@mmpay/browser 0.0.0-stage → 1.3.1

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@mmpay/browser",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.3.1",
+  "description": "JavaScript SDK for integrating the MMQR Merchant and Redirect payment gateway",
+  "keywords": [
+    "MMQR"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/esm/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nawing/MMPay-Browser-SDK.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nawing/MMPay-Browser-SDK/issues"
+  },
+  "homepage": "https://github.com/nawing/MMPay-Browser-SDK#readme",
+  "scripts": {
+    "build": "tsc --emitDeclarationOnly && rollup -c rollup.config.ts --configPlugin typescript",
+    "dev": "rollup -c rollup.config.ts -w --configPlugin typescript",
+    "serve": "python3 -m http.server 5173"
+  },
+  "devDependencies": {
+    "dotenv": "^17.2.2",
+    "@rollup/plugin-commonjs": "^26.0.1",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/bun": "^1.4.3",
+    "rollup": "^4.61.1",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "tslib": "^2.8.1",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Naw Ing",
+  "license": "ISC"
+}

package/rollup.config.ts

@@ -0,0 +1,33 @@
+import typescript from '@rollup/plugin-typescript';
+
+export default {
+  input: 'src/index.ts',
+  output: [
+    {
+      file: 'dist/cjs/index.js',
+      format: 'cjs',
+      exports: 'named'
+    },
+    {
+      file: 'dist/esm/index.js',
+      format: 'es'
+    },
+    {
+      file: 'dist/mmpay-sdk.js',
+      format: 'umd',
+      name: 'MMPaySDK',
+      exports: 'named'
+    }
+  ],
+  plugins: [
+    typescript({
+      tsconfig: './tsconfig.json',
+      compilerOptions: {
+        outDir: 'dist',
+        declaration: false,
+        declarationMap: false,
+        declarationDir: undefined
+      }
+    })
+  ]
+};

package/src/api.ts

@@ -0,0 +1,121 @@
+import {
+  ICancelPaymentRequestParams,
+  ICancelPaymentResponse,
+  ICreatePaymentRequestParams,
+  ICreatePaymentResponse,
+  ICreateTokenRequestParams,
+  ICreateTokenResponse,
+  IPaymentShowRequestParams,
+  IPaymentShowResponse,
+  IPollingRequest,
+  IPollingResponse,
+  IStreamTicketResponse
+} from './types';
+
+const REQUEST_TIMEOUT_MS = 20000;
+
+export class MMPayApiError extends Error {
+  public status: number;
+
+  constructor(message: string, status: number) {
+    super(message);
+    this.name = 'MMPayApiError';
+    this.status = status;
+    Object.setPrototypeOf(this, MMPayApiError.prototype);
+  }
+}
+
+export class MMPayAPI {
+  private baseUrl: string;
+  private environment: 'sandbox' | 'production';
+  private publishableKey: string;
+  private tokenKey: string | null = null;
+
+  constructor(baseUrl: string, environment: 'sandbox' | 'production', publishableKey: string) {
+    this.baseUrl = baseUrl.replace(/\/+$/, '');
+    this.environment = environment;
+    this.publishableKey = publishableKey;
+  }
+
+  public setToken(token: string | null): void {
+    this.tokenKey = token;
+  }
+
+  public getToken(): string | null {
+    return this.tokenKey;
+  }
+
+  private async call<T>(endpoint: string, data: object = {}): Promise<T> {
+    let headers: any = {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${this.publishableKey}`
+    };
+    if (this.tokenKey) {
+      headers['X-MMPay-Btoken'] = this.tokenKey;
+    }
+    const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+    const timeoutId = controller ? setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS) : undefined;
+    try {
+      const response = await fetch(`${this.baseUrl}${endpoint}`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(data),
+        signal: controller ? controller.signal : undefined
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new MMPayApiError(
+          `API Error (${response.status}): ${response.statusText}. Details: ${errorText}`,
+          response.status
+        );
+      }
+      return await response.json() as T;
+    } catch (error: any) {
+      if (error && error.name === 'AbortError') {
+        throw new MMPayApiError('Request timed out. Please check your connection.', 0);
+      }
+      throw error;
+    } finally {
+      if (timeoutId !== undefined) clearTimeout(timeoutId);
+    }
+  }
+
+  public async createToken(payload: ICreateTokenRequestParams): Promise<ICreateTokenResponse> {
+    const endpoint = `/xpayments/${this.environment}-token-request`;
+    return this.call<ICreateTokenResponse>(endpoint, payload);
+  }
+
+  public async showPayment(payload: IPaymentShowRequestParams): Promise<IPaymentShowResponse> {
+    const endpoint = `/xpayments/${this.environment}-payment-show`;
+    return this.call<IPaymentShowResponse>(endpoint, payload);
+  }
+
+  public async cancelPayment(payload: ICancelPaymentRequestParams): Promise<ICancelPaymentResponse> {
+    const endpoint = `/xpayments/${this.environment}-payment-cancel`;
+    return this.call<ICancelPaymentResponse>(endpoint, payload);
+  }
+
+  public async createPayment(payload: ICreatePaymentRequestParams): Promise<ICreatePaymentResponse> {
+    const endpoint = `/xpayments/${this.environment}-payment-create`;
+    return this.call<ICreatePaymentResponse>(endpoint, payload);
+  }
+
+  public async pollPayment(payload: IPollingRequest): Promise<IPollingResponse> {
+    const endpoint = `/xpayments/${this.environment}-payment-polling`;
+    return this.call<IPollingResponse>(endpoint, payload);
+  }
+
+  /**
+   * A WebSocket handshake cannot carry the publishable key or session token,
+   * so the authenticated API issues a short-lived, single-use ticket for it.
+   */
+  public async createStreamTicket(payload: IPollingRequest): Promise<IStreamTicketResponse> {
+    const endpoint = `/xpayments/${this.environment}-payment-stream-ticket`;
+    return this.call<IStreamTicketResponse>(endpoint, payload);
+  }
+
+  public getStreamUrl(ticket: string): string {
+    const socketBase = this.baseUrl.replace(/^http/i, 'ws');
+    return `${socketBase}/xpayments/${this.environment}-payment-stream?ticket=${encodeURIComponent(ticket)}`;
+  }
+}

package/src/i18n.ts

@@ -0,0 +1,112 @@
+import {MMPayLanguage} from './types';
+
+const LANGUAGE_STORAGE_KEY = 'mmpay_lang';
+
+type Dictionary = Record<string, string>;
+
+const en: Dictionary = {
+  'loading.title': 'Connecting',
+  'loading.subtitle': 'Setting up a secure connection...',
+  'qr.scanHint': 'Scan with any MMQR banking app',
+  'qr.poweredBy': 'Payment powered by MyanMyanPay',
+  'qr.orderId': 'Order ID',
+  'qr.refNo': 'MMQR Ref No',
+  'qr.download': 'Download QR Code',
+  'qr.waiting': 'Waiting for payment',
+  'qr.reconnecting': 'Reconnecting...',
+  'qr.loadFailed': 'The QR code could not be displayed.',
+  'qr.retry': 'Try again',
+  'cancel.title': 'Cancel Transaction?',
+  'cancel.body': 'If you haven\'t paid yet, you can safely cancel this process.',
+  'cancel.confirm': 'Stop Process',
+  'cancel.back': 'Go Back',
+  'status.SUCCESS': 'Success',
+  'status.CANCELLED': 'Cancelled',
+  'status.EXPIRED': 'Expired',
+  'status.FAILED': 'Failed',
+  'message.SUCCESS': 'Payment successful.',
+  'message.CANCELLED': 'Payment cancelled.',
+  'message.EXPIRED': 'Payment expired.',
+  'message.FAILED': 'Payment failed.',
+  'message.TIMEOUT': 'Time expired.',
+  'message.ERROR': 'Something went wrong while starting the payment.',
+  'message.ref': 'Ref: {ref}',
+  'action.close': 'Close',
+  'action.language': 'Language'
+};
+
+const mm: Dictionary = {
+  'loading.title': 'ချိတ်ဆက်နေပါသည်',
+  'loading.subtitle': 'လုံခြုံရေး စနစ်ဖြင့် ချိတ်ဆက်နေပါသည်...',
+  'qr.poweredBy': 'MyanMyanPay ဖြင့် ပေးချေပါ',
+  'qr.orderId': 'အော်ဒါနံပါတ်',
+  'qr.refNo': 'ရည်ညွှန်းနံပါတ်',
+  'qr.download': 'QR ဒေါင်းလုဒ်လုပ်မည်',
+  'cancel.title': 'လုပ်ငန်းစဉ်ကို ပယ်ဖျက်မည်လား?',
+  'cancel.body': 'ငွေမပေးချေရသေးပါက လုပ်ငန်းစဉ်ကို ဘေးကင်းစွာ ပယ်ဖျက်နိုင်ပါသည်။',
+  'cancel.confirm': 'ရပ်တန့်မည်',
+  'cancel.back': 'နောက်သို့',
+  'status.SUCCESS': 'အောင်မြင်ပါသည်',
+  'status.CANCELLED': 'ပယ်ဖျက်လိုက်ပါသည်',
+  'status.EXPIRED': 'သက်တမ်းကုန်သွားပါပြီ',
+  'status.FAILED': 'မအောင်မြင်ပါ',
+  'message.SUCCESS': 'ငွေပေးချေမှု အောင်မြင်ပါပြီ။',
+  'message.CANCELLED': 'ငွေပေးချေမှုကို ပယ်ဖျက်လိုက်ပါသည်။',
+  'message.EXPIRED': 'ငွေပေးချေမှု သက်တမ်းကုန်သွားပါပြီ။',
+  'message.FAILED': 'ငွေပေးချေမှု မအောင်မြင်ပါ။',
+  'message.TIMEOUT': 'သတ်မှတ်ချိန်ကုန်သွားပါပြီ။',
+  'message.ERROR': 'ငွေပေးချေမှု စတင်စဉ် အမှားအယွင်း ဖြစ်ပွားသည်။',
+  'message.ref': 'ရည်ညွှန်းနံပါတ်: {ref}',
+  'action.close': 'ပိတ်မည်',
+  'action.language': 'ဘာသာစကား',
+
+  // Added in 1.3.0 for the new screens. Everything above was already shipped.
+  'qr.scanHint': 'MMQR လက်ခံသော မည်သည့်ဘဏ်အက်ပ်ဖြင့်မဆို စကင်ဖတ်ပါ',
+  'qr.waiting': 'ငွေပေးချေမှုကို စောင့်ဆိုင်းနေပါသည်',
+  'qr.reconnecting': 'ပြန်လည်ချိတ်ဆက်နေပါသည်...',
+  'qr.loadFailed': 'QR ကုဒ်ကို ပြသ၍မရပါ။',
+  'qr.retry': 'ထပ်မံကြိုးစားမည်'
+};
+
+const dictionaries: Record<MMPayLanguage, Dictionary> = {en, mm};
+
+export function normalizeLanguage(value: unknown): MMPayLanguage | null {
+  if (typeof value !== 'string') return null;
+  const code = value.toLowerCase();
+  if (code === 'mm' || code === 'my' || code.indexOf('my-') === 0) return 'mm';
+  if (code === 'en' || code.indexOf('en-') === 0) return 'en';
+  return null;
+}
+
+/**
+ * A missing translation falls back to English so a screen can never render
+ * blank text, whichever language is selected.
+ */
+export function translate(language: MMPayLanguage, key: string, params?: Record<string, string>): string {
+  let text = dictionaries[language][key] || en[key] || key;
+  if (params) {
+    Object.keys(params).forEach(name => {
+      text = text.split('{' + name + '}').join(params[name]);
+    });
+  }
+  return text;
+}
+
+/**
+ * The shopper's own choice wins, then the merchant's configured language, then
+ * the browser language.
+ */
+export function resolveInitialLanguage(preferred?: string): MMPayLanguage {
+  let stored: string | null = null;
+  try {
+    stored = window.localStorage.getItem(LANGUAGE_STORAGE_KEY);
+  } catch (e) { }
+  const browser = typeof navigator !== 'undefined' ? navigator.language : undefined;
+  return normalizeLanguage(stored) || normalizeLanguage(preferred) || normalizeLanguage(browser) || 'en';
+}
+
+export function rememberLanguage(language: MMPayLanguage): void {
+  try {
+    window.localStorage.setItem(LANGUAGE_STORAGE_KEY, language);
+  } catch (e) { }
+}