pipework 0.8.6 → 0.8.8

package/dist/state-machine/define.js

@@ -0,0 +1,46 @@
+import { InvalidStateMachineError } from './errors.js';
+import { buildTransitionMap, getValidTargets, attemptTransition, evaluateGuard } from './transition.js';
+export function defineStateMachine(config) {
+    validate(config);
+    const transitionMap = buildTransitionMap(config.transitions);
+    return {
+        validTargets(from) {
+            return getValidTargets(transitionMap, from);
+        },
+        hasTransition(from, to) {
+            return getValidTargets(transitionMap, from).includes(to);
+        },
+        async canTransition(context) {
+            return evaluateGuard(transitionMap, context);
+        },
+        async transition(context) {
+            return attemptTransition(context, transitionMap);
+        },
+        definition: config,
+    };
+}
+function validate(config) {
+    if (config.states.length === 0) {
+        throw new InvalidStateMachineError('Must define at least one state.');
+    }
+    const stateSet = new Set(config.states);
+    if (stateSet.size !== config.states.length) {
+        const dupes = config.states.filter((s, i) => config.states.indexOf(s) !== i);
+        throw new InvalidStateMachineError(`Duplicate states: ${dupes.join(', ')}.`);
+    }
+    if (config.initial !== undefined && !stateSet.has(config.initial)) {
+        throw new InvalidStateMachineError(`Initial state "${config.initial}" is not in the states list.`);
+    }
+    for (const t of config.transitions) {
+        if (!stateSet.has(t.from)) {
+            throw new InvalidStateMachineError(`Transition references unknown source state "${t.from}".`);
+        }
+        const targets = typeof t.to === 'string' ? [t.to] : t.to;
+        for (const target of targets) {
+            if (!stateSet.has(target)) {
+                throw new InvalidStateMachineError(`Transition from "${t.from}" references unknown target state "${target}".`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=define.js.map

package/dist/state-machine/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/state-machine/define.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEvG,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,QAAQ,CAAC,MAAM,CAAC,CAAA;IAEhB,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAE5D,OAAO;QACL,YAAY,CAAC,IAAY;YACvB,OAAO,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;QAC7C,CAAC;QAED,aAAa,CAAC,IAAY,EAAE,EAAU;YACpC,OAAO,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC1D,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAA0B;YAC5C,OAAO,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,OAA0B;YACzC,OAAO,iBAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAClD,CAAC;QAED,UAAU,EAAE,MAAM;KACnB,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,MAA0B;IAC1C,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,wBAAwB,CAAC,iCAAiC,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAEvC,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAC5E,MAAM,IAAI,wBAAwB,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,MAAM,CAAC,OAAO,8BAA8B,CAC/D,CAAA;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,wBAAwB,CAChC,+CAA+C,CAAC,CAAC,IAAI,IAAI,CAC1D,CAAA;QACH,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACxD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,wBAAwB,CAChC,oBAAoB,CAAC,CAAC,IAAI,sCAAsC,MAAM,IAAI,CAC3E,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/state-machine/errors.d.ts

@@ -0,0 +1,12 @@
+import { PipeworkError } from '../errors/base.js';
+export declare class InvalidTransitionError extends PipeworkError {
+    readonly code: "INVALID_TRANSITION";
+    readonly httpStatus: 409;
+    constructor(entityType: string, from: string, to: string, validTargets: readonly string[]);
+}
+export declare class InvalidStateMachineError extends PipeworkError {
+    readonly code: "INVALID_STATE_MACHINE";
+    readonly httpStatus: 500;
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/state-machine/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/state-machine/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAS;IAC7C,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAGhC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,SAAS,MAAM,EAAE;CASlC;AAED,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAS;IAChD,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAS;gBAEtB,OAAO,EAAE,MAAM;CAG5B"}

package/dist/state-machine/errors.js

@@ -0,0 +1,19 @@
+import { PipeworkError } from '../errors/base.js';
+export class InvalidTransitionError extends PipeworkError {
+    code = 'INVALID_TRANSITION';
+    httpStatus = 409;
+    constructor(entityType, from, to, validTargets) {
+        const targets = validTargets.length > 0
+            ? `Valid targets from "${from}": ${validTargets.join(', ')}.`
+            : `No transitions defined from "${from}".`;
+        super(`Cannot transition ${entityType} from "${from}" to "${to}". ${targets}`);
+    }
+}
+export class InvalidStateMachineError extends PipeworkError {
+    code = 'INVALID_STATE_MACHINE';
+    httpStatus = 500;
+    constructor(message) {
+        super(`[pipework] Invalid state machine definition: ${message}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/state-machine/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/state-machine/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAC9C,IAAI,GAAG,oBAA6B,CAAA;IACpC,UAAU,GAAG,GAAY,CAAA;IAElC,YACE,UAAkB,EAClB,IAAY,EACZ,EAAU,EACV,YAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;YACrC,CAAC,CAAC,uBAAuB,IAAI,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC7D,CAAC,CAAC,gCAAgC,IAAI,IAAI,CAAA;QAC5C,KAAK,CACH,qBAAqB,UAAU,UAAU,IAAI,SAAS,EAAE,MAAM,OAAO,EAAE,CACxE,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IAChD,IAAI,GAAG,uBAAgC,CAAA;IACvC,UAAU,GAAG,GAAY,CAAA;IAElC,YAAY,OAAe;QACzB,KAAK,CAAC,gDAAgD,OAAO,EAAE,CAAC,CAAA;IAClE,CAAC;CACF"}

package/dist/state-machine/index.d.ts

@@ -0,0 +1,4 @@
+export { defineStateMachine } from './define.js';
+export { InvalidTransitionError, InvalidStateMachineError } from './errors.js';
+export type { StateMachineConfig, TransitionDef, TransitionContext, TransitionResult, StateMachine } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state-machine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state-machine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC9E,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/state-machine/index.js

@@ -0,0 +1,3 @@
+export { defineStateMachine } from './define.js';
+export { InvalidTransitionError, InvalidStateMachineError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/state-machine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state-machine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA"}

package/dist/state-machine/namespace.d.ts

@@ -0,0 +1,12 @@
+import { defineStateMachine } from './define.js';
+import { InvalidTransitionError, InvalidStateMachineError } from './errors.js';
+/** State machine namespace — define valid transitions with guards and side effects. */
+export declare const state: {
+    /** Defines a state machine from states, transitions, guards, and effects. Returns a StateMachine with transition/canTransition. */
+    define: typeof defineStateMachine;
+    /** Thrown when a transition is not allowed from the current state. */
+    InvalidTransitionError: typeof InvalidTransitionError;
+    /** Thrown when the state machine definition is internally inconsistent. */
+    InvalidStateMachineError: typeof InvalidStateMachineError;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/state-machine/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/state-machine/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAE9E,uFAAuF;AACvF,eAAO,MAAM,KAAK;IAChB,mIAAmI;;IAEnI,sEAAsE;;IAEtE,2EAA2E;;CAE5E,CAAA"}

package/dist/state-machine/namespace.js

@@ -0,0 +1,12 @@
+import { defineStateMachine } from './define.js';
+import { InvalidTransitionError, InvalidStateMachineError } from './errors.js';
+/** State machine namespace — define valid transitions with guards and side effects. */
+export const state = {
+    /** Defines a state machine from states, transitions, guards, and effects. Returns a StateMachine with transition/canTransition. */
+    define: defineStateMachine,
+    /** Thrown when a transition is not allowed from the current state. */
+    InvalidTransitionError,
+    /** Thrown when the state machine definition is internally inconsistent. */
+    InvalidStateMachineError,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/state-machine/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/state-machine/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAE9E,uFAAuF;AACvF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,mIAAmI;IACnI,MAAM,EAAE,kBAAkB;IAC1B,sEAAsE;IACtE,sBAAsB;IACtB,2EAA2E;IAC3E,wBAAwB;CACzB,CAAA"}

package/dist/state-machine/transition.d.ts

@@ -0,0 +1,7 @@
+import type { TransitionDef, TransitionContext, TransitionResult } from './types.js';
+export declare function buildTransitionMap(transitions: readonly TransitionDef[]): Map<string, TransitionDef[]>;
+export declare function getValidTargets(transitionMap: Map<string, TransitionDef[]>, from: string): string[];
+export declare function findMatchingDef(transitionMap: Map<string, TransitionDef[]>, from: string, to: string): TransitionDef | undefined;
+export declare function evaluateGuard(transitionMap: Map<string, TransitionDef[]>, context: TransitionContext): Promise<boolean>;
+export declare function attemptTransition(context: TransitionContext, transitionMap: Map<string, TransitionDef[]>): Promise<TransitionResult>;
+//# sourceMappingURL=transition.d.ts.map

package/dist/state-machine/transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../src/state-machine/transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGpF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAQtG;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAWnG;AAED,wBAAgB,eAAe,CAC7B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAC3C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,aAAa,GAAG,SAAS,CAK3B;AAED,wBAAsB,aAAa,CACjC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAC3C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,GAC1C,OAAO,CAAC,gBAAgB,CAAC,CA+B3B"}

package/dist/state-machine/transition.js

@@ -0,0 +1,57 @@
+import { InvalidTransitionError } from './errors.js';
+export function buildTransitionMap(transitions) {
+    const map = new Map();
+    for (const t of transitions) {
+        const existing = map.get(t.from) ?? [];
+        existing.push(t);
+        map.set(t.from, existing);
+    }
+    return map;
+}
+export function getValidTargets(transitionMap, from) {
+    const defs = transitionMap.get(from) ?? [];
+    const targets = [];
+    for (const def of defs) {
+        if (typeof def.to === 'string') {
+            targets.push(def.to);
+        }
+        else {
+            targets.push(...def.to);
+        }
+    }
+    return targets;
+}
+export function findMatchingDef(transitionMap, from, to) {
+    const defs = transitionMap.get(from) ?? [];
+    return defs.find(d => typeof d.to === 'string' ? d.to === to : d.to.includes(to));
+}
+export async function evaluateGuard(transitionMap, context) {
+    const validTargets = getValidTargets(transitionMap, context.from);
+    if (!validTargets.includes(context.to)) {
+        return false;
+    }
+    const matchingDef = findMatchingDef(transitionMap, context.from, context.to);
+    if (matchingDef?.guard !== undefined) {
+        return matchingDef.guard(context);
+    }
+    return true;
+}
+export async function attemptTransition(context, transitionMap) {
+    const validTargets = getValidTargets(transitionMap, context.from);
+    if (!validTargets.includes(context.to)) {
+        throw new InvalidTransitionError(context.entityType, context.from, context.to, validTargets);
+    }
+    const matchingDef = findMatchingDef(transitionMap, context.from, context.to);
+    if (matchingDef?.guard !== undefined) {
+        const allowed = await matchingDef.guard(context);
+        if (!allowed) {
+            throw new InvalidTransitionError(context.entityType, context.from, context.to, validTargets);
+        }
+    }
+    return {
+        from: context.from,
+        to: context.to,
+        entityId: context.entityId,
+    };
+}
+//# sourceMappingURL=transition.js.map

package/dist/state-machine/transition.js.map

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

package/dist/state-machine/types.d.ts

@@ -0,0 +1,33 @@
+import type { Audit } from '../audit/types.js';
+export interface TransitionDef {
+    readonly from: string;
+    readonly to: string | readonly string[];
+    readonly guard?: (context: TransitionContext) => boolean | Promise<boolean>;
+}
+export interface StateMachineConfig {
+    readonly states: readonly string[];
+    readonly transitions: readonly TransitionDef[];
+    readonly initial?: string;
+    readonly audit?: Audit;
+}
+export interface TransitionContext {
+    readonly entityId: string;
+    readonly entityType: string;
+    readonly from: string;
+    readonly to: string;
+    readonly userId?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface TransitionResult {
+    readonly from: string;
+    readonly to: string;
+    readonly entityId: string;
+}
+export interface StateMachine {
+    validTargets(from: string): readonly string[];
+    hasTransition(from: string, to: string): boolean;
+    canTransition(context: TransitionContext): Promise<boolean>;
+    transition(context: TransitionContext): Promise<TransitionResult>;
+    readonly definition: StateMachineConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/state-machine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state-machine/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5E;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAA;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAChD,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACjE,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;CACxC"}

package/dist/state-machine/types.js

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

package/dist/state-machine/types.js.map

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

package/dist/surface/http.d.ts

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

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

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

package/dist/surface/http.js

@@ -0,0 +1,84 @@
+import { DEFAULT_DB } from '../di/types.js';
+import { createServer } from '../http/server.js';
+export function createHttpSurface(config) {
+    const databases = collectHttpDatabases(config);
+    const deps = {};
+    const surface = {
+        kind: 'http',
+        manifest: { databases, jobTypes: [], dependencies: deps },
+        dependencies(d) {
+            Object.assign(deps, d);
+            return surface;
+        },
+        async start(context) {
+            const serverConfig = buildServerConfig(config);
+            const server = createServer(context, serverConfig);
+            const handlers = config.handlers ?? [];
+            if (handlers.length > 0) {
+                server.registerHandlers([...handlers]);
+            }
+            const resources = config.resources ?? [];
+            for (const resource of resources) {
+                server.registerResource(resource);
+            }
+            const address = await server.listen();
+            return {
+                kind: 'http',
+                address,
+                async stop() {
+                    await server.close();
+                },
+            };
+        },
+    };
+    return surface;
+}
+function buildServerConfig(config) {
+    const sc = { managed: true };
+    if (config.port !== undefined)
+        sc.port = config.port;
+    if (config.host !== undefined)
+        sc.host = config.host;
+    if (config.gracefulShutdownMs !== undefined)
+        sc.gracefulShutdownMs = config.gracefulShutdownMs;
+    if (config.auth !== undefined)
+        sc.auth = config.auth;
+    if (config.tenant !== undefined)
+        sc.tenant = config.tenant;
+    if (config.cors !== undefined)
+        sc.cors = config.cors;
+    if (config.security !== undefined)
+        sc.security = config.security;
+    if (config.rateLimit !== undefined)
+        sc.rateLimit = config.rateLimit;
+    if (config.openapi !== undefined)
+        sc.openapi = config.openapi;
+    if (config.rbac !== undefined)
+        sc.rbac = config.rbac;
+    if (config.transactionPerRequest !== undefined)
+        sc.transactionPerRequest = config.transactionPerRequest;
+    if (config.transactionTimeoutMs !== undefined)
+        sc.transactionTimeoutMs = config.transactionTimeoutMs;
+    if (config.healthChecks !== undefined)
+        sc.healthChecks = config.healthChecks;
+    if (config.logging !== undefined)
+        sc.logging = config.logging;
+    if (config.logger !== undefined)
+        sc.logger = config.logger;
+    if (config.trustProxy !== undefined)
+        sc.trustProxy = config.trustProxy;
+    return sc;
+}
+function collectHttpDatabases(config) {
+    const dbs = new Set();
+    for (const h of config.handlers ?? []) {
+        for (const db of h.meta.databases) {
+            dbs.add(db === DEFAULT_DB ? DEFAULT_DB : db);
+        }
+    }
+    for (const r of config.resources ?? []) {
+        dbs.add(r.meta.database);
+    }
+    return [...dbs];
+}
+//# sourceMappingURL=http.js.map

package/dist/surface/http.js.map

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

package/dist/surface/index.d.ts

@@ -0,0 +1,7 @@
+export { createHttpSurface } from './http.js';
+export { createWorkerSurface } from './worker.js';
+export { createScriptSurface } from './script.js';
+export { validateSurfaces, validateNoJobTypeDuplicates } from './validate.js';
+export { startSurfaces, type StartResult } from './start.js';
+export type { SurfaceKind, SurfaceManifest, SurfaceHandle, Surface, SurfaceBuilder, SurfaceContext, HttpSurfaceConfig, WorkerSurfaceConfig, ScriptSurfaceConfig, ScriptContext, RetryConfig, SurfaceMap, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surface/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAC5D,YAAY,EACV,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EACpF,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EAC1E,WAAW,EAAE,UAAU,GACxB,MAAM,YAAY,CAAA"}

package/dist/surface/index.js

@@ -0,0 +1,6 @@
+export { createHttpSurface } from './http.js';
+export { createWorkerSurface } from './worker.js';
+export { createScriptSurface } from './script.js';
+export { validateSurfaces, validateNoJobTypeDuplicates } from './validate.js';
+export { startSurfaces } from './start.js';
+//# sourceMappingURL=index.js.map

package/dist/surface/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surface/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAA"}

package/dist/surface/namespace.d.ts

@@ -0,0 +1,13 @@
+import { createHttpSurface } from './http.js';
+import { createWorkerSurface } from './worker.js';
+import { createScriptSurface } from './script.js';
+/** Surface namespace — declarative entry points that define how the app runs (HTTP server, background worker, one-shot script). */
+export declare const surface: {
+    /** Creates an HTTP surface — a Fastify server with routes, middleware, and production validation. */
+    http: typeof createHttpSurface;
+    /** Creates a worker surface — a long-running process that claims and executes jobs from queues. */
+    worker: typeof createWorkerSurface;
+    /** Creates a script surface — a one-shot process that runs and exits (migrations, seeds, CLI tools). */
+    script: typeof createScriptSurface;
+};
+//# sourceMappingURL=namespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/surface/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,mIAAmI;AACnI,eAAO,MAAM,OAAO;IAClB,qGAAqG;;IAErG,mGAAmG;;IAEnG,wGAAwG;;CAEzG,CAAA"}

package/dist/surface/namespace.js

@@ -0,0 +1,13 @@
+import { createHttpSurface } from './http.js';
+import { createWorkerSurface } from './worker.js';
+import { createScriptSurface } from './script.js';
+/** Surface namespace — declarative entry points that define how the app runs (HTTP server, background worker, one-shot script). */
+export const surface = {
+    /** Creates an HTTP surface — a Fastify server with routes, middleware, and production validation. */
+    http: createHttpSurface,
+    /** Creates a worker surface — a long-running process that claims and executes jobs from queues. */
+    worker: createWorkerSurface,
+    /** Creates a script surface — a one-shot process that runs and exits (migrations, seeds, CLI tools). */
+    script: createScriptSurface,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/surface/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/surface/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,mIAAmI;AACnI,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,qGAAqG;IACrG,IAAI,EAAE,iBAAiB;IACvB,mGAAmG;IACnG,MAAM,EAAE,mBAAmB;IAC3B,wGAAwG;IACxG,MAAM,EAAE,mBAAmB;CAC5B,CAAA"}

package/dist/surface/script.d.ts

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

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

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

package/dist/surface/script.js

@@ -0,0 +1,24 @@
+export function createScriptSurface(config) {
+    const deps = {};
+    const surface = {
+        kind: 'script',
+        manifest: { databases: config.databases ?? [], jobTypes: [], dependencies: deps },
+        dependencies(d) {
+            Object.assign(deps, d);
+            return surface;
+        },
+        async start(context) {
+            await config.run({
+                config: context.config,
+                env: context.env,
+                pool: context.pool,
+            });
+            return {
+                kind: 'script',
+                async stop() { },
+            };
+        },
+    };
+    return surface;
+}
+//# sourceMappingURL=script.js.map

package/dist/surface/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../src/surface/script.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,MAAM,IAAI,GAA2B,EAAE,CAAA;IAEvC,MAAM,OAAO,GAAmB;QAC9B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QAEjF,YAAY,CAAC,CAAyB;YACpC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YACtB,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,OAAuB;YACjC,MAAM,MAAM,CAAC,GAAG,CAAC;gBACf,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAA;YAEF,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,KAAK,CAAC,IAAI,KAAI,CAAC;aAChB,CAAA;QACH,CAAC;KACF,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/surface/start.d.ts

@@ -0,0 +1,8 @@
+import type { SurfaceContext, SurfaceHandle, SurfaceMap } from './types.js';
+import type { ResolvedConfig } from '../config/load.js';
+export interface StartResult {
+    readonly handles: ReadonlyMap<string, SurfaceHandle>;
+    stop(): Promise<void>;
+}
+export declare function startSurfaces(context: SurfaceContext, config: ResolvedConfig, surfaces: SurfaceMap): Promise<StartResult>;
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/surface/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,WAAW,CAAC,CAyEtB"}

package/dist/surface/start.js

@@ -0,0 +1,64 @@
+import { validateSurfaces, validateNoJobTypeDuplicates } from './validate.js';
+import { getBaseLogger } from '../logging/index.js';
+export async function startSurfaces(context, config, surfaces) {
+    const logger = getBaseLogger();
+    validateSurfaces(config, surfaces);
+    validateNoJobTypeDuplicates(surfaces);
+    const handles = new Map();
+    const startOrder = [];
+    const entries = Object.entries(surfaces);
+    const scripts = entries.filter(([, s]) => s.kind === 'script');
+    const workers = entries.filter(([, s]) => s.kind === 'worker');
+    const httpSurfaces = entries.filter(([, s]) => s.kind === 'http');
+    const ordered = [...scripts, ...workers, ...httpSurfaces];
+    for (const [name, surface] of ordered) {
+        logger.info({ surface: name, kind: surface.kind }, `Starting surface "${name}"`);
+        try {
+            const handle = await surface.start(context);
+            handles.set(name, handle);
+            startOrder.push(name);
+            if (handle.address !== undefined) {
+                logger.info({ surface: name, address: handle.address }, `Surface "${name}" listening`);
+            }
+        }
+        catch (err) {
+            logger.error({ surface: name, err }, `Failed to start surface "${name}"`);
+            for (const started of startOrder.reverse()) {
+                try {
+                    await handles.get(started).stop();
+                }
+                catch (stopErr) {
+                    logger.error({ surface: started, err: stopErr }, `Failed to stop surface "${started}" during rollback`);
+                }
+            }
+            throw new Error(`[pipework] Failed to start surface "${name}".\n\n` +
+                `  ${err instanceof Error ? err.message : String(err)}\n\n` +
+                `  Surfaces that were started have been stopped.\n`);
+        }
+    }
+    return {
+        handles,
+        async stop() {
+            const stopOrder = [...startOrder].reverse();
+            const errors = [];
+            for (const name of stopOrder) {
+                const handle = handles.get(name);
+                if (handle === undefined)
+                    continue;
+                try {
+                    logger.info({ surface: name }, `Stopping surface "${name}"`);
+                    await handle.stop();
+                }
+                catch (err) {
+                    logger.error({ surface: name, err }, `Error stopping surface "${name}"`);
+                    errors.push({ name, error: err });
+                }
+            }
+            if (errors.length > 0) {
+                const details = errors.map(e => `  - ${e.name}: ${e.error instanceof Error ? e.error.message : String(e.error)}`).join('\n');
+                throw new Error(`[pipework] Errors occurred while stopping surfaces:\n\n${details}\n`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/surface/start.js.map

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