@backblaze-labs/b2-sdk 0.2.0 → 0.4.0

package/dist/streams/progress.d.ts

@@ -13,6 +13,16 @@ export interface ProgressEvent {
 }
 /** Callback invoked each time transfer progress changes. */
 export type ProgressListener = (event: ProgressEvent) => void;
+/** Default minimum time between byte-progress emissions. */
+export declare const DEFAULT_PROGRESS_EMIT_INTERVAL_MS = 100;
+/** Internal controls for ProgressTracker emission behavior. */
+export interface ProgressTrackerOptions {
+    /**
+     * Minimum milliseconds between byte-only progress emissions.
+     * Set to 0 to emit every change.
+     */
+    readonly minIntervalMs?: number;
+}
 /**
  * Accumulates byte and part counts and emits {@link ProgressEvent}s to a listener.
  *
@@ -33,20 +43,36 @@ export declare class ProgressTracker {
     private partsCompleted;
     /** Timestamp when tracking began. */
     private readonly startTime;
+    /** Minimum milliseconds between byte-only emissions. */
+    private readonly minIntervalMs;
+    /** Timestamp of the most recent emitted snapshot. */
+    private lastEmitTime;
+    /** Timer scheduled for a coalesced byte-only emission. */
+    private pendingEmitTimer;
+    /** Listener error captured from a detached timer callback. */
+    private listenerError;
     /**
      * Creates a new ProgressTracker.
      * @param listener - Callback to receive progress events, or undefined to disable.
      * @param totalBytes - Expected total bytes, or null if unknown.
      * @param totalParts - Expected total parts, or null if not a multipart transfer.
+     * @param options - Optional emission controls.
      */
-    constructor(listener: ProgressListener | undefined, totalBytes: number | null, totalParts: number | null);
+    constructor(listener: ProgressListener | undefined, totalBytes: number | null, totalParts: number | null, options?: ProgressTrackerOptions);
     /**
-     * Record that additional bytes have been transferred and notify the listener.
+     * Record that additional bytes have been transferred and schedule listener notification.
      * @param count - The number of additional bytes that were transferred.
      */
     addBytes(count: number): void;
     /** Record that a multipart part has completed and notify the listener. */
     completePart(): void;
+    /** Cancel any pending coalesced progress emission. */
+    dispose(): void;
+    private emitThrottled;
+    private flushPendingEmit;
+    private clearPendingEmit;
+    private emitNow;
+    private throwPendingListenerError;
     /** Emit the current progress snapshot to the listener, if one is registered. */
     private emit;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/streams/progress.js"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAE7D;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAexB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAhB7B,0CAA0C;IAC1C,OAAO,CAAC,gBAAgB,CAAI;IAC5B,wCAAwC;IACxC,OAAO,CAAC,cAAc,CAAI;IAC1B,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAElC;;;;;OAKG;gBAEgB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,UAAU,EAAE,MAAM,GAAG,IAAI;IAK5C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,0EAA0E;IAC1E,YAAY,IAAI,IAAI;IAKpB,gFAAgF;IAChF,OAAO,CAAC,IAAI;CASb"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/streams/progress.js"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAE7D,4DAA4D;AAC5D,eAAO,MAAM,iCAAiC,MAAM,CAAA;AAEpD,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAwBxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAzB7B,0CAA0C;IAC1C,OAAO,CAAC,gBAAgB,CAAI;IAC5B,wCAAwC;IACxC,OAAO,CAAC,cAAc,CAAI;IAC1B,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,qDAAqD;IACrD,OAAO,CAAC,YAAY,CAAsB;IAC1C,0DAA0D;IAC1D,OAAO,CAAC,gBAAgB,CAA2C;IACnE,8DAA8D;IAC9D,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;;;OAMG;gBAEgB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,UAAU,EAAE,MAAM,GAAG,IAAI,EAC1C,OAAO,GAAE,sBAA2B;IAMtC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,0EAA0E;IAC1E,YAAY,IAAI,IAAI;IAOpB,sDAAsD;IACtD,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,yBAAyB;IAOjC,gFAAgF;IAChF,OAAO,CAAC,IAAI;CASb"}

package/dist/streams/progress.js

@@ -1,4 +1,3 @@
-//#region src/streams/progress.ts
 /**
 * Accumulates byte and part counts and emits {@link ProgressEvent}s to a listener.
 *
@@ -19,31 +18,91 @@ var ProgressTracker = class {
 	partsCompleted = 0;
 	/** Timestamp when tracking began. */
 	startTime;
+	/** Minimum milliseconds between byte-only emissions. */
+	minIntervalMs;
+	/** Timestamp of the most recent emitted snapshot. */
+	lastEmitTime = null;
+	/** Timer scheduled for a coalesced byte-only emission. */
+	pendingEmitTimer;
+	/** Listener error captured from a detached timer callback. */
+	listenerError;
 	/**
 	* Creates a new ProgressTracker.
 	* @param listener - Callback to receive progress events, or undefined to disable.
 	* @param totalBytes - Expected total bytes, or null if unknown.
 	* @param totalParts - Expected total parts, or null if not a multipart transfer.
+	* @param options - Optional emission controls.
 	*/
-	constructor(listener, totalBytes, totalParts) {
+	constructor(listener, totalBytes, totalParts, options = {}) {
 		this.listener = listener;
 		this.totalBytes = totalBytes;
 		this.totalParts = totalParts;
 		this.startTime = Date.now();
+		this.minIntervalMs = Math.max(0, options.minIntervalMs ?? 100);
 	}
 	/**
-	* Record that additional bytes have been transferred and notify the listener.
+	* Record that additional bytes have been transferred and schedule listener notification.
 	* @param count - The number of additional bytes that were transferred.
 	*/
 	addBytes(count) {
+		this.throwPendingListenerError();
 		this.bytesTransferred += count;
-		this.emit();
+		this.emitThrottled();
 	}
 	/** Record that a multipart part has completed and notify the listener. */
 	completePart() {
+		this.throwPendingListenerError();
+		this.flushPendingEmit();
 		this.partsCompleted++;
+		this.emitNow();
+	}
+	/** Cancel any pending coalesced progress emission. */
+	dispose() {
+		this.clearPendingEmit();
+		this.listenerError = void 0;
+	}
+	emitThrottled() {
+		if (this.listener === void 0) return;
+		if (this.minIntervalMs === 0) {
+			this.emitNow();
+			return;
+		}
+		const now = Date.now();
+		if (this.lastEmitTime === null || now - this.lastEmitTime >= this.minIntervalMs) {
+			this.emitNow(now);
+			return;
+		}
+		if (this.pendingEmitTimer !== void 0) return;
+		const delay = Math.max(0, this.minIntervalMs - (now - this.lastEmitTime));
+		this.pendingEmitTimer = setTimeout(() => {
+			this.pendingEmitTimer = void 0;
+			try {
+				this.emitNow();
+			} catch (err) {
+				this.listenerError = err;
+			}
+		}, delay);
+		this.pendingEmitTimer.unref?.();
+	}
+	flushPendingEmit() {
+		if (this.pendingEmitTimer !== void 0) this.emitNow();
+	}
+	clearPendingEmit() {
+		if (this.pendingEmitTimer === void 0) return;
+		clearTimeout(this.pendingEmitTimer);
+		this.pendingEmitTimer = void 0;
+	}
+	emitNow(now = Date.now()) {
+		this.clearPendingEmit();
+		this.lastEmitTime = now;
 		this.emit();
 	}
+	throwPendingListenerError() {
+		if (this.listenerError === void 0) return;
+		const err = this.listenerError;
+		this.listenerError = void 0;
+		throw err;
+	}
 	/** Emit the current progress snapshot to the listener, if one is registered. */
 	emit() {
 		this.listener?.({

package/dist/streams/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","names":[],"sources":["../../src/streams/progress.ts"],"sourcesContent":["/** Snapshot of upload or download progress at a point in time. */\nexport interface ProgressEvent {\n  /** Number of bytes transferred so far. */\n  readonly bytesTransferred: number\n  /** Total bytes expected, or null if unknown. */\n  readonly totalBytes: number | null\n  /** Number of multipart parts completed so far. */\n  readonly partsCompleted: number\n  /** Total number of parts expected, or null if unknown. */\n  readonly totalParts: number | null\n  /** Milliseconds elapsed since the operation started. */\n  readonly elapsedMs: number\n}\n\n/** Callback invoked each time transfer progress changes. */\nexport type ProgressListener = (event: ProgressEvent) => void\n\n/**\n * Accumulates byte and part counts and emits {@link ProgressEvent}s to a listener.\n *\n * Internal building block. The SDK wires one of these inside every\n * transfer that accepts an `onProgress` option; users supply the\n * listener callback, not the tracker. Exported only so SDK source\n * modules can import it; not re-exported through any subpath.\n *\n * @internal\n */\nexport class ProgressTracker {\n  /** Running total of bytes transferred. */\n  private bytesTransferred = 0\n  /** Running count of completed parts. */\n  private partsCompleted = 0\n  /** Timestamp when tracking began. */\n  private readonly startTime: number\n\n  /**\n   * Creates a new ProgressTracker.\n   * @param listener - Callback to receive progress events, or undefined to disable.\n   * @param totalBytes - Expected total bytes, or null if unknown.\n   * @param totalParts - Expected total parts, or null if not a multipart transfer.\n   */\n  constructor(\n    private readonly listener: ProgressListener | undefined,\n    private readonly totalBytes: number | null,\n    private readonly totalParts: number | null,\n  ) {\n    this.startTime = Date.now()\n  }\n\n  /**\n   * Record that additional bytes have been transferred and notify the listener.\n   * @param count - The number of additional bytes that were transferred.\n   */\n  addBytes(count: number): void {\n    this.bytesTransferred += count\n    this.emit()\n  }\n\n  /** Record that a multipart part has completed and notify the listener. */\n  completePart(): void {\n    this.partsCompleted++\n    this.emit()\n  }\n\n  /** Emit the current progress snapshot to the listener, if one is registered. */\n  private emit(): void {\n    this.listener?.({\n      bytesTransferred: this.bytesTransferred,\n      totalBytes: this.totalBytes,\n      partsCompleted: this.partsCompleted,\n      totalParts: this.totalParts,\n      elapsedMs: Date.now() - this.startTime,\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;;AA2BA,IAAa,kBAAb,MAA6B;CAeR;CACA;CACA;;CAfnB,mBAA2B;;CAE3B,iBAAyB;;CAEzB;;;;;;;CAQA,YACE,UACA,YACA,YACA;EAHiB,KAAA,WAAA;EACA,KAAA,aAAA;EACA,KAAA,aAAA;EAEjB,KAAK,YAAY,KAAK,IAAI;CAC5B;;;;;CAMA,SAAS,OAAqB;EAC5B,KAAK,oBAAoB;EACzB,KAAK,KAAK;CACZ;;CAGA,eAAqB;EACnB,KAAK;EACL,KAAK,KAAK;CACZ;;CAGA,OAAqB;EACnB,KAAK,WAAW;GACd,kBAAkB,KAAK;GACvB,YAAY,KAAK;GACjB,gBAAgB,KAAK;GACrB,YAAY,KAAK;GACjB,WAAW,KAAK,IAAI,IAAI,KAAK;EAC/B,CAAC;CACH;AACF"}
+{"version":3,"file":"progress.js","names":[],"sources":["../../src/streams/progress.ts"],"sourcesContent":["/** Snapshot of upload or download progress at a point in time. */\nexport interface ProgressEvent {\n  /** Number of bytes transferred so far. */\n  readonly bytesTransferred: number\n  /** Total bytes expected, or null if unknown. */\n  readonly totalBytes: number | null\n  /** Number of multipart parts completed so far. */\n  readonly partsCompleted: number\n  /** Total number of parts expected, or null if unknown. */\n  readonly totalParts: number | null\n  /** Milliseconds elapsed since the operation started. */\n  readonly elapsedMs: number\n}\n\n/** Callback invoked each time transfer progress changes. */\nexport type ProgressListener = (event: ProgressEvent) => void\n\n/** Default minimum time between byte-progress emissions. */\nexport const DEFAULT_PROGRESS_EMIT_INTERVAL_MS = 100\n\n/** Internal controls for ProgressTracker emission behavior. */\nexport interface ProgressTrackerOptions {\n  /**\n   * Minimum milliseconds between byte-only progress emissions.\n   * Set to 0 to emit every change.\n   */\n  readonly minIntervalMs?: number\n}\n\n/**\n * Accumulates byte and part counts and emits {@link ProgressEvent}s to a listener.\n *\n * Internal building block. The SDK wires one of these inside every\n * transfer that accepts an `onProgress` option; users supply the\n * listener callback, not the tracker. Exported only so SDK source\n * modules can import it; not re-exported through any subpath.\n *\n * @internal\n */\nexport class ProgressTracker {\n  /** Running total of bytes transferred. */\n  private bytesTransferred = 0\n  /** Running count of completed parts. */\n  private partsCompleted = 0\n  /** Timestamp when tracking began. */\n  private readonly startTime: number\n  /** Minimum milliseconds between byte-only emissions. */\n  private readonly minIntervalMs: number\n  /** Timestamp of the most recent emitted snapshot. */\n  private lastEmitTime: number | null = null\n  /** Timer scheduled for a coalesced byte-only emission. */\n  private pendingEmitTimer: ReturnType<typeof setTimeout> | undefined\n  /** Listener error captured from a detached timer callback. */\n  private listenerError: unknown\n\n  /**\n   * Creates a new ProgressTracker.\n   * @param listener - Callback to receive progress events, or undefined to disable.\n   * @param totalBytes - Expected total bytes, or null if unknown.\n   * @param totalParts - Expected total parts, or null if not a multipart transfer.\n   * @param options - Optional emission controls.\n   */\n  constructor(\n    private readonly listener: ProgressListener | undefined,\n    private readonly totalBytes: number | null,\n    private readonly totalParts: number | null,\n    options: ProgressTrackerOptions = {},\n  ) {\n    this.startTime = Date.now()\n    this.minIntervalMs = Math.max(0, options.minIntervalMs ?? DEFAULT_PROGRESS_EMIT_INTERVAL_MS)\n  }\n\n  /**\n   * Record that additional bytes have been transferred and schedule listener notification.\n   * @param count - The number of additional bytes that were transferred.\n   */\n  addBytes(count: number): void {\n    this.throwPendingListenerError()\n    this.bytesTransferred += count\n    this.emitThrottled()\n  }\n\n  /** Record that a multipart part has completed and notify the listener. */\n  completePart(): void {\n    this.throwPendingListenerError()\n    this.flushPendingEmit()\n    this.partsCompleted++\n    this.emitNow()\n  }\n\n  /** Cancel any pending coalesced progress emission. */\n  dispose(): void {\n    this.clearPendingEmit()\n    this.listenerError = undefined\n  }\n\n  private emitThrottled(): void {\n    if (this.listener === undefined) return\n    if (this.minIntervalMs === 0) {\n      this.emitNow()\n      return\n    }\n\n    const now = Date.now()\n    if (this.lastEmitTime === null || now - this.lastEmitTime >= this.minIntervalMs) {\n      this.emitNow(now)\n      return\n    }\n\n    if (this.pendingEmitTimer !== undefined) return\n\n    const delay = Math.max(0, this.minIntervalMs - (now - this.lastEmitTime))\n    this.pendingEmitTimer = setTimeout(() => {\n      this.pendingEmitTimer = undefined\n      try {\n        this.emitNow()\n      } catch (err) {\n        this.listenerError = err\n      }\n    }, delay)\n    ;(this.pendingEmitTimer as { unref?: () => void }).unref?.()\n  }\n\n  private flushPendingEmit(): void {\n    if (this.pendingEmitTimer !== undefined) {\n      this.emitNow()\n    }\n  }\n\n  private clearPendingEmit(): void {\n    if (this.pendingEmitTimer === undefined) return\n    clearTimeout(this.pendingEmitTimer)\n    this.pendingEmitTimer = undefined\n  }\n\n  private emitNow(now = Date.now()): void {\n    this.clearPendingEmit()\n    this.lastEmitTime = now\n    this.emit()\n  }\n\n  private throwPendingListenerError(): void {\n    if (this.listenerError === undefined) return\n    const err = this.listenerError\n    this.listenerError = undefined\n    throw err\n  }\n\n  /** Emit the current progress snapshot to the listener, if one is registered. */\n  private emit(): void {\n    this.listener?.({\n      bytesTransferred: this.bytesTransferred,\n      totalBytes: this.totalBytes,\n      partsCompleted: this.partsCompleted,\n      totalParts: this.totalParts,\n      elapsedMs: Date.now() - this.startTime,\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;AAuCA,IAAa,kBAAb,MAA6B;CAwBR;CACA;CACA;;CAxBnB,mBAA2B;;CAE3B,iBAAyB;;CAEzB;;CAEA;;CAEA,eAAsC;;CAEtC;;CAEA;;;;;;;;CASA,YACE,UACA,YACA,YACA,UAAkC,CAAC,GACnC;EAJiB,KAAA,WAAA;EACA,KAAA,aAAA;EACA,KAAA,aAAA;EAGjB,KAAK,YAAY,KAAK,IAAI;EAC1B,KAAK,gBAAgB,KAAK,IAAI,GAAG,QAAQ,iBAAA,GAAkD;CAC7F;;;;;CAMA,SAAS,OAAqB;EAC5B,KAAK,0BAA0B;EAC/B,KAAK,oBAAoB;EACzB,KAAK,cAAc;CACrB;;CAGA,eAAqB;EACnB,KAAK,0BAA0B;EAC/B,KAAK,iBAAiB;EACtB,KAAK;EACL,KAAK,QAAQ;CACf;;CAGA,UAAgB;EACd,KAAK,iBAAiB;EACtB,KAAK,gBAAgB,KAAA;CACvB;CAEA,gBAA8B;EAC5B,IAAI,KAAK,aAAa,KAAA,GAAW;EACjC,IAAI,KAAK,kBAAkB,GAAG;GAC5B,KAAK,QAAQ;GACb;EACF;EAEA,MAAM,MAAM,KAAK,IAAI;EACrB,IAAI,KAAK,iBAAiB,QAAQ,MAAM,KAAK,gBAAgB,KAAK,eAAe;GAC/E,KAAK,QAAQ,GAAG;GAChB;EACF;EAEA,IAAI,KAAK,qBAAqB,KAAA,GAAW;EAEzC,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,iBAAiB,MAAM,KAAK,aAAa;EACxE,KAAK,mBAAmB,iBAAiB;GACvC,KAAK,mBAAmB,KAAA;GACxB,IAAI;IACF,KAAK,QAAQ;GACf,SAAS,KAAK;IACZ,KAAK,gBAAgB;GACvB;EACF,GAAG,KAAK;EACP,KAAM,iBAA4C,QAAQ;CAC7D;CAEA,mBAAiC;EAC/B,IAAI,KAAK,qBAAqB,KAAA,GAC5B,KAAK,QAAQ;CAEjB;CAEA,mBAAiC;EAC/B,IAAI,KAAK,qBAAqB,KAAA,GAAW;EACzC,aAAa,KAAK,gBAAgB;EAClC,KAAK,mBAAmB,KAAA;CAC1B;CAEA,QAAgB,MAAM,KAAK,IAAI,GAAS;EACtC,KAAK,iBAAiB;EACtB,KAAK,eAAe;EACpB,KAAK,KAAK;CACZ;CAEA,4BAA0C;EACxC,IAAI,KAAK,kBAAkB,KAAA,GAAW;EACtC,MAAM,MAAM,KAAK;EACjB,KAAK,gBAAgB,KAAA;EACrB,MAAM;CACR;;CAGA,OAAqB;EACnB,KAAK,WAAW;GACd,kBAAkB,KAAK;GACvB,YAAY,KAAK;GACjB,gBAAgB,KAAK;GACrB,YAAY,KAAK;GACjB,WAAW,KAAK,IAAI,IAAI,KAAK;EAC/B,CAAC;CACH;AACF"}

package/dist/streams/source.cjs

@@ -84,7 +84,8 @@ var BlobSource = class BlobSource {
 	async toArrayBuffer(options = {}) {
 		options.signal?.throwIfAborted();
 		if (options.signal === void 0) return this.blob.arrayBuffer();
-		return require_bytes.arrayBufferFor(await require_collect.collectStream(this.stream(), options));
+		const bytes = await require_collect.collectStream(this.stream(), options);
+		return require_bytes.arrayBufferFor(bytes);
 	}
 };
 /** ContentSource backed by a Uint8Array buffer. */

package/dist/streams/source.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"source.cjs","names":[],"sources":["../../src/streams/source.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { collectStream } from './collect.ts'\n\nexport { FileSource, type FileSourcePath } from './file-source.ts'\n\nconst READABLE_STREAM_SIZE_REQUIRED_ERROR = 'size is required when using a ReadableStream as input.'\nconst FORWARD_ONLY_SIZE_REQUIRED_ERROR =\n  'size is required when using a forward-only content source as input.'\nconst STREAM_SOURCE_ENDED_EARLY_ERROR = 'StreamSource ended before the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_BYTES_ERROR =\n  'StreamSource emitted more bytes than the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR =\n  'StreamSource emitted too many empty chunks without data.'\n/** Maximum consecutive empty chunks tolerated from a forward-only stream. */\nexport const MAX_EMPTY_STREAM_CHUNKS = 1024\n\nfunction asyncIterableToReadableStream(\n  iterable: AsyncIterable<Uint8Array>,\n): ReadableStream<Uint8Array> {\n  const iterator = iterable[Symbol.asyncIterator]()\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await iterator.next()\n        if (done === true) {\n          controller.close()\n          return\n        }\n        if (!(value instanceof Uint8Array)) {\n          throw new TypeError('Async iterable content sources must yield Uint8Array chunks.')\n        }\n        controller.enqueue(value)\n      } catch (err) {\n        /* v8 ignore next -- Iterator-return failure must not mask the pull error. */\n        await returnAsyncIteratorBestEffort(iterator)\n        throw err\n      }\n    },\n    async cancel(reason) {\n      await returnAsyncIteratorBestEffort(iterator, reason)\n    },\n  })\n}\n\nasync function returnAsyncIteratorBestEffort(\n  iterator: AsyncIterator<Uint8Array>,\n  reason?: unknown,\n): Promise<void> {\n  try {\n    await iterator.return?.(reason)\n  } catch {\n    // Iterator cleanup is secondary and must not mask the pull error.\n  }\n}\n\nfunction isAsyncIterable(input: unknown): input is AsyncIterable<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    Symbol.asyncIterator in input &&\n    typeof input[Symbol.asyncIterator] === 'function'\n  )\n}\n\nfunction isReadableStream(input: unknown): input is ReadableStream<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    typeof (input as { getReader?: unknown }).getReader === 'function'\n  )\n}\n\n/**\n * Uniform adapter for upload content. Wraps File, Blob, Buffer, local files,\n * async iterables, or ReadableStream behind a common interface so upload logic\n * does not depend on the input type.\n */\nexport interface ContentSource {\n  /** Total size of the content in bytes. */\n  readonly size: number\n  /** Pre-computed SHA-1 hex digest, if available. */\n  readonly sha1?: string\n  /**\n   * Whether {@link slice} is safe to call on this source.\n   *\n   * `true` for in-memory / random-access sources (`BufferSource`,\n   * `BlobSource`, `FileSource`) — the multipart upload engine can dispatch\n   * part reads in parallel by slicing the source into disjoint ranges.\n   * `false` for forward-only streams and async iterables — the engine must\n   * read sequentially, one `partSize` chunk at a time. Callers that branch on\n   * this flag are expected to fall back to the sequential path rather than call\n   * `slice()` and catch the throw.\n   */\n  readonly canSlice: boolean\n  /** Return a sub-range of this source as a new ContentSource. */\n  slice(start: number, end: number): ContentSource\n  /** Open the content as a ReadableStream. */\n  stream(): ReadableStream<Uint8Array>\n  /** Read the entire content into an ArrayBuffer. */\n  toArrayBuffer(options?: { readonly signal?: AbortSignal }): Promise<ArrayBuffer>\n}\n\n/** ContentSource backed by a Blob or File. */\nexport class BlobSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */\n  readonly canSlice = true\n\n  /**\n   * Create a BlobSource wrapping the given Blob.\n   * @param blob - The Blob or File to use as the underlying content.\n   */\n  constructor(private readonly blob: Blob) {\n    this.size = blob.size\n  }\n\n  /**\n   * Return a new BlobSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BlobSource(this.blob.slice(start, end))\n  }\n\n  /**\n   * Open the Blob content as a ReadableStream.\n   * @returns A ReadableStream of the Blob bytes.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    return this.blob.stream() as ReadableStream<Uint8Array>\n  }\n\n  /**\n   * Read the entire Blob content into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    if (options.signal === undefined) return this.blob.arrayBuffer()\n    const bytes = await collectStream(this.stream(), options)\n    return arrayBufferFor(bytes)\n  }\n}\n\n/** ContentSource backed by a Uint8Array buffer. */\nexport class BufferSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: the entire payload lives in memory. */\n  readonly canSlice = true\n\n  /**\n   * Create a BufferSource wrapping the given Uint8Array.\n   * @param buffer - The byte buffer to use as the underlying content.\n   */\n  constructor(private readonly buffer: Uint8Array) {\n    this.size = buffer.byteLength\n  }\n\n  /**\n   * Return a new BufferSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BufferSource(this.buffer.slice(start, end))\n  }\n\n  /**\n   * Open the buffer content as a ReadableStream.\n   * @returns A ReadableStream that emits the buffer bytes in a single chunk.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    const buffer = this.buffer\n    return new ReadableStream({\n      start(controller) {\n        controller.enqueue(buffer)\n        controller.close()\n      },\n    })\n  }\n\n  /**\n   * Read the entire buffer content into an ArrayBuffer.\n   * @param options - Optional abort signal checked before returning bytes.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    return arrayBufferFor(this.buffer)\n  }\n}\n\n/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */\nexport class StreamSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /**\n   * Forward-only: ReadableStreams cannot be repositioned, so multipart\n   * uploads must take the sequential path. See the interface comment on\n   * `canSlice` for what the engine does with this flag.\n   */\n  readonly canSlice = false\n  /** Whether the stream has already been read. */\n  private consumed = false\n\n  /**\n   * Create a StreamSource wrapping the given ReadableStream with a known byte size.\n   * @param readable - The ReadableStream to wrap as a content source.\n   * @param size - The total number of bytes the stream will produce.\n   */\n  constructor(\n    private readonly readable: ReadableStream<Uint8Array>,\n    size: number,\n  ) {\n    validateStreamSourceSize(size)\n    this.size = size\n  }\n\n  /**\n   * Always throws because streams cannot be sliced. Buffer the stream first.\n   *\n   * @throws If slicing is attempted on a stream-backed source.\n   */\n  slice(): ContentSource {\n    throw new Error('StreamSource does not support slicing. Buffer the stream first.')\n  }\n\n  /**\n   * Open the underlying ReadableStream. Can only be called once.\n   * @returns The underlying ReadableStream of bytes.\n   *\n   * @throws If the stream has already been consumed.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    if (this.consumed) throw new Error('StreamSource can only be consumed once.')\n    this.consumed = true\n    return this.readable\n  }\n\n  /**\n   * Read the entire stream into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    const bytes = await collectStreamExactly(this.stream(), this.size, options.signal)\n    return bytes.buffer as ArrayBuffer\n  }\n}\n\nfunction validateStreamSourceSize(size: number): void {\n  if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) {\n    throw new RangeError('StreamSource size must be a non-negative finite integer.')\n  }\n}\n\n/**\n * Reads exactly the advertised number of bytes from a stream.\n * @param stream - Stream to consume.\n * @param expectedSize - Exact number of bytes expected from the stream.\n * @param signal - Optional abort signal for cancelling the read.\n *\n * @returns A byte array of length `expectedSize`.\n *\n * @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.\n */\nexport async function collectStreamExactly(\n  stream: ReadableStream<Uint8Array>,\n  expectedSize: number,\n  signal?: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer>> {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  let completed = false\n\n  try {\n    while (total < expectedSize) {\n      const { done, value } = await readNextNonEmptyStreamChunk(\n        reader,\n        STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n        signal,\n      )\n      if (done) throw new Error(STREAM_SOURCE_ENDED_EARLY_ERROR)\n      if (total + value.byteLength > expectedSize) {\n        throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n      }\n      chunks.push(value)\n      total += value.byteLength\n    }\n\n    const extra = await readNextNonEmptyStreamChunk(\n      reader,\n      STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n      signal,\n    )\n    if (!extra.done) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n\n    const result = new Uint8Array(expectedSize)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    completed = true\n    return result\n  } finally {\n    if (!completed) {\n      cancelReaderBestEffort(reader)\n    }\n    try {\n      reader.releaseLock()\n    } catch {\n      // Aborted reads can leave a pending read while best-effort cancel is\n      // still unsettled. Preserve the original abort/error instead.\n    }\n  }\n}\n\n/**\n * Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.\n * @param reader - Locked reader for a Uint8Array stream.\n * @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.\n * @param signal - Optional abort signal that cancels the reader and rejects the read.\n *\n * @returns The next non-empty chunk or EOF result.\n */\nexport async function readNextNonEmptyStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  emptyChunkErrorMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readStreamChunk(reader, signal)\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_EMPTY_STREAM_CHUNKS) {\n      throw new Error(emptyChunkErrorMessage)\n    }\n  }\n}\n\nasync function readStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  signal: AbortSignal | undefined,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  if (signal === undefined) return reader.read()\n  if (signal.aborted) {\n    const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n    cancelReaderBestEffort(reader, reason)\n    throw reason\n  }\n\n  let removeAbortListener: (() => void) | undefined\n  const abort = new Promise<never>((_, reject) => {\n    const onAbort = (): void => {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      reject(reason)\n    }\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    const result = await Promise.race([reader.read(), abort])\n    if (signal.aborted) {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      throw reason\n    }\n    return result\n  } finally {\n    removeAbortListener?.()\n  }\n}\n\nfunction cancelReaderBestEffort(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  reason?: unknown,\n): void {\n  /* v8 ignore next -- Reader cancellation failure is deliberately best-effort. */\n  void reader.cancel(reason).catch(() => {})\n}\n\n/** ContentSource backed by a forward-only async iterable of Uint8Array chunks. */\nclass AsyncIterableSource extends StreamSource {\n  /**\n   * Create an AsyncIterableSource from a known-size async iterable.\n   * @param iterable - Async iterable that yields Uint8Array chunks.\n   * @param size - Total byte length the iterable will produce.\n   */\n  constructor(iterable: AsyncIterable<Uint8Array>, size: number) {\n    super(asyncIterableToReadableStream(iterable), size)\n  }\n}\n\n/**\n * Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.\n * When passing a ReadableStream or async iterable, the `size` parameter is required.\n * @param input - The content to wrap.\n * @param size - The total byte length, required for forward-only inputs.\n *\n * @returns A ContentSource adapter for the given input.\n *\n * @throws If input is forward-only and size is not provided.\n */\nexport function toContentSource(\n  input: Uint8Array | Blob | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>,\n  size?: number,\n): ContentSource {\n  if (input instanceof Uint8Array) {\n    return new BufferSource(input)\n  }\n  if (input instanceof Blob) {\n    return new BlobSource(input)\n  }\n  if (isReadableStream(input)) {\n    if (size === undefined) {\n      throw new Error(READABLE_STREAM_SIZE_REQUIRED_ERROR)\n    }\n    return new StreamSource(input, size)\n  }\n  if (isAsyncIterable(input)) {\n    if (size === undefined) {\n      throw new Error(FORWARD_ONLY_SIZE_REQUIRED_ERROR)\n    }\n    return new AsyncIterableSource(input, size)\n  }\n  throw new TypeError('Unsupported content source input.')\n}\n"],"mappings":"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"}
+{"version":3,"file":"source.cjs","names":[],"sources":["../../src/streams/source.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { collectStream } from './collect.ts'\n\nexport { FileSource, type FileSourcePath } from './file-source.ts'\n\nconst READABLE_STREAM_SIZE_REQUIRED_ERROR = 'size is required when using a ReadableStream as input.'\nconst FORWARD_ONLY_SIZE_REQUIRED_ERROR =\n  'size is required when using a forward-only content source as input.'\nconst STREAM_SOURCE_ENDED_EARLY_ERROR = 'StreamSource ended before the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_BYTES_ERROR =\n  'StreamSource emitted more bytes than the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR =\n  'StreamSource emitted too many empty chunks without data.'\n/** Maximum consecutive empty chunks tolerated from a forward-only stream. */\nexport const MAX_EMPTY_STREAM_CHUNKS = 1024\n\nfunction asyncIterableToReadableStream(\n  iterable: AsyncIterable<Uint8Array>,\n): ReadableStream<Uint8Array> {\n  const iterator = iterable[Symbol.asyncIterator]()\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await iterator.next()\n        if (done === true) {\n          controller.close()\n          return\n        }\n        if (!(value instanceof Uint8Array)) {\n          throw new TypeError('Async iterable content sources must yield Uint8Array chunks.')\n        }\n        controller.enqueue(value)\n      } catch (err) {\n        /* v8 ignore next -- Iterator-return failure must not mask the pull error. */\n        await returnAsyncIteratorBestEffort(iterator)\n        throw err\n      }\n    },\n    async cancel(reason) {\n      await returnAsyncIteratorBestEffort(iterator, reason)\n    },\n  })\n}\n\nasync function returnAsyncIteratorBestEffort(\n  iterator: AsyncIterator<Uint8Array>,\n  reason?: unknown,\n): Promise<void> {\n  try {\n    await iterator.return?.(reason)\n  } catch {\n    // Iterator cleanup is secondary and must not mask the pull error.\n  }\n}\n\nfunction isAsyncIterable(input: unknown): input is AsyncIterable<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    Symbol.asyncIterator in input &&\n    typeof input[Symbol.asyncIterator] === 'function'\n  )\n}\n\nfunction isReadableStream(input: unknown): input is ReadableStream<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    typeof (input as { getReader?: unknown }).getReader === 'function'\n  )\n}\n\n/**\n * Uniform adapter for upload content. Wraps File, Blob, Buffer, local files,\n * async iterables, or ReadableStream behind a common interface so upload logic\n * does not depend on the input type.\n */\nexport interface ContentSource {\n  /** Total size of the content in bytes. */\n  readonly size: number\n  /** Pre-computed SHA-1 hex digest, if available. */\n  readonly sha1?: string\n  /**\n   * Whether {@link slice} is safe to call on this source.\n   *\n   * `true` for in-memory / random-access sources (`BufferSource`,\n   * `BlobSource`, `FileSource`) — the multipart upload engine can dispatch\n   * part reads in parallel by slicing the source into disjoint ranges.\n   * `false` for forward-only streams and async iterables — the engine must\n   * read sequentially, one `partSize` chunk at a time. Callers that branch on\n   * this flag are expected to fall back to the sequential path rather than call\n   * `slice()` and catch the throw.\n   */\n  readonly canSlice: boolean\n  /** Return a sub-range of this source as a new ContentSource. */\n  slice(start: number, end: number): ContentSource\n  /** Open the content as a ReadableStream. */\n  stream(): ReadableStream<Uint8Array>\n  /** Read the entire content into an ArrayBuffer. */\n  toArrayBuffer(options?: { readonly signal?: AbortSignal }): Promise<ArrayBuffer>\n}\n\n/** ContentSource backed by a Blob or File. */\nexport class BlobSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */\n  readonly canSlice = true\n\n  /**\n   * Create a BlobSource wrapping the given Blob.\n   * @param blob - The Blob or File to use as the underlying content.\n   */\n  constructor(private readonly blob: Blob) {\n    this.size = blob.size\n  }\n\n  /**\n   * Return a new BlobSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BlobSource(this.blob.slice(start, end))\n  }\n\n  /**\n   * Open the Blob content as a ReadableStream.\n   * @returns A ReadableStream of the Blob bytes.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    return this.blob.stream() as ReadableStream<Uint8Array>\n  }\n\n  /**\n   * Read the entire Blob content into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    if (options.signal === undefined) return this.blob.arrayBuffer()\n    const bytes = await collectStream(this.stream(), options)\n    return arrayBufferFor(bytes)\n  }\n}\n\n/** ContentSource backed by a Uint8Array buffer. */\nexport class BufferSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: the entire payload lives in memory. */\n  readonly canSlice = true\n\n  /**\n   * Create a BufferSource wrapping the given Uint8Array.\n   * @param buffer - The byte buffer to use as the underlying content.\n   */\n  constructor(private readonly buffer: Uint8Array) {\n    this.size = buffer.byteLength\n  }\n\n  /**\n   * Return a new BufferSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BufferSource(this.buffer.slice(start, end))\n  }\n\n  /**\n   * Open the buffer content as a ReadableStream.\n   * @returns A ReadableStream that emits the buffer bytes in a single chunk.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    const buffer = this.buffer\n    return new ReadableStream({\n      start(controller) {\n        controller.enqueue(buffer)\n        controller.close()\n      },\n    })\n  }\n\n  /**\n   * Read the entire buffer content into an ArrayBuffer.\n   * @param options - Optional abort signal checked before returning bytes.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    return arrayBufferFor(this.buffer)\n  }\n}\n\n/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */\nexport class StreamSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /**\n   * Forward-only: ReadableStreams cannot be repositioned, so multipart\n   * uploads must take the sequential path. See the interface comment on\n   * `canSlice` for what the engine does with this flag.\n   */\n  readonly canSlice = false\n  /** Whether the stream has already been read. */\n  private consumed = false\n\n  /**\n   * Create a StreamSource wrapping the given ReadableStream with a known byte size.\n   * @param readable - The ReadableStream to wrap as a content source.\n   * @param size - The total number of bytes the stream will produce.\n   */\n  constructor(\n    private readonly readable: ReadableStream<Uint8Array>,\n    size: number,\n  ) {\n    validateStreamSourceSize(size)\n    this.size = size\n  }\n\n  /**\n   * Always throws because streams cannot be sliced. Buffer the stream first.\n   *\n   * @throws If slicing is attempted on a stream-backed source.\n   */\n  slice(): ContentSource {\n    throw new Error('StreamSource does not support slicing. Buffer the stream first.')\n  }\n\n  /**\n   * Open the underlying ReadableStream. Can only be called once.\n   * @returns The underlying ReadableStream of bytes.\n   *\n   * @throws If the stream has already been consumed.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    if (this.consumed) throw new Error('StreamSource can only be consumed once.')\n    this.consumed = true\n    return this.readable\n  }\n\n  /**\n   * Read the entire stream into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    const bytes = await collectStreamExactly(this.stream(), this.size, options.signal)\n    return bytes.buffer as ArrayBuffer\n  }\n}\n\nfunction validateStreamSourceSize(size: number): void {\n  if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) {\n    throw new RangeError('StreamSource size must be a non-negative finite integer.')\n  }\n}\n\n/**\n * Reads exactly the advertised number of bytes from a stream.\n * @param stream - Stream to consume.\n * @param expectedSize - Exact number of bytes expected from the stream.\n * @param signal - Optional abort signal for cancelling the read.\n *\n * @returns A byte array of length `expectedSize`.\n *\n * @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.\n */\nexport async function collectStreamExactly(\n  stream: ReadableStream<Uint8Array>,\n  expectedSize: number,\n  signal?: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer>> {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  let completed = false\n\n  try {\n    while (total < expectedSize) {\n      const { done, value } = await readNextNonEmptyStreamChunk(\n        reader,\n        STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n        signal,\n      )\n      if (done) throw new Error(STREAM_SOURCE_ENDED_EARLY_ERROR)\n      if (total + value.byteLength > expectedSize) {\n        throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n      }\n      chunks.push(value)\n      total += value.byteLength\n    }\n\n    const extra = await readNextNonEmptyStreamChunk(\n      reader,\n      STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n      signal,\n    )\n    if (!extra.done) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n\n    const result = new Uint8Array(expectedSize)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    completed = true\n    return result\n  } finally {\n    if (!completed) {\n      cancelReaderBestEffort(reader)\n    }\n    try {\n      reader.releaseLock()\n    } catch {\n      // Aborted reads can leave a pending read while best-effort cancel is\n      // still unsettled. Preserve the original abort/error instead.\n    }\n  }\n}\n\n/**\n * Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.\n * @param reader - Locked reader for a Uint8Array stream.\n * @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.\n * @param signal - Optional abort signal that cancels the reader and rejects the read.\n *\n * @returns The next non-empty chunk or EOF result.\n */\nexport async function readNextNonEmptyStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  emptyChunkErrorMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readStreamChunk(reader, signal)\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_EMPTY_STREAM_CHUNKS) {\n      throw new Error(emptyChunkErrorMessage)\n    }\n  }\n}\n\nasync function readStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  signal: AbortSignal | undefined,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  if (signal === undefined) return reader.read()\n  if (signal.aborted) {\n    const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n    cancelReaderBestEffort(reader, reason)\n    throw reason\n  }\n\n  let removeAbortListener: (() => void) | undefined\n  const abort = new Promise<never>((_, reject) => {\n    const onAbort = (): void => {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      reject(reason)\n    }\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    const result = await Promise.race([reader.read(), abort])\n    if (signal.aborted) {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      throw reason\n    }\n    return result\n  } finally {\n    removeAbortListener?.()\n  }\n}\n\nfunction cancelReaderBestEffort(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  reason?: unknown,\n): void {\n  /* v8 ignore next -- Reader cancellation failure is deliberately best-effort. */\n  void reader.cancel(reason).catch(() => {})\n}\n\n/** ContentSource backed by a forward-only async iterable of Uint8Array chunks. */\nclass AsyncIterableSource extends StreamSource {\n  /**\n   * Create an AsyncIterableSource from a known-size async iterable.\n   * @param iterable - Async iterable that yields Uint8Array chunks.\n   * @param size - Total byte length the iterable will produce.\n   */\n  constructor(iterable: AsyncIterable<Uint8Array>, size: number) {\n    super(asyncIterableToReadableStream(iterable), size)\n  }\n}\n\n/**\n * Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.\n * When passing a ReadableStream or async iterable, the `size` parameter is required.\n * @param input - The content to wrap.\n * @param size - The total byte length, required for forward-only inputs.\n *\n * @returns A ContentSource adapter for the given input.\n *\n * @throws If input is forward-only and size is not provided.\n */\nexport function toContentSource(\n  input: Uint8Array | Blob | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>,\n  size?: number,\n): ContentSource {\n  if (input instanceof Uint8Array) {\n    return new BufferSource(input)\n  }\n  if (input instanceof Blob) {\n    return new BlobSource(input)\n  }\n  if (isReadableStream(input)) {\n    if (size === undefined) {\n      throw new Error(READABLE_STREAM_SIZE_REQUIRED_ERROR)\n    }\n    return new StreamSource(input, size)\n  }\n  if (isAsyncIterable(input)) {\n    if (size === undefined) {\n      throw new Error(FORWARD_ONLY_SIZE_REQUIRED_ERROR)\n    }\n    return new AsyncIterableSource(input, size)\n  }\n  throw new TypeError('Unsupported content source input.')\n}\n"],"mappings":"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"}

package/dist/streams/source.js

@@ -84,7 +84,8 @@ var BlobSource = class BlobSource {
 	async toArrayBuffer(options = {}) {
 		options.signal?.throwIfAborted();
 		if (options.signal === void 0) return this.blob.arrayBuffer();
-		return arrayBufferFor(await collectStream(this.stream(), options));
+		const bytes = await collectStream(this.stream(), options);
+		return arrayBufferFor(bytes);
 	}
 };
 /** ContentSource backed by a Uint8Array buffer. */

package/dist/streams/source.js.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","names":[],"sources":["../../src/streams/source.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { collectStream } from './collect.ts'\n\nexport { FileSource, type FileSourcePath } from './file-source.ts'\n\nconst READABLE_STREAM_SIZE_REQUIRED_ERROR = 'size is required when using a ReadableStream as input.'\nconst FORWARD_ONLY_SIZE_REQUIRED_ERROR =\n  'size is required when using a forward-only content source as input.'\nconst STREAM_SOURCE_ENDED_EARLY_ERROR = 'StreamSource ended before the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_BYTES_ERROR =\n  'StreamSource emitted more bytes than the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR =\n  'StreamSource emitted too many empty chunks without data.'\n/** Maximum consecutive empty chunks tolerated from a forward-only stream. */\nexport const MAX_EMPTY_STREAM_CHUNKS = 1024\n\nfunction asyncIterableToReadableStream(\n  iterable: AsyncIterable<Uint8Array>,\n): ReadableStream<Uint8Array> {\n  const iterator = iterable[Symbol.asyncIterator]()\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await iterator.next()\n        if (done === true) {\n          controller.close()\n          return\n        }\n        if (!(value instanceof Uint8Array)) {\n          throw new TypeError('Async iterable content sources must yield Uint8Array chunks.')\n        }\n        controller.enqueue(value)\n      } catch (err) {\n        /* v8 ignore next -- Iterator-return failure must not mask the pull error. */\n        await returnAsyncIteratorBestEffort(iterator)\n        throw err\n      }\n    },\n    async cancel(reason) {\n      await returnAsyncIteratorBestEffort(iterator, reason)\n    },\n  })\n}\n\nasync function returnAsyncIteratorBestEffort(\n  iterator: AsyncIterator<Uint8Array>,\n  reason?: unknown,\n): Promise<void> {\n  try {\n    await iterator.return?.(reason)\n  } catch {\n    // Iterator cleanup is secondary and must not mask the pull error.\n  }\n}\n\nfunction isAsyncIterable(input: unknown): input is AsyncIterable<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    Symbol.asyncIterator in input &&\n    typeof input[Symbol.asyncIterator] === 'function'\n  )\n}\n\nfunction isReadableStream(input: unknown): input is ReadableStream<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    typeof (input as { getReader?: unknown }).getReader === 'function'\n  )\n}\n\n/**\n * Uniform adapter for upload content. Wraps File, Blob, Buffer, local files,\n * async iterables, or ReadableStream behind a common interface so upload logic\n * does not depend on the input type.\n */\nexport interface ContentSource {\n  /** Total size of the content in bytes. */\n  readonly size: number\n  /** Pre-computed SHA-1 hex digest, if available. */\n  readonly sha1?: string\n  /**\n   * Whether {@link slice} is safe to call on this source.\n   *\n   * `true` for in-memory / random-access sources (`BufferSource`,\n   * `BlobSource`, `FileSource`) — the multipart upload engine can dispatch\n   * part reads in parallel by slicing the source into disjoint ranges.\n   * `false` for forward-only streams and async iterables — the engine must\n   * read sequentially, one `partSize` chunk at a time. Callers that branch on\n   * this flag are expected to fall back to the sequential path rather than call\n   * `slice()` and catch the throw.\n   */\n  readonly canSlice: boolean\n  /** Return a sub-range of this source as a new ContentSource. */\n  slice(start: number, end: number): ContentSource\n  /** Open the content as a ReadableStream. */\n  stream(): ReadableStream<Uint8Array>\n  /** Read the entire content into an ArrayBuffer. */\n  toArrayBuffer(options?: { readonly signal?: AbortSignal }): Promise<ArrayBuffer>\n}\n\n/** ContentSource backed by a Blob or File. */\nexport class BlobSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */\n  readonly canSlice = true\n\n  /**\n   * Create a BlobSource wrapping the given Blob.\n   * @param blob - The Blob or File to use as the underlying content.\n   */\n  constructor(private readonly blob: Blob) {\n    this.size = blob.size\n  }\n\n  /**\n   * Return a new BlobSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BlobSource(this.blob.slice(start, end))\n  }\n\n  /**\n   * Open the Blob content as a ReadableStream.\n   * @returns A ReadableStream of the Blob bytes.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    return this.blob.stream() as ReadableStream<Uint8Array>\n  }\n\n  /**\n   * Read the entire Blob content into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    if (options.signal === undefined) return this.blob.arrayBuffer()\n    const bytes = await collectStream(this.stream(), options)\n    return arrayBufferFor(bytes)\n  }\n}\n\n/** ContentSource backed by a Uint8Array buffer. */\nexport class BufferSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: the entire payload lives in memory. */\n  readonly canSlice = true\n\n  /**\n   * Create a BufferSource wrapping the given Uint8Array.\n   * @param buffer - The byte buffer to use as the underlying content.\n   */\n  constructor(private readonly buffer: Uint8Array) {\n    this.size = buffer.byteLength\n  }\n\n  /**\n   * Return a new BufferSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BufferSource(this.buffer.slice(start, end))\n  }\n\n  /**\n   * Open the buffer content as a ReadableStream.\n   * @returns A ReadableStream that emits the buffer bytes in a single chunk.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    const buffer = this.buffer\n    return new ReadableStream({\n      start(controller) {\n        controller.enqueue(buffer)\n        controller.close()\n      },\n    })\n  }\n\n  /**\n   * Read the entire buffer content into an ArrayBuffer.\n   * @param options - Optional abort signal checked before returning bytes.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    return arrayBufferFor(this.buffer)\n  }\n}\n\n/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */\nexport class StreamSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /**\n   * Forward-only: ReadableStreams cannot be repositioned, so multipart\n   * uploads must take the sequential path. See the interface comment on\n   * `canSlice` for what the engine does with this flag.\n   */\n  readonly canSlice = false\n  /** Whether the stream has already been read. */\n  private consumed = false\n\n  /**\n   * Create a StreamSource wrapping the given ReadableStream with a known byte size.\n   * @param readable - The ReadableStream to wrap as a content source.\n   * @param size - The total number of bytes the stream will produce.\n   */\n  constructor(\n    private readonly readable: ReadableStream<Uint8Array>,\n    size: number,\n  ) {\n    validateStreamSourceSize(size)\n    this.size = size\n  }\n\n  /**\n   * Always throws because streams cannot be sliced. Buffer the stream first.\n   *\n   * @throws If slicing is attempted on a stream-backed source.\n   */\n  slice(): ContentSource {\n    throw new Error('StreamSource does not support slicing. Buffer the stream first.')\n  }\n\n  /**\n   * Open the underlying ReadableStream. Can only be called once.\n   * @returns The underlying ReadableStream of bytes.\n   *\n   * @throws If the stream has already been consumed.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    if (this.consumed) throw new Error('StreamSource can only be consumed once.')\n    this.consumed = true\n    return this.readable\n  }\n\n  /**\n   * Read the entire stream into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    const bytes = await collectStreamExactly(this.stream(), this.size, options.signal)\n    return bytes.buffer as ArrayBuffer\n  }\n}\n\nfunction validateStreamSourceSize(size: number): void {\n  if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) {\n    throw new RangeError('StreamSource size must be a non-negative finite integer.')\n  }\n}\n\n/**\n * Reads exactly the advertised number of bytes from a stream.\n * @param stream - Stream to consume.\n * @param expectedSize - Exact number of bytes expected from the stream.\n * @param signal - Optional abort signal for cancelling the read.\n *\n * @returns A byte array of length `expectedSize`.\n *\n * @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.\n */\nexport async function collectStreamExactly(\n  stream: ReadableStream<Uint8Array>,\n  expectedSize: number,\n  signal?: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer>> {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  let completed = false\n\n  try {\n    while (total < expectedSize) {\n      const { done, value } = await readNextNonEmptyStreamChunk(\n        reader,\n        STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n        signal,\n      )\n      if (done) throw new Error(STREAM_SOURCE_ENDED_EARLY_ERROR)\n      if (total + value.byteLength > expectedSize) {\n        throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n      }\n      chunks.push(value)\n      total += value.byteLength\n    }\n\n    const extra = await readNextNonEmptyStreamChunk(\n      reader,\n      STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n      signal,\n    )\n    if (!extra.done) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n\n    const result = new Uint8Array(expectedSize)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    completed = true\n    return result\n  } finally {\n    if (!completed) {\n      cancelReaderBestEffort(reader)\n    }\n    try {\n      reader.releaseLock()\n    } catch {\n      // Aborted reads can leave a pending read while best-effort cancel is\n      // still unsettled. Preserve the original abort/error instead.\n    }\n  }\n}\n\n/**\n * Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.\n * @param reader - Locked reader for a Uint8Array stream.\n * @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.\n * @param signal - Optional abort signal that cancels the reader and rejects the read.\n *\n * @returns The next non-empty chunk or EOF result.\n */\nexport async function readNextNonEmptyStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  emptyChunkErrorMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readStreamChunk(reader, signal)\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_EMPTY_STREAM_CHUNKS) {\n      throw new Error(emptyChunkErrorMessage)\n    }\n  }\n}\n\nasync function readStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  signal: AbortSignal | undefined,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  if (signal === undefined) return reader.read()\n  if (signal.aborted) {\n    const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n    cancelReaderBestEffort(reader, reason)\n    throw reason\n  }\n\n  let removeAbortListener: (() => void) | undefined\n  const abort = new Promise<never>((_, reject) => {\n    const onAbort = (): void => {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      reject(reason)\n    }\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    const result = await Promise.race([reader.read(), abort])\n    if (signal.aborted) {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      throw reason\n    }\n    return result\n  } finally {\n    removeAbortListener?.()\n  }\n}\n\nfunction cancelReaderBestEffort(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  reason?: unknown,\n): void {\n  /* v8 ignore next -- Reader cancellation failure is deliberately best-effort. */\n  void reader.cancel(reason).catch(() => {})\n}\n\n/** ContentSource backed by a forward-only async iterable of Uint8Array chunks. */\nclass AsyncIterableSource extends StreamSource {\n  /**\n   * Create an AsyncIterableSource from a known-size async iterable.\n   * @param iterable - Async iterable that yields Uint8Array chunks.\n   * @param size - Total byte length the iterable will produce.\n   */\n  constructor(iterable: AsyncIterable<Uint8Array>, size: number) {\n    super(asyncIterableToReadableStream(iterable), size)\n  }\n}\n\n/**\n * Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.\n * When passing a ReadableStream or async iterable, the `size` parameter is required.\n * @param input - The content to wrap.\n * @param size - The total byte length, required for forward-only inputs.\n *\n * @returns A ContentSource adapter for the given input.\n *\n * @throws If input is forward-only and size is not provided.\n */\nexport function toContentSource(\n  input: Uint8Array | Blob | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>,\n  size?: number,\n): ContentSource {\n  if (input instanceof Uint8Array) {\n    return new BufferSource(input)\n  }\n  if (input instanceof Blob) {\n    return new BlobSource(input)\n  }\n  if (isReadableStream(input)) {\n    if (size === undefined) {\n      throw new Error(READABLE_STREAM_SIZE_REQUIRED_ERROR)\n    }\n    return new StreamSource(input, size)\n  }\n  if (isAsyncIterable(input)) {\n    if (size === undefined) {\n      throw new Error(FORWARD_ONLY_SIZE_REQUIRED_ERROR)\n    }\n    return new AsyncIterableSource(input, size)\n  }\n  throw new TypeError('Unsupported content source input.')\n}\n"],"mappings":"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"}
+{"version":3,"file":"source.js","names":[],"sources":["../../src/streams/source.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { collectStream } from './collect.ts'\n\nexport { FileSource, type FileSourcePath } from './file-source.ts'\n\nconst READABLE_STREAM_SIZE_REQUIRED_ERROR = 'size is required when using a ReadableStream as input.'\nconst FORWARD_ONLY_SIZE_REQUIRED_ERROR =\n  'size is required when using a forward-only content source as input.'\nconst STREAM_SOURCE_ENDED_EARLY_ERROR = 'StreamSource ended before the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_BYTES_ERROR =\n  'StreamSource emitted more bytes than the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR =\n  'StreamSource emitted too many empty chunks without data.'\n/** Maximum consecutive empty chunks tolerated from a forward-only stream. */\nexport const MAX_EMPTY_STREAM_CHUNKS = 1024\n\nfunction asyncIterableToReadableStream(\n  iterable: AsyncIterable<Uint8Array>,\n): ReadableStream<Uint8Array> {\n  const iterator = iterable[Symbol.asyncIterator]()\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await iterator.next()\n        if (done === true) {\n          controller.close()\n          return\n        }\n        if (!(value instanceof Uint8Array)) {\n          throw new TypeError('Async iterable content sources must yield Uint8Array chunks.')\n        }\n        controller.enqueue(value)\n      } catch (err) {\n        /* v8 ignore next -- Iterator-return failure must not mask the pull error. */\n        await returnAsyncIteratorBestEffort(iterator)\n        throw err\n      }\n    },\n    async cancel(reason) {\n      await returnAsyncIteratorBestEffort(iterator, reason)\n    },\n  })\n}\n\nasync function returnAsyncIteratorBestEffort(\n  iterator: AsyncIterator<Uint8Array>,\n  reason?: unknown,\n): Promise<void> {\n  try {\n    await iterator.return?.(reason)\n  } catch {\n    // Iterator cleanup is secondary and must not mask the pull error.\n  }\n}\n\nfunction isAsyncIterable(input: unknown): input is AsyncIterable<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    Symbol.asyncIterator in input &&\n    typeof input[Symbol.asyncIterator] === 'function'\n  )\n}\n\nfunction isReadableStream(input: unknown): input is ReadableStream<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    typeof (input as { getReader?: unknown }).getReader === 'function'\n  )\n}\n\n/**\n * Uniform adapter for upload content. Wraps File, Blob, Buffer, local files,\n * async iterables, or ReadableStream behind a common interface so upload logic\n * does not depend on the input type.\n */\nexport interface ContentSource {\n  /** Total size of the content in bytes. */\n  readonly size: number\n  /** Pre-computed SHA-1 hex digest, if available. */\n  readonly sha1?: string\n  /**\n   * Whether {@link slice} is safe to call on this source.\n   *\n   * `true` for in-memory / random-access sources (`BufferSource`,\n   * `BlobSource`, `FileSource`) — the multipart upload engine can dispatch\n   * part reads in parallel by slicing the source into disjoint ranges.\n   * `false` for forward-only streams and async iterables — the engine must\n   * read sequentially, one `partSize` chunk at a time. Callers that branch on\n   * this flag are expected to fall back to the sequential path rather than call\n   * `slice()` and catch the throw.\n   */\n  readonly canSlice: boolean\n  /** Return a sub-range of this source as a new ContentSource. */\n  slice(start: number, end: number): ContentSource\n  /** Open the content as a ReadableStream. */\n  stream(): ReadableStream<Uint8Array>\n  /** Read the entire content into an ArrayBuffer. */\n  toArrayBuffer(options?: { readonly signal?: AbortSignal }): Promise<ArrayBuffer>\n}\n\n/** ContentSource backed by a Blob or File. */\nexport class BlobSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */\n  readonly canSlice = true\n\n  /**\n   * Create a BlobSource wrapping the given Blob.\n   * @param blob - The Blob or File to use as the underlying content.\n   */\n  constructor(private readonly blob: Blob) {\n    this.size = blob.size\n  }\n\n  /**\n   * Return a new BlobSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BlobSource(this.blob.slice(start, end))\n  }\n\n  /**\n   * Open the Blob content as a ReadableStream.\n   * @returns A ReadableStream of the Blob bytes.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    return this.blob.stream() as ReadableStream<Uint8Array>\n  }\n\n  /**\n   * Read the entire Blob content into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    if (options.signal === undefined) return this.blob.arrayBuffer()\n    const bytes = await collectStream(this.stream(), options)\n    return arrayBufferFor(bytes)\n  }\n}\n\n/** ContentSource backed by a Uint8Array buffer. */\nexport class BufferSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: the entire payload lives in memory. */\n  readonly canSlice = true\n\n  /**\n   * Create a BufferSource wrapping the given Uint8Array.\n   * @param buffer - The byte buffer to use as the underlying content.\n   */\n  constructor(private readonly buffer: Uint8Array) {\n    this.size = buffer.byteLength\n  }\n\n  /**\n   * Return a new BufferSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BufferSource(this.buffer.slice(start, end))\n  }\n\n  /**\n   * Open the buffer content as a ReadableStream.\n   * @returns A ReadableStream that emits the buffer bytes in a single chunk.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    const buffer = this.buffer\n    return new ReadableStream({\n      start(controller) {\n        controller.enqueue(buffer)\n        controller.close()\n      },\n    })\n  }\n\n  /**\n   * Read the entire buffer content into an ArrayBuffer.\n   * @param options - Optional abort signal checked before returning bytes.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    return arrayBufferFor(this.buffer)\n  }\n}\n\n/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */\nexport class StreamSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /**\n   * Forward-only: ReadableStreams cannot be repositioned, so multipart\n   * uploads must take the sequential path. See the interface comment on\n   * `canSlice` for what the engine does with this flag.\n   */\n  readonly canSlice = false\n  /** Whether the stream has already been read. */\n  private consumed = false\n\n  /**\n   * Create a StreamSource wrapping the given ReadableStream with a known byte size.\n   * @param readable - The ReadableStream to wrap as a content source.\n   * @param size - The total number of bytes the stream will produce.\n   */\n  constructor(\n    private readonly readable: ReadableStream<Uint8Array>,\n    size: number,\n  ) {\n    validateStreamSourceSize(size)\n    this.size = size\n  }\n\n  /**\n   * Always throws because streams cannot be sliced. Buffer the stream first.\n   *\n   * @throws If slicing is attempted on a stream-backed source.\n   */\n  slice(): ContentSource {\n    throw new Error('StreamSource does not support slicing. Buffer the stream first.')\n  }\n\n  /**\n   * Open the underlying ReadableStream. Can only be called once.\n   * @returns The underlying ReadableStream of bytes.\n   *\n   * @throws If the stream has already been consumed.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    if (this.consumed) throw new Error('StreamSource can only be consumed once.')\n    this.consumed = true\n    return this.readable\n  }\n\n  /**\n   * Read the entire stream into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    const bytes = await collectStreamExactly(this.stream(), this.size, options.signal)\n    return bytes.buffer as ArrayBuffer\n  }\n}\n\nfunction validateStreamSourceSize(size: number): void {\n  if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) {\n    throw new RangeError('StreamSource size must be a non-negative finite integer.')\n  }\n}\n\n/**\n * Reads exactly the advertised number of bytes from a stream.\n * @param stream - Stream to consume.\n * @param expectedSize - Exact number of bytes expected from the stream.\n * @param signal - Optional abort signal for cancelling the read.\n *\n * @returns A byte array of length `expectedSize`.\n *\n * @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.\n */\nexport async function collectStreamExactly(\n  stream: ReadableStream<Uint8Array>,\n  expectedSize: number,\n  signal?: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer>> {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  let completed = false\n\n  try {\n    while (total < expectedSize) {\n      const { done, value } = await readNextNonEmptyStreamChunk(\n        reader,\n        STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n        signal,\n      )\n      if (done) throw new Error(STREAM_SOURCE_ENDED_EARLY_ERROR)\n      if (total + value.byteLength > expectedSize) {\n        throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n      }\n      chunks.push(value)\n      total += value.byteLength\n    }\n\n    const extra = await readNextNonEmptyStreamChunk(\n      reader,\n      STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n      signal,\n    )\n    if (!extra.done) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n\n    const result = new Uint8Array(expectedSize)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    completed = true\n    return result\n  } finally {\n    if (!completed) {\n      cancelReaderBestEffort(reader)\n    }\n    try {\n      reader.releaseLock()\n    } catch {\n      // Aborted reads can leave a pending read while best-effort cancel is\n      // still unsettled. Preserve the original abort/error instead.\n    }\n  }\n}\n\n/**\n * Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.\n * @param reader - Locked reader for a Uint8Array stream.\n * @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.\n * @param signal - Optional abort signal that cancels the reader and rejects the read.\n *\n * @returns The next non-empty chunk or EOF result.\n */\nexport async function readNextNonEmptyStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  emptyChunkErrorMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readStreamChunk(reader, signal)\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_EMPTY_STREAM_CHUNKS) {\n      throw new Error(emptyChunkErrorMessage)\n    }\n  }\n}\n\nasync function readStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  signal: AbortSignal | undefined,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  if (signal === undefined) return reader.read()\n  if (signal.aborted) {\n    const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n    cancelReaderBestEffort(reader, reason)\n    throw reason\n  }\n\n  let removeAbortListener: (() => void) | undefined\n  const abort = new Promise<never>((_, reject) => {\n    const onAbort = (): void => {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      reject(reason)\n    }\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    const result = await Promise.race([reader.read(), abort])\n    if (signal.aborted) {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      throw reason\n    }\n    return result\n  } finally {\n    removeAbortListener?.()\n  }\n}\n\nfunction cancelReaderBestEffort(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  reason?: unknown,\n): void {\n  /* v8 ignore next -- Reader cancellation failure is deliberately best-effort. */\n  void reader.cancel(reason).catch(() => {})\n}\n\n/** ContentSource backed by a forward-only async iterable of Uint8Array chunks. */\nclass AsyncIterableSource extends StreamSource {\n  /**\n   * Create an AsyncIterableSource from a known-size async iterable.\n   * @param iterable - Async iterable that yields Uint8Array chunks.\n   * @param size - Total byte length the iterable will produce.\n   */\n  constructor(iterable: AsyncIterable<Uint8Array>, size: number) {\n    super(asyncIterableToReadableStream(iterable), size)\n  }\n}\n\n/**\n * Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.\n * When passing a ReadableStream or async iterable, the `size` parameter is required.\n * @param input - The content to wrap.\n * @param size - The total byte length, required for forward-only inputs.\n *\n * @returns A ContentSource adapter for the given input.\n *\n * @throws If input is forward-only and size is not provided.\n */\nexport function toContentSource(\n  input: Uint8Array | Blob | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>,\n  size?: number,\n): ContentSource {\n  if (input instanceof Uint8Array) {\n    return new BufferSource(input)\n  }\n  if (input instanceof Blob) {\n    return new BlobSource(input)\n  }\n  if (isReadableStream(input)) {\n    if (size === undefined) {\n      throw new Error(READABLE_STREAM_SIZE_REQUIRED_ERROR)\n    }\n    return new StreamSource(input, size)\n  }\n  if (isAsyncIterable(input)) {\n    if (size === undefined) {\n      throw new Error(FORWARD_ONLY_SIZE_REQUIRED_ERROR)\n    }\n    return new AsyncIterableSource(input, size)\n  }\n  throw new TypeError('Unsupported content source input.')\n}\n"],"mappings":"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"}

package/dist/sync/b2-sha1-reader.cjs

@@ -1,3 +1,4 @@
+const require_abort = require("../util/abort.cjs");
 const require_hash = require("../streams/hash.cjs");
 const require_sha1_options = require("./sha1-options.cjs");
 //#region src/sync/b2-sha1-reader.ts
@@ -26,7 +27,7 @@ async function readStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage,
 	}
 }
 async function readRawStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage, signal) {
-	signal?.throwIfAborted();
+	require_abort.throwIfSignalAborted(signal);
 	let timeout;
 	let removeAbortListener;
 	const readPromise = reader.read();
@@ -36,9 +37,12 @@ async function readRawStreamChunkWithTimeout(reader, timeoutMillis, stalledMessa
 		}, timeoutMillis);
 	});
 	const abortPromise = signal === void 0 ? void 0 : new Promise((_, reject) => {
-		const onAbort = () => reject(signal.reason ?? /* @__PURE__ */ new Error("aborted"));
+		const onAbort = () => {
+			reject(require_abort.abortReason(signal));
+		};
 		signal.addEventListener("abort", onAbort, { once: true });
 		removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+		if (signal.aborted) onAbort();
 	});
 	try {
 		if (timeoutPromise === void 0 && abortPromise === void 0) return await readPromise;

package/dist/sync/b2-sha1-reader.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"b2-sha1-reader.cjs","names":[],"sources":["../../src/sync/b2-sha1-reader.ts"],"sourcesContent":["import { IncrementalSha1 } from '../streams/hash.ts'\nimport { normalizeSha1TimeoutMillis } from './sha1-options.ts'\n\nconst MAX_CONSECUTIVE_EMPTY_READ_CHUNKS = 1024\n\n/**\n * Reads one non-empty stream chunk with an idle timeout and optional abort signal.\n * Empty chunks are not progress; too many consecutive empty chunks fail with the\n * same stalled-read diagnostic used for pending reads.\n *\n * @param reader - Locked reader to read from.\n * @param timeoutMillis - Idle timeout in milliseconds for this read.\n * @param stalledMessage - Error message used when the read makes no progress.\n * @param signal - Optional abort signal to observe while reading.\n *\n * @returns The next stream read result.\n *\n * @internal\n */\nexport async function readStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readRawStreamChunkWithTimeout(\n      reader,\n      timeoutMillis,\n      stalledMessage,\n      signal,\n    )\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_CONSECUTIVE_EMPTY_READ_CHUNKS) {\n      throw new Error(stalledMessage)\n    }\n  }\n}\n\nasync function readRawStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  signal?.throwIfAborted()\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  let removeAbortListener: (() => void) | undefined\n  const readPromise = reader.read()\n  const timeoutPromise =\n    timeoutMillis === Number.POSITIVE_INFINITY\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          timeout = setTimeout(() => {\n            reject(new Error(stalledMessage))\n          }, timeoutMillis)\n        })\n  const abortPromise =\n    signal === undefined\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          const onAbort = () => reject(signal.reason ?? new Error('aborted'))\n          signal.addEventListener('abort', onAbort, { once: true })\n          removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n        })\n\n  try {\n    if (timeoutPromise === undefined && abortPromise === undefined) return await readPromise\n    const candidates = [readPromise]\n    if (timeoutPromise !== undefined) candidates.push(timeoutPromise)\n    if (abortPromise !== undefined) candidates.push(abortPromise)\n    return await Promise.race(candidates)\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    removeAbortListener?.()\n    void readPromise.catch(() => {})\n  }\n}\n\n/**\n * Hashes a B2 response body as SHA-1 with idle timeout, abort, and size checks.\n *\n * @param body - Response body stream to hash.\n * @param signal - Optional abort signal to observe while reading.\n * @param options - Optional timeout and byte-count limits.\n *\n * @returns The computed SHA-1 and number of bytes read.\n *\n * @internal\n */\nexport async function hashReadableStreamSha1(\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n  options?: {\n    readonly idleTimeoutMillis: number\n    readonly maxBytes: number\n    readonly expectedBytes: number\n  },\n): Promise<{ readonly contentSha1: string; readonly bytesRead: number }> {\n  const hash = new IncrementalSha1()\n  const reader = body.getReader()\n  const idleTimeoutMillis = options?.idleTimeoutMillis ?? normalizeSha1TimeoutMillis(undefined)\n  const maxBytes = options?.maxBytes ?? Number.POSITIVE_INFINITY\n  const expectedBytes = options?.expectedBytes\n  let bytesRead = 0\n  try {\n    while (true) {\n      const { done, value } = await readStreamChunkWithTimeout(\n        reader,\n        idleTimeoutMillis,\n        `sha1 B2 read stalled for ${idleTimeoutMillis} ms`,\n        signal,\n      )\n      if (done) break\n      bytesRead += value.byteLength\n      if (bytesRead > maxBytes) {\n        throw new Error(`sha1 B2 read exceeded ${maxBytes} byte verification budget`)\n      }\n      await hash.update(value)\n    }\n    if (expectedBytes !== undefined && bytesRead !== expectedBytes) {\n      throw new Error(`sha1 B2 read ended after ${bytesRead} bytes, expected ${expectedBytes}`)\n    }\n    return { contentSha1: await hash.digest(), bytesRead }\n  } catch (err) {\n    void reader.cancel(err).catch(() => {})\n    throw err\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Applies an absolute verification deadline while forwarding parent aborts.\n *\n * @param signal - Optional parent abort signal.\n * @param timeoutMillis - Absolute deadline in milliseconds.\n * @param run - Operation to run with the derived deadline signal.\n *\n * @returns The operation result.\n *\n * @internal\n */\nexport async function withSha1VerificationDeadline<T>(\n  signal: AbortSignal | undefined,\n  timeoutMillis: number,\n  run: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n  const controller = new AbortController()\n  const abortFromParent = () => controller.abort(signal?.reason)\n  if (signal?.aborted) abortFromParent()\n  signal?.addEventListener('abort', abortFromParent, { once: true })\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeout = setTimeout(() => {\n      const error = new Error(`sha1 B2 verification exceeded ${timeoutMillis} ms`)\n      controller.abort(error)\n      reject(error)\n    }, timeoutMillis)\n  })\n  const runPromise = run(controller.signal)\n  try {\n    return await Promise.race([runPromise, timeoutPromise])\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    signal?.removeEventListener('abort', abortFromParent)\n    void runPromise.catch(() => {})\n  }\n}\n\n/**\n * Bounds B2 SHA-1 verification downloads to the selected object's size and optional ceiling.\n *\n * @param contentLength - Selected B2 object byte length.\n * @param ceiling - Optional lower verification budget.\n *\n * @returns The byte budget to enforce.\n *\n * @internal\n */\nexport function normalizeSha1VerificationMaxBytes(\n  contentLength: number,\n  ceiling: number | undefined,\n): number {\n  const contentBudget = Math.max(0, Math.floor(contentLength))\n  if (ceiling === undefined) return contentBudget\n  if (!Number.isFinite(ceiling) || ceiling < 0) return contentBudget\n  return Math.min(contentBudget, Math.floor(ceiling))\n}\n"],"mappings":"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"}
+{"version":3,"file":"b2-sha1-reader.cjs","names":[],"sources":["../../src/sync/b2-sha1-reader.ts"],"sourcesContent":["import { IncrementalSha1 } from '../streams/hash.ts'\nimport { abortReason, throwIfSignalAborted } from '../util/abort.ts'\nimport { normalizeSha1TimeoutMillis } from './sha1-options.ts'\n\nconst MAX_CONSECUTIVE_EMPTY_READ_CHUNKS = 1024\n\n/**\n * Reads one non-empty stream chunk with an idle timeout and optional abort signal.\n * Empty chunks are not progress; too many consecutive empty chunks fail with the\n * same stalled-read diagnostic used for pending reads.\n *\n * @param reader - Locked reader to read from.\n * @param timeoutMillis - Idle timeout in milliseconds for this read.\n * @param stalledMessage - Error message used when the read makes no progress.\n * @param signal - Optional abort signal to observe while reading.\n *\n * @returns The next stream read result.\n *\n * @internal\n */\nexport async function readStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readRawStreamChunkWithTimeout(\n      reader,\n      timeoutMillis,\n      stalledMessage,\n      signal,\n    )\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_CONSECUTIVE_EMPTY_READ_CHUNKS) {\n      throw new Error(stalledMessage)\n    }\n  }\n}\n\nasync function readRawStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  throwIfSignalAborted(signal)\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  let removeAbortListener: (() => void) | undefined\n  const readPromise = reader.read()\n  const timeoutPromise =\n    timeoutMillis === Number.POSITIVE_INFINITY\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          timeout = setTimeout(() => {\n            reject(new Error(stalledMessage))\n          }, timeoutMillis)\n        })\n  const abortPromise =\n    signal === undefined\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          const onAbort = () => {\n            reject(abortReason(signal))\n          }\n          signal.addEventListener('abort', onAbort, { once: true })\n          removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n          if (signal.aborted) onAbort()\n        })\n\n  try {\n    if (timeoutPromise === undefined && abortPromise === undefined) return await readPromise\n    const candidates = [readPromise]\n    if (timeoutPromise !== undefined) candidates.push(timeoutPromise)\n    if (abortPromise !== undefined) candidates.push(abortPromise)\n    return await Promise.race(candidates)\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    removeAbortListener?.()\n    void readPromise.catch(() => {})\n  }\n}\n\n/**\n * Hashes a B2 response body as SHA-1 with idle timeout, abort, and size checks.\n *\n * @param body - Response body stream to hash.\n * @param signal - Optional abort signal to observe while reading.\n * @param options - Optional timeout and byte-count limits.\n *\n * @returns The computed SHA-1 and number of bytes read.\n *\n * @internal\n */\nexport async function hashReadableStreamSha1(\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n  options?: {\n    readonly idleTimeoutMillis: number\n    readonly maxBytes: number\n    readonly expectedBytes: number\n  },\n): Promise<{ readonly contentSha1: string; readonly bytesRead: number }> {\n  const hash = new IncrementalSha1()\n  const reader = body.getReader()\n  const idleTimeoutMillis = options?.idleTimeoutMillis ?? normalizeSha1TimeoutMillis(undefined)\n  const maxBytes = options?.maxBytes ?? Number.POSITIVE_INFINITY\n  const expectedBytes = options?.expectedBytes\n  let bytesRead = 0\n  try {\n    while (true) {\n      const { done, value } = await readStreamChunkWithTimeout(\n        reader,\n        idleTimeoutMillis,\n        `sha1 B2 read stalled for ${idleTimeoutMillis} ms`,\n        signal,\n      )\n      if (done) break\n      bytesRead += value.byteLength\n      if (bytesRead > maxBytes) {\n        throw new Error(`sha1 B2 read exceeded ${maxBytes} byte verification budget`)\n      }\n      await hash.update(value)\n    }\n    if (expectedBytes !== undefined && bytesRead !== expectedBytes) {\n      throw new Error(`sha1 B2 read ended after ${bytesRead} bytes, expected ${expectedBytes}`)\n    }\n    return { contentSha1: await hash.digest(), bytesRead }\n  } catch (err) {\n    void reader.cancel(err).catch(() => {})\n    throw err\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Applies an absolute verification deadline while forwarding parent aborts.\n *\n * @param signal - Optional parent abort signal.\n * @param timeoutMillis - Absolute deadline in milliseconds.\n * @param run - Operation to run with the derived deadline signal.\n *\n * @returns The operation result.\n *\n * @internal\n */\nexport async function withSha1VerificationDeadline<T>(\n  signal: AbortSignal | undefined,\n  timeoutMillis: number,\n  run: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n  const controller = new AbortController()\n  const abortFromParent = () => controller.abort(signal?.reason)\n  if (signal?.aborted) abortFromParent()\n  signal?.addEventListener('abort', abortFromParent, { once: true })\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeout = setTimeout(() => {\n      const error = new Error(`sha1 B2 verification exceeded ${timeoutMillis} ms`)\n      controller.abort(error)\n      reject(error)\n    }, timeoutMillis)\n  })\n  const runPromise = run(controller.signal)\n  try {\n    return await Promise.race([runPromise, timeoutPromise])\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    signal?.removeEventListener('abort', abortFromParent)\n    void runPromise.catch(() => {})\n  }\n}\n\n/**\n * Bounds B2 SHA-1 verification downloads to the selected object's size and optional ceiling.\n *\n * @param contentLength - Selected B2 object byte length.\n * @param ceiling - Optional lower verification budget.\n *\n * @returns The byte budget to enforce.\n *\n * @internal\n */\nexport function normalizeSha1VerificationMaxBytes(\n  contentLength: number,\n  ceiling: number | undefined,\n): number {\n  const contentBudget = Math.max(0, Math.floor(contentLength))\n  if (ceiling === undefined) return contentBudget\n  if (!Number.isFinite(ceiling) || ceiling < 0) return contentBudget\n  return Math.min(contentBudget, Math.floor(ceiling))\n}\n"],"mappings":"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"}

package/dist/sync/b2-sha1-reader.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"b2-sha1-reader.d.ts","sourceRoot":"","sources":["../../src/sync/b2-sha1-reader.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAe/C;AA2CD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAKR"}
+{"version":3,"file":"b2-sha1-reader.d.ts","sourceRoot":"","sources":["../../src/sync/b2-sha1-reader.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAe/C;AA8CD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAKR"}

package/dist/sync/b2-sha1-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b2-sha1-reader.d.ts","sourceRoot":"","sources":["../../src/sync/b2-sha1-reader.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAe/C;AA2CD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAKR"}
+{"version":3,"file":"b2-sha1-reader.d.ts","sourceRoot":"","sources":["../../src/sync/b2-sha1-reader.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAe/C;AA8CD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAKR"}

package/dist/sync/b2-sha1-reader.js

@@ -1,3 +1,4 @@
+import { abortReason, throwIfSignalAborted } from "../util/abort.js";
 import { IncrementalSha1 } from "../streams/hash.js";
 import { normalizeSha1TimeoutMillis } from "./sha1-options.js";
 //#region src/sync/b2-sha1-reader.ts
@@ -26,7 +27,7 @@ async function readStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage,
 	}
 }
 async function readRawStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage, signal) {
-	signal?.throwIfAborted();
+	throwIfSignalAborted(signal);
 	let timeout;
 	let removeAbortListener;
 	const readPromise = reader.read();
@@ -36,9 +37,12 @@ async function readRawStreamChunkWithTimeout(reader, timeoutMillis, stalledMessa
 		}, timeoutMillis);
 	});
 	const abortPromise = signal === void 0 ? void 0 : new Promise((_, reject) => {
-		const onAbort = () => reject(signal.reason ?? /* @__PURE__ */ new Error("aborted"));
+		const onAbort = () => {
+			reject(abortReason(signal));
+		};
 		signal.addEventListener("abort", onAbort, { once: true });
 		removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+		if (signal.aborted) onAbort();
 	});
 	try {
 		if (timeoutPromise === void 0 && abortPromise === void 0) return await readPromise;

package/dist/sync/b2-sha1-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"b2-sha1-reader.js","names":[],"sources":["../../src/sync/b2-sha1-reader.ts"],"sourcesContent":["import { IncrementalSha1 } from '../streams/hash.ts'\nimport { normalizeSha1TimeoutMillis } from './sha1-options.ts'\n\nconst MAX_CONSECUTIVE_EMPTY_READ_CHUNKS = 1024\n\n/**\n * Reads one non-empty stream chunk with an idle timeout and optional abort signal.\n * Empty chunks are not progress; too many consecutive empty chunks fail with the\n * same stalled-read diagnostic used for pending reads.\n *\n * @param reader - Locked reader to read from.\n * @param timeoutMillis - Idle timeout in milliseconds for this read.\n * @param stalledMessage - Error message used when the read makes no progress.\n * @param signal - Optional abort signal to observe while reading.\n *\n * @returns The next stream read result.\n *\n * @internal\n */\nexport async function readStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readRawStreamChunkWithTimeout(\n      reader,\n      timeoutMillis,\n      stalledMessage,\n      signal,\n    )\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_CONSECUTIVE_EMPTY_READ_CHUNKS) {\n      throw new Error(stalledMessage)\n    }\n  }\n}\n\nasync function readRawStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  signal?.throwIfAborted()\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  let removeAbortListener: (() => void) | undefined\n  const readPromise = reader.read()\n  const timeoutPromise =\n    timeoutMillis === Number.POSITIVE_INFINITY\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          timeout = setTimeout(() => {\n            reject(new Error(stalledMessage))\n          }, timeoutMillis)\n        })\n  const abortPromise =\n    signal === undefined\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          const onAbort = () => reject(signal.reason ?? new Error('aborted'))\n          signal.addEventListener('abort', onAbort, { once: true })\n          removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n        })\n\n  try {\n    if (timeoutPromise === undefined && abortPromise === undefined) return await readPromise\n    const candidates = [readPromise]\n    if (timeoutPromise !== undefined) candidates.push(timeoutPromise)\n    if (abortPromise !== undefined) candidates.push(abortPromise)\n    return await Promise.race(candidates)\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    removeAbortListener?.()\n    void readPromise.catch(() => {})\n  }\n}\n\n/**\n * Hashes a B2 response body as SHA-1 with idle timeout, abort, and size checks.\n *\n * @param body - Response body stream to hash.\n * @param signal - Optional abort signal to observe while reading.\n * @param options - Optional timeout and byte-count limits.\n *\n * @returns The computed SHA-1 and number of bytes read.\n *\n * @internal\n */\nexport async function hashReadableStreamSha1(\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n  options?: {\n    readonly idleTimeoutMillis: number\n    readonly maxBytes: number\n    readonly expectedBytes: number\n  },\n): Promise<{ readonly contentSha1: string; readonly bytesRead: number }> {\n  const hash = new IncrementalSha1()\n  const reader = body.getReader()\n  const idleTimeoutMillis = options?.idleTimeoutMillis ?? normalizeSha1TimeoutMillis(undefined)\n  const maxBytes = options?.maxBytes ?? Number.POSITIVE_INFINITY\n  const expectedBytes = options?.expectedBytes\n  let bytesRead = 0\n  try {\n    while (true) {\n      const { done, value } = await readStreamChunkWithTimeout(\n        reader,\n        idleTimeoutMillis,\n        `sha1 B2 read stalled for ${idleTimeoutMillis} ms`,\n        signal,\n      )\n      if (done) break\n      bytesRead += value.byteLength\n      if (bytesRead > maxBytes) {\n        throw new Error(`sha1 B2 read exceeded ${maxBytes} byte verification budget`)\n      }\n      await hash.update(value)\n    }\n    if (expectedBytes !== undefined && bytesRead !== expectedBytes) {\n      throw new Error(`sha1 B2 read ended after ${bytesRead} bytes, expected ${expectedBytes}`)\n    }\n    return { contentSha1: await hash.digest(), bytesRead }\n  } catch (err) {\n    void reader.cancel(err).catch(() => {})\n    throw err\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Applies an absolute verification deadline while forwarding parent aborts.\n *\n * @param signal - Optional parent abort signal.\n * @param timeoutMillis - Absolute deadline in milliseconds.\n * @param run - Operation to run with the derived deadline signal.\n *\n * @returns The operation result.\n *\n * @internal\n */\nexport async function withSha1VerificationDeadline<T>(\n  signal: AbortSignal | undefined,\n  timeoutMillis: number,\n  run: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n  const controller = new AbortController()\n  const abortFromParent = () => controller.abort(signal?.reason)\n  if (signal?.aborted) abortFromParent()\n  signal?.addEventListener('abort', abortFromParent, { once: true })\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeout = setTimeout(() => {\n      const error = new Error(`sha1 B2 verification exceeded ${timeoutMillis} ms`)\n      controller.abort(error)\n      reject(error)\n    }, timeoutMillis)\n  })\n  const runPromise = run(controller.signal)\n  try {\n    return await Promise.race([runPromise, timeoutPromise])\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    signal?.removeEventListener('abort', abortFromParent)\n    void runPromise.catch(() => {})\n  }\n}\n\n/**\n * Bounds B2 SHA-1 verification downloads to the selected object's size and optional ceiling.\n *\n * @param contentLength - Selected B2 object byte length.\n * @param ceiling - Optional lower verification budget.\n *\n * @returns The byte budget to enforce.\n *\n * @internal\n */\nexport function normalizeSha1VerificationMaxBytes(\n  contentLength: number,\n  ceiling: number | undefined,\n): number {\n  const contentBudget = Math.max(0, Math.floor(contentLength))\n  if (ceiling === undefined) return contentBudget\n  if (!Number.isFinite(ceiling) || ceiling < 0) return contentBudget\n  return Math.min(contentBudget, Math.floor(ceiling))\n}\n"],"mappings":"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"}
+{"version":3,"file":"b2-sha1-reader.js","names":[],"sources":["../../src/sync/b2-sha1-reader.ts"],"sourcesContent":["import { IncrementalSha1 } from '../streams/hash.ts'\nimport { abortReason, throwIfSignalAborted } from '../util/abort.ts'\nimport { normalizeSha1TimeoutMillis } from './sha1-options.ts'\n\nconst MAX_CONSECUTIVE_EMPTY_READ_CHUNKS = 1024\n\n/**\n * Reads one non-empty stream chunk with an idle timeout and optional abort signal.\n * Empty chunks are not progress; too many consecutive empty chunks fail with the\n * same stalled-read diagnostic used for pending reads.\n *\n * @param reader - Locked reader to read from.\n * @param timeoutMillis - Idle timeout in milliseconds for this read.\n * @param stalledMessage - Error message used when the read makes no progress.\n * @param signal - Optional abort signal to observe while reading.\n *\n * @returns The next stream read result.\n *\n * @internal\n */\nexport async function readStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readRawStreamChunkWithTimeout(\n      reader,\n      timeoutMillis,\n      stalledMessage,\n      signal,\n    )\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_CONSECUTIVE_EMPTY_READ_CHUNKS) {\n      throw new Error(stalledMessage)\n    }\n  }\n}\n\nasync function readRawStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  throwIfSignalAborted(signal)\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  let removeAbortListener: (() => void) | undefined\n  const readPromise = reader.read()\n  const timeoutPromise =\n    timeoutMillis === Number.POSITIVE_INFINITY\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          timeout = setTimeout(() => {\n            reject(new Error(stalledMessage))\n          }, timeoutMillis)\n        })\n  const abortPromise =\n    signal === undefined\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          const onAbort = () => {\n            reject(abortReason(signal))\n          }\n          signal.addEventListener('abort', onAbort, { once: true })\n          removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n          if (signal.aborted) onAbort()\n        })\n\n  try {\n    if (timeoutPromise === undefined && abortPromise === undefined) return await readPromise\n    const candidates = [readPromise]\n    if (timeoutPromise !== undefined) candidates.push(timeoutPromise)\n    if (abortPromise !== undefined) candidates.push(abortPromise)\n    return await Promise.race(candidates)\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    removeAbortListener?.()\n    void readPromise.catch(() => {})\n  }\n}\n\n/**\n * Hashes a B2 response body as SHA-1 with idle timeout, abort, and size checks.\n *\n * @param body - Response body stream to hash.\n * @param signal - Optional abort signal to observe while reading.\n * @param options - Optional timeout and byte-count limits.\n *\n * @returns The computed SHA-1 and number of bytes read.\n *\n * @internal\n */\nexport async function hashReadableStreamSha1(\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n  options?: {\n    readonly idleTimeoutMillis: number\n    readonly maxBytes: number\n    readonly expectedBytes: number\n  },\n): Promise<{ readonly contentSha1: string; readonly bytesRead: number }> {\n  const hash = new IncrementalSha1()\n  const reader = body.getReader()\n  const idleTimeoutMillis = options?.idleTimeoutMillis ?? normalizeSha1TimeoutMillis(undefined)\n  const maxBytes = options?.maxBytes ?? Number.POSITIVE_INFINITY\n  const expectedBytes = options?.expectedBytes\n  let bytesRead = 0\n  try {\n    while (true) {\n      const { done, value } = await readStreamChunkWithTimeout(\n        reader,\n        idleTimeoutMillis,\n        `sha1 B2 read stalled for ${idleTimeoutMillis} ms`,\n        signal,\n      )\n      if (done) break\n      bytesRead += value.byteLength\n      if (bytesRead > maxBytes) {\n        throw new Error(`sha1 B2 read exceeded ${maxBytes} byte verification budget`)\n      }\n      await hash.update(value)\n    }\n    if (expectedBytes !== undefined && bytesRead !== expectedBytes) {\n      throw new Error(`sha1 B2 read ended after ${bytesRead} bytes, expected ${expectedBytes}`)\n    }\n    return { contentSha1: await hash.digest(), bytesRead }\n  } catch (err) {\n    void reader.cancel(err).catch(() => {})\n    throw err\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Applies an absolute verification deadline while forwarding parent aborts.\n *\n * @param signal - Optional parent abort signal.\n * @param timeoutMillis - Absolute deadline in milliseconds.\n * @param run - Operation to run with the derived deadline signal.\n *\n * @returns The operation result.\n *\n * @internal\n */\nexport async function withSha1VerificationDeadline<T>(\n  signal: AbortSignal | undefined,\n  timeoutMillis: number,\n  run: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n  const controller = new AbortController()\n  const abortFromParent = () => controller.abort(signal?.reason)\n  if (signal?.aborted) abortFromParent()\n  signal?.addEventListener('abort', abortFromParent, { once: true })\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeout = setTimeout(() => {\n      const error = new Error(`sha1 B2 verification exceeded ${timeoutMillis} ms`)\n      controller.abort(error)\n      reject(error)\n    }, timeoutMillis)\n  })\n  const runPromise = run(controller.signal)\n  try {\n    return await Promise.race([runPromise, timeoutPromise])\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    signal?.removeEventListener('abort', abortFromParent)\n    void runPromise.catch(() => {})\n  }\n}\n\n/**\n * Bounds B2 SHA-1 verification downloads to the selected object's size and optional ceiling.\n *\n * @param contentLength - Selected B2 object byte length.\n * @param ceiling - Optional lower verification budget.\n *\n * @returns The byte budget to enforce.\n *\n * @internal\n */\nexport function normalizeSha1VerificationMaxBytes(\n  contentLength: number,\n  ceiling: number | undefined,\n): number {\n  const contentBudget = Math.max(0, Math.floor(contentLength))\n  if (ceiling === undefined) return contentBudget\n  if (!Number.isFinite(ceiling) || ceiling < 0) return contentBudget\n  return Math.min(contentBudget, Math.floor(ceiling))\n}\n"],"mappings":"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"}