@etohq/connector-engine 1.5.1-alpha.4

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

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

package/dist/types/routing-config.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * @fileoverview Generic Routing Configuration (Not Payment-Specific)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=routing-config.js.map

package/dist/types/routing-config.js.map

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

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

@@ -0,0 +1,31 @@
+import type { OperationGroupsConfig } from "../types/operation-groups";
+import type { BaseConnectorPlugin } from "../types/base-plugin";
+/**
+ * Helper function to create connector engine instances
+ * Wraps the ETO ConnectorEngine factory function for easier usage
+ */
+export interface PluginConfiguration {
+    [domainName: string]: BaseConnectorPlugin;
+}
+/**
+ * Create a connector engine with plugins and operation groups
+ *
+ * @param plugins - Configuration object mapping domain names to plugin instances
+ * @param operationGroups - Optional operation groups configuration
+ * @returns Configured connector engine instance
+ *
+ * @example
+ * ```typescript
+ * const engine = createConnectorEngine({
+ *   meeting: new MeetingPlugin(),
+ *   google: new GoogleCalendarPlugin()
+ * }, {
+ *   resource: {
+ *     domains: ['meeting'],
+ *     operations: ['checkAvailability', 'reserveResource']
+ *   }
+ * });
+ * ```
+ */
+export declare function createConnectorEngine(plugins: PluginConfiguration, operationGroups?: OperationGroupsConfig): void;
+//# sourceMappingURL=create-connector-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-connector-engine.d.ts","sourceRoot":"","sources":["../../src/utils/create-connector-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAC5B,eAAe,CAAC,EAAE,qBAAqB,QAMxC"}

package/dist/utils/create-connector-engine.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnectorEngine = createConnectorEngine;
+const connector_engine_1 = require("../engine/connector-engine");
+/**
+ * Create a connector engine with plugins and operation groups
+ *
+ * @param plugins - Configuration object mapping domain names to plugin instances
+ * @param operationGroups - Optional operation groups configuration
+ * @returns Configured connector engine instance
+ *
+ * @example
+ * ```typescript
+ * const engine = createConnectorEngine({
+ *   meeting: new MeetingPlugin(),
+ *   google: new GoogleCalendarPlugin()
+ * }, {
+ *   resource: {
+ *     domains: ['meeting'],
+ *     operations: ['checkAvailability', 'reserveResource']
+ *   }
+ * });
+ * ```
+ */
+function createConnectorEngine(plugins, operationGroups) {
+    // ConnectorEngine is a factory function, not a class constructor
+    const engine = (0, connector_engine_1.ConnectorEngine)(plugins, operationGroups);
+    return engine;
+}
+//# sourceMappingURL=create-connector-engine.js.map

package/dist/utils/create-connector-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-connector-engine.js","sourceRoot":"","sources":["../../src/utils/create-connector-engine.ts"],"names":[],"mappings":";;AAiCA,sDAQC;AAzCD,iEAA6D;AAa7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,qBAAqB,CACnC,OAA4B,EAC5B,eAAuC;IAEvC,iEAAiE;IACjE,MAAM,MAAM,GAAG,IAAA,kCAAe,EAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAEzD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/examples/booking-example.ts

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview Booking Example Configuration
+ * @description Example showing simplified connector types with optional domain
+ */
+
+import { ConnectorEngine } from "../src";
+
+// ===== OPERATION TYPE DEFINITIONS =====
+
+interface MeetingsAvailabilityOperation {
+  resourceType: string;
+  timeSlot: { start: Date; end: Date };
+  eventTypeId: string;
+  requirements?: { capacity?: number; location?: string };
+}
+
+interface MeetingsReservationOperation {
+  resourceType: string;
+  bookingData: {
+    title: string;
+    start_time: Date;
+    end_time: Date;
+    attendees: Array<{ email: string; name: string }>;
+    eventTypeId: string;
+    location?: string;
+  };
+}
+
+interface LogisticsAvailabilityOperation {
+  resourceType: string;
+  timeSlot: { start: Date; end: Date };
+  vehicleType: string;
+  route?: { pickup: string; delivery: string };
+  requirements?: { capacity?: number; specialEquipment?: string[] };
+}
+
+interface LogisticsReservationOperation {
+  resourceType: string;
+  deliveryData: {
+    vehicleId: string;
+    pickup: { address: string; timeWindow: { start: Date; end: Date } };
+    delivery: { address: string; timeWindow: { start: Date; end: Date } };
+    cargo: { weight: number; dimensions: { length: number; width: number; height: number } };
+    specialInstructions?: string;
+  };
+}
+
+// ===== SIMPLIFIED CONNECTOR TYPES CONFIGURATION =====
+
+const bookingConnectorTypes = {
+  // Meetings domain
+  meetings: {
+    checkAvailability: {} as MeetingsAvailabilityOperation,
+    reserveResource: {} as MeetingsReservationOperation
+  },
+
+  // Logistics domain
+  logistics: {
+    checkAvailability: {} as LogisticsAvailabilityOperation,
+    reserveResource: {} as LogisticsReservationOperation
+  }
+} as const;
+
+// ===== OPERATION GROUPS CONFIGURATION =====
+
+const bookingOperationGroups = {
+  // Universal resource operations - domain optional, defaults to first domain
+  resource: {
+    domains: ['meetings', 'logistics'],
+    operations: ['checkAvailability', 'reserveResource'],
+    options: {
+      behavior: 'route_by_domain' as const,
+      priority: 1,
+      timeout: 30000,
+      retries: 2
+    }
+  },
+
+  // Internal operations - execute all domains
+  internal: {
+    domains: ['meetings', 'logistics'],
+    operations: ['checkAvailability'],
+    options: {
+      behavior: 'execute_all' as const,
+      connectorId: 'internal-system',
+      priority: 2,
+      timeout: 15000,
+      retries: 1
+    }
+  },
+
+  // External operations - first success
+  external: {
+    domains: ['meetings'],
+    operations: ['reserveResource'],
+    options: {
+      behavior: 'first_success' as const,
+      priority: 3,
+      timeout: 45000,
+      retries: 3
+    }
+  }
+} as const;
+
+// ===== CREATE CONNECTOR ENGINE =====
+
+export const bookingConnectorEngine = ConnectorEngine(
+  bookingConnectorTypes,
+  bookingOperationGroups
+);
+
+// ===== UPDATED USAGE EXAMPLES =====
+
+export async function exampleUsage() {
+  
+  // ✅ Resource operations - domain optional
+  const meetingAvailability = await bookingConnectorEngine.executeResourceCheckAvailability({
+    // ✅ No domain - uses group default (first domain: 'meetings')
+    resourceType: 'conference_room',
+    timeSlot: { start: new Date(), end: new Date() },
+    eventTypeId: 'team-meeting',
+    requirements: { capacity: 10 }
+  });
+
+  // ✅ Resource operations - domain override
+  const logisticsAvailability = await bookingConnectorEngine.executeResourceCheckAvailability({
+    domain: 'logistics', // ✅ Override to logistics domain
+    resourceType: 'delivery_vehicle',
+    timeSlot: { start: new Date(), end: new Date() },
+    vehicleType: 'truck',
+    requirements: { capacity: 1000 }
+  });
+
+  // ✅ Internal operations - execute all domains
+  const internalAvailability = await bookingConnectorEngine.executeInternalCheckAvailability({
+    // ✅ No domain - executes all configured domains
+    resourceType: 'any',
+    timeSlot: { start: new Date(), end: new Date() },
+    eventTypeId: 'internal-check', // Required by meetings
+    vehicleType: 'any' // Required by logistics
+  });
+
+  // ✅ External operations - first success
+  const externalReservation = await bookingConnectorEngine.executeExternalReserveResource({
+    // ✅ No domain - uses first success behavior on meetings domain
+    resourceType: 'conference_room',
+    bookingData: {
+      title: 'Important Meeting',
+      start_time: new Date(),
+      end_time: new Date(),
+      attendees: [{ email: 'user@example.com', name: 'User' }],
+      eventTypeId: 'external-meeting'
+    }
+  });
+
+  return {
+    meetingAvailability,
+    logisticsAvailability,
+    internalAvailability,
+    externalReservation
+  };
+}
+
+// ===== EXPORT TYPES FOR EXTERNAL USE =====
+
+export type BookingConnectorEngine = typeof bookingConnectorEngine;
+export type BookingConnectorTypes = typeof bookingConnectorTypes;
+export type BookingOperationGroups = typeof bookingOperationGroups;

package/examples/booking-test.ts

@@ -0,0 +1,231 @@
+/**
+ * @fileoverview Booking Operation Groups Test
+ * @description Test file for simplified connector types with optional domain
+ */
+
+import { bookingConnectorEngine, exampleUsage } from './booking-example';
+
+// ===== TYPE SAFETY TESTS =====
+
+// ✅ Test 1: Resource operations with optional domain
+async function testResourceOperations() {
+  console.log('🧪 Testing Resource Operations...');
+
+  try {
+    // Default domain routing (no domain specified)
+    const defaultResult = await bookingConnectorEngine.executeResourceCheckAvailability({
+      // ✅ No domain - uses group default ('meetings')
+      resourceType: 'conference_room',
+      timeSlot: { start: new Date('2024-01-15T10:00:00Z'), end: new Date('2024-01-15T11:00:00Z') },
+      eventTypeId: 'team-meeting'
+    });
+    console.log('✅ Default domain routing (meetings):', defaultResult);
+
+    // Explicit domain override
+    const logisticsResult = await bookingConnectorEngine.executeResourceCheckAvailability({
+      domain: 'logistics', // ✅ Optional override
+      resourceType: 'delivery_truck',
+      timeSlot: { start: new Date('2024-01-15T09:00:00Z'), end: new Date('2024-01-15T17:00:00Z') },
+      vehicleType: 'medium_truck',
+      route: { pickup: '123 Warehouse St', delivery: '456 Customer Ave' }
+    });
+    console.log('✅ Explicit domain override (logistics):', logisticsResult);
+
+  } catch (error) {
+    console.error('❌ Resource operations test failed:', error);
+  }
+}
+
+// ✅ Test 2: Internal operations (execute all domains)
+async function testInternalOperations() {
+  console.log('🧪 Testing Internal Operations...');
+
+  try {
+    const internalResult = await bookingConnectorEngine.executeInternalCheckAvailability({
+      // ✅ No domain - executes all configured domains
+      resourceType: 'any_resource',
+      timeSlot: { start: new Date('2024-01-15T14:00:00Z'), end: new Date('2024-01-15T15:00:00Z') },
+      eventTypeId: 'internal-check', // Required by meetings domain
+      vehicleType: 'any_vehicle' // Required by logistics domain
+    });
+    console.log('✅ Internal operations (all domains):', internalResult);
+
+  } catch (error) {
+    console.error('❌ Internal operations test failed:', error);
+  }
+}
+
+// ✅ Test 3: External operations (first success)
+async function testExternalOperations() {
+  console.log('🧪 Testing External Operations...');
+
+  try {
+    const externalResult = await bookingConnectorEngine.executeExternalReserveResource({
+      // ✅ No domain - uses first success on meetings domain
+      resourceType: 'meeting_room',
+      bookingData: {
+        title: 'Client Presentation',
+        start_time: new Date('2024-01-15T16:00:00Z'),
+        end_time: new Date('2024-01-15T17:00:00Z'),
+        attendees: [
+          { email: 'client@example.com', name: 'Client Representative' },
+          { email: 'sales@company.com', name: 'Sales Manager' }
+        ],
+        eventTypeId: 'client-meeting',
+        location: 'Conference Room A'
+      }
+    });
+    console.log('✅ External operations (first success):', externalResult);
+
+  } catch (error) {
+    console.error('❌ External operations test failed:', error);
+  }
+}
+
+// ✅ Test 4: Domain validation
+async function testDomainValidation() {
+  console.log('🧪 Testing Domain Validation...');
+
+  try {
+    // Valid domain override
+    const validResult = await bookingConnectorEngine.executeResourceCheckAvailability({
+      domain: 'meetings', // ✅ Valid domain for resource group
+      resourceType: 'conference_room',
+      timeSlot: { start: new Date(), end: new Date() },
+      eventTypeId: 'test-meeting'
+    });
+    console.log('✅ Valid domain override:', validResult);
+
+    // Invalid domain should throw error
+    try {
+      await bookingConnectorEngine.executeResourceCheckAvailability({
+        domain: 'invalid_domain' as any, // ❌ Invalid domain
+        resourceType: 'conference_room',
+        timeSlot: { start: new Date(), end: new Date() },
+        eventTypeId: 'test-meeting'
+      });
+      console.error('❌ Should have thrown error for invalid domain');
+    } catch (error) {
+      console.log('✅ Correctly rejected invalid domain:', error.message);
+    }
+
+  } catch (error) {
+    console.error('❌ Domain validation test failed:', error);
+  }
+}
+
+// ===== TYPE SAFETY VALIDATION =====
+
+function validateTypeSafety() {
+  console.log('🧪 Validating Type Safety...');
+
+  // These should cause TypeScript errors if uncommented:
+  
+  /*
+  // ❌ Invalid domain type
+  bookingConnectorEngine.executeResourceCheckAvailability({
+    domain: 'invalid_domain', // TypeScript error: not in 'meetings' | 'logistics'
+    resourceType: 'room',
+    timeSlot: { start: new Date(), end: new Date() },
+    eventTypeId: 'test'
+  });
+
+  // ❌ Missing required field for meetings domain
+  bookingConnectorEngine.executeResourceCheckAvailability({
+    resourceType: 'room',
+    timeSlot: { start: new Date(), end: new Date() }
+    // Missing eventTypeId - TypeScript error
+  });
+
+  // ❌ Wrong field for logistics domain
+  bookingConnectorEngine.executeResourceCheckAvailability({
+    domain: 'logistics',
+    resourceType: 'truck',
+    timeSlot: { start: new Date(), end: new Date() },
+    eventTypeId: 'test' // Wrong field - should be vehicleType
+  });
+  */
+
+  console.log('✅ Type safety validation passed (no TypeScript errors)');
+}
+
+// ===== PERFORMANCE TESTS =====
+
+async function testPerformance() {
+  console.log('🧪 Testing Performance...');
+
+  const startTime = Date.now();
+  
+  try {
+    // Execute multiple operations in parallel
+    const results = await Promise.all([
+      bookingConnectorEngine.executeResourceCheckAvailability({
+        resourceType: 'room_1',
+        timeSlot: { start: new Date(), end: new Date() },
+        eventTypeId: 'perf-test'
+      }),
+      bookingConnectorEngine.executeResourceCheckAvailability({
+        domain: 'logistics',
+        resourceType: 'truck_1',
+        timeSlot: { start: new Date(), end: new Date() },
+        vehicleType: 'small_truck'
+      }),
+      bookingConnectorEngine.executeInternalCheckAvailability({
+        resourceType: 'any',
+        timeSlot: { start: new Date(), end: new Date() },
+        eventTypeId: 'perf-test',
+        vehicleType: 'any'
+      })
+    ]);
+
+    const executionTime = Date.now() - startTime;
+    console.log(`✅ Performance test completed in ${executionTime}ms`);
+    console.log(`✅ Executed ${results.length} operations in parallel`);
+
+  } catch (error) {
+    console.error('❌ Performance test failed:', error);
+  }
+}
+
+// ===== RUN ALL TESTS =====
+
+export async function runAllTests() {
+  console.log('🚀 Starting Connector Engine Operation Groups Tests...\n');
+
+  // Validate type safety first
+  validateTypeSafety();
+  console.log('');
+
+  // Run functional tests
+  await testResourceOperations();
+  console.log('');
+  
+  await testInternalOperations();
+  console.log('');
+  
+  await testExternalOperations();
+  console.log('');
+  
+  await testDomainValidation();
+  console.log('');
+  
+  await testPerformance();
+  console.log('');
+
+  // Run example usage
+  console.log('🧪 Testing Example Usage...');
+  try {
+    const exampleResults = await exampleUsage();
+    console.log('✅ Example usage completed successfully');
+    console.log('Results summary:', Object.keys(exampleResults));
+  } catch (error) {
+    console.error('❌ Example usage failed:', error);
+  }
+
+  console.log('\n🎉 All tests completed!');
+}
+
+// Run tests if this file is executed directly
+if (require.main === module) {
+  runAllTests().catch(console.error);
+}