@seifer-webapp-factory/kits 0.1.0

package/dist/backend/persistence/adapters/testcontainer-harness.js

@@ -0,0 +1,79 @@
+import { ConnectionError, redactReason } from '../core/errors.js';
+import { MigrationRunner } from '../core/migrations.js';
+import { createPool } from '../core/pool.js';
+import { quoteIdent } from '../core/sql.js';
+import { pgDriver } from './pg-driver.js';
+/** Start een wegwerp-database, past migraties toe en levert een {@link TestDatabase}. */
+export async function startTestDatabase(options) {
+    const factory = options.containerFactory ?? postgresContainerFactory();
+    const started = await factory.start();
+    const pool = createPool(started.driver, options.poolConfig ?? {});
+    try {
+        await pool.init();
+        const runnerOptions = options.ledgerTable ? { ledgerTable: options.ledgerTable } : {};
+        await new MigrationRunner(pool, options.migrations, runnerOptions).up();
+    }
+    catch (error) {
+        await pool.close().catch(() => undefined);
+        await started.stop().catch(() => undefined);
+        throw error instanceof ConnectionError
+            ? error
+            : new ConnectionError(`Testdatabase kon niet worden voorbereid: ${redactReason(error)}`);
+    }
+    const managed = options.managedTables ?? [];
+    return {
+        pool,
+        reset: async () => {
+            if (managed.length === 0)
+                return;
+            const list = managed.map(quoteIdent).join(', ');
+            await pool.execute(`TRUNCATE TABLE ${list} RESTART IDENTITY CASCADE`);
+        },
+        stop: async () => {
+            await pool.close().catch(() => undefined);
+            await started.stop().catch(() => undefined);
+        },
+    };
+}
+/** Echte Postgres-testcontainer-factory (vereist een Docker-runtime). */
+export function postgresContainerFactory(options = {}) {
+    const image = options.image ?? 'postgres:16-alpine';
+    const database = options.database ?? 'test';
+    const user = options.user ?? 'test';
+    const password = options.password ?? 'test';
+    return {
+        start: async () => {
+            let container;
+            try {
+                const { GenericContainer, Wait } = await import('testcontainers');
+                container = await new GenericContainer(image)
+                    .withEnvironment({
+                    POSTGRES_USER: user,
+                    POSTGRES_PASSWORD: password,
+                    POSTGRES_DB: database,
+                })
+                    .withExposedPorts(5432)
+                    .withWaitStrategy(Wait.forLogMessage(/database system is ready to accept connections/, 2))
+                    .start();
+            }
+            catch (error) {
+                throw new ConnectionError(`Postgres-testcontainer kon niet starten (is de Docker-runtime beschikbaar?): ${redactReason(error)}`);
+            }
+            const connection = {
+                host: container.getHost(),
+                port: container.getMappedPort(5432),
+                database,
+                user,
+                password,
+            };
+            return {
+                driver: pgDriver(connection),
+                connection,
+                stop: async () => {
+                    await container.stop();
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=testcontainer-harness.js.map

package/dist/backend/persistence/adapters/testcontainer-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcontainer-harness.js","sourceRoot":"","sources":["../../../../backend/src/persistence/adapters/testcontainer-harness.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAA2B,MAAM,gBAAgB,CAAC;AA8BnE,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA4B;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,IAAI,wBAAwB,EAAE,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,KAAK,YAAY,eAAe;YACpC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,eAAe,CAAC,4CAA4C,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IAC5C,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,2BAA2B,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AASD,yEAAyE;AACzE,MAAM,UAAU,wBAAwB,CAAC,UAAoC,EAAE;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,oBAAoB,CAAC;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;IAE5C,OAAO;QACL,KAAK,EAAE,KAAK,IAA8B,EAAE;YAC1C,IAAI,SAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAClE,SAAS,GAAG,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC;qBAC1C,eAAe,CAAC;oBACf,aAAa,EAAE,IAAI;oBACnB,iBAAiB,EAAE,QAAQ;oBAC3B,WAAW,EAAE,QAAQ;iBACtB,CAAC;qBACD,gBAAgB,CAAC,IAAI,CAAC;qBACtB,gBAAgB,CACf,IAAI,CAAC,aAAa,CAAC,gDAAgD,EAAE,CAAC,CAAC,CACxE;qBACA,KAAK,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,eAAe,CACvB,gFAAgF,YAAY,CAC1F,KAAK,CACN,EAAE,CACJ,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAuB;gBACrC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE;gBACzB,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC;gBACnC,QAAQ;gBACR,IAAI;gBACJ,QAAQ;aACT,CAAC;YACF,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC;gBAC5B,UAAU;gBACV,IAAI,EAAE,KAAK,IAAI,EAAE;oBACf,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzB,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Foutentaxonomie voor de persistence-kit. Fouten lekken nooit ruwe SQL of verbindingsgeheimen
+ * (US-0301 AC3, US-0304 AC3).
+ */
+export declare class PersistenceError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/** Verbinding kon niet worden opgezet/gevalideerd (fail-fast). Bevat geen wachtwoord. */
+export declare class ConnectionError extends PersistenceError {
+    constructor(message: string);
+}
+/** Geen verbinding beschikbaar binnen de acquire-timeout (pool verzadigd). */
+export declare class PoolTimeoutError extends PersistenceError {
+    constructor(message?: string);
+}
+/** Generieke query-fout; bevat bewust geen ruwe SQL. */
+export declare class QueryError extends PersistenceError {
+    constructor(message?: string);
+}
+/** Schending van een unieke constraint (US-0304 AC3). */
+export declare class UniqueConstraintError extends PersistenceError {
+    readonly constraint: string | undefined;
+    constructor(constraint?: string);
+}
+/** Fout tijdens een migratie; benoemt de migratie-id, geen ruwe SQL. */
+export declare class MigrationError extends PersistenceError {
+    readonly migrationId: string;
+    constructor(migrationId: string, reason: string);
+}
+/**
+ * Redigeert een reden/melding: verwijdert `password=...`, `://user:pass@` en losse secret-achtige
+ * fragmenten zodat verbindingsgeheimen niet in fouten of logs belanden.
+ */
+export declare function redactReason(input: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../backend/src/persistence/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAsB;CAMxD;AAED,yFAAyF;AACzF,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM;CAG5B;AAED,8EAA8E;AAC9E,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,OAAO,SAA0D;CAG9E;AAED,wDAAwD;AACxD,qBAAa,UAAW,SAAQ,gBAAgB;gBAClC,OAAO,SAA0B;CAG9C;AAED,yDAAyD;AACzD,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAC5B,UAAU,CAAC,EAAE,MAAM;CAOhC;AAED,wEAAwE;AACxE,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBACjB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIhD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnD"}

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

@@ -0,0 +1,58 @@
+/**
+ * Foutentaxonomie voor de persistence-kit. Fouten lekken nooit ruwe SQL of verbindingsgeheimen
+ * (US-0301 AC3, US-0304 AC3).
+ */
+export class PersistenceError extends Error {
+    code;
+    constructor(message, code = 'PERSISTENCE_ERROR') {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Verbinding kon niet worden opgezet/gevalideerd (fail-fast). Bevat geen wachtwoord. */
+export class ConnectionError extends PersistenceError {
+    constructor(message) {
+        super(message, 'CONNECTION_ERROR');
+    }
+}
+/** Geen verbinding beschikbaar binnen de acquire-timeout (pool verzadigd). */
+export class PoolTimeoutError extends PersistenceError {
+    constructor(message = 'Geen databaseverbinding beschikbaar binnen de timeout') {
+        super(message, 'POOL_TIMEOUT');
+    }
+}
+/** Generieke query-fout; bevat bewust geen ruwe SQL. */
+export class QueryError extends PersistenceError {
+    constructor(message = 'Databasequery mislukt') {
+        super(message, 'QUERY_ERROR');
+    }
+}
+/** Schending van een unieke constraint (US-0304 AC3). */
+export class UniqueConstraintError extends PersistenceError {
+    constraint;
+    constructor(constraint) {
+        super(`Unieke constraint geschonden${constraint ? ` (${constraint})` : ''}`, 'UNIQUE_VIOLATION');
+        this.constraint = constraint;
+    }
+}
+/** Fout tijdens een migratie; benoemt de migratie-id, geen ruwe SQL. */
+export class MigrationError extends PersistenceError {
+    migrationId;
+    constructor(migrationId, reason) {
+        super(`Migratie "${migrationId}" mislukt: ${reason}`, 'MIGRATION_ERROR');
+        this.migrationId = migrationId;
+    }
+}
+/**
+ * Redigeert een reden/melding: verwijdert `password=...`, `://user:pass@` en losse secret-achtige
+ * fragmenten zodat verbindingsgeheimen niet in fouten of logs belanden.
+ */
+export function redactReason(input) {
+    let text = input instanceof Error ? input.message : String(input);
+    text = text.replace(/(password|pwd)\s*=\s*[^\s;&]+/gi, '$1=***');
+    text = text.replace(/(:\/\/[^:@/\s]+:)[^@/\s]+@/g, '$1***@');
+    return text;
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../backend/src/persistence/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAS;IACtB,YAAY,OAAe,EAAE,IAAI,GAAG,mBAAmB;QACrD,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,yFAAyF;AACzF,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACrC,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,YAAY,OAAO,GAAG,uDAAuD;QAC3E,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACjC,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,OAAO,UAAW,SAAQ,gBAAgB;IAC9C,YAAY,OAAO,GAAG,uBAAuB;QAC3C,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IAChD,UAAU,CAAqB;IACxC,YAAY,UAAmB;QAC7B,KAAK,CACH,+BAA+B,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EACrE,kBAAkB,CACnB,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IACzC,WAAW,CAAS;IAC7B,YAAY,WAAmB,EAAE,MAAc;QAC7C,KAAK,CAAC,aAAa,WAAW,cAAc,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACzE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iCAAiC,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/backend/persistence/core/migrations.d.ts

@@ -0,0 +1,16 @@
+import type { Migration, MigrationStatus, Pool } from './ports.js';
+export interface MigrationRunnerOptions {
+    /** Naam van de ledgertabel. Default `schema_migrations`. */
+    ledgerTable?: string;
+}
+export declare class MigrationRunner {
+    #private;
+    constructor(pool: Pool, migrations: Migration[], options?: MigrationRunnerOptions);
+    /** Overzicht van toegepaste vs. openstaande migraties. */
+    status(): Promise<MigrationStatus>;
+    /** Past alle openstaande migraties in volgorde toe. Retourneert de toegepaste ids. */
+    up(): Promise<string[]>;
+    /** Draait de laatste `steps` toegepaste migraties terug. Retourneert de teruggedraaide ids. */
+    down(steps?: number): Promise<string[]>;
+}
+//# sourceMappingURL=migrations.d.ts.map

package/dist/backend/persistence/core/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../../backend/src/persistence/core/migrations.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;;gBAKd,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,sBAA2B;IAOrF,0DAA0D;IACpD,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAUxC,sFAAsF;IAChF,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB7B,+FAA+F;IACzF,IAAI,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA+CzC"}

package/dist/backend/persistence/core/migrations.js

@@ -0,0 +1,95 @@
+/**
+ * US-0303 — Migratie-runner (up/down/status).
+ *
+ * Voert geïnjecteerde migraties uit (elk met een stabiele `id`, `up` en `down`), houdt een
+ * ledgertabel bij van toegepaste migraties en draait elke migratie transactioneel: bij een fout rolt
+ * die migratie terug en stopt de runner met een duidelijke fout; eerder toegepaste migraties blijven
+ * intact. Idempotent: reeds toegepaste migraties worden overgeslagen. Bevat geen concrete migraties.
+ */
+import { MigrationError, redactReason } from './errors.js';
+import { quoteIdent } from './sql.js';
+export class MigrationRunner {
+    #pool;
+    #migrations;
+    #ledger;
+    constructor(pool, migrations, options = {}) {
+        this.#pool = pool;
+        this.#ledger = options.ledgerTable ?? 'schema_migrations';
+        this.#migrations = [...migrations].sort((a, b) => a.id.localeCompare(b.id));
+        this.#assertUniqueIds();
+    }
+    /** Overzicht van toegepaste vs. openstaande migraties. */
+    async status() {
+        await this.#ensureLedger();
+        const applied = await this.#appliedIds();
+        const appliedSet = new Set(applied);
+        return {
+            applied,
+            pending: this.#migrations.filter((m) => !appliedSet.has(m.id)).map((m) => m.id),
+        };
+    }
+    /** Past alle openstaande migraties in volgorde toe. Retourneert de toegepaste ids. */
+    async up() {
+        await this.#ensureLedger();
+        const applied = new Set(await this.#appliedIds());
+        const pending = this.#migrations.filter((m) => !applied.has(m.id));
+        const done = [];
+        for (const migration of pending) {
+            try {
+                await this.#pool.withTransaction(async (exec) => {
+                    await migration.up({ execute: (sql, params) => exec.execute(sql, params) });
+                    await exec.execute(`INSERT INTO ${quoteIdent(this.#ledger)} ("id") VALUES ($1)`, [
+                        migration.id,
+                    ]);
+                });
+            }
+            catch (error) {
+                throw new MigrationError(migration.id, redactReason(error));
+            }
+            done.push(migration.id);
+        }
+        return done;
+    }
+    /** Draait de laatste `steps` toegepaste migraties terug. Retourneert de teruggedraaide ids. */
+    async down(steps = 1) {
+        await this.#ensureLedger();
+        const applied = await this.#appliedIds();
+        const toRevert = applied.slice(-steps).reverse();
+        const reverted = [];
+        for (const id of toRevert) {
+            const migration = this.#migrations.find((m) => m.id === id);
+            if (!migration) {
+                throw new MigrationError(id, 'migratie niet gevonden in de geïnjecteerde set');
+            }
+            try {
+                await this.#pool.withTransaction(async (exec) => {
+                    await migration.down({ execute: (sql, params) => exec.execute(sql, params) });
+                    await exec.execute(`DELETE FROM ${quoteIdent(this.#ledger)} WHERE "id" = $1`, [id]);
+                });
+            }
+            catch (error) {
+                throw new MigrationError(id, redactReason(error));
+            }
+            reverted.push(id);
+        }
+        return reverted;
+    }
+    async #ensureLedger() {
+        await this.#pool.execute(`CREATE TABLE IF NOT EXISTS ${quoteIdent(this.#ledger)} ` +
+            `("id" text PRIMARY KEY, "applied_at" timestamptz NOT NULL DEFAULT now())`);
+    }
+    async #appliedIds() {
+        const result = await this.#pool.execute(`SELECT "id" FROM ${quoteIdent(this.#ledger)} ORDER BY "id" ASC`);
+        return result.rows.map((r) => r.id);
+    }
+    #assertUniqueIds() {
+        const seen = new Set();
+        for (const m of this.#migrations) {
+            if (seen.has(m.id)) {
+                throw new MigrationError(m.id, 'dubbele migratie-id in de geïnjecteerde set');
+            }
+            seen.add(m.id);
+        }
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/backend/persistence/core/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../../../backend/src/persistence/core/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAOtC,MAAM,OAAO,eAAe;IACjB,KAAK,CAAO;IACZ,WAAW,CAAc;IACzB,OAAO,CAAS;IAEzB,YAAY,IAAU,EAAE,UAAuB,EAAE,UAAkC,EAAE;QACnF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;QAC1D,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO;YACL,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,EAAE;QACN,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;oBAC9C,MAAM,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC5E,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE;wBAC/E,SAAS,CAAC,EAAE;qBACb,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC;QAClB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,cAAc,CAAC,EAAE,EAAE,gDAAgD,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;oBAC9C,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC9E,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtF,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,cAAc,CAAC,EAAE,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtB,8BAA8B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;YACvD,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACrC,oBAAoB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CACjE,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,gBAAgB;QACd,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnB,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,6CAA6C,CAAC,CAAC;YAChF,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/backend/persistence/core/pool.d.ts

@@ -0,0 +1,4 @@
+import type { Driver, Pool, PoolConfig } from './ports.js';
+/** Maakt een beheerde connectie-pool over een {@link Driver}-adapter. */
+export declare function createPool(driver: Driver, config?: PoolConfig): Pool;
+//# sourceMappingURL=pool.d.ts.map

package/dist/backend/persistence/core/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../../backend/src/persistence/core/pool.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,MAAM,EAIN,IAAI,EACJ,UAAU,EAIX,MAAM,YAAY,CAAC;AAsLpB,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,IAAI,CAExE"}

package/dist/backend/persistence/core/pool.js

@@ -0,0 +1,180 @@
+/**
+ * US-0301 — Connectie-pool + health-probe, en US-0302 — Transactie-scope / unit-of-work.
+ *
+ * Beheert fysieke verbindingen via de {@link Driver}-poort met een max-grootte en acquire-timeout,
+ * valideert de verbinding fail-fast bij opstart en biedt een health-probe (`healthy`/`degraded`/
+ * `down`). `withTransaction` orkestreert commit/rollback; geneste aanroepen hergebruiken de
+ * transactie via savepoints (geen globale state — de context loopt via AsyncLocalStorage).
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { ConnectionError, PoolTimeoutError, redactReason, } from './errors.js';
+const DEFAULT_MAX = 10;
+const DEFAULT_ACQUIRE_TIMEOUT = 5000;
+const DEFAULT_HEALTH_TIMEOUT = 1000;
+class ConnectionPool {
+    #driver;
+    #max;
+    #acquireTimeout;
+    #healthTimeout;
+    #leases = [];
+    #waiters = [];
+    #als = new AsyncLocalStorage();
+    #savepointSeq = 0;
+    #closed = false;
+    constructor(driver, config = {}) {
+        this.#driver = driver;
+        this.#max = config.max ?? DEFAULT_MAX;
+        this.#acquireTimeout = config.acquireTimeoutMs ?? DEFAULT_ACQUIRE_TIMEOUT;
+        this.#healthTimeout = config.healthTimeoutMs ?? DEFAULT_HEALTH_TIMEOUT;
+    }
+    get stats() {
+        const inUse = this.#leases.filter((l) => l.inUse).length;
+        return { total: this.#leases.length, idle: this.#leases.length - inUse, inUse };
+    }
+    async init() {
+        try {
+            const lease = await this.#acquire(this.#acquireTimeout);
+            try {
+                await lease.conn.execute('SELECT 1');
+            }
+            finally {
+                this.#release(lease);
+            }
+        }
+        catch (error) {
+            throw new ConnectionError(`Databaseverbinding kon niet worden opgezet: ${redactReason(error)}`);
+        }
+    }
+    async execute(sql, params) {
+        const scope = this.#als.getStore();
+        if (scope)
+            return scope.exec.execute(sql, params);
+        return this.withConnection((exec) => exec.execute(sql, params));
+    }
+    async withConnection(fn) {
+        const lease = await this.#acquire(this.#acquireTimeout);
+        try {
+            return await fn(this.#executorFor(lease));
+        }
+        finally {
+            this.#release(lease);
+        }
+    }
+    async withTransaction(fn) {
+        const scope = this.#als.getStore();
+        if (scope)
+            return this.#nestedTransaction(scope, fn);
+        const lease = await this.#acquire(this.#acquireTimeout);
+        const exec = this.#executorFor(lease);
+        try {
+            await lease.conn.execute('BEGIN');
+            const result = await this.#als.run({ exec }, () => fn(exec));
+            await lease.conn.execute('COMMIT');
+            return result;
+        }
+        catch (error) {
+            try {
+                await lease.conn.execute('ROLLBACK');
+            }
+            catch {
+                // rollback-fout onderdrukken; de oorspronkelijke fout is leidend
+            }
+            throw error;
+        }
+        finally {
+            this.#release(lease);
+        }
+    }
+    async #nestedTransaction(scope, fn) {
+        const name = `sp_${++this.#savepointSeq}`;
+        await scope.exec.execute(`SAVEPOINT "${name}"`);
+        try {
+            const result = await fn(scope.exec);
+            await scope.exec.execute(`RELEASE SAVEPOINT "${name}"`);
+            return result;
+        }
+        catch (error) {
+            await scope.exec.execute(`ROLLBACK TO SAVEPOINT "${name}"`);
+            throw error;
+        }
+    }
+    async checkHealth() {
+        const start = performance.now();
+        let lease;
+        try {
+            lease = await this.#acquire(this.#healthTimeout);
+        }
+        catch (error) {
+            const latencyMs = Math.round(performance.now() - start);
+            if (error instanceof PoolTimeoutError) {
+                return { status: 'degraded', latencyMs };
+            }
+            return { status: 'down', latencyMs, error: redactReason(error) };
+        }
+        try {
+            await lease.conn.execute('SELECT 1');
+            return { status: 'healthy', latencyMs: Math.round(performance.now() - start) };
+        }
+        catch (error) {
+            return {
+                status: 'down',
+                latencyMs: Math.round(performance.now() - start),
+                error: redactReason(error),
+            };
+        }
+        finally {
+            this.#release(lease);
+        }
+    }
+    async close() {
+        this.#closed = true;
+        for (const waiter of this.#waiters.splice(0)) {
+            clearTimeout(waiter.timer);
+            waiter.reject(new ConnectionError('Pool is gesloten'));
+        }
+        await Promise.all(this.#leases.map((l) => l.conn.close().catch(() => undefined)));
+        this.#leases.length = 0;
+    }
+    #executorFor(lease) {
+        return { execute: (sql, params) => lease.conn.execute(sql, params) };
+    }
+    async #acquire(timeoutMs) {
+        if (this.#closed)
+            throw new ConnectionError('Pool is gesloten');
+        const idle = this.#leases.find((l) => !l.inUse);
+        if (idle) {
+            idle.inUse = true;
+            return idle;
+        }
+        if (this.#leases.length < this.#max) {
+            const conn = await this.#driver.create();
+            const lease = { conn, inUse: true };
+            this.#leases.push(lease);
+            return lease;
+        }
+        // Verzadigd: wacht tot een verbinding vrijkomt, of timeout (-> degraded in health).
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const idx = this.#waiters.findIndex((w) => w.timer === timer);
+                if (idx >= 0)
+                    this.#waiters.splice(idx, 1);
+                reject(new PoolTimeoutError());
+            }, timeoutMs);
+            this.#waiters.push({ resolve, reject, timer });
+        });
+    }
+    #release(lease) {
+        const waiter = this.#waiters.shift();
+        if (waiter) {
+            clearTimeout(waiter.timer);
+            waiter.resolve(lease); // blijft inUse voor de volgende wachter
+            return;
+        }
+        lease.inUse = false;
+    }
+}
+/** Maakt een beheerde connectie-pool over een {@link Driver}-adapter. */
+export function createPool(driver, config = {}) {
+    return new ConnectionPool(driver, config);
+}
+//# sourceMappingURL=pool.js.map

package/dist/backend/persistence/core/pool.js.map

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

package/dist/backend/persistence/core/ports.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Poorten & types voor de persistence-kit. Het consumerende project injecteert een driver-adapter,
+ * connectie-config, migraties en entity-mappings; de kit bevat geen domeinkennis of tabelnamen.
+ */
+export type Row = Record<string, unknown>;
+export interface QueryResult<R extends Row = Row> {
+    rows: R[];
+    rowCount: number;
+}
+/** Een fysieke databaseverbinding zoals een driver-adapter die levert. */
+export interface DriverConnection {
+    execute<R extends Row = Row>(sql: string, params?: readonly unknown[]): Promise<QueryResult<R>>;
+    close(): Promise<void>;
+}
+/**
+ * Driver-poort (US-0301 AC4). De pool leent hier fysieke verbindingen. Adapters: `pgDriver` (echte
+ * Postgres) en `inMemoryDriver` (dep-vrij, voor tests en consumer-tests).
+ */
+export interface Driver {
+    /** Maak een nieuwe fysieke verbinding. Gooit bij een onbereikbare database. */
+    create(): Promise<DriverConnection>;
+}
+export interface PoolConfig {
+    /** Maximum aantal verbindingen. Default 10. */
+    max?: number;
+    /** Timeout (ms) voor het lenen van een verbinding bij verzadiging. Default 5000. */
+    acquireTimeoutMs?: number;
+    /** Timeout (ms) voor de health-probe bij verzadiging. Default 1000. */
+    healthTimeoutMs?: number;
+}
+export type HealthState = 'healthy' | 'degraded' | 'down';
+export interface HealthResult {
+    status: HealthState;
+    latencyMs: number;
+    /** Geredigeerde reden bij `down` (nooit een wachtwoord). */
+    error?: string;
+}
+/** Uitvoerder van SQL binnen de actieve context (pool-verbinding of transactie). */
+export interface Executor {
+    execute<R extends Row = Row>(sql: string, params?: readonly unknown[]): Promise<QueryResult<R>>;
+}
+/** Beheerde connectie-pool (US-0301/US-0302). */
+export interface Pool extends Executor {
+    /** Valideer de verbinding fail-fast bij opstart. */
+    init(): Promise<void>;
+    checkHealth(): Promise<HealthResult>;
+    /** Voer `fn` uit met een geleende verbinding (auto-released). */
+    withConnection<T>(fn: (executor: Executor) => Promise<T>): Promise<T>;
+    /** Voer `fn` atomair uit in een transactie; nesting gebruikt savepoints (US-0302). */
+    withTransaction<T>(fn: (executor: Executor) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    readonly stats: PoolStats;
+}
+export interface PoolStats {
+    total: number;
+    idle: number;
+    inUse: number;
+}
+export interface MigrationContext {
+    execute<R extends Row = Row>(sql: string, params?: readonly unknown[]): Promise<QueryResult<R>>;
+}
+export interface Migration {
+    /** Stabiele volgorde-sleutel, bv. `0001_init`. */
+    id: string;
+    up(ctx: MigrationContext): Promise<void>;
+    down(ctx: MigrationContext): Promise<void>;
+}
+export interface MigrationStatus {
+    applied: string[];
+    pending: string[];
+}
+export interface EntityMapping<T extends Row> {
+    /** Tabelnaam (geïnjecteerd; geen tabelnaam in de kit zelf). */
+    table: string;
+    /** Naam van de identifier-kolom. Default `id`. */
+    idColumn?: string;
+    /** Persisteerbare kolommen. */
+    columns: (keyof T & string)[];
+    /** Id-generator wanneer een insert geen identifier meelevert. */
+    generateId?: () => unknown;
+}
+export interface FindOptions<T extends Row> {
+    filter?: Partial<Record<keyof T & string, unknown>>;
+    limit?: number;
+    offset?: number;
+    sort?: {
+        field: keyof T & string;
+        direction: 'asc' | 'desc';
+    }[];
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/backend/persistence/core/ports.d.ts.map

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

package/dist/backend/persistence/core/ports.js

@@ -0,0 +1,6 @@
+/**
+ * Poorten & types voor de persistence-kit. Het consumerende project injecteert een driver-adapter,
+ * connectie-config, migraties en entity-mappings; de kit bevat geen domeinkennis of tabelnamen.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/backend/persistence/core/ports.js.map

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

package/dist/backend/persistence/core/repository.d.ts

@@ -0,0 +1,18 @@
+import type { EntityMapping, FindOptions, Pool, Row } from './ports.js';
+export declare class BaseRepository<T extends Row, ID = unknown> {
+    #private;
+    constructor(pool: Pool, mapping: EntityMapping<T>);
+    insert(entity: Partial<T>): Promise<T>;
+    findById(id: ID): Promise<T | null>;
+    findOne(filter: FindOptions<T>['filter']): Promise<T | null>;
+    find(options?: FindOptions<T>): Promise<T[]>;
+    count(filter?: FindOptions<T>['filter']): Promise<number>;
+    /** Combineert `find` + `count` voor een pagina met totaalaantal (US-0304 AC2). */
+    page(options?: FindOptions<T>): Promise<{
+        data: T[];
+        total: number;
+    }>;
+    update(id: ID, patch: Partial<T>): Promise<T | null>;
+    delete(id: ID): Promise<boolean>;
+}
+//# sourceMappingURL=repository.d.ts.map