@backblaze-labs/b2-sdk 0.2.0 → 0.4.0

package/dist/streams/hash.js

@@ -1,5 +1,5 @@
 import { arrayBufferFor } from "../util/bytes.js";
-import { hexEncode } from "../util/crypto.js";
+import { hexEncode, sha256Hex as sha256Hex$1 } from "../util/crypto.js";
 //#region src/streams/hash.ts
 var nodeCreateHash;
 /**
@@ -29,24 +29,20 @@ async function getNodeCreateHash() {
 	}
 	return nodeCreateHash;
 }
-/**
-* Incrementally computes SHA-1 hashes over streaming data.
-* Uses Node.js `crypto` when available, falling back to a dependency-free
-* incremental JavaScript implementation.
-*/
-var IncrementalSha1 = class {
+var IncrementalHash = class {
+	algorithm;
+	jsHash;
 	/** Total bytes fed into the hash so far. */
 	totalLength = 0;
 	/** Node.js hash instance, or null if using the JavaScript fallback. */
 	nodeHash = null;
-	/** Streaming JavaScript fallback used when Node crypto is unavailable. */
-	jsHash = new JsSha1Hasher();
 	/** Resolves once the crypto backend has been loaded. */
 	initPromise;
-	/** Creates a new IncrementalSha1 and lazily initializes the crypto backend. */
-	constructor() {
+	constructor(algorithm, jsHash) {
+		this.algorithm = algorithm;
+		this.jsHash = jsHash;
 		this.initPromise = getNodeCreateHash().then((factory) => {
-			if (factory) this.nodeHash = factory("sha1");
+			if (factory) this.nodeHash = factory(this.algorithm);
 		});
 	}
 	/**
@@ -64,8 +60,8 @@ var IncrementalSha1 = class {
 		this.totalLength += data.byteLength;
 	}
 	/**
-	* Finalize the hash and return the hex-encoded SHA-1 digest.
-	* @returns The lowercase hex-encoded SHA-1 digest of all data fed so far.
+	* Finalize the hash and return the hex-encoded digest.
+	* @returns The lowercase hex-encoded digest of all data fed so far.
 	*/
 	async digest() {
 		await this.initPromise;
@@ -82,6 +78,28 @@ var IncrementalSha1 = class {
 		return this.totalLength;
 	}
 };
+/**
+* Incrementally computes SHA-1 hashes over streaming data.
+* Uses Node.js `crypto` when available, falling back to a dependency-free
+* incremental JavaScript implementation.
+*/
+var IncrementalSha1 = class extends IncrementalHash {
+	/** Creates a new IncrementalSha1 and lazily initializes the crypto backend. */
+	constructor() {
+		super("sha1", new JsSha1Hasher());
+	}
+};
+/**
+* Incrementally computes SHA-256 hashes over streaming data.
+* Uses Node.js `crypto` when available, falling back to a dependency-free
+* incremental JavaScript implementation.
+*/
+var IncrementalSha256 = class extends IncrementalHash {
+	/** Creates a new IncrementalSha256 and lazily initializes the crypto backend. */
+	constructor() {
+		super("sha256", new JsSha256Hasher());
+	}
+};
 /* v8 ignore start -- JavaScript fallback path, exercised by browser-mode tests */
 var JsSha1Hasher = class {
 	h0 = 1732584193;
@@ -189,6 +207,210 @@ function rotateLeft(value, bits) {
 function wordToHex(word) {
 	return word.toString(16).padStart(8, "0");
 }
+var SHA256_INITIAL_STATE = [
+	1779033703,
+	3144134277,
+	1013904242,
+	2773480762,
+	1359893119,
+	2600822924,
+	528734635,
+	1541459225
+];
+var SHA256_K = [
+	1116352408,
+	1899447441,
+	3049323471,
+	3921009573,
+	961987163,
+	1508970993,
+	2453635748,
+	2870763221,
+	3624381080,
+	310598401,
+	607225278,
+	1426881987,
+	1925078388,
+	2162078206,
+	2614888103,
+	3248222580,
+	3835390401,
+	4022224774,
+	264347078,
+	604807628,
+	770255983,
+	1249150122,
+	1555081692,
+	1996064986,
+	2554220882,
+	2821834349,
+	2952996808,
+	3210313671,
+	3336571891,
+	3584528711,
+	113926993,
+	338241895,
+	666307205,
+	773529912,
+	1294757372,
+	1396182291,
+	1695183700,
+	1986661051,
+	2177026350,
+	2456956037,
+	2730485921,
+	2820302411,
+	3259730800,
+	3345764771,
+	3516065817,
+	3600352804,
+	4094571909,
+	275423344,
+	430227734,
+	506948616,
+	659060556,
+	883997877,
+	958139571,
+	1322822218,
+	1537002063,
+	1747873779,
+	1955562222,
+	2024104815,
+	2227730452,
+	2361852424,
+	2428436474,
+	2756734187,
+	3204031479,
+	3329325298
+];
+var JsSha256Hasher = class {
+	h0 = SHA256_INITIAL_STATE[0];
+	h1 = SHA256_INITIAL_STATE[1];
+	h2 = SHA256_INITIAL_STATE[2];
+	h3 = SHA256_INITIAL_STATE[3];
+	h4 = SHA256_INITIAL_STATE[4];
+	h5 = SHA256_INITIAL_STATE[5];
+	h6 = SHA256_INITIAL_STATE[6];
+	h7 = SHA256_INITIAL_STATE[7];
+	block = /* @__PURE__ */ new Uint8Array(64);
+	blockLength = 0;
+	bytesProcessed = 0;
+	digested = false;
+	words = /* @__PURE__ */ new Uint32Array(64);
+	update(data) {
+		if (this.digested) throw new Error("SHA-256 digest has already been finalized");
+		this.bytesProcessed += data.byteLength;
+		let offset = 0;
+		if (this.blockLength > 0) {
+			const toCopy = Math.min(64 - this.blockLength, data.byteLength);
+			this.block.set(data.subarray(0, toCopy), this.blockLength);
+			this.blockLength += toCopy;
+			offset = toCopy;
+			if (this.blockLength === 64) {
+				this.processBlock(this.block, 0);
+				this.blockLength = 0;
+			}
+		}
+		while (offset + 64 <= data.byteLength) {
+			this.processBlock(data, offset);
+			offset += 64;
+		}
+		if (offset < data.byteLength) {
+			this.block.set(data.subarray(offset), 0);
+			this.blockLength = data.byteLength - offset;
+		}
+	}
+	digest() {
+		if (this.digested) throw new Error("SHA-256 digest has already been finalized");
+		this.digested = true;
+		const bitLengthHigh = Math.floor(this.bytesProcessed / 536870912);
+		const bitLengthLow = this.bytesProcessed << 3 >>> 0;
+		this.block[this.blockLength] = 128;
+		this.blockLength++;
+		if (this.blockLength > 56) {
+			this.block.fill(0, this.blockLength, 64);
+			this.processBlock(this.block, 0);
+			this.blockLength = 0;
+		}
+		this.block.fill(0, this.blockLength, 56);
+		writeUint32(this.block, 56, bitLengthHigh);
+		writeUint32(this.block, 60, bitLengthLow);
+		this.processBlock(this.block, 0);
+		return [
+			this.h0,
+			this.h1,
+			this.h2,
+			this.h3,
+			this.h4,
+			this.h5,
+			this.h6,
+			this.h7
+		].map(wordToHex).join("");
+	}
+	processBlock(block, offset) {
+		const words = this.words;
+		for (let i = 0; i < 16; i++) {
+			const j = offset + i * 4;
+			words[i] = (block[j] ?? 0) << 24 | (block[j + 1] ?? 0) << 16 | (block[j + 2] ?? 0) << 8 | (block[j + 3] ?? 0);
+		}
+		for (let i = 16; i < 64; i++) words[i] = smallSigma1(words[i - 2] ?? 0) + (words[i - 7] ?? 0) + smallSigma0(words[i - 15] ?? 0) + (words[i - 16] ?? 0) >>> 0;
+		let a = this.h0;
+		let b = this.h1;
+		let c = this.h2;
+		let d = this.h3;
+		let e = this.h4;
+		let f = this.h5;
+		let g = this.h6;
+		let h = this.h7;
+		for (let i = 0; i < 64; i++) {
+			const t1 = h + bigSigma1(e) + sha256Choose(e, f, g) + (SHA256_K[i] ?? 0) + (words[i] ?? 0) >>> 0;
+			const t2 = bigSigma0(a) + sha256Majority(a, b, c) >>> 0;
+			h = g;
+			g = f;
+			f = e;
+			e = d + t1 >>> 0;
+			d = c;
+			c = b;
+			b = a;
+			a = t1 + t2 >>> 0;
+		}
+		this.h0 = this.h0 + a >>> 0;
+		this.h1 = this.h1 + b >>> 0;
+		this.h2 = this.h2 + c >>> 0;
+		this.h3 = this.h3 + d >>> 0;
+		this.h4 = this.h4 + e >>> 0;
+		this.h5 = this.h5 + f >>> 0;
+		this.h6 = this.h6 + g >>> 0;
+		this.h7 = this.h7 + h >>> 0;
+	}
+};
+function writeUint32(block, offset, value) {
+	block[offset] = value >>> 24 & 255;
+	block[offset + 1] = value >>> 16 & 255;
+	block[offset + 2] = value >>> 8 & 255;
+	block[offset + 3] = value & 255;
+}
+function rotateRight(value, bits) {
+	return (value >>> bits | value << 32 - bits) >>> 0;
+}
+function smallSigma0(value) {
+	return rotateRight(value, 7) ^ rotateRight(value, 18) ^ value >>> 3;
+}
+function smallSigma1(value) {
+	return rotateRight(value, 17) ^ rotateRight(value, 19) ^ value >>> 10;
+}
+function bigSigma0(value) {
+	return rotateRight(value, 2) ^ rotateRight(value, 13) ^ rotateRight(value, 22);
+}
+function bigSigma1(value) {
+	return rotateRight(value, 6) ^ rotateRight(value, 11) ^ rotateRight(value, 25);
+}
+function sha256Choose(x, y, z) {
+	return x & y ^ ~x & z;
+}
+function sha256Majority(x, y, z) {
+	return x & y ^ x & z ^ y & z;
+}
 /* v8 ignore stop */
 /**
 * Compute the SHA-1 hex digest of a complete byte array in one shot.
@@ -208,7 +430,16 @@ async function sha1Hex(data) {
 	return hexEncode(new Uint8Array(hashBuffer));
 	/* v8 ignore stop */
 }
+/**
+* Compute the SHA-256 hex digest of a complete byte array in one shot.
+* @param data - The byte array to hash.
+*
+* @returns The lowercase hex-encoded SHA-256 digest of the input.
+*/
+async function sha256Hex(data) {
+	return sha256Hex$1(data);
+}
 //#endregion
-export { IncrementalSha1, sha1Hex };
+export { IncrementalSha1, IncrementalSha256, sha1Hex, sha256Hex };
 
 //# sourceMappingURL=hash.js.map

package/dist/streams/hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"hash.js","names":[],"sources":["../../src/streams/hash.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { hexEncode } from '../util/crypto.ts'\n\n/** Internal wrapper around a Node.js Hash instance. */\ntype NodeHasher = { update(data: Uint8Array): void; digest(encoding: string): string }\n\n/** Factory that creates a NodeHasher for a given algorithm name. */\ntype NodeHashFactory = (algorithm: string) => NodeHasher\n\nlet nodeCreateHash: NodeHashFactory | null | undefined\n\n/**\n * Lazily loads `node:crypto` and caches the factory. Returns null in non-Node runtimes.\n *\n * @returns The cached hash factory, or null if Node crypto is unavailable.\n */\nasync function getNodeCreateHash(): Promise<NodeHashFactory | null> {\n  if (nodeCreateHash !== undefined) return nodeCreateHash\n  try {\n    // biome-ignore lint/suspicious/noTsIgnore: isomorphic import — @ts-ignore is silent when node:crypto resolves (Node) and suppresses the error when it doesn't (Deno/browser); @ts-expect-error can't do both\n    // @ts-ignore -- node:crypto may not exist in browser/edge runtimes\n    const crypto = await import('node:crypto')\n    // Vite's browser shim resolves the import but does not implement\n    // `createHash`. Probe explicitly so we fall through to the WebCrypto\n    // path instead of returning a broken factory.\n    if (typeof crypto.createHash !== 'function') throw new Error('createHash unavailable')\n    nodeCreateHash = (algo: string) => {\n      const h = crypto.createHash(algo)\n      return {\n        update(data: Uint8Array) {\n          h.update(data)\n        },\n        digest(encoding: string) {\n          return h.digest(encoding as 'hex') as string\n        },\n      }\n    }\n  } catch {\n    /* v8 ignore next -- non-Node runtime fallback, unreachable in Node coverage. */\n    nodeCreateHash = null\n  }\n  return nodeCreateHash\n}\n\n/**\n * Incrementally computes SHA-1 hashes over streaming data.\n * Uses Node.js `crypto` when available, falling back to a dependency-free\n * incremental JavaScript implementation.\n */\nexport class IncrementalSha1 {\n  /** Total bytes fed into the hash so far. */\n  private totalLength = 0\n  /** Node.js hash instance, or null if using the JavaScript fallback. */\n  private nodeHash: NodeHasher | null = null\n  /** Streaming JavaScript fallback used when Node crypto is unavailable. */\n  private jsHash = new JsSha1Hasher()\n  /** Resolves once the crypto backend has been loaded. */\n  private initPromise: Promise<void>\n\n  /** Creates a new IncrementalSha1 and lazily initializes the crypto backend. */\n  constructor() {\n    this.initPromise = getNodeCreateHash().then((factory) => {\n      if (factory) this.nodeHash = factory('sha1')\n    })\n  }\n\n  /**\n   * Feed data into the hash. Async because it lazily initializes the crypto backend.\n   * @param data - The bytes to include in the hash computation.\n   *\n   * @returns A promise that resolves once the data has been consumed.\n   */\n  async update(data: Uint8Array): Promise<void> {\n    await this.initPromise\n    if (this.nodeHash) {\n      this.nodeHash.update(data)\n    } else {\n      /* v8 ignore next -- WebCrypto fallback is exercised by browser-mode tests. */\n      this.jsHash.update(data)\n    }\n    this.totalLength += data.byteLength\n  }\n\n  /**\n   * Finalize the hash and return the hex-encoded SHA-1 digest.\n   * @returns The lowercase hex-encoded SHA-1 digest of all data fed so far.\n   */\n  async digest(): Promise<string> {\n    await this.initPromise\n    if (this.nodeHash) {\n      return this.nodeHash.digest('hex')\n    }\n\n    /* v8 ignore next -- non-Node runtime fallback, exercised by browser-mode tests */\n    return this.jsHash.digest()\n  }\n\n  /**\n   * Total number of bytes fed into the hash so far.\n   *\n   * @returns The cumulative byte count across all update calls.\n   */\n  get bytesProcessed(): number {\n    return this.totalLength\n  }\n}\n\n/* v8 ignore start -- JavaScript fallback path, exercised by browser-mode tests */\nclass JsSha1Hasher {\n  private h0 = 0x67452301\n  private h1 = 0xefcdab89\n  private h2 = 0x98badcfe\n  private h3 = 0x10325476\n  private h4 = 0xc3d2e1f0\n  private readonly block = new Uint8Array(64)\n  private blockLength = 0\n  private bytesProcessed = 0\n  private digested = false\n  private readonly words = new Uint32Array(80)\n\n  update(data: Uint8Array): void {\n    if (this.digested) throw new Error('SHA-1 digest has already been finalized')\n    this.bytesProcessed += data.byteLength\n\n    let offset = 0\n    if (this.blockLength > 0) {\n      const toCopy = Math.min(64 - this.blockLength, data.byteLength)\n      this.block.set(data.subarray(0, toCopy), this.blockLength)\n      this.blockLength += toCopy\n      offset = toCopy\n      if (this.blockLength === 64) {\n        this.processBlock(this.block, 0)\n        this.blockLength = 0\n      }\n    }\n\n    while (offset + 64 <= data.byteLength) {\n      this.processBlock(data, offset)\n      offset += 64\n    }\n\n    if (offset < data.byteLength) {\n      this.block.set(data.subarray(offset), 0)\n      this.blockLength = data.byteLength - offset\n    }\n  }\n\n  digest(): string {\n    if (this.digested) throw new Error('SHA-1 digest has already been finalized')\n    this.digested = true\n\n    const bitLengthHigh = Math.floor(this.bytesProcessed / 0x20000000)\n    const bitLengthLow = (this.bytesProcessed << 3) >>> 0\n\n    this.block[this.blockLength] = 0x80\n    this.blockLength++\n\n    if (this.blockLength > 56) {\n      this.block.fill(0, this.blockLength, 64)\n      this.processBlock(this.block, 0)\n      this.blockLength = 0\n    }\n\n    this.block.fill(0, this.blockLength, 56)\n    this.writeUint32(56, bitLengthHigh)\n    this.writeUint32(60, bitLengthLow)\n    this.processBlock(this.block, 0)\n\n    return (\n      wordToHex(this.h0) +\n      wordToHex(this.h1) +\n      wordToHex(this.h2) +\n      wordToHex(this.h3) +\n      wordToHex(this.h4)\n    )\n  }\n\n  private writeUint32(offset: number, value: number): void {\n    this.block[offset] = (value >>> 24) & 0xff\n    this.block[offset + 1] = (value >>> 16) & 0xff\n    this.block[offset + 2] = (value >>> 8) & 0xff\n    this.block[offset + 3] = value & 0xff\n  }\n\n  private processBlock(block: Uint8Array, offset: number): void {\n    const words = this.words\n    for (let i = 0; i < 16; i++) {\n      const j = offset + i * 4\n      words[i] =\n        ((block[j] ?? 0) << 24) |\n        ((block[j + 1] ?? 0) << 16) |\n        ((block[j + 2] ?? 0) << 8) |\n        (block[j + 3] ?? 0)\n    }\n\n    for (let i = 16; i < 80; i++) {\n      words[i] = rotateLeft(\n        (words[i - 3] ?? 0) ^ (words[i - 8] ?? 0) ^ (words[i - 14] ?? 0) ^ (words[i - 16] ?? 0),\n        1,\n      )\n    }\n\n    let a = this.h0\n    let b = this.h1\n    let c = this.h2\n    let d = this.h3\n    let e = this.h4\n\n    for (let i = 0; i < 80; i++) {\n      let f: number\n      let k: number\n      if (i < 20) {\n        f = (b & c) | (~b & d)\n        k = 0x5a827999\n      } else if (i < 40) {\n        f = b ^ c ^ d\n        k = 0x6ed9eba1\n      } else if (i < 60) {\n        f = (b & c) | (b & d) | (c & d)\n        k = 0x8f1bbcdc\n      } else {\n        f = b ^ c ^ d\n        k = 0xca62c1d6\n      }\n\n      const temp = (rotateLeft(a, 5) + f + e + k + (words[i] ?? 0)) >>> 0\n      e = d\n      d = c\n      c = rotateLeft(b, 30)\n      b = a\n      a = temp\n    }\n\n    this.h0 = (this.h0 + a) >>> 0\n    this.h1 = (this.h1 + b) >>> 0\n    this.h2 = (this.h2 + c) >>> 0\n    this.h3 = (this.h3 + d) >>> 0\n    this.h4 = (this.h4 + e) >>> 0\n  }\n}\n\nfunction rotateLeft(value: number, bits: number): number {\n  return ((value << bits) | (value >>> (32 - bits))) >>> 0\n}\n\nfunction wordToHex(word: number): string {\n  return word.toString(16).padStart(8, '0')\n}\n/* v8 ignore stop */\n\n/**\n * Compute the SHA-1 hex digest of a complete byte array in one shot.\n * @param data - The byte array to hash.\n *\n * @returns The lowercase hex-encoded SHA-1 digest of the input.\n */\nexport async function sha1Hex(data: Uint8Array): Promise<string> {\n  const factory = await getNodeCreateHash()\n  if (factory) {\n    const h = factory('sha1')\n    h.update(data)\n    return h.digest('hex')\n  }\n  // Copy subarray and SharedArrayBuffer-backed views so WebCrypto hashes\n  // exactly `data`'s visible bytes with a plain ArrayBuffer.\n  /* v8 ignore start -- WebCrypto fallback, only reachable when node:crypto is unavailable */\n  const hashBuffer = await crypto.subtle.digest('SHA-1', arrayBufferFor(data))\n  return hexEncode(new Uint8Array(hashBuffer))\n  /* v8 ignore stop */\n}\n"],"mappings":"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"}
+{"version":3,"file":"hash.js","names":[],"sources":["../../src/streams/hash.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { hexEncode, sha256Hex as utilSha256Hex } from '../util/crypto.ts'\n\n/** Internal wrapper around a Node.js Hash instance. */\ntype NodeHasher = { update(data: Uint8Array): void; digest(encoding: string): string }\n\n/** Factory that creates a NodeHasher for a given algorithm name. */\ntype NodeHashFactory = (algorithm: string) => NodeHasher\n\n/** Shared interface for dependency-free streaming hash fallbacks. */\ntype JsHasher = { update(data: Uint8Array): void; digest(): string }\n\nlet nodeCreateHash: NodeHashFactory | null | undefined\n\n/**\n * Lazily loads `node:crypto` and caches the factory. Returns null in non-Node runtimes.\n *\n * @returns The cached hash factory, or null if Node crypto is unavailable.\n */\nasync function getNodeCreateHash(): Promise<NodeHashFactory | null> {\n  if (nodeCreateHash !== undefined) return nodeCreateHash\n  try {\n    // biome-ignore lint/suspicious/noTsIgnore: isomorphic import — @ts-ignore is silent when node:crypto resolves (Node) and suppresses the error when it doesn't (Deno/browser); @ts-expect-error can't do both\n    // @ts-ignore -- node:crypto may not exist in browser/edge runtimes\n    const crypto = await import('node:crypto')\n    // Vite's browser shim resolves the import but does not implement\n    // `createHash`. Probe explicitly so we fall through to the WebCrypto\n    // path instead of returning a broken factory.\n    if (typeof crypto.createHash !== 'function') throw new Error('createHash unavailable')\n    nodeCreateHash = (algo: string) => {\n      const h = crypto.createHash(algo)\n      return {\n        update(data: Uint8Array) {\n          h.update(data)\n        },\n        digest(encoding: string) {\n          return h.digest(encoding as 'hex') as string\n        },\n      }\n    }\n  } catch {\n    /* v8 ignore next -- non-Node runtime fallback, unreachable in Node coverage. */\n    nodeCreateHash = null\n  }\n  return nodeCreateHash\n}\n\nclass IncrementalHash {\n  /** Total bytes fed into the hash so far. */\n  private totalLength = 0\n  /** Node.js hash instance, or null if using the JavaScript fallback. */\n  private nodeHash: NodeHasher | null = null\n  /** Resolves once the crypto backend has been loaded. */\n  private initPromise: Promise<void>\n\n  constructor(\n    private readonly algorithm: 'sha1' | 'sha256',\n    private readonly jsHash: JsHasher,\n  ) {\n    this.initPromise = getNodeCreateHash().then((factory) => {\n      if (factory) this.nodeHash = factory(this.algorithm)\n    })\n  }\n\n  /**\n   * Feed data into the hash. Async because it lazily initializes the crypto backend.\n   * @param data - The bytes to include in the hash computation.\n   *\n   * @returns A promise that resolves once the data has been consumed.\n   */\n  async update(data: Uint8Array): Promise<void> {\n    await this.initPromise\n    if (this.nodeHash) {\n      this.nodeHash.update(data)\n    } else {\n      /* v8 ignore next -- WebCrypto fallback is exercised by browser-mode tests. */\n      this.jsHash.update(data)\n    }\n    this.totalLength += data.byteLength\n  }\n\n  /**\n   * Finalize the hash and return the hex-encoded digest.\n   * @returns The lowercase hex-encoded digest of all data fed so far.\n   */\n  async digest(): Promise<string> {\n    await this.initPromise\n    if (this.nodeHash) {\n      return this.nodeHash.digest('hex')\n    }\n\n    /* v8 ignore next -- non-Node runtime fallback, exercised by browser-mode tests */\n    return this.jsHash.digest()\n  }\n\n  /**\n   * Total number of bytes fed into the hash so far.\n   *\n   * @returns The cumulative byte count across all update calls.\n   */\n  get bytesProcessed(): number {\n    return this.totalLength\n  }\n}\n\n/**\n * Incrementally computes SHA-1 hashes over streaming data.\n * Uses Node.js `crypto` when available, falling back to a dependency-free\n * incremental JavaScript implementation.\n */\nexport class IncrementalSha1 extends IncrementalHash {\n  /** Creates a new IncrementalSha1 and lazily initializes the crypto backend. */\n  constructor() {\n    super('sha1', new JsSha1Hasher())\n  }\n}\n\n/**\n * Incrementally computes SHA-256 hashes over streaming data.\n * Uses Node.js `crypto` when available, falling back to a dependency-free\n * incremental JavaScript implementation.\n */\nexport class IncrementalSha256 extends IncrementalHash {\n  /** Creates a new IncrementalSha256 and lazily initializes the crypto backend. */\n  constructor() {\n    super('sha256', new JsSha256Hasher())\n  }\n}\n\n/* v8 ignore start -- JavaScript fallback path, exercised by browser-mode tests */\nclass JsSha1Hasher {\n  private h0 = 0x67452301\n  private h1 = 0xefcdab89\n  private h2 = 0x98badcfe\n  private h3 = 0x10325476\n  private h4 = 0xc3d2e1f0\n  private readonly block = new Uint8Array(64)\n  private blockLength = 0\n  private bytesProcessed = 0\n  private digested = false\n  private readonly words = new Uint32Array(80)\n\n  update(data: Uint8Array): void {\n    if (this.digested) throw new Error('SHA-1 digest has already been finalized')\n    this.bytesProcessed += data.byteLength\n\n    let offset = 0\n    if (this.blockLength > 0) {\n      const toCopy = Math.min(64 - this.blockLength, data.byteLength)\n      this.block.set(data.subarray(0, toCopy), this.blockLength)\n      this.blockLength += toCopy\n      offset = toCopy\n      if (this.blockLength === 64) {\n        this.processBlock(this.block, 0)\n        this.blockLength = 0\n      }\n    }\n\n    while (offset + 64 <= data.byteLength) {\n      this.processBlock(data, offset)\n      offset += 64\n    }\n\n    if (offset < data.byteLength) {\n      this.block.set(data.subarray(offset), 0)\n      this.blockLength = data.byteLength - offset\n    }\n  }\n\n  digest(): string {\n    if (this.digested) throw new Error('SHA-1 digest has already been finalized')\n    this.digested = true\n\n    const bitLengthHigh = Math.floor(this.bytesProcessed / 0x20000000)\n    const bitLengthLow = (this.bytesProcessed << 3) >>> 0\n\n    this.block[this.blockLength] = 0x80\n    this.blockLength++\n\n    if (this.blockLength > 56) {\n      this.block.fill(0, this.blockLength, 64)\n      this.processBlock(this.block, 0)\n      this.blockLength = 0\n    }\n\n    this.block.fill(0, this.blockLength, 56)\n    this.writeUint32(56, bitLengthHigh)\n    this.writeUint32(60, bitLengthLow)\n    this.processBlock(this.block, 0)\n\n    return (\n      wordToHex(this.h0) +\n      wordToHex(this.h1) +\n      wordToHex(this.h2) +\n      wordToHex(this.h3) +\n      wordToHex(this.h4)\n    )\n  }\n\n  private writeUint32(offset: number, value: number): void {\n    this.block[offset] = (value >>> 24) & 0xff\n    this.block[offset + 1] = (value >>> 16) & 0xff\n    this.block[offset + 2] = (value >>> 8) & 0xff\n    this.block[offset + 3] = value & 0xff\n  }\n\n  private processBlock(block: Uint8Array, offset: number): void {\n    const words = this.words\n    for (let i = 0; i < 16; i++) {\n      const j = offset + i * 4\n      words[i] =\n        ((block[j] ?? 0) << 24) |\n        ((block[j + 1] ?? 0) << 16) |\n        ((block[j + 2] ?? 0) << 8) |\n        (block[j + 3] ?? 0)\n    }\n\n    for (let i = 16; i < 80; i++) {\n      words[i] = rotateLeft(\n        (words[i - 3] ?? 0) ^ (words[i - 8] ?? 0) ^ (words[i - 14] ?? 0) ^ (words[i - 16] ?? 0),\n        1,\n      )\n    }\n\n    let a = this.h0\n    let b = this.h1\n    let c = this.h2\n    let d = this.h3\n    let e = this.h4\n\n    for (let i = 0; i < 80; i++) {\n      let f: number\n      let k: number\n      if (i < 20) {\n        f = (b & c) | (~b & d)\n        k = 0x5a827999\n      } else if (i < 40) {\n        f = b ^ c ^ d\n        k = 0x6ed9eba1\n      } else if (i < 60) {\n        f = (b & c) | (b & d) | (c & d)\n        k = 0x8f1bbcdc\n      } else {\n        f = b ^ c ^ d\n        k = 0xca62c1d6\n      }\n\n      const temp = (rotateLeft(a, 5) + f + e + k + (words[i] ?? 0)) >>> 0\n      e = d\n      d = c\n      c = rotateLeft(b, 30)\n      b = a\n      a = temp\n    }\n\n    this.h0 = (this.h0 + a) >>> 0\n    this.h1 = (this.h1 + b) >>> 0\n    this.h2 = (this.h2 + c) >>> 0\n    this.h3 = (this.h3 + d) >>> 0\n    this.h4 = (this.h4 + e) >>> 0\n  }\n}\n\nfunction rotateLeft(value: number, bits: number): number {\n  return ((value << bits) | (value >>> (32 - bits))) >>> 0\n}\n\nfunction wordToHex(word: number): string {\n  return word.toString(16).padStart(8, '0')\n}\n\nconst SHA256_INITIAL_STATE = [\n  0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,\n] as const\n\nconst SHA256_K = [\n  0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,\n  0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,\n  0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,\n  0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,\n  0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,\n  0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,\n  0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,\n  0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,\n] as const\n\nclass JsSha256Hasher {\n  private h0: number = SHA256_INITIAL_STATE[0]\n  private h1: number = SHA256_INITIAL_STATE[1]\n  private h2: number = SHA256_INITIAL_STATE[2]\n  private h3: number = SHA256_INITIAL_STATE[3]\n  private h4: number = SHA256_INITIAL_STATE[4]\n  private h5: number = SHA256_INITIAL_STATE[5]\n  private h6: number = SHA256_INITIAL_STATE[6]\n  private h7: number = SHA256_INITIAL_STATE[7]\n  private readonly block = new Uint8Array(64)\n  private blockLength = 0\n  private bytesProcessed = 0\n  private digested = false\n  private readonly words = new Uint32Array(64)\n\n  update(data: Uint8Array): void {\n    if (this.digested) throw new Error('SHA-256 digest has already been finalized')\n    this.bytesProcessed += data.byteLength\n\n    let offset = 0\n    if (this.blockLength > 0) {\n      const toCopy = Math.min(64 - this.blockLength, data.byteLength)\n      this.block.set(data.subarray(0, toCopy), this.blockLength)\n      this.blockLength += toCopy\n      offset = toCopy\n      if (this.blockLength === 64) {\n        this.processBlock(this.block, 0)\n        this.blockLength = 0\n      }\n    }\n\n    while (offset + 64 <= data.byteLength) {\n      this.processBlock(data, offset)\n      offset += 64\n    }\n\n    if (offset < data.byteLength) {\n      this.block.set(data.subarray(offset), 0)\n      this.blockLength = data.byteLength - offset\n    }\n  }\n\n  digest(): string {\n    if (this.digested) throw new Error('SHA-256 digest has already been finalized')\n    this.digested = true\n\n    const bitLengthHigh = Math.floor(this.bytesProcessed / 0x20000000)\n    const bitLengthLow = (this.bytesProcessed << 3) >>> 0\n\n    this.block[this.blockLength] = 0x80\n    this.blockLength++\n\n    if (this.blockLength > 56) {\n      this.block.fill(0, this.blockLength, 64)\n      this.processBlock(this.block, 0)\n      this.blockLength = 0\n    }\n\n    this.block.fill(0, this.blockLength, 56)\n    writeUint32(this.block, 56, bitLengthHigh)\n    writeUint32(this.block, 60, bitLengthLow)\n    this.processBlock(this.block, 0)\n\n    return [this.h0, this.h1, this.h2, this.h3, this.h4, this.h5, this.h6, this.h7]\n      .map(wordToHex)\n      .join('')\n  }\n\n  private processBlock(block: Uint8Array, offset: number): void {\n    const words = this.words\n    for (let i = 0; i < 16; i++) {\n      const j = offset + i * 4\n      words[i] =\n        ((block[j] ?? 0) << 24) |\n        ((block[j + 1] ?? 0) << 16) |\n        ((block[j + 2] ?? 0) << 8) |\n        (block[j + 3] ?? 0)\n    }\n\n    for (let i = 16; i < 64; i++) {\n      words[i] =\n        (smallSigma1(words[i - 2] ?? 0) +\n          (words[i - 7] ?? 0) +\n          smallSigma0(words[i - 15] ?? 0) +\n          (words[i - 16] ?? 0)) >>>\n        0\n    }\n\n    let a = this.h0\n    let b = this.h1\n    let c = this.h2\n    let d = this.h3\n    let e = this.h4\n    let f = this.h5\n    let g = this.h6\n    let h = this.h7\n\n    for (let i = 0; i < 64; i++) {\n      const t1 =\n        (h + bigSigma1(e) + sha256Choose(e, f, g) + (SHA256_K[i] ?? 0) + (words[i] ?? 0)) >>> 0\n      const t2 = (bigSigma0(a) + sha256Majority(a, b, c)) >>> 0\n      h = g\n      g = f\n      f = e\n      e = (d + t1) >>> 0\n      d = c\n      c = b\n      b = a\n      a = (t1 + t2) >>> 0\n    }\n\n    this.h0 = (this.h0 + a) >>> 0\n    this.h1 = (this.h1 + b) >>> 0\n    this.h2 = (this.h2 + c) >>> 0\n    this.h3 = (this.h3 + d) >>> 0\n    this.h4 = (this.h4 + e) >>> 0\n    this.h5 = (this.h5 + f) >>> 0\n    this.h6 = (this.h6 + g) >>> 0\n    this.h7 = (this.h7 + h) >>> 0\n  }\n}\n\nfunction writeUint32(block: Uint8Array, offset: number, value: number): void {\n  block[offset] = (value >>> 24) & 0xff\n  block[offset + 1] = (value >>> 16) & 0xff\n  block[offset + 2] = (value >>> 8) & 0xff\n  block[offset + 3] = value & 0xff\n}\n\nfunction rotateRight(value: number, bits: number): number {\n  return ((value >>> bits) | (value << (32 - bits))) >>> 0\n}\n\nfunction smallSigma0(value: number): number {\n  return rotateRight(value, 7) ^ rotateRight(value, 18) ^ (value >>> 3)\n}\n\nfunction smallSigma1(value: number): number {\n  return rotateRight(value, 17) ^ rotateRight(value, 19) ^ (value >>> 10)\n}\n\nfunction bigSigma0(value: number): number {\n  return rotateRight(value, 2) ^ rotateRight(value, 13) ^ rotateRight(value, 22)\n}\n\nfunction bigSigma1(value: number): number {\n  return rotateRight(value, 6) ^ rotateRight(value, 11) ^ rotateRight(value, 25)\n}\n\nfunction sha256Choose(x: number, y: number, z: number): number {\n  return (x & y) ^ (~x & z)\n}\n\nfunction sha256Majority(x: number, y: number, z: number): number {\n  return (x & y) ^ (x & z) ^ (y & z)\n}\n/* v8 ignore stop */\n\n/**\n * Compute the SHA-1 hex digest of a complete byte array in one shot.\n * @param data - The byte array to hash.\n *\n * @returns The lowercase hex-encoded SHA-1 digest of the input.\n */\nexport async function sha1Hex(data: Uint8Array): Promise<string> {\n  const factory = await getNodeCreateHash()\n  if (factory) {\n    const h = factory('sha1')\n    h.update(data)\n    return h.digest('hex')\n  }\n  // Copy subarray and SharedArrayBuffer-backed views so WebCrypto hashes\n  // exactly `data`'s visible bytes with a plain ArrayBuffer.\n  /* v8 ignore start -- WebCrypto fallback, only reachable when node:crypto is unavailable */\n  const hashBuffer = await crypto.subtle.digest('SHA-1', arrayBufferFor(data))\n  return hexEncode(new Uint8Array(hashBuffer))\n  /* v8 ignore stop */\n}\n\n/**\n * Compute the SHA-256 hex digest of a complete byte array in one shot.\n * @param data - The byte array to hash.\n *\n * @returns The lowercase hex-encoded SHA-256 digest of the input.\n */\nexport async function sha256Hex(data: Uint8Array): Promise<string> {\n  return utilSha256Hex(data)\n}\n"],"mappings":";;;AAYA,IAAI;;;;;;AAOJ,eAAe,oBAAqD;CAClE,IAAI,mBAAmB,KAAA,GAAW,OAAO;CACzC,IAAI;EAGF,MAAM,SAAS,MAAM,OAAO;EAI5B,IAAI,OAAO,OAAO,eAAe,YAAY,MAAM,IAAI,MAAM,wBAAwB;EACrF,kBAAkB,SAAiB;GACjC,MAAM,IAAI,OAAO,WAAW,IAAI;GAChC,OAAO;IACL,OAAO,MAAkB;KACvB,EAAE,OAAO,IAAI;IACf;IACA,OAAO,UAAkB;KACvB,OAAO,EAAE,OAAO,QAAiB;IACnC;GACF;EACF;CACF,QAAQ;;EAEN,iBAAiB;CACnB;CACA,OAAO;AACT;AAEA,IAAM,kBAAN,MAAsB;CASD;CACA;;CARnB,cAAsB;;CAEtB,WAAsC;;CAEtC;CAEA,YACE,WACA,QACA;EAFiB,KAAA,YAAA;EACA,KAAA,SAAA;EAEjB,KAAK,cAAc,kBAAkB,CAAC,CAAC,MAAM,YAAY;GACvD,IAAI,SAAS,KAAK,WAAW,QAAQ,KAAK,SAAS;EACrD,CAAC;CACH;;;;;;;CAQA,MAAM,OAAO,MAAiC;EAC5C,MAAM,KAAK;EACX,IAAI,KAAK,UACP,KAAK,SAAS,OAAO,IAAI;;;EAGzB,KAAK,OAAO,OAAO,IAAI;EAEzB,KAAK,eAAe,KAAK;CAC3B;;;;;CAMA,MAAM,SAA0B;EAC9B,MAAM,KAAK;EACX,IAAI,KAAK,UACP,OAAO,KAAK,SAAS,OAAO,KAAK;;EAInC,OAAO,KAAK,OAAO,OAAO;CAC5B;;;;;;CAOA,IAAI,iBAAyB;EAC3B,OAAO,KAAK;CACd;AACF;;;;;;AAOA,IAAa,kBAAb,cAAqC,gBAAgB;;CAEnD,cAAc;EACZ,MAAM,QAAQ,IAAI,aAAa,CAAC;CAClC;AACF;;;;;;AAOA,IAAa,oBAAb,cAAuC,gBAAgB;;CAErD,cAAc;EACZ,MAAM,UAAU,IAAI,eAAe,CAAC;CACtC;AACF;;AAGA,IAAM,eAAN,MAAmB;CACjB,KAAa;CACb,KAAa;CACb,KAAa;CACb,KAAa;CACb,KAAa;CACb,wBAAyB,IAAI,WAAW,EAAE;CAC1C,cAAsB;CACtB,iBAAyB;CACzB,WAAmB;CACnB,wBAAyB,IAAI,YAAY,EAAE;CAE3C,OAAO,MAAwB;EAC7B,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,yCAAyC;EAC5E,KAAK,kBAAkB,KAAK;EAE5B,IAAI,SAAS;EACb,IAAI,KAAK,cAAc,GAAG;GACxB,MAAM,SAAS,KAAK,IAAI,KAAK,KAAK,aAAa,KAAK,UAAU;GAC9D,KAAK,MAAM,IAAI,KAAK,SAAS,GAAG,MAAM,GAAG,KAAK,WAAW;GACzD,KAAK,eAAe;GACpB,SAAS;GACT,IAAI,KAAK,gBAAgB,IAAI;IAC3B,KAAK,aAAa,KAAK,OAAO,CAAC;IAC/B,KAAK,cAAc;GACrB;EACF;EAEA,OAAO,SAAS,MAAM,KAAK,YAAY;GACrC,KAAK,aAAa,MAAM,MAAM;GAC9B,UAAU;EACZ;EAEA,IAAI,SAAS,KAAK,YAAY;GAC5B,KAAK,MAAM,IAAI,KAAK,SAAS,MAAM,GAAG,CAAC;GACvC,KAAK,cAAc,KAAK,aAAa;EACvC;CACF;CAEA,SAAiB;EACf,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,yCAAyC;EAC5E,KAAK,WAAW;EAEhB,MAAM,gBAAgB,KAAK,MAAM,KAAK,iBAAiB,SAAU;EACjE,MAAM,eAAgB,KAAK,kBAAkB,MAAO;EAEpD,KAAK,MAAM,KAAK,eAAe;EAC/B,KAAK;EAEL,IAAI,KAAK,cAAc,IAAI;GACzB,KAAK,MAAM,KAAK,GAAG,KAAK,aAAa,EAAE;GACvC,KAAK,aAAa,KAAK,OAAO,CAAC;GAC/B,KAAK,cAAc;EACrB;EAEA,KAAK,MAAM,KAAK,GAAG,KAAK,aAAa,EAAE;EACvC,KAAK,YAAY,IAAI,aAAa;EAClC,KAAK,YAAY,IAAI,YAAY;EACjC,KAAK,aAAa,KAAK,OAAO,CAAC;EAE/B,OACE,UAAU,KAAK,EAAE,IACjB,UAAU,KAAK,EAAE,IACjB,UAAU,KAAK,EAAE,IACjB,UAAU,KAAK,EAAE,IACjB,UAAU,KAAK,EAAE;CAErB;CAEA,YAAoB,QAAgB,OAAqB;EACvD,KAAK,MAAM,UAAW,UAAU,KAAM;EACtC,KAAK,MAAM,SAAS,KAAM,UAAU,KAAM;EAC1C,KAAK,MAAM,SAAS,KAAM,UAAU,IAAK;EACzC,KAAK,MAAM,SAAS,KAAK,QAAQ;CACnC;CAEA,aAAqB,OAAmB,QAAsB;EAC5D,MAAM,QAAQ,KAAK;EACnB,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,IAAI,SAAS,IAAI;GACvB,MAAM,MACF,MAAM,MAAM,MAAM,MAClB,MAAM,IAAI,MAAM,MAAM,MACtB,MAAM,IAAI,MAAM,MAAM,KACvB,MAAM,IAAI,MAAM;EACrB;EAEA,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,KACvB,MAAM,KAAK,YACR,MAAM,IAAI,MAAM,MAAM,MAAM,IAAI,MAAM,MAAM,MAAM,IAAI,OAAO,MAAM,MAAM,IAAI,OAAO,IACrF,CACF;EAGF,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EAEb,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,IAAI;GACJ,IAAI;GACJ,IAAI,IAAI,IAAI;IACV,IAAK,IAAI,IAAM,CAAC,IAAI;IACpB,IAAI;GACN,OAAO,IAAI,IAAI,IAAI;IACjB,IAAI,IAAI,IAAI;IACZ,IAAI;GACN,OAAO,IAAI,IAAI,IAAI;IACjB,IAAK,IAAI,IAAM,IAAI,IAAM,IAAI;IAC7B,IAAI;GACN,OAAO;IACL,IAAI,IAAI,IAAI;IACZ,IAAI;GACN;GAEA,MAAM,OAAQ,WAAW,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK,MAAM,MAAM,OAAQ;GAClE,IAAI;GACJ,IAAI;GACJ,IAAI,WAAW,GAAG,EAAE;GACpB,IAAI;GACJ,IAAI;EACN;EAEA,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;CAC9B;AACF;AAEA,SAAS,WAAW,OAAe,MAAsB;CACvD,QAAS,SAAS,OAAS,UAAW,KAAK,UAAY;AACzD;AAEA,SAAS,UAAU,MAAsB;CACvC,OAAO,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG;AAC1C;AAEA,IAAM,uBAAuB;CAC3B;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;AACtF;AAEA,IAAM,WAAW;CACf;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CACpF;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;CAAY;AACtF;AAEA,IAAM,iBAAN,MAAqB;CACnB,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,KAAqB,qBAAqB;CAC1C,wBAAyB,IAAI,WAAW,EAAE;CAC1C,cAAsB;CACtB,iBAAyB;CACzB,WAAmB;CACnB,wBAAyB,IAAI,YAAY,EAAE;CAE3C,OAAO,MAAwB;EAC7B,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,2CAA2C;EAC9E,KAAK,kBAAkB,KAAK;EAE5B,IAAI,SAAS;EACb,IAAI,KAAK,cAAc,GAAG;GACxB,MAAM,SAAS,KAAK,IAAI,KAAK,KAAK,aAAa,KAAK,UAAU;GAC9D,KAAK,MAAM,IAAI,KAAK,SAAS,GAAG,MAAM,GAAG,KAAK,WAAW;GACzD,KAAK,eAAe;GACpB,SAAS;GACT,IAAI,KAAK,gBAAgB,IAAI;IAC3B,KAAK,aAAa,KAAK,OAAO,CAAC;IAC/B,KAAK,cAAc;GACrB;EACF;EAEA,OAAO,SAAS,MAAM,KAAK,YAAY;GACrC,KAAK,aAAa,MAAM,MAAM;GAC9B,UAAU;EACZ;EAEA,IAAI,SAAS,KAAK,YAAY;GAC5B,KAAK,MAAM,IAAI,KAAK,SAAS,MAAM,GAAG,CAAC;GACvC,KAAK,cAAc,KAAK,aAAa;EACvC;CACF;CAEA,SAAiB;EACf,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,2CAA2C;EAC9E,KAAK,WAAW;EAEhB,MAAM,gBAAgB,KAAK,MAAM,KAAK,iBAAiB,SAAU;EACjE,MAAM,eAAgB,KAAK,kBAAkB,MAAO;EAEpD,KAAK,MAAM,KAAK,eAAe;EAC/B,KAAK;EAEL,IAAI,KAAK,cAAc,IAAI;GACzB,KAAK,MAAM,KAAK,GAAG,KAAK,aAAa,EAAE;GACvC,KAAK,aAAa,KAAK,OAAO,CAAC;GAC/B,KAAK,cAAc;EACrB;EAEA,KAAK,MAAM,KAAK,GAAG,KAAK,aAAa,EAAE;EACvC,YAAY,KAAK,OAAO,IAAI,aAAa;EACzC,YAAY,KAAK,OAAO,IAAI,YAAY;EACxC,KAAK,aAAa,KAAK,OAAO,CAAC;EAE/B,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE,CAAC,CAC5E,IAAI,SAAS,CAAC,CACd,KAAK,EAAE;CACZ;CAEA,aAAqB,OAAmB,QAAsB;EAC5D,MAAM,QAAQ,KAAK;EACnB,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,IAAI,SAAS,IAAI;GACvB,MAAM,MACF,MAAM,MAAM,MAAM,MAClB,MAAM,IAAI,MAAM,MAAM,MACtB,MAAM,IAAI,MAAM,MAAM,KACvB,MAAM,IAAI,MAAM;EACrB;EAEA,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,KACvB,MAAM,KACH,YAAY,MAAM,IAAI,MAAM,CAAC,KAC3B,MAAM,IAAI,MAAM,KACjB,YAAY,MAAM,IAAI,OAAO,CAAC,KAC7B,MAAM,IAAI,OAAO,OACpB;EAGJ,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EACb,IAAI,IAAI,KAAK;EAEb,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,KACH,IAAI,UAAU,CAAC,IAAI,aAAa,GAAG,GAAG,CAAC,KAAK,SAAS,MAAM,MAAM,MAAM,MAAM,OAAQ;GACxF,MAAM,KAAM,UAAU,CAAC,IAAI,eAAe,GAAG,GAAG,CAAC,MAAO;GACxD,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAK,IAAI,OAAQ;GACjB,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAK,KAAK,OAAQ;EACpB;EAEA,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;EAC5B,KAAK,KAAM,KAAK,KAAK,MAAO;CAC9B;AACF;AAEA,SAAS,YAAY,OAAmB,QAAgB,OAAqB;CAC3E,MAAM,UAAW,UAAU,KAAM;CACjC,MAAM,SAAS,KAAM,UAAU,KAAM;CACrC,MAAM,SAAS,KAAM,UAAU,IAAK;CACpC,MAAM,SAAS,KAAK,QAAQ;AAC9B;AAEA,SAAS,YAAY,OAAe,MAAsB;CACxD,QAAS,UAAU,OAAS,SAAU,KAAK,UAAY;AACzD;AAEA,SAAS,YAAY,OAAuB;CAC1C,OAAO,YAAY,OAAO,CAAC,IAAI,YAAY,OAAO,EAAE,IAAK,UAAU;AACrE;AAEA,SAAS,YAAY,OAAuB;CAC1C,OAAO,YAAY,OAAO,EAAE,IAAI,YAAY,OAAO,EAAE,IAAK,UAAU;AACtE;AAEA,SAAS,UAAU,OAAuB;CACxC,OAAO,YAAY,OAAO,CAAC,IAAI,YAAY,OAAO,EAAE,IAAI,YAAY,OAAO,EAAE;AAC/E;AAEA,SAAS,UAAU,OAAuB;CACxC,OAAO,YAAY,OAAO,CAAC,IAAI,YAAY,OAAO,EAAE,IAAI,YAAY,OAAO,EAAE;AAC/E;AAEA,SAAS,aAAa,GAAW,GAAW,GAAmB;CAC7D,OAAQ,IAAI,IAAM,CAAC,IAAI;AACzB;AAEA,SAAS,eAAe,GAAW,GAAW,GAAmB;CAC/D,OAAQ,IAAI,IAAM,IAAI,IAAM,IAAI;AAClC;;;;;;;;AASA,eAAsB,QAAQ,MAAmC;CAC/D,MAAM,UAAU,MAAM,kBAAkB;CACxC,IAAI,SAAS;EACX,MAAM,IAAI,QAAQ,MAAM;EACxB,EAAE,OAAO,IAAI;EACb,OAAO,EAAE,OAAO,KAAK;CACvB;;CAIA,MAAM,aAAa,MAAM,OAAO,OAAO,OAAO,SAAS,eAAe,IAAI,CAAC;CAC3E,OAAO,UAAU,IAAI,WAAW,UAAU,CAAC;;AAE7C;;;;;;;AAQA,eAAsB,UAAU,MAAmC;CACjE,OAAO,YAAc,IAAI;AAC3B"}

package/dist/streams/index.cjs

@@ -1,13 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_encryption = require("../types/encryption.cjs");
 const require_hash = require("./hash.cjs");
 const require_file_source = require("./file-source.cjs");
 const require_source = require("./source.cjs");
-const require_encryption = require("../types/encryption.cjs");
 exports.BlobSource = require_source.BlobSource;
 exports.BufferSource = require_source.BufferSource;
 exports.EncryptionKey = require_encryption.EncryptionKey;
 exports.FileSource = require_file_source.FileSource;
 exports.IncrementalSha1 = require_hash.IncrementalSha1;
+exports.IncrementalSha256 = require_hash.IncrementalSha256;
 exports.StreamSource = require_source.StreamSource;
 exports.sha1Hex = require_hash.sha1Hex;
+exports.sha256Hex = require_hash.sha256Hex;
 exports.toContentSource = require_source.toContentSource;

package/dist/streams/index.d.cts

@@ -1,6 +1,6 @@
 /** @packageDocumentation */
 export { EncryptionKey } from '../types/encryption.js';
-export { IncrementalSha1, sha1Hex } from './hash.js';
+export { IncrementalSha1, IncrementalSha256, sha1Hex, sha256Hex } from './hash.js';
 export type { ProgressEvent, ProgressListener } from './progress.js';
 export type { ContentSource, FileSourcePath } from './source.js';
 export { BlobSource, BufferSource, FileSource, StreamSource, toContentSource, } from './source.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.js"],"names":[],"mappings":"AAAA,4BAA4B;AAO5B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACpD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.js"],"names":[],"mappings":"AAAA,4BAA4B;AAO5B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAClF,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAA"}

package/dist/streams/index.d.ts

@@ -1,6 +1,6 @@
 /** @packageDocumentation */
 export { EncryptionKey } from '../types/encryption.js';
-export { IncrementalSha1, sha1Hex } from './hash.js';
+export { IncrementalSha1, IncrementalSha256, sha1Hex, sha256Hex } from './hash.js';
 export type { ProgressEvent, ProgressListener } from './progress.js';
 export type { ContentSource, FileSourcePath } from './source.js';
 export { BlobSource, BufferSource, FileSource, StreamSource, toContentSource, } from './source.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.js"],"names":[],"mappings":"AAAA,4BAA4B;AAO5B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACpD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.js"],"names":[],"mappings":"AAAA,4BAA4B;AAO5B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAClF,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAA"}

package/dist/streams/index.js

@@ -1,5 +1,5 @@
-import { IncrementalSha1, sha1Hex } from "./hash.js";
+import { EncryptionKey } from "../types/encryption.js";
+import { IncrementalSha1, IncrementalSha256, sha1Hex, sha256Hex } from "./hash.js";
 import { FileSource } from "./file-source.js";
 import { BlobSource, BufferSource, StreamSource, toContentSource } from "./source.js";
-import { EncryptionKey } from "../types/encryption.js";
-export { BlobSource, BufferSource, EncryptionKey, FileSource, IncrementalSha1, StreamSource, sha1Hex, toContentSource };
+export { BlobSource, BufferSource, EncryptionKey, FileSource, IncrementalSha1, IncrementalSha256, StreamSource, sha1Hex, sha256Hex, toContentSource };

package/dist/streams/progress.cjs

@@ -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.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"progress.cjs","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.cjs","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/progress.d.cts

@@ -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.cts.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"}