@nehorai/payments-il 0.1.0

package/dist/cardcom/index.js

@@ -0,0 +1,678 @@
+// src/providers/cardcom/cardcom-provider.ts
+import * as crypto from "crypto";
+import { calculateCaptureDeadline } from "@nehorai/payments/types";
+
+// src/providers/cardcom/cardcom-types.ts
+var CARDCOM_API_BASE = "https://secure.cardcom.solutions";
+var CARDCOM_ENDPOINTS = {
+  LOW_PROFILE_CREATE: "/api/v11/LowProfile/Create",
+  LOW_PROFILE_STATUS: "/Interface/BillGoldGetLowProfileIndicator.aspx",
+  DIRECT_CHARGE: "/api/v11/Transactions/Transaction",
+  REFUND: "/api/v11/Transactions/RefundByTransactionId"
+};
+var CARDCOM_SUPPORTED_CURRENCIES = ["ILS", "USD", "EUR", "GBP"];
+var CardcomOperation = /* @__PURE__ */ ((CardcomOperation2) => {
+  CardcomOperation2[CardcomOperation2["BILL_ONLY"] = 1] = "BILL_ONLY";
+  CardcomOperation2[CardcomOperation2["BILL_AND_CREATE_TOKEN"] = 2] = "BILL_AND_CREATE_TOKEN";
+  CardcomOperation2[CardcomOperation2["CREATE_TOKEN_ONLY"] = 3] = "CREATE_TOKEN_ONLY";
+  CardcomOperation2[CardcomOperation2["SUSPEND_DEAL_ONLY"] = 4] = "SUSPEND_DEAL_ONLY";
+  return CardcomOperation2;
+})(CardcomOperation || {});
+var CardcomTransactionType = /* @__PURE__ */ ((CardcomTransactionType2) => {
+  CardcomTransactionType2[CardcomTransactionType2["REGULAR"] = 1] = "REGULAR";
+  CardcomTransactionType2[CardcomTransactionType2["CREDIT"] = 2] = "CREDIT";
+  CardcomTransactionType2[CardcomTransactionType2["INSTALLMENTS"] = 3] = "INSTALLMENTS";
+  return CardcomTransactionType2;
+})(CardcomTransactionType || {});
+var CARDCOM_WEBHOOK_EVENTS = [
+  "payment.completed",
+  "payment.declined",
+  "payment.authorized"
+];
+var CARDCOM_DEAL_RESPONSE_ACTIONS = {
+  0: "pending",
+  1: "approved",
+  2: "declined",
+  3: "error"
+};
+var CARDCOM_RESPONSE_CODE_MAP = {
+  0: "created",
+  1: "failed",
+  2: "failed",
+  3: "failed",
+  4: "failed",
+  5: "failed",
+  6: "failed",
+  7: "failed",
+  8: "failed",
+  9: "failed",
+  10: "failed"
+};
+function mapCardcomDealResponseToStatus(dealResponse) {
+  switch (dealResponse) {
+    case 0:
+      return "pending_authorization";
+    case 1:
+      return "captured";
+    case 2:
+      return "failed";
+    case 3:
+      return "failed";
+    default:
+      return "failed";
+  }
+}
+function mapCardcomError(responseCode) {
+  const errorMessages = {
+    0: "Success",
+    1: "General error",
+    2: "Invalid API credentials",
+    3: "Invalid terminal number",
+    4: "Invalid operation type",
+    5: "Invalid card details",
+    6: "Card declined by issuer",
+    7: "Insufficient funds",
+    8: "Invalid amount",
+    9: "Transaction not found",
+    10: "Duplicate transaction",
+    11: "Terminal not active",
+    12: "CVV validation failed",
+    13: "Card expired",
+    14: "Invalid currency",
+    15: "Operation not supported"
+  };
+  return errorMessages[responseCode] ?? `Error code ${responseCode}`;
+}
+var CARDCOM_CURRENCY_CODES = {
+  ILS: 1,
+  USD: 2,
+  EUR: 3,
+  GBP: 4
+};
+function getCurrencyCode(currency) {
+  return CARDCOM_CURRENCY_CODES[currency.toUpperCase()] ?? 1;
+}
+var CARDCOM_LANGUAGE_CODES = {
+  en: "en",
+  he: "he"
+};
+
+// src/providers/cardcom/cardcom-provider.ts
+var CardcomProvider = class {
+  name = "cardcom";
+  supportedCurrencies = CARDCOM_SUPPORTED_CURRENCIES;
+  supportsRecurring = true;
+  supportsSplitPayments = false;
+  config;
+  constructor(config) {
+    if (!config.terminalNumber || !config.apiName || !config.apiPassword) {
+      throw new Error(
+        "CardcomProvider requires terminalNumber, apiName, and apiPassword in config"
+      );
+    }
+    this.config = config;
+  }
+  // ==========================================================================
+  // Payment Intent Operations
+  // ==========================================================================
+  async createPaymentIntent(params) {
+    try {
+      const amountMajor = params.amount.amountMinor / 100;
+      const operation = params.captureMethod === "manual" ? 4 /* SUSPEND_DEAL_ONLY */ : params.metadata?.savePaymentMethod ? 2 /* BILL_AND_CREATE_TOKEN */ : 1 /* BILL_ONLY */;
+      const request = {
+        TerminalNumber: this.config.terminalNumber,
+        ApiName: this.config.apiName,
+        ApiPassword: this.config.apiPassword,
+        Sum: amountMajor,
+        CoinID: getCurrencyCode(params.amount.currency),
+        Operation: operation,
+        Language: "en",
+        ReturnUrl: params.returnUrl,
+        ErrorUrl: params.returnUrl,
+        ProductName: params.description ?? "Payment",
+        InternalDealNumber: params.idempotencyKey,
+        SendEmail: false
+      };
+      if (params.metadata?.customerName) {
+        request.CustomerName = String(params.metadata.customerName);
+      }
+      if (params.metadata?.customerEmail) {
+        request.Email = String(params.metadata.customerEmail);
+      }
+      const response = await this.makeRequest(
+        CARDCOM_ENDPOINTS.LOW_PROFILE_CREATE,
+        request
+      );
+      if (response.ResponseCode !== 0 || !response.PaymentUrl) {
+        return {
+          success: false,
+          error: mapCardcomError(response.ResponseCode),
+          errorCode: String(response.ResponseCode)
+        };
+      }
+      return {
+        success: true,
+        providerIntentId: response.LowProfileCode,
+        redirectUrl: response.PaymentUrl,
+        status: "created"
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async authorize(params) {
+    try {
+      const statusResponse = await this.getLowProfileStatus(
+        params.providerIntentId
+      );
+      if (!statusResponse.success || !statusResponse.data) {
+        return {
+          success: false,
+          error: statusResponse.error ?? "Failed to check payment status"
+        };
+      }
+      const status = statusResponse.data;
+      if (status.DealResponse === 1) {
+        return {
+          success: true,
+          authorizationCode: status.InternalDealNumber ?? params.providerIntentId,
+          status: "authorized",
+          captureDeadline: calculateCaptureDeadline(/* @__PURE__ */ new Date())
+        };
+      }
+      if (status.DealResponse === 2) {
+        return {
+          success: false,
+          error: "Payment declined",
+          status: "failed"
+        };
+      }
+      return {
+        success: false,
+        error: "Payment not yet completed",
+        status: "pending_authorization"
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async capture(params) {
+    try {
+      const statusResponse = await this.getLowProfileStatus(
+        params.providerIntentId
+      );
+      if (!statusResponse.success || !statusResponse.data) {
+        return {
+          success: false,
+          error: statusResponse.error ?? "Failed to capture payment"
+        };
+      }
+      const status = statusResponse.data;
+      if (status.DealResponse === 1) {
+        return {
+          success: true,
+          providerTransactionId: status.InternalDealNumber ?? params.providerIntentId,
+          status: "captured",
+          capturedAmount: {
+            amountMinor: Math.round((status.Amount ?? 0) * 100),
+            currency: status.Currency ?? params.amount?.currency ?? "ILS"
+          }
+        };
+      }
+      return {
+        success: false,
+        error: "Payment not authorized for capture",
+        status: mapCardcomDealResponseToStatus(status.DealResponse ?? 3)
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async void(_params) {
+    return {
+      success: false,
+      error: "Void operation not supported via API. Please use Cardcom merchant dashboard."
+    };
+  }
+  async refund(params) {
+    try {
+      const refundAmount = params.amount ? params.amount.amountMinor / 100 : void 0;
+      if (!refundAmount) {
+        return {
+          success: false,
+          error: "Refund amount is required"
+        };
+      }
+      const request = {
+        TerminalNumber: this.config.terminalNumber,
+        ApiName: this.config.apiName,
+        ApiPassword: this.config.apiPassword,
+        InternalDealNumber: params.providerTransactionId,
+        Amount: refundAmount,
+        CoinID: params.amount ? getCurrencyCode(params.amount.currency) : 1
+      };
+      const response = await this.makeRequest(
+        CARDCOM_ENDPOINTS.REFUND,
+        request
+      );
+      if (response.ResponseCode !== 0) {
+        return {
+          success: false,
+          error: mapCardcomError(response.ResponseCode)
+        };
+      }
+      return {
+        success: true,
+        providerRefundId: response.InternalDealNumber ?? params.providerTransactionId,
+        refundedAmount: {
+          amountMinor: Math.round((response.Amount ?? 0) * 100),
+          currency: params.amount?.currency ?? "ILS"
+        },
+        status: "succeeded"
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  // ==========================================================================
+  // Payment Method Tokenization
+  // ==========================================================================
+  async createSetupIntent(params) {
+    try {
+      const request = {
+        TerminalNumber: this.config.terminalNumber,
+        ApiName: this.config.apiName,
+        ApiPassword: this.config.apiPassword,
+        Sum: 0,
+        Operation: 3 /* CREATE_TOKEN_ONLY */,
+        Language: "en",
+        InternalDealNumber: `setup_${params.userId}_${Date.now()}`
+      };
+      const response = await this.makeRequest(
+        CARDCOM_ENDPOINTS.LOW_PROFILE_CREATE,
+        request
+      );
+      if (response.ResponseCode !== 0 || !response.PaymentUrl) {
+        return {
+          success: false,
+          error: mapCardcomError(response.ResponseCode)
+        };
+      }
+      return {
+        success: true,
+        setupIntentId: response.LowProfileCode,
+        clientSecret: response.PaymentUrl
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async savePaymentMethod(params) {
+    try {
+      const lowProfileCode = params.setupData.lowProfileCode;
+      if (!lowProfileCode) {
+        return {
+          success: false,
+          error: "Low profile code is required"
+        };
+      }
+      const statusResponse = await this.getLowProfileStatus(lowProfileCode);
+      if (!statusResponse.success || !statusResponse.data) {
+        return {
+          success: false,
+          error: statusResponse.error ?? "Failed to retrieve payment method"
+        };
+      }
+      const status = statusResponse.data;
+      if (!status.Token) {
+        return {
+          success: false,
+          error: "No token created"
+        };
+      }
+      const [expMonth, expYear] = (status.CardExpiration ?? "/").split("/");
+      return {
+        success: true,
+        paymentMethodId: status.Token,
+        cardBrand: status.CardType ?? "unknown",
+        cardLast4: status.CardMask?.slice(-4),
+        cardExpMonth: expMonth?.padStart(2, "0"),
+        cardExpYear: expYear ? `20${expYear}` : void 0,
+        cardBin: status.CardBin
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async deletePaymentMethod(_paymentMethodId) {
+    return {
+      success: true
+    };
+  }
+  // ==========================================================================
+  // Customer Management
+  // ==========================================================================
+  async createCustomer(params) {
+    return {
+      success: true,
+      customerId: params.userId
+    };
+  }
+  async getOrCreateCustomer(userId, email) {
+    return this.createCustomer({ userId, email });
+  }
+  // ==========================================================================
+  // Health & Status
+  // ==========================================================================
+  async getHealth() {
+    const start = Date.now();
+    try {
+      const request = {
+        TerminalNumber: this.config.terminalNumber,
+        ApiName: this.config.apiName,
+        ApiPassword: this.config.apiPassword,
+        Sum: 1,
+        Operation: 1 /* BILL_ONLY */,
+        InternalDealNumber: `health_check_${Date.now()}`
+      };
+      const response = await this.makeRequest(
+        CARDCOM_ENDPOINTS.LOW_PROFILE_CREATE,
+        request
+      );
+      const healthy = response.ResponseCode === 0 || response.ResponseCode === 1;
+      return {
+        provider: "cardcom",
+        healthy,
+        lastChecked: /* @__PURE__ */ new Date(),
+        avgLatencyMs: Date.now() - start,
+        circuitBreakerOpen: false
+      };
+    } catch {
+      return {
+        provider: "cardcom",
+        healthy: false,
+        lastChecked: /* @__PURE__ */ new Date(),
+        circuitBreakerOpen: false
+      };
+    }
+  }
+  validateWebhookSignature(payload, signature) {
+    if (!this.config.webhookSecret) {
+      return false;
+    }
+    try {
+      const expectedSignature = crypto.createHmac("sha256", this.config.webhookSecret).update(payload).digest("hex");
+      return crypto.timingSafeEqual(
+        Buffer.from(signature),
+        Buffer.from(expectedSignature)
+      );
+    } catch {
+      return false;
+    }
+  }
+  async getPaymentIntentStatus(providerIntentId) {
+    try {
+      const result = await this.getLowProfileStatus(providerIntentId);
+      if (!result.success || !result.data) {
+        return {
+          status: "unknown",
+          error: result.error
+        };
+      }
+      const status = mapCardcomDealResponseToStatus(
+        result.data.DealResponse ?? 0
+      );
+      return { status };
+    } catch (error) {
+      return {
+        status: "unknown",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  // ==========================================================================
+  // Helper Methods
+  // ==========================================================================
+  async makeRequest(endpoint, data) {
+    const url = `${CARDCOM_API_BASE}${endpoint}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(data)
+    });
+    if (!response.ok) {
+      throw new Error(`Cardcom API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  async getLowProfileStatus(lowProfileCode) {
+    try {
+      const params = new URLSearchParams({
+        terminalnumber: this.config.terminalNumber,
+        lowprofilecode: lowProfileCode,
+        username: this.config.apiName
+      });
+      const url = `${CARDCOM_API_BASE}${CARDCOM_ENDPOINTS.LOW_PROFILE_STATUS}?${params}`;
+      const response = await fetch(url, {
+        method: "GET"
+      });
+      if (!response.ok) {
+        return {
+          success: false,
+          error: `Status check failed: ${response.status}`
+        };
+      }
+      const data = await response.json();
+      if (data.ResponseCode !== 0) {
+        return {
+          success: false,
+          error: mapCardcomError(data.ResponseCode)
+        };
+      }
+      return { success: true, data };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Status check failed"
+      };
+    }
+  }
+  handleError(error) {
+    const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+    return {
+      success: false,
+      error: errorMessage
+    };
+  }
+};
+
+// src/providers/cardcom/cardcom-webhook-handler.ts
+var CardcomWebhookHandler = class {
+  provider = "cardcom";
+  supportedEventTypes = CARDCOM_WEBHOOK_EVENTS;
+  parseEvent(rawPayload) {
+    try {
+      const params = rawPayload;
+      const responseCode = parseInt(params.ResponseCode ?? "1", 10);
+      const dealResponse = parseInt(params.DealResponse ?? "0", 10);
+      const lowProfileCode = params.LowProfileCode ?? "";
+      const internalDealNumber = params.InternalDealNumber ?? "";
+      if (!lowProfileCode && !internalDealNumber) {
+        return {
+          success: false,
+          error: "Missing LowProfileCode or InternalDealNumber in callback"
+        };
+      }
+      let eventType;
+      if (dealResponse === 1) {
+        eventType = "payment.completed";
+      } else if (dealResponse === 2) {
+        eventType = "payment.declined";
+      } else if (dealResponse === 0 && responseCode === 0) {
+        eventType = "payment.authorized";
+      } else {
+        eventType = "payment.declined";
+      }
+      const status = mapCardcomDealResponseToStatus(dealResponse);
+      const amountString = params.Amount ?? "0";
+      const amountMajor = parseFloat(amountString);
+      const amountMinor = Math.round(amountMajor * 100);
+      const parsed = {
+        provider: "cardcom",
+        eventId: `${lowProfileCode}_${internalDealNumber}_${Date.now()}`,
+        eventType,
+        providerTransactionId: internalDealNumber || lowProfileCode,
+        timestamp: /* @__PURE__ */ new Date(),
+        rawPayload,
+        newStatus: status,
+        amountMinor,
+        currency: params.Currency ?? "ILS"
+      };
+      if (dealResponse === 2 || responseCode !== 0) {
+        parsed.error = {
+          code: String(responseCode),
+          message: CARDCOM_DEAL_RESPONSE_ACTIONS[dealResponse] ?? "Payment failed"
+        };
+      }
+      return { success: true, event: parsed };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Parse error"
+      };
+    }
+  }
+  async processEvent(event) {
+    const action = this.getActionForEvent(event.eventType);
+    if (action === "ignored") {
+      return {
+        success: true,
+        action: "ignored_event_type"
+      };
+    }
+    return {
+      success: true,
+      transactionId: event.providerTransactionId,
+      action: "status_updated"
+    };
+  }
+  canHandle(eventType) {
+    return this.supportedEventTypes.includes(
+      eventType
+    );
+  }
+  async reconcile(_transactionId, _providerTransactionId) {
+    return {
+      reconciled: false,
+      finalStatus: "created",
+      source: "provider_query",
+      statusChanged: false
+    };
+  }
+  mapEventType(providerEventType) {
+    return providerEventType;
+  }
+  mapStatus(providerStatus) {
+    const dealResponse = parseInt(providerStatus, 10);
+    if (isNaN(dealResponse)) {
+      return null;
+    }
+    return mapCardcomDealResponseToStatus(dealResponse);
+  }
+  getActionForEvent(eventType) {
+    switch (eventType) {
+      case "payment.completed":
+      case "payment.declined":
+      case "payment.authorized":
+        return "status_update";
+      default:
+        return "ignored";
+    }
+  }
+};
+function validateCardcomCallback(params) {
+  const requiredFields = ["ResponseCode", "LowProfileCode"];
+  for (const field of requiredFields) {
+    if (!params[field]) {
+      return {
+        valid: false,
+        error: `Missing required field: ${field}`
+      };
+    }
+  }
+  const responseCode = parseInt(String(params.ResponseCode), 10);
+  if (isNaN(responseCode)) {
+    return {
+      valid: false,
+      error: "Invalid ResponseCode format"
+    };
+  }
+  return { valid: true };
+}
+function parseCardcomCallbackUrl(url) {
+  try {
+    const urlObj = new URL(url);
+    const params = {};
+    params.ResponseCode = urlObj.searchParams.get("ResponseCode") ?? void 0;
+    params.LowProfileCode = urlObj.searchParams.get("LowProfileCode") ?? void 0;
+    params.DealResponse = urlObj.searchParams.get("DealResponse") ?? void 0;
+    params.OperationResponse = urlObj.searchParams.get("OperationResponse") ?? void 0;
+    params.InternalDealNumber = urlObj.searchParams.get("InternalDealNumber") ?? void 0;
+    params.Amount = urlObj.searchParams.get("Amount") ?? void 0;
+    params.Currency = urlObj.searchParams.get("Currency") ?? void 0;
+    params.CardMask = urlObj.searchParams.get("CardMask") ?? void 0;
+    params.Token = urlObj.searchParams.get("Token") ?? void 0;
+    return params;
+  } catch {
+    return {};
+  }
+}
+function isCardcomCallbackSuccess(params) {
+  const responseCode = parseInt(params.ResponseCode ?? "1", 10);
+  const dealResponse = parseInt(params.DealResponse ?? "0", 10);
+  return responseCode === 0 && dealResponse === 1;
+}
+function isCardcomCallbackAuthorized(params) {
+  const responseCode = parseInt(params.ResponseCode ?? "1", 10);
+  const dealResponse = parseInt(params.DealResponse ?? "0", 10);
+  return responseCode === 0 && (dealResponse === 0 || dealResponse === 1);
+}
+function getCardcomCallbackError(params) {
+  const responseCode = parseInt(params.ResponseCode ?? "1", 10);
+  const dealResponse = parseInt(params.DealResponse ?? "0", 10);
+  if (responseCode === 0 && dealResponse === 1) {
+    return null;
+  }
+  if (dealResponse === 2) {
+    return "Payment declined by card issuer";
+  }
+  if (responseCode !== 0) {
+    return `Payment failed with code ${responseCode}`;
+  }
+  return "Payment processing error";
+}
+export {
+  CARDCOM_API_BASE,
+  CARDCOM_CURRENCY_CODES,
+  CARDCOM_DEAL_RESPONSE_ACTIONS,
+  CARDCOM_ENDPOINTS,
+  CARDCOM_LANGUAGE_CODES,
+  CARDCOM_RESPONSE_CODE_MAP,
+  CARDCOM_SUPPORTED_CURRENCIES,
+  CARDCOM_WEBHOOK_EVENTS,
+  CardcomOperation,
+  CardcomProvider,
+  CardcomTransactionType,
+  CardcomWebhookHandler,
+  getCardcomCallbackError,
+  getCurrencyCode,
+  isCardcomCallbackAuthorized,
+  isCardcomCallbackSuccess,
+  mapCardcomDealResponseToStatus,
+  mapCardcomError,
+  parseCardcomCallbackUrl,
+  validateCardcomCallback
+};
+//# sourceMappingURL=index.js.map