@lunarhue/store 0.3.0 → 0.4.0

package/dist/chunk-VMOEEBP4.js

@@ -0,0 +1,268 @@
+import { defineStoreLoggerMetadata, createStoreLoggerMetadata, emitStoreDebugEvent, transitionStoreLifecycle, createSubscriptionLoggerId } from './chunk-JB6XVML6.js';
+import { createStore } from '@tanstack/store';
+
+var UNINITIALIZED = /* @__PURE__ */ Symbol("lunarhue.store.uninitialized");
+function createStoreInstance({
+  builderId = "b0",
+  debug,
+  hasDeclaredInitialState,
+  hasOverrideInitialState,
+  initialState,
+  readyOnCreate
+}) {
+  const store = createStore(
+    readyOnCreate ? initialState : UNINITIALIZED
+  );
+  const lifecycleMeta = createStore({
+    status: readyOnCreate ? "ready" : "uninitialized",
+    error: null
+  });
+  const cleanups = [];
+  let disposePromise = null;
+  const nativeStateGetter = Object.getOwnPropertyDescriptor(
+    Object.getPrototypeOf(store),
+    "state"
+  )?.get;
+  if (!nativeStateGetter) {
+    throw new Error("Failed to resolve the TanStack Store state getter.");
+  }
+  const nativeGet = () => nativeStateGetter.call(store);
+  const nativeSetState = store.setState.bind(store);
+  const nativeSubscribe = store.subscribe.bind(store);
+  const instance = store;
+  const lifecycleMetaStore = lifecycleMeta;
+  defineStoreLoggerMetadata(
+    instance,
+    createStoreLoggerMetadata({
+      builderId,
+      debug
+    })
+  );
+  const assertReady = (value) => {
+    if (value === UNINITIALIZED) {
+      throw new Error("Store has not been initialized.");
+    }
+    return value;
+  };
+  const getState = () => assertReady(nativeGet());
+  const lifecycle = {
+    meta: lifecycleMeta
+  };
+  const subscribe = (observerOrFn, error, complete) => {
+    const subscriptionId = createSubscriptionLoggerId();
+    const observer = typeof observerOrFn === "function" ? {
+      next: observerOrFn,
+      error,
+      complete
+    } : observerOrFn;
+    const observerKind = typeof observerOrFn === "function" ? "function" : "observer";
+    emitStoreDebugEvent(instance, {
+      detail: { observerKind },
+      event: "subscription.connected",
+      source: "core",
+      subscriptionId
+    });
+    const subscription = nativeSubscribe({
+      next(value) {
+        if (value === UNINITIALIZED) {
+          emitStoreDebugEvent(instance, {
+            event: "subscription.notify.skipped_uninitialized",
+            minimumLevel: "trace",
+            source: "core",
+            subscriptionId
+          });
+          return;
+        }
+        emitStoreDebugEvent(instance, {
+          event: "subscription.notify",
+          minimumLevel: "verbose",
+          nextState: value,
+          source: "core",
+          subscriptionId
+        });
+        try {
+          observer.next?.(value);
+        } catch (notifyError) {
+          emitStoreDebugEvent(instance, {
+            error: notifyError,
+            event: "subscription.notify.error",
+            minimumLevel: "trace",
+            nextState: value,
+            source: "core",
+            subscriptionId
+          });
+          throw notifyError;
+        }
+      },
+      error(err) {
+        observer.error?.(err);
+      },
+      complete() {
+        observer.complete?.();
+      }
+    });
+    let unsubscribed = false;
+    return {
+      unsubscribe() {
+        if (unsubscribed) {
+          return;
+        }
+        unsubscribed = true;
+        subscription.unsubscribe();
+        emitStoreDebugEvent(instance, {
+          event: "subscription.disconnected",
+          source: "core",
+          subscriptionId
+        });
+      }
+    };
+  };
+  Object.defineProperty(instance, "dispose", {
+    configurable: true,
+    enumerable: true,
+    value: async () => {
+      if (disposePromise) {
+        return disposePromise;
+      }
+      emitStoreDebugEvent(instance, {
+        event: "store.dispose.started",
+        source: "core"
+      });
+      disposePromise = (async () => {
+        for (const cleanup of [...cleanups].reverse()) {
+          await cleanup();
+        }
+        emitStoreDebugEvent(instance, {
+          event: "store.dispose.completed",
+          source: "core"
+        });
+      })();
+      return disposePromise;
+    }
+  });
+  Object.defineProperties(instance, {
+    get: {
+      configurable: true,
+      enumerable: true,
+      value: () => getState()
+    },
+    state: {
+      configurable: true,
+      enumerable: true,
+      get() {
+        return getState();
+      }
+    },
+    setState: {
+      configurable: true,
+      enumerable: true,
+      value: (updater) => {
+        let previousState;
+        let nextState;
+        try {
+          nativeSetState((prev) => {
+            const readyPreviousState = assertReady(prev);
+            previousState = readyPreviousState;
+            nextState = updater(readyPreviousState);
+            return nextState;
+          });
+        } catch (stateError) {
+          emitStoreDebugEvent(instance, {
+            error: stateError,
+            event: "store.state.set.error",
+            minimumLevel: "trace",
+            nextState,
+            previousState,
+            source: "core"
+          });
+          throw stateError;
+        }
+        emitStoreDebugEvent(instance, {
+          event: "store.state.set",
+          minimumLevel: "verbose",
+          nextState,
+          previousState,
+          source: "core"
+        });
+      }
+    },
+    subscribe: {
+      configurable: true,
+      enumerable: true,
+      value: subscribe
+    },
+    setInitialState: {
+      configurable: true,
+      enumerable: true,
+      value: async (nextState) => {
+        try {
+          if (nativeGet() !== UNINITIALIZED) {
+            throw new Error("Store initial state has already been set.");
+          }
+          nativeSetState(() => nextState);
+        } catch (initialStateError) {
+          emitStoreDebugEvent(instance, {
+            error: initialStateError,
+            event: "store.initial_state.set.error",
+            minimumLevel: "trace",
+            nextState,
+            source: "core"
+          });
+          throw initialStateError;
+        }
+        emitStoreDebugEvent(instance, {
+          event: "store.initial_state.set",
+          minimumLevel: "verbose",
+          nextState,
+          source: "core"
+        });
+        transitionStoreLifecycle(
+          instance,
+          lifecycleMetaStore,
+          {
+            status: "ready",
+            error: null
+          },
+          {
+            source: "core"
+          }
+        );
+      }
+    },
+    lifecycle: {
+      configurable: true,
+      enumerable: true,
+      value: lifecycle
+    }
+  });
+  emitStoreDebugEvent(instance, {
+    detail: {
+      hasDeclaredInitialState: hasDeclaredInitialState ?? false,
+      hasOverrideInitialState: hasOverrideInitialState ?? false
+    },
+    event: "store.created",
+    source: "core",
+    status: readyOnCreate ? "ready" : "uninitialized"
+  });
+  return {
+    store: instance,
+    onDispose(cleanup) {
+      cleanups.push(cleanup);
+    },
+    attachSurface(surface) {
+      for (const key of Reflect.ownKeys(surface)) {
+        if (key in instance) {
+          throw new Error(`Store plugin surface collision on "${String(key)}".`);
+        }
+      }
+      Object.defineProperties(
+        instance,
+        Object.getOwnPropertyDescriptors(surface)
+      );
+    }
+  };
+}
+
+export { createStoreInstance };
+//# sourceMappingURL=chunk-VMOEEBP4.js.map
+//# sourceMappingURL=chunk-VMOEEBP4.js.map

package/dist/chunk-VMOEEBP4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/store-instance.ts"],"names":["createTanStackStore"],"mappings":"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","file":"chunk-VMOEEBP4.js","sourcesContent":["import {\n  createStore as createTanStackStore,\n  type Observer,\n  type Store as BaseStore,\n  type Subscription,\n} from '@tanstack/store'\n\nimport {\n  createStoreLoggerMetadata,\n  createSubscriptionLoggerId,\n  defineStoreLoggerMetadata,\n  emitStoreDebugEvent,\n  transitionStoreLifecycle,\n} from './logger'\n\nimport type {\n  StoreCleanup,\n  StoreCreateOptions,\n  Store,\n  StoreLifecycleMeta,\n  ReadableStore,\n} from './types'\n\ntype StoreController<TState> = {\n  store: Store<TState>\n  onDispose(cleanup: StoreCleanup): void\n  attachSurface(surface: object): void\n}\n\ntype CreateStoreInstanceOptions<TState> = {\n  builderId?: string\n  debug?: StoreCreateOptions<TState>['debug']\n  hasDeclaredInitialState?: boolean\n  hasOverrideInitialState?: boolean\n  initialState?: TState\n  readyOnCreate: boolean\n}\n\nconst UNINITIALIZED = Symbol('lunarhue.store.uninitialized')\n\nexport function createStoreInstance<TState>({\n  builderId = 'b0',\n  debug,\n  hasDeclaredInitialState,\n  hasOverrideInitialState,\n  initialState,\n  readyOnCreate,\n}: CreateStoreInstanceOptions<TState>): StoreController<TState> {\n  const store = createTanStackStore<TState | typeof UNINITIALIZED>(\n    readyOnCreate ? (initialState as TState) : UNINITIALIZED,\n  )\n  const lifecycleMeta = createTanStackStore<StoreLifecycleMeta>({\n    status: readyOnCreate ? 'ready' : 'uninitialized',\n    error: null,\n  })\n  const cleanups: StoreCleanup[] = []\n  let disposePromise: Promise<void> | null = null\n\n  const nativeStateGetter = Object.getOwnPropertyDescriptor(\n    Object.getPrototypeOf(store),\n    'state',\n  )?.get\n\n  if (!nativeStateGetter) {\n    throw new Error('Failed to resolve the TanStack Store state getter.')\n  }\n\n  const nativeGet = () => nativeStateGetter.call(store)\n  const nativeSetState = store.setState.bind(store)\n  const nativeSubscribe = store.subscribe.bind(store)\n  const instance = store as unknown as Store<TState>\n  const lifecycleMetaStore = lifecycleMeta as WritableReadableStore<\n    StoreLifecycleMeta\n  >\n\n  defineStoreLoggerMetadata(\n    instance,\n    createStoreLoggerMetadata({\n      builderId,\n      debug,\n    }),\n  )\n\n  const assertReady = (value: TState | typeof UNINITIALIZED): TState => {\n    if (value === UNINITIALIZED) {\n      throw new Error('Store has not been initialized.')\n    }\n\n    return value\n  }\n\n  const getState = () => assertReady(nativeGet())\n  const lifecycle = {\n    meta: lifecycleMeta as ReadableStore<StoreLifecycleMeta>,\n  }\n  const subscribe = (\n    observerOrFn: Observer<TState> | ((value: TState) => void),\n    error?: (error: any) => void,\n    complete?: () => void,\n  ): Subscription => {\n    const subscriptionId = createSubscriptionLoggerId()\n    const observer =\n      typeof observerOrFn === 'function'\n        ? {\n            next: observerOrFn,\n            error,\n            complete,\n          }\n        : observerOrFn\n    const observerKind =\n      typeof observerOrFn === 'function' ? 'function' : 'observer'\n\n    emitStoreDebugEvent(instance, {\n      detail: { observerKind },\n      event: 'subscription.connected',\n      source: 'core',\n      subscriptionId,\n    })\n\n    const subscription = nativeSubscribe({\n      next(value) {\n        if (value === UNINITIALIZED) {\n          emitStoreDebugEvent(instance, {\n            event: 'subscription.notify.skipped_uninitialized',\n            minimumLevel: 'trace',\n            source: 'core',\n            subscriptionId,\n          })\n          return\n        }\n\n        emitStoreDebugEvent(instance, {\n          event: 'subscription.notify',\n          minimumLevel: 'verbose',\n          nextState: value,\n          source: 'core',\n          subscriptionId,\n        })\n\n        try {\n          observer.next?.(value)\n        } catch (notifyError) {\n          emitStoreDebugEvent(instance, {\n            error: notifyError,\n            event: 'subscription.notify.error',\n            minimumLevel: 'trace',\n            nextState: value,\n            source: 'core',\n            subscriptionId,\n          })\n          throw notifyError\n        }\n      },\n      error(err) {\n        observer.error?.(err)\n      },\n      complete() {\n        observer.complete?.()\n      },\n    })\n    let unsubscribed = false\n\n    return {\n      unsubscribe() {\n        if (unsubscribed) {\n          return\n        }\n\n        unsubscribed = true\n        subscription.unsubscribe()\n        emitStoreDebugEvent(instance, {\n          event: 'subscription.disconnected',\n          source: 'core',\n          subscriptionId,\n        })\n      },\n    }\n  }\n\n  Object.defineProperty(instance, 'dispose', {\n    configurable: true,\n    enumerable: true,\n    value: async () => {\n      if (disposePromise) {\n        return disposePromise\n      }\n\n      emitStoreDebugEvent(instance, {\n        event: 'store.dispose.started',\n        source: 'core',\n      })\n\n      disposePromise = (async () => {\n        for (const cleanup of [...cleanups].reverse()) {\n          await cleanup()\n        }\n\n        emitStoreDebugEvent(instance, {\n          event: 'store.dispose.completed',\n          source: 'core',\n        })\n      })()\n\n      return disposePromise\n    },\n  })\n\n  Object.defineProperties(instance, {\n    get: {\n      configurable: true,\n      enumerable: true,\n      value: () => getState(),\n    },\n    state: {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return getState()\n      },\n    },\n    setState: {\n      configurable: true,\n      enumerable: true,\n      value: (updater: (prev: TState) => TState) => {\n        let previousState: TState | undefined\n        let nextState: TState | undefined\n\n        try {\n          nativeSetState((prev) => {\n            const readyPreviousState = assertReady(prev)\n            previousState = readyPreviousState\n            nextState = updater(readyPreviousState)\n\n            return nextState\n          })\n        } catch (stateError) {\n          emitStoreDebugEvent(instance, {\n            error: stateError,\n            event: 'store.state.set.error',\n            minimumLevel: 'trace',\n            nextState,\n            previousState,\n            source: 'core',\n          })\n          throw stateError\n        }\n\n        emitStoreDebugEvent(instance, {\n          event: 'store.state.set',\n          minimumLevel: 'verbose',\n          nextState,\n          previousState,\n          source: 'core',\n        })\n      },\n    },\n    subscribe: {\n      configurable: true,\n      enumerable: true,\n      value: subscribe,\n    },\n    setInitialState: {\n      configurable: true,\n      enumerable: true,\n      value: async (nextState: TState) => {\n        try {\n          if (nativeGet() !== UNINITIALIZED) {\n            throw new Error('Store initial state has already been set.')\n          }\n\n          nativeSetState(() => nextState)\n        } catch (initialStateError) {\n          emitStoreDebugEvent(instance, {\n            error: initialStateError,\n            event: 'store.initial_state.set.error',\n            minimumLevel: 'trace',\n            nextState,\n            source: 'core',\n          })\n          throw initialStateError\n        }\n\n        emitStoreDebugEvent(instance, {\n          event: 'store.initial_state.set',\n          minimumLevel: 'verbose',\n          nextState,\n          source: 'core',\n        })\n\n        transitionStoreLifecycle(\n          instance,\n          lifecycleMetaStore,\n          {\n            status: 'ready',\n            error: null,\n          },\n          {\n            source: 'core',\n          },\n        )\n      },\n    },\n    lifecycle: {\n      configurable: true,\n      enumerable: true,\n      value: lifecycle,\n    },\n  })\n\n  emitStoreDebugEvent(instance, {\n    detail: {\n      hasDeclaredInitialState: hasDeclaredInitialState ?? false,\n      hasOverrideInitialState: hasOverrideInitialState ?? false,\n    },\n    event: 'store.created',\n    source: 'core',\n    status: readyOnCreate ? 'ready' : 'uninitialized',\n  })\n\n  return {\n    store: instance,\n    onDispose(cleanup) {\n      cleanups.push(cleanup)\n    },\n    attachSurface(surface) {\n      for (const key of Reflect.ownKeys(surface)) {\n        if (key in instance) {\n          throw new Error(`Store plugin surface collision on \"${String(key)}\".`)\n        }\n      }\n\n      Object.defineProperties(\n        instance,\n        Object.getOwnPropertyDescriptors(surface),\n      )\n    },\n  }\n}\n\ntype WritableReadableStore<TState> = ReadableStore<TState> & {\n  setState(updater: (prev: TState) => TState): void\n}\n"]}

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { S as StoreBuilder } from '../types-CugArdrs.js';
-export { R as ReadableStore, a as Store, b as StoreCleanup, c as StoreInitialStateLoader, d as StoreLifecycleMeta, e as StoreLifecycleStatus, f as StorePlugin, g as StorePluginContext, h as StoreState } from '../types-CugArdrs.js';
+import { S as StoreBuilder } from '../types-DjDVKPhw.js';
+export { R as ReadableStore, a as Store, b as StoreCleanup, c as StoreCreateOptions, d as StoreDebugEvent, e as StoreDebugEventName, f as StoreDebugLevel, g as StoreDebugLogArgs, h as StoreDebugOptions, i as StoreDebugSink, j as StoreInitialStateLoader, k as StoreLifecycleMeta, l as StoreLifecycleStatus, m as StoreLogger, n as StorePlugin, o as StorePluginContext, p as StoreState } from '../types-DjDVKPhw.js';
 import '@tanstack/store';
 
 /**

package/dist/core/index.js

@@ -1,19 +1,32 @@
-import { createStoreInstance } from '../chunk-C5U3Q6O3.js';
-import { registerStoreBuilder } from '../chunk-PCSRXZL4.js';
+import { createStoreInstance } from '../chunk-VMOEEBP4.js';
+import { createBuilderLoggerMetadata, defineBuilderLoggerMetadata, emitStoreDebugEvent, registerStoreBuilder } from '../chunk-JB6XVML6.js';
 
 // src/core/create-store.ts
 function createStore(initialState) {
   const hasDeclaredInitialState = arguments.length > 0;
   const createBuilder = (plugins) => {
+    const loggerMetadata = createBuilderLoggerMetadata();
     const builder = {
-      create(overrideInitialState) {
-        const hasOverrideInitialState = arguments.length > 0;
+      create(overrideInitialState, options) {
+        const hasOverrideInitialState = overrideInitialState !== void 0;
         const controller = createStoreInstance({
+          builderId: loggerMetadata.builderId,
+          debug: options?.debug,
+          hasDeclaredInitialState,
+          hasOverrideInitialState,
           initialState: hasOverrideInitialState ? overrideInitialState : initialState,
           readyOnCreate: hasOverrideInitialState || hasDeclaredInitialState
         });
         for (const plugin of plugins) {
           const surface = plugin({
+            logger: {
+              emit(args) {
+                return emitStoreDebugEvent(
+                  controller.store,
+                  args
+                );
+              }
+            },
             store: controller.store,
             onDispose: (cleanup) => controller.onDispose(cleanup)
           });
@@ -27,6 +40,7 @@ function createStore(initialState) {
         return createBuilder([...plugins, plugin]);
       }
     };
+    defineBuilderLoggerMetadata(builder, loggerMetadata);
     return builder;
   };
   return createBuilder([]);

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/create-store.ts"],"names":[],"mappings":";;;;AAiBO,SAAS,YACd,YAAA,EACsB;AACtB,EAAA,MAAM,uBAAA,GAA0B,UAAU,MAAA,GAAS,CAAA;AAGnD,EAAA,MAAM,aAAA,GAAgB,CACpB,OAAA,KACmC;AACnC,IAAA,MAAM,OAAA,GAA0C;AAAA,MAC9C,OAAO,oBAAA,EAA+B;AACpC,QAAA,MAAM,uBAAA,GAA0B,UAAU,MAAA,GAAS,CAAA;AACnD,QAAA,MAAM,aAAa,mBAAA,CAAoB;AAAA,UACrC,YAAA,EAAc,0BACV,oBAAA,GACA,YAAA;AAAA,UACJ,eAAe,uBAAA,IAA2B;AAAA,SAC3C,CAAA;AAED,QAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,UAAA,MAAM,UAAU,MAAA,CAAO;AAAA,YACrB,OAAO,UAAA,CAAW,KAAA;AAAA,YAClB,SAAA,EAAW,CAAC,OAAA,KAAY,UAAA,CAAW,UAAU,OAAO;AAAA,WACrD,CAAA;AAED,UAAA,UAAA,CAAW,cAAc,OAAO,CAAA;AAAA,QAClC;AAEA,QAAA,MAAM,QAAQ,UAAA,CAAW,KAAA;AACzB,QAAA,oBAAA,CAAqB,OAAO,OAAO,CAAA;AAEnC,QAAA,OAAO,KAAA;AAAA,MACT,CAAA;AAAA,MACA,OACE,MAAA,EACA;AACA,QAAA,OAAO,aAAA,CAAuC,CAAC,GAAG,OAAA,EAAS,MAAM,CAAC,CAAA;AAAA,MACpE;AAAA,KACF;AAEA,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,aAAA,CAAkB,EAAE,CAAA;AAC7B","file":"index.js","sourcesContent":["\nimport { createStoreInstance } from './store-instance'\nimport { registerStoreBuilder } from './builder-registry'\n\nimport type { Store, StoreBuilder, StorePlugin } from './types'\n\n/**\n * Declares a reusable store builder.\n *\n * The returned builder is immutable: each call to {@link StoreBuilder.extend}\n * returns a new builder, and each call to {@link StoreBuilder.create} returns a\n * fresh runtime store instance. If neither a declaration-time default nor a\n * create-time override is provided, the runtime store starts uninitialized and\n * must receive {@link Store.setInitialState} before reads or writes are valid.\n */\nexport function createStore<TState>(): StoreBuilder<TState>\nexport function createStore<TState>(initialState: TState): StoreBuilder<TState>\nexport function createStore<TState>(\n  initialState?: TState,\n): StoreBuilder<TState> {\n  const hasDeclaredInitialState = arguments.length > 0\n  type PluginList = ReadonlyArray<StorePlugin<TState, any, any>>\n\n  const createBuilder = <TPlugins>(\n    plugins: PluginList,\n  ): StoreBuilder<TState, TPlugins> => {\n    const builder: StoreBuilder<TState, TPlugins> = {\n      create(overrideInitialState?: TState) {\n        const hasOverrideInitialState = arguments.length > 0\n        const controller = createStoreInstance({\n          initialState: hasOverrideInitialState\n            ? overrideInitialState\n            : initialState,\n          readyOnCreate: hasOverrideInitialState || hasDeclaredInitialState,\n        })\n\n        for (const plugin of plugins) {\n          const surface = plugin({\n            store: controller.store as Store<TState, any>,\n            onDispose: (cleanup) => controller.onDispose(cleanup),\n          })\n\n          controller.attachSurface(surface)\n        }\n\n        const store = controller.store as Store<TState, TPlugins>\n        registerStoreBuilder(store, builder)\n\n        return store\n      },\n      extend<TNextPlugins>(\n        plugin: StorePlugin<TState, TPlugins, TNextPlugins>,\n      ) {\n        return createBuilder<TPlugins & TNextPlugins>([...plugins, plugin])\n      },\n    }\n\n    return builder\n  }\n\n  return createBuilder<{}>([])\n}\n"]}
+{"version":3,"sources":["../../src/core/create-store.ts"],"names":[],"mappings":";;;;AA2BO,SAAS,YACd,YAAA,EACsB;AACtB,EAAA,MAAM,uBAAA,GAA0B,UAAU,MAAA,GAAS,CAAA;AAGnD,EAAA,MAAM,aAAA,GAAgB,CACpB,OAAA,KACmC;AACnC,IAAA,MAAM,iBAAiB,2BAAA,EAA4B;AACnD,IAAA,MAAM,OAAA,GAA0C;AAAA,MAC9C,MAAA,CACE,sBACA,OAAA,EACA;AACA,QAAA,MAAM,0BAA0B,oBAAA,KAAyB,MAAA;AACzD,QAAA,MAAM,aAAa,mBAAA,CAAoB;AAAA,UACrC,WAAW,cAAA,CAAe,SAAA;AAAA,UAC1B,OAAO,OAAA,EAAS,KAAA;AAAA,UAChB,uBAAA;AAAA,UACA,uBAAA;AAAA,UACA,YAAA,EAAc,0BACV,oBAAA,GACA,YAAA;AAAA,UACJ,eAAe,uBAAA,IAA2B;AAAA,SAC3C,CAAA;AAED,QAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,UAAA,MAAM,UAAU,MAAA,CAAO;AAAA,YACrB,MAAA,EAAQ;AAAA,cACN,KAAK,IAAA,EAAM;AACT,gBAAA,OAAO,mBAAA;AAAA,kBACL,UAAA,CAAW,KAAA;AAAA,kBACX;AAAA,iBACF;AAAA,cACF;AAAA,aACF;AAAA,YACA,OAAO,UAAA,CAAW,KAAA;AAAA,YAClB,SAAA,EAAW,CAAC,OAAA,KAAY,UAAA,CAAW,UAAU,OAAO;AAAA,WACrD,CAAA;AAED,UAAA,UAAA,CAAW,cAAc,OAAO,CAAA;AAAA,QAClC;AAEA,QAAA,MAAM,QAAQ,UAAA,CAAW,KAAA;AACzB,QAAA,oBAAA,CAAqB,OAAO,OAAO,CAAA;AAEnC,QAAA,OAAO,KAAA;AAAA,MACT,CAAA;AAAA,MACA,OACE,MAAA,EACA;AACA,QAAA,OAAO,aAAA,CAAuC,CAAC,GAAG,OAAA,EAAS,MAAM,CAAC,CAAA;AAAA,MACpE;AAAA,KACF;AAEA,IAAA,2BAAA,CAA4B,SAAS,cAAc,CAAA;AAEnD,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,aAAA,CAAkB,EAAE,CAAA;AAC7B","file":"index.js","sourcesContent":["\nimport { createStoreInstance } from './store-instance'\nimport { registerStoreBuilder } from './builder-registry'\nimport {\n  createBuilderLoggerMetadata,\n  defineBuilderLoggerMetadata,\n  emitStoreDebugEvent,\n} from './logger'\n\nimport type {\n  Store,\n  StoreBuilder,\n  StoreCreateOptions,\n  StorePlugin,\n} from './types'\n\n/**\n * Declares a reusable store builder.\n *\n * The returned builder is immutable: each call to {@link StoreBuilder.extend}\n * returns a new builder, and each call to {@link StoreBuilder.create} returns a\n * fresh runtime store instance. If neither a declaration-time default nor a\n * create-time override is provided, the runtime store starts uninitialized and\n * must receive {@link Store.setInitialState} before reads or writes are valid.\n */\nexport function createStore<TState>(): StoreBuilder<TState>\nexport function createStore<TState>(initialState: TState): StoreBuilder<TState>\nexport function createStore<TState>(\n  initialState?: TState,\n): StoreBuilder<TState> {\n  const hasDeclaredInitialState = arguments.length > 0\n  type PluginList = ReadonlyArray<StorePlugin<TState, any, any>>\n\n  const createBuilder = <TPlugins>(\n    plugins: PluginList,\n  ): StoreBuilder<TState, TPlugins> => {\n    const loggerMetadata = createBuilderLoggerMetadata()\n    const builder: StoreBuilder<TState, TPlugins> = {\n      create(\n        overrideInitialState?: TState,\n        options?: StoreCreateOptions<TState>,\n      ) {\n        const hasOverrideInitialState = overrideInitialState !== undefined\n        const controller = createStoreInstance({\n          builderId: loggerMetadata.builderId,\n          debug: options?.debug,\n          hasDeclaredInitialState,\n          hasOverrideInitialState,\n          initialState: hasOverrideInitialState\n            ? overrideInitialState\n            : initialState,\n          readyOnCreate: hasOverrideInitialState || hasDeclaredInitialState,\n        })\n\n        for (const plugin of plugins) {\n          const surface = plugin({\n            logger: {\n              emit(args) {\n                return emitStoreDebugEvent(\n                  controller.store as Store<TState, any>,\n                  args,\n                )\n              },\n            },\n            store: controller.store as Store<TState, any>,\n            onDispose: (cleanup) => controller.onDispose(cleanup),\n          })\n\n          controller.attachSurface(surface)\n        }\n\n        const store = controller.store as Store<TState, TPlugins>\n        registerStoreBuilder(store, builder)\n\n        return store\n      },\n      extend<TNextPlugins>(\n        plugin: StorePlugin<TState, TPlugins, TNextPlugins>,\n      ) {\n        return createBuilder<TPlugins & TNextPlugins>([...plugins, plugin])\n      },\n    }\n\n    defineBuilderLoggerMetadata(builder, loggerMetadata)\n\n    return builder\n  }\n\n  return createBuilder<{}>([])\n}\n"]}

package/dist/plugins/actions/index.d.ts

@@ -1,4 +1,4 @@
-import { f as StorePlugin, a as Store } from '../../types-CugArdrs.js';
+import { n as StorePlugin, a as Store } from '../../types-DjDVKPhw.js';
 import '@tanstack/store';
 
 /**

package/dist/plugins/persist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as Store, f as StorePlugin, S as StoreBuilder, c as StoreInitialStateLoader } from '../../types-CugArdrs.js';
+import { a as Store, n as StorePlugin, S as StoreBuilder, h as StoreDebugOptions, j as StoreInitialStateLoader } from '../../types-DjDVKPhw.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import '@tanstack/store';
@@ -137,6 +137,7 @@ type PersistStoreProviderChildren<TState, TPlugins> = ReactNode | ((args: Persis
 type BuilderPersistStoreProviderBaseProps<TState, TPlugins> = {
     builder: StoreBuilder<TState, TPlugins & PersistStoreSurface>;
     children?: PersistStoreProviderChildren<TState, TPlugins>;
+    debug?: StoreDebugOptions<TState>;
     persist?: PersistRuntimeOptions<TState>;
     store?: never;
 } & PersistenceBoundaryOptions;

package/dist/plugins/persist/index.js

@@ -1,6 +1,6 @@
-import { createStoreInstance } from '../../chunk-C5U3Q6O3.js';
-import { StoreProvider } from '../../chunk-GHGDIRN2.js';
-import { getStoreBuilder } from '../../chunk-PCSRXZL4.js';
+import { createStoreInstance } from '../../chunk-VMOEEBP4.js';
+import { StoreProvider } from '../../chunk-SOWFT4FH.js';
+import { getStoreBuilder, emitStoreDebugEvent } from '../../chunk-JB6XVML6.js';
 import { useContext, createContext, useEffectEvent, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -66,6 +66,13 @@ function createPersistController(store, pluginOptions) {
       pending: true,
       error: null
     }));
+    emitStoreDebugEvent(store, {
+      event: "persist.transition.queued",
+      minimumLevel: "verbose",
+      nextState,
+      previousState,
+      source: "persist"
+    });
   };
   const canPersist = () => {
     return state.connected && state.runtimeOptions?.enabled;
@@ -76,6 +83,14 @@ function createPersistController(store, pluginOptions) {
   const scheduleFlush = () => {
     clearTimer();
     const delay = state.runtimeOptions?.delay ?? 0;
+    emitStoreDebugEvent(store, {
+      detail: {
+        delay
+      },
+      event: "persist.flush.scheduled",
+      minimumLevel: "verbose",
+      source: "persist"
+    });
     state.timer = setTimeout(() => {
       void flush();
     }, delay);
@@ -85,6 +100,14 @@ function createPersistController(store, pluginOptions) {
     if (!runtimeOptions?.enabled) {
       return;
     }
+    const nextState = pluginOptions?.serializeState ? pluginOptions.serializeState(transition.nextState) : transition.nextState;
+    emitStoreDebugEvent(store, {
+      event: "persist.flush.started",
+      minimumLevel: "verbose",
+      nextState,
+      previousState: transition.previousState,
+      source: "persist"
+    });
     meta.setState((prev) => ({
       ...prev,
       pending: false,
@@ -92,7 +115,6 @@ function createPersistController(store, pluginOptions) {
       error: null
     }));
     try {
-      const nextState = pluginOptions?.serializeState ? pluginOptions.serializeState(transition.nextState) : transition.nextState;
       await runtimeOptions.onPersist({
         previousState: transition.previousState,
         nextState
@@ -103,6 +125,13 @@ function createPersistController(store, pluginOptions) {
         lastPersistedAt: Date.now(),
         error: null
       }));
+      emitStoreDebugEvent(store, {
+        event: "persist.flush.completed",
+        minimumLevel: "verbose",
+        nextState,
+        previousState: transition.previousState,
+        source: "persist"
+      });
     } catch (error) {
       state.pendingTransition = transition;
       meta.setState((prev) => ({
@@ -111,6 +140,13 @@ function createPersistController(store, pluginOptions) {
         persisting: false,
         error
       }));
+      emitStoreDebugEvent(store, {
+        error,
+        event: "persist.flush.failed",
+        nextState,
+        previousState: transition.previousState,
+        source: "persist"
+      });
       throw error;
     }
   };
@@ -158,6 +194,14 @@ function createPersistController(store, pluginOptions) {
       resetState();
       state.connected = true;
       ensureSubscription();
+      emitStoreDebugEvent(store, {
+        detail: {
+          delay: state.runtimeOptions.delay,
+          enabled: state.runtimeOptions.enabled
+        },
+        event: "persist.connected",
+        source: "persist"
+      });
       return () => {
         state.connected = false;
         clearTimer();
@@ -165,6 +209,14 @@ function createPersistController(store, pluginOptions) {
           ...prev,
           persisting: false
         }));
+        emitStoreDebugEvent(store, {
+          detail: {
+            delay: state.runtimeOptions?.delay ?? 0,
+            enabled: state.runtimeOptions?.enabled ?? false
+          },
+          event: "persist.disconnected",
+          source: "persist"
+        });
       };
     },
     flush
@@ -242,6 +294,14 @@ function usePersistenceBoundary(store, options) {
       return;
     }
     return () => {
+      emitStoreDebugEvent(store, {
+        detail: {
+          trigger: "unmount"
+        },
+        event: "persist.boundary.flush",
+        minimumLevel: "verbose",
+        source: "persist"
+      });
       void store.persist.flush();
     };
   }, [flushOnUnmount, store]);
@@ -250,6 +310,14 @@ function usePersistenceBoundary(store, options) {
       return;
     }
     const handlePageHide = () => {
+      emitStoreDebugEvent(store, {
+        detail: {
+          trigger: "pagehide"
+        },
+        event: "persist.boundary.flush",
+        minimumLevel: "verbose",
+        source: "persist"
+      });
       void store.persist.flush();
     };
     window.addEventListener("pagehide", handlePageHide);
@@ -317,19 +385,28 @@ function PersistStoreProvider(props) {
   );
   if ("initialState" in props) {
     const initialState = props.initialState;
-    return /* @__PURE__ */ jsx(StoreProvider, { builder: props.builder, initialState, children: ({ store }) => content(store) });
+    return /* @__PURE__ */ jsx(
+      StoreProvider,
+      {
+        builder: props.builder,
+        debug: props.debug,
+        initialState,
+        children: ({ store }) => content(store)
+      }
+    );
   }
   if (props.loadInitialState) {
     return /* @__PURE__ */ jsx(
       StoreProvider,
       {
         builder: props.builder,
+        debug: props.debug,
         loadInitialState: props.loadInitialState,
         children: ({ store }) => content(store)
       }
     );
   }
-  return /* @__PURE__ */ jsx(StoreProvider, { builder: props.builder, children: ({ store }) => content(store) });
+  return /* @__PURE__ */ jsx(StoreProvider, { builder: props.builder, debug: props.debug, children: ({ store }) => content(store) });
 }
 
 export { PersistStoreProvider, persist, usePersistentStore };