actor-ts 0.9.1 → 0.11.0

package/dist/cluster/ClusterOptions.js.map

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

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 defaultFailureDetectorOptions: 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 options;
+    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;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEtG,eAAO,MAAM,6BAA6B,EAAE,0BAI3C,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,OAAO,CAA6B;gBAEzC,OAAO,GAAE,sBAA2B;IAMhD,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,CAA6C;CACpE"}

package/dist/cluster/FailureDetector.js

@@ -1,5 +1,6 @@
 import { fromNullable } from '../util/Option.js';
-export const defaultFailureDetectorSettings = {
+import { FailureDetectorOptionsValidator } from './FailureDetectorOptions.js';
+export const defaultFailureDetectorOptions = {
     heartbeatIntervalMs: 500,
     unreachableAfterMs: 2_000,
     downAfterMs: 5_000,
@@ -11,10 +12,12 @@ 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;
+    options;
+    constructor(options = {}) {
+        // Unset builder fields fall through to the built-in defaults.
+        this.options = { ...defaultFailureDetectorOptions, ...options };
+        new FailureDetectorOptionsValidator().validate(this.options);
     }
     /** Record that a message was received from `peer` (any message counts). */
     heartbeat(peer, now = Date.now()) {
@@ -36,15 +39,15 @@ export class FailureDetector {
         if (!sample)
             return 'healthy';
         const elapsed = now - sample.lastSeen;
-        if (elapsed >= this.settings.downAfterMs)
+        if (elapsed >= this.options.downAfterMs)
             return 'down';
-        if (elapsed >= this.settings.unreachableAfterMs)
+        if (elapsed >= this.options.unreachableAfterMs)
             return 'unreachable';
         return 'healthy';
     }
     lastSeen(peer) {
         return fromNullable(this.samples.get(peer.toString())?.lastSeen);
     }
-    get interval() { return this.settings.heartbeatIntervalMs; }
+    get interval() { return this.options.heartbeatIntervalMs; }
 }
 //# sourceMappingURL=FailureDetector.js.map

package/dist/cluster/FailureDetector.js.map

@@ -1 +1 @@
-{"version":3,"file":"FailureDetector.js","sourceRoot":"","sources":["../../src/cluster/FailureDetector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAW9D,MAAM,CAAC,MAAM,8BAA8B,GAA4B;IACrE,mBAAmB,EAAE,GAAG;IACxB,kBAAkB,EAAE,KAAK;IACzB,WAAW,EAAE,KAAK;CACnB,CAAC;AASF;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAGG;IAFrB,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,YAA6B,WAAoC,8BAA8B;QAAlE,aAAQ,GAAR,QAAQ,CAA0D;IAAG,CAAC;IAEnG,2EAA2E;IAC3E,SAAS,CAAC,IAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,6EAA6E;IAC7E,QAAQ,CAAC,IAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,CAAC,IAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,IAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC;QACtC,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;YAAE,OAAO,MAAM,CAAC;QACxD,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB;YAAE,OAAO,aAAa,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,IAAiB;QACxB,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,QAAQ,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;CACrE"}
+{"version":3,"file":"FailureDetector.js","sourceRoot":"","sources":["../../src/cluster/FailureDetector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAG9E,MAAM,CAAC,MAAM,6BAA6B,GAA+B;IACvE,mBAAmB,EAAE,GAAG;IACxB,kBAAkB,EAAE,KAAK;IACzB,WAAW,EAAE,KAAK;CACnB,CAAC;AASF;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAClB,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3B,OAAO,CAA6B;IAErD,YAAY,UAAkC,EAAE;QAC9C,8DAA8D;QAC9D,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,6BAA6B,EAAE,GAAI,OAA+C,EAAE,CAAC;QACzG,IAAI,+BAA+B,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,2EAA2E;IAC3E,SAAS,CAAC,IAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,6EAA6E;IAC7E,QAAQ,CAAC,IAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,CAAC,IAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,IAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC;QACtC,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,OAAO,MAAM,CAAC;QACvD,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,kBAAkB;YAAE,OAAO,aAAa,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,IAAiB;QACxB,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,QAAQ,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;CACpE"}

package/dist/cluster/FailureDetectorOptions.d.ts

@@ -0,0 +1,49 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/** Plain options-object shape accepted by a {@link FailureDetector}. */
+export interface FailureDetectorOptionsType {
+    /** 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;
+}
+/**
+ * Fluent builder for {@link FailureDetectorOptionsType}.  Unset fields fall
+ * through to {@link defaultFailureDetectorOptions} in the consumer, so a
+ * bare `FailureDetectorOptions.create()` yields the defaults.
+ *
+ *     new FailureDetector(
+ *       FailureDetectorOptions.create().withUnreachableAfterMs(3_000),
+ *     )
+ */
+export declare class FailureDetectorOptionsBuilder extends OptionsBuilder<FailureDetectorOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new FailureDetectorOptionsBuilder()`. */
+    static create(): FailureDetectorOptionsBuilder;
+    /** How often the detector samples and decides membership health. */
+    withHeartbeatIntervalMs(ms: number): this;
+    /** Time without heartbeat after which a peer is marked unreachable. */
+    withUnreachableAfterMs(ms: number): this;
+    /** Additional time after which an unreachable peer is declared down. */
+    withDownAfterMs(ms: number): this;
+}
+/**
+ * Validates resolved {@link FailureDetectorOptionsType} settings — every
+ * threshold is a positive duration.  (`downAfterMs` is additive time on top
+ * of `unreachableAfterMs`, not an absolute deadline, so the two are not
+ * ordered against each other.)
+ */
+export declare class FailureDetectorOptionsValidator extends OptionsValidator<FailureDetectorOptionsType> {
+    constructor();
+    protected rules(_s: Partial<FailureDetectorOptionsType>): void;
+}
+/**
+ * Accepted input for any FailureDetector-configurable constructor: the
+ * fluent {@link FailureDetectorOptionsBuilder} OR a plain
+ * {@link FailureDetectorOptionsType} object.
+ */
+export type FailureDetectorOptions = FailureDetectorOptionsBuilder | Partial<FailureDetectorOptionsType>;
+/** Value alias so `FailureDetectorOptions.create()` / `new FailureDetectorOptions()` resolve to the builder. */
+export declare const FailureDetectorOptions: typeof FailureDetectorOptionsBuilder;
+//# sourceMappingURL=FailureDetectorOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FailureDetectorOptions.d.ts","sourceRoot":"","sources":["../../src/cluster/FailureDetectorOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,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;;;;;;;;GAQG;AACH,qBAAa,6BAA8B,SAAQ,cAAc,CAAC,0BAA0B,CAAC;IAC3F,mFAAmF;IACnF,MAAM,CAAC,MAAM,IAAI,6BAA6B;IAI9C,oEAAoE;IACpE,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzC,uEAAuE;IACvE,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxC,wEAAwE;IACxE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGlC;AAED;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,gBAAgB,CAAC,0BAA0B,CAAC;;IAI/F,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;CAK/D;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AACzG,gHAAgH;AAChH,eAAO,MAAM,sBAAsB,sCAAgC,CAAC"}

package/dist/cluster/FailureDetectorOptions.js

@@ -0,0 +1,48 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link FailureDetectorOptionsType}.  Unset fields fall
+ * through to {@link defaultFailureDetectorOptions} in the consumer, so a
+ * bare `FailureDetectorOptions.create()` yields the defaults.
+ *
+ *     new FailureDetector(
+ *       FailureDetectorOptions.create().withUnreachableAfterMs(3_000),
+ *     )
+ */
+export class FailureDetectorOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new FailureDetectorOptionsBuilder()`. */
+    static create() {
+        return new FailureDetectorOptionsBuilder();
+    }
+    /** How often the detector samples and decides membership health. */
+    withHeartbeatIntervalMs(ms) {
+        return this.set('heartbeatIntervalMs', ms);
+    }
+    /** Time without heartbeat after which a peer is marked unreachable. */
+    withUnreachableAfterMs(ms) {
+        return this.set('unreachableAfterMs', ms);
+    }
+    /** Additional time after which an unreachable peer is declared down. */
+    withDownAfterMs(ms) {
+        return this.set('downAfterMs', ms);
+    }
+}
+/**
+ * Validates resolved {@link FailureDetectorOptionsType} settings — every
+ * threshold is a positive duration.  (`downAfterMs` is additive time on top
+ * of `unreachableAfterMs`, not an absolute deadline, so the two are not
+ * ordered against each other.)
+ */
+export class FailureDetectorOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('FailureDetectorOptions');
+    }
+    rules(_s) {
+        this.positiveNumber('heartbeatIntervalMs');
+        this.positiveNumber('unreachableAfterMs');
+        this.positiveNumber('downAfterMs');
+    }
+}
+/** Value alias so `FailureDetectorOptions.create()` / `new FailureDetectorOptions()` resolve to the builder. */
+export const FailureDetectorOptions = FailureDetectorOptionsBuilder;
+//# sourceMappingURL=FailureDetectorOptions.js.map

package/dist/cluster/FailureDetectorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailureDetectorOptions.js","sourceRoot":"","sources":["../../src/cluster/FailureDetectorOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAY/D;;;;;;;;GAQG;AACH,MAAM,OAAO,6BAA8B,SAAQ,cAA0C;IAC3F,mFAAmF;IACnF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,6BAA6B,EAAE,CAAC;IAC7C,CAAC;IAED,oEAAoE;IACpE,uBAAuB,CAAC,EAAU;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,EAAU;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,eAAe,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,+BAAgC,SAAQ,gBAA4C;IAC/F;QACE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAClC,CAAC;IACS,KAAK,CAAC,EAAuC;QACrD,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;CACF;AAQD,gHAAgH;AAChH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC"}

package/dist/cluster/Member.js

@@ -62,8 +62,8 @@ export class Member {
         return new Member(this.address, 'removed', this.version + 1, this.roles, removedAt);
     }
     toString() {
-        const r = this.roles.size > 0 ? ` roles=[${Array.from(this.roles).join(',')}]` : '';
-        return `Member(${this.address}, ${this.status}, v${this.version}${r})`;
+        const rolesSuffix = this.roles.size > 0 ? ` roles=[${Array.from(this.roles).join(',')}]` : '';
+        return `Member(${this.address}, ${this.status}, v${this.version}${rolesSuffix})`;
     }
 }
 //# sourceMappingURL=Member.js.map

package/dist/cluster/Member.js.map

@@ -1 +1 @@
-{"version":3,"file":"Member.js","sourceRoot":"","sources":["../../src/cluster/Member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,MAAM;IAIC;IACA;IACA;IAEA;IAPT,KAAK,CAAsB;IAEpC,YACkB,OAAoB,EACpB,MAAoB,EACpB,OAAe,EAC/B,QAA0B,EAAE,EACZ,SAAkB;QAJlB,YAAO,GAAP,OAAO,CAAa;QACpB,WAAM,GAAN,MAAM,CAAc;QACpB,YAAO,GAAP,OAAO,CAAQ;QAEf,cAAS,GAAT,SAAS,CAAS;QAElC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/D,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI;eACtB,IAAI,CAAC,MAAM,KAAK,WAAW;eAC3B,IAAI,CAAC,MAAM,KAAK,SAAS;eACzB,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAe;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;SAC9B,CAAC;QACF,8DAA8D;QAC9D,8DAA8D;QAC9D,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;YACxC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAgB;QAC9B,OAAO,IAAI,MAAM,CACf,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAClC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,KAAK,IAAI,EAAE,EAChB,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,MAAoB;QAC7B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,QAAQ;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,OAAO,UAAU,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC;IACzE,CAAC;CACF"}
+{"version":3,"file":"Member.js","sourceRoot":"","sources":["../../src/cluster/Member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,MAAM;IAIC;IACA;IACA;IAEA;IAPT,KAAK,CAAsB;IAEpC,YACkB,OAAoB,EACpB,MAAoB,EACpB,OAAe,EAC/B,QAA0B,EAAE,EACZ,SAAkB;QAJlB,YAAO,GAAP,OAAO,CAAa;QACpB,WAAM,GAAN,MAAM,CAAc;QACpB,YAAO,GAAP,OAAO,CAAQ;QAEf,cAAS,GAAT,SAAS,CAAS;QAElC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/D,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI;eACtB,IAAI,CAAC,MAAM,KAAK,WAAW;eAC3B,IAAI,CAAC,MAAM,KAAK,SAAS;eACzB,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAe;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;SAC9B,CAAC;QACF,8DAA8D;QAC9D,8DAA8D;QAC9D,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;YACxC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAgB;QAC9B,OAAO,IAAI,MAAM,CACf,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAClC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,KAAK,IAAI,EAAE,EAChB,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,MAAoB;QAC7B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,QAAQ;QACN,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO,UAAU,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,OAAO,GAAG,WAAW,GAAG,CAAC;IACnF,CAAC;CACF"}

package/dist/cluster/PhiAccrualFailureDetector.d.ts

@@ -1,24 +1,8 @@
 import { NodeAddress } from './NodeAddress.js';
 import type { FailureDecision } from './FailureDetector.js';
 import { type Option } from '../util/Option.js';
-export interface PhiAccrualSettings {
-    /** Intended heartbeat cadence.  Used to keep `interval` compatible with FailureDetector. */
-    readonly heartbeatIntervalMs: number;
-    /** Phi value above which the peer is flagged unreachable.  Typical 8–12. */
-    readonly unreachableThreshold: number;
-    /** Phi value above which the peer is flagged down.  Must be > unreachableThreshold. */
-    readonly downThreshold: number;
-    /** How many recent intervals to keep in the sliding window. */
-    readonly maxSampleSize: number;
-    /** Minimum stddev floor — avoids over-eager flagging for very stable peers. */
-    readonly minStdDeviationMs: number;
-    /**
-     * Grace period added to the most recent heartbeat — heartbeats that
-     * arrive up to `acceptableHeartbeatPauseMs` late do not raise phi.
-     */
-    readonly acceptableHeartbeatPauseMs: number;
-}
-export declare const defaultPhiAccrualSettings: PhiAccrualSettings;
+import type { PhiAccrualOptions, PhiAccrualOptionsType } from './PhiAccrualOptions.js';
+export declare const defaultPhiAccrualOptions: PhiAccrualOptionsType;
 /**
  * Phi-accrual failure detector (Hayashibara et al, "The Phi Accrual Failure
  * Detector", 2004).  Tracks the distribution of recent inter-arrival times
@@ -31,8 +15,8 @@ export declare const defaultPhiAccrualSettings: PhiAccrualSettings;
  */
 export declare class PhiAccrualFailureDetector {
     private readonly peers;
-    private readonly settings;
-    constructor(settings?: Partial<PhiAccrualSettings>);
+    private readonly options;
+    constructor(options?: PhiAccrualOptions);
     get interval(): number;
     /** Peer is now known.  No sample added until the first heartbeat. */
     register(peer: NodeAddress, _now?: number): void;

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

@@ -1 +1 @@
-{"version":3,"file":"PhiAccrualFailureDetector.d.ts","sourceRoot":"","sources":["../../src/cluster/PhiAccrualFailureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,uFAAuF;IACvF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;CAC7C;AAED,eAAO,MAAM,yBAAyB,EAAE,kBAOvC,CAAC;AAWF;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAUtD,IAAI,QAAQ,IAAI,MAAM,CAA8C;IAEpE,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,MAAmB,GAAG,IAAI;IAa5D,4DAA4D;IAC5D,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAsB5D,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM;IAmBxD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,eAAe;IAOpE,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAE/B,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAM3C,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,MAAM;CASf"}
+{"version":3,"file":"PhiAccrualFailureDetector.d.ts","sourceRoot":"","sources":["../../src/cluster/PhiAccrualFailureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,eAAO,MAAM,wBAAwB,EAAE,qBAOtC,CAAC;AAWF;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,OAAO,GAAE,iBAAsB;IAK3C,IAAI,QAAQ,IAAI,MAAM,CAA6C;IAEnE,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,MAAmB,GAAG,IAAI;IAa5D,4DAA4D;IAC5D,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAsB5D,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM;IAmBxD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,eAAe;IAOpE,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAE/B,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAM3C,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,MAAM;CASf"}

package/dist/cluster/PhiAccrualFailureDetector.js

@@ -1,5 +1,6 @@
 import { fromNullable } from '../util/Option.js';
-export const defaultPhiAccrualSettings = {
+import { PhiAccrualOptionsValidator } from './PhiAccrualOptions.js';
+export const defaultPhiAccrualOptions = {
     heartbeatIntervalMs: 500,
     unreachableThreshold: 8,
     downThreshold: 12,
@@ -19,17 +20,12 @@ export const defaultPhiAccrualSettings = {
  */
 export class PhiAccrualFailureDetector {
     peers = new Map();
-    settings;
-    constructor(settings = {}) {
-        this.settings = { ...defaultPhiAccrualSettings, ...settings };
-        if (this.settings.downThreshold <= this.settings.unreachableThreshold) {
-            throw new Error('PhiAccrualFailureDetector: downThreshold must exceed unreachableThreshold');
-        }
-        if (this.settings.maxSampleSize < 1) {
-            throw new Error('PhiAccrualFailureDetector: maxSampleSize must be >= 1');
-        }
+    options;
+    constructor(options = {}) {
+        this.options = { ...defaultPhiAccrualOptions, ...options };
+        new PhiAccrualOptionsValidator().validate(this.options);
     }
-    get interval() { return this.settings.heartbeatIntervalMs; }
+    get interval() { return this.options.heartbeatIntervalMs; }
     /** Peer is now known.  No sample added until the first heartbeat. */
     register(peer, _now = Date.now()) {
         const key = peer.toString();
@@ -37,7 +33,7 @@ export class PhiAccrualFailureDetector {
             this.peers.set(key, {
                 lastHeartbeat: 0,
                 everSeen: false,
-                intervals: new Array(this.settings.maxSampleSize).fill(0),
+                intervals: new Array(this.options.maxSampleSize).fill(0),
                 intervalsHead: 0,
                 intervalsCount: 0,
             });
@@ -46,51 +42,51 @@ export class PhiAccrualFailureDetector {
     /** Record a received heartbeat for `peer` at time `now`. */
     heartbeat(peer, now = Date.now()) {
         const key = peer.toString();
-        let s = this.peers.get(key);
-        if (!s) {
-            s = {
+        let state = this.peers.get(key);
+        if (!state) {
+            state = {
                 lastHeartbeat: now, everSeen: true,
-                intervals: new Array(this.settings.maxSampleSize).fill(0),
+                intervals: new Array(this.options.maxSampleSize).fill(0),
                 intervalsHead: 0, intervalsCount: 0,
             };
-            this.peers.set(key, s);
+            this.peers.set(key, state);
             return;
         }
-        if (s.lastHeartbeat > 0) {
-            const delta = now - s.lastHeartbeat;
-            s.intervals[s.intervalsHead] = delta;
-            s.intervalsHead = (s.intervalsHead + 1) % this.settings.maxSampleSize;
-            if (s.intervalsCount < this.settings.maxSampleSize)
-                s.intervalsCount++;
+        if (state.lastHeartbeat > 0) {
+            const delta = now - state.lastHeartbeat;
+            state.intervals[state.intervalsHead] = delta;
+            state.intervalsHead = (state.intervalsHead + 1) % this.options.maxSampleSize;
+            if (state.intervalsCount < this.options.maxSampleSize)
+                state.intervalsCount++;
         }
-        s.lastHeartbeat = now;
-        s.everSeen = true;
+        state.lastHeartbeat = now;
+        state.everSeen = true;
     }
     /** Current phi value for `peer` — the higher, the more suspicious. */
     phi(peer, now = Date.now()) {
-        const s = this.peers.get(peer.toString());
-        if (!s || !s.everSeen)
+        const state = this.peers.get(peer.toString());
+        if (!state || !state.everSeen)
             return 0;
-        const effectiveElapsed = Math.max(0, now - s.lastHeartbeat - this.settings.acceptableHeartbeatPauseMs);
+        const effectiveElapsed = Math.max(0, now - state.lastHeartbeat - this.options.acceptableHeartbeatPauseMs);
         // Before enough samples are collected, fall back to the intended
         // cadence so very new peers don't immediately look unreachable.
-        const mean = s.intervalsCount > 0 ? this.mean(s) : this.settings.heartbeatIntervalMs;
-        const stddev = Math.max(this.settings.minStdDeviationMs, this.stddev(s, mean));
+        const mean = state.intervalsCount > 0 ? this.mean(state) : this.options.heartbeatIntervalMs;
+        const stddev = Math.max(this.options.minStdDeviationMs, this.stddev(state, mean));
         // Use the classic Hayashibara formulation with a normal distribution.
         // phi = -log10(P(delay > elapsed))
         // Where P(delay > x) ≈ 1 - Φ((x - mean) / stddev).
-        const y = (effectiveElapsed - mean) / stddev;
+        const zScore = (effectiveElapsed - mean) / stddev;
         // Use the complementary normal CDF (from upper-tail approximation).
-        const prob = 1 - standardNormalCdf(y);
+        const prob = 1 - standardNormalCdf(zScore);
         if (prob <= 0)
             return Number.POSITIVE_INFINITY;
         return -Math.log10(prob);
     }
     decide(peer, now = Date.now()) {
         const phi = this.phi(peer, now);
-        if (phi >= this.settings.downThreshold)
+        if (phi >= this.options.downThreshold)
             return 'down';
-        if (phi >= this.settings.unreachableThreshold)
+        if (phi >= this.options.unreachableThreshold)
             return 'unreachable';
         return 'healthy';
     }
@@ -99,21 +95,21 @@ export class PhiAccrualFailureDetector {
         return fromNullable(this.peers.get(peer.toString())?.lastHeartbeat);
     }
     /* ------------------------ helpers ------------------------ */
-    mean(s) {
+    mean(state) {
         let sum = 0;
-        for (let i = 0; i < s.intervalsCount; i++)
-            sum += s.intervals[i];
-        return sum / s.intervalsCount;
+        for (let i = 0; i < state.intervalsCount; i++)
+            sum += state.intervals[i];
+        return sum / state.intervalsCount;
     }
-    stddev(s, mean) {
-        if (s.intervalsCount < 2)
+    stddev(state, mean) {
+        if (state.intervalsCount < 2)
             return 0;
         let acc = 0;
-        for (let i = 0; i < s.intervalsCount; i++) {
-            const d = s.intervals[i] - mean;
-            acc += d * d;
+        for (let i = 0; i < state.intervalsCount; i++) {
+            const deviation = state.intervals[i] - mean;
+            acc += deviation * deviation;
         }
-        return Math.sqrt(acc / s.intervalsCount);
+        return Math.sqrt(acc / state.intervalsCount);
     }
 }
 /** Standard-normal CDF via Abramowitz & Stegun 26.2.17 (good to ~7e-4). */

package/dist/cluster/PhiAccrualFailureDetector.js.map

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

package/dist/cluster/PhiAccrualOptions.d.ts

@@ -0,0 +1,64 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/** Plain options-object shape accepted by a {@link PhiAccrualFailureDetector}. */
+export interface PhiAccrualOptionsType {
+    /** Intended heartbeat cadence.  Used to keep `interval` compatible with FailureDetector. */
+    readonly heartbeatIntervalMs: number;
+    /** Phi value above which the peer is flagged unreachable.  Typical 8–12. */
+    readonly unreachableThreshold: number;
+    /** Phi value above which the peer is flagged down.  Must be > unreachableThreshold. */
+    readonly downThreshold: number;
+    /** How many recent intervals to keep in the sliding window. */
+    readonly maxSampleSize: number;
+    /** Minimum stddev floor — avoids over-eager flagging for very stable peers. */
+    readonly minStdDeviationMs: number;
+    /**
+     * Grace period added to the most recent heartbeat — heartbeats that
+     * arrive up to `acceptableHeartbeatPauseMs` late do not raise phi.
+     */
+    readonly acceptableHeartbeatPauseMs: number;
+}
+/**
+ * Fluent builder for {@link PhiAccrualOptionsType}.  Unset fields fall
+ * through to {@link defaultPhiAccrualOptions} in the constructor, so a
+ * bare `PhiAccrualOptions.create()` yields the defaults.
+ *
+ *     new PhiAccrualFailureDetector(
+ *       PhiAccrualOptions.create().withUnreachableThreshold(10).withDownThreshold(16),
+ *     )
+ */
+export declare class PhiAccrualOptionsBuilder extends OptionsBuilder<PhiAccrualOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new PhiAccrualOptionsBuilder()`. */
+    static create(): PhiAccrualOptionsBuilder;
+    /** Intended heartbeat cadence — keeps `interval` compatible with FailureDetector. */
+    withHeartbeatIntervalMs(ms: number): this;
+    /** Phi value above which the peer is flagged unreachable.  Typical 8–12. */
+    withUnreachableThreshold(phi: number): this;
+    /** Phi value above which the peer is flagged down.  Must exceed `unreachableThreshold`. */
+    withDownThreshold(phi: number): this;
+    /** How many recent intervals to keep in the sliding window. */
+    withMaxSampleSize(n: number): this;
+    /** Minimum stddev floor — avoids over-eager flagging for very stable peers. */
+    withMinStdDeviationMs(ms: number): this;
+    /** Grace period added to the most recent heartbeat before phi rises. */
+    withAcceptableHeartbeatPauseMs(ms: number): this;
+}
+/**
+ * Validates resolved {@link PhiAccrualOptionsType} settings — every field is
+ * a positive duration/count, and `downThreshold` must exceed
+ * `unreachableThreshold` (a non-strictly-ordered pair would flag peers down
+ * before they are ever unreachable).
+ */
+export declare class PhiAccrualOptionsValidator extends OptionsValidator<PhiAccrualOptionsType> {
+    constructor();
+    protected rules(s: Partial<PhiAccrualOptionsType>): void;
+}
+/**
+ * Accepted input for any PhiAccrual-configurable constructor: the fluent
+ * {@link PhiAccrualOptionsBuilder} OR a plain {@link PhiAccrualOptionsType}
+ * object.
+ */
+export type PhiAccrualOptions = PhiAccrualOptionsBuilder | Partial<PhiAccrualOptionsType>;
+/** Value alias so `PhiAccrualOptions.create()` / `new PhiAccrualOptions()` resolve to the builder. */
+export declare const PhiAccrualOptions: typeof PhiAccrualOptionsBuilder;
+//# sourceMappingURL=PhiAccrualOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PhiAccrualOptions.d.ts","sourceRoot":"","sources":["../../src/cluster/PhiAccrualOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,kFAAkF;AAClF,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,uFAAuF;IACvF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACjF,8EAA8E;IAC9E,MAAM,CAAC,MAAM,IAAI,wBAAwB;IAIzC,qFAAqF;IACrF,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzC,4EAA4E;IAC5E,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3C,2FAA2F;IAC3F,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIpC,+DAA+D;IAC/D,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlC,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvC,wEAAwE;IACxE,8BAA8B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGjD;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB,CAAC,qBAAqB,CAAC;;IAIrF,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;CAezD;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAC1F,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,iCAA2B,CAAC"}

package/dist/cluster/PhiAccrualOptions.js

@@ -0,0 +1,68 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link PhiAccrualOptionsType}.  Unset fields fall
+ * through to {@link defaultPhiAccrualOptions} in the constructor, so a
+ * bare `PhiAccrualOptions.create()` yields the defaults.
+ *
+ *     new PhiAccrualFailureDetector(
+ *       PhiAccrualOptions.create().withUnreachableThreshold(10).withDownThreshold(16),
+ *     )
+ */
+export class PhiAccrualOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new PhiAccrualOptionsBuilder()`. */
+    static create() {
+        return new PhiAccrualOptionsBuilder();
+    }
+    /** Intended heartbeat cadence — keeps `interval` compatible with FailureDetector. */
+    withHeartbeatIntervalMs(ms) {
+        return this.set('heartbeatIntervalMs', ms);
+    }
+    /** Phi value above which the peer is flagged unreachable.  Typical 8–12. */
+    withUnreachableThreshold(phi) {
+        return this.set('unreachableThreshold', phi);
+    }
+    /** Phi value above which the peer is flagged down.  Must exceed `unreachableThreshold`. */
+    withDownThreshold(phi) {
+        return this.set('downThreshold', phi);
+    }
+    /** How many recent intervals to keep in the sliding window. */
+    withMaxSampleSize(n) {
+        return this.set('maxSampleSize', n);
+    }
+    /** Minimum stddev floor — avoids over-eager flagging for very stable peers. */
+    withMinStdDeviationMs(ms) {
+        return this.set('minStdDeviationMs', ms);
+    }
+    /** Grace period added to the most recent heartbeat before phi rises. */
+    withAcceptableHeartbeatPauseMs(ms) {
+        return this.set('acceptableHeartbeatPauseMs', ms);
+    }
+}
+/**
+ * Validates resolved {@link PhiAccrualOptionsType} settings — every field is
+ * a positive duration/count, and `downThreshold` must exceed
+ * `unreachableThreshold` (a non-strictly-ordered pair would flag peers down
+ * before they are ever unreachable).
+ */
+export class PhiAccrualOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('PhiAccrualOptions');
+    }
+    rules(s) {
+        this.positiveNumber('heartbeatIntervalMs');
+        this.positiveNumber('unreachableThreshold');
+        this.positiveNumber('downThreshold');
+        this.positiveInt('maxSampleSize');
+        this.positiveNumber('minStdDeviationMs');
+        this.nonNegativeNumber('acceptableHeartbeatPauseMs');
+        if (s.downThreshold !== undefined &&
+            s.unreachableThreshold !== undefined &&
+            s.downThreshold <= s.unreachableThreshold) {
+            this.fail('downThreshold', 'must exceed unreachableThreshold', s.downThreshold);
+        }
+    }
+}
+/** Value alias so `PhiAccrualOptions.create()` / `new PhiAccrualOptions()` resolve to the builder. */
+export const PhiAccrualOptions = PhiAccrualOptionsBuilder;
+//# sourceMappingURL=PhiAccrualOptions.js.map

package/dist/cluster/PhiAccrualOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhiAccrualOptions.js","sourceRoot":"","sources":["../../src/cluster/PhiAccrualOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAqB/D;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAqC;IACjF,8EAA8E;IAC9E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,qFAAqF;IACrF,uBAAuB,CAAC,EAAU;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,4EAA4E;IAC5E,wBAAwB,CAAC,GAAW;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,2FAA2F;IAC3F,iBAAiB,CAAC,GAAW;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,+DAA+D;IAC/D,iBAAiB,CAAC,CAAS;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,+EAA+E;IAC/E,qBAAqB,CAAC,EAAU;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,wEAAwE;IACxE,8BAA8B,CAAC,EAAU;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAuC;IACrF;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7B,CAAC;IACS,KAAK,CAAC,CAAiC;QAC/C,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;QAC5C,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;QACzC,IAAI,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAC;QACrD,IACE,CAAC,CAAC,aAAa,KAAK,SAAS;YAC7B,CAAC,CAAC,oBAAoB,KAAK,SAAS;YACpC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,oBAAoB,EACzC,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,kCAAkC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF;AAQD,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC"}