bkash-client 0.0.0-stage → 0.1.0

package/dist/chunk-FXLW32P4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"chunk-FXLW32P4.js","sourcesContent":["/**\n * @bkash/client\n * Universal, headless client SDK for bKash payment integrations.\n */\n\nexport type BkashClientState =\n  | 'idle'\n  | 'creating'\n  | 'awaiting_user'\n  | 'verifying'\n  | 'success'\n  | 'pending'\n  | 'cancelled'\n  | 'timeout'\n  | 'offline'\n  | 'error';\n\nexport interface BkashClientOptions {\n  /**\n   * Endpoint on merchant backend to create payment session.\n   * Defaults to \"/api/bkash/create\".\n   */\n  createUrl?: string;\n  /**\n   * Callback URL registered with merchant backend.\n   */\n  callbackUrl?: string;\n  /**\n   * Hook triggered on state transition.\n   */\n  onStateChange?: (state: BkashClientState) => void;\n  /**\n   * Hook triggered when payment completes successfully.\n   */\n  onSuccess?: (paymentId: string) => void;\n  /**\n   * Hook triggered on payment error.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Hook triggered if user cancels payment.\n   */\n  onCancel?: () => void;\n}\n\n/**\n * All fields are optional hints. bkash-server decides the amount and invoice from its own\n * data and ignores any amount or invoice sent from the browser.\n */\nexport interface InitiateCheckoutParams {\n  amount?: number | string;\n  invoiceNumber?: string;\n  orderId?: string;\n  payerReference?: string;\n  metadata?: Record<string, string>;\n}\n\nexport class BkashClient {\n  private state: BkashClientState = 'idle';\n  private options: BkashClientOptions;\n  private currentPaymentId: string | null = null;\n  private listeners = new Set<(state: BkashClientState) => void>();\n\n  constructor(options?: BkashClientOptions) {\n    this.options = {\n      createUrl: '/api/bkash/create',\n      ...options,\n    };\n  }\n\n  public getState(): BkashClientState {\n    return this.state;\n  }\n\n  public getPaymentId(): string | null {\n    return this.currentPaymentId;\n  }\n\n  /**\n   * Returns human-readable UI guidance for the current client state.\n   * Specifically guarantees that unknown or timed-out outcomes are presented as\n   * \"payment pending, do not pay again\" rather than a false failure.\n   */\n  public getStateMessage(): string {\n    switch (this.state) {\n      case 'idle':\n        return 'Ready to initiate checkout.';\n      case 'creating':\n        return 'Initializing payment session with bKash...';\n      case 'awaiting_user':\n        return 'Redirecting to bKash secure payment page...';\n      case 'verifying':\n        return 'Verifying payment with bKash...';\n      case 'success':\n        return 'Payment completed successfully!';\n      case 'pending':\n      case 'timeout':\n        return 'Payment pending, do not pay again. Please wait while your transaction is reconciled with bKash.';\n      case 'cancelled':\n        return 'Payment was cancelled.';\n      case 'offline':\n        return 'Device is offline. Please check your internet connection before retrying.';\n      case 'error':\n        return 'An error occurred during checkout.';\n      default:\n        return '';\n    }\n  }\n\n  public subscribe(listener: (state: BkashClientState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  public cancel(): void {\n    this.setState('cancelled');\n    this.options.onCancel?.();\n  }\n\n  public setPending(paymentId?: string): void {\n    if (paymentId) this.currentPaymentId = paymentId;\n    this.setState('pending');\n  }\n\n  private setState(newState: BkashClientState): void {\n    this.state = newState;\n    this.options.onStateChange?.(newState);\n    this.listeners.forEach((fn) => fn(newState));\n  }\n\n  /**\n   * Initiates payment flow by calling the merchant backend,\n   * obtaining the gateway URL, and redirecting the customer.\n   */\n  public async checkout(params: InitiateCheckoutParams = {}): Promise<void> {\n    // Offline pre-check\n    if (typeof navigator !== 'undefined' && navigator.onLine === false) {\n      this.setState('offline');\n      const offlineErr = new Error('Device is offline. Please check your internet connection.');\n      this.options.onError?.(offlineErr);\n      throw offlineErr;\n    }\n\n    try {\n      this.setState('creating');\n\n      const defaultCallback = typeof window !== 'undefined' ? window.location?.href : '';\n      const res = await fetch(this.options.createUrl!, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          amount: params.amount,\n          invoiceNumber: params.invoiceNumber,\n          orderId: params.orderId,\n          callbackUrl: this.options.callbackUrl || defaultCallback,\n          payerReference: params.payerReference,\n          metadata: params.metadata,\n        }),\n      });\n\n      if (!res.ok) {\n        throw new Error(`Failed to create payment session: HTTP ${res.status}`);\n      }\n\n      const data = (await res.json()) as {\n        redirectUrl?: string;\n        paymentId?: string;\n        error?: string;\n      };\n      if (!data.redirectUrl || !data.paymentId) {\n        throw new Error(data.error || 'Invalid session response from payment server.');\n      }\n\n      this.currentPaymentId = data.paymentId;\n      this.setState('awaiting_user');\n\n      // Launch bKash Hosted Checkout\n      if (typeof window !== 'undefined' && window.location) {\n        window.location.href = data.redirectUrl;\n      }\n    } catch (err: unknown) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      const isTimeout =\n        error.name === 'AbortError' ||\n        error.name === 'TimeoutError' ||\n        /timeout|abort/i.test(error.message);\n\n      if (isTimeout) {\n        // Under AUD-08: timeout / unknown outcome MUST display pending (\"do not pay again\")\n        this.setState('pending');\n      } else {\n        this.setState('error');\n      }\n\n      this.options.onError?.(error);\n      throw error;\n    }\n  }\n\n  public reset(): void {\n    this.currentPaymentId = null;\n    this.setState('idle');\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+// src/index.ts
+var BkashClient = class {
+  state = "idle";
+  options;
+  currentPaymentId = null;
+  listeners = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this.options = {
+      createUrl: "/api/bkash/create",
+      ...options
+    };
+  }
+  getState() {
+    return this.state;
+  }
+  getPaymentId() {
+    return this.currentPaymentId;
+  }
+  /**
+   * Returns human-readable UI guidance for the current client state.
+   * Specifically guarantees that unknown or timed-out outcomes are presented as
+   * "payment pending, do not pay again" rather than a false failure.
+   */
+  getStateMessage() {
+    switch (this.state) {
+      case "idle":
+        return "Ready to initiate checkout.";
+      case "creating":
+        return "Initializing payment session with bKash...";
+      case "awaiting_user":
+        return "Redirecting to bKash secure payment page...";
+      case "verifying":
+        return "Verifying payment with bKash...";
+      case "success":
+        return "Payment completed successfully!";
+      case "pending":
+      case "timeout":
+        return "Payment pending, do not pay again. Please wait while your transaction is reconciled with bKash.";
+      case "cancelled":
+        return "Payment was cancelled.";
+      case "offline":
+        return "Device is offline. Please check your internet connection before retrying.";
+      case "error":
+        return "An error occurred during checkout.";
+      default:
+        return "";
+    }
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  cancel() {
+    this.setState("cancelled");
+    this.options.onCancel?.();
+  }
+  setPending(paymentId) {
+    if (paymentId) this.currentPaymentId = paymentId;
+    this.setState("pending");
+  }
+  setState(newState) {
+    this.state = newState;
+    this.options.onStateChange?.(newState);
+    this.listeners.forEach((fn) => fn(newState));
+  }
+  /**
+   * Initiates payment flow by calling the merchant backend,
+   * obtaining the gateway URL, and redirecting the customer.
+   */
+  async checkout(params = {}) {
+    if (typeof navigator !== "undefined" && navigator.onLine === false) {
+      this.setState("offline");
+      const offlineErr = new Error("Device is offline. Please check your internet connection.");
+      this.options.onError?.(offlineErr);
+      throw offlineErr;
+    }
+    try {
+      this.setState("creating");
+      const defaultCallback = typeof window !== "undefined" ? window.location?.href : "";
+      const res = await fetch(this.options.createUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          amount: params.amount,
+          invoiceNumber: params.invoiceNumber,
+          orderId: params.orderId,
+          callbackUrl: this.options.callbackUrl || defaultCallback,
+          payerReference: params.payerReference,
+          metadata: params.metadata
+        })
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to create payment session: HTTP ${res.status}`);
+      }
+      const data = await res.json();
+      if (!data.redirectUrl || !data.paymentId) {
+        throw new Error(data.error || "Invalid session response from payment server.");
+      }
+      this.currentPaymentId = data.paymentId;
+      this.setState("awaiting_user");
+      if (typeof window !== "undefined" && window.location) {
+        window.location.href = data.redirectUrl;
+      }
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      const isTimeout = error.name === "AbortError" || error.name === "TimeoutError" || /timeout|abort/i.test(error.message);
+      if (isTimeout) {
+        this.setState("pending");
+      } else {
+        this.setState("error");
+      }
+      this.options.onError?.(error);
+      throw error;
+    }
+  }
+  reset() {
+    this.currentPaymentId = null;
+    this.setState("idle");
+  }
+};
+
+exports.BkashClient = BkashClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAyDO,IAAM,cAAN,MAAkB;AAAA,EACf,KAAA,GAA0B,MAAA;AAAA,EAC1B,OAAA;AAAA,EACA,gBAAA,GAAkC,IAAA;AAAA,EAClC,SAAA,uBAAgB,GAAA,EAAuC;AAAA,EAE/D,YAAY,OAAA,EAA8B;AACxC,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,SAAA,EAAW,mBAAA;AAAA,MACX,GAAG;AAAA,KACL;AAAA,EACF;AAAA,EAEO,QAAA,GAA6B;AAClC,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,EACd;AAAA,EAEO,YAAA,GAA8B;AACnC,IAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,eAAA,GAA0B;AAC/B,IAAA,QAAQ,KAAK,KAAA;AAAO,MAClB,KAAK,MAAA;AACH,QAAA,OAAO,6BAAA;AAAA,MACT,KAAK,UAAA;AACH,QAAA,OAAO,4CAAA;AAAA,MACT,KAAK,eAAA;AACH,QAAA,OAAO,6CAAA;AAAA,MACT,KAAK,WAAA;AACH,QAAA,OAAO,iCAAA;AAAA,MACT,KAAK,SAAA;AACH,QAAA,OAAO,iCAAA;AAAA,MACT,KAAK,SAAA;AAAA,MACL,KAAK,SAAA;AACH,QAAA,OAAO,iGAAA;AAAA,MACT,KAAK,WAAA;AACH,QAAA,OAAO,wBAAA;AAAA,MACT,KAAK,SAAA;AACH,QAAA,OAAO,2EAAA;AAAA,MACT,KAAK,OAAA;AACH,QAAA,OAAO,oCAAA;AAAA,MACT;AACE,QAAA,OAAO,EAAA;AAAA;AACX,EACF;AAAA,EAEO,UAAU,QAAA,EAAyD;AACxE,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAQ,CAAA;AAC3B,IAAA,OAAO,MAAM,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA;AAAA,EAC7C;AAAA,EAEO,MAAA,GAAe;AACpB,IAAA,IAAA,CAAK,SAAS,WAAW,CAAA;AACzB,IAAA,IAAA,CAAK,QAAQ,QAAA,IAAW;AAAA,EAC1B;AAAA,EAEO,WAAW,SAAA,EAA0B;AAC1C,IAAA,IAAI,SAAA,OAAgB,gBAAA,GAAmB,SAAA;AACvC,IAAA,IAAA,CAAK,SAAS,SAAS,CAAA;AAAA,EACzB;AAAA,EAEQ,SAAS,QAAA,EAAkC;AACjD,IAAA,IAAA,CAAK,KAAA,GAAQ,QAAA;AACb,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAgB,QAAQ,CAAA;AACrC,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,QAAQ,CAAC,CAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAa,QAAA,CAAS,MAAA,GAAiC,EAAC,EAAkB;AAExE,IAAA,IAAI,OAAO,SAAA,KAAc,WAAA,IAAe,SAAA,CAAU,WAAW,KAAA,EAAO;AAClE,MAAA,IAAA,CAAK,SAAS,SAAS,CAAA;AACvB,MAAA,MAAM,UAAA,GAAa,IAAI,KAAA,CAAM,2DAA2D,CAAA;AACxF,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,UAAU,CAAA;AACjC,MAAA,MAAM,UAAA;AAAA,IACR;AAEA,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,SAAS,UAAU,CAAA;AAExB,MAAA,MAAM,kBAAkB,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,UAAU,IAAA,GAAO,EAAA;AAChF,MAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,IAAA,CAAK,QAAQ,SAAA,EAAY;AAAA,QAC/C,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,QAC9C,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,UACnB,QAAQ,MAAA,CAAO,MAAA;AAAA,UACf,eAAe,MAAA,CAAO,aAAA;AAAA,UACtB,SAAS,MAAA,CAAO,OAAA;AAAA,UAChB,WAAA,EAAa,IAAA,CAAK,OAAA,CAAQ,WAAA,IAAe,eAAA;AAAA,UACzC,gBAAgB,MAAA,CAAO,cAAA;AAAA,UACvB,UAAU,MAAA,CAAO;AAAA,SAClB;AAAA,OACF,CAAA;AAED,MAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,uCAAA,EAA0C,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AAAA,MACxE;AAEA,MAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,EAAK;AAK7B,MAAA,IAAI,CAAC,IAAA,CAAK,WAAA,IAAe,CAAC,KAAK,SAAA,EAAW;AACxC,QAAA,MAAM,IAAI,KAAA,CAAM,IAAA,CAAK,KAAA,IAAS,+CAA+C,CAAA;AAAA,MAC/E;AAEA,MAAA,IAAA,CAAK,mBAAmB,IAAA,CAAK,SAAA;AAC7B,MAAA,IAAA,CAAK,SAAS,eAAe,CAAA;AAG7B,MAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,QAAA,EAAU;AACpD,QAAA,MAAA,CAAO,QAAA,CAAS,OAAO,IAAA,CAAK,WAAA;AAAA,MAC9B;AAAA,IACF,SAAS,GAAA,EAAc;AACrB,MAAA,MAAM,KAAA,GAAQ,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAChE,MAAA,MAAM,SAAA,GACJ,KAAA,CAAM,IAAA,KAAS,YAAA,IACf,KAAA,CAAM,SAAS,cAAA,IACf,gBAAA,CAAiB,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA;AAErC,MAAA,IAAI,SAAA,EAAW;AAEb,QAAA,IAAA,CAAK,SAAS,SAAS,CAAA;AAAA,MACzB,CAAA,MAAO;AACL,QAAA,IAAA,CAAK,SAAS,OAAO,CAAA;AAAA,MACvB;AAEA,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,KAAK,CAAA;AAC5B,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA,EAEO,KAAA,GAAc;AACnB,IAAA,IAAA,CAAK,gBAAA,GAAmB,IAAA;AACxB,IAAA,IAAA,CAAK,SAAS,MAAM,CAAA;AAAA,EACtB;AACF","file":"index.cjs","sourcesContent":["/**\n * @bkash/client\n * Universal, headless client SDK for bKash payment integrations.\n */\n\nexport type BkashClientState =\n  | 'idle'\n  | 'creating'\n  | 'awaiting_user'\n  | 'verifying'\n  | 'success'\n  | 'pending'\n  | 'cancelled'\n  | 'timeout'\n  | 'offline'\n  | 'error';\n\nexport interface BkashClientOptions {\n  /**\n   * Endpoint on merchant backend to create payment session.\n   * Defaults to \"/api/bkash/create\".\n   */\n  createUrl?: string;\n  /**\n   * Callback URL registered with merchant backend.\n   */\n  callbackUrl?: string;\n  /**\n   * Hook triggered on state transition.\n   */\n  onStateChange?: (state: BkashClientState) => void;\n  /**\n   * Hook triggered when payment completes successfully.\n   */\n  onSuccess?: (paymentId: string) => void;\n  /**\n   * Hook triggered on payment error.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Hook triggered if user cancels payment.\n   */\n  onCancel?: () => void;\n}\n\n/**\n * All fields are optional hints. bkash-server decides the amount and invoice from its own\n * data and ignores any amount or invoice sent from the browser.\n */\nexport interface InitiateCheckoutParams {\n  amount?: number | string;\n  invoiceNumber?: string;\n  orderId?: string;\n  payerReference?: string;\n  metadata?: Record<string, string>;\n}\n\nexport class BkashClient {\n  private state: BkashClientState = 'idle';\n  private options: BkashClientOptions;\n  private currentPaymentId: string | null = null;\n  private listeners = new Set<(state: BkashClientState) => void>();\n\n  constructor(options?: BkashClientOptions) {\n    this.options = {\n      createUrl: '/api/bkash/create',\n      ...options,\n    };\n  }\n\n  public getState(): BkashClientState {\n    return this.state;\n  }\n\n  public getPaymentId(): string | null {\n    return this.currentPaymentId;\n  }\n\n  /**\n   * Returns human-readable UI guidance for the current client state.\n   * Specifically guarantees that unknown or timed-out outcomes are presented as\n   * \"payment pending, do not pay again\" rather than a false failure.\n   */\n  public getStateMessage(): string {\n    switch (this.state) {\n      case 'idle':\n        return 'Ready to initiate checkout.';\n      case 'creating':\n        return 'Initializing payment session with bKash...';\n      case 'awaiting_user':\n        return 'Redirecting to bKash secure payment page...';\n      case 'verifying':\n        return 'Verifying payment with bKash...';\n      case 'success':\n        return 'Payment completed successfully!';\n      case 'pending':\n      case 'timeout':\n        return 'Payment pending, do not pay again. Please wait while your transaction is reconciled with bKash.';\n      case 'cancelled':\n        return 'Payment was cancelled.';\n      case 'offline':\n        return 'Device is offline. Please check your internet connection before retrying.';\n      case 'error':\n        return 'An error occurred during checkout.';\n      default:\n        return '';\n    }\n  }\n\n  public subscribe(listener: (state: BkashClientState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  public cancel(): void {\n    this.setState('cancelled');\n    this.options.onCancel?.();\n  }\n\n  public setPending(paymentId?: string): void {\n    if (paymentId) this.currentPaymentId = paymentId;\n    this.setState('pending');\n  }\n\n  private setState(newState: BkashClientState): void {\n    this.state = newState;\n    this.options.onStateChange?.(newState);\n    this.listeners.forEach((fn) => fn(newState));\n  }\n\n  /**\n   * Initiates payment flow by calling the merchant backend,\n   * obtaining the gateway URL, and redirecting the customer.\n   */\n  public async checkout(params: InitiateCheckoutParams = {}): Promise<void> {\n    // Offline pre-check\n    if (typeof navigator !== 'undefined' && navigator.onLine === false) {\n      this.setState('offline');\n      const offlineErr = new Error('Device is offline. Please check your internet connection.');\n      this.options.onError?.(offlineErr);\n      throw offlineErr;\n    }\n\n    try {\n      this.setState('creating');\n\n      const defaultCallback = typeof window !== 'undefined' ? window.location?.href : '';\n      const res = await fetch(this.options.createUrl!, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          amount: params.amount,\n          invoiceNumber: params.invoiceNumber,\n          orderId: params.orderId,\n          callbackUrl: this.options.callbackUrl || defaultCallback,\n          payerReference: params.payerReference,\n          metadata: params.metadata,\n        }),\n      });\n\n      if (!res.ok) {\n        throw new Error(`Failed to create payment session: HTTP ${res.status}`);\n      }\n\n      const data = (await res.json()) as {\n        redirectUrl?: string;\n        paymentId?: string;\n        error?: string;\n      };\n      if (!data.redirectUrl || !data.paymentId) {\n        throw new Error(data.error || 'Invalid session response from payment server.');\n      }\n\n      this.currentPaymentId = data.paymentId;\n      this.setState('awaiting_user');\n\n      // Launch bKash Hosted Checkout\n      if (typeof window !== 'undefined' && window.location) {\n        window.location.href = data.redirectUrl;\n      }\n    } catch (err: unknown) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      const isTimeout =\n        error.name === 'AbortError' ||\n        error.name === 'TimeoutError' ||\n        /timeout|abort/i.test(error.message);\n\n      if (isTimeout) {\n        // Under AUD-08: timeout / unknown outcome MUST display pending (\"do not pay again\")\n        this.setState('pending');\n      } else {\n        this.setState('error');\n      }\n\n      this.options.onError?.(error);\n      throw error;\n    }\n  }\n\n  public reset(): void {\n    this.currentPaymentId = null;\n    this.setState('idle');\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,70 @@
+/**
+ * @bkash/client
+ * Universal, headless client SDK for bKash payment integrations.
+ */
+type BkashClientState = 'idle' | 'creating' | 'awaiting_user' | 'verifying' | 'success' | 'pending' | 'cancelled' | 'timeout' | 'offline' | 'error';
+interface BkashClientOptions {
+    /**
+     * Endpoint on merchant backend to create payment session.
+     * Defaults to "/api/bkash/create".
+     */
+    createUrl?: string;
+    /**
+     * Callback URL registered with merchant backend.
+     */
+    callbackUrl?: string;
+    /**
+     * Hook triggered on state transition.
+     */
+    onStateChange?: (state: BkashClientState) => void;
+    /**
+     * Hook triggered when payment completes successfully.
+     */
+    onSuccess?: (paymentId: string) => void;
+    /**
+     * Hook triggered on payment error.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Hook triggered if user cancels payment.
+     */
+    onCancel?: () => void;
+}
+/**
+ * All fields are optional hints. bkash-server decides the amount and invoice from its own
+ * data and ignores any amount or invoice sent from the browser.
+ */
+interface InitiateCheckoutParams {
+    amount?: number | string;
+    invoiceNumber?: string;
+    orderId?: string;
+    payerReference?: string;
+    metadata?: Record<string, string>;
+}
+declare class BkashClient {
+    private state;
+    private options;
+    private currentPaymentId;
+    private listeners;
+    constructor(options?: BkashClientOptions);
+    getState(): BkashClientState;
+    getPaymentId(): string | null;
+    /**
+     * Returns human-readable UI guidance for the current client state.
+     * Specifically guarantees that unknown or timed-out outcomes are presented as
+     * "payment pending, do not pay again" rather than a false failure.
+     */
+    getStateMessage(): string;
+    subscribe(listener: (state: BkashClientState) => void): () => void;
+    cancel(): void;
+    setPending(paymentId?: string): void;
+    private setState;
+    /**
+     * Initiates payment flow by calling the merchant backend,
+     * obtaining the gateway URL, and redirecting the customer.
+     */
+    checkout(params?: InitiateCheckoutParams): Promise<void>;
+    reset(): void;
+}
+
+export { BkashClient, type BkashClientOptions, type BkashClientState, type InitiateCheckoutParams };

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @bkash/client
+ * Universal, headless client SDK for bKash payment integrations.
+ */
+type BkashClientState = 'idle' | 'creating' | 'awaiting_user' | 'verifying' | 'success' | 'pending' | 'cancelled' | 'timeout' | 'offline' | 'error';
+interface BkashClientOptions {
+    /**
+     * Endpoint on merchant backend to create payment session.
+     * Defaults to "/api/bkash/create".
+     */
+    createUrl?: string;
+    /**
+     * Callback URL registered with merchant backend.
+     */
+    callbackUrl?: string;
+    /**
+     * Hook triggered on state transition.
+     */
+    onStateChange?: (state: BkashClientState) => void;
+    /**
+     * Hook triggered when payment completes successfully.
+     */
+    onSuccess?: (paymentId: string) => void;
+    /**
+     * Hook triggered on payment error.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Hook triggered if user cancels payment.
+     */
+    onCancel?: () => void;
+}
+/**
+ * All fields are optional hints. bkash-server decides the amount and invoice from its own
+ * data and ignores any amount or invoice sent from the browser.
+ */
+interface InitiateCheckoutParams {
+    amount?: number | string;
+    invoiceNumber?: string;
+    orderId?: string;
+    payerReference?: string;
+    metadata?: Record<string, string>;
+}
+declare class BkashClient {
+    private state;
+    private options;
+    private currentPaymentId;
+    private listeners;
+    constructor(options?: BkashClientOptions);
+    getState(): BkashClientState;
+    getPaymentId(): string | null;
+    /**
+     * Returns human-readable UI guidance for the current client state.
+     * Specifically guarantees that unknown or timed-out outcomes are presented as
+     * "payment pending, do not pay again" rather than a false failure.
+     */
+    getStateMessage(): string;
+    subscribe(listener: (state: BkashClientState) => void): () => void;
+    cancel(): void;
+    setPending(paymentId?: string): void;
+    private setState;
+    /**
+     * Initiates payment flow by calling the merchant backend,
+     * obtaining the gateway URL, and redirecting the customer.
+     */
+    checkout(params?: InitiateCheckoutParams): Promise<void>;
+    reset(): void;
+}
+
+export { BkashClient, type BkashClientOptions, type BkashClientState, type InitiateCheckoutParams };

package/dist/index.js

@@ -0,0 +1,4 @@
+export { BkashClient } from './chunk-FXLW32P4.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/react-native.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+var react = require('react');
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var cachedWebView = null;
+var attemptedRequire = false;
+function resolveWebView() {
+  if (attemptedRequire) return cachedWebView;
+  attemptedRequire = true;
+  try {
+    const rnw = typeof __require !== "undefined" ? __require("react-native-webview") : null;
+    cachedWebView = rnw?.WebView || rnw?.default || rnw;
+  } catch {
+    cachedWebView = null;
+  }
+  return cachedWebView;
+}
+function BkashCheckout({
+  redirectUrl,
+  callbackUrl,
+  onSuccess,
+  onCancel,
+  onError,
+  WebViewComponent
+}) {
+  const Component = WebViewComponent || resolveWebView();
+  if (!Component) {
+    throw new Error(
+      'BkashCheckout requires "react-native-webview" to render in React Native / Expo. Please install it by running:\n  npx expo install react-native-webview\nor\n  npm install react-native-webview\nAlternatively, pass your WebView component via the WebViewComponent prop.'
+    );
+  }
+  const webViewRef = react.useRef(null);
+  const handleNavigationStateChange = (navState) => {
+    const { url } = navState;
+    if (url.startsWith(callbackUrl)) {
+      try {
+        const parsed = new URL(url);
+        const status = parsed.searchParams.get("status");
+        const paymentId = parsed.searchParams.get("paymentID") || parsed.searchParams.get("paymentId");
+        if (status === "cancel") {
+          onCancel?.();
+        } else if (status === "failure") {
+          onError?.(new Error("bKash payment failed."));
+        } else if (status === "success" && paymentId) {
+          onSuccess(paymentId);
+        }
+      } catch (err) {
+        onError?.(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  };
+  return react.createElement(Component, {
+    ref: webViewRef,
+    source: { uri: redirectUrl },
+    onNavigationStateChange: handleNavigationStateChange,
+    startInLoadingState: true
+  });
+}
+
+exports.BkashCheckout = BkashCheckout;
+//# sourceMappingURL=react-native.cjs.map
+//# sourceMappingURL=react-native.cjs.map

package/dist/react-native.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react-native.ts"],"names":["useRef","createElement"],"mappings":";;;;;;;;;;AAiBA,IAAI,aAAA,GAAqB,IAAA;AACzB,IAAI,gBAAA,GAAmB,KAAA;AAEvB,SAAS,cAAA,GAAiB;AACxB,EAAA,IAAI,kBAAkB,OAAO,aAAA;AAC7B,EAAA,gBAAA,GAAmB,IAAA;AACnB,EAAA,IAAI;AAEF,IAAA,MAAM,MAAM,OAAO,SAAA,KAAY,WAAA,GAAc,SAAA,CAAQ,sBAAsB,CAAA,GAAI,IAAA;AAC/E,IAAA,aAAA,GAAgB,GAAA,EAAK,OAAA,IAAW,GAAA,EAAK,OAAA,IAAW,GAAA;AAAA,EAClD,CAAA,CAAA,MAAQ;AACN,IAAA,aAAA,GAAgB,IAAA;AAAA,EAClB;AACA,EAAA,OAAO,aAAA;AACT;AASO,SAAS,aAAA,CAAc;AAAA,EAC5B,WAAA;AAAA,EACA,WAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAAuB;AACrB,EAAA,MAAM,SAAA,GAAY,oBAAoB,cAAA,EAAe;AAErD,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAMF;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAAaA,aAAY,IAAI,CAAA;AAEnC,EAAA,MAAM,2BAAA,GAA8B,CAAC,QAAA,KAA8B;AACjE,IAAA,MAAM,EAAE,KAAI,GAAI,QAAA;AAEhB,IAAA,IAAI,GAAA,CAAI,UAAA,CAAW,WAAW,CAAA,EAAG;AAC/B,MAAA,IAAI;AACF,QAAA,MAAM,MAAA,GAAS,IAAI,GAAA,CAAI,GAAG,CAAA;AAC1B,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,YAAA,CAAa,GAAA,CAAI,QAAQ,CAAA;AAC/C,QAAA,MAAM,SAAA,GACJ,OAAO,YAAA,CAAa,GAAA,CAAI,WAAW,CAAA,IAAK,MAAA,CAAO,YAAA,CAAa,GAAA,CAAI,WAAW,CAAA;AAE7E,QAAA,IAAI,WAAW,QAAA,EAAU;AACvB,UAAA,QAAA,IAAW;AAAA,QACb,CAAA,MAAA,IAAW,WAAW,SAAA,EAAW;AAC/B,UAAA,OAAA,GAAU,IAAI,KAAA,CAAM,uBAAuB,CAAC,CAAA;AAAA,QAC9C,CAAA,MAAA,IAAW,MAAA,KAAW,SAAA,IAAa,SAAA,EAAW;AAC5C,UAAA,SAAA,CAAU,SAAS,CAAA;AAAA,QACrB;AAAA,MACF,SAAS,GAAA,EAAc;AACrB,QAAA,OAAA,GAAU,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,MAC/D;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,OAAOC,oBAAc,SAAA,EAAW;AAAA,IAC9B,GAAA,EAAK,UAAA;AAAA,IACL,MAAA,EAAQ,EAAE,GAAA,EAAK,WAAA,EAAY;AAAA,IAC3B,uBAAA,EAAyB,2BAAA;AAAA,IACzB,mBAAA,EAAqB;AAAA,GACtB,CAAA;AACH","file":"react-native.cjs","sourcesContent":["import { createElement, useRef } from 'react';\n\nexport interface BkashCheckoutProps {\n  /** The checkout redirectUrl received from backend */\n  redirectUrl: string;\n  /** The expected callback URL prefix to intercept */\n  callbackUrl: string;\n  /** Hook called when callback redirect succeeds */\n  onSuccess: (paymentId: string) => void;\n  /** Hook called when user cancels */\n  onCancel?: () => void;\n  /** Hook called on error */\n  onError?: (error: Error) => void;\n  /** Optional WebView component (passed in or resolved from react-native-webview) */\n  WebViewComponent?: any;\n}\n\nlet cachedWebView: any = null;\nlet attemptedRequire = false;\n\nfunction resolveWebView() {\n  if (attemptedRequire) return cachedWebView;\n  attemptedRequire = true;\n  try {\n    // Attempt dynamic require in React Native / Expo environment\n    const rnw = typeof require !== 'undefined' ? require('react-native-webview') : null;\n    cachedWebView = rnw?.WebView || rnw?.default || rnw;\n  } catch {\n    cachedWebView = null;\n  }\n  return cachedWebView;\n}\n\n/**\n * React Native WebView Checkout wrapper with deep link and callback URL interception.\n * Works with Expo and React Native CLI.\n *\n * Automatically resolves `react-native-webview` from peer dependencies or accepts\n * an explicit `WebViewComponent` prop.\n */\nexport function BkashCheckout({\n  redirectUrl,\n  callbackUrl,\n  onSuccess,\n  onCancel,\n  onError,\n  WebViewComponent,\n}: BkashCheckoutProps) {\n  const Component = WebViewComponent || resolveWebView();\n\n  if (!Component) {\n    throw new Error(\n      'BkashCheckout requires \"react-native-webview\" to render in React Native / Expo. ' +\n      'Please install it by running:\\n' +\n      '  npx expo install react-native-webview\\n' +\n      'or\\n' +\n      '  npm install react-native-webview\\n' +\n      'Alternatively, pass your WebView component via the WebViewComponent prop.'\n    );\n  }\n\n  const webViewRef = useRef<any>(null);\n\n  const handleNavigationStateChange = (navState: { url: string }) => {\n    const { url } = navState;\n\n    if (url.startsWith(callbackUrl)) {\n      try {\n        const parsed = new URL(url);\n        const status = parsed.searchParams.get('status');\n        const paymentId =\n          parsed.searchParams.get('paymentID') || parsed.searchParams.get('paymentId');\n\n        if (status === 'cancel') {\n          onCancel?.();\n        } else if (status === 'failure') {\n          onError?.(new Error('bKash payment failed.'));\n        } else if (status === 'success' && paymentId) {\n          onSuccess(paymentId);\n        }\n      } catch (err: unknown) {\n        onError?.(err instanceof Error ? err : new Error(String(err)));\n      }\n    }\n  };\n\n  return createElement(Component, {\n    ref: webViewRef,\n    source: { uri: redirectUrl },\n    onNavigationStateChange: handleNavigationStateChange,\n    startInLoadingState: true,\n  });\n}\n"]}

package/dist/react-native.d.cts

@@ -0,0 +1,35 @@
+import * as react from 'react';
+
+interface BkashCheckoutProps {
+    /** The checkout redirectUrl received from backend */
+    redirectUrl: string;
+    /** The expected callback URL prefix to intercept */
+    callbackUrl: string;
+    /** Hook called when callback redirect succeeds */
+    onSuccess: (paymentId: string) => void;
+    /** Hook called when user cancels */
+    onCancel?: () => void;
+    /** Hook called on error */
+    onError?: (error: Error) => void;
+    /** Optional WebView component (passed in or resolved from react-native-webview) */
+    WebViewComponent?: any;
+}
+/**
+ * React Native WebView Checkout wrapper with deep link and callback URL interception.
+ * Works with Expo and React Native CLI.
+ *
+ * Automatically resolves `react-native-webview` from peer dependencies or accepts
+ * an explicit `WebViewComponent` prop.
+ */
+declare function BkashCheckout({ redirectUrl, callbackUrl, onSuccess, onCancel, onError, WebViewComponent, }: BkashCheckoutProps): react.CElement<{
+    ref: react.MutableRefObject<any>;
+    source: {
+        uri: string;
+    };
+    onNavigationStateChange: (navState: {
+        url: string;
+    }) => void;
+    startInLoadingState: boolean;
+}, any>;
+
+export { BkashCheckout, type BkashCheckoutProps };

package/dist/react-native.d.ts

@@ -0,0 +1,35 @@
+import * as react from 'react';
+
+interface BkashCheckoutProps {
+    /** The checkout redirectUrl received from backend */
+    redirectUrl: string;
+    /** The expected callback URL prefix to intercept */
+    callbackUrl: string;
+    /** Hook called when callback redirect succeeds */
+    onSuccess: (paymentId: string) => void;
+    /** Hook called when user cancels */
+    onCancel?: () => void;
+    /** Hook called on error */
+    onError?: (error: Error) => void;
+    /** Optional WebView component (passed in or resolved from react-native-webview) */
+    WebViewComponent?: any;
+}
+/**
+ * React Native WebView Checkout wrapper with deep link and callback URL interception.
+ * Works with Expo and React Native CLI.
+ *
+ * Automatically resolves `react-native-webview` from peer dependencies or accepts
+ * an explicit `WebViewComponent` prop.
+ */
+declare function BkashCheckout({ redirectUrl, callbackUrl, onSuccess, onCancel, onError, WebViewComponent, }: BkashCheckoutProps): react.CElement<{
+    ref: react.MutableRefObject<any>;
+    source: {
+        uri: string;
+    };
+    onNavigationStateChange: (navState: {
+        url: string;
+    }) => void;
+    startInLoadingState: boolean;
+}, any>;
+
+export { BkashCheckout, type BkashCheckoutProps };

package/dist/react-native.js

@@ -0,0 +1,61 @@
+import { __require } from './chunk-DGUM43GV.js';
+import { useRef, createElement } from 'react';
+
+var cachedWebView = null;
+var attemptedRequire = false;
+function resolveWebView() {
+  if (attemptedRequire) return cachedWebView;
+  attemptedRequire = true;
+  try {
+    const rnw = typeof __require !== "undefined" ? __require("react-native-webview") : null;
+    cachedWebView = rnw?.WebView || rnw?.default || rnw;
+  } catch {
+    cachedWebView = null;
+  }
+  return cachedWebView;
+}
+function BkashCheckout({
+  redirectUrl,
+  callbackUrl,
+  onSuccess,
+  onCancel,
+  onError,
+  WebViewComponent
+}) {
+  const Component = WebViewComponent || resolveWebView();
+  if (!Component) {
+    throw new Error(
+      'BkashCheckout requires "react-native-webview" to render in React Native / Expo. Please install it by running:\n  npx expo install react-native-webview\nor\n  npm install react-native-webview\nAlternatively, pass your WebView component via the WebViewComponent prop.'
+    );
+  }
+  const webViewRef = useRef(null);
+  const handleNavigationStateChange = (navState) => {
+    const { url } = navState;
+    if (url.startsWith(callbackUrl)) {
+      try {
+        const parsed = new URL(url);
+        const status = parsed.searchParams.get("status");
+        const paymentId = parsed.searchParams.get("paymentID") || parsed.searchParams.get("paymentId");
+        if (status === "cancel") {
+          onCancel?.();
+        } else if (status === "failure") {
+          onError?.(new Error("bKash payment failed."));
+        } else if (status === "success" && paymentId) {
+          onSuccess(paymentId);
+        }
+      } catch (err) {
+        onError?.(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  };
+  return createElement(Component, {
+    ref: webViewRef,
+    source: { uri: redirectUrl },
+    onNavigationStateChange: handleNavigationStateChange,
+    startInLoadingState: true
+  });
+}
+
+export { BkashCheckout };
+//# sourceMappingURL=react-native.js.map
+//# sourceMappingURL=react-native.js.map

package/dist/react-native.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react-native.ts"],"names":[],"mappings":";;;AAiBA,IAAI,aAAA,GAAqB,IAAA;AACzB,IAAI,gBAAA,GAAmB,KAAA;AAEvB,SAAS,cAAA,GAAiB;AACxB,EAAA,IAAI,kBAAkB,OAAO,aAAA;AAC7B,EAAA,gBAAA,GAAmB,IAAA;AACnB,EAAA,IAAI;AAEF,IAAA,MAAM,MAAM,OAAO,SAAA,KAAY,WAAA,GAAc,SAAA,CAAQ,sBAAsB,CAAA,GAAI,IAAA;AAC/E,IAAA,aAAA,GAAgB,GAAA,EAAK,OAAA,IAAW,GAAA,EAAK,OAAA,IAAW,GAAA;AAAA,EAClD,CAAA,CAAA,MAAQ;AACN,IAAA,aAAA,GAAgB,IAAA;AAAA,EAClB;AACA,EAAA,OAAO,aAAA;AACT;AASO,SAAS,aAAA,CAAc;AAAA,EAC5B,WAAA;AAAA,EACA,WAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAAuB;AACrB,EAAA,MAAM,SAAA,GAAY,oBAAoB,cAAA,EAAe;AAErD,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAMF;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAAa,OAAY,IAAI,CAAA;AAEnC,EAAA,MAAM,2BAAA,GAA8B,CAAC,QAAA,KAA8B;AACjE,IAAA,MAAM,EAAE,KAAI,GAAI,QAAA;AAEhB,IAAA,IAAI,GAAA,CAAI,UAAA,CAAW,WAAW,CAAA,EAAG;AAC/B,MAAA,IAAI;AACF,QAAA,MAAM,MAAA,GAAS,IAAI,GAAA,CAAI,GAAG,CAAA;AAC1B,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,YAAA,CAAa,GAAA,CAAI,QAAQ,CAAA;AAC/C,QAAA,MAAM,SAAA,GACJ,OAAO,YAAA,CAAa,GAAA,CAAI,WAAW,CAAA,IAAK,MAAA,CAAO,YAAA,CAAa,GAAA,CAAI,WAAW,CAAA;AAE7E,QAAA,IAAI,WAAW,QAAA,EAAU;AACvB,UAAA,QAAA,IAAW;AAAA,QACb,CAAA,MAAA,IAAW,WAAW,SAAA,EAAW;AAC/B,UAAA,OAAA,GAAU,IAAI,KAAA,CAAM,uBAAuB,CAAC,CAAA;AAAA,QAC9C,CAAA,MAAA,IAAW,MAAA,KAAW,SAAA,IAAa,SAAA,EAAW;AAC5C,UAAA,SAAA,CAAU,SAAS,CAAA;AAAA,QACrB;AAAA,MACF,SAAS,GAAA,EAAc;AACrB,QAAA,OAAA,GAAU,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,MAC/D;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,cAAc,SAAA,EAAW;AAAA,IAC9B,GAAA,EAAK,UAAA;AAAA,IACL,MAAA,EAAQ,EAAE,GAAA,EAAK,WAAA,EAAY;AAAA,IAC3B,uBAAA,EAAyB,2BAAA;AAAA,IACzB,mBAAA,EAAqB;AAAA,GACtB,CAAA;AACH","file":"react-native.js","sourcesContent":["import { createElement, useRef } from 'react';\n\nexport interface BkashCheckoutProps {\n  /** The checkout redirectUrl received from backend */\n  redirectUrl: string;\n  /** The expected callback URL prefix to intercept */\n  callbackUrl: string;\n  /** Hook called when callback redirect succeeds */\n  onSuccess: (paymentId: string) => void;\n  /** Hook called when user cancels */\n  onCancel?: () => void;\n  /** Hook called on error */\n  onError?: (error: Error) => void;\n  /** Optional WebView component (passed in or resolved from react-native-webview) */\n  WebViewComponent?: any;\n}\n\nlet cachedWebView: any = null;\nlet attemptedRequire = false;\n\nfunction resolveWebView() {\n  if (attemptedRequire) return cachedWebView;\n  attemptedRequire = true;\n  try {\n    // Attempt dynamic require in React Native / Expo environment\n    const rnw = typeof require !== 'undefined' ? require('react-native-webview') : null;\n    cachedWebView = rnw?.WebView || rnw?.default || rnw;\n  } catch {\n    cachedWebView = null;\n  }\n  return cachedWebView;\n}\n\n/**\n * React Native WebView Checkout wrapper with deep link and callback URL interception.\n * Works with Expo and React Native CLI.\n *\n * Automatically resolves `react-native-webview` from peer dependencies or accepts\n * an explicit `WebViewComponent` prop.\n */\nexport function BkashCheckout({\n  redirectUrl,\n  callbackUrl,\n  onSuccess,\n  onCancel,\n  onError,\n  WebViewComponent,\n}: BkashCheckoutProps) {\n  const Component = WebViewComponent || resolveWebView();\n\n  if (!Component) {\n    throw new Error(\n      'BkashCheckout requires \"react-native-webview\" to render in React Native / Expo. ' +\n      'Please install it by running:\\n' +\n      '  npx expo install react-native-webview\\n' +\n      'or\\n' +\n      '  npm install react-native-webview\\n' +\n      'Alternatively, pass your WebView component via the WebViewComponent prop.'\n    );\n  }\n\n  const webViewRef = useRef<any>(null);\n\n  const handleNavigationStateChange = (navState: { url: string }) => {\n    const { url } = navState;\n\n    if (url.startsWith(callbackUrl)) {\n      try {\n        const parsed = new URL(url);\n        const status = parsed.searchParams.get('status');\n        const paymentId =\n          parsed.searchParams.get('paymentID') || parsed.searchParams.get('paymentId');\n\n        if (status === 'cancel') {\n          onCancel?.();\n        } else if (status === 'failure') {\n          onError?.(new Error('bKash payment failed.'));\n        } else if (status === 'success' && paymentId) {\n          onSuccess(paymentId);\n        }\n      } catch (err: unknown) {\n        onError?.(err instanceof Error ? err : new Error(String(err)));\n      }\n    }\n  };\n\n  return createElement(Component, {\n    ref: webViewRef,\n    source: { uri: redirectUrl },\n    onNavigationStateChange: handleNavigationStateChange,\n    startInLoadingState: true,\n  });\n}\n"]}