sa2kit 3.0.0 → 3.2.0

package/dist/index-FVJZCEtm.d.mts

@@ -0,0 +1,145 @@
+/**
+ * 日志级别
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * 日志条目
+ */
+interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    data?: any;
+    context?: string;
+    error?: Error;
+}
+/**
+ * 日志适配器接口
+ * 不同平台实现不同的日志输出方式
+ */
+interface LoggerAdapter {
+    /**
+     * 输出日志
+     */
+    log(entry: LogEntry): void;
+    /**
+     * 批量输出日志（可选）
+     */
+    logBatch?(entries: LogEntry[]): void;
+}
+/**
+ * 日志配置
+ */
+interface LoggerConfig {
+    /**
+     * 最小日志级别
+     * 只有大于等于此级别的日志才会输出
+     */
+    minLevel: LogLevel;
+    /**
+     * 是否启用时间戳
+     */
+    enableTimestamp?: boolean;
+    /**
+     * 是否启用上下文（模块名）
+     */
+    enableContext?: boolean;
+    /**
+     * 环境（development/production）
+     */
+    environment?: 'development' | 'production';
+    /**
+     * 自定义适配器
+     */
+    adapter?: LoggerAdapter;
+}
+
+/**
+ * 统一日志管理类
+ */
+declare class Logger {
+    private config;
+    private adapter;
+    private context?;
+    constructor(config?: Partial<LoggerConfig>, context?: string);
+    /**
+     * 创建带上下文的子 Logger
+     */
+    createChild(context: string): Logger;
+    /**
+     * 调试日志
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * 信息日志
+     */
+    info(message: string, data?: any): void;
+    /**
+     * 警告日志
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * 错误日志
+     */
+    error(message: string, error?: Error | any): void;
+    /**
+     * 核心日志方法
+     */
+    private log;
+    /**
+     * 设置日志级别
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * 获取当前日志级别
+     */
+    getLevel(): LogLevel;
+}
+/**
+ * 默认全局 Logger 实例
+ */
+declare const logger: Logger;
+/**
+ * 创建带上下文的 Logger
+ */
+declare function createLogger(context: string, config?: Partial<LoggerConfig>): Logger;
+
+/**
+ * 控制台日志适配器
+ * 使用 console.info/warn/error 输出日志
+ */
+declare class ConsoleLoggerAdapter implements LoggerAdapter {
+    private readonly colors;
+    log(entry: LogEntry): void;
+    private formatTimestamp;
+    private getLevelName;
+    private colorize;
+}
+
+/**
+ * @package sa2kit/common/logger
+ * 通用日志模块（2.0 common）
+ */
+
+type index_ConsoleLoggerAdapter = ConsoleLoggerAdapter;
+declare const index_ConsoleLoggerAdapter: typeof ConsoleLoggerAdapter;
+type index_LogEntry = LogEntry;
+type index_LogLevel = LogLevel;
+declare const index_LogLevel: typeof LogLevel;
+type index_Logger = Logger;
+declare const index_Logger: typeof Logger;
+type index_LoggerAdapter = LoggerAdapter;
+type index_LoggerConfig = LoggerConfig;
+declare const index_createLogger: typeof createLogger;
+declare const index_logger: typeof logger;
+declare namespace index {
+  export { index_ConsoleLoggerAdapter as ConsoleLoggerAdapter, type index_LogEntry as LogEntry, index_LogLevel as LogLevel, index_Logger as Logger, type index_LoggerAdapter as LoggerAdapter, type index_LoggerConfig as LoggerConfig, index_createLogger as createLogger, index_logger as logger };
+}
+
+export { ConsoleLoggerAdapter as C, LogLevel as L, type LogEntry as a, type LoggerAdapter as b, type LoggerConfig as c, Logger as d, createLogger as e, index as i, logger as l };

package/dist/index-FVJZCEtm.d.ts

@@ -0,0 +1,145 @@
+/**
+ * 日志级别
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * 日志条目
+ */
+interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    data?: any;
+    context?: string;
+    error?: Error;
+}
+/**
+ * 日志适配器接口
+ * 不同平台实现不同的日志输出方式
+ */
+interface LoggerAdapter {
+    /**
+     * 输出日志
+     */
+    log(entry: LogEntry): void;
+    /**
+     * 批量输出日志（可选）
+     */
+    logBatch?(entries: LogEntry[]): void;
+}
+/**
+ * 日志配置
+ */
+interface LoggerConfig {
+    /**
+     * 最小日志级别
+     * 只有大于等于此级别的日志才会输出
+     */
+    minLevel: LogLevel;
+    /**
+     * 是否启用时间戳
+     */
+    enableTimestamp?: boolean;
+    /**
+     * 是否启用上下文（模块名）
+     */
+    enableContext?: boolean;
+    /**
+     * 环境（development/production）
+     */
+    environment?: 'development' | 'production';
+    /**
+     * 自定义适配器
+     */
+    adapter?: LoggerAdapter;
+}
+
+/**
+ * 统一日志管理类
+ */
+declare class Logger {
+    private config;
+    private adapter;
+    private context?;
+    constructor(config?: Partial<LoggerConfig>, context?: string);
+    /**
+     * 创建带上下文的子 Logger
+     */
+    createChild(context: string): Logger;
+    /**
+     * 调试日志
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * 信息日志
+     */
+    info(message: string, data?: any): void;
+    /**
+     * 警告日志
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * 错误日志
+     */
+    error(message: string, error?: Error | any): void;
+    /**
+     * 核心日志方法
+     */
+    private log;
+    /**
+     * 设置日志级别
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * 获取当前日志级别
+     */
+    getLevel(): LogLevel;
+}
+/**
+ * 默认全局 Logger 实例
+ */
+declare const logger: Logger;
+/**
+ * 创建带上下文的 Logger
+ */
+declare function createLogger(context: string, config?: Partial<LoggerConfig>): Logger;
+
+/**
+ * 控制台日志适配器
+ * 使用 console.info/warn/error 输出日志
+ */
+declare class ConsoleLoggerAdapter implements LoggerAdapter {
+    private readonly colors;
+    log(entry: LogEntry): void;
+    private formatTimestamp;
+    private getLevelName;
+    private colorize;
+}
+
+/**
+ * @package sa2kit/common/logger
+ * 通用日志模块（2.0 common）
+ */
+
+type index_ConsoleLoggerAdapter = ConsoleLoggerAdapter;
+declare const index_ConsoleLoggerAdapter: typeof ConsoleLoggerAdapter;
+type index_LogEntry = LogEntry;
+type index_LogLevel = LogLevel;
+declare const index_LogLevel: typeof LogLevel;
+type index_Logger = Logger;
+declare const index_Logger: typeof Logger;
+type index_LoggerAdapter = LoggerAdapter;
+type index_LoggerConfig = LoggerConfig;
+declare const index_createLogger: typeof createLogger;
+declare const index_logger: typeof logger;
+declare namespace index {
+  export { index_ConsoleLoggerAdapter as ConsoleLoggerAdapter, type index_LogEntry as LogEntry, index_LogLevel as LogLevel, index_Logger as Logger, type index_LoggerAdapter as LoggerAdapter, type index_LoggerConfig as LoggerConfig, index_createLogger as createLogger, index_logger as logger };
+}
+
+export { ConsoleLoggerAdapter as C, LogLevel as L, type LogEntry as a, type LoggerAdapter as b, type LoggerConfig as c, Logger as d, createLogger as e, index as i, logger as l };

package/dist/index-nD9vPCZT.d.ts

@@ -0,0 +1,159 @@
+import { S as StorageAdapter, a as StorageChangeEvent } from './types-BaZccpvk.js';
+
+/**
+ * Web 平台存储适配器 (localStorage)
+ */
+
+declare class WebStorageAdapter implements StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    addChangeListener(callback: (key: string, value: string | null) => void): () => void;
+    /**
+     * 触发自定义事件，通知同标签页的其他组件
+     */
+    dispatchChange(key: string, value: string | null): void;
+}
+
+/**
+ * React Native 平台存储适配器 (AsyncStorage)
+ */
+
+declare class ReactNativeStorageAdapter implements StorageAdapter {
+    private listeners;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    addChangeListener(callback: (key: string, value: string | null) => void): () => void;
+    private notifyListeners;
+}
+
+/**
+ * 小程序平台存储适配器 (wx.storage / Taro.storage)
+ * 仅在小程序环境下加载和使用
+ */
+
+declare class MiniAppStorageAdapter implements StorageAdapter {
+    private listeners;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    addChangeListener(callback: (key: string, value: string | null) => void): () => void;
+    private notifyListeners;
+}
+
+/**
+ * Electron 桌面端存储适配器
+ *
+ * Electron 渲染进程可以使用 localStorage（和 Web 相同）
+ * 但我们提供专门的适配器以支持未来可能的主进程存储需求
+ */
+
+declare class ElectronStorageAdapter implements StorageAdapter {
+    private listeners;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    /**
+     * 添加存储变化监听器
+     * 支持跨 Electron 窗口同步
+     */
+    addChangeListener(listener: (key: string, newValue: string | null) => void): () => void;
+    removeChangeListener(listener: (key: string, newValue: string | null) => void): void;
+    /**
+     * 通知监听器
+     */
+    private notifyListeners;
+}
+
+/**
+ * 通用存储 Hook
+ * 支持多平台：Web、React Native、小程序
+ *
+ * 优点：
+ * 1. 异步读取，不阻塞渲染
+ * 2. 统一的错误处理
+ * 3. 类型安全
+ * 4. 跨平台支持
+ * 5. 自动同步（支持的平台）
+ */
+
+declare function useStorage<T>(storage: StorageAdapter, key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * Web 平台 localStorage Hook
+ * 基于通用 useStorage 的便捷封装
+ */
+/**
+ * Web 平台的 localStorage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useLocalStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * React Native 的 AsyncStorage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useAsyncStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * 小程序的 Taro Storage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useTaroStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * Electron 桌面端的 Storage Hook
+ *
+ * 在 Electron 渲染进程中使用 localStorage
+ * 支持跨窗口同步
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ *
+ * @example
+ * ```tsx
+ * const [token, setToken, removeToken] = useElectronStorage('auth-token', '')
+ * ```
+ */
+declare function useElectronStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * @package sa2kit/common/storage
+ * 跨平台存储适配器与 Hooks
+ */
+
+type index_ElectronStorageAdapter = ElectronStorageAdapter;
+declare const index_ElectronStorageAdapter: typeof ElectronStorageAdapter;
+type index_MiniAppStorageAdapter = MiniAppStorageAdapter;
+declare const index_MiniAppStorageAdapter: typeof MiniAppStorageAdapter;
+type index_ReactNativeStorageAdapter = ReactNativeStorageAdapter;
+declare const index_ReactNativeStorageAdapter: typeof ReactNativeStorageAdapter;
+declare const index_StorageAdapter: typeof StorageAdapter;
+declare const index_StorageChangeEvent: typeof StorageChangeEvent;
+type index_WebStorageAdapter = WebStorageAdapter;
+declare const index_WebStorageAdapter: typeof WebStorageAdapter;
+declare const index_useAsyncStorage: typeof useAsyncStorage;
+declare const index_useElectronStorage: typeof useElectronStorage;
+declare const index_useLocalStorage: typeof useLocalStorage;
+declare const index_useStorage: typeof useStorage;
+declare const index_useTaroStorage: typeof useTaroStorage;
+declare namespace index {
+  export { index_ElectronStorageAdapter as ElectronStorageAdapter, index_MiniAppStorageAdapter as MiniAppStorageAdapter, index_ReactNativeStorageAdapter as ReactNativeStorageAdapter, index_StorageAdapter as StorageAdapter, index_StorageChangeEvent as StorageChangeEvent, index_WebStorageAdapter as WebStorageAdapter, index_useAsyncStorage as useAsyncStorage, index_useElectronStorage as useElectronStorage, index_useLocalStorage as useLocalStorage, index_useStorage as useStorage, index_useTaroStorage as useTaroStorage };
+}
+
+export { ElectronStorageAdapter as E, MiniAppStorageAdapter as M, ReactNativeStorageAdapter as R, WebStorageAdapter as W, useLocalStorage as a, useAsyncStorage as b, useTaroStorage as c, useElectronStorage as d, index as i, useStorage as u };