@quanticjs/workflow 2.0.0

package/dist/QuanticWorkflowModule.d.ts

@@ -0,0 +1,4 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class QuanticWorkflowModule {
+    static forRoot(): DynamicModule;
+}

package/dist/QuanticWorkflowModule.js

@@ -0,0 +1,32 @@
+"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 QuanticWorkflowModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuanticWorkflowModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@quanticjs/core");
+const WorkflowBehavior_1 = require("./WorkflowBehavior");
+let QuanticWorkflowModule = QuanticWorkflowModule_1 = class QuanticWorkflowModule {
+    static forRoot() {
+        return {
+            module: QuanticWorkflowModule_1,
+            providers: [
+                WorkflowBehavior_1.WorkflowBehavior,
+                { provide: core_1.PIPELINE_BEHAVIOR, useExisting: WorkflowBehavior_1.WorkflowBehavior, multi: true },
+            ],
+            exports: [
+                WorkflowBehavior_1.WorkflowBehavior,
+            ],
+        };
+    }
+};
+exports.QuanticWorkflowModule = QuanticWorkflowModule;
+exports.QuanticWorkflowModule = QuanticWorkflowModule = QuanticWorkflowModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], QuanticWorkflowModule);

package/dist/WorkflowBehavior.d.ts

@@ -0,0 +1,10 @@
+import { Result, PipelineBehavior, PipelineScope } from '@quanticjs/core';
+import type { WorkflowEngine } from '@quanticjs/core';
+export declare class WorkflowBehavior implements PipelineBehavior {
+    private readonly engine?;
+    readonly order: 50;
+    readonly scope: PipelineScope;
+    private readonly logger;
+    constructor(engine?: WorkflowEngine | undefined);
+    execute<T>(command: object, next: () => Promise<Result<T>>): Promise<Result<T>>;
+}

package/dist/WorkflowBehavior.js

@@ -0,0 +1,61 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var WorkflowBehavior_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowBehavior = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@quanticjs/core");
+let WorkflowBehavior = WorkflowBehavior_1 = class WorkflowBehavior {
+    engine;
+    order = core_1.BehaviorOrder.WORKFLOW;
+    scope = 'command';
+    logger = new common_1.Logger(WorkflowBehavior_1.name);
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async execute(command, next) {
+        const metadata = (0, core_1.getWorkflowMetadata)(command.constructor);
+        if (!metadata) {
+            return next();
+        }
+        if (!this.engine) {
+            this.logger.debug('No WorkflowEngine provided, skipping workflow behavior');
+            return next();
+        }
+        try {
+            const result = await this.engine.startProcess(metadata.processDefinitionId, command, { commandType: command.constructor.name });
+            return core_1.Result.success(result);
+        }
+        catch (error) {
+            const fallback = metadata.fallback ?? 'throw';
+            this.logger.warn(`Workflow start failed for "${metadata.processDefinitionId}", applying fallback: ${fallback}`, error.message);
+            switch (fallback) {
+                case 'skip':
+                    return next();
+                case 'queue':
+                    return core_1.Result.failure(core_1.ErrorType.InternalError, `Workflow queuing not available without companion package: ${error.message}`);
+                case 'throw':
+                default:
+                    return core_1.Result.failure(core_1.ErrorType.InternalError, `Workflow start failed: ${error.message}`);
+            }
+        }
+    }
+};
+exports.WorkflowBehavior = WorkflowBehavior;
+exports.WorkflowBehavior = WorkflowBehavior = WorkflowBehavior_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(core_1.WORKFLOW_ENGINE)),
+    __metadata("design:paramtypes", [Object])
+], WorkflowBehavior);

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { WorkflowBehavior } from './WorkflowBehavior';
+export { QuanticWorkflowModule } from './QuanticWorkflowModule';

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuanticWorkflowModule = exports.WorkflowBehavior = void 0;
+var WorkflowBehavior_1 = require("./WorkflowBehavior");
+Object.defineProperty(exports, "WorkflowBehavior", { enumerable: true, get: function () { return WorkflowBehavior_1.WorkflowBehavior; } });
+var QuanticWorkflowModule_1 = require("./QuanticWorkflowModule");
+Object.defineProperty(exports, "QuanticWorkflowModule", { enumerable: true, get: function () { return QuanticWorkflowModule_1.QuanticWorkflowModule; } });

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@quanticjs/workflow",
+  "version": "2.0.0",
+  "description": "Workflow engine integration for quanticjs — pipeline behavior for external BPM engines",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "jest --passWithNoTests",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@quanticjs/core": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0"
+  }
+}