@composy/store-core 0.0.1

package/esm/engine/plugin.js

@@ -0,0 +1,153 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { globalEventBus } from "../core/event-bus.js";
+//#region src/engine/plugin.ts
+const storeStateKeys = {
+	BUS: "store:bus",
+	PINIA: "store:pinia",
+	API: "store:api",
+	REGISTRY: "store:registry",
+	RUNTIME: "store:runtime"
+};
+const storeEventKeys = {
+	INSTALLED: "store:installed",
+	UNINSTALLED: "store:uninstalled"
+};
+function resolveEngine(context) {
+	const value = context;
+	if (value && typeof value === "object" && "engine" in value) return value.engine ?? {};
+	return value ?? {};
+}
+function resolvePluginContext(context) {
+	return context && typeof context === "object" ? context : void 0;
+}
+function resolveDefaultApp(engine, context, payload) {
+	const payloadObject = payload;
+	return payloadObject?.app ?? payloadObject?.framework?.app ?? engine.getApp?.() ?? context?.framework?.app;
+}
+function createRegisteredApi(name, version, runtime) {
+	return {
+		name,
+		version,
+		pinia: runtime.pinia,
+		getStore: runtime.storeAPI.getStore,
+		hasStore: runtime.storeAPI.hasStore,
+		getStoreIds: runtime.storeAPI.getStoreIds,
+		resetAll: runtime.storeAPI.resetAll
+	};
+}
+function registerEngineApi(engine, name, version, runtime) {
+	if (!engine.api?.register) return;
+	const api = createRegisteredApi(name, version, runtime);
+	engine.api.unregister?.(name);
+	if (engine.api.register.length >= 2) {
+		engine.api.register(name, api);
+		return;
+	}
+	engine.api.register(api);
+}
+function syncEngineState(engine, name, options, runtime) {
+	engine.state?.set?.(storeStateKeys.RUNTIME, runtime);
+	engine.state?.set?.(storeStateKeys.PINIA, runtime.pinia);
+	engine.state?.set?.(storeStateKeys.API, runtime.storeAPI);
+	engine.state?.set?.(storeStateKeys.REGISTRY, runtime.registry);
+	engine.state?.set?.(storeStateKeys.BUS, globalEventBus);
+	engine.state?.set?.(`plugins.${name}`, runtime.storeAPI);
+	engine.state?.set?.(`plugins.${name}.config`, options);
+}
+function clearEngineState(engine, name) {
+	engine.state?.delete?.(storeStateKeys.RUNTIME);
+	engine.state?.delete?.(storeStateKeys.PINIA);
+	engine.state?.delete?.(storeStateKeys.API);
+	engine.state?.delete?.(storeStateKeys.REGISTRY);
+	engine.state?.delete?.(storeStateKeys.BUS);
+	engine.state?.delete?.(`plugins.${name}`);
+	engine.state?.delete?.(`plugins.${name}.config`);
+}
+function registerContainerServices(context, runtime) {
+	if (!context?.container?.singleton) return;
+	try {
+		context.container.singleton("pinia", runtime.pinia);
+		context.container.singleton("storeAPI", runtime.storeAPI);
+		context.container.singleton("storeRegistry", runtime.registry);
+		context.container.singleton("storeRuntime", runtime);
+	} catch {}
+}
+function createStoreEngineBridge(options) {
+	const { createRuntime, debug = false, name = "store", onRuntimeChange, version = "1.0.0" } = options;
+	let activeEngine = {};
+	let activeContext;
+	let runtime = null;
+	let runtimeOwner = null;
+	const bindRuntime = (nextRuntime, owner) => {
+		const previousRuntime = runtime;
+		const previousOwner = runtimeOwner;
+		runtime = nextRuntime;
+		runtimeOwner = owner;
+		onRuntimeChange?.(nextRuntime);
+		syncEngineState(activeEngine, name, options, nextRuntime);
+		registerEngineApi(activeEngine, name, version, nextRuntime);
+		registerContainerServices(activeContext, nextRuntime);
+		if (previousRuntime && previousRuntime !== nextRuntime && previousOwner === "engine") previousRuntime.dispose?.();
+		return nextRuntime;
+	};
+	const ensureRuntime = () => {
+		if (runtime && runtimeOwner === "engine") return runtime;
+		return createRuntime();
+	};
+	const attachToApp = (app) => {
+		const installedRuntime = options.getRuntimeFromApp?.(app);
+		if (installedRuntime) return bindRuntime(installedRuntime, "external");
+		const nextRuntime = ensureRuntime();
+		const mountedRuntime = options.attachToApp ? options.attachToApp(app, nextRuntime) : nextRuntime;
+		return bindRuntime(mountedRuntime, mountedRuntime === nextRuntime ? "engine" : "external");
+	};
+	const install = async (context) => {
+		activeEngine = resolveEngine(context);
+		activeContext = resolvePluginContext(context);
+		const app = options.resolveApp ? options.resolveApp(activeEngine, activeContext ?? {}, void 0) : resolveDefaultApp(activeEngine, activeContext);
+		if (app && (!options.isApp || options.isApp(app))) attachToApp(app);
+		else {
+			bindRuntime(ensureRuntime(), "engine");
+			activeEngine.events?.once?.("app:created", (payload) => {
+				const createdApp = options.resolveApp ? options.resolveApp(activeEngine, activeContext ?? {}, payload) : resolveDefaultApp(activeEngine, activeContext, payload);
+				if (createdApp && (!options.isApp || options.isApp(createdApp))) attachToApp(createdApp);
+			});
+		}
+		await activeEngine.events?.emit?.(storeEventKeys.INSTALLED, {
+			name,
+			version,
+			pinia: runtime?.pinia,
+			storeAPI: runtime?.storeAPI
+		});
+		if (debug) activeEngine.logger?.info?.("[StoreEngineBridge] installed");
+	};
+	const uninstall = async (context) => {
+		const engine = context ? resolveEngine(context) : activeEngine;
+		engine.api?.unregister?.(name);
+		clearEngineState(engine, name);
+		await engine.events?.emit?.(storeEventKeys.UNINSTALLED, { name });
+		if (runtime && runtimeOwner === "engine") runtime.dispose?.();
+		runtime = null;
+		runtimeOwner = null;
+		onRuntimeChange?.(null);
+		if (debug) engine.logger?.info?.("[StoreEngineBridge] uninstalled");
+	};
+	return {
+		attachToApp,
+		getRuntime: () => runtime,
+		install,
+		uninstall
+	};
+}
+//#endregion
+export { createStoreEngineBridge, storeEventKeys, storeStateKeys };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=plugin.js.map

package/esm/engine/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../src/engine/plugin.ts"],"sourcesContent":["/**\n * @composy/store-core Engine 桥接能力\n *\n * Core 负责 engine 生命周期、state/API 同步和事件派发；框架适配层只提供 runtime 创建与 App 挂载。\n * @module engine/plugin\n */\n\nimport type {\n  StoreEngineBridge,\n  StoreEngineBridgeOptions,\n  StoreEngineLike,\n  StoreEnginePluginContextLike,\n  StoreEngineRegisteredApi,\n  StoreRuntimeLike,\n} from './types'\nimport { globalEventBus } from '../core/event-bus'\n\nexport const storeStateKeys = {\n  BUS: 'store:bus' as const,\n  PINIA: 'store:pinia' as const,\n  API: 'store:api' as const,\n  REGISTRY: 'store:registry' as const,\n  RUNTIME: 'store:runtime' as const,\n} as const\n\nexport const storeEventKeys = {\n  INSTALLED: 'store:installed' as const,\n  UNINSTALLED: 'store:uninstalled' as const,\n} as const\n\ntype RuntimeOwner = 'engine' | 'external'\n\nfunction resolveEngine(context: unknown): StoreEngineLike {\n  const value = context as StoreEnginePluginContextLike | StoreEngineLike | null | undefined\n  if (value && typeof value === 'object' && 'engine' in value) {\n    return value.engine ?? {}\n  }\n\n  return (value ?? {}) as StoreEngineLike\n}\n\nfunction resolvePluginContext(context: unknown): StoreEnginePluginContextLike | undefined {\n  return context && typeof context === 'object'\n    ? context as StoreEnginePluginContextLike\n    : undefined\n}\n\nfunction resolveDefaultApp(\n  engine: StoreEngineLike,\n  context: StoreEnginePluginContextLike | undefined,\n  payload?: unknown,\n): unknown {\n  const payloadObject = payload as { app?: unknown; framework?: { app?: unknown } } | undefined\n  return payloadObject?.app\n    ?? payloadObject?.framework?.app\n    ?? engine.getApp?.()\n    ?? context?.framework?.app\n}\n\nfunction createRegisteredApi(\n  name: string,\n  version: string,\n  runtime: StoreRuntimeLike,\n): StoreEngineRegisteredApi {\n  return {\n    name,\n    version,\n    pinia: runtime.pinia,\n    getStore: runtime.storeAPI.getStore,\n    hasStore: runtime.storeAPI.hasStore,\n    getStoreIds: runtime.storeAPI.getStoreIds,\n    resetAll: runtime.storeAPI.resetAll,\n  }\n}\n\nfunction registerEngineApi(\n  engine: StoreEngineLike,\n  name: string,\n  version: string,\n  runtime: StoreRuntimeLike,\n): void {\n  if (!engine.api?.register) {\n    return\n  }\n\n  const api = createRegisteredApi(name, version, runtime)\n  engine.api.unregister?.(name)\n\n  if (engine.api.register.length >= 2) {\n    ;(engine.api.register as (name: string, api: StoreEngineRegisteredApi) => void)(name, api)\n    return\n  }\n\n  ;(engine.api.register as (api: StoreEngineRegisteredApi) => void)(api)\n}\n\nfunction syncEngineState<Runtime extends StoreRuntimeLike>(\n  engine: StoreEngineLike,\n  name: string,\n  options: StoreEngineBridgeOptions<Runtime>,\n  runtime: Runtime,\n): void {\n  engine.state?.set?.(storeStateKeys.RUNTIME, runtime)\n  engine.state?.set?.(storeStateKeys.PINIA, runtime.pinia)\n  engine.state?.set?.(storeStateKeys.API, runtime.storeAPI)\n  engine.state?.set?.(storeStateKeys.REGISTRY, runtime.registry)\n  engine.state?.set?.(storeStateKeys.BUS, globalEventBus)\n  engine.state?.set?.(`plugins.${name}`, runtime.storeAPI)\n  engine.state?.set?.(`plugins.${name}.config`, options)\n}\n\nfunction clearEngineState(engine: StoreEngineLike, name: string): void {\n  engine.state?.delete?.(storeStateKeys.RUNTIME)\n  engine.state?.delete?.(storeStateKeys.PINIA)\n  engine.state?.delete?.(storeStateKeys.API)\n  engine.state?.delete?.(storeStateKeys.REGISTRY)\n  engine.state?.delete?.(storeStateKeys.BUS)\n  engine.state?.delete?.(`plugins.${name}`)\n  engine.state?.delete?.(`plugins.${name}.config`)\n}\n\nfunction registerContainerServices(\n  context: StoreEnginePluginContextLike | undefined,\n  runtime: StoreRuntimeLike,\n): void {\n  if (!context?.container?.singleton) {\n    return\n  }\n\n  try {\n    context.container.singleton('pinia', runtime.pinia)\n    context.container.singleton('storeAPI', runtime.storeAPI)\n    context.container.singleton('storeRegistry', runtime.registry)\n    context.container.singleton('storeRuntime', runtime)\n  }\n  catch {\n    // 同一个 engine 重复安装时可能已存在单例，保持幂等即可。\n  }\n}\n\nexport function createStoreEngineBridge<Runtime extends StoreRuntimeLike>(\n  options: StoreEngineBridgeOptions<Runtime>,\n): StoreEngineBridge {\n  const {\n    createRuntime,\n    debug = false,\n    name = 'store',\n    onRuntimeChange,\n    version = '1.0.0',\n  } = options\n\n  let activeEngine: StoreEngineLike = {}\n  let activeContext: StoreEnginePluginContextLike | undefined\n  let runtime: Runtime | null = null\n  let runtimeOwner: RuntimeOwner | null = null\n\n  const bindRuntime = (\n    nextRuntime: Runtime,\n    owner: RuntimeOwner,\n  ): Runtime => {\n    const previousRuntime = runtime\n    const previousOwner = runtimeOwner\n\n    runtime = nextRuntime\n    runtimeOwner = owner\n    onRuntimeChange?.(nextRuntime)\n\n    syncEngineState(activeEngine, name, options, nextRuntime)\n    registerEngineApi(activeEngine, name, version, nextRuntime)\n    registerContainerServices(activeContext, nextRuntime)\n\n    if (\n      previousRuntime\n      && previousRuntime !== nextRuntime\n      && previousOwner === 'engine'\n    ) {\n      previousRuntime.dispose?.()\n    }\n\n    return nextRuntime\n  }\n\n  const ensureRuntime = (): Runtime => {\n    if (runtime && runtimeOwner === 'engine') {\n      return runtime\n    }\n\n    return createRuntime()\n  }\n\n  const attachToApp = (app: unknown): Runtime => {\n    const installedRuntime = options.getRuntimeFromApp?.(app)\n    if (installedRuntime) {\n      return bindRuntime(installedRuntime, 'external')\n    }\n\n    const nextRuntime = ensureRuntime()\n    const mountedRuntime = options.attachToApp\n      ? options.attachToApp(app, nextRuntime)\n      : nextRuntime\n    const owner: RuntimeOwner = mountedRuntime === nextRuntime ? 'engine' : 'external'\n    return bindRuntime(mountedRuntime, owner)\n  }\n\n  const install = async (context: unknown): Promise<void> => {\n    activeEngine = resolveEngine(context)\n    activeContext = resolvePluginContext(context)\n\n    const app = options.resolveApp\n      ? options.resolveApp(activeEngine, activeContext ?? {}, undefined)\n      : resolveDefaultApp(activeEngine, activeContext)\n\n    if (app && (!options.isApp || options.isApp(app))) {\n      attachToApp(app)\n    }\n    else {\n      bindRuntime(ensureRuntime(), 'engine')\n      activeEngine.events?.once?.('app:created', (payload?: unknown) => {\n        const createdApp = options.resolveApp\n          ? options.resolveApp(activeEngine, activeContext ?? {}, payload)\n          : resolveDefaultApp(activeEngine, activeContext, payload)\n        if (createdApp && (!options.isApp || options.isApp(createdApp))) {\n          attachToApp(createdApp)\n        }\n      })\n    }\n\n    await activeEngine.events?.emit?.(storeEventKeys.INSTALLED, {\n      name,\n      version,\n      pinia: runtime?.pinia,\n      storeAPI: runtime?.storeAPI,\n    })\n\n    if (debug) {\n      activeEngine.logger?.info?.('[StoreEngineBridge] installed')\n    }\n  }\n\n  const uninstall = async (context?: unknown): Promise<void> => {\n    const engine = context ? resolveEngine(context) : activeEngine\n\n    engine.api?.unregister?.(name)\n    clearEngineState(engine, name)\n    await engine.events?.emit?.(storeEventKeys.UNINSTALLED, { name })\n\n    if (runtime && runtimeOwner === 'engine') {\n      runtime.dispose?.()\n    }\n\n    runtime = null\n    runtimeOwner = null\n    onRuntimeChange?.(null)\n\n    if (debug) {\n      engine.logger?.info?.('[StoreEngineBridge] uninstalled')\n    }\n  }\n\n  return {\n    attachToApp,\n    getRuntime: () => runtime,\n    install,\n    uninstall,\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiBO,MAAM,iBAAiB;CAC5B,KAAK;CACL,OAAO;CACP,KAAK;CACL,UAAU;CACV,SAAS;AACX;AAEO,MAAM,iBAAiB;CAC5B,WAAW;CACX,aAAa;AACf;AAIA,SAAS,cAAc,SAAmC;CACxD,MAAM,QAAQ;CACd,IAAI,SAAS,OAAO,UAAU,YAAY,YAAY,OACpD,OAAO,MAAM,UAAU,CAAC;CAG1B,OAAQ,SAAS,CAAC;AACpB;AAEA,SAAS,qBAAqB,SAA4D;CACxF,OAAO,WAAW,OAAO,YAAY,WACjC,UACA,KAAA;AACN;AAEA,SAAS,kBACP,QACA,SACA,SACS;CACT,MAAM,gBAAgB;CACtB,OAAO,eAAe,OACjB,eAAe,WAAW,OAC1B,OAAO,SAAS,KAChB,SAAS,WAAW;AAC3B;AAEA,SAAS,oBACP,MACA,SACA,SAC0B;CAC1B,OAAO;EACL;EACA;EACA,OAAO,QAAQ;EACf,UAAU,QAAQ,SAAS;EAC3B,UAAU,QAAQ,SAAS;EAC3B,aAAa,QAAQ,SAAS;EAC9B,UAAU,QAAQ,SAAS;CAC7B;AACF;AAEA,SAAS,kBACP,QACA,MACA,SACA,SACM;CACN,IAAI,CAAC,OAAO,KAAK,UACf;CAGF,MAAM,MAAM,oBAAoB,MAAM,SAAS,OAAO;CACtD,OAAO,IAAI,aAAa,IAAI;CAE5B,IAAI,OAAO,IAAI,SAAS,UAAU,GAAG;EACjC,OAAO,IAAI,SAAmE,MAAM,GAAG;EACzF;CACF;CAEE,OAAO,IAAI,SAAqD,GAAG;AACvE;AAEA,SAAS,gBACP,QACA,MACA,SACA,SACM;CACN,OAAO,OAAO,MAAM,eAAe,SAAS,OAAO;CACnD,OAAO,OAAO,MAAM,eAAe,OAAO,QAAQ,KAAK;CACvD,OAAO,OAAO,MAAM,eAAe,KAAK,QAAQ,QAAQ;CACxD,OAAO,OAAO,MAAM,eAAe,UAAU,QAAQ,QAAQ;CAC7D,OAAO,OAAO,MAAM,eAAe,KAAK,cAAc;CACtD,OAAO,OAAO,MAAM,WAAW,QAAQ,QAAQ,QAAQ;CACvD,OAAO,OAAO,MAAM,WAAW,KAAI,UAAW,OAAO;AACvD;AAEA,SAAS,iBAAiB,QAAyB,MAAoB;CACrE,OAAO,OAAO,SAAS,eAAe,OAAO;CAC7C,OAAO,OAAO,SAAS,eAAe,KAAK;CAC3C,OAAO,OAAO,SAAS,eAAe,GAAG;CACzC,OAAO,OAAO,SAAS,eAAe,QAAQ;CAC9C,OAAO,OAAO,SAAS,eAAe,GAAG;CACzC,OAAO,OAAO,SAAS,WAAW,MAAM;CACxC,OAAO,OAAO,SAAS,WAAW,KAAI,QAAS;AACjD;AAEA,SAAS,0BACP,SACA,SACM;CACN,IAAI,CAAC,SAAS,WAAW,WACvB;CAGF,IAAI;EACF,QAAQ,UAAU,UAAU,SAAS,QAAQ,KAAK;EAClD,QAAQ,UAAU,UAAU,YAAY,QAAQ,QAAQ;EACxD,QAAQ,UAAU,UAAU,iBAAiB,QAAQ,QAAQ;EAC7D,QAAQ,UAAU,UAAU,gBAAgB,OAAO;CACrD,QACM,CAEN;AACF;AAEO,SAAS,wBACd,SACmB;CACnB,MAAM,EACJ,eACA,QAAQ,OACR,OAAO,SACP,iBACA,UAAU,YACR;CAEJ,IAAI,eAAgC,CAAC;CACrC,IAAI;CACJ,IAAI,UAA0B;CAC9B,IAAI,eAAoC;CAExC,MAAM,eACJ,aACA,UACY;EACZ,MAAM,kBAAkB;EACxB,MAAM,gBAAgB;EAEtB,UAAU;EACV,eAAe;EACf,kBAAkB,WAAW;EAE7B,gBAAgB,cAAc,MAAM,SAAS,WAAW;EACxD,kBAAkB,cAAc,MAAM,SAAS,WAAW;EAC1D,0BAA0B,eAAe,WAAW;EAEpD,IACE,mBACG,oBAAoB,eACpB,kBAAkB,UAErB,gBAAgB,UAAU;EAG5B,OAAO;CACT;CAEA,MAAM,sBAA+B;EACnC,IAAI,WAAW,iBAAiB,UAC9B,OAAO;EAGT,OAAO,cAAc;CACvB;CAEA,MAAM,eAAe,QAA0B;EAC7C,MAAM,mBAAmB,QAAQ,oBAAoB,GAAG;EACxD,IAAI,kBACF,OAAO,YAAY,kBAAkB,UAAU;EAGjD,MAAM,cAAc,cAAc;EAClC,MAAM,iBAAiB,QAAQ,cAC3B,QAAQ,YAAY,KAAK,WAAW,IACpC;EAEJ,OAAO,YAAY,gBADS,mBAAmB,cAAc,WAAW,UAChC;CAC1C;CAEA,MAAM,UAAU,OAAO,YAAoC;EACzD,eAAe,cAAc,OAAO;EACpC,gBAAgB,qBAAqB,OAAO;EAE5C,MAAM,MAAM,QAAQ,aAChB,QAAQ,WAAW,cAAc,iBAAiB,CAAC,GAAG,KAAA,CAAS,IAC/D,kBAAkB,cAAc,aAAa;EAEjD,IAAI,QAAQ,CAAC,QAAQ,SAAS,QAAQ,MAAM,GAAG,IAC7C,YAAY,GAAG;OAEZ;GACH,YAAY,cAAc,GAAG,QAAQ;GACrC,aAAa,QAAQ,OAAO,gBAAgB,YAAsB;IAChE,MAAM,aAAa,QAAQ,aACvB,QAAQ,WAAW,cAAc,iBAAiB,CAAC,GAAG,OAAO,IAC7D,kBAAkB,cAAc,eAAe,OAAO;IAC1D,IAAI,eAAe,CAAC,QAAQ,SAAS,QAAQ,MAAM,UAAU,IAC3D,YAAY,UAAU;GAE1B,CAAC;EACH;EAEA,MAAM,aAAa,QAAQ,OAAO,eAAe,WAAW;GAC1D;GACA;GACA,OAAO,SAAS;GAChB,UAAU,SAAS;EACrB,CAAC;EAED,IAAI,OACF,aAAa,QAAQ,OAAO,+BAA+B;CAE/D;CAEA,MAAM,YAAY,OAAO,YAAqC;EAC5D,MAAM,SAAS,UAAU,cAAc,OAAO,IAAI;EAElD,OAAO,KAAK,aAAa,IAAI;EAC7B,iBAAiB,QAAQ,IAAI;EAC7B,MAAM,OAAO,QAAQ,OAAO,eAAe,aAAa,EAAE,KAAK,CAAC;EAEhE,IAAI,WAAW,iBAAiB,UAC9B,QAAQ,UAAU;EAGpB,UAAU;EACV,eAAe;EACf,kBAAkB,IAAI;EAEtB,IAAI,OACF,OAAO,QAAQ,OAAO,iCAAiC;CAE3D;CAEA,OAAO;EACL;EACA,kBAAkB;EAClB;EACA;CACF;AACF"}

package/esm/engine/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Store Engine 集成类型
+ *
+ * 这里仅描述框架无关的 engine 契约；Vue/React 等适配层负责提供真实 runtime。
+ * @module engine/types
+ */
+import type { EventBus, StoreId } from '../types';
+export interface StoreRuntimeLike {
+    pinia?: unknown;
+    registry?: unknown;
+    storeAPI: StoreEngineApi;
+    dispose?: () => void;
+}
+export interface StoreEngineApi {
+    pinia?: unknown;
+    getStore: <T = unknown>(id: StoreId) => T | undefined;
+    hasStore: (id: StoreId) => boolean;
+    getStoreIds: () => StoreId[];
+    resetAll: () => void;
+}
+export interface StoreEngineApiLike {
+    register?: ((api: StoreEngineRegisteredApi) => void) | ((name: string, api: StoreEngineRegisteredApi) => void);
+    unregister?: (name: string) => void;
+}
+export interface StoreEngineEventsLike {
+    emit?: (event: string, payload: unknown) => void | Promise<void>;
+    once?: (event: string, listener: (payload?: unknown) => void | Promise<void>) => void;
+}
+export interface StoreEngineStateLike {
+    delete?: (key: string) => void;
+    set?: (key: string, value: unknown) => void;
+}
+export interface StoreEngineLoggerLike {
+    info?: (...args: unknown[]) => void;
+}
+export interface StoreEngineContainerLike {
+    has?: (identifier: string | symbol) => boolean;
+    resolve?: <T = unknown>(identifier: string | symbol) => T;
+    singleton?: (identifier: string | symbol, implementation: unknown) => void;
+}
+export interface StoreEngineLike {
+    api?: StoreEngineApiLike;
+    container?: StoreEngineContainerLike;
+    events?: StoreEngineEventsLike;
+    getApp?: () => unknown;
+    logger?: StoreEngineLoggerLike;
+    state?: StoreEngineStateLike;
+}
+export interface StoreEnginePluginContextLike {
+    container?: StoreEngineContainerLike;
+    engine?: StoreEngineLike;
+    framework?: {
+        app?: unknown;
+    };
+}
+export interface StoreEngineRegisteredApi extends StoreEngineApi {
+    name: string;
+    version: string;
+}
+export interface StoreEnginePluginOptions {
+    debug?: boolean;
+    dependencies?: string[];
+    name?: string;
+    version?: string;
+}
+export interface StoreEngineBridgeOptions<Runtime extends StoreRuntimeLike = StoreRuntimeLike> extends StoreEnginePluginOptions {
+    createRuntime: () => Runtime;
+    attachToApp?: (app: unknown, runtime: Runtime) => Runtime;
+    getRuntimeFromApp?: (app: unknown) => Runtime | null | undefined;
+    isApp?: (value: unknown) => boolean;
+    onRuntimeChange?: (runtime: Runtime | null) => void;
+    resolveApp?: (engine: StoreEngineLike, context: StoreEnginePluginContextLike, payload?: unknown) => unknown;
+}
+export interface StoreEngineBridge {
+    attachToApp: (app: unknown) => StoreRuntimeLike;
+    getRuntime: () => StoreRuntimeLike | null;
+    install: (context: unknown) => Promise<void>;
+    uninstall: (context?: unknown) => Promise<void>;
+}
+export type { EventBus };
+//# sourceMappingURL=types.d.ts.map

package/esm/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/esm/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