offdex 2.0.0 → 3.0.0

package/README.md

@@ -1,68 +1,120 @@
-# Offdex
-
-Keyed object storage for the browser. Offdex wraps IndexedDB with a tiny, unbiased API so you can drop in `{ key: "<string>", ...data }` objects and have them shared across tabs, workers, and sessions without thinking about schema versions.
-
-## Why use Offdex
-
-- Zero schema/versioning overhead: one object store keyed by `key`, no migrations to manage.
-- Minimal wrapper: no hooks or proxies in the storage API, just data in and data out.
-- Works everywhere IndexedDB works: tabs, workers, and other browser runtimes share the same underlying database.
-- Offline by default: IndexedDB persists across reloads and disconnects.
-- Typed surface: ships with TypeScript definitions for easy adoption.
-
-## Install
-
-```bash
-npm install offdex
-```
-
-## Quick start
-
-```js
-import { storage } from "offdex";
-
-const profile = {
-  key: "profile:ada",
-  name: "Ada Lovelace",
-  role: "analyst",
-};
-
-await storage.put(profile);
-
-const again = await storage.get(profile.key);
-// -> { key: "profile:ada", name: "Ada Lovelace", role: "analyst" }
-
-await storage.delete(profile.key);
-```
-
-## API
-
-### `storage`
-
-- Ready-to-use singleton instance shared across every import in the same origin. Uses the `offdex` database and `objects` store under the hood.
-
-### `class ObjectStore`
-
-- `constructor()` — opens (or creates) the `offdex` database with the `objects` store. Use this only if you need a separate instance.
-- `put(object: { key: string } & Record<string, unknown>): Promise<void>` - upserts an object keyed by `key`.
-- `putAll(objects: { key: string } & Record<string, unknown>[]): Promise<void>` - upserts multiple objects in a single transaction.
-- `get(key: string): Promise<{ key: string } & Record<string, unknown> | undefined>` - fetches by `key`, returning `undefined` when missing.
-- `delete(key: string): Promise<void>` - removes an object by `key`.
-- `getAllMatches(queryOrFilter: StorageQuery | (object) => boolean): Promise<object[]>` - returns objects that pass a query or predicate.
-- `deleteAllMatches(queryOrFilter: StorageQuery | (object) => boolean): Promise<void>` — deletes objects that pass a query or predicate.
-
-### Other exports
-
-- `StorageQuery` — helper for simple equality-based queries.
-- `ObservableValue` — observable wrapper around a single value.
-- `ObservableObject` — wraps an object in observable values keyed by its properties.
-
-### Types
-
-- `StoredObject` - `{ key: string } & Record<string, unknown>`.
-
-## Notes
-
-- Runs in any environment that exposes `indexedDB` (secure contexts in modern browsers).
-- Data is shared per origin; open multiple tabs or workers and you will see the same store.
-- There is no schema migration system; keep your stored objects backward compatible or manage migrations externally if you need them.
+# Offdex
+
+IndexedDB-backed object storage for browsers and workers. Store
+structured-clone JS values (objects, arrays, and primitives limited to
+msgpack-compatible types) by key, read them back directly, and share data across
+tabs and workers without schema migrations.
+
+## Why use Offdex
+
+- Simple `put/get/head/delete/list` API in browser contexts.
+- Object storage for msgpack-safe structured-clone JS values: primitives,
+  arrays, plain objects, Date, and typed arrays.
+- Single object store keyed by string; no migrations to manage.
+- Data shared per origin across tabs and workers (instance per JavaScript realm).
+- Offline persistence via IndexedDB.
+- TypeScript-first.
+- Singleton-only API: one shared `storage` instance per JavaScript realm (per thread).
+
+## Install
+
+```bash
+npm install offdex
+```
+
+## Quick start
+
+```js
+import storage from "offdex";
+
+await storage.put("profile:ada", { greeting: "hello from IndexedDB" });
+
+const object = await storage.get("profile:ada");
+if (object) {
+  console.log(object);
+}
+
+await storage.put("bytes", new Uint8Array([1, 2, 3]));
+const bytes = await storage.get("bytes");
+console.log(bytes instanceof Uint8Array, bytes);
+```
+
+## API
+
+### `storage` (default export)
+
+Singleton storage instance per JavaScript realm backed by the `offdex` database
+and `blobs` object store. The underlying store is shared per origin across tabs
+and workers.
+
+### Methods
+
+- `put(key, value, options?)` -> `Promise<void>`
+- `get(key, options?)` -> `Promise<unknown | null>`
+- `head(key)` -> `Promise<boolean>`
+- `delete(key)` -> `Promise<void>`
+- `list(options?)` -> `Promise<{ objects: { key: string }[] }>`
+
+### Value requirements (msgpack-compatible)
+
+- `value` must be a structured-clone JS value encodable by `@msgpack/msgpack`
+  with default options.
+- Allowed: `null`/`undefined`, booleans, numbers, strings, arrays, plain
+  objects, `Date`, and `ArrayBufferView` (typed arrays/DataView).
+- Not allowed: `BigInt`, `Map`, `Set`, `RegExp`, `Error`, `Blob`/`File`,
+  `ArrayBuffer`, functions, symbols, or circular references.
+- `put` throws a `TypeError` if a value is not msgpack-compatible.
+- MessagePack note: `undefined` decodes as `null`, and binary decodes as
+  `Uint8Array`.
+
+## Compatibility notes
+
+- Method names mirror Cloudflare R2 (`put/get/head/delete/list`), but return
+  values are simplified for direct value access.
+- Offdex does not use MessagePack internally; it just validates compatibility.
+- `options` arguments are accepted for signature compatibility but not used.
+- `list` currently returns all keys; prefix/limit/cursor options are ignored.
+
+## Build
+
+```bash
+npm run build
+```
+
+## Tests
+
+```bash
+npx playwright install
+npm test
+```
+
+Playwright runs Chromium, Firefox, WebKit, plus mobile emulation projects.
+
+## Benchmarks
+
+```bash
+npx playwright install
+npm run bench
+```
+
+The benchmark runs in Chromium via Playwright and times a batch of msgpack-safe
+`put/head/get/list/delete` operations.
+
+```text
+[bench] put 200 items: 148.6ms
+[bench] head 200 items: 101.6ms
+[bench] get 200 items: 100.3ms
+[bench] list 200 items: 2.7ms
+[bench] delete 200 items: 123.8ms
+```
+
+## Manual browser check
+
+- Run `npm run build`, open `in-browser-testing.html`, then use `storage` from
+  the console with msgpack-compatible structured-clone values.
+
+## Notes
+
+- Requires `indexedDB` (modern browsers / worker runtimes).
+- Data is scoped per origin; all tabs/workers on the same origin share the same
+  store.

package/dist/BlobStorage/class.d.ts

@@ -0,0 +1,10 @@
+import type { R2GetOptions, R2ListOptions, R2Objects, R2PutOptions } from "@cloudflare/workers-types";
+export declare class BlobStorage {
+    #private;
+    put: (key: string, value: unknown, _options?: R2PutOptions) => Promise<void>;
+    head: (key: string) => Promise<boolean>;
+    get: (key: string, _options?: R2GetOptions) => Promise<unknown | null>;
+    delete: (key: string) => Promise<void>;
+    list: (_options?: R2ListOptions) => Promise<R2Objects>;
+}
+//# sourceMappingURL=class.d.ts.map

package/dist/BlobStorage/class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../src/BlobStorage/class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACb,MAAM,2BAA2B,CAAC;AAInC,qBAAa,WAAW;;IAgItB,GAAG,GACD,KAAK,MAAM,EACX,OAAO,OAAO,EACd,WAAW,YAAY,KACtB,OAAO,CAAC,IAAI,CAAC,CAwBd;IAEF,IAAI,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC,CAc1C;IAEF,GAAG,GACD,KAAK,MAAM,EACX,WAAW,YAAY,KACtB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAcxB;IAEF,MAAM,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CASzC;IAEF,IAAI,GAAU,WAAW,aAAa,KAAG,OAAO,CAAC,SAAS,CAAC,CAiBzD;CACH"}

package/dist/BlobStorage/class.js

@@ -0,0 +1,169 @@
+var _a;
+export class BlobStorage {
+    static #dbName = "offdex";
+    static #storeName = "blobs";
+    #dbPromise = _a.#open();
+    static #open() {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(_a.#dbName, 1);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(_a.#storeName)) {
+                    db.createObjectStore(_a.#storeName, { keyPath: "key" });
+                }
+            };
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    static #throwMsgpackError(path, reason) {
+        throw new TypeError(`{offdex} BlobStorage.put: value at ${path} is not msgpack-compatible (${reason})`);
+    }
+    static #assertMsgpackCompatible(value, path, seen) {
+        if (value === null || value === undefined)
+            return;
+        const valueType = typeof value;
+        if (valueType === "string" ||
+            valueType === "boolean" ||
+            valueType === "number")
+            return;
+        if (valueType === "bigint") {
+            _a.#throwMsgpackError(path, "bigint is not supported without custom msgpack options");
+        }
+        if (valueType === "symbol") {
+            _a.#throwMsgpackError(path, "symbol values are not supported");
+        }
+        if (valueType === "function") {
+            _a.#throwMsgpackError(path, "functions are not supported");
+        }
+        if (value instanceof Date)
+            return;
+        if (ArrayBuffer.isView(value))
+            return;
+        if (value instanceof ArrayBuffer) {
+            _a.#throwMsgpackError(path, "ArrayBuffer is not supported; use Uint8Array instead");
+        }
+        if (typeof Blob === "function" && value instanceof Blob) {
+            _a.#throwMsgpackError(path, "Blob/File values are not supported; use Uint8Array instead");
+        }
+        if (typeof File === "function" && value instanceof File) {
+            _a.#throwMsgpackError(path, "Blob/File values are not supported; use Uint8Array instead");
+        }
+        if (value instanceof Map) {
+            _a.#throwMsgpackError(path, "Map is not supported");
+        }
+        if (value instanceof Set) {
+            _a.#throwMsgpackError(path, "Set is not supported");
+        }
+        if (value instanceof RegExp) {
+            _a.#throwMsgpackError(path, "RegExp is not supported");
+        }
+        if (value instanceof Error) {
+            _a.#throwMsgpackError(path, "Error is not supported");
+        }
+        if (Array.isArray(value)) {
+            if (seen.has(value)) {
+                _a.#throwMsgpackError(path, "circular references are not supported");
+            }
+            seen.add(value);
+            for (let index = 0; index < value.length; index += 1) {
+                _a.#assertMsgpackCompatible(value[index], `${path}[${index}]`, seen);
+            }
+            seen.delete(value);
+            return;
+        }
+        if (value && typeof value === "object") {
+            const proto = Object.getPrototypeOf(value);
+            if (proto !== Object.prototype && proto !== null) {
+                _a.#throwMsgpackError(path, "only plain objects are supported");
+            }
+            if (Object.getOwnPropertySymbols(value).length > 0) {
+                _a.#throwMsgpackError(path, "symbol keys are not supported");
+            }
+            if (seen.has(value)) {
+                _a.#throwMsgpackError(path, "circular references are not supported");
+            }
+            seen.add(value);
+            for (const [key, entry] of Object.entries(value)) {
+                _a.#assertMsgpackCompatible(entry, `${path}.${key}`, seen);
+            }
+            seen.delete(value);
+            return;
+        }
+        _a.#throwMsgpackError(path, "unsupported value type");
+    }
+    put = async (key, value, _options) => {
+        _a.#assertMsgpackCompatible(value, "$", new WeakSet());
+        const db = await this.#dbPromise;
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readwrite");
+            try {
+                tx.objectStore(_a.#storeName).put({
+                    key: String(key),
+                    value,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                reject(new TypeError(`{offdex} BlobStorage.put: value must be structured-cloneable (${message})`));
+                return;
+            }
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+    };
+    head = async (key) => {
+        const db = await this.#dbPromise;
+        const exists = await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readonly");
+            const store = tx.objectStore(_a.#storeName);
+            const req = typeof store.getKey === "function" ? store.getKey(key) : store.get(key);
+            tx.oncomplete = () => resolve(req.result !== undefined);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+        return exists;
+    };
+    get = async (key, _options) => {
+        const db = await this.#dbPromise;
+        const row = await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readonly");
+            const req = tx.objectStore(_a.#storeName).get(key);
+            tx.oncomplete = () => resolve(req.result);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+        if (!row)
+            return null;
+        return row.value;
+    };
+    delete = async (key) => {
+        const db = await this.#dbPromise;
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readwrite");
+            tx.objectStore(_a.#storeName).delete(key);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+    };
+    list = async (_options) => {
+        const db = await this.#dbPromise;
+        const keys = await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readonly");
+            const req = tx.objectStore(_a.#storeName).getAllKeys();
+            tx.oncomplete = () => resolve(req.result);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+        return {
+            objects: keys.map((key) => ({ key })),
+            truncated: false,
+            delimitedPrefixes: [],
+            cursor: undefined,
+        };
+    };
+}
+_a = BlobStorage;
+//# sourceMappingURL=class.js.map

package/dist/BlobStorage/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../src/BlobStorage/class.ts"],"names":[],"mappings":"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"}

package/dist/ObjectStorage/class.d.ts

@@ -0,0 +1,10 @@
+import type { R2GetOptions, R2ListOptions, R2Objects, R2PutOptions } from "@cloudflare/workers-types";
+export declare class ObjectStorage {
+    #private;
+    put: (key: string, value: unknown, _options?: R2PutOptions) => Promise<void>;
+    head: (key: string) => Promise<boolean>;
+    get: (key: string, _options?: R2GetOptions) => Promise<unknown | null>;
+    delete: (key: string) => Promise<void>;
+    list: (_options?: R2ListOptions) => Promise<R2Objects>;
+}
+//# sourceMappingURL=class.d.ts.map

package/dist/ObjectStorage/class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../src/ObjectStorage/class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACb,MAAM,2BAA2B,CAAC;AAInC,qBAAa,aAAa;;IAsIxB,GAAG,GACD,KAAK,MAAM,EACX,OAAO,OAAO,EACd,WAAW,YAAY,KACtB,OAAO,CAAC,IAAI,CAAC,CAwBd;IAEF,IAAI,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC,CAc1C;IAEF,GAAG,GACD,KAAK,MAAM,EACX,WAAW,YAAY,KACtB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAcxB;IAEF,MAAM,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CASzC;IAEF,IAAI,GAAU,WAAW,aAAa,KAAG,OAAO,CAAC,SAAS,CAAC,CAiBzD;CACH"}

package/dist/ObjectStorage/class.js

@@ -0,0 +1,169 @@
+var _a;
+export class ObjectStorage {
+    static #dbName = "offdex";
+    static #storeName = "blobs";
+    #dbPromise = _a.#open();
+    static #open() {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(_a.#dbName, 1);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(_a.#storeName)) {
+                    db.createObjectStore(_a.#storeName, { keyPath: "key" });
+                }
+            };
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    static #throwMsgpackError(path, reason) {
+        throw new TypeError(`{offdex} ObjectStorage.put: value at ${path} is not msgpack-compatible (${reason})`);
+    }
+    static #assertMsgpackCompatible(value, path, seen) {
+        if (value === null || value === undefined)
+            return;
+        const valueType = typeof value;
+        if (valueType === "string" ||
+            valueType === "boolean" ||
+            valueType === "number")
+            return;
+        if (valueType === "bigint") {
+            _a.#throwMsgpackError(path, "bigint is not supported without custom msgpack options");
+        }
+        if (valueType === "symbol") {
+            _a.#throwMsgpackError(path, "symbol values are not supported");
+        }
+        if (valueType === "function") {
+            _a.#throwMsgpackError(path, "functions are not supported");
+        }
+        if (value instanceof Date)
+            return;
+        if (ArrayBuffer.isView(value))
+            return;
+        if (value instanceof ArrayBuffer) {
+            _a.#throwMsgpackError(path, "ArrayBuffer is not supported; use Uint8Array instead");
+        }
+        if (typeof Blob === "function" && value instanceof Blob) {
+            _a.#throwMsgpackError(path, "Blob/File values are not supported; use Uint8Array instead");
+        }
+        if (typeof File === "function" && value instanceof File) {
+            _a.#throwMsgpackError(path, "Blob/File values are not supported; use Uint8Array instead");
+        }
+        if (value instanceof Map) {
+            _a.#throwMsgpackError(path, "Map is not supported");
+        }
+        if (value instanceof Set) {
+            _a.#throwMsgpackError(path, "Set is not supported");
+        }
+        if (value instanceof RegExp) {
+            _a.#throwMsgpackError(path, "RegExp is not supported");
+        }
+        if (value instanceof Error) {
+            _a.#throwMsgpackError(path, "Error is not supported");
+        }
+        if (Array.isArray(value)) {
+            if (seen.has(value)) {
+                _a.#throwMsgpackError(path, "circular references are not supported");
+            }
+            seen.add(value);
+            for (let index = 0; index < value.length; index += 1) {
+                _a.#assertMsgpackCompatible(value[index], `${path}[${index}]`, seen);
+            }
+            seen.delete(value);
+            return;
+        }
+        if (value && typeof value === "object") {
+            const proto = Object.getPrototypeOf(value);
+            if (proto !== Object.prototype && proto !== null) {
+                _a.#throwMsgpackError(path, "only plain objects are supported");
+            }
+            if (Object.getOwnPropertySymbols(value).length > 0) {
+                _a.#throwMsgpackError(path, "symbol keys are not supported");
+            }
+            if (seen.has(value)) {
+                _a.#throwMsgpackError(path, "circular references are not supported");
+            }
+            seen.add(value);
+            for (const [key, entry] of Object.entries(value)) {
+                _a.#assertMsgpackCompatible(entry, `${path}.${key}`, seen);
+            }
+            seen.delete(value);
+            return;
+        }
+        _a.#throwMsgpackError(path, "unsupported value type");
+    }
+    put = async (key, value, _options) => {
+        _a.#assertMsgpackCompatible(value, "$", new WeakSet());
+        const db = await this.#dbPromise;
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readwrite");
+            try {
+                tx.objectStore(_a.#storeName).put({
+                    key: String(key),
+                    value,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                reject(new TypeError(`{offdex} ObjectStorage.put: value must be structured-cloneable (${message})`));
+                return;
+            }
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+    };
+    head = async (key) => {
+        const db = await this.#dbPromise;
+        const exists = await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readonly");
+            const store = tx.objectStore(_a.#storeName);
+            const req = typeof store.getKey === "function" ? store.getKey(key) : store.get(key);
+            tx.oncomplete = () => resolve(req.result !== undefined);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+        return exists;
+    };
+    get = async (key, _options) => {
+        const db = await this.#dbPromise;
+        const row = await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readonly");
+            const req = tx.objectStore(_a.#storeName).get(key);
+            tx.oncomplete = () => resolve(req.result);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+        if (!row)
+            return null;
+        return row.value;
+    };
+    delete = async (key) => {
+        const db = await this.#dbPromise;
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readwrite");
+            tx.objectStore(_a.#storeName).delete(key);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+    };
+    list = async (_options) => {
+        const db = await this.#dbPromise;
+        const keys = await new Promise((resolve, reject) => {
+            const tx = db.transaction(_a.#storeName, "readonly");
+            const req = tx.objectStore(_a.#storeName).getAllKeys();
+            tx.oncomplete = () => resolve(req.result);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+        return {
+            objects: keys.map((key) => ({ key })),
+            truncated: false,
+            delimitedPrefixes: [],
+            cursor: undefined,
+        };
+    };
+}
+_a = ObjectStorage;
+//# sourceMappingURL=class.js.map

package/dist/ObjectStorage/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../src/ObjectStorage/class.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { ObjectStorage } from "./ObjectStorage/class.js";
+declare const _default: ObjectStorage;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;;AAEzD,wBAAmC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import { ObjectStorage } from "./ObjectStorage/class.js";
+export default new ObjectStorage();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,eAAe,IAAI,aAAa,EAAE,CAAC"}

package/package.json

@@ -1,26 +1,27 @@
 {
   "name": "offdex",
-  "version": "2.0.0",
-  "description": "Minimal, unbiased IndexedDB object-store wrapper keyed by a string. Shared across browser threads, offline-persistent, simple API.",
+  "version": "3.0.0",
+  "description": "IndexedDB-backed object storage for structured-clone JS values (msgpack-compatible) in browsers and workers.",
   "keywords": [
     "indexeddb",
-    "offline",
+    "structured-clone",
+    "msgpack",
+    "binary",
+    "object",
     "storage",
     "browser-storage",
     "web-storage",
-    "object-store",
-    "key-value",
-    "key",
-    "persist",
-    "threads",
-    "workers",
-    "shared",
-    "minimal"
+    "r2",
+    "cloudflare",
+    "bucket",
+    "offline",
+    "worker",
+    "persist"
   ],
   "license": "MIT",
   "type": "module",
-  "main": "src/index.js",
-  "types": "src/index.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jortsupetterson/offdex.git"
@@ -31,15 +32,28 @@
   "homepage": "https://github.com/jortsupetterson/offdex#readme",
   "exports": {
     ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
-    "src",
+    "dist",
     "LICENSE",
     "README.md"
   ],
-  "sideEffects": false
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "npm run build && playwright test",
+    "bench": "npm run build && playwright test -c playwright.bench.config.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@cloudflare/workers-types": "^4.20260101.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.57.0",
+    "typescript": "^5.9.3"
+  }
 }

package/src/ObjectStore/index.js

@@ -1,184 +0,0 @@
-export class ObjectStore {
-  static #idb = "offdex";
-  static #store = "objects";
-
-  /**
-   * @returns {Promise<IDBDatabase>}
-   */
-  static #open() {
-    return new Promise((resolve, reject) => {
-      const request = indexedDB.open(ObjectStore.#idb);
-
-      request.addEventListener("upgradeneeded", () => {
-        const db = request.result;
-        if (!db.objectStoreNames.contains(ObjectStore.#store)) {
-          db.createObjectStore(ObjectStore.#store, { keyPath: "key" });
-        }
-      });
-
-      request.addEventListener("success", () => {
-        resolve(request.result);
-      });
-
-      request.addEventListener("error", () => {
-        reject(request.error);
-      });
-    });
-  }
-
-  constructor() {
-    this.instance = ObjectStore.#open();
-  }
-
-  /**
-   * @param {import("../types").StoredObject} object
-   * @returns {Promise<void>}
-   */
-  async put(object) {
-    const db = await this.instance;
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(ObjectStore.#store, "readwrite");
-      const store = transaction.objectStore(ObjectStore.#store);
-      store.put(object);
-
-      transaction.oncomplete = () => resolve();
-      transaction.onerror = () =>
-        reject(new Error(`{offdex} ObjectStore: ${transaction.error}`));
-    });
-  }
-
-  /**
-   * @param {string} key
-   * @returns {Promise<import("../types").StoredObject | undefined>}
-   */
-  async get(key) {
-    const db = await this.instance;
-
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(ObjectStore.#store, "readonly");
-      const store = transaction.objectStore(ObjectStore.#store);
-      const request = store.get(key);
-
-      transaction.oncomplete = () => {
-        if (!request.result) {
-          resolve(undefined);
-          return;
-        }
-
-        resolve(request.result);
-      };
-
-      transaction.onerror = () =>
-        reject(new Error(`{offdex} ObjectStore: ${transaction.error}`));
-    });
-  }
-
-  /**
-   * @param {string} key
-   * @returns {Promise<void>}
-   */
-  async delete(key) {
-    const db = await this.instance;
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(ObjectStore.#store, "readwrite");
-      const store = transaction.objectStore(ObjectStore.#store);
-      store.delete(key);
-      transaction.oncomplete = () => resolve();
-      transaction.onerror = () =>
-        reject(new Error(`{offdex} ObjectStore: ${transaction.error}`));
-    });
-  }
-
-  /**
-   * @param {import("../types").StoredObject[]} objects
-   * @returns {Promise<void>}
-   */
-  async putAll(objects) {
-    const db = await this.instance;
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(ObjectStore.#store, "readwrite");
-      const store = transaction.objectStore(ObjectStore.#store);
-
-      for (const object of objects) {
-        store.put(object);
-      }
-
-      transaction.oncomplete = () => resolve();
-      transaction.onerror = () =>
-        reject(new Error(`{offdex} ObjectStore.putAll: ${transaction.error}`));
-    });
-  }
-
-  /**
-   * @param {import("../StorageQuery/index.js").StorageQuery | ((object: import("../types").StoredObject) => boolean)} queryOrPredicate
-   * @returns {Promise<import("../types").StoredObject[]>}
-   */
-  async getAllMatches(queryOrPredicate) {
-    const db = await this.instance;
-    const objectStoreInstance = this;
-
-    const predicate =
-      typeof queryOrPredicate === "function"
-        ? queryOrPredicate
-        : (object) => queryOrPredicate.matches(object);
-
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(ObjectStore.#store, "readonly");
-      const store = transaction.objectStore(ObjectStore.#store);
-      const request = store.openCursor();
-
-      const results = [];
-
-      request.onsuccess = () => {
-        const cursor = request.result;
-        if (!cursor) return;
-
-        const value = cursor.value;
-
-        if (predicate(value)) {
-          results.push(value);
-        }
-
-        cursor.continue();
-      };
-
-      transaction.oncomplete = () => resolve(results);
-      transaction.onerror = () =>
-        reject(new Error(`{offdex} ObjectStore: ${transaction.error}`));
-    });
-  }
-
-  /**
-   * @param {import("../StorageQuery/index.js").StorageQuery | ((object: import("../types").StoredObject) => boolean)} queryOrPredicate
-   * @returns {Promise<void>}
-   */
-  async deleteAllMatches(queryOrPredicate) {
-    const db = await this.instance;
-
-    const predicate =
-      typeof queryOrPredicate === "function"
-        ? queryOrPredicate
-        : (object) => queryOrPredicate.matches(object);
-
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(ObjectStore.#store, "readwrite");
-      const store = transaction.objectStore(ObjectStore.#store);
-      const request = store.openCursor();
-
-      request.onsuccess = () => {
-        const cursor = request.result;
-        if (!cursor) return;
-
-        if (predicate(cursor.value)) {
-          cursor.delete();
-        }
-
-        cursor.continue();
-      };
-
-      transaction.oncomplete = () => resolve();
-      transaction.onerror = () =>
-        reject(new Error(`{offdex} ObjectStore: ${transaction.error}`));
-    });
-  }
-}

package/src/ObservableObject/index.js

@@ -1,12 +0,0 @@
-import { ObservableValue } from "../ObservableValue/index.js";
-
-export class ObservableObject {
-  /**
-   * @param {import("../types").StoredObject} object
-   */
-  constructor(object) {
-    for (const key in object) {
-      this[key] = new ObservableValue(object[key]);
-    }
-  }
-}

package/src/ObservableValue/index.js

@@ -1,58 +0,0 @@
-export class ObservableValue {
-  /**
-   * @param {any} value
-   * @param {any} [fallback]
-   */
-  constructor(value, fallback = null) {
-    this.value = value;
-    this.fallback = fallback;
-    /** @type {Set<{ event: "set" | "reset"; callback: (value: any) => void }>} */
-    this.observers = new Set();
-  }
-  get() {
-    return this.value;
-  }
-  /**
-   * @param {any} newValue
-   * @returns {void}
-   */
-  set(newValue) {
-    if (newValue === this.value) return;
-    this.value = newValue;
-    const changeObservers = [...this.observers].filter(
-      (observer) => observer.event === "set"
-    );
-    for (const observer of changeObservers) {
-      observer.callback(newValue);
-    }
-  }
-  reset() {
-    this.value = this.fallback;
-    const resetObservers = [...this.observers].filter(
-      (observer) => observer.event === "reset"
-    );
-    for (const observer of resetObservers) {
-      observer.callback(this.fallback);
-    }
-  }
-  /**
-   * @param {"set" | "reset"} event
-   * @param {Function} callback
-   * @returns {() => void}
-   */
-  observe(event, callback) {
-    if (event !== "set" && event !== "reset")
-      throw new Error(
-        "{offdex} ObservableValue: Supported `event` parameters are [set, reset]"
-      );
-    if (typeof callback !== "function")
-      throw new Error(
-        "{offdex} ObservableValue: Paramater `callback` must be of type function"
-      );
-    const observer = { event, callback };
-    this.observers.add(observer);
-    return () => {
-      this.observers.delete(observer);
-    };
-  }
-}

package/src/StorageQuery/index.js

@@ -1,12 +0,0 @@
-export class StorageQuery {
-  constructor(args = {}) {
-    this.args = args;
-  }
-
-  matches(object) {
-    for (const key in this.args) {
-      if (object[key] !== this.args[key]) return false;
-    }
-    return true;
-  }
-}

package/src/index.d.ts

@@ -1,36 +0,0 @@
-export type StoredObject = { key: string } & Record<string, unknown>;
-
-export class StorageQuery {
-  constructor(args?: Record<string, unknown>);
-  args: Record<string, unknown>;
-  matches(object: StoredObject): boolean;
-}
-
-export class ObservableValue<T = unknown> {
-  constructor(value: T, fallback?: T);
-  get(): T;
-  set(newValue: T): void;
-  reset(): void;
-  observe(event: "set" | "reset", callback: (value: T) => void): () => void;
-}
-
-export class ObservableObject<T extends StoredObject = StoredObject> {
-  constructor(object: T);
-  [key: string]: ObservableValue<unknown>;
-}
-
-export class ObjectStore {
-  constructor();
-  put(object: StoredObject): Promise<void>;
-  get(key: string): Promise<StoredObject | undefined>;
-  delete(key: string): Promise<void>;
-  putAll(objects: StoredObject[]): Promise<void>;
-  getAllMatches(
-    queryOrFilter: StorageQuery | ((object: StoredObject) => boolean)
-  ): Promise<StoredObject[]>;
-  deleteAllMatches(
-    queryOrFilter: StorageQuery | ((object: StoredObject) => boolean)
-  ): Promise<void>;
-}
-
-export const storage: ObjectStore;

package/src/index.js

@@ -1,7 +0,0 @@
-import { ObjectStore } from "./ObjectStore/index.js";
-import { StorageQuery } from "./StorageQuery/index.js";
-import { ObservableValue } from "./ObservableValue/index.js";
-import { ObservableObject } from "./ObservableObject/index.js";
-
-export { ObjectStore, StorageQuery, ObservableValue, ObservableObject };
-export const storage = new ObjectStore();

package/src/types.d.ts

@@ -1 +0,0 @@
-export type StoredObject = { key: string } & Record<string, unknown>;