@nanobpm/urban 0.53.0 → 0.55.0

package/src/runtime/engine/nanosdk.test.ts

@@ -231,6 +231,24 @@ test("searchUserTasks forwards a caller-provided lifecycle state filter", async
   assert.equal(input?.filter?.processInstanceKey, "pi");
 });
 
+test("openUserTasks pins state=CREATED onto the underlying search", async () => {
+  let input: { filter?: Record<string, unknown> } | undefined;
+  const client = fakeSdkClient({
+    searchUserTasks: async (i) => {
+      input = i;
+      return { items: [{ userTaskKey: 9, elementId: "approve" }] };
+    },
+  });
+  const engine = new SdkEngineClient(client);
+  const tasks = await engine.openUserTasks({ processInstanceKey: "pi" });
+  // openUserTasks is the safe accessor: it derives from searchUserTasks with state pinned to
+  // CREATED, so a completed/canceled task can never surface through it. The caller's other
+  // selectors pass through unchanged.
+  assert.equal(input?.filter?.state, "CREATED", "openUserTasks pins state=CREATED");
+  assert.equal(input?.filter?.processInstanceKey, "pi");
+  assert.deepEqual(tasks, [{ userTaskKey: "9", elementId: "approve", variables: undefined }]);
+});
+
 test("searchUserTasks surfaces the resolved form linkage", async () => {
   const client = fakeSdkClient({
     searchUserTasks: async () => ({

package/src/runtime/engine/nanosdk.ts

@@ -20,6 +20,7 @@ import type {
   ProcessInstanceState,
   UserTaskState,
   UserTaskSummary,
+  UserTaskFilter,
   WorkerSubscription,
 } from "../core/host.ts";
 import { isBpmnError } from "../core/host.ts";
@@ -230,10 +231,7 @@ export class SdkEngineClient implements EngineClient {
     });
   }
 
-  async searchUserTasks(filter?: {
-    processInstanceKey?: string;
-    assignee?: string;
-    candidateGroup?: string;
+  async searchUserTasks(filter?: UserTaskFilter & {
     state?: UserTaskState;
   }): Promise<UserTaskSummary[]> {
     // User tasks are an eventually consistent read; ask for zero-wait consistency so
@@ -261,6 +259,13 @@ export class SdkEngineClient implements EngineClient {
     });
   }
 
+  /** The open (answerable) user tasks — `searchUserTasks` pinned to `state: "CREATED"`.
+   *  The single safe accessor for reconcile/affordance paths (see `EngineClient.openUserTasks`);
+   *  derives from `searchUserTasks` so the two cannot drift. */
+  openUserTasks(filter?: UserTaskFilter): Promise<UserTaskSummary[]> {
+    return this.searchUserTasks({ ...filter, state: "CREATED" });
+  }
+
   async getForm(input: { formKey?: string; formId?: string }): Promise<FormSchema | null> {
     // The engine addresses deployed forms by key (`GET /forms/{formKey}`). A user task's
     // `formKey` is the engine's resolution of its `formId` linkage to the latest deployed

package/src/runtime/index.ts

@@ -95,6 +95,7 @@ export type {
   SqliteDb,
   UserTaskState,
   UserTaskSummary,
+  UserTaskFilter,
   WatchHandle,
   WorkerSubscription,
 } from "./core/host.ts";