@beam-network/sdk 0.2.13 → 0.2.14

package/dist/client.d.ts

@@ -48,6 +48,12 @@ export declare class BeamClient {
     private request;
 }
 export declare function calculateOptimalChunkSize(totalSize: number): number;
+export declare function buildStagingObjectPrefix(input: {
+    finalObjectKey: string;
+    transferId: string;
+    sourceId: string;
+    destinationId: string;
+}): string;
 export declare function buildStagingObjectKey(input: {
     finalObjectKey: string;
     transferId: string;

package/dist/client.js

@@ -1,4 +1,4 @@
-import { abortMultipartUpload, computeChunksContentMd5, createMultipartUpload, nowIso, prepareProviderDestination, prepareProviderSource, prepareProviderSourceForPlan, isS3CompatibleProvider, listPartsPageMarker, listPartsVerifyMarker, signAbortMultipartUpload, signCompleteMultipartUpload, signDeleteObject, signDestinationRoute, signListMultipartUpload, signUploadPartCopy } from "./provider-signing.js";
+import { abortMultipartUpload, computeChunksContentMd5, createMultipartUpload, nowIso, prepareProviderDestination, prepareProviderSource, prepareProviderSourceForPlan, isS3CompatibleProvider, listPartsPageMarker, listPartsVerifyMarker, signAbortMultipartUpload, signCompleteMultipartUpload, signDeleteObject, signDestinationRoute, signListMultipartUpload, signListObjects, signUploadPartCopy } from "./provider-signing.js";
 export const BEAM_DEFAULT_URL = "https://beamcore.b1m.ai";
 export class BeamApiError extends Error {
     status;
@@ -341,16 +341,19 @@ export class BeamClient {
                 fetchImpl: this.fetchImpl
             });
         }
-        const stagingObjectKey = buildStagingObjectKey({
+        const stagingObjectPrefix = buildStagingObjectPrefix({
             finalObjectKey: input.finalObjectKey,
             transferId: input.transferId,
             sourceId: input.chunk.source_id,
-            destinationId: input.target.destination_id,
-            chunkIndex: input.chunk.chunk_index,
-            partNumber: input.partNumber
+            destinationId: input.target.destination_id
         });
+        const stagingObjectKey = [
+            stagingObjectPrefix,
+            `part-${input.partNumber}-chunk-${input.chunk.chunk_index}`
+        ].join("/");
         const copySourceRange = `bytes=0-${Math.max(0, input.chunk.chunk_size - 1)}`;
         const { copyUrl, copySource } = await signUploadPartCopy(input.destination, input.finalObjectKey, stagingObjectKey, input.upload.uploadId, input.partNumber, input.expiresIn, copySourceRange);
+        const stagingListUrl = await signListObjects(input.destination, stagingObjectPrefix, input.expiresIn);
         const deleteUrl = await signDeleteObject(input.destination, stagingObjectKey, input.expiresIn);
         return signDestinationRoute({
             chunk: input.chunk,
@@ -369,6 +372,7 @@ export class BeamClient {
             multipartCreatedAt: input.upload.multipartCreatedAt,
             commitMethod: "upload_part_copy",
             stagingObjectKey,
+            stagingListUrl,
             copyUrl,
             copySource,
             copySourceRange,
@@ -716,13 +720,18 @@ function normalizeBaseUrl(value) {
 function compact(input) {
     return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
 }
-export function buildStagingObjectKey(input) {
+export function buildStagingObjectPrefix(input) {
     const base = input.finalObjectKey.replace(/\/+$/, "") || "object";
     return [
         `${base}.beam-staging`,
         safeObjectKeySegment(input.transferId),
         safeObjectKeySegment(input.sourceId),
-        safeObjectKeySegment(input.destinationId),
+        safeObjectKeySegment(input.destinationId)
+    ].join("/");
+}
+export function buildStagingObjectKey(input) {
+    return [
+        buildStagingObjectPrefix(input),
         `part-${input.partNumber}-chunk-${input.chunkIndex}`
     ].join("/");
 }

package/dist/provider-signing.d.ts

@@ -17,6 +17,7 @@ export declare function prepareProviderDestination(destination: ProviderDestinat
 export declare function createMultipartUpload(destination: ProviderDestinationConfig, objectKey: string): Promise<string>;
 export declare function signCompleteMultipartUpload(destination: ProviderDestinationConfig, objectKey: string, uploadId: string, expiresIn: number): Promise<string>;
 export declare function signAbortMultipartUpload(destination: ProviderDestinationConfig, objectKey: string, uploadId: string, expiresIn: number): Promise<string>;
+export declare function signListObjects(destination: ProviderDestinationConfig, prefix: string, expiresIn: number): Promise<string>;
 export declare function signListMultipartUpload(destination: ProviderDestinationConfig, objectKey: string, uploadId: string, expiresIn: number, options?: {
     maxParts?: number;
     partNumberMarker?: number;
@@ -49,6 +50,7 @@ export declare function signDestinationRoute(input: {
     partVerifyUrl?: string;
     listPageUrl?: string;
     stagingObjectKey?: string;
+    stagingListUrl?: string;
     copyUrl?: string;
     copySource?: string;
     copySourceRange?: string;

package/dist/provider-signing.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { AbortMultipartUploadCommand, CompleteMultipartUploadCommand, CreateMultipartUploadCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListPartsCommand, PutObjectCommand, S3Client, UploadPartCopyCommand, UploadPartCommand } from "@aws-sdk/client-s3";
+import { AbortMultipartUploadCommand, CompleteMultipartUploadCommand, CreateMultipartUploadCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, ListPartsCommand, PutObjectCommand, S3Client, UploadPartCopyCommand, UploadPartCommand } from "@aws-sdk/client-s3";
 import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
 export function nowIso() {
     return new Date().toISOString();
@@ -139,6 +139,13 @@ export async function signAbortMultipartUpload(destination, objectKey, uploadId,
     }
     throw new Error(`multipart abort is not supported for ${destination.provider}`);
 }
+export async function signListObjects(destination, prefix, expiresIn) {
+    if (isS3CompatibleProvider(destination)) {
+        const client = createS3CompatibleClient(destination);
+        return getSignedUrl(client, new ListObjectsV2Command({ Bucket: destination.bucket, Prefix: prefix }), { expiresIn });
+    }
+    throw new Error(`multipart staging list is not supported for ${destination.provider}`);
+}
 export async function signListMultipartUpload(destination, objectKey, uploadId, expiresIn, options = {}) {
     if (isS3CompatibleProvider(destination)) {
         const client = createS3CompatibleClient(destination);
@@ -247,6 +254,7 @@ export async function signDestinationRoute(input) {
             ...(input.multipartCreatedAt ? { multipart_created_at: input.multipartCreatedAt } : {}),
             ...(input.commitMethod ? { commit_method: input.commitMethod } : {}),
             ...(input.stagingObjectKey ? { staging_object_key: input.stagingObjectKey } : {}),
+            ...(input.stagingListUrl ? { staging_list_url: input.stagingListUrl } : {}),
             ...(input.copyUrl ? { copy_url: input.copyUrl } : {}),
             ...(input.copySource ? { copy_source: input.copySource } : {}),
             ...(input.copySourceRange ? { copy_source_range: input.copySourceRange } : {}),

package/package.json

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