@maverickcer/env-cap 0.7.6 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ADOPTION.md +4 -4
- package/AGENTS.md +2 -3
- package/CHANGELOG.md +36 -0
- package/CODE_REVIEW.md +1 -1
- package/CONTRIBUTING.md +1 -1
- package/GUIDE.md +12 -12
- package/README.md +11 -12
- package/VERSIONING.md +2 -1
- package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +3 -4
- package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
- package/dist/.dts/build/assemble-project.d.ts +3 -3
- package/dist/.dts/build/change-model.d.ts +9 -11
- package/dist/.dts/build/change-model.d.ts.map +1 -1
- package/dist/.dts/build/check-artifacts.d.ts +5 -6
- package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
- package/dist/.dts/build/citation-verification.d.ts +6 -7
- package/dist/.dts/build/citation-verification.d.ts.map +1 -1
- package/dist/.dts/build/contract-model.d.ts +7 -8
- package/dist/.dts/build/contract-model.d.ts.map +1 -1
- package/dist/.dts/build/deep-equal.d.ts +3 -3
- package/dist/.dts/build/deep-freeze.d.ts +5 -7
- package/dist/.dts/build/deep-freeze.d.ts.map +1 -1
- package/dist/.dts/build/dependency-model.d.ts +2 -2
- package/dist/.dts/build/dependency-model.d.ts.map +1 -1
- package/dist/.dts/build/discover.d.ts +6 -6
- package/dist/.dts/build/discover.d.ts.map +1 -1
- package/dist/.dts/build/env-example.d.ts +6 -7
- package/dist/.dts/build/env-example.d.ts.map +1 -1
- package/dist/.dts/build/errors.d.ts +4 -4
- package/dist/.dts/build/evidence-cache.d.ts +12 -14
- package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
- package/dist/.dts/build/evidence-model.d.ts +6 -7
- package/dist/.dts/build/evidence-model.d.ts.map +1 -1
- package/dist/.dts/build/evidence-reference.d.ts +6 -6
- package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
- package/dist/.dts/build/exclusive-group.d.ts +3 -3
- package/dist/.dts/build/finding-model.d.ts +12 -13
- package/dist/.dts/build/finding-model.d.ts.map +1 -1
- package/dist/.dts/build/generate-documentation.d.ts +6 -7
- package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
- package/dist/.dts/build/generate-evidence.d.ts +13 -15
- package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
- package/dist/.dts/build/generate-manifest.d.ts +14 -16
- package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
- package/dist/.dts/build/generated-banner.d.ts +3 -3
- package/dist/.dts/build/governance-fields.d.ts +3 -3
- package/dist/.dts/build/humanize-key.d.ts +3 -3
- package/dist/.dts/build/lifecycle-model.d.ts +3 -3
- package/dist/.dts/build/literal-eval.d.ts +2 -2
- package/dist/.dts/build/literal-eval.d.ts.map +1 -1
- package/dist/.dts/build/live-expirations.d.ts +9 -9
- package/dist/.dts/build/manifest.d.ts +7 -8
- package/dist/.dts/build/manifest.d.ts.map +1 -1
- package/dist/.dts/build/merge-documentation.d.ts +4 -5
- package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
- package/dist/.dts/build/resolution/resolve-import.d.ts +8 -9
- package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
- package/dist/.dts/build/resolution/resolve-within-root.d.ts +4 -4
- package/dist/.dts/build/sarif.d.ts +9 -11
- package/dist/.dts/build/sarif.d.ts.map +1 -1
- package/dist/.dts/build/source-position.d.ts +14 -17
- package/dist/.dts/build/source-position.d.ts.map +1 -1
- package/dist/.dts/build/usage-report.d.ts +16 -17
- package/dist/.dts/build/usage-report.d.ts.map +1 -1
- package/dist/.dts/cli/filesystem.d.ts.map +1 -1
- package/dist/.dts/eslint-plugin/glob.d.ts +2 -2
- package/dist/.dts/eslint-plugin/index.d.ts +2 -1
- package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
- package/dist/.dts/eslint-plugin/no-node-fs.d.ts +5 -5
- package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
- package/dist/.dts/evidence/define-projection.d.ts +6 -6
- package/dist/.dts/runtime/create.d.ts +2 -3
- package/dist/.dts/runtime/create.d.ts.map +1 -1
- package/dist/.dts/runtime/errors.d.ts +7 -8
- package/dist/.dts/runtime/errors.d.ts.map +1 -1
- package/dist/.dts/runtime/index.d.ts +2 -2
- package/dist/.dts/runtime/types.d.ts +18 -20
- package/dist/.dts/runtime/types.d.ts.map +1 -1
- package/dist/.dts/runtime/validate.d.ts +2 -2
- package/dist/.dts/runtime/validate.d.ts.map +1 -1
- package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +3 -4
- package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
- package/dist/.dts7/build/assemble-project.d.ts +3 -3
- package/dist/.dts7/build/change-model.d.ts +9 -11
- package/dist/.dts7/build/change-model.d.ts.map +1 -1
- package/dist/.dts7/build/check-artifacts.d.ts +5 -6
- package/dist/.dts7/build/check-artifacts.d.ts.map +1 -1
- package/dist/.dts7/build/citation-verification.d.ts +6 -7
- package/dist/.dts7/build/citation-verification.d.ts.map +1 -1
- package/dist/.dts7/build/contract-model.d.ts +7 -8
- package/dist/.dts7/build/contract-model.d.ts.map +1 -1
- package/dist/.dts7/build/deep-equal.d.ts +3 -3
- package/dist/.dts7/build/deep-freeze.d.ts +5 -7
- package/dist/.dts7/build/deep-freeze.d.ts.map +1 -1
- package/dist/.dts7/build/dependency-model.d.ts +2 -2
- package/dist/.dts7/build/dependency-model.d.ts.map +1 -1
- package/dist/.dts7/build/discover.d.ts +6 -6
- package/dist/.dts7/build/discover.d.ts.map +1 -1
- package/dist/.dts7/build/env-example.d.ts +6 -7
- package/dist/.dts7/build/env-example.d.ts.map +1 -1
- package/dist/.dts7/build/errors.d.ts +4 -4
- package/dist/.dts7/build/evidence-cache.d.ts +12 -14
- package/dist/.dts7/build/evidence-cache.d.ts.map +1 -1
- package/dist/.dts7/build/evidence-model.d.ts +6 -7
- package/dist/.dts7/build/evidence-model.d.ts.map +1 -1
- package/dist/.dts7/build/evidence-reference.d.ts +6 -6
- package/dist/.dts7/build/evidence-reference.d.ts.map +1 -1
- package/dist/.dts7/build/exclusive-group.d.ts +3 -3
- package/dist/.dts7/build/finding-model.d.ts +12 -13
- package/dist/.dts7/build/finding-model.d.ts.map +1 -1
- package/dist/.dts7/build/generate-documentation.d.ts +6 -7
- package/dist/.dts7/build/generate-documentation.d.ts.map +1 -1
- package/dist/.dts7/build/generate-evidence.d.ts +13 -15
- package/dist/.dts7/build/generate-evidence.d.ts.map +1 -1
- package/dist/.dts7/build/generate-manifest.d.ts +14 -16
- package/dist/.dts7/build/generate-manifest.d.ts.map +1 -1
- package/dist/.dts7/build/generated-banner.d.ts +3 -3
- package/dist/.dts7/build/governance-fields.d.ts +3 -3
- package/dist/.dts7/build/humanize-key.d.ts +3 -3
- package/dist/.dts7/build/lifecycle-model.d.ts +3 -3
- package/dist/.dts7/build/literal-eval.d.ts +2 -2
- package/dist/.dts7/build/literal-eval.d.ts.map +1 -1
- package/dist/.dts7/build/live-expirations.d.ts +9 -9
- package/dist/.dts7/build/manifest.d.ts +7 -8
- package/dist/.dts7/build/manifest.d.ts.map +1 -1
- package/dist/.dts7/build/merge-documentation.d.ts +4 -5
- package/dist/.dts7/build/merge-documentation.d.ts.map +1 -1
- package/dist/.dts7/build/resolution/resolve-import.d.ts +8 -9
- package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -1
- package/dist/.dts7/build/resolution/resolve-within-root.d.ts +4 -4
- package/dist/.dts7/build/sarif.d.ts +9 -11
- package/dist/.dts7/build/sarif.d.ts.map +1 -1
- package/dist/.dts7/build/source-position.d.ts +14 -17
- package/dist/.dts7/build/source-position.d.ts.map +1 -1
- package/dist/.dts7/build/usage-report.d.ts +16 -17
- package/dist/.dts7/build/usage-report.d.ts.map +1 -1
- package/dist/.dts7/cli/filesystem.d.ts.map +1 -1
- package/dist/.dts7/eslint-plugin/glob.d.ts +2 -2
- package/dist/.dts7/eslint-plugin/index.d.ts +2 -1
- package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -1
- package/dist/.dts7/eslint-plugin/no-node-fs.d.ts +5 -5
- package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +4 -4
- package/dist/.dts7/evidence/define-projection.d.ts +6 -6
- package/dist/.dts7/runtime/create.d.ts +2 -3
- package/dist/.dts7/runtime/create.d.ts.map +1 -1
- package/dist/.dts7/runtime/errors.d.ts +7 -8
- package/dist/.dts7/runtime/errors.d.ts.map +1 -1
- package/dist/.dts7/runtime/index.d.ts +2 -2
- package/dist/.dts7/runtime/types.d.ts +18 -20
- package/dist/.dts7/runtime/types.d.ts.map +1 -1
- package/dist/.dts7/runtime/validate.d.ts +2 -2
- package/dist/.dts7/runtime/validate.d.ts.map +1 -1
- package/dist/{build-UEENZEUX.js → build-Z76NCC65.js} +7 -10
- package/dist/build-Z76NCC65.js.map +1 -0
- package/dist/build.cjs +6 -9
- package/dist/build.cjs.map +1 -1
- package/dist/build.js +6 -9
- package/dist/build.js.map +1 -1
- package/dist/{chunk-TBL3O7IG.js → chunk-JRCMG4FQ.js} +2 -2
- package/dist/cli/index.js +3 -3
- package/dist/cli/index.js.map +1 -1
- package/dist/eslint-plugin/index.cjs.map +1 -1
- package/dist/eslint-plugin/index.js.map +1 -1
- package/dist/evidence.cjs.map +1 -1
- package/dist/evidence.js.map +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/node.cjs.map +1 -1
- package/dist/node.js.map +1 -1
- package/package.json +8 -7
- package/schemas/env-cap-report.schema.json +11 -11
- package/skills/env-cap/SKILL.md +1 -1
- package/skills/env-cap/references/api.md +1 -1
- package/specs/architecture.md +6 -6
- package/specs/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +9 -0
- package/specs/migrations/README.md +9 -9
- package/specs/migrations/from-centralized-schema.md +28 -28
- package/specs/migrations/from-dotenv.md +11 -11
- package/specs/migrations/from-envalid.md +16 -16
- package/specs/migrations/from-process-env.md +19 -19
- package/specs/migrations/from-t3-env.md +24 -24
- package/specs/migrations/from-zod.md +21 -21
- package/dist/build-UEENZEUX.js.map +0 -1
- /package/dist/{chunk-TBL3O7IG.js.map → chunk-JRCMG4FQ.js.map} +0 -0
|
@@ -2,18 +2,17 @@ import type { BuildFileSystem } from "../types.js";
|
|
|
2
2
|
import { type PackageSchemaResolutionResult } from "./resolve-package-schema.js";
|
|
3
3
|
import { type AliasResolutionCache, type TsconfigPathsResolution } from "./resolve-tsconfig-paths.js";
|
|
4
4
|
/**
|
|
5
|
-
* Resolves a relative import specifier
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* file that contains the import.
|
|
5
|
+
* Resolves a relative import specifier, as written in source (`"./schema.js"`),
|
|
6
|
+
* to an absolute file path. It resolves against the file that contains the
|
|
7
|
+
* import. A `.js` suffix points at the `.ts` source file, as in this codebase.
|
|
9
8
|
*
|
|
10
9
|
* @remarks
|
|
11
10
|
* Deliberately narrow: only handles a direct relative specifier resolving to
|
|
12
|
-
* a real `.ts`/`.tsx` file on disk.
|
|
13
|
-
* imports, and anything
|
|
14
|
-
* `exports` map lookups
|
|
15
|
-
* as "couldn't statically link" and warns rather than guesses
|
|
16
|
-
*
|
|
11
|
+
* a real `.ts`/`.tsx` file on disk. Anything else returns `undefined`: bare
|
|
12
|
+
* or package specifiers, namespace imports, and anything that needs real
|
|
13
|
+
* module resolution (re-export chains, `exports` map lookups). The caller
|
|
14
|
+
* reads that as "couldn't statically link" and warns rather than guesses.
|
|
15
|
+
* `evaluateLiteral` treats non-literal expressions the same way.
|
|
17
16
|
*
|
|
18
17
|
* @returns The resolved absolute path, or `undefined` when the specifier isn't relative or doesn't resolve to a real file.
|
|
19
18
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resolve-import.d.ts","sourceRoot":"","sources":["../../../../src/build/resolution/resolve-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAEpC
|
|
1
|
+
{"version":3,"file":"resolve-import.d.ts","sourceRoot":"","sources":["../../../../src/build/resolution/resolve-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAEpC;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED,8GAA8G;AAC9G,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2HAA2H;IAC3H,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,4HAA4H;IAC5H,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAA;IACnE,wIAAwI;IACxI,QAAQ,CAAC,aAAa,EAAE,uBAAuB,GAAG,SAAS,CAAA;IAC3D,+LAA+L;IAC/L,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}
|
|
@@ -22,10 +22,10 @@ export declare function isWithinDirectory(baseDir: string, targetPath: string):
|
|
|
22
22
|
* branch of the filesystem entirely). Discovery (`include`/`exclude`) is
|
|
23
23
|
* already safe by construction: it only ever walks *down* from `root` via
|
|
24
24
|
* `readdir`, so a pattern can't make it read outside `root`. Output
|
|
25
|
-
* locations have no such
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
25
|
+
* locations have no such guarantee, since `path.resolve` walks back out
|
|
26
|
+
* through `..` segments. So this is a lexical bounds-check. It is not a
|
|
27
|
+
* symlink-aware `realpath` check, because *output* paths usually don't
|
|
28
|
+
* exist yet.
|
|
29
29
|
*
|
|
30
30
|
* Never throws itself: returns a `CompatibilityIssue`-shaped finding on
|
|
31
31
|
* escape so each generator function (`generateEnvManifest`, `generateDocumentation`,
|
|
@@ -1,14 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* SARIF export: an adapter over Finding Model, not a new fact source.
|
|
3
3
|
* Produces a minimal, spec-conformant SARIF 2.1.0 log
|
|
4
|
-
* (https://docs.oasis-open.org/sarif/sarif/v2.1.0/)
|
|
5
|
-
*
|
|
6
|
-
*
|
|
4
|
+
* (https://docs.oasis-open.org/sarif/sarif/v2.1.0/). Any SARIF-aware tool can
|
|
5
|
+
* then read env-cap's findings, such as GitHub code scanning or a CI security
|
|
6
|
+
* dashboard.
|
|
7
7
|
*
|
|
8
|
-
* Pure and synchronous: every input is
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
* `buildFindingModel()` already concluded.
|
|
8
|
+
* Pure and synchronous: every input is computed before this runs. It never
|
|
9
|
+
* re-derives a finding, reads the filesystem or decides what is a problem.
|
|
10
|
+
* It only re-shapes what `buildFindingModel()` concluded.
|
|
12
11
|
*/
|
|
13
12
|
import type { FindingModel } from "./finding-model.js";
|
|
14
13
|
/** SARIF's `level` enum: see the SARIF 2.1.0 spec, section 3.27.10. */
|
|
@@ -55,10 +54,9 @@ export interface SarifLog {
|
|
|
55
54
|
*
|
|
56
55
|
* @remarks
|
|
57
56
|
* `rules` lists every distinct `FindingCode` actually present in this run,
|
|
58
|
-
* sorted: not the full `FindingCode` union. A SARIF consumer
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
* rules. `results` preserves Finding Model's own order, which a caller wanting
|
|
57
|
+
* sorted: not the full `FindingCode` union. A SARIF consumer reads the rules
|
|
58
|
+
* array as "what this tool reported". Rules with no result would make a clean
|
|
59
|
+
* run look like it has unexplained silent rules. `results` preserves Finding Model's own order, which a caller wanting
|
|
62
60
|
* a different one sorts themselves.
|
|
63
61
|
*/
|
|
64
62
|
export declare function buildSarifLog(findingModel: FindingModel): SarifLog;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../../src/build/sarif.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../../src/build/sarif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAI/D,uEAAuE;AACvE,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAOvD,UAAU,aAAa;IACrB,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,gBAAgB,EAAE;YAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;QACnD,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KAC/E,CAAA;CACF;AAsCD,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CAC9C;AAED,iHAAiH;AACjH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS;QACtB,QAAQ,CAAC,IAAI,EAAE;YACb,QAAQ,CAAC,MAAM,EAAE;gBACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;gBAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBACxB,QAAQ,CAAC,KAAK,EAAE,SAAS;oBAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAA;aACnD,CAAA;SACF,CAAA;QACD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;KACzC,EAAE,CAAA;CACJ;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ,CAgClE"}
|
|
@@ -15,10 +15,9 @@ export interface SourcePosition {
|
|
|
15
15
|
}
|
|
16
16
|
/**
|
|
17
17
|
* `node`'s starting line/column within `sourceFile`, both 1-indexed: TypeScript's own
|
|
18
|
-
* `getLineAndCharacterOfPosition()` returns 0-indexed values for both. Callers
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* root-relative or still absolute.
|
|
18
|
+
* `getLineAndCharacterOfPosition()` returns 0-indexed values for both. Callers add the file path
|
|
19
|
+
* they have in scope to build a full {@link SourcePosition}. Returning only the two numbers keeps
|
|
20
|
+
* it usable whether that path is root-relative or absolute.
|
|
22
21
|
*/
|
|
23
22
|
export declare function positionOf(sourceFile: ts.SourceFile, node: ts.Node): {
|
|
24
23
|
line: number;
|
|
@@ -27,28 +26,26 @@ export declare function positionOf(sourceFile: ts.SourceFile, node: ts.Node): {
|
|
|
27
26
|
/**
|
|
28
27
|
* Parses a developer-supplied `"<relative-path>:<line>:<column>"` citation
|
|
29
28
|
* (a {@link runtime.VariableEvidenceDocs.dynamicAccess} entry) into a
|
|
30
|
-
* {@link SourcePosition}. Splits on the *last* two colons so a path
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
* treat that as a malformed citation, never a thrown error. See ADR 0037.
|
|
29
|
+
* {@link SourcePosition}. Splits on the *last* two colons, so a path that
|
|
30
|
+
* contains colons still parses. Only the trailing `:<line>:<column>` is
|
|
31
|
+
* position syntax. Returns `undefined` for any other shape: missing segments,
|
|
32
|
+
* a line or column that is not a positive integer, or an empty path. Callers
|
|
33
|
+
* treat that as a malformed citation, not a thrown error. See ADR 0037.
|
|
36
34
|
*/
|
|
37
35
|
export declare function parsePositionCitation(citation: string): SourcePosition | undefined;
|
|
38
36
|
/**
|
|
39
37
|
* One developer-declared {@link runtime.VariableEvidenceDocs.dynamicAccess} citation's
|
|
40
|
-
* current acknowledgment state: a claim, never an observation.
|
|
41
|
-
* separate from `VariableAccessStatus
|
|
42
|
-
*
|
|
43
|
-
*
|
|
38
|
+
* current acknowledgment state: a claim, never an observation. It stays
|
|
39
|
+
* separate from `VariableAccessStatus`, which is 3-valued and AST-derived only.
|
|
40
|
+
* So a developer's assertion can never make env-cap claim an observation it
|
|
41
|
+
* did not make. See
|
|
44
42
|
* `evidence-snapshot.ts`'s `computeDynamicAccessAcknowledgments()` (where
|
|
45
43
|
* this is computed) and ADR 0037.
|
|
46
44
|
*/
|
|
47
45
|
export interface DynamicAccessAssertion extends SourcePosition {
|
|
48
46
|
/**
|
|
49
|
-
* `"fresh"`: the cited file
|
|
50
|
-
*
|
|
51
|
-
* nothing to contradict it yet). `"stale"`: the cited file exists but its
|
|
47
|
+
* `"fresh"`: the cited file exists and matches the committed baseline
|
|
48
|
+
* hash, or has no baseline yet (a new citation). `"stale"`: the cited file exists but its
|
|
52
49
|
* content has changed since the committed baseline. `"missing"`: the
|
|
53
50
|
* cited file no longer exists at all. Re-derived from scratch every run;
|
|
54
51
|
* never cached across runs.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-position.d.ts","sourceRoot":"","sources":["../../../src/build/source-position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED
|
|
1
|
+
{"version":3,"file":"source-position.d.ts","sourceRoot":"","sources":["../../../src/build/source-position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,IAAI,EAAE,EAAE,CAAC,IAAI,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAQlF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;IACtD;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC"}
|
|
@@ -12,9 +12,9 @@ export interface OwnershipDependencyEntry {
|
|
|
12
12
|
readonly owner: string | undefined;
|
|
13
13
|
/** Number of variables declared in this contract's schema. */
|
|
14
14
|
readonly variableCount: number;
|
|
15
|
-
/** Files coupled to this contract
|
|
16
|
-
* member from it
|
|
17
|
-
*
|
|
15
|
+
/** Files coupled to this contract: they import it, reference it, or read a
|
|
16
|
+
* member from it. This answers "who depends on this" per contract; it does
|
|
17
|
+
* not prove any variable was read. Blast radius if this contract changes is
|
|
18
18
|
* `consumers.length`, computed by callers/renderers on demand rather than
|
|
19
19
|
* stored redundantly here. */
|
|
20
20
|
readonly consumers: readonly string[];
|
|
@@ -52,7 +52,7 @@ export interface UnconsumedOwnedVariableFinding {
|
|
|
52
52
|
* claimed otherwise. A non-empty list means someone specifically claimed
|
|
53
53
|
* dynamic access here once, and that claim can no longer be verified. That
|
|
54
54
|
* is worth a human check before deleting, not a stronger reason to trust
|
|
55
|
-
* "unconsumed.
|
|
55
|
+
* "unconsumed". The list holds the raw citations, not a collapsed
|
|
56
56
|
* `high`/`low` label, matching this codebase's "show the receipt" pattern
|
|
57
57
|
* (ADR 0036/0037). A reader can judge confidence from the actual evidence
|
|
58
58
|
* rather than trusting a derived summary. See ADR 0038.
|
|
@@ -72,7 +72,7 @@ export interface IndeterminateOwnershipFinding {
|
|
|
72
72
|
/** See {@link UnconsumedOwnedVariableFinding.staleOrMissingCitations}. */
|
|
73
73
|
readonly staleOrMissingCitations: readonly DynamicAccessCitationProblem[];
|
|
74
74
|
}
|
|
75
|
-
/** A variable that would otherwise be reported `unconsumedOwnedVariables`/`indeterminate
|
|
75
|
+
/** A variable that would otherwise be reported `unconsumedOwnedVariables`/`indeterminate` but has at least one `"fresh"` developer-declared `dynamicAccess` citation. The raw static status is shown beside the assertion, never replaced by it. See ADR 0037. */
|
|
76
76
|
export interface AssertedDynamicAccessFinding {
|
|
77
77
|
/** Resolved display name (see {@link DiscoveredContract.contractName}). */
|
|
78
78
|
readonly contractName: string;
|
|
@@ -84,10 +84,9 @@ export interface AssertedDynamicAccessFinding {
|
|
|
84
84
|
readonly dynamicAccessAssertions: readonly DynamicAccessAssertion[];
|
|
85
85
|
}
|
|
86
86
|
/** Everything {@link renderUsageReport} needs to render the Dependency &
|
|
87
|
-
* Ownership Report
|
|
88
|
-
* `
|
|
89
|
-
* `
|
|
90
|
-
* `GenerateDocumentationResult`. `generate-usage.ts` composes its own
|
|
87
|
+
* Ownership Report. It is not derived from `GenerateUsageReportResult` in
|
|
88
|
+
* `generate-usage.js`, as `RenderDocsOptions` in `docs.ts` is not derived
|
|
89
|
+
* from `GenerateDocumentationResult`. `generate-usage.ts` composes its own
|
|
91
90
|
* public result type from these building blocks instead, keeping this
|
|
92
91
|
* renderer module importable without its orchestrator. */
|
|
93
92
|
export interface RenderUsageReportOptions {
|
|
@@ -105,20 +104,20 @@ export interface RenderUsageReportOptions {
|
|
|
105
104
|
readonly indeterminate: readonly IndeterminateOwnershipFinding[];
|
|
106
105
|
/** Variables a developer has re-acknowledged via `dynamicAccess`, freshly: see ADR 0037. */
|
|
107
106
|
readonly asserted: readonly AssertedDynamicAccessFinding[];
|
|
108
|
-
/** Schema-discovery parse warnings plus
|
|
109
|
-
*
|
|
110
|
-
* `generateEnvManifest`/`generateDocumentation
|
|
111
|
-
*
|
|
112
|
-
*
|
|
107
|
+
/** Schema-discovery parse warnings plus any `packages` resolution failures
|
|
108
|
+
* (ADR 0014). They appear here as well as in
|
|
109
|
+
* `generateEnvManifest`/`generateDocumentation`, so a team that reads only
|
|
110
|
+
* this report still learns when a cross-package contract failed to
|
|
111
|
+
* resolve. */
|
|
113
112
|
readonly parseWarnings: readonly ParseWarning[];
|
|
114
113
|
/** Every surface actually scanned for usage: see ADR 0036. Named explicitly next to `unconsumedOwnedVariables` so "no consumer found" is never read as a stronger claim than what was actually searched. */
|
|
115
114
|
readonly scannedSurfaces: readonly ScannedSurface[];
|
|
116
115
|
}
|
|
117
116
|
/**
|
|
118
117
|
* Renders the Dependency & Ownership Report: who owns each variable, which
|
|
119
|
-
* features consume each contract, and
|
|
120
|
-
*
|
|
121
|
-
*
|
|
118
|
+
* features consume each contract, and the blast radius of a change. It
|
|
119
|
+
* answers those three questions, never in generic "dead code" or "unused
|
|
120
|
+
* symbol" terms.
|
|
122
121
|
*/
|
|
123
122
|
export declare function renderUsageReport(computed: RenderUsageReportOptions): string;
|
|
124
123
|
//# sourceMappingURL=usage-report.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"usage-report.d.ts","sourceRoot":"","sources":["../../../src/build/usage-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAO9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAElF,uFAAuF;AACvF,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B;;;;mCAI+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED,oEAAoE;AACpE,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AACD,+GAA+G;AAC/G,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AACD,0EAA0E;AAC1E,MAAM,WAAW,8BAA8B;IAC7C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,uBAAuB,EAAE,SAAS,4BAA4B,EAAE,CAAA;CAC1E;AACD,8GAA8G;AAC9G,MAAM,WAAW,6BAA6B;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yFAAyF;IACzF,QAAQ,CAAC,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAA;IACtD,0EAA0E;IAC1E,QAAQ,CAAC,uBAAuB,EAAE,SAAS,4BAA4B,EAAE,CAAA;CAC1E;AACD,
|
|
1
|
+
{"version":3,"file":"usage-report.d.ts","sourceRoot":"","sources":["../../../src/build/usage-report.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/cli/filesystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAc,MAAM,mBAAmB,CAAA;
|
|
1
|
+
{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/cli/filesystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAc,MAAM,mBAAmB,CAAA;AAgDjF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAO9B,CAAA"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Matching of the plugin's `allow` options against the file a rule is checking. The behavior lives in
|
|
3
|
-
* `../_ipc/glob.ts`, a managed copy of
|
|
4
|
-
* the working directory (`src/cli/**`) matches the absolute path ESLint passes, on Windows too.
|
|
3
|
+
* `../_ipc/glob.ts`, a managed copy of `runtime/glob.ts` from internal-package-contract. A pattern written
|
|
4
|
+
* relative to the working directory (`src/cli/**`) matches the absolute path ESLint passes, on Windows too.
|
|
5
5
|
*/
|
|
6
6
|
export { matchesAllowList } from "../_ipc/glob.js";
|
|
7
7
|
//# sourceMappingURL=glob.d.ts.map
|
|
@@ -3,7 +3,8 @@
|
|
|
3
3
|
*
|
|
4
4
|
* `no-raw-process-env` flags direct `process.env` reads outside `env.schema.ts` files. `no-node-fs` flags
|
|
5
5
|
* `node:fs` imports in library code, which should take its file system from the caller. The plugin runs
|
|
6
|
-
* inside the project's
|
|
6
|
+
* inside the project's ESLint. The `eslint-compat` CI job tests it on the lowest and newest release of each
|
|
7
|
+
* ESLint major in the peer range.
|
|
7
8
|
*
|
|
8
9
|
* @packageDocumentation
|
|
9
10
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/eslint-plugin/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/eslint-plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;;;;GAUG;AACH,QAAA,MAAM,MAAM;IACV,wEAAwE;;QAEtE,mCAAmC;;;;QAEnC,4BAA4B;;;;;CAG/B,CAAA;AACD,eAAe,MAAM,CAAA;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA"}
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Flags any `import
|
|
3
|
-
* its filesystem capability from the caller instead of
|
|
2
|
+
* Flags any `import`, `require` or dynamic `import()` of `node:fs` in library code. A library surface then
|
|
3
|
+
* receives its filesystem capability from the caller instead of importing `node:fs`.
|
|
4
4
|
*
|
|
5
5
|
* @remarks
|
|
6
|
-
* Nothing is exempt by default. A package's
|
|
7
|
-
*
|
|
8
|
-
*
|
|
6
|
+
* Nothing is exempt by default. A package's config allows its CLI folder (for example `src/cli/**`), which
|
|
7
|
+
* builds the `node:fs/promises` adapter. A consuming project sets the `allow` option for its CLI or script
|
|
8
|
+
* entry points. The rule itself lives in `../_ipc/no-node-fs.ts`, a managed copy of
|
|
9
9
|
* internal-package-contract's `runtime/no-node-fs.ts`; this supplies env-cap's documentation link and the decision
|
|
10
10
|
* record the message cites.
|
|
11
11
|
*/
|
|
@@ -10,12 +10,12 @@ export interface RuleOptions {
|
|
|
10
10
|
}
|
|
11
11
|
/**
|
|
12
12
|
* Flags any direct `process.env.X`/`process.env["X"]` read in application code, so environment
|
|
13
|
-
* access always goes through
|
|
13
|
+
* access always goes through the `createEnv()` contract of the feature that owns the variable.
|
|
14
14
|
*
|
|
15
15
|
* @remarks
|
|
16
|
-
* `env.schema.ts`/`env.schema.tsx` files are always exempt
|
|
17
|
-
*
|
|
18
|
-
* project's
|
|
16
|
+
* `env.schema.ts`/`env.schema.tsx` files are always exempt, because `createEnv()` reads
|
|
17
|
+
* `process.env` there. The rule's `allow` option extends that exemption to a consuming
|
|
18
|
+
* project's trusted bootstrap code.
|
|
19
19
|
*/
|
|
20
20
|
export declare const noRawProcessEnv: import("@typescript-eslint/utils/ts-eslint").RuleModule<"noRawProcessEnv", [RuleOptions], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
|
|
21
21
|
name: string;
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import type { EvidenceModel } from "../build/evidence-model.js";
|
|
2
2
|
/**
|
|
3
3
|
* A pure function from the full Evidence Model to one field of a
|
|
4
|
-
* projection's output shape.
|
|
5
|
-
* `defineEvidenceProjection()` wraps
|
|
6
|
-
* `createTrackingProxy()` below)
|
|
7
|
-
*
|
|
4
|
+
* projection's output shape. It reads `evidence` and performs no I/O.
|
|
5
|
+
* The membrane `defineEvidenceProjection()` wraps around `evidence` throws on
|
|
6
|
+
* any write (see `createTrackingProxy()` below). That enforces the read-only
|
|
7
|
+
* half of purity. The "no side effects" half is the author's job.
|
|
8
8
|
*/
|
|
9
9
|
export type EvidenceProjector<T> = (evidence: EvidenceModel) => T;
|
|
10
10
|
/** One independent, pure projector function per key of the projection's output shape `T`. */
|
|
@@ -28,8 +28,8 @@ export interface EvidenceProjection<T extends Record<string, unknown>> {
|
|
|
28
28
|
}
|
|
29
29
|
/**
|
|
30
30
|
* Declares a projection: a named, pure transform from the immutable
|
|
31
|
-
* `EvidenceModel` to any consumer-defined output shape
|
|
32
|
-
*
|
|
31
|
+
* `EvidenceModel` to any consumer-defined output shape. It is built from the
|
|
32
|
+
* independent per-field projector functions in `schema` (ADR 0031, ADR 0032).
|
|
33
33
|
*
|
|
34
34
|
* The reference projections env-cap ships (`.env.example`, Environment
|
|
35
35
|
* Configuration Reference, Configuration Ownership, etc.) are built through
|
|
@@ -7,9 +7,8 @@ import type { CreateEnvOptions, EnvContract, EnvSchema } from "./types.js";
|
|
|
7
7
|
* `createEnv` is runtime-only: `processor`/`validator`/`default` are the
|
|
8
8
|
* whole vocabulary, because they're the only fields {@link validateEnv} actually
|
|
9
9
|
* reads. Documentation (description, ownership, lifecycle, category, and
|
|
10
|
-
* everything else that only
|
|
11
|
-
* {@link documentEnv} call (see `document.ts`)
|
|
12
|
-
* never required for this to work.
|
|
10
|
+
* everything else that only feeds generated docs) lives in a separate
|
|
11
|
+
* {@link documentEnv} call (see `document.ts`). That call is optional.
|
|
13
12
|
*
|
|
14
13
|
* @returns An {@link EnvContract} exposing one read-only getter per key: there is no
|
|
15
14
|
* global env object, only per-feature contracts like `paymentsEnv.STRIPE_KEY`. Accessing a
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/runtime/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI7F
|
|
1
|
+
{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/runtime/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI7F;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAC3C,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CAAC,CAAC,CAAC,CA4ChB"}
|
|
@@ -1,14 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Every error type here is
|
|
3
|
-
* declaring contract's name, the failure kind, and a message
|
|
4
|
-
*
|
|
5
|
-
*
|
|
2
|
+
* Every error type here is built from four things only. They are the variable
|
|
3
|
+
* name, the declaring contract's name, the failure kind, and a message from
|
|
4
|
+
* the developer's processor or validator. Raw or processed environment values
|
|
5
|
+
* never reach an error: see the Security section in the README.
|
|
6
6
|
*
|
|
7
7
|
* Documentation (description, owner, etc.) never appears here, even when a
|
|
8
|
-
* {@link documentEnv} call exists for this variable
|
|
9
|
-
* build-time-only and
|
|
10
|
-
*
|
|
11
|
-
* runtime minimal, not an oversight.
|
|
8
|
+
* {@link documentEnv} call exists for this variable. `documentEnv` is
|
|
9
|
+
* build-time-only, and {@link validateEnv} has nowhere to read its data from.
|
|
10
|
+
* That follows from keeping the runtime minimal.
|
|
12
11
|
*/
|
|
13
12
|
/** One variable's processing or validation failure, as recorded by {@link validateEnv}. */
|
|
14
13
|
export interface VariableFailure {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gIAAgI;IAChI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;IACxC,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAwBD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,IAAI,2BAA0B;IACvC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;gBAEjC,QAAQ,EAAE,SAAS,eAAe,EAAE;CAMjD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,mBAAkB;gBAEnB,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAS9C"}
|
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
* Node imports, `process.` and `Buffer.`, but a third-party import would pass unnoticed.
|
|
8
8
|
* Discovery and manifest generation live in `@maverickcer/env-cap/build`, never here.
|
|
9
9
|
*
|
|
10
|
-
* `documentEnv` is exported here, not from `./build
|
|
11
|
-
*
|
|
10
|
+
* `documentEnv` is exported here, not from `./build`. It is called inline in the same schema file
|
|
11
|
+
* as `createEnv`, and that file may end up in any bundle. It must be as cheap to import as
|
|
12
12
|
* `createEnv` (see `document.ts`).
|
|
13
13
|
*
|
|
14
14
|
* @packageDocumentation
|
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
* requiredness is just a validator that rejects `undefined`/empty values.
|
|
8
8
|
*
|
|
9
9
|
* Documentation fields (description, owner, expiresAt, category, ...) live
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
10
|
+
* in {@link documentEnv} (see `document.ts`), not here. This file is the
|
|
11
|
+
* runtime's whole vocabulary. `validate.ts`, `create.ts` and `errors.ts` read
|
|
12
|
+
* every field in it at runtime. If a field is only ever
|
|
13
13
|
* read by the generator, it belongs in `document.ts`, not here. `context` is
|
|
14
14
|
* the one exception. The build package also reads it for documentation
|
|
15
15
|
* display (see ADR 0022). It belongs here rather than in `documentEnv()`
|
|
@@ -34,8 +34,8 @@ export type Validator<T> = (value: T, rawEnv: RawEnv) => true | string;
|
|
|
34
34
|
*
|
|
35
35
|
* @remarks
|
|
36
36
|
* The union is redundant at the type level (`unknown` alone already accepts a
|
|
37
|
-
* function). It's kept because this type is public API
|
|
38
|
-
*
|
|
37
|
+
* function). It's kept because this type is public API. A reader of the generated `.d.ts`
|
|
38
|
+
* learns the thunk form from it, and bare `unknown` would hide that.
|
|
39
39
|
*/
|
|
40
40
|
export type DefaultValue = unknown | (() => unknown);
|
|
41
41
|
/** Configuration for one schema entry: how to default, process, and validate a single raw environment value. */
|
|
@@ -68,9 +68,9 @@ export interface EnvDefinition<T> {
|
|
|
68
68
|
* A schema is a map of variable name -> definition.
|
|
69
69
|
*
|
|
70
70
|
* @remarks
|
|
71
|
-
* `EnvDefinition<any>` is used only as the generic *bound* here
|
|
71
|
+
* `EnvDefinition<any>` is used only as the generic *bound* here, never surfaced to consumers.
|
|
72
72
|
* TypeScript infers a precise, per-key literal type for `S` from the object passed to
|
|
73
|
-
* {@link createEnv}
|
|
73
|
+
* {@link createEnv}. So the resolved contract type (see {@link InferEnvValue}) stays fully
|
|
74
74
|
* strict. This is the same variance workaround used by schema libraries like zod/trpc for
|
|
75
75
|
* heterogeneous generic maps.
|
|
76
76
|
*/
|
|
@@ -102,9 +102,9 @@ export interface ContractInternals<S extends EnvSchema = EnvSchema> {
|
|
|
102
102
|
* runtime cache: there is no global env object, only per-feature contracts like this one.
|
|
103
103
|
*
|
|
104
104
|
* @remarks
|
|
105
|
-
* `toString()` is intersected in
|
|
106
|
-
* declaration
|
|
107
|
-
*
|
|
105
|
+
* `toString()` is intersected in, rather than left to the ambient `Object.prototype`
|
|
106
|
+
* declaration. `create.ts` overrides it to return a redacted `EnvContract("name")`
|
|
107
|
+
* representation, never resolved values (ADR 0006). Declaring
|
|
108
108
|
* it here means the type accurately describes what calling `String(contract)` returns.
|
|
109
109
|
*/
|
|
110
110
|
export type EnvContract<S extends EnvSchema> = {
|
|
@@ -127,9 +127,9 @@ export interface validateEnvOptions {
|
|
|
127
127
|
/**
|
|
128
128
|
* Every contract to validate: typically the `contracts` array imported
|
|
129
129
|
* from a generated manifest (see {@link build.generateEnvManifest}). Pass all of them
|
|
130
|
-
* in one call
|
|
131
|
-
*
|
|
132
|
-
*
|
|
130
|
+
* in one call. {@link validateEnv} initializes once per process. A second call
|
|
131
|
+
* returns the first call's cached result without re-running anything, even if
|
|
132
|
+
* it passes a different manifest.
|
|
133
133
|
*/
|
|
134
134
|
manifest: readonly EnvContract<any>[];
|
|
135
135
|
/**
|
|
@@ -137,9 +137,8 @@ export interface validateEnvOptions {
|
|
|
137
137
|
* "production"]`): entirely application-defined; env-cap never
|
|
138
138
|
* detects or infers these, the caller always computes and passes them
|
|
139
139
|
* explicitly. A variable whose `context` isn't in this list is skipped
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
* it): see ADR 0022. A variable with no `context` always participates,
|
|
140
|
+
* (ADR 0022). No default, processor or validator runs for it. It stays
|
|
141
|
+
* not ready, as if this run had never happened. A variable with no `context` always participates,
|
|
143
142
|
* regardless of what's passed here. Omitted (the default) behaves as an
|
|
144
143
|
* empty list: only variables with no `context` participate.
|
|
145
144
|
*
|
|
@@ -179,10 +178,9 @@ export interface CreateEnvOptions {
|
|
|
179
178
|
/**
|
|
180
179
|
* Pass `import.meta.url` here so validation errors point at the file that
|
|
181
180
|
* declared the failing variable (e.g. "features/payments/env.schema.ts")
|
|
182
|
-
* instead of
|
|
183
|
-
*
|
|
184
|
-
* always correct and never goes stale
|
|
185
|
-
* engine rather than hand-typed.
|
|
181
|
+
* instead of the short `name` label. `createEnv` has no portable way to
|
|
182
|
+
* discover its caller's module URL. The JS engine supplies
|
|
183
|
+
* `import.meta.url`, so it is always correct and never goes stale.
|
|
186
184
|
*/
|
|
187
185
|
source?: string;
|
|
188
186
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,sGAAsG;AACtG,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEtD,uGAAuG;AACvG,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAA;AAEtE;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;AAEpD,gHAAgH;AAChH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACxB,sEAAsE;IACtE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;AAE1D,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,GAAG,CAAA;CAAE,GACpD,GAAG,SAAS,MAAM,MAAM,CAAC,GACvB,CAAC,GACD,GAAG,GACL,KAAK,CAAA;AAET;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS;IAClE,kEAAkE;IAClE,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;CAC9B,GACG,CAAC,GACD,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAChC,MAAM,GACN,aAAa,CAAC,CAAC,CAAC,CAAA;AAEtB,0GAA0G;AAC1G,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;IAC7C,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7C,GAAG;IACF,sGAAsG;IACtG,QAAQ,IAAI,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IAEH,QAAQ,EAAE,SAAS,WAAW,CAAC,GAAG,CAAC,EAAE,CAAA;IACrC
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -4,8 +4,8 @@ import type { validateEnvOptions, validateEnvResult } from "./types.js";
|
|
|
4
4
|
* `options.values`, then caches the results.
|
|
5
5
|
*
|
|
6
6
|
* @remarks
|
|
7
|
-
* Idempotent: the first
|
|
8
|
-
* process
|
|
7
|
+
* Idempotent: the first call's outcome, success or failure, holds for the life of the
|
|
8
|
+
* process. Later calls return (or re-throw) that same outcome without re-running any
|
|
9
9
|
* processor or validator. Concurrent in-flight calls share one underlying run. Call
|
|
10
10
|
* `resetEnvCache()` to validate again, for example between test scenarios.
|
|
11
11
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/runtime/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,
|
|
1
|
+
{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/runtime/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyBzF"}
|
|
@@ -125,10 +125,9 @@ export declare function loadTsconfigPaths(product: string, root: string, tsconfi
|
|
|
125
125
|
* this mechanism never overlaps with that trust boundary.
|
|
126
126
|
* - **`.ts`/`.tsx` only.** Matches `resolveRelativeImport()`'s own existing candidate set
|
|
127
127
|
* and `resolve-package-schema.ts`'s `SCHEMA_FILE_EXTENSIONS`: this codebase's static-
|
|
128
|
-
* analysis pipeline
|
|
129
|
-
*
|
|
130
|
-
*
|
|
131
|
-
* warn-don't-guess philosophy exists to avoid.
|
|
128
|
+
* analysis pipeline reads only `.ts` and `.tsx` today. Any other resolved file is a risk.
|
|
129
|
+
* `ts.createSourceFile()` would not error on it; it would parse garbage. That is the
|
|
130
|
+
* "guess" the warn-don't-guess rule exists to prevent.
|
|
132
131
|
*/
|
|
133
132
|
export declare function resolveAliasImport(specifier: string, importingFile: string, resolution: TsconfigPathsResolution, cache: AliasResolutionCache): string | undefined;
|
|
134
133
|
//# sourceMappingURL=resolve-tsconfig-paths.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/_ipc/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAElF;AAED,4IAA4I;AAC5I,MAAM,WAAW,uBAAuB;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAA;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAYD,iIAAiI;AACjI,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAuElC;AAED
|
|
1
|
+
{"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/_ipc/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAElF;AAED,4IAA4I;AAC5I,MAAM,WAAW,uBAAuB;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAA;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAYD,iIAAiI;AACjI,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAuElC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,uBAAuB,EACnC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,SAAS,CAiBpB"}
|
|
@@ -18,9 +18,9 @@ export interface AssembleProjectOptions {
|
|
|
18
18
|
* discovery+link pass. It holds the linked contract graph and the
|
|
19
19
|
* import-resolution context. Every later resolution call
|
|
20
20
|
* (`computeScanSurface()`, `buildDependencyModel()`, ...) must reuse that
|
|
21
|
-
* context to agree with `linkResult`. It also holds a shared file-read cache
|
|
22
|
-
*
|
|
23
|
-
*
|
|
21
|
+
* context to agree with `linkResult`. It also holds a shared file-read cache.
|
|
22
|
+
* So a file that several later passes match is read from disk once. A schema
|
|
23
|
+
* file that the usage pass' broader `SCAN_INCLUDE` also matches is one case.
|
|
24
24
|
*/
|
|
25
25
|
export interface AssembledProject {
|
|
26
26
|
readonly root: string;
|