@allahjs/utils 0.0.1

package/dist/uniapp/Tips/index.d.ts

@@ -0,0 +1,295 @@
+/**
+ * 提示类型枚举
+ */
+declare enum ToastType {
+    SUCCESS = "success",
+    ERROR = "error",
+    WARNING = "warning",
+    INFO = "info",
+    LOADING = "loading"
+}
+/**
+ * 提示位置枚举
+ */
+declare enum ToastPosition {
+    TOP = "top",
+    CENTER = "center",
+    BOTTOM = "bottom"
+}
+/**
+ * 模态框按钮配置
+ */
+interface ModalButton {
+    text: string;
+    color?: string;
+}
+/**
+ * 模态框配置选项
+ */
+interface ModalOptions {
+    title?: string;
+    content: string;
+    showCancel?: boolean;
+    cancelText?: string;
+    cancelColor?: string;
+    confirmText?: string;
+    confirmColor?: string;
+    editable?: boolean;
+    placeholderText?: string;
+}
+/**
+ * ActionSheet 选项配置
+ */
+interface ActionSheetItem {
+    text: string;
+    color?: string;
+}
+/**
+ * ActionSheet 配置选项
+ */
+interface ActionSheetOptions {
+    itemList: string[] | ActionSheetItem[];
+    itemColor?: string;
+    title?: string;
+}
+/**
+ * 统一的提示工具对象
+ */
+declare const Tips: {
+    /**
+     * 显示成功提示
+     */
+    success: (title: string, duration?: number, mask?: boolean) => void;
+    /**
+     * 显示错误提示
+     */
+    error: (title: string, duration?: number, mask?: boolean) => void;
+    /**
+     * 显示警告提示
+     */
+    warning: (title: string, duration?: number, mask?: boolean) => void;
+    /**
+     * 显示普通提示
+     */
+    info: (title: string, duration?: number, mask?: boolean) => void;
+    /**
+     * 显示加载提示
+     */
+    loading: (title?: string, mask?: boolean) => void;
+    /**
+     * 隐藏加载提示
+     */
+    hideLoading: () => void;
+    /**
+     * 隐藏所有提示
+     */
+    hide: () => void;
+    /**
+     * 显示确认对话框
+     */
+    confirm: (content: string, title?: string) => Promise<boolean>;
+    /**
+     * 显示自定义模态框
+     */
+    modal: (options: ModalOptions) => Promise<{
+        confirm: boolean;
+        cancel: boolean;
+        content?: string;
+    }>;
+    /**
+     * 显示输入框对话框
+     */
+    input: (content: string, placeholder?: string, title?: string) => Promise<{
+        confirmed: boolean;
+        content: string;
+    }>;
+    /**
+     * 显示操作菜单
+     */
+    actionSheet: (options: ActionSheetOptions) => Promise<{
+        tapIndex: number;
+        cancelled: boolean;
+    }>;
+    /**
+     * 显示带回调的成功提示
+     */
+    successCallback: (title: string, callback: () => void, duration?: number) => void;
+    /**
+     * 显示带回调的错误提示
+     */
+    errorCallback: (title: string, callback: () => void, duration?: number) => void;
+    /**
+     * 显示加载提示并执行异步操作
+     */
+    async: <T>(asyncFn: () => Promise<T>, loadingText?: string, successText?: string, errorText?: string) => Promise<T>;
+    /**
+     * 显示删除确认对话框
+     */
+    deleteConfirm: (itemName: string, title?: string) => Promise<boolean>;
+    /**
+     * 显示网络错误提示
+     */
+    networkError: (customMessage?: string) => void;
+    /**
+     * 显示权限请求提示
+     */
+    permission: (permissionName: string) => Promise<boolean>;
+    /**
+     * 显示版本更新提示
+     */
+    update: (version: string, updateContent: string, isForced?: boolean) => Promise<boolean>;
+    /**
+     * 防抖成功提示
+     */
+    successDebounced: (title: string, duration?: number) => void;
+    /**
+     * 防抖错误提示
+     */
+    errorDebounced: (title: string, duration?: number) => void;
+    /**
+     * 创建批量操作提示管理器
+     */
+    batch: () => BatchOperationTips;
+};
+/**
+ * 显示成功提示
+ * @deprecated 建议使用 Tips.success
+ */
+declare const showSuccessToast: (title: string, duration?: number, mask?: boolean) => void;
+/**
+ * 显示错误提示
+ * @deprecated 建议使用 Tips.error
+ */
+declare const showErrorToast: (title: string, duration?: number, mask?: boolean) => void;
+/**
+ * 显示警告提示
+ * @deprecated 建议使用 Tips.warning
+ */
+declare const showWarningToast: (title: string, duration?: number, mask?: boolean) => void;
+/**
+ * 显示普通提示（无图标）
+ * @deprecated 建议使用 Tips.info
+ */
+declare const showToast: (title: string, duration?: number, mask?: boolean) => void;
+/**
+ * 显示加载提示
+ * @deprecated 建议使用 Tips.loading
+ */
+declare const showLoading: (title?: string, mask?: boolean) => void;
+/**
+ * 隐藏加载提示
+ * @deprecated 建议使用 Tips.hideLoading
+ */
+declare const hideLoading: () => void;
+/**
+ * 隐藏所有提示
+ * @deprecated 建议使用 Tips.hide
+ */
+declare const hideToast: () => void;
+/**
+ * 显示确认对话框
+ * @deprecated 建议使用 Tips.confirm
+ */
+declare const showConfirmDialog: (content: string, title?: string) => Promise<boolean>;
+/**
+ * 显示自定义模态框
+ * @deprecated 建议使用 Tips.modal
+ */
+declare const showModal: (options: ModalOptions) => Promise<{
+    confirm: boolean;
+    cancel: boolean;
+    content?: string;
+}>;
+/**
+ * 显示输入框对话框
+ * @deprecated 建议使用 Tips.input
+ */
+declare const showInputDialog: (content: string, placeholder?: string, title?: string) => Promise<{
+    confirmed: boolean;
+    content: string;
+}>;
+/**
+ * 显示操作菜单
+ * @deprecated 建议使用 Tips.actionSheet
+ */
+declare const showActionSheet: (options: ActionSheetOptions) => Promise<{
+    tapIndex: number;
+    cancelled: boolean;
+}>;
+/**
+ * 显示带回调的成功提示
+ * @deprecated 建议使用 Tips.successCallback
+ */
+declare const showSuccessToastWithCallback: (title: string, callback: () => void, duration?: number) => void;
+/**
+ * 显示带回调的错误提示
+ * @deprecated 建议使用 Tips.errorCallback
+ */
+declare const showErrorToastWithCallback: (title: string, callback: () => void, duration?: number) => void;
+/**
+ * 显示加载提示并执行异步操作
+ * @deprecated 建议使用 Tips.async
+ */
+declare const showLoadingWithAsync: <T>(asyncFn: () => Promise<T>, loadingText?: string, successText?: string, errorText?: string) => Promise<T>;
+/**
+ * 显示删除确认对话框
+ * @deprecated 建议使用 Tips.deleteConfirm
+ */
+declare const showDeleteConfirm: (itemName: string, title?: string) => Promise<boolean>;
+/**
+ * 显示网络错误提示
+ * @deprecated 建议使用 Tips.networkError
+ */
+declare const showNetworkError: (customMessage?: string) => void;
+/**
+ * 显示权限请求提示
+ * @deprecated 建议使用 Tips.permission
+ */
+declare const showPermissionRequest: (permissionName: string) => Promise<boolean>;
+/**
+ * 显示版本更新提示
+ * @deprecated 建议使用 Tips.update
+ */
+declare const showUpdateDialog: (version: string, updateContent: string, isForced?: boolean) => Promise<boolean>;
+/**
+ * 防抖成功提示
+ * @deprecated 建议使用 Tips.successDebounced
+ */
+declare const showSuccessToastDebounced: (title: string, duration?: number) => void;
+/**
+ * 防抖错误提示
+ * @deprecated 建议使用 Tips.errorDebounced
+ */
+declare const showErrorToastDebounced: (title: string, duration?: number) => void;
+/**
+ * 批量操作提示管理器
+ */
+declare class BatchOperationTips {
+    private total;
+    private current;
+    private operation;
+    /**
+     * 开始批量操作
+     * @param total 总数量
+     * @param operation 操作名称
+     */
+    start(total: number, operation?: string): void;
+    /**
+     * 更新进度
+     * @param increment 增加的数量，默认1
+     */
+    progress(increment?: number): void;
+    /**
+     * 完成批量操作
+     * @param successMessage 成功提示信息
+     */
+    complete(successMessage?: string): void;
+    /**
+     * 批量操作失败
+     * @param errorMessage 错误提示信息
+     */
+    error(errorMessage?: string): void;
+}
+
+export { BatchOperationTips, Tips, ToastPosition, ToastType, hideLoading, hideToast, showActionSheet, showConfirmDialog, showDeleteConfirm, showErrorToast, showErrorToastDebounced, showErrorToastWithCallback, showInputDialog, showLoading, showLoadingWithAsync, showModal, showNetworkError, showPermissionRequest, showSuccessToast, showSuccessToastDebounced, showSuccessToastWithCallback, showToast, showUpdateDialog, showWarningToast };
+export type { ActionSheetItem, ActionSheetOptions, ModalButton, ModalOptions };

package/dist/uniapp/cloudUtils/index.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+var index = require('../uniUtils/index.cjs');
+
+/**
+ * 云函数工具类
+ * 提供云函数调用、重试、响应处理等功能
+ */
+const cloudUtils = {
+    /**
+     * 调用云函数
+     * @param app CloudBase 应用实例
+     * @param params 操作参数
+     * @returns 云函数执行结果
+     */
+    async call(app, params) {
+        try {
+            const result = await app.callFunction({
+                name: params.function,
+                data: {
+                    action: params.action,
+                    params: params.params
+                }
+            });
+            // 提示信息处理
+            if (params.successMessage) {
+                return cloudUtils.handleResponse(result.result, params.successMessage);
+            }
+            // 使用 safeGetResponseData 确保返回安全的数据结构
+            return index.safeGetResponseData(result.result, params.errorDefault);
+        }
+        catch (error) {
+            index.handleError(error, `调用云函数 ${params.function} 失败`);
+        }
+        return null;
+    },
+    /**
+     * 带重试机制调用云函数
+     * @param app CloudBase 应用实例
+     * @param functionName 云函数名称
+     * @param action 操作类型
+     * @param params 参数
+     * @param retryCount 重试次数，默认3次
+     * @returns 云函数执行结果
+     */
+    async callWithRetry(app, functionName, action, params, retryCount = 3) {
+        let lastError;
+        for (let i = 0; i < retryCount; i++) {
+            try {
+                return await this.call(app, {
+                    function: functionName,
+                    action,
+                    params
+                });
+            }
+            catch (error) {
+                lastError = error;
+                if (i < retryCount - 1) {
+                    // 等待一段时间后重试
+                    await new Promise(resolve => setTimeout(resolve, 1000 * (i + 1)));
+                }
+            }
+        }
+        throw lastError;
+    },
+    /**
+     * 处理响应
+     * @param data 云函数返回结果
+     * @param successMessage 成功提示消息
+     * @returns 处理后的结果数据
+     */
+    handleResponse(data, successMessage) {
+        if (data?.code === 0) {
+            if (successMessage) {
+                uni.showToast({
+                    title: successMessage,
+                    icon: 'success'
+                });
+            }
+            return data.result;
+        }
+        const errorMessage = data?.message || '操作失败';
+        uni.showToast({
+            title: errorMessage,
+            icon: 'none'
+        });
+        throw new Error(errorMessage);
+    }
+};
+
+exports.cloudUtils = cloudUtils;
+//# sourceMappingURL=index.cjs.map

package/dist/uniapp/cloudUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/uniapp/cloudUtils/index.ts"],"sourcesContent":[null],"names":["safeGetResponseData","handleError"],"mappings":";;;;AA2BA;;;AAGG;AACI,MAAM,UAAU,GAAG;AACxB;;;;;AAKG;AACH,IAAA,MAAM,IAAI,CAAU,GAAQ,EAAE,MAAsB,EAAA;AAElD,QAAA,IAAI;AACF,YAAA,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC;gBACpC,IAAI,EAAE,MAAM,CAAC,QAAQ;AACrB,gBAAA,IAAI,EAAE;oBACJ,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC;AAChB;AACF,aAAA,CAAC;;AAEF,YAAA,IAAG,MAAM,CAAC,cAAc,EAAC;AACvB,gBAAA,OAAO,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;YACxE;;YAEA,OAAOA,yBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAM;QACrE;QAAE,OAAO,KAAK,EAAE;YACdC,iBAAW,CAAC,KAAK,EAAE,CAAA,MAAA,EAAS,MAAM,CAAC,QAAQ,CAAA,GAAA,CAAK,CAAC;QACnD;AACA,QAAA,OAAO,IAAS;IAClB,CAAC;AAED;;;;;;;;AAQG;AACH,IAAA,MAAM,aAAa,CACjB,GAAQ,EACR,YAAoB,EACpB,MAAc,EACd,MAAY,EACZ,UAAA,GAAqB,CAAC,EAAA;AAEtB,QAAA,IAAI,SAAc;AAElB,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE;AACnC,YAAA,IAAI;AACF,gBAAA,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;AAC1B,oBAAA,QAAQ,EAAE,YAAY;oBACtB,MAAM;oBACN;AACD,iBAAA,CAAC;YACJ;YAAE,OAAO,KAAK,EAAE;gBACd,SAAS,GAAG,KAAK;AACjB,gBAAA,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE;;oBAEtB,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnE;YACF;QACF;AAEA,QAAA,MAAM,SAAS;IACjB,CAAC;AAED;;;;;AAKG;IACH,cAAc,CAAC,IAAS,EAAE,cAAuB,EAAA;AAC/C,QAAA,IAAI,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE;YACpB,IAAI,cAAc,EAAE;gBAClB,GAAG,CAAC,SAAS,CAAC;AACZ,oBAAA,KAAK,EAAE,cAAc;AACrB,oBAAA,IAAI,EAAE;AACP,iBAAA,CAAC;YACJ;YACA,OAAO,IAAI,CAAC,MAAM;QACpB;AACA,QAAA,MAAM,YAAY,GAAG,IAAI,EAAE,OAAO,IAAI,MAAM;QAC5C,GAAG,CAAC,SAAS,CAAC;AACZ,YAAA,KAAK,EAAE,YAAY;AACnB,YAAA,IAAI,EAAE;AACP,SAAA,CAAC;AACF,QAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;IAC/B;;;;;"}

package/dist/uniapp/cloudUtils/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 云函数调用参数接口
+ * 用于统一封装调用云函数时所需的参数
+ */
+type ICallParams<T> = {
+    /** 云函数名称 */
+    function: string;
+    /** 云函数内部操作类型 */
+    action: string;
+    /** 传递给云函数的额外参数 */
+    params?: any;
+    /**
+     * 异常的时候的默认值
+     */
+    errorDefault?: T;
+    /**
+     * 成功时的提示
+     */
+    successMessage?: string;
+    /**
+     * 失败时的提示
+     */
+    errorMessage?: string;
+};
+/**
+ * 云函数工具类
+ * 提供云函数调用、重试、响应处理等功能
+ */
+declare const cloudUtils: {
+    /**
+     * 调用云函数
+     * @param app CloudBase 应用实例
+     * @param params 操作参数
+     * @returns 云函数执行结果
+     */
+    call<T = any>(app: any, params: ICallParams<T>): Promise<T>;
+    /**
+     * 带重试机制调用云函数
+     * @param app CloudBase 应用实例
+     * @param functionName 云函数名称
+     * @param action 操作类型
+     * @param params 参数
+     * @param retryCount 重试次数，默认3次
+     * @returns 云函数执行结果
+     */
+    callWithRetry(app: any, functionName: string, action: string, params?: any, retryCount?: number): Promise<any>;
+    /**
+     * 处理响应
+     * @param data 云函数返回结果
+     * @param successMessage 成功提示消息
+     * @returns 处理后的结果数据
+     */
+    handleResponse(data: any, successMessage?: string): any;
+};
+
+export { cloudUtils };

package/dist/uniapp/index.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var index$2 = require('./uniUtils/index.cjs');
+var index = require('./Tips/index.cjs');
+var index$1 = require('./cloudUtils/index.cjs');
+
+
+
+exports.createTimestampedData = index$2.createTimestampedData;
+exports.createUpdateData = index$2.createUpdateData;
+exports.deepClone = index$2.deepClone;
+exports.ensureArray = index$2.ensureArray;
+exports.findById = index$2.findById;
+exports.formatDate = index$2.formatDate;
+exports.formatRelativeTime = index$2.formatRelativeTime;
+exports.handleError = index$2.handleError;
+exports.handleSuccess = index$2.handleSuccess;
+exports.isDataExists = index$2.isDataExists;
+exports.isValidFamilyMember = index$2.isValidFamilyMember;
+exports.safeGetResponseData = index$2.safeGetResponseData;
+exports.validateRequiredFields = index$2.validateRequiredFields;
+exports.BatchOperationTips = index.BatchOperationTips;
+exports.Tips = index.Tips;
+Object.defineProperty(exports, "ToastPosition", {
+	enumerable: true,
+	get: function () { return index.ToastPosition; }
+});
+Object.defineProperty(exports, "ToastType", {
+	enumerable: true,
+	get: function () { return index.ToastType; }
+});
+exports.hideLoading = index.hideLoading;
+exports.hideToast = index.hideToast;
+exports.showActionSheet = index.showActionSheet;
+exports.showConfirmDialog = index.showConfirmDialog;
+exports.showDeleteConfirm = index.showDeleteConfirm;
+exports.showErrorToast = index.showErrorToast;
+exports.showErrorToastDebounced = index.showErrorToastDebounced;
+exports.showErrorToastWithCallback = index.showErrorToastWithCallback;
+exports.showInputDialog = index.showInputDialog;
+exports.showLoading = index.showLoading;
+exports.showLoadingWithAsync = index.showLoadingWithAsync;
+exports.showModal = index.showModal;
+exports.showNetworkError = index.showNetworkError;
+exports.showPermissionRequest = index.showPermissionRequest;
+exports.showSuccessToast = index.showSuccessToast;
+exports.showSuccessToastDebounced = index.showSuccessToastDebounced;
+exports.showSuccessToastWithCallback = index.showSuccessToastWithCallback;
+exports.showToast = index.showToast;
+exports.showUpdateDialog = index.showUpdateDialog;
+exports.showWarningToast = index.showWarningToast;
+exports.cloudUtils = index$1.cloudUtils;
+//# sourceMappingURL=index.cjs.map

package/dist/uniapp/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/uniapp/index.d.ts

@@ -0,0 +1,3 @@
+export { ExistenceValidationResponse, FamilyValidationResponse, StandardResponse, createTimestampedData, createUpdateData, deepClone, ensureArray, findById, formatDate, formatRelativeTime, handleError, handleSuccess, isDataExists, isValidFamilyMember, safeGetResponseData, validateRequiredFields } from './uniUtils/index.js';
+export { ActionSheetItem, ActionSheetOptions, BatchOperationTips, ModalButton, ModalOptions, Tips, ToastPosition, ToastType, hideLoading, hideToast, showActionSheet, showConfirmDialog, showDeleteConfirm, showErrorToast, showErrorToastDebounced, showErrorToastWithCallback, showInputDialog, showLoading, showLoadingWithAsync, showModal, showNetworkError, showPermissionRequest, showSuccessToast, showSuccessToastDebounced, showSuccessToastWithCallback, showToast, showUpdateDialog, showWarningToast } from './Tips/index.js';
+export { cloudUtils } from './cloudUtils/index.js';