@v-miniapp/apis 1.0.12 → 1.0.14

package/README.md

@@ -1,6 +1,6 @@
 # @v-miniapp/apis
 
-**@v-miniapp/apis** là bộ thư viện JavaScript API được thiết kế đặc biệt cho việc phát triển V-App. SDK này cung cấp đầy đủ các API để tương tác với nền tảng V-App, bao gồm các nhóm API cơ bản (thoát MiniApp, chia sẻ, thông tin hệ thống), giao diện (dialog, toast, loading, action sheet), media (ảnh, video, âm thanh), lưu trữ (local storage), network & cloud (HTTP request, upload/download), thanh toán (payment flow), và các API phần cứng (Bluetooth, Biometrics, Geo location). Thư viện hỗ trợ cả hai cách gọi API: dạng sync (callback-based) và async (Promise-based) để phù hợp với mọi phong cách lập trình.
+**@v-miniapp/apis** là bộ thư viện JavaScript API được thiết kế đặc biệt cho việc phát triển V-App.
 
 📚 **Tài liệu chính thức**: [Tổng quan về API | V-MiniApp](https://developer.v-app.vn/api/overview)
 

package/dist/api/index.d.ts

@@ -7,6 +7,8 @@ import { IVsfGetSettingAsync } from '../types/api/get-setting';
 import { IVsfOpenSettingAsync } from '../types/api/open-setting';
 import { IVsfOpenAppSettingAsync } from '../types/api/open-app-setting';
 import { IVsfOpenNativeAppStoreAsync } from '../types/api/open-native-app-store';
+import { IVsfOpenDeeplinkAsync } from '../types/api/open-deeplink';
+import { IVsfOpenPublicDeepLinkAsync } from '../types/api/open-public-deep-link';
 import { IVsfShareAppAsync } from '../types/api/share-app';
 import { IVsfSetStorageAsync } from '../types/api/set-storage';
 import { IVsfGetStorageAsync } from '../types/api/get-storage';
@@ -56,6 +58,8 @@ export declare const apisAsync: {
     openSetting: IVsfOpenSettingAsync;
     openAppSetting: IVsfOpenAppSettingAsync;
     openNativeStore: IVsfOpenNativeAppStoreAsync;
+    openDeeplink: IVsfOpenDeeplinkAsync;
+    openPublicDeepLink: IVsfOpenPublicDeepLinkAsync;
     shareApp: IVsfShareAppAsync;
     setStorage: IVsfSetStorageAsync;
     getStorage: IVsfGetStorageAsync;

package/dist/api/index.js

@@ -1,124 +1,130 @@
-import { getVsfPromiseFunction as t } from "../utils/api.js";
+import { getVsfPromiseFunction as o } from "../utils/api.js";
 const e = new Proxy({}, {
-  get(i, o) {
-    return typeof window.vsf[o] == "function" ? (...a) => window.vsf[o](...a) : window.vsf[o];
+  get(a, t) {
+    return typeof window.vsf[t] == "function" ? (...i) => window.vsf[t](...i) : window.vsf[t];
   }
 }), s = {
-  getSystemInfo: t(
+  getSystemInfo: o(
     e.getSystemInfo
   ),
-  clearStorage: t(
+  clearStorage: o(
     e.clearStorage
   ),
-  getClipboard: t(
+  getClipboard: o(
     e.getClipboard
   ),
-  setClipboard: t(
+  setClipboard: o(
     e.setClipboard
   ),
-  exitMiniApp: t(
+  exitMiniApp: o(
     e.exitMiniApp
   ),
-  getSetting: t(e.getSetting),
-  openSetting: t(
+  getSetting: o(e.getSetting),
+  openSetting: o(
     e.openSetting
   ),
-  openAppSetting: t(
+  openAppSetting: o(
     e.openAppSetting
   ),
-  openNativeStore: t(
+  openNativeStore: o(
     e.openNativeAppStore
   ),
-  shareApp: t(e.shareApp),
-  setStorage: t(e.setStorage),
-  getStorage: t(e.getStorage),
-  removeStorage: t(
+  openDeeplink: o(
+    e.openDeeplink
+  ),
+  openPublicDeepLink: o(
+    e.openPublicDeepLink
+  ),
+  shareApp: o(e.shareApp),
+  setStorage: o(e.setStorage),
+  getStorage: o(e.getStorage),
+  removeStorage: o(
     e.removeStorage
   ),
-  getStorageInfo: t(
+  getStorageInfo: o(
     e.getStorageInfo
   ),
-  alert: t(e.alert),
-  confirm: t(e.confirm),
-  prompt: t(e.prompt),
-  showToast: t(e.showToast),
-  showLoading: t(
+  alert: o(e.alert),
+  confirm: o(e.confirm),
+  prompt: o(e.prompt),
+  showToast: o(e.showToast),
+  showLoading: o(
     e.showLoading
   ),
-  hideLoading: t(
+  hideLoading: o(
     e.hideLoading
   ),
-  showActionSheet: t(
+  showActionSheet: o(
     e.showActionSheet
   ),
-  chooseImage: t(
+  chooseImage: o(
     e.chooseImage
   ),
-  getImageInfo: t(
+  getImageInfo: o(
     e.getImageInfo
   ),
-  compressImage: t(
+  compressImage: o(
     e.compressImage
   ),
-  request: t(e.request),
-  downloadFile: t(
+  request: o(e.request),
+  downloadFile: o(
     e.downloadFile
   ),
-  uploadFile: t(e.uploadFile),
-  getLocation: t(
+  uploadFile: o(e.uploadFile),
+  getLocation: o(
     e.getLocation
   ),
-  scan: t(e.scan),
-  makePhoneCall: t(
+  scan: o(e.scan),
+  makePhoneCall: o(
     e.makePhoneCall
   ),
-  previewImage: t(
+  previewImage: o(
     e.previewImage
   ),
-  saveImage: t(e.saveImage),
-  getAuthCode: t(
+  saveImage: o(e.saveImage),
+  getAuthCode: o(
     e.getAuthCode
   ),
-  getUserInfo: t(
+  getUserInfo: o(
     e.getUserInfo
   ),
-  initPayment: t(
+  initPayment: o(
     e.initPayment
   ),
-  showPaymentMethod: t(
+  showPaymentMethod: o(
     e.showPaymentMethod
   ),
-  getDefaultPaymentMethod: t(
+  getDefaultPaymentMethod: o(
     e.getDefaultPaymentMethod
   ),
-  startBeaconDiscovery: t(
+  startBeaconDiscovery: o(
     e.startBeaconDiscovery
   ),
-  stopBeaconDiscovery: t(
+  stopBeaconDiscovery: o(
     e.stopBeaconDiscovery
   ),
-  getBeaconDiscoveryStatus: t(
+  getBeaconDiscoveryStatus: o(
     e.getBeaconDiscoveryStatus
   ),
   onBeaconDiscovery: e.onBeaconDiscovery,
   offBeaconDiscovery: e.offBeaconDiscovery,
   bioMetrics: {
-    localAuth: t(
+    localAuth: o(
       e.bioMetrics.localAuth
     ),
-    isSupported: t(
+    isSupported: o(
       e.bioMetrics.isSupported
     ),
-    keyExists: t(
+    keyExists: o(
       e.bioMetrics.keyExists
     ),
-    createKey: t(
+    createKey: o(
       e.bioMetrics.createKey
     ),
-    createSignature: t(
+    createSignature: o(
       e.bioMetrics.createSignature
     ),
-    deleteKey: t(
+    deleteKey: o(
       e.bioMetrics.deleteKey
     )
   }

package/dist/types/api/index.d.ts

@@ -18,7 +18,9 @@ export * from './get-user-info';
 export * from './init-payment';
 export * from './make-phone-call';
 export * from './open-app-setting';
+export * from './open-deeplink';
 export * from './open-native-app-store';
+export * from './open-public-deep-link';
 export * from './open-setting';
 export * from './preview-image';
 export * from './prompt';

package/dist/types/api/open-deeplink.d.ts

@@ -0,0 +1,15 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Kết quả trả về sau khi mở deep link
+ */
+export type IVsfOpenDeeplinkData = boolean;
+/**
+ * Tham số để mở deep link
+ */
+export type IVsfOpenDeeplinkOptions = {
+    /** URL của deep link cần mở */
+    url: string;
+};
+export type IVsfOpenDeeplinkOptionsWithCallback = IVsfOptionsWithCallback<IVsfOpenDeeplinkOptions, IVsfOpenDeeplinkData>;
+export type IVsfOpenDeeplink = (options: IVsfOpenDeeplinkOptionsWithCallback) => void;
+export type IVsfOpenDeeplinkAsync = (options: IVsfOpenDeeplinkOptions) => Promise<IVsfOpenDeeplinkData>;

package/dist/types/api/open-public-deep-link.d.ts

@@ -0,0 +1,17 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Kết quả trả về sau khi mở public deep link
+ */
+export type IVsfOpenPublicDeepLinkData = boolean;
+/**
+ * Tham số để mở public deep link
+ */
+export type IVsfOpenPublicDeepLinkOptions = {
+    /** URL của deep link cần mở */
+    url: string;
+    /** Mở trong in-app browser hay không. Mặc định là false */
+    inAppBrowser?: boolean;
+};
+export type IVsfOpenPublicDeepLinkOptionsWithCallback = IVsfOptionsWithCallback<IVsfOpenPublicDeepLinkOptions, IVsfOpenPublicDeepLinkData>;
+export type IVsfOpenPublicDeepLink = (options: IVsfOpenPublicDeepLinkOptionsWithCallback) => void;
+export type IVsfOpenPublicDeepLinkAsync = (options: IVsfOpenPublicDeepLinkOptions) => Promise<IVsfOpenPublicDeepLinkData>;

package/dist/types/vsf.d.ts

@@ -7,6 +7,8 @@ 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';
@@ -165,6 +167,27 @@ export type IVsf = {
      * @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.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-miniapp/apis",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "type": "module",
   "files": [
     "dist",