@vqh2602/mini-app-sdk 1.0.6 → 1.0.8

package/dist/core/modules/auth.d.ts

@@ -1,8 +1,58 @@
 import { ITransport } from '../../transport/index.js';
-import { AccessTokenResult, AuthLoginOptions, AuthLoginResult, UserProfile } from '../types/index.js';
+import { BiometricStatus, BiometricAuthOptions, BiometricAuthResult, AccessTokenResult, AuthLoginOptions, AuthLoginResult, MiniAppTokenResult, UserProfile } from '../types/index.js';
+export interface PkceEntry {
+    verifier: string;
+    createdAt: number;
+    expiresAt: number;
+    timer?: any;
+}
+export interface PkceStoreConfig {
+    defaultTtlMs?: number;
+    maxPendingSessions?: number;
+}
+/**
+ * PkceVerifierStore enforces lifecycle constraints on generated PKCE code verifiers:
+ * 1. Time-To-Live (TTL): Automatically evicts and cleans up timers after expiry (default: 5 minutes).
+ * 2. Capacity bounds: Caps pending verifier sessions (default: max 20) with FIFO eviction of oldest entries.
+ * 3. Single-use consumption: Retrieving a verifier immediately burns it from the store.
+ * 4. Explicit teardown: Cleans up all pending verifiers on logout, error, or SDK destruction.
+ */
+export declare class PkceVerifierStore {
+    private entries;
+    private defaultTtlMs;
+    private maxPendingSessions;
+    constructor(config?: PkceStoreConfig);
+    set(authCode: string, verifier: string, ttlMs?: number): void;
+    get(authCode: string): string | undefined;
+    consume(authCode: string): string | undefined;
+    delete(authCode: string): boolean;
+    has(authCode: string): boolean;
+    size(): number;
+    clear(): void;
+    private cleanExpired;
+    private getOldestKey;
+}
+export declare const pkceStore: PkceVerifierStore;
 export declare class AuthModule {
     private transport;
     constructor(transport: ITransport);
+    /** Kiểm tra hỗ trợ phần cứng và sinh trắc học đã thiết lập/được phép dùng. */
+    checkBiometrics(): Promise<BiometricStatus>;
+    /** Xác thực cục bộ bằng sinh trắc học; yêu cầu phiên SuperApp đang đăng nhập. */
+    authenticateBiometric(options?: BiometricAuthOptions): Promise<BiometricAuthResult>;
+    requestCode(options?: {
+        codeChallenge?: string;
+        scopes?: string[];
+    }): Promise<{
+        authCode: string;
+        expiresIn: number;
+        appId: string;
+        scopes: string[];
+    }>;
+    exchangeCode(options: {
+        authCode: string;
+        codeVerifier?: string;
+    }): Promise<MiniAppTokenResult>;
     /**
      * Yêu cầu người dùng đăng nhập & cấp quyền truy cập
      */
@@ -20,11 +70,21 @@ export declare class AuthModule {
      */
     refreshToken(refreshToken?: string): Promise<AccessTokenResult>;
     /**
-     * Đăng xuất phiên làm việc hiện tại
+     * Đăng xuất phiên làm việc hiện tại và hủy toàn bộ phiên PKCE đang chờ
      */
     logout(): Promise<{
-        success: boolean;
-        message: string;
+        status: string;
+        timestamp: string;
     }>;
+    destroy(): void;
+    dispose(): void;
+}
+export declare class AuthBackend {
+    private transport;
+    constructor(transport: ITransport);
+    exchangeCode(authCode: string): Promise<MiniAppTokenResult>;
+    refreshToken(refreshToken: string): Promise<MiniAppTokenResult>;
+    destroy(): void;
+    dispose(): void;
 }
 //# sourceMappingURL=auth.d.ts.map

package/dist/core/modules/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/modules/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtG,qBAAa,UAAU;IACT,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAEzC;;OAEG;IACU,KAAK,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5E;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIzD;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD;;OAEG;IACU,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI5E;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGtE"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/modules/auth.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/auth.js

@@ -1,8 +1,173 @@
+/**
+ * PkceVerifierStore enforces lifecycle constraints on generated PKCE code verifiers:
+ * 1. Time-To-Live (TTL): Automatically evicts and cleans up timers after expiry (default: 5 minutes).
+ * 2. Capacity bounds: Caps pending verifier sessions (default: max 20) with FIFO eviction of oldest entries.
+ * 3. Single-use consumption: Retrieving a verifier immediately burns it from the store.
+ * 4. Explicit teardown: Cleans up all pending verifiers on logout, error, or SDK destruction.
+ */
+export class PkceVerifierStore {
+    entries = new Map();
+    defaultTtlMs;
+    maxPendingSessions;
+    constructor(config = {}) {
+        this.defaultTtlMs = config.defaultTtlMs ?? 5 * 60 * 1000; // 5 minutes default
+        this.maxPendingSessions = config.maxPendingSessions ?? 20; // max 20 pending requests
+    }
+    set(authCode, verifier, ttlMs) {
+        if (!authCode || !verifier)
+            return;
+        this.cleanExpired();
+        // Enforce capacity bounds: evict oldest entry if limit reached
+        if (this.entries.size >= this.maxPendingSessions) {
+            const oldestKey = this.getOldestKey();
+            if (oldestKey) {
+                this.delete(oldestKey);
+            }
+        }
+        const effectiveTtl = ttlMs && ttlMs > 0 ? ttlMs : this.defaultTtlMs;
+        const now = Date.now();
+        const expiresAt = now + effectiveTtl;
+        const timer = setTimeout(() => {
+            this.delete(authCode);
+        }, effectiveTtl);
+        if (timer && typeof timer === 'object' && typeof timer.unref === 'function') {
+            timer.unref();
+        }
+        this.entries.set(authCode, {
+            verifier,
+            createdAt: now,
+            expiresAt,
+            timer,
+        });
+    }
+    get(authCode) {
+        const entry = this.entries.get(authCode);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.delete(authCode);
+            return undefined;
+        }
+        return entry.verifier;
+    }
+    consume(authCode) {
+        const entry = this.entries.get(authCode);
+        if (!entry)
+            return undefined;
+        this.delete(authCode);
+        if (Date.now() > entry.expiresAt) {
+            return undefined;
+        }
+        return entry.verifier;
+    }
+    delete(authCode) {
+        const entry = this.entries.get(authCode);
+        if (!entry)
+            return false;
+        if (entry.timer) {
+            clearTimeout(entry.timer);
+        }
+        return this.entries.delete(authCode);
+    }
+    has(authCode) {
+        const entry = this.entries.get(authCode);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.delete(authCode);
+            return false;
+        }
+        return true;
+    }
+    size() {
+        this.cleanExpired();
+        return this.entries.size;
+    }
+    clear() {
+        for (const entry of this.entries.values()) {
+            if (entry.timer) {
+                clearTimeout(entry.timer);
+            }
+        }
+        this.entries.clear();
+    }
+    cleanExpired() {
+        const now = Date.now();
+        for (const [key, entry] of this.entries.entries()) {
+            if (now > entry.expiresAt) {
+                if (entry.timer)
+                    clearTimeout(entry.timer);
+                this.entries.delete(key);
+            }
+        }
+    }
+    getOldestKey() {
+        let oldestKey;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.entries.entries()) {
+            if (entry.createdAt < oldestTime) {
+                oldestTime = entry.createdAt;
+                oldestKey = key;
+            }
+        }
+        return oldestKey;
+    }
+}
+export const pkceStore = new PkceVerifierStore();
+function url64(bytes) {
+    return btoa(String.fromCharCode(...bytes)).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
 export class AuthModule {
     transport;
     constructor(transport) {
         this.transport = transport;
     }
+    /** Kiểm tra hỗ trợ phần cứng và sinh trắc học đã thiết lập/được phép dùng. */
+    checkBiometrics() {
+        return this.transport.invoke('auth.checkBiometrics');
+    }
+    /** Xác thực cục bộ bằng sinh trắc học; yêu cầu phiên SuperApp đang đăng nhập. */
+    authenticateBiometric(options = {}) {
+        return this.transport.invoke('auth.authenticateBiometric', options);
+    }
+    async requestCode(options = {}) {
+        let challenge = options.codeChallenge;
+        if (!challenge) {
+            const verifier = url64(crypto.getRandomValues(new Uint8Array(32)));
+            challenge = url64(new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(verifier))));
+            const result = await this.transport.invoke('auth.requestCode', { codeChallenge: challenge, codeChallengeMethod: 'S256', scopes: options.scopes || ['user.getBasicInfo'] });
+            const ttlMs = result.expiresIn && result.expiresIn > 0 && result.expiresIn <= 3600
+                ? result.expiresIn * 1000
+                : undefined;
+            pkceStore.set(result.authCode, verifier, ttlMs);
+            return result;
+        }
+        return this.transport.invoke('auth.requestCode', {
+            ...options,
+            codeChallenge: challenge,
+            codeChallengeMethod: 'S256',
+        });
+    }
+    async exchangeCode(options) {
+        const codeVerifier = options.codeVerifier || pkceStore.consume(options.authCode);
+        if (!codeVerifier) {
+            throw { code: 'INVALID_PARAMS', message: 'Request a PKCE auth code first or provide codeVerifier' };
+        }
+        try {
+            const result = await this.transport.invoke('auth.exchangeCode', {
+                authCode: options.authCode,
+                codeVerifier,
+            });
+            return result;
+        }
+        catch (error) {
+            pkceStore.delete(options.authCode);
+            throw error;
+        }
+        finally {
+            pkceStore.delete(options.authCode);
+        }
+    }
     /**
      * Yêu cầu người dùng đăng nhập & cấp quyền truy cập
      */
@@ -28,10 +193,48 @@ export class AuthModule {
         return this.transport.invoke('auth.refreshToken', { refreshToken });
     }
     /**
-     * Đăng xuất phiên làm việc hiện tại
+     * Đăng xuất phiên làm việc hiện tại và hủy toàn bộ phiên PKCE đang chờ
      */
     async logout() {
-        return this.transport.invoke('auth.logout');
+        try {
+            return await this.transport.invoke('auth.logout');
+        }
+        finally {
+            pkceStore.clear();
+        }
+    }
+    destroy() {
+        pkceStore.clear();
+    }
+    dispose() {
+        this.destroy();
+    }
+}
+export class AuthBackend {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async exchangeCode(authCode) {
+        const codeVerifier = pkceStore.consume(authCode);
+        if (!codeVerifier)
+            throw { code: 'INVALID_PARAMS', message: 'Request a PKCE auth code first' };
+        try {
+            const result = await this.transport.invoke('auth.exchangeCode', { authCode, codeVerifier });
+            return result;
+        }
+        finally {
+            pkceStore.delete(authCode);
+        }
+    }
+    refreshToken(refreshToken) {
+        return this.transport.invoke('auth.refreshToken', { refreshToken });
+    }
+    destroy() {
+        pkceStore.clear();
+    }
+    dispose() {
+        this.destroy();
     }
 }
 //# sourceMappingURL=auth.js.map

package/dist/core/modules/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/core/modules/auth.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IAE7C;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,UAA4B,EAAE;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAkB,YAAY,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAoB,qBAAqB,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAc,qBAAqB,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CAAC,YAAqB;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAoB,mBAAmB,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAwC,aAAa,CAAC,CAAC;IACrF,CAAC;CACF"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/core/modules/auth.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/debug.d.ts

@@ -0,0 +1,14 @@
+import { ITransport } from '../../transport/index.js';
+export declare class DebugModule {
+    private transport;
+    constructor(transport: ITransport);
+    /**
+     * Kiểm tra phản hồi echo từ SuperApp Bridge
+     */
+    echo(payload: any): Promise<any>;
+    /**
+     * Giả lập lỗi native để kiểm tra xử lý ngoại lệ
+     */
+    simulateFailure(type: string): Promise<any>;
+}
+//# sourceMappingURL=debug.d.ts.map

package/dist/core/modules/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/core/modules/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAEzC;;OAEG;IACU,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAI7C;;OAEG;IACU,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAGzD"}

package/dist/core/modules/debug.js

@@ -0,0 +1,19 @@
+export class DebugModule {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * Kiểm tra phản hồi echo từ SuperApp Bridge
+     */
+    async echo(payload) {
+        return this.transport.invoke('debug.echo', payload);
+    }
+    /**
+     * Giả lập lỗi native để kiểm tra xử lý ngoại lệ
+     */
+    async simulateFailure(type) {
+        return this.transport.invoke('debug.simulateFailure', { type });
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/core/modules/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/core/modules/debug.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IAE7C;;OAEG;IACI,KAAK,CAAC,IAAI,CAAC,OAAY;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAAC,IAAY;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/core/modules/device.d.ts

@@ -3,6 +3,9 @@ import { BatteryInfo, DeviceInfo, KeepScreenOptions, NetworkInfo } from '../type
 export declare class DeviceModule {
     private transport;
     constructor(transport: ITransport);
+    getContacts(options?: {
+        query?: string;
+    }): Promise<import('../types/index.js').ContactsResult>;
     /**
      * Lấy mức pin và trạng thái sạc
      */
@@ -22,7 +25,7 @@ export declare class DeviceModule {
     /**
      * Kích hoạt rung phản hồi xúc giác (Haptic Feedback)
      */
-    vibrate(style?: 'light' | 'medium' | 'heavy'): Promise<void>;
+    vibrate(style?: 'light' | 'medium' | 'heavy'): Promise<any>;
     /**
      * Giữ màn hình luôn bật / luôn sáng
      */

package/dist/core/modules/device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/core/modules/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5F,qBAAa,YAAY;IACX,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAEzC;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjD;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjD;;OAEG;IACU,OAAO,CAAC,KAAK,GAAE,OAAO,GAAG,QAAQ,GAAG,OAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF;;OAEG;IACU,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAMrH"}
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/core/modules/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5F,qBAAa,YAAY;IACX,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAClC,WAAW,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,cAAc,CAAC;IAIzG;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjD;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjD;;OAEG;IACU,OAAO,CAAC,KAAK,GAAE,OAAO,GAAG,QAAQ,GAAG,OAAiB,GAAG,OAAO,CAAC,GAAG,CAAC;IAIjF;;OAEG;IACU,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAMrH"}

package/dist/core/modules/device.js

@@ -3,6 +3,9 @@ export class DeviceModule {
     constructor(transport) {
         this.transport = transport;
     }
+    getContacts(options = {}) {
+        return this.transport.invoke('getContacts', options);
+    }
     /**
      * Lấy mức pin và trạng thái sạc
      */
@@ -31,7 +34,7 @@ export class DeviceModule {
      * Kích hoạt rung phản hồi xúc giác (Haptic Feedback)
      */
     async vibrate(style = 'light') {
-        await this.transport.invoke('device.vibrate', { style });
+        return this.transport.invoke('device.vibrate', { style });
     }
     /**
      * Giữ màn hình luôn bật / luôn sáng

package/dist/core/modules/device.js.map

@@ -1 +1 @@
-{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../src/core/modules/device.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IAE7C;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAc,uBAAuB,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAc,uBAAuB,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAa,sBAAsB,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAa,sBAAsB,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,QAAsC,OAAO;QAChE,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,OAAqC;QAC3D,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE;YAC3B,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAA8C,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC1G,CAAC;CACF"}
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../src/core/modules/device.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IACtC,WAAW,CAAC,UAA8B,EAAE;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAc,uBAAuB,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAc,uBAAuB,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAa,sBAAsB,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAa,sBAAsB,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,QAAsC,OAAO;QAChE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,OAAqC;QAC3D,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE;YAC3B,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAA8C,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC1G,CAAC;CACF"}

package/dist/core/modules/file.d.ts

@@ -0,0 +1,38 @@
+import { ITransport } from '../../transport/index.js';
+export declare class FileModule {
+    private transport;
+    constructor(transport: ITransport);
+    /**
+     * Lưu tệp tin vào bộ nhớ ứng dụng
+     */
+    saveFile(options: {
+        data: string;
+        fileName: string;
+        mimeType?: string;
+    }): Promise<{
+        success: boolean;
+        filePath: string;
+    }>;
+    /**
+     * Chọn tệp từ máy (PDF, Docx, Image...)
+     */
+    pickFile(options?: {
+        allowedExtensions?: string[];
+        mimeTypes?: string[];
+    }): Promise<{
+        name: string;
+        size: number;
+        uri: string;
+        mimeType?: string;
+    }>;
+    /**
+     * Xem trước tệp tài liệu bằng trình đọc native
+     */
+    filePreview(options: {
+        filePath: string;
+        title?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/core/modules/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/core/modules/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,qBAAa,UAAU;IACT,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAEzC;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC7F,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAIF;;OAEG;IACU,QAAQ,CAAC,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC;QACnG,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAIF;;OAEG;IACU,WAAW,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAGvG"}

package/dist/core/modules/file.js

@@ -0,0 +1,25 @@
+export class FileModule {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * Lưu tệp tin vào bộ nhớ ứng dụng
+     */
+    async saveFile(options) {
+        return this.transport.invoke('saveFile', options);
+    }
+    /**
+     * Chọn tệp từ máy (PDF, Docx, Image...)
+     */
+    async pickFile(options = {}) {
+        return this.transport.invoke('pickFile', options);
+    }
+    /**
+     * Xem trước tệp tài liệu bằng trình đọc native
+     */
+    async filePreview(options) {
+        return this.transport.invoke('filePreview', options);
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/core/modules/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/core/modules/file.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IAE7C;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,OAA8D;QAIlF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,UAAkE,EAAE;QAMxF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW,CAAC,OAA6C;QACpE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/core/modules/lifecycle.d.ts

@@ -3,6 +3,18 @@ export type LifecycleListener = (data?: any) => void;
 export declare class LifecycleModule {
     private transport;
     constructor(transport: ITransport);
+    /**
+     * Đăng ký lắng nghe sự kiện bất kỳ từ SuperApp
+     */
+    on(event: string, callback: (payload: any) => void): () => void;
+    /**
+     * Huỷ lắng nghe sự kiện
+     */
+    off(event: string, callback: (payload: any) => void): void;
+    /**
+     * Phát sự kiện trong Mini App
+     */
+    emit(event: string, payload: any): void;
     /**
      * Đăng ký lắng nghe sự kiện khi Mini App hiển thị ra màn hình chính (Foreground)
      */
@@ -15,5 +27,16 @@ export declare class LifecycleModule {
      * Đăng ký lắng nghe lỗi hệ thống
      */
     onError(callback: LifecycleListener): () => void;
+    /**
+     * Lắng nghe sự kiện thay đổi phiên đăng nhập (login / logout)
+     */
+    onSessionChanged(callback: (payload: {
+        state: 'logged_in' | 'logged_out';
+        userId?: string;
+    }) => void): () => void;
+    /**
+     * Lắng nghe trạng thái thanh toán đơn hàng cập nhật
+     */
+    onPaymentStatusChanged(callback: (payload: any) => void): () => void;
 }
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/modules/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/modules/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;AAErD,qBAAa,eAAe;IACd,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAEzC;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAIzD;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAIzD;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;CAGxD"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/modules/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;AAErD,qBAAa,eAAe;IACd,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAEzC;;OAEG;IACI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAItE;;OAEG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIjE;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAI9C;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAIzD;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAIzD;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAIvD;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAIxH;;OAEG;IACI,sBAAsB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;CAG5E"}

package/dist/core/modules/lifecycle.js

@@ -3,6 +3,24 @@ export class LifecycleModule {
     constructor(transport) {
         this.transport = transport;
     }
+    /**
+     * Đăng ký lắng nghe sự kiện bất kỳ từ SuperApp
+     */
+    on(event, callback) {
+        return this.transport.on(event, callback);
+    }
+    /**
+     * Huỷ lắng nghe sự kiện
+     */
+    off(event, callback) {
+        this.transport.off(event, callback);
+    }
+    /**
+     * Phát sự kiện trong Mini App
+     */
+    emit(event, payload) {
+        this.transport.emit(event, payload);
+    }
     /**
      * Đăng ký lắng nghe sự kiện khi Mini App hiển thị ra màn hình chính (Foreground)
      */
@@ -21,5 +39,17 @@ export class LifecycleModule {
     onError(callback) {
         return this.transport.on('appError', callback);
     }
+    /**
+     * Lắng nghe sự kiện thay đổi phiên đăng nhập (login / logout)
+     */
+    onSessionChanged(callback) {
+        return this.transport.on('auth.sessionChanged', callback);
+    }
+    /**
+     * Lắng nghe trạng thái thanh toán đơn hàng cập nhật
+     */
+    onPaymentStatusChanged(callback) {
+        return this.transport.on('payment.statusChanged', callback);
+    }
 }
 //# sourceMappingURL=lifecycle.js.map

package/dist/core/modules/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/core/modules/lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IAE7C;;OAEG;IACI,SAAS,CAAC,QAA2B;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,QAA2B;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,QAA2B;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/core/modules/lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;IAAG,CAAC;IAE7C;;OAEG;IACI,EAAE,CAAC,KAAa,EAAE,QAAgC;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,KAAa,EAAE,QAAgC;QACxD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,KAAa,EAAE,OAAY;QACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,QAA2B;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,QAA2B;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,QAA2B;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,QAAmF;QACzG,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,sBAAsB,CAAC,QAAgC;QAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACF"}