@nehorai/payments-il 0.1.0

package/dist/hyp/index.js

@@ -0,0 +1,841 @@
+// src/providers/hyp/hyp-provider.ts
+import { calculateCaptureDeadline } from "@nehorai/payments/types";
+
+// src/providers/hyp/hyp-types.ts
+var DEFAULT_HYP_ENDPOINTS = {
+  test: "https://cguat2.creditguard.co.il",
+  production: "https://cgpay3.creditguard.co.il"
+};
+var HYP_SUPPORTED_CURRENCIES = [
+  "ILS",
+  // Israeli Shekel (primary)
+  "USD",
+  // US Dollar
+  "EUR",
+  // Euro
+  "GBP"
+  // British Pound
+];
+var HYP_RESULT_CODE_MAP = {
+  "000": "captured",
+  // Success
+  "001": "failed",
+  // Declined
+  "002": "failed",
+  // Invalid card
+  "003": "failed",
+  // Expired card
+  "004": "failed",
+  // Insufficient funds
+  "005": "failed",
+  // Invalid CVV
+  "006": "failed",
+  // Card not permitted
+  "033": "failed",
+  // Lost/Stolen card
+  "034": "failed",
+  // Suspected fraud
+  "051": "failed",
+  // Insufficient funds
+  "054": "failed",
+  // Expired card
+  "057": "failed",
+  // Transaction not permitted
+  "100": "failed",
+  // System error
+  "200": "pending_authorization"
+  // Pending
+};
+var HYP_TRANSACTION_TYPES = {
+  /** Regular charge (immediate capture) */
+  DEBIT: "Debit",
+  /** Refund */
+  CREDIT: "Credit",
+  /** Authorization only (J5) */
+  DEBIT_J5: "Debit"
+};
+var HYP_TRANSACTION_CODES = {
+  /** Regular transaction */
+  REGULAR: "Regular",
+  /** Verify only (authorization) */
+  VERIFY: "Verify",
+  /** Force transaction */
+  FORCE: "Force"
+};
+var HYP_VALIDATION_MODES = {
+  /** Auto commit (immediate capture) */
+  AUTO_COMM: "AutoComm",
+  /** Transaction only (authorization, requires manual capture) */
+  TX_ONLY: "TxOnly"
+};
+var HYP_CREDIT_TYPES = {
+  /** Regular credit card */
+  REGULAR: "1",
+  /** Token/Saved card */
+  TOKEN: "8"
+};
+var HYP_ERROR_MAP = {
+  "001": "card_declined",
+  "002": "invalid_card",
+  "003": "expired_card",
+  "004": "insufficient_funds",
+  "005": "invalid_cvc",
+  "006": "card_declined",
+  "033": "card_declined",
+  "034": "card_declined",
+  "051": "insufficient_funds",
+  "054": "expired_card",
+  "057": "card_declined",
+  "100": "processing_error",
+  "200": "authentication_required"
+};
+function mapHypStatus(resultCode) {
+  return HYP_RESULT_CODE_MAP[resultCode] ?? null;
+}
+function mapHypError(resultCode) {
+  return HYP_ERROR_MAP[resultCode] ?? "unknown";
+}
+function isHypSupportedCurrency(currency) {
+  return HYP_SUPPORTED_CURRENCIES.includes(
+    currency
+  );
+}
+function isHypSuccess(resultCode) {
+  return resultCode === "000";
+}
+function formatHypAmount(amountMinor) {
+  return amountMinor;
+}
+function formatCardExpiration(month, year) {
+  const mm = month.padStart(2, "0");
+  const yy = year.slice(-2);
+  return `${mm}${yy}`;
+}
+function parseCardExpiration(expiration) {
+  const mm = expiration.substring(0, 2);
+  const yy = expiration.substring(2, 4);
+  return {
+    month: mm,
+    year: `20${yy}`
+  };
+}
+
+// src/providers/hyp/hyp-provider.ts
+var HypProvider = class {
+  name = "hyp";
+  supportedCurrencies = HYP_SUPPORTED_CURRENCIES;
+  supportsRecurring = true;
+  supportsSplitPayments = false;
+  config;
+  constructor(config) {
+    if (!config.terminalNumber || !config.user || !config.password) {
+      throw new Error(
+        "HypProvider requires terminalNumber, user, and password in config"
+      );
+    }
+    const baseUrl = config.baseUrl ?? (config.environment === "production" ? DEFAULT_HYP_ENDPOINTS.production : DEFAULT_HYP_ENDPOINTS.test);
+    this.config = { ...config, baseUrl };
+  }
+  // ==========================================================================
+  // Payment Intent Operations
+  // ==========================================================================
+  /**
+   * Create a payment intent
+   *
+   * For Hyp, this generates a hosted payment page or prepares for direct charge.
+   */
+  async createPaymentIntent(params) {
+    try {
+      if (!params.paymentMethodId) {
+        return await this.createHostedPage(params);
+      }
+      return await this.chargeWithToken(params);
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * Create hosted payment page
+   */
+  async createHostedPage(params) {
+    const uniqueid = params.idempotencyKey;
+    const request = {
+      terminalNumber: this.config.terminalNumber,
+      user: this.config.user,
+      password: this.config.password,
+      total: formatHypAmount(params.amount.amountMinor),
+      currency: params.amount.currency,
+      transactionType: HYP_TRANSACTION_TYPES.DEBIT,
+      transactionCode: params.captureMethod === "manual" ? HYP_TRANSACTION_CODES.VERIFY : HYP_TRANSACTION_CODES.REGULAR,
+      validation: params.captureMethod === "manual" ? HYP_VALIDATION_MODES.TX_ONLY : HYP_VALIDATION_MODES.AUTO_COMM,
+      uniqueid,
+      successUrl: params.returnUrl,
+      errorUrl: params.returnUrl,
+      cancelUrl: params.returnUrl,
+      language: "en"
+    };
+    const response = await this.sendDoDealRequest(request);
+    if (!isHypSuccess(response.resultCode)) {
+      return {
+        success: false,
+        error: response.resultDescription ?? "Transaction failed",
+        errorCode: mapHypError(response.resultCode)
+      };
+    }
+    return {
+      success: true,
+      providerIntentId: response.transactionId ?? uniqueid,
+      redirectUrl: response.redirectUrl,
+      status: "created"
+    };
+  }
+  /**
+   * Charge with saved payment method token
+   */
+  async chargeWithToken(params) {
+    const uniqueid = params.idempotencyKey;
+    const request = {
+      terminalNumber: this.config.terminalNumber,
+      user: this.config.user,
+      password: this.config.password,
+      total: formatHypAmount(params.amount.amountMinor),
+      currency: params.amount.currency,
+      transactionType: HYP_TRANSACTION_TYPES.DEBIT,
+      transactionCode: params.captureMethod === "manual" ? HYP_TRANSACTION_CODES.VERIFY : HYP_TRANSACTION_CODES.REGULAR,
+      validation: params.captureMethod === "manual" ? HYP_VALIDATION_MODES.TX_ONLY : HYP_VALIDATION_MODES.AUTO_COMM,
+      creditType: HYP_CREDIT_TYPES.TOKEN,
+      cardToken: params.paymentMethodId,
+      uniqueid
+    };
+    const response = await this.sendDoDealRequest(request);
+    if (!isHypSuccess(response.resultCode)) {
+      return {
+        success: false,
+        error: response.resultDescription ?? "Transaction failed",
+        errorCode: mapHypError(response.resultCode)
+      };
+    }
+    const status = mapHypStatus(response.resultCode) ?? "created";
+    return {
+      success: true,
+      providerIntentId: response.transactionId ?? uniqueid,
+      status
+    };
+  }
+  async authorize(params) {
+    try {
+      return {
+        success: true,
+        authorizationCode: params.providerIntentId,
+        status: "authorized",
+        captureDeadline: calculateCaptureDeadline(/* @__PURE__ */ new Date())
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async capture(params) {
+    try {
+      const request = {
+        terminalNumber: this.config.terminalNumber,
+        user: this.config.user,
+        password: this.config.password,
+        total: params.amount ? formatHypAmount(params.amount.amountMinor) : void 0,
+        currency: params.amount?.currency ?? "ILS",
+        transactionType: HYP_TRANSACTION_TYPES.DEBIT,
+        transactionCode: HYP_TRANSACTION_CODES.FORCE,
+        validation: HYP_VALIDATION_MODES.AUTO_COMM,
+        uniqueid: params.idempotencyKey,
+        authorizationCode: params.providerIntentId
+      };
+      const response = await this.sendDoDealRequest(request);
+      if (!isHypSuccess(response.resultCode)) {
+        return {
+          success: false,
+          error: response.resultDescription ?? "Capture failed",
+          errorCode: mapHypError(response.resultCode)
+        };
+      }
+      return {
+        success: true,
+        providerTransactionId: response.transactionId ?? params.providerIntentId,
+        status: "captured",
+        capturedAmount: params.amount ?? {
+          amountMinor: 0,
+          currency: "ILS"
+        }
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async void(params) {
+    try {
+      const request = {
+        terminalNumber: this.config.terminalNumber,
+        user: this.config.user,
+        password: this.config.password,
+        transactionId: params.providerIntentId,
+        currency: "ILS",
+        uniqueid: params.providerIntentId
+      };
+      const response = await this.sendRefundRequest(request);
+      if (!isHypSuccess(response.resultCode)) {
+        return {
+          success: false,
+          error: response.resultDescription ?? "Void failed"
+        };
+      }
+      return { success: true, status: "voided" };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  // ==========================================================================
+  // Refunds
+  // ==========================================================================
+  async refund(params) {
+    try {
+      const request = {
+        terminalNumber: this.config.terminalNumber,
+        user: this.config.user,
+        password: this.config.password,
+        transactionId: params.providerTransactionId,
+        total: params.amount ? formatHypAmount(params.amount.amountMinor) : void 0,
+        currency: params.amount?.currency ?? "ILS",
+        uniqueid: params.idempotencyKey
+      };
+      const response = await this.sendRefundRequest(request);
+      if (!isHypSuccess(response.resultCode)) {
+        return {
+          success: false,
+          error: response.resultDescription ?? "Refund failed"
+        };
+      }
+      return {
+        success: true,
+        providerRefundId: response.transactionId ?? params.idempotencyKey,
+        refundedAmount: params.amount ?? {
+          amountMinor: 0,
+          currency: "ILS"
+        },
+        status: "succeeded"
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  // ==========================================================================
+  // Payment Methods (Tokenization)
+  // ==========================================================================
+  async createSetupIntent(params) {
+    try {
+      const uniqueid = `setup_${params.userId}_${Date.now()}`;
+      const request = {
+        terminalNumber: this.config.terminalNumber,
+        user: this.config.user,
+        password: this.config.password,
+        total: 0,
+        currency: "ILS",
+        transactionType: HYP_TRANSACTION_TYPES.DEBIT,
+        transactionCode: HYP_TRANSACTION_CODES.VERIFY,
+        validation: HYP_VALIDATION_MODES.TX_ONLY,
+        creditType: HYP_CREDIT_TYPES.TOKEN,
+        customerData: params.customerId ?? params.userId,
+        uniqueid,
+        language: "en"
+      };
+      const response = await this.sendDoDealRequest(request);
+      if (!isHypSuccess(response.resultCode)) {
+        return {
+          success: false,
+          error: response.resultDescription ?? "Setup failed"
+        };
+      }
+      return {
+        success: true,
+        setupIntentId: response.transactionId ?? uniqueid,
+        clientSecret: response.redirectUrl
+      };
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  async savePaymentMethod(params) {
+    try {
+      const cardToken = params.setupData.cardToken;
+      const cardMask = params.setupData.cardMask;
+      const cardBrand = params.setupData.cardBrand;
+      const cardExpiration = params.setupData.cardExpiration;
+      if (!cardToken) {
+        return {
+          success: false,
+          error: "No card token received"
+        };
+      }
+      return {
+        success: true,
+        paymentMethodId: cardToken,
+        cardBrand: cardBrand ?? "unknown",
+        cardLast4: cardMask?.slice(-4) ?? "0000",
+        cardExpMonth: cardExpiration?.substring(0, 2) ?? "01",
+        cardExpYear: `20${cardExpiration?.substring(2, 4) ?? "99"}`
+      };
+    } 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 {
+      success: true,
+      customerId: userId
+    };
+  }
+  // ==========================================================================
+  // Health & Security
+  // ==========================================================================
+  async getHealth() {
+    const start = Date.now();
+    try {
+      const response = await fetch(`${this.config.baseUrl}/xpo/Relay`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "text/xml"
+        },
+        body: this.buildTestXML(),
+        signal: AbortSignal.timeout(5e3)
+      });
+      const healthy = response.ok;
+      return {
+        provider: "hyp",
+        healthy,
+        lastChecked: /* @__PURE__ */ new Date(),
+        avgLatencyMs: Date.now() - start,
+        circuitBreakerOpen: false
+      };
+    } catch {
+      return {
+        provider: "hyp",
+        healthy: false,
+        lastChecked: /* @__PURE__ */ new Date(),
+        circuitBreakerOpen: false
+      };
+    }
+  }
+  validateWebhookSignature(_payload, _signature) {
+    if (!this.config.webhookSecret) return false;
+    return !!this.config.webhookSecret;
+  }
+  async getPaymentIntentStatus(_providerIntentId) {
+    return {
+      status: "unknown",
+      error: "Status query not supported by Hyp basic integration"
+    };
+  }
+  // ==========================================================================
+  // XML Request Builders
+  // ==========================================================================
+  buildDoDealXML(request) {
+    const parts = [];
+    parts.push('<?xml version="1.0" encoding="utf-8"?>');
+    parts.push("<ashrait>");
+    parts.push("<request>");
+    parts.push(`<version>1000</version>`);
+    parts.push("<language>ENG</language>");
+    parts.push("<command>doDeal</command>");
+    parts.push(`<terminalNumber>${this.escapeXml(request.terminalNumber)}</terminalNumber>`);
+    parts.push(`<user>${this.escapeXml(request.user)}</user>`);
+    parts.push(`<password>${this.escapeXml(request.password)}</password>`);
+    if (request.cardNo) {
+      parts.push(`<cardNo>${this.escapeXml(request.cardNo)}</cardNo>`);
+    }
+    if (request.cardExpiration) {
+      parts.push(`<cardExpiration>${this.escapeXml(request.cardExpiration)}</cardExpiration>`);
+    }
+    if (request.cvv) {
+      parts.push(`<cvv>${this.escapeXml(request.cvv)}</cvv>`);
+    }
+    if (request.cardToken) {
+      parts.push(`<cardToken>${this.escapeXml(request.cardToken)}</cardToken>`);
+    }
+    if (request.authorizationCode) {
+      parts.push(`<authNumber>${this.escapeXml(request.authorizationCode)}</authNumber>`);
+    }
+    if (request.total !== void 0) {
+      parts.push(`<total>${request.total}</total>`);
+    }
+    parts.push(`<currency>${this.escapeXml(request.currency)}</currency>`);
+    parts.push(`<transactionType>${this.escapeXml(request.transactionType)}</transactionType>`);
+    if (request.transactionCode) {
+      parts.push(`<transactionCode>${this.escapeXml(request.transactionCode)}</transactionCode>`);
+    }
+    if (request.creditType) {
+      parts.push(`<creditType>${request.creditType}</creditType>`);
+    }
+    if (request.validation) {
+      parts.push(`<validation>${this.escapeXml(request.validation)}</validation>`);
+    }
+    if (request.uniqueid) {
+      parts.push(`<uniqueid>${this.escapeXml(request.uniqueid)}</uniqueid>`);
+    }
+    if (request.customerData) {
+      parts.push(`<customerData>${this.escapeXml(request.customerData)}</customerData>`);
+    }
+    if (request.successUrl) {
+      parts.push(`<successUrl>${this.escapeXml(request.successUrl)}</successUrl>`);
+    }
+    if (request.errorUrl) {
+      parts.push(`<errorUrl>${this.escapeXml(request.errorUrl)}</errorUrl>`);
+    }
+    if (request.cancelUrl) {
+      parts.push(`<cancelUrl>${this.escapeXml(request.cancelUrl)}</cancelUrl>`);
+    }
+    parts.push("</request>");
+    parts.push("</ashrait>");
+    return parts.join("");
+  }
+  buildRefundXML(request) {
+    const parts = [];
+    parts.push('<?xml version="1.0" encoding="utf-8"?>');
+    parts.push("<ashrait>");
+    parts.push("<request>");
+    parts.push(`<version>1000</version>`);
+    parts.push("<language>ENG</language>");
+    parts.push("<command>refundDeal</command>");
+    parts.push(`<terminalNumber>${this.escapeXml(request.terminalNumber)}</terminalNumber>`);
+    parts.push(`<user>${this.escapeXml(request.user)}</user>`);
+    parts.push(`<password>${this.escapeXml(request.password)}</password>`);
+    parts.push(`<transactionId>${this.escapeXml(request.transactionId)}</transactionId>`);
+    parts.push(`<currency>${this.escapeXml(request.currency)}</currency>`);
+    if (request.total !== void 0) {
+      parts.push(`<total>${request.total}</total>`);
+    }
+    if (request.uniqueid) {
+      parts.push(`<uniqueid>${this.escapeXml(request.uniqueid)}</uniqueid>`);
+    }
+    parts.push("</request>");
+    parts.push("</ashrait>");
+    return parts.join("");
+  }
+  buildTestXML() {
+    return `<?xml version="1.0" encoding="utf-8"?>
+<ashrait>
+  <request>
+    <version>1000</version>
+    <language>ENG</language>
+    <command>echo</command>
+  </request>
+</ashrait>`;
+  }
+  // ==========================================================================
+  // HTTP Helpers
+  // ==========================================================================
+  async sendDoDealRequest(request) {
+    const xmlBody = this.buildDoDealXML(request);
+    const response = await fetch(`${this.config.baseUrl}/xpo/Relay`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "text/xml; charset=utf-8"
+      },
+      body: xmlBody
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const xmlResponse = await response.text();
+    return this.parseDoDealResponse(xmlResponse);
+  }
+  async sendRefundRequest(request) {
+    const xmlBody = this.buildRefundXML(request);
+    const response = await fetch(`${this.config.baseUrl}/xpo/Relay`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "text/xml; charset=utf-8"
+      },
+      body: xmlBody
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const xmlResponse = await response.text();
+    return this.parseRefundResponse(xmlResponse);
+  }
+  // ==========================================================================
+  // XML Parsing
+  // ==========================================================================
+  parseDoDealResponse(xml) {
+    return {
+      resultCode: this.extractXmlValue(xml, "resultCode") ?? "100",
+      resultDescription: this.extractXmlValue(xml, "resultDescription"),
+      transactionId: this.extractXmlValue(xml, "transactionId"),
+      authorizationCode: this.extractXmlValue(xml, "authorizationCode"),
+      voucherNumber: this.extractXmlValue(xml, "voucherNumber"),
+      cardToken: this.extractXmlValue(xml, "cardToken"),
+      cardMask: this.extractXmlValue(xml, "cardMask"),
+      cardBrand: this.extractXmlValue(xml, "cardBrand"),
+      cardExpiration: this.extractXmlValue(xml, "cardExpiration"),
+      redirectUrl: this.extractXmlValue(xml, "redirectUrl"),
+      uniqueid: this.extractXmlValue(xml, "uniqueid"),
+      rawXml: xml
+    };
+  }
+  parseRefundResponse(xml) {
+    return {
+      resultCode: this.extractXmlValue(xml, "resultCode") ?? "100",
+      resultDescription: this.extractXmlValue(xml, "resultDescription"),
+      transactionId: this.extractXmlValue(xml, "transactionId"),
+      authorizationCode: this.extractXmlValue(xml, "authorizationCode"),
+      uniqueid: this.extractXmlValue(xml, "uniqueid")
+    };
+  }
+  extractXmlValue(xml, tagName) {
+    const regex = new RegExp(`<${tagName}>([^<]*)</${tagName}>`, "i");
+    const match = xml.match(regex);
+    return match ? match[1].trim() : void 0;
+  }
+  escapeXml(str) {
+    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+  }
+  // ==========================================================================
+  // Error Handling
+  // ==========================================================================
+  handleError(error) {
+    if (error instanceof Error) {
+      return {
+        success: false,
+        error: error.message,
+        errorCode: "unknown"
+      };
+    }
+    return {
+      success: false,
+      error: "Unknown error occurred",
+      errorCode: "unknown"
+    };
+  }
+};
+
+// src/providers/hyp/hyp-webhook-handler.ts
+var HYP_EVENT_TYPES = {
+  TRANSACTION_SUCCESS: "transaction.success",
+  TRANSACTION_FAILED: "transaction.failed",
+  TRANSACTION_PENDING: "transaction.pending",
+  REFUND_SUCCESS: "refund.success",
+  REFUND_FAILED: "refund.failed"
+};
+var HypWebhookHandler = class {
+  provider = "hyp";
+  supportedEventTypes = Object.values(HYP_EVENT_TYPES);
+  parseEvent(rawPayload) {
+    try {
+      const resultCode = String(rawPayload.resultCode ?? "100");
+      const resultDescription = String(rawPayload.resultDescription ?? "");
+      const transactionId = String(rawPayload.transactionId ?? "");
+      const uniqueid = String(rawPayload.uniqueid ?? "");
+      const total = Number(rawPayload.total ?? 0);
+      const currency = String(rawPayload.currency ?? "ILS");
+      const eventType = this.determineEventType(resultCode);
+      const newStatus = mapHypStatus(resultCode);
+      const event = {
+        provider: "hyp",
+        eventId: uniqueid || transactionId || `hyp_${Date.now()}`,
+        eventType,
+        providerTransactionId: transactionId,
+        amountMinor: total,
+        currency,
+        newStatus: newStatus ?? void 0,
+        error: isHypSuccess(resultCode) ? void 0 : {
+          code: resultCode,
+          message: resultDescription
+        },
+        timestamp: /* @__PURE__ */ new Date(),
+        rawPayload
+      };
+      return {
+        success: true,
+        event
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Failed to parse webhook"
+      };
+    }
+  }
+  async processEvent(event) {
+    try {
+      if (!event.providerTransactionId) {
+        return {
+          success: false,
+          error: "Missing transaction ID in webhook",
+          action: "ignored_event_type"
+        };
+      }
+      const action = this.determineAction(event);
+      return {
+        success: true,
+        transactionId: event.providerTransactionId,
+        action
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Processing failed",
+        action: "ignored_event_type"
+      };
+    }
+  }
+  canHandle(eventType) {
+    return this.supportedEventTypes.includes(
+      eventType
+    );
+  }
+  async reconcile(_transactionId, _providerTransactionId) {
+    return {
+      reconciled: false,
+      finalStatus: "pending_authorization",
+      source: "webhook",
+      statusChanged: false
+    };
+  }
+  mapEventType(providerEventType) {
+    return providerEventType;
+  }
+  mapStatus(providerStatus) {
+    return mapHypStatus(providerStatus);
+  }
+  // ==========================================================================
+  // Helper Methods
+  // ==========================================================================
+  determineEventType(resultCode) {
+    if (isHypSuccess(resultCode)) {
+      return HYP_EVENT_TYPES.TRANSACTION_SUCCESS;
+    }
+    if (resultCode === "200") {
+      return HYP_EVENT_TYPES.TRANSACTION_PENDING;
+    }
+    return HYP_EVENT_TYPES.TRANSACTION_FAILED;
+  }
+  determineAction(event) {
+    switch (event.eventType) {
+      case HYP_EVENT_TYPES.TRANSACTION_SUCCESS:
+      case HYP_EVENT_TYPES.TRANSACTION_FAILED:
+      case HYP_EVENT_TYPES.TRANSACTION_PENDING:
+      case HYP_EVENT_TYPES.REFUND_FAILED:
+        return "status_updated";
+      case HYP_EVENT_TYPES.REFUND_SUCCESS:
+        return "refund_processed";
+      default:
+        return "ignored_event_type";
+    }
+  }
+  // ==========================================================================
+  // Webhook Validation
+  // ==========================================================================
+  validateSignature(payload, signature, secret) {
+    const hasRequiredParams = payload.resultCode !== void 0 && (payload.transactionId !== void 0 || payload.uniqueid !== void 0);
+    if (!hasRequiredParams) {
+      return false;
+    }
+    if (secret && signature) {
+      return this.validateHMAC(payload, signature, secret);
+    }
+    return hasRequiredParams;
+  }
+  validateHMAC(_payload, signature, _secret) {
+    try {
+      return !!signature;
+    } catch {
+      return false;
+    }
+  }
+  // ==========================================================================
+  // Callback URL Builders
+  // ==========================================================================
+  buildSuccessUrl(baseUrl, transactionId) {
+    return `${baseUrl}/api/payments/hyp/callback?status=success&txId=${transactionId}`;
+  }
+  buildErrorUrl(baseUrl, transactionId) {
+    return `${baseUrl}/api/payments/hyp/callback?status=error&txId=${transactionId}`;
+  }
+  buildCancelUrl(baseUrl, transactionId) {
+    return `${baseUrl}/api/payments/hyp/callback?status=cancel&txId=${transactionId}`;
+  }
+  // ==========================================================================
+  // Response Parsing
+  // ==========================================================================
+  extractErrorDetails(payload) {
+    const resultCode = String(payload.resultCode ?? "unknown");
+    const resultDescription = String(payload.resultDescription ?? "Unknown error");
+    return {
+      code: resultCode,
+      message: resultDescription,
+      userMessage: this.getUserFriendlyMessage(resultCode)
+    };
+  }
+  getUserFriendlyMessage(resultCode) {
+    const errorCode = mapHypError(resultCode);
+    const messages = {
+      card_declined: "Your card was declined. Please try another payment method.",
+      invalid_card: "The card information is invalid. Please check and try again.",
+      expired_card: "Your card has expired. Please use a different card.",
+      insufficient_funds: "Insufficient funds. Please try another payment method.",
+      invalid_cvc: "The security code (CVV) is incorrect.",
+      processing_error: "A processing error occurred. Please try again.",
+      authentication_required: "Additional authentication is required. Please complete the verification.",
+      unknown: "An error occurred. Please try again or contact support."
+    };
+    return messages[errorCode] ?? messages.unknown;
+  }
+  extractCardDetails(payload) {
+    const cardToken = payload.cardToken;
+    const cardMask = payload.cardMask;
+    const cardBrand = payload.cardBrand;
+    const cardExpiration = payload.cardExpiration;
+    return {
+      cardToken,
+      cardMask,
+      cardBrand,
+      cardExpiration,
+      last4: cardMask?.slice(-4)
+    };
+  }
+};
+function createHypWebhookHandler() {
+  return new HypWebhookHandler();
+}
+export {
+  DEFAULT_HYP_ENDPOINTS,
+  HYP_CREDIT_TYPES,
+  HYP_ERROR_MAP,
+  HYP_RESULT_CODE_MAP,
+  HYP_SUPPORTED_CURRENCIES,
+  HYP_TRANSACTION_CODES,
+  HYP_TRANSACTION_TYPES,
+  HYP_VALIDATION_MODES,
+  HypProvider,
+  HypWebhookHandler,
+  createHypWebhookHandler,
+  formatCardExpiration,
+  formatHypAmount,
+  isHypSuccess,
+  isHypSupportedCurrency,
+  mapHypError,
+  mapHypStatus,
+  parseCardExpiration
+};
+//# sourceMappingURL=index.js.map