@etohq/orchestration 1.0.0

package/dist/transaction/errors.d.ts

@@ -0,0 +1,27 @@
+declare class BaseStepErrror extends Error {
+    #private;
+    constructor(name: any, message?: string, stepResponse?: unknown);
+    getStepResponse(): unknown;
+}
+export declare class PermanentStepFailureError extends BaseStepErrror {
+    static isPermanentStepFailureError(error: Error): error is PermanentStepFailureError;
+    constructor(message?: string, stepResponse?: unknown);
+}
+export declare class SkipStepResponse extends BaseStepErrror {
+    static isSkipStepResponse(error: Error): error is SkipStepResponse;
+    constructor(message?: string, stepResponse?: unknown);
+}
+export declare class TransactionStepTimeoutError extends BaseStepErrror {
+    static isTransactionStepTimeoutError(error: Error): error is TransactionStepTimeoutError;
+    constructor(message?: string, stepResponse?: unknown);
+}
+export declare class TransactionTimeoutError extends BaseStepErrror {
+    static isTransactionTimeoutError(error: Error): error is TransactionTimeoutError;
+    constructor(message?: string, stepResponse?: unknown);
+}
+export declare class NonSerializableCheckPointError extends Error {
+    static isNonSerializableCheckPointError(error: Error): error is NonSerializableCheckPointError;
+    constructor(message?: string);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/transaction/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/transaction/errors.ts"],"names":[],"mappings":"AAAA,cAAM,cAAe,SAAQ,KAAK;;gBAGpB,IAAI,KAAA,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO;IAM1D,eAAe,IAAI,OAAO;CAG3B;AAED,qBAAa,yBAA0B,SAAQ,cAAc;IAC3D,MAAM,CAAC,2BAA2B,CAChC,KAAK,EAAE,KAAK,GACX,KAAK,IAAI,yBAAyB;gBAOzB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO;CAGrD;AAED,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,gBAAgB;gBAMtD,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO;CAGrD;AAED,qBAAa,2BAA4B,SAAQ,cAAc;IAC7D,MAAM,CAAC,6BAA6B,CAClC,KAAK,EAAE,KAAK,GACX,KAAK,IAAI,2BAA2B;gBAO3B,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO;CAGrD;AAED,qBAAa,uBAAwB,SAAQ,cAAc;IACzD,MAAM,CAAC,yBAAyB,CAC9B,KAAK,EAAE,KAAK,GACX,KAAK,IAAI,uBAAuB;gBAOvB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO;CAGrD;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,MAAM,CAAC,gCAAgC,CACrC,KAAK,EAAE,KAAK,GACX,KAAK,IAAI,8BAA8B;gBAO9B,OAAO,CAAC,EAAE,MAAM;CAI7B"}

package/dist/transaction/errors.js

@@ -0,0 +1,78 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _BaseStepErrror_stepResponse;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NonSerializableCheckPointError = exports.TransactionTimeoutError = exports.TransactionStepTimeoutError = exports.SkipStepResponse = exports.PermanentStepFailureError = void 0;
+class BaseStepErrror extends Error {
+    constructor(name, message, stepResponse) {
+        super(message);
+        _BaseStepErrror_stepResponse.set(this, void 0);
+        this.name = name;
+        __classPrivateFieldSet(this, _BaseStepErrror_stepResponse, stepResponse, "f");
+    }
+    getStepResponse() {
+        return __classPrivateFieldGet(this, _BaseStepErrror_stepResponse, "f");
+    }
+}
+_BaseStepErrror_stepResponse = new WeakMap();
+class PermanentStepFailureError extends BaseStepErrror {
+    static isPermanentStepFailureError(error) {
+        return (error instanceof PermanentStepFailureError ||
+            error?.name === "PermanentStepFailure");
+    }
+    constructor(message, stepResponse) {
+        super("PermanentStepFailure", message, stepResponse);
+    }
+}
+exports.PermanentStepFailureError = PermanentStepFailureError;
+class SkipStepResponse extends BaseStepErrror {
+    static isSkipStepResponse(error) {
+        return (error instanceof SkipStepResponse || error?.name === "SkipStepResponse");
+    }
+    constructor(message, stepResponse) {
+        super("SkipStepResponse", message, stepResponse);
+    }
+}
+exports.SkipStepResponse = SkipStepResponse;
+class TransactionStepTimeoutError extends BaseStepErrror {
+    static isTransactionStepTimeoutError(error) {
+        return (error instanceof TransactionStepTimeoutError ||
+            error?.name === "TransactionStepTimeoutError");
+    }
+    constructor(message, stepResponse) {
+        super("TransactionStepTimeoutError", message, stepResponse);
+    }
+}
+exports.TransactionStepTimeoutError = TransactionStepTimeoutError;
+class TransactionTimeoutError extends BaseStepErrror {
+    static isTransactionTimeoutError(error) {
+        return (error instanceof TransactionTimeoutError ||
+            error?.name === "TransactionTimeoutError");
+    }
+    constructor(message, stepResponse) {
+        super("TransactionTimeoutError", message, stepResponse);
+    }
+}
+exports.TransactionTimeoutError = TransactionTimeoutError;
+class NonSerializableCheckPointError extends Error {
+    static isNonSerializableCheckPointError(error) {
+        return (error instanceof NonSerializableCheckPointError ||
+            error?.name === "NonSerializableCheckPointError");
+    }
+    constructor(message) {
+        super(message);
+        this.name = "NonSerializableCheckPointError";
+    }
+}
+exports.NonSerializableCheckPointError = NonSerializableCheckPointError;
+//# sourceMappingURL=errors.js.map

package/dist/transaction/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/transaction/errors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,MAAM,cAAe,SAAQ,KAAK;IAGhC,YAAY,IAAI,EAAE,OAAgB,EAAE,YAAsB;QACxD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHhB,+CAAsB;QAIpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,uBAAA,IAAI,gCAAiB,YAAY,MAAA,CAAA;IACnC,CAAC;IAED,eAAe;QACb,OAAO,uBAAA,IAAI,oCAAc,CAAA;IAC3B,CAAC;CACF;;AAED,MAAa,yBAA0B,SAAQ,cAAc;IAC3D,MAAM,CAAC,2BAA2B,CAChC,KAAY;QAEZ,OAAO,CACL,KAAK,YAAY,yBAAyB;YAC1C,KAAK,EAAE,IAAI,KAAK,sBAAsB,CACvC,CAAA;IACH,CAAC;IAED,YAAY,OAAgB,EAAE,YAAsB;QAClD,KAAK,CAAC,sBAAsB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IACtD,CAAC;CACF;AAbD,8DAaC;AAED,MAAa,gBAAiB,SAAQ,cAAc;IAClD,MAAM,CAAC,kBAAkB,CAAC,KAAY;QACpC,OAAO,CACL,KAAK,YAAY,gBAAgB,IAAI,KAAK,EAAE,IAAI,KAAK,kBAAkB,CACxE,CAAA;IACH,CAAC;IAED,YAAY,OAAgB,EAAE,YAAsB;QAClD,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IAClD,CAAC;CACF;AAVD,4CAUC;AAED,MAAa,2BAA4B,SAAQ,cAAc;IAC7D,MAAM,CAAC,6BAA6B,CAClC,KAAY;QAEZ,OAAO,CACL,KAAK,YAAY,2BAA2B;YAC5C,KAAK,EAAE,IAAI,KAAK,6BAA6B,CAC9C,CAAA;IACH,CAAC;IAED,YAAY,OAAgB,EAAE,YAAsB;QAClD,KAAK,CAAC,6BAA6B,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IAC7D,CAAC;CACF;AAbD,kEAaC;AAED,MAAa,uBAAwB,SAAQ,cAAc;IACzD,MAAM,CAAC,yBAAyB,CAC9B,KAAY;QAEZ,OAAO,CACL,KAAK,YAAY,uBAAuB;YACxC,KAAK,EAAE,IAAI,KAAK,yBAAyB,CAC1C,CAAA;IACH,CAAC;IAED,YAAY,OAAgB,EAAE,YAAsB;QAClD,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IACzD,CAAC;CACF;AAbD,0DAaC;AAED,MAAa,8BAA+B,SAAQ,KAAK;IACvD,MAAM,CAAC,gCAAgC,CACrC,KAAY;QAEZ,OAAO,CACL,KAAK,YAAY,8BAA8B;YAC/C,KAAK,EAAE,IAAI,KAAK,gCAAgC,CACjD,CAAA;IACH,CAAC;IAED,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAA;IAC9C,CAAC;CACF;AAdD,wEAcC"}

package/dist/transaction/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./datastore/abstract-storage";
+export * from "./distributed-transaction";
+export * from "./errors";
+export * from "./orchestrator-builder";
+export * from "./transaction-orchestrator";
+export * from "./transaction-step";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,UAAU,CAAA;AACxB,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,SAAS,CAAA"}

package/dist/transaction/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./datastore/abstract-storage"), exports);
+__exportStar(require("./distributed-transaction"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./orchestrator-builder"), exports);
+__exportStar(require("./transaction-orchestrator"), exports);
+__exportStar(require("./transaction-step"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/transaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA4C;AAC5C,4DAAyC;AACzC,2CAAwB;AACxB,yDAAsC;AACtC,6DAA0C;AAC1C,qDAAkC;AAClC,0CAAuB"}

package/dist/transaction/orchestrator-builder.d.ts

@@ -0,0 +1,36 @@
+import { TransactionStepsDefinition } from "./types";
+interface InternalStep extends TransactionStepsDefinition {
+    next?: InternalStep | InternalStep[];
+    depth: number;
+    parent?: InternalStep | null;
+}
+export declare class OrchestratorBuilder {
+    protected steps: InternalStep;
+    protected hasChanges_: boolean;
+    get hasChanges(): boolean;
+    constructor(steps?: TransactionStepsDefinition);
+    load(steps?: TransactionStepsDefinition): this;
+    addAction(action: string, options?: Partial<TransactionStepsDefinition>): this;
+    replaceAction(existingAction: string, action: string, options?: Partial<TransactionStepsDefinition>): this;
+    insertActionBefore(existingAction: string, action: string, options?: Partial<TransactionStepsDefinition>): this;
+    insertActionAfter(existingAction: string, action: string, options?: Partial<TransactionStepsDefinition>): this;
+    protected appendTo(step: InternalStep | string, newStep: InternalStep): this;
+    appendAction(action: string, to: string, options?: Partial<TransactionStepsDefinition>): this;
+    protected move(actionToMove: string, targetAction: string, { runInParallel, mergeNext, }?: {
+        runInParallel?: boolean;
+        mergeNext?: boolean;
+    }): OrchestratorBuilder;
+    moveAction(actionToMove: string, targetAction: string): OrchestratorBuilder;
+    moveAndMergeNextAction(actionToMove: string, targetAction: string): OrchestratorBuilder;
+    mergeActions(where: string, ...actions: string[]): this;
+    deleteAction(action: string, steps?: InternalStep): this;
+    pruneAction(action: string): this;
+    protected findStepByAction(action: string, step?: InternalStep): InternalStep | undefined;
+    protected findOrThrowStepByAction(action: string, steps?: InternalStep): InternalStep;
+    protected findParentStepByAction(action: string, step?: InternalStep): InternalStep | undefined;
+    protected findLastStep(steps?: InternalStep): InternalStep;
+    protected updateDepths(startingStep: InternalStep, parent: any, incr?: number, beginFrom?: number): void;
+    build(): TransactionStepsDefinition;
+}
+export {};
+//# sourceMappingURL=orchestrator-builder.d.ts.map

package/dist/transaction/orchestrator-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-builder.d.ts","sourceRoot":"","sources":["../../src/transaction/orchestrator-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEpD,UAAU,YAAa,SAAQ,0BAA0B;IACvD,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAC7B;AAED,qBAAa,mBAAmB;IAC9B,SAAS,CAAC,KAAK,EAAE,YAAY,CAAA;IAC7B,SAAS,CAAC,WAAW,UAAQ;IAE7B,IAAI,UAAU,YAEb;gBAEW,KAAK,CAAC,EAAE,0BAA0B;IAI9C,IAAI,CAAC,KAAK,CAAC,EAAE,0BAA0B;IAiBvC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,0BAA0B,CAAM;IAe3E,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,0BAA0B,CAAM;IAWnD,kBAAkB,CAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,0BAA0B,CAAM;IAkCnD,iBAAiB,CACf,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,0BAA0B,CAAM;IAmBnD,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,OAAO,EAAE,YAAY;IAerE,YAAY,CACV,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,OAAO,CAAC,0BAA0B,CAAM;IAanD,SAAS,CAAC,IAAI,CACZ,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,EACE,aAAa,EACb,SAAS,GACV,GAAE;QACD,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,SAAS,CAAC,EAAE,OAAO,CAAA;KAIpB,GACA,mBAAmB;IAwEtB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,mBAAmB;IAI3E,sBAAsB,CACpB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,mBAAmB;IAItB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE;IAgBhD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,YAAyB;IA6B7D,WAAW,CAAC,MAAM,EAAE,MAAM;IAgB1B,SAAS,CAAC,gBAAgB,CACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,YAAyB,GAC9B,YAAY,GAAG,SAAS;IAmB3B,SAAS,CAAC,uBAAuB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,YAAyB,GAC/B,YAAY;IASf,SAAS,CAAC,sBAAsB,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,YAAyB,GAC9B,YAAY,GAAG,SAAS;IAyB3B,SAAS,CAAC,YAAY,CAAC,KAAK,GAAE,YAAyB,GAAG,YAAY;IAWtE,SAAS,CAAC,YAAY,CACpB,YAAY,EAAE,YAAY,EAC1B,MAAM,KAAA,EACN,IAAI,SAAI,EACR,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAiBP,KAAK,IAAI,0BAA0B;CAuBpC"}

package/dist/transaction/orchestrator-builder.js

@@ -0,0 +1,300 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestratorBuilder = void 0;
+class OrchestratorBuilder {
+    get hasChanges() {
+        return this.hasChanges_;
+    }
+    constructor(steps) {
+        this.hasChanges_ = false;
+        this.load(steps);
+    }
+    load(steps) {
+        this.steps = {
+            depth: -1,
+            parent: null,
+            next: Object.keys(steps ?? {}).length
+                ? JSON.parse(JSON.stringify((steps.action ? steps : steps.next)))
+                : undefined,
+        };
+        this.updateDepths(this.steps, {}, 1, -1);
+        return this;
+    }
+    addAction(action, options = {}) {
+        const step = this.findLastStep();
+        const newAction = {
+            action,
+            depth: step.depth + 1,
+            parent: step.action,
+            ...options,
+        };
+        step.next = newAction;
+        this.hasChanges_ = true;
+        return this;
+    }
+    replaceAction(existingAction, action, options = {}) {
+        const step = this.findOrThrowStepByAction(existingAction);
+        step.action = action;
+        Object.assign(step, options);
+        this.hasChanges_ = true;
+        return this;
+    }
+    insertActionBefore(existingAction, action, options = {}) {
+        const parentStep = this.findParentStepByAction(existingAction);
+        if (parentStep) {
+            const oldNext = parentStep.next;
+            const newDepth = parentStep.depth + 1;
+            if (Array.isArray(parentStep.next)) {
+                const index = parentStep.next.findIndex((step) => step.action === existingAction);
+                if (index > -1) {
+                    parentStep.next[index] = {
+                        action,
+                        ...options,
+                        next: oldNext[index],
+                        depth: newDepth,
+                    };
+                }
+            }
+            else {
+                parentStep.next = {
+                    action,
+                    ...options,
+                    next: oldNext,
+                    depth: newDepth,
+                };
+            }
+            this.updateDepths(oldNext, parentStep);
+        }
+        this.hasChanges_ = true;
+        return this;
+    }
+    insertActionAfter(existingAction, action, options = {}) {
+        const step = this.findOrThrowStepByAction(existingAction);
+        const oldNext = step.next;
+        const newDepth = step.depth + 1;
+        step.next = {
+            action,
+            ...options,
+            next: oldNext,
+            depth: newDepth,
+            parent: step.action,
+        };
+        this.updateDepths(oldNext, step.next);
+        this.hasChanges_ = true;
+        return this;
+    }
+    appendTo(step, newStep) {
+        if (typeof step === "string") {
+            step = this.findOrThrowStepByAction(step);
+        }
+        step.next = {
+            ...newStep,
+            depth: step.depth + 1,
+            parent: step.action,
+        };
+        this.hasChanges_ = true;
+        return this;
+    }
+    appendAction(action, to, options = {}) {
+        const newAction = {
+            action,
+            ...options,
+        };
+        const branch = this.findLastStep(this.findStepByAction(to));
+        this.appendTo(branch, newAction);
+        return this;
+    }
+    move(actionToMove, targetAction, { runInParallel, mergeNext, } = {
+        runInParallel: false,
+        mergeNext: false,
+    }) {
+        const parentActionToMoveStep = this.findParentStepByAction(actionToMove);
+        const parentTargetActionStep = this.findParentStepByAction(targetAction);
+        const actionToMoveStep = this.findStepByAction(actionToMove, parentTargetActionStep);
+        if (!actionToMoveStep) {
+            throw new Error(`Action "${actionToMove}" could not be found in the following steps of "${targetAction}"`);
+        }
+        if (Array.isArray(parentActionToMoveStep.next)) {
+            const index = parentActionToMoveStep.next.findIndex((step) => step.action === actionToMove);
+            if (index > -1) {
+                parentActionToMoveStep.next.splice(index, 1);
+            }
+        }
+        else {
+            delete parentActionToMoveStep.next;
+        }
+        if (runInParallel) {
+            if (Array.isArray(parentTargetActionStep.next)) {
+                parentTargetActionStep.next.push(actionToMoveStep);
+            }
+            else if (parentTargetActionStep.next) {
+                parentTargetActionStep.next = [
+                    parentTargetActionStep.next,
+                    actionToMoveStep,
+                ];
+            }
+        }
+        else {
+            if (actionToMoveStep.next) {
+                if (mergeNext) {
+                    if (Array.isArray(actionToMoveStep.next)) {
+                        actionToMoveStep.next.push(parentTargetActionStep.next);
+                    }
+                    else {
+                        actionToMoveStep.next = [
+                            actionToMoveStep.next,
+                            parentTargetActionStep.next,
+                        ];
+                    }
+                }
+                else {
+                    this.appendTo(this.findLastStep(actionToMoveStep), parentTargetActionStep.next);
+                }
+            }
+            else {
+                actionToMoveStep.next = parentTargetActionStep.next;
+            }
+            parentTargetActionStep.next = actionToMoveStep;
+        }
+        this.updateDepths(actionToMoveStep, parentTargetActionStep, 1, parentTargetActionStep.depth);
+        this.hasChanges_ = true;
+        return this;
+    }
+    moveAction(actionToMove, targetAction) {
+        return this.move(actionToMove, targetAction);
+    }
+    moveAndMergeNextAction(actionToMove, targetAction) {
+        return this.move(actionToMove, targetAction, { mergeNext: true });
+    }
+    mergeActions(where, ...actions) {
+        actions.unshift(where);
+        if (actions.length < 2) {
+            throw new Error("Cannot merge less than two actions");
+        }
+        for (const action of actions) {
+            if (action !== where) {
+                this.move(action, where, { runInParallel: true });
+            }
+        }
+        return this;
+    }
+    deleteAction(action, steps = this.steps) {
+        const actionStep = this.findOrThrowStepByAction(action);
+        const parentStep = this.findParentStepByAction(action, steps);
+        if (Array.isArray(parentStep.next)) {
+            const index = parentStep.next.findIndex((step) => step.action === action);
+            if (index > -1 && actionStep.next) {
+                if (actionStep.next) {
+                    parentStep.next[index] = actionStep.next;
+                }
+                else {
+                    parentStep.next.splice(index, 1);
+                }
+            }
+        }
+        else {
+            parentStep.next = actionStep.next;
+        }
+        this.updateDepths(actionStep.next, parentStep, 1, parentStep.depth);
+        this.hasChanges_ = true;
+        return this;
+    }
+    pruneAction(action) {
+        const parentStep = this.findParentStepByAction(action, this.steps);
+        if (Array.isArray(parentStep.next)) {
+            const index = parentStep.next.findIndex((step) => step.action === action);
+            if (index > -1) {
+                parentStep.next.splice(index, 1);
+            }
+        }
+        else {
+            delete parentStep.next;
+        }
+        this.hasChanges_ = true;
+        return this;
+    }
+    findStepByAction(action, step = this.steps) {
+        if (step.uuid === action || step.action === action) {
+            return step;
+        }
+        if (Array.isArray(step.next)) {
+            for (const subStep of step.next) {
+                const found = this.findStepByAction(action, subStep);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+        else if (step.next && typeof step.next === "object") {
+            return this.findStepByAction(action, step.next);
+        }
+        return;
+    }
+    findOrThrowStepByAction(action, steps = this.steps) {
+        const step = this.findStepByAction(action, steps);
+        if (!step) {
+            throw new Error(`Action "${action}" could not be found`);
+        }
+        return step;
+    }
+    findParentStepByAction(action, step = this.steps) {
+        if (!step.next) {
+            return;
+        }
+        const nextSteps = Array.isArray(step.next) ? step.next : [step.next];
+        for (const nextStep of nextSteps) {
+            if (!nextStep) {
+                continue;
+            }
+            if (nextStep.uuid === action || nextStep.action === action) {
+                return step;
+            }
+            const foundStep = this.findParentStepByAction(action, nextStep);
+            if (foundStep) {
+                return foundStep;
+            }
+        }
+        return;
+    }
+    findLastStep(steps = this.steps) {
+        let step = steps;
+        while (step.next) {
+            step = Array.isArray(step.next)
+                ? step.next[step.next.length - 1]
+                : step.next;
+        }
+        return step;
+    }
+    updateDepths(startingStep, parent, incr = 1, beginFrom) {
+        if (!startingStep) {
+            return;
+        }
+        const update = (step, parent, beginFrom) => {
+            step.depth = beginFrom + incr;
+            step.parent = parent.action;
+            if (Array.isArray(step.next)) {
+                step.next.forEach((nextAction) => update(nextAction, step, step.depth));
+            }
+            else if (step.next) {
+                update(step.next, step, step.depth);
+            }
+        };
+        update(startingStep, parent, beginFrom ?? startingStep.depth);
+    }
+    build() {
+        if (!this.steps.next) {
+            return {};
+        }
+        const ignore = ["depth", "parent"];
+        const result = JSON.parse(JSON.stringify(Array.isArray(this.steps.next) ? this.steps : this.steps.next, null), (key, value) => {
+            if (ignore.includes(key)) {
+                return;
+            }
+            return value;
+        });
+        this.hasChanges_ = false;
+        return result;
+    }
+}
+exports.OrchestratorBuilder = OrchestratorBuilder;
+//# sourceMappingURL=orchestrator-builder.js.map

package/dist/transaction/orchestrator-builder.js.map

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

package/dist/transaction/transaction-orchestrator.d.ts

@@ -0,0 +1,118 @@
+import { DistributedTransactionType } from "./distributed-transaction";
+import { TransactionStepHandler } from "./transaction-step";
+import { TransactionFlow, TransactionModelOptions, TransactionOptions, TransactionStepsDefinition } from "./types";
+import { EventEmitter } from "events";
+/**
+ * @class TransactionOrchestrator is responsible for managing and executing distributed transactions.
+ * It is based on a single transaction definition, which is used to execute all the transaction steps
+ */
+export declare class TransactionOrchestrator extends EventEmitter {
+    id: string;
+    private static ROOT_STEP;
+    static DEFAULT_TTL: number;
+    private invokeSteps;
+    private compensateSteps;
+    private definition;
+    private options?;
+    static DEFAULT_RETRIES: number;
+    private static workflowOptions;
+    static getWorkflowOptions(modelId: string): TransactionOptions;
+    /**
+     * Trace workflow transaction for instrumentation
+     */
+    static traceTransaction?: (transactionResume: (...args: any[]) => Promise<void>, metadata: {
+        model_id: string;
+        transaction_id: string;
+        flow_metadata: TransactionFlow["metadata"];
+    }) => Promise<any>;
+    /**
+     * Trace workflow steps for instrumentation
+     */
+    static traceStep?: (handler: (...args: any[]) => Promise<any>, metadata: {
+        action: string;
+        type: "invoke" | "compensate";
+        step_id: string;
+        step_uuid: string;
+        attempts: number;
+        failures: number;
+        async: boolean;
+        idempotency_key: string;
+    }) => Promise<any>;
+    constructor({ id, definition, options, isClone, }: {
+        id: string;
+        definition: TransactionStepsDefinition;
+        options?: TransactionModelOptions;
+        isClone?: boolean;
+    });
+    static clone(orchestrator: TransactionOrchestrator): TransactionOrchestrator;
+    private static SEPARATOR;
+    static getKeyName(...params: string[]): string;
+    private getPreviousStep;
+    getOptions(): TransactionModelOptions;
+    private getInvokeSteps;
+    private getCompensationSteps;
+    private canMoveForward;
+    private canMoveBackward;
+    private canContinue;
+    private hasExpired;
+    private checkTransactionTimeout;
+    private checkStepTimeout;
+    private checkAllSteps;
+    private flagStepsToRevert;
+    private static setStepSuccess;
+    private static skipStep;
+    private static setStepTimeout;
+    private static setStepFailure;
+    private executeNext;
+    /**
+     * Start a new transaction or resume a transaction that has been previously started
+     * @param transaction - The transaction to resume
+     */
+    resume(transaction: DistributedTransactionType): Promise<void>;
+    /**
+     * Cancel and revert a transaction compensating all its executed steps. It can be an ongoing transaction or a completed one
+     * @param transaction - The transaction to be reverted
+     */
+    cancelTransaction(transaction: DistributedTransactionType): Promise<void>;
+    private parseFlowOptions;
+    private createTransactionFlow;
+    private static loadTransactionById;
+    private static buildSteps;
+    /** Create a new transaction
+     * @param transactionId - unique identifier of the transaction
+     * @param handler - function to handle action of the transaction
+     * @param payload - payload to be passed to all the transaction steps
+     * @param flowMetadata - flow metadata which can include event group id for example
+     */
+    beginTransaction(transactionId: string, handler: TransactionStepHandler, payload?: unknown, flowMetadata?: TransactionFlow["metadata"]): Promise<DistributedTransactionType>;
+    /** Returns an existing transaction
+     * @param transactionId - unique identifier of the transaction
+     * @param handler - function to handle action of the transaction
+     */
+    retrieveExistingTransaction(transactionId: string, handler: TransactionStepHandler): Promise<DistributedTransactionType>;
+    private static getStepByAction;
+    private static getTransactionAndStepFromIdempotencyKey;
+    /** Skip the execution of a specific transaction and step
+     * @param responseIdempotencyKey - The idempotency key for the step
+     * @param handler - The handler function to execute the step
+     * @param transaction - The current transaction. If not provided it will be loaded based on the responseIdempotencyKey
+     */
+    skipStep(responseIdempotencyKey: string, handler?: TransactionStepHandler, transaction?: DistributedTransactionType): Promise<DistributedTransactionType>;
+    /** Register a step success for a specific transaction and step
+     * @param responseIdempotencyKey - The idempotency key for the step
+     * @param handler - The handler function to execute the step
+     * @param transaction - The current transaction. If not provided it will be loaded based on the responseIdempotencyKey
+     * @param response - The response of the step
+     */
+    registerStepSuccess(responseIdempotencyKey: string, handler?: TransactionStepHandler, transaction?: DistributedTransactionType, response?: unknown): Promise<DistributedTransactionType>;
+    /**
+     * Register a step failure for a specific transaction and step
+     * @param responseIdempotencyKey - The idempotency key for the step
+     * @param error - The error that caused the failure
+     * @param handler - The handler function to execute the step
+     * @param transaction - The current transaction
+     * @param response - The response of the step
+     */
+    registerStepFailure(responseIdempotencyKey: string, error?: Error | any, handler?: TransactionStepHandler, transaction?: DistributedTransactionType): Promise<DistributedTransactionType>;
+}
+//# sourceMappingURL=transaction-orchestrator.d.ts.map

package/dist/transaction/transaction-orchestrator.d.ts.map

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