@beam-network/sdk 0.2.16 → 0.2.18

package/README.md

@@ -92,3 +92,9 @@ Use `S3ProviderConfig` for ordinary AWS S3 if preferred, and keep using
 endpoint.
 
 For low-level raw transfer configs, use `createRawTransfer`; lifecycle transport still goes through NATS.
+
+## Route Streaming And Payload Size
+
+Provider transfers stream signed routes over NATS in target batches of 512 routes. The SDK still splits a batch earlier when the encoded MessagePack request would exceed `maxPayloadBytes`, which defaults to 24 MiB.
+
+NATS requires this guard because the broker rejects messages above its configured `max_payload`. This limit applies only to lifecycle/control metadata; transfer file bytes do not flow through NATS.

package/dist/client.d.ts

@@ -11,6 +11,7 @@ export declare class BeamClient {
     readonly natsUrl: string;
     private readonly fetchImpl;
     private readonly control;
+    private readonly recoverySigners;
     constructor(options?: BeamClientOptions);
     close(): Promise<void>;
     createRawTransfer(input: RawTransferCreateInput): Promise<TransferCreateResponse>;
@@ -23,7 +24,6 @@ export declare class BeamClient {
         destinations: PreparedDestination[];
         name?: string;
         testMode?: boolean;
-        experimental?: boolean;
         urlsExpiresAt?: string;
         signedUrlFlow?: SignedUrlFlow;
     }): Promise<TransferPlanResponse>;
@@ -32,7 +32,6 @@ export declare class BeamClient {
         destinations: PreparedDestination[];
         name?: string;
         testMode?: boolean;
-        experimental?: boolean;
         urlsExpiresAt?: string;
         signedUrlFlow?: SignedUrlFlow;
     }): Promise<TransferPrepareResponse>;
@@ -40,16 +39,20 @@ export declare class BeamClient {
         chunkRoutes: SignedChunkRoute[];
         transferKey?: string;
         urlsExpiresAt?: string;
+        signedUrlFlow?: SignedUrlFlow;
+        autoDistribute?: boolean;
     }): Promise<AttachSignedUrlsResponse>;
     prepareProviderTransfer(input: ProviderTransferCreateInput): Promise<TransferPrepareResponse>;
     private signProviderRoute;
+    private startProviderRouteRecoverySigner;
+    private stopRecoverySigner;
+    private stopAllRecoverySigners;
     createAndDistribute(input: RawTransferCreateInput): Promise<TransferCreateResponse>;
     waitForTransfer(transferId: string, options?: {
         timeoutMs?: number;
         pollIntervalMs?: number;
     }): Promise<TransferStatusInfo>;
 }
-export declare function calculateOptimalChunkSize(totalSize: number): number;
 export declare function buildStagingObjectPrefix(input: {
     finalObjectKey: string;
     transferId: string;