nestjs-serverless-workflow 0.1.0 → 0.1.3

package/dist/core/decorators/with-retry.decorator.d.ts

@@ -1,4 +1,31 @@
 import type { IBackoffRetryConfig } from '../types/index.js';
+/**
+ * Build the metadata key for a specific handler's retry config.
+ * @internal
+ */
 export declare const getRetryKey: (propertyKey: string) => string;
+/**
+ * Method decorator that attaches retry configuration to a workflow handler.
+ *
+ * When an adapter (e.g. {@link DurableLambdaEventHandler}) executes the
+ * transition, it reads this metadata and wraps the call with automatic
+ * retries using the specified backoff strategy.
+ *
+ * @param config - Backoff retry configuration (strategy, attempts, delays).
+ *
+ * @example
+ * ```typescript
+ * @OnEvent('order.process')
+ * @WithRetry({
+ *   handler: 'onProcess',
+ *   maxAttempts: 3,
+ *   strategy: RetryStrategy.EXPONENTIAL_JITTER,
+ *   initialDelay: 500,
+ * })
+ * async onProcess(@Entity() order: Order) {
+ *   // may throw — will be retried up to 3 times
+ * }
+ * ```
+ */
 export declare function WithRetry(config: IBackoffRetryConfig): (_target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 //# sourceMappingURL=with-retry.decorator.d.ts.map

package/dist/core/decorators/with-retry.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-retry.decorator.d.ts","sourceRoot":"","sources":["../../../packages/core/decorators/with-retry.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD,eAAO,MAAM,WAAW,iCAA8D,CAAC;AAEvF,wBAAgB,SAAS,CAAC,MAAM,EAAE,mBAAmB,6FAKpD"}
+{"version":3,"file":"with-retry.decorator.d.ts","sourceRoot":"","sources":["../../../packages/core/decorators/with-retry.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAKpD;;;GAGG;AACH,eAAO,MAAM,WAAW,iCAA8D,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,mBAAmB,6FAKpD"}

package/dist/core/decorators/with-retry.decorator.js

@@ -1,5 +1,33 @@
+/** @internal Base metadata key for retry configuration. */
 const WITH_RETRY_KEY = 'workflow:retry';
+/**
+ * Build the metadata key for a specific handler's retry config.
+ * @internal
+ */
 export const getRetryKey = (propertyKey) => `${WITH_RETRY_KEY}:${propertyKey}`;
+/**
+ * Method decorator that attaches retry configuration to a workflow handler.
+ *
+ * When an adapter (e.g. {@link DurableLambdaEventHandler}) executes the
+ * transition, it reads this metadata and wraps the call with automatic
+ * retries using the specified backoff strategy.
+ *
+ * @param config - Backoff retry configuration (strategy, attempts, delays).
+ *
+ * @example
+ * ```typescript
+ * @OnEvent('order.process')
+ * @WithRetry({
+ *   handler: 'onProcess',
+ *   maxAttempts: 3,
+ *   strategy: RetryStrategy.EXPONENTIAL_JITTER,
+ *   initialDelay: 500,
+ * })
+ * async onProcess(@Entity() order: Order) {
+ *   // may throw — will be retried up to 3 times
+ * }
+ * ```
+ */
 export function WithRetry(config) {
     return (_target, propertyKey, descriptor) => {
         Reflect.defineMetadata(getRetryKey(propertyKey), config, descriptor.value);

package/dist/core/decorators/with-retry.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"with-retry.decorator.js","sourceRoot":"","sources":["../../../packages/core/decorators/with-retry.decorator.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,GAAG,cAAc,IAAI,WAAW,EAAE,CAAC;AAEvF,MAAM,UAAU,SAAS,CAAC,MAA2B,EAAE;IACrD,OAAO,CAAC,OAAY,EAAE,WAAmB,EAAE,UAA8B,EAAE,EAAE,CAAC;QAC5E,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,UAAU,CAAC;IAAA,CACnB,CAAC;AAAA,CACH"}
+{"version":3,"file":"with-retry.decorator.js","sourceRoot":"","sources":["../../../packages/core/decorators/with-retry.decorator.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,GAAG,cAAc,IAAI,WAAW,EAAE,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CAAC,MAA2B,EAAE;IACrD,OAAO,CAAC,OAAY,EAAE,WAAmB,EAAE,UAA8B,EAAE,EAAE,CAAC;QAC5E,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,UAAU,CAAC;IAAA,CACnB,CAAC;AAAA,CACH"}

package/dist/core/decorators/workflow.decorator.d.ts

@@ -1,4 +1,33 @@
 import type { IWorkflowDefinition } from '../../core/index.js';
+/** @internal Metadata key for the workflow definition on a class. */
 export declare const WORKFLOW_DEFINITION_KEY = "workflow:definition";
+/**
+ * Class decorator that declares a NestJS class as a workflow.
+ *
+ * Stores the {@link IWorkflowDefinition} as metadata so the
+ * {@link OrchestratorService} can discover it at module init and build
+ * the routing table for state transitions.
+ *
+ * @typeParam T     - Entity type
+ * @typeParam Event - Union of event names
+ * @typeParam State - Union of state values
+ *
+ * @param definition - The full workflow definition (states, transitions, entity service).
+ *
+ * @example
+ * ```typescript
+ * @Workflow<Order, OrderEvent, OrderStatus>({
+ *   name: 'OrderWorkflow',
+ *   states: {
+ *     finals: [OrderStatus.Completed],
+ *     idles:  [OrderStatus.Pending],
+ *     failed: OrderStatus.Failed,
+ *   },
+ *   transitions: [ ... ],
+ *   entityService: 'entity.order',
+ * })
+ * export class OrderWorkflow { ... }
+ * ```
+ */
 export declare function Workflow<T, Event, State>(definition: IWorkflowDefinition<T, Event, State>): <T extends new (...args: any[]) => {}>(instance: T) => T;
 //# sourceMappingURL=workflow.decorator.d.ts.map

package/dist/core/decorators/workflow.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.decorator.d.ts","sourceRoot":"","sources":["../../../packages/core/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAElD,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAChF,CAAC,uDAKV"}
+{"version":3,"file":"workflow.decorator.d.ts","sourceRoot":"","sources":["../../../packages/core/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAElD,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAChF,CAAC,uDAKV"}

package/dist/core/decorators/workflow.decorator.js

@@ -1,4 +1,33 @@
+/** @internal Metadata key for the workflow definition on a class. */
 export const WORKFLOW_DEFINITION_KEY = 'workflow:definition';
+/**
+ * Class decorator that declares a NestJS class as a workflow.
+ *
+ * Stores the {@link IWorkflowDefinition} as metadata so the
+ * {@link OrchestratorService} can discover it at module init and build
+ * the routing table for state transitions.
+ *
+ * @typeParam T     - Entity type
+ * @typeParam Event - Union of event names
+ * @typeParam State - Union of state values
+ *
+ * @param definition - The full workflow definition (states, transitions, entity service).
+ *
+ * @example
+ * ```typescript
+ * @Workflow<Order, OrderEvent, OrderStatus>({
+ *   name: 'OrderWorkflow',
+ *   states: {
+ *     finals: [OrderStatus.Completed],
+ *     idles:  [OrderStatus.Pending],
+ *     failed: OrderStatus.Failed,
+ *   },
+ *   transitions: [ ... ],
+ *   entityService: 'entity.order',
+ * })
+ * export class OrderWorkflow { ... }
+ * ```
+ */
 export function Workflow(definition) {
     return (instance) => {
         Reflect.defineMetadata(WORKFLOW_DEFINITION_KEY, definition, instance);

package/dist/core/decorators/workflow.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.decorator.js","sourceRoot":"","sources":["../../../packages/core/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAkB,UAAgD,EAAE;IAC1F,OAAO,CAAyC,QAAW,EAAE,EAAE,CAAC;QAC9D,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEtE,OAAO,QAAQ,CAAC;IAAA,CACjB,CAAC;AAAA,CACH"}
+{"version":3,"file":"workflow.decorator.js","sourceRoot":"","sources":["../../../packages/core/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,QAAQ,CAAkB,UAAgD,EAAE;IAC1F,OAAO,CAAyC,QAAW,EAAE,EAAE,CAAC;QAC9D,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEtE,OAAO,QAAQ,CAAC;IAAA,CACjB,CAAC;AAAA,CACH"}

package/dist/core/index.d.ts

@@ -1,3 +1,17 @@
+/**
+ * @module nestjs-serverless-workflow/core
+ *
+ * Core workflow engine for NestJS — provides decorators, services, types, and
+ * utilities for defining and executing state-machine-based workflows.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   Workflow, OnEvent, Entity, Payload,
+ *   WorkflowModule, OrchestratorService,
+ * } from 'nestjs-serverless-workflow/core';
+ * ```
+ */
 export * from './decorators/index.js';
 export * from './providers/index.js';
 export * from './providers/router.factory.js';

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -1,3 +1,17 @@
+/**
+ * @module nestjs-serverless-workflow/core
+ *
+ * Core workflow engine for NestJS — provides decorators, services, types, and
+ * utilities for defining and executing state-machine-based workflows.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   Workflow, OnEvent, Entity, Payload,
+ *   WorkflowModule, OrchestratorService,
+ * } from 'nestjs-serverless-workflow/core';
+ * ```
+ */
 export * from './decorators/index.js';
 export * from './providers/index.js';
 export * from './providers/router.factory.js';

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../packages/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../packages/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/core/providers/orchestrator.service.d.ts

@@ -3,15 +3,38 @@ import { type OnModuleInit } from '@nestjs/common';
 import { DiscoveryService, ModuleRef } from '@nestjs/core';
 import type { IWorkflowEvent } from '../types/workflow-event.interface.js';
 import { StateRouterHelperFactory } from './router.factory.js';
+/**
+ * Central orchestration engine that discovers workflow definitions at startup
+ * and routes incoming {@link IWorkflowEvent}s to the correct handler.
+ *
+ * Registered automatically by {@link WorkflowModule.register}. Adapters
+ * (and application code) call {@link transit} to trigger state transitions
+ * and receive a {@link TransitResult} describing the outcome.
+ */
 export declare class OrchestratorService implements OnModuleInit {
     private readonly discoveryService;
     private readonly routerHelperFactory;
     private readonly moduleRef;
+    /** Event-name → route lookup table, built once during `onModuleInit`. */
     private routes;
     private readonly logger;
     constructor(discoveryService: DiscoveryService, routerHelperFactory: StateRouterHelperFactory, moduleRef: ModuleRef);
     onModuleInit(): void;
+    /**
+     * Returns the retry configuration attached to the handler for a given event,
+     * or `undefined` if the handler has no `@WithRetry()` decorator.
+     */
     getRetryConfig(event: string): IBackoffRetryConfig | undefined;
+    /**
+     * Execute a single state transition for the given workflow event.
+     *
+     * Loads the entity, finds a valid transition, runs the handler, updates
+     * the entity status, and returns a {@link TransitResult} describing what
+     * happened and what the caller should do next.
+     *
+     * @throws {BadRequestException} If no workflow is registered for the event,
+     *   the entity is not found, or no valid transition matches.
+     */
     transit(params: IWorkflowEvent): Promise<TransitResult>;
 }
 //# sourceMappingURL=orchestrator.service.d.ts.map

package/dist/core/providers/orchestrator.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.service.d.ts","sourceRoot":"","sources":["../../../packages/core/providers/orchestrator.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,mBAAmB,EAMxB,KAAK,aAAa,EACnB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBACa,mBAAoB,YAAW,YAAY;IAKpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAE/D,YACmB,gBAAgB,EAAE,gBAAgB,EAClC,mBAAmB,EAAE,wBAAwB,EAC7C,SAAS,EAAE,SAAS,EACnC;IAEJ,YAAY,SA4CX;IAED,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE7D;IAEK,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAqG5D;CACF"}
+{"version":3,"file":"orchestrator.service.d.ts","sourceRoot":"","sources":["../../../packages/core/providers/orchestrator.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,mBAAmB,EAMxB,KAAK,aAAa,EACnB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;GAOG;AACH,qBACa,mBAAoB,YAAW,YAAY;IAMpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,2EAAyE;IACzE,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAE/D,YACmB,gBAAgB,EAAE,gBAAgB,EAClC,mBAAmB,EAAE,wBAAwB,EAC7C,SAAS,EAAE,SAAS,EACnC;IAEJ,YAAY,SA4CX;IAED;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE7D;IAED;;;;;;;;;OASG;IACG,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAqG5D;CACF"}

package/dist/core/providers/orchestrator.service.js

@@ -12,10 +12,19 @@ import { UnretriableException } from '../../exception/unretriable.exception.js';
 import { BadRequestException, Injectable, Logger } from '@nestjs/common';
 import { DiscoveryService, ModuleRef } from '@nestjs/core';
 import { StateRouterHelperFactory } from './router.factory.js';
+/**
+ * Central orchestration engine that discovers workflow definitions at startup
+ * and routes incoming {@link IWorkflowEvent}s to the correct handler.
+ *
+ * Registered automatically by {@link WorkflowModule.register}. Adapters
+ * (and application code) call {@link transit} to trigger state transitions
+ * and receive a {@link TransitResult} describing the outcome.
+ */
 let OrchestratorService = class OrchestratorService {
     discoveryService;
     routerHelperFactory;
     moduleRef;
+    /** Event-name → route lookup table, built once during `onModuleInit`. */
     routes = new Map();
     logger = new Logger(OrchestratorService.name);
     constructor(discoveryService, routerHelperFactory, moduleRef) {
@@ -57,9 +66,23 @@ let OrchestratorService = class OrchestratorService {
         }
         this.logger.log(`StateRouter initialized with ${this.routes.size} routes: `, Array.from(this.routes.keys()));
     }
+    /**
+     * Returns the retry configuration attached to the handler for a given event,
+     * or `undefined` if the handler has no `@WithRetry()` decorator.
+     */
     getRetryConfig(event) {
         return this.routes.get(event)?.retryConfig;
     }
+    /**
+     * Execute a single state transition for the given workflow event.
+     *
+     * Loads the entity, finds a valid transition, runs the handler, updates
+     * the entity status, and returns a {@link TransitResult} describing what
+     * happened and what the caller should do next.
+     *
+     * @throws {BadRequestException} If no workflow is registered for the event,
+     *   the entity is not found, or no valid transition matches.
+     */
     async transit(params) {
         const { urn, payload, event } = params;
         const route = this.routes.get(event);

package/dist/core/providers/orchestrator.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.service.js","sourceRoot":"","sources":["../../../packages/core/providers/orchestrator.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrator.service.js","sourceRoot":"","sources":["../../../packages/core/providers/orchestrator.service.ts"],"names":[],"mappings":"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"}

package/dist/core/providers/router.factory.d.ts

@@ -1,7 +1,15 @@
 import { type Logger } from '@nestjs/common';
 import type { IWorkflowDefinition, IWorkflowEntity } from '../types/index.js';
 import { RouterService } from './router.service.js';
+/**
+ * Factory that creates {@link RouterService} instances with the correct
+ * generic parameters for a given workflow event.
+ *
+ * Registered as a singleton via {@link WorkflowModule} and injected into
+ * {@link OrchestratorService}.
+ */
 export declare class StateRouterHelperFactory {
+    /** Create a new {@link RouterService} scoped to a single event dispatch. */
     create<T, Event, State>(event: Event, entityService: IWorkflowEntity, workflowDefinition: IWorkflowDefinition<T, Event, State>, logger: Logger): RouterService<T, Event, State>;
 }
 //# sourceMappingURL=router.factory.d.ts.map

package/dist/core/providers/router.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.factory.d.ts","sourceRoot":"","sources":["../../../packages/core/providers/router.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBACa,wBAAwB;IACnC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EACpB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,eAAe,EAC9B,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EACxD,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAEhC;CACF"}
+{"version":3,"file":"router.factory.d.ts","sourceRoot":"","sources":["../../../packages/core/providers/router.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AACH,qBACa,wBAAwB;IACnC,4EAA4E;IAC5E,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EACpB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,eAAe,EAC9B,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EACxD,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAEhC;CACF"}

package/dist/core/providers/router.factory.js

@@ -6,7 +6,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { Injectable } from '@nestjs/common';
 import { RouterService } from './router.service.js';
+/**
+ * Factory that creates {@link RouterService} instances with the correct
+ * generic parameters for a given workflow event.
+ *
+ * Registered as a singleton via {@link WorkflowModule} and injected into
+ * {@link OrchestratorService}.
+ */
 let StateRouterHelperFactory = class StateRouterHelperFactory {
+    /** Create a new {@link RouterService} scoped to a single event dispatch. */
     create(event, entityService, workflowDefinition, logger) {
         return new RouterService(event, entityService, workflowDefinition, logger);
     }

package/dist/core/providers/router.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.factory.js","sourceRoot":"","sources":["../../../packages/core/providers/router.factory.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,IAAa,wBAAwB,GAArC,MAAa,wBAAwB;IACnC,MAAM,CACJ,KAAY,EACZ,aAA8B,EAC9B,kBAAwD,EACxD,MAAc,EACkB;QAChC,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAAA,CAC5E;CACF,CAAA;AATY,wBAAwB;IADpC,UAAU,EAAE;GACA,wBAAwB,CASpC"}
+{"version":3,"file":"router.factory.js","sourceRoot":"","sources":["../../../packages/core/providers/router.factory.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AAEH,IAAa,wBAAwB,GAArC,MAAa,wBAAwB;IACnC,4EAA4E;IAC5E,MAAM,CACJ,KAAY,EACZ,aAA8B,EAC9B,kBAAwD,EACxD,MAAc,EACkB;QAChC,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAAA,CAC5E;CACF,CAAA;AAVY,wBAAwB;IADpC,UAAU,EAAE;GACA,wBAAwB,CAUpC"}

package/dist/core/providers/router.service.d.ts

@@ -1,12 +1,33 @@
 import { type Logger } from '@nestjs/common';
 import type { Duration, ITransitionEvent, IWorkflowDefinition, IWorkflowEntity } from '../types/index.js';
+/**
+ * Transition-matching and entity-validation logic for a single workflow event.
+ *
+ * Created per-request by {@link StateRouterHelperFactory}. Encapsulates the
+ * rules for finding a valid transition, checking conditions, resolving idle
+ * states, and building handler arguments from parameter decorators.
+ *
+ * @typeParam T     - Entity type
+ * @typeParam Event - Event name type
+ * @typeParam State - State value type
+ * @internal
+ */
 export declare class RouterService<T, Event, State> {
     private readonly event;
     private readonly entityService;
     private readonly workflowDefinition;
     private readonly logger;
     constructor(event: Event, entityService: IWorkflowEntity, workflowDefinition: IWorkflowDefinition<T, Event, State>, logger: Logger);
+    /** Load the entity by URN and verify it exists. Warns if already in a final state. */
     loadAndValidateEntity(urn: string | number): Promise<T>;
+    /**
+     * Search the workflow's transitions for a valid match given the entity's
+     * current state, the incoming event, and any guard conditions.
+     *
+     * @param options.skipEventCheck - When `true`, matches transitions by state
+     *   only (used for auto-transition after a handler completes).
+     * @returns The first matching transition and whether any event+state pair matched.
+     */
     findValidTransition<P>(entity: T, payload: P, options?: {
         skipEventCheck?: boolean;
     }): {
@@ -15,8 +36,15 @@ export declare class RouterService<T, Event, State> {
     };
     private matchesState;
     private matchesEvent;
+    /** Check whether the entity's current state is listed as an idle state. */
     isInIdleStatus(entity: T): boolean;
+    /** Return the per-state timeout for an idle state, or `undefined` if none configured. */
     getIdleTimeout(state: string | number): Duration | undefined;
+    /**
+     * Resolve `@Entity()` and `@Payload()` parameter decorators into an ordered
+     * argument array for the handler method. Falls back to the legacy
+     * `{ entity, payload }` shape when no decorator metadata is present.
+     */
     buildParamDecorators(entity: T, payload: any, target: any, propertyKey: string | symbol): any[];
 }
 //# sourceMappingURL=router.service.d.ts.map

package/dist/core/providers/router.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.service.d.ts","sourceRoot":"","sources":["../../../packages/core/providers/router.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjG,qBAAa,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK;IAEtC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,YACmB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,eAAe,EAC9B,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EACxD,MAAM,EAAE,MAAM,EAC7B;IAEE,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAe5D;IAED,mBAAmB,CAAC,CAAC,EACnB,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACrC;QAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QAAC,kBAAkB,EAAE,OAAO,CAAA;KAAE,CA0B1F;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAIpB,cAAc,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAUjC;IAED,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAO3D;IAED,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,SAmBtF;CACF"}
+{"version":3,"file":"router.service.d.ts","sourceRoot":"","sources":["../../../packages/core/providers/router.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjG;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK;IAEtC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,YACmB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,eAAe,EAC9B,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EACxD,MAAM,EAAE,MAAM,EAC7B;IAEJ,sFAAsF;IAChF,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAe5D;IAED;;;;;;;OAOG;IACH,mBAAmB,CAAC,CAAC,EACnB,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACrC;QAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QAAC,kBAAkB,EAAE,OAAO,CAAA;KAAE,CA0B1F;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,cAAc,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAUjC;IAED,yFAAyF;IACzF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAO3D;IAED;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,SAmBtF;CACF"}

package/dist/core/providers/router.service.js

@@ -1,4 +1,16 @@
 import { BadRequestException } from '@nestjs/common';
+/**
+ * Transition-matching and entity-validation logic for a single workflow event.
+ *
+ * Created per-request by {@link StateRouterHelperFactory}. Encapsulates the
+ * rules for finding a valid transition, checking conditions, resolving idle
+ * states, and building handler arguments from parameter decorators.
+ *
+ * @typeParam T     - Entity type
+ * @typeParam Event - Event name type
+ * @typeParam State - State value type
+ * @internal
+ */
 export class RouterService {
     event;
     entityService;
@@ -10,6 +22,7 @@ export class RouterService {
         this.workflowDefinition = workflowDefinition;
         this.logger = logger;
     }
+    /** Load the entity by URN and verify it exists. Warns if already in a final state. */
     async loadAndValidateEntity(urn) {
         const entity = await this.entityService.load(urn);
         if (!entity) {
@@ -23,6 +36,14 @@ export class RouterService {
         }
         return entity;
     }
+    /**
+     * Search the workflow's transitions for a valid match given the entity's
+     * current state, the incoming event, and any guard conditions.
+     *
+     * @param options.skipEventCheck - When `true`, matches transitions by state
+     *   only (used for auto-transition after a handler completes).
+     * @returns The first matching transition and whether any event+state pair matched.
+     */
     findValidTransition(entity, payload, options) {
         const currentStatus = this.entityService.status(entity);
         const skipEventCheck = options?.skipEventCheck === true;
@@ -55,6 +76,7 @@ export class RouterService {
     matchesEvent(event) {
         return Array.isArray(event) ? event.includes(this.event) : event === this.event;
     }
+    /** Check whether the entity's current state is listed as an idle state. */
     isInIdleStatus(entity) {
         const status = this.entityService.status(entity);
         if (!status) {
@@ -64,6 +86,7 @@ export class RouterService {
             ? entry.state === status
             : entry === status);
     }
+    /** Return the per-state timeout for an idle state, or `undefined` if none configured. */
     getIdleTimeout(state) {
         for (const entry of this.workflowDefinition.states.idles) {
             if (typeof entry === 'object' && entry !== null && 'state' in entry) {
@@ -73,6 +96,11 @@ export class RouterService {
         }
         return undefined;
     }
+    /**
+     * Resolve `@Entity()` and `@Payload()` parameter decorators into an ordered
+     * argument array for the handler method. Falls back to the legacy
+     * `{ entity, payload }` shape when no decorator metadata is present.
+     */
     buildParamDecorators(entity, payload, target, propertyKey) {
         // Metadata is stored on the prototype when decorators are applied
         const prototype = target.constructor?.prototype || target;

package/dist/core/providers/router.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.service.js","sourceRoot":"","sources":["../../../packages/core/providers/router.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.service.js","sourceRoot":"","sources":["../../../packages/core/providers/router.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAe,MAAM,gBAAgB,CAAC;AAGlE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IAEL,KAAK;IACL,aAAa;IACb,kBAAkB;IAClB,MAAM;IAJzB,YACmB,KAAY,EACZ,aAA8B,EAC9B,kBAAwD,EACxD,MAAc,EAC/B;qBAJiB,KAAK;6BACL,aAAa;kCACb,kBAAkB;sBAClB,MAAM;IACtB,CAAC;IAEJ,sFAAsF;IACtF,KAAK,CAAC,qBAAqB,CAAC,GAAoB,EAAc;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;YAC5C,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAgC,CAAC;QAE3F,IAAI,kBAAkB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,wEAAwE,EAAE,GAAG,CAAC,CAAC;QAChH,CAAC;QAED,OAAO,MAAM,CAAC;IAAA,CACf;IAED;;;;;;;OAOG;IACH,mBAAmB,CACjB,MAAS,EACT,OAAU,EACV,OAAsC,EACoD;QAC1F,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;QAExD,IAAI,UAAU,GAAgD,IAAI,CAAC;QACnE,IAAI,kBAAkB,GAAG,KAAK,CAAC;QAE/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC;gBAAE,SAAS;YACxD,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YAE7D,kBAAkB,GAAG,IAAI,CAAC;YAE1B,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAAE,SAAS;YAE7D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;gBAClC,IAAI,cAAc;oBAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;gBACpE,MAAM,IAAI,mBAAmB,CAC3B,8GAA8G,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CACxI,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAAA,CACvD;IAEO,YAAY,CAAC,IAAqB,EAAE,aAA8B,EAAW;QACnF,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,CAAC,CAAE,IAA+B,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC1D,CAAC,CAAE,IAAwB,KAAK,aAAa,CAAC;IAAA,CACjD;IAEO,YAAY,CAAC,KAAsB,EAAW;QACpD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC;IAAA,CACjF;IAED,2EAA2E;IAC3E,cAAc,CAAC,MAAS,EAAW;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACrG,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACzD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK;YAC7D,CAAC,CAAE,KAAK,CAAC,KAAyB,KAAK,MAAM;YAC7C,CAAC,CAAE,KAAyB,KAAK,MAAM,CAC1C,CAAC;IAAA,CACH;IAED,yFAAyF;IACzF,cAAc,CAAC,KAAsB,EAAwB;QAC3D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;gBACpE,IAAK,KAAK,CAAC,KAAyB,KAAK,KAAK;oBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IAAA,CAClB;IAED;;;;OAIG;IACH,oBAAoB,CAAC,MAAS,EAAE,OAAY,EAAE,MAAW,EAAE,WAA4B,EAAE;QACvF,kEAAkE;QAClE,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,SAAS,IAAI,MAAM,CAAC;QAC1D,MAAM,UAAU,GACd,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAE1E,IAAI,IAAI,GAAU,EAAE,CAAC;QACrB,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,8CAA8C;YAC9C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;oBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;qBACjD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;oBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;;oBACxD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;YACpC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,kDAAkD;YAClD,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IAAA,CACb;CACF"}

package/dist/core/types/entity.interface.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Contract for the persistence layer of a workflow entity.
+ *
+ * Implement this interface in an `@Injectable()` service and register it with
+ * {@link WorkflowModule.register} under the injection token referenced by
+ * your `@Workflow({ entityService })` definition.
+ *
+ * @typeParam T     - The entity type (e.g. `Order`, `User`)
+ * @typeParam State - The enum or union of valid entity states
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class OrderEntityService implements IWorkflowEntity<Order, OrderStatus> {
+ *   async create() { ... }
+ *   async load(urn) { ... }
+ *   async update(entity, status) { ... }
+ *   status(entity) { return entity.status; }
+ *   urn(entity) { return entity.id; }
+ * }
+ * ```
+ */
 export interface IWorkflowEntity<T = any, State = string | number> {
     /**
      * Creates a new instance of the entity

package/dist/core/types/entity.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity.interface.d.ts","sourceRoot":"","sources":["../../../packages/core/types/entity.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM;IAC/D;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7C;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC;IAEzB;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;CACjC"}
+{"version":3,"file":"entity.interface.d.ts","sourceRoot":"","sources":["../../../packages/core/types/entity.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM;IAC/D;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7C;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC;IAEzB;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;CACjC"}

package/dist/core/types/retry.interface.d.ts

@@ -1,5 +1,9 @@
 /**
- * Retry strategy types
+ * Available backoff strategies for retry logic.
+ *
+ * - `FIXED` — constant delay between attempts.
+ * - `EXPONENTIAL` — delay doubles (or multiplies) on each attempt.
+ * - `EXPONENTIAL_JITTER` — exponential with randomised jitter to spread load (default).
  */
 export declare enum RetryStrategy {
     FIXED = "fixed",
@@ -7,17 +11,43 @@ export declare enum RetryStrategy {
     EXPONENTIAL_JITTER = "exponential_jitter"
 }
 /**
- * Retry configuration for workflow steps
+ * Configuration for the {@link WithRetry} decorator.
+ *
+ * Attach to a workflow handler method to enable automatic retries with
+ * configurable backoff. Used by adapters (e.g. {@link DurableLambdaEventHandler})
+ * to wrap `orchestrator.transit()` calls.
+ *
+ * @example
+ * ```typescript
+ * @OnEvent('order.process')
+ * @WithRetry({
+ *   handler: 'onProcess',
+ *   maxAttempts: 3,
+ *   strategy: RetryStrategy.EXPONENTIAL_JITTER,
+ *   initialDelay: 500,
+ * })
+ * async onProcess(@Entity() order: Order) { ... }
+ * ```
  */
 export interface IBackoffRetryConfig {
+    /** Name of the handler method this config belongs to. */
     handler: string;
+    /** Maximum number of attempts (including the initial try). */
     maxAttempts: number;
+    /** Backoff strategy. Defaults to `EXPONENTIAL_JITTER`. */
     strategy?: RetryStrategy;
+    /** Base delay in milliseconds before the first retry. Defaults to `1000`. */
     initialDelay?: number;
+    /** Multiplier applied on each attempt for exponential strategies. Defaults to `2`. */
     backoffMultiplier?: number;
+    /** Upper bound for computed delay in milliseconds. Defaults to `60000`. */
     maxDelay?: number;
+    /** `true` for full jitter, or a number `0–1` for partial jitter percentage. */
     jitter?: boolean | number;
 }
+/**
+ * Minimal interface for a retry-capable handler.
+ */
 export interface IRetryHandler {
     execute: () => Promise<void>;
 }

package/dist/core/types/retry.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.interface.d.ts","sourceRoot":"","sources":["../../../packages/core/types/retry.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"retry.interface.d.ts","sourceRoot":"","sources":["../../../packages/core/types/retry.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;CAC1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B"}

package/dist/core/types/retry.interface.js

@@ -1,6 +1,10 @@
 export { RetryStrategy };
 /**
- * Retry strategy types
+ * Available backoff strategies for retry logic.
+ *
+ * - `FIXED` — constant delay between attempts.
+ * - `EXPONENTIAL` — delay doubles (or multiplies) on each attempt.
+ * - `EXPONENTIAL_JITTER` — exponential with randomised jitter to spread load (default).
  */
 var RetryStrategy;
 (function (RetryStrategy) {

package/dist/core/types/retry.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.interface.js","sourceRoot":"","sources":["../../../packages/core/types/retry.interface.ts"],"names":[],"mappings":"SAGY,aAAa;AAHzB;;GAEG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,4CAA2B,CAAA;IAC3B,0DAAyC,CAAA;AAAC,CAC5C,EAJY,aAAa,KAAb,aAAa,QAIxB"}
+{"version":3,"file":"retry.interface.js","sourceRoot":"","sources":["../../../packages/core/types/retry.interface.ts"],"names":[],"mappings":"SAOY,aAAa;AAPzB;;;;;;GAMG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,4CAA2B,CAAA;IAC3B,0DAAyC,CAAA;AAAC,CAC5C,EAJY,aAAa,KAAb,aAAa,QAIxB"}