@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/upload/stream.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/upload/stream.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAM5D,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,iBAAiB,CAAA;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IAC7C,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAmNnB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/upload/stream.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAK5D,OAAO,EACL,KAAK,qBAAqB,EAI3B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,YAAY,CAAA;AAEnB,8DAA8D;AAC9D,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB,EAAE,qBAAqB;IACzF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,iBAAiB,CAAA;IACjD;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IAC7C,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CA6VnB"}

package/dist/upload/stream.d.ts

@@ -4,8 +4,10 @@ import { ProgressListener } from '../streams/progress.js';
 import { EncryptionSetting } from '../types/encryption.js';
 import { FileVersion } from '../types/file.js';
 import { BucketId } from '../types/ids.js';
+import { CleanupFailureOptions } from './cancel.js';
+import { UploadRetryOptions } from './retry.js';
 /** Options for creating a streaming multipart upload sink. */
-export interface CreateWriteStreamOptions {
+export interface CreateWriteStreamOptions extends UploadRetryOptions, CleanupFailureOptions {
     /** Target bucket for the upload. */
     readonly bucketId: BucketId;
     /** Destination file name in the bucket. */
@@ -16,6 +18,12 @@ export interface CreateWriteStreamOptions {
     readonly fileInfo?: Record<string, string>;
     /** Server-side encryption applied to each part. */
     readonly serverSideEncryption?: EncryptionSetting;
+    /**
+     * B2 upload timestamp override in milliseconds since epoch.
+     * Sets the file version `uploadTimestamp`; distinct from `src_last_modified_millis` metadata.
+     * Requires B2 account enablement for Custom Upload Timestamp.
+     */
+    readonly customUploadTimestamp?: number;
     /**
      * Target part size in bytes. The stream buffers writes until this many bytes
      * are accumulated, then ships a part. Must be at least the account's

package/dist/upload/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/upload/stream.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAM5D,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,iBAAiB,CAAA;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IAC7C,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAmNnB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/upload/stream.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAK5D,OAAO,EACL,KAAK,qBAAqB,EAI3B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,YAAY,CAAA;AAEnB,8DAA8D;AAC9D,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB,EAAE,qBAAqB;IACzF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,iBAAiB,CAAA;IACjD;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IAC7C,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CA6VnB"}

package/dist/upload/stream.js

@@ -1,198 +1,324 @@
-import { IncrementalSha1 } from "../streams/hash.js";
+import { createAbortScope } from "./abort-scope.js";
+import { DEFAULT_CLEANUP_TIMEOUT_MS, cancelLargeFileBestEffort, resolveLargeFileErrorAfterCleanup } from "./cancel.js";
+import { Semaphore } from "./concurrency.js";
+import { abortReason, raceWithAbort } from "../util/abort.js";
+import { finishLargeFileWithAbortReconciliation } from "./finish.js";
+import "../util/defaults.js";
 import { ProgressTracker } from "../streams/progress.js";
-import { DEFAULT_TRANSFER_CONCURRENCY, DEFAULT_CONTENT_TYPE } from "../util/defaults.js";
+import { IncrementalSha1 } from "../streams/hash.js";
+import { resolveRetryResponseBodyFailures, uploadPartWithFreshUrl } from "./retry.js";
 import { toError } from "../util/to-error.js";
-import { cancelLargeFileBestEffort } from "./cancel.js";
-import { Semaphore } from "./concurrency.js";
+//#region src/upload/stream.ts
+/**
+* Creates a {@link WritableStream} that streams data into a B2 multipart upload.
+*
+* Buffers incoming chunks until `partSize` bytes are accumulated, ships each
+* complete part through the standard multipart engine, and finalizes the file
+* once the stream is closed. Honours backpressure via the queue's bounded
+* concurrency. Streaming uploads do not support resume because the total size
+* and per-part hashes aren't known in advance; use {@link uploadLargeFile} with
+* a buffered source when resume is required.
+*
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state (tokens, URLs, part URL pool).
+* @param options - Streaming upload parameters.
+*
+* @returns A {@link UploadWriteHandle} with the writable sink and a completion promise.
+*/
 function createWriteStream(raw, accountInfo, options) {
-  const minPartSize = accountInfo.getAbsoluteMinimumPartSize();
-  const recommendedPartSize = accountInfo.getRecommendedPartSize();
-  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize);
-  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY;
-  const tracker = new ProgressTracker(options.onProgress, null, null);
-  const sem = new Semaphore(concurrency);
-  let largeFileId = null;
-  let startPromise = null;
-  let nextPartNumber = 1;
-  let pendingBytes = 0;
-  const pending = [];
-  const partSha1s = [];
-  const inflight = [];
-  let errored = null;
-  const {
-    promise: done,
-    resolve: resolveDone,
-    reject: rejectDone
-  } = Promise.withResolvers();
-  done.catch(() => {
-  });
-  function ensureStarted() {
-    if (largeFileId !== null) return Promise.resolve(largeFileId);
-    if (startPromise !== null) return startPromise;
-    startPromise = (async () => {
-      const resp = await raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-        bucketId: options.bucketId,
-        fileName: options.fileName,
-        contentType: options.contentType ?? DEFAULT_CONTENT_TYPE,
-        fileInfo: options.fileInfo ?? {},
-        ...options.serverSideEncryption !== void 0 ? { serverSideEncryption: options.serverSideEncryption } : {}
-      });
-      largeFileId = resp.fileId;
-      return largeFileId;
-    })();
-    return startPromise;
-  }
-  async function shipPart(data, partNumber) {
-    const fileId = await ensureStarted();
-    const sha1 = new IncrementalSha1();
-    await sha1.update(data);
-    const sha1Hex = await sha1.digest();
-    let uploadEntry = accountInfo.checkoutPartUploadUrl(fileId);
-    if (!uploadEntry) {
-      const resp = await raw.getUploadPartUrl(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
-        fileId
-      });
-      uploadEntry = { uploadUrl: resp.uploadUrl, authorizationToken: resp.authorizationToken };
-    }
-    try {
-      const result = await raw.uploadPart(
-        uploadEntry.uploadUrl,
-        {
-          authorization: uploadEntry.authorizationToken,
-          partNumber,
-          contentLength: data.byteLength,
-          contentSha1: sha1Hex,
-          ...options.serverSideEncryption !== void 0 ? { serverSideEncryption: options.serverSideEncryption } : {}
-        },
-        data,
-        options.signal
-      );
-      accountInfo.returnPartUploadUrl(fileId, uploadEntry);
-      partSha1s[partNumber - 1] = result.contentSha1;
-      tracker.addBytes(data.byteLength);
-      tracker.completePart();
-    } catch (err) {
-      accountInfo.evictPartUploadUrl(fileId, uploadEntry);
-      throw err;
-    }
-  }
-  function dispatchPart() {
-    if (pending.length === 0) return;
-    let data;
-    if (pending.length === 1) {
-      const head = pending[0];
-      if (!head) return;
-      data = head;
-    } else {
-      const total = pending.reduce((sum, chunk) => sum + chunk.byteLength, 0);
-      data = new Uint8Array(total);
-      let offset = 0;
-      for (const chunk of pending) {
-        data.set(chunk, offset);
-        offset += chunk.byteLength;
-      }
-    }
-    pending.length = 0;
-    pendingBytes = 0;
-    const partNumber = nextPartNumber++;
-    const task = (async () => {
-      await sem.acquire();
-      try {
-        await shipPart(data, partNumber);
-      } catch (err) {
-        errored = toError(err);
-        throw err;
-      } finally {
-        sem.release();
-      }
-    })();
-    inflight.push(task);
-    task.catch(() => {
-    });
-  }
-  const writable = new WritableStream({
-    async write(chunk) {
-      if (errored) throw errored;
-      options.signal?.throwIfAborted();
-      pending.push(chunk);
-      pendingBytes += chunk.byteLength;
-      while (pendingBytes >= partSize) {
-        const carved = carveExact(pending, partSize);
-        const partNumber = nextPartNumber++;
-        pendingBytes -= partSize;
-        const task = (async () => {
-          await sem.acquire();
-          try {
-            await shipPart(carved, partNumber);
-          } catch (err) {
-            errored = toError(err);
-            throw err;
-          } finally {
-            sem.release();
-          }
-        })();
-        inflight.push(task);
-        task.catch(() => {
-        });
-      }
-    },
-    async close() {
-      try {
-        if (errored) throw errored;
-        options.signal?.throwIfAborted();
-        if (pendingBytes > 0) {
-          dispatchPart();
-        }
-        await Promise.all(inflight);
-        if (errored) throw errored;
-        if (largeFileId === null) {
-          throw new Error("createWriteStream closed without any data written.");
-        }
-        const result = await raw.finishLargeFile(
-          accountInfo.getApiUrl(),
-          accountInfo.getAuthToken(),
-          { fileId: largeFileId, partSha1Array: partSha1s }
-        );
-        resolveDone(result);
-      } catch (err) {
-        const fileIdToCancel = largeFileId;
-        if (fileIdToCancel !== null) {
-          await cancelLargeFileBestEffort(raw, accountInfo, fileIdToCancel);
-        }
-        rejectDone(err);
-        throw err;
-      }
-    },
-    async abort(reason) {
-      const fileIdToCancel = largeFileId;
-      if (fileIdToCancel !== null) {
-        await cancelLargeFileBestEffort(raw, accountInfo, fileIdToCancel);
-      }
-      rejectDone(toError(reason));
-    }
-  });
-  return { writable, done };
+	const minPartSize = accountInfo.getAbsoluteMinimumPartSize();
+	const recommendedPartSize = accountInfo.getRecommendedPartSize();
+	const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize);
+	const concurrency = options.concurrency ?? 4;
+	const tracker = new ProgressTracker(options.onProgress, null, null);
+	const sem = new Semaphore(concurrency);
+	const abortScope = createAbortScope(options.signal);
+	let largeFileId = null;
+	let startPromise = null;
+	let cancelAfterStartScheduled = false;
+	let nextPartNumber = 1;
+	let pendingBytes = 0;
+	const pending = [];
+	const partSha1s = [];
+	const inflight = [];
+	let errored = null;
+	const { promise: done, resolve: resolveDone, reject: rejectDone } = Promise.withResolvers();
+	done.catch(() => {});
+	function ensureStarted() {
+		if (largeFileId !== null) return Promise.resolve(largeFileId);
+		if (startPromise === null) startPromise = raw.startLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			bucketId: options.bucketId,
+			fileName: options.fileName,
+			contentType: options.contentType ?? "b2/x-auto",
+			fileInfo: options.fileInfo ?? {},
+			...options.customUploadTimestamp !== void 0 ? { customUploadTimestamp: String(options.customUploadTimestamp) } : {},
+			...options.serverSideEncryption !== void 0 ? { serverSideEncryption: options.serverSideEncryption } : {}
+		}, {
+			signal: abortScope.signal,
+			...options.retry !== void 0 ? { retry: options.retry } : {}
+		}).then((resp) => {
+			largeFileId = resp.fileId;
+			if (abortScope.signal.aborted || errored !== null) cancelStartedLargeFile(largeFileId);
+			return largeFileId;
+		});
+		const started = startPromise;
+		return raceWithAbort(started, abortScope.signal).catch((err) => {
+			if (abortScope.signal.aborted) scheduleCancelLargeFileAfterStart(started);
+			throw err;
+		});
+	}
+	async function shipPart(data, partNumber) {
+		if (errored !== null) throw errored;
+		abortScope.signal.throwIfAborted();
+		const fileId = await ensureStarted();
+		if (errored !== null) throw errored;
+		abortScope.signal.throwIfAborted();
+		const sha1 = new IncrementalSha1();
+		await sha1.update(data);
+		const sha1Hex = await sha1.digest();
+		abortScope.signal.throwIfAborted();
+		const result = await uploadPartWithFreshUrl(raw, accountInfo, fileId, {
+			fileName: options.fileName,
+			partNumber,
+			data,
+			contentLength: data.byteLength,
+			contentSha1: sha1Hex,
+			retry: options.retry,
+			signal: abortScope.signal,
+			onUploadRetry: options.onUploadRetry,
+			retryResponseBodyFailures: resolveRetryResponseBodyFailures(options.retryResponseBodyFailures),
+			...options.serverSideEncryption !== void 0 ? { serverSideEncryption: options.serverSideEncryption } : {}
+		});
+		partSha1s[partNumber - 1] = result.contentSha1;
+		tracker.addBytes(data.byteLength);
+		tracker.completePart();
+	}
+	function markErrored(err) {
+		const error = toError(err);
+		errored = error;
+		abortScope.abort(error);
+		return error;
+	}
+	function cancelStartedLargeFile(fileId) {
+		if (cancelAfterStartScheduled) return;
+		cancelAfterStartScheduled = true;
+		cancelLargeFileBestEffort(raw, accountInfo, fileId, cleanupWriteStreamOptions(options));
+	}
+	function scheduleCancelLargeFileAfterStart(started) {
+		started.then((fileId) => cancelStartedLargeFile(fileId)).catch(() => {});
+	}
+	async function settleInflightForClose() {
+		const settled = Promise.allSettled(inflight);
+		if (startPromise === null || largeFileId !== null) return await settled;
+		const abortWaiter = waitForAbort(abortScope.signal);
+		try {
+			if (await Promise.race([
+				settled.then(() => "settled"),
+				startPromise.then(() => "start-settled", () => "start-settled"),
+				abortWaiter.promise.then(() => "aborted")
+			]) === "aborted" && largeFileId === null) throw abortReason(abortScope.signal);
+			return await settled;
+		} finally {
+			abortWaiter.dispose();
+		}
+	}
+	function startPartWithAcquiredSlot(data, partNumber) {
+		const task = (async () => {
+			try {
+				await shipPart(data, partNumber);
+			} catch (err) {
+				markErrored(err);
+				throw err;
+			} finally {
+				sem.release();
+			}
+		})();
+		inflight.push(task);
+		task.catch(() => {});
+	}
+	async function acquirePartSlot() {
+		await sem.acquire();
+		if (errored !== null) {
+			sem.release();
+			throw errored;
+		}
+		try {
+			abortScope.signal.throwIfAborted();
+		} catch (err) {
+			sem.release();
+			throw err;
+		}
+	}
+	async function waitForInflightPartsToSettle(timeoutMs = DEFAULT_CLEANUP_TIMEOUT_MS) {
+		if (inflight.length === 0) return;
+		let timeout;
+		try {
+			await Promise.race([Promise.allSettled(inflight).then(() => void 0), new Promise((resolve) => {
+				timeout = setTimeout(resolve, timeoutMs);
+			})]);
+		} finally {
+			if (timeout !== void 0) clearTimeout(timeout);
+		}
+	}
+	async function dispatchPart() {
+		if (pending.length === 0) return;
+		await acquirePartSlot();
+		let data;
+		if (pending.length === 1) {
+			const head = pending[0];
+			if (!head) {
+				sem.release();
+				return;
+			}
+			data = head;
+		} else {
+			const total = pending.reduce((sum, chunk) => sum + chunk.byteLength, 0);
+			data = new Uint8Array(total);
+			let offset = 0;
+			for (const chunk of pending) {
+				data.set(chunk, offset);
+				offset += chunk.byteLength;
+			}
+		}
+		pending.length = 0;
+		pendingBytes = 0;
+		const partNumber = nextPartNumber++;
+		startPartWithAcquiredSlot(data, partNumber);
+	}
+	return {
+		writable: new WritableStream({
+			async write(chunk) {
+				if (errored) throw errored;
+				abortScope.signal.throwIfAborted();
+				if (chunk.byteLength === 0) return;
+				pending.push(chunk);
+				pendingBytes += chunk.byteLength;
+				while (pendingBytes >= partSize) {
+					await acquirePartSlot();
+					if (errored) {
+						sem.release();
+						throw errored;
+					}
+					const carved = carveExact(pending, partSize);
+					const partNumber = nextPartNumber++;
+					pendingBytes -= partSize;
+					startPartWithAcquiredSlot(carved, partNumber);
+				}
+			},
+			async close() {
+				try {
+					if (errored) throw errored;
+					abortScope.signal.throwIfAborted();
+					if (pendingBytes > 0) await dispatchPart();
+					const rejected = (await settleInflightForClose()).find((result) => result.status === "rejected");
+					if (rejected !== void 0 && errored === null) markErrored(rejected.reason);
+					if (errored) throw errored;
+					if (largeFileId === null) throw new Error("createWriteStream closed without any data written.");
+					const result = await finishLargeFileWithAbortReconciliation(raw, accountInfo, {
+						fileId: largeFileId,
+						bucketId: options.bucketId,
+						fileName: options.fileName,
+						partSha1s,
+						signal: abortScope.signal,
+						...options.retry !== void 0 ? { retry: options.retry } : {}
+					});
+					abortScope.dispose();
+					resolveDone(result);
+				} catch (err) {
+					const closeError = toError(err);
+					if (errored === null) errored = closeError;
+					abortScope.abort(errored);
+					const observedError = errored;
+					const fileIdToCancel = largeFileId;
+					if (fileIdToCancel === null && startPromise !== null) {
+						scheduleCancelLargeFileAfterStart(startPromise);
+						abortScope.dispose();
+						rejectDone(observedError);
+						throw observedError;
+					}
+					await Promise.allSettled(inflight);
+					let finalError = observedError;
+					if (fileIdToCancel !== null) finalError = await resolveLargeFileErrorAfterCleanup(observedError, raw, accountInfo, {
+						fileId: fileIdToCancel,
+						bucketId: options.bucketId,
+						fileName: options.fileName,
+						signal: options.signal,
+						onCleanupFailure: options.onCleanupFailure
+					});
+					abortScope.dispose();
+					rejectDone(finalError);
+					throw finalError;
+				}
+			},
+			async abort(reason) {
+				const abortError = markErrored(reason);
+				pending.length = 0;
+				pendingBytes = 0;
+				const fileIdToCancel = largeFileId;
+				if (fileIdToCancel === null && startPromise !== null) scheduleCancelLargeFileAfterStart(startPromise);
+				if (fileIdToCancel !== null) {
+					await waitForInflightPartsToSettle();
+					await cancelLargeFileBestEffort(raw, accountInfo, fileIdToCancel, cleanupWriteStreamOptions(options));
+				}
+				abortScope.dispose();
+				rejectDone(abortError);
+			}
+		}),
+		done
+	};
+}
+function cleanupWriteStreamOptions(options) {
+	return {
+		...options.signal !== void 0 ? { signal: options.signal } : {},
+		...options.onCleanupFailure !== void 0 ? { onCleanupFailure: options.onCleanupFailure } : {}
+	};
 }
+/**
+* Removes exactly `size` bytes from the front of `chunks` (mutates) and returns
+* them as a contiguous Uint8Array. Any trailing remainder of the last chunk
+* stays at the front of `chunks` for the next part.
+*
+* @param chunks - Queue of pending chunks. Modified in place.
+* @param size - Number of bytes to carve off the front.
+*
+* @returns A new Uint8Array containing exactly `size` bytes.
+*/
 function carveExact(chunks, size) {
-  const out = new Uint8Array(size);
-  let written = 0;
-  while (written < size && chunks.length > 0) {
-    const head = chunks[0];
-    if (!head) break;
-    const need = size - written;
-    if (head.byteLength <= need) {
-      out.set(head, written);
-      written += head.byteLength;
-      chunks.shift();
-    } else {
-      out.set(head.subarray(0, need), written);
-      chunks[0] = head.subarray(need);
-      written += need;
-    }
-  }
-  return out;
+	const out = new Uint8Array(size);
+	let written = 0;
+	while (written < size && chunks.length > 0) {
+		const head = chunks[0];
+		if (!head) break;
+		const need = size - written;
+		if (head.byteLength <= need) {
+			out.set(head, written);
+			written += head.byteLength;
+			chunks.shift();
+		} else {
+			out.set(head.subarray(0, need), written);
+			chunks[0] = head.subarray(need);
+			written += need;
+		}
+	}
+	return out;
+}
+function waitForAbort(signal) {
+	if (signal.aborted) return {
+		promise: Promise.resolve(abortReason(signal)),
+		dispose() {}
+	};
+	let onAbort;
+	return {
+		promise: new Promise((resolve) => {
+			onAbort = () => resolve(abortReason(signal));
+			signal.addEventListener("abort", onAbort, { once: true });
+		}),
+		dispose() {
+			if (onAbort !== void 0) signal.removeEventListener("abort", onAbort);
+		}
+	};
 }
-export {
-  createWriteStream
-};
-//# sourceMappingURL=stream.js.map
+//#endregion
+export { createWriteStream };
+
+//# sourceMappingURL=stream.js.map