actor-ts 0.9.1 → 0.10.0

package/dist/cluster/singleton/ClusterSingleton.js

@@ -2,6 +2,7 @@ import { extensionId } from '../../Extension.js';
 import { Props } from '../../Props.js';
 import { fromNullable } from '../../util/Option.js';
 import { ClusterSingletonManager, singletonManagerPath, } from './ClusterSingletonManager.js';
+import { ClusterSingletonManagerOptions } from './ClusterSingletonManagerOptions.js';
 import { ClusterSingletonProxy } from './ClusterSingletonProxy.js';
 /**
  * Extension registered on the ActorSystem that manages all
@@ -15,7 +16,8 @@ export class ClusterSingleton {
     constructor(system) {
         this.system = system;
     }
-    start(cluster, settings) {
+    start(cluster, options) {
+        const settings = options;
         const existing = this.handles.get(settings.typeName);
         if (existing)
             return existing;
@@ -31,14 +33,18 @@ export class ClusterSingleton {
                 managerRef.tell({ t: 'singleton-deliver', body: env.body });
         });
         const managerProps = Props.create(() => {
-            const mgr = new ClusterSingletonManager({
-                cluster,
-                typeName: settings.typeName,
-                singletonProps: settings.props,
-                role: settings.role,
-                lease: settings.lease,
-                acquireRetryIntervalMs: settings.acquireRetryIntervalMs,
-            });
+            const managerOptions = ClusterSingletonManagerOptions.create()
+                .withCluster(cluster)
+                .withTypeName(settings.typeName)
+                .withSingletonProps(settings.props);
+            if (settings.role !== undefined)
+                managerOptions.withRole(settings.role);
+            if (settings.lease !== undefined)
+                managerOptions.withLease(settings.lease);
+            if (settings.acquireRetryIntervalMs !== undefined) {
+                managerOptions.withAcquireRetryIntervalMs(settings.acquireRetryIntervalMs);
+            }
+            const mgr = new ClusterSingletonManager(managerOptions);
             mgr._envelopeUnsub = envelopeUnsub;
             return mgr;
         });

package/dist/cluster/singleton/ClusterSingleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterSingleton.js","sourceRoot":"","sources":["../../../src/cluster/singleton/ClusterSingleton.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GAErB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAuCnE;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAEE;IADrB,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC9D,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAI,OAAgB,EAAE,QAAmC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,QAAQ;YAAE,OAAO,QAA8B,CAAC;QAEpD,uEAAuE;QACvE,qEAAqE;QACrE,wEAAwE;QACxE,kCAAkC;QAClC,IAAI,UAAU,GAAa,IAA2B,CAAC;QACvD,MAAM,aAAa,GAAG,OAAO,CAAC,wBAAwB,CACpD,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACzD,CAAC,GAAG,EAAE,EAAE;YACN,mEAAmE;YACnE,uDAAuD;YACvD,IAAI,UAAU;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAA+B,CAAC,CAAC;QAC3G,CAAC,CACF,CAAC;QAEF,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAI;gBACzC,OAAO;gBACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,cAAc,EAAE,QAAQ,CAAC,KAAK;gBAC9B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;aACxD,CAAC,CAAC;YACH,GAAG,CAAC,cAAc,GAAG,aAAa,CAAC;YACnC,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,qBAAqB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,IAAI,qBAAqB,CAAI,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACnF,MAAM,MAAM,GAAuB;YACjC,KAAK,EAAE,OAAO,EAAE,UAAU;YAC1B,IAAI;gBACF,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC;SACF,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAkC,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,0DAA0D;IAC1D,GAAG,CAAI,QAAgB;QACrB,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAmC,CAAC,CAAC;IACpF,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAkC,WAAW,CAC1E,4BAA4B,EAC5B,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CACzC,CAAC"}
+{"version":3,"file":"ClusterSingleton.js","sourceRoot":"","sources":["../../../src/cluster/singleton/ClusterSingleton.ts"],"names":[],"mappings":"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"}

package/dist/cluster/singleton/ClusterSingletonManager.d.ts

@@ -1,8 +1,6 @@
 import { Actor } from '../../Actor.js';
-import type { Lease } from '../../coordination/Lease.js';
-import type { Props } from '../../Props.js';
 import { Terminated } from '../../SystemMessages.js';
-import type { Cluster } from '../Cluster.js';
+import type { ClusterSingletonManagerOptions, ClusterSingletonManagerOptionsType } from './ClusterSingletonManagerOptions.js';
 /**
  * Path at which every node hosts its ClusterSingletonManager for a given
  * singleton typeName.  Used by the proxy/envelope layer to address the
@@ -33,19 +31,6 @@ type ManagerEvent = {
     t: 'acquire-retry';
 };
 type Inbox = SingletonDeliver | ManagerEvent | Terminated;
-export interface ClusterSingletonManagerSettings<T> {
-    readonly cluster: Cluster;
-    /** Logical name for this singleton; also used as the child-actor name. */
-    readonly typeName: string;
-    /** How to construct the singleton actor.  Only instantiated on the leader. */
-    readonly singletonProps: Props<T>;
-    /** Optional role — only nodes with this role will host the singleton. */
-    readonly role?: string;
-    /** Optional split-brain protection — see {@link StartSingletonSettings.lease}. */
-    readonly lease?: Lease;
-    /** Retry interval for `lease.acquire()` after a failed attempt.  Default: 5 s. */
-    readonly acquireRetryIntervalMs?: number;
-}
 /**
  * Runs on every node.  Watches cluster events and (re)spawns the singleton
  * child when this node is the cluster leader; stops the child when it is not.
@@ -65,7 +50,6 @@ export interface ClusterSingletonManagerSettings<T> {
  *   with an in-flight acquire.
  */
 export declare class ClusterSingletonManager<T> extends Actor<Inbox> {
-    readonly settings: ClusterSingletonManagerSettings<T>;
     private child;
     /**
      * The previous child while it is mid-stop.  We watch every child we
@@ -88,7 +72,8 @@ export declare class ClusterSingletonManager<T> extends Actor<Inbox> {
     private leaseState;
     /** Callback the extension hands us so we can release the envelope path on stop. */
     _envelopeUnsub: (() => void) | null;
-    constructor(settings: ClusterSingletonManagerSettings<T>);
+    readonly settings: ClusterSingletonManagerOptionsType<T>;
+    constructor(options: ClusterSingletonManagerOptions<T>);
     preStart(): void;
     postStop(): Promise<void>;
     onReceive(msg: Inbox): void | Promise<void>;

package/dist/cluster/singleton/ClusterSingletonManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterSingletonManager.d.ts","sourceRoot":"","sources":["../../../src/cluster/singleton/ClusterSingletonManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAGD;;;;;GAKG;AACH,KAAK,YAAY,GACb;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,KAAK,GAAG,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,+BAA+B,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAuB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,KAAK,CAAC;aA0B9B,QAAQ,EAAE,+BAA+B,CAAC,CAAC,CAAC;IAzBxE,OAAO,CAAC,KAAK,CAA4B;IACzC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,UAAU,CAA4B;IAE9C,gEAAgE;IAChE,OAAO,CAAC,UAAU,CAAyC;IAE3D,mFAAmF;IACnF,cAAc,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAEf,QAAQ,EAAE,+BAA+B,CAAC,CAAC,CAAC;IAE/D,QAAQ,IAAI,IAAI;IAwCV,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,aAAa;IAWrB,iFAAiF;IACjF,OAAO,CAAC,aAAa;YAYP,eAAe;YA8Bf,UAAU;IAWxB,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,oBAAoB;CAO7B"}
+{"version":3,"file":"ClusterSingletonManager.d.ts","sourceRoot":"","sources":["../../../src/cluster/singleton/ClusterSingletonManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,8BAA8B,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AAG9H;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAGD;;;;;GAKG;AACH,KAAK,YAAY,GACb;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,KAAK,GAAG,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAuB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,KAAK,CAAC;IAC1D,OAAO,CAAC,KAAK,CAA4B;IACzC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,UAAU,CAA4B;IAE9C,gEAAgE;IAChE,OAAO,CAAC,UAAU,CAAyC;IAE3D,mFAAmF;IACnF,cAAc,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE3C,QAAQ,CAAC,QAAQ,EAAE,kCAAkC,CAAC,CAAC,CAAC,CAAC;gBAE7C,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC;IAK7C,QAAQ,IAAI,IAAI;IAwCV,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,aAAa;IAWrB,iFAAiF;IACjF,OAAO,CAAC,aAAa;YAYP,eAAe;YA8Bf,UAAU;IAWxB,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,oBAAoB;CAO7B"}

package/dist/cluster/singleton/ClusterSingletonManager.js

@@ -29,7 +29,6 @@ export function singletonManagerPath(systemName, typeName) {
  *   with an in-flight acquire.
  */
 export class ClusterSingletonManager extends Actor {
-    settings;
     child = null;
     /**
      * The previous child while it is mid-stop.  We watch every child we
@@ -52,9 +51,10 @@ export class ClusterSingletonManager extends Actor {
     leaseState = 'none';
     /** Callback the extension hands us so we can release the envelope path on stop. */
     _envelopeUnsub = null;
-    constructor(settings) {
+    settings;
+    constructor(options) {
         super();
-        this.settings = settings;
+        this.settings = options;
     }
     preStart() {
         const cluster = this.settings.cluster;

package/dist/cluster/singleton/ClusterSingletonManager.js.map

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

package/dist/cluster/singleton/ClusterSingletonManagerOptions.d.ts

@@ -0,0 +1,49 @@
+import type { Lease } from '../../coordination/Lease.js';
+import type { Props } from '../../Props.js';
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { Cluster } from '../Cluster.js';
+/** Plain settings-object shape consumed by a {@link ClusterSingletonManager}. */
+export interface ClusterSingletonManagerOptionsType<T> {
+    readonly cluster: Cluster;
+    /** Logical name for this singleton; also used as the child-actor name. */
+    readonly typeName: string;
+    /** How to construct the singleton actor.  Only instantiated on the leader. */
+    readonly singletonProps: Props<T>;
+    /** Optional role — only nodes with this role will host the singleton. */
+    readonly role?: string;
+    /** Optional split-brain protection — see {@link StartSingletonOptionsType.lease}. */
+    readonly lease?: Lease;
+    /** Retry interval for `lease.acquire()` after a failed attempt.  Default: 5 s. */
+    readonly acquireRetryIntervalMs?: number;
+}
+/**
+ * Fluent builder for {@link ClusterSingletonManagerOptionsType}.  The
+ * manager is constructed directly by the {@link ClusterSingleton}
+ * extension, so callers rarely build this by hand — but the builder
+ * keeps the construction API uniform with the rest of the cluster layer.
+ */
+export declare class ClusterSingletonManagerOptionsBuilder<T> extends OptionsBuilder<ClusterSingletonManagerOptionsType<T>> {
+    /** Start a fresh builder. */
+    static create<T>(): ClusterSingletonManagerOptionsBuilder<T>;
+    /** The cluster this manager lives in — drives membership + leadership. */
+    withCluster(cluster: Cluster): this;
+    /** Logical name for this singleton; also used as the child-actor name. */
+    withTypeName(typeName: string): this;
+    /** How to construct the singleton actor.  Only instantiated on the leader. */
+    withSingletonProps(props: Props<T>): this;
+    /** Only nodes carrying this role tag will host the singleton. */
+    withRole(role: string): this;
+    /** Split-brain protection — the leader acquires this lease before spawning. */
+    withLease(lease: Lease): this;
+    /** Retry interval (ms) for `lease.acquire()` after a failed attempt.  Default 5 s. */
+    withAcquireRetryIntervalMs(ms: number): this;
+}
+/**
+ * Accepted input for a {@link ClusterSingletonManager}: the fluent
+ * {@link ClusterSingletonManagerOptionsBuilder} OR a plain (partial)
+ * {@link ClusterSingletonManagerOptionsType} object.
+ */
+export type ClusterSingletonManagerOptions<T> = ClusterSingletonManagerOptionsBuilder<T> | Partial<ClusterSingletonManagerOptionsType<T>>;
+/** Value alias so `ClusterSingletonManagerOptions.create()` resolves to the builder. */
+export declare const ClusterSingletonManagerOptions: typeof ClusterSingletonManagerOptionsBuilder;
+//# sourceMappingURL=ClusterSingletonManagerOptions.d.ts.map

package/dist/cluster/singleton/ClusterSingletonManagerOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterSingletonManagerOptions.d.ts","sourceRoot":"","sources":["../../../src/cluster/singleton/ClusterSingletonManagerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,iFAAiF;AACjF,MAAM,WAAW,kCAAkC,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;;;;GAKG;AACH,qBAAa,qCAAqC,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,kCAAkC,CAAC,CAAC,CAAC,CAAC;IACjH,6BAA6B;IAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,qCAAqC,CAAC,CAAC,CAAC;IAI5D,0EAA0E;IAC1E,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,0EAA0E;IAC1E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,8EAA8E;IAC9E,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,+EAA+E;IAC/E,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI7B,sFAAsF;IACtF,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG7C;AAED;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,IACxC,qCAAqC,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,kCAAkC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,8CAAwC,CAAC"}

package/dist/cluster/singleton/ClusterSingletonManagerOptions.js

@@ -0,0 +1,40 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ClusterSingletonManagerOptionsType}.  The
+ * manager is constructed directly by the {@link ClusterSingleton}
+ * extension, so callers rarely build this by hand — but the builder
+ * keeps the construction API uniform with the rest of the cluster layer.
+ */
+export class ClusterSingletonManagerOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder. */
+    static create() {
+        return new ClusterSingletonManagerOptionsBuilder();
+    }
+    /** The cluster this manager lives in — drives membership + leadership. */
+    withCluster(cluster) {
+        return this.set('cluster', cluster);
+    }
+    /** Logical name for this singleton; also used as the child-actor name. */
+    withTypeName(typeName) {
+        return this.set('typeName', typeName);
+    }
+    /** How to construct the singleton actor.  Only instantiated on the leader. */
+    withSingletonProps(props) {
+        return this.set('singletonProps', props);
+    }
+    /** Only nodes carrying this role tag will host the singleton. */
+    withRole(role) {
+        return this.set('role', role);
+    }
+    /** Split-brain protection — the leader acquires this lease before spawning. */
+    withLease(lease) {
+        return this.set('lease', lease);
+    }
+    /** Retry interval (ms) for `lease.acquire()` after a failed attempt.  Default 5 s. */
+    withAcquireRetryIntervalMs(ms) {
+        return this.set('acquireRetryIntervalMs', ms);
+    }
+}
+/** Value alias so `ClusterSingletonManagerOptions.create()` resolves to the builder. */
+export const ClusterSingletonManagerOptions = ClusterSingletonManagerOptionsBuilder;
+//# sourceMappingURL=ClusterSingletonManagerOptions.js.map

package/dist/cluster/singleton/ClusterSingletonManagerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterSingletonManagerOptions.js","sourceRoot":"","sources":["../../../src/cluster/singleton/ClusterSingletonManagerOptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAkB9D;;;;;GAKG;AACH,MAAM,OAAO,qCAAyC,SAAQ,cAAqD;IACjH,6BAA6B;IAC7B,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,qCAAqC,EAAK,CAAC;IACxD,CAAC;IAED,0EAA0E;IAC1E,WAAW,CAAC,OAAgB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,0EAA0E;IAC1E,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,8EAA8E;IAC9E,kBAAkB,CAAC,KAAe;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,iEAAiE;IACjE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,+EAA+E;IAC/E,SAAS,CAAC,KAAY;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,sFAAsF;IACtF,0BAA0B,CAAC,EAAU;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;CACF;AAUD,wFAAwF;AACxF,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC"}

package/dist/cluster/singleton/StartSingletonOptions.d.ts

@@ -0,0 +1,64 @@
+import type { Lease } from '../../coordination/Lease.js';
+import type { Props } from '../../Props.js';
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/** Plain settings-object shape accepted by {@link ClusterSingleton.start}. */
+export interface StartSingletonOptionsType<T> {
+    /** Logical name for this singleton — used in the manager/child actor path. */
+    readonly typeName: string;
+    /** Props used to construct the singleton on the leader. */
+    readonly props: Props<T>;
+    /** If set, only nodes carrying this role tag will host the singleton. */
+    readonly role?: string;
+    /**
+     * Optional split-brain protection.  When provided, the elected
+     * leader's manager calls `lease.acquire()` before spawning the
+     * singleton — so a partition that produces two oldest views still
+     * only ever spawns the singleton on the side that holds the lease.
+     * The manager subscribes to `lease.onLost(reason)` and stops the
+     * child if ownership is revoked mid-flight.
+     *
+     * Without a lease the manager keeps its current sync behaviour:
+     * spawn the moment cluster gossip says we're leader, no external
+     * arbitration.
+     */
+    readonly lease?: Lease;
+    /**
+     * How often to retry `lease.acquire()` after a failed attempt
+     * (another holder owns it, transient backend error, etc.).
+     * Default: `5_000` ms.  Ignored if no lease is provided.
+     */
+    readonly acquireRetryIntervalMs?: number;
+}
+/**
+ * Fluent builder for {@link StartSingletonOptionsType}:
+ *
+ *     system.extension(ClusterSingletonId).start(
+ *       cluster,
+ *       StartSingletonOptions.create<Cmd>()
+ *         .withTypeName('counter')
+ *         .withProps(Props.create(() => new CounterActor())),
+ *     );
+ */
+export declare class StartSingletonOptionsBuilder<T> extends OptionsBuilder<StartSingletonOptionsType<T>> {
+    /** Start a fresh builder. */
+    static create<T>(): StartSingletonOptionsBuilder<T>;
+    /** Logical name for this singleton — used in the manager/child actor path. */
+    withTypeName(typeName: string): this;
+    /** Props used to construct the singleton on the leader. */
+    withProps(props: Props<T>): this;
+    /** Only nodes carrying this role tag will host the singleton. */
+    withRole(role: string): this;
+    /** Split-brain protection — the leader acquires this lease before spawning. */
+    withLease(lease: Lease): this;
+    /** Retry interval (ms) for `lease.acquire()` after a failed attempt.  Default 5 s. */
+    withAcquireRetryIntervalMs(ms: number): this;
+}
+/**
+ * Accepted input for {@link ClusterSingleton.start}: the fluent
+ * {@link StartSingletonOptionsBuilder} OR a plain (partial)
+ * {@link StartSingletonOptionsType} object.
+ */
+export type StartSingletonOptions<T> = StartSingletonOptionsBuilder<T> | Partial<StartSingletonOptionsType<T>>;
+/** Value alias so `StartSingletonOptions.create()` / `new StartSingletonOptions()` resolve to the builder. */
+export declare const StartSingletonOptions: typeof StartSingletonOptionsBuilder;
+//# sourceMappingURL=StartSingletonOptions.d.ts.map

package/dist/cluster/singleton/StartSingletonOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartSingletonOptions.d.ts","sourceRoot":"","sources":["../../../src/cluster/singleton/StartSingletonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,qBAAa,4BAA4B,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAC/F,6BAA6B;IAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,4BAA4B,CAAC,CAAC,CAAC;IAInD,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,2DAA2D;IAC3D,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAIhC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,+EAA+E;IAC/E,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI7B,sFAAsF;IACtF,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG7C;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAC/B,4BAA4B,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,8GAA8G;AAC9G,eAAO,MAAM,qBAAqB,qCAA+B,CAAC"}

package/dist/cluster/singleton/StartSingletonOptions.js

@@ -0,0 +1,40 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link StartSingletonOptionsType}:
+ *
+ *     system.extension(ClusterSingletonId).start(
+ *       cluster,
+ *       StartSingletonOptions.create<Cmd>()
+ *         .withTypeName('counter')
+ *         .withProps(Props.create(() => new CounterActor())),
+ *     );
+ */
+export class StartSingletonOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder. */
+    static create() {
+        return new StartSingletonOptionsBuilder();
+    }
+    /** Logical name for this singleton — used in the manager/child actor path. */
+    withTypeName(typeName) {
+        return this.set('typeName', typeName);
+    }
+    /** Props used to construct the singleton on the leader. */
+    withProps(props) {
+        return this.set('props', props);
+    }
+    /** Only nodes carrying this role tag will host the singleton. */
+    withRole(role) {
+        return this.set('role', role);
+    }
+    /** Split-brain protection — the leader acquires this lease before spawning. */
+    withLease(lease) {
+        return this.set('lease', lease);
+    }
+    /** Retry interval (ms) for `lease.acquire()` after a failed attempt.  Default 5 s. */
+    withAcquireRetryIntervalMs(ms) {
+        return this.set('acquireRetryIntervalMs', ms);
+    }
+}
+/** Value alias so `StartSingletonOptions.create()` / `new StartSingletonOptions()` resolve to the builder. */
+export const StartSingletonOptions = StartSingletonOptionsBuilder;
+//# sourceMappingURL=StartSingletonOptions.js.map

package/dist/cluster/singleton/StartSingletonOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartSingletonOptions.js","sourceRoot":"","sources":["../../../src/cluster/singleton/StartSingletonOptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA+B9D;;;;;;;;;GASG;AACH,MAAM,OAAO,4BAAgC,SAAQ,cAA4C;IAC/F,6BAA6B;IAC7B,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,4BAA4B,EAAK,CAAC;IAC/C,CAAC;IAED,8EAA8E;IAC9E,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,2DAA2D;IAC3D,SAAS,CAAC,KAAe;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,iEAAiE;IACjE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,+EAA+E;IAC/E,SAAS,CAAC,KAAY;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,sFAAsF;IACtF,0BAA0B,CAAC,EAAU;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;CACF;AAUD,8GAA8G;AAC9G,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC"}

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

@@ -1,6 +1,10 @@
 export { ClusterSingleton, ClusterSingletonId, } from './ClusterSingleton.js';
-export type { StartSingletonSettings, SingletonHandle, } from './ClusterSingleton.js';
+export { StartSingletonOptions, StartSingletonOptionsBuilder } from './StartSingletonOptions.js';
+export type { StartSingletonOptionsType } from './StartSingletonOptions.js';
+export type { SingletonHandle } from './ClusterSingleton.js';
 export { ClusterSingletonManager, singletonManagerPath, } from './ClusterSingletonManager.js';
-export type { ClusterSingletonManagerSettings, SingletonDeliver, } from './ClusterSingletonManager.js';
+export { ClusterSingletonManagerOptions, ClusterSingletonManagerOptionsBuilder } from './ClusterSingletonManagerOptions.js';
+export type { ClusterSingletonManagerOptionsType } from './ClusterSingletonManagerOptions.js';
+export type { SingletonDeliver } from './ClusterSingletonManager.js';
 export { ClusterSingletonProxy } from './ClusterSingletonProxy.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cluster/singleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,sBAAsB,EACtB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cluster/singleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACjG,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,8BAA8B,EAAE,qCAAqC,EAAE,MAAM,qCAAqC,CAAC;AAC5H,YAAY,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AAC9F,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/cluster/singleton/index.js

@@ -1,4 +1,6 @@
 export { ClusterSingleton, ClusterSingletonId, } from './ClusterSingleton.js';
+export { StartSingletonOptions, StartSingletonOptionsBuilder } from './StartSingletonOptions.js';
 export { ClusterSingletonManager, singletonManagerPath, } from './ClusterSingletonManager.js';
+export { ClusterSingletonManagerOptions, ClusterSingletonManagerOptionsBuilder } from './ClusterSingletonManagerOptions.js';
 export { ClusterSingletonProxy } from './ClusterSingletonProxy.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cluster/singleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cluster/singleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAGjG,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,8BAA8B,EAAE,qCAAqC,EAAE,MAAM,qCAAqC,CAAC;AAG5H,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/config/ConfigKeys.d.ts

@@ -58,6 +58,11 @@ export declare const ConfigKeys: {
             readonly websocket: "actor-ts.io.broker.websocket";
         };
     };
+    /** HTTP subsystem config roots — `actor-ts.http.*`. */
+    readonly http: {
+        /** Server-side WebSocket defaults for `websocket()` routes. */
+        readonly websocket: "actor-ts.http.websocket";
+    };
     /** Persistence plugin selection + config — `actor-ts.persistence.*`. */
     readonly persistence: {
         readonly journal: {

package/dist/config/ConfigKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigKeys.d.ts","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,UAAU;IACrB,yCAAyC;;;;IAKzC,iDAAiD;;;;;IAMjD,6CAA6C;;;;;;IAO7C,uDAAuD;;;;;;;;;;;;;;;;;;;IAoBvD,wEAAwE;;;;;;;;;;;;;;;;;IAkBxE,qDAAqD;;IAGrD;;;;;;OAMG;;;;;;;CAOK,CAAC"}
+{"version":3,"file":"ConfigKeys.d.ts","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,UAAU;IACrB,yCAAyC;;;;IAKzC,iDAAiD;;;;;IAMjD,6CAA6C;;;;;;IAO7C,uDAAuD;;;;;;;;;;;;;;;;;;;IAoBvD,uDAAuD;;QAErD,+DAA+D;;;IAIjE,wEAAwE;;;;;;;;;;;;;;;;;IAkBxE,qDAAqD;;IAGrD;;;;;;OAMG;;;;;;;CAOK,CAAC"}

package/dist/config/ConfigKeys.js

@@ -58,6 +58,11 @@ export const ConfigKeys = {
             websocket: 'actor-ts.io.broker.websocket',
         },
     },
+    /** HTTP subsystem config roots — `actor-ts.http.*`. */
+    http: {
+        /** Server-side WebSocket defaults for `websocket()` routes. */
+        websocket: 'actor-ts.http.websocket',
+    },
     /** Persistence plugin selection + config — `actor-ts.persistence.*`. */
     persistence: {
         journal: {

package/dist/config/ConfigKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigKeys.js","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,yCAAyC;IACzC,MAAM,EAAE;QACN,KAAK,EAAE,uBAAuB;KAC/B;IAED,iDAAiD;IACjD,UAAU,EAAE;QACV,OAAO,EAAE,6BAA6B;QACtC,UAAU,EAAE,gCAAgC;KAC7C;IAED,6CAA6C;IAC7C,KAAK,EAAE;QACL,QAAQ,EAAE,0BAA0B;QACpC,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,0BAA0B;KACtC;IAED,uDAAuD;IACvD,EAAE,EAAE;QACF,MAAM,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE;gBACJ,MAAM,EAAE,gCAAgC;gBACxC,MAAM,EAAE,gCAAgC;aACzC;YACD,SAAS,EAAE,8BAA8B;YACzC,KAAK,EAAE,0BAA0B;YACjC,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,yBAAyB;YAC/B,YAAY,EAAE,kCAAkC;YAChD,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,wBAAwB;YAC7B,SAAS,EAAE,8BAA8B;SAC1C;KACF;IAED,wEAAwE;IACxE,WAAW,EAAE;QACX,OAAO,EAAE;YACP,MAAM,EAAE,qCAAqC;YAC7C,QAAQ,EAAE,wCAAwC;YAClD,SAAS,EAAE,wCAAwC;SACpD;QACD,aAAa,EAAE;YACb,MAAM,EAAE,4CAA4C;YACpD,QAAQ,EAAE,+CAA+C;YACzD,SAAS,EAAE,+CAA+C;YAC1D,aAAa,EAAE,oDAAoD;SACpE;QACD,YAAY,EAAE;YACZ,aAAa,EAAE,mDAAmD;SACnE;KACF;IAED,qDAAqD;IACrD,SAAS,EAAE,oBAAoB;IAE/B;;;;;;OAMG;IACH,MAAM,EAAE;QACN,KAAK,EAAM,cAAc;QACzB,IAAI,EAAO,aAAa;QACxB,KAAK,EAAM,cAAc;QACzB,SAAS,EAAE,kBAAkB;KAC9B;CACO,CAAC"}
+{"version":3,"file":"ConfigKeys.js","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,yCAAyC;IACzC,MAAM,EAAE;QACN,KAAK,EAAE,uBAAuB;KAC/B;IAED,iDAAiD;IACjD,UAAU,EAAE;QACV,OAAO,EAAE,6BAA6B;QACtC,UAAU,EAAE,gCAAgC;KAC7C;IAED,6CAA6C;IAC7C,KAAK,EAAE;QACL,QAAQ,EAAE,0BAA0B;QACpC,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,0BAA0B;KACtC;IAED,uDAAuD;IACvD,EAAE,EAAE;QACF,MAAM,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE;gBACJ,MAAM,EAAE,gCAAgC;gBACxC,MAAM,EAAE,gCAAgC;aACzC;YACD,SAAS,EAAE,8BAA8B;YACzC,KAAK,EAAE,0BAA0B;YACjC,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,yBAAyB;YAC/B,YAAY,EAAE,kCAAkC;YAChD,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,wBAAwB;YAC7B,SAAS,EAAE,8BAA8B;SAC1C;KACF;IAED,uDAAuD;IACvD,IAAI,EAAE;QACJ,+DAA+D;QAC/D,SAAS,EAAE,yBAAyB;KACrC;IAED,wEAAwE;IACxE,WAAW,EAAE;QACX,OAAO,EAAE;YACP,MAAM,EAAE,qCAAqC;YAC7C,QAAQ,EAAE,wCAAwC;YAClD,SAAS,EAAE,wCAAwC;SACpD;QACD,aAAa,EAAE;YACb,MAAM,EAAE,4CAA4C;YACpD,QAAQ,EAAE,+CAA+C;YACzD,SAAS,EAAE,+CAA+C;YAC1D,aAAa,EAAE,oDAAoD;SACpE;QACD,YAAY,EAAE;YACZ,aAAa,EAAE,mDAAmD;SACnE;KACF;IAED,qDAAqD;IACrD,SAAS,EAAE,oBAAoB;IAE/B;;;;;;OAMG;IACH,MAAM,EAAE;QACN,KAAK,EAAM,cAAc;QACzB,IAAI,EAAO,aAAa;QACxB,KAAK,EAAM,cAAc;QACzB,SAAS,EAAE,kBAAkB;KAC9B;CACO,CAAC"}

package/dist/coordination/Lease.d.ts

@@ -12,10 +12,42 @@
  *
  * Different backends implement the contract differently — see
  * `InMemoryLease` (reference + tests) and `KubernetesLease` (production).
+ *
+ * Backends MAY additionally implement `acquireWithToken()` for fencing-
+ * token support — see the method comment below.  Consumers that need
+ * fencing (e.g. `LeaseMajority` split-brain protection) feature-detect
+ * the method and fall back to plain `acquire()` when it's absent.
  */
 export interface Lease {
     /** Try to acquire the lease.  Resolves true on success, false on contention. */
     acquire(): Promise<boolean>;
+    /**
+     * Optional: acquire the lease and return a backend-issued **fencing
+     * token** on success.  Returns `null` on contention (semantic
+     * equivalent of `acquire()` returning `false`).
+     *
+     * A fencing token is a value that an external observer can use to
+     * order two acquires against the same lease — typically backed by the
+     * coordination service's own optimistic-concurrency primitive
+     * (Kubernetes Lease's `resourceVersion` + `leaseTransitions`, Redis
+     * `SETNX` with an incrementing counter, etcd `revision`, etc.).
+     *
+     * Why both methods exist: `acquire()` is sufficient for the common
+     * "did I win the race?" question, and is the minimum contract every
+     * backend must implement.  `acquireWithToken()` is for callers that
+     * also need to **detect a stale acquire result**.  Without a token,
+     * a late-arriving `acquire() → true` from a previously-timed-out
+     * attempt is indistinguishable from a fresh successful acquire; with
+     * a token, the caller compares the token against the current holder
+     * to decide whether the result still reflects reality.
+     *
+     * Tokens are opaque strings — comparison must be exact-string.
+     * Backends should choose a representation that's monotonic per
+     * acquire (so callers can detect "newer acquire happened after mine").
+     */
+    acquireWithToken?(): Promise<{
+        readonly token: string;
+    } | null>;
     /** Release the lease voluntarily.  No-op if not held. */
     release(): Promise<void>;
     /** True if this process currently owns the lease.  Purely local — no IO. */
@@ -23,18 +55,4 @@ export interface Lease {
     /** Register a handler fired when ownership is lost unexpectedly. */
     onLost(handler: (reason: string) => void): () => void;
 }
-export interface LeaseSettings {
-    /** Lease name — unique identifier within the namespace. */
-    readonly name: string;
-    /** Identifier of the holder (pod name / host name / uuid). */
-    readonly owner: string;
-    /** Time-to-live in ms — the backend auto-expires if we fail to renew. */
-    readonly ttlMs: number;
-    /** How often to renew (< ttlMs — typically ttl/3). */
-    readonly renewalIntervalMs?: number;
-    /** Max attempts for a single `acquire()` before returning false. */
-    readonly acquireRetries?: number;
-    /** Delay between acquire retries. */
-    readonly acquireRetryDelayMs?: number;
-}
 //# sourceMappingURL=Lease.d.ts.map

package/dist/coordination/Lease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Lease.d.ts","sourceRoot":"","sources":["../../src/coordination/Lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5B,yDAAyD;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,4EAA4E;IAC5E,UAAU,IAAI,OAAO,CAAC;IAEtB,oEAAoE;IACpE,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qCAAqC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC"}
+{"version":3,"file":"Lease.d.ts","sourceRoot":"","sources":["../../src/coordination/Lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAEhE,yDAAyD;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,4EAA4E;IAC5E,UAAU,IAAI,OAAO,CAAC;IAEtB,oEAAoE;IACpE,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvD"}

package/dist/coordination/LeaseOptions.d.ts

@@ -0,0 +1,61 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Plain settings-object shape shared by every {@link Lease} backend — the
+ * common construction-time settings.  A plain object of these fields is an
+ * accepted alternative to the {@link LeaseOptionsBuilder}; concrete backends
+ * extend it (e.g. `KubernetesLeaseOptionsType`).
+ */
+export interface LeaseOptionsType {
+    /** Lease name — unique identifier within the namespace. */
+    readonly name: string;
+    /** Identifier of the holder (pod name / host name / uuid). */
+    readonly owner: string;
+    /** Time-to-live in ms — the backend auto-expires if we fail to renew. */
+    readonly ttlMs: number;
+    /** How often to renew (< ttlMs — typically ttl/3). */
+    readonly renewalIntervalMs?: number;
+    /** Max attempts for a single `acquire()` before returning false. */
+    readonly acquireRetries?: number;
+    /** Delay between acquire retries. */
+    readonly acquireRetryDelayMs?: number;
+}
+/**
+ * Fluent builder for {@link LeaseOptionsType} — the common construction-time
+ * settings every {@link Lease} backend shares.  The concrete
+ * `KubernetesLeaseOptionsBuilder` subclass extends this with the K8s-specific
+ * `withX(...)` methods.
+ *
+ *     new InMemoryLease(
+ *       LeaseOptions.create().withName('singleton').withOwner(nodeId).withTtlMs(10_000),
+ *     );
+ *
+ * Generic over `T extends LeaseOptionsType` so `KubernetesLeaseOptionsBuilder`
+ * can inherit these six setters while adding its own — same shape as the
+ * broker `BrokerOptionsBuilder<T>` base.  The `as keyof T` casts pay for
+ * writing the shared setters once against the generic; concrete subclasses
+ * stay type-safe because their extra methods target concrete field types.
+ */
+export declare class LeaseOptionsBuilder<T extends LeaseOptionsType = LeaseOptionsType> extends OptionsBuilder<T> {
+    /** Start a fresh builder.  Equivalent to `new LeaseOptionsBuilder()`. */
+    static create(): LeaseOptionsBuilder;
+    /** Lease name — unique identifier within the namespace. */
+    withName(name: string): this;
+    /** Identifier of the holder (pod name / host name / uuid). */
+    withOwner(owner: string): this;
+    /** Time-to-live in ms — the backend auto-expires if we fail to renew. */
+    withTtlMs(ttlMs: number): this;
+    /** How often to renew (< ttlMs — typically ttl/3). */
+    withRenewalIntervalMs(renewalIntervalMs: number): this;
+    /** Max attempts for a single `acquire()` before returning false. */
+    withAcquireRetries(acquireRetries: number): this;
+    /** Delay between acquire retries. */
+    withAcquireRetryDelayMs(acquireRetryDelayMs: number): this;
+}
+/**
+ * Accepted input for any lease constructor: the fluent
+ * {@link LeaseOptionsBuilder} OR a plain {@link LeaseOptionsType} object.
+ */
+export type LeaseOptions = LeaseOptionsBuilder | Partial<LeaseOptionsType>;
+/** Value alias so `LeaseOptions.create()` / `new LeaseOptions()` resolve to the builder. */
+export declare const LeaseOptions: typeof LeaseOptionsBuilder;
+//# sourceMappingURL=LeaseOptions.d.ts.map

package/dist/coordination/LeaseOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeaseOptions.d.ts","sourceRoot":"","sources":["../../src/coordination/LeaseOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qCAAqC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACvG,yEAAyE;IACzE,MAAM,CAAC,MAAM,IAAI,mBAAmB;IAIpC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,8DAA8D;IAC9D,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,yEAAyE;IACzE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,sDAAsD;IACtD,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAItD,oEAAoE;IACpE,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIhD,qCAAqC;IACrC,uBAAuB,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI;CAG3D;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAC3E,4FAA4F;AAC5F,eAAO,MAAM,YAAY,4BAAsB,CAAC"}