@moltendb-web/query 1.0.0-rc.1 → 1.0.0-rc.4

package/README.md

@@ -1,12 +1,12 @@
 # @moltendb-web/query
 
-Type-safe, chainable query builder for [MoltenDB](https://github.com/maximilian27/MoltenDB).
+Type-safe, chainable query builder for [MoltenDb](https://github.com/maximilian27/MoltenDb).
 
 Works in vanilla JavaScript and TypeScript. Compiles as an npm module (CJS + ESM + `.d.ts`).
 
 ### 🌋 Explore the Full Functionality
 
-The best way to experience the MoltenDB query builder is through our **[Interactive Demo on StackBlitz](https://stackblitz.com/~/github.com/maximilian27/moltendb-wasm-demo?file=package.json)**. It contains a complete, live environment where you can test query builder expressions, perform mutations, and see real-time events without any local setup.
+The best way to experience the MoltenDb query builder is through our **[Interactive Demo on StackBlitz](https://stackblitz.com/~/github.com/maximilian27/moltendb-wasm-demo?file=package.json)**. It contains a complete, live environment where you can test query builder expressions, perform mutations, and see real-time events without any local setup.
 
 ---
 
@@ -21,15 +21,15 @@ npm install @moltendb-web/query
 ## Quick start
 
 ```ts
-import { MoltenDB } from '@moltendb-web/core';
-import { MoltenDBClient, WorkerTransport } from '@moltendb-web/query';
+import { MoltenDb } from '@moltendb-web/core';
+import { MoltenDbClient, WorkerTransport } from '@moltendb-web/query';
 
 // 1. Initialize the Core Engine (boots WASM worker)
-const db = new MoltenDB('moltendb_demo');
+const db = new MoltenDb('moltendb_demo');
 await db.init();
 
 // 2. Connect the Query Builder to the worker
-const client = new MoltenDBClient(db);
+const client = new MoltenDbClient(db);
 
 // SET — insert / upsert
 await client.collection('laptops')
@@ -196,7 +196,7 @@ await client.collection('laptops')
 Implement `MoltenTransport` to connect to any backend:
 
 ```ts
-import { MoltenTransport, MoltenDBClient, Document, JsonValue } from '@moltendb-web/query';
+import { MoltenTransport, MoltenDbClient, Document, JsonValue } from '@moltendb-web/query';
 
 class FetchTransport implements MoltenTransport {
   constructor(private baseUrl: string, private token: string) {}
@@ -214,7 +214,7 @@ class FetchTransport implements MoltenTransport {
   }
 }
 
-const db = new MoltenDBClient(new FetchTransport('[https://api.mydomain.com](https://api.mydomain.com)', myToken));
+const db = new MoltenDbClient(new FetchTransport('[https://api.mydomain.com](https://api.mydomain.com)', myToken));
 ```
 
 ---

package/dist/index.d.ts

@@ -2,7 +2,7 @@
 export type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
-/** A document stored in MoltenDB — any object with string keys. */
+/** A document stored in MoltenDb — any object with string keys. */
 export type Document = {
     [key: string]: JsonValue;
 };
@@ -54,7 +54,7 @@ export type ExtendsMap = {
     [alias: string]: string;
 };
 /**
- * The transport layer used by MoltenDBClient to send messages.
+ * The transport layer used by MoltenDbClient to send messages.
  * Implement this interface to connect the query builder to any backend:
  *   - A Web Worker (WASM in-browser)
  *   - A fetch-based HTTP client
@@ -269,7 +269,7 @@ export declare class DeleteQuery {
 }
 /**
  * A handle to a specific collection.
- * Returned by `MoltenDBClient.collection(name)`.
+ * Returned by `MoltenDbClient.collection(name)`.
  * Use it to start any of the four operation builders.
  */
 export declare class CollectionHandle {
@@ -313,17 +313,17 @@ export declare class CollectionHandle {
     delete(): DeleteQuery;
 }
 /**
- * The main entry point for the MoltenDB query builder.
+ * The main entry point for the MoltenDb query builder.
  *
  * Accepts any {@link MoltenTransport} implementation — use {@link WorkerTransport}
- * to connect to a MoltenDB WASM Web Worker, or provide your own transport
+ * to connect to a MoltenDb WASM Web Worker, or provide your own transport
  * for HTTP, WebSocket, or testing.
  *
  * @example
  * // Browser + WASM Web Worker
  * const worker = new Worker('./moltendb-worker.js', { type: 'module' });
  * const transport = new WorkerTransport(worker);
- * const db = new MoltenDBClient(transport);
+ * const db = new MoltenDbClient(transport);
  *
  * const results = await db.collection('laptops')
  *   .get()
@@ -332,7 +332,7 @@ export declare class CollectionHandle {
  *   .count(5)
  *   .exec();
  */
-export declare class MoltenDBClient {
+export declare class MoltenDbClient {
     private transport;
     constructor(transport: MoltenTransport);
     /**

package/dist/index.esm.js

@@ -1,5 +1,5 @@
-// ─── MoltenDB Query Builder ───────────────────────────────────────────────────
-// Chainable, type-safe query builder for MoltenDB.
+// ─── MoltenDb Query Builder ───────────────────────────────────────────────────
+// Chainable, type-safe query builder for MoltenDb.
 //
 // Each operation has its own builder class that only exposes the methods
 // that are valid for that operation — matching the server's allowed-property
@@ -13,7 +13,7 @@
 //
 // Usage (vanilla JS or TypeScript):
 //
-//   const db = new MoltenDBClient(worker);
+//   const db = new MoltenDbClient(worker);
 //
 //   // GET — chainable query
 //   const results = await db.collection('laptops')
@@ -326,7 +326,7 @@ export { DeleteQuery as DeleteQuery };
 // ─── CollectionHandle ─────────────────────────────────────────────────────────
 /**
  * A handle to a specific collection.
- * Returned by `MoltenDBClient.collection(name)`.
+ * Returned by `MoltenDbClient.collection(name)`.
  * Use it to start any of the four operation builders.
  */
 class CollectionHandle {
@@ -379,19 +379,19 @@ class CollectionHandle {
     }
 }
 export { CollectionHandle as CollectionHandle };
-// ─── MoltenDBClient ───────────────────────────────────────────────────────────
+// ─── MoltenDbClient ───────────────────────────────────────────────────────────
 /**
- * The main entry point for the MoltenDB query builder.
+ * The main entry point for the MoltenDb query builder.
  *
  * Accepts any {@link MoltenTransport} implementation — use {@link WorkerTransport}
- * to connect to a MoltenDB WASM Web Worker, or provide your own transport
+ * to connect to a MoltenDb WASM Web Worker, or provide your own transport
  * for HTTP, WebSocket, or testing.
  *
  * @example
  * // Browser + WASM Web Worker
  * const worker = new Worker('./moltendb-worker.js', { type: 'module' });
  * const transport = new WorkerTransport(worker);
- * const db = new MoltenDBClient(transport);
+ * const db = new MoltenDbClient(transport);
  *
  * const results = await db.collection('laptops')
  *   .get()
@@ -400,7 +400,7 @@ export { CollectionHandle as CollectionHandle };
  *   .count(5)
  *   .exec();
  */
-class MoltenDBClient {
+class MoltenDbClient {
     constructor(transport) {
         this.transport = transport;
     }
@@ -414,5 +414,5 @@ class MoltenDBClient {
         return new CollectionHandle(this.transport, name);
     }
 }
-export { MoltenDBClient as MoltenDBClient };
+export { MoltenDbClient as MoltenDbClient };
 //# sourceMappingURL=index.js.map

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
-// ─── MoltenDB Query Builder ───────────────────────────────────────────────────
-// Chainable, type-safe query builder for MoltenDB.
+// ─── MoltenDb Query Builder ───────────────────────────────────────────────────
+// Chainable, type-safe query builder for MoltenDb.
 //
 // Each operation has its own builder class that only exposes the methods
 // that are valid for that operation — matching the server's allowed-property
@@ -14,7 +14,7 @@
 //
 // Usage (vanilla JS or TypeScript):
 //
-//   const db = new MoltenDBClient(worker);
+//   const db = new MoltenDbClient(worker);
 //
 //   // GET — chainable query
 //   const results = await db.collection('laptops')
@@ -41,7 +41,7 @@
 //   await db.collection('laptops').delete().drop().exec();
 // ─────────────────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoltenDBClient = exports.CollectionHandle = exports.DeleteQuery = exports.UpdateQuery = exports.SetQuery = exports.GetQuery = void 0;
+exports.MoltenDbClient = exports.CollectionHandle = exports.DeleteQuery = exports.UpdateQuery = exports.SetQuery = exports.GetQuery = void 0;
 // ─── GetQuery ─────────────────────────────────────────────────────────────────
 /**
  * Builder for GET (read/query) operations.
@@ -328,7 +328,7 @@ exports.DeleteQuery = DeleteQuery;
 // ─── CollectionHandle ─────────────────────────────────────────────────────────
 /**
  * A handle to a specific collection.
- * Returned by `MoltenDBClient.collection(name)`.
+ * Returned by `MoltenDbClient.collection(name)`.
  * Use it to start any of the four operation builders.
  */
 class CollectionHandle {
@@ -381,19 +381,19 @@ class CollectionHandle {
     }
 }
 exports.CollectionHandle = CollectionHandle;
-// ─── MoltenDBClient ───────────────────────────────────────────────────────────
+// ─── MoltenDbClient ───────────────────────────────────────────────────────────
 /**
- * The main entry point for the MoltenDB query builder.
+ * The main entry point for the MoltenDb query builder.
  *
  * Accepts any {@link MoltenTransport} implementation — use {@link WorkerTransport}
- * to connect to a MoltenDB WASM Web Worker, or provide your own transport
+ * to connect to a MoltenDb WASM Web Worker, or provide your own transport
  * for HTTP, WebSocket, or testing.
  *
  * @example
  * // Browser + WASM Web Worker
  * const worker = new Worker('./moltendb-worker.js', { type: 'module' });
  * const transport = new WorkerTransport(worker);
- * const db = new MoltenDBClient(transport);
+ * const db = new MoltenDbClient(transport);
  *
  * const results = await db.collection('laptops')
  *   .get()
@@ -402,7 +402,7 @@ exports.CollectionHandle = CollectionHandle;
  *   .count(5)
  *   .exec();
  */
-class MoltenDBClient {
+class MoltenDbClient {
     constructor(transport) {
         this.transport = transport;
     }
@@ -416,5 +416,5 @@ class MoltenDBClient {
         return new CollectionHandle(this.transport, name);
     }
 }
-exports.MoltenDBClient = MoltenDBClient;
+exports.MoltenDbClient = MoltenDbClient;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@moltendb-web/query",
-  "version": "1.0.0-rc.1",
-  "description": "Type-safe query builder for MoltenDB — chainable API for get, set, update and delete operations.",
+  "version": "1.0.0-rc.4",
+  "description": "Type-safe query builder for MoltenDb — chainable API for get, set, update and delete operations.",
+  "author": "Maximilian Both <maximilian.both27@outlook.com>",
   "main": "./dist/index.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
@@ -23,7 +24,8 @@
   "scripts": {
     "build": "tsc --project tsconfig.build.json && node scripts/build-esm.js",
     "typecheck": "tsc --noEmit",
-    "test": "node --experimental-vm-modules node_modules/.bin/jest"
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "prepublishOnly": "npm run build"
   },
   "keywords": ["moltendb", "database", "query-builder", "nosql", "wasm"],
   "license": "MIT",

package/src/index.ts

@@ -1,5 +1,5 @@
-// ─── MoltenDB Query Builder ───────────────────────────────────────────────────
-// Chainable, type-safe query builder for MoltenDB.
+// ─── MoltenDb Query Builder ───────────────────────────────────────────────────
+// Chainable, type-safe query builder for MoltenDb.
 //
 // Each operation has its own builder class that only exposes the methods
 // that are valid for that operation — matching the server's allowed-property
@@ -13,7 +13,7 @@
 //
 // Usage (vanilla JS or TypeScript):
 //
-//   const db = new MoltenDBClient(worker);
+//   const db = new MoltenDbClient(worker);
 //
 //   // GET — chainable query
 //   const results = await db.collection('laptops')
@@ -51,7 +51,7 @@ export type JsonValue =
   | JsonValue[]
   | { [key: string]: JsonValue };
 
-/** A document stored in MoltenDB — any object with string keys. */
+/** A document stored in MoltenDb — any object with string keys. */
 export type Document = { [key: string]: JsonValue };
 
 /** A map of document key → document body used in set/update payloads. */
@@ -114,7 +114,7 @@ export type ExtendsMap = { [alias: string]: string };
 // ── Transport interface ───────────────────────────────────────────────────────
 
 /**
- * The transport layer used by MoltenDBClient to send messages.
+ * The transport layer used by MoltenDbClient to send messages.
  * Implement this interface to connect the query builder to any backend:
  *   - A Web Worker (WASM in-browser)
  *   - A fetch-based HTTP client
@@ -447,7 +447,7 @@ export class DeleteQuery {
 
 /**
  * A handle to a specific collection.
- * Returned by `MoltenDBClient.collection(name)`.
+ * Returned by `MoltenDbClient.collection(name)`.
  * Use it to start any of the four operation builders.
  */
 export class CollectionHandle {
@@ -507,20 +507,20 @@ export class CollectionHandle {
   }
 }
 
-// ─── MoltenDBClient ───────────────────────────────────────────────────────────
+// ─── MoltenDbClient ───────────────────────────────────────────────────────────
 
 /**
- * The main entry point for the MoltenDB query builder.
+ * The main entry point for the MoltenDb query builder.
  *
  * Accepts any {@link MoltenTransport} implementation — use {@link WorkerTransport}
- * to connect to a MoltenDB WASM Web Worker, or provide your own transport
+ * to connect to a MoltenDb WASM Web Worker, or provide your own transport
  * for HTTP, WebSocket, or testing.
  *
  * @example
  * // Browser + WASM Web Worker
  * const worker = new Worker('./moltendb-worker.js', { type: 'module' });
  * const transport = new WorkerTransport(worker);
- * const db = new MoltenDBClient(transport);
+ * const db = new MoltenDbClient(transport);
  *
  * const results = await db.collection('laptops')
  *   .get()
@@ -529,7 +529,7 @@ export class CollectionHandle {
  *   .count(5)
  *   .exec();
  */
-export class MoltenDBClient {
+export class MoltenDbClient {
   private transport: MoltenTransport;
 
   constructor(transport: MoltenTransport) {

package/dist/esm/index.js

@@ -1,443 +0,0 @@
-// ─── MoltenDB Query Builder ───────────────────────────────────────────────────
-// Chainable, type-safe query builder for MoltenDB.
-//
-// Each operation has its own builder class that only exposes the methods
-// that are valid for that operation — matching the server's allowed-property
-// lists exactly:
-//
-//   GET_ALLOWED:    collection, keys, where, fields, excludedFields,
-//                   joins, sort, count, offset
-//   SET_ALLOWED:    collection, data, extends
-//   UPDATE_ALLOWED: collection, data
-//   DELETE_ALLOWED: collection, keys, drop
-//
-// Usage (vanilla JS or TypeScript):
-//
-//   const db = new MoltenDBClient(worker);
-//
-//   // GET — chainable query
-//   const results = await db.collection('laptops')
-//     .get()
-//     .where({ brand: 'Apple' })
-//     .fields(['brand', 'model', 'price'])
-//     .sort([{ field: 'price', order: 'asc' }])
-//     .count(10)
-//     .exec();
-//
-//   // SET — insert/upsert
-//   await db.collection('laptops')
-//     .set({ lp1: { brand: 'Lenovo', price: 1499 } })
-//     .exec();
-//
-//   // UPDATE — partial patch
-//   await db.collection('laptops')
-//     .update({ lp4: { price: 1749, in_stock: true } })
-//     .exec();
-//
-//   // DELETE — single key, batch, or drop
-//   await db.collection('laptops').delete().keys('lp6').exec();
-//   await db.collection('laptops').delete().keys(['lp4', 'lp5']).exec();
-//   await db.collection('laptops').delete().drop().exec();
-// ─────────────────────────────────────────────────────────────────────────────
-// ─── WorkerTransport ──────────────────────────────────────────────────────────
-/**
- * Default transport that communicates with a MoltenDB Web Worker.
- *
- * The worker must follow the moltendb-worker.js message protocol:
- *   postMessage({ id, action, ...payload })
- *   onmessage → { id, result } | { id, error }
- */
-export class WorkerTransport {
-    constructor(worker, startId = 0) {
-        this.pending = new Map();
-        this.messageId = startId;
-        this.worker = worker;
-        this.worker.addEventListener('message', (event) => {
-            const { id, result, error } = event.data;
-            const p = this.pending.get(id);
-            if (!p)
-                return;
-            this.pending.delete(id);
-            if (error)
-                p.reject(new Error(error));
-            else
-                p.resolve(result ?? null);
-        });
-    }
-    send(action, payload) {
-        return new Promise((resolve, reject) => {
-            const id = this.messageId++;
-            this.pending.set(id, { resolve, reject });
-            this.worker.postMessage({ id, action, ...payload });
-        });
-    }
-}
-// ─── GetQuery ─────────────────────────────────────────────────────────────────
-/**
- * Builder for GET (read/query) operations.
- *
- * Allowed fields: collection, keys, where, fields, excludedFields,
- *                 joins, sort, count, offset
- *
- * @example
- * const rows = await db.collection('laptops')
- *   .get()
- *   .where({ brand: 'Apple' })
- *   .fields(['brand', 'model', 'price'])
- *   .sort([{ field: 'price', order: 'asc' }])
- *   .count(5)
- *   .exec();
- */
-export class GetQuery {
-    /** @internal */
-    constructor(transport, collection) {
-        this.transport = transport;
-        this.payload = { collection };
-    }
-    /**
-     * Fetch a single document by key, or a batch of documents by key array.
-     *
-     * @param keys - A single key string or an array of key strings.
-     *
-     * @example
-     * // Single key
-     * .keys('lp2')
-     * // Batch
-     * .keys(['lp1', 'lp3', 'lp5'])
-     */
-    keys(keys) {
-        this.payload['keys'] = keys;
-        return this;
-    }
-    /**
-     * Filter documents using a WHERE clause.
-     * Multiple conditions are combined with implicit AND.
-     *
-     * Supported operators: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $contains
-     * Dot-notation is supported for nested fields.
-     *
-     * @example
-     * .where({ brand: 'Apple' })
-     * .where({ price: { $gt: 1000, $lt: 3000 } })
-     * .where({ 'specs.cpu.brand': 'Intel', in_stock: true })
-     */
-    where(clause) {
-        this.payload['where'] = clause;
-        return this;
-    }
-    /**
-     * Project the response to only the specified fields (dot-notation supported).
-     * Cannot be combined with {@link excludedFields}.
-     *
-     * @example
-     * .fields(['brand', 'model', 'specs.cpu.ghz'])
-     */
-    fields(fields) {
-        this.payload['fields'] = fields;
-        return this;
-    }
-    /**
-     * Return all fields except the specified ones.
-     * Cannot be combined with {@link fields}.
-     *
-     * @example
-     * .excludedFields(['price', 'memory_id', 'display_id'])
-     */
-    excludedFields(fields) {
-        this.payload['excludedFields'] = fields;
-        return this;
-    }
-    /**
-     * Join related documents from other collections.
-     * Each join embeds the related document under the given alias.
-     *
-     * @example
-     * .joins([
-     *   { alias: 'ram',    from: 'memory',  on: 'memory_id',  fields: ['capacity_gb', 'type'] },
-     *   { alias: 'screen', from: 'display', on: 'display_id', fields: ['refresh_hz', 'panel'] },
-     * ])
-     */
-    joins(specs) {
-        this.payload['joins'] = specs.map(({ alias, from, on, fields }) => ({
-            [alias]: fields ? { from, on, fields } : { from, on },
-        }));
-        return this;
-    }
-    /**
-     * Sort the results.
-     * Multiple specs are applied in priority order (first = primary sort key).
-     *
-     * @example
-     * .sort([{ field: 'price', order: 'asc' }])
-     * .sort([{ field: 'brand', order: 'asc' }, { field: 'price', order: 'desc' }])
-     */
-    sort(specs) {
-        this.payload['sort'] = specs;
-        return this;
-    }
-    /**
-     * Limit the number of results returned (applied after filtering and sorting).
-     *
-     * @example
-     * .count(10)
-     */
-    count(n) {
-        this.payload['count'] = n;
-        return this;
-    }
-    /**
-     * Skip the first N results (for pagination, applied after sorting).
-     *
-     * @example
-     * .offset(20).count(10)  // page 3 of 10
-     */
-    offset(n) {
-        this.payload['offset'] = n;
-        return this;
-    }
-    /**
-     * Build and return the raw JSON payload without sending it.
-     * Useful for debugging or passing to a custom transport.
-     */
-    build() {
-        return { ...this.payload };
-    }
-    /**
-     * Execute the query and return the result.
-     * Returns a single document for single-key lookups, or an array for all others.
-     */
-    exec() {
-        return this.transport.send('get', this.payload);
-    }
-}
-// ─── SetQuery ─────────────────────────────────────────────────────────────────
-/**
- * Builder for SET (insert / upsert) operations.
- *
- * Allowed fields: collection, data, extends
- *
- * @example
- * await db.collection('laptops')
- *   .set({
- *     lp1: { brand: 'Lenovo', model: 'ThinkPad X1', price: 1499 },
- *     lp2: { brand: 'Apple',  model: 'MacBook Pro', price: 3499 },
- *   })
- *   .exec();
- */
-export class SetQuery {
-    /** @internal */
-    constructor(transport, collection, data) {
-        this.transport = transport;
-        this.payload = { collection, data: data };
-    }
-    /**
-     * Embed data from other collections into each document at insert time.
-     * The referenced document is fetched once and stored as a snapshot.
-     *
-     * Format: `{ alias: "collection.key" }`
-     *
-     * @example
-     * .extends({ ram: 'memory.mem4', screen: 'display.dsp3' })
-     */
-    extends(map) {
-        // The extends map is applied to every document in data.
-        // We store it at the top level; the server resolves it per-document.
-        const data = this.payload['data'];
-        if (Array.isArray(data)) {
-            // Array format — inject extends into each item
-            this.payload['data'] = data.map((doc) => ({
-                ...doc,
-                extends: map,
-            }));
-        }
-        else if (data && typeof data === 'object') {
-            // Object format — inject extends into each document value
-            const updated = {};
-            for (const [key, doc] of Object.entries(data)) {
-                updated[key] = { ...doc, extends: map };
-            }
-            this.payload['data'] = updated;
-        }
-        return this;
-    }
-    /** Build and return the raw JSON payload without sending it. */
-    build() {
-        return { ...this.payload };
-    }
-    /** Execute the insert/upsert and return `{ count, status }`. */
-    exec() {
-        return this.transport.send('set', this.payload);
-    }
-}
-// ─── UpdateQuery ──────────────────────────────────────────────────────────────
-/**
- * Builder for UPDATE (partial patch / merge) operations.
- *
- * Allowed fields: collection, data
- *
- * Only the fields present in each patch object are updated —
- * all other fields on the existing document are left unchanged.
- *
- * @example
- * await db.collection('laptops')
- *   .update({ lp4: { price: 1749, in_stock: true } })
- *   .exec();
- */
-export class UpdateQuery {
-    /** @internal */
-    constructor(transport, collection, data) {
-        this.transport = transport;
-        this.payload = { collection, data: data };
-    }
-    /** Build and return the raw JSON payload without sending it. */
-    build() {
-        return { ...this.payload };
-    }
-    /** Execute the patch and return `{ count, status }`. */
-    exec() {
-        return this.transport.send('update', this.payload);
-    }
-}
-// ─── DeleteQuery ──────────────────────────────────────────────────────────────
-/**
- * Builder for DELETE operations.
- *
- * Allowed fields: collection, keys, drop
- *
- * @example
- * // Delete a single document
- * await db.collection('laptops').delete().keys('lp6').exec();
- *
- * // Delete multiple documents
- * await db.collection('laptops').delete().keys(['lp4', 'lp5']).exec();
- *
- * // Drop the entire collection
- * await db.collection('laptops').delete().drop().exec();
- */
-export class DeleteQuery {
-    /** @internal */
-    constructor(transport, collection) {
-        this.transport = transport;
-        this.payload = { collection };
-    }
-    /**
-     * Delete a single document by key, or multiple documents by key array.
-     *
-     * @example
-     * .keys('lp6')
-     * .keys(['lp4', 'lp5'])
-     */
-    keys(keys) {
-        this.payload['keys'] = keys;
-        return this;
-    }
-    /**
-     * Drop the entire collection (deletes all documents).
-     * Cannot be combined with {@link keys}.
-     *
-     * @example
-     * .drop()
-     */
-    drop() {
-        this.payload['drop'] = true;
-        return this;
-    }
-    /** Build and return the raw JSON payload without sending it. */
-    build() {
-        return { ...this.payload };
-    }
-    /** Execute the delete and return `{ count, status }`. */
-    exec() {
-        return this.transport.send('delete', this.payload);
-    }
-}
-// ─── CollectionHandle ─────────────────────────────────────────────────────────
-/**
- * A handle to a specific collection.
- * Returned by `MoltenDBClient.collection(name)`.
- * Use it to start any of the four operation builders.
- */
-export class CollectionHandle {
-    /** @internal */
-    constructor(transport, collectionName) {
-        this.transport = transport;
-        this.collectionName = collectionName;
-    }
-    /**
-     * Start a GET (read/query) builder for this collection.
-     *
-     * @example
-     * db.collection('laptops').get().where({ brand: 'Apple' }).exec()
-     */
-    get() {
-        return new GetQuery(this.transport, this.collectionName);
-    }
-    /**
-     * Start a SET (insert/upsert) builder for this collection.
-     *
-     * @param data - A map of `{ key: document }` pairs, or an array of documents
-     *               (keys are auto-generated as UUIDv7 when using array format).
-     *
-     * @example
-     * db.collection('laptops').set({ lp1: { brand: 'Lenovo', price: 1499 } }).exec()
-     */
-    set(data) {
-        return new SetQuery(this.transport, this.collectionName, data);
-    }
-    /**
-     * Start an UPDATE (partial patch) builder for this collection.
-     *
-     * @param data - A map of `{ key: patch }` pairs. Only the provided fields are updated.
-     *
-     * @example
-     * db.collection('laptops').update({ lp4: { price: 1749 } }).exec()
-     */
-    update(data) {
-        return new UpdateQuery(this.transport, this.collectionName, data);
-    }
-    /**
-     * Start a DELETE builder for this collection.
-     * Chain `.keys(...)` or `.drop()` to specify what to delete.
-     *
-     * @example
-     * db.collection('laptops').delete().keys('lp6').exec()
-     */
-    delete() {
-        return new DeleteQuery(this.transport, this.collectionName);
-    }
-}
-// ─── MoltenDBClient ───────────────────────────────────────────────────────────
-/**
- * The main entry point for the MoltenDB query builder.
- *
- * Accepts any {@link MoltenTransport} implementation — use {@link WorkerTransport}
- * to connect to a MoltenDB WASM Web Worker, or provide your own transport
- * for HTTP, WebSocket, or testing.
- *
- * @example
- * // Browser + WASM Web Worker
- * const worker = new Worker('./moltendb-worker.js', { type: 'module' });
- * const transport = new WorkerTransport(worker);
- * const db = new MoltenDBClient(transport);
- *
- * const results = await db.collection('laptops')
- *   .get()
- *   .where({ in_stock: true })
- *   .sort([{ field: 'price', order: 'asc' }])
- *   .count(5)
- *   .exec();
- */
-export class MoltenDBClient {
-    constructor(transport) {
-        this.transport = transport;
-    }
-    /**
-     * Select a collection to operate on.
-     * Returns a {@link CollectionHandle} from which you can start any query builder.
-     *
-     * @param name - The collection name (e.g. `'laptops'`).
-     */
-    collection(name) {
-        return new CollectionHandle(this.transport, name);
-    }
-}