pipework 0.8.6 → 0.8.8

package/dist/http/types.d.ts

@@ -0,0 +1,130 @@
+import type { AuthStrategy } from '../auth/types.js';
+import type { AuthEnricher, TenantResolver } from '../auth/chain.js';
+import type { Handler, HttpMethod } from '../di/types.js';
+import type { HealthCheck } from '../lifecycle/types.js';
+import type { TenantConfig } from '../tenant/types.js';
+import type { Rbac } from '../rbac/types.js';
+import type { OpenAPIInfo } from '../openapi/generate.js';
+import type { LoggingConfig } from '../logging/types.js';
+import type { PipeworkLogger } from '../logging/types.js';
+/** Fastify request with pipework extensions — req.id (UUID), typed headers. */
+export interface HttpRequest {
+    readonly headers: Readonly<Record<string, string | undefined>>;
+    readonly rawBody?: Buffer;
+}
+/** Fastify reply with pipework extensions. */
+export interface HttpResponse {
+    header(name: string, value: string): void;
+}
+/** CORS configuration — origin, methods, headers, credentials, maxAge. */
+export interface CorsConfig {
+    origin?: string | string[] | boolean | RegExp | ((origin: string) => boolean);
+    methods?: string[];
+    allowedHeaders?: string[];
+    exposedHeaders?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
+/** Security header configuration — passed to @fastify/helmet. */
+export interface SecurityConfig {
+    contentSecurityPolicy?: boolean | Record<string, string[]>;
+    crossOriginEmbedderPolicy?: boolean;
+    crossOriginOpenerPolicy?: boolean | {
+        policy: string;
+    };
+    crossOriginResourcePolicy?: boolean | {
+        policy: string;
+    };
+    dnsPrefetchControl?: boolean;
+    frameguard?: boolean | {
+        action: string;
+    };
+    hidePoweredBy?: boolean;
+    hsts?: boolean | {
+        maxAge: number;
+        includeSubDomains?: boolean;
+    };
+    ieNoOpen?: boolean;
+    noSniff?: boolean;
+    referrerPolicy?: boolean | {
+        policy: string;
+    };
+    xssFilter?: boolean;
+}
+/** Rate limiting configuration — max requests, time window, key generator. */
+export interface RateLimitConfig {
+    max?: number;
+    timeWindow?: string | number;
+    keyGenerator?: (request: HttpRequest) => string;
+    allowList?: string[];
+    ban?: number;
+}
+/** Options for server.inject() — method, url, headers, payload for testing without HTTP. */
+export interface InjectOptions {
+    method: string;
+    url: string;
+    headers?: Record<string, string | string[] | undefined>;
+    payload?: unknown;
+    query?: Record<string, string | string[]>;
+}
+/** Response from server.inject() — statusCode, headers, body, json() helper. */
+export interface InjectResponse {
+    statusCode: number;
+    headers: Record<string, string | number | string[] | undefined>;
+    body: string;
+    json(): unknown;
+}
+/** Configuration for http.createServer() — CORS, security headers, rate limiting, transaction timeout. */
+export interface ServerConfig {
+    port?: number;
+    host?: string;
+    gracefulShutdownMs?: number;
+    trustProxy?: boolean;
+    logger?: PipeworkLogger | false;
+    health?: boolean;
+    healthPath?: string;
+    readyPath?: string;
+    healthChecks?: HealthCheck[];
+    transactionPerRequest?: boolean | string[];
+    transactionTimeoutMs?: number;
+    auth?: ServerAuthConfig;
+    tenant?: TenantConfig | null;
+    rbac?: Rbac;
+    cors?: CorsConfig | false;
+    security?: SecurityConfig | false;
+    rateLimit?: RateLimitConfig | false;
+    openapi?: OpenAPIInfo;
+    openApiPath?: string;
+    logging?: LoggingConfig;
+    managed?: boolean;
+}
+/** Server-level auth configuration — strategy, session config, optional enricher. */
+export type ServerAuthConfig = {
+    strategy: AuthStrategy<unknown>;
+    optional?: boolean;
+} | {
+    strategies: AuthStrategy<unknown>[];
+    enrichers?: AuthEnricher<unknown>[];
+    tenantResolver?: TenantResolver<unknown>;
+    optional?: boolean;
+};
+/** Internal route registration record — used by OpenAPI generation to discover routes. */
+export interface RouteRegistration {
+    method: HttpMethod;
+    path: string;
+    handler: Handler<Record<string, unknown>, unknown>;
+}
+/** Standard handler response shape — statusCode, headers, body. */
+export interface HandlerResponse {
+    readonly status: number;
+    readonly body?: unknown;
+}
+/** Standard error response shape — { error: { code, message }, statusCode }. */
+export interface ErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        fields?: Record<string, readonly string[]>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/http/types.js

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

package/dist/http/types.js.map

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

package/dist/idempotency/index.d.ts

@@ -0,0 +1,4 @@
+export { createIdempotency, type IdempotencyMiddleware } from './middleware.js';
+export { createStore } from './store.js';
+export type { IdempotencyConfig, IdempotencyRecord, IdempotencyStore } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/idempotency/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/idempotency/index.js

@@ -0,0 +1,3 @@
+export { createIdempotency } from './middleware.js';
+export { createStore } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/idempotency/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/idempotency/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA8B,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/idempotency/middleware.d.ts

@@ -0,0 +1,21 @@
+import type { IdempotencyConfig, IdempotencyStore } from './types.js';
+import type { DB } from '../db/index.js';
+import type { Manifold } from '../pipework.js';
+export interface IdempotencyMiddleware {
+    readonly store: IdempotencyStore;
+    readonly config: Required<IdempotencyConfig>;
+    check(db: DB, tenantId: string, key: string, method: string, path: string): Promise<{
+        status: 'new';
+    } | {
+        status: 'locked';
+    } | {
+        status: 'completed';
+        statusCode: number;
+        body: unknown;
+    }>;
+    complete(db: DB, tenantId: string, key: string, statusCode: number, body: unknown): Promise<void>;
+    fail(db: DB, tenantId: string, key: string): Promise<void>;
+    cleanup(db: DB): Promise<number>;
+}
+export declare function createIdempotency(instance: Manifold, config: IdempotencyConfig): IdempotencyMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/idempotency/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/idempotency/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAG9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAE5C,KAAK,CACH,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAEjH,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACjC;AAUD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAwDtG"}

package/dist/idempotency/middleware.js

@@ -0,0 +1,56 @@
+import { createStore } from './store.js';
+const DEFAULTS = {
+    table: '__pipework_idempotency',
+    headerName: 'Idempotency-Key',
+    ttlSeconds: 86400,
+    lockTimeoutMs: 30_000,
+    methods: ['POST', 'PATCH', 'DELETE'],
+};
+export function createIdempotency(instance, config) {
+    const resolved = {
+        database: config.database,
+        table: config.table ?? DEFAULTS.table,
+        headerName: config.headerName ?? DEFAULTS.headerName,
+        ttlSeconds: config.ttlSeconds ?? DEFAULTS.ttlSeconds,
+        lockTimeoutMs: config.lockTimeoutMs ?? DEFAULTS.lockTimeoutMs,
+        methods: config.methods ?? [...DEFAULTS.methods],
+    };
+    const store = createStore(resolved.table);
+    return {
+        store,
+        config: resolved,
+        async check(db, tenantId, key, method, path) {
+            const existing = await store.find(db, tenantId, key);
+            if (existing === null) {
+                const locked = await store.lock(db, tenantId, key, method, path, resolved.lockTimeoutMs);
+                if (!locked) {
+                    return { status: 'locked' };
+                }
+                return { status: 'new' };
+            }
+            if (existing.statusCode !== null) {
+                return { status: 'completed', statusCode: existing.statusCode, body: existing.responseBody };
+            }
+            if (existing.lockedUntil !== null && existing.lockedUntil.getTime() > Date.now()) {
+                return { status: 'locked' };
+            }
+            // Lock expired — re-lock and retry
+            await store.remove(db, tenantId, key);
+            const locked = await store.lock(db, tenantId, key, method, path, resolved.lockTimeoutMs);
+            if (!locked) {
+                return { status: 'locked' };
+            }
+            return { status: 'new' };
+        },
+        async complete(db, tenantId, key, statusCode, body) {
+            await store.complete(db, tenantId, key, statusCode, body);
+        },
+        async fail(db, tenantId, key) {
+            await store.remove(db, tenantId, key);
+        },
+        async cleanup(db) {
+            return store.cleanup(db, resolved.ttlSeconds);
+        },
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/idempotency/middleware.js.map

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

package/dist/idempotency/store.d.ts

@@ -0,0 +1,3 @@
+import type { IdempotencyStore } from './types.js';
+export declare function createStore(table: string): IdempotencyStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/idempotency/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/idempotency/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAA;AAErE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA2E3D"}

package/dist/idempotency/store.js

@@ -0,0 +1,63 @@
+import { sql } from '../db/sql.js';
+export function createStore(table) {
+    return {
+        async ensureTable(db) {
+            await db.execute(sql.raw(`
+        CREATE TABLE IF NOT EXISTS ${table} (
+          key TEXT NOT NULL,
+          tenant_id TEXT NOT NULL,
+          method TEXT NOT NULL,
+          path TEXT NOT NULL,
+          status_code INTEGER,
+          response_body JSONB,
+          locked_until TIMESTAMPTZ,
+          created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+          PRIMARY KEY (tenant_id, key)
+        )
+      `));
+        },
+        async find(db, tenantId, key) {
+            const rows = await db.execute(sql `SELECT key, tenant_id, method, path, status_code, response_body, locked_until, created_at
+            FROM ${sql.raw(table)}
+            WHERE tenant_id = ${tenantId} AND key = ${key}`);
+            const row = rows[0];
+            if (row === undefined)
+                return null;
+            return {
+                key: row['key'],
+                tenantId: row['tenant_id'],
+                method: row['method'],
+                path: row['path'],
+                statusCode: row['status_code'],
+                responseBody: row['response_body'],
+                lockedUntil: row['locked_until'] !== null ? new Date(row['locked_until']) : null,
+                createdAt: new Date(row['created_at']),
+            };
+        },
+        async lock(db, tenantId, key, method, path, lockMs) {
+            const lockUntil = new Date(Date.now() + lockMs);
+            const rows = await db.execute(sql `INSERT INTO ${sql.raw(table)} (key, tenant_id, method, path, locked_until)
+            VALUES (${key}, ${tenantId}, ${method}, ${path}, ${lockUntil.toISOString()})
+            ON CONFLICT (tenant_id, key) DO NOTHING
+            RETURNING key`);
+            return rows.length > 0;
+        },
+        async complete(db, tenantId, key, statusCode, responseBody) {
+            await db.execute(sql `UPDATE ${sql.raw(table)}
+            SET status_code = ${statusCode},
+                response_body = ${JSON.stringify(responseBody)},
+                locked_until = NULL
+            WHERE tenant_id = ${tenantId} AND key = ${key}`);
+        },
+        async remove(db, tenantId, key) {
+            await db.execute(sql `DELETE FROM ${sql.raw(table)} WHERE tenant_id = ${tenantId} AND key = ${key}`);
+        },
+        async cleanup(db, ttlSeconds) {
+            const rows = await db.execute(sql `DELETE FROM ${sql.raw(table)}
+            WHERE created_at < now() - ${ttlSeconds.toString() + ' seconds'}::interval
+            RETURNING key`);
+            return rows.length;
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/idempotency/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/idempotency/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAIlC,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,EAAM;YACtB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;qCACM,KAAK;;;;;;;;;;;OAWnC,CAAC,CAAC,CAAA;QACL,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW;YAC9C,MAAM,IAAI,GAAc,MAAM,EAAE,CAAC,OAAO,CACtC,GAAG,CAAA;mBACQ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;gCACD,QAAQ,cAAc,GAAG,EAAE,CACpD,CAAA;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAA;YAC1D,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YAElC,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,KAAK,CAAW;gBACzB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAW;gBACpC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW;gBAC/B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAW;gBAC3B,UAAU,EAAE,GAAG,CAAC,aAAa,CAAkB;gBAC/C,YAAY,EAAE,GAAG,CAAC,eAAe,CAAC;gBAClC,WAAW,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAW,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC1F,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAW,CAAC;aACjD,CAAA;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW,EAAE,MAAc,EAAE,IAAY,EAAE,MAAc;YAC5F,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAA;YAC/C,MAAM,IAAI,GAAc,MAAM,EAAE,CAAC,OAAO,CACtC,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;sBAClB,GAAG,KAAK,QAAQ,KAAK,MAAM,KAAK,IAAI,KAAK,SAAS,CAAC,WAAW,EAAE;;0BAE5D,CACnB,CAAA;YACD,OAAQ,IAAkB,CAAC,MAAM,GAAG,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW,EAAE,UAAkB,EAAE,YAAqB;YAC7F,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;gCACH,UAAU;kCACR,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;;gCAE9B,QAAQ,cAAc,GAAG,EAAE,CACpD,CAAA;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW;YAChD,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,QAAQ,cAAc,GAAG,EAAE,CAClF,CAAA;QACH,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,EAAM,EAAE,UAAkB;YACtC,MAAM,IAAI,GAAc,MAAM,EAAE,CAAC,OAAO,CACtC,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;yCACC,UAAU,CAAC,QAAQ,EAAE,GAAG,UAAU;0BACjD,CACnB,CAAA;YACD,OAAQ,IAAkB,CAAC,MAAM,CAAA;QACnC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/idempotency/types.d.ts

@@ -0,0 +1,28 @@
+import type { DB } from '../db/index.js';
+export interface IdempotencyConfig {
+    database: string;
+    table?: string;
+    headerName?: string;
+    ttlSeconds?: number;
+    lockTimeoutMs?: number;
+    methods?: ReadonlyArray<'POST' | 'PUT' | 'PATCH' | 'DELETE'>;
+}
+export interface IdempotencyRecord {
+    key: string;
+    tenantId: string;
+    method: string;
+    path: string;
+    statusCode: number | null;
+    responseBody: unknown;
+    lockedUntil: Date | null;
+    createdAt: Date;
+}
+export interface IdempotencyStore {
+    ensureTable(db: DB): Promise<void>;
+    find(db: DB, tenantId: string, key: string): Promise<IdempotencyRecord | null>;
+    lock(db: DB, tenantId: string, key: string, method: string, path: string, lockMs: number): Promise<boolean>;
+    complete(db: DB, tenantId: string, key: string, statusCode: number, responseBody: unknown): Promise<void>;
+    remove(db: DB, tenantId: string, key: string): Promise<void>;
+    cleanup(db: DB, ttlSeconds: number): Promise<number>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/idempotency/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAExC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IAC9E,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3G,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzG,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACrD"}

package/dist/idempotency/types.js

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

package/dist/idempotency/types.js.map

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

package/dist/infra/idempotency/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/infra/idempotency/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAA;AAErE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA2E3D"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/infra/idempotency/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAA;AAErE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAgF3D"}

package/dist/infra/idempotency/store.js

@@ -43,9 +43,14 @@ export function createStore(table) {
             return rows.length > 0;
         },
         async complete(db, tenantId, key, statusCode, responseBody) {
+            // JSON.stringify(undefined) returns undefined, which binds as an empty
+            // SQL placeholder and triggers a syntax error. A 204-style response
+            // legitimately has no body; persist it as JSON null so replay surfaces
+            // the same null and the cached statusCode.
+            const body = responseBody === undefined ? null : responseBody;
             await db.execute(sql `UPDATE ${sql.raw(table)}
             SET status_code = ${statusCode},
-                response_body = ${JSON.stringify(responseBody)},
+                response_body = ${JSON.stringify(body)},
                 locked_until = NULL
             WHERE tenant_id = ${tenantId} AND key = ${key}`);
         },

package/dist/infra/idempotency/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/infra/idempotency/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAI1C,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,EAAM;YACtB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;qCACM,KAAK;;;;;;;;;;;OAWnC,CAAC,CAAC,CAAA;QACL,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW;YAC9C,MAAM,IAAI,GAAc,MAAM,EAAE,CAAC,OAAO,CACtC,GAAG,CAAA;mBACQ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;gCACD,QAAQ,cAAc,GAAG,EAAE,CACpD,CAAA;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAA;YAC1D,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YAElC,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,KAAK,CAAW;gBACzB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAW;gBACpC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW;gBAC/B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAW;gBAC3B,UAAU,EAAE,GAAG,CAAC,aAAa,CAAkB;gBAC/C,YAAY,EAAE,GAAG,CAAC,eAAe,CAAC;gBAClC,WAAW,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAW,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC1F,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAW,CAAC;aACjD,CAAA;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW,EAAE,MAAc,EAAE,IAAY,EAAE,MAAc;YAC5F,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAA;YAC/C,MAAM,IAAI,GAAc,MAAM,EAAE,CAAC,OAAO,CACtC,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;sBAClB,GAAG,KAAK,QAAQ,KAAK,MAAM,KAAK,IAAI,KAAK,SAAS,CAAC,WAAW,EAAE;;0BAE5D,CACnB,CAAA;YACD,OAAQ,IAAkB,CAAC,MAAM,GAAG,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW,EAAE,UAAkB,EAAE,YAAqB;YAC7F,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;gCACH,UAAU;kCACR,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;;gCAE9B,QAAQ,cAAc,GAAG,EAAE,CACpD,CAAA;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAM,EAAE,QAAgB,EAAE,GAAW;YAChD,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,QAAQ,cAAc,GAAG,EAAE,CAClF,CAAA;QACH,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,EAAM,EAAE,UAAkB;YACtC,MAAM,IAAI,GAAc,MAAM,EAAE,CAAC,OAAO,CACtC,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;yCACC,UAAU,CAAC,QAAQ,EAAE,GAAG,UAAU;0BACjD,CACnB,CAAA;YACD,OAAQ,IAAkB,CAAC,MAAM,CAAA;QACnC,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/infra/idempotency/store.ts"],"names":[],"mappings":"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"}

package/dist/jobs/cron.d.ts

@@ -0,0 +1,11 @@
+/** Parsed cron schedule — arrays of valid minutes, hours, days, months, weekdays. */
+export interface CronSchedule {
+    readonly minutes: readonly number[];
+    readonly hours: readonly number[];
+    readonly daysOfMonth: readonly number[];
+    readonly months: readonly number[];
+    readonly daysOfWeek: readonly number[];
+}
+export declare function parseCron(expression: string): CronSchedule;
+export declare function nextTick(schedule: CronSchedule, after: Date, timezone?: string): Date;
+//# sourceMappingURL=cron.d.ts.map

package/dist/jobs/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/jobs/cron.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAUD,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAgB1D;AA8CD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAmErF"}

package/dist/jobs/cron.js

@@ -0,0 +1,176 @@
+import { ValidationError } from '../errors/index.js';
+const FIELD_RANGES = [
+    [0, 59], // minute
+    [0, 23], // hour
+    [1, 31], // day of month
+    [1, 12], // month
+    [0, 6], // day of week (0=Sun)
+];
+export function parseCron(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new ValidationError(`Invalid cron expression "${expression}": expected 5 fields (minute hour day month weekday), got ${parts.length}`);
+    }
+    const [minutes, hours, daysOfMonth, months, daysOfWeek] = parts;
+    return {
+        minutes: parseField(minutes, FIELD_RANGES[0], 'minute'),
+        hours: parseField(hours, FIELD_RANGES[1], 'hour'),
+        daysOfMonth: parseField(daysOfMonth, FIELD_RANGES[2], 'day-of-month'),
+        months: parseField(months, FIELD_RANGES[3], 'month'),
+        daysOfWeek: parseField(daysOfWeek, FIELD_RANGES[4], 'day-of-week'),
+    };
+}
+function parseField(field, [min, max], name) {
+    const values = new Set();
+    for (const part of field.split(',')) {
+        const stepMatch = part.match(/^(.+)\/(\d+)$/);
+        const step = stepMatch ? parseInt(stepMatch[2], 10) : null;
+        const rangePart = stepMatch ? stepMatch[1] : part;
+        if (step !== null && (step < 1 || step > max)) {
+            throw new ValidationError(`Invalid cron ${name}: step "${step}" out of range`);
+        }
+        if (rangePart === '*') {
+            for (let i = min; i <= max; i += (step ?? 1)) {
+                values.add(i);
+            }
+        }
+        else if (rangePart.includes('-')) {
+            const [startStr, endStr] = rangePart.split('-');
+            const start = parseInt(startStr, 10);
+            const end = parseInt(endStr, 10);
+            if (Number.isNaN(start) || Number.isNaN(end) || start < min || end > max || start > end) {
+                throw new ValidationError(`Invalid cron ${name}: range "${rangePart}" out of bounds (${min}-${max})`);
+            }
+            for (let i = start; i <= end; i += (step ?? 1)) {
+                values.add(i);
+            }
+        }
+        else {
+            const val = parseInt(rangePart, 10);
+            if (Number.isNaN(val) || val < min || val > max) {
+                throw new ValidationError(`Invalid cron ${name}: value "${rangePart}" out of range (${min}-${max})`);
+            }
+            if (step !== null) {
+                for (let i = val; i <= max; i += step) {
+                    values.add(i);
+                }
+            }
+            else {
+                values.add(val);
+            }
+        }
+    }
+    return [...values].sort((a, b) => a - b);
+}
+export function nextTick(schedule, after, timezone) {
+    const tz = timezone ?? 'UTC';
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: tz,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    });
+    const parts = extractParts(formatter, after);
+    let year = parts.year;
+    let month = parts.month;
+    let day = parts.day;
+    let hour = parts.hour;
+    let minute = parts.minute + 1;
+    for (let guard = 0; guard < 5 * 366; guard++) {
+        if (minute > 59) {
+            minute = 0;
+            hour++;
+        }
+        if (hour > 23) {
+            hour = 0;
+            day++;
+        }
+        const dim = getDaysInMonth(year, month);
+        if (day > dim) {
+            day = 1;
+            month++;
+        }
+        if (month > 12) {
+            month = 1;
+            year++;
+        }
+        if (!schedule.months.includes(month)) {
+            month++;
+            day = schedule.daysOfMonth[0];
+            hour = schedule.hours[0];
+            minute = schedule.minutes[0];
+            continue;
+        }
+        if (!schedule.daysOfMonth.includes(day)) {
+            day++;
+            hour = schedule.hours[0];
+            minute = schedule.minutes[0];
+            continue;
+        }
+        const dow = getDayOfWeekForDate(year, month, day);
+        if (!schedule.daysOfWeek.includes(dow)) {
+            day++;
+            hour = schedule.hours[0];
+            minute = schedule.minutes[0];
+            continue;
+        }
+        if (!schedule.hours.includes(hour)) {
+            const nextHour = schedule.hours.find(h => h > hour);
+            if (nextHour !== undefined) {
+                hour = nextHour;
+                minute = schedule.minutes[0];
+            }
+            else {
+                day++;
+                hour = schedule.hours[0];
+                minute = schedule.minutes[0];
+            }
+            continue;
+        }
+        if (!schedule.minutes.includes(minute)) {
+            const nextMin = schedule.minutes.find(m => m >= minute);
+            if (nextMin !== undefined) {
+                minute = nextMin;
+            }
+            else {
+                hour++;
+                minute = schedule.minutes[0];
+            }
+            continue;
+        }
+        return buildDate(tz, year, month, day, hour, minute);
+    }
+    throw new Error('Could not find next cron tick within search window');
+}
+function extractParts(formatter, date) {
+    const resolved = formatter.formatToParts(date);
+    const get = (type) => parseInt(resolved.find(p => p.type === type).value, 10);
+    return { year: get('year'), month: get('month'), day: get('day'), hour: get('hour'), minute: get('minute') };
+}
+function getDayOfWeekForDate(year, month, day) {
+    return new Date(Date.UTC(year, month - 1, day, 12, 0, 0)).getUTCDay();
+}
+function getDaysInMonth(year, month) {
+    return new Date(year, month, 0).getDate();
+}
+function buildDate(tz, year, month, day, hour, minute) {
+    if (tz === 'UTC') {
+        return new Date(Date.UTC(year, month - 1, day, hour, minute, 0, 0));
+    }
+    const iso = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}T${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}:00`;
+    const formatter = new Intl.DateTimeFormat('en-US', { timeZone: tz, timeZoneName: 'longOffset' });
+    const refParts = formatter.formatToParts(new Date(iso + 'Z'));
+    const tzPart = refParts.find(p => p.type === 'timeZoneName')?.value ?? '+00:00';
+    const offsetMatch = tzPart.match(/GMT([+-]\d{1,2}):?(\d{2})?/);
+    if (!offsetMatch)
+        return new Date(iso + 'Z');
+    const offsetHours = parseInt(offsetMatch[1], 10);
+    const offsetMinutes = parseInt(offsetMatch[2] ?? '0', 10);
+    const totalOffsetMs = (offsetHours * 60 + (offsetHours < 0 ? -offsetMinutes : offsetMinutes)) * 60_000;
+    return new Date(new Date(iso + 'Z').getTime() - totalOffsetMs);
+}
+//# sourceMappingURL=cron.js.map

package/dist/jobs/cron.js.map

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

package/dist/jobs/execute.d.ts

@@ -0,0 +1,12 @@
+import type { Manifold } from '../pipework.js';
+import type { Handler } from '../di/types.js';
+export interface ExecuteJobOptions {
+    instance: Manifold;
+    jobId?: string;
+    jobType?: string;
+    auth?: unknown;
+    tenant?: string | null;
+    input?: unknown;
+}
+export declare function executeJob<TDeps extends Record<string, unknown>, TReturn>(handler: Handler<TDeps, TReturn>, options: ExecuteJobOptions): Promise<TReturn>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/jobs/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/jobs/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAK7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAC7E,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAWlB"}