actor-ts 0.9.0 → 0.10.0

package/dist/cluster/router/ClusterRouterOptions.d.ts

@@ -0,0 +1,60 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { Cluster } from '../Cluster.js';
+import type { ClusterRouterType } from './ClusterRouter.js';
+/** Plain settings-object shape consumed by {@link ClusterRouter.props}. */
+export interface ClusterRouterOptionsType<TMsg> {
+    /** The cluster the router lives in.  Used for membership + transport. */
+    readonly cluster: Cluster;
+    /** Restrict routees to up-members carrying this role.  Omit for "any node". */
+    readonly role?: string;
+    /** Strategy.  See {@link ClusterRouterType}. */
+    readonly routerType: ClusterRouterType;
+    /**
+     * The path the routee actor lives under on each routee node — usually
+     * `/user/<actorName>`.  The same path must exist on every targeted
+     * node; the router doesn't probe for liveness beyond the cluster
+     * membership state.
+     */
+    readonly routeePath: string;
+    /**
+     * Required for `routerType: 'consistent-hashing'`, ignored otherwise.
+     * Returns the string key used to pin a message to a routee.  Two
+     * messages with the same key always land on the same node (subject
+     * to the cluster topology not changing).
+     */
+    readonly extractKey?: (message: TMsg) => string;
+}
+/**
+ * Fluent builder for {@link ClusterRouterOptionsType}:
+ *
+ *     ClusterRouter.props(
+ *       ClusterRouterOptions.create<Cmd>()
+ *         .withCluster(cluster)
+ *         .withRouterType('consistent-hashing')
+ *         .withRouteePath('/user/worker')
+ *         .withExtractKey((m) => m.id),
+ *     );
+ */
+export declare class ClusterRouterOptionsBuilder<TMsg> extends OptionsBuilder<ClusterRouterOptionsType<TMsg>> {
+    /** Start a fresh builder. */
+    static create<TMsg>(): ClusterRouterOptionsBuilder<TMsg>;
+    /** The cluster the router lives in — drives membership + transport. */
+    withCluster(cluster: Cluster): this;
+    /** Restrict routees to up-members carrying this role.  Omit for "any node". */
+    withRole(role: string): this;
+    /** Routing strategy.  See {@link ClusterRouterType}. */
+    withRouterType(routerType: ClusterRouterType): this;
+    /** The path the routee actor lives under on each node — usually `/user/<name>`. */
+    withRouteePath(routeePath: string): this;
+    /** Key extractor — required for `consistent-hashing`, ignored otherwise. */
+    withExtractKey(extractKey: (message: TMsg) => string): this;
+}
+/**
+ * Accepted input for {@link ClusterRouter.props}: the fluent
+ * {@link ClusterRouterOptionsBuilder} OR a plain (partial)
+ * {@link ClusterRouterOptionsType} object.
+ */
+export type ClusterRouterOptions<TMsg> = ClusterRouterOptionsBuilder<TMsg> | Partial<ClusterRouterOptionsType<TMsg>>;
+/** Value alias so `ClusterRouterOptions.create()` / `new ClusterRouterOptions()` resolve to the builder. */
+export declare const ClusterRouterOptions: typeof ClusterRouterOptionsBuilder;
+//# sourceMappingURL=ClusterRouterOptions.d.ts.map

package/dist/cluster/router/ClusterRouterOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterRouterOptions.d.ts","sourceRoot":"","sources":["../../../src/cluster/router/ClusterRouterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB,CAAC,IAAI;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,2BAA2B,CAAC,IAAI,CAAE,SAAQ,cAAc,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACnG,6BAA6B;IAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,CAAC;IAIxD,uEAAuE;IACvE,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,wDAAwD;IACxD,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAInD,mFAAmF;IACnF,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,4EAA4E;IAC5E,cAAc,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,GAAG,IAAI;CAG5D;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,IAAI,IACjC,2BAA2B,CAAC,IAAI,CAAC,GACjC,OAAO,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}

package/dist/cluster/router/ClusterRouterOptions.js

@@ -0,0 +1,41 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ClusterRouterOptionsType}:
+ *
+ *     ClusterRouter.props(
+ *       ClusterRouterOptions.create<Cmd>()
+ *         .withCluster(cluster)
+ *         .withRouterType('consistent-hashing')
+ *         .withRouteePath('/user/worker')
+ *         .withExtractKey((m) => m.id),
+ *     );
+ */
+export class ClusterRouterOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder. */
+    static create() {
+        return new ClusterRouterOptionsBuilder();
+    }
+    /** The cluster the router lives in — drives membership + transport. */
+    withCluster(cluster) {
+        return this.set('cluster', cluster);
+    }
+    /** Restrict routees to up-members carrying this role.  Omit for "any node". */
+    withRole(role) {
+        return this.set('role', role);
+    }
+    /** Routing strategy.  See {@link ClusterRouterType}. */
+    withRouterType(routerType) {
+        return this.set('routerType', routerType);
+    }
+    /** The path the routee actor lives under on each node — usually `/user/<name>`. */
+    withRouteePath(routeePath) {
+        return this.set('routeePath', routeePath);
+    }
+    /** Key extractor — required for `consistent-hashing`, ignored otherwise. */
+    withExtractKey(extractKey) {
+        return this.set('extractKey', extractKey);
+    }
+}
+/** Value alias so `ClusterRouterOptions.create()` / `new ClusterRouterOptions()` resolve to the builder. */
+export const ClusterRouterOptions = ClusterRouterOptionsBuilder;
+//# sourceMappingURL=ClusterRouterOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterRouterOptions.js","sourceRoot":"","sources":["../../../src/cluster/router/ClusterRouterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA4B9D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,2BAAkC,SAAQ,cAA8C;IACnG,6BAA6B;IAC7B,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,2BAA2B,EAAQ,CAAC;IACjD,CAAC;IAED,uEAAuE;IACvE,WAAW,CAAC,OAAgB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+EAA+E;IAC/E,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,wDAAwD;IACxD,cAAc,CAAC,UAA6B;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,mFAAmF;IACnF,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,cAAc,CAAC,UAAqC;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAUD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}

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

@@ -1,4 +1,6 @@
 export { ClusterRouter } from './ClusterRouter.js';
-export type { ClusterRouterOptions, ClusterRouterType, } from './ClusterRouter.js';
+export { ClusterRouterOptions, ClusterRouterOptionsBuilder } from './ClusterRouterOptions.js';
+export type { ClusterRouterOptionsType } from './ClusterRouterOptions.js';
+export type { ClusterRouterType } from './ClusterRouter.js';
 export { pickRendezvous } from './ConsistentHashing.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cluster/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cluster/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC9F,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cluster/router/index.js

@@ -1,3 +1,4 @@
 export { ClusterRouter } from './ClusterRouter.js';
+export { ClusterRouterOptions, ClusterRouterOptionsBuilder } from './ClusterRouterOptions.js';
 export { pickRendezvous } from './ConsistentHashing.js';
 //# sourceMappingURL=index.js.map

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,MAAM,2BAA2B,CAAC;AAG9F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

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 settings-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 settings 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,2EAA2E;IAC3E,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 settings 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,2EAA2E;IAC3E,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<CartMsg>().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 settings via the builder.
+     * sharding.start(
+     *   StartShardingOptions.create<CounterMsg>()
+     *     .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>;
+    start<TMsg>(options: StartShardingOptions<TMsg>): ActorRef<TMsg>;
+    start<TMsg>(typeName: string, entity: (new () => import('../../Actor.js').Actor<TMsg>) | (() => import('../../Actor.js').Actor<TMsg>), options?: StartShardingOptions<TMsg>): 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 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<TMsg>(options: StartShardingOptions<TMsg>): ActorRef<TMsg>;
     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;AAa7C,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,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;IAChE,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,OAAO,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,GACnC,QAAQ,CAAC,IAAI,CAAC;IA6BjB,uFAAuF;IACvF,OAAO,CAAC,0BAA0B;IAyBlC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;IAUrE,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,7 @@ 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 { isShardingMessage } from './ShardingProtocol.js';
 /**
  * User-facing entry point.  Attaches to an ActorSystem + Cluster pair and
@@ -47,7 +48,8 @@ export class ClusterSharding {
         return ref;
     }
     /** @internal — wrap the shorthand entity arg into a Props + assemble full settings. */
-    buildSettingsFromShorthand(typeName, entity, opts) {
+    buildSettingsFromShorthand(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,31 +61,53 @@ 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 settings object first so both builder and plain-object inputs are
+        // handled uniformly (a `Partial<StartShardingOptionsType>` has no `.withProxy`).
+        const settings = { ...options, proxy: true };
+        return this.start(settings);
     }
     /* ------------------------------- Internal -------------------------------- */
     ensureCoordinator(settings) {
         if (this.coordinators.has(settings.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}`);
+        const coordinatorOptions = ShardCoordinatorOptions.create()
+            .withTypeName(settings.typeName)
+            .withCluster(this.cluster)
+            .withAllocationStrategy(settings.allocationStrategy ?? new HashAllocationStrategy())
+            .withLocalResolver((path) => this.regionsByPath.get(path)
+            ?? this.coordinators.get(this.typeNameFromCoordinatorPath(path) ?? '')
+            ?? null);
+        if (settings.role !== undefined)
+            coordinatorOptions.withRole(settings.role);
+        if (settings.rebalanceIntervalMs !== undefined)
+            coordinatorOptions.withRebalanceIntervalMs(settings.rebalanceIntervalMs);
+        if (settings.handOffTimeoutMs !== undefined)
+            coordinatorOptions.withHandOffTimeoutMs(settings.handOffTimeoutMs);
+        if (settings.rememberEntities !== undefined)
+            coordinatorOptions.withRememberEntities(settings.rememberEntities);
+        const store = this.resolveRememberEntitiesStore(settings);
+        if (store !== undefined)
+            coordinatorOptions.withRememberEntitiesStore(store);
+        if (settings.coordinatorStateStore !== undefined)
+            coordinatorOptions.withCoordinatorStateStore(settings.coordinatorStateStore);
+        if (settings.lease !== undefined)
+            coordinatorOptions.withLease(settings.lease);
+        if (settings.acquireRetryIntervalMs !== undefined)
+            coordinatorOptions.withAcquireRetryIntervalMs(settings.acquireRetryIntervalMs);
+        const ref = this.system.spawn(Props.create(() => new ShardCoordinator(coordinatorOptions)), `sharding-coordinator-${settings.typeName}`);
         this.coordinators.set(settings.typeName, ref);
         this.regionsByPath.set(coordinatorPath(this.system.name, settings.typeName), ref);
     }

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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"}