@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/warehouse/registry/data-source-registry.js

@@ -0,0 +1,396 @@
+"use strict";
+/**
+ * Data Source Registry
+ *
+ * Manages data sources across databases, graphs, and vector stores.
+ * Provides unified access to underlying services (DatabaseService, GraphService, VectorService).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSourceRegistry = void 0;
+// ==================== DATA SOURCE REGISTRY ====================
+/**
+ * Data Source Registry
+ *
+ * Central registry for all data sources used by the warehouse.
+ * Manages connections and provides access to underlying services.
+ */
+class DataSourceRegistry {
+    constructor(databaseService, graphService, vectorService, config = {}) {
+        this.databaseService = databaseService;
+        this.graphService = graphService;
+        this.vectorService = vectorService;
+        this.config = config;
+        /** Registered data sources */
+        this.sources = new Map();
+        /** Metadata cache */
+        this.metadataCache = new Map();
+        // Start health checks if enabled
+        if (config.healthCheck) {
+            this.startHealthChecks();
+        }
+    }
+    // ==================== REGISTRATION ====================
+    /**
+     * Register a database data source
+     */
+    async registerDatabase(tag, env, product) {
+        const source = {
+            tag,
+            type: 'database',
+            env,
+            product,
+            status: 'connected', // Assume connected via DatabaseService
+        };
+        // Try to fetch metadata
+        if (this.config.cacheMetadata) {
+            try {
+                source.metadata = await this.fetchDatabaseMetadata(tag, env, product);
+            }
+            catch (error) {
+                console.warn(`[DataSourceRegistry] Failed to fetch metadata for ${tag}:`, error);
+            }
+        }
+        this.sources.set(tag, source);
+        return source;
+    }
+    /**
+     * Register a graph data source
+     */
+    async registerGraph(tag, env, product) {
+        const source = {
+            tag,
+            type: 'graph',
+            env,
+            product,
+            status: 'connected',
+        };
+        // Try to fetch metadata
+        if (this.config.cacheMetadata) {
+            try {
+                source.metadata = await this.fetchGraphMetadata(tag, env, product);
+            }
+            catch (error) {
+                console.warn(`[DataSourceRegistry] Failed to fetch metadata for ${tag}:`, error);
+            }
+        }
+        this.sources.set(tag, source);
+        return source;
+    }
+    /**
+     * Register a vector data source
+     */
+    async registerVector(tag, env, product) {
+        const source = {
+            tag,
+            type: 'vector',
+            env,
+            product,
+            status: 'connected',
+        };
+        // Try to fetch metadata
+        if (this.config.cacheMetadata) {
+            try {
+                source.metadata = await this.fetchVectorMetadata(tag, env, product);
+            }
+            catch (error) {
+                console.warn(`[DataSourceRegistry] Failed to fetch metadata for ${tag}:`, error);
+            }
+        }
+        this.sources.set(tag, source);
+        return source;
+    }
+    /**
+     * Unregister a data source
+     */
+    unregister(tag) {
+        this.metadataCache.delete(tag);
+        return this.sources.delete(tag);
+    }
+    // ==================== LOOKUP ====================
+    /**
+     * Get a registered data source
+     */
+    get(tag) {
+        return this.sources.get(tag);
+    }
+    /**
+     * Check if a data source is registered
+     */
+    has(tag) {
+        return this.sources.has(tag);
+    }
+    /**
+     * Get all registered data sources
+     */
+    getAll() {
+        return Array.from(this.sources.values());
+    }
+    /**
+     * Get data sources by type
+     */
+    getByType(type) {
+        return this.getAll().filter(s => s.type === type);
+    }
+    /**
+     * Resolve a data source reference
+     */
+    resolve(ref) {
+        const source = this.get(ref.tag);
+        if (!source) {
+            throw new Error(`Data source not found: ${ref.tag}`);
+        }
+        if (source.type !== ref.type) {
+            throw new Error(`Data source type mismatch: expected ${ref.type}, got ${source.type} for ${ref.tag}`);
+        }
+        return source;
+    }
+    // ==================== SERVICE ACCESS ====================
+    /**
+     * Get the database service
+     */
+    getDatabaseService() {
+        return this.databaseService;
+    }
+    /**
+     * Get the graph service
+     */
+    getGraphService() {
+        return this.graphService;
+    }
+    /**
+     * Get the vector service
+     */
+    getVectorService() {
+        return this.vectorService;
+    }
+    /**
+     * Get the appropriate service for a data source
+     */
+    getService(source) {
+        switch (source.type) {
+            case 'database':
+                return this.databaseService;
+            case 'graph':
+                return this.graphService;
+            case 'vector':
+                return this.vectorService;
+            default:
+                throw new Error(`Unknown data source type: ${source.type}`);
+        }
+    }
+    // ==================== METADATA ====================
+    /**
+     * Get metadata for a data source
+     */
+    async getMetadata(tag, forceRefresh = false) {
+        const source = this.get(tag);
+        if (!source)
+            return undefined;
+        // Check cache
+        if (!forceRefresh && this.metadataCache.has(tag)) {
+            const cached = this.metadataCache.get(tag);
+            const ttl = (this.config.metadataCacheTtl || 300) * 1000;
+            if (Date.now() - cached.updatedAt.getTime() < ttl) {
+                return cached;
+            }
+        }
+        // Fetch fresh metadata
+        let metadata;
+        switch (source.type) {
+            case 'database':
+                metadata = await this.fetchDatabaseMetadata(tag, source.env, source.product);
+                break;
+            case 'graph':
+                metadata = await this.fetchGraphMetadata(tag, source.env, source.product);
+                break;
+            case 'vector':
+                metadata = await this.fetchVectorMetadata(tag, source.env, source.product);
+                break;
+        }
+        if (metadata) {
+            this.metadataCache.set(tag, metadata);
+            source.metadata = metadata;
+        }
+        return metadata;
+    }
+    /**
+     * Get entity schema
+     */
+    async getEntitySchema(tag, entity) {
+        var _a;
+        const metadata = await this.getMetadata(tag);
+        return (_a = metadata === null || metadata === void 0 ? void 0 : metadata.schemas) === null || _a === void 0 ? void 0 : _a[entity];
+    }
+    /**
+     * Validate that an entity exists in a data source
+     */
+    async validateEntity(source) {
+        const metadata = await this.getMetadata(source.tag);
+        if (!metadata)
+            return true; // Can't validate without metadata
+        return metadata.entities.includes(source.entity);
+    }
+    // ==================== HEALTH CHECKS ====================
+    /**
+     * Check health of a data source
+     */
+    async checkHealth(tag) {
+        var _a;
+        const source = this.get(tag);
+        if (!source)
+            return false;
+        try {
+            switch (source.type) {
+                case 'database':
+                    // Use a simple query to check connection
+                    await this.databaseService.query({
+                        table: ((_a = source.metadata) === null || _a === void 0 ? void 0 : _a.entities[0]) || 'dual',
+                        select: ['1'],
+                        limit: 1,
+                        env: source.env,
+                        product: source.product,
+                        database: tag,
+                    });
+                    break;
+                case 'graph':
+                    // Check graph connection - attempt to connect
+                    await this.graphService.connect({
+                        env: source.env,
+                        product: source.product,
+                        graph: tag,
+                    });
+                    break;
+                case 'vector':
+                    // Check vector connection - attempt to connect
+                    await this.vectorService.connect({
+                        product: source.product,
+                        env: source.env,
+                        vector: tag,
+                    });
+                    break;
+            }
+            source.status = 'connected';
+            source.error = undefined;
+            source.lastHealthCheck = new Date();
+            return true;
+        }
+        catch (error) {
+            source.status = 'error';
+            source.error = error.message;
+            source.lastHealthCheck = new Date();
+            return false;
+        }
+    }
+    /**
+     * Check health of all data sources
+     */
+    async checkAllHealth() {
+        const results = new Map();
+        for (const tag of this.sources.keys()) {
+            results.set(tag, await this.checkHealth(tag));
+        }
+        return results;
+    }
+    /**
+     * Start periodic health checks
+     */
+    startHealthChecks() {
+        const interval = (this.config.healthCheckInterval || 60) * 1000;
+        this.healthCheckTimer = setInterval(() => {
+            this.checkAllHealth().catch(err => {
+                console.error('[DataSourceRegistry] Health check failed:', err);
+            });
+        }, interval);
+    }
+    /**
+     * Stop health checks
+     */
+    stopHealthChecks() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+    }
+    // ==================== PRIVATE METHODS ====================
+    /**
+     * Fetch metadata for a database
+     */
+    async fetchDatabaseMetadata(tag, env, product) {
+        try {
+            const tables = await this.databaseService.listTables({
+                env,
+                product,
+                database: tag,
+            });
+            return {
+                entities: tables, // listTables returns string[]
+                updatedAt: new Date(),
+            };
+        }
+        catch (_a) {
+            return {
+                entities: [],
+                updatedAt: new Date(),
+            };
+        }
+    }
+    /**
+     * Fetch metadata for a graph
+     */
+    async fetchGraphMetadata(tag, env, product) {
+        try {
+            // Connect to the graph first
+            await this.graphService.connect({
+                env,
+                product,
+                graph: tag,
+            });
+            // Get node labels from graph
+            const stats = await this.graphService.getStatistics();
+            return {
+                entities: Object.keys(stats.nodesByLabel || {}),
+                updatedAt: new Date(),
+            };
+        }
+        catch (_a) {
+            return {
+                entities: [],
+                updatedAt: new Date(),
+            };
+        }
+    }
+    /**
+     * Fetch metadata for a vector store
+     */
+    async fetchVectorMetadata(tag, _env, product) {
+        try {
+            // Fetch vector configuration to get metadata
+            const vectorConfig = await this.vectorService.fetch({
+                product,
+                tag,
+            });
+            return {
+                // Use the vector tag as the entity name since vector stores are typically single-index
+                entities: vectorConfig ? [vectorConfig.tag] : [],
+                updatedAt: new Date(),
+            };
+        }
+        catch (_a) {
+            return {
+                entities: [],
+                updatedAt: new Date(),
+            };
+        }
+    }
+    // ==================== CLEANUP ====================
+    /**
+     * Clean up resources
+     */
+    destroy() {
+        this.stopHealthChecks();
+        this.sources.clear();
+        this.metadataCache.clear();
+    }
+}
+exports.DataSourceRegistry = DataSourceRegistry;
+//# sourceMappingURL=data-source-registry.js.map

package/dist/warehouse/registry/data-source-registry.js.map

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

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

@@ -0,0 +1,4 @@
+/**
+ * Registry exports
+ */
+export { DataSourceRegistry, IRegisteredDataSource, IDataSourceMetadata, IEntitySchema, IFieldSchema, IIndexSchema, IRegistryConfig, } from './data-source-registry';

package/dist/warehouse/registry/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Registry exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSourceRegistry = void 0;
+var data_source_registry_1 = require("./data-source-registry");
+Object.defineProperty(exports, "DataSourceRegistry", { enumerable: true, get: function () { return data_source_registry_1.DataSourceRegistry; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/warehouse/registry/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+DAQgC;AAP9B,0HAAA,kBAAkB,OAAA"}

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

@@ -0,0 +1,4 @@
+/**
+ * Transaction exports
+ */
+export { SagaOrchestrator, StepExecutor, ISagaOrchestratorOptions, } from './saga-orchestrator';

package/dist/warehouse/transactions/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Transaction exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SagaOrchestrator = void 0;
+var saga_orchestrator_1 = require("./saga-orchestrator");
+Object.defineProperty(exports, "SagaOrchestrator", { enumerable: true, get: function () { return saga_orchestrator_1.SagaOrchestrator; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/warehouse/transactions/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAI6B;AAH3B,qHAAA,gBAAgB,OAAA"}

package/dist/warehouse/transactions/saga-orchestrator.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Saga Orchestrator
+ *
+ * Manages distributed transactions across multiple data sources using
+ * the Saga pattern with compensating transactions for rollback.
+ */
+import { ISagaTransaction, ISagaState, ISagaResult, IRetryConfig, IWarehouseQuery, IWarehouseResult } from '../types';
+/**
+ * Step executor function
+ */
+export type StepExecutor = (operation: Omit<IWarehouseQuery, 'transaction'>) => Promise<IWarehouseResult>;
+/**
+ * Saga orchestrator options
+ */
+export interface ISagaOrchestratorOptions {
+    /** Default timeout for steps (ms) */
+    defaultTimeout?: number;
+    /** Default retry configuration */
+    defaultRetry?: IRetryConfig;
+    /** Persist saga state callback */
+    persistState?: (state: ISagaState) => Promise<void>;
+    /** Load saga state callback */
+    loadState?: (sagaId: string) => Promise<ISagaState | undefined>;
+}
+/**
+ * Saga Orchestrator
+ *
+ * Coordinates execution of distributed transactions using the Saga pattern.
+ * Handles step execution, compensation on failure, and state management.
+ */
+export declare class SagaOrchestrator {
+    private readonly executor;
+    private readonly options;
+    private readonly activeSagas;
+    constructor(executor: StepExecutor, options?: ISagaOrchestratorOptions);
+    /**
+     * Execute a saga transaction
+     */
+    execute(mainOperation: Omit<IWarehouseQuery, 'transaction'>, transaction: ISagaTransaction): Promise<ISagaResult>;
+    /**
+     * Resume a saga from persisted state
+     */
+    resume(sagaId: string): Promise<ISagaResult | undefined>;
+    /**
+     * Get current saga state
+     */
+    getState(sagaId: string): ISagaState | undefined;
+    /**
+     * Initialize saga state
+     */
+    private initializeSagaState;
+    /**
+     * Execute all saga steps
+     */
+    private executeSteps;
+    /**
+     * Execute a single step with retry logic
+     */
+    private executeStepWithRetry;
+    /**
+     * Check if an error should trigger a retry
+     */
+    private shouldRetry;
+    /**
+     * Handle saga failure - compensate or abort
+     */
+    private handleSagaFailure;
+    /**
+     * Execute compensation for completed steps (in reverse order)
+     */
+    private executeCompensations;
+    /**
+     * Build execution order respecting dependencies
+     */
+    private buildExecutionOrder;
+    /**
+     * Get step by index
+     */
+    private getStepByIndex;
+    /**
+     * Build saga result
+     */
+    private buildResult;
+    /**
+     * Persist saga state
+     */
+    private persistState;
+    /**
+     * Sleep for a given duration
+     */
+    private sleep;
+}