@beam-network/sdk 0.5.3 → 0.5.5

package/README.md

@@ -98,7 +98,7 @@ For low-level raw transfer configs, use `createRawTransfer`; lifecycle transport
 
 Provider transfers use `transfer-client-control/v5`. Every reply carries Runtime and transport epochs; prepare and every route-stream message carry a UUID route generation. S3, R2, and S3-compatible destinations retain direct multipart UploadPart/ListParts/HEAD handling.
 
-The client signs up to 64 routes concurrently by default and emits 2,048-route logical batches, split only when encoded MessagePack requests exceed `maxPayloadBytes` (8 MiB by default; explicit positive overrides remain supported). A single route larger than the configured limit fails before publication with both sizes in the error. Multipart create and abort requests use a separate `multipartControlConcurrency` limit of 2 by default, with explicit positive overrides supported, and S3-compatible control requests make up to five attempts for transient provider failures. This keeps URL signing throughput independent from provider control-plane pressure.
+The client signs up to 64 routes concurrently by default and emits 2,048-route logical batches. Encoded MessagePack requests target 4 MiB physical batches under `maxPayloadBytes` (8 MiB by default; explicit positive overrides remain supported). The splitter reserves control-envelope headroom for the live auth token and stable request identity so the final encoded request remains below the configured guard. A single route above the 4 MiB target but within the configured guard publishes alone; a single route larger than the configured limit fails before publication with both sizes in the error. Multipart create and abort requests use a separate `multipartControlConcurrency` limit of 2 by default, with explicit positive overrides supported, and S3-compatible control requests make up to five attempts for transient provider failures. This keeps URL signing throughput independent from provider control-plane pressure.
 
 The stream ID derives from the transfer, selected flow, and immutable plan identity, and each ordered batch ID includes its route-coordinate checksum. Manual multi-destination attachment requires `delivery_index` on every route. Lifecycle mutations retry transient failures up to three times with the same request identity. A non-recoverable provider setup or route failure raises `BeamProviderTransferError`, whose `errors`, `transferCancelled`, and `multipartCleanupComplete` fields retain the original provider, cancellation, and cleanup outcomes. `waitForTransfer` subscribes to the API-key-owned, at-most-once terminal signal before its first status read and reconciles every signal through authoritative status; subscription failure degrades to the same jittered 15-to-30-second status fallback. Call `close()` when the client is no longer needed; it also closes outstanding terminal waiters.
 

package/dist/nats-control.d.ts

@@ -4,6 +4,7 @@ export declare const TRANSFER_CLIENT_CONTROL_SCHEMA_VERSION = "transfer-client-c
 export declare const BEAM_DEFAULT_NATS_URL = "tls://nats.b1m.ai:4222";
 export declare const BEAM_DEFAULT_NATS_WS_URL = "wss://nats.b1m.ai:443";
 export declare const BEAM_DEFAULT_MAX_PAYLOAD_BYTES: number;
+export declare const BEAM_ROUTE_TARGET_PAYLOAD_BYTES: number;
 export type TransferClientMessageType = "runtime.hello" | "transfer.plan" | "transfer.create" | "transfer.prepare" | "transfer.route_stream.begin" | "transfer.route_stream.manifest" | "transfer.route_stream.batch" | "transfer.route_stream.complete" | "transfer.distribute" | "transfer.status" | "transfer.cancel" | "transfer.resume";
 export interface CompactSignedRouteBatch {
     source_chunks: Array<{

package/dist/nats-control.js

@@ -6,6 +6,8 @@ export const BEAM_DEFAULT_NATS_WS_URL = "wss://nats.b1m.ai:443";
 // NATS enforces max_payload per message. This guard splits signed-route control
 // messages before the broker rejects them; transfer bytes never flow through NATS.
 export const BEAM_DEFAULT_MAX_PAYLOAD_BYTES = 8 * 1024 * 1024;
+export const BEAM_ROUTE_TARGET_PAYLOAD_BYTES = 4 * 1024 * 1024;
+const ROUTE_BATCH_AUTH_TOKEN_ESTIMATE_BYTES = 64 * 1024;
 export function buildConnectionOptions(options) {
     const connectionOptions = {
         servers: options.natsUrl,
@@ -284,6 +286,8 @@ export class BeamTransferControl {
         }
     }
     splitRoutesForPayload(messageType, basePayload, routes) {
+        const targetPayloadBytes = Math.min(this.maxPayloadBytes, BEAM_ROUTE_TARGET_PAYLOAD_BYTES);
+        const authTokenEstimateBytes = Math.min(ROUTE_BATCH_AUTH_TOKEN_ESTIMATE_BYTES, Math.max(512, Math.floor(this.maxPayloadBytes / 128)));
         const encodedBytes = (candidate) => {
             const encoded = encode({
                 schema_version: TRANSFER_CLIENT_CONTROL_SCHEMA_VERSION,
@@ -292,7 +296,10 @@ export class BeamTransferControl {
                 shard_id: 0,
                 message_type: messageType,
                 request_id: "00000000-0000-4000-8000-000000000000",
-                auth_token: "x".repeat(512),
+                // The live JWT is larger than the compact placeholder once claims and
+                // signatures are encoded. Reserve enough space for token and envelope
+                // growth so a batch accepted by the estimator stays below the guard.
+                auth_token: "x".repeat(authTokenEstimateBytes),
                 occurred_at: new Date().toISOString(),
                 producer: "sdk",
                 payload: { ...basePayload, route_batch: compactSignedRoutes(candidate) }
@@ -307,7 +314,7 @@ export class BeamTransferControl {
             let accepted = 0;
             while (low <= high) {
                 const count = Math.floor((low + high) / 2);
-                if (encodedBytes(routes.slice(offset, offset + count)) <= this.maxPayloadBytes) {
+                if (encodedBytes(routes.slice(offset, offset + count)) <= targetPayloadBytes) {
                     accepted = count;
                     low = count + 1;
                 }
@@ -316,7 +323,10 @@ export class BeamTransferControl {
             }
             if (accepted === 0) {
                 const bytes = encodedBytes(routes.slice(offset, offset + 1));
-                throw new Error(`single signed route is ${bytes} bytes, above maxPayloadBytes=${this.maxPayloadBytes}`);
+                if (bytes > this.maxPayloadBytes) {
+                    throw new Error(`single signed route is ${bytes} bytes, above maxPayloadBytes=${this.maxPayloadBytes}`);
+                }
+                accepted = 1;
             }
             chunks.push(routes.slice(offset, offset + accepted));
             offset += accepted;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@beam-network/sdk",
-    "version": "0.5.3",
+    "version": "0.5.5",
     "description": "TypeScript SDK for BEAM transfer creation and management.",
     "type": "module",
     "license": "MIT",