bkash-client 0.0.0-stage → 0.1.0

package/dist/react.cjs

@@ -0,0 +1,190 @@
+'use strict';
+
+var react = require('react');
+
+// src/react.ts
+
+// 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");
+  }
+};
+
+// src/react.ts
+function useBkash(options) {
+  const [client] = react.useState(() => new BkashClient(options));
+  const [state, setState] = react.useState(client.getState());
+  const [error, setError] = react.useState(null);
+  react.useEffect(() => {
+    return client.subscribe((newState) => setState(newState));
+  }, [client]);
+  const checkout = react.useCallback(
+    async (params) => {
+      setError(null);
+      try {
+        await client.checkout(params);
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [client]
+  );
+  const reset = react.useCallback(() => {
+    setError(null);
+    client.reset();
+  }, [client]);
+  return {
+    state,
+    error,
+    paymentId: client.getPaymentId(),
+    checkout,
+    reset,
+    client
+  };
+}
+function BkashButton({
+  amount,
+  invoiceNumber,
+  orderId,
+  options,
+  className,
+  children
+}) {
+  const { state, checkout } = useBkash(options);
+  const handleClick = async () => {
+    if (state === "creating") return;
+    await checkout({ amount, invoiceNumber, orderId });
+  };
+  return react.createElement(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: state === "creating",
+      className: className || "bkash-pay-btn"
+    },
+    children || (state === "creating" ? "Connecting to bKash..." : "Pay with bKash")
+  );
+}
+
+exports.BkashButton = BkashButton;
+exports.useBkash = useBkash;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/react.ts"],"names":["useState","useEffect","useCallback","createElement"],"mappings":"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","file":"react.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","import { useState, useEffect, useCallback, createElement } from 'react';\nimport {\n  BkashClient,\n  type BkashClientOptions,\n  type BkashClientState,\n  type InitiateCheckoutParams,\n} from './index.js';\n\nexport function useBkash(options?: BkashClientOptions) {\n  const [client] = useState(() => new BkashClient(options));\n  const [state, setState] = useState<BkashClientState>(client.getState());\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    return client.subscribe((newState) => setState(newState));\n  }, [client]);\n\n  const checkout = useCallback(\n    async (params: InitiateCheckoutParams) => {\n      setError(null);\n      try {\n        await client.checkout(params);\n      } catch (err: unknown) {\n        const errorObj = err instanceof Error ? err : new Error(String(err));\n        setError(errorObj);\n        throw errorObj;\n      }\n    },\n    [client]\n  );\n\n  const reset = useCallback(() => {\n    setError(null);\n    client.reset();\n  }, [client]);\n\n  return {\n    state,\n    error,\n    paymentId: client.getPaymentId(),\n    checkout,\n    reset,\n    client,\n  };\n}\n\nexport interface BkashButtonProps {\n  amount?: number | string;\n  invoiceNumber?: string;\n  orderId?: string;\n  options?: BkashClientOptions;\n  className?: string;\n  children?: any;\n}\n\nexport function BkashButton({\n  amount,\n  invoiceNumber,\n  orderId,\n  options,\n  className,\n  children,\n}: BkashButtonProps) {\n  const { state, checkout } = useBkash(options);\n\n  const handleClick = async () => {\n    if (state === 'creating') return;\n    await checkout({ amount, invoiceNumber, orderId });\n  };\n\n  return createElement(\n    'button',\n    {\n      type: 'button',\n      onClick: handleClick,\n      disabled: state === 'creating',\n      className: className || 'bkash-pay-btn',\n    },\n    children || (state === 'creating' ? 'Connecting to bKash...' : 'Pay with bKash')\n  );\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,27 @@
+import * as react from 'react';
+import { BkashClientOptions, BkashClientState, InitiateCheckoutParams, BkashClient } from './index.cjs';
+
+declare function useBkash(options?: BkashClientOptions): {
+    state: BkashClientState;
+    error: Error | null;
+    paymentId: string | null;
+    checkout: (params: InitiateCheckoutParams) => Promise<void>;
+    reset: () => void;
+    client: BkashClient;
+};
+interface BkashButtonProps {
+    amount?: number | string;
+    invoiceNumber?: string;
+    orderId?: string;
+    options?: BkashClientOptions;
+    className?: string;
+    children?: any;
+}
+declare function BkashButton({ amount, invoiceNumber, orderId, options, className, children, }: BkashButtonProps): react.DetailedReactHTMLElement<{
+    type: string;
+    onClick: () => Promise<void>;
+    disabled: boolean;
+    className: string;
+}, HTMLElement>;
+
+export { BkashButton, type BkashButtonProps, useBkash };

package/dist/react.d.ts

@@ -0,0 +1,27 @@
+import * as react from 'react';
+import { BkashClientOptions, BkashClientState, InitiateCheckoutParams, BkashClient } from './index.js';
+
+declare function useBkash(options?: BkashClientOptions): {
+    state: BkashClientState;
+    error: Error | null;
+    paymentId: string | null;
+    checkout: (params: InitiateCheckoutParams) => Promise<void>;
+    reset: () => void;
+    client: BkashClient;
+};
+interface BkashButtonProps {
+    amount?: number | string;
+    invoiceNumber?: string;
+    orderId?: string;
+    options?: BkashClientOptions;
+    className?: string;
+    children?: any;
+}
+declare function BkashButton({ amount, invoiceNumber, orderId, options, className, children, }: BkashButtonProps): react.DetailedReactHTMLElement<{
+    type: string;
+    onClick: () => Promise<void>;
+    disabled: boolean;
+    className: string;
+}, HTMLElement>;
+
+export { BkashButton, type BkashButtonProps, useBkash };

package/dist/react.js

@@ -0,0 +1,65 @@
+import { BkashClient } from './chunk-FXLW32P4.js';
+import './chunk-DGUM43GV.js';
+import { useState, useEffect, useCallback, createElement } from 'react';
+
+function useBkash(options) {
+  const [client] = useState(() => new BkashClient(options));
+  const [state, setState] = useState(client.getState());
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    return client.subscribe((newState) => setState(newState));
+  }, [client]);
+  const checkout = useCallback(
+    async (params) => {
+      setError(null);
+      try {
+        await client.checkout(params);
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [client]
+  );
+  const reset = useCallback(() => {
+    setError(null);
+    client.reset();
+  }, [client]);
+  return {
+    state,
+    error,
+    paymentId: client.getPaymentId(),
+    checkout,
+    reset,
+    client
+  };
+}
+function BkashButton({
+  amount,
+  invoiceNumber,
+  orderId,
+  options,
+  className,
+  children
+}) {
+  const { state, checkout } = useBkash(options);
+  const handleClick = async () => {
+    if (state === "creating") return;
+    await checkout({ amount, invoiceNumber, orderId });
+  };
+  return createElement(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: state === "creating",
+      className: className || "bkash-pay-btn"
+    },
+    children || (state === "creating" ? "Connecting to bKash..." : "Pay with bKash")
+  );
+}
+
+export { BkashButton, useBkash };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"names":[],"mappings":";;;;AAQO,SAAS,SAAS,OAAA,EAA8B;AACrD,EAAA,MAAM,CAAC,MAAM,CAAA,GAAI,QAAA,CAAS,MAAM,IAAI,WAAA,CAAY,OAAO,CAAC,CAAA;AACxD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAI,QAAA,CAA2B,MAAA,CAAO,UAAU,CAAA;AACtE,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAuB,IAAI,CAAA;AAErD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,OAAO,OAAO,SAAA,CAAU,CAAC,QAAA,KAAa,QAAA,CAAS,QAAQ,CAAC,CAAA;AAAA,EAC1D,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,QAAA,GAAW,WAAA;AAAA,IACf,OAAO,MAAA,KAAmC;AACxC,MAAA,QAAA,CAAS,IAAI,CAAA;AACb,MAAA,IAAI;AACF,QAAA,MAAM,MAAA,CAAO,SAAS,MAAM,CAAA;AAAA,MAC9B,SAAS,GAAA,EAAc;AACrB,QAAA,MAAM,QAAA,GAAW,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AACnE,QAAA,QAAA,CAAS,QAAQ,CAAA;AACjB,QAAA,MAAM,QAAA;AAAA,MACR;AAAA,IACF,CAAA;AAAA,IACA,CAAC,MAAM;AAAA,GACT;AAEA,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,QAAA,CAAS,IAAI,CAAA;AACb,IAAA,MAAA,CAAO,KAAA,EAAM;AAAA,EACf,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,KAAA;AAAA,IACA,SAAA,EAAW,OAAO,YAAA,EAAa;AAAA,IAC/B,QAAA;AAAA,IACA,KAAA;AAAA,IACA;AAAA,GACF;AACF;AAWO,SAAS,WAAA,CAAY;AAAA,EAC1B,MAAA;AAAA,EACA,aAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAA,EAAqB;AACnB,EAAA,MAAM,EAAE,KAAA,EAAO,QAAA,EAAS,GAAI,SAAS,OAAO,CAAA;AAE5C,EAAA,MAAM,cAAc,YAAY;AAC9B,IAAA,IAAI,UAAU,UAAA,EAAY;AAC1B,IAAA,MAAM,QAAA,CAAS,EAAE,MAAA,EAAQ,aAAA,EAAe,SAAS,CAAA;AAAA,EACnD,CAAA;AAEA,EAAA,OAAO,aAAA;AAAA,IACL,QAAA;AAAA,IACA;AAAA,MACE,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,WAAA;AAAA,MACT,UAAU,KAAA,KAAU,UAAA;AAAA,MACpB,WAAW,SAAA,IAAa;AAAA,KAC1B;AAAA,IACA,QAAA,KAAa,KAAA,KAAU,UAAA,GAAa,wBAAA,GAA2B,gBAAA;AAAA,GACjE;AACF","file":"react.js","sourcesContent":["import { useState, useEffect, useCallback, createElement } from 'react';\nimport {\n  BkashClient,\n  type BkashClientOptions,\n  type BkashClientState,\n  type InitiateCheckoutParams,\n} from './index.js';\n\nexport function useBkash(options?: BkashClientOptions) {\n  const [client] = useState(() => new BkashClient(options));\n  const [state, setState] = useState<BkashClientState>(client.getState());\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    return client.subscribe((newState) => setState(newState));\n  }, [client]);\n\n  const checkout = useCallback(\n    async (params: InitiateCheckoutParams) => {\n      setError(null);\n      try {\n        await client.checkout(params);\n      } catch (err: unknown) {\n        const errorObj = err instanceof Error ? err : new Error(String(err));\n        setError(errorObj);\n        throw errorObj;\n      }\n    },\n    [client]\n  );\n\n  const reset = useCallback(() => {\n    setError(null);\n    client.reset();\n  }, [client]);\n\n  return {\n    state,\n    error,\n    paymentId: client.getPaymentId(),\n    checkout,\n    reset,\n    client,\n  };\n}\n\nexport interface BkashButtonProps {\n  amount?: number | string;\n  invoiceNumber?: string;\n  orderId?: string;\n  options?: BkashClientOptions;\n  className?: string;\n  children?: any;\n}\n\nexport function BkashButton({\n  amount,\n  invoiceNumber,\n  orderId,\n  options,\n  className,\n  children,\n}: BkashButtonProps) {\n  const { state, checkout } = useBkash(options);\n\n  const handleClick = async () => {\n    if (state === 'creating') return;\n    await checkout({ amount, invoiceNumber, orderId });\n  };\n\n  return createElement(\n    'button',\n    {\n      type: 'button',\n      onClick: handleClick,\n      disabled: state === 'creating',\n      className: className || 'bkash-pay-btn',\n    },\n    children || (state === 'creating' ? 'Connecting to bKash...' : 'Pay with bKash')\n  );\n}\n"]}

package/dist/svelte.cjs

@@ -0,0 +1,141 @@
+'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");
+  }
+};
+
+// src/svelte.ts
+function createBkashStore(options) {
+  const client = new BkashClient(options);
+  return {
+    subscribe: (run) => {
+      run({ state: client.getState(), paymentId: client.getPaymentId() });
+      return client.subscribe((state) => {
+        run({ state, paymentId: client.getPaymentId() });
+      });
+    },
+    checkout: (params) => client.checkout(params),
+    reset: () => client.reset()
+  };
+}
+
+exports.createBkashStore = createBkashStore;
+//# sourceMappingURL=svelte.cjs.map
+//# sourceMappingURL=svelte.cjs.map

package/dist/svelte.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/svelte.ts"],"names":[],"mappings":"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","file":"svelte.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","import {\n  BkashClient,\n  type BkashClientOptions,\n  type BkashClientState,\n  type InitiateCheckoutParams,\n} from './index.js';\n\nexport interface BkashSvelteStore {\n  subscribe: (run: (value: { state: BkashClientState; paymentId: string | null }) => void) => () => void;\n  checkout: (params: InitiateCheckoutParams) => Promise<void>;\n  reset: () => void;\n}\n\n/**\n * Svelte readable store wrapper for bKash Client.\n */\nexport function createBkashStore(options?: BkashClientOptions): BkashSvelteStore {\n  const client = new BkashClient(options);\n\n  return {\n    subscribe: (run) => {\n      run({ state: client.getState(), paymentId: client.getPaymentId() });\n      return client.subscribe((state) => {\n        run({ state, paymentId: client.getPaymentId() });\n      });\n    },\n    checkout: (params) => client.checkout(params),\n    reset: () => client.reset(),\n  };\n}\n"]}

package/dist/svelte.d.cts

@@ -0,0 +1,16 @@
+import { BkashClientState, InitiateCheckoutParams, BkashClientOptions } from './index.cjs';
+
+interface BkashSvelteStore {
+    subscribe: (run: (value: {
+        state: BkashClientState;
+        paymentId: string | null;
+    }) => void) => () => void;
+    checkout: (params: InitiateCheckoutParams) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Svelte readable store wrapper for bKash Client.
+ */
+declare function createBkashStore(options?: BkashClientOptions): BkashSvelteStore;
+
+export { type BkashSvelteStore, createBkashStore };

package/dist/svelte.d.ts

@@ -0,0 +1,16 @@
+import { BkashClientState, InitiateCheckoutParams, BkashClientOptions } from './index.js';
+
+interface BkashSvelteStore {
+    subscribe: (run: (value: {
+        state: BkashClientState;
+        paymentId: string | null;
+    }) => void) => () => void;
+    checkout: (params: InitiateCheckoutParams) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Svelte readable store wrapper for bKash Client.
+ */
+declare function createBkashStore(options?: BkashClientOptions): BkashSvelteStore;
+
+export { type BkashSvelteStore, createBkashStore };

package/dist/svelte.js

@@ -0,0 +1,21 @@
+import { BkashClient } from './chunk-FXLW32P4.js';
+import './chunk-DGUM43GV.js';
+
+// src/svelte.ts
+function createBkashStore(options) {
+  const client = new BkashClient(options);
+  return {
+    subscribe: (run) => {
+      run({ state: client.getState(), paymentId: client.getPaymentId() });
+      return client.subscribe((state) => {
+        run({ state, paymentId: client.getPaymentId() });
+      });
+    },
+    checkout: (params) => client.checkout(params),
+    reset: () => client.reset()
+  };
+}
+
+export { createBkashStore };
+//# sourceMappingURL=svelte.js.map
+//# sourceMappingURL=svelte.js.map

package/dist/svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/svelte.ts"],"names":[],"mappings":";;;;AAgBO,SAAS,iBAAiB,OAAA,EAAgD;AAC/E,EAAA,MAAM,MAAA,GAAS,IAAI,WAAA,CAAY,OAAO,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,CAAC,GAAA,KAAQ;AAClB,MAAA,GAAA,CAAI,EAAE,OAAO,MAAA,CAAO,QAAA,IAAY,SAAA,EAAW,MAAA,CAAO,YAAA,EAAa,EAAG,CAAA;AAClE,MAAA,OAAO,MAAA,CAAO,SAAA,CAAU,CAAC,KAAA,KAAU;AACjC,QAAA,GAAA,CAAI,EAAE,KAAA,EAAO,SAAA,EAAW,MAAA,CAAO,YAAA,IAAgB,CAAA;AAAA,MACjD,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,QAAA,EAAU,CAAC,MAAA,KAAW,MAAA,CAAO,SAAS,MAAM,CAAA;AAAA,IAC5C,KAAA,EAAO,MAAM,MAAA,CAAO,KAAA;AAAM,GAC5B;AACF","file":"svelte.js","sourcesContent":["import {\n  BkashClient,\n  type BkashClientOptions,\n  type BkashClientState,\n  type InitiateCheckoutParams,\n} from './index.js';\n\nexport interface BkashSvelteStore {\n  subscribe: (run: (value: { state: BkashClientState; paymentId: string | null }) => void) => () => void;\n  checkout: (params: InitiateCheckoutParams) => Promise<void>;\n  reset: () => void;\n}\n\n/**\n * Svelte readable store wrapper for bKash Client.\n */\nexport function createBkashStore(options?: BkashClientOptions): BkashSvelteStore {\n  const client = new BkashClient(options);\n\n  return {\n    subscribe: (run) => {\n      run({ state: client.getState(), paymentId: client.getPaymentId() });\n      return client.subscribe((state) => {\n        run({ state, paymentId: client.getPaymentId() });\n      });\n    },\n    checkout: (params) => client.checkout(params),\n    reset: () => client.reset(),\n  };\n}\n"]}