@ibiz-template/runtime 0.7.41-alpha.5 → 0.7.41-alpha.51

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
@@ -8,41 +9,115 @@ import { IApiFileUtil } from '../../interface';
  */
 export declare class FileUtil implements IApiFileUtil {
     /**
-     * @description 计算OSSCat参数
+     * @description 下载凭证工具
      * @protected
-     * @param {string} url
-     * @param {IContext} context
-     * @param {string} [OSSCatName]
-     * @returns {*}  {string}
      * @memberof FileUtil
      */
-    protected calcOSSCatUrl(url: string, context: IContext, OSSCatName?: string): string;
+    protected downloadTicketUtil: DownloadTicketUtil;
+    /**
+     * @description 自定义文件上传请求头数据
+     * @protected
+     * @type {Record<string, string>}
+     * @memberof FileUtil
+     */
+    protected customUploadHeaders: Record<string, string>;
+    /**
+     * @description 设置文件上传请求头数据
+     * @param {Record<string, string>} args
+     * @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 IFileUtil
+     */
+    getUploadHeaders(): Record<string, string>;
+    /**
+     * 计算OSSCat参数
+     * @param url
+     * @param context
+     * @param OSSCatName
+     * @param enableNoAccess 若启用无权限模式则在文件存储目录后面拼接特殊字符'$'
+     * @returns
+     */
+    protected calcOSSCatUrl(url: string, context: IContext, OSSCatName?: string, enableNoAccess?: boolean): string;
     /**
-     * @description 计算文件的上传路径和下载路径
-     * 下载路径文件id用%fileId%占位，替换即可
-     * 配置编辑器参数uploadParams和exportParams时，会像导航参数一样动态添加对应的参数到url上
+     * @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
@@ -68,7 +143,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='']
@@ -76,6 +151,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":"AAAA,OAAO,EAEL,aAAa,EAId,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C;;;;;;;;OAQG;IACH,SAAS,CAAC,aAAa,CACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM;IAWT;;;;;;;;;;;;;OAaG;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;IA+BnB;;;;;;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

@@ -1,6 +1,9 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
 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
@@ -8,33 +11,124 @@ import { convertNavData } from '../nav-params/nav-params';
  * @implements {IApiFileUtil}
  */
 export class FileUtil {
+    constructor() {
+        /**
+         * @description 下载凭证工具
+         * @protected
+         * @memberof FileUtil
+         */
+        this.downloadTicketUtil = new DownloadTicketUtil();
+        /**
+         * @description 自定义文件上传请求头数据
+         * @protected
+         * @type {Record<string, string>}
+         * @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 设置文件上传请求头数据
+     * @param {Record<string, string>} args
+     * @memberof FileUtil
+     */
+    setUploadHeaders(args) {
+        Object.assign(this.customUploadHeaders, args);
+    }
     /**
-     * @description 计算OSSCat参数
+     * @description 获取是否启用下载凭证
      * @protected
-     * @param {string} url
-     * @param {IContext} context
-     * @param {string} [OSSCatName]
-     * @returns {*}  {string}
+     * @param {boolean} [enableDownloadTicket]
+     * @returns {*}  {boolean}
      * @memberof FileUtil
      */
-    calcOSSCatUrl(url, context, OSSCatName) {
+    getEnableDownloadTicket(enableDownloadTicket) {
+        let tempEnableDownloadTicket = ibiz.config.common.enableDownloadTicket;
+        if (enableDownloadTicket) {
+            tempEnableDownloadTicket = enableDownloadTicket;
+        }
+        return tempEnableDownloadTicket;
+    }
+    /**
+     * @description 获取文件上传请求头数据
+     * @returns {*}  {Record<string, string>}
+     * @memberof IFileUtil
+     */
+    getUploadHeaders() {
+        const uploadHeaders = {};
+        // 预定义请求头数据
+        const token = getAppCookie(CoreConst.TOKEN);
+        if (token) {
+            Object.assign(uploadHeaders, {
+                [`${ibiz.env.tokenHeader}Authorization`]: `${ibiz.env.tokenPrefix}Bearer ${token}`,
+            });
+        }
+        // 自定义请求头数据
+        if (this.customUploadHeaders &&
+            Object.keys(this.customUploadHeaders).length > 0) {
+            Object.assign(uploadHeaders, Object.assign({}, this.customUploadHeaders));
+        }
+        return uploadHeaders;
+    }
+    /**
+     * 计算OSSCat参数
+     * @param url
+     * @param context
+     * @param OSSCatName
+     * @param enableNoAccess 若启用无权限模式则在文件存储目录后面拼接特殊字符'$'
+     * @returns
+     */
+    calcOSSCatUrl(url, context, OSSCatName, enableNoAccess = false) {
         var _a;
         let uploadUrl = `${ibiz.env.baseUrl}/${ibiz.env.appId}${url}`;
         const app = ibiz.hub.getApp(context.srfappid);
         const OSSCat = OSSCatName ||
             app.model.defaultOSSCat ||
             ((_a = app.model.userParam) === null || _a === void 0 ? void 0 : _a.DefaultOSSCat);
-        uploadUrl = uploadUrl.replace('/{cat}', OSSCat ? `/${OSSCat}` : '');
+        uploadUrl = uploadUrl.replace('/{cat}', OSSCat ? `/${OSSCat}${enableNoAccess ? '$' : ''}` : '');
         return uploadUrl;
     }
     /**
-     * @description 计算文件的上传路径和下载路径
-     * 下载路径文件id用%fileId%占位，替换即可
-     * 配置编辑器参数uploadParams和exportParams时，会像导航参数一样动态添加对应的参数到url上
+     * @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;
@@ -42,10 +136,10 @@ export class FileUtil {
      * @memberof FileUtil
      */
     calcFileUpDownUrl(context, params, data = {}, extraParams = {}) {
-        const { uploadParams, exportParams, osscat: OSSCatName } = extraParams;
+        const { uploadParams, exportParams, osscat: OSSCatName, enableNoAccess, } = 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);
         let _uploadParams = {};
         let _exportParams = {};
         if (uploadParams) {
@@ -58,16 +152,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了，这里无需再写
@@ -108,7 +245,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 获取文件名
@@ -144,17 +286,13 @@ export class FileUtil {
      * @memberof FileUtil
      */
     async chooseFileAndUpload(context, params, data, option = {}) {
-        const { accept, multiple, showUploadManager } = option;
-        const urls = ibiz.util.file.calcFileUpDownUrl(context, params, data);
+        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 = {};
-        const token = getAppCookie(CoreConst.TOKEN);
-        if (token) {
-            Object.assign(headers, {
-                [`${ibiz.env.tokenHeader}Authorization`]: `${ibiz.env.tokenPrefix}Bearer ${token}`,
-            });
-        }
+        const headers = this.getUploadHeaders();
         if (showUploadManager) {
             promises = await ibiz.notification.uploadManager({
                 uploadUrl: urls.uploadUrl,
@@ -187,7 +325,12 @@ export class FileUtil {
             // 添加事件监听器，处理文件上传逻辑
             inputElement.addEventListener('change', (e) => {
                 resolve(e.target.files);
-            });
+            }, { once: true });
+            // 监听取消操作
+            window.addEventListener('focus', () => {
+                // 确保执行在 change 之后
+                setTimeout(() => resolve(undefined), 300);
+            }, { once: true });
             // 将 input 元素添加到页面中
             document.body.appendChild(inputElement);
             // 执行文件上传操作
@@ -196,4 +339,62 @@ export class FileUtil {
             document.body.removeChild(inputElement);
         });
     }
+    /**
+     * @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/handlebars/helpers/abs/abs.d.ts

@@ -0,0 +1,14 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 数字绝对值
+ *
+ * @description 用法 {{abs string }}。效果: 获取数值字符串的绝对值
+ * @export
+ * @class HelperAbs
+ * @extends {HelperBase}
+ */
+export declare class HelperAbs extends HelperBase {
+    constructor(hbs: IData);
+    onExecute(str: string): string;
+}
+//# sourceMappingURL=abs.d.ts.map

package/out/utils/handlebars/helpers/abs/abs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abs.d.ts","sourceRoot":"","sources":["../../../../../src/utils/handlebars/helpers/abs/abs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,GAAG,EAAE,KAAK;IAItB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAI/B"}

package/out/utils/handlebars/helpers/abs/abs.js

@@ -0,0 +1,19 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 数字绝对值
+ *
+ * @description 用法 {{abs string }}。效果: 获取数值字符串的绝对值
+ * @export
+ * @class HelperAbs
+ * @extends {HelperBase}
+ */
+export class HelperAbs extends HelperBase {
+    constructor(hbs) {
+        super(hbs, 'abs');
+    }
+    onExecute(str) {
+        if (!str)
+            return '';
+        return Math.abs(Number(str)).toString();
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/handlebars/helpers/index.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAoB/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/handlebars/helpers/index.ts"],"names":[],"mappings":"AAqBA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAqB/C"}

package/out/utils/handlebars/helpers/index.js

@@ -17,6 +17,7 @@ import { HelperPascalCase } from './pascal-case/pascal-case';
 import { HelperSnakeCase } from './snake-case/snake-case';
 import { HelperSpinalCase } from './spinal-case/spinal-case';
 import { HelperUpperCase } from './upper-case/upper-case';
+import { HelperAbs } from './abs/abs';
 /**
  * 安装自定义助手
  *
@@ -25,6 +26,7 @@ import { HelperUpperCase } from './upper-case/upper-case';
  * @export
  */
 export function installHelpers(hsb) {
+    new HelperAbs(hsb);
     new HelperAnd(hsb);
     new HelperCamelCase(hsb);
     new HelperConcat(hsb);

package/out/utils/handlebars/utils/helper/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/utils/handlebars/utils/helper/helper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAoBpC;IAEF;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,UAAU,CAAC,aAAa,GAChC,MAAM,GAAG,OAAO;CAOpB"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/utils/handlebars/utils/helper/helper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAqBpC;IAEF;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,UAAU,CAAC,aAAa,GAChC,MAAM,GAAG,OAAO;CAOpB"}

package/out/utils/handlebars/utils/helper/helper.js

@@ -50,6 +50,7 @@ HelperUtil.helperNames = [
     'lookup',
     'log',
     'and',
+    'abs',
     'camelCase',
     'concat',
     'eq',

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';