@solidxai/core 0.1.12 → 0.1.13-beta.10

package/dist/services/workflow/workflow-definition-metadata-sync.service.js

@@ -0,0 +1,187 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var WorkflowDefinitionMetadataSyncService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowDefinitionMetadataSyncService = void 0;
+const common_1 = require("@nestjs/common");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const module_metadata_helper_service_1 = require("../../helpers/module-metadata-helper.service");
+let WorkflowDefinitionMetadataSyncService = WorkflowDefinitionMetadataSyncService_1 = class WorkflowDefinitionMetadataSyncService {
+    constructor(moduleMetadataHelperService) {
+        this.moduleMetadataHelperService = moduleMetadataHelperService;
+        this.logger = new common_1.Logger(WorkflowDefinitionMetadataSyncService_1.name);
+    }
+    async upsertWorkflowDefinition(workflowDefinition, previousWorkflowDefinition) {
+        const moduleName = workflowDefinition.moduleMetadata?.name;
+        if (!moduleName) {
+            this.logger.warn(`Skipping workflow metadata sync for ${workflowDefinition.key}: moduleMetadata relation is not loaded.`);
+            return;
+        }
+        if (previousWorkflowDefinition &&
+            (previousWorkflowDefinition.key !== workflowDefinition.key ||
+                previousWorkflowDefinition.moduleMetadata?.name !== moduleName)) {
+            await this.removeWorkflowDefinition(previousWorkflowDefinition);
+        }
+        const metadataFilePath = await this.getExistingMetadataFilePath(moduleName);
+        if (!metadataFilePath) {
+            return;
+        }
+        const metadata = await this.moduleMetadataHelperService.getModuleMetadataConfiguration(metadataFilePath);
+        if (!metadata) {
+            return;
+        }
+        const yamlRelativePath = this.getWorkflowYamlRelativePath(workflowDefinition.key);
+        const yamlFilePath = path.resolve(path.dirname(metadataFilePath), yamlRelativePath);
+        await fs.mkdir(path.dirname(yamlFilePath), { recursive: true });
+        await fs.writeFile(yamlFilePath, this.withTrailingNewline(workflowDefinition.definitionYaml ?? ''), 'utf8');
+        if (!Array.isArray(metadata.workflowDefinitions)) {
+            metadata.workflowDefinitions = [];
+        }
+        const entry = this.toMetadataEntry(workflowDefinition, moduleName, yamlRelativePath);
+        const existingIndex = metadata.workflowDefinitions.findIndex((definition) => definition.key === workflowDefinition.key);
+        if (existingIndex === -1) {
+            metadata.workflowDefinitions.push(entry);
+        }
+        else {
+            metadata.workflowDefinitions[existingIndex] = entry;
+        }
+        await this.writeMetadataFile(metadataFilePath, metadata);
+        this.logger.log(`Synced workflow definition ${workflowDefinition.key} to ${metadataFilePath}`);
+    }
+    async removeWorkflowDefinition(workflowDefinition) {
+        const moduleName = workflowDefinition.moduleMetadata?.name;
+        if (!moduleName) {
+            this.logger.warn(`Skipping workflow metadata removal for ${workflowDefinition.key}: moduleMetadata relation is not loaded.`);
+            return;
+        }
+        const metadataFilePath = await this.getExistingMetadataFilePath(moduleName);
+        if (!metadataFilePath) {
+            return;
+        }
+        const metadata = await this.moduleMetadataHelperService.getModuleMetadataConfiguration(metadataFilePath);
+        if (!metadata || !Array.isArray(metadata.workflowDefinitions)) {
+            return;
+        }
+        const existingEntry = metadata.workflowDefinitions.find((definition) => definition.key === workflowDefinition.key);
+        const previousLength = metadata.workflowDefinitions.length;
+        metadata.workflowDefinitions = metadata.workflowDefinitions.filter((definition) => definition.key !== workflowDefinition.key);
+        const yamlRelativePath = this.resolveWorkflowYamlReference(workflowDefinition, existingEntry);
+        if (yamlRelativePath) {
+            await this.removeYamlFile(path.resolve(path.dirname(metadataFilePath), yamlRelativePath));
+        }
+        if (metadata.workflowDefinitions.length !== previousLength) {
+            await this.writeMetadataFile(metadataFilePath, metadata);
+            this.logger.log(`Removed workflow definition ${workflowDefinition.key} from ${metadataFilePath}`);
+        }
+    }
+    async getExistingMetadataFilePath(moduleName) {
+        const metadataFilePath = await this.moduleMetadataHelperService.getModuleMetadataFilePath(moduleName);
+        try {
+            await fs.access(metadataFilePath);
+            return metadataFilePath;
+        }
+        catch {
+            this.logger.warn(`Skipping workflow metadata sync because metadata file was not found: ${metadataFilePath}`);
+            return null;
+        }
+    }
+    toMetadataEntry(workflowDefinition, moduleName, yamlRelativePath) {
+        const entry = {
+            key: workflowDefinition.key,
+            moduleUserKey: moduleName,
+            displayName: workflowDefinition.displayName,
+            definitionYaml: `file:${yamlRelativePath}`,
+        };
+        this.assignIfPresent(entry, 'namespace', workflowDefinition.namespace);
+        this.assignIfPresent(entry, 'description', workflowDefinition.description);
+        this.assignIfPresent(entry, 'status', workflowDefinition.status);
+        this.assignIfPresent(entry, 'definitionVersion', workflowDefinition.definitionVersion);
+        this.assignIfPresent(entry, 'tags', workflowDefinition.tags);
+        return entry;
+    }
+    assignIfPresent(target, key, value) {
+        if (value !== undefined && value !== null && value !== '') {
+            target[key] = value;
+        }
+    }
+    getWorkflowYamlRelativePath(workflowKey) {
+        return path.posix.join('workflows', `${this.safeWorkflowFileName(workflowKey)}.yaml`);
+    }
+    safeWorkflowFileName(workflowKey) {
+        return String(workflowKey ?? 'workflow')
+            .trim()
+            .replace(/[\\/]/g, '-')
+            .replace(/^\.+/, '')
+            || 'workflow';
+    }
+    resolveWorkflowYamlReference(workflowDefinition, metadataEntry) {
+        if (typeof metadataEntry?.definitionYaml === 'string' && metadataEntry.definitionYaml.startsWith('file:')) {
+            return metadataEntry.definitionYaml.slice('file:'.length).trim();
+        }
+        return this.getWorkflowYamlRelativePath(workflowDefinition.key);
+    }
+    async removeYamlFile(filePath) {
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error?.code !== 'ENOENT') {
+                this.logger.warn(`Unable to remove workflow YAML file ${filePath}: ${error?.message ?? String(error)}`);
+            }
+        }
+    }
+    async writeMetadataFile(metadataFilePath, metadata) {
+        await fs.writeFile(metadataFilePath, `${JSON.stringify(metadata, null, 2)}\n`, 'utf8');
+    }
+    withTrailingNewline(value) {
+        return value.endsWith('\n') ? value : `${value}\n`;
+    }
+};
+exports.WorkflowDefinitionMetadataSyncService = WorkflowDefinitionMetadataSyncService;
+exports.WorkflowDefinitionMetadataSyncService = WorkflowDefinitionMetadataSyncService = WorkflowDefinitionMetadataSyncService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [module_metadata_helper_service_1.ModuleMetadataHelperService])
+], WorkflowDefinitionMetadataSyncService);
+//# sourceMappingURL=workflow-definition-metadata-sync.service.js.map

package/dist/services/workflow/workflow-definition-metadata-sync.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-definition-metadata-sync.service.js","sourceRoot":"","sources":["../../../src/services/workflow/workflow-definition-metadata-sync.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, Logger } from '@nestjs/common';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport { WorkflowDefinition } from 'src/entities/workflow-definition.entity';\nimport { ModuleMetadataHelperService } from 'src/helpers/module-metadata-helper.service';\n\ntype WorkflowMetadataEntry = {\n  key: string;\n  moduleUserKey: string;\n  displayName: string;\n  namespace?: string;\n  description?: string;\n  status?: string;\n  definitionVersion?: string;\n  tags?: any;\n  definitionYaml: string;\n};\n\n@Injectable()\nexport class WorkflowDefinitionMetadataSyncService {\n  private readonly logger = new Logger(WorkflowDefinitionMetadataSyncService.name);\n\n  constructor(\n    private readonly moduleMetadataHelperService: ModuleMetadataHelperService,\n  ) {}\n\n  async upsertWorkflowDefinition(\n    workflowDefinition: WorkflowDefinition,\n    previousWorkflowDefinition?: WorkflowDefinition | null,\n  ): Promise<void> {\n    const moduleName = workflowDefinition.moduleMetadata?.name;\n    if (!moduleName) {\n      this.logger.warn(`Skipping workflow metadata sync for ${workflowDefinition.key}: moduleMetadata relation is not loaded.`);\n      return;\n    }\n\n    if (\n      previousWorkflowDefinition &&\n      (\n        previousWorkflowDefinition.key !== workflowDefinition.key ||\n        previousWorkflowDefinition.moduleMetadata?.name !== moduleName\n      )\n    ) {\n      await this.removeWorkflowDefinition(previousWorkflowDefinition);\n    }\n\n    const metadataFilePath = await this.getExistingMetadataFilePath(moduleName);\n    if (!metadataFilePath) {\n      return;\n    }\n\n    const metadata = await this.moduleMetadataHelperService.getModuleMetadataConfiguration(metadataFilePath);\n    if (!metadata) {\n      return;\n    }\n\n    const yamlRelativePath = this.getWorkflowYamlRelativePath(workflowDefinition.key);\n    const yamlFilePath = path.resolve(path.dirname(metadataFilePath), yamlRelativePath);\n\n    await fs.mkdir(path.dirname(yamlFilePath), { recursive: true });\n    await fs.writeFile(yamlFilePath, this.withTrailingNewline(workflowDefinition.definitionYaml ?? ''), 'utf8');\n\n    if (!Array.isArray(metadata.workflowDefinitions)) {\n      metadata.workflowDefinitions = [];\n    }\n\n    const entry = this.toMetadataEntry(workflowDefinition, moduleName, yamlRelativePath);\n    const existingIndex = metadata.workflowDefinitions.findIndex(\n      (definition: WorkflowMetadataEntry) => definition.key === workflowDefinition.key,\n    );\n\n    if (existingIndex === -1) {\n      metadata.workflowDefinitions.push(entry);\n    } else {\n      metadata.workflowDefinitions[existingIndex] = entry;\n    }\n\n    await this.writeMetadataFile(metadataFilePath, metadata);\n    this.logger.log(`Synced workflow definition ${workflowDefinition.key} to ${metadataFilePath}`);\n  }\n\n  async removeWorkflowDefinition(workflowDefinition: WorkflowDefinition): Promise<void> {\n    const moduleName = workflowDefinition.moduleMetadata?.name;\n    if (!moduleName) {\n      this.logger.warn(`Skipping workflow metadata removal for ${workflowDefinition.key}: moduleMetadata relation is not loaded.`);\n      return;\n    }\n\n    const metadataFilePath = await this.getExistingMetadataFilePath(moduleName);\n    if (!metadataFilePath) {\n      return;\n    }\n\n    const metadata = await this.moduleMetadataHelperService.getModuleMetadataConfiguration(metadataFilePath);\n    if (!metadata || !Array.isArray(metadata.workflowDefinitions)) {\n      return;\n    }\n\n    const existingEntry = metadata.workflowDefinitions.find(\n      (definition: WorkflowMetadataEntry) => definition.key === workflowDefinition.key,\n    );\n    const previousLength = metadata.workflowDefinitions.length;\n    metadata.workflowDefinitions = metadata.workflowDefinitions.filter(\n      (definition: WorkflowMetadataEntry) => definition.key !== workflowDefinition.key,\n    );\n\n    const yamlRelativePath = this.resolveWorkflowYamlReference(workflowDefinition, existingEntry);\n    if (yamlRelativePath) {\n      await this.removeYamlFile(path.resolve(path.dirname(metadataFilePath), yamlRelativePath));\n    }\n\n    if (metadata.workflowDefinitions.length !== previousLength) {\n      await this.writeMetadataFile(metadataFilePath, metadata);\n      this.logger.log(`Removed workflow definition ${workflowDefinition.key} from ${metadataFilePath}`);\n    }\n  }\n\n  private async getExistingMetadataFilePath(moduleName: string): Promise<string | null> {\n    const metadataFilePath = await this.moduleMetadataHelperService.getModuleMetadataFilePath(moduleName);\n    try {\n      await fs.access(metadataFilePath);\n      return metadataFilePath;\n    } catch {\n      this.logger.warn(`Skipping workflow metadata sync because metadata file was not found: ${metadataFilePath}`);\n      return null;\n    }\n  }\n\n  private toMetadataEntry(\n    workflowDefinition: WorkflowDefinition,\n    moduleName: string,\n    yamlRelativePath: string,\n  ): WorkflowMetadataEntry {\n    const entry: WorkflowMetadataEntry = {\n      key: workflowDefinition.key,\n      moduleUserKey: moduleName,\n      displayName: workflowDefinition.displayName,\n      definitionYaml: `file:${yamlRelativePath}`,\n    };\n\n    this.assignIfPresent(entry, 'namespace', workflowDefinition.namespace);\n    this.assignIfPresent(entry, 'description', workflowDefinition.description);\n    this.assignIfPresent(entry, 'status', workflowDefinition.status);\n    this.assignIfPresent(entry, 'definitionVersion', workflowDefinition.definitionVersion);\n    this.assignIfPresent(entry, 'tags', workflowDefinition.tags);\n\n    return entry;\n  }\n\n  private assignIfPresent(target: WorkflowMetadataEntry, key: keyof WorkflowMetadataEntry, value: any) {\n    if (value !== undefined && value !== null && value !== '') {\n      (target as any)[key] = value;\n    }\n  }\n\n  private getWorkflowYamlRelativePath(workflowKey: string) {\n    return path.posix.join('workflows', `${this.safeWorkflowFileName(workflowKey)}.yaml`);\n  }\n\n  private safeWorkflowFileName(workflowKey: string) {\n    return String(workflowKey ?? 'workflow')\n      .trim()\n      .replace(/[\\\\/]/g, '-')\n      .replace(/^\\.+/, '')\n      || 'workflow';\n  }\n\n  private resolveWorkflowYamlReference(\n    workflowDefinition: WorkflowDefinition,\n    metadataEntry?: WorkflowMetadataEntry,\n  ): string | null {\n    if (typeof metadataEntry?.definitionYaml === 'string' && metadataEntry.definitionYaml.startsWith('file:')) {\n      return metadataEntry.definitionYaml.slice('file:'.length).trim();\n    }\n\n    return this.getWorkflowYamlRelativePath(workflowDefinition.key);\n  }\n\n  private async removeYamlFile(filePath: string) {\n    try {\n      await fs.unlink(filePath);\n    } catch (error: any) {\n      if (error?.code !== 'ENOENT') {\n        this.logger.warn(`Unable to remove workflow YAML file ${filePath}: ${error?.message ?? String(error)}`);\n      }\n    }\n  }\n\n  private async writeMetadataFile(metadataFilePath: string, metadata: any) {\n    await fs.writeFile(metadataFilePath, `${JSON.stringify(metadata, null, 2)}\\n`, 'utf8');\n  }\n\n  private withTrailingNewline(value: string) {\n    return value.endsWith('\\n') ? value : `${value}\\n`;\n  }\n}\n"]}

package/dist/services/workflow/workflow-definition-validator.service.d.ts

@@ -0,0 +1,13 @@
+import { WorkflowDefinitionDsl } from '../../types/workflow-dsl.types';
+import { WorkflowNodeRegistryService } from './workflow-node-registry.service';
+export declare class WorkflowDefinitionValidatorService {
+    private readonly registry;
+    constructor(registry: WorkflowNodeRegistryService);
+    validate(definition: WorkflowDefinitionDsl): void;
+    private validateTriggers;
+    private validateTrigger;
+    private inputHasDefault;
+    private validateNodes;
+    private validateNode;
+}
+//# sourceMappingURL=workflow-definition-validator.service.d.ts.map

package/dist/services/workflow/workflow-definition-validator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-definition-validator.service.d.ts","sourceRoot":"","sources":["../../../src/services/workflow/workflow-definition-validator.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EAGtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E,qBACa,kCAAkC;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,2BAA2B;IAElE,QAAQ,CAAC,UAAU,EAAE,qBAAqB;IAwB1C,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,eAAe;IAwDvB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;CAqFrB"}

package/dist/services/workflow/workflow-definition-validator.service.js

@@ -0,0 +1,166 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowDefinitionValidatorService = void 0;
+const common_1 = require("@nestjs/common");
+const workflow_node_registry_service_1 = require("./workflow-node-registry.service");
+const cron_parser_1 = require("cron-parser");
+let WorkflowDefinitionValidatorService = class WorkflowDefinitionValidatorService {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    validate(definition) {
+        if (!definition || !Array.isArray(definition.nodes)) {
+            throw new common_1.BadRequestException('Workflow definition YAML must include a nodes array.');
+        }
+        if (definition.triggers !== undefined &&
+            definition.triggers !== null &&
+            !Array.isArray(definition.triggers)) {
+            throw new common_1.BadRequestException('Workflow definition triggers must be an array when provided.');
+        }
+        const nodeIds = new Set();
+        this.validateNodes(definition.nodes, nodeIds);
+        this.validateNodes(definition.errors ?? [], nodeIds);
+        this.validateNodes(definition.finally ?? [], nodeIds);
+        this.validateTriggers(definition);
+    }
+    validateTriggers(definition) {
+        const triggers = definition.triggers ?? [];
+        const triggerIds = new Set();
+        const activeScheduleTriggers = triggers.filter((trigger) => trigger?.type === 'schedule' && !trigger.disabled);
+        for (const trigger of triggers) {
+            this.validateTrigger(trigger, triggerIds);
+        }
+        if (!activeScheduleTriggers.length) {
+            return;
+        }
+        const inputs = definition.inputs ?? {};
+        for (const [inputKey, inputDefinition] of Object.entries(inputs)) {
+            if (!this.inputHasDefault(inputDefinition)) {
+                throw new common_1.BadRequestException(`Workflow input "${inputKey}" requires a default value before enabling a scheduled trigger.`);
+            }
+        }
+    }
+    validateTrigger(trigger, triggerIds) {
+        if (!trigger || typeof trigger !== 'object' || Array.isArray(trigger)) {
+            throw new common_1.BadRequestException('Every workflow trigger must be an object.');
+        }
+        if (!trigger.id) {
+            throw new common_1.BadRequestException('Every workflow trigger requires an id.');
+        }
+        if (triggerIds.has(trigger.id)) {
+            throw new common_1.BadRequestException(`Duplicate workflow trigger id "${trigger.id}".`);
+        }
+        triggerIds.add(trigger.id);
+        if (!['schedule', 'webhook'].includes(trigger.type)) {
+            throw new common_1.BadRequestException(`Workflow trigger "${trigger.id}" has unsupported type "${trigger.type}".`);
+        }
+        if (trigger.type === 'schedule') {
+            const cronExpression = trigger.configuration?.cronExpression ?? trigger.configuration?.cron;
+            if (!cronExpression || typeof cronExpression !== 'string') {
+                throw new common_1.BadRequestException(`Workflow trigger "${trigger.id}" requires a cron expression.`);
+            }
+            try {
+                cron_parser_1.CronExpressionParser.parse(cronExpression, {
+                    currentDate: new Date(),
+                    tz: trigger.configuration?.timezone ?? 'UTC',
+                });
+            }
+            catch (error) {
+                throw new common_1.BadRequestException(`Workflow trigger "${trigger.id}" has an invalid cron expression: ${error?.message ?? cronExpression}`);
+            }
+        }
+        if (trigger.type === 'webhook') {
+            const method = String(trigger.configuration?.method ?? 'POST').toUpperCase();
+            if (!['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(method)) {
+                throw new common_1.BadRequestException(`Workflow trigger "${trigger.id}" has unsupported webhook method "${method}".`);
+            }
+        }
+    }
+    inputHasDefault(inputDefinition) {
+        if (inputDefinition &&
+            typeof inputDefinition === 'object' &&
+            !Array.isArray(inputDefinition)) {
+            return (Object.prototype.hasOwnProperty.call(inputDefinition, 'default') &&
+                inputDefinition.default !== undefined &&
+                inputDefinition.default !== null);
+        }
+        return inputDefinition !== undefined && inputDefinition !== null;
+    }
+    validateNodes(nodes, nodeIds) {
+        for (const node of nodes) {
+            this.validateNode(node, nodeIds);
+        }
+    }
+    validateNode(node, nodeIds) {
+        if (!node || typeof node !== 'object' || Array.isArray(node)) {
+            throw new common_1.BadRequestException('Every workflow node must be an object.');
+        }
+        for (const unsupportedKey of ['children', 'branches', 'nodes']) {
+            if (Object.prototype.hasOwnProperty.call(node, unsupportedKey)) {
+                throw new common_1.BadRequestException(`Workflow node "${node.id ?? 'unknown'}" uses unsupported child key "${unsupportedKey}". Use "tasks", "then", "else", "defaults", "errors", or "cases" instead.`);
+            }
+        }
+        for (const childKey of ['tasks', 'then', 'else', 'defaults', 'errors']) {
+            const childValue = node[childKey];
+            if (childValue !== undefined &&
+                childValue !== null &&
+                !Array.isArray(childValue)) {
+                throw new common_1.BadRequestException(`Workflow node "${node.id ?? 'unknown'}" field "${childKey}" must be an array when provided.`);
+            }
+        }
+        if (node.cases !== undefined &&
+            node.cases !== null &&
+            (typeof node.cases !== 'object' || Array.isArray(node.cases))) {
+            throw new common_1.BadRequestException(`Workflow node "${node.id ?? 'unknown'}" field "cases" must be an object of arrays when provided.`);
+        }
+        if (node.cases && typeof node.cases === 'object') {
+            for (const [caseKey, caseNodes] of Object.entries(node.cases)) {
+                if (!Array.isArray(caseNodes)) {
+                    throw new common_1.BadRequestException(`Workflow node "${node.id ?? 'unknown'}" case "${caseKey}" must be an array.`);
+                }
+            }
+        }
+        if (!node.id) {
+            throw new common_1.BadRequestException('Every workflow node requires an id.');
+        }
+        if (nodeIds.has(node.id)) {
+            throw new common_1.BadRequestException(`Duplicate workflow node id "${node.id}".`);
+        }
+        nodeIds.add(node.id);
+        if (!node.kind) {
+            throw new common_1.BadRequestException(`Workflow node "${node.id}" requires kind.`);
+        }
+        if (!['task', 'control', 'subflow'].includes(node.kind)) {
+            throw new common_1.BadRequestException(`Workflow node "${node.id}" has unsupported kind "${node.kind}".`);
+        }
+        if (!node.type) {
+            throw new common_1.BadRequestException(`Workflow node "${node.id}" requires type.`);
+        }
+        if (!this.registry.has(node.type)) {
+            throw new common_1.BadRequestException(`Workflow node "${node.id}" uses unregistered type "${node.type}".`);
+        }
+        this.validateNodes(node.tasks ?? [], nodeIds);
+        this.validateNodes(node.then ?? [], nodeIds);
+        this.validateNodes(node.else ?? [], nodeIds);
+        this.validateNodes(node.defaults ?? [], nodeIds);
+        this.validateNodes(node.errors ?? [], nodeIds);
+        Object.values(node.cases ?? {}).forEach((caseNodes) => {
+            this.validateNodes(caseNodes, nodeIds);
+        });
+    }
+};
+exports.WorkflowDefinitionValidatorService = WorkflowDefinitionValidatorService;
+exports.WorkflowDefinitionValidatorService = WorkflowDefinitionValidatorService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [workflow_node_registry_service_1.WorkflowNodeRegistryService])
+], WorkflowDefinitionValidatorService);
+//# sourceMappingURL=workflow-definition-validator.service.js.map

package/dist/services/workflow/workflow-definition-validator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-definition-validator.service.js","sourceRoot":"","sources":["../../../src/services/workflow/workflow-definition-validator.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { BadRequestException, Injectable } from '@nestjs/common';\nimport {\n  WorkflowDefinitionDsl,\n  WorkflowNodeDefinition,\n  WorkflowTriggerDefinition,\n} from '../../types/workflow-dsl.types';\nimport { WorkflowNodeRegistryService } from './workflow-node-registry.service';\nimport { CronExpressionParser } from 'cron-parser';\n\n@Injectable()\nexport class WorkflowDefinitionValidatorService {\n  constructor(private readonly registry: WorkflowNodeRegistryService) {}\n\n  validate(definition: WorkflowDefinitionDsl) {\n    if (!definition || !Array.isArray(definition.nodes)) {\n      throw new BadRequestException(\n        'Workflow definition YAML must include a nodes array.',\n      );\n    }\n\n    if (\n      definition.triggers !== undefined &&\n      definition.triggers !== null &&\n      !Array.isArray(definition.triggers)\n    ) {\n      throw new BadRequestException(\n        'Workflow definition triggers must be an array when provided.',\n      );\n    }\n\n    const nodeIds = new Set<string>();\n    this.validateNodes(definition.nodes, nodeIds);\n    this.validateNodes(definition.errors ?? [], nodeIds);\n    this.validateNodes(definition.finally ?? [], nodeIds);\n    this.validateTriggers(definition);\n  }\n\n  private validateTriggers(definition: WorkflowDefinitionDsl) {\n    const triggers = definition.triggers ?? [];\n    const triggerIds = new Set<string>();\n    const activeScheduleTriggers = triggers.filter(\n      (trigger) => trigger?.type === 'schedule' && !trigger.disabled,\n    );\n\n    for (const trigger of triggers) {\n      this.validateTrigger(trigger, triggerIds);\n    }\n\n    if (!activeScheduleTriggers.length) {\n      return;\n    }\n\n    const inputs = definition.inputs ?? {};\n    for (const [inputKey, inputDefinition] of Object.entries(inputs)) {\n      if (!this.inputHasDefault(inputDefinition)) {\n        throw new BadRequestException(\n          `Workflow input \"${inputKey}\" requires a default value before enabling a scheduled trigger.`,\n        );\n      }\n    }\n  }\n\n  private validateTrigger(\n    trigger: WorkflowTriggerDefinition,\n    triggerIds: Set<string>,\n  ) {\n    if (!trigger || typeof trigger !== 'object' || Array.isArray(trigger)) {\n      throw new BadRequestException('Every workflow trigger must be an object.');\n    }\n\n    if (!trigger.id) {\n      throw new BadRequestException('Every workflow trigger requires an id.');\n    }\n\n    if (triggerIds.has(trigger.id)) {\n      throw new BadRequestException(\n        `Duplicate workflow trigger id \"${trigger.id}\".`,\n      );\n    }\n    triggerIds.add(trigger.id);\n\n    if (!['schedule', 'webhook'].includes(trigger.type)) {\n      throw new BadRequestException(\n        `Workflow trigger \"${trigger.id}\" has unsupported type \"${trigger.type}\".`,\n      );\n    }\n\n    if (trigger.type === 'schedule') {\n      const cronExpression =\n        trigger.configuration?.cronExpression ?? trigger.configuration?.cron;\n      if (!cronExpression || typeof cronExpression !== 'string') {\n        throw new BadRequestException(\n          `Workflow trigger \"${trigger.id}\" requires a cron expression.`,\n        );\n      }\n\n      try {\n        CronExpressionParser.parse(cronExpression, {\n          currentDate: new Date(),\n          tz: trigger.configuration?.timezone ?? 'UTC',\n        });\n      } catch (error: any) {\n        throw new BadRequestException(\n          `Workflow trigger \"${trigger.id}\" has an invalid cron expression: ${error?.message ?? cronExpression}`,\n        );\n      }\n    }\n\n    if (trigger.type === 'webhook') {\n      const method = String(trigger.configuration?.method ?? 'POST').toUpperCase();\n      if (!['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(method)) {\n        throw new BadRequestException(\n          `Workflow trigger \"${trigger.id}\" has unsupported webhook method \"${method}\".`,\n        );\n      }\n    }\n  }\n\n  private inputHasDefault(inputDefinition: any): boolean {\n    if (\n      inputDefinition &&\n      typeof inputDefinition === 'object' &&\n      !Array.isArray(inputDefinition)\n    ) {\n      return (\n        Object.prototype.hasOwnProperty.call(inputDefinition, 'default') &&\n        inputDefinition.default !== undefined &&\n        inputDefinition.default !== null\n      );\n    }\n\n    return inputDefinition !== undefined && inputDefinition !== null;\n  }\n\n  private validateNodes(nodes: WorkflowNodeDefinition[], nodeIds: Set<string>) {\n    for (const node of nodes) {\n      this.validateNode(node, nodeIds);\n    }\n  }\n\n  private validateNode(node: WorkflowNodeDefinition, nodeIds: Set<string>) {\n    if (!node || typeof node !== 'object' || Array.isArray(node)) {\n      throw new BadRequestException('Every workflow node must be an object.');\n    }\n\n    for (const unsupportedKey of ['children', 'branches', 'nodes']) {\n      if (Object.prototype.hasOwnProperty.call(node, unsupportedKey)) {\n        throw new BadRequestException(\n          `Workflow node \"${node.id ?? 'unknown'}\" uses unsupported child key \"${unsupportedKey}\". Use \"tasks\", \"then\", \"else\", \"defaults\", \"errors\", or \"cases\" instead.`,\n        );\n      }\n    }\n\n    for (const childKey of ['tasks', 'then', 'else', 'defaults', 'errors'] as const) {\n      const childValue = node[childKey];\n      if (\n        childValue !== undefined &&\n        childValue !== null &&\n        !Array.isArray(childValue)\n      ) {\n        throw new BadRequestException(\n          `Workflow node \"${node.id ?? 'unknown'}\" field \"${childKey}\" must be an array when provided.`,\n        );\n      }\n    }\n\n    if (\n      node.cases !== undefined &&\n      node.cases !== null &&\n      (typeof node.cases !== 'object' || Array.isArray(node.cases))\n    ) {\n      throw new BadRequestException(\n        `Workflow node \"${node.id ?? 'unknown'}\" field \"cases\" must be an object of arrays when provided.`,\n      );\n    }\n\n    if (node.cases && typeof node.cases === 'object') {\n      for (const [caseKey, caseNodes] of Object.entries(node.cases)) {\n        if (!Array.isArray(caseNodes)) {\n          throw new BadRequestException(\n            `Workflow node \"${node.id ?? 'unknown'}\" case \"${caseKey}\" must be an array.`,\n          );\n        }\n      }\n    }\n\n    if (!node.id) {\n      throw new BadRequestException('Every workflow node requires an id.');\n    }\n\n    if (nodeIds.has(node.id)) {\n      throw new BadRequestException(`Duplicate workflow node id \"${node.id}\".`);\n    }\n\n    nodeIds.add(node.id);\n\n    if (!node.kind) {\n      throw new BadRequestException(`Workflow node \"${node.id}\" requires kind.`);\n    }\n\n    if (!['task', 'control', 'subflow'].includes(node.kind)) {\n      throw new BadRequestException(\n        `Workflow node \"${node.id}\" has unsupported kind \"${node.kind}\".`,\n      );\n    }\n\n    if (!node.type) {\n      throw new BadRequestException(`Workflow node \"${node.id}\" requires type.`);\n    }\n\n    if (!this.registry.has(node.type)) {\n      throw new BadRequestException(\n        `Workflow node \"${node.id}\" uses unregistered type \"${node.type}\".`,\n      );\n    }\n\n    this.validateNodes(node.tasks ?? [], nodeIds);\n    this.validateNodes(node.then ?? [], nodeIds);\n    this.validateNodes(node.else ?? [], nodeIds);\n    this.validateNodes(node.defaults ?? [], nodeIds);\n    this.validateNodes(node.errors ?? [], nodeIds);\n    Object.values(node.cases ?? {}).forEach((caseNodes) => {\n      this.validateNodes(caseNodes, nodeIds);\n    });\n  }\n}\n"]}

package/dist/services/workflow/workflow-execution-writer.service.d.ts

@@ -0,0 +1,26 @@
+import { EntityManager } from 'typeorm';
+import { WorkflowDefinition } from '../../entities/workflow-definition.entity';
+import { WorkflowExecutionArtifact } from '../../entities/workflow-execution-artifact.entity';
+import { WorkflowExecutionLog } from '../../entities/workflow-execution-log.entity';
+import { WorkflowExecution } from '../../entities/workflow-execution.entity';
+import { WorkflowStepExecution } from '../../entities/workflow-step-execution.entity';
+import { WorkflowArtifactEmitRequest, WorkflowExecutionRequest, WorkflowLogEmitRequest, WorkflowNodeDefinition, WorkflowStepExecutionStatus } from '../../types/workflow-dsl.types';
+export declare class WorkflowExecutionWriterService {
+    private readonly entityManager;
+    constructor(entityManager: EntityManager);
+    createExecution(definition: WorkflowDefinition, request: WorkflowExecutionRequest): Promise<WorkflowExecution>;
+    createEnqueuedExecution(definition: WorkflowDefinition, request: WorkflowExecutionRequest): Promise<WorkflowExecution>;
+    startExecution(execution: WorkflowExecution, request: WorkflowExecutionRequest): Promise<WorkflowExecution>;
+    completeExecution(execution: WorkflowExecution, _outputPayload: any): Promise<WorkflowExecution>;
+    failExecution(execution: WorkflowExecution, error: unknown): Promise<WorkflowExecution>;
+    createStep(execution: WorkflowExecution, node: WorkflowNodeDefinition, sequenceNumber: number, inputPayload: any, parentNodeId?: string, parentStepExecutionKey?: string): Promise<WorkflowStepExecution>;
+    completeStep(step: WorkflowStepExecution, status: WorkflowStepExecutionStatus, outputPayload: any, runtimeContext?: any): Promise<WorkflowStepExecution>;
+    failStep(step: WorkflowStepExecution, error: unknown): Promise<WorkflowStepExecution>;
+    writeLog(execution: WorkflowExecution, step: WorkflowStepExecution | undefined, entry: WorkflowLogEmitRequest, sequenceNumber: number): Promise<WorkflowExecutionLog>;
+    writeArtifact(execution: WorkflowExecution, step: WorkflowStepExecution | undefined, entry: WorkflowArtifactEmitRequest): Promise<WorkflowExecutionArtifact>;
+    private createKey;
+    private duration;
+    private errorMessage;
+    private errorDetails;
+}
+//# sourceMappingURL=workflow-execution-writer.service.d.ts.map

package/dist/services/workflow/workflow-execution-writer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-execution-writer.service.d.ts","sourceRoot":"","sources":["../../../src/services/workflow/workflow-execution-writer.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mDAAmD,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AAExC,qBACa,8BAA8B;IAGvC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAGzC,eAAe,CACnB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IAmBvB,uBAAuB,CAC3B,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IAoBvB,cAAc,CAClB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IASvB,iBAAiB,CACrB,SAAS,EAAE,iBAAiB,EAC5B,cAAc,EAAE,GAAG,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAYvB,aAAa,CACjB,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,iBAAiB,CAAC;IAUvB,UAAU,CACd,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,sBAAsB,EAC5B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,GAAG,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,qBAAqB,CAAC;IAwB3B,YAAY,CAChB,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,2BAA2B,EACnC,aAAa,EAAE,GAAG,EAClB,cAAc,CAAC,EAAE,GAAG,GACnB,OAAO,CAAC,qBAAqB,CAAC;IAU3B,QAAQ,CACZ,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,qBAAqB,CAAC;IAU3B,QAAQ,CACZ,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,qBAAqB,GAAG,SAAS,EACvC,KAAK,EAAE,sBAAsB,EAC7B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,oBAAoB,CAAC;IAoB1B,aAAa,CACjB,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,qBAAqB,GAAG,SAAS,EACvC,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,yBAAyB,CAAC;IAuBrC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;CAWrB"}