actor-ts 0.9.0

package/dist/cluster/downing/LeaseMajority.js

@@ -0,0 +1,129 @@
+import { addrKey, } from './DowningProvider.js';
+/**
+ * Split-brain resolver that uses an external `Lease` to break ties
+ * when the cluster splits into equal-sized partitions — the case
+ * where membership-only strategies (KeepOldest, KeepReferee,
+ * KeepMajority) cannot make a deterministic call.
+ *
+ * Algorithm per partition observation (one side of the split):
+ *
+ *   1. Run the standard `KeepMajority` math.
+ *      - Reachable side has strict majority → down the unreachable side.
+ *      - Reachable side is the strict minority → down ourselves
+ *        (and every reachable peer on this side).
+ *   2. Equal-size partition (or insufficient info) → start
+ *      `lease.acquire()`.  Return no decision while the acquire is
+ *      pending so the cluster waits.
+ *   3. When acquire resolves:
+ *      - `true` → we are the surviving side.  Down the unreachable side.
+ *      - `false` → some other side won.  Down our own side.
+ *
+ * The `decide()` interface stays sync (the rest of the resolver
+ * pipeline is sync).  Async work happens off-band — this strategy
+ * is **stateful**: the first equal-size observation kicks off the
+ * acquire; subsequent ticks read the cached result.
+ *
+ * **Lease unavailable** (network problem reaching the K8s API):
+ * `acquire()` rejects → strategy stays in pending state and returns
+ * an empty decision.  Better to wait than to risk both sides
+ * surviving.
+ */
+export class LeaseMajority {
+    settings;
+    /** Cached decision once acquire has resolved.  Cleared on a fresh
+     *  partition view so a new split triggers a new acquire. */
+    decision = null;
+    /** True while an `acquire()` is in flight. */
+    acquiring = false;
+    /** Fingerprint of the partition view we last evaluated.  Used to
+     *  detect a *new* split (different unreachable set) so we restart
+     *  the acquire flow. */
+    lastFingerprint = null;
+    /** Wall-clock deadline of the in-flight acquire — used to recover
+     *  if `acquire()` hangs longer than the user's budget. */
+    acquireDeadline = 0;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    decide(view) {
+        const candidates = view.allMembers.filter((m) => (m.status === 'up' || m.status === 'leaving' || m.status === 'unreachable') &&
+            (!this.settings.role || m.hasRole(this.settings.role)));
+        if (candidates.length === 0)
+            return new Set();
+        const reachable = candidates.filter((m) => !view.unreachable.has(addrKey(m)));
+        const unreachable = candidates.filter((m) => view.unreachable.has(addrKey(m)));
+        const n = candidates.length;
+        const needed = Math.floor(n / 2) + 1;
+        const fingerprint = this.fingerprintOf(reachable, unreachable);
+        // No partition (everyone reachable) → reset state, no decision.
+        if (unreachable.length === 0) {
+            this.reset();
+            return new Set();
+        }
+        // Partition view changed since last evaluation → drop cached
+        // decision so a fresh split triggers a fresh acquire.
+        if (fingerprint !== this.lastFingerprint) {
+            this.reset();
+            this.lastFingerprint = fingerprint;
+        }
+        // Strict majority — no Lease needed.
+        if (reachable.length >= needed) {
+            this.decision = new Set(unreachable.map(addrKey));
+            return this.decision;
+        }
+        // Strict minority — also no Lease needed.
+        if (unreachable.length >= needed) {
+            this.decision = new Set(reachable.map(addrKey));
+            return this.decision;
+        }
+        // Equal-size partition (or stuck-quorum corner case) — Lease
+        // arbitration kicks in.
+        if (this.decision !== null) {
+            // Cached from a prior tick on this same view.
+            return this.decision;
+        }
+        if (this.acquiring) {
+            // Recover if the acquire stalled past its budget.  The Lease
+            // implementation is supposed to honour its own retry/timeout
+            // settings, but defence-in-depth: if it hasn't resolved by
+            // the deadline, treat it as a transient failure and let the
+            // next tick try again.
+            if (Date.now() > this.acquireDeadline) {
+                this.acquiring = false;
+            }
+            return new Set();
+        }
+        const surviveSet = new Set(unreachable.map(addrKey));
+        const downSelfSet = new Set(reachable.map(addrKey));
+        this.acquiring = true;
+        this.acquireDeadline = Date.now() + (this.settings.acquireTimeoutMs ?? 5_000);
+        void this.runAcquire(surviveSet, downSelfSet);
+        return new Set();
+    }
+    /* ------------------------------ internals ------------------------------ */
+    async runAcquire(surviveSet, downSelfSet) {
+        let won;
+        try {
+            won = await this.settings.lease.acquire();
+        }
+        catch {
+            // Lease backend unreachable — stay pending.  The next decide()
+            // call sees `acquiring=false` (we clear it below) and restarts.
+            this.acquiring = false;
+            return;
+        }
+        this.acquiring = false;
+        this.decision = won ? surviveSet : downSelfSet;
+    }
+    reset() {
+        this.decision = null;
+        this.acquiring = false;
+        this.lastFingerprint = null;
+    }
+    fingerprintOf(reachable, unreachable) {
+        const r = reachable.map((m) => m.address.toString()).sort().join(',');
+        const u = unreachable.map((m) => m.address.toString()).sort().join(',');
+        return `R[${r}]|U[${u}]`;
+    }
+}
+//# sourceMappingURL=LeaseMajority.js.map

package/dist/cluster/downing/LeaseMajority.js.map

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

package/dist/cluster/downing/StaticQuorum.d.ts

@@ -0,0 +1,21 @@
+import { type ClusterPartitionView, type DowningDecision, type DowningProvider } from './DowningProvider.js';
+export interface StaticQuorumSettings {
+    /** Exact size of the quorum needed on the reachable side. */
+    readonly quorumSize: number;
+    /** If set, only members carrying this role count toward quorum. */
+    readonly role?: string;
+}
+/**
+ * "Static quorum" — as long as at least `quorumSize` reachable members are
+ * up on this side, keep them and down the rest.  Otherwise, down ourselves.
+ *
+ * This is the safest SBR choice when you know the expected cluster size
+ * and want to avoid split-brain at the cost of availability when sections
+ * shrink below the threshold.
+ */
+export declare class StaticQuorum implements DowningProvider {
+    private readonly settings;
+    constructor(settings: StaticQuorumSettings);
+    decide(view: ClusterPartitionView): DowningDecision;
+}
+//# sourceMappingURL=StaticQuorum.d.ts.map

package/dist/cluster/downing/StaticQuorum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticQuorum.d.ts","sourceRoot":"","sources":["../../../src/cluster/downing/StaticQuorum.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,eAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,oBAAoB;IAM3D,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,eAAe;CAepD"}

package/dist/cluster/downing/StaticQuorum.js

@@ -0,0 +1,30 @@
+import { addrKey, } from './DowningProvider.js';
+/**
+ * "Static quorum" — as long as at least `quorumSize` reachable members are
+ * up on this side, keep them and down the rest.  Otherwise, down ourselves.
+ *
+ * This is the safest SBR choice when you know the expected cluster size
+ * and want to avoid split-brain at the cost of availability when sections
+ * shrink below the threshold.
+ */
+export class StaticQuorum {
+    settings;
+    constructor(settings) {
+        this.settings = settings;
+        if (settings.quorumSize < 1) {
+            throw new Error('StaticQuorum: quorumSize must be >= 1');
+        }
+    }
+    decide(view) {
+        const candidates = view.allMembers.filter((m) => (m.status === 'up' || m.status === 'leaving' || m.status === 'unreachable') &&
+            (!this.settings.role || m.hasRole(this.settings.role)));
+        const reachable = candidates.filter((m) => !view.unreachable.has(addrKey(m)));
+        const unreachable = candidates.filter((m) => view.unreachable.has(addrKey(m)));
+        if (reachable.length >= this.settings.quorumSize) {
+            return new Set(unreachable.map(addrKey));
+        }
+        // Not enough reachable — we're below quorum, down ourselves.
+        return new Set(reachable.map(addrKey));
+    }
+}
+//# sourceMappingURL=StaticQuorum.js.map

package/dist/cluster/downing/StaticQuorum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticQuorum.js","sourceRoot":"","sources":["../../../src/cluster/downing/StaticQuorum.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GAIR,MAAM,sBAAsB,CAAC;AAS9B;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;QACzD,IAAI,QAAQ,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAA0B;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC;YAC3E,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACvD,CAAC;QAEF,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/E,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YACjD,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,6DAA6D;QAC7D,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/cluster/downing/index.d.ts

@@ -0,0 +1,13 @@
+export { KeepMajority } from './KeepMajority.js';
+export type { KeepMajoritySettings } from './KeepMajority.js';
+export { KeepOldest } from './KeepOldest.js';
+export type { KeepOldestSettings } from './KeepOldest.js';
+export { StaticQuorum } from './StaticQuorum.js';
+export type { StaticQuorumSettings } from './StaticQuorum.js';
+export { KeepReferee } from './KeepReferee.js';
+export type { KeepRefereeSettings } from './KeepReferee.js';
+export { LeaseMajority } from './LeaseMajority.js';
+export type { LeaseMajoritySettings } from './LeaseMajority.js';
+export { addrKey } from './DowningProvider.js';
+export type { DowningProvider, DowningDecision, ClusterPartitionView, } from './DowningProvider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cluster/downing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cluster/downing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/cluster/downing/index.js

@@ -0,0 +1,7 @@
+export { KeepMajority } from './KeepMajority.js';
+export { KeepOldest } from './KeepOldest.js';
+export { StaticQuorum } from './StaticQuorum.js';
+export { KeepReferee } from './KeepReferee.js';
+export { LeaseMajority } from './LeaseMajority.js';
+export { addrKey } from './DowningProvider.js';
+//# sourceMappingURL=index.js.map

package/dist/cluster/downing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cluster/downing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/cluster/index.d.ts

@@ -0,0 +1,49 @@
+export { Cluster, inMemoryTransport } from './Cluster.js';
+export type { ClusterSettings } from './Cluster.js';
+export { bootstrapCluster } from './ClusterBootstrap.js';
+export type { ClusterBootstrapOptions, BootstrappedCluster, } from './ClusterBootstrap.js';
+export { NodeAddress } from './NodeAddress.js';
+export type { NodeAddressData } from './NodeAddress.js';
+export { Member } from './Member.js';
+export type { MemberData, MemberStatus, WireMessage } from './Protocol.js';
+export { SelfUp, SelfRemoved, LeaderChanged, MemberJoined, MemberUp, MemberWeaklyUp, MemberUnreachable, MemberReachable, MemberDown, MemberLeft, MemberRemoved, ShardMapChanged, } from './ClusterEvents.js';
+export type { ClusterEvent } from './ClusterEvents.js';
+export { RemoteActorRef } from './RemoteActorRef.js';
+export { InMemoryTransport, TcpTransport } from './Transport.js';
+export type { Transport, WireHandler, TlsTransportSettings } from './Transport.js';
+export { MessageChannelTransport } from './transports/MessageChannelTransport.js';
+export type { PortLike, BrokeredMessage } from './transports/MessageChannelTransport.js';
+export { FailureDetector, defaultFailureDetectorSettings, } from './FailureDetector.js';
+export type { FailureDetectorSettings, FailureDecision } from './FailureDetector.js';
+export { PhiAccrualFailureDetector, defaultPhiAccrualSettings, } from './PhiAccrualFailureDetector.js';
+export type { PhiAccrualSettings } from './PhiAccrualFailureDetector.js';
+export { KeepMajority, KeepOldest, StaticQuorum, KeepReferee, } from './downing/index.js';
+export type { DowningProvider, DowningDecision, ClusterPartitionView, KeepMajoritySettings, KeepOldestSettings, StaticQuorumSettings, KeepRefereeSettings, } from './downing/index.js';
+export { ClusterSingleton, ClusterSingletonId, ClusterSingletonManager, ClusterSingletonProxy, singletonManagerPath, } from './singleton/index.js';
+export type { StartSingletonSettings, SingletonHandle, ClusterSingletonManagerSettings, SingletonDeliver, } from './singleton/index.js';
+export { DistributedPubSub, DistributedPubSubId, DistributedPubSubMediator, mediatorPath, CurrentTopics, GetTopics, Publish, Subscribe, SubscribeAck, Unsubscribe, UnsubscribeAck, UnsubscribeAll, } from './pubsub/index.js';
+export type { DistributedPubSubSettings } from './pubsub/index.js';
+export { ClusterSharding } from './sharding/ClusterSharding.js';
+export type { StartSettings } from './sharding/ClusterSharding.js';
+export { ShardedDaemonProcess } from './sharding/ShardedDaemonProcess.js';
+export type { ShardedDaemonProcessSettings, ShardedDaemonProcessHandle, } from './sharding/ShardedDaemonProcess.js';
+export { ShardRegion } from './sharding/ShardRegion.js';
+export type { ShardingSettings } from './sharding/ShardRegion.js';
+export { ShardCoordinator } from './sharding/ShardCoordinator.js';
+export type { ShardCoordinatorSettings } from './sharding/ShardCoordinator.js';
+export { Passivate } from './sharding/Passivate.js';
+export { JournalRememberEntitiesStore, } from './sharding/RememberEntitiesStore.js';
+export type { RememberEntitiesStore, RememberEvent, } from './sharding/RememberEntitiesStore.js';
+export { CassandraRememberEntitiesStore, rememberEntitiesDdl, } from './sharding/CassandraRememberEntitiesStore.js';
+export type { CassandraRememberEntitiesStoreOptions, } from './sharding/CassandraRememberEntitiesStore.js';
+export { HashAllocationStrategy, LeastShardAllocationStrategy, } from './sharding/AllocationStrategy.js';
+export type { AllocationStrategy } from './sharding/AllocationStrategy.js';
+export { moduloAllocator, rendezvousAllocator, hashShardId, } from './sharding/ShardAllocator.js';
+export type { ShardAllocator } from './sharding/ShardAllocator.js';
+export { ClusterRouter, pickRendezvous } from './router/index.js';
+export type { ClusterRouterOptions, ClusterRouterType, } from './router/index.js';
+export { ClusterClient } from './ClusterClient.js';
+export type { ClusterClientSettings } from './ClusterClient.js';
+export { ClusterClientReceptionist, ClusterClientReceptionistId, } from './ClusterClientReceptionist.js';
+export type { ClusterClientReceptionistSettings, ClusterClientEnvelopeMsg, ClusterClientReplyMsg, } from './ClusterClientReceptionist.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cluster/index.js

@@ -0,0 +1,33 @@
+// Cluster entry points.
+export { Cluster, inMemoryTransport } from './Cluster.js';
+export { bootstrapCluster } from './ClusterBootstrap.js';
+export { NodeAddress } from './NodeAddress.js';
+export { Member } from './Member.js';
+export { SelfUp, SelfRemoved, LeaderChanged, MemberJoined, MemberUp, MemberWeaklyUp, MemberUnreachable, MemberReachable, MemberDown, MemberLeft, MemberRemoved, ShardMapChanged, } from './ClusterEvents.js';
+export { RemoteActorRef } from './RemoteActorRef.js';
+export { InMemoryTransport, TcpTransport } from './Transport.js';
+export { MessageChannelTransport } from './transports/MessageChannelTransport.js';
+export { FailureDetector, defaultFailureDetectorSettings, } from './FailureDetector.js';
+export { PhiAccrualFailureDetector, defaultPhiAccrualSettings, } from './PhiAccrualFailureDetector.js';
+// Split-Brain Resolver strategies.
+export { KeepMajority, KeepOldest, StaticQuorum, KeepReferee, } from './downing/index.js';
+// Cluster Singleton.
+export { ClusterSingleton, ClusterSingletonId, ClusterSingletonManager, ClusterSingletonProxy, singletonManagerPath, } from './singleton/index.js';
+// Distributed Pub-Sub.
+export { DistributedPubSub, DistributedPubSubId, DistributedPubSubMediator, mediatorPath, CurrentTopics, GetTopics, Publish, Subscribe, SubscribeAck, Unsubscribe, UnsubscribeAck, UnsubscribeAll, } from './pubsub/index.js';
+// Sharding.
+export { ClusterSharding } from './sharding/ClusterSharding.js';
+export { ShardedDaemonProcess } from './sharding/ShardedDaemonProcess.js';
+export { ShardRegion } from './sharding/ShardRegion.js';
+export { ShardCoordinator } from './sharding/ShardCoordinator.js';
+export { Passivate } from './sharding/Passivate.js';
+export { JournalRememberEntitiesStore, } from './sharding/RememberEntitiesStore.js';
+export { CassandraRememberEntitiesStore, rememberEntitiesDdl, } from './sharding/CassandraRememberEntitiesStore.js';
+export { HashAllocationStrategy, LeastShardAllocationStrategy, } from './sharding/AllocationStrategy.js';
+export { moduloAllocator, rendezvousAllocator, hashShardId, } from './sharding/ShardAllocator.js';
+// Cluster-aware routing.
+export { ClusterRouter, pickRendezvous } from './router/index.js';
+// Outside-in client (#86).
+export { ClusterClient } from './ClusterClient.js';
+export { ClusterClientReceptionist, ClusterClientReceptionistId, } from './ClusterClientReceptionist.js';
+//# sourceMappingURL=index.js.map

package/dist/cluster/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cluster/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAGlF,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAGxC,mCAAmC;AACnC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAW5B,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAQ9B,uBAAuB;AACvB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAK1E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EACL,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EACL,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,8CAA8C,CAAC;AAItD,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAGtC,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMlE,2BAA2B;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC"}

package/dist/cluster/pubsub/DistributedPubSubExtension.d.ts

@@ -0,0 +1,30 @@
+import type { ActorRef } from '../../ActorRef.js';
+import type { ActorSystem } from '../../ActorSystem.js';
+import { type Extension, type ExtensionId } from '../../Extension.js';
+import type { Cluster } from '../Cluster.js';
+import { type DistributedPubSubSettings } from './DistributedPubSubMediator.js';
+import type { GetTopics, Publish, Subscribe, Unsubscribe, UnsubscribeAll } from './Messages.js';
+type MediatorMessage = Subscribe | Unsubscribe | UnsubscribeAll | Publish | GetTopics;
+/**
+ * System-wide access to the DistributedPubSubMediator for a given Cluster.
+ * Call `DistributedPubSub.get(system, cluster).mediator` to grab a ref
+ * and send Subscribe / Publish / … messages to it.
+ */
+export declare class DistributedPubSub implements Extension {
+    private readonly system;
+    private _mediator;
+    private _cluster;
+    constructor(system: ActorSystem);
+    /**
+     * Bind the mediator to a specific Cluster.  Idempotent per Cluster —
+     * re-binding to the same cluster is a no-op; re-binding to a different
+     * cluster throws.
+     */
+    start(cluster: Cluster, settings?: Partial<Omit<DistributedPubSubSettings, 'cluster'>>): ActorRef<MediatorMessage>;
+    /** The ref of the mediator — throws if `start()` hasn't been called. */
+    get mediator(): ActorRef<MediatorMessage>;
+    isStarted(): boolean;
+}
+export declare const DistributedPubSubId: ExtensionId<DistributedPubSub>;
+export {};
+//# sourceMappingURL=DistributedPubSubExtension.d.ts.map

package/dist/cluster/pubsub/DistributedPubSubExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DistributedPubSubExtension.d.ts","sourceRoot":"","sources":["../../../src/cluster/pubsub/DistributedPubSubExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB,KAAK,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtF;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IAIrC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,QAAQ,CAAwB;gBAEX,MAAM,EAAE,WAAW;IAEhD;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAM,GAAG,QAAQ,CAAC,eAAe,CAAC;IAoBtH,wEAAwE;IACxE,IAAI,QAAQ,IAAI,QAAQ,CAAC,eAAe,CAAC,CAGxC;IAED,SAAS,IAAI,OAAO;CACrB;AAED,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,iBAAiB,CAG9D,CAAC"}

package/dist/cluster/pubsub/DistributedPubSubExtension.js

@@ -0,0 +1,42 @@
+import { extensionId } from '../../Extension.js';
+import { Props } from '../../Props.js';
+import { DistributedPubSubMediator, mediatorPath, } from './DistributedPubSubMediator.js';
+/**
+ * System-wide access to the DistributedPubSubMediator for a given Cluster.
+ * Call `DistributedPubSub.get(system, cluster).mediator` to grab a ref
+ * and send Subscribe / Publish / … messages to it.
+ */
+export class DistributedPubSub {
+    system;
+    _mediator = null;
+    _cluster = null;
+    constructor(system) {
+        this.system = system;
+    }
+    /**
+     * Bind the mediator to a specific Cluster.  Idempotent per Cluster —
+     * re-binding to the same cluster is a no-op; re-binding to a different
+     * cluster throws.
+     */
+    start(cluster, settings = {}) {
+        if (this._mediator && this._cluster === cluster)
+            return this._mediator;
+        if (this._mediator)
+            throw new Error('DistributedPubSub is already bound to a different cluster');
+        this._cluster = cluster;
+        const mediator = this.system.spawn(Props.create(() => new DistributedPubSubMediator({ cluster, ...settings })), 'pubsub-mediator');
+        this._mediator = mediator;
+        // Route inbound publishes (remote → local) to the mediator's mailbox.
+        cluster._registerEnvelopeHandler(mediatorPath(cluster.system.name), (env) => mediator.tell(env.body));
+        return this._mediator;
+    }
+    /** The ref of the mediator — throws if `start()` hasn't been called. */
+    get mediator() {
+        if (!this._mediator)
+            throw new Error('DistributedPubSub.start(cluster) must be called first');
+        return this._mediator;
+    }
+    isStarted() { return this._mediator !== null; }
+}
+export const DistributedPubSubId = extensionId('DistributedPubSub', (system) => new DistributedPubSub(system));
+//# sourceMappingURL=DistributedPubSubExtension.js.map

package/dist/cluster/pubsub/DistributedPubSubExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DistributedPubSubExtension.js","sourceRoot":"","sources":["../../../src/cluster/pubsub/DistributedPubSubExtension.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAoC,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EACL,yBAAyB,EACzB,YAAY,GAEb,MAAM,gCAAgC,CAAC;AAWxC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAIC;IAHrB,SAAS,GAAqC,IAAI,CAAC;IACnD,QAAQ,GAAmB,IAAI,CAAC;IAExC,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;OAIG;IACH,KAAK,CAAC,OAAgB,EAAE,WAAgE,EAAE;QACxF,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QACvE,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACjG,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAChC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,yBAAyB,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,EAC3E,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,QAAqC,CAAC;QAEvD,sEAAsE;QACtE,OAAO,CAAC,wBAAwB,CAC9B,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EACjC,CAAC,GAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAa,CAAC,CACvD,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,wEAAwE;IACxE,IAAI,QAAQ;QACV,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,SAAS,KAAc,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAmC,WAAW,CAC5E,mBAAmB,EACnB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAC1C,CAAC"}

package/dist/cluster/pubsub/DistributedPubSubMediator.d.ts

@@ -0,0 +1,56 @@
+import { Actor } from '../../Actor.js';
+import type { Cluster } from '../Cluster.js';
+import { GetTopics, Publish, Subscribe, type PubSubPublishMsg, Unsubscribe, UnsubscribeAll } from './Messages.js';
+/**
+ * Well-known path at which every node hosts its DistributedPubSubMediator.
+ * Remote publishes target this path so the receiving mediator can fan out
+ * to its local subscribers.
+ */
+export declare function mediatorPath(systemName: string): string;
+export interface DistributedPubSubSettings {
+    readonly cluster: Cluster;
+    readonly gossipIntervalMs?: number;
+}
+/**
+ * Cluster-wide publish/subscribe bus.  Every node hosts one mediator
+ * which keeps a local Map<topic, subscribers> and gossip-replicates
+ * the topic→node set so Publish can reach every subscriber with at
+ * most one remote hop.
+ *
+ * Simple delta model: each mediator periodically gossips its local
+ * topic set to one random peer.  Peers merge into their view.
+ */
+export declare class DistributedPubSubMediator extends Actor<Subscribe | Unsubscribe | UnsubscribeAll | Publish | GetTopics | PubSubPublishMsg> {
+    readonly settings: DistributedPubSubSettings;
+    private readonly topics;
+    private gossipTimer;
+    private unsubscribeWire;
+    private unsubscribeCluster;
+    private version;
+    constructor(settings: DistributedPubSubSettings);
+    preStart(): void;
+    postStop(): void;
+    onReceive(msg: Subscribe | Unsubscribe | UnsubscribeAll | Publish | GetTopics | PubSubPublishMsg): void;
+    private handleSubscribe;
+    private handleUnsubscribe;
+    private handleUnsubscribeAll;
+    private handleGetTopics;
+    private handlePublish;
+    private deliverLocal;
+    private gossipTick;
+    /**
+     * Send the current subscription state to **every** peer
+     * immediately.  Used after local subscribe / unsubscribe so a
+     * follow-up publish doesn't have to wait several gossip ticks
+     * for the random-peer-per-tick scheme to reach every node.
+     * Periodic `gossipTick` continues to run as steady-state
+     * anti-entropy.
+     */
+    private eagerGossip;
+    private buildGossip;
+    private handleGossip;
+    private forgetNode;
+    private getOrCreateSet;
+    private sendWire;
+}
+//# sourceMappingURL=DistributedPubSubMediator.d.ts.map

package/dist/cluster/pubsub/DistributedPubSubMediator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DistributedPubSubMediator.d.ts","sourceRoot":"","sources":["../../../src/cluster/pubsub/DistributedPubSubMediator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,OAAO,EAEL,SAAS,EACT,OAAO,EACP,SAAS,EAGT,KAAK,gBAAgB,EAErB,WAAW,EAEX,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AASD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,SAAQ,KAAK,CAClD,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,gBAAgB,CAClF;aAO6B,QAAQ,EAAE,yBAAyB;IAN/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,OAAO,CAAK;gBAEQ,QAAQ,EAAE,yBAAyB;IAEtD,QAAQ,IAAI,IAAI;IAkBhB,QAAQ,IAAI,IAAI;IAMhB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI;IAchH,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,UAAU;IAUlB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,QAAQ;CAgBjB"}