zmp-sdk 2.47.2 → 2.48.1

package/index.d.ts

@@ -991,6 +991,43 @@ declare const ACTION: {
     MP_APP_LIFECYCLE_TRACKING: {
         skipJump: boolean;
     };
+    OPEN_DOCUMENT: {
+        skipJump: boolean;
+        errorList: {
+            all: {
+                "-10": {
+                    mapTo: {
+                        code: number;
+                        message: string;
+                    };
+                };
+                "-700": {
+                    mapTo: {
+                        code: number;
+                        message: string;
+                    };
+                };
+                "-701": {
+                    mapTo: {
+                        code: number;
+                        message: string;
+                    };
+                };
+                "-702": {
+                    mapTo: {
+                        code: number;
+                        message: string;
+                    };
+                };
+                "-703": {
+                    mapTo: {
+                        code: number;
+                        message: string;
+                    };
+                };
+            };
+        };
+    };
 };
 declare const AUTHEN_SCOPE_VALUES: readonly ["scope.userInfo", "scope.userLocation", "scope.userPhonenumber"];
 declare const GET_SETTINGS_SCOPE_VALUES: readonly ["scope.userInfo", "scope.userLocation", "scope.userPhonenumber", "scope.camera", "scope.micro"];
@@ -5656,6 +5693,100 @@ declare const CheckoutKit: {
     purchase: typeof purchase$1;
 };
 
+declare const openDocumentArgs: ZodObject<{
+    url: ZodString;
+    title: ZodOptional<ZodString>;
+    download: ZodOptional<ZodDefault<ZodBoolean>>;
+    edit: ZodOptional<ZodDefault<ZodBoolean>>;
+}, "strip", ZodTypeAny, {
+    title?: string | undefined;
+    download?: boolean | undefined;
+    edit?: boolean | undefined;
+    url: string;
+}, {
+    title?: string | undefined;
+    download?: boolean | undefined;
+    edit?: boolean | undefined;
+    url: string;
+}>[];
+/**
+ * API cho phép ứng dụng xem trực tiếp tài liệu (PDF) từ URL.
+ *
+ * @minimumVersion 2.47.0
+ * @zaloOnly Chỉ hoạt động khi chạy bên trong ứng dụng Zalo mobile.
+ * @param {string} url URL của tài liệu cần mở. Hiện chỉ hỗ trợ định dạng tài liệu PDF.
+ * @param {string} [title] Tiêu đề của tài liệu trên header bar. Mặc định lấy tên từ URL.
+ * @param {boolean} [download=false] Bật tính năng tải tài liệu. Mặc định là false.
+ * @param {boolean} [edit=false] Bật tính năng chỉnh sửa tài liệu (chỉ hỗ trợ trên ios). Mặc định là false.
+ *
+ * @example Mở tài liệu PDF từ URL:
+ * ```ts
+ * openDocument({
+ *   url: "https://pdfobject.com/pdf/sample.pdf"
+ * });
+ * ```
+ *
+ * @example Mở tài liệu PDF từ URL với tiêu đề tùy chỉnh:
+ * ```ts
+ * openDocument({
+ *   url: "https://pdfobject.com/pdf/sample.pdf",
+ *   title: "Tài liệu mẫu"
+ * });
+ * ```
+ *
+ * @example Mở tài liệu PDF từ URL với tiêu đề tùy chỉnh và mở tính năng tải xuống:
+ * ```ts
+ * openDocument({
+ *   url: "https://pdfobject.com/pdf/sample.pdf",
+ *   title: "Tài liệu mẫu",
+ *   download: true
+ * });
+ * ```
+ *
+ * @example Mở tài liệu PDF từ URL với tiêu đề tùy chỉnh và mở tính năng chỉnh sửa (chỉ hỗ trợ trên ios):
+ * ```ts
+ * openDocument({
+ *   url: "https://pdfobject.com/pdf/sample.pdf",
+ *   title: "Tài liệu mẫu",
+ *   edit: true
+ * });
+ * ```
+ */
+declare function openDocument(args: AsyncVoidCallback & TypeOf<(typeof openDocumentArgs)[0]>): Promise<void>;
+
+/**
+ * Lấy thông tin nguồn mở app.
+ *
+ * @minimumVersion 2.48.1
+ * @zaloOnly Chỉ hoạt động khi chạy bên trong ứng dụng Zalo mobile.
+ *
+ * @returns {Object} Trả về đối tượng chứa thông tin nguồn mở app.
+ * - `srcOpen`: Nguồn mở app.
+ *
+ * @example Lấy thông tin nguồn mở app:
+ * ```ts
+ * const entrySource = await getEntrySource();
+ * console.log(entrySource.srcOpen);
+ * ```
+ *
+ * @example Lấy thông tin nguồn mở app với callback:
+ * ```ts
+ * getEntrySource({
+ *   success: function(res) {
+ *     console.log(res.srcOpen);
+ *   },
+ *   fail: function(err) {
+ *     console.error(err);
+ *   }
+ * });
+ * ```
+ */
+declare function getEntrySource(args?: AsyncCallback<{
+    srcOpen: string;
+}>): Promise<{
+    srcOpen: string;
+} | null>;
+
 declare class AppError {
     code: number;
     message: string | string[];
@@ -5795,6 +5926,8 @@ declare const otherApis: {
         showWidget: typeof showWidget;
         purchase: typeof purchase$1;
     };
+    openDocument: typeof openDocument;
+    getEntrySource: typeof getEntrySource;
     FacingMode: typeof FacingMode;
     PhotoFormat: typeof PhotoFormat;
     PhotoQuality: typeof PhotoQuality;
@@ -5802,4 +5935,4 @@ declare const otherApis: {
     ZMACameraImp: typeof ZMACameraImp;
 };
 
-export { Action, AndroidBottomNavigationBarType, AppError, AsyncCallback, AsyncCallbackFailObject, AsyncProgressCallback, AsyncVoidCallback, AuthorizeType, CameraEvents, CameraParams, ChatType, CheckStateBioAuthenticationReturns, CheckTransactionReturns, CheckZaloCameraPermissionReturns, CheckoutKit, CheckoutSDK, ChooseImageReturns, Common, ContextInfo, CreateOrderIAPReturns, CreateOrderReturns, Events as EventName, Events, FacingMode, FunctionProps, GetAppInfoReturns, GetAuthCodeReturns, GetBeaconDiscoveryReturns, GetLocationReturns, GetNetworkTypeReturns, GetPhoneNumberReturns, GetSettingReturn, GetStorageReturns, GetUserInfoReturns, GetZPITokenReturns, IAPMethodType, IAPPayType, IAPPayTypeType, IOSSafeAreaBottomType, JumpStatus, KeepScreenReturns, LogData, MediaConstraints, MediaDevice, MediaPickerType, NativeCallBackData, NetworkType, OpenBioAuthenticationReturns, OpenMediaPickerReturns, OpenPostFeedReturns, OpenProfilePickerReturns, OpenProfilePickerType, OpenShareSheetReturns, OpenWebviewReturns, OrientationType, Payment, PhotoConstraint, PhotoFormat, PhotoFrame, PhotoQuality, PickAttr, PickedProfile, PlatformType, PostFeedType, ProfileInfo, ProfileType, ProrationMode, ProrationModeType, RemoveStorageReturns, RequestCameraPermissionReturns, SaveFileReturns, ScanNFCType, ScanQRCodeReturns, SelectPaymentMethodReturns, SetStorageReturns, ShareSheetType, StatusBarType, StorageInfo, StreamType, SystemInfo, TempFile, TextAlignType, UserInfo, VibrateType, ZMACamera, ZMACameraImp, addRating, authorize, checkNFC, checkStateBioAuthentication, checkTransaction, checkZaloCameraPermission, chooseImage, clearStorage, closeApp, closeLoading, configAppView, connectWifi, createCameraContext, createOrder, createOrderIAP, createShortcut, otherApis as default, displayAd, downloadFile, events, favoriteApp, followOA, getAccessToken, getAppInfo, getAuthCode, getBeacons, getContext, getContextAsync, getDeviceId, getDeviceIdAsync, getIDToken, getLocation, getNetworkType, getPhoneNumber, getRouteParams, getSetting, getShareableLink, getStorage, getStorageInfo, getSystemInfo, getUserID, getUserInfo, getVersion, getZPIToken, hideKeyboard, iBeaconInfo, interactOA, interactOA as interactOa, checkIsAllowedInteractWithOA as isAllowedInteractWithOA, keepScreen, loadAd, login, minimizeApp, nativeStorage, offConfirmToExit, offKeepScreen, onCallbackData, onConfirmToExit, onKeepScreen, onNetworkStatusChange, openBioAuthentication, openChat, openGroupList, openMediaPicker, openMiniApp, openOutApp, openPermissionSetting, openPhone, openPostFeed, openProfile, openProfilePicker, openSMS, openShareSheet, openWebview, purchase, refreshAd, removeStorage, requestCameraPermission, requestSendNotification, requestUpdateZalo, saveImageToGallery, saveVideoToGallery, scanNFC, scanQRCode, selectPaymentMethod, sendDataToPreviousMiniApp, setAccessToken, setAndroidBottomNavigationBar, setIOSBottomSafeArea, setNavigationBarColor, setNavigationBarLeftButton, setNavigationBarTitle, setStatusBar, setStorage, setupAd, showCustomOAWidget, showFunctionButtonWidget, showOAWidget, showToast, startBeaconDiscovery, stopBeaconDiscovery, trackingManager, unfollowOA, vibrate, viewOAQr };
+export { Action, AndroidBottomNavigationBarType, AppError, AsyncCallback, AsyncCallbackFailObject, AsyncProgressCallback, AsyncVoidCallback, AuthorizeType, CameraEvents, CameraParams, ChatType, CheckStateBioAuthenticationReturns, CheckTransactionReturns, CheckZaloCameraPermissionReturns, CheckoutKit, CheckoutSDK, ChooseImageReturns, Common, ContextInfo, CreateOrderIAPReturns, CreateOrderReturns, Events as EventName, Events, FacingMode, FunctionProps, GetAppInfoReturns, GetAuthCodeReturns, GetBeaconDiscoveryReturns, GetLocationReturns, GetNetworkTypeReturns, GetPhoneNumberReturns, GetSettingReturn, GetStorageReturns, GetUserInfoReturns, GetZPITokenReturns, IAPMethodType, IAPPayType, IAPPayTypeType, IOSSafeAreaBottomType, JumpStatus, KeepScreenReturns, LogData, MediaConstraints, MediaDevice, MediaPickerType, NativeCallBackData, NetworkType, OpenBioAuthenticationReturns, OpenMediaPickerReturns, OpenPostFeedReturns, OpenProfilePickerReturns, OpenProfilePickerType, OpenShareSheetReturns, OpenWebviewReturns, OrientationType, Payment, PhotoConstraint, PhotoFormat, PhotoFrame, PhotoQuality, PickAttr, PickedProfile, PlatformType, PostFeedType, ProfileInfo, ProfileType, ProrationMode, ProrationModeType, RemoveStorageReturns, RequestCameraPermissionReturns, SaveFileReturns, ScanNFCType, ScanQRCodeReturns, SelectPaymentMethodReturns, SetStorageReturns, ShareSheetType, StatusBarType, StorageInfo, StreamType, SystemInfo, TempFile, TextAlignType, UserInfo, VibrateType, ZMACamera, ZMACameraImp, addRating, authorize, checkNFC, checkStateBioAuthentication, checkTransaction, checkZaloCameraPermission, chooseImage, clearStorage, closeApp, closeLoading, configAppView, connectWifi, createCameraContext, createOrder, createOrderIAP, createShortcut, otherApis as default, displayAd, downloadFile, events, favoriteApp, followOA, getAccessToken, getAppInfo, getAuthCode, getBeacons, getContext, getContextAsync, getDeviceId, getDeviceIdAsync, getEntrySource, getIDToken, getLocation, getNetworkType, getPhoneNumber, getRouteParams, getSetting, getShareableLink, getStorage, getStorageInfo, getSystemInfo, getUserID, getUserInfo, getVersion, getZPIToken, hideKeyboard, iBeaconInfo, interactOA, interactOA as interactOa, checkIsAllowedInteractWithOA as isAllowedInteractWithOA, keepScreen, loadAd, login, minimizeApp, nativeStorage, offConfirmToExit, offKeepScreen, onCallbackData, onConfirmToExit, onKeepScreen, onNetworkStatusChange, openBioAuthentication, openChat, openDocument, openGroupList, openMediaPicker, openMiniApp, openOutApp, openPermissionSetting, openPhone, openPostFeed, openProfile, openProfilePicker, openSMS, openShareSheet, openWebview, purchase, refreshAd, removeStorage, requestCameraPermission, requestSendNotification, requestUpdateZalo, saveImageToGallery, saveVideoToGallery, scanNFC, scanQRCode, selectPaymentMethod, sendDataToPreviousMiniApp, setAccessToken, setAndroidBottomNavigationBar, setIOSBottomSafeArea, setNavigationBarColor, setNavigationBarLeftButton, setNavigationBarTitle, setStatusBar, setStorage, setupAd, showCustomOAWidget, showFunctionButtonWidget, showOAWidget, showToast, startBeaconDiscovery, stopBeaconDiscovery, trackingManager, unfollowOA, vibrate, viewOAQr };