@functional-systems/lambdadb 0.8.1-dev.40308886780001 → 0.9.0-dev.40316159993001

package/CHANGELOG.md

@@ -1,31 +1,31 @@
 # Changelog
 
-## Unreleased
-
-- Aligned Fetch/List documentation with docs `ce2d8f7bd8ee2ab4f240be022085aab37cca0b91`
-  and backend `0a54b6ecb483ce7df9677ba2071a491f9f9879c9`: both support 1000,
-  with List defaulting to 100 and Fetch retaining its per-node JSON budget.
-  Added nullable POST List inputs and public-client routing that preserves explicit
-  nulls, including pagination. Existing server validation and defaults are retained.
-
-- Documented and covered unindexed stored string paths for native embedding
-  sources and rerank fields at backend
-  `ff13daf3f4ed40487b2b13522a141265c2f459ab` (PR #481). Examples use vector-only
-  schemas and original nested JSON. Clarified scalar source validation, full
-  upserts, partial updates, projection, and deployment compatibility. Runtime
-  schemas, public types, defaults, limits, and package versions are unchanged.
-- Raised native reranking output and candidate limits from 100 to 1000, aligned
-  with backend `963d79e8866833f1deb1393ed00a9825d866c853`. Query `size`, dense
-  `knn.k`, and Bayesian `candidateSize` also support up to 1000 on that contract;
-  their server-side validation and request defaults remain unchanged.
-- Aligned query resource documentation with backend
-  `234f6f97814bf0d60604fa45ab2907f1fce88b5a`: query results and hydrated candidate
-  bodies no longer have aggregate 64 MiB limits. Large results retain the
-  existing `docsUrl` format; shared temporary storage exhaustion returns HTTP
-  503 without partial results or rerank provider fallback. Internal transport
-  and rerank input budgets remain unchanged, as do Facet bucket, Fetch, and
-  List count limits. Source alignment does not establish deployment or package
-  publication.
+## 0.9.0
+
+- Raised native reranking output and candidate limits to 1000, matching the
+  server's Query size, dense KNN k, and Bayesian candidate limits. Fetch and List
+  also support 1000 on the pinned server contract; List's default remains 100.
+- Added explicit null support for POST List size, pageToken, and filter, including
+  public list/listSafe routing and pagination. Existing GET inputs, defaults,
+  server-side validation, and error classification retain their behavior.
+- Updated native embedding and reranking examples for unindexed stored string
+  paths, with coverage for nested JSON, partial updates, projection, and source
+  validation. Legacy indexed sources and managedEmbedding inputs remain supported.
+- Documented query result spooling without an aggregate 64 MiB result limit,
+  Fetch's retained 64 MiB per-node JSON budget, and HTTP 503 on shared temporary
+  storage admission failure. Rerank text budgets and facet limits are unchanged.
+- Updated contribution guidance for manual SDK maintenance and aligned CI with
+  the Node 24 publication runtime.
+- Clarified that native embedding KNN fields require queryText and reject
+  queryVector, matching the corrected OpenAPI description and server behavior.
+- Clarified write retries and uncertain outcomes. Default retries include all
+  HTTP 5xx responses, including 502/504. Callers that need to reconcile an
+  uncertain write before replay must explicitly disable retries.
+- Pinned the current OpenAPI to docs `94a7b71613a3bf217a370d5117b3ff6ddfbae851`
+  and the read contract to backend `0a54b6ecb483ce7df9677ba2071a491f9f9879c9`.
+  Native stored string paths use backend `ff13daf3f4ed40487b2b13522a141265c2f459ab`.
+  Server-dependent capabilities require a supporting deployment; source pins and
+  SDK publication alone do not establish production rollout.
 
 ## 0.8.1
 

package/README.md

@@ -213,7 +213,9 @@ Query results and hydrated candidate bodies no longer have an aggregate 64 MiB
 limit. Large results use the existing `docsUrl` download format; exhaustion of
 the server's shared temporary storage budget returns HTTP 503 without partial results.
 See [query size and byte limits](docs/native-reranking.md#query-size-and-byte-limits).
-Facet buckets, Fetch, and List retain their existing 100-item limits.
+Facet buckets retain their 100-item limit. Fetch and GET/POST List support up to
+1000 IDs/documents; List defaults to 100. Fetch retains a 64 MiB per-node JSON
+budget. See the [read contract](docs/OPENAPI_UPDATE.md#updating-fetch-and-list).
 Source alignment does not establish deployment to your endpoint.
 
 ### Native reranking

package/RUNTIMES.md

@@ -14,8 +14,8 @@ This SDK is intended to be used in JavaScript runtimes that support ECMAScript 2
 Runtime environments that are explicitly supported are:
 
 - Evergreen browsers which include: Chrome, Safari, Edge, Firefox
-- Node.js active and maintenance LTS releases
-  - Currently, this is v18 and v20
+- Node.js active and maintenance LTS releases; see the [official release schedule](https://nodejs.org/en/about/previous-releases).
+  - CI and package publication use Node 24. Node 18 and 20 are end-of-life.
 - Bun v1 and above
 - Deno v1.39
   - Note that Deno does not currently have native support for streaming file uploads backed by the filesystem ([issue link][deno-file-streaming])

package/dist/commonjs/client.d.ts

@@ -210,7 +210,7 @@ export declare class CollectionDocs {
      */
     deleteSafe(body: DeleteDocsInput, options?: RequestOptions): Promise<Result<MessageResponse, DeleteDocsError>>;
     /**
-     * Fetch documents by IDs (max 100).
+     * Fetch documents by IDs (max 1000 on the supporting server contract).
      * When the API returns docs via docsUrl (isDocsInline false), documents are
      * fetched from the presigned URL automatically so the response always has docs.
      */

package/dist/commonjs/client.js

@@ -512,7 +512,7 @@ class CollectionDocs {
         return await (0, collectionsDocsDelete_js_1.collectionsDocsDelete)(this.client, { collectionName: this.collectionName, requestBody: body }, options);
     }
     /**
-     * Fetch documents by IDs (max 100).
+     * Fetch documents by IDs (max 1000 on the supporting server contract).
      * When the API returns docs via docsUrl (isDocsInline false), documents are
      * fetched from the presigned URL automatically so the response always has docs.
      */

package/dist/commonjs/lib/config.d.ts

@@ -37,8 +37,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.1.1";
-    readonly sdkVersion: "0.8.1-dev.40308886780001";
+    readonly sdkVersion: "0.9.0-dev.40316159993001";
     readonly genVersion: "2.798.0";
-    readonly userAgent: "speakeasy-sdk/typescript 0.8.1-dev.40308886780001 2.798.0 1.1.1 @functional-systems/lambdadb";
+    readonly userAgent: "speakeasy-sdk/typescript 0.9.0-dev.40316159993001 2.798.0 1.1.1 @functional-systems/lambdadb";
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/commonjs/lib/config.js

@@ -37,8 +37,8 @@ function serverURLFromOptions(options) {
 exports.SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.1.1",
-    sdkVersion: "0.8.1-dev.40308886780001",
+    sdkVersion: "0.9.0-dev.40316159993001",
     genVersion: "2.798.0",
-    userAgent: "speakeasy-sdk/typescript 0.8.1-dev.40308886780001 2.798.0 1.1.1 @functional-systems/lambdadb",
+    userAgent: "speakeasy-sdk/typescript 0.9.0-dev.40316159993001 2.798.0 1.1.1 @functional-systems/lambdadb",
 };
 //# sourceMappingURL=config.js.map

package/dist/commonjs/models/operations/querycollection.d.ts

@@ -22,7 +22,7 @@ export type QueryCollectionRequestBody = {
     candidateSize?: number | undefined;
     /**
      * Query object. BayesianQuery provides an optional typed top-level hybrid query.
-     * For native embedding vector fields, use knn.queryText. For unmanaged vector fields, use knn.queryVector.
+     * For native embedding vector fields, use knn.queryText; knn.queryVector is not supported. For caller-provided vector fields, use knn.queryVector. Each KNN query requires exactly one non-null query input.
      */
     query?: {
         [k: string]: any;

package/dist/esm/client.d.ts

@@ -210,7 +210,7 @@ export declare class CollectionDocs {
      */
     deleteSafe(body: DeleteDocsInput, options?: RequestOptions): Promise<Result<MessageResponse, DeleteDocsError>>;
     /**
-     * Fetch documents by IDs (max 100).
+     * Fetch documents by IDs (max 1000 on the supporting server contract).
      * When the API returns docs via docsUrl (isDocsInline false), documents are
      * fetched from the presigned URL automatically so the response always has docs.
      */

package/dist/esm/client.js

@@ -507,7 +507,7 @@ export class CollectionDocs {
         return await collectionsDocsDelete(this.client, { collectionName: this.collectionName, requestBody: body }, options);
     }
     /**
-     * Fetch documents by IDs (max 100).
+     * Fetch documents by IDs (max 1000 on the supporting server contract).
      * When the API returns docs via docsUrl (isDocsInline false), documents are
      * fetched from the presigned URL automatically so the response always has docs.
      */

package/dist/esm/lib/config.d.ts

@@ -37,8 +37,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.1.1";
-    readonly sdkVersion: "0.8.1-dev.40308886780001";
+    readonly sdkVersion: "0.9.0-dev.40316159993001";
     readonly genVersion: "2.798.0";
-    readonly userAgent: "speakeasy-sdk/typescript 0.8.1-dev.40308886780001 2.798.0 1.1.1 @functional-systems/lambdadb";
+    readonly userAgent: "speakeasy-sdk/typescript 0.9.0-dev.40316159993001 2.798.0 1.1.1 @functional-systems/lambdadb";
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/esm/lib/config.js

@@ -33,8 +33,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.1.1",
-    sdkVersion: "0.8.1-dev.40308886780001",
+    sdkVersion: "0.9.0-dev.40316159993001",
     genVersion: "2.798.0",
-    userAgent: "speakeasy-sdk/typescript 0.8.1-dev.40308886780001 2.798.0 1.1.1 @functional-systems/lambdadb",
+    userAgent: "speakeasy-sdk/typescript 0.9.0-dev.40316159993001 2.798.0 1.1.1 @functional-systems/lambdadb",
 };
 //# sourceMappingURL=config.js.map

package/dist/esm/models/operations/querycollection.d.ts

@@ -22,7 +22,7 @@ export type QueryCollectionRequestBody = {
     candidateSize?: number | undefined;
     /**
      * Query object. BayesianQuery provides an optional typed top-level hybrid query.
-     * For native embedding vector fields, use knn.queryText. For unmanaged vector fields, use knn.queryVector.
+     * For native embedding vector fields, use knn.queryText; knn.queryVector is not supported. For caller-provided vector fields, use knn.queryVector. Each KNN query requires exactly one non-null query input.
      */
     query?: {
         [k: string]: any;

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.8.1-dev.40308886780001",
+  "version": "0.9.0-dev.40316159993001",
   "exports": {
     ".": "./src/index.ts",
     "./models/errors": "./src/models/errors/index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.8.1-dev.40308886780001",
+  "version": "0.9.0-dev.40316159993001",
   "author": "Functional Systems, Inc.",
   "homepage": "https://github.com/lambdadb/lambdadb-typescript-client#readme",
   "license": "Apache-2.0",
@@ -169,5 +169,5 @@
   "main": "./dist/commonjs/index.js",
   "types": "./dist/commonjs/index.d.ts",
   "module": "./dist/esm/index.js",
-  "lambdadbSourceCommit": "3cf4d9b13978a455c78cc40250a26dfd9f9c9721"
+  "lambdadbSourceCommit": "2ba8e4669d3c2be1cff23b03d3fcdd29c681b654"
 }

package/src/client.ts

@@ -831,7 +831,7 @@ export class CollectionDocs {
   }
 
   /**
-   * Fetch documents by IDs (max 100).
+   * Fetch documents by IDs (max 1000 on the supporting server contract).
    * When the API returns docs via docsUrl (isDocsInline false), documents are
    * fetched from the presigned URL automatically so the response always has docs.
    */

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.8.1-dev.40308886780001",
+  sdkVersion: "0.9.0-dev.40316159993001",
   genVersion: "2.798.0",
   userAgent:
-    "speakeasy-sdk/typescript 0.8.1-dev.40308886780001 2.798.0 1.1.1 @functional-systems/lambdadb",
+    "speakeasy-sdk/typescript 0.9.0-dev.40316159993001 2.798.0 1.1.1 @functional-systems/lambdadb",
 } as const;

package/src/models/operations/querycollection.ts

@@ -26,7 +26,7 @@ export type QueryCollectionRequestBody = {
   candidateSize?: number | undefined;
   /**
    * Query object. BayesianQuery provides an optional typed top-level hybrid query.
-   * For native embedding vector fields, use knn.queryText. For unmanaged vector fields, use knn.queryVector.
+   * For native embedding vector fields, use knn.queryText; knn.queryVector is not supported. For caller-provided vector fields, use knn.queryVector. Each KNN query requires exactly one non-null query input.
    */
   query?: { [k: string]: any } | undefined;
   facets?: Record<string, FacetRequest> | undefined;