@dudousxd/nestjs-durable-dashboard 0.49.0 → 0.51.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,26 @@ 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.
+     *
+     * When the gateway can version the detail without reading it, the response carries an `ETag`, and
+     * a poll whose `If-None-Match` still names it gets a 304 before the timeline is read. The browser
+     * sends that header itself (the response is `no-cache`), so a console poll needs no code for it.
+     */
+    run(id: string, full?: string, ifNoneMatch?: string, response?: unknown): Promise<{
+        run: _dudousxd_nestjs_durable_core.WorkflowRun;
+        timeline: _dudousxd_nestjs_durable_core.StepCheckpoint[];
+        children: string[];
+        fans?: _dudousxd_nestjs_durable_core.FanSummary[] | undefined;
+        childCount?: number | undefined;
+    }>;
+    /** One page of a summarized fan's members, in seq order. Versioned like {@link run}. */
+    fanMembers(id: string, group: string, offset?: string, limit?: string, failed?: string, ifNoneMatch?: string, response?: unknown): Promise<{
+        items: _dudousxd_nestjs_durable_core.StepCheckpoint[];
+        total: number;
+    }>;
     /** 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,26 @@ 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.
+     *
+     * When the gateway can version the detail without reading it, the response carries an `ETag`, and
+     * a poll whose `If-None-Match` still names it gets a 304 before the timeline is read. The browser
+     * sends that header itself (the response is `no-cache`), so a console poll needs no code for it.
+     */
+    run(id: string, full?: string, ifNoneMatch?: string, response?: unknown): Promise<{
+        run: _dudousxd_nestjs_durable_core.WorkflowRun;
+        timeline: _dudousxd_nestjs_durable_core.StepCheckpoint[];
+        children: string[];
+        fans?: _dudousxd_nestjs_durable_core.FanSummary[] | undefined;
+        childCount?: number | undefined;
+    }>;
+    /** One page of a summarized fan's members, in seq order. Versioned like {@link run}. */
+    fanMembers(id: string, group: string, offset?: string, limit?: string, failed?: string, ifNoneMatch?: string, response?: unknown): Promise<{
+        items: _dudousxd_nestjs_durable_core.StepCheckpoint[];
+        total: number;
+    }>;
     /** 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<{