@scenario-labs/sdk 0.1.3 → 0.3.0

package/lib/workflow.mjs

@@ -0,0 +1,62 @@
+import { Workflows, } from "../resources/workflows.mjs";
+import { enhanceJob } from "./job.mjs";
+import { validateWorkflowFlow } from "./workflow_validator.mjs";
+/**
+ * Enhanced workflow object with helper methods.
+ * Has all original workflow fields plus `findNode()`, `getNodesByType()`.
+ *
+ * @example
+ * ```ts
+ * const response = await client.workflows.retrieve(workflowId);
+ * response.workflow.findNode('final_image');
+ * response.workflow.getNodesByType('custom-model');
+ * response.workflow.name; // original fields still work
+ * ```
+ */
+export class WorkflowEntity {
+    /** Find a node in the workflow definition by ID. */
+    findNode(nodeId) {
+        return this.flow.find((node) => node.id === nodeId);
+    }
+    /** Get all nodes of a specific type from the workflow definition. */
+    getNodesByType(type) {
+        return this.flow.filter((node) => node.type === type);
+    }
+    /**
+     * Validate the structural integrity of a workflow flow.
+     * Throws an `Error` with a human-readable message on the first violation found.
+     */
+    validate() {
+        validateWorkflowFlow(this.flow);
+    }
+    /** @internal Create a WorkflowEntity from raw workflow data. */
+    static from(data) {
+        return Object.assign(Object.create(WorkflowEntity.prototype), data);
+    }
+}
+/**
+ * Enhanced Workflows resource.
+ * Extends the generated {@link Workflows} — all original methods are inherited.
+ * Overrides `retrieve()`, `run()`, and `approveUser()` to return enriched response objects.
+ */
+export class EnhancedWorkflows extends Workflows {
+    /**
+     * Get workflow by ID. Returns an enhanced response where `workflow` has
+     * `findNode()`, `getNodesByType()`, and `validate()`.
+     */
+    retrieve(workflowID, options) {
+        return super.retrieve(workflowID, options)._thenUnwrap((data) => ({
+            ...data,
+            workflow: WorkflowEntity.from(data.workflow),
+        }));
+    }
+    /** Run a workflow. Returns an enhanced response where `job` has `.wait()`. */
+    run(workflowID, params, options) {
+        return enhanceJob(this._client, super.run(workflowID, params, options));
+    }
+    /** Approve a user approval node. Returns an enhanced response where `job` has `.wait()`. */
+    approveUser(workflowID, body, options) {
+        return enhanceJob(this._client, super.approveUser(workflowID, body, options));
+    }
+}
+//# sourceMappingURL=workflow.mjs.map

package/lib/workflow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.mjs","sourceRoot":"","sources":["../src/lib/workflow.ts"],"names":[],"mappings":"OAEO,EACL,SAAS,GAMV;OACM,EAAgB,UAAU,EAAE;OAC5B,EAAE,oBAAoB,EAAE;AAK/B;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAc;IACzB,oDAAoD;IACpD,QAAQ,CAEN,MAAc;QAEd,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,qEAAqE;IACrE,cAAc,CAA2D,IAAc;QACrF,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,gEAAgE;IAChE,MAAM,CAAC,IAAI,CAAC,IAAuC;QACjD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;CACF;AAOD;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C;;;OAGG;IACM,QAAQ,CACf,UAAkB,EAClB,OAAwB;QAExB,OAAO,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChE,GAAG,IAAI;YACP,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC7C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,8EAA8E;IACrE,GAAG,CACV,UAAkB,EAClB,MAAyB,EACzB,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,4FAA4F;IACnF,WAAW,CAClB,UAAkB,EAClB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,CAAC;CACF"}

package/lib/workflow_validator.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Validates the structural integrity of a workflow flow (array of nodes).
+ *
+ * Throws an `Error` with a human-readable message on the first violation found.
+ *
+ * Checks performed:
+ *  1. Every node has a non-empty string `id`
+ *  2. Node IDs are unique within the flow
+ *  3. Every node `type` is a recognized workflow node type
+ *  4. Per-type required fields:
+ *       - custom-model → modelId
+ *       - workflow     → workflowId
+ *       - logic        → logicType
+ *       - for-each     → loopBodyNodeIds (non-empty) OR count (>0)
+ *  5. Cross-references all point to node IDs that exist in the flow:
+ *       - dependsOn entries
+ *       - input ref.node (excluding "workflow" which is a reserved keyword)
+ *       - input ref.conditional entries
+ *       - loopBodyNodeIds entries
+ */
+export declare function validateWorkflowFlow(flow: unknown[]): void;
+//# sourceMappingURL=workflow_validator.d.mts.map

package/lib/workflow_validator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_validator.d.mts","sourceRoot":"","sources":["../src/lib/workflow_validator.ts"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CA4E1D"}

package/lib/workflow_validator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Validates the structural integrity of a workflow flow (array of nodes).
+ *
+ * Throws an `Error` with a human-readable message on the first violation found.
+ *
+ * Checks performed:
+ *  1. Every node has a non-empty string `id`
+ *  2. Node IDs are unique within the flow
+ *  3. Every node `type` is a recognized workflow node type
+ *  4. Per-type required fields:
+ *       - custom-model → modelId
+ *       - workflow     → workflowId
+ *       - logic        → logicType
+ *       - for-each     → loopBodyNodeIds (non-empty) OR count (>0)
+ *  5. Cross-references all point to node IDs that exist in the flow:
+ *       - dependsOn entries
+ *       - input ref.node (excluding "workflow" which is a reserved keyword)
+ *       - input ref.conditional entries
+ *       - loopBodyNodeIds entries
+ */
+export declare function validateWorkflowFlow(flow: unknown[]): void;
+//# sourceMappingURL=workflow_validator.d.ts.map

package/lib/workflow_validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_validator.d.ts","sourceRoot":"","sources":["../src/lib/workflow_validator.ts"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CA4E1D"}

package/lib/workflow_validator.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWorkflowFlow = validateWorkflowFlow;
+const VALID_NODE_TYPES = new Set([
+    'custom-model',
+    'for-each',
+    'generate-prompt',
+    'list',
+    'logic',
+    'model',
+    'remove-background',
+    'transform',
+    'user-approval',
+    'workflow',
+]);
+/**
+ * Validates the structural integrity of a workflow flow (array of nodes).
+ *
+ * Throws an `Error` with a human-readable message on the first violation found.
+ *
+ * Checks performed:
+ *  1. Every node has a non-empty string `id`
+ *  2. Node IDs are unique within the flow
+ *  3. Every node `type` is a recognized workflow node type
+ *  4. Per-type required fields:
+ *       - custom-model → modelId
+ *       - workflow     → workflowId
+ *       - logic        → logicType
+ *       - for-each     → loopBodyNodeIds (non-empty) OR count (>0)
+ *  5. Cross-references all point to node IDs that exist in the flow:
+ *       - dependsOn entries
+ *       - input ref.node (excluding "workflow" which is a reserved keyword)
+ *       - input ref.conditional entries
+ *       - loopBodyNodeIds entries
+ */
+function validateWorkflowFlow(flow) {
+    const nodeIds = new Set();
+    const firstSeenAt = new Map();
+    // Pass 1 — per-node checks (ID, type, required fields)
+    for (let i = 0; i < flow.length; i++) {
+        const node = flow[i];
+        if (typeof node.id !== 'string' || !node.id) {
+            throw new Error(`Node at index ${i} is missing an "id" field`);
+        }
+        if (nodeIds.has(node.id)) {
+            throw new Error(`Duplicate node id "${node.id}" at index ${i} (first seen at index ${firstSeenAt.get(node.id)})`);
+        }
+        nodeIds.add(node.id);
+        firstSeenAt.set(node.id, i);
+        const label = `"${node.id}"`;
+        if (typeof node.type !== 'string' || !VALID_NODE_TYPES.has(node.type)) {
+            throw new Error(`Node ${label} has invalid type "${node.type}". Valid types are: ${[...VALID_NODE_TYPES].join(', ')}`);
+        }
+        const type = node.type;
+        if (type === 'custom-model' && !node.modelId) {
+            throw new Error(`Node ${label} (custom-model) is missing required field "modelId"`);
+        }
+        if (type === 'workflow' && !node.workflowId) {
+            throw new Error(`Node ${label} (workflow) is missing required field "workflowId"`);
+        }
+        if (type === 'logic' && !node.logicType) {
+            throw new Error(`Node ${label} (logic) is missing required field "logicType"`);
+        }
+        if (type === 'for-each') {
+            const hasLoopBody = Array.isArray(node.loopBodyNodeIds) && node.loopBodyNodeIds.length > 0;
+            const hasCount = typeof node.count === 'number' && node.count > 0;
+            if (!hasLoopBody && !hasCount) {
+                throw new Error(`Node ${label} (for-each) requires either "loopBodyNodeIds" (non-empty array) or "count" (positive number)`);
+            }
+        }
+    }
+    // Pass 2 — cross-reference checks (all node IDs are now collected)
+    for (const rawNode of flow) {
+        const node = rawNode;
+        const nodeId = node.id;
+        if (Array.isArray(node.dependsOn)) {
+            for (const depId of node.dependsOn) {
+                if (typeof depId === 'string' && !nodeIds.has(depId)) {
+                    throw new Error(`Node "${nodeId}" dependsOn unknown node "${depId}"`);
+                }
+            }
+        }
+        if (Array.isArray(node.inputs)) {
+            for (const input of node.inputs) {
+                validateInputRefs(nodeId, input, nodeIds);
+            }
+        }
+        if (Array.isArray(node.loopBodyNodeIds)) {
+            for (const bodyId of node.loopBodyNodeIds) {
+                if (typeof bodyId === 'string' && !nodeIds.has(bodyId)) {
+                    throw new Error(`Node "${nodeId}" loopBodyNodeIds references unknown node "${bodyId}"`);
+                }
+            }
+        }
+    }
+}
+function validateInputRefs(nodeId, input, nodeIds) {
+    const inputName = typeof input.name === 'string' && input.name ? input.name : '(unnamed)';
+    if (input.ref) {
+        const { node: refNode, conditional } = input.ref;
+        // "workflow" is a reserved keyword meaning "take from the workflow's own inputs"
+        if (typeof refNode === 'string' && refNode !== 'workflow' && !nodeIds.has(refNode)) {
+            throw new Error(`Node "${nodeId}" input "${inputName}" references unknown node "${refNode}"`);
+        }
+        if (Array.isArray(conditional)) {
+            for (const condId of conditional) {
+                if (typeof condId === 'string' && !nodeIds.has(condId)) {
+                    throw new Error(`Node "${nodeId}" input "${inputName}" has a conditional ref pointing to unknown node "${condId}"`);
+                }
+            }
+        }
+    }
+    // Recurse into INPUTS_ARRAY sub-inputs
+    if (Array.isArray(input.items)) {
+        for (const item of input.items) {
+            if (Array.isArray(item)) {
+                for (const subInput of item) {
+                    validateInputRefs(nodeId, subInput, nodeIds);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=workflow_validator.js.map

package/lib/workflow_validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_validator.js","sourceRoot":"","sources":["../src/lib/workflow_validator.ts"],"names":[],"mappings":"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"}

package/lib/workflow_validator.mjs

@@ -0,0 +1,121 @@
+const VALID_NODE_TYPES = new Set([
+    'custom-model',
+    'for-each',
+    'generate-prompt',
+    'list',
+    'logic',
+    'model',
+    'remove-background',
+    'transform',
+    'user-approval',
+    'workflow',
+]);
+/**
+ * Validates the structural integrity of a workflow flow (array of nodes).
+ *
+ * Throws an `Error` with a human-readable message on the first violation found.
+ *
+ * Checks performed:
+ *  1. Every node has a non-empty string `id`
+ *  2. Node IDs are unique within the flow
+ *  3. Every node `type` is a recognized workflow node type
+ *  4. Per-type required fields:
+ *       - custom-model → modelId
+ *       - workflow     → workflowId
+ *       - logic        → logicType
+ *       - for-each     → loopBodyNodeIds (non-empty) OR count (>0)
+ *  5. Cross-references all point to node IDs that exist in the flow:
+ *       - dependsOn entries
+ *       - input ref.node (excluding "workflow" which is a reserved keyword)
+ *       - input ref.conditional entries
+ *       - loopBodyNodeIds entries
+ */
+export function validateWorkflowFlow(flow) {
+    const nodeIds = new Set();
+    const firstSeenAt = new Map();
+    // Pass 1 — per-node checks (ID, type, required fields)
+    for (let i = 0; i < flow.length; i++) {
+        const node = flow[i];
+        if (typeof node.id !== 'string' || !node.id) {
+            throw new Error(`Node at index ${i} is missing an "id" field`);
+        }
+        if (nodeIds.has(node.id)) {
+            throw new Error(`Duplicate node id "${node.id}" at index ${i} (first seen at index ${firstSeenAt.get(node.id)})`);
+        }
+        nodeIds.add(node.id);
+        firstSeenAt.set(node.id, i);
+        const label = `"${node.id}"`;
+        if (typeof node.type !== 'string' || !VALID_NODE_TYPES.has(node.type)) {
+            throw new Error(`Node ${label} has invalid type "${node.type}". Valid types are: ${[...VALID_NODE_TYPES].join(', ')}`);
+        }
+        const type = node.type;
+        if (type === 'custom-model' && !node.modelId) {
+            throw new Error(`Node ${label} (custom-model) is missing required field "modelId"`);
+        }
+        if (type === 'workflow' && !node.workflowId) {
+            throw new Error(`Node ${label} (workflow) is missing required field "workflowId"`);
+        }
+        if (type === 'logic' && !node.logicType) {
+            throw new Error(`Node ${label} (logic) is missing required field "logicType"`);
+        }
+        if (type === 'for-each') {
+            const hasLoopBody = Array.isArray(node.loopBodyNodeIds) && node.loopBodyNodeIds.length > 0;
+            const hasCount = typeof node.count === 'number' && node.count > 0;
+            if (!hasLoopBody && !hasCount) {
+                throw new Error(`Node ${label} (for-each) requires either "loopBodyNodeIds" (non-empty array) or "count" (positive number)`);
+            }
+        }
+    }
+    // Pass 2 — cross-reference checks (all node IDs are now collected)
+    for (const rawNode of flow) {
+        const node = rawNode;
+        const nodeId = node.id;
+        if (Array.isArray(node.dependsOn)) {
+            for (const depId of node.dependsOn) {
+                if (typeof depId === 'string' && !nodeIds.has(depId)) {
+                    throw new Error(`Node "${nodeId}" dependsOn unknown node "${depId}"`);
+                }
+            }
+        }
+        if (Array.isArray(node.inputs)) {
+            for (const input of node.inputs) {
+                validateInputRefs(nodeId, input, nodeIds);
+            }
+        }
+        if (Array.isArray(node.loopBodyNodeIds)) {
+            for (const bodyId of node.loopBodyNodeIds) {
+                if (typeof bodyId === 'string' && !nodeIds.has(bodyId)) {
+                    throw new Error(`Node "${nodeId}" loopBodyNodeIds references unknown node "${bodyId}"`);
+                }
+            }
+        }
+    }
+}
+function validateInputRefs(nodeId, input, nodeIds) {
+    const inputName = typeof input.name === 'string' && input.name ? input.name : '(unnamed)';
+    if (input.ref) {
+        const { node: refNode, conditional } = input.ref;
+        // "workflow" is a reserved keyword meaning "take from the workflow's own inputs"
+        if (typeof refNode === 'string' && refNode !== 'workflow' && !nodeIds.has(refNode)) {
+            throw new Error(`Node "${nodeId}" input "${inputName}" references unknown node "${refNode}"`);
+        }
+        if (Array.isArray(conditional)) {
+            for (const condId of conditional) {
+                if (typeof condId === 'string' && !nodeIds.has(condId)) {
+                    throw new Error(`Node "${nodeId}" input "${inputName}" has a conditional ref pointing to unknown node "${condId}"`);
+                }
+            }
+        }
+    }
+    // Recurse into INPUTS_ARRAY sub-inputs
+    if (Array.isArray(input.items)) {
+        for (const item of input.items) {
+            if (Array.isArray(item)) {
+                for (const subInput of item) {
+                    validateInputRefs(nodeId, subInput, nodeIds);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=workflow_validator.mjs.map

package/lib/workflow_validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_validator.mjs","sourceRoot":"","sources":["../src/lib/workflow_validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@scenario-labs/sdk",
-  "version": "0.1.3",
-  "description": "The official TypeScript library for the Scenario SDK API",
-  "author": "Scenario SDK <support@scenario.com>",
+  "version": "0.3.0",
+  "description": "The official TypeScript library for the Scenario API",
+  "author": "Scenario <support@scenario.com>",
   "types": "./index.d.ts",
   "main": "./index.js",
   "type": "commonjs",
@@ -81,6 +81,16 @@
     "./index.mjs": {
       "default": "./index.mjs"
     },
+    "./lib/*.mjs": {
+      "default": "./lib/*.mjs"
+    },
+    "./lib/*.js": {
+      "default": "./lib/*.js"
+    },
+    "./lib/*": {
+      "import": "./lib/*.mjs",
+      "require": "./lib/*.js"
+    },
     "./resource": {
       "import": "./resource.mjs",
       "require": "./resource.js"