@blokjs/runner 0.2.2 → 0.6.0

package/dist/scheduling/DebounceBackend.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Tier C #1 · Cross-process debounce backend interface.
+ *
+ * Mirrors the relationship between `ConcurrencyBackend` and the
+ * `RunStore`-backed concurrency gate: an optional async capability that
+ * lets `DebounceCoordinator` coordinate windows across processes
+ * (NATS KV, Redis) instead of relying on the local in-memory Map.
+ *
+ * Default behavior is unchanged — when no backend is set, the
+ * coordinator uses its existing in-memory state. The backend is opt-in
+ * via `BLOK_DEBOUNCE_BACKEND={nats-kv|redis}` and installed by trigger
+ * packages during `listen()`.
+ *
+ * **Semantic trade-off**: this v1 ships *owner-local payload*
+ * semantics. The owning process's captured closure (`onFire`) fires
+ * when its local timer elapses; payloads from coalesce pings on other
+ * processes are dropped (the doc only records `pingCount`,
+ * `lastPingAt`, and `scheduledAt`). Cross-process latest-payload-wins
+ * is a deferred follow-up — would require persisting each ping's
+ * payload to the shared doc.
+ */
+export type DebounceBackendMode = "leading" | "trailing";
+export interface DebounceRegisterBackendOpts {
+    workflowName: string;
+    debounceKey: string;
+    mode: DebounceBackendMode;
+    delayMs: number;
+    maxDelayMs?: number;
+    /** Run id allocated by the caller for THIS ping. */
+    runId: string;
+    /** Process identity used for owner-lease attribution. */
+    processId: string;
+    /** Owner lease in ms — when expired, another process can take over. */
+    ownerLeaseMs: number;
+    /** Current wall-clock ms. */
+    now: number;
+}
+/**
+ * Result of a `registerPing`. Three outcomes, mirroring the
+ * single-process `DebounceRegisterResult` shape:
+ *
+ * - `"owner-new"` — caller is the new owner of a fresh window.
+ *   For leading mode: fire synchronously. For trailing mode: start a
+ *   local timer to fire at `scheduledAt`.
+ * - `"owner-extend"` — caller is the existing owner; window extended.
+ *   Cancel + restart local timer to fire at the new `scheduledAt`.
+ * - `"coalesce"` — caller is NOT the owner. Mark the run `debounced`
+ *   with `intoRunId = activeRunId`.
+ */
+export interface DebounceRegisterBackendResult {
+    outcome: "owner-new" | "owner-extend" | "coalesce";
+    activeRunId: string;
+    /** The runId of the OWNING process. Equal to opts.runId when outcome ∈ {owner-new, owner-extend}; differs on coalesce. */
+    scheduledAt: number;
+    pingCount: number;
+}
+/**
+ * Result of a `finalize` call from an owning process's local timer.
+ *
+ * - `"fire"` — caller still owns AND the silence period elapsed.
+ *   Bucket has been atomically DELETEd; caller dispatches.
+ * - `"reschedule"` — caller still owns, but coalesce pings from other
+ *   processes pushed `scheduledAt` forward. Caller restarts local
+ *   timer for `scheduledAt - now`.
+ * - `"abandoned"` — caller's lease expired and another process took
+ *   ownership. Caller silently drops the closure.
+ */
+export type DebounceFinalizeResult = {
+    finalize: "fire";
+} | {
+    finalize: "reschedule";
+    scheduledAt: number;
+} | {
+    finalize: "abandoned";
+};
+export interface DebounceBackend {
+    /** Identifying string for logs/metrics. e.g. `"nats-kv"`, `"redis"`. */
+    readonly name: string;
+    /** Lifecycle — open the underlying connection. Idempotent. */
+    connect(): Promise<void>;
+    /** Lifecycle — close the underlying connection. Idempotent. */
+    disconnect(): Promise<void>;
+    /**
+     * Atomically record a ping against the `(workflow, debounceKey)`
+     * bucket and decide ownership. Returns one of the three outcomes
+     * documented on {@link DebounceRegisterBackendResult}.
+     */
+    registerPing(opts: DebounceRegisterBackendOpts): Promise<DebounceRegisterBackendResult>;
+    /**
+     * Owner calls this on local timer fire. Atomically:
+     *  - If `runId` still owns AND `now >= scheduledAt` → DELETE the
+     *    bucket and return `{finalize: "fire"}`.
+     *  - If `runId` still owns but `now < scheduledAt` → return
+     *    `{finalize: "reschedule", scheduledAt}`.
+     *  - If `runId` no longer owns (lease expired + handoff) → return
+     *    `{finalize: "abandoned"}`.
+     */
+    finalize(workflowName: string, debounceKey: string, runId: string, now: number): Promise<DebounceFinalizeResult>;
+    /** Cancel an active window without firing. Returns true if cancelled. */
+    cancel(workflowName: string, debounceKey: string): Promise<boolean>;
+    /**
+     * Janitor sweep — purge every bucket whose owner lease expired
+     * AND whose `scheduledAt` is in the past. Returns the count of
+     * purged buckets. Cheap per-bucket lazy-purge happens inside the
+     * registerPing/finalize scripts.
+     */
+    purgeExpired(now: number): Promise<number>;
+}

package/dist/scheduling/DebounceBackend.js

@@ -0,0 +1,23 @@
+/**
+ * Tier C #1 · Cross-process debounce backend interface.
+ *
+ * Mirrors the relationship between `ConcurrencyBackend` and the
+ * `RunStore`-backed concurrency gate: an optional async capability that
+ * lets `DebounceCoordinator` coordinate windows across processes
+ * (NATS KV, Redis) instead of relying on the local in-memory Map.
+ *
+ * Default behavior is unchanged — when no backend is set, the
+ * coordinator uses its existing in-memory state. The backend is opt-in
+ * via `BLOK_DEBOUNCE_BACKEND={nats-kv|redis}` and installed by trigger
+ * packages during `listen()`.
+ *
+ * **Semantic trade-off**: this v1 ships *owner-local payload*
+ * semantics. The owning process's captured closure (`onFire`) fires
+ * when its local timer elapses; payloads from coalesce pings on other
+ * processes are dropped (the doc only records `pingCount`,
+ * `lastPingAt`, and `scheduledAt`). Cross-process latest-payload-wins
+ * is a deferred follow-up — would require persisting each ping's
+ * payload to the shared doc.
+ */
+export {};
+//# sourceMappingURL=DebounceBackend.js.map

package/dist/scheduling/DebounceBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebounceBackend.js","sourceRoot":"","sources":["../../src/scheduling/DebounceBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/scheduling/DebounceCoordinator.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Tier 2 #7 — debounce coordinator. Tier C #1 — cross-process awareness.
+ *
+ * Coalesces rapid same-key triggers into a single delayed run. Modes:
+ *
+ * - `"trailing"` (default): each ping resets a timer; the run fires
+ *   after `delayMs` of silence. Latest payload wins (within a single
+ *   owning process). `maxDelayMs` bounds tail latency — even with
+ *   continuous pings, the run fires after `maxDelayMs` from the FIRST
+ *   ping.
+ * - `"leading"`: the first ping fires immediately. Subsequent pings
+ *   within `delayMs` are dropped. Window resets after `delayMs` of
+ *   silence.
+ *
+ * Process-wide singleton. **Default**: in-memory only — fast,
+ * synchronous internally. **Cross-process mode (Tier C #1)**: install a
+ * `DebounceBackend` via `setBackend()` and the coordinator routes
+ * register/cancel through the backend with the same outcome surface,
+ * keeping a local timer + closure for the OWNING process. The
+ * `register()` API is async — callers must `await` it.
+ *
+ * Latest-payload semantics in cross-process mode: **owner-local**.
+ * Pings from a non-owning process bump pingCount + push scheduledAt in
+ * the shared doc but do NOT contribute their payload — only the
+ * owning process's captured `onFire` closure fires. Cross-process
+ * latest-payload-wins is deferred (would require persisting each
+ * ping's payload to the shared doc; tracked in BACKLOG).
+ */
+import type { DebounceBackend } from "./DebounceBackend";
+export type DebounceDispatchFn = () => Promise<void>;
+export type DebounceMode = "leading" | "trailing";
+export interface DebounceRegisterOpts {
+    workflowName: string;
+    debounceKey: string;
+    mode: DebounceMode;
+    delayMs: number;
+    maxDelayMs?: number;
+    /**
+     * Run id allocated by the caller for THIS ping. On a fresh window
+     * this becomes the active run id; on a coalesce it's a "loser" and
+     * the caller marks it `debounced` terminal.
+     */
+    runId: string;
+    /**
+     * Callback the coordinator invokes when the trailing-mode window
+     * closes. Captures ctx + runId via closure. NOT called for leading
+     * mode (the caller runs the first ping synchronously) or for
+     * coalesce pings (those are dropped by definition).
+     */
+    onFire: DebounceDispatchFn;
+    /**
+     * Test-only override of "now" for deterministic tests. Production
+     * code does not pass this.
+     */
+    __now?: number;
+}
+/**
+ * The outcome of `register`. Branches the caller's behavior.
+ *
+ * - `"fire-immediate"` (leading + fresh window) — caller runs the
+ *   workflow synchronously. The window is now open; subsequent pings
+ *   in `delayMs` are suppressed.
+ * - `"schedule-trailing"` (trailing + fresh window) — caller marks the
+ *   run `debounced` (transient) and throws `DeferredDispatchSignal`.
+ *   The coordinator's timer will invoke `onFire` after the window.
+ * - `"coalesce"` (leading or trailing + existing window) — caller marks
+ *   the run `debounced` (terminal, with `intoRunId = activeRunId`) and
+ *   throws `DeferredDispatchSignal`. The active run absorbs the ping.
+ */
+export interface DebounceRegisterResult {
+    outcome: "fire-immediate" | "schedule-trailing" | "coalesce";
+    /**
+     * The runId of the run that owns the active window. Equal to
+     * `opts.runId` on `fire-immediate` and `schedule-trailing`; equal to
+     * the EXISTING window's runId on `coalesce` (so the caller knows
+     * which run absorbed the ping).
+     */
+    activeRunId: string;
+    /** Dispatch time for trailing windows; undefined on `fire-immediate`. */
+    scheduledAt?: number;
+    /** Pings absorbed by the active window so far (including this one). */
+    pingCount: number;
+}
+export declare class DebounceCoordinator {
+    private static instance;
+    private states;
+    private backend;
+    /** Process identity for cross-process owner-lease attribution. Stable for the lifetime of the singleton. */
+    private readonly processId;
+    private ownerLeaseMs;
+    static getInstance(): DebounceCoordinator;
+    /** Test-only — reset the singleton + clear all state. */
+    static resetInstance(): void;
+    /**
+     * Install a cross-process backend. Set via `HttpTrigger.listen()` /
+     * `WorkerTrigger.listen()` when `BLOK_DEBOUNCE_BACKEND` is configured.
+     * Pass `null` to revert to the in-memory fast path.
+     */
+    setBackend(backend: DebounceBackend | null): void;
+    getBackend(): DebounceBackend | null;
+    /**
+     * Override the owner-lease duration. Used by `HttpTrigger.listen()` /
+     * `WorkerTrigger.listen()` to apply `BLOK_DEBOUNCE_OWNER_LEASE_MS`.
+     */
+    setOwnerLeaseMs(ms: number): void;
+    private bucket;
+    register(opts: DebounceRegisterOpts): Promise<DebounceRegisterResult>;
+    /**
+     * In-memory fast path — preserved exactly from the v1 single-process
+     * implementation. Synchronous internally; the outer signature is
+     * async so callers don't need to discriminate.
+     */
+    private registerLocal;
+    private fireTrailingLocal;
+    /**
+     * Cross-process path — delegates ownership to the backend and uses
+     * a local timer + closure for the OWNING process.
+     *
+     * Three outcomes from the backend:
+     *  - `owner-new`: this process is the new owner. Start a local timer
+     *    + closure; on fire, atomically finalize via the backend.
+     *  - `owner-extend`: this process is already the owner. Cancel +
+     *    restart the local timer at the new scheduledAt; refresh closure.
+     *  - `coalesce`: another process owns the window. Just return.
+     *
+     * Leading mode: `owner-new` translates to `fire-immediate` (caller
+     * fires synchronously); `owner-extend`/`coalesce` translate to
+     * `coalesce`.
+     */
+    private registerCrossProcess;
+    private installOwnerTimer;
+    private fireTrailingCrossProcess;
+    /** Cancel an active window without firing. Returns true if cancelled. */
+    cancel(workflowName: string, debounceKey: string): Promise<boolean>;
+    /** Number of active LOCAL debounce windows. Tests + observability. Excludes cross-process windows owned by other processes. */
+    size(): number;
+    /** True if THIS process has a local window for `(workflow, key)`. Excludes windows owned by other processes. */
+    has(workflowName: string, debounceKey: string): boolean;
+    /** Cancel everything without firing. Local state only — cross-process buckets fall back to lease-expiry. */
+    clear(): void;
+}

package/dist/scheduling/DebounceCoordinator.js

@@ -0,0 +1,362 @@
+/**
+ * Tier 2 #7 — debounce coordinator. Tier C #1 — cross-process awareness.
+ *
+ * Coalesces rapid same-key triggers into a single delayed run. Modes:
+ *
+ * - `"trailing"` (default): each ping resets a timer; the run fires
+ *   after `delayMs` of silence. Latest payload wins (within a single
+ *   owning process). `maxDelayMs` bounds tail latency — even with
+ *   continuous pings, the run fires after `maxDelayMs` from the FIRST
+ *   ping.
+ * - `"leading"`: the first ping fires immediately. Subsequent pings
+ *   within `delayMs` are dropped. Window resets after `delayMs` of
+ *   silence.
+ *
+ * Process-wide singleton. **Default**: in-memory only — fast,
+ * synchronous internally. **Cross-process mode (Tier C #1)**: install a
+ * `DebounceBackend` via `setBackend()` and the coordinator routes
+ * register/cancel through the backend with the same outcome surface,
+ * keeping a local timer + closure for the OWNING process. The
+ * `register()` API is async — callers must `await` it.
+ *
+ * Latest-payload semantics in cross-process mode: **owner-local**.
+ * Pings from a non-owning process bump pingCount + push scheduledAt in
+ * the shared doc but do NOT contribute their payload — only the
+ * owning process's captured `onFire` closure fires. Cross-process
+ * latest-payload-wins is deferred (would require persisting each
+ * ping's payload to the shared doc; tracked in BACKLOG).
+ */
+import { randomUUID } from "node:crypto";
+const DEFAULT_OWNER_LEASE_MS = 60_000;
+export class DebounceCoordinator {
+    static instance = null;
+    states = new Map();
+    backend = null;
+    /** Process identity for cross-process owner-lease attribution. Stable for the lifetime of the singleton. */
+    processId = randomUUID();
+    ownerLeaseMs = DEFAULT_OWNER_LEASE_MS;
+    static getInstance() {
+        if (!DebounceCoordinator.instance) {
+            DebounceCoordinator.instance = new DebounceCoordinator();
+        }
+        return DebounceCoordinator.instance;
+    }
+    /** Test-only — reset the singleton + clear all state. */
+    static resetInstance() {
+        DebounceCoordinator.instance?.clear();
+        DebounceCoordinator.instance = null;
+    }
+    /**
+     * Install a cross-process backend. Set via `HttpTrigger.listen()` /
+     * `WorkerTrigger.listen()` when `BLOK_DEBOUNCE_BACKEND` is configured.
+     * Pass `null` to revert to the in-memory fast path.
+     */
+    setBackend(backend) {
+        this.backend = backend;
+    }
+    getBackend() {
+        return this.backend;
+    }
+    /**
+     * Override the owner-lease duration. Used by `HttpTrigger.listen()` /
+     * `WorkerTrigger.listen()` to apply `BLOK_DEBOUNCE_OWNER_LEASE_MS`.
+     */
+    setOwnerLeaseMs(ms) {
+        if (Number.isFinite(ms) && ms > 0) {
+            this.ownerLeaseMs = ms;
+        }
+    }
+    bucket(workflowName, debounceKey) {
+        return `${workflowName}\x1f${debounceKey}`;
+    }
+    async register(opts) {
+        if (this.backend) {
+            return this.registerCrossProcess(opts);
+        }
+        return this.registerLocal(opts);
+    }
+    /**
+     * In-memory fast path — preserved exactly from the v1 single-process
+     * implementation. Synchronous internally; the outer signature is
+     * async so callers don't need to discriminate.
+     */
+    registerLocal(opts) {
+        const now = opts.__now ?? Date.now();
+        const bucketKey = this.bucket(opts.workflowName, opts.debounceKey);
+        const existing = this.states.get(bucketKey);
+        // === Leading mode ===
+        if (opts.mode === "leading") {
+            if (existing) {
+                // Window active — coalesce this ping (drop the run).
+                existing.pingCount += 1;
+                existing.lastPingAt = now;
+                return {
+                    outcome: "coalesce",
+                    activeRunId: existing.activeRunId,
+                    pingCount: existing.pingCount,
+                };
+            }
+            // Open a new window. Caller fires synchronously; coordinator just
+            // tracks state to suppress follow-ups for `delayMs`.
+            const state = {
+                bucketKey,
+                mode: "leading",
+                delayMs: opts.delayMs,
+                maxDelayMs: opts.maxDelayMs,
+                firstPingAt: now,
+                lastPingAt: now,
+                pingCount: 1,
+                activeRunId: opts.runId,
+            };
+            // Auto-close the window after delayMs of silence — clear state so
+            // subsequent pings start fresh.
+            state.timer = setTimeout(() => {
+                const cur = this.states.get(bucketKey);
+                if (cur && cur.lastPingAt + opts.delayMs <= Date.now()) {
+                    this.states.delete(bucketKey);
+                }
+            }, opts.delayMs);
+            this.states.set(bucketKey, state);
+            return { outcome: "fire-immediate", activeRunId: opts.runId, pingCount: 1 };
+        }
+        // === Trailing mode ===
+        if (existing) {
+            // Extend the window: cancel the old timer, set a new one. Latest
+            // payload wins via the captured `onFire`.
+            if (existing.timer)
+                clearTimeout(existing.timer);
+            existing.pingCount += 1;
+            existing.lastPingAt = now;
+            existing.onFire = opts.onFire;
+            const naiveDeadline = now + opts.delayMs;
+            const dispatchAt = existing.maxDelayDeadline !== undefined ? Math.min(naiveDeadline, existing.maxDelayDeadline) : naiveDeadline;
+            const wait = Math.max(0, dispatchAt - now);
+            existing.timer = setTimeout(() => this.fireTrailingLocal(bucketKey), wait);
+            return {
+                outcome: "coalesce",
+                activeRunId: existing.activeRunId,
+                scheduledAt: dispatchAt,
+                pingCount: existing.pingCount,
+            };
+        }
+        // New trailing window.
+        const state = {
+            bucketKey,
+            mode: "trailing",
+            delayMs: opts.delayMs,
+            maxDelayMs: opts.maxDelayMs,
+            firstPingAt: now,
+            lastPingAt: now,
+            pingCount: 1,
+            activeRunId: opts.runId,
+            maxDelayDeadline: opts.maxDelayMs !== undefined ? now + opts.maxDelayMs : undefined,
+            onFire: opts.onFire,
+        };
+        const naiveDeadline = now + opts.delayMs;
+        const dispatchAt = state.maxDelayDeadline !== undefined ? Math.min(naiveDeadline, state.maxDelayDeadline) : naiveDeadline;
+        const wait = Math.max(0, dispatchAt - now);
+        state.timer = setTimeout(() => this.fireTrailingLocal(bucketKey), wait);
+        this.states.set(bucketKey, state);
+        return {
+            outcome: "schedule-trailing",
+            activeRunId: opts.runId,
+            scheduledAt: dispatchAt,
+            pingCount: 1,
+        };
+    }
+    fireTrailingLocal(bucketKey) {
+        const state = this.states.get(bucketKey);
+        if (!state)
+            return;
+        this.states.delete(bucketKey);
+        if (state.onFire) {
+            void state.onFire().catch((err) => {
+                console.error(`[blok][scheduling] DebounceCoordinator trailing-fire failed for key ${bucketKey}:`, err instanceof Error ? err.stack || err.message : err);
+            });
+        }
+    }
+    /**
+     * Cross-process path — delegates ownership to the backend and uses
+     * a local timer + closure for the OWNING process.
+     *
+     * Three outcomes from the backend:
+     *  - `owner-new`: this process is the new owner. Start a local timer
+     *    + closure; on fire, atomically finalize via the backend.
+     *  - `owner-extend`: this process is already the owner. Cancel +
+     *    restart the local timer at the new scheduledAt; refresh closure.
+     *  - `coalesce`: another process owns the window. Just return.
+     *
+     * Leading mode: `owner-new` translates to `fire-immediate` (caller
+     * fires synchronously); `owner-extend`/`coalesce` translate to
+     * `coalesce`.
+     */
+    async registerCrossProcess(opts) {
+        const backend = this.backend;
+        if (!backend)
+            return this.registerLocal(opts);
+        const now = opts.__now ?? Date.now();
+        const bucketKey = this.bucket(opts.workflowName, opts.debounceKey);
+        let res;
+        try {
+            res = await backend.registerPing({
+                workflowName: opts.workflowName,
+                debounceKey: opts.debounceKey,
+                mode: opts.mode,
+                delayMs: opts.delayMs,
+                maxDelayMs: opts.maxDelayMs,
+                runId: opts.runId,
+                processId: this.processId,
+                ownerLeaseMs: this.ownerLeaseMs,
+                now,
+            });
+        }
+        catch (err) {
+            // Fail-open — fall back to local in-memory window. Same posture
+            // as the concurrency-backend fail-fast path (deny-on-error) but
+            // debounce isn't a safety gate — better to admit the ping than
+            // drop it on a transient broker outage.
+            console.warn(`[blok][scheduling] debounce backend registerPing failed for ${bucketKey}: ${err instanceof Error ? err.message : String(err)}; falling back to in-memory window`);
+            return this.registerLocal(opts);
+        }
+        // === Leading mode ===
+        if (opts.mode === "leading") {
+            if (res.outcome === "owner-new") {
+                // Caller fires synchronously; we don't keep a local timer for
+                // leading mode (the backend's owner-lease IS the window).
+                return { outcome: "fire-immediate", activeRunId: opts.runId, pingCount: res.pingCount };
+            }
+            return { outcome: "coalesce", activeRunId: res.activeRunId, pingCount: res.pingCount };
+        }
+        // === Trailing mode ===
+        if (res.outcome === "owner-new") {
+            // New trailing window owned by this process. Capture the closure +
+            // start a local timer to fire at backend-decided scheduledAt.
+            this.installOwnerTimer(bucketKey, opts, res.scheduledAt, now);
+            return {
+                outcome: "schedule-trailing",
+                activeRunId: opts.runId,
+                scheduledAt: res.scheduledAt,
+                pingCount: res.pingCount,
+            };
+        }
+        if (res.outcome === "owner-extend") {
+            // We still own. Replace the captured closure (latest payload
+            // wins within this process) + reschedule.
+            this.installOwnerTimer(bucketKey, opts, res.scheduledAt, now);
+            return {
+                outcome: "coalesce",
+                activeRunId: res.activeRunId,
+                scheduledAt: res.scheduledAt,
+                pingCount: res.pingCount,
+            };
+        }
+        // outcome === "coalesce" — another process owns. Do not install a
+        // local timer; the owning process drives the fire.
+        return {
+            outcome: "coalesce",
+            activeRunId: res.activeRunId,
+            scheduledAt: res.scheduledAt,
+            pingCount: res.pingCount,
+        };
+    }
+    installOwnerTimer(bucketKey, opts, scheduledAt, now) {
+        const existing = this.states.get(bucketKey);
+        if (existing?.timer)
+            clearTimeout(existing.timer);
+        const state = {
+            bucketKey,
+            mode: opts.mode,
+            delayMs: opts.delayMs,
+            maxDelayMs: opts.maxDelayMs,
+            firstPingAt: existing?.firstPingAt ?? now,
+            lastPingAt: now,
+            pingCount: (existing?.pingCount ?? 0) + 1,
+            activeRunId: opts.runId,
+            maxDelayDeadline: existing?.maxDelayDeadline ?? (opts.maxDelayMs !== undefined ? now + opts.maxDelayMs : undefined),
+            onFire: opts.onFire,
+        };
+        const wait = Math.max(0, scheduledAt - now);
+        state.timer = setTimeout(() => {
+            void this.fireTrailingCrossProcess(bucketKey, opts.workflowName, opts.debounceKey, opts.runId);
+        }, wait);
+        this.states.set(bucketKey, state);
+    }
+    async fireTrailingCrossProcess(bucketKey, workflowName, debounceKey, runId) {
+        const backend = this.backend;
+        const state = this.states.get(bucketKey);
+        if (!backend || !state)
+            return;
+        const now = Date.now();
+        let result;
+        try {
+            result = await backend.finalize(workflowName, debounceKey, runId, now);
+        }
+        catch (err) {
+            // Treat as abandoned — owner-lease will eventually expire and
+            // another process can take over. Don't fire to avoid duplicate
+            // dispatch.
+            console.warn(`[blok][scheduling] debounce backend finalize failed for ${bucketKey}: ${err instanceof Error ? err.message : String(err)}; abandoning local owner state`);
+            this.states.delete(bucketKey);
+            return;
+        }
+        if (result.finalize === "fire") {
+            this.states.delete(bucketKey);
+            if (state.onFire) {
+                void state.onFire().catch((err) => {
+                    console.error(`[blok][scheduling] DebounceCoordinator cross-process fire failed for key ${bucketKey}:`, err instanceof Error ? err.stack || err.message : err);
+                });
+            }
+            return;
+        }
+        if (result.finalize === "reschedule") {
+            // Coalesce pings from other processes pushed scheduledAt forward.
+            // Reschedule local timer; closure stays.
+            if (state.timer)
+                clearTimeout(state.timer);
+            const wait = Math.max(0, result.scheduledAt - now);
+            state.timer = setTimeout(() => {
+                void this.fireTrailingCrossProcess(bucketKey, workflowName, debounceKey, runId);
+            }, wait);
+            return;
+        }
+        // finalize === "abandoned" — lease expired; another process took
+        // over. Drop the closure silently.
+        this.states.delete(bucketKey);
+    }
+    /** Cancel an active window without firing. Returns true if cancelled. */
+    async cancel(workflowName, debounceKey) {
+        const bucketKey = this.bucket(workflowName, debounceKey);
+        const state = this.states.get(bucketKey);
+        if (state?.timer)
+            clearTimeout(state.timer);
+        const hadLocal = this.states.delete(bucketKey);
+        if (this.backend) {
+            try {
+                const cancelled = await this.backend.cancel(workflowName, debounceKey);
+                return cancelled || hadLocal;
+            }
+            catch (err) {
+                console.warn(`[blok][scheduling] debounce backend cancel failed for ${bucketKey}: ${err instanceof Error ? err.message : String(err)}`);
+                return hadLocal;
+            }
+        }
+        return hadLocal;
+    }
+    /** Number of active LOCAL debounce windows. Tests + observability. Excludes cross-process windows owned by other processes. */
+    size() {
+        return this.states.size;
+    }
+    /** True if THIS process has a local window for `(workflow, key)`. Excludes windows owned by other processes. */
+    has(workflowName, debounceKey) {
+        return this.states.has(this.bucket(workflowName, debounceKey));
+    }
+    /** Cancel everything without firing. Local state only — cross-process buckets fall back to lease-expiry. */
+    clear() {
+        for (const state of this.states.values()) {
+            if (state.timer)
+                clearTimeout(state.timer);
+        }
+        this.states.clear();
+    }
+}
+//# sourceMappingURL=DebounceCoordinator.js.map

package/dist/scheduling/DebounceCoordinator.js.map

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