my-uniapp-tools 1.0.8 → 1.0.9

package/dist/clipboard/index.d.ts

@@ -2,8 +2,37 @@
  * 剪贴板相关工具函数
  */
 /**
- * 跨平台文本复制功能
+ * 剪贴板操作配置
+ */
+interface ClipboardConfig {
+    showToast?: boolean;
+    successMessage?: string;
+    failMessage?: string;
+    timeout?: number;
+}
+/**
+ * 跨平台文本复制功能（优化版本）
  * @param text 要复制的文本内容
+ * @param config 配置选项
  * @description 支持 H5、App、小程序。H5 平台优先使用现代的 Clipboard API，失败时回退到传统方法
+ * @returns Promise<boolean> 复制是否成功
+ */
+export declare function copyText(text: string, config?: ClipboardConfig): Promise<boolean>;
+/**
+ * 读取剪贴板内容（仅H5平台支持）
+ * @param config 配置选项
+ * @returns Promise<string | null> 剪贴板内容，失败时返回null
+ */
+export declare function readClipboard(config?: ClipboardConfig): Promise<string | null>;
+/**
+ * 检查剪贴板API是否可用
+ * @returns boolean 是否支持剪贴板操作
+ */
+export declare function isClipboardSupported(): boolean;
+/**
+ * 清空剪贴板（仅H5平台支持）
+ * @param config 配置选项
+ * @returns Promise<boolean> 是否成功
  */
-export declare function copyText(text: string): void;
+export declare function clearClipboard(config?: ClipboardConfig): Promise<boolean>;
+export {};

package/dist/core/errorHandler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 统一错误处理机制
+ */
+export interface ErrorInfo {
+    code: string;
+    message: string;
+    module: string;
+    timestamp: number;
+    stack?: string;
+}
+export declare class UniAppToolsError extends Error {
+    code: string;
+    module: string;
+    timestamp: number;
+    constructor(code: string, message: string, module: string);
+}
+/**
+ * 全局错误处理器
+ */
+export declare class ErrorHandler {
+    private static instance;
+    private errorCallbacks;
+    static getInstance(): ErrorHandler;
+    /**
+     * 注册错误回调
+     */
+    onError(callback: (error: ErrorInfo) => void): void;
+    /**
+     * 处理错误
+     */
+    handleError(error: Error | UniAppToolsError, module: string): void;
+    /**
+     * 创建模块专用的错误处理函数
+     */
+    createModuleErrorHandler(moduleName: string): (code: string, message: string, originalError?: Error) => UniAppToolsError;
+}
+/**
+ * 异步操作包装器，统一错误处理
+ */
+export declare function safeAsync<T>(operation: () => Promise<T>, moduleName: string, errorCode?: string): Promise<T | null>;
+/**
+ * 同步操作包装器，统一错误处理
+ */
+export declare function safeSync<T>(operation: () => T, moduleName: string, errorCode?: string, defaultValue?: T | null): T | null;

package/dist/core/performance.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 性能监控工具
+ */
+export interface PerformanceMetric {
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    module: string;
+    metadata?: Record<string, any>;
+}
+export declare class PerformanceMonitor {
+    private static instance;
+    private metrics;
+    private completedMetrics;
+    private maxStoredMetrics;
+    static getInstance(): PerformanceMonitor;
+    /**
+     * 开始性能测量
+     */
+    start(name: string, module: string, metadata?: Record<string, any>): void;
+    /**
+     * 结束性能测量
+     */
+    end(name: string): PerformanceMetric | null;
+    /**
+     * 获取性能报告
+     */
+    getReport(): {
+        byModule: Record<string, PerformanceMetric[]>;
+        slowest: PerformanceMetric[];
+        average: Record<string, number>;
+    };
+    /**
+     * 清除性能记录
+     */
+    clear(): void;
+}
+/**
+ * 性能装饰器
+ */
+export declare function measurePerformance(moduleName: string): (target: any, propertyName: string, descriptor: PropertyDescriptor) => void;

package/dist/index.d.ts

@@ -1,6 +1,10 @@
+export function initUniAppTools(config?: {}): void;
+export * from "./core/errorHandler";
+export * from "./core/performance";
 export * from "./ui";
 export * from "./navigation";
 export * from "./clipboard";
 export * from "./system";
 export * from "./localStorage";
 export * from "./utils";
+export const VERSION: "1.0.8";

package/dist/localStorage/index.d.ts

@@ -1,26 +1,75 @@
 /**
- * 本地存储相关工具函数
+ * 本地存储相关工具函数（优化版本）
  */
 /**
- * 同步设置本地缓存
+ * 存储配置选项
+ */
+interface StorageOptions {
+    compress?: boolean;
+    encrypt?: boolean;
+    ttl?: number;
+}
+/**
+ * 同步设置本地缓存（优化版本）
  * @param key 缓存键
  * @param obj 要缓存的值，可以是任何类型
- * @description 如果值是字符串，直接存储；否则，尝试将其 JSON 序列化后存储。
- *              添加了错误处理，以防 JSON 序列化失败。
+ * @param options 存储选项
+ * @returns 是否设置成功
  */
-export declare function setStorageSync(key: string, obj: unknown): void;
+export declare function setStorageSync<T>(key: string, obj: T, options?: StorageOptions): boolean;
 /**
- * 同步获取本地缓存
+ * 同步获取本地缓存（优化版本）
  * @param key 缓存键
- * @returns 缓存的值。如果存储的是 JSON 字符串，则返回解析后的对象；否则返回原始值。
- * @description 获取指定键的值。如果值是非空字符串，尝试进行 JSON 解析。
- *              如果解析成功，返回解析后的对象；如果解析失败或值不是有效字符串，返回原始值。
+ * @param defaultValue 默认值
+ * @returns 缓存的值
  */
-export declare function getStorageSync(key: string): any;
+export declare function getStorageSync<T>(key: string, defaultValue?: T): T | undefined;
 /**
- * 同步清理本地缓存
+ * 同步清理本地缓存（优化版本）
  * @param key 可选的缓存键
- * @description 如果传入 key，则删除对应的缓存项。
- *              如果不传入 key，则清除所有本地缓存。
+ * @returns 是否清理成功
+ */
+export declare function clearStorageSync(key?: string): boolean;
+/**
+ * 异步设置本地缓存
+ * @param key 缓存键
+ * @param obj 要缓存的值
+ * @param options 存储选项
+ * @returns Promise<boolean>
+ */
+export declare function setStorage<T>(key: string, obj: T, options?: StorageOptions): Promise<boolean>;
+/**
+ * 异步获取本地缓存
+ * @param key 缓存键
+ * @param defaultValue 默认值
+ * @returns Promise<T | undefined>
+ */
+export declare function getStorage<T>(key: string, defaultValue?: T): Promise<T | undefined>;
+/**
+ * 获取存储信息
+ * @returns 存储信息
+ */
+export declare function getStorageInfo(): {
+    keys: string[];
+    currentSize: number;
+    limitSize: number;
+};
+/**
+ * 清理过期数据
+ * @returns 清理的数据条数
+ */
+export declare function cleanExpiredStorage(): number;
+/**
+ * 批量设置存储
+ * @param items 要设置的键值对
+ * @param options 存储选项
+ * @returns 成功设置的数量
+ */
+export declare function batchSetStorage(items: Record<string, any>, options?: StorageOptions): number;
+/**
+ * 批量获取存储
+ * @param keys 要获取的键数组
+ * @returns 键值对对象
  */
-export declare function clearStorageSync(key?: string): void;
+export declare function batchGetStorage<T = any>(keys: string[]): Record<string, T | undefined>;
+export {};