@beam-network/sdk 0.2.15 → 0.2.17

package/README.md

@@ -91,4 +91,10 @@ Use `S3ProviderConfig` for ordinary AWS S3 if preferred, and keep using
 `S3CompatibleProviderConfig` when a provider needs a custom S3-compatible
 endpoint.
 
-For low-level BeamCore `/transfers/create` calls with raw HTTP-style configs, use `createRawTransfer`.
+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

@@ -1,15 +1,19 @@
 import type { AttachSignedUrlsResponse, BeamClientOptions, DistributeResponse, PlanningHttpSource, PreparedDestination, PreparedHttpSource, ProviderTransferCreateInput, RawTransferCreateInput, SignedChunkRoute, SignedUrlFlow, TransferCancelResponse, TransferCreateResponse, TransferPlanResponse, TransferPrepareResponse, TransferStatusInfo } from "./models.js";
-export declare const BEAM_DEFAULT_URL = "https://beamcore.b1m.ai";
+import { BEAM_DEFAULT_NATS_URL } from "./nats-control.js";
+export { BEAM_DEFAULT_NATS_URL };
 export declare class BeamApiError extends Error {
     readonly status: number;
     readonly body: string;
     constructor(message: string, status: number, body: string);
 }
 export declare class BeamClient {
-    readonly baseUrl: string;
     readonly apiKey: string;
+    readonly natsUrl: string;
     private readonly fetchImpl;
+    private readonly control;
+    private readonly recoverySigners;
     constructor(options?: BeamClientOptions);
+    close(): Promise<void>;
     createRawTransfer(input: RawTransferCreateInput): Promise<TransferCreateResponse>;
     createTransfer(input: ProviderTransferCreateInput): Promise<TransferPrepareResponse>;
     transferStatus(transferId: string): Promise<TransferStatusInfo>;
@@ -20,7 +24,6 @@ export declare class BeamClient {
         destinations: PreparedDestination[];
         name?: string;
         testMode?: boolean;
-        experimental?: boolean;
         urlsExpiresAt?: string;
         signedUrlFlow?: SignedUrlFlow;
     }): Promise<TransferPlanResponse>;
@@ -29,7 +32,6 @@ export declare class BeamClient {
         destinations: PreparedDestination[];
         name?: string;
         testMode?: boolean;
-        experimental?: boolean;
         urlsExpiresAt?: string;
         signedUrlFlow?: SignedUrlFlow;
     }): Promise<TransferPrepareResponse>;
@@ -37,17 +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>;
-    private request;
 }
-export declare function calculateOptimalChunkSize(totalSize: number): number;
 export declare function buildStagingObjectPrefix(input: {
     finalObjectKey: string;
     transferId: string;