actor-ts 0.9.1 → 0.11.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cluster/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cluster/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAG7H,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cluster/sharding/AllocationStrategy.js

@@ -51,10 +51,10 @@ export class LeastShardAllocationStrategy {
             throw new Error('LeastShardAllocationStrategy: no candidates');
         let best = candidates[0];
         let bestLoad = currentShards.get(best.toString())?.size ?? 0;
-        for (const c of candidates) {
-            const load = currentShards.get(c.toString())?.size ?? 0;
-            if (load < bestLoad || (load === bestLoad && c.compareTo(best) < 0)) {
-                best = c;
+        for (const candidate of candidates) {
+            const load = currentShards.get(candidate.toString())?.size ?? 0;
+            if (load < bestLoad || (load === bestLoad && candidate.compareTo(best) < 0)) {
+                best = candidate;
                 bestLoad = load;
             }
         }

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

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

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

@@ -1,4 +1,4 @@
-import type { CassandraClientLike, CassandraConnection } from '../../persistence/journals/CassandraClient.js';
+import type { CassandraRememberEntitiesStoreOptions } from './CassandraRememberEntitiesStoreOptions.js';
 import type { RememberEntitiesStore, RememberEvent } from './RememberEntitiesStore.js';
 /**
  * Cassandra-backed `RememberEntitiesStore` for `ClusterSharding` (#84)
@@ -33,20 +33,6 @@ import type { RememberEntitiesStore, RememberEvent } from './RememberEntitiesSto
  * arrives at the same `entitiesPerShard` view the event-replay
  * variant produces.
  */
-export interface CassandraRememberEntitiesStoreOptions extends CassandraConnection {
-    /** Table for the remember-entities state.  Default: `remember_entities`. */
-    readonly table?: string;
-    /** Auto-create the table on first use.  Default: `true`. */
-    readonly autoCreateTables?: boolean;
-    /**
-     * Inject a pre-built CQL client.  When omitted, the store
-     * instantiates its own (via `cassandra-driver`) — but typical
-     * deployments share one client across journal + snapshot store +
-     * remember-entities, so passing the existing one in is the
-     * recommended pattern.
-     */
-    readonly client?: CassandraClientLike;
-}
 export declare class CassandraRememberEntitiesStore implements RememberEntitiesStore {
     private readonly options;
     private client;

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

@@ -1 +1 @@
-{"version":3,"file":"CassandraRememberEntitiesStore.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/CassandraRememberEntitiesStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAE9G,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,qCAAsC,SAAQ,mBAAmB;IAChF,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AASD,qBAAa,8BAA+B,YAAW,qBAAqB;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,qCAAqC;IAMpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAehD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAStC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUd,aAAa;IAK3B,OAAO,KAAK,KAAK,GAAgE;IAEjF,OAAO,CAAC,SAAS;CAGlB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAST"}
+{"version":3,"file":"CassandraRememberEntitiesStore.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/CassandraRememberEntitiesStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qCAAqC,EAA6C,MAAM,4CAA4C,CAAC;AACnJ,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AASvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,8BAA+B,YAAW,qBAAqB;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqD;IAC7E,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,qCAAqC;IAMpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAehD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAStC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUd,aAAa;IAK3B,OAAO,KAAK,KAAK,GAAgE;IAEjF,OAAO,CAAC,SAAS;CAGlB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAST"}

package/dist/cluster/sharding/CassandraRememberEntitiesStore.js

@@ -1,4 +1,37 @@
 import { createCassandraClient, keyspaceDdl } from '../../persistence/journals/CassandraClient.js';
+/**
+ * Cassandra-backed `RememberEntitiesStore` for `ClusterSharding` (#84)
+ * — the natural complement to the existing `JournalRememberEntitiesStore`
+ * for deployments using Cassandra/Scylla as their event journal.
+ *
+ * **Schema design.**  State-based, not event-sourced.  Each known
+ * (type, shard, entity) triple lives as a single row with a
+ * `started_at` timestamp; `stopped` events translate into a row
+ * delete, `started` events into an upsert.  This is materially
+ * cheaper to reload than the journal-backed implementation (one
+ * partition scan vs. replaying every lifecycle event ever recorded
+ * for the type) at the cost of losing history — but the
+ * coordinator only needs the **current** entity set.
+ *
+ * **Partition layout.**  Partition key is `type_name`; clustering
+ * key is `(shard_id, entity_id)`.  Every entity for a given sharded
+ * type lands in one partition.  Acceptable for typical workloads
+ * (thousands of entities per type, fits comfortably in a single
+ * Cassandra partition); for very large entity sets, switch to the
+ * journal-backed store or split the partition by `shard_id` (the
+ * standard Cassandra "wide-row → composite-key" workaround).
+ *
+ * **`clear` semantics.**  Issues `DELETE FROM tbl WHERE type_name = ?`
+ * — a whole-partition delete, atomic in Cassandra.  Scoping resets to
+ * one type at a time matches `JournalRememberEntitiesStore`.
+ *
+ * **Replay shape.**  `load` returns synthetic `'started'` events for
+ * every row currently in the partition.  No `'stopped'` events are
+ * emitted because they were applied via DELETE at write time —
+ * `ShardCoordinator` reapplies the result to its in-memory map and
+ * arrives at the same `entitiesPerShard` view the event-replay
+ * variant produces.
+ */
 export class CassandraRememberEntitiesStore {
     options;
     client;
@@ -7,8 +40,8 @@ export class CassandraRememberEntitiesStore {
     stopped = false;
     constructor(options) {
         this.options = options;
-        this.client = options.client ?? undefined;
-        this.ownsClient = !options.client;
+        this.client = this.options.client ?? undefined;
+        this.ownsClient = !this.options.client;
     }
     async start() {
         if (this.started)

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

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

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

@@ -0,0 +1,63 @@
+import type { CassandraClientLike, CassandraConnection } from '../../persistence/journals/CassandraClient.js';
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Plain options-object shape consumed by {@link CassandraRememberEntitiesStore}
+ * — the shared {@link CassandraConnection} fields plus the store-specific
+ * `table` / `autoCreateTables` / `client`.
+ */
+export interface CassandraRememberEntitiesStoreOptionsType extends CassandraConnection {
+    /** Table for the remember-entities state.  Default: `remember_entities`. */
+    readonly table?: string;
+    /** Auto-create the table on first use.  Default: `true`. */
+    readonly autoCreateTables?: boolean;
+    /**
+     * Inject a pre-built CQL client.  When omitted, the store
+     * instantiates its own (via `cassandra-driver`) — but typical
+     * deployments share one client across journal + snapshot store +
+     * remember-entities, so passing the existing one in is the
+     * recommended pattern.
+     */
+    readonly client?: CassandraClientLike;
+}
+/**
+ * Fluent builder for {@link CassandraRememberEntitiesStoreOptionsType}.
+ * Carries `withX` methods for the shared {@link CassandraConnection}
+ * fields too — the connection mixin is not built on its own; the store
+ * exposes its connection surface directly (same pattern as
+ * `CassandraJournalOptions`).
+ */
+export declare class CassandraRememberEntitiesStoreOptionsBuilder extends OptionsBuilder<CassandraRememberEntitiesStoreOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new CassandraRememberEntitiesStoreOptionsBuilder()`. */
+    static create(): CassandraRememberEntitiesStoreOptionsBuilder;
+    /** Node(s) to seed the cluster topology from. */
+    withContactPoints(contactPoints: ReadonlyArray<string>): this;
+    /** Local DC — required for DCAwareRoundRobinPolicy.  Defaults to `datacenter1`. */
+    withLocalDataCenter(localDataCenter: string): this;
+    /** Keyspace to `USE` after connect.  Must already exist, or pass `withAutoCreateKeyspace(true)`. */
+    withKeyspace(keyspace: string): this;
+    /** Username/password for PLAIN auth. */
+    withCredentials(username: string, password: string): this;
+    /** Port — defaults to 9042. */
+    withPort(port: number): this;
+    /** If true, create the keyspace on startup (simple strategy, rf=1). */
+    withAutoCreateKeyspace(autoCreateKeyspace?: boolean): this;
+    /** Replication options used by autoCreateKeyspace.  Ignored otherwise. */
+    withReplication(replication: NonNullable<CassandraConnection['replication']>): this;
+    /** CQL consistency level for all reads and writes.  Default `LOCAL_QUORUM` (6). */
+    withConsistency(consistency: number): this;
+    /** Table for the remember-entities state.  Default: `remember_entities`. */
+    withTable(table: string): this;
+    /** Auto-create the table on first use.  Default: `true`. */
+    withAutoCreateTables(autoCreateTables?: boolean): this;
+    /** Inject a pre-built CQL client instead of letting the store instantiate its own. */
+    withClient(client: CassandraClientLike): this;
+}
+/**
+ * Accepted input for a {@link CassandraRememberEntitiesStore}: the fluent
+ * {@link CassandraRememberEntitiesStoreOptionsBuilder} OR a plain (partial)
+ * {@link CassandraRememberEntitiesStoreOptionsType} object.
+ */
+export type CassandraRememberEntitiesStoreOptions = CassandraRememberEntitiesStoreOptionsBuilder | Partial<CassandraRememberEntitiesStoreOptionsType>;
+/** Value alias so `CassandraRememberEntitiesStoreOptions.create()` resolves to the builder. */
+export declare const CassandraRememberEntitiesStoreOptions: typeof CassandraRememberEntitiesStoreOptionsBuilder;
+//# sourceMappingURL=CassandraRememberEntitiesStoreOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraRememberEntitiesStoreOptions.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/CassandraRememberEntitiesStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,yCAA0C,SAAQ,mBAAmB;IACpF,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED;;;;;;GAMG;AACH,qBAAa,4CACX,SAAQ,cAAc,CAAC,yCAAyC,CAAC;IACjE,kGAAkG;IAClG,MAAM,CAAC,MAAM,IAAI,4CAA4C;IAM7D,iDAAiD;IACjD,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI7D,mFAAmF;IACnF,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAIlD,oGAAoG;IACpG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,wCAAwC;IACxC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIzD,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,uEAAuE;IACvE,sBAAsB,CAAC,kBAAkB,UAAO,GAAG,IAAI;IAIvD,0EAA0E;IAC1E,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI;IAInF,mFAAmF;IACnF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM1C,4EAA4E;IAC5E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,4DAA4D;IAC5D,oBAAoB,CAAC,gBAAgB,UAAO,GAAG,IAAI;IAInD,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;CAG9C;AAED;;;;GAIG;AACH,MAAM,MAAM,qCAAqC,GAC7C,4CAA4C,GAC5C,OAAO,CAAC,yCAAyC,CAAC,CAAC;AACvD,+FAA+F;AAC/F,eAAO,MAAM,qCAAqC,qDAA+C,CAAC"}

package/dist/cluster/sharding/CassandraRememberEntitiesStoreOptions.js

@@ -0,0 +1,63 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link CassandraRememberEntitiesStoreOptionsType}.
+ * Carries `withX` methods for the shared {@link CassandraConnection}
+ * fields too — the connection mixin is not built on its own; the store
+ * exposes its connection surface directly (same pattern as
+ * `CassandraJournalOptions`).
+ */
+export class CassandraRememberEntitiesStoreOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new CassandraRememberEntitiesStoreOptionsBuilder()`. */
+    static create() {
+        return new CassandraRememberEntitiesStoreOptionsBuilder();
+    }
+    /* --- shared CassandraConnection fields --- */
+    /** Node(s) to seed the cluster topology from. */
+    withContactPoints(contactPoints) {
+        return this.set('contactPoints', contactPoints);
+    }
+    /** Local DC — required for DCAwareRoundRobinPolicy.  Defaults to `datacenter1`. */
+    withLocalDataCenter(localDataCenter) {
+        return this.set('localDataCenter', localDataCenter);
+    }
+    /** Keyspace to `USE` after connect.  Must already exist, or pass `withAutoCreateKeyspace(true)`. */
+    withKeyspace(keyspace) {
+        return this.set('keyspace', keyspace);
+    }
+    /** Username/password for PLAIN auth. */
+    withCredentials(username, password) {
+        return this.set('credentials', { username, password });
+    }
+    /** Port — defaults to 9042. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** If true, create the keyspace on startup (simple strategy, rf=1). */
+    withAutoCreateKeyspace(autoCreateKeyspace = true) {
+        return this.set('autoCreateKeyspace', autoCreateKeyspace);
+    }
+    /** Replication options used by autoCreateKeyspace.  Ignored otherwise. */
+    withReplication(replication) {
+        return this.set('replication', replication);
+    }
+    /** CQL consistency level for all reads and writes.  Default `LOCAL_QUORUM` (6). */
+    withConsistency(consistency) {
+        return this.set('consistency', consistency);
+    }
+    /* --- store-specific fields --- */
+    /** Table for the remember-entities state.  Default: `remember_entities`. */
+    withTable(table) {
+        return this.set('table', table);
+    }
+    /** Auto-create the table on first use.  Default: `true`. */
+    withAutoCreateTables(autoCreateTables = true) {
+        return this.set('autoCreateTables', autoCreateTables);
+    }
+    /** Inject a pre-built CQL client instead of letting the store instantiate its own. */
+    withClient(client) {
+        return this.set('client', client);
+    }
+}
+/** Value alias so `CassandraRememberEntitiesStoreOptions.create()` resolves to the builder. */
+export const CassandraRememberEntitiesStoreOptions = CassandraRememberEntitiesStoreOptionsBuilder;
+//# sourceMappingURL=CassandraRememberEntitiesStoreOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraRememberEntitiesStoreOptions.js","sourceRoot":"","sources":["../../../src/cluster/sharding/CassandraRememberEntitiesStoreOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAsB9D;;;;;;GAMG;AACH,MAAM,OAAO,4CACX,SAAQ,cAAyD;IACjE,kGAAkG;IAClG,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,4CAA4C,EAAE,CAAC;IAC5D,CAAC;IAED,+CAA+C;IAE/C,iDAAiD;IACjD,iBAAiB,CAAC,aAAoC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,mFAAmF;IACnF,mBAAmB,CAAC,eAAuB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,oGAAoG;IACpG,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,wCAAwC;IACxC,eAAe,CAAC,QAAgB,EAAE,QAAgB;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,+BAA+B;IAC/B,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,kBAAkB,GAAG,IAAI;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IAC5D,CAAC;IAED,0EAA0E;IAC1E,eAAe,CAAC,WAA4D;QAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,mFAAmF;IACnF,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,mCAAmC;IAEnC,4EAA4E;IAC5E,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,4DAA4D;IAC5D,oBAAoB,CAAC,gBAAgB,GAAG,IAAI;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,sFAAsF;IACtF,UAAU,CAAC,MAA2B;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAUD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,qCAAqC,GAAG,4CAA4C,CAAC"}

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

@@ -1,58 +1,8 @@
 import type { ActorRef } from '../../ActorRef.js';
 import type { ActorSystem } from '../../ActorSystem.js';
-import type { Lease } from '../../coordination/Lease.js';
 import type { Cluster } from '../Cluster.js';
-import { AllocationStrategy } from './AllocationStrategy.js';
-import type { CoordinatorStateStore } from './CoordinatorState.js';
-import { type RememberEntitiesStore } from './RememberEntitiesStore.js';
-import { type ShardingSettings } from './ShardRegion.js';
+import type { StartShardingOptions } from './StartShardingOptions.js';
 import { isShardingMessage } from './ShardingProtocol.js';
-export interface StartSettings<TMsg> extends ShardingSettings<TMsg> {
-    /** Strategy the coordinator uses to allocate and rebalance shards. */
-    readonly allocationStrategy?: AllocationStrategy;
-    /** Gap between coordinator-driven rebalance passes. */
-    readonly rebalanceIntervalMs?: number;
-    /** Time to wait for HandOffComplete before force-reallocating. */
-    readonly handOffTimeoutMs?: number;
-    /**
-     * Optional split-brain protection for the coordinator.  When set,
-     * the elected leader's coordinator must hold the lease before it
-     * processes shard messages — under a network partition that
-     * produces two leader views, only the side that successfully
-     * acquires the lease ever issues `AllocateShard` / `HandOff`
-     * directives.  See `ShardCoordinatorSettings.lease`.
-     */
-    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 — relevant
-     * only when `rememberEntities: true`.  When omitted (and
-     * `rememberEntities: true`), the default
-     * `JournalRememberEntitiesStore` is auto-instantiated using the
-     * Journal from the system's `PersistenceExtension`, so a full
-     * cluster cold-start no longer loses the registry.  Set to a
-     * custom impl to plug in a separate store.
-     *
-     * Pass `null` to opt out of persistence entirely (registry stays
-     * in-memory only — the v1 behaviour).
-     */
-    readonly rememberEntitiesStore?: RememberEntitiesStore | null;
-    /**
-     * Optional persistence backend for the coordinator's allocation
-     * state (`regions` + `shardHome`).  When set, a new leader
-     * elected after the previous leader's failure can seed its
-     * coordinator from the snapshot instead of running
-     * `tryAllocate` from scratch — saves a brief reallocation storm
-     * at thousands-of-shards scale.
-     *
-     * Unlike `rememberEntitiesStore`, ClusterSharding does NOT
-     * auto-instantiate this — the user must explicitly pass a store
-     * (typically `new DistributedDataCoordinatorStateStore(dd, ...)`).
-     * Without it, the v1 rebuild-from-Register behaviour is preserved.
-     */
-    readonly coordinatorStateStore?: CoordinatorStateStore;
-}
 /**
  * User-facing entry point.  Attaches to an ActorSystem + Cluster pair and
  * lets you start a sharded region for each entity type.  A `ShardCoordinator`
@@ -77,24 +27,28 @@ export declare class ClusterSharding {
      * });
      *
      * // Shorthand: pass a factory.  Useful for closures / DI / no-arg new.
-     * sharding.start('cart', () => new CartEntity(deps), {
-     *   extractEntityId: (msg) => msg.entityId,
-     * });
+     * sharding.start('cart', () => new CartEntity(deps),
+     *   StartShardingOptions.create<CartMessage>().withExtractEntityId((msg) => msg.entityId));
      *
-     * // Full-form: explicit Props + all settings (unchanged).
-     * sharding.start({
-     *   typeName: 'counter',
-     *   entityProps: Props.create(() => new CounterEntity()),
-     *   extractEntityId: (msg) => msg.id,
-     * });
+     * // Full-form: explicit Props + all options via the builder.
+     * sharding.start(
+     *   StartShardingOptions.create<CounterMessage>()
+     *     .withTypeName('counter')
+     *     .withEntityProps(Props.create(() => new CounterEntity()))
+     *     .withExtractEntityId((msg) => msg.id),
+     * );
      * ```
      */
-    start<TMsg>(settings: StartSettings<TMsg>): ActorRef<TMsg>;
-    start<TMsg>(typeName: string, entity: (new () => import('../../Actor.js').Actor<TMsg>) | (() => import('../../Actor.js').Actor<TMsg>), opts: Omit<StartSettings<TMsg>, 'typeName' | 'entityProps'>): ActorRef<TMsg>;
-    /** @internal — wrap the shorthand entity arg into a Props + assemble full settings. */
-    private buildSettingsFromShorthand;
-    /** Start a proxy region — routes to the cluster but never hosts entities. */
-    startProxy<TMsg>(settings: Omit<StartSettings<TMsg>, 'proxy'>): ActorRef<TMsg>;
+    start<TMessage>(options: StartShardingOptions<TMessage>): ActorRef<TMessage>;
+    start<TMessage>(typeName: string, entity: (new () => import('../../Actor.js').Actor<TMessage>) | (() => import('../../Actor.js').Actor<TMessage>), options?: StartShardingOptions<TMessage>): ActorRef<TMessage>;
+    /** @internal — wrap the shorthand entity arg into a Props + assemble full options. */
+    private buildOptionsFromShorthand;
+    /**
+     * Start a proxy region — routes to the cluster but never hosts entities.
+     * Takes the same builder as {@link start}; `proxy` is forced on internally,
+     * so any `withProxy(...)` on the passed builder is overridden.
+     */
+    startProxy<TMessage>(options: StartShardingOptions<TMessage>): ActorRef<TMessage>;
     private ensureCoordinator;
     /**
      * Resolve the `rememberEntitiesStore` for a sharded type:

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

@@ -1 +1 @@
-{"version":3,"file":"ClusterSharding.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/ClusterSharding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAA0B,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,aAAa,CAAC,IAAI,CAAE,SAAQ,gBAAgB,CAAC,IAAI,CAAC;IACjE,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,uDAAuD;IACvD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC9D;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CACxD;AAED;;;;;GAKG;AACH,qBAAa,eAAe;aAKR,MAAM,EAAE,WAAW;aACnB,OAAO,EAAE,OAAO;IALlC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IAErE,OAAO;IAOP,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+C;IAEvE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe;IAQlE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC1D,KAAK,CAAC,IAAI,EACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,UAAU,OAAO,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EACvG,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,GAC1D,QAAQ,CAAC,IAAI,CAAC;IA6BjB,uFAAuF;IACvF,OAAO,CAAC,0BAA0B;IAoBlC,6EAA6E;IAC7E,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;IAM9E,OAAO,CAAC,iBAAiB;IA2BzB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,4BAA4B;IAUpC,OAAO,CAAC,2BAA2B;IAKnC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;CAQzB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"ClusterSharding.d.ts","sourceRoot":"","sources":["../../../src/cluster/sharding/ClusterSharding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAc7C,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,eAAe;aAKR,MAAM,EAAE,WAAW;aACnB,OAAO,EAAE,OAAO;IALlC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IAErE,OAAO;IAOP,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+C;IAEvE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe;IAQlE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC5E,KAAK,CAAC,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,UAAU,OAAO,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAC/G,OAAO,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACvC,QAAQ,CAAC,QAAQ,CAAC;IA8BrB,sFAAsF;IACtF,OAAO,CAAC,yBAAyB;IAyBjC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAUjF,OAAO,CAAC,iBAAiB;IA8BzB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,4BAA4B;IAUpC,OAAO,CAAC,2BAA2B;IAKnC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;CAQzB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/cluster/sharding/ClusterSharding.js

@@ -4,6 +4,8 @@ import { HashAllocationStrategy } from './AllocationStrategy.js';
 import { JournalRememberEntitiesStore, } from './RememberEntitiesStore.js';
 import { ShardRegion, coordinatorPath, } from './ShardRegion.js';
 import { ShardCoordinator } from './ShardCoordinator.js';
+import { ShardCoordinatorOptions } from './ShardCoordinatorOptions.js';
+import { StartShardingOptionsValidator } from './StartShardingOptions.js';
 import { isShardingMessage } from './ShardingProtocol.js';
 /**
  * User-facing entry point.  Attaches to an ActorSystem + Cluster pair and
@@ -31,23 +33,25 @@ export class ClusterSharding {
         return created;
     }
     start(arg1, arg2, arg3) {
-        const settings = typeof arg1 === 'string'
-            ? this.buildSettingsFromShorthand(arg1, arg2, arg3 ?? {})
+        const options = typeof arg1 === 'string'
+            ? this.buildOptionsFromShorthand(arg1, arg2, arg3 ?? {})
             : arg1;
-        this.ensureCoordinator(settings);
-        const existing = this.findRegionByType(settings.typeName);
+        new StartShardingOptionsValidator().validate(options);
+        this.ensureCoordinator(options);
+        const existing = this.findRegionByType(options.typeName);
         if (existing)
             return existing;
-        const cfg = ShardRegion.settingsToConfig(settings, this.cluster, (path) => this.regionsByPath.get(path) ?? null);
+        const cfg = ShardRegion.settingsToConfig(options, this.cluster, (path) => this.regionsByPath.get(path) ?? null);
         const ref = this.system.spawn(
-        // ShardRegion internally handles extra envelope types; cast to Actor<TMsg>
+        // ShardRegion internally handles extra envelope types; cast to Actor<TMessage>
         // so the returned ref presents the user-facing signature.
-        Props.create(() => new ShardRegion(cfg)), `sharding-${settings.typeName}`);
+        Props.create(() => new ShardRegion(cfg)), `sharding-${options.typeName}`);
         this.regionsByPath.set(ref.path.toString(), ref);
         return ref;
     }
-    /** @internal — wrap the shorthand entity arg into a Props + assemble full settings. */
-    buildSettingsFromShorthand(typeName, entity, opts) {
+    /** @internal — wrap the shorthand entity arg into a Props + assemble full options. */
+    buildOptionsFromShorthand(typeName, entity, options) {
+        const opts = options;
         // Classes have a `.prototype` whose `constructor` === the class itself.
         // Arrow functions don't have `prototype`; regular non-class functions do
         // (with `.prototype.constructor === fn`), so we treat anything that's
@@ -59,33 +63,55 @@ export class ClusterSharding {
         const factory = isClass
             ? () => new entity()
             : entity;
-        return { ...opts, typeName, entityProps: Props.create(factory) };
+        return {
+            ...opts,
+            typeName,
+            entityProps: Props.create(factory),
+        };
     }
-    /** Start a proxy region — routes to the cluster but never hosts entities. */
-    startProxy(settings) {
-        return this.start({ ...settings, proxy: true });
+    /**
+     * Start a proxy region — routes to the cluster but never hosts entities.
+     * Takes the same builder as {@link start}; `proxy` is forced on internally,
+     * so any `withProxy(...)` on the passed builder is overridden.
+     */
+    startProxy(options) {
+        // Force `proxy: true` regardless of what the caller passed.  Resolve to a
+        // plain options object first so both builder and plain-object inputs are
+        // handled uniformly (a `Partial<StartShardingOptionsType>` has no `.withProxy`).
+        const resolvedOptions = { ...options, proxy: true };
+        return this.start(resolvedOptions);
     }
     /* ------------------------------- Internal -------------------------------- */
-    ensureCoordinator(settings) {
-        if (this.coordinators.has(settings.typeName))
+    ensureCoordinator(options) {
+        if (this.coordinators.has(options.typeName))
             return;
-        const coordinatorSettings = {
-            typeName: settings.typeName,
-            cluster: this.cluster,
-            allocationStrategy: settings.allocationStrategy ?? new HashAllocationStrategy(),
-            role: settings.role,
-            rebalanceIntervalMs: settings.rebalanceIntervalMs,
-            handOffTimeoutMs: settings.handOffTimeoutMs,
-            rememberEntities: settings.rememberEntities,
-            rememberEntitiesStore: this.resolveRememberEntitiesStore(settings),
-            coordinatorStateStore: settings.coordinatorStateStore,
-            lease: settings.lease,
-            acquireRetryIntervalMs: settings.acquireRetryIntervalMs,
-            localResolver: (path) => this.regionsByPath.get(path) ?? this.coordinators.get(this.typeNameFromCoordinatorPath(path) ?? '') ?? null,
-        };
-        const ref = this.system.spawn(Props.create(() => new ShardCoordinator(coordinatorSettings)), `sharding-coordinator-${settings.typeName}`);
-        this.coordinators.set(settings.typeName, ref);
-        this.regionsByPath.set(coordinatorPath(this.system.name, settings.typeName), ref);
+        const coordinatorOptions = ShardCoordinatorOptions.create()
+            .withTypeName(options.typeName)
+            .withCluster(this.cluster)
+            .withAllocationStrategy(options.allocationStrategy ?? new HashAllocationStrategy())
+            .withLocalResolver((path) => this.regionsByPath.get(path)
+            ?? this.coordinators.get(this.typeNameFromCoordinatorPath(path) ?? '')
+            ?? null);
+        if (options.role !== undefined)
+            coordinatorOptions.withRole(options.role);
+        if (options.rebalanceIntervalMs !== undefined)
+            coordinatorOptions.withRebalanceIntervalMs(options.rebalanceIntervalMs);
+        if (options.handOffTimeoutMs !== undefined)
+            coordinatorOptions.withHandOffTimeoutMs(options.handOffTimeoutMs);
+        if (options.rememberEntities !== undefined)
+            coordinatorOptions.withRememberEntities(options.rememberEntities);
+        const store = this.resolveRememberEntitiesStore(options);
+        if (store !== undefined)
+            coordinatorOptions.withRememberEntitiesStore(store);
+        if (options.coordinatorStateStore !== undefined)
+            coordinatorOptions.withCoordinatorStateStore(options.coordinatorStateStore);
+        if (options.lease !== undefined)
+            coordinatorOptions.withLease(options.lease);
+        if (options.acquireRetryIntervalMs !== undefined)
+            coordinatorOptions.withAcquireRetryIntervalMs(options.acquireRetryIntervalMs);
+        const ref = this.system.spawn(Props.create(() => new ShardCoordinator(coordinatorOptions)), `sharding-coordinator-${options.typeName}`);
+        this.coordinators.set(options.typeName, ref);
+        this.regionsByPath.set(coordinatorPath(this.system.name, options.typeName), ref);
     }
     /**
      * Resolve the `rememberEntitiesStore` for a sharded type:
@@ -98,19 +124,19 @@ export class ClusterSharding {
      *     extension so the registry survives cluster cold-starts
      *     without the user wiring anything up.
      */
-    resolveRememberEntitiesStore(settings) {
-        if (!settings.rememberEntities)
+    resolveRememberEntitiesStore(options) {
+        if (!options.rememberEntities)
             return undefined;
-        if (settings.rememberEntitiesStore === null)
+        if (options.rememberEntitiesStore === null)
             return undefined;
-        if (settings.rememberEntitiesStore)
-            return settings.rememberEntitiesStore;
+        if (options.rememberEntitiesStore)
+            return options.rememberEntitiesStore;
         const journal = this.system.extension(PersistenceExtensionId).journal;
         return new JournalRememberEntitiesStore(journal);
     }
     typeNameFromCoordinatorPath(path) {
-        const m = path.match(/\/sharding-coordinator-([^/]+)$/);
-        return m ? m[1] : null;
+        const match = path.match(/\/sharding-coordinator-([^/]+)$/);
+        return match ? match[1] : null;
     }
     findRegionByType(typeName) {
         const suffix = `/user/sharding-${typeName}`;

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

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

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

@@ -67,7 +67,7 @@ export interface CoordinatorStateStore {
  * tick.  In a 3-node cluster, the previous leader's last write
  * reaches the new leader within ~2 gossip rounds in expectation.
  * For sub-second failover the user can tighten
- * `DistributedDataSettings.gossipIntervalMs`.
+ * `DistributedDataOptionsType.gossipInterval`.
  */
 export declare class DistributedDataCoordinatorStateStore implements CoordinatorStateStore {
     private readonly dd;

package/dist/cluster/sharding/CoordinatorState.js

@@ -17,7 +17,7 @@ import { LWWRegister } from '../../crdt/LWWRegister.js';
  * tick.  In a 3-node cluster, the previous leader's last write
  * reaches the new leader within ~2 gossip rounds in expectation.
  * For sub-second failover the user can tighten
- * `DistributedDataSettings.gossipIntervalMs`.
+ * `DistributedDataOptionsType.gossipInterval`.
  */
 export class DistributedDataCoordinatorStateStore {
     dd;