@plq/use-persisted-state 1.3.0 → 1.4.1

package/lib/utils/create-web-storage.js

@@ -1,92 +1,89 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const listeners = new Set();
-function fireStorageEvent(changes) {
-    listeners.forEach(listener => {
-        listener(changes);
-    });
+const change_notifier_1 = require("./change-notifier");
+const storage_event_router_1 = require("./storage-event-router");
+function toKeyList(keys) {
+    return Array.isArray(keys) ? keys : [keys];
 }
-window.addEventListener('storage', event => {
-    if (event.key) {
-        const changes = {
-            [event.key]: {
-                newValue: event.newValue,
-                oldValue: event.oldValue,
-            },
+/**
+ * Adapts a Web Storage area to the library's `Storage` contract.
+ *
+ * Pass `undefined` where the global is missing, as it is on a server: the
+ * adapter then reads back nothing and **silently discards every write**, so a
+ * consumer keeps its initial value instead of the import throwing. Listeners
+ * are still accepted and reported, they simply never fire.
+ */
+exports.default = (storage) => {
+    // Per-instance notifier: the localStorage and sessionStorage adapters must not
+    // share listeners, or a write to one area notifies subscribers of the other.
+    const notifier = (0, change_notifier_1.createChangeNotifier)();
+    // Only a missing global is inert. Anything else a caller passes has to fail
+    // on first use instead of swallowing their writes.
+    if (storage === undefined) {
+        return {
+            get: () => ({}),
+            set: () => { },
+            remove: () => { },
+            onChanged: notifier.onChanged,
         };
-        fireStorageEvent(changes);
     }
-});
-const onChanged = {
-    addListener(listener) {
-        listeners.add(listener);
-    },
-    removeListener(listener) {
-        listeners.delete(listener);
-    },
-    hasListener(listener) {
-        return listeners.has(listener);
-    },
-};
-exports.default = (storage) => ({
-    get: keys => {
-        const result = {};
-        if (Array.isArray(keys)) {
-            keys.forEach(key => {
-                const item = typeof storage !== 'undefined' ? storage.getItem(key) : undefined;
-                if (item)
+    const route = { storage, fire: notifier.fire };
+    // The DOM subscription is shared and reference counted: an adapter joins it
+    // with its first listener and lets go with its last, so factory calls nobody
+    // listens to leave nothing attached to the global object.
+    const onChanged = {
+        addListener(listener) {
+            notifier.onChanged.addListener(listener);
+            (0, storage_event_router_1.addRoute)(route);
+        },
+        removeListener(listener) {
+            notifier.onChanged.removeListener(listener);
+            if (!notifier.hasListeners())
+                (0, storage_event_router_1.removeRoute)(route);
+        },
+        hasListener(listener) {
+            return notifier.onChanged.hasListener(listener);
+        },
+    };
+    return {
+        get: keys => {
+            const result = {};
+            for (const key of toKeyList(keys)) {
+                const item = storage.getItem(key);
+                // `null` is the only answer that means absence: an empty string is a
+                // value the caller stored, and reporting it as a missing key loses it.
+                if (item !== null)
                     result[key] = item;
-            });
-        }
-        else {
-            const item = typeof storage !== 'undefined' ? storage.getItem(keys) : undefined;
-            if (item)
-                result[keys] = item;
-        }
-        return result;
-    },
-    set: items => {
-        const changes = {};
-        Object.entries(items).forEach(([key, value]) => {
-            const oldValue = typeof storage !== 'undefined' ? storage.getItem(key) : undefined;
-            if (typeof storage !== 'undefined') {
+            }
+            return result;
+        },
+        set: items => {
+            const changes = {};
+            for (const [key, value] of Object.entries(items)) {
+                const oldValue = storage.getItem(key);
                 storage.setItem(key, value);
                 changes[key] = {
                     oldValue,
                     newValue: value,
                 };
             }
-        });
-        if (Object.keys(changes).length > 0)
-            fireStorageEvent(changes);
-    },
-    remove: keys => {
-        const changes = {};
-        if (Array.isArray(keys)) {
-            keys.forEach(key => {
-                const oldValue = typeof storage !== 'undefined' ? storage.getItem(key) : undefined;
-                if (typeof storage !== 'undefined') {
-                    storage.removeItem(key);
-                    changes[key] = {
-                        oldValue,
-                        newValue: null,
-                    };
-                }
-            });
-        }
-        else {
-            const oldValue = typeof storage !== 'undefined' ? storage.getItem(keys) : undefined;
-            if (typeof storage !== 'undefined') {
-                storage.removeItem(keys);
-                changes[keys] = {
+            if (Object.keys(changes).length > 0)
+                notifier.fire(changes);
+        },
+        remove: keys => {
+            const changes = {};
+            for (const key of toKeyList(keys)) {
+                const oldValue = storage.getItem(key);
+                storage.removeItem(key);
+                changes[key] = {
                     oldValue,
                     newValue: null,
                 };
             }
-        }
-        if (Object.keys(changes).length > 0)
-            fireStorageEvent(changes);
-    },
-    onChanged,
-});
+            if (Object.keys(changes).length > 0)
+                notifier.fire(changes);
+        },
+        onChanged,
+    };
+};
 //# sourceMappingURL=create-web-storage.js.map

package/lib/utils/create-web-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-web-storage.js","sourceRoot":"","sources":["../../src/utils/create-web-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-web-storage.js","sourceRoot":"","sources":["../../src/utils/create-web-storage.ts"],"names":[],"mappings":"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"}

package/lib/utils/extension-storage.d.ts

@@ -0,0 +1,38 @@
+import type { StorageChange, StorageChangeEvent } from '../@types/storage';
+declare const TRACKED_AREAS: readonly ["local", "sync", "managed"];
+export type Area = (typeof TRACKED_AREAS)[number];
+/**
+ * Extension storage holds arbitrary JSON, while this library only ever writes
+ * serialized strings. Anything else under a key belongs to other code and is
+ * reported as absent — which is what effectively happened before, once such a
+ * value reached `JSON.parse` and the hook fell back to its initial value.
+ */
+export declare function toStoredValue(value: unknown): string | null | undefined;
+export declare function toStorageChanges(changes: {
+    [key: string]: {
+        oldValue?: unknown;
+        newValue?: unknown;
+    };
+}): {
+    [key: string]: StorageChange;
+};
+export declare function toStoredItems(items: {
+    [key: string]: unknown;
+}): {
+    [key: string]: string;
+};
+export interface ListenerRegistry {
+    fire(changes: {
+        [key: string]: StorageChange;
+    }, area: string): void;
+    createOnChanged(area: Area): StorageChangeEvent;
+}
+/**
+ * Demultiplexes an extension's single `onChanged` event, which names the area
+ * that changed, to one notifier per area. Each adapter owns its own registry,
+ * so a change in one browser's storage never reaches listeners registered on
+ * another's.
+ */
+export declare function createListenerRegistry(): ListenerRegistry;
+export {};
+//# sourceMappingURL=extension-storage.d.ts.map

package/lib/utils/extension-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-storage.d.ts","sourceRoot":"","sources":["../../src/utils/extension-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAG1E,QAAA,MAAM,aAAa,uCAAwC,CAAA;AAE3D,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAQjD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAIvE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG;IACxG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAC7B,CAWA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAQ1F;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnE,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,CAAA;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAiBzD"}

package/lib/utils/extension-storage.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toStoredValue = toStoredValue;
+exports.toStorageChanges = toStorageChanges;
+exports.toStoredItems = toStoredItems;
+exports.createListenerRegistry = createListenerRegistry;
+const change_notifier_1 = require("./change-notifier");
+const TRACKED_AREAS = ['local', 'sync', 'managed'];
+// Both browsers also report `session` changes, an area this library does not
+// expose. Dispatching one would read an undefined notifier and throw.
+function isTrackedArea(area) {
+    return TRACKED_AREAS.includes(area);
+}
+/**
+ * Extension storage holds arbitrary JSON, while this library only ever writes
+ * serialized strings. Anything else under a key belongs to other code and is
+ * reported as absent — which is what effectively happened before, once such a
+ * value reached `JSON.parse` and the hook fell back to its initial value.
+ */
+function toStoredValue(value) {
+    if (value === undefined)
+        return;
+    return typeof value === 'string' ? value : null;
+}
+function toStorageChanges(changes) {
+    const result = {};
+    for (const [key, change] of Object.entries(changes)) {
+        result[key] = {
+            oldValue: toStoredValue(change.oldValue),
+            newValue: toStoredValue(change.newValue),
+        };
+    }
+    return result;
+}
+function toStoredItems(items) {
+    const result = {};
+    for (const [key, value] of Object.entries(items)) {
+        if (typeof value === 'string')
+            result[key] = value;
+    }
+    return result;
+}
+/**
+ * Demultiplexes an extension's single `onChanged` event, which names the area
+ * that changed, to one notifier per area. Each adapter owns its own registry,
+ * so a change in one browser's storage never reaches listeners registered on
+ * another's.
+ */
+function createListenerRegistry() {
+    const notifiers = {
+        local: (0, change_notifier_1.createChangeNotifier)(),
+        sync: (0, change_notifier_1.createChangeNotifier)(),
+        managed: (0, change_notifier_1.createChangeNotifier)(),
+    };
+    return {
+        fire(changes, area) {
+            if (!isTrackedArea(area))
+                return;
+            notifiers[area].fire(changes);
+        },
+        createOnChanged(area) {
+            return notifiers[area].onChanged;
+        },
+    };
+}
+//# sourceMappingURL=extension-storage.js.map

package/lib/utils/extension-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-storage.js","sourceRoot":"","sources":["../../src/utils/extension-storage.ts"],"names":[],"mappings":";;AAmBA,sCAIC;AAED,4CAaC;AAED,sCAQC;AAaD,wDAiBC;AA7ED,uDAA6E;AAE7E,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAU,CAAA;AAI3D,6EAA6E;AAC7E,sEAAsE;AACtE,SAAS,aAAa,CAAC,IAAY;IACjC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAM;IAE/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;AACjD,CAAC;AAED,SAAgB,gBAAgB,CAAC,OAAsE;IAGrG,MAAM,MAAM,GAAqC,EAAE,CAAA;IAEnD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG;YACZ,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;YACxC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;SACzC,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAgB,aAAa,CAAC,KAAiC;IAC7D,MAAM,MAAM,GAA8B,EAAE,CAAA;IAE5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACpD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAOD;;;;;GAKG;AACH,SAAgB,sBAAsB;IACpC,MAAM,SAAS,GAAuC;QACpD,KAAK,EAAE,IAAA,sCAAoB,GAAE;QAC7B,IAAI,EAAE,IAAA,sCAAoB,GAAE;QAC5B,OAAO,EAAE,IAAA,sCAAoB,GAAE;KAChC,CAAA;IAED,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,IAAI;YAChB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBAAE,OAAM;YAEhC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;QACD,eAAe,CAAC,IAAI;YAClB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAA;QAClC,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/utils/get-new-item.d.ts

@@ -1,2 +1,14 @@
-export default function <T>(key: string, persistedItem: string, newValue: T): string;
+/**
+ * Merges `newValue` under `key` into the serialized entry a factory shares between all of its
+ * hooks, and returns the entry to store.
+ *
+ * Reports and throws when the entry cannot be merged into, rather than answering with one built
+ * from nothing. What this returns is written over the whole entry, so an unreadable entry is the
+ * one case with nothing safe to return: every other hook's key would be replaced with nothing,
+ * and the bytes a repair still needs would go with them.
+ *
+ * @throws {SyntaxError} when the entry is not valid JSON.
+ * @throws {TypeError} when the entry is valid JSON but not an object of keys.
+ */
+export default function getNewItem<T>(key: string, persistedItem: string, newValue: T): string;
 //# sourceMappingURL=get-new-item.d.ts.map

package/lib/utils/get-new-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-new-item.d.ts","sourceRoot":"","sources":["../../src/utils/get-new-item.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,WAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAelF"}
+{"version":3,"file":"get-new-item.d.ts","sourceRoot":"","sources":["../../src/utils/get-new-item.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAwB7F"}

package/lib/utils/get-new-item.js

@@ -1,17 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
-function default_1(key, persistedItem, newValue) {
+exports.default = getNewItem;
+const is_1 = require("@plq/is");
+/**
+ * Merges `newValue` under `key` into the serialized entry a factory shares between all of its
+ * hooks, and returns the entry to store.
+ *
+ * Reports and throws when the entry cannot be merged into, rather than answering with one built
+ * from nothing. What this returns is written over the whole entry, so an unreadable entry is the
+ * one case with nothing safe to return: every other hook's key would be replaced with nothing,
+ * and the bytes a repair still needs would go with them.
+ *
+ * @throws {SyntaxError} when the entry is not valid JSON.
+ * @throws {TypeError} when the entry is valid JSON but not an object of keys.
+ */
+function getNewItem(key, persistedItem, newValue) {
     let persist;
     try {
         persist = persistedItem ? JSON.parse(persistedItem) : {};
     }
     catch (err) {
-        console.error(err);
-        persist = {};
+        console.error("use-persisted-state: Can't write value to storage", err);
+        throw err;
     }
-    return JSON.stringify(Object.assign(persist, {
-        [key]: newValue,
-    }));
+    if (!(0, is_1.isObject)(persist)) {
+        // A shared backend can leave any JSON under the key, and neither a primitive nor an array
+        // survives being merged into: `JSON.stringify` unwraps the first back to itself and keeps the
+        // second an array, so the value being set disappears with the property added to it. A stored
+        // `null` did not even get that far - it threw out of `Object.assign` and into the caller.
+        const err = new TypeError('the stored entry is not an object of keys');
+        console.error("use-persisted-state: Can't write value to storage", err);
+        throw err;
+    }
+    return JSON.stringify({ ...persist, [key]: newValue });
 }
 //# sourceMappingURL=get-new-item.js.map

package/lib/utils/get-new-item.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-new-item.js","sourceRoot":"","sources":["../../src/utils/get-new-item.ts"],"names":[],"mappings":";;AAAA,4BAeC;AAfD,mBAA2B,GAAW,EAAE,aAAqB,EAAE,QAAW;IACxE,IAAI,OAAiC,CAAA;IAErC,IAAI,CAAC;QACH,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClB,OAAO,GAAG,EAAE,CAAA;IACd,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CACnB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACrB,CAAC,GAAG,CAAC,EAAE,QAAQ;KAChB,CAAC,CACH,CAAA;AACH,CAAC"}
+{"version":3,"file":"get-new-item.js","sourceRoot":"","sources":["../../src/utils/get-new-item.ts"],"names":[],"mappings":";;AAcA,6BAwBC;AAtCD,gCAAkC;AAElC;;;;;;;;;;;GAWG;AACH,SAAwB,UAAU,CAAI,GAAW,EAAE,aAAqB,EAAE,QAAW;IACnF,IAAI,OAAgB,CAAA;IAEpB,IAAI,CAAC;QACH,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,GAAG,CAAC,CAAA;QAEvE,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC,IAAA,aAAQ,EAAC,OAAO,CAAC,EAAE,CAAC;QACvB,0FAA0F;QAC1F,8FAA8F;QAC9F,6FAA6F;QAC7F,0FAA0F;QAC1F,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAA;QAEtE,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,GAAG,CAAC,CAAA;QAEvE,MAAM,GAAG,CAAA;IACX,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;AACxD,CAAC"}

package/lib/utils/get-new-value.d.ts

@@ -1,3 +1,3 @@
-import React from 'react';
+import type React from 'react';
 export default function <T>(newState: React.SetStateAction<T>, state: T): T;
 //# sourceMappingURL=get-new-value.d.ts.map

package/lib/utils/get-new-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-new-value.d.ts","sourceRoot":"","sources":["../../src/utils/get-new-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,MAAM,CAAC,OAAO,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAU1E"}
+{"version":3,"file":"get-new-value.d.ts","sourceRoot":"","sources":["../../src/utils/get-new-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,CAAC,OAAO,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAU1E"}

package/lib/utils/get-persisted-value.d.ts

@@ -1,2 +1,9 @@
-export default function <T>(key: string, initialValue: T | (() => T), persist?: string): T;
+/**
+ * Resolves the value a hook starts from: the persisted entry for `key` when the stored payload
+ * carries one, the initial value otherwise.
+ *
+ * Presence is decided by the key rather than by the value, so a persisted `null` comes back as
+ * the value the user set instead of being mistaken for an absence and replaced.
+ */
+export default function getPersistedValue<T>(key: string, initialValue: T | (() => T), persist?: string): T;
 //# sourceMappingURL=get-persisted-value.d.ts.map

package/lib/utils/get-persisted-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-persisted-value.d.ts","sourceRoot":"","sources":["../../src/utils/get-persisted-value.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,WAAU,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAgBvF"}
+{"version":3,"file":"get-persisted-value.d.ts","sourceRoot":"","sources":["../../src/utils/get-persisted-value.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAwB1G"}

package/lib/utils/get-persisted-value.js

@@ -1,18 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
+exports.default = getPersistedValue;
 const is_1 = require("@plq/is");
-function default_1(key, initialValue, persist) {
+/**
+ * Resolves the value a hook starts from: the persisted entry for `key` when the stored payload
+ * carries one, the initial value otherwise.
+ *
+ * Presence is decided by the key rather than by the value, so a persisted `null` comes back as
+ * the value the user set instead of being mistaken for an absence and replaced.
+ */
+function getPersistedValue(key, initialValue, persist) {
     let initialPersist;
     try {
         initialPersist = persist ? JSON.parse(persist) : {};
     }
-    catch {
+    catch (err) {
+        // A shared backend can hold a foreign or truncated entry, so a parse failure is expected here
+        // and must not stop the component mounting. It is reported rather than swallowed because the
+        // fallback discards whatever was persisted, and because the change path logs the same failure.
+        console.error("use-persisted-state: Can't parse value from storage", err);
         initialPersist = {};
     }
     let initialOrPersistedValue = (0, is_1.isFunction)(initialValue) ? initialValue() : initialValue;
-    if (initialPersist && key in initialPersist) {
-        initialOrPersistedValue = initialPersist[key] ?? initialOrPersistedValue;
+    // `JSON.parse` yields any JSON value, so a foreign entry can be a primitive,
+    // and `in` throws on one. This runs in the `useState` initializer, where a
+    // throw stops the component mounting instead of falling back.
+    if ((0, is_1.isObject)(initialPersist) && key in initialPersist) {
+        initialOrPersistedValue = initialPersist[key];
     }
     return initialOrPersistedValue;
 }

package/lib/utils/get-persisted-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-persisted-value.js","sourceRoot":"","sources":["../../src/utils/get-persisted-value.ts"],"names":[],"mappings":";;AAEA,4BAgBC;AAlBD,gCAAoC;AAEpC,mBAA2B,GAAU,EAAE,YAA2B,EAAE,OAAgB;IAClF,IAAI,cAAwC,CAAA;IAE5C,IAAI,CAAC;QACH,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,cAAc,GAAG,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,uBAAuB,GAAG,IAAA,eAAU,EAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAE,CAAC,CAAC,YAAY,CAAA;IAEvF,IAAI,cAAc,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;QAC5C,uBAAuB,GAAI,cAAc,CAAC,GAAG,CAAO,IAAI,uBAAuB,CAAA;IACjF,CAAC;IAED,OAAO,uBAAuB,CAAA;AAChC,CAAC"}
+{"version":3,"file":"get-persisted-value.js","sourceRoot":"","sources":["../../src/utils/get-persisted-value.ts"],"names":[],"mappings":";;AASA,oCAwBC;AAjCD,gCAA8C;AAE9C;;;;;;GAMG;AACH,SAAwB,iBAAiB,CAAI,GAAW,EAAE,YAA2B,EAAE,OAAgB;IACrG,IAAI,cAAuB,CAAA;IAE3B,IAAI,CAAC;QACH,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8FAA8F;QAC9F,6FAA6F;QAC7F,+FAA+F;QAC/F,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAA;QAEzE,cAAc,GAAG,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,uBAAuB,GAAG,IAAA,eAAU,EAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,CAAA;IAEtF,6EAA6E;IAC7E,2EAA2E;IAC3E,8DAA8D;IAC9D,IAAI,IAAA,aAAQ,EAAC,cAAc,CAAC,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;QACtD,uBAAuB,GAAG,cAAc,CAAC,GAAG,CAAM,CAAA;IACpD,CAAC;IAED,OAAO,uBAAuB,CAAA;AAChC,CAAC"}

package/lib/utils/is-async-storage.d.ts

@@ -1,3 +1,10 @@
 import type { AsyncStorage } from '../@types/storage';
+/**
+ * Narrows a storage to {@link AsyncStorage}, deciding which hook the entry point builds.
+ *
+ * Inspection never writes: `set` and `remove` are only checked for shape, never invoked, so
+ * `get` alone decides. A candidate pairing an async `get` with a sync `set` satisfies neither
+ * storage interface, which is why proving the other two members is not worth a write.
+ */
 export default function isAsyncStorage(storage: unknown): storage is AsyncStorage;
 //# sourceMappingURL=is-async-storage.d.ts.map

package/lib/utils/is-async-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-async-storage.d.ts","sourceRoot":"","sources":["../../src/utils/is-async-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAA;AAEnD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,YAAY,CA0BhF"}
+{"version":3,"file":"is-async-storage.d.ts","sourceRoot":"","sources":["../../src/utils/is-async-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAcrD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,YAAY,CAoDhF"}

package/lib/utils/is-async-storage.js

@@ -2,28 +2,59 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = isAsyncStorage;
 const is_1 = require("@plq/is");
+// `AsyncStorage` is three methods, so every member has to be callable: a promise standing in for
+// one satisfies nothing the hook then does with it. `@plq/is` classifies async functions as their
+// own type, so `isFunction` rejects them and both checks are needed to admit a callable member.
+const isCallableMember = (member) => (0, is_1.isFunction)(member) || (0, is_1.isAsyncFunction)(member);
+/**
+ * Narrows a storage to {@link AsyncStorage}, deciding which hook the entry point builds.
+ *
+ * Inspection never writes: `set` and `remove` are only checked for shape, never invoked, so
+ * `get` alone decides. A candidate pairing an async `get` with a sync `set` satisfies neither
+ * storage interface, which is why proving the other two members is not worth a write.
+ */
 function isAsyncStorage(storage) {
-    const hasGet = Boolean(storage) && typeof storage?.get !== 'undefined';
-    const hasSet = Boolean(storage) && typeof storage?.set !== 'undefined';
-    const hasRemove = Boolean(storage) && typeof storage?.remove !== 'undefined';
-    if (!hasGet || !hasSet || !hasRemove) {
+    const candidate = storage;
+    if (!candidate) {
         return false;
     }
-    const hasGetPromise = (0, is_1.isPromise)(storage.get)
-        || (0, is_1.isFunction)(storage.get) && (0, is_1.isPromise)(storage.get(''))
-        || (0, is_1.isAsyncFunction)(storage.get);
-    const hasSetPromise = (0, is_1.isPromise)(storage.set)
-        || (0, is_1.isFunction)(storage.set) && (0, is_1.isPromise)(storage.set({}))
-        || (0, is_1.isAsyncFunction)(storage.set);
-    const hasRemovePromise = (0, is_1.isPromise)(storage.remove)
-        || (0, is_1.isFunction)(storage.remove) && (0, is_1.isPromise)(storage.remove(''))
-        || (0, is_1.isAsyncFunction)(storage.remove);
-    return Boolean(storage)
-        && hasGet
-        && hasSet
-        && hasRemove
-        && hasGetPromise
-        && hasSetPromise
-        && hasRemovePromise;
+    const { get, set, remove } = candidate;
+    if (!isCallableMember(set) || !isCallableMember(remove)) {
+        return false;
+    }
+    // An `async` declaration is the one form of asyncness visible without a call.
+    if ((0, is_1.isAsyncFunction)(get)) {
+        return true;
+    }
+    if (!(0, is_1.isFunction)(get)) {
+        return false;
+    }
+    // `AsyncStorage` admits a plain function returning a promise, and nothing short of a call tells
+    // that apart from a sync get. Any adapter written that way can only be recognised here, and a
+    // third-party one is free to be written that way, so this line stays necessary however the
+    // shipped adapters happen to declare themselves. A read is the one probe that leaves the
+    // inspected storage as it found it.
+    let probe;
+    try {
+        // Called as a method of the storage it belongs to: an adapter written as an
+        // object of methods reads its own state through `this`, and probing the
+        // extracted function would throw on a storage that is perfectly valid.
+        probe = get.call(candidate, '');
+    }
+    catch {
+        // Not swallowed, deferred: consumers build the factory at module scope, where
+        // a throw takes the import down instead of reaching a component. A storage
+        // whose read fails is not provably async, and the sync path raises the same
+        // failure at the first read, where it can be handled.
+        return false;
+    }
+    if (!(0, is_1.isPromise)(probe)) {
+        return false;
+    }
+    // Only the probe's shape answers the question, so its outcome is discarded by construction.
+    // The rejection still has to be claimed: unclaimed, it terminates the process on Node 15+,
+    // letting a storage that merely fails a read take the consuming application down with it.
+    probe.then(undefined, () => undefined);
+    return true;
 }
 //# sourceMappingURL=is-async-storage.js.map

package/lib/utils/is-async-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-async-storage.js","sourceRoot":"","sources":["../../src/utils/is-async-storage.ts"],"names":[],"mappings":";;AAGA,iCA0BC;AA7BD,gCAA8D;AAG9D,SAAwB,cAAc,CAAC,OAAgB;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,OAAQ,OAAe,EAAE,GAAG,KAAK,WAAW,CAAA;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,OAAQ,OAAe,EAAE,GAAG,KAAK,WAAW,CAAA;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,OAAQ,OAAe,EAAE,MAAM,KAAK,WAAW,CAAA;IAErF,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,cAAS,EAAE,OAAe,CAAC,GAAG,CAAC;WAC9C,IAAA,eAAU,EAAE,OAAe,CAAC,GAAG,CAAC,IAAI,IAAA,cAAS,EAAE,OAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;WACvE,IAAA,oBAAe,EAAE,OAAe,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,aAAa,GAAG,IAAA,cAAS,EAAE,OAAe,CAAC,GAAG,CAAC;WAC9C,IAAA,eAAU,EAAE,OAAe,CAAC,GAAG,CAAC,IAAI,IAAA,cAAS,EAAE,OAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;WACvE,IAAA,oBAAe,EAAE,OAAe,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,gBAAgB,GAAG,IAAA,cAAS,EAAE,OAAe,CAAC,MAAM,CAAC;WACpD,IAAA,eAAU,EAAE,OAAe,CAAC,MAAM,CAAC,IAAI,IAAA,cAAS,EAAE,OAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;WAC7E,IAAA,oBAAe,EAAE,OAAe,CAAC,MAAM,CAAC,CAAA;IAE/C,OAAO,OAAO,CAAC,OAAO,CAAC;WAChB,MAAM;WACN,MAAM;WACN,SAAS;WACT,aAAa;WACb,aAAa;WACb,gBAAgB,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"is-async-storage.js","sourceRoot":"","sources":["../../src/utils/is-async-storage.ts"],"names":[],"mappings":";;AAsBA,iCAoDC;AA1ED,gCAAgE;AAUhE,iGAAiG;AACjG,kGAAkG;AAClG,gGAAgG;AAChG,MAAM,gBAAgB,GAAG,CAAC,MAAe,EAAW,EAAE,CAAC,IAAA,eAAU,EAAC,MAAM,CAAC,IAAI,IAAA,oBAAe,EAAC,MAAM,CAAC,CAAA;AAEpG;;;;;;GAMG;AACH,SAAwB,cAAc,CAAC,OAAgB;IACrD,MAAM,SAAS,GAAG,OAA8C,CAAA;IAEhE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAEtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,8EAA8E;IAC9E,IAAI,IAAA,oBAAe,EAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,gGAAgG;IAChG,8FAA8F;IAC9F,2FAA2F;IAC3F,yFAAyF;IACzF,oCAAoC;IACpC,IAAI,KAAc,CAAA;IAElB,IAAI,CAAC;QACH,4EAA4E;QAC5E,wEAAwE;QACxE,uEAAuE;QACvE,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,8EAA8E;QAC9E,2EAA2E;QAC3E,4EAA4E;QAC5E,sDAAsD;QACtD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,CAAC,IAAA,cAAS,EAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,4FAA4F;IAC5F,2FAA2F;IAC3F,0FAA0F;IAC1F,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAEtC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/lib/utils/storage-event-router.d.ts

@@ -0,0 +1,17 @@
+import type { StorageChange } from '../@types/storage';
+/** An adapter waiting for DOM storage events about the area it wraps. */
+export interface StorageEventRoute {
+    storage: globalThis.Storage;
+    fire(changes: {
+        [key: string]: StorageChange;
+    }): void;
+}
+/**
+ * Starts routing DOM storage events to `route`. Every adapter shares one
+ * subscription on the global object, so creating adapters nobody listens to
+ * costs nothing.
+ */
+export declare function addRoute(route: StorageEventRoute): void;
+/** Stops routing to `route`, releasing the shared subscription with the last one. */
+export declare function removeRoute(route: StorageEventRoute): void;
+//# sourceMappingURL=storage-event-router.d.ts.map

package/lib/utils/storage-event-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-event-router.d.ts","sourceRoot":"","sources":["../../src/utils/storage-event-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,GAAG,IAAI,CAAA;CACtD;AAoCD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAQvD;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAQ1D"}