@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/warehouse/transactions/saga-orchestrator.js

@@ -0,0 +1,383 @@
+"use strict";
+/**
+ * Saga Orchestrator
+ *
+ * Manages distributed transactions across multiple data sources using
+ * the Saga pattern with compensating transactions for rollback.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SagaOrchestrator = void 0;
+const types_1 = require("../types");
+// ==================== SAGA ORCHESTRATOR ====================
+/**
+ * Saga Orchestrator
+ *
+ * Coordinates execution of distributed transactions using the Saga pattern.
+ * Handles step execution, compensation on failure, and state management.
+ */
+class SagaOrchestrator {
+    constructor(executor, options = {}) {
+        this.executor = executor;
+        this.options = options;
+        this.activeSagas = new Map();
+    }
+    /**
+     * Execute a saga transaction
+     */
+    async execute(mainOperation, transaction) {
+        // Initialize saga state
+        const sagaId = transaction.id || (0, types_1.generateSagaId)();
+        const state = this.initializeSagaState(sagaId, mainOperation, transaction);
+        this.activeSagas.set(sagaId, state);
+        await this.persistState(state);
+        try {
+            // Execute all steps
+            await this.executeSteps(state, transaction);
+            // Mark as committed if all steps succeeded
+            if (state.status === 'executing') {
+                state.status = 'committed';
+                state.completedAt = new Date();
+            }
+            await this.persistState(state);
+            return this.buildResult(state);
+        }
+        catch (error) {
+            // Handle failure
+            return this.handleSagaFailure(state, transaction, error);
+        }
+        finally {
+            this.activeSagas.delete(sagaId);
+        }
+    }
+    /**
+     * Resume a saga from persisted state
+     */
+    async resume(sagaId) {
+        if (!this.options.loadState) {
+            throw new Error('Cannot resume saga: no loadState function provided');
+        }
+        const state = await this.options.loadState(sagaId);
+        if (!state) {
+            return undefined;
+        }
+        this.activeSagas.set(sagaId, state);
+        try {
+            // Resume based on current status
+            switch (state.status) {
+                case 'executing':
+                    // Continue with remaining steps
+                    // This is a simplified resume - full implementation would track exact position
+                    break;
+                case 'compensating':
+                    // Continue compensation
+                    await this.executeCompensations(state);
+                    break;
+                case 'committed':
+                case 'rolled_back':
+                case 'failed':
+                    // Already complete
+                    break;
+                default:
+                    break;
+            }
+            return this.buildResult(state);
+        }
+        finally {
+            this.activeSagas.delete(sagaId);
+        }
+    }
+    /**
+     * Get current saga state
+     */
+    getState(sagaId) {
+        return this.activeSagas.get(sagaId);
+    }
+    // ==================== PRIVATE METHODS ====================
+    /**
+     * Initialize saga state
+     */
+    initializeSagaState(sagaId, mainOperation, transaction) {
+        // Create steps array with main operation first
+        const steps = [
+            {
+                id: (0, types_1.generateStepId)('main'),
+                name: 'Main Operation',
+                status: 'pending',
+                attempts: 0,
+            },
+        ];
+        // Add additional steps
+        if (transaction.operations) {
+            const sorted = [...transaction.operations].sort((a, b) => (a.order || 0) - (b.order || 0));
+            for (const step of sorted) {
+                steps.push({
+                    id: step.id || (0, types_1.generateStepId)(step.name),
+                    name: step.name,
+                    status: 'pending',
+                    attempts: 0,
+                });
+            }
+        }
+        return {
+            id: sagaId,
+            status: 'pending',
+            steps,
+            startedAt: new Date(),
+            results: new Map(),
+        };
+    }
+    /**
+     * Execute all saga steps
+     */
+    async executeSteps(state, transaction) {
+        state.status = 'executing';
+        // Build execution order respecting dependencies
+        const executionOrder = this.buildExecutionOrder(transaction);
+        for (const stepIndex of executionOrder) {
+            const stepState = state.steps[stepIndex];
+            const step = this.getStepByIndex(stepIndex, transaction);
+            if (!step)
+                continue;
+            stepState.status = 'executing';
+            await this.persistState(state);
+            try {
+                const result = await this.executeStepWithRetry(step.operation, stepState, transaction.retry || this.options.defaultRetry);
+                stepState.status = 'completed';
+                stepState.result = result;
+                state.results.set(stepState.id, result);
+                await this.persistState(state);
+            }
+            catch (error) {
+                stepState.status = 'failed';
+                stepState.error = error;
+                // Check if step is required
+                if (step.required !== false) {
+                    throw error;
+                }
+                // Non-required step failed - continue
+                stepState.status = 'skipped';
+                await this.persistState(state);
+            }
+        }
+    }
+    /**
+     * Execute a single step with retry logic
+     */
+    async executeStepWithRetry(operation, stepState, retryConfig) {
+        const maxAttempts = (retryConfig === null || retryConfig === void 0 ? void 0 : retryConfig.maxAttempts) || 1;
+        const initialDelay = (retryConfig === null || retryConfig === void 0 ? void 0 : retryConfig.initialDelay) || 1000;
+        const maxDelay = (retryConfig === null || retryConfig === void 0 ? void 0 : retryConfig.maxDelay) || 10000;
+        const backoffMultiplier = (retryConfig === null || retryConfig === void 0 ? void 0 : retryConfig.backoffMultiplier) || 2;
+        let lastError;
+        let delay = initialDelay;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            stepState.attempts = attempt;
+            try {
+                const result = await this.executor(operation);
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                // Check if we should retry
+                if (attempt < maxAttempts && this.shouldRetry(error, retryConfig)) {
+                    await this.sleep(delay);
+                    delay = Math.min(delay * backoffMultiplier, maxDelay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Check if an error should trigger a retry
+     */
+    shouldRetry(error, config) {
+        if (!(config === null || config === void 0 ? void 0 : config.retryOn)) {
+            // Retry on common transient errors
+            const message = error.message.toLowerCase();
+            return (message.includes('timeout') ||
+                message.includes('connection') ||
+                message.includes('temporarily unavailable') ||
+                message.includes('retry'));
+        }
+        const message = error.message.toLowerCase();
+        return config.retryOn.some(type => {
+            switch (type) {
+                case 'timeout':
+                    return message.includes('timeout');
+                case 'connection':
+                    return message.includes('connection') || message.includes('network');
+                case 'conflict':
+                    return message.includes('conflict') || message.includes('locked');
+                case 'transient':
+                    return message.includes('temporarily') || message.includes('retry');
+                default:
+                    return false;
+            }
+        });
+    }
+    /**
+     * Handle saga failure - compensate or abort
+     */
+    async handleSagaFailure(state, transaction, error) {
+        const failedStep = state.steps.find(s => s.status === 'failed');
+        if (transaction.onFailure === 'abort') {
+            state.status = 'failed';
+            state.error = {
+                message: error.message,
+                failedStep: failedStep === null || failedStep === void 0 ? void 0 : failedStep.id,
+                compensationSuccessful: false,
+                rolledBackSteps: [],
+                failedRollbackSteps: [],
+                cause: error,
+            };
+            state.completedAt = new Date();
+            await this.persistState(state);
+            return this.buildResult(state);
+        }
+        if (transaction.onFailure === 'continue') {
+            state.status = 'partially_committed';
+            state.error = {
+                message: error.message,
+                failedStep: failedStep === null || failedStep === void 0 ? void 0 : failedStep.id,
+                compensationSuccessful: false,
+                rolledBackSteps: [],
+                failedRollbackSteps: [],
+                cause: error,
+            };
+            state.completedAt = new Date();
+            await this.persistState(state);
+            return this.buildResult(state);
+        }
+        // Default: compensate
+        state.status = 'compensating';
+        await this.persistState(state);
+        const compensationResult = await this.executeCompensations(state);
+        state.status = compensationResult.success ? 'rolled_back' : 'failed';
+        state.error = {
+            message: error.message,
+            failedStep: failedStep === null || failedStep === void 0 ? void 0 : failedStep.id,
+            compensationSuccessful: compensationResult.success,
+            rolledBackSteps: compensationResult.rolledBack,
+            failedRollbackSteps: compensationResult.failed,
+            cause: error,
+        };
+        state.completedAt = new Date();
+        await this.persistState(state);
+        return this.buildResult(state);
+    }
+    /**
+     * Execute compensation for completed steps (in reverse order)
+     */
+    async executeCompensations(state) {
+        const rolledBack = [];
+        const failed = [];
+        // Get completed steps in reverse order
+        const completedSteps = state.steps
+            .filter(s => s.status === 'completed')
+            .reverse();
+        for (const stepState of completedSteps) {
+            try {
+                // Generate compensation from result if not provided
+                const compensation = (0, types_1.generateCompensation)({ operation: 'delete', from: { type: 'database', tag: '', entity: '' } }, // Placeholder
+                stepState.result);
+                if (compensation) {
+                    await this.executor(compensation);
+                }
+                stepState.compensationStatus = 'completed';
+                rolledBack.push(stepState.id);
+            }
+            catch (error) {
+                stepState.compensationStatus = 'compensation_failed';
+                failed.push(stepState.id);
+            }
+            await this.persistState(state);
+        }
+        return {
+            success: failed.length === 0,
+            rolledBack,
+            failed,
+        };
+    }
+    /**
+     * Build execution order respecting dependencies
+     */
+    buildExecutionOrder(transaction) {
+        const order = [0]; // Main operation first
+        if (!transaction.operations) {
+            return order;
+        }
+        // Simple topological sort based on dependsOn
+        const operations = transaction.operations;
+        const visited = new Set([0]);
+        const idToIndex = new Map();
+        operations.forEach((op, idx) => {
+            if (op.id) {
+                idToIndex.set(op.id, idx + 1);
+            }
+        });
+        const visit = (index) => {
+            if (visited.has(index))
+                return;
+            const op = operations[index - 1];
+            if (op.dependsOn) {
+                for (const depId of op.dependsOn) {
+                    const depIdx = idToIndex.get(depId);
+                    if (depIdx !== undefined) {
+                        visit(depIdx);
+                    }
+                }
+            }
+            visited.add(index);
+            order.push(index);
+        };
+        for (let i = 1; i <= operations.length; i++) {
+            visit(i);
+        }
+        return order;
+    }
+    /**
+     * Get step by index
+     */
+    getStepByIndex(index, transaction) {
+        var _a;
+        if (index === 0) {
+            // Main operation - not in transaction.operations
+            return undefined; // Handled separately
+        }
+        return (_a = transaction.operations) === null || _a === void 0 ? void 0 : _a[index - 1];
+    }
+    /**
+     * Build saga result
+     */
+    buildResult(state) {
+        const stepResults = {};
+        state.results.forEach((value, key) => {
+            stepResults[key] = value;
+        });
+        return {
+            transactionId: state.id,
+            status: state.status,
+            stepResults,
+            executionTime: state.completedAt
+                ? state.completedAt.getTime() - state.startedAt.getTime()
+                : Date.now() - state.startedAt.getTime(),
+            error: state.error,
+        };
+    }
+    /**
+     * Persist saga state
+     */
+    async persistState(state) {
+        if (this.options.persistState) {
+            await this.options.persistState(state);
+        }
+    }
+    /**
+     * Sleep for a given duration
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.SagaOrchestrator = SagaOrchestrator;
+//# sourceMappingURL=saga-orchestrator.js.map

package/dist/warehouse/transactions/saga-orchestrator.js.map

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

package/dist/warehouse/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Warehouse Types
+ *
+ * Unified type definitions for the cross-database warehouse interface.
+ */
+export { DataSourceType, IDataSource, WarehouseOperation, IFieldMapping, IAggregation, IOrderBy, IWarehouseQuery, IExecutionHints, IWarehouseResult, IQueryMetadata, ISourceStats, IJoinStats, IExecutionPlan, IExecutionStep, } from './query.interface';
+export { IComparisonCondition, IStringCondition, IArrayCondition, IJsonCondition, IVectorSimilarityCondition, IGraphConnectivityCondition, IFullTextCondition, IFieldCondition, ILogicalOperators, IUnifiedWhereClause, isEmptyWhereClause, hasVectorOperators, hasGraphOperators, extractFieldPaths, } from './where.interface';
+export { StandardJoinType, JoinType, IJoinCondition, ICompoundJoinCondition, ISemanticJoinConfig, IGraphJoinConfig, IJoinClause, IJoinResult, isCompoundCondition, isStandardJoin, parseFieldPath, buildFieldPath, extractJoinAliases, validateJoinClause, } from './join.interface';
+export { ISagaTransaction, SagaIsolation, ISagaStep, IRetryConfig, ISagaState, SagaStatus, ISagaStepState, StepStatus, ISagaError, ISagaResult, ITransactionContext, generateSagaId, generateStepId, isSagaInProgress, isSagaSuccessful, generateCompensation, } from './transaction.interface';

package/dist/warehouse/types/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Warehouse Types
+ *
+ * Unified type definitions for the cross-database warehouse interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCompensation = exports.isSagaSuccessful = exports.isSagaInProgress = exports.generateStepId = exports.generateSagaId = exports.validateJoinClause = exports.extractJoinAliases = exports.buildFieldPath = exports.parseFieldPath = exports.isStandardJoin = exports.isCompoundCondition = exports.extractFieldPaths = exports.hasGraphOperators = exports.hasVectorOperators = exports.isEmptyWhereClause = void 0;
+// Where clause interfaces
+var where_interface_1 = require("./where.interface");
+// Utilities
+Object.defineProperty(exports, "isEmptyWhereClause", { enumerable: true, get: function () { return where_interface_1.isEmptyWhereClause; } });
+Object.defineProperty(exports, "hasVectorOperators", { enumerable: true, get: function () { return where_interface_1.hasVectorOperators; } });
+Object.defineProperty(exports, "hasGraphOperators", { enumerable: true, get: function () { return where_interface_1.hasGraphOperators; } });
+Object.defineProperty(exports, "extractFieldPaths", { enumerable: true, get: function () { return where_interface_1.extractFieldPaths; } });
+// Join interfaces
+var join_interface_1 = require("./join.interface");
+// Utilities
+Object.defineProperty(exports, "isCompoundCondition", { enumerable: true, get: function () { return join_interface_1.isCompoundCondition; } });
+Object.defineProperty(exports, "isStandardJoin", { enumerable: true, get: function () { return join_interface_1.isStandardJoin; } });
+Object.defineProperty(exports, "parseFieldPath", { enumerable: true, get: function () { return join_interface_1.parseFieldPath; } });
+Object.defineProperty(exports, "buildFieldPath", { enumerable: true, get: function () { return join_interface_1.buildFieldPath; } });
+Object.defineProperty(exports, "extractJoinAliases", { enumerable: true, get: function () { return join_interface_1.extractJoinAliases; } });
+Object.defineProperty(exports, "validateJoinClause", { enumerable: true, get: function () { return join_interface_1.validateJoinClause; } });
+// Transaction interfaces
+var transaction_interface_1 = require("./transaction.interface");
+// Utilities
+Object.defineProperty(exports, "generateSagaId", { enumerable: true, get: function () { return transaction_interface_1.generateSagaId; } });
+Object.defineProperty(exports, "generateStepId", { enumerable: true, get: function () { return transaction_interface_1.generateStepId; } });
+Object.defineProperty(exports, "isSagaInProgress", { enumerable: true, get: function () { return transaction_interface_1.isSagaInProgress; } });
+Object.defineProperty(exports, "isSagaSuccessful", { enumerable: true, get: function () { return transaction_interface_1.isSagaSuccessful; } });
+Object.defineProperty(exports, "generateCompensation", { enumerable: true, get: function () { return transaction_interface_1.generateCompensation; } });
+//# sourceMappingURL=index.js.map

package/dist/warehouse/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/warehouse/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAwBH,0BAA0B;AAC1B,qDAmB2B;AALzB,YAAY;AACZ,qHAAA,kBAAkB,OAAA;AAClB,qHAAA,kBAAkB,OAAA;AAClB,oHAAA,iBAAiB,OAAA;AACjB,oHAAA,iBAAiB,OAAA;AAGnB,kBAAkB;AAClB,mDAmB0B;AAPxB,YAAY;AACZ,qHAAA,mBAAmB,OAAA;AACnB,gHAAA,cAAc,OAAA;AACd,gHAAA,cAAc,OAAA;AACd,gHAAA,cAAc,OAAA;AACd,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAGpB,yBAAyB;AACzB,iEAqBiC;AAN/B,YAAY;AACZ,uHAAA,cAAc,OAAA;AACd,uHAAA,cAAc,OAAA;AACd,yHAAA,gBAAgB,OAAA;AAChB,yHAAA,gBAAgB,OAAA;AAChB,6HAAA,oBAAoB,OAAA"}

package/dist/warehouse/types/join.interface.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Join Interface
+ *
+ * Defines cross-database join operations including standard SQL-style joins,
+ * semantic joins (vector similarity), and graph traversal joins.
+ */
+import { IDataSource } from './query.interface';
+import { IUnifiedWhereClause } from './where.interface';
+/**
+ * Standard join types
+ */
+export type StandardJoinType = 'inner' | 'left' | 'right' | 'full' | 'cross';
+/**
+ * Extended join types including semantic/vector joins
+ */
+export type JoinType = StandardJoinType | 'semantic' | 'graph';
+/**
+ * Standard join condition (equality or comparison)
+ */
+export interface IJoinCondition {
+    /** Left side field path (e.g., "u.id") */
+    left: string;
+    /** Right side field path (e.g., "o.userId") */
+    right: string;
+    /**
+     * Comparison operator
+     * @default '='
+     */
+    operator?: '=' | '!=' | '>' | '<' | '>=' | '<=';
+}
+/**
+ * Multiple join conditions with logical operator
+ */
+export interface ICompoundJoinCondition {
+    /** Logical operator */
+    logic: 'AND' | 'OR';
+    /** Individual conditions */
+    conditions: IJoinCondition[];
+}
+/**
+ * Semantic join configuration (vector similarity)
+ */
+export interface ISemanticJoinConfig {
+    /**
+     * Field containing embedding or text to embed
+     * If text, will be embedded on-the-fly
+     */
+    embedField: string;
+    /**
+     * Minimum similarity threshold (0-1 for cosine)
+     * @default 0.7
+     */
+    similarityThreshold?: number;
+    /**
+     * Maximum similar items to return per row
+     * @default 10
+     */
+    topK?: number;
+    /**
+     * Distance metric
+     * @default 'cosine'
+     */
+    metric?: 'cosine' | 'euclidean' | 'dot_product';
+    /**
+     * Embedding model to use if embedField contains text
+     * Required if embedField is not already a vector
+     */
+    embeddingModel?: string;
+}
+/**
+ * Graph traversal join configuration
+ */
+export interface IGraphJoinConfig {
+    /**
+     * Relationship type to traverse
+     */
+    relationship: string;
+    /**
+     * Traversal direction
+     * @default 'outgoing'
+     */
+    direction?: 'outgoing' | 'incoming' | 'both';
+    /**
+     * Minimum traversal depth
+     * @default 1
+     */
+    minDepth?: number;
+    /**
+     * Maximum traversal depth
+     * @default 1
+     */
+    maxDepth?: number;
+    /**
+     * Filter for intermediate nodes
+     */
+    nodeFilter?: IUnifiedWhereClause;
+    /**
+     * Filter for relationships
+     */
+    relationshipFilter?: IUnifiedWhereClause;
+}
+/**
+ * Join clause for cross-database joins
+ *
+ * @example
+ * // Standard inner join
+ * {
+ *   type: 'inner',
+ *   source: { type: 'database', tag: 'orders-mongo', entity: 'orders', alias: 'o' },
+ *   on: { left: 'u.id', right: 'o.userId' }
+ * }
+ *
+ * @example
+ * // Semantic join (vector similarity)
+ * {
+ *   type: 'semantic',
+ *   source: { type: 'vector', tag: 'products-pinecone', entity: 'products', alias: 'similar' },
+ *   semantic: {
+ *     embedField: 'p.description',
+ *     similarityThreshold: 0.8,
+ *     topK: 5
+ *   }
+ * }
+ *
+ * @example
+ * // Graph traversal join
+ * {
+ *   type: 'graph',
+ *   source: { type: 'graph', tag: 'social-neo4j', entity: 'Person', alias: 'friend' },
+ *   graph: {
+ *     relationship: 'FRIENDS_WITH',
+ *     direction: 'both',
+ *     maxDepth: 2
+ *   },
+ *   on: { left: 'u.id', right: 'friend.userId' }
+ * }
+ */
+export interface IJoinClause {
+    /** Join type */
+    type: JoinType;
+    /** Data source to join */
+    source: IDataSource;
+    /**
+     * Join condition for standard joins
+     * Required for 'inner', 'left', 'right', 'full' joins
+     */
+    on?: IJoinCondition | ICompoundJoinCondition;
+    /**
+     * Semantic join configuration
+     * Required when type is 'semantic'
+     */
+    semantic?: ISemanticJoinConfig;
+    /**
+     * Graph traversal configuration
+     * Required when type is 'graph'
+     */
+    graph?: IGraphJoinConfig;
+    /**
+     * Additional filter to apply to joined data
+     */
+    where?: IUnifiedWhereClause;
+    /**
+     * Fields to select from this join source
+     * If not specified, all fields are included
+     */
+    select?: string[];
+    /**
+     * Alias prefix for all fields from this source
+     * Helps avoid naming conflicts
+     */
+    fieldPrefix?: string;
+}
+/**
+ * Result of a join operation
+ */
+export interface IJoinResult<T = Record<string, any>> {
+    /** Joined data */
+    data: T[];
+    /** Join statistics */
+    stats: {
+        /** Left side row count */
+        leftRows: number;
+        /** Right side row count */
+        rightRows: number;
+        /** Matched pairs */
+        matchedPairs: number;
+        /** Result row count */
+        resultRows: number;
+        /** Join strategy used */
+        strategy: 'hash' | 'nested_loop' | 'sort_merge' | 'semantic' | 'graph';
+        /** Execution time in milliseconds */
+        executionTime: number;
+    };
+}
+/**
+ * Check if a join condition is compound
+ */
+export declare function isCompoundCondition(condition: IJoinCondition | ICompoundJoinCondition): condition is ICompoundJoinCondition;
+/**
+ * Check if a join is a standard SQL-style join
+ */
+export declare function isStandardJoin(type: JoinType): type is StandardJoinType;
+/**
+ * Parse a field path into alias and field name
+ *
+ * @example
+ * parseFieldPath('u.name') // { alias: 'u', field: 'name' }
+ * parseFieldPath('name')    // { alias: undefined, field: 'name' }
+ */
+export declare function parseFieldPath(path: string): {
+    alias?: string;
+    field: string;
+};
+/**
+ * Build a field path from alias and field name
+ */
+export declare function buildFieldPath(alias: string | undefined, field: string): string;
+/**
+ * Extract all source aliases from a list of join clauses
+ */
+export declare function extractJoinAliases(joins: IJoinClause[]): string[];
+/**
+ * Validate join clause configuration
+ */
+export declare function validateJoinClause(join: IJoinClause): string[];