@ductape/sdk 0.1.6 → 0.1.8

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

@@ -1,383 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,33 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,225 +0,0 @@
-/**
- * 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[];