dharma-core 0.6.1 → 0.7.0

package/README.md

@@ -22,7 +22,7 @@ const store = createStore({
 const { increment, decrement } = store.actions;
 
 // Subscribe to state changes
-const unsubscribe = store.subscribe((state) => console.log(state.count));
+const unsubscribe = store.subscribe((state) => console.log(state));
 // Update the state
 increment();
 // { count: 1 }

package/dist/cjs/lib/createStore.d.ts

@@ -1,4 +1,4 @@
-type Listener<TState extends object> = (state: TState) => void;
+export type Listener<TState extends object> = (state: TState) => void;
 export type SetState<TState extends object> = (stateModifier: StateModifier<TState>) => TState;
 export type Store<TState extends object, TActions extends object> = {
     /** Returns the current state of the store. */
@@ -31,7 +31,7 @@ export type StateHandler<TState extends object> = {
     reset: () => TState;
 };
 export type DefineActions<TState extends object, TActions> = (stateHandler: StateHandler<TState>) => TActions;
-type BaseConfig<TState extends object, TActions extends object> = {
+export type BaseConfig<TState extends object, TActions extends object> = {
     /** The initial state of the store. */
     initialState: TState;
     /** A function that defines actions that can modify the state. */
@@ -45,20 +45,21 @@ type BaseConfig<TState extends object, TActions extends object> = {
     /** Invoked whenever the state changes. */
     onChange?: StoreEventHandler<TState>;
 };
+export type MaybePromise<T> = T | Promise<T>;
 export type StorageAPI = {
-    getItem: (key: string) => string | null;
-    setItem: (key: string, value: string) => void;
-    removeItem: (key: string) => void;
+    getItem: (key: string) => MaybePromise<string | null>;
+    setItem: (key: string, value: string) => MaybePromise<void>;
+    removeItem: (key: string) => MaybePromise<void>;
 };
 export type Serializer<T = any> = {
     stringify: (value: T) => string;
     parse: (value: string) => T;
 };
-type NonPersistentConfig = {
+export type NoPersistConfig = {
     /** Whether to persist the state of the store. */
     persist?: false;
 };
-type PersistentConfig<TState extends object> = {
+export type PersistConfig<TState extends object> = {
     /** Whether to persist the state of the store. */
     persist: true;
     /** The unique key used to identify this store in storage. */
@@ -68,7 +69,7 @@ type PersistentConfig<TState extends object> = {
     /** The serializer to use for storing the state. Defaults to JSON. */
     serializer?: Serializer<TState>;
 };
-export type StoreConfig<TState extends object, TActions extends object> = BaseConfig<TState, TActions> & (NonPersistentConfig | PersistentConfig<TState>);
+export type StoreConfig<TState extends object, TActions extends object> = BaseConfig<TState, TActions> & (PersistConfig<TState> | NoPersistConfig);
 /**
  * Creates a store with an initial state and actions that can modify the state.
  *
@@ -152,4 +153,3 @@ export type StoreConfig<TState extends object, TActions extends object> = BaseCo
  * ```
  */
 export declare const createStore: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>) => Store<TState, TActions>;
-export {};

package/dist/cjs/lib/createStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStore.js","sources":["../../../src/lib/createStore.ts"],"sourcesContent":["import { getPersistHandler } from \"./getPersistHandler\";\nimport { merge } from \"./merge\";\n\ntype Listener<TState extends object> = (state: TState) => void;\n\nexport type SetState<TState extends object> = (\n  stateModifier: StateModifier<TState>,\n) => TState;\n\nexport type Store<TState extends object, TActions extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n  /** Actions that can modify the state of the store. */\n  actions: TActions;\n  /** Subscribes to changes in the state of the store. Returns an unsubscribe function. */\n  subscribe: (listener: Listener<TState>) => () => void;\n};\n\nexport type StoreEventContext<TState extends object> = {\n  /** The current state of the store. */\n  state: TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type StoreEventHandler<TState extends object> = (\n  context: StoreEventContext<TState>,\n) => void;\n\nexport type StateModifier<TState extends object> =\n  | Partial<TState>\n  | ((state: TState) => Partial<TState>);\n\nexport type StateHandler<TState extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type DefineActions<TState extends object, TActions> = (\n  stateHandler: StateHandler<TState>,\n) => TActions;\n\ntype BaseConfig<TState extends object, TActions extends object> = {\n  /** The initial state of the store. */\n  initialState: TState;\n  /** A function that defines actions that can modify the state. */\n  defineActions?: DefineActions<TState, TActions>;\n  /** Invoked when the store is created. */\n  onLoad?: StoreEventHandler<TState>;\n  /** Invoked when the store is subscribed to. */\n  onAttach?: StoreEventHandler<TState>;\n  /** Invoked when the store is unsubscribed from. */\n  onDetach?: StoreEventHandler<TState>;\n  /** Invoked whenever the state changes. */\n  onChange?: StoreEventHandler<TState>;\n};\n\nexport type StorageAPI = {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Serializer<T = any> = {\n  stringify: (value: T) => string;\n  parse: (value: string) => T;\n};\n\ntype NonPersistentConfig = {\n  /** Whether to persist the state of the store. */\n  persist?: false;\n};\n\ntype PersistentConfig<TState extends object> = {\n  /** Whether to persist the state of the store. */\n  persist: true;\n  /** The unique key used to identify this store in storage. */\n  key: string;\n  /** The storage to use for persisting the state. Defaults to local storage if available. */\n  storage?: StorageAPI;\n  /** The serializer to use for storing the state. Defaults to JSON. */\n  serializer?: Serializer<TState>;\n};\n\nexport type StoreConfig<\n  TState extends object,\n  TActions extends object,\n> = BaseConfig<TState, TActions> &\n  (NonPersistentConfig | PersistentConfig<TState>);\n\n/**\n * Creates a store with an initial state and actions that can modify the state.\n *\n * @param {StoreConfig<TState, TActions>} [config] - The configuration for the store.\n *\n * @returns {Store<TState, TActions>} The created store with state management methods.\n *\n * @example\n * Basic usage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * @example\n * With event handlers:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import { State } from \"./types\";\n *\n * const initialState: State = { data: null, loading: true, error: null };\n *\n * const store = createStore({\n *   initialState,\n *   onAttach: async ({ set }) => {\n *     try {\n *       const response = await fetch(\"https://api.example.com/data\");\n *       const data = await response.json();\n *       set({ data, loading: false });\n *     } catch (error) {\n *       set({ error, loading: false });\n *     }\n *   },\n *   onDetach: ({ reset }) => reset(),\n * });\n * ```\n *\n * @example\n * Persistent store (uses local storage by default):\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).\n * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).\n *\n * @example\n * With superjson serialization and session storage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import superjson from \"superjson\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   serializer: superjson,\n *   storage: sessionStorage,\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n */\nexport const createStore = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n): Store<TState, TActions> => {\n  const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } =\n    config;\n\n  let state = initialState;\n\n  const get = () => state;\n\n  const setSilently = (stateModifier: StateModifier<TState>) => {\n    state = merge(state, stateModifier);\n    return state;\n  };\n\n  const set = (stateModifier: StateModifier<TState>) => {\n    setSilently(stateModifier);\n    dispatch();\n    return state;\n  };\n\n  const resetSilently = () => setSilently(initialState);\n\n  const reset = () => {\n    resetSilently();\n    dispatch();\n    return state;\n  };\n\n  const listeners = new Set<Listener<TState>>();\n  const actions = defineActions\n    ? defineActions({ set, get, reset })\n    : ({} as TActions);\n  const IS_BROWSER = typeof window !== \"undefined\";\n  const persistHandler = getPersistHandler(config, IS_BROWSER, get, set);\n\n  const subscribe = (listener: Listener<TState>) => {\n    if (listeners.size === 0) {\n      onAttach?.({ state, set, reset });\n      persistHandler?.updateState();\n\n      if (IS_BROWSER && persistHandler) {\n        window.addEventListener(\"focus\", persistHandler.updateState);\n      }\n    }\n\n    listener(state);\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        onDetach?.({ state, set, reset });\n\n        if (IS_BROWSER && persistHandler) {\n          window.removeEventListener(\"focus\", persistHandler.updateState);\n        }\n      }\n    };\n  };\n\n  const dispatch = () => {\n    onChange?.({\n      state,\n      set: setSilently,\n      reset: resetSilently,\n    });\n    persistHandler?.updateSnapshot(state);\n    listeners.forEach((listener) => listener(state));\n  };\n\n  onLoad?.({ state, set, reset });\n  persistHandler?.initializeSnapshots();\n\n  return {\n    get,\n    set,\n    reset,\n    subscribe,\n    actions,\n  };\n};\n"],"names":["merge","getPersistHandler"],"mappings":";;;;;AAqGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFG;AACI,MAAM,WAAW,GAAG,CAIzB,MAAqC,KACV;AAC3B,IAAA,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACzE,MAAM;IAER,IAAI,KAAK,GAAG,YAAY;AAExB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK;AAEvB,IAAA,MAAM,WAAW,GAAG,CAAC,aAAoC,KAAI;AAC3D,QAAA,KAAK,GAAGA,WAAK,CAAC,KAAK,EAAE,aAAa,CAAC;AACnC,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,aAAoC,KAAI;QACnD,WAAW,CAAC,aAAa,CAAC;AAC1B,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC;IAErD,MAAM,KAAK,GAAG,MAAK;AACjB,QAAA,aAAa,EAAE;AACf,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;IAC7C,MAAM,OAAO,GAAG;UACZ,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;UAChC,EAAe;AACpB,IAAA,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW;AAChD,IAAA,MAAM,cAAc,GAAGC,mCAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;AAEtE,IAAA,MAAM,SAAS,GAAG,CAAC,QAA0B,KAAI;AAC/C,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;YACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACjC,cAAc,EAAE,WAAW,EAAE;AAE7B,YAAA,IAAI,UAAU,IAAI,cAAc,EAAE;gBAChC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;YAC9D;QACF;QAEA,QAAQ,CAAC,KAAK,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;gBACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAEjC,gBAAA,IAAI,UAAU,IAAI,cAAc,EAAE;oBAChC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;gBACjE;YACF;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,QAAQ,GAAG;YACT,KAAK;AACL,YAAA,GAAG,EAAE,WAAW;AAChB,YAAA,KAAK,EAAE,aAAa;AACrB,SAAA,CAAC;AACF,QAAA,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC;AACrC,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,IAAA,CAAC;IAED,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE,mBAAmB,EAAE;IAErC,OAAO;QACL,GAAG;QACH,GAAG;QACH,KAAK;QACL,SAAS;QACT,OAAO;KACR;AACH;;;;"}
+{"version":3,"file":"createStore.js","sources":["../../../src/lib/createStore.ts"],"sourcesContent":["import { getPersistHandler } from \"./getPersistHandler\";\nimport { merge } from \"./merge\";\n\nexport type Listener<TState extends object> = (state: TState) => void;\n\nexport type SetState<TState extends object> = (\n  stateModifier: StateModifier<TState>,\n) => TState;\n\nexport type Store<TState extends object, TActions extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n  /** Actions that can modify the state of the store. */\n  actions: TActions;\n  /** Subscribes to changes in the state of the store. Returns an unsubscribe function. */\n  subscribe: (listener: Listener<TState>) => () => void;\n};\n\nexport type StoreEventContext<TState extends object> = {\n  /** The current state of the store. */\n  state: TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type StoreEventHandler<TState extends object> = (\n  context: StoreEventContext<TState>,\n) => void;\n\nexport type StateModifier<TState extends object> =\n  | Partial<TState>\n  | ((state: TState) => Partial<TState>);\n\nexport type StateHandler<TState extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type DefineActions<TState extends object, TActions> = (\n  stateHandler: StateHandler<TState>,\n) => TActions;\n\nexport type BaseConfig<TState extends object, TActions extends object> = {\n  /** The initial state of the store. */\n  initialState: TState;\n  /** A function that defines actions that can modify the state. */\n  defineActions?: DefineActions<TState, TActions>;\n  /** Invoked when the store is created. */\n  onLoad?: StoreEventHandler<TState>;\n  /** Invoked when the store is subscribed to. */\n  onAttach?: StoreEventHandler<TState>;\n  /** Invoked when the store is unsubscribed from. */\n  onDetach?: StoreEventHandler<TState>;\n  /** Invoked whenever the state changes. */\n  onChange?: StoreEventHandler<TState>;\n};\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport type StorageAPI = {\n  getItem: (key: string) => MaybePromise<string | null>;\n  setItem: (key: string, value: string) => MaybePromise<void>;\n  removeItem: (key: string) => MaybePromise<void>;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Serializer<T = any> = {\n  stringify: (value: T) => string;\n  parse: (value: string) => T;\n};\n\nexport type NoPersistConfig = {\n  /** Whether to persist the state of the store. */\n  persist?: false;\n};\n\nexport type PersistConfig<TState extends object> = {\n  /** Whether to persist the state of the store. */\n  persist: true;\n  /** The unique key used to identify this store in storage. */\n  key: string;\n  /** The storage to use for persisting the state. Defaults to local storage if available. */\n  storage?: StorageAPI;\n  /** The serializer to use for storing the state. Defaults to JSON. */\n  serializer?: Serializer<TState>;\n};\n\nexport type StoreConfig<\n  TState extends object,\n  TActions extends object,\n> = BaseConfig<TState, TActions> & (PersistConfig<TState> | NoPersistConfig);\n\n/**\n * Creates a store with an initial state and actions that can modify the state.\n *\n * @param {StoreConfig<TState, TActions>} [config] - The configuration for the store.\n *\n * @returns {Store<TState, TActions>} The created store with state management methods.\n *\n * @example\n * Basic usage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * @example\n * With event handlers:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import { State } from \"./types\";\n *\n * const initialState: State = { data: null, loading: true, error: null };\n *\n * const store = createStore({\n *   initialState,\n *   onAttach: async ({ set }) => {\n *     try {\n *       const response = await fetch(\"https://api.example.com/data\");\n *       const data = await response.json();\n *       set({ data, loading: false });\n *     } catch (error) {\n *       set({ error, loading: false });\n *     }\n *   },\n *   onDetach: ({ reset }) => reset(),\n * });\n * ```\n *\n * @example\n * Persistent store (uses local storage by default):\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).\n * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).\n *\n * @example\n * With superjson serialization and session storage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import superjson from \"superjson\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   serializer: superjson,\n *   storage: sessionStorage,\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n */\nexport const createStore = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n): Store<TState, TActions> => {\n  const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } =\n    config;\n\n  let state = initialState;\n\n  const get = () => state;\n\n  const setSilently = (stateModifier: StateModifier<TState>) => {\n    state = merge(state, stateModifier);\n    return state;\n  };\n\n  const set = (stateModifier: StateModifier<TState>) => {\n    setSilently(stateModifier);\n    dispatch();\n    return state;\n  };\n\n  const resetSilently = () => setSilently(initialState);\n\n  const reset = () => {\n    resetSilently();\n    dispatch();\n    return state;\n  };\n\n  const listeners = new Set<Listener<TState>>();\n  const actions = defineActions\n    ? defineActions({ set, get, reset })\n    : ({} as TActions);\n  const IS_BROWSER = typeof window !== \"undefined\";\n  const persistHandler = getPersistHandler(config, IS_BROWSER, get, set);\n\n  const subscribe = (listener: Listener<TState>) => {\n    if (listeners.size === 0) {\n      onAttach?.({ state, set, reset });\n      persistHandler?.updateState();\n\n      if (IS_BROWSER && persistHandler) {\n        window.addEventListener(\"focus\", persistHandler.updateState);\n      }\n    }\n\n    listener(state);\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        onDetach?.({ state, set, reset });\n\n        if (IS_BROWSER && persistHandler) {\n          window.removeEventListener(\"focus\", persistHandler.updateState);\n        }\n      }\n    };\n  };\n\n  const dispatch = () => {\n    onChange?.({\n      state,\n      set: setSilently,\n      reset: resetSilently,\n    });\n    persistHandler?.updateSnapshot(state);\n    listeners.forEach((listener) => listener(state));\n  };\n\n  onLoad?.({ state, set, reset });\n  persistHandler?.initializeSnapshots();\n\n  return {\n    get,\n    set,\n    reset,\n    subscribe,\n    actions,\n  };\n};\n"],"names":["merge","getPersistHandler"],"mappings":";;;;;AAsGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFG;AACI,MAAM,WAAW,GAAG,CAIzB,MAAqC,KACV;AAC3B,IAAA,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACzE,MAAM;IAER,IAAI,KAAK,GAAG,YAAY;AAExB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK;AAEvB,IAAA,MAAM,WAAW,GAAG,CAAC,aAAoC,KAAI;AAC3D,QAAA,KAAK,GAAGA,WAAK,CAAC,KAAK,EAAE,aAAa,CAAC;AACnC,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,aAAoC,KAAI;QACnD,WAAW,CAAC,aAAa,CAAC;AAC1B,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC;IAErD,MAAM,KAAK,GAAG,MAAK;AACjB,QAAA,aAAa,EAAE;AACf,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;IAC7C,MAAM,OAAO,GAAG;UACZ,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;UAChC,EAAe;AACpB,IAAA,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW;AAChD,IAAA,MAAM,cAAc,GAAGC,mCAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;AAEtE,IAAA,MAAM,SAAS,GAAG,CAAC,QAA0B,KAAI;AAC/C,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;YACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACjC,cAAc,EAAE,WAAW,EAAE;AAE7B,YAAA,IAAI,UAAU,IAAI,cAAc,EAAE;gBAChC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;YAC9D;QACF;QAEA,QAAQ,CAAC,KAAK,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;gBACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAEjC,gBAAA,IAAI,UAAU,IAAI,cAAc,EAAE;oBAChC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;gBACjE;YACF;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,QAAQ,GAAG;YACT,KAAK;AACL,YAAA,GAAG,EAAE,WAAW;AAChB,YAAA,KAAK,EAAE,aAAa;AACrB,SAAA,CAAC;AACF,QAAA,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC;AACrC,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,IAAA,CAAC;IAED,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE,mBAAmB,EAAE;IAErC,OAAO;QACL,GAAG;QACH,GAAG;QACH,KAAK;QACL,SAAS;QACT,OAAO;KACR;AACH;;;;"}

package/dist/cjs/lib/getPersistHandler.d.ts

@@ -1,6 +1,6 @@
 import { SetState, StoreConfig } from "./createStore";
 export declare const getPersistHandler: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>, isBrowser: boolean, get: () => TState, set: SetState<TState>) => {
-    initializeSnapshots: () => void;
-    updateSnapshot: (newState: TState) => void;
-    updateState: () => void;
+    initializeSnapshots: () => Promise<void>;
+    updateSnapshot: (newState: TState) => Promise<void>;
+    updateState: () => Promise<void>;
 } | null;

package/dist/cjs/lib/getPersistHandler.js

@@ -1,34 +1,61 @@
 'use strict';
 
+var warn = require('./warn.js');
+
 const getPersistHandler = (config, isBrowser, get, set) => {
     if (!config.persist) {
         return null;
     }
     const storage = config.storage ?? (isBrowser ? localStorage : undefined);
     if (!storage) {
+        warn.warn("No storage provider found. If this happened during SSR, you can safely ignore this warning.");
         return null;
     }
     const { key, serializer = JSON, initialState } = config;
     const initKey = `init_${key}`;
-    const initializeSnapshots = () => {
-        const initialStateSnapshot = storage.getItem(initKey);
-        const initialStateString = serializer.stringify(initialState);
-        if (initialStateSnapshot !== initialStateString) {
-            storage.setItem(initKey, initialStateString);
-            storage.removeItem(key);
+    const initializeSnapshots = async () => {
+        try {
+            let initialStateSnapshot = storage.getItem(initKey);
+            const initialStateString = serializer.stringify(initialState);
+            if (initialStateSnapshot instanceof Promise) {
+                initialStateSnapshot = await initialStateSnapshot;
+            }
+            if (initialStateSnapshot !== initialStateString) {
+                storage.setItem(initKey, initialStateString);
+                storage.removeItem(key);
+            }
+        }
+        catch {
+            warn.warn("Failed to initialize snapshots. If this happened during SSR, you can safely ignore this warning.");
         }
     };
-    const updateSnapshot = (newState) => {
-        const currentSnapshot = storage.getItem(key);
-        const newSnapshot = serializer.stringify(newState);
-        if (newSnapshot !== currentSnapshot) {
-            storage.setItem(key, newSnapshot);
+    const updateSnapshot = async (newState) => {
+        try {
+            let currentSnapshot = storage.getItem(key);
+            const newSnapshot = serializer.stringify(newState);
+            if (currentSnapshot instanceof Promise) {
+                currentSnapshot = await currentSnapshot;
+            }
+            if (newSnapshot !== currentSnapshot) {
+                storage.setItem(key, newSnapshot);
+            }
+        }
+        catch {
+            warn.warn("Failed to update snapshot");
         }
     };
-    const updateState = () => {
-        const currentSnapshot = storage.getItem(key);
-        if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {
-            set(serializer.parse(currentSnapshot));
+    const updateState = async () => {
+        try {
+            let currentSnapshot = storage.getItem(key);
+            if (currentSnapshot instanceof Promise) {
+                currentSnapshot = await currentSnapshot;
+            }
+            if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {
+                set(serializer.parse(currentSnapshot));
+            }
+        }
+        catch {
+            warn.warn("Failed to update state from snapshot");
         }
     };
     return {

package/dist/cjs/lib/getPersistHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPersistHandler.js","sources":["../../../src/lib/getPersistHandler.ts"],"sourcesContent":["import { SetState, StoreConfig } from \"./createStore\";\n\nexport const getPersistHandler = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n  isBrowser: boolean,\n  get: () => TState,\n  set: SetState<TState>,\n) => {\n  if (!config.persist) {\n    return null;\n  }\n\n  const storage = config.storage ?? (isBrowser ? localStorage : undefined);\n\n  if (!storage) {\n    return null;\n  }\n\n  const { key, serializer = JSON, initialState } = config;\n  const initKey = `init_${key}`;\n\n  const initializeSnapshots = () => {\n    const initialStateSnapshot = storage.getItem(initKey);\n    const initialStateString = serializer.stringify(initialState);\n\n    if (initialStateSnapshot !== initialStateString) {\n      storage.setItem(initKey, initialStateString);\n      storage.removeItem(key);\n    }\n  };\n\n  const updateSnapshot = (newState: TState) => {\n    const currentSnapshot = storage.getItem(key);\n    const newSnapshot = serializer.stringify(newState);\n\n    if (newSnapshot !== currentSnapshot) {\n      storage.setItem(key, newSnapshot);\n    }\n  };\n\n  const updateState = () => {\n    const currentSnapshot = storage.getItem(key);\n\n    if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {\n      set(serializer.parse(currentSnapshot));\n    }\n  };\n\n  return {\n    initializeSnapshots,\n    updateSnapshot,\n    updateState,\n  };\n};\n"],"names":[],"mappings":";;AAEO,MAAM,iBAAiB,GAAG,CAI/B,MAAqC,EACrC,SAAkB,EAClB,GAAiB,EACjB,GAAqB,KACnB;AACF,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAExE,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,OAAO,IAAI;IACb;IAEA,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM;AACvD,IAAA,MAAM,OAAO,GAAG,CAAA,KAAA,EAAQ,GAAG,EAAE;IAE7B,MAAM,mBAAmB,GAAG,MAAK;QAC/B,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACrD,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;AAE7D,QAAA,IAAI,oBAAoB,KAAK,kBAAkB,EAAE;AAC/C,YAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC;AAC5C,YAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACzB;AACF,IAAA,CAAC;AAED,IAAA,MAAM,cAAc,GAAG,CAAC,QAAgB,KAAI;QAC1C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;QAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;AAElD,QAAA,IAAI,WAAW,KAAK,eAAe,EAAE;AACnC,YAAA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;QACnC;AACF,IAAA,CAAC;IAED,MAAM,WAAW,GAAG,MAAK;QACvB,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAE5C,QAAA,IAAI,eAAe,IAAI,eAAe,KAAK,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE;YACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACxC;AACF,IAAA,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,cAAc;QACd,WAAW;KACZ;AACH;;;;"}
+{"version":3,"file":"getPersistHandler.js","sources":["../../../src/lib/getPersistHandler.ts"],"sourcesContent":["import { SetState, StorageAPI, StoreConfig } from \"./createStore\";\nimport { warn } from \"./warn\";\n\nexport const getPersistHandler = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n  isBrowser: boolean,\n  get: () => TState,\n  set: SetState<TState>,\n) => {\n  if (!config.persist) {\n    return null;\n  }\n\n  const storage =\n    config.storage ?? (isBrowser ? (localStorage as StorageAPI) : undefined);\n\n  if (!storage) {\n    warn(\n      \"No storage provider found. If this happened during SSR, you can safely ignore this warning.\",\n    );\n    return null;\n  }\n\n  const { key, serializer = JSON, initialState } = config;\n  const initKey = `init_${key}`;\n\n  const initializeSnapshots = async () => {\n    try {\n      let initialStateSnapshot = storage.getItem(initKey);\n      const initialStateString = serializer.stringify(initialState);\n\n      if (initialStateSnapshot instanceof Promise) {\n        initialStateSnapshot = await initialStateSnapshot;\n      }\n\n      if (initialStateSnapshot !== initialStateString) {\n        storage.setItem(initKey, initialStateString);\n        storage.removeItem(key);\n      }\n    } catch {\n      warn(\n        \"Failed to initialize snapshots. If this happened during SSR, you can safely ignore this warning.\",\n      );\n    }\n  };\n\n  const updateSnapshot = async (newState: TState) => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n      const newSnapshot = serializer.stringify(newState);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (newSnapshot !== currentSnapshot) {\n        storage.setItem(key, newSnapshot);\n      }\n    } catch {\n      warn(\"Failed to update snapshot\");\n    }\n  };\n\n  const updateState = async () => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {\n        set(serializer.parse(currentSnapshot));\n      }\n    } catch {\n      warn(\"Failed to update state from snapshot\");\n    }\n  };\n\n  return {\n    initializeSnapshots,\n    updateSnapshot,\n    updateState,\n  };\n};\n"],"names":["warn"],"mappings":";;;;AAGO,MAAM,iBAAiB,GAAG,CAI/B,MAAqC,EACrC,SAAkB,EAClB,GAAiB,EACjB,GAAqB,KACnB;AACF,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,KAAK,SAAS,GAAI,YAA2B,GAAG,SAAS,CAAC;IAE1E,IAAI,CAAC,OAAO,EAAE;QACZA,SAAI,CACF,6FAA6F,CAC9F;AACD,QAAA,OAAO,IAAI;IACb;IAEA,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM;AACvD,IAAA,MAAM,OAAO,GAAG,CAAA,KAAA,EAAQ,GAAG,EAAE;AAE7B,IAAA,MAAM,mBAAmB,GAAG,YAAW;AACrC,QAAA,IAAI;YACF,IAAI,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YACnD,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;AAE7D,YAAA,IAAI,oBAAoB,YAAY,OAAO,EAAE;gBAC3C,oBAAoB,GAAG,MAAM,oBAAoB;YACnD;AAEA,YAAA,IAAI,oBAAoB,KAAK,kBAAkB,EAAE;AAC/C,gBAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC;AAC5C,gBAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CACF,kGAAkG,CACnG;QACH;AACF,IAAA,CAAC;AAED,IAAA,MAAM,cAAc,GAAG,OAAO,QAAgB,KAAI;AAChD,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;AAElD,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,WAAW,KAAK,eAAe,EAAE;AACnC,gBAAA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;YACnC;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CAAC,2BAA2B,CAAC;QACnC;AACF,IAAA,CAAC;AAED,IAAA,MAAM,WAAW,GAAG,YAAW;AAC7B,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAE1C,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,eAAe,IAAI,eAAe,KAAK,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE;gBACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACxC;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CAAC,sCAAsC,CAAC;QAC9C;AACF,IAAA,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,cAAc;QACd,WAAW;KACZ;AACH;;;;"}

package/dist/cjs/lib/warn.d.ts

@@ -0,0 +1 @@
+export declare const warn: (message: string) => void;

package/dist/cjs/lib/warn.js

@@ -0,0 +1,6 @@
+'use strict';
+
+const warn = (message) => console.warn(`[dharma-core] ${message}`);
+
+exports.warn = warn;
+//# sourceMappingURL=warn.js.map

package/dist/cjs/lib/warn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn.js","sources":["../../../src/lib/warn.ts"],"sourcesContent":["export const warn = (message: string) =>\n  console.warn(`[dharma-core] ${message}`);\n"],"names":[],"mappings":";;AAAO,MAAM,IAAI,GAAG,CAAC,OAAe,KAClC,OAAO,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAA,CAAE;;;;"}

package/dist/esm/lib/createStore.d.ts

@@ -1,4 +1,4 @@
-type Listener<TState extends object> = (state: TState) => void;
+export type Listener<TState extends object> = (state: TState) => void;
 export type SetState<TState extends object> = (stateModifier: StateModifier<TState>) => TState;
 export type Store<TState extends object, TActions extends object> = {
     /** Returns the current state of the store. */
@@ -31,7 +31,7 @@ export type StateHandler<TState extends object> = {
     reset: () => TState;
 };
 export type DefineActions<TState extends object, TActions> = (stateHandler: StateHandler<TState>) => TActions;
-type BaseConfig<TState extends object, TActions extends object> = {
+export type BaseConfig<TState extends object, TActions extends object> = {
     /** The initial state of the store. */
     initialState: TState;
     /** A function that defines actions that can modify the state. */
@@ -45,20 +45,21 @@ type BaseConfig<TState extends object, TActions extends object> = {
     /** Invoked whenever the state changes. */
     onChange?: StoreEventHandler<TState>;
 };
+export type MaybePromise<T> = T | Promise<T>;
 export type StorageAPI = {
-    getItem: (key: string) => string | null;
-    setItem: (key: string, value: string) => void;
-    removeItem: (key: string) => void;
+    getItem: (key: string) => MaybePromise<string | null>;
+    setItem: (key: string, value: string) => MaybePromise<void>;
+    removeItem: (key: string) => MaybePromise<void>;
 };
 export type Serializer<T = any> = {
     stringify: (value: T) => string;
     parse: (value: string) => T;
 };
-type NonPersistentConfig = {
+export type NoPersistConfig = {
     /** Whether to persist the state of the store. */
     persist?: false;
 };
-type PersistentConfig<TState extends object> = {
+export type PersistConfig<TState extends object> = {
     /** Whether to persist the state of the store. */
     persist: true;
     /** The unique key used to identify this store in storage. */
@@ -68,7 +69,7 @@ type PersistentConfig<TState extends object> = {
     /** The serializer to use for storing the state. Defaults to JSON. */
     serializer?: Serializer<TState>;
 };
-export type StoreConfig<TState extends object, TActions extends object> = BaseConfig<TState, TActions> & (NonPersistentConfig | PersistentConfig<TState>);
+export type StoreConfig<TState extends object, TActions extends object> = BaseConfig<TState, TActions> & (PersistConfig<TState> | NoPersistConfig);
 /**
  * Creates a store with an initial state and actions that can modify the state.
  *
@@ -152,4 +153,3 @@ export type StoreConfig<TState extends object, TActions extends object> = BaseCo
  * ```
  */
 export declare const createStore: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>) => Store<TState, TActions>;
-export {};

package/dist/esm/lib/createStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStore.js","sources":["../../../src/lib/createStore.ts"],"sourcesContent":["import { getPersistHandler } from \"./getPersistHandler\";\nimport { merge } from \"./merge\";\n\ntype Listener<TState extends object> = (state: TState) => void;\n\nexport type SetState<TState extends object> = (\n  stateModifier: StateModifier<TState>,\n) => TState;\n\nexport type Store<TState extends object, TActions extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n  /** Actions that can modify the state of the store. */\n  actions: TActions;\n  /** Subscribes to changes in the state of the store. Returns an unsubscribe function. */\n  subscribe: (listener: Listener<TState>) => () => void;\n};\n\nexport type StoreEventContext<TState extends object> = {\n  /** The current state of the store. */\n  state: TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type StoreEventHandler<TState extends object> = (\n  context: StoreEventContext<TState>,\n) => void;\n\nexport type StateModifier<TState extends object> =\n  | Partial<TState>\n  | ((state: TState) => Partial<TState>);\n\nexport type StateHandler<TState extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type DefineActions<TState extends object, TActions> = (\n  stateHandler: StateHandler<TState>,\n) => TActions;\n\ntype BaseConfig<TState extends object, TActions extends object> = {\n  /** The initial state of the store. */\n  initialState: TState;\n  /** A function that defines actions that can modify the state. */\n  defineActions?: DefineActions<TState, TActions>;\n  /** Invoked when the store is created. */\n  onLoad?: StoreEventHandler<TState>;\n  /** Invoked when the store is subscribed to. */\n  onAttach?: StoreEventHandler<TState>;\n  /** Invoked when the store is unsubscribed from. */\n  onDetach?: StoreEventHandler<TState>;\n  /** Invoked whenever the state changes. */\n  onChange?: StoreEventHandler<TState>;\n};\n\nexport type StorageAPI = {\n  getItem: (key: string) => string | null;\n  setItem: (key: string, value: string) => void;\n  removeItem: (key: string) => void;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Serializer<T = any> = {\n  stringify: (value: T) => string;\n  parse: (value: string) => T;\n};\n\ntype NonPersistentConfig = {\n  /** Whether to persist the state of the store. */\n  persist?: false;\n};\n\ntype PersistentConfig<TState extends object> = {\n  /** Whether to persist the state of the store. */\n  persist: true;\n  /** The unique key used to identify this store in storage. */\n  key: string;\n  /** The storage to use for persisting the state. Defaults to local storage if available. */\n  storage?: StorageAPI;\n  /** The serializer to use for storing the state. Defaults to JSON. */\n  serializer?: Serializer<TState>;\n};\n\nexport type StoreConfig<\n  TState extends object,\n  TActions extends object,\n> = BaseConfig<TState, TActions> &\n  (NonPersistentConfig | PersistentConfig<TState>);\n\n/**\n * Creates a store with an initial state and actions that can modify the state.\n *\n * @param {StoreConfig<TState, TActions>} [config] - The configuration for the store.\n *\n * @returns {Store<TState, TActions>} The created store with state management methods.\n *\n * @example\n * Basic usage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * @example\n * With event handlers:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import { State } from \"./types\";\n *\n * const initialState: State = { data: null, loading: true, error: null };\n *\n * const store = createStore({\n *   initialState,\n *   onAttach: async ({ set }) => {\n *     try {\n *       const response = await fetch(\"https://api.example.com/data\");\n *       const data = await response.json();\n *       set({ data, loading: false });\n *     } catch (error) {\n *       set({ error, loading: false });\n *     }\n *   },\n *   onDetach: ({ reset }) => reset(),\n * });\n * ```\n *\n * @example\n * Persistent store (uses local storage by default):\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).\n * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).\n *\n * @example\n * With superjson serialization and session storage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import superjson from \"superjson\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   serializer: superjson,\n *   storage: sessionStorage,\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n */\nexport const createStore = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n): Store<TState, TActions> => {\n  const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } =\n    config;\n\n  let state = initialState;\n\n  const get = () => state;\n\n  const setSilently = (stateModifier: StateModifier<TState>) => {\n    state = merge(state, stateModifier);\n    return state;\n  };\n\n  const set = (stateModifier: StateModifier<TState>) => {\n    setSilently(stateModifier);\n    dispatch();\n    return state;\n  };\n\n  const resetSilently = () => setSilently(initialState);\n\n  const reset = () => {\n    resetSilently();\n    dispatch();\n    return state;\n  };\n\n  const listeners = new Set<Listener<TState>>();\n  const actions = defineActions\n    ? defineActions({ set, get, reset })\n    : ({} as TActions);\n  const IS_BROWSER = typeof window !== \"undefined\";\n  const persistHandler = getPersistHandler(config, IS_BROWSER, get, set);\n\n  const subscribe = (listener: Listener<TState>) => {\n    if (listeners.size === 0) {\n      onAttach?.({ state, set, reset });\n      persistHandler?.updateState();\n\n      if (IS_BROWSER && persistHandler) {\n        window.addEventListener(\"focus\", persistHandler.updateState);\n      }\n    }\n\n    listener(state);\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        onDetach?.({ state, set, reset });\n\n        if (IS_BROWSER && persistHandler) {\n          window.removeEventListener(\"focus\", persistHandler.updateState);\n        }\n      }\n    };\n  };\n\n  const dispatch = () => {\n    onChange?.({\n      state,\n      set: setSilently,\n      reset: resetSilently,\n    });\n    persistHandler?.updateSnapshot(state);\n    listeners.forEach((listener) => listener(state));\n  };\n\n  onLoad?.({ state, set, reset });\n  persistHandler?.initializeSnapshots();\n\n  return {\n    get,\n    set,\n    reset,\n    subscribe,\n    actions,\n  };\n};\n"],"names":[],"mappings":";;;AAqGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFG;AACI,MAAM,WAAW,GAAG,CAIzB,MAAqC,KACV;AAC3B,IAAA,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACzE,MAAM;IAER,IAAI,KAAK,GAAG,YAAY;AAExB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK;AAEvB,IAAA,MAAM,WAAW,GAAG,CAAC,aAAoC,KAAI;AAC3D,QAAA,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC;AACnC,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,aAAoC,KAAI;QACnD,WAAW,CAAC,aAAa,CAAC;AAC1B,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC;IAErD,MAAM,KAAK,GAAG,MAAK;AACjB,QAAA,aAAa,EAAE;AACf,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;IAC7C,MAAM,OAAO,GAAG;UACZ,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;UAChC,EAAe;AACpB,IAAA,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW;AAChD,IAAA,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;AAEtE,IAAA,MAAM,SAAS,GAAG,CAAC,QAA0B,KAAI;AAC/C,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;YACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACjC,cAAc,EAAE,WAAW,EAAE;AAE7B,YAAA,IAAI,UAAU,IAAI,cAAc,EAAE;gBAChC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;YAC9D;QACF;QAEA,QAAQ,CAAC,KAAK,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;gBACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAEjC,gBAAA,IAAI,UAAU,IAAI,cAAc,EAAE;oBAChC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;gBACjE;YACF;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,QAAQ,GAAG;YACT,KAAK;AACL,YAAA,GAAG,EAAE,WAAW;AAChB,YAAA,KAAK,EAAE,aAAa;AACrB,SAAA,CAAC;AACF,QAAA,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC;AACrC,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,IAAA,CAAC;IAED,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE,mBAAmB,EAAE;IAErC,OAAO;QACL,GAAG;QACH,GAAG;QACH,KAAK;QACL,SAAS;QACT,OAAO;KACR;AACH;;;;"}
+{"version":3,"file":"createStore.js","sources":["../../../src/lib/createStore.ts"],"sourcesContent":["import { getPersistHandler } from \"./getPersistHandler\";\nimport { merge } from \"./merge\";\n\nexport type Listener<TState extends object> = (state: TState) => void;\n\nexport type SetState<TState extends object> = (\n  stateModifier: StateModifier<TState>,\n) => TState;\n\nexport type Store<TState extends object, TActions extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n  /** Actions that can modify the state of the store. */\n  actions: TActions;\n  /** Subscribes to changes in the state of the store. Returns an unsubscribe function. */\n  subscribe: (listener: Listener<TState>) => () => void;\n};\n\nexport type StoreEventContext<TState extends object> = {\n  /** The current state of the store. */\n  state: TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type StoreEventHandler<TState extends object> = (\n  context: StoreEventContext<TState>,\n) => void;\n\nexport type StateModifier<TState extends object> =\n  | Partial<TState>\n  | ((state: TState) => Partial<TState>);\n\nexport type StateHandler<TState extends object> = {\n  /** Returns the current state of the store. */\n  get: () => TState;\n  /** Sets the state of the store. */\n  set: SetState<TState>;\n  /** Resets the state of the store to its initial value. */\n  reset: () => TState;\n};\n\nexport type DefineActions<TState extends object, TActions> = (\n  stateHandler: StateHandler<TState>,\n) => TActions;\n\nexport type BaseConfig<TState extends object, TActions extends object> = {\n  /** The initial state of the store. */\n  initialState: TState;\n  /** A function that defines actions that can modify the state. */\n  defineActions?: DefineActions<TState, TActions>;\n  /** Invoked when the store is created. */\n  onLoad?: StoreEventHandler<TState>;\n  /** Invoked when the store is subscribed to. */\n  onAttach?: StoreEventHandler<TState>;\n  /** Invoked when the store is unsubscribed from. */\n  onDetach?: StoreEventHandler<TState>;\n  /** Invoked whenever the state changes. */\n  onChange?: StoreEventHandler<TState>;\n};\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport type StorageAPI = {\n  getItem: (key: string) => MaybePromise<string | null>;\n  setItem: (key: string, value: string) => MaybePromise<void>;\n  removeItem: (key: string) => MaybePromise<void>;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Serializer<T = any> = {\n  stringify: (value: T) => string;\n  parse: (value: string) => T;\n};\n\nexport type NoPersistConfig = {\n  /** Whether to persist the state of the store. */\n  persist?: false;\n};\n\nexport type PersistConfig<TState extends object> = {\n  /** Whether to persist the state of the store. */\n  persist: true;\n  /** The unique key used to identify this store in storage. */\n  key: string;\n  /** The storage to use for persisting the state. Defaults to local storage if available. */\n  storage?: StorageAPI;\n  /** The serializer to use for storing the state. Defaults to JSON. */\n  serializer?: Serializer<TState>;\n};\n\nexport type StoreConfig<\n  TState extends object,\n  TActions extends object,\n> = BaseConfig<TState, TActions> & (PersistConfig<TState> | NoPersistConfig);\n\n/**\n * Creates a store with an initial state and actions that can modify the state.\n *\n * @param {StoreConfig<TState, TActions>} [config] - The configuration for the store.\n *\n * @returns {Store<TState, TActions>} The created store with state management methods.\n *\n * @example\n * Basic usage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * @example\n * With event handlers:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import { State } from \"./types\";\n *\n * const initialState: State = { data: null, loading: true, error: null };\n *\n * const store = createStore({\n *   initialState,\n *   onAttach: async ({ set }) => {\n *     try {\n *       const response = await fetch(\"https://api.example.com/data\");\n *       const data = await response.json();\n *       set({ data, loading: false });\n *     } catch (error) {\n *       set({ error, loading: false });\n *     }\n *   },\n *   onDetach: ({ reset }) => reset(),\n * });\n * ```\n *\n * @example\n * Persistent store (uses local storage by default):\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).\n * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).\n *\n * @example\n * With superjson serialization and session storage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import superjson from \"superjson\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   serializer: superjson,\n *   storage: sessionStorage,\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n */\nexport const createStore = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n): Store<TState, TActions> => {\n  const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } =\n    config;\n\n  let state = initialState;\n\n  const get = () => state;\n\n  const setSilently = (stateModifier: StateModifier<TState>) => {\n    state = merge(state, stateModifier);\n    return state;\n  };\n\n  const set = (stateModifier: StateModifier<TState>) => {\n    setSilently(stateModifier);\n    dispatch();\n    return state;\n  };\n\n  const resetSilently = () => setSilently(initialState);\n\n  const reset = () => {\n    resetSilently();\n    dispatch();\n    return state;\n  };\n\n  const listeners = new Set<Listener<TState>>();\n  const actions = defineActions\n    ? defineActions({ set, get, reset })\n    : ({} as TActions);\n  const IS_BROWSER = typeof window !== \"undefined\";\n  const persistHandler = getPersistHandler(config, IS_BROWSER, get, set);\n\n  const subscribe = (listener: Listener<TState>) => {\n    if (listeners.size === 0) {\n      onAttach?.({ state, set, reset });\n      persistHandler?.updateState();\n\n      if (IS_BROWSER && persistHandler) {\n        window.addEventListener(\"focus\", persistHandler.updateState);\n      }\n    }\n\n    listener(state);\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        onDetach?.({ state, set, reset });\n\n        if (IS_BROWSER && persistHandler) {\n          window.removeEventListener(\"focus\", persistHandler.updateState);\n        }\n      }\n    };\n  };\n\n  const dispatch = () => {\n    onChange?.({\n      state,\n      set: setSilently,\n      reset: resetSilently,\n    });\n    persistHandler?.updateSnapshot(state);\n    listeners.forEach((listener) => listener(state));\n  };\n\n  onLoad?.({ state, set, reset });\n  persistHandler?.initializeSnapshots();\n\n  return {\n    get,\n    set,\n    reset,\n    subscribe,\n    actions,\n  };\n};\n"],"names":[],"mappings":";;;AAsGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFG;AACI,MAAM,WAAW,GAAG,CAIzB,MAAqC,KACV;AAC3B,IAAA,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACzE,MAAM;IAER,IAAI,KAAK,GAAG,YAAY;AAExB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK;AAEvB,IAAA,MAAM,WAAW,GAAG,CAAC,aAAoC,KAAI;AAC3D,QAAA,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC;AACnC,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,aAAoC,KAAI;QACnD,WAAW,CAAC,aAAa,CAAC;AAC1B,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC;IAErD,MAAM,KAAK,GAAG,MAAK;AACjB,QAAA,aAAa,EAAE;AACf,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;IAC7C,MAAM,OAAO,GAAG;UACZ,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;UAChC,EAAe;AACpB,IAAA,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW;AAChD,IAAA,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;AAEtE,IAAA,MAAM,SAAS,GAAG,CAAC,QAA0B,KAAI;AAC/C,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;YACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACjC,cAAc,EAAE,WAAW,EAAE;AAE7B,YAAA,IAAI,UAAU,IAAI,cAAc,EAAE;gBAChC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;YAC9D;QACF;QAEA,QAAQ,CAAC,KAAK,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;gBACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAEjC,gBAAA,IAAI,UAAU,IAAI,cAAc,EAAE;oBAChC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC;gBACjE;YACF;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,QAAQ,GAAG;YACT,KAAK;AACL,YAAA,GAAG,EAAE,WAAW;AAChB,YAAA,KAAK,EAAE,aAAa;AACrB,SAAA,CAAC;AACF,QAAA,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC;AACrC,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,IAAA,CAAC;IAED,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE,mBAAmB,EAAE;IAErC,OAAO;QACL,GAAG;QACH,GAAG;QACH,KAAK;QACL,SAAS;QACT,OAAO;KACR;AACH;;;;"}

package/dist/esm/lib/getPersistHandler.d.ts

@@ -1,6 +1,6 @@
 import { SetState, StoreConfig } from "./createStore";
 export declare const getPersistHandler: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>, isBrowser: boolean, get: () => TState, set: SetState<TState>) => {
-    initializeSnapshots: () => void;
-    updateSnapshot: (newState: TState) => void;
-    updateState: () => void;
+    initializeSnapshots: () => Promise<void>;
+    updateSnapshot: (newState: TState) => Promise<void>;
+    updateState: () => Promise<void>;
 } | null;

package/dist/esm/lib/getPersistHandler.js

@@ -1,32 +1,59 @@
+import { warn } from './warn.js';
+
 const getPersistHandler = (config, isBrowser, get, set) => {
     if (!config.persist) {
         return null;
     }
     const storage = config.storage ?? (isBrowser ? localStorage : undefined);
     if (!storage) {
+        warn("No storage provider found. If this happened during SSR, you can safely ignore this warning.");
         return null;
     }
     const { key, serializer = JSON, initialState } = config;
     const initKey = `init_${key}`;
-    const initializeSnapshots = () => {
-        const initialStateSnapshot = storage.getItem(initKey);
-        const initialStateString = serializer.stringify(initialState);
-        if (initialStateSnapshot !== initialStateString) {
-            storage.setItem(initKey, initialStateString);
-            storage.removeItem(key);
+    const initializeSnapshots = async () => {
+        try {
+            let initialStateSnapshot = storage.getItem(initKey);
+            const initialStateString = serializer.stringify(initialState);
+            if (initialStateSnapshot instanceof Promise) {
+                initialStateSnapshot = await initialStateSnapshot;
+            }
+            if (initialStateSnapshot !== initialStateString) {
+                storage.setItem(initKey, initialStateString);
+                storage.removeItem(key);
+            }
+        }
+        catch {
+            warn("Failed to initialize snapshots. If this happened during SSR, you can safely ignore this warning.");
         }
     };
-    const updateSnapshot = (newState) => {
-        const currentSnapshot = storage.getItem(key);
-        const newSnapshot = serializer.stringify(newState);
-        if (newSnapshot !== currentSnapshot) {
-            storage.setItem(key, newSnapshot);
+    const updateSnapshot = async (newState) => {
+        try {
+            let currentSnapshot = storage.getItem(key);
+            const newSnapshot = serializer.stringify(newState);
+            if (currentSnapshot instanceof Promise) {
+                currentSnapshot = await currentSnapshot;
+            }
+            if (newSnapshot !== currentSnapshot) {
+                storage.setItem(key, newSnapshot);
+            }
+        }
+        catch {
+            warn("Failed to update snapshot");
         }
     };
-    const updateState = () => {
-        const currentSnapshot = storage.getItem(key);
-        if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {
-            set(serializer.parse(currentSnapshot));
+    const updateState = async () => {
+        try {
+            let currentSnapshot = storage.getItem(key);
+            if (currentSnapshot instanceof Promise) {
+                currentSnapshot = await currentSnapshot;
+            }
+            if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {
+                set(serializer.parse(currentSnapshot));
+            }
+        }
+        catch {
+            warn("Failed to update state from snapshot");
         }
     };
     return {

package/dist/esm/lib/getPersistHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPersistHandler.js","sources":["../../../src/lib/getPersistHandler.ts"],"sourcesContent":["import { SetState, StoreConfig } from \"./createStore\";\n\nexport const getPersistHandler = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n  isBrowser: boolean,\n  get: () => TState,\n  set: SetState<TState>,\n) => {\n  if (!config.persist) {\n    return null;\n  }\n\n  const storage = config.storage ?? (isBrowser ? localStorage : undefined);\n\n  if (!storage) {\n    return null;\n  }\n\n  const { key, serializer = JSON, initialState } = config;\n  const initKey = `init_${key}`;\n\n  const initializeSnapshots = () => {\n    const initialStateSnapshot = storage.getItem(initKey);\n    const initialStateString = serializer.stringify(initialState);\n\n    if (initialStateSnapshot !== initialStateString) {\n      storage.setItem(initKey, initialStateString);\n      storage.removeItem(key);\n    }\n  };\n\n  const updateSnapshot = (newState: TState) => {\n    const currentSnapshot = storage.getItem(key);\n    const newSnapshot = serializer.stringify(newState);\n\n    if (newSnapshot !== currentSnapshot) {\n      storage.setItem(key, newSnapshot);\n    }\n  };\n\n  const updateState = () => {\n    const currentSnapshot = storage.getItem(key);\n\n    if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {\n      set(serializer.parse(currentSnapshot));\n    }\n  };\n\n  return {\n    initializeSnapshots,\n    updateSnapshot,\n    updateState,\n  };\n};\n"],"names":[],"mappings":"AAEO,MAAM,iBAAiB,GAAG,CAI/B,MAAqC,EACrC,SAAkB,EAClB,GAAiB,EACjB,GAAqB,KACnB;AACF,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAExE,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,OAAO,IAAI;IACb;IAEA,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM;AACvD,IAAA,MAAM,OAAO,GAAG,CAAA,KAAA,EAAQ,GAAG,EAAE;IAE7B,MAAM,mBAAmB,GAAG,MAAK;QAC/B,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACrD,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;AAE7D,QAAA,IAAI,oBAAoB,KAAK,kBAAkB,EAAE;AAC/C,YAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC;AAC5C,YAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACzB;AACF,IAAA,CAAC;AAED,IAAA,MAAM,cAAc,GAAG,CAAC,QAAgB,KAAI;QAC1C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;QAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;AAElD,QAAA,IAAI,WAAW,KAAK,eAAe,EAAE;AACnC,YAAA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;QACnC;AACF,IAAA,CAAC;IAED,MAAM,WAAW,GAAG,MAAK;QACvB,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAE5C,QAAA,IAAI,eAAe,IAAI,eAAe,KAAK,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE;YACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACxC;AACF,IAAA,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,cAAc;QACd,WAAW;KACZ;AACH;;;;"}
+{"version":3,"file":"getPersistHandler.js","sources":["../../../src/lib/getPersistHandler.ts"],"sourcesContent":["import { SetState, StorageAPI, StoreConfig } from \"./createStore\";\nimport { warn } from \"./warn\";\n\nexport const getPersistHandler = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n  isBrowser: boolean,\n  get: () => TState,\n  set: SetState<TState>,\n) => {\n  if (!config.persist) {\n    return null;\n  }\n\n  const storage =\n    config.storage ?? (isBrowser ? (localStorage as StorageAPI) : undefined);\n\n  if (!storage) {\n    warn(\n      \"No storage provider found. If this happened during SSR, you can safely ignore this warning.\",\n    );\n    return null;\n  }\n\n  const { key, serializer = JSON, initialState } = config;\n  const initKey = `init_${key}`;\n\n  const initializeSnapshots = async () => {\n    try {\n      let initialStateSnapshot = storage.getItem(initKey);\n      const initialStateString = serializer.stringify(initialState);\n\n      if (initialStateSnapshot instanceof Promise) {\n        initialStateSnapshot = await initialStateSnapshot;\n      }\n\n      if (initialStateSnapshot !== initialStateString) {\n        storage.setItem(initKey, initialStateString);\n        storage.removeItem(key);\n      }\n    } catch {\n      warn(\n        \"Failed to initialize snapshots. If this happened during SSR, you can safely ignore this warning.\",\n      );\n    }\n  };\n\n  const updateSnapshot = async (newState: TState) => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n      const newSnapshot = serializer.stringify(newState);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (newSnapshot !== currentSnapshot) {\n        storage.setItem(key, newSnapshot);\n      }\n    } catch {\n      warn(\"Failed to update snapshot\");\n    }\n  };\n\n  const updateState = async () => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {\n        set(serializer.parse(currentSnapshot));\n      }\n    } catch {\n      warn(\"Failed to update state from snapshot\");\n    }\n  };\n\n  return {\n    initializeSnapshots,\n    updateSnapshot,\n    updateState,\n  };\n};\n"],"names":[],"mappings":";;AAGO,MAAM,iBAAiB,GAAG,CAI/B,MAAqC,EACrC,SAAkB,EAClB,GAAiB,EACjB,GAAqB,KACnB;AACF,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,KAAK,SAAS,GAAI,YAA2B,GAAG,SAAS,CAAC;IAE1E,IAAI,CAAC,OAAO,EAAE;QACZ,IAAI,CACF,6FAA6F,CAC9F;AACD,QAAA,OAAO,IAAI;IACb;IAEA,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM;AACvD,IAAA,MAAM,OAAO,GAAG,CAAA,KAAA,EAAQ,GAAG,EAAE;AAE7B,IAAA,MAAM,mBAAmB,GAAG,YAAW;AACrC,QAAA,IAAI;YACF,IAAI,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YACnD,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;AAE7D,YAAA,IAAI,oBAAoB,YAAY,OAAO,EAAE;gBAC3C,oBAAoB,GAAG,MAAM,oBAAoB;YACnD;AAEA,YAAA,IAAI,oBAAoB,KAAK,kBAAkB,EAAE;AAC/C,gBAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC;AAC5C,gBAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB;QACF;AAAE,QAAA,MAAM;YACN,IAAI,CACF,kGAAkG,CACnG;QACH;AACF,IAAA,CAAC;AAED,IAAA,MAAM,cAAc,GAAG,OAAO,QAAgB,KAAI;AAChD,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;AAElD,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,WAAW,KAAK,eAAe,EAAE;AACnC,gBAAA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;YACnC;QACF;AAAE,QAAA,MAAM;YACN,IAAI,CAAC,2BAA2B,CAAC;QACnC;AACF,IAAA,CAAC;AAED,IAAA,MAAM,WAAW,GAAG,YAAW;AAC7B,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAE1C,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,eAAe,IAAI,eAAe,KAAK,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE;gBACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACxC;QACF;AAAE,QAAA,MAAM;YACN,IAAI,CAAC,sCAAsC,CAAC;QAC9C;AACF,IAAA,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,cAAc;QACd,WAAW;KACZ;AACH;;;;"}

package/dist/esm/lib/warn.d.ts

@@ -0,0 +1 @@
+export declare const warn: (message: string) => void;

package/dist/esm/lib/warn.js

@@ -0,0 +1,4 @@
+const warn = (message) => console.warn(`[dharma-core] ${message}`);
+
+export { warn };
+//# sourceMappingURL=warn.js.map

package/dist/esm/lib/warn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn.js","sources":["../../../src/lib/warn.ts"],"sourcesContent":["export const warn = (message: string) =>\n  console.warn(`[dharma-core] ${message}`);\n"],"names":[],"mappings":"AAAO,MAAM,IAAI,GAAG,CAAC,OAAe,KAClC,OAAO,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAA,CAAE;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dharma-core",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "author": "Frans Ekman <fransedvinekman@gmail.com>",
   "license": "MIT",
   "description": "My package description",
@@ -45,6 +45,9 @@
   "publishConfig": {
     "provenance": true
   },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^2.2.0"
+  },
   "scripts": {
     "build": "rm -rf dist && rollup -c",
     "dev": "rollup -c -w",