@duraflows/nestjs 5.2.1 → 6.1.0

package/dist/cjs/index.d.ts

@@ -12,7 +12,7 @@ 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, GetAvailableEventsInput, WorkflowInstanceStore, WorkflowHistoryStore, WorkflowHistoryRecord, WorkflowTransactionRunner, WorkflowClock, WorkflowPersistenceProvider, WorkflowDefinitionRegistry, WorkflowCommandRegistry, ValidationResult, ValidationError, CompiledWorkflow, OnEnterChainResult, OnEnterHopResult, WorkflowRuntimeClient, } 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, 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 { WorkflowObserver, StateEnterEvent, ObserverErrorHandler } from "@duraflows/core";
 export type { WorkflowGuard, WorkflowGuardRef, WorkflowGuardRegistry } from "@duraflows/core";

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

@@ -1,7 +1,11 @@
-import type { WorkflowRuntime, ProcessExpiredWorkflowsResult } from "@duraflows/core";
+import type { FindParkedTimeoutsInput, ProcessExpiredWorkflowsResult, WorkflowInstance, WorkflowRuntime } from "@duraflows/core";
 export declare class WorkflowTimeoutService {
     private readonly runtime;
     constructor(runtime: WorkflowRuntime);
     processExpiredWorkflows(limit?: number): Promise<ProcessExpiredWorkflowsResult>;
+    /** Instances parked after repeated timeout failures, oldest-parked first. */
+    findParkedTimeouts(input?: FindParkedTimeoutsInput): Promise<WorkflowInstance[]>;
+    /** Clears an instance's timeout retry state so the next sweep retries it. */
+    rearmTimeout(workflowInstanceUuid: string): Promise<WorkflowInstance>;
 }
 //# sourceMappingURL=workflow-timeout.service.d.ts.map

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

@@ -23,6 +23,14 @@ let WorkflowTimeoutService = class WorkflowTimeoutService {
     async processExpiredWorkflows(limit) {
         return this.runtime.processExpiredWorkflows({ limit });
     }
+    /** Instances parked after repeated timeout failures, oldest-parked first. */
+    async findParkedTimeouts(input) {
+        return this.runtime.findParkedTimeouts(input);
+    }
+    /** Clears an instance's timeout retry state so the next sweep retries it. */
+    async rearmTimeout(workflowInstanceUuid) {
+        return this.runtime.rearmTimeout(workflowInstanceUuid);
+    }
 };
 exports.WorkflowTimeoutService = WorkflowTimeoutService;
 exports.WorkflowTimeoutService = WorkflowTimeoutService = __decorate([

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

@@ -1,5 +1,5 @@
 import { type DynamicModule, type Type, type InjectionToken, type OptionalFactoryDependency } from "@nestjs/common";
-import type { WorkflowDefinition, WorkflowClock, WorkflowPersistenceProvider, WorkflowObserver, ObserverErrorHandler, WorkflowGuard, WorkflowGuardRegistry } from "@duraflows/core";
+import type { WorkflowDefinition, WorkflowClock, WorkflowPersistenceProvider, WorkflowObserver, ObserverErrorHandler, WorkflowGuard, WorkflowGuardRegistry, WorkflowTimeoutRetryOptions } from "@duraflows/core";
 import { type WorkflowCommandRegistration } from "./providers/nest-command-registry.js";
 export interface WorkflowModuleOptions {
     workflows: WorkflowDefinition[];
@@ -10,6 +10,11 @@ export interface WorkflowModuleOptions {
     onObserverError?: ObserverErrorHandler;
     persistence: WorkflowPersistenceProvider;
     clock?: WorkflowClock;
+    /**
+     * How `processExpiredWorkflows` retries an instance whose timeout processing
+     * fails: exponential backoff, then parking. Defaults apply when omitted.
+     */
+    timeoutRetry?: WorkflowTimeoutRetryOptions;
     enableControllers?: boolean;
 }
 export interface WorkflowModuleFactoryConfig {
@@ -20,6 +25,8 @@ export interface WorkflowModuleFactoryConfig {
     guardRegistry?: WorkflowGuardRegistry;
     observers?: WorkflowObserver[];
     onObserverError?: ObserverErrorHandler;
+    /** See {@link WorkflowModuleOptions.timeoutRetry}. */
+    timeoutRetry?: WorkflowTimeoutRetryOptions;
 }
 export interface WorkflowModuleAsyncOptions<TArgs extends unknown[] = unknown[]> {
     imports?: Type<unknown>[];

package/dist/cjs/workflow.module.js

@@ -153,6 +153,7 @@ function buildWorkflowProviders(explicitCommands) {
                 definitionStore: definitionStore ?? undefined,
                 observers: config.observers,
                 onObserverError: config.onObserverError,
+                timeoutRetry: config.timeoutRetry,
             }),
             inject: [
                 injection_tokens_js_1.WORKFLOW_MODULE_OPTIONS,

package/dist/index.d.ts

@@ -12,7 +12,7 @@ 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, GetAvailableEventsInput, WorkflowInstanceStore, WorkflowHistoryStore, WorkflowHistoryRecord, WorkflowTransactionRunner, WorkflowClock, WorkflowPersistenceProvider, WorkflowDefinitionRegistry, WorkflowCommandRegistry, ValidationResult, ValidationError, CompiledWorkflow, OnEnterChainResult, OnEnterHopResult, WorkflowRuntimeClient, } 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, 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 { WorkflowObserver, StateEnterEvent, ObserverErrorHandler } from "@duraflows/core";
 export type { WorkflowGuard, WorkflowGuardRef, WorkflowGuardRegistry } from "@duraflows/core";

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

@@ -1,7 +1,11 @@
-import type { WorkflowRuntime, ProcessExpiredWorkflowsResult } from "@duraflows/core";
+import type { FindParkedTimeoutsInput, ProcessExpiredWorkflowsResult, WorkflowInstance, WorkflowRuntime } from "@duraflows/core";
 export declare class WorkflowTimeoutService {
     private readonly runtime;
     constructor(runtime: WorkflowRuntime);
     processExpiredWorkflows(limit?: number): Promise<ProcessExpiredWorkflowsResult>;
+    /** Instances parked after repeated timeout failures, oldest-parked first. */
+    findParkedTimeouts(input?: FindParkedTimeoutsInput): Promise<WorkflowInstance[]>;
+    /** Clears an instance's timeout retry state so the next sweep retries it. */
+    rearmTimeout(workflowInstanceUuid: string): Promise<WorkflowInstance>;
 }
 //# sourceMappingURL=workflow-timeout.service.d.ts.map

package/dist/services/workflow-timeout.service.js

@@ -20,6 +20,14 @@ let WorkflowTimeoutService = class WorkflowTimeoutService {
     async processExpiredWorkflows(limit) {
         return this.runtime.processExpiredWorkflows({ limit });
     }
+    /** Instances parked after repeated timeout failures, oldest-parked first. */
+    async findParkedTimeouts(input) {
+        return this.runtime.findParkedTimeouts(input);
+    }
+    /** Clears an instance's timeout retry state so the next sweep retries it. */
+    async rearmTimeout(workflowInstanceUuid) {
+        return this.runtime.rearmTimeout(workflowInstanceUuid);
+    }
 };
 WorkflowTimeoutService = __decorate([
     Injectable(),

package/dist/workflow.module.d.ts

@@ -1,5 +1,5 @@
 import { type DynamicModule, type Type, type InjectionToken, type OptionalFactoryDependency } from "@nestjs/common";
-import type { WorkflowDefinition, WorkflowClock, WorkflowPersistenceProvider, WorkflowObserver, ObserverErrorHandler, WorkflowGuard, WorkflowGuardRegistry } from "@duraflows/core";
+import type { WorkflowDefinition, WorkflowClock, WorkflowPersistenceProvider, WorkflowObserver, ObserverErrorHandler, WorkflowGuard, WorkflowGuardRegistry, WorkflowTimeoutRetryOptions } from "@duraflows/core";
 import { type WorkflowCommandRegistration } from "./providers/nest-command-registry.js";
 export interface WorkflowModuleOptions {
     workflows: WorkflowDefinition[];
@@ -10,6 +10,11 @@ export interface WorkflowModuleOptions {
     onObserverError?: ObserverErrorHandler;
     persistence: WorkflowPersistenceProvider;
     clock?: WorkflowClock;
+    /**
+     * How `processExpiredWorkflows` retries an instance whose timeout processing
+     * fails: exponential backoff, then parking. Defaults apply when omitted.
+     */
+    timeoutRetry?: WorkflowTimeoutRetryOptions;
     enableControllers?: boolean;
 }
 export interface WorkflowModuleFactoryConfig {
@@ -20,6 +25,8 @@ export interface WorkflowModuleFactoryConfig {
     guardRegistry?: WorkflowGuardRegistry;
     observers?: WorkflowObserver[];
     onObserverError?: ObserverErrorHandler;
+    /** See {@link WorkflowModuleOptions.timeoutRetry}. */
+    timeoutRetry?: WorkflowTimeoutRetryOptions;
 }
 export interface WorkflowModuleAsyncOptions<TArgs extends unknown[] = unknown[]> {
     imports?: Type<unknown>[];

package/dist/workflow.module.js

@@ -150,6 +150,7 @@ function buildWorkflowProviders(explicitCommands) {
                 definitionStore: definitionStore ?? undefined,
                 observers: config.observers,
                 onObserverError: config.onObserverError,
+                timeoutRetry: config.timeoutRetry,
             }),
             inject: [
                 WORKFLOW_MODULE_OPTIONS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duraflows/nestjs",
-  "version": "5.2.1",
+  "version": "6.1.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": "^5.2.1",
+    "@duraflows/core": "^6.1.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": "5.2.1"
+    "@duraflows/core": "6.1.0"
   },
   "scripts": {
     "build": "tsc --build"