actor-ts 0.9.0

package/dist/testkit/TestProbe.js

@@ -0,0 +1,184 @@
+import { ActorPath } from '../ActorPath.js';
+import { ActorRef } from '../ActorRef.js';
+let probeCounter = 0;
+/**
+ * A lightweight ActorRef that captures every `tell` for inspection by tests.
+ * Unlike an ordinary actor it is synchronous and not driven by the dispatcher —
+ * messages sit in an internal queue until a test asserts on them.
+ */
+export class TestProbe extends ActorRef {
+    system;
+    path;
+    queue = [];
+    /** Parked resolvers when a caller is waiting for the next message. */
+    waiters = [];
+    defaultTimeoutMs;
+    _lastSender = null;
+    constructor(system, opts = {}) {
+        super();
+        this.system = system;
+        const n = opts.name ?? `test-probe-${++probeCounter}`;
+        this.path = new ActorPath('', null, system.name).child(n);
+        this.defaultTimeoutMs = opts.defaultTimeoutMs ?? 3_000;
+    }
+    tell(message, sender = null) {
+        const env = { message, sender };
+        // Hand off to a parked waiter if one is present — otherwise buffer.
+        const w = this.waiters.shift();
+        if (w) {
+            if (w.timer)
+                clearTimeout(w.timer);
+            w.resolve(env);
+        }
+        else {
+            this.queue.push(env);
+        }
+    }
+    /** Number of messages currently buffered. */
+    get messageCount() { return this.queue.length; }
+    /** True when there is at least one buffered message waiting to be consumed. */
+    hasMessage() { return this.queue.length > 0; }
+    /** The sender of the LAST message consumed via expect* / receive*. */
+    get sender() { return this._lastSender; }
+    /** Convenience: reply to the last sender (throws if there is none). */
+    reply(message) {
+        if (!this._lastSender)
+            throw new Error('TestProbe.reply(): no sender recorded');
+        this._lastSender.tell(message, this);
+    }
+    /** Clear all buffered messages — handy between test phases. */
+    clearInbox() { this.queue.length = 0; }
+    /* ----------------------------- Expectations ---------------------------- */
+    /** Wait for the next message and return it.  Throws on timeout. */
+    async receiveOne(timeoutMs) {
+        return (await this._next(timeoutMs)).message;
+    }
+    /** Receive the next `n` messages. */
+    async receiveN(n, timeoutMs) {
+        const out = [];
+        for (let i = 0; i < n; i++)
+            out.push(await this.receiveOne(timeoutMs));
+        return out;
+    }
+    /** Assert the next message deep-equals `expected`. */
+    async expectMsg(expected, timeoutMs) {
+        const got = await this.receiveOne(timeoutMs);
+        if (!deepEqual(got, expected)) {
+            throw new Error(`expectMsg: expected ${stringify(expected)} but got ${stringify(got)}`);
+        }
+        return got;
+    }
+    /** Assert the next message is an instance of `Class`. */
+    async expectMsgType(Class, timeoutMs) {
+        const got = await this.receiveOne(timeoutMs);
+        if (!(got instanceof Class)) {
+            throw new Error(`expectMsgType: expected instance of ${Class.name} but got ${stringify(got)}`);
+        }
+        return got;
+    }
+    /** Assert NO message arrives within the timeout. */
+    async expectNoMessage(timeoutMs = 300) {
+        if (this.queue.length > 0) {
+            throw new Error(`expectNoMessage: queue contains ${stringify(this.queue[0].message)}`);
+        }
+        // Wait silently — if something arrives, the next `receiveOne` call would
+        // pick it up. We implement by parking a waiter that we cancel after the
+        // window elapses.
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                // Remove our entry from waiters before resolving.
+                const idx = this.waiters.indexOf(entry);
+                if (idx >= 0)
+                    this.waiters.splice(idx, 1);
+                resolve();
+            }, timeoutMs);
+            const entry = {
+                resolve: (env) => {
+                    clearTimeout(timer);
+                    reject(new Error(`expectNoMessage: received ${stringify(env.message)}`));
+                },
+                reject: (err) => { clearTimeout(timer); reject(err); },
+                timer: null,
+            };
+            this.waiters.push(entry);
+        });
+    }
+    /** Receive messages until `pred` returns true.  Other messages are discarded. */
+    async fishForMessage(pred, timeoutMs = this.defaultTimeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            const remaining = Math.max(0, deadline - Date.now());
+            const msg = await this.receiveOne(remaining || 1);
+            if (pred(msg))
+                return msg;
+        }
+    }
+    /* ------------------------------ Internal ------------------------------- */
+    _next(timeoutMs) {
+        const t = timeoutMs ?? this.defaultTimeoutMs;
+        // Use already-buffered message if any.
+        const buffered = this.queue.shift();
+        if (buffered) {
+            this._lastSender = buffered.sender;
+            return Promise.resolve(buffered);
+        }
+        return new Promise((resolve, reject) => {
+            const entry = {
+                resolve: (env) => {
+                    this._lastSender = env.sender;
+                    resolve(env);
+                },
+                reject,
+                timer: null,
+            };
+            if (t > 0 && Number.isFinite(t)) {
+                entry.timer = setTimeout(() => {
+                    const idx = this.waiters.indexOf(entry);
+                    if (idx >= 0)
+                        this.waiters.splice(idx, 1);
+                    reject(new Error(`TestProbe timeout after ${t}ms`));
+                }, t);
+            }
+            this.waiters.push(entry);
+        });
+    }
+    /** @internal — used by TestKit for diagnostics. */
+    _snapshot() { return this.queue.slice(); }
+}
+/* ------------------------------- Utilities ------------------------------- */
+function stringify(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== 'object' || typeof b !== 'object')
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a)) {
+        const ar = a, br = b;
+        if (ar.length !== br.length)
+            return false;
+        for (let i = 0; i < ar.length; i++)
+            if (!deepEqual(ar[i], br[i]))
+                return false;
+        return true;
+    }
+    const ao = a, bo = b;
+    const keysA = Object.keys(ao), keysB = Object.keys(bo);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const k of keysA)
+        if (!deepEqual(ao[k], bo[k]))
+            return false;
+    return true;
+}
+//# sourceMappingURL=TestProbe.js.map

package/dist/testkit/TestProbe.js.map

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

package/dist/testkit/index.d.ts

@@ -0,0 +1,11 @@
+export { TestKit } from './TestKit.js';
+export type { TestKitOptions } from './TestKit.js';
+export { TestProbe } from './TestProbe.js';
+export type { TestProbeOptions } from './TestProbe.js';
+export { ManualScheduler } from './ManualScheduler.js';
+export { MultiNodeSpec } from './MultiNodeSpec.js';
+export type { MultiNodeSpecSettings } from './MultiNodeSpec.js';
+export { ParallelMultiNodeSpec } from './ParallelMultiNodeSpec.js';
+export type { ParallelMultiNodeSpecSettings } from './ParallelMultiNodeSpec.js';
+export type { ScenarioContext, ScenarioModule, MemberSnapshot, } from './internal/parallel-multi-node-bootstrap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testkit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,6CAA6C,CAAC"}

package/dist/testkit/index.js

@@ -0,0 +1,6 @@
+export { TestKit } from './TestKit.js';
+export { TestProbe } from './TestProbe.js';
+export { ManualScheduler } from './ManualScheduler.js';
+export { MultiNodeSpec } from './MultiNodeSpec.js';
+export { ParallelMultiNodeSpec } from './ParallelMultiNodeSpec.js';
+//# sourceMappingURL=index.js.map

package/dist/testkit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testkit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/testkit/internal/MultiNodeBroker.d.ts

@@ -0,0 +1,39 @@
+import type { NodeAddress } from '../../cluster/NodeAddress.js';
+import type { PortLike } from '../../cluster/transports/MessageChannelTransport.js';
+/**
+ * Worker-broker variant for `ParallelMultiNodeSpec` — extends the
+ * production `WorkerBroker` semantics with two things tests need:
+ *
+ *   1. **`partition(a, b)` / `heal(a, b)`** — bidirectionally drop
+ *      messages between two registered addresses, simulating a
+ *      network partition between worker pairs.  The cluster's
+ *      failure-detector eventually marks the unreachable side
+ *      `unreachable → down → removed`.
+ *
+ *   2. **`unregisterAndDropFutureFrames(addr)`** — used by `crash()`
+ *      to make sure any in-flight frames from the dying worker are
+ *      not delivered after the crash.
+ *
+ * We don't subclass the production broker because the broker's
+ * routing logic is small enough to fork cleanly here, and the
+ * production version doesn't need the test-only hooks.  Keeps the
+ * production code path lean.
+ */
+export declare class MultiNodeBroker {
+    private readonly ports;
+    /** Set of `"a→b"` strings — directed; we add both directions to
+     *  represent a bidirectional partition.  Frames targeting a
+     *  blocked direction get dropped silently. */
+    private readonly blocked;
+    private stopped;
+    register(address: NodeAddress, port: PortLike): void;
+    unregister(address: NodeAddress): void;
+    close(): void;
+    /** Register a bidirectional partition between `a` and `b`. */
+    partition(a: NodeAddress, b: NodeAddress): void;
+    /** Lift the partition between `a` and `b`. */
+    heal(a: NodeAddress, b: NodeAddress): void;
+    registered(): NodeAddress[];
+    private onMessage;
+}
+//# sourceMappingURL=MultiNodeBroker.d.ts.map

package/dist/testkit/internal/MultiNodeBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeBroker.d.ts","sourceRoot":"","sources":["../../../src/testkit/internal/MultiNodeBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAEV,QAAQ,EACT,MAAM,qDAAqD,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD;;kDAE8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,OAAO,CAAS;IAExB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAUpD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAStC,KAAK,IAAI,IAAI;IAUb,8DAA8D;IAC9D,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI;IAK/C,8CAA8C;IAC9C,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI;IAK1C,UAAU,IAAI,WAAW,EAAE;IAM3B,OAAO,CAAC,SAAS;CAUlB"}

package/dist/testkit/internal/MultiNodeBroker.js

@@ -0,0 +1,96 @@
+import { NodeAddress as NodeAddressCtor } from '../../cluster/NodeAddress.js';
+/**
+ * Worker-broker variant for `ParallelMultiNodeSpec` — extends the
+ * production `WorkerBroker` semantics with two things tests need:
+ *
+ *   1. **`partition(a, b)` / `heal(a, b)`** — bidirectionally drop
+ *      messages between two registered addresses, simulating a
+ *      network partition between worker pairs.  The cluster's
+ *      failure-detector eventually marks the unreachable side
+ *      `unreachable → down → removed`.
+ *
+ *   2. **`unregisterAndDropFutureFrames(addr)`** — used by `crash()`
+ *      to make sure any in-flight frames from the dying worker are
+ *      not delivered after the crash.
+ *
+ * We don't subclass the production broker because the broker's
+ * routing logic is small enough to fork cleanly here, and the
+ * production version doesn't need the test-only hooks.  Keeps the
+ * production code path lean.
+ */
+export class MultiNodeBroker {
+    ports = new Map();
+    /** Set of `"a→b"` strings — directed; we add both directions to
+     *  represent a bidirectional partition.  Frames targeting a
+     *  blocked direction get dropped silently. */
+    blocked = new Set();
+    stopped = false;
+    register(address, port) {
+        const key = address.toString();
+        if (this.ports.has(key)) {
+            throw new Error(`MultiNodeBroker: address ${key} already registered`);
+        }
+        this.ports.set(key, port);
+        port.onmessage = (evt) => this.onMessage(key, evt.data);
+        port.start?.();
+    }
+    unregister(address) {
+        const key = address.toString();
+        const port = this.ports.get(key);
+        if (!port)
+            return;
+        try {
+            port.onmessage = null;
+        }
+        catch { /* ignore */ }
+        try {
+            port.close?.();
+        }
+        catch { /* ignore */ }
+        this.ports.delete(key);
+    }
+    close() {
+        this.stopped = true;
+        for (const [, port] of this.ports) {
+            try {
+                port.onmessage = null;
+            }
+            catch { /* ignore */ }
+            try {
+                port.close?.();
+            }
+            catch { /* ignore */ }
+        }
+        this.ports.clear();
+        this.blocked.clear();
+    }
+    /** Register a bidirectional partition between `a` and `b`. */
+    partition(a, b) {
+        this.blocked.add(`${a}→${b}`);
+        this.blocked.add(`${b}→${a}`);
+    }
+    /** Lift the partition between `a` and `b`. */
+    heal(a, b) {
+        this.blocked.delete(`${a}→${b}`);
+        this.blocked.delete(`${b}→${a}`);
+    }
+    registered() {
+        return Array.from(this.ports.keys()).map((k) => NodeAddressCtor.parse(k));
+    }
+    /* -------------------------------- internals ------------------------- */
+    onMessage(sourceKey, env) {
+        if (this.stopped)
+            return;
+        if (!this.ports.has(sourceKey))
+            return; // sender was unregistered
+        const targetAddr = NodeAddressCtor.fromJSON(env.to);
+        const targetKey = targetAddr.toString();
+        if (this.blocked.has(`${sourceKey}→${targetKey}`))
+            return; // partition
+        const target = this.ports.get(targetKey);
+        if (!target)
+            return; // unknown destination
+        target.postMessage(env);
+    }
+}
+//# sourceMappingURL=MultiNodeBroker.js.map

package/dist/testkit/internal/MultiNodeBroker.js.map

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

package/dist/testkit/internal/MultiNodeTransport.d.ts

@@ -0,0 +1,58 @@
+import type { NodeAddress } from '../../cluster/NodeAddress.js';
+import type { WireMessage } from '../../cluster/Protocol.js';
+import type { Transport, WireHandler } from '../../cluster/Transport.js';
+/**
+ * In-process Transport with per-instance partition controls — the
+ * backbone of `MultiNodeSpec`.
+ *
+ * Looks just like `InMemoryTransport` (process-global registry,
+ * microtask-deferred delivery so ordering mirrors TCP), with two
+ * extras the multi-node test harness needs:
+ *
+ *   1. **Outbound block set** — `blockOutgoing(peer)` makes this
+ *      transport refuse to send to a specific peer.  Combined with
+ *      the receiving side's mirror check, that is a one-way "drop"
+ *      from this side's perspective.
+ *   2. **Bidirectional partition** — `partitionFromPeer(peer)`
+ *      blocks both directions between this node and `peer`,
+ *      simulating a real network partition.  `heal(peer)` undoes it.
+ *
+ * Used only by tests; do NOT export this from the package barrel —
+ * production code should use `InMemoryTransport` (no partition hooks)
+ * or `TcpTransport` / `MessageChannelTransport`.
+ */
+export declare class MultiNodeTransport implements Transport {
+    readonly self: NodeAddress;
+    private static registry;
+    private handler;
+    private stopped;
+    private readonly blockedOutgoing;
+    constructor(self: NodeAddress);
+    setHandler(handler: WireHandler): void;
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+    send(to: NodeAddress, msg: WireMessage): void;
+    disconnect(_peer: NodeAddress): void;
+    peers(): NodeAddress[];
+    /** Block all outgoing traffic from this transport to `peer`. */
+    blockOutgoing(peer: NodeAddress): void;
+    /** Undo `blockOutgoing` for `peer`. */
+    unblockOutgoing(peer: NodeAddress): void;
+    /**
+     * Bidirectional partition: this transport refuses outgoing to `peer`,
+     * and (by virtue of `send`'s mirror check) any frame from this side
+     * that the peer might still attempt to route to us is dropped on the
+     * peer's side too.  In effect: a network partition between the two.
+     *
+     * Note: the symmetric call must be made on the *peer*'s transport
+     * for the partition to take effect in both directions explicitly —
+     * this method only updates *this* transport's view.  Use
+     * `MultiNodeSpec.partition(roleA, roleB)` for the symmetric helper.
+     */
+    partitionFromPeer(peer: NodeAddress): void;
+    /** True iff currently blocked from sending to `peer`. */
+    isPartitionedFrom(peer: NodeAddress): boolean;
+    /** Test reset — clears the registry.  Intended for `afterEach`. */
+    static _resetRegistryForTest(): void;
+}
+//# sourceMappingURL=MultiNodeTransport.d.ts.map

package/dist/testkit/internal/MultiNodeTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeTransport.d.ts","sourceRoot":"","sources":["../../../src/testkit/internal/MultiNodeTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAOtC,QAAQ,CAAC,IAAI,EAAE,WAAW;IANtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyC;IAEhE,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;gBAEhC,IAAI,EAAE,WAAW;IAEtC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAEhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAe7C,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAEpC,KAAK,IAAI,WAAW,EAAE;IAQtB,gEAAgE;IAChE,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAItC,uCAAuC;IACvC,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIxC;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI1C,yDAAyD;IACzD,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAI7C,mEAAmE;IACnE,MAAM,CAAC,qBAAqB,IAAI,IAAI;CAGrC"}

package/dist/testkit/internal/MultiNodeTransport.js

@@ -0,0 +1,96 @@
+import { NodeAddress as NodeAddressCtor } from '../../cluster/NodeAddress.js';
+/**
+ * In-process Transport with per-instance partition controls — the
+ * backbone of `MultiNodeSpec`.
+ *
+ * Looks just like `InMemoryTransport` (process-global registry,
+ * microtask-deferred delivery so ordering mirrors TCP), with two
+ * extras the multi-node test harness needs:
+ *
+ *   1. **Outbound block set** — `blockOutgoing(peer)` makes this
+ *      transport refuse to send to a specific peer.  Combined with
+ *      the receiving side's mirror check, that is a one-way "drop"
+ *      from this side's perspective.
+ *   2. **Bidirectional partition** — `partitionFromPeer(peer)`
+ *      blocks both directions between this node and `peer`,
+ *      simulating a real network partition.  `heal(peer)` undoes it.
+ *
+ * Used only by tests; do NOT export this from the package barrel —
+ * production code should use `InMemoryTransport` (no partition hooks)
+ * or `TcpTransport` / `MessageChannelTransport`.
+ */
+export class MultiNodeTransport {
+    self;
+    static registry = new Map();
+    handler = () => { };
+    stopped = false;
+    blockedOutgoing = new Set();
+    constructor(self) {
+        this.self = self;
+    }
+    setHandler(handler) { this.handler = handler; }
+    async start() {
+        MultiNodeTransport.registry.set(this.self.toString(), this);
+    }
+    async shutdown() {
+        this.stopped = true;
+        MultiNodeTransport.registry.delete(this.self.toString());
+    }
+    send(to, msg) {
+        if (this.stopped)
+            return;
+        const toKey = to.toString();
+        if (this.blockedOutgoing.has(toKey))
+            return;
+        const peer = MultiNodeTransport.registry.get(toKey);
+        if (!peer || peer.stopped)
+            return;
+        // Mirror — if the peer has us in its outgoing-block set, that
+        // means the partition is bidirectional; drop on its side too.
+        if (peer.blockedOutgoing.has(this.self.toString()))
+            return;
+        const from = this.self;
+        queueMicrotask(() => {
+            if (!peer.stopped)
+                peer.handler(from, msg);
+        });
+    }
+    disconnect(_peer) { }
+    peers() {
+        return Array.from(MultiNodeTransport.registry.keys())
+            .filter((k) => k !== this.self.toString())
+            .map((k) => NodeAddressCtor.parse(k));
+    }
+    /* ---------------------------- partition controls --------------------------- */
+    /** Block all outgoing traffic from this transport to `peer`. */
+    blockOutgoing(peer) {
+        this.blockedOutgoing.add(peer.toString());
+    }
+    /** Undo `blockOutgoing` for `peer`. */
+    unblockOutgoing(peer) {
+        this.blockedOutgoing.delete(peer.toString());
+    }
+    /**
+     * Bidirectional partition: this transport refuses outgoing to `peer`,
+     * and (by virtue of `send`'s mirror check) any frame from this side
+     * that the peer might still attempt to route to us is dropped on the
+     * peer's side too.  In effect: a network partition between the two.
+     *
+     * Note: the symmetric call must be made on the *peer*'s transport
+     * for the partition to take effect in both directions explicitly —
+     * this method only updates *this* transport's view.  Use
+     * `MultiNodeSpec.partition(roleA, roleB)` for the symmetric helper.
+     */
+    partitionFromPeer(peer) {
+        this.blockOutgoing(peer);
+    }
+    /** True iff currently blocked from sending to `peer`. */
+    isPartitionedFrom(peer) {
+        return this.blockedOutgoing.has(peer.toString());
+    }
+    /** Test reset — clears the registry.  Intended for `afterEach`. */
+    static _resetRegistryForTest() {
+        MultiNodeTransport.registry.clear();
+    }
+}
+//# sourceMappingURL=MultiNodeTransport.js.map

package/dist/testkit/internal/MultiNodeTransport.js.map

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

package/dist/testkit/internal/parallel-multi-node-bootstrap.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Generic worker-side bootstrap for `ParallelMultiNodeSpec`.  Each
+ * worker spawned by the harness runs this script; the harness drives
+ * the worker via a control-channel piggybacked on the same
+ * `postMessage` socket that `WorkerNode.join()` uses for its
+ * lifecycle handshake.
+ *
+ * Test-local actor logic is loaded via a **scenario module** —
+ * `initData.scenarioModule` is a URL passed by the harness; the
+ * bootstrap dynamically imports it and calls its `setup(ctx)` hook
+ * after the cluster joins, then dispatches `run-command` requests
+ * through the module's `commands` map.  The scenario module owns
+ * everything actor-shaped (entity classes, sharding setup, …) —
+ * the harness only ever sees JSON-serialisable command/response
+ * pairs.
+ *
+ * **Why a separate file**: the worker process can't see the test
+ * file's closures (workers run in their own JS context with their
+ * own module graph).  A standalone bootstrap that loads scenario
+ * modules by URL is the cleanest way to thread test-specific code
+ * into the worker without leaking it through `postMessage`.
+ */
+import { ActorSystem } from '../../ActorSystem.js';
+import { Cluster } from '../../cluster/Cluster.js';
+import type { Member } from '../../cluster/Member.js';
+/**
+ * Optional shape a scenario module exports.  All hooks are optional —
+ * a scenario can be just `{ setup }` for static fixture setup, or
+ * just `{ commands }` for a request/reply tester, or both.  The
+ * `ctx` parameter holds the worker's `ActorSystem` + `Cluster` plus
+ * the role name + any role-specific init data.
+ */
+export interface ScenarioContext {
+    readonly role: string;
+    readonly system: ActorSystem;
+    readonly cluster: Cluster;
+    readonly initData: unknown;
+    /** Per-role state the scenario wants to keep across commands. */
+    readonly state: Record<string, unknown>;
+}
+export interface ScenarioModule {
+    setup?: (ctx: ScenarioContext) => void | Promise<void>;
+    commands?: Record<string, (args: unknown, ctx: ScenarioContext) => unknown | Promise<unknown>>;
+}
+/** Member view as a JSON-serialisable snapshot — Member instances
+ *  themselves carry NodeAddress objects which postMessage flattens
+ *  into plain data anyway, but defining the shape here makes the
+ *  cross-process contract explicit. */
+export interface MemberSnapshot {
+    readonly address: string;
+    readonly status: Member['status'];
+    readonly roles: ReadonlyArray<string>;
+}
+//# sourceMappingURL=parallel-multi-node-bootstrap.d.ts.map

package/dist/testkit/internal/parallel-multi-node-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-multi-node-bootstrap.d.ts","sourceRoot":"","sources":["../../../src/testkit/internal/parallel-multi-node-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CACpE,CAAC;CACH;AA0BD;;;uCAGuC;AACvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC"}