@duraflows/nestjs 4.1.0 → 5.1.0

package/README.md

@@ -33,6 +33,15 @@ You will also need a persistence adapter such as [`@duraflows/pg`](https://www.n
 pnpm add @duraflows/pg pg
 ```
 
+### Compatibility
+
+| NestJS | Supported | Notes                                                                                                                                                           |
+| ------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 12.x   | ✅        | NestJS 12 ships ESM-only. CommonJS apps load it through `require(esm)`, which needs **Node.js ≥ 20.19 or ≥ 22.12** (a NestJS requirement, not a duraflows one). |
+| 11.x   | ✅        | From `11.0.0`.                                                                                                                                                  |
+
+The same `@duraflows/nestjs` release works on both majors, from both CommonJS and ESM apps. No duraflows changes are needed when you upgrade an app from NestJS 11 to 12.
+
 ## Quick Start
 
 ### Module Registration

package/dist/cjs/index.d.ts

@@ -2,7 +2,7 @@ export { WorkflowModule } from "./workflow.module.js";
 export type { WorkflowModuleOptions, WorkflowModuleAsyncOptions, WorkflowModuleFactoryConfig, } from "./workflow.module.js";
 export { WorkflowService } from "./services/workflow.service.js";
 export { WorkflowTimeoutService } from "./services/workflow-timeout.service.js";
-export { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, } from "./providers/injection-tokens.js";
+export { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, WORKFLOW_DEFINITION_STORE, } from "./providers/injection-tokens.js";
 export { NestCommandRegistry } from "./providers/nest-command-registry.js";
 export type { WorkflowCommandRegistration } from "./providers/nest-command-registry.js";
 export { WorkflowCommand, WORKFLOW_COMMAND_METADATA_KEY } from "./decorators/workflow-command.decorator.js";

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_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.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; } });
@@ -19,6 +19,7 @@ Object.defineProperty(exports, "WORKFLOW_GUARD_REGISTRY", { enumerable: true, ge
 Object.defineProperty(exports, "WORKFLOW_DEFINITION_REGISTRY", { enumerable: true, get: function () { return injection_tokens_js_1.WORKFLOW_DEFINITION_REGISTRY; } });
 Object.defineProperty(exports, "WORKFLOW_TRANSACTION_RUNNER", { enumerable: true, get: function () { return injection_tokens_js_1.WORKFLOW_TRANSACTION_RUNNER; } });
 Object.defineProperty(exports, "WORKFLOW_CLOCK", { enumerable: true, get: function () { return injection_tokens_js_1.WORKFLOW_CLOCK; } });
+Object.defineProperty(exports, "WORKFLOW_DEFINITION_STORE", { enumerable: true, get: function () { return injection_tokens_js_1.WORKFLOW_DEFINITION_STORE; } });
 var nest_command_registry_js_1 = require("./providers/nest-command-registry.js");
 Object.defineProperty(exports, "NestCommandRegistry", { enumerable: true, get: function () { return nest_command_registry_js_1.NestCommandRegistry; } });
 // Decorators

package/dist/cjs/providers/injection-tokens.d.ts

@@ -6,6 +6,7 @@ export declare const WORKFLOW_DEFINITION_REGISTRY: unique symbol;
 export declare const WORKFLOW_TRANSACTION_RUNNER: unique symbol;
 export declare const WORKFLOW_CLOCK: unique symbol;
 export declare const WORKFLOW_GUARD_REGISTRY: unique symbol;
+export declare const WORKFLOW_DEFINITION_STORE: unique symbol;
 /**
  * The resolved module configuration. Deliberately not re-exported from the
  * package barrel: it exists so `forRoot` and `forRootAsync` can publish their

package/dist/cjs/providers/injection-tokens.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKFLOW_MODULE_OPTIONS = exports.WORKFLOW_GUARD_REGISTRY = exports.WORKFLOW_CLOCK = exports.WORKFLOW_TRANSACTION_RUNNER = exports.WORKFLOW_DEFINITION_REGISTRY = exports.WORKFLOW_COMMAND_REGISTRY = exports.WORKFLOW_HISTORY_STORE = exports.WORKFLOW_INSTANCE_STORE = exports.WORKFLOW_RUNTIME = void 0;
+exports.WORKFLOW_MODULE_OPTIONS = exports.WORKFLOW_DEFINITION_STORE = exports.WORKFLOW_GUARD_REGISTRY = exports.WORKFLOW_CLOCK = exports.WORKFLOW_TRANSACTION_RUNNER = exports.WORKFLOW_DEFINITION_REGISTRY = exports.WORKFLOW_COMMAND_REGISTRY = exports.WORKFLOW_HISTORY_STORE = exports.WORKFLOW_INSTANCE_STORE = exports.WORKFLOW_RUNTIME = void 0;
 exports.WORKFLOW_RUNTIME = Symbol("WORKFLOW_RUNTIME");
 exports.WORKFLOW_INSTANCE_STORE = Symbol("WORKFLOW_INSTANCE_STORE");
 exports.WORKFLOW_HISTORY_STORE = Symbol("WORKFLOW_HISTORY_STORE");
@@ -9,6 +9,7 @@ exports.WORKFLOW_DEFINITION_REGISTRY = Symbol("WORKFLOW_DEFINITION_REGISTRY");
 exports.WORKFLOW_TRANSACTION_RUNNER = Symbol("WORKFLOW_TRANSACTION_RUNNER");
 exports.WORKFLOW_CLOCK = Symbol("WORKFLOW_CLOCK");
 exports.WORKFLOW_GUARD_REGISTRY = Symbol("WORKFLOW_GUARD_REGISTRY");
+exports.WORKFLOW_DEFINITION_STORE = Symbol("WORKFLOW_DEFINITION_STORE");
 /**
  * The resolved module configuration. Deliberately not re-exported from the
  * package barrel: it exists so `forRoot` and `forRootAsync` can publish their

package/dist/cjs/providers/workflow-runtime-initializer.d.ts

@@ -0,0 +1,13 @@
+import { type OnModuleInit } from "@nestjs/common";
+import type { WorkflowRuntime } from "@duraflows/core";
+/**
+ * Runs `WorkflowRuntime.initialize()` during module init so definition
+ * snapshots sync (and version-bump violations surface) at application
+ * startup rather than on the first workflow operation.
+ */
+export declare class WorkflowRuntimeInitializer implements OnModuleInit {
+    private readonly runtime;
+    constructor(runtime: WorkflowRuntime);
+    onModuleInit(): Promise<void>;
+}
+//# sourceMappingURL=workflow-runtime-initializer.d.ts.map

package/dist/cjs/providers/workflow-runtime-initializer.js

@@ -0,0 +1,38 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowRuntimeInitializer = void 0;
+const common_1 = require("@nestjs/common");
+const injection_tokens_js_1 = require("./injection-tokens.js");
+/**
+ * Runs `WorkflowRuntime.initialize()` during module init so definition
+ * snapshots sync (and version-bump violations surface) at application
+ * startup rather than on the first workflow operation.
+ */
+let WorkflowRuntimeInitializer = class WorkflowRuntimeInitializer {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async onModuleInit() {
+        await this.runtime.initialize();
+    }
+};
+exports.WorkflowRuntimeInitializer = WorkflowRuntimeInitializer;
+exports.WorkflowRuntimeInitializer = WorkflowRuntimeInitializer = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(injection_tokens_js_1.WORKFLOW_RUNTIME)),
+    __metadata("design:paramtypes", [Function])
+], WorkflowRuntimeInitializer);
+//# sourceMappingURL=workflow-runtime-initializer.js.map

package/dist/cjs/workflow.module.js

@@ -14,6 +14,7 @@ const core_2 = require("@duraflows/core");
 const nest_command_registry_js_1 = require("./providers/nest-command-registry.js");
 const command_discovery_js_1 = require("./providers/command-discovery.js");
 const injection_tokens_js_1 = require("./providers/injection-tokens.js");
+const workflow_runtime_initializer_js_1 = require("./providers/workflow-runtime-initializer.js");
 const workflow_service_js_1 = require("./services/workflow.service.js");
 const workflow_timeout_service_js_1 = require("./services/workflow-timeout.service.js");
 const workflow_event_controller_js_1 = require("./controllers/workflow-event.controller.js");
@@ -129,6 +130,11 @@ function buildWorkflowProviders(explicitCommands) {
             useFactory: (config) => config.persistence.transactionRunner,
             inject: [injection_tokens_js_1.WORKFLOW_MODULE_OPTIONS],
         },
+        {
+            provide: injection_tokens_js_1.WORKFLOW_DEFINITION_STORE,
+            useFactory: (config) => config.persistence.definitionStore ?? null,
+            inject: [injection_tokens_js_1.WORKFLOW_MODULE_OPTIONS],
+        },
         {
             provide: injection_tokens_js_1.WORKFLOW_CLOCK,
             useFactory: (config) => config.clock ?? { now: () => new Date() },
@@ -136,7 +142,7 @@ function buildWorkflowProviders(explicitCommands) {
         },
         {
             provide: injection_tokens_js_1.WORKFLOW_RUNTIME,
-            useFactory: (config, definitionRegistry, commandRegistry, guardRegistry, instanceStore, historyStore, transactionRunner, clock) => new core_2.WorkflowRuntime({
+            useFactory: (config, definitionRegistry, commandRegistry, guardRegistry, instanceStore, historyStore, transactionRunner, clock, definitionStore) => new core_2.WorkflowRuntime({
                 definitionRegistry,
                 commandRegistry,
                 guardRegistry,
@@ -144,6 +150,7 @@ function buildWorkflowProviders(explicitCommands) {
                 historyStore,
                 transactionRunner,
                 clock,
+                definitionStore: definitionStore ?? undefined,
                 observers: config.observers,
                 onObserverError: config.onObserverError,
             }),
@@ -156,10 +163,12 @@ function buildWorkflowProviders(explicitCommands) {
                 injection_tokens_js_1.WORKFLOW_HISTORY_STORE,
                 injection_tokens_js_1.WORKFLOW_TRANSACTION_RUNNER,
                 injection_tokens_js_1.WORKFLOW_CLOCK,
+                injection_tokens_js_1.WORKFLOW_DEFINITION_STORE,
             ],
         },
         workflow_service_js_1.WorkflowService,
         workflow_timeout_service_js_1.WorkflowTimeoutService,
+        workflow_runtime_initializer_js_1.WorkflowRuntimeInitializer,
     ];
 }
 let WorkflowModule = WorkflowModule_1 = class WorkflowModule {

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { WorkflowModule } from "./workflow.module.js";
 export type { WorkflowModuleOptions, WorkflowModuleAsyncOptions, WorkflowModuleFactoryConfig, } from "./workflow.module.js";
 export { WorkflowService } from "./services/workflow.service.js";
 export { WorkflowTimeoutService } from "./services/workflow-timeout.service.js";
-export { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, } from "./providers/injection-tokens.js";
+export { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, WORKFLOW_DEFINITION_STORE, } from "./providers/injection-tokens.js";
 export { NestCommandRegistry } from "./providers/nest-command-registry.js";
 export type { WorkflowCommandRegistration } from "./providers/nest-command-registry.js";
 export { WorkflowCommand, WORKFLOW_COMMAND_METADATA_KEY } from "./decorators/workflow-command.decorator.js";

package/dist/index.js

@@ -4,7 +4,7 @@ export { WorkflowModule } from "./workflow.module.js";
 export { WorkflowService } from "./services/workflow.service.js";
 export { WorkflowTimeoutService } from "./services/workflow-timeout.service.js";
 // Providers
-export { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, } from "./providers/injection-tokens.js";
+export { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, WORKFLOW_DEFINITION_STORE, } from "./providers/injection-tokens.js";
 export { NestCommandRegistry } from "./providers/nest-command-registry.js";
 // Decorators
 export { WorkflowCommand, WORKFLOW_COMMAND_METADATA_KEY } from "./decorators/workflow-command.decorator.js";

package/dist/providers/injection-tokens.d.ts

@@ -6,6 +6,7 @@ export declare const WORKFLOW_DEFINITION_REGISTRY: unique symbol;
 export declare const WORKFLOW_TRANSACTION_RUNNER: unique symbol;
 export declare const WORKFLOW_CLOCK: unique symbol;
 export declare const WORKFLOW_GUARD_REGISTRY: unique symbol;
+export declare const WORKFLOW_DEFINITION_STORE: unique symbol;
 /**
  * The resolved module configuration. Deliberately not re-exported from the
  * package barrel: it exists so `forRoot` and `forRootAsync` can publish their

package/dist/providers/injection-tokens.js

@@ -6,6 +6,7 @@ export const WORKFLOW_DEFINITION_REGISTRY = Symbol("WORKFLOW_DEFINITION_REGISTRY
 export const WORKFLOW_TRANSACTION_RUNNER = Symbol("WORKFLOW_TRANSACTION_RUNNER");
 export const WORKFLOW_CLOCK = Symbol("WORKFLOW_CLOCK");
 export const WORKFLOW_GUARD_REGISTRY = Symbol("WORKFLOW_GUARD_REGISTRY");
+export const WORKFLOW_DEFINITION_STORE = Symbol("WORKFLOW_DEFINITION_STORE");
 /**
  * The resolved module configuration. Deliberately not re-exported from the
  * package barrel: it exists so `forRoot` and `forRootAsync` can publish their

package/dist/providers/workflow-runtime-initializer.d.ts

@@ -0,0 +1,13 @@
+import { type OnModuleInit } from "@nestjs/common";
+import type { WorkflowRuntime } from "@duraflows/core";
+/**
+ * Runs `WorkflowRuntime.initialize()` during module init so definition
+ * snapshots sync (and version-bump violations surface) at application
+ * startup rather than on the first workflow operation.
+ */
+export declare class WorkflowRuntimeInitializer implements OnModuleInit {
+    private readonly runtime;
+    constructor(runtime: WorkflowRuntime);
+    onModuleInit(): Promise<void>;
+}
+//# sourceMappingURL=workflow-runtime-initializer.d.ts.map

package/dist/providers/workflow-runtime-initializer.js

@@ -0,0 +1,35 @@
+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); }
+};
+import { Inject, Injectable } from "@nestjs/common";
+import { WORKFLOW_RUNTIME } from "./injection-tokens.js";
+/**
+ * Runs `WorkflowRuntime.initialize()` during module init so definition
+ * snapshots sync (and version-bump violations surface) at application
+ * startup rather than on the first workflow operation.
+ */
+let WorkflowRuntimeInitializer = class WorkflowRuntimeInitializer {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async onModuleInit() {
+        await this.runtime.initialize();
+    }
+};
+WorkflowRuntimeInitializer = __decorate([
+    Injectable(),
+    __param(0, Inject(WORKFLOW_RUNTIME)),
+    __metadata("design:paramtypes", [Function])
+], WorkflowRuntimeInitializer);
+export { WorkflowRuntimeInitializer };
+//# sourceMappingURL=workflow-runtime-initializer.js.map

package/dist/workflow.module.js

@@ -10,7 +10,8 @@ import { DiscoveryModule, DiscoveryService, ModuleRef } from "@nestjs/core";
 import { InMemoryDefinitionRegistry, WorkflowRuntime, WorkflowValidator, WorkflowCompiler, InMemoryGuardRegistry, } from "@duraflows/core";
 import { NestCommandRegistry } from "./providers/nest-command-registry.js";
 import { discoverDecoratedCommands, mergeCommandRegistrations } from "./providers/command-discovery.js";
-import { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, WORKFLOW_GUARD_REGISTRY, WORKFLOW_MODULE_OPTIONS, } from "./providers/injection-tokens.js";
+import { WORKFLOW_RUNTIME, WORKFLOW_INSTANCE_STORE, WORKFLOW_HISTORY_STORE, WORKFLOW_COMMAND_REGISTRY, WORKFLOW_DEFINITION_REGISTRY, WORKFLOW_TRANSACTION_RUNNER, WORKFLOW_CLOCK, WORKFLOW_GUARD_REGISTRY, WORKFLOW_DEFINITION_STORE, WORKFLOW_MODULE_OPTIONS, } from "./providers/injection-tokens.js";
+import { WorkflowRuntimeInitializer } from "./providers/workflow-runtime-initializer.js";
 import { WorkflowService } from "./services/workflow.service.js";
 import { WorkflowTimeoutService } from "./services/workflow-timeout.service.js";
 import { WorkflowEventController } from "./controllers/workflow-event.controller.js";
@@ -126,6 +127,11 @@ function buildWorkflowProviders(explicitCommands) {
             useFactory: (config) => config.persistence.transactionRunner,
             inject: [WORKFLOW_MODULE_OPTIONS],
         },
+        {
+            provide: WORKFLOW_DEFINITION_STORE,
+            useFactory: (config) => config.persistence.definitionStore ?? null,
+            inject: [WORKFLOW_MODULE_OPTIONS],
+        },
         {
             provide: WORKFLOW_CLOCK,
             useFactory: (config) => config.clock ?? { now: () => new Date() },
@@ -133,7 +139,7 @@ function buildWorkflowProviders(explicitCommands) {
         },
         {
             provide: WORKFLOW_RUNTIME,
-            useFactory: (config, definitionRegistry, commandRegistry, guardRegistry, instanceStore, historyStore, transactionRunner, clock) => new WorkflowRuntime({
+            useFactory: (config, definitionRegistry, commandRegistry, guardRegistry, instanceStore, historyStore, transactionRunner, clock, definitionStore) => new WorkflowRuntime({
                 definitionRegistry,
                 commandRegistry,
                 guardRegistry,
@@ -141,6 +147,7 @@ function buildWorkflowProviders(explicitCommands) {
                 historyStore,
                 transactionRunner,
                 clock,
+                definitionStore: definitionStore ?? undefined,
                 observers: config.observers,
                 onObserverError: config.onObserverError,
             }),
@@ -153,10 +160,12 @@ function buildWorkflowProviders(explicitCommands) {
                 WORKFLOW_HISTORY_STORE,
                 WORKFLOW_TRANSACTION_RUNNER,
                 WORKFLOW_CLOCK,
+                WORKFLOW_DEFINITION_STORE,
             ],
         },
         WorkflowService,
         WorkflowTimeoutService,
+        WorkflowRuntimeInitializer,
     ];
 }
 let WorkflowModule = WorkflowModule_1 = class WorkflowModule {

package/package.json

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