@functional-systems/lambdadb 0.8.1-dev.38730896042001 → 0.8.1-dev.39249041100001

package/CHANGELOG.md

@@ -6,10 +6,14 @@
   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.
-- Documented the server's 64 MiB query response and hydration budgets, which
-  return HTTP 400 without partial results. Facet bucket, Fetch, and List count
-  limits remain unchanged. Source alignment does not establish deployment or
-  package publication.
+- 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.8.1
 

package/README.md

@@ -209,8 +209,9 @@ and use a separate [pinned source contract](docs/OPENAPI_UPDATE.md#openapi-spec)
 Query `size`, dense `knn.k`, Bayesian `candidateSize`, and
 `rerank.candidateSize` support up to 1000 on the
 [pinned backend contract](docs/OPENAPI_UPDATE.md#updating-query-limits).
-The server enforces a 64 MiB uncompressed query response budget and a separate
-hydration budget, returning HTTP 400 without partial results when exceeded.
+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.
 Source alignment does not establish deployment to your endpoint.
@@ -499,13 +500,46 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 <!-- Start Retries [retries] -->
 ## Retries
 
-Some of the endpoints in this SDK support retries.  If you use the SDK without any configuration, it will fall back to the default retry strategy provided by the API.  However, the default retry strategy can be overridden on a per-operation basis, or across the entire SDK.
+Retry behavior is configured by the SDK. Document write API requests use backoff
+retries by default for HTTP `429`, all `5xx` responses (including `500`, `502`, `503`, and
+`504`), and connection errors or transport timeouts. Per-call `retries` overrides
+the client's `retryConfig`. The same retry settings apply to `*Safe` methods;
+returning a Result does not disable retries.
 
 For retryable `429` responses, the backoff implementation honors a valid
 `Retry-After` header when present. The API does not guarantee that every `429`
 contains this header.
 
-To change the default retry strategy for a single API call, simply provide a retryConfig object to the call:
+For writes, an error does not prove that the mutation was not committed. The
+response can be lost after a successful commit, and automatic retries can
+reapply the write before the SDK returns an error or a successful response.
+Retries do not provide exactly-once execution.
+
+To inspect state before deciding whether to retry a write, disable automatic
+retries on the initial call:
+
+```typescript
+import { LambdaDBClient } from "@functional-systems/lambdadb";
+
+const client = new LambdaDBClient({
+  projectApiKey: "<YOUR_PROJECT_API_KEY>",
+});
+const collection = client.collection("my-collection");
+
+await collection.docs.upsert(
+  { docs: [{ id: "doc-1", title: "Updated title" }] },
+  { retries: { strategy: "none" } },
+);
+```
+
+This disables both HTTP-status and connection-error retries for that call.
+Setting only `retryConnectionErrors: false` still allows retryable HTTP
+responses, including `502` and `504`, to be retried. Disabling retries does not
+cancel a server-side write or establish its outcome. After a failure, inspect
+the target Branch state and consider the operation's semantics before issuing
+another write. The SDK does not perform that reconciliation automatically.
+
+To change the retry strategy for a single API call, pass `retries` in its request options:
 ```typescript
 import { LambdaDBClient } from "@functional-systems/lambdadb";
 

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.38730896042001";
+    readonly sdkVersion: "0.8.1-dev.39249041100001";
     readonly genVersion: "2.798.0";
-    readonly userAgent: "speakeasy-sdk/typescript 0.8.1-dev.38730896042001 2.798.0 1.1.1 @functional-systems/lambdadb";
+    readonly userAgent: "speakeasy-sdk/typescript 0.8.1-dev.39249041100001 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.38730896042001",
+    sdkVersion: "0.8.1-dev.39249041100001",
     genVersion: "2.798.0",
-    userAgent: "speakeasy-sdk/typescript 0.8.1-dev.38730896042001 2.798.0 1.1.1 @functional-systems/lambdadb",
+    userAgent: "speakeasy-sdk/typescript 0.8.1-dev.39249041100001 2.798.0 1.1.1 @functional-systems/lambdadb",
 };
 //# sourceMappingURL=config.js.map

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.38730896042001";
+    readonly sdkVersion: "0.8.1-dev.39249041100001";
     readonly genVersion: "2.798.0";
-    readonly userAgent: "speakeasy-sdk/typescript 0.8.1-dev.38730896042001 2.798.0 1.1.1 @functional-systems/lambdadb";
+    readonly userAgent: "speakeasy-sdk/typescript 0.8.1-dev.39249041100001 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.38730896042001",
+    sdkVersion: "0.8.1-dev.39249041100001",
     genVersion: "2.798.0",
-    userAgent: "speakeasy-sdk/typescript 0.8.1-dev.38730896042001 2.798.0 1.1.1 @functional-systems/lambdadb",
+    userAgent: "speakeasy-sdk/typescript 0.8.1-dev.39249041100001 2.798.0 1.1.1 @functional-systems/lambdadb",
 };
 //# sourceMappingURL=config.js.map

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.8.1-dev.38730896042001",
+  "version": "0.8.1-dev.39249041100001",
   "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.38730896042001",
+  "version": "0.8.1-dev.39249041100001",
   "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": "6f790d54d2094d0f548210df56c216a70dbf9e0e"
+  "lambdadbSourceCommit": "374ef91cf59e373a0ddb2a66bc47b8ff9ee81833"
 }

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