gjendje 1.3.0 → 1.3.1

package/dist/{chunk-ARCB4TVB.cjs → chunk-3YGK3425.cjs}

@@ -4,7 +4,14 @@
 var globalConfig = {};
 var PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "session", "bucket"]);
 function configure(config) {
-  globalConfig = { ...globalConfig, ...config };
+  for (const key of Object.keys(config)) {
+    const value = config[key];
+    if (value === void 0) {
+      delete globalConfig[key];
+    } else {
+      globalConfig[key] = value;
+    }
+  }
   if (globalConfig.registry === false && globalConfig.scope && PERSISTENT_SCOPES.has(globalConfig.scope)) {
     log(
       "warn",
@@ -12,6 +19,9 @@ function configure(config) {
     );
   }
 }
+function resetConfig() {
+  globalConfig = {};
+}
 function getConfig() {
   return globalConfig;
 }
@@ -102,16 +112,27 @@ function unregisterByKey(rKey) {
 function getRegistry() {
   return registry;
 }
+function destroyAll() {
+  const instances = [...registry.values()];
+  for (const instance of instances) {
+    if (!instance.isDestroyed) {
+      instance.destroy();
+    }
+  }
+  registry.clear();
+}
 
 exports.PERSISTENT_SCOPES = PERSISTENT_SCOPES;
 exports.configure = configure;
 exports.createListeners = createListeners;
+exports.destroyAll = destroyAll;
 exports.getConfig = getConfig;
 exports.getRegistered = getRegistered;
 exports.getRegistry = getRegistry;
 exports.log = log;
 exports.registerNew = registerNew;
 exports.reportError = reportError;
+exports.resetConfig = resetConfig;
 exports.safeCall = safeCall;
 exports.safeCallChange = safeCallChange;
 exports.safeCallConfig = safeCallConfig;

package/dist/{chunk-KVY36YX4.cjs → chunk-TXLZGYYF.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkARCB4TVB_cjs = require('./chunk-ARCB4TVB.cjs');
+var chunk3YGK3425_cjs = require('./chunk-3YGK3425.cjs');
 
 // src/batch.ts
 var depth = 0;
@@ -26,8 +26,17 @@ function notify(fn) {
   }
   fn();
 }
+var MAX_FLUSH_ITERATIONS = 100;
 function flush() {
+  let iterations = 0;
   while (queue.length > 0) {
+    if (++iterations > MAX_FLUSH_ITERATIONS) {
+      console.error(
+        "[gjendje] Batch flush exceeded maximum iterations \u2014 possible infinite loop. Remaining queued notifications have been dropped."
+      );
+      queue = [];
+      break;
+    }
     generation++;
     const current = queue;
     queue = [];
@@ -203,7 +212,7 @@ function notifyWatchers(watchers, prev, next) {
     const nextVal = nextObj?.[watchKey];
     if (!Object.is(prevVal, nextVal)) {
       for (const listener of listeners) {
-        chunkARCB4TVB_cjs.safeCall(listener, nextVal);
+        chunk3YGK3425_cjs.safeCall(listener, nextVal);
       }
     }
   }
@@ -230,7 +239,7 @@ function readAndMigrate(raw, options, key, scope) {
     if (storedVersion < currentVersion && options.migrate) {
       data = runMigrations(data, storedVersion, currentVersion, options.migrate, key, scope);
       if (key && scope) {
-        chunkARCB4TVB_cjs.safeCallConfig(chunkARCB4TVB_cjs.getConfig().onMigrate, {
+        chunk3YGK3425_cjs.safeCallConfig(chunk3YGK3425_cjs.getConfig().onMigrate, {
           key,
           scope,
           fromVersion: storedVersion,
@@ -241,19 +250,19 @@ function readAndMigrate(raw, options, key, scope) {
     }
     if (options.validate && !options.validate(data)) {
       if (key && scope) {
-        const config = chunkARCB4TVB_cjs.getConfig();
-        chunkARCB4TVB_cjs.safeCallConfig(config.onValidationFail, { key, scope, value: data });
+        const config = chunk3YGK3425_cjs.getConfig();
+        chunk3YGK3425_cjs.safeCallConfig(config.onValidationFail, { key, scope, value: data });
         const validationErr = new ValidationError(key, scope, data);
-        chunkARCB4TVB_cjs.safeCallConfig(config.onError, { key, scope, error: validationErr });
+        chunk3YGK3425_cjs.safeCallConfig(config.onError, { key, scope, error: validationErr });
       }
       return defaultValue;
     }
     return data;
   } catch (err) {
-    chunkARCB4TVB_cjs.log("debug", `Failed to read/migrate stored value \u2014 falling back to default.`);
+    chunk3YGK3425_cjs.log("debug", `Failed to read/migrate stored value \u2014 falling back to default.`);
     if (key && scope) {
       const readErr = new StorageReadError(key, scope, err);
-      chunkARCB4TVB_cjs.safeCallConfig(chunkARCB4TVB_cjs.getConfig().onError, { key, scope, error: readErr });
+      chunk3YGK3425_cjs.safeCallConfig(chunk3YGK3425_cjs.getConfig().onError, { key, scope, error: readErr });
     }
     return defaultValue;
   }
@@ -282,7 +291,7 @@ function mergeKeys(stored, defaultValue, keys) {
 var MAX_MIGRATION_STEPS = 1e3;
 function runMigrations(data, fromVersion, toVersion, migrations, key, scope) {
   if (fromVersion < 0 || toVersion - fromVersion > MAX_MIGRATION_STEPS) {
-    chunkARCB4TVB_cjs.log("warn", `Migration range v${fromVersion}\u2192v${toVersion} is out of bounds \u2014 skipping.`);
+    chunk3YGK3425_cjs.log("warn", `Migration range v${fromVersion}\u2192v${toVersion} is out of bounds \u2014 skipping.`);
     return data;
   }
   let current = data;
@@ -292,10 +301,10 @@ function runMigrations(data, fromVersion, toVersion, migrations, key, scope) {
       try {
         current = migrateFn(current);
       } catch (err) {
-        chunkARCB4TVB_cjs.log("warn", `Migration from v${v} failed \u2014 returning partially migrated value.`);
+        chunk3YGK3425_cjs.log("warn", `Migration from v${v} failed \u2014 returning partially migrated value.`);
         if (key && scope) {
           const migrationErr = new MigrationError(key, scope, v, toVersion, err);
-          chunkARCB4TVB_cjs.safeCallConfig(chunkARCB4TVB_cjs.getConfig().onError, { key, scope, error: migrationErr });
+          chunk3YGK3425_cjs.safeCallConfig(chunk3YGK3425_cjs.getConfig().onError, { key, scope, error: migrationErr });
         }
         return current;
       }
@@ -307,13 +316,22 @@ function runMigrations(data, fromVersion, toVersion, migrations, key, scope) {
 // src/adapters/storage.ts
 function createStorageAdapter(storage, key, options) {
   const { default: defaultValue, version, serialize, persist } = options;
-  const listeners = chunkARCB4TVB_cjs.createListeners();
+  const listeners = chunk3YGK3425_cjs.createListeners();
   let cachedRaw;
   let cachedValue;
   let cacheValid = false;
   function parse(raw) {
     if (serialize) {
-      return serialize.parse(raw);
+      const value = serialize.parse(raw);
+      if (options.validate && !options.validate(value)) {
+        const scope = options.scope ?? "local";
+        const config = chunk3YGK3425_cjs.getConfig();
+        chunk3YGK3425_cjs.safeCallConfig(config.onValidationFail, { key, scope, value });
+        const validationErr = new ValidationError(key, scope, value);
+        chunk3YGK3425_cjs.safeCallConfig(config.onError, { key, scope, error: validationErr });
+        return defaultValue;
+      }
+      return value;
     }
     return readAndMigrate(raw, options, key, options.scope);
   }
@@ -364,11 +382,11 @@ function createStorageAdapter(storage, key, options) {
       const isQuota = e instanceof DOMException && (e.name === "QuotaExceededError" || e.code === 22);
       const scope = options.scope ?? "local";
       const writeErr = new StorageWriteError(key, scope, e, isQuota);
-      chunkARCB4TVB_cjs.log("error", writeErr.message);
+      chunk3YGK3425_cjs.log("error", writeErr.message);
       if (isQuota) {
-        chunkARCB4TVB_cjs.safeCallConfig(chunkARCB4TVB_cjs.getConfig().onQuotaExceeded, { key, scope, error: writeErr });
+        chunk3YGK3425_cjs.safeCallConfig(chunk3YGK3425_cjs.getConfig().onQuotaExceeded, { key, scope, error: writeErr });
       }
-      chunkARCB4TVB_cjs.reportError(key, scope, writeErr);
+      chunk3YGK3425_cjs.reportError(key, scope, writeErr);
     }
   }
   let lastNotifiedValue = defaultValue;
@@ -445,7 +463,7 @@ function parseQuota(quota) {
 function createBucketAdapter(key, bucketOptions, options) {
   const { default: defaultValue } = options;
   const fallbackScope = bucketOptions.fallback ?? "local";
-  const listeners = chunkARCB4TVB_cjs.createListeners();
+  const listeners = chunk3YGK3425_cjs.createListeners();
   let lastNotifiedValue = defaultValue;
   const notifyListeners = () => listeners.notify(lastNotifiedValue);
   const fallbackStorage = fallbackScope === "session" ? sessionStorage : localStorage;
@@ -464,7 +482,7 @@ function createBucketAdapter(key, bucketOptions, options) {
         if (parsed != null) {
           openOptions.expires = parsed;
         } else {
-          chunkARCB4TVB_cjs.log(
+          chunk3YGK3425_cjs.log(
             "warn",
             `Invalid bucket expires format: "${bucketOptions.expires}". Expected a number or a string like "7d", "24h", "30m".`
           );
@@ -475,7 +493,7 @@ function createBucketAdapter(key, bucketOptions, options) {
         if (parsed != null) {
           openOptions.quota = parsed;
         } else {
-          chunkARCB4TVB_cjs.log(
+          chunk3YGK3425_cjs.log(
             "warn",
             `Invalid bucket quota format: "${bucketOptions.quota}". Expected a number or a string like "10mb", "50kb", "1gb".`
           );
@@ -496,17 +514,17 @@ function createBucketAdapter(key, bucketOptions, options) {
       }
       const bucketValue = delegate.get();
       if (hadUserWrite && shallowEqual(bucketValue, defaultValue)) {
-        chunkARCB4TVB_cjs.safeCallConfig(chunkARCB4TVB_cjs.getConfig().onExpire, { key, scope: "bucket", expiredAt: Date.now() });
+        chunk3YGK3425_cjs.safeCallConfig(chunk3YGK3425_cjs.getConfig().onExpire, { key, scope: "bucket", expiredAt: Date.now() });
       }
       if (hadUserWrite) {
         delegate.set(currentValue);
       }
     } catch (err) {
-      chunkARCB4TVB_cjs.log(
+      chunk3YGK3425_cjs.log(
         "warn",
         `Storage Bucket initialization failed for key "${key}" \u2014 using ${fallbackScope} fallback.`
       );
-      chunkARCB4TVB_cjs.reportError(key, "bucket", err);
+      chunk3YGK3425_cjs.reportError(key, "bucket", err);
     }
     if (isDestroyed) return;
     const storedValue = delegate.get();
@@ -545,7 +563,7 @@ function createMemoryAdapter(defaultValue) {
   const listeners = /* @__PURE__ */ new Set();
   const notifyListeners = () => {
     for (const listener of listeners) {
-      chunkARCB4TVB_cjs.safeCall(listener, current);
+      chunk3YGK3425_cjs.safeCall(listener, current);
     }
   };
   return {
@@ -578,13 +596,13 @@ function withSync(adapter, key, scope) {
       channel = new BroadcastChannel(channelName);
     } catch (err) {
       const syncErr = new SyncError(key, scope ?? "local", err);
-      chunkARCB4TVB_cjs.log("warn", `Failed to create BroadcastChannel for key "${key}" \u2014 cross-tab sync disabled.`);
+      chunk3YGK3425_cjs.log("warn", `Failed to create BroadcastChannel for key "${key}" \u2014 cross-tab sync disabled.`);
       if (scope) {
-        chunkARCB4TVB_cjs.reportError(key, scope, syncErr);
+        chunk3YGK3425_cjs.reportError(key, scope, syncErr);
       }
     }
   }
-  const listeners = chunkARCB4TVB_cjs.createListeners();
+  const listeners = chunk3YGK3425_cjs.createListeners();
   let isDestroyed = false;
   const unsubscribeAdapter = adapter.subscribe((value) => {
     listeners.notify(value);
@@ -599,13 +617,13 @@ function withSync(adapter, key, scope) {
       try {
         adapter.set(value);
         if (scope) {
-          chunkARCB4TVB_cjs.safeCallConfig(chunkARCB4TVB_cjs.getConfig().onSync, { key, scope, value, source: "remote" });
+          chunk3YGK3425_cjs.safeCallConfig(chunk3YGK3425_cjs.getConfig().onSync, { key, scope, value, source: "remote" });
         }
       } catch (err) {
         const syncErr = new SyncError(key, scope ?? "local", err);
-        chunkARCB4TVB_cjs.log("error", syncErr.message);
+        chunk3YGK3425_cjs.log("error", syncErr.message);
         if (scope) {
-          chunkARCB4TVB_cjs.reportError(key, scope, syncErr);
+          chunk3YGK3425_cjs.reportError(key, scope, syncErr);
         }
       }
     };
@@ -624,9 +642,9 @@ function withSync(adapter, key, scope) {
           channel.postMessage({ value });
         } catch (err) {
           const syncErr = new SyncError(key, scope ?? "local", err);
-          chunkARCB4TVB_cjs.log("error", syncErr.message);
+          chunk3YGK3425_cjs.log("error", syncErr.message);
           if (scope) {
-            chunkARCB4TVB_cjs.reportError(key, scope, syncErr);
+            chunk3YGK3425_cjs.reportError(key, scope, syncErr);
           }
         }
       }
@@ -648,11 +666,11 @@ function withSync(adapter, key, scope) {
 }
 
 // src/adapters/url.ts
-function createUrlAdapter(key, defaultValue, serializer, persist) {
+function createUrlAdapter(key, defaultValue, serializer, persist, urlReplace) {
   if (typeof window === "undefined") {
     throw new Error("[gjendje] URL scope is not available in this environment.");
   }
-  const listeners = chunkARCB4TVB_cjs.createListeners();
+  const listeners = chunk3YGK3425_cjs.createListeners();
   const defaultSerialized = serializer.stringify(defaultValue);
   let cachedSearch;
   let cachedValue = defaultValue;
@@ -688,7 +706,11 @@ function createUrlAdapter(key, defaultValue, serializer, persist) {
       }
       const search = params.toString();
       const newUrl = search ? `${window.location.pathname}?${search}${window.location.hash}` : `${window.location.pathname}${window.location.hash}`;
-      window.history.pushState(null, "", newUrl);
+      if (urlReplace) {
+        window.history.replaceState(null, "", newUrl);
+      } else {
+        window.history.pushState(null, "", newUrl);
+      }
       cachedSearch = search ? `?${search}` : "";
       cachedValue = persist ? mergeKeys(toStore, defaultValue, persist) : value;
     } catch {
@@ -777,7 +799,8 @@ function resolveAdapter(storageKey, scope, options) {
         storageKey,
         options.default,
         options.serialize ?? { stringify: JSON.stringify, parse: JSON.parse },
-        options.persist
+        options.persist,
+        options.urlReplace
       );
     case "server":
       if (!_serverAdapterFactory) {
@@ -846,11 +869,11 @@ var StateImpl = class {
         next = interceptor(next, prev);
       }
     } catch (err) {
-      chunkARCB4TVB_cjs.reportError(this.key, this.scope, err);
+      chunk3YGK3425_cjs.reportError(this.key, this.scope, err);
       throw err;
     }
     if (!Object.is(original, next)) {
-      chunkARCB4TVB_cjs.safeCallConfig(this._config.onIntercept, {
+      chunk3YGK3425_cjs.safeCallConfig(this._config.onIntercept, {
         key: this.key,
         scope: this.scope,
         original,
@@ -863,10 +886,10 @@ var StateImpl = class {
     const s = this._s;
     if (s.changeHandlers !== void 0 && s.changeHandlers.size > 0) {
       for (const hook of s.changeHandlers) {
-        chunkARCB4TVB_cjs.safeCallChange(hook, next, prev);
+        chunk3YGK3425_cjs.safeCallChange(hook, next, prev);
       }
     }
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onChange, {
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onChange, {
       key: this.key,
       scope: this.scope,
       value: next,
@@ -897,7 +920,7 @@ var StateImpl = class {
     s.lastValue = next;
     this._adapter.set(next);
     s.settled = this._adapter.ready;
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onReset, { key: this.key, scope: this.scope, previousValue: prev });
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onReset, { key: this.key, scope: this.scope, previousValue: prev });
     this._notifyChange(next, prev);
   }
   get ready() {
@@ -953,7 +976,7 @@ var StateImpl = class {
           if (Object.hasOwn(prevRec, key)) {
             filtered[key] = partialRec[key];
           } else {
-            chunkARCB4TVB_cjs.log("warn", `patch("${this.key}") ignored unknown key "${key}" (strict mode).`);
+            chunk3YGK3425_cjs.log("warn", `patch("${this.key}") ignored unknown key "${key}" (strict mode).`);
           }
         }
         return { ...prev, ...filtered };
@@ -971,8 +994,8 @@ var StateImpl = class {
     s.watchers?.clear();
     s.watchUnsub?.();
     this._adapter.destroy?.();
-    chunkARCB4TVB_cjs.unregisterByKey(this._rKey);
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onDestroy, { key: this.key, scope: this.scope });
+    chunk3YGK3425_cjs.unregisterByKey(this._rKey);
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onDestroy, { key: this.key, scope: this.scope });
     if (s.resolveDestroyed) {
       s.resolveDestroyed();
     } else {
@@ -1049,11 +1072,11 @@ var MemoryStateImpl = class {
           next = interceptor(next, prev);
         }
       } catch (err) {
-        chunkARCB4TVB_cjs.reportError(this.key, this.scope, err);
+        chunk3YGK3425_cjs.reportError(this.key, this.scope, err);
         throw err;
       }
       if (!Object.is(original, next)) {
-        chunkARCB4TVB_cjs.safeCallConfig(this._config.onIntercept, {
+        chunk3YGK3425_cjs.safeCallConfig(this._config.onIntercept, {
           key: this.key,
           scope: this.scope,
           original,
@@ -1068,10 +1091,10 @@ var MemoryStateImpl = class {
     }
     if (ext !== void 0 && ext.changeHandlers !== void 0 && ext.changeHandlers.size > 0) {
       for (const hook of ext.changeHandlers) {
-        chunkARCB4TVB_cjs.safeCallChange(hook, next, prev);
+        chunk3YGK3425_cjs.safeCallChange(hook, next, prev);
       }
     }
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onChange, {
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onChange, {
       key: this.key,
       scope: this.scope,
       value: next,
@@ -1085,7 +1108,7 @@ var MemoryStateImpl = class {
       c.listeners = listeners;
       c.notifyFn = () => {
         for (const l of listeners) {
-          chunkARCB4TVB_cjs.safeCall(l, c.current);
+          chunk3YGK3425_cjs.safeCall(l, c.current);
         }
       };
     }
@@ -1108,11 +1131,11 @@ var MemoryStateImpl = class {
           next = interceptor(next, prev);
         }
       } catch (err) {
-        chunkARCB4TVB_cjs.reportError(this.key, this.scope, err);
+        chunk3YGK3425_cjs.reportError(this.key, this.scope, err);
         throw err;
       }
       if (!Object.is(original, next)) {
-        chunkARCB4TVB_cjs.safeCallConfig(this._config.onIntercept, {
+        chunk3YGK3425_cjs.safeCallConfig(this._config.onIntercept, {
           key: this.key,
           scope: this.scope,
           original,
@@ -1127,11 +1150,11 @@ var MemoryStateImpl = class {
     }
     if (ext !== void 0 && ext.changeHandlers !== void 0 && ext.changeHandlers.size > 0) {
       for (const hook of ext.changeHandlers) {
-        chunkARCB4TVB_cjs.safeCallChange(hook, next, prev);
+        chunk3YGK3425_cjs.safeCallChange(hook, next, prev);
       }
     }
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onReset, { key: this.key, scope: this.scope, previousValue: prev });
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onChange, {
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onReset, { key: this.key, scope: this.scope, previousValue: prev });
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onChange, {
       key: this.key,
       scope: this.scope,
       value: next,
@@ -1192,7 +1215,7 @@ var MemoryStateImpl = class {
           if (Object.hasOwn(prevRec, key)) {
             filtered[key] = partialRec[key];
           } else {
-            chunkARCB4TVB_cjs.log("warn", `patch("${this.key}") ignored unknown key "${key}" (strict mode).`);
+            chunk3YGK3425_cjs.log("warn", `patch("${this.key}") ignored unknown key "${key}" (strict mode).`);
           }
         }
         return { ...prev, ...filtered };
@@ -1227,8 +1250,8 @@ var MemoryStateImpl = class {
     }
     c.listeners?.clear();
     c.notifyFn = void 0;
-    if (this._rKey) chunkARCB4TVB_cjs.unregisterByKey(this._rKey);
-    chunkARCB4TVB_cjs.safeCallConfig(this._config.onDestroy, { key: this.key, scope: this.scope });
+    if (this._rKey) chunk3YGK3425_cjs.unregisterByKey(this._rKey);
+    chunk3YGK3425_cjs.safeCallConfig(this._config.onDestroy, { key: this.key, scope: this.scope });
     if (ext?.resolveDestroyed) {
       ext.resolveDestroyed();
     } else if (ext !== void 0) {
@@ -1240,7 +1263,7 @@ function createBase(key, options) {
   if (!key) {
     throw new Error("[gjendje] key must be a non-empty string.");
   }
-  const config = chunkARCB4TVB_cjs.getConfig();
+  const config = chunk3YGK3425_cjs.getConfig();
   if (config.keyPattern && !config.keyPattern.test(key)) {
     throw new Error(
       `[gjendje] Key "${key}" does not match the configured keyPattern ${config.keyPattern}.`
@@ -1250,7 +1273,7 @@ function createBase(key, options) {
   const scope = rawScope === "render" ? "memory" : rawScope;
   if (scope === "memory") {
     if (options.sync || config.sync) {
-      chunkARCB4TVB_cjs.log(
+      chunk3YGK3425_cjs.log(
         "warn",
         `sync: true is ignored for scope "memory". Only "local" and "bucket" scopes support cross-tab sync.`
       );
@@ -1258,27 +1281,27 @@ function createBase(key, options) {
     if (config.registry === false) {
       return new MemoryStateImpl(key, "", options, config);
     }
-    const rKey2 = chunkARCB4TVB_cjs.scopedKey(key, scope);
-    const existing2 = chunkARCB4TVB_cjs.getRegistered(rKey2);
+    const rKey2 = chunk3YGK3425_cjs.scopedKey(key, scope);
+    const existing2 = chunk3YGK3425_cjs.getRegistered(rKey2);
     if (existing2 && !existing2.isDestroyed) {
       if (config.warnOnDuplicate) {
-        chunkARCB4TVB_cjs.log("warn", `Duplicate state("${key}") with scope "${scope}". Returning cached instance.`);
+        chunk3YGK3425_cjs.log("warn", `Duplicate state("${key}") with scope "${scope}". Returning cached instance.`);
       }
       return existing2;
     }
     const instance2 = new MemoryStateImpl(key, rKey2, options, config);
-    chunkARCB4TVB_cjs.registerNew(rKey2, key, scope, instance2, config, existing2);
+    chunk3YGK3425_cjs.registerNew(rKey2, key, scope, instance2, config, existing2);
     return instance2;
   }
-  const rKey = chunkARCB4TVB_cjs.scopedKey(key, scope);
-  const existing = chunkARCB4TVB_cjs.getRegistered(rKey);
+  const rKey = chunk3YGK3425_cjs.scopedKey(key, scope);
+  const existing = chunk3YGK3425_cjs.getRegistered(rKey);
   if (existing && !existing.isDestroyed) {
     if (config.warnOnDuplicate) {
-      chunkARCB4TVB_cjs.log("warn", `Duplicate state("${key}") with scope "${scope}". Returning cached instance.`);
+      chunk3YGK3425_cjs.log("warn", `Duplicate state("${key}") with scope "${scope}". Returning cached instance.`);
     }
     return existing;
   }
-  if (config.requireValidation && chunkARCB4TVB_cjs.PERSISTENT_SCOPES.has(scope) && !options.validate) {
+  if (config.requireValidation && chunk3YGK3425_cjs.PERSISTENT_SCOPES.has(scope) && !options.validate) {
     throw new Error(
       `[gjendje] A validate function is required for persisted scope "${scope}" on state("${key}"). Set requireValidation: false in configure() to disable.`
     );
@@ -1287,7 +1310,7 @@ function createBase(key, options) {
   const useMemoryFallback = isSsrMode && isServer();
   const effectiveSync = options.sync ?? (config.sync && SYNCABLE_SCOPES.has(scope));
   if (effectiveSync && !SYNCABLE_SCOPES.has(scope)) {
-    chunkARCB4TVB_cjs.log(
+    chunk3YGK3425_cjs.log(
       "warn",
       `sync: true is ignored for scope "${scope}". Only "local" and "bucket" scopes support cross-tab sync.`
     );
@@ -1310,22 +1333,22 @@ function createBase(key, options) {
         if (!shallowEqual(storedValue, options.default)) {
           instance.set(storedValue);
         }
-        chunkARCB4TVB_cjs.safeCallConfig(config.onHydrate, {
+        chunk3YGK3425_cjs.safeCallConfig(config.onHydrate, {
           key,
           scope,
           serverValue: options.default,
           clientValue: storedValue
         });
       } catch (err) {
-        chunkARCB4TVB_cjs.log("debug", `Hydration adapter unavailable for state("${key}") \u2014 using memory fallback.`);
+        chunk3YGK3425_cjs.log("debug", `Hydration adapter unavailable for state("${key}") \u2014 using memory fallback.`);
         const hydrationErr = new HydrationError(key, scope, err);
-        chunkARCB4TVB_cjs.reportError(key, scope, hydrationErr);
+        chunk3YGK3425_cjs.reportError(key, scope, hydrationErr);
       } finally {
         realAdapter?.destroy?.();
       }
     });
   }
-  chunkARCB4TVB_cjs.registerNew(rKey, key, scope, instance, config, existing);
+  chunk3YGK3425_cjs.registerNew(rKey, key, scope, instance, config, existing);
   return instance;
 }
 

package/dist/{chunk-UEEINLOF.js → chunk-UGISZQRH.js}

@@ -1,4 +1,4 @@
-import { safeCall, getConfig, log, scopedKey, getRegistered, registerNew, PERSISTENT_SCOPES, reportError, safeCallConfig, safeCallChange, unregisterByKey, createListeners } from './chunk-FAISWCIZ.js';
+import { safeCall, getConfig, log, scopedKey, getRegistered, registerNew, PERSISTENT_SCOPES, reportError, safeCallConfig, safeCallChange, unregisterByKey, createListeners } from './chunk-YPT6TO4H.js';
 
 // src/batch.ts
 var depth = 0;
@@ -24,8 +24,17 @@ function notify(fn) {
   }
   fn();
 }
+var MAX_FLUSH_ITERATIONS = 100;
 function flush() {
+  let iterations = 0;
   while (queue.length > 0) {
+    if (++iterations > MAX_FLUSH_ITERATIONS) {
+      console.error(
+        "[gjendje] Batch flush exceeded maximum iterations \u2014 possible infinite loop. Remaining queued notifications have been dropped."
+      );
+      queue = [];
+      break;
+    }
     generation++;
     const current = queue;
     queue = [];
@@ -311,7 +320,16 @@ function createStorageAdapter(storage, key, options) {
   let cacheValid = false;
   function parse(raw) {
     if (serialize) {
-      return serialize.parse(raw);
+      const value = serialize.parse(raw);
+      if (options.validate && !options.validate(value)) {
+        const scope = options.scope ?? "local";
+        const config = getConfig();
+        safeCallConfig(config.onValidationFail, { key, scope, value });
+        const validationErr = new ValidationError(key, scope, value);
+        safeCallConfig(config.onError, { key, scope, error: validationErr });
+        return defaultValue;
+      }
+      return value;
     }
     return readAndMigrate(raw, options, key, options.scope);
   }
@@ -646,7 +664,7 @@ function withSync(adapter, key, scope) {
 }
 
 // src/adapters/url.ts
-function createUrlAdapter(key, defaultValue, serializer, persist) {
+function createUrlAdapter(key, defaultValue, serializer, persist, urlReplace) {
   if (typeof window === "undefined") {
     throw new Error("[gjendje] URL scope is not available in this environment.");
   }
@@ -686,7 +704,11 @@ function createUrlAdapter(key, defaultValue, serializer, persist) {
       }
       const search = params.toString();
       const newUrl = search ? `${window.location.pathname}?${search}${window.location.hash}` : `${window.location.pathname}${window.location.hash}`;
-      window.history.pushState(null, "", newUrl);
+      if (urlReplace) {
+        window.history.replaceState(null, "", newUrl);
+      } else {
+        window.history.pushState(null, "", newUrl);
+      }
       cachedSearch = search ? `?${search}` : "";
       cachedValue = persist ? mergeKeys(toStore, defaultValue, persist) : value;
     } catch {
@@ -775,7 +797,8 @@ function resolveAdapter(storageKey, scope, options) {
         storageKey,
         options.default,
         options.serialize ?? { stringify: JSON.stringify, parse: JSON.parse },
-        options.persist
+        options.persist,
+        options.urlReplace
       );
     case "server":
       if (!_serverAdapterFactory) {

package/dist/{chunk-FAISWCIZ.js → chunk-YPT6TO4H.js}

@@ -2,7 +2,14 @@
 var globalConfig = {};
 var PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "session", "bucket"]);
 function configure(config) {
-  globalConfig = { ...globalConfig, ...config };
+  for (const key of Object.keys(config)) {
+    const value = config[key];
+    if (value === void 0) {
+      delete globalConfig[key];
+    } else {
+      globalConfig[key] = value;
+    }
+  }
   if (globalConfig.registry === false && globalConfig.scope && PERSISTENT_SCOPES.has(globalConfig.scope)) {
     log(
       "warn",
@@ -10,6 +17,9 @@ function configure(config) {
     );
   }
 }
+function resetConfig() {
+  globalConfig = {};
+}
 function getConfig() {
   return globalConfig;
 }
@@ -100,5 +110,14 @@ function unregisterByKey(rKey) {
 function getRegistry() {
   return registry;
 }
+function destroyAll() {
+  const instances = [...registry.values()];
+  for (const instance of instances) {
+    if (!instance.isDestroyed) {
+      instance.destroy();
+    }
+  }
+  registry.clear();
+}
 
-export { PERSISTENT_SCOPES, configure, createListeners, getConfig, getRegistered, getRegistry, log, registerNew, reportError, safeCall, safeCallChange, safeCallConfig, scopedKey, unregisterByKey };
+export { PERSISTENT_SCOPES, configure, createListeners, destroyAll, getConfig, getRegistered, getRegistry, log, registerNew, reportError, resetConfig, safeCall, safeCallChange, safeCallConfig, scopedKey, unregisterByKey };