@mmpay/browser 0.0.0-stage → 1.3.1

package/dist/esm/api.d.ts

@@ -0,0 +1,26 @@
+import { ICancelPaymentRequestParams, ICancelPaymentResponse, ICreatePaymentRequestParams, ICreatePaymentResponse, ICreateTokenRequestParams, ICreateTokenResponse, IPaymentShowRequestParams, IPaymentShowResponse, IPollingRequest, IPollingResponse, IStreamTicketResponse } from './types';
+export declare class MMPayApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class MMPayAPI {
+    private baseUrl;
+    private environment;
+    private publishableKey;
+    private tokenKey;
+    constructor(baseUrl: string, environment: 'sandbox' | 'production', publishableKey: string);
+    setToken(token: string | null): void;
+    getToken(): string | null;
+    private call;
+    createToken(payload: ICreateTokenRequestParams): Promise<ICreateTokenResponse>;
+    showPayment(payload: IPaymentShowRequestParams): Promise<IPaymentShowResponse>;
+    cancelPayment(payload: ICancelPaymentRequestParams): Promise<ICancelPaymentResponse>;
+    createPayment(payload: ICreatePaymentRequestParams): Promise<ICreatePaymentResponse>;
+    pollPayment(payload: IPollingRequest): Promise<IPollingResponse>;
+    /**
+     * A WebSocket handshake cannot carry the publishable key or session token,
+     * so the authenticated API issues a short-lived, single-use ticket for it.
+     */
+    createStreamTicket(payload: IPollingRequest): Promise<IStreamTicketResponse>;
+    getStreamUrl(ticket: string): string;
+}

package/dist/esm/deprecated/api.d.ts

@@ -0,0 +1,12 @@
+import { ICreatePaymentRequestParams, ICreatePaymentResponse, ICreateTokenRequestParams, ICreateTokenResponse } from '../types';
+export declare class DeprecatedMMPayAPI {
+    private baseUrl;
+    private environment;
+    private publishableKey;
+    private tokenKey;
+    constructor(environment: 'sandbox' | 'production', publishableKey: string);
+    setToken(token: string | null): void;
+    private call;
+    createToken(payload: ICreateTokenRequestParams): Promise<ICreateTokenResponse>;
+    createPayment(payload: ICreatePaymentRequestParams): Promise<ICreatePaymentResponse>;
+}

package/dist/esm/deprecated/showPaymentModal.d.ts

@@ -0,0 +1,6 @@
+import { ICreatePaymentRequestParams, IModalEventResult } from '../types';
+/**
+ * @deprecated This method is deprecated. Please migrate to the .pay() method.
+ */
+export declare function legacyShowPaymentModal(this: any, // Binds the parent MMPaySDK instance context
+params: ICreatePaymentRequestParams, onComplete: (result: IModalEventResult) => void): Promise<void>;

package/dist/esm/functions/api.d.ts

@@ -0,0 +1,12 @@
+import { ICreatePaymentRequestParams, ICreatePaymentResponse, ICreateTokenRequestParams, ICreateTokenResponse } from '../types';
+export declare class XMMPayAPI {
+    private baseUrl;
+    private environment;
+    private publishableKey;
+    private tokenKey;
+    constructor(environment: 'sandbox' | 'production', publishableKey: string);
+    setToken(token: string | null): void;
+    private call;
+    createToken(payload: ICreateTokenRequestParams): Promise<ICreateTokenResponse>;
+    createPayment(payload: ICreatePaymentRequestParams): Promise<ICreatePaymentResponse>;
+}

package/dist/esm/functions/showPaymentModal.d.ts

@@ -0,0 +1,2 @@
+import { ICreatePaymentRequestParams, IModalEventResult } from '../types';
+export declare function showPaymentModal(this: any, params: ICreatePaymentRequestParams, onComplete: (result: IModalEventResult) => void): Promise<void>;

package/dist/esm/i18n.d.ts

@@ -0,0 +1,13 @@
+import { MMPayLanguage } from './types';
+export declare function normalizeLanguage(value: unknown): MMPayLanguage | null;
+/**
+ * A missing translation falls back to English so a screen can never render
+ * blank text, whichever language is selected.
+ */
+export declare function translate(language: MMPayLanguage, key: string, params?: Record<string, string>): string;
+/**
+ * The shopper's own choice wins, then the merchant's configured language, then
+ * the browser language.
+ */
+export declare function resolveInitialLanguage(preferred?: string): MMPayLanguage;
+export declare function rememberLanguage(language: MMPayLanguage): void;

package/dist/esm/index.d.ts

@@ -0,0 +1,65 @@
+import { MMPayAPI } from './api';
+import { ICreatePaymentRequestParams, IModalEventResult, IPollingRequest, MMPayLanguage, SDKOptions } from './types';
+import { MMPayUI, MMPayUIHandlers } from './ui';
+export declare class MMPaySDK {
+    private POLL_INTERVAL_MS;
+    private TIMEOUT_SECONDS;
+    private readonly CACHE_KEY;
+    private environment;
+    private transport;
+    protected merchantName: string;
+    private onCompleteCallback;
+    private statusWatcher;
+    private countdownIntervalId;
+    private pendingApiResponse;
+    private pendingPaymentPayload;
+    private flowId;
+    private settled;
+    private cancelling;
+    private creating;
+    protected api: MMPayAPI;
+    protected ui: MMPayUI;
+    constructor(publishableKey: string, options?: SDKOptions);
+    /**
+     * Switches the modal language. Works at any time, including while a payment
+     * is on screen, and is remembered for the shopper's next visit.
+     */
+    setLanguage(language: MMPayLanguage | 'my'): void;
+    getLanguage(): MMPayLanguage;
+    showPaymentModal(params: ICreatePaymentRequestParams, onComplete: (result: IModalEventResult) => void): Promise<void>;
+    /**
+     * Spam guard: while the shopper has an order that is not paid, cancelled or
+     * expired, a new one is not created. The unfinished order is shown again
+     * instead. The server is asked first, so an order that finished in the
+     * meantime does not block a new one.
+     */
+    private _showUnfinishedOrder;
+    pay(orderId: string, onComplete: (result: IModalEventResult) => void): Promise<void>;
+    /**
+     * Starts a fresh flow. Anything still running from an earlier call is
+     * stopped, and its late responses are ignored through `flowId`.
+     */
+    private _beginFlow;
+    /** Keeps the loading state up briefly so a fast response does not flicker. */
+    private _holdLoading;
+    private _showQr;
+    private _failFlow;
+    /**
+     * Single exit for every finished payment, whichever source reported it
+     * first (socket, polling or the countdown), so the result screen and the
+     * merchant callback fire exactly once.
+     */
+    private _finish;
+    protected _getUiHandlers(): MMPayUIHandlers;
+    private _cancelPendingPayment;
+    protected _triggerEvent(eventData: IModalEventResult): void;
+    private _stopTimers;
+    protected _cleanup(): void;
+    protected _clearCache(): void;
+    private _readCache;
+    private _writeCache;
+    private _checkAndAutoResume;
+    private _resumePaymentState;
+    protected _startStatusWatch(payload: IPollingRequest): void;
+    protected _startCountdown(orderId: string, expireAt: number): void;
+}