webapp-factory 0.1.0

package/dist/http/core/validation.js

@@ -0,0 +1,36 @@
+/**
+ * US-0203 — Input-validatie (DTO/schema).
+ *
+ * Valideert body, query en path-params tegen per-route geregistreerde schema's. Bij succes krijgt de
+ * handler getypte data; bij falen wordt een {@link ValidationError} met een geaggregeerde,
+ * geredigeerde lijst overtredingen geworpen (die de kernel als 400 mapt). De validatie-engine is
+ * vervangbaar via de {@link Schema}-poort; de laag is domein-loos.
+ */
+import { ValidationError } from './errors.js';
+/** Valideert de request-onderdelen; verzamelt álle overtredingen over body/query/params heen. */
+export function validateRequest(req, schemas) {
+    if (!schemas) {
+        return { body: req.body, query: req.query ?? {}, params: req.params ?? {} };
+    }
+    const issues = [];
+    const body = check('body', req.body, schemas.body, issues);
+    const query = check('query', req.query ?? {}, schemas.query, issues);
+    const params = check('params', req.params ?? {}, schemas.params, issues);
+    if (issues.length > 0) {
+        throw new ValidationError(issues);
+    }
+    return { body, query, params };
+}
+function check(scope, value, schema, issues) {
+    if (!schema)
+        return value;
+    const result = schema.validate(value);
+    if (result.success)
+        return result.value;
+    for (const issue of result.issues) {
+        const path = issue.path && issue.path !== '(root)' ? `${scope}.${issue.path}` : scope;
+        issues.push({ path, message: issue.message });
+    }
+    return undefined;
+}
+//# sourceMappingURL=validation.js.map

package/dist/http/core/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/http/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAS9C,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,GAAkB,EAAE,OAAsB;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,KAAK,CACZ,KAAkC,EAClC,KAAc,EACd,MAA4B,EAC5B,MAAyB;IAEzB,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/http/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `http` kit — domein-loze HTTP-plumbing: bootstrap + route-mounting, request-context, validatie,
+ * error-taxonomie, paginatie, OpenAPI en CORS/security-headers. Framework-agnostische core + adapters.
+ *
+ * De NestJS-adapter zit bewust achter de subpath `webapp-factory/backend-foundation/http/nestjs` (harde
+ * `@nestjs/*`-import), zodat de core-kit zonder Nest bruikbaar blijft.
+ */
+export { createKernel, type Kernel, type KernelConfig, type CreateKernelOptions, type KernelLogEvent, } from './core/kernel.js';
+export type { HttpMethod, KernelRequest, KernelResponse, Schema, ValidationOutcome, ValidationIssue, JsonSchema, RequestContext, RouteModule, RouteDefinition, RouteHandler, RouteHandlerInput, RouteSchemas, ListConfig, ListParams, SortField, } from './core/ports.js';
+export { HttpError, ValidationError, toErrorResponse, isHttpError, badRequest, unauthorized, forbidden, notFound, conflict, unprocessable, internal, type ErrorCategory, type ErrorResponseOptions, } from './core/errors.js';
+export { buildRequestContext, contextHeaders, runWithContext, getRequestContext, type ContextConfig, } from './core/context.js';
+export { validateRequest } from './core/validation.js';
+export { parseListQuery, paginate } from './core/pagination.js';
+export { securityHeaders, resolveCors, type SecurityHeadersConfig, type CorsConfig, type CorsResult, } from './core/security.js';
+export { compileRoutes, matchRoute, validateRouteModule, KernelBootstrapError, type CompiledRoute, type RouteMatch, } from './core/router.js';
+export { generateOpenApi, type OpenApiDocument, type OpenApiInfo, type OpenApiOptions, } from './core/openapi.js';
+export { redactSensitive, DEFAULT_SENSITIVE_KEYS } from './core/redaction.js';
+export { zodSchema, zodToJsonSchema } from './adapters/zod-schema.js';
+export { createRequestListener, type NodeRequestListener } from './nodejs/http-adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,GACV,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,eAAe,EACf,eAAe,EACf,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EACL,eAAe,EACf,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,29 @@
+/**
+ * `http` kit — domein-loze HTTP-plumbing: bootstrap + route-mounting, request-context, validatie,
+ * error-taxonomie, paginatie, OpenAPI en CORS/security-headers. Framework-agnostische core + adapters.
+ *
+ * De NestJS-adapter zit bewust achter de subpath `webapp-factory/backend-foundation/http/nestjs` (harde
+ * `@nestjs/*`-import), zodat de core-kit zonder Nest bruikbaar blijft.
+ */
+// Kernel (US-0201..0207)
+export { createKernel, } from './core/kernel.js';
+// Error-taxonomie (US-0204)
+export { HttpError, ValidationError, toErrorResponse, isHttpError, badRequest, unauthorized, forbidden, notFound, conflict, unprocessable, internal, } from './core/errors.js';
+// Request-context (US-0202)
+export { buildRequestContext, contextHeaders, runWithContext, getRequestContext, } from './core/context.js';
+// Validatie (US-0203)
+export { validateRequest } from './core/validation.js';
+// Paginatie/filtering/sortering (US-0205)
+export { parseListQuery, paginate } from './core/pagination.js';
+// CORS + security-headers (US-0207)
+export { securityHeaders, resolveCors, } from './core/security.js';
+// Router (US-0201)
+export { compileRoutes, matchRoute, validateRouteModule, KernelBootstrapError, } from './core/router.js';
+// OpenAPI (US-0206)
+export { generateOpenApi, } from './core/openapi.js';
+// Redactie
+export { redactSensitive, DEFAULT_SENSITIVE_KEYS } from './core/redaction.js';
+// Adapters (dep-vrij / peer via zod)
+export { zodSchema, zodToJsonSchema } from './adapters/zod-schema.js';
+export { createRequestListener } from './nodejs/http-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yBAAyB;AACzB,OAAO,EACL,YAAY,GAKb,MAAM,kBAAkB,CAAC;AAsB1B,4BAA4B;AAC5B,OAAO,EACL,SAAS,EACT,eAAe,EACf,eAAe,EACf,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,QAAQ,GAGT,MAAM,kBAAkB,CAAC;AAE1B,4BAA4B;AAC5B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhE,oCAAoC;AACpC,OAAO,EACL,eAAe,EACf,WAAW,GAIZ,MAAM,oBAAoB,CAAC;AAE5B,mBAAmB;AACnB,OAAO,EACL,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,eAAe,GAIhB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,qCAAqC;AACrC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAA4B,MAAM,0BAA0B,CAAC"}

package/dist/http/nestjs/http-kernel.module.d.ts

@@ -0,0 +1,37 @@
+/**
+ * NestJS-adapter voor de http-kernel. Registreert een wildcard-controller die elk request naar de
+ * kernel routeert, zodat de kernel de routing/plumbing verzorgt en Nest de HTTP-transport levert.
+ *
+ * `@nestjs/common` en `@nestjs/platform-express` zijn optionele peer-dependencies; alleen nodig als je
+ * deze subpath importeert.
+ */
+import { type DynamicModule } from '@nestjs/common';
+import { type CreateKernelOptions, type Kernel } from '../core/kernel.js';
+/** DI-token waaronder de kernel-instance beschikbaar is. */
+export declare const HTTP_KERNEL: unique symbol;
+/** Minimale vorm van een Express-achtig request/response (geen harde type-dep). */
+interface ExpressLikeRequest {
+    method: string;
+    path?: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+}
+interface ExpressLikeResponse {
+    status(code: number): unknown;
+    setHeader(name: string, value: string): unknown;
+    json(body: unknown): unknown;
+    end(): unknown;
+}
+export declare class HttpKernelController {
+    private readonly kernel;
+    constructor(kernel: Kernel);
+    handle(req: ExpressLikeRequest, res: ExpressLikeResponse): Promise<void>;
+}
+export declare class HttpKernelModule {
+    /** Bootstrap de kernel (fail-fast bij ongeldige route-modules) en mount de wildcard-controller. */
+    static forRoot(options: CreateKernelOptions): DynamicModule;
+}
+export {};
+//# sourceMappingURL=http-kernel.module.d.ts.map

package/dist/http/nestjs/http-kernel.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-kernel.module.d.ts","sourceRoot":"","sources":["../../../src/http/nestjs/http-kernel.module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGxF,4DAA4D;AAC5D,eAAO,MAAM,WAAW,eAAmC,CAAC;AAE5D,mFAAmF;AACnF,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AACD,UAAU,mBAAmB;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,GAAG,IAAI,OAAO,CAAC;CAChB;AAED,qBACa,oBAAoB;IACE,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAG1D,MAAM,CAAQ,GAAG,EAAE,kBAAkB,EAAS,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB7F;AAED,qBAAa,gBAAgB;IAC3B,mGAAmG;IACnG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;CAU5D"}

package/dist/http/nestjs/http-kernel.module.js

@@ -0,0 +1,77 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+/**
+ * NestJS-adapter voor de http-kernel. Registreert een wildcard-controller die elk request naar de
+ * kernel routeert, zodat de kernel de routing/plumbing verzorgt en Nest de HTTP-transport levert.
+ *
+ * `@nestjs/common` en `@nestjs/platform-express` zijn optionele peer-dependencies; alleen nodig als je
+ * deze subpath importeert.
+ */
+import { All, Controller, Inject, Req, Res } from '@nestjs/common';
+import { createKernel } from '../core/kernel.js';
+/** DI-token waaronder de kernel-instance beschikbaar is. */
+export const HTTP_KERNEL = Symbol.for('http-kernel.kernel');
+let HttpKernelController = class HttpKernelController {
+    kernel;
+    constructor(kernel) {
+        this.kernel = kernel;
+    }
+    async handle(req, res) {
+        const kreq = {
+            method: req.method,
+            path: req.path ?? new URL(req.url, 'http://localhost').pathname,
+            headers: req.headers,
+            query: req.query ?? {},
+            body: req.body,
+        };
+        const kres = await this.kernel.handle(kreq);
+        res.status(kres.status);
+        for (const [key, value] of Object.entries(kres.headers)) {
+            res.setHeader(key, value);
+        }
+        if (kres.body === null || kres.body === undefined) {
+            res.end();
+        }
+        else {
+            res.json(kres.body);
+        }
+    }
+};
+__decorate([
+    All('*'),
+    __param(0, Req()),
+    __param(1, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], HttpKernelController.prototype, "handle", null);
+HttpKernelController = __decorate([
+    Controller(),
+    __param(0, Inject(HTTP_KERNEL)),
+    __metadata("design:paramtypes", [Object])
+], HttpKernelController);
+export { HttpKernelController };
+export class HttpKernelModule {
+    /** Bootstrap de kernel (fail-fast bij ongeldige route-modules) en mount de wildcard-controller. */
+    static forRoot(options) {
+        const kernel = createKernel(options);
+        return {
+            module: HttpKernelModule,
+            global: true,
+            controllers: [HttpKernelController],
+            providers: [{ provide: HTTP_KERNEL, useValue: kernel }],
+            exports: [HTTP_KERNEL],
+        };
+    }
+}
+//# sourceMappingURL=http-kernel.module.js.map

package/dist/http/nestjs/http-kernel.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-kernel.module.js","sourceRoot":"","sources":["../../../src/http/nestjs/http-kernel.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAsB,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAyC,MAAM,mBAAmB,CAAC;AAGxF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAmBrD,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACmB;IAAlD,YAAkD,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAG9D,AAAN,KAAK,CAAC,MAAM,CAAQ,GAAuB,EAAS,GAAwB;QAC1E,MAAM,IAAI,GAAkB;YAC1B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ;YAC/D,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClD,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF,CAAA;AAnBO;IADL,GAAG,CAAC,GAAG,CAAC;IACK,WAAA,GAAG,EAAE,CAAA;IAA2B,WAAA,GAAG,EAAE,CAAA;;;;kDAkBlD;AAtBU,oBAAoB;IADhC,UAAU,EAAE;IAEE,WAAA,MAAM,CAAC,WAAW,CAAC,CAAA;;GADrB,oBAAoB,CAuBhC;;AAED,MAAM,OAAO,gBAAgB;IAC3B,mGAAmG;IACnG,MAAM,CAAC,OAAO,CAAC,OAA4B;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO;YACL,MAAM,EAAE,gBAAgB;YACxB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,CAAC,oBAAoB,CAAC;YACnC,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC,WAAW,CAAC;SACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/http/nodejs/http-adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Node-http-adapter: bindt de kernel aan het ingebouwde `node:http`-servermodel zonder externe deps.
+ * Vertaalt een `IncomingMessage` naar een {@link KernelRequest} en schrijft de {@link KernelResponse}
+ * naar de `ServerResponse`.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Kernel } from '../core/kernel.js';
+export type NodeRequestListener = (req: IncomingMessage, res: ServerResponse) => void;
+/** Maakt een `http.createServer`-compatibele listener die requests naar de kernel routeert. */
+export declare function createRequestListener(kernel: Kernel): NodeRequestListener;
+//# sourceMappingURL=http-adapter.d.ts.map

package/dist/http/nodejs/http-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../../src/http/nodejs/http-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;AAEtF,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAUzE"}

package/dist/http/nodejs/http-adapter.js

@@ -0,0 +1,60 @@
+/** Maakt een `http.createServer`-compatibele listener die requests naar de kernel routeert. */
+export function createRequestListener(kernel) {
+    return (req, res) => {
+        handle(kernel, req, res).catch(() => {
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.setHeader('Content-Type', 'application/json');
+            }
+            res.end(JSON.stringify({ error: { code: 'INTERNAL_ERROR', message: 'Internal server error' } }));
+        });
+    };
+}
+async function handle(kernel, req, res) {
+    const url = new URL(req.url ?? '/', 'http://localhost');
+    const query = {};
+    for (const [key, value] of url.searchParams.entries()) {
+        query[key] = value;
+    }
+    const kreq = {
+        method: req.method ?? 'GET',
+        path: url.pathname,
+        headers: req.headers,
+        query,
+        body: await readBody(req),
+    };
+    const kres = await kernel.handle(kreq);
+    res.statusCode = kres.status;
+    for (const [key, value] of Object.entries(kres.headers)) {
+        res.setHeader(key, value);
+    }
+    if (kres.body === null || kres.body === undefined) {
+        res.end();
+        return;
+    }
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify(kres.body));
+}
+async function readBody(req) {
+    const method = (req.method ?? 'GET').toUpperCase();
+    if (method === 'GET' || method === 'HEAD')
+        return undefined;
+    const chunks = [];
+    for await (const chunk of req) {
+        chunks.push(chunk);
+    }
+    if (chunks.length === 0)
+        return undefined;
+    const raw = Buffer.concat(chunks).toString('utf8');
+    const contentType = req.headers['content-type'] ?? '';
+    if (contentType.includes('application/json')) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return raw; // ongeldige JSON -> laat validatie het afvangen
+        }
+    }
+    return raw;
+}
+//# sourceMappingURL=http-adapter.js.map

package/dist/http/nodejs/http-adapter.js.map

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

package/dist/i18n/core/catalog.d.ts

@@ -0,0 +1,23 @@
+/**
+ * US-1301 — Catalogus-loader + fallback-keten. Indexeert geïnjecteerde locale-catalogi en resolvet een
+ * sleutel via de fallback-keten (bv. `nl-BE → nl → default`). Bevat geen vertaalinhoud.
+ */
+import type { Catalogs, MessageValue } from './ports.js';
+export interface ResolvedMessage {
+    value: MessageValue;
+    /** De locale waaruit de sleutel uiteindelijk is opgehaald (voor pluralisatie). */
+    locale: string;
+}
+export interface CatalogResolver {
+    resolveKey(locale: string, key: string): ResolvedMessage | null;
+    readonly supportedLocales: string[];
+    readonly defaultLocale: string;
+}
+/** Bouwt de fallback-keten voor een locale, eindigend op de default-locale. */
+export declare function fallbackChain(locale: string, defaultLocale: string): string[];
+export declare function createCatalogResolver(options: {
+    catalogs: Catalogs;
+    defaultLocale: string;
+    supportedLocales?: string[];
+}): CatalogResolver;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/i18n/core/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAS7E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG,eAAe,CAgBlB"}

package/dist/i18n/core/catalog.js

@@ -0,0 +1,31 @@
+/** Bouwt de fallback-keten voor een locale, eindigend op de default-locale. */
+export function fallbackChain(locale, defaultLocale) {
+    const chain = [];
+    const parts = locale.split('-');
+    for (let i = parts.length; i >= 1; i--) {
+        const candidate = parts.slice(0, i).join('-');
+        if (!chain.includes(candidate))
+            chain.push(candidate);
+    }
+    if (!chain.includes(defaultLocale))
+        chain.push(defaultLocale);
+    return chain;
+}
+export function createCatalogResolver(options) {
+    const catalogs = options.catalogs;
+    const defaultLocale = options.defaultLocale;
+    const supportedLocales = options.supportedLocales ?? Object.keys(catalogs);
+    return {
+        supportedLocales,
+        defaultLocale,
+        resolveKey(locale, key) {
+            for (const candidate of fallbackChain(locale, defaultLocale)) {
+                const value = catalogs[candidate]?.[key];
+                if (value !== undefined)
+                    return { value, locale: candidate };
+            }
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/i18n/core/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/i18n/core/catalog.ts"],"names":[],"mappings":"AAkBA,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,aAAqB;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAIrC;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE3E,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,UAAU,CAAC,MAAM,EAAE,GAAG;YACpB,KAAK,MAAM,SAAS,IAAI,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;gBAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/i18n/core/errors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Foutentaxonomie voor i18n. Ontbrekende sleutels crashen niet (ze leveren een marker + waarschuwing);
+ * een ontbrekende interpolatie-parameter is wél een expliciete fout (US-1302 AC3).
+ */
+export declare class I18nError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** Een of meer benoemde interpolatie-parameters ontbreken (US-1302 AC3). */
+export declare class MissingParamError extends I18nError {
+    readonly params: string[];
+    constructor(params: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/i18n/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM1C;AAED,4EAA4E;AAC5E,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACd,MAAM,EAAE,MAAM,EAAE;CAI7B"}

package/dist/i18n/core/errors.js

@@ -0,0 +1,22 @@
+/**
+ * Foutentaxonomie voor i18n. Ontbrekende sleutels crashen niet (ze leveren een marker + waarschuwing);
+ * een ontbrekende interpolatie-parameter is wél een expliciete fout (US-1302 AC3).
+ */
+export class I18nError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Een of meer benoemde interpolatie-parameters ontbreken (US-1302 AC3). */
+export class MissingParamError extends I18nError {
+    params;
+    constructor(params) {
+        super(`Ontbrekende interpolatie-parameter(s): ${params.join(', ')}`, 'MISSING_PARAM');
+        this.params = params;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/i18n/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/i18n/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAS;IACtB,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IACrC,MAAM,CAAW;IAC1B,YAAY,MAAgB;QAC1B,KAAK,CAAC,0CAA0C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/i18n/core/i18n.d.ts

@@ -0,0 +1,20 @@
+import type { Catalogs, I18nLogger, LocaleContext, MessageParams } from './ports.js';
+export interface I18n {
+    /** Directe vertaling; gooit bij een ontbrekende interpolatie-parameter (US-1302). */
+    translate(locale: string, key: string, params?: MessageParams): string;
+    negotiate(context: LocaleContext): string;
+    /** Gelokaliseerd foutbericht; crash-veilig. */
+    resolveError(code: string, params: MessageParams, context: LocaleContext): string;
+    /** Gelokaliseerd e-mailbericht; crash-veilig. */
+    resolveEmail(templateKey: string, params: MessageParams, context: LocaleContext): string;
+    readonly supportedLocales: string[];
+    readonly defaultLocale: string;
+}
+export interface I18nOptions {
+    catalogs: Catalogs;
+    defaultLocale: string;
+    supportedLocales?: string[];
+    logger?: I18nLogger;
+}
+export declare function createI18n(options: I18nOptions): I18n;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n/core/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/i18n.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,IAAI;IACnB,qFAAqF;IACrF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACvE,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;IAC1C,+CAA+C;IAC/C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;IAClF,iDAAiD;IACjD,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;IACzF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAuCrD"}

package/dist/i18n/core/i18n.js

@@ -0,0 +1,48 @@
+/**
+ * US-1304 — Resolutie-façade. Bindt catalogus-loader (US-1301), interpolatie/pluralisatie (US-1302) en
+ * locale-negotiatie (US-1303) samen tot `translate`, `resolveError` en `resolveEmail`. De façade is
+ * crash-veilig: onbekende sleutels/parameters leveren een herkenbare fallback + waarschuwing, zonder
+ * PII of stacktrace te lekken. Alleen expliciet meegegeven parameters worden geïnterpoleerd.
+ */
+import { createCatalogResolver } from './catalog.js';
+import { MissingParamError } from './errors.js';
+import { buildMessage } from './message.js';
+import { negotiateLocale, parseAcceptLanguage } from './negotiate.js';
+export function createI18n(options) {
+    const resolver = createCatalogResolver(options);
+    const logger = options.logger ?? { warn: (message, meta) => console.warn(message, meta) };
+    function translate(locale, key, params = {}) {
+        const resolved = resolver.resolveKey(locale, key);
+        if (!resolved) {
+            logger.warn('i18n: ontbrekende sleutel', { key, locale });
+            return key; // herkenbare missing-key-marker (US-1301 AC3)
+        }
+        return buildMessage(resolved.locale, resolved.value, params);
+    }
+    function negotiate(context) {
+        const desired = 'acceptLanguage' in context ? parseAcceptLanguage(context.acceptLanguage) : context.desired;
+        return negotiateLocale(desired, resolver.supportedLocales, resolver.defaultLocale);
+    }
+    function resolve(key, params, context) {
+        const locale = negotiate(context);
+        try {
+            return translate(locale, key, params);
+        }
+        catch (error) {
+            logger.warn('i18n: resolutie-fout', {
+                key,
+                ...(error instanceof MissingParamError ? { missingParams: error.params } : {}),
+            });
+            return key; // crash-veilige fallback, geen half-ingevuld bericht (US-1304 AC3)
+        }
+    }
+    return {
+        translate,
+        negotiate,
+        resolveError: (code, params, context) => resolve(code, params, context),
+        resolveEmail: (templateKey, params, context) => resolve(templateKey, params, context),
+        supportedLocales: resolver.supportedLocales,
+        defaultLocale: resolver.defaultLocale,
+    };
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n/core/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/i18n/core/i18n.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAsBtE,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAe,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;IAEtG,SAAS,SAAS,CAAC,MAAc,EAAE,GAAW,EAAE,SAAwB,EAAE;QACxE,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,OAAO,GAAG,CAAC,CAAC,8CAA8C;QAC5D,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,SAAS,SAAS,CAAC,OAAsB;QACvC,MAAM,OAAO,GAAG,gBAAgB,IAAI,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5G,OAAO,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACrF,CAAC;IAED,SAAS,OAAO,CAAC,GAAW,EAAE,MAAqB,EAAE,OAAsB;QACzE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAClC,GAAG;gBACH,GAAG,CAAC,KAAK,YAAY,iBAAiB,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,CAAC,mEAAmE;QACjF,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,SAAS;QACT,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;QACvE,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC;QACrF,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,aAAa,EAAE,QAAQ,CAAC,aAAa;KACtC,CAAC;AACJ,CAAC"}

package/dist/i18n/core/message.d.ts

@@ -0,0 +1,8 @@
+import type { MessageParams, MessageValue, PluralForms } from './ports.js';
+/** Vervangt `{name}` door parameters; gooit {@link MissingParamError} bij ontbrekende parameters. */
+export declare function interpolate(template: string, params: MessageParams): string;
+/** Kiest de juiste plural-vorm voor `count` in de gegeven locale (CLDR via `Intl.PluralRules`). */
+export declare function selectPluralForm(locale: string, forms: PluralForms, count: number): string;
+/** Bouwt het uiteindelijke bericht: kiest de plural-vorm (indien nodig) en interpoleert. */
+export declare function buildMessage(locale: string, value: MessageValue, params: MessageParams): string;
+//# sourceMappingURL=message.d.ts.map

package/dist/i18n/core/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/message.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI3E,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAW3E;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAI/F"}

package/dist/i18n/core/message.js

@@ -0,0 +1,38 @@
+/**
+ * US-1302 — Interpolatie + pluralisatie. Interpoleert benoemde variabelen (`{name}`) en kiest de
+ * CLDR-plural-vorm via de ingebouwde `Intl.PluralRules` (geen externe dep). Een ontbrekende parameter
+ * levert een expliciete fout op — nooit een half ingevuld bericht.
+ */
+import { MissingParamError } from './errors.js';
+const PLACEHOLDER = /\{(\w+)\}/g;
+/** Vervangt `{name}` door parameters; gooit {@link MissingParamError} bij ontbrekende parameters. */
+export function interpolate(template, params) {
+    const missing = [];
+    const result = template.replace(PLACEHOLDER, (_, name) => {
+        if (!(name in params)) {
+            missing.push(name);
+            return '';
+        }
+        return String(params[name]);
+    });
+    if (missing.length > 0)
+        throw new MissingParamError([...new Set(missing)]);
+    return result;
+}
+/** Kiest de juiste plural-vorm voor `count` in de gegeven locale (CLDR via `Intl.PluralRules`). */
+export function selectPluralForm(locale, forms, count) {
+    let category = 'other';
+    try {
+        category = new Intl.PluralRules(locale).select(count);
+    }
+    catch {
+        category = 'other';
+    }
+    return forms[category] ?? forms.other;
+}
+/** Bouwt het uiteindelijke bericht: kiest de plural-vorm (indien nodig) en interpoleert. */
+export function buildMessage(locale, value, params) {
+    const template = typeof value === 'string' ? value : selectPluralForm(locale, value, Number(params['count'] ?? 0));
+    return interpolate(template, params);
+}
+//# sourceMappingURL=message.js.map

package/dist/i18n/core/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/i18n/core/message.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,WAAW,GAAG,YAAY,CAAC;AAEjC,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,MAAqB;IACjE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QAC/D,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAkB,EAAE,KAAa;IAChF,IAAI,QAAQ,GAAwB,OAAO,CAAC;IAC5C,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC;AACxC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAmB,EAAE,MAAqB;IACrF,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpG,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/i18n/core/negotiate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * US-1303 — Locale-negotiatie. Matcht gewenste locales (met q-weging, zoals in `Accept-Language`)
+ * tegen de ondersteunde locales; valt terug op de default als geen enkele wordt ondersteund.
+ */
+export interface DesiredLocale {
+    locale: string;
+    q?: number;
+}
+/** Parset een `Accept-Language`-headerwaarde naar een lijst met q-weging. */
+export declare function parseAcceptLanguage(header: string): DesiredLocale[];
+/** Kiest de best passende ondersteunde locale, of de default-locale bij geen match. */
+export declare function negotiateLocale(desired: DesiredLocale[], supported: string[], defaultLocale: string): string;
+//# sourceMappingURL=negotiate.d.ts.map

package/dist/i18n/core/negotiate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiate.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/negotiate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAanE;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAUR"}

package/dist/i18n/core/negotiate.js

@@ -0,0 +1,46 @@
+/**
+ * US-1303 — Locale-negotiatie. Matcht gewenste locales (met q-weging, zoals in `Accept-Language`)
+ * tegen de ondersteunde locales; valt terug op de default als geen enkele wordt ondersteund.
+ */
+/** Parset een `Accept-Language`-headerwaarde naar een lijst met q-weging. */
+export function parseAcceptLanguage(header) {
+    return header
+        .split(',')
+        .map((part) => {
+        const [locale, ...params] = part.trim().split(';');
+        let q = 1;
+        for (const param of params) {
+            const match = /q=([0-9.]+)/.exec(param.trim());
+            if (match)
+                q = Number(match[1]);
+        }
+        return { locale: (locale ?? '').trim(), q };
+    })
+        .filter((entry) => entry.locale.length > 0 && entry.locale !== '*');
+}
+/** Kiest de best passende ondersteunde locale, of de default-locale bij geen match. */
+export function negotiateLocale(desired, supported, defaultLocale) {
+    const sorted = desired
+        .map((d, index) => ({ locale: d.locale, q: d.q ?? 1, index }))
+        .sort((a, b) => b.q - a.q || a.index - b.index);
+    for (const { locale } of sorted) {
+        const match = matchSupported(locale, supported);
+        if (match)
+            return match;
+    }
+    return defaultLocale;
+}
+function matchSupported(desired, supported) {
+    const d = desired.toLowerCase();
+    for (const candidate of supported) {
+        const s = candidate.toLowerCase();
+        if (d === s)
+            return candidate;
+        if (d.startsWith(`${s}-`))
+            return candidate; // "nl-NL" matcht ondersteunde "nl"
+        if (s.startsWith(`${d}-`))
+            return candidate; // "nl" matcht ondersteunde "nl-BE"
+    }
+    return null;
+}
+//# sourceMappingURL=negotiate.js.map