react-global-state-hooks 15.0.18 → 16.0.0

package/GlobalStore.cjs

@@ -0,0 +1,240 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/GlobalStore.ts
+var GlobalStore_exports = {};
+__export(GlobalStore_exports, {
+  GlobalStore: () => GlobalStore,
+  default: () => GlobalStore_default
+});
+module.exports = __toCommonJS(GlobalStore_exports);
+var import_GlobalStore = __toESM(require("react-hooks-global-states/GlobalStore"));
+var import_tryCatch = __toESM(require("./tryCatch.cjs"));
+var import_formatFromStore = __toESM(require("json-storage-formatter/formatFromStore"));
+var import_formatToStore = __toESM(require("json-storage-formatter/formatToStore"));
+var import_isNil = __toESM(require("json-storage-formatter/isNil"));
+var import_isPrimitive = __toESM(require("json-storage-formatter/isPrimitive"));
+var defaultStorageVersion = -1;
+var GlobalStore = class _GlobalStore extends import_GlobalStore.default {
+  constructor(state, args = { metadata: {} }) {
+    var _a;
+    super(state, args);
+    this.localStorage = null;
+    // we are overriding the onInit to add local storage restoration logic
+    this.onInit = () => {
+      const storageConfig = this.localStorage;
+      if (!storageConfig || !this.isPersistStorageAvailable()) return;
+      const versioning = storageConfig.versioning;
+      const { result: restoredEnvelope, error: initializationError } = (0, import_tryCatch.default)(
+        () => {
+          var _a, _b, _c;
+          if ((_a = storageConfig.adapter) == null ? void 0 : _a.getItem) {
+            return {
+              s: (_b = storageConfig.adapter) == null ? void 0 : _b.getItem(storageConfig.key),
+              v: (_c = versioning == null ? void 0 : versioning.version) != null ? _c : defaultStorageVersion
+            };
+          }
+          const envelope = this.getStorageItem();
+          const shouldMergeStates = envelope && storageConfig.selector && !(0, import_isPrimitive.default)(envelope == null ? void 0 : envelope.s);
+          if (!shouldMergeStates) return envelope;
+          return __spreadProps(__spreadValues({}, envelope), {
+            s: __spreadValues(__spreadValues({}, this.getState()), envelope.s)
+          });
+        }
+      );
+      if (initializationError) {
+        this.handleStorageError(initializationError);
+        this.updateStateWithValidation(this.getState());
+        return;
+      }
+      if (!restoredEnvelope) {
+        this.updateStateWithValidation(this.getState());
+        return;
+      }
+      const isSameVersion = restoredEnvelope.v === (versioning == null ? void 0 : versioning.version);
+      const migratorFn = versioning == null ? void 0 : versioning.migrator;
+      if (isSameVersion || !migratorFn || storageConfig.adapter) {
+        this.updateStateWithValidation(restoredEnvelope.s);
+        return;
+      }
+      const { result: migrated, error: migrateError } = (0, import_tryCatch.default)(() => {
+        return migratorFn(
+          {
+            legacy: restoredEnvelope.s,
+            initial: this.getState()
+          },
+          this.storeTools
+        );
+      });
+      if (!migrateError) {
+        this.updateStateWithValidation(migrated);
+        return;
+      }
+      this.handleStorageError(migrateError);
+      this.updateStateWithValidation(this.getState());
+    };
+    // we are overriding the onStateChanged to add local storage sync logic
+    this.onStateChanged = ({ state }) => {
+      const storageConfig = this.localStorage;
+      if (!storageConfig || !this.isPersistStorageAvailable()) return;
+      const { error } = (0, import_tryCatch.default)(() => {
+        var _a;
+        const setFn = (_a = storageConfig.adapter) == null ? void 0 : _a.setItem;
+        if (setFn) {
+          return setFn(storageConfig.key, state);
+        }
+        this.setStorageItem(state);
+      });
+      if (!error) return;
+      this.handleStorageError(error);
+    };
+    this.localStorage = (_a = args.localStorage) != null ? _a : null;
+    const isExtensionClass = this.constructor !== _GlobalStore;
+    if (isExtensionClass) return;
+    this.initialize();
+  }
+  isPersistStorageAvailable() {
+    var _a;
+    return Boolean(((_a = this.localStorage) == null ? void 0 : _a.key) && (globalThis == null ? void 0 : globalThis.localStorage));
+  }
+  trySetStorageItem(state) {
+    const storageConfig = this.localStorage;
+    if (!storageConfig) return;
+    const { error } = (0, import_tryCatch.default)(() => {
+      var _a;
+      const setFn = (_a = storageConfig.adapter) == null ? void 0 : _a.setItem;
+      if (!setFn) return this.setStorageItem(state);
+      setFn(storageConfig.key, state);
+    });
+    if (!error) return;
+    this.handleStorageError(error);
+  }
+  // helper to validate and update the state
+  updateStateWithValidation(state) {
+    const storageConfig = this.localStorage;
+    if (!storageConfig) return;
+    const { result: sanitizedState, error: validationError } = (0, import_tryCatch.default)(() => {
+      var _a;
+      return (_a = storageConfig.validator) == null ? void 0 : _a.call(
+        storageConfig,
+        {
+          restored: state,
+          initial: this.getState()
+        },
+        this.storeTools
+      );
+    });
+    if (validationError) {
+      this.handleStorageError(validationError);
+      this.trySetStorageItem(this.getState());
+      return;
+    }
+    if (sanitizedState === void 0) {
+      if (state === void 0) {
+        this.trySetStorageItem(this.getState());
+        return;
+      }
+      this.setState(state);
+      this.trySetStorageItem(state);
+      return;
+    }
+    this.setState(sanitizedState);
+    this.trySetStorageItem(sanitizedState);
+  }
+  // retrieves a versioned item from the local storage
+  getStorageItem() {
+    const json = globalThis.localStorage.getItem(this.localStorage.key);
+    const restoredEnvelope = (0, import_isNil.default)(json) ? null : (0, import_formatFromStore.default)(json);
+    assertEnvelopeFormat(this.localStorage.key, restoredEnvelope);
+    return restoredEnvelope;
+  }
+  // add a versioned item to the local storage
+  setStorageItem(state) {
+    var _a, _b, _c, _d;
+    const envelope = {
+      s: ((_a = this.localStorage) == null ? void 0 : _a.selector) ? this.localStorage.selector(state) : state,
+      v: (_d = (_c = (_b = this.localStorage) == null ? void 0 : _b.versioning) == null ? void 0 : _c.version) != null ? _d : defaultStorageVersion
+    };
+    const formatted = (0, import_formatToStore.default)(envelope);
+    globalThis.localStorage.setItem(this.localStorage.key, formatted);
+  }
+  reset(...args) {
+    if (this.isPersistStorageAvailable() && args.length === 0) {
+      globalThis.localStorage.removeItem(this.localStorage.key);
+    }
+    super.reset(...args);
+  }
+  handleStorageError(error) {
+    var _a, _b;
+    if ((_a = this.localStorage) == null ? void 0 : _a.onError) {
+      return this.localStorage.onError(error, this.storeTools);
+    }
+    globalThis.console.error(
+      [
+        "[react-global-state-hooks]\n",
+        "  localStorage sync error:",
+        `[hook]:`,
+        `  ${this._name}`,
+        `[Localstorage Key]:`,
+        `  ${(_b = this.localStorage) == null ? void 0 : _b.key}`,
+        `[Error]:`,
+        `  ${error != null ? error : "undefined"}
+
+`,
+        "Stacktrace:"
+      ].join("\n"),
+      error.stack
+    );
+  }
+};
+function assertEnvelopeFormat(key, value) {
+  if ((0, import_isNil.default)(value)) return;
+  if (typeof value === "object" && "s" in value && "v" in value) return;
+  throw new Error(
+    `[react-native-global-state-hooks] The value of the key "${key}" is not a valid storage envelope.`
+  );
+}
+var GlobalStore_default = GlobalStore;

package/GlobalStore.js

@@ -1 +1,240 @@
-var t,e;t=this,e=(t,e,o,r,a)=>(()=>{"use strict";var s={132(t,e,o){var r=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(e,"__esModule",{value:!0}),e.GlobalStore=void 0;const a=r(o(536)),s=r(o(862)),i=r(o(330)),l=r(o(413)),n=r(o(773)),u=r(o(955));class g extends a.default{constructor(t,e={metadata:{}}){var o;super(t,e),this.localStorage=null,this.onInit=()=>{const t=this.localStorage;if(!t||!this.isPersistStorageAvailable())return;const e=t.versioning,{result:o,error:r}=(0,s.default)(()=>{var o,r,a;if(null===(o=t.adapter)||void 0===o?void 0:o.getItem)return{s:null===(r=t.adapter)||void 0===r?void 0:r.getItem(t.key),v:null!==(a=null==e?void 0:e.version)&&void 0!==a?a:-1};const s=this.getStorageItem();return s&&t.selector&&!(0,u.default)(null==s?void 0:s.s)?Object.assign(Object.assign({},s),{s:Object.assign(Object.assign({},this.getState()),s.s)}):s});if(r)return this.handleStorageError(r),void this.updateStateWithValidation(this.getState());if(!o)return void this.updateStateWithValidation(this.getState());const a=o.v===(null==e?void 0:e.version),i=null==e?void 0:e.migrator;if(a||!i||t.adapter)return void this.updateStateWithValidation(o.s);const{result:l,error:n}=(0,s.default)(()=>i({legacy:o.s,initial:this.getState()},this.storeTools));n?(this.handleStorageError(n),this.updateStateWithValidation(this.getState())):this.updateStateWithValidation(l)},this.onStateChanged=({state:t})=>{const e=this.localStorage;if(!e||!this.isPersistStorageAvailable())return;const{error:o}=(0,s.default)(()=>{var o;const r=null===(o=e.adapter)||void 0===o?void 0:o.setItem;if(r)return r(e.key,t);this.setStorageItem(t)});o&&this.handleStorageError(o)},this.localStorage=null!==(o=e.localStorage)&&void 0!==o?o:null,this.constructor!==g||this.initialize()}isPersistStorageAvailable(){var t;return Boolean((null===(t=this.localStorage)||void 0===t?void 0:t.key)&&(null===globalThis||void 0===globalThis?void 0:globalThis.localStorage))}trySetStorageItem(t){const e=this.localStorage;if(!e)return;const{error:o}=(0,s.default)(()=>{var o;const r=null===(o=e.adapter)||void 0===o?void 0:o.setItem;if(!r)return this.setStorageItem(t);r(e.key,t)});o&&this.handleStorageError(o)}updateStateWithValidation(t){const e=this.localStorage;if(!e)return;const{result:o,error:r}=(0,s.default)(()=>{var o;return null===(o=e.validator)||void 0===o?void 0:o.call(e,{restored:t,initial:this.getState()},this.storeTools)});return r?(this.handleStorageError(r),void this.trySetStorageItem(this.getState())):void 0===o?void 0===t?void this.trySetStorageItem(this.getState()):(this.setState(t),void this.trySetStorageItem(t)):(this.setState(o),void this.trySetStorageItem(o))}getStorageItem(){const t=globalThis.localStorage.getItem(this.localStorage.key),e=(0,n.default)(t)?null:(0,i.default)(t);return function(t,e){if(!((0,n.default)(e)||"object"==typeof e&&"s"in e&&"v"in e))throw new Error(`[react-native-global-state-hooks] The value of the key "${t}" is not a valid storage envelope.`)}(this.localStorage.key,e),e}setStorageItem(t){var e,o,r,a;const s={s:(null===(e=this.localStorage)||void 0===e?void 0:e.selector)?this.localStorage.selector(t):t,v:null!==(a=null===(r=null===(o=this.localStorage)||void 0===o?void 0:o.versioning)||void 0===r?void 0:r.version)&&void 0!==a?a:-1},i=(0,l.default)(s);globalThis.localStorage.setItem(this.localStorage.key,i)}reset(...t){this.isPersistStorageAvailable()&&0===t.length&&globalThis.localStorage.removeItem(this.localStorage.key),super.reset(...t)}handleStorageError(t){var e,o;if(null===(e=this.localStorage)||void 0===e?void 0:e.onError)return this.localStorage.onError(t,this.storeTools);globalThis.console.error(["[react-global-state-hooks]\n","  localStorage sync error:","[hook]:",`  ${this._name}`,"[Localstorage Key]:",`  ${null===(o=this.localStorage)||void 0===o?void 0:o.key}`,"[Error]:",`  ${null!=t?t:"undefined"}\n\n`,"Stacktrace:"].join("\n"),t.stack)}}e.GlobalStore=g,e.default=g},330(e){e.exports=t},413(t){t.exports=e},536(t){t.exports=o},773(t){t.exports=r},862(t,e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=function(t){try{return{result:t(),error:null}}catch(t){return{result:null,error:t}}}},955(t){t.exports=a}},i={};return function t(e){var o=i[e];if(void 0!==o)return o.exports;var r=i[e]={exports:{}};return s[e].call(r.exports,r,r.exports,t),r.exports}(132)})(),"object"==typeof exports&&"object"==typeof module?module.exports=e(require("json-storage-formatter/formatFromStore"),require("json-storage-formatter/formatToStore"),require("react-hooks-global-states/GlobalStore"),require("json-storage-formatter/isNil"),require("json-storage-formatter/isPrimitive")):"function"==typeof define&&define.amd?define(["json-storage-formatter/formatFromStore","json-storage-formatter/formatToStore","react-hooks-global-states/GlobalStore","json-storage-formatter/isNil","json-storage-formatter/isPrimitive"],e):"object"==typeof exports?exports["react-global-state-hooks"]=e(require("json-storage-formatter/formatFromStore"),require("json-storage-formatter/formatToStore"),require("react-hooks-global-states/GlobalStore"),require("json-storage-formatter/isNil"),require("json-storage-formatter/isPrimitive")):t["react-global-state-hooks"]=e(t["json-storage-formatter/formatFromStore"],t["json-storage-formatter/formatToStore"],t["react-hooks-global-states/GlobalStore"],t["json-storage-formatter/isNil"],t["json-storage-formatter/isPrimitive"]);
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/GlobalStore.ts
+var GlobalStore_exports = {};
+__export(GlobalStore_exports, {
+  GlobalStore: () => GlobalStore,
+  default: () => GlobalStore_default
+});
+module.exports = __toCommonJS(GlobalStore_exports);
+var import_GlobalStore = __toESM(require("react-hooks-global-states/GlobalStore"));
+var import_tryCatch = __toESM(require("./tryCatch.js"));
+var import_formatFromStore = __toESM(require("json-storage-formatter/formatFromStore"));
+var import_formatToStore = __toESM(require("json-storage-formatter/formatToStore"));
+var import_isNil = __toESM(require("json-storage-formatter/isNil"));
+var import_isPrimitive = __toESM(require("json-storage-formatter/isPrimitive"));
+var defaultStorageVersion = -1;
+var GlobalStore = class _GlobalStore extends import_GlobalStore.default {
+  constructor(state, args = { metadata: {} }) {
+    var _a;
+    super(state, args);
+    this.localStorage = null;
+    // we are overriding the onInit to add local storage restoration logic
+    this.onInit = () => {
+      const storageConfig = this.localStorage;
+      if (!storageConfig || !this.isPersistStorageAvailable()) return;
+      const versioning = storageConfig.versioning;
+      const { result: restoredEnvelope, error: initializationError } = (0, import_tryCatch.default)(
+        () => {
+          var _a, _b, _c;
+          if ((_a = storageConfig.adapter) == null ? void 0 : _a.getItem) {
+            return {
+              s: (_b = storageConfig.adapter) == null ? void 0 : _b.getItem(storageConfig.key),
+              v: (_c = versioning == null ? void 0 : versioning.version) != null ? _c : defaultStorageVersion
+            };
+          }
+          const envelope = this.getStorageItem();
+          const shouldMergeStates = envelope && storageConfig.selector && !(0, import_isPrimitive.default)(envelope == null ? void 0 : envelope.s);
+          if (!shouldMergeStates) return envelope;
+          return __spreadProps(__spreadValues({}, envelope), {
+            s: __spreadValues(__spreadValues({}, this.getState()), envelope.s)
+          });
+        }
+      );
+      if (initializationError) {
+        this.handleStorageError(initializationError);
+        this.updateStateWithValidation(this.getState());
+        return;
+      }
+      if (!restoredEnvelope) {
+        this.updateStateWithValidation(this.getState());
+        return;
+      }
+      const isSameVersion = restoredEnvelope.v === (versioning == null ? void 0 : versioning.version);
+      const migratorFn = versioning == null ? void 0 : versioning.migrator;
+      if (isSameVersion || !migratorFn || storageConfig.adapter) {
+        this.updateStateWithValidation(restoredEnvelope.s);
+        return;
+      }
+      const { result: migrated, error: migrateError } = (0, import_tryCatch.default)(() => {
+        return migratorFn(
+          {
+            legacy: restoredEnvelope.s,
+            initial: this.getState()
+          },
+          this.storeTools
+        );
+      });
+      if (!migrateError) {
+        this.updateStateWithValidation(migrated);
+        return;
+      }
+      this.handleStorageError(migrateError);
+      this.updateStateWithValidation(this.getState());
+    };
+    // we are overriding the onStateChanged to add local storage sync logic
+    this.onStateChanged = ({ state }) => {
+      const storageConfig = this.localStorage;
+      if (!storageConfig || !this.isPersistStorageAvailable()) return;
+      const { error } = (0, import_tryCatch.default)(() => {
+        var _a;
+        const setFn = (_a = storageConfig.adapter) == null ? void 0 : _a.setItem;
+        if (setFn) {
+          return setFn(storageConfig.key, state);
+        }
+        this.setStorageItem(state);
+      });
+      if (!error) return;
+      this.handleStorageError(error);
+    };
+    this.localStorage = (_a = args.localStorage) != null ? _a : null;
+    const isExtensionClass = this.constructor !== _GlobalStore;
+    if (isExtensionClass) return;
+    this.initialize();
+  }
+  isPersistStorageAvailable() {
+    var _a;
+    return Boolean(((_a = this.localStorage) == null ? void 0 : _a.key) && (globalThis == null ? void 0 : globalThis.localStorage));
+  }
+  trySetStorageItem(state) {
+    const storageConfig = this.localStorage;
+    if (!storageConfig) return;
+    const { error } = (0, import_tryCatch.default)(() => {
+      var _a;
+      const setFn = (_a = storageConfig.adapter) == null ? void 0 : _a.setItem;
+      if (!setFn) return this.setStorageItem(state);
+      setFn(storageConfig.key, state);
+    });
+    if (!error) return;
+    this.handleStorageError(error);
+  }
+  // helper to validate and update the state
+  updateStateWithValidation(state) {
+    const storageConfig = this.localStorage;
+    if (!storageConfig) return;
+    const { result: sanitizedState, error: validationError } = (0, import_tryCatch.default)(() => {
+      var _a;
+      return (_a = storageConfig.validator) == null ? void 0 : _a.call(
+        storageConfig,
+        {
+          restored: state,
+          initial: this.getState()
+        },
+        this.storeTools
+      );
+    });
+    if (validationError) {
+      this.handleStorageError(validationError);
+      this.trySetStorageItem(this.getState());
+      return;
+    }
+    if (sanitizedState === void 0) {
+      if (state === void 0) {
+        this.trySetStorageItem(this.getState());
+        return;
+      }
+      this.setState(state);
+      this.trySetStorageItem(state);
+      return;
+    }
+    this.setState(sanitizedState);
+    this.trySetStorageItem(sanitizedState);
+  }
+  // retrieves a versioned item from the local storage
+  getStorageItem() {
+    const json = globalThis.localStorage.getItem(this.localStorage.key);
+    const restoredEnvelope = (0, import_isNil.default)(json) ? null : (0, import_formatFromStore.default)(json);
+    assertEnvelopeFormat(this.localStorage.key, restoredEnvelope);
+    return restoredEnvelope;
+  }
+  // add a versioned item to the local storage
+  setStorageItem(state) {
+    var _a, _b, _c, _d;
+    const envelope = {
+      s: ((_a = this.localStorage) == null ? void 0 : _a.selector) ? this.localStorage.selector(state) : state,
+      v: (_d = (_c = (_b = this.localStorage) == null ? void 0 : _b.versioning) == null ? void 0 : _c.version) != null ? _d : defaultStorageVersion
+    };
+    const formatted = (0, import_formatToStore.default)(envelope);
+    globalThis.localStorage.setItem(this.localStorage.key, formatted);
+  }
+  reset(...args) {
+    if (this.isPersistStorageAvailable() && args.length === 0) {
+      globalThis.localStorage.removeItem(this.localStorage.key);
+    }
+    super.reset(...args);
+  }
+  handleStorageError(error) {
+    var _a, _b;
+    if ((_a = this.localStorage) == null ? void 0 : _a.onError) {
+      return this.localStorage.onError(error, this.storeTools);
+    }
+    globalThis.console.error(
+      [
+        "[react-global-state-hooks]\n",
+        "  localStorage sync error:",
+        `[hook]:`,
+        `  ${this._name}`,
+        `[Localstorage Key]:`,
+        `  ${(_b = this.localStorage) == null ? void 0 : _b.key}`,
+        `[Error]:`,
+        `  ${error != null ? error : "undefined"}
+
+`,
+        "Stacktrace:"
+      ].join("\n"),
+      error.stack
+    );
+  }
+};
+function assertEnvelopeFormat(key, value) {
+  if ((0, import_isNil.default)(value)) return;
+  if (typeof value === "object" && "s" in value && "v" in value) return;
+  throw new Error(
+    `[react-native-global-state-hooks] The value of the key "${key}" is not a valid storage envelope.`
+  );
+}
+var GlobalStore_default = GlobalStore;