@dudousxd/nestjs-durable 0.40.0 → 0.42.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
+import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
 export { AttributeFilter, EngineEvent, InferSearchAttributes, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, SearchAttributesSchema, StepCheckpoint, StepEvent, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowHandler, WorkflowRun, readSearchAttributes } from '@dudousxd/nestjs-durable-core';
 import { z } from 'zod';
 import { ConcurrencyOption, StartRunDeps, RunRedisWorkerOptions, RunningWorker, DurableWorkerRuntime } from '@dudousxd/durable-worker';
@@ -898,6 +898,8 @@ declare class ProxyRunGateway implements RunGateway {
     /** The control plane's `StoreRunGateway` resolves each run's `waiting` descriptor; the reply carries
      *  it through as plain JSON, so a tenant's list rows name the wait too. */
     listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /** Counted on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys. */
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /** Round-trips to the operator, which scopes the result to this tenant's own `@<tenant>` groups. */
     workerHealth(): Promise<GroupHealth[]>;
     /** Bulk, one request for the whole id list (like `listRuns`, not one request per id). The operator
@@ -991,6 +993,13 @@ declare class StoreRunGateway implements RunGateway {
     topology(): DurableTopology;
     getRunDetail(runId: string): Promise<RunDetail | null>;
     listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /**
+     * The `(status, origin)` counts behind a console's chips, straight off the store's aggregate. The
+     * console needs this precisely BECAUSE its list is paginated: the page bounds what is rendered,
+     * these counts stay whole-set exact. A store with no aggregate falls back to counting a full
+     * listing — correct, but the unbounded read this exists to avoid, so it is the last resort.
+     */
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /**
      * Bulk-resolve what each of `runIds` is currently parked on — for a consumer with its own filtered/
      * paginated run listing (e.g. "which of MY suspended runs are stuck at a breakpoint") without

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
+import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
 export { AttributeFilter, EngineEvent, InferSearchAttributes, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, SearchAttributesSchema, StepCheckpoint, StepEvent, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowHandler, WorkflowRun, readSearchAttributes } from '@dudousxd/nestjs-durable-core';
 import { z } from 'zod';
 import { ConcurrencyOption, StartRunDeps, RunRedisWorkerOptions, RunningWorker, DurableWorkerRuntime } from '@dudousxd/durable-worker';
@@ -898,6 +898,8 @@ declare class ProxyRunGateway implements RunGateway {
     /** The control plane's `StoreRunGateway` resolves each run's `waiting` descriptor; the reply carries
      *  it through as plain JSON, so a tenant's list rows name the wait too. */
     listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /** Counted on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys. */
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /** Round-trips to the operator, which scopes the result to this tenant's own `@<tenant>` groups. */
     workerHealth(): Promise<GroupHealth[]>;
     /** Bulk, one request for the whole id list (like `listRuns`, not one request per id). The operator
@@ -991,6 +993,13 @@ declare class StoreRunGateway implements RunGateway {
     topology(): DurableTopology;
     getRunDetail(runId: string): Promise<RunDetail | null>;
     listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /**
+     * The `(status, origin)` counts behind a console's chips, straight off the store's aggregate. The
+     * console needs this precisely BECAUSE its list is paginated: the page bounds what is rendered,
+     * these counts stay whole-set exact. A store with no aggregate falls back to counting a full
+     * listing — correct, but the unbounded read this exists to avoid, so it is the last resort.
+     */
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /**
      * Bulk-resolve what each of `runIds` is currently parked on — for a consumer with its own filtered/
      * paginated run listing (e.g. "which of MY suspended runs are stuck at a breakpoint") without

package/dist/index.js

@@ -419,7 +419,15 @@ var ThinWorkflowRegistrar = class {
   }
   onModuleInit() {
     if (!isPureThinWorker(this.options)) return;
-    scanWorkflows(this.discovery, (meta, instance) => this.runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input)));
+    scanWorkflows(this.discovery, (meta, instance, origin) => this.runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input), {
+      version: meta.version,
+      ...meta.requires !== void 0 ? {
+        requires: meta.requires
+      } : {},
+      ...origin !== void 0 ? {
+        origin
+      } : {}
+    }));
   }
 };
 ThinWorkflowRegistrar = _ts_decorate2([
@@ -566,6 +574,9 @@ function unavailableRunGateway() {
     listRuns(_query) {
       return tenantGatewayUnavailable("listRuns");
     },
+    runFacets(_query) {
+      return tenantGatewayUnavailable("runFacets");
+    },
     waitingFor(_runIds) {
       return tenantGatewayUnavailable("waitingFor");
     },
@@ -813,7 +824,15 @@ var InAppWorkerBootstrap = class {
   }
   onModuleInit() {
     if (!isCoLocatedWorker(this.options)) return;
-    scanWorkflows(this.discovery, (meta, instance) => this.runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input)));
+    scanWorkflows(this.discovery, (meta, instance, origin) => this.runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input), {
+      version: meta.version,
+      ...meta.requires !== void 0 ? {
+        requires: meta.requires
+      } : {},
+      ...origin !== void 0 ? {
+        origin
+      } : {}
+    }));
     scanSteps(this.discovery, this.metadataScanner, (meta, handler) => this.runtime.registerStep(meta.name, handler));
   }
   async onApplicationBootstrap() {
@@ -980,6 +999,13 @@ var ProxyRunGateway = class {
       query
     });
   }
+  /** Counted on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys. */
+  runFacets(query) {
+    return this.request({
+      kind: "runFacets",
+      query
+    });
+  }
   /** Round-trips to the operator, which scopes the result to this tenant's own `@<tenant>` groups. */
   workerHealth() {
     return this.request({
@@ -1196,6 +1222,19 @@ var RunRequestResponder = class {
         }
       };
     }
+    if (body.kind === "runFacets") {
+      const data = await this.gateway.runFacets({
+        ...body.query,
+        namespace: msg.tenant
+      });
+      return {
+        requestId: msg.requestId,
+        result: {
+          ok: true,
+          data
+        }
+      };
+    }
     if (body.kind === "workerHealth") {
       const all = await this.gateway.workerHealth();
       const data = all.filter((h) => h.group.endsWith(`@${msg.tenant}`));
@@ -1288,7 +1327,7 @@ var RunRequestResponder = class {
 };
 
 // src/store-run-gateway.ts
-import { STATE_STORE_CANONICAL as STATE_STORE_CANONICAL2, WorkflowEngine as WorkflowEngine2, indexWaitersByRun, resolveRunWaiting } from "@dudousxd/nestjs-durable-core";
+import { STATE_STORE_CANONICAL as STATE_STORE_CANONICAL2, WorkflowEngine as WorkflowEngine2, indexWaitersByRun, mergeRunFacetRows, resolveRunWaiting } from "@dudousxd/nestjs-durable-core";
 import { Inject as Inject5, Injectable as Injectable8 } from "@nestjs/common";
 function _ts_decorate8(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -1347,6 +1386,21 @@ var StoreRunGateway = class {
     });
   }
   /**
+  * The `(status, origin)` counts behind a console's chips, straight off the store's aggregate. The
+  * console needs this precisely BECAUSE its list is paginated: the page bounds what is rendered,
+  * these counts stay whole-set exact. A store with no aggregate falls back to counting a full
+  * listing — correct, but the unbounded read this exists to avoid, so it is the last resort.
+  */
+  async runFacets(query) {
+    if (this.store.runFacets) return this.store.runFacets(query);
+    const runs = await this.store.listRuns(query);
+    return mergeRunFacetRows(runs.map((r) => ({
+      status: r.status,
+      origin: r.origin,
+      count: 1
+    })));
+  }
+  /**
   * Bulk-resolve what each of `runIds` is currently parked on — for a consumer with its own filtered/
   * paginated run listing (e.g. "which of MY suspended runs are stuck at a breakpoint") without
   * re-deriving `listRuns`' waiter scan or querying `durable_step_checkpoints` directly. Mirrors