@nwire/hooks 0.7.0 → 0.8.0

package/dist/hook.d.ts

@@ -5,30 +5,47 @@
  * attachments. `.run()` fires the chain first (sequential, can short-circuit),
  * then fires listeners in parallel via Promise.allSettled.
  *
- * Behavior matrix is locked by architecture-sketch.html §07.
+ * On top of that core, every hook is:
+ *   - introspectable      — listed by `listHooks()`, keyed by `id` + `name`
+ *   - traceable           — `.tap()` receives a StepObservation per phase
+ *   - linked              — nested runs auto-pick a `parentRunId`
+ *   - source-located      — `hook("x")` captures its call site
+ *   - cancellable         — `.run(ctx, { signal })` propagates an AbortSignal
+ *   - prioritised         — `.use(fn, { priority })` orders the chain
+ *   - filterable          — `.on(fn, { when: "success" | "failure" })`
+ *   - replayable          — `.runDetailed()` returns the full step trace
+ */
+import type { ChainFn, HookOptions, ListenerFn, OnOptions, RunOptions, RunResult, TapFn, UseOptions } from "./types.js";
+/**
+ * The public Hook surface.
+ *
+ * The signatures stay backward-compatible: `.use(fn)`, `.on(fn)`, `.run(ctx)`
+ * work exactly as before. Each method accepts new optional arguments —
+ * priority, name, when, signal — that opt into the richer behavior.
  */
-import type { ChainFn, HookOptions, ListenerFn } from "./types.js";
-/** The public Hook surface. See architecture-sketch.html §06. */
 export interface Hook<Ctx> {
     /** Hook name. Stable for logging + telemetry. */
     readonly name: string;
+    /** Process-wide unique id for this hook instance. */
+    readonly id: string;
     /** Attach a chain middleware (sequential, can short-circuit). */
-    use(fn: ChainFn<Ctx>): this;
+    use(fn: ChainFn<Ctx>, opts?: UseOptions): this;
     /** Attach a listener (parallel, observes final ctx, cannot mutate). */
-    on(fn: ListenerFn<Ctx>): this;
+    on(fn: ListenerFn<Ctx>, opts?: OnOptions): this;
     /** Detach a previously attached `.use()` or `.on()` fn. No-op if unknown. */
     off(fn: ChainFn<Ctx> | ListenerFn<Ctx>): this;
     /** Run the chain, then fire listeners. Returns the (possibly mutated) ctx. */
-    run(ctx: Ctx): Promise<Ctx>;
+    run(ctx: Ctx, opts?: RunOptions): Promise<Ctx>;
+    /** Same as `.run()`, but returns the full observation trace + outcome. */
+    runDetailed(ctx: Ctx, opts?: RunOptions): Promise<RunResult<Ctx>>;
+    /** Subscribe to per-step observations. Returns an unsubscribe handle. */
+    tap(observer: TapFn): () => void;
+    /** Step counts — `{ chain, listeners }`. Used by the registry + tests. */
+    stepCounts(): {
+        readonly chain: number;
+        readonly listeners: number;
+    };
 }
-/**
- * Create a new hook.
- *
- * @example
- *   const request = hook<RequestCtx>("http.request");
- *   request.use(async (ctx, next) => { ctx.start = Date.now(); await next(); });
- *   request.on(async (ctx) => { await analytics.track(ctx); });
- *   await request.run(ctx);
- */
+/** Create a new hook. */
 export declare function hook<Ctx>(name: string, options?: HookOptions<Ctx>): Hook<Ctx>;
 //# sourceMappingURL=hook.d.ts.map

package/dist/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAWhE,iEAAiE;AACjE,MAAM,WAAW,IAAI,CAAC,GAAG;IACvB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAE5B,uEAAuE;IACvE,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAE9B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAE9C,8EAA8E;IAC9E,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAW,CAAC,GAAG,CAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAEjF"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EAEV,SAAS,EAET,KAAK,EACL,UAAU,EACX,MAAM,SAAS,CAAC;AAIjB;;;;;;GAMG;AACH,MAAM,WAAW,IAAI,CAAC,GAAG;IACvB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAI,MAAM,CAAC;IAEtB,iEAAiE;IACjE,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAE/C,uEAAuE;IACvE,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEhD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAE9C,8EAA8E;IAC9E,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/C,0EAA0E;IAC1E,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAElE,yEAAyE;IACzE,GAAG,CAAC,QAAQ,EAAE,KAAK,GAAG,MAAM,IAAI,CAAC;IAEjC,0EAA0E;IAC1E,UAAU,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,yBAAyB;AACzB,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAW,CAAC,GAAG,CAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAKjF"}

package/dist/hook.js

@@ -5,144 +5,244 @@
  * attachments. `.run()` fires the chain first (sequential, can short-circuit),
  * then fires listeners in parallel via Promise.allSettled.
  *
- * Behavior matrix is locked by architecture-sketch.html §07.
+ * On top of that core, every hook is:
+ *   - introspectable      — listed by `listHooks()`, keyed by `id` + `name`
+ *   - traceable           — `.tap()` receives a StepObservation per phase
+ *   - linked              — nested runs auto-pick a `parentRunId`
+ *   - source-located      — `hook("x")` captures its call site
+ *   - cancellable         — `.run(ctx, { signal })` propagates an AbortSignal
+ *   - prioritised         — `.use(fn, { priority })` orders the chain
+ *   - filterable          — `.on(fn, { when: "success" | "failure" })`
+ *   - replayable          — `.runDetailed()` returns the full step trace
  */
 import Emittery from "emittery";
 import { compose } from "./compose.js";
-/**
- * Internal emittery event name. We piggy-back on emittery for typed
- * subscription bookkeeping (and as the documented foundation of @nwire/hooks),
- * but we iterate listeners ourselves via a parallel Set so we can apply the
- * contract-mandated `Promise.allSettled` semantics — emittery's `.emit()`
- * uses Promise.all which fails fast on the first rejection.
- */
+import { captureSourceLocation, nextHookId, nextRunId, registerHook, withRunContext, currentRun, } from "./registry.js";
 const RUN_EVENT = "__nwire_hooks_run__";
-/**
- * Create a new hook.
- *
- * @example
- *   const request = hook<RequestCtx>("http.request");
- *   request.use(async (ctx, next) => { ctx.start = Date.now(); await next(); });
- *   request.on(async (ctx) => { await analytics.track(ctx); });
- *   await request.run(ctx);
- */
+/** Create a new hook. */
 export function hook(name, options = {}) {
-    return new HookImpl(name, options);
+    const source = captureSourceLocation(2);
+    const h = new HookImpl(name, options);
+    registerHook(h, source);
+    return h;
 }
 class HookImpl {
     name;
+    id;
     chain = [];
-    /** Iteration store — we run these in parallel via Promise.allSettled. */
-    listeners = new Set();
-    /** Bookkeeping mirror — emittery is the documented foundation. */
+    listeners = [];
     emitter = new Emittery();
-    /** Map user fn → emittery-shaped adapter, for `.off()`. */
-    adapters = new WeakMap();
+    taps = new Set();
+    stepCounter = 0;
     strictListeners;
     onListenerError;
     constructor(name, options) {
         this.name = name;
+        this.id = nextHookId();
         this.strictListeners = options.strictListeners === true;
         this.onListenerError =
             options.onListenerError ??
                 ((err, _ctx, hookName) => {
-                    // Conservative default — log + continue. Hosts (createHooks)
-                    // override this to route through their `lifecycle.error` hook.
                     // eslint-disable-next-line no-console
                     console.error(`[@nwire/hooks] listener error in "${hookName}":`, err);
                 });
     }
-    use(fn) {
-        this.chain.push(fn);
+    stepCounts() {
+        return { chain: this.chain.length, listeners: this.listeners.length };
+    }
+    use(fn, opts) {
+        const entry = {
+            fn,
+            stepId: this.stepCounter++,
+            name: opts?.name,
+            priority: opts?.priority ?? 0,
+        };
+        this.chain.push(entry);
+        // Higher priority runs first (outermost). Stable sort preserves insertion
+        // order for equal priorities.
+        this.chain.sort((a, b) => b.priority - a.priority || a.stepId - b.stepId);
         return this;
     }
-    on(fn) {
-        if (this.listeners.has(fn))
+    on(fn, opts) {
+        if (this.listeners.find((l) => l.fn === fn))
             return this;
-        this.listeners.add(fn);
-        const adapter = async (ctx) => {
-            await fn(ctx);
+        const adapter = async (ctx) => { await fn(ctx); };
+        const entry = {
+            fn,
+            stepId: this.stepCounter++,
+            name: opts?.name,
+            priority: opts?.priority ?? 0,
+            when: opts?.when ?? "always",
+            adapter,
         };
-        this.adapters.set(fn, adapter);
+        this.listeners.push(entry);
+        this.listeners.sort((a, b) => b.priority - a.priority || a.stepId - b.stepId);
         this.emitter.on(RUN_EVENT, adapter);
         return this;
     }
     off(fn) {
-        // Try chain first.
-        const chainIdx = this.chain.indexOf(fn);
+        const chainIdx = this.chain.findIndex((c) => c.fn === fn);
         if (chainIdx >= 0) {
             this.chain.splice(chainIdx, 1);
             return this;
         }
-        // Otherwise treat as listener.
-        const listenerFn = fn;
-        if (this.listeners.delete(listenerFn)) {
-            const adapter = this.adapters.get(listenerFn);
-            if (adapter) {
-                this.emitter.off(RUN_EVENT, adapter);
-                this.adapters.delete(listenerFn);
-            }
+        const listenerIdx = this.listeners.findIndex((l) => l.fn === fn);
+        if (listenerIdx >= 0) {
+            const entry = this.listeners[listenerIdx];
+            this.emitter.off(RUN_EVENT, entry.adapter);
+            this.listeners.splice(listenerIdx, 1);
         }
         return this;
     }
-    async run(ctx) {
-        // 1. Run the chain. If it throws, capture before listeners fire so they
-        //    can observe the failure mode via ctx.error.
-        const composed = compose(this.chain);
-        let chainError = undefined;
-        try {
-            await composed(ctx, async () => {
-                // Tail — nothing to do. The chain itself decides whether to call
-                // next() or short-circuit.
-            });
-        }
-        catch (err) {
-            chainError = err;
-            // Stash on ctx so listeners can observe failure mode. Mutating even
-            // when `Ctx` doesn't declare an `error` field is the documented
-            // contract (§07 row 2 + row 11).
-            ctx.error = err;
+    tap(observer) {
+        this.taps.add(observer);
+        return () => { this.taps.delete(observer); };
+    }
+    async run(ctx, opts) {
+        const result = await this.runDetailed(ctx, opts);
+        if (result.outcome === "failed" && result.error !== undefined) {
+            throw result.error;
         }
-        // 2. Fire listeners in parallel via Promise.allSettled — contract row 4.
-        if (this.listeners.size > 0) {
-            const snapshot = Array.from(this.listeners);
-            const results = await Promise.allSettled(snapshot.map(async (listener) => listener(ctx)));
-            const failures = results.filter((r) => r.status === "rejected");
-            if (failures.length > 0) {
-                if (this.strictListeners) {
-                    // Strict mode: opt-in escape hatch (§07 closing note). Surface
-                    // the first failure; attach the rest via `cause` for debug.
-                    const primary = failures[0].reason;
-                    if (failures.length > 1 &&
-                        primary instanceof Error &&
-                        primary.cause === undefined) {
-                        Object.defineProperty(primary, "cause", {
-                            value: failures.slice(1).map((f) => f.reason),
-                            configurable: true,
-                            writable: true,
-                        });
-                    }
-                    throw primary;
-                }
-                // Default mode: report each, never fail the run.
-                for (const failure of failures) {
-                    try {
-                        this.onListenerError(failure.reason, ctx, this.name);
-                    }
-                    catch {
-                        // Reporter itself blew up — swallow. Listener-error reporting
-                        // must never crash the hook.
-                    }
+        return result.ctx;
+    }
+    async runDetailed(ctx, opts) {
+        const runId = nextRunId();
+        const parentRunId = opts?.parentRunId ?? currentRun()?.runId;
+        const signal = opts?.signal;
+        const steps = [];
+        const startedAt = nowMs();
+        const emit = (obs) => {
+            steps.push(obs);
+            for (const tap of this.taps) {
+                try {
+                    tap(obs);
                 }
+                catch { /* tap throws are swallowed */ }
+            }
+        };
+        // Inject abort signal onto ctx (only if ctx is an object). Domain code
+        // can read `ctx.signal` to bail early. We don't overwrite a user-provided
+        // signal on ctx; user wins.
+        if (signal && ctx && typeof ctx === "object" && !ctx.signal) {
+            ctx.signal = signal;
+        }
+        const composed = compose(this.chain.map((entry) => wrapChain(this, entry, runId, parentRunId, signal, emit)));
+        // A chain step that doesn't call its `next()` short-circuits — the tail
+        // is the only place that *reliably* signals "every step yielded down to
+        // me." We toggle a flag inside the tail; if it stays false after the
+        // compose resolves without throwing, the chain was prevented.
+        let chainError = undefined;
+        let reachedTail = false;
+        await withRunContext({ runId, hookId: this.id, parentRunId }, async () => {
+            try {
+                await composed(ctx, async () => { reachedTail = true; });
+            }
+            catch (err) {
+                chainError = err;
+                ctx.error = err;
+            }
+        });
+        // Empty chain — nothing to short-circuit, treat as completed.
+        if (this.chain.length === 0)
+            reachedTail = true;
+        const outcome = chainError !== undefined ? "failed" : reachedTail ? "completed" : "prevented";
+        await this.fireListeners(ctx, outcome, runId, parentRunId, emit);
+        return {
+            ctx,
+            outcome,
+            runId,
+            parentRunId,
+            steps,
+            durationMs: nowMs() - startedAt,
+            error: chainError,
+        };
+    }
+    async fireListeners(ctx, outcome, runId, parentRunId, emit) {
+        const eligible = this.listeners.filter((l) => {
+            if (l.when === "always")
+                return true;
+            if (l.when === "success")
+                return outcome === "completed";
+            if (l.when === "failure")
+                return outcome === "failed";
+            return true;
+        });
+        if (eligible.length === 0)
+            return;
+        const results = await Promise.allSettled(eligible.map(async (entry) => {
+            const startTs = nowMs();
+            emit(makeObs(this, entry.stepId, "listener", entry.name, "start", startTs, runId, parentRunId));
+            try {
+                await entry.fn(ctx);
+                emit(makeObs(this, entry.stepId, "listener", entry.name, "end", nowMs(), runId, parentRunId, nowMs() - startTs));
+            }
+            catch (err) {
+                emit(makeObs(this, entry.stepId, "listener", entry.name, "error", nowMs(), runId, parentRunId, nowMs() - startTs, err));
+                throw err;
+            }
+        }));
+        const failures = results.filter((r) => r.status === "rejected");
+        if (failures.length === 0)
+            return;
+        if (this.strictListeners) {
+            const primary = failures[0].reason;
+            if (failures.length > 1 &&
+                primary instanceof Error &&
+                primary.cause === undefined) {
+                Object.defineProperty(primary, "cause", {
+                    value: failures.slice(1).map((f) => f.reason),
+                    configurable: true,
+                    writable: true,
+                });
             }
+            throw primary;
         }
-        // 3. Propagate chain failure to the caller of `.run()`. Listeners have
-        //    already observed it via ctx.error; this is the actionable signal
-        //    for whatever called the hook.
-        if (chainError !== undefined) {
-            throw chainError;
+        for (const f of failures) {
+            try {
+                this.onListenerError(f.reason, ctx, this.name);
+            }
+            catch { /* reporter blew up — swallow */ }
         }
-        return ctx;
     }
 }
+// ─── Helpers ──────────────────────────────────────────────────────────
+function wrapChain(hook, entry, runId, parentRunId, signal, emit) {
+    return async function instrumented(ctx, next) {
+        if (signal?.aborted) {
+            throw signal.reason ?? new Error("hook aborted");
+        }
+        const startTs = nowMs();
+        emit(makeObs(hook, entry.stepId, "chain", entry.name, "start", startTs, runId, parentRunId));
+        try {
+            await entry.fn(ctx, next);
+            const endTs = nowMs();
+            emit(makeObs(hook, entry.stepId, "chain", entry.name, "end", endTs, runId, parentRunId, endTs - startTs));
+        }
+        catch (err) {
+            const endTs = nowMs();
+            emit(makeObs(hook, entry.stepId, "chain", entry.name, "error", endTs, runId, parentRunId, endTs - startTs, err));
+            throw err;
+        }
+    };
+}
+function makeObs(hook, stepId, stepKind, stepName, phase, ts, runId, parentRunId, durationMs, error) {
+    return {
+        hookName: hook.name,
+        hookId: hook.id,
+        runId,
+        parentRunId,
+        stepId,
+        stepKind,
+        stepName,
+        phase,
+        ts,
+        durationMs,
+        error,
+    };
+}
+// performance.now() is available in Node 16+; fall back to Date.now() only
+// if a host VM lacks it (vitest can stub it).
+const nowMs = typeof performance !== "undefined" && typeof performance.now === "function"
+    ? () => performance.now()
+    : () => Date.now();
 //# sourceMappingURL=hook.js.map

package/dist/hook.js.map

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

package/dist/index.d.ts

@@ -1,13 +1,18 @@
 /**
- * @nwire/hooks — the universal dispatch primitive
+ * @nwire/hooks — the universal dispatch primitive.
  *
- * One `hook()` accepts BOTH `.use()` (chain) and `.on()` (parallel listener)
- * attachments. Chain runs first (sequential, can short-circuit), then listeners
- * fire in parallel via Promise.allSettled. See architecture-sketch.html §06–§07.
+ * One `hook()` accepts both `.use()` (chain middleware) and `.on()` (parallel
+ * listener) attachments. Every run is observable end-to-end via `.tap()`,
+ * yields a runId that links nested runs into a topology tree, and can be
+ * recorded for replay.
+ *
+ * See README.md for the full contract + recipes.
  */
 export { hook, type Hook } from "./hook.js";
-export { createHooks, type Host, type HookMap, type Plugin, type PluginEntry } from "./create-hooks.js";
+export { createHooks, type Host, type HookMap, type Plugin, type PluginEntry, } from "./create-hooks.js";
 export { compose } from "./compose.js";
 export { pipe, withTimeout, withRetry } from "./pipe.js";
-export type { ChainFn, HookOptions, ListenerFn, RetryOpts } from "./types.js";
+export { record, replay, type RecordOptions, type ReplayResult } from "./record.js";
+export { listHooks, currentRun, captureSourceLocation, } from "./registry.js";
+export type { ChainFn, HookOptions, ListenerFn, OnOptions, Recording, RetryOpts, RunOptions, RunOutcome, RunResult, SourceLocation, StepKind, StepObservation, StepPhase, TapFn, UseOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACtD,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EACL,WAAW,EACX,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EACL,SAAS,EACT,UAAU,EACV,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,OAAO,EACP,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,QAAQ,EACR,eAAe,EACf,SAAS,EACT,KAAK,EACL,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,12 +1,17 @@
 /**
- * @nwire/hooks — the universal dispatch primitive
+ * @nwire/hooks — the universal dispatch primitive.
  *
- * One `hook()` accepts BOTH `.use()` (chain) and `.on()` (parallel listener)
- * attachments. Chain runs first (sequential, can short-circuit), then listeners
- * fire in parallel via Promise.allSettled. See architecture-sketch.html §06–§07.
+ * One `hook()` accepts both `.use()` (chain middleware) and `.on()` (parallel
+ * listener) attachments. Every run is observable end-to-end via `.tap()`,
+ * yields a runId that links nested runs into a topology tree, and can be
+ * recorded for replay.
+ *
+ * See README.md for the full contract + recipes.
  */
 export { hook } from "./hook.js";
-export { createHooks } from "./create-hooks.js";
+export { createHooks, } from "./create-hooks.js";
 export { compose } from "./compose.js";
 export { pipe, withTimeout, withRetry } from "./pipe.js";
+export { record, replay } from "./record.js";
+export { listHooks, currentRun, captureSourceLocation, } from "./registry.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAa,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,WAAW,EAA0D,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAa,MAAM,QAAQ,CAAC;AACzC,OAAO,EACL,WAAW,GAKZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAyC,MAAM,UAAU,CAAC;AACjF,OAAO,EACL,SAAS,EACT,UAAU,EACV,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/record.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Recording + replay.
+ *
+ * Recording a hook run produces a {@link Recording} — the full step trace
+ * plus user-supplied ctx snapshots taken before and after. Replays the
+ * recording later (or in another process) and assert step-by-step shape
+ * matches. This is the substrate Studio's "replay this trace" button and
+ * the deterministic debug flow are built on.
+ *
+ * Two scopes:
+ *
+ *   record(hook, ctx, opts?)      one-shot: run the hook, snapshot ctx, return Recording
+ *   replay(hook, recording, opts) re-run with the recorded ctxIn; compare shapes
+ *
+ * The clone strategy is pluggable; default is `structuredClone`. Pass
+ * `clone: (x) => JSON.parse(JSON.stringify(x))` for non-clonable shapes.
+ */
+import type { Hook } from "./hook.js";
+import type { Recording, RunOptions } from "./types.js";
+export interface RecordOptions extends RunOptions {
+    /** Custom ctx-cloner for snapshotting. Default: `structuredClone`. */
+    readonly clone?: <T>(ctx: T) => T;
+}
+/**
+ * Run the hook once, capture ctx-in/out + every observation. Result is a
+ * self-contained {@link Recording} that can be persisted (JSON-safe if the
+ * caller's clone yields JSON-safe shapes), shipped to Studio, or fed back
+ * into `replay()`.
+ */
+export declare function record<Ctx>(hook: Hook<Ctx>, ctx: Ctx, opts?: RecordOptions): Promise<Recording>;
+/** Comparison result returned by {@link replay}. */
+export interface ReplayResult<Ctx> {
+    readonly matches: boolean;
+    readonly drift: ReadonlyArray<string>;
+    readonly recorded: Recording;
+    readonly replayed: {
+        readonly ctx: Ctx;
+        readonly stepCount: number;
+        readonly outcome: string;
+    };
+}
+/**
+ * Replay a recording. Re-runs the hook with `recording.ctxIn` (cloned),
+ * compares the resulting step sequence + outcome against the recording,
+ * and reports drift. This is observational — it does not stub side effects.
+ * Pure / idempotent chains should match; non-deterministic chains report
+ * their drift so a human can decide whether it's expected.
+ */
+export declare function replay<Ctx>(hook: Hook<Ctx>, recording: Recording, opts?: RecordOptions): Promise<ReplayResult<Ctx>>;
+//# sourceMappingURL=record.d.ts.map

package/dist/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;CACnC;AAQD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAC9B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,GAAG,EAAE,GAAG,EACR,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,SAAS,CAAC,CAepB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY,CAAC,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAK,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChG;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAC9B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,SAAS,EAAE,SAAS,EACpB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAoC5B"}