@dudousxd/nestjs-durable 0.42.0 → 0.43.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, RunFacetQuery, RunFacetRow, 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, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, 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';
@@ -900,6 +900,9 @@ declare class ProxyRunGateway implements RunGateway {
     listRuns(query: RunQuery): Promise<RunListItem[]>;
     /** Counted on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys. */
     runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
+    /** Enumerated on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys —
+     *  so a tenant's pickers offer its own tenants/tags/attributes and never another's. */
+    runValueFacets(axis: RunValueAxis, query: RunFacetQuery, opts?: RunValueFacetOptions): Promise<RunValueFacetRow[]>;
     /** 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
@@ -1000,6 +1003,14 @@ declare class StoreRunGateway implements RunGateway {
      * listing — correct, but the unbounded read this exists to avoid, so it is the last resort.
      */
     runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
+    /**
+     * The distinct values behind a console's pickers, straight off the store's enumeration. A store
+     * without one answers `[]` rather than falling back to a listing: unlike the facet counts above —
+     * where a full listing is at least the RIGHT answer expensively — a picker built from an unbounded
+     * scan would be the same unbounded read on every keystroke, for a control whose free-text entry
+     * still works without it.
+     */
+    runValueFacets(axis: RunValueAxis, query: RunFacetQuery, opts?: RunValueFacetOptions): Promise<RunValueFacetRow[]>;
     /**
      * 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, RunFacetQuery, RunFacetRow, 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, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, 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';
@@ -900,6 +900,9 @@ declare class ProxyRunGateway implements RunGateway {
     listRuns(query: RunQuery): Promise<RunListItem[]>;
     /** Counted on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys. */
     runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
+    /** Enumerated on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys —
+     *  so a tenant's pickers offer its own tenants/tags/attributes and never another's. */
+    runValueFacets(axis: RunValueAxis, query: RunFacetQuery, opts?: RunValueFacetOptions): Promise<RunValueFacetRow[]>;
     /** 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
@@ -1000,6 +1003,14 @@ declare class StoreRunGateway implements RunGateway {
      * listing — correct, but the unbounded read this exists to avoid, so it is the last resort.
      */
     runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
+    /**
+     * The distinct values behind a console's pickers, straight off the store's enumeration. A store
+     * without one answers `[]` rather than falling back to a listing: unlike the facet counts above —
+     * where a full listing is at least the RIGHT answer expensively — a picker built from an unbounded
+     * scan would be the same unbounded read on every keystroke, for a control whose free-text entry
+     * still works without it.
+     */
+    runValueFacets(axis: RunValueAxis, query: RunFacetQuery, opts?: RunValueFacetOptions): Promise<RunValueFacetRow[]>;
     /**
      * 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

@@ -577,6 +577,9 @@ function unavailableRunGateway() {
     runFacets(_query) {
       return tenantGatewayUnavailable("runFacets");
     },
+    runValueFacets(_axis, _query, _opts) {
+      return tenantGatewayUnavailable("runValueFacets");
+    },
     waitingFor(_runIds) {
       return tenantGatewayUnavailable("waitingFor");
     },
@@ -1006,6 +1009,16 @@ var ProxyRunGateway = class {
       query
     });
   }
+  /** Enumerated on the operator, over the same tenant-scoped predicates its `listRuns` reply obeys —
+  *  so a tenant's pickers offer its own tenants/tags/attributes and never another's. */
+  runValueFacets(axis, query, opts) {
+    return this.request({
+      kind: "runValueFacets",
+      axis,
+      query,
+      opts
+    });
+  }
   /** Round-trips to the operator, which scopes the result to this tenant's own `@<tenant>` groups. */
   workerHealth() {
     return this.request({
@@ -1235,6 +1248,19 @@ var RunRequestResponder = class {
         }
       };
     }
+    if (body.kind === "runValueFacets") {
+      const data = await this.gateway.runValueFacets(body.axis, {
+        ...body.query,
+        namespace: msg.tenant
+      }, body.opts);
+      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}`));
@@ -1401,6 +1427,16 @@ var StoreRunGateway = class {
     })));
   }
   /**
+  * The distinct values behind a console's pickers, straight off the store's enumeration. A store
+  * without one answers `[]` rather than falling back to a listing: unlike the facet counts above —
+  * where a full listing is at least the RIGHT answer expensively — a picker built from an unbounded
+  * scan would be the same unbounded read on every keystroke, for a control whose free-text entry
+  * still works without it.
+  */
+  async runValueFacets(axis, query, opts) {
+    return this.store.runValueFacets?.(axis, query, opts) ?? [];
+  }
+  /**
   * 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