pipework 0.8.11 → 0.8.13

package/dist/data/valve/decision.js

@@ -0,0 +1,19 @@
+/**
+ * The decision outcome — the load-bearing seam of the transition-gate form
+ * (#307 field 13). A gate's `.decision()` hook returns one of three branches.
+ * The three-way partition is fixed here by the primitive; the business verdict
+ * that *picks* a branch is consumer-silo application code.
+ */
+/** Cross the valve: deliver `payload` to the consumer. */
+export function cross(payload) {
+    return { kind: 'cross', payload };
+}
+/** Hold the crossing: it enters a provisional, reviewable state carrying `reason`. */
+export function held(reason) {
+    return { kind: 'held', reason };
+}
+/** Evaluation failed: a retryable, dead-letterable outcome — never a thrown exception. */
+export function failed(error) {
+    return { kind: 'failed', error };
+}
+//# sourceMappingURL=decision.js.map

package/dist/data/valve/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../../src/data/valve/decision.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,0DAA0D;AAC1D,MAAM,UAAU,KAAK,CAAW,OAAiB;IAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AACnC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,IAAI,CAAU,MAAe;IAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACjC,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,MAAM,CAAC,KAAY;IACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;AAClC,CAAC"}

package/dist/data/valve/durable-crossing.d.ts

@@ -0,0 +1,25 @@
+import type { DB } from '../db/namespace.js';
+import type { Queue } from '../../async/jobs/queue.js';
+import type { CrossingResult } from './types.js';
+/** Job type for a durable valve crossing. */
+export declare const VALVE_CROSSING_JOB_TYPE = "pipework:valve-crossing";
+/** The payload of a durable-crossing job. */
+export interface CrossingJobPayload {
+    readonly valve: string;
+    readonly source: unknown;
+}
+/**
+ * Enqueue a handoff crossing to run durably. The job queue retries it with
+ * backoff and dead-letters it on retry exhaustion — failure-to-cross becomes a
+ * terminal job outcome, not an exception that vanishes.
+ */
+export declare function enqueueCrossing(queue: Queue, db: DB, valve: string, source: unknown): Promise<string>;
+/**
+ * The job-handler body for a durable crossing. Wire it into a worker — e.g.
+ * `fitting().job(VALVE_CROSSING_JOB_TYPE).fit(({ input, db }) => runCrossingJob(input, db))`.
+ * The valve must be registered in the worker process; the crossing runs
+ * recorded and idempotent on the job's transaction. A throw fails the job,
+ * which the queue retries and finally dead-letters.
+ */
+export declare function runCrossingJob(payload: CrossingJobPayload, tx: DB): Promise<CrossingResult>;
+//# sourceMappingURL=durable-crossing.d.ts.map

package/dist/data/valve/durable-crossing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-crossing.d.ts","sourceRoot":"","sources":["../../../src/data/valve/durable-crossing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAA;AAElE,6CAA6C;AAC7C,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAEhE,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAcjG"}

package/dist/data/valve/durable-crossing.js

@@ -0,0 +1,32 @@
+import { getValve } from './registry.js';
+import { executeSupplyCrossing } from './execute-crossing.js';
+/** Job type for a durable valve crossing. */
+export const VALVE_CROSSING_JOB_TYPE = 'pipework:valve-crossing';
+/**
+ * Enqueue a handoff crossing to run durably. The job queue retries it with
+ * backoff and dead-letters it on retry exhaustion — failure-to-cross becomes a
+ * terminal job outcome, not an exception that vanishes.
+ */
+export async function enqueueCrossing(queue, db, valve, source) {
+    const payload = { valve, source };
+    return queue.enqueue(db, { type: VALVE_CROSSING_JOB_TYPE, payload });
+}
+/**
+ * The job-handler body for a durable crossing. Wire it into a worker — e.g.
+ * `fitting().job(VALVE_CROSSING_JOB_TYPE).fit(({ input, db }) => runCrossingJob(input, db))`.
+ * The valve must be registered in the worker process; the crossing runs
+ * recorded and idempotent on the job's transaction. A throw fails the job,
+ * which the queue retries and finally dead-letters.
+ */
+export async function runCrossingJob(payload, tx) {
+    const definition = getValve(payload.valve);
+    if (definition === undefined) {
+        throw new Error(`[pipework] Durable crossing names an unregistered valve: "${payload.valve}".\n\n` +
+            '  The valve declaration must be imported in the worker process so it registers.\n');
+    }
+    if (definition.kind !== 'handoff') {
+        throw new Error(`[pipework] Durable crossing supports handoff valves; "${payload.valve}" is a ${definition.kind}.\n`);
+    }
+    return executeSupplyCrossing(definition, payload.source, tx);
+}
+//# sourceMappingURL=durable-crossing.js.map

package/dist/data/valve/durable-crossing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-crossing.js","sourceRoot":"","sources":["../../../src/data/valve/durable-crossing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAK7D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAA;AAQhE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAY,EACZ,EAAM,EACN,KAAa,EACb,MAAe;IAEf,MAAM,OAAO,GAAuB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IACrD,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA2B,EAAE,EAAM;IACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,6DAA6D,OAAO,CAAC,KAAK,QAAQ;YAClF,mFAAmF,CACpF,CAAA;IACH,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,yDAAyD,OAAO,CAAC,KAAK,UAAU,UAAU,CAAC,IAAI,KAAK,CACrG,CAAA;IACH,CAAC;IACD,OAAO,qBAAqB,CAAC,UAAgD,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACpG,CAAC"}

package/dist/data/valve/execute-crossing.d.ts

@@ -0,0 +1,17 @@
+import type { DB } from '../db/namespace.js';
+import type { CrossingResult, GateCrossingResult, GateDefinition, SupplyDefinition } from './types.js';
+/**
+ * Execute a handoff crossing with idempotency and provenance, on the caller's
+ * transaction. If the supply declares an idempotency key and a `crossed` row
+ * already exists for it, the crossing is skipped — its effect already landed.
+ * Otherwise the crossing runs and its outcome is appended to the ledger
+ * atomically with it.
+ */
+export declare function executeSupplyCrossing<TSource, TPayload>(definition: SupplyDefinition<TSource, TPayload>, source: TSource, tx: DB): Promise<CrossingResult>;
+/**
+ * Execute a transition-gate crossing with provenance. Each fanned-out crossing
+ * — crossed, held, or failed — is appended to the ledger as its own row, on the
+ * caller's transaction.
+ */
+export declare function executeGateCrossing<TEvent>(definition: GateDefinition<TEvent>, event: TEvent, context: Readonly<Record<string, unknown>>, tx: DB): Promise<readonly GateCrossingResult[]>;
+//# sourceMappingURL=execute-crossing.d.ts.map

package/dist/data/valve/execute-crossing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-crossing.d.ts","sourceRoot":"","sources":["../../../src/data/valve/execute-crossing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAiBnB;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAC3D,UAAU,EAAE,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC/C,MAAM,EAAE,OAAO,EACf,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,cAAc,CAAC,CAezB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAC9C,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,EAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1C,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAaxC"}

package/dist/data/valve/execute-crossing.js

@@ -0,0 +1,58 @@
+import { crossSupply, crossGate } from './cross.js';
+import { recordCrossing, findCrossing } from './crossing-ledger.js';
+function lineageOf(definition, source) {
+    if (definition.lineageField === undefined)
+        return null;
+    const value = source[definition.lineageField];
+    return typeof value === 'string' ? value : null;
+}
+function detailOf(result) {
+    if (result.kind === 'held')
+        return { reason: result.reason };
+    if (result.kind === 'failed')
+        return { error: result.error.message };
+    return null;
+}
+/**
+ * Execute a handoff crossing with idempotency and provenance, on the caller's
+ * transaction. If the supply declares an idempotency key and a `crossed` row
+ * already exists for it, the crossing is skipped — its effect already landed.
+ * Otherwise the crossing runs and its outcome is appended to the ledger
+ * atomically with it.
+ */
+export async function executeSupplyCrossing(definition, source, tx) {
+    const key = definition.idempotentBy !== undefined ? definition.idempotentBy(source) : null;
+    if (key !== null && await findCrossing(tx, definition.name, key)) {
+        return { kind: 'skipped' };
+    }
+    const result = await crossSupply(definition, source, tx);
+    await recordCrossing(tx, {
+        valve: definition.name,
+        idempotencyKey: key,
+        outcome: result.kind,
+        payload: result.kind === 'crossed' ? result.payload : null,
+        detail: null,
+        lineageId: lineageOf(definition, source),
+    });
+    return result;
+}
+/**
+ * Execute a transition-gate crossing with provenance. Each fanned-out crossing
+ * — crossed, held, or failed — is appended to the ledger as its own row, on the
+ * caller's transaction.
+ */
+export async function executeGateCrossing(definition, event, context, tx) {
+    const results = await crossGate(definition, event, context);
+    for (const result of results) {
+        await recordCrossing(tx, {
+            valve: definition.name,
+            idempotencyKey: null,
+            outcome: result.kind,
+            payload: result.kind === 'crossed' ? result.payload : null,
+            detail: detailOf(result),
+            lineageId: null,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=execute-crossing.js.map

package/dist/data/valve/execute-crossing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-crossing.js","sourceRoot":"","sources":["../../../src/data/valve/execute-crossing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AASnE,SAAS,SAAS,CAChB,UAA+C,EAC/C,MAAe;IAEf,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,MAAM,KAAK,GAAI,MAAkC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;IAC1E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,MAA0B;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;IAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAA+C,EAC/C,MAAe,EACf,EAAM;IAEN,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1F,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IAC5B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IACxD,MAAM,cAAc,CAAC,EAAE,EAAE;QACvB,KAAK,EAAE,UAAU,CAAC,IAAI;QACtB,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,MAAM,CAAC,IAAI;QACpB,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC1D,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;KACzC,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkC,EAClC,KAAa,EACb,OAA0C,EAC1C,EAAM;IAEN,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC3D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,cAAc,CAAC,EAAE,EAAE;YACvB,KAAK,EAAE,UAAU,CAAC,IAAI;YACtB,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC1D,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;YACxB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/data/valve/faucet.d.ts

@@ -0,0 +1,18 @@
+import type { FaucetDefinition, FaucetHandler } from './types.js';
+/**
+ * The consumer-side builder. A faucet binds to a valve by name — never to the
+ * producer silo — and lands every (re-validated) payload in a consumer entity.
+ * `.on()` is terminal: supplying the intake handler registers the faucet.
+ */
+export interface FaucetBuilder<TPayload> {
+    /** The consumer entity the payload lands in. */
+    into(target: string): FaucetBuilder<TPayload>;
+    /** The intake handler. Terminal — registers the faucet and returns its definition. */
+    on(handler: FaucetHandler<TPayload>): FaucetDefinition<TPayload>;
+}
+/**
+ * Declare a faucet — the consumer side of a `supply -> faucet` edge. `valve` is
+ * the name of the producer valve this faucet consumes.
+ */
+export declare function faucet<TPayload = unknown>(valve: string): FaucetBuilder<TPayload>;
+//# sourceMappingURL=faucet.d.ts.map

package/dist/data/valve/faucet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faucet.d.ts","sourceRoot":"","sources":["../../../src/data/valve/faucet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEjE;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ;IACrC,gDAAgD;IAChD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC7C,sFAAsF;IACtF,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;CACjE;AAwBD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAcjF"}

package/dist/data/valve/faucet.js

@@ -0,0 +1,34 @@
+import { registerFaucet } from './registry.js';
+function finalizeFaucet(state, handler) {
+    if (state.target === undefined) {
+        throw new Error(`[pipework] Faucet for valve "${state.valve}" is missing .into(...).\n\n` +
+            '  A faucet must declare the consumer entity its payload lands in before .on(...).\n' +
+            '  Example: faucet("frozen-outcome").into("ledger-entries").on(handler)\n');
+    }
+    const definition = {
+        valve: state.valve,
+        target: state.target,
+        handler,
+    };
+    registerFaucet(definition);
+    return definition;
+}
+/**
+ * Declare a faucet — the consumer side of a `supply -> faucet` edge. `valve` is
+ * the name of the producer valve this faucet consumes.
+ */
+export function faucet(valve) {
+    const state = { valve, target: undefined };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- the builder erases the payload generic; FaucetBuilder is the precise public surface
+    const builder = {
+        into(target) {
+            state.target = target;
+            return builder;
+        },
+        on(handler) {
+            return finalizeFaucet(state, handler);
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=faucet.js.map

package/dist/data/valve/faucet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faucet.js","sourceRoot":"","sources":["../../../src/data/valve/faucet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAoB9C,SAAS,cAAc,CAAC,KAAkB,EAAE,OAA+B;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,CAAC,KAAK,8BAA8B;YACzE,qFAAqF;YACrF,0EAA0E,CAC3E,CAAA;IACH,CAAC;IACD,MAAM,UAAU,GAA8B;QAC5C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO;KACR,CAAA;IACD,cAAc,CAAC,UAAU,CAAC,CAAA;IAC1B,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAqB,KAAa;IACtD,MAAM,KAAK,GAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IAEvD,qJAAqJ;IACrJ,MAAM,OAAO,GAAQ;QACnB,IAAI,CAAC,MAAc;YACjB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAA;YACrB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,EAAE,CAAC,OAA+B;YAChC,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACvC,CAAC;KACF,CAAA;IACD,OAAO,OAAkC,CAAA;AAC3C,CAAC"}

package/dist/data/valve/gate.d.ts

@@ -0,0 +1,28 @@
+import type { GateDecision, GateDefinition, GateRetraction, GateTrigger } from './types.js';
+/**
+ * The producer-side builder for a transition-gate valve. `.on()` fixes the
+ * source event type; `.fanOut()` and `.decision()` are checked against it.
+ * `.decision()` is terminal — the async hook is the load-bearing seam, and
+ * supplying it registers the gate.
+ */
+export interface GateBuilder<TEvent> {
+    /** The source entity and the set of triggers that fire the gate. */
+    on<TOnEvent = TEvent>(source: string, triggers: readonly GateTrigger[]): GateBuilder<TOnEvent>;
+    /** Enrichment context — context key -> inbound valve name. Fed by inbound faucets. */
+    context(inbound: Record<string, string>): GateBuilder<TEvent>;
+    /** Names the computed signals the decision may read. */
+    signals(names: readonly string[]): GateBuilder<TEvent>;
+    /** Fans one trigger out to N independently-keyed crossings. */
+    fanOut(items: (event: TEvent) => readonly unknown[]): GateBuilder<TEvent>;
+    /** Declares that a trigger supersedes and retracts the prior crossing. */
+    retracts(config: GateRetraction): GateBuilder<TEvent>;
+    /** The async decision hook. Terminal — registers the gate and returns its definition. */
+    decision(hook: GateDecision<TEvent>): GateDefinition<TEvent>;
+}
+/**
+ * Declare a transition-gate valve. A gate modulates a state change within one
+ * silo, so `silo` is both producer and consumer. Chain the anatomy and finish
+ * with `.decision(hook)`.
+ */
+export declare function gate(name: string, silo: string): GateBuilder<unknown>;
+//# sourceMappingURL=gate.d.ts.map

package/dist/data/valve/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../src/data/valve/gate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3F;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,MAAM;IACjC,oEAAoE;IACpE,EAAE,CAAC,QAAQ,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9F,sFAAsF;IACtF,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAC7D,wDAAwD;IACxD,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IACtD,+DAA+D;IAC/D,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IACzE,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IACrD,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;CAC7D;AA6CD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAyCrE"}

package/dist/data/valve/gate.js

@@ -0,0 +1,74 @@
+import { registerValve } from './registry.js';
+function finalizeGate(state, hook) {
+    if (state.source === undefined || state.triggers === undefined) {
+        throw new Error(`[pipework] Valve "${state.name}" is missing .on(...).\n\n` +
+            '  A gate must declare its source entity and trigger set before .decision(...).\n' +
+            '  Example: gate("event-verification", "events")\n' +
+            '             .on("event-versions", [{ trigger: "admission" }])\n');
+    }
+    if (state.triggers.length === 0) {
+        throw new Error(`[pipework] Valve "${state.name}" has an empty trigger set.\n\n` +
+            '  .on(...) must declare at least one trigger — a gate that never fires is dead.\n');
+    }
+    const definition = {
+        name: state.name,
+        kind: 'transition-gate',
+        topology: { producer: state.silo, consumer: state.silo },
+        source: state.source,
+        triggers: state.triggers,
+        context: { ...state.context },
+        signals: [...state.signals],
+        fanOut: state.fanOut,
+        decision: hook,
+        retraction: state.retraction,
+    };
+    registerValve(definition);
+    return definition;
+}
+/**
+ * Declare a transition-gate valve. A gate modulates a state change within one
+ * silo, so `silo` is both producer and consumer. Chain the anatomy and finish
+ * with `.decision(hook)`.
+ */
+export function gate(name, silo) {
+    const state = {
+        name,
+        silo,
+        source: undefined,
+        triggers: undefined,
+        context: {},
+        signals: [],
+        fanOut: undefined,
+        retraction: undefined,
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- builder type param narrows per stage; the public GateBuilder type is precise
+    const builder = {
+        on(source, triggers) {
+            state.source = source;
+            state.triggers = triggers;
+            return builder;
+        },
+        context(inbound) {
+            state.context = inbound;
+            return builder;
+        },
+        signals(names) {
+            state.signals = names;
+            return builder;
+        },
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- fan-out event generic erased into state; see GateState
+        fanOut(items) {
+            state.fanOut = items;
+            return builder;
+        },
+        retracts(config) {
+            state.retraction = config;
+            return builder;
+        },
+        decision(hook) {
+            return finalizeGate(state, hook);
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=gate.js.map

package/dist/data/valve/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../../src/data/valve/gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAoC7C,SAAS,YAAY,CAAC,KAAgB,EAAE,IAA2B;IACjE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,IAAI,4BAA4B;YAC3D,kFAAkF;YAClF,mDAAmD;YACnD,kEAAkE,CACnE,CAAA;IACH,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,IAAI,iCAAiC;YAChE,mFAAmF,CACpF,CAAA;IACH,CAAC;IACD,MAAM,UAAU,GAA4B;QAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE;QACxD,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;QAC7B,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAA;IACD,aAAa,CAAC,UAAU,CAAC,CAAA;IACzB,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,IAAY;IAC7C,MAAM,KAAK,GAAc;QACvB,IAAI;QACJ,IAAI;QACJ,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,SAAS;KACtB,CAAA;IAED,8IAA8I;IAC9I,MAAM,OAAO,GAAQ;QACnB,EAAE,CAAC,MAAc,EAAE,QAAgC;YACjD,KAAK,CAAC,MAAM,GAAG,MAAM,CAAA;YACrB,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;YACzB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,OAAO,CAAC,OAA+B;YACrC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;YACvB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,OAAO,CAAC,KAAwB;YAC9B,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;YACrB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,wHAAwH;QACxH,MAAM,CAAC,KAAyC;YAC9C,KAAK,CAAC,MAAM,GAAG,KAAK,CAAA;YACpB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,QAAQ,CAAC,MAAsB;YAC7B,KAAK,CAAC,UAAU,GAAG,MAAM,CAAA;YACzB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,QAAQ,CAAC,IAA2B;YAClC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAClC,CAAC;KACF,CAAA;IACD,OAAO,OAA+B,CAAA;AACxC,CAAC"}

package/dist/data/valve/graph.d.ts

@@ -0,0 +1,28 @@
+export type ValveNodeKind = 'supply' | 'gate' | 'faucet';
+export interface ValveGraphNode {
+    readonly id: string;
+    readonly kind: ValveNodeKind;
+}
+/**
+ * `crossing` — a producer delivers to a faucet. `context` — a gate's enrichment
+ * depends on an inbound valve. `retraction` — a superseded crossing invalidates
+ * the downstream it fed.
+ */
+export type ValveEdgeKind = 'crossing' | 'context' | 'retraction';
+export interface ValveGraphEdge {
+    readonly kind: ValveEdgeKind;
+    readonly from: string;
+    readonly to: string;
+}
+/** The directional data-dependency graph, distinct from the package graph. */
+export interface ValveGraph {
+    readonly nodes: readonly ValveGraphNode[];
+    readonly edges: readonly ValveGraphEdge[];
+}
+/** Assemble the valve graph from every registered valve and faucet. */
+export declare function buildValveGraph(): ValveGraph;
+/** Faucet node ids fed by the named valve — the direct downstream of a crossing. */
+export declare function downstreamFaucets(graph: ValveGraph, valveName: string): readonly string[];
+/** Gate valve names whose enrichment context depends on the named valve. */
+export declare function contextDependents(graph: ValveGraph, valveName: string): readonly string[];
+//# sourceMappingURL=graph.d.ts.map

package/dist/data/valve/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/data/valve/graph.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAA;AAEjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;CAC1C;AAMD,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,UAAU,CA4B5C;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIzF;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIzF"}

package/dist/data/valve/graph.js

@@ -0,0 +1,43 @@
+import { valves, faucetsOf } from './registry.js';
+function faucetNodeId(valve, target) {
+    return `${valve}::${target}`;
+}
+/** Assemble the valve graph from every registered valve and faucet. */
+export function buildValveGraph() {
+    const nodes = new Map();
+    const edges = [];
+    for (const [name, definition] of valves()) {
+        nodes.set(name, { id: name, kind: definition.kind === 'transition-gate' ? 'gate' : 'supply' });
+        const consumers = faucetsOf(name);
+        for (const consumer of consumers) {
+            const faucetId = faucetNodeId(name, consumer.target);
+            nodes.set(faucetId, { id: faucetId, kind: 'faucet' });
+            edges.push({ kind: 'crossing', from: name, to: faucetId });
+        }
+        if (definition.kind === 'transition-gate') {
+            const gateDef = definition;
+            for (const inbound of Object.values(gateDef.context)) {
+                edges.push({ kind: 'context', from: name, to: inbound });
+            }
+            if (gateDef.retraction !== undefined) {
+                for (const consumer of consumers) {
+                    edges.push({ kind: 'retraction', from: name, to: faucetNodeId(name, consumer.target) });
+                }
+            }
+        }
+    }
+    return { nodes: [...nodes.values()], edges };
+}
+/** Faucet node ids fed by the named valve — the direct downstream of a crossing. */
+export function downstreamFaucets(graph, valveName) {
+    return graph.edges
+        .filter((edge) => edge.kind === 'crossing' && edge.from === valveName)
+        .map((edge) => edge.to);
+}
+/** Gate valve names whose enrichment context depends on the named valve. */
+export function contextDependents(graph, valveName) {
+    return graph.edges
+        .filter((edge) => edge.kind === 'context' && edge.to === valveName)
+        .map((edge) => edge.from);
+}
+//# sourceMappingURL=graph.js.map

package/dist/data/valve/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/data/valve/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA6BjD,SAAS,YAAY,CAAC,KAAa,EAAE,MAAc;IACjD,OAAO,GAAG,KAAK,KAAK,MAAM,EAAE,CAAA;AAC9B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC/C,MAAM,KAAK,GAAqB,EAAE,CAAA;IAElC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC;QAC1C,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QAE9F,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QACjC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;YACpD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;YACrD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,IAAI,UAAU,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,UAAqC,CAAA;YACrD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;YAC1D,CAAC;YACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACrC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBACzF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAA;AAC9C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,SAAiB;IACpE,OAAO,KAAK,CAAC,KAAK;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;SACrE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC3B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,SAAiB;IACpE,OAAO,KAAK,CAAC,KAAK;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;SAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC"}

package/dist/data/valve/index.d.ts

@@ -0,0 +1,24 @@
+export { cross, held, failed } from './decision.js';
+export type { Crossed, Held, Failed, DecisionOutcome } from './decision.js';
+export { registerValve, valves, getValve, registerFaucet, faucetsOf, clearValveRegistry, } from './registry.js';
+export { supply } from './supply.js';
+export type { SupplyBuilder } from './supply.js';
+export { gate } from './gate.js';
+export type { GateBuilder } from './gate.js';
+export { faucet } from './faucet.js';
+export type { FaucetBuilder } from './faucet.js';
+export { crossSupply, crossGate } from './cross.js';
+export { executeSupplyCrossing, executeGateCrossing } from './execute-crossing.js';
+export { enqueueCrossing, runCrossingJob, VALVE_CROSSING_JOB_TYPE } from './durable-crossing.js';
+export type { CrossingJobPayload } from './durable-crossing.js';
+export { recordCrossing, findCrossing } from './crossing-ledger.js';
+export type { CrossingRecord } from './crossing-ledger.js';
+export { valveCrossing } from './schema/valve-crossing.js';
+export { buildValveGraph, downstreamFaucets, contextDependents } from './graph.js';
+export type { ValveGraph, ValveGraphNode, ValveGraphEdge, ValveNodeKind, ValveEdgeKind } from './graph.js';
+export { diffContract } from './contract-diff.js';
+export type { ContractDiff } from './contract-diff.js';
+export { emitArtifact } from './artifact.js';
+export type { ContractArtifact } from './artifact.js';
+export type { ValveKind, ValveTopology, ValveDefinition, HandoffTrigger, CrossingMode, ContractShape, ContractPayload, SupplyDefinition, GateTrigger, GateRetraction, GateDecision, GateDefinition, FaucetHandler, FaucetDefinition, CrossedResult, BlockedResult, HeldResult, FailedResult, SkippedResult, SupplyCrossingResult, GateCrossingResult, CrossingResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/valve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/valve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACnD,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3E,OAAO,EACL,aAAa,EACb,MAAM,EACN,QAAQ,EACR,cAAc,EACd,SAAS,EACT,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAChG,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAClF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1G,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,YAAY,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/data/valve/index.js

@@ -0,0 +1,14 @@
+export { cross, held, failed } from './decision.js';
+export { registerValve, valves, getValve, registerFaucet, faucetsOf, clearValveRegistry, } from './registry.js';
+export { supply } from './supply.js';
+export { gate } from './gate.js';
+export { faucet } from './faucet.js';
+export { crossSupply, crossGate } from './cross.js';
+export { executeSupplyCrossing, executeGateCrossing } from './execute-crossing.js';
+export { enqueueCrossing, runCrossingJob, VALVE_CROSSING_JOB_TYPE } from './durable-crossing.js';
+export { recordCrossing, findCrossing } from './crossing-ledger.js';
+export { valveCrossing } from './schema/valve-crossing.js';
+export { buildValveGraph, downstreamFaucets, contextDependents } from './graph.js';
+export { diffContract } from './contract-diff.js';
+export { emitArtifact } from './artifact.js';
+//# sourceMappingURL=index.js.map

package/dist/data/valve/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data/valve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EACL,aAAa,EACb,MAAM,EACN,QAAQ,EACR,cAAc,EACd,SAAS,EACT,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEhG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/data/valve/namespace.d.ts

@@ -0,0 +1,57 @@
+import { supply } from './supply.js';
+import { gate } from './gate.js';
+import { faucet } from './faucet.js';
+import { cross, held, failed } from './decision.js';
+import { crossSupply, crossGate } from './cross.js';
+import { executeSupplyCrossing, executeGateCrossing } from './execute-crossing.js';
+import { enqueueCrossing, runCrossingJob } from './durable-crossing.js';
+import { buildValveGraph, downstreamFaucets, contextDependents } from './graph.js';
+import { diffContract } from './contract-diff.js';
+import { emitArtifact } from './artifact.js';
+import { valves, getValve, faucetsOf } from './registry.js';
+/** Valve namespace — typed, directional, gated boundaries between code silos. */
+export declare const valve: {
+    /** Declare a handoff valve — the producer side of a payload crossing. */
+    supply: typeof supply;
+    /** Declare a transition-gate valve — the producer side of a gated state change. */
+    gate: typeof gate;
+    /** Declare a faucet — the consumer side of a `supply -> faucet` edge. */
+    faucet: typeof faucet;
+    /** Decision outcome: cross the valve, delivering the payload. */
+    cross: typeof cross;
+    /** Decision outcome: hold the crossing in a provisional, reviewable state. */
+    held: typeof held;
+    /** Decision outcome: evaluation failed — retryable, never a thrown exception. */
+    failed: typeof failed;
+    /** Execute a handoff crossing in the caller's transaction (unrecorded mechanics). */
+    crossSupply: typeof crossSupply;
+    /** Execute a transition-gate crossing (unrecorded mechanics). */
+    crossGate: typeof crossGate;
+    /** Execute a handoff crossing with idempotency and provenance recording. */
+    executeSupplyCrossing: typeof executeSupplyCrossing;
+    /** Execute a transition-gate crossing with provenance recording. */
+    executeGateCrossing: typeof executeGateCrossing;
+    /** Enqueue a handoff crossing to run durably as a retried, dead-letterable job. */
+    enqueueCrossing: typeof enqueueCrossing;
+    /** The durable-crossing job-handler body — wire into a worker. */
+    runCrossingJob: typeof runCrossingJob;
+    /** Job type for a durable valve crossing. */
+    VALVE_CROSSING_JOB_TYPE: string;
+    /** Assemble the directional valve graph from every registered valve and faucet. */
+    graph: typeof buildValveGraph;
+    /** The faucet nodes a valve feeds. */
+    downstreamFaucets: typeof downstreamFaucets;
+    /** The gates whose enrichment context depends on a valve. */
+    contextDependents: typeof contextDependents;
+    /** Diff a valve contract between two versions. */
+    diffContract: typeof diffContract;
+    /** Project a handoff supply to its lightweight contract artifact. */
+    emitArtifact: typeof emitArtifact;
+    /** All registered producer valves, keyed by name. */
+    valves: typeof valves;
+    /** Look up a registered valve by name. */
+    getValve: typeof getValve;
+    /** The faucets consuming a named valve. */
+    faucetsOf: typeof faucetsOf;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/data/valve/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/data/valve/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,eAAe,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE3D,iFAAiF;AACjF,eAAO,MAAM,KAAK;IAChB,yEAAyE;;IAEzE,mFAAmF;;IAEnF,yEAAyE;;IAEzE,iEAAiE;;IAEjE,8EAA8E;;IAE9E,iFAAiF;;IAEjF,qFAAqF;;IAErF,iEAAiE;;IAEjE,4EAA4E;;IAE5E,oEAAoE;;IAEpE,mFAAmF;;IAEnF,kEAAkE;;IAElE,6CAA6C;;IAE7C,mFAAmF;;IAEnF,sCAAsC;;IAEtC,6DAA6D;;IAE7D,kDAAkD;;IAElD,qEAAqE;;IAErE,qDAAqD;;IAErD,0CAA0C;;IAE1C,2CAA2C;;CAE5C,CAAA"}

package/dist/data/valve/namespace.js

@@ -0,0 +1,57 @@
+import { supply } from './supply.js';
+import { gate } from './gate.js';
+import { faucet } from './faucet.js';
+import { cross, held, failed } from './decision.js';
+import { crossSupply, crossGate } from './cross.js';
+import { executeSupplyCrossing, executeGateCrossing } from './execute-crossing.js';
+import { enqueueCrossing, runCrossingJob, VALVE_CROSSING_JOB_TYPE } from './durable-crossing.js';
+import { buildValveGraph, downstreamFaucets, contextDependents } from './graph.js';
+import { diffContract } from './contract-diff.js';
+import { emitArtifact } from './artifact.js';
+import { valves, getValve, faucetsOf } from './registry.js';
+/** Valve namespace — typed, directional, gated boundaries between code silos. */
+export const valve = {
+    /** Declare a handoff valve — the producer side of a payload crossing. */
+    supply,
+    /** Declare a transition-gate valve — the producer side of a gated state change. */
+    gate,
+    /** Declare a faucet — the consumer side of a `supply -> faucet` edge. */
+    faucet,
+    /** Decision outcome: cross the valve, delivering the payload. */
+    cross,
+    /** Decision outcome: hold the crossing in a provisional, reviewable state. */
+    held,
+    /** Decision outcome: evaluation failed — retryable, never a thrown exception. */
+    failed,
+    /** Execute a handoff crossing in the caller's transaction (unrecorded mechanics). */
+    crossSupply,
+    /** Execute a transition-gate crossing (unrecorded mechanics). */
+    crossGate,
+    /** Execute a handoff crossing with idempotency and provenance recording. */
+    executeSupplyCrossing,
+    /** Execute a transition-gate crossing with provenance recording. */
+    executeGateCrossing,
+    /** Enqueue a handoff crossing to run durably as a retried, dead-letterable job. */
+    enqueueCrossing,
+    /** The durable-crossing job-handler body — wire into a worker. */
+    runCrossingJob,
+    /** Job type for a durable valve crossing. */
+    VALVE_CROSSING_JOB_TYPE,
+    /** Assemble the directional valve graph from every registered valve and faucet. */
+    graph: buildValveGraph,
+    /** The faucet nodes a valve feeds. */
+    downstreamFaucets,
+    /** The gates whose enrichment context depends on a valve. */
+    contextDependents,
+    /** Diff a valve contract between two versions. */
+    diffContract,
+    /** Project a handoff supply to its lightweight contract artifact. */
+    emitArtifact,
+    /** All registered producer valves, keyed by name. */
+    valves,
+    /** Look up a registered valve by name. */
+    getValve,
+    /** The faucets consuming a named valve. */
+    faucetsOf,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/data/valve/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/data/valve/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE3D,iFAAiF;AACjF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,yEAAyE;IACzE,MAAM;IACN,mFAAmF;IACnF,IAAI;IACJ,yEAAyE;IACzE,MAAM;IACN,iEAAiE;IACjE,KAAK;IACL,8EAA8E;IAC9E,IAAI;IACJ,iFAAiF;IACjF,MAAM;IACN,qFAAqF;IACrF,WAAW;IACX,iEAAiE;IACjE,SAAS;IACT,4EAA4E;IAC5E,qBAAqB;IACrB,oEAAoE;IACpE,mBAAmB;IACnB,mFAAmF;IACnF,eAAe;IACf,kEAAkE;IAClE,cAAc;IACd,6CAA6C;IAC7C,uBAAuB;IACvB,mFAAmF;IACnF,KAAK,EAAE,eAAe;IACtB,sCAAsC;IACtC,iBAAiB;IACjB,6DAA6D;IAC7D,iBAAiB;IACjB,kDAAkD;IAClD,YAAY;IACZ,qEAAqE;IACrE,YAAY;IACZ,qDAAqD;IACrD,MAAM;IACN,0CAA0C;IAC1C,QAAQ;IACR,2CAA2C;IAC3C,SAAS;CACV,CAAA"}