@nehorai/payments-il 0.1.0

package/dist/routing/index.js

@@ -0,0 +1,113 @@
+// src/routing/routing-rules.ts
+var ISRAELI_BIN_RANGES = [
+  // Isracard
+  { start: "458000", end: "458999", issuer: "Isracard", country: "IL" },
+  { start: "480000", end: "480999", issuer: "Isracard", country: "IL" },
+  // Cal (Visa Cal)
+  { start: "532600", end: "532699", issuer: "Cal", country: "IL" },
+  { start: "557050", end: "557059", issuer: "Cal", country: "IL" },
+  // Leumi Card
+  { start: "589200", end: "589299", issuer: "Leumi Card", country: "IL" },
+  // Diners Israel
+  { start: "363700", end: "363799", issuer: "Diners Israel", country: "IL" },
+  // Max (Leumi)
+  { start: "491861", end: "491861", issuer: "Max", country: "IL" },
+  { start: "458600", end: "458699", issuer: "Max", country: "IL" }
+];
+var ISRAELI_CARD_BIN_RULES = [
+  {
+    ranges: ISRAELI_BIN_RANGES.map((r) => ({
+      start: r.start,
+      end: r.end,
+      issuer: r.issuer,
+      country: r.country
+    })),
+    preferredProvider: "hyp",
+    priority: 1
+  }
+];
+var ISRAELI_PROVIDER_PRIORITIES = [
+  {
+    provider: "hyp",
+    priority: 1,
+    maxFeePercent: 1.8,
+    supportsCurrency: ["ILS", "USD", "EUR"],
+    supportsRecurring: true,
+    isLocalGateway: true
+  },
+  {
+    provider: "cardcom",
+    priority: 2,
+    maxFeePercent: 2,
+    supportsCurrency: ["ILS", "USD", "EUR"],
+    supportsRecurring: true,
+    isLocalGateway: true
+  },
+  {
+    provider: "stripe",
+    priority: 3,
+    maxFeePercent: 2.9,
+    supportsCurrency: ["USD", "EUR", "GBP", "ILS", "CAD", "AUD"],
+    supportsRecurring: true,
+    isLocalGateway: false
+  }
+];
+var ISRAELI_ROUTING_RULES = {
+  cardBinRules: ISRAELI_CARD_BIN_RULES,
+  providerPriorities: ISRAELI_PROVIDER_PRIORITIES
+};
+function isIsraeliCard(bin) {
+  if (!bin || bin.length < 6) return false;
+  const binPrefix = bin.substring(0, 6);
+  return ISRAELI_BIN_RANGES.some(
+    (range) => binPrefix >= range.start && binPrefix <= range.end
+  );
+}
+function getCardIssuer(bin) {
+  if (!bin || bin.length < 6) return null;
+  const binPrefix = bin.substring(0, 6);
+  const range = ISRAELI_BIN_RANGES.find(
+    (r) => binPrefix >= r.start && binPrefix <= r.end
+  );
+  return range?.issuer ?? null;
+}
+function getOptimalProvider(isIsraeli, currency, requiresRecurring, availableProviders) {
+  const candidates = ISRAELI_PROVIDER_PRIORITIES.filter(
+    (p) => availableProviders.includes(p.provider)
+  );
+  if (candidates.length === 0) return null;
+  const suitable = candidates.filter((p) => {
+    if (!p.supportsCurrency.includes(currency)) return false;
+    if (requiresRecurring && !p.supportsRecurring) return false;
+    return true;
+  });
+  if (suitable.length === 0) {
+    return candidates[0]?.provider ?? null;
+  }
+  if (isIsraeli) {
+    const localProviders = suitable.filter((p) => p.isLocalGateway);
+    if (localProviders.length > 0) {
+      return localProviders.sort((a, b) => a.priority - b.priority)[0].provider;
+    }
+  }
+  return suitable.sort((a, b) => a.priority - b.priority)[0].provider;
+}
+function getFallbackProviders(primaryProvider, availableProviders) {
+  return ISRAELI_PROVIDER_PRIORITIES.filter(
+    (p) => p.provider !== primaryProvider && availableProviders.includes(p.provider)
+  ).sort((a, b) => a.priority - b.priority).map((p) => p.provider);
+}
+function getProviderFeePercent(provider) {
+  const config = ISRAELI_PROVIDER_PRIORITIES.find((p) => p.provider === provider);
+  return config?.maxFeePercent ?? 3;
+}
+export {
+  ISRAELI_BIN_RANGES,
+  ISRAELI_ROUTING_RULES,
+  getCardIssuer,
+  getFallbackProviders,
+  getOptimalProvider,
+  getProviderFeePercent,
+  isIsraeliCard
+};
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routing/routing-rules.ts"],"sourcesContent":["/**\r\n * Israeli Routing Rules Configuration\r\n *\r\n * Defines BIN (Bank Identification Number) ranges for smart routing\r\n * and provider selection rules.\r\n *\r\n * Exports ISRAELI_ROUTING_RULES as RoutingRules type from @nehorai/payments,\r\n * so it can be passed directly to createPaymentServices({ routingRules }).\r\n *\r\n * Israeli cards are routed to local gateways (Hyp/Cardcom) for:\r\n * - Better transaction fees (1.8% vs 2.9%)\r\n * - Higher approval rates for Israeli customers\r\n * - ILS currency support\r\n */\r\n\r\nimport type { PaymentProvider } from '@nehorai/payments/types';\r\nimport type {\r\n  RoutingRules,\r\n  CardBinRule,\r\n  ProviderPriorityRule,\r\n} from '@nehorai/payments/services';\r\n\r\n// ============================================================================\r\n// Israeli BIN Ranges\r\n// ============================================================================\r\n\r\n/**\r\n * BIN range definition (local type for documentation purposes)\r\n */\r\nexport interface BINRange {\r\n  /** Starting BIN (6 digits) */\r\n  start: string;\r\n  /** Ending BIN (6 digits) */\r\n  end: string;\r\n  /** Card issuer name */\r\n  issuer: string;\r\n  /** Country code */\r\n  country: string;\r\n}\r\n\r\n/**\r\n * Israeli credit card BIN ranges\r\n * These cards should be routed to local gateways for better rates\r\n *\r\n * Note: This is not exhaustive. In production, consider using a BIN database\r\n * service for comprehensive coverage.\r\n */\r\nexport const ISRAELI_BIN_RANGES: readonly BINRange[] = [\r\n  // Isracard\r\n  { start: '458000', end: '458999', issuer: 'Isracard', country: 'IL' },\r\n  { start: '480000', end: '480999', issuer: 'Isracard', country: 'IL' },\r\n\r\n  // Cal (Visa Cal)\r\n  { start: '532600', end: '532699', issuer: 'Cal', country: 'IL' },\r\n  { start: '557050', end: '557059', issuer: 'Cal', country: 'IL' },\r\n\r\n  // Leumi Card\r\n  { start: '589200', end: '589299', issuer: 'Leumi Card', country: 'IL' },\r\n\r\n  // Diners Israel\r\n  { start: '363700', end: '363799', issuer: 'Diners Israel', country: 'IL' },\r\n\r\n  // Max (Leumi)\r\n  { start: '491861', end: '491861', issuer: 'Max', country: 'IL' },\r\n  { start: '458600', end: '458699', issuer: 'Max', country: 'IL' },\r\n] as const;\r\n\r\n// ============================================================================\r\n// Card BIN Rules (RoutingRules-compatible)\r\n// ============================================================================\r\n\r\n/**\r\n * Israeli card BIN rules in CardBinRule format for the core routing engine.\r\n * All Israeli BIN ranges prefer 'hyp' as the primary local gateway.\r\n */\r\nconst ISRAELI_CARD_BIN_RULES: CardBinRule[] = [\r\n  {\r\n    ranges: ISRAELI_BIN_RANGES.map((r) => ({\r\n      start: r.start,\r\n      end: r.end,\r\n      issuer: r.issuer,\r\n      country: r.country,\r\n    })),\r\n    preferredProvider: 'hyp',\r\n    priority: 1,\r\n  },\r\n];\r\n\r\n// ============================================================================\r\n// Provider Priority Rules (RoutingRules-compatible)\r\n// ============================================================================\r\n\r\n/**\r\n * Israeli provider priorities in ProviderPriorityRule format.\r\n * Local gateways (Hyp, Cardcom) are prioritized over international providers.\r\n */\r\nconst ISRAELI_PROVIDER_PRIORITIES: ProviderPriorityRule[] = [\r\n  {\r\n    provider: 'hyp',\r\n    priority: 1,\r\n    maxFeePercent: 1.8,\r\n    supportsCurrency: ['ILS', 'USD', 'EUR'],\r\n    supportsRecurring: true,\r\n    isLocalGateway: true,\r\n  },\r\n  {\r\n    provider: 'cardcom',\r\n    priority: 2,\r\n    maxFeePercent: 2.0,\r\n    supportsCurrency: ['ILS', 'USD', 'EUR'],\r\n    supportsRecurring: true,\r\n    isLocalGateway: true,\r\n  },\r\n  {\r\n    provider: 'stripe',\r\n    priority: 3,\r\n    maxFeePercent: 2.9,\r\n    supportsCurrency: ['USD', 'EUR', 'GBP', 'ILS', 'CAD', 'AUD'],\r\n    supportsRecurring: true,\r\n    isLocalGateway: false,\r\n  },\r\n];\r\n\r\n// ============================================================================\r\n// Exported RoutingRules (core-compatible)\r\n// ============================================================================\r\n\r\n/**\r\n * Israeli routing rules, compatible with the core RoutingRules type.\r\n * Pass directly to createPaymentServices({ routingRules: ISRAELI_ROUTING_RULES }).\r\n */\r\nexport const ISRAELI_ROUTING_RULES: RoutingRules = {\r\n  cardBinRules: ISRAELI_CARD_BIN_RULES,\r\n  providerPriorities: ISRAELI_PROVIDER_PRIORITIES,\r\n};\r\n\r\n// ============================================================================\r\n// Routing Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Check if a BIN belongs to an Israeli card\r\n */\r\nexport function isIsraeliCard(bin: string): boolean {\r\n  if (!bin || bin.length < 6) return false;\r\n\r\n  const binPrefix = bin.substring(0, 6);\r\n\r\n  return ISRAELI_BIN_RANGES.some(\r\n    (range) => binPrefix >= range.start && binPrefix <= range.end\r\n  );\r\n}\r\n\r\n/**\r\n * Get card issuer from BIN\r\n */\r\nexport function getCardIssuer(bin: string): string | null {\r\n  if (!bin || bin.length < 6) return null;\r\n\r\n  const binPrefix = bin.substring(0, 6);\r\n\r\n  const range = ISRAELI_BIN_RANGES.find(\r\n    (r) => binPrefix >= r.start && binPrefix <= r.end\r\n  );\r\n\r\n  return range?.issuer ?? null;\r\n}\r\n\r\n/**\r\n * Get optimal provider for a given context\r\n */\r\nexport function getOptimalProvider(\r\n  isIsraeli: boolean,\r\n  currency: string,\r\n  requiresRecurring: boolean,\r\n  availableProviders: PaymentProvider[]\r\n): PaymentProvider | null {\r\n  const candidates = ISRAELI_PROVIDER_PRIORITIES.filter((p) =>\r\n    availableProviders.includes(p.provider)\r\n  );\r\n\r\n  if (candidates.length === 0) return null;\r\n\r\n  const suitable = candidates.filter((p) => {\r\n    if (!p.supportsCurrency.includes(currency)) return false;\r\n    if (requiresRecurring && !p.supportsRecurring) return false;\r\n    return true;\r\n  });\r\n\r\n  if (suitable.length === 0) {\r\n    return candidates[0]?.provider ?? null;\r\n  }\r\n\r\n  if (isIsraeli) {\r\n    const localProviders = suitable.filter((p) => p.isLocalGateway);\r\n    if (localProviders.length > 0) {\r\n      return localProviders.sort((a, b) => a.priority - b.priority)[0].provider;\r\n    }\r\n  }\r\n\r\n  return suitable.sort((a, b) => a.priority - b.priority)[0].provider;\r\n}\r\n\r\n/**\r\n * Get fallback providers in order of priority\r\n */\r\nexport function getFallbackProviders(\r\n  primaryProvider: PaymentProvider,\r\n  availableProviders: PaymentProvider[]\r\n): PaymentProvider[] {\r\n  return ISRAELI_PROVIDER_PRIORITIES\r\n    .filter((p) =>\r\n      p.provider !== primaryProvider &&\r\n      availableProviders.includes(p.provider)\r\n    )\r\n    .sort((a, b) => a.priority - b.priority)\r\n    .map((p) => p.provider);\r\n}\r\n\r\n/**\r\n * Get estimated fee for a provider\r\n */\r\nexport function getProviderFeePercent(provider: PaymentProvider): number {\r\n  const config = ISRAELI_PROVIDER_PRIORITIES.find((p) => p.provider === provider);\r\n  return config?.maxFeePercent ?? 3.0;\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@nehorai/payments-il",
+  "version": "0.1.0",
+  "description": "Israeli payment providers (Hyp, Cardcom) for @nehorai/payments",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./hyp": {
+      "types": "./dist/hyp/index.d.ts",
+      "import": "./dist/hyp/index.js",
+      "require": "./dist/hyp/index.cjs"
+    },
+    "./cardcom": {
+      "types": "./dist/cardcom/index.d.ts",
+      "import": "./dist/cardcom/index.js",
+      "require": "./dist/cardcom/index.cjs"
+    },
+    "./routing": {
+      "types": "./dist/routing/index.d.ts",
+      "import": "./dist/routing/index.js",
+      "require": "./dist/routing/index.cjs"
+    },
+    "./factory": {
+      "types": "./dist/factory.d.ts",
+      "import": "./dist/factory.js",
+      "require": "./dist/factory.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@nehorai/payments": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "tsup": "^8.0.0",
+    "@types/node": "^22.13.4"
+  },
+  "license": "MIT",
+  "author": "Nehorai Hadad",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}