offdex 1.0.6 → 1.0.7

package/README.md

@@ -3,24 +3,27 @@
 ID-first object storage for the browser. Offdex wraps IndexedDB with a tiny, stable API so you can drop in `{ id: <uuid>, ...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 `id`, no migrations to manage.
 - 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 = {
   id: crypto.randomUUID(), // UUIDv4 string
   name: "Ada Lovelace",
-  role: "analyst"
+  role: "analyst",
 };
 
 await storage.put(profile);
@@ -32,10 +35,13 @@ await storage.delete(profile.id);
 ```
 
 ## 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: { id: UUIDv4 } & Record<string, unknown>): Promise<void>` — upserts an object keyed by `id`.
 - `get(id: UUIDv4, onSet?, onDelete?): Promise<{ id: UUIDv4 } & Record<string, unknown> | undefined>` — fetches by `id`, returning `undefined` when missing. Optional callbacks run before a property change/delete; return `false` to block the change.
@@ -44,16 +50,19 @@ await storage.delete(profile.id);
 - `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
+
 - `UUIDv4` — template literal type for UUID strings.
 - `StoredObject` — `{ id: UUIDv4 } & Record<string, unknown>`.
 - `OnSetHandler`, `OnDeleteHandler` — callback shapes used by `get`/`getAllMatches`.
 
 ## 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "offdex",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "ID-driven object storage wrapper for IndexedDB with zero schema/versioning overhead. Shared across all browser threads, offline-persistent, large capacity, simple API.",
   "keywords": [
     "indexeddb",

package/src/ObjectStore/index.js

@@ -117,6 +117,26 @@ export class ObjectStore {
     });
   }
 
+  /**
+   * @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
    * @param {(propertyName: string, oldValue: any, newValue: any) => void | boolean} [onSetEvent]