nestjs-serverless-workflow 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"default.decorator.d.ts","sourceRoot":"","sources":["../../../src/workflow/decorators/default.decorator.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD,eAAO,MAAM,SAAS,GAAI,QAAQ,GAAG,EAAE,cAAc,MAAM,EAAE,YAAY,kBAAkB,uBAM1F,CAAC"}

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

@@ -0,0 +1,9 @@
+export const WORKFLOW_DEFAULT_EVENT = 'workflow.default';
+export const OnDefault = (target, _propertyKey, descriptor) => {
+    let existingFallback = Reflect.getMetadata(WORKFLOW_DEFAULT_EVENT, target.constructor);
+    if (!existingFallback) {
+        Reflect.defineMetadata(WORKFLOW_DEFAULT_EVENT, descriptor.value, target.constructor);
+    }
+    return descriptor;
+};
+//# sourceMappingURL=default.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default.decorator.js","sourceRoot":"","sources":["../../../src/workflow/decorators/default.decorator.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAEzD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAW,EAAE,YAAoB,EAAE,UAA8B,EAAE,EAAE;IAC7F,IAAI,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACvF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { ISagaConfig } from '@/workflow';
+export declare const WORKFLOW_HANDLER_KEY = "workflow:metadata";
+export declare const OnEvent: (event: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const OnCompensation: (event: string, config: ISagaConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=event.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.decorator.d.ts","sourceRoot":"","sources":["../../../src/workflow/decorators/event.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAEhE,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,MAAM,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAW1G,CAAC;AAEF,eAAO,MAAM,cAAc,GACxB,OAAO,MAAM,EAAE,QAAQ,WAAW,MAAM,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAWxG,CAAC"}

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

@@ -0,0 +1,20 @@
+export const WORKFLOW_HANDLER_KEY = 'workflow:metadata';
+export const OnEvent = (event) => (target, propertyKey, descriptor) => {
+    let workflowHandlers = Reflect.getMetadata(WORKFLOW_HANDLER_KEY, target.constructor);
+    if (!workflowHandlers) {
+        workflowHandlers = [];
+        Reflect.defineMetadata(WORKFLOW_HANDLER_KEY, workflowHandlers, target.constructor);
+    }
+    workflowHandlers.push({ event, handler: descriptor.value, name: propertyKey });
+    return descriptor;
+};
+export const OnCompensation = (event, config) => (target, propertyKey, descriptor) => {
+    let workflowHandlers = Reflect.getMetadata(WORKFLOW_HANDLER_KEY, target.constructor);
+    if (!workflowHandlers) {
+        workflowHandlers = [];
+        Reflect.defineMetadata(WORKFLOW_HANDLER_KEY, workflowHandlers, target.constructor);
+    }
+    workflowHandlers.push({ event, handler: descriptor.value, name: propertyKey, sagaConfig: config });
+    return descriptor;
+};
+//# sourceMappingURL=event.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.decorator.js","sourceRoot":"","sources":["../../../src/workflow/decorators/event.decorator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B,EAAE,EAAE;IAC7G,IAAI,gBAAgB,GAAuB,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAEzG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,EAAE,CAAC;QACtB,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACrF,CAAC;IAED,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAE/E,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GACzB,CAAC,KAAa,EAAE,MAAmB,EAAE,EAAE,CAAC,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B,EAAE,EAAE;IAC3G,IAAI,gBAAgB,GAAuB,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAEzG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,EAAE,CAAC;QACtB,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACrF,CAAC;IAED,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnG,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}

package/dist/workflow/decorators/index.d.ts

@@ -0,0 +1,6 @@
+export * from './default.decorator';
+export * from './event.decorator';
+export * from './params.decorator';
+export * from './with-retry.decorator';
+export * from './workflow.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/dist/workflow/decorators/index.js

@@ -0,0 +1,6 @@
+export * from './default.decorator';
+export * from './event.decorator';
+export * from './params.decorator';
+export * from './with-retry.decorator';
+export * from './workflow.decorator';
+//# sourceMappingURL=index.js.map

package/dist/workflow/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function Entity(): ParameterDecorator;
+export declare function Payload<P>(dto?: P): ParameterDecorator;
+//# sourceMappingURL=params.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.decorator.d.ts","sourceRoot":"","sources":["../../../src/workflow/decorators/params.decorator.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,kBAAkB,CAO3C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAOtD"}

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

@@ -0,0 +1,19 @@
+export function Entity() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey || parameterIndex === undefined)
+            throw new Error('Entity decorator can only be used on method parameters');
+        const existing = Reflect.getOwnMetadata('workflow:params', target, propertyKey) || [];
+        existing.push({ index: parameterIndex, type: 'entity' });
+        Reflect.defineMetadata('workflow:params', existing, target, propertyKey);
+    };
+}
+export function Payload(dto) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey || parameterIndex === undefined)
+            throw new Error('Payload decorator can only be used on method parameters');
+        const existing = Reflect.getOwnMetadata('workflow:params', target, propertyKey) || [];
+        existing.push({ index: parameterIndex, type: 'payload', dto });
+        Reflect.defineMetadata('workflow:params', existing, target, propertyKey);
+    };
+}
+//# sourceMappingURL=params.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.decorator.js","sourceRoot":"","sources":["../../../src/workflow/decorators/params.decorator.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM;IACpB,OAAO,CAAC,MAAc,EAAE,WAA6B,EAAE,cAAuB,EAAE,EAAE;QAChF,IAAI,CAAC,WAAW,IAAI,cAAc,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5H,MAAM,QAAQ,GAAe,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAI,GAAO;IAChC,OAAO,CAAC,MAAc,EAAE,WAA6B,EAAE,cAAuB,EAAE,EAAE;QAChF,IAAI,CAAC,WAAW,IAAI,cAAc,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7H,MAAM,QAAQ,GAAe,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type IBackoffRetryConfig } from '../types';
+export declare const getRetryKey: (propertyKey: string) => string;
+export declare function WithRetry(config: IBackoffRetryConfig): (_target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=with-retry.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.decorator.d.ts","sourceRoot":"","sources":["../../../src/workflow/decorators/with-retry.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,WAAuC,CAAC;AAEvF,wBAAgB,SAAS,CAAC,MAAM,EAAE,mBAAmB,IAC3C,SAAS,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAI1E"}

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

@@ -0,0 +1,9 @@
+const WITH_RETRY_KEY = 'workflow:retry';
+export const getRetryKey = (propertyKey) => `${WITH_RETRY_KEY}:${propertyKey}`;
+export function WithRetry(config) {
+    return (_target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(getRetryKey(propertyKey), config, descriptor.value);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=with-retry.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.decorator.js","sourceRoot":"","sources":["../../../src/workflow/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;IACnD,OAAO,CAAC,OAAY,EAAE,WAAmB,EAAE,UAA8B,EAAE,EAAE;QAC3E,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+import { type IWorkflowDefinition } from '@/workflow';
+export declare const WORKFLOW_DEFINITION_KEY = "workflow:definition";
+export declare function Workflow<T, Event, State>(definition: IWorkflowDefinition<T, Event, State>): <T_1 extends {
+    new (...args: any[]): {};
+}>(instance: T_1) => T_1;
+//# sourceMappingURL=workflow.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.decorator.d.ts","sourceRoot":"","sources":["../../../src/workflow/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,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,IACvE,GAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,UAAU,GAAC,SAKrE"}

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

@@ -0,0 +1,8 @@
+export const WORKFLOW_DEFINITION_KEY = 'workflow:definition';
+export function Workflow(definition) {
+    return function (instance) {
+        Reflect.defineMetadata(WORKFLOW_DEFINITION_KEY, definition, instance);
+        return instance;
+    };
+}
+//# sourceMappingURL=workflow.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.decorator.js","sourceRoot":"","sources":["../../../src/workflow/decorators/workflow.decorator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAkB,UAAgD;IACxF,OAAO,UAAkD,QAAW;QAClE,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEtE,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/workflow/index.d.ts

@@ -0,0 +1,7 @@
+export * from './decorators';
+export * from './providers';
+export * from './providers/router.factory';
+export * from './types';
+export * from './utils';
+export * from './workflow.module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/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"}

package/dist/workflow/index.js

@@ -0,0 +1,7 @@
+export * from './decorators';
+export * from './providers';
+export * from './providers/router.factory';
+export * from './types';
+export * from './utils';
+export * from './workflow.module';
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/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"}

package/dist/workflow/providers/index.d.ts

@@ -0,0 +1,4 @@
+export * from './ochestrator.service';
+export * from './router.factory';
+export * from './router.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/workflow/providers/index.js

@@ -0,0 +1,4 @@
+export * from './ochestrator.service';
+export * from './router.factory';
+export * from './router.service';
+//# sourceMappingURL=index.js.map

package/dist/workflow/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/workflow/providers/ochestrator.service.d.ts

@@ -0,0 +1,32 @@
+import type { IWorkflowEvent } from '@/event-bus';
+import { DiscoveryService, ModuleRef } from '@nestjs/core';
+import { StateRouterHelperFactory } from './router.factory';
+/**
+ * TODO:
+ * 1. SAGA: SAGA transaction will update history storage each transition, history service is implemented from `ISagaHistoryStore`
+ *   +) If reverese order, execute compensations in reverse order
+ *   +) If in-order, execute compensations in order
+ *   +) If parallel, execute compensations in parallel
+ * 2. Replay workflow:
+ *   +) If compensation in-progress, execute compensation first
+ *   +) If compensation completed, start from start state
+ *   +) If no compensation and transaction is failed, start from last failed state
+ *   +) If no compensation and transaction is completed, throw error
+ * 3. Checkpointing for long-running tasks (Serverless)
+ *   +) Handle serverless function timeout, store current entity state to checkpoint broker via `BrokerPublisher`
+ *   +) BrokerPublisher.publish will implement delay queue via time calculated from RetryService.execute()
+ * 4. Retry Service: Retry in state handler level via `IRetryHandler`
+ *   +) If CompensationHandler
+ * 5. Timeout handling: listen for timeout event emitted by Runtime Adapter (DEV DONE - TESTING)
+ */
+export declare class OrchestratorService {
+    private readonly discoveryService;
+    private readonly routerHelperFactory;
+    private readonly moduleRef;
+    private routes;
+    private readonly logger;
+    constructor(discoveryService: DiscoveryService, routerHelperFactory: StateRouterHelperFactory, moduleRef: ModuleRef);
+    onModuleInit(): void;
+    transit(params: IWorkflowEvent): Promise<void>;
+}
+//# sourceMappingURL=ochestrator.service.d.ts.map

package/dist/workflow/providers/ochestrator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ochestrator.service.d.ts","sourceRoot":"","sources":["../../../src/workflow/providers/ochestrator.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,aAAa,CAAC;AAgBpE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,mBAAmB;IAK5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,MAAM,CAA6E;IAC3F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAG5C,gBAAgB,EAAE,gBAAgB,EAClC,mBAAmB,EAAE,wBAAwB,EAC7C,SAAS,EAAE,SAAS;IAGvC,YAAY;IAuDN,OAAO,CAAC,MAAM,EAAE,cAAc;CA+GrC"}

package/dist/workflow/providers/ochestrator.service.js

@@ -0,0 +1,183 @@
+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 OrchestratorService_1;
+import { UnretriableException } from '@/exception/unretriable.exception';
+import { getRetryKey, WORKFLOW_DEFAULT_EVENT, WORKFLOW_DEFINITION_KEY, WORKFLOW_HANDLER_KEY } from '@/workflow';
+import { BadRequestException, Injectable, Logger } from '@nestjs/common';
+import { DiscoveryService, ModuleRef } from '@nestjs/core';
+import { StateRouterHelperFactory } from './router.factory';
+/**
+ * TODO:
+ * 1. SAGA: SAGA transaction will update history storage each transition, history service is implemented from `ISagaHistoryStore`
+ *   +) If reverese order, execute compensations in reverse order
+ *   +) If in-order, execute compensations in order
+ *   +) If parallel, execute compensations in parallel
+ * 2. Replay workflow:
+ *   +) If compensation in-progress, execute compensation first
+ *   +) If compensation completed, start from start state
+ *   +) If no compensation and transaction is failed, start from last failed state
+ *   +) If no compensation and transaction is completed, throw error
+ * 3. Checkpointing for long-running tasks (Serverless)
+ *   +) Handle serverless function timeout, store current entity state to checkpoint broker via `BrokerPublisher`
+ *   +) BrokerPublisher.publish will implement delay queue via time calculated from RetryService.execute()
+ * 4. Retry Service: Retry in state handler level via `IRetryHandler`
+ *   +) If CompensationHandler
+ * 5. Timeout handling: listen for timeout event emitted by Runtime Adapter (DEV DONE - TESTING)
+ */
+let OrchestratorService = OrchestratorService_1 = class OrchestratorService {
+    constructor(discoveryService, routerHelperFactory, moduleRef) {
+        this.discoveryService = discoveryService;
+        this.routerHelperFactory = routerHelperFactory;
+        this.moduleRef = moduleRef;
+        this.routes = new Map();
+        this.logger = new Logger(OrchestratorService_1.name);
+    }
+    onModuleInit() {
+        const providers = this.discoveryService.getProviders();
+        for (const provider of providers) {
+            const { instance } = provider;
+            if (!instance || !instance.constructor)
+                continue;
+            const [workflowDefinition, handlerStore, defaultHandler] = [
+                Reflect.getMetadata(WORKFLOW_DEFINITION_KEY, instance.constructor),
+                Reflect.getMetadata(WORKFLOW_HANDLER_KEY, instance.constructor),
+                Reflect.getMetadata(WORKFLOW_DEFAULT_EVENT, instance.constructor),
+                [],
+            ];
+            if (!handlerStore || handlerStore.length === 0 || !workflowDefinition) {
+                this.logger.warn(`No handlers found for workflow: ${workflowDefinition.name}`);
+                continue;
+            }
+            const brokerPublisher = this.moduleRef.get(workflowDefinition.brokerPublisher, {
+                strict: true,
+            });
+            const entityService = this.moduleRef.get(workflowDefinition.entityService, { strict: true });
+            const historyService = workflowDefinition.saga
+                ? this.moduleRef.get(workflowDefinition.saga.historyService, {
+                    strict: true,
+                })
+                : undefined;
+            for (const handler of handlerStore) {
+                if (this.routes.has(handler.event)) {
+                    throw new Error(`Duplicate workflow event handler detected for event: ${handler.event} in workflow: ${workflowDefinition.name}`);
+                }
+                const retryConfig = this.moduleRef.get(getRetryKey(handler.name));
+                this.routes.set(handler.event, {
+                    handler: handler.handler,
+                    definition: workflowDefinition,
+                    instance,
+                    handlerName: handler.name,
+                    retryConfig,
+                    defaultHandler,
+                    entityService,
+                    brokerPublisher,
+                    historyService,
+                });
+            }
+        }
+        this.logger.log(`StateRouter initialized with ${this.routes.size} routes: `, Array.from(this.routes.keys()));
+    }
+    async transit(params) {
+        const { urn, payload, attempt, topic: event } = params;
+        const route = this.routes.get(event);
+        if (!route)
+            throw new BadRequestException(`No workflow found for event: ${event}`);
+        const { definition, instance, defaultHandler, entityService } = route;
+        if (!definition) {
+            const className = instance.name;
+            throw new BadRequestException(`Workflow definition metadata is missing for controller class "${className}". Ensure @Workflow(...) is applied to the class and that decorators are not reordered.`);
+        }
+        const logger = new Logger(`Router::${definition.name}`);
+        const routerHelper = this.routerHelperFactory.create(event, entityService, definition, logger);
+        logger.log(`Method ${route.handlerName} is being called with arguments:`, params);
+        // ========================= BEGIN routing logic =========================
+        let entity = await routerHelper.loadAndValidateEntity(urn);
+        const entityStatus = entityService.status(entity);
+        let transition = routerHelper.findValidTransition(entity, payload);
+        let stepPayload = payload;
+        if (!transition) {
+            if (defaultHandler) {
+                logger.log(`Falling back to the default transition`, urn);
+                await defaultHandler(entity, event, payload);
+            }
+            throw new BadRequestException(`No matched transition for event: ${event}, status: ${entityStatus}. Please verify your workflow definition!`);
+        }
+        try {
+            while (!!transition) {
+                logger.log('======= WORKFLOW STEP STARTED =======');
+                if (routerHelper.isInIdleStatus(entity)) {
+                    if (!transition.conditions) {
+                        throw new BadRequestException(`Idle state ${entityStatus} transitions must provide conditions for further navigation, please check for workflow definition and try again!`);
+                    }
+                    if (transition.conditions.some((condition) => !condition)) {
+                        logger.log(`Element ${urn} is idle from ${transition.from} to ${transition.to} status. Waiting for external event...`);
+                        break;
+                    }
+                }
+                const currentEntityStatus = entityService.status(entity);
+                logger.log(`Executing transition from ${currentEntityStatus} to ${transition.to} (${urn})`);
+                // Store entity state before transition (for SAGA)
+                const beforeState = { ...entity };
+                // Get the correct handler for the current transition event
+                const currentEvent = Array.isArray(transition.event) ? transition.event[0] : transition.event;
+                const currentRoute = this.routes.get(currentEvent);
+                if (!currentRoute) {
+                    throw new BadRequestException(`No handler found for event: ${currentEvent}`);
+                }
+                const { handlerName, handler, retryConfig } = currentRoute;
+                const args = routerHelper.buildParamDecorators(entity, stepPayload, instance, handlerName);
+                try {
+                    stepPayload = await handler.apply(instance, args);
+                }
+                catch (e) {
+                    if (!retryConfig)
+                        throw e;
+                    const { maxAttempts } = retryConfig;
+                    if (e instanceof BadRequestException || e instanceof UnretriableException || attempt >= maxAttempts) {
+                        logger.error('Unretriable exception found!');
+                        return;
+                    }
+                    // TODO: add more payload: original method, payload, entity, retryConfigs
+                    await this.moduleRef.get(retryConfig.handler).execute();
+                }
+                // Update entity status
+                entity = await entityService.update(entity, transition.to);
+                logger.log(`Element transitioned from ${currentEntityStatus} to ${transition.to} (${urn})`);
+                const updatedStatus = entityService.status(entity);
+                const definedFinalStates = definition.states.finals;
+                if (definedFinalStates.includes(updatedStatus)) {
+                    logger.log(`Element ${urn} reached final state: ${updatedStatus}`);
+                    break;
+                }
+                // NOTE: Get next event for automatic transitions
+                transition = routerHelper.findValidTransition(entity, stepPayload, {
+                    skipEventCheck: true,
+                });
+                if (!transition) {
+                    logger.warn(`There's no valid next transition from ${updatedStatus} or the condition is not met. (${urn})`);
+                }
+                logger.log(`Next event: ${transition?.event ?? 'none'} Next status: ${updatedStatus} (${urn})`);
+            }
+        }
+        catch (e) {
+            await entityService.update(entity, definition.states.failed);
+            logger.error(`Transition failed. Setting status to failed (${e.message})`, urn);
+            throw e;
+        }
+    }
+};
+OrchestratorService = OrchestratorService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [DiscoveryService,
+        StateRouterHelperFactory,
+        ModuleRef])
+], OrchestratorService);
+export { OrchestratorService };
+//# sourceMappingURL=ochestrator.service.js.map

package/dist/workflow/providers/ochestrator.service.js.map

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

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

@@ -0,0 +1,7 @@
+import { Logger } from '@nestjs/common';
+import { RouterService } from './router.service';
+import type { IWorkflowEntity, IWorkflowDefinition } from '../types';
+export declare class StateRouterHelperFactory {
+    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/workflow/providers/router.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.factory.d.ts","sourceRoot":"","sources":["../../../src/workflow/providers/router.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAErE,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;CAGlC"}

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

@@ -0,0 +1,18 @@
+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;
+};
+import { Injectable } from '@nestjs/common';
+import { RouterService } from './router.service';
+let StateRouterHelperFactory = class StateRouterHelperFactory {
+    create(event, entityService, workflowDefinition, logger) {
+        return new RouterService(event, entityService, workflowDefinition, logger);
+    }
+};
+StateRouterHelperFactory = __decorate([
+    Injectable()
+], StateRouterHelperFactory);
+export { StateRouterHelperFactory };
+//# sourceMappingURL=router.factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.factory.js","sourceRoot":"","sources":["../../../src/workflow/providers/router.factory.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAU,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI1C,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACnC,MAAM,CACJ,KAAY,EACZ,aAA8B,EAC9B,kBAAwD,EACxD,MAAc;QAEd,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;CACF,CAAA;AATY,wBAAwB;IADpC,UAAU,EAAE;GACA,wBAAwB,CASpC"}

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

@@ -0,0 +1,16 @@
+import { Logger } from '@nestjs/common';
+import type { IWorkflowEntity, ITransitionEvent, IWorkflowDefinition } from '../types';
+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);
+    loadAndValidateEntity(urn: string | number): Promise<T>;
+    findValidTransition<P>(entity: T, payload: P, options?: {
+        skipEventCheck?: boolean;
+    }): ITransitionEvent<T, Event, State, P> | null;
+    isInIdleStatus(entity: T): boolean;
+    buildParamDecorators(entity: T, payload: any, target: any, propertyKey: string | symbol): any[];
+}
+//# sourceMappingURL=router.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.service.d.ts","sourceRoot":"","sources":["../../../src/workflow/providers/router.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEvF,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;gBAHN,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,eAAe,EAC9B,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EACxD,MAAM,EAAE,MAAM;IAG3B,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB7D,mBAAmB,CAAC,CAAC,EACnB,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACrC,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI;IAgC9C,cAAc,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO;IASlC,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAoBxF"}

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

@@ -0,0 +1,79 @@
+import { BadRequestException } from '@nestjs/common';
+export class RouterService {
+    constructor(event, entityService, workflowDefinition, logger) {
+        this.event = event;
+        this.entityService = entityService;
+        this.workflowDefinition = workflowDefinition;
+        this.logger = logger;
+    }
+    async loadAndValidateEntity(urn) {
+        const entity = await this.entityService.load(urn);
+        if (!entity) {
+            this.logger.error(`Element not found`, urn);
+            throw new BadRequestException(`Entity not found`, String(urn));
+        }
+        const entityStatus = this.entityService.status(entity);
+        const definedFinalStates = this.workflowDefinition.states.finals;
+        if (definedFinalStates.includes(entityStatus)) {
+            this.logger.warn(`Entity: ${urn} is in a final status. Accepting transitions due to a retry mechanism.`, urn);
+        }
+        return entity;
+    }
+    findValidTransition(entity, payload, options) {
+        const currentStatus = this.entityService.status(entity);
+        const possibleNextTransitionSet = new Set();
+        const possibleTransitions = this.workflowDefinition.transitions
+            // Find transition event that matches the current event and state
+            .filter((transition) => {
+            const events = Array.isArray(transition.event) ? transition.event : [transition.event];
+            const states = (Array.isArray(transition.from) ? transition.from : [transition.from]);
+            return (options?.skipEventCheck ? true : events.includes(this.event)) && states.includes(currentStatus);
+        })
+            // Condition checking
+            .filter(({ conditions, to }) => {
+            if (conditions && conditions.some((condition) => !condition(entity, payload)))
+                return false;
+            possibleNextTransitionSet.add(to);
+            return true;
+        });
+        if (possibleTransitions.length === 0)
+            return null;
+        const possibleNextTransitions = Array.from(possibleNextTransitionSet);
+        if (possibleNextTransitions.length > 1) {
+            throw new BadRequestException(`Multiple "to" transition states is not allowed, please verify Workflow Definition at @Workflow decorator: [${possibleNextTransitions.join(', ')}]`);
+        }
+        // Since event and "to" transition state will be similar
+        return possibleTransitions[0];
+    }
+    isInIdleStatus(entity) {
+        const status = this.entityService.status(entity);
+        if (!status) {
+            throw new Error('Entity status is not defined. Unable to determine if the entity is idle or not.');
+        }
+        const definedIdleStatuses = this.workflowDefinition.states.idles;
+        return definedIdleStatuses.includes(status);
+    }
+    buildParamDecorators(entity, payload, target, propertyKey) {
+        // Metadata is stored on the prototype when decorators are applied
+        const prototype = target.constructor?.prototype || target;
+        const paramsMeta = Reflect.getOwnMetadata('workflow:params', prototype, propertyKey) || [];
+        let args = [];
+        if (paramsMeta && paramsMeta.length > 0) {
+            // populate args according to metadata indices
+            for (const meta of paramsMeta) {
+                if (meta.type === 'entity')
+                    args[meta.index] = entity;
+                else if (meta.type === 'payload')
+                    args[meta.index] = payload;
+                else
+                    args[meta.index] = undefined;
+            }
+        }
+        else {
+            // legacy: single object param { entity, payload }
+            args = [{ entity, payload }];
+        }
+        return args;
+    }
+}
+//# sourceMappingURL=router.service.js.map

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

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