@composy/store-core 0.0.1

package/es/errors/index.d.ts

@@ -0,0 +1,208 @@
+/**
+ * 自定义错误类
+ *
+ * 提供统一的错误处理模式
+ * @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/es/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/es/errors/index.js

@@ -0,0 +1,217 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+//#region src/errors/index.ts
+var StoreErrorCode = /* @__PURE__ */ ((StoreErrorCode2) => {
+	StoreErrorCode2["STORE_DISPOSED"] = "STORE_DISPOSED";
+	StoreErrorCode2["STORE_NOT_FOUND"] = "STORE_NOT_FOUND";
+	StoreErrorCode2["STORE_ALREADY_EXISTS"] = "STORE_ALREADY_EXISTS";
+	StoreErrorCode2["INVALID_STATE"] = "INVALID_STATE";
+	StoreErrorCode2["INVALID_ACTION"] = "INVALID_ACTION";
+	StoreErrorCode2["SERIALIZATION_ERROR"] = "SERIALIZATION_ERROR";
+	StoreErrorCode2["DESERIALIZATION_ERROR"] = "DESERIALIZATION_ERROR";
+	StoreErrorCode2["STORAGE_ERROR"] = "STORAGE_ERROR";
+	StoreErrorCode2["PLUGIN_ERROR"] = "PLUGIN_ERROR";
+	StoreErrorCode2["MIDDLEWARE_ERROR"] = "MIDDLEWARE_ERROR";
+	StoreErrorCode2["SUBSCRIPTION_ERROR"] = "SUBSCRIPTION_ERROR";
+	StoreErrorCode2["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+	StoreErrorCode2["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+	return StoreErrorCode2;
+})(StoreErrorCode || {});
+var ErrorSeverity = /* @__PURE__ */ ((ErrorSeverity2) => {
+	ErrorSeverity2["WARNING"] = "warning";
+	ErrorSeverity2["ERROR"] = "error";
+	ErrorSeverity2["FATAL"] = "fatal";
+	return ErrorSeverity2;
+})(ErrorSeverity || {});
+var StoreError = class StoreError extends Error {
+	/**
+	* 创建 Store 错误
+	*
+	* @param message - 错误消息
+	* @param code - 错误代码
+	* @param context - 错误上下文
+	* @param severity - 错误严重级别
+	* @param cause - 原始错误
+	*/
+	constructor(message, code = "UNKNOWN_ERROR", context = {}, severity = "error", cause) {
+		super(message);
+		this.name = "StoreError";
+		this.code = code;
+		this.context = {
+			...context,
+			timestamp: context.timestamp ?? Date.now()
+		};
+		this.severity = severity;
+		this.cause = cause;
+		Object.setPrototypeOf(this, StoreError.prototype);
+		if (Error.captureStackTrace) Error.captureStackTrace(this, StoreError);
+	}
+	/**
+	* 转换为 JSON
+	*/
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message,
+			code: this.code,
+			context: this.context,
+			severity: this.severity,
+			stack: this.stack
+		};
+	}
+	/**
+	* 格式化错误信息
+	*/
+	format() {
+		const parts = [`[${this.code}] ${this.message}`];
+		if (this.context.storeId) parts.push(`Store: ${this.context.storeId}`);
+		if (this.context.action) parts.push(`Action: ${this.context.action}`);
+		return parts.join(" | ");
+	}
+};
+var StoreDisposedError = class StoreDisposedError extends StoreError {
+	constructor(storeId, action) {
+		super(`Store "${storeId}" \u5DF2\u88AB\u9500\u6BC1\uFF0C\u65E0\u6CD5\u6267\u884C\u64CD\u4F5C${action ? `: ${action}` : ""}`, "STORE_DISPOSED", {
+			storeId,
+			action
+		}, "error");
+		this.name = "StoreDisposedError";
+		Object.setPrototypeOf(this, StoreDisposedError.prototype);
+	}
+};
+var StoreNotFoundError = class StoreNotFoundError extends StoreError {
+	constructor(storeId) {
+		super(`Store "${storeId}" \u4E0D\u5B58\u5728`, "STORE_NOT_FOUND", { storeId }, "error");
+		this.name = "StoreNotFoundError";
+		Object.setPrototypeOf(this, StoreNotFoundError.prototype);
+	}
+};
+var StoreAlreadyExistsError = class StoreAlreadyExistsError extends StoreError {
+	constructor(storeId) {
+		super(`Store "${storeId}" \u5DF2\u5B58\u5728`, "STORE_ALREADY_EXISTS", { storeId }, "warning");
+		this.name = "StoreAlreadyExistsError";
+		Object.setPrototypeOf(this, StoreAlreadyExistsError.prototype);
+	}
+};
+var InvalidStateError = class InvalidStateError extends StoreError {
+	constructor(message, storeId, data) {
+		super(message, "INVALID_STATE", {
+			storeId,
+			data
+		}, "error");
+		this.name = "InvalidStateError";
+		Object.setPrototypeOf(this, InvalidStateError.prototype);
+	}
+};
+var SerializationError = class SerializationError extends StoreError {
+	constructor(message, cause, storeId) {
+		super(message, "SERIALIZATION_ERROR", { storeId }, "error", cause);
+		this.name = "SerializationError";
+		Object.setPrototypeOf(this, SerializationError.prototype);
+	}
+};
+var DeserializationError = class DeserializationError extends StoreError {
+	constructor(message, cause, storeId) {
+		super(message, "DESERIALIZATION_ERROR", { storeId }, "error", cause);
+		this.name = "DeserializationError";
+		Object.setPrototypeOf(this, DeserializationError.prototype);
+	}
+};
+var StorageError = class StorageError extends StoreError {
+	constructor(message, cause, storeId) {
+		super(message, "STORAGE_ERROR", { storeId }, "error", cause);
+		this.name = "StorageError";
+		Object.setPrototypeOf(this, StorageError.prototype);
+	}
+};
+var PluginError = class PluginError extends StoreError {
+	constructor(message, pluginName, cause) {
+		super(message, "PLUGIN_ERROR", { plugin: pluginName }, "error", cause);
+		this.name = "PluginError";
+		Object.setPrototypeOf(this, PluginError.prototype);
+	}
+};
+var MiddlewareError = class MiddlewareError extends StoreError {
+	constructor(message, middlewareName, cause) {
+		super(message, "MIDDLEWARE_ERROR", { middleware: middlewareName }, "error", cause);
+		this.name = "MiddlewareError";
+		Object.setPrototypeOf(this, MiddlewareError.prototype);
+	}
+};
+var SubscriptionError = class SubscriptionError extends StoreError {
+	constructor(message, cause, storeId) {
+		super(message, "SUBSCRIPTION_ERROR", { storeId }, "warning", cause);
+		this.name = "SubscriptionError";
+		Object.setPrototypeOf(this, SubscriptionError.prototype);
+	}
+};
+var TimeoutError = class TimeoutError extends StoreError {
+	constructor(message, storeId, action) {
+		super(message, "TIMEOUT_ERROR", {
+			storeId,
+			action
+		}, "error");
+		this.name = "TimeoutError";
+		Object.setPrototypeOf(this, TimeoutError.prototype);
+	}
+};
+const errorUtils = {
+	/**
+	* 判断是否为 Store 错误
+	*/
+	isStoreError(error) {
+		return error instanceof StoreError;
+	},
+	/**
+	* 判断是否为特定类型的错误
+	*/
+	isErrorCode(error, code) {
+		return error instanceof StoreError && error.code === code;
+	},
+	/**
+	* 包装错误为 Store 错误
+	*/
+	wrap(error, code = "UNKNOWN_ERROR", context = {}) {
+		if (error instanceof StoreError) return error;
+		return new StoreError(error instanceof Error ? error.message : String(error), code, context, "error", error instanceof Error ? error : void 0);
+	},
+	/**
+	* 安全执行函数，捕获并包装错误
+	*/
+	async tryCatch(fn, code = "UNKNOWN_ERROR", context = {}) {
+		try {
+			return await fn();
+		} catch (error) {
+			throw errorUtils.wrap(error, code, context);
+		}
+	},
+	/**
+	* 创建错误日志记录器
+	*/
+	createLogger(prefix) {
+		return {
+			error(error) {
+				console.error(`[${prefix}]`, error.format());
+				if (error.cause) console.error(`[${prefix}] Caused by:`, error.cause);
+			},
+			warn(error) {
+				console.warn(`[${prefix}]`, error.format());
+			},
+			log(error) {
+				if (error.severity === "fatal" || error.severity === "error") this.error(error);
+				else this.warn(error);
+			}
+		};
+	}
+};
+//#endregion
+export { DeserializationError, ErrorSeverity, InvalidStateError, MiddlewareError, PluginError, SerializationError, StorageError, StoreAlreadyExistsError, StoreDisposedError, StoreError, StoreErrorCode, StoreNotFoundError, SubscriptionError, TimeoutError, errorUtils };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=index.js.map

package/es/errors/index.js.map

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

package/es/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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/es/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,qBAAqB,GACtB,MAAM,QAAQ,CAAA;AAEf,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,GACT,MAAM,QAAQ,CAAA;AAGf,cAAc,UAAU,CAAA;AAGxB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,YAAY,EACV,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,YAAY,EACZ,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,WAAW,CAAA;AAGlB,YAAY,EAEV,aAAa,EACb,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EAEZ,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,EAET,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,MAAM,EACN,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,GACZ,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,QAAQ,EACR,aAAa,EACb,SAAS,EACT,YAAY,EACZ,QAAQ,GACT,MAAM,SAAS,CAAA;AAGhB,eAAO,MAAM,OAAO,UAAU,CAAA;AAC9B,eAAO,MAAM,IAAI,wBAAwB,CAAA;AAEzC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAA"}

package/es/index.js

@@ -0,0 +1,34 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { createPubSub, createPubSubWithValue } from "./core/pub-sub.js";
+import { createAsyncAction } from "./core/async-action.js";
+import { createEventBus, globalEventBus } from "./core/event-bus.js";
+import { BaseStore } from "./core/base-store.js";
+import { batch, createBatchManager, getGlobalBatchManager, setGlobalBatchManager } from "./core/batch-manager.js";
+import { createStore } from "./core/create-store.js";
+import { createStoreEngineBridge, storeEventKeys, storeStateKeys } from "./engine/plugin.js";
+import { DeserializationError, ErrorSeverity, InvalidStateError, MiddlewareError, PluginError, SerializationError, StorageError, StoreAlreadyExistsError, StoreDisposedError, StoreError, StoreErrorCode, StoreNotFoundError, SubscriptionError, TimeoutError, errorUtils } from "./errors/index.js";
+import { debounce, throttle } from "./utils/debounce-throttle.js";
+import { deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, isObject, isPlainObject, shallowClone } from "./utils/deep-clone.js";
+import { combineSelectors, createCachedSelector, createMemoizedSelector, createSelector, createSelectorWithDeps, deleteByPath, getByPath, hasPath, setByPath } from "./utils/selector.js";
+import { createLoggerMiddleware, createSimpleLoggerMiddleware } from "./middleware/logger.js";
+import { createMiddlewareManager, getGlobalMiddlewareManager, setGlobalMiddlewareManager } from "./middleware/middleware-manager.js";
+import { createPersistMiddleware, restoreState } from "./middleware/persist.js";
+import { createTimeTravelMiddleware, setRestoreCallback } from "./middleware/time-travel.js";
+import { createValidationMiddleware } from "./middleware/validation.js";
+import { composePlugins, createPluginFactory, defineStorePlugin } from "./plugins/define-plugin.js";
+import { createPluginManager, getGlobalPluginManager, setGlobalPluginManager } from "./plugins/plugin-manager.js";
+//#region src/index.ts
+const version = "1.0.0";
+const name = "@composy/store-core";
+//#endregion
+export { BaseStore, DeserializationError, ErrorSeverity, InvalidStateError, MiddlewareError, PluginError, SerializationError, StorageError, StoreAlreadyExistsError, StoreDisposedError, StoreError, StoreErrorCode, StoreNotFoundError, SubscriptionError, TimeoutError, batch, combineSelectors, composePlugins, createAsyncAction, createBatchManager, createCachedSelector, createEventBus, createLoggerMiddleware, createMemoizedSelector, createMiddlewareManager, createPersistMiddleware, createPluginFactory, createPluginManager, createPubSub, createPubSubWithValue, createSelector, createSelectorWithDeps, createSimpleLoggerMiddleware, createStore, createStoreEngineBridge, createTimeTravelMiddleware, createValidationMiddleware, debounce, deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, defineStorePlugin, deleteByPath, errorUtils, getByPath, getGlobalBatchManager, getGlobalMiddlewareManager, getGlobalPluginManager, globalEventBus, hasPath, isObject, isPlainObject, name, restoreState, setByPath, setGlobalBatchManager, setGlobalMiddlewareManager, setGlobalPluginManager, setRestoreCallback, shallowClone, storeEventKeys, storeStateKeys, throttle, version };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=index.js.map

package/es/index.js.map

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

package/es/middleware/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 中间件模块导出
+ *
+ * 提供日志、持久化、时间旅行等中间件
+ * @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/es/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,4BAA4B,GAC7B,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,uBAAuB,EACvB,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAA"}

package/es/middleware/index.js

@@ -0,0 +1,16 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { createLoggerMiddleware, createProductionLoggerMiddleware, createSimpleLoggerMiddleware } from "./logger.js";
+import { createMiddlewareManager, getGlobalMiddlewareManager, setGlobalMiddlewareManager } from "./middleware-manager.js";
+import { createPersistMiddleware, restoreState } from "./persist.js";
+import { createTimeTravelMiddleware, setRestoreCallback } from "./time-travel.js";
+import { createValidationMiddleware } from "./validation.js";
+export { createLoggerMiddleware, createMiddlewareManager, createPersistMiddleware, createProductionLoggerMiddleware, createSimpleLoggerMiddleware, createTimeTravelMiddleware, createValidationMiddleware, getGlobalMiddlewareManager, restoreState, setGlobalMiddlewareManager, setRestoreCallback };
+/*! End of @composy/store-core | Powered by @composy/builder */

package/es/middleware/logger.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 日志中间件
+ *
+ * 提供状态变化和 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/es/middleware/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,iBAAiB,EAAa,MAAM,UAAU,CAAA;AAwEjG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,UAAU,CA8FZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE;IACpD,mBAAmB;IACnB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe;IACf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAA;IAC/C,UAAU;IACV,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAA;CAC5C,GAAG,UAAU,CA+BlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,GAAE;IACxD,eAAe;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACxD,GAAG,UAAU,CAyBlB"}