@crediblemark/buayar 0.8.4 → 0.8.6

package/dist/index.js

@@ -94,6 +94,8 @@ __export(index_exports, {
   buildCoreChargePayload: () => buildCoreChargePayload,
   buildDefaultDescriptors: () => buildDefaultDescriptors,
   buildIpaymuCallbackString: () => buildIpaymuCallbackString,
+  buildPaymentMethodDescriptor: () => buildPaymentMethodDescriptor,
+  buildPaymentMethodDescriptors: () => buildPaymentMethodDescriptors,
   buildPaypalBasicAuth: () => buildPaypalBasicAuth,
   buildPayuBasicAuth: () => buildPayuBasicAuth,
   buildRazorpayBasicAuth: () => buildRazorpayBasicAuth,
@@ -114,6 +116,7 @@ __export(index_exports, {
   getPaymentMethodCategory: () => getPaymentMethodCategory,
   getXenditAuthHeader: () => getXenditAuthHeader,
   hmacSha256: () => hmacSha256,
+  mapCategoryToDescriptorType: () => mapCategoryToDescriptorType,
   md5: () => md5,
   minifyJson: () => minifyJson,
   normalizeIpaymuCallback: () => normalizeIpaymuCallback,
@@ -1805,7 +1808,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
       payload = {
         name: customer.name,
         email: customer.email,
-        phone: customer.phone || "081234567890",
+        ...customer.phone ? { phone: customer.phone } : {},
         amount: integerAmount,
         notifyUrl,
         expired: 24,
@@ -1836,7 +1839,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
         referenceId: orderId,
         buyerName: customer.name,
         buyerEmail: customer.email,
-        buyerPhone: customer.phone || "081234567890",
+        ...customer.phone ? { buyerPhone: customer.phone } : {},
         ...feeDirection ? { feeDirection } : {},
         ...escrow !== void 0 ? { escrow } : {},
         ...subAccount ? { account: subAccount } : {},
@@ -2066,6 +2069,28 @@ var IpaymuProvider = class extends BasePaymentProvider {
       };
     }
   }
+  async probePaymentMethods(config) {
+    try {
+      const res = await this.getPaymentMethods({ amount: 1e4 }, config);
+      if (res.success && res.methods) {
+        return {
+          success: true,
+          enabled: res.methods.map((m) => m.paymentMethod)
+        };
+      }
+      return {
+        success: false,
+        enabled: [],
+        error: res.error || "Failed to probe iPaymu payment methods"
+      };
+    } catch (e) {
+      return {
+        success: false,
+        enabled: [],
+        error: e.message || "Failed to probe iPaymu payment methods"
+      };
+    }
+  }
   async checkTransaction(params, config) {
     const { merchantOrderId } = params;
     const va = config.merchantCode || config.merchantId || "";
@@ -2353,8 +2378,8 @@ var XenditProvider = class extends BasePaymentProvider {
     const status = isPaid ? "paid" : isPending ? "pending" : isExpired ? "expired" : "failed";
     const webhookToken = config.extra?.webhookToken;
     const headerToken = config.extra?.callbackToken || config.extra?.headers?.["x-callback-token"] || config.extra?.headers?.["X-Callback-Token"];
-    let isValid = true;
-    if (webhookToken || headerToken) {
+    let isValid = false;
+    if (webhookToken && headerToken) {
       isValid = verifyXenditWebhookToken(headerToken, webhookToken);
     }
     return {
@@ -2502,6 +2527,75 @@ var XenditProvider = class extends BasePaymentProvider {
         category: "Paylater / Cicilan"
       }
     ];
+    const apiKey = config.apiKey || config.serverKey || config.secretKey || "";
+    if (apiKey) {
+      try {
+        const authHeader = getXenditAuthHeader(apiKey);
+        const response = await fetch(`${this.getBaseUrl()}/payment_channels`, {
+          method: "GET",
+          headers: {
+            "Authorization": authHeader,
+            "Content-Type": "application/json"
+          }
+        });
+        if (response.ok) {
+          const channels = await response.json();
+          if (Array.isArray(channels) && channels.length > 0) {
+            const dynamicMethods = [];
+            for (const ch of channels) {
+              if (ch.status && ch.status !== "ACTIVE") continue;
+              const codeLower = (ch.channel_code || "").toLowerCase();
+              let canonicalCode = codeLower;
+              let category = "Virtual Account";
+              if (ch.type === "BANK_TRANSFER" || codeLower.endsWith("_va") || ["bca", "bni", "bri", "mandiri", "permata", "cimb", "bsi"].includes(codeLower)) {
+                canonicalCode = codeLower.endsWith("_va") ? codeLower : `${codeLower}_va`;
+                category = "Virtual Account";
+              } else if (ch.type === "EWALLET" || ["ovo", "dana", "linkaja", "shopeepay", "gopay"].includes(codeLower)) {
+                canonicalCode = codeLower;
+                category = "E-Wallet";
+              } else if (ch.type === "QR_CODE" || codeLower === "qris") {
+                canonicalCode = "qris";
+                category = "QRIS";
+              } else if (ch.type === "RETAIL_OUTLET" || ["alfamart", "indomaret"].includes(codeLower)) {
+                canonicalCode = codeLower;
+                category = "Retail / Gerai";
+              } else if (ch.type === "CARD") {
+                canonicalCode = "credit_card";
+                category = "Kartu Kredit";
+              } else if (ch.type === "PAYLATER" || ["kredivo", "akulaku", "indodana"].includes(codeLower)) {
+                canonicalCode = codeLower;
+                category = "Paylater / Cicilan";
+              }
+              dynamicMethods.push({
+                paymentMethod: canonicalCode,
+                code: ch.channel_code || canonicalCode,
+                paymentName: ch.display_name || ch.name || ch.channel_code,
+                paymentImage: `https://xendit.co/icons/${codeLower}.png`,
+                totalFee: ch.fee ? `${ch.fee}` : "",
+                category,
+                coming_soon: false,
+                extra: ch
+              });
+            }
+            if (dynamicMethods.length > 0) {
+              const categories2 = {};
+              for (const item of dynamicMethods) {
+                if (!categories2[item.category]) categories2[item.category] = [];
+                categories2[item.category].push(item);
+              }
+              return {
+                success: true,
+                provider: "xendit",
+                methods: dynamicMethods,
+                categories: categories2,
+                rawResponse: channels
+              };
+            }
+          }
+        }
+      } catch (e) {
+      }
+    }
     const categories = {};
     for (const item of staticMethods) {
       if (!categories[item.category]) {
@@ -2517,6 +2611,28 @@ var XenditProvider = class extends BasePaymentProvider {
       rawResponse: staticMethods
     };
   }
+  async probePaymentMethods(config) {
+    try {
+      const res = await this.getPaymentMethods({ amount: 1e4 }, config);
+      if (res.success && res.methods) {
+        return {
+          success: true,
+          enabled: res.methods.map((m) => m.paymentMethod)
+        };
+      }
+      return {
+        success: false,
+        enabled: [],
+        error: res.error || "Failed to probe Xendit payment methods"
+      };
+    } catch (e) {
+      return {
+        success: false,
+        enabled: [],
+        error: e.message || "Failed to probe Xendit payment methods"
+      };
+    }
+  }
   async checkTransaction(params, config) {
     const { merchantOrderId } = params;
     const apiKey = config.apiKey || config.serverKey || config.secretKey || "";
@@ -3313,7 +3429,7 @@ var DokuProvider = class extends BasePaymentProvider {
     const secretKey = config.secretKey || config.apiKey || "";
     const signature = headers["signature"] || headers["Signature"] || config.extra?.dokuSignature || config.extra?.signatureHeader;
     const clientId = config.merchantCode || config.clientKey || "";
-    let isValid = true;
+    let isValid = false;
     if (signature || headers && (headers["request-id"] || headers["Request-Id"])) {
       isValid = verifyDokuWebhookSignature(headers, body, clientId, secretKey);
     }
@@ -3338,7 +3454,7 @@ var DokuProvider = class extends BasePaymentProvider {
   verifySnapCallback(body, config, headers) {
     const clientSecret = config.apiKey || config.serverKey || config.secretKey || "";
     const endpointUrl = config.extra?.notificationPath || headers["x-path"] || config.extra?.headers?.["request-target"] || "/api/payment/webhook";
-    let isValid = true;
+    let isValid = false;
     const incomingSig = headers["x-signature"] || headers["X-SIGNATURE"] || headers["signature"] || headers["Signature"] || "";
     if (incomingSig && clientSecret) {
       isValid = verifySnapWebhookSignature(headers, body, clientSecret, endpointUrl);
@@ -9666,6 +9782,18 @@ var PaymentManager = class {
     if (provider.probePaymentMethods) {
       return provider.probePaymentMethods(config);
     }
+    try {
+      if (typeof provider.getPaymentMethods === "function") {
+        const res = await provider.getPaymentMethods({ amount: 1e4 }, config);
+        if (res && res.success && Array.isArray(res.methods) && res.methods.length > 0) {
+          return {
+            success: true,
+            enabled: res.methods.map((m) => m.paymentMethod)
+          };
+        }
+      }
+    } catch (e) {
+    }
     return { success: false, enabled: [], error: `Provider '${providerName}' does not support payment methods probing` };
   }
   // ─── Unified Advanced Operations (Refund / Balance / Disburse) ─────────────
@@ -9849,6 +9977,80 @@ var PaymentManager = class {
 };
 var paymentManager = new PaymentManager();
 
+// src/core/descriptor.ts
+function mapCategoryToDescriptorType(category, paymentMethod) {
+  const cat = (category || "").toLowerCase();
+  const method = (paymentMethod || "").toLowerCase();
+  const isVa = cat === "virtual account" || method.includes("_va");
+  const isQr = cat === "qris" || method === "qris";
+  const isEwallet = cat === "e-wallet" || cat === "ewallet" || method === "ewallet";
+  const isRetail = cat === "retail / gerai" || cat === "cstore" || method === "cstore";
+  const isCard = cat === "kartu kredit" || cat === "cc";
+  const isPaylater = cat === "paylater / cicilan" || cat === "paylater" || method === "paylater";
+  if (isQr) return "qris";
+  if (isVa) return "va";
+  if (isEwallet) return "ewallet";
+  if (isRetail) return "retail";
+  if (isCard) return "card";
+  if (isPaylater) return "paylater";
+  return "other";
+}
+function iconForType(type) {
+  switch (type) {
+    case "qris":
+    case "ewallet":
+      return "\u{1F4F1}";
+    case "va":
+      return "\u{1F3E6}";
+    case "retail":
+      return "\u{1F3EA}";
+    case "card":
+    case "paylater":
+    default:
+      return "\u{1F4B3}";
+  }
+}
+function badgeForType(type) {
+  switch (type) {
+    case "qris":
+      return "Instan Bebas Biaya";
+    case "va":
+      return "Otomatis 24 Jam";
+    case "ewallet":
+      return "E-Wallet Instan";
+    case "retail":
+      return "Gerai Retail";
+    case "card":
+      return "Visa / Mastercard";
+    case "paylater":
+      return "Cicilan PayLater";
+    default:
+      return "Tersedia Otomatis";
+  }
+}
+function buildPaymentMethodDescriptor(pm, _providerName) {
+  const category = pm.category || "";
+  const code = (pm.code || pm.paymentMethod || "").toUpperCase();
+  const type = mapCategoryToDescriptorType(category, pm.paymentMethod);
+  const icon = iconForType(type);
+  let badge = badgeForType(type);
+  const feeDisplay = pm.totalFee && pm.totalFee !== "-" ? pm.totalFee : "";
+  return {
+    id: code,
+    name: pm.paymentName,
+    type,
+    icon,
+    badge: feeDisplay ? `${badge} \u2022 Fee ${feeDisplay}` : badge,
+    image: pm.paymentImage || void 0,
+    category,
+    coming_soon: pm.coming_soon ?? false,
+    totalFee: feeDisplay || void 0
+  };
+}
+function buildPaymentMethodDescriptors(methods, providerName) {
+  return methods.map((pm) => buildPaymentMethodDescriptor(pm, providerName));
+}
+
 // src/core/providerRegistry.ts
 var ProviderRegistry = class {
   descriptors = /* @__PURE__ */ new Map();
@@ -9891,10 +10093,26 @@ var ProviderRegistry = class {
     return ties.length === 1 ? top.name : void 0;
   }
   /**
-   * Autodetect provider dari struktur payload webhook.
+   * Autodetect provider dari struktur payload webhook dan header.
    * Mengembalikan nama provider jika dikenali, else undefined.
    */
-  detectFromWebhook(payload) {
+  detectFromWebhook(payload, headers) {
+    if (headers) {
+      const h = {};
+      for (const k of Object.keys(headers)) {
+        h[k.toLowerCase()] = headers[k];
+      }
+      if (h["stripe-signature"]) return "stripe";
+      if (h["x-callback-token"]) return "xendit";
+      if (h["x-razorpay-signature"]) return "razorpay";
+      if (h["cko-signature"]) return "checkoutcom";
+      if (h["openpayu-signature"]) return "payu";
+      if (h["x-square-hmacsha256-signature"] || h["x-square-signature"]) return "square";
+      if (h["bt_signature"]) return "braintree";
+      if (h["x-oy-username"]) return "oy";
+      if (h["signature"] && (h["client-id"] || h["request-id"])) return "doku";
+      if (h["x-signature"] && (payload?.trx_id || payload?.via || payload?.sid)) return "ipaymu";
+    }
     if (!payload) return void 0;
     const p = payload;
     if (p.signature_key && p.transaction_status) return "midtrans";
@@ -9908,7 +10126,9 @@ var ProviderRegistry = class {
     if (p.merchant_id && p.order_id && p.signature) return "prismalink";
     if (p.object === "event" || p.type && p.data?.object && p.api_version) return "stripe";
     if (p.event && p.payload?.payment?.entity) return "razorpay";
-    if (p.external_id || p.event?.startsWith("payment.") || p.event?.startsWith("qr.") || p.data?.reference_id) return "xendit";
+    if (p.external_id && (p.status || p.paid_amount || p.payment_method || p.payment_channel || p.id) || p.event?.startsWith("payment.") || p.event?.startsWith("qr.") || p.data?.reference_id) {
+      return "xendit";
+    }
     if (p.event_type && p.resource && (p.event_type.startsWith("PAYMENT.") || p.event_type.startsWith("CHECKOUT.ORDER."))) return "paypal";
     if (p.notificationItems || p.merchantAccountCode && p.pspReference && p.eventCode) return "adyen";
     if (p.type && p.data?._links && (p.type.startsWith("payment_") || p.type.startsWith("refund_"))) return "checkoutcom";
@@ -10262,10 +10482,10 @@ var Buayar = class {
     return { methods: desc.methods, operations: desc.operations };
   }
   /**
-   * Deteksi nama provider dari struktur payload webhook.
+   * Deteksi nama provider dari struktur payload webhook dan opsional headers.
    */
-  detectProviderFromPayload(payload) {
-    return this.registry.detectFromWebhook(payload);
+  detectProviderFromPayload(payload, headers) {
+    return this.registry.detectFromWebhook(payload, headers);
   }
   /**
    * Deteksi nama provider aktif dari variabel lingkungan (kredensial yang terisi).
@@ -10310,6 +10530,33 @@ var Buayar = class {
     const providerName = configOverride?.provider || this.provider;
     return this.manager.getPaymentMethods(providerName, params || { amount: 1e4 }, mergedConfig);
   }
+  /**
+   * Ambil daftar channel pembayaran aktif dalam bentuk deskriptor kanonikal
+   * siap-render (id, name, type, icon, badge, image, category, totalFee).
+   * Wrapper di atas {@link Buayar.getPaymentMethods} + `buildPaymentMethodDescriptors`,
+   * sehingga konsumen UI/snapshot tidak perlu melakukan mapping ulang per provider.
+   */
+  async getPaymentMethodDescriptors(params, configOverride) {
+    const mergedConfig = { ...this.config, ...configOverride };
+    const providerName = configOverride?.provider || this.provider;
+    const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const res = await this.manager.getPaymentMethods(providerName, params || { amount: 1e4 }, mergedConfig);
+    if (!res.success) {
+      return {
+        success: false,
+        provider: providerName,
+        descriptors: [],
+        error: res.error || "Failed to fetch payment methods",
+        generatedAt
+      };
+    }
+    return {
+      success: true,
+      provider: providerName,
+      descriptors: buildPaymentMethodDescriptors(res.methods, providerName),
+      generatedAt
+    };
+  }
   /**
    * Cek status transaksi pembayaran berdasarkan Order ID
    */
@@ -10367,14 +10614,39 @@ var Buayar = class {
         mergedConfig.extra.oyUsername = Array.isArray(oyUser) ? oyUser[0] : oyUser;
       }
     }
-    let providerName = configOverride?.provider || this.provider;
-    const detected = this.registry.detectFromWebhook(payload);
-    if (detected) providerName = detected;
+    let providerName = configOverride?.provider !== void 0 ? configOverride.provider : this.provider;
+    if (!providerName) {
+      const detected = this.registry.detectFromWebhook(payload, headers);
+      if (detected) providerName = detected;
+    }
+    if (!providerName) {
+      return {
+        isValid: false,
+        isPaid: false,
+        isPending: false,
+        isFailed: true,
+        isExpired: false,
+        status: "failed",
+        orderId: "",
+        amount: 0,
+        provider: "unknown",
+        error: "Unable to detect payment provider for webhook. Please specify provider in configuration or override.",
+        rawPayload: payload
+      };
+    }
     return this.manager.verifyCallback(providerName, payload, mergedConfig);
   }
   async handleWebhook(payload, headers, configOverride) {
     return this.verifyWebhook(payload, headers, configOverride);
   }
+  /**
+   * Probe payment methods yang benar-benar aktif di akun merchant gateway.
+   */
+  async probePaymentMethods(configOverride) {
+    const mergedConfig = { ...this.config, ...configOverride };
+    const providerName = configOverride?.provider || this.provider;
+    return this.manager.probePaymentMethods(providerName, mergedConfig);
+  }
   /**
    * Unified Refund — berlaku untuk semua provider yang mendukung refund.
    * Provider tanpa fitur refund mengembalikan `{ supported: false }`, bukan error.
@@ -10529,6 +10801,8 @@ var buayar = new Buayar();
   buildCoreChargePayload,
   buildDefaultDescriptors,
   buildIpaymuCallbackString,
+  buildPaymentMethodDescriptor,
+  buildPaymentMethodDescriptors,
   buildPaypalBasicAuth,
   buildPayuBasicAuth,
   buildRazorpayBasicAuth,
@@ -10549,6 +10823,7 @@ var buayar = new Buayar();
   getPaymentMethodCategory,
   getXenditAuthHeader,
   hmacSha256,
+  mapCategoryToDescriptorType,
   md5,
   minifyJson,
   normalizeIpaymuCallback,