@etohq/connector-engine 1.5.1-alpha.4

package/dist/types/base-plugin.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * @fileoverview Base Plugin Interface
+ * @description Enhanced base interface with operation types and container context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractConnectorPlugin = exports.PluginType = void 0;
+// ===== PLUGIN TYPES =====
+var PluginType;
+(function (PluginType) {
+    PluginType["PAYMENT"] = "payment";
+    PluginType["NOTIFICATION"] = "notification";
+    PluginType["CALENDAR"] = "calendar";
+    PluginType["VIDEO"] = "video";
+    PluginType["STORAGE"] = "storage";
+    PluginType["ANALYTICS"] = "analytics";
+    PluginType["RESOURCE"] = "resource";
+    PluginType["CUSTOM"] = "custom";
+})(PluginType || (exports.PluginType = PluginType = {}));
+// ===== ENHANCED BASE PLUGIN =====
+class AbstractConnectorPlugin {
+    constructor() {
+        this.config = null;
+        this.initialized = false;
+    }
+    async initialize(config) {
+        this.config = config;
+        this.initialized = true;
+    }
+    async destroy() {
+        this.config = null;
+        this.initialized = false;
+    }
+    async healthCheck() {
+        return {
+            status: this.initialized ? 'healthy' : 'unhealthy',
+            message: this.initialized ? 'Plugin is initialized' : 'Plugin not initialized',
+            lastChecked: new Date()
+        };
+    }
+    ensureInitialized() {
+        if (!this.initialized || !this.config) {
+            throw new Error(`Plugin ${this.getName()} is not initialized`);
+        }
+    }
+    getConfig() {
+        this.ensureInitialized();
+        return this.config;
+    }
+}
+exports.AbstractConnectorPlugin = AbstractConnectorPlugin;
+createPlugin(config, engine_1.ConnectorConfig);
+TPlugin;
+getSupportedProviders();
+string[];
+getPluginType();
+string;
+// ===== PLUGIN TYPES =====
+(function (PluginType) {
+    PluginType["PAYMENT"] = "payment";
+    PluginType["NOTIFICATION"] = "notification";
+    PluginType["CALENDAR"] = "calendar";
+    PluginType["VIDEO"] = "video";
+    PluginType["STORAGE"] = "storage";
+    PluginType["RESOURCE"] = "resource";
+    PluginType["BOOKING"] = "booking";
+})(PluginType || (exports.PluginType = PluginType = {}));
+//# sourceMappingURL=base-plugin.js.map

package/dist/types/base-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-plugin.js","sourceRoot":"","sources":["../../src/types/base-plugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkHH,2BAA2B;AAE3B,IAAY,UASX;AATD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;IACvB,mCAAqB,CAAA;IACrB,+BAAiB,CAAA;AACnB,CAAC,EATW,UAAU,0BAAV,UAAU,QASrB;AAoCD,mCAAmC;AAEnC,MAAsB,uBAAuB;IAA7C;QACY,WAAM,GAA2B,IAAI,CAAC;QACtC,gBAAW,GAAG,KAAK,CAAC;IAkChC,CAAC;IA5BC,KAAK,CAAC,UAAU,CAAC,MAAuB;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAClD,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,wBAAwB;YAC9E,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;IACJ,CAAC;IAES,iBAAiB;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAES,SAAS;QACjB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,MAAO,CAAC;IACtB,CAAC;CACF;AApCD,0DAoCC;AACC,YAAY,CAAC,MAAM,EAAE,wBAAe,CAAC,CAAA;AAAE,OAAO,CAAC;AAC/C,qBAAqB,EAAE,CAAA;AAAE,MAAM,CAAC,CAAC,CAAC;AAClC,aAAa,EAAE,CAAA;AAAE,MAAM,CAAC;AA+C1B,2BAA2B;AAE3B,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,iCAAmB,CAAA;IACnB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;AACrB,CAAC,EARW,UAAU,0BAAV,UAAU,QAQrB"}

package/dist/types/connector-plugin.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Clean Connector Plugin Design - First Principles
+ */
+export interface OperationType {
+    input: any;
+    output: any;
+}
+export interface ConnectorPlugin<TOperations extends Record<string, OperationType> = Record<string, OperationType>> {
+    getName(): string;
+    getVersion(): string;
+    operations: {
+        [K in keyof TOperations]: (input: TOperations[K]['input'], config: any) => Promise<TOperations[K]['output']>;
+    };
+}
+export declare abstract class AbstractConnectorPlugin<TOperations extends Record<string, OperationType> = Record<string, OperationType>> implements ConnectorPlugin<TOperations> {
+    abstract getName(): string;
+    abstract getVersion(): string;
+    abstract operations: {
+        [K in keyof TOperations]: (input: TOperations[K]['input'], config: any) => Promise<TOperations[K]['output']>;
+    };
+}
+//# sourceMappingURL=connector-plugin.d.ts.map

package/dist/types/connector-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-plugin.d.ts","sourceRoot":"","sources":["../../src/types/connector-plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;CACb;AAGD,MAAM,WAAW,eAAe,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAChH,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,IAAI,MAAM,CAAC;IAGrB,UAAU,EAAE;SACT,CAAC,IAAI,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9B,MAAM,EAAE,GAAG,KACR,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KACvC,CAAC;CACH;AAGD,8BAAsB,uBAAuB,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAC7H,YAAW,eAAe,CAAC,WAAW,CAAC;IAEvC,QAAQ,CAAC,OAAO,IAAI,MAAM;IAC1B,QAAQ,CAAC,UAAU,IAAI,MAAM;IAC7B,QAAQ,CAAC,UAAU,EAAE;SAClB,CAAC,IAAI,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KAC7G,CAAC;CACH"}

package/dist/types/connector-plugin.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * @fileoverview Clean Connector Plugin Design - First Principles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractConnectorPlugin = void 0;
+// ===== ABSTRACT BASE =====
+class AbstractConnectorPlugin {
+}
+exports.AbstractConnectorPlugin = AbstractConnectorPlugin;
+//# sourceMappingURL=connector-plugin.js.map

package/dist/types/connector-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-plugin.js","sourceRoot":"","sources":["../../src/types/connector-plugin.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAsBH,4BAA4B;AAC5B,MAAsB,uBAAuB;CAQ5C;AARD,0DAQC"}

package/dist/types/engine.d.ts

@@ -0,0 +1,223 @@
+/**
+ * @fileoverview Core Engine Types
+ * @description Core interfaces for the ETO Framework Connector Engine
+ */
+export type ConnectorID = string;
+export type TaskID = string;
+export type WorkflowID = string;
+export type PluginName = string;
+export interface ConnectorConfig {
+    connector_id: ConnectorID;
+    provider: string;
+    name: string;
+    config: Record<string, unknown>;
+    capabilities: ConnectorCapabilities;
+    enabled: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface ConnectorCapabilities {
+    health_check: boolean;
+    webhook_handling: boolean;
+    [capability: string]: boolean;
+}
+export interface ExecutionOptions {
+    connectorId?: ConnectorID;
+    selection?: ConnectorSelectionCriteria;
+    metadata?: Record<string, unknown>;
+    timeout?: number;
+    retries?: number;
+    priority?: number;
+}
+export interface ConnectorSelectionCriteria {
+    preferredProviders?: string[];
+    excludeProviders?: string[];
+    region?: string;
+    requireCapabilities?: string[];
+    [criteria: string]: unknown;
+}
+export type ConnectorSelectionStrategy = "round_robin" | "random" | "priority" | "least_loaded" | "fastest_response" | "custom";
+export interface ConnectorResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: ConnectorError;
+    metadata: {
+        connectorId: ConnectorID;
+        provider: string;
+        executionTime: number;
+        timestamp: Date;
+        retryCount?: number;
+    };
+}
+export interface ConnectorError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+    retryable: boolean;
+    category: 'network' | 'authentication' | 'authorization' | 'validation' | 'rate_limit' | 'server_error' | 'unknown';
+}
+export interface PluginHealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    message?: string;
+    lastChecked: Date;
+    responseTime?: number;
+    details?: Record<string, unknown>;
+}
+export interface SystemHealthStatus {
+    overall: 'healthy' | 'degraded' | 'unhealthy';
+    plugins: Record<string, PluginHealthStatus>;
+    timestamp: Date;
+    uptime: number;
+}
+export interface ConnectorMetrics {
+    connectorId: ConnectorID;
+    provider: string;
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    averageResponseTime: number;
+    lastRequestTime?: Date;
+    errorRate: number;
+    availability: number;
+}
+export interface OperationMetrics {
+    operationName: string;
+    domain: string;
+    totalExecutions: number;
+    successfulExecutions: number;
+    failedExecutions: number;
+    averageExecutionTime: number;
+    lastExecutionTime?: Date;
+    errorsByType: Record<string, number>;
+}
+export interface WebhookConfig {
+    url: string;
+    secret?: string;
+    events: string[];
+    headers?: Record<string, string>;
+    retries?: number;
+    timeout?: number;
+}
+export interface WebhookPayload {
+    id: string;
+    event: string;
+    timestamp: Date;
+    data: unknown;
+    source: {
+        connectorId: ConnectorID;
+        provider: string;
+    };
+    signature?: string;
+}
+export interface RateLimitConfig {
+    requestsPerSecond?: number;
+    requestsPerMinute?: number;
+    requestsPerHour?: number;
+    requestsPerDay?: number;
+    burstLimit?: number;
+    strategy: 'token_bucket' | 'sliding_window' | 'fixed_window';
+}
+export interface RateLimitStatus {
+    remaining: number;
+    resetTime: Date;
+    limit: number;
+    retryAfter?: number;
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    recoveryTimeout: number;
+    monitoringPeriod: number;
+    halfOpenMaxCalls: number;
+}
+export interface CircuitBreakerStatus {
+    state: 'closed' | 'open' | 'half_open';
+    failureCount: number;
+    lastFailureTime?: Date;
+    nextAttemptTime?: Date;
+}
+export interface RetryConfig {
+    maxAttempts: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    jitter: boolean;
+    retryableErrors: string[];
+}
+export interface CacheConfig {
+    enabled: boolean;
+    ttl: number;
+    maxSize: number;
+    strategy: 'lru' | 'fifo' | 'ttl';
+}
+export interface CacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    timestamp: Date;
+    ttl: number;
+    hits: number;
+}
+export interface AuditLog {
+    id: string;
+    timestamp: Date;
+    connectorId: ConnectorID;
+    operation: string;
+    input: unknown;
+    output?: unknown;
+    error?: ConnectorError;
+    executionTime: number;
+    userId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface LogLevel {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    timestamp: Date;
+    context?: Record<string, unknown>;
+}
+export interface PluginLifecycleEvents {
+    onInitialize?: (config: ConnectorConfig) => Promise<void>;
+    onDestroy?: () => Promise<void>;
+    onConfigUpdate?: (newConfig: ConnectorConfig) => Promise<void>;
+    onHealthCheck?: () => Promise<PluginHealthStatus>;
+}
+export interface ConnectorEngineConfig {
+    plugins: Record<string, unknown>;
+    operationGroups?: Record<string, unknown>;
+    defaultTimeout: number;
+    defaultRetries: number;
+    healthCheckInterval: number;
+    metricsEnabled: boolean;
+    auditEnabled: boolean;
+    caching: CacheConfig;
+    rateLimiting?: RateLimitConfig;
+    circuitBreaker?: CircuitBreakerConfig;
+}
+export type ConnectorSelectionStrategy = "round_robin" | "first_available" | "weighted" | "custom";
+export interface PluginHealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    lastChecked: Date;
+    details?: any;
+    errors?: string[];
+}
+export interface WorkflowContext {
+    executionId: string;
+    stepId?: string;
+    metadata?: Record<string, any>;
+}
+export interface ConnectorError {
+    code: string;
+    message: string;
+    details?: any;
+    retryable?: boolean;
+}
+export interface ConnectorResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: ConnectorError;
+    metadata?: {
+        connectorId: ConnectorID;
+        provider: string;
+        executionTime?: number;
+        requestId?: string;
+    };
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/types/engine.d.ts.map

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

package/dist/types/engine.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @fileoverview Core Engine Types
+ * @description Core interfaces for the ETO Framework Connector Engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=engine.js.map

package/dist/types/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/types/engine.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Clean Connector Engine Types
+ */
+export { type ConnectorPlugin, type OperationType, AbstractConnectorPlugin } from "./connector-plugin";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * @fileoverview Clean Connector Engine Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractConnectorPlugin = void 0;
+var connector_plugin_1 = require("./connector-plugin");
+Object.defineProperty(exports, "AbstractConnectorPlugin", { enumerable: true, get: function () { return connector_plugin_1.AbstractConnectorPlugin; } });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAuG;AAApD,2HAAA,uBAAuB,OAAA"}

package/dist/types/operation-groups.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Operation Groups Types
+ * @description Types for operation group configuration in connector engine
+ */
+export interface OperationGroupsConfig {
+    [groupName: string]: {
+        domains: string[];
+        operations: string[];
+        options: {
+            behavior: 'execute_all' | 'route_by_domain' | 'first_success';
+            connectorId?: string;
+            priority?: number;
+            timeout?: number;
+            retries?: number;
+        };
+    };
+}
+export interface OperationGroupExecutionOptions {
+    behavior: 'execute_all' | 'route_by_domain' | 'first_success';
+    connectorId?: string;
+    priority?: number;
+    timeout?: number;
+    retries?: number;
+}
+export interface OperationGroupResult<T = unknown> {
+    groupName: string;
+    executedDomains: string[];
+    results: Record<string, T>;
+    metadata: {
+        behavior: string;
+        connectorId?: string;
+        executionTime: number;
+        errors?: Record<string, Error>;
+        domainSource?: 'input' | 'options' | 'group_default';
+    };
+}
+export type ExtractGroupNames<T extends OperationGroupsConfig> = keyof T;
+export type ExtractGroupOperations<T extends OperationGroupsConfig, K extends keyof T> = T[K]['operations'][number];
+export type ExtractGroupDomains<T extends OperationGroupsConfig, K extends keyof T> = T[K]['domains'][number];
+export type InferOperationGroupInput<TInferredConnectorTypes extends Record<string, Record<string, {
+    input: unknown;
+    output: unknown;
+}>>, TOperationGroups extends OperationGroupsConfig, TGroupName extends keyof TOperationGroups, TOperation extends string> = TOperationGroups[TGroupName]['options']['behavior'] extends 'route_by_domain' ? {
+    domain?: ExtractGroupDomains<TOperationGroups, TGroupName>;
+} & UnionToIntersection<{
+    [Domain in ExtractGroupDomains<TOperationGroups, TGroupName>]: Domain extends keyof TInferredConnectorTypes ? TOperation extends keyof TInferredConnectorTypes[Domain] ? TInferredConnectorTypes[Domain][TOperation]['input'] : unknown : unknown;
+}[ExtractGroupDomains<TOperationGroups, TGroupName>]> : UnionToIntersection<{
+    [Domain in ExtractGroupDomains<TOperationGroups, TGroupName>]: Domain extends keyof TInferredConnectorTypes ? TOperation extends keyof TInferredConnectorTypes[Domain] ? TInferredConnectorTypes[Domain][TOperation]['input'] : unknown : unknown;
+}[ExtractGroupDomains<TOperationGroups, TGroupName>]>;
+export type InferOperationGroupOutput<TInferredConnectorTypes extends Record<string, Record<string, {
+    input: unknown;
+    output: unknown;
+}>>, TOperationGroups extends OperationGroupsConfig, TGroupName extends keyof TOperationGroups, TOperation extends string> = OperationGroupResult<UnionToIntersection<{
+    [Domain in ExtractGroupDomains<TOperationGroups, TGroupName>]: Domain extends keyof TInferredConnectorTypes ? TOperation extends keyof TInferredConnectorTypes[Domain] ? TInferredConnectorTypes[Domain][TOperation]['output'] : unknown : unknown;
+}[ExtractGroupDomains<TOperationGroups, TGroupName>]>>;
+type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+export interface OperationGroupBuilder<T extends OperationGroupsConfig = {}> {
+    addGroup<TGroupName extends string, TDomains extends readonly string[], TOperations extends readonly string[]>(groupName: TGroupName, config: {
+        domains: TDomains;
+        operations: TOperations;
+        options: OperationGroupExecutionOptions;
+    }): OperationGroupBuilder<T & Record<TGroupName, {
+        domains: TDomains[number][];
+        operations: TOperations[number][];
+        options: OperationGroupExecutionOptions;
+    }>>;
+    build(): T;
+}
+export declare function createOperationGroupBuilder(): OperationGroupBuilder<{}>;
+export interface OperationGroupValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function validateOperationGroups<T extends OperationGroupsConfig>(groups: T, availableDomains: string[], domainOperations: Record<string, string[]>): OperationGroupValidationResult;
+export type InferOperationGroupOutput<TInferredConnectorTypes extends Record<string, any>, TOperationGroups extends OperationGroupsConfig, TGroupName extends keyof TOperationGroups, TOperation extends string> = TOperationGroups[TGroupName]['options']['behavior'] extends 'route_by_domain' ? any : OperationGroupResult<any>;
+export {};
+//# sourceMappingURL=operation-groups.d.ts.map

package/dist/types/operation-groups.d.ts.map

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

package/dist/types/operation-groups.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * @fileoverview Operation Groups Types
+ * @description Types for operation group configuration in connector engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOperationGroupBuilder = createOperationGroupBuilder;
+exports.validateOperationGroups = validateOperationGroups;
+function createOperationGroupBuilder() {
+    const groups = {};
+    return {
+        addGroup(groupName, config) {
+            groups[groupName] = config;
+            return this;
+        },
+        build() {
+            return groups;
+        }
+    };
+}
+function validateOperationGroups(groups, availableDomains, domainOperations) {
+    const errors = [];
+    const warnings = [];
+    for (const [groupName, groupConfig] of Object.entries(groups)) {
+        // Validate domains
+        for (const domain of groupConfig.domains) {
+            if (!availableDomains.includes(domain)) {
+                errors.push(`Group '${groupName}' references unknown domain '${domain}'`);
+            }
+        }
+        // Validate operations
+        for (const domain of groupConfig.domains) {
+            if (domainOperations[domain]) {
+                for (const operation of groupConfig.operations) {
+                    if (!domainOperations[domain].includes(operation)) {
+                        errors.push(`Group '${groupName}' references unknown operation '${operation}' for domain '${domain}'`);
+                    }
+                }
+            }
+        }
+        // Validate behavior-specific requirements
+        if (groupConfig.options.behavior === 'route_by_domain' && groupConfig.domains.length === 1) {
+            warnings.push(`Group '${groupName}' uses 'route_by_domain' behavior with only one domain`);
+        }
+        if (groupConfig.options.behavior === 'first_success' && groupConfig.domains.length === 1) {
+            warnings.push(`Group '${groupName}' uses 'first_success' behavior with only one domain`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+{
+    domain ?  : ExtractGroupDomains; // ✅ Optional domain
+}
+ & (UnionToIntersection);
+UnionToIntersection;
+//# sourceMappingURL=operation-groups.js.map

package/dist/types/operation-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-groups.js","sourceRoot":"","sources":["../../src/types/operation-groups.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA6HH,kEAYC;AAUD,0DA0CC;AAhED,SAAgB,2BAA2B;IACzC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,OAAO;QACL,QAAQ,CAAC,SAAS,EAAE,MAAM;YACxB,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;YAC3B,OAAO,IAAsD,CAAC;QAChE,CAAC;QACD,KAAK;YACH,OAAO,MAAiC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAUD,SAAgB,uBAAuB,CACrC,MAAS,EACT,gBAA0B,EAC1B,gBAA0C;IAE1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,mBAAmB;QACnB,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,gCAAgC,MAAM,GAAG,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,KAAK,MAAM,SAAS,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;oBAC/C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;wBAClD,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,mCAAmC,SAAS,iBAAiB,MAAM,GAAG,CAAC,CAAC;oBACzG,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,KAAK,iBAAiB,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3F,QAAQ,CAAC,IAAI,CAAC,UAAU,SAAS,wDAAwD,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,KAAK,eAAe,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzF,QAAQ,CAAC,IAAI,CAAC,UAAU,SAAS,sDAAsD,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAEG,CAAC;IACC,MAAM,CAAA,CAAC,CAAA,CAAA,CAAC,CAAC,mBAAiD,CAAC,CAAC,oBAAoB;AAClF,CAAC;AAAC,AAAD,IAAG,mBAQH,CAAA,CAAA;AAED,mBAQC,CAAC"}

package/dist/types/routing-config.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Generic Routing Configuration (Not Payment-Specific)
+ */
+export interface RoutingContext {
+    operation?: string;
+    domain?: string;
+    region?: string;
+    country?: string;
+    userId?: string;
+    tenantId?: string;
+    priority?: 'low' | 'normal' | 'high';
+    resourceType?: string;
+    resourceSize?: number;
+    metadata?: Record<string, any>;
+    forceConnector?: string;
+    skipRouting?: boolean;
+}
+export interface RoutingRule {
+    name: string;
+    description?: string;
+    conditions: {
+        resourceType?: string[];
+        resourceSize?: {
+            min?: number;
+            max?: number;
+        };
+        region?: string[];
+        country?: string[];
+        tenantId?: string[];
+        priority?: string[];
+        timeOfDay?: {
+            start?: string;
+            end?: string;
+        };
+        dayOfWeek?: string[];
+        customFields?: Record<string, any>;
+        metadata?: Record<string, any>;
+    };
+    connectors: ConnectorChoice[];
+    enabled: boolean;
+    created_at: string;
+    modified_at: string;
+}
+export interface ConnectorChoice {
+    connector: string;
+    merchant_connector_id?: string;
+    priority?: number;
+    weight?: number;
+    maxConcurrency?: number;
+    maxResourceSize?: number;
+    supportedRegions?: string[];
+    supportedCountries?: string[];
+}
+export type RoutingAlgorithm = 'priority' | 'volume_split' | 'advanced' | 'cost_optimization' | 'performance' | 'load_balancing' | 'region_based';
+export interface RoutingConfig {
+    profile_id: string;
+    name: string;
+    description?: string;
+    algorithm: {
+        type: RoutingAlgorithm;
+        data: RoutingRule[];
+    };
+    fallback_routing?: {
+        enabled: boolean;
+        connectors: string[];
+    };
+    circuit_breaker?: {
+        failure_threshold: number;
+        recovery_time_seconds: number;
+        max_retries: number;
+    };
+    created_at: string;
+    modified_at: string;
+    version: number;
+}
+export interface ConnectorMetrics {
+    connector_name: string;
+    success_rate: number;
+    total_requests: number;
+    successful_requests: number;
+    failed_requests: number;
+    total_volume?: number;
+    successful_payments?: number;
+    failed_payments?: number;
+    total_amount_processed?: number;
+    avg_ticket_size?: number;
+    avg_response_time_ms: number;
+    p95_response_time_ms: number;
+    total_resources_processed: number;
+    avg_resource_size: number;
+    window_start: string;
+    window_end: string;
+    circuit_breaker_status: 'closed' | 'open' | 'half_open';
+    consecutive_failures: number;
+    last_failure_time?: string;
+}
+export interface RoutingDecision {
+    selected_connector: string;
+    merchant_connector_id?: string;
+    algorithm_used: RoutingAlgorithm;
+    rule_applied?: string;
+    fallback_used: boolean;
+    decision_timestamp: string;
+    routing_profile_id: string;
+    alternative_connectors: string[];
+}
+export interface RoutingEngine {
+    route(context: RoutingContext, config: RoutingConfig): Promise<RoutingDecision>;
+    updateMetrics(connectorId: string, success: boolean, responseTime: number, resourceSize?: number): Promise<void>;
+    getConnectorHealth(connectorId: string): Promise<ConnectorMetrics>;
+    validateConfig(config: RoutingConfig): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+}
+//# sourceMappingURL=routing-config.d.ts.map