@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/streams/source.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/streams/source.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,gEAAgE;IAChE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;IAChD,4CAA4C;IAC5C,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAA;IACpC,mDAAmD;IACnD,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACtC;AAED,8CAA8C;AAC9C,qBAAa,UAAW,YAAW,aAAa;IAUlC,OAAO,CAAC,QAAQ,CAAC,IAAI;IATjC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,QAAO;IAExB;;;OAGG;gBAC0B,IAAI,EAAE,IAAI;IAIvC;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAIhD;;;OAGG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAIpC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;CAGtC;AAED,mDAAmD;AACnD,qBAAa,YAAa,YAAW,aAAa;IAUpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,QAAO;IAExB;;;OAGG;gBAC0B,MAAM,EAAE,UAAU;IAI/C;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAIhD;;;OAGG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAUpC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;CAQtC;AAED,wGAAwG;AACxG,qBAAa,YAAa,YAAW,aAAa;IAkB9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjB3B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,SAAQ;IACzB,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAQ;IAExB;;;;OAIG;gBAEgB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACrD,IAAI,EAAE,MAAM;IAKd;;;;OAIG;IACH,KAAK,IAAI,aAAa;IAItB;;;;;OAKG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAMpC;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;CAI5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,EACrD,IAAI,CAAC,EAAE,MAAM,GACZ,aAAa,CAWf"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/streams/source.js"],"names":[],"mappings":"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"}

package/dist/streams/source.d.ts

@@ -1,6 +1,10 @@
+export { FileSource, type FileSourcePath } from './file-source.js';
+/** Maximum consecutive empty chunks tolerated from a forward-only stream. */
+export declare const MAX_EMPTY_STREAM_CHUNKS = 1024;
 /**
- * Uniform adapter for upload content. Wraps File, Blob, Buffer, or ReadableStream
- * behind a common interface so upload logic does not depend on the input type.
+ * Uniform adapter for upload content. Wraps File, Blob, Buffer, local files,
+ * async iterables, or ReadableStream behind a common interface so upload logic
+ * does not depend on the input type.
  */
 export interface ContentSource {
     /** Total size of the content in bytes. */
@@ -11,12 +15,12 @@ export interface ContentSource {
      * Whether {@link slice} is safe to call on this source.
      *
      * `true` for in-memory / random-access sources (`BufferSource`,
-     * `BlobSource`) — the multipart upload engine can dispatch part reads
-     * in parallel by slicing the source into disjoint ranges. `false`
-     * for forward-only sources (`StreamSource`) — the engine must read
-     * sequentially, one `partSize` chunk at a time. Callers that branch
-     * on this flag are expected to fall back to the sequential path
-     * rather than call `slice()` and catch the throw.
+     * `BlobSource`, `FileSource`) — the multipart upload engine can dispatch
+     * part reads in parallel by slicing the source into disjoint ranges.
+     * `false` for forward-only streams and async iterables — the engine must
+     * read sequentially, one `partSize` chunk at a time. Callers that branch on
+     * this flag are expected to fall back to the sequential path rather than call
+     * `slice()` and catch the throw.
      */
     readonly canSlice: boolean;
     /** Return a sub-range of this source as a new ContentSource. */
@@ -24,7 +28,9 @@ export interface ContentSource {
     /** Open the content as a ReadableStream. */
     stream(): ReadableStream<Uint8Array>;
     /** Read the entire content into an ArrayBuffer. */
-    toArrayBuffer(): Promise<ArrayBuffer>;
+    toArrayBuffer(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
 }
 /** ContentSource backed by a Blob or File. */
 export declare class BlobSource implements ContentSource {
@@ -53,9 +59,13 @@ export declare class BlobSource implements ContentSource {
     stream(): ReadableStream<Uint8Array>;
     /**
      * Read the entire Blob content into an ArrayBuffer.
+     * @param options - Optional abort signal used while reading.
+     *
      * @returns A promise that resolves with the full content as an ArrayBuffer.
      */
-    toArrayBuffer(): Promise<ArrayBuffer>;
+    toArrayBuffer(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
 }
 /** ContentSource backed by a Uint8Array buffer. */
 export declare class BufferSource implements ContentSource {
@@ -84,9 +94,13 @@ export declare class BufferSource implements ContentSource {
     stream(): ReadableStream<Uint8Array>;
     /**
      * Read the entire buffer content into an ArrayBuffer.
+     * @param options - Optional abort signal checked before returning bytes.
+     *
      * @returns A promise that resolves with the full content as an ArrayBuffer.
      */
-    toArrayBuffer(): Promise<ArrayBuffer>;
+    toArrayBuffer(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
 }
 /** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */
 export declare class StreamSource implements ContentSource {
@@ -122,19 +136,43 @@ export declare class StreamSource implements ContentSource {
     stream(): ReadableStream<Uint8Array>;
     /**
      * Read the entire stream into an ArrayBuffer.
+     * @param options - Optional abort signal used while reading.
+     *
      * @returns A promise that resolves with the full content as an ArrayBuffer.
      */
-    toArrayBuffer(): Promise<ArrayBuffer>;
+    toArrayBuffer(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
 }
 /**
- * Convert a Uint8Array, Blob, or ReadableStream into a {@link ContentSource}.
- * When passing a ReadableStream, the `size` parameter is required.
- * @param input - The content to wrap, as a Uint8Array, Blob, or ReadableStream.
- * @param size - The total byte length, required when input is a ReadableStream.
+ * Reads exactly the advertised number of bytes from a stream.
+ * @param stream - Stream to consume.
+ * @param expectedSize - Exact number of bytes expected from the stream.
+ * @param signal - Optional abort signal for cancelling the read.
+ *
+ * @returns A byte array of length `expectedSize`.
+ *
+ * @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.
+ */
+export declare function collectStreamExactly(stream: ReadableStream<Uint8Array>, expectedSize: number, signal?: AbortSignal): Promise<Uint8Array<ArrayBuffer>>;
+/**
+ * Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.
+ * @param reader - Locked reader for a Uint8Array stream.
+ * @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.
+ * @param signal - Optional abort signal that cancels the reader and rejects the read.
+ *
+ * @returns The next non-empty chunk or EOF result.
+ */
+export declare function readNextNonEmptyStreamChunk(reader: ReadableStreamDefaultReader<Uint8Array>, emptyChunkErrorMessage: string, signal?: AbortSignal): Promise<ReadableStreamReadResult<Uint8Array>>;
+/**
+ * Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.
+ * When passing a ReadableStream or async iterable, the `size` parameter is required.
+ * @param input - The content to wrap.
+ * @param size - The total byte length, required for forward-only inputs.
  *
  * @returns A ContentSource adapter for the given input.
  *
- * @throws If input is a ReadableStream and size is not provided.
+ * @throws If input is forward-only and size is not provided.
  */
-export declare function toContentSource(input: Uint8Array | Blob | ReadableStream<Uint8Array>, size?: number): ContentSource;
+export declare function toContentSource(input: Uint8Array | Blob | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>, size?: number): ContentSource;
 //# sourceMappingURL=source.d.ts.map

package/dist/streams/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/streams/source.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,gEAAgE;IAChE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;IAChD,4CAA4C;IAC5C,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAA;IACpC,mDAAmD;IACnD,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACtC;AAED,8CAA8C;AAC9C,qBAAa,UAAW,YAAW,aAAa;IAUlC,OAAO,CAAC,QAAQ,CAAC,IAAI;IATjC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,QAAO;IAExB;;;OAGG;gBAC0B,IAAI,EAAE,IAAI;IAIvC;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAIhD;;;OAGG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAIpC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;CAGtC;AAED,mDAAmD;AACnD,qBAAa,YAAa,YAAW,aAAa;IAUpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,QAAO;IAExB;;;OAGG;gBAC0B,MAAM,EAAE,UAAU;IAI/C;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAIhD;;;OAGG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAUpC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;CAQtC;AAED,wGAAwG;AACxG,qBAAa,YAAa,YAAW,aAAa;IAkB9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjB3B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,SAAQ;IACzB,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAQ;IAExB;;;;OAIG;gBAEgB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACrD,IAAI,EAAE,MAAM;IAKd;;;;OAIG;IACH,KAAK,IAAI,aAAa;IAItB;;;;;OAKG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAMpC;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;CAI5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,EACrD,IAAI,CAAC,EAAE,MAAM,GACZ,aAAa,CAWf"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/streams/source.js"],"names":[],"mappings":"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"}

package/dist/streams/source.js

@@ -1,155 +1,318 @@
+import { arrayBufferFor } from "../util/bytes.js";
 import { collectStream } from "./collect.js";
-class BlobSource {
-  /**
-   * Create a BlobSource wrapping the given Blob.
-   * @param blob - The Blob or File to use as the underlying content.
-   */
-  constructor(blob) {
-    this.blob = blob;
-    this.size = blob.size;
-  }
-  /** {@inheritDoc} */
-  size;
-  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */
-  canSlice = true;
-  /**
-   * Return a new BlobSource covering the specified byte range.
-   * @param start - The zero-based byte offset to begin the slice.
-   * @param end - The exclusive byte offset where the slice ends.
-   *
-   * @returns A new ContentSource representing the requested sub-range.
-   */
-  slice(start, end) {
-    return new BlobSource(this.blob.slice(start, end));
-  }
-  /**
-   * Open the Blob content as a ReadableStream.
-   * @returns A ReadableStream of the Blob bytes.
-   */
-  stream() {
-    return this.blob.stream();
-  }
-  /**
-   * Read the entire Blob content into an ArrayBuffer.
-   * @returns A promise that resolves with the full content as an ArrayBuffer.
-   */
-  toArrayBuffer() {
-    return this.blob.arrayBuffer();
-  }
+import { FileSource } from "./file-source.js";
+//#region src/streams/source.ts
+var READABLE_STREAM_SIZE_REQUIRED_ERROR = "size is required when using a ReadableStream as input.";
+var FORWARD_ONLY_SIZE_REQUIRED_ERROR = "size is required when using a forward-only content source as input.";
+var STREAM_SOURCE_ENDED_EARLY_ERROR = "StreamSource ended before the advertised byte count.";
+var STREAM_SOURCE_TOO_MANY_BYTES_ERROR = "StreamSource emitted more bytes than the advertised byte count.";
+var STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR = "StreamSource emitted too many empty chunks without data.";
+/** Maximum consecutive empty chunks tolerated from a forward-only stream. */
+var MAX_EMPTY_STREAM_CHUNKS = 1024;
+function asyncIterableToReadableStream(iterable) {
+	const iterator = iterable[Symbol.asyncIterator]();
+	return new ReadableStream({
+		async pull(controller) {
+			try {
+				const { done, value } = await iterator.next();
+				if (done === true) {
+					controller.close();
+					return;
+				}
+				if (!(value instanceof Uint8Array)) throw new TypeError("Async iterable content sources must yield Uint8Array chunks.");
+				controller.enqueue(value);
+			} catch (err) {
+				/* v8 ignore next -- Iterator-return failure must not mask the pull error. */
+				await returnAsyncIteratorBestEffort(iterator);
+				throw err;
+			}
+		},
+		async cancel(reason) {
+			await returnAsyncIteratorBestEffort(iterator, reason);
+		}
+	});
 }
-class BufferSource {
-  /**
-   * Create a BufferSource wrapping the given Uint8Array.
-   * @param buffer - The byte buffer to use as the underlying content.
-   */
-  constructor(buffer) {
-    this.buffer = buffer;
-    this.size = buffer.byteLength;
-  }
-  /** {@inheritDoc} */
-  size;
-  /** Random-access: the entire payload lives in memory. */
-  canSlice = true;
-  /**
-   * Return a new BufferSource covering the specified byte range.
-   * @param start - The zero-based byte offset to begin the slice.
-   * @param end - The exclusive byte offset where the slice ends.
-   *
-   * @returns A new ContentSource representing the requested sub-range.
-   */
-  slice(start, end) {
-    return new BufferSource(this.buffer.slice(start, end));
-  }
-  /**
-   * Open the buffer content as a ReadableStream.
-   * @returns A ReadableStream that emits the buffer bytes in a single chunk.
-   */
-  stream() {
-    const buffer = this.buffer;
-    return new ReadableStream({
-      start(controller) {
-        controller.enqueue(buffer);
-        controller.close();
-      }
-    });
-  }
-  /**
-   * Read the entire buffer content into an ArrayBuffer.
-   * @returns A promise that resolves with the full content as an ArrayBuffer.
-   */
-  toArrayBuffer() {
-    return Promise.resolve(
-      this.buffer.buffer.slice(
-        this.buffer.byteOffset,
-        this.buffer.byteOffset + this.buffer.byteLength
-      )
-    );
-  }
+async function returnAsyncIteratorBestEffort(iterator, reason) {
+	try {
+		await iterator.return?.(reason);
+	} catch {}
 }
-class StreamSource {
-  /**
-   * Create a StreamSource wrapping the given ReadableStream with a known byte size.
-   * @param readable - The ReadableStream to wrap as a content source.
-   * @param size - The total number of bytes the stream will produce.
-   */
-  constructor(readable, size) {
-    this.readable = readable;
-    this.size = size;
-  }
-  /** {@inheritDoc} */
-  size;
-  /**
-   * Forward-only: ReadableStreams cannot be repositioned, so multipart
-   * uploads must take the sequential path. See the interface comment on
-   * `canSlice` for what the engine does with this flag.
-   */
-  canSlice = false;
-  /** Whether the stream has already been read. */
-  consumed = false;
-  /**
-   * Always throws because streams cannot be sliced. Buffer the stream first.
-   *
-   * @throws If slicing is attempted on a stream-backed source.
-   */
-  slice() {
-    throw new Error("StreamSource does not support slicing. Buffer the stream first.");
-  }
-  /**
-   * Open the underlying ReadableStream. Can only be called once.
-   * @returns The underlying ReadableStream of bytes.
-   *
-   * @throws If the stream has already been consumed.
-   */
-  stream() {
-    if (this.consumed) throw new Error("StreamSource can only be consumed once.");
-    this.consumed = true;
-    return this.readable;
-  }
-  /**
-   * Read the entire stream into an ArrayBuffer.
-   * @returns A promise that resolves with the full content as an ArrayBuffer.
-   */
-  async toArrayBuffer() {
-    const bytes = await collectStream(this.stream());
-    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
-  }
+function isAsyncIterable(input) {
+	return typeof input === "object" && input !== null && Symbol.asyncIterator in input && typeof input[Symbol.asyncIterator] === "function";
 }
-function toContentSource(input, size) {
-  if (input instanceof Uint8Array) {
-    return new BufferSource(input);
-  }
-  if (input instanceof Blob) {
-    return new BlobSource(input);
-  }
-  if (size === void 0) {
-    throw new Error("size is required when using a ReadableStream as input.");
-  }
-  return new StreamSource(input, size);
+function isReadableStream(input) {
+	return typeof input === "object" && input !== null && typeof input.getReader === "function";
 }
-export {
-  BlobSource,
-  BufferSource,
-  StreamSource,
-  toContentSource
+/** ContentSource backed by a Blob or File. */
+var BlobSource = class BlobSource {
+	blob;
+	/** {@inheritDoc} */
+	size;
+	/** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */
+	canSlice = true;
+	/**
+	* Create a BlobSource wrapping the given Blob.
+	* @param blob - The Blob or File to use as the underlying content.
+	*/
+	constructor(blob) {
+		this.blob = blob;
+		this.size = blob.size;
+	}
+	/**
+	* Return a new BlobSource covering the specified byte range.
+	* @param start - The zero-based byte offset to begin the slice.
+	* @param end - The exclusive byte offset where the slice ends.
+	*
+	* @returns A new ContentSource representing the requested sub-range.
+	*/
+	slice(start, end) {
+		return new BlobSource(this.blob.slice(start, end));
+	}
+	/**
+	* Open the Blob content as a ReadableStream.
+	* @returns A ReadableStream of the Blob bytes.
+	*/
+	stream() {
+		return this.blob.stream();
+	}
+	/**
+	* Read the entire Blob content into an ArrayBuffer.
+	* @param options - Optional abort signal used while reading.
+	*
+	* @returns A promise that resolves with the full content as an ArrayBuffer.
+	*/
+	async toArrayBuffer(options = {}) {
+		options.signal?.throwIfAborted();
+		if (options.signal === void 0) return this.blob.arrayBuffer();
+		return arrayBufferFor(await collectStream(this.stream(), options));
+	}
+};
+/** ContentSource backed by a Uint8Array buffer. */
+var BufferSource = class BufferSource {
+	buffer;
+	/** {@inheritDoc} */
+	size;
+	/** Random-access: the entire payload lives in memory. */
+	canSlice = true;
+	/**
+	* Create a BufferSource wrapping the given Uint8Array.
+	* @param buffer - The byte buffer to use as the underlying content.
+	*/
+	constructor(buffer) {
+		this.buffer = buffer;
+		this.size = buffer.byteLength;
+	}
+	/**
+	* Return a new BufferSource covering the specified byte range.
+	* @param start - The zero-based byte offset to begin the slice.
+	* @param end - The exclusive byte offset where the slice ends.
+	*
+	* @returns A new ContentSource representing the requested sub-range.
+	*/
+	slice(start, end) {
+		return new BufferSource(this.buffer.slice(start, end));
+	}
+	/**
+	* Open the buffer content as a ReadableStream.
+	* @returns A ReadableStream that emits the buffer bytes in a single chunk.
+	*/
+	stream() {
+		const buffer = this.buffer;
+		return new ReadableStream({ start(controller) {
+			controller.enqueue(buffer);
+			controller.close();
+		} });
+	}
+	/**
+	* Read the entire buffer content into an ArrayBuffer.
+	* @param options - Optional abort signal checked before returning bytes.
+	*
+	* @returns A promise that resolves with the full content as an ArrayBuffer.
+	*/
+	async toArrayBuffer(options = {}) {
+		options.signal?.throwIfAborted();
+		return arrayBufferFor(this.buffer);
+	}
+};
+/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */
+var StreamSource = class {
+	readable;
+	/** {@inheritDoc} */
+	size;
+	/**
+	* Forward-only: ReadableStreams cannot be repositioned, so multipart
+	* uploads must take the sequential path. See the interface comment on
+	* `canSlice` for what the engine does with this flag.
+	*/
+	canSlice = false;
+	/** Whether the stream has already been read. */
+	consumed = false;
+	/**
+	* Create a StreamSource wrapping the given ReadableStream with a known byte size.
+	* @param readable - The ReadableStream to wrap as a content source.
+	* @param size - The total number of bytes the stream will produce.
+	*/
+	constructor(readable, size) {
+		this.readable = readable;
+		validateStreamSourceSize(size);
+		this.size = size;
+	}
+	/**
+	* Always throws because streams cannot be sliced. Buffer the stream first.
+	*
+	* @throws If slicing is attempted on a stream-backed source.
+	*/
+	slice() {
+		throw new Error("StreamSource does not support slicing. Buffer the stream first.");
+	}
+	/**
+	* Open the underlying ReadableStream. Can only be called once.
+	* @returns The underlying ReadableStream of bytes.
+	*
+	* @throws If the stream has already been consumed.
+	*/
+	stream() {
+		if (this.consumed) throw new Error("StreamSource can only be consumed once.");
+		this.consumed = true;
+		return this.readable;
+	}
+	/**
+	* Read the entire stream into an ArrayBuffer.
+	* @param options - Optional abort signal used while reading.
+	*
+	* @returns A promise that resolves with the full content as an ArrayBuffer.
+	*/
+	async toArrayBuffer(options = {}) {
+		return (await collectStreamExactly(this.stream(), this.size, options.signal)).buffer;
+	}
 };
-//# sourceMappingURL=source.js.map
+function validateStreamSourceSize(size) {
+	if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) throw new RangeError("StreamSource size must be a non-negative finite integer.");
+}
+/**
+* Reads exactly the advertised number of bytes from a stream.
+* @param stream - Stream to consume.
+* @param expectedSize - Exact number of bytes expected from the stream.
+* @param signal - Optional abort signal for cancelling the read.
+*
+* @returns A byte array of length `expectedSize`.
+*
+* @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.
+*/
+async function collectStreamExactly(stream, expectedSize, signal) {
+	const reader = stream.getReader();
+	const chunks = [];
+	let total = 0;
+	let completed = false;
+	try {
+		while (total < expectedSize) {
+			const { done, value } = await readNextNonEmptyStreamChunk(reader, STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR, signal);
+			if (done) throw new Error(STREAM_SOURCE_ENDED_EARLY_ERROR);
+			if (total + value.byteLength > expectedSize) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR);
+			chunks.push(value);
+			total += value.byteLength;
+		}
+		if (!(await readNextNonEmptyStreamChunk(reader, STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR, signal)).done) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR);
+		const result = new Uint8Array(expectedSize);
+		let offset = 0;
+		for (const chunk of chunks) {
+			result.set(chunk, offset);
+			offset += chunk.byteLength;
+		}
+		completed = true;
+		return result;
+	} finally {
+		if (!completed) cancelReaderBestEffort(reader);
+		try {
+			reader.releaseLock();
+		} catch {}
+	}
+}
+/**
+* Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.
+* @param reader - Locked reader for a Uint8Array stream.
+* @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.
+* @param signal - Optional abort signal that cancels the reader and rejects the read.
+*
+* @returns The next non-empty chunk or EOF result.
+*/
+async function readNextNonEmptyStreamChunk(reader, emptyChunkErrorMessage, signal) {
+	let emptyChunks = 0;
+	while (true) {
+		const result = await readStreamChunk(reader, signal);
+		if (result.done || result.value.byteLength > 0) return result;
+		emptyChunks += 1;
+		if (emptyChunks > 1024) throw new Error(emptyChunkErrorMessage);
+	}
+}
+async function readStreamChunk(reader, signal) {
+	if (signal === void 0) return reader.read();
+	if (signal.aborted) {
+		const reason = signal.reason ?? new DOMException("Aborted", "AbortError");
+		cancelReaderBestEffort(reader, reason);
+		throw reason;
+	}
+	let removeAbortListener;
+	const abort = new Promise((_, reject) => {
+		const onAbort = () => {
+			const reason = signal.reason ?? new DOMException("Aborted", "AbortError");
+			cancelReaderBestEffort(reader, reason);
+			reject(reason);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+	});
+	try {
+		const result = await Promise.race([reader.read(), abort]);
+		if (signal.aborted) {
+			const reason = signal.reason ?? new DOMException("Aborted", "AbortError");
+			cancelReaderBestEffort(reader, reason);
+			throw reason;
+		}
+		return result;
+	} finally {
+		removeAbortListener?.();
+	}
+}
+function cancelReaderBestEffort(reader, reason) {
+	/* v8 ignore next -- Reader cancellation failure is deliberately best-effort. */
+	reader.cancel(reason).catch(() => {});
+}
+/** ContentSource backed by a forward-only async iterable of Uint8Array chunks. */
+var AsyncIterableSource = class extends StreamSource {
+	/**
+	* Create an AsyncIterableSource from a known-size async iterable.
+	* @param iterable - Async iterable that yields Uint8Array chunks.
+	* @param size - Total byte length the iterable will produce.
+	*/
+	constructor(iterable, size) {
+		super(asyncIterableToReadableStream(iterable), size);
+	}
+};
+/**
+* Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.
+* When passing a ReadableStream or async iterable, the `size` parameter is required.
+* @param input - The content to wrap.
+* @param size - The total byte length, required for forward-only inputs.
+*
+* @returns A ContentSource adapter for the given input.
+*
+* @throws If input is forward-only and size is not provided.
+*/
+function toContentSource(input, size) {
+	if (input instanceof Uint8Array) return new BufferSource(input);
+	if (input instanceof Blob) return new BlobSource(input);
+	if (isReadableStream(input)) {
+		if (size === void 0) throw new Error(READABLE_STREAM_SIZE_REQUIRED_ERROR);
+		return new StreamSource(input, size);
+	}
+	if (isAsyncIterable(input)) {
+		if (size === void 0) throw new Error(FORWARD_ONLY_SIZE_REQUIRED_ERROR);
+		return new AsyncIterableSource(input, size);
+	}
+	throw new TypeError("Unsupported content source input.");
+}
+//#endregion
+export { BlobSource, BufferSource, FileSource, MAX_EMPTY_STREAM_CHUNKS, StreamSource, collectStreamExactly, readNextNonEmptyStreamChunk, toContentSource };
+
+//# sourceMappingURL=source.js.map