@philiprehberger/config-layer 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philiprehberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# @philiprehberger/config-layer
+
+[![CI](https://github.com/philiprehberger/ts-config-layer/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/ts-config-layer/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@philiprehberger/config-layer.svg)](https://www.npmjs.com/package/@philiprehberger/config-layer)
+[![License](https://img.shields.io/github/license/philiprehberger/ts-config-layer)](LICENSE)
+
+Layered configuration loader with typed output and multiple sources
+
+## Installation
+
+```bash
+npm install @philiprehberger/config-layer
+```
+
+## Usage
+
+```ts
+import { loadConfig, envSource, objectSource } from '@philiprehberger/config-layer';
+
+const config = loadConfig({
+  port: { type: 'number', default: 3000 },
+  dbUrl: { type: 'string', required: true, env: 'DATABASE_URL' },
+  debug: { type: 'boolean', default: false },
+}, [
+  envSource(),
+  objectSource({ port: 8080 }),
+]);
+
+// config.port → 8080 (from objectSource, overrides default)
+// config.dbUrl → from DATABASE_URL env var
+// config.debug → false (default)
+```
+
+### Sources
+
+Sources are applied in order — later sources override earlier ones:
+
+```ts
+const config = loadConfig(schema, [
+  envSource(),                    // Load from process.env
+  envSource('APP_'),              // Load from env vars with APP_ prefix
+  objectSource({ port: 9090 }),   // Override with explicit values
+]);
+```
+
+### Schema
+
+```ts
+const schema = {
+  // Shorthand
+  host: 'string',
+  port: 'number',
+  debug: 'boolean',
+
+  // Full definition
+  dbUrl: {
+    type: 'string',
+    required: true,     // Throws if missing (default: true)
+    env: 'DATABASE_URL', // Map to specific env var name
+    default: undefined,  // Default value if not provided
+  },
+};
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `loadConfig(schema, sources)` | Load and validate config from sources |
+| `envSource(prefix?)` | Read from `process.env`, optionally filtering by prefix |
+| `objectSource(obj)` | Read from a plain object |
+
+### `ConfigFieldDef`
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `type` | `'string' \| 'number' \| 'boolean'` | — | Value type (auto-coerced) |
+| `required` | `boolean` | `true` | Throw if missing |
+| `default` | `string \| number \| boolean` | — | Default value |
+| `env` | `string` | — | Override env var name |
+
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,110 @@
+'use strict';
+
+// src/loader.ts
+function normalizeField(field) {
+  if (typeof field === "string") {
+    return { type: field };
+  }
+  return field;
+}
+function coerce(value, type) {
+  switch (type) {
+    case "number": {
+      const n = Number(value);
+      if (isNaN(n)) throw new Error(`Cannot convert "${value}" to number`);
+      return n;
+    }
+    case "boolean":
+      return value === "true" || value === "1" || value === "yes";
+    case "string":
+    default:
+      return value;
+  }
+}
+function loadConfig(schema, sources) {
+  var _a, _b, _c;
+  const merged = {};
+  for (const source of sources) {
+    const data = source.load();
+    for (const [key, value] of Object.entries(data)) {
+      if (value !== void 0) {
+        merged[key] = value;
+      }
+    }
+  }
+  const result = {};
+  const errors = [];
+  for (const [key, rawField] of Object.entries(schema)) {
+    const field = normalizeField(rawField);
+    const envKey = (_b = (_a = field.env) == null ? void 0 : _a.toLowerCase()) != null ? _b : key.toLowerCase();
+    const raw = (_c = merged[envKey]) != null ? _c : merged[key.toLowerCase()];
+    if (raw !== void 0) {
+      try {
+        result[key] = coerce(raw, field.type);
+      } catch (e) {
+        errors.push(`${key}: ${e instanceof Error ? e.message : String(e)}`);
+      }
+    } else if (field.default !== void 0) {
+      result[key] = field.default;
+    } else if (field.required !== false) {
+      errors.push(`${key}: required but not provided`);
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`Config validation failed:
+  ${errors.join("\n  ")}`);
+  }
+  return result;
+}
+
+// src/sources.ts
+function envSource(prefix) {
+  return {
+    name: "env",
+    load() {
+      const env = {};
+      try {
+        if (typeof globalThis !== "undefined" && "process" in globalThis) {
+          const proc = globalThis.process;
+          if (proc.env) {
+            if (prefix) {
+              const upper = prefix.toUpperCase();
+              for (const [key, value] of Object.entries(proc.env)) {
+                if (key.startsWith(upper)) {
+                  const stripped = key.slice(upper.length).replace(/^_/, "");
+                  env[stripped.toLowerCase()] = value;
+                }
+              }
+            } else {
+              for (const [key, value] of Object.entries(proc.env)) {
+                env[key.toLowerCase()] = value;
+              }
+            }
+          }
+        }
+      } catch (e) {
+      }
+      return env;
+    }
+  };
+}
+function objectSource(obj) {
+  return {
+    name: "object",
+    load() {
+      const result = {};
+      for (const [key, value] of Object.entries(obj)) {
+        if (value !== void 0 && value !== null) {
+          result[key.toLowerCase()] = String(value);
+        }
+      }
+      return result;
+    }
+  };
+}
+
+exports.envSource = envSource;
+exports.loadConfig = loadConfig;
+exports.objectSource = objectSource;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/sources.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ConfigSchema, ConfigFieldDef, ConfigSource, ConfigValueType } from './types.js';\n\nfunction normalizeField(field: ConfigFieldDef | ConfigValueType): ConfigFieldDef {\n  if (typeof field === 'string') {\n    return { type: field };\n  }\n  return field;\n}\n\nfunction coerce(value: string, type: ConfigValueType): string | number | boolean {\n  switch (type) {\n    case 'number': {\n      const n = Number(value);\n      if (isNaN(n)) throw new Error(`Cannot convert \"${value}\" to number`);\n      return n;\n    }\n    case 'boolean':\n      return value === 'true' || value === '1' || value === 'yes';\n    case 'string':\n    default:\n      return value;\n  }\n}\n\nexport function loadConfig<T extends ConfigSchema>(\n  schema: T,\n  sources: ConfigSource[],\n): { [K in keyof T]: T[K] extends { type: 'number' } | 'number' ? number : T[K] extends { type: 'boolean' } | 'boolean' ? boolean : string } {\n  const merged: Record<string, string | undefined> = {};\n\n  for (const source of sources) {\n    const data = source.load();\n    for (const [key, value] of Object.entries(data)) {\n      if (value !== undefined) {\n        merged[key] = value;\n      }\n    }\n  }\n\n  const result: Record<string, unknown> = {};\n  const errors: string[] = [];\n\n  for (const [key, rawField] of Object.entries(schema)) {\n    const field = normalizeField(rawField);\n    const envKey = field.env?.toLowerCase() ?? key.toLowerCase();\n    const raw = merged[envKey] ?? merged[key.toLowerCase()];\n\n    if (raw !== undefined) {\n      try {\n        result[key] = coerce(raw, field.type);\n      } catch (e) {\n        errors.push(`${key}: ${e instanceof Error ? e.message : String(e)}`);\n      }\n    } else if (field.default !== undefined) {\n      result[key] = field.default;\n    } else if (field.required !== false) {\n      errors.push(`${key}: required but not provided`);\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new Error(`Config validation failed:\\n  ${errors.join('\\n  ')}`);\n  }\n\n  return result as ReturnType<typeof loadConfig<T>>;\n}\n","import type { ConfigSource } from './types.js';\n\nexport function envSource(prefix?: string): ConfigSource {\n  return {\n    name: 'env',\n    load() {\n      const env: Record<string, string | undefined> = {};\n      try {\n        if (typeof globalThis !== 'undefined' && 'process' in globalThis) {\n          const proc = (globalThis as Record<string, unknown>).process as { env?: Record<string, string | undefined> };\n          if (proc.env) {\n            if (prefix) {\n              const upper = prefix.toUpperCase();\n              for (const [key, value] of Object.entries(proc.env)) {\n                if (key.startsWith(upper)) {\n                  const stripped = key.slice(upper.length).replace(/^_/, '');\n                  env[stripped.toLowerCase()] = value;\n                }\n              }\n            } else {\n              for (const [key, value] of Object.entries(proc.env)) {\n                env[key.toLowerCase()] = value;\n              }\n            }\n          }\n        }\n      } catch { /* non-node environment */ }\n      return env;\n    },\n  };\n}\n\nexport function objectSource(obj: Record<string, unknown>): ConfigSource {\n  return {\n    name: 'object',\n    load() {\n      const result: Record<string, string | undefined> = {};\n      for (const [key, value] of Object.entries(obj)) {\n        if (value !== undefined && value !== null) {\n          result[key.toLowerCase()] = String(value);\n        }\n      }\n      return result;\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+type ConfigValueType = 'string' | 'number' | 'boolean';
+interface ConfigFieldDef {
+    type: ConfigValueType;
+    required?: boolean;
+    default?: string | number | boolean;
+    env?: string;
+}
+type ConfigSchema = Record<string, ConfigFieldDef | ConfigValueType>;
+type InferConfig<T extends ConfigSchema> = {
+    [K in keyof T]: T[K] extends 'string' ? string : T[K] extends 'number' ? number : T[K] extends 'boolean' ? boolean : T[K] extends {
+        type: 'string';
+    } ? string : T[K] extends {
+        type: 'number';
+    } ? number : T[K] extends {
+        type: 'boolean';
+    } ? boolean : never;
+};
+interface ConfigSource {
+    name: string;
+    load(): Record<string, string | undefined>;
+}
+
+declare function loadConfig<T extends ConfigSchema>(schema: T, sources: ConfigSource[]): {
+    [K in keyof T]: T[K] extends {
+        type: 'number';
+    } | 'number' ? number : T[K] extends {
+        type: 'boolean';
+    } | 'boolean' ? boolean : string;
+};
+
+declare function envSource(prefix?: string): ConfigSource;
+declare function objectSource(obj: Record<string, unknown>): ConfigSource;
+
+export { type ConfigFieldDef, type ConfigSchema, type ConfigSource, type ConfigValueType, type InferConfig, envSource, loadConfig, objectSource };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+type ConfigValueType = 'string' | 'number' | 'boolean';
+interface ConfigFieldDef {
+    type: ConfigValueType;
+    required?: boolean;
+    default?: string | number | boolean;
+    env?: string;
+}
+type ConfigSchema = Record<string, ConfigFieldDef | ConfigValueType>;
+type InferConfig<T extends ConfigSchema> = {
+    [K in keyof T]: T[K] extends 'string' ? string : T[K] extends 'number' ? number : T[K] extends 'boolean' ? boolean : T[K] extends {
+        type: 'string';
+    } ? string : T[K] extends {
+        type: 'number';
+    } ? number : T[K] extends {
+        type: 'boolean';
+    } ? boolean : never;
+};
+interface ConfigSource {
+    name: string;
+    load(): Record<string, string | undefined>;
+}
+
+declare function loadConfig<T extends ConfigSchema>(schema: T, sources: ConfigSource[]): {
+    [K in keyof T]: T[K] extends {
+        type: 'number';
+    } | 'number' ? number : T[K] extends {
+        type: 'boolean';
+    } | 'boolean' ? boolean : string;
+};
+
+declare function envSource(prefix?: string): ConfigSource;
+declare function objectSource(obj: Record<string, unknown>): ConfigSource;
+
+export { type ConfigFieldDef, type ConfigSchema, type ConfigSource, type ConfigValueType, type InferConfig, envSource, loadConfig, objectSource };

package/dist/index.js

@@ -0,0 +1,106 @@
+// src/loader.ts
+function normalizeField(field) {
+  if (typeof field === "string") {
+    return { type: field };
+  }
+  return field;
+}
+function coerce(value, type) {
+  switch (type) {
+    case "number": {
+      const n = Number(value);
+      if (isNaN(n)) throw new Error(`Cannot convert "${value}" to number`);
+      return n;
+    }
+    case "boolean":
+      return value === "true" || value === "1" || value === "yes";
+    case "string":
+    default:
+      return value;
+  }
+}
+function loadConfig(schema, sources) {
+  var _a, _b, _c;
+  const merged = {};
+  for (const source of sources) {
+    const data = source.load();
+    for (const [key, value] of Object.entries(data)) {
+      if (value !== void 0) {
+        merged[key] = value;
+      }
+    }
+  }
+  const result = {};
+  const errors = [];
+  for (const [key, rawField] of Object.entries(schema)) {
+    const field = normalizeField(rawField);
+    const envKey = (_b = (_a = field.env) == null ? void 0 : _a.toLowerCase()) != null ? _b : key.toLowerCase();
+    const raw = (_c = merged[envKey]) != null ? _c : merged[key.toLowerCase()];
+    if (raw !== void 0) {
+      try {
+        result[key] = coerce(raw, field.type);
+      } catch (e) {
+        errors.push(`${key}: ${e instanceof Error ? e.message : String(e)}`);
+      }
+    } else if (field.default !== void 0) {
+      result[key] = field.default;
+    } else if (field.required !== false) {
+      errors.push(`${key}: required but not provided`);
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`Config validation failed:
+  ${errors.join("\n  ")}`);
+  }
+  return result;
+}
+
+// src/sources.ts
+function envSource(prefix) {
+  return {
+    name: "env",
+    load() {
+      const env = {};
+      try {
+        if (typeof globalThis !== "undefined" && "process" in globalThis) {
+          const proc = globalThis.process;
+          if (proc.env) {
+            if (prefix) {
+              const upper = prefix.toUpperCase();
+              for (const [key, value] of Object.entries(proc.env)) {
+                if (key.startsWith(upper)) {
+                  const stripped = key.slice(upper.length).replace(/^_/, "");
+                  env[stripped.toLowerCase()] = value;
+                }
+              }
+            } else {
+              for (const [key, value] of Object.entries(proc.env)) {
+                env[key.toLowerCase()] = value;
+              }
+            }
+          }
+        }
+      } catch (e) {
+      }
+      return env;
+    }
+  };
+}
+function objectSource(obj) {
+  return {
+    name: "object",
+    load() {
+      const result = {};
+      for (const [key, value] of Object.entries(obj)) {
+        if (value !== void 0 && value !== null) {
+          result[key.toLowerCase()] = String(value);
+        }
+      }
+      return result;
+    }
+  };
+}
+
+export { envSource, loadConfig, objectSource };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/sources.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ConfigSchema, ConfigFieldDef, ConfigSource, ConfigValueType } from './types.js';\n\nfunction normalizeField(field: ConfigFieldDef | ConfigValueType): ConfigFieldDef {\n  if (typeof field === 'string') {\n    return { type: field };\n  }\n  return field;\n}\n\nfunction coerce(value: string, type: ConfigValueType): string | number | boolean {\n  switch (type) {\n    case 'number': {\n      const n = Number(value);\n      if (isNaN(n)) throw new Error(`Cannot convert \"${value}\" to number`);\n      return n;\n    }\n    case 'boolean':\n      return value === 'true' || value === '1' || value === 'yes';\n    case 'string':\n    default:\n      return value;\n  }\n}\n\nexport function loadConfig<T extends ConfigSchema>(\n  schema: T,\n  sources: ConfigSource[],\n): { [K in keyof T]: T[K] extends { type: 'number' } | 'number' ? number : T[K] extends { type: 'boolean' } | 'boolean' ? boolean : string } {\n  const merged: Record<string, string | undefined> = {};\n\n  for (const source of sources) {\n    const data = source.load();\n    for (const [key, value] of Object.entries(data)) {\n      if (value !== undefined) {\n        merged[key] = value;\n      }\n    }\n  }\n\n  const result: Record<string, unknown> = {};\n  const errors: string[] = [];\n\n  for (const [key, rawField] of Object.entries(schema)) {\n    const field = normalizeField(rawField);\n    const envKey = field.env?.toLowerCase() ?? key.toLowerCase();\n    const raw = merged[envKey] ?? merged[key.toLowerCase()];\n\n    if (raw !== undefined) {\n      try {\n        result[key] = coerce(raw, field.type);\n      } catch (e) {\n        errors.push(`${key}: ${e instanceof Error ? e.message : String(e)}`);\n      }\n    } else if (field.default !== undefined) {\n      result[key] = field.default;\n    } else if (field.required !== false) {\n      errors.push(`${key}: required but not provided`);\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new Error(`Config validation failed:\\n  ${errors.join('\\n  ')}`);\n  }\n\n  return result as ReturnType<typeof loadConfig<T>>;\n}\n","import type { ConfigSource } from './types.js';\n\nexport function envSource(prefix?: string): ConfigSource {\n  return {\n    name: 'env',\n    load() {\n      const env: Record<string, string | undefined> = {};\n      try {\n        if (typeof globalThis !== 'undefined' && 'process' in globalThis) {\n          const proc = (globalThis as Record<string, unknown>).process as { env?: Record<string, string | undefined> };\n          if (proc.env) {\n            if (prefix) {\n              const upper = prefix.toUpperCase();\n              for (const [key, value] of Object.entries(proc.env)) {\n                if (key.startsWith(upper)) {\n                  const stripped = key.slice(upper.length).replace(/^_/, '');\n                  env[stripped.toLowerCase()] = value;\n                }\n              }\n            } else {\n              for (const [key, value] of Object.entries(proc.env)) {\n                env[key.toLowerCase()] = value;\n              }\n            }\n          }\n        }\n      } catch { /* non-node environment */ }\n      return env;\n    },\n  };\n}\n\nexport function objectSource(obj: Record<string, unknown>): ConfigSource {\n  return {\n    name: 'object',\n    load() {\n      const result: Record<string, string | undefined> = {};\n      for (const [key, value] of Object.entries(obj)) {\n        if (value !== undefined && value !== null) {\n          result[key.toLowerCase()] = String(value);\n        }\n      }\n      return result;\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@philiprehberger/config-layer",
+  "version": "0.1.5",
+  "description": "Layered configuration loader with typed output and multiple sources",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "node --test"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "config",
+    "configuration",
+    "environment",
+    "typed",
+    "layered"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/philiprehberger/ts-config-layer.git"
+  },
+  "homepage": "https://github.com/philiprehberger/ts-config-layer#readme",
+  "bugs": {
+    "url": "https://github.com/philiprehberger/ts-config-layer/issues"
+  },
+  "author": "Philip Rehberger",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false
+}