pipework 0.8.6 → 0.8.8

package/dist/lifecycle/drain.js

@@ -0,0 +1,24 @@
+export function setupDrain(app) {
+    let count = 0;
+    app.addHook('onRequest', () => { count++; return Promise.resolve(); });
+    app.addHook('onResponse', () => { count--; return Promise.resolve(); });
+    return {
+        inFlight: () => count,
+        waitForDrain: (timeoutMs) => new Promise((resolve, reject) => {
+            if (count === 0)
+                return resolve();
+            const deadline = setTimeout(() => {
+                clearInterval(poll);
+                reject(new Error(`[pipework] Drain timeout: ${count} requests still in-flight after ${timeoutMs}ms`));
+            }, timeoutMs);
+            const poll = setInterval(() => {
+                if (count === 0) {
+                    clearTimeout(deadline);
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 50);
+        }),
+    };
+}
+//# sourceMappingURL=drain.js.map

package/dist/lifecycle/drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.js","sourceRoot":"","sources":["../../src/lifecycle/drain.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CAAC,GAAoB;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;IACrE,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;IAEtE,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,YAAY,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzE,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,OAAO,EAAE,CAAA;YAEjC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC/B,aAAa,CAAC,IAAI,CAAC,CAAA;gBACnB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,KAAK,mCAAmC,SAAS,IAAI,CAAC,CAAC,CAAA;YACvG,CAAC,EAAE,SAAS,CAAC,CAAA;YAEb,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC5B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,YAAY,CAAC,QAAQ,CAAC,CAAA;oBACtB,aAAa,CAAC,IAAI,CAAC,CAAA;oBACnB,OAAO,EAAE,CAAA;gBACX,CAAC;YACH,CAAC,EAAE,EAAE,CAAC,CAAA;QACR,CAAC,CAAC;KACH,CAAA;AACH,CAAC"}

package/dist/lifecycle/health.d.ts

@@ -0,0 +1,8 @@
+import type { FastifyInstance } from 'fastify';
+import type { Manifold } from '../pipework.js';
+import type { HealthCheck } from './types.js';
+export declare function registerHealthRoutes(app: FastifyInstance, instance: Manifold, checks: readonly HealthCheck[], paths: {
+    health: string;
+    ready: string;
+}): void;
+//# sourceMappingURL=health.d.ts.map

package/dist/lifecycle/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/lifecycle/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAmC,MAAM,YAAY,CAAA;AAK9E,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC,IAAI,CAoCN"}

package/dist/lifecycle/health.js

@@ -0,0 +1,62 @@
+import { sql } from '../db/sql.js';
+const startedAt = Date.now();
+export function registerHealthRoutes(app, instance, checks, paths) {
+    app.get(paths.health, async (_req, reply) => {
+        return reply.status(200).send({ status: 'healthy', uptime: Date.now() - startedAt });
+    });
+    app.get(paths.ready, async (_req, reply) => {
+        const results = {};
+        let overall = 'healthy';
+        const dbChecks = await checkDatabases(instance);
+        for (const [name, result] of Object.entries(dbChecks)) {
+            results[name] = result;
+            if (result.status === 'unhealthy')
+                overall = 'unhealthy';
+            else if (result.status === 'degraded' && overall !== 'unhealthy')
+                overall = 'degraded';
+        }
+        for (const check of checks) {
+            const start = Date.now();
+            try {
+                const result = await check.check();
+                results[check.name] = { ...result, latencyMs: result.latencyMs ?? (Date.now() - start) };
+                if (result.status === 'unhealthy')
+                    overall = 'unhealthy';
+                else if (result.status === 'degraded' && overall !== 'unhealthy')
+                    overall = 'degraded';
+            }
+            catch (err) {
+                results[check.name] = {
+                    status: 'unhealthy',
+                    message: err instanceof Error ? err.message : 'check failed',
+                    latencyMs: Date.now() - start,
+                };
+                overall = 'unhealthy';
+            }
+        }
+        const status = { status: overall, uptime: Date.now() - startedAt, checks: results };
+        return reply.status(overall === 'unhealthy' ? 503 : 200).send(status);
+    });
+}
+async function checkDatabases(instance) {
+    const results = {};
+    const dbNames = instance.config.databaseNames();
+    for (const name of dbNames) {
+        const start = Date.now();
+        try {
+            const dbConfig = instance.config.database(name);
+            const conn = instance.pool.getOrCreate(dbConfig);
+            await conn.drizzle.execute(sql `SELECT 1`);
+            results[`db:${name}`] = { status: 'healthy', latencyMs: Date.now() - start };
+        }
+        catch (err) {
+            results[`db:${name}`] = {
+                status: 'unhealthy',
+                message: err instanceof Error ? err.message : 'connection failed',
+                latencyMs: Date.now() - start,
+            };
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=health.js.map

package/dist/lifecycle/health.js.map

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

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,5 @@
+export { orchestrateStartup, type StartupOptions } from './startup.js';
+export { registerHealthRoutes } from './health.js';
+export { setupDrain, type DrainState } from './drain.js';
+export type { LifecycleConfig, StartupHook, ShutdownHook, HealthCheck, HealthCheckResult, HealthStatus } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACxD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/lifecycle/index.js

@@ -0,0 +1,4 @@
+export { orchestrateStartup } from './startup.js';
+export { registerHealthRoutes } from './health.js';
+export { setupDrain } from './drain.js';
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAA"}

package/dist/lifecycle/namespace.d.ts

@@ -0,0 +1,7 @@
+import { orchestrateStartup } from './startup.js';
+/** Application lifecycle namespace — startup orchestration with hooks and timeouts. */
+export declare const lifecycle: {
+    /** Runs pre-start hooks (DB readiness checks, migrations, etc.) with a configurable timeout. */
+    orchestrate: typeof orchestrateStartup;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/lifecycle/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/lifecycle/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,uFAAuF;AACvF,eAAO,MAAM,SAAS;IACpB,gGAAgG;;CAEjG,CAAA"}

package/dist/lifecycle/namespace.js

@@ -0,0 +1,7 @@
+import { orchestrateStartup } from './startup.js';
+/** Application lifecycle namespace — startup orchestration with hooks and timeouts. */
+export const lifecycle = {
+    /** Runs pre-start hooks (DB readiness checks, migrations, etc.) with a configurable timeout. */
+    orchestrate: orchestrateStartup,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/lifecycle/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/lifecycle/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,gGAAgG;IAChG,WAAW,EAAE,kBAAkB;CAChC,CAAA"}

package/dist/lifecycle/startup.d.ts

@@ -0,0 +1,8 @@
+import type { Manifold } from '../pipework.js';
+import type { StartupHook } from './types.js';
+export interface StartupOptions {
+    readonly hooks?: readonly StartupHook[];
+    readonly timeoutMs?: number;
+}
+export declare function orchestrateStartup(instance: Manifold, options?: StartupOptions): Promise<void>;
+//# sourceMappingURL=startup.d.ts.map

package/dist/lifecycle/startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../../src/lifecycle/startup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BxG"}

package/dist/lifecycle/startup.js

@@ -0,0 +1,43 @@
+import { sql } from '../db/sql.js';
+import { getBaseLogger } from '../logging/index.js';
+export async function orchestrateStartup(instance, options = {}) {
+    const logger = getBaseLogger();
+    const timeoutMs = options.timeoutMs ?? 30000;
+    const doStartupWork = async () => {
+        await verifyDatabases(instance, logger);
+        if (options.hooks) {
+            for (const hook of options.hooks) {
+                logger.info({ hook: hook.name }, 'Running pre-start hook');
+                await hook.execute();
+            }
+        }
+    };
+    const timeoutPromise = new Promise((_, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`[pipework] Startup timed out after ${timeoutMs}ms.\n\n` +
+                '  This usually means a database is unreachable or a pre-start hook is hanging.\n' +
+                '  Check your DATABASE_URL values and network connectivity.\n'));
+        }, timeoutMs);
+        timer.unref();
+    });
+    await Promise.race([doStartupWork(), timeoutPromise]);
+}
+async function verifyDatabases(instance, logger) {
+    const dbNames = instance.config.databaseNames();
+    for (const name of dbNames) {
+        const dbConfig = instance.config.database(name);
+        const conn = instance.pool.getOrCreate(dbConfig);
+        try {
+            await conn.drizzle.execute(sql `SELECT 1`);
+            logger.info({ database: name }, 'Database connectivity verified');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`[pipework] Cannot connect to database "${name}".\n\n` +
+                `  URL: ${dbConfig.url.replace(/\/\/[^@]+@/, '//***@')}\n` +
+                `  Error: ${message}\n\n` +
+                '  Check that the database is running and the URL is correct.\n');
+        }
+    }
+}
+//# sourceMappingURL=startup.js.map

package/dist/lifecycle/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../../src/lifecycle/startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAOnD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB,EAAE,UAA0B,EAAE;IACvF,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;IAE5C,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;QAC/B,MAAM,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAEvC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAA;gBAC1D,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;YACtB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CACd,sCAAsC,SAAS,SAAS;gBACxD,kFAAkF;gBAClF,8DAA8D,CAC/D,CAAC,CAAA;QACJ,CAAC,EAAE,SAAS,CAAC,CAAA;QACb,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,cAAc,CAAC,CAAC,CAAA;AACvD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAkB,EAAE,MAAkE;IACnH,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;IAE/C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC,CAAA;YACzC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,gCAAgC,CAAC,CAAA;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChE,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,QAAQ;gBACtD,UAAU,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC1D,YAAY,OAAO,MAAM;gBACzB,gEAAgE,CACjE,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lifecycle/types.d.ts

@@ -0,0 +1,30 @@
+export interface LifecycleConfig {
+    readonly preStart?: readonly StartupHook[];
+    readonly preShutdown?: readonly ShutdownHook[];
+    readonly healthChecks?: readonly HealthCheck[];
+    readonly drainTimeoutMs?: number;
+    readonly startupTimeoutMs?: number;
+}
+export interface StartupHook {
+    readonly name: string;
+    execute(): Promise<void>;
+}
+export interface ShutdownHook {
+    readonly name: string;
+    execute(): Promise<void>;
+}
+export interface HealthCheck {
+    readonly name: string;
+    check(): Promise<HealthCheckResult>;
+}
+export interface HealthCheckResult {
+    readonly status: 'healthy' | 'degraded' | 'unhealthy';
+    readonly message?: string;
+    readonly latencyMs?: number;
+}
+export interface HealthStatus {
+    readonly status: 'healthy' | 'degraded' | 'unhealthy';
+    readonly uptime: number;
+    readonly checks: Record<string, HealthCheckResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CACnD"}

package/dist/lifecycle/types.js

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

package/dist/lifecycle/types.js.map

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

package/dist/log/namespace.d.ts

@@ -0,0 +1,15 @@
+import { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig } from '../logging/logger.js';
+/** Structured logger (Pino) — auto-binds requestId, tenantId, userId, sessionId from ALS context on every log call. */
+export declare const log: import("../index.js").PipeworkLogger & {
+    /** Creates a new PipeworkLogger instance with custom config (level, redaction, transport). */
+    create: typeof createPipeworkLogger;
+    /** Returns the context-aware logger proxy (same as the log export itself). */
+    get: typeof getLogger;
+    /** Returns the raw Pino logger without ALS context binding. */
+    getBase: typeof getBaseLogger;
+    /** Sets global logging config (level, redaction paths, custom context fields). */
+    configure: typeof setLoggingConfig;
+    /** Default redaction paths — password, secret, token, authorization, cookie, etc. */
+    REDACT_PATHS: readonly string[];
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/log/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/log/namespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAwB,MAAM,sBAAsB,CAAA;AAE7H,uHAAuH;AACvH,eAAO,MAAM,GAAG;IACd,8FAA8F;;IAE9F,8EAA8E;;IAE9E,+DAA+D;;IAE/D,kFAAkF;;IAElF,qFAAqF;;CAErF,CAAA"}

package/dist/log/namespace.js

@@ -0,0 +1,16 @@
+import { log as logProxy } from '../logging/proxy.js';
+import { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig, DEFAULT_REDACT_PATHS } from '../logging/logger.js';
+/** Structured logger (Pino) — auto-binds requestId, tenantId, userId, sessionId from ALS context on every log call. */
+export const log = Object.assign(logProxy, {
+    /** Creates a new PipeworkLogger instance with custom config (level, redaction, transport). */
+    create: createPipeworkLogger,
+    /** Returns the context-aware logger proxy (same as the log export itself). */
+    get: getLogger,
+    /** Returns the raw Pino logger without ALS context binding. */
+    getBase: getBaseLogger,
+    /** Sets global logging config (level, redaction paths, custom context fields). */
+    configure: setLoggingConfig,
+    /** Default redaction paths — password, secret, token, authorization, cookie, etc. */
+    REDACT_PATHS: DEFAULT_REDACT_PATHS,
+});
+//# sourceMappingURL=namespace.js.map

package/dist/log/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/log/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE7H,uHAAuH;AACvH,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;IACzC,8FAA8F;IAC9F,MAAM,EAAE,oBAAoB;IAC5B,8EAA8E;IAC9E,GAAG,EAAE,SAAS;IACd,+DAA+D;IAC/D,OAAO,EAAE,aAAa;IACtB,kFAAkF;IAClF,SAAS,EAAE,gBAAgB;IAC3B,qFAAqF;IACrF,YAAY,EAAE,oBAAoB;CACnC,CAAC,CAAA"}

package/dist/logging/context.d.ts

@@ -0,0 +1,11 @@
+export interface CorrelationFields {
+    requestId?: string;
+    tenantId?: string;
+    userId?: string;
+    sessionId?: string;
+    traceId?: string;
+    jobType?: string;
+    [key: string]: string | undefined;
+}
+export declare function getCorrelationFields(): CorrelationFields;
+//# sourceMappingURL=context.d.ts.map

package/dist/logging/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/logging/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAClC;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAwCxD"}

package/dist/logging/context.js

@@ -0,0 +1,46 @@
+import { getContext } from '../context/store.js';
+import { getLoggingConfig } from './logger.js';
+export function getCorrelationFields() {
+    const ctx = getContext();
+    if (!ctx)
+        return {};
+    const config = getLoggingConfig();
+    const enabled = config?.contextFields;
+    const fields = {};
+    if (isEnabled('requestId', enabled) && ctx.requestId !== '') {
+        fields.requestId = ctx.requestId;
+    }
+    if (isEnabled('tenantId', enabled) && ctx.tenant !== null) {
+        fields.tenantId = ctx.tenant;
+    }
+    if (isEnabled('userId', enabled) && ctx.auth !== null && typeof ctx.auth === 'object' && 'userId' in ctx.auth) {
+        const userId = ctx.auth.userId;
+        if (typeof userId === 'string')
+            fields.userId = userId;
+    }
+    if (isEnabled('sessionId', enabled) && ctx.metadata?.sessionId != null) {
+        fields.sessionId = ctx.metadata.sessionId;
+    }
+    if (isEnabled('traceId', enabled) && ctx.metadata?.traceId != null) {
+        fields.traceId = ctx.metadata.traceId;
+    }
+    if (ctx.jobType !== null) {
+        fields.jobType = ctx.jobType;
+    }
+    if (config?.authFields != null && ctx.auth !== null && typeof ctx.auth === 'object') {
+        const auth = ctx.auth;
+        for (const field of config.authFields) {
+            const value = auth[field];
+            if (typeof value === 'string') {
+                fields[field] = value;
+            }
+        }
+    }
+    return fields;
+}
+function isEnabled(field, enabled) {
+    if (enabled === undefined)
+        return true;
+    return enabled.includes(field);
+}
+//# sourceMappingURL=context.js.map

package/dist/logging/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/logging/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAa9C,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;IACxB,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IAEnB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;IACjC,MAAM,OAAO,GAAG,MAAM,EAAE,aAAa,CAAA;IAErC,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAA;IAClC,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAA;IAC9B,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9G,MAAM,MAAM,GAAI,GAAG,CAAC,IAA4B,CAAC,MAAM,CAAA;QACvD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IACxD,CAAC;IACD,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC;QACvE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAA;IAC3C,CAAC;IACD,IAAI,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;QACnE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAA;IACvC,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;IAC9B,CAAC;IAED,IAAI,MAAM,EAAE,UAAU,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpF,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAA;QAChD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAmB,EAAE,OAA4C;IAClF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,4 @@
+export { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig, DEFAULT_REDACT_PATHS } from './logger.js';
+export { log } from './proxy.js';
+export type { LoggerConfig, LogLevel, PipeworkLogger, LoggingConfig, ContextField } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACpH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAChC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/logging/index.js

@@ -0,0 +1,3 @@
+export { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig, DEFAULT_REDACT_PATHS } from './logger.js';
+export { log } from './proxy.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACpH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,8 @@
+import type { PipeworkLogger, LoggerConfig, LoggingConfig } from './types.js';
+export declare const DEFAULT_REDACT_PATHS: readonly string[];
+export declare function createPipeworkLogger(config?: LoggerConfig): PipeworkLogger;
+export declare function setLoggingConfig(config: LoggingConfig): void;
+export declare function getLoggingConfig(): LoggingConfig | null;
+export declare function getLogger(): PipeworkLogger;
+export declare function getBaseLogger(): PipeworkLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7E,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAOjD,CAAA;AAKD,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAY9E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE5D;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD;AAED,wBAAgB,SAAS,IAAI,cAAc,CAM1C;AAED,wBAAgB,aAAa,IAAI,cAAc,CAE9C"}

package/dist/logging/logger.js

@@ -0,0 +1,39 @@
+import pino from 'pino';
+import { getCorrelationFields } from './context.js';
+export const DEFAULT_REDACT_PATHS = [
+    'password',
+    'token',
+    'authorization',
+    '*.password',
+    '*.token',
+    '*.authorization',
+];
+let baseLogger = null;
+let loggingConfig = null;
+export function createPipeworkLogger(config = {}) {
+    const level = config.level ?? 'info';
+    const redact = config.redact ?? [...DEFAULT_REDACT_PATHS];
+    const pinoOpts = { level, redact: redact };
+    if (config.pretty === true) {
+        pinoOpts.transport = { target: 'pino-pretty', options: { colorize: true } };
+    }
+    baseLogger = pino(pinoOpts);
+    return baseLogger;
+}
+export function setLoggingConfig(config) {
+    loggingConfig = config;
+}
+export function getLoggingConfig() {
+    return loggingConfig;
+}
+export function getLogger() {
+    const base = baseLogger ?? pino({ level: 'info' });
+    const fields = getCorrelationFields();
+    if (Object.keys(fields).length === 0)
+        return base;
+    return base.child(fields);
+}
+export function getBaseLogger() {
+    return baseLogger ?? pino({ level: 'info' });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,UAAU;IACV,OAAO;IACP,eAAe;IACf,YAAY;IACZ,SAAS;IACT,iBAAiB;CAClB,CAAA;AAED,IAAI,UAAU,GAA0B,IAAI,CAAA;AAC5C,IAAI,aAAa,GAAyB,IAAI,CAAA;AAE9C,MAAM,UAAU,oBAAoB,CAAC,SAAuB,EAAE;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAA;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,oBAAoB,CAAC,CAAA;IAEzD,MAAM,QAAQ,GAAuB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAkB,EAAE,CAAA;IAE1E,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,QAAQ,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAA;IAC7E,CAAC;IAED,UAAU,GAAG,IAAI,CAAC,QAAQ,CAA8B,CAAA;IACxD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,aAAa,GAAG,MAAM,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,IAAI,GAAG,UAAU,IAAK,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAA+B,CAAA;IACjF,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAA;IAErC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,IAAK,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAA+B,CAAA;AAC7E,CAAC"}

package/dist/logging/proxy.d.ts

@@ -0,0 +1,3 @@
+import type { PipeworkLogger } from './types.js';
+export declare const log: PipeworkLogger;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/logging/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/logging/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD,eAAO,MAAM,GAAG,EAAE,cAUhB,CAAA"}

package/dist/logging/proxy.js

@@ -0,0 +1,14 @@
+import { getLogger } from './logger.js';
+export const log = new Proxy({}, {
+    get(target, prop) {
+        if (Object.hasOwn(target, prop))
+            return target[prop];
+        const logger = getLogger();
+        const value = logger[prop];
+        if (typeof value === 'function') {
+            return value.bind(logger);
+        }
+        return value;
+    },
+});
+//# sourceMappingURL=proxy.js.map

package/dist/logging/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/logging/proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,CAAC,MAAM,GAAG,GAAmB,IAAI,KAAK,CAAC,EAAoB,EAAE;IACjE,GAAG,CAAC,MAAM,EAAE,IAAqB;QAC/B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,OAAQ,MAAsD,CAAC,IAAI,CAAC,CAAA;QACrG,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,IAA4B,CAAC,CAAA;QAClD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAQ,KAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAC,CAAA"}

package/dist/logging/types.d.ts

@@ -0,0 +1,36 @@
+export type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+export type ContextField = 'requestId' | 'tenantId' | 'userId' | 'sessionId' | 'traceId';
+export interface PipeworkLogger {
+    info(msg: string): void;
+    info(obj: Record<string, unknown>, msg?: string): void;
+    warn(msg: string): void;
+    warn(obj: Record<string, unknown>, msg?: string): void;
+    error(msg: string): void;
+    error(obj: Record<string, unknown>, msg?: string): void;
+    debug(msg: string): void;
+    debug(obj: Record<string, unknown>, msg?: string): void;
+    fatal(msg: string): void;
+    fatal(obj: Record<string, unknown>, msg?: string): void;
+    trace(msg: string): void;
+    trace(obj: Record<string, unknown>, msg?: string): void;
+    child(bindings: Record<string, unknown>): PipeworkLogger;
+    silent: boolean;
+}
+export interface LoggerConfig {
+    readonly level?: LogLevel;
+    readonly pretty?: boolean;
+    readonly slowQueryMs?: number;
+    readonly redact?: readonly string[] | {
+        readonly paths: readonly string[];
+        readonly censor?: string;
+        readonly remove?: boolean;
+    };
+}
+export interface LoggingConfig {
+    readonly traceHeader?: string;
+    readonly requestIdHeader?: string;
+    readonly sessionHeader?: string;
+    readonly authFields?: readonly string[];
+    readonly contextFields?: readonly ContextField[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/logging/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAE9E,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;AAExF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAA;IACxD,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG;QACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;QACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAC1B,CAAA;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CACjD"}

package/dist/logging/types.js

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

package/dist/logging/types.js.map

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

package/dist/migrate/check.d.ts

@@ -0,0 +1,14 @@
+import { type MigrationHazard, type Severity } from './safety.js';
+export interface MigrationCheckResult {
+    safe: boolean;
+    hasDestructive: boolean;
+    hasLocking: boolean;
+    fileHazards: {
+        file: string;
+        hazards: MigrationHazard[];
+    }[];
+}
+export declare function checkMigrations(migrationsFolder: string): MigrationCheckResult;
+export declare function formatCheckResult(result: MigrationCheckResult): string;
+export type { MigrationHazard, Severity };
+//# sourceMappingURL=check.d.ts.map

package/dist/migrate/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/migrate/check.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE5F,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAA;IACb,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,eAAe,EAAE,CAAA;KAAE,EAAE,CAAA;CAC5D;AAYD,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,oBAAoB,CA+B9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAyBtE;AAED,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAA"}

package/dist/migrate/check.js

@@ -0,0 +1,58 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { analyzeSQL, formatHazards } from './safety.js';
+export function checkMigrations(migrationsFolder) {
+    const journalPath = join(migrationsFolder, 'meta', '_journal.json');
+    if (!existsSync(journalPath)) {
+        return { safe: true, hasDestructive: false, hasLocking: false, fileHazards: [] };
+    }
+    const journal = JSON.parse(readFileSync(journalPath, 'utf-8'));
+    const fileHazards = [];
+    let hasDestructive = false;
+    let hasLocking = false;
+    for (const entry of journal.entries) {
+        const sqlPath = join(migrationsFolder, `${entry.tag}.sql`);
+        if (!existsSync(sqlPath))
+            continue;
+        const sql = readFileSync(sqlPath, 'utf-8');
+        const hazards = analyzeSQL(sql);
+        if (hazards.length > 0) {
+            fileHazards.push({ file: `${entry.tag}.sql`, hazards });
+            if (hazards.some(h => h.severity === 'destructive'))
+                hasDestructive = true;
+            if (hazards.some(h => h.severity === 'locking'))
+                hasLocking = true;
+        }
+    }
+    return {
+        safe: !hasDestructive && !hasLocking,
+        hasDestructive,
+        hasLocking,
+        fileHazards,
+    };
+}
+export function formatCheckResult(result) {
+    if (result.safe)
+        return '';
+    const lines = [];
+    const dCount = result.fileHazards.reduce((n, f) => n + f.hazards.filter(h => h.severity === 'destructive').length, 0);
+    const lCount = result.fileHazards.reduce((n, f) => n + f.hazards.filter(h => h.severity === 'locking').length, 0);
+    const parts = [];
+    if (dCount > 0)
+        parts.push(`${dCount} destructive`);
+    if (lCount > 0)
+        parts.push(`${lCount} locking`);
+    lines.push(`Migration safety check: ${parts.join(' and ')} operation${dCount + lCount > 1 ? 's' : ''} detected.\n`);
+    for (const { file, hazards } of result.fileHazards) {
+        lines.push(formatHazards(hazards, file));
+    }
+    lines.push('');
+    if (dCount > 0) {
+        lines.push('Pass --allow-destructive to run destructive migrations.');
+    }
+    if (lCount > 0) {
+        lines.push('Pass --acknowledge-lock to run migrations that acquire heavy locks.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=check.js.map