@cogs/config 0.2.0 → 0.5.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.
Files changed (63) hide show
  1. package/README.md +145 -8
  2. package/dist/cjs/correct-env.js +44 -0
  3. package/dist/cjs/dotenv-checkers.js +176 -0
  4. package/dist/cjs/dotenv-correlation.js +95 -0
  5. package/dist/cjs/dotenv-files.js +43 -0
  6. package/dist/cjs/dotenv-fixers.js +88 -0
  7. package/dist/cjs/dotenv-with-expand.js +123 -0
  8. package/dist/cjs/envs.js +93 -0
  9. package/dist/cjs/index.js +23 -0
  10. package/dist/cjs/package.json +3 -0
  11. package/dist/cjs/preload.js +18 -0
  12. package/dist/cjs/process-env.js +39 -0
  13. package/dist/cjs/redact.js +27 -0
  14. package/dist/cjs/utils.js +65 -0
  15. package/dist/cli-core.d.ts +72 -0
  16. package/dist/cli-core.d.ts.map +1 -0
  17. package/dist/cli-core.js +311 -0
  18. package/dist/cli-core.js.map +1 -0
  19. package/dist/cli.d.ts +9 -0
  20. package/dist/cli.d.ts.map +1 -0
  21. package/dist/cli.js +17 -0
  22. package/dist/cli.js.map +1 -0
  23. package/dist/correct-env.d.ts.map +1 -1
  24. package/dist/correct-env.js.map +1 -1
  25. package/dist/dotenv-checkers.d.ts +61 -11
  26. package/dist/dotenv-checkers.d.ts.map +1 -1
  27. package/dist/dotenv-checkers.js +87 -25
  28. package/dist/dotenv-checkers.js.map +1 -1
  29. package/dist/dotenv-correlation.d.ts +23 -0
  30. package/dist/dotenv-correlation.d.ts.map +1 -0
  31. package/dist/dotenv-correlation.js +92 -0
  32. package/dist/dotenv-correlation.js.map +1 -0
  33. package/dist/dotenv-files.d.ts +24 -0
  34. package/dist/dotenv-files.d.ts.map +1 -0
  35. package/dist/dotenv-files.js +40 -0
  36. package/dist/dotenv-files.js.map +1 -0
  37. package/dist/dotenv-fixers.d.ts.map +1 -1
  38. package/dist/dotenv-fixers.js +7 -7
  39. package/dist/dotenv-fixers.js.map +1 -1
  40. package/dist/dotenv-with-expand.d.ts +1 -1
  41. package/dist/dotenv-with-expand.d.ts.map +1 -1
  42. package/dist/dotenv-with-expand.js +5 -5
  43. package/dist/dotenv-with-expand.js.map +1 -1
  44. package/dist/envs.d.ts +9 -1
  45. package/dist/envs.d.ts.map +1 -1
  46. package/dist/envs.js +58 -31
  47. package/dist/envs.js.map +1 -1
  48. package/dist/index.d.ts +7 -7
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +7 -7
  51. package/dist/index.js.map +1 -1
  52. package/dist/preload.js +3 -3
  53. package/dist/preload.js.map +1 -1
  54. package/dist/process-env.d.ts.map +1 -1
  55. package/dist/process-env.js.map +1 -1
  56. package/dist/redact.d.ts +18 -0
  57. package/dist/redact.d.ts.map +1 -0
  58. package/dist/redact.js +24 -0
  59. package/dist/redact.js.map +1 -0
  60. package/dist/utils.d.ts.map +1 -1
  61. package/dist/utils.js +2 -2
  62. package/dist/utils.js.map +1 -1
  63. package/package.json +18 -7
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Value masking for lint findings.
3
+ *
4
+ * Local port of `packages/env-doctor/src/redact.ts`'s `maskLast4`, duplicated
5
+ * deliberately rather than imported across packages: `@cogs/config` is the
6
+ * published, dependency-light loader that every app preloads, and
7
+ * `@cogs/env-doctor` is a private tool. A cross-package import would invert that
8
+ * dependency direction for four lines of string slicing.
9
+ */
10
+ /**
11
+ * Mask a value to its last 4 characters so a finding can say *which* value it
12
+ * is about without printing a secret in full.
13
+ *
14
+ * Values of 4 characters or fewer are masked outright rather than shown, and an
15
+ * empty value renders as `(empty)` so a `KEY=` line is still legible.
16
+ */
17
+ export declare const maskLast4: (value: string) => string;
18
+ //# sourceMappingURL=redact.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAIzC,CAAA"}
package/dist/redact.js ADDED
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Value masking for lint findings.
3
+ *
4
+ * Local port of `packages/env-doctor/src/redact.ts`'s `maskLast4`, duplicated
5
+ * deliberately rather than imported across packages: `@cogs/config` is the
6
+ * published, dependency-light loader that every app preloads, and
7
+ * `@cogs/env-doctor` is a private tool. A cross-package import would invert that
8
+ * dependency direction for four lines of string slicing.
9
+ */
10
+ /**
11
+ * Mask a value to its last 4 characters so a finding can say *which* value it
12
+ * is about without printing a secret in full.
13
+ *
14
+ * Values of 4 characters or fewer are masked outright rather than shown, and an
15
+ * empty value renders as `(empty)` so a `KEY=` line is still legible.
16
+ */
17
+ export const maskLast4 = (value) => {
18
+ if (value.length === 0)
19
+ return '(empty)';
20
+ if (value.length <= 4)
21
+ return '****';
22
+ return `****${value.slice(-4)}`;
23
+ };
24
+ //# sourceMappingURL=redact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACpC,OAAO,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACjC,CAAC,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,QAAQ,CAAC,EACT,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,CAcF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,QAAQ,CAAC,EACT,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,CAYF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,EACpB,cAAc,MAAM,KACnB,MAAkD,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAavD,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OACxB,CAAC"}
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,QAAQ,CAAC,EACT,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,CAcF,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,QAAQ,CAAC,EACT,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,CAYF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,EACpB,cAAc,MAAM,KACnB,MAAkD,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAavD,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OACxB,CAAA"}
package/dist/utils.js CHANGED
@@ -1,4 +1,4 @@
1
- import path from "node:path";
1
+ import path from 'node:path';
2
2
  export const mergeDefaults = (target, source) => {
3
3
  const targetRecord = target;
4
4
  if (!source) {
@@ -37,7 +37,7 @@ export const resolveApp = (relativePath, appDirectory) => path.resolve(appDirect
37
37
  * @returns The string with invalid leading characters removed.
38
38
  */
39
39
  export const removeInvalidLeadingChars = (str) => {
40
- const chars = str.split("");
40
+ const chars = str.split('');
41
41
  let notFound = true;
42
42
  let i = 0;
43
43
  while (notFound && i < chars.length) {
package/dist/utils.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAS,EACT,MAAgC,EAC7B,EAAE;IACL,MAAM,YAAY,GAAG,MAAiC,CAAC;IAEvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAAS,EACT,MAAgC,EAC7B,EAAE;IACL,MAAM,YAAY,GAAG,MAAiC,CAAC;IAEvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,YAAoB,EACpB,YAAoB,EACZ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAW,EAAU,EAAE;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,QAAQ,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7D,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAA8B,EAAW,EAAE,CACjE,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC"}
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAS,EACT,MAAgC,EAC7B,EAAE;IACL,MAAM,YAAY,GAAG,MAAiC,CAAA;IAEtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAC3B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAAS,EACT,MAAgC,EAC7B,EAAE;IACL,MAAM,YAAY,GAAG,MAAiC,CAAA;IAEtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,YAAoB,EACpB,YAAoB,EACZ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAW,EAAU,EAAE;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC3B,IAAI,QAAQ,GAAG,IAAI,CAAA;IACnB,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,QAAQ,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7D,QAAQ,GAAG,KAAK,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,CAAA;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACrB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAA8B,EAAW,EAAE,CACjE,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,CAAA"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@cogs/config",
3
- "version": "0.2.0",
4
- "description": "Framework-agnostic layered-dotenv loader — resolves the canonical .env file chain, expands ${VAR} references, and folds values into process.env with deploy-injected variables staying authoritative",
3
+ "version": "0.5.0",
4
+ "description": "Framework-agnostic layered-dotenv loader — resolves the canonical .env file chain, expands ${VAR} references, and folds values into process.env with deploy-injected variables staying authoritative. Dual ESM+CJS so it works from an ESM --import preload or a CJS --require hook (dd-trace and other one-offs)",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
@@ -9,22 +9,33 @@
9
9
  "directory": "packages/config"
10
10
  },
11
11
  "type": "module",
12
- "main": "./dist/index.js",
12
+ "bin": {
13
+ "config-lint": "./dist/cli.js"
14
+ },
15
+ "main": "./dist/cjs/index.js",
16
+ "module": "./dist/index.js",
13
17
  "types": "./dist/index.d.ts",
14
18
  "exports": {
15
19
  ".": {
16
20
  "types": "./dist/index.d.ts",
17
- "import": "./dist/index.js"
21
+ "import": "./dist/index.js",
22
+ "require": "./dist/cjs/index.js"
18
23
  },
19
24
  "./preload": {
20
25
  "types": "./dist/preload.d.ts",
21
- "import": "./dist/preload.js"
26
+ "import": "./dist/preload.js",
27
+ "require": "./dist/cjs/preload.js"
28
+ },
29
+ "./register": {
30
+ "require": "./dist/cjs/preload.js",
31
+ "default": "./dist/cjs/preload.js"
22
32
  },
23
33
  "./package.json": "./package.json"
24
34
  },
25
35
  "files": [
26
36
  "dist",
27
- "!dist/tsconfig.tsbuildinfo"
37
+ "!dist/tsconfig.tsbuildinfo",
38
+ "!dist/cjs/tsconfig.tsbuildinfo"
28
39
  ],
29
40
  "publishConfig": {
30
41
  "access": "public"
@@ -37,7 +48,7 @@
37
48
  "vitest": "^3.0.0"
38
49
  },
39
50
  "scripts": {
40
- "build": "tsc -p tsconfig.json",
51
+ "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node ./scripts/postbuild-cjs.mjs && chmod +x dist/cli.js",
41
52
  "lint": "biome check .",
42
53
  "typecheck": "tsc -p tsconfig.json --noEmit",
43
54
  "test": "vitest run"