@duraflows/nestjs 6.1.0 → 7.0.0

package/dist/cjs/filters/workflow-exception.filter.js

@@ -28,7 +28,8 @@ let WorkflowExceptionFilter = WorkflowExceptionFilter_1 = class WorkflowExceptio
             });
             return;
         }
-        if (exception instanceof core_1.InvalidEventError) {
+        // Both mean the instance's state doesn't fit the governing definition.
+        if (exception instanceof core_1.InvalidEventError || exception instanceof core_1.IncompatibleDefinitionError) {
             response.status(common_1.HttpStatus.CONFLICT).send({
                 statusCode: common_1.HttpStatus.CONFLICT,
                 error: "Conflict",

package/dist/cjs/index.d.ts

@@ -12,8 +12,8 @@ export { WorkflowQueryController } from "./controllers/workflow-query.controller
 export { WorkflowTimeoutController } from "./controllers/workflow-timeout.controller.js";
 export { WorkflowExceptionFilter } from "./filters/workflow-exception.filter.js";
 export { TriggerEventDto, TriggerEventParamsDto, HistoryQueryDto, HistoryParamsDto, AvailableEventsParamsDto, TimeoutProcessQueryDto, CreateInstanceDto, } from "./controllers/dto/index.js";
-export type { WorkflowDefinition, WorkflowStateDefinition, WorkflowEventDefinition, WorkflowOnEnterDefinition, WorkflowCommandRef, WorkflowTimeoutDefinition, CommandResult, WorkflowExecutionContext, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, ProcessExpiredWorkflowsInput, ProcessExpiredWorkflowsResult, FindParkedTimeoutsInput, WorkflowTimeoutRetry, WorkflowTimeoutRetryOptions, GetAvailableEventsInput, WorkflowInstanceStore, WorkflowHistoryStore, WorkflowHistoryRecord, WorkflowTransactionRunner, WorkflowClock, WorkflowPersistenceProvider, WorkflowDefinitionRegistry, WorkflowCommandRegistry, ValidationResult, ValidationError, CompiledWorkflow, OnEnterChainResult, OnEnterHopResult, WorkflowRuntimeClient, } from "@duraflows/core";
-export { WorkflowError, WorkflowDefinitionError, WorkflowInstanceNotFoundError, InvalidEventError, CommandFailureError, OnEnterDepthExceededError, WorkflowValidator, WorkflowCompiler, CommandExecutor, EventExecutor, OnEnterExecutor, TimeoutResolver, WorkflowRuntime, WorkflowHandle, InMemoryDefinitionRegistry, InMemoryCommandRegistry, InMemoryGuardRegistry, } from "@duraflows/core";
+export type { WorkflowDefinition, WorkflowStateDefinition, WorkflowEventDefinition, WorkflowOnEnterDefinition, WorkflowCommandRef, WorkflowTimeoutDefinition, CommandResult, WorkflowExecutionContext, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, ProcessExpiredWorkflowsInput, ProcessExpiredWorkflowsResult, FindParkedTimeoutsInput, WorkflowTimeoutRetry, WorkflowTimeoutRetryOptions, GetAvailableEventsInput, WorkflowInstanceStore, WorkflowHistoryStore, WorkflowHistoryRecord, DefinitionVersionSummary, WorkflowTransactionRunner, WorkflowClock, WorkflowPersistenceProvider, WorkflowDefinitionRegistry, WorkflowCommandRegistry, ValidationResult, ValidationError, CompiledWorkflow, OnEnterChainResult, OnEnterHopResult, WorkflowRuntimeClient, } from "@duraflows/core";
+export { WorkflowError, WorkflowDefinitionError, WorkflowInstanceNotFoundError, InvalidEventError, IncompatibleDefinitionError, CommandFailureError, OnEnterDepthExceededError, WorkflowValidator, WorkflowCompiler, CommandExecutor, EventExecutor, OnEnterExecutor, TimeoutResolver, WorkflowRuntime, WorkflowHandle, InMemoryDefinitionRegistry, InMemoryCommandRegistry, InMemoryGuardRegistry, } from "@duraflows/core";
 export type { WorkflowObserver, StateEnterEvent, ObserverErrorHandler } from "@duraflows/core";
 export type { WorkflowGuard, WorkflowGuardRef, WorkflowGuardRegistry } from "@duraflows/core";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryGuardRegistry = exports.InMemoryCommandRegistry = exports.InMemoryDefinitionRegistry = exports.WorkflowHandle = exports.WorkflowRuntime = exports.TimeoutResolver = exports.OnEnterExecutor = exports.EventExecutor = exports.CommandExecutor = exports.WorkflowCompiler = exports.WorkflowValidator = exports.OnEnterDepthExceededError = exports.CommandFailureError = exports.InvalidEventError = exports.WorkflowInstanceNotFoundError = exports.WorkflowDefinitionError = exports.WorkflowError = exports.CreateInstanceDto = exports.TimeoutProcessQueryDto = exports.AvailableEventsParamsDto = exports.HistoryParamsDto = exports.HistoryQueryDto = exports.TriggerEventParamsDto = exports.TriggerEventDto = exports.WorkflowExceptionFilter = exports.WorkflowTimeoutController = exports.WorkflowQueryController = exports.WorkflowEventController = exports.WorkflowInstanceController = exports.WORKFLOW_COMMAND_METADATA_KEY = exports.WorkflowCommand = exports.NestCommandRegistry = exports.WORKFLOW_DEFINITION_STORE = exports.WORKFLOW_CLOCK = exports.WORKFLOW_TRANSACTION_RUNNER = exports.WORKFLOW_DEFINITION_REGISTRY = exports.WORKFLOW_GUARD_REGISTRY = exports.WORKFLOW_COMMAND_REGISTRY = exports.WORKFLOW_HISTORY_STORE = exports.WORKFLOW_INSTANCE_STORE = exports.WORKFLOW_RUNTIME = exports.WorkflowTimeoutService = exports.WorkflowService = exports.WorkflowModule = void 0;
+exports.InMemoryGuardRegistry = exports.InMemoryCommandRegistry = exports.InMemoryDefinitionRegistry = exports.WorkflowHandle = exports.WorkflowRuntime = exports.TimeoutResolver = exports.OnEnterExecutor = exports.EventExecutor = exports.CommandExecutor = exports.WorkflowCompiler = exports.WorkflowValidator = exports.OnEnterDepthExceededError = exports.CommandFailureError = exports.IncompatibleDefinitionError = exports.InvalidEventError = exports.WorkflowInstanceNotFoundError = exports.WorkflowDefinitionError = exports.WorkflowError = exports.CreateInstanceDto = exports.TimeoutProcessQueryDto = exports.AvailableEventsParamsDto = exports.HistoryParamsDto = exports.HistoryQueryDto = exports.TriggerEventParamsDto = exports.TriggerEventDto = exports.WorkflowExceptionFilter = exports.WorkflowTimeoutController = exports.WorkflowQueryController = exports.WorkflowEventController = exports.WorkflowInstanceController = exports.WORKFLOW_COMMAND_METADATA_KEY = exports.WorkflowCommand = exports.NestCommandRegistry = exports.WORKFLOW_DEFINITION_STORE = exports.WORKFLOW_CLOCK = exports.WORKFLOW_TRANSACTION_RUNNER = exports.WORKFLOW_DEFINITION_REGISTRY = exports.WORKFLOW_GUARD_REGISTRY = exports.WORKFLOW_COMMAND_REGISTRY = exports.WORKFLOW_HISTORY_STORE = exports.WORKFLOW_INSTANCE_STORE = exports.WORKFLOW_RUNTIME = exports.WorkflowTimeoutService = exports.WorkflowService = exports.WorkflowModule = void 0;
 // Module
 var workflow_module_js_1 = require("./workflow.module.js");
 Object.defineProperty(exports, "WorkflowModule", { enumerable: true, get: function () { return workflow_module_js_1.WorkflowModule; } });
@@ -52,6 +52,7 @@ Object.defineProperty(exports, "WorkflowError", { enumerable: true, get: functio
 Object.defineProperty(exports, "WorkflowDefinitionError", { enumerable: true, get: function () { return core_1.WorkflowDefinitionError; } });
 Object.defineProperty(exports, "WorkflowInstanceNotFoundError", { enumerable: true, get: function () { return core_1.WorkflowInstanceNotFoundError; } });
 Object.defineProperty(exports, "InvalidEventError", { enumerable: true, get: function () { return core_1.InvalidEventError; } });
+Object.defineProperty(exports, "IncompatibleDefinitionError", { enumerable: true, get: function () { return core_1.IncompatibleDefinitionError; } });
 Object.defineProperty(exports, "CommandFailureError", { enumerable: true, get: function () { return core_1.CommandFailureError; } });
 Object.defineProperty(exports, "OnEnterDepthExceededError", { enumerable: true, get: function () { return core_1.OnEnterDepthExceededError; } });
 Object.defineProperty(exports, "WorkflowValidator", { enumerable: true, get: function () { return core_1.WorkflowValidator; } });

package/dist/cjs/services/workflow.service.d.ts

@@ -1,5 +1,5 @@
 import { WorkflowHandle } from "@duraflows/core";
-import type { WorkflowRuntime, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, GetAvailableEventsInput, WorkflowDefinition, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, WorkflowHistoryRecord } from "@duraflows/core";
+import type { WorkflowRuntime, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, GetAvailableEventsInput, WorkflowDefinition, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, WorkflowHistoryRecord, DefinitionVersionSummary } from "@duraflows/core";
 export declare class WorkflowService {
     private readonly runtime;
     constructor(runtime: WorkflowRuntime);
@@ -32,6 +32,7 @@ export declare class WorkflowService {
         limit?: number;
         offset?: number;
     }): Promise<WorkflowHistoryRecord[]>;
+    listDefinitionVersions(workflowName: string): Promise<DefinitionVersionSummary[]>;
     getHandle(uuid: string): WorkflowHandle;
 }
 //# sourceMappingURL=workflow.service.d.ts.map

package/dist/cjs/services/workflow.service.js

@@ -71,6 +71,9 @@ let WorkflowService = class WorkflowService {
     async getHistory(workflowInstanceUuid, options) {
         return this.runtime.getHistory(workflowInstanceUuid, options);
     }
+    async listDefinitionVersions(workflowName) {
+        return this.runtime.listDefinitionVersions(workflowName);
+    }
     getHandle(uuid) {
         return new core_1.WorkflowHandle(uuid, this);
     }

package/dist/cjs/workflow.module.d.ts

@@ -15,6 +15,12 @@ export interface WorkflowModuleOptions {
      * fails: exponential backoff, then parking. Defaults apply when omitted.
      */
     timeoutRetry?: WorkflowTimeoutRetryOptions;
+    /**
+     * What module init does when a stored definition version that still has
+     * active instances references an unregistered command or guard: `"fail"`
+     * (default) fails application startup, `"warn"` logs and continues.
+     */
+    onUnresolvable?: "fail" | "warn";
     enableControllers?: boolean;
 }
 export interface WorkflowModuleFactoryConfig {
@@ -27,6 +33,8 @@ export interface WorkflowModuleFactoryConfig {
     onObserverError?: ObserverErrorHandler;
     /** See {@link WorkflowModuleOptions.timeoutRetry}. */
     timeoutRetry?: WorkflowTimeoutRetryOptions;
+    /** See {@link WorkflowModuleOptions.onUnresolvable}. */
+    onUnresolvable?: "fail" | "warn";
 }
 export interface WorkflowModuleAsyncOptions<TArgs extends unknown[] = unknown[]> {
     imports?: Type<unknown>[];

package/dist/cjs/workflow.module.js

@@ -154,6 +154,7 @@ function buildWorkflowProviders(explicitCommands) {
                 observers: config.observers,
                 onObserverError: config.onObserverError,
                 timeoutRetry: config.timeoutRetry,
+                onUnresolvable: config.onUnresolvable,
             }),
             inject: [
                 injection_tokens_js_1.WORKFLOW_MODULE_OPTIONS,

package/dist/filters/workflow-exception.filter.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 var WorkflowExceptionFilter_1;
 import { Catch, HttpStatus, Logger } from "@nestjs/common";
-import { WorkflowError, WorkflowInstanceNotFoundError, InvalidEventError, InvalidArgumentError } from "@duraflows/core";
+import { WorkflowError, WorkflowInstanceNotFoundError, InvalidEventError, InvalidArgumentError, IncompatibleDefinitionError, } from "@duraflows/core";
 /**
  * Maps duraflows domain errors to HTTP statuses for the optional REST
  * controllers. Without this filter, a missing instance or an event invalid
@@ -25,7 +25,8 @@ let WorkflowExceptionFilter = WorkflowExceptionFilter_1 = class WorkflowExceptio
             });
             return;
         }
-        if (exception instanceof InvalidEventError) {
+        // Both mean the instance's state doesn't fit the governing definition.
+        if (exception instanceof InvalidEventError || exception instanceof IncompatibleDefinitionError) {
             response.status(HttpStatus.CONFLICT).send({
                 statusCode: HttpStatus.CONFLICT,
                 error: "Conflict",

package/dist/index.d.ts

@@ -12,8 +12,8 @@ export { WorkflowQueryController } from "./controllers/workflow-query.controller
 export { WorkflowTimeoutController } from "./controllers/workflow-timeout.controller.js";
 export { WorkflowExceptionFilter } from "./filters/workflow-exception.filter.js";
 export { TriggerEventDto, TriggerEventParamsDto, HistoryQueryDto, HistoryParamsDto, AvailableEventsParamsDto, TimeoutProcessQueryDto, CreateInstanceDto, } from "./controllers/dto/index.js";
-export type { WorkflowDefinition, WorkflowStateDefinition, WorkflowEventDefinition, WorkflowOnEnterDefinition, WorkflowCommandRef, WorkflowTimeoutDefinition, CommandResult, WorkflowExecutionContext, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, ProcessExpiredWorkflowsInput, ProcessExpiredWorkflowsResult, FindParkedTimeoutsInput, WorkflowTimeoutRetry, WorkflowTimeoutRetryOptions, GetAvailableEventsInput, WorkflowInstanceStore, WorkflowHistoryStore, WorkflowHistoryRecord, WorkflowTransactionRunner, WorkflowClock, WorkflowPersistenceProvider, WorkflowDefinitionRegistry, WorkflowCommandRegistry, ValidationResult, ValidationError, CompiledWorkflow, OnEnterChainResult, OnEnterHopResult, WorkflowRuntimeClient, } from "@duraflows/core";
-export { WorkflowError, WorkflowDefinitionError, WorkflowInstanceNotFoundError, InvalidEventError, CommandFailureError, OnEnterDepthExceededError, WorkflowValidator, WorkflowCompiler, CommandExecutor, EventExecutor, OnEnterExecutor, TimeoutResolver, WorkflowRuntime, WorkflowHandle, InMemoryDefinitionRegistry, InMemoryCommandRegistry, InMemoryGuardRegistry, } from "@duraflows/core";
+export type { WorkflowDefinition, WorkflowStateDefinition, WorkflowEventDefinition, WorkflowOnEnterDefinition, WorkflowCommandRef, WorkflowTimeoutDefinition, CommandResult, WorkflowExecutionContext, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, ProcessExpiredWorkflowsInput, ProcessExpiredWorkflowsResult, FindParkedTimeoutsInput, WorkflowTimeoutRetry, WorkflowTimeoutRetryOptions, GetAvailableEventsInput, WorkflowInstanceStore, WorkflowHistoryStore, WorkflowHistoryRecord, DefinitionVersionSummary, WorkflowTransactionRunner, WorkflowClock, WorkflowPersistenceProvider, WorkflowDefinitionRegistry, WorkflowCommandRegistry, ValidationResult, ValidationError, CompiledWorkflow, OnEnterChainResult, OnEnterHopResult, WorkflowRuntimeClient, } from "@duraflows/core";
+export { WorkflowError, WorkflowDefinitionError, WorkflowInstanceNotFoundError, InvalidEventError, IncompatibleDefinitionError, CommandFailureError, OnEnterDepthExceededError, WorkflowValidator, WorkflowCompiler, CommandExecutor, EventExecutor, OnEnterExecutor, TimeoutResolver, WorkflowRuntime, WorkflowHandle, InMemoryDefinitionRegistry, InMemoryCommandRegistry, InMemoryGuardRegistry, } from "@duraflows/core";
 export type { WorkflowObserver, StateEnterEvent, ObserverErrorHandler } from "@duraflows/core";
 export type { WorkflowGuard, WorkflowGuardRef, WorkflowGuardRegistry } from "@duraflows/core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -17,5 +17,5 @@ export { WorkflowTimeoutController } from "./controllers/workflow-timeout.contro
 export { WorkflowExceptionFilter } from "./filters/workflow-exception.filter.js";
 // DTOs
 export { TriggerEventDto, TriggerEventParamsDto, HistoryQueryDto, HistoryParamsDto, AvailableEventsParamsDto, TimeoutProcessQueryDto, CreateInstanceDto, } from "./controllers/dto/index.js";
-export { WorkflowError, WorkflowDefinitionError, WorkflowInstanceNotFoundError, InvalidEventError, CommandFailureError, OnEnterDepthExceededError, WorkflowValidator, WorkflowCompiler, CommandExecutor, EventExecutor, OnEnterExecutor, TimeoutResolver, WorkflowRuntime, WorkflowHandle, InMemoryDefinitionRegistry, InMemoryCommandRegistry, InMemoryGuardRegistry, } from "@duraflows/core";
+export { WorkflowError, WorkflowDefinitionError, WorkflowInstanceNotFoundError, InvalidEventError, IncompatibleDefinitionError, CommandFailureError, OnEnterDepthExceededError, WorkflowValidator, WorkflowCompiler, CommandExecutor, EventExecutor, OnEnterExecutor, TimeoutResolver, WorkflowRuntime, WorkflowHandle, InMemoryDefinitionRegistry, InMemoryCommandRegistry, InMemoryGuardRegistry, } from "@duraflows/core";
 //# sourceMappingURL=index.js.map

package/dist/services/workflow.service.d.ts

@@ -1,5 +1,5 @@
 import { WorkflowHandle } from "@duraflows/core";
-import type { WorkflowRuntime, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, GetAvailableEventsInput, WorkflowDefinition, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, WorkflowHistoryRecord } from "@duraflows/core";
+import type { WorkflowRuntime, CreateWorkflowInstanceInput, TriggerWorkflowEventInput, GetAvailableEventsInput, WorkflowDefinition, WorkflowInstance, WorkflowExecutionResult, AvailableWorkflowEvent, WorkflowHistoryRecord, DefinitionVersionSummary } from "@duraflows/core";
 export declare class WorkflowService {
     private readonly runtime;
     constructor(runtime: WorkflowRuntime);
@@ -32,6 +32,7 @@ export declare class WorkflowService {
         limit?: number;
         offset?: number;
     }): Promise<WorkflowHistoryRecord[]>;
+    listDefinitionVersions(workflowName: string): Promise<DefinitionVersionSummary[]>;
     getHandle(uuid: string): WorkflowHandle;
 }
 //# sourceMappingURL=workflow.service.d.ts.map

package/dist/services/workflow.service.js

@@ -68,6 +68,9 @@ let WorkflowService = class WorkflowService {
     async getHistory(workflowInstanceUuid, options) {
         return this.runtime.getHistory(workflowInstanceUuid, options);
     }
+    async listDefinitionVersions(workflowName) {
+        return this.runtime.listDefinitionVersions(workflowName);
+    }
     getHandle(uuid) {
         return new WorkflowHandle(uuid, this);
     }

package/dist/workflow.module.d.ts

@@ -15,6 +15,12 @@ export interface WorkflowModuleOptions {
      * fails: exponential backoff, then parking. Defaults apply when omitted.
      */
     timeoutRetry?: WorkflowTimeoutRetryOptions;
+    /**
+     * What module init does when a stored definition version that still has
+     * active instances references an unregistered command or guard: `"fail"`
+     * (default) fails application startup, `"warn"` logs and continues.
+     */
+    onUnresolvable?: "fail" | "warn";
     enableControllers?: boolean;
 }
 export interface WorkflowModuleFactoryConfig {
@@ -27,6 +33,8 @@ export interface WorkflowModuleFactoryConfig {
     onObserverError?: ObserverErrorHandler;
     /** See {@link WorkflowModuleOptions.timeoutRetry}. */
     timeoutRetry?: WorkflowTimeoutRetryOptions;
+    /** See {@link WorkflowModuleOptions.onUnresolvable}. */
+    onUnresolvable?: "fail" | "warn";
 }
 export interface WorkflowModuleAsyncOptions<TArgs extends unknown[] = unknown[]> {
     imports?: Type<unknown>[];

package/dist/workflow.module.js

@@ -151,6 +151,7 @@ function buildWorkflowProviders(explicitCommands) {
                 observers: config.observers,
                 onObserverError: config.onObserverError,
                 timeoutRetry: config.timeoutRetry,
+                onUnresolvable: config.onUnresolvable,
             }),
             inject: [
                 WORKFLOW_MODULE_OPTIONS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duraflows/nestjs",
-  "version": "6.1.0",
+  "version": "7.0.0",
   "description": "NestJS integration for duraflows: dependency injection, services, optional REST controllers, and @WorkflowCommand decorator for DI-backed command handlers.",
   "keywords": [
     "duraflows",
@@ -54,7 +54,7 @@
     "class-validator": "^0.15.1"
   },
   "peerDependencies": {
-    "@duraflows/core": "^6.1.0",
+    "@duraflows/core": "^7.0.0",
     "@nestjs/common": "^11.0.0 || ^12.0.0",
     "@nestjs/core": "^11.0.0 || ^12.0.0",
     "reflect-metadata": "^0.2.0"
@@ -65,7 +65,7 @@
     "@nestjs/platform-express": "^12.1.0",
     "@nestjs/testing": "^12.1.0",
     "reflect-metadata": "^0.2.2",
-    "@duraflows/core": "6.1.0"
+    "@duraflows/core": "7.0.0"
   },
   "scripts": {
     "build": "tsc --build"