actor-ts 0.9.1 → 0.11.0

package/dist/testkit/MultiNodeClusterFixture.d.ts

@@ -0,0 +1,63 @@
+import { MultiNodeSpec } from './MultiNodeSpec.js';
+import type { MultiNodeSpecOptionsType } from './MultiNodeSpecOptions.js';
+/**
+ * Test fixture that boots a {@link MultiNodeSpec} ONCE per describe-
+ * block and tears it down after the last `test()` in the block runs.
+ * Wraps the runner's `beforeAll` / `afterAll` hooks so a multi-node
+ * test file doesn't have to re-spin a 3-node cluster per-test —
+ * the bootstrap cost is paid once and amortised across the block.
+ *
+ * **Test-runner agnostic**: the framework's build output mustn't
+ * import `bun:test` directly (that breaks Node / Deno consumers
+ * who installed actor-ts and then run their own Vitest/Jest suite).
+ * Instead the caller passes the runner's `beforeAll` / `afterAll`
+ * in.  For Bun:
+ *
+ *   import { beforeAll, afterAll, describe, test } from 'bun:test';
+ *   import { MultiNodeClusterFixture } from 'actor-ts/testkit';
+ *
+ *   describe('sharding', () => {
+ *     const fixture = MultiNodeClusterFixture.create(
+ *       { roles: ['a', 'b', 'c'] },
+ *       { beforeAll, afterAll },
+ *     );
+ *
+ *     test('shard rebalances on join', async () => {
+ *       const a = fixture.spec().clusterFor('a');
+ *       // …
+ *     });
+ *   });
+ *
+ * Vitest and Jest export `beforeAll` / `afterAll` with compatible
+ * signatures, so the same shape works there.
+ */
+export interface TestRunnerHooks {
+    beforeAll(fn: () => void | Promise<void>): void;
+    afterAll(fn: () => void | Promise<void>): void;
+}
+export interface MultiNodeClusterFixture {
+    /** The underlying MultiNodeSpec — available inside any `test()` in the describe block. */
+    spec(): MultiNodeSpec;
+    /**
+     * `true` after `beforeAll` has run.  Used by tests that need to
+     * detect "is the fixture set up yet" (rare — usually you just
+     * call `spec()` and it throws helpfully if not started).
+     */
+    isStarted(): boolean;
+}
+export declare const MultiNodeClusterFixture: {
+    /**
+     * Register a multi-node cluster fixture in the current describe
+     * block.  Returns a handle whose `.spec()` is callable inside any
+     * `test()` in the same block.
+     *
+     * The implementation captures `options` lazily — start happens
+     * inside the registered `beforeAll`, not at `create()` time.
+     * Bun's TestKit also hadn't started any actor systems yet at
+     * describe-registration time, so any side effects of MultiNodeSpec
+     * construction would be wasted if a sibling `test.skip`/filter
+     * skipped this block.
+     */
+    create(options: MultiNodeSpecOptionsType, hooks: TestRunnerHooks): MultiNodeClusterFixture;
+};
+//# sourceMappingURL=MultiNodeClusterFixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeClusterFixture.d.ts","sourceRoot":"","sources":["../../src/testkit/MultiNodeClusterFixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,IAAI,IAAI,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,uBAAuB;IAClC;;;;;;;;;;;OAWG;oBAEQ,wBAAwB,SAC1B,eAAe,GACrB,uBAAuB;CAgC3B,CAAC"}

package/dist/testkit/MultiNodeClusterFixture.js

@@ -0,0 +1,43 @@
+import { MultiNodeSpec } from './MultiNodeSpec.js';
+export const MultiNodeClusterFixture = {
+    /**
+     * Register a multi-node cluster fixture in the current describe
+     * block.  Returns a handle whose `.spec()` is callable inside any
+     * `test()` in the same block.
+     *
+     * The implementation captures `options` lazily — start happens
+     * inside the registered `beforeAll`, not at `create()` time.
+     * Bun's TestKit also hadn't started any actor systems yet at
+     * describe-registration time, so any side effects of MultiNodeSpec
+     * construction would be wasted if a sibling `test.skip`/filter
+     * skipped this block.
+     */
+    create(options, hooks) {
+        let spec = null;
+        let started = false;
+        hooks.beforeAll(async () => {
+            spec = new MultiNodeSpec(options);
+            await spec.start();
+            started = true;
+        });
+        hooks.afterAll(async () => {
+            if (spec && started) {
+                await spec.stop();
+                spec = null;
+                started = false;
+            }
+        });
+        return {
+            spec() {
+                if (!spec) {
+                    throw new Error('MultiNodeClusterFixture.spec(): the fixture has not started yet.  ' +
+                        'Call this from inside a `test()` body — the beforeAll hook only runs ' +
+                        'after all tests in the describe block are registered.');
+                }
+                return spec;
+            },
+            isStarted() { return started; },
+        };
+    },
+};
+//# sourceMappingURL=MultiNodeClusterFixture.js.map

package/dist/testkit/MultiNodeClusterFixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeClusterFixture.js","sourceRoot":"","sources":["../../src/testkit/MultiNodeClusterFixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkDnD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,OAAiC,EACjC,KAAsB;QAEtB,IAAI,IAAI,GAAyB,IAAI,CAAC;QACtC,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YACzB,IAAI,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI;gBACF,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CACb,oEAAoE;wBACpE,uEAAuE;wBACvE,uDAAuD,CACxD,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,SAAS,KAAc,OAAO,OAAO,CAAC,CAAC,CAAC;SACzC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/testkit/MultiNodeSpec.d.ts

@@ -1,90 +1,14 @@
+import type { MultiNodeSpecOptions } from './MultiNodeSpecOptions.js';
 import { ActorSystem } from '../ActorSystem.js';
-import { Cluster, type ClusterSettings } from '../cluster/Cluster.js';
-import type { DowningProvider } from '../cluster/downing/index.js';
+import { Cluster } from '../cluster/Cluster.js';
 import { type Member } from '../cluster/Member.js';
 import { NodeAddress } from '../cluster/NodeAddress.js';
-import { LogLevel } from '../Logger.js';
-/**
- * Multi-node-spec test harness — runs multiple `ActorSystem` + `Cluster`
- * instances in **one** process, routed through `MultiNodeTransport`,
- * with helpers for the operations real multi-node tests actually need:
- *
- *   - **Spin up N roles** at once (`new MultiNodeSpec({ roles: ['a','b','c'] })`),
- *     each with its own ActorSystem + Cluster + NodeAddress.  The first
- *     role acts as the seed by default.
- *   - **Cluster API access** per role — `clusterFor('a')`, `systemFor('b')`.
- *   - **Crash simulation** — `crash(role)` shuts down a node's transport
- *     ungracefully (other nodes detect via failure-detection); `leave(role)`
- *     does a graceful exit.
- *   - **Network partition** — `partition(roleA, roleB)` bidirectionally
- *     blocks messages between the two roles; `heal(...)` undoes it.
- *   - **Synchronization helpers** — `awaitMembers`, `awaitMemberStatus`,
- *     `awaitLeader` — poll-based assertions with a default 10 s timeout
- *     so race-prone multi-node tests have a deterministic exit point
- *     (rather than hanging forever).
- *
- * In-process means single event-loop — that loses true parallelism, but
- * gains determinism, fast test starts, and clean stack traces.  The
- * worker-thread-based variant could be a follow-up if real concurrency
- * matters.  For the scenarios we're targeting (sharding rebalance,
- * pubsub cross-node, singleton failover), in-process is enough.
- *
- *   const spec = new MultiNodeSpec({ roles: ['a', 'b', 'c'] });
- *   await spec.start();
- *   await spec.awaitMembers('a', 3);
- *
- *   spec.systemFor('b').spawnAnonymous(...);
- *   await spec.crash('b');
- *   await spec.awaitMembers('a', 2);
- *
- *   await spec.stop();
- */
-export interface MultiNodeSpecSettings {
-    /** Role names — also act as system names; must be unique within the spec. */
-    readonly roles: ReadonlyArray<string>;
-    /**
-     * Roles that act as bootstrap seeds.  Defaults to `[roles[0]]` — the
-     * first role is the lone seed.  All other roles try to join via the
-     * seed list.
-     */
-    readonly seedRoles?: ReadonlyArray<string>;
-    /**
-     * Per-role address overrides.  Useful if a test wants pinned
-     * host:port pairs (e.g. for log readability).  If omitted, addresses
-     * are auto-allocated as `127.0.0.1:<base + index>` with a fresh base
-     * per spec.
-     */
-    readonly addresses?: Readonly<Record<string, {
-        host: string;
-        port: number;
-    }>>;
-    /**
-     * Failure-detector overrides.  Multi-node tests typically want the
-     * detector tightened so dead nodes are noticed within seconds rather
-     * than the production default.  See `Cluster.ts` for the field set.
-     */
-    readonly failureDetector?: ClusterSettings['failureDetector'];
-    /** Gossip interval, default 100 ms (vs production 1 s). */
-    readonly gossipIntervalMs?: number;
-    /** How long synchronous `await*` helpers wait before throwing.  Default 10 s. */
-    readonly awaitTimeoutMs?: number;
-    /** Logger — defaults to NoopLogger so tests stay quiet. */
-    readonly logLevel?: LogLevel;
-    /**
-     * Per-role split-brain resolver factory.  Called once per role at
-     * `start()` time; the returned provider is wired into that role's
-     * cluster via `ClusterSettings.downing`.  Each role typically gets
-     * its OWN provider instance (some strategies are stateful — e.g.
-     * `LeaseMajority` holds a per-replica acquire result).  Pass
-     * `undefined` for a role that should run without downing.
-     */
-    readonly downing?: (role: string) => DowningProvider | undefined;
-}
 export declare class MultiNodeSpec {
-    private readonly settings;
+    private readonly options;
     private readonly nodes;
     private started;
-    constructor(settings: MultiNodeSpecSettings);
+    private readonly barriers;
+    constructor(optionsInput: MultiNodeSpecOptions);
     /** Bring up every role. */
     start(): Promise<void>;
     /** Tear down every node.  Idempotent — safe to call after `crash()`. */
@@ -125,6 +49,46 @@ export declare class MultiNodeSpec {
     awaitLeader(role: string, expectedLeaderRole: string | null, timeoutMs?: number): Promise<void>;
     private requireNode;
     private awaitCondition;
+    /**
+     * Akka-style cross-node test synchronisation.  Each role calls
+     * `await spec.enterBarrier(name, role)` at a point where every other
+     * role must also have reached the same point.  Resolves only when
+     * every role has called in; rejects on timeout if the deadline
+     * elapses before all expected entrants arrive.
+     *
+     * `expectedRoles` defaults to the full role set, but you can pin a
+     * subset when a barrier is only between a few of them
+     * (e.g. {@link partition(a, b)} testing — `enterBarrier('partitioned',
+     * 'a', { participants: ['a','b'] })`).
+     *
+     * Re-entering an already-completed barrier with the same name
+     * works — the barrier slot is reset once everyone has arrived, so
+     * subsequent rounds use the same name fresh.
+     *
+     * Use in tests:
+     *
+     *   const spec = new MultiNodeSpec({ roles: ['a','b','c'] });
+     *   await spec.start();
+     *   await Promise.all([
+     *     (async () => {
+     *       // Per-role setup work
+     *       await spec.enterBarrier('configured', 'a');
+     *       // Continue once b and c are also configured
+     *     })(),
+     *     (async () => { ... await spec.enterBarrier('configured', 'b'); })(),
+     *     (async () => { ... await spec.enterBarrier('configured', 'c'); })(),
+     *   ]);
+     */
+    enterBarrier(name: string, role: string, opts?: {
+        readonly participants?: ReadonlyArray<string>;
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    /**
+     * Number of currently-tracked barriers — diagnostic / test
+     * introspection hook.  Mostly there for tests that want to verify
+     * a barrier slot got cleaned up after every role entered.
+     */
+    get pendingBarrierCount(): number;
     private snapshotMemberCount;
     private snapshotMembers;
     private snapshotLeader;

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

@@ -1 +1 @@
-{"version":3,"file":"MultiNodeSpec.d.ts","sourceRoot":"","sources":["../../src/testkit/MultiNodeSpec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MultiNodeSpec.d.ts","sourceRoot":"","sources":["../../src/testkit/MultiNodeSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAkExD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CACwD;IAChF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,YAAY,EAAE,oBAAoB;IAoB9C,2BAA2B;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyD5B,wEAAwE;IAClE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IACpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IACrC,0EAA0E;IAC1E,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,qEAAqE;IAC/D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,wFAAwF;IACxF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO7C,sCAAsC;IACtC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASxC;;;OAGG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,MAAoC,GACnF,OAAO,CAAC,IAAI,CAAC;IAYhB;;;OAGG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EAC1D,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,IAAI,CAAC;IAahB;;;OAGG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,EAC/C,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,IAAI,CAAC;IAiBhB,OAAO,CAAC,WAAW;YAML,cAAc;IAa5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACxF,OAAO,CAAC,IAAI,CAAC;IA2DhB;;;;OAIG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAA+B;IAEhE,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/testkit/MultiNodeSpec.js

@@ -1,29 +1,33 @@
 import { ActorSystem } from '../ActorSystem.js';
+import { ActorSystemOptions } from '../ActorSystemOptions.js';
 import { Cluster } from '../cluster/Cluster.js';
+import { ClusterOptions } from '../cluster/ClusterOptions.js';
 import { NodeAddress } from '../cluster/NodeAddress.js';
 import { LogLevel, NoopLogger } from '../Logger.js';
 import { MultiNodeTransport } from './internal/MultiNodeTransport.js';
 let nextPortBase = 30_000;
 export class MultiNodeSpec {
-    settings;
+    options;
     nodes = new Map();
     started = false;
-    constructor(settings) {
-        if (settings.roles.length === 0) {
+    barriers = new Map();
+    constructor(optionsInput) {
+        const options = optionsInput;
+        if (options.roles.length === 0) {
             throw new Error('MultiNodeSpec: at least one role is required');
         }
-        if (new Set(settings.roles).size !== settings.roles.length) {
+        if (new Set(options.roles).size !== options.roles.length) {
             throw new Error('MultiNodeSpec: roles must be unique');
         }
-        this.settings = {
-            roles: settings.roles,
-            seedRoles: settings.seedRoles ?? [settings.roles[0]],
-            gossipIntervalMs: settings.gossipIntervalMs ?? 100,
-            awaitTimeoutMs: settings.awaitTimeoutMs ?? 10_000,
-            logLevel: settings.logLevel ?? LogLevel.Off,
-            addresses: settings.addresses,
-            failureDetector: settings.failureDetector,
-            downing: settings.downing,
+        this.options = {
+            roles: options.roles,
+            seedRoles: options.seedRoles ?? [options.roles[0]],
+            gossipIntervalMs: options.gossipIntervalMs ?? 100,
+            awaitTimeoutMs: options.awaitTimeoutMs ?? 10_000,
+            logLevel: options.logLevel ?? LogLevel.Off,
+            addresses: options.addresses,
+            failureDetector: options.failureDetector,
+            downing: options.downing,
         };
     }
     /** Bring up every role. */
@@ -32,42 +36,45 @@ export class MultiNodeSpec {
             throw new Error('MultiNodeSpec: already started');
         this.started = true;
         const portBase = nextPortBase;
-        nextPortBase += this.settings.roles.length + 1;
+        nextPortBase += this.options.roles.length + 1;
         // Step 1: build the address book up front so seeds can name peers.
         const addressByRole = new Map();
-        this.settings.roles.forEach((role, idx) => {
-            const explicit = this.settings.addresses?.[role];
+        this.options.roles.forEach((role, idx) => {
+            const explicit = this.options.addresses?.[role];
             const host = explicit?.host ?? '127.0.0.1';
             const port = explicit?.port ?? (portBase + idx);
             addressByRole.set(role, new NodeAddress(role, host, port));
         });
-        const seeds = this.settings.seedRoles
+        const seeds = this.options.seedRoles
             .map((r) => addressByRole.get(r))
             .filter((a) => a !== undefined)
             .map((a) => a.toString());
         // Step 2: spin up systems + clusters.  Seed role is started first
         // so the others can hit it with their initial join gossip.
         const orderedRoles = [
-            ...this.settings.seedRoles,
-            ...this.settings.roles.filter((r) => !this.settings.seedRoles.includes(r)),
+            ...this.options.seedRoles,
+            ...this.options.roles.filter((r) => !this.options.seedRoles.includes(r)),
         ];
         for (const role of orderedRoles) {
             const address = addressByRole.get(role);
             const transport = new MultiNodeTransport(address);
-            const system = ActorSystem.create(role, {
-                logger: new NoopLogger(),
-                logLevel: this.settings.logLevel,
-            });
-            const cluster = await Cluster.join(system, {
-                host: address.host,
-                port: address.port,
-                seeds,
-                transport,
-                gossipIntervalMs: this.settings.gossipIntervalMs,
-                seedRetryIntervalMs: 100,
-                failureDetector: this.settings.failureDetector,
-                downing: this.settings.downing?.(role),
-            });
+            const system = ActorSystem.create(role, ActorSystemOptions.create()
+                .withLogger(new NoopLogger())
+                .withLogLevel(this.options.logLevel));
+            const clusterOptions = ClusterOptions.create()
+                .withHost(address.host)
+                .withPort(address.port)
+                .withSeeds(seeds)
+                .withTransport(transport)
+                .withGossipIntervalMs(this.options.gossipIntervalMs)
+                .withSeedRetryIntervalMs(100);
+            if (this.options.failureDetector) {
+                clusterOptions.withFailureDetector(this.options.failureDetector);
+            }
+            const downing = this.options.downing?.(role);
+            if (downing)
+                clusterOptions.withDowning(downing);
+            const cluster = await Cluster.join(system, clusterOptions);
             this.nodes.set(role, {
                 role,
                 address,
@@ -134,24 +141,24 @@ export class MultiNodeSpec {
     }
     /** Bidirectional partition between two roles.  Both sides drop traffic to the other. */
     partition(roleA, roleB) {
-        const a = this.requireNode(roleA);
-        const b = this.requireNode(roleB);
-        a.transport.partitionFromPeer(b.address);
-        b.transport.partitionFromPeer(a.address);
+        const nodeA = this.requireNode(roleA);
+        const nodeB = this.requireNode(roleB);
+        nodeA.transport.partitionFromPeer(nodeB.address);
+        nodeB.transport.partitionFromPeer(nodeA.address);
     }
     /** Undo `partition(roleA, roleB)`. */
     heal(roleA, roleB) {
-        const a = this.requireNode(roleA);
-        const b = this.requireNode(roleB);
-        a.transport.unblockOutgoing(b.address);
-        b.transport.unblockOutgoing(a.address);
+        const nodeA = this.requireNode(roleA);
+        const nodeB = this.requireNode(roleB);
+        nodeA.transport.unblockOutgoing(nodeB.address);
+        nodeB.transport.unblockOutgoing(nodeA.address);
     }
     /* --------------------------- await helpers --------------------------- */
     /**
      * Wait until the named role's view of the cluster contains exactly
      * `expectedCount` members in `up`-or-better state.  Throws on timeout.
      */
-    async awaitMembers(role, expectedCount, timeoutMs = this.settings.awaitTimeoutMs) {
+    async awaitMembers(role, expectedCount, timeoutMs = this.options.awaitTimeoutMs) {
         await this.awaitCondition(() => {
             const cluster = this.requireNode(role).cluster;
             const upCount = cluster.getMembers().filter((m) => m.status === 'up').length;
@@ -162,7 +169,7 @@ export class MultiNodeSpec {
      * Wait until the named role's view shows `targetMember` (by role name)
      * in the given status (`up`, `unreachable`, `down`, `removed`).
      */
-    async awaitMemberStatus(role, targetRole, status, timeoutMs = this.settings.awaitTimeoutMs) {
+    async awaitMemberStatus(role, targetRole, status, timeoutMs = this.options.awaitTimeoutMs) {
         const targetAddr = this.requireNode(targetRole).address.toString();
         await this.awaitCondition(() => {
             const cluster = this.requireNode(role).cluster;
@@ -174,7 +181,7 @@ export class MultiNodeSpec {
      * Wait until the named role's view of the leader is `expectedLeaderRole`,
      * or `null` to wait for "no leader".
      */
-    async awaitLeader(role, expectedLeaderRole, timeoutMs = this.settings.awaitTimeoutMs) {
+    async awaitLeader(role, expectedLeaderRole, timeoutMs = this.options.awaitTimeoutMs) {
         const expectedAddr = expectedLeaderRole
             ? this.requireNode(expectedLeaderRole).address.toString()
             : null;
@@ -201,6 +208,94 @@ export class MultiNodeSpec {
         }
         throw new Error(`MultiNodeSpec: timeout after ${timeoutMs} ms — ${description}`);
     }
+    /* --------------------------- enterBarrier (#198) ---------------------------- */
+    /**
+     * Akka-style cross-node test synchronisation.  Each role calls
+     * `await spec.enterBarrier(name, role)` at a point where every other
+     * role must also have reached the same point.  Resolves only when
+     * every role has called in; rejects on timeout if the deadline
+     * elapses before all expected entrants arrive.
+     *
+     * `expectedRoles` defaults to the full role set, but you can pin a
+     * subset when a barrier is only between a few of them
+     * (e.g. {@link partition(a, b)} testing — `enterBarrier('partitioned',
+     * 'a', { participants: ['a','b'] })`).
+     *
+     * Re-entering an already-completed barrier with the same name
+     * works — the barrier slot is reset once everyone has arrived, so
+     * subsequent rounds use the same name fresh.
+     *
+     * Use in tests:
+     *
+     *   const spec = new MultiNodeSpec({ roles: ['a','b','c'] });
+     *   await spec.start();
+     *   await Promise.all([
+     *     (async () => {
+     *       // Per-role setup work
+     *       await spec.enterBarrier('configured', 'a');
+     *       // Continue once b and c are also configured
+     *     })(),
+     *     (async () => { ... await spec.enterBarrier('configured', 'b'); })(),
+     *     (async () => { ... await spec.enterBarrier('configured', 'c'); })(),
+     *   ]);
+     */
+    async enterBarrier(name, role, opts = {}) {
+        const participants = opts.participants ?? this.options.roles;
+        if (!participants.includes(role)) {
+            throw new Error(`MultiNodeSpec.enterBarrier: role '${role}' is not in the participants list ` +
+                `[${participants.join(', ')}]`);
+        }
+        const timeoutMs = opts.timeoutMs ?? this.options.awaitTimeoutMs;
+        const expectedRoles = participants.length;
+        const key = `${name}::${participants.slice().sort().join(',')}`;
+        const existing = this.barriers.get(key);
+        const entry = existing ?? {
+            expectedRoles,
+            entered: new Set(),
+            waiters: [],
+        };
+        if (!existing)
+            this.barriers.set(key, entry);
+        if (entry.expectedRoles !== expectedRoles) {
+            throw new Error(`MultiNodeSpec.enterBarrier('${name}'): participant-set changed mid-flight ` +
+                `(was ${entry.expectedRoles} roles, now ${expectedRoles})`);
+        }
+        if (entry.entered.has(role)) {
+            throw new Error(`MultiNodeSpec.enterBarrier: role '${role}' already entered barrier '${name}'`);
+        }
+        entry.entered.add(role);
+        // Last entrant wakes everyone up.
+        if (entry.entered.size === expectedRoles) {
+            this.barriers.delete(key);
+            for (const waiter of entry.waiters) {
+                if (waiter.timer)
+                    clearTimeout(waiter.timer);
+                waiter.resolve();
+            }
+            return;
+        }
+        // Otherwise park here until the deadline or until the last
+        // entrant wakes us.
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const i = entry.waiters.findIndex((w) => w.resolve === resolve);
+                if (i >= 0)
+                    entry.waiters.splice(i, 1);
+                entry.entered.delete(role);
+                if (entry.entered.size === 0)
+                    this.barriers.delete(key);
+                reject(new Error(`MultiNodeSpec.enterBarrier('${name}'): role '${role}' timed out after ${timeoutMs}ms — ` +
+                    `entered=[${Array.from(entry.entered).join(', ')}], expected ${expectedRoles}`));
+            }, timeoutMs);
+            entry.waiters.push({ resolve, reject, timer });
+        });
+    }
+    /**
+     * Number of currently-tracked barriers — diagnostic / test
+     * introspection hook.  Mostly there for tests that want to verify
+     * a barrier slot got cleaned up after every role entered.
+     */
+    get pendingBarrierCount() { return this.barriers.size; }
     snapshotMemberCount(role) {
         try {
             const cluster = this.requireNode(role).cluster;

package/dist/testkit/MultiNodeSpec.js.map

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

package/dist/testkit/MultiNodeSpecOptions.d.ts

@@ -0,0 +1,57 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import type { ClusterOptionsType } from '../cluster/ClusterOptions.js';
+import type { DowningProvider } from '../cluster/downing/index.js';
+import type { LogLevel } from '../Logger.js';
+type AddressMap = Readonly<Record<string, {
+    host: string;
+    port: number;
+}>>;
+/** Plain options-object shape accepted by a {@link MultiNodeSpec}. */
+export interface MultiNodeSpecOptionsType {
+    /** Role names — also act as system names; must be unique within the spec. */
+    readonly roles: ReadonlyArray<string>;
+    /** Roles that act as bootstrap seeds.  Defaults to `[roles[0]]`. */
+    readonly seedRoles?: ReadonlyArray<string>;
+    /** Per-role address overrides.  Auto-allocated if omitted. */
+    readonly addresses?: AddressMap;
+    /** Failure-detector overrides (tests usually tighten the detector). */
+    readonly failureDetector?: ClusterOptionsType['failureDetector'];
+    /** Gossip interval, default 100 ms (vs production 1 s). */
+    readonly gossipIntervalMs?: number;
+    /** How long synchronous `await*` helpers wait before throwing.  Default 10 s. */
+    readonly awaitTimeoutMs?: number;
+    /** Log level — defaults to a quiet NoopLogger. */
+    readonly logLevel?: LogLevel;
+    /** Per-role split-brain resolver factory. */
+    readonly downing?: (role: string) => DowningProvider | undefined;
+}
+/** Fluent builder for {@link MultiNodeSpecOptionsType}. */
+export declare class MultiNodeSpecOptionsBuilder extends OptionsBuilder<MultiNodeSpecOptionsType> {
+    /** Start a fresh builder. */
+    static create(): MultiNodeSpecOptionsBuilder;
+    /** Role names (also system names); must be unique.  Required. */
+    withRoles(roles: ReadonlyArray<string>): this;
+    /** Roles that act as bootstrap seeds.  Defaults to the first role. */
+    withSeedRoles(seedRoles: ReadonlyArray<string>): this;
+    /** Per-role address overrides. */
+    withAddresses(addresses: AddressMap): this;
+    /** Failure-detector overrides. */
+    withFailureDetector(failureDetector: ClusterOptionsType['failureDetector']): this;
+    /** Gossip interval in ms.  Default 100. */
+    withGossipIntervalMs(gossipIntervalMs: number): this;
+    /** `await*` helper timeout in ms.  Default 10 000. */
+    withAwaitTimeoutMs(awaitTimeoutMs: number): this;
+    /** Log level.  Default quiet. */
+    withLogLevel(logLevel: LogLevel): this;
+    /** Per-role split-brain resolver factory. */
+    withDowning(downing: (role: string) => DowningProvider | undefined): this;
+}
+/**
+ * Accepted input for a {@link MultiNodeSpec}: the fluent
+ * {@link MultiNodeSpecOptionsBuilder} OR a plain {@link MultiNodeSpecOptionsType}.
+ */
+export type MultiNodeSpecOptions = MultiNodeSpecOptionsBuilder | Partial<MultiNodeSpecOptionsType>;
+/** Value alias so `MultiNodeSpecOptions.create()` / `new MultiNodeSpecOptions()` resolve to the builder. */
+export declare const MultiNodeSpecOptions: typeof MultiNodeSpecOptionsBuilder;
+export {};
+//# sourceMappingURL=MultiNodeSpecOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeSpecOptions.d.ts","sourceRoot":"","sources":["../../src/testkit/MultiNodeSpecOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAE3E,sEAAsE;AACtE,MAAM,WAAW,wBAAwB;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,eAAe,CAAC,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IACjE,2DAA2D;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;CAClE;AAED,2DAA2D;AAC3D,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,wBAAwB,CAAC;IACvF,6BAA6B;IAC7B,MAAM,CAAC,MAAM,IAAI,2BAA2B;IAI5C,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI7C,sEAAsE;IACtE,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAIrD,kCAAkC;IAClC,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAI1C,kCAAkC;IAClC,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAIjF,2CAA2C;IAC3C,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAIpD,sDAAsD;IACtD,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIhD,iCAAiC;IACjC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAItC,6CAA6C;IAC7C,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,GAAG,IAAI;CAG1E;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACnG,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}