@beam-network/sdk 0.5.1 → 0.5.2

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` (24 MiB by default). 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. `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.
+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. 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. `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.
 
 Hippius uses genuine non-multipart v2 routes, so its manifest is empty and group-level final HEAD verification is not available from that provider flow.
 

package/dist/client.d.ts

@@ -1,5 +1,10 @@
 import type { AttachSignedUrlsResponse, BeamClientOptions, DistributeResponse, MultipartGroupManifest, PlanningHttpSource, PreparedDestination, PreparedHttpSource, ProviderTransferCreateInput, RawTransferCreateInput, SignedChunkRoute, SignedUrlFlow, TransferCancelResponse, TransferCreateResponse, TransferPlanResponse, TransferPrepareResponse, TransferStatusInfo, TransferTerminalSignalWaiter } from "./models.js";
 import { BEAM_DEFAULT_NATS_URL } from "./nats-control.js";
+export declare class BeamRouteRecoveryPendingError extends Error {
+    readonly transferId: string;
+    readonly cause: unknown;
+    constructor(transferId: string, cause: unknown);
+}
 export { BEAM_DEFAULT_NATS_URL };
 export declare class BeamApiError extends Error {
     readonly status: number;

package/dist/client.js

@@ -1,5 +1,15 @@
 import { abortMultipartUpload, createMultipartUpload, expiresAtIso, prepareProviderDestination, prepareProviderSource, signAbortMultipartUpload, signCompleteMultipartUpload, signDeleteObject, signDestinationRoute, signFinalObjectHead, signListMultipartUpload, signListObjects, signUploadPartCopy } from "./provider-signing.js";
 import { BeamTransferControl, BEAM_DEFAULT_NATS_URL, compactSignedRoutes, isRecoverableRouteStreamError } from "./nats-control.js";
+export class BeamRouteRecoveryPendingError extends Error {
+    transferId;
+    cause;
+    constructor(transferId, cause) {
+        super(`Transfer ${transferId} is prepared and route recovery is continuing in the background.`);
+        this.name = "BeamRouteRecoveryPendingError";
+        this.transferId = transferId;
+        this.cause = cause;
+    }
+}
 import { multipartPartNumber } from "./multipart-limits.js";
 export { BEAM_DEFAULT_NATS_URL };
 export class BeamApiError extends Error {
@@ -192,10 +202,11 @@ export class BeamClient {
             return attached;
         }
         catch (error) {
-            if (isRecoverableRouteStreamError(error))
+            if (isRecoverableRouteStreamError(error)) {
                 this.control.continueRecoveryLease(transferId);
-            else
-                this.control.releaseRecoveryLease(transferId);
+                throw new BeamRouteRecoveryPendingError(transferId, error);
+            }
+            this.control.releaseRecoveryLease(transferId);
             throw error;
         }
         finally {
@@ -381,8 +392,12 @@ export class BeamClient {
                 if (multipartManifestTask)
                     await Promise.allSettled([multipartManifestTask]);
                 if (!recoveryReplay) {
-                    if (foregroundCancelled || isRecoverableRouteStreamError(error)) {
+                    if (foregroundCancelled) {
+                        this.control.continueRecoveryLease(prepared.transfer_id);
+                    }
+                    else if (isRecoverableRouteStreamError(error)) {
                         this.control.continueRecoveryLease(prepared.transfer_id);
+                        throw new BeamRouteRecoveryPendingError(prepared.transfer_id, error);
                     }
                     else {
                         this.control.releaseRecoveryLease(prepared.transfer_id);

package/dist/nats-control.js

@@ -5,7 +5,7 @@ export const BEAM_DEFAULT_NATS_URL = "tls://nats.b1m.ai:4222";
 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 = 24 * 1024 * 1024;
+export const BEAM_DEFAULT_MAX_PAYLOAD_BYTES = 8 * 1024 * 1024;
 export function buildConnectionOptions(options) {
     const connectionOptions = {
         servers: options.natsUrl,

package/package.json

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