actor-ts 0.9.0

package/dist/config/reference.js

@@ -0,0 +1,86 @@
+/**
+ * Bundled default configuration — the `reference.conf` values every
+ * feature module expects to see.  Shipped as a HOCON string constant so
+ * there is no asset-copying step during `bun run build`.
+ *
+ * Users override these values by:
+ *   - writing an `application.conf` file (HOCON or JSON), or
+ *   - passing `{ config: { ... } }` to `ActorSystem.create`.
+ */
+export const REFERENCE_CONF = `
+actor-ts {
+  system {
+    name = "default"
+  }
+
+  logger {
+    level = "info"   # debug | info | warn | error | off
+  }
+
+  dispatcher {
+    default = "immediate"   # immediate | microtask | throughput
+    throughput = 16
+  }
+
+  cluster {
+    gossip-interval = 1s
+    seed-retry-interval = 3s
+    leader-election = "lowest-address"
+
+    failure-detector {
+      heartbeat-interval = 500ms
+      unreachable-after = 2s
+      down-after = 5s
+    }
+  }
+
+  remote {
+    transport = "tcp"
+    tcp {
+      hostname = "0.0.0.0"
+      port = 2552
+    }
+    tls {
+      enabled = false
+    }
+    max-frame-size = 1M
+  }
+
+  http {
+    backend = "fastify"   # fastify | bun | express
+    shutdown-grace-period = 5s
+  }
+
+  persistence {
+    journal {
+      plugin = "actor-ts.persistence.journal.in-memory"
+    }
+    snapshot-store {
+      plugin = "actor-ts.persistence.snapshot-store.in-memory"
+    }
+    recovery {
+      mode = "eager"    # eager | parallel
+    }
+  }
+
+  sharding {
+    number-of-shards = 64
+    rebalance-interval = 2s
+    hand-off-timeout = 10s
+    remember-entities = false
+    passivation-idle = 0ms
+  }
+
+  worker {
+    count = "auto"   # "auto" uses navigator.hardwareConcurrency
+    restart-policy = "on-failure"   # always | on-failure | never
+  }
+
+  coordinated-shutdown {
+    default-phase-timeout = 5s
+    terminate-actor-system = true
+    exit-jvm = false   # node-level: whether to call process.exit
+  }
+}
+`.trim();
+//# sourceMappingURL=reference.js.map

package/dist/config/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/config/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2E7B,CAAC,IAAI,EAAE,CAAC"}

package/dist/coordination/Lease.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Abstract distributed lease.  A lease is owned by a single holder for a
+ * bounded duration; renewed periodically by the holder to keep ownership.
+ *
+ * Four-method contract:
+ *   - `acquire()` tries to claim the lease; returns true on success.
+ *   - `release()` voluntarily drops ownership.
+ *   - `checkAlive()` is a cheap "do I still own this lease?" check used by
+ *     failure-detection logic.
+ *   - `onLost(cb)` registers a callback fired if ownership is lost
+ *     unexpectedly (TTL expired, another holder took over, etc.).
+ *
+ * Different backends implement the contract differently — see
+ * `InMemoryLease` (reference + tests) and `KubernetesLease` (production).
+ */
+export interface Lease {
+    /** Try to acquire the lease.  Resolves true on success, false on contention. */
+    acquire(): Promise<boolean>;
+    /** Release the lease voluntarily.  No-op if not held. */
+    release(): Promise<void>;
+    /** True if this process currently owns the lease.  Purely local — no IO. */
+    checkAlive(): boolean;
+    /** 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

@@ -0,0 +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"}

package/dist/coordination/Lease.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Lease.js.map

package/dist/coordination/Lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lease.js","sourceRoot":"","sources":["../../src/coordination/Lease.ts"],"names":[],"mappings":""}

package/dist/coordination/index.d.ts

@@ -0,0 +1,5 @@
+export type { Lease, LeaseSettings } from './Lease.js';
+export { InMemoryLease, inMemoryLeaseStore } from './leases/InMemoryLease.js';
+export { KubernetesLease } from './leases/KubernetesLease.js';
+export type { KubernetesLeaseSettings } from './leases/KubernetesLease.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/coordination/index.js

@@ -0,0 +1,3 @@
+export { InMemoryLease, inMemoryLeaseStore } from './leases/InMemoryLease.js';
+export { KubernetesLease } from './leases/KubernetesLease.js';
+//# sourceMappingURL=index.js.map

package/dist/coordination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/coordination/leases/InMemoryLease.d.ts

@@ -0,0 +1,40 @@
+import type { Lease, LeaseSettings } from '../Lease.js';
+interface LeaseRecord {
+    readonly name: string;
+    owner: string;
+    expiresAt: number;
+}
+/** Global registry shared by all InMemoryLeases in the process — simulates a remote store. */
+declare class InMemoryLeaseStore {
+    private readonly leases;
+    /** Try to take the lease named `name` for `owner` until `expiresAt`. */
+    tryAcquire(name: string, owner: string, expiresAt: number): boolean;
+    renew(name: string, owner: string, expiresAt: number): boolean;
+    release(name: string, owner: string): void;
+    peek(name: string): LeaseRecord | undefined;
+    /** Reset — only for tests. */
+    _clear(): void;
+}
+/** Singleton store — all in-process InMemoryLeases compete against it. */
+export declare const inMemoryLeaseStore: InMemoryLeaseStore;
+/**
+ * Reference Lease implementation backed by the shared in-memory store.
+ * Useful for tests and single-process development.  The store is a plain
+ * JS Map, so it is NOT appropriate for multi-process deployments — use
+ * `KubernetesLease` for that.
+ */
+export declare class InMemoryLease implements Lease {
+    private readonly settings;
+    private readonly renewalIntervalMs;
+    private renewalTimer;
+    private held;
+    private readonly onLostHandlers;
+    constructor(settings: LeaseSettings);
+    acquire(): Promise<boolean>;
+    release(): Promise<void>;
+    checkAlive(): boolean;
+    onLost(handler: (reason: string) => void): () => void;
+    private startRenewalLoop;
+}
+export {};
+//# sourceMappingURL=InMemoryLease.d.ts.map

package/dist/coordination/leases/InMemoryLease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryLease.d.ts","sourceRoot":"","sources":["../../../src/coordination/leases/InMemoryLease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExD,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8FAA8F;AAC9F,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD,wEAAwE;IACxE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAQnE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAO9D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAM3C,8BAA8B;IAC9B,MAAM,IAAI,IAAI;CACf;AAED,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,oBAA2B,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,KAAK;IAM7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;gBAEzC,QAAQ,EAAE,aAAa;IAI9C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAe3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,UAAU,IAAI,OAAO;IAErB,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKrD,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/coordination/leases/InMemoryLease.js

@@ -0,0 +1,109 @@
+/** Global registry shared by all InMemoryLeases in the process — simulates a remote store. */
+class InMemoryLeaseStore {
+    leases = new Map();
+    /** Try to take the lease named `name` for `owner` until `expiresAt`. */
+    tryAcquire(name, owner, expiresAt) {
+        const now = Date.now();
+        const existing = this.leases.get(name);
+        if (existing && existing.owner !== owner && existing.expiresAt > now)
+            return false;
+        this.leases.set(name, { name, owner, expiresAt });
+        return true;
+    }
+    renew(name, owner, expiresAt) {
+        const existing = this.leases.get(name);
+        if (!existing || existing.owner !== owner)
+            return false;
+        existing.expiresAt = expiresAt;
+        return true;
+    }
+    release(name, owner) {
+        const existing = this.leases.get(name);
+        if (existing && existing.owner === owner)
+            this.leases.delete(name);
+    }
+    peek(name) {
+        const r = this.leases.get(name);
+        if (r && r.expiresAt <= Date.now()) {
+            this.leases.delete(name);
+            return undefined;
+        }
+        return r;
+    }
+    /** Reset — only for tests. */
+    _clear() { this.leases.clear(); }
+}
+/** Singleton store — all in-process InMemoryLeases compete against it. */
+export const inMemoryLeaseStore = new InMemoryLeaseStore();
+/**
+ * Reference Lease implementation backed by the shared in-memory store.
+ * Useful for tests and single-process development.  The store is a plain
+ * JS Map, so it is NOT appropriate for multi-process deployments — use
+ * `KubernetesLease` for that.
+ */
+export class InMemoryLease {
+    settings;
+    renewalIntervalMs;
+    renewalTimer = null;
+    held = false;
+    onLostHandlers = new Set();
+    constructor(settings) {
+        this.settings = settings;
+        this.renewalIntervalMs = settings.renewalIntervalMs ?? Math.max(100, Math.floor(settings.ttlMs / 3));
+    }
+    async acquire() {
+        const retries = this.settings.acquireRetries ?? 1;
+        const delay = this.settings.acquireRetryDelayMs ?? 50;
+        for (let i = 0; i < retries; i++) {
+            const expiresAt = Date.now() + this.settings.ttlMs;
+            if (inMemoryLeaseStore.tryAcquire(this.settings.name, this.settings.owner, expiresAt)) {
+                this.held = true;
+                this.startRenewalLoop();
+                return true;
+            }
+            if (i < retries - 1)
+                await sleep(delay);
+        }
+        return false;
+    }
+    async release() {
+        if (!this.held)
+            return;
+        this.held = false;
+        if (this.renewalTimer) {
+            clearInterval(this.renewalTimer);
+            this.renewalTimer = null;
+        }
+        inMemoryLeaseStore.release(this.settings.name, this.settings.owner);
+    }
+    checkAlive() { return this.held; }
+    onLost(handler) {
+        this.onLostHandlers.add(handler);
+        return () => this.onLostHandlers.delete(handler);
+    }
+    startRenewalLoop() {
+        this.renewalTimer = setInterval(() => {
+            if (!this.held)
+                return;
+            const expiresAt = Date.now() + this.settings.ttlMs;
+            const ok = inMemoryLeaseStore.renew(this.settings.name, this.settings.owner, expiresAt);
+            if (!ok) {
+                this.held = false;
+                if (this.renewalTimer) {
+                    clearInterval(this.renewalTimer);
+                    this.renewalTimer = null;
+                }
+                for (const h of this.onLostHandlers) {
+                    try {
+                        h('lease lost during renewal');
+                    }
+                    catch { /* swallow */ }
+                }
+            }
+        }, this.renewalIntervalMs);
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=InMemoryLease.js.map

package/dist/coordination/leases/InMemoryLease.js.map

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

package/dist/coordination/leases/KubernetesLease.d.ts

@@ -0,0 +1,78 @@
+import type { Lease, LeaseSettings } from '../Lease.js';
+import { type K8sFetchClient } from './k8sApi.js';
+/**
+ * K8s-specific additions to the common lease settings.  When `apiServerUrl`,
+ * `authToken`, or `caCert` are omitted the adapter probes the standard
+ * ServiceAccount mount points (`/var/run/secrets/kubernetes.io/...`).
+ *
+ * `client` is a test seam — pass a fake `K8sFetchClient` to drive the
+ * lease without a real API server.
+ */
+export interface KubernetesLeaseSettings extends LeaseSettings {
+    /** Kubernetes namespace that owns the `coordination.k8s.io/v1/Lease` object. */
+    readonly namespace: string;
+    /** API-server URL.  Defaults to the in-cluster service or `https://kubernetes.default.svc`. */
+    readonly apiServerUrl?: string;
+    /** Bearer token for the ServiceAccount.  Reads `/var/run/...` if omitted. */
+    readonly authToken?: string;
+    /** PEM-encoded CA cert for the API server.  Reads `/var/run/...` if omitted. */
+    readonly caCert?: string;
+    /** Test seam — inject a fake fetch client. */
+    readonly client?: K8sFetchClient;
+}
+/**
+ * Lease backed by a Kubernetes `coordination.k8s.io/v1/Lease` object.
+ * Self-contained — speaks the K8s REST API directly, no client-library
+ * dependency.  Designed for use behind `ClusterSingleton` so split-brain
+ * is impossible: at most one Pod can hold the lease at a time, K8s
+ * arbitrates via optimistic concurrency control.
+ *
+ * Lifecycle:
+ *
+ *   1. **acquire()** — GET the lease object.  If it doesn't exist, CREATE
+ *      it with `holderIdentity = settings.owner`.  If it does exist and
+ *      either it's already ours or the previous holder's `renewTime + ttl`
+ *      has passed, PUT a new spec with our owner + a fresh
+ *      `acquireTime` / `renewTime`.  Returns true on success, false on a
+ *      live conflict.  Optimistic-write 409 conflicts are retried up to
+ *      `acquireRetries` times.
+ *
+ *   2. **renewal loop** — every `renewalIntervalMs` (default `ttl/3`),
+ *      GET + PUT to bump `renewTime`.  A 409 / 404 / network error here
+ *      is treated as 'lease lost' and fires `onLost(reason)`.
+ *
+ *   3. **release()** — DELETE the lease (404 is treated as success).
+ *      Cancels the renewal timer.
+ *
+ * Failure modes that fire `onLost`:
+ *   - PUT during renewal returns 409 (someone else won a race after we
+ *     read the resourceVersion).
+ *   - PUT during renewal returns 404 (someone deleted the lease).
+ *   - Network error during renewal that the renewal-loop's retry budget
+ *     can't absorb.
+ *   - The K8s API server is unreachable for longer than `ttlMs`.
+ */
+export declare class KubernetesLease implements Lease {
+    private readonly settings;
+    private readonly renewalIntervalMs;
+    private renewalTimer;
+    private held;
+    private currentLease;
+    private readonly onLostHandlers;
+    private creds;
+    constructor(settings: KubernetesLeaseSettings);
+    /** Resolve credentials lazily — once on first call, cached after. */
+    private getCreds;
+    acquire(): Promise<boolean>;
+    /** One pass of GET → CREATE-or-PUT.  Three outcomes: success / held-by-other / race. */
+    private tryAcquireOnce;
+    /** True iff the existing lease has a different live holder. */
+    private isStillHeldByOther;
+    release(): Promise<void>;
+    checkAlive(): boolean;
+    onLost(handler: (reason: string) => void): () => void;
+    private startRenewalLoop;
+    private renewOnce;
+    private fireLost;
+}
+//# sourceMappingURL=KubernetesLease.d.ts.map

package/dist/coordination/leases/KubernetesLease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KubernetesLease.d.ts","sourceRoot":"","sources":["../../../src/coordination/leases/KubernetesLease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAQL,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,eAAgB,YAAW,KAAK;IAQ/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAPrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,KAAK,CAA+B;gBAEf,QAAQ,EAAE,uBAAuB;IAK9D,qEAAqE;YACvD,QAAQ;IA2BhB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAcjC,wFAAwF;YAC1E,cAAc;IAkD5B,+DAA+D;IAC/D,OAAO,CAAC,kBAAkB;IAWpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B,UAAU,IAAI,OAAO;IAErB,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOrD,OAAO,CAAC,gBAAgB;YAOV,SAAS;IAmCvB,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/coordination/leases/KubernetesLease.js

@@ -0,0 +1,244 @@
+import { createLease, deleteLease, getLease, K8sLeaseError, loadInClusterCredentials, updateLease, } from './k8sApi.js';
+/**
+ * Lease backed by a Kubernetes `coordination.k8s.io/v1/Lease` object.
+ * Self-contained — speaks the K8s REST API directly, no client-library
+ * dependency.  Designed for use behind `ClusterSingleton` so split-brain
+ * is impossible: at most one Pod can hold the lease at a time, K8s
+ * arbitrates via optimistic concurrency control.
+ *
+ * Lifecycle:
+ *
+ *   1. **acquire()** — GET the lease object.  If it doesn't exist, CREATE
+ *      it with `holderIdentity = settings.owner`.  If it does exist and
+ *      either it's already ours or the previous holder's `renewTime + ttl`
+ *      has passed, PUT a new spec with our owner + a fresh
+ *      `acquireTime` / `renewTime`.  Returns true on success, false on a
+ *      live conflict.  Optimistic-write 409 conflicts are retried up to
+ *      `acquireRetries` times.
+ *
+ *   2. **renewal loop** — every `renewalIntervalMs` (default `ttl/3`),
+ *      GET + PUT to bump `renewTime`.  A 409 / 404 / network error here
+ *      is treated as 'lease lost' and fires `onLost(reason)`.
+ *
+ *   3. **release()** — DELETE the lease (404 is treated as success).
+ *      Cancels the renewal timer.
+ *
+ * Failure modes that fire `onLost`:
+ *   - PUT during renewal returns 409 (someone else won a race after we
+ *     read the resourceVersion).
+ *   - PUT during renewal returns 404 (someone deleted the lease).
+ *   - Network error during renewal that the renewal-loop's retry budget
+ *     can't absorb.
+ *   - The K8s API server is unreachable for longer than `ttlMs`.
+ */
+export class KubernetesLease {
+    settings;
+    renewalIntervalMs;
+    renewalTimer = null;
+    held = false;
+    currentLease = null;
+    onLostHandlers = new Set();
+    creds = null;
+    constructor(settings) {
+        this.settings = settings;
+        this.renewalIntervalMs = settings.renewalIntervalMs
+            ?? Math.max(500, Math.floor(settings.ttlMs / 3));
+    }
+    /** Resolve credentials lazily — once on first call, cached after. */
+    async getCreds() {
+        if (this.creds)
+            return this.creds;
+        if (this.settings.apiServerUrl && this.settings.authToken && this.settings.caCert) {
+            this.creds = {
+                apiServerUrl: this.settings.apiServerUrl,
+                authToken: this.settings.authToken,
+                caCert: this.settings.caCert,
+            };
+            return this.creds;
+        }
+        const inCluster = await loadInClusterCredentials();
+        if (!inCluster) {
+            throw new Error('KubernetesLease: no credentials available.  Either supply apiServerUrl '
+                + '+ authToken + caCert, or run inside a Pod with a mounted ServiceAccount '
+                + `(${'/var/run/secrets/kubernetes.io/serviceaccount'}).`);
+        }
+        this.creds = {
+            apiServerUrl: this.settings.apiServerUrl ?? inCluster.apiServerUrl,
+            authToken: this.settings.authToken ?? inCluster.authToken,
+            caCert: this.settings.caCert ?? inCluster.caCert,
+            defaultNamespace: inCluster.defaultNamespace,
+        };
+        return this.creds;
+    }
+    async acquire() {
+        const retries = this.settings.acquireRetries ?? 3;
+        const retryDelay = this.settings.acquireRetryDelayMs ?? 100;
+        for (let attempt = 0; attempt < retries; attempt++) {
+            const result = await this.tryAcquireOnce();
+            if (result === 'success')
+                return true;
+            if (result === 'held-by-other')
+                return false;
+            // 'race' — someone else mutated the lease between our GET and PUT;
+            // back off briefly and retry.
+            if (attempt < retries - 1)
+                await sleep(retryDelay);
+        }
+        return false;
+    }
+    /** One pass of GET → CREATE-or-PUT.  Three outcomes: success / held-by-other / race. */
+    async tryAcquireOnce() {
+        const creds = await this.getCreds();
+        const ns = this.settings.namespace;
+        const name = this.settings.name;
+        const ttlSec = Math.max(1, Math.ceil(this.settings.ttlMs / 1000));
+        const now = new Date().toISOString();
+        const existing = await getLease(creds, ns, name, this.settings.client);
+        if (existing === null) {
+            // No lease object yet — create.  CREATE returns null on 409 (race lost).
+            const created = await createLease(creds, ns, {
+                holderIdentity: this.settings.owner,
+                leaseDurationSeconds: ttlSec,
+                acquireTime: now,
+                renewTime: now,
+            }, name, this.settings.client);
+            if (!created)
+                return 'race';
+            this.held = true;
+            this.currentLease = created;
+            this.startRenewalLoop();
+            return 'success';
+        }
+        // Lease object exists.  Decide whether we can take it.
+        if (this.isStillHeldByOther(existing))
+            return 'held-by-other';
+        // Either ours or expired — bump owner via PUT with the resourceVersion
+        // we just GET'd.  K8s rejects with 409 if anyone else mutated since.
+        const transitionsBefore = existing.spec.leaseTransitions ?? 0;
+        const ownerChanging = existing.spec.holderIdentity !== this.settings.owner;
+        const updated = {
+            ...existing,
+            spec: {
+                ...existing.spec,
+                holderIdentity: this.settings.owner,
+                leaseDurationSeconds: ttlSec,
+                acquireTime: now,
+                renewTime: now,
+                leaseTransitions: ownerChanging ? transitionsBefore + 1 : transitionsBefore,
+            },
+        };
+        const result = await updateLease(creds, updated, this.settings.client);
+        if (!result)
+            return 'race';
+        this.held = true;
+        this.currentLease = result;
+        this.startRenewalLoop();
+        return 'success';
+    }
+    /** True iff the existing lease has a different live holder. */
+    isStillHeldByOther(lease) {
+        const holder = lease.spec.holderIdentity;
+        if (!holder)
+            return false; // unowned
+        if (holder === this.settings.owner)
+            return false; // we already hold it
+        const renewTime = lease.spec.renewTime;
+        const durationSec = lease.spec.leaseDurationSeconds ?? this.settings.ttlMs / 1000;
+        if (!renewTime)
+            return true; // owned but no time → assume live
+        const expiresAt = new Date(renewTime).getTime() + durationSec * 1000;
+        return expiresAt > Date.now();
+    }
+    async release() {
+        if (!this.held)
+            return;
+        this.held = false;
+        if (this.renewalTimer) {
+            clearInterval(this.renewalTimer);
+            this.renewalTimer = null;
+        }
+        const creds = await this.getCreds().catch(() => null);
+        if (!creds)
+            return;
+        try {
+            await deleteLease(creds, this.settings.namespace, this.settings.name, this.settings.client);
+        }
+        catch (e) {
+            // best-effort — log via thrown info but don't fail the caller
+            // (release is a cleanup hook).
+            void e;
+        }
+        this.currentLease = null;
+    }
+    checkAlive() { return this.held; }
+    onLost(handler) {
+        this.onLostHandlers.add(handler);
+        return () => this.onLostHandlers.delete(handler);
+    }
+    /* ---------------------------- internals --------------------------- */
+    startRenewalLoop() {
+        if (this.renewalTimer)
+            return;
+        this.renewalTimer = setInterval(() => {
+            void this.renewOnce();
+        }, this.renewalIntervalMs);
+    }
+    async renewOnce() {
+        if (!this.held || !this.currentLease)
+            return;
+        let creds;
+        try {
+            creds = await this.getCreds();
+        }
+        catch (e) {
+            this.fireLost(`renewal failed: ${e.message}`);
+            return;
+        }
+        const now = new Date().toISOString();
+        const ttlSec = Math.max(1, Math.ceil(this.settings.ttlMs / 1000));
+        const updated = {
+            ...this.currentLease,
+            spec: {
+                ...this.currentLease.spec,
+                holderIdentity: this.settings.owner,
+                leaseDurationSeconds: ttlSec,
+                renewTime: now,
+            },
+        };
+        try {
+            const result = await updateLease(creds, updated, this.settings.client);
+            if (!result) {
+                // 409 / 404 — somebody else won, or the object was deleted.
+                this.fireLost('lease lost during renewal (conflict or 404)');
+                return;
+            }
+            this.currentLease = result;
+        }
+        catch (e) {
+            const msg = e instanceof K8sLeaseError
+                ? `renewal http error: ${e.message}`
+                : `renewal error: ${e.message}`;
+            this.fireLost(msg);
+        }
+    }
+    fireLost(reason) {
+        if (!this.held)
+            return;
+        this.held = false;
+        if (this.renewalTimer) {
+            clearInterval(this.renewalTimer);
+            this.renewalTimer = null;
+        }
+        this.currentLease = null;
+        for (const h of this.onLostHandlers) {
+            try {
+                h(reason);
+            }
+            catch { /* swallow */ }
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=KubernetesLease.js.map

package/dist/coordination/leases/KubernetesLease.js.map

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