react-wire-persisted 1.0.6 → 1.3.0

package/dist/react-wire-persisted.mjs

@@ -0,0 +1,232 @@
+import { createWire as b } from "@forminator/react-wire";
+(function() {
+  const s = {};
+  try {
+    if (process) {
+      process.env = Object.assign({}, process.env), Object.assign(process.env, s);
+      return;
+    }
+  } catch {
+  }
+  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) => ({
+    ...r,
+    [n]: `${s}.${t[n]}`
+  }), {}) : t;
+}, g = {
+  getItem: (s) => g[s],
+  setItem: (s, e) => {
+    g[s] = e;
+  },
+  removeItem: (s) => {
+    delete g[s];
+  }
+}, d = (s) => {
+  const e = typeof s;
+  return s === null ? !0 : Array.isArray(s) || e === "object" ? !1 : e !== "function";
+}, P = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  addKey: p,
+  fakeLocalStorage: g,
+  getKeys: O,
+  getPrefixedKeys: S,
+  isPrimitive: d,
+  key: I
+}, Symbol.toStringTag, { value: "Module" }));
+class h {
+  /**
+   * 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)
+      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 v extends h {
+  constructor(e = null, t = {}) {
+    super(e, t), this.storage = this.getStorage();
+  }
+  getStorage() {
+    try {
+      return window.localStorage;
+    } catch {
+      return console.warn("LocalStorageProvider: localStorage not supported"), g;
+    }
+  }
+  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, n] of Object.entries(t)) {
+      const o = r.replace(this.namespace, e);
+      this.setItem(o, n);
+    }
+    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 = d(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 n = `${this.namespace}.`;
+    Object.keys(localStorage).forEach((o) => {
+      const l = this.namespace ? o.startsWith(n) : !0, a = (t == null ? void 0 : 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]));
+    });
+  }
+  resetAll(e = [], t = !1) {
+    this._resetAll(!0, e || [], t);
+  }
+  removeAll(e = [], t = !1) {
+    this._resetAll(!1, e || [], t);
+  }
+}
+const A = {
+  logging: {
+    enabled: !1
+  }
+};
+let y = v, i = new y(), u = { ...A }, f = [];
+const w = () => i.namespace, x = () => i, _ = () => u, K = (s) => {
+  i.setNamespace(s), i = new y(s || w());
+}, V = (s) => {
+  if (u = {
+    ...u,
+    ...s
+  }, u.logging.enabled)
+    for (console.info("Flushing", f.length, "pending logs"); f.length; )
+      console.log(...f.shift());
+}, N = (...s) => {
+  u.logging.enabled ? console.log(...s) : f.push(s);
+}, E = (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) => {
+    t.subscribe(c);
+  }, l = i.getItem(s), a = l === null ? e : l;
+  return N("react-wire-persisted: create", s, {
+    value: e,
+    storedValue: l,
+    initialValue: a
+  }), a !== e && n(a), {
+    ...t,
+    getValue: r,
+    setValue: n,
+    subscribe: o
+  };
+};
+export {
+  E as createPersistedWire,
+  A as defaultOptions,
+  w as getNamespace,
+  _ as getOptions,
+  x as getStorage,
+  K as setNamespace,
+  V as setOptions,
+  P as utils
+};

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

@@ -0,0 +1 @@
+(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 p={},y=s=>{p[s]=s},v=s=>y(s),w=()=>p,A=(s,e=null)=>{const t=e||p;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:w,getPrefixedKeys:A,isPrimitive:b,key:v},Symbol.toStringTag,{value:"Module"}));class d{constructor(e,t){if(new.target===d)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 d{constructor(e=null,t={}){super(e,t),this.storage=this.getStorage()}getStorage(){try{return window.localStorage}catch{return console.warn("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==null?void 0: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},h=[];const S=()=>l.namespace,P=()=>l,W=()=>g,_=s=>{l.setNamespace(s),l=new I(s||S())},K=s=>{if(g={...g,...s},g.logging.enabled)for(console.info("Flushing",h.length,"pending logs");h.length;)console.log(...h.shift())},T=(...s)=>{g.logging.enabled?console.log(...s):h.push(s)},V=(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=m=>(l.setItem(s,m),t.setValue(m)),i=m=>{t.subscribe(m)},u=l.getItem(s),f=u===null?e:u;return T("react-wire-persisted: create",s,{value:e,storedValue:u,initialValue:f}),f!==e&&o(f),{...t,getValue:r,setValue:o,subscribe:i}};n.createPersistedWire=V,n.defaultOptions=O,n.getNamespace=S,n.getOptions=W,n.getStorage=P,n.setNamespace=_,n.setOptions=K,n.utils=N,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,52 +1,49 @@
 {
   "name": "react-wire-persisted",
-  "version": "1.0.6",
+  "version": "1.3.0",
   "author": "Wesley Bliss <wesley.bliss@gmail.com>",
   "license": "MIT",
-  "main": "lib/react-wire-persisted.js",
+  "main": "./dist/react-wire-persisted.umd.cjs",
+  "module": "./dist/react-wire-persisted.mjs",
   "files": [
-    "lib"
+    "src",
+    "dist"
   ],
+  "exports": {
+    ".": {
+      "import": "./dist/react-wire-persisted.mjs",
+      "require": "./dist/react-wire-persisted.umd.cjs"
+    }
+  },
   "scripts": {
-    "dev": "NODE_ENV=development webpack serve --config config/webpack.config.js --progress",
-    "build": "NODE_ENV=production webpack --config config/webpack.config.js --progress",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:watch:all": "jest --watchAll",
-    "test:watch:coverage": "jest --watch --collectCoverage",
-    "test:snapshots": "jest --updateSnapshot",
-    "test:coverage": "jest --collectCoverage",
-    "test:ci": "jest --runInBand"
+    "dev": "vite --host --config config/vite.config.development.js",
+    "build": "vite build --config config/vite.config.production.js",
+    "test:unit": "NODE_ENV=test vitest run --threads=false",
+    "test:unit:only": "NODE_ENV=test vitest run --threads=false -t ",
+    "test:unit:coverage": "NODE_ENV=test vitest run --threads=false --no-color --reporter=junit --coverage --outputFile=coverage/report.xml"
   },
   "dependencies": {},
   "devDependencies": {
-    "@babel/core": "^7.17.5",
-    "@babel/plugin-transform-runtime": "^7.17.0",
-    "@babel/preset-env": "^7.16.11",
-    "@babel/preset-react": "^7.16.7",
-    "@forminator/react-wire": "^0.5.0-alpha.1",
-    "@pmmmwh/react-refresh-webpack-plugin": "^0.5.4",
-    "@testing-library/jest-dom": "^5.16.2",
-    "@testing-library/react": "^12.1.3",
-    "babel-jest": "^27.5.1",
-    "babel-loader": "^8.2.3",
-    "browserslist": "^4.19.3",
-    "clean-webpack-plugin": "^4.0.0",
-    "css-loader": "^6.6.0",
-    "dotenv-webpack": "^7.1.0",
-    "esbuild": "^0.14.23",
-    "html-webpack-plugin": "^5.5.0",
-    "interpolate-html-plugin": "^4.0.0",
-    "jest": "^27.5.1",
-    "react": "^17.0.2",
-    "react-dom": "^17.0.2",
-    "snapshot-diff": "^0.9.0",
-    "style-loader": "^3.3.1",
-    "webpack": "^5.69.1",
-    "webpack-bundle-analyzer": "^4.5.0",
-    "webpack-cli": "^4.9.2",
-    "webpack-dev-server": "^4.7.4",
-    "webpack-node-externals": "^3.0.0"
+    "@forminator/react-wire": "^0.6.0",
+    "@testing-library/jest-dom": "^5.16.5",
+    "@testing-library/react": "^14.0.0",
+    "@testing-library/user-event": "^14.4.3",
+    "@vitejs/plugin-react": "^3.1.0",
+    "@vitest/coverage-c8": "^0.28.5",
+    "browserslist": "^4.21.5",
+    "c8": "^7.13.0",
+    "dotenv": "^16.0.3",
+    "esbuild": "^0.17.10",
+    "jest": "^29.4.3",
+    "jest-environment-jsdom": "^29.4.3",
+    "np": "^7.6.3",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rollup-plugin-inject-process-env": "^1.3.1",
+    "snapshot-diff": "^0.10.0",
+    "vite": "^4.1.4",
+    "vite-jest": "^0.1.4",
+    "vitest": "^0.28.5"
   },
   "peerDependencies": {
     "@forminator/react-wire": "^0.5.0-alpha.1",

package/src/index.js

@@ -0,0 +1,4 @@
+import * as utils from './utils'
+
+export { utils }
+export * from './react-wire-persisted'

package/src/providers/LocalStorageProvider.js

@@ -0,0 +1,152 @@
+import StorageProvider from './StorageProvider'
+import { fakeLocalStorage, isPrimitive } from '../utils'
+
+/**
+ * A storage provider for `localStorage`
+ * @see `StorageProvider.js` for documentation
+ */
+class LocalStorageProvider extends StorageProvider {
+    
+    constructor(namespace = null, registry = {}) {
+        
+        super(namespace, registry)
+        
+        this.storage = this.getStorage()
+        
+    }
+    
+    getStorage() {
+        
+        try {
+            return window.localStorage
+        } catch (e) {
+            /* istanbul ignore next */
+            console.warn('LocalStorageProvider: localStorage not supported')
+            /* istanbul ignore next */
+            return fakeLocalStorage
+        }
+        
+    }
+    
+    setNamespace(namespace) {
+        
+        if (!this.namespace) {
+            this.namespace = namespace
+            return
+        }
+        
+        if (this.namespace === namespace)
+            return
+        
+        const items = JSON.parse(JSON.stringify(this.getAll()))
+        
+        this.removeAll()
+        
+        for (const [key, value] of Object.entries(items)) {
+            const newKey = key.replace(this.namespace, namespace)
+            this.setItem(newKey, value)
+        }
+        
+        this.namespace = namespace
+        
+    }
+    
+    getItem(key) {
+        
+        const val = this.storage.getItem(key)
+        
+        if (val === undefined || val === null)
+            return null
+        
+        try {
+            return JSON.parse(val)
+        } catch (e) {
+            return val
+        }
+        
+    }
+    
+    setItem(key, value) {
+        
+        let val = value
+        
+        // Don't allow "null" & similar values to be stringified
+        if (val !== undefined && val !== null)
+            val = isPrimitive(value) ? value : JSON.stringify(value)
+        
+        return this.storage.setItem(key, val)
+        
+    }
+    
+    removeItem(key, fromRegistry = false) {
+        
+        if (fromRegistry)
+            delete this.registry[key]
+        
+        return this.storage.removeItem(key)
+        
+    }
+    
+    getAll() {
+        
+        const prefixNs = `${this.namespace}.`
+        
+        return Object.keys(this.storage).reduce((acc, it) => {
+            
+            if (this.namespace ? it.startsWith(prefixNs) : true)
+                acc[it] = this.storage.getItem(it)
+            
+            return acc
+            
+        }, {})
+        
+    }
+    
+    _resetAll(
+        useInitialValues = true,
+        excludedKeys = [],
+        clearRegistry = false
+    ) {
+        
+        const prefixNs = `${this.namespace}.`
+        
+        Object.keys(localStorage).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) {
+        this._resetAll(true, excludedKeys || [], clearRegistry)
+    }
+    
+    removeAll(excludedKeys = [], clearRegistry = false) {
+        this._resetAll(false, excludedKeys || [], clearRegistry)
+    }
+    
+}
+
+export default LocalStorageProvider

package/src/providers/MemoryStorageProvider.js

@@ -0,0 +1,20 @@
+import LocalStorageProvider from './LocalStorageProvider'
+import { fakeLocalStorage } from '../utils'
+
+class MemoryStorageProvider extends LocalStorageProvider {
+    
+    constructor(namespace = null, registry = {}) {
+        
+        super(namespace, registry)
+        
+    }
+    
+    getStorage() {
+        
+        return fakeLocalStorage
+        
+    }
+    
+}
+
+export default MemoryStorageProvider

package/src/providers/StorageProvider.js

@@ -0,0 +1,102 @@
+
+/**
+ * Base class to allow storage access
+ * @see `LocalStorageProvider.js` for an example implementation
+ */
+class StorageProvider {
+    
+    /**
+     * 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(namespace, registry) {
+        
+        // Simulate being an abstract class
+        if (new.target === StorageProvider)
+            throw TypeError(`StorageProvider is abstract. Extend this class to implement it`)
+        
+        this.namespace = namespace || null
+        this.registry = registry || /* 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(namespace) {}
+    
+    /**
+     * 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(key, initialValue) {
+        this.registry[key] = initialValue
+    }
+    
+    /**
+     * Reads an item from storage
+     * @param {String} key Key for the item to retrieve
+     */
+    /* istanbul ignore next */
+    getItem(key) {}
+    
+    /**
+     * Stores a value
+     * @param {String} key Item's storage key
+     * @param {String} value Item's value to store
+     */
+    /* istanbul ignore next */
+    setItem(key, value) {}
+    
+    /**
+     * 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(key, fromRegistry = false) {}
+    
+    /**
+     * 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(
+        useInitialValues = true,
+        excludedKeys = [],
+        clearRegistry = false
+    ) {}
+    
+    /**
+     * 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(excludedKeys = []) {}
+    
+    /**
+     * 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(excludedKeys = []) {}
+    
+}
+
+export default StorageProvider

package/src/react-wire-persisted.js

@@ -0,0 +1,115 @@
+import { createWire } from '@forminator/react-wire'
+import LocalStorageProvider from './providers/LocalStorageProvider'
+
+export const defaultOptions = {
+    logging: {
+        enabled: false,
+    },
+}
+
+let Provider = LocalStorageProvider
+let storage = new Provider()
+let options = { ...defaultOptions }
+let pendingLogs = []
+
+/**
+ * Gets the namespace of the storage provider
+ * 
+ * @returns {String}
+ */
+export const getNamespace = () => storage.namespace
+
+/**
+ * Gets the current storage provider class instance
+ * 
+ * @returns {StorageProvider}
+ */
+export const getStorage = () => storage
+
+export const getOptions = () => options
+
+/**
+ * Sets the namespace for the storage provider
+ * 
+ * @param {String} namespace The namespace for the storage provider
+ */
+export const setNamespace = namespace => {
+    storage.setNamespace(namespace)
+    storage = new Provider(namespace || getNamespace())
+}
+
+export const setOptions = value => {
+    options = {
+        ...options,
+        ...value,
+    }
+    /* istanbul ignore next */
+    if (options.logging.enabled) {
+        console.info('Flushing', pendingLogs.length, 'pending logs')
+        while (pendingLogs.length)
+            /* istanbul ignore next */
+            console.log(...pendingLogs.shift())
+    }
+}
+
+const log = (...args) => {
+    /* istanbul ignore next */
+    if (options.logging.enabled)
+        /* istanbul ignore next */
+        console.log(...args)
+    else
+        pendingLogs.push(args)
+}
+
+/**
+ * Creates a persisted Wire using the `StorageProvider` that is currently set
+ * Defaults to `localStorage` via `LocalStorageProvider`
+ * 
+ * @param {String} key Unique key for storing this value
+ * @param {*} value Initial value of this Wire
+ * @returns A new Wire decorated with localStorage functionality
+ */
+export const createPersistedWire = (key, value = null) => {
+    
+    // This check helps ensure no accidental key typos occur
+    if (!key && (typeof key) !== 'number') throw new Error(
+        `createPersistedWire: Key cannot be a falsey value (${key}}`
+    )
+    
+    // Track this writable entry so we can easily clear all
+    storage.register(key, value)
+    
+    // The actual Wire backing object
+    const wire = createWire(value)
+    
+    const getValue = () => wire.getValue()
+    
+    const setValue = newValue => {
+        storage.setItem(key, newValue)
+        return wire.setValue(newValue)
+    }
+    
+    const subscribe = fn => {
+        wire.subscribe(fn)
+    }
+    
+    const storedValue = storage.getItem(key)
+    const initialValue = storedValue === null ? value : storedValue
+    
+    log('react-wire-persisted: create', key, {
+        value,
+        storedValue,
+        initialValue,
+    })
+    
+    if (initialValue !== value)
+        setValue(initialValue)
+    
+    return {
+        ...wire,
+        getValue,
+        setValue,
+        subscribe,
+    }
+    
+}

package/src/utils/fakeLocalStorage.js

@@ -0,0 +1,14 @@
+
+const storage = {
+    __IS_FAKE_LOCAL_STORAGE__: true,
+}
+
+export const fakeLocalStorage = {
+    getItem: key => fakeLocalStorage[key],
+    setItem: (key, value) => {
+        fakeLocalStorage[key] = value
+    },
+    removeItem: key => {
+        delete fakeLocalStorage[key]
+    }
+}

package/src/utils/index.js

@@ -0,0 +1,20 @@
+export * from './keys'
+export * from './fakeLocalStorage'
+
+/**
+ * Checks if a value is a primitive type
+ * 
+ * @param {*} val Value to check
+ * @returns {Boolean} True if value is a primitive type
+ */
+export const isPrimitive = val => {
+    
+    const type = typeof val
+    
+    if (val === null) return true
+    if (Array.isArray(val)) return false
+    if (type === 'object') return false
+    
+    return type !== 'function'
+    
+}

package/src/utils/keys.js

@@ -0,0 +1,49 @@
+
+/**
+ * Convenience map of keys
+ */
+const storageKeys = {}
+
+/**
+ * Adds a key to the keys map
+ * 
+ * @param {String} value Key name
+ */
+export const addKey = value => {
+    storageKeys[value] = value
+}
+
+/**
+ * Adds a key to the keys map
+ * (Alias for `addKey`)
+ * 
+ * @param {String} value Key name
+ */
+export const key = value => addKey(value)
+
+/**
+ * Convenience method to get internally managed storage keys
+ * 
+ * @returns {Object} Storage keys map
+ */
+export const getKeys = () => storageKeys
+
+/**
+ * Helper utility to prefix all keys in a map to use a namespace
+ * 
+ * @param {String} namespace Storage namespace prefix
+ * @param {Object} keys (Optional) Storage key/values. Defaults to the internally managed keys map
+ */
+export const getPrefixedKeys = (namespace, keys = null) => {
+    
+    const items = keys || storageKeys
+    
+    if (!namespace)
+        return items
+    
+    return Object.keys(items).reduce((acc, it) => ({
+        ...acc,
+        [it]: `${namespace}.${items[it]}`,
+    }), {})
+    
+}

package/lib/react-wire-persisted.js

@@ -1 +0,0 @@
-!function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t();else if("function"==typeof define&&define.amd)define([],t);else{var r=t();for(var n in r)("object"==typeof exports?exports:e)[n]=r[n]}}(this,(function(){return(()=>{"use strict";var e={253:(e,t,r)=>{r.r(t),r.d(t,{addKey:()=>l,fakeLocalStorage:()=>g,getKeys:()=>p,getPrefixedKeys:()=>v,isPrimitive:()=>y,key:()=>f});const n=require("@babel/runtime/helpers/typeof");var o=r.n(n),i=r(779),a=r.n(i);function s(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?s(Object(r),!0).forEach((function(t){a()(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):s(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}var u={},l=function(e){u[e]=e},f=function(e){return l(e)},p=function(){return u},v=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:null,r=t||u;return e?Object.keys(r).reduce((function(t,n){return c(c({},t),{},a()({},n,"".concat(e,".").concat(r[n])))}),{}):r},g={__IS_FAKE_LOCAL_STORAGE__:!0,getItem:function(e){return g[e]},setItem:function(e,t){g[e]=t},removeItem:function(e){delete g[e]}},y=function(e){var t=o()(e);return null===e||!Array.isArray(e)&&("object"!==t&&"function"!==t)}},779:e=>{e.exports=require("@babel/runtime/helpers/defineProperty")}},t={};function r(n){var o=t[n];if(void 0!==o)return o.exports;var i=t[n]={exports:{}};return e[n](i,i.exports,r),i.exports}r.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return r.d(t,{a:t}),t},r.d=(e,t)=>{for(var n in t)r.o(t,n)&&!r.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:t[n]})},r.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};return(()=>{r.r(n),r.d(n,{createPersistedWire:()=>C,defaultOptions:()=>w,getNamespace:()=>x,getOptions:()=>E,getStorage:()=>q,setNamespace:()=>N,setOptions:()=>D,utils:()=>e});var e=r(253);const t=require("@babel/runtime/helpers/toConsumableArray");var o=r.n(t),i=r(779),a=r.n(i);const s=require("@forminator/react-wire"),c=require("@babel/runtime/helpers/slicedToArray");var u=r.n(c);const l=require("@babel/runtime/helpers/classCallCheck");var f=r.n(l);const p=require("@babel/runtime/helpers/createClass");var v=r.n(p);const g=require("@babel/runtime/helpers/inherits");var y=r.n(g);const h=require("@babel/runtime/helpers/possibleConstructorReturn");var m=r.n(h);const b=require("@babel/runtime/helpers/getPrototypeOf");var d=r.n(b);function O(e){var t=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(e){return!1}}();return function(){var r,n=d()(e);if(t){var o=d()(this).constructor;r=Reflect.construct(n,arguments,o)}else r=n.apply(this,arguments);return m()(this,r)}}var j=function(t){y()(n,t);var r=O(n);function n(){var e,t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null,o=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return f()(this,n),(e=r.call(this,t,o)).storage=e.getStorage(),e}return v()(n,[{key:"getStorage",value:function(){try{return window.localStorage}catch(t){return console.warn("LocalStorageProvider: localStorage not supported"),e.fakeLocalStorage}}},{key:"setNamespace",value:function(e){if(this.namespace){if(this.namespace!==e){var t=JSON.parse(JSON.stringify(this.getAll()));this.removeAll();for(var r=0,n=Object.entries(t);r<n.length;r++){var o=u()(n[r],2),i=o[0],a=o[1],s=i.replace(this.namespace,e);this.setItem(s,a)}this.namespace=e}}else this.namespace=e}},{key:"getItem",value:function(e){var t=this.storage.getItem(e);if(null==t)return null;try{return JSON.parse(t)}catch(e){return t}}},{key:"setItem",value:function(t,r){var n=r;return null!=n&&(n=(0,e.isPrimitive)(r)?r:JSON.stringify(r)),this.storage.setItem(t,n)}},{key:"removeItem",value:function(e){var t=arguments.length>1&&void 0!==arguments[1]&&arguments[1];return t&&delete this.registry[e],this.storage.removeItem(e)}},{key:"getAll",value:function(){var e=this,t="".concat(this.namespace,".");return Object.keys(this.storage).reduce((function(r,n){return e.namespace&&!n.startsWith(t)||(r[n]=e.storage.getItem(n)),r}),{})}},{key:"_resetAll",value:function(){var e=this,t=!(arguments.length>0&&void 0!==arguments[0])||arguments[0],r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[],n=arguments.length>2&&void 0!==arguments[2]&&arguments[2],o="".concat(this.namespace,".");Object.keys(localStorage).forEach((function(i){var a=!e.namespace||i.startsWith(o),s=(null==r?void 0:r.includes(i))||!1;a&&!s&&(t?Object.prototype.hasOwnProperty.call(e.registry,i)?e.storage.setItem(i,e.registry[i]):e.storage.removeItem(i):(e.storage.removeItem(i),n&&delete e.registry[i]))}))}},{key:"resetAll",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[],t=arguments.length>1&&void 0!==arguments[1]&&arguments[1];this._resetAll(!0,e||[],t)}},{key:"removeAll",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[],t=arguments.length>1&&void 0!==arguments[1]&&arguments[1];this._resetAll(!1,e||[],t)}}]),n}(function(){function e(t,r){if(f()(this,e),(this instanceof e?this.constructor:void 0)===e)throw TypeError("StorageProvider is abstract. Extend this class to implement it");this.namespace=t||null,this.registry=r||{}}return v()(e,[{key:"setNamespace",value:function(e){}},{key:"register",value:function(e,t){this.registry[e]=t}},{key:"getItem",value:function(e){}},{key:"setItem",value:function(e,t){}},{key:"removeItem",value:function(e){}},{key:"getAll",value:function(){}},{key:"_resetAll",value:function(){}},{key:"resetAll",value:function(){}},{key:"removeAll",value:function(){}}]),e}());function P(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function k(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?P(Object(r),!0).forEach((function(t){a()(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):P(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}var w={logging:!1},S=j,A=new S,I=k({},w),_=[],x=function(){return A.namespace},q=function(){return A},E=function(){return I},N=function(e){A.setNamespace(e),A=new S(e||x())},D=function(e){if((I=k(k({},I),e)).logging)for(console.info("Flushing",_.length,"pending logs");_.length;){var t;(t=console).log.apply(t,o()(_.shift()))}},R=function(){for(var e,t=arguments.length,r=new Array(t),n=0;n<t;n++)r[n]=arguments[n];I.logging.enabled?(e=console).log.apply(e,r):_.push(r)},C=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:null;if(!e&&"number"!=typeof e)throw new Error("createPersistedWire: Key cannot be a falsey value (".concat(e,"}"));A.register(e,t);var r=(0,s.createWire)(t),n=function(){return r.getValue()},o=function(t){return A.setItem(e,t),r.setValue(t)},i=function(e){r.subscribe(e)},a=A.getItem(e),c=null===a?t:a;return R("react-wire-persisted: create",e,{value:t,storedValue:a,initialValue:c}),c!==t&&o(c),k(k({},r),{},{getValue:n,setValue:o,subscribe:i})}})(),n})()}));

package/lib/utils/index.js

@@ -1 +0,0 @@
-!function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t();else if("function"==typeof define&&define.amd)define([],t);else{var r=t();for(var n in r)("object"==typeof exports?exports:e)[n]=r[n]}}(this,(function(){return(()=>{"use strict";var e={779:e=>{e.exports=require("@babel/runtime/helpers/defineProperty")}},t={};function r(n){var o=t[n];if(void 0!==o)return o.exports;var i=t[n]={exports:{}};return e[n](i,i.exports,r),i.exports}r.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return r.d(t,{a:t}),t},r.d=(e,t)=>{for(var n in t)r.o(t,n)&&!r.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:t[n]})},r.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};return(()=>{r.r(n),r.d(n,{addKey:()=>a,fakeLocalStorage:()=>y,getKeys:()=>s,getPrefixedKeys:()=>l,isPrimitive:()=>b,key:()=>p});const e=require("@babel/runtime/helpers/typeof");var t=r.n(e),o=r(779),i=r.n(o);function c(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function u(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?c(Object(r),!0).forEach((function(t){i()(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):c(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}var f={},a=function(e){f[e]=e},p=function(e){return a(e)},s=function(){return f},l=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:null,r=t||f;return e?Object.keys(r).reduce((function(t,n){return u(u({},t),{},i()({},n,"".concat(e,".").concat(r[n])))}),{}):r},y={__IS_FAKE_LOCAL_STORAGE__:!0,getItem:function(e){return y[e]},setItem:function(e,t){y[e]=t},removeItem:function(e){delete y[e]}},b=function(e){var r=t()(e);return null===e||!Array.isArray(e)&&("object"!==r&&"function"!==r)}})(),n})()}));