react-wire-persisted 1.5.0 → 2.0.1

package/client.js

@@ -0,0 +1,58 @@
+'use client'
+
+// This file is specifically for Next.js App Router client components
+// Import this directly: import { HydrationProvider } from 'react-wire-persisted/client'
+
+import { useEffect, useRef } from 'react'
+import { upgradeStorage } from './dist/react-wire-persisted.js'
+
+// Inline the hydration detection logic to avoid import issues
+const getIsClient = () => typeof window !== 'undefined'
+
+const getHasHydrated = () => {
+    if (!getIsClient()) return false
+    return document.readyState !== 'loading'
+}
+
+/**
+ * A Next.js App Router compatible client component that handles automatic storage upgrade
+ * after hydration. Import this from 'react-wire-persisted/client' to ensure proper client-side operation.
+ *
+ * @param {Object} props Component props
+ * @param {React.ReactNode} props.children Child components to render
+ * @param {Function} props.onUpgrade Callback called when storage is upgraded
+ * @param {Boolean} props.autoUpgrade Whether to automatically upgrade storage (default: true)
+ */
+export function HydrationProvider({ children, onUpgrade, autoUpgrade = true }) {
+    const hasUpgraded = useRef(false)
+
+    useEffect(() => {
+        if (!autoUpgrade || hasUpgraded.current || !getIsClient()) {
+            return
+        }
+
+        const attemptUpgrade = () => {
+            if (getHasHydrated() && !hasUpgraded.current) {
+                const upgraded = upgradeStorage()
+
+                if (upgraded) {
+                    hasUpgraded.current = true
+                    onUpgrade?.()
+                }
+            }
+        }
+
+        // Try to upgrade immediately if already hydrated
+        attemptUpgrade()
+
+        // Also try after a short delay to ensure DOM is ready
+        const timeoutId = setTimeout(attemptUpgrade, 0)
+
+        return () => clearTimeout(timeoutId)
+    }, [autoUpgrade, onUpgrade])
+
+    return children
+}
+
+// Re-export the hook from the main package for convenience
+export { useHydration } from './dist/react-wire-persisted.js'

package/client.mjs

@@ -0,0 +1,108 @@
+'use client'
+
+// This file is specifically for Next.js App Router client components
+// Import this directly: import { HydrationProvider } from 'react-wire-persisted/client.mjs'
+
+import { useEffect, useRef } from 'react'
+
+// Inline all the necessary utilities to avoid any import issues
+const isClient = typeof window !== 'undefined'
+
+const isLocalStorageAvailable = () => {
+    if (!isClient) return false
+
+    try {
+        const testKey = '__rwp_test__'
+        window.localStorage.setItem(testKey, 'test')
+        window.localStorage.removeItem(testKey)
+        return true
+    } catch (e) {
+        return false
+    }
+}
+
+// Simple fake storage for SSR
+const fakeStorage = {
+    data: {},
+    getItem: (key) => fakeStorage.data[key] || null,
+    setItem: (key, value) => {
+        fakeStorage.data[key] = value
+    },
+    removeItem: (key) => {
+        delete fakeStorage.data[key]
+    }
+}
+
+// Get current storage (real or fake)
+const getCurrentStorage = () => {
+    return isLocalStorageAvailable() ? window.localStorage : fakeStorage
+}
+
+// Simple storage upgrade function
+const upgradeStorageToReal = () => {
+    if (!isClient || !isLocalStorageAvailable()) {
+        return false
+    }
+
+    // If we're already using real localStorage, nothing to do
+    if (fakeStorage.data && Object.keys(fakeStorage.data).length === 0) {
+        return false
+    }
+
+    try {
+        // Move data from fake to real storage
+        const fakeData = { ...fakeStorage.data }
+        Object.keys(fakeData).forEach(key => {
+            if (fakeData[key] != null) {
+                window.localStorage.setItem(key, fakeData[key])
+            }
+        })
+
+        // Clear fake storage
+        fakeStorage.data = {}
+        return true
+    } catch (e) {
+        return false
+    }
+}
+
+/**
+ * A Next.js App Router compatible client component that handles automatic storage upgrade
+ * after hydration. Import this from 'react-wire-persisted/client.mjs' to ensure proper client-side operation.
+ *
+ * @param {Object} props Component props
+ * @param {React.ReactNode} props.children Child components to render
+ * @param {Function} props.onUpgrade Callback called when storage is upgraded
+ * @param {Boolean} props.autoUpgrade Whether to automatically upgrade storage (default: true)
+ */
+export function HydrationProvider({ children, onUpgrade, autoUpgrade = true }) {
+    const hasUpgraded = useRef(false)
+
+    useEffect(() => {
+        if (!autoUpgrade || hasUpgraded.current || !isClient) {
+            return
+        }
+
+        const attemptUpgrade = () => {
+            // Wait for DOM to be ready
+            if (document.readyState !== 'loading' && !hasUpgraded.current) {
+                const upgraded = upgradeStorageToReal()
+
+                if (upgraded) {
+                    hasUpgraded.current = true
+                    onUpgrade?.()
+                }
+            }
+        }
+
+        // Try to upgrade immediately if DOM is already ready
+        attemptUpgrade()
+
+        // Also try after a short delay to ensure everything is ready
+        const timeoutId = setTimeout(attemptUpgrade, 100)
+
+        return () => clearTimeout(timeoutId)
+    }, [autoUpgrade, onUpgrade])
+
+    return children
+}

package/dist/{react-wire-persisted.mjs → index.js}

@@ -1,4 +1,5 @@
-import { createWire as b } from "@forminator/react-wire";
+import { createWire as U } from "@forminator/react-wire";
+import { useRef as b, useEffect as O } from "react";
 (function() {
   const s = {};
   try {
@@ -10,42 +11,62 @@ import { createWire as b } from "@forminator/react-wire";
   }
   globalThis.process = { env: s };
 })();
-const m = {}, p = (s) => {
-  m[s] = s;
-}, I = (s) => p(s), O = () => m, S = (s, e = null) => {
-  const t = e || m;
-  return s ? Object.keys(t).reduce((r, n) => ({
+const y = {}, w = (s) => {
+  y[s] = s;
+}, j = (s) => w(s), x = () => y, N = (s, e = null) => {
+  const t = e || y;
+  return s ? Object.keys(t).reduce((r, o) => ({
     ...r,
-    [n]: `${s}.${t[n]}`
+    [o]: `${s}.${t[o]}`
   }), {}) : t;
 }, g = {
+  __IS_FAKE_LOCAL_STORAGE__: !0
+}, h = {
   getItem: (s) => g[s],
   setItem: (s, e) => {
     g[s] = e;
   },
   removeItem: (s) => {
     delete g[s];
+  },
+  // Make Object.keys() work properly for _resetAll method
+  ...g
+};
+let S = !1, p = !1;
+typeof window < "u" && (S = !0, document.readyState === "loading" ? document.addEventListener("DOMContentLoaded", () => {
+  p = !0;
+}) : p = !0);
+const m = () => S, _ = () => p, d = () => {
+  if (!S) return !1;
+  try {
+    const s = "__rwp_test__";
+    return window.localStorage.setItem(s, "test"), window.localStorage.removeItem(s), !0;
+  } catch {
+    return !1;
   }
-}, d = (s) => {
+}, A = (s) => {
   const e = typeof s;
   return s === null ? !0 : Array.isArray(s) || e === "object" ? !1 : e !== "function";
-}, j = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+}, k = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  addKey: p,
-  fakeLocalStorage: g,
-  getKeys: O,
-  getPrefixedKeys: S,
-  isPrimitive: d,
-  key: I
+  addKey: w,
+  fakeLocalStorage: h,
+  getHasHydrated: _,
+  getIsClient: m,
+  getKeys: x,
+  getPrefixedKeys: N,
+  isLocalStorageAvailable: d,
+  isPrimitive: A,
+  key: j
 }, Symbol.toStringTag, { value: "Module" }));
-class h {
+class I {
   /**
    * Initializes the class
    * @param {String} namespace Namespace to prefix all keys with. Mostly used for the logging & reset functions
    * @param {Object} registry (Optional) Initialize the storage provider with an existing registry
    */
   constructor(e, t) {
-    if (new.target === h)
+    if (new.target === I)
       throw TypeError("StorageProvider is abstract. Extend this class to implement it");
     this.namespace = e || null, this.registry = t || /* istanbul ignore next */
     {};
@@ -122,16 +143,12 @@ class h {
   removeAll(e = []) {
   }
 }
-class v extends h {
+class T extends I {
   constructor(e = null, t = {}) {
-    super(e, t), this.storage = this.getStorage();
+    super(e, t), this.storage = this.getStorage(), this._isUsingFakeStorage = !d();
   }
   getStorage() {
-    try {
-      return window.localStorage;
-    } catch {
-      return console.warn(new Error("LocalStorageProvider: localStorage not supported")), g;
-    }
+    return d() ? window.localStorage : h;
   }
   setNamespace(e) {
     if (!this.namespace) {
@@ -142,9 +159,9 @@ class v extends h {
       return;
     const t = JSON.parse(JSON.stringify(this.getAll()));
     this.removeAll();
-    for (const [r, n] of Object.entries(t)) {
-      const o = r.replace(this.namespace, e);
-      this.setItem(o, n);
+    for (const [r, o] of Object.entries(t)) {
+      const n = r.replace(this.namespace, e);
+      this.setItem(n, o);
     }
     this.namespace = e;
   }
@@ -160,7 +177,7 @@ class v extends h {
   }
   setItem(e, t) {
     let r = t;
-    return r != null && (r = d(t) ? t : JSON.stringify(t)), this.storage.setItem(e, r);
+    return r != null && (r = A(t) ? t : JSON.stringify(t)), this.storage.setItem(e, r);
   }
   removeItem(e, t = !1) {
     return t && delete this.registry[e], this.storage.removeItem(e);
@@ -170,10 +187,10 @@ class v extends h {
     return Object.keys(this.storage).reduce((t, r) => ((!this.namespace || r.startsWith(e)) && (t[r] = this.storage.getItem(r)), t), {});
   }
   _resetAll(e = !0, t = [], r = !1) {
-    const n = `${this.namespace}.`;
-    Object.keys(localStorage).forEach((o) => {
-      const l = this.namespace ? o.startsWith(n) : !0, a = t?.includes(o) || !1;
-      !l || a || (e ? Object.prototype.hasOwnProperty.call(this.registry, o) ? this.storage.setItem(o, this.registry[o]) : this.storage.removeItem(o) : (this.storage.removeItem(o), r && delete this.registry[o]));
+    const o = `${this.namespace}.`;
+    Object.keys(this.storage).forEach((n) => {
+      const a = this.namespace ? n.startsWith(o) : !0, l = t?.includes(n) || !1;
+      !a || l || (e ? Object.prototype.hasOwnProperty.call(this.registry, n) ? this.storage.setItem(n, this.registry[n]) : this.storage.removeItem(n) : (this.storage.removeItem(n), r && delete this.registry[n]));
     });
   }
   resetAll(e = [], t = !1) {
@@ -182,50 +199,111 @@ class v extends h {
   removeAll(e = [], t = !1) {
     this._resetAll(!1, e || [], t);
   }
+  /**
+   * Attempt to upgrade from fake storage to real localStorage
+   * This is useful for hydration scenarios
+   */
+  upgradeToRealStorage() {
+    if (!this._isUsingFakeStorage || !d())
+      return !1;
+    const e = { ...this.storage };
+    return this.storage = window.localStorage, this._isUsingFakeStorage = !1, Object.keys(e).forEach((t) => {
+      if (t !== "__IS_FAKE_LOCAL_STORAGE__" && e[t] != null)
+        try {
+          this.storage.setItem(t, e[t]);
+        } catch {
+          return this.storage = h, this._isUsingFakeStorage = !0, !1;
+        }
+    }), !0;
+  }
+  /**
+   * Check if currently using fake storage
+   */
+  isUsingFakeStorage() {
+    return this._isUsingFakeStorage;
+  }
 }
-const A = {
+const L = {
   logging: {
     enabled: !1
   }
 };
-let y = v, i = new y(), u = { ...A }, f = [];
-const w = () => i.namespace, K = () => i, P = () => u, _ = (s) => {
-  i.setNamespace(s), i = new y(s || w());
-}, E = (s) => {
+let v = T, i = new v(), u = { ...L }, f = [];
+const P = () => i.namespace, V = () => i, $ = () => u, C = (s) => {
+  i.setNamespace(s), i = new v(s || P());
+}, H = (s) => {
   if (u = {
     ...u,
     ...s
   }, u.logging.enabled)
     for (console.info("Flushing", f.length, "pending logs"); f.length; )
       console.log(...f.shift());
-}, x = (...s) => {
+}, K = () => {
+  if (!m())
+    return !1;
+  const s = i.upgradeToRealStorage();
+  return s && E("react-wire-persisted: Upgraded to real localStorage after hydration"), s;
+}, E = (...s) => {
   u.logging.enabled ? console.log(...s) : f.push(s);
-}, V = (s, e = null) => {
+}, W = (s, e = null) => {
   if (!s && typeof s != "number") throw new Error(
     `createPersistedWire: Key cannot be a falsey value (${s}}`
   );
   i.register(s, e);
-  const t = b(e), r = () => t.getValue(), n = (c) => (i.setItem(s, c), t.setValue(c)), o = (c) => {
+  const t = U(e), r = () => t.getValue(), o = (c) => (i.setItem(s, c), t.setValue(c)), n = (c) => {
     t.subscribe(c);
-  }, l = i.getItem(s), a = l === null ? e : l;
-  return x("react-wire-persisted: create", s, {
+  }, a = i.getItem(s), l = a === null ? e : a;
+  return E("react-wire-persisted: create", s, {
     value: e,
-    storedValue: l,
-    initialValue: a
-  }), a !== e && n(a), {
+    storedValue: a,
+    initialValue: l
+  }), l !== e && o(l), {
     ...t,
     getValue: r,
-    setValue: n,
-    subscribe: o
+    setValue: o,
+    subscribe: n
+  };
+}, J = (s = {}) => {
+  const {
+    autoUpgrade: e = !0,
+    onUpgrade: t
+  } = s, r = b(!1);
+  return O(() => {
+    if (!e || r.current || !m())
+      return;
+    const o = () => {
+      _() && !r.current && K() && (r.current = !0, t?.());
+    };
+    o();
+    const n = setTimeout(o, 0);
+    return () => clearTimeout(n);
+  }, [e, t]), {
+    hasUpgraded: r.current
   };
 };
+function D({ children: s, onUpgrade: e, autoUpgrade: t = !0 }) {
+  const r = b(!1);
+  return O(() => {
+    if (!t || r.current || !m())
+      return;
+    const o = () => {
+      _() && !r.current && K() && (r.current = !0, e?.());
+    };
+    o();
+    const n = setTimeout(o, 0);
+    return () => clearTimeout(n);
+  }, [t, e]), s;
+}
 export {
-  V as createPersistedWire,
-  A as defaultOptions,
-  w as getNamespace,
-  P as getOptions,
-  K as getStorage,
-  _ as setNamespace,
-  E as setOptions,
-  j as utils
+  D as HydrationProvider,
+  W as createPersistedWire,
+  L as defaultOptions,
+  P as getNamespace,
+  $ as getOptions,
+  V as getStorage,
+  C as setNamespace,
+  H as setOptions,
+  K as upgradeStorage,
+  J as useHydration,
+  k as utils
 };

package/dist/react-wire-persisted.js

@@ -0,0 +1,309 @@
+import { createWire as U } from "@forminator/react-wire";
+import { useRef as b, useEffect as O } from "react";
+(function() {
+  const s = {};
+  try {
+    if (process) {
+      process.env = Object.assign({}, process.env), Object.assign(process.env, s);
+      return;
+    }
+  } catch {
+  }
+  globalThis.process = { env: s };
+})();
+const y = {}, w = (s) => {
+  y[s] = s;
+}, j = (s) => w(s), x = () => y, N = (s, e = null) => {
+  const t = e || y;
+  return s ? Object.keys(t).reduce((r, o) => ({
+    ...r,
+    [o]: `${s}.${t[o]}`
+  }), {}) : t;
+}, g = {
+  __IS_FAKE_LOCAL_STORAGE__: !0
+}, h = {
+  getItem: (s) => g[s],
+  setItem: (s, e) => {
+    g[s] = e;
+  },
+  removeItem: (s) => {
+    delete g[s];
+  },
+  // Make Object.keys() work properly for _resetAll method
+  ...g
+};
+let S = !1, p = !1;
+typeof window < "u" && (S = !0, document.readyState === "loading" ? document.addEventListener("DOMContentLoaded", () => {
+  p = !0;
+}) : p = !0);
+const m = () => S, _ = () => p, d = () => {
+  if (!S) return !1;
+  try {
+    const s = "__rwp_test__";
+    return window.localStorage.setItem(s, "test"), window.localStorage.removeItem(s), !0;
+  } catch {
+    return !1;
+  }
+}, A = (s) => {
+  const e = typeof s;
+  return s === null ? !0 : Array.isArray(s) || e === "object" ? !1 : e !== "function";
+}, k = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  addKey: w,
+  fakeLocalStorage: h,
+  getHasHydrated: _,
+  getIsClient: m,
+  getKeys: x,
+  getPrefixedKeys: N,
+  isLocalStorageAvailable: d,
+  isPrimitive: A,
+  key: j
+}, Symbol.toStringTag, { value: "Module" }));
+class I {
+  /**
+   * Initializes the class
+   * @param {String} namespace Namespace to prefix all keys with. Mostly used for the logging & reset functions
+   * @param {Object} registry (Optional) Initialize the storage provider with an existing registry
+   */
+  constructor(e, t) {
+    if (new.target === I)
+      throw TypeError("StorageProvider is abstract. Extend this class to implement it");
+    this.namespace = e || null, this.registry = t || /* istanbul ignore next */
+    {};
+  }
+  /**
+   * Sets the namespace for this storage provider, and migrates
+   * all stored values to the new namespace
+   * @param {String} namespace New namespace for this storage provider
+   */
+  /* istanbul ignore next */
+  setNamespace(e) {
+  }
+  /**
+   * Registers an item with it's initial value. This is used for logging, resetting, etc.
+   * @param {String} key Storage item's key
+   * @param {*} initialValue Storage item's initial value
+   */
+  register(e, t) {
+    this.registry[e] = t;
+  }
+  /**
+   * Reads an item from storage
+   * @param {String} key Key for the item to retrieve
+   */
+  /* istanbul ignore next */
+  getItem(e) {
+  }
+  /**
+   * Stores a value
+   * @param {String} key Item's storage key
+   * @param {String} value Item's value to store
+   */
+  /* istanbul ignore next */
+  setItem(e, t) {
+  }
+  /**
+   * Removes an item from storage
+   * @param {String} key Item's storage key
+   * @param {Boolean} fromRegistry (Optional) If the item should also be removed from the registry
+   */
+  /* istanbul ignore next */
+  removeItem(e, t = !1) {
+  }
+  /**
+   * Gets all stored keys & values
+   * If a `namespace` was set, only keys prefixed with the namespace will be returned
+   */
+  /* istanbul ignore next */
+  getAll() {
+  }
+  /**
+   * 
+   * @param {Boolean} useInitialValues If values should be replaced with their initial values. If false, keys are removed
+   * @param {String[]} excludedKeys (Optional) List of keys to exclude
+   * @param {Boolean} clearRegistry (Optional) If the registry should also be cleared
+   */
+  /* istanbul ignore next */
+  _resetAll(e = !0, t = [], r = !1) {
+  }
+  /**
+   * Resets all values to their initial values
+   * If a `namespace` is set, only keys prefixed with the namespace will be reset
+   * @param {String[]} excludedKeys (Optional) List of keys to exclude
+   */
+  /* istanbul ignore next */
+  resetAll(e = []) {
+  }
+  /**
+   * Removes all items from local storage.
+   * If a `namespace` is set, only keys prefixed with the namespace will be removed
+   * @param {String[]} excludedKeys (Optional) List of keys to exclude
+   */
+  /* istanbul ignore next */
+  removeAll(e = []) {
+  }
+}
+class T extends I {
+  constructor(e = null, t = {}) {
+    super(e, t), this.storage = this.getStorage(), this._isUsingFakeStorage = !d();
+  }
+  getStorage() {
+    return d() ? window.localStorage : h;
+  }
+  setNamespace(e) {
+    if (!this.namespace) {
+      this.namespace = e;
+      return;
+    }
+    if (this.namespace === e)
+      return;
+    const t = JSON.parse(JSON.stringify(this.getAll()));
+    this.removeAll();
+    for (const [r, o] of Object.entries(t)) {
+      const n = r.replace(this.namespace, e);
+      this.setItem(n, o);
+    }
+    this.namespace = e;
+  }
+  getItem(e) {
+    const t = this.storage.getItem(e);
+    if (t == null)
+      return null;
+    try {
+      return JSON.parse(t);
+    } catch {
+      return t;
+    }
+  }
+  setItem(e, t) {
+    let r = t;
+    return r != null && (r = A(t) ? t : JSON.stringify(t)), this.storage.setItem(e, r);
+  }
+  removeItem(e, t = !1) {
+    return t && delete this.registry[e], this.storage.removeItem(e);
+  }
+  getAll() {
+    const e = `${this.namespace}.`;
+    return Object.keys(this.storage).reduce((t, r) => ((!this.namespace || r.startsWith(e)) && (t[r] = this.storage.getItem(r)), t), {});
+  }
+  _resetAll(e = !0, t = [], r = !1) {
+    const o = `${this.namespace}.`;
+    Object.keys(this.storage).forEach((n) => {
+      const a = this.namespace ? n.startsWith(o) : !0, l = t?.includes(n) || !1;
+      !a || l || (e ? Object.prototype.hasOwnProperty.call(this.registry, n) ? this.storage.setItem(n, this.registry[n]) : this.storage.removeItem(n) : (this.storage.removeItem(n), r && delete this.registry[n]));
+    });
+  }
+  resetAll(e = [], t = !1) {
+    this._resetAll(!0, e || [], t);
+  }
+  removeAll(e = [], t = !1) {
+    this._resetAll(!1, e || [], t);
+  }
+  /**
+   * Attempt to upgrade from fake storage to real localStorage
+   * This is useful for hydration scenarios
+   */
+  upgradeToRealStorage() {
+    if (!this._isUsingFakeStorage || !d())
+      return !1;
+    const e = { ...this.storage };
+    return this.storage = window.localStorage, this._isUsingFakeStorage = !1, Object.keys(e).forEach((t) => {
+      if (t !== "__IS_FAKE_LOCAL_STORAGE__" && e[t] != null)
+        try {
+          this.storage.setItem(t, e[t]);
+        } catch {
+          return this.storage = h, this._isUsingFakeStorage = !0, !1;
+        }
+    }), !0;
+  }
+  /**
+   * Check if currently using fake storage
+   */
+  isUsingFakeStorage() {
+    return this._isUsingFakeStorage;
+  }
+}
+const L = {
+  logging: {
+    enabled: !1
+  }
+};
+let v = T, i = new v(), u = { ...L }, f = [];
+const P = () => i.namespace, V = () => i, $ = () => u, C = (s) => {
+  i.setNamespace(s), i = new v(s || P());
+}, H = (s) => {
+  if (u = {
+    ...u,
+    ...s
+  }, u.logging.enabled)
+    for (console.info("Flushing", f.length, "pending logs"); f.length; )
+      console.log(...f.shift());
+}, K = () => {
+  if (!m())
+    return !1;
+  const s = i.upgradeToRealStorage();
+  return s && E("react-wire-persisted: Upgraded to real localStorage after hydration"), s;
+}, E = (...s) => {
+  u.logging.enabled ? console.log(...s) : f.push(s);
+}, W = (s, e = null) => {
+  if (!s && typeof s != "number") throw new Error(
+    `createPersistedWire: Key cannot be a falsey value (${s}}`
+  );
+  i.register(s, e);
+  const t = U(e), r = () => t.getValue(), o = (c) => (i.setItem(s, c), t.setValue(c)), n = (c) => {
+    t.subscribe(c);
+  }, a = i.getItem(s), l = a === null ? e : a;
+  return E("react-wire-persisted: create", s, {
+    value: e,
+    storedValue: a,
+    initialValue: l
+  }), l !== e && o(l), {
+    ...t,
+    getValue: r,
+    setValue: o,
+    subscribe: n
+  };
+}, J = (s = {}) => {
+  const {
+    autoUpgrade: e = !0,
+    onUpgrade: t
+  } = s, r = b(!1);
+  return O(() => {
+    if (!e || r.current || !m())
+      return;
+    const o = () => {
+      _() && !r.current && K() && (r.current = !0, t?.());
+    };
+    o();
+    const n = setTimeout(o, 0);
+    return () => clearTimeout(n);
+  }, [e, t]), {
+    hasUpgraded: r.current
+  };
+};
+function D({ children: s, onUpgrade: e, autoUpgrade: t = !0 }) {
+  const r = b(!1);
+  return O(() => {
+    if (!t || r.current || !m())
+      return;
+    const o = () => {
+      _() && !r.current && K() && (r.current = !0, e?.());
+    };
+    o();
+    const n = setTimeout(o, 0);
+    return () => clearTimeout(n);
+  }, [t, e]), s;
+}
+export {
+  D as HydrationProvider,
+  W as createPersistedWire,
+  L as defaultOptions,
+  P as getNamespace,
+  $ as getOptions,
+  V as getStorage,
+  C as setNamespace,
+  H as setOptions,
+  K as upgradeStorage,
+  J as useHydration,
+  k as utils
+};

package/dist/react-wire-persisted.umd.cjs

@@ -0,0 +1 @@
+(function(n,l){typeof exports=="object"&&typeof module<"u"?l(exports,require("@forminator/react-wire"),require("react")):typeof define=="function"&&define.amd?define(["exports","@forminator/react-wire","react"],l):(n=typeof globalThis<"u"?globalThis:n||self,l(n["react-wire-persisted"]={},n.reactWire,n.React))})(this,(function(n,l,f){"use strict";(function(){const s={};try{if(process){process.env=Object.assign({},process.env),Object.assign(process.env,s);return}}catch{}globalThis.process={env:s}})();const S={},v=s=>{S[s]=s},P=s=>v(s),U=()=>S,R=(s,e=null)=>{const t=e||S;return s?Object.keys(t).reduce((r,o)=>({...r,[o]:`${s}.${t[o]}`}),{}):t},m={__IS_FAKE_LOCAL_STORAGE__:!0},_={getItem:s=>m[s],setItem:(s,e)=>{m[s]=e},removeItem:s=>{delete m[s]},...m};let I=!1,O=!1;typeof window<"u"&&(I=!0,document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>{O=!0}):O=!0);const h=()=>I,b=()=>O,p=()=>{if(!I)return!1;try{const s="__rwp_test__";return window.localStorage.setItem(s,"test"),window.localStorage.removeItem(s),!0}catch{return!1}},T=s=>{const e=typeof s;return s===null?!0:Array.isArray(s)||e==="object"?!1:e!=="function"},L=Object.freeze(Object.defineProperty({__proto__:null,addKey:v,fakeLocalStorage:_,getHasHydrated:b,getIsClient:h,getKeys:U,getPrefixedKeys:R,isLocalStorageAvailable:p,isPrimitive:T,key:P},Symbol.toStringTag,{value:"Module"}));class w{constructor(e,t){if(new.target===w)throw TypeError("StorageProvider is abstract. Extend this class to implement it");this.namespace=e||null,this.registry=t||{}}setNamespace(e){}register(e,t){this.registry[e]=t}getItem(e){}setItem(e,t){}removeItem(e,t=!1){}getAll(){}_resetAll(e=!0,t=[],r=!1){}resetAll(e=[]){}removeAll(e=[]){}}class F extends w{constructor(e=null,t={}){super(e,t),this.storage=this.getStorage(),this._isUsingFakeStorage=!p()}getStorage(){return p()?window.localStorage:_}setNamespace(e){if(!this.namespace){this.namespace=e;return}if(this.namespace===e)return;const t=JSON.parse(JSON.stringify(this.getAll()));this.removeAll();for(const[r,o]of Object.entries(t)){const i=r.replace(this.namespace,e);this.setItem(i,o)}this.namespace=e}getItem(e){const t=this.storage.getItem(e);if(t==null)return null;try{return JSON.parse(t)}catch{return t}}setItem(e,t){let r=t;return r!=null&&(r=T(t)?t:JSON.stringify(t)),this.storage.setItem(e,r)}removeItem(e,t=!1){return t&&delete this.registry[e],this.storage.removeItem(e)}getAll(){const e=`${this.namespace}.`;return Object.keys(this.storage).reduce((t,r)=>((!this.namespace||r.startsWith(e))&&(t[r]=this.storage.getItem(r)),t),{})}_resetAll(e=!0,t=[],r=!1){const o=`${this.namespace}.`;Object.keys(this.storage).forEach(i=>{const c=this.namespace?i.startsWith(o):!0,g=t?.includes(i)||!1;!c||g||(e?Object.prototype.hasOwnProperty.call(this.registry,i)?this.storage.setItem(i,this.registry[i]):this.storage.removeItem(i):(this.storage.removeItem(i),r&&delete this.registry[i]))})}resetAll(e=[],t=!1){this._resetAll(!0,e||[],t)}removeAll(e=[],t=!1){this._resetAll(!1,e||[],t)}upgradeToRealStorage(){if(!this._isUsingFakeStorage||!p())return!1;const e={...this.storage};return this.storage=window.localStorage,this._isUsingFakeStorage=!1,Object.keys(e).forEach(t=>{if(t!=="__IS_FAKE_LOCAL_STORAGE__"&&e[t]!=null)try{this.storage.setItem(t,e[t])}catch{return this.storage=_,this._isUsingFakeStorage=!0,!1}}),!0}isUsingFakeStorage(){return this._isUsingFakeStorage}}const j={logging:{enabled:!1}};let E=F,a=new E,u={...j},y=[];const K=()=>a.namespace,k=()=>a,H=()=>u,W=s=>{a.setNamespace(s),a=new E(s||K())},V=s=>{if(u={...u,...s},u.logging.enabled)for(console.info("Flushing",y.length,"pending logs");y.length;)console.log(...y.shift())},A=()=>{if(!h())return!1;const s=a.upgradeToRealStorage();return s&&N("react-wire-persisted: Upgraded to real localStorage after hydration"),s},N=(...s)=>{u.logging.enabled?console.log(...s):y.push(s)},$=(s,e=null)=>{if(!s&&typeof s!="number")throw new Error(`createPersistedWire: Key cannot be a falsey value (${s}}`);a.register(s,e);const t=l.createWire(e),r=()=>t.getValue(),o=d=>(a.setItem(s,d),t.setValue(d)),i=d=>{t.subscribe(d)},c=a.getItem(s),g=c===null?e:c;return N("react-wire-persisted: create",s,{value:e,storedValue:c,initialValue:g}),g!==e&&o(g),{...t,getValue:r,setValue:o,subscribe:i}},C=(s={})=>{const{autoUpgrade:e=!0,onUpgrade:t}=s,r=f.useRef(!1);return f.useEffect(()=>{if(!e||r.current||!h())return;const o=()=>{b()&&!r.current&&A()&&(r.current=!0,t?.())};o();const i=setTimeout(o,0);return()=>clearTimeout(i)},[e,t]),{hasUpgraded:r.current}};function J({children:s,onUpgrade:e,autoUpgrade:t=!0}){const r=f.useRef(!1);return f.useEffect(()=>{if(!t||r.current||!h())return;const o=()=>{b()&&!r.current&&A()&&(r.current=!0,e?.())};o();const i=setTimeout(o,0);return()=>clearTimeout(i)},[t,e]),s}n.HydrationProvider=J,n.createPersistedWire=$,n.defaultOptions=j,n.getNamespace=K,n.getOptions=H,n.getStorage=k,n.setNamespace=W,n.setOptions=V,n.upgradeStorage=A,n.useHydration=C,n.utils=L,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));

package/nextjs.js

@@ -0,0 +1,40 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+
+/**
+ * Simple Next.js App Router compatible component for react-wire-persisted
+ * This component handles the localStorage hydration issue in Next.js
+ *
+ * Usage:
+ * import { NextJSHydrationProvider } from 'react-wire-persisted/nextjs'
+ *
+ * <NextJSHydrationProvider>
+ *   <YourApp />
+ * </NextJSHydrationProvider>
+ */
+export function NextJSHydrationProvider({ children }) {
+    const [isHydrated, setIsHydrated] = useState(false)
+
+    useEffect(() => {
+        // Mark as hydrated and try to upgrade storage
+        setIsHydrated(true)
+
+        // Dynamically import and upgrade storage after hydration
+        if (typeof window !== 'undefined') {
+            import('./dist/react-wire-persisted.js')
+                .then(module => {
+                    // Attempt to upgrade storage
+                    if (module.upgradeStorage) {
+                        module.upgradeStorage()
+                    }
+                })
+                .catch(err => {
+                    console.warn('Failed to upgrade react-wire-persisted storage:', err)
+                })
+        }
+    }, [])
+
+    // Render children immediately, but storage upgrade happens after hydration
+    return children
+}

package/package.json

@@ -1,54 +1,66 @@
 {
   "name": "react-wire-persisted",
-  "version": "1.5.0",
+  "version": "2.0.1",
   "author": "Wesley Bliss <wesley.bliss@gmail.com>",
   "license": "MIT",
   "type": "module",
   "main": "./dist/react-wire-persisted.umd.cjs",
-  "module": "./dist/react-wire-persisted.mjs",
+  "module": "./dist/index.js",
   "files": [
     "src",
-    "dist"
+    "dist",
+    "client.js",
+    "client.mjs",
+    "nextjs.js"
   ],
   "exports": {
     ".": {
-      "import": "./dist/react-wire-persisted.mjs",
+      "import": "./dist/react-wire-persisted.js",
       "require": "./dist/react-wire-persisted.umd.cjs"
+    },
+    "./client": {
+      "import": "./client.mjs",
+      "require": "./client.js"
+    },
+    "./nextjs": {
+      "import": "./nextjs.js",
+      "require": "./nextjs.js"
     }
   },
   "scripts": {
     "dev": "vite --host --config config/vite.config.development.js",
-    "build": "vite build --config config/vite.config.production.js",
+    "build": "vite build --config config/vite.config.production.js && cp dist/react-wire-persisted.js dist/index.js",
     "test:unit": "NODE_ENV=test vitest run",
     "test:unit:only": "NODE_ENV=test vitest run -t ",
-    "test:unit:coverage": "NODE_ENV=test vitest run --no-color --reporter=junit --coverage --outputFile=coverage/report.xml"
+    "test:unit:coverage": "NODE_ENV=test vitest run --no-color --reporter=junit --coverage --outputFile=coverage/report.xml",
+    "yalc": "pnpm build && yalc push"
   },
   "devDependencies": {
     "@forminator/react-wire": "^0.7.0",
-    "@testing-library/jest-dom": "^6.6.4",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.8.0",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
-    "@vitejs/plugin-react": "^4.7.0",
-    "@vitest/coverage-c8": "^0.33.0",
-    "browserslist": "^4.25.1",
-    "c8": "^10.1.3",
-    "dotenv": "^17.2.1",
-    "esbuild": "^0.25.8",
-    "jest": "^30.0.5",
-    "jest-environment-jsdom": "^30.0.5",
+    "@vitejs/plugin-react": "^5.0.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "browserslist": "^4.26.2",
+    "dotenv": "^17.2.2",
+    "esbuild": "^0.25.10",
+    "jest": "^30.1.3",
+    "jest-environment-jsdom": "^30.1.2",
     "np": "^10.2.0",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "rollup-plugin-inject-process-env": "^1.3.1",
     "snapshot-diff": "^0.10.0",
-    "vite": "^7.0.6",
+    "vite": "^7.1.7",
     "vite-jest": "^0.1.4",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
-    "@forminator/react-wire": "^0.5.0-alpha.1",
-    "react": "^17.0.2",
-    "react-dom": "^17.0.2"
+    "@forminator/react-wire": "^0.7.0",
+    "react": "^18.3.1 || ^19.0.0",
+    "react-dom": "^18.3.1 || ^19.0.0"
   },
   "browserslist": {
     "production": [

package/src/components/HydrationProvider.js

@@ -0,0 +1,45 @@
+'use client'
+
+import { useEffect, useRef } from 'react'
+import { upgradeStorage } from '../react-wire-persisted'
+import { getIsClient, getHasHydrated } from '../utils'
+
+/**
+ * A Next.js App Router compatible component that handles automatic storage upgrade
+ * after hydration. Use this in your root layout.
+ *
+ * @param {Object} props Component props
+ * @param {React.ReactNode} props.children Child components to render
+ * @param {Function} props.onUpgrade Callback called when storage is upgraded
+ * @param {Boolean} props.autoUpgrade Whether to automatically upgrade storage (default: true)
+ */
+export function HydrationProvider({ children, onUpgrade, autoUpgrade = true }) {
+    const hasUpgraded = useRef(false)
+
+    useEffect(() => {
+        if (!autoUpgrade || hasUpgraded.current || !getIsClient()) {
+            return
+        }
+
+        const attemptUpgrade = () => {
+            if (getHasHydrated() && !hasUpgraded.current) {
+                const upgraded = upgradeStorage()
+
+                if (upgraded) {
+                    hasUpgraded.current = true
+                    onUpgrade?.()
+                }
+            }
+        }
+
+        // Try to upgrade immediately if already hydrated
+        attemptUpgrade()
+
+        // Also try after a short delay to ensure DOM is ready
+        const timeoutId = setTimeout(attemptUpgrade, 0)
+
+        return () => clearTimeout(timeoutId)
+    }, [autoUpgrade, onUpgrade])
+
+    return children
+}

package/src/components/HydrationProvider.jsx

@@ -0,0 +1,17 @@
+'use client'
+
+import { useHydration } from '../hooks/useHydration'
+
+/**
+ * A Next.js App Router compatible component that handles automatic storage upgrade
+ * after hydration. Use this in your root layout.
+ *
+ * @param {Object} props Component props
+ * @param {React.ReactNode} props.children Child components to render
+ * @param {Function} props.onUpgrade Callback called when storage is upgraded
+ * @param {Boolean} props.autoUpgrade Whether to automatically upgrade storage (default: true)
+ */
+export function HydrationProvider({ children, onUpgrade, autoUpgrade = true }) {
+    useHydration({ onUpgrade, autoUpgrade })
+    return children
+}

package/src/components/index.js

@@ -0,0 +1 @@
+export { HydrationProvider } from './HydrationProvider.js'

package/src/hooks/useHydration.js

@@ -0,0 +1,58 @@
+'use client'
+
+import { useEffect, useRef } from 'react'
+import { upgradeStorage } from '../react-wire-persisted'
+import { getIsClient, getHasHydrated } from '../utils'
+
+/**
+ * React hook that handles automatic storage upgrade after hydration
+ * This should be used in the root component of your application
+ *
+ * @param {Object} options Configuration options
+ * @param {Boolean} options.autoUpgrade Whether to automatically upgrade storage (default: true)
+ * @param {Function} options.onUpgrade Callback called when storage is upgraded
+ */
+export const useHydration = (options = {}) => {
+    
+    const {
+        autoUpgrade = true,
+        onUpgrade
+    } = options
+    
+    const hasUpgraded = useRef(false)
+    
+    useEffect(() => {
+        
+        if (!autoUpgrade || hasUpgraded.current || !getIsClient())
+            return
+        
+        const attemptUpgrade = () => {
+            
+            if (getHasHydrated() && !hasUpgraded.current) {
+                
+                const upgraded = upgradeStorage()
+                
+                if (upgraded) {
+                    hasUpgraded.current = true
+                    onUpgrade?.()
+                }
+                
+            }
+            
+        }
+        
+        // Try to upgrade immediately if already hydrated
+        attemptUpgrade()
+        
+        // Also try after a short delay to ensure DOM is ready
+        const timeoutId = setTimeout(attemptUpgrade, 0)
+        
+        return () => clearTimeout(timeoutId)
+        
+    }, [autoUpgrade, onUpgrade])
+    
+    return {
+        hasUpgraded: hasUpgraded.current
+    }
+    
+}

package/src/index.js

@@ -2,3 +2,5 @@ import * as utils from './utils'
 
 export { utils }
 export * from './react-wire-persisted'
+export * from './hooks/useHydration'
+export * from './components'

package/src/providers/LocalStorageProvider.js

@@ -1,5 +1,5 @@
 import StorageProvider from './StorageProvider'
-import { fakeLocalStorage, isPrimitive } from '../utils'
+import { fakeLocalStorage, isPrimitive, isLocalStorageAvailable } from '../utils'
 
 /**
  * A storage provider for `localStorage`
@@ -8,24 +8,24 @@ import { fakeLocalStorage, isPrimitive } from '../utils'
 class LocalStorageProvider extends StorageProvider {
     
     constructor(namespace = null, registry = {}) {
-        
+
         super(namespace, registry)
-        
+
         this.storage = this.getStorage()
-        
+        this._isUsingFakeStorage = !isLocalStorageAvailable()
+
     }
     
     getStorage() {
-        
-        try {
+
+        // Use the isomorphic utility to check localStorage availability
+        if (isLocalStorageAvailable()) {
             return window.localStorage
-        } catch (e) {
-            /* istanbul ignore next */
-            console.warn(new Error('LocalStorageProvider: localStorage not supported'))
-            /* istanbul ignore next */
-            return fakeLocalStorage
         }
-        
+
+        // Fallback to fake localStorage for SSR or when localStorage is disabled
+        return fakeLocalStorage
+
     }
     
     setNamespace(namespace) {
@@ -107,36 +107,36 @@ class LocalStorageProvider extends StorageProvider {
         excludedKeys = [],
         clearRegistry = false
     ) {
-        
+
         const prefixNs = `${this.namespace}.`
-        
-        Object.keys(localStorage).forEach(it => {
-            
+
+        Object.keys(this.storage).forEach(it => {
+
             const isAppKey = this.namespace ? it.startsWith(prefixNs) : true
             const isExcluded = excludedKeys?.includes(it) || false
-            
+
             if (!isAppKey || isExcluded) return
-            
+
             if (useInitialValues) {
-                
+
                 const isRegistered = Object.prototype.hasOwnProperty.call(this.registry, it)
-                
+
                 if (isRegistered)
                     this.storage.setItem(it, this.registry[it])
                 else
                     this.storage.removeItem(it)
-                
+
             } else {
-                
+
                 this.storage.removeItem(it)
-                
+
                 if (clearRegistry)
                     delete this.registry[it]
-                
+
             }
-            
+
         })
-        
+
     }
     
     resetAll(excludedKeys = [], clearRegistry = false) {
@@ -146,7 +146,49 @@ class LocalStorageProvider extends StorageProvider {
     removeAll(excludedKeys = [], clearRegistry = false) {
         this._resetAll(false, excludedKeys || [], clearRegistry)
     }
-    
+
+    /**
+     * Attempt to upgrade from fake storage to real localStorage
+     * This is useful for hydration scenarios
+     */
+    upgradeToRealStorage() {
+
+        if (!this._isUsingFakeStorage) {
+            return false // Already using real storage
+        }
+
+        if (!isLocalStorageAvailable()) {
+            return false // Real storage still not available
+        }
+
+        const fakeData = { ...this.storage }
+        this.storage = window.localStorage
+        this._isUsingFakeStorage = false
+
+        // Migrate data from fake storage to real storage
+        Object.keys(fakeData).forEach(key => {
+            if (key !== '__IS_FAKE_LOCAL_STORAGE__' && fakeData[key] != null) {
+                try {
+                    this.storage.setItem(key, fakeData[key])
+                } catch (e) {
+                    // If we can't write to localStorage, revert to fake storage
+                    this.storage = fakeLocalStorage
+                    this._isUsingFakeStorage = true
+                    return false
+                }
+            }
+        })
+
+        return true
+    }
+
+    /**
+     * Check if currently using fake storage
+     */
+    isUsingFakeStorage() {
+        return this._isUsingFakeStorage
+    }
+
 }
 
 export default LocalStorageProvider

package/src/react-wire-persisted.js

@@ -1,5 +1,6 @@
 import { createWire } from '@forminator/react-wire'
 import LocalStorageProvider from './providers/LocalStorageProvider'
+import { getIsClient, getHasHydrated } from './utils'
 
 export const defaultOptions = {
     logging: {
@@ -52,6 +53,26 @@ export const setOptions = value => {
     }
 }
 
+/**
+ * Attempts to upgrade the storage provider from fake storage to real localStorage
+ * This should be called on the client side after hydration
+ *
+ * @returns {Boolean} True if upgrade was successful
+ */
+export const upgradeStorage = () => {
+    if (!getIsClient()) {
+        return false
+    }
+
+    const upgraded = storage.upgradeToRealStorage()
+
+    if (upgraded) {
+        log('react-wire-persisted: Upgraded to real localStorage after hydration')
+    }
+
+    return upgraded
+}
+
 const log = (...args) => {
     /* istanbul ignore next */
     if (options.logging.enabled)

package/src/utils/fakeLocalStorage.js

@@ -4,11 +4,13 @@ const storage = {
 }
 
 export const fakeLocalStorage = {
-    getItem: key => fakeLocalStorage[key],
+    getItem: key => storage[key],
     setItem: (key, value) => {
-        fakeLocalStorage[key] = value
+        storage[key] = value
     },
     removeItem: key => {
-        delete fakeLocalStorage[key]
-    }
+        delete storage[key]
+    },
+    // Make Object.keys() work properly for _resetAll method
+    ...storage
 }

package/src/utils/index.js

@@ -1,5 +1,6 @@
 export * from './keys'
 export * from './fakeLocalStorage'
+export * from './isomorphic'
 
 /**
  * Checks if a value is a primitive type

package/src/utils/isomorphic.js

@@ -0,0 +1,46 @@
+/**
+ * Utilities for handling server-side rendering and client-side hydration
+ */
+
+let isClient = false
+let hasHydrated = false
+
+// Detect if we're running in a browser environment
+if (typeof window !== 'undefined') {
+    isClient = true
+
+    // Mark as hydrated when the DOM is ready
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => {
+            hasHydrated = true
+        })
+    } else {
+        hasHydrated = true
+    }
+}
+
+/**
+ * Check if we're running in a browser environment
+ */
+export const getIsClient = () => isClient
+
+/**
+ * Check if the client has finished hydrating
+ */
+export const getHasHydrated = () => hasHydrated
+
+/**
+ * Check if localStorage is available and safe to use
+ */
+export const isLocalStorageAvailable = () => {
+    if (!isClient) return false
+
+    try {
+        const testKey = '__rwp_test__'
+        window.localStorage.setItem(testKey, 'test')
+        window.localStorage.removeItem(testKey)
+        return true
+    } catch (e) {
+        return false
+    }
+}

package/dist/react-wire-persisted.umd.js

@@ -1 +0,0 @@
-(function(n,a){typeof exports=="object"&&typeof module<"u"?a(exports,require("@forminator/react-wire")):typeof define=="function"&&define.amd?define(["exports","@forminator/react-wire"],a):(n=typeof globalThis<"u"?globalThis:n||self,a(n["react-wire-persisted"]={},n.reactWire))})(this,function(n,a){"use strict";(function(){const s={};try{if(process){process.env=Object.assign({},process.env),Object.assign(process.env,s);return}}catch{}globalThis.process={env:s}})();const h={},y=s=>{h[s]=s},w=s=>y(s),v=()=>h,A=(s,e=null)=>{const t=e||h;return s?Object.keys(t).reduce((r,o)=>({...r,[o]:`${s}.${t[o]}`}),{}):t},c={getItem:s=>c[s],setItem:(s,e)=>{c[s]=e},removeItem:s=>{delete c[s]}},b=s=>{const e=typeof s;return s===null?!0:Array.isArray(s)||e==="object"?!1:e!=="function"},N=Object.freeze(Object.defineProperty({__proto__:null,addKey:y,fakeLocalStorage:c,getKeys:v,getPrefixedKeys:A,isPrimitive:b,key:w},Symbol.toStringTag,{value:"Module"}));class p{constructor(e,t){if(new.target===p)throw TypeError("StorageProvider is abstract. Extend this class to implement it");this.namespace=e||null,this.registry=t||{}}setNamespace(e){}register(e,t){this.registry[e]=t}getItem(e){}setItem(e,t){}removeItem(e,t=!1){}getAll(){}_resetAll(e=!0,t=[],r=!1){}resetAll(e=[]){}removeAll(e=[]){}}class j extends p{constructor(e=null,t={}){super(e,t),this.storage=this.getStorage()}getStorage(){try{return window.localStorage}catch{return console.warn(new Error("LocalStorageProvider: localStorage not supported")),c}}setNamespace(e){if(!this.namespace){this.namespace=e;return}if(this.namespace===e)return;const t=JSON.parse(JSON.stringify(this.getAll()));this.removeAll();for(const[r,o]of Object.entries(t)){const i=r.replace(this.namespace,e);this.setItem(i,o)}this.namespace=e}getItem(e){const t=this.storage.getItem(e);if(t==null)return null;try{return JSON.parse(t)}catch{return t}}setItem(e,t){let r=t;return r!=null&&(r=b(t)?t:JSON.stringify(t)),this.storage.setItem(e,r)}removeItem(e,t=!1){return t&&delete this.registry[e],this.storage.removeItem(e)}getAll(){const e=`${this.namespace}.`;return Object.keys(this.storage).reduce((t,r)=>((!this.namespace||r.startsWith(e))&&(t[r]=this.storage.getItem(r)),t),{})}_resetAll(e=!0,t=[],r=!1){const o=`${this.namespace}.`;Object.keys(localStorage).forEach(i=>{const u=this.namespace?i.startsWith(o):!0,f=t?.includes(i)||!1;!u||f||(e?Object.prototype.hasOwnProperty.call(this.registry,i)?this.storage.setItem(i,this.registry[i]):this.storage.removeItem(i):(this.storage.removeItem(i),r&&delete this.registry[i]))})}resetAll(e=[],t=!1){this._resetAll(!0,e||[],t)}removeAll(e=[],t=!1){this._resetAll(!1,e||[],t)}}const O={logging:{enabled:!1}};let I=j,l=new I,g={...O},m=[];const S=()=>l.namespace,P=()=>l,K=()=>g,W=s=>{l.setNamespace(s),l=new I(s||S())},_=s=>{if(g={...g,...s},g.logging.enabled)for(console.info("Flushing",m.length,"pending logs");m.length;)console.log(...m.shift())},E=(...s)=>{g.logging.enabled?console.log(...s):m.push(s)},T=(s,e=null)=>{if(!s&&typeof s!="number")throw new Error(`createPersistedWire: Key cannot be a falsey value (${s}}`);l.register(s,e);const t=a.createWire(e),r=()=>t.getValue(),o=d=>(l.setItem(s,d),t.setValue(d)),i=d=>{t.subscribe(d)},u=l.getItem(s),f=u===null?e:u;return E("react-wire-persisted: create",s,{value:e,storedValue:u,initialValue:f}),f!==e&&o(f),{...t,getValue:r,setValue:o,subscribe:i}};n.createPersistedWire=T,n.defaultOptions=O,n.getNamespace=S,n.getOptions=K,n.getStorage=P,n.setNamespace=W,n.setOptions=_,n.utils=N,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})});