@dudousxd/nestjs-durable-dashboard 0.24.0 → 0.26.0

package/dist/client/group-by-partition.d.ts

@@ -0,0 +1,21 @@
+import type { GroupHealth } from './durable-client';
+/** Rolled-up worker health for one tenant-isolation partition (see `partitionOf`). */
+export interface PartitionView {
+    partition: string;
+    /** Distinct `instanceId`s across every group's `liveWorkers` in this partition. */
+    workerCount: number;
+    /** Number of groups (queues) bucketed into this partition. */
+    handlerCount: number;
+    /** Sum of `depth` across the partition's groups. */
+    totalDepth: number;
+    /** Groups with a nonzero backlog and no live worker. */
+    starvedCount: number;
+}
+/**
+ * Bucket `GroupHealth[]` by `partitionOf(group.group)` and roll up counts. A worker that serves
+ * multiple queues in the same partition is counted once toward `workerCount` — we dedupe by
+ * `instanceId` across the whole partition, not per group. `'default'` (the operator/control-plane
+ * partition) sorts first; the rest follow alphabetically.
+ */
+export declare function groupByPartition(groups: GroupHealth[]): PartitionView[];
+//# sourceMappingURL=group-by-partition.d.ts.map

package/dist/client/group-by-partition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-partition.d.ts","sourceRoot":"","sources":["../../src/client/group-by-partition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAsCvE"}

package/dist/client/group-by-partition.js

@@ -0,0 +1,47 @@
+import { partitionOf } from './queue-partition';
+/**
+ * Bucket `GroupHealth[]` by `partitionOf(group.group)` and roll up counts. A worker that serves
+ * multiple queues in the same partition is counted once toward `workerCount` — we dedupe by
+ * `instanceId` across the whole partition, not per group. `'default'` (the operator/control-plane
+ * partition) sorts first; the rest follow alphabetically.
+ */
+export function groupByPartition(groups) {
+    const byPartition = new Map();
+    for (const group of groups) {
+        const partition = partitionOf(group.group);
+        const existing = byPartition.get(partition);
+        if (existing) {
+            existing.push(group);
+        }
+        else {
+            byPartition.set(partition, [group]);
+        }
+    }
+    const views = [...byPartition.entries()].map(([partition, partitionGroups]) => {
+        const workerIds = new Set();
+        let totalDepth = 0;
+        let starvedCount = 0;
+        for (const group of partitionGroups) {
+            totalDepth += group.depth;
+            if (group.depth > 0 && group.liveWorkers.length === 0)
+                starvedCount += 1;
+            for (const worker of group.liveWorkers)
+                workerIds.add(worker.instanceId);
+        }
+        return {
+            partition,
+            workerCount: workerIds.size,
+            handlerCount: partitionGroups.length,
+            totalDepth,
+            starvedCount,
+        };
+    });
+    return views.sort((a, b) => {
+        if (a.partition === 'default')
+            return -1;
+        if (b.partition === 'default')
+            return 1;
+        return a.partition.localeCompare(b.partition);
+    });
+}
+//# sourceMappingURL=group-by-partition.js.map

package/dist/client/group-by-partition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-partition.js","sourceRoot":"","sources":["../../src/client/group-by-partition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE;QAC5E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC;YAC1B,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,YAAY,IAAI,CAAC,CAAC;YACzE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,WAAW;gBAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO;YACL,SAAS;YACT,WAAW,EAAE,SAAS,CAAC,IAAI;YAC3B,YAAY,EAAE,eAAe,CAAC,MAAM;YACpC,UAAU;YACV,YAAY;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/client/pivot-by-worker.d.ts

@@ -0,0 +1,24 @@
+import type { GroupHealth, WorkerStatus } from './durable-client';
+/** One real worker pod, pivoted out of the `group → liveWorkers` shape the engine reports. A single
+ *  process subscribes to many handler queues and heartbeats into each, so `GroupHealth.liveWorkers`
+ *  repeats the same `instanceId` under every group it serves — this collapses those back to one row. */
+export interface WorkerView {
+    instanceId: string;
+    /** The partition this worker serves; its groups share one (see `partitionOf`). */
+    partition: string;
+    runtime?: 'node' | 'python' | undefined;
+    /** `baseHandlerName()` of every group this worker appears in, deduped and sorted ascending. */
+    handlers: string[];
+    /** From the heartbeat with the greatest `lastBeatAt`. */
+    status?: WorkerStatus | undefined;
+    /** Max `lastBeatAt` across this worker's heartbeats. */
+    lastBeatAt: number;
+}
+/**
+ * Pivot per-group worker health into per-worker health: `group → workers` becomes
+ * `worker → the groups it serves`. Each worker's `status`/`runtime` come from its most recent
+ * heartbeat (greatest `lastBeatAt`); `partition` follows that same latest heartbeat's group, which
+ * also covers the (should-never-happen) case of a worker whose groups disagree on partition.
+ */
+export declare function pivotByWorker(groups: GroupHealth[]): WorkerView[];
+//# sourceMappingURL=pivot-by-worker.d.ts.map

package/dist/client/pivot-by-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot-by-worker.d.ts","sourceRoot":"","sources":["../../src/client/pivot-by-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGlE;;wGAEwG;AACxG,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,CA8CjE"}

package/dist/client/pivot-by-worker.js

@@ -0,0 +1,55 @@
+import { baseHandlerName, partitionOf } from './queue-partition';
+/**
+ * Pivot per-group worker health into per-worker health: `group → workers` becomes
+ * `worker → the groups it serves`. Each worker's `status`/`runtime` come from its most recent
+ * heartbeat (greatest `lastBeatAt`); `partition` follows that same latest heartbeat's group, which
+ * also covers the (should-never-happen) case of a worker whose groups disagree on partition.
+ */
+export function pivotByWorker(groups) {
+    const byInstance = new Map();
+    for (const group of groups) {
+        for (const heartbeat of group.liveWorkers) {
+            const handler = baseHandlerName(heartbeat.group);
+            const existing = byInstance.get(heartbeat.instanceId);
+            if (existing === undefined) {
+                byInstance.set(heartbeat.instanceId, {
+                    instanceId: heartbeat.instanceId,
+                    partition: partitionOf(heartbeat.group),
+                    runtime: heartbeat.status?.runtime,
+                    handlers: new Set([handler]),
+                    status: heartbeat.status,
+                    lastBeatAt: heartbeat.lastBeatAt,
+                });
+                continue;
+            }
+            existing.handlers.add(handler);
+            if (heartbeat.lastBeatAt >= existing.lastBeatAt) {
+                existing.lastBeatAt = heartbeat.lastBeatAt;
+                existing.partition = partitionOf(heartbeat.group);
+                existing.runtime = heartbeat.status?.runtime;
+                existing.status = heartbeat.status;
+            }
+        }
+    }
+    return [...byInstance.values()]
+        .map((worker) => ({
+        instanceId: worker.instanceId,
+        partition: worker.partition,
+        runtime: worker.runtime,
+        handlers: [...worker.handlers].sort((a, b) => a.localeCompare(b)),
+        status: worker.status,
+        lastBeatAt: worker.lastBeatAt,
+    }))
+        .sort((a, b) => {
+        if (a.partition !== b.partition) {
+            // 'default' always sorts first; everything else falls back to alphabetical.
+            if (a.partition === 'default')
+                return -1;
+            if (b.partition === 'default')
+                return 1;
+            return a.partition.localeCompare(b.partition);
+        }
+        return a.instanceId.localeCompare(b.instanceId);
+    });
+}
+//# sourceMappingURL=pivot-by-worker.js.map

package/dist/client/pivot-by-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot-by-worker.js","sourceRoot":"","sources":["../../src/client/pivot-by-worker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA4BjE;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA6B,CAAC;IAExD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACtD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE;oBACnC,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC;oBACvC,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO;oBAClC,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;oBAC5B,MAAM,EAAE,SAAS,CAAC,MAAM;oBACxB,UAAU,EAAE,SAAS,CAAC,UAAU;iBACjC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,SAAS,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAChD,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;gBAC3C,QAAQ,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAClD,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC7C,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;SAC5B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;YAChC,4EAA4E;YAC5E,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/client/queue-partition.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Route-by-handler queue tokens are `<handler>@<partition>` (see core `tenantGroup`); the operator's
+ * default partition carries no suffix. A handler/workflow name never contains `@`, so the last `@`
+ * unambiguously separates the partition.
+ */
+/** The isolation partition a worker-queue token belongs to (`'default'` when it has no suffix). */
+export declare function partitionOf(group: string): string;
+/** The handler/workflow name with any `@<partition>` suffix stripped. */
+export declare function baseHandlerName(group: string): string;
+//# sourceMappingURL=queue-partition.d.ts.map

package/dist/client/queue-partition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-partition.d.ts","sourceRoot":"","sources":["../../src/client/queue-partition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/client/queue-partition.js

@@ -0,0 +1,16 @@
+/**
+ * Route-by-handler queue tokens are `<handler>@<partition>` (see core `tenantGroup`); the operator's
+ * default partition carries no suffix. A handler/workflow name never contains `@`, so the last `@`
+ * unambiguously separates the partition.
+ */
+/** The isolation partition a worker-queue token belongs to (`'default'` when it has no suffix). */
+export function partitionOf(group) {
+    const at = group.lastIndexOf('@');
+    return at === -1 ? 'default' : group.slice(at + 1);
+}
+/** The handler/workflow name with any `@<partition>` suffix stripped. */
+export function baseHandlerName(group) {
+    const at = group.lastIndexOf('@');
+    return at === -1 ? group : group.slice(0, at);
+}
+//# sourceMappingURL=queue-partition.js.map

package/dist/client/queue-partition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-partition.js","sourceRoot":"","sources":["../../src/client/queue-partition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/client/summarize-health.d.ts

@@ -0,0 +1,19 @@
+import type { GroupHealth } from './durable-client';
+/** Health-first summary of the whole `/durable` worker fleet, across every queue. */
+export interface HealthSummary {
+    /** Total number of groups (queues), healthy or not. */
+    queueCount: number;
+    /** Distinct `instanceId`s across every group's `liveWorkers` — a worker on many queues counts once. */
+    workerCount: number;
+    /** Groups with backlog and no worker consuming it, sorted by `depth` descending. */
+    starved: GroupHealth[];
+    /** True when `starved` is empty — the whole fleet is draining. */
+    allDraining: boolean;
+}
+/**
+ * Reduce the (potentially ~40-queue) `GroupHealth` list to the one actionable signal: which
+ * queues have backlog with nobody consuming it. `Array.prototype.sort` is stable (ES2019+), so
+ * groups tied on `depth` keep their input order.
+ */
+export declare function summarizeHealth(groups: GroupHealth[]): HealthSummary;
+//# sourceMappingURL=summarize-health.d.ts.map

package/dist/client/summarize-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-health.d.ts","sourceRoot":"","sources":["../../src/client/summarize-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,kEAAkE;IAClE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,CAgBpE"}

package/dist/client/summarize-health.js

@@ -0,0 +1,22 @@
+/**
+ * Reduce the (potentially ~40-queue) `GroupHealth` list to the one actionable signal: which
+ * queues have backlog with nobody consuming it. `Array.prototype.sort` is stable (ES2019+), so
+ * groups tied on `depth` keep their input order.
+ */
+export function summarizeHealth(groups) {
+    const instanceIds = new Set();
+    for (const group of groups) {
+        for (const worker of group.liveWorkers)
+            instanceIds.add(worker.instanceId);
+    }
+    const starved = groups
+        .filter((group) => group.depth > 0 && group.liveWorkers.length === 0)
+        .sort((a, b) => b.depth - a.depth);
+    return {
+        queueCount: groups.length,
+        workerCount: instanceIds.size,
+        starved,
+        allDraining: starved.length === 0,
+    };
+}
+//# sourceMappingURL=summarize-health.js.map

package/dist/client/summarize-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-health.js","sourceRoot":"","sources":["../../src/client/summarize-health.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,WAAW;YAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM;SACnB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;SACpE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,OAAO;QACP,WAAW,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/server/index.cjs

@@ -36,6 +36,11 @@ module.exports = __toCommonJS(index_exports);
 var import_nestjs_durable_core = require("@dudousxd/nestjs-durable-core");
 var import_common = require("@nestjs/common");
 var import_rxjs = require("rxjs");
+
+// src/server/tokens.ts
+var RUN_GATEWAY = Symbol.for("nestjs-durable:run-gateway");
+
+// src/server/dashboard.service.ts
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -57,33 +62,52 @@ var DashboardService = class {
   static {
     __name(this, "DashboardService");
   }
+  gateway;
   store;
   engine;
-  /** Prometheus counters accumulated from engine events since boot (per process). */
+  /** Prometheus counters accumulated from engine events since boot (per process); undefined on a
+  *  store-less tenant (no engine to accumulate from). */
   metricsCollector;
-  constructor(store, engine) {
+  constructor(gateway, store, engine) {
+    this.gateway = gateway;
     this.store = store;
     this.engine = engine;
-    this.metricsCollector = (0, import_nestjs_durable_core.collectMetrics)(this.engine);
+    this.metricsCollector = this.store && this.engine ? (0, import_nestjs_durable_core.collectMetrics)(this.engine) : void 0;
+  }
+  /**
+  * The operator-only ops need the FULL engine + canonical store, which only the control plane has.
+  * On a tenant the `WorkflowEngine` token is a store-less start client that implements none of these
+  * methods, so presence of the canonical store is the reliable discriminator — gate on it (never
+  * on engine presence, which is truthy on a tenant too).
+  */
+  controlPlane() {
+    if (!this.store || !this.engine) {
+      throw new Error("This durable dashboard operation requires the control plane (not available on a tenant deployment).");
+    }
+    return {
+      store: this.store,
+      engine: this.engine
+    };
   }
   /**
   * Prometheus-text metrics for a `/metrics` scrape: the event-counters (runs/steps by outcome,
   * per-workflow counts) plus live **backlog gauges** queried at scrape time — `durable_pending_runs`
   * (the dispatch backlog: the key health signal of the dispatch model) and `durable_dead_runs` (DLQ
-  * size). Capped per status so the scrape can't load an unbounded result set.
+  * size). Capped per status so the scrape can't load an unbounded result set. Control-plane-only.
   */
   async metrics() {
+    const { store, engine } = this.controlPlane();
     const cap = 1e4;
     const [pending, running, dead] = await Promise.all([
-      this.store.listRuns({
+      store.listRuns({
         status: "pending",
         limit: cap
       }),
-      this.store.listRuns({
+      store.listRuns({
         status: "running",
         limit: cap
       }),
-      this.store.listRuns({
+      store.listRuns({
         status: "dead",
         limit: cap
       })
@@ -96,7 +120,7 @@ var DashboardService = class {
       "# TYPE durable_dead_runs gauge",
       `durable_dead_runs ${dead.length}`
     ];
-    const health = await this.engine.workerHealth();
+    const health = await engine.workerHealth();
     if (health.length > 0) {
       gauges.push("# TYPE durable_group_queue_depth gauge");
       for (const h of health) {
@@ -107,40 +131,30 @@ var DashboardService = class {
         gauges.push(`durable_group_live_workers{group="${h.group}"} ${h.liveWorkers.length}`);
       }
     }
-    return `${this.metricsCollector.prometheus()}${gauges.join("\n")}
+    return `${this.metricsCollector?.prometheus() ?? ""}${gauges.join("\n")}
 `;
   }
   listRuns(query) {
-    return this.store.listRuns(query);
+    return this.gateway.listRuns(query);
   }
   /** Per-group worker health (queue backlog + live worker heartbeats) for the Workers panel. The
-  *  alert state a row turns red on is `depth > 0 && liveWorkers.length === 0`. */
-  workerHealth() {
-    return this.engine.workerHealth();
-  }
-  async getRunDetail(runId) {
-    const run = await this.store.getRun(runId);
-    if (!run) return null;
-    const [timeline, children] = await Promise.all([
-      this.store.listCheckpoints(runId),
-      this.engine.getRunChildren(runId)
-    ]);
-    return {
-      run,
-      timeline,
-      children
-    };
+  *  alert state a row turns red on is `depth > 0 && liveWorkers.length === 0`. Control-plane-only. */
+  async workerHealth() {
+    return this.controlPlane().engine.workerHealth();
+  }
+  getRunDetail(runId) {
+    return this.gateway.getRunDetail(runId);
   }
   /** Fix-and-replay a dead/failed run with a corrected input — a fresh linked run. Returns its id. */
   retryWithInput(runId, input) {
-    return this.engine.retryWithInput(runId, input);
+    return this.gateway.retryWithInput(runId, input);
   }
   /** Re-run a failed/incomplete run; completed steps replay from their checkpoints. */
   retry(runId) {
-    return this.engine.requeue(runId);
+    return this.gateway.retry(runId);
   }
   cancel(runId, opts) {
-    return this.engine.cancel(runId, opts);
+    return this.gateway.cancel(runId, opts);
   }
   /**
   * Apply `retry` or `cancel` to every run matching a filter (status / tag / workflow) — e.g. "retry
@@ -148,15 +162,15 @@ var DashboardService = class {
   * (already terminal) are skipped. Returns how many matched and how many the action applied to.
   */
   async bulk(action, filter, opts) {
-    const runs = await this.store.listRuns({
+    const runs = await this.gateway.listRuns({
       ...filter,
       limit: 500
     });
     let applied = 0;
     for (const r of runs) {
       try {
-        if (action === "retry") await this.engine.requeue(r.id);
-        else await this.engine.cancel(r.id, opts);
+        if (action === "retry") await this.gateway.retry(r.id);
+        else await this.gateway.cancel(r.id, opts);
         applied += 1;
       } catch {
       }
@@ -168,45 +182,48 @@ var DashboardService = class {
   }
   /** Resume a run paused at a `ctx.breakpoint` (the "continue" button). */
   continue(runId) {
-    return this.engine.continue(runId);
+    return this.gateway.continue(runId);
   }
   /**
   * Deliver a `ctx.webhook()` callback: turn an inbound POST (token + body) into the signal the
   * waiting run is parked on. Returns the run result, or `null` if no run waits on that token (a
-  * stale/duplicate callback) — a safe no-op the controller maps to 404.
+  * stale/duplicate callback) — a safe no-op the controller maps to 404. Control-plane-only.
   */
-  deliverWebhook(token, body) {
-    return this.engine.signal(token, body);
+  async deliverWebhook(token, body) {
+    return this.controlPlane().engine.signal(token, body);
   }
-  /** Side-effect-free read of a value a run published via `ctx.setEvent` (a live query). */
-  getEvent(runId, key) {
-    return this.engine.getEvent(runId, key);
+  /** Side-effect-free read of a value a run published via `ctx.setEvent` (a live query). Control-plane-only. */
+  async getEvent(runId, key) {
+    return this.controlPlane().engine.getEvent(runId, key);
   }
-  /** Deliver a validated `ctx.onUpdate` to a run; the validator may reject it (see UpdateResult). */
-  update(runId, name, arg) {
-    return this.engine.update(runId, name, arg);
+  /** Deliver a validated `ctx.onUpdate` to a run; the validator may reject it (see UpdateResult). Control-plane-only. */
+  async update(runId, name, arg) {
+    return this.controlPlane().engine.update(runId, name, arg);
   }
   /**
-  * Live stream of a run's lifecycle events for SSE. Backed by `engine.subscribe`, which — when the
-  * transport has a control plane — receives events from EVERY instance, so a dashboard-only pod
-  * tails a run executing on a worker pod. Without a control plane it only sees same-process events.
+  * Live stream of a run's lifecycle events for SSE. Backed by `gateway.subscribe`, which — on the
+  * control plane — receives events from EVERY instance (so a dashboard-only pod tails a run
+  * executing on a worker pod), and on a tenant round-trips over the transport. Either way the
+  * gateway already filters to `runId`; the dashboard just wires the events through.
   */
   streamRun(runId) {
     return new import_rxjs.Observable((subscriber) => {
-      const off = this.engine.subscribe((event) => {
-        if (event.runId === runId) subscriber.next({
-          data: event
-        });
-      });
+      const off = this.gateway.subscribe(runId, (event) => subscriber.next({
+        data: event
+      }));
       return () => off();
     });
   }
 };
 DashboardService = _ts_decorate([
   (0, import_common.Injectable)(),
-  _ts_param(0, (0, import_common.Inject)(import_nestjs_durable_core.STATE_STORE_CANONICAL)),
+  _ts_param(0, (0, import_common.Inject)(RUN_GATEWAY)),
+  _ts_param(1, (0, import_common.Optional)()),
+  _ts_param(1, (0, import_common.Inject)(import_nestjs_durable_core.STATE_STORE_CANONICAL)),
+  _ts_param(2, (0, import_common.Optional)()),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
+    typeof RunGateway === "undefined" ? Object : RunGateway,
     typeof StateStore === "undefined" ? Object : StateStore,
     typeof import_nestjs_durable_core.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core.WorkflowEngine
   ])