@beam-network/sdk 0.5.17-dev.0 → 0.5.17-dev.1

package/README.md

@@ -178,3 +178,5 @@ Only short-lived range/upload routes go to workers. Multipart creation, verifica
 `listMultipartParts`, `completeMultipartUpload`, and `inspectDestinationObject` reuse the same provider client and return metadata only. ListParts walks every page; completion submits the selected provider-verified parts. Adapters must durably retain the upload and verified manifest before completion so restart recovery cannot infer delivery from size alone.
 
 Manual releases from `dev` require a committed `-dev.N` version and publish only to npm tag `dev`; the stable tag is unchanged.
+
+Multipart control helpers (`createMultipartUpload`, `listMultipartParts`, `completeMultipartUpload`, `inspectDestinationObject`, and `abortMultipartUpload`) accept an optional `AbortSignal` and cancel through the existing provider HTTP transport. Pass it as `signal` in object arguments or as the last positional argument. Cancellation stops waiting and network activity; it cannot undo a provider operation already accepted. After an interrupted completion, inspect the durable upload/object identity before retrying or reporting cleanup complete.

package/dist/provider-signing.d.ts

@@ -18,6 +18,7 @@ export declare function createMultipartUpload(input: {
     destination: ProviderDestinationConfig;
     objectKey: string;
     metadata: Record<string, string>;
+    signal?: AbortSignal;
 }): Promise<string>;
 export declare function signFinalObjectHead(destination: ProviderDestinationConfig, objectKey: string, expiresIn: number): Promise<string>;
 export declare function signCompleteMultipartUpload(destination: ProviderDestinationConfig, objectKey: string, uploadId: string, expiresIn: number): Promise<string>;
@@ -26,9 +27,9 @@ export declare function signListMultipartUpload(destination: ProviderDestination
     maxParts?: number;
     partNumberMarker?: number;
 }): Promise<string>;
-export declare function abortMultipartUpload(destination: ProviderDestinationConfig, objectKey: string, uploadId: string): Promise<void>;
+export declare function abortMultipartUpload(destination: ProviderDestinationConfig, objectKey: string, uploadId: string, signal?: AbortSignal): Promise<void>;
 /** Provider metadata only. These operations never read or proxy object bytes. */
-export declare function listMultipartParts(destination: ProviderDestinationConfig, objectKey: string, uploadId: string): Promise<{
+export declare function listMultipartParts(destination: ProviderDestinationConfig, objectKey: string, uploadId: string, signal?: AbortSignal): Promise<{
     partNumber: number;
     etag: string;
     size: number;
@@ -41,11 +42,12 @@ export declare function completeMultipartUpload(input: {
         partNumber: number;
         etag: string;
     }[];
+    signal?: AbortSignal;
 }): Promise<{
     etag: string | undefined;
     versionId: string | undefined;
 }>;
-export declare function inspectDestinationObject(destination: ProviderDestinationConfig, objectKey: string): Promise<{
+export declare function inspectDestinationObject(destination: ProviderDestinationConfig, objectKey: string, signal?: AbortSignal): Promise<{
     size: number | undefined;
     etag: string | undefined;
     versionId: string | undefined;

package/dist/provider-signing.js

@@ -152,7 +152,7 @@ export async function createMultipartUpload(input) {
             Bucket: input.destination.bucket,
             Key: input.objectKey,
             Metadata: input.metadata
-        }));
+        }), { abortSignal: input.signal });
         if (!response.UploadId) {
             throw new Error(`provider did not return UploadId for ${input.objectKey}`);
         }
@@ -194,15 +194,15 @@ export async function signListMultipartUpload(destination, objectKey, uploadId,
     }
     throw new Error(`multipart list-parts is not supported for ${destination.provider}`);
 }
-export async function abortMultipartUpload(destination, objectKey, uploadId) {
+export async function abortMultipartUpload(destination, objectKey, uploadId, signal) {
     if (isS3CompatibleProvider(destination)) {
-        await createS3CompatibleClient(destination).send(new AbortMultipartUploadCommand({ Bucket: destination.bucket, Key: objectKey, UploadId: uploadId }));
+        await createS3CompatibleClient(destination).send(new AbortMultipartUploadCommand({ Bucket: destination.bucket, Key: objectKey, UploadId: uploadId }), { abortSignal: signal });
         return;
     }
     throw new Error(`multipart abort is not supported for ${destination.provider}`);
 }
 /** Provider metadata only. These operations never read or proxy object bytes. */
-export async function listMultipartParts(destination, objectKey, uploadId) {
+export async function listMultipartParts(destination, objectKey, uploadId, signal) {
     if (!isS3CompatibleProvider(destination))
         return unsupportedProviderConfig(destination);
     const parts = [];
@@ -210,7 +210,7 @@ export async function listMultipartParts(destination, objectKey, uploadId) {
     do {
         const page = await createS3CompatibleClient(destination).send(new ListPartsCommand({
             Bucket: destination.bucket, Key: objectKey, UploadId: uploadId, MaxParts: 1000, PartNumberMarker: marker
-        }));
+        }), { abortSignal: signal });
         for (const part of page.Parts ?? []) {
             if (!part.PartNumber || !part.ETag || !Number.isSafeInteger(part.Size))
                 throw new Error("invalid multipart part metadata");
@@ -230,13 +230,13 @@ export async function completeMultipartUpload(input) {
         Bucket: input.destination.bucket, Key: input.objectKey, UploadId: input.uploadId,
         MultipartUpload: { Parts: [...input.parts].sort((a, b) => a.partNumber - b.partNumber)
                 .map((part) => ({ PartNumber: part.partNumber, ETag: part.etag })) }
-    }));
+    }), { abortSignal: input.signal });
     return { etag: result.ETag, versionId: result.VersionId };
 }
-export async function inspectDestinationObject(destination, objectKey) {
+export async function inspectDestinationObject(destination, objectKey, signal) {
     if (!isS3CompatibleProvider(destination))
         return unsupportedProviderConfig(destination);
-    const result = await createS3CompatibleClient(destination).send(new HeadObjectCommand({ Bucket: destination.bucket, Key: objectKey }));
+    const result = await createS3CompatibleClient(destination).send(new HeadObjectCommand({ Bucket: destination.bucket, Key: objectKey }), { abortSignal: signal });
     return { size: result.ContentLength, etag: result.ETag, versionId: result.VersionId, metadata: result.Metadata ?? {} };
 }
 export async function signDestinationRoute(input) {

package/package.json

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