webapp-factory 0.1.0

package/dist/persistence/adapters/pg-driver.js

@@ -0,0 +1,42 @@
+/**
+ * Echte Postgres-{@link Driver} bovenop `node-postgres` (`pg`). Verbindingsparameters komen via
+ * config-injectie binnen; secrets worden nooit gelogd. `pg` is een optionele peer-dependency.
+ */
+import { Client } from 'pg';
+class PgConnection {
+    #client;
+    constructor(client) {
+        this.#client = client;
+    }
+    async execute(sql, params = []) {
+        const result = await this.#client.query(sql, params);
+        return { rows: result.rows, rowCount: result.rowCount ?? result.rows.length };
+    }
+    async close() {
+        await this.#client.end();
+    }
+}
+/** Maakt een Postgres-driver; elke `create()` opent een nieuwe fysieke verbinding. */
+export function pgDriver(config) {
+    const clientConfig = {
+        host: config.host,
+        port: config.port ?? 5432,
+        database: config.database,
+        user: config.user,
+    };
+    if (config.password !== undefined)
+        clientConfig.password = config.password;
+    if (config.ssl !== undefined)
+        clientConfig.ssl = config.ssl;
+    if (config.connectionTimeoutMs !== undefined) {
+        clientConfig.connectionTimeoutMillis = config.connectionTimeoutMs;
+    }
+    return {
+        create: async () => {
+            const client = new Client(clientConfig);
+            await client.connect();
+            return new PgConnection(client);
+        },
+    };
+}
+//# sourceMappingURL=pg-driver.js.map

package/dist/persistence/adapters/pg-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-driver.js","sourceRoot":"","sources":["../../../src/persistence/adapters/pg-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAqB,MAAM,IAAI,CAAC;AAgB/C,MAAM,YAAY;IACP,OAAO,CAAS;IACzB,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,OAAO,CACX,GAAW,EACX,SAA6B,EAAE;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,MAAmB,CAAC,CAAC;QAClE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvF,CAAC;IACD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CAAC,MAA0B;IACjD,MAAM,YAAY,GAAiB;QACjC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,YAAY,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3E,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,YAAY,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAC5D,IAAI,MAAM,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC7C,YAAY,CAAC,uBAAuB,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACpE,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,IAA+B,EAAE;YAC5C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;YACxC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/persistence/adapters/testcontainer-harness.d.ts

@@ -0,0 +1,37 @@
+import type { Driver, Migration, Pool, PoolConfig } from '../core/ports.js';
+import { type PgConnectionConfig } from './pg-driver.js';
+export interface StartedDatabase {
+    driver: Driver;
+    connection?: PgConnectionConfig;
+    stop(): Promise<void>;
+}
+export interface ContainerFactory {
+    start(): Promise<StartedDatabase>;
+}
+export interface TestDatabaseOptions {
+    migrations: Migration[];
+    /** Tabellen die de reset-helper leegmaakt (exclusief de ledger). */
+    managedTables?: string[];
+    poolConfig?: PoolConfig;
+    ledgerTable?: string;
+    /** Injecteerbare factory; default een echte Postgres-testcontainer. */
+    containerFactory?: ContainerFactory;
+}
+export interface TestDatabase {
+    pool: Pool;
+    /** Leegt de beheerde tabellen tussen tests (US-0305 AC2). */
+    reset(): Promise<void>;
+    /** Stopt de pool en ruimt de container op (US-0305 AC3). */
+    stop(): Promise<void>;
+}
+/** Start een wegwerp-database, past migraties toe en levert een {@link TestDatabase}. */
+export declare function startTestDatabase(options: TestDatabaseOptions): Promise<TestDatabase>;
+export interface PostgresContainerOptions {
+    image?: string;
+    database?: string;
+    user?: string;
+    password?: string;
+}
+/** Echte Postgres-testcontainer-factory (vereist een Docker-runtime). */
+export declare function postgresContainerFactory(options?: PostgresContainerOptions): ContainerFactory;
+//# sourceMappingURL=testcontainer-harness.d.ts.map

package/dist/persistence/adapters/testcontainer-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcontainer-harness.d.ts","sourceRoot":"","sources":["../../../src/persistence/adapters/testcontainer-harness.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAY,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,6DAA6D;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,4DAA4D;IAC5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,yFAAyF;AACzF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8B3F;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,gBAAgB,CA8CjG"}

package/dist/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/persistence/adapters/testcontainer-harness.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../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/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/persistence/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../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/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/persistence/core/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../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/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/persistence/core/migrations.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../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/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/persistence/core/pool.js.map

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