@lindorm/config 0.3.0 → 0.4.1

package/README.md

@@ -15,7 +15,7 @@ This package is ESM-only. Import it with `import`; `require()` is not supported.
 - Validates the merged configuration with a Zod schema you supply.
 - Loads YAML files from a `config/` directory via the [`config`](https://www.npmjs.com/package/config) (node-config) package, layered by `NODE_ENV`.
 - Loads `.env` and `.env.${NODE_ENV}` via [`@dotenvx/dotenvx`](https://www.npmjs.com/package/@dotenvx/dotenvx).
-- Overrides any nested config value from a single environment variable named in `CONSTANT_CASE`.
+- **Schema-driven** environment-variable override: every leaf in the schema is checked against an env var named `SEGMENT__SEGMENT__LEAF`, regardless of whether YAML scaffolds the key. A service can run with no YAML at all if every required key is in env.
 - Accepts a full configuration object as JSON in the `NODE_CONFIG` environment variable.
 - Coerces string inputs to the schema's primitive types (numbers, booleans, dates, bigints) and parses JSON-encoded arrays and objects.
 - Resolves the running package's `name` and `version` and exposes them as `config.npm.package`.
@@ -54,8 +54,8 @@ console.log(config.npm.package.name); // resolved from the nearest package.json
 
 1. `.env` and `.env.${NODE_ENV}` files (loaded into `process.env` via `@dotenvx/dotenvx`).
 2. YAML files in `./config/` (loaded by the `config` npm package; see its docs for the full list of supported file types and search paths). Keys are normalised to `camelCase`.
-3. `process.env` entries that match a schema key in `CONSTANT_CASE` (nested keys joined with `_`).
-4. `NODE_CONFIG` — a JSON object passed in a single environment variable.
+3. `NODE_CONFIG` — a JSON object passed in a single environment variable.
+4. `process.env` entries derived from the schema's leaves: each leaf path is converted to `CONSTANT_CASE` per segment, joined with `__` (double underscore). Arrays are replaced (not concatenated).
 
 The merged object is then coerced and validated against the Zod schema.
 
@@ -94,20 +94,23 @@ is_production: true
 
 ### Environment variables
 
-Each schema key maps to a single environment variable in `CONSTANT_CASE`. Nested keys are joined with `_`.
+The env-var name for a schema leaf is built segment-by-segment: each path segment becomes `CONSTANT_CASE` (so `maxRetries` ↔ `MAX_RETRIES`), and segments are joined with `__` (double underscore). The double underscore keeps the segment boundary unambiguous when a segment itself contains internal word breaks.
 
-| Schema key              | Environment variable     |
-| ----------------------- | ------------------------ |
-| `server.port`           | `SERVER_PORT`            |
-| `database.poolSize`     | `DATABASE_POOL_SIZE`     |
-| `nested.some.deepValue` | `NESTED_SOME_DEEP_VALUE` |
+| Schema key              | Environment variable       |
+| ----------------------- | -------------------------- |
+| `server.port`           | `SERVER__PORT`             |
+| `database.poolSize`     | `DATABASE__POOL_SIZE`      |
+| `nested.some.deepValue` | `NESTED__SOME__DEEP_VALUE` |
+| `pylon.kek`             | `PYLON__KEK`               |
 
-Values are passed through `safelyParse` from `@lindorm/utils`, so JSON-encoded arrays and objects are decoded automatically:
+Binding is **schema-driven** — every leaf in your Zod schema is looked up in `process.env`. You don't need a YAML scaffold for env vars to work; if the env supplies every required key, you can run without `config/*.yml` at all.
+
+Values are passed through `safelyParse` from `@lindorm/utils`, so JSON-encoded arrays and objects are decoded automatically. Empty-string env values (`MY_VAR=""`) are preserved — they are not treated as "unset". Arrays from env replace (not concatenate) any earlier value:
 
 ```bash
-SERVER_PORT=8080
-DATABASE_URL=postgresql://prod-server/myapp
-DATABASE_POOL_SIZE=50
+SERVER__PORT=8080
+DATABASE__URL=postgresql://prod-server/myapp
+DATABASE__POOL_SIZE=50
 FEATURES='["feature1","feature2","feature3"]'
 IS_PRODUCTION=true
 ```
@@ -119,7 +122,7 @@ IS_PRODUCTION=true
 - `.env.${NODE_ENV}` (only when `NODE_ENV` is set)
 - `.env`
 
-The values become part of `process.env` and follow the same `CONSTANT_CASE` rules as above.
+The values become part of `process.env` and follow the same `__`-separator binding rules as above.
 
 ### `NODE_CONFIG`
 

package/dist/internal/build-env-overrides.d.ts

@@ -0,0 +1,5 @@
+import type { Dict } from "@lindorm/types";
+import { z } from "zod";
+import type { ProcessEnv } from "../types/index.js";
+export declare const buildEnvOverrides: (schema: z.ZodType, processEnv: ProcessEnv) => Dict;
+//# sourceMappingURL=build-env-overrides.d.ts.map

package/dist/internal/build-env-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-env-overrides.d.ts","sourceRoot":"","sources":["../../src/internal/build-env-overrides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA8CpD,eAAO,MAAM,iBAAiB,GAAI,QAAQ,CAAC,CAAC,OAAO,EAAE,YAAY,UAAU,KAAG,IAc7E,CAAC"}

package/dist/internal/build-env-overrides.js

@@ -0,0 +1,31 @@
+import { changeCase } from "@lindorm/case";
+import { safelyParse } from "@lindorm/utils";
+import { z } from "zod";
+import { walkSchemaLeaves } from "./walk-schema.js";
+const buildEnvName = (path) => path.map((segment) => changeCase(segment, "constant")).join("__");
+const setPathValue = (target, path, value) => {
+    let cursor = target;
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        const existing = cursor[key];
+        if (existing === undefined || existing === null || typeof existing !== "object") {
+            cursor[key] = {};
+        }
+        cursor = cursor[key];
+    }
+    cursor[path[path.length - 1]] = value;
+};
+export const buildEnvOverrides = (schema, processEnv) => {
+    const result = {};
+    for (const { path } of walkSchemaLeaves(schema)) {
+        if (path.length === 0)
+            continue;
+        const envName = buildEnvName(path);
+        const raw = processEnv[envName];
+        if (raw === undefined)
+            continue;
+        setPathValue(result, path, safelyParse(raw));
+    }
+    return result;
+};
+//# sourceMappingURL=build-env-overrides.js.map

package/dist/internal/build-env-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-env-overrides.js","sourceRoot":"","sources":["../../src/internal/build-env-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAcpD,MAAM,YAAY,GAAG,CAAC,IAA2B,EAAU,EAAE,CAC3D,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,YAAY,GAAG,CACnB,MAAY,EACZ,IAA2B,EAC3B,KAAc,EACR,EAAE;IACR,IAAI,MAAM,GAAS,MAAM,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChF,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,GAAG,CAAS,CAAC;IAC/B,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACxC,CAAC,CAAC;AAaF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAiB,EAAE,UAAsB,EAAQ,EAAE;IACnF,MAAM,MAAM,GAAS,EAAE,CAAC;IAExB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEhC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAEhC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/internal/deep-override.d.ts

@@ -0,0 +1,3 @@
+import type { Dict } from "@lindorm/types";
+export declare const deepOverride: (...sources: Array<Dict | undefined>) => Dict;
+//# sourceMappingURL=deep-override.d.ts.map

package/dist/internal/deep-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-override.d.ts","sourceRoot":"","sources":["../../src/internal/deep-override.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAe3C,eAAO,MAAM,YAAY,GAAI,GAAG,SAAS,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,KAAG,IAiBlE,CAAC"}

package/dist/internal/deep-override.js

@@ -0,0 +1,20 @@
+import { isObject } from "@lindorm/is";
+export const deepOverride = (...sources) => {
+    const result = {};
+    for (const source of sources) {
+        if (!source)
+            continue;
+        for (const [key, value] of Object.entries(source)) {
+            if (value === undefined)
+                continue;
+            if (isObject(value) && isObject(result[key])) {
+                result[key] = deepOverride(result[key], value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=deep-override.js.map

package/dist/internal/deep-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-override.js","sourceRoot":"","sources":["../../src/internal/deep-override.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgBvC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,OAAgC,EAAQ,EAAE;IACxE,MAAM,MAAM,GAAS,EAAE,CAAC;IAExB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAElC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/internal/index.d.ts

@@ -1,5 +1,8 @@
+export * from "./build-env-overrides.js";
 export * from "./coerce-all.js";
+export * from "./deep-override.js";
 export * from "./load-config.js";
 export * from "./load-node-config.js";
 export * from "./load-npm-info.js";
+export * from "./walk-schema.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/internal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/internal/index.js

@@ -1,5 +1,8 @@
+export * from "./build-env-overrides.js";
 export * from "./coerce-all.js";
+export * from "./deep-override.js";
 export * from "./load-config.js";
 export * from "./load-node-config.js";
 export * from "./load-npm-info.js";
+export * from "./walk-schema.js";
 //# sourceMappingURL=index.js.map

package/dist/internal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/internal/load-config.d.ts

@@ -1,4 +1,3 @@
 import type { Dict } from "@lindorm/types";
-import type { ProcessEnv } from "../types/index.js";
-export declare const loadConfig: (processEnv: ProcessEnv) => Dict;
+export declare const loadConfig: () => Dict;
 //# sourceMappingURL=load-config.d.ts.map

package/dist/internal/load-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/internal/load-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,eAAO,MAAM,UAAU,GAAI,YAAY,UAAU,KAAG,IAKnD,CAAC"}
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/internal/load-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAY3C,eAAO,MAAM,UAAU,QAAO,IAG7B,CAAC"}

package/dist/internal/load-config.js

@@ -1,9 +1,7 @@
 import { changeKeys } from "@lindorm/case";
 import c from "config";
-import { mergeObjectWithProcessEnv } from "./merge-object-with-process-env.js";
-export const loadConfig = (processEnv) => {
+export const loadConfig = () => {
     const config = c.util.toObject();
-    const merged = mergeObjectWithProcessEnv(processEnv, config);
-    return changeKeys(merged, "camel");
+    return changeKeys(config, "camel");
 };
 //# sourceMappingURL=load-config.js.map

package/dist/internal/load-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/internal/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAsB,EAAQ,EAAE;IACzD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAE7D,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC"}
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/internal/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,CAAC,MAAM,QAAQ,CAAC;AAWvB,MAAM,CAAC,MAAM,UAAU,GAAG,GAAS,EAAE;IACnC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAU,CAAC;IACzC,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC"}

package/dist/internal/walk-schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export type SchemaLeaf = {
+    path: ReadonlyArray<string>;
+    schema: z.ZodType;
+};
+export declare const walkSchemaLeaves: (schema: z.ZodType, path?: ReadonlyArray<string>) => Array<SchemaLeaf>;
+//# sourceMappingURL=walk-schema.d.ts.map

package/dist/internal/walk-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-schema.d.ts","sourceRoot":"","sources":["../../src/internal/walk-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;CACnB,CAAC;AAiBF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,CAAC,CAAC,OAAO,EACjB,OAAM,aAAa,CAAC,MAAM,CAAM,KAC/B,KAAK,CAAC,UAAU,CAyBlB,CAAC"}

package/dist/internal/walk-schema.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+const getDef = (schema) => schema._zod?.def ?? schema._def ?? {};
+export const walkSchemaLeaves = (schema, path = []) => {
+    const def = getDef(schema);
+    switch (def.type) {
+        case "object": {
+            const shape = def.shape;
+            if (!shape)
+                return [{ path, schema }];
+            const out = [];
+            for (const key of Object.keys(shape)) {
+                out.push(...walkSchemaLeaves(shape[key], [...path, key]));
+            }
+            return out;
+        }
+        case "optional":
+        case "nullable":
+        case "default":
+        case "readonly":
+        case "nonoptional":
+            return walkSchemaLeaves(def.innerType, path);
+        default:
+            return [{ path, schema }];
+    }
+};
+//# sourceMappingURL=walk-schema.js.map

package/dist/internal/walk-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-schema.js","sourceRoot":"","sources":["../../src/internal/walk-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,MAAM,GAAG,CAAC,MAAiB,EAAuC,EAAE,CACvE,MAAc,CAAC,IAAI,EAAE,GAAG,IAAK,MAAc,CAAC,IAAI,IAAI,EAAE,CAAC;AAc1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAiB,EACjB,OAA8B,EAAE,EACb,EAAE;IACrB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE3B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,GAAG,CAAC,KAA8C,CAAC;YACjE,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAEtC,MAAM,GAAG,GAAsB,EAAE,CAAC;YAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,gBAAgB,CAAC,GAAG,CAAC,SAAsB,EAAE,IAAI,CAAC,CAAC;QAE5D;YACE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/utils/configuration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,MAAM,oBAAoB,GAAG;IAcjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAC/D,QAAQ,CAAC,EACT,UAAS,oBAAyB,KACjC,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAoBzC,CAAC"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/utils/configuration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,oBAAoB,GAAG;IAcjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAoBF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAC/D,QAAQ,CAAC,EACT,UAAS,oBAAyB,KACjC,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAuBzC,CAAC"}

package/dist/utils/configuration.js

@@ -1,22 +1,22 @@
 import dotenvx from "@dotenvx/dotenvx";
-import { merge } from "@lindorm/utils";
 import { z } from "zod";
-import { coerceAll, loadConfig, loadNodeConfig, loadNpmInfo } from "../internal/index.js";
+import { buildEnvOverrides, coerceAll, deepOverride, loadConfig, loadNodeConfig, loadNpmInfo, } from "../internal/index.js";
 export const configuration = (schema, options = {}) => {
     dotenvx.config({
         path: process.env.NODE_ENV ? [`.env.${process.env.NODE_ENV}`, ".env"] : ".env",
         quiet: true,
     });
-    const config = loadConfig(process.env);
+    const wrapped = z.object(schema);
+    const yaml = loadConfig();
     const node = loadNodeConfig(process.env);
-    const merged = merge(config, node);
-    const zod = coerceAll(z.object(schema));
-    const parsed = zod.parse(merged);
+    const env = buildEnvOverrides(wrapped, process.env);
+    const merged = deepOverride(yaml, node, env);
+    const parsed = coerceAll(wrapped).parse(merged);
     const npm = {
         npm: {
             package: loadNpmInfo(options.scope),
         },
     };
-    return merge(parsed, npm);
+    return deepOverride(parsed, npm);
 };
 //# sourceMappingURL=configuration.js.map

package/dist/utils/configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/utils/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAmB1F,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAS,EACT,UAAgC,EAAE,EACQ,EAAE;IAC5C,OAAO,CAAC,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;QAC9E,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEnC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC,MAAM,GAAG,GAAG;QACV,GAAG,EAAE;YACH,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACpC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC,MAAa,EAAE,GAAU,CAAC,CAAC;AAC1C,CAAC,CAAC"}
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/utils/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAsC9B,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAS,EACT,UAAgC,EAAE,EACQ,EAAE;IAC5C,OAAO,CAAC,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;QAC9E,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG;QACV,GAAG,EAAE;YACH,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACpC;KACF,CAAC;IAEF,OAAO,YAAY,CAAC,MAAa,EAAE,GAAU,CAAQ,CAAC;AACxD,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lindorm/config",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "license": "AGPL-3.0-or-later",
   "author": "Jonn Nilsson",
   "repository": {
@@ -11,6 +11,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist"
+  ],
   "bin": {
     "config": "dist/cli.js"
   },
@@ -37,10 +40,10 @@
   },
   "dependencies": {
     "@dotenvx/dotenvx": "^1.54.1",
-    "@lindorm/case": "^0.2.0",
-    "@lindorm/is": "^0.2.0",
-    "@lindorm/types": "^0.6.0",
-    "@lindorm/utils": "^0.8.0",
+    "@lindorm/case": "^0.2.1",
+    "@lindorm/is": "^0.2.1",
+    "@lindorm/types": "^0.6.1",
+    "@lindorm/utils": "^0.8.1",
     "commander": "^14.0.3",
     "config": "^4.4.1",
     "dotenv": "^17.3.1",
@@ -51,5 +54,5 @@
     "@types/config": "^3.3.5",
     "@types/js-yaml": "^4.0.9"
   },
-  "gitHead": "a2b0a53295aebda806b4057f34707e8583570265"
+  "gitHead": "da067071d415e07d7d25bbac1621b9e02fcc3166"
 }

package/.env.test

@@ -1 +0,0 @@
-WITH_DOT_ENV_REPLACEMENT="two"

package/.node_config.json

@@ -1,3 +0,0 @@
-{
-  "test": "test"
-}

package/.node_config.yml

@@ -1,3 +0,0 @@
-test2:
-  test3:
-    test4: test5

package/CHANGELOG.md

@@ -1,80 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [0.3.0](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.10...@lindorm/config@0.3.0) (2026-05-02)
-
-### Features
-
-- **config:** resolve npm.package via explicit scope, not cwd ([279b633](https://github.com/lindorm-io/monorepo/commit/279b63307beb103a82f15aeb63e637f168ef9635))
-- migrate 20 packages from jest to vitest ([d8bfda8](https://github.com/lindorm-io/monorepo/commit/d8bfda8854dc1cb9537ba0b3e47ec4e4c7bded08))
-
-## [0.2.10](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.9...@lindorm/config@0.2.10) (2026-04-19)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.9](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.8...@lindorm/config@0.2.9) (2026-04-15)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.8](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.7...@lindorm/config@0.2.8) (2026-04-01)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.7](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.6...@lindorm/config@0.2.7) (2026-03-13)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.6](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.5...@lindorm/config@0.2.6) (2026-03-13)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.5](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.4...@lindorm/config@0.2.5) (2026-02-17)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.4](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.3...@lindorm/config@0.2.4) (2025-09-18)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.3](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.2...@lindorm/config@0.2.3) (2025-07-19)
-
-### Bug Fixes
-
-- remove unnecessary enums ([d0364d9](https://github.com/lindorm-io/monorepo/commit/d0364d97ad0dc621a1020d4ddba8d3a87959838d))
-
-## [0.2.2](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.1...@lindorm/config@0.2.2) (2025-07-12)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.2.1](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.2.0...@lindorm/config@0.2.1) (2025-07-10)
-
-**Note:** Version bump only for package @lindorm/config
-
-# [0.2.0](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.1.2...@lindorm/config@0.2.0) (2025-06-17)
-
-### Bug Fixes
-
-- solve issues with merge ([6561027](https://github.com/lindorm-io/monorepo/commit/6561027172f31f154be84f122a68c1361399abd3))
-- update cli ([552a9f0](https://github.com/lindorm-io/monorepo/commit/552a9f0a0839d756d9e856b7a6842aee4e01cac5))
-
-### Features
-
-- add cli for generating node_config env ([57e5ff9](https://github.com/lindorm-io/monorepo/commit/57e5ff9cad0aa655420f6232f23ae526545331b4))
-- use zod to coerce and validate config ([03ed9b6](https://github.com/lindorm-io/monorepo/commit/03ed9b65f95bab3168a081c669118b3ed6d45538))
-
-## [0.1.2](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.1.1...@lindorm/config@0.1.2) (2025-01-28)
-
-**Note:** Version bump only for package @lindorm/config
-
-## [0.1.1](https://github.com/lindorm-io/monorepo/compare/@lindorm/config@0.1.0...@lindorm/config@0.1.1) (2024-10-12)
-
-**Note:** Version bump only for package @lindorm/config
-
-# 0.1.0 (2024-09-20)
-
-### Features
-
-- initialise config package ([cd119e3](https://github.com/lindorm-io/monorepo/commit/cd119e37df2a5fa9979d21e56e5835864ba0744b))
-- initialise configuration package ([42b8b41](https://github.com/lindorm-io/monorepo/commit/42b8b414a6fc2845a79fa89fabd0c0ff89dd3477))

package/dist/internal/find-process-env-value.d.ts

@@ -1,3 +0,0 @@
-import type { ProcessEnv } from "../types/index.js";
-export declare const findProcessEnvValue: (processEnv: ProcessEnv, key: string, parent?: string) => any;
-//# sourceMappingURL=find-process-env-value.d.ts.map

package/dist/internal/find-process-env-value.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"find-process-env-value.d.ts","sourceRoot":"","sources":["../../src/internal/find-process-env-value.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,mBAAmB,GAC9B,YAAY,UAAU,EACtB,KAAK,MAAM,EACX,SAAS,MAAM,KACd,GAQF,CAAC"}

package/dist/internal/find-process-env-value.js

@@ -1,10 +0,0 @@
-import { changeCase } from "@lindorm/case";
-import { safelyParse } from "@lindorm/utils";
-export const findProcessEnvValue = (processEnv, key, parent) => {
-    const k = changeCase(key, "constant");
-    const pkey = parent ? changeCase(parent, "constant") : undefined;
-    const search = pkey ? `${pkey}_${k}` : k;
-    const value = processEnv[search] ? processEnv[search] : undefined;
-    return value ? safelyParse(value) : undefined;
-};
-//# sourceMappingURL=find-process-env-value.js.map

package/dist/internal/find-process-env-value.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"find-process-env-value.js","sourceRoot":"","sources":["../../src/internal/find-process-env-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAAsB,EACtB,GAAW,EACX,MAAe,EACV,EAAE;IACP,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC,CAAC"}

package/dist/internal/merge-object-with-process-env.d.ts

@@ -1,4 +0,0 @@
-import type { Dict } from "@lindorm/types";
-import type { ProcessEnv } from "../types/index.js";
-export declare const mergeObjectWithProcessEnv: (processEnv: ProcessEnv, config: Dict, parent?: string) => Dict;
-//# sourceMappingURL=merge-object-with-process-env.d.ts.map

package/dist/internal/merge-object-with-process-env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-object-with-process-env.d.ts","sourceRoot":"","sources":["../../src/internal/merge-object-with-process-env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,eAAO,MAAM,yBAAyB,GACpC,YAAY,UAAU,EACtB,QAAQ,IAAI,EACZ,SAAS,MAAM,KACd,IAqBF,CAAC"}

package/dist/internal/merge-object-with-process-env.js

@@ -1,20 +0,0 @@
-import { isObject, isUndefined } from "@lindorm/is";
-import { findProcessEnvValue } from "./find-process-env-value.js";
-export const mergeObjectWithProcessEnv = (processEnv, config, parent) => {
-    const result = {};
-    for (const [key, value] of Object.entries(config)) {
-        const env = findProcessEnvValue(processEnv, key, parent);
-        if (!isUndefined(env)) {
-            result[key] = env;
-            continue;
-        }
-        if (isObject(value)) {
-            const pkey = parent ? `${parent}_${key}` : key;
-            result[key] = mergeObjectWithProcessEnv(processEnv, value, pkey);
-            continue;
-        }
-        result[key] = value;
-    }
-    return result;
-};
-//# sourceMappingURL=merge-object-with-process-env.js.map

package/dist/internal/merge-object-with-process-env.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-object-with-process-env.js","sourceRoot":"","sources":["../../src/internal/merge-object-with-process-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,UAAsB,EACtB,MAAY,EACZ,MAAe,EACT,EAAE;IACR,MAAM,MAAM,GAAS,EAAE,CAAC;IAExB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAEzD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,yBAAyB,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/vitest.config.mjs

@@ -1,3 +0,0 @@
-import { createVitestConfig } from "../../vitest.config.base.mjs";
-
-export default createVitestConfig();