Rules Hub
Code Ruleset
Rule priority, scope & exceptions
Use this to align rules with the senior-level structure (P0/P1/P2, scope, exceptions/tradeoffs).
Report the originating configuration alias in validation errors
When normalizing supported configuration aliases, retain which input variable supplied an invalid value so diagnostics name the variable the operator can fix.
Bad example
| 1 | const host = schema.parse(env.PRIMARY_HOST || env.LEGACY_HOST); |
Explanation (EN)
When normalizing supported configuration aliases, retain which input variable supplied an invalid value so diagnostics name the variable the operator can fix.
Objašnjenje (HR)
Kod neispravne konfiguracije navedi stvarnu varijablu koja je dala vrijednost, uz isti prioritet aliasa i bez zapisivanja tajnih vrijednosti.
Good example
| 1 | const source = env.PRIMARY_HOST ? 'PRIMARY_HOST' : 'LEGACY_HOST'; |
| 2 | const host = validateConfigField(source, env[source]); |
Explanation (EN)
Preserve configured precedence and missing-value behavior while mapping safe validation field paths back to the provided alias. Do not log the value, credential-bearing URL or complete environment. Test invalid fallback-only configuration and an invalid primary value when both variables exist. Normalized return names can remain canonical.
Objašnjenje (HR)
Kod neispravne konfiguracije navedi stvarnu varijablu koja je dala vrijednost, uz isti prioritet aliasa i bez zapisivanja tajnih vrijednosti.
Notes (EN)
Preserve configured precedence and missing-value behavior while mapping safe validation field paths back to the provided alias. Do not log the value, credential-bearing URL or complete environment. Test invalid fallback-only configuration and an invalid primary value when both variables exist. Normalized return names can remain canonical.
Bilješke (HR)
Kod neispravne konfiguracije navedi stvarnu varijablu koja je dala vrijednost, uz isti prioritet aliasa i bez zapisivanja tajnih vrijednosti.
Exceptions / Tradeoffs (EN)
If all supported aliases are already named in an actionable diagnostic, per-input path remapping is optional. Do not claim an unset alias supplied a missing value.
Iznimke / Tradeoffi (HR)
Primijeni u opisanom kontekstu uz navedene iznimke.