@beam-network/sdk 0.2.23 → 0.3.0

package/dist/provider-signing.js

@@ -1,4 +1,4 @@
-import { AbortMultipartUploadCommand, CompleteMultipartUploadCommand, CreateMultipartUploadCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, ListPartsCommand, PutObjectCommand, S3Client, UploadPartCopyCommand, UploadPartCommand } from "@aws-sdk/client-s3";
+import { AbortMultipartUploadCommand, CompleteMultipartUploadCommand, CreateMultipartUploadCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, ListPartsCommand, PutObjectCommand, S3Client, UploadPartCopyCommand } from "@aws-sdk/client-s3";
 import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
 export function nowIso() {
     return new Date().toISOString();
@@ -113,16 +113,27 @@ export function prepareProviderDestination(destination, options = {}) {
     }
     return unsupportedProviderConfig(destination);
 }
-export async function createMultipartUpload(destination, objectKey) {
-    if (isS3CompatibleProvider(destination)) {
-        const client = createS3CompatibleClient(destination);
-        const response = await client.send(new CreateMultipartUploadCommand({ Bucket: destination.bucket, Key: objectKey }));
+export async function createMultipartUpload(input) {
+    if (isS3CompatibleProvider(input.destination)) {
+        const client = createS3CompatibleClient(input.destination);
+        const response = await client.send(new CreateMultipartUploadCommand({
+            Bucket: input.destination.bucket,
+            Key: input.objectKey,
+            Metadata: input.metadata
+        }));
         if (!response.UploadId) {
-            throw new Error(`provider did not return UploadId for ${objectKey}`);
+            throw new Error(`provider did not return UploadId for ${input.objectKey}`);
         }
         return response.UploadId;
     }
-    throw new Error(`multipart upload is not supported for ${destination.provider}`);
+    throw new Error(`multipart upload is not supported for ${input.destination.provider}`);
+}
+export async function signFinalObjectHead(destination, objectKey, expiresIn) {
+    if (isS3CompatibleProvider(destination)) {
+        const client = createS3CompatibleClient(destination);
+        return getSignedUrl(client, new HeadObjectCommand({ Bucket: destination.bucket, Key: objectKey }), { expiresIn });
+    }
+    throw new Error(`final object HEAD signing is not supported for ${destination.provider}`);
 }
 export async function signCompleteMultipartUpload(destination, objectKey, uploadId, expiresIn) {
     if (isS3CompatibleProvider(destination)) {
@@ -138,10 +149,15 @@ 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) {
+export async function signListObjects(destination, prefix, expiresIn, options = {}) {
     if (isS3CompatibleProvider(destination)) {
         const client = createS3CompatibleClient(destination);
-        return getSignedUrl(client, new ListObjectsV2Command({ Bucket: destination.bucket, Prefix: prefix }), { expiresIn });
+        return getSignedUrl(client, new ListObjectsV2Command({
+            Bucket: destination.bucket,
+            Prefix: prefix,
+            MaxKeys: 1_000,
+            StartAfter: options.startAfter
+        }), { expiresIn });
     }
     throw new Error(`multipart staging list is not supported for ${destination.provider}`);
 }
@@ -158,13 +174,6 @@ export async function signListMultipartUpload(destination, objectKey, uploadId,
     }
     throw new Error(`multipart list-parts is not supported for ${destination.provider}`);
 }
-export function listPartsPageMarker(partNumber, pageSize = 1000) {
-    const marker = Math.floor((Math.max(1, partNumber) - 1) / pageSize) * pageSize;
-    return marker > 0 ? marker : undefined;
-}
-export function listPartsVerifyMarker(partNumber) {
-    return partNumber > 1 ? partNumber - 1 : undefined;
-}
 export async function signUploadPartCopy(destination, finalObjectKey, stagingObjectKey, uploadId, partNumber, expiresIn, copySourceRange) {
     if (isS3CompatibleProvider(destination)) {
         const client = createS3CompatibleClient(destination);
@@ -209,31 +218,29 @@ export async function abortMultipartUpload(destination, objectKey, uploadId) {
     throw new Error(`multipart abort is not supported for ${destination.provider}`);
 }
 export async function signDestinationRoute(input) {
+    if (input.commitMethod !== undefined && input.commitMethod !== "upload_part_copy") {
+        throw new Error(`unsupported signed_url_v2 commit method: ${String(input.commitMethod)}`);
+    }
     const targetObjectKey = input.target.object_key;
     if (!targetObjectKey) {
         throw new Error("destination signing target is missing object_key");
     }
-    const objectKey = input.commitMethod === "upload_part_copy" && input.stagingObjectKey
-        ? input.stagingObjectKey
-        : targetObjectKey;
-    const uploadPartObjectKey = input.multipartObjectKey ?? targetObjectKey;
-    const destUrl = await signDestinationUrl({
-        destination: input.destination,
-        objectKey,
-        uploadPartObjectKey,
-        expiresIn: input.expiresIn,
-        uploadId: input.uploadId,
-        partNumber: input.partNumber,
-        useStagingPut: input.commitMethod === "upload_part_copy",
-        fetchImpl: input.fetchImpl,
-    });
-    const sourceRoute = await signSourceRoute({
-        source: input.source,
-        fallbackUrl: input.chunk.source_url,
-        chunk: input.chunk,
-        expiresIn: input.expiresIn,
-        fetchImpl: input.fetchImpl
-    });
+    const objectKey = input.stagingObjectKey ?? targetObjectKey;
+    const [destUrl, sourceRoute] = await Promise.all([
+        signDestinationUrl({
+            destination: input.destination,
+            objectKey,
+            expiresIn: input.expiresIn,
+            fetchImpl: input.fetchImpl,
+        }),
+        signSourceRoute({
+            source: input.source,
+            fallbackUrl: input.chunk.source_url,
+            chunk: input.chunk,
+            expiresIn: input.expiresIn,
+            fetchImpl: input.fetchImpl
+        })
+    ]);
     return {
         source_id: input.chunk.source_id,
         destination_id: input.target.destination_id,
@@ -246,23 +253,14 @@ export async function signDestinationRoute(input) {
         headers: sourceRoute.headers,
         metadata: {
             ...(input.target.metadata ?? {}),
-            ...(input.transferId ? { transfer_id: input.transferId } : {}),
             ...(input.multipartGroupId ? { multipart_group_id: input.multipartGroupId } : {}),
-            ...(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 } : {}),
             ...(input.deleteUrl ? { delete_url: input.deleteUrl } : {}),
-            ...(input.uploadId ? { upload_id: input.uploadId } : {}),
-            ...(input.partNumber ? { part_number: input.partNumber } : {}),
-            ...(input.partVerifyUrl ? { part_verify_url: input.partVerifyUrl } : {}),
-            ...(input.listPageUrl ? { list_page_url: input.listPageUrl } : {}),
-            ...(input.completeUrl ? { complete_url: input.completeUrl } : {}),
-            ...(input.abortUrl ? { abort_url: input.abortUrl } : {}),
-            ...(input.listUrl ? { list_url: input.listUrl } : {})
+            ...(input.partNumber ? { part_number: input.partNumber } : {})
         }
     };
 }
@@ -301,14 +299,6 @@ async function signSourceRoute(input) {
 async function signDestinationUrl(input) {
     if (isS3CompatibleProvider(input.destination)) {
         const client = createS3CompatibleClient(input.destination);
-        if (input.uploadId && input.partNumber && !input.useStagingPut) {
-            return getSignedUrl(client, new UploadPartCommand({
-                Bucket: input.destination.bucket,
-                Key: input.uploadPartObjectKey,
-                UploadId: input.uploadId,
-                PartNumber: input.partNumber,
-            }), { expiresIn: input.expiresIn });
-        }
         return getSignedUrl(client, new PutObjectCommand({ Bucket: input.destination.bucket, Key: input.objectKey }), { expiresIn: input.expiresIn });
     }
     if (isHippiusProvider(input.destination)) {

package/package.json

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