@scenario-labs/sdk 0.2.0 → 1.0.0

package/lib/workflow.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.mjs","sourceRoot":"","sources":["../src/lib/workflow.ts"],"names":[],"mappings":"OAEO,EACL,SAAS,GAMV;OACM,EAAgB,UAAU,EAAE;AAKnC;;;;;;;;;;;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,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"}
+{"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;AAO/B;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,cAAc;IAGzB,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;;;;;OAKG;IACH,GAAG,CAED,MAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,gEAAgE;IAChE,MAAM,CAAC,IAAI,CACT,MAAgB,EAChB,IAAuC;QAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,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,OAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvE,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_import_validator.d.mts

@@ -0,0 +1,40 @@
+export declare class WorkflowImportError extends Error {
+    constructor(message: string);
+}
+export type WorkflowEditorNodeType = 'text' | 'asset' | 'model' | 'llm' | 'transformText' | 'splitText' | 'ifElse' | 'groupItems' | 'sliceAssets' | 'forEach' | 'forEachEnd' | 'stickyNote';
+export declare const VALID_EDITOR_NODE_TYPES: readonly WorkflowEditorNodeType[];
+export interface WorkflowExportData {
+    version: '1.0';
+    name: string;
+    description: string;
+    editorInfo: {
+        nodes: Array<{
+            type: WorkflowEditorNodeType;
+            [key: string]: unknown;
+        }>;
+        edges: Array<{
+            [key: string]: unknown;
+        }>;
+        inputKeys: string[];
+    };
+    inputs: unknown[];
+    tagSet: string[];
+    uiConfig?: object;
+    exportedAt: string;
+    exportedBy: string;
+}
+/**
+ * Validates a workflow export payload (e.g. from a JSON file import).
+ *
+ * Throws a `WorkflowImportError` with a human-readable message on the first
+ * violation found. Returns the validated data cast to `WorkflowExportData`.
+ *
+ * Checks performed:
+ *  1. Data is a non-null object
+ *  2. `version` field is present and equals "1.0"
+ *  3. `editorInfo` has non-empty `nodes` and `edges` arrays
+ *  4. Each node's `type` is a recognized editor node type
+ *  5. `inputs` is an array
+ */
+export declare function validateEditorInfo(data: unknown): WorkflowExportData;
+//# sourceMappingURL=workflow_import_validator.d.mts.map

package/lib/workflow_import_validator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_import_validator.d.mts","sourceRoot":"","sources":["../src/lib/workflow_import_validator.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,OAAO,GACP,OAAO,GACP,KAAK,GACL,eAAe,GACf,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,SAAS,GACT,YAAY,GACZ,YAAY,CAAC;AAEjB,eAAO,MAAM,uBAAuB,EAAE,SAAS,sBAAsB,EAapE,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,sBAAsB,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QACvE,KAAK,EAAE,KAAK,CAAC;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QACzC,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAsCpE"}

package/lib/workflow_import_validator.d.ts

@@ -0,0 +1,40 @@
+export declare class WorkflowImportError extends Error {
+    constructor(message: string);
+}
+export type WorkflowEditorNodeType = 'text' | 'asset' | 'model' | 'llm' | 'transformText' | 'splitText' | 'ifElse' | 'groupItems' | 'sliceAssets' | 'forEach' | 'forEachEnd' | 'stickyNote';
+export declare const VALID_EDITOR_NODE_TYPES: readonly WorkflowEditorNodeType[];
+export interface WorkflowExportData {
+    version: '1.0';
+    name: string;
+    description: string;
+    editorInfo: {
+        nodes: Array<{
+            type: WorkflowEditorNodeType;
+            [key: string]: unknown;
+        }>;
+        edges: Array<{
+            [key: string]: unknown;
+        }>;
+        inputKeys: string[];
+    };
+    inputs: unknown[];
+    tagSet: string[];
+    uiConfig?: object;
+    exportedAt: string;
+    exportedBy: string;
+}
+/**
+ * Validates a workflow export payload (e.g. from a JSON file import).
+ *
+ * Throws a `WorkflowImportError` with a human-readable message on the first
+ * violation found. Returns the validated data cast to `WorkflowExportData`.
+ *
+ * Checks performed:
+ *  1. Data is a non-null object
+ *  2. `version` field is present and equals "1.0"
+ *  3. `editorInfo` has non-empty `nodes` and `edges` arrays
+ *  4. Each node's `type` is a recognized editor node type
+ *  5. `inputs` is an array
+ */
+export declare function validateEditorInfo(data: unknown): WorkflowExportData;
+//# sourceMappingURL=workflow_import_validator.d.ts.map

package/lib/workflow_import_validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_import_validator.d.ts","sourceRoot":"","sources":["../src/lib/workflow_import_validator.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,OAAO,GACP,OAAO,GACP,KAAK,GACL,eAAe,GACf,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,SAAS,GACT,YAAY,GACZ,YAAY,CAAC;AAEjB,eAAO,MAAM,uBAAuB,EAAE,SAAS,sBAAsB,EAapE,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,sBAAsB,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QACvE,KAAK,EAAE,KAAK,CAAC;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QACzC,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAsCpE"}

package/lib/workflow_import_validator.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_EDITOR_NODE_TYPES = exports.WorkflowImportError = void 0;
+exports.validateEditorInfo = validateEditorInfo;
+class WorkflowImportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowImportError';
+    }
+}
+exports.WorkflowImportError = WorkflowImportError;
+exports.VALID_EDITOR_NODE_TYPES = [
+    'text',
+    'asset',
+    'model',
+    'llm',
+    'transformText',
+    'splitText',
+    'ifElse',
+    'groupItems',
+    'sliceAssets',
+    'forEach',
+    'forEachEnd',
+    'stickyNote',
+];
+/**
+ * Validates a workflow export payload (e.g. from a JSON file import).
+ *
+ * Throws a `WorkflowImportError` with a human-readable message on the first
+ * violation found. Returns the validated data cast to `WorkflowExportData`.
+ *
+ * Checks performed:
+ *  1. Data is a non-null object
+ *  2. `version` field is present and equals "1.0"
+ *  3. `editorInfo` has non-empty `nodes` and `edges` arrays
+ *  4. Each node's `type` is a recognized editor node type
+ *  5. `inputs` is an array
+ */
+function validateEditorInfo(data) {
+    if (typeof data !== 'object' || data === null) {
+        throw new WorkflowImportError('Invalid JSON format');
+    }
+    const workflow = data;
+    if (!workflow.version) {
+        throw new WorkflowImportError('Missing version field');
+    }
+    if (workflow.version !== '1.0') {
+        throw new WorkflowImportError(`Unsupported version: ${workflow.version}`);
+    }
+    if (!workflow.editorInfo || !workflow.editorInfo.nodes || !workflow.editorInfo.edges) {
+        throw new WorkflowImportError('Missing editorInfo structure');
+    }
+    if (!Array.isArray(workflow.editorInfo.nodes)) {
+        throw new WorkflowImportError('Invalid nodes array');
+    }
+    if (!Array.isArray(workflow.editorInfo.edges)) {
+        throw new WorkflowImportError('Invalid edges array');
+    }
+    if (!workflow.inputs || !Array.isArray(workflow.inputs)) {
+        throw new WorkflowImportError('Invalid inputs array');
+    }
+    for (const node of workflow.editorInfo.nodes) {
+        if (!exports.VALID_EDITOR_NODE_TYPES.includes(node.type)) {
+            throw new WorkflowImportError(`Invalid node type: ${node.type}`);
+        }
+    }
+    return workflow;
+}
+//# sourceMappingURL=workflow_import_validator.js.map

package/lib/workflow_import_validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_import_validator.js","sourceRoot":"","sources":["../src/lib/workflow_import_validator.ts"],"names":[],"mappings":";;;AAiEA,gDAsCC;AAvGD,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAgBY,QAAA,uBAAuB,GAAsC;IACxE,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,eAAe;IACf,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,SAAS;IACT,YAAY;IACZ,YAAY;CACb,CAAC;AAkBF;;;;;;;;;;;;GAYG;AACH,SAAgB,kBAAkB,CAAC,IAAa;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAmC,CAAC;IAErD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACrF,MAAM,IAAI,mBAAmB,CAAC,8BAA8B,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC7C,IAAI,CAAE,+BAA6C,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,OAAO,QAA8B,CAAC;AACxC,CAAC"}

package/lib/workflow_import_validator.mjs

@@ -0,0 +1,64 @@
+export class WorkflowImportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowImportError';
+    }
+}
+export const VALID_EDITOR_NODE_TYPES = [
+    'text',
+    'asset',
+    'model',
+    'llm',
+    'transformText',
+    'splitText',
+    'ifElse',
+    'groupItems',
+    'sliceAssets',
+    'forEach',
+    'forEachEnd',
+    'stickyNote',
+];
+/**
+ * Validates a workflow export payload (e.g. from a JSON file import).
+ *
+ * Throws a `WorkflowImportError` with a human-readable message on the first
+ * violation found. Returns the validated data cast to `WorkflowExportData`.
+ *
+ * Checks performed:
+ *  1. Data is a non-null object
+ *  2. `version` field is present and equals "1.0"
+ *  3. `editorInfo` has non-empty `nodes` and `edges` arrays
+ *  4. Each node's `type` is a recognized editor node type
+ *  5. `inputs` is an array
+ */
+export function validateEditorInfo(data) {
+    if (typeof data !== 'object' || data === null) {
+        throw new WorkflowImportError('Invalid JSON format');
+    }
+    const workflow = data;
+    if (!workflow.version) {
+        throw new WorkflowImportError('Missing version field');
+    }
+    if (workflow.version !== '1.0') {
+        throw new WorkflowImportError(`Unsupported version: ${workflow.version}`);
+    }
+    if (!workflow.editorInfo || !workflow.editorInfo.nodes || !workflow.editorInfo.edges) {
+        throw new WorkflowImportError('Missing editorInfo structure');
+    }
+    if (!Array.isArray(workflow.editorInfo.nodes)) {
+        throw new WorkflowImportError('Invalid nodes array');
+    }
+    if (!Array.isArray(workflow.editorInfo.edges)) {
+        throw new WorkflowImportError('Invalid edges array');
+    }
+    if (!workflow.inputs || !Array.isArray(workflow.inputs)) {
+        throw new WorkflowImportError('Invalid inputs array');
+    }
+    for (const node of workflow.editorInfo.nodes) {
+        if (!VALID_EDITOR_NODE_TYPES.includes(node.type)) {
+            throw new WorkflowImportError(`Invalid node type: ${node.type}`);
+        }
+    }
+    return workflow;
+}
+//# sourceMappingURL=workflow_import_validator.mjs.map

package/lib/workflow_import_validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_import_validator.mjs","sourceRoot":"","sources":["../src/lib/workflow_import_validator.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAgBD,MAAM,CAAC,MAAM,uBAAuB,GAAsC;IACxE,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,eAAe;IACf,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,SAAS;IACT,YAAY;IACZ,YAAY;CACb,CAAC;AAkBF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAmC,CAAC;IAErD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACrF,MAAM,IAAI,mBAAmB,CAAC,8BAA8B,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC7C,IAAI,CAAE,uBAA6C,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,OAAO,QAA8B,CAAC;AACxC,CAAC"}

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,6 +1,6 @@
 {
   "name": "@scenario-labs/sdk",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "The official TypeScript library for the Scenario API",
   "author": "Scenario <support@scenario.com>",
   "types": "./index.d.ts",
@@ -91,6 +91,16 @@
       "import": "./lib/*.mjs",
       "require": "./lib/*.js"
     },
+    "./pagination": {
+      "import": "./pagination.mjs",
+      "require": "./pagination.js"
+    },
+    "./pagination.js": {
+      "default": "./pagination.js"
+    },
+    "./pagination.mjs": {
+      "default": "./pagination.mjs"
+    },
     "./resource": {
       "import": "./resource.mjs",
       "require": "./resource.js"

package/pagination.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/pagination.mjs";
+//# sourceMappingURL=pagination.d.mts.map

package/pagination.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.mts","sourceRoot":"","sources":["src/pagination.ts"],"names":[],"mappings":""}

package/pagination.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/pagination.js";
+//# sourceMappingURL=pagination.d.ts.map

package/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["src/pagination.ts"],"names":[],"mappings":""}

package/pagination.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/pagination instead */
+tslib_1.__exportStar(require("./core/pagination.js"), exports);
+//# sourceMappingURL=pagination.js.map

package/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["src/pagination.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,+DAAkC"}

package/pagination.mjs

@@ -0,0 +1,2 @@
+export * from "./core/pagination.mjs";
+//# sourceMappingURL=pagination.mjs.map

package/pagination.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.mjs","sourceRoot":"","sources":["src/pagination.ts"],"names":[],"mappings":""}