@kraken-e2e/signaling 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+import type { SignalRecord, SignalScope } from './types.js';
+export interface SignalTimeoutDetail {
+    readonly scope: SignalScope;
+    /** Unknown at transport level; the SignalBus enriches it. */
+    readonly subscriberId?: string | undefined;
+    readonly signalName: string;
+    readonly timeoutMs: number;
+    /** The cursor (afterSeq) the wait was issued with. */
+    readonly cursor: number;
+    /** Everything published in the scope so far — the "what actually happened" dump. */
+    readonly historySnapshot: readonly SignalRecord[];
+    /** Signal names in the scope within edit distance 2 of the waited name (typo diagnosis). */
+    readonly nearMissNames: readonly string[];
+}
+/** A waited-for signal never arrived within the budget. This is a TEST failure. */
+export declare class SignalTimeoutError extends Error {
+    readonly name = "SignalTimeoutError";
+    readonly detail: SignalTimeoutDetail;
+    constructor(detail: SignalTimeoutDetail);
+}
+/** The scope was destroyed (or never created); the operation cannot proceed. */
+export declare class ScopeClosedError extends Error {
+    readonly name = "ScopeClosedError";
+    constructor(scope: SignalScope, operation: string);
+}
+/** A pending wait was cancelled through its AbortSignal (e.g. failFast teardown). */
+export declare class SignalWaitAbortedError extends Error {
+    readonly name = "SignalWaitAbortedError";
+    constructor(signalName: string);
+}
+/** Infrastructure failure (transport down/unreachable). NOT a test failure. */
+export declare class TransportUnavailableError extends Error {
+    readonly name = "TransportUnavailableError";
+}
+/** The payload is not JSON-serializable or exceeds the configured size cap. */
+export declare class SignalPayloadError extends Error {
+    readonly name = "SignalPayloadError";
+}
+/** API misuse (e.g. two concurrent identical waits by one subscriber — ADR-0003 D3). */
+export declare class SignalUsageError extends Error {
+    readonly name = "SignalUsageError";
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC;IAClD,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,mFAAmF;AACnF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;gBAEzB,MAAM,EAAE,mBAAmB;CAkBxC;AAED,gFAAgF;AAChF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAkB,IAAI,sBAAsB;gBAEhC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;CAMlD;AAED,qFAAqF;AACrF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,4BAA4B;gBAEtC,UAAU,EAAE,MAAM;CAG/B;AAED,+EAA+E;AAC/E,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;CACtD;AAED,+EAA+E;AAC/E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;CAC/C;AAED,wFAAwF;AACxF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAkB,IAAI,sBAAsB;CAC7C"}

package/dist/errors.js

@@ -0,0 +1,47 @@
+/** A waited-for signal never arrived within the budget. This is a TEST failure. */
+export class SignalTimeoutError extends Error {
+    name = 'SignalTimeoutError';
+    detail;
+    constructor(detail) {
+        const who = detail.subscriberId ? `subscriber "${detail.subscriberId}"` : 'a subscriber';
+        const seen = detail.historySnapshot.length === 0
+            ? 'No signals were published in this scope.'
+            : `Signals published so far: ${detail.historySnapshot
+                .map((r) => `"${r.name}" by ${r.from} (seq ${r.seq})`)
+                .join(', ')}.`;
+        const nearMiss = detail.nearMissNames.length > 0
+            ? ` Did you mean ${detail.nearMissNames.map((n) => `"${n}"`).join(' or ')}?`
+            : '';
+        super(`Timed out after ${detail.timeoutMs}ms: ${who} was waiting for signal "${detail.signalName}" ` +
+            `(after seq ${detail.cursor}) in scope ${detail.scope.runId}/${detail.scope.scenarioId}. ${seen}${nearMiss}`);
+        this.detail = detail;
+    }
+}
+/** The scope was destroyed (or never created); the operation cannot proceed. */
+export class ScopeClosedError extends Error {
+    name = 'ScopeClosedError';
+    constructor(scope, operation) {
+        super(`Cannot ${operation}: signal scope ${scope.runId}/${scope.scenarioId} is not open ` +
+            '(never created or already destroyed).');
+    }
+}
+/** A pending wait was cancelled through its AbortSignal (e.g. failFast teardown). */
+export class SignalWaitAbortedError extends Error {
+    name = 'SignalWaitAbortedError';
+    constructor(signalName) {
+        super(`Wait for signal "${signalName}" was aborted.`);
+    }
+}
+/** Infrastructure failure (transport down/unreachable). NOT a test failure. */
+export class TransportUnavailableError extends Error {
+    name = 'TransportUnavailableError';
+}
+/** The payload is not JSON-serializable or exceeds the configured size cap. */
+export class SignalPayloadError extends Error {
+    name = 'SignalPayloadError';
+}
+/** API misuse (e.g. two concurrent identical waits by one subscriber — ADR-0003 D3). */
+export class SignalUsageError extends Error {
+    name = 'SignalUsageError';
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAgBA,mFAAmF;AACnF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;IACrC,MAAM,CAAsB;IAErC,YAAY,MAA2B;QACrC,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC;QACzF,MAAM,IAAI,GACR,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;YACjC,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,6BAA6B,MAAM,CAAC,eAAe;iBAChD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC;iBACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,MAAM,QAAQ,GACZ,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAC,iBAAiB,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YAC5E,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,CACH,mBAAmB,MAAM,CAAC,SAAS,OAAO,GAAG,4BAA4B,MAAM,CAAC,UAAU,IAAI;YAC5F,cAAc,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,GAAG,QAAQ,EAAE,CAC/G,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvB,IAAI,GAAG,kBAAkB,CAAC;IAE5C,YAAY,KAAkB,EAAE,SAAiB;QAC/C,KAAK,CACH,UAAU,SAAS,kBAAkB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,eAAe;YACjF,uCAAuC,CAC1C,CAAC;IACJ,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IAElD,YAAY,UAAkB;QAC5B,KAAK,CAAC,oBAAoB,UAAU,gBAAgB,CAAC,CAAC;IACxD,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChC,IAAI,GAAG,2BAA2B,CAAC;CACtD;AAED,+EAA+E;AAC/E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;CAC/C;AAED,wFAAwF;AACxF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvB,IAAI,GAAG,kBAAkB,CAAC;CAC7C"}

package/dist/in-memory-transport.d.ts

@@ -0,0 +1,21 @@
+import { type SignalPayload, type SignalQuery, type SignalRecord, type SignalScope, type SignalTransport, type TransportWaitOptions } from './types.js';
+/**
+ * Reference transport: a Map-based append-only log per scope. Deliberately "as
+ * awkward as a network": microtask-deferred resolution (never synchronous) and
+ * JSON round-tripped payloads, so local tests cannot accrete behaviors a
+ * distributed transport can't honor (ADR-0003).
+ */
+export declare class InMemoryTransport implements SignalTransport {
+    #private;
+    createScope(scope: SignalScope): Promise<void>;
+    publish(scope: SignalScope, signal: {
+        name: string;
+        from: string;
+        payload: SignalPayload;
+    }): Promise<SignalRecord>;
+    waitFor(scope: SignalScope, query: SignalQuery, opts: TransportWaitOptions): Promise<SignalRecord>;
+    history(scope: SignalScope): Promise<readonly SignalRecord[]>;
+    destroyScope(scope: SignalScope): Promise<void>;
+    ping(): Promise<void>;
+}
+//# sourceMappingURL=in-memory-transport.d.ts.map

package/dist/in-memory-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-transport.d.ts","sourceRoot":"","sources":["../src/in-memory-transport.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAwCpB;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,eAAe;;IAWjD,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,GAC7D,OAAO,CAAC,YAAY,CAAC;IA2BlB,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,YAAY,CAAC;IA2DlB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAM7D,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/in-memory-transport.js

@@ -0,0 +1,142 @@
+import { ScopeClosedError, SignalPayloadError, SignalTimeoutError, SignalWaitAbortedError, } from './errors.js';
+import { nearMissNames } from './near-miss.js';
+import { scopeKey, } from './types.js';
+function matches(query, record) {
+    return (record.seq > query.afterSeq &&
+        record.name === query.name &&
+        (query.from === undefined || record.from === query.from));
+}
+/** Deep-copies through JSON so shared-mutable-reference bugs fail locally too (ADR-0003 D5). */
+function cloneJson(payload) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(payload ?? null);
+    }
+    catch (cause) {
+        throw new SignalPayloadError(`Signal payload is not JSON-serializable: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (serialized === undefined) {
+        throw new SignalPayloadError('Signal payload is not JSON-serializable.');
+    }
+    return JSON.parse(serialized);
+}
+const microtask = () => new Promise((resolve) => queueMicrotask(resolve));
+/**
+ * Reference transport: a Map-based append-only log per scope. Deliberately "as
+ * awkward as a network": microtask-deferred resolution (never synchronous) and
+ * JSON round-tripped payloads, so local tests cannot accrete behaviors a
+ * distributed transport can't honor (ADR-0003).
+ */
+export class InMemoryTransport {
+    #scopes = new Map();
+    #state(scope, operation) {
+        const state = this.#scopes.get(scopeKey(scope));
+        if (!state) {
+            throw new ScopeClosedError(scope, operation);
+        }
+        return state;
+    }
+    async createScope(scope) {
+        const key = scopeKey(scope);
+        if (!this.#scopes.has(key)) {
+            this.#scopes.set(key, { records: [], nextSeq: 1, waiters: new Set() });
+        }
+        await microtask();
+    }
+    async publish(scope, signal) {
+        const state = this.#state(scope, `publish signal "${signal.name}"`);
+        // Seq assignment is synchronous with the call (call order = total order);
+        // only the RESOLUTION and waiter notification are deferred.
+        const record = {
+            seq: state.nextSeq,
+            name: signal.name,
+            from: signal.from,
+            payload: cloneJson(signal.payload),
+            publishedAt: Date.now(),
+        };
+        state.nextSeq += 1;
+        state.records.push(record);
+        queueMicrotask(() => {
+            for (const waiter of [...state.waiters]) {
+                if (matches(waiter.query, record)) {
+                    state.waiters.delete(waiter);
+                    waiter.settle(record);
+                }
+            }
+        });
+        await microtask();
+        return record;
+    }
+    // Async so that even "scope closed" surfaces as a rejection, never a
+    // synchronous throw (the same Zalgo rule the resolutions follow).
+    async waitFor(scope, query, opts) {
+        const state = this.#state(scope, `wait for signal "${query.name}"`);
+        return new Promise((resolve, reject) => {
+            const existing = state.records.find((record) => matches(query, record));
+            if (existing) {
+                // Replay-first, but never synchronously (Zalgo prevention).
+                queueMicrotask(() => resolve(existing));
+                return;
+            }
+            if (opts.signal?.aborted) {
+                queueMicrotask(() => reject(new SignalWaitAbortedError(query.name)));
+                return;
+            }
+            let cleanup = () => { };
+            const waiter = {
+                query,
+                settle(record) {
+                    cleanup();
+                    resolve(record);
+                },
+                fail(error) {
+                    cleanup();
+                    reject(error);
+                },
+            };
+            const timer = setTimeout(() => {
+                state.waiters.delete(waiter);
+                cleanup();
+                reject(new SignalTimeoutError({
+                    scope,
+                    signalName: query.name,
+                    timeoutMs: opts.timeoutMs,
+                    cursor: query.afterSeq,
+                    historySnapshot: [...state.records],
+                    nearMissNames: nearMissNames(query.name, state.records),
+                }));
+            }, opts.timeoutMs);
+            const onAbort = () => {
+                state.waiters.delete(waiter);
+                cleanup();
+                reject(new SignalWaitAbortedError(query.name));
+            };
+            opts.signal?.addEventListener('abort', onAbort, { once: true });
+            cleanup = () => {
+                clearTimeout(timer);
+                opts.signal?.removeEventListener('abort', onAbort);
+            };
+            state.waiters.add(waiter);
+        });
+    }
+    async history(scope) {
+        const state = this.#state(scope, 'read signal history');
+        await microtask();
+        return [...state.records];
+    }
+    async destroyScope(scope) {
+        const state = this.#scopes.get(scopeKey(scope));
+        if (state) {
+            this.#scopes.delete(scopeKey(scope));
+            for (const waiter of [...state.waiters]) {
+                waiter.fail(new ScopeClosedError(scope, `wait for signal "${waiter.query.name}"`));
+            }
+            state.waiters.clear();
+        }
+        await microtask();
+    }
+    async ping() {
+        await microtask();
+    }
+}
+//# sourceMappingURL=in-memory-transport.js.map

package/dist/in-memory-transport.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @kraken-e2e/signaling — standalone multi-actor signal log (ADR-0001 §5.7, ADR-0003).
+ *
+ * A scoped append-only log with per-(subscriber, signal-name) cursors:
+ * publish-before-wait always delivers (replay-first), repeated signals count
+ * FIFO per subscriber, and distinct subscribers each receive every record
+ * (broadcast). Zero runtime dependencies; usable without Gherkin or WebdriverIO.
+ *
+ * The transport conformance suite lives at `@kraken-e2e/signaling/conformance`.
+ */
+export { ActorSignals, ScopedSignals, SignalBus, type SignalBusOptions, type SignalHandle, type WaitOptions, } from './bus.js';
+export { type ChaosOperation, type ChaosOptions, ChaosTransport, } from './chaos-transport.js';
+export { ScopeClosedError, SignalPayloadError, type SignalTimeoutDetail, SignalTimeoutError, SignalUsageError, SignalWaitAbortedError, TransportUnavailableError, } from './errors.js';
+export { InMemoryTransport } from './in-memory-transport.js';
+export { levenshtein, nearMissNames } from './near-miss.js';
+export { type SignalPayload, type SignalQuery, type SignalRecord, type SignalScope, type SignalTransport, scopeKey, type TransportWaitOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,QAAQ,EACR,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @kraken-e2e/signaling — standalone multi-actor signal log (ADR-0001 §5.7, ADR-0003).
+ *
+ * A scoped append-only log with per-(subscriber, signal-name) cursors:
+ * publish-before-wait always delivers (replay-first), repeated signals count
+ * FIFO per subscriber, and distinct subscribers each receive every record
+ * (broadcast). Zero runtime dependencies; usable without Gherkin or WebdriverIO.
+ *
+ * The transport conformance suite lives at `@kraken-e2e/signaling/conformance`.
+ */
+export { ActorSignals, ScopedSignals, SignalBus, } from './bus.js';
+export { ChaosTransport, } from './chaos-transport.js';
+export { ScopeClosedError, SignalPayloadError, SignalTimeoutError, SignalUsageError, SignalWaitAbortedError, TransportUnavailableError, } from './errors.js';
+export { InMemoryTransport } from './in-memory-transport.js';
+export { levenshtein, nearMissNames } from './near-miss.js';
+export { scopeKey, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,SAAS,GAIV,MAAM,UAAU,CAAC;AAClB,OAAO,EAGL,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAElB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAML,QAAQ,GAET,MAAM,YAAY,CAAC"}

package/dist/near-miss.d.ts

@@ -0,0 +1,6 @@
+import type { SignalRecord } from './types.js';
+/** Classic dynamic-programming Levenshtein distance (small inputs only). */
+export declare function levenshtein(a: string, b: string): number;
+/** Signal names in the history within edit distance 2 of the waited name (typo diagnosis). */
+export declare function nearMissNames(waited: string, history: readonly SignalRecord[]): readonly string[];
+//# sourceMappingURL=near-miss.d.ts.map

package/dist/near-miss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"near-miss.d.ts","sourceRoot":"","sources":["../src/near-miss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBxD;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,MAAM,EAAE,CAQjG"}

package/dist/near-miss.js

@@ -0,0 +1,30 @@
+/** Classic dynamic-programming Levenshtein distance (small inputs only). */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const distance = Array.from({ length: rows * cols }, () => 0);
+    for (let i = 0; i < rows; i += 1)
+        distance[i * cols] = i;
+    for (let j = 0; j < cols; j += 1)
+        distance[j] = j;
+    for (let i = 1; i < rows; i += 1) {
+        for (let j = 1; j < cols; j += 1) {
+            const substitutionCost = a[i - 1] === b[j - 1] ? 0 : 1;
+            distance[i * cols + j] = Math.min((distance[(i - 1) * cols + j] ?? 0) + 1, (distance[i * cols + (j - 1)] ?? 0) + 1, (distance[(i - 1) * cols + (j - 1)] ?? 0) + substitutionCost);
+        }
+    }
+    return distance[rows * cols - 1] ?? 0;
+}
+/** Signal names in the history within edit distance 2 of the waited name (typo diagnosis). */
+export function nearMissNames(waited, history) {
+    const seen = new Set();
+    for (const record of history) {
+        if (record.name !== waited && levenshtein(record.name, waited) <= 2) {
+            seen.add(record.name);
+        }
+    }
+    return [...seen];
+}
+//# sourceMappingURL=near-miss.js.map

package/dist/near-miss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"near-miss.js","sourceRoot":"","sources":["../src/near-miss.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,gBAAgB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAC/B,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACvC,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACvC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,gBAAgB,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAgC;IAC5E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/redis-transport.d.ts

@@ -0,0 +1,46 @@
+import { type SignalPayload, type SignalQuery, type SignalRecord, type SignalScope, type SignalTransport, type TransportWaitOptions } from './types.js';
+/** The node-redis client slice this transport consumes (mock/type firewall). */
+export interface RedisClientLike {
+    connect(): Promise<unknown>;
+    close(): Promise<unknown> | void;
+    on(event: string, listener: (...args: unknown[]) => void): unknown;
+    eval(script: string, options: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    xRange(key: string, start: string, end: string): Promise<Array<{
+        id: string;
+        message: Record<string, string>;
+    }>>;
+    exists(key: string): Promise<number>;
+    set(key: string, value: string): Promise<unknown>;
+    del(keys: string[]): Promise<unknown>;
+    ping(): Promise<unknown>;
+}
+export interface RedisTransportOptions {
+    /** redis:// URL (ignored when `client` is provided). */
+    readonly url?: string;
+    /** Pre-built client (tests, custom config). Must NOT be connected yet. */
+    readonly client?: RedisClientLike;
+    /** Key namespace; instances with different prefixes are fully isolated. */
+    readonly keyPrefix?: string;
+    /** waitFor poll interval. */
+    readonly pollMs?: number;
+}
+export declare class RedisStreamTransport implements SignalTransport {
+    #private;
+    constructor(options?: RedisTransportOptions);
+    createScope(scope: SignalScope): Promise<void>;
+    publish(scope: SignalScope, signal: {
+        name: string;
+        from: string;
+        payload: SignalPayload;
+    }): Promise<SignalRecord>;
+    waitFor(scope: SignalScope, query: SignalQuery, opts: TransportWaitOptions): Promise<SignalRecord>;
+    history(scope: SignalScope): Promise<readonly SignalRecord[]>;
+    destroyScope(scope: SignalScope): Promise<void>;
+    ping(): Promise<void>;
+    /** Closes the underlying client (transport-level teardown, not per-scope). */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=redis-transport.d.ts.map

package/dist/redis-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-transport.d.ts","sourceRoot":"","sources":["../src/redis-transport.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACjC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD,qBAAa,oBAAqB,YAAW,eAAe;;gBAO9C,OAAO,GAAE,qBAA0B;IA0DzC,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,GAC7D,OAAO,CAAC,YAAY,CAAC;IA4ClB,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,YAAY,CAAC;IA8BlB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAM7D,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,8EAA8E;IACxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/redis-transport.js

@@ -0,0 +1,173 @@
+/**
+ * Distributed SignalTransport over Redis Streams (ADR-0001 D11: node-redis,
+ * never ioredis; live-verified against node-redis 6.1 / Redis 8, 2026-07-05).
+ *
+ * Mapping: one stream per scope; Kraken's monotonic `seq` is assigned by an
+ * atomic Lua INCR+XADD (explicit stream id `${seq}-0`), so stream order IS
+ * seq order and catch-up reads are `XRANGE (seq-0 +` (exclusive start).
+ * waitFor polls (default 15ms) — dumb-log semantics, no per-waiter blocking
+ * connections; the SignalBus above owns cursors and FIFO fairness.
+ *
+ * This module is a SUBPATH export (`@kraken-e2e/signaling/redis`); `redis` is an
+ * OPTIONAL peer dependency loaded dynamically on first use — installing
+ * Kraken never drags Redis in (same import-safety rule as the drivers).
+ */
+import { ScopeClosedError, SignalPayloadError, SignalTimeoutError, SignalWaitAbortedError, TransportUnavailableError, } from './errors.js';
+import { nearMissNames } from './near-miss.js';
+import { scopeKey, } from './types.js';
+/** Atomic seq assignment + append: INCR the scope counter, XADD at `${seq}-0`. */
+const PUBLISH_LUA = `
+local seq = redis.call('INCR', KEYS[2])
+redis.call('XADD', KEYS[1], seq .. '-0',
+  'name', ARGV[1], 'from', ARGV[2], 'payload', ARGV[3], 'publishedAt', ARGV[4])
+return seq
+`;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export class RedisStreamTransport {
+    #options;
+    #prefix;
+    #pollMs;
+    #client;
+    #connecting;
+    constructor(options = {}) {
+        this.#options = options;
+        this.#prefix = options.keyPrefix ?? 'kraken';
+        this.#pollMs = options.pollMs ?? 15;
+    }
+    async #connected() {
+        if (this.#client)
+            return this.#client;
+        this.#connecting ??= (async () => {
+            try {
+                let client = this.#options.client;
+                if (!client) {
+                    const redisSpecifier = 'redis';
+                    const redis = (await import(redisSpecifier));
+                    client = redis.createClient(this.#options.url !== undefined ? { url: this.#options.url } : {});
+                }
+                // MANDATORY: without an error listener node-redis throws uncaught.
+                client.on('error', () => { });
+                await client.connect();
+                this.#client = client;
+                return client;
+            }
+            catch (cause) {
+                this.#connecting = undefined;
+                throw new TransportUnavailableError(`Redis transport could not connect${this.#options.url ? ` to ${this.#options.url}` : ''}: ${cause instanceof Error ? cause.message : String(cause)}`);
+            }
+        })();
+        return this.#connecting;
+    }
+    #keys(scope) {
+        const base = `${this.#prefix}:${scopeKey(scope)}`;
+        return { stream: `${base}:stream`, seq: `${base}:seq`, open: `${base}:open` };
+    }
+    async #assertOpen(client, scope, operation) {
+        if ((await client.exists(this.#keys(scope).open)) !== 1) {
+            throw new ScopeClosedError(scope, operation);
+        }
+    }
+    #toRecord(entry) {
+        return {
+            seq: Number(entry.id.split('-')[0]),
+            name: entry.message['name'] ?? '',
+            from: entry.message['from'] ?? '',
+            payload: JSON.parse(entry.message['payload'] ?? 'null'),
+            publishedAt: Number(entry.message['publishedAt'] ?? 0),
+        };
+    }
+    async createScope(scope) {
+        const client = await this.#connected();
+        await client.set(this.#keys(scope).open, '1');
+    }
+    async publish(scope, signal) {
+        const client = await this.#connected();
+        await this.#assertOpen(client, scope, `publish signal "${signal.name}"`);
+        let serialized;
+        try {
+            serialized = JSON.stringify(signal.payload ?? null);
+        }
+        catch (cause) {
+            throw new SignalPayloadError(`Signal payload is not JSON-serializable: ${cause instanceof Error ? cause.message : String(cause)}`);
+        }
+        if (serialized === undefined) {
+            throw new SignalPayloadError('Signal payload is not JSON-serializable.');
+        }
+        const publishedAt = Date.now();
+        const keys = this.#keys(scope);
+        const seq = Number(await client.eval(PUBLISH_LUA, {
+            keys: [keys.stream, keys.seq],
+            arguments: [signal.name, signal.from, serialized, String(publishedAt)],
+        }));
+        return {
+            seq,
+            name: signal.name,
+            from: signal.from,
+            payload: JSON.parse(serialized),
+            publishedAt,
+        };
+    }
+    async #readAfter(client, scope, afterSeq) {
+        const entries = await client.xRange(this.#keys(scope).stream, afterSeq > 0 ? `(${afterSeq}-0` : '-', '+');
+        return entries.map((entry) => this.#toRecord(entry));
+    }
+    async waitFor(scope, query, opts) {
+        const client = await this.#connected();
+        const deadline = Date.now() + opts.timeoutMs;
+        for (;;) {
+            await this.#assertOpen(client, scope, `wait for signal "${query.name}"`);
+            if (opts.signal?.aborted) {
+                throw new SignalWaitAbortedError(query.name);
+            }
+            const records = await this.#readAfter(client, scope, query.afterSeq);
+            const match = records.find((record) => record.name === query.name && (query.from === undefined || record.from === query.from));
+            if (match)
+                return match;
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                const historySnapshot = await this.history(scope);
+                throw new SignalTimeoutError({
+                    scope,
+                    signalName: query.name,
+                    timeoutMs: opts.timeoutMs,
+                    cursor: query.afterSeq,
+                    historySnapshot,
+                    nearMissNames: nearMissNames(query.name, historySnapshot),
+                });
+            }
+            await sleep(Math.min(this.#pollMs, remaining));
+        }
+    }
+    async history(scope) {
+        const client = await this.#connected();
+        await this.#assertOpen(client, scope, 'read signal history');
+        return this.#readAfter(client, scope, 0);
+    }
+    async destroyScope(scope) {
+        const client = await this.#connected();
+        const keys = this.#keys(scope);
+        // Pending waiters observe the missing :open flag on their next poll and
+        // reject with ScopeClosedError — no server-side waiter registry to clear.
+        await client.del([keys.open, keys.stream, keys.seq]);
+    }
+    async ping() {
+        try {
+            const client = await this.#connected();
+            await client.ping();
+        }
+        catch (cause) {
+            if (cause instanceof TransportUnavailableError)
+                throw cause;
+            throw new TransportUnavailableError(`Redis ping failed: ${cause instanceof Error ? cause.message : String(cause)}`);
+        }
+    }
+    /** Closes the underlying client (transport-level teardown, not per-scope). */
+    async close() {
+        if (this.#client) {
+            await this.#client.close();
+            this.#client = undefined;
+            this.#connecting = undefined;
+        }
+    }
+}
+//# sourceMappingURL=redis-transport.js.map

package/dist/redis-transport.js.map

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