actor-ts 0.9.0 → 0.10.0

package/dist/cluster/ClusterClient.js

@@ -42,17 +42,30 @@ import { DEFAULT_ASK_TIMEOUT_MS } from '../util/Constants.js';
 import { NodeAddress } from './NodeAddress.js';
 import { encodeFrame, FrameDecoder } from './Protocol.js';
 const HELLO_TIMEOUT_MS = 5_000;
-let _askCounter = 0;
+/**
+ * Generate an unpredictable ask ID.  Used by `ClusterClient.ask()` to
+ * route a `cluster-client-reply` frame back to the right pending
+ * promise.
+ *
+ * **Security note (#120)**: previously this was `c${Date.now()}-${counter}`,
+ * which an attacker on the wire (MitM on plaintext, malicious cluster
+ * peer, or someone with frame-level write access via TLS-stripping
+ * proxy) could predict and use to inject a forged reply BEFORE the
+ * legitimate one arrives.  `crypto.randomUUID()` gives 122 bits of
+ * entropy per call — guessing the next ID is computationally
+ * infeasible.  Frame replies whose ID doesn't match a current
+ * pending entry are dropped by `handleReply()` (existing behaviour).
+ */
 function nextAskId() {
-    _askCounter = (_askCounter + 1) >>> 0;
-    return `c${Date.now()}-${_askCounter}`;
+    return globalThis.crypto.randomUUID();
 }
+/** @internal — test-only handle for the predictability regression. */
+export const _nextAskIdForTest = nextAskId;
 /**
  * Connect to a cluster via one of the listed contact-points and exchange
  * messages with actors on the cluster.  See the file header for scope.
  */
 export class ClusterClient {
-    settings;
     contactPoints;
     identity;
     tls;
@@ -66,7 +79,9 @@ export class ClusterClient {
     stopped = false;
     /** Filled by `hello-ack`; the contact-point's real address (post-handshake). */
     contactPointPeer = null;
-    constructor(settings) {
+    settings;
+    constructor(options) {
+        const settings = options;
         this.settings = settings;
         if (!settings.contactPoints || settings.contactPoints.length === 0) {
             throw new Error('ClusterClient: contactPoints must contain at least one entry');
@@ -86,7 +101,7 @@ export class ClusterClient {
         this.identity = new NodeAddress(sysName, id.host, id.port);
         this.tls = settings.tls ?? null;
         this.askTimeoutMs = settings.askTimeoutMs ?? DEFAULT_ASK_TIMEOUT_MS;
-        this.log = settings.log ?? new ConsoleLogger(LogLevel.Warn, 'cluster-client');
+        this.log = settings.logger ?? new ConsoleLogger(LogLevel.Warn, 'cluster-client');
     }
     /** The synthetic identity this client uses in its `hello` handshake. */
     get clientAddress() { return this.identity; }

package/dist/cluster/ClusterClient.js.map

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

package/dist/cluster/ClusterClientOptions.d.ts

@@ -0,0 +1,65 @@
+import type { TlsTransportSettings } from '../runtime/tcp/index.js';
+import type { Logger } from '../Logger.js';
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Plain settings-object shape accepted by a {@link ClusterClient}. */
+export interface ClusterClientOptionsType {
+    /**
+     * Cluster nodes to dial.  Each is a `host:port` or `<system>@host:port`
+     * string — the same shape `Cluster.join` accepts for seeds.  Tried in
+     * order; on dial failure the next is attempted.
+     */
+    readonly contactPoints: ReadonlyArray<string>;
+    /** Synthetic system name embedded in the client's hello.  Default: 'cluster-client'. */
+    readonly systemName?: string;
+    /**
+     * Host + port the client claims as its identity.  The cluster uses this
+     * to route `cluster-client-reply` frames back over the right connection.
+     * Use a host:port that uniquely identifies this client instance — random
+     * defaults are fine because the cluster only needs it for connection
+     * routing, not for actual networking back to the client.
+     */
+    readonly clientIdentity?: {
+        readonly host: string;
+        readonly port: number;
+    };
+    /** Default ask timeout (ms).  Default: 5_000. */
+    readonly askTimeoutMs?: number;
+    /** Optional TLS config — must match the cluster's. */
+    readonly tls?: TlsTransportSettings;
+    /** Custom logger; default: ConsoleLogger at WARN. */
+    readonly logger?: Logger;
+}
+/**
+ * Fluent builder for {@link ClusterClientOptionsType}:
+ *
+ *     new ClusterClient(
+ *       ClusterClientOptions.create()
+ *         .withContactPoints(['sys@127.0.0.1:2551'])
+ *         .withAskTimeoutMs(3_000),
+ *     );
+ */
+export declare class ClusterClientOptionsBuilder extends OptionsBuilder<ClusterClientOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new ClusterClientOptionsBuilder()`. */
+    static create(): ClusterClientOptionsBuilder;
+    /** Cluster nodes to dial (`host:port` or `<system>@host:port`).  Tried in order. */
+    withContactPoints(contactPoints: ReadonlyArray<string>): this;
+    /** Synthetic system name embedded in the client's hello.  Default `cluster-client`. */
+    withSystemName(systemName: string): this;
+    /** Host + port the client claims as its identity for reply routing. */
+    withClientIdentity(host: string, port: number): this;
+    /** Default ask timeout in ms.  Default 5 s. */
+    withAskTimeoutMs(ms: number): this;
+    /** TLS config — must match the cluster's. */
+    withTls(tls: TlsTransportSettings): this;
+    /** Custom logger; default ConsoleLogger at WARN. */
+    withLogger(logger: Logger): this;
+}
+/**
+ * Accepted input for the {@link ClusterClient} constructor: the fluent
+ * {@link ClusterClientOptionsBuilder} OR a plain
+ * {@link ClusterClientOptionsType} object.
+ */
+export type ClusterClientOptions = ClusterClientOptionsBuilder | Partial<ClusterClientOptionsType>;
+/** Value alias so `ClusterClientOptions.create()` / `new ClusterClientOptions()` resolve to the builder. */
+export declare const ClusterClientOptions: typeof ClusterClientOptionsBuilder;
+//# sourceMappingURL=ClusterClientOptions.d.ts.map

package/dist/cluster/ClusterClientOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterClientOptions.d.ts","sourceRoot":"","sources":["../../src/cluster/ClusterClientOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,wBAAwB,CAAC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM,IAAI,2BAA2B;IAI5C,oFAAoF;IACpF,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI7D,uFAAuF;IACvF,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,uEAAuE;IACvE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpD,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC,6CAA6C;IAC7C,OAAO,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI;IAIxC,oDAAoD;IACpD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGjC;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACnG,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}

package/dist/cluster/ClusterClientOptions.js

@@ -0,0 +1,43 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ClusterClientOptionsType}:
+ *
+ *     new ClusterClient(
+ *       ClusterClientOptions.create()
+ *         .withContactPoints(['sys@127.0.0.1:2551'])
+ *         .withAskTimeoutMs(3_000),
+ *     );
+ */
+export class ClusterClientOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ClusterClientOptionsBuilder()`. */
+    static create() {
+        return new ClusterClientOptionsBuilder();
+    }
+    /** Cluster nodes to dial (`host:port` or `<system>@host:port`).  Tried in order. */
+    withContactPoints(contactPoints) {
+        return this.set('contactPoints', contactPoints);
+    }
+    /** Synthetic system name embedded in the client's hello.  Default `cluster-client`. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+    /** Host + port the client claims as its identity for reply routing. */
+    withClientIdentity(host, port) {
+        return this.set('clientIdentity', { host, port });
+    }
+    /** Default ask timeout in ms.  Default 5 s. */
+    withAskTimeoutMs(ms) {
+        return this.set('askTimeoutMs', ms);
+    }
+    /** TLS config — must match the cluster's. */
+    withTls(tls) {
+        return this.set('tls', tls);
+    }
+    /** Custom logger; default ConsoleLogger at WARN. */
+    withLogger(logger) {
+        return this.set('logger', logger);
+    }
+}
+/** Value alias so `ClusterClientOptions.create()` / `new ClusterClientOptions()` resolve to the builder. */
+export const ClusterClientOptions = ClusterClientOptionsBuilder;
+//# sourceMappingURL=ClusterClientOptions.js.map

package/dist/cluster/ClusterClientOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterClientOptions.js","sourceRoot":"","sources":["../../src/cluster/ClusterClientOptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA4B3D;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAAwC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC3C,CAAC;IAED,oFAAoF;IACpF,iBAAiB,CAAC,aAAoC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,uFAAuF;IACvF,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,uEAAuE;IACvE,kBAAkB,CAAC,IAAY,EAAE,IAAY;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,+CAA+C;IAC/C,gBAAgB,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,6CAA6C;IAC7C,OAAO,CAAC,GAAyB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,oDAAoD;IACpD,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAQD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}

package/dist/cluster/ClusterClientReceptionist.d.ts

@@ -42,6 +42,7 @@ import type { ActorSystem } from '../ActorSystem.js';
 import { type Extension, type ExtensionId } from '../Extension.js';
 import { type NodeAddressData } from './NodeAddress.js';
 import type { Cluster } from './Cluster.js';
+import type { ClusterClientReceptionistOptions } from './ClusterClientReceptionistOptions.js';
 /** Inbound: a client wants to deliver `body` to actor at `to`. */
 export interface ClusterClientEnvelopeMsg {
     readonly t: 'cluster-client-envelope';
@@ -57,13 +58,6 @@ export interface ClusterClientReplyMsg {
     readonly ok: boolean;
     readonly body: unknown;
 }
-export interface ClusterClientReceptionistSettings {
-    /**
-     * Default ask timeout (ms) when a client envelope carries an `askId`.
-     * Default: 5_000.
-     */
-    readonly askTimeoutMs?: number;
-}
 /**
  * Per-system extension that runs once `start(cluster)` is called.
  * Registers a wire handler on the cluster transport; calling `stop()`
@@ -76,7 +70,7 @@ export declare class ClusterClientReceptionist implements Extension {
     private _unsubscribe;
     private _cluster;
     constructor(system: ActorSystem);
-    start(cluster: Cluster, settings?: ClusterClientReceptionistSettings): void;
+    start(cluster: Cluster, options?: ClusterClientReceptionistOptions): void;
     /** Stop accepting client envelopes.  Idempotent. */
     stop(): void;
     private sendReply;

package/dist/cluster/ClusterClientReceptionist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterClientReceptionist.d.ts","sourceRoot":"","sources":["../../src/cluster/ClusterClientReceptionist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,kEAAkE;AAClE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,EAAE,sBAAsB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,SAAS;IAK7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAwB;gBAEX,MAAM,EAAE,WAAW;IAEhD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,iCAAsC,GAAG,IAAI;IAwD/E,oDAAoD;IACpD,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,SAAS;CAYlB;AAED,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,yBAAyB,CAI5E,CAAC"}
+{"version":3,"file":"ClusterClientReceptionist.d.ts","sourceRoot":"","sources":["../../src/cluster/ClusterClientReceptionist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,gCAAgC,EAAwC,MAAM,uCAAuC,CAAC;AAIpI,kEAAkE;AAClE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,EAAE,sBAAsB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAID;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,SAAS;IAK7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAwB;gBAEX,MAAM,EAAE,WAAW;IAEhD,KAAK,CACH,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,gCAAqC,GAC7C,IAAI;IAyDP,oDAAoD;IACpD,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,SAAS;CAYlB;AAED,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,yBAAyB,CAI5E,CAAC"}

package/dist/cluster/ClusterClientReceptionist.js

@@ -41,6 +41,7 @@
 import { extensionId } from '../Extension.js';
 import { DEFAULT_ASK_TIMEOUT_MS } from '../util/Constants.js';
 import { NodeAddress } from './NodeAddress.js';
+/* ============================= extension ============================ */
 /**
  * Per-system extension that runs once `start(cluster)` is called.
  * Registers a wire handler on the cluster transport; calling `stop()`
@@ -55,13 +56,14 @@ export class ClusterClientReceptionist {
     constructor(system) {
         this.system = system;
     }
-    start(cluster, settings = {}) {
+    start(cluster, options = {}) {
         if (this._started && this._cluster === cluster)
             return;
         if (this._started) {
             throw new Error('ClusterClientReceptionist is already bound to a different cluster');
         }
         this._cluster = cluster;
+        const settings = options;
         const askTimeoutMs = settings.askTimeoutMs ?? DEFAULT_ASK_TIMEOUT_MS;
         const log = this.system.log.withSource(`cluster-client-receptionist@${cluster.selfAddress}`);
         this._unsubscribe = cluster._onWire('cluster-client-envelope', (msg) => {

package/dist/cluster/ClusterClientReceptionist.js.map

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

package/dist/cluster/ClusterClientReceptionistOptions.d.ts

@@ -0,0 +1,32 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/** Plain settings-object shape accepted by {@link ClusterClientReceptionist.start}. */
+export interface ClusterClientReceptionistOptionsType {
+    /**
+     * Default ask timeout (ms) when a client envelope carries an `askId`.
+     * Default: 5_000.
+     */
+    readonly askTimeoutMs?: number;
+}
+/**
+ * Fluent builder for {@link ClusterClientReceptionistOptionsType}:
+ *
+ *     receptionist.start(
+ *       cluster,
+ *       ClusterClientReceptionistOptions.create().withAskTimeoutMs(3_000),
+ *     );
+ */
+export declare class ClusterClientReceptionistOptionsBuilder extends OptionsBuilder<ClusterClientReceptionistOptionsType> {
+    /** Start a fresh builder. */
+    static create(): ClusterClientReceptionistOptionsBuilder;
+    /** Default ask timeout (ms) for client envelopes carrying an `askId`.  Default 5 s. */
+    withAskTimeoutMs(ms: number): this;
+}
+/**
+ * Accepted input for {@link ClusterClientReceptionist.start}: the fluent
+ * {@link ClusterClientReceptionistOptionsBuilder} OR a plain
+ * {@link ClusterClientReceptionistOptionsType} object.
+ */
+export type ClusterClientReceptionistOptions = ClusterClientReceptionistOptionsBuilder | Partial<ClusterClientReceptionistOptionsType>;
+/** Value alias so `ClusterClientReceptionistOptions.create()` / `new ClusterClientReceptionistOptions()` resolve to the builder. */
+export declare const ClusterClientReceptionistOptions: typeof ClusterClientReceptionistOptionsBuilder;
+//# sourceMappingURL=ClusterClientReceptionistOptions.d.ts.map

package/dist/cluster/ClusterClientReceptionistOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterClientReceptionistOptions.d.ts","sourceRoot":"","sources":["../../src/cluster/ClusterClientReceptionistOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,uFAAuF;AACvF,MAAM,WAAW,oCAAoC;IACnD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,uCAAwC,SAAQ,cAAc,CAAC,oCAAoC,CAAC;IAC/G,6BAA6B;IAC7B,MAAM,CAAC,MAAM,IAAI,uCAAuC;IAIxD,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GACxC,uCAAuC,GACvC,OAAO,CAAC,oCAAoC,CAAC,CAAC;AAClD,oIAAoI;AACpI,eAAO,MAAM,gCAAgC,gDAA0C,CAAC"}

package/dist/cluster/ClusterClientReceptionistOptions.js

@@ -0,0 +1,22 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ClusterClientReceptionistOptionsType}:
+ *
+ *     receptionist.start(
+ *       cluster,
+ *       ClusterClientReceptionistOptions.create().withAskTimeoutMs(3_000),
+ *     );
+ */
+export class ClusterClientReceptionistOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder. */
+    static create() {
+        return new ClusterClientReceptionistOptionsBuilder();
+    }
+    /** Default ask timeout (ms) for client envelopes carrying an `askId`.  Default 5 s. */
+    withAskTimeoutMs(ms) {
+        return this.set('askTimeoutMs', ms);
+    }
+}
+/** Value alias so `ClusterClientReceptionistOptions.create()` / `new ClusterClientReceptionistOptions()` resolve to the builder. */
+export const ClusterClientReceptionistOptions = ClusterClientReceptionistOptionsBuilder;
+//# sourceMappingURL=ClusterClientReceptionistOptions.js.map

package/dist/cluster/ClusterClientReceptionistOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterClientReceptionistOptions.js","sourceRoot":"","sources":["../../src/cluster/ClusterClientReceptionistOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAW3D;;;;;;;GAOG;AACH,MAAM,OAAO,uCAAwC,SAAQ,cAAoD;IAC/G,6BAA6B;IAC7B,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uCAAuC,EAAE,CAAC;IACvD,CAAC;IAED,uFAAuF;IACvF,gBAAgB,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;CACF;AAUD,oIAAoI;AACpI,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAuC,CAAC"}

package/dist/cluster/ClusterOptions.d.ts

@@ -0,0 +1,116 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import type { FailureDetectorOptionsType } from './FailureDetectorOptions.js';
+import type { Transport } from './Transport.js';
+import type { DowningProvider } from './downing/DowningProvider.js';
+/** Plain settings-object shape accepted by {@link Cluster.join}. */
+export interface ClusterOptionsType {
+    readonly host: string;
+    readonly port: number;
+    /** Other nodes this node should try to contact on startup. */
+    readonly seeds?: string[];
+    /** Role tags exposed to other members — used to constrain sharding placement. */
+    readonly roles?: string[];
+    /** Failure detector thresholds. */
+    readonly failureDetector?: Partial<FailureDetectorOptionsType>;
+    /** Override the transport (e.g. InMemoryTransport for tests). */
+    readonly transport?: Transport;
+    /** How often gossip is pushed to a random reachable peer. */
+    readonly gossipIntervalMs?: number;
+    /** How often to resend the initial join gossip to seeds until self is Up. */
+    readonly seedRetryIntervalMs?: number;
+    /**
+     * How long to keep a `removed` tombstone in the local members map
+     * before pruning it.  Tombstones exist so stale gossip from a slow
+     * peer can't resurrect a definitively-removed address; the TTL
+     * caps their accumulation in long-running clusters with frequent
+     * node churn (#75).  Default 24 h — comfortably above any
+     * realistic gossip-propagation lag.
+     */
+    readonly tombstoneTtlMs?: number;
+    /**
+     * How often the tombstone-prune pass runs.  Default 5 min — small
+     * enough that a freshly-expired tombstone disappears within one
+     * pruning window, large enough to be negligible CPU.
+     */
+    readonly tombstonePruneIntervalMs?: number;
+    /**
+     * Minimum age before a tombstone is eligible for pruning, regardless
+     * of {@link tombstoneTtlMs}.  Defaults to `6 × downAfterMs`, which
+     * gives a few failure-detector rounds of breathing room so peers
+     * that haven't fully converged still see the tombstone before it
+     * vanishes.  Mostly relevant for tests that set a very low TTL.
+     */
+    readonly tombstoneMinRetentionMs?: number;
+    /**
+     * Auto-promote a `joining` member to `weakly-up` after this many ms if
+     * convergence (leader + `up` transition) hasn't happened yet.  Set to 0
+     * to disable.  Default: 0 (disabled — opt-in only).
+     */
+    readonly weaklyUpAfterMs?: number;
+    /**
+     * Optional split-brain resolver.  When provided, the cluster invokes
+     * `provider.decide(view)` whenever a member transitions to / from
+     * `unreachable`, and force-downs every address in the returned set
+     * (regardless of failure-detector state).  Without a provider, the
+     * cluster relies solely on the failure detector's elapsed-time
+     * `unreachable → down → removed` cascade — fine for unilateral
+     * crashes, weak under network partitions.
+     *
+     * See `src/cluster/downing/` for the bundled strategies (KeepMajority,
+     * KeepOldest, KeepReferee, StaticQuorum, LeaseMajority).
+     */
+    readonly downing?: DowningProvider;
+}
+/**
+ * Fluent builder for {@link ClusterOptionsType} — the sole input to
+ * {@link Cluster.join}.  `host` + `port` are required; every other knob
+ * is optional.  Polymorphic / whole-value fields (`transport`,
+ * `downing`, `failureDetector`, `roles`, `seeds`) are passed as-is via a
+ * single `withX(value)` — no nested builders.
+ *
+ *     await Cluster.join(
+ *       system,
+ *       ClusterOptions.create()
+ *         .withHost('127.0.0.1')
+ *         .withPort(2552)
+ *         .withSeeds(['sys@127.0.0.1:2551']),
+ *     );
+ */
+export declare class ClusterOptionsBuilder extends OptionsBuilder<ClusterOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new ClusterOptionsBuilder()`. */
+    static create(): ClusterOptionsBuilder;
+    /** Bind host. */
+    withHost(host: string): this;
+    /** Bind port. */
+    withPort(port: number): this;
+    /** Other nodes this node should try to contact on startup. */
+    withSeeds(seeds: string[]): this;
+    /** Role tags exposed to other members — constrain sharding placement. */
+    withRoles(roles: string[]): this;
+    /** Failure-detector thresholds (merged over the built-in defaults). */
+    withFailureDetector(failureDetector: Partial<FailureDetectorOptionsType>): this;
+    /** Override the transport (e.g. `InMemoryTransport` for tests). */
+    withTransport(transport: Transport): this;
+    /** How often gossip is pushed to a random reachable peer. */
+    withGossipIntervalMs(ms: number): this;
+    /** How often to resend the initial join gossip to seeds until self is Up. */
+    withSeedRetryIntervalMs(ms: number): this;
+    /** How long to keep a `removed` tombstone before pruning it.  Default 24 h. */
+    withTombstoneTtlMs(ms: number): this;
+    /** How often the tombstone-prune pass runs.  Default 5 min. */
+    withTombstonePruneIntervalMs(ms: number): this;
+    /** Minimum age before a tombstone is eligible for pruning.  Default `6 × downAfterMs`. */
+    withTombstoneMinRetentionMs(ms: number): this;
+    /** Auto-promote `joining` → `weakly-up` after this many ms.  0 disables (default). */
+    withWeaklyUpAfterMs(ms: number): this;
+    /** Optional split-brain resolver (KeepMajority, KeepOldest, …). */
+    withDowning(downing: DowningProvider): this;
+}
+/**
+ * Accepted input for {@link Cluster.join}: the fluent
+ * {@link ClusterOptionsBuilder} OR a plain {@link ClusterOptionsType} object.
+ */
+export type ClusterOptions = ClusterOptionsBuilder | Partial<ClusterOptionsType>;
+/** Value alias so `ClusterOptions.create()` / `new ClusterOptions()` resolve to the builder. */
+export declare const ClusterOptions: typeof ClusterOptionsBuilder;
+//# sourceMappingURL=ClusterOptions.d.ts.map

package/dist/cluster/ClusterOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterOptions.d.ts","sourceRoot":"","sources":["../../src/cluster/ClusterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC/D,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAC3E,2EAA2E;IAC3E,MAAM,CAAC,MAAM,IAAI,qBAAqB;IAItC,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,8DAA8D;IAC9D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhC,yEAAyE;IACzE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhC,uEAAuE;IACvE,mBAAmB,CAAC,eAAe,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IAI/E,mEAAmE;IACnE,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIzC,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAItC,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzC,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC,+DAA+D;IAC/D,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9C,0FAA0F;IAC1F,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7C,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIrC,mEAAmE;IACnE,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;CAG5C;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AACjF,gGAAgG;AAChG,eAAO,MAAM,cAAc,8BAAwB,CAAC"}

package/dist/cluster/ClusterOptions.js

@@ -0,0 +1,77 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ClusterOptionsType} — the sole input to
+ * {@link Cluster.join}.  `host` + `port` are required; every other knob
+ * is optional.  Polymorphic / whole-value fields (`transport`,
+ * `downing`, `failureDetector`, `roles`, `seeds`) are passed as-is via a
+ * single `withX(value)` — no nested builders.
+ *
+ *     await Cluster.join(
+ *       system,
+ *       ClusterOptions.create()
+ *         .withHost('127.0.0.1')
+ *         .withPort(2552)
+ *         .withSeeds(['sys@127.0.0.1:2551']),
+ *     );
+ */
+export class ClusterOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ClusterOptionsBuilder()`. */
+    static create() {
+        return new ClusterOptionsBuilder();
+    }
+    /** Bind host. */
+    withHost(host) {
+        return this.set('host', host);
+    }
+    /** Bind port. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** Other nodes this node should try to contact on startup. */
+    withSeeds(seeds) {
+        return this.set('seeds', seeds);
+    }
+    /** Role tags exposed to other members — constrain sharding placement. */
+    withRoles(roles) {
+        return this.set('roles', roles);
+    }
+    /** Failure-detector thresholds (merged over the built-in defaults). */
+    withFailureDetector(failureDetector) {
+        return this.set('failureDetector', failureDetector);
+    }
+    /** Override the transport (e.g. `InMemoryTransport` for tests). */
+    withTransport(transport) {
+        return this.set('transport', transport);
+    }
+    /** How often gossip is pushed to a random reachable peer. */
+    withGossipIntervalMs(ms) {
+        return this.set('gossipIntervalMs', ms);
+    }
+    /** How often to resend the initial join gossip to seeds until self is Up. */
+    withSeedRetryIntervalMs(ms) {
+        return this.set('seedRetryIntervalMs', ms);
+    }
+    /** How long to keep a `removed` tombstone before pruning it.  Default 24 h. */
+    withTombstoneTtlMs(ms) {
+        return this.set('tombstoneTtlMs', ms);
+    }
+    /** How often the tombstone-prune pass runs.  Default 5 min. */
+    withTombstonePruneIntervalMs(ms) {
+        return this.set('tombstonePruneIntervalMs', ms);
+    }
+    /** Minimum age before a tombstone is eligible for pruning.  Default `6 × downAfterMs`. */
+    withTombstoneMinRetentionMs(ms) {
+        return this.set('tombstoneMinRetentionMs', ms);
+    }
+    /** Auto-promote `joining` → `weakly-up` after this many ms.  0 disables (default). */
+    withWeaklyUpAfterMs(ms) {
+        return this.set('weaklyUpAfterMs', ms);
+    }
+    /** Optional split-brain resolver (KeepMajority, KeepOldest, …). */
+    withDowning(downing) {
+        return this.set('downing', downing);
+    }
+}
+/** Value alias so `ClusterOptions.create()` / `new ClusterOptions()` resolve to the builder. */
+export const ClusterOptions = ClusterOptionsBuilder;
+//# sourceMappingURL=ClusterOptions.js.map

package/dist/cluster/ClusterOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterOptions.js","sourceRoot":"","sources":["../../src/cluster/ClusterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiE3D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAkC;IAC3E,2EAA2E;IAC3E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,qBAAqB,EAAE,CAAC;IACrC,CAAC;IAED,iBAAiB;IACjB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,iBAAiB;IACjB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,8DAA8D;IAC9D,SAAS,CAAC,KAAe;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,yEAAyE;IACzE,SAAS,CAAC,KAAe;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,uEAAuE;IACvE,mBAAmB,CAAC,eAAoD;QACtE,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,mEAAmE;IACnE,aAAa,CAAC,SAAoB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,6DAA6D;IAC7D,oBAAoB,CAAC,EAAU;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,6EAA6E;IAC7E,uBAAuB,CAAC,EAAU;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,+EAA+E;IAC/E,kBAAkB,CAAC,EAAU;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,+DAA+D;IAC/D,4BAA4B,CAAC,EAAU;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,0FAA0F;IAC1F,2BAA2B,CAAC,EAAU;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,sFAAsF;IACtF,mBAAmB,CAAC,EAAU;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,OAAwB;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AAOD,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC"}

package/dist/cluster/FailureDetector.d.ts

@@ -1,14 +1,7 @@
 import { NodeAddress } from './NodeAddress.js';
 import { type Option } from '../util/Option.js';
-export interface FailureDetectorSettings {
-    /** How often the detector samples and decides membership health. */
-    readonly heartbeatIntervalMs: number;
-    /** Time without heartbeat after which a peer is marked unreachable. */
-    readonly unreachableAfterMs: number;
-    /** Additional time after which an unreachable peer is declared down. */
-    readonly downAfterMs: number;
-}
-export declare const defaultFailureDetectorSettings: FailureDetectorSettings;
+import type { FailureDetectorOptions, FailureDetectorOptionsType } from './FailureDetectorOptions.js';
+export declare const defaultFailureDetectorSettings: FailureDetectorOptionsType;
 export type FailureDecision = 'healthy' | 'unreachable' | 'down';
 /**
  * A simple, deterministic failure detector.  Every heartbeat bumps the
@@ -17,9 +10,9 @@ export type FailureDecision = 'healthy' | 'unreachable' | 'down';
  * plain elapsed-time limits, which is sufficient for LAN-scale clusters.
  */
 export declare class FailureDetector {
-    private readonly settings;
     private samples;
-    constructor(settings?: FailureDetectorSettings);
+    private readonly settings;
+    constructor(options?: FailureDetectorOptions);
     /** Record that a message was received from `peer` (any message counts). */
     heartbeat(peer: NodeAddress, now?: number): void;
     /** Record that we know about a peer even if we haven't heard from it yet. */

package/dist/cluster/FailureDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FailureDetector.d.ts","sourceRoot":"","sources":["../../src/cluster/FailureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,8BAA8B,EAAE,uBAI5C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAOjE;;;;;GAKG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,OAAO,CAA6B;gBAEf,QAAQ,GAAE,uBAAwD;IAE/F,2EAA2E;IAC3E,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAM5D,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAK3D,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI/B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,eAAe;IASpE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAI3C,IAAI,QAAQ,IAAI,MAAM,CAA8C;CACrE"}
+{"version":3,"file":"FailureDetector.d.ts","sourceRoot":"","sources":["../../src/cluster/FailureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEtG,eAAO,MAAM,8BAA8B,EAAE,0BAI5C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAOjE;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,OAAO,GAAE,sBAA2B;IAKhD,2EAA2E;IAC3E,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAM5D,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAK3D,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI/B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,eAAe;IASpE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAI3C,IAAI,QAAQ,IAAI,MAAM,CAA8C;CACrE"}

package/dist/cluster/FailureDetector.js

@@ -11,10 +11,11 @@ export const defaultFailureDetectorSettings = {
  * plain elapsed-time limits, which is sufficient for LAN-scale clusters.
  */
 export class FailureDetector {
-    settings;
     samples = new Map();
-    constructor(settings = defaultFailureDetectorSettings) {
-        this.settings = settings;
+    settings;
+    constructor(options = {}) {
+        // Unset builder fields fall through to the built-in defaults.
+        this.settings = { ...defaultFailureDetectorSettings, ...options };
     }
     /** Record that a message was received from `peer` (any message counts). */
     heartbeat(peer, now = Date.now()) {