@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/copy/large.cjs

@@ -1,74 +1,117 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const ids = require("../types/ids.cjs");
-const cancel = require("../upload/cancel.cjs");
-const concurrency = require("../upload/concurrency.cjs");
-const defaults = require("../util/defaults.cjs");
-const planRanges = require("../util/plan-ranges.cjs");
+const require_file = require("../types/file.cjs");
+const require_ids = require("../types/ids.cjs");
+const require_abort_scope = require("../upload/abort-scope.cjs");
+const require_cancel = require("../upload/cancel.cjs");
+const require_concurrency = require("../upload/concurrency.cjs");
+const require_finish = require("../upload/finish.cjs");
+require("../util/defaults.cjs");
+const require_plan_ranges = require("../util/plan-ranges.cjs");
+//#region src/copy/large.ts
+/**
+* Performs a server-side copy of a file using the multipart `b2_copy_part` protocol.
+* The source bytes never traverse the client; B2 copies each range internally.
+*
+* Falls back to a single `copyFile` call when the source fits in one part.
+*
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state (used to resolve API URL, recommended part size).
+* @param options - Copy parameters including source, destination, and concurrency.
+*
+* @returns The resulting destination {@link FileVersion}.
+*/
 async function copyLargeFile(raw, accountInfo, options) {
-  const recommendedPartSize = accountInfo.getRecommendedPartSize();
-  const minPartSize = accountInfo.getAbsoluteMinimumPartSize();
-  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize);
-  const concurrency$1 = options.concurrency ?? defaults.DEFAULT_TRANSFER_CONCURRENCY;
-  const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-    fileId: options.sourceFileId
-  });
-  const totalSize = sourceInfo.contentLength;
-  if (totalSize <= partSize) {
-    return raw.copyFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-      sourceFileId: options.sourceFileId,
-      fileName: options.fileName,
-      ...options.destinationBucketId !== void 0 ? { destinationBucketId: options.destinationBucketId } : {},
-      ...options.contentType !== void 0 ? { contentType: options.contentType } : {},
-      ...options.fileInfo !== void 0 ? { fileInfo: options.fileInfo } : {},
-      ...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {},
-      ...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {}
-    });
-  }
-  const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId;
-  const startResp = await raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-    bucketId: destBucketId,
-    fileName: options.fileName,
-    contentType: options.contentType ?? sourceInfo.contentType ?? defaults.DEFAULT_CONTENT_TYPE,
-    fileInfo: options.fileInfo ?? {},
-    ...options.destinationServerSideEncryption !== void 0 ? { serverSideEncryption: options.destinationServerSideEncryption } : {}
-  });
-  const largeFileId = startResp.fileId;
-  const ranges = planRanges.planRanges(totalSize, partSize);
-  const partSha1s = new Array(ranges.length);
-  const sem = new concurrency.Semaphore(concurrency$1);
-  try {
-    options.signal?.throwIfAborted();
-    await Promise.all(
-      ranges.map(async (range) => {
-        await sem.acquire();
-        try {
-          options.signal?.throwIfAborted();
-          const resp = await raw.copyPart(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-            sourceFileId: options.sourceFileId,
-            // `startLargeFile` returns `LargeFileId`; `copyPart` takes the
-            // same value typed as `FileId`. Re-brand via the factory.
-            largeFileId: ids.fileId(largeFileId),
-            partNumber: range.partNumber,
-            range: planRanges.byteRangeHeader(range.start, range.end),
-            ...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {},
-            ...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {}
-          });
-          partSha1s[range.partNumber - 1] = resp.contentSha1;
-        } finally {
-          sem.release();
-        }
-      })
-    );
-    options.signal?.throwIfAborted();
-    return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-      fileId: largeFileId,
-      partSha1Array: partSha1s
-    });
-  } catch (err) {
-    await cancel.cancelLargeFileBestEffort(raw, accountInfo, largeFileId);
-    throw err;
-  }
+	options.signal?.throwIfAborted();
+	const recommendedPartSize = accountInfo.getRecommendedPartSize();
+	const minPartSize = accountInfo.getAbsoluteMinimumPartSize();
+	const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize);
+	const concurrency = options.concurrency ?? 4;
+	const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), { fileId: options.sourceFileId });
+	const totalSize = sourceInfo.contentLength;
+	if (totalSize <= partSize) {
+		options.signal?.throwIfAborted();
+		const replaceMetadata = options.contentType !== void 0 || options.fileInfo !== void 0;
+		return raw.copyFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			sourceFileId: options.sourceFileId,
+			fileName: options.fileName,
+			...options.destinationBucketId !== void 0 ? { destinationBucketId: options.destinationBucketId } : {},
+			...replaceMetadata ? {
+				metadataDirective: require_file.MetadataDirective.Replace,
+				contentType: options.contentType ?? sourceInfo.contentType ?? "b2/x-auto",
+				fileInfo: options.fileInfo ?? {}
+			} : {},
+			...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {},
+			...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {}
+		}, options.signal !== void 0 ? { signal: options.signal } : void 0);
+	}
+	const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId;
+	const ranges = require_plan_ranges.planRanges(totalSize, partSize);
+	const partSha1s = new Array(ranges.length);
+	const sem = new require_concurrency.Semaphore(concurrency);
+	const abortScope = require_abort_scope.createAbortScope(options.signal);
+	let largeFileId;
+	try {
+		abortScope.signal.throwIfAborted();
+		const startPromise = raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			bucketId: destBucketId,
+			fileName: options.fileName,
+			contentType: options.contentType ?? sourceInfo.contentType ?? "b2/x-auto",
+			fileInfo: options.fileInfo ?? {},
+			...options.destinationServerSideEncryption !== void 0 ? { serverSideEncryption: options.destinationServerSideEncryption } : {}
+		}, { signal: abortScope.signal });
+		try {
+			largeFileId = (await require_abort_scope.raceWithAbort(startPromise, abortScope.signal)).fileId;
+		} catch (err) {
+			if (abortScope.signal.aborted) cancelLargeFileAfterStart(startPromise, raw, accountInfo, options.onCleanupFailure);
+			throw err;
+		}
+		const startedLargeFileId = largeFileId;
+		if (startedLargeFileId === void 0) throw new Error("copyLargeFile: start did not return a large file ID.");
+		const tasks = ranges.map(async (range) => {
+			await sem.acquire();
+			try {
+				abortScope.signal.throwIfAborted();
+				const resp = await require_abort_scope.raceWithAbort(raw.copyPart(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+					sourceFileId: options.sourceFileId,
+					largeFileId: require_ids.fileId(startedLargeFileId),
+					partNumber: range.partNumber,
+					range: require_plan_ranges.byteRangeHeader(range.start, range.end),
+					...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {},
+					...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {}
+				}, { signal: abortScope.signal }), abortScope.signal);
+				partSha1s[range.partNumber - 1] = resp.contentSha1;
+			} catch (err) {
+				abortScope.abort(err);
+				throw err;
+			} finally {
+				sem.release();
+			}
+		});
+		require_abort_scope.throwRejectedOrAbortReason(await Promise.allSettled(tasks), abortScope);
+		return await require_finish.finishLargeFileWithAbortReconciliation(raw, accountInfo, {
+			fileId: startedLargeFileId,
+			bucketId: destBucketId,
+			fileName: options.fileName,
+			partSha1s,
+			signal: abortScope.signal
+		});
+	} catch (err) {
+		abortScope.abort(err);
+		if (largeFileId === void 0) throw err;
+		return await require_cancel.cleanupAfterLargeFileError(err, raw, accountInfo, {
+			fileId: largeFileId,
+			bucketId: destBucketId,
+			fileName: options.fileName,
+			signal: options.signal,
+			onCleanupFailure: options.onCleanupFailure
+		});
+	} finally {
+		abortScope.dispose();
+	}
 }
+function cancelLargeFileAfterStart(started, raw, accountInfo, onCleanupFailure) {
+	started.then((resp) => require_cancel.cancelLargeFileBestEffort(raw, accountInfo, resp.fileId, onCleanupFailure === void 0 ? void 0 : { onCleanupFailure })).catch(() => {});
+}
+//#endregion
 exports.copyLargeFile = copyLargeFile;
-//# sourceMappingURL=large.cjs.map
+
+//# sourceMappingURL=large.cjs.map

package/dist/copy/large.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"large.cjs","sources":["../../src/copy/large.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport type { FileVersion } from '../types/file.ts'\nimport { type BucketId, type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { cancelLargeFileBestEffort } from '../upload/cancel.ts'\nimport { Semaphore } from '../upload/concurrency.ts'\nimport { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\n\n/** Options for a server-side multipart copy. */\nexport interface CopyLargeFileOptions {\n  /** ID of the source file version to copy. */\n  readonly sourceFileId: FileId\n  /** Destination file name in the target bucket. */\n  readonly fileName: string\n  /** Target bucket. Defaults to the source's bucket. */\n  readonly destinationBucketId?: BucketId\n  /** Size of each part in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /**\n   * Maximum number of parts copied in parallel. Defaults to\n   * {@link DEFAULT_TRANSFER_CONCURRENCY}.\n   */\n  readonly concurrency?: number\n  /** MIME type for the destination file. Defaults to `b2/x-auto`. */\n  readonly contentType?: string\n  /** Custom file info merged into the destination. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption applied to the destination. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n  /** SSE-C settings used to read the source if it was uploaded with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /**\n   * Optional abort signal. Checked before dispatching each part and\n   * between parts; an aborted signal cancels remaining parts and rolls\n   * back the unfinished large file via best-effort `cancelLargeFile`.\n   *\n   * Aborting does NOT roll back parts already accepted by B2; those\n   * exist on the unfinished large file until the cancel call completes\n   * or B2's lifecycle expires the in-progress upload (24 hours).\n   */\n  readonly signal?: AbortSignal\n}\n\n/**\n * Performs a server-side copy of a file using the multipart `b2_copy_part` protocol.\n * The source bytes never traverse the client; B2 copies each range internally.\n *\n * Falls back to a single `copyFile` call when the source fits in one part.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state (used to resolve API URL, recommended part size).\n * @param options - Copy parameters including source, destination, and concurrency.\n *\n * @returns The resulting destination {@link FileVersion}.\n */\nexport async function copyLargeFile(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: CopyLargeFileOptions,\n): Promise<FileVersion> {\n  const recommendedPartSize = accountInfo.getRecommendedPartSize()\n  const minPartSize = accountInfo.getAbsoluteMinimumPartSize()\n  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize)\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n\n  // Discover the source size via getFileInfo.\n  const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n    fileId: options.sourceFileId,\n  })\n  const totalSize = sourceInfo.contentLength\n\n  // Below the part threshold, take the single-call fast path.\n  if (totalSize <= partSize) {\n    return raw.copyFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n      sourceFileId: options.sourceFileId,\n      fileName: options.fileName,\n      ...(options.destinationBucketId !== undefined\n        ? { destinationBucketId: options.destinationBucketId }\n        : {}),\n      ...(options.contentType !== undefined ? { contentType: options.contentType } : {}),\n      ...(options.fileInfo !== undefined ? { fileInfo: options.fileInfo } : {}),\n      ...(options.destinationServerSideEncryption !== undefined\n        ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n        : {}),\n      ...(options.sourceServerSideEncryption !== undefined\n        ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n        : {}),\n    })\n  }\n\n  // Resolve destination bucket (defaults to source's bucket). Both operands\n  // are already typed `BucketId`, so no cast is needed.\n  const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId\n\n  // Start the multipart file.\n  const startResp = await raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n    bucketId: destBucketId,\n    fileName: options.fileName,\n    contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,\n    fileInfo: options.fileInfo ?? {},\n    ...(options.destinationServerSideEncryption !== undefined\n      ? { serverSideEncryption: options.destinationServerSideEncryption }\n      : {}),\n  })\n  const largeFileId = startResp.fileId\n\n  const ranges = planRanges(totalSize, partSize)\n  const partSha1s: string[] = new Array(ranges.length)\n  const sem = new Semaphore(concurrency)\n\n  try {\n    options.signal?.throwIfAborted()\n    await Promise.all(\n      ranges.map(async (range) => {\n        await sem.acquire()\n        try {\n          // Re-check the abort flag after every queue handoff so the\n          // first cancelled task short-circuits the remaining parts.\n          options.signal?.throwIfAborted()\n          const resp = await raw.copyPart(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n            sourceFileId: options.sourceFileId,\n            // `startLargeFile` returns `LargeFileId`; `copyPart` takes the\n            // same value typed as `FileId`. Re-brand via the factory.\n            largeFileId: fileIdOf(largeFileId),\n            partNumber: range.partNumber,\n            range: byteRangeHeader(range.start, range.end),\n            ...(options.sourceServerSideEncryption !== undefined\n              ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n              : {}),\n            ...(options.destinationServerSideEncryption !== undefined\n              ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n              : {}),\n          })\n          partSha1s[range.partNumber - 1] = resp.contentSha1\n        } finally {\n          sem.release()\n        }\n      }),\n    )\n\n    options.signal?.throwIfAborted()\n    return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n      fileId: largeFileId,\n      partSha1Array: partSha1s,\n    })\n  } catch (err) {\n    await cancelLargeFileBestEffort(raw, accountInfo, largeFileId)\n    throw err\n  }\n}\n"],"names":["concurrency","DEFAULT_TRANSFER_CONCURRENCY","DEFAULT_CONTENT_TYPE","planRanges","Semaphore","fileIdOf","byteRangeHeader","cancelLargeFileBestEffort"],"mappings":";;;;;;;AAyDA,eAAsB,cACpB,KACA,aACA,SACsB;AACtB,QAAM,sBAAsB,YAAY,uBAAA;AACxC,QAAM,cAAc,YAAY,2BAAA;AAChC,QAAM,WAAW,KAAK,IAAI,QAAQ,YAAY,qBAAqB,WAAW;AAC9E,QAAMA,gBAAc,QAAQ,eAAeC,SAAAA;AAG3C,QAAM,aAAa,MAAM,IAAI,YAAY,YAAY,UAAA,GAAa,YAAY,gBAAgB;AAAA,IAC5F,QAAQ,QAAQ;AAAA,EAAA,CACjB;AACD,QAAM,YAAY,WAAW;AAG7B,MAAI,aAAa,UAAU;AACzB,WAAO,IAAI,SAAS,YAAY,aAAa,YAAY,gBAAgB;AAAA,MACvE,cAAc,QAAQ;AAAA,MACtB,UAAU,QAAQ;AAAA,MAClB,GAAI,QAAQ,wBAAwB,SAChC,EAAE,qBAAqB,QAAQ,oBAAA,IAC/B,CAAA;AAAA,MACJ,GAAI,QAAQ,gBAAgB,SAAY,EAAE,aAAa,QAAQ,YAAA,IAAgB,CAAA;AAAA,MAC/E,GAAI,QAAQ,aAAa,SAAY,EAAE,UAAU,QAAQ,SAAA,IAAa,CAAA;AAAA,MACtE,GAAI,QAAQ,oCAAoC,SAC5C,EAAE,iCAAiC,QAAQ,gCAAA,IAC3C,CAAA;AAAA,MACJ,GAAI,QAAQ,+BAA+B,SACvC,EAAE,4BAA4B,QAAQ,+BACtC,CAAA;AAAA,IAAC,CACN;AAAA,EACH;AAIA,QAAM,eAAe,QAAQ,uBAAuB,WAAW;AAG/D,QAAM,YAAY,MAAM,IAAI,eAAe,YAAY,UAAA,GAAa,YAAY,gBAAgB;AAAA,IAC9F,UAAU;AAAA,IACV,UAAU,QAAQ;AAAA,IAClB,aAAa,QAAQ,eAAe,WAAW,eAAeC,SAAAA;AAAAA,IAC9D,UAAU,QAAQ,YAAY,CAAA;AAAA,IAC9B,GAAI,QAAQ,oCAAoC,SAC5C,EAAE,sBAAsB,QAAQ,oCAChC,CAAA;AAAA,EAAC,CACN;AACD,QAAM,cAAc,UAAU;AAE9B,QAAM,SAASC,WAAAA,WAAW,WAAW,QAAQ;AAC7C,QAAM,YAAsB,IAAI,MAAM,OAAO,MAAM;AACnD,QAAM,MAAM,IAAIC,YAAAA,UAAUJ,aAAW;AAErC,MAAI;AACF,YAAQ,QAAQ,eAAA;AAChB,UAAM,QAAQ;AAAA,MACZ,OAAO,IAAI,OAAO,UAAU;AAC1B,cAAM,IAAI,QAAA;AACV,YAAI;AAGF,kBAAQ,QAAQ,eAAA;AAChB,gBAAM,OAAO,MAAM,IAAI,SAAS,YAAY,UAAA,GAAa,YAAY,gBAAgB;AAAA,YACnF,cAAc,QAAQ;AAAA;AAAA;AAAA,YAGtB,aAAaK,IAAAA,OAAS,WAAW;AAAA,YACjC,YAAY,MAAM;AAAA,YAClB,OAAOC,WAAAA,gBAAgB,MAAM,OAAO,MAAM,GAAG;AAAA,YAC7C,GAAI,QAAQ,+BAA+B,SACvC,EAAE,4BAA4B,QAAQ,2BAAA,IACtC,CAAA;AAAA,YACJ,GAAI,QAAQ,oCAAoC,SAC5C,EAAE,iCAAiC,QAAQ,oCAC3C,CAAA;AAAA,UAAC,CACN;AACD,oBAAU,MAAM,aAAa,CAAC,IAAI,KAAK;AAAA,QACzC,UAAA;AACE,cAAI,QAAA;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IAAA;AAGH,YAAQ,QAAQ,eAAA;AAChB,WAAO,MAAM,IAAI,gBAAgB,YAAY,aAAa,YAAY,gBAAgB;AAAA,MACpF,QAAQ;AAAA,MACR,eAAe;AAAA,IAAA,CAChB;AAAA,EACH,SAAS,KAAK;AACZ,UAAMC,iCAA0B,KAAK,aAAa,WAAW;AAC7D,UAAM;AAAA,EACR;AACF;;"}
+{"version":3,"file":"large.cjs","names":[],"sources":["../../src/copy/large.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport { type FileVersion, MetadataDirective } from '../types/file.ts'\nimport { type BucketId, type FileId, fileId as fileIdOf, type LargeFileId } from '../types/ids.ts'\nimport {\n  createAbortScope,\n  raceWithAbort,\n  throwRejectedOrAbortReason,\n} from '../upload/abort-scope.ts'\nimport {\n  type CleanupFailureListener,\n  cancelLargeFileBestEffort,\n  cleanupAfterLargeFileError,\n} from '../upload/cancel.ts'\nimport { Semaphore } from '../upload/concurrency.ts'\nimport { finishLargeFileWithAbortReconciliation } from '../upload/finish.ts'\nimport { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\n\n/** Options for a server-side multipart copy. */\nexport interface CopyLargeFileOptions {\n  /** ID of the source file version to copy. */\n  readonly sourceFileId: FileId\n  /** Destination file name in the target bucket. */\n  readonly fileName: string\n  /** Target bucket. Defaults to the source's bucket. */\n  readonly destinationBucketId?: BucketId\n  /** Size of each part in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /**\n   * Maximum number of parts copied in parallel. Defaults to\n   * {@link DEFAULT_TRANSFER_CONCURRENCY}.\n   */\n  readonly concurrency?: number\n  /** MIME type for the destination file. Defaults to `b2/x-auto`. */\n  readonly contentType?: string\n  /** Custom file info merged into the destination. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption applied to the destination. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n  /** SSE-C settings used to read the source if it was uploaded with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /**\n   * Callback invoked if best-effort cancellation fails, or if cancellation is\n   * skipped because `b2_finish_large_file` may already have committed.\n   */\n  readonly onCleanupFailure?: CleanupFailureListener\n  /**\n   * Optional abort signal. Checked before dispatching each part and\n   * between parts; an aborted signal cancels remaining parts and rolls\n   * back the unfinished large file via best-effort `cancelLargeFile`.\n   *\n   * Aborting does NOT roll back parts already accepted by B2; those\n   * exist on the unfinished large file until the cancel call completes\n   * or B2's lifecycle expires the in-progress upload (24 hours).\n   */\n  readonly signal?: AbortSignal\n}\n\n/**\n * Performs a server-side copy of a file using the multipart `b2_copy_part` protocol.\n * The source bytes never traverse the client; B2 copies each range internally.\n *\n * Falls back to a single `copyFile` call when the source fits in one part.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state (used to resolve API URL, recommended part size).\n * @param options - Copy parameters including source, destination, and concurrency.\n *\n * @returns The resulting destination {@link FileVersion}.\n */\nexport async function copyLargeFile(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: CopyLargeFileOptions,\n): Promise<FileVersion> {\n  options.signal?.throwIfAborted()\n  const recommendedPartSize = accountInfo.getRecommendedPartSize()\n  const minPartSize = accountInfo.getAbsoluteMinimumPartSize()\n  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize)\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n\n  // Discover the source size via getFileInfo.\n  const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n    fileId: options.sourceFileId,\n  })\n  const totalSize = sourceInfo.contentLength\n\n  // Below the part threshold, take the single-call fast path.\n  if (totalSize <= partSize) {\n    options.signal?.throwIfAborted()\n    // `b2_copy_file` only accepts replacement contentType/fileInfo under\n    // `metadataDirective: REPLACE`; supplying them in the default COPY mode is\n    // rejected by B2. When the caller sets either, switch to REPLACE with a\n    // required contentType (the override, else the source's, else b2/x-auto),\n    // matching the multipart path's metadata semantics below.\n    const replaceMetadata = options.contentType !== undefined || options.fileInfo !== undefined\n    return raw.copyFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      {\n        sourceFileId: options.sourceFileId,\n        fileName: options.fileName,\n        ...(options.destinationBucketId !== undefined\n          ? { destinationBucketId: options.destinationBucketId }\n          : {}),\n        ...(replaceMetadata\n          ? {\n              metadataDirective: MetadataDirective.Replace,\n              contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,\n              fileInfo: options.fileInfo ?? {},\n            }\n          : {}),\n        ...(options.destinationServerSideEncryption !== undefined\n          ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n          : {}),\n        ...(options.sourceServerSideEncryption !== undefined\n          ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n          : {}),\n      },\n      options.signal !== undefined ? { signal: options.signal } : undefined,\n    )\n  }\n\n  // Resolve destination bucket (defaults to source's bucket). Both operands\n  // are already typed `BucketId`, so no cast is needed.\n  const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId\n\n  const ranges = planRanges(totalSize, partSize)\n  const partSha1s: string[] = new Array(ranges.length)\n  const sem = new Semaphore(concurrency)\n  const abortScope = createAbortScope(options.signal)\n  let largeFileId: LargeFileId | undefined\n\n  try {\n    abortScope.signal.throwIfAborted()\n    const startPromise = raw.startLargeFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      {\n        bucketId: destBucketId,\n        fileName: options.fileName,\n        contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,\n        fileInfo: options.fileInfo ?? {},\n        ...(options.destinationServerSideEncryption !== undefined\n          ? { serverSideEncryption: options.destinationServerSideEncryption }\n          : {}),\n      },\n      { signal: abortScope.signal },\n    )\n    try {\n      const startResp = await raceWithAbort(startPromise, abortScope.signal)\n      largeFileId = startResp.fileId\n    } catch (err) {\n      if (abortScope.signal.aborted) {\n        cancelLargeFileAfterStart(startPromise, raw, accountInfo, options.onCleanupFailure)\n      }\n      throw err\n    }\n    const startedLargeFileId = largeFileId\n    if (startedLargeFileId === undefined) {\n      throw new Error('copyLargeFile: start did not return a large file ID.')\n    }\n\n    const tasks = ranges.map(async (range) => {\n      await sem.acquire()\n      try {\n        abortScope.signal.throwIfAborted()\n        const copyPromise = raw.copyPart(\n          accountInfo.getApiUrl(),\n          accountInfo.getAuthToken(),\n          {\n            sourceFileId: options.sourceFileId,\n            // `startLargeFile` returns `LargeFileId`; `copyPart` takes the\n            // same value typed as `FileId`. Re-brand via the factory.\n            largeFileId: fileIdOf(startedLargeFileId),\n            partNumber: range.partNumber,\n            range: byteRangeHeader(range.start, range.end),\n            ...(options.sourceServerSideEncryption !== undefined\n              ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n              : {}),\n            ...(options.destinationServerSideEncryption !== undefined\n              ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n              : {}),\n          },\n          { signal: abortScope.signal },\n        )\n        const resp = await raceWithAbort(copyPromise, abortScope.signal)\n        partSha1s[range.partNumber - 1] = resp.contentSha1\n      } catch (err) {\n        abortScope.abort(err)\n        throw err\n      } finally {\n        sem.release()\n      }\n    })\n\n    throwRejectedOrAbortReason(await Promise.allSettled(tasks), abortScope)\n\n    return await finishLargeFileWithAbortReconciliation(raw, accountInfo, {\n      fileId: startedLargeFileId,\n      bucketId: destBucketId,\n      fileName: options.fileName,\n      partSha1s,\n      signal: abortScope.signal,\n    })\n  } catch (err) {\n    abortScope.abort(err)\n    if (largeFileId === undefined) throw err\n    return await cleanupAfterLargeFileError(err, raw, accountInfo, {\n      fileId: largeFileId,\n      bucketId: destBucketId,\n      fileName: options.fileName,\n      signal: options.signal,\n      onCleanupFailure: options.onCleanupFailure,\n    })\n  } finally {\n    abortScope.dispose()\n  }\n}\n\nfunction cancelLargeFileAfterStart(\n  started: Promise<{ readonly fileId: LargeFileId }>,\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  onCleanupFailure: CleanupFailureListener | undefined,\n): void {\n  void started\n    .then((resp) =>\n      cancelLargeFileBestEffort(\n        raw,\n        accountInfo,\n        resp.fileId,\n        onCleanupFailure === undefined ? undefined : { onCleanupFailure },\n      ),\n    )\n    .catch(() => {\n      // If start failed, no file ID is available to cancel.\n    })\n}\n"],"mappings":"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"}

package/dist/copy/large.d.cts

@@ -3,6 +3,7 @@ import { RawClient } from '../raw/index.js';
 import { EncryptionSetting } from '../types/encryption.js';
 import { FileVersion } from '../types/file.js';
 import { BucketId, FileId } from '../types/ids.js';
+import { CleanupFailureListener } from '../upload/cancel.js';
 /** Options for a server-side multipart copy. */
 export interface CopyLargeFileOptions {
     /** ID of the source file version to copy. */
@@ -26,6 +27,11 @@ export interface CopyLargeFileOptions {
     readonly destinationServerSideEncryption?: EncryptionSetting;
     /** SSE-C settings used to read the source if it was uploaded with SSE-C. */
     readonly sourceServerSideEncryption?: EncryptionSetting;
+    /**
+     * Callback invoked if best-effort cancellation fails, or if cancellation is
+     * skipped because `b2_finish_large_file` may already have committed.
+     */
+    readonly onCleanupFailure?: CleanupFailureListener;
     /**
      * Optional abort signal. Checked before dispatching each part and
      * between parts; an aborted signal cancels remaining parts and rolls

package/dist/copy/large.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"large.d.ts","sourceRoot":"","sources":["../../src/copy/large.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAsB,MAAM,iBAAiB,CAAA;AAMhF,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAA;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,+BAA+B,CAAC,EAAE,iBAAiB,CAAA;IAC5D,4EAA4E;IAC5E,QAAQ,CAAC,0BAA0B,CAAC,EAAE,iBAAiB,CAAA;IACvD;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA0FtB"}
+{"version":3,"file":"large.d.ts","sourceRoot":"","sources":["../../src/copy/large.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAwC,MAAM,iBAAiB,CAAA;AAMlG,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,qBAAqB,CAAA;AAM5B,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAA;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,+BAA+B,CAAC,EAAE,iBAAiB,CAAA;IAC5D,4EAA4E;IAC5E,QAAQ,CAAC,0BAA0B,CAAC,EAAE,iBAAiB,CAAA;IACvD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;IAClD;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAgJtB"}

package/dist/copy/large.d.ts

@@ -3,6 +3,7 @@ import { RawClient } from '../raw/index.js';
 import { EncryptionSetting } from '../types/encryption.js';
 import { FileVersion } from '../types/file.js';
 import { BucketId, FileId } from '../types/ids.js';
+import { CleanupFailureListener } from '../upload/cancel.js';
 /** Options for a server-side multipart copy. */
 export interface CopyLargeFileOptions {
     /** ID of the source file version to copy. */
@@ -26,6 +27,11 @@ export interface CopyLargeFileOptions {
     readonly destinationServerSideEncryption?: EncryptionSetting;
     /** SSE-C settings used to read the source if it was uploaded with SSE-C. */
     readonly sourceServerSideEncryption?: EncryptionSetting;
+    /**
+     * Callback invoked if best-effort cancellation fails, or if cancellation is
+     * skipped because `b2_finish_large_file` may already have committed.
+     */
+    readonly onCleanupFailure?: CleanupFailureListener;
     /**
      * Optional abort signal. Checked before dispatching each part and
      * between parts; an aborted signal cancels remaining parts and rolls

package/dist/copy/large.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"large.d.ts","sourceRoot":"","sources":["../../src/copy/large.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAsB,MAAM,iBAAiB,CAAA;AAMhF,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAA;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,+BAA+B,CAAC,EAAE,iBAAiB,CAAA;IAC5D,4EAA4E;IAC5E,QAAQ,CAAC,0BAA0B,CAAC,EAAE,iBAAiB,CAAA;IACvD;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA0FtB"}
+{"version":3,"file":"large.d.ts","sourceRoot":"","sources":["../../src/copy/large.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAwC,MAAM,iBAAiB,CAAA;AAMlG,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,qBAAqB,CAAA;AAM5B,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAA;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,+BAA+B,CAAC,EAAE,iBAAiB,CAAA;IAC5D,4EAA4E;IAC5E,QAAQ,CAAC,0BAA0B,CAAC,EAAE,iBAAiB,CAAA;IACvD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;IAClD;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAgJtB"}

package/dist/copy/large.js

@@ -1,74 +1,117 @@
+import { MetadataDirective } from "../types/file.js";
 import { fileId } from "../types/ids.js";
-import { cancelLargeFileBestEffort } from "../upload/cancel.js";
+import { createAbortScope, raceWithAbort, throwRejectedOrAbortReason } from "../upload/abort-scope.js";
+import { cancelLargeFileBestEffort, cleanupAfterLargeFileError } from "../upload/cancel.js";
 import { Semaphore } from "../upload/concurrency.js";
-import { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from "../util/defaults.js";
+import { finishLargeFileWithAbortReconciliation } from "../upload/finish.js";
+import "../util/defaults.js";
 import { byteRangeHeader, planRanges } from "../util/plan-ranges.js";
+//#region src/copy/large.ts
+/**
+* Performs a server-side copy of a file using the multipart `b2_copy_part` protocol.
+* The source bytes never traverse the client; B2 copies each range internally.
+*
+* Falls back to a single `copyFile` call when the source fits in one part.
+*
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state (used to resolve API URL, recommended part size).
+* @param options - Copy parameters including source, destination, and concurrency.
+*
+* @returns The resulting destination {@link FileVersion}.
+*/
 async function copyLargeFile(raw, accountInfo, options) {
-  const recommendedPartSize = accountInfo.getRecommendedPartSize();
-  const minPartSize = accountInfo.getAbsoluteMinimumPartSize();
-  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize);
-  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY;
-  const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-    fileId: options.sourceFileId
-  });
-  const totalSize = sourceInfo.contentLength;
-  if (totalSize <= partSize) {
-    return raw.copyFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-      sourceFileId: options.sourceFileId,
-      fileName: options.fileName,
-      ...options.destinationBucketId !== void 0 ? { destinationBucketId: options.destinationBucketId } : {},
-      ...options.contentType !== void 0 ? { contentType: options.contentType } : {},
-      ...options.fileInfo !== void 0 ? { fileInfo: options.fileInfo } : {},
-      ...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {},
-      ...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {}
-    });
-  }
-  const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId;
-  const startResp = await raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-    bucketId: destBucketId,
-    fileName: options.fileName,
-    contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,
-    fileInfo: options.fileInfo ?? {},
-    ...options.destinationServerSideEncryption !== void 0 ? { serverSideEncryption: options.destinationServerSideEncryption } : {}
-  });
-  const largeFileId = startResp.fileId;
-  const ranges = planRanges(totalSize, partSize);
-  const partSha1s = new Array(ranges.length);
-  const sem = new Semaphore(concurrency);
-  try {
-    options.signal?.throwIfAborted();
-    await Promise.all(
-      ranges.map(async (range) => {
-        await sem.acquire();
-        try {
-          options.signal?.throwIfAborted();
-          const resp = await raw.copyPart(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-            sourceFileId: options.sourceFileId,
-            // `startLargeFile` returns `LargeFileId`; `copyPart` takes the
-            // same value typed as `FileId`. Re-brand via the factory.
-            largeFileId: fileId(largeFileId),
-            partNumber: range.partNumber,
-            range: byteRangeHeader(range.start, range.end),
-            ...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {},
-            ...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {}
-          });
-          partSha1s[range.partNumber - 1] = resp.contentSha1;
-        } finally {
-          sem.release();
-        }
-      })
-    );
-    options.signal?.throwIfAborted();
-    return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-      fileId: largeFileId,
-      partSha1Array: partSha1s
-    });
-  } catch (err) {
-    await cancelLargeFileBestEffort(raw, accountInfo, largeFileId);
-    throw err;
-  }
+	options.signal?.throwIfAborted();
+	const recommendedPartSize = accountInfo.getRecommendedPartSize();
+	const minPartSize = accountInfo.getAbsoluteMinimumPartSize();
+	const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize);
+	const concurrency = options.concurrency ?? 4;
+	const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), { fileId: options.sourceFileId });
+	const totalSize = sourceInfo.contentLength;
+	if (totalSize <= partSize) {
+		options.signal?.throwIfAborted();
+		const replaceMetadata = options.contentType !== void 0 || options.fileInfo !== void 0;
+		return raw.copyFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			sourceFileId: options.sourceFileId,
+			fileName: options.fileName,
+			...options.destinationBucketId !== void 0 ? { destinationBucketId: options.destinationBucketId } : {},
+			...replaceMetadata ? {
+				metadataDirective: MetadataDirective.Replace,
+				contentType: options.contentType ?? sourceInfo.contentType ?? "b2/x-auto",
+				fileInfo: options.fileInfo ?? {}
+			} : {},
+			...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {},
+			...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {}
+		}, options.signal !== void 0 ? { signal: options.signal } : void 0);
+	}
+	const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId;
+	const ranges = planRanges(totalSize, partSize);
+	const partSha1s = new Array(ranges.length);
+	const sem = new Semaphore(concurrency);
+	const abortScope = createAbortScope(options.signal);
+	let largeFileId;
+	try {
+		abortScope.signal.throwIfAborted();
+		const startPromise = raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			bucketId: destBucketId,
+			fileName: options.fileName,
+			contentType: options.contentType ?? sourceInfo.contentType ?? "b2/x-auto",
+			fileInfo: options.fileInfo ?? {},
+			...options.destinationServerSideEncryption !== void 0 ? { serverSideEncryption: options.destinationServerSideEncryption } : {}
+		}, { signal: abortScope.signal });
+		try {
+			largeFileId = (await raceWithAbort(startPromise, abortScope.signal)).fileId;
+		} catch (err) {
+			if (abortScope.signal.aborted) cancelLargeFileAfterStart(startPromise, raw, accountInfo, options.onCleanupFailure);
+			throw err;
+		}
+		const startedLargeFileId = largeFileId;
+		if (startedLargeFileId === void 0) throw new Error("copyLargeFile: start did not return a large file ID.");
+		const tasks = ranges.map(async (range) => {
+			await sem.acquire();
+			try {
+				abortScope.signal.throwIfAborted();
+				const resp = await raceWithAbort(raw.copyPart(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+					sourceFileId: options.sourceFileId,
+					largeFileId: fileId(startedLargeFileId),
+					partNumber: range.partNumber,
+					range: byteRangeHeader(range.start, range.end),
+					...options.sourceServerSideEncryption !== void 0 ? { sourceServerSideEncryption: options.sourceServerSideEncryption } : {},
+					...options.destinationServerSideEncryption !== void 0 ? { destinationServerSideEncryption: options.destinationServerSideEncryption } : {}
+				}, { signal: abortScope.signal }), abortScope.signal);
+				partSha1s[range.partNumber - 1] = resp.contentSha1;
+			} catch (err) {
+				abortScope.abort(err);
+				throw err;
+			} finally {
+				sem.release();
+			}
+		});
+		throwRejectedOrAbortReason(await Promise.allSettled(tasks), abortScope);
+		return await finishLargeFileWithAbortReconciliation(raw, accountInfo, {
+			fileId: startedLargeFileId,
+			bucketId: destBucketId,
+			fileName: options.fileName,
+			partSha1s,
+			signal: abortScope.signal
+		});
+	} catch (err) {
+		abortScope.abort(err);
+		if (largeFileId === void 0) throw err;
+		return await cleanupAfterLargeFileError(err, raw, accountInfo, {
+			fileId: largeFileId,
+			bucketId: destBucketId,
+			fileName: options.fileName,
+			signal: options.signal,
+			onCleanupFailure: options.onCleanupFailure
+		});
+	} finally {
+		abortScope.dispose();
+	}
 }
-export {
-  copyLargeFile
-};
-//# sourceMappingURL=large.js.map
+function cancelLargeFileAfterStart(started, raw, accountInfo, onCleanupFailure) {
+	started.then((resp) => cancelLargeFileBestEffort(raw, accountInfo, resp.fileId, onCleanupFailure === void 0 ? void 0 : { onCleanupFailure })).catch(() => {});
+}
+//#endregion
+export { copyLargeFile };
+
+//# sourceMappingURL=large.js.map

package/dist/copy/large.js.map

@@ -1 +1 @@
-{"version":3,"file":"large.js","sources":["../../src/copy/large.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport type { FileVersion } from '../types/file.ts'\nimport { type BucketId, type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { cancelLargeFileBestEffort } from '../upload/cancel.ts'\nimport { Semaphore } from '../upload/concurrency.ts'\nimport { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\n\n/** Options for a server-side multipart copy. */\nexport interface CopyLargeFileOptions {\n  /** ID of the source file version to copy. */\n  readonly sourceFileId: FileId\n  /** Destination file name in the target bucket. */\n  readonly fileName: string\n  /** Target bucket. Defaults to the source's bucket. */\n  readonly destinationBucketId?: BucketId\n  /** Size of each part in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /**\n   * Maximum number of parts copied in parallel. Defaults to\n   * {@link DEFAULT_TRANSFER_CONCURRENCY}.\n   */\n  readonly concurrency?: number\n  /** MIME type for the destination file. Defaults to `b2/x-auto`. */\n  readonly contentType?: string\n  /** Custom file info merged into the destination. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption applied to the destination. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n  /** SSE-C settings used to read the source if it was uploaded with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /**\n   * Optional abort signal. Checked before dispatching each part and\n   * between parts; an aborted signal cancels remaining parts and rolls\n   * back the unfinished large file via best-effort `cancelLargeFile`.\n   *\n   * Aborting does NOT roll back parts already accepted by B2; those\n   * exist on the unfinished large file until the cancel call completes\n   * or B2's lifecycle expires the in-progress upload (24 hours).\n   */\n  readonly signal?: AbortSignal\n}\n\n/**\n * Performs a server-side copy of a file using the multipart `b2_copy_part` protocol.\n * The source bytes never traverse the client; B2 copies each range internally.\n *\n * Falls back to a single `copyFile` call when the source fits in one part.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state (used to resolve API URL, recommended part size).\n * @param options - Copy parameters including source, destination, and concurrency.\n *\n * @returns The resulting destination {@link FileVersion}.\n */\nexport async function copyLargeFile(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: CopyLargeFileOptions,\n): Promise<FileVersion> {\n  const recommendedPartSize = accountInfo.getRecommendedPartSize()\n  const minPartSize = accountInfo.getAbsoluteMinimumPartSize()\n  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize)\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n\n  // Discover the source size via getFileInfo.\n  const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n    fileId: options.sourceFileId,\n  })\n  const totalSize = sourceInfo.contentLength\n\n  // Below the part threshold, take the single-call fast path.\n  if (totalSize <= partSize) {\n    return raw.copyFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n      sourceFileId: options.sourceFileId,\n      fileName: options.fileName,\n      ...(options.destinationBucketId !== undefined\n        ? { destinationBucketId: options.destinationBucketId }\n        : {}),\n      ...(options.contentType !== undefined ? { contentType: options.contentType } : {}),\n      ...(options.fileInfo !== undefined ? { fileInfo: options.fileInfo } : {}),\n      ...(options.destinationServerSideEncryption !== undefined\n        ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n        : {}),\n      ...(options.sourceServerSideEncryption !== undefined\n        ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n        : {}),\n    })\n  }\n\n  // Resolve destination bucket (defaults to source's bucket). Both operands\n  // are already typed `BucketId`, so no cast is needed.\n  const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId\n\n  // Start the multipart file.\n  const startResp = await raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n    bucketId: destBucketId,\n    fileName: options.fileName,\n    contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,\n    fileInfo: options.fileInfo ?? {},\n    ...(options.destinationServerSideEncryption !== undefined\n      ? { serverSideEncryption: options.destinationServerSideEncryption }\n      : {}),\n  })\n  const largeFileId = startResp.fileId\n\n  const ranges = planRanges(totalSize, partSize)\n  const partSha1s: string[] = new Array(ranges.length)\n  const sem = new Semaphore(concurrency)\n\n  try {\n    options.signal?.throwIfAborted()\n    await Promise.all(\n      ranges.map(async (range) => {\n        await sem.acquire()\n        try {\n          // Re-check the abort flag after every queue handoff so the\n          // first cancelled task short-circuits the remaining parts.\n          options.signal?.throwIfAborted()\n          const resp = await raw.copyPart(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n            sourceFileId: options.sourceFileId,\n            // `startLargeFile` returns `LargeFileId`; `copyPart` takes the\n            // same value typed as `FileId`. Re-brand via the factory.\n            largeFileId: fileIdOf(largeFileId),\n            partNumber: range.partNumber,\n            range: byteRangeHeader(range.start, range.end),\n            ...(options.sourceServerSideEncryption !== undefined\n              ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n              : {}),\n            ...(options.destinationServerSideEncryption !== undefined\n              ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n              : {}),\n          })\n          partSha1s[range.partNumber - 1] = resp.contentSha1\n        } finally {\n          sem.release()\n        }\n      }),\n    )\n\n    options.signal?.throwIfAborted()\n    return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n      fileId: largeFileId,\n      partSha1Array: partSha1s,\n    })\n  } catch (err) {\n    await cancelLargeFileBestEffort(raw, accountInfo, largeFileId)\n    throw err\n  }\n}\n"],"names":["fileIdOf"],"mappings":";;;;;AAyDA,eAAsB,cACpB,KACA,aACA,SACsB;AACtB,QAAM,sBAAsB,YAAY,uBAAA;AACxC,QAAM,cAAc,YAAY,2BAAA;AAChC,QAAM,WAAW,KAAK,IAAI,QAAQ,YAAY,qBAAqB,WAAW;AAC9E,QAAM,cAAc,QAAQ,eAAe;AAG3C,QAAM,aAAa,MAAM,IAAI,YAAY,YAAY,UAAA,GAAa,YAAY,gBAAgB;AAAA,IAC5F,QAAQ,QAAQ;AAAA,EAAA,CACjB;AACD,QAAM,YAAY,WAAW;AAG7B,MAAI,aAAa,UAAU;AACzB,WAAO,IAAI,SAAS,YAAY,aAAa,YAAY,gBAAgB;AAAA,MACvE,cAAc,QAAQ;AAAA,MACtB,UAAU,QAAQ;AAAA,MAClB,GAAI,QAAQ,wBAAwB,SAChC,EAAE,qBAAqB,QAAQ,oBAAA,IAC/B,CAAA;AAAA,MACJ,GAAI,QAAQ,gBAAgB,SAAY,EAAE,aAAa,QAAQ,YAAA,IAAgB,CAAA;AAAA,MAC/E,GAAI,QAAQ,aAAa,SAAY,EAAE,UAAU,QAAQ,SAAA,IAAa,CAAA;AAAA,MACtE,GAAI,QAAQ,oCAAoC,SAC5C,EAAE,iCAAiC,QAAQ,gCAAA,IAC3C,CAAA;AAAA,MACJ,GAAI,QAAQ,+BAA+B,SACvC,EAAE,4BAA4B,QAAQ,+BACtC,CAAA;AAAA,IAAC,CACN;AAAA,EACH;AAIA,QAAM,eAAe,QAAQ,uBAAuB,WAAW;AAG/D,QAAM,YAAY,MAAM,IAAI,eAAe,YAAY,UAAA,GAAa,YAAY,gBAAgB;AAAA,IAC9F,UAAU;AAAA,IACV,UAAU,QAAQ;AAAA,IAClB,aAAa,QAAQ,eAAe,WAAW,eAAe;AAAA,IAC9D,UAAU,QAAQ,YAAY,CAAA;AAAA,IAC9B,GAAI,QAAQ,oCAAoC,SAC5C,EAAE,sBAAsB,QAAQ,oCAChC,CAAA;AAAA,EAAC,CACN;AACD,QAAM,cAAc,UAAU;AAE9B,QAAM,SAAS,WAAW,WAAW,QAAQ;AAC7C,QAAM,YAAsB,IAAI,MAAM,OAAO,MAAM;AACnD,QAAM,MAAM,IAAI,UAAU,WAAW;AAErC,MAAI;AACF,YAAQ,QAAQ,eAAA;AAChB,UAAM,QAAQ;AAAA,MACZ,OAAO,IAAI,OAAO,UAAU;AAC1B,cAAM,IAAI,QAAA;AACV,YAAI;AAGF,kBAAQ,QAAQ,eAAA;AAChB,gBAAM,OAAO,MAAM,IAAI,SAAS,YAAY,UAAA,GAAa,YAAY,gBAAgB;AAAA,YACnF,cAAc,QAAQ;AAAA;AAAA;AAAA,YAGtB,aAAaA,OAAS,WAAW;AAAA,YACjC,YAAY,MAAM;AAAA,YAClB,OAAO,gBAAgB,MAAM,OAAO,MAAM,GAAG;AAAA,YAC7C,GAAI,QAAQ,+BAA+B,SACvC,EAAE,4BAA4B,QAAQ,2BAAA,IACtC,CAAA;AAAA,YACJ,GAAI,QAAQ,oCAAoC,SAC5C,EAAE,iCAAiC,QAAQ,oCAC3C,CAAA;AAAA,UAAC,CACN;AACD,oBAAU,MAAM,aAAa,CAAC,IAAI,KAAK;AAAA,QACzC,UAAA;AACE,cAAI,QAAA;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IAAA;AAGH,YAAQ,QAAQ,eAAA;AAChB,WAAO,MAAM,IAAI,gBAAgB,YAAY,aAAa,YAAY,gBAAgB;AAAA,MACpF,QAAQ;AAAA,MACR,eAAe;AAAA,IAAA,CAChB;AAAA,EACH,SAAS,KAAK;AACZ,UAAM,0BAA0B,KAAK,aAAa,WAAW;AAC7D,UAAM;AAAA,EACR;AACF;"}
+{"version":3,"file":"large.js","names":[],"sources":["../../src/copy/large.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport { type FileVersion, MetadataDirective } from '../types/file.ts'\nimport { type BucketId, type FileId, fileId as fileIdOf, type LargeFileId } from '../types/ids.ts'\nimport {\n  createAbortScope,\n  raceWithAbort,\n  throwRejectedOrAbortReason,\n} from '../upload/abort-scope.ts'\nimport {\n  type CleanupFailureListener,\n  cancelLargeFileBestEffort,\n  cleanupAfterLargeFileError,\n} from '../upload/cancel.ts'\nimport { Semaphore } from '../upload/concurrency.ts'\nimport { finishLargeFileWithAbortReconciliation } from '../upload/finish.ts'\nimport { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\n\n/** Options for a server-side multipart copy. */\nexport interface CopyLargeFileOptions {\n  /** ID of the source file version to copy. */\n  readonly sourceFileId: FileId\n  /** Destination file name in the target bucket. */\n  readonly fileName: string\n  /** Target bucket. Defaults to the source's bucket. */\n  readonly destinationBucketId?: BucketId\n  /** Size of each part in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /**\n   * Maximum number of parts copied in parallel. Defaults to\n   * {@link DEFAULT_TRANSFER_CONCURRENCY}.\n   */\n  readonly concurrency?: number\n  /** MIME type for the destination file. Defaults to `b2/x-auto`. */\n  readonly contentType?: string\n  /** Custom file info merged into the destination. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption applied to the destination. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n  /** SSE-C settings used to read the source if it was uploaded with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /**\n   * Callback invoked if best-effort cancellation fails, or if cancellation is\n   * skipped because `b2_finish_large_file` may already have committed.\n   */\n  readonly onCleanupFailure?: CleanupFailureListener\n  /**\n   * Optional abort signal. Checked before dispatching each part and\n   * between parts; an aborted signal cancels remaining parts and rolls\n   * back the unfinished large file via best-effort `cancelLargeFile`.\n   *\n   * Aborting does NOT roll back parts already accepted by B2; those\n   * exist on the unfinished large file until the cancel call completes\n   * or B2's lifecycle expires the in-progress upload (24 hours).\n   */\n  readonly signal?: AbortSignal\n}\n\n/**\n * Performs a server-side copy of a file using the multipart `b2_copy_part` protocol.\n * The source bytes never traverse the client; B2 copies each range internally.\n *\n * Falls back to a single `copyFile` call when the source fits in one part.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state (used to resolve API URL, recommended part size).\n * @param options - Copy parameters including source, destination, and concurrency.\n *\n * @returns The resulting destination {@link FileVersion}.\n */\nexport async function copyLargeFile(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: CopyLargeFileOptions,\n): Promise<FileVersion> {\n  options.signal?.throwIfAborted()\n  const recommendedPartSize = accountInfo.getRecommendedPartSize()\n  const minPartSize = accountInfo.getAbsoluteMinimumPartSize()\n  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize)\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n\n  // Discover the source size via getFileInfo.\n  const sourceInfo = await raw.getFileInfo(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n    fileId: options.sourceFileId,\n  })\n  const totalSize = sourceInfo.contentLength\n\n  // Below the part threshold, take the single-call fast path.\n  if (totalSize <= partSize) {\n    options.signal?.throwIfAborted()\n    // `b2_copy_file` only accepts replacement contentType/fileInfo under\n    // `metadataDirective: REPLACE`; supplying them in the default COPY mode is\n    // rejected by B2. When the caller sets either, switch to REPLACE with a\n    // required contentType (the override, else the source's, else b2/x-auto),\n    // matching the multipart path's metadata semantics below.\n    const replaceMetadata = options.contentType !== undefined || options.fileInfo !== undefined\n    return raw.copyFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      {\n        sourceFileId: options.sourceFileId,\n        fileName: options.fileName,\n        ...(options.destinationBucketId !== undefined\n          ? { destinationBucketId: options.destinationBucketId }\n          : {}),\n        ...(replaceMetadata\n          ? {\n              metadataDirective: MetadataDirective.Replace,\n              contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,\n              fileInfo: options.fileInfo ?? {},\n            }\n          : {}),\n        ...(options.destinationServerSideEncryption !== undefined\n          ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n          : {}),\n        ...(options.sourceServerSideEncryption !== undefined\n          ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n          : {}),\n      },\n      options.signal !== undefined ? { signal: options.signal } : undefined,\n    )\n  }\n\n  // Resolve destination bucket (defaults to source's bucket). Both operands\n  // are already typed `BucketId`, so no cast is needed.\n  const destBucketId = options.destinationBucketId ?? sourceInfo.bucketId\n\n  const ranges = planRanges(totalSize, partSize)\n  const partSha1s: string[] = new Array(ranges.length)\n  const sem = new Semaphore(concurrency)\n  const abortScope = createAbortScope(options.signal)\n  let largeFileId: LargeFileId | undefined\n\n  try {\n    abortScope.signal.throwIfAborted()\n    const startPromise = raw.startLargeFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      {\n        bucketId: destBucketId,\n        fileName: options.fileName,\n        contentType: options.contentType ?? sourceInfo.contentType ?? DEFAULT_CONTENT_TYPE,\n        fileInfo: options.fileInfo ?? {},\n        ...(options.destinationServerSideEncryption !== undefined\n          ? { serverSideEncryption: options.destinationServerSideEncryption }\n          : {}),\n      },\n      { signal: abortScope.signal },\n    )\n    try {\n      const startResp = await raceWithAbort(startPromise, abortScope.signal)\n      largeFileId = startResp.fileId\n    } catch (err) {\n      if (abortScope.signal.aborted) {\n        cancelLargeFileAfterStart(startPromise, raw, accountInfo, options.onCleanupFailure)\n      }\n      throw err\n    }\n    const startedLargeFileId = largeFileId\n    if (startedLargeFileId === undefined) {\n      throw new Error('copyLargeFile: start did not return a large file ID.')\n    }\n\n    const tasks = ranges.map(async (range) => {\n      await sem.acquire()\n      try {\n        abortScope.signal.throwIfAborted()\n        const copyPromise = raw.copyPart(\n          accountInfo.getApiUrl(),\n          accountInfo.getAuthToken(),\n          {\n            sourceFileId: options.sourceFileId,\n            // `startLargeFile` returns `LargeFileId`; `copyPart` takes the\n            // same value typed as `FileId`. Re-brand via the factory.\n            largeFileId: fileIdOf(startedLargeFileId),\n            partNumber: range.partNumber,\n            range: byteRangeHeader(range.start, range.end),\n            ...(options.sourceServerSideEncryption !== undefined\n              ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n              : {}),\n            ...(options.destinationServerSideEncryption !== undefined\n              ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n              : {}),\n          },\n          { signal: abortScope.signal },\n        )\n        const resp = await raceWithAbort(copyPromise, abortScope.signal)\n        partSha1s[range.partNumber - 1] = resp.contentSha1\n      } catch (err) {\n        abortScope.abort(err)\n        throw err\n      } finally {\n        sem.release()\n      }\n    })\n\n    throwRejectedOrAbortReason(await Promise.allSettled(tasks), abortScope)\n\n    return await finishLargeFileWithAbortReconciliation(raw, accountInfo, {\n      fileId: startedLargeFileId,\n      bucketId: destBucketId,\n      fileName: options.fileName,\n      partSha1s,\n      signal: abortScope.signal,\n    })\n  } catch (err) {\n    abortScope.abort(err)\n    if (largeFileId === undefined) throw err\n    return await cleanupAfterLargeFileError(err, raw, accountInfo, {\n      fileId: largeFileId,\n      bucketId: destBucketId,\n      fileName: options.fileName,\n      signal: options.signal,\n      onCleanupFailure: options.onCleanupFailure,\n    })\n  } finally {\n    abortScope.dispose()\n  }\n}\n\nfunction cancelLargeFileAfterStart(\n  started: Promise<{ readonly fileId: LargeFileId }>,\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  onCleanupFailure: CleanupFailureListener | undefined,\n): void {\n  void started\n    .then((resp) =>\n      cancelLargeFileBestEffort(\n        raw,\n        accountInfo,\n        resp.fileId,\n        onCleanupFailure === undefined ? undefined : { onCleanupFailure },\n      ),\n    )\n    .catch(() => {\n      // If start failed, no file ID is available to cancel.\n    })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwEA,eAAsB,cACpB,KACA,aACA,SACsB;CACtB,QAAQ,QAAQ,eAAe;CAC/B,MAAM,sBAAsB,YAAY,uBAAuB;CAC/D,MAAM,cAAc,YAAY,2BAA2B;CAC3D,MAAM,WAAW,KAAK,IAAI,QAAQ,YAAY,qBAAqB,WAAW;CAC9E,MAAM,cAAc,QAAQ,eAAA;CAG5B,MAAM,aAAa,MAAM,IAAI,YAAY,YAAY,UAAU,GAAG,YAAY,aAAa,GAAG,EAC5F,QAAQ,QAAQ,aAClB,CAAC;CACD,MAAM,YAAY,WAAW;CAG7B,IAAI,aAAa,UAAU;EACzB,QAAQ,QAAQ,eAAe;EAM/B,MAAM,kBAAkB,QAAQ,gBAAgB,KAAA,KAAa,QAAQ,aAAa,KAAA;EAClF,OAAO,IAAI,SACT,YAAY,UAAU,GACtB,YAAY,aAAa,GACzB;GACE,cAAc,QAAQ;GACtB,UAAU,QAAQ;GAClB,GAAI,QAAQ,wBAAwB,KAAA,IAChC,EAAE,qBAAqB,QAAQ,oBAAoB,IACnD,CAAC;GACL,GAAI,kBACA;IACE,mBAAmB,kBAAkB;IACrC,aAAa,QAAQ,eAAe,WAAW,eAAA;IAC/C,UAAU,QAAQ,YAAY,CAAC;GACjC,IACA,CAAC;GACL,GAAI,QAAQ,oCAAoC,KAAA,IAC5C,EAAE,iCAAiC,QAAQ,gCAAgC,IAC3E,CAAC;GACL,GAAI,QAAQ,+BAA+B,KAAA,IACvC,EAAE,4BAA4B,QAAQ,2BAA2B,IACjE,CAAC;EACP,GACA,QAAQ,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,KAAA,CAC9D;CACF;CAIA,MAAM,eAAe,QAAQ,uBAAuB,WAAW;CAE/D,MAAM,SAAS,WAAW,WAAW,QAAQ;CAC7C,MAAM,YAAsB,IAAI,MAAM,OAAO,MAAM;CACnD,MAAM,MAAM,IAAI,UAAU,WAAW;CACrC,MAAM,aAAa,iBAAiB,QAAQ,MAAM;CAClD,IAAI;CAEJ,IAAI;EACF,WAAW,OAAO,eAAe;EACjC,MAAM,eAAe,IAAI,eACvB,YAAY,UAAU,GACtB,YAAY,aAAa,GACzB;GACE,UAAU;GACV,UAAU,QAAQ;GAClB,aAAa,QAAQ,eAAe,WAAW,eAAA;GAC/C,UAAU,QAAQ,YAAY,CAAC;GAC/B,GAAI,QAAQ,oCAAoC,KAAA,IAC5C,EAAE,sBAAsB,QAAQ,gCAAgC,IAChE,CAAC;EACP,GACA,EAAE,QAAQ,WAAW,OAAO,CAC9B;EACA,IAAI;GAEF,eAAc,MADU,cAAc,cAAc,WAAW,MAAM,EAAA,CAC7C;EAC1B,SAAS,KAAK;GACZ,IAAI,WAAW,OAAO,SACpB,0BAA0B,cAAc,KAAK,aAAa,QAAQ,gBAAgB;GAEpF,MAAM;EACR;EACA,MAAM,qBAAqB;EAC3B,IAAI,uBAAuB,KAAA,GACzB,MAAM,IAAI,MAAM,sDAAsD;EAGxE,MAAM,QAAQ,OAAO,IAAI,OAAO,UAAU;GACxC,MAAM,IAAI,QAAQ;GAClB,IAAI;IACF,WAAW,OAAO,eAAe;IAoBjC,MAAM,OAAO,MAAM,cAnBC,IAAI,SACtB,YAAY,UAAU,GACtB,YAAY,aAAa,GACzB;KACE,cAAc,QAAQ;KAGtB,aAAa,OAAS,kBAAkB;KACxC,YAAY,MAAM;KAClB,OAAO,gBAAgB,MAAM,OAAO,MAAM,GAAG;KAC7C,GAAI,QAAQ,+BAA+B,KAAA,IACvC,EAAE,4BAA4B,QAAQ,2BAA2B,IACjE,CAAC;KACL,GAAI,QAAQ,oCAAoC,KAAA,IAC5C,EAAE,iCAAiC,QAAQ,gCAAgC,IAC3E,CAAC;IACP,GACA,EAAE,QAAQ,WAAW,OAAO,CAEG,GAAa,WAAW,MAAM;IAC/D,UAAU,MAAM,aAAa,KAAK,KAAK;GACzC,SAAS,KAAK;IACZ,WAAW,MAAM,GAAG;IACpB,MAAM;GACR,UAAU;IACR,IAAI,QAAQ;GACd;EACF,CAAC;EAED,2BAA2B,MAAM,QAAQ,WAAW,KAAK,GAAG,UAAU;EAEtE,OAAO,MAAM,uCAAuC,KAAK,aAAa;GACpE,QAAQ;GACR,UAAU;GACV,UAAU,QAAQ;GAClB;GACA,QAAQ,WAAW;EACrB,CAAC;CACH,SAAS,KAAK;EACZ,WAAW,MAAM,GAAG;EACpB,IAAI,gBAAgB,KAAA,GAAW,MAAM;EACrC,OAAO,MAAM,2BAA2B,KAAK,KAAK,aAAa;GAC7D,QAAQ;GACR,UAAU;GACV,UAAU,QAAQ;GAClB,QAAQ,QAAQ;GAChB,kBAAkB,QAAQ;EAC5B,CAAC;CACH,UAAU;EACR,WAAW,QAAQ;CACrB;AACF;AAEA,SAAS,0BACP,SACA,KACA,aACA,kBACM;CACN,QACG,MAAM,SACL,0BACE,KACA,aACA,KAAK,QACL,qBAAqB,KAAA,IAAY,KAAA,IAAY,EAAE,iBAAiB,CAClE,CACF,CAAC,CACA,YAAY,CAEb,CAAC;AACL"}