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

package/dist/esm/client.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 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 { SDKOptions } from "./lib/config.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 };
+/** Default base URL for the LambdaDB API. */
+export declare const DEFAULT_BASE_URL = "https://api.lambdadb.ai";
+/** Default project name when not specified. */
+export declare const DEFAULT_PROJECT_NAME = "playground";
+/**
+ * Options for LambdaDBClient. Supports baseUrl + projectName (recommended) or
+ * legacy projectHost / serverURL. When neither serverURL nor projectHost is set,
+ * the base URL is built as `${baseUrl}/projects/${projectName}`.
+ */
+export type LambdaDBClientOptions = SDKOptions & {
+    /**
+     * API base URL (e.g. https://api.lambdadb.ai). Default: "https://api.lambdadb.ai"
+     */
+    baseUrl?: string;
+    /**
+     * Project name (path segment under /projects/). Default: "playground"
+     */
+    projectName?: string;
+};
+/**
+ * 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 {
+    constructor(options?: LambdaDBClientOptions);
+    /**
+     * 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":"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"}

package/dist/esm/client.js

@@ -0,0 +1,177 @@
+/**
+ * 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";
+/** Default base URL for the LambdaDB API. */
+export const DEFAULT_BASE_URL = "https://api.lambdadb.ai";
+/** Default project name when not specified. */
+export const DEFAULT_PROJECT_NAME = "playground";
+function normalizeClientOptions(options = {}) {
+    const { baseUrl = DEFAULT_BASE_URL, projectName = DEFAULT_PROJECT_NAME, serverURL, projectHost, ...rest } = options;
+    if (serverURL !== undefined && serverURL !== null) {
+        return { ...rest, serverURL };
+    }
+    if (projectHost !== undefined && projectHost !== null) {
+        return { ...rest, projectHost };
+    }
+    const base = baseUrl.replace(/\/+$/, "");
+    const serverURLFromBase = `${base}/projects/${encodeURIComponent(projectName)}`;
+    return { ...rest, serverURL: serverURLFromBase };
+}
+/**
+ * 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 {
+    constructor(options) {
+        super(normalizeClientOptions(options));
+    }
+    /**
+     * 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, DEFAULT_BASE_URL, DEFAULT_PROJECT_NAME, type RequestOptions as ClientRequestOptions, type LambdaDBClientOptions, } 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,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,cAAc,IAAI,oBAAoB,EAC3C,KAAK,qBAAqB,GAC3B,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, DEFAULT_BASE_URL, DEFAULT_PROJECT_NAME, } 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,EAChB,gBAAgB,EAChB,oBAAoB,GAGrB,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.1",
   "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",