pipework 0.7.12 → 0.7.17

package/dist/core/errors/namespace.js

@@ -0,0 +1,17 @@
+import { PipeworkError, NotFoundError, UnauthorizedError, ForbiddenError, ValidationError, ConflictError } from './index.js';
+/** Standard error classes — all extend PipeworkError with structured error codes and actionable messages. */
+export const errors = {
+    /** Base error class with code, statusCode, and suggestion fields. */
+    Base: PipeworkError,
+    /** 404 — resource not found. */
+    NotFound: NotFoundError,
+    /** 401 — missing or invalid authentication. */
+    Unauthorized: UnauthorizedError,
+    /** 403 — authenticated but insufficient permissions. */
+    Forbidden: ForbiddenError,
+    /** 422 — input validation failed, carries field-level details. */
+    Validation: ValidationError,
+    /** 409 — resource state conflict (duplicate, version mismatch). */
+    Conflict: ConflictError,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/core/errors/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/core/errors/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE5H,6GAA6G;AAC7G,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,qEAAqE;IACrE,IAAI,EAAE,aAAa;IACnB,gCAAgC;IAChC,QAAQ,EAAE,aAAa;IACvB,+CAA+C;IAC/C,YAAY,EAAE,iBAAiB;IAC/B,wDAAwD;IACxD,SAAS,EAAE,cAAc;IACzB,kEAAkE;IAClE,UAAU,EAAE,eAAe;IAC3B,mEAAmE;IACnE,QAAQ,EAAE,aAAa;CACxB,CAAA"}

package/dist/core/errors/types.d.ts

@@ -0,0 +1,29 @@
+import { PipeworkError } from './base.js';
+export declare class NotFoundError extends PipeworkError {
+    readonly code: "NOT_FOUND";
+    readonly httpStatus: 404;
+    constructor(resource: string, details?: Record<string, unknown>);
+}
+export declare class UnauthorizedError extends PipeworkError {
+    readonly code: "UNAUTHORIZED";
+    readonly httpStatus: 401;
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+export declare class ForbiddenError extends PipeworkError {
+    readonly code: "FORBIDDEN";
+    readonly httpStatus: 403;
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+export declare class ValidationError extends PipeworkError {
+    readonly code: "VALIDATION_ERROR";
+    readonly httpStatus: 422;
+    readonly fieldErrors: Readonly<Record<string, readonly string[]>>;
+    constructor(message: string);
+    constructor(fieldErrors: Record<string, string[]>, message?: string);
+}
+export declare class ConflictError extends PipeworkError {
+    readonly code: "CONFLICT";
+    readonly httpStatus: 409;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/errors/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;IACpC,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAGpE;AAED,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAS;IACvC,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,OAAO,GAAE,MAAkC,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAG/F;AAED,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;IACpC,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,OAAO,GAAE,MAAmC,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAGhG;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;IAC3C,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;IAClC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;gBAErD,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM;CAWpE;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;IACnC,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAGnE"}

package/dist/core/errors/types.js

@@ -0,0 +1,46 @@
+import { PipeworkError } from './base.js';
+export class NotFoundError extends PipeworkError {
+    code = 'NOT_FOUND';
+    httpStatus = 404;
+    constructor(resource, details = {}) {
+        super(`${resource} not found`, details);
+    }
+}
+export class UnauthorizedError extends PipeworkError {
+    code = 'UNAUTHORIZED';
+    httpStatus = 401;
+    constructor(message = 'Authentication required', details = {}) {
+        super(message, details);
+    }
+}
+export class ForbiddenError extends PipeworkError {
+    code = 'FORBIDDEN';
+    httpStatus = 403;
+    constructor(message = 'Insufficient permissions', details = {}) {
+        super(message, details);
+    }
+}
+export class ValidationError extends PipeworkError {
+    code = 'VALIDATION_ERROR';
+    httpStatus = 422;
+    fieldErrors;
+    constructor(fieldErrorsOrMessage, message) {
+        if (typeof fieldErrorsOrMessage === 'string') {
+            super(fieldErrorsOrMessage, { fieldErrors: {} });
+            this.fieldErrors = {};
+        }
+        else {
+            const msg = message ?? 'Invalid input';
+            super(msg, { fieldErrors: fieldErrorsOrMessage });
+            this.fieldErrors = fieldErrorsOrMessage;
+        }
+    }
+}
+export class ConflictError extends PipeworkError {
+    code = 'CONFLICT';
+    httpStatus = 409;
+    constructor(message, details = {}) {
+        super(message, details);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/errors/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,OAAO,aAAc,SAAQ,aAAa;IACrC,IAAI,GAAG,WAAoB,CAAA;IAC3B,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,QAAgB,EAAE,UAAmC,EAAE;QACjE,KAAK,CAAC,GAAG,QAAQ,YAAY,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IACzC,IAAI,GAAG,cAAuB,CAAA;IAC9B,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,UAAkB,yBAAyB,EAAE,UAAmC,EAAE;QAC5F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IACtC,IAAI,GAAG,WAAoB,CAAA;IAC3B,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,UAAkB,0BAA0B,EAAE,UAAmC,EAAE;QAC7F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,aAAa;IACvC,IAAI,GAAG,kBAA2B,CAAA;IAClC,UAAU,GAAG,GAAY,CAAA;IACzB,WAAW,CAA6C;IAIjE,YAAY,oBAAuD,EAAE,OAAgB;QACnF,IAAI,OAAO,oBAAoB,KAAK,QAAQ,EAAE,CAAC;YAC7C,KAAK,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAA;YAChD,IAAI,CAAC,WAAW,GAAG,EAAE,CAAA;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,OAAO,IAAI,eAAe,CAAA;YACtC,KAAK,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAA;YACjD,IAAI,CAAC,WAAW,GAAG,oBAAoB,CAAA;QACzC,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IACrC,IAAI,GAAG,UAAmB,CAAA;IAC1B,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/core/lifecycle/drain.d.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from 'fastify';
+export interface DrainState {
+    readonly inFlight: () => number;
+    readonly waitForDrain: (timeoutMs: number) => Promise<void>;
+}
+export declare function setupDrain(app: FastifyInstance): DrainState;
+//# sourceMappingURL=drain.d.ts.map

package/dist/core/lifecycle/drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/drain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,UAAU,CAyB3D"}

package/dist/core/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/core/lifecycle/drain.js.map

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

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

@@ -0,0 +1,62 @@
+import { sql } from '../../data/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/core/lifecycle/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/core/lifecycle/health.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAE5B,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,QAAkB,EAClB,MAA8B,EAC9B,KAAwC;IAExC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,OAAO,GAAsC,EAAE,CAAA;QACrD,IAAI,OAAO,GAA2B,SAAS,CAAA;QAE/C,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;QAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;YACtB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO,GAAG,WAAW,CAAA;iBACnD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,KAAK,WAAW;gBAAE,OAAO,GAAG,UAAU,CAAA;QACxF,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACxB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;gBAClC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAA;gBACxF,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;oBAAE,OAAO,GAAG,WAAW,CAAA;qBACnD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,KAAK,WAAW;oBAAE,OAAO,GAAG,UAAU,CAAA;YACxF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;oBACpB,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc;oBAC5D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;iBAC9B,CAAA;gBACD,OAAO,GAAG,WAAW,CAAA;YACvB,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;QACjG,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAkB;IAC9C,MAAM,OAAO,GAAsC,EAAE,CAAA;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;IAE/C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;YAChD,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC,CAAA;YACzC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG;gBACtB,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;gBACjE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC9B,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

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

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

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

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

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

@@ -0,0 +1,43 @@
+import { sql } from '../../data/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/core/lifecycle/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../../../src/core/lifecycle/startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAG1C,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/core/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/core/lifecycle/types.d.ts.map

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

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

package/dist/core/lifecycle/types.js.map

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

package/dist/core/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("../logging/types.js").LogNamespace & {
+    /** 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/core/log/namespace.d.ts.map

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

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

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

@@ -0,0 +1,46 @@
+import { getContext } from '../../request/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/core/logging/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/core/logging/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAC3D,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/core/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, LogNamespace, LoggingConfig, ContextField } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/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,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/core/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/core/logging/index.js.map

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

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

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

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

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

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

package/dist/core/logging/proxy.js

@@ -0,0 +1,21 @@
+import { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig, DEFAULT_REDACT_PATHS } from './logger.js';
+const target = {
+    create: createPipeworkLogger,
+    get: getLogger,
+    getBase: getBaseLogger,
+    configure: setLoggingConfig,
+    REDACT_PATHS: DEFAULT_REDACT_PATHS,
+};
+export const log = new Proxy(target, {
+    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/core/logging/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../../src/core/logging/proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEpH,MAAM,MAAM,GAAG;IACb,MAAM,EAAE,oBAAoB;IAC5B,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,aAAa;IACtB,SAAS,EAAE,gBAAgB;IAC3B,YAAY,EAAE,oBAAoB;CACR,CAAA;AAE5B,MAAM,CAAC,MAAM,GAAG,GAAiB,IAAI,KAAK,CAAC,MAAM,EAAE;IACjD,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"}