@dudousxd/nestjs-durable-dashboard 0.41.0 → 0.42.0

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
 import * as _dudousxd_nestjs_durable_core from '@dudousxd/nestjs-durable-core';
-import { RunGateway, StateStore, WorkflowEngine, RunQuery, RunListItem, DurableTopology, GroupHealth, RunDetail, RunResult, UpdateResult, EngineEvent, RunStatus } from '@dudousxd/nestjs-durable-core';
+import { RunGateway, StateStore, WorkflowEngine, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, DurableTopology, GroupHealth, RunDetail, RunResult, UpdateResult, EngineEvent, RunStatus } from '@dudousxd/nestjs-durable-core';
 export { RunDetail } from '@dudousxd/nestjs-durable-core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
@@ -134,6 +134,9 @@ declare class DashboardService {
      */
     metrics(): Promise<string>;
     listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /** `(status, origin)` counts over the same predicates {@link listRuns} pages — what keeps the
+     *  console's chips exact while its list is bounded to a page. */
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /** This deployment's durable role (control plane vs tenant) + tenant name — for the dashboard header
      *  badge. Routes through the gateway, which knows its own topology (store-backed = operator, proxy =
      *  tenant). Works on both topologies (no store/engine needed). */
@@ -195,6 +198,18 @@ declare class DashboardService {
     }>;
 }
 
+/**
+ * A run as the CONSOLE'S LIST needs it: every field a row or its derived state reads, and none of the
+ * payloads only the detail view opens.
+ *
+ * `input`, `output` and `error` are dropped. On a real control plane they dominate the response —
+ * measured against a 9.5k-run deployment, `error` alone (stack traces on every failed run) was 63% of
+ * a 12 MB listing — while no list row, and no `deriveRunState` input, ever reads them. The detail
+ * endpoint (`GET runs/:id`) still returns the whole run, which is where those three are actually
+ * rendered.
+ */
+type RunListRow = Omit<RunListItem, 'input' | 'output' | 'error'>;
+
 /** JSON API consumed by the control-plane SPA. Mounted at `apiBasePath` (set by RouterModule). */
 declare class DurableApiController {
     private readonly dashboard;
@@ -207,7 +222,16 @@ declare class DurableApiController {
      * A blank param (`?namespace=`, from a cleared filter box) is the same as an absent one; passing
      * `''` through would be an exact match on a tenant nobody has, i.e. a silently empty console.
      */
-    runs(status?: RunStatus, workflow?: string, tag?: string, attr?: string | string[], namespace?: string, origin?: string): Promise<_dudousxd_nestjs_durable_core.RunListItem[]>;
+    runs(status?: RunStatus | RunStatus[], workflow?: string, tag?: string, attr?: string | string[], namespace?: string, origin?: string, unattributed?: string, limit?: string, offset?: string): Promise<RunListRow[]>;
+    /**
+     * `(status, origin)` counts for the runs matching the same tag/tenant/attribute predicates as
+     * `GET runs`. This is what lets that listing be PAGED at all: the page bounds what the console
+     * renders, this bounds nothing and keeps its status and origin chips exact.
+     *
+     * `status`, `origin` and the page bounds are deliberately NOT accepted — they are the axes being
+     * counted, so narrowing by them would report the answer back to itself.
+     */
+    facets(workflow?: string, tag?: string, attr?: string | string[], namespace?: string): Promise<_dudousxd_nestjs_durable_core.RunFacetRow[]>;
     /** Prometheus-text metrics (runs/steps by outcome, per-workflow counts) for a scrape. */
     metrics(): Promise<string>;
     /** Per-group worker health (queue backlog + live worker heartbeats) for the Workers panel. */
@@ -232,7 +256,7 @@ declare class DurableApiController {
      * The filter takes the SAME params as `GET runs` and is parsed identically, so "retry all" acts on
      * exactly the set the operator was looking at rather than a wider one.
      */
-    bulk(action: 'retry' | 'cancel', status?: RunStatus, tag?: string, workflow?: string, attr?: string | string[], compensate?: string, namespace?: string, origin?: string): Promise<{
+    bulk(action: 'retry' | 'cancel', status?: RunStatus, tag?: string, workflow?: string, attr?: string | string[], compensate?: string, namespace?: string, origin?: string, unattributed?: string): Promise<{
         matched: number;
         applied: number;
     }>;

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
 import * as _dudousxd_nestjs_durable_core from '@dudousxd/nestjs-durable-core';
-import { RunGateway, StateStore, WorkflowEngine, RunQuery, RunListItem, DurableTopology, GroupHealth, RunDetail, RunResult, UpdateResult, EngineEvent, RunStatus } from '@dudousxd/nestjs-durable-core';
+import { RunGateway, StateStore, WorkflowEngine, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, DurableTopology, GroupHealth, RunDetail, RunResult, UpdateResult, EngineEvent, RunStatus } from '@dudousxd/nestjs-durable-core';
 export { RunDetail } from '@dudousxd/nestjs-durable-core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
@@ -134,6 +134,9 @@ declare class DashboardService {
      */
     metrics(): Promise<string>;
     listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /** `(status, origin)` counts over the same predicates {@link listRuns} pages — what keeps the
+     *  console's chips exact while its list is bounded to a page. */
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /** This deployment's durable role (control plane vs tenant) + tenant name — for the dashboard header
      *  badge. Routes through the gateway, which knows its own topology (store-backed = operator, proxy =
      *  tenant). Works on both topologies (no store/engine needed). */
@@ -195,6 +198,18 @@ declare class DashboardService {
     }>;
 }
 
+/**
+ * A run as the CONSOLE'S LIST needs it: every field a row or its derived state reads, and none of the
+ * payloads only the detail view opens.
+ *
+ * `input`, `output` and `error` are dropped. On a real control plane they dominate the response —
+ * measured against a 9.5k-run deployment, `error` alone (stack traces on every failed run) was 63% of
+ * a 12 MB listing — while no list row, and no `deriveRunState` input, ever reads them. The detail
+ * endpoint (`GET runs/:id`) still returns the whole run, which is where those three are actually
+ * rendered.
+ */
+type RunListRow = Omit<RunListItem, 'input' | 'output' | 'error'>;
+
 /** JSON API consumed by the control-plane SPA. Mounted at `apiBasePath` (set by RouterModule). */
 declare class DurableApiController {
     private readonly dashboard;
@@ -207,7 +222,16 @@ declare class DurableApiController {
      * A blank param (`?namespace=`, from a cleared filter box) is the same as an absent one; passing
      * `''` through would be an exact match on a tenant nobody has, i.e. a silently empty console.
      */
-    runs(status?: RunStatus, workflow?: string, tag?: string, attr?: string | string[], namespace?: string, origin?: string): Promise<_dudousxd_nestjs_durable_core.RunListItem[]>;
+    runs(status?: RunStatus | RunStatus[], workflow?: string, tag?: string, attr?: string | string[], namespace?: string, origin?: string, unattributed?: string, limit?: string, offset?: string): Promise<RunListRow[]>;
+    /**
+     * `(status, origin)` counts for the runs matching the same tag/tenant/attribute predicates as
+     * `GET runs`. This is what lets that listing be PAGED at all: the page bounds what the console
+     * renders, this bounds nothing and keeps its status and origin chips exact.
+     *
+     * `status`, `origin` and the page bounds are deliberately NOT accepted — they are the axes being
+     * counted, so narrowing by them would report the answer back to itself.
+     */
+    facets(workflow?: string, tag?: string, attr?: string | string[], namespace?: string): Promise<_dudousxd_nestjs_durable_core.RunFacetRow[]>;
     /** Prometheus-text metrics (runs/steps by outcome, per-workflow counts) for a scrape. */
     metrics(): Promise<string>;
     /** Per-group worker health (queue backlog + live worker heartbeats) for the Workers panel. */
@@ -232,7 +256,7 @@ declare class DurableApiController {
      * The filter takes the SAME params as `GET runs` and is parsed identically, so "retry all" acts on
      * exactly the set the operator was looking at rather than a wider one.
      */
-    bulk(action: 'retry' | 'cancel', status?: RunStatus, tag?: string, workflow?: string, attr?: string | string[], compensate?: string, namespace?: string, origin?: string): Promise<{
+    bulk(action: 'retry' | 'cancel', status?: RunStatus, tag?: string, workflow?: string, attr?: string | string[], compensate?: string, namespace?: string, origin?: string, unattributed?: string): Promise<{
         matched: number;
         applied: number;
     }>;

package/dist/server/index.js

@@ -101,6 +101,11 @@ var DashboardService = class {
   listRuns(query) {
     return this.gateway.listRuns(query);
   }
+  /** `(status, origin)` counts over the same predicates {@link listRuns} pages — what keeps the
+  *  console's chips exact while its list is bounded to a page. */
+  runFacets(query) {
+    return this.gateway.runFacets(query);
+  }
   /** This deployment's durable role (control plane vs tenant) + tenant name — for the dashboard header
   *  badge. Routes through the gateway, which knows its own topology (store-backed = operator, proxy =
   *  tenant). Works on both topologies (no store/engine needed). */
@@ -246,6 +251,13 @@ function parseAttrFilters(attr) {
 }
 __name(parseAttrFilters, "parseAttrFilters");
 
+// src/server/run-list-row.ts
+function toRunListRow(run) {
+  const { input: _input, output: _output, error: _error, ...row } = run;
+  return row;
+}
+__name(toRunListRow, "toRunListRow");
+
 // src/server/durable-api.controller.ts
 function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -264,6 +276,41 @@ function _ts_param2(paramIndex, decorator) {
   };
 }
 __name(_ts_param2, "_ts_param");
+function pageBounds(limit, offset) {
+  const bound = /* @__PURE__ */ __name((raw) => {
+    const n = Number(raw);
+    return raw !== void 0 && raw !== "" && Number.isInteger(n) && n >= 0 ? n : void 0;
+  }, "bound");
+  const l = bound(limit);
+  const o = bound(offset);
+  return {
+    ...l !== void 0 ? {
+      limit: l
+    } : {},
+    ...o !== void 0 ? {
+      offset: o
+    } : {}
+  };
+}
+__name(pageBounds, "pageBounds");
+function statusPredicate(status) {
+  if (Array.isArray(status)) return status.length ? {
+    statuses: status
+  } : {};
+  return status ? {
+    status
+  } : {};
+}
+__name(statusPredicate, "statusPredicate");
+function originPredicate(origin, unattributed) {
+  if (unattributed === "true" || unattributed === "1") return {
+    origin: null
+  };
+  return origin ? {
+    origin
+  } : {};
+}
+__name(originPredicate, "originPredicate");
 var DurableApiController = class {
   static {
     __name(this, "DurableApiController");
@@ -280,14 +327,32 @@ var DurableApiController = class {
   * A blank param (`?namespace=`, from a cleared filter box) is the same as an absent one; passing
   * `''` through would be an exact match on a tenant nobody has, i.e. a silently empty console.
   */
-  runs(status, workflow, tag, attr, namespace, origin) {
-    return this.dashboard.listRuns({
-      status,
+  async runs(status, workflow, tag, attr, namespace, origin, unattributed, limit, offset) {
+    const runs = await this.dashboard.listRuns({
+      ...statusPredicate(status),
       workflow,
       tag,
       attributes: parseAttrFilters(attr),
       namespace: namespace || void 0,
-      origin: origin || void 0
+      ...originPredicate(origin, unattributed),
+      ...pageBounds(limit, offset)
+    });
+    return runs.map(toRunListRow);
+  }
+  /**
+  * `(status, origin)` counts for the runs matching the same tag/tenant/attribute predicates as
+  * `GET runs`. This is what lets that listing be PAGED at all: the page bounds what the console
+  * renders, this bounds nothing and keeps its status and origin chips exact.
+  *
+  * `status`, `origin` and the page bounds are deliberately NOT accepted — they are the axes being
+  * counted, so narrowing by them would report the answer back to itself.
+  */
+  facets(workflow, tag, attr, namespace) {
+    return this.dashboard.runFacets({
+      workflow,
+      tag,
+      attributes: parseAttrFilters(attr),
+      namespace: namespace || void 0
     });
   }
   /** Prometheus-text metrics (runs/steps by outcome, per-workflow counts) for a scrape. */
@@ -324,14 +389,17 @@ var DurableApiController = class {
   * The filter takes the SAME params as `GET runs` and is parsed identically, so "retry all" acts on
   * exactly the set the operator was looking at rather than a wider one.
   */
-  bulk(action, status, tag, workflow, attr, compensate, namespace, origin) {
+  bulk(action, status, tag, workflow, attr, compensate, namespace, origin, unattributed) {
     return this.dashboard.bulk(action === "cancel" ? "cancel" : "retry", {
       status,
       tag,
       workflow,
       attributes: parseAttrFilters(attr),
       namespace: namespace || void 0,
-      origin: origin || void 0
+      // The unattributed bucket is a scope a console can actually SELECT, so a bulk action launched
+      // under it must be narrowed to it. Dropping the param would widen a retry/cancel to every
+      // origin — acting on runs the operator was not looking at.
+      ...originPredicate(origin, unattributed)
     }, {
       compensate: compensate === "true"
     });
@@ -382,17 +450,38 @@ _ts_decorate2([
   _ts_param2(3, Query("attr")),
   _ts_param2(4, Query("namespace")),
   _ts_param2(5, Query("origin")),
+  _ts_param2(6, Query("unattributed")),
+  _ts_param2(7, Query("limit")),
+  _ts_param2(8, Query("offset")),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
-    typeof RunStatus === "undefined" ? Object : RunStatus,
+    Object,
     String,
     String,
     Object,
     String,
+    String,
+    String,
+    String,
     String
   ]),
-  _ts_metadata2("design:returntype", void 0)
+  _ts_metadata2("design:returntype", Promise)
 ], DurableApiController.prototype, "runs", null);
+_ts_decorate2([
+  Get("runs/facets"),
+  _ts_param2(0, Query("workflow")),
+  _ts_param2(1, Query("tag")),
+  _ts_param2(2, Query("attr")),
+  _ts_param2(3, Query("namespace")),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    String,
+    String,
+    Object,
+    String
+  ]),
+  _ts_metadata2("design:returntype", void 0)
+], DurableApiController.prototype, "facets", null);
 _ts_decorate2([
   Get("metrics"),
   Header("Content-Type", "text/plain; version=0.0.4"),
@@ -460,6 +549,7 @@ _ts_decorate2([
   _ts_param2(5, Query("compensate")),
   _ts_param2(6, Query("namespace")),
   _ts_param2(7, Query("origin")),
+  _ts_param2(8, Query("unattributed")),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     String,
@@ -469,6 +559,7 @@ _ts_decorate2([
     Object,
     String,
     String,
+    String,
     String
   ]),
   _ts_metadata2("design:returntype", void 0)