bkash-client 0.0.0-stage → 0.1.0

package/dist/vue.cjs

@@ -0,0 +1,169 @@
+'use strict';
+
+var vue = require('vue');
+
+// src/vue.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/vue.ts
+function useBkash(options) {
+  const client = new BkashClient(options);
+  const state = vue.ref(client.getState());
+  const error = vue.ref(null);
+  const paymentId = vue.ref(client.getPaymentId());
+  client.subscribe((newState) => {
+    state.value = newState;
+    paymentId.value = client.getPaymentId();
+  });
+  const checkout = async (params) => {
+    error.value = null;
+    try {
+      await client.checkout(params);
+      paymentId.value = client.getPaymentId();
+    } catch (err) {
+      const errObj = err instanceof Error ? err : new Error(String(err));
+      error.value = errObj;
+      throw errObj;
+    }
+  };
+  const reset = () => {
+    error.value = null;
+    client.reset();
+    paymentId.value = null;
+  };
+  return {
+    state: vue.readonly(state),
+    error: vue.readonly(error),
+    paymentId: vue.readonly(paymentId),
+    getState: () => state.value,
+    getError: () => error.value,
+    getPaymentId: () => paymentId.value,
+    checkout,
+    reset,
+    client
+  };
+}
+
+exports.useBkash = useBkash;
+//# sourceMappingURL=vue.cjs.map
+//# sourceMappingURL=vue.cjs.map

package/dist/vue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/vue.ts"],"names":["ref","readonly"],"mappings":"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","file":"vue.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 { ref, readonly, type Ref, type DeepReadonly } from 'vue';\nimport {\n  BkashClient,\n  type BkashClientOptions,\n  type BkashClientState,\n  type InitiateCheckoutParams,\n} from './index.js';\n\nexport interface UseBkashReturn {\n  state: DeepReadonly<Ref<BkashClientState>>;\n  error: DeepReadonly<Ref<Error | null>>;\n  paymentId: DeepReadonly<Ref<string | null>>;\n  getState: () => BkashClientState;\n  getError: () => Error | null;\n  getPaymentId: () => string | null;\n  checkout: (params: InitiateCheckoutParams) => Promise<void>;\n  reset: () => void;\n  client: BkashClient;\n}\n\n/**\n * Vue 3 Composable for bKash Checkout.\n * Provides deep reactivity via Vue 3 Refs, compatible with <script setup> and JSX templates.\n */\nexport function useBkash(options?: BkashClientOptions): UseBkashReturn {\n  const client = new BkashClient(options);\n  const state = ref<BkashClientState>(client.getState());\n  const error = ref<Error | null>(null);\n  const paymentId = ref<string | null>(client.getPaymentId());\n\n  client.subscribe((newState) => {\n    state.value = newState;\n    paymentId.value = client.getPaymentId();\n  });\n\n  const checkout = async (params: InitiateCheckoutParams) => {\n    error.value = null;\n    try {\n      await client.checkout(params);\n      paymentId.value = client.getPaymentId();\n    } catch (err: unknown) {\n      const errObj = err instanceof Error ? err : new Error(String(err));\n      error.value = errObj;\n      throw errObj;\n    }\n  };\n\n  const reset = () => {\n    error.value = null;\n    client.reset();\n    paymentId.value = null;\n  };\n\n  return {\n    state: readonly(state),\n    error: readonly(error),\n    paymentId: readonly(paymentId),\n    getState: () => state.value,\n    getError: () => error.value,\n    getPaymentId: () => paymentId.value,\n    checkout,\n    reset,\n    client,\n  };\n}\n"]}

package/dist/vue.d.cts

@@ -0,0 +1,21 @@
+import { DeepReadonly, Ref } from 'vue';
+import { BkashClientState, InitiateCheckoutParams, BkashClient, BkashClientOptions } from './index.cjs';
+
+interface UseBkashReturn {
+    state: DeepReadonly<Ref<BkashClientState>>;
+    error: DeepReadonly<Ref<Error | null>>;
+    paymentId: DeepReadonly<Ref<string | null>>;
+    getState: () => BkashClientState;
+    getError: () => Error | null;
+    getPaymentId: () => string | null;
+    checkout: (params: InitiateCheckoutParams) => Promise<void>;
+    reset: () => void;
+    client: BkashClient;
+}
+/**
+ * Vue 3 Composable for bKash Checkout.
+ * Provides deep reactivity via Vue 3 Refs, compatible with <script setup> and JSX templates.
+ */
+declare function useBkash(options?: BkashClientOptions): UseBkashReturn;
+
+export { type UseBkashReturn, useBkash };

package/dist/vue.d.ts

@@ -0,0 +1,21 @@
+import { DeepReadonly, Ref } from 'vue';
+import { BkashClientState, InitiateCheckoutParams, BkashClient, BkashClientOptions } from './index.js';
+
+interface UseBkashReturn {
+    state: DeepReadonly<Ref<BkashClientState>>;
+    error: DeepReadonly<Ref<Error | null>>;
+    paymentId: DeepReadonly<Ref<string | null>>;
+    getState: () => BkashClientState;
+    getError: () => Error | null;
+    getPaymentId: () => string | null;
+    checkout: (params: InitiateCheckoutParams) => Promise<void>;
+    reset: () => void;
+    client: BkashClient;
+}
+/**
+ * Vue 3 Composable for bKash Checkout.
+ * Provides deep reactivity via Vue 3 Refs, compatible with <script setup> and JSX templates.
+ */
+declare function useBkash(options?: BkashClientOptions): UseBkashReturn;
+
+export { type UseBkashReturn, useBkash };

package/dist/vue.js

@@ -0,0 +1,45 @@
+import { BkashClient } from './chunk-FXLW32P4.js';
+import './chunk-DGUM43GV.js';
+import { ref, readonly } from 'vue';
+
+function useBkash(options) {
+  const client = new BkashClient(options);
+  const state = ref(client.getState());
+  const error = ref(null);
+  const paymentId = ref(client.getPaymentId());
+  client.subscribe((newState) => {
+    state.value = newState;
+    paymentId.value = client.getPaymentId();
+  });
+  const checkout = async (params) => {
+    error.value = null;
+    try {
+      await client.checkout(params);
+      paymentId.value = client.getPaymentId();
+    } catch (err) {
+      const errObj = err instanceof Error ? err : new Error(String(err));
+      error.value = errObj;
+      throw errObj;
+    }
+  };
+  const reset = () => {
+    error.value = null;
+    client.reset();
+    paymentId.value = null;
+  };
+  return {
+    state: readonly(state),
+    error: readonly(error),
+    paymentId: readonly(paymentId),
+    getState: () => state.value,
+    getError: () => error.value,
+    getPaymentId: () => paymentId.value,
+    checkout,
+    reset,
+    client
+  };
+}
+
+export { useBkash };
+//# sourceMappingURL=vue.js.map
+//# sourceMappingURL=vue.js.map

package/dist/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vue.ts"],"names":[],"mappings":";;;;AAwBO,SAAS,SAAS,OAAA,EAA8C;AACrE,EAAA,MAAM,MAAA,GAAS,IAAI,WAAA,CAAY,OAAO,CAAA;AACtC,EAAA,MAAM,KAAA,GAAQ,GAAA,CAAsB,MAAA,CAAO,QAAA,EAAU,CAAA;AACrD,EAAA,MAAM,KAAA,GAAQ,IAAkB,IAAI,CAAA;AACpC,EAAA,MAAM,SAAA,GAAY,GAAA,CAAmB,MAAA,CAAO,YAAA,EAAc,CAAA;AAE1D,EAAA,MAAA,CAAO,SAAA,CAAU,CAAC,QAAA,KAAa;AAC7B,IAAA,KAAA,CAAM,KAAA,GAAQ,QAAA;AACd,IAAA,SAAA,CAAU,KAAA,GAAQ,OAAO,YAAA,EAAa;AAAA,EACxC,CAAC,CAAA;AAED,EAAA,MAAM,QAAA,GAAW,OAAO,MAAA,KAAmC;AACzD,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AACd,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,CAAO,SAAS,MAAM,CAAA;AAC5B,MAAA,SAAA,CAAU,KAAA,GAAQ,OAAO,YAAA,EAAa;AAAA,IACxC,SAAS,GAAA,EAAc;AACrB,MAAA,MAAM,MAAA,GAAS,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AACjE,MAAA,KAAA,CAAM,KAAA,GAAQ,MAAA;AACd,MAAA,MAAM,MAAA;AAAA,IACR;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,QAAQ,MAAM;AAClB,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AACd,IAAA,MAAA,CAAO,KAAA,EAAM;AACb,IAAA,SAAA,CAAU,KAAA,GAAQ,IAAA;AAAA,EACpB,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,SAAS,KAAK,CAAA;AAAA,IACrB,KAAA,EAAO,SAAS,KAAK,CAAA;AAAA,IACrB,SAAA,EAAW,SAAS,SAAS,CAAA;AAAA,IAC7B,QAAA,EAAU,MAAM,KAAA,CAAM,KAAA;AAAA,IACtB,QAAA,EAAU,MAAM,KAAA,CAAM,KAAA;AAAA,IACtB,YAAA,EAAc,MAAM,SAAA,CAAU,KAAA;AAAA,IAC9B,QAAA;AAAA,IACA,KAAA;AAAA,IACA;AAAA,GACF;AACF","file":"vue.js","sourcesContent":["import { ref, readonly, type Ref, type DeepReadonly } from 'vue';\nimport {\n  BkashClient,\n  type BkashClientOptions,\n  type BkashClientState,\n  type InitiateCheckoutParams,\n} from './index.js';\n\nexport interface UseBkashReturn {\n  state: DeepReadonly<Ref<BkashClientState>>;\n  error: DeepReadonly<Ref<Error | null>>;\n  paymentId: DeepReadonly<Ref<string | null>>;\n  getState: () => BkashClientState;\n  getError: () => Error | null;\n  getPaymentId: () => string | null;\n  checkout: (params: InitiateCheckoutParams) => Promise<void>;\n  reset: () => void;\n  client: BkashClient;\n}\n\n/**\n * Vue 3 Composable for bKash Checkout.\n * Provides deep reactivity via Vue 3 Refs, compatible with <script setup> and JSX templates.\n */\nexport function useBkash(options?: BkashClientOptions): UseBkashReturn {\n  const client = new BkashClient(options);\n  const state = ref<BkashClientState>(client.getState());\n  const error = ref<Error | null>(null);\n  const paymentId = ref<string | null>(client.getPaymentId());\n\n  client.subscribe((newState) => {\n    state.value = newState;\n    paymentId.value = client.getPaymentId();\n  });\n\n  const checkout = async (params: InitiateCheckoutParams) => {\n    error.value = null;\n    try {\n      await client.checkout(params);\n      paymentId.value = client.getPaymentId();\n    } catch (err: unknown) {\n      const errObj = err instanceof Error ? err : new Error(String(err));\n      error.value = errObj;\n      throw errObj;\n    }\n  };\n\n  const reset = () => {\n    error.value = null;\n    client.reset();\n    paymentId.value = null;\n  };\n\n  return {\n    state: readonly(state),\n    error: readonly(error),\n    paymentId: readonly(paymentId),\n    getState: () => state.value,\n    getError: () => error.value,\n    getPaymentId: () => paymentId.value,\n    checkout,\n    reset,\n    client,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,162 @@
 {
   "name": "bkash-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Headless, multi-framework client SDK for bKash payment flows",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": {
+        "import": "./dist/react.d.ts",
+        "require": "./dist/react.d.cts"
+      },
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs",
+      "default": "./dist/react.js"
+    },
+    "./react-native": {
+      "types": {
+        "import": "./dist/react-native.d.ts",
+        "require": "./dist/react-native.d.cts"
+      },
+      "import": "./dist/react-native.js",
+      "require": "./dist/react-native.cjs",
+      "default": "./dist/react-native.js"
+    },
+    "./vue": {
+      "types": {
+        "import": "./dist/vue.d.ts",
+        "require": "./dist/vue.d.cts"
+      },
+      "import": "./dist/vue.js",
+      "require": "./dist/vue.cjs",
+      "default": "./dist/vue.js"
+    },
+    "./svelte": {
+      "types": {
+        "import": "./dist/svelte.d.ts",
+        "require": "./dist/svelte.d.cts"
+      },
+      "import": "./dist/svelte.js",
+      "require": "./dist/svelte.cjs",
+      "default": "./dist/svelte.js"
+    },
+    "./angular": {
+      "types": {
+        "import": "./dist/angular.d.ts",
+        "require": "./dist/angular.d.cts"
+      },
+      "import": "./dist/angular.js",
+      "require": "./dist/angular.cjs",
+      "default": "./dist/angular.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "react": [
+        "./dist/react.d.ts"
+      ],
+      "react-native": [
+        "./dist/react-native.d.ts"
+      ],
+      "vue": [
+        "./dist/vue.d.ts"
+      ],
+      "svelte": [
+        "./dist/svelte.d.ts"
+      ],
+      "angular": [
+        "./dist/angular.d.ts"
+      ]
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-native": "*",
+    "react-native-webview": "*",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react-native-webview": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "bkash",
+    "bangladesh",
+    "payment",
+    "checkout",
+    "react",
+    "react-native",
+    "vue",
+    "svelte",
+    "angular",
+    "headless"
+  ],
+  "author": "Md Tanvir Ahamed Shanto (https://github.com/iamtashanto)",
+  "license": "MIT",
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "^20.14.0",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.7",
+    "@vue/test-utils": "^2.5.1",
+    "jsdom": "^24.1.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "svelte": "^5.57.2",
+    "tsup": "^8.2.4",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.3",
+    "vue": "^3.5.44"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iamtashanto/Bkash.git",
+    "directory": "packages/bkash-client"
+  },
+  "homepage": "https://bkash-sdk.tashanto.com/docs/",
+  "bugs": {
+    "url": "https://github.com/iamtashanto/Bkash/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsup --watch"
+  }
 }