actor-ts 0.9.0

package/dist/cluster/ClusterEvents.js

@@ -0,0 +1,124 @@
+/* -------------------------------- Self events ------------------------------ */
+/** Fired on the local node when its own member transitions to Up. */
+export class SelfUp {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/**
+ * Fired on the local node when its own member has been removed.
+ * After this event fires, the local cluster instance is effectively
+ * dead — call `system.terminate()` to clean up.  The tombstone
+ * behaviour described on {@link MemberRemoved} also applies: peers
+ * keep this node's address as a `removed` tombstone until their
+ * `tombstoneTtlMs` (default 24 h) expires (#75).
+ */
+export class SelfRemoved {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** Fired on the local node when the cluster leader has changed. */
+export class LeaderChanged {
+    leader;
+    constructor(leader) {
+        this.leader = leader;
+    }
+}
+/* ------------------------------- Member events ----------------------------- */
+/** A member was added to the cluster (first time we see it). */
+export class MemberJoined {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** A member transitioned to the Up state and is ready to receive work. */
+export class MemberUp {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** A joining member has been tentatively upgraded to WeaklyUp. */
+export class MemberWeaklyUp {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** Heartbeats have been missed; the member may still come back. */
+export class MemberUnreachable {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** Previously-unreachable member responded again. */
+export class MemberReachable {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** Confirmed down — taken out of the cluster and shards re-assigned. */
+export class MemberDown {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** Member is leaving gracefully (after calling cluster.leave()). */
+export class MemberLeft {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/**
+ * Member removed from the cluster.  Fires on two distinct paths:
+ *
+ *   - **Definitive removal** — `handleLeave` (peer sent `leave`)
+ *     and `evaluateDowning` (force-down via a `DowningProvider`)
+ *     mark the address as a **tombstone**: the entry stays in the
+ *     local `members` map with `status === 'removed'` and a
+ *     `removedAt` timestamp, so stale gossip from a slow peer
+ *     can't resurrect the address.  The tombstone is reclaimed
+ *     by `tombstonePruneTick` once `tombstoneTtlMs` (default 24 h)
+ *     has elapsed — see #75 for the full lifecycle.
+ *   - **FD-driven** — the failure detector's elapsed-time
+ *     `unreachable → down → removed` cascade.  Here the entry is
+ *     deleted outright (no tombstone) so a healed partition can
+ *     re-discover the peer.
+ *
+ * Public APIs (`getMembers`, `upMembers`, `reachableMembers`) skip
+ * `removed` entries, so most user code stays unaffected.  Code that
+ * iterates the raw membership view directly should check
+ * `member.status !== 'removed'` (or use `member.isReachable()`,
+ * which already returns false for `removed`).  An attempt to
+ * `Cluster.join` on the same `host:port` after `MemberRemoved` will
+ * still work — the framework detects the new incarnation via
+ * `mergeMember`'s wall-clock version epoch and supersedes the
+ * tombstone.  See `tests/cluster.test.ts` → "a node that
+ * gracefully left can rejoin on the same address".
+ */
+export class MemberRemoved {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+}
+/** Shard ownership map recomputed. */
+export class ShardMapChanged {
+    type;
+    shards;
+    version;
+    constructor(type, shards, version) {
+        this.type = type;
+        this.shards = shards;
+        this.version = version;
+    }
+}
+//# sourceMappingURL=ClusterEvents.js.map

package/dist/cluster/ClusterEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterEvents.js","sourceRoot":"","sources":["../../src/cluster/ClusterEvents.ts"],"names":[],"mappings":"AAGA,iFAAiF;AAEjF,qEAAqE;AACrE,MAAM,OAAO,MAAM;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAEtE;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE3E,mEAAmE;AACnE,MAAM,OAAO,aAAa;IACI;IAA5B,YAA4B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;CACvD;AAED,iFAAiF;AAEjF,gEAAgE;AAChE,MAAM,OAAO,YAAY;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE5E,0EAA0E;AAC1E,MAAM,OAAO,QAAQ;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAExE,kEAAkE;AAClE,MAAM,OAAO,cAAc;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE9E,mEAAmE;AACnE,MAAM,OAAO,iBAAiB;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAEjF,qDAAqD;AACrD,MAAM,OAAO,eAAe;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE/E,wEAAwE;AACxE,MAAM,OAAO,UAAU;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE1E,oEAAoE;AACpE,MAAM,OAAO,UAAU;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,aAAa;IAA+B;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAAE;AAE7E,sCAAsC;AACtC,MAAM,OAAO,eAAe;IAER;IACA;IACA;IAHlB,YACkB,IAAY,EACZ,MAAmC,EACnC,OAAe;QAFf,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAA6B;QACnC,YAAO,GAAP,OAAO,CAAQ;IAC9B,CAAC;CACL"}

package/dist/cluster/FailureDetector.d.ts

@@ -0,0 +1,32 @@
+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;
+export type FailureDecision = 'healthy' | 'unreachable' | 'down';
+/**
+ * A simple, deterministic failure detector.  Every heartbeat bumps the
+ * last-seen timestamp for a peer; the cluster periodically asks which peers
+ * have fallen past the thresholds.  No φ-accrual / variance tracking — just
+ * plain elapsed-time limits, which is sufficient for LAN-scale clusters.
+ */
+export declare class FailureDetector {
+    private readonly settings;
+    private samples;
+    constructor(settings?: FailureDetectorSettings);
+    /** 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. */
+    register(peer: NodeAddress, now?: number): void;
+    forget(peer: NodeAddress): void;
+    decide(peer: NodeAddress, now?: number): FailureDecision;
+    lastSeen(peer: NodeAddress): Option<number>;
+    get interval(): number;
+}
+//# sourceMappingURL=FailureDetector.d.ts.map

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

@@ -0,0 +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"}

package/dist/cluster/FailureDetector.js

@@ -0,0 +1,50 @@
+import { fromNullable } from '../util/Option.js';
+export const defaultFailureDetectorSettings = {
+    heartbeatIntervalMs: 500,
+    unreachableAfterMs: 2_000,
+    downAfterMs: 5_000,
+};
+/**
+ * A simple, deterministic failure detector.  Every heartbeat bumps the
+ * last-seen timestamp for a peer; the cluster periodically asks which peers
+ * have fallen past the thresholds.  No φ-accrual / variance tracking — just
+ * plain elapsed-time limits, which is sufficient for LAN-scale clusters.
+ */
+export class FailureDetector {
+    settings;
+    samples = new Map();
+    constructor(settings = defaultFailureDetectorSettings) {
+        this.settings = settings;
+    }
+    /** Record that a message was received from `peer` (any message counts). */
+    heartbeat(peer, now = Date.now()) {
+        const key = peer.toString();
+        const prev = this.samples.get(key);
+        this.samples.set(key, { lastSeen: now, everSeen: prev?.everSeen ?? true });
+    }
+    /** Record that we know about a peer even if we haven't heard from it yet. */
+    register(peer, now = Date.now()) {
+        const key = peer.toString();
+        if (!this.samples.has(key))
+            this.samples.set(key, { lastSeen: now, everSeen: false });
+    }
+    forget(peer) {
+        this.samples.delete(peer.toString());
+    }
+    decide(peer, now = Date.now()) {
+        const sample = this.samples.get(peer.toString());
+        if (!sample)
+            return 'healthy';
+        const elapsed = now - sample.lastSeen;
+        if (elapsed >= this.settings.downAfterMs)
+            return 'down';
+        if (elapsed >= this.settings.unreachableAfterMs)
+            return 'unreachable';
+        return 'healthy';
+    }
+    lastSeen(peer) {
+        return fromNullable(this.samples.get(peer.toString())?.lastSeen);
+    }
+    get interval() { return this.settings.heartbeatIntervalMs; }
+}
+//# sourceMappingURL=FailureDetector.js.map

package/dist/cluster/FailureDetector.js.map

@@ -0,0 +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"}

package/dist/cluster/Member.d.ts

@@ -0,0 +1,38 @@
+import { NodeAddress } from './NodeAddress.js';
+import type { MemberData, MemberStatus } from './Protocol.js';
+/**
+ * Immutable description of a cluster member at a point in time.  Member
+ * instances are replaced (not mutated) as their status evolves.  The
+ * `version` counter is incremented on every status change and acts as a
+ * logical clock for gossip merges.
+ *
+ * `removedAt` is set only on tombstone members (status === 'removed'),
+ * via {@link withRemoved}.  It carries the wall-clock instant at which
+ * the tombstone was created and gossips to peers so every node prunes
+ * the tombstone at roughly the same wall-clock time — see
+ * `Cluster.tombstonePruneTick` (#75).
+ */
+export declare class Member {
+    readonly address: NodeAddress;
+    readonly status: MemberStatus;
+    readonly version: number;
+    readonly removedAt?: number | undefined;
+    readonly roles: ReadonlySet<string>;
+    constructor(address: NodeAddress, status: MemberStatus, version: number, roles?: Iterable<string>, removedAt?: number | undefined);
+    hasRole(role: string): boolean;
+    isReachable(): boolean;
+    toData(): MemberData;
+    static fromData(data: MemberData): Member;
+    withStatus(status: MemberStatus): Member;
+    /**
+     * Transition into the `removed` tombstone state with a fresh
+     * `removedAt` timestamp.  Cluster paths that definitively remove a
+     * peer (graceful leave, downing-provider force-down) call this
+     * instead of `withStatus('removed')` so the tombstone carries an
+     * age — required for `Cluster.tombstonePruneTick` to drop expired
+     * tombstones cluster-wide (#75).
+     */
+    withRemoved(removedAt: number): Member;
+    toString(): string;
+}
+//# sourceMappingURL=Member.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Member.d.ts","sourceRoot":"","sources":["../../src/cluster/Member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,qBAAa,MAAM;aAIC,OAAO,EAAE,WAAW;aACpB,MAAM,EAAE,YAAY;aACpB,OAAO,EAAE,MAAM;aAEf,SAAS,CAAC,EAAE,MAAM;IAPpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;gBAGlB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EAC/B,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAM,EACZ,SAAS,CAAC,EAAE,MAAM,YAAA;IAKpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAE9B,WAAW,IAAI,OAAO;IAOtB,MAAM,IAAI,UAAU;IAcpB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAUzC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAIxC;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAItC,QAAQ,IAAI,MAAM;CAInB"}

package/dist/cluster/Member.js

@@ -0,0 +1,69 @@
+import { NodeAddress } from './NodeAddress.js';
+/**
+ * Immutable description of a cluster member at a point in time.  Member
+ * instances are replaced (not mutated) as their status evolves.  The
+ * `version` counter is incremented on every status change and acts as a
+ * logical clock for gossip merges.
+ *
+ * `removedAt` is set only on tombstone members (status === 'removed'),
+ * via {@link withRemoved}.  It carries the wall-clock instant at which
+ * the tombstone was created and gossips to peers so every node prunes
+ * the tombstone at roughly the same wall-clock time — see
+ * `Cluster.tombstonePruneTick` (#75).
+ */
+export class Member {
+    address;
+    status;
+    version;
+    removedAt;
+    roles;
+    constructor(address, status, version, roles = [], removedAt) {
+        this.address = address;
+        this.status = status;
+        this.version = version;
+        this.removedAt = removedAt;
+        this.roles = new Set(roles);
+    }
+    hasRole(role) { return this.roles.has(role); }
+    isReachable() {
+        return this.status === 'up'
+            || this.status === 'weakly-up'
+            || this.status === 'joining'
+            || this.status === 'leaving';
+    }
+    toData() {
+        const data = {
+            address: this.address.toJSON(),
+            status: this.status,
+            version: this.version,
+            roles: Array.from(this.roles),
+        };
+        // `removedAt` only ever set on tombstones — omit otherwise to
+        // keep gossip bytes proportional to status, not member count.
+        return this.removedAt !== undefined
+            ? { ...data, removedAt: this.removedAt }
+            : data;
+    }
+    static fromData(data) {
+        return new Member(NodeAddress.fromJSON(data.address), data.status, data.version, data.roles ?? [], data.removedAt);
+    }
+    withStatus(status) {
+        return new Member(this.address, status, this.version + 1, this.roles, this.removedAt);
+    }
+    /**
+     * Transition into the `removed` tombstone state with a fresh
+     * `removedAt` timestamp.  Cluster paths that definitively remove a
+     * peer (graceful leave, downing-provider force-down) call this
+     * instead of `withStatus('removed')` so the tombstone carries an
+     * age — required for `Cluster.tombstonePruneTick` to drop expired
+     * tombstones cluster-wide (#75).
+     */
+    withRemoved(removedAt) {
+        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})`;
+    }
+}
+//# sourceMappingURL=Member.js.map

package/dist/cluster/Member.js.map

@@ -0,0 +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"}

package/dist/cluster/NodeAddress.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A node in the cluster is identified by host + port + system name.
+ * Stringified as `system@host:port`.
+ */
+export declare class NodeAddress {
+    readonly systemName: string;
+    readonly host: string;
+    readonly port: number;
+    constructor(systemName: string, host: string, port: number);
+    toString(): string;
+    equals(other: NodeAddress): boolean;
+    /** Ordering used by the leader election: lexicographic on the string form. */
+    compareTo(other: NodeAddress): number;
+    toJSON(): NodeAddressData;
+    static fromJSON(data: NodeAddressData): NodeAddress;
+    /** Parse a string of the form `system@host:port`. */
+    static parse(s: string): NodeAddress;
+}
+export interface NodeAddressData {
+    readonly systemName: string;
+    readonly host: string;
+    readonly port: number;
+}
+//# sourceMappingURL=NodeAddress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAddress.d.ts","sourceRoot":"","sources":["../../src/cluster/NodeAddress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;aAEJ,UAAU,EAAE,MAAM;aAClB,IAAI,EAAE,MAAM;aACZ,IAAI,EAAE,MAAM;gBAFZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM;IAG9B,QAAQ,IAAI,MAAM;IAElB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAMnC,8EAA8E;IAC9E,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAIrC,MAAM,IAAI,eAAe;IAIzB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW;IAInD,qDAAqD;IACrD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW;CAUrC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/cluster/NodeAddress.js

@@ -0,0 +1,44 @@
+/**
+ * A node in the cluster is identified by host + port + system name.
+ * Stringified as `system@host:port`.
+ */
+export class NodeAddress {
+    systemName;
+    host;
+    port;
+    constructor(systemName, host, port) {
+        this.systemName = systemName;
+        this.host = host;
+        this.port = port;
+    }
+    toString() { return `${this.systemName}@${this.host}:${this.port}`; }
+    equals(other) {
+        return this.systemName === other.systemName
+            && this.host === other.host
+            && this.port === other.port;
+    }
+    /** Ordering used by the leader election: lexicographic on the string form. */
+    compareTo(other) {
+        return this.toString().localeCompare(other.toString());
+    }
+    toJSON() {
+        return { systemName: this.systemName, host: this.host, port: this.port };
+    }
+    static fromJSON(data) {
+        return new NodeAddress(data.systemName, data.host, data.port);
+    }
+    /** Parse a string of the form `system@host:port`. */
+    static parse(s) {
+        const at = s.indexOf('@');
+        const colon = s.lastIndexOf(':');
+        if (at < 0 || colon <= at)
+            throw new Error(`Invalid node address: ${s}`);
+        const systemName = s.slice(0, at);
+        const host = s.slice(at + 1, colon);
+        const port = parseInt(s.slice(colon + 1), 10);
+        if (!Number.isFinite(port))
+            throw new Error(`Invalid port in node address: ${s}`);
+        return new NodeAddress(systemName, host, port);
+    }
+}
+//# sourceMappingURL=NodeAddress.js.map

package/dist/cluster/NodeAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAddress.js","sourceRoot":"","sources":["../../src/cluster/NodeAddress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAW;IAEJ;IACA;IACA;IAHlB,YACkB,UAAkB,EAClB,IAAY,EACZ,IAAY;QAFZ,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;IAC3B,CAAC;IAEJ,QAAQ,KAAa,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAE7E,MAAM,CAAC,KAAkB;QACvB,OAAO,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU;eACtC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;eACxB,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,8EAA8E;IAC9E,SAAS,CAAC,KAAkB;QAC1B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAqB;QACnC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,qDAAqD;IACrD,MAAM,CAAC,KAAK,CAAC,CAAS;QACpB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,IAAI,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/cluster/PhiAccrualFailureDetector.d.ts

@@ -0,0 +1,49 @@
+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;
+/**
+ * Phi-accrual failure detector (Hayashibara et al, "The Phi Accrual Failure
+ * Detector", 2004).  Tracks the distribution of recent inter-arrival times
+ * and produces a continuous suspicion value `phi`; the cluster converts
+ * `phi` to `unreachable`/`down` by threshold.
+ *
+ * Compared to the simple time-threshold `FailureDetector`, this adapts to
+ * actual network conditions — a chatty LAN peer can be flagged sooner, a
+ * jittery mobile peer gets more slack.
+ */
+export declare class PhiAccrualFailureDetector {
+    private readonly peers;
+    private readonly settings;
+    constructor(settings?: Partial<PhiAccrualSettings>);
+    get interval(): number;
+    /** Peer is now known.  No sample added until the first heartbeat. */
+    register(peer: NodeAddress, _now?: number): void;
+    /** Record a received heartbeat for `peer` at time `now`. */
+    heartbeat(peer: NodeAddress, now?: number): void;
+    /** Current phi value for `peer` — the higher, the more suspicious. */
+    phi(peer: NodeAddress, now?: number): number;
+    decide(peer: NodeAddress, now?: number): FailureDecision;
+    forget(peer: NodeAddress): void;
+    lastSeen(peer: NodeAddress): Option<number>;
+    private mean;
+    private stddev;
+}
+//# sourceMappingURL=PhiAccrualFailureDetector.d.ts.map

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

@@ -0,0 +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"}

package/dist/cluster/PhiAccrualFailureDetector.js

@@ -0,0 +1,139 @@
+import { fromNullable } from '../util/Option.js';
+export const defaultPhiAccrualSettings = {
+    heartbeatIntervalMs: 500,
+    unreachableThreshold: 8,
+    downThreshold: 12,
+    maxSampleSize: 200,
+    minStdDeviationMs: 100,
+    acceptableHeartbeatPauseMs: 0,
+};
+/**
+ * Phi-accrual failure detector (Hayashibara et al, "The Phi Accrual Failure
+ * Detector", 2004).  Tracks the distribution of recent inter-arrival times
+ * and produces a continuous suspicion value `phi`; the cluster converts
+ * `phi` to `unreachable`/`down` by threshold.
+ *
+ * Compared to the simple time-threshold `FailureDetector`, this adapts to
+ * actual network conditions — a chatty LAN peer can be flagged sooner, a
+ * jittery mobile peer gets more slack.
+ */
+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');
+        }
+    }
+    get interval() { return this.settings.heartbeatIntervalMs; }
+    /** Peer is now known.  No sample added until the first heartbeat. */
+    register(peer, _now = Date.now()) {
+        const key = peer.toString();
+        if (!this.peers.has(key)) {
+            this.peers.set(key, {
+                lastHeartbeat: 0,
+                everSeen: false,
+                intervals: new Array(this.settings.maxSampleSize).fill(0),
+                intervalsHead: 0,
+                intervalsCount: 0,
+            });
+        }
+    }
+    /** 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 = {
+                lastHeartbeat: now, everSeen: true,
+                intervals: new Array(this.settings.maxSampleSize).fill(0),
+                intervalsHead: 0, intervalsCount: 0,
+            };
+            this.peers.set(key, s);
+            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++;
+        }
+        s.lastHeartbeat = now;
+        s.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)
+            return 0;
+        const effectiveElapsed = Math.max(0, now - s.lastHeartbeat - this.settings.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));
+        // 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;
+        // Use the complementary normal CDF (from upper-tail approximation).
+        const prob = 1 - standardNormalCdf(y);
+        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)
+            return 'down';
+        if (phi >= this.settings.unreachableThreshold)
+            return 'unreachable';
+        return 'healthy';
+    }
+    forget(peer) { this.peers.delete(peer.toString()); }
+    lastSeen(peer) {
+        return fromNullable(this.peers.get(peer.toString())?.lastHeartbeat);
+    }
+    /* ------------------------ helpers ------------------------ */
+    mean(s) {
+        let sum = 0;
+        for (let i = 0; i < s.intervalsCount; i++)
+            sum += s.intervals[i];
+        return sum / s.intervalsCount;
+    }
+    stddev(s, mean) {
+        if (s.intervalsCount < 2)
+            return 0;
+        let acc = 0;
+        for (let i = 0; i < s.intervalsCount; i++) {
+            const d = s.intervals[i] - mean;
+            acc += d * d;
+        }
+        return Math.sqrt(acc / s.intervalsCount);
+    }
+}
+/** Standard-normal CDF via Abramowitz & Stegun 26.2.17 (good to ~7e-4). */
+function standardNormalCdf(x) {
+    // Handle tails explicitly for numerical stability.
+    if (x < -8)
+        return 0;
+    if (x > 8)
+        return 1;
+    const b1 = 0.319381530;
+    const b2 = -0.356563782;
+    const b3 = 1.781477937;
+    const b4 = -1.821255978;
+    const b5 = 1.330274429;
+    const p = 0.2316419;
+    const c = 0.39894228;
+    const ax = Math.abs(x);
+    const t = 1 / (1 + p * ax);
+    const y = t * (b1 + t * (b2 + t * (b3 + t * (b4 + t * b5))));
+    const cdf = 1 - c * Math.exp(-x * x / 2) * y;
+    return x >= 0 ? cdf : 1 - cdf;
+}
+//# sourceMappingURL=PhiAccrualFailureDetector.js.map

package/dist/cluster/PhiAccrualFailureDetector.js.map

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