@functional-systems/lambdadb 0.5.0-rc.1 → 0.5.0-rc.2

package/src/funcs/collectionsUpdate.ts

@@ -40,6 +40,11 @@ export function collectionsUpdate(
     | errors.ResourceNotFoundError
     | errors.TooManyRequestsError
     | errors.InternalServerError
+    | errors.CatalogConflictError
+    | errors.PayloadTooLargeError
+    | errors.BadGatewayError
+    | errors.ServiceUnavailableError
+    | errors.GatewayTimeoutError
     | LambdaDBError
     | ResponseValidationError
     | ConnectionError
@@ -70,6 +75,11 @@ async function $do(
       | errors.ResourceNotFoundError
       | errors.TooManyRequestsError
       | errors.InternalServerError
+      | errors.CatalogConflictError
+      | errors.PayloadTooLargeError
+      | errors.BadGatewayError
+      | errors.ServiceUnavailableError
+      | errors.GatewayTimeoutError
       | LambdaDBError
       | ResponseValidationError
       | ConnectionError
@@ -173,6 +183,11 @@ async function $do(
     | errors.ResourceNotFoundError
     | errors.TooManyRequestsError
     | errors.InternalServerError
+    | errors.CatalogConflictError
+    | errors.PayloadTooLargeError
+    | errors.BadGatewayError
+    | errors.ServiceUnavailableError
+    | errors.GatewayTimeoutError
     | LambdaDBError
     | ResponseValidationError
     | ConnectionError
@@ -186,8 +201,10 @@ async function $do(
     M.jsonErr(400, errors.BadRequestError$inboundSchema),
     M.jsonErr(401, errors.UnauthenticatedError$inboundSchema),
     M.jsonErr(404, errors.ResourceNotFoundError$inboundSchema),
+    M.jsonErr(409, errors.CatalogConflictError$inboundSchema),
     M.jsonErr(429, errors.TooManyRequestsError$inboundSchema),
     M.jsonErr(500, errors.InternalServerError$inboundSchema),
+    ...M.gatewayErrorMatchers(),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req, { extraFields: responseFields });

package/src/lib/collectionContract.ts

@@ -0,0 +1,42 @@
+import * as z from "zod/v3";
+
+// Mirrors Java String.isBlank, which is the server-side contract. In
+// particular, NBSP (U+00A0), figure space (U+2007), and narrow NBSP (U+202F)
+// are not considered blank by Java.
+const javaWhitespaceCodePoints = new Set([
+  ...Array.from({ length: 5 }, (_, index) => 0x0009 + index),
+  ...Array.from({ length: 5 }, (_, index) => 0x001c + index),
+  0x1680,
+  ...Array.from({ length: 7 }, (_, index) => 0x2000 + index),
+  ...Array.from({ length: 3 }, (_, index) => 0x2008 + index),
+  0x2028,
+  0x2029,
+  0x205f,
+  0x3000,
+]);
+
+function isJavaBlank(value: string): boolean {
+  return Array.from(value).every((character) =>
+    javaWhitespaceCodePoints.has(character.codePointAt(0) ?? -1)
+  );
+}
+
+const collectionTagValueSchema = z.string()
+  .min(1)
+  .max(127)
+  .regex(/^[^:#,]+$/)
+  .refine((value) => !isJavaBlank(value), {
+    message: "Collection tag values must contain a non-whitespace character",
+  });
+
+/** @internal */
+export const collectionTagsSchema = z.record(collectionTagValueSchema)
+  .refine((value) => Object.keys(value).length <= 5, {
+    message: "Collection tags support at most five entries",
+  })
+  .refine(
+    (value) => Object.keys(value).every((key) =>
+      /^[A-Za-z0-9_.-]{1,63}$/.test(key)
+    ),
+    { message: "Invalid collection tag key" },
+  );

package/src/lib/config.ts

@@ -73,8 +73,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.1",
-  sdkVersion: "0.5.0-rc.1",
+  sdkVersion: "0.5.0-rc.2",
   genVersion: "2.798.0",
   userAgent:
-    "speakeasy-sdk/typescript 0.5.0-rc.1 2.798.0 1.1.1 @functional-systems/lambdadb",
+    "speakeasy-sdk/typescript 0.5.0-rc.2 2.798.0 1.1.1 @functional-systems/lambdadb",
 } as const;

package/src/lib/matchers.ts

@@ -3,6 +3,16 @@
  */
 
 import { LambdaDBDefaultError } from "../models/errors/lambdadbdefaulterror.js";
+import {
+  BadGatewayError$inboundSchema,
+  GatewayTimeoutError$inboundSchema,
+  PayloadTooLargeError$inboundSchema,
+  ServiceUnavailableError$inboundSchema,
+  type BadGatewayError,
+  type GatewayTimeoutError,
+  type PayloadTooLargeError,
+  type ServiceUnavailableError,
+} from "../models/errors/gatewayerrors.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { ERR, OK, Result } from "../types/fp.js";
 import { matchResponse, matchStatusCode, StatusCodePredicate } from "./http.js";
@@ -167,6 +177,23 @@ export function fail(codes: StatusCodePredicate): FailMatcher {
   return { enc: "fail", codes };
 }
 
+/** Standard JSON Gateway failures shared by public API operations. */
+export function gatewayErrorMatchers(): Array<
+  ErrorMatcher<
+    | PayloadTooLargeError
+    | BadGatewayError
+    | ServiceUnavailableError
+    | GatewayTimeoutError
+  >
+> {
+  return [
+    jsonErr(413, PayloadTooLargeError$inboundSchema),
+    jsonErr(502, BadGatewayError$inboundSchema),
+    jsonErr(503, ServiceUnavailableError$inboundSchema),
+    jsonErr(504, GatewayTimeoutError$inboundSchema),
+  ];
+}
+
 export type MatchedValue<Matchers> = Matchers extends Matcher<infer T, any>[]
   ? T
   : never;

package/src/models/collectionresponse.ts

@@ -35,7 +35,8 @@ export type CollectionResponse = {
    */
   numPartitions: number;
   /**
-   * Total number of documents.
+   * Document count in the default main Branch's committed head. This is not a
+   * sum across Branches or the count of a selected ref.
    */
   numDocs: number;
   /** Default writable Branch. */
@@ -51,7 +52,9 @@ export type CollectionResponse = {
    */
   updatedAt: number;
   /**
-   * Collection data last update time in milliseconds since the Unix epoch.
+   * Last data update recorded in the default main Branch's committed head, in
+   * milliseconds since the Unix epoch. Commits without data mutations retain
+   * the previous value. Absent before a committed head exists.
    */
   dataUpdatedAt?: number | undefined;
 };
@@ -64,7 +67,10 @@ export const CollectionResponse$inboundSchema: z.ZodType<
 > = z.object({
   projectName: z.string(),
   collectionName: z.string(),
-  indexConfigs: z.record(IndexConfigsUnion$inboundSchema),
+  indexConfigs: z.record(IndexConfigsUnion$inboundSchema).refine(
+    (value) => Object.keys(value).length > 0,
+    { message: "Collection indexConfigs must contain at least one field" },
+  ),
   description: z.string(),
   tags: z.record(z.string()),
   partitionConfig: nullToUndefined(PartitionConfig$inboundSchema.optional()),

package/src/models/errors/gatewayerrors.ts

@@ -0,0 +1,104 @@
+import * as z from "zod/v3";
+
+import { nullToUndefined } from "../../lib/schemas.js";
+import { LambdaDBError } from "./lambdadberror.js";
+
+export type GatewayErrorData = {
+  message?: string | undefined;
+};
+
+type HTTPMeta = {
+  response: Response;
+  request: Request;
+  body: string;
+};
+
+class GatewayResponseError extends LambdaDBError {
+  /** The structured JSON error returned by the Gateway. */
+  readonly data$: GatewayErrorData;
+
+  protected constructor(name: string, err: GatewayErrorData, httpMeta: HTTPMeta) {
+    super(
+      err.message || `API error occurred: ${JSON.stringify(err)}`,
+      httpMeta,
+    );
+    this.data$ = err;
+    this.name = name;
+  }
+}
+
+/** HTTP 409 conditional catalog conflict. */
+export class CatalogConflictError extends GatewayResponseError {
+  constructor(err: GatewayErrorData, httpMeta: HTTPMeta) {
+    super("CatalogConflictError", err, httpMeta);
+  }
+}
+
+/** HTTP 413 Gateway transport limit exceeded. */
+export class PayloadTooLargeError extends GatewayResponseError {
+  constructor(err: GatewayErrorData, httpMeta: HTTPMeta) {
+    super("PayloadTooLargeError", err, httpMeta);
+  }
+}
+
+/** HTTP 502 unexpected downstream failure. */
+export class BadGatewayError extends GatewayResponseError {
+  constructor(err: GatewayErrorData, httpMeta: HTTPMeta) {
+    super("BadGatewayError", err, httpMeta);
+  }
+}
+
+/** HTTP 503 transient catalog or storage dependency failure. */
+export class ServiceUnavailableError extends GatewayResponseError {
+  constructor(err: GatewayErrorData, httpMeta: HTTPMeta) {
+    super("ServiceUnavailableError", err, httpMeta);
+  }
+}
+
+/** HTTP 504 Gateway request deadline exceeded. */
+export class GatewayTimeoutError extends GatewayResponseError {
+  constructor(err: GatewayErrorData, httpMeta: HTTPMeta) {
+    super("GatewayTimeoutError", err, httpMeta);
+  }
+}
+
+type GatewayErrorConstructor<T extends GatewayResponseError> = new (
+  err: GatewayErrorData,
+  httpMeta: HTTPMeta,
+) => T;
+
+function gatewayErrorSchema<T extends GatewayResponseError>(
+  ErrorClass: GatewayErrorConstructor<T>,
+): z.ZodType<T, z.ZodTypeDef, unknown> {
+  return z.object({
+    message: nullToUndefined(z.string().optional()),
+    request$: z.instanceof(Request),
+    response$: z.instanceof(Response),
+    body$: z.string(),
+  }).transform((value) =>
+    new ErrorClass(value, {
+      request: value.request$,
+      response: value.response$,
+      body: value.body$,
+    })
+  );
+}
+
+/** @internal */
+export const CatalogConflictError$inboundSchema = gatewayErrorSchema(
+  CatalogConflictError,
+);
+/** @internal */
+export const PayloadTooLargeError$inboundSchema = gatewayErrorSchema(
+  PayloadTooLargeError,
+);
+/** @internal */
+export const BadGatewayError$inboundSchema = gatewayErrorSchema(BadGatewayError);
+/** @internal */
+export const ServiceUnavailableError$inboundSchema = gatewayErrorSchema(
+  ServiceUnavailableError,
+);
+/** @internal */
+export const GatewayTimeoutError$inboundSchema = gatewayErrorSchema(
+  GatewayTimeoutError,
+);

package/src/models/errors/index.ts

@@ -3,6 +3,7 @@
  */
 
 export * from "./badrequesterror.js";
+export * from "./gatewayerrors.js";
 export * from "./httpclienterrors.js";
 export * from "./internalservererror.js";
 export * from "./lambdadbdefaulterror.js";

package/src/models/errors/lambdadberror.ts

@@ -15,6 +15,11 @@ export class LambdaDBError extends Error {
   /** Raw response */
   public readonly rawResponse: Response;
 
+  /** Optional Retry-After response header, commonly returned with HTTP 429. */
+  public get retryAfter(): string | undefined {
+    return this.headers.get("retry-after") ?? undefined;
+  }
+
   constructor(
     message: string,
     httpMeta: {

package/src/models/operations/bulkupsertdocs.ts

@@ -40,7 +40,7 @@ export const BulkUpsertDocsRequestBody$outboundSchema: z.ZodType<
   objectKey: z.string(),
   type: z.literal("application/json").default("application/json"),
   branch: z.string().regex(/^[a-zA-Z0-9_-]{3,52}$/).optional(),
-});
+}).strict();
 
 export function bulkUpsertDocsRequestBodyToJSON(
   bulkUpsertDocsRequestBody: BulkUpsertDocsRequestBody,

package/src/models/operations/createcollection.ts

@@ -3,6 +3,7 @@
  */
 
 import * as z from "zod/v3";
+import { collectionTagsSchema } from "../../lib/collectionContract.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
@@ -54,19 +55,15 @@ export const CreateCollectionRequest$outboundSchema: z.ZodType<
   CreateCollectionRequest
 > = z.object({
   collectionName: z.string().regex(/^[a-zA-Z0-9_-]{3,52}$/),
-  indexConfigs: z.record(models.IndexConfigsUnion$outboundSchema),
+  indexConfigs: z.record(models.IndexConfigsUnion$outboundSchema).refine(
+    (value) => Object.keys(value).length > 0,
+    { message: "Collection indexConfigs must contain at least one field" },
+  ),
   description: z.string().max(255).optional(),
-  tags: z.record(
-    z.string().min(1).max(127).regex(/^[^:#,]+$/),
-  ).refine((value) => Object.keys(value).length <= 5, {
-    message: "Collection tags support at most five entries",
-  }).refine(
-    (value) => Object.keys(value).every((key) => /^[A-Za-z0-9_.-]{1,63}$/.test(key)),
-    { message: "Invalid collection tag key" },
-  ).optional(),
+  tags: collectionTagsSchema.optional(),
   partitionConfig: models.PartitionConfig$outboundSchema.optional(),
   snapshotRetentionInDays: z.number().int().min(1).max(31).optional(),
-});
+}).strict();
 
 export function createCollectionRequestToJSON(
   createCollectionRequest: CreateCollectionRequest,

package/src/models/operations/deletedocs.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import * as models from "../index.js";
 
-export type DeleteDocsRequestBody = {
+type DeleteDocsRequestFields = {
   /**
    * A list of document IDs.
    */
@@ -20,6 +20,17 @@ export type DeleteDocsRequestBody = {
   branch?: string | undefined;
 };
 
+/** Delete by exactly one selector. partitionFilter only narrows that selector. */
+export type DeleteDocsRequestBody =
+  | (DeleteDocsRequestFields & {
+    ids: Array<string>;
+    filter?: never;
+  })
+  | (DeleteDocsRequestFields & {
+    ids?: never;
+    filter: { [k: string]: any };
+  });
+
 export type DeleteDocsRequest = {
   /**
    * Collection name.
@@ -29,13 +40,24 @@ export type DeleteDocsRequest = {
 };
 
 /** @internal */
-export type DeleteDocsRequestBody$Outbound = {
+type DeleteDocsRequestFields$Outbound = {
   ids?: Array<string> | undefined;
   filter?: { [k: string]: any } | undefined;
   partitionFilter?: models.PartitionFilter$Outbound | undefined;
   branch?: string | undefined;
 };
 
+/** @internal */
+export type DeleteDocsRequestBody$Outbound =
+  | (DeleteDocsRequestFields$Outbound & {
+    ids: Array<string>;
+    filter?: never;
+  })
+  | (DeleteDocsRequestFields$Outbound & {
+    ids?: never;
+    filter: { [k: string]: any };
+  });
+
 /** @internal */
 export const DeleteDocsRequestBody$outboundSchema: z.ZodType<
   DeleteDocsRequestBody$Outbound,
@@ -46,7 +68,14 @@ export const DeleteDocsRequestBody$outboundSchema: z.ZodType<
   filter: z.record(z.any()).optional(),
   partitionFilter: models.PartitionFilter$outboundSchema.optional(),
   branch: z.string().regex(/^[a-zA-Z0-9_-]{3,52}$/).optional(),
-});
+}).strict().refine(
+  (value) => (value.ids === undefined) !== (value.filter === undefined),
+  { message: "Specify exactly one of ids or filter", path: ["ids"] },
+) as unknown as z.ZodType<
+  DeleteDocsRequestBody$Outbound,
+  z.ZodTypeDef,
+  DeleteDocsRequestBody
+>;
 
 export function deleteDocsRequestBodyToJSON(
   deleteDocsRequestBody: DeleteDocsRequestBody,

package/src/models/operations/fetchdocs.ts

@@ -15,7 +15,7 @@ export type FetchDocsRequestBody = {
    */
   ids: Array<string>;
   /**
-   * If your application requires a strongly consistent read, set consistentRead to true. Although a strongly consistent read might take more time than an eventually consistent read, it always returns the last updated value.
+   * Overlay eligible pending writes on a directly selected Branch. Tag and Alias reads reject true, pending bulk imports are excluded, and an oversized pending overlay can return HTTP 429.
    */
   consistentRead?: boolean | undefined;
   /**
@@ -89,7 +89,7 @@ export const FetchDocsRequestBody$outboundSchema: z.ZodType<
   fields: models.FieldsSelectorUnion$outboundSchema.optional(),
   partitionFilter: models.PartitionFilter$outboundSchema.optional(),
   ref: models.ReadRef$schema.optional(),
-}).superRefine((value, context) => {
+}).strict().superRefine((value, context) => {
   if (value.consistentRead && value.ref != null && value.ref.kind !== "branch") {
     context.addIssue({
       code: z.ZodIssueCode.custom,

package/src/models/operations/listdocs.ts

@@ -19,7 +19,7 @@ export type ListDocsRequest = {
    */
   size?: number | undefined;
   /**
-   * Next page token.
+   * Opaque search position, not a Snapshot pin. Use one immutable Tag throughout a stable export.
    */
   pageToken?: string | undefined;
   /**
@@ -101,7 +101,7 @@ export type ListDocsExtendedRequestBody = {
    */
   size?: number | undefined;
   /**
-   * Next page token.
+   * Opaque search position, not a Snapshot pin. Use one immutable Tag throughout a stable export.
    */
   pageToken?: string | undefined;
   /**
@@ -153,7 +153,7 @@ export const ListDocsExtendedRequestBody$outboundSchema: z.ZodType<
   fields: models.FieldsSelectorUnion$outboundSchema.optional(),
   includeVectors: z.boolean().default(false),
   ref: models.ReadRef$schema.optional(),
-});
+}).strict();
 
 export function listDocsExtendedRequestBodyToJSON(
   listDocsExtendedRequestBody: ListDocsExtendedRequestBody,

package/src/models/operations/querycollection.ts

@@ -19,7 +19,7 @@ export type QueryCollectionRequestBody = {
    */
   query: { [k: string]: any };
   /**
-   * If your application requires a strongly consistent read, set consistentRead to true. Although a strongly consistent read might take more time than an eventually consistent read, it always returns the last updated value.
+   * Overlay eligible pending writes on a directly selected Branch. Tag and Alias reads reject true, pending bulk imports are excluded, and an oversized pending overlay can return HTTP 429.
    */
   consistentRead?: boolean | undefined;
   /**
@@ -115,7 +115,7 @@ export const QueryCollectionRequestBody$outboundSchema: z.ZodType<
   fields: models.FieldsSelectorUnion$outboundSchema.optional(),
   partitionFilter: models.PartitionFilter$outboundSchema.optional(),
   ref: models.ReadRef$schema.optional(),
-}).superRefine((value, context) => {
+}).strict().superRefine((value, context) => {
   if (value.consistentRead && value.ref != null && value.ref.kind !== "branch") {
     context.addIssue({
       code: z.ZodIssueCode.custom,

package/src/models/operations/updatecollection.ts

@@ -3,19 +3,28 @@
  */
 
 import * as z from "zod/v3";
+import { collectionTagsSchema } from "../../lib/collectionContract.js";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import * as models from "../index.js";
 
-export type UpdateCollectionRequestBody = {
-  indexConfigs?: { [k: string]: models.IndexConfigsUnion } | undefined;
-  description?: string | undefined;
-  tags?: Record<string, string> | undefined;
-  snapshotRetentionInDays?: number | undefined;
+type UpdateCollectionFields = {
+  indexConfigs?: { [k: string]: models.IndexConfigsUnion } | null | undefined;
+  description?: string | null | undefined;
+  tags?: Record<string, string> | null | undefined;
+  snapshotRetentionInDays?: number | null | undefined;
 };
 
+export type UpdateCollectionRequestBody =
+  | (UpdateCollectionFields & {
+    indexConfigs: { [k: string]: models.IndexConfigsUnion };
+  })
+  | (UpdateCollectionFields & { description: string })
+  | (UpdateCollectionFields & { tags: Record<string, string> })
+  | (UpdateCollectionFields & { snapshotRetentionInDays: number });
+
 export type UpdateCollectionRequest = {
   /**
    * Collection name.
@@ -32,33 +41,45 @@ export type UpdateCollectionResponse = {
 };
 
 /** @internal */
-export type UpdateCollectionRequestBody$Outbound = {
-  indexConfigs?: { [k: string]: models.IndexConfigsUnion$Outbound } | undefined;
-  description?: string | undefined;
-  tags?: Record<string, string> | undefined;
-  snapshotRetentionInDays?: number | undefined;
+type UpdateCollectionFields$Outbound = {
+  indexConfigs?:
+    | { [k: string]: models.IndexConfigsUnion$Outbound }
+    | null
+    | undefined;
+  description?: string | null | undefined;
+  tags?: Record<string, string> | null | undefined;
+  snapshotRetentionInDays?: number | null | undefined;
 };
 
+export type UpdateCollectionRequestBody$Outbound =
+  | (UpdateCollectionFields$Outbound & {
+    indexConfigs: { [k: string]: models.IndexConfigsUnion$Outbound };
+  })
+  | (UpdateCollectionFields$Outbound & { description: string })
+  | (UpdateCollectionFields$Outbound & { tags: Record<string, string> })
+  | (UpdateCollectionFields$Outbound & { snapshotRetentionInDays: number });
+
 /** @internal */
 export const UpdateCollectionRequestBody$outboundSchema: z.ZodType<
   UpdateCollectionRequestBody$Outbound,
   z.ZodTypeDef,
   UpdateCollectionRequestBody
 > = z.object({
-  indexConfigs: z.record(models.IndexConfigsUnion$outboundSchema).optional(),
-  description: z.string().max(255).optional(),
-  tags: z.record(
-    z.string().min(1).max(127).regex(/^[^:#,]+$/),
-  ).refine((value) => Object.keys(value).length <= 5, {
-    message: "Collection tags support at most five entries",
-  }).refine(
-    (value) => Object.keys(value).every((key) => /^[A-Za-z0-9_.-]{1,63}$/.test(key)),
-    { message: "Invalid collection tag key" },
-  ).optional(),
-  snapshotRetentionInDays: z.number().int().min(1).max(31).optional(),
-}).refine((value) => Object.values(value).some((item) => item !== undefined), {
-  message: "At least one collection field must be provided",
-});
+  indexConfigs: z.record(models.IndexConfigsUnion$outboundSchema).refine(
+    (value) => Object.keys(value).length > 0,
+    { message: "Collection indexConfigs must contain at least one field" },
+  ).nullable().optional(),
+  description: z.string().max(255).nullable().optional(),
+  tags: collectionTagsSchema.nullable().optional(),
+  snapshotRetentionInDays: z.number().int().min(1).max(31).nullable().optional(),
+}).strict().refine(
+  (value) => Object.values(value).some((item) => item !== undefined && item !== null),
+  { message: "At least one non-null collection field must be provided" },
+) as z.ZodType<
+  UpdateCollectionRequestBody$Outbound,
+  z.ZodTypeDef,
+  UpdateCollectionRequestBody
+>;
 
 export function updateCollectionRequestBodyToJSON(
   updateCollectionRequestBody: UpdateCollectionRequestBody,

package/src/models/operations/updatedocs.ts

@@ -36,7 +36,7 @@ export const UpdateDocsRequestBody$outboundSchema: z.ZodType<
 > = z.object({
   docs: z.array(z.record(z.any())),
   branch: z.string().regex(/^[a-zA-Z0-9_-]{3,52}$/).optional(),
-});
+}).strict();
 
 export function updateDocsRequestBodyToJSON(
   updateDocsRequestBody: UpdateDocsRequestBody,

package/src/models/operations/upsertdocs.ts

@@ -36,7 +36,7 @@ export const UpsertDocsRequestBody$outboundSchema: z.ZodType<
 > = z.object({
   docs: z.array(z.record(z.any())),
   branch: z.string().regex(/^[a-zA-Z0-9_-]{3,52}$/).optional(),
-});
+}).strict();
 
 export function upsertDocsRequestBodyToJSON(
   upsertDocsRequestBody: UpsertDocsRequestBody,

package/src/sdk/docs.ts

@@ -89,7 +89,7 @@ export class Docs extends ClientSDK {
   }
 
   /**
-   * Delete documents by document IDs or query filter from a collection.
+   * Delete documents by exactly one of document IDs or query filter.
    */
   async delete(
     request: operations.DeleteDocsRequest,