pipework 0.8.6 → 0.8.8

package/dist/surface/types.d.ts

@@ -0,0 +1,111 @@
+import type { Handler } from '../di/types.js';
+import type { Resource } from '../fixture/types.js';
+import type { ServerConfig } from '../http/types.js';
+import type { QueueConfig, BackoffConfig } from '../jobs/queue.js';
+export type SurfaceKind = 'http' | 'worker' | 'script';
+export interface SurfaceManifest {
+    readonly databases: readonly string[];
+    readonly jobTypes: readonly string[];
+    readonly dependencies: Readonly<Record<string, string>>;
+}
+export interface SurfaceHandle {
+    readonly kind: SurfaceKind;
+    readonly address?: string;
+    stop(): Promise<void>;
+}
+export interface Surface {
+    readonly kind: SurfaceKind;
+    readonly manifest: SurfaceManifest;
+    start(context: SurfaceContext): Promise<SurfaceHandle>;
+}
+export interface SurfaceBuilder extends Surface {
+    dependencies(d: Record<string, string>): SurfaceBuilder;
+}
+export interface SurfaceContext {
+    readonly config: {
+        readonly environment: string;
+        database(name?: string): {
+            readonly name: string;
+            readonly url: string;
+        };
+        databases(): ReadonlyMap<string, {
+            readonly name: string;
+        }>;
+        databaseNames(): readonly string[];
+        defaultDatabaseName(): string;
+        readonly observability: {
+            readonly slowQueryMs: number;
+            readonly logAllQueries: boolean;
+            readonly poolMetricsInterval: number;
+        };
+        readonly raw: unknown;
+    };
+    readonly env: Readonly<Record<string, unknown>>;
+    readonly pool: {
+        getOrCreate(config: {
+            readonly name: string;
+            readonly url: string;
+        }): {
+            readonly drizzle: import('../db/index.js').DB;
+            close(): Promise<void>;
+        };
+        get(name: string): {
+            readonly drizzle: import('../db/index.js').DB;
+            close(): Promise<void>;
+        } | undefined;
+        closeAll(): Promise<void>;
+        count(): number;
+    };
+    readonly isolation: {
+        markBegin(): void;
+        markEnd(): void;
+        assertClean(): void;
+    };
+    readonly connections: {
+        track(id: string, name: string, context: string): void;
+        release(id: string): void;
+        activeCount(): number;
+    };
+}
+export interface HttpSurfaceConfig {
+    readonly handlers?: readonly Handler<Record<string, unknown>, unknown>[];
+    readonly resources?: readonly Resource<unknown>[];
+    readonly port?: number;
+    readonly host?: string;
+    readonly auth?: ServerConfig['auth'];
+    readonly tenant?: ServerConfig['tenant'];
+    readonly cors?: ServerConfig['cors'];
+    readonly security?: ServerConfig['security'];
+    readonly rateLimit?: ServerConfig['rateLimit'];
+    readonly openapi?: ServerConfig['openapi'];
+    readonly rbac?: ServerConfig['rbac'];
+    readonly transactionPerRequest?: ServerConfig['transactionPerRequest'];
+    readonly transactionTimeoutMs?: ServerConfig['transactionTimeoutMs'];
+    readonly healthChecks?: ServerConfig['healthChecks'];
+    readonly logging?: ServerConfig['logging'];
+    readonly logger?: ServerConfig['logger'];
+    readonly trustProxy?: ServerConfig['trustProxy'];
+    readonly gracefulShutdownMs?: number;
+}
+export interface RetryConfig {
+    readonly attempts: number;
+    readonly backoff?: BackoffConfig;
+}
+export interface WorkerSurfaceConfig {
+    readonly jobs: readonly Handler<Record<string, unknown>, unknown>[];
+    readonly database?: string;
+    readonly concurrency?: number;
+    readonly pollIntervalMs?: number;
+    readonly queue?: QueueConfig;
+}
+export interface ScriptSurfaceConfig {
+    readonly databases?: readonly string[];
+    readonly run: (context: ScriptContext) => Promise<void>;
+}
+export interface ScriptContext {
+    readonly config: SurfaceContext['config'];
+    readonly env: SurfaceContext['env'];
+    readonly pool: SurfaceContext['pool'];
+}
+export type SurfaceMap = Record<string, Surface>;
+//# sourceMappingURL=types.d.ts.map

package/dist/surface/types.d.ts.map

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

package/dist/surface/types.js

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

package/dist/surface/types.js.map

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

package/dist/surface/validate.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedConfig } from '../config/load.js';
+import type { SurfaceMap } from './types.js';
+import type { ValidationIssue } from '../validation/types.js';
+export declare function validateSurfaces(config: ResolvedConfig, surfaces: SurfaceMap): void;
+export declare function collectSurfaceIssues(surfaces: SurfaceMap, configuredDatabases: readonly string[], defaultDbAvailable: boolean): ValidationIssue[];
+export declare function validateNoJobTypeDuplicates(surfaces: SurfaceMap): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/surface/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/surface/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,YAAY,CAAA;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAoCnF;AAwBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EACpB,mBAAmB,EAAE,SAAS,MAAM,EAAE,EACtC,kBAAkB,EAAE,OAAO,GAC1B,eAAe,EAAE,CAwDnB;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAuBtE"}

package/dist/surface/validate.js

@@ -0,0 +1,121 @@
+import { DEFAULT_DB } from '../di/types.js';
+export function validateSurfaces(config, surfaces) {
+    const problems = [];
+    const configuredDbs = new Set(config.databaseNames());
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const db of surface.manifest.databases) {
+            if (db === DEFAULT_DB) {
+                if (configuredDbs.size > 1) {
+                    try {
+                        config.defaultDatabaseName();
+                    }
+                    catch {
+                        problems.push(`Surface "${name}" uses the default database, but multiple databases are configured.\n` +
+                            `    Configured: ${[...configuredDbs].join(', ')}\n` +
+                            `    Fix: Pass an explicit database name — e.g., surface.worker({ database: "${[...configuredDbs][0]}" })`);
+                    }
+                }
+            }
+            else if (!configuredDbs.has(db)) {
+                const available = [...configuredDbs].join(', ');
+                problems.push(`Surface "${name}" requires database "${db}" which is not configured.\n` +
+                    `    Configured databases: ${available || '(none)'}\n` +
+                    `    Fix: Add "${db}" to your databases config, or correct the name in the surface definition.`);
+            }
+        }
+        validateSurfaceKind(name, surface, problems);
+    }
+    if (problems.length > 0) {
+        throw new Error(`[pipework] Surface validation failed:\n\n${problems.map((p, i) => `  ${i + 1}. ${p}`).join('\n\n')}\n`);
+    }
+}
+function validateSurfaceKind(name, surface, problems) {
+    if (surface.kind === 'worker') {
+        if (surface.manifest.jobTypes.length === 0) {
+            problems.push(`Surface "${name}" is a worker with no job handlers.\n` +
+                '    Fix: Pass at least one job handler — surface.worker({ jobs: [myJob] })');
+        }
+        const seen = new Set();
+        for (const jobType of surface.manifest.jobTypes) {
+            if (seen.has(jobType)) {
+                problems.push(`Surface "${name}" has duplicate job type "${jobType}".\n` +
+                    '    Each job type must have exactly one handler.');
+            }
+            seen.add(jobType);
+        }
+    }
+}
+export function collectSurfaceIssues(surfaces, configuredDatabases, defaultDbAvailable) {
+    const issues = [];
+    const dbSet = new Set(configuredDatabases);
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const db of surface.manifest.databases) {
+            if (db === DEFAULT_DB) {
+                if (!defaultDbAvailable) {
+                    issues.push({
+                        phase: 'surface',
+                        message: `"${name}" uses the default database, but multiple databases are configured: ${configuredDatabases.join(', ')}`,
+                    });
+                }
+            }
+            else if (!dbSet.has(db)) {
+                issues.push({
+                    phase: 'surface',
+                    message: `"${name}" requires database "${db}" which is not configured (available: ${configuredDatabases.join(', ')})`,
+                });
+            }
+        }
+        if (surface.kind === 'worker' && surface.manifest.jobTypes.length === 0) {
+            issues.push({
+                phase: 'surface',
+                message: `"${name}" is a worker with no job handlers`,
+            });
+        }
+        const seen = new Set();
+        for (const jobType of surface.manifest.jobTypes) {
+            if (seen.has(jobType)) {
+                issues.push({
+                    phase: 'surface',
+                    message: `"${name}" has duplicate job type "${jobType}"`,
+                });
+            }
+            seen.add(jobType);
+        }
+    }
+    const jobOwners = new Map();
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const jobType of surface.manifest.jobTypes) {
+            const existing = jobOwners.get(jobType);
+            if (existing !== undefined) {
+                issues.push({
+                    phase: 'surface',
+                    message: `job type "${jobType}" handled by both "${existing}" and "${name}"`,
+                });
+            }
+            else {
+                jobOwners.set(jobType, name);
+            }
+        }
+    }
+    return issues;
+}
+export function validateNoJobTypeDuplicates(surfaces) {
+    const owners = new Map();
+    const problems = [];
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const jobType of surface.manifest.jobTypes) {
+            const existing = owners.get(jobType);
+            if (existing !== undefined) {
+                problems.push(`Job type "${jobType}" is handled by both "${existing}" and "${name}".\n` +
+                    '    Each job type must be handled by exactly one worker surface.');
+            }
+            else {
+                owners.set(jobType, name);
+            }
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`[pipework] Job type conflict:\n\n${problems.map((p, i) => `  ${i + 1}. ${p}`).join('\n\n')}\n`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/surface/validate.js.map

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

package/dist/surface/worker.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceBuilder, WorkerSurfaceConfig } from './types.js';
+export declare function createWorkerSurface(config: WorkerSurfaceConfig): SurfaceBuilder;
+//# sourceMappingURL=worker.d.ts.map

package/dist/surface/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/surface/worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAiB,mBAAmB,EAAkB,MAAM,YAAY,CAAA;AAQpG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CA8F/E"}

package/dist/surface/worker.js

@@ -0,0 +1,151 @@
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_DB } from '../di/types.js';
+import { createQueue } from '../jobs/queue.js';
+import { executeJob } from '../jobs/execute.js';
+import { sql } from '../db/sql.js';
+export function createWorkerSurface(config) {
+    const databases = collectWorkerDatabases(config);
+    const jobTypes = collectJobTypes(config.jobs);
+    validateJobHandlers(config.jobs);
+    const deps = {};
+    const surface = {
+        kind: 'worker',
+        manifest: { databases, jobTypes, dependencies: deps },
+        dependencies(d) {
+            Object.assign(deps, d);
+            return surface;
+        },
+        async start(context) {
+            const queue = createQueue(config.queue);
+            const dbName = config.database ?? context.config.defaultDatabaseName();
+            const dbConfig = context.config.database(dbName);
+            const conn = context.pool.getOrCreate(dbConfig);
+            const db = conn.drizzle;
+            await db.execute(sql `SELECT 1`);
+            const dispatch = buildDispatchTable(config.jobs);
+            const concurrency = config.concurrency ?? 1;
+            const pollIntervalMs = config.pollIntervalMs ?? 1000;
+            const shouldRun = { value: true };
+            const claimLoop = async () => {
+                const workerId = randomUUID();
+                while (shouldRun.value) {
+                    try {
+                        const claimed = await queue.claim(db, workerId);
+                        if (claimed === null) {
+                            await sleep(pollIntervalMs);
+                            continue;
+                        }
+                        const handler = dispatch.get(claimed.type);
+                        if (handler === undefined) {
+                            await queue.fail(db, claimed.id, new Error(`[pipework] No handler registered for job type "${claimed.type}".\n\n` +
+                                `  Registered types: ${[...dispatch.keys()].join(', ')}\n` +
+                                '  This job was enqueued with a type that no handler recognizes.\n'));
+                            continue;
+                        }
+                        const heartbeatInterval = setInterval(() => {
+                            void queue.heartbeat(db, claimed.id);
+                        }, 30_000);
+                        try {
+                            const timeoutMs = handler.meta.jobTimeout ?? undefined;
+                            const result = await executeWithTimeout(() => executeJob(handler, {
+                                instance: context,
+                                jobId: claimed.id,
+                                jobType: claimed.type,
+                                input: claimed.payload,
+                            }), timeoutMs, claimed.type, claimed.id);
+                            await queue.complete(db, claimed.id, result);
+                        }
+                        catch (err) {
+                            await queue.fail(db, claimed.id, err);
+                        }
+                        finally {
+                            clearInterval(heartbeatInterval);
+                        }
+                    }
+                    catch {
+                        await sleep(pollIntervalMs);
+                    }
+                }
+            };
+            const workers = Array.from({ length: concurrency }, () => claimLoop());
+            return {
+                kind: 'worker',
+                async stop() {
+                    shouldRun.value = false;
+                    await Promise.allSettled(workers);
+                },
+            };
+        },
+    };
+    return surface;
+}
+function buildDispatchTable(jobs) {
+    const table = new Map();
+    for (const job of jobs) {
+        const jobType = job.meta.jobType;
+        if (typeof jobType === 'string') {
+            table.set(jobType, job);
+        }
+    }
+    return table;
+}
+function validateJobHandlers(jobs) {
+    const seen = new Set();
+    for (const job of jobs) {
+        if (!job.meta.isJob || job.meta.jobType === null) {
+            throw new Error('[pipework] All handlers passed to surface.worker({ jobs }) must be created with .job("type-name").\n\n' +
+                '  Example:\n' +
+                '    fitting().use().job("send-email").input(schema).fit(handler)\n');
+        }
+        if (seen.has(job.meta.jobType)) {
+            throw new Error(`[pipework] Duplicate job type "${job.meta.jobType}" in worker surface.\n\n` +
+                '  Each job type must have exactly one handler. If you need multiple handlers,\n' +
+                '  create separate worker surfaces.\n');
+        }
+        seen.add(job.meta.jobType);
+    }
+}
+function collectWorkerDatabases(config) {
+    const dbs = new Set();
+    if (config.database !== undefined) {
+        dbs.add(config.database);
+    }
+    else {
+        dbs.add(DEFAULT_DB);
+    }
+    for (const job of config.jobs) {
+        for (const db of job.meta.databases) {
+            dbs.add(db);
+        }
+    }
+    return [...dbs];
+}
+function collectJobTypes(jobs) {
+    const types = [];
+    for (const j of jobs) {
+        if (typeof j.meta.jobType === 'string') {
+            types.push(j.meta.jobType);
+        }
+    }
+    return types;
+}
+async function executeWithTimeout(fn, timeoutMs, jobType, jobId) {
+    if (timeoutMs === undefined)
+        return fn();
+    const result = await Promise.race([
+        fn(),
+        new Promise((_, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`[pipework] Job "${jobType}" (${jobId}) timed out after ${timeoutMs}ms.\n\n` +
+                    '  The job handler did not complete within the configured timeout.\n' +
+                    '  Increase the timeout with .timeout(ms) or optimize the handler.\n'));
+            }, timeoutMs);
+            timer.unref();
+        }),
+    ]);
+    return result;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=worker.js.map

package/dist/surface/worker.js.map

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

package/dist/temporal/close.d.ts

@@ -0,0 +1,3 @@
+import type { TemporalOptions } from './types.js';
+export declare function close(options: TemporalOptions): Promise<number>;
+//# sourceMappingURL=close.d.ts.map

package/dist/temporal/close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../src/temporal/close.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGjD,wBAAsB,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE"}

package/dist/temporal/close.js

@@ -0,0 +1,19 @@
+import { sql } from '../db/sql.js';
+import { getTableName } from '../db/generated/drizzle-orm/introspection.js';
+import { TemporalIntegrityError } from './errors.js';
+export async function close(options) {
+    const { tx, where } = options;
+    const table = typeof options.table === 'string' ? options.table : getTableName(options.table);
+    const rows = await tx.execute(sql `SELECT id FROM ${sql.identifier(table)} WHERE ${where} AND effective_to IS NULL FOR UPDATE`);
+    if (rows.length === 0) {
+        return 0;
+    }
+    if (rows.length > 1) {
+        throw new TemporalIntegrityError(`Multiple open versions detected in "${table}" — data integrity violation. ` +
+            `Expected at most one row with effective_to IS NULL, found ${rows.length}.`, { table, count: rows.length });
+    }
+    const currentId = rows[0]['id'];
+    await tx.execute(sql `UPDATE ${sql.identifier(table)} SET effective_to = now() WHERE id = ${currentId}::uuid`);
+    return 1;
+}
+//# sourceMappingURL=close.js.map

package/dist/temporal/close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../src/temporal/close.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAE3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAwB;IAClD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAE7F,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,GAAG,CAAA,kBAAkB,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,KAAK,sCAAsC,CAChG,CAAA;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,sBAAsB,CAC9B,uCAAuC,KAAK,gCAAgC;YAC5E,6DAA6D,IAAI,CAAC,MAAM,GAAG,EAC3E,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAC9B,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,IAAI,CAAW,CAAA;IAE1C,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,wCAAwC,SAAS,QAAQ,CAC5F,CAAA;IAED,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/temporal/columns.d.ts

@@ -0,0 +1,7 @@
+export declare function temporalColumns(): {
+    effectiveFrom: import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTimestampBuilderInitial<"effective_from">>>;
+    effectiveTo: import("drizzle-orm/pg-core").PgTimestampBuilderInitial<"effective_to">;
+    version: import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgIntegerBuilderInitial<"version">>>;
+    createdBy: import("drizzle-orm/pg-core").PgTextBuilderInitial<"created_by", [string, ...string[]]>;
+};
+//# sourceMappingURL=columns.d.ts.map

package/dist/temporal/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/temporal/columns.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe;;;;;EAO9B"}

package/dist/temporal/columns.js

@@ -0,0 +1,10 @@
+import { timestamp, integer, text } from '../db/col/index.js';
+export function temporalColumns() {
+    return {
+        effectiveFrom: timestamp('effective_from', { withTimezone: true }).notNull().defaultNow(),
+        effectiveTo: timestamp('effective_to', { withTimezone: true }),
+        version: integer('version').notNull().default(1),
+        createdBy: text('created_by'),
+    };
+}
+//# sourceMappingURL=columns.js.map

package/dist/temporal/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../src/temporal/columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE7D,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,aAAa,EAAE,SAAS,CAAC,gBAAgB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;QACzF,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC9D,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;KAC9B,CAAA;AACH,CAAC"}

package/dist/temporal/definition-queries.d.ts

@@ -0,0 +1,14 @@
+import type { DB, SQL } from '../db/types.js';
+import type { DefinedTable, FieldDescriptor } from '../domain/types.js';
+import type { ReviseResult } from './types.js';
+export interface DefinitionReviseOptions<TFields extends Record<string, FieldDescriptor> = Record<string, FieldDescriptor>> {
+    readonly tx: DB;
+    readonly definition: DefinedTable<TFields>;
+    readonly where: SQL;
+    readonly data: Record<string, unknown>;
+    readonly userId?: string;
+}
+export declare function asOf<TFields extends Record<string, FieldDescriptor>>(db: DB, definition: DefinedTable<TFields>, date: Date, where?: SQL): Promise<Record<string, unknown>[]>;
+export declare function allVersions<TFields extends Record<string, FieldDescriptor>>(db: DB, definition: DefinedTable<TFields>, where?: SQL): Promise<Record<string, unknown>[]>;
+export declare function effectiveUpdate<TFields extends Record<string, FieldDescriptor>>(options: DefinitionReviseOptions<TFields>): Promise<ReviseResult>;
+//# sourceMappingURL=definition-queries.d.ts.map

package/dist/temporal/definition-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-queries.d.ts","sourceRoot":"","sources":["../../src/temporal/definition-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAA;AAM7D,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IACxH,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;IACf,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAaD,wBAAsB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACxE,EAAE,EAAE,EAAE,EACN,UAAU,EAAE,YAAY,CAAC,OAAO,CAAC,EACjC,IAAI,EAAE,IAAI,EACV,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAQpC;AAED,wBAAsB,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC/E,EAAE,EAAE,EAAE,EACN,UAAU,EAAE,YAAY,CAAC,OAAO,CAAC,EACjC,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CASpC;AAED,wBAAsB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAYvJ"}

package/dist/temporal/definition-queries.js

@@ -0,0 +1,45 @@
+import { atTime } from './query.js';
+import { revise } from './revise.js';
+import { TemporalIntegrityError } from './errors.js';
+import { and } from '../db/generated/drizzle-orm/operator.js';
+function requireEffectiveDated(definition, fnName) {
+    if (!definition.$traits.includes('effectiveDated')) {
+        throw new TemporalIntegrityError(`temporal.${fnName}() requires an effective-dated definition.\n\n` +
+            `  "${definition.$name}" does not have the .effectiveDated() trait.\n\n` +
+            `  Add .effectiveDated() to your definition:\n` +
+            `    pipe.define('${definition.$name}', { ... }).effectiveDated()\n`);
+    }
+}
+export async function asOf(db, definition, date, where) {
+    requireEffectiveDated(definition, 'asOf');
+    const table = definition.table();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- atTime expects column accessors typed by HasTemporalColumns
+    const temporal = atTime(table, date);
+    const condition = where !== undefined ? and(temporal, where) : temporal;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle select chain requires concrete table generics
+    return await db.select().from(table).where(condition);
+}
+export async function allVersions(db, definition, where) {
+    requireEffectiveDated(definition, 'allVersions');
+    const table = definition.table();
+    if (where !== undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle select chain requires concrete table generics
+        return await db.select().from(table).where(where);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle select chain requires concrete table generics
+    return await db.select().from(table);
+}
+export async function effectiveUpdate(options) {
+    requireEffectiveDated(options.definition, 'effectiveUpdate');
+    const reviseOptions = {
+        tx: options.tx,
+        table: options.definition.$name,
+        where: options.where,
+        data: options.data,
+    };
+    if (options.userId !== undefined) {
+        return revise({ ...reviseOptions, userId: options.userId });
+    }
+    return revise(reviseOptions);
+}
+//# sourceMappingURL=definition-queries.js.map

package/dist/temporal/definition-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-queries.js","sourceRoot":"","sources":["../../src/temporal/definition-queries.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAA;AAU7D,SAAS,qBAAqB,CAAkD,UAAiC,EAAE,MAAc;IAC/H,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,sBAAsB,CAC9B,YAAY,MAAM,gDAAgD;YAClE,MAAM,UAAU,CAAC,KAAK,kDAAkD;YACxE,+CAA+C;YAC/C,oBAAoB,UAAU,CAAC,KAAK,gCAAgC,CACrE,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,EAAM,EACN,UAAiC,EACjC,IAAU,EACV,KAAW;IAEX,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,CAAA;IAChC,6HAA6H;IAC7H,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAY,EAAE,IAAI,CAAC,CAAA;IAC3C,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IACvE,uHAAuH;IACvH,OAAO,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAM,EACN,UAAiC,EACjC,KAAW;IAEX,qBAAqB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,CAAA;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,uHAAuH;QACvH,OAAO,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5D,CAAC;IACD,uHAAuH;IACvH,OAAO,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAkD,OAAyC;IAC9H,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA;IAC5D,MAAM,aAAa,GAAkB;QACnC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK;QAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,EAAE,GAAG,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC,aAAa,CAAC,CAAA;AAC9B,CAAC"}

package/dist/temporal/errors.d.ts

@@ -0,0 +1,7 @@
+import { PipeworkError } from '../errors/base.js';
+export declare class TemporalIntegrityError extends PipeworkError {
+    readonly code: "TEMPORAL_INTEGRITY";
+    readonly httpStatus: 409;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/temporal/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/temporal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAS;IAC7C,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAGnE"}

package/dist/temporal/errors.js

@@ -0,0 +1,9 @@
+import { PipeworkError } from '../errors/base.js';
+export class TemporalIntegrityError extends PipeworkError {
+    code = 'TEMPORAL_INTEGRITY';
+    httpStatus = 409;
+    constructor(message, details = {}) {
+        super(message, details);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/temporal/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/temporal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAC9C,IAAI,GAAG,oBAA6B,CAAA;IACpC,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/temporal/get-current.d.ts

@@ -0,0 +1,3 @@
+import type { TemporalOptions, GetCurrentResult } from './types.js';
+export declare function getCurrent(options: TemporalOptions): Promise<GetCurrentResult | null>;
+//# sourceMappingURL=get-current.d.ts.map

package/dist/temporal/get-current.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current.d.ts","sourceRoot":"","sources":["../../src/temporal/get-current.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGnE,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsB3F"}

package/dist/temporal/get-current.js

@@ -0,0 +1,18 @@
+import { sql } from '../db/sql.js';
+import { getTableName } from '../db/generated/drizzle-orm/introspection.js';
+import { TemporalIntegrityError } from './errors.js';
+export async function getCurrent(options) {
+    const { tx, where } = options;
+    const table = typeof options.table === 'string' ? options.table : getTableName(options.table);
+    const rows = await tx.execute(sql `SELECT id::text, version FROM ${sql.identifier(table)} WHERE ${where} AND effective_to IS NULL`);
+    if (rows.length === 0) {
+        return null;
+    }
+    if (rows.length > 1) {
+        throw new TemporalIntegrityError(`Multiple open versions detected in "${table}" — data integrity violation. ` +
+            `Expected at most one row with effective_to IS NULL, found ${rows.length}.`, { table, count: rows.length });
+    }
+    const row = rows[0];
+    return { id: row['id'], version: row['version'] };
+}
+//# sourceMappingURL=get-current.js.map