@defai.digital/workflow-engine 13.0.3

package/dist/validation.js

@@ -0,0 +1,77 @@
+import { WorkflowSchema, } from '@defai.digital/contracts';
+import { WorkflowErrorCodes } from './types.js';
+/**
+ * Validation error for workflows
+ */
+export class WorkflowValidationError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'WorkflowValidationError';
+    }
+}
+/**
+ * Validates a workflow definition and checks invariants
+ * INV-WF-003: Schema strictness - unknown fields rejected
+ * INV-WF-004: Step ID uniqueness
+ */
+export function validateWorkflow(data) {
+    // Use strict parsing to reject unknown fields (INV-WF-003)
+    const strictSchema = WorkflowSchema.strict();
+    const result = strictSchema.safeParse(data);
+    if (!result.success) {
+        throw new WorkflowValidationError(WorkflowErrorCodes.VALIDATION_ERROR, `Workflow validation failed: ${result.error.message}`, { errors: result.error.errors });
+    }
+    const workflow = result.data;
+    // INV-WF-004: Check for duplicate step IDs
+    const stepIds = new Set();
+    for (const step of workflow.steps) {
+        if (stepIds.has(step.stepId)) {
+            throw new WorkflowValidationError(WorkflowErrorCodes.DUPLICATE_STEP_ID, `Duplicate step ID found: ${step.stepId}`, { stepId: step.stepId });
+        }
+        stepIds.add(step.stepId);
+    }
+    return workflow;
+}
+/**
+ * Deep freezes an object to make it immutable
+ * INV-WF-005: Workflow definitions must not be modified during execution
+ */
+function deepFreeze(obj) {
+    const propNames = Reflect.ownKeys(obj);
+    for (const name of propNames) {
+        const value = obj[name];
+        if (value !== null && typeof value === 'object') {
+            deepFreeze(value);
+        }
+    }
+    return Object.freeze(obj);
+}
+/**
+ * Prepares a workflow for execution by validating and freezing it
+ * INV-WF-003: Schema strictness
+ * INV-WF-004: Step ID uniqueness
+ * INV-WF-005: Immutable definition
+ */
+export function prepareWorkflow(data) {
+    const workflow = validateWorkflow(data);
+    // Collect step IDs
+    const stepIds = new Set(workflow.steps.map((s) => s.stepId));
+    // Deep freeze the workflow (INV-WF-005)
+    const frozenWorkflow = deepFreeze(structuredClone(workflow));
+    return {
+        workflow: frozenWorkflow,
+        stepIds,
+    };
+}
+/**
+ * Deep freezes a step result to ensure immutability
+ * This prevents subsequent steps from accidentally modifying previous results
+ */
+export function deepFreezeStepResult(result) {
+    return deepFreeze(structuredClone(result));
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAE9B;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,2DAA2D;IAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,uBAAuB,CAC/B,kBAAkB,CAAC,gBAAgB,EACnC,+BAA+B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EACrD,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAE7B,2CAA2C;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,uBAAuB,CAC/B,kBAAkB,CAAC,iBAAiB,EACpC,4BAA4B,IAAI,CAAC,MAAM,EAAE,EACzC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAmB,GAAM;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAgB,CAAC;IAEtD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,UAAU,CAAC,KAAe,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAExC,mBAAmB;IACnB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7D,wCAAwC;IACxC,MAAM,cAAc,GAAG,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE7D,OAAO;QACL,QAAQ,EAAE,cAAc;QACxB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@defai.digital/workflow-engine",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Workflow execution engine - executes workflows following contract invariants",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/workflow-engine"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "yaml": "^2.7.0",
+    "@defai.digital/contracts": "13.0.3"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}