@dudousxd/nestjs-durable-dashboard 0.49.0 → 0.50.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, ScheduleListQuery, ScheduleDescription, RunResult, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, DurableTopology, GroupHealth, RunDetail, UpdateResult, EngineEvent, AttributeFilter } from '@dudousxd/nestjs-durable-core';
+import { RunGateway, StateStore, WorkflowEngine, ScheduleListQuery, ScheduleDescription, RunResult, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, DurableTopology, GroupHealth, RunDetailOptions, RunDetail, FanPageQuery, FanPage, UpdateResult, EngineEvent, AttributeFilter } from '@dudousxd/nestjs-durable-core';
 export { RunDetail } from '@dudousxd/nestjs-durable-core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
@@ -164,7 +164,9 @@ declare class DashboardService {
      *  gateway so it works on BOTH topologies: the control plane returns every group; a tenant proxies
      *  to the operator, which scopes the result to the tenant's own `@<tenant>` groups. */
     workerHealth(): Promise<GroupHealth[]>;
-    getRunDetail(runId: string): Promise<RunDetail | null>;
+    getRunDetail(runId: string, options?: RunDetailOptions): Promise<RunDetail | null>;
+    /** A page of one fan's members, or null when the run is unknown or the gateway can't page fans. */
+    getFanMembers(runId: string, group: string, query: FanPageQuery): Promise<FanPage | null>;
     /** Fix-and-replay a dead/failed run with a corrected input — a fresh linked run. Returns its id. */
     retryWithInput(runId: string, input: unknown): Promise<{
         runId: string;
@@ -314,7 +316,13 @@ declare class DurableApiController {
     triggerSchedule(id: string): Promise<_dudousxd_nestjs_durable_core.RunResult>;
     /** This deployment's durable role (control plane vs tenant) + tenant name — for the header badge. */
     topology(): _dudousxd_nestjs_durable_core.DurableTopology;
-    run(id: string): Promise<_dudousxd_nestjs_durable_core.RunDetail>;
+    /**
+     * A run's detail. Fans wider than {@link FAN_INLINE_MAX} come back as one `FanSummary` each, their
+     * members paged by `runs/:id/fans/:group`; `?full=true` returns every checkpoint instead.
+     */
+    run(id: string, full?: string): Promise<_dudousxd_nestjs_durable_core.RunDetail>;
+    /** One page of a summarized fan's members, in seq order. */
+    fanMembers(id: string, group: string, offset?: string, limit?: string, failed?: string): Promise<_dudousxd_nestjs_durable_core.FanPage>;
     /** Server-Sent Events stream of a run's live lifecycle events — the dashboard tails it instead
      *  of polling. Cross-pod when the transport has a control plane (see DashboardService.streamRun). */
     stream(id: string): rxjs.Observable<{

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, ScheduleListQuery, ScheduleDescription, RunResult, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, DurableTopology, GroupHealth, RunDetail, UpdateResult, EngineEvent, AttributeFilter } from '@dudousxd/nestjs-durable-core';
+import { RunGateway, StateStore, WorkflowEngine, ScheduleListQuery, ScheduleDescription, RunResult, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, DurableTopology, GroupHealth, RunDetailOptions, RunDetail, FanPageQuery, FanPage, UpdateResult, EngineEvent, AttributeFilter } from '@dudousxd/nestjs-durable-core';
 export { RunDetail } from '@dudousxd/nestjs-durable-core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
@@ -164,7 +164,9 @@ declare class DashboardService {
      *  gateway so it works on BOTH topologies: the control plane returns every group; a tenant proxies
      *  to the operator, which scopes the result to the tenant's own `@<tenant>` groups. */
     workerHealth(): Promise<GroupHealth[]>;
-    getRunDetail(runId: string): Promise<RunDetail | null>;
+    getRunDetail(runId: string, options?: RunDetailOptions): Promise<RunDetail | null>;
+    /** A page of one fan's members, or null when the run is unknown or the gateway can't page fans. */
+    getFanMembers(runId: string, group: string, query: FanPageQuery): Promise<FanPage | null>;
     /** Fix-and-replay a dead/failed run with a corrected input — a fresh linked run. Returns its id. */
     retryWithInput(runId: string, input: unknown): Promise<{
         runId: string;
@@ -314,7 +316,13 @@ declare class DurableApiController {
     triggerSchedule(id: string): Promise<_dudousxd_nestjs_durable_core.RunResult>;
     /** This deployment's durable role (control plane vs tenant) + tenant name — for the header badge. */
     topology(): _dudousxd_nestjs_durable_core.DurableTopology;
-    run(id: string): Promise<_dudousxd_nestjs_durable_core.RunDetail>;
+    /**
+     * A run's detail. Fans wider than {@link FAN_INLINE_MAX} come back as one `FanSummary` each, their
+     * members paged by `runs/:id/fans/:group`; `?full=true` returns every checkpoint instead.
+     */
+    run(id: string, full?: string): Promise<_dudousxd_nestjs_durable_core.RunDetail>;
+    /** One page of a summarized fan's members, in seq order. */
+    fanMembers(id: string, group: string, offset?: string, limit?: string, failed?: string): Promise<_dudousxd_nestjs_durable_core.FanPage>;
     /** Server-Sent Events stream of a run's live lifecycle events — the dashboard tails it instead
      *  of polling. Cross-pod when the transport has a control plane (see DashboardService.streamRun). */
     stream(id: string): rxjs.Observable<{

package/dist/server/index.js

@@ -155,8 +155,12 @@ var DashboardService = class {
   async workerHealth() {
     return this.gateway.workerHealth();
   }
-  getRunDetail(runId) {
-    return this.gateway.getRunDetail(runId);
+  getRunDetail(runId, options) {
+    return this.gateway.getRunDetail(runId, options);
+  }
+  /** A page of one fan's members, or null when the run is unknown or the gateway can't page fans. */
+  async getFanMembers(runId, group, query) {
+    return await this.gateway.getFanMembers?.(runId, group, query) ?? null;
   }
   /** Fix-and-replay a dead/failed run with a corrected input — a fresh linked run. Returns its id. */
   retryWithInput(runId, input) {
@@ -961,6 +965,7 @@ function _ts_param2(paramIndex, decorator) {
   };
 }
 __name(_ts_param2, "_ts_param");
+var FAN_INLINE_MAX = 50;
 var DurableApiController = class {
   static {
     __name(this, "DurableApiController");
@@ -1059,11 +1064,27 @@ var DurableApiController = class {
   topology() {
     return this.dashboard.topology();
   }
-  async run(id) {
-    const detail = await this.dashboard.getRunDetail(id);
+  /**
+  * A run's detail. Fans wider than {@link FAN_INLINE_MAX} come back as one `FanSummary` each, their
+  * members paged by `runs/:id/fans/:group`; `?full=true` returns every checkpoint instead.
+  */
+  async run(id, full) {
+    const detail = await this.dashboard.getRunDetail(id, full === "true" ? void 0 : {
+      summarizeFansOver: FAN_INLINE_MAX
+    });
     if (!detail) throw new NotFoundException(`run ${id} not found`);
     return detail;
   }
+  /** One page of a summarized fan's members, in seq order. */
+  async fanMembers(id, group, offset, limit, failed) {
+    const page2 = await this.dashboard.getFanMembers(id, group, {
+      offset: offset === void 0 ? void 0 : Number(offset),
+      limit: limit === void 0 ? void 0 : Number(limit),
+      failedOnly: failed === "true"
+    });
+    if (!page2) throw new NotFoundException(`fan ${group} of run ${id} not found`);
+    return page2;
+  }
   /** Server-Sent Events stream of a run's live lifecycle events — the dashboard tails it instead
   *  of polling. Cross-pod when the transport has a control plane (see DashboardService.streamRun). */
   stream(id) {
@@ -1218,12 +1239,31 @@ _ts_decorate4([
 _ts_decorate4([
   Get("runs/:id"),
   _ts_param2(0, Param("id")),
+  _ts_param2(1, Query("full")),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
+    String,
     String
   ]),
   _ts_metadata4("design:returntype", Promise)
 ], DurableApiController.prototype, "run", null);
+_ts_decorate4([
+  Get("runs/:id/fans/:group"),
+  _ts_param2(0, Param("id")),
+  _ts_param2(1, Param("group")),
+  _ts_param2(2, Query("offset")),
+  _ts_param2(3, Query("limit")),
+  _ts_param2(4, Query("failed")),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
+    String,
+    String,
+    String,
+    String,
+    String
+  ]),
+  _ts_metadata4("design:returntype", Promise)
+], DurableApiController.prototype, "fanMembers", null);
 _ts_decorate4([
   Sse("runs/:id/stream"),
   _ts_param2(0, Param("id")),