@v-miniapp/apis 1.0.13 → 1.0.14

package/dist/types/vsf.d.ts

@@ -0,0 +1,687 @@
+import { IVsfGetSystemInfo } from './api/get-system-info';
+import { IVsfClearStorage } from './api/clear-storage';
+import { IVsfGetClipboard } from './api/get-clipboard';
+import { IVsfSetClipboard } from './api/set-clipboard';
+import { IVsfExitMiniApp } from './api/exit-miniapp';
+import { IVsfGetSetting } from './api/get-setting';
+import { IVsfOpenSetting } from './api/open-setting';
+import { IVsfOpenAppSetting } from './api/open-app-setting';
+import { IVsfOpenNativeAppStore } from './api/open-native-app-store';
+import { IVsfOpenDeeplink } from './api/open-deeplink';
+import { IVsfOpenPublicDeepLink } from './api/open-public-deep-link';
+import { IVsfShareApp } from './api/share-app';
+import { IVsfSetStorage } from './api/set-storage';
+import { IVsfGetStorage } from './api/get-storage';
+import { IVsfRemoveStorage } from './api/remove-storage';
+import { IVsfGetStorageInfo } from './api/get-storage-info';
+import { IVsfAlert } from './api/alert';
+import { IVsfConfirm } from './api/confirm';
+import { IVsfPrompt } from './api/prompt';
+import { IVsfShowToast } from './api/show-toast';
+import { IVsfShowLoading } from './api/show-loading';
+import { IVsfShowActionSheet } from './api/show-action-sheet';
+import { IVsfChooseImage } from './api/choose-image';
+import { IVsfGetImageInfo } from './api/get-image-info';
+import { IVsfCompressImage } from './api/compress-image';
+import { IVsfRequest } from './api/request';
+import { IVsfDownloadFile } from './api/download-file';
+import { IVsfUploadFile } from './api/upload-file';
+import { IVsfGetLocation } from './api/get-location';
+import { IVsfScan } from './api/scan';
+import { IVsfMakePhoneCall } from './api/make-phone-call';
+import { IVsfPreviewImage } from './api/preview-image';
+import { IVsfSaveImage } from './api/save-image';
+import { IVsfGetAuthCode } from './api/get-auth-code';
+import { IVsfGetUserInfo } from './api/get-user-info';
+import { IVsfInitPayment } from './api/init-payment';
+import { IVsfShowPaymentMethod } from './api/show-payment-method';
+import { IVsfGetDefaultPaymentMethod } from './api/get-default-payment-method';
+import { IVsfOnBeaconBiscovery } from './api/on-beacon-discovery';
+import { IVsfStartBeaconDiscovery } from './api/start-beacon-discovery';
+import { IVsfStopBeaconDiscovery } from './api/stop-beacon-discovery';
+import { IVsfOffBeaconDiscovery } from './api/off-beacon-discovery';
+import { IVsfGetBeaconDiscoveryStatus } from './api/get-beacon-discovery-status';
+import { IVsfBioMetricsLocalAuth } from './api/bio-metrics/local-auth';
+import { IVsfBioMetricsIsSupported } from './api/bio-metrics/is-supported';
+import { IVsfBioMetricsKeyExists } from './api/bio-metrics/key-exists';
+import { IVsfBioMetricsCreateKey } from './api/bio-metrics/create-key';
+import { IVsfBioMetricsCreateSignature } from './api/bio-metrics/create-signature';
+import { IVsfBioMetricsDeleteKey } from './api/bio-metrics/delete-key';
+import { IVsfHideLoading } from './api';
+/**
+ * V-App Super Framework (VSF) API Interface
+ *
+ * Cung cấp quyền truy cập vào các tính năng native của thiết bị và nền tảng V-App.
+ * Tất cả API sử dụng callback pattern với `success`, `fail`, và `complete`.
+ */
+export type IVsf = {
+    /**
+     * Lấy thông tin hệ thống và thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.keys - `Array<keyof SystemInfo>` (tùy chọn) - Các thuộc tính cần lấy. Nếu không truyền sẽ lấy tất cả
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.app`: `string` - Tên super app (VD: V-app)
+     *   - `res.brand`: `string` - Nhãn hiệu thiết bị (iPhone, Samsung,...)
+     *   - `res.currentBattery`: `number` - Mức pin hiện tại (0-1)
+     *   - `res.model`: `string` - Model thiết bị
+     *   - `res.platform`: `'ios' | 'android' | 'macos' | 'windows' | 'web' | 'native'`
+     *   - `res.system`: `'Android' | 'iOS' | 'iPhone OS' | 'iPadOS'`
+     *   - `res.version`: `string` - Phiên bản OS
+     *   - `res.hostVersion`: `string` - Phiên bản V App
+     *   - `res.runtimeVersion`: `string` - Phiên bản runtime
+     *   - `res.freeStorage`: `number` - Dung lượng trống (bytes)
+     *   - `res.screenWidth/screenHeight`: `number` - Kích thước màn hình (pixel)
+     *   - `res.windowWidth/windowHeight`: `number` - Kích thước cửa sổ (pixel)
+     *   - `res.titleBarHeight/statusBarHeight`: `number` - Chiều cao bar (pixel)
+     *   - `res.locale`: `'vi' | 'en'` - Ngôn ngữ
+     *   - `res.deviceId`: `string` - UUID thiết bị
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getSystemInfo: IVsfGetSystemInfo;
+    /**
+     * Xóa toàn bộ dữ liệu trong local storage.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `() => void` - Callback khi xóa thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    clearStorage: IVsfClearStorage;
+    /**
+     * Lấy nội dung từ clipboard của thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.text`: `string` - Nội dung text trong clipboard
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getClipboard: IVsfGetClipboard;
+    /**
+     * Sao chép nội dung vào clipboard của thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.text - `string` (bắt buộc) - Nội dung text cần sao chép
+     * @param options.success - `() => void` - Callback khi sao chép thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    setClipboard: IVsfSetClipboard;
+    /**
+     * Thoát mini app hiện tại và quay về host app.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `() => void` - Callback khi thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    exitMiniApp: IVsfExitMiniApp;
+    /**
+     * Lấy cài đặt quyền hiện tại của mini app.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.authSetting`: `Record<string, boolean>` - Trạng thái các quyền đã được cấp
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getSetting: IVsfGetSetting;
+    /**
+     * Ẩn loading hiện tại.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `() => void` - Callback khi thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    hideLoading: IVsfHideLoading;
+    /**
+     * Mở trang cài đặt quyền của mini app.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.authSetting`: `Record<string, boolean>` - Trạng thái quyền sau khi thay đổi
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    openSetting: IVsfOpenSetting;
+    /**
+     * Mở trang cài đặt ứng dụng của thiết bị cho host app.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `() => void` - Callback khi thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    openAppSetting: IVsfOpenAppSetting;
+    /**
+     * Mở trang app store native (App Store/Google Play).
+     *
+     * @param options - Tham số cấu hình
+     * @param options.appleStoreId - `string` (bắt buộc) - ID ứng dụng trên Apple App Store
+     * @param options.googlePlayId - `string` (bắt buộc) - ID ứng dụng trên Google Play Store
+     * @param options.success - `(res: boolean) => void` - Callback khi thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    openNativeAppStore: IVsfOpenNativeAppStore;
+    /**
+     * Mở deep link.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.url - `string` (bắt buộc) - URL của deep link cần mở
+     * @param options.success - `(res: boolean) => void` - Callback khi thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    openDeeplink: IVsfOpenDeeplink;
+    /**
+     * Mở public deep link.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.url - `string` (bắt buộc) - URL của deep link cần mở
+     * @param options.inAppBrowser - `boolean` (tùy chọn) - Mở trong in-app browser hay không. Mặc định: `false`
+     * @param options.success - `(res: boolean) => void` - Callback khi thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    openPublicDeepLink: IVsfOpenPublicDeepLink;
+    /**
+     * Chia sẻ mini app với người khác sử dụng chức năng share native.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (tùy chọn) - Tiêu đề chia sẻ
+     * @param options.desc - `string` (tùy chọn) - Mô tả chia sẻ
+     * @param options.path - `string` (tùy chọn) - Đường dẫn trong miniapp
+     * @param options.url - `string` (tùy chọn) - URL chia sẻ
+     * @param options.success - `() => void` - Callback khi chia sẻ thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    shareApp: IVsfShareApp;
+    /**
+     * Lưu dữ liệu vào local storage với key được chỉ định.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.key - `string` (bắt buộc) - Key để lưu dữ liệu
+     * @param options.data - `string | object` (bắt buộc) - Dữ liệu cần lưu
+     * @param options.success - `() => void` - Callback khi lưu thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    setStorage: IVsfSetStorage;
+    /**
+     * Lấy dữ liệu từ local storage theo key.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.key - `string` (bắt buộc) - Key của dữ liệu cần lấy
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.data`: `string | object` - Dữ liệu được lưu trữ
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getStorage: IVsfGetStorage;
+    /**
+     * Xóa dữ liệu khỏi local storage theo key.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.key - `string` (bắt buộc) - Key của dữ liệu cần xóa
+     * @param options.success - `() => void` - Callback khi xóa thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    removeStorage: IVsfRemoveStorage;
+    /**
+     * Lấy thông tin về dung lượng local storage đang sử dụng.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.keys`: `string[]` - Danh sách các key đang lưu
+     *   - `res.currentSize`: `number` - Dung lượng đang sử dụng (bytes)
+     *   - `res.limitSize`: `number` - Dung lượng tối đa (bytes)
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getStorageInfo: IVsfGetStorageInfo;
+    /**
+     * Hiển thị hộp thoại thông báo (alert).
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (tùy chọn) - Tiêu đề hộp thoại
+     * @param options.content - `string` (tùy chọn) - Nội dung hộp thoại
+     * @param options.buttonText - `string` (tùy chọn) - Text hiển thị trên nút bấm
+     * @param options.success - `() => void` - Callback khi đóng alert
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    alert: IVsfAlert;
+    /**
+     * Hiển thị hộp thoại xác nhận với nút OK/Hủy.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (tùy chọn) - Tiêu đề hộp thoại
+     * @param options.content - `string` (tùy chọn) - Nội dung hộp thoại
+     * @param options.confirmButtonText - `string` (tùy chọn) - Text nút xác nhận
+     * @param options.cancelButtonText - `string` (tùy chọn) - Text nút hủy
+     * @param options.success - `(res) => void` - Callback khi người dùng chọn
+     *   - `res.confirm`: `boolean` - `true` nếu bấm xác nhận, `false` nếu bấm hủy
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    confirm: IVsfConfirm;
+    /**
+     * Hiển thị hộp thoại nhập liệu (prompt).
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (tùy chọn) - Tiêu đề hộp thoại
+     * @param options.message - `string` (tùy chọn) - Thông điệp hiển thị
+     * @param options.placeholder - `string` (tùy chọn) - Placeholder cho ô nhập
+     * @param options.okButton - `string` (tùy chọn) - Text nút OK
+     * @param options.cancelButton - `string` (tùy chọn) - Text nút Cancel
+     * @param options.success - `(res) => void` - Callback khi người dùng chọn
+     *   - `res.ok`: `boolean` - `true` nếu bấm OK, `false` nếu bấm Cancel
+     *   - `res.inputValue`: `string` - Giá trị người dùng đã nhập
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    prompt: IVsfPrompt;
+    /**
+     * Hiển thị thông báo toast.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.type - `string` (tùy chọn) - Loại toast: `'success'`, `'fail'`, `'none'`,...
+     * @param options.content - `string` (tùy chọn) - Nội dung hiển thị
+     * @param options.buttonText - `string` (tùy chọn) - Text hiển thị trên nút
+     * @param options.duration - `number` (tùy chọn) - Thời gian hiển thị (ms)
+     * @param options.success - `() => void` - Callback khi hiển thị thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    showToast: IVsfShowToast;
+    /**
+     * Hiển thị indicator loading.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.content - `string` (tùy chọn) - Nội dung hiển thị kèm loading
+     * @param options.success - `() => void` - Callback khi hiển thị thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    showLoading: IVsfShowLoading;
+    /**
+     * Hiển thị action sheet với nhiều tùy chọn.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (tùy chọn) - Tiêu đề action sheet
+     * @param options.items - `string[]` (bắt buộc) - Danh sách các mục để chọn
+     * @param options.cancelButton - `string` (tùy chọn) - Text nút hủy
+     * @param options.success - `(res) => void` - Callback khi người dùng chọn
+     *   - `res.index`: `number` - Vị trí mục được chọn (0-indexed)
+     * @param options.fail - `(error) => void` - Callback khi thất bại/hủy
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    showActionSheet: IVsfShowActionSheet;
+    /**
+     * Mở trình chọn ảnh từ thư viện hoặc camera.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.count - `number` (tùy chọn) - Số lượng tối đa ảnh có thể chọn. Mặc định: `1`
+     * @param options.includeBase64 - `boolean` (tùy chọn) - Nếu `true`, kết quả trả về sẽ có thêm data base64. Mặc định: `false`
+     * @param options.sourceType - `Array<'camera' | 'album'>` (tùy chọn) - Nguồn lấy ảnh. Mặc định: `['camera', 'album']`
+     * @param options.success - `(res) => void` - Callback khi chọn ảnh thành công
+     *   - `res.filePaths`: `string[]` - Đường dẫn các ảnh được chọn (dùng để display hoặc upload)
+     *   - `res.tempFiles`: `Array<{path, size, width, height, data?}>` - Thông tin chi tiết từng ảnh
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất (dù thành công hay thất bại)
+     */
+    chooseImage: IVsfChooseImage;
+    /**
+     * Lấy thông tin của file ảnh.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.src - `string` (bắt buộc) - Đường dẫn hoặc URL của ảnh
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.width`: `number` - Chiều rộng ảnh (pixel)
+     *   - `res.height`: `number` - Chiều cao ảnh (pixel)
+     *   - `res.orientation`: `'up' | 'down' | 'left' | 'right' | 'up-mirrored' | 'down-mirrored' | 'left-mirrored' | 'right-mirrored'`
+     *   - `res.path`: `string` - Đường dẫn ảnh
+     *   - `res.type`: `string` - Loại ảnh (mime type)
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getImageInfo: IVsfGetImageInfo;
+    /**
+     * Nén ảnh để giảm dung lượng file.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.filePaths - `string[]` (bắt buộc) - Danh sách đường dẫn các ảnh cần nén
+     * @param options.options - `object` (tùy chọn) - Tùy chọn nén
+     *   - `options.quality`: `number` - Chất lượng ảnh sau khi nén (0-100)
+     *   - `options.maxWidth`: `number` - Chiều rộng tối đa (pixel)
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.filePaths`: `string[]` - Danh sách đường dẫn các ảnh đã nén
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    compressImage: IVsfCompressImage;
+    /**
+     * Thực hiện các network request HTTP/HTTPS.
+     *
+     * Do mini app chạy trong môi trường JavaScript cô lập không có `fetch` hay `XMLHttpRequest`,
+     * sử dụng API này cho tất cả network request. Chỉ hỗ trợ HTTPS.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.url - `string` (bắt buộc) - Đường dẫn muốn gọi tới
+     * @param options.headers - `object` (tùy chọn) - Cấu hình headers
+     * @param options.method - `string` (tùy chọn) - Phương thức: `'GET'`, `'POST'`, `'PUT'`, `'DELETE'`,... Mặc định: `'GET'`
+     * @param options.data - `object` (tùy chọn) - Data kèm theo trong request
+     * @param options.timeout - `number` (tùy chọn) - Timeout (ms). Mặc định: `30000` (30s)
+     * @param options.dataType - `string` (tùy chọn) - Định dạng response: `'JSON'`, `'text'`, `'base64'`, `'arraybuffer'`. Mặc định: `'JSON'`
+     * @param options.includeHeader - `boolean` (tùy chọn) - Có bao gồm headers trong response không
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.data`: `string` - Dữ liệu trả về (định dạng phụ thuộc dataType)
+     *   - `res.headers`: `object` - Headers trả về (nếu includeHeader: true)
+     *   - `res.status`: `number` - Response code. Mặc định: `200`
+     *   - `res.statusText`: `string` - Thông điệp tương ứng. Mặc định: `'OK'`
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    request: IVsfRequest;
+    /**
+     * Download file từ URL và lưu tạm trên thiết bị.
+     *
+     * Khác với `apis.request` trả về raw data, `downloadFile` lưu file và trả về đường dẫn tạm thời.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.url - `string` (bắt buộc) - Đường dẫn của file muốn download
+     * @param options.headers - `object` (tùy chọn) - Cấu hình headers
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.filePath`: `string` - Đường dẫn của file sau khi download
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    downloadFile: IVsfDownloadFile;
+    /**
+     * Upload file từ thiết bị lên server.
+     *
+     * Chỉ hỗ trợ upload đường dẫn file tạm thời (từ `chooseImage` hoặc `downloadFile`).
+     *
+     * @param options - Tham số cấu hình
+     * @param options.url - `string` (bắt buộc) - Đường dẫn server muốn upload
+     * @param options.method - `string` (tùy chọn) - Phương thức. Mặc định: `'POST'`
+     * @param options.fileName - `string` (bắt buộc) - Tên file làm key trong form data
+     * @param options.filePath - `string` (tùy chọn) - Đường dẫn tạm thời của file
+     * @param options.filePaths - `string[]` (tùy chọn) - Mảng đường dẫn (upload multiple)
+     * @param options.formData - `object` (tùy chọn) - Các field khác của form
+     * @param options.fileType - `string` (bắt buộc) - Loại file: `'image'`, `'video'`, `'audio'`
+     * @param options.headers - `object` (tùy chọn) - Cấu hình headers
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.data`: `string` - Dữ liệu trả về từ server
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    uploadFile: IVsfUploadFile;
+    /**
+     * Lấy vị trí địa lý hiện tại của thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.cacheTimeout - `number` (tùy chọn) - Thời gian cache (giây). Mặc định: `30`
+     * @param options.type - `number` (tùy chọn) - Độ chính xác: `0` = WiFi (thấp), `1` = GPS (cao)
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.latitude`: `number` - Vĩ độ
+     *   - `res.longitude`: `number` - Kinh độ
+     *   - `res.altitude`: `number` - Độ cao so với mực nước biển (mét)
+     *   - `res.accuracy`: `number` - Độ chính xác vị trí (mét)
+     *   - `res.altitudeAccuracy`: `number` - Độ chính xác độ cao (mét)
+     *   - `res.heading`: `number` - Hướng di chuyển
+     *   - `res.speed`: `number` - Tốc độ di chuyển (m/s)
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getLocation: IVsfGetLocation;
+    /**
+     * Mở trình quét mã vạch/QR code của thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res: string) => void` - Callback khi quét thành công, trả về nội dung mã
+     * @param options.fail - `(error) => void` - Callback khi thất bại/hủy
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    scan: IVsfScan;
+    /**
+     * Thực hiện cuộc gọi điện thoại đến số được chỉ định.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.number - `number` (bắt buộc) - Số điện thoại cần gọi
+     * @param options.success - `() => void` - Callback khi bắt đầu cuộc gọi
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    makePhoneCall: IVsfMakePhoneCall;
+    /**
+     * Xem trước ảnh trong trình xem gallery toàn màn hình.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.urls - `string[]` (bắt buộc) - Danh sách URL các ảnh cần xem
+     * @param options.current - `number` (tùy chọn) - Vị trí ảnh hiện tại (0-indexed)
+     * @param options.enablesavephoto - `boolean` (tùy chọn) - Cho phép lưu ảnh
+     * @param options.enableShowPhotoDownload - `boolean` (tùy chọn) - Hiển thị nút tải ảnh
+     * @param options.success - `() => void` - Callback khi mở thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    previewImage: IVsfPreviewImage;
+    /**
+     * Lưu ảnh vào thư viện ảnh của thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.url - `string` (bắt buộc) - Đường dẫn hoặc URL của ảnh cần lưu
+     * @param options.success - `() => void` - Callback khi lưu thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    saveImage: IVsfSaveImage;
+    /**
+     * Lấy mã xác thực (authorization code) cho việc đăng nhập người dùng.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.scopes - `Array<'profile' | 'phone' | 'email'>` (tùy chọn) - Các scope quyền cần yêu cầu
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.authCode`: `string` - Mã xác thực
+     *   - `res.authSuccessScopes`: `string[]` - Các scope được cấp quyền
+     *   - `res.authErrorScopes`: `Record<string, string>` - Các scope bị lỗi và lý do
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getAuthCode: IVsfGetAuthCode;
+    /**
+     * Lấy thông tin profile của người dùng hiện tại.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.avatar`: `string` - URL ảnh đại diện
+     *   - `res.name`: `string` - Tên người dùng
+     *   - `res.gender`: `string` (tùy chọn) - Giới tính
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getUserInfo: IVsfGetUserInfo;
+    /**
+     * Khởi tạo và xử lý giao dịch thanh toán.
+     *
+     * **Luồng thanh toán:**
+     * 1. Gọi `apis.showPaymentMethod` để người dùng chọn phương thức thanh toán
+     * 2. Tạo đơn hàng trên backend (xem tài liệu Payment API)
+     * 3. Gọi `apis.initPayment` để khởi tạo thanh toán
+     *
+     * **Lưu ý:** Mỗi `orderId` chỉ được sử dụng một lần.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.paymentApiKey - `string` (bắt buộc) - Payment API key tương ứng với điểm thanh toán
+     * @param options.orderInfo - `object` (bắt buộc) - Thông tin đơn hàng:
+     *   - `amount`: `number` (bắt buộc) - Số tiền thanh toán
+     *   - `currency`: `string` (bắt buộc) - Đơn vị tiền tệ (VD: `'VND'`)
+     *   - `description`: `string` (bắt buộc) - Mô tả đơn hàng
+     *   - `orderId`: `string` (bắt buộc) - Mã đơn hàng (unique, chỉ dùng 1 lần)
+     *   - `referenceId`: `string` (bắt buộc) - Mã tham chiếu
+     *   - `secureHash`: `string` (bắt buộc) - HMAC-SHA256 hash để verify
+     *   - `paymentMethodCode`: `string` - Mã phương thức thanh toán
+     *   - `providerId`: `string` - ID payment provider
+     *   - `userPaymentMethodId`: `string` (tùy chọn) - ID phương thức đã liên kết
+     *   - `paymentType`: `'2D' | '3D'` (tùy chọn) - Loại thanh toán. Mặc định: `'3D'`
+     *   - `businessUnitId`: `string` (tùy chọn) - Mã cơ sở kinh doanh (bắt buộc trên production)
+     *   - `branchId`: `string` (tùy chọn) - Mã chi nhánh (bắt buộc trên production)
+     *   - `orderInfo`: `object` (bắt buộc) - Thông tin chi tiết đơn hàng
+     * @param options.success - `(res: string) => void` - Callback khi thành công (luôn là `'success'`)
+     * @param options.fail - `(error: string) => void` - Callback khi thất bại (error message)
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    initPayment: IVsfInitPayment;
+    /**
+     * Hiển thị màn hình chọn phương thức thanh toán.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.paymentApiKey - `string` (bắt buộc) - Payment API key
+     * @param options.amount - `number` (tùy chọn) - Giá trị đơn hàng để lọc phương thức
+     * @param options.success - `(res) => void` - Callback khi người dùng chọn xong
+     *   - `res.category`: `string` - Danh mục phương thức
+     *   - `res.code`: `string` - Mã phương thức thanh toán
+     *   - `res.type`: `string` - Loại phương thức
+     *   - `res.iconUrl`: `string` - URL icon
+     *   - `res.name`: `string` - Tên phương thức
+     *   - `res.providerId`: `string` - ID nhà cung cấp
+     *   - `res.providerName`: `string` - Tên nhà cung cấp
+     *   - `res.paymentMethodId`: `string` - ID phương thức
+     *   - `res.userPaymentMethodId`: `string` - ID phương thức đã liên kết (nếu có)
+     * @param options.fail - `(error: string) => void` - Callback khi hủy/thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    showPaymentMethod: IVsfShowPaymentMethod;
+    /**
+     * Lấy phương thức thanh toán mặc định của người dùng.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.paymentApiKey - `string` (bắt buộc) - Payment API key
+     * @param options.success - `(res) => void` - Callback khi thành công (cùng format với showPaymentMethod)
+     * @param options.fail - `(error: string) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getDefaultPaymentMethod: IVsfGetDefaultPaymentMethod;
+    /**
+     * Đăng ký listener lắng nghe sự kiện phát hiện beacon.
+     *
+     * **Lưu ý:** Cùng callback reference được dùng để hủy đăng ký với `offBeaconDiscovery`.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.callback - `(data: BeaconInfo) => void` (bắt buộc) - Listener được gọi mỗi khi tìm được beacon
+     *   - `data.type`: `'iBeacon' | 'Eddystone'` - Loại beacon
+     *   - `data.data`: `object` - Dữ liệu beacon (uuid, major, minor, rssi, distance,...)
+     */
+    onBeaconDiscovery: IVsfOnBeaconBiscovery;
+    /**
+     * Bắt đầu quét các thiết bị beacon Bluetooth gần đó.
+     *
+     * **Lưu ý:** Cần người dùng cấp quyền truy cập Bluetooth và Location.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `() => void` - Callback khi bắt đầu quét thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    startBeaconDiscovery: IVsfStartBeaconDiscovery;
+    /**
+     * Dừng quét các thiết bị beacon Bluetooth.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `() => void` - Callback khi dừng thành công
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    stopBeaconDiscovery: IVsfStopBeaconDiscovery;
+    /**
+     * Xóa listener lắng nghe beacon discovery.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.callback - `() => void` (bắt buộc) - Listener cần xóa (cùng reference với onBeaconDiscovery)
+     */
+    offBeaconDiscovery: IVsfOffBeaconDiscovery;
+    /**
+     * Lấy trạng thái quét beacon discovery hiện tại.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.data`: `'initializing' | 'started' | 'stopped'` - Trạng thái hiện tại
+     * @param options.fail - `(error) => void` - Callback khi thất bại
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    getBeaconDiscoveryStatus: IVsfGetBeaconDiscoveryStatus;
+    /**
+     * Các API xác thực sinh trắc học cho việc xác thực cục bộ an toàn và quản lý khóa mật mã.
+     */
+    bioMetrics: {
+        /**
+         * Thực hiện xác thực sinh trắc học cục bộ (Face ID, Touch ID, vân tay).
+         *
+         * @param options - Tham số cấu hình
+         * @param options.content - `string` (bắt buộc) - Nội dung hiển thị khi yêu cầu xác thực
+         * @param options.success - `(res: boolean) => void` - Callback khi thành công (`true`)
+         * @param options.fail - `(error) => void` - Callback khi thất bại
+         * @param options.complete - `() => void` - Callback khi hoàn tất
+         */
+        localAuth: IVsfBioMetricsLocalAuth;
+        /**
+         * Kiểm tra xem thiết bị có hỗ trợ xác thực sinh trắc học không.
+         *
+         * @param options - Tham số cấu hình
+         * @param options.success - `(res) => void` - Callback khi thành công
+         *   - `res.isSupported`: `boolean` - Có hỗ trợ sinh trắc học không
+         *   - `res.mode`: `string` (tùy chọn) - Chế độ: `'facial'`, `'fingerprint'`,...
+         *   - `res.error`: `string` (tùy chọn) - Thông báo lỗi nếu có
+         * @param options.fail - `(error) => void` - Callback khi thất bại
+         * @param options.complete - `() => void` - Callback khi hoàn tất
+         */
+        isSupported: IVsfBioMetricsIsSupported;
+        /**
+         * Kiểm tra xem khóa sinh trắc học có tồn tại không.
+         *
+         * @param options - Tham số cấu hình
+         * @param options.success - `(res: boolean) => void` - Callback khi thành công (`true` nếu tồn tại)
+         * @param options.fail - `(error) => void` - Callback khi thất bại
+         * @param options.complete - `() => void` - Callback khi hoàn tất
+         */
+        keyExists: IVsfBioMetricsKeyExists;
+        /**
+         * Tạo khóa mật mã mới được bảo vệ bằng sinh trắc học.
+         *
+         * @param options - Tham số cấu hình
+         * @param options.success - `(res) => void` - Callback khi thành công
+         *   - `res.publicKey`: `string` - Public key được tạo
+         * @param options.fail - `(error) => void` - Callback khi thất bại
+         * @param options.complete - `() => void` - Callback khi hoàn tất
+         */
+        createKey: IVsfBioMetricsCreateKey;
+        /**
+         * Tạo chữ ký mật mã sử dụng khóa được bảo vệ bằng sinh trắc học.
+         *
+         * @param options - Tham số cấu hình
+         * @param options.challenge - `string` (bắt buộc) - Chuỗi challenge để ký
+         * @param options.content - `string` (bắt buộc) - Nội dung cần ký
+         * @param options.success - `(res) => void` - Callback khi thành công
+         *   - `res.signature`: `string` - Chữ ký được tạo
+         * @param options.fail - `(error) => void` - Callback khi thất bại
+         * @param options.complete - `() => void` - Callback khi hoàn tất
+         */
+        createSignature: IVsfBioMetricsCreateSignature;
+        /**
+         * Xóa khóa mật mã được bảo vệ bằng sinh trắc học.
+         *
+         * @param options - Tham số cấu hình
+         * @param options.success - `(res: boolean) => void` - Callback khi thành công (`true`)
+         * @param options.fail - `(error) => void` - Callback khi thất bại
+         * @param options.complete - `() => void` - Callback khi hoàn tất
+         */
+        deleteKey: IVsfBioMetricsDeleteKey;
+    };
+};