@ibiz-template/runtime 0.7.41-alpha.10 → 0.7.41-alpha.100

package/out/utils/file-util/file-util.d.ts

@@ -1,5 +1,6 @@
-import { IHttpResponse } from '@ibiz-template/core';
-import { IApiFileUtil } from '../../interface';
+import { IApiContext, IHttpResponse } from '@ibiz-template/core';
+import { IApiDownloadTicket, IApiFileUpDownExtraParams, IApiFileUtil } from '../../interface';
+import { DownloadTicketUtil } from './download-ticket/download-ticket-util';
 /**
  * @description 文件工具类
  * @export
@@ -7,6 +8,12 @@ import { IApiFileUtil } from '../../interface';
  * @implements {IApiFileUtil}
  */
 export declare class FileUtil implements IApiFileUtil {
+    /**
+     * @description 下载凭证工具
+     * @protected
+     * @memberof FileUtil
+     */
+    protected downloadTicketUtil: DownloadTicketUtil;
     /**
      * @description 自定义文件上传请求头数据
      * @protected
@@ -20,46 +27,98 @@ export declare class FileUtil implements IApiFileUtil {
      * @memberof FileUtil
      */
     setUploadHeaders(args: Record<string, string>): void;
+    /**
+     * @description 获取是否启用下载凭证
+     * @protected
+     * @param {boolean} [enableDownloadTicket]
+     * @returns {*}  {boolean}
+     * @memberof FileUtil
+     */
+    protected getEnableDownloadTicket(enableDownloadTicket?: boolean): boolean;
     /**
      * @description 获取文件上传请求头数据
      * @returns {*}  {Record<string, string>}
-     * @memberof IApiFileUtil
+     * @memberof IFileUtil
      */
     getUploadHeaders(): Record<string, string>;
     /**
-     * @description 计算OSSCat参数
-     * @protected
-     * @param {string} url
-     * @param {IContext} context
-     * @param {string} [OSSCatName]
-     * @returns {*}  {string}
-     * @memberof FileUtil
+     * 计算OSSCat参数
+     * @param url
+     * @param context
+     * @param OSSCatName
+     * @param enableNoAccess 若启用无权限模式则在文件存储目录后面拼接特殊字符'$'
+     * @param globalDownloadPrifix 是否启用全局下载文件前缀，启用则以global作为前缀
+     * @returns
      */
-    protected calcOSSCatUrl(url: string, context: IContext, OSSCatName?: string): string;
+    protected calcOSSCatUrl(url: string, context: IContext, OSSCatName?: string, enableNoAccess?: boolean, globalDownloadPrifix?: boolean): string;
     /**
      * @description 计算文件的上传路径和下载路径,下载路径文件id用%fileId%占位，替换即可;配置编辑器参数uploadParams和exportParams时，会像导航参数一样动态添加对应的参数到url上
      * @param {IContext} context
      * @param {IParams} params
      * @param {IData} [data={}]
-     * @param {IData} [extraParams={}]
+     * @param {IApiFileUpDownExtraParams} [extraParams={}]
      * @returns {*}  {{
      *     uploadUrl: string;
      *     downloadUrl: string;
      *   }}
      * @memberof FileUtil
      */
-    calcFileUpDownUrl(context: IContext, params: IParams, data?: IData, extraParams?: IData): {
+    calcFileUpDownUrl(context: IContext, params: IParams, data?: IData, extraParams?: IApiFileUpDownExtraParams): {
         uploadUrl: string;
         downloadUrl: string;
     };
+    /**
+     * @description 获取下载凭证
+     * @param {IApiContext} context
+     * @param {IParams} params
+     * @param {IData} data
+     * @param {({ fileId: string } & IData)} file
+     * @param {{ appEntityTag?: string; dataFieldTag?: string }} [downloadTicketParams]
+     * @returns {*}  {(Promise<IApiDownloadTicket | undefined>)}
+     * @memberof FileUtil
+     */
+    getDownloadTicket(context: IApiContext, params: IParams, data: IData, file: {
+        fileId: string;
+    } & IData, downloadTicketParams?: {
+        appEntityTag?: string;
+        dataFieldTag?: string;
+    }): Promise<IApiDownloadTicket | undefined>;
+    /**
+     * @description 设置下载票据
+     * @param {string} fileId
+     * @param {IData} downloadTicket
+     * @memberof FileUtil
+     */
+    setDownloadTicket(fileId: string, downloadTicket: IData): void;
     /**
      * @description 请求url获取文件流，并用JS触发文件下载
      * @param {string} url
      * @param {string} [name]
+     * @param {({
+     *       context: IContext;
+     *       params: IParams;
+     *       data: IData;
+     *       file: { fileId: string } & IData;
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *       downloadTicketParams?: { appEntityTag?: string; dataFieldTag?: string };
+     *     })} [downloadParams]
+     * @param {boolean} [enableDownloadTicket]
      * @returns {*}  {Promise<void>}
      * @memberof FileUtil
      */
-    fileDownload(url: string, name?: string): Promise<void>;
+    fileDownload(url: string, name?: string, downloadParams?: {
+        context: IContext;
+        params: IParams;
+        data: IData;
+        file: {
+            fileId: string;
+        } & IData;
+        extraParams?: IApiFileUpDownExtraParams;
+        downloadTicketParams?: {
+            appEntityTag?: string;
+            dataFieldTag?: string;
+        };
+    }, enableDownloadTicket?: boolean, enableNoAccess?: boolean): Promise<void>;
     /**
      * @description 文件上传
      * @param {string} uploadUrl
@@ -85,7 +144,7 @@ export declare class FileUtil implements IApiFileUtil {
      * @returns {*}  {Promise<IData[]>}
      * @memberof FileUtil
      */
-    chooseFileAndUpload(context: IContext, params: IParams, data: IData, option?: IData): Promise<IData[]>;
+    chooseFileAndUpload(context: IContext, params: IParams, data: IData, option?: IData): Promise<IData[] | undefined>;
     /**
      * @description 选择文件
      * @param {string} [accept='']
@@ -93,6 +152,50 @@ export declare class FileUtil implements IApiFileUtil {
      * @returns {*}  {Promise<FileList>}
      * @memberof FileUtil
      */
-    chooseFile(accept?: string, multiple?: boolean): Promise<FileList>;
+    chooseFile(accept?: string, multiple?: boolean): Promise<FileList | undefined>;
+    /**
+     * @description 通用请求文件方法，可自定义 responseType（默认获取Blob类型的文件流，responseType 的配置决定了请求服务时返回的文件数据格式）
+     * @param {string} url
+     * @param {XMLHttpRequestResponseType} [responseType]
+     * @param {({
+     *       context: IContext;
+     *       params: IParams;
+     *       data: IData;
+     *       file: { fileId: string } & IData;
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *       downloadTicketParams?: { appEntityTag?: string; dataFieldTag?: string };
+     *     })} [downloadParams]
+     * @param {boolean} [enableDownloadTicket]
+     * @returns {*}  {Promise<IData>}
+     * @memberof FileUtil
+     */
+    requestFile(url: string, responseType?: XMLHttpRequestResponseType, downloadParams?: {
+        context: IContext;
+        params: IParams;
+        data: IData;
+        file: {
+            fileId: string;
+        } & IData;
+        extraParams?: IApiFileUpDownExtraParams;
+        downloadTicketParams?: {
+            appEntityTag?: string;
+            dataFieldTag?: string;
+        };
+    }, enableDownloadTicket?: boolean, enableNoAccess?: boolean): Promise<IData>;
+    /**
+     * 图片压缩
+     * @param file      原始文件
+     * @param maxW      最大宽度（默认 1280）
+     * @param quality   压缩质量 0~1（默认 0.8）
+     * @returns Promise<File> 压缩后的新文件
+     */
+    compressImg: (file: File, maxW?: number, quality?: number) => Promise<File>;
+    /**
+     * @description base64字符串转Blob对象
+     * @param {string} base64
+     * @returns {*}  {Blob}
+     * @memberof FileUtil
+     */
+    base64ToBlob(base64: string): Blob;
 }
 //# sourceMappingURL=file-util.d.ts.map

package/out/utils/file-util/file-util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-util.d.ts","sourceRoot":"","sources":["../../../src/utils/file-util/file-util.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,EAId,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAE3D;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIpD;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAqB1C;;;;;;;;OAQG;IACH,SAAS,CAAC,aAAa,CACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM;IAWT;;;;;;;;;;;OAWG;IACH,iBAAiB,CACf,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,KAAU,EAChB,WAAW,GAAE,KAAU,GACtB;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IA0BD;;;;;;OAMG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7D;;;;;;;OAOG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,KAAK,GACb,OAAO,CAAC,KAAK,CAAC;IAiBjB;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM;IAmBnD;;;;;;;;OAQG;IACG,mBAAmB,CACvB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,KAAK,EACX,MAAM,GAAE,KAAU,GACjB,OAAO,CAAC,KAAK,EAAE,CAAC;IA8BnB;;;;;;OAMG;IACH,UAAU,CACR,MAAM,GAAE,MAAW,EACnB,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,QAAQ,CAAC;CAuBrB"}
+{"version":3,"file":"file-util.d.ts","sourceRoot":"","sources":["../../../src/utils/file-util/file-util.ts"],"names":[],"mappings":"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"}

package/out/utils/file-util/file-util.js

@@ -2,6 +2,8 @@
 import { CoreConst, RuntimeError, downloadFileFromBlob, getAppCookie, } from '@ibiz-template/core';
 import qs from 'qs';
 import { convertNavData } from '../nav-params/nav-params';
+import { DownloadTicketUtil } from './download-ticket/download-ticket-util';
+import { DownloadTicket } from './download-ticket/download-ticket';
 /**
  * @description 文件工具类
  * @export
@@ -10,6 +12,12 @@ import { convertNavData } from '../nav-params/nav-params';
  */
 export class FileUtil {
     constructor() {
+        /**
+         * @description 下载凭证工具
+         * @protected
+         * @memberof FileUtil
+         */
+        this.downloadTicketUtil = new DownloadTicketUtil();
         /**
          * @description 自定义文件上传请求头数据
          * @protected
@@ -17,6 +25,42 @@ export class FileUtil {
          * @memberof FileUtil
          */
         this.customUploadHeaders = {};
+        /**
+         * 图片压缩
+         * @param file      原始文件
+         * @param maxW      最大宽度（默认 1280）
+         * @param quality   压缩质量 0~1（默认 0.8）
+         * @returns Promise<File> 压缩后的新文件
+         */
+        this.compressImg = (file, maxW = 1280, quality = 0.8) => {
+            return new Promise((resolve, reject) => {
+                const img = new Image();
+                img.src = URL.createObjectURL(file);
+                img.onerror = (e) => reject(e);
+                img.onload = () => {
+                    const { width: w, height: h } = img;
+                    // 等比缩放
+                    const scale = w > h ? maxW / w : maxW / h;
+                    const cw = scale < 1 ? Math.round(w * scale) : w;
+                    const ch = scale < 1 ? Math.round(h * scale) : h;
+                    const canvas = document.createElement('canvas');
+                    canvas.width = cw;
+                    canvas.height = ch;
+                    const ctx = canvas.getContext('2d');
+                    ctx.drawImage(img, 0, 0, cw, ch);
+                    canvas.toBlob(blob => {
+                        if (!blob)
+                            return reject();
+                        // 把 blob 转成新 File（保留原名、类型）
+                        const newFile = new File([blob], file.name, {
+                            type: 'image/jpeg',
+                            lastModified: Date.now(),
+                        });
+                        resolve(newFile);
+                    }, 'image/jpeg', quality);
+                };
+            });
+        };
     }
     /**
      * @description 设置文件上传请求头数据
@@ -26,10 +70,24 @@ export class FileUtil {
     setUploadHeaders(args) {
         Object.assign(this.customUploadHeaders, args);
     }
+    /**
+     * @description 获取是否启用下载凭证
+     * @protected
+     * @param {boolean} [enableDownloadTicket]
+     * @returns {*}  {boolean}
+     * @memberof FileUtil
+     */
+    getEnableDownloadTicket(enableDownloadTicket) {
+        let tempEnableDownloadTicket = ibiz.config.common.enableDownloadTicket;
+        if (enableDownloadTicket) {
+            tempEnableDownloadTicket = enableDownloadTicket;
+        }
+        return tempEnableDownloadTicket;
+    }
     /**
      * @description 获取文件上传请求头数据
      * @returns {*}  {Record<string, string>}
-     * @memberof IApiFileUtil
+     * @memberof IFileUtil
      */
     getUploadHeaders() {
         const uploadHeaders = {};
@@ -48,30 +106,35 @@ export class FileUtil {
         return uploadHeaders;
     }
     /**
-     * @description 计算OSSCat参数
-     * @protected
-     * @param {string} url
-     * @param {IContext} context
-     * @param {string} [OSSCatName]
-     * @returns {*}  {string}
-     * @memberof FileUtil
+     * 计算OSSCat参数
+     * @param url
+     * @param context
+     * @param OSSCatName
+     * @param enableNoAccess 若启用无权限模式则在文件存储目录后面拼接特殊字符'$'
+     * @param globalDownloadPrifix 是否启用全局下载文件前缀，启用则以global作为前缀
+     * @returns
      */
-    calcOSSCatUrl(url, context, OSSCatName) {
+    calcOSSCatUrl(url, context, OSSCatName, enableNoAccess = false, globalDownloadPrifix = false) {
         var _a;
-        let uploadUrl = `${ibiz.env.baseUrl}/${ibiz.env.appId}${url}`;
+        let targetUrl = `${ibiz.env.baseUrl}/${ibiz.env.appId}${url}`;
+        // 启用则以global作为前缀,仅下载识别此参数
+        if (globalDownloadPrifix) {
+            targetUrl = `/__APP__${url}`;
+        }
         const app = ibiz.hub.getApp(context.srfappid);
         const OSSCat = OSSCatName ||
+            ibiz.env.defaultOSSCat ||
             app.model.defaultOSSCat ||
             ((_a = app.model.userParam) === null || _a === void 0 ? void 0 : _a.DefaultOSSCat);
-        uploadUrl = uploadUrl.replace('/{cat}', OSSCat ? `/${OSSCat}` : '');
-        return uploadUrl;
+        targetUrl = targetUrl.replace('/{cat}', OSSCat ? `/${OSSCat}${enableNoAccess ? '$' : ''}` : '');
+        return targetUrl;
     }
     /**
      * @description 计算文件的上传路径和下载路径,下载路径文件id用%fileId%占位，替换即可;配置编辑器参数uploadParams和exportParams时，会像导航参数一样动态添加对应的参数到url上
      * @param {IContext} context
      * @param {IParams} params
      * @param {IData} [data={}]
-     * @param {IData} [extraParams={}]
+     * @param {IApiFileUpDownExtraParams} [extraParams={}]
      * @returns {*}  {{
      *     uploadUrl: string;
      *     downloadUrl: string;
@@ -79,10 +142,11 @@ export class FileUtil {
      * @memberof FileUtil
      */
     calcFileUpDownUrl(context, params, data = {}, extraParams = {}) {
-        const { uploadParams, exportParams, osscat: OSSCatName } = extraParams;
+        const { uploadParams, exportParams, osscat: OSSCatName, enableNoAccess, globalDownloadPrifix, } = extraParams;
         // 计算文件上传路径
-        let uploadUrl = this.calcOSSCatUrl(ibiz.env.uploadFileUrl, context, OSSCatName);
-        let downloadUrl = this.calcOSSCatUrl(`${ibiz.env.downloadFileUrl}/%fileId%`, context, OSSCatName);
+        let uploadUrl = this.calcOSSCatUrl(ibiz.env.uploadFileUrl, context, OSSCatName, enableNoAccess);
+        // 计算文件下载路径
+        let downloadUrl = this.calcOSSCatUrl(`${ibiz.env.downloadFileUrl}/%fileId%`, context, OSSCatName, enableNoAccess, globalDownloadPrifix);
         let _uploadParams = {};
         let _exportParams = {};
         if (uploadParams) {
@@ -95,16 +159,59 @@ export class FileUtil {
         downloadUrl += qs.stringify(_exportParams, { addQueryPrefix: true });
         return { uploadUrl, downloadUrl };
     }
+    /**
+     * @description 获取下载凭证
+     * @param {IApiContext} context
+     * @param {IParams} params
+     * @param {IData} data
+     * @param {({ fileId: string } & IData)} file
+     * @param {{ appEntityTag?: string; dataFieldTag?: string }} [downloadTicketParams]
+     * @returns {*}  {(Promise<IApiDownloadTicket | undefined>)}
+     * @memberof FileUtil
+     */
+    async getDownloadTicket(context, params, data, file, downloadTicketParams = {}) {
+        return this.downloadTicketUtil.getDownloadTicket(file.fileId, context, params, data, downloadTicketParams);
+    }
+    /**
+     * @description 设置下载票据
+     * @param {string} fileId
+     * @param {IData} downloadTicket
+     * @memberof FileUtil
+     */
+    setDownloadTicket(fileId, downloadTicket) {
+        this.downloadTicketUtil.setDownloadTicket(fileId, new DownloadTicket(downloadTicket));
+    }
     /**
      * @description 请求url获取文件流，并用JS触发文件下载
      * @param {string} url
      * @param {string} [name]
+     * @param {({
+     *       context: IContext;
+     *       params: IParams;
+     *       data: IData;
+     *       file: { fileId: string } & IData;
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *       downloadTicketParams?: { appEntityTag?: string; dataFieldTag?: string };
+     *     })} [downloadParams]
+     * @param {boolean} [enableDownloadTicket]
      * @returns {*}  {Promise<void>}
      * @memberof FileUtil
      */
-    async fileDownload(url, name) {
+    async fileDownload(url, name, downloadParams, enableDownloadTicket, enableNoAccess) {
+        const tempEnableDownloadTicket = !enableNoAccess && this.getEnableDownloadTicket(enableDownloadTicket);
+        let tempDownloadUrl = url;
+        // 应用启用传入下载凭证且外部传入下载参数才去计算凭证
+        if (tempEnableDownloadTicket && downloadParams) {
+            const { context, params, data, file, extraParams, downloadTicketParams } = downloadParams;
+            const { downloadUrl } = this.calcFileUpDownUrl(context, params, data, extraParams);
+            const downloadTicket = await this.getDownloadTicket(context, params, data, file, downloadTicketParams);
+            if (!downloadTicket) {
+                throw new RuntimeError('runtime.utils.fileUtil.getDownloadTicketFailed');
+            }
+            tempDownloadUrl = downloadUrl.replace('%fileId%', downloadTicket.ticket);
+        }
         // 发送get请求
-        const response = await ibiz.net.request(url, {
+        const response = await ibiz.net.request(tempDownloadUrl, {
             method: 'get',
             responseType: 'blob',
             baseURL: '', // 已经有baseURL了，这里无需再写
@@ -145,7 +252,12 @@ export class FileUtil {
         if (res.status !== 200) {
             throw new RuntimeError(ibiz.i18n.t('runtime.utils.fileUtil.fileUploadFailed'));
         }
-        return res.data;
+        const result = res.data;
+        // 启用传入下载凭证成功后设置下载票据
+        if (ibiz.config.common.enableDownloadTicket && result.ticket) {
+            ibiz.util.file.setDownloadTicket(result.id, result.ticket);
+        }
+        return result;
     }
     /**
      * @description 获取文件名
@@ -184,6 +296,8 @@ export class FileUtil {
         const { accept, multiple, showUploadManager, extraParams } = option;
         const urls = ibiz.util.file.calcFileUpDownUrl(context, params, data, extraParams);
         const files = await ibiz.util.file.chooseFile(accept, multiple);
+        if (!files)
+            return;
         let promises = [];
         const headers = this.getUploadHeaders();
         if (showUploadManager) {
@@ -210,21 +324,93 @@ export class FileUtil {
     chooseFile(accept = '', multiple = false) {
         return new Promise(resolve => {
             // 创建 input 元素
-            const inputElement = document.createElement('input');
+            let inputElement = document.createElement('input');
             inputElement.type = 'file';
             inputElement.accept = accept;
             inputElement.multiple = multiple;
             inputElement.webkitdirectory = false;
             // 添加事件监听器，处理文件上传逻辑
             inputElement.addEventListener('change', (e) => {
+                if (inputElement) {
+                    document.body.removeChild(inputElement);
+                    inputElement = null;
+                }
                 resolve(e.target.files);
-            });
+            }, { once: true });
             // 将 input 元素添加到页面中
             document.body.appendChild(inputElement);
             // 执行文件上传操作
             inputElement.click();
-            // 方法结束后销毁 input 元素
-            document.body.removeChild(inputElement);
+            // 监听取消操作
+            window.addEventListener('focus', () => {
+                // 确保执行在 change 之后
+                setTimeout(() => {
+                    // 方法结束后销毁 input 元素
+                    if (inputElement) {
+                        document.body.removeChild(inputElement);
+                        inputElement = null;
+                    }
+                    resolve(undefined);
+                }, 1000);
+            }, { once: true });
+        });
+    }
+    /**
+     * @description 通用请求文件方法，可自定义 responseType（默认获取Blob类型的文件流，responseType 的配置决定了请求服务时返回的文件数据格式）
+     * @param {string} url
+     * @param {XMLHttpRequestResponseType} [responseType]
+     * @param {({
+     *       context: IContext;
+     *       params: IParams;
+     *       data: IData;
+     *       file: { fileId: string } & IData;
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *       downloadTicketParams?: { appEntityTag?: string; dataFieldTag?: string };
+     *     })} [downloadParams]
+     * @param {boolean} [enableDownloadTicket]
+     * @returns {*}  {Promise<IData>}
+     * @memberof FileUtil
+     */
+    async requestFile(url, responseType, downloadParams, enableDownloadTicket, enableNoAccess) {
+        let tempDownloadUrl = url;
+        const tempEnableDownloadTicket = !enableNoAccess && this.getEnableDownloadTicket(enableDownloadTicket);
+        // 如果启用了下载凭证，并且传入了下载参数，则拼接带凭证的下载地址
+        if (tempEnableDownloadTicket && downloadParams) {
+            const { context, params, data, file, extraParams, downloadTicketParams } = downloadParams;
+            const { downloadUrl } = ibiz.util.file.calcFileUpDownUrl(context, params, data, extraParams);
+            const downloadTicket = await ibiz.util.file.getDownloadTicket(context, params, data, file, downloadTicketParams);
+            if (!downloadTicket) {
+                throw new RuntimeError('runtime.utils.fileUtil.getDownloadTicketFailed');
+            }
+            tempDownloadUrl = downloadUrl.replace('%fileId%', downloadTicket.ticket);
+        }
+        // 发送请求
+        const response = await ibiz.net.request(tempDownloadUrl, {
+            method: 'get',
+            responseType: responseType || 'blob',
+            baseURL: '', // 已经有 baseURL，不需要再写
         });
+        if (response.status !== 200) {
+            throw new RuntimeError(ibiz.i18n.t('runtime.platform.failedDownload'));
+        }
+        if (!response.data) {
+            throw new RuntimeError(ibiz.i18n.t('runtime.platform.fileStreamData'));
+        }
+        return response.data;
+    }
+    /**
+     * @description base64字符串转Blob对象
+     * @param {string} base64
+     * @returns {*}  {Blob}
+     * @memberof FileUtil
+     */
+    base64ToBlob(base64) {
+        const binStr = atob(base64.split(',')[1]);
+        const len = binStr.length;
+        const arr = new Uint8Array(len);
+        for (let i = 0; i < len; i++) {
+            arr[i] = binStr.charCodeAt(i);
+        }
+        return new Blob([arr]);
     }
 }

package/out/utils/index.d.ts

@@ -28,4 +28,12 @@ export { Html2Canvas } from './html2canvas/html2canvas';
 export { VoiceUtil } from './voice-util/voice-util';
 export { EncyptionUtil } from './encryption-uitl/encryption-uitl';
 export * from './dr-ctrl-util';
+export * from './date-util';
+export { ChangeTracker } from './change-tracker/change-tracker';
+export { ViewShellHooks } from './view-shell-hooks/view-shell-hooks';
+export { WaterMarkUtil } from './water-mark-util/water-mark-util';
+export * from './map-util/map-util';
+export * from './wechat-util/wechat-util';
+export * from './json-util/json-util';
+export * from './stringify-util/stringify-util';
 //# sourceMappingURL=index.d.ts.map

package/out/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC"}

package/out/utils/index.js

@@ -28,3 +28,11 @@ export { Html2Canvas } from './html2canvas/html2canvas';
 export { VoiceUtil } from './voice-util/voice-util';
 export { EncyptionUtil } from './encryption-uitl/encryption-uitl';
 export * from './dr-ctrl-util';
+export * from './date-util';
+export { ChangeTracker } from './change-tracker/change-tracker';
+export { ViewShellHooks } from './view-shell-hooks/view-shell-hooks';
+export { WaterMarkUtil } from './water-mark-util/water-mark-util';
+export * from './map-util/map-util';
+export * from './wechat-util/wechat-util';
+export * from './json-util/json-util';
+export * from './stringify-util/stringify-util';

package/out/utils/json-util/JsonContext.d.ts

@@ -0,0 +1,16 @@
+export declare class JsonContext {
+    contextStack: any[];
+    constructor();
+    get current(): any;
+    get context(): any[];
+    get empty(): boolean;
+    set(value: any): void;
+    reset(): void;
+    remove(value: any): void;
+}
+export declare const ContextValues: {
+    OBJECT_KEY: string;
+    OBJECT_VALUE: string;
+    ARRAY: string;
+};
+//# sourceMappingURL=JsonContext.d.ts.map

package/out/utils/json-util/JsonContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonContext.d.ts","sourceRoot":"","sources":["../../../src/utils/json-util/JsonContext.ts"],"names":[],"mappings":"AAGA,qBAAa,WAAW;IACtB,YAAY,EAAE,GAAG,EAAE,CAAC;;IAMpB,IAAI,OAAO,QAEV;IAED,IAAI,OAAO,UAEV;IAED,IAAI,KAAK,YAER;IAED,GAAG,CAAC,KAAK,EAAE,GAAG;IAId,KAAK;IAIL,MAAM,CAAC,KAAK,EAAE,GAAG;CAMlB;AAED,eAAO,MAAM,aAAa;;;;CAIzB,CAAC"}

package/out/utils/json-util/JsonContext.js

@@ -0,0 +1,34 @@
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export class JsonContext {
+    constructor() {
+        this.contextStack = [];
+    }
+    get current() {
+        return this.contextStack[this.contextStack.length - 1];
+    }
+    get context() {
+        return [...this.contextStack];
+    }
+    get empty() {
+        return this.contextStack.length === 0;
+    }
+    set(value) {
+        this.contextStack.push(value);
+    }
+    reset() {
+        this.contextStack = [];
+    }
+    remove(value) {
+        const index = this.contextStack.lastIndexOf(value);
+        if (index !== -1) {
+            this.contextStack.splice(index, 1);
+        }
+    }
+}
+export const ContextValues = {
+    OBJECT_KEY: 'OBJECT_KEY',
+    OBJECT_VALUE: 'OBJECT_VALUE',
+    ARRAY: 'ARRAY',
+};

package/out/utils/json-util/JsonParser.d.ts

@@ -0,0 +1,20 @@
+import { JsonContext } from './JsonContext';
+export declare class JsonParser {
+    jsonStr: string;
+    index: number;
+    context: JsonContext;
+    logging: boolean;
+    logger: any[];
+    constructor(jsonStr?: string, logging?: boolean);
+    log(text: string): void;
+    parse(): any;
+    parseValue(): any;
+    parseObject(): any;
+    parseArray(): any[];
+    parseString(): string | number | boolean | null;
+    parseNumber(): string | number;
+    parseUnquotedString(): string;
+    skipWhitespace(): void;
+    peek(): string;
+}
+//# sourceMappingURL=JsonParser.d.ts.map

package/out/utils/json-util/JsonParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonParser.d.ts","sourceRoot":"","sources":["../../../src/utils/json-util/JsonParser.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiB,WAAW,EAAE,MAAM,eAAe,CAAC;AAK3D,qBAAa,UAAU;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,EAAE,WAAW,CAAC;IAErB,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,GAAG,EAAE,CAAC;gBAEF,OAAO,SAAK,EAAE,OAAO,UAAQ;IAQzC,GAAG,CAAC,IAAI,EAAE,MAAM;IAShB,KAAK;IAkCL,UAAU,IAAI,GAAG;IAgBjB,WAAW;IAiDX,UAAU;IA8BV,WAAW;IA0FX,WAAW;IAcX,mBAAmB;IAanB,cAAc;IAQd,IAAI;CAGL"}