@seifer-webapp-factory/kits 0.1.0

package/dist/backend/config/adapters/secret-resolvers.js

@@ -0,0 +1,60 @@
+/**
+ * US-0102 — Kant-en-klare {@link SecretResolver}-adapters. Consumers kunnen ook een eigen backend
+ * aankoppelen zonder de module te wijzigen (portabiliteit).
+ */
+import { readFile } from 'node:fs/promises';
+/**
+ * Lost `file://`-referenties op vanaf het bestandssysteem, bv.
+ * `file:///run/secrets/db_password` -> inhoud van `/run/secrets/db_password` (getrimd).
+ */
+export function fileSecretResolver(options = {}) {
+    const trim = options.trim ?? true;
+    return {
+        canResolve: (ref) => ref.scheme === 'file',
+        resolve: async (ref) => {
+            const path = ref.raw.replace(/^file:\/\//i, '');
+            const content = await readFile(path, 'utf8');
+            return trim ? content.trim() : content;
+        },
+    };
+}
+/**
+ * In-memory resolver voor een gegeven schema (bv. `vault`), gevoed uit een map. Handig als stub voor
+ * een vault-backend, voor tests, of als eenvoudige custom backend.
+ */
+export function mapSecretResolver(scheme, entries) {
+    return {
+        canResolve: (ref) => ref.scheme === scheme,
+        resolve: (ref) => {
+            if (!Object.prototype.hasOwnProperty.call(entries, ref.location)) {
+                // Bewust generiek: geen (deels) secretwaarde in de fout.
+                throw new Error('sleutel niet gevonden');
+            }
+            return entries[ref.location];
+        },
+    };
+}
+/**
+ * Adapter rondom een custom async backend-functie. Het schema bepaalt welke referenties deze
+ * resolver aankan.
+ */
+export function functionSecretResolver(scheme, fn) {
+    return {
+        canResolve: (ref) => ref.scheme === scheme,
+        resolve: (ref) => fn(ref),
+    };
+}
+/** Combineert meerdere resolvers; de eerste die de referentie aankan wint. */
+export function compositeSecretResolver(...resolvers) {
+    return {
+        canResolve: (ref) => resolvers.some((r) => r.canResolve(ref)),
+        resolve: (ref) => {
+            const resolver = resolvers.find((r) => r.canResolve(ref));
+            if (!resolver) {
+                throw new Error('sleutel niet gevonden');
+            }
+            return resolver.resolve(ref);
+        },
+    };
+}
+//# sourceMappingURL=secret-resolvers.js.map

package/dist/backend/config/adapters/secret-resolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-resolvers.js","sourceRoot":"","sources":["../../../../backend/src/config/adapters/secret-resolvers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA8B,EAAE;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,OAAO;QACL,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,OAA+B;IAC/E,OAAO;QACL,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAC1C,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjE,yDAAyD;gBACzD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAW,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,EAAgD;IAEhD,OAAO;QACL,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAC1C,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CAAC,GAAG,SAA2B;IACpE,OAAO;QACL,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/config/adapters/zod-schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * US-0103 — Zod-adapter voor de {@link ConfigSchema}-poort.
+ *
+ * Wrapt een Zod-schema tot een config-kit-schema. Het output-type wordt met `z.infer` uit het
+ * schema afgeleid (geen `any`), validatie verzamelt ALLE overtredingen, en de Zod-`z.coerce`-helpers
+ * kunnen gebruikt worden voor scalaire coercie (string -> number/boolean) tijdens validatie.
+ *
+ * Zod is een peer-dependency; de core zelf hangt er niet van af.
+ */
+import { z, type ZodType } from 'zod';
+import type { ConfigSchema } from '../core/ports.js';
+import { Secret } from '../core/secret.js';
+/** Maakt een {@link ConfigSchema} van een Zod-schema. */
+export declare function zodSchema<S extends ZodType>(schema: S): ConfigSchema<z.infer<S>>;
+/**
+ * Zod-type voor een secretveld: verwacht een reeds-opgeloste {@link Secret} (de secret-resolutie
+ * loopt vóór validatie). Het output-type is `Secret`, zodat consumers bewust `.reveal()` aanroepen.
+ */
+export declare function zodSecret(): z.ZodType<Secret>;
+//# sourceMappingURL=zod-schema.d.ts.map

package/dist/backend/config/adapters/zod-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.d.ts","sourceRoot":"","sources":["../../../../backend/src/config/adapters/zod-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAUhF;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAE7C"}

package/dist/backend/config/adapters/zod-schema.js

@@ -0,0 +1,35 @@
+/**
+ * US-0103 — Zod-adapter voor de {@link ConfigSchema}-poort.
+ *
+ * Wrapt een Zod-schema tot een config-kit-schema. Het output-type wordt met `z.infer` uit het
+ * schema afgeleid (geen `any`), validatie verzamelt ALLE overtredingen, en de Zod-`z.coerce`-helpers
+ * kunnen gebruikt worden voor scalaire coercie (string -> number/boolean) tijdens validatie.
+ *
+ * Zod is een peer-dependency; de core zelf hangt er niet van af.
+ */
+import { z } from 'zod';
+import { Secret } from '../core/secret.js';
+/** Maakt een {@link ConfigSchema} van een Zod-schema. */
+export function zodSchema(schema) {
+    return {
+        validate(raw) {
+            const result = schema.safeParse(raw);
+            if (result.success) {
+                return { success: true, value: result.data };
+            }
+            return { success: false, issues: result.error.issues.map(toIssue) };
+        },
+    };
+}
+/**
+ * Zod-type voor een secretveld: verwacht een reeds-opgeloste {@link Secret} (de secret-resolutie
+ * loopt vóór validatie). Het output-type is `Secret`, zodat consumers bewust `.reveal()` aanroepen.
+ */
+export function zodSecret() {
+    return z.instanceof(Secret);
+}
+function toIssue(issue) {
+    const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+    return { path, message: issue.message };
+}
+//# sourceMappingURL=zod-schema.js.map

package/dist/backend/config/adapters/zod-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.js","sourceRoot":"","sources":["../../../../backend/src/config/adapters/zod-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAgB,MAAM,KAAK,CAAC;AAGtC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAoB,MAAS;IACpD,OAAO;QACL,QAAQ,CAAC,GAAY;YACnB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/C,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,OAAO,CAAC,KAAiB;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/backend/config/core/env-loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * US-0101 — Env laden & parsen.
+ *
+ * Leest omgevingsvariabelen en optionele `.env`-bronnen in en zet ze om naar een genest, ruw
+ * configuratie-object volgens de key-conventie (`DB__HOST` -> `db.host`). Coercie naar primitieve
+ * types gebeurt schema-gedreven via {@link coerceByMap}. De module bevat geen domeinkennis: welke
+ * keys en types bestaan komt uit het geïnjecteerde schema/typemap.
+ */
+import { type ConfigIssue } from './errors.js';
+import type { RawConfig } from './ports.js';
+export type ScalarKind = 'string' | 'number' | 'boolean' | 'list';
+/** Map van dotted pad -> verwacht scalair type (afgeleid uit het geïnjecteerde schema). */
+export type TypeMap = Record<string, ScalarKind>;
+export interface ParseEnvOptions {
+    /** Scheidingsteken voor nesting. Default `__`. */
+    separator?: string;
+    /**
+     * Optionele prefix; alleen keys met deze prefix worden meegenomen en de prefix wordt gestript.
+     * Bv. prefix `APP_` -> `APP_DB__HOST` wordt `db.host`.
+     */
+    prefix?: string;
+    /** Segmenten lowercasen (default true), zodat `DB__HOST` -> `db.host`. */
+    lowercase?: boolean;
+}
+type EnvRecord = Record<string, string | undefined>;
+/** Zet een platte env-record om naar een genest ruw configuratie-object. */
+export declare function parseEnv(env: EnvRecord, options?: ParseEnvOptions): RawConfig;
+/** Parse `.env`-bestandsinhoud naar een platte record (KEY=VALUE, comments/lege regels genegeerd). */
+export declare function parseDotenv(content: string): Record<string, string>;
+/**
+ * Voegt meerdere ruwe bronnen samen met voorrangsvolgorde: latere bronnen winnen (US-0101 AC2).
+ * Diepe merge, override wint per key.
+ */
+export declare function mergeSources(...sources: RawConfig[]): RawConfig;
+/**
+ * Coerce ruwe (string) waarden naar hun schema-type op basis van een {@link TypeMap} (US-0101).
+ *
+ * @param mode `'throw'` gooit een {@link ConfigParseError} bij de eerste niet-coërceerbare waarde
+ *   (standalone gebruik). `'collect'` verzamelt alle issues en retourneert ze, zonder te gooien
+ *   (voor geaggregeerde rapportage in de pijplijn).
+ */
+export declare function coerceByMap(raw: RawConfig, map: TypeMap, mode?: 'throw' | 'collect'): {
+    value: RawConfig;
+    issues: ConfigIssue[];
+};
+export {};
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/backend/config/core/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../../../backend/src/config/core/env-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAElE,2FAA2F;AAC3F,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpD,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,SAAS,CAsBjF;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE,OAAO,GAAG,SAAmB,GAClC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAsB7C"}

package/dist/backend/config/core/env-loader.js

@@ -0,0 +1,155 @@
+/**
+ * US-0101 — Env laden & parsen.
+ *
+ * Leest omgevingsvariabelen en optionele `.env`-bronnen in en zet ze om naar een genest, ruw
+ * configuratie-object volgens de key-conventie (`DB__HOST` -> `db.host`). Coercie naar primitieve
+ * types gebeurt schema-gedreven via {@link coerceByMap}. De module bevat geen domeinkennis: welke
+ * keys en types bestaan komt uit het geïnjecteerde schema/typemap.
+ */
+import { ConfigParseError } from './errors.js';
+import { deepMerge, isPlainObject } from './merge.js';
+/** Zet een platte env-record om naar een genest ruw configuratie-object. */
+export function parseEnv(env, options = {}) {
+    const separator = options.separator ?? '__';
+    const lowercase = options.lowercase ?? true;
+    const prefix = options.prefix;
+    const result = {};
+    for (const [rawKey, value] of Object.entries(env)) {
+        if (value === undefined)
+            continue;
+        let key = rawKey;
+        if (prefix !== undefined) {
+            if (!key.startsWith(prefix))
+                continue;
+            key = key.slice(prefix.length);
+        }
+        const segments = key
+            .split(separator)
+            .map((s) => (lowercase ? s.toLowerCase() : s))
+            .filter((s) => s.length > 0);
+        if (segments.length === 0)
+            continue;
+        setPath(result, segments, value);
+    }
+    return result;
+}
+/** Parse `.env`-bestandsinhoud naar een platte record (KEY=VALUE, comments/lege regels genegeerd). */
+export function parseDotenv(content) {
+    const out = {};
+    for (const line of content.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0 || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        let value = trimmed.slice(eq + 1).trim();
+        // Strip omringende quotes.
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key.length > 0)
+            out[key] = value;
+    }
+    return out;
+}
+/**
+ * Voegt meerdere ruwe bronnen samen met voorrangsvolgorde: latere bronnen winnen (US-0101 AC2).
+ * Diepe merge, override wint per key.
+ */
+export function mergeSources(...sources) {
+    return sources.reduce((acc, src) => deepMerge(acc, src), {});
+}
+/**
+ * Coerce ruwe (string) waarden naar hun schema-type op basis van een {@link TypeMap} (US-0101).
+ *
+ * @param mode `'throw'` gooit een {@link ConfigParseError} bij de eerste niet-coërceerbare waarde
+ *   (standalone gebruik). `'collect'` verzamelt alle issues en retourneert ze, zonder te gooien
+ *   (voor geaggregeerde rapportage in de pijplijn).
+ */
+export function coerceByMap(raw, map, mode = 'throw') {
+    const issues = [];
+    const result = structuredCloneRaw(raw);
+    for (const [path, kind] of Object.entries(map)) {
+        const segments = path.split('.');
+        const current = getPath(result, segments);
+        if (current === undefined)
+            continue; // ontbrekende keys behandelt de validatie (defaults/required)
+        if (typeof current !== 'string')
+            continue; // al gecoerced of genest
+        const coerced = coerceScalar(current, kind);
+        if ('error' in coerced) {
+            issues.push({ path, message: coerced.error });
+            continue;
+        }
+        setPath(result, segments, coerced.value);
+    }
+    if (mode === 'throw' && issues.length > 0) {
+        throw new ConfigParseError(issues);
+    }
+    return { value: result, issues };
+}
+function coerceScalar(value, kind) {
+    switch (kind) {
+        case 'string':
+            return { value };
+        case 'number': {
+            const trimmed = value.trim();
+            if (trimmed.length === 0)
+                return { error: 'verwacht number, kreeg lege waarde' };
+            const n = Number(trimmed);
+            if (Number.isNaN(n))
+                return { error: 'verwacht number' };
+            return { value: n };
+        }
+        case 'boolean': {
+            const v = value.trim().toLowerCase();
+            if (['true', '1', 'yes', 'on'].includes(v))
+                return { value: true };
+            if (['false', '0', 'no', 'off'].includes(v))
+                return { value: false };
+            return { error: 'verwacht boolean' };
+        }
+        case 'list':
+            return {
+                value: value
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter((s) => s.length > 0),
+            };
+        default:
+            return { value };
+    }
+}
+// ---- interne helpers -------------------------------------------------------
+function setPath(target, segments, value) {
+    let node = target;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const seg = segments[i];
+        const next = node[seg];
+        if (typeof next !== 'object' || next === null || Array.isArray(next)) {
+            node[seg] = {};
+        }
+        node = node[seg];
+    }
+    node[segments[segments.length - 1]] = value;
+}
+function getPath(source, segments) {
+    let node = source;
+    for (const seg of segments) {
+        if (typeof node !== 'object' || node === null)
+            return undefined;
+        node = node[seg];
+    }
+    return node;
+}
+function structuredCloneRaw(raw) {
+    const out = {};
+    for (const [key, value] of Object.entries(raw)) {
+        out[key] = isPlainObject(value) ? structuredCloneRaw(value) : value;
+    }
+    return out;
+}
+//# sourceMappingURL=env-loader.js.map

package/dist/backend/config/core/env-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.js","sourceRoot":"","sources":["../../../../backend/src/config/core/env-loader.ts"],"names":[],"mappings":"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"}

package/dist/backend/config/core/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Foutentaxonomie voor config-kit. Alle fouten zijn geredigeerd: ze bevatten paden en redenen,
+ * maar nooit (deels) opgeloste secretwaarden.
+ */
+export interface ConfigIssue {
+    /** Dotted pad naar de betreffende config-key, bv. `db.port`. `(root)` voor top-level. */
+    path: string;
+    /** Mensvriendelijke reden zonder secretwaarden. */
+    message: string;
+}
+/** Basisklasse voor alle config-kit-fouten. */
+export declare class ConfigKitError extends Error {
+    constructor(message: string);
+}
+/** Coercie/parse-fout tijdens het inlezen van env (US-0101). */
+export declare class ConfigParseError extends ConfigKitError {
+    readonly issues: ConfigIssue[];
+    constructor(issues: ConfigIssue[]);
+}
+/** Fout bij het oplossen van een secret-referentie (US-0102). Bevat nooit de secretwaarde. */
+export declare class SecretResolutionError extends ConfigKitError {
+    readonly path: string;
+    /** Referentie-locatie (schema + locatie), bv. `vault://kv/data/app#missing`. */
+    readonly reference: string;
+    constructor(path: string, reference: string, reason?: string);
+}
+/** Geaggregeerde validatiefout na schemavalidatie (US-0103/US-0104/US-0105). */
+export declare class ConfigValidationError extends ConfigKitError {
+    readonly issues: ConfigIssue[];
+    /** Actieve omgeving waarin validatie faalde, indien van toepassing (US-0105). */
+    readonly environment: string | undefined;
+    constructor(issues: ConfigIssue[], environment?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/backend/config/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../backend/src/config/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAM5B;AAED,gEAAgE;AAChE,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;gBAEnB,MAAM,EAAE,WAAW,EAAE;CAIlC;AAED,8FAA8F;AAC9F,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQ7D;AAED,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE7B,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;CAMxD"}

package/dist/backend/config/core/errors.js

@@ -0,0 +1,49 @@
+/**
+ * Foutentaxonomie voor config-kit. Alle fouten zijn geredigeerd: ze bevatten paden en redenen,
+ * maar nooit (deels) opgeloste secretwaarden.
+ */
+/** Basisklasse voor alle config-kit-fouten. */
+export class ConfigKitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+        // Behoud de prototype-keten bij transpileren naar oudere targets.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Coercie/parse-fout tijdens het inlezen van env (US-0101). */
+export class ConfigParseError extends ConfigKitError {
+    issues;
+    constructor(issues) {
+        super(`Configuratie kon niet geparsed worden:\n${formatIssues(issues)}`);
+        this.issues = issues;
+    }
+}
+/** Fout bij het oplossen van een secret-referentie (US-0102). Bevat nooit de secretwaarde. */
+export class SecretResolutionError extends ConfigKitError {
+    path;
+    /** Referentie-locatie (schema + locatie), bv. `vault://kv/data/app#missing`. */
+    reference;
+    constructor(path, reference, reason) {
+        super(`Secret-referentie voor "${path}" kon niet worden opgelost (${reference})` +
+            (reason ? `: ${reason}` : ''));
+        this.path = path;
+        this.reference = reference;
+    }
+}
+/** Geaggregeerde validatiefout na schemavalidatie (US-0103/US-0104/US-0105). */
+export class ConfigValidationError extends ConfigKitError {
+    issues;
+    /** Actieve omgeving waarin validatie faalde, indien van toepassing (US-0105). */
+    environment;
+    constructor(issues, environment) {
+        const scope = environment ? ` (omgeving: ${environment})` : '';
+        super(`Configuratie is ongeldig${scope}:\n${formatIssues(issues)}`);
+        this.issues = issues;
+        this.environment = environment;
+    }
+}
+function formatIssues(issues) {
+    return issues.map((i) => `  - ${i.path}: ${i.message}`).join('\n');
+}
+//# sourceMappingURL=errors.js.map

package/dist/backend/config/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../backend/src/config/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,+CAA+C;AAC/C,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,kEAAkE;QAClE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACzC,MAAM,CAAgB;IAE/B,YAAY,MAAqB;QAC/B,KAAK,CAAC,2CAA2C,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,8FAA8F;AAC9F,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IAC9C,IAAI,CAAS;IACtB,gFAAgF;IACvE,SAAS,CAAS;IAE3B,YAAY,IAAY,EAAE,SAAiB,EAAE,MAAe;QAC1D,KAAK,CACH,2BAA2B,IAAI,+BAA+B,SAAS,GAAG;YACxE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IAC9C,MAAM,CAAgB;IAC/B,iFAAiF;IACxE,WAAW,CAAqB;IAEzC,YAAY,MAAqB,EAAE,WAAoB;QACrD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,eAAe,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,2BAA2B,KAAK,MAAM,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,SAAS,YAAY,CAAC,MAAqB;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC"}

package/dist/backend/config/core/freeze.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Diep bevriezen (immutable maken) van een config-object. Secrets worden als geheel bevroren maar
+ * niet doorlopen (hun waarde zit buiten de instance). Arrays en geneste objecten worden recursief
+ * bevroren.
+ */
+export declare function deepFreeze<T>(value: T): T;
+//# sourceMappingURL=freeze.d.ts.map

package/dist/backend/config/core/freeze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.d.ts","sourceRoot":"","sources":["../../../../backend/src/config/core/freeze.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAUzC"}

package/dist/backend/config/core/freeze.js

@@ -0,0 +1,20 @@
+import { isSecret } from './secret.js';
+/**
+ * Diep bevriezen (immutable maken) van een config-object. Secrets worden als geheel bevroren maar
+ * niet doorlopen (hun waarde zit buiten de instance). Arrays en geneste objecten worden recursief
+ * bevroren.
+ */
+export function deepFreeze(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (isSecret(value))
+        return Object.freeze(value);
+    if (Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    for (const key of Object.keys(value)) {
+        deepFreeze(value[key]);
+    }
+    return value;
+}
+//# sourceMappingURL=freeze.js.map

package/dist/backend/config/core/freeze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.js","sourceRoot":"","sources":["../../../../backend/src/config/core/freeze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,EAAE,CAAC;QAChE,UAAU,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/backend/config/core/load-config.d.ts

@@ -0,0 +1,43 @@
+import { type ParseEnvOptions } from './env-loader.js';
+import type { ConfigSchema, RawConfig, Reporter, SecretResolver } from './ports.js';
+type EnvRecord = Record<string, string | undefined>;
+export interface LoadConfigOptions<T> {
+    /** Geïnjecteerd config-schema (US-0103). */
+    schema: ConfigSchema<T>;
+    /** Basisconfiguratie die voor alle omgevingen geldt. */
+    base?: RawConfig;
+    /** Per-omgeving overridelagen, gekozen op basis van de actieve omgeving. */
+    overrides?: Record<string, RawConfig>;
+    /** Env-key waaruit de actieve omgeving gelezen wordt (bv. `APP_ENV`). */
+    environmentKey?: string;
+    /** Expliciete actieve omgeving; wint van `environmentKey`. */
+    activeEnvironment?: string;
+    /** Env-record; indien gezet wordt deze geparsed en met hoogste voorrang samengevoegd. */
+    env?: EnvRecord;
+    /** Opties voor env-parsing (separator, prefix, lowercase). */
+    envOptions?: ParseEnvOptions;
+    /** `.env`-bestandsinhoud; lagere voorrang dan `env`. */
+    dotenv?: string;
+    /** Aanvullende reeds-geparste lagen, tussen override en `.env` in. */
+    sources?: RawConfig[];
+    /** Secret-resolver-poort; indien gezet worden referenties opgelost en geredigeerd. */
+    resolver?: SecretResolver;
+    /** Extra dotted paden die als secret behandeld moeten worden. */
+    extraSecretPaths?: string[];
+    /** Reporter-poort voor het geredigeerde foutrapport. */
+    reporter?: Reporter;
+    /** Gedrag bij falen: `throw` (default) of `exit` (niet-nul exitcode). */
+    onFailure?: 'throw' | 'exit';
+    /** Injecteerbare exit-functie (default `process.exit`), zodat fail-fast testbaar is. */
+    exit?: (code: number) => never;
+    /** Titel van het foutrapport. */
+    reportTitle?: string;
+}
+/**
+ * Laadt, valideert en bevriest de configuratie. Retourneert een volledig getypt, onveranderlijk
+ * object. Gooit {@link ConfigValidationError} (of stopt het proces bij `onFailure: 'exit'`) wanneer
+ * de effectieve config niet aan het schema voldoet.
+ */
+export declare function loadConfig<T>(options: LoadConfigOptions<T>): Promise<T>;
+export {};
+//# sourceMappingURL=load-config.d.ts.map

package/dist/backend/config/core/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../../../backend/src/config/core/load-config.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5F,OAAO,KAAK,EAEV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,4CAA4C;IAC5C,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAGxB,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,yFAAyF;IACzF,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IAGtB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG5B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,wFAAwF;IACxF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA0B7E"}

package/dist/backend/config/core/load-config.js

@@ -0,0 +1,74 @@
+/**
+ * Orkestreert de volledige config-pijplijn en bindt US-0101 t/m US-0105 samen:
+ *
+ *  1. Lagen samenstellen: basis + per-omgeving override (US-0105) + extra bronnen + `.env` + env
+ *     (US-0101, met voorrang env > .env > sources > override > basis).
+ *  2. Secret-referenties oplossen en redigeren (US-0102).
+ *  3. Valideren tegen het geïnjecteerde schema -> getypt, bevroren object (US-0103).
+ *  4. Bij falen: geredigeerd, geaggregeerd foutrapport via de reporter-poort + fail-fast (US-0104).
+ *
+ * De coercie van scalairen gebeurt in het schema (bv. Zod `z.coerce`), zodat alle type- en
+ * validatiefouten in één rapport verzameld worden.
+ */
+import { ConfigValidationError } from './errors.js';
+import { mergeSources, parseDotenv, parseEnv } from './env-loader.js';
+import { deepFreeze } from './freeze.js';
+import { resolveSecrets } from './secret-resolver.js';
+const defaultExit = (code) => process.exit(code);
+/**
+ * Laadt, valideert en bevriest de configuratie. Retourneert een volledig getypt, onveranderlijk
+ * object. Gooit {@link ConfigValidationError} (of stopt het proces bij `onFailure: 'exit'`) wanneer
+ * de effectieve config niet aan het schema voldoet.
+ */
+export async function loadConfig(options) {
+    const activeEnvironment = resolveActiveEnvironment(options);
+    let raw = composeLayers(options, activeEnvironment);
+    if (options.resolver) {
+        raw = await resolveSecrets(raw, options.resolver, {
+            extraSecretPaths: options.extraSecretPaths ?? [],
+        });
+    }
+    const result = options.schema.validate(raw);
+    if (!result.success) {
+        const report = {
+            title: options.reportTitle ?? 'Ongeldige configuratie',
+            issues: result.issues,
+            environment: activeEnvironment,
+        };
+        options.reporter?.report(report);
+        if ((options.onFailure ?? 'throw') === 'exit') {
+            (options.exit ?? defaultExit)(1);
+        }
+        throw new ConfigValidationError(result.issues, activeEnvironment);
+    }
+    return deepFreeze(result.value);
+}
+function resolveActiveEnvironment(options) {
+    if (options.activeEnvironment !== undefined)
+        return options.activeEnvironment;
+    if (options.environmentKey !== undefined) {
+        const source = options.env ?? process.env;
+        return source[options.environmentKey];
+    }
+    return undefined;
+}
+function composeLayers(options, activeEnvironment) {
+    const layers = [];
+    if (options.base)
+        layers.push(options.base);
+    if (options.overrides && activeEnvironment !== undefined) {
+        const layer = options.overrides[activeEnvironment];
+        if (layer !== undefined)
+            layers.push(layer);
+    }
+    if (options.sources)
+        layers.push(...options.sources);
+    if (options.dotenv !== undefined) {
+        layers.push(parseEnv(parseDotenv(options.dotenv), options.envOptions));
+    }
+    if (options.env !== undefined) {
+        layers.push(parseEnv(options.env, options.envOptions));
+    }
+    return mergeSources(...layers);
+}
+//# sourceMappingURL=load-config.js.map

package/dist/backend/config/core/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../../../backend/src/config/core/load-config.ts"],"names":[],"mappings":"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"}

package/dist/backend/config/core/merge.d.ts

@@ -0,0 +1,19 @@
+/**
+ * US-0105 — Per-omgeving overrides.
+ *
+ * Een basisconfiguratie geldt voor alle omgevingen; een per-omgeving laag (geselecteerd via een
+ * omgeving-indicator) overschrijft specifieke keys via een deterministische diepe merge (override
+ * wint). De set omgevingen komt uit de geïnjecteerde configuratie; de module kent geen vaste
+ * omgevingsnamen.
+ */
+import type { RawConfig } from './ports.js';
+/** Diepe merge van twee ruwe objecten; `override` wint. Arrays en scalars worden vervangen. */
+export declare function deepMerge(base: RawConfig, override: RawConfig): RawConfig;
+/**
+ * Bepaalt de effectieve config door de basis samen te voegen met de laag van de actieve omgeving.
+ * Onbekende/ontbrekende omgeving (`activeEnvironment` undefined of niet in `overrides`) valt terug
+ * op uitsluitend de basisconfig (US-0105 AC2).
+ */
+export declare function resolveEnvironmentLayers(base: RawConfig, overrides: Record<string, RawConfig>, activeEnvironment: string | undefined): RawConfig;
+export declare function isPlainObject(value: unknown): value is RawConfig;
+//# sourceMappingURL=merge.d.ts.map

package/dist/backend/config/core/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../../backend/src/config/core/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,SAAS,CAWzE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,SAAS,CAKX;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAEhE"}