@functional-systems/lambdadb 0.2.1 → 0.3.0-dev

package/README.md

@@ -3,9 +3,8 @@
 Developer-friendly & type-safe Typescript SDK specifically catered to leverage *LambdaDB* API.
 
 <div align="left">
-    <a href="https://www.speakeasy.com/?utm_source=lambdadb&utm_campaign=typescript"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
-    <a href="https://opensource.org/licenses/MIT">
-        <img src="https://img.shields.io/badge/License-MIT-blue.svg" style="width: 100px; height: 28px;" />
+    <a href="https://opensource.org/licenses/Apache-2.0">
+        <img src="https://img.shields.io/badge/License-Apache--2.0-blue.svg" style="width: 100px; height: 28px;" />
     </a>
 </div>
 
@@ -80,23 +79,30 @@ For supported JavaScript runtimes, please consult [RUNTIMES.md](RUNTIMES.md).
 <!-- Start SDK Example Usage [usage] -->
 ## SDK Example Usage
 
-### Example
+We recommend the **collection-scoped client** (`LambdaDBClient`): you get a handle for a collection once and then call methods without passing `collectionName` on every request.
+
+### Recommended: LambdaDBClient (collection-scoped)
 
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   projectApiKey: "<YOUR_PROJECT_API_KEY>",
 });
 
 async function run() {
-  const result = await lambdaDB.collections.list();
-
-  console.log(result);
+  // List all collections in the project
+  const list = await client.listCollections();
+  console.log(list);
+
+  // Work with a specific collection — no collectionName in every call
+  const collection = client.collection("my-collection");
+  await collection.get();
+  await collection.docs.list({ size: 20 });
+  await collection.docs.upsert({ docs: [{ id: "1", text: "hello" }] });
 }
 
 run();
-
 ```
 <!-- End SDK Example Usage [usage] -->
 
@@ -113,20 +119,18 @@ This SDK supports the following security scheme globally:
 
 To authenticate with the API the `projectApiKey` parameter must be set when initializing the SDK client instance. For example:
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   projectApiKey: "<YOUR_PROJECT_API_KEY>",
 });
 
 async function run() {
-  const result = await lambdaDB.collections.list();
-
+  const result = await client.listCollections();
   console.log(result);
 }
 
 run();
-
 ```
 <!-- End Authentication [security] -->
 
@@ -158,6 +162,20 @@ run();
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
+### Legacy API (`LambdaDB`)
+
+The classic client `LambdaDB` is still supported for compatibility. New code should prefer `LambdaDBClient` and `client.collection(name)`.
+
+```typescript
+import { LambdaDB } from "@functional-systems/lambdadb";
+
+const lambdaDB = new LambdaDB({ projectApiKey: "<YOUR_PROJECT_API_KEY>" });
+const result = await lambdaDB.collections.list();
+await lambdaDB.collections.docs.listDocs({ collectionName: "my-collection", size: 20 });
+```
+
+See [docs/sdks/collections/README.md](docs/sdks/collections/README.md) and [docs/sdks/docs/README.md](docs/sdks/docs/README.md) for the full legacy API reference.
+
 <!-- Start Standalone functions [standalone-funcs] -->
 ## Standalone functions
 
@@ -197,14 +215,14 @@ Some of the endpoints in this SDK support retries.  If you use the SDK without a
 
 To change the default retry strategy for a single API call, simply provide a retryConfig object to the call:
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   projectApiKey: "<YOUR_PROJECT_API_KEY>",
 });
 
 async function run() {
-  const result = await lambdaDB.collections.list({
+  const result = await client.listCollections({
     retries: {
       strategy: "backoff",
       backoff: {
@@ -216,19 +234,17 @@ async function run() {
       retryConnectionErrors: false,
     },
   });
-
   console.log(result);
 }
 
 run();
-
 ```
 
 If you'd like to override the default retry strategy for all operations that support retries, you can provide a retryConfig at SDK initialization:
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   retryConfig: {
     strategy: "backoff",
     backoff: {
@@ -243,8 +259,7 @@ const lambdaDB = new LambdaDB({
 });
 
 async function run() {
-  const result = await lambdaDB.collections.list();
-
+  const result = await client.listCollections();
   console.log(result);
 }
 
@@ -269,17 +284,16 @@ run();
 
 ### Example
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 import * as errors from "@functional-systems/lambdadb/models/errors";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   projectApiKey: "<YOUR_PROJECT_API_KEY>",
 });
 
 async function run() {
   try {
-    const result = await lambdaDB.collections.list();
-
+    const result = await client.listCollections();
     console.log(result);
   } catch (error) {
     // The base class for HTTP error responses
@@ -345,43 +359,39 @@ The default server `https://{projectHost}` contains variables and is set to `htt
 #### Example
 
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   serverIdx: 0,
   projectHost: "api.lambdadb.com/projects/default",
   projectApiKey: "<YOUR_PROJECT_API_KEY>",
 });
 
 async function run() {
-  const result = await lambdaDB.collections.list();
-
+  const result = await client.listCollections();
   console.log(result);
 }
 
 run();
-
 ```
 
 ### Override Server URL Per-Client
 
 The default server can be overridden globally by passing a URL to the `serverURL: string` optional parameter when initializing the SDK client instance. For example:
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
+const client = new LambdaDBClient({
   serverURL: "https://api.lambdadb.com/projects/default",
   projectApiKey: "<YOUR_PROJECT_API_KEY>",
 });
 
 async function run() {
-  const result = await lambdaDB.collections.list();
-
+  const result = await client.listCollections();
   console.log(result);
 }
 
 run();
-
 ```
 <!-- End Server Selection [server] -->
 
@@ -403,7 +413,7 @@ custom header and a timeout to requests and how to use the `"requestError"` hook
 to log errors:
 
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 import { HTTPClient } from "@functional-systems/lambdadb/lib/http";
 
 const httpClient = new HTTPClient({
@@ -430,7 +440,7 @@ httpClient.addHook("requestError", (error, request) => {
   console.groupEnd();
 });
 
-const sdk = new LambdaDB({ httpClient: httpClient });
+const client = new LambdaDBClient({ httpClient, projectApiKey: "<YOUR_PROJECT_API_KEY>" });
 ```
 <!-- End Custom HTTP Client [http-client] -->
 
@@ -445,25 +455,20 @@ You can pass a logger that matches `console`'s interface as an SDK option.
 > Beware that debug logging will reveal secrets, like API tokens in headers, in log messages printed to a console or files. It's recommended to use this feature only during local development and not in production.
 
 ```typescript
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const sdk = new LambdaDB({ debugLogger: console });
+const client = new LambdaDBClient({ debugLogger: console, projectApiKey: "<YOUR_PROJECT_API_KEY>" });
 ```
 
 You can also enable a default debug logger by setting an environment variable `LAMBDADB_DEBUG` to true.
 <!-- End Debugging [debug] -->
 
-<!-- Placeholder for Future Speakeasy SDK Sections -->
-
 # Development
 
 ## Maturity
 
-This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage
-to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally
-looking for the latest version.
+This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage to a specific package version unless you are intentionally looking for the latest version.
 
 ## Contributions
 
-While we value open-source contributions to this SDK, this library is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation. 
-We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release. 
+We welcome contributions. The recommended API is implemented in `src/client.ts` (LambdaDBClient, collection-scoped). The rest of `src/` (funcs, models, lib) is maintained manually; see [docs/OPENAPI_UPDATE.md](docs/OPENAPI_UPDATE.md) for how API changes are applied. Feel free to open a PR or an issue. 

package/dist/commonjs/client.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Collection-scoped facade for LambdaDB API.
+ * Use this client for a better DX: no need to pass collectionName on every call.
+ *
+ * @example
+ * const client = new LambdaDBClient({ projectApiKey: "..." });
+ * const collection = client.collection("my-collection");
+ * await collection.get();
+ * await collection.docs.list({ size: 20 });
+ * await collection.docs.upsert({ docs: [{ id: "1", text: "hello" }] });
+ */
+import { LambdaDBCore } from "./core.js";
+import type { RequestOptions } from "./lib/sdks.js";
+import type * as operations from "./models/operations/index.js";
+import type * as models from "./models/index.js";
+export type { RequestOptions };
+export type { operations, models };
+/**
+ * Client with collection-scoped API. Prefer this over the legacy
+ * `LambdaDB` when you want to avoid passing collectionName on every call.
+ */
+export declare class LambdaDBClient extends LambdaDBCore {
+    /**
+     * Get a handle for a specific collection. All methods on the handle
+     * use this collection name; you do not pass it again.
+     */
+    collection(collectionName: string): CollectionHandle;
+    /**
+     * List all collections in the project.
+     */
+    listCollections(options?: RequestOptions): Promise<operations.ListCollectionsResponse>;
+    /**
+     * Create a new collection.
+     */
+    createCollection(request: operations.CreateCollectionRequest, options?: RequestOptions): Promise<operations.CreateCollectionResponse>;
+}
+/**
+ * Handle for a single collection. All methods operate on this collection.
+ */
+export declare class CollectionHandle {
+    private readonly client;
+    readonly collectionName: string;
+    constructor(client: LambdaDBCore, collectionName: string);
+    /**
+     * Get metadata of this collection.
+     */
+    get(options?: RequestOptions): Promise<operations.GetCollectionResponse>;
+    /**
+     * Configure (update) this collection.
+     */
+    update(requestBody: operations.UpdateCollectionRequestBody, options?: RequestOptions): Promise<operations.UpdateCollectionResponse>;
+    /**
+     * Delete this collection.
+     */
+    delete(options?: RequestOptions): Promise<models.MessageResponse>;
+    /**
+     * Search this collection with a query.
+     */
+    query(requestBody: operations.QueryCollectionRequestBody, options?: RequestOptions): Promise<operations.QueryCollectionResponse>;
+    readonly docs: CollectionDocs;
+}
+/**
+ * Document operations scoped to a collection.
+ */
+declare class CollectionDocs {
+    private readonly client;
+    private readonly collectionName;
+    constructor(client: LambdaDBCore, collectionName: string);
+    /**
+     * List documents in the collection.
+     */
+    list(params?: {
+        size?: number;
+        pageToken?: string;
+    }, options?: RequestOptions): Promise<operations.ListDocsResponse>;
+    /**
+     * Upsert documents. Max payload 6MB.
+     */
+    upsert(body: {
+        docs: Array<Record<string, unknown>>;
+    }, options?: RequestOptions): Promise<models.MessageResponse>;
+    /**
+     * Update documents (each doc must have id). Max payload 6MB.
+     */
+    update(body: {
+        docs: Array<Record<string, unknown>>;
+    }, options?: RequestOptions): Promise<models.MessageResponse>;
+    /**
+     * Delete documents by ids and/or filter.
+     */
+    delete(body: operations.DeleteDocsRequestBody, options?: RequestOptions): Promise<models.MessageResponse>;
+    /**
+     * Fetch documents by IDs (max 100).
+     */
+    fetch(body: operations.FetchDocsRequestBody, options?: RequestOptions): Promise<operations.FetchDocsResponse>;
+    /**
+     * Get presigned URL and metadata for bulk upload (up to 200MB).
+     */
+    getBulkUpsert(options?: RequestOptions): Promise<operations.GetBulkUpsertDocsResponse>;
+    /**
+     * Trigger bulk upsert with an object key from getBulkUpsert().
+     */
+    bulkUpsert(body: {
+        objectKey: string;
+    }, options?: RequestOptions): Promise<models.MessageResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAczC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,cAAc,EAAE,CAAC;AAG/B,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAEnC;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C;;;OAGG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB;IAIpD;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc;IAI9C;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,UAAU,CAAC,uBAAuB,EAC3C,OAAO,CAAC,EAAE,cAAc;CAI3B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM;gBADd,MAAM,EAAE,YAAY,EAC5B,cAAc,EAAE,MAAM;IAGjC;;OAEG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc;IAMlC;;OAEG;IACG,MAAM,CACV,WAAW,EAAE,UAAU,CAAC,2BAA2B,EACnD,OAAO,CAAC,EAAE,cAAc;IAc1B;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc;IAUrC;;OAEG;IACG,KAAK,CACT,WAAW,EAAE,UAAU,CAAC,0BAA0B,EAClD,OAAO,CAAC,EAAE,cAAc;IAc1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAwD;CACtF;AAED;;GAEG;AACH,cAAM,cAAc;IAEhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM;IAGzC;;OAEG;IACG,IAAI,CACR,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9C,OAAO,CAAC,EAAE,cAAc;IAW1B;;OAEG;IACG,MAAM,CACV,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAalC;;OAEG;IACG,MAAM,CACV,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAalC;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,UAAU,CAAC,qBAAqB,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;IAalC;;OAEG;IACG,KAAK,CACT,IAAI,EAAE,UAAU,CAAC,oBAAoB,EACrC,OAAO,CAAC,EAAE,cAAc;IAc1B;;OAEG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc;IAU5C;;OAEG;IACG,UAAU,CACd,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;CAYnC"}

package/dist/commonjs/client.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Collection-scoped facade for LambdaDB API.
+ * Use this client for a better DX: no need to pass collectionName on every call.
+ *
+ * @example
+ * const client = new LambdaDBClient({ projectApiKey: "..." });
+ * const collection = client.collection("my-collection");
+ * await collection.get();
+ * await collection.docs.list({ size: 20 });
+ * await collection.docs.upsert({ docs: [{ id: "1", text: "hello" }] });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionHandle = exports.LambdaDBClient = void 0;
+const core_js_1 = require("./core.js");
+const collectionsCreate_js_1 = require("./funcs/collectionsCreate.js");
+const collectionsDelete_js_1 = require("./funcs/collectionsDelete.js");
+const collectionsGet_js_1 = require("./funcs/collectionsGet.js");
+const collectionsList_js_1 = require("./funcs/collectionsList.js");
+const collectionsQuery_js_1 = require("./funcs/collectionsQuery.js");
+const collectionsUpdate_js_1 = require("./funcs/collectionsUpdate.js");
+const collectionsDocsBulkUpsert_js_1 = require("./funcs/collectionsDocsBulkUpsert.js");
+const collectionsDocsDelete_js_1 = require("./funcs/collectionsDocsDelete.js");
+const collectionsDocsFetch_js_1 = require("./funcs/collectionsDocsFetch.js");
+const collectionsDocsGetBulkUpsert_js_1 = require("./funcs/collectionsDocsGetBulkUpsert.js");
+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");
+/**
+ * Client with collection-scoped API. Prefer this over the legacy
+ * `LambdaDB` when you want to avoid passing collectionName on every call.
+ */
+class LambdaDBClient extends core_js_1.LambdaDBCore {
+    /**
+     * Get a handle for a specific collection. All methods on the handle
+     * use this collection name; you do not pass it again.
+     */
+    collection(collectionName) {
+        return new CollectionHandle(this, collectionName);
+    }
+    /**
+     * List all collections in the project.
+     */
+    async listCollections(options) {
+        return (0, fp_js_1.unwrapAsync)((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));
+    }
+}
+exports.LambdaDBClient = LambdaDBClient;
+/**
+ * Handle for a single collection. All methods operate on this collection.
+ */
+class CollectionHandle {
+    constructor(client, collectionName) {
+        this.client = client;
+        this.collectionName = collectionName;
+        this.docs = new CollectionDocs(this.client, this.collectionName);
+    }
+    /**
+     * Get metadata of this collection.
+     */
+    async get(options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsGet_js_1.collectionsGet)(this.client, { collectionName: this.collectionName }, options));
+    }
+    /**
+     * Configure (update) this collection.
+     */
+    async update(requestBody, options) {
+        return (0, fp_js_1.unwrapAsync)((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));
+    }
+    /**
+     * Search this collection with a query.
+     */
+    async query(requestBody, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsQuery_js_1.collectionsQuery)(this.client, {
+            collectionName: this.collectionName,
+            requestBody,
+        }, options));
+    }
+}
+exports.CollectionHandle = CollectionHandle;
+/**
+ * Document operations scoped to a collection.
+ */
+class CollectionDocs {
+    constructor(client, collectionName) {
+        this.client = client;
+        this.collectionName = collectionName;
+    }
+    /**
+     * List documents in the collection.
+     */
+    async list(params, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsListDocs_js_1.collectionsDocsListDocs)(this.client, { collectionName: this.collectionName, ...params }, options));
+    }
+    /**
+     * Upsert documents. Max payload 6MB.
+     */
+    async upsert(body, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsUpsert_js_1.collectionsDocsUpsert)(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Update documents (each doc must have id). Max payload 6MB.
+     */
+    async update(body, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsUpdate_js_1.collectionsDocsUpdate)(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Delete documents by ids and/or filter.
+     */
+    async delete(body, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsDelete_js_1.collectionsDocsDelete)(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Fetch documents by IDs (max 100).
+     */
+    async fetch(body, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsFetch_js_1.collectionsDocsFetch)(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Get presigned URL and metadata for bulk upload (up to 200MB).
+     */
+    async getBulkUpsert(options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsGetBulkUpsert_js_1.collectionsDocsGetBulkUpsert)(this.client, { collectionName: this.collectionName }, options));
+    }
+    /**
+     * Trigger bulk upsert with an object key from getBulkUpsert().
+     */
+    async bulkUpsert(body, options) {
+        return (0, fp_js_1.unwrapAsync)((0, collectionsDocsBulkUpsert_js_1.collectionsDocsBulkUpsert)(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/commonjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uCAAyC;AACzC,uEAAiE;AACjE,uEAAiE;AACjE,iEAA2D;AAC3D,mEAA6D;AAC7D,qEAA+D;AAC/D,uEAAiE;AACjE,uFAAiF;AACjF,+EAAyE;AACzE,6EAAuE;AACvE,6FAAuF;AACvF,mFAA6E;AAC7E,+EAAyE;AACzE,+EAAyE;AAIzE,yCAA4C;AAO5C;;;GAGG;AACH,MAAa,cAAe,SAAQ,sBAAY;IAC9C;;;OAGG;IACH,UAAU,CAAC,cAAsB;QAC/B,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAwB;QAC5C,OAAO,IAAA,mBAAW,EAAC,IAAA,oCAAe,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAA2C,EAC3C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,wCAAiB,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;CACF;AAzBD,wCAyBC;AAED;;GAEG;AACH,MAAa,gBAAgB;IAC3B,YACmB,MAAoB,EAC5B,cAAsB;QADd,WAAM,GAAN,MAAM,CAAc;QAC5B,mBAAc,GAAd,cAAc,CAAQ;QA+DxB,SAAI,GAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IA9DlF,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAwB;QAChC,OAAO,IAAA,mBAAW,EAChB,IAAA,kCAAc,EAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAC9E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,WAAmD,EACnD,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,wCAAiB,EACf,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW;SACZ,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAwB;QACnC,OAAO,IAAA,mBAAW,EAChB,IAAA,wCAAiB,EACf,IAAI,CAAC,MAAM,EACX,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,EACvC,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,WAAkD,EAClD,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,sCAAgB,EACd,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW;SACZ,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;CAGF;AAnED,4CAmEC;AAED;;GAEG;AACH,MAAM,cAAc;IAClB,YACmB,MAAoB,EACpB,cAAsB;QADtB,WAAM,GAAN,MAAM,CAAc;QACpB,mBAAc,GAAd,cAAc,CAAQ;IACtC,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,MAA8C,EAC9C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,oDAAuB,EACrB,IAAI,CAAC,MAAM,EACX,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,GAAG,MAAM,EAAE,EAClD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,IAA8C,EAC9C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,gDAAqB,EACnB,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI;SAClB,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,IAA8C,EAC9C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,gDAAqB,EACnB,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI;SAClB,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,IAAsC,EACtC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,gDAAqB,EACnB,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI;SAClB,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,IAAqC,EACrC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,8CAAoB,EAClB,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI;SAClB,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAwB;QAC1C,OAAO,IAAA,mBAAW,EAChB,IAAA,8DAA4B,EAC1B,IAAI,CAAC,MAAM,EACX,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,EACvC,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,IAA2B,EAC3B,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAChB,IAAA,wDAAyB,EACvB,IAAI,CAAC,MAAM,EACX;YACE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI;SAClB,EACD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/commonjs/index.d.ts

@@ -3,4 +3,6 @@ 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 */
+export { LambdaDBClient, CollectionHandle, type RequestOptions as ClientRequestOptions, } 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"}
+{"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,KAAK,cAAc,IAAI,oBAAoB,GAC5C,MAAM,aAAa,CAAC"}

package/dist/commonjs/index.js

@@ -39,10 +39,14 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTTPClient = exports.files = void 0;
+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 */
+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; } });
 //# 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"}
+{"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,yCAIqB;AAHnB,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA"}