@etohq/connector-engine 1.5.1-alpha.4

package/dist/engine/connector-engine-impl.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * @fileoverview Type-Safe Connector Engine
+ * @description ETO Framework core connector engine with compile-time type safety
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorEngine = ConnectorEngine;
+const workflows_sdk_1 = require("@etohq/framework/workflows-sdk");
+// ===== TYPE-SAFE CONNECTOR ENGINE IMPLEMENTATION =====
+class ConnectorEngineImpl {
+    constructor(connectorTypes) {
+        this.connectorTypes = connectorTypes;
+        this.connectors = new Map();
+        this.plugins = new Map();
+        this.generatedWorkflows = new Map();
+        this.selectionStrategy = "round_robin";
+        this.pluginRegistry = this.createPluginRegistry();
+        this.generateDynamicMethods();
+    }
+    setSelectionStrategy(strategy) {
+        this.selectionStrategy = strategy;
+    }
+    getConnectors() {
+        return Array.from(this.connectors.values());
+    }
+    getConnector(connectorId) {
+        return this.connectors.get(connectorId) || null;
+    }
+    // ===== DYNAMIC METHOD GENERATION =====
+    generateDynamicMethods() {
+        for (const [connectorType, operations] of Object.entries(this.connectorTypes)) {
+            for (const operationName of Object.keys(operations)) {
+                const methodName = `execute${this.capitalize(connectorType)}${this.capitalize(operationName)}`;
+                this[methodName] = (input, options) => {
+                    // Select connector based on options or auto-select
+                    const connectorId = options?.connectorId ||
+                        this.selectConnector(connectorType, operationName, options?.selection);
+                    // Get the workflow from registry
+                    // createWorkflow already returns a properly typed ReturnWorkflow
+                    const workflow = this.getWorkflow(connectorType, operationName, connectorId);
+                    // Return the workflow directly - it's already a complete ReturnWorkflow
+                    // The workflow function, run(), runAsStep(), etc. are all provided by createWorkflow
+                    return workflow;
+                };
+            }
+        }
+    }
+    capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    // ===== CONNECTOR LIFECYCLE =====
+    async installConnector(provider, config) {
+        const plugin = this.plugins.get(provider);
+        if (!plugin) {
+            throw new Error(`Plugin not found for provider: ${provider}`);
+        }
+        await plugin.initialize(config);
+        this.connectors.set(config.connector_id, config);
+        // Generate workflows for this connector
+        this.generateWorkflowsForConnector(config.connector_id, provider, plugin);
+        return config.connector_id;
+    }
+    registerPlugin(provider, plugin) {
+        this.plugins.set(provider, plugin);
+    }
+    async uninstallConnector(connectorId) {
+        const config = this.connectors.get(connectorId);
+        if (!config) {
+            throw new Error(`Connector not found: ${connectorId}`);
+        }
+        const plugin = this.plugins.get(config.provider);
+        if (plugin) {
+            await plugin.destroy();
+        }
+        this.connectors.delete(connectorId);
+        // Remove generated workflows
+        for (const [key] of this.generatedWorkflows) {
+            if (key.includes(connectorId)) {
+                this.generatedWorkflows.delete(key);
+            }
+        }
+    }
+    // ===== CONNECTOR SELECTION =====
+    selectConnector(connectorType, operation, criteria) {
+        const availableConnectors = Array.from(this.connectors.values()).filter((connector) => {
+            if (!connector.enabled)
+                return false;
+            const plugin = this.plugins.get(connector.provider);
+            if (!plugin)
+                return false;
+            // Check if plugin supports the operation
+            if (this.isTypedPlugin(plugin)) {
+                const operations = plugin.getSupportedOperations();
+                if (!operations[operation])
+                    return false;
+            }
+            // Apply selection criteria
+            if (criteria?.preferredProviders &&
+                !criteria.preferredProviders.includes(connector.provider)) {
+                return false;
+            }
+            if (criteria?.excludeProviders &&
+                criteria.excludeProviders.includes(connector.provider)) {
+                return false;
+            }
+            if (criteria?.region &&
+                connector.metadata?.region !== criteria.region) {
+                return false;
+            }
+            if (criteria?.requireCapabilities) {
+                for (const capability of criteria.requireCapabilities) {
+                    if (!connector.capabilities[capability]) {
+                        return false;
+                    }
+                }
+            }
+            return true;
+        });
+        if (availableConnectors.length === 0) {
+            throw new Error(`No available connectors for ${connectorType}.${operation}`);
+        }
+        // Apply selection strategy
+        switch (this.selectionStrategy) {
+            case "round_robin":
+                return availableConnectors[Math.floor(Math.random() * availableConnectors.length)].connector_id;
+            case "priority":
+                // todo fix
+                return availableConnectors[0].connector_id;
+            default:
+                return availableConnectors[0].connector_id;
+        }
+    }
+    // ===== WORKFLOW GENERATION =====
+    generateWorkflowsForConnector(connectorId, provider, plugin) {
+        for (const [connectorType, operations] of Object.entries(this.connectorTypes)) {
+            for (const operationName of Object.keys(operations)) {
+                // Check if plugin supports this operation
+                if (this.pluginSupportsOperation(plugin, operationName)) {
+                    const workflowKey = `${connectorType}-${connectorId}-${operationName}`;
+                    const workflow = this.createWorkflowForOperation(connectorId, provider, connectorType, operationName, plugin);
+                    this.generatedWorkflows.set(workflowKey, workflow);
+                }
+            }
+        }
+    }
+    createWorkflowForOperation(connectorId, provider, connectorType, operationName, plugin) {
+        // Create ETO step for this operation
+        const step = (0, workflows_sdk_1.createStep)(`${provider}-${operationName}`, async (input, { container }) => {
+            const config = this.connectors.get(connectorId);
+            if (!config) {
+                throw new Error(`Connector not found: ${connectorId}`);
+            }
+            let result;
+            if (this.isTypedPlugin(plugin)) {
+                result = await plugin.executeOperation(config, operationName, input.data);
+            }
+            else {
+                // Fallback for non-typed plugins
+                const pluginMethod = plugin[operationName];
+                if (typeof pluginMethod === "function") {
+                    const rawResult = await pluginMethod.call(plugin, config, input.data);
+                    result = {
+                        success: true,
+                        data: rawResult,
+                        metadata: {
+                            connectorId,
+                            provider: config.provider,
+                            executionTime: 0,
+                            timestamp: new Date(),
+                            retryCount: 0,
+                        },
+                    };
+                }
+                else {
+                    throw new Error(`Operation ${operationName} not supported by plugin ${provider}`);
+                }
+            }
+            if (!result.success) {
+                throw new Error(result.error?.message || `Operation ${operationName} failed`);
+            }
+            return new workflows_sdk_1.StepResponse(result.data, {
+                connectorId,
+                operation: operationName,
+                result: result.data,
+            });
+        }, async (compensationData, { container }) => {
+            // Auto-generated compensation
+            console.log(`Compensating ${provider}-${operationName}:`, compensationData);
+            // Check if plugin has custom compensation
+            const compensationFn = plugin[`${operationName}_compensate`];
+            if (compensationFn && typeof compensationFn === "function") {
+                await compensationFn.call(plugin, compensationData, { container });
+            }
+        });
+        // Create ETO workflow that wraps the step
+        const workflow = (0, workflows_sdk_1.createWorkflow)(`${provider}-${operationName}-workflow`, (input) => {
+            const config = this.connectors.get(connectorId);
+            const stepInput = {
+                config,
+                data: input,
+            };
+            const result = step(stepInput);
+            return new workflows_sdk_1.WorkflowResponse(result);
+        });
+        return workflow;
+    }
+    // ===== WORKFLOW ACCESS =====
+    getWorkflow(connectorType, operation, connectorId) {
+        const selectedConnectorId = connectorId || this.selectConnector(connectorType, operation);
+        const workflowKey = `${connectorType}-${selectedConnectorId}-${operation}`;
+        const workflow = this.generatedWorkflows.get(workflowKey);
+        if (!workflow) {
+            throw new Error(`Workflow not found for ${connectorType}.${operation} with connector ${selectedConnectorId}`);
+        }
+        return workflow;
+    }
+    // ===== HEALTH MONITORING =====
+    async getSystemHealth() {
+        const connectors = {};
+        let healthyCount = 0;
+        let totalCount = 0;
+        for (const [connectorId, config] of this.connectors) {
+            totalCount++;
+            const plugin = this.plugins.get(config.provider);
+            if (plugin) {
+                try {
+                    connectors[connectorId] = await plugin.healthCheck();
+                    if (connectors[connectorId].status === "healthy") {
+                        healthyCount++;
+                    }
+                }
+                catch (error) {
+                    connectors[connectorId] = {
+                        status: "unhealthy",
+                        lastChecked: new Date(),
+                        errors: [error.message],
+                    };
+                }
+            }
+            else {
+                connectors[connectorId] = {
+                    status: "unhealthy",
+                    lastChecked: new Date(),
+                    errors: ["Plugin not found"],
+                };
+            }
+        }
+        let overall = "healthy";
+        if (healthyCount === 0 && totalCount > 0) {
+            overall = "unhealthy";
+        }
+        else if (healthyCount < totalCount) {
+            overall = "degraded";
+        }
+        return { overall, connectors };
+    }
+    // ===== UTILITY METHODS =====
+    isTypedPlugin(plugin) {
+        return "getSupportedOperations" in plugin && "executeOperation" in plugin;
+    }
+    pluginSupportsOperation(plugin, operationName) {
+        if (this.isTypedPlugin(plugin)) {
+            const operations = plugin.getSupportedOperations();
+            return operationName in operations;
+        }
+        // For non-typed plugins, check if method exists
+        return typeof plugin[operationName] === "function";
+    }
+    createPluginRegistry() {
+        const registry = new Map();
+        return {
+            registerPlugin: (pluginType, provider, factory) => {
+                if (!registry.has(pluginType)) {
+                    registry.set(pluginType, new Map());
+                }
+                registry.get(pluginType).set(provider, factory);
+            },
+            getPlugin: (pluginType, provider) => {
+                return registry.get(pluginType)?.get(provider) || null;
+            },
+            listPlugins: (pluginType) => {
+                const result = [];
+                if (pluginType) {
+                    const providers = registry.get(pluginType);
+                    if (providers) {
+                        for (const [provider, factory] of providers) {
+                            result.push({ pluginType, provider, factory });
+                        }
+                    }
+                }
+                else {
+                    for (const [type, providers] of registry) {
+                        for (const [provider, factory] of providers) {
+                            result.push({ pluginType: type, provider, factory });
+                        }
+                    }
+                }
+                return result;
+            },
+            register: function (name, plugin) {
+                throw new Error("Function not implemented.");
+            },
+            unregister: function (name) {
+                throw new Error("Function not implemented.");
+            },
+            get: function (name) {
+                throw new Error("Function not implemented.");
+            },
+            list: function () {
+                throw new Error("Function not implemented.");
+            },
+            has: function (name) {
+                throw new Error("Function not implemented.");
+            },
+            validate: function (plugin) {
+                throw new Error("Function not implemented.");
+            },
+            getOperations: function (pluginName) {
+                throw new Error("Function not implemented.");
+            },
+            getPluginInfo: function (name) {
+                throw new Error("Function not implemented.");
+            },
+        };
+    }
+}
+// ===== CONFIGURATION =====
+// ===== TYPE-SAFE CONNECTOR ENGINE FACTORY =====
+function ConnectorEngine(connectorTypes) {
+    return new ConnectorEngineImpl(connectorTypes);
+}
+//# sourceMappingURL=connector-engine-impl.js.map

package/dist/engine/connector-engine-impl.js.map

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

package/dist/engine/connector-engine.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Universal Connector Engine
+ * @description Plugin-first connector engine with operation groups and full type safety
+ */
+import { BaseConnectorPlugin } from "../types/base-plugin";
+import { OperationGroupsConfig, OperationGroupResult, ExtractGroupNames, ExtractGroupOperations, InferOperationGroupInput, InferOperationGroupOutput } from "../types/operation-groups";
+import { EtoContainer, Context } from "@etohq/framework/types";
+export interface PluginConfiguration {
+    [domainName: string]: BaseConnectorPlugin;
+}
+interface StepDefinition<TInput = unknown, TOutput = unknown> {
+    stepId: string;
+    run(input: TInput, context: {
+        container: EtoContainer;
+    }): Promise<TOutput>;
+}
+export interface PluginRegistry {
+    register(name: string, plugin: BaseConnectorPlugin): void;
+    get(name: string): BaseConnectorPlugin | undefined;
+    list(): string[];
+    validate(plugin: BaseConnectorPlugin): boolean;
+    getOperations(pluginName: string): string[];
+}
+export declare function ConnectorEngine<TPlugins extends PluginConfiguration, TOperationGroups extends OperationGroupsConfig = {}>(plugins: TPlugins, operationGroups?: TOperationGroups): void;
+type GroupMethods = TOperationGroups extends OperationGroupsConfig ? {
+    [GroupName in ExtractGroupNames<TOperationGroups>]: {
+        [Operation in ExtractGroupOperations<TOperationGroups, GroupName> as `execute${Capitalize<GroupName & string>}${Capitalize<Operation & string>}`]: <TInput extends InferOperationGroupInput<InferredConnectorTypes, TOperationGroups, GroupName, Operation>, TOutput extends InferOperationGroupOutput<InferredConnectorTypes, TOperationGroups, GroupName, Operation>>(input: TInput, sharedContext?: Context) => Promise<OperationGroupResult<TOutput>>;
+    }[ExtractGroupOperations<TOperationGroups, GroupName>];
+} : as;
+declare class ConnectorEngineImpl implements DomainMethods, GroupMethods {
+    private readonly plugins;
+    private readonly operationGroups;
+    private readonly pluginRegistry;
+    constructor();
+    private generateDynamicMethods;
+    private generateDomainMethods;
+    private generateGroupMethods;
+    executeDomainOperation<TInput = unknown, TOutput = unknown>(domain: keyof TPlugins, operation: string, input: TInput, sharedContext?: Context): Promise<TOutput>;
+    executeGroupOperation<TInput = unknown, TOutput = unknown>(groupId: keyof TOperationGroups, operation: string, input: TInput, sharedContext?: Context): Promise<OperationGroupResult<TOutput>>;
+    private generateEtoStyleMethods;
+    private generatePluginMethods;
+    private generateOperationGroupMethods;
+    private getGroupMethodName;
+    private executeSingleOperation;
+    private executeOperationGroup;
+    getPluginRegistry(): PluginRegistry;
+    getGeneratedMethods(): {
+        domainMethods: string[];
+        groupMethods: string[];
+    };
+}
+export { ConnectorEngineImpl as UniversalConnectorEngine };
+export type { PluginConfiguration, PluginRegistry, WorkflowDefinition, StepDefinition, OperationGroupsConfig, OperationGroupResult };
+//# sourceMappingURL=connector-engine.d.ts.map

package/dist/engine/connector-engine.d.ts.map

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