@defai.digital/cross-cutting 13.0.3

package/dist/retention-manager.js.map

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

package/dist/saga-manager.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Saga Manager Implementation
+ *
+ * Implements the saga pattern for distributed transaction compensation.
+ * Enables automatic rollback of completed steps on failure.
+ *
+ * Invariants:
+ * - INV-SG-001: Compensations run in reverse order on failure
+ * - INV-SG-002: Required compensations must succeed
+ * - INV-SG-003: Saga state transitions are valid
+ */
+import { type SagaDefinition, type SagaState, type SagaStep, type CompensationAction, type SagaResult } from '@defai.digital/contracts';
+/**
+ * Saga step executor function
+ */
+export type SagaStepExecutor<T = unknown> = (step: SagaStep, context: Record<string, unknown>) => Promise<T>;
+/**
+ * Compensation executor function
+ */
+export type CompensationExecutor = (action: CompensationAction, context: Record<string, unknown>) => Promise<void>;
+/**
+ * Saga manager for orchestrating distributed transactions
+ */
+export interface SagaManager {
+    /** Get saga definition */
+    getDefinition(): SagaDefinition;
+    /** Execute the saga with given steps */
+    execute(steps: SagaStep[], stepExecutor: SagaStepExecutor, compensationExecutor: CompensationExecutor, correlationId?: string): Promise<SagaResult>;
+    /** Get current state */
+    getState(): SagaState | null;
+    /** Manually trigger compensation */
+    compensate(): Promise<void>;
+}
+/**
+ * Creates a saga manager
+ */
+export declare function createSagaManager(definition: SagaDefinition): SagaManager;
+/**
+ * Creates a simple saga definition
+ */
+export declare function defineSaga(sagaId: string, compensations: CompensationAction[], options?: {
+    onFailure?: 'compensate' | 'pause' | 'continue';
+    compensationOrder?: 'reverse' | 'parallel';
+    workflowId?: string;
+    description?: string;
+}): SagaDefinition;
+/**
+ * Saga error
+ */
+export declare class SagaError extends Error {
+    readonly code: string;
+    constructor(code: string, message?: string);
+    static stepFailed(stepId: string, error: string): SagaError;
+    static compensationFailed(stepId: string, error: string): SagaError;
+    static sagaNotFound(sagaId: string): SagaError;
+}
+//# sourceMappingURL=saga-manager.d.ts.map

package/dist/saga-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saga-manager.d.ts","sourceRoot":"","sources":["../src/saga-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAKhB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,CAC1C,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,aAAa,IAAI,cAAc,CAAC;IAEhC,wCAAwC;IACxC,OAAO,CACL,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,gBAAgB,EAC9B,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB,wBAAwB;IACxB,QAAQ,IAAI,SAAS,GAAG,IAAI,CAAC;IAE7B,oCAAoC;IACpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,WAAW,CAwMzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,kBAAkB,EAAE,EACnC,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;IAChD,iBAAiB,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,cAAc,CAShB;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAEhB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE,MAAM;IAMlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAO3D,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAOnE,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAM/C"}

package/dist/saga-manager.js

@@ -0,0 +1,202 @@
+/**
+ * Saga Manager Implementation
+ *
+ * Implements the saga pattern for distributed transaction compensation.
+ * Enables automatic rollback of completed steps on failure.
+ *
+ * Invariants:
+ * - INV-SG-001: Compensations run in reverse order on failure
+ * - INV-SG-002: Required compensations must succeed
+ * - INV-SG-003: Saga state transitions are valid
+ */
+import { createInitialSagaState, isValidSagaTransition, SagaErrorCodes, } from '@defai.digital/contracts';
+/**
+ * Creates a saga manager
+ */
+export function createSagaManager(definition) {
+    let state = null;
+    let compensationExec = null;
+    let context = {};
+    /**
+     * Update saga state with transition validation
+     * INV-SG-003: State transitions are valid
+     */
+    function transitionTo(newStatus) {
+        if (!state)
+            return;
+        if (!isValidSagaTransition(state.status, newStatus)) {
+            throw new SagaError(SagaErrorCodes.INVALID_STATE_TRANSITION, `Invalid state transition from ${state.status} to ${newStatus}`);
+        }
+        state = { ...state, status: newStatus };
+    }
+    /**
+     * Execute compensations
+     * INV-SG-001: Execute in reverse order
+     */
+    async function executeCompensations() {
+        if (!state || !compensationExec)
+            return;
+        transitionTo('compensating');
+        // Get compensations for completed steps in reverse order
+        const completedStepIds = [...state.completedSteps].reverse();
+        for (const stepId of completedStepIds) {
+            const compensation = definition.compensations.find((c) => c.stepId === stepId);
+            if (!compensation)
+                continue;
+            // Already compensated
+            if (state.compensatedSteps.includes(stepId))
+                continue;
+            let retries = 0;
+            let success = false;
+            while (retries <= compensation.retryCount && !success) {
+                try {
+                    await compensationExec(compensation, context);
+                    state.compensatedSteps.push(stepId);
+                    success = true;
+                }
+                catch (error) {
+                    retries++;
+                    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                    state.compensationErrors.push({
+                        stepId,
+                        error: errorMessage,
+                        timestamp: new Date().toISOString(),
+                        retryCount: retries,
+                    });
+                    // INV-SG-002: Required compensations must succeed
+                    if (retries > compensation.retryCount) {
+                        if (compensation.required) {
+                            transitionTo('failed');
+                            throw new SagaError(SagaErrorCodes.REQUIRED_COMPENSATION_FAILED, `Required compensation for step ${stepId} failed: ${errorMessage}`);
+                        }
+                        // Non-required compensation failed, continue
+                        break;
+                    }
+                }
+            }
+        }
+        transitionTo('compensated');
+    }
+    return {
+        getDefinition() {
+            return { ...definition };
+        },
+        async execute(steps, stepExecutor, compensationExecutor, correlationId) {
+            compensationExec = compensationExecutor;
+            context = {};
+            // Initialize saga state
+            state = createInitialSagaState(definition.sagaId, correlationId);
+            const startTime = Date.now();
+            const results = [];
+            try {
+                // Execute each step
+                for (const step of steps) {
+                    try {
+                        const result = await stepExecutor(step, context);
+                        results.push(result);
+                        // Record completed step
+                        state.completedSteps.push(step.stepId);
+                        // Store output in context for subsequent steps
+                        context[step.stepId] = result;
+                    }
+                    catch (error) {
+                        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                        state.failedStep = step.stepId;
+                        state.failureReason = errorMessage;
+                        // Execute compensations based on strategy
+                        if (definition.onFailure === 'compensate') {
+                            await executeCompensations();
+                        }
+                        else if (definition.onFailure === 'pause') {
+                            transitionTo('paused');
+                        }
+                        if (state.status !== 'compensated') {
+                            transitionTo('failed');
+                        }
+                        state.completedAt = new Date().toISOString();
+                        return {
+                            success: false,
+                            executionId: state.executionId,
+                            error: errorMessage,
+                            compensated: state.status === 'compensated',
+                            durationMs: Date.now() - startTime,
+                            finalStatus: state.status,
+                        };
+                    }
+                }
+                transitionTo('completed');
+                state.completedAt = new Date().toISOString();
+                return {
+                    success: true,
+                    executionId: state.executionId,
+                    results,
+                    durationMs: Date.now() - startTime,
+                    finalStatus: state.status,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                if (state) {
+                    if (state.status !== 'failed') {
+                        state.status = 'failed';
+                    }
+                    state.failureReason = errorMessage;
+                    state.completedAt = new Date().toISOString();
+                }
+                return {
+                    success: false,
+                    executionId: state?.executionId ?? '',
+                    error: errorMessage,
+                    durationMs: Date.now() - startTime,
+                    finalStatus: 'failed',
+                };
+            }
+        },
+        getState() {
+            return state ? { ...state } : null;
+        },
+        async compensate() {
+            if (!state) {
+                throw new SagaError(SagaErrorCodes.SAGA_NOT_FOUND, 'No saga state to compensate');
+            }
+            if (state.status !== 'paused' && state.status !== 'running') {
+                throw new SagaError(SagaErrorCodes.INVALID_STATE_TRANSITION, `Cannot compensate saga in ${state.status} state`);
+            }
+            await executeCompensations();
+        },
+    };
+}
+/**
+ * Creates a simple saga definition
+ */
+export function defineSaga(sagaId, compensations, options = {}) {
+    return {
+        sagaId,
+        compensations,
+        onFailure: options.onFailure ?? 'compensate',
+        compensationOrder: options.compensationOrder ?? 'reverse',
+        workflowId: options.workflowId,
+        description: options.description,
+    };
+}
+/**
+ * Saga error
+ */
+export class SagaError extends Error {
+    code;
+    constructor(code, message) {
+        super(message ?? `Saga error: ${code}`);
+        this.code = code;
+        this.name = 'SagaError';
+    }
+    static stepFailed(stepId, error) {
+        return new SagaError(SagaErrorCodes.STEP_FAILED, `Saga step ${stepId} failed: ${error}`);
+    }
+    static compensationFailed(stepId, error) {
+        return new SagaError(SagaErrorCodes.COMPENSATION_FAILED, `Compensation for ${stepId} failed: ${error}`);
+    }
+    static sagaNotFound(sagaId) {
+        return new SagaError(SagaErrorCodes.SAGA_NOT_FOUND, `Saga not found: ${sagaId}`);
+    }
+}
+//# sourceMappingURL=saga-manager.js.map

package/dist/saga-manager.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@defai.digital/cross-cutting",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Cross-cutting concerns for AutomatosX - DLQ, Saga, Retention, Idempotency",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/cross-cutting"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@defai.digital/contracts": "13.0.3"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}