@unboundcx/sdk 4.13.108 → 4.13.110

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.108",
+  "version": "4.13.110",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/workflows.js

@@ -97,6 +97,30 @@ export class WorkflowsService {
     return result;
   }
 
+  // Delete guard (soft-delete workflows / hard-delete draft versions):
+  // resolves everything a workflow (or a specific draft version) is
+  // referenced by, so the client can block the delete with a named list
+  // instead of a generic FK error. Exactly one of workflowId/
+  // workflowVersionId is expected.
+  async references({ workflowId, workflowVersionId } = {}) {
+    this.sdk.validateParams(
+      { workflowId, workflowVersionId },
+      {
+        workflowId: { type: 'string', required: false },
+        workflowVersionId: { type: 'string', required: false },
+      },
+    );
+
+    const query = {};
+    if (workflowId) query.workflowId = workflowId;
+    if (workflowVersionId) query.workflowVersionId = workflowVersionId;
+
+    const result = await internalRequest(this.sdk, '/workflows/references', 'GET', {
+      query,
+    });
+    return result;
+  }
+
   // P6 §6 — variable catalogue (inputs/system/context/module outputs) for
   // the designer's `{{` autocomplete + variables panel.
   async variables(versionId) {
@@ -519,4 +543,34 @@ export class WorkflowSessionsService {
     );
     return result;
   }
+
+  // P10 click-to-filter: GET /workflows/:workflowVersionId/sessions ->
+  // {sessionIds}. filter is {workflowItemId?, fromItemId?, toItemId?,
+  // startDate?, endDate?} -- workflowItemId alone, or fromItemId+toItemId
+  // together, is required (validated server-side in sessionsByPath.js).
+  async sessionsByPath(workflowVersionId, filter = {}) {
+    this.sdk.validateParams(
+      { workflowVersionId },
+      {
+        workflowVersionId: { type: 'string', required: true },
+      },
+    );
+
+    const { workflowItemId, fromItemId, toItemId, startDate, endDate } =
+      filter || {};
+    const query = {};
+    if (workflowItemId) query.workflowItemId = workflowItemId;
+    if (fromItemId) query.fromItemId = fromItemId;
+    if (toItemId) query.toItemId = toItemId;
+    if (startDate) query.startDate = startDate;
+    if (endDate) query.endDate = endDate;
+
+    const result = await internalRequest(
+      this.sdk,
+      `/workflows/${workflowVersionId}/sessions`,
+      'GET',
+      { query },
+    );
+    return result;
+  }
 }