@plq/use-persisted-state 1.3.0 → 1.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017 Uploadcare
+Copyright (c) 2019 Alexander Kurganov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,21 +1,37 @@
 # usePersistedState
+
 [![npm version](https://badge.fury.io/js/@plq%2Fuse-persisted-state.svg)](https://www.npmjs.com/package/@plq/use-persisted-state)
-[![Tests](https://github.com/Akurganow/use-persisted-state/actions/workflows/main.yml/badge.svg?branch=master)](https://github.com/Akurganow/use-persisted-state/actions/workflows/main.yml)
+[![Tests](https://github.com/Akurganow/use-persisted-state/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/Akurganow/use-persisted-state/actions/workflows/main.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-support-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/akurganow)
 
-Persists the state to localStorage, sessionStorage or any custom storage
+A React `useState` that persists to `localStorage`, `sessionStorage`, extension storage (`browser.storage` / `chrome.storage`), or any custom backend.
 
 ## Features
 
-- Persist the state to `localStorage`, `sessionStorage` or almost anything else implements [storage API](https://github.com/Akurganow/use-persisted-state/blob/master/docs/storage-api.md)
-- The state factory takes as many keys as needed, so you don't have to call the factory for each variable
-- Written with the TypeScript, the definitions go with the library
-- No third-party dependencies
+- Persist state to `localStorage`, `sessionStorage`, extension storage, or almost anything else that implements the [storage API](https://github.com/Akurganow/use-persisted-state/blob/main/docs/storage-api.md)
+- One state factory serves as many keys as needed, so you don't have to call the factory for each variable
+- Supports both synchronous and asynchronous storage backends
+- Components using the same key stay in sync; with the `localStorage` adapter, changes also propagate across browser tabs
+- Written in TypeScript — type definitions ship with the package
+- A single tiny runtime dependency: [`@plq/is`](https://www.npmjs.com/package/@plq/is)
+
+## Requirements
+
+To use `@plq/use-persisted-state`, you must use `react@16.8.0` or greater, which includes Hooks.
+The library is tested against React 19. The peer range allows React 16.8 and above, though only 19 is exercised in CI.
 
-## Example
+## Install
+
+```sh
+npm install @plq/use-persisted-state
+```
+
+## Quick start
 
 ```jsx
 import createPersistedState from '@plq/use-persisted-state'
-import storage from '@plq/use-persisted-state/lib/storages/local-storage'
+import storage from '@plq/use-persisted-state/storages/local-storage'
 
 const [usePersistedState] = createPersistedState('example', storage)
 
@@ -32,25 +48,64 @@ export default function App() {
 }
 ```
 
-[![Edit @plq/use-persisted-state](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/plquse-persisted-state-ob2od?fontsize=14)
+This example uses the bundled `localStorage` adapter; [Storage adapters](#storage-adapters) lists the rest and what each one is for.
+
+To try it locally, run the demo app from a repository checkout: `npm ci && npm run demo`.
+
+## API
+
+### `createPersistedState(name, storage)` — default export
+
+```ts
+const [usePersistedState, clear] = createPersistedState(name, storage)
+```
+
+- `name` — a namespace for this factory. All keys created by the returned hook are stored together in a single storage entry named `persisted_state_hook:<name>`.
+- `storage` — a synchronous or asynchronous storage backend implementing the [storage API](https://github.com/Akurganow/use-persisted-state/blob/main/docs/storage-api.md).
+
+Returns a `[usePersistedState, clear]` tuple. The default export detects whether the backend is asynchronous from the shape of its methods wherever it can — a `get` declared `async` settles the question without a call. Only when that does not hold does it call `get('')` once, as a method of your storage, to see whether the result is a `Promise`; `set` and `remove` are never invoked, so detection cannot write to your storage. All three members must be functions. If even a read during setup is undesirable, import one of the named factories below instead — they skip detection entirely.
+
+### Named factories
+
+```ts
+import { createPersistedState, createAsyncPersistedState } from '@plq/use-persisted-state'
+```
+
+- `createPersistedState(name, storage)` — for synchronous backends only (`localStorage`, `sessionStorage`).
+- `createAsyncPersistedState(name, storage)` — for asynchronous backends only (`browser.storage`, `chrome.storage`, custom promise-based backends).
 
-## Requirement
-To use `@plq/use-persisted-state`, you must use `react@16.8.0` or greater which includes Hooks.
-The library is fully compatible with React 18 and React 19.
+### `usePersistedState(key, initialValue)`
 
-## React 19 Compatibility
+```ts
+const [state, setState] = usePersistedState(key, initialValue)
+```
+
+Works like `useState`: returns the current state and a setter that accepts either a value or an updater function (`prev => next`). In addition, every update is written to the storage backend, and external changes to the stored value update the state.
+
+- Values are serialized with `JSON.stringify`, so they must be JSON-serializable (no functions, class instances, `Map`, `Set`, etc.). A few values serialize into something else rather than failing outright — see [Values JSON cannot carry](#values-json-cannot-carry).
+- With an asynchronous backend, the hook renders `initialValue` first and updates once the stored value has loaded.
+
+### `clear()`
+
+Removes the factory's whole storage entry. Hooks created by that factory fall back to their initial values. Returns `void` for synchronous backends and `Promise<void>` for asynchronous ones.
+
+### TypeScript
+
+The package ships its own type definitions. The storage contract and the hook's own types are exported from the entry point:
+
+```ts
+import type { Storage, AsyncStorage, StorageChange, StorageChangeListener } from '@plq/use-persisted-state'
+```
 
-This library is fully compatible with React 19 and supports all new features:
-- Works seamlessly with `useTransition` for performance optimization
-- Compatible with `useActionState` for form handling
-- Supports `useOptimistic` for optimistic updates
+`Storage` and `AsyncStorage` are the two backend contracts. `StorageChange`, `StorageChangeListener` and `StorageChangeEvent` describe the `onChanged` event an adapter provides. `PersistedState` and `UsePersistedState` type the hook and the tuple it returns.
 
-Check out our [React 19 examples](./demo/src/examples/) to see these features in action!
+The longer `@plq/use-persisted-state/lib/@types/storage` path that earlier versions documented continues to work and resolves to the same types. Prefer the entry point: `lib/` is kept open for compatibility only.
+
+## Clear storage
 
-## Clear Storage
 ```jsx
 import createPersistedState from '@plq/use-persisted-state'
-import storage from '@plq/use-persisted-state/lib/storages/local-storage'
+import storage from '@plq/use-persisted-state/storages/local-storage'
 
 const [usePersistedState, clear] = createPersistedState('example', storage)
 
@@ -67,44 +122,36 @@ export default function App() {
   )
 }
 ```
+
 ## Use sessionStorage
+
 ```jsx
 import createPersistedState from '@plq/use-persisted-state'
-import storage from '@plq/use-persisted-state/lib/storages/session-storage'
+import storage from '@plq/use-persisted-state/storages/session-storage'
 
 const [usePersistedState, clear] = createPersistedState('example', storage)
 ```
+
 ## Use async storage
+
 ```jsx
 import createPersistedState from '@plq/use-persisted-state'
-// or
+// or, to skip async detection:
 import { createAsyncPersistedState } from '@plq/use-persisted-state'
-import { local } from '@plq/use-persisted-state/lib/storages/browser-storage'
+import { local } from '@plq/use-persisted-state/storages/browser-storage'
 
 const [usePersistedState, clear] = createPersistedState('example', local)
 ```
+
 ## Use custom storage
 
-The [storage API](https://github.com/Akurganow/use-persisted-state/blob/master/docs/storage-api.md) is similar to the browser.storage but with a few differences
+The [storage API](https://github.com/Akurganow/use-persisted-state/blob/main/docs/storage-api.md) is similar to the WebExtensions `browser.storage` API, with a few differences. Any object implementing it works:
 
 ```jsx
 import createPersistedState from '@plq/use-persisted-state'
 
 const storageListeners = new Set()
 
-onChangeSomeStorage(event => {
-  const changes = {
-    [event.key]: {
-      newValue: event.newValue,
-      oldValue: event.oldValue,
-    },
-  }
-
-  listeners.forEach(listener => {
-    listener(changes)
-  })
-})
-
 const myStorage = {
   get: keys => getItemsFromSomeStorage(keys),
   set: items => setItemsToSomeStorage(items),
@@ -113,21 +160,89 @@ const myStorage = {
     addListener: listener => storageListeners.add(listener),
     removeListener: listener => storageListeners.delete(listener),
     hasListener: listener => storageListeners.has(listener),
-  }
+  },
 }
 
 const [usePersistedState, clear] = createPersistedState('example', myStorage)
 ```
+
+Your adapter owns that listener set and calls every listener when the backing store changes, which is what keeps components on the same key in sync. The [storage API](https://github.com/Akurganow/use-persisted-state/blob/main/docs/storage-api.md) documents the change payload and carries the complete example, including how to forward a backend's own events to the listeners.
+
 ## Storage adapters
-### [localStorage](https://developer.mozilla.org/docs/Web/API/Window/localStorage) `@plq/use-persisted-state/lib/storages/local-storage`
-  - Useful for average web application
-### [sessionStorage](https://developer.mozilla.org/docs/Web/API/Window/sessionStorage) `@plq/use-persisted-state/lib/storages/session-storage`
-  - Useful for average web application
-### [browser.storage](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/storage) `@plq/use-persisted-state/lib/storages/browser-storage`
-  - Only for web extensions.
-  - Don't forget to set up [polyfill](https://github.com/mozilla/webextension-polyfill) if you want to run extension in Chrome browser.
-  - To use this storage you need to include the "storage" [permission](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) in your `manifest.json` file
-### [chrome.storage](https://developer.chrome.com/apps/storage) `@plq/use-persisted-state/lib/storages/chrome-storage`
-  - Only for Chrome-based web extensions.
-  - If you develop extension that will be run only in Chrome browser you can use this storage without [polyfill](https://github.com/mozilla/webextension-polyfill).
-  - You must declare the "storage" permission in the [extension manifest](https://developer.chrome.com/apps/manifest) to use this storage.
+
+The longer `@plq/use-persisted-state/lib/storages/…` paths that earlier versions documented continue
+to work. Prefer the shorter ones below: imported from ES module code, the `lib` path hands back the
+CommonJS exports object rather than the adapter, so it needs an extra `.default` that the shorter
+path does not.
+
+### [localStorage](https://developer.mozilla.org/docs/Web/API/Window/localStorage) `@plq/use-persisted-state/storages/local-storage`
+
+- Useful for the average web application.
+- Synchronous. Changes made in other browser tabs are picked up through the [`storage` event](https://developer.mozilla.org/docs/Web/API/Window/storage_event).
+
+### [sessionStorage](https://developer.mozilla.org/docs/Web/API/Window/sessionStorage) `@plq/use-persisted-state/storages/session-storage`
+
+- Useful for state that should not outlive the browser session.
+- Synchronous.
+
+### [browser.storage](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/storage) `@plq/use-persisted-state/storages/browser-storage`
+
+- Only for web extensions. Asynchronous.
+- Named exports for each storage area: `local`, `sync` and `managed` (note that the [managed area](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/storage/managed) is read-only for the extension).
+- Don't forget to set up the [polyfill](https://github.com/mozilla/webextension-polyfill) if you want to run the extension in a Chromium-based browser.
+- You need to declare the "storage" [permission](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) in your `manifest.json` file.
+
+### [chrome.storage](https://developer.chrome.com/docs/extensions/reference/api/storage) `@plq/use-persisted-state/storages/chrome-storage`
+
+- Only for Chromium-based web extensions. Asynchronous.
+- Named exports for each storage area: `local`, `sync` and `managed` (the managed area is read-only for the extension).
+- If your extension runs only in Chromium-based browsers, you can use this adapter without the polyfill.
+- You must declare the "storage" permission in the [extension manifest](https://developer.chrome.com/docs/extensions/reference/manifest) to use this adapter.
+
+```jsx
+import createPersistedState from '@plq/use-persisted-state'
+import { local } from '@plq/use-persisted-state/storages/chrome-storage'
+
+const [usePersistedState, clear] = createPersistedState('example', local)
+```
+
+## Server-side rendering
+
+This library targets browser environments. Two things matter when rendering on a server:
+
+- The bundled `local-storage` and `session-storage` adapters can be imported without `localStorage` / `sessionStorage`. Where the global is missing the adapter reads back nothing and discards every write, so the hook keeps its initial value rather than throwing.
+- The synchronous hook reads from storage during render.
+
+When using an SSR framework (Next.js, Remix, etc.), make sure the components using the hook run only on the client — for example, in client-only components or behind a dynamic import that is disabled during SSR.
+
+## How values are stored
+
+Each factory keeps all of its keys in a single storage entry named `persisted_state_hook:<name>`, holding a JSON object with one property per key:
+
+```
+persisted_state_hook:example → {"count":0}
+```
+
+Storage backends only ever see serialized strings. Anything you persist ends up unencrypted in the underlying storage — do not store secrets or sensitive data (see [SECURITY.md](https://github.com/Akurganow/use-persisted-state/blob/main/SECURITY.md)).
+
+### Values JSON cannot carry
+
+A few values do not survive `JSON.stringify`. This follows from the format rather than from a choice
+the library makes, and no adapter can repair it: once a value has been written, nothing in storage
+tells a `null` you stored apart from a `null` that JSON produced.
+
+- **`undefined`** — the key is dropped, so nothing reaches storage at all. The component that set it
+  keeps `undefined` in memory, as `useState` would, and other components already mounted on that key
+  see no change and keep the value they hold. After a remount or a reload the key is absent, so the
+  initial value comes back.
+- **`NaN`, `Infinity`, `-Infinity`** — these are written as `null`. The component that set the value
+  keeps it until it remounts; every other component on that key reads back `null`, as does any
+  reader after a reload.
+
+## Contributing
+
+Contributions are welcome — see [CONTRIBUTING.md](https://github.com/Akurganow/use-persisted-state/blob/main/CONTRIBUTING.md) for setup, testing and the commit convention, and [CODE_OF_CONDUCT.md](https://github.com/Akurganow/use-persisted-state/blob/main/CODE_OF_CONDUCT.md) for community standards.
+
+## License
+
+[MIT](LICENSE)

package/esm/index.d.mts

@@ -0,0 +1,13 @@
+// Type-level aliases of the build output rather than restated signatures: a
+// copy keeps compiling after src changes and hands ESM consumers stale types
+// while CJS consumers get the current ones.
+export { default, createPersistedState, createAsyncPersistedState } from '../lib/index.js'
+export type {
+  AsyncStorage,
+  PersistedState,
+  Storage,
+  StorageChange,
+  StorageChangeEvent,
+  StorageChangeListener,
+  UsePersistedState,
+} from '../lib/index.js'

package/esm/index.mjs

@@ -0,0 +1,10 @@
+// Hand-written ES module wrapper over the single CJS build. A second compiled
+// ESM copy would duplicate the module-level listener registries, so hooks
+// loaded through one module system would stop seeing writes made through the
+// other. Values are re-exported through property access because Node's named
+// export detection for CJS is heuristic.
+import cjs from '../lib/index.js'
+
+export default cjs.default
+export const createPersistedState = cjs.createPersistedState
+export const createAsyncPersistedState = cjs.createAsyncPersistedState

package/esm/storages/browser-storage.d.mts

@@ -0,0 +1 @@
+export { local, sync, managed } from '../../lib/storages/browser-storage.js'

package/esm/storages/browser-storage.mjs

@@ -0,0 +1,5 @@
+import cjs from '../../lib/storages/browser-storage.js'
+
+export const local = cjs.local
+export const sync = cjs.sync
+export const managed = cjs.managed

package/esm/storages/chrome-storage.d.mts

@@ -0,0 +1 @@
+export { local, sync, managed } from '../../lib/storages/chrome-storage.js'

package/esm/storages/chrome-storage.mjs

@@ -0,0 +1,5 @@
+import cjs from '../../lib/storages/chrome-storage.js'
+
+export const local = cjs.local
+export const sync = cjs.sync
+export const managed = cjs.managed

package/esm/storages/local-storage.d.mts

@@ -0,0 +1 @@
+export { default } from '../../lib/storages/local-storage.js'

package/esm/storages/local-storage.mjs

@@ -0,0 +1,3 @@
+import cjs from '../../lib/storages/local-storage.js'
+
+export default cjs.default

package/esm/storages/session-storage.d.mts

@@ -0,0 +1 @@
+export { default } from '../../lib/storages/session-storage.js'

package/esm/storages/session-storage.mjs

@@ -0,0 +1,3 @@
+import cjs from '../../lib/storages/session-storage.js'
+
+export default cjs.default

package/lib/@types/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/@types/storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,KAAK,IAAI,CAAA;AAEvF,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACtD,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;CACvD;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC5D,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAChD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,SAAS,EAAE,kBAAkB,CAAC;CAC/B"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/@types/storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,KAAK,IAAI,CAAA;AAEvF,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAClD,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACrD,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAA;CACtD;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC3D,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAA;IACzC,SAAS,EAAE,kBAAkB,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAA;IACpE,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,SAAS,EAAE,kBAAkB,CAAA;CAC9B"}

package/lib/create-async-persisted-state.d.ts

@@ -1,4 +1,4 @@
-import { AsyncStorage } from './@types/storage';
-import { PersistedState } from './@types/hook';
+import type { AsyncStorage } from './@types/storage';
+import type { PersistedState } from './@types/hook';
 export default function createAsyncPersistedState<S extends AsyncStorage>(storageKey: string, storage: S): [PersistedState, () => Promise<void>];
 //# sourceMappingURL=create-async-persisted-state.d.ts.map

package/lib/create-async-persisted-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-async-persisted-state.d.ts","sourceRoot":"","sources":["../src/create-async-persisted-state.ts"],"names":[],"mappings":"AAOA,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAC,cAAc,EAAoB,MAAM,eAAe,CAAA;AAE/D,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,CAAC,SAAS,YAAY,EACtE,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,GACT,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAuCvC"}
+{"version":3,"file":"create-async-persisted-state.d.ts","sourceRoot":"","sources":["../src/create-async-persisted-state.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAA;AAEtE,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,CAAC,SAAS,YAAY,EACtE,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,GACT,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAqGvC"}

package/lib/create-async-persisted-state.js

@@ -16,23 +16,73 @@ function createAsyncPersistedState(storageKey, storage) {
     };
     const usePersistedState = (key, initialValue) => {
         const [state, setState] = (0, react_1.useState)(initialValue);
-        const setPersistedState = async (newState) => {
-            const newValue = (0, get_new_value_1.default)(newState, state);
-            setState(newValue);
+        // The setter must resolve updater functions against the last value applied,
+        // not against the one captured by the render that created it. Reading the
+        // render closure collapses updates batched into a single event.
+        const latestValue = (0, react_1.useRef)(state);
+        // Whether anything has already put a value in place. A load that settles after
+        // the caller set one must not revert it, and no signal local to the load can
+        // answer this: the write it loses to happens outside the load entirely.
+        const hasAppliedValue = (0, react_1.useRef)(false);
+        const applyValue = (0, react_1.useCallback)((value) => {
+            latestValue.current = value;
+            hasAppliedValue.current = true;
+            setState(value);
+        }, []);
+        // The exact entry this hook last wrote and has not yet seen reported back.
+        const pendingOwnWrite = (0, react_1.useRef)(null);
+        const setPersistedState = (0, react_1.useCallback)(async (newState) => {
+            const newValue = (0, get_new_value_1.default)(newState, latestValue.current);
+            applyValue(newValue);
             const persistedItem = await storage.get(safeStorageKey);
             const newItem = (0, get_new_item_1.default)(key, persistedItem[safeStorageKey], newValue);
+            // Recorded before the write, because the backend may report it before the
+            // promise settles.
+            pendingOwnWrite.current = newItem;
             await storage.set({ [safeStorageKey]: newItem });
-        };
+        }, [key, applyValue]);
+        // As in `useState`, the value the load falls back to is the one given on the
+        // first render. Later identities of an inline object must not reload, or the
+        // effect re-runs on every render and never settles.
+        const mountInitialValue = (0, react_1.useRef)(initialValue);
+        // Subscribed before the load below, and the order is load-bearing: React runs
+        // effects in declaration order, so reading first would leave an interval
+        // between the read and the subscription in which a write belongs to neither
+        // and is lost. Reading last covers everything written before the subscription
+        // began, and the listener covers everything after.
+        (0, use_storage_handler_1.default)(key, safeStorageKey, applyValue, storage, initialValue, pendingOwnWrite);
         (0, react_1.useEffect)(() => {
-            const setInitialValue = async () => {
-                const persist = await storage.get(safeStorageKey);
-                const persistedState = persist[safeStorageKey];
-                const initialOrPersistedValue = (0, get_persisted_value_1.default)(key, initialValue, persistedState);
-                setState(initialOrPersistedValue);
+            // Two separate questions, and one cell cannot hold both: whether this load
+            // is still the current one, which only the closure it belongs to can answer,
+            // and whether a value has been applied meanwhile, which outlives it. A load
+            // abandoned by a key change would otherwise read the flag its successor had
+            // just set, apply the previous key's value and shut the successor out. The
+            // second question is also what makes subscribing first safe: a value the
+            // listener delivers while the load is in flight is not overwritten by it.
+            let isCancelled = false;
+            hasAppliedValue.current = false;
+            const loadPersistedValue = async () => {
+                try {
+                    const persist = await storage.get(safeStorageKey);
+                    if (isCancelled || hasAppliedValue.current)
+                        return;
+                    applyValue((0, get_persisted_value_1.default)(key, mountInitialValue.current, persist[safeStorageKey]));
+                }
+                catch (err) {
+                    // An extension backend rejects on a quota error or an invalidated
+                    // extension context. Nothing awaits this load, so an unclaimed
+                    // rejection terminates the process on Node 15+ and surfaces as an
+                    // uncaught error in the browser. The initial value is already in
+                    // state, so the mount stands on it and the failure is reported rather
+                    // than swallowed, as the synchronous path reports its own.
+                    console.error("use-persisted-state: Can't read value from storage", err);
+                }
             };
-            setInitialValue();
-        }, [initialValue, key]);
-        (0, use_storage_handler_1.default)(key, safeStorageKey, setState, storage, initialValue);
+            loadPersistedValue();
+            return () => {
+                isCancelled = true;
+            };
+        }, [key, applyValue]);
         return [state, setPersistedState];
     };
     return [usePersistedState, clear];

package/lib/create-async-persisted-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-async-persisted-state.js","sourceRoot":"","sources":["../src/create-async-persisted-state.ts"],"names":[],"mappings":";;;;;AAUA,4CA0CC;AApDD,iCAAgD;AAEhD,sFAA2D;AAC3D,0EAA+C;AAC/C,wEAA6C;AAC7C,sFAA2D;AAK3D,SAAwB,yBAAyB,CAC/C,UAAkB,EAClB,OAAU;IAEV,MAAM,cAAc,GAAG,wBAAwB,UAAU,EAAE,CAAA;IAE3D,MAAM,KAAK,GAAG,GAAkB,EAAE;QAChC,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IACvC,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,CAAI,GAAW,EAAE,YAA2B,EAAwB,EAAE;QAC9F,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAI,YAAY,CAAC,CAAA;QAEnD,MAAM,iBAAiB,GAAG,KAAK,EAAE,QAAiC,EAAiB,EAAE;YACnF,MAAM,QAAQ,GAAG,IAAA,uBAAW,EAAI,QAAQ,EAAE,KAAK,CAAC,CAAA;YAEhD,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAElB,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACvD,MAAM,OAAO,GAAG,IAAA,sBAAU,EAAI,GAAG,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,CAAA;YAE3E,MAAM,OAAO,CAAC,GAAG,CAAC,EAAC,CAAC,cAAc,CAAC,EAAE,OAAO,EAAC,CAAC,CAAA;QAChD,CAAC,CAAA;QAED,IAAA,iBAAS,EAAC,GAAG,EAAE;YACb,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;gBACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;gBACjD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;gBAC9C,MAAM,uBAAuB,GAAG,IAAA,6BAAiB,EAAI,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,CAAA;gBAEvF,QAAQ,CAAC,uBAAuB,CAAC,CAAA;YACnC,CAAC,CAAA;YAED,eAAe,EAAE,CAAA;QACnB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAA;QAEvB,IAAA,6BAAiB,EAAI,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAE1E,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;IACnC,CAAC,CAAA;IAED,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"create-async-persisted-state.js","sourceRoot":"","sources":["../src/create-async-persisted-state.ts"],"names":[],"mappings":"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"}

package/lib/create-persisted-state.d.ts

@@ -1,4 +1,4 @@
-import { Storage } from './@types/storage';
-import { PersistedState } from './@types/hook';
+import type { Storage } from './@types/storage';
+import type { PersistedState } from './@types/hook';
 export default function createPersistedState(storageKey: string, storage: Storage): [PersistedState, () => void];
 //# sourceMappingURL=create-persisted-state.d.ts.map

package/lib/create-persisted-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-persisted-state.d.ts","sourceRoot":"","sources":["../src/create-persisted-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAC,cAAc,EAAoB,MAAM,eAAe,CAAA;AAO/D,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAoC9B"}
+{"version":3,"file":"create-persisted-state.d.ts","sourceRoot":"","sources":["../src/create-persisted-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAA;AAOtE,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAgE/G"}

package/lib/create-persisted-state.js

@@ -14,23 +14,41 @@ function createPersistedState(storageKey, storage) {
     const clear = () => {
         storage.remove(safeStorageKey);
     };
+    const readPersisted = (key, initialValue) => (0, get_persisted_value_1.default)(key, initialValue, storage.get(safeStorageKey)[safeStorageKey]);
     const usePersistedState = (key, initialValue) => {
-        const persist = storage.get(safeStorageKey);
-        const persistedState = persist[safeStorageKey];
-        const initialOrPersistedValue = (0, get_persisted_value_1.default)(key, initialValue, persistedState);
-        const [state, setState] = (0, react_1.useState)(initialOrPersistedValue);
-        const setPersistedState = (newState) => {
-            const newValue = (0, get_new_value_1.default)(newState, state);
-            setState(newValue);
+        // Reading through the initializer keeps the storage out of the render path:
+        // the hook runs on every render of every consuming component, so a re-read is
+        // only warranted when the key it is asked for actually changes.
+        const [state, setState] = (0, react_1.useState)(() => readPersisted(key, initialValue));
+        // The setter must resolve updater functions against the last value applied,
+        // not against the one captured by the render that created it. Reading the
+        // render closure collapses updates batched into a single event.
+        const latestValue = (0, react_1.useRef)(state);
+        const applyValue = (0, react_1.useCallback)((value) => {
+            latestValue.current = value;
+            setState(value);
+        }, []);
+        // A mounted hook handed a different key has to show that key's value before
+        // anything can be written, or the next update stores the previous key's value
+        // under the new key and destroys what was there. Adjusting during render ties
+        // the re-read to the change itself, where an effect would cost a read and a
+        // second render on every mount as well.
+        const renderedKey = (0, react_1.useRef)(key);
+        if (renderedKey.current !== key) {
+            renderedKey.current = key;
+            applyValue(readPersisted(key, initialValue));
+        }
+        // The exact entry this hook last wrote and has not yet seen reported back.
+        const pendingOwnWrite = (0, react_1.useRef)(null);
+        const setPersistedState = (0, react_1.useCallback)((newState) => {
+            const newValue = (0, get_new_value_1.default)(newState, latestValue.current);
+            applyValue(newValue);
             const persistedItem = storage.get(safeStorageKey)[safeStorageKey];
             const newItem = (0, get_new_item_1.default)(key, persistedItem, newValue);
+            pendingOwnWrite.current = newItem;
             storage.set({ [safeStorageKey]: newItem });
-        };
-        (0, react_1.useEffect)(() => {
-            const initialOrPersistedValue = (0, get_persisted_value_1.default)(key, initialValue, persistedState);
-            setState(initialOrPersistedValue);
-        }, [initialValue, key, persistedState]);
-        (0, use_storage_handler_1.default)(key, safeStorageKey, setState, storage, initialValue);
+        }, [key, applyValue]);
+        (0, use_storage_handler_1.default)(key, safeStorageKey, applyValue, storage, initialValue, pendingOwnWrite);
         return [state, setPersistedState];
     };
     return [usePersistedState, clear];

package/lib/create-persisted-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-persisted-state.js","sourceRoot":"","sources":["../src/create-persisted-state.ts"],"names":[],"mappings":";;;;;AAUA,uCAuCC;AAjDD,iCAAgD;AAKhD,sFAA2D;AAC3D,0EAA+C;AAC/C,wEAA6C;AAC7C,sFAA2D;AAE3D,SAAwB,oBAAoB,CAC1C,UAAkB,EAClB,OAAgB;IAEhB,MAAM,cAAc,GAAG,wBAAwB,UAAU,EAAE,CAAA;IAC3D,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IAChC,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,CAAI,GAAW,EAAE,YAAe,EAAwB,EAAE;QAClF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAC3C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;QAC9C,MAAM,uBAAuB,GAAG,IAAA,6BAAiB,EAAI,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,CAAA;QAEvF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAI,uBAAuB,CAAC,CAAA;QAE9D,MAAM,iBAAiB,GAAG,CAAC,QAAiC,EAAQ,EAAE;YACpE,MAAM,QAAQ,GAAG,IAAA,uBAAW,EAAI,QAAQ,EAAE,KAAK,CAAC,CAAA;YAEhD,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAElB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,CAAA;YACjE,MAAM,OAAO,GAAG,IAAA,sBAAU,EAAI,GAAG,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAA;YAE3D,OAAO,CAAC,GAAG,CAAC,EAAC,CAAC,cAAc,CAAC,EAAE,OAAO,EAAC,CAAC,CAAA;QAC1C,CAAC,CAAA;QAED,IAAA,iBAAS,EAAC,GAAG,EAAE;YACb,MAAM,uBAAuB,GAAG,IAAA,6BAAiB,EAAI,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,CAAA;YAEvF,QAAQ,CAAC,uBAAuB,CAAC,CAAA;QACnC,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAA;QAEvC,IAAA,6BAAiB,EAAI,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAE1E,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;IACnC,CAAC,CAAA;IAED,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"create-persisted-state.js","sourceRoot":"","sources":["../src/create-persisted-state.ts"],"names":[],"mappings":";;;;;AAWA,uCAgEC;AA1ED,iCAAqD;AAKrD,sFAA2D;AAC3D,0EAA+C;AAC/C,wEAA6C;AAC7C,sFAA2D;AAE3D,SAAwB,oBAAoB,CAAC,UAAkB,EAAE,OAAgB;IAC/E,MAAM,cAAc,GAAG,wBAAwB,UAAU,EAAE,CAAA;IAC3D,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IAChC,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,CAAI,GAAW,EAAE,YAAe,EAAK,EAAE,CAC3D,IAAA,6BAAiB,EAAI,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,CAAC,CAAA;IAEtF,MAAM,iBAAiB,GAAG,CAAI,GAAW,EAAE,YAAe,EAAwB,EAAE;QAClF,4EAA4E;QAC5E,8EAA8E;QAC9E,gEAAgE;QAChE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAI,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAA;QAE7E,4EAA4E;QAC5E,0EAA0E;QAC1E,gEAAgE;QAChE,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAA;QAEjC,MAAM,UAAU,GAAG,IAAA,mBAAW,EAAC,CAAC,KAAQ,EAAQ,EAAE;YAChD,WAAW,CAAC,OAAO,GAAG,KAAK,CAAA;YAE3B,QAAQ,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC,EAAE,EAAE,CAAC,CAAA;QAEN,4EAA4E;QAC5E,8EAA8E;QAC9E,8EAA8E;QAC9E,4EAA4E;QAC5E,wCAAwC;QACxC,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,GAAG,CAAC,CAAA;QAE/B,IAAI,WAAW,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC;YAChC,WAAW,CAAC,OAAO,GAAG,GAAG,CAAA;YAEzB,UAAU,CAAC,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAA;QAC9C,CAAC;QAED,2EAA2E;QAC3E,MAAM,eAAe,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAA;QAEnD,MAAM,iBAAiB,GAAG,IAAA,mBAAW,EACnC,CAAC,QAAiC,EAAQ,EAAE;YAC1C,MAAM,QAAQ,GAAG,IAAA,uBAAW,EAAI,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;YAE9D,UAAU,CAAC,QAAQ,CAAC,CAAA;YAEpB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,CAAA;YACjE,MAAM,OAAO,GAAG,IAAA,sBAAU,EAAI,GAAG,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAA;YAE3D,eAAe,CAAC,OAAO,GAAG,OAAO,CAAA;YAEjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;QAC5C,CAAC,EACD,CAAC,GAAG,EAAE,UAAU,CAAC,CAClB,CAAA;QAED,IAAA,6BAAiB,EAAI,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;QAE7F,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;IACnC,CAAC,CAAA;IAED,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC"}

package/lib/index.d.ts

@@ -1,7 +1,8 @@
-import { default as createSyncPersistedState } from './create-persisted-state';
-import createAsyncPersistedState from './create-async-persisted-state';
-import { Storage, AsyncStorage } from './@types/storage';
-import { PersistedState } from './@types/hook';
+import type { Storage, AsyncStorage } from './@types/storage';
+import type { PersistedState } from './@types/hook';
 export default function createPersistedState<S extends Storage | AsyncStorage>(name: string, storage: S): [PersistedState, () => void | Promise<void>];
-export { createSyncPersistedState as createPersistedState, createAsyncPersistedState, };
+export { default as createPersistedState } from './create-persisted-state';
+export { default as createAsyncPersistedState } from './create-async-persisted-state';
+export type { AsyncStorage, Storage, StorageChange, StorageChangeEvent, StorageChangeListener } from './@types/storage';
+export type { PersistedState, UsePersistedState } from './@types/hook';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,yBAAyB,MAAM,gCAAgC,CAAA;AAItE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,CAAC,SAAS,OAAO,GAAG,YAAY,EAC3E,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GACT,CAAC,cAAc,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAM9C;AAED,OAAO,EACL,wBAAwB,IAAI,oBAAoB,EAChD,yBAAyB,GAC1B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,CAAC,SAAS,OAAO,GAAG,YAAY,EAC3E,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GACT,CAAC,cAAc,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAM9C;AAED,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAMrF,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACvH,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/lib/index.js

@@ -6,9 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAsyncPersistedState = exports.createPersistedState = void 0;
 exports.default = createPersistedState;
 const create_persisted_state_1 = __importDefault(require("./create-persisted-state"));
-Object.defineProperty(exports, "createPersistedState", { enumerable: true, get: function () { return create_persisted_state_1.default; } });
 const create_async_persisted_state_1 = __importDefault(require("./create-async-persisted-state"));
-exports.createAsyncPersistedState = create_async_persisted_state_1.default;
 const is_async_storage_1 = __importDefault(require("./utils/is-async-storage"));
 function createPersistedState(name, storage) {
     if ((0, is_async_storage_1.default)(storage)) {
@@ -16,4 +14,8 @@ function createPersistedState(name, storage) {
     }
     return (0, create_persisted_state_1.default)(name, storage);
 }
+var create_persisted_state_2 = require("./create-persisted-state");
+Object.defineProperty(exports, "createPersistedState", { enumerable: true, get: function () { return __importDefault(create_persisted_state_2).default; } });
+var create_async_persisted_state_2 = require("./create-async-persisted-state");
+Object.defineProperty(exports, "createAsyncPersistedState", { enumerable: true, get: function () { return __importDefault(create_async_persisted_state_2).default; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAQA,uCASC;AAjBD,sFAA8E;AAoBhD,qGApBV,gCAAwB,OAoBM;AAnBlD,kGAAsE;AAoBpE,oCApBK,sCAAyB,CAoBL;AAlB3B,gFAAqD;AAKrD,SAAwB,oBAAoB,CAC1C,IAAY,EACZ,OAAU;IAEV,IAAI,IAAA,0BAAc,EAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAA,sCAAyB,EAAC,IAAI,EAAE,OAAuB,CAAC,CAAA;IACjE,CAAC;IAED,OAAO,IAAA,gCAAwB,EAAC,IAAI,EAAE,OAAkB,CAAC,CAAA;AAC3D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAQA,uCASC;AAjBD,sFAA+D;AAC/D,kGAAsE;AAEtE,gFAAqD;AAKrD,SAAwB,oBAAoB,CAC1C,IAAY,EACZ,OAAU;IAEV,IAAI,IAAA,0BAAc,EAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAA,sCAAyB,EAAC,IAAI,EAAE,OAAuB,CAAC,CAAA;IACjE,CAAC;IAED,OAAO,IAAA,gCAAwB,EAAC,IAAI,EAAE,OAAkB,CAAC,CAAA;AAC3D,CAAC;AAED,mEAA0E;AAAjE,+IAAA,OAAO,OAAwB;AACxC,+EAAqF;AAA5E,0JAAA,OAAO,OAA6B"}