webapp-factory 0.1.0

package/dist/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/config/core/load-config.js.map

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

package/dist/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/config/core/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../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"}

package/dist/config/core/merge.js

@@ -0,0 +1,31 @@
+/** Diepe merge van twee ruwe objecten; `override` wint. Arrays en scalars worden vervangen. */
+export function deepMerge(base, override) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        const existing = out[key];
+        if (isPlainObject(existing) && isPlainObject(value)) {
+            out[key] = deepMerge(existing, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/**
+ * 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 function resolveEnvironmentLayers(base, overrides, activeEnvironment) {
+    if (activeEnvironment === undefined)
+        return { ...base };
+    const layer = overrides[activeEnvironment];
+    if (layer === undefined)
+        return { ...base };
+    return deepMerge(base, layer);
+}
+export function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=merge.js.map

package/dist/config/core/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/config/core/merge.ts"],"names":[],"mappings":"AAUA,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,QAAmB;IAC5D,MAAM,GAAG,GAAc,EAAE,GAAG,IAAI,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAe,EACf,SAAoC,EACpC,iBAAqC;IAErC,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5C,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/config/core/ports.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Ports (interfaces) waarop de config-kit-core leunt. Het consumerende project levert de adapters.
+ * Deze poorten vormen het portabiliteits-contract: de core kent geen concrete implementaties.
+ */
+import type { ConfigIssue } from './errors.js';
+/** Ruw, genest configuratie-object zoals opgeleverd door de env-loader. */
+export type RawConfig = {
+    [key: string]: unknown;
+};
+/** Resultaat van een schemavalidatie. */
+export type ValidationResult<T> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    issues: ConfigIssue[];
+};
+/**
+ * Config-schema-poort (US-0103). Het consumerende project injecteert een schema; de core roept
+ * uitsluitend `validate` aan en leidt het output-type `T` hieruit af. Zie de Zod-adapter voor een
+ * kant-en-klare implementatie.
+ */
+export interface ConfigSchema<T> {
+    validate(raw: unknown): ValidationResult<T>;
+}
+/** Ontlede secret-referentie, bv. `file:///run/secrets/db` of `vault://kv/data/app#password`. */
+export interface SecretRef {
+    /** Het schema-deel, bv. `file`, `vault`, `env`. */
+    scheme: string;
+    /** Alles na `://`, bv. `/run/secrets/db` of `kv/data/app#password`. */
+    location: string;
+    /** De volledige oorspronkelijke referentie. */
+    raw: string;
+}
+/**
+ * Secret-resolver-poort (US-0102). Lost referenties op tot hun werkelijke waarde. De concrete
+ * backend (file, vault, of een adapter van de consumer) is injecteerbaar.
+ */
+export interface SecretResolver {
+    /** Kan deze resolver de gegeven referentie oplossen? */
+    canResolve(ref: SecretRef): boolean;
+    /** Los de referentie op tot een klaartekstwaarde. Mag sync of async zijn. */
+    resolve(ref: SecretRef): Promise<string> | string;
+}
+/** Geredigeerd foutrapport dat via de reporter-poort wordt uitgeschreven (US-0104). */
+export interface ConfigReport {
+    title: string;
+    issues: ConfigIssue[];
+    environment?: string | undefined;
+}
+/**
+ * Reporter/logger-poort (US-0104). Het consumerende project bepaalt de vorm (stdout, structured
+ * log). De core dwingt geen specifieke logger af.
+ */
+export interface Reporter {
+    report(report: ConfigReport): void;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/config/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/config/core/ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEnD,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC7C;AAED,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC;IACpC,6EAA6E;IAC7E,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACnD;AAED,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC"}

package/dist/config/core/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/config/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/config/core/ports.ts"],"names":[],"mappings":""}

package/dist/config/core/secret-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { RawConfig, SecretRef, SecretResolver } from './ports.js';
+/** Ontleedt een string in een {@link SecretRef}, of `null` als het geen referentie is. */
+export declare function parseSecretRef(value: string): SecretRef | null;
+export interface ResolveSecretsOptions {
+    /**
+     * Extra dotted paden die als secret behandeld moeten worden, ook als de waarde een letterlijke
+     * (niet-referentie) string is. Handig voor literals die geredigeerd moeten worden.
+     */
+    extraSecretPaths?: string[];
+}
+/**
+ * Loopt door het ruwe object, lost referenties op via de resolver en wrapt secretwaarden in
+ * {@link Secret}. Retourneert een nieuw object; de invoer blijft ongewijzigd.
+ */
+export declare function resolveSecrets(raw: RawConfig, resolver: SecretResolver, options?: ResolveSecretsOptions): Promise<RawConfig>;
+//# sourceMappingURL=secret-resolver.d.ts.map

package/dist/config/core/secret-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-resolver.d.ts","sourceRoot":"","sources":["../../../src/config/core/secret-resolver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKvE,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM9D;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,SAAS,CAAC,CAGpB"}

package/dist/config/core/secret-resolver.js

@@ -0,0 +1,73 @@
+/**
+ * US-0102 — Secret-resolutie (file/vault-refs, redactie).
+ *
+ * Herkent secret-referenties (bv. `file:///run/secrets/db` of `vault://kv/data/app#password`) in
+ * het ruwe config-object en lost ze op via de geïnjecteerde {@link SecretResolver}-poort. Opgeloste
+ * waarden worden als {@link Secret} gemarkeerd zodat ze consequent geredigeerd worden. Faalt veilig:
+ * een resolutiefout benoemt de key en referentie, maar nooit een (deels) opgeloste waarde.
+ */
+import { SecretResolutionError } from './errors.js';
+import { isPlainObject } from './merge.js';
+import { Secret } from './secret.js';
+const REF_PATTERN = /^([a-z][a-z0-9+.-]*):\/\/(.*)$/i;
+/** Ontleedt een string in een {@link SecretRef}, of `null` als het geen referentie is. */
+export function parseSecretRef(value) {
+    const match = REF_PATTERN.exec(value);
+    if (!match)
+        return null;
+    const scheme = match[1].toLowerCase();
+    const location = match[2];
+    return { scheme, location, raw: value };
+}
+/**
+ * Loopt door het ruwe object, lost referenties op via de resolver en wrapt secretwaarden in
+ * {@link Secret}. Retourneert een nieuw object; de invoer blijft ongewijzigd.
+ */
+export async function resolveSecrets(raw, resolver, options = {}) {
+    const secretPaths = new Set(options.extraSecretPaths ?? []);
+    return (await walk(raw, [], resolver, secretPaths));
+}
+async function walk(node, path, resolver, secretPaths) {
+    const dotted = path.join('.');
+    if (typeof node === 'string') {
+        const ref = parseSecretRef(node);
+        if (ref) {
+            const value = await resolveRef(ref, dotted, resolver);
+            return new Secret(value);
+        }
+        if (secretPaths.has(dotted)) {
+            return new Secret(node);
+        }
+        return node;
+    }
+    if (Array.isArray(node)) {
+        return Promise.all(node.map((item, i) => walk(item, [...path, String(i)], resolver, secretPaths)));
+    }
+    if (isPlainObject(node)) {
+        const out = {};
+        for (const [key, value] of Object.entries(node)) {
+            out[key] = await walk(value, [...path, key], resolver, secretPaths);
+        }
+        return out;
+    }
+    return node;
+}
+async function resolveRef(ref, path, resolver) {
+    if (!resolver.canResolve(ref)) {
+        throw new SecretResolutionError(path, ref.raw, `geen resolver voor schema "${ref.scheme}"`);
+    }
+    try {
+        return await resolver.resolve(ref);
+    }
+    catch (cause) {
+        // Belangrijk: nooit de (deels) opgeloste waarde of de oorspronkelijke fout-payload lekken.
+        const reason = cause instanceof Error ? cause.message : 'onbekende fout';
+        throw new SecretResolutionError(path, ref.raw, sanitizeReason(reason, ref));
+    }
+}
+/** Verwijdert de referentie-locatie uit de reden zodat er zeker geen secret-hint in lekt. */
+function sanitizeReason(reason, ref) {
+    // Houd de reden kort en generiek; de referentie zelf staat al veilig in de error.
+    return reason.replaceAll(ref.location, '<locatie>');
+}
+//# sourceMappingURL=secret-resolver.js.map

package/dist/config/core/secret-resolver.js.map

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

package/dist/config/core/secret.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Secret — een waarde die nooit in klaartekst mag lekken via serialisatie, logging of inspectie.
+ *
+ * De werkelijke waarde wordt buiten de instance bewaard (module-scoped WeakMap), zodat het object
+ * zelf geen enumerable/inspecteerbare property met de secret bevat. `JSON.stringify`, `String()`,
+ * `console.log`/`util.inspect` en spreads leveren daardoor consequent de redactiemarker op.
+ */
+declare const REDACTED = "***";
+export declare class Secret {
+    constructor(value: string);
+    /** Haal de werkelijke secretwaarde op. Alleen bewust aanroepen op het punt van gebruik. */
+    reveal(): string;
+    /** Redactie bij `JSON.stringify`. */
+    toJSON(): string;
+    /** Redactie bij string-coercion / template-literals. */
+    toString(): string;
+}
+/** Type-guard voor een {@link Secret}. */
+export declare function isSecret(value: unknown): value is Secret;
+export { REDACTED };
+//# sourceMappingURL=secret.d.ts.map

package/dist/config/core/secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../../src/config/core/secret.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,QAAA,MAAM,QAAQ,QAAQ,CAAC;AAIvB,qBAAa,MAAM;gBACL,KAAK,EAAE,MAAM;IAIzB,2FAA2F;IAC3F,MAAM,IAAI,MAAM;IAQhB,qCAAqC;IACrC,MAAM,IAAI,MAAM;IAIhB,wDAAwD;IACxD,QAAQ,IAAI,MAAM;CAQnB;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/config/core/secret.js

@@ -0,0 +1,40 @@
+/**
+ * Secret — een waarde die nooit in klaartekst mag lekken via serialisatie, logging of inspectie.
+ *
+ * De werkelijke waarde wordt buiten de instance bewaard (module-scoped WeakMap), zodat het object
+ * zelf geen enumerable/inspecteerbare property met de secret bevat. `JSON.stringify`, `String()`,
+ * `console.log`/`util.inspect` en spreads leveren daardoor consequent de redactiemarker op.
+ */
+const REDACTED = '***';
+const store = new WeakMap();
+export class Secret {
+    constructor(value) {
+        store.set(this, value);
+    }
+    /** Haal de werkelijke secretwaarde op. Alleen bewust aanroepen op het punt van gebruik. */
+    reveal() {
+        const value = store.get(this);
+        if (value === undefined) {
+            throw new Error('Secret is niet beschikbaar (mogelijk niet correct geconstrueerd).');
+        }
+        return value;
+    }
+    /** Redactie bij `JSON.stringify`. */
+    toJSON() {
+        return REDACTED;
+    }
+    /** Redactie bij string-coercion / template-literals. */
+    toString() {
+        return REDACTED;
+    }
+    /** Redactie bij `util.inspect` / `console.log` (Node). */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return REDACTED;
+    }
+}
+/** Type-guard voor een {@link Secret}. */
+export function isSecret(value) {
+    return value instanceof Secret;
+}
+export { REDACTED };
+//# sourceMappingURL=secret.js.map

package/dist/config/core/secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.js","sourceRoot":"","sources":["../../../src/config/core/secret.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,KAAK,CAAC;AAEvB,MAAM,KAAK,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE5C,MAAM,OAAO,MAAM;IACjB,YAAY,KAAa;QACvB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,2FAA2F;IAC3F,MAAM;QACJ,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qCAAqC;IACrC,MAAM;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wDAAwD;IACxD,QAAQ;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0DAA0D;IAC1D,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,MAAM,CAAC;AACjC,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * webapp-factory/backend-foundation/config — domein-loze, getypte configuratie- en secret-loading met schemavalidatie,
+ * fail-fast start en per-omgeving overrides. Pure TypeScript-core + ports/adapters.
+ */
+export type { ConfigSchema, ConfigReport, RawConfig, Reporter, SecretRef, SecretResolver, ValidationResult, } from './core/ports.js';
+export { ConfigKitError, ConfigParseError, ConfigValidationError, SecretResolutionError, type ConfigIssue, } from './core/errors.js';
+export { Secret, isSecret, REDACTED } from './core/secret.js';
+export { parseEnv, parseDotenv, mergeSources, coerceByMap, type ParseEnvOptions, type ScalarKind, type TypeMap, } from './core/env-loader.js';
+export { resolveSecrets, parseSecretRef, type ResolveSecretsOptions, } from './core/secret-resolver.js';
+export { deepMerge, resolveEnvironmentLayers } from './core/merge.js';
+export { deepFreeze } from './core/freeze.js';
+export { loadConfig, type LoadConfigOptions } from './core/load-config.js';
+export { zodSchema, zodSecret } from './adapters/zod-schema.js';
+export { fileSecretResolver, mapSecretResolver, functionSecretResolver, compositeSecretResolver, } from './adapters/secret-resolvers.js';
+export { consoleReporter, collectingReporter, formatReport } from './adapters/reporters.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,OAAO,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,23 @@
+/**
+ * webapp-factory/backend-foundation/config — domein-loze, getypte configuratie- en secret-loading met schemavalidatie,
+ * fail-fast start en per-omgeving overrides. Pure TypeScript-core + ports/adapters.
+ */
+// Core: fouten
+export { ConfigKitError, ConfigParseError, ConfigValidationError, SecretResolutionError, } from './core/errors.js';
+// Core: secrets & redactie
+export { Secret, isSecret, REDACTED } from './core/secret.js';
+// Core: env-loading (US-0101)
+export { parseEnv, parseDotenv, mergeSources, coerceByMap, } from './core/env-loader.js';
+// Core: secret-resolutie (US-0102)
+export { resolveSecrets, parseSecretRef, } from './core/secret-resolver.js';
+// Core: per-omgeving overrides (US-0105)
+export { deepMerge, resolveEnvironmentLayers } from './core/merge.js';
+// Core: freeze-util
+export { deepFreeze } from './core/freeze.js';
+// Core: orkestrator (US-0101..US-0105)
+export { loadConfig } from './core/load-config.js';
+// Adapters
+export { zodSchema, zodSecret } from './adapters/zod-schema.js';
+export { fileSecretResolver, mapSecretResolver, functionSecretResolver, compositeSecretResolver, } from './adapters/secret-resolvers.js';
+export { consoleReporter, collectingReporter, formatReport } from './adapters/reporters.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,eAAe;AACf,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAC;AAE1B,2BAA2B;AAC3B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,8BAA8B;AAC9B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,GAIZ,MAAM,sBAAsB,CAAC;AAE9B,mCAAmC;AACnC,OAAO,EACL,cAAc,EACd,cAAc,GAEf,MAAM,2BAA2B,CAAC;AAEnC,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,uCAAuC;AACvC,OAAO,EAAE,UAAU,EAA0B,MAAM,uBAAuB,CAAC;AAE3E,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/config/nestjs/config-kit.module.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Dunne NestJS-adapter. Maakt het gevalideerde, bevroren config-object beschikbaar via dependency
+ * injection. De Nest-types worden uitsluitend als `import type` gebruikt, zodat config-kit geen
+ * harde runtime-afhankelijkheid op `@nestjs/common` heeft (pure core + dunne adapter). `@nestjs/common`
+ * is een optionele peer-dependency: alleen nodig als je deze subpath importeert.
+ *
+ * Gebruik in een Nest-app:
+ *
+ * ```ts
+ * @Module({
+ *   imports: [ConfigKitModule.forRootAsync({ schema, env: process.env })],
+ * })
+ * export class AppModule {}
+ *
+ * // elders:
+ * constructor(@Inject(CONFIG_KIT) private readonly config: AppConfig) {}
+ * ```
+ */
+import type { DynamicModule, InjectionToken } from '@nestjs/common';
+import { type LoadConfigOptions } from '../core/load-config.js';
+/** DI-token waaronder het config-object wordt geregistreerd. */
+export declare const CONFIG_KIT: unique symbol;
+export interface ConfigKitModuleOptions<T> extends LoadConfigOptions<T> {
+    /** Registreer de module globaal (default true), zodat het token overal injecteerbaar is. */
+    global?: boolean;
+    /** Alternatief DI-token; default {@link CONFIG_KIT}. */
+    token?: InjectionToken;
+}
+export declare class ConfigKitModule {
+    /**
+     * Async root-registratie: laadt en valideert de config bij bootstrap (fail-fast) en levert het
+     * bevroren object onder het token. Faalt de validatie, dan verwerpt de provider-factory en stopt
+     * de Nest-bootstrap (fail-fast, US-0104).
+     */
+    static forRootAsync<T>(options: ConfigKitModuleOptions<T>): DynamicModule;
+}
+//# sourceMappingURL=config-kit.module.d.ts.map

package/dist/config/nestjs/config-kit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-kit.module.d.ts","sourceRoot":"","sources":["../../../src/config/nestjs/config-kit.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAY,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,gEAAgE;AAChE,eAAO,MAAM,UAAU,eAAkC,CAAC;AAE1D,MAAM,WAAW,sBAAsB,CAAC,CAAC,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IACrE,4FAA4F;IAC5F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,aAAa;CAa1E"}

package/dist/config/nestjs/config-kit.module.js

@@ -0,0 +1,24 @@
+import { loadConfig } from '../core/load-config.js';
+/** DI-token waaronder het config-object wordt geregistreerd. */
+export const CONFIG_KIT = Symbol.for('config-kit.config');
+export class ConfigKitModule {
+    /**
+     * Async root-registratie: laadt en valideert de config bij bootstrap (fail-fast) en levert het
+     * bevroren object onder het token. Faalt de validatie, dan verwerpt de provider-factory en stopt
+     * de Nest-bootstrap (fail-fast, US-0104).
+     */
+    static forRootAsync(options) {
+        const token = options.token ?? CONFIG_KIT;
+        const provider = {
+            provide: token,
+            useFactory: () => loadConfig(options),
+        };
+        return {
+            module: ConfigKitModule,
+            global: options.global ?? true,
+            providers: [provider],
+            exports: [token],
+        };
+    }
+}
+//# sourceMappingURL=config-kit.module.js.map

package/dist/config/nestjs/config-kit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-kit.module.js","sourceRoot":"","sources":["../../../src/config/nestjs/config-kit.module.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,UAAU,EAA0B,MAAM,wBAAwB,CAAC;AAE5E,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAS1D,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAI,OAAkC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC;QAC1C,MAAM,QAAQ,GAAa;YACzB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,GAAe,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;SAClD,CAAC;QACF,OAAO;YACL,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,OAAO,EAAE,CAAC,KAAK,CAAC;SACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/http/adapters/zod-schema.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Zod-adapter voor de {@link Schema}-poort (US-0203) met JSON-schema-afleiding voor OpenAPI (US-0206).
+ * De validatie-engine is zo vervangbaar zonder de kernel te wijzigen.
+ */
+import { z, type ZodType, type ZodTypeAny } from 'zod';
+import type { JsonSchema, Schema } from '../core/ports.js';
+/** Maakt een {@link Schema} van een Zod-schema. */
+export declare function zodSchema<S extends ZodType>(schema: S): Schema<z.infer<S>>;
+/** Minimale Zod → JSON-schema-conversie voor OpenAPI; onbekende types vallen terug op generiek. */
+export declare function zodToJsonSchema(schema: ZodTypeAny): JsonSchema;
+//# sourceMappingURL=zod-schema.d.ts.map

package/dist/http/adapters/zod-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.d.ts","sourceRoot":"","sources":["../../../src/http/adapters/zod-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAC;AAE9E,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAiB1E;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAoC9D"}

package/dist/http/adapters/zod-schema.js

@@ -0,0 +1,74 @@
+/**
+ * Zod-adapter voor de {@link Schema}-poort (US-0203) met JSON-schema-afleiding voor OpenAPI (US-0206).
+ * De validatie-engine is zo vervangbaar zonder de kernel te wijzigen.
+ */
+import { z } from 'zod';
+/** Maakt een {@link Schema} van een Zod-schema. */
+export function zodSchema(schema) {
+    return {
+        validate(input) {
+            const result = schema.safeParse(input);
+            if (result.success)
+                return { success: true, value: result.data };
+            return {
+                success: false,
+                issues: result.error.issues.map((i) => ({
+                    path: i.path.length > 0 ? i.path.join('.') : '(root)',
+                    message: i.message,
+                })),
+            };
+        },
+        jsonSchema() {
+            return zodToJsonSchema(schema);
+        },
+    };
+}
+/** Minimale Zod → JSON-schema-conversie voor OpenAPI; onbekende types vallen terug op generiek. */
+export function zodToJsonSchema(schema) {
+    const def = schema._def;
+    switch (def['typeName']) {
+        case 'ZodString':
+            return { type: 'string' };
+        case 'ZodNumber':
+            return { type: hasIntCheck(def) ? 'integer' : 'number' };
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodLiteral':
+            return { const: def['value'] };
+        case 'ZodEnum':
+            return { type: 'string', enum: def['values'] };
+        case 'ZodArray':
+            return { type: 'array', items: zodToJsonSchema(def['type']) };
+        case 'ZodObject': {
+            const shape = def['shape']();
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = zodToJsonSchema(value);
+                if (!isOptional(value))
+                    required.push(key);
+            }
+            const out = { type: 'object', properties };
+            if (required.length > 0)
+                out.required = required;
+            return out;
+        }
+        case 'ZodOptional':
+        case 'ZodDefault':
+        case 'ZodNullable':
+            return zodToJsonSchema(def['innerType']);
+        case 'ZodEffects':
+            return zodToJsonSchema(def['schema']);
+        default:
+            return { type: 'object', additionalProperties: true };
+    }
+}
+function hasIntCheck(def) {
+    const checks = def['checks'];
+    return Array.isArray(checks) && checks.some((c) => c.kind === 'int');
+}
+function isOptional(schema) {
+    const typeName = schema._def.typeName;
+    return typeName === 'ZodOptional' || typeName === 'ZodDefault';
+}
+//# sourceMappingURL=zod-schema.js.map

package/dist/http/adapters/zod-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.js","sourceRoot":"","sources":["../../../src/http/adapters/zod-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAiC,MAAM,KAAK,CAAC;AAGvD,mDAAmD;AACnD,MAAM,UAAU,SAAS,CAAoB,MAAS;IACpD,OAAO;QACL,QAAQ,CAAC,KAAc;YACrB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ;oBACrD,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QACD,UAAU;YACR,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAmD,CAAC;IACvE,QAAQ,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3D,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,YAAY;YACf,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAc,EAAE,CAAC;QAC9D,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAe,CAAC,EAAE,CAAC;QAC9E,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAI,GAAG,CAAC,OAAO,CAAsC,EAAE,CAAC;YACnE,MAAM,UAAU,GAA+B,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,GAAG,GAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;YACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,GAAG,CAAC,WAAW,CAAe,CAAC,CAAC;QACzD,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAe,CAAC,CAAC;QACtD;YACE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAA6B;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAoC,CAAC;IAChE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB;IACpC,MAAM,QAAQ,GAAI,MAAM,CAAC,IAA8B,CAAC,QAAQ,CAAC;IACjE,OAAO,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,YAAY,CAAC;AACjE,CAAC"}

package/dist/http/core/context.d.ts

@@ -0,0 +1,25 @@
+import type { KernelRequest, RequestContext } from './ports.js';
+export interface ContextConfig {
+    /** Inkomende/uitgaande correlation-header. Default `x-correlation-id`. */
+    correlationHeader?: string;
+    /** Uitgaande request-id-header. Default `x-request-id`. */
+    requestIdHeader?: string;
+    /** Geldig formaat voor een aangeleverde correlation-id. Default: veilig token. */
+    correlationPattern?: RegExp;
+    /** Id-generator. Default `crypto.randomUUID`. */
+    idGenerator?: () => string;
+}
+export interface BuiltContext {
+    context: RequestContext;
+    /** True als een aangeleverde correlation-header ongeldig was en vervangen is (US-0202 AC3). */
+    invalidCorrelation: boolean;
+}
+/** Bouwt de request-context uit de inkomende headers en de configuratie. */
+export declare function buildRequestContext(headers: KernelRequest['headers'], config?: ContextConfig): BuiltContext;
+/** Response-headers voor de context (request-id + correlation-id). */
+export declare function contextHeaders(context: RequestContext, config?: ContextConfig): Record<string, string>;
+/** Draait `fn` met de gegeven context beschikbaar via {@link getRequestContext}. */
+export declare function runWithContext<T>(context: RequestContext, fn: () => T): T;
+/** Haalt de huidige request-context op (undefined buiten een request). */
+export declare function getRequestContext(): RequestContext | undefined;
+//# sourceMappingURL=context.d.ts.map