@composy/store-core 0.0.1 → 0.0.2

package/esm/errors/index.d.ts

@@ -1,208 +0,0 @@
-/**
- * 自定义错误类
- *
- * 提供统一的错误处理模式
- * @module errors
- */
-/**
- * Store 错误代码
- */
-export declare enum StoreErrorCode {
-    /** Store 已销毁 */
-    STORE_DISPOSED = "STORE_DISPOSED",
-    /** Store 不存在 */
-    STORE_NOT_FOUND = "STORE_NOT_FOUND",
-    /** Store 已存在 */
-    STORE_ALREADY_EXISTS = "STORE_ALREADY_EXISTS",
-    /** 无效的状态 */
-    INVALID_STATE = "INVALID_STATE",
-    /** 无效的 Action */
-    INVALID_ACTION = "INVALID_ACTION",
-    /** 序列化错误 */
-    SERIALIZATION_ERROR = "SERIALIZATION_ERROR",
-    /** 反序列化错误 */
-    DESERIALIZATION_ERROR = "DESERIALIZATION_ERROR",
-    /** 存储错误 */
-    STORAGE_ERROR = "STORAGE_ERROR",
-    /** 插件错误 */
-    PLUGIN_ERROR = "PLUGIN_ERROR",
-    /** 中间件错误 */
-    MIDDLEWARE_ERROR = "MIDDLEWARE_ERROR",
-    /** 订阅错误 */
-    SUBSCRIPTION_ERROR = "SUBSCRIPTION_ERROR",
-    /** 超时错误 */
-    TIMEOUT_ERROR = "TIMEOUT_ERROR",
-    /** 未知错误 */
-    UNKNOWN_ERROR = "UNKNOWN_ERROR"
-}
-/**
- * 错误严重级别
- */
-export declare enum ErrorSeverity {
-    /** 警告 - 不影响功能，但需要注意 */
-    WARNING = "warning",
-    /** 错误 - 影响部分功能 */
-    ERROR = "error",
-    /** 致命 - 导致系统无法正常运行 */
-    FATAL = "fatal"
-}
-/**
- * Store 错误上下文
- */
-export interface StoreErrorContext {
-    /** Store ID */
-    storeId?: string;
-    /** Action 名称 */
-    action?: string;
-    /** 插件名称 */
-    plugin?: string;
-    /** 中间件名称 */
-    middleware?: string;
-    /** 额外数据 */
-    data?: unknown;
-    /** 时间戳 */
-    timestamp?: number;
-}
-/**
- * Store 基础错误类
- *
- * 所有 Store 相关错误的基类
- *
- * @example
- * ```typescript
- * try {
- *   store.someAction()
- * } catch (error) {
- *   if (error instanceof StoreError) {
- *     console.log('Store error:', error.code, error.message)
- *     console.log('Context:', error.context)
- *   }
- * }
- * ```
- */
-export declare class StoreError extends Error {
-    /** 错误代码 */
-    readonly code: StoreErrorCode;
-    /** 错误上下文 */
-    readonly context: StoreErrorContext;
-    /** 错误严重级别 */
-    readonly severity: ErrorSeverity;
-    /** 原始错误 */
-    readonly cause?: Error;
-    /**
-     * 创建 Store 错误
-     *
-     * @param message - 错误消息
-     * @param code - 错误代码
-     * @param context - 错误上下文
-     * @param severity - 错误严重级别
-     * @param cause - 原始错误
-     */
-    constructor(message: string, code?: StoreErrorCode, context?: StoreErrorContext, severity?: ErrorSeverity, cause?: Error);
-    /**
-     * 转换为 JSON
-     */
-    toJSON(): Record<string, unknown>;
-    /**
-     * 格式化错误信息
-     */
-    format(): string;
-}
-/**
- * Store 销毁错误
- *
- * 当尝试操作已销毁的 Store 时抛出
- */
-export declare class StoreDisposedError extends StoreError {
-    constructor(storeId: string, action?: string);
-}
-/**
- * Store 不存在错误
- */
-export declare class StoreNotFoundError extends StoreError {
-    constructor(storeId: string);
-}
-/**
- * Store 已存在错误
- */
-export declare class StoreAlreadyExistsError extends StoreError {
-    constructor(storeId: string);
-}
-/**
- * 无效状态错误
- */
-export declare class InvalidStateError extends StoreError {
-    constructor(message: string, storeId?: string, data?: unknown);
-}
-/**
- * 序列化错误
- */
-export declare class SerializationError extends StoreError {
-    constructor(message: string, cause?: Error, storeId?: string);
-}
-/**
- * 反序列化错误
- */
-export declare class DeserializationError extends StoreError {
-    constructor(message: string, cause?: Error, storeId?: string);
-}
-/**
- * 存储错误
- */
-export declare class StorageError extends StoreError {
-    constructor(message: string, cause?: Error, storeId?: string);
-}
-/**
- * 插件错误
- */
-export declare class PluginError extends StoreError {
-    constructor(message: string, pluginName: string, cause?: Error);
-}
-/**
- * 中间件错误
- */
-export declare class MiddlewareError extends StoreError {
-    constructor(message: string, middlewareName: string, cause?: Error);
-}
-/**
- * 订阅错误
- */
-export declare class SubscriptionError extends StoreError {
-    constructor(message: string, cause?: Error, storeId?: string);
-}
-/**
- * 超时错误
- */
-export declare class TimeoutError extends StoreError {
-    constructor(message: string, storeId?: string, action?: string);
-}
-/**
- * 错误处理工具
- */
-export declare const errorUtils: {
-    /**
-     * 判断是否为 Store 错误
-     */
-    isStoreError(error: unknown): error is StoreError;
-    /**
-     * 判断是否为特定类型的错误
-     */
-    isErrorCode(error: unknown, code: StoreErrorCode): boolean;
-    /**
-     * 包装错误为 Store 错误
-     */
-    wrap(error: unknown, code?: StoreErrorCode, context?: StoreErrorContext): StoreError;
-    /**
-     * 安全执行函数，捕获并包装错误
-     */
-    tryCatch<T>(fn: () => T | Promise<T>, code?: StoreErrorCode, context?: StoreErrorContext): Promise<T>;
-    /**
-     * 创建错误日志记录器
-     */
-    createLogger(prefix: string): {
-        error(error: StoreError): void;
-        warn(error: StoreError): void;
-        log(error: StoreError): void;
-    };
-};
-//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * @composy/store-core - 框架无关的状态管理核心库
- *
- * 主要功能模块：
- * - 核心抽象：Store、State、Action、Getter 等核心概念
- * - 插件系统：可扩展的插件机制
- * - 中间件：日志、持久化、时间旅行等
- * - 订阅发布：状态变化订阅、事件总线
- * - 批量更新：性能优化的批量状态更新
- * - 工具函数：深拷贝、选择器等
- *
- * @module @composy/store-core
- */
-export { BaseStore, batch, createAsyncAction, createBatchManager, createEventBus, createPubSub, createPubSubWithValue, createStore, getGlobalBatchManager, globalEventBus, setGlobalBatchManager, } from './core';
-export type { AsyncAction, AsyncActionOptions, AsyncActionState, CreateStoreDefinition, StoreAPI, } from './core';
-export * from './engine';
-export { DeserializationError, ErrorSeverity, errorUtils, InvalidStateError, MiddlewareError, PluginError, SerializationError, StorageError, StoreAlreadyExistsError, StoreDisposedError, StoreError, StoreErrorCode, StoreNotFoundError, SubscriptionError, TimeoutError, } from './errors';
-export type { StoreErrorContext, } from './errors';
-export { createLoggerMiddleware, createMiddlewareManager, createPersistMiddleware, createSimpleLoggerMiddleware, createTimeTravelMiddleware, createValidationMiddleware, getGlobalMiddlewareManager, restoreState, setGlobalMiddlewareManager, setRestoreCallback, } from './middleware';
-export type { StoreValidationRules, ValidationError, ValidationMiddlewareOptions, ValidationResult, ValidationRule, } from './middleware';
-export { composePlugins, createPluginFactory, createPluginManager, defineStorePlugin, getGlobalPluginManager, setGlobalPluginManager, } from './plugins';
-export type { ActionContext, ActionSubscriber, BatchContext, BatchManager, DefinePluginOptions, EventBus, EventData, EventListener, EventType, LoggerMiddlewareOptions, Middleware, MiddlewareActionType, MiddlewareContext, MiddlewareFunction, MiddlewareManager, PersistMiddlewareOptions, PersistOptions, PluginContext, PluginFactory, PluginManager, PubSub, Selector, SelectorOptions, StateMutation, StateSnapshot, StateSubscriber, StateTree, StorageAdapter, StoreAction, StoreActions, StoreDefinition, StoreGetter, StoreGetters, StoreId, StoreInstance, StoreManagerLike, StoreOptions, StorePlugin, SubscribeOptions, Subscriber, SubscriptionOptions, TimeTravelController, TimeTravelMiddlewareOptions, Unsubscribe, } from './types';
-export { combineSelectors, createCachedSelector, createMemoizedSelector, createSelector, createSelectorWithDeps, debounce, deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, deleteByPath, getByPath, hasPath, isObject, isPlainObject, setByPath, shallowClone, throttle, } from './utils';
-export declare const version = "1.0.0";
-export declare const name = "@composy/store-core";
-export type { DebouncedFunction, DeepCloneOptions, DeepMergeOptions, MemoizedSelectorOptions, SelectorEqualityFn, ThrottledFunction, } from './utils';
-//# sourceMappingURL=index.d.ts.map

package/esm/middleware/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * 中间件模块导出
- *
- * 提供日志、持久化、时间旅行等中间件
- * @module middleware
- */
-export { createLoggerMiddleware, createProductionLoggerMiddleware, createSimpleLoggerMiddleware, } from './logger';
-export { createMiddlewareManager, getGlobalMiddlewareManager, setGlobalMiddlewareManager, } from './middleware-manager';
-export { createPersistMiddleware, restoreState, } from './persist';
-export { createTimeTravelMiddleware, setRestoreCallback, } from './time-travel';
-export { createValidationMiddleware, } from './validation';
-export type { StoreValidationRules, ValidationError, ValidationMiddlewareOptions, ValidationResult, ValidationRule, } from './validation';
-//# sourceMappingURL=index.d.ts.map

package/esm/middleware/logger.d.ts

@@ -1,67 +0,0 @@
-/**
- * 日志中间件
- *
- * 提供状态变化和 Action 调用的日志记录，支持多种日志级别和格式化选项
- * @module middleware/logger
- */
-import type { LoggerMiddlewareOptions, Middleware, MiddlewareContext } from '../types';
-/**
- * 创建日志中间件
- *
- * 提供完整的状态变化和 Action 调用日志记录，支持时间戳、分组和性能计时
- *
- * @param options - 日志选项
- * @returns 日志中间件
- *
- * @example
- * ```typescript
- * const logger = createLoggerMiddleware({
- *   logState: true,
- *   collapsed: true,
- *   timestamp: true,
- *   filter: (context) => context.storeId !== 'internal'
- * })
- *
- * middlewareManager.use(logger)
- * ```
- */
-export declare function createLoggerMiddleware(options?: LoggerMiddlewareOptions): Middleware;
-/**
- * 简单日志中间件（不使用分组，适合生产环境）
- *
- * @param options - 配置选项
- * @param options.includePayload - 是否输出 payload
- * @param options.format - 自定义日志格式化函数
- * @param options.filter - 日志过滤器
- * @returns 简单日志中间件
- *
- * @example
- * ```typescript
- * const logger = createSimpleLoggerMiddleware({
- *   includePayload: true,
- *   format: (ctx) => `${ctx.storeId}: ${ctx.type}`
- * })
- * ```
- */
-export declare function createSimpleLoggerMiddleware(options?: {
-    /** 是否包含 payload */
-    includePayload?: boolean;
-    /** 自定义格式化函数 */
-    format?: (context: MiddlewareContext) => string;
-    /** 过滤器 */
-    filter?: (context: MiddlewareContext) => boolean;
-}): Middleware;
-/**
- * 创建生产环境日志中间件
- *
- * 只记录错误和警告，不记录正常状态变化
- *
- * @param options - 配置选项
- * @param options.onError - 自定义错误处理器
- * @returns 生产环境日志中间件
- */
-export declare function createProductionLoggerMiddleware(options?: {
-    /** 自定义错误处理器 */
-    onError?: (error: Error, context: MiddlewareContext) => void;
-}): Middleware;
-//# sourceMappingURL=logger.d.ts.map

package/esm/middleware/middleware-manager.d.ts

@@ -1,40 +0,0 @@
-/**
- * 中间件管理器
- *
- * @module middleware/middleware-manager
- */
-import type { MiddlewareManager } from '../types';
-/**
- * 创建中间件管理器
- *
- * @returns 中间件管理器实例
- *
- * @example
- * ```typescript
- * const manager = createMiddlewareManager()
- *
- * // 添加日志中间件
- * manager.use({
- *   name: 'logger',
- *   priority: 1,
- *   handler: async (ctx, next) => {
- *     console.log('Before:', ctx.type)
- *     await next()
- *     console.log('After:', ctx.type)
- *   }
- * })
- *
- * // 执行中间件链
- * await manager.execute({ storeId: 'test', state: {}, type: 'state:patch' })
- * ```
- */
-export declare function createMiddlewareManager(): MiddlewareManager;
-/**
- * 获取全局中间件管理器
- */
-export declare function getGlobalMiddlewareManager(): MiddlewareManager;
-/**
- * 设置全局中间件管理器
- */
-export declare function setGlobalMiddlewareManager(manager: MiddlewareManager): void;
-//# sourceMappingURL=middleware-manager.d.ts.map

package/esm/plugins/plugin-manager.d.ts

@@ -1,35 +0,0 @@
-/**
- * 插件管理器
- *
- * @module plugins/plugin-manager
- */
-import type { PluginManager } from '../types';
-/**
- * 创建插件管理器
- *
- * @returns 插件管理器实例
- *
- * @example
- * ```typescript
- * const manager = createPluginManager()
- *
- * // 注册插件
- * manager.use(myPlugin, { option: 'value' })
- *
- * // 获取插件
- * const plugin = manager.get('my-plugin')
- *
- * // 移除插件
- * manager.remove('my-plugin')
- * ```
- */
-export declare function createPluginManager(): PluginManager;
-/**
- * 获取全局插件管理器
- */
-export declare function getGlobalPluginManager(): PluginManager;
-/**
- * 设置全局插件管理器
- */
-export declare function setGlobalPluginManager(manager: PluginManager): void;
-//# sourceMappingURL=plugin-manager.d.ts.map

package/esm/types/middleware.d.ts

@@ -1,172 +0,0 @@
-/**
- * 中间件系统类型定义
- *
- * @module types/middleware
- */
-import type { StateTree, StoreId } from './store';
-/**
- * 中间件上下文
- * @template S - 状态类型
- */
-export interface MiddlewareContext<S extends StateTree = StateTree> {
-    /** Store ID */
-    storeId: StoreId;
-    /** 当前状态 */
-    state: S;
-    /** 操作类型 */
-    type: MiddlewareActionType;
-    /** 操作数据 */
-    payload?: unknown;
-    /** 元数据 */
-    meta?: Record<string, unknown>;
-}
-/**
- * 中间件操作类型
- */
-export type MiddlewareActionType = 'state:init' | 'state:patch' | 'state:reset' | 'action:before' | 'action:after' | 'action:error';
-/**
- * 中间件函数类型
- * @template S - 状态类型
- */
-export type MiddlewareFunction<S extends StateTree = StateTree> = (context: MiddlewareContext<S>, next: () => void | Promise<void>) => void | Promise<void>;
-/**
- * 中间件接口
- * @template S - 状态类型
- */
-export interface Middleware<S extends StateTree = StateTree> {
-    /** 中间件名称 */
-    readonly name: string;
-    /** 中间件优先级（数字越小越先执行） */
-    readonly priority?: number;
-    /** 中间件处理函数 */
-    handler: MiddlewareFunction<S>;
-}
-/**
- * 中间件管理器接口
- */
-export interface MiddlewareManager {
-    /**
-     * 添加中间件
-     * @param middleware - 中间件实例
-     */
-    use: (middleware: Middleware) => void;
-    /**
-     * 移除中间件
-     * @param name - 中间件名称
-     */
-    remove: (name: string) => void;
-    /**
-     * 获取中间件
-     * @param name - 中间件名称
-     */
-    get: (name: string) => Middleware | undefined;
-    /**
-     * 是否存在中间件
-     * @param name - 中间件名称
-     */
-    has: (name: string) => boolean;
-    /**
-     * 执行中间件链
-     * @param context - 上下文
-     */
-    execute: (context: MiddlewareContext) => Promise<void>;
-    /**
-     * 获取所有中间件
-     */
-    getAll: () => Middleware[];
-    /**
-     * 清空所有中间件
-     */
-    clear: () => void;
-}
-/**
- * 日志中间件选项
- */
-export interface LoggerMiddlewareOptions {
-    /** 是否记录状态变化 */
-    logState?: boolean;
-    /** 是否记录 action */
-    logAction?: boolean;
-    /** 是否折叠日志 */
-    collapsed?: boolean;
-    /** 是否显示时间戳 */
-    timestamp?: boolean;
-    /** 日志级别 */
-    level?: 'log' | 'info' | 'warn' | 'debug';
-    /** 自定义日志器 */
-    logger?: {
-        log: (...args: unknown[]) => void;
-        info: (...args: unknown[]) => void;
-        warn: (...args: unknown[]) => void;
-        debug: (...args: unknown[]) => void;
-        error?: (...args: unknown[]) => void;
-        group?: (...args: unknown[]) => void;
-        groupCollapsed?: (...args: unknown[]) => void;
-        groupEnd?: () => void;
-    };
-    /** 自定义过滤器 */
-    filter?: (context: MiddlewareContext) => boolean;
-}
-/**
- * 持久化中间件选项
- */
-export interface PersistMiddlewareOptions {
-    /** 存储键名前缀 */
-    keyPrefix?: string;
-    /** 存储类型 */
-    storage?: 'localStorage' | 'sessionStorage';
-    /** 要持久化的 Store ID 列表（空则全部持久化） */
-    stores?: StoreId[];
-    /** 要持久化的状态路径 */
-    paths?: Record<StoreId, string[]>;
-    /** 序列化函数 */
-    serialize?: (value: unknown) => string;
-    /** 反序列化函数 */
-    deserialize?: (value: string) => unknown;
-    /** 防抖延迟（毫秒） */
-    debounce?: number;
-}
-/**
- * 时间旅行中间件选项
- */
-export interface TimeTravelMiddlewareOptions {
-    /** 最大历史记录数 */
-    maxHistory?: number;
-    /** 是否启用 */
-    enabled?: boolean;
-}
-/**
- * 时间旅行控制器
- */
-export interface TimeTravelController {
-    /** 撤销 */
-    undo: () => void;
-    /** 重做 */
-    redo: () => void;
-    /** 跳转到指定历史 */
-    goto: (index: number) => void;
-    /** 获取历史记录 */
-    getHistory: () => StateSnapshot[];
-    /** 当前历史索引 */
-    getCurrentIndex: () => number;
-    /** 是否可撤销 */
-    canUndo: () => boolean;
-    /** 是否可重做 */
-    canRedo: () => boolean;
-    /** 清空历史 */
-    clear: () => void;
-}
-/**
- * 状态快照
- */
-export interface StateSnapshot {
-    /** 快照时间 */
-    timestamp: number;
-    /** 状态数据 */
-    state: StateTree;
-    /** 操作类型 */
-    type: MiddlewareActionType;
-    /** Store ID */
-    storeId: StoreId;
-}
-//# sourceMappingURL=middleware.d.ts.map

package/esm/types/plugin.d.ts

@@ -1,136 +0,0 @@
-/**
- * 插件系统类型定义
- *
- * @module types/plugin
- */
-import type { StateTree, StoreId } from './store';
-/**
- * 插件上下文
- */
-export interface PluginContext {
-    /** Store 管理器实例 */
-    storeManager: StoreManagerLike;
-    /** 当前 Store ID */
-    storeId: StoreId;
-    /** 当前 Store 实例 */
-    store: unknown;
-    /** 插件配置选项 */
-    options: Record<string, unknown>;
-}
-/**
- * Store 管理器接口（简化版）
- */
-export interface StoreManagerLike {
-    /** 获取 Store */
-    getStore: (id: StoreId) => unknown;
-    /** 是否存在 Store */
-    hasStore: (id: StoreId) => boolean;
-    /** 获取所有 Store ID */
-    getStoreIds: () => StoreId[];
-}
-/**
- * 插件接口
- * @template Options - 插件选项类型
- */
-export interface StorePlugin<Options = Record<string, unknown>> {
-    /** 插件名称 */
-    readonly name: string;
-    /** 插件版本 */
-    readonly version?: string;
-    /** 插件描述 */
-    readonly description?: string;
-    /**
-     * 安装插件
-     * @param context - 插件上下文
-     * @param options - 插件选项
-     */
-    install: (context: PluginContext, options?: Options) => void | Promise<void>;
-    /**
-     * 卸载插件
-     * @param context - 插件上下文
-     */
-    uninstall?: (context: PluginContext) => void | Promise<void>;
-    /**
-     * Store 创建时的钩子
-     * @param store - Store 实例
-     */
-    onStoreCreated?: (store: unknown) => void;
-    /**
-     * Store 销毁时的钩子
-     * @param store - Store 实例
-     */
-    onStoreDisposed?: (store: unknown) => void;
-    /**
-     * 状态变化时的钩子
-     * @param storeId - Store ID
-     * @param state - 新状态
-     * @param oldState - 旧状态
-     */
-    onStateChange?: <S extends StateTree>(storeId: StoreId, state: S, oldState: S) => void;
-}
-/**
- * 插件工厂函数类型
- * @template Options - 插件选项类型
- */
-export type PluginFactory<Options = Record<string, unknown>> = (options?: Options) => StorePlugin<Options>;
-/**
- * 定义插件选项
- * @template Options - 插件选项类型
- */
-export interface DefinePluginOptions<Options = Record<string, unknown>> {
-    /** 插件名称 */
-    name: string;
-    /** 插件版本 */
-    version?: string;
-    /** 插件描述 */
-    description?: string;
-    /** 安装函数 */
-    install: StorePlugin<Options>['install'];
-    /** 卸载函数 */
-    uninstall?: StorePlugin<Options>['uninstall'];
-    /** Store 创建钩子 */
-    onStoreCreated?: StorePlugin<Options>['onStoreCreated'];
-    /** Store 销毁钩子 */
-    onStoreDisposed?: StorePlugin<Options>['onStoreDisposed'];
-    /** 状态变化钩子 */
-    onStateChange?: StorePlugin<Options>['onStateChange'];
-}
-/**
- * 插件管理器接口
- */
-export interface PluginManager {
-    /**
-     * 注册插件
-     * @param plugin - 插件实例
-     * @param options - 插件选项
-     */
-    use: <Options>(plugin: StorePlugin<Options>, options?: Options) => void;
-    /**
-     * 移除插件
-     * @param name - 插件名称
-     */
-    remove: (name: string) => void;
-    /**
-     * 获取插件
-     * @param name - 插件名称
-     */
-    get: (name: string) => StorePlugin | undefined;
-    /**
-     * 是否已注册插件
-     * @param name - 插件名称
-     */
-    has: (name: string) => boolean;
-    /**
-     * 获取所有插件
-     */
-    getAll: () => Map<string, StorePlugin>;
-    /**
-     * 获取插件数量
-     */
-    size: () => number;
-    /**
-     * 清空所有插件
-     */
-    clear: () => void;
-}
-//# sourceMappingURL=plugin.d.ts.map