@functional-systems/lambdadb 0.3.0-dev.1 → 0.3.0-dev.3

package/dist/commonjs/client.js

@@ -27,6 +27,18 @@ const collectionsDocsListDocs_js_1 = require("./funcs/collectionsDocsListDocs.js
 const collectionsDocsUpdate_js_1 = require("./funcs/collectionsDocsUpdate.js");
 const collectionsDocsUpsert_js_1 = require("./funcs/collectionsDocsUpsert.js");
 const fp_js_1 = require("./types/fp.js");
+/**
+ * Fetches documents from a presigned docsUrl. Response must be { docs: [...] }.
+ */
+async function fetchDocsFromUrl(docsUrl) {
+    const res = await fetch(docsUrl);
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Failed to fetch documents from URL: ${res.status} ${res.statusText}${text ? ` - ${text}` : ""}`);
+    }
+    const json = (await res.json());
+    return json.docs ?? [];
+}
 /** Default base URL for the LambdaDB API. */
 exports.DEFAULT_BASE_URL = "https://api.lambdadb.ai";
 /** Default project name when not specified. */
@@ -64,12 +76,24 @@ class LambdaDBClient extends core_js_1.LambdaDBCore {
     async listCollections(options) {
         return (0, fp_js_1.unwrapAsync)((0, collectionsList_js_1.collectionsList)(this, options));
     }
+    /**
+     * List all collections (Safe: returns Result instead of throwing).
+     */
+    async listCollectionsSafe(options) {
+        return await (0, collectionsList_js_1.collectionsList)(this, options);
+    }
     /**
      * Create a new collection.
      */
     async createCollection(request, options) {
         return (0, fp_js_1.unwrapAsync)((0, collectionsCreate_js_1.collectionsCreate)(this, request, options));
     }
+    /**
+     * Create a new collection (Safe: returns Result instead of throwing).
+     */
+    async createCollectionSafe(request, options) {
+        return await (0, collectionsCreate_js_1.collectionsCreate)(this, request, options);
+    }
 }
 exports.LambdaDBClient = LambdaDBClient;
 /**
@@ -87,6 +111,12 @@ class CollectionHandle {
     async get(options) {
         return (0, fp_js_1.unwrapAsync)((0, collectionsGet_js_1.collectionsGet)(this.client, { collectionName: this.collectionName }, options));
     }
+    /**
+     * Get metadata of this collection (Safe: returns Result instead of throwing).
+     */
+    async getSafe(options) {
+        return await (0, collectionsGet_js_1.collectionsGet)(this.client, { collectionName: this.collectionName }, options);
+    }
     /**
      * Configure (update) this collection.
      */
@@ -96,20 +126,58 @@ class CollectionHandle {
             requestBody,
         }, options));
     }
+    /**
+     * Configure (update) this collection (Safe: returns Result instead of throwing).
+     */
+    async updateSafe(requestBody, options) {
+        return await (0, collectionsUpdate_js_1.collectionsUpdate)(this.client, { collectionName: this.collectionName, requestBody }, options);
+    }
     /**
      * Delete this collection.
      */
     async delete(options) {
         return (0, fp_js_1.unwrapAsync)((0, collectionsDelete_js_1.collectionsDelete)(this.client, { collectionName: this.collectionName }, options));
     }
+    /**
+     * Delete this collection (Safe: returns Result instead of throwing).
+     */
+    async deleteSafe(options) {
+        return await (0, collectionsDelete_js_1.collectionsDelete)(this.client, { collectionName: this.collectionName }, options);
+    }
     /**
      * Search this collection with a query.
+     * When the API returns docs via docsUrl (isDocsInline false), documents are
+     * fetched from the presigned URL automatically so the response always has docs.
      */
     async query(requestBody, options) {
-        return (0, fp_js_1.unwrapAsync)((0, collectionsQuery_js_1.collectionsQuery)(this.client, {
+        const result = await (0, fp_js_1.unwrapAsync)((0, collectionsQuery_js_1.collectionsQuery)(this.client, {
             collectionName: this.collectionName,
             requestBody,
         }, options));
+        if (!result.isDocsInline && result.docsUrl) {
+            const docs = await fetchDocsFromUrl(result.docsUrl);
+            return { ...result, docs, isDocsInline: true };
+        }
+        return result;
+    }
+    /**
+     * Search this collection with a query (Safe: returns Result instead of throwing).
+     * When the API returns docs via docsUrl, documents are fetched from the presigned URL automatically.
+     */
+    async querySafe(requestBody, options) {
+        const result = await (0, collectionsQuery_js_1.collectionsQuery)(this.client, { collectionName: this.collectionName, requestBody }, options);
+        if (!result.ok)
+            return result;
+        if (!result.value.isDocsInline && result.value.docsUrl) {
+            try {
+                const docs = await fetchDocsFromUrl(result.value.docsUrl);
+                return (0, fp_js_1.OK)({ ...result.value, docs, isDocsInline: true });
+            }
+            catch (e) {
+                return (0, fp_js_1.ERR)(e);
+            }
+        }
+        return result;
     }
 }
 exports.CollectionHandle = CollectionHandle;
@@ -127,6 +195,50 @@ class CollectionDocs {
     async list(params, options) {
         return (0, fp_js_1.unwrapAsync)((0, collectionsDocsListDocs_js_1.collectionsDocsListDocs)(this.client, { collectionName: this.collectionName, ...params }, options));
     }
+    /**
+     * List documents in the collection (Safe: returns Result instead of throwing).
+     */
+    async listSafe(params, options) {
+        return await (0, collectionsDocsListDocs_js_1.collectionsDocsListDocs)(this.client, { collectionName: this.collectionName, ...params }, options);
+    }
+    /**
+     * Iterate over all pages of documents. Yields one page per API response (with docs and nextPageToken).
+     * Use this to process large result sets without loading everything into memory.
+     *
+     * Note: The API limits response size by payload, not by document count. The number of docs per page
+     * may be less than the requested `size` and can vary from page to page.
+     *
+     * @example
+     * for await (const page of collection.docs.listPages({ size: 50 })) {
+     *   console.log(page.docs.length, page.nextPageToken ?? "last page");
+     * }
+     */
+    async *listPages(params, options) {
+        let pageToken = params?.pageToken;
+        const baseParams = { size: params?.size, pageToken };
+        while (true) {
+            const page = await this.list({ ...baseParams, pageToken }, options);
+            yield page;
+            pageToken = page.nextPageToken;
+            if (pageToken == null || pageToken === "")
+                break;
+        }
+    }
+    /**
+     * Fetch all documents across pages and return a single list. Uses listPages internally.
+     * For large collections, prefer listPages() to avoid high memory use.
+     *
+     * Note: Page size is constrained by API payload limits, so the number of docs per page may vary.
+     */
+    async listAll(params, options) {
+        const docs = [];
+        let total = 0;
+        for await (const page of this.listPages(params, options)) {
+            docs.push(...page.docs);
+            total = page.total;
+        }
+        return { docs, total };
+    }
     /**
      * Upsert documents. Max payload 6MB.
      */
@@ -136,6 +248,12 @@ class CollectionDocs {
             requestBody: body,
         }, options));
     }
+    /**
+     * Upsert documents (Safe: returns Result instead of throwing). Max payload 6MB.
+     */
+    async upsertSafe(body, options) {
+        return await (0, collectionsDocsUpsert_js_1.collectionsDocsUpsert)(this.client, { collectionName: this.collectionName, requestBody: body }, options);
+    }
     /**
      * Update documents (each doc must have id). Max payload 6MB.
      */
@@ -145,6 +263,12 @@ class CollectionDocs {
             requestBody: body,
         }, options));
     }
+    /**
+     * Update documents (Safe: returns Result instead of throwing). Max payload 6MB.
+     */
+    async updateSafe(body, options) {
+        return await (0, collectionsDocsUpdate_js_1.collectionsDocsUpdate)(this.client, { collectionName: this.collectionName, requestBody: body }, options);
+    }
     /**
      * Delete documents by ids and/or filter.
      */
@@ -154,14 +278,46 @@ class CollectionDocs {
             requestBody: body,
         }, options));
     }
+    /**
+     * Delete documents by ids and/or filter (Safe: returns Result instead of throwing).
+     */
+    async deleteSafe(body, options) {
+        return await (0, collectionsDocsDelete_js_1.collectionsDocsDelete)(this.client, { collectionName: this.collectionName, requestBody: body }, options);
+    }
     /**
      * Fetch documents by IDs (max 100).
+     * When the API returns docs via docsUrl (isDocsInline false), documents are
+     * fetched from the presigned URL automatically so the response always has docs.
      */
     async fetch(body, options) {
-        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsFetch_js_1.collectionsDocsFetch)(this.client, {
+        const result = await (0, fp_js_1.unwrapAsync)((0, collectionsDocsFetch_js_1.collectionsDocsFetch)(this.client, {
             collectionName: this.collectionName,
             requestBody: body,
         }, options));
+        if (!result.isDocsInline && result.docsUrl) {
+            const docs = await fetchDocsFromUrl(result.docsUrl);
+            return { ...result, docs, isDocsInline: true };
+        }
+        return result;
+    }
+    /**
+     * Fetch documents by IDs (Safe: returns Result instead of throwing).
+     * When the API returns docs via docsUrl, documents are fetched from the presigned URL automatically.
+     */
+    async fetchSafe(body, options) {
+        const result = await (0, collectionsDocsFetch_js_1.collectionsDocsFetch)(this.client, { collectionName: this.collectionName, requestBody: body }, options);
+        if (!result.ok)
+            return result;
+        if (!result.value.isDocsInline && result.value.docsUrl) {
+            try {
+                const docs = await fetchDocsFromUrl(result.value.docsUrl);
+                return (0, fp_js_1.OK)({ ...result.value, docs, isDocsInline: true });
+            }
+            catch (e) {
+                return (0, fp_js_1.ERR)(e);
+            }
+        }
+        return result;
     }
     /**
      * Get presigned URL and metadata for bulk upload (up to 200MB).
@@ -169,6 +325,12 @@ class CollectionDocs {
     async getBulkUpsert(options) {
         return (0, fp_js_1.unwrapAsync)((0, collectionsDocsGetBulkUpsert_js_1.collectionsDocsGetBulkUpsert)(this.client, { collectionName: this.collectionName }, options));
     }
+    /**
+     * Get presigned URL and metadata for bulk upload (Safe: returns Result instead of throwing).
+     */
+    async getBulkUpsertSafe(options) {
+        return await (0, collectionsDocsGetBulkUpsert_js_1.collectionsDocsGetBulkUpsert)(this.client, { collectionName: this.collectionName }, options);
+    }
     /**
      * Trigger bulk upsert with an object key from getBulkUpsert().
      */
@@ -178,5 +340,61 @@ class CollectionDocs {
             requestBody: body,
         }, options));
     }
+    /**
+     * Trigger bulk upsert (Safe: returns Result instead of throwing).
+     */
+    async bulkUpsertSafe(body, options) {
+        return await (0, collectionsDocsBulkUpsert_js_1.collectionsDocsBulkUpsert)(this.client, { collectionName: this.collectionName, requestBody: body }, options);
+    }
+    /**
+     * Bulk upsert documents in one call (up to 200MB). Abstracts getBulkUpsert,
+     * S3 upload via presigned URL, and bulkUpsert. Use this for better DX when
+     * you have a document list; use getBulkUpsert + bulkUpsert for low-level control.
+     */
+    async bulkUpsertDocs(body, options) {
+        const { url, type, httpMethod, objectKey, sizeLimitBytes } = await this.getBulkUpsert(options);
+        const payload = { docs: body.docs };
+        const jsonString = JSON.stringify(payload);
+        const sizeBytes = new TextEncoder().encode(jsonString).length;
+        if (sizeBytes > sizeLimitBytes) {
+            throw new Error(`Bulk upsert payload size (${sizeBytes} bytes) exceeds limit (${sizeLimitBytes} bytes)`);
+        }
+        const putResponse = await fetch(url, {
+            method: httpMethod,
+            headers: { "Content-Type": type },
+            body: jsonString,
+        });
+        if (!putResponse.ok) {
+            const text = await putResponse.text();
+            throw new Error(`Bulk upsert upload failed: ${putResponse.status} ${putResponse.statusText}${text ? ` - ${text}` : ""}`);
+        }
+        return this.bulkUpsert({ objectKey }, options);
+    }
+    /**
+     * Bulk upsert documents in one call (Safe: returns Result instead of throwing).
+     * May return Error for local failures (payload size, upload). API errors use GetBulkUpsertDocsError or BulkUpsertDocsError.
+     */
+    async bulkUpsertDocsSafe(body, options) {
+        const getResult = await this.getBulkUpsertSafe(options);
+        if (!getResult.ok)
+            return getResult;
+        const { url, type, httpMethod, objectKey, sizeLimitBytes } = getResult.value;
+        const payload = { docs: body.docs };
+        const jsonString = JSON.stringify(payload);
+        const sizeBytes = new TextEncoder().encode(jsonString).length;
+        if (sizeBytes > sizeLimitBytes) {
+            return (0, fp_js_1.ERR)(new Error(`Bulk upsert payload size (${sizeBytes} bytes) exceeds limit (${sizeLimitBytes} bytes)`));
+        }
+        const putResponse = await fetch(url, {
+            method: httpMethod,
+            headers: { "Content-Type": type },
+            body: jsonString,
+        });
+        if (!putResponse.ok) {
+            const text = await putResponse.text();
+            return (0, fp_js_1.ERR)(new Error(`Bulk upsert upload failed: ${putResponse.status} ${putResponse.statusText}${text ? ` - ${text}` : ""}`));
+        }
+        return this.bulkUpsertSafe({ objectKey }, options);
+    }
 }
 //# sourceMappingURL=client.js.map

package/dist/commonjs/client.js.map

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

package/dist/commonjs/index.d.ts

@@ -3,6 +3,21 @@ export * as files from "./lib/files.js";
 export { HTTPClient } from "./lib/http.js";
 export type { Fetcher, HTTPClientOptions } from "./lib/http.js";
 export * from "./sdk/sdk.js";
-/** Collection-scoped client (recommended). See docs/REFACTORING_PROPOSAL.md */
+/** Collection-scoped client (recommended). See docs/REFACTORING_STATUS.md */
 export { LambdaDBClient, CollectionHandle, DEFAULT_BASE_URL, DEFAULT_PROJECT_NAME, type RequestOptions as ClientRequestOptions, type LambdaDBClientOptions, } from "./client.js";
+/** Public API types (inputs and responses for the collection-scoped client). */
+export type * from "./types/public.js";
+/** Result type and helpers for Safe methods. */
+export type { Result } from "./types/fp.js";
+export { OK, ERR } from "./types/fp.js";
+/** Error classes and per-operation error unions for Safe methods and instanceof checks. */
+export * from "./types/errors.js";
+/** Query input helper for collection.query() / collection.querySafe(). */
+export { createQueryInput, type CreateQueryInputOptions, } from "./lib/queryInput.js";
+/** Retry config type for LambdaDBClientOptions and RequestOptions. */
+export type { RetryConfig } from "./lib/retries.js";
+/**
+ * @deprecated Use types from the package root (e.g. CreateCollectionInput, QueryCollectionResponse). Will be removed in the next major version.
+ */
+export type { operations, models } from "./client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/commonjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAChE,cAAc,cAAc,CAAC;AAE7B,+EAA+E;AAC/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,cAAc,IAAI,oBAAoB,EAC3C,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAChE,cAAc,cAAc,CAAC;AAE7B,6EAA6E;AAC7E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,cAAc,IAAI,oBAAoB,EAC3C,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAChF,mBAAmB,mBAAmB,CAAC;AAEvC,gDAAgD;AAChD,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAExC,2FAA2F;AAC3F,cAAc,mBAAmB,CAAC;AAElC,0EAA0E;AAC1E,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,sEAAsE;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/commonjs/index.js

@@ -39,16 +39,24 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_PROJECT_NAME = exports.DEFAULT_BASE_URL = exports.CollectionHandle = exports.LambdaDBClient = exports.HTTPClient = exports.files = void 0;
+exports.createQueryInput = exports.ERR = exports.OK = exports.DEFAULT_PROJECT_NAME = exports.DEFAULT_BASE_URL = exports.CollectionHandle = exports.LambdaDBClient = exports.HTTPClient = exports.files = void 0;
 __exportStar(require("./lib/config.js"), exports);
 exports.files = __importStar(require("./lib/files.js"));
 var http_js_1 = require("./lib/http.js");
 Object.defineProperty(exports, "HTTPClient", { enumerable: true, get: function () { return http_js_1.HTTPClient; } });
 __exportStar(require("./sdk/sdk.js"), exports);
-/** Collection-scoped client (recommended). See docs/REFACTORING_PROPOSAL.md */
+/** Collection-scoped client (recommended). See docs/REFACTORING_STATUS.md */
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "LambdaDBClient", { enumerable: true, get: function () { return client_js_1.LambdaDBClient; } });
 Object.defineProperty(exports, "CollectionHandle", { enumerable: true, get: function () { return client_js_1.CollectionHandle; } });
 Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return client_js_1.DEFAULT_BASE_URL; } });
 Object.defineProperty(exports, "DEFAULT_PROJECT_NAME", { enumerable: true, get: function () { return client_js_1.DEFAULT_PROJECT_NAME; } });
+var fp_js_1 = require("./types/fp.js");
+Object.defineProperty(exports, "OK", { enumerable: true, get: function () { return fp_js_1.OK; } });
+Object.defineProperty(exports, "ERR", { enumerable: true, get: function () { return fp_js_1.ERR; } });
+/** Error classes and per-operation error unions for Safe methods and instanceof checks. */
+__exportStar(require("./types/errors.js"), exports);
+/** Query input helper for collection.query() / collection.querySafe(). */
+var queryInput_js_1 = require("./lib/queryInput.js");
+Object.defineProperty(exports, "createQueryInput", { enumerable: true, get: function () { return queryInput_js_1.createQueryInput; } });
 //# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,wDAAwC;AACxC,yCAA2C;AAAlC,qGAAA,UAAU,OAAA;AAEnB,+CAA6B;AAE7B,+EAA+E;AAC/E,yCAOqB;AANnB,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,wDAAwC;AACxC,yCAA2C;AAAlC,qGAAA,UAAU,OAAA;AAEnB,+CAA6B;AAE7B,6EAA6E;AAC7E,yCAOqB;AANnB,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AAUtB,uCAAwC;AAA/B,2FAAA,EAAE,OAAA;AAAE,4FAAA,GAAG,OAAA;AAEhB,2FAA2F;AAC3F,oDAAkC;AAElC,0EAA0E;AAC1E,qDAG6B;AAF3B,iHAAA,gBAAgB,OAAA"}

package/dist/commonjs/lib/config.d.ts

@@ -13,11 +13,13 @@ export type SDKOptions = {
      */
     serverIdx?: number | undefined;
     /**
-     * Sets the projectHost variable for url substitution
+     * Sets the projectHost variable for url substitution.
+     * @deprecated Prefer `baseUrl` + `projectName` when using {@link LambdaDBClient}.
      */
     projectHost?: string | undefined;
     /**
-     * Allows overriding the default server URL used by the SDK
+     * Allows overriding the default server URL used by the SDK.
+     * @deprecated Prefer `baseUrl` + `projectName` when using {@link LambdaDBClient}. Use this only when you need to override the full base URL.
      */
     serverURL?: string | undefined;
     /**

package/dist/commonjs/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,eAAO,MAAM,UAAU,oCAKb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAE7D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,GAAG,IAAI,CAqBpE;AAED,eAAO,MAAM,YAAY;;;;;;CAOf,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,eAAO,MAAM,UAAU,oCAKb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAE7D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,GAAG,IAAI,CAqBpE;AAED,eAAO,MAAM,YAAY;;;;;;CAOf,CAAC"}

package/dist/commonjs/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA6CH,oDAqBC;AA7DD,qCAA8C;AAE9C;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB;;OAEG;IACH,uBAAuB;CACf,CAAC;AA8BX,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAElC,MAAM,YAAY,GAAa;QAC7B;YACE,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,mCAAmC;SAC1E;KACF,CAAC;IACF,IAAI,MAAM,GAAW,EAAE,CAAC;IAExB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACzC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,kBAAU,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,SAAS,GAAG,kBAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,GAAG,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAEY,QAAA,YAAY,GAAG;IAC1B,QAAQ,EAAE,YAAY;IACtB,iBAAiB,EAAE,OAAO;IAC1B,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,SAAS;IACrB,SAAS,EACP,2EAA2E;CACrE,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA+CH,oDAqBC;AA/DD,qCAA8C;AAE9C;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB;;OAEG;IACH,uBAAuB;CACf,CAAC;AAgCX,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAElC,MAAM,YAAY,GAAa;QAC7B;YACE,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,mCAAmC;SAC1E;KACF,CAAC;IACF,IAAI,MAAM,GAAW,EAAE,CAAC;IAExB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACzC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,kBAAU,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,SAAS,GAAG,kBAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,GAAG,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAEY,QAAA,YAAY,GAAG;IAC1B,QAAQ,EAAE,YAAY;IACtB,iBAAiB,EAAE,OAAO;IAC1B,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,SAAS;IACrB,SAAS,EACP,2EAA2E;CACrE,CAAC"}

package/dist/commonjs/lib/queryInput.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Helper to build QueryCollectionInput for collection.query() / collection.querySafe().
+ */
+import type { FieldsSelectorUnion, PartitionFilter } from "../models/index.js";
+import type { QueryCollectionInput } from "../types/public.js";
+/**
+ * Options for createQueryInput (all optional except query).
+ */
+export type CreateQueryInputOptions = {
+    size?: number;
+    consistentRead?: boolean;
+    includeVectors?: boolean;
+    sort?: Array<{
+        [k: string]: unknown;
+    }>;
+    fields?: FieldsSelectorUnion;
+    partitionFilter?: PartitionFilter;
+};
+/**
+ * Build a query input object for collection.query() or collection.querySafe().
+ * Pass the required query object (e.g. text search or vector search params) and optional options.
+ *
+ * @example
+ * const input = createQueryInput({ text: "hello" }, { size: 10 });
+ * const result = await collection.query(input);
+ */
+export declare function createQueryInput(query: {
+    [k: string]: unknown;
+}, options?: CreateQueryInputOptions): QueryCollectionInput;
+//# sourceMappingURL=queryInput.d.ts.map

package/dist/commonjs/lib/queryInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryInput.d.ts","sourceRoot":"","sources":["../../../src/lib/queryInput.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAC/B,OAAO,CAAC,EAAE,uBAAuB,GAChC,oBAAoB,CAEtB"}

package/dist/commonjs/lib/queryInput.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Helper to build QueryCollectionInput for collection.query() / collection.querySafe().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQueryInput = createQueryInput;
+/**
+ * Build a query input object for collection.query() or collection.querySafe().
+ * Pass the required query object (e.g. text search or vector search params) and optional options.
+ *
+ * @example
+ * const input = createQueryInput({ text: "hello" }, { size: 10 });
+ * const result = await collection.query(input);
+ */
+function createQueryInput(query, options) {
+    return { query, ...options };
+}
+//# sourceMappingURL=queryInput.js.map

package/dist/commonjs/lib/queryInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryInput.js","sourceRoot":"","sources":["../../../src/lib/queryInput.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAyBH,4CAKC;AAbD;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,KAA+B,EAC/B,OAAiC;IAEjC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/commonjs/sdk/collections.d.ts

@@ -2,6 +2,9 @@ import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 import { Docs } from "./docs.js";
+/**
+ * @deprecated Use {@link LambdaDBClient} (e.g. `client.listCollections()`, `client.collection(name).get()`). This legacy API will be removed in a future major version.
+ */
 export declare class Collections extends ClientSDK {
     private _docs?;
     get docs(): Docs;

package/dist/commonjs/sdk/collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/sdk/collections.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,KAAK,CAAC,CAAO;IACrB,IAAI,IAAI,IAAI,IAAI,CAEf;IAED;;OAEG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC;IAO9C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC;IAQ/C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,GAAG,CACP,OAAO,EAAE,UAAU,CAAC,oBAAoB,EACxC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC;IAQ5C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC;IAQ/C;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,UAAU,CAAC,sBAAsB,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC;CAO/C"}
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/sdk/collections.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,KAAK,CAAC,CAAO;IACrB,IAAI,IAAI,IAAI,IAAI,CAEf;IAED;;OAEG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC;IAO9C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC;IAQ/C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,GAAG,CACP,OAAO,EAAE,UAAU,CAAC,oBAAoB,EACxC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC;IAQ5C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC;IAQ/C;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,UAAU,CAAC,sBAAsB,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC;CAO/C"}

package/dist/commonjs/sdk/collections.js

@@ -13,6 +13,9 @@ const collectionsUpdate_js_1 = require("../funcs/collectionsUpdate.js");
 const sdks_js_1 = require("../lib/sdks.js");
 const fp_js_1 = require("../types/fp.js");
 const docs_js_1 = require("./docs.js");
+/**
+ * @deprecated Use {@link LambdaDBClient} (e.g. `client.listCollections()`, `client.collection(name).get()`). This legacy API will be removed in a future major version.
+ */
 class Collections extends sdks_js_1.ClientSDK {
     get docs() {
         return (this._docs ?? (this._docs = new docs_js_1.Docs(this._options)));

package/dist/commonjs/sdk/collections.js.map

@@ -1 +1 @@
-{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/sdk/collections.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,wEAAkE;AAClE,wEAAkE;AAClE,kEAA4D;AAC5D,oEAA8D;AAC9D,sEAAgE;AAChE,wEAAkE;AAClE,4CAA2D;AAG3D,0CAA6C;AAC7C,uCAAiC;AAEjC,MAAa,WAAY,SAAQ,mBAAS;IAExC,IAAI,IAAI;QACN,OAAO,CAAC,IAAI,CAAC,KAAK,KAAV,IAAI,CAAC,KAAK,GAAK,IAAI,cAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,oCAAe,EAChC,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAClC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAClC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,OAAwC,EACxC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,kCAAc,EAC/B,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAClC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,OAA0C,EAC1C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,sCAAgB,EACjC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF;AAvFD,kCAuFC"}
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/sdk/collections.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,wEAAkE;AAClE,wEAAkE;AAClE,kEAA4D;AAC5D,oEAA8D;AAC9D,sEAAgE;AAChE,wEAAkE;AAClE,4CAA2D;AAG3D,0CAA6C;AAC7C,uCAAiC;AAEjC;;GAEG;AACH,MAAa,WAAY,SAAQ,mBAAS;IAExC,IAAI,IAAI;QACN,OAAO,CAAC,IAAI,CAAC,KAAK,KAAV,IAAI,CAAC,KAAK,GAAK,IAAI,cAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,oCAAe,EAChC,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAClC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAClC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,OAAwC,EACxC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,kCAAc,EAC/B,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAClC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,OAA0C,EAC1C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,sCAAgB,EACjC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF;AAvFD,kCAuFC"}

package/dist/commonjs/sdk/docs.d.ts

@@ -1,6 +1,9 @@
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
+/**
+ * @deprecated Use {@link LambdaDBClient} and `client.collection(name).docs` (e.g. `.list()`, `.upsert()`, `.fetch()`). This legacy API will be removed in a future major version.
+ */
 export declare class Docs extends ClientSDK {
     /**
      * List documents in a collection.

package/dist/commonjs/sdk/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/sdk/docs.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D,qBAAa,IAAK,SAAQ,SAAS;IACjC;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,UAAU,CAAC,eAAe,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAQvC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,iBAAiB,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,UAAU,CAAC,wBAAwB,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAQhD;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,UAAU,CAAC,qBAAqB,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,iBAAiB,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,iBAAiB,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,UAAU,CAAC,gBAAgB,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;CAOzC"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/sdk/docs.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D;;GAEG;AACH,qBAAa,IAAK,SAAQ,SAAS;IACjC;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,UAAU,CAAC,eAAe,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAQvC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,iBAAiB,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,UAAU,CAAC,wBAAwB,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAQhD;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,UAAU,CAAC,qBAAqB,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,iBAAiB,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,UAAU,CAAC,iBAAiB,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAQlC;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,UAAU,CAAC,gBAAgB,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;CAOzC"}

package/dist/commonjs/sdk/docs.js

@@ -13,6 +13,9 @@ const collectionsDocsUpdate_js_1 = require("../funcs/collectionsDocsUpdate.js");
 const collectionsDocsUpsert_js_1 = require("../funcs/collectionsDocsUpsert.js");
 const sdks_js_1 = require("../lib/sdks.js");
 const fp_js_1 = require("../types/fp.js");
+/**
+ * @deprecated Use {@link LambdaDBClient} and `client.collection(name).docs` (e.g. `.list()`, `.upsert()`, `.fetch()`). This legacy API will be removed in a future major version.
+ */
 class Docs extends sdks_js_1.ClientSDK {
     /**
      * List documents in a collection.

package/dist/commonjs/sdk/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/sdk/docs.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,wFAAkF;AAClF,gFAA0E;AAC1E,8EAAwE;AACxE,8FAAwF;AACxF,oFAA8E;AAC9E,gFAA0E;AAC1E,gFAA0E;AAC1E,4CAA2D;AAG3D,0CAA6C;AAE7C,MAAa,IAAK,SAAQ,mBAAS;IACjC;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAmC,EACnC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,oDAAuB,EACxC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,gDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,OAA4C,EAC5C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,8DAA4B,EAC7C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,OAAyC,EACzC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wDAAyB,EAC1C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,gDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,gDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,OAAoC,EACpC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,8CAAoB,EACrC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF;AAlGD,oBAkGC"}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/sdk/docs.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,wFAAkF;AAClF,gFAA0E;AAC1E,8EAAwE;AACxE,8FAAwF;AACxF,oFAA8E;AAC9E,gFAA0E;AAC1E,gFAA0E;AAC1E,4CAA2D;AAG3D,0CAA6C;AAE7C;;GAEG;AACH,MAAa,IAAK,SAAQ,mBAAS;IACjC;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAmC,EACnC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,oDAAuB,EACxC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,gDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,OAA4C,EAC5C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,8DAA4B,EAC7C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,OAAyC,EACzC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wDAAyB,EAC1C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,gDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,gDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,OAAoC,EACpC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,8CAAoB,EACrC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF;AAlGD,oBAkGC"}

package/dist/commonjs/sdk/sdk.d.ts

@@ -1,5 +1,8 @@
 import { ClientSDK } from "../lib/sdks.js";
 import { Collections } from "./collections.js";
+/**
+ * @deprecated Use {@link LambdaDBClient} and `client.collection(name)` instead. This legacy client will be removed in a future major version.
+ */
 export declare class LambdaDB extends ClientSDK {
     private _collections?;
     get collections(): Collections;

package/dist/commonjs/sdk/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/sdk/sdk.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,QAAS,SAAQ,SAAS;IACrC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,IAAI,WAAW,IAAI,WAAW,CAE7B;CACF"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/sdk/sdk.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,qBAAa,QAAS,SAAQ,SAAS;IACrC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,IAAI,WAAW,IAAI,WAAW,CAE7B;CACF"}

package/dist/commonjs/sdk/sdk.js

@@ -6,6 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LambdaDB = void 0;
 const sdks_js_1 = require("../lib/sdks.js");
 const collections_js_1 = require("./collections.js");
+/**
+ * @deprecated Use {@link LambdaDBClient} and `client.collection(name)` instead. This legacy client will be removed in a future major version.
+ */
 class LambdaDB extends sdks_js_1.ClientSDK {
     get collections() {
         return (this._collections ?? (this._collections = new collections_js_1.Collections(this._options)));

package/dist/commonjs/sdk/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/sdk/sdk.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,4CAA2C;AAC3C,qDAA+C;AAE/C,MAAa,QAAS,SAAQ,mBAAS;IAErC,IAAI,WAAW;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,KAAjB,IAAI,CAAC,YAAY,GAAK,IAAI,4BAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAC,CAAC;IAChE,CAAC;CACF;AALD,4BAKC"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/sdk/sdk.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,4CAA2C;AAC3C,qDAA+C;AAE/C;;GAEG;AACH,MAAa,QAAS,SAAQ,mBAAS;IAErC,IAAI,WAAW;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,KAAjB,IAAI,CAAC,YAAY,GAAK,IAAI,4BAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAC,CAAC;IAChE,CAAC;CACF;AALD,4BAKC"}