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

package/dist/esm/lib/queryInput.js

@@ -0,0 +1,15 @@
+/**
+ * Helper to build QueryCollectionInput for collection.query() / collection.querySafe().
+ */
+/**
+ * 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 function createQueryInput(query, options) {
+    return { query, ...options };
+}
+//# sourceMappingURL=queryInput.js.map

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

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

package/dist/esm/types/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Public API error types for the collection-scoped client.
+ * Re-exports error classes and defines per-operation error unions for Safe methods.
+ */
+import type * as errors from "../models/errors/index.js";
+import type { LambdaDBError } from "../models/errors/lambdadberror.js";
+import type { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import type { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import type { ConnectionError, RequestAbortedError, RequestTimeoutError, InvalidRequestError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+export { BadRequestError, UnauthenticatedError, ResourceNotFoundError, ResourceAlreadyExistsError, TooManyRequestsError, InternalServerError, LambdaDBError, LambdaDBDefaultError, ResponseValidationError, SDKValidationError, } from "../models/errors/index.js";
+export { HTTPClientError, ConnectionError, RequestAbortedError, RequestTimeoutError, InvalidRequestError, UnexpectedClientError, } from "../models/errors/httpclienterrors.js";
+export type LambdaDBClientError = LambdaDBError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError;
+/** Errors that can occur when listing collections, getting a collection, deleting a collection, or getting bulk upsert info. */
+export type ListCollectionsError = errors.UnauthenticatedError | errors.ResourceNotFoundError | errors.TooManyRequestsError | errors.InternalServerError | LambdaDBClientError;
+/** Errors that can occur when creating a collection. */
+export type CreateCollectionError = errors.BadRequestError | errors.UnauthenticatedError | errors.ResourceAlreadyExistsError | errors.TooManyRequestsError | errors.InternalServerError | LambdaDBClientError;
+/** Errors that can occur when getting a collection. */
+export type GetCollectionError = ListCollectionsError;
+/** Errors that can occur when updating a collection. */
+export type UpdateCollectionError = errors.BadRequestError | errors.UnauthenticatedError | errors.ResourceNotFoundError | errors.TooManyRequestsError | errors.InternalServerError | LambdaDBClientError;
+/** Errors that can occur when deleting a collection. */
+export type DeleteCollectionError = ListCollectionsError;
+/** Errors that can occur when querying a collection. */
+export type QueryCollectionError = UpdateCollectionError;
+/** Errors that can occur when listing, upserting, updating, deleting, or fetching docs, or when calling bulkUpsert. */
+export type ListDocsError = UpdateCollectionError;
+export type UpsertDocsError = UpdateCollectionError;
+export type UpdateDocsError = UpdateCollectionError;
+export type DeleteDocsError = UpdateCollectionError;
+export type FetchDocsError = UpdateCollectionError;
+export type BulkUpsertDocsError = UpdateCollectionError;
+/** Errors that can occur when getting bulk upsert docs info. */
+export type GetBulkUpsertDocsError = ListCollectionsError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAG9C,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CAAC;AAIvB,gIAAgI;AAChI,MAAM,MAAM,oBAAoB,GAC5B,MAAM,CAAC,oBAAoB,GAC3B,MAAM,CAAC,qBAAqB,GAC5B,MAAM,CAAC,oBAAoB,GAC3B,MAAM,CAAC,mBAAmB,GAC1B,mBAAmB,CAAC;AAExB,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAC7B,MAAM,CAAC,eAAe,GACtB,MAAM,CAAC,oBAAoB,GAC3B,MAAM,CAAC,0BAA0B,GACjC,MAAM,CAAC,oBAAoB,GAC3B,MAAM,CAAC,mBAAmB,GAC1B,mBAAmB,CAAC;AAExB,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEtD,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAC7B,MAAM,CAAC,eAAe,GACtB,MAAM,CAAC,oBAAoB,GAC3B,MAAM,CAAC,qBAAqB,GAC5B,MAAM,CAAC,oBAAoB,GAC3B,MAAM,CAAC,mBAAmB,GAC1B,mBAAmB,CAAC;AAExB,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEzD,uHAAuH;AACvH,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AACpD,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AACpD,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC;AACnD,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC"}

package/dist/esm/types/errors.js

@@ -0,0 +1,8 @@
+/**
+ * Public API error types for the collection-scoped client.
+ * Re-exports error classes and defines per-operation error unions for Safe methods.
+ */
+// ---- Re-export error classes for instanceof checks and typing ----
+export { BadRequestError, UnauthenticatedError, ResourceNotFoundError, ResourceAlreadyExistsError, TooManyRequestsError, InternalServerError, LambdaDBError, LambdaDBDefaultError, ResponseValidationError, SDKValidationError, } from "../models/errors/index.js";
+export { HTTPClientError, ConnectionError, RequestAbortedError, RequestTimeoutError, InvalidRequestError, UnexpectedClientError, } from "../models/errors/httpclienterrors.js";
+//# sourceMappingURL=errors.js.map

package/dist/esm/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,qEAAqE;AACrE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC"}

package/dist/esm/types/public.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Public API types for the collection-scoped client.
+ * Only request-body–level inputs and method return types are exposed.
+ */
+export type { CreateCollectionRequest as CreateCollectionInput } from "../models/operations/createcollection.js";
+export type { UpdateCollectionRequestBody as UpdateCollectionInput } from "../models/operations/updatecollection.js";
+export type { QueryCollectionRequestBody as QueryCollectionInput } from "../models/operations/querycollection.js";
+export type { UpsertDocsRequestBody as UpsertDocsInput } from "../models/operations/upsertdocs.js";
+export type { UpdateDocsRequestBody as UpdateDocsInput } from "../models/operations/updatedocs.js";
+export type { DeleteDocsRequestBody as DeleteDocsInput } from "../models/operations/deletedocs.js";
+export type { FetchDocsRequestBody as FetchDocsInput } from "../models/operations/fetchdocs.js";
+export type { BulkUpsertDocsRequestBody as BulkUpsertInput } from "../models/operations/bulkupsertdocs.js";
+import type { ListDocsRequest } from "../models/operations/listdocs.js";
+/** Parameters for listing documents (size, pageToken). */
+export type ListDocsInput = Pick<ListDocsRequest, "size" | "pageToken">;
+export type { ListCollectionsResponse } from "../models/operations/listcollections.js";
+export type { CreateCollectionResponse } from "../models/operations/createcollection.js";
+export type { GetCollectionResponse } from "../models/operations/getcollection.js";
+export type { UpdateCollectionResponse } from "../models/operations/updatecollection.js";
+export type { QueryCollectionResponse, QueryCollectionDoc, } from "../models/operations/querycollection.js";
+export type { ListDocsResponse } from "../models/operations/listdocs.js";
+export type { MessageResponse } from "../models/index.js";
+export type { FetchDocsResponse, FetchDocsDoc, } from "../models/operations/fetchdocs.js";
+export type { GetBulkUpsertDocsResponse } from "../models/operations/getbulkupsertdocs.js";
+export type { IndexConfigsUnion, PartitionConfig, PartitionFilter, FieldsSelectorUnion, CollectionResponse, } from "../models/index.js";
+//# sourceMappingURL=public.d.ts.map

package/dist/esm/types/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/types/public.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,uBAAuB,IAAI,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjH,YAAY,EAAE,2BAA2B,IAAI,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACrH,YAAY,EAAE,0BAA0B,IAAI,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAClH,YAAY,EAAE,qBAAqB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,qBAAqB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,qBAAqB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,oBAAoB,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,yBAAyB,IAAI,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;AAGxE,YAAY,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EACV,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,iBAAiB,EACjB,YAAY,GACb,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAG3F,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/esm/types/public.js

@@ -0,0 +1,6 @@
+/**
+ * Public API types for the collection-scoped client.
+ * Only request-body–level inputs and method return types are exposed.
+ */
+export {};
+//# sourceMappingURL=public.js.map

package/dist/esm/types/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/types/public.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/examples/collectionScoped.example.ts

@@ -9,7 +9,11 @@ dotenv.config();
  *   npm run build && npx tsx collectionScoped.example.ts
  */
 
-import { LambdaDBClient } from "@functional-systems/lambdadb";
+import {
+  LambdaDBClient,
+  type ListDocsInput,
+  type ListDocsResponse,
+} from "@functional-systems/lambdadb";
 
 const client = new LambdaDBClient({
   projectApiKey: process.env.LAMBDADB_PROJECT_API_KEY ?? "<YOUR_PROJECT_API_KEY>",
@@ -24,8 +28,10 @@ async function main() {
   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 });
+  // List documents (no collectionName in the call); use public types for params and result
+  const listParams: ListDocsInput = { size: 10 };
+  const listResult: ListDocsResponse = await collection.docs.list(listParams);
+  const { docs, total, nextPageToken } = listResult;
   console.log(`Documents: ${docs.length} of ${total}`, nextPageToken ? "(has more)" : "");
 }
 

package/examples/collectionsList.example.ts

@@ -8,14 +8,17 @@ dotenv.config();
  *   npm run build && npx tsx collectionsList.example.ts
  */
 
-import { LambdaDBClient } from "@functional-systems/lambdadb";
+import {
+  LambdaDBClient,
+  type ListCollectionsResponse,
+} from "@functional-systems/lambdadb";
 
 const client = new LambdaDBClient({
   projectApiKey: process.env.LAMBDADB_PROJECT_API_KEY ?? "<YOUR_PROJECT_API_KEY>",
 });
 
 async function main() {
-  const result = await client.listCollections();
+  const result: ListCollectionsResponse = await client.listCollections();
   console.log(result);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.3.0-dev.2",
+  "version": "0.3.0-dev.3",
   "author": "Functional Systems, Inc.",
   "homepage": "https://github.com/lambdadb/lambdadb-typescript-client#readme",
   "license": "Apache-2.0",