@etohq/connector-engine 1.5.1-alpha.4

package/hyperswitch-example.ts

@@ -0,0 +1,263 @@
+// /**
+//  * Hyperswitch-Style Routing Integration Example
+//  */
+
+// import { ConnectorEngine, ConnectorPlugin, AbstractConnectorPlugin, RoutingConfig } from "./src";
+
+// // ===== PAYMENT PLUGINS =====
+// class StripePlugin extends AbstractConnectorPlugin<{
+//   createPayment: {
+//     input: { amount: number; currency: string; payment_method: string };
+//     output: { payment_id: string; status: 'succeeded' | 'pending' };
+//   };
+// }> {
+//   getName() { return 'stripe'; }
+//   getVersion() { return '1.0.0'; }
+  
+//   operations = {
+//     createPayment: async (input, config) => {
+//       console.log(`Stripe payment: $${input.amount/100} ${input.currency} via ${config.region}`);
+//       return { payment_id: `pi_${Date.now()}`, status: 'succeeded' as const };
+//     }
+//   };
+// }
+
+// class PayPalPlugin extends AbstractConnectorPlugin<{
+//   createPayment: {
+//     input: { amount: number; currency: string; payment_method: string };
+//     output: { payment_id: string; status: 'succeeded' | 'pending' };
+//   };
+// }> {
+//   getName() { return 'paypal'; }
+//   getVersion() { return '1.0.0'; }
+  
+//   operations = {
+//     createPayment: async (input, config) => {
+//       console.log(`PayPal payment: $${input.amount/100} ${input.currency} via ${config.region}`);
+//       return { payment_id: `pp_${Date.now()}`, status: 'succeeded' as const };
+//     }
+//   };
+// }
+
+// // ===== ENGINE WITH HYPERSWITCH ROUTING =====
+// const engine = ConnectorEngine({
+//   'stripe-us': new StripePlugin(),
+//   'stripe-eu': new StripePlugin(),
+//   'paypal-us': new PayPalPlugin(),
+//   'paypal-eu': new PayPalPlugin()
+// }, {
+//   payments: {
+//     connectors: ['stripe-us', 'stripe-eu', 'paypal-us', 'paypal-eu'],
+//     operations: ['createPayment'],
+//     options: { behavior: 'execute_all' } // Will be overridden by routing config
+//   }
+// }, {
+//   // Connector configs from DB
+//   configLoader: async (connectorId: string) => {
+//     const configs = {
+//       'stripe-us': { region: 'US', secretKey: 'sk_us_xxx' },
+//       'stripe-eu': { region: 'EU', secretKey: 'sk_eu_yyy' },
+//       'paypal-us': { region: 'US', clientId: 'pp_us_xxx' },
+//       'paypal-eu': { region: 'EU', clientId: 'pp_eu_yyy' }
+//     };
+//     return configs[connectorId as keyof typeof configs];
+//   },
+  
+//   // Hyperswitch-style routing config from DB
+//   routingConfigLoader: async (groupId: string) => {
+//     const routingConfigs: Record<string, RoutingConfig> = {
+//       payments: {
+//         profile_id: 'payment_profile_1',
+//         name: 'Smart Payment Routing',
+//         algorithm: {
+//           type: 'advanced',
+//           data: [
+//             {
+//               name: 'EU_Payments',
+//               description: 'Route EU payments to EU connectors',
+//               conditions: {
+//                 currency: ['EUR', 'GBP'],
+//                 country: ['DE', 'FR', 'GB', 'IT', 'ES']
+//               },
+//               connectors: [
+//                 { connector: 'stripe-eu', priority: 100, weight: 70 },
+//                 { connector: 'paypal-eu', priority: 90, weight: 30 }
+//               ],
+//               enabled: true,
+//               created_at: '2024-01-01T00:00:00Z',
+//               modified_at: '2024-01-01T00:00:00Z'
+//             },
+//             {
+//               name: 'US_High_Value',
+//               description: 'High value US payments via Stripe',
+//               conditions: {
+//                 currency: ['USD'],
+//                 country: ['US'],
+//                 amount: { min: 10000 } // $100+
+//               },
+//               connectors: [
+//                 { connector: 'stripe-us', priority: 100 }
+//               ],
+//               enabled: true,
+//               created_at: '2024-01-01T00:00:00Z',
+//               modified_at: '2024-01-01T00:00:00Z'
+//             },
+//             {
+//               name: 'US_Default',
+//               description: 'Default US payment routing',
+//               conditions: {
+//                 currency: ['USD'],
+//                 country: ['US']
+//               },
+//               connectors: [
+//                 { connector: 'stripe-us', priority: 100, weight: 60 },
+//                 { connector: 'paypal-us', priority: 90, weight: 40 }
+//               ],
+//               enabled: true,
+//               created_at: '2024-01-01T00:00:00Z',
+//               modified_at: '2024-01-01T00:00:00Z'
+//             }
+//           ]
+//         },
+//         fallback_routing: {
+//           enabled: true,
+//           connectors: ['paypal-us', 'paypal-eu']
+//         },
+//         circuit_breaker: {
+//           failure_threshold: 5,
+//           recovery_time_seconds: 300,
+//           max_retries: 3
+//         },
+//         created_at: '2024-01-01T00:00:00Z',
+//         modified_at: '2024-01-01T00:00:00Z',
+//         version: 1
+//       }
+//     };
+    
+//     return routingConfigs[groupId];
+//   }
+// });
+
+// // ===== USAGE EXAMPLES =====
+
+// async function demonstrateHyperswitchRouting() {
+//   console.log('=== Hyperswitch-Style Routing Demo ===\n');
+
+//   // 1. EU Payment - Should route to stripe-eu
+//   console.log('1. EU Payment (EUR 50):');
+//   const euPayment = engine.executePaymentsCreatePayment(
+//     {
+//       amount: 5000,
+//       currency: 'EUR',
+//       payment_method: 'card'
+//     },
+//     {
+//       // Payment context for routing decisions
+//       currency: 'EUR',
+//       country: 'DE',
+//       amount: 5000,
+//       payment_method: 'card'
+//     } as PaymentContext
+//   );
+  
+//   const euResult = await euPayment.run({
+//     input: { amount: 5000, currency: 'EUR', payment_method: 'card' }
+//   });
+//   console.log('EU Result:', euResult);
+
+//   // 2. US High Value - Should route to stripe-us
+//   console.log('\n2. US High Value Payment (USD 150):');
+//   const highValuePayment = engine.executePaymentsCreatePayment(
+//     {
+//       amount: 15000,
+//       currency: 'USD', 
+//       payment_method: 'card'
+//     },
+//     {
+//       currency: 'USD',
+//       country: 'US',
+//       amount: 15000,
+//       payment_method: 'card'
+//     } as PaymentContext
+//   );
+  
+//   const highValueResult = await highValuePayment.run({
+//     input: { amount: 15000, currency: 'USD', payment_method: 'card' }
+//   });
+//   console.log('High Value Result:', highValueResult);
+
+//   // 3. US Default - Should use weighted routing between stripe-us and paypal-us
+//   console.log('\n3. US Default Payment (USD 25):');
+//   const defaultPayment = engine.executePaymentsCreatePayment(
+//     {
+//       amount: 2500,
+//       currency: 'USD',
+//       payment_method: 'card'
+//     },
+//     {
+//       currency: 'USD',
+//       country: 'US', 
+//       amount: 2500,
+//       payment_method: 'card'
+//     } as PaymentContext
+//   );
+  
+//   const defaultResult = await defaultPayment.run({
+//     input: { amount: 2500, currency: 'USD', payment_method: 'card' }
+//   });
+//   console.log('Default Result:', defaultResult);
+
+//   console.log('\n=== Routing Demo Complete ===');
+// }
+
+// // ===== BUSINESS LOGIC INTEGRATION =====
+
+// class PaymentService {
+//   constructor(private engine: typeof engine) {}
+
+//   async processPayment(paymentRequest: {
+//     amount: number;
+//     currency: string;
+//     customerId: string;
+//     country: string;
+//     paymentMethod: string;
+//   }) {
+//     // Create payment context for smart routing
+//     const context: PaymentContext = {
+//       amount: paymentRequest.amount,
+//       currency: paymentRequest.currency,
+//       country: paymentRequest.country,
+//       payment_method: paymentRequest.paymentMethod,
+//       customer_id: paymentRequest.customerId,
+//       metadata: {
+//         service: 'payment-service',
+//         timestamp: new Date().toISOString()
+//       }
+//     };
+
+//     // Engine automatically routes based on Hyperswitch rules
+//     const paymentWorkflow = this.engine.executePaymentsCreatePayment(
+//       {
+//         amount: paymentRequest.amount,
+//         currency: paymentRequest.currency,
+//         payment_method: paymentRequest.paymentMethod
+//       },
+//       context
+//     );
+
+//     return await paymentWorkflow.run({
+//       input: {
+//         amount: paymentRequest.amount,
+//         currency: paymentRequest.currency,
+//         payment_method: paymentRequest.paymentMethod
+//       }
+//     });
+//   }
+// }
+
+// // Run demo
+// if (require.main === module) {
+//   demonstrateHyperswitchRouting().catch(console.error);
+// }
+
+// export { engine, PaymentService };

package/jest.config.js

@@ -0,0 +1,2 @@
+const defineJestConfig = require("../../../define_jest_config")
+module.exports = defineJestConfig()

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@etohq/connector-engine",
+  "version": "1.5.1-alpha.4",
+  "description": "ETO Framework Core Connector Engine - Universal plugin system for external integrations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "bignumber.js": "9.1.2"
+  },
+  "devDependencies": {
+    "@mikro-orm/core": "6.4.3",
+    "@types/jest": "29.5.14",
+    "@types/node": "22.10.5",
+    "awilix": "8.0.1",
+    "expect-type": "0.20.0",
+    "rimraf": "5.0.2",
+    "typescript": "5.8.3",
+    "tsc-alias": "1.8.6",
+    "vite": "5.2.11",
+    "@etohq/framework": "1.5.1-alpha.4"
+  },
+  "peerDependencies": {
+    "awilix": "8.0.1",
+    "vite": "5.2.11",
+    "@etohq/framework": "1.5.1-alpha.4"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    },
+    "./engine": {
+      "types": "./dist/engine/index.d.ts",
+      "default": "./dist/engine/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}