@v-miniapp/apis 1.0.14 → 1.0.17

package/dist/api/index.d.ts

@@ -1,7 +1,9 @@
+import { IVsfAddCalendarEventAsync } from '../types/api/add-calendar-event';
 import { IVsfGetSystemInfoAsync } from '../types/api/get-system-info';
 import { IVsfClearStorageAsync } from '../types/api/clear-storage';
 import { IVsfGetClipboardAsync } from '../types/api/get-clipboard';
 import { IVsfSetClipboardAsync } from '../types/api/set-clipboard';
+import { IVsfSetNavigationBarAsync } from '../types/api/set-navigation-bar';
 import { IVsfExitMiniAppAsync } from '../types/api/exit-miniapp';
 import { IVsfGetSettingAsync } from '../types/api/get-setting';
 import { IVsfOpenSettingAsync } from '../types/api/open-setting';
@@ -13,14 +15,17 @@ import { IVsfShareAppAsync } from '../types/api/share-app';
 import { IVsfSetStorageAsync } from '../types/api/set-storage';
 import { IVsfGetStorageAsync } from '../types/api/get-storage';
 import { IVsfRemoveStorageAsync } from '../types/api/remove-storage';
+import { IVsfReportAnalyticsAsync } from '../types/api/report-analytics';
 import { IVsfGetStorageInfoAsync } from '../types/api/get-storage-info';
 import { IVsfAlertAsync } from '../types/api/alert';
 import { IVsfConfirmAsync } from '../types/api/confirm';
+import { IVsfConfirmBeforeExitAsync } from '../types/api/confirm-before-exit';
 import { IVsfPromptAsync } from '../types/api/prompt';
 import { IVsfShowToastAsync } from '../types/api/show-toast';
 import { IVsfShowLoadingAsync } from '../types/api/show-loading';
 import { IVsfShowActionSheetAsync } from '../types/api/show-action-sheet';
 import { IVsfChooseImageAsync } from '../types/api/choose-image';
+import { IVsfChoosePhoneContactAsync } from '../types/api/choose-phone-contact';
 import { IVsfGetImageInfoAsync } from '../types/api/get-image-info';
 import { IVsfCompressImageAsync } from '../types/api/compress-image';
 import { IVsfRequestAsync } from '../types/api/request';
@@ -49,11 +54,14 @@ import { IVsfHideLoadingAsync } from '../types/api';
 import { IVsf } from '../types/vsf';
 export declare const apisSync: IVsf;
 export declare const apisAsync: {
+    addCalendarEvent: IVsfAddCalendarEventAsync;
     getSystemInfo: IVsfGetSystemInfoAsync;
     clearStorage: IVsfClearStorageAsync;
     getClipboard: IVsfGetClipboardAsync;
     setClipboard: IVsfSetClipboardAsync;
+    setNavigationBar: IVsfSetNavigationBarAsync;
     exitMiniApp: IVsfExitMiniAppAsync;
+    confirmBeforeExit: IVsfConfirmBeforeExitAsync;
     getSetting: IVsfGetSettingAsync;
     openSetting: IVsfOpenSettingAsync;
     openAppSetting: IVsfOpenAppSettingAsync;
@@ -64,6 +72,7 @@ export declare const apisAsync: {
     setStorage: IVsfSetStorageAsync;
     getStorage: IVsfGetStorageAsync;
     removeStorage: IVsfRemoveStorageAsync;
+    reportAnalytics: IVsfReportAnalyticsAsync;
     getStorageInfo: IVsfGetStorageInfoAsync;
     alert: IVsfAlertAsync;
     confirm: IVsfConfirmAsync;
@@ -73,6 +82,7 @@ export declare const apisAsync: {
     hideLoading: IVsfHideLoadingAsync;
     showActionSheet: IVsfShowActionSheetAsync;
     chooseImage: IVsfChooseImageAsync;
+    choosePhoneContact: IVsfChoosePhoneContactAsync;
     getImageInfo: IVsfGetImageInfoAsync;
     compressImage: IVsfCompressImageAsync;
     request: IVsfRequestAsync;

package/dist/api/index.js

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

package/dist/types/api/add-calendar-event.d.ts

@@ -0,0 +1,23 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Tham số cho API addCalendarEvent
+ */
+export type IVsfAddCalendarEventOptions = {
+    /** Tiêu đề của sự kiện */
+    title: string;
+    /** Thời gian bắt đầu (UTC), định dạng: YYYY-MM-DDTHH:mm:ss.SSSZ */
+    startDate: string;
+    /** Thời gian kết thúc (UTC), định dạng: YYYY-MM-DDTHH:mm:ss.SSSZ */
+    endDate: string;
+    /** Địa điểm tổ chức sự kiện */
+    location?: string;
+    /** Sự kiện có diễn ra cả ngày hay không */
+    allDay?: boolean;
+    /** URL liên quan đến sự kiện (chỉ hỗ trợ trên iOS) */
+    url?: string;
+    /** Ghi chú (notes trên iOS) hoặc mô tả (description trên Android) liên quan đến sự kiện */
+    notes?: string;
+};
+export type IVsfAddCalendarEventOptionsWithCallback = IVsfOptionsWithCallback<IVsfAddCalendarEventOptions, void>;
+export type IVsfAddCalendarEvent = (options: IVsfAddCalendarEventOptionsWithCallback) => void;
+export type IVsfAddCalendarEventAsync = (options: IVsfAddCalendarEventOptions) => Promise<void>;

package/dist/types/api/choose-phone-contact.d.ts

@@ -0,0 +1,17 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Kết quả trả về khi chọn liên hệ điện thoại
+ */
+export type IVsfChoosePhoneContactData = {
+    /** Tên hiển thị của liên hệ */
+    full_name: string;
+    /** Số điện thoại được chọn */
+    phone_number: string;
+};
+/**
+ * Tham số cho API choosePhoneContact (không có tham số)
+ */
+export type IVsfChoosePhoneContactOptions = void;
+export type IVsfChoosePhoneContactOptionsWithCallback = IVsfOptionsWithCallback<IVsfChoosePhoneContactOptions, IVsfChoosePhoneContactData>;
+export type IVsfChoosePhoneContact = (options?: IVsfChoosePhoneContactOptionsWithCallback) => void;
+export type IVsfChoosePhoneContactAsync = (options?: IVsfChoosePhoneContactOptions) => Promise<IVsfChoosePhoneContactData>;

package/dist/types/api/confirm-before-exit.d.ts

@@ -0,0 +1,13 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Params for confirmBeforeExit API
+ */
+export type IVsfConfirmBeforeExitOptions = {
+    /** Enable or disable exit confirmation */
+    enable: boolean;
+    /** Message to show in the confirmation popup */
+    message?: string;
+};
+export type IVsfConfirmBeforeExitOptionsWithCallback = IVsfOptionsWithCallback<IVsfConfirmBeforeExitOptions, void>;
+export type IVsfConfirmBeforeExit = (options: IVsfConfirmBeforeExitOptionsWithCallback) => void;
+export type IVsfConfirmBeforeExitAsync = (options: IVsfConfirmBeforeExitOptions) => Promise<void>;

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

@@ -1,8 +1,11 @@
+export * from './add-calendar-event';
 export * from './alert';
 export * from './choose-image';
+export * from './choose-phone-contact';
 export * from './clear-storage';
 export * from './compress-image';
 export * from './confirm';
+export * from './confirm-before-exit';
 export * from './get-default-payment-method';
 export * from './download-file';
 export * from './exit-miniapp';
@@ -25,10 +28,12 @@ export * from './open-setting';
 export * from './preview-image';
 export * from './prompt';
 export * from './remove-storage';
+export * from './report-analytics';
 export * from './request';
 export * from './save-image';
 export * from './scan';
 export * from './set-clipboard';
+export * from './set-navigation-bar';
 export * from './set-storage';
 export * from './share-app';
 export * from './show-action-sheet';

package/dist/types/api/report-analytics.d.ts

@@ -0,0 +1,8 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Tham số cho API reportAnalytics (dữ liệu analytics tùy ý)
+ */
+export type IVsfReportAnalyticsOptions = Record<string, any>;
+export type IVsfReportAnalyticsOptionsWithCallback = IVsfOptionsWithCallback<IVsfReportAnalyticsOptions, void>;
+export type IVsfReportAnalytics = (name: string, options?: IVsfReportAnalyticsOptionsWithCallback) => void;
+export type IVsfReportAnalyticsAsync = (name: string, options?: IVsfReportAnalyticsOptions) => Promise<void>;

package/dist/types/api/set-navigation-bar.d.ts

@@ -0,0 +1,21 @@
+import { IVsfOptionsWithCallback } from '../common';
+/**
+ * Tham số cho API setNavigationBar
+ */
+export type IVsfSetNavigationBarOptions = {
+    /** Tiêu đề thanh điều hướng */
+    title?: string;
+    /** URL hoặc đường dẫn ảnh cho thanh điều hướng */
+    image?: string;
+    /** Màu nền thanh tiêu đề */
+    titleBarColor?: string;
+    /** Màu viền dưới thanh điều hướng */
+    borderBottomColor?: string;
+    /** Đặt lại thanh điều hướng về mặc định hay không */
+    reset?: boolean;
+    /** Giao diện thanh điều hướng: dark hoặc light */
+    theme?: 'dark' | 'light';
+};
+export type IVsfSetNavigationBarOptionsWithCallback = IVsfOptionsWithCallback<IVsfSetNavigationBarOptions, void>;
+export type IVsfSetNavigationBar = (options?: IVsfSetNavigationBarOptionsWithCallback) => void;
+export type IVsfSetNavigationBarAsync = (options?: IVsfSetNavigationBarOptions) => Promise<void>;

package/dist/types/api/show-payment-method.d.ts

@@ -25,7 +25,7 @@ export type IVsfPaymentMethod = {
 /**
  * Kết quả trả về khi người dùng chọn phương thức thanh toán (mảng các phương thức)
  */
-export type IVsfShowPaymentMethodData = IVsfPaymentMethod[];
+export type IVsfShowPaymentMethodData = IVsfPaymentMethod;
 /**
  * Tham số để hiển thị danh sách phương thức thanh toán
  */

package/dist/types/vsf.d.ts

@@ -1,7 +1,9 @@
+import { IVsfAddCalendarEvent } from './api/add-calendar-event';
 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 { IVsfSetNavigationBar } from './api/set-navigation-bar';
 import { IVsfExitMiniApp } from './api/exit-miniapp';
 import { IVsfGetSetting } from './api/get-setting';
 import { IVsfOpenSetting } from './api/open-setting';
@@ -13,14 +15,17 @@ 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 { IVsfReportAnalytics } from './api/report-analytics';
 import { IVsfGetStorageInfo } from './api/get-storage-info';
 import { IVsfAlert } from './api/alert';
 import { IVsfConfirm } from './api/confirm';
+import { IVsfConfirmBeforeExit } from './api/confirm-before-exit';
 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 { IVsfChoosePhoneContact } from './api/choose-phone-contact';
 import { IVsfGetImageInfo } from './api/get-image-info';
 import { IVsfCompressImage } from './api/compress-image';
 import { IVsfRequest } from './api/request';
@@ -55,6 +60,22 @@ import { IVsfHideLoading } from './api';
  * Tất cả API sử dụng callback pattern với `success`, `fail`, và `complete`.
  */
 export type IVsf = {
+    /**
+     * Thêm sự kiện vào lịch (calendar) của thiết bị.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (bắt buộc) - Tiêu đề của sự kiện
+     * @param options.startDate - `string` (bắt buộc) - Thời gian bắt đầu (UTC), định dạng: YYYY-MM-DDTHH:mm:ss.SSSZ
+     * @param options.endDate - `string` (bắt buộc) - Thời gian kết thúc (UTC), định dạng: YYYY-MM-DDTHH:mm:ss.SSSZ
+     * @param options.location - `string` (tùy chọn) - Địa điểm tổ chức sự kiện
+     * @param options.allDay - `boolean` (tùy chọn) - Sự kiện có diễn ra cả ngày hay không
+     * @param options.url - `string` (tùy chọn) - URL liên quan đến sự kiện (chỉ hỗ trợ trên iOS)
+     * @param options.notes - `string` (tùy chọn) - Ghi chú (notes trên iOS) hoặc mô tả (description trên Android) liên quan đến sự kiện
+     * @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
+     */
+    addCalendarEvent: IVsfAddCalendarEvent;
     /**
      * Lấy thông tin hệ thống và thiết bị.
      *
@@ -109,6 +130,21 @@ export type IVsf = {
      * @param options.complete - `() => void` - Callback khi hoàn tất
      */
     setClipboard: IVsfSetClipboard;
+    /**
+     * Cấu hình thanh điều hướng (navigation bar).
+     *
+     * @param options - Tham số cấu hình
+     * @param options.title - `string` (tùy chọn) - Tiêu đề thanh điều hướng
+     * @param options.image - `string` (tùy chọn) - URL hoặc đường dẫn ảnh cho thanh điều hướng
+     * @param options.titleBarColor - `string` (tùy chọn) - Màu nền thanh tiêu đề
+     * @param options.borderBottomColor - `string` (tùy chọn) - Màu viền dưới thanh điều hướng
+     * @param options.reset - `boolean` (tùy chọn) - Đặt lại thanh điều hướng về mặc định
+     * @param options.theme - `'dark' | 'light'` (tùy chọn) - Giao diện: dark hoặc light
+     * @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
+     */
+    setNavigationBar: IVsfSetNavigationBar;
     /**
      * Thoát mini app hiện tại và quay về host app.
      *
@@ -118,6 +154,17 @@ export type IVsf = {
      * @param options.complete - `() => void` - Callback khi hoàn tất
      */
     exitMiniApp: IVsfExitMiniApp;
+    /**
+     * Bật hoặc tắt xác nhận trước khi thoát mini app.
+     *
+     * @param options - Tham số cấu hình
+     * @param options.enable - `boolean` (bắt buộc) - Kích hoạt hay không việc xác nhận trước khi thoát
+     * @param options.message - `string` (tùy chọn) - Nội dung hiển thị trong popup xác nhận
+     * @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
+     */
+    confirmBeforeExit: IVsfConfirmBeforeExit;
     /**
      * Lấy cài đặt quyền hiện tại của mini app.
      *
@@ -233,6 +280,15 @@ export type IVsf = {
      * @param options.complete - `() => void` - Callback khi hoàn tất
      */
     removeStorage: IVsfRemoveStorage;
+    /**
+     * Gửi dữ liệu analytics (báo cáo sự kiện/tùy chỉnh).
+     *
+     * @param options - Tham số: object key-value tùy ý (Record<string, any>)
+     * @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
+     */
+    reportAnalytics: IVsfReportAnalytics;
     /**
      * Lấy thông tin về dung lượng local storage đang sử dụng.
      *
@@ -337,6 +393,17 @@ export type IVsf = {
      * @param options.complete - `() => void` - Callback khi hoàn tất (dù thành công hay thất bại)
      */
     chooseImage: IVsfChooseImage;
+    /**
+     * Mở danh bạ để người dùng chọn một liên hệ điện thoại.
+     *
+     * @param options - Tham số cấu hình (không có tham số)
+     * @param options.success - `(res) => void` - Callback khi thành công
+     *   - `res.full_name`: `string` - Tên hiển thị của liên hệ
+     *   - `res.phone_number`: `string` - Số điện thoại được chọn
+     * @param options.fail - `(error) => void` - Callback khi thất bại/hủy
+     * @param options.complete - `() => void` - Callback khi hoàn tất
+     */
+    choosePhoneContact: IVsfChoosePhoneContact;
     /**
      * Lấy thông tin của file ảnh.
      *

package/dist/utils/api.d.ts

@@ -1,4 +1,6 @@
 import { IVsfOptionsWithCallback } from '../types/common';
 type IVsfFunction = (options: IVsfOptionsWithCallback<any>) => void;
 export declare const getVsfPromiseFunction: <IVsfFunctionSync>(func: IVsfFunction) => IVsfFunctionSync;
+type IVsfFunctionWithName = (name: string, options: IVsfOptionsWithCallback<any>) => void;
+export declare const getVsfPromiseFunctionWithName: <IVsfFunctionSync>(func: IVsfFunctionWithName) => IVsfFunctionSync;
 export {};

package/dist/utils/api.js

@@ -1,10 +1,17 @@
-const t = (e) => ((r) => new Promise((s, n) => {
+const i = (e) => ((s) => new Promise((r, n) => {
   e({
-    ...r,
+    ...s,
     fail: n,
-    success: s
+    success: r
+  });
+})), o = (e) => ((s, r) => new Promise((n, t) => {
+  e(s, {
+    ...r,
+    fail: t,
+    success: n
   });
 }));
 export {
-  t as getVsfPromiseFunction
+  i as getVsfPromiseFunction,
+  o as getVsfPromiseFunctionWithName
 };

package/package.json

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