@mmpay/browser 0.0.0-stage → 1.3.1

package/src/stream.ts

@@ -0,0 +1,214 @@
+import {MMPayAPI, MMPayApiError} from './api';
+import {IPollingRequest, IPollingResponse, MMPayTransport} from './types';
+
+export type ConnectionState = 'live' | 'reconnecting';
+
+interface WatcherOptions {
+  transport: MMPayTransport;
+  pollInterval: number;
+  onStatus: (response: IPollingResponse) => void;
+  onConnectionChange?: (state: ConnectionState) => void;
+}
+
+const MAX_SOCKET_FAILURES = 3;
+const SILENCE_TIMEOUT_MS = 45000;
+const MAX_RECONNECT_DELAY_MS = 10000;
+const MIN_POLL_INTERVAL_MS = 2000;
+
+const CLOSE_SESSION_EXPIRED = 4408;
+const CLOSE_TOO_MANY_CONNECTIONS = 4429;
+
+/**
+ * Watches one payment until the owner calls `stop()`.
+ *
+ * Status is pushed over a WebSocket. If a socket cannot be established or keeps
+ * dropping (old server, blocking proxy), the watcher quietly degrades to the
+ * HTTP polling endpoint, so a payment is never left unobserved.
+ */
+export class PaymentStatusWatcher {
+  private socket: WebSocket | null = null;
+  private stopped = false;
+  private connecting = false;
+  private usingPolling = false;
+  private socketFailures = 0;
+  private pollIntervalId: number | undefined = undefined;
+  private reconnectTimeoutId: number | undefined = undefined;
+  private silenceTimeoutId: number | undefined = undefined;
+  private readonly onWake = () => this.wake();
+  private readonly onVisibility = () => {
+    if (document.visibilityState === 'visible') this.wake();
+  };
+
+  constructor(
+    private api: MMPayAPI,
+    private payload: IPollingRequest,
+    private options: WatcherOptions
+  ) { }
+
+  public start(): void {
+    // Shoppers leave to pay in their banking app; a backgrounded tab may have
+    // its socket frozen, so re-check the moment they come back.
+    document.addEventListener('visibilitychange', this.onVisibility);
+    window.addEventListener('online', this.onWake);
+    window.addEventListener('pageshow', this.onWake);
+    this.checkNow();
+    if (this.options.transport !== 'polling' && typeof WebSocket !== 'undefined') {
+      this.connect();
+    } else {
+      this.startPolling();
+    }
+  }
+
+  public stop(): void {
+    this.stopped = true;
+    document.removeEventListener('visibilitychange', this.onVisibility);
+    window.removeEventListener('online', this.onWake);
+    window.removeEventListener('pageshow', this.onWake);
+    window.clearInterval(this.pollIntervalId);
+    window.clearTimeout(this.reconnectTimeoutId);
+    window.clearTimeout(this.silenceTimeoutId);
+    this.closeSocket();
+  }
+
+  private async checkNow(): Promise<void> {
+    try {
+      const response = await this.api.pollPayment(this.payload);
+      if (!this.stopped) this.options.onStatus(response);
+    } catch (error) { }
+  }
+
+  private wake(): void {
+    if (this.stopped) return;
+    this.checkNow();
+    if (this.usingPolling || this.connecting) return;
+    if (!this.socket || this.socket.readyState > 1) {
+      window.clearTimeout(this.reconnectTimeoutId);
+      this.connect();
+    }
+  }
+
+  private async connect(): Promise<void> {
+    if (this.stopped || this.usingPolling || this.connecting) return;
+    this.connecting = true;
+    let ticket: string;
+    try {
+      ticket = (await this.api.createStreamTicket(this.payload)).ticket;
+    } catch (error) {
+      this.connecting = false;
+      const status = error instanceof MMPayApiError ? error.status : 0;
+      // The server does not offer the stream, or refuses this session.
+      if (status >= 400 && status < 500 && status !== 429) {
+        this.startPolling();
+      } else {
+        this.handleSocketFailure();
+      }
+      return;
+    }
+    this.connecting = false;
+    if (this.stopped) return;
+
+    let socket: WebSocket;
+    try {
+      socket = new WebSocket(this.api.getStreamUrl(ticket));
+    } catch (error) {
+      this.handleSocketFailure();
+      return;
+    }
+    this.socket = socket;
+    this.armSilenceTimer();
+
+    socket.onmessage = (event: MessageEvent) => {
+      if (socket !== this.socket || this.stopped) return;
+      // Only a message proves the stream works end to end.
+      this.socketFailures = 0;
+      this.armSilenceTimer();
+      this.notifyConnection('live');
+      const message = this.parseMessage(event.data);
+      if (message && message.type === 'status' && this.isOwnStatus(message.data)) {
+        this.options.onStatus(message.data);
+      }
+    };
+    socket.onclose = (event: CloseEvent) => {
+      if (socket !== this.socket || this.stopped) return;
+      this.socket = null;
+      window.clearTimeout(this.silenceTimeoutId);
+      if (event.code === CLOSE_SESSION_EXPIRED) return;
+      if (event.code === CLOSE_TOO_MANY_CONNECTIONS) {
+        this.startPolling();
+        return;
+      }
+      this.handleSocketFailure();
+    };
+    socket.onerror = () => { };
+  }
+
+  private parseMessage(data: unknown): any {
+    if (typeof data !== 'string') return null;
+    try {
+      return JSON.parse(data);
+    } catch (error) {
+      return null;
+    }
+  }
+
+  private isOwnStatus(data: any): data is IPollingResponse {
+    return !!data && typeof data.status === 'string' && data.orderId === this.payload.orderId;
+  }
+
+  private handleSocketFailure(): void {
+    if (this.stopped || this.usingPolling) return;
+    this.socketFailures++;
+    this.checkNow();
+    if (this.socketFailures >= MAX_SOCKET_FAILURES && this.options.transport !== 'websocket') {
+      this.startPolling();
+      return;
+    }
+    this.notifyConnection('reconnecting');
+    const backoff = Math.min(MAX_RECONNECT_DELAY_MS, 1000 * Math.pow(2, this.socketFailures - 1));
+    const delay = backoff / 2 + Math.random() * (backoff / 2);
+    window.clearTimeout(this.reconnectTimeoutId);
+    this.reconnectTimeoutId = window.setTimeout(() => this.connect(), delay);
+  }
+
+  private armSilenceTimer(): void {
+    window.clearTimeout(this.silenceTimeoutId);
+    this.silenceTimeoutId = window.setTimeout(() => {
+      // The server sends a heartbeat every 20 seconds. Silence means the
+      // connection is dead even if the browser has not noticed yet.
+      const socket = this.socket;
+      this.socket = null;
+      if (socket) this.discard(socket);
+      this.handleSocketFailure();
+    }, SILENCE_TIMEOUT_MS);
+  }
+
+  private startPolling(): void {
+    if (this.stopped || this.usingPolling) return;
+    this.usingPolling = true;
+    window.clearTimeout(this.reconnectTimeoutId);
+    window.clearTimeout(this.silenceTimeoutId);
+    this.closeSocket();
+    this.notifyConnection('live');
+    const interval = Math.max(MIN_POLL_INTERVAL_MS, this.options.pollInterval);
+    this.pollIntervalId = window.setInterval(() => this.checkNow(), interval);
+  }
+
+  private closeSocket(): void {
+    const socket = this.socket;
+    this.socket = null;
+    if (socket) this.discard(socket);
+  }
+
+  private discard(socket: WebSocket): void {
+    socket.onmessage = null;
+    socket.onclose = null;
+    socket.onerror = null;
+    try {
+      socket.close();
+    } catch (error) { }
+  }
+
+  private notifyConnection(state: ConnectionState): void {
+    if (this.options.onConnectionChange) this.options.onConnectionChange(state);
+  }
+}

package/src/styles.ts

@@ -0,0 +1,206 @@
+/**
+ * Styles live inside the modal's shadow root, so the merchant page's CSS
+ * cannot restyle the payment modal and these rules cannot leak out.
+ */
+export const MMPAY_STYLES = `
+.mmp-root, .mmp-root *, .mmp-root *::before, .mmp-root *::after { box-sizing: border-box; }
+.mmp-root {
+  --mmp-card: #ffffff;
+  --mmp-text: #1d1d1f;
+  --mmp-sub: #6e6e73;
+  --mmp-border: rgba(0, 0, 0, 0.08);
+  --mmp-chip: #f2f2f5;
+  --mmp-chip-active: #ffffff;
+  --mmp-chip-hover: #e5e5ea;
+  --mmp-panel: #f7f7f9;
+  --mmp-skeleton: #e9e9ee;
+  --mmp-skeleton-shine: #f6f6f9;
+  --mmp-accent: #2c2c2e;
+  --mmp-accent-text: #ffffff;
+  --mmp-success: #1f9d55;
+  --mmp-success-bg: #e6f6ec;
+  --mmp-danger: #d93025;
+  --mmp-danger-bg: #fce8e6;
+  --mmp-warn: #c26a00;
+  --mmp-warn-bg: #fff3e0;
+  --mmp-card-blur: none;
+  position: absolute; top: 0; right: 0; bottom: 0; left: 0;
+  display: flex; align-items: center; justify-content: center;
+  padding: 16px; overflow-y: auto;
+  background: rgba(0, 0, 0, 0.45);
+  -webkit-backdrop-filter: blur(8px); backdrop-filter: blur(8px);
+  font-family: -apple-system, BlinkMacSystemFont, "SF Pro Text", "Segoe UI", Roboto, Helvetica, Arial, "Padauk", "Myanmar Text", "Noto Sans Myanmar", sans-serif;
+  font-size: 16px; line-height: 1.4; font-weight: 400; font-style: normal;
+  letter-spacing: normal; text-align: center; text-transform: none; white-space: normal;
+  color: var(--mmp-text); direction: ltr;
+  -webkit-font-smoothing: antialiased; -webkit-text-size-adjust: 100%;
+  animation: mmp-fade 0.2s ease;
+}
+.mmp-root.mmp-dark {
+  --mmp-card: #1c1c1e;
+  --mmp-text: #f5f5f7;
+  --mmp-sub: rgba(235, 235, 245, 0.62);
+  --mmp-border: rgba(255, 255, 255, 0.12);
+  --mmp-chip: #2c2c2e;
+  --mmp-chip-active: #636366;
+  --mmp-chip-hover: #3a3a3c;
+  --mmp-panel: #2c2c2e;
+  --mmp-skeleton: #2c2c2e;
+  --mmp-skeleton-shine: #3a3a3c;
+  --mmp-accent: #ffffff;
+  --mmp-accent-text: #000000;
+  --mmp-success: #34c759;
+  --mmp-success-bg: rgba(52, 199, 89, 0.18);
+  --mmp-danger: #ff6259;
+  --mmp-danger-bg: rgba(255, 69, 58, 0.18);
+  --mmp-warn: #ffa733;
+  --mmp-warn-bg: rgba(255, 149, 0, 0.18);
+}
+.mmp-root.mmp-translucent { --mmp-card: rgba(255, 255, 255, 0.78); --mmp-card-blur: blur(20px); }
+.mmp-root.mmp-dark.mmp-translucent { --mmp-card: rgba(28, 28, 30, 0.78); }
+.mmp-root[data-lang="mm"] { line-height: 1.75; }
+
+.mmp-card {
+  position: relative; display: flex; flex-direction: column;
+  width: 100%; max-width: 372px; max-height: 100%; margin: auto;
+  overflow-x: hidden; overflow-y: auto;
+  background: var(--mmp-card);
+  -webkit-backdrop-filter: var(--mmp-card-blur); backdrop-filter: var(--mmp-card-blur);
+  border-radius: 24px;
+  box-shadow: 0 24px 60px rgba(0, 0, 0, 0.22), 0 0 0 1px var(--mmp-border);
+  outline: none;
+  animation: mmp-rise 0.35s cubic-bezier(0.2, 0.8, 0.2, 1);
+}
+.mmp-topbar { display: flex; align-items: center; justify-content: space-between; padding: 14px 14px 0 14px; flex-shrink: 0; }
+.mmp-lang { display: inline-flex; gap: 2px; padding: 3px; background: var(--mmp-chip); border: 1px solid var(--mmp-border); border-radius: 11px; }
+.mmp-lang button {
+  margin: 0; padding: 5px 11px; min-width: 40px; border: none; border-radius: 8px; background: transparent;
+  font: inherit; font-size: 12px; font-weight: 600; line-height: 1.5; color: var(--mmp-sub); cursor: pointer;
+  transition: background 0.2s ease, color 0.2s ease;
+}
+.mmp-lang button[aria-pressed="true"] { background: var(--mmp-chip-active); color: var(--mmp-text); box-shadow: 0 1px 4px rgba(0, 0, 0, 0.12); }
+.mmp-close {
+  display: flex; align-items: center; justify-content: center; width: 34px; height: 34px; margin: 0; padding: 0;
+  border: none; border-radius: 50%; background: var(--mmp-chip); color: var(--mmp-sub); cursor: pointer;
+  transition: background 0.2s ease, color 0.2s ease;
+}
+.mmp-close:hover { background: var(--mmp-chip-hover); color: var(--mmp-text); }
+.mmp-close[hidden] { display: flex; visibility: hidden; }
+.mmp-root button:focus-visible { outline: 2px solid var(--mmp-text); outline-offset: 2px; }
+
+.mmp-screen { display: flex; flex-direction: column; align-items: center; padding: 6px 22px 22px 22px; animation: mmp-screen-in 0.28s ease; }
+.mmp-brand { display: flex; align-items: center; justify-content: center; height: 36px; margin-bottom: 10px; }
+.mmp-brand img { display: block; height: 36px; width: auto; max-width: 160px; object-fit: contain; }
+.mmp-merchant { max-width: 100%; font-size: 15px; font-weight: 500; color: var(--mmp-sub); overflow-wrap: anywhere; }
+.mmp-amount { display: flex; align-items: baseline; justify-content: center; gap: 6px; min-height: 36px; margin: 2px 0 14px 0; }
+.mmp-amount-value { font-size: 30px; font-weight: 700; line-height: 1.2; letter-spacing: -0.5px; font-variant-numeric: tabular-nums; }
+.mmp-amount-currency { font-size: 14px; font-weight: 600; letter-spacing: 0.5px; color: var(--mmp-sub); }
+
+.mmp-qr {
+  position: relative; display: flex; align-items: center; justify-content: center; flex-shrink: 0;
+  width: 228px; height: 228px; padding: 12px; background: #ffffff; border-radius: 18px;
+  border: 1px solid var(--mmp-border); box-shadow: 0 8px 24px rgba(0, 0, 0, 0.06); overflow: hidden;
+}
+.mmp-qr canvas { display: block; width: 100% !important; height: 100% !important; animation: mmp-qr-in 0.4s cubic-bezier(0.2, 0.8, 0.2, 1); }
+.mmp-qr-placeholder { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 22px; width: 100%; height: 100%; }
+.mmp-loader-logo { display: block; width: 88px; height: 88px; border-radius: 22px; box-shadow: 0 10px 24px rgba(0, 0, 0, 0.18); animation: mmp-pulse 2.2s ease-in-out infinite; }
+.mmp-loader-track { position: relative; width: 120px; height: 3px; border-radius: 3px; background: #ececf1; overflow: hidden; }
+.mmp-loader-bar { position: absolute; top: 0; bottom: 0; left: 0; width: 40%; border-radius: 3px; background: #1d1d1f; animation: mmp-sweep 1.2s cubic-bezier(0.4, 0, 0.2, 1) infinite; }
+.mmp-qr-error { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 10px; padding: 8px; font-size: 13px; color: #6e6e73; }
+.mmp-qr-error button {
+  margin: 0; padding: 7px 14px; border: 1px solid #d2d2d7; border-radius: 10px; background: #ffffff;
+  font: inherit; font-size: 13px; font-weight: 600; color: #1d1d1f; cursor: pointer;
+}
+
+.mmp-caption { min-height: 44px; margin: 14px 0 0 0; display: flex; flex-direction: column; align-items: center; justify-content: center; }
+.mmp-caption-title { font-size: 15px; font-weight: 600; }
+.mmp-caption-title::after { content: ""; display: inline-block; width: 1.2em; text-align: left; animation: mmp-ellipsis 1.4s steps(4, end) infinite; }
+.mmp-caption-sub { font-size: 13px; color: var(--mmp-sub); }
+.mmp-hint { font-size: 13px; color: var(--mmp-sub); }
+
+.mmp-status-row { display: flex; align-items: center; justify-content: center; flex-wrap: wrap; gap: 8px; margin: 10px 0 14px 0; }
+.mmp-waiting, .mmp-timer {
+  display: inline-flex; align-items: center; gap: 7px; padding: 5px 11px; border-radius: 999px;
+  font-size: 13px; font-weight: 600; background: var(--mmp-panel); border: 1px solid var(--mmp-border); color: var(--mmp-sub);
+}
+.mmp-dot { position: relative; width: 8px; height: 8px; border-radius: 50%; background: var(--mmp-success); flex-shrink: 0; }
+.mmp-dot::after { content: ""; position: absolute; top: 0; right: 0; bottom: 0; left: 0; border-radius: 50%; background: inherit; animation: mmp-ping 1.6s ease-out infinite; }
+.mmp-waiting[data-state="reconnecting"] .mmp-dot { background: var(--mmp-warn); }
+.mmp-timer { font-variant-numeric: tabular-nums; color: var(--mmp-text); }
+.mmp-timer svg { width: 13px; height: 13px; fill: currentColor; }
+.mmp-timer[data-urgent="true"] { color: var(--mmp-danger); background: var(--mmp-danger-bg); border-color: transparent; }
+
+.mmp-details { width: 100%; padding: 12px 14px; margin-bottom: 14px; background: var(--mmp-panel); border: 1px solid var(--mmp-border); border-radius: 14px; }
+.mmp-detail { display: flex; align-items: center; justify-content: space-between; gap: 12px; min-height: 24px; font-size: 13px; color: var(--mmp-sub); }
+.mmp-detail + .mmp-detail { margin-top: 6px; }
+.mmp-detail > span:first-child { flex-shrink: 0; text-align: left; }
+.mmp-detail strong { font-weight: 600; color: var(--mmp-text); text-align: right; overflow-wrap: anywhere; font-variant-numeric: tabular-nums; }
+.mmp-skeleton {
+  display: inline-block; height: 14px; border-radius: 7px;
+  background: linear-gradient(90deg, var(--mmp-skeleton) 25%, var(--mmp-skeleton-shine) 50%, var(--mmp-skeleton) 75%);
+  background-size: 200% 100%; animation: mmp-shimmer 1.4s linear infinite;
+}
+
+.mmp-btn {
+  display: flex; align-items: center; justify-content: center; gap: 8px; width: 100%; min-height: 50px; margin: 0; padding: 12px 20px;
+  border: 1px solid transparent; border-radius: 14px; background: var(--mmp-accent); color: var(--mmp-accent-text);
+  font: inherit; font-size: 16px; font-weight: 600; cursor: pointer; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.14);
+  transition: transform 0.15s ease, filter 0.2s ease, opacity 0.2s ease;
+}
+.mmp-btn:hover { filter: brightness(1.08); }
+.mmp-btn:active { transform: scale(0.98); }
+.mmp-btn:disabled { opacity: 0.45; cursor: default; filter: none; transform: none; box-shadow: none; }
+.mmp-btn svg { width: 18px; height: 18px; flex-shrink: 0; }
+.mmp-btn-secondary { background: transparent; color: var(--mmp-text); border-color: var(--mmp-border); box-shadow: none; }
+.mmp-btn-secondary:hover { background: var(--mmp-chip); filter: none; }
+.mmp-btn-danger { background: var(--mmp-danger-bg); color: var(--mmp-danger); box-shadow: none; }
+.mmp-btn[data-busy="true"]::before {
+  content: ""; width: 16px; height: 16px; border-radius: 50%; border: 2px solid currentColor; border-right-color: transparent;
+  animation: mmp-spin 0.7s linear infinite;
+}
+.mmp-powered { margin-top: 12px; font-size: 12px; font-weight: 500; color: var(--mmp-sub); }
+
+.mmp-sheet {
+  position: absolute; top: 52px; right: 0; bottom: 0; left: 0; z-index: 2;
+  display: flex; flex-direction: column; align-items: center; justify-content: center;
+  padding: 12px 22px 24px 22px; background: var(--mmp-card); border-radius: 0 0 24px 24px; overflow-y: auto;
+  animation: mmp-sheet-in 0.26s cubic-bezier(0.2, 0.8, 0.2, 1);
+}
+.mmp-root.mmp-translucent .mmp-sheet { -webkit-backdrop-filter: blur(24px); backdrop-filter: blur(24px); }
+.mmp-icon { display: flex; align-items: center; justify-content: center; width: 72px; height: 72px; margin: 10px auto 18px auto; border-radius: 50%; flex-shrink: 0; animation: mmp-pop 0.45s cubic-bezier(0.2, 1.4, 0.4, 1); }
+.mmp-icon svg { width: 36px; height: 36px; fill: none; stroke: currentColor; stroke-width: 2.6; stroke-linecap: round; stroke-linejoin: round; }
+.mmp-icon svg path { stroke-dasharray: 60; stroke-dashoffset: 60; animation: mmp-draw 0.5s 0.2s ease forwards; }
+.mmp-icon[data-tone="success"] { background: var(--mmp-success-bg); color: var(--mmp-success); }
+.mmp-icon[data-tone="danger"] { background: var(--mmp-danger-bg); color: var(--mmp-danger); }
+.mmp-icon[data-tone="warn"] { background: var(--mmp-warn-bg); color: var(--mmp-warn); }
+.mmp-title { margin: 0 0 10px 0; font-size: 22px; font-weight: 700; line-height: inherit; color: var(--mmp-text); }
+.mmp-pill { display: inline-block; max-width: 100%; padding: 6px 12px; margin-bottom: 14px; background: var(--mmp-panel); border: 1px solid var(--mmp-border); border-radius: 10px; font-size: 13px; font-weight: 600; color: var(--mmp-sub); overflow-wrap: anywhere; }
+.mmp-text { margin: 0 0 6px 0; font-size: 15px; color: var(--mmp-sub); overflow-wrap: anywhere; }
+.mmp-detail-text { max-width: 100%; max-height: 84px; margin: 4px 0 0 0; overflow-y: auto; font-size: 12px; line-height: 1.4; color: var(--mmp-sub); opacity: 0.85; overflow-wrap: anywhere; }
+.mmp-actions { display: flex; flex-direction: column; gap: 10px; width: 100%; margin-top: 18px; }
+
+@keyframes mmp-fade { from { opacity: 0; } to { opacity: 1; } }
+@keyframes mmp-rise { from { opacity: 0; transform: translateY(18px) scale(0.97); } to { opacity: 1; transform: none; } }
+@keyframes mmp-screen-in { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } }
+@keyframes mmp-sheet-in { from { opacity: 0; transform: translateY(16px); } to { opacity: 1; transform: none; } }
+@keyframes mmp-qr-in { from { opacity: 0; transform: scale(0.94); } to { opacity: 1; transform: none; } }
+@keyframes mmp-pulse { 0%, 100% { opacity: 0.88; transform: scale(1); } 50% { opacity: 1; transform: scale(1.05); } }
+@keyframes mmp-sweep { 0% { transform: translateX(-110%); } 100% { transform: translateX(260%); } }
+@keyframes mmp-shimmer { from { background-position: 200% 0; } to { background-position: -200% 0; } }
+@keyframes mmp-ping { 0% { transform: scale(1); opacity: 0.7; } 100% { transform: scale(2.6); opacity: 0; } }
+@keyframes mmp-spin { to { transform: rotate(360deg); } }
+@keyframes mmp-pop { from { opacity: 0; transform: scale(0.6); } to { opacity: 1; transform: none; } }
+@keyframes mmp-draw { to { stroke-dashoffset: 0; } }
+@keyframes mmp-ellipsis { 0% { content: ""; } 25% { content: "."; } 50% { content: ".."; } 75% { content: "..."; } }
+
+@media (max-width: 380px) {
+  .mmp-root { padding: 10px; }
+  .mmp-screen { padding: 6px 16px 18px 16px; }
+  .mmp-qr { width: 204px; height: 204px; }
+}
+@media (prefers-reduced-motion: reduce) {
+  .mmp-root, .mmp-root *, .mmp-root *::before, .mmp-root *::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; }
+  .mmp-icon svg path { stroke-dashoffset: 0; }
+  .mmp-loader-bar { width: 100%; opacity: 0.25; }
+}
+`;

package/src/types.ts

@@ -0,0 +1,117 @@
+export type MMPayLanguage = 'en' | 'mm';
+
+export type MMPayTransport = 'auto' | 'websocket' | 'polling';
+
+export type MMPayTerminalStatus = 'SUCCESS' | 'FAILED' | 'EXPIRED' | 'CANCELLED';
+
+export interface IDesignOptions {
+  mode?: 'light' | 'dark' | 'light-translucent' | 'dark-translucent' | 'auto';
+  color?: string;
+}
+
+export interface SDKOptions {
+  baseUrl?: string;
+  environment?: 'sandbox' | 'production';
+  merchantName?: string;
+  /**
+   * Interval of the HTTP polling fallback, in milliseconds.
+   */
+  pollInterval?: number;
+  /**
+   * How payment status reaches the browser. `auto` (default) uses a WebSocket
+   * and falls back to HTTP polling when a socket cannot be established.
+   */
+  transport?: MMPayTransport;
+  /**
+   * Seconds the shopper has to pay before the modal shows "Expired".
+   * Default and maximum: 900 (15 minutes). Minimum: 60.
+   */
+  timeoutSeconds?: number;
+  /**
+   * Language the modal opens in. The shopper can still switch, and their
+   * choice is remembered.
+   */
+  language?: MMPayLanguage | 'my';
+  design?: IDesignOptions;
+}
+
+export interface ICreateTokenRequestParams {
+  amount?: number;
+  orderId: string;
+  nonce: string;
+}
+
+export interface ICreateTokenResponse {
+  token: string;
+}
+
+export interface ICreatePaymentRequestParams {
+  amount: number;
+  orderId: string;
+  callbackUrl?: string;
+  customMessage?: string;
+  nonce: string;
+}
+
+export interface ICreatePaymentResponse {
+  orderId: string;
+  amount: number;
+  status: 'PENDING' | 'SUCCESS' | 'FAILED' | 'REFUNDED' | 'CANCELLED' | 'EXPIRED';
+  currency: string;
+  vendorQrRefId: string;
+  qr: string;
+  createdAt: string;
+}
+
+export interface IPaymentShowRequestParams {
+  orderId: string;
+  nonce: string;
+}
+
+export interface IPaymentShowResponse {
+  orderId: string;
+  amount: number;
+  status: 'PENDING' | 'SUCCESS' | 'FAILED' | 'REFUNDED' | 'CANCELLED' | 'EXPIRED';
+  currency: string;
+  vendorQrRefId: string;
+  qr: string;
+  createdAt: string;
+}
+
+export interface ICancelPaymentRequestParams {
+  orderId: string;
+  nonce: string;
+}
+
+export interface ICancelPaymentResponse {
+  success: boolean;
+}
+
+export interface IPollingRequest {
+  orderId: string;
+  nonce: string;
+}
+
+export interface IPollingResponse {
+  status: 'PENDING' | 'SUCCESS' | 'FAILED' | 'REFUNDED' | 'CANCELLED' | 'EXPIRED';
+  vendorQrRefId?: string;
+  transactionRefId?: string;
+  orderId?: string;
+  amount?: number;
+}
+
+export interface IStreamTicketResponse {
+  ticket: string;
+  expiresIn: number;
+}
+
+export interface IModalEventResult {
+  success?: boolean;
+  created?: boolean;
+  cancelled?: boolean;
+  expired?: boolean;
+  failed?: boolean;
+  orderId?: string;
+  amount?: number;
+  vendorQrRefId?: string;
+}