@noy-db/to-browser-local 0.1.0-pre.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vLannaAi
+
+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

@@ -0,0 +1,33 @@
+# @noy-db/to-browser-local
+
+[![npm](https://img.shields.io/npm/v/%40noy-db/to-browser-local.svg)](https://www.npmjs.com/package/@noy-db/to-browser-local)
+
+> localStorage adapter for noy-db with optional key obfuscation
+
+Part of [**`@noy-db/hub`**](https://www.npmjs.com/package/@noy-db/hub) — the zero-knowledge, offline-first, encrypted document store.
+
+## Install
+
+```bash
+pnpm add @noy-db/hub @noy-db/to-browser-local
+```
+
+## What it is
+
+localStorage adapter for noy-db with optional key obfuscation
+
+## Status
+
+**Pre-release** (`0.1.0-pre.1`). API may change before `1.0`.
+
+## Documentation
+
+See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup, examples, and the full subsystem catalog.
+
+- Source — [`packages/to-browser-local`](https://github.com/vLannaAi/noy-db/tree/main/packages/to-browser-local)
+- Issues — [github.com/vLannaAi/noy-db/issues](https://github.com/vLannaAi/noy-db/issues)
+- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db/blob/main/SPEC.md)
+
+## License
+
+[MIT](./LICENSE) © vLannaAi

package/dist/index.cjs

@@ -0,0 +1,244 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  browserLocalStore: () => browserLocalStore
+});
+module.exports = __toCommonJS(index_exports);
+var import_hub = require("@noy-db/hub");
+function browserLocalStore(options = {}) {
+  const prefix = options.prefix ?? "noydb";
+  const obfuscate = options.obfuscate ?? false;
+  const obfKey = obfuscate ? makeObfKey(prefix) : "";
+  return createLocalStorageAdapter(prefix, obfuscate, obfKey);
+}
+function fnv1a(str) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function hashComponent(value, obfuscate) {
+  return obfuscate ? fnv1a(value) : value;
+}
+function xorEncode(plaintext, key) {
+  const bytes = new TextEncoder().encode(plaintext);
+  const keyBytes = new TextEncoder().encode(key);
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] = bytes[i] ^ keyBytes[i % keyBytes.length];
+  }
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+function xorDecode(encoded, key) {
+  const binary = atob(encoded);
+  const bytes = new Uint8Array(binary.length);
+  const keyBytes = new TextEncoder().encode(key);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i) ^ keyBytes[i % keyBytes.length];
+  }
+  return new TextDecoder().decode(bytes);
+}
+function makeObfKey(prefix) {
+  return prefix + ":noydb-obf-key";
+}
+function wrapValue(envelope, collection, id, obfuscate, obfKey) {
+  if (!obfuscate) return JSON.stringify(envelope);
+  let safeEnvelope = envelope;
+  if (!envelope._iv && envelope._data) {
+    safeEnvelope = { ...safeEnvelope, _data: xorEncode(envelope._data, obfKey) };
+  }
+  if (envelope._by) {
+    safeEnvelope = { ...safeEnvelope, _by: xorEncode(envelope._by, obfKey) };
+  }
+  const stored = {
+    _oi: xorEncode(id, obfKey),
+    _oc: xorEncode(collection, obfKey),
+    _e: safeEnvelope
+  };
+  return JSON.stringify(stored);
+}
+function unwrapValue(raw, obfuscate, obfKey) {
+  const parsed = JSON.parse(raw);
+  if (!obfuscate || !("_e" in parsed)) {
+    const env = parsed;
+    return { envelope: env, origId: "", origCol: "" };
+  }
+  let envelope = parsed._e;
+  if (!envelope._iv && envelope._data) {
+    envelope = { ...envelope, _data: xorDecode(envelope._data, obfKey) };
+  }
+  if (envelope._by) {
+    envelope = { ...envelope, _by: xorDecode(envelope._by, obfKey) };
+  }
+  return {
+    envelope,
+    origId: xorDecode(parsed._oi, obfKey),
+    origCol: xorDecode(parsed._oc, obfKey)
+  };
+}
+function createLocalStorageAdapter(prefix, obfuscate, obfKey) {
+  function key(vault, collection, id) {
+    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:${hashComponent(id, obfuscate)}`;
+  }
+  function collectionPrefix(vault, collection) {
+    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:`;
+  }
+  function compartmentPrefix(vault) {
+    return `${prefix}:${hashComponent(vault, obfuscate)}:`;
+  }
+  return {
+    name: "browser:localStorage",
+    async get(vault, collection, id) {
+      const data = localStorage.getItem(key(vault, collection, id));
+      if (!data) return null;
+      return unwrapValue(data, obfuscate, obfKey).envelope;
+    },
+    async put(vault, collection, id, envelope, expectedVersion) {
+      const k = key(vault, collection, id);
+      if (expectedVersion !== void 0) {
+        const existing = localStorage.getItem(k);
+        if (existing) {
+          const current = unwrapValue(existing, obfuscate, obfKey).envelope;
+          if (current._v !== expectedVersion) {
+            throw new import_hub.ConflictError(current._v, `Version conflict: expected ${expectedVersion}, found ${current._v}`);
+          }
+        }
+      }
+      localStorage.setItem(k, wrapValue(envelope, collection, id, obfuscate, obfKey));
+    },
+    async delete(vault, collection, id) {
+      localStorage.removeItem(key(vault, collection, id));
+    },
+    async list(vault, collection) {
+      const pfx = collectionPrefix(vault, collection);
+      const ids = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (!k?.startsWith(pfx)) continue;
+        if (obfuscate) {
+          const raw = localStorage.getItem(k);
+          if (raw) {
+            const { origId } = unwrapValue(raw, true, obfKey);
+            ids.push(origId);
+          }
+        } else {
+          ids.push(k.slice(pfx.length));
+        }
+      }
+      return ids;
+    },
+    async loadAll(vault) {
+      const pfx = compartmentPrefix(vault);
+      const snapshot = {};
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (!k?.startsWith(pfx)) continue;
+        const raw = localStorage.getItem(k);
+        if (!raw) continue;
+        let collection;
+        let id;
+        if (obfuscate) {
+          const { envelope, origId, origCol } = unwrapValue(raw, true, obfKey);
+          if (origCol.startsWith("_")) continue;
+          collection = origCol;
+          id = origId;
+          if (!snapshot[collection]) snapshot[collection] = {};
+          snapshot[collection][id] = envelope;
+        } else {
+          const rest = k.slice(pfx.length);
+          const colonIdx = rest.indexOf(":");
+          if (colonIdx < 0) continue;
+          collection = rest.slice(0, colonIdx);
+          id = rest.slice(colonIdx + 1);
+          if (collection.startsWith("_")) continue;
+          if (!snapshot[collection]) snapshot[collection] = {};
+          snapshot[collection][id] = JSON.parse(raw);
+        }
+      }
+      return snapshot;
+    },
+    async saveAll(vault, data) {
+      for (const [collection, records] of Object.entries(data)) {
+        for (const [id, envelope] of Object.entries(records)) {
+          localStorage.setItem(
+            key(vault, collection, id),
+            wrapValue(envelope, collection, id, obfuscate, obfKey)
+          );
+        }
+      }
+    },
+    async ping() {
+      try {
+        const testKey = `${prefix}:__ping__`;
+        localStorage.setItem(testKey, "1");
+        localStorage.removeItem(testKey);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Paginate over a collection. Cursor is a numeric offset (as a string)
+     * into the sorted localStorage key list. Sorting by key gives stable
+     * ordering across page fetches even when other code is mutating
+     * unrelated keys in the same prefix.
+     *
+     * Note: localStorage's `length` and `key(i)` are O(N) per call in some
+     * browsers, so listing the matching keys upfront is faster than
+     * iterating in slices.
+     */
+    async listPage(vault, collection, cursor, limit = 100) {
+      const pfx = collectionPrefix(vault, collection);
+      const matchedKeys = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (k?.startsWith(pfx)) matchedKeys.push(k);
+      }
+      matchedKeys.sort();
+      const start = cursor ? parseInt(cursor, 10) : 0;
+      const end = Math.min(start + limit, matchedKeys.length);
+      const items = [];
+      for (let i = start; i < end; i++) {
+        const k = matchedKeys[i];
+        const raw = localStorage.getItem(k);
+        if (!raw) continue;
+        const { envelope, origId } = unwrapValue(raw, obfuscate, obfKey);
+        const id = obfuscate ? origId : k.slice(pfx.length);
+        items.push({ id, envelope });
+      }
+      return {
+        items,
+        nextCursor: end < matchedKeys.length ? String(end) : null
+      };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  browserLocalStore
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/to-browser-local** — `localStorage`-backed NOYDB store.\n *\n * All data is stored under `localStorage` with keys of the form\n * `{prefix}:{vault}:{collection}:{id}`. CAS checks are synchronous and\n * inherently atomic within a single JS thread.\n *\n * ## When to use\n *\n * Use `@noy-db/to-browser-idb` for most browser applications — it supports\n * larger storage quotas and true atomic transactions. Prefer this store only\n * when IndexedDB is unavailable (rare) or when you need storage that survives\n * across `sessionStorage` clears but is inspectable without DevTools.\n *\n * ## Obfuscation mode\n *\n * Setting `obfuscate: true` replaces each key component with an FNV-1a hash\n * and XOR-encodes metadata (vault name, collection name, record ID, `_by`\n * attribution) so that the logical structure of the data is not visible to\n * browser extensions or DevTools. This is **not** encryption — the envelope\n * `_data` field is always AES-GCM ciphertext regardless of this setting.\n *\n * ## Capabilities\n *\n * | Capability | Value |\n * |---|---|\n * | `casAtomic` | `true` — synchronous single-threaded JS |\n * | `listPage` | ✓ — cursor-based pagination |\n * | `ping` | ✓ — round-trips a sentinel key |\n *\n * @packageDocumentation\n */\n\nimport type { NoydbStore, EncryptedEnvelope, VaultSnapshot } from '@noy-db/hub'\nimport { ConflictError } from '@noy-db/hub'\n\n/**\n * Options for `browserLocalStore()`.\n *\n * All NOYDB data is stored in `localStorage` under `{prefix}:{vault}:{collection}:{id}`.\n * Enable `obfuscate` to replace each path component with an FNV-1a hash and\n * XOR-encode metadata so vault/collection/record names are not visible to\n * browser extensions or DevTools inspecting `localStorage`.\n */\nexport interface BrowserLocalOptions {\n  /** Storage key prefix. Default: 'noydb'. */\n  prefix?: string\n  /** Obfuscate storage keys so collection/record names are not readable. Default: false. */\n  obfuscate?: boolean\n}\n\n/**\n * Create a localStorage-backed store adapter.\n *\n * Key scheme (normal):    `{prefix}:{vault}:{collection}:{id}`\n * Key scheme (obfuscated): `{prefix}:{hash}:{hash}:{hash}`\n *\n * StoreCapabilities:\n *   casAtomic: true  — localStorage ops are synchronous and inherently atomic\n *   auth: { kind: 'browser-origin', flow: 'implicit', required: false }\n */\nexport function browserLocalStore(options: BrowserLocalOptions = {}): NoydbStore {\n  const prefix = options.prefix ?? 'noydb'\n  const obfuscate = options.obfuscate ?? false\n  const obfKey = obfuscate ? makeObfKey(prefix) : ''\n\n  return createLocalStorageAdapter(prefix, obfuscate, obfKey)\n}\n\n// ─── Key Obfuscation ───────────────────────────────────────────────────\n\n/**\n * FNV-1a 32-bit hash → 8-char hex string.\n * Not cryptographic — just makes keys opaque to casual inspection.\n */\nfunction fnv1a(str: string): string {\n  let hash = 0x811c9dc5\n  for (let i = 0; i < str.length; i++) {\n    hash ^= str.charCodeAt(i)\n    hash = Math.imul(hash, 0x01000193)\n  }\n  return (hash >>> 0).toString(16).padStart(8, '0')\n}\n\nfunction hashComponent(value: string, obfuscate: boolean): string {\n  return obfuscate ? fnv1a(value) : value\n}\n\n// ─── XOR Encode/Decode (makes metadata unreadable in storage) ──────────\n\n/** XOR-encode a string with a repeating key, return base64. */\nfunction xorEncode(plaintext: string, key: string): string {\n  const bytes = new TextEncoder().encode(plaintext)\n  const keyBytes = new TextEncoder().encode(key)\n  for (let i = 0; i < bytes.length; i++) {\n    bytes[i] = bytes[i]! ^ keyBytes[i % keyBytes.length]!\n  }\n  let binary = ''\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]!)\n  }\n  return btoa(binary)\n}\n\n/** Decode a base64 XOR-encoded string. */\nfunction xorDecode(encoded: string, key: string): string {\n  const binary = atob(encoded)\n  const bytes = new Uint8Array(binary.length)\n  const keyBytes = new TextEncoder().encode(key)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i) ^ keyBytes[i % keyBytes.length]!\n  }\n  return new TextDecoder().decode(bytes)\n}\n\n/** Stored value wraps envelope + encoded original key parts. */\ninterface StoredValue {\n  /** Encoded original record ID. */\n  _oi: string\n  /** Encoded original collection name. */\n  _oc: string\n  /** The encrypted envelope. */\n  _e: EncryptedEnvelope\n}\n\nfunction makeObfKey(prefix: string): string {\n  return prefix + ':noydb-obf-key'\n}\n\nfunction wrapValue(envelope: EncryptedEnvelope, collection: string, id: string, obfuscate: boolean, obfKey: string): string {\n  if (!obfuscate) return JSON.stringify(envelope)\n\n  let safeEnvelope = envelope\n\n  // If _data is plaintext (e.g. keyring: _iv is empty), XOR-encode it\n  if (!envelope._iv && envelope._data) {\n    safeEnvelope = { ...safeEnvelope, _data: xorEncode(envelope._data, obfKey) }\n  }\n\n  // XOR-encode _by (user attribution) if present\n  if (envelope._by) {\n    safeEnvelope = { ...safeEnvelope, _by: xorEncode(envelope._by, obfKey) }\n  }\n\n  const stored: StoredValue = {\n    _oi: xorEncode(id, obfKey),\n    _oc: xorEncode(collection, obfKey),\n    _e: safeEnvelope,\n  }\n  return JSON.stringify(stored)\n}\n\nfunction unwrapValue(raw: string, obfuscate: boolean, obfKey: string): { envelope: EncryptedEnvelope; origId: string; origCol: string } {\n  const parsed = JSON.parse(raw) as StoredValue | EncryptedEnvelope\n  if (!obfuscate || !('_e' in parsed)) {\n    const env = parsed as EncryptedEnvelope\n    return { envelope: env, origId: '', origCol: '' }\n  }\n\n  let envelope = parsed._e\n  // Decode _data if it was XOR-encoded (keyring entries with empty _iv)\n  if (!envelope._iv && envelope._data) {\n    envelope = { ...envelope, _data: xorDecode(envelope._data, obfKey) }\n  }\n  // Decode _by if it was XOR-encoded\n  if (envelope._by) {\n    envelope = { ...envelope, _by: xorDecode(envelope._by, obfKey) }\n  }\n\n  return {\n    envelope,\n    origId: xorDecode(parsed._oi, obfKey),\n    origCol: xorDecode(parsed._oc, obfKey),\n  }\n}\n\n// ─── localStorage Backend ──────────────────────────────────────────────\n\nfunction createLocalStorageAdapter(prefix: string, obfuscate: boolean, obfKey: string): NoydbStore {\n  function key(vault: string, collection: string, id: string): string {\n    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:${hashComponent(id, obfuscate)}`\n  }\n\n  function collectionPrefix(vault: string, collection: string): string {\n    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:`\n  }\n\n  function compartmentPrefix(vault: string): string {\n    return `${prefix}:${hashComponent(vault, obfuscate)}:`\n  }\n\n  return {\n    name: 'browser:localStorage',\n\n    async get(vault, collection, id) {\n      const data = localStorage.getItem(key(vault, collection, id))\n      if (!data) return null\n      return unwrapValue(data, obfuscate, obfKey).envelope\n    },\n\n    async put(vault, collection, id, envelope, expectedVersion) {\n      const k = key(vault, collection, id)\n\n      if (expectedVersion !== undefined) {\n        const existing = localStorage.getItem(k)\n        if (existing) {\n          const current = unwrapValue(existing, obfuscate, obfKey).envelope\n          if (current._v !== expectedVersion) {\n            throw new ConflictError(current._v, `Version conflict: expected ${expectedVersion}, found ${current._v}`)\n          }\n        }\n      }\n\n      localStorage.setItem(k, wrapValue(envelope, collection, id, obfuscate, obfKey))\n    },\n\n    async delete(vault, collection, id) {\n      localStorage.removeItem(key(vault, collection, id))\n    },\n\n    async list(vault, collection) {\n      const pfx = collectionPrefix(vault, collection)\n      const ids: string[] = []\n      for (let i = 0; i < localStorage.length; i++) {\n        const k = localStorage.key(i)\n        if (!k?.startsWith(pfx)) continue\n\n        if (obfuscate) {\n          const raw = localStorage.getItem(k)\n          if (raw) {\n            const { origId } = unwrapValue(raw, true, obfKey)\n            ids.push(origId)\n          }\n        } else {\n          ids.push(k.slice(pfx.length))\n        }\n      }\n      return ids\n    },\n\n    async loadAll(vault) {\n      const pfx = compartmentPrefix(vault)\n      const snapshot: VaultSnapshot = {}\n\n      for (let i = 0; i < localStorage.length; i++) {\n        const k = localStorage.key(i)\n        if (!k?.startsWith(pfx)) continue\n\n        const raw = localStorage.getItem(k)\n        if (!raw) continue\n\n        let collection: string\n        let id: string\n\n        if (obfuscate) {\n          const { envelope, origId, origCol } = unwrapValue(raw, true, obfKey)\n          if (origCol.startsWith('_')) continue\n          collection = origCol\n          id = origId\n          if (!snapshot[collection]) snapshot[collection] = {}\n          snapshot[collection]![id] = envelope\n        } else {\n          const rest = k.slice(pfx.length)\n          const colonIdx = rest.indexOf(':')\n          if (colonIdx < 0) continue\n          collection = rest.slice(0, colonIdx)\n          id = rest.slice(colonIdx + 1)\n          if (collection.startsWith('_')) continue\n          if (!snapshot[collection]) snapshot[collection] = {}\n          snapshot[collection]![id] = JSON.parse(raw) as EncryptedEnvelope\n        }\n      }\n\n      return snapshot\n    },\n\n    async saveAll(vault, data) {\n      for (const [collection, records] of Object.entries(data)) {\n        for (const [id, envelope] of Object.entries(records)) {\n          localStorage.setItem(\n            key(vault, collection, id),\n            wrapValue(envelope, collection, id, obfuscate, obfKey),\n          )\n        }\n      }\n    },\n\n    async ping() {\n      try {\n        const testKey = `${prefix}:__ping__`\n        localStorage.setItem(testKey, '1')\n        localStorage.removeItem(testKey)\n        return true\n      } catch {\n        return false\n      }\n    },\n\n    /**\n     * Paginate over a collection. Cursor is a numeric offset (as a string)\n     * into the sorted localStorage key list. Sorting by key gives stable\n     * ordering across page fetches even when other code is mutating\n     * unrelated keys in the same prefix.\n     *\n     * Note: localStorage's `length` and `key(i)` are O(N) per call in some\n     * browsers, so listing the matching keys upfront is faster than\n     * iterating in slices.\n     */\n    async listPage(vault, collection, cursor, limit = 100) {\n      const pfx = collectionPrefix(vault, collection)\n      const matchedKeys: string[] = []\n      for (let i = 0; i < localStorage.length; i++) {\n        const k = localStorage.key(i)\n        if (k?.startsWith(pfx)) matchedKeys.push(k)\n      }\n      matchedKeys.sort()\n\n      const start = cursor ? parseInt(cursor, 10) : 0\n      const end = Math.min(start + limit, matchedKeys.length)\n\n      const items: Array<{ id: string; envelope: EncryptedEnvelope }> = []\n      for (let i = start; i < end; i++) {\n        const k = matchedKeys[i]!\n        const raw = localStorage.getItem(k)\n        if (!raw) continue\n        const { envelope, origId } = unwrapValue(raw, obfuscate, obfKey)\n        const id = obfuscate ? origId : k.slice(pfx.length)\n        items.push({ id, envelope })\n      }\n\n      return {\n        items,\n        nextCursor: end < matchedKeys.length ? String(end) : null,\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+import { NoydbStore } from '@noy-db/hub';
+
+/**
+ * **@noy-db/to-browser-local** — `localStorage`-backed NOYDB store.
+ *
+ * All data is stored under `localStorage` with keys of the form
+ * `{prefix}:{vault}:{collection}:{id}`. CAS checks are synchronous and
+ * inherently atomic within a single JS thread.
+ *
+ * ## When to use
+ *
+ * Use `@noy-db/to-browser-idb` for most browser applications — it supports
+ * larger storage quotas and true atomic transactions. Prefer this store only
+ * when IndexedDB is unavailable (rare) or when you need storage that survives
+ * across `sessionStorage` clears but is inspectable without DevTools.
+ *
+ * ## Obfuscation mode
+ *
+ * Setting `obfuscate: true` replaces each key component with an FNV-1a hash
+ * and XOR-encodes metadata (vault name, collection name, record ID, `_by`
+ * attribution) so that the logical structure of the data is not visible to
+ * browser extensions or DevTools. This is **not** encryption — the envelope
+ * `_data` field is always AES-GCM ciphertext regardless of this setting.
+ *
+ * ## Capabilities
+ *
+ * | Capability | Value |
+ * |---|---|
+ * | `casAtomic` | `true` — synchronous single-threaded JS |
+ * | `listPage` | ✓ — cursor-based pagination |
+ * | `ping` | ✓ — round-trips a sentinel key |
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for `browserLocalStore()`.
+ *
+ * All NOYDB data is stored in `localStorage` under `{prefix}:{vault}:{collection}:{id}`.
+ * Enable `obfuscate` to replace each path component with an FNV-1a hash and
+ * XOR-encode metadata so vault/collection/record names are not visible to
+ * browser extensions or DevTools inspecting `localStorage`.
+ */
+interface BrowserLocalOptions {
+    /** Storage key prefix. Default: 'noydb'. */
+    prefix?: string;
+    /** Obfuscate storage keys so collection/record names are not readable. Default: false. */
+    obfuscate?: boolean;
+}
+/**
+ * Create a localStorage-backed store adapter.
+ *
+ * Key scheme (normal):    `{prefix}:{vault}:{collection}:{id}`
+ * Key scheme (obfuscated): `{prefix}:{hash}:{hash}:{hash}`
+ *
+ * StoreCapabilities:
+ *   casAtomic: true  — localStorage ops are synchronous and inherently atomic
+ *   auth: { kind: 'browser-origin', flow: 'implicit', required: false }
+ */
+declare function browserLocalStore(options?: BrowserLocalOptions): NoydbStore;
+
+export { type BrowserLocalOptions, browserLocalStore };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { NoydbStore } from '@noy-db/hub';
+
+/**
+ * **@noy-db/to-browser-local** — `localStorage`-backed NOYDB store.
+ *
+ * All data is stored under `localStorage` with keys of the form
+ * `{prefix}:{vault}:{collection}:{id}`. CAS checks are synchronous and
+ * inherently atomic within a single JS thread.
+ *
+ * ## When to use
+ *
+ * Use `@noy-db/to-browser-idb` for most browser applications — it supports
+ * larger storage quotas and true atomic transactions. Prefer this store only
+ * when IndexedDB is unavailable (rare) or when you need storage that survives
+ * across `sessionStorage` clears but is inspectable without DevTools.
+ *
+ * ## Obfuscation mode
+ *
+ * Setting `obfuscate: true` replaces each key component with an FNV-1a hash
+ * and XOR-encodes metadata (vault name, collection name, record ID, `_by`
+ * attribution) so that the logical structure of the data is not visible to
+ * browser extensions or DevTools. This is **not** encryption — the envelope
+ * `_data` field is always AES-GCM ciphertext regardless of this setting.
+ *
+ * ## Capabilities
+ *
+ * | Capability | Value |
+ * |---|---|
+ * | `casAtomic` | `true` — synchronous single-threaded JS |
+ * | `listPage` | ✓ — cursor-based pagination |
+ * | `ping` | ✓ — round-trips a sentinel key |
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for `browserLocalStore()`.
+ *
+ * All NOYDB data is stored in `localStorage` under `{prefix}:{vault}:{collection}:{id}`.
+ * Enable `obfuscate` to replace each path component with an FNV-1a hash and
+ * XOR-encode metadata so vault/collection/record names are not visible to
+ * browser extensions or DevTools inspecting `localStorage`.
+ */
+interface BrowserLocalOptions {
+    /** Storage key prefix. Default: 'noydb'. */
+    prefix?: string;
+    /** Obfuscate storage keys so collection/record names are not readable. Default: false. */
+    obfuscate?: boolean;
+}
+/**
+ * Create a localStorage-backed store adapter.
+ *
+ * Key scheme (normal):    `{prefix}:{vault}:{collection}:{id}`
+ * Key scheme (obfuscated): `{prefix}:{hash}:{hash}:{hash}`
+ *
+ * StoreCapabilities:
+ *   casAtomic: true  — localStorage ops are synchronous and inherently atomic
+ *   auth: { kind: 'browser-origin', flow: 'implicit', required: false }
+ */
+declare function browserLocalStore(options?: BrowserLocalOptions): NoydbStore;
+
+export { type BrowserLocalOptions, browserLocalStore };

package/dist/index.js

@@ -0,0 +1,219 @@
+// src/index.ts
+import { ConflictError } from "@noy-db/hub";
+function browserLocalStore(options = {}) {
+  const prefix = options.prefix ?? "noydb";
+  const obfuscate = options.obfuscate ?? false;
+  const obfKey = obfuscate ? makeObfKey(prefix) : "";
+  return createLocalStorageAdapter(prefix, obfuscate, obfKey);
+}
+function fnv1a(str) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function hashComponent(value, obfuscate) {
+  return obfuscate ? fnv1a(value) : value;
+}
+function xorEncode(plaintext, key) {
+  const bytes = new TextEncoder().encode(plaintext);
+  const keyBytes = new TextEncoder().encode(key);
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] = bytes[i] ^ keyBytes[i % keyBytes.length];
+  }
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+function xorDecode(encoded, key) {
+  const binary = atob(encoded);
+  const bytes = new Uint8Array(binary.length);
+  const keyBytes = new TextEncoder().encode(key);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i) ^ keyBytes[i % keyBytes.length];
+  }
+  return new TextDecoder().decode(bytes);
+}
+function makeObfKey(prefix) {
+  return prefix + ":noydb-obf-key";
+}
+function wrapValue(envelope, collection, id, obfuscate, obfKey) {
+  if (!obfuscate) return JSON.stringify(envelope);
+  let safeEnvelope = envelope;
+  if (!envelope._iv && envelope._data) {
+    safeEnvelope = { ...safeEnvelope, _data: xorEncode(envelope._data, obfKey) };
+  }
+  if (envelope._by) {
+    safeEnvelope = { ...safeEnvelope, _by: xorEncode(envelope._by, obfKey) };
+  }
+  const stored = {
+    _oi: xorEncode(id, obfKey),
+    _oc: xorEncode(collection, obfKey),
+    _e: safeEnvelope
+  };
+  return JSON.stringify(stored);
+}
+function unwrapValue(raw, obfuscate, obfKey) {
+  const parsed = JSON.parse(raw);
+  if (!obfuscate || !("_e" in parsed)) {
+    const env = parsed;
+    return { envelope: env, origId: "", origCol: "" };
+  }
+  let envelope = parsed._e;
+  if (!envelope._iv && envelope._data) {
+    envelope = { ...envelope, _data: xorDecode(envelope._data, obfKey) };
+  }
+  if (envelope._by) {
+    envelope = { ...envelope, _by: xorDecode(envelope._by, obfKey) };
+  }
+  return {
+    envelope,
+    origId: xorDecode(parsed._oi, obfKey),
+    origCol: xorDecode(parsed._oc, obfKey)
+  };
+}
+function createLocalStorageAdapter(prefix, obfuscate, obfKey) {
+  function key(vault, collection, id) {
+    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:${hashComponent(id, obfuscate)}`;
+  }
+  function collectionPrefix(vault, collection) {
+    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:`;
+  }
+  function compartmentPrefix(vault) {
+    return `${prefix}:${hashComponent(vault, obfuscate)}:`;
+  }
+  return {
+    name: "browser:localStorage",
+    async get(vault, collection, id) {
+      const data = localStorage.getItem(key(vault, collection, id));
+      if (!data) return null;
+      return unwrapValue(data, obfuscate, obfKey).envelope;
+    },
+    async put(vault, collection, id, envelope, expectedVersion) {
+      const k = key(vault, collection, id);
+      if (expectedVersion !== void 0) {
+        const existing = localStorage.getItem(k);
+        if (existing) {
+          const current = unwrapValue(existing, obfuscate, obfKey).envelope;
+          if (current._v !== expectedVersion) {
+            throw new ConflictError(current._v, `Version conflict: expected ${expectedVersion}, found ${current._v}`);
+          }
+        }
+      }
+      localStorage.setItem(k, wrapValue(envelope, collection, id, obfuscate, obfKey));
+    },
+    async delete(vault, collection, id) {
+      localStorage.removeItem(key(vault, collection, id));
+    },
+    async list(vault, collection) {
+      const pfx = collectionPrefix(vault, collection);
+      const ids = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (!k?.startsWith(pfx)) continue;
+        if (obfuscate) {
+          const raw = localStorage.getItem(k);
+          if (raw) {
+            const { origId } = unwrapValue(raw, true, obfKey);
+            ids.push(origId);
+          }
+        } else {
+          ids.push(k.slice(pfx.length));
+        }
+      }
+      return ids;
+    },
+    async loadAll(vault) {
+      const pfx = compartmentPrefix(vault);
+      const snapshot = {};
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (!k?.startsWith(pfx)) continue;
+        const raw = localStorage.getItem(k);
+        if (!raw) continue;
+        let collection;
+        let id;
+        if (obfuscate) {
+          const { envelope, origId, origCol } = unwrapValue(raw, true, obfKey);
+          if (origCol.startsWith("_")) continue;
+          collection = origCol;
+          id = origId;
+          if (!snapshot[collection]) snapshot[collection] = {};
+          snapshot[collection][id] = envelope;
+        } else {
+          const rest = k.slice(pfx.length);
+          const colonIdx = rest.indexOf(":");
+          if (colonIdx < 0) continue;
+          collection = rest.slice(0, colonIdx);
+          id = rest.slice(colonIdx + 1);
+          if (collection.startsWith("_")) continue;
+          if (!snapshot[collection]) snapshot[collection] = {};
+          snapshot[collection][id] = JSON.parse(raw);
+        }
+      }
+      return snapshot;
+    },
+    async saveAll(vault, data) {
+      for (const [collection, records] of Object.entries(data)) {
+        for (const [id, envelope] of Object.entries(records)) {
+          localStorage.setItem(
+            key(vault, collection, id),
+            wrapValue(envelope, collection, id, obfuscate, obfKey)
+          );
+        }
+      }
+    },
+    async ping() {
+      try {
+        const testKey = `${prefix}:__ping__`;
+        localStorage.setItem(testKey, "1");
+        localStorage.removeItem(testKey);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Paginate over a collection. Cursor is a numeric offset (as a string)
+     * into the sorted localStorage key list. Sorting by key gives stable
+     * ordering across page fetches even when other code is mutating
+     * unrelated keys in the same prefix.
+     *
+     * Note: localStorage's `length` and `key(i)` are O(N) per call in some
+     * browsers, so listing the matching keys upfront is faster than
+     * iterating in slices.
+     */
+    async listPage(vault, collection, cursor, limit = 100) {
+      const pfx = collectionPrefix(vault, collection);
+      const matchedKeys = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const k = localStorage.key(i);
+        if (k?.startsWith(pfx)) matchedKeys.push(k);
+      }
+      matchedKeys.sort();
+      const start = cursor ? parseInt(cursor, 10) : 0;
+      const end = Math.min(start + limit, matchedKeys.length);
+      const items = [];
+      for (let i = start; i < end; i++) {
+        const k = matchedKeys[i];
+        const raw = localStorage.getItem(k);
+        if (!raw) continue;
+        const { envelope, origId } = unwrapValue(raw, obfuscate, obfKey);
+        const id = obfuscate ? origId : k.slice(pfx.length);
+        items.push({ id, envelope });
+      }
+      return {
+        items,
+        nextCursor: end < matchedKeys.length ? String(end) : null
+      };
+    }
+  };
+}
+export {
+  browserLocalStore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/to-browser-local** — `localStorage`-backed NOYDB store.\n *\n * All data is stored under `localStorage` with keys of the form\n * `{prefix}:{vault}:{collection}:{id}`. CAS checks are synchronous and\n * inherently atomic within a single JS thread.\n *\n * ## When to use\n *\n * Use `@noy-db/to-browser-idb` for most browser applications — it supports\n * larger storage quotas and true atomic transactions. Prefer this store only\n * when IndexedDB is unavailable (rare) or when you need storage that survives\n * across `sessionStorage` clears but is inspectable without DevTools.\n *\n * ## Obfuscation mode\n *\n * Setting `obfuscate: true` replaces each key component with an FNV-1a hash\n * and XOR-encodes metadata (vault name, collection name, record ID, `_by`\n * attribution) so that the logical structure of the data is not visible to\n * browser extensions or DevTools. This is **not** encryption — the envelope\n * `_data` field is always AES-GCM ciphertext regardless of this setting.\n *\n * ## Capabilities\n *\n * | Capability | Value |\n * |---|---|\n * | `casAtomic` | `true` — synchronous single-threaded JS |\n * | `listPage` | ✓ — cursor-based pagination |\n * | `ping` | ✓ — round-trips a sentinel key |\n *\n * @packageDocumentation\n */\n\nimport type { NoydbStore, EncryptedEnvelope, VaultSnapshot } from '@noy-db/hub'\nimport { ConflictError } from '@noy-db/hub'\n\n/**\n * Options for `browserLocalStore()`.\n *\n * All NOYDB data is stored in `localStorage` under `{prefix}:{vault}:{collection}:{id}`.\n * Enable `obfuscate` to replace each path component with an FNV-1a hash and\n * XOR-encode metadata so vault/collection/record names are not visible to\n * browser extensions or DevTools inspecting `localStorage`.\n */\nexport interface BrowserLocalOptions {\n  /** Storage key prefix. Default: 'noydb'. */\n  prefix?: string\n  /** Obfuscate storage keys so collection/record names are not readable. Default: false. */\n  obfuscate?: boolean\n}\n\n/**\n * Create a localStorage-backed store adapter.\n *\n * Key scheme (normal):    `{prefix}:{vault}:{collection}:{id}`\n * Key scheme (obfuscated): `{prefix}:{hash}:{hash}:{hash}`\n *\n * StoreCapabilities:\n *   casAtomic: true  — localStorage ops are synchronous and inherently atomic\n *   auth: { kind: 'browser-origin', flow: 'implicit', required: false }\n */\nexport function browserLocalStore(options: BrowserLocalOptions = {}): NoydbStore {\n  const prefix = options.prefix ?? 'noydb'\n  const obfuscate = options.obfuscate ?? false\n  const obfKey = obfuscate ? makeObfKey(prefix) : ''\n\n  return createLocalStorageAdapter(prefix, obfuscate, obfKey)\n}\n\n// ─── Key Obfuscation ───────────────────────────────────────────────────\n\n/**\n * FNV-1a 32-bit hash → 8-char hex string.\n * Not cryptographic — just makes keys opaque to casual inspection.\n */\nfunction fnv1a(str: string): string {\n  let hash = 0x811c9dc5\n  for (let i = 0; i < str.length; i++) {\n    hash ^= str.charCodeAt(i)\n    hash = Math.imul(hash, 0x01000193)\n  }\n  return (hash >>> 0).toString(16).padStart(8, '0')\n}\n\nfunction hashComponent(value: string, obfuscate: boolean): string {\n  return obfuscate ? fnv1a(value) : value\n}\n\n// ─── XOR Encode/Decode (makes metadata unreadable in storage) ──────────\n\n/** XOR-encode a string with a repeating key, return base64. */\nfunction xorEncode(plaintext: string, key: string): string {\n  const bytes = new TextEncoder().encode(plaintext)\n  const keyBytes = new TextEncoder().encode(key)\n  for (let i = 0; i < bytes.length; i++) {\n    bytes[i] = bytes[i]! ^ keyBytes[i % keyBytes.length]!\n  }\n  let binary = ''\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]!)\n  }\n  return btoa(binary)\n}\n\n/** Decode a base64 XOR-encoded string. */\nfunction xorDecode(encoded: string, key: string): string {\n  const binary = atob(encoded)\n  const bytes = new Uint8Array(binary.length)\n  const keyBytes = new TextEncoder().encode(key)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i) ^ keyBytes[i % keyBytes.length]!\n  }\n  return new TextDecoder().decode(bytes)\n}\n\n/** Stored value wraps envelope + encoded original key parts. */\ninterface StoredValue {\n  /** Encoded original record ID. */\n  _oi: string\n  /** Encoded original collection name. */\n  _oc: string\n  /** The encrypted envelope. */\n  _e: EncryptedEnvelope\n}\n\nfunction makeObfKey(prefix: string): string {\n  return prefix + ':noydb-obf-key'\n}\n\nfunction wrapValue(envelope: EncryptedEnvelope, collection: string, id: string, obfuscate: boolean, obfKey: string): string {\n  if (!obfuscate) return JSON.stringify(envelope)\n\n  let safeEnvelope = envelope\n\n  // If _data is plaintext (e.g. keyring: _iv is empty), XOR-encode it\n  if (!envelope._iv && envelope._data) {\n    safeEnvelope = { ...safeEnvelope, _data: xorEncode(envelope._data, obfKey) }\n  }\n\n  // XOR-encode _by (user attribution) if present\n  if (envelope._by) {\n    safeEnvelope = { ...safeEnvelope, _by: xorEncode(envelope._by, obfKey) }\n  }\n\n  const stored: StoredValue = {\n    _oi: xorEncode(id, obfKey),\n    _oc: xorEncode(collection, obfKey),\n    _e: safeEnvelope,\n  }\n  return JSON.stringify(stored)\n}\n\nfunction unwrapValue(raw: string, obfuscate: boolean, obfKey: string): { envelope: EncryptedEnvelope; origId: string; origCol: string } {\n  const parsed = JSON.parse(raw) as StoredValue | EncryptedEnvelope\n  if (!obfuscate || !('_e' in parsed)) {\n    const env = parsed as EncryptedEnvelope\n    return { envelope: env, origId: '', origCol: '' }\n  }\n\n  let envelope = parsed._e\n  // Decode _data if it was XOR-encoded (keyring entries with empty _iv)\n  if (!envelope._iv && envelope._data) {\n    envelope = { ...envelope, _data: xorDecode(envelope._data, obfKey) }\n  }\n  // Decode _by if it was XOR-encoded\n  if (envelope._by) {\n    envelope = { ...envelope, _by: xorDecode(envelope._by, obfKey) }\n  }\n\n  return {\n    envelope,\n    origId: xorDecode(parsed._oi, obfKey),\n    origCol: xorDecode(parsed._oc, obfKey),\n  }\n}\n\n// ─── localStorage Backend ──────────────────────────────────────────────\n\nfunction createLocalStorageAdapter(prefix: string, obfuscate: boolean, obfKey: string): NoydbStore {\n  function key(vault: string, collection: string, id: string): string {\n    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:${hashComponent(id, obfuscate)}`\n  }\n\n  function collectionPrefix(vault: string, collection: string): string {\n    return `${prefix}:${hashComponent(vault, obfuscate)}:${hashComponent(collection, obfuscate)}:`\n  }\n\n  function compartmentPrefix(vault: string): string {\n    return `${prefix}:${hashComponent(vault, obfuscate)}:`\n  }\n\n  return {\n    name: 'browser:localStorage',\n\n    async get(vault, collection, id) {\n      const data = localStorage.getItem(key(vault, collection, id))\n      if (!data) return null\n      return unwrapValue(data, obfuscate, obfKey).envelope\n    },\n\n    async put(vault, collection, id, envelope, expectedVersion) {\n      const k = key(vault, collection, id)\n\n      if (expectedVersion !== undefined) {\n        const existing = localStorage.getItem(k)\n        if (existing) {\n          const current = unwrapValue(existing, obfuscate, obfKey).envelope\n          if (current._v !== expectedVersion) {\n            throw new ConflictError(current._v, `Version conflict: expected ${expectedVersion}, found ${current._v}`)\n          }\n        }\n      }\n\n      localStorage.setItem(k, wrapValue(envelope, collection, id, obfuscate, obfKey))\n    },\n\n    async delete(vault, collection, id) {\n      localStorage.removeItem(key(vault, collection, id))\n    },\n\n    async list(vault, collection) {\n      const pfx = collectionPrefix(vault, collection)\n      const ids: string[] = []\n      for (let i = 0; i < localStorage.length; i++) {\n        const k = localStorage.key(i)\n        if (!k?.startsWith(pfx)) continue\n\n        if (obfuscate) {\n          const raw = localStorage.getItem(k)\n          if (raw) {\n            const { origId } = unwrapValue(raw, true, obfKey)\n            ids.push(origId)\n          }\n        } else {\n          ids.push(k.slice(pfx.length))\n        }\n      }\n      return ids\n    },\n\n    async loadAll(vault) {\n      const pfx = compartmentPrefix(vault)\n      const snapshot: VaultSnapshot = {}\n\n      for (let i = 0; i < localStorage.length; i++) {\n        const k = localStorage.key(i)\n        if (!k?.startsWith(pfx)) continue\n\n        const raw = localStorage.getItem(k)\n        if (!raw) continue\n\n        let collection: string\n        let id: string\n\n        if (obfuscate) {\n          const { envelope, origId, origCol } = unwrapValue(raw, true, obfKey)\n          if (origCol.startsWith('_')) continue\n          collection = origCol\n          id = origId\n          if (!snapshot[collection]) snapshot[collection] = {}\n          snapshot[collection]![id] = envelope\n        } else {\n          const rest = k.slice(pfx.length)\n          const colonIdx = rest.indexOf(':')\n          if (colonIdx < 0) continue\n          collection = rest.slice(0, colonIdx)\n          id = rest.slice(colonIdx + 1)\n          if (collection.startsWith('_')) continue\n          if (!snapshot[collection]) snapshot[collection] = {}\n          snapshot[collection]![id] = JSON.parse(raw) as EncryptedEnvelope\n        }\n      }\n\n      return snapshot\n    },\n\n    async saveAll(vault, data) {\n      for (const [collection, records] of Object.entries(data)) {\n        for (const [id, envelope] of Object.entries(records)) {\n          localStorage.setItem(\n            key(vault, collection, id),\n            wrapValue(envelope, collection, id, obfuscate, obfKey),\n          )\n        }\n      }\n    },\n\n    async ping() {\n      try {\n        const testKey = `${prefix}:__ping__`\n        localStorage.setItem(testKey, '1')\n        localStorage.removeItem(testKey)\n        return true\n      } catch {\n        return false\n      }\n    },\n\n    /**\n     * Paginate over a collection. Cursor is a numeric offset (as a string)\n     * into the sorted localStorage key list. Sorting by key gives stable\n     * ordering across page fetches even when other code is mutating\n     * unrelated keys in the same prefix.\n     *\n     * Note: localStorage's `length` and `key(i)` are O(N) per call in some\n     * browsers, so listing the matching keys upfront is faster than\n     * iterating in slices.\n     */\n    async listPage(vault, collection, cursor, limit = 100) {\n      const pfx = collectionPrefix(vault, collection)\n      const matchedKeys: string[] = []\n      for (let i = 0; i < localStorage.length; i++) {\n        const k = localStorage.key(i)\n        if (k?.startsWith(pfx)) matchedKeys.push(k)\n      }\n      matchedKeys.sort()\n\n      const start = cursor ? parseInt(cursor, 10) : 0\n      const end = Math.min(start + limit, matchedKeys.length)\n\n      const items: Array<{ id: string; envelope: EncryptedEnvelope }> = []\n      for (let i = start; i < end; i++) {\n        const k = matchedKeys[i]!\n        const raw = localStorage.getItem(k)\n        if (!raw) continue\n        const { envelope, origId } = unwrapValue(raw, obfuscate, obfKey)\n        const id = obfuscate ? origId : k.slice(pfx.length)\n        items.push({ id, envelope })\n      }\n\n      return {\n        items,\n        nextCursor: end < matchedKeys.length ? String(end) : null,\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@noy-db/to-browser-local",
+  "version": "0.1.0-pre.3",
+  "description": "localStorage adapter for noy-db with optional key obfuscation",
+  "license": "MIT",
+  "author": "vLannaAi <vicio@lanna.ai>",
+  "homepage": "https://github.com/vLannaAi/noy-db/tree/main/packages/to-browser-local#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vLannaAi/noy-db.git",
+    "directory": "packages/to-browser-local"
+  },
+  "bugs": {
+    "url": "https://github.com/vLannaAi/noy-db/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@noy-db/hub": "0.1.0-pre.3"
+  },
+  "devDependencies": {
+    "happy-dom": "^18.0.0",
+    "@noy-db/hub": "0.1.0-pre.3",
+    "@noy-db/test-adapter-conformance": "0.0.0"
+  },
+  "keywords": [
+    "noy-db",
+    "adapter",
+    "browser",
+    "localstorage",
+    "web",
+    "offline-first",
+    "encryption",
+    "zero-knowledge",
+    "obfuscation"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  }
+}