@weasel-js/storage 0.0.0-stage → 1.9.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 orochi235
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# @weasel-js/storage
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Keyed storage behind one async interface, `StorageAdapter`, with adapters for
+IndexedDB, `localStorage`, `sessionStorage`, the URL hash and memory.
+`openRecords` loads every record under a prefix into a `RecordCache`: reads
+are synchronous from memory, writes land in memory at once and reach storage
+on a debounce, and changes other tabs make arrive as `remote` changes.
+
+Adapters that can read synchronously (`localStorage`, `sessionStorage`,
+memory) also implement `listSync`, and `openRecordsSync` opens a cache from
+one with no `await`.
+
+`defaultStorage()` is IndexedDB under the database `'weasel'`, or
+`localStorage`, with a warning, where IndexedDB will not open; it chooses once
+per page. `fallbackStorage(preferred, fallback, label)` makes the same choice
+between any two adapters, and `createDefaultStorage(preferred, label)` builds a
+`defaultStorage` of your own over a different preferred adapter, such as
+IndexedDB under another database.

package/dist/index.d.ts

@@ -0,0 +1,139 @@
+/** A change someone else made to one record: its new value, or `undefined`
+ *  when it was deleted. */
+type StorageChange = [key: string, value: unknown];
+/** Asynchronous keyed storage of structured-clone values, so IndexedDB, the
+ *  URL, memory or a server can all back one. */
+interface StorageAdapter {
+    /** `undefined` when the key is absent. */
+    get(key: string): Promise<unknown>;
+    list(prefix: string): Promise<[string, unknown][]>;
+    /** Every record under `prefix`, read without waiting. Only substrates that
+     *  can answer synchronously implement it. */
+    listSync?(prefix: string): [string, unknown][];
+    /** Rejects when the value did not land. */
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** Reports writes under `prefix` made by anyone but this adapter — another
+     *  tab, another instance, a server. Omit when the substrate cannot tell. */
+    subscribe?(prefix: string, on: (changes: StorageChange[]) => void): () => void;
+}
+/** An adapter `openRecordsSync` can open. */
+type SyncStorageAdapter = StorageAdapter & Required<Pick<StorageAdapter, 'listSync'>>;
+
+/** `preferred` if it opens, otherwise `fallback` — with a warning. */
+declare function fallbackStorage(preferred: StorageAdapter, fallback?: StorageAdapter, label?: string): Promise<StorageAdapter>;
+/** A page-wide default: `preferred`, or localStorage where it will not open,
+ *  chosen on first call and kept until `resetDefaultStorage` (tests only). */
+declare function createDefaultStorage(preferred: StorageAdapter, label?: string): {
+    defaultStorage: () => Promise<StorageAdapter>;
+    resetDefaultStorage: () => void;
+};
+/** IndexedDB under the default database, 'weasel', or localStorage where it
+ *  will not open. Resolved once per page. */
+declare const defaultStorage: () => Promise<StorageAdapter>;
+
+/** Options for `createIndexedDbAdapter`. */
+interface IndexedDbAdapterOptions {
+    /** Default `'weasel'`. */
+    database?: string;
+    /** Default `'records'`. One object store per database: a store added to a
+     *  database that already exists is not created. */
+    store?: string;
+}
+/** Persist to IndexedDB, which stores structured-clone values natively — typed
+ *  arrays, `Map`s, `Blob`s — and holds far more than localStorage. Other tabs
+ *  hear writes through a `BroadcastChannel`. The database opens on first use. */
+declare function createIndexedDbAdapter({ database, store, }?: IndexedDbAdapterOptions): StorageAdapter;
+/** IndexedDB under the default database and store. */
+declare const indexedDbAdapter: StorageAdapter;
+
+/** An in-memory store, discarded on reload. Values are copied in and out, as a
+ *  real substrate would. Adapters built over one shared `backing` hear each
+ *  other's writes — two tabs, for a test. */
+declare function createMemoryAdapter(backing?: Map<string, unknown>): SyncStorageAdapter;
+/** Persists nothing and reads back nothing. */
+declare const noneAdapter: SyncStorageAdapter;
+
+/** Persist into the URL fragment, so the page's link carries its state and can
+ *  be shared or bookmarked. Changes to the fragment made elsewhere — a pasted
+ *  link, back and forward — arrive through `hashchange`. */
+declare const urlHashAdapter: StorageAdapter;
+
+/** Persist to `localStorage`, one JSON value per record. Survives a reload and
+ *  reaches other tabs through the `storage` event. */
+declare const localStorageAdapter: SyncStorageAdapter;
+/** Persist to `sessionStorage` — survives a reload but not a new tab. */
+declare const sessionStorageAdapter: SyncStorageAdapter;
+
+/** One record changing, as a cache listener hears it. `value` is `undefined`
+ *  for a delete. `local` changes were made through this cache; `remote` ones
+ *  came from another writer. */
+interface RecordChange {
+    name: string;
+    value: unknown;
+    origin: 'local' | 'remote';
+}
+/**
+ * Every record under one prefix, held in memory: the only thing that talks to
+ * a `StorageAdapter`. Names are keys with the prefix removed.
+ *
+ * Writes land in memory at once and reach storage on a debounce. The newest
+ * write to a record wins: another writer's change to a record with a write
+ * still queued here is ignored, since the queued write lands after it.
+ */
+interface RecordCache {
+    readonly prefix: string;
+    /** False once writing is off — the records could not be read, or the
+     *  opener marked them read-only — so nothing here can overwrite them. */
+    readonly writable: boolean;
+    has(name: string): boolean;
+    get(name: string): unknown;
+    /** Every record whose name starts with `namePrefix`. */
+    entries(namePrefix?: string): [string, unknown][];
+    set(name: string, value: unknown): void;
+    delete(name: string): void;
+    subscribe(listener: (changes: RecordChange[]) => void): () => void;
+    /** Send queued writes now. Resolves true when every queued write landed or
+     *  none was queued; false when a write threw (its value stays in memory) or
+     *  writing is off and writes were queued. */
+    flush(): Promise<boolean>;
+    /** Send queued writes and stop hearing other writers. */
+    close(): Promise<void>;
+}
+/** The parts of a cache only its opener uses. */
+interface OwnedRecordCache extends RecordCache {
+    /** Hold these records without writing them back. */
+    seed(entries: Iterable<[string, unknown]>): void;
+    stopWriting(): void;
+}
+/** Options for `createRecordCache` and `openRecords`. */
+interface RecordCacheOptions {
+    storage: StorageAdapter;
+    prefix: string;
+    /** Trailing debounce on writes. Default 300 ms. */
+    debounceMs?: number;
+    /** The longest a write waits under continuous change. Default 1000 ms. */
+    maxWaitMs?: number;
+}
+/** A cache holding `initial`, with nothing read from storage. */
+declare function createRecordCache(options: RecordCacheOptions & {
+    initial?: Iterable<[string, unknown]>;
+    writable?: boolean;
+}): OwnedRecordCache;
+/** Read every record under `prefix` and hold them. A failed read opens the
+ *  cache empty with writing off, so it never overwrites what it could not
+ *  read. */
+declare function openRecords(options: RecordCacheOptions): Promise<OwnedRecordCache>;
+/** `openRecords` for an adapter that reads synchronously: the cache is ready
+ *  on return. A failed read opens it empty with writing off. */
+declare function openRecordsSync(options: RecordCacheOptions & {
+    storage: SyncStorageAdapter;
+}): OwnedRecordCache;
+
+/** Encode a string for the URL fragment. */
+declare function encodeUrlHash(value: string): string;
+/** Decode a URL fragment written by `encodeUrlHash`, or `null` if it is
+ *  malformed. */
+declare function decodeUrlHash(hash: string): string | null;
+
+export { type IndexedDbAdapterOptions, type OwnedRecordCache, type RecordCache, type RecordCacheOptions, type RecordChange, type StorageAdapter, type StorageChange, type SyncStorageAdapter, createDefaultStorage, createIndexedDbAdapter, createMemoryAdapter, createRecordCache, decodeUrlHash, defaultStorage, encodeUrlHash, fallbackStorage, indexedDbAdapter, localStorageAdapter, noneAdapter, openRecords, openRecordsSync, sessionStorageAdapter, urlHashAdapter };

package/dist/index.js

@@ -0,0 +1,500 @@
+// src/indexedDb.ts
+function createIndexedDbAdapter({
+  database = "weasel",
+  store = "records"
+} = {}) {
+  let opened = null;
+  const open = () => {
+    opened ??= new Promise((resolve, reject) => {
+      if (typeof indexedDB === "undefined") {
+        reject(new Error("[storage] IndexedDB is not available here"));
+        return;
+      }
+      const request = indexedDB.open(database, 1);
+      request.onupgradeneeded = () => {
+        if (!request.result.objectStoreNames.contains(store)) {
+          request.result.createObjectStore(store);
+        }
+      };
+      request.onsuccess = () => {
+        const db = request.result;
+        if (!db.objectStoreNames.contains(store)) {
+          reject(new Error(`[storage] IndexedDB database "${database}" has no store "${store}"`));
+          return;
+        }
+        resolve(db);
+      };
+      request.onerror = () => reject(request.error);
+      request.onblocked = () => reject(new Error(`[storage] IndexedDB "${database}" is blocked`));
+    });
+    return opened;
+  };
+  const run = (mode, body) => open().then(
+    (db) => new Promise((resolve, reject) => {
+      const tx = db.transaction(store, mode);
+      const result = body(tx.objectStore(store));
+      tx.oncomplete = () => resolve(result());
+      tx.onerror = () => reject(tx.error);
+      tx.onabort = () => reject(tx.error);
+    })
+  );
+  let channel = null;
+  const getChannel = () => {
+    if (typeof BroadcastChannel === "undefined") return null;
+    if (!channel) {
+      channel = new BroadcastChannel(`weasel-storage:${database}:${store}`);
+      channel.unref?.();
+    }
+    return channel;
+  };
+  const announce = (changes) => {
+    getChannel()?.postMessage(changes);
+  };
+  const adapter = {
+    get: (key) => run("readonly", (s) => {
+      const request = s.get(key);
+      return () => request.result;
+    }),
+    list: (prefix) => run("readonly", (s) => {
+      const range = IDBKeyRange.bound(prefix, `${prefix}\uFFFF`);
+      const keys = s.getAllKeys(range);
+      const values = s.getAll(range);
+      return () => keys.result.map((key, i) => [String(key), values.result[i]]);
+    }),
+    set: async (key, value) => {
+      await run("readwrite", (s) => {
+        s.put(value, key);
+        return () => void 0;
+      });
+      announce([[key, value]]);
+    },
+    delete: async (key) => {
+      await run("readwrite", (s) => {
+        s.delete(key);
+        return () => void 0;
+      });
+      announce([[key, void 0]]);
+    }
+  };
+  if (typeof BroadcastChannel !== "undefined") {
+    adapter.subscribe = (prefix, on) => {
+      const ch = getChannel();
+      if (!ch) return () => {
+      };
+      const handler = (e) => {
+        const mine = e.data.filter(([key]) => key.startsWith(prefix));
+        if (mine.length > 0) on(mine);
+      };
+      ch.addEventListener("message", handler);
+      return () => ch.removeEventListener("message", handler);
+    };
+  }
+  return adapter;
+}
+var indexedDbAdapter = createIndexedDbAdapter();
+
+// src/json.ts
+function parse(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+function isJsonSafe(value, seen = /* @__PURE__ */ new Set()) {
+  if (value === null) return true;
+  switch (typeof value) {
+    case "string":
+    case "boolean":
+      return true;
+    case "number":
+      return Number.isFinite(value);
+    case "object": {
+      if (seen.has(value)) return false;
+      seen.add(value);
+      const proto = Object.getPrototypeOf(value);
+      const ok = Array.isArray(value) ? value.every((v) => isJsonSafe(v, seen)) : (proto === Object.prototype || proto === null) && Object.values(value).every((v) => v === void 0 || isJsonSafe(v, seen));
+      seen.delete(value);
+      return ok;
+    }
+    default:
+      return false;
+  }
+}
+
+// src/webStorage.ts
+function webStorageAdapter(area, name, crossTab) {
+  const warned = /* @__PURE__ */ new Set();
+  const listNow = (prefix) => {
+    const store = area();
+    const out = [];
+    for (let i = 0; i < store.length; i++) {
+      const key = store.key(i);
+      if (key === null || !key.startsWith(prefix)) continue;
+      const raw = store.getItem(key);
+      if (raw !== null) out.push([key, parse(raw)]);
+    }
+    return out;
+  };
+  const adapter = {
+    get: async (key) => {
+      const raw = area().getItem(key);
+      return raw === null ? void 0 : parse(raw);
+    },
+    list: async (prefix) => listNow(prefix),
+    listSync: listNow,
+    set: async (key, value) => {
+      if (!warned.has(key) && !isJsonSafe(value)) {
+        warned.add(key);
+        console.warn(
+          `[storage] "${key}" holds a value JSON cannot keep exactly; ${name} stores what JSON keeps. Use IndexedDB for binary or non-JSON state.`
+        );
+      }
+      area().setItem(key, JSON.stringify(value));
+    },
+    delete: async (key) => {
+      area().removeItem(key);
+    }
+  };
+  if (crossTab) {
+    adapter.subscribe = (prefix, on) => {
+      if (typeof window === "undefined") return () => {
+      };
+      const handler = (e) => {
+        if (e.key === null || !e.key.startsWith(prefix)) return;
+        if (e.storageArea !== area()) return;
+        on([[e.key, e.newValue === null ? void 0 : parse(e.newValue)]]);
+      };
+      window.addEventListener("storage", handler);
+      return () => window.removeEventListener("storage", handler);
+    };
+  }
+  return adapter;
+}
+var localStorageAdapter = webStorageAdapter(
+  () => localStorage,
+  "localStorage",
+  true
+);
+var sessionStorageAdapter = webStorageAdapter(
+  () => sessionStorage,
+  "sessionStorage",
+  false
+);
+
+// src/defaultStorage.ts
+async function fallbackStorage(preferred, fallback = localStorageAdapter, label = "preferred storage") {
+  try {
+    await preferred.list(" ");
+    return preferred;
+  } catch (error) {
+    console.warn(`[storage] ${label} would not open; using the fallback instead`, error);
+    return fallback;
+  }
+}
+function createDefaultStorage(preferred, label) {
+  let resolved = null;
+  return {
+    defaultStorage: () => resolved ??= fallbackStorage(preferred, localStorageAdapter, label),
+    resetDefaultStorage: () => {
+      resolved = null;
+    }
+  };
+}
+var { defaultStorage, resetDefaultStorage } = createDefaultStorage(indexedDbAdapter, "IndexedDB");
+
+// src/memory.ts
+var memorySubscribers = /* @__PURE__ */ new WeakMap();
+function createMemoryAdapter(backing = /* @__PURE__ */ new Map()) {
+  let subscribers = memorySubscribers.get(backing);
+  if (!subscribers) {
+    subscribers = /* @__PURE__ */ new Set();
+    memorySubscribers.set(backing, subscribers);
+  }
+  const peers = subscribers;
+  const notify = (key, value) => {
+    for (const sub of peers) {
+      if (sub.owner === adapter || !key.startsWith(sub.prefix)) continue;
+      const copy = value === void 0 ? void 0 : structuredClone(value);
+      queueMicrotask(() => sub.on([[key, copy]]));
+    }
+  };
+  const listNow = (prefix) => [...backing].filter(([key]) => key.startsWith(prefix)).map(([key, value]) => [key, structuredClone(value)]);
+  const adapter = {
+    get: async (key) => backing.has(key) ? structuredClone(backing.get(key)) : void 0,
+    list: async (prefix) => listNow(prefix),
+    listSync: listNow,
+    set: async (key, value) => {
+      const copy = structuredClone(value);
+      backing.set(key, copy);
+      notify(key, copy);
+    },
+    delete: async (key) => {
+      backing.delete(key);
+      notify(key, void 0);
+    },
+    subscribe: (prefix, on) => {
+      const sub = { owner: adapter, prefix, on };
+      peers.add(sub);
+      return () => {
+        peers.delete(sub);
+      };
+    }
+  };
+  return adapter;
+}
+var noneAdapter = {
+  get: async () => void 0,
+  list: async () => [],
+  listSync: () => [],
+  set: async () => {
+  },
+  delete: async () => {
+  }
+};
+
+// src/urlHash.ts
+function encodeUrlHash(value) {
+  return btoa(encodeURIComponent(value));
+}
+function decodeUrlHash(hash) {
+  if (!hash) return null;
+  try {
+    return decodeURIComponent(atob(hash));
+  } catch {
+    return null;
+  }
+}
+
+// src/urlHashAdapter.ts
+var URL_HASH_GUARD = typeof window !== "undefined";
+function readHashMap() {
+  if (!URL_HASH_GUARD) return {};
+  const raw = decodeUrlHash(window.location.hash.replace(/^#/, ""));
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+var hashSubscribers = /* @__PURE__ */ new Set();
+function writeHashMap(map) {
+  if (!URL_HASH_GUARD) return;
+  const encoded = encodeUrlHash(JSON.stringify(map));
+  window.history.replaceState(null, "", `#${encoded}`);
+  for (const sub of hashSubscribers) sub.last = { ...map };
+}
+var urlHashAdapter = {
+  get: async (key) => {
+    const raw = readHashMap()[key];
+    return raw === void 0 ? void 0 : parse(raw);
+  },
+  list: async (prefix) => Object.entries(readHashMap()).filter(([key]) => key.startsWith(prefix)).map(([key, raw]) => [key, parse(raw)]),
+  set: async (key, value) => {
+    const map = readHashMap();
+    map[key] = JSON.stringify(value);
+    writeHashMap(map);
+  },
+  delete: async (key) => {
+    const map = readHashMap();
+    delete map[key];
+    writeHashMap(map);
+  },
+  subscribe: (prefix, on) => {
+    if (!URL_HASH_GUARD) return () => {
+    };
+    const sub = { last: readHashMap() };
+    hashSubscribers.add(sub);
+    const handler = () => {
+      const next = readHashMap();
+      const changes = [];
+      for (const key of /* @__PURE__ */ new Set([...Object.keys(sub.last), ...Object.keys(next)])) {
+        if (!key.startsWith(prefix) || sub.last[key] === next[key]) continue;
+        const raw = next[key];
+        changes.push([key, raw === void 0 ? void 0 : parse(raw)]);
+      }
+      sub.last = next;
+      if (changes.length > 0) on(changes);
+    };
+    window.addEventListener("hashchange", handler);
+    return () => {
+      hashSubscribers.delete(sub);
+      window.removeEventListener("hashchange", handler);
+    };
+  }
+};
+
+// src/records.ts
+var DELETED = /* @__PURE__ */ Symbol("deleted");
+function createRecordCache(options) {
+  const { storage, prefix } = options;
+  const debounceMs = options.debounceMs ?? 300;
+  const maxWaitMs = options.maxWaitMs ?? 1e3;
+  const values = new Map(options.initial ?? []);
+  const queued = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  let writable = options.writable ?? true;
+  let closed = false;
+  let timer = null;
+  let firstQueuedAt = null;
+  const emit = (changes) => {
+    for (const listener of [...listeners]) listener(changes);
+  };
+  const schedule = () => {
+    if (!writable || closed) return;
+    const now = Date.now();
+    firstQueuedAt ??= now;
+    if (timer) clearTimeout(timer);
+    const wait = Math.max(0, Math.min(debounceMs, firstQueuedAt + maxWaitMs - now));
+    timer = setTimeout(() => {
+      timer = null;
+      void flush();
+    }, wait);
+  };
+  async function flush() {
+    if (timer) clearTimeout(timer);
+    timer = null;
+    firstQueuedAt = null;
+    if (queued.size === 0) return true;
+    if (!writable) return false;
+    const batch = [...queued];
+    queued.clear();
+    const landed = await Promise.all(
+      batch.map(async ([name, value]) => {
+        const key = prefix + name;
+        try {
+          if (value === DELETED) await storage.delete(key);
+          else await storage.set(key, value);
+          return true;
+        } catch (error) {
+          console.warn(`[storage] could not write "${key}"; keeping it in memory`, error);
+          return false;
+        }
+      })
+    );
+    return landed.every(Boolean);
+  }
+  const applyRemote = (changes) => {
+    const applied = [];
+    for (const [key, value] of changes) {
+      if (!key.startsWith(prefix)) continue;
+      const name = key.slice(prefix.length);
+      if (queued.has(name)) continue;
+      if (value === void 0) {
+        if (!values.has(name)) continue;
+        values.delete(name);
+      } else {
+        values.set(name, value);
+      }
+      applied.push({ name, value, origin: "remote" });
+    }
+    if (applied.length > 0) emit(applied);
+  };
+  const unsubscribe = writable ? storage.subscribe?.(prefix, applyRemote) : void 0;
+  const onPageHide = () => {
+    void flush();
+  };
+  const onVisibility = () => {
+    if (document.visibilityState === "hidden") void flush();
+  };
+  if (typeof window !== "undefined") {
+    window.addEventListener("pagehide", onPageHide);
+    document.addEventListener("visibilitychange", onVisibility);
+  }
+  const cache = {
+    prefix,
+    get writable() {
+      return writable;
+    },
+    has: (name) => values.has(name),
+    get: (name) => values.get(name),
+    entries: (namePrefix = "") => [...values].filter(([name]) => name.startsWith(namePrefix)),
+    set: (name, value) => {
+      values.set(name, value);
+      queued.set(name, value);
+      emit([{ name, value, origin: "local" }]);
+      schedule();
+    },
+    delete: (name) => {
+      if (!values.has(name) && !queued.has(name)) return;
+      values.delete(name);
+      queued.set(name, DELETED);
+      emit([{ name, value: void 0, origin: "local" }]);
+      schedule();
+    },
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    flush,
+    close: async () => {
+      if (closed) return;
+      await flush();
+      closed = true;
+      unsubscribe?.();
+      if (typeof window !== "undefined") {
+        window.removeEventListener("pagehide", onPageHide);
+        document.removeEventListener("visibilitychange", onVisibility);
+      }
+    },
+    seed: (entries) => {
+      for (const [name, value] of entries) values.set(name, value);
+    },
+    stopWriting: () => {
+      writable = false;
+      queued.clear();
+      if (timer) clearTimeout(timer);
+      timer = null;
+      unsubscribe?.();
+    },
+    applyRemote
+  };
+  return cache;
+}
+function stripPrefix(prefix, rows) {
+  return rows.map(([key, value]) => [key.slice(prefix.length), value]);
+}
+function unreadable(options, error) {
+  console.warn(
+    `[storage] could not read "${options.prefix}"; opening empty and not persisting`,
+    error
+  );
+  return createRecordCache({ ...options, writable: false });
+}
+async function openRecords(options) {
+  const early = [];
+  const stopEarly = options.storage.subscribe?.(options.prefix, (c) => early.push(...c));
+  let listed;
+  try {
+    listed = await options.storage.list(options.prefix);
+  } catch (error) {
+    stopEarly?.();
+    return unreadable(options, error);
+  }
+  const cache = createRecordCache({
+    ...options,
+    initial: stripPrefix(options.prefix, listed)
+  });
+  stopEarly?.();
+  cache.applyRemote(early);
+  return cache;
+}
+function openRecordsSync(options) {
+  let listed;
+  try {
+    listed = options.storage.listSync(options.prefix);
+  } catch (error) {
+    return unreadable(options, error);
+  }
+  return createRecordCache({
+    ...options,
+    initial: stripPrefix(options.prefix, listed)
+  });
+}
+
+export { createDefaultStorage, createIndexedDbAdapter, createMemoryAdapter, createRecordCache, decodeUrlHash, defaultStorage, encodeUrlHash, fallbackStorage, indexedDbAdapter, localStorageAdapter, noneAdapter, openRecords, openRecordsSync, sessionStorageAdapter, urlHashAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/indexedDb.ts","../src/json.ts","../src/webStorage.ts","../src/defaultStorage.ts","../src/memory.ts","../src/urlHash.ts","../src/urlHashAdapter.ts","../src/records.ts"],"names":[],"mappings":";AAkBO,SAAS,sBAAA,CAAuB;AAAA,EACrC,QAAA,GAAW,QAAA;AAAA,EACX,KAAA,GAAQ;AACV,CAAA,GAA6B,EAAC,EAAmB;AAC/C,EAAA,IAAI,MAAA,GAAsC,IAAA;AAC1C,EAAA,MAAM,OAAO,MAA4B;AACvC,IAAA,MAAA,KAAW,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AAC1C,MAAA,IAAI,OAAO,cAAc,WAAA,EAAa;AACpC,QAAA,MAAA,CAAO,IAAI,KAAA,CAAM,2CAA2C,CAAC,CAAA;AAC7D,QAAA;AAAA,MACF;AACA,MAAA,MAAM,OAAA,GAAU,SAAA,CAAU,IAAA,CAAK,QAAA,EAAU,CAAC,CAAA;AAC1C,MAAA,OAAA,CAAQ,kBAAkB,MAAM;AAC9B,QAAA,IAAI,CAAC,OAAA,CAAQ,MAAA,CAAO,gBAAA,CAAiB,QAAA,CAAS,KAAK,CAAA,EAAG;AACpD,UAAA,OAAA,CAAQ,MAAA,CAAO,kBAAkB,KAAK,CAAA;AAAA,QACxC;AAAA,MACF,CAAA;AACA,MAAA,OAAA,CAAQ,YAAY,MAAM;AACxB,QAAA,MAAM,KAAK,OAAA,CAAQ,MAAA;AACnB,QAAA,IAAI,CAAC,EAAA,CAAG,gBAAA,CAAiB,QAAA,CAAS,KAAK,CAAA,EAAG;AACxC,UAAA,MAAA,CAAO,IAAI,KAAA,CAAM,CAAA,8BAAA,EAAiC,QAAQ,CAAA,gBAAA,EAAmB,KAAK,GAAG,CAAC,CAAA;AACtF,UAAA;AAAA,QACF;AACA,QAAA,OAAA,CAAQ,EAAE,CAAA;AAAA,MACZ,CAAA;AACA,MAAA,OAAA,CAAQ,OAAA,GAAU,MAAM,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA;AAC5C,MAAA,OAAA,CAAQ,SAAA,GAAY,MAAM,MAAA,CAAO,IAAI,MAAM,CAAA,qBAAA,EAAwB,QAAQ,cAAc,CAAC,CAAA;AAAA,IAC5F,CAAC,CAAA;AACD,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,GAAA,GAAM,CAAI,IAAA,EAA0B,IAAA,KACxC,MAAK,CAAE,IAAA;AAAA,IACL,CAAC,EAAA,KACC,IAAI,OAAA,CAAW,CAAC,SAAS,MAAA,KAAW;AAClC,MAAA,MAAM,EAAA,GAAK,EAAA,CAAG,WAAA,CAAY,KAAA,EAAO,IAAI,CAAA;AACrC,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,EAAA,CAAG,WAAA,CAAY,KAAK,CAAC,CAAA;AACzC,MAAA,EAAA,CAAG,UAAA,GAAa,MAAM,OAAA,CAAQ,MAAA,EAAQ,CAAA;AACtC,MAAA,EAAA,CAAG,OAAA,GAAU,MAAM,MAAA,CAAO,EAAA,CAAG,KAAK,CAAA;AAClC,MAAA,EAAA,CAAG,OAAA,GAAU,MAAM,MAAA,CAAO,EAAA,CAAG,KAAK,CAAA;AAAA,IACpC,CAAC;AAAA,GACL;AAEF,EAAA,IAAI,OAAA,GAA8B,IAAA;AAClC,EAAA,MAAM,aAAa,MAA0B;AAC3C,IAAA,IAAI,OAAO,gBAAA,KAAqB,WAAA,EAAa,OAAO,IAAA;AACpD,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,OAAA,GAAU,IAAI,gBAAA,CAAiB,CAAA,eAAA,EAAkB,QAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAE,CAAA;AAEpE,MAAA,OAAA,CAAQ,KAAA,IAAQ;AAAA,IAClB;AACA,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AACA,EAAA,MAAM,QAAA,GAAW,CAAC,OAAA,KAAmC;AACnD,IAAA,UAAA,EAAW,EAAG,YAAY,OAAO,CAAA;AAAA,EACnC,CAAA;AAEA,EAAA,MAAM,OAAA,GAA0B;AAAA,IAC9B,KAAK,CAAC,GAAA,KACJ,GAAA,CAAI,UAAA,EAAY,CAAC,CAAA,KAAM;AACrB,MAAA,MAAM,OAAA,GAAU,CAAA,CAAE,GAAA,CAAI,GAAG,CAAA;AACzB,MAAA,OAAO,MAAM,OAAA,CAAQ,MAAA;AAAA,IACvB,CAAC,CAAA;AAAA,IACH,MAAM,CAAC,MAAA,KACL,GAAA,CAAI,UAAA,EAAY,CAAC,CAAA,KAAM;AACrB,MAAA,MAAM,QAAQ,WAAA,CAAY,KAAA,CAAM,MAAA,EAAQ,CAAA,EAAG,MAAM,CAAA,MAAA,CAAG,CAAA;AACpD,MAAA,MAAM,IAAA,GAAO,CAAA,CAAE,UAAA,CAAW,KAAK,CAAA;AAC/B,MAAA,MAAM,MAAA,GAAS,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA;AAC7B,MAAA,OAAO,MACL,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,CAAC,GAAA,EAAK,CAAA,KAAyB,CAAC,MAAA,CAAO,GAAG,CAAA,EAAG,MAAA,CAAO,MAAA,CAAO,CAAC,CAAC,CAAC,CAAA;AAAA,IAClF,CAAC,CAAA;AAAA,IACH,GAAA,EAAK,OAAO,GAAA,EAAK,KAAA,KAAU;AACzB,MAAA,MAAM,GAAA,CAAI,WAAA,EAAa,CAAC,CAAA,KAAM;AAC5B,QAAA,CAAA,CAAE,GAAA,CAAI,OAAO,GAAG,CAAA;AAChB,QAAA,OAAO,MAAM,MAAA;AAAA,MACf,CAAC,CAAA;AACD,MAAA,QAAA,CAAS,CAAC,CAAC,GAAA,EAAK,KAAK,CAAC,CAAC,CAAA;AAAA,IACzB,CAAA;AAAA,IACA,MAAA,EAAQ,OAAO,GAAA,KAAQ;AACrB,MAAA,MAAM,GAAA,CAAI,WAAA,EAAa,CAAC,CAAA,KAAM;AAC5B,QAAA,CAAA,CAAE,OAAO,GAAG,CAAA;AACZ,QAAA,OAAO,MAAM,MAAA;AAAA,MACf,CAAC,CAAA;AACD,MAAA,QAAA,CAAS,CAAC,CAAC,GAAA,EAAK,MAAS,CAAC,CAAC,CAAA;AAAA,IAC7B;AAAA,GACF;AACA,EAAA,IAAI,OAAO,qBAAqB,WAAA,EAAa;AAC3C,IAAA,OAAA,CAAQ,SAAA,GAAY,CAAC,MAAA,EAAQ,EAAA,KAAO;AAClC,MAAA,MAAM,KAAK,UAAA,EAAW;AACtB,MAAA,IAAI,CAAC,EAAA,EAAI,OAAO,MAAM;AAAA,MAAC,CAAA;AACvB,MAAA,MAAM,OAAA,GAAU,CAAC,CAAA,KAA2C;AAC1D,QAAA,MAAM,IAAA,GAAO,CAAA,CAAE,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,CAAI,UAAA,CAAW,MAAM,CAAC,CAAA;AAC5D,QAAA,IAAI,IAAA,CAAK,MAAA,GAAS,CAAA,EAAG,EAAA,CAAG,IAAI,CAAA;AAAA,MAC9B,CAAA;AACA,MAAA,EAAA,CAAG,gBAAA,CAAiB,WAAW,OAAO,CAAA;AACtC,MAAA,OAAO,MAAM,EAAA,CAAG,mBAAA,CAAoB,SAAA,EAAW,OAAO,CAAA;AAAA,IACxD,CAAA;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAGO,IAAM,mBAAmC,sBAAA;;;ACtHzC,SAAS,MAAM,GAAA,EAAsB;AAC1C,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,GAAG,CAAA;AAAA,EACvB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,GAAA;AAAA,EACT;AACF;AAKO,SAAS,UAAA,CAAW,KAAA,EAAgB,IAAA,mBAAoB,IAAI,KAAI,EAAY;AACjF,EAAA,IAAI,KAAA,KAAU,MAAM,OAAO,IAAA;AAC3B,EAAA,QAAQ,OAAO,KAAA;AAAO,IACpB,KAAK,QAAA;AAAA,IACL,KAAK,SAAA;AACH,MAAA,OAAO,IAAA;AAAA,IACT,KAAK,QAAA;AACH,MAAA,OAAO,MAAA,CAAO,SAAS,KAAK,CAAA;AAAA,IAC9B,KAAK,QAAA,EAAU;AACb,MAAA,IAAI,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG,OAAO,KAAA;AAC5B,MAAA,IAAA,CAAK,IAAI,KAAK,CAAA;AACd,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,cAAA,CAAe,KAAK,CAAA;AACzC,MAAA,MAAM,EAAA,GAAK,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAC1B,KAAA,CAAM,KAAA,CAAM,CAAC,CAAA,KAAM,UAAA,CAAW,CAAA,EAAG,IAAI,CAAC,CAAA,GAAA,CACrC,KAAA,KAAU,MAAA,CAAO,SAAA,IAAa,KAAA,KAAU,IAAA,KACzC,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA,CAAE,KAAA,CAAM,CAAC,CAAA,KAAM,CAAA,KAAM,MAAA,IAAa,UAAA,CAAW,CAAA,EAAG,IAAI,CAAC,CAAA;AAC5E,MAAA,IAAA,CAAK,OAAO,KAAK,CAAA;AACjB,MAAA,OAAO,EAAA;AAAA,IACT;AAAA,IACA;AACE,MAAA,OAAO,KAAA;AAAA;AAEb;;;AChCA,SAAS,iBAAA,CAAkB,IAAA,EAAqB,IAAA,EAAc,QAAA,EAAuC;AACnG,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAY;AAC/B,EAAA,MAAM,OAAA,GAAU,CAAC,MAAA,KAAwC;AACvD,IAAA,MAAM,QAAQ,IAAA,EAAK;AACnB,IAAA,MAAM,MAA2B,EAAC;AAClC,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA;AACvB,MAAA,IAAI,QAAQ,IAAA,IAAQ,CAAC,GAAA,CAAI,UAAA,CAAW,MAAM,CAAA,EAAG;AAC7C,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA;AAC7B,MAAA,IAAI,GAAA,KAAQ,MAAM,GAAA,CAAI,IAAA,CAAK,CAAC,GAAA,EAAK,KAAA,CAAM,GAAG,CAAC,CAAC,CAAA;AAAA,IAC9C;AACA,IAAA,OAAO,GAAA;AAAA,EACT,CAAA;AACA,EAAA,MAAM,OAAA,GAA8B;AAAA,IAClC,GAAA,EAAK,OAAO,GAAA,KAAQ;AAClB,MAAA,MAAM,GAAA,GAAM,IAAA,EAAK,CAAE,OAAA,CAAQ,GAAG,CAAA;AAC9B,MAAA,OAAO,GAAA,KAAQ,IAAA,GAAO,MAAA,GAAY,KAAA,CAAM,GAAG,CAAA;AAAA,IAC7C,CAAA;AAAA,IACA,IAAA,EAAM,OAAO,MAAA,KAAW,OAAA,CAAQ,MAAM,CAAA;AAAA,IACtC,QAAA,EAAU,OAAA;AAAA,IACV,GAAA,EAAK,OAAO,GAAA,EAAK,KAAA,KAAU;AACzB,MAAA,IAAI,CAAC,OAAO,GAAA,CAAI,GAAG,KAAK,CAAC,UAAA,CAAW,KAAK,CAAA,EAAG;AAC1C,QAAA,MAAA,CAAO,IAAI,GAAG,CAAA;AACd,QAAA,OAAA,CAAQ,IAAA;AAAA,UACN,CAAA,WAAA,EAAc,GAAG,CAAA,0CAAA,EAA6C,IAAI,CAAA,oEAAA;AAAA,SACpE;AAAA,MACF;AACA,MAAA,IAAA,GAAO,OAAA,CAAQ,GAAA,EAAK,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AAAA,IAC3C,CAAA;AAAA,IACA,MAAA,EAAQ,OAAO,GAAA,KAAQ;AACrB,MAAA,IAAA,EAAK,CAAE,WAAW,GAAG,CAAA;AAAA,IACvB;AAAA,GACF;AACA,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,OAAA,CAAQ,SAAA,GAAY,CAAC,MAAA,EAAQ,EAAA,KAAO;AAClC,MAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,MAAM;AAAA,MAAC,CAAA;AACjD,MAAA,MAAM,OAAA,GAAU,CAAC,CAAA,KAA0B;AACzC,QAAA,IAAI,CAAA,CAAE,QAAQ,IAAA,IAAQ,CAAC,EAAE,GAAA,CAAI,UAAA,CAAW,MAAM,CAAA,EAAG;AACjD,QAAA,IAAI,CAAA,CAAE,WAAA,KAAgB,IAAA,EAAK,EAAG;AAC9B,QAAA,EAAA,CAAG,CAAC,CAAC,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,KAAa,IAAA,GAAO,MAAA,GAAY,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;AAAA,MACnE,CAAA;AACA,MAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,OAAO,CAAA;AAC1C,MAAA,OAAO,MAAM,MAAA,CAAO,mBAAA,CAAoB,SAAA,EAAW,OAAO,CAAA;AAAA,IAC5D,CAAA;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAIO,IAAM,mBAAA,GAA0C,iBAAA;AAAA,EACrD,MAAM,YAAA;AAAA,EACN,cAAA;AAAA,EACA;AACF;AAGO,IAAM,qBAAA,GAA4C,iBAAA;AAAA,EACvD,MAAM,cAAA;AAAA,EACN,gBAAA;AAAA,EACA;AACF;;;AC3DA,eAAsB,eAAA,CACpB,SAAA,EACA,QAAA,GAA2B,mBAAA,EAC3B,QAAQ,mBAAA,EACiB;AACzB,EAAA,IAAI;AACF,IAAA,MAAM,SAAA,CAAU,KAAK,GAAG,CAAA;AACxB,IAAA,OAAO,SAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,UAAA,EAAa,KAAK,CAAA,2CAAA,CAAA,EAA+C,KAAK,CAAA;AACnF,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAIO,SAAS,oBAAA,CACd,WACA,KAAA,EACoF;AACpF,EAAA,IAAI,QAAA,GAA2C,IAAA;AAC/C,EAAA,OAAO;AAAA,IACL,gBAAgB,MAAO,QAAA,KAAa,eAAA,CAAgB,SAAA,EAAW,qBAAqB,KAAK,CAAA;AAAA,IACzF,qBAAqB,MAAM;AACzB,MAAA,QAAA,GAAW,IAAA;AAAA,IACb;AAAA,GACF;AACF;AAIO,IAAM,EAAE,cAAA,EAAgB,mBAAA,EAAoB,GAAI,oBAAA,CAAqB,kBAAkB,WAAW;;;AC5BzG,IAAM,iBAAA,uBAAwB,OAAA,EAAqD;AAK5E,SAAS,mBAAA,CAAoB,OAAA,mBAAgC,IAAI,GAAA,EAAI,EAAuB;AACjG,EAAA,IAAI,WAAA,GAAc,iBAAA,CAAkB,GAAA,CAAI,OAAO,CAAA;AAC/C,EAAA,IAAI,CAAC,WAAA,EAAa;AAChB,IAAA,WAAA,uBAAkB,GAAA,EAAI;AACtB,IAAA,iBAAA,CAAkB,GAAA,CAAI,SAAS,WAAW,CAAA;AAAA,EAC5C;AACA,EAAA,MAAM,KAAA,GAAQ,WAAA;AACd,EAAA,MAAM,MAAA,GAAS,CAAC,GAAA,EAAa,KAAA,KAAyB;AACpD,IAAA,KAAA,MAAW,OAAO,KAAA,EAAO;AACvB,MAAA,IAAI,GAAA,CAAI,UAAU,OAAA,IAAW,CAAC,IAAI,UAAA,CAAW,GAAA,CAAI,MAAM,CAAA,EAAG;AAC1D,MAAA,MAAM,IAAA,GAAO,KAAA,KAAU,MAAA,GAAY,MAAA,GAAY,gBAAgB,KAAK,CAAA;AACpE,MAAA,cAAA,CAAe,MAAM,IAAI,EAAA,CAAG,CAAC,CAAC,GAAA,EAAK,IAAI,CAAC,CAAC,CAAC,CAAA;AAAA,IAC5C;AAAA,EACF,CAAA;AACA,EAAA,MAAM,OAAA,GAAU,CAAC,MAAA,KACf,CAAC,GAAG,OAAO,CAAA,CACR,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,CAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CACxC,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAyB,CAAC,GAAA,EAAK,eAAA,CAAgB,KAAK,CAAC,CAAC,CAAA;AAC3E,EAAA,MAAM,OAAA,GAA8B;AAAA,IAClC,GAAA,EAAK,OAAO,GAAA,KAAS,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,GAAI,eAAA,CAAgB,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAC,CAAA,GAAI,MAAA;AAAA,IAC5E,IAAA,EAAM,OAAO,MAAA,KAAW,OAAA,CAAQ,MAAM,CAAA;AAAA,IACtC,QAAA,EAAU,OAAA;AAAA,IACV,GAAA,EAAK,OAAO,GAAA,EAAK,KAAA,KAAU;AACzB,MAAA,MAAM,IAAA,GAAO,gBAAgB,KAAK,CAAA;AAClC,MAAA,OAAA,CAAQ,GAAA,CAAI,KAAK,IAAI,CAAA;AACrB,MAAA,MAAA,CAAO,KAAK,IAAI,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,MAAA,EAAQ,OAAO,GAAA,KAAQ;AACrB,MAAA,OAAA,CAAQ,OAAO,GAAG,CAAA;AAClB,MAAA,MAAA,CAAO,KAAK,MAAS,CAAA;AAAA,IACvB,CAAA;AAAA,IACA,SAAA,EAAW,CAAC,MAAA,EAAQ,EAAA,KAAO;AACzB,MAAA,MAAM,GAAA,GAAM,EAAE,KAAA,EAAO,OAAA,EAAS,QAAQ,EAAA,EAAG;AACzC,MAAA,KAAA,CAAM,IAAI,GAAG,CAAA;AACb,MAAA,OAAO,MAAM;AACX,QAAA,KAAA,CAAM,OAAO,GAAG,CAAA;AAAA,MAClB,CAAA;AAAA,IACF;AAAA,GACF;AACA,EAAA,OAAO,OAAA;AACT;AAGO,IAAM,WAAA,GAAkC;AAAA,EAC7C,KAAK,YAAY,MAAA;AAAA,EACjB,IAAA,EAAM,YAAY,EAAC;AAAA,EACnB,QAAA,EAAU,MAAM,EAAC;AAAA,EACjB,KAAK,YAAY;AAAA,EAAC,CAAA;AAAA,EAClB,QAAQ,YAAY;AAAA,EAAC;AACvB;;;AC7DO,SAAS,cAAc,KAAA,EAAuB;AACnD,EAAA,OAAO,IAAA,CAAK,kBAAA,CAAmB,KAAK,CAAC,CAAA;AACvC;AAIO,SAAS,cAAc,IAAA,EAA6B;AACzD,EAAA,IAAI,CAAC,MAAM,OAAO,IAAA;AAClB,EAAA,IAAI;AACF,IAAA,OAAO,kBAAA,CAAmB,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,EACtC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;;;ACVA,IAAM,cAAA,GAAiB,OAAO,MAAA,KAAW,WAAA;AAEzC,SAAS,WAAA,GAAsC;AAC7C,EAAA,IAAI,CAAC,cAAA,EAAgB,OAAO,EAAC;AAC7B,EAAA,MAAM,GAAA,GAAM,cAAc,MAAA,CAAO,QAAA,CAAS,KAAK,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAC,CAAA;AAChE,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,GAAG,CAAA;AAAA,EACvB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AAIA,IAAM,eAAA,uBAAsB,GAAA,EAAsC;AAElE,SAAS,aAAa,GAAA,EAAmC;AACvD,EAAA,IAAI,CAAC,cAAA,EAAgB;AACrB,EAAA,MAAM,OAAA,GAAU,aAAA,CAAc,IAAA,CAAK,SAAA,CAAU,GAAG,CAAC,CAAA;AACjD,EAAA,MAAA,CAAO,QAAQ,YAAA,CAAa,IAAA,EAAM,EAAA,EAAI,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AACnD,EAAA,KAAA,MAAW,OAAO,eAAA,EAAiB,GAAA,CAAI,IAAA,GAAO,EAAE,GAAG,GAAA,EAAI;AACzD;AAKO,IAAM,cAAA,GAAiC;AAAA,EAC5C,GAAA,EAAK,OAAO,GAAA,KAAQ;AAClB,IAAA,MAAM,GAAA,GAAM,WAAA,EAAY,CAAE,GAAG,CAAA;AAC7B,IAAA,OAAO,GAAA,KAAQ,MAAA,GAAY,MAAA,GAAY,KAAA,CAAM,GAAG,CAAA;AAAA,EAClD,CAAA;AAAA,EACA,IAAA,EAAM,OAAO,MAAA,KACX,MAAA,CAAO,OAAA,CAAQ,WAAA,EAAa,CAAA,CACzB,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,CAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CACxC,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,GAAG,CAAA,KAAyB,CAAC,GAAA,EAAK,KAAA,CAAM,GAAG,CAAC,CAAC,CAAA;AAAA,EAC7D,GAAA,EAAK,OAAO,GAAA,EAAK,KAAA,KAAU;AACzB,IAAA,MAAM,MAAM,WAAA,EAAY;AACxB,IAAA,GAAA,CAAI,GAAG,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAC/B,IAAA,YAAA,CAAa,GAAG,CAAA;AAAA,EAClB,CAAA;AAAA,EACA,MAAA,EAAQ,OAAO,GAAA,KAAQ;AACrB,IAAA,MAAM,MAAM,WAAA,EAAY;AACxB,IAAA,OAAO,IAAI,GAAG,CAAA;AACd,IAAA,YAAA,CAAa,GAAG,CAAA;AAAA,EAClB,CAAA;AAAA,EACA,SAAA,EAAW,CAAC,MAAA,EAAQ,EAAA,KAAO;AACzB,IAAA,IAAI,CAAC,cAAA,EAAgB,OAAO,MAAM;AAAA,IAAC,CAAA;AACnC,IAAA,MAAM,GAAA,GAAM,EAAE,IAAA,EAAM,WAAA,EAAY,EAAE;AAClC,IAAA,eAAA,CAAgB,IAAI,GAAG,CAAA;AACvB,IAAA,MAAM,UAAU,MAAY;AAC1B,MAAA,MAAM,OAAO,WAAA,EAAY;AACzB,MAAA,MAAM,UAA2B,EAAC;AAClC,MAAA,KAAA,MAAW,uBAAO,IAAI,GAAA,CAAI,CAAC,GAAG,OAAO,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA,EAAG,GAAG,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAC,CAAA,EAAG;AAC3E,QAAA,IAAI,CAAC,GAAA,CAAI,UAAA,CAAW,MAAM,CAAA,IAAK,GAAA,CAAI,IAAA,CAAK,GAAG,CAAA,KAAM,IAAA,CAAK,GAAG,CAAA,EAAG;AAC5D,QAAA,MAAM,GAAA,GAAM,KAAK,GAAG,CAAA;AACpB,QAAA,OAAA,CAAQ,IAAA,CAAK,CAAC,GAAA,EAAK,GAAA,KAAQ,SAAY,MAAA,GAAY,KAAA,CAAM,GAAG,CAAC,CAAC,CAAA;AAAA,MAChE;AACA,MAAA,GAAA,CAAI,IAAA,GAAO,IAAA;AACX,MAAA,IAAI,OAAA,CAAQ,MAAA,GAAS,CAAA,EAAG,EAAA,CAAG,OAAO,CAAA;AAAA,IACpC,CAAA;AACA,IAAA,MAAA,CAAO,gBAAA,CAAiB,cAAc,OAAO,CAAA;AAC7C,IAAA,OAAO,MAAM;AACX,MAAA,eAAA,CAAgB,OAAO,GAAG,CAAA;AAC1B,MAAA,MAAA,CAAO,mBAAA,CAAoB,cAAc,OAAO,CAAA;AAAA,IAClD,CAAA;AAAA,EACF;AACF;;;ACfA,IAAM,OAAA,0BAAiB,SAAS,CAAA;AAGzB,SAAS,kBACd,OAAA,EACkB;AAClB,EAAA,MAAM,EAAE,OAAA,EAAS,MAAA,EAAO,GAAI,OAAA;AAC5B,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,GAAA;AACzC,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,EAAA,MAAM,SAAS,IAAI,GAAA,CAAqB,OAAA,CAAQ,OAAA,IAAW,EAAE,CAAA;AAC7D,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAqB;AACxC,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAuC;AAC7D,EAAA,IAAI,QAAA,GAAW,QAAQ,QAAA,IAAY,IAAA;AACnC,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,IAAI,KAAA,GAA8C,IAAA;AAClD,EAAA,IAAI,aAAA,GAA+B,IAAA;AAEnC,EAAA,MAAM,IAAA,GAAO,CAAC,OAAA,KAAkC;AAC9C,IAAA,KAAA,MAAW,YAAY,CAAC,GAAG,SAAS,CAAA,WAAY,OAAO,CAAA;AAAA,EACzD,CAAA;AAEA,EAAA,MAAM,WAAW,MAAY;AAC3B,IAAA,IAAI,CAAC,YAAY,MAAA,EAAQ;AACzB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,aAAA,KAAkB,GAAA;AAClB,IAAA,IAAI,KAAA,eAAoB,KAAK,CAAA;AAC7B,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,IAAI,UAAA,EAAY,aAAA,GAAgB,SAAA,GAAY,GAAG,CAAC,CAAA;AAC9E,IAAA,KAAA,GAAQ,WAAW,MAAM;AACvB,MAAA,KAAA,GAAQ,IAAA;AACR,MAAA,KAAK,KAAA,EAAM;AAAA,IACb,GAAG,IAAI,CAAA;AAAA,EACT,CAAA;AAEA,EAAA,eAAe,KAAA,GAA0B;AACvC,IAAA,IAAI,KAAA,eAAoB,KAAK,CAAA;AAC7B,IAAA,KAAA,GAAQ,IAAA;AACR,IAAA,aAAA,GAAgB,IAAA;AAChB,IAAA,IAAI,MAAA,CAAO,IAAA,KAAS,CAAA,EAAG,OAAO,IAAA;AAC9B,IAAA,IAAI,CAAC,UAAU,OAAO,KAAA;AACtB,IAAA,MAAM,KAAA,GAAQ,CAAC,GAAG,MAAM,CAAA;AACxB,IAAA,MAAA,CAAO,KAAA,EAAM;AACb,IAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,GAAA;AAAA,MAC3B,MAAM,GAAA,CAAI,OAAO,CAAC,IAAA,EAAM,KAAK,CAAA,KAAM;AACjC,QAAA,MAAM,MAAM,MAAA,GAAS,IAAA;AACrB,QAAA,IAAI;AACF,UAAA,IAAI,KAAA,KAAU,OAAA,EAAS,MAAM,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,eAC1C,MAAM,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACjC,UAAA,OAAO,IAAA;AAAA,QACT,SAAS,KAAA,EAAO;AACd,UAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,2BAAA,EAA8B,GAAG,CAAA,uBAAA,CAAA,EAA2B,KAAK,CAAA;AAC9E,UAAA,OAAO,KAAA;AAAA,QACT;AAAA,MACF,CAAC;AAAA,KACH;AACA,IAAA,OAAO,MAAA,CAAO,MAAM,OAAO,CAAA;AAAA,EAC7B;AAEA,EAAA,MAAM,WAAA,GAAc,CAAC,OAAA,KAAmC;AACtD,IAAA,MAAM,UAA0B,EAAC;AACjC,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,OAAA,EAAS;AAClC,MAAA,IAAI,CAAC,GAAA,CAAI,UAAA,CAAW,MAAM,CAAA,EAAG;AAC7B,MAAA,MAAM,IAAA,GAAO,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA;AACpC,MAAA,IAAI,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA,EAAG;AACtB,MAAA,IAAI,UAAU,MAAA,EAAW;AACvB,QAAA,IAAI,CAAC,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA,EAAG;AACvB,QAAA,MAAA,CAAO,OAAO,IAAI,CAAA;AAAA,MACpB,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,GAAA,CAAI,MAAM,KAAK,CAAA;AAAA,MACxB;AACA,MAAA,OAAA,CAAQ,KAAK,EAAE,IAAA,EAAM,KAAA,EAAO,MAAA,EAAQ,UAAU,CAAA;AAAA,IAChD;AACA,IAAA,IAAI,OAAA,CAAQ,MAAA,GAAS,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA;AAAA,EACtC,CAAA;AAEA,EAAA,MAAM,cAAc,QAAA,GAAW,OAAA,CAAQ,SAAA,GAAY,MAAA,EAAQ,WAAW,CAAA,GAAI,MAAA;AAE1E,EAAA,MAAM,aAAa,MAAY;AAC7B,IAAA,KAAK,KAAA,EAAM;AAAA,EACb,CAAA;AACA,EAAA,MAAM,eAAe,MAAY;AAC/B,IAAA,IAAI,QAAA,CAAS,eAAA,KAAoB,QAAA,EAAU,KAAK,KAAA,EAAM;AAAA,EACxD,CAAA;AACA,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,UAAU,CAAA;AAC9C,IAAA,QAAA,CAAS,gBAAA,CAAiB,oBAAoB,YAAY,CAAA;AAAA,EAC5D;AAEA,EAAA,MAAM,KAAA,GAAgE;AAAA,IACpE,MAAA;AAAA,IACA,IAAI,QAAA,GAAW;AACb,MAAA,OAAO,QAAA;AAAA,IACT,CAAA;AAAA,IACA,GAAA,EAAK,CAAC,IAAA,KAAS,MAAA,CAAO,IAAI,IAAI,CAAA;AAAA,IAC9B,GAAA,EAAK,CAAC,IAAA,KAAS,MAAA,CAAO,IAAI,IAAI,CAAA;AAAA,IAC9B,SAAS,CAAC,UAAA,GAAa,EAAA,KAAO,CAAC,GAAG,MAAM,CAAA,CAAE,MAAA,CAAO,CAAC,CAAC,IAAI,CAAA,KAAM,IAAA,CAAK,UAAA,CAAW,UAAU,CAAC,CAAA;AAAA,IACxF,GAAA,EAAK,CAAC,IAAA,EAAM,KAAA,KAAU;AACpB,MAAA,MAAA,CAAO,GAAA,CAAI,MAAM,KAAK,CAAA;AACtB,MAAA,MAAA,CAAO,GAAA,CAAI,MAAM,KAAK,CAAA;AACtB,MAAA,IAAA,CAAK,CAAC,EAAE,IAAA,EAAM,OAAO,MAAA,EAAQ,OAAA,EAAS,CAAC,CAAA;AACvC,MAAA,QAAA,EAAS;AAAA,IACX,CAAA;AAAA,IACA,MAAA,EAAQ,CAAC,IAAA,KAAS;AAChB,MAAA,IAAI,CAAC,OAAO,GAAA,CAAI,IAAI,KAAK,CAAC,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA,EAAG;AAC5C,MAAA,MAAA,CAAO,OAAO,IAAI,CAAA;AAClB,MAAA,MAAA,CAAO,GAAA,CAAI,MAAM,OAAO,CAAA;AACxB,MAAA,IAAA,CAAK,CAAC,EAAE,IAAA,EAAM,KAAA,EAAO,QAAW,MAAA,EAAQ,OAAA,EAAS,CAAC,CAAA;AAClD,MAAA,QAAA,EAAS;AAAA,IACX,CAAA;AAAA,IACA,SAAA,EAAW,CAAC,QAAA,KAAa;AACvB,MAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,MAAA,OAAO,MAAM;AACX,QAAA,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,MAC3B,CAAA;AAAA,IACF,CAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAO,YAAY;AACjB,MAAA,IAAI,MAAA,EAAQ;AACZ,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAA,GAAS,IAAA;AACT,MAAA,WAAA,IAAc;AACd,MAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,QAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,UAAU,CAAA;AACjD,QAAA,QAAA,CAAS,mBAAA,CAAoB,oBAAoB,YAAY,CAAA;AAAA,MAC/D;AAAA,IACF,CAAA;AAAA,IACA,IAAA,EAAM,CAAC,OAAA,KAAY;AACjB,MAAA,KAAA,MAAW,CAAC,MAAM,KAAK,CAAA,IAAK,SAAS,MAAA,CAAO,GAAA,CAAI,MAAM,KAAK,CAAA;AAAA,IAC7D,CAAA;AAAA,IACA,aAAa,MAAM;AACjB,MAAA,QAAA,GAAW,KAAA;AACX,MAAA,MAAA,CAAO,KAAA,EAAM;AACb,MAAA,IAAI,KAAA,eAAoB,KAAK,CAAA;AAC7B,MAAA,KAAA,GAAQ,IAAA;AACR,MAAA,WAAA,IAAc;AAAA,IAChB,CAAA;AAAA,IACA;AAAA,GACF;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,WAAA,CAAY,QAAgB,IAAA,EAAgD;AACnF,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,KAAK,KAAK,CAAA,KAAyB,CAAC,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA,EAAG,KAAK,CAAC,CAAA;AACxF;AAEA,SAAS,UAAA,CAAW,SAA6B,KAAA,EAAkC;AACjF,EAAA,OAAA,CAAQ,IAAA;AAAA,IACN,CAAA,0BAAA,EAA6B,QAAQ,MAAM,CAAA,mCAAA,CAAA;AAAA,IAC3C;AAAA,GACF;AACA,EAAA,OAAO,kBAAkB,EAAE,GAAG,OAAA,EAAS,QAAA,EAAU,OAAO,CAAA;AAC1D;AAKA,eAAsB,YAAY,OAAA,EAAwD;AAExF,EAAA,MAAM,QAAyB,EAAC;AAChC,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,GAAY,OAAA,CAAQ,MAAA,EAAQ,CAAC,CAAA,KAAM,KAAA,CAAM,IAAA,CAAK,GAAG,CAAC,CAAC,CAAA;AACrF,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,MAAM,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,QAAQ,MAAM,CAAA;AAAA,EACpD,SAAS,KAAA,EAAO;AACd,IAAA,SAAA,IAAY;AACZ,IAAA,OAAO,UAAA,CAAW,SAAS,KAAK,CAAA;AAAA,EAClC;AACA,EAAA,MAAM,QAAQ,iBAAA,CAAkB;AAAA,IAC9B,GAAG,OAAA;AAAA,IACH,OAAA,EAAS,WAAA,CAAY,OAAA,CAAQ,MAAA,EAAQ,MAAM;AAAA,GAC5C,CAAA;AACD,EAAA,SAAA,IAAY;AACZ,EAAC,KAAA,CAAmE,YAAY,KAAK,CAAA;AACrF,EAAA,OAAO,KAAA;AACT;AAIO,SAAS,gBACd,OAAA,EACkB;AAClB,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAA;AAAA,EAClD,SAAS,KAAA,EAAO;AACd,IAAA,OAAO,UAAA,CAAW,SAAS,KAAK,CAAA;AAAA,EAClC;AACA,EAAA,OAAO,iBAAA,CAAkB;AAAA,IACvB,GAAG,OAAA;AAAA,IACH,OAAA,EAAS,WAAA,CAAY,OAAA,CAAQ,MAAA,EAAQ,MAAM;AAAA,GAC5C,CAAA;AACH","file":"index.js","sourcesContent":["import type { StorageAdapter, StorageChange } from './types';\n\n/** Options for `createIndexedDbAdapter`. */\nexport interface IndexedDbAdapterOptions {\n  /** Default `'weasel'`. */\n  database?: string;\n  /** Default `'records'`. One object store per database: a store added to a\n   *  database that already exists is not created. */\n  store?: string;\n}\n\ninterface NodeChannel extends BroadcastChannel {\n  unref?: () => void;\n}\n\n/** Persist to IndexedDB, which stores structured-clone values natively — typed\n *  arrays, `Map`s, `Blob`s — and holds far more than localStorage. Other tabs\n *  hear writes through a `BroadcastChannel`. The database opens on first use. */\nexport function createIndexedDbAdapter({\n  database = 'weasel',\n  store = 'records',\n}: IndexedDbAdapterOptions = {}): StorageAdapter {\n  let opened: Promise<IDBDatabase> | null = null;\n  const open = (): Promise<IDBDatabase> => {\n    opened ??= new Promise((resolve, reject) => {\n      if (typeof indexedDB === 'undefined') {\n        reject(new Error('[storage] IndexedDB is not available here'));\n        return;\n      }\n      const request = indexedDB.open(database, 1);\n      request.onupgradeneeded = () => {\n        if (!request.result.objectStoreNames.contains(store)) {\n          request.result.createObjectStore(store);\n        }\n      };\n      request.onsuccess = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(store)) {\n          reject(new Error(`[storage] IndexedDB database \"${database}\" has no store \"${store}\"`));\n          return;\n        }\n        resolve(db);\n      };\n      request.onerror = () => reject(request.error);\n      request.onblocked = () => reject(new Error(`[storage] IndexedDB \"${database}\" is blocked`));\n    });\n    return opened;\n  };\n\n  const run = <T>(mode: IDBTransactionMode, body: (s: IDBObjectStore) => () => T): Promise<T> =>\n    open().then(\n      (db) =>\n        new Promise<T>((resolve, reject) => {\n          const tx = db.transaction(store, mode);\n          const result = body(tx.objectStore(store));\n          tx.oncomplete = () => resolve(result());\n          tx.onerror = () => reject(tx.error);\n          tx.onabort = () => reject(tx.error);\n        }),\n    );\n\n  let channel: NodeChannel | null = null;\n  const getChannel = (): NodeChannel | null => {\n    if (typeof BroadcastChannel === 'undefined') return null;\n    if (!channel) {\n      channel = new BroadcastChannel(`weasel-storage:${database}:${store}`) as NodeChannel;\n      // Node keeps its event loop alive for an open channel; a browser has no unref.\n      channel.unref?.();\n    }\n    return channel;\n  };\n  const announce = (changes: StorageChange[]): void => {\n    getChannel()?.postMessage(changes);\n  };\n\n  const adapter: StorageAdapter = {\n    get: (key) =>\n      run('readonly', (s) => {\n        const request = s.get(key);\n        return () => request.result as unknown;\n      }),\n    list: (prefix) =>\n      run('readonly', (s) => {\n        const range = IDBKeyRange.bound(prefix, `${prefix}￿`);\n        const keys = s.getAllKeys(range);\n        const values = s.getAll(range);\n        return () =>\n          keys.result.map((key, i): [string, unknown] => [String(key), values.result[i]]);\n      }),\n    set: async (key, value) => {\n      await run('readwrite', (s) => {\n        s.put(value, key);\n        return () => undefined;\n      });\n      announce([[key, value]]);\n    },\n    delete: async (key) => {\n      await run('readwrite', (s) => {\n        s.delete(key);\n        return () => undefined;\n      });\n      announce([[key, undefined]]);\n    },\n  };\n  if (typeof BroadcastChannel !== 'undefined') {\n    adapter.subscribe = (prefix, on) => {\n      const ch = getChannel();\n      if (!ch) return () => {};\n      const handler = (e: MessageEvent<StorageChange[]>): void => {\n        const mine = e.data.filter(([key]) => key.startsWith(prefix));\n        if (mine.length > 0) on(mine);\n      };\n      ch.addEventListener('message', handler);\n      return () => ch.removeEventListener('message', handler);\n    };\n  }\n  return adapter;\n}\n\n/** IndexedDB under the default database and store. */\nexport const indexedDbAdapter: StorageAdapter = createIndexedDbAdapter();\n","/** Raw strings written before records existed come back as the string they\n *  are. */\nexport function parse(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return raw;\n  }\n}\n\n/** Whether `JSON.stringify` would keep `value` exactly. An object key holding\n *  `undefined` counts as kept: JSON drops the key, and reading back an absent\n *  key yields the same `undefined`. */\nexport function isJsonSafe(value: unknown, seen: Set<object> = new Set()): boolean {\n  if (value === null) return true;\n  switch (typeof value) {\n    case 'string':\n    case 'boolean':\n      return true;\n    case 'number':\n      return Number.isFinite(value);\n    case 'object': {\n      if (seen.has(value)) return false;\n      seen.add(value);\n      const proto = Object.getPrototypeOf(value);\n      const ok = Array.isArray(value)\n        ? value.every((v) => isJsonSafe(v, seen))\n        : (proto === Object.prototype || proto === null) &&\n          Object.values(value).every((v) => v === undefined || isJsonSafe(v, seen));\n      seen.delete(value);\n      return ok;\n    }\n    default:\n      return false;\n  }\n}\n","import { isJsonSafe, parse } from './json';\nimport type { SyncStorageAdapter } from './types';\n\nfunction webStorageAdapter(area: () => Storage, name: string, crossTab: boolean): SyncStorageAdapter {\n  const warned = new Set<string>();\n  const listNow = (prefix: string): [string, unknown][] => {\n    const store = area();\n    const out: [string, unknown][] = [];\n    for (let i = 0; i < store.length; i++) {\n      const key = store.key(i);\n      if (key === null || !key.startsWith(prefix)) continue;\n      const raw = store.getItem(key);\n      if (raw !== null) out.push([key, parse(raw)]);\n    }\n    return out;\n  };\n  const adapter: SyncStorageAdapter = {\n    get: async (key) => {\n      const raw = area().getItem(key);\n      return raw === null ? undefined : parse(raw);\n    },\n    list: async (prefix) => listNow(prefix),\n    listSync: listNow,\n    set: async (key, value) => {\n      if (!warned.has(key) && !isJsonSafe(value)) {\n        warned.add(key);\n        console.warn(\n          `[storage] \"${key}\" holds a value JSON cannot keep exactly; ${name} stores what JSON keeps. Use IndexedDB for binary or non-JSON state.`,\n        );\n      }\n      area().setItem(key, JSON.stringify(value));\n    },\n    delete: async (key) => {\n      area().removeItem(key);\n    },\n  };\n  if (crossTab) {\n    adapter.subscribe = (prefix, on) => {\n      if (typeof window === 'undefined') return () => {};\n      const handler = (e: StorageEvent): void => {\n        if (e.key === null || !e.key.startsWith(prefix)) return;\n        if (e.storageArea !== area()) return;\n        on([[e.key, e.newValue === null ? undefined : parse(e.newValue)]]);\n      };\n      window.addEventListener('storage', handler);\n      return () => window.removeEventListener('storage', handler);\n    };\n  }\n  return adapter;\n}\n\n/** Persist to `localStorage`, one JSON value per record. Survives a reload and\n *  reaches other tabs through the `storage` event. */\nexport const localStorageAdapter: SyncStorageAdapter = webStorageAdapter(\n  () => localStorage,\n  'localStorage',\n  true,\n);\n\n/** Persist to `sessionStorage` — survives a reload but not a new tab. */\nexport const sessionStorageAdapter: SyncStorageAdapter = webStorageAdapter(\n  () => sessionStorage,\n  'sessionStorage',\n  false,\n);\n","import { indexedDbAdapter } from './indexedDb';\nimport type { StorageAdapter } from './types';\nimport { localStorageAdapter } from './webStorage';\n\n/** `preferred` if it opens, otherwise `fallback` — with a warning. */\nexport async function fallbackStorage(\n  preferred: StorageAdapter,\n  fallback: StorageAdapter = localStorageAdapter,\n  label = 'preferred storage',\n): Promise<StorageAdapter> {\n  try {\n    await preferred.list(' ');\n    return preferred;\n  } catch (error) {\n    console.warn(`[storage] ${label} would not open; using the fallback instead`, error);\n    return fallback;\n  }\n}\n\n/** A page-wide default: `preferred`, or localStorage where it will not open,\n *  chosen on first call and kept until `resetDefaultStorage` (tests only). */\nexport function createDefaultStorage(\n  preferred: StorageAdapter,\n  label?: string,\n): { defaultStorage: () => Promise<StorageAdapter>; resetDefaultStorage: () => void } {\n  let resolved: Promise<StorageAdapter> | null = null;\n  return {\n    defaultStorage: () => (resolved ??= fallbackStorage(preferred, localStorageAdapter, label)),\n    resetDefaultStorage: () => {\n      resolved = null;\n    },\n  };\n}\n\n/** IndexedDB under the default database, 'weasel', or localStorage where it\n *  will not open. Resolved once per page. */\nexport const { defaultStorage, resetDefaultStorage } = createDefaultStorage(indexedDbAdapter, 'IndexedDB');\n","import type { StorageAdapter, StorageChange, SyncStorageAdapter } from './types';\n\ninterface MemorySubscriber {\n  owner: StorageAdapter;\n  prefix: string;\n  on: (changes: StorageChange[]) => void;\n}\n\nconst memorySubscribers = new WeakMap<Map<string, unknown>, Set<MemorySubscriber>>();\n\n/** An in-memory store, discarded on reload. Values are copied in and out, as a\n *  real substrate would. Adapters built over one shared `backing` hear each\n *  other's writes — two tabs, for a test. */\nexport function createMemoryAdapter(backing: Map<string, unknown> = new Map()): SyncStorageAdapter {\n  let subscribers = memorySubscribers.get(backing);\n  if (!subscribers) {\n    subscribers = new Set();\n    memorySubscribers.set(backing, subscribers);\n  }\n  const peers = subscribers;\n  const notify = (key: string, value: unknown): void => {\n    for (const sub of peers) {\n      if (sub.owner === adapter || !key.startsWith(sub.prefix)) continue;\n      const copy = value === undefined ? undefined : structuredClone(value);\n      queueMicrotask(() => sub.on([[key, copy]]));\n    }\n  };\n  const listNow = (prefix: string): [string, unknown][] =>\n    [...backing]\n      .filter(([key]) => key.startsWith(prefix))\n      .map(([key, value]): [string, unknown] => [key, structuredClone(value)]);\n  const adapter: SyncStorageAdapter = {\n    get: async (key) => (backing.has(key) ? structuredClone(backing.get(key)) : undefined),\n    list: async (prefix) => listNow(prefix),\n    listSync: listNow,\n    set: async (key, value) => {\n      const copy = structuredClone(value);\n      backing.set(key, copy);\n      notify(key, copy);\n    },\n    delete: async (key) => {\n      backing.delete(key);\n      notify(key, undefined);\n    },\n    subscribe: (prefix, on) => {\n      const sub = { owner: adapter, prefix, on };\n      peers.add(sub);\n      return () => {\n        peers.delete(sub);\n      };\n    },\n  };\n  return adapter;\n}\n\n/** Persists nothing and reads back nothing. */\nexport const noneAdapter: SyncStorageAdapter = {\n  get: async () => undefined,\n  list: async () => [],\n  listSync: () => [],\n  set: async () => {},\n  delete: async () => {},\n};\n","/** Encode a string for the URL fragment. */\nexport function encodeUrlHash(value: string): string {\n  return btoa(encodeURIComponent(value));\n}\n\n/** Decode a URL fragment written by `encodeUrlHash`, or `null` if it is\n *  malformed. */\nexport function decodeUrlHash(hash: string): string | null {\n  if (!hash) return null;\n  try {\n    return decodeURIComponent(atob(hash));\n  } catch {\n    return null;\n  }\n}\n","import { parse } from './json';\nimport type { StorageAdapter, StorageChange } from './types';\nimport { decodeUrlHash, encodeUrlHash } from './urlHash';\n\nconst URL_HASH_GUARD = typeof window !== 'undefined';\n\nfunction readHashMap(): Record<string, string> {\n  if (!URL_HASH_GUARD) return {};\n  const raw = decodeUrlHash(window.location.hash.replace(/^#/, ''));\n  if (!raw) return {};\n  try {\n    return JSON.parse(raw) as Record<string, string>;\n  } catch {\n    return {};\n  }\n}\n\n/** What each live subscription last saw, refreshed on this page's own writes\n *  so `hashchange` reports only somebody else's. */\nconst hashSubscribers = new Set<{ last: Record<string, string> }>();\n\nfunction writeHashMap(map: Record<string, string>): void {\n  if (!URL_HASH_GUARD) return;\n  const encoded = encodeUrlHash(JSON.stringify(map));\n  window.history.replaceState(null, '', `#${encoded}`);\n  for (const sub of hashSubscribers) sub.last = { ...map };\n}\n\n/** Persist into the URL fragment, so the page's link carries its state and can\n *  be shared or bookmarked. Changes to the fragment made elsewhere — a pasted\n *  link, back and forward — arrive through `hashchange`. */\nexport const urlHashAdapter: StorageAdapter = {\n  get: async (key) => {\n    const raw = readHashMap()[key];\n    return raw === undefined ? undefined : parse(raw);\n  },\n  list: async (prefix) =>\n    Object.entries(readHashMap())\n      .filter(([key]) => key.startsWith(prefix))\n      .map(([key, raw]): [string, unknown] => [key, parse(raw)]),\n  set: async (key, value) => {\n    const map = readHashMap();\n    map[key] = JSON.stringify(value);\n    writeHashMap(map);\n  },\n  delete: async (key) => {\n    const map = readHashMap();\n    delete map[key];\n    writeHashMap(map);\n  },\n  subscribe: (prefix, on) => {\n    if (!URL_HASH_GUARD) return () => {};\n    const sub = { last: readHashMap() };\n    hashSubscribers.add(sub);\n    const handler = (): void => {\n      const next = readHashMap();\n      const changes: StorageChange[] = [];\n      for (const key of new Set([...Object.keys(sub.last), ...Object.keys(next)])) {\n        if (!key.startsWith(prefix) || sub.last[key] === next[key]) continue;\n        const raw = next[key];\n        changes.push([key, raw === undefined ? undefined : parse(raw)]);\n      }\n      sub.last = next;\n      if (changes.length > 0) on(changes);\n    };\n    window.addEventListener('hashchange', handler);\n    return () => {\n      hashSubscribers.delete(sub);\n      window.removeEventListener('hashchange', handler);\n    };\n  },\n};\n","import type { StorageAdapter, StorageChange, SyncStorageAdapter } from './types';\n\n/** One record changing, as a cache listener hears it. `value` is `undefined`\n *  for a delete. `local` changes were made through this cache; `remote` ones\n *  came from another writer. */\nexport interface RecordChange {\n  name: string;\n  value: unknown;\n  origin: 'local' | 'remote';\n}\n\n/**\n * Every record under one prefix, held in memory: the only thing that talks to\n * a `StorageAdapter`. Names are keys with the prefix removed.\n *\n * Writes land in memory at once and reach storage on a debounce. The newest\n * write to a record wins: another writer's change to a record with a write\n * still queued here is ignored, since the queued write lands after it.\n */\nexport interface RecordCache {\n  readonly prefix: string;\n  /** False once writing is off — the records could not be read, or the\n   *  opener marked them read-only — so nothing here can overwrite them. */\n  readonly writable: boolean;\n  has(name: string): boolean;\n  get(name: string): unknown;\n  /** Every record whose name starts with `namePrefix`. */\n  entries(namePrefix?: string): [string, unknown][];\n  set(name: string, value: unknown): void;\n  delete(name: string): void;\n  subscribe(listener: (changes: RecordChange[]) => void): () => void;\n  /** Send queued writes now. Resolves true when every queued write landed or\n   *  none was queued; false when a write threw (its value stays in memory) or\n   *  writing is off and writes were queued. */\n  flush(): Promise<boolean>;\n  /** Send queued writes and stop hearing other writers. */\n  close(): Promise<void>;\n}\n\n/** The parts of a cache only its opener uses. */\nexport interface OwnedRecordCache extends RecordCache {\n  /** Hold these records without writing them back. */\n  seed(entries: Iterable<[string, unknown]>): void;\n  stopWriting(): void;\n}\n\n/** Options for `createRecordCache` and `openRecords`. */\nexport interface RecordCacheOptions {\n  storage: StorageAdapter;\n  prefix: string;\n  /** Trailing debounce on writes. Default 300 ms. */\n  debounceMs?: number;\n  /** The longest a write waits under continuous change. Default 1000 ms. */\n  maxWaitMs?: number;\n}\n\nconst DELETED = Symbol('deleted');\n\n/** A cache holding `initial`, with nothing read from storage. */\nexport function createRecordCache(\n  options: RecordCacheOptions & { initial?: Iterable<[string, unknown]>; writable?: boolean },\n): OwnedRecordCache {\n  const { storage, prefix } = options;\n  const debounceMs = options.debounceMs ?? 300;\n  const maxWaitMs = options.maxWaitMs ?? 1000;\n  const values = new Map<string, unknown>(options.initial ?? []);\n  const queued = new Map<string, unknown>();\n  const listeners = new Set<(changes: RecordChange[]) => void>();\n  let writable = options.writable ?? true;\n  let closed = false;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let firstQueuedAt: number | null = null;\n\n  const emit = (changes: RecordChange[]): void => {\n    for (const listener of [...listeners]) listener(changes);\n  };\n\n  const schedule = (): void => {\n    if (!writable || closed) return;\n    const now = Date.now();\n    firstQueuedAt ??= now;\n    if (timer) clearTimeout(timer);\n    const wait = Math.max(0, Math.min(debounceMs, firstQueuedAt + maxWaitMs - now));\n    timer = setTimeout(() => {\n      timer = null;\n      void flush();\n    }, wait);\n  };\n\n  async function flush(): Promise<boolean> {\n    if (timer) clearTimeout(timer);\n    timer = null;\n    firstQueuedAt = null;\n    if (queued.size === 0) return true;\n    if (!writable) return false;\n    const batch = [...queued];\n    queued.clear();\n    const landed = await Promise.all(\n      batch.map(async ([name, value]) => {\n        const key = prefix + name;\n        try {\n          if (value === DELETED) await storage.delete(key);\n          else await storage.set(key, value);\n          return true;\n        } catch (error) {\n          console.warn(`[storage] could not write \"${key}\"; keeping it in memory`, error);\n          return false;\n        }\n      }),\n    );\n    return landed.every(Boolean);\n  }\n\n  const applyRemote = (changes: StorageChange[]): void => {\n    const applied: RecordChange[] = [];\n    for (const [key, value] of changes) {\n      if (!key.startsWith(prefix)) continue;\n      const name = key.slice(prefix.length);\n      if (queued.has(name)) continue;\n      if (value === undefined) {\n        if (!values.has(name)) continue;\n        values.delete(name);\n      } else {\n        values.set(name, value);\n      }\n      applied.push({ name, value, origin: 'remote' });\n    }\n    if (applied.length > 0) emit(applied);\n  };\n\n  const unsubscribe = writable ? storage.subscribe?.(prefix, applyRemote) : undefined;\n\n  const onPageHide = (): void => {\n    void flush();\n  };\n  const onVisibility = (): void => {\n    if (document.visibilityState === 'hidden') void flush();\n  };\n  if (typeof window !== 'undefined') {\n    window.addEventListener('pagehide', onPageHide);\n    document.addEventListener('visibilitychange', onVisibility);\n  }\n\n  const cache: OwnedRecordCache & { applyRemote: typeof applyRemote } = {\n    prefix,\n    get writable() {\n      return writable;\n    },\n    has: (name) => values.has(name),\n    get: (name) => values.get(name),\n    entries: (namePrefix = '') => [...values].filter(([name]) => name.startsWith(namePrefix)),\n    set: (name, value) => {\n      values.set(name, value);\n      queued.set(name, value);\n      emit([{ name, value, origin: 'local' }]);\n      schedule();\n    },\n    delete: (name) => {\n      if (!values.has(name) && !queued.has(name)) return;\n      values.delete(name);\n      queued.set(name, DELETED);\n      emit([{ name, value: undefined, origin: 'local' }]);\n      schedule();\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    flush,\n    close: async () => {\n      if (closed) return;\n      await flush();\n      closed = true;\n      unsubscribe?.();\n      if (typeof window !== 'undefined') {\n        window.removeEventListener('pagehide', onPageHide);\n        document.removeEventListener('visibilitychange', onVisibility);\n      }\n    },\n    seed: (entries) => {\n      for (const [name, value] of entries) values.set(name, value);\n    },\n    stopWriting: () => {\n      writable = false;\n      queued.clear();\n      if (timer) clearTimeout(timer);\n      timer = null;\n      unsubscribe?.();\n    },\n    applyRemote,\n  };\n  return cache;\n}\n\nfunction stripPrefix(prefix: string, rows: [string, unknown][]): [string, unknown][] {\n  return rows.map(([key, value]): [string, unknown] => [key.slice(prefix.length), value]);\n}\n\nfunction unreadable(options: RecordCacheOptions, error: unknown): OwnedRecordCache {\n  console.warn(\n    `[storage] could not read \"${options.prefix}\"; opening empty and not persisting`,\n    error,\n  );\n  return createRecordCache({ ...options, writable: false });\n}\n\n/** Read every record under `prefix` and hold them. A failed read opens the\n *  cache empty with writing off, so it never overwrites what it could not\n *  read. */\nexport async function openRecords(options: RecordCacheOptions): Promise<OwnedRecordCache> {\n  // Listen before listing, so a change landing between the two is not lost.\n  const early: StorageChange[] = [];\n  const stopEarly = options.storage.subscribe?.(options.prefix, (c) => early.push(...c));\n  let listed: [string, unknown][];\n  try {\n    listed = await options.storage.list(options.prefix);\n  } catch (error) {\n    stopEarly?.();\n    return unreadable(options, error);\n  }\n  const cache = createRecordCache({\n    ...options,\n    initial: stripPrefix(options.prefix, listed),\n  });\n  stopEarly?.();\n  (cache as unknown as { applyRemote: (c: StorageChange[]) => void }).applyRemote(early);\n  return cache;\n}\n\n/** `openRecords` for an adapter that reads synchronously: the cache is ready\n *  on return. A failed read opens it empty with writing off. */\nexport function openRecordsSync(\n  options: RecordCacheOptions & { storage: SyncStorageAdapter },\n): OwnedRecordCache {\n  let listed: [string, unknown][];\n  try {\n    listed = options.storage.listSync(options.prefix);\n  } catch (error) {\n    return unreadable(options, error);\n  }\n  return createRecordCache({\n    ...options,\n    initial: stripPrefix(options.prefix, listed),\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@weasel-js/storage",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.9.3",
+  "description": "Keyed async storage behind one adapter interface — IndexedDB, localStorage, the URL hash, memory — and an in-memory record cache that writes behind and hears other tabs. No React, no weasel deps.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "author": "orochi235",
+  "homepage": "https://orochi235.github.io/weasel/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orochi235/weasel.git",
+    "directory": "packages/storage"
+  },
+  "bugs": {
+    "url": "https://github.com/orochi235/weasel/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}