@composy/store-core 0.0.1

package/es/middleware/logger.js

@@ -0,0 +1,136 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { MiddlewareError } from "../errors/index.js";
+import { deepClone } from "../utils/deep-clone.js";
+//#region src/middleware/logger.ts
+const defaultOptions = {
+	logState: true,
+	logAction: true,
+	collapsed: true,
+	timestamp: true,
+	level: "log"
+};
+const LOG_COLORS = {
+	prevState: "color: #9E9E9E; font-weight: bold",
+	action: "color: #03A9F4; font-weight: bold",
+	nextState: "color: #4CAF50; font-weight: bold",
+	error: "color: #F44336; font-weight: bold",
+	duration: "color: #9C27B0; font-weight: normal",
+	title: "color: inherit; font-weight: bold"
+};
+function formatTime(date) {
+	return `${date.getHours().toString().padStart(2, "0")}:${date.getMinutes().toString().padStart(2, "0")}:${date.getSeconds().toString().padStart(2, "0")}.${date.getMilliseconds().toString().padStart(3, "0")}`;
+}
+function formatDuration(startTime, endTime) {
+	const duration = endTime - startTime;
+	if (duration < 1) return "< 1ms";
+	return `${duration.toFixed(2)}ms`;
+}
+function safeCloneState(state) {
+	try {
+		return deepClone(state);
+	} catch {
+		return { ...state };
+	}
+}
+function createLoggerMiddleware(options = {}) {
+	const opts = {
+		...defaultOptions,
+		...options
+	};
+	const logger = opts.logger ?? console;
+	return {
+		name: "logger",
+		priority: 0,
+		handler: async (context, next) => {
+			const { storeId, type, state, payload } = context;
+			if (opts.filter && !opts.filter(context)) {
+				await next();
+				return;
+			}
+			const isStateChange = type.startsWith("state:");
+			const isAction = type.startsWith("action:");
+			if (isStateChange && !opts.logState || isAction && !opts.logAction) {
+				await next();
+				return;
+			}
+			const timestamp = opts.timestamp ? formatTime(/* @__PURE__ */ new Date()) : "";
+			const prefix = `[Store: ${storeId}]`;
+			const startTime = performance.now();
+			const prevState = safeCloneState(state);
+			const groupTitle = timestamp ? `${timestamp} ${prefix} ${type}` : `${prefix} ${type}`;
+			const startGroup = () => {
+				if (opts.collapsed && typeof logger.groupCollapsed === "function") logger.groupCollapsed(`%c${groupTitle}`, LOG_COLORS.title);
+				else if (typeof logger.group === "function") logger.group(`%c${groupTitle}`, LOG_COLORS.title);
+			};
+			const endGroup = () => {
+				if (typeof logger.groupEnd === "function") logger.groupEnd();
+			};
+			startGroup();
+			try {
+				const logFn = logger[opts.level ?? "log"] ?? logger.log;
+				if (typeof logFn === "function") {
+					logFn.call(logger, "%c prev state", LOG_COLORS.prevState, prevState);
+					if (payload !== void 0) logFn.call(logger, "%c payload", LOG_COLORS.action, payload);
+				}
+				await next();
+				const endTime = performance.now();
+				if (typeof logFn === "function") {
+					logFn.call(logger, "%c next state", LOG_COLORS.nextState, safeCloneState(context.state));
+					logFn.call(logger, "%c duration", LOG_COLORS.duration, formatDuration(startTime, endTime));
+				}
+			} catch (error) {
+				if (typeof logger.error === "function") logger.error("%c error", LOG_COLORS.error, error);
+				throw new MiddlewareError(`\u65E5\u5FD7\u4E2D\u95F4\u4EF6\u6267\u884C\u9519\u8BEF: ${error instanceof Error ? error.message : String(error)}`, "logger", error instanceof Error ? error : void 0);
+			} finally {
+				endGroup();
+			}
+		}
+	};
+}
+function createSimpleLoggerMiddleware(options = {}) {
+	const { includePayload = true, format, filter } = options;
+	return {
+		name: "simple-logger",
+		priority: 0,
+		handler: async (context, next) => {
+			const { storeId, type, payload } = context;
+			if (filter && !filter(context)) {
+				await next();
+				return;
+			}
+			const message = format ? format(context) : `[Store: ${storeId}] ${type}`;
+			if (includePayload && payload !== void 0) console.info(message, payload);
+			else console.info(message);
+			await next();
+		}
+	};
+}
+function createProductionLoggerMiddleware(options = {}) {
+	const { onError } = options;
+	return {
+		name: "production-logger",
+		priority: 0,
+		handler: async (context, next) => {
+			try {
+				await next();
+			} catch (error) {
+				const err = error instanceof Error ? error : new Error(String(error));
+				if (onError) onError(err, context);
+				else console.error(`[Store Error] ${context.storeId}:`, err);
+				throw error;
+			}
+		}
+	};
+}
+//#endregion
+export { createLoggerMiddleware, createProductionLoggerMiddleware, createSimpleLoggerMiddleware };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=logger.js.map

package/es/middleware/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":[],"sources":["../../src/middleware/logger.ts"],"sourcesContent":["/**\n * 日志中间件\n *\n * 提供状态变化和 Action 调用的日志记录，支持多种日志级别和格式化选项\n * @module middleware/logger\n */\n\nimport type { LoggerMiddlewareOptions, Middleware, MiddlewareContext, StateTree } from '../types'\nimport { MiddlewareError } from '../errors'\nimport { deepClone } from '../utils'\n\n/**\n * 默认日志选项\n */\nconst defaultOptions: Required<Omit<LoggerMiddlewareOptions, 'logger' | 'filter'>> = {\n  logState: true,\n  logAction: true,\n  collapsed: true,\n  timestamp: true,\n  level: 'log',\n}\n\n/**\n * 日志颜色配置\n */\nconst LOG_COLORS = {\n  prevState: 'color: #9E9E9E; font-weight: bold',\n  action: 'color: #03A9F4; font-weight: bold',\n  nextState: 'color: #4CAF50; font-weight: bold',\n  error: 'color: #F44336; font-weight: bold',\n  duration: 'color: #9C27B0; font-weight: normal',\n  title: 'color: inherit; font-weight: bold',\n} as const\n\n/**\n * 格式化时间戳\n *\n * @param date - 日期对象\n * @returns 格式化的时间字符串\n */\nfunction formatTime(date: Date): string {\n  const hours = date.getHours().toString().padStart(2, '0')\n  const minutes = date.getMinutes().toString().padStart(2, '0')\n  const seconds = date.getSeconds().toString().padStart(2, '0')\n  const ms = date.getMilliseconds().toString().padStart(3, '0')\n  return `${hours}:${minutes}:${seconds}.${ms}`\n}\n\n/**\n * 格式化时间差\n *\n * @param startTime - 开始时间\n * @param endTime - 结束时间\n * @returns 格式化的时间差字符串\n */\nfunction formatDuration(startTime: number, endTime: number): string {\n  const duration = endTime - startTime\n  if (duration < 1) {\n    return '< 1ms'\n  }\n  return `${duration.toFixed(2)}ms`\n}\n\n/**\n * 安全克隆状态（防止日志中的对象被修改）\n *\n * @param state - 状态对象\n * @returns 克隆后的状态\n */\nfunction safeCloneState<S extends StateTree>(state: S): S {\n  try {\n    return deepClone(state)\n  }\n  catch {\n    // 如果克隆失败，返回浅拷贝\n    return { ...state }\n  }\n}\n\n/**\n * 创建日志中间件\n *\n * 提供完整的状态变化和 Action 调用日志记录，支持时间戳、分组和性能计时\n *\n * @param options - 日志选项\n * @returns 日志中间件\n *\n * @example\n * ```typescript\n * const logger = createLoggerMiddleware({\n *   logState: true,\n *   collapsed: true,\n *   timestamp: true,\n *   filter: (context) => context.storeId !== 'internal'\n * })\n *\n * middlewareManager.use(logger)\n * ```\n */\nexport function createLoggerMiddleware(\n  options: LoggerMiddlewareOptions = {},\n): Middleware {\n  const opts = { ...defaultOptions, ...options }\n  const logger = opts.logger ?? console\n\n  return {\n    name: 'logger',\n    priority: 0, // 最先执行，确保能记录所有操作\n\n    handler: async (context: MiddlewareContext, next: () => void | Promise<void>) => {\n      const { storeId, type, state, payload } = context\n\n      // 应用自定义过滤器\n      if (opts.filter && !opts.filter(context)) {\n        await next()\n        return\n      }\n\n      // 判断是否需要记录\n      const isStateChange = type.startsWith('state:')\n      const isAction = type.startsWith('action:')\n\n      if ((isStateChange && !opts.logState) || (isAction && !opts.logAction)) {\n        await next()\n        return\n      }\n\n      const timestamp = opts.timestamp ? formatTime(new Date()) : ''\n      const prefix = `[Store: ${storeId}]`\n      const startTime = performance.now()\n\n      // 保存操作前的状态\n      const prevState = safeCloneState(state)\n\n      // 开始分组\n      const groupTitle = timestamp ? `${timestamp} ${prefix} ${type}` : `${prefix} ${type}`\n\n      const startGroup = (): void => {\n        if (opts.collapsed && typeof logger.groupCollapsed === 'function') {\n          logger.groupCollapsed(`%c${groupTitle}`, LOG_COLORS.title)\n        }\n        else if (typeof logger.group === 'function') {\n          logger.group(`%c${groupTitle}`, LOG_COLORS.title)\n        }\n      }\n\n      const endGroup = (): void => {\n        if (typeof logger.groupEnd === 'function') {\n          logger.groupEnd()\n        }\n      }\n\n      startGroup()\n\n      try {\n        // 记录操作前的状态\n        const logFn = logger[opts.level ?? 'log'] ?? logger.log\n\n        if (typeof logFn === 'function') {\n          logFn.call(logger, '%c prev state', LOG_COLORS.prevState, prevState)\n\n          if (payload !== undefined) {\n            logFn.call(logger, '%c payload', LOG_COLORS.action, payload)\n          }\n        }\n\n        // 执行下一个中间件\n        await next()\n\n        const endTime = performance.now()\n\n        // 记录操作后的状态\n        if (typeof logFn === 'function') {\n          logFn.call(logger, '%c next state', LOG_COLORS.nextState, safeCloneState(context.state))\n          logFn.call(logger, '%c duration', LOG_COLORS.duration, formatDuration(startTime, endTime))\n        }\n      }\n      catch (error) {\n        // 记录错误\n        if (typeof logger.error === 'function') {\n          logger.error('%c error', LOG_COLORS.error, error)\n        }\n\n        // 包装并重新抛出错误\n        throw new MiddlewareError(\n          `日志中间件执行错误: ${error instanceof Error ? error.message : String(error)}`,\n          'logger',\n          error instanceof Error ? error : undefined,\n        )\n      }\n      finally {\n        endGroup()\n      }\n    },\n  }\n}\n\n/**\n * 简单日志中间件（不使用分组，适合生产环境）\n *\n * @param options - 配置选项\n * @param options.includePayload - 是否输出 payload\n * @param options.format - 自定义日志格式化函数\n * @param options.filter - 日志过滤器\n * @returns 简单日志中间件\n *\n * @example\n * ```typescript\n * const logger = createSimpleLoggerMiddleware({\n *   includePayload: true,\n *   format: (ctx) => `${ctx.storeId}: ${ctx.type}`\n * })\n * ```\n */\nexport function createSimpleLoggerMiddleware(options: {\n  /** 是否包含 payload */\n  includePayload?: boolean\n  /** 自定义格式化函数 */\n  format?: (context: MiddlewareContext) => string\n  /** 过滤器 */\n  filter?: (context: MiddlewareContext) => boolean\n} = {}): Middleware {\n  const { includePayload = true, format, filter } = options\n\n  return {\n    name: 'simple-logger',\n    priority: 0,\n\n    handler: async (context: MiddlewareContext, next: () => void | Promise<void>) => {\n      const { storeId, type, payload } = context\n\n      // 应用过滤器\n      if (filter && !filter(context)) {\n        await next()\n        return\n      }\n\n      // 使用自定义格式化或默认格式\n      const message = format\n        ? format(context)\n        : `[Store: ${storeId}] ${type}`\n\n      if (includePayload && payload !== undefined) {\n        console.info(message, payload)\n      }\n      else {\n        console.info(message)\n      }\n\n      await next()\n    },\n  }\n}\n\n/**\n * 创建生产环境日志中间件\n *\n * 只记录错误和警告，不记录正常状态变化\n *\n * @param options - 配置选项\n * @param options.onError - 自定义错误处理器\n * @returns 生产环境日志中间件\n */\nexport function createProductionLoggerMiddleware(options: {\n  /** 自定义错误处理器 */\n  onError?: (error: Error, context: MiddlewareContext) => void\n} = {}): Middleware {\n  const { onError } = options\n\n  return {\n    name: 'production-logger',\n    priority: 0,\n\n    handler: async (context: MiddlewareContext, next: () => void | Promise<void>) => {\n      try {\n        await next()\n      }\n      catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error))\n\n        if (onError) {\n          onError(err, context)\n        }\n        else {\n          console.error(`[Store Error] ${context.storeId}:`, err)\n        }\n\n        throw error\n      }\n    },\n  }\n}\n\n"],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+/**
+ * 中间件管理器
+ *
+ * @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/es/middleware/middleware-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-manager.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAiC,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAoH3D;AAOD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,iBAAiB,CAK9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAE3E"}

package/es/middleware/middleware-manager.js

@@ -0,0 +1,79 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+//#region src/middleware/middleware-manager.ts
+function createMiddlewareManager() {
+	const middlewares = /* @__PURE__ */ new Map();
+	let sortedMiddlewares = null;
+	const getSortedMiddlewares = () => {
+		if (sortedMiddlewares === null) sortedMiddlewares = Array.from(middlewares.values()).sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+		return sortedMiddlewares;
+	};
+	const invalidateCache = () => {
+		sortedMiddlewares = null;
+	};
+	const use = (middleware) => {
+		if (middlewares.has(middleware.name)) console.warn(`[Middleware] \u4E2D\u95F4\u4EF6 "${middleware.name}" \u5DF2\u5B58\u5728\uFF0C\u5C06\u88AB\u8986\u76D6`);
+		middlewares.set(middleware.name, middleware);
+		invalidateCache();
+	};
+	const remove = (name) => {
+		if (middlewares.delete(name)) invalidateCache();
+	};
+	const get = (name) => {
+		return middlewares.get(name);
+	};
+	const has = (name) => {
+		return middlewares.has(name);
+	};
+	const execute = async (context) => {
+		const sorted = getSortedMiddlewares();
+		if (sorted.length === 0) return;
+		const dispatch = async (index) => {
+			const middleware = sorted[index];
+			if (!middleware) return;
+			let called = false;
+			const next = async () => {
+				if (called) throw new Error(`[Middleware] next() called multiple times in "${middleware.name}"`);
+				called = true;
+				await dispatch(index + 1);
+			};
+			await middleware.handler(context, next);
+		};
+		await dispatch(0);
+	};
+	const getAll = () => {
+		return getSortedMiddlewares();
+	};
+	const clear = () => {
+		middlewares.clear();
+		invalidateCache();
+	};
+	return {
+		use,
+		remove,
+		get,
+		has,
+		execute,
+		getAll,
+		clear
+	};
+}
+let globalMiddlewareManager = null;
+function getGlobalMiddlewareManager() {
+	if (!globalMiddlewareManager) globalMiddlewareManager = createMiddlewareManager();
+	return globalMiddlewareManager;
+}
+function setGlobalMiddlewareManager(manager) {
+	globalMiddlewareManager = manager;
+}
+//#endregion
+export { createMiddlewareManager, getGlobalMiddlewareManager, setGlobalMiddlewareManager };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=middleware-manager.js.map

package/es/middleware/middleware-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-manager.js","names":[],"sources":["../../src/middleware/middleware-manager.ts"],"sourcesContent":["/**\n * 中间件管理器\n *\n * @module middleware/middleware-manager\n */\n\nimport type { Middleware, MiddlewareContext, MiddlewareManager } from '../types'\n\n/**\n * 创建中间件管理器\n *\n * @returns 中间件管理器实例\n *\n * @example\n * ```typescript\n * const manager = createMiddlewareManager()\n *\n * // 添加日志中间件\n * manager.use({\n *   name: 'logger',\n *   priority: 1,\n *   handler: async (ctx, next) => {\n *     console.log('Before:', ctx.type)\n *     await next()\n *     console.log('After:', ctx.type)\n *   }\n * })\n *\n * // 执行中间件链\n * await manager.execute({ storeId: 'test', state: {}, type: 'state:patch' })\n * ```\n */\nexport function createMiddlewareManager(): MiddlewareManager {\n  /** 中间件列表 */\n  const middlewares = new Map<string, Middleware>()\n\n  /** 已排序的中间件列表缓存 */\n  let sortedMiddlewares: Middleware[] | null = null\n\n  /**\n   * 获取排序后的中间件列表\n   */\n  const getSortedMiddlewares = (): Middleware[] => {\n    if (sortedMiddlewares === null) {\n      sortedMiddlewares = Array.from(middlewares.values()).sort(\n        (a, b) => (a.priority ?? 100) - (b.priority ?? 100),\n      )\n    }\n    return sortedMiddlewares\n  }\n\n  /**\n   * 使中间件缓存失效\n   */\n  const invalidateCache = (): void => {\n    sortedMiddlewares = null\n  }\n\n  /**\n   * 添加中间件\n   */\n  const use = (middleware: Middleware): void => {\n    if (middlewares.has(middleware.name)) {\n      console.warn(`[Middleware] 中间件 \"${middleware.name}\" 已存在，将被覆盖`)\n    }\n    middlewares.set(middleware.name, middleware)\n    invalidateCache()\n  }\n\n  /**\n   * 移除中间件\n   */\n  const remove = (name: string): void => {\n    if (middlewares.delete(name)) {\n      invalidateCache()\n    }\n  }\n\n  /**\n   * 获取中间件\n   */\n  const get = (name: string): Middleware | undefined => {\n    return middlewares.get(name)\n  }\n\n  /**\n   * 是否存在中间件\n   */\n  const has = (name: string): boolean => {\n    return middlewares.has(name)\n  }\n\n  /**\n   * 执行中间件链\n   */\n  const execute = async (context: MiddlewareContext): Promise<void> => {\n    const sorted = getSortedMiddlewares()\n\n    if (sorted.length === 0) {\n      return\n    }\n\n    const dispatch = async (index: number): Promise<void> => {\n      const middleware = sorted[index]\n      if (!middleware) {\n        return\n      }\n\n      let called = false\n      const next = async (): Promise<void> => {\n        if (called) {\n          throw new Error(`[Middleware] next() called multiple times in \"${middleware.name}\"`)\n        }\n\n        called = true\n        await dispatch(index + 1)\n      }\n\n      await middleware.handler(context, next)\n    }\n\n    await dispatch(0)\n  }\n\n  /**\n   * 获取所有中间件\n   */\n  const getAll = (): Middleware[] => {\n    return getSortedMiddlewares()\n  }\n\n  /**\n   * 清空所有中间件\n   */\n  const clear = (): void => {\n    middlewares.clear()\n    invalidateCache()\n  }\n\n  return {\n    use,\n    remove,\n    get,\n    has,\n    execute,\n    getAll,\n    clear,\n  }\n}\n\n/**\n * 全局中间件管理器\n */\nlet globalMiddlewareManager: MiddlewareManager | null = null\n\n/**\n * 获取全局中间件管理器\n */\nexport function getGlobalMiddlewareManager(): MiddlewareManager {\n  if (!globalMiddlewareManager) {\n    globalMiddlewareManager = createMiddlewareManager()\n  }\n  return globalMiddlewareManager\n}\n\n/**\n * 设置全局中间件管理器\n */\nexport function setGlobalMiddlewareManager(manager: MiddlewareManager): void {\n  globalMiddlewareManager = manager\n}\n\n"],"mappings":";;;;;;;;;;AAgCO,SAAS,0BAA6C;CAE3D,MAAM,8BAAc,IAAI,IAAwB;CAGhD,IAAI,oBAAyC;CAK7C,MAAM,6BAA2C;EAC/C,IAAI,sBAAsB,MACxB,oBAAoB,MAAM,KAAK,YAAY,OAAO,CAAC,CAAA,CAAE,MAClD,GAAG,OAAO,EAAE,YAAY,QAAQ,EAAE,YAAY,IACjD;EAEF,OAAO;CACT;CAKA,MAAM,wBAA8B;EAClC,oBAAoB;CACtB;CAKA,MAAM,OAAO,eAAiC;EAC5C,IAAI,YAAY,IAAI,WAAW,IAAI,GACjC,QAAQ,KAAK,oCAAqB,WAAW,KAAI,mDAAY;EAE/D,YAAY,IAAI,WAAW,MAAM,UAAU;EAC3C,gBAAgB;CAClB;CAKA,MAAM,UAAU,SAAuB;EACrC,IAAI,YAAY,OAAO,IAAI,GACzB,gBAAgB;CAEpB;CAKA,MAAM,OAAO,SAAyC;EACpD,OAAO,YAAY,IAAI,IAAI;CAC7B;CAKA,MAAM,OAAO,SAA0B;EACrC,OAAO,YAAY,IAAI,IAAI;CAC7B;CAKA,MAAM,UAAU,OAAO,YAA8C;EACnE,MAAM,SAAS,qBAAqB;EAEpC,IAAI,OAAO,WAAW,GACpB;EAGF,MAAM,WAAW,OAAO,UAAiC;GACvD,MAAM,aAAa,OAAO;GAC1B,IAAI,CAAC,YACH;GAGF,IAAI,SAAS;GACb,MAAM,OAAO,YAA2B;IACtC,IAAI,QACF,MAAM,IAAI,MAAM,iDAAiD,WAAW,KAAI,EAAG;IAGrF,SAAS;IACT,MAAM,SAAS,QAAQ,CAAC;GAC1B;GAEA,MAAM,WAAW,QAAQ,SAAS,IAAI;EACxC;EAEA,MAAM,SAAS,CAAC;CAClB;CAKA,MAAM,eAA6B;EACjC,OAAO,qBAAqB;CAC9B;CAKA,MAAM,cAAoB;EACxB,YAAY,MAAM;EAClB,gBAAgB;CAClB;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;AAKA,IAAI,0BAAoD;AAKjD,SAAS,6BAAgD;CAC9D,IAAI,CAAC,yBACH,0BAA0B,wBAAwB;CAEpD,OAAO;AACT;AAKO,SAAS,2BAA2B,SAAkC;CAC3E,0BAA0B;AAC5B"}

package/es/middleware/persist.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 持久化中间件
+ *
+ * 提供状态持久化功能
+ * @module middleware/persist
+ */
+import type { Middleware, PersistMiddlewareOptions, StateTree, StoreId } from '../types';
+/**
+ * 创建持久化中间件
+ *
+ * @param options - 持久化选项
+ * @returns 持久化中间件
+ *
+ * @example
+ * ```typescript
+ * const persist = createPersistMiddleware({
+ *   storage: 'localStorage',
+ *   stores: ['user', 'settings'],
+ *   debounce: 200,
+ * })
+ *
+ * middlewareManager.use(persist)
+ * ```
+ */
+export declare function createPersistMiddleware(options?: PersistMiddlewareOptions): Middleware;
+/**
+ * 从存储恢复状态
+ *
+ * @param storeId - Store ID
+ * @param options - 持久化选项
+ * @returns 恢复的状态或 null
+ */
+export declare function restoreState<S extends StateTree>(storeId: StoreId, options?: PersistMiddlewareOptions): S | null;
+//# sourceMappingURL=persist.d.ts.map

package/es/middleware/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/middleware/persist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqB,wBAAwB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAgC3G;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,UAAU,CAgGZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAC9C,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,wBAA6B,GACrC,CAAC,GAAG,IAAI,CAkBV"}

package/es/middleware/persist.js

@@ -0,0 +1,102 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { debounce } from "../utils/debounce-throttle.js";
+//#region src/middleware/persist.ts
+const defaultOptions = {
+	keyPrefix: "ldesign-store:",
+	storage: "localStorage",
+	debounce: 100,
+	serialize: JSON.stringify,
+	deserialize: JSON.parse
+};
+function resolveOptions(options) {
+	return {
+		...defaultOptions,
+		...options
+	};
+}
+function getStorage(type) {
+	if (typeof window === "undefined") return null;
+	return type === "localStorage" ? localStorage : sessionStorage;
+}
+function createPersistMiddleware(options = {}) {
+	const opts = resolveOptions(options);
+	const storage = getStorage(opts.storage);
+	const debouncedSave = /* @__PURE__ */ new Map();
+	const getKey = (storeId) => {
+		return `${opts.keyPrefix}${storeId}`;
+	};
+	const filterState = (storeId, state) => {
+		const paths = opts.paths?.[storeId];
+		if (!paths || paths.length === 0) return state;
+		const filtered = {};
+		for (const path of paths) {
+			const keys = path.split(".");
+			let source = state;
+			let target = filtered;
+			for (let i = 0; i < keys.length; i++) {
+				const key = keys[i];
+				if (i === keys.length - 1) target[key] = source?.[key];
+				else {
+					target[key] = target[key] || {};
+					target = target[key];
+					source = source?.[key];
+				}
+			}
+		}
+		return filtered;
+	};
+	const saveState = (storeId, state) => {
+		if (!storage) return;
+		try {
+			const filteredState = filterState(storeId, state);
+			const serialized = opts.serialize(filteredState);
+			storage.setItem(getKey(storeId), serialized);
+		} catch (error) {
+			console.error(`[Persist] \u4FDD\u5B58\u72B6\u6001\u5931\u8D25 (${storeId}):`, error);
+		}
+	};
+	const getDebouncedSave = (storeId) => {
+		let fn = debouncedSave.get(storeId);
+		if (!fn) {
+			fn = debounce((state) => saveState(storeId, state), opts.debounce);
+			debouncedSave.set(storeId, fn);
+		}
+		return fn;
+	};
+	return {
+		name: "persist",
+		priority: 100,
+		handler: async (context, next) => {
+			await next();
+			const { storeId, type, state } = context;
+			if (!type.startsWith("state:")) return;
+			if (opts.stores && !opts.stores.includes(storeId)) return;
+			getDebouncedSave(storeId)(state);
+		}
+	};
+}
+function restoreState(storeId, options = {}) {
+	const opts = resolveOptions(options);
+	const storage = getStorage(opts.storage);
+	if (!storage) return null;
+	try {
+		const key = `${opts.keyPrefix}${storeId}`;
+		const data = storage.getItem(key);
+		if (data) return opts.deserialize(data);
+	} catch (error) {
+		console.error(`[Persist] \u6062\u590D\u72B6\u6001\u5931\u8D25 (${storeId}):`, error);
+	}
+	return null;
+}
+//#endregion
+export { createPersistMiddleware, restoreState };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=persist.js.map

package/es/middleware/persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","names":[],"sources":["../../src/middleware/persist.ts"],"sourcesContent":["/**\n * 持久化中间件\n *\n * 提供状态持久化功能\n * @module middleware/persist\n */\n\nimport type { Middleware, MiddlewareContext, PersistMiddlewareOptions, StateTree, StoreId } from '../types'\nimport { debounce } from '../utils/debounce-throttle'\n\ntype ResolvedPersistMiddlewareOptions = Required<\n  Pick<PersistMiddlewareOptions, 'debounce' | 'deserialize' | 'keyPrefix' | 'serialize' | 'storage'>\n> & Omit<PersistMiddlewareOptions, 'debounce' | 'deserialize' | 'keyPrefix' | 'serialize' | 'storage'>\n\n/**\n * 默认持久化选项\n */\nconst defaultOptions: ResolvedPersistMiddlewareOptions = {\n  keyPrefix: 'ldesign-store:',\n  storage: 'localStorage',\n  debounce: 100,\n  serialize: JSON.stringify,\n  deserialize: JSON.parse,\n}\n\nfunction resolveOptions(options: PersistMiddlewareOptions): ResolvedPersistMiddlewareOptions {\n  return { ...defaultOptions, ...options }\n}\n\n/**\n * 获取存储对象\n */\nfunction getStorage(type: 'localStorage' | 'sessionStorage'): Storage | null {\n  if (typeof window === 'undefined') {\n    return null\n  }\n  return type === 'localStorage' ? localStorage : sessionStorage\n}\n\n/**\n * 创建持久化中间件\n *\n * @param options - 持久化选项\n * @returns 持久化中间件\n *\n * @example\n * ```typescript\n * const persist = createPersistMiddleware({\n *   storage: 'localStorage',\n *   stores: ['user', 'settings'],\n *   debounce: 200,\n * })\n *\n * middlewareManager.use(persist)\n * ```\n */\nexport function createPersistMiddleware(\n  options: PersistMiddlewareOptions = {},\n): Middleware {\n  const opts = resolveOptions(options)\n  const storage = getStorage(opts.storage)\n\n  /** 保存状态的防抖函数映射 */\n  const debouncedSave = new Map<StoreId, (state: StateTree) => void>()\n\n  /**\n   * 获取存储键名\n   */\n  const getKey = (storeId: StoreId): string => {\n    return `${opts.keyPrefix}${storeId}`\n  }\n\n  /**\n   * 筛选需要持久化的状态路径\n   */\n  const filterState = (storeId: StoreId, state: StateTree): StateTree => {\n    const paths = opts.paths?.[storeId]\n    if (!paths || paths.length === 0) {\n      return state\n    }\n\n    const filtered: StateTree = {}\n    for (const path of paths) {\n      const keys = path.split('.')\n      let source: unknown = state\n      let target: StateTree = filtered\n\n      for (let i = 0; i < keys.length; i++) {\n        const key = keys[i]\n        if (i === keys.length - 1) {\n          target[key] = (source as StateTree)?.[key]\n        }\n        else {\n          target[key] = target[key] || {}\n          target = target[key] as StateTree\n          source = (source as StateTree)?.[key]\n        }\n      }\n    }\n\n    return filtered\n  }\n\n  /**\n   * 保存状态到存储\n   */\n  const saveState = (storeId: StoreId, state: StateTree): void => {\n    if (!storage) return\n\n    try {\n      const filteredState = filterState(storeId, state)\n      const serialized = opts.serialize(filteredState)\n      storage.setItem(getKey(storeId), serialized)\n    }\n    catch (error) {\n      console.error(`[Persist] 保存状态失败 (${storeId}):`, error)\n    }\n  }\n\n  /**\n   * 获取或创建防抖保存函数\n   */\n  const getDebouncedSave = (storeId: StoreId): (state: StateTree) => void => {\n    let fn = debouncedSave.get(storeId)\n    if (!fn) {\n      fn = debounce((state: StateTree) => saveState(storeId, state), opts.debounce)\n      debouncedSave.set(storeId, fn)\n    }\n    return fn\n  }\n\n  return {\n    name: 'persist',\n    priority: 100, // 最后执行\n\n    handler: async (context: MiddlewareContext, next: () => void | Promise<void>) => {\n      await next()\n\n      const { storeId, type, state } = context\n\n      // 只在状态变化时持久化\n      if (!type.startsWith('state:')) {\n        return\n      }\n\n      // 检查是否需要持久化此 Store\n      if (opts.stores && !opts.stores.includes(storeId)) {\n        return\n      }\n\n      // 使用防抖保存\n      getDebouncedSave(storeId)(state)\n    },\n  }\n}\n\n/**\n * 从存储恢复状态\n *\n * @param storeId - Store ID\n * @param options - 持久化选项\n * @returns 恢复的状态或 null\n */\nexport function restoreState<S extends StateTree>(\n  storeId: StoreId,\n  options: PersistMiddlewareOptions = {},\n): S | null {\n  const opts = resolveOptions(options)\n  const storage = getStorage(opts.storage)\n\n  if (!storage) return null\n\n  try {\n    const key = `${opts.keyPrefix}${storeId}`\n    const data = storage.getItem(key)\n    if (data) {\n      return opts.deserialize(data) as S\n    }\n  }\n  catch (error) {\n    console.error(`[Persist] 恢复状态失败 (${storeId}):`, error)\n  }\n\n  return null\n}\n\n"],"mappings":";;;;;;;;;;;AAiBA,MAAM,iBAAmD;CACvD,WAAW;CACX,SAAS;CACT,UAAU;CACV,WAAW,KAAK;CAChB,aAAa,KAAK;AACpB;AAEA,SAAS,eAAe,SAAqE;CAC3F,OAAO;EAAE,GAAG;EAAgB,GAAG;CAAQ;AACzC;AAKA,SAAS,WAAW,MAAyD;CAC3E,IAAI,OAAO,WAAW,aACpB,OAAO;CAET,OAAO,SAAS,iBAAiB,eAAe;AAClD;AAmBO,SAAS,wBACd,UAAoC,CAAC,GACzB;CACZ,MAAM,OAAO,eAAe,OAAO;CACnC,MAAM,UAAU,WAAW,KAAK,OAAO;CAGvC,MAAM,gCAAgB,IAAI,IAAyC;CAKnE,MAAM,UAAU,YAA6B;EAC3C,OAAO,GAAG,KAAK,YAAY;CAC7B;CAKA,MAAM,eAAe,SAAkB,UAAgC;EACrE,MAAM,QAAQ,KAAK,QAAQ;EAC3B,IAAI,CAAC,SAAS,MAAM,WAAW,GAC7B,OAAO;EAGT,MAAM,WAAsB,CAAC;EAC7B,KAAA,MAAW,QAAQ,OAAO;GACxB,MAAM,OAAO,KAAK,MAAM,GAAG;GAC3B,IAAI,SAAkB;GACtB,IAAI,SAAoB;GAExB,KAAA,IAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;IACpC,MAAM,MAAM,KAAK;IACjB,IAAI,MAAM,KAAK,SAAS,GACtB,OAAO,OAAQ,SAAuB;SAEnC;KACH,OAAO,OAAO,OAAO,QAAQ,CAAC;KAC9B,SAAS,OAAO;KAChB,SAAU,SAAuB;IACnC;GACF;EACF;EAEA,OAAO;CACT;CAKA,MAAM,aAAa,SAAkB,UAA2B;EAC9D,IAAI,CAAC,SAAS;EAEd,IAAI;GACF,MAAM,gBAAgB,YAAY,SAAS,KAAK;GAChD,MAAM,aAAa,KAAK,UAAU,aAAa;GAC/C,QAAQ,QAAQ,OAAO,OAAO,GAAG,UAAU;EAC7C,SACO,OAAO;GACZ,QAAQ,MAAM,mDAAqB,QAAO,KAAM,KAAK;EACvD;CACF;CAKA,MAAM,oBAAoB,YAAiD;EACzE,IAAI,KAAK,cAAc,IAAI,OAAO;EAClC,IAAI,CAAC,IAAI;GACP,KAAK,UAAU,UAAqB,UAAU,SAAS,KAAK,GAAG,KAAK,QAAQ;GAC5E,cAAc,IAAI,SAAS,EAAE;EAC/B;EACA,OAAO;CACT;CAEA,OAAO;EACL,MAAM;EACN,UAAU;EAEV,SAAS,OAAO,SAA4B,SAAqC;GAC/E,MAAM,KAAK;GAEX,MAAM,EAAE,SAAS,MAAM,UAAU;GAGjC,IAAI,CAAC,KAAK,WAAW,QAAQ,GAC3B;GAIF,IAAI,KAAK,UAAU,CAAC,KAAK,OAAO,SAAS,OAAO,GAC9C;GAIF,iBAAiB,OAAO,CAAA,CAAE,KAAK;EACjC;CACF;AACF;AASO,SAAS,aACd,SACA,UAAoC,CAAC,GAC3B;CACV,MAAM,OAAO,eAAe,OAAO;CACnC,MAAM,UAAU,WAAW,KAAK,OAAO;CAEvC,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI;EACF,MAAM,MAAM,GAAG,KAAK,YAAY;EAChC,MAAM,OAAO,QAAQ,QAAQ,GAAG;EAChC,IAAI,MACF,OAAO,KAAK,YAAY,IAAI;CAEhC,SACO,OAAO;EACZ,QAAQ,MAAM,mDAAqB,QAAO,KAAM,KAAK;CACvD;CAEA,OAAO;AACT"}

package/es/middleware/time-travel.d.ts

@@ -0,0 +1,30 @@
+import type { Middleware, // 状态快照接口
+StateTree, // 状态树类型
+StoreId, // Store 标识类型
+TimeTravelController, // 时间旅行控制器接口
+TimeTravelMiddlewareOptions } from '../types';
+/**
+ * 创建时间旅行中间件
+ *
+ * 返回一个中间件函数和一个控制器对象：
+ * - 中间件负责拦截 state: 类型的操作，在操作前后记录状态快照
+ * - 控制器提供 undo/redo/goto/clear 等方法，用于在历史快照之间跳转
+ *
+ * @param options - 中间件配置选项（可选，与默认值合并）
+ * @returns 包含 middleware（中间件）和 controller（控制器）的对象
+ */
+export declare function createTimeTravelMiddleware(options?: TimeTravelMiddlewareOptions): {
+    middleware: Middleware;
+    controller: TimeTravelController;
+};
+/**
+ * 外部设置恢复回调的辅助函数
+ * 将外部提供的状态恢复函数注入到时间旅行控制器中
+ *
+ * 使用场景：Store 运行时初始化时调用此函数，将控制器与 Store 的状态恢复逻辑连接
+ *
+ * @param controller - 时间旅行控制器实例
+ * @param callback - 恢复回调函数，接收 storeId 和已深拷贝的状态树
+ */
+export declare function setRestoreCallback(controller: TimeTravelController, callback: (storeId: StoreId, state: StateTree) => void): void;
+//# sourceMappingURL=time-travel.d.ts.map

package/es/middleware/time-travel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-travel.d.ts","sourceRoot":"","sources":["../../src/middleware/time-travel.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,UAAU,EAEkB,SAAS;AACrC,SAAS,EAAmB,QAAQ;AACpC,OAAO,EAAqB,aAAa;AACzC,oBAAoB,EAAQ,YAAY;AACxC,2BAA2B,EAC5B,MAAM,UAAU,CAAA;AA+BjB;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC;IACD,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,oBAAoB,CAAA;CACjC,CA2NA;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,GACrD,IAAI,CAYN"}

package/es/middleware/time-travel.js

@@ -0,0 +1,151 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { deepClone } from "../utils/deep-clone.js";
+//#region src/middleware/time-travel.ts
+const defaultOptions = {
+	maxHistory: 100,
+	enabled: true
+};
+function createTimeTravelMiddleware(options = {}) {
+	const opts = {
+		...defaultOptions,
+		...options
+	};
+	const maxHistory = opts.maxHistory ?? defaultOptions.maxHistory ?? 100;
+	const history = [];
+	let currentIndex = -1;
+	let isTraveling = false;
+	let restoreCallback = () => {};
+	const addSnapshot = (snapshot) => {
+		if (!opts.enabled || isTraveling) return;
+		if (currentIndex < history.length - 1) history.splice(currentIndex + 1);
+		history.push(snapshot);
+		currentIndex = history.length - 1;
+		if (history.length > maxHistory) {
+			history.shift();
+			currentIndex--;
+		}
+	};
+	const controller = {
+		/**
+		* 撤销操作
+		* 将当前指针前移一步，恢复到上一个历史快照状态
+		*/
+		undo: () => {
+			if (!controller.canUndo()) return;
+			isTraveling = true;
+			currentIndex--;
+			const snapshot = history[currentIndex];
+			restoreCallback(snapshot.storeId, deepClone(snapshot.state));
+			isTraveling = false;
+		},
+		/**
+		* 重做操作
+		* 将当前指针后移一步，恢复到下一个历史快照状态
+		*/
+		redo: () => {
+			if (!controller.canRedo()) return;
+			isTraveling = true;
+			currentIndex++;
+			const snapshot = history[currentIndex];
+			restoreCallback(snapshot.storeId, deepClone(snapshot.state));
+			isTraveling = false;
+		},
+		/**
+		* 跳转到指定历史索引
+		* 将当前指针直接移动到指定位置，恢复对应的快照状态
+		*
+		* @param index - 目标历史索引（0-based）
+		*/
+		goto: (index) => {
+			if (index < 0 || index >= history.length) return;
+			isTraveling = true;
+			currentIndex = index;
+			const snapshot = history[currentIndex];
+			restoreCallback(snapshot.storeId, deepClone(snapshot.state));
+			isTraveling = false;
+		},
+		/**
+		* 获取完整的快照历史（返回深拷贝，防止外部修改内部历史记录）
+		* @returns 历史快照数组的深拷贝
+		*/
+		getHistory: () => deepClone(history),
+		/**
+		* 获取当前快照指针索引
+		* @returns 当前索引值，-1 表示无快照
+		*/
+		getCurrentIndex: () => currentIndex,
+		/**
+		* 判断是否可以撤销
+		* 当前索引大于 0 时，说明前面还有历史快照
+		* @returns 是否可以执行 undo 操作
+		*/
+		canUndo: () => currentIndex > 0,
+		/**
+		* 判断是否可以重做
+		* 当前索引小于历史长度 - 1 时，说明后面还有快照
+		* @returns 是否可以执行 redo 操作
+		*/
+		canRedo: () => currentIndex < history.length - 1,
+		/**
+		* 清除所有历史快照并重置指针
+		* 通常在 Store 销毁或需要重置历史时调用
+		*/
+		clear: () => {
+			history.length = 0;
+			currentIndex = -1;
+		}
+	};
+	controller.__setRestoreCallback = (callback) => {
+		restoreCallback = callback;
+	};
+	return {
+		middleware: {
+			name: "time-travel",
+			priority: 50,
+			/**
+			* 中间件处理函数
+			* 只拦截 "state:" 类型的操作（状态变更操作），其他类型直接放行
+			* 正在时间旅行时也不记录快照，避免循环
+			*
+			* @param context - 中间件上下文，包含 storeId、操作类型、状态等信息
+			* @param next - 调用下一个中间件或最终操作的函数
+			*/
+			handler: async (context, next) => {
+				const { storeId, type, state } = context;
+				if (!type.startsWith("state:") || isTraveling) {
+					await next();
+					return;
+				}
+				const snapshot = {
+					timestamp: Date.now(),
+					state: deepClone(state),
+					type,
+					storeId
+				};
+				await next();
+				addSnapshot(snapshot);
+			}
+		},
+		controller
+	};
+}
+function setRestoreCallback(controller, callback) {
+	const controllerWithSetter = controller;
+	if (typeof controllerWithSetter.__setRestoreCallback === "function") {
+		controllerWithSetter.__setRestoreCallback(callback);
+		return;
+	}
+	console.warn("[TimeTravel] 请使用 createTimeTravelMiddleware 返回的 controller");
+}
+//#endregion
+export { createTimeTravelMiddleware, setRestoreCallback };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=time-travel.js.map