actor-ts 0.9.1 → 0.11.0

package/dist/cluster/sharding/ShardAllocator.js

@@ -22,9 +22,9 @@ export const rendezvousAllocator = (shardId, members) => {
     let bestHash = -1;
     let best = members[0];
     for (const addr of members) {
-        const h = hashCombine(shardId, addr.toString());
-        if (h > bestHash) {
-            bestHash = h;
+        const hash = hashCombine(shardId, addr.toString());
+        if (hash > bestHash) {
+            bestHash = hash;
             best = addr;
         }
     }
@@ -37,18 +37,18 @@ export const rendezvousAllocator = (shardId, members) => {
 export function hashShardId(entityId, numShards) {
     return Math.abs(stringHash(entityId)) % numShards;
 }
-function stringHash(s) {
-    let h = 2166136261; // FNV-1a 32-bit basis
-    for (let i = 0; i < s.length; i++) {
-        h ^= s.charCodeAt(i);
-        h = Math.imul(h, 16777619);
+function stringHash(text) {
+    let hash = 2166136261; // FNV-1a 32-bit basis
+    for (let i = 0; i < text.length; i++) {
+        hash ^= text.charCodeAt(i);
+        hash = Math.imul(hash, 16777619);
     }
-    return h;
+    return hash;
 }
-function hashCombine(a, b) {
-    let h = stringHash(b) ^ (a * 2654435761);
-    h ^= h >>> 13;
-    h = Math.imul(h, 1540483477);
-    return h >>> 0;
+function hashCombine(shardId, text) {
+    let hash = stringHash(text) ^ (shardId * 2654435761);
+    hash ^= hash >>> 13;
+    hash = Math.imul(hash, 1540483477);
+    return hash >>> 0;
 }
 //# sourceMappingURL=ShardAllocator.js.map

package/dist/cluster/sharding/ShardAllocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShardAllocator.js","sourceRoot":"","sources":["../../../src/cluster/sharding/ShardAllocator.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAE,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpF,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,IAAI,IAAI,GAAgB,OAAO,CAAC,CAAC,CAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;YAAC,QAAQ,GAAG,CAAC,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC;QAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,SAAiB;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,sBAAsB;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IACzC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}
+{"version":3,"file":"ShardAllocator.js","sourceRoot":"","sources":["../../../src/cluster/sharding/ShardAllocator.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAE,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpF,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,IAAI,IAAI,GAAgB,OAAO,CAAC,CAAC,CAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC;QAAC,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,SAAiB;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,sBAAsB;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,IAAY;IAChD,IAAI,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;IACrD,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;IACpB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/cluster/sharding/ShardCoordinator.d.ts

@@ -1,10 +1,5 @@
 import { Actor } from '../../Actor.js';
-import type { ActorRef } from '../../ActorRef.js';
-import type { Lease } from '../../coordination/Lease.js';
-import type { Cluster } from '../Cluster.js';
-import { type AllocationStrategy } from './AllocationStrategy.js';
-import type { CoordinatorStateStore } from './CoordinatorState.js';
-import type { RememberEntitiesStore } from './RememberEntitiesStore.js';
+import type { ShardCoordinatorOptions, ShardCoordinatorOptionsType } from './ShardCoordinatorOptions.js';
 import type { ShardingMessage } from './ShardingProtocol.js';
 /**
  * The lease-aware path uses internal events instead of inline awaits so
@@ -25,61 +20,6 @@ type CoordinatorEvent = {
     t: 'acquire-retry';
 };
 type CoordinatorInbox = ShardingMessage | CoordinatorEvent;
-export interface ShardCoordinatorSettings {
-    readonly typeName: string;
-    readonly cluster: Cluster;
-    readonly allocationStrategy: AllocationStrategy;
-    readonly role?: string;
-    readonly rebalanceIntervalMs?: number;
-    readonly handOffTimeoutMs?: number;
-    readonly rememberEntities?: boolean;
-    /** Resolver for local actor paths — used when coordinator lives on the same node as a region. */
-    readonly localResolver: (path: string) => ActorRef | null;
-    /**
-     * Optional split-brain protection.  When set, the elected leader's
-     * coordinator must hold the lease before it processes shard
-     * messages.  Under a network partition where two nodes converge to
-     * "I am the leader" gossip views, only the side that successfully
-     * acquires the lease ever issues `AllocateShard` / `HandOff`
-     * directives — the other side stays passive and drops messages
-     * (regions retry naturally on their next cache miss).
-     *
-     * Without a lease the coordinator gates only on `isLeader()` —
-     * v1 behaviour, no extra coordination.
-     */
-    readonly lease?: Lease;
-    /** Retry interval for `lease.acquire()` after a failed attempt.  Default: 5 s. */
-    readonly acquireRetryIntervalMs?: number;
-    /**
-     * Optional persistence backend for the entity registry.  Only used
-     * when `rememberEntities: true`.  Without it, `entitiesPerShard`
-     * stays in-memory only and a full cluster restart loses the
-     * registry — until messages re-arrive and trigger fresh
-     * EntityStarted notifications.  Set to a `JournalRememberEntitiesStore`
-     * (or any custom impl) to make the registry survive cold-starts.
-     *
-     * The `ClusterSharding` extension auto-instantiates the default
-     * `JournalRememberEntitiesStore` (using the active Journal) when
-     * `rememberEntities: true` and no explicit store is provided —
-     * so most users don't need to touch this field.
-     */
-    readonly rememberEntitiesStore?: RememberEntitiesStore;
-    /**
-     * Optional persistence backend for the allocation state itself
-     * (`regions` + `shardHome`).  Without it, `LeaderChanged` triggers
-     * a full rebuild from `Register` gossip — fine for a few hundred
-     * shards, painful at thousands.  With it, the new leader loads
-     * the last-known snapshot from the store (e.g. `DistributedData`)
-     * and skips the reallocation storm.
-     *
-     * `ClusterSharding` does NOT auto-instantiate this — the user
-     * must explicitly start a DistributedData extension first and
-     * pass `new DistributedDataCoordinatorStateStore(...)`.  Without
-     * that opt-in, `ShardCoordinator` keeps the v1 rebuild-from-
-     * Register behaviour (backwards-compat).
-     */
-    readonly coordinatorStateStore?: CoordinatorStateStore;
-}
 /**
  * Cluster-wide authoritative source of shard-to-region assignments.  Runs on
  * every node but only responds to requests when the local node is the
@@ -93,7 +33,6 @@ export interface ShardCoordinatorSettings {
  * across restarts without re-allocating every shard from scratch.
  */
 export declare class ShardCoordinator extends Actor<CoordinatorInbox> {
-    readonly settings: ShardCoordinatorSettings;
     private readonly regions;
     private readonly shardHome;
     private readonly pending;
@@ -104,7 +43,7 @@ export declare class ShardCoordinator extends Actor<CoordinatorInbox> {
     private unsubscribeLeaseLost;
     private acquireRetryTimer;
     /**
-     * Lease lifecycle (only used when `settings.lease` is set).
+     * Lease lifecycle (only used when `options.lease` is set).
      * Drives the `isActive()` predicate — coordinator only processes
      * shard messages while `isLeader() && leaseState === 'held'`.
      */
@@ -142,7 +81,8 @@ export declare class ShardCoordinator extends Actor<CoordinatorInbox> {
      */
     private coordinatorStateInFlight;
     private coordinatorStateDirty;
-    constructor(settings: ShardCoordinatorSettings);
+    readonly options: ShardCoordinatorOptionsType;
+    constructor(options: ShardCoordinatorOptions);
     /** Path used by ClusterSharding to locate the coordinator on any node. */
     static pathFor(typeName: string): string;
     preStart(): Promise<void>;

package/dist/cluster/sharding/ShardCoordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShardCoordinator.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/ShardCoordinator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,yBAAyB,CAAC;AAC1F,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EASV,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAG/B;;;;;GAKG;AACH,KAAK,gBAAgB,GACjB;IAAE,CAAC,EAAE,WAAW,CAAA;CAAE,GAClB;IAAE,CAAC,EAAE,sBAAsB,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1D;IAAE,CAAC,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC;AAE3B,KAAK,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAoB3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,iGAAiG;IACjG,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC;IAC1D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IACvD;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CACxD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,gBAAgB,CAAC;aAuD/B,QAAQ,EAAE,wBAAwB;IAtD9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA2D;IAC/F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IAEnE,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,iBAAiB,CAA4B;IAErD;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAyC;IAE3D;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAEnD;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB,CAAoC;IAE9D;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,qBAAqB,CAAS;gBAEV,QAAQ,EAAE,wBAAwB;IAE9D,0EAA0E;IAC1E,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCxC;;;sDAGkD;IAClD,OAAO,CAAC,kBAAkB;IAeX,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAoB/C,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,QAAQ;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,cAAc;YA8BR,UAAU;IAWxB,OAAO,CAAC,mBAAmB;IAkC3B,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;IAa3B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,eAAe;IAiCvB;;;;;;;OAOG;YACW,oBAAoB;IA2ClC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA0BpC,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,OAAO;CAUhB"}
+{"version":3,"file":"ShardCoordinator.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/ShardCoordinator.ts"],"names":[],"mappings":"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"}

package/dist/cluster/sharding/ShardCoordinator.js

@@ -6,9 +6,9 @@ import { RemoteActorRef } from '../RemoteActorRef.js';
 function isCoordinatorEvent(msg) {
     if (!msg || typeof msg !== 'object')
         return false;
-    const t = msg.t;
-    return t === 'reconcile' || t === 'lease-acquire-result'
-        || t === 'lease-lost' || t === 'acquire-retry';
+    const discriminator = msg.t;
+    return discriminator === 'reconcile' || discriminator === 'lease-acquire-result'
+        || discriminator === 'lease-lost' || discriminator === 'acquire-retry';
 }
 function regionKey(node, path) {
     return `${node}|${path}`;
@@ -26,7 +26,6 @@ function regionKey(node, path) {
  * across restarts without re-allocating every shard from scratch.
  */
 export class ShardCoordinator extends Actor {
-    settings;
     regions = new Map();
     shardHome = new Map(); // shardId → regionPath
     pending = new Map(); // waiting queries
@@ -37,7 +36,7 @@ export class ShardCoordinator extends Actor {
     unsubscribeLeaseLost = null;
     acquireRetryTimer = null;
     /**
-     * Lease lifecycle (only used when `settings.lease` is set).
+     * Lease lifecycle (only used when `options.lease` is set).
      * Drives the `isActive()` predicate — coordinator only processes
      * shard messages while `isLeader() && leaseState === 'held'`.
      */
@@ -75,9 +74,10 @@ export class ShardCoordinator extends Actor {
      */
     coordinatorStateInFlight = false;
     coordinatorStateDirty = false;
-    constructor(settings) {
+    options;
+    constructor(options) {
         super();
-        this.settings = settings;
+        this.options = options;
     }
     /** Path used by ClusterSharding to locate the coordinator on any node. */
     static pathFor(typeName) {
@@ -89,30 +89,30 @@ export class ShardCoordinator extends Actor {
         //    Without this, a fresh-cluster start would treat every
         //    rememberEntities=true sharded type as empty and only
         //    re-register entities lazily as messages arrive.
-        if (this.settings.rememberEntities && this.settings.rememberEntitiesStore) {
+        if (this.options.rememberEntities && this.options.rememberEntitiesStore) {
             try {
-                const events = await this.settings.rememberEntitiesStore
-                    .load(this.settings.typeName);
+                const events = await this.options.rememberEntitiesStore
+                    .load(this.options.typeName);
                 for (const ev of events)
                     this.applyRememberEvent(ev);
             }
             catch (err) {
-                this.system.log.warn(`[sharding] failed to load remembered entities for '${this.settings.typeName}'`, err);
+                this.system.log.warn(`[sharding] failed to load remembered entities for '${this.options.typeName}'`, err);
             }
         }
-        this.unsubscribeCluster = this.settings.cluster.subscribe(evt => match(evt)
+        this.unsubscribeCluster = this.options.cluster.subscribe(evt => match(evt)
             .with(P.instanceOf(MemberRemoved), (e) => this.onMemberRemoved(e.member.address))
             .with(P.instanceOf(LeaderChanged), () => this.onLeaderChanged())
             .otherwise(() => { }));
-        if (this.settings.lease) {
-            this.unsubscribeLeaseLost = this.settings.lease.onLost((reason) => {
+        if (this.options.lease) {
+            this.unsubscribeLeaseLost = this.options.lease.onLost((reason) => {
                 this.self.tell({ t: 'lease-lost', reason });
             });
             // Kick the initial reconcile through the mailbox so the lease
             // path serialises with subsequent cluster events.
             this.self.tell({ t: 'reconcile' });
         }
-        this.rebalanceTimer = this.system.scheduler.scheduleAtFixedRateFn(this.settings.rebalanceIntervalMs ?? 2_000, this.settings.rebalanceIntervalMs ?? 2_000, () => { if (this.isActive())
+        this.rebalanceTimer = this.system.scheduler.scheduleAtFixedRateFn(this.options.rebalanceIntervalMs ?? 2_000, this.options.rebalanceIntervalMs ?? 2_000, () => { if (this.isActive())
             this.rebalanceTick(); });
     }
     /** Apply a single `RememberEvent` to the in-memory `entitiesPerShard`
@@ -139,11 +139,11 @@ export class ShardCoordinator extends Actor {
         this.unsubscribeLeaseLost?.();
         this.rebalanceTimer?.cancel();
         this.acquireRetryTimer?.cancel();
-        for (const r of this.rebalanceInProgress.values())
-            r.timer.cancel();
-        if (this.settings.lease && this.leaseState === 'held') {
+        for (const rebalance of this.rebalanceInProgress.values())
+            rebalance.timer.cancel();
+        if (this.options.lease && this.leaseState === 'held') {
             try {
-                await this.settings.lease.release();
+                await this.options.lease.release();
             }
             catch { /* best-effort */ }
             this.leaseState = 'none';
@@ -159,7 +159,7 @@ export class ShardCoordinator extends Actor {
         }
         if (!this.isLeader())
             return;
-        if (this.settings.lease && this.leaseState !== 'held') {
+        if (this.options.lease && this.leaseState !== 'held') {
             // Leader, but lease not yet held — buffer instead of drop so
             // regions don't need to retry on the next cluster event.
             if (this.acquireBuffer.length < ShardCoordinator.ACQUIRE_BUFFER_CAP) {
@@ -174,13 +174,13 @@ export class ShardCoordinator extends Actor {
             .with({ $t: 'sharding.Register' }, (m) => this.handleRegister(m))
             .with({ $t: 'sharding.GetShardHome' }, (m) => this.handleGetShardHome(m))
             .with({ $t: 'sharding.HandOffComplete' }, (m) => this.handleHandOffComplete(m))
-            .with({ $t: 'sharding.BeginHandOffAck' }, () => { })
+            .with({ $t: 'sharding.BeginHandOffAcknowledgment' }, () => { })
             .with({ $t: 'sharding.RegionTerminated' }, (m) => this.onRegionTerminated(m))
             .with({ $t: 'sharding.EntityStarted' }, (m) => this.handleEntityStarted(m))
             .with({ $t: 'sharding.EntityStopped' }, (m) => this.handleEntityStopped(m))
             .otherwise(() => { });
     }
-    isLeader() { return this.settings.cluster.isLeader(); }
+    isLeader() { return this.options.cluster.isLeader(); }
     /**
      * True iff this coordinator is the authoritative one — i.e. should
      * be processing shard messages.  Without a lease this is just
@@ -188,7 +188,7 @@ export class ShardCoordinator extends Actor {
      * lease be currently held by this replica.
      */
     isActive() {
-        if (!this.settings.lease)
+        if (!this.options.lease)
             return this.isLeader();
         return this.isLeader() && this.leaseState === 'held';
     }
@@ -202,7 +202,7 @@ export class ShardCoordinator extends Actor {
             .exhaustive();
     }
     reconcileLease() {
-        if (!this.settings.lease)
+        if (!this.options.lease)
             return;
         const wantActive = this.isLeader();
         if (wantActive) {
@@ -219,7 +219,7 @@ export class ShardCoordinator extends Actor {
             if (this.leaseState === 'held') {
                 // Stepped down — release so a follower can pick up faster
                 // than waiting for the TTL to expire.
-                void this.settings.lease.release().catch((e) => this.system.log.warn(`[sharding] lease release failed`, e));
+                void this.options.lease.release().catch((e) => this.system.log.warn(`[sharding] lease release failed`, e));
                 this.leaseState = 'none';
                 // Falling out of `held` already triggers our standard
                 // "not-leader" cleanup via onLeaderChanged below — no extra
@@ -237,7 +237,7 @@ export class ShardCoordinator extends Actor {
     }
     async runAcquire() {
         try {
-            const got = await this.settings.lease.acquire();
+            const got = await this.options.lease.acquire();
             this.self.tell({ t: 'lease-acquire-result', got });
         }
         catch (error) {
@@ -250,7 +250,7 @@ export class ShardCoordinator extends Actor {
         if (this.leaseState !== 'acquiring') {
             // Spurious result — release if we somehow got it.
             if (msg.got)
-                void this.settings.lease.release().catch(() => { });
+                void this.options.lease.release().catch(() => { });
             return;
         }
         if (!msg.got) {
@@ -263,12 +263,12 @@ export class ShardCoordinator extends Actor {
         if (!this.isLeader()) {
             // Lost leadership during the acquire — release and let the
             // new leader (if any) take over.
-            void this.settings.lease.release().catch(() => { });
+            void this.options.lease.release().catch(() => { });
             this.leaseState = 'none';
             return;
         }
         this.leaseState = 'held';
-        this.system.log.info(`[sharding] coordinator '${this.settings.typeName}' became active (lease acquired)`);
+        this.system.log.info(`[sharding] coordinator '${this.options.typeName}' became active (lease acquired)`);
         // Drain any messages that arrived while we were acquiring.
         // Regions don't retry on a timer — they only re-ask on cluster
         // events — so without this drain a region that asked during
@@ -276,22 +276,22 @@ export class ShardCoordinator extends Actor {
         if (this.acquireBuffer.length > 0) {
             const buffered = this.acquireBuffer;
             this.acquireBuffer = [];
-            for (const m of buffered)
-                this.dispatchShardingMessage(m);
+            for (const message of buffered)
+                this.dispatchShardingMessage(message);
         }
     }
     handleLeaseLost(msg) {
         if (this.leaseState !== 'held')
             return;
-        this.system.log.warn(`[sharding] coordinator '${this.settings.typeName}' lost lease — ${msg.reason}; stepping down`);
+        this.system.log.warn(`[sharding] coordinator '${this.options.typeName}' lost lease — ${msg.reason}; stepping down`);
         this.leaseState = 'none';
         // Cancel any in-flight rebalance handoff timers — those would
         // fire force-reallocations that we shouldn't be doing while
         // passive.  Pending queries get dropped (regions retry once we
         // become active again, or once cluster events flush their
         // register loop).
-        for (const r of this.rebalanceInProgress.values())
-            r.timer.cancel();
+        for (const rebalance of this.rebalanceInProgress.values())
+            rebalance.timer.cancel();
         this.rebalanceInProgress.clear();
         this.pending.clear();
         this.acquireBuffer = [];
@@ -306,21 +306,21 @@ export class ShardCoordinator extends Actor {
         this.self.tell({ t: 'reconcile' });
     }
     scheduleAcquireRetry() {
-        const interval = this.settings.acquireRetryIntervalMs ?? 5_000;
+        const interval = this.options.acquireRetryIntervalMs ?? 5_000;
         this.acquireRetryTimer?.cancel();
         this.acquireRetryTimer = this.system.scheduler.scheduleOnceFn(interval, () => {
             this.self.tell({ t: 'acquire-retry' });
         });
     }
     candidates() {
-        const role = this.settings.role;
+        const role = this.options.role;
         const activeRegions = Array.from(this.regions.values()).filter(r => !r.proxy);
         const addrs = activeRegions.map(r => r.node);
         if (!role)
             return addrs;
         return addrs.filter(a => {
-            const m = this.settings.cluster.getMembers().find(x => x.address.equals(a));
-            return m?.hasRole(role) ?? false;
+            const member = this.options.cluster.getMembers().find(x => x.address.equals(a));
+            return member?.hasRole(role) ?? false;
         });
     }
     currentShardCounts() {
@@ -332,8 +332,8 @@ export class ShardCoordinator extends Actor {
                 continue;
             const addr = info.node.toString();
             const existing = out.get(addr) ?? new Set();
-            for (const s of info.shards)
-                existing.add(s);
+            for (const shardId of info.shards)
+                existing.add(shardId);
             out.set(addr, existing);
         }
         return out;
@@ -352,13 +352,13 @@ export class ShardCoordinator extends Actor {
             this.shardHome.set(shardId, key);
         }
         const ack = {
-            $t: 'sharding.RegisterAck',
+            $t: 'sharding.RegisterAcknowledgment',
             coordinator: this.self.path.toString(),
         };
         this.replyTo(msg.region, msg.node, ack);
         for (const shardId of msg.hostedShards)
             this.flushPending(shardId);
-        if (this.settings.rememberEntities) {
+        if (this.options.rememberEntities) {
             for (const shardId of msg.hostedShards)
                 this.shipRememberedEntities(shardId);
         }
@@ -386,7 +386,7 @@ export class ShardCoordinator extends Actor {
         const cs = this.candidates();
         if (cs.length === 0)
             return;
-        const owner = this.settings.allocationStrategy.allocate(shardId, cs, this.currentShardCounts());
+        const owner = this.options.allocationStrategy.allocate(shardId, cs, this.currentShardCounts());
         const key = this.findRegionKey(owner);
         if (!key)
             return;
@@ -403,7 +403,7 @@ export class ShardCoordinator extends Actor {
             node: info.node.toJSON(),
         });
         this.flushPending(shardId);
-        if (this.settings.rememberEntities)
+        if (this.options.rememberEntities)
             this.shipRememberedEntities(shardId);
         this.scheduleCoordinatorStateSave();
     }
@@ -426,13 +426,13 @@ export class ShardCoordinator extends Actor {
         this.tryAllocate(shardId);
     }
     handleEntityStarted(msg) {
-        if (!this.settings.rememberEntities)
+        if (!this.options.rememberEntities)
             return;
         this.applyRememberEvent({ kind: 'started', shardId: msg.shardId, entityId: msg.entityId });
         this.persistRememberEvent({ kind: 'started', shardId: msg.shardId, entityId: msg.entityId });
     }
     handleEntityStopped(msg) {
-        if (!this.settings.rememberEntities) {
+        if (!this.options.rememberEntities) {
             // Existing behaviour: tidy the in-memory map even when we're
             // not remembering entities, so an unwise external trigger
             // doesn't leave stale data in the map.
@@ -456,12 +456,12 @@ export class ShardCoordinator extends Actor {
      * writes.
      */
     persistRememberEvent(event) {
-        const store = this.settings.rememberEntitiesStore;
+        const store = this.options.rememberEntitiesStore;
         if (!store)
             return;
         this.rememberWriteChain = this.rememberWriteChain
             .catch(() => { })
-            .then(() => store.append(this.settings.typeName, event))
+            .then(() => store.append(this.options.typeName, event))
             .catch((err) => {
             this.system.log.warn(`[sharding] failed to persist remembered-entity event ${event.kind}/${event.shardId}/${event.entityId}`, err);
         });
@@ -508,8 +508,8 @@ export class ShardCoordinator extends Actor {
             this.shardHome.clear();
             this.pending.clear();
             this.acquireBuffer = [];
-            for (const r of this.rebalanceInProgress.values())
-                r.timer.cancel();
+            for (const rebalance of this.rebalanceInProgress.values())
+                rebalance.timer.cancel();
             this.rebalanceInProgress.clear();
         }
         else {
@@ -520,7 +520,7 @@ export class ShardCoordinator extends Actor {
             // tryAllocate call.  Failure is tolerated: we fall back to
             // the v1 rebuild-from-Register path when the load fails or
             // returns nothing.
-            if (this.settings.coordinatorStateStore) {
+            if (this.options.coordinatorStateStore) {
                 void this.loadCoordinatorState();
             }
         }
@@ -528,7 +528,7 @@ export class ShardCoordinator extends Actor {
         // any time the leader role flips — see `reconcileLease()`.  We
         // route through the mailbox so the state machine serialises with
         // any in-flight acquire result.
-        if (this.settings.lease) {
+        if (this.options.lease) {
             this.self.tell({ t: 'reconcile' });
         }
     }
@@ -542,15 +542,15 @@ export class ShardCoordinator extends Actor {
      * onMessage flow.
      */
     async loadCoordinatorState() {
-        const store = this.settings.coordinatorStateStore;
+        const store = this.options.coordinatorStateStore;
         if (!store)
             return;
         let data;
         try {
-            data = await store.load(this.settings.typeName);
+            data = await store.load(this.options.typeName);
         }
         catch (err) {
-            this.system.log.warn(`[sharding] coordinator-state load failed for '${this.settings.typeName}'`, err);
+            this.system.log.warn(`[sharding] coordinator-state load failed for '${this.options.typeName}'`, err);
             return;
         }
         if (!data)
@@ -559,18 +559,18 @@ export class ShardCoordinator extends Actor {
         // some Register messages), merge — keep what we know AND what
         // the snapshot says.  The snapshot's `regions` may be stale (a
         // node may have died), so we filter by current cluster membership.
-        const livingNodes = new Set(this.settings.cluster.upMembers().map((m) => m.address.toString()));
-        for (const r of data.regions) {
-            if (!livingNodes.has(r.node.systemName + '@' + r.node.host + ':' + r.node.port)) {
+        const livingNodes = new Set(this.options.cluster.upMembers().map((m) => m.address.toString()));
+        for (const region of data.regions) {
+            if (!livingNodes.has(region.node.systemName + '@' + region.node.host + ':' + region.node.port)) {
                 // Node dropped out of the cluster between snapshot and now
                 // — skip the entry; the dead region won't be re-resurrected.
                 continue;
             }
-            const node = NodeAddress.fromJSON(r.node);
-            if (this.regions.has(r.key))
+            const node = NodeAddress.fromJSON(region.node);
+            if (this.regions.has(region.key))
                 continue; // already known via Register
-            this.regions.set(r.key, {
-                node, path: r.path, proxy: r.proxy, shards: new Set(r.shards),
+            this.regions.set(region.key, {
+                node, path: region.path, proxy: region.proxy, shards: new Set(region.shards),
             });
         }
         for (const [shardId, regionKey] of data.shardHome) {
@@ -588,7 +588,7 @@ export class ShardCoordinator extends Actor {
      * `inFlight + dirty` flag pair.
      */
     scheduleCoordinatorStateSave() {
-        const store = this.settings.coordinatorStateStore;
+        const store = this.options.coordinatorStateStore;
         if (!store)
             return;
         if (!this.isLeader())
@@ -599,9 +599,9 @@ export class ShardCoordinator extends Actor {
         }
         this.coordinatorStateInFlight = true;
         const snapshot = this.snapshotCoordinatorState();
-        void store.save(this.settings.typeName, snapshot)
+        void store.save(this.options.typeName, snapshot)
             .catch((err) => {
-            this.system.log.warn(`[sharding] coordinator-state save failed for '${this.settings.typeName}'`, err);
+            this.system.log.warn(`[sharding] coordinator-state save failed for '${this.options.typeName}'`, err);
         })
             .finally(() => {
             this.coordinatorStateInFlight = false;
@@ -627,7 +627,7 @@ export class ShardCoordinator extends Actor {
             shardHome.push([shardId, regionKey]);
         }
         return {
-            leader: this.settings.cluster.selfAddress.toString(),
+            leader: this.options.cluster.selfAddress.toString(),
             takenAt: Date.now(),
             regions,
             shardHome,
@@ -635,7 +635,7 @@ export class ShardCoordinator extends Actor {
     }
     /* ------------------------------- Rebalance ------------------------------- */
     rebalanceTick() {
-        const shardsToMove = this.settings.allocationStrategy.rebalance(this.currentShardCounts(), this.candidates(), new Set(this.rebalanceInProgress.keys()));
+        const shardsToMove = this.options.allocationStrategy.rebalance(this.currentShardCounts(), this.candidates(), new Set(this.rebalanceInProgress.keys()));
         for (const shardId of shardsToMove)
             this.beginHandOff(shardId);
     }
@@ -646,7 +646,7 @@ export class ShardCoordinator extends Actor {
         const owner = this.regions.get(ownerKey);
         if (!owner)
             return;
-        const timeout = this.settings.handOffTimeoutMs ?? 10_000;
+        const timeout = this.options.handOffTimeoutMs ?? 10_000;
         const timer = this.system.scheduler.scheduleOnceFn(timeout, () => {
             if (this.rebalanceInProgress.delete(shardId)) {
                 this.system.log.warn(`[sharding] handoff timeout for shard ${shardId}; forcing reallocate`);
@@ -675,8 +675,8 @@ export class ShardCoordinator extends Actor {
         const info = this.regions.get(home);
         if (!info)
             return;
-        for (const q of pending) {
-            this.replyTo(q.requester, q.requesterNode, {
+        for (const pendingQuery of pending) {
+            this.replyTo(pendingQuery.requester, pendingQuery.requesterNode, {
                 $t: 'sharding.ShardHome',
                 shardId,
                 region: info.path,
@@ -706,13 +706,13 @@ export class ShardCoordinator extends Actor {
     }
     replyTo(path, nodeData, msg) {
         const node = NodeAddress.fromJSON(nodeData);
-        if (node.equals(this.settings.cluster.selfAddress)) {
-            const ref = this.settings.localResolver(path);
+        if (node.equals(this.options.cluster.selfAddress)) {
+            const ref = this.options.localResolver(path);
             if (ref)
                 ref.tell(msg);
             return;
         }
-        const remote = new RemoteActorRef(node, path, this.settings.cluster);
+        const remote = new RemoteActorRef(node, path, this.options.cluster);
         remote.tell(msg);
     }
 }