@functional-systems/lambdadb 0.2.1 → 0.3.0-dev

package/dist/esm/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/esm/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/esm/client.js

@@ -0,0 +1,158 @@
+/**
+ * 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 { collectionsCreate } from "./funcs/collectionsCreate.js";
+import { collectionsDelete } from "./funcs/collectionsDelete.js";
+import { collectionsGet } from "./funcs/collectionsGet.js";
+import { collectionsList } from "./funcs/collectionsList.js";
+import { collectionsQuery } from "./funcs/collectionsQuery.js";
+import { collectionsUpdate } from "./funcs/collectionsUpdate.js";
+import { collectionsDocsBulkUpsert } from "./funcs/collectionsDocsBulkUpsert.js";
+import { collectionsDocsDelete } from "./funcs/collectionsDocsDelete.js";
+import { collectionsDocsFetch } from "./funcs/collectionsDocsFetch.js";
+import { collectionsDocsGetBulkUpsert } from "./funcs/collectionsDocsGetBulkUpsert.js";
+import { collectionsDocsListDocs } from "./funcs/collectionsDocsListDocs.js";
+import { collectionsDocsUpdate } from "./funcs/collectionsDocsUpdate.js";
+import { collectionsDocsUpsert } from "./funcs/collectionsDocsUpsert.js";
+import { unwrapAsync } from "./types/fp.js";
+/**
+ * Client with collection-scoped API. Prefer this over the legacy
+ * `LambdaDB` when you want to avoid passing collectionName on every call.
+ */
+export 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) {
+        return new CollectionHandle(this, collectionName);
+    }
+    /**
+     * List all collections in the project.
+     */
+    async listCollections(options) {
+        return unwrapAsync(collectionsList(this, options));
+    }
+    /**
+     * Create a new collection.
+     */
+    async createCollection(request, options) {
+        return unwrapAsync(collectionsCreate(this, request, options));
+    }
+}
+/**
+ * Handle for a single collection. All methods operate on this collection.
+ */
+export 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 unwrapAsync(collectionsGet(this.client, { collectionName: this.collectionName }, options));
+    }
+    /**
+     * Configure (update) this collection.
+     */
+    async update(requestBody, options) {
+        return unwrapAsync(collectionsUpdate(this.client, {
+            collectionName: this.collectionName,
+            requestBody,
+        }, options));
+    }
+    /**
+     * Delete this collection.
+     */
+    async delete(options) {
+        return unwrapAsync(collectionsDelete(this.client, { collectionName: this.collectionName }, options));
+    }
+    /**
+     * Search this collection with a query.
+     */
+    async query(requestBody, options) {
+        return unwrapAsync(collectionsQuery(this.client, {
+            collectionName: this.collectionName,
+            requestBody,
+        }, options));
+    }
+}
+/**
+ * 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 unwrapAsync(collectionsDocsListDocs(this.client, { collectionName: this.collectionName, ...params }, options));
+    }
+    /**
+     * Upsert documents. Max payload 6MB.
+     */
+    async upsert(body, options) {
+        return unwrapAsync(collectionsDocsUpsert(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Update documents (each doc must have id). Max payload 6MB.
+     */
+    async update(body, options) {
+        return unwrapAsync(collectionsDocsUpdate(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Delete documents by ids and/or filter.
+     */
+    async delete(body, options) {
+        return unwrapAsync(collectionsDocsDelete(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Fetch documents by IDs (max 100).
+     */
+    async fetch(body, options) {
+        return unwrapAsync(collectionsDocsFetch(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+    /**
+     * Get presigned URL and metadata for bulk upload (up to 200MB).
+     */
+    async getBulkUpsert(options) {
+        return unwrapAsync(collectionsDocsGetBulkUpsert(this.client, { collectionName: this.collectionName }, options));
+    }
+    /**
+     * Trigger bulk upsert with an object key from getBulkUpsert().
+     */
+    async bulkUpsert(body, options) {
+        return unwrapAsync(collectionsDocsBulkUpsert(this.client, {
+            collectionName: this.collectionName,
+            requestBody: body,
+        }, options));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/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/esm/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/esm/index.js

@@ -5,4 +5,6 @@ export * from "./lib/config.js";
 export * as files from "./lib/files.js";
 export { HTTPClient } from "./lib/http.js";
 export * from "./sdk/sdk.js";
+/** Collection-scoped client (recommended). See docs/REFACTORING_PROPOSAL.md */
+export { LambdaDBClient, CollectionHandle, } from "./client.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,cAAc,cAAc,CAAC;AAE7B,+EAA+E;AAC/E,OAAO,EACL,cAAc,EACd,gBAAgB,GAEjB,MAAM,aAAa,CAAC"}

package/examples/collectionScoped.example.ts

@@ -0,0 +1,32 @@
+import dotenv from "dotenv";
+dotenv.config();
+
+/**
+ * Example: collection-scoped API — get a collection handle once, then call
+ * methods without passing collectionName every time.
+ *
+ * Run from the examples directory:
+ *   npm run build && npx tsx collectionScoped.example.ts
+ */
+
+import { LambdaDBClient } from "@functional-systems/lambdadb";
+
+const client = new LambdaDBClient({
+  projectApiKey: process.env.LAMBDADB_PROJECT_API_KEY ?? "<YOUR_PROJECT_API_KEY>",
+});
+
+const COLLECTION_NAME = "my-collection";
+
+async function main() {
+  const collection = client.collection(COLLECTION_NAME);
+
+  // Collection metadata
+  const meta = await collection.get();
+  console.log("Collection:", meta);
+
+  // List documents (no collectionName in the call)
+  const { docs, total, nextPageToken } = await collection.docs.list({ size: 10 });
+  console.log(`Documents: ${docs.length} of ${total}`, nextPageToken ? "(has more)" : "");
+}
+
+main().catch(console.error);

package/examples/collectionsList.example.ts

@@ -1,25 +1,21 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
 import dotenv from "dotenv";
 dotenv.config();
+
 /**
- * Example usage of the @functional-systems/lambdadb SDK
+ * Example: list collections using the recommended LambdaDBClient.
  *
- * To run this example from the examples directory:
- * npm run build && npx tsx collectionsList.example.ts
+ * Run from the examples directory:
+ *   npm run build && npx tsx collectionsList.example.ts
  */
 
-import { LambdaDB } from "@functional-systems/lambdadb";
+import { LambdaDBClient } from "@functional-systems/lambdadb";
 
-const lambdaDB = new LambdaDB({
-  projectApiKey: "<YOUR_PROJECT_API_KEY>",
+const client = new LambdaDBClient({
+  projectApiKey: process.env.LAMBDADB_PROJECT_API_KEY ?? "<YOUR_PROJECT_API_KEY>",
 });
 
 async function main() {
-  const result = await lambdaDB.collections.list();
-
+  const result = await client.listCollections();
   console.log(result);
 }
 

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.2.1",
+  "version": "0.3.0-dev",
   "author": "Functional Systems, Inc.",
   "homepage": "https://github.com/lambdadb/lambdadb-typescript-client#readme",
   "license": "Apache-2.0",
-  "repository": "https://github.com/lambdadb/lambdadb-typescript-client.git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lambdadb/lambdadb-typescript-client.git"
+  },
   "type": "module",
   "tshy": {
     "sourceDialects": [
@@ -27,7 +30,6 @@
     "build": "tshy",
     "prepublishOnly": "npm run build"
   },
-  "peerDependencies": {},
   "devDependencies": {
     "@eslint/js": "^9.19.0",
     "eslint": "^9.19.0",

package/src/client.ts

@@ -0,0 +1,272 @@
+/**
+ * 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 { collectionsCreate } from "./funcs/collectionsCreate.js";
+import { collectionsDelete } from "./funcs/collectionsDelete.js";
+import { collectionsGet } from "./funcs/collectionsGet.js";
+import { collectionsList } from "./funcs/collectionsList.js";
+import { collectionsQuery } from "./funcs/collectionsQuery.js";
+import { collectionsUpdate } from "./funcs/collectionsUpdate.js";
+import { collectionsDocsBulkUpsert } from "./funcs/collectionsDocsBulkUpsert.js";
+import { collectionsDocsDelete } from "./funcs/collectionsDocsDelete.js";
+import { collectionsDocsFetch } from "./funcs/collectionsDocsFetch.js";
+import { collectionsDocsGetBulkUpsert } from "./funcs/collectionsDocsGetBulkUpsert.js";
+import { collectionsDocsListDocs } from "./funcs/collectionsDocsListDocs.js";
+import { collectionsDocsUpdate } from "./funcs/collectionsDocsUpdate.js";
+import { collectionsDocsUpsert } from "./funcs/collectionsDocsUpsert.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";
+import { unwrapAsync } from "./types/fp.js";
+
+export type { RequestOptions };
+
+// Re-export common types for facade users
+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 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 {
+    return new CollectionHandle(this, collectionName);
+  }
+
+  /**
+   * List all collections in the project.
+   */
+  async listCollections(options?: RequestOptions) {
+    return unwrapAsync(collectionsList(this, options));
+  }
+
+  /**
+   * Create a new collection.
+   */
+  async createCollection(
+    request: operations.CreateCollectionRequest,
+    options?: RequestOptions,
+  ) {
+    return unwrapAsync(collectionsCreate(this, request, options));
+  }
+}
+
+/**
+ * Handle for a single collection. All methods operate on this collection.
+ */
+export class CollectionHandle {
+  constructor(
+    private readonly client: LambdaDBCore,
+    readonly collectionName: string,
+  ) {}
+
+  /**
+   * Get metadata of this collection.
+   */
+  async get(options?: RequestOptions) {
+    return unwrapAsync(
+      collectionsGet(this.client, { collectionName: this.collectionName }, options),
+    );
+  }
+
+  /**
+   * Configure (update) this collection.
+   */
+  async update(
+    requestBody: operations.UpdateCollectionRequestBody,
+    options?: RequestOptions,
+  ) {
+    return unwrapAsync(
+      collectionsUpdate(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody,
+        },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Delete this collection.
+   */
+  async delete(options?: RequestOptions) {
+    return unwrapAsync(
+      collectionsDelete(
+        this.client,
+        { collectionName: this.collectionName },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Search this collection with a query.
+   */
+  async query(
+    requestBody: operations.QueryCollectionRequestBody,
+    options?: RequestOptions,
+  ) {
+    return unwrapAsync(
+      collectionsQuery(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody,
+        },
+        options,
+      ),
+    );
+  }
+
+  readonly docs: CollectionDocs = new CollectionDocs(this.client, this.collectionName);
+}
+
+/**
+ * Document operations scoped to a collection.
+ */
+class CollectionDocs {
+  constructor(
+    private readonly client: LambdaDBCore,
+    private readonly collectionName: string,
+  ) {}
+
+  /**
+   * List documents in the collection.
+   */
+  async list(
+    params?: { size?: number; pageToken?: string },
+    options?: RequestOptions,
+  ) {
+    return unwrapAsync(
+      collectionsDocsListDocs(
+        this.client,
+        { collectionName: this.collectionName, ...params },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Upsert documents. Max payload 6MB.
+   */
+  async upsert(
+    body: { docs: Array<Record<string, unknown>> },
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(
+      collectionsDocsUpsert(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody: body,
+        },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Update documents (each doc must have id). Max payload 6MB.
+   */
+  async update(
+    body: { docs: Array<Record<string, unknown>> },
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(
+      collectionsDocsUpdate(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody: body,
+        },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Delete documents by ids and/or filter.
+   */
+  async delete(
+    body: operations.DeleteDocsRequestBody,
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(
+      collectionsDocsDelete(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody: body,
+        },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Fetch documents by IDs (max 100).
+   */
+  async fetch(
+    body: operations.FetchDocsRequestBody,
+    options?: RequestOptions,
+  ) {
+    return unwrapAsync(
+      collectionsDocsFetch(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody: body,
+        },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Get presigned URL and metadata for bulk upload (up to 200MB).
+   */
+  async getBulkUpsert(options?: RequestOptions) {
+    return unwrapAsync(
+      collectionsDocsGetBulkUpsert(
+        this.client,
+        { collectionName: this.collectionName },
+        options,
+      ),
+    );
+  }
+
+  /**
+   * Trigger bulk upsert with an object key from getBulkUpsert().
+   */
+  async bulkUpsert(
+    body: { objectKey: string },
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(
+      collectionsDocsBulkUpsert(
+        this.client,
+        {
+          collectionName: this.collectionName,
+          requestBody: body,
+        },
+        options,
+      ),
+    );
+  }
+}

package/src/index.ts

@@ -7,3 +7,10 @@ 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";