actor-ts 0.10.0 → 0.11.0

package/dist/testkit/MockCluster.js

@@ -1,27 +1,53 @@
 import { Member } from '../cluster/Member.js';
 import { LeaderChanged, MemberDown, MemberJoined, MemberLeft, MemberReachable, MemberRemoved, MemberUnreachable, MemberUp, SelfRemoved, SelfUp, } from '../cluster/ClusterEvents.js';
 import { none, some } from '../util/Option.js';
+/**
+ * Tiny in-memory mock of the {@link Cluster} read surface — for unit
+ * tests that only care about membership events and don't want to
+ * spin up a real ActorSystem + Transport.
+ *
+ * What it provides:
+ *   - `subscribe(listener)` — same shape as `Cluster.subscribe`; the
+ *     mock replays the current view as `MemberUp` events on first
+ *     subscribe, then emits events imperatively via the test helper
+ *     methods.
+ *   - `getMembers()` / `upMembers()` / `getMembersByStatus()` —
+ *     same accessor shape as the real Cluster.
+ *   - `selfAddress` — fixed at construction time.
+ *
+ * What it deliberately does NOT do:
+ *   - No Transport — `tell` / `send` paths aren't simulated.  Use
+ *     the in-memory MultiNodeSpec if you need real message flow.
+ *   - No gossip — events fire when the test driver calls them.
+ *   - No failure detection — `markUnreachable()` flips status
+ *     synchronously.
+ *
+ * Use for: testing code that subscribes to cluster events
+ * (Receptionist, Sharding, DowningProvider impls) without paying
+ * the spin-up cost of a real Cluster instance.
+ */
 export class MockCluster {
     selfAddress;
     members = new Map();
     leader;
     listeners = [];
-    constructor(settings) {
-        this.selfAddress = settings.selfAddress;
+    constructor(optionsInput) {
+        const options = optionsInput;
+        this.selfAddress = options.selfAddress;
         // Self always present.
-        const selfMember = new Member(settings.selfAddress, 'up', 1, []);
-        this.members.set(settings.selfAddress.toString(), selfMember);
-        for (const m of settings.initialMembers ?? []) {
-            this.members.set(m.address.toString(), m);
+        const selfMember = new Member(options.selfAddress, 'up', 1, []);
+        this.members.set(options.selfAddress.toString(), selfMember);
+        for (const member of options.initialMembers ?? []) {
+            this.members.set(member.address.toString(), member);
         }
-        this.leader = settings.initialLeader ?? this.computeLeader();
+        this.leader = options.initialLeader ?? this.computeLeader();
     }
     /** Match the Cluster API: replays current state on subscribe. */
     subscribe(listener) {
-        for (const m of this.members.values()) {
-            if (m.status === 'up') {
+        for (const member of this.members.values()) {
+            if (member.status === 'up') {
                 try {
-                    listener(new MemberUp(m));
+                    listener(new MemberUp(member));
                 }
                 catch { /* ignore */ }
             }
@@ -46,33 +72,33 @@ export class MockCluster {
         };
     }
     getMembers() {
-        return Array.from(this.members.values()).filter((m) => m.status !== 'removed');
+        return Array.from(this.members.values()).filter((member) => member.status !== 'removed');
     }
     upMembers() {
         return Array.from(this.members.values())
-            .filter((m) => m.status === 'up')
+            .filter((member) => member.status === 'up')
             .sort((a, b) => a.address.compareTo(b.address));
     }
     getMembersByStatus(status) {
-        return Array.from(this.members.values()).filter((m) => m.status === status);
+        return Array.from(this.members.values()).filter((member) => member.status === status);
     }
     getLeader() { return this.leader; }
     /* ------------------------------ Test driver ------------------------------ */
     /** Add a fresh peer in `joining` state and fire `MemberJoined`. */
     addMember(address, roles = []) {
-        const m = new Member(address, 'joining', 1, roles);
-        this.members.set(address.toString(), m);
-        this.emit(new MemberJoined(m));
-        return m;
+        const member = new Member(address, 'joining', 1, roles);
+        this.members.set(address.toString(), member);
+        this.emit(new MemberJoined(member));
+        return member;
     }
     /** Transition a member to `up` and fire `MemberUp` (+ LeaderChanged if it changes). */
     upMember(address) {
         const prev = this.requireMember(address);
-        const m = new Member(address, 'up', prev.version + 1, prev.roles);
-        this.members.set(address.toString(), m);
-        this.emit(new MemberUp(m));
+        const member = new Member(address, 'up', prev.version + 1, prev.roles);
+        this.members.set(address.toString(), member);
+        this.emit(new MemberUp(member));
         this.maybeLeaderChange();
-        return m;
+        return member;
     }
     /** Mark a member as unreachable; fires `MemberUnreachable`. */
     markUnreachable(address) {
@@ -92,10 +118,10 @@ export class MockCluster {
     /** Force a member down (DowningProvider triggered).  Fires `MemberDown`. */
     downMember(address) {
         const prev = this.requireMember(address);
-        const m = new Member(address, 'down', prev.version + 1, prev.roles);
-        this.members.set(address.toString(), m);
-        this.emit(new MemberDown(m));
-        return m;
+        const member = new Member(address, 'down', prev.version + 1, prev.roles);
+        this.members.set(address.toString(), member);
+        this.emit(new MemberDown(member));
+        return member;
     }
     /** Graceful leave path — fires `MemberLeft` then `MemberRemoved`. */
     leaveMember(address) {
@@ -118,8 +144,8 @@ export class MockCluster {
             this.leader = none;
         }
         else {
-            const m = this.requireMember(addr);
-            this.leader = some(m);
+            const member = this.requireMember(addr);
+            this.leader = some(member);
         }
         this.emit(new LeaderChanged(this.leader));
     }
@@ -135,10 +161,10 @@ export class MockCluster {
         }
     }
     requireMember(address) {
-        const m = this.members.get(address.toString());
-        if (!m)
+        const member = this.members.get(address.toString());
+        if (!member)
             throw new Error(`MockCluster: no member with address ${address}`);
-        return m;
+        return member;
     }
     computeLeader() {
         const ups = this.upMembers();

package/dist/testkit/MockCluster.js.map

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

package/dist/testkit/MockClusterOptions.d.ts

@@ -0,0 +1,32 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import type { Member } from '../cluster/Member.js';
+import type { NodeAddress } from '../cluster/NodeAddress.js';
+import type { Option } from '../util/Option.js';
+/** Plain options-object shape accepted by a {@link MockCluster}. */
+export interface MockClusterOptionsType {
+    /** Self address — what `selfAddress` returns. */
+    readonly selfAddress: NodeAddress;
+    /** Initial members.  Self is added automatically if not present. */
+    readonly initialMembers?: ReadonlyArray<Member>;
+    /** Initial leader.  Defaults to the lowest address. */
+    readonly initialLeader?: Option<Member>;
+}
+/** Fluent builder for {@link MockClusterOptionsType}. */
+export declare class MockClusterOptionsBuilder extends OptionsBuilder<MockClusterOptionsType> {
+    /** Start a fresh builder. */
+    static create(): MockClusterOptionsBuilder;
+    /** Self address — what `selfAddress` returns.  Required. */
+    withSelfAddress(selfAddress: NodeAddress): this;
+    /** Initial members (self added automatically if absent). */
+    withInitialMembers(initialMembers: ReadonlyArray<Member>): this;
+    /** Initial leader.  Defaults to the lowest address. */
+    withInitialLeader(initialLeader: Option<Member>): this;
+}
+/**
+ * Accepted input for a {@link MockCluster}: the fluent
+ * {@link MockClusterOptionsBuilder} OR a plain {@link MockClusterOptionsType}.
+ */
+export type MockClusterOptions = MockClusterOptionsBuilder | Partial<MockClusterOptionsType>;
+/** Value alias so `MockClusterOptions.create()` / `new MockClusterOptions()` resolve to the builder. */
+export declare const MockClusterOptions: typeof MockClusterOptionsBuilder;
+//# sourceMappingURL=MockClusterOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockClusterOptions.d.ts","sourceRoot":"","sources":["../../src/testkit/MockClusterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,uDAAuD;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,yDAAyD;AACzD,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,sBAAsB,CAAC;IACnF,6BAA6B;IAC7B,MAAM,CAAC,MAAM,IAAI,yBAAyB;IAI1C,4DAA4D;IAC5D,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAI/C,4DAA4D;IAC5D,kBAAkB,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI/D,uDAAuD;IACvD,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI;CAGvD;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAC7F,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,kCAA4B,CAAC"}

package/dist/testkit/MockClusterOptions.js

@@ -0,0 +1,23 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Fluent builder for {@link MockClusterOptionsType}. */
+export class MockClusterOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder. */
+    static create() {
+        return new MockClusterOptionsBuilder();
+    }
+    /** Self address — what `selfAddress` returns.  Required. */
+    withSelfAddress(selfAddress) {
+        return this.set('selfAddress', selfAddress);
+    }
+    /** Initial members (self added automatically if absent). */
+    withInitialMembers(initialMembers) {
+        return this.set('initialMembers', initialMembers);
+    }
+    /** Initial leader.  Defaults to the lowest address. */
+    withInitialLeader(initialLeader) {
+        return this.set('initialLeader', initialLeader);
+    }
+}
+/** Value alias so `MockClusterOptions.create()` / `new MockClusterOptions()` resolve to the builder. */
+export const MockClusterOptions = MockClusterOptionsBuilder;
+//# sourceMappingURL=MockClusterOptions.js.map

package/dist/testkit/MockClusterOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockClusterOptions.js","sourceRoot":"","sources":["../../src/testkit/MockClusterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAe3D,yDAAyD;AACzD,MAAM,OAAO,yBAA0B,SAAQ,cAAsC;IACnF,6BAA6B;IAC7B,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,yBAAyB,EAAE,CAAC;IACzC,CAAC;IAED,4DAA4D;IAC5D,eAAe,CAAC,WAAwB;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,4DAA4D;IAC5D,kBAAkB,CAAC,cAAqC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,uDAAuD;IACvD,iBAAiB,CAAC,aAA6B;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;CACF;AAOD,wGAAwG;AACxG,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC"}

package/dist/testkit/MultiNodeClusterFixture.d.ts

@@ -1,4 +1,5 @@
-import { MultiNodeSpec, type MultiNodeSpecSettings } from './MultiNodeSpec.js';
+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.
@@ -50,13 +51,13 @@ export declare const MultiNodeClusterFixture: {
      * block.  Returns a handle whose `.spec()` is callable inside any
      * `test()` in the same block.
      *
-     * The implementation captures `settings` lazily — start happens
+     * 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(settings: MultiNodeSpecSettings, hooks: TestRunnerHooks): MultiNodeClusterFixture;
+    create(options: MultiNodeSpecOptionsType, hooks: TestRunnerHooks): MultiNodeClusterFixture;
 };
 //# sourceMappingURL=MultiNodeClusterFixture.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MultiNodeClusterFixture.d.ts","sourceRoot":"","sources":["../../src/testkit/MultiNodeClusterFixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;qBAES,qBAAqB,SACxB,eAAe,GACrB,uBAAuB;CAgC3B,CAAC"}
+{"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

@@ -5,18 +5,18 @@ export const MultiNodeClusterFixture = {
      * block.  Returns a handle whose `.spec()` is callable inside any
      * `test()` in the same block.
      *
-     * The implementation captures `settings` lazily — start happens
+     * 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(settings, hooks) {
+    create(options, hooks) {
         let spec = null;
         let started = false;
         hooks.beforeAll(async () => {
-            spec = new MultiNodeSpec(settings);
+            spec = new MultiNodeSpec(options);
             await spec.start();
             started = true;
         });

package/dist/testkit/MultiNodeClusterFixture.js.map

@@ -1 +1 @@
-{"version":3,"file":"MultiNodeClusterFixture.js","sourceRoot":"","sources":["../../src/testkit/MultiNodeClusterFixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA8B,MAAM,oBAAoB,CAAC;AAiD/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,QAA+B,EAC/B,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,QAAQ,CAAC,CAAC;YACnC,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"}
+{"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,92 +1,14 @@
+import type { MultiNodeSpecOptions } from './MultiNodeSpecOptions.js';
 import { ActorSystem } from '../ActorSystem.js';
 import { Cluster } from '../cluster/Cluster.js';
-import { type ClusterOptionsType } from '../cluster/ClusterOptions.js';
-import type { DowningProvider } from '../cluster/downing/index.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?: 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;
-    /** 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 `ClusterOptionsType.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;
     private readonly barriers;
-    constructor(settings: MultiNodeSpecSettings);
+    constructor(optionsInput: MultiNodeSpecOptions);
     /** Bring up every role. */
     start(): Promise<void>;
     /** Tear down every node.  Idempotent — safe to call after `crash()`. */

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

@@ -7,26 +7,27 @@ 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;
     barriers = new Map();
-    constructor(settings) {
-        if (settings.roles.length === 0) {
+    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. */
@@ -35,42 +36,42 @@ 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, ActorSystemOptions.create()
                 .withLogger(new NoopLogger())
-                .withLogLevel(this.settings.logLevel));
+                .withLogLevel(this.options.logLevel));
             const clusterOptions = ClusterOptions.create()
                 .withHost(address.host)
                 .withPort(address.port)
                 .withSeeds(seeds)
                 .withTransport(transport)
-                .withGossipIntervalMs(this.settings.gossipIntervalMs)
+                .withGossipIntervalMs(this.options.gossipIntervalMs)
                 .withSeedRetryIntervalMs(100);
-            if (this.settings.failureDetector) {
-                clusterOptions.withFailureDetector(this.settings.failureDetector);
+            if (this.options.failureDetector) {
+                clusterOptions.withFailureDetector(this.options.failureDetector);
             }
-            const downing = this.settings.downing?.(role);
+            const downing = this.options.downing?.(role);
             if (downing)
                 clusterOptions.withDowning(downing);
             const cluster = await Cluster.join(system, clusterOptions);
@@ -140,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;
@@ -168,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;
@@ -180,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;
@@ -239,12 +240,12 @@ export class MultiNodeSpec {
      *   ]);
      */
     async enterBarrier(name, role, opts = {}) {
-        const participants = opts.participants ?? this.settings.roles;
+        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.settings.awaitTimeoutMs;
+        const timeoutMs = opts.timeoutMs ?? this.options.awaitTimeoutMs;
         const expectedRoles = participants.length;
         const key = `${name}::${participants.slice().sort().join(',')}`;
         const existing = this.barriers.get(key);
@@ -266,10 +267,10 @@ export class MultiNodeSpec {
         // Last entrant wakes everyone up.
         if (entry.entered.size === expectedRoles) {
             this.barriers.delete(key);
-            for (const w of entry.waiters) {
-                if (w.timer)
-                    clearTimeout(w.timer);
-                w.resolve();
+            for (const waiter of entry.waiters) {
+                if (waiter.timer)
+                    clearTimeout(waiter.timer);
+                waiter.resolve();
             }
             return;
         }