@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/download/parallel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.cjs","sources":["../../src/download/parallel.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { DEFAULT_RETRY_OPTIONS, computeBackoff, sleep } from '../http/retry.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport { collectStream } from '../streams/collect.ts'\nimport type { FileId } from '../types/ids.ts'\nimport { DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\n\n/** Options for downloading a file using concurrent byte-range requests. */\nexport interface ParallelDownloadOptions {\n  /** ID of the file to download. */\n  readonly fileId: FileId\n  /** Total file size in bytes (must be known in advance). */\n  readonly totalSize: number\n  /** Size of each ranged chunk in bytes. Defaults to 10 MB. */\n  readonly rangeSize?: number\n  /** Maximum number of chunks fetched in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /** Maximum retry attempts per range on transient failures. Defaults to 5. */\n  readonly maxRetries?: number\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n}\n\n/**\n * Creates a readable stream that downloads a file using parallel byte-range requests.\n *\n * The file is split into fixed-size ranges fetched in a **sliding\n * window** keyed off the consumer's read pace. The window size is\n * `concurrency * 2`: up to `concurrency` ranges are in flight at once,\n * plus up to `concurrency` completed-but-not-yet-emitted ranges buffered\n * ahead of the read head. New fetches kick off only when the consumer\n * reads a chunk, so a slow downstream pipe (e.g. a saturated network\n * sink or a `pipeTo` consumer that drains slowly) backpressures into\n * the SDK and bounds peak memory to `(concurrency * 2) * rangeSize`.\n *\n * The previous eager implementation scheduled every range into\n * `Promise.all` up front; a slow head-of-line range could hold the\n * entire file in memory while later ranges finished and waited.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Parallel download parameters (file ID, size, concurrency).\n *\n * @returns A `ReadableStream` that yields file bytes in order.\n */\nexport function createParallelDownloadStream(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: ParallelDownloadOptions,\n): ReadableStream<Uint8Array> {\n  const rangeSize = options.rangeSize ?? 10 * 1024 * 1024\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n  const totalSize = options.totalSize\n  // `maxRetries` is part of `DEFAULT_RETRY_OPTIONS`; only override when\n  // the caller supplied an explicit value so the shared default stays\n  // the single source of truth.\n  const retryOptions = {\n    ...DEFAULT_RETRY_OPTIONS,\n    ...(options.maxRetries !== undefined ? { maxRetries: options.maxRetries } : {}),\n  }\n  const abort = options.signal\n\n  const ranges = planRanges(totalSize, rangeSize)\n\n  // `inflight` holds currently-fetching range promises; `buffer` holds\n  // completed ranges waiting for their slot in the emit order. Total\n  // scheduled-but-not-emitted = inflight.size + buffer.size is capped\n  // at `windowSize`, so peak memory is bounded regardless of any\n  // single range's latency.\n  const windowSize = concurrency * 2\n  const inflight = new Map<number, Promise<void>>()\n  const buffer = new Map<number, Uint8Array>()\n  let nextToSchedule = 0\n  let nextToEmit = 0\n  let firstError: unknown = null\n\n  function scheduleNext(): void {\n    while (\n      firstError === null &&\n      // Honour abort here so a completed range that triggers a top-up\n      // doesn't queue one final fetch after the caller aborted. Without\n      // this gate, one extra range request fires post-abort before the\n      // `pull()` loop notices.\n      abort?.aborted !== true &&\n      nextToSchedule < ranges.length &&\n      inflight.size + buffer.size < windowSize\n    ) {\n      const range = ranges[nextToSchedule]\n      if (range === undefined) break\n      const idx = nextToSchedule\n      nextToSchedule++\n      const task = (async () => {\n        try {\n          const data = await fetchRangeWithRetry(\n            raw,\n            accountInfo,\n            options.fileId,\n            range.start,\n            range.end,\n            retryOptions,\n            abort,\n          )\n          buffer.set(idx, data)\n        } catch (err) {\n          if (firstError === null) firstError = err\n        } finally {\n          inflight.delete(idx)\n        }\n      })()\n      inflight.set(idx, task)\n    }\n  }\n\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      // Pre-warm: kick off the initial window so the first `pull` has\n      // something to await. An already-aborted signal surfaces as a\n      // stream error rather than a synchronous throw, matching the\n      // contract callers had with the previous eager implementation.\n      try {\n        abort?.throwIfAborted()\n        scheduleNext()\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    async pull(controller) {\n      try {\n        // Wait until the next in-order chunk is available.\n        while (!buffer.has(nextToEmit)) {\n          abort?.throwIfAborted()\n          if (firstError !== null) throw firstError\n          /* v8 ignore start -- defensive close: every code path that\n             populates `nextToEmit < ranges.length` also schedules into\n             `inflight`. The pre-warm in `start()` plus `scheduleNext()`\n             after each enqueue guarantee that whenever there are\n             pending ranges, at least one is in flight. This guard\n             exists only so a future refactor can't accidentally stall\n             the stream by leaving both maps empty mid-stream. */\n          if (inflight.size === 0) {\n            controller.close()\n            return\n          }\n          /* v8 ignore stop */\n          await Promise.race(inflight.values())\n        }\n\n        const data = buffer.get(nextToEmit)\n        if (data !== undefined) {\n          buffer.delete(nextToEmit)\n          nextToEmit++\n          controller.enqueue(data)\n        }\n\n        // Top up the window now that we freed a slot by emitting.\n        scheduleNext()\n\n        if (\n          nextToEmit >= ranges.length &&\n          buffer.size === 0 &&\n          inflight.size === 0 &&\n          firstError === null\n        ) {\n          controller.close()\n        }\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    cancel() {\n      // Abort propagation handles in-flight requests; just drop buffered\n      // data so it can be GC'd promptly.\n      buffer.clear()\n    },\n  })\n}\n\n/**\n * Fetches a single byte range with bounded retry on transient failures.\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param fileId - ID of the file being downloaded.\n * @param start - Inclusive byte offset where the range begins.\n * @param end - Inclusive byte offset where the range ends.\n * @param retryOptions - Retry settings controlling attempts and backoff.\n * @param signal - Optional abort signal that cancels the range and any pending retry.\n *\n * @returns The range's bytes, or throws after exhausting all retry attempts.\n */\nasync function fetchRangeWithRetry(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  fileId: FileId,\n  start: number,\n  end: number,\n  retryOptions: typeof DEFAULT_RETRY_OPTIONS,\n  signal: AbortSignal | undefined,\n): Promise<Uint8Array> {\n  let lastError: unknown\n  for (let attempt = 0; attempt <= retryOptions.maxRetries; attempt++) {\n    if (attempt > 0) {\n      const delay = computeBackoff(attempt - 1, retryOptions)\n      await sleep(delay, signal)\n    }\n    try {\n      signal?.throwIfAborted()\n      const resp = await raw.downloadFileById(\n        accountInfo.getDownloadUrl(),\n        accountInfo.getAuthToken(),\n        fileId,\n        {\n          range: byteRangeHeader(start, end),\n          ...(signal !== undefined ? { signal } : {}),\n        },\n      )\n      if (!resp.body) throw new Error('Download chunk has no body')\n      return await collectStream(resp.body)\n    } catch (err) {\n      lastError = err\n      // Honour AbortSignal cancellation: don't retry past an abort.\n      if (signal?.aborted) throw err\n      if (err instanceof DOMException && err.name === 'AbortError') throw err\n    }\n  }\n  throw lastError instanceof Error ? lastError : new Error('Range download failed after retries')\n}\n"],"names":["DEFAULT_TRANSFER_CONCURRENCY","DEFAULT_RETRY_OPTIONS","planRanges","computeBackoff","sleep","byteRangeHeader","collectStream"],"mappings":"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"}
+{"version":3,"file":"parallel.cjs","names":[],"sources":["../../src/download/parallel.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { B2Error, classifyError, NetworkError } from '../errors/index.ts'\nimport { computeBackoff, DEFAULT_RETRY_OPTIONS, type RetryOptions, sleep } from '../http/retry.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport { collectStream } from '../streams/collect.ts'\nimport { IncrementalSha1 } from '../streams/hash.ts'\nimport type { B2ErrorResponse } from '../types/errors.ts'\nimport type { FileId } from '../types/ids.ts'\nimport { DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { normalizeSha1 } from '../util/normalize.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\nimport { normalizeVerifiableSha1 } from '../util/sha1.ts'\nimport { utf8Decoder } from '../util/text-codec.ts'\nimport { assertDownloadSha1, assertDownloadSha1HeaderAgreement } from './checksum.ts'\n\n/** Options for downloading a file using concurrent byte-range requests. */\nexport interface ParallelDownloadOptions {\n  /** ID of the file to download. */\n  readonly fileId: FileId\n  /** Total file size in bytes (must be known in advance). */\n  readonly totalSize: number\n  /** Size of each ranged chunk in bytes. Defaults to 10 MB. */\n  readonly rangeSize?: number\n  /** Maximum number of chunks fetched in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /**\n   * Extra retry attempts per range on transient failures. Defaults to 0 because\n   * `B2Client` already applies `RetryTransport`; set this only when supplying a\n   * raw client that does not already retry transport failures.\n   */\n  readonly maxRetries?: number\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n}\n\ninterface RangeDownloadResult {\n  readonly data: Uint8Array\n  readonly contentSha1: string | null\n}\n\n/**\n * Creates a readable stream that downloads a file using parallel byte-range requests.\n *\n * The file is split into fixed-size ranges fetched in a **sliding\n * window** keyed off the consumer's read pace. The window size is\n * `concurrency * 2`: up to `concurrency` ranges are in flight at once,\n * plus up to `concurrency` completed-but-not-yet-emitted ranges buffered\n * ahead of the read head. New fetches kick off only when the consumer\n * reads a chunk, so a slow downstream pipe (e.g. a saturated network\n * sink or a `pipeTo` consumer that drains slowly) backpressures into\n * the SDK and bounds peak memory to `(concurrency * 2) * rangeSize`.\n *\n * The previous eager implementation scheduled every range into\n * `Promise.all` up front; a slow head-of-line range could hold the\n * entire file in memory while later ranges finished and waited.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Parallel download parameters (file ID, size, concurrency).\n *\n * @returns A `ReadableStream` that yields file bytes in order.\n */\nexport function createParallelDownloadStream(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: ParallelDownloadOptions,\n): ReadableStream<Uint8Array> {\n  const rangeSize = options.rangeSize ?? 10 * 1024 * 1024\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n  const totalSize = options.totalSize\n  // The high-level B2Client already wraps the raw transport in RetryTransport.\n  // Keep the parallel-download outer retry disabled by default so each range\n  // has one retry budget unless callers explicitly opt into an extra raw-client\n  // retry layer.\n  const retryOptions = {\n    ...DEFAULT_RETRY_OPTIONS,\n    maxRetries: options.maxRetries ?? 0,\n  }\n  const abort = options.signal\n\n  const ranges = planRanges(totalSize, rangeSize)\n\n  // `inflight` holds currently-fetching range promises; `buffer` holds\n  // completed ranges waiting for their slot in the emit order. Total\n  // scheduled-but-not-emitted = inflight.size + buffer.size is capped\n  // at `windowSize`, so peak memory is bounded regardless of any\n  // single range's latency.\n  const windowSize = concurrency * 2\n  const inflight = new Map<number, Promise<void>>()\n  const buffer = new Map<number, RangeDownloadResult>()\n  let assembledSha1: IncrementalSha1 | null = null\n  let nextToSchedule = 0\n  let nextToEmit = 0\n  let expectedSha1: string | null | undefined\n  let firstError: unknown = null\n\n  function scheduleNext(): void {\n    while (\n      firstError === null &&\n      // Honour abort here so a completed range that triggers a top-up\n      // doesn't queue one final fetch after the caller aborted. Without\n      // this gate, one extra range request fires post-abort before the\n      // `pull()` loop notices.\n      abort?.aborted !== true &&\n      nextToSchedule < ranges.length &&\n      inflight.size + buffer.size < windowSize\n    ) {\n      const range = ranges[nextToSchedule]\n      if (range === undefined) break\n      const idx = nextToSchedule\n      nextToSchedule++\n      const task = (async () => {\n        try {\n          const result = await fetchRangeWithRetry(\n            raw,\n            accountInfo,\n            options.fileId,\n            range.start,\n            range.end,\n            totalSize,\n            retryOptions,\n            abort,\n          )\n          buffer.set(idx, result)\n        } catch (err) {\n          if (firstError === null) firstError = err\n        } finally {\n          inflight.delete(idx)\n        }\n      })()\n      inflight.set(idx, task)\n    }\n  }\n\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      // Pre-warm: kick off the initial window so the first `pull` has\n      // something to await. An already-aborted signal surfaces as a\n      // stream error rather than a synchronous throw, matching the\n      // contract callers had with the previous eager implementation.\n      try {\n        abort?.throwIfAborted()\n        scheduleNext()\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    async pull(controller) {\n      try {\n        // Wait until the next in-order chunk is available.\n        while (!buffer.has(nextToEmit)) {\n          abort?.throwIfAborted()\n          if (firstError !== null) throw firstError\n          // Zero-byte downloads have no planned ranges and close here. For\n          // non-empty downloads, this guard prevents a future refactor from\n          // stalling the stream if it leaves both maps empty mid-stream.\n          if (inflight.size === 0) {\n            controller.close()\n            return\n          }\n          await Promise.race(inflight.values())\n        }\n\n        const result = buffer.get(nextToEmit)\n        if (result !== undefined) {\n          buffer.delete(nextToEmit)\n          nextToEmit++\n          const rangeSha1 = normalizeVerifiableSha1(result.contentSha1)\n          if (expectedSha1 === undefined) {\n            expectedSha1 = rangeSha1\n          } else {\n            // B2 range responses should agree on the same whole-file SHA-1;\n            // any value or presence change makes verification untrustworthy.\n            assertDownloadSha1HeaderAgreement(expectedSha1, rangeSha1)\n          }\n          if (expectedSha1 !== null) {\n            assembledSha1 ??= new IncrementalSha1()\n            await assembledSha1.update(result.data)\n          }\n          controller.enqueue(result.data)\n        }\n\n        // Top up the window now that we freed a slot by emitting.\n        scheduleNext()\n\n        if (\n          nextToEmit >= ranges.length &&\n          buffer.size === 0 &&\n          inflight.size === 0 &&\n          firstError === null\n        ) {\n          if (expectedSha1 !== undefined && expectedSha1 !== null && assembledSha1 !== null) {\n            assertDownloadSha1(expectedSha1, await assembledSha1.digest())\n          }\n          controller.close()\n        }\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    cancel() {\n      // Abort propagation handles in-flight requests; just drop buffered\n      // data so it can be GC'd promptly.\n      buffer.clear()\n    },\n  })\n}\n\n/**\n * Fetches a single byte range with bounded retry on transient failures.\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param fileId - ID of the file being downloaded.\n * @param start - Inclusive byte offset where the range begins.\n * @param end - Inclusive byte offset where the range ends.\n * @param totalSize - Expected complete file size.\n * @param retryOptions - Retry settings controlling attempts and backoff.\n * @param signal - Optional abort signal that cancels the range and any pending retry.\n *\n * @returns The range's bytes, or throws after exhausting all retry attempts.\n */\nasync function fetchRangeWithRetry(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  fileId: FileId,\n  start: number,\n  end: number,\n  totalSize: number,\n  retryOptions: RetryOptions,\n  signal: AbortSignal | undefined,\n): Promise<RangeDownloadResult> {\n  let lastError: unknown\n  for (let attempt = 0; attempt <= retryOptions.maxRetries; attempt++) {\n    if (attempt > 0) {\n      const retryAfter =\n        lastError instanceof B2Error && lastError.retryAfter !== undefined\n          ? lastError.retryAfter\n          : undefined\n      const delay = computeBackoff(attempt - 1, retryOptions, retryAfter)\n      await sleep(delay, signal)\n    }\n    try {\n      signal?.throwIfAborted()\n      const resp = await raw.downloadFileById(\n        accountInfo.getDownloadUrl(),\n        accountInfo.getAuthToken(),\n        fileId,\n        {\n          range: byteRangeHeader(start, end),\n          ...(signal !== undefined ? { signal } : {}),\n        },\n      )\n      if (resp.status < 200 || resp.status >= 300) {\n        throw await classifyDownloadResponseError(resp)\n      }\n      if (!resp.body) throw new Error('Download chunk has no body')\n      const data = await collectStream(resp.body)\n      validateRangeResponse(resp, start, end, totalSize, data.byteLength)\n      return {\n        data,\n        contentSha1: normalizeSha1(resp.headers.get('X-Bz-Content-Sha1')),\n      }\n    } catch (err) {\n      lastError = err\n      // Honour AbortSignal cancellation: don't retry past an abort.\n      if (signal?.aborted) throw err\n      if (err instanceof DOMException && err.name === 'AbortError') throw err\n      if (!isRetryableRangeError(err) || attempt === retryOptions.maxRetries) {\n        throw err\n      }\n    }\n  }\n  throw lastError instanceof Error ? lastError : new Error('Range download failed after retries')\n}\n\nclass RangeValidationError extends Error {\n  readonly retryable = false\n\n  constructor(message: string) {\n    super(message)\n    this.name = 'RangeValidationError'\n  }\n}\n\nfunction validateRangeResponse(\n  response: { headers: Headers; status: number },\n  start: number,\n  end: number,\n  totalSize: number,\n  byteLength: number,\n): void {\n  const expectedLength = end - start + 1\n  if (response.status !== 206) {\n    throw new RangeValidationError(\n      `Expected HTTP 206 Partial Content for range ${start}-${end}, got ${response.status}`,\n    )\n  }\n\n  const contentRange = response.headers.get('Content-Range')\n  if (contentRange === null) {\n    throw new RangeValidationError(`Missing Content-Range for range ${start}-${end}`)\n  }\n\n  const match = contentRange.match(/^bytes (\\d+)-(\\d+)\\/(\\d+|\\*)$/)\n  if (match === null) {\n    throw new RangeValidationError(\n      `Invalid Content-Range for range ${start}-${end}: ${contentRange}`,\n    )\n  }\n\n  const actualStart = Number.parseInt(match[1] ?? '', 10)\n  const actualEnd = Number.parseInt(match[2] ?? '', 10)\n  const actualTotal = match[3] ?? ''\n  if (actualStart !== start || actualEnd !== end) {\n    throw new RangeValidationError(\n      `Content-Range ${contentRange} does not match requested range ${start}-${end}`,\n    )\n  }\n\n  if (actualTotal === '*') {\n    throw new RangeValidationError(`Content-Range ${contentRange} does not include total size`)\n  }\n\n  const parsedTotal = Number.parseInt(actualTotal, 10)\n  if (parsedTotal !== totalSize) {\n    throw new RangeValidationError(\n      `Content-Range ${contentRange} does not match expected total size ${totalSize}`,\n    )\n  }\n\n  if (byteLength !== expectedLength) {\n    throw new RangeValidationError(\n      `Expected ${expectedLength} bytes for range ${start}-${end}, got ${byteLength}`,\n    )\n  }\n}\n\nasync function classifyDownloadResponseError(response: {\n  headers: Headers\n  status: number\n  body: ReadableStream<Uint8Array> | null\n}): Promise<B2Error> {\n  let errorBody: B2ErrorResponse = {\n    status: response.status,\n    code: 'internal_error',\n    message: `HTTP ${response.status}`,\n  }\n\n  if (response.body !== null) {\n    const bytes = await collectStream(response.body)\n    try {\n      const parsed = JSON.parse(utf8Decoder.decode(bytes)) as Partial<B2ErrorResponse>\n      errorBody = {\n        status: response.status,\n        code: parsed.code ?? 'internal_error',\n        message: parsed.message ?? `HTTP ${response.status}`,\n      }\n    } catch {\n      // Keep the synthetic errorBody above when the response body is not JSON.\n    }\n  }\n\n  const retryAfterHeader = response.headers.get('Retry-After')\n  const retryAfter = retryAfterHeader !== null ? Number.parseInt(retryAfterHeader, 10) : undefined\n  const requestId = response.headers.get('X-Bz-Request-Id') ?? undefined\n\n  return classifyError(errorBody, {\n    ...(retryAfter !== undefined ? { retryAfter } : {}),\n    ...(requestId !== undefined ? { requestId } : {}),\n  })\n}\n\nfunction isRetryableRangeError(err: unknown): boolean {\n  if (err instanceof B2Error || err instanceof NetworkError) return err.retryable\n  if (hasRetryableFlag(err)) return err.retryable\n  // Bare FetchTransport surfaces network failures as TypeError. Validation\n  // failures use RangeValidationError above, so they never land here.\n  return err instanceof TypeError\n}\n\nfunction hasRetryableFlag(err: unknown): err is { retryable: boolean } {\n  return (\n    typeof err === 'object' &&\n    err !== null &&\n    'retryable' in err &&\n    typeof (err as { retryable?: unknown }).retryable === 'boolean'\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,6BACd,KACA,aACA,SAC4B;CAC5B,MAAM,YAAY,QAAQ,aAAa,KAAK,OAAO;CACnD,MAAM,cAAc,QAAQ,eAAA;CAC5B,MAAM,YAAY,QAAQ;CAK1B,MAAM,eAAe;EACnB,GAAG,cAAA;EACH,YAAY,QAAQ,cAAc;CACpC;CACA,MAAM,QAAQ,QAAQ;CAEtB,MAAM,SAAS,oBAAA,WAAW,WAAW,SAAS;CAO9C,MAAM,aAAa,cAAc;CACjC,MAAM,2BAAW,IAAI,IAA2B;CAChD,MAAM,yBAAS,IAAI,IAAiC;CACpD,IAAI,gBAAwC;CAC5C,IAAI,iBAAiB;CACrB,IAAI,aAAa;CACjB,IAAI;CACJ,IAAI,aAAsB;CAE1B,SAAS,eAAqB;EAC5B,OACE,eAAe,QAKf,OAAO,YAAY,QACnB,iBAAiB,OAAO,UACxB,SAAS,OAAO,OAAO,OAAO,YAC9B;GACA,MAAM,QAAQ,OAAO;GACrB,IAAI,UAAU,KAAA,GAAW;GACzB,MAAM,MAAM;GACZ;GACA,MAAM,QAAQ,YAAY;IACxB,IAAI;KACF,MAAM,SAAS,MAAM,oBACnB,KACA,aACA,QAAQ,QACR,MAAM,OACN,MAAM,KACN,WACA,cACA,KACF;KACA,OAAO,IAAI,KAAK,MAAM;IACxB,SAAS,KAAK;KACZ,IAAI,eAAe,MAAM,aAAa;IACxC,UAAU;KACR,SAAS,OAAO,GAAG;IACrB;GACF,EAAA,CAAG;GACH,SAAS,IAAI,KAAK,IAAI;EACxB;CACF;CAEA,OAAO,IAAI,eAA2B;EACpC,MAAM,YAAY;GAKhB,IAAI;IACF,OAAO,eAAe;IACtB,aAAa;GACf,SAAS,KAAK;IACZ,WAAW,MAAM,GAAG;GACtB;EACF;EACA,MAAM,KAAK,YAAY;GACrB,IAAI;IAEF,OAAO,CAAC,OAAO,IAAI,UAAU,GAAG;KAC9B,OAAO,eAAe;KACtB,IAAI,eAAe,MAAM,MAAM;KAI/B,IAAI,SAAS,SAAS,GAAG;MACvB,WAAW,MAAM;MACjB;KACF;KACA,MAAM,QAAQ,KAAK,SAAS,OAAO,CAAC;IACtC;IAEA,MAAM,SAAS,OAAO,IAAI,UAAU;IACpC,IAAI,WAAW,KAAA,GAAW;KACxB,OAAO,OAAO,UAAU;KACxB;KACA,MAAM,YAAY,aAAA,wBAAwB,OAAO,WAAW;KAC5D,IAAI,iBAAiB,KAAA,GACnB,eAAe;UAIf,iBAAA,kCAAkC,cAAc,SAAS;KAE3D,IAAI,iBAAiB,MAAM;MACzB,kBAAkB,IAAI,aAAA,gBAAgB;MACtC,MAAM,cAAc,OAAO,OAAO,IAAI;KACxC;KACA,WAAW,QAAQ,OAAO,IAAI;IAChC;IAGA,aAAa;IAEb,IACE,cAAc,OAAO,UACrB,OAAO,SAAS,KAChB,SAAS,SAAS,KAClB,eAAe,MACf;KACA,IAAI,iBAAiB,KAAA,KAAa,iBAAiB,QAAQ,kBAAkB,MAC3E,iBAAA,mBAAmB,cAAc,MAAM,cAAc,OAAO,CAAC;KAE/D,WAAW,MAAM;IACnB;GACF,SAAS,KAAK;IACZ,WAAW,MAAM,GAAG;GACtB;EACF;EACA,SAAS;GAGP,OAAO,MAAM;EACf;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,eAAe,oBACb,KACA,aACA,QACA,OACA,KACA,WACA,cACA,QAC8B;CAC9B,IAAI;CACJ,KAAK,IAAI,UAAU,GAAG,WAAW,aAAa,YAAY,WAAW;EACnE,IAAI,UAAU,GAAG;GACf,MAAM,aACJ,qBAAqB,qBAAA,WAAW,UAAU,eAAe,KAAA,IACrD,UAAU,aACV,KAAA;GAEN,MAAM,cAAA,MADQ,cAAA,eAAe,UAAU,GAAG,cAAc,UAC5C,GAAO,MAAM;EAC3B;EACA,IAAI;GACF,QAAQ,eAAe;GACvB,MAAM,OAAO,MAAM,IAAI,iBACrB,YAAY,eAAe,GAC3B,YAAY,aAAa,GACzB,QACA;IACE,OAAO,oBAAA,gBAAgB,OAAO,GAAG;IACjC,GAAI,WAAW,KAAA,IAAY,EAAE,OAAO,IAAI,CAAC;GAC3C,CACF;GACA,IAAI,KAAK,SAAS,OAAO,KAAK,UAAU,KACtC,MAAM,MAAM,8BAA8B,IAAI;GAEhD,IAAI,CAAC,KAAK,MAAM,MAAM,IAAI,MAAM,4BAA4B;GAC5D,MAAM,OAAO,MAAM,gBAAA,cAAc,KAAK,IAAI;GAC1C,sBAAsB,MAAM,OAAO,KAAK,WAAW,KAAK,UAAU;GAClE,OAAO;IACL;IACA,aAAa,kBAAA,cAAc,KAAK,QAAQ,IAAI,mBAAmB,CAAC;GAClE;EACF,SAAS,KAAK;GACZ,YAAY;GAEZ,IAAI,QAAQ,SAAS,MAAM;GAC3B,IAAI,eAAe,gBAAgB,IAAI,SAAS,cAAc,MAAM;GACpE,IAAI,CAAC,sBAAsB,GAAG,KAAK,YAAY,aAAa,YAC1D,MAAM;EAEV;CACF;CACA,MAAM,qBAAqB,QAAQ,4BAAY,IAAI,MAAM,qCAAqC;AAChG;AAEA,IAAM,uBAAN,cAAmC,MAAM;CACvC,YAAqB;CAErB,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,SAAS,sBACP,UACA,OACA,KACA,WACA,YACM;CACN,MAAM,iBAAiB,MAAM,QAAQ;CACrC,IAAI,SAAS,WAAW,KACtB,MAAM,IAAI,qBACR,+CAA+C,MAAM,GAAG,IAAI,QAAQ,SAAS,QAC/E;CAGF,MAAM,eAAe,SAAS,QAAQ,IAAI,eAAe;CACzD,IAAI,iBAAiB,MACnB,MAAM,IAAI,qBAAqB,mCAAmC,MAAM,GAAG,KAAK;CAGlF,MAAM,QAAQ,aAAa,MAAM,+BAA+B;CAChE,IAAI,UAAU,MACZ,MAAM,IAAI,qBACR,mCAAmC,MAAM,GAAG,IAAI,IAAI,cACtD;CAGF,MAAM,cAAc,OAAO,SAAS,MAAM,MAAM,IAAI,EAAE;CACtD,MAAM,YAAY,OAAO,SAAS,MAAM,MAAM,IAAI,EAAE;CACpD,MAAM,cAAc,MAAM,MAAM;CAChC,IAAI,gBAAgB,SAAS,cAAc,KACzC,MAAM,IAAI,qBACR,iBAAiB,aAAa,kCAAkC,MAAM,GAAG,KAC3E;CAGF,IAAI,gBAAgB,KAClB,MAAM,IAAI,qBAAqB,iBAAiB,aAAa,6BAA6B;CAI5F,IADoB,OAAO,SAAS,aAAa,EAC7C,MAAgB,WAClB,MAAM,IAAI,qBACR,iBAAiB,aAAa,sCAAsC,WACtE;CAGF,IAAI,eAAe,gBACjB,MAAM,IAAI,qBACR,YAAY,eAAe,mBAAmB,MAAM,GAAG,IAAI,QAAQ,YACrE;AAEJ;AAEA,eAAe,8BAA8B,UAIxB;CACnB,IAAI,YAA6B;EAC/B,QAAQ,SAAS;EACjB,MAAM;EACN,SAAS,QAAQ,SAAS;CAC5B;CAEA,IAAI,SAAS,SAAS,MAAM;EAC1B,MAAM,QAAQ,MAAM,gBAAA,cAAc,SAAS,IAAI;EAC/C,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,mBAAA,YAAY,OAAO,KAAK,CAAC;GACnD,YAAY;IACV,QAAQ,SAAS;IACjB,MAAM,OAAO,QAAQ;IACrB,SAAS,OAAO,WAAW,QAAQ,SAAS;GAC9C;EACF,QAAQ,CAER;CACF;CAEA,MAAM,mBAAmB,SAAS,QAAQ,IAAI,aAAa;CAC3D,MAAM,aAAa,qBAAqB,OAAO,OAAO,SAAS,kBAAkB,EAAE,IAAI,KAAA;CACvF,MAAM,YAAY,SAAS,QAAQ,IAAI,iBAAiB,KAAK,KAAA;CAE7D,OAAO,qBAAA,cAAc,WAAW;EAC9B,GAAI,eAAe,KAAA,IAAY,EAAE,WAAW,IAAI,CAAC;EACjD,GAAI,cAAc,KAAA,IAAY,EAAE,UAAU,IAAI,CAAC;CACjD,CAAC;AACH;AAEA,SAAS,sBAAsB,KAAuB;CACpD,IAAI,eAAe,qBAAA,WAAW,eAAe,qBAAA,cAAc,OAAO,IAAI;CACtE,IAAI,iBAAiB,GAAG,GAAG,OAAO,IAAI;CAGtC,OAAO,eAAe;AACxB;AAEA,SAAS,iBAAiB,KAA6C;CACrE,OACE,OAAO,QAAQ,YACf,QAAQ,QACR,eAAe,OACf,OAAQ,IAAgC,cAAc;AAE1D"}

package/dist/download/parallel.d.cts

@@ -11,7 +11,11 @@ export interface ParallelDownloadOptions {
     readonly rangeSize?: number;
     /** Maximum number of chunks fetched in parallel. Defaults to 4. */
     readonly concurrency?: number;
-    /** Maximum retry attempts per range on transient failures. Defaults to 5. */
+    /**
+     * Extra retry attempts per range on transient failures. Defaults to 0 because
+     * `B2Client` already applies `RetryTransport`; set this only when supplying a
+     * raw client that does not already retry transport failures.
+     */
     readonly maxRetries?: number;
     /** Signal to abort the download. */
     readonly signal?: AbortSignal;

package/dist/download/parallel.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/download/parallel.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAI7C,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAAC,UAAU,CAAC,CA8H5B"}
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/download/parallel.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAIhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAQ7C,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAOD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAAC,UAAU,CAAC,CA4I5B"}

package/dist/download/parallel.d.ts

@@ -11,7 +11,11 @@ export interface ParallelDownloadOptions {
     readonly rangeSize?: number;
     /** Maximum number of chunks fetched in parallel. Defaults to 4. */
     readonly concurrency?: number;
-    /** Maximum retry attempts per range on transient failures. Defaults to 5. */
+    /**
+     * Extra retry attempts per range on transient failures. Defaults to 0 because
+     * `B2Client` already applies `RetryTransport`; set this only when supplying a
+     * raw client that does not already retry transport failures.
+     */
     readonly maxRetries?: number;
     /** Signal to abort the download. */
     readonly signal?: AbortSignal;

package/dist/download/parallel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/download/parallel.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAI7C,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAAC,UAAU,CAAC,CA8H5B"}
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/download/parallel.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAIhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAQ7C,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAOD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAAC,UAAU,CAAC,CA4I5B"}

package/dist/download/parallel.js

@@ -1,122 +1,218 @@
+import { B2Error, NetworkError, classifyError } from "../errors/index.js";
+import { byteRangeHeader, planRanges } from "../util/plan-ranges.js";
+import { utf8Decoder } from "../util/text-codec.js";
+import { normalizeSha1 } from "../util/normalize.js";
+import { IncrementalSha1 } from "../streams/hash.js";
+import { normalizeVerifiableSha1 } from "../util/sha1.js";
+import { assertDownloadSha1, assertDownloadSha1HeaderAgreement } from "./checksum.js";
 import { DEFAULT_RETRY_OPTIONS, computeBackoff, sleep } from "../http/retry.js";
 import { collectStream } from "../streams/collect.js";
-import { DEFAULT_TRANSFER_CONCURRENCY } from "../util/defaults.js";
-import { planRanges, byteRangeHeader } from "../util/plan-ranges.js";
+//#region src/download/parallel.ts
+/**
+* Creates a readable stream that downloads a file using parallel byte-range requests.
+*
+* The file is split into fixed-size ranges fetched in a **sliding
+* window** keyed off the consumer's read pace. The window size is
+* `concurrency * 2`: up to `concurrency` ranges are in flight at once,
+* plus up to `concurrency` completed-but-not-yet-emitted ranges buffered
+* ahead of the read head. New fetches kick off only when the consumer
+* reads a chunk, so a slow downstream pipe (e.g. a saturated network
+* sink or a `pipeTo` consumer that drains slowly) backpressures into
+* the SDK and bounds peak memory to `(concurrency * 2) * rangeSize`.
+*
+* The previous eager implementation scheduled every range into
+* `Promise.all` up front; a slow head-of-line range could hold the
+* entire file in memory while later ranges finished and waited.
+*
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state.
+* @param options - Parallel download parameters (file ID, size, concurrency).
+*
+* @returns A `ReadableStream` that yields file bytes in order.
+*/
 function createParallelDownloadStream(raw, accountInfo, options) {
-  const rangeSize = options.rangeSize ?? 10 * 1024 * 1024;
-  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY;
-  const totalSize = options.totalSize;
-  const retryOptions = {
-    ...DEFAULT_RETRY_OPTIONS,
-    ...options.maxRetries !== void 0 ? { maxRetries: options.maxRetries } : {}
-  };
-  const abort = options.signal;
-  const ranges = planRanges(totalSize, rangeSize);
-  const windowSize = concurrency * 2;
-  const inflight = /* @__PURE__ */ new Map();
-  const buffer = /* @__PURE__ */ new Map();
-  let nextToSchedule = 0;
-  let nextToEmit = 0;
-  let firstError = null;
-  function scheduleNext() {
-    while (firstError === null && // Honour abort here so a completed range that triggers a top-up
-    // doesn't queue one final fetch after the caller aborted. Without
-    // this gate, one extra range request fires post-abort before the
-    // `pull()` loop notices.
-    abort?.aborted !== true && nextToSchedule < ranges.length && inflight.size + buffer.size < windowSize) {
-      const range = ranges[nextToSchedule];
-      if (range === void 0) break;
-      const idx = nextToSchedule;
-      nextToSchedule++;
-      const task = (async () => {
-        try {
-          const data = await fetchRangeWithRetry(
-            raw,
-            accountInfo,
-            options.fileId,
-            range.start,
-            range.end,
-            retryOptions,
-            abort
-          );
-          buffer.set(idx, data);
-        } catch (err) {
-          if (firstError === null) firstError = err;
-        } finally {
-          inflight.delete(idx);
-        }
-      })();
-      inflight.set(idx, task);
-    }
-  }
-  return new ReadableStream({
-    start(controller) {
-      try {
-        abort?.throwIfAborted();
-        scheduleNext();
-      } catch (err) {
-        controller.error(err);
-      }
-    },
-    async pull(controller) {
-      try {
-        while (!buffer.has(nextToEmit)) {
-          abort?.throwIfAborted();
-          if (firstError !== null) throw firstError;
-          if (inflight.size === 0) {
-            controller.close();
-            return;
-          }
-          await Promise.race(inflight.values());
-        }
-        const data = buffer.get(nextToEmit);
-        if (data !== void 0) {
-          buffer.delete(nextToEmit);
-          nextToEmit++;
-          controller.enqueue(data);
-        }
-        scheduleNext();
-        if (nextToEmit >= ranges.length && buffer.size === 0 && inflight.size === 0 && firstError === null) {
-          controller.close();
-        }
-      } catch (err) {
-        controller.error(err);
-      }
-    },
-    cancel() {
-      buffer.clear();
-    }
-  });
+	const rangeSize = options.rangeSize ?? 10 * 1024 * 1024;
+	const concurrency = options.concurrency ?? 4;
+	const totalSize = options.totalSize;
+	const retryOptions = {
+		...DEFAULT_RETRY_OPTIONS,
+		maxRetries: options.maxRetries ?? 0
+	};
+	const abort = options.signal;
+	const ranges = planRanges(totalSize, rangeSize);
+	const windowSize = concurrency * 2;
+	const inflight = /* @__PURE__ */ new Map();
+	const buffer = /* @__PURE__ */ new Map();
+	let assembledSha1 = null;
+	let nextToSchedule = 0;
+	let nextToEmit = 0;
+	let expectedSha1;
+	let firstError = null;
+	function scheduleNext() {
+		while (firstError === null && abort?.aborted !== true && nextToSchedule < ranges.length && inflight.size + buffer.size < windowSize) {
+			const range = ranges[nextToSchedule];
+			if (range === void 0) break;
+			const idx = nextToSchedule;
+			nextToSchedule++;
+			const task = (async () => {
+				try {
+					const result = await fetchRangeWithRetry(raw, accountInfo, options.fileId, range.start, range.end, totalSize, retryOptions, abort);
+					buffer.set(idx, result);
+				} catch (err) {
+					if (firstError === null) firstError = err;
+				} finally {
+					inflight.delete(idx);
+				}
+			})();
+			inflight.set(idx, task);
+		}
+	}
+	return new ReadableStream({
+		start(controller) {
+			try {
+				abort?.throwIfAborted();
+				scheduleNext();
+			} catch (err) {
+				controller.error(err);
+			}
+		},
+		async pull(controller) {
+			try {
+				while (!buffer.has(nextToEmit)) {
+					abort?.throwIfAborted();
+					if (firstError !== null) throw firstError;
+					if (inflight.size === 0) {
+						controller.close();
+						return;
+					}
+					await Promise.race(inflight.values());
+				}
+				const result = buffer.get(nextToEmit);
+				if (result !== void 0) {
+					buffer.delete(nextToEmit);
+					nextToEmit++;
+					const rangeSha1 = normalizeVerifiableSha1(result.contentSha1);
+					if (expectedSha1 === void 0) expectedSha1 = rangeSha1;
+					else assertDownloadSha1HeaderAgreement(expectedSha1, rangeSha1);
+					if (expectedSha1 !== null) {
+						assembledSha1 ??= new IncrementalSha1();
+						await assembledSha1.update(result.data);
+					}
+					controller.enqueue(result.data);
+				}
+				scheduleNext();
+				if (nextToEmit >= ranges.length && buffer.size === 0 && inflight.size === 0 && firstError === null) {
+					if (expectedSha1 !== void 0 && expectedSha1 !== null && assembledSha1 !== null) assertDownloadSha1(expectedSha1, await assembledSha1.digest());
+					controller.close();
+				}
+			} catch (err) {
+				controller.error(err);
+			}
+		},
+		cancel() {
+			buffer.clear();
+		}
+	});
 }
-async function fetchRangeWithRetry(raw, accountInfo, fileId, start, end, retryOptions, signal) {
-  let lastError;
-  for (let attempt = 0; attempt <= retryOptions.maxRetries; attempt++) {
-    if (attempt > 0) {
-      const delay = computeBackoff(attempt - 1, retryOptions);
-      await sleep(delay, signal);
-    }
-    try {
-      signal?.throwIfAborted();
-      const resp = await raw.downloadFileById(
-        accountInfo.getDownloadUrl(),
-        accountInfo.getAuthToken(),
-        fileId,
-        {
-          range: byteRangeHeader(start, end),
-          ...signal !== void 0 ? { signal } : {}
-        }
-      );
-      if (!resp.body) throw new Error("Download chunk has no body");
-      return await collectStream(resp.body);
-    } catch (err) {
-      lastError = err;
-      if (signal?.aborted) throw err;
-      if (err instanceof DOMException && err.name === "AbortError") throw err;
-    }
-  }
-  throw lastError instanceof Error ? lastError : new Error("Range download failed after retries");
+/**
+* Fetches a single byte range with bounded retry on transient failures.
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state.
+* @param fileId - ID of the file being downloaded.
+* @param start - Inclusive byte offset where the range begins.
+* @param end - Inclusive byte offset where the range ends.
+* @param totalSize - Expected complete file size.
+* @param retryOptions - Retry settings controlling attempts and backoff.
+* @param signal - Optional abort signal that cancels the range and any pending retry.
+*
+* @returns The range's bytes, or throws after exhausting all retry attempts.
+*/
+async function fetchRangeWithRetry(raw, accountInfo, fileId, start, end, totalSize, retryOptions, signal) {
+	let lastError;
+	for (let attempt = 0; attempt <= retryOptions.maxRetries; attempt++) {
+		if (attempt > 0) {
+			const retryAfter = lastError instanceof B2Error && lastError.retryAfter !== void 0 ? lastError.retryAfter : void 0;
+			await sleep(computeBackoff(attempt - 1, retryOptions, retryAfter), signal);
+		}
+		try {
+			signal?.throwIfAborted();
+			const resp = await raw.downloadFileById(accountInfo.getDownloadUrl(), accountInfo.getAuthToken(), fileId, {
+				range: byteRangeHeader(start, end),
+				...signal !== void 0 ? { signal } : {}
+			});
+			if (resp.status < 200 || resp.status >= 300) throw await classifyDownloadResponseError(resp);
+			if (!resp.body) throw new Error("Download chunk has no body");
+			const data = await collectStream(resp.body);
+			validateRangeResponse(resp, start, end, totalSize, data.byteLength);
+			return {
+				data,
+				contentSha1: normalizeSha1(resp.headers.get("X-Bz-Content-Sha1"))
+			};
+		} catch (err) {
+			lastError = err;
+			if (signal?.aborted) throw err;
+			if (err instanceof DOMException && err.name === "AbortError") throw err;
+			if (!isRetryableRangeError(err) || attempt === retryOptions.maxRetries) throw err;
+		}
+	}
+	throw lastError instanceof Error ? lastError : /* @__PURE__ */ new Error("Range download failed after retries");
 }
-export {
-  createParallelDownloadStream
+var RangeValidationError = class extends Error {
+	retryable = false;
+	constructor(message) {
+		super(message);
+		this.name = "RangeValidationError";
+	}
 };
-//# sourceMappingURL=parallel.js.map
+function validateRangeResponse(response, start, end, totalSize, byteLength) {
+	const expectedLength = end - start + 1;
+	if (response.status !== 206) throw new RangeValidationError(`Expected HTTP 206 Partial Content for range ${start}-${end}, got ${response.status}`);
+	const contentRange = response.headers.get("Content-Range");
+	if (contentRange === null) throw new RangeValidationError(`Missing Content-Range for range ${start}-${end}`);
+	const match = contentRange.match(/^bytes (\d+)-(\d+)\/(\d+|\*)$/);
+	if (match === null) throw new RangeValidationError(`Invalid Content-Range for range ${start}-${end}: ${contentRange}`);
+	const actualStart = Number.parseInt(match[1] ?? "", 10);
+	const actualEnd = Number.parseInt(match[2] ?? "", 10);
+	const actualTotal = match[3] ?? "";
+	if (actualStart !== start || actualEnd !== end) throw new RangeValidationError(`Content-Range ${contentRange} does not match requested range ${start}-${end}`);
+	if (actualTotal === "*") throw new RangeValidationError(`Content-Range ${contentRange} does not include total size`);
+	if (Number.parseInt(actualTotal, 10) !== totalSize) throw new RangeValidationError(`Content-Range ${contentRange} does not match expected total size ${totalSize}`);
+	if (byteLength !== expectedLength) throw new RangeValidationError(`Expected ${expectedLength} bytes for range ${start}-${end}, got ${byteLength}`);
+}
+async function classifyDownloadResponseError(response) {
+	let errorBody = {
+		status: response.status,
+		code: "internal_error",
+		message: `HTTP ${response.status}`
+	};
+	if (response.body !== null) {
+		const bytes = await collectStream(response.body);
+		try {
+			const parsed = JSON.parse(utf8Decoder.decode(bytes));
+			errorBody = {
+				status: response.status,
+				code: parsed.code ?? "internal_error",
+				message: parsed.message ?? `HTTP ${response.status}`
+			};
+		} catch {}
+	}
+	const retryAfterHeader = response.headers.get("Retry-After");
+	const retryAfter = retryAfterHeader !== null ? Number.parseInt(retryAfterHeader, 10) : void 0;
+	const requestId = response.headers.get("X-Bz-Request-Id") ?? void 0;
+	return classifyError(errorBody, {
+		...retryAfter !== void 0 ? { retryAfter } : {},
+		...requestId !== void 0 ? { requestId } : {}
+	});
+}
+function isRetryableRangeError(err) {
+	if (err instanceof B2Error || err instanceof NetworkError) return err.retryable;
+	if (hasRetryableFlag(err)) return err.retryable;
+	return err instanceof TypeError;
+}
+function hasRetryableFlag(err) {
+	return typeof err === "object" && err !== null && "retryable" in err && typeof err.retryable === "boolean";
+}
+//#endregion
+export { createParallelDownloadStream };
+
+//# sourceMappingURL=parallel.js.map

package/dist/download/parallel.js.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.js","sources":["../../src/download/parallel.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { DEFAULT_RETRY_OPTIONS, computeBackoff, sleep } from '../http/retry.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport { collectStream } from '../streams/collect.ts'\nimport type { FileId } from '../types/ids.ts'\nimport { DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\n\n/** Options for downloading a file using concurrent byte-range requests. */\nexport interface ParallelDownloadOptions {\n  /** ID of the file to download. */\n  readonly fileId: FileId\n  /** Total file size in bytes (must be known in advance). */\n  readonly totalSize: number\n  /** Size of each ranged chunk in bytes. Defaults to 10 MB. */\n  readonly rangeSize?: number\n  /** Maximum number of chunks fetched in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /** Maximum retry attempts per range on transient failures. Defaults to 5. */\n  readonly maxRetries?: number\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n}\n\n/**\n * Creates a readable stream that downloads a file using parallel byte-range requests.\n *\n * The file is split into fixed-size ranges fetched in a **sliding\n * window** keyed off the consumer's read pace. The window size is\n * `concurrency * 2`: up to `concurrency` ranges are in flight at once,\n * plus up to `concurrency` completed-but-not-yet-emitted ranges buffered\n * ahead of the read head. New fetches kick off only when the consumer\n * reads a chunk, so a slow downstream pipe (e.g. a saturated network\n * sink or a `pipeTo` consumer that drains slowly) backpressures into\n * the SDK and bounds peak memory to `(concurrency * 2) * rangeSize`.\n *\n * The previous eager implementation scheduled every range into\n * `Promise.all` up front; a slow head-of-line range could hold the\n * entire file in memory while later ranges finished and waited.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Parallel download parameters (file ID, size, concurrency).\n *\n * @returns A `ReadableStream` that yields file bytes in order.\n */\nexport function createParallelDownloadStream(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: ParallelDownloadOptions,\n): ReadableStream<Uint8Array> {\n  const rangeSize = options.rangeSize ?? 10 * 1024 * 1024\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n  const totalSize = options.totalSize\n  // `maxRetries` is part of `DEFAULT_RETRY_OPTIONS`; only override when\n  // the caller supplied an explicit value so the shared default stays\n  // the single source of truth.\n  const retryOptions = {\n    ...DEFAULT_RETRY_OPTIONS,\n    ...(options.maxRetries !== undefined ? { maxRetries: options.maxRetries } : {}),\n  }\n  const abort = options.signal\n\n  const ranges = planRanges(totalSize, rangeSize)\n\n  // `inflight` holds currently-fetching range promises; `buffer` holds\n  // completed ranges waiting for their slot in the emit order. Total\n  // scheduled-but-not-emitted = inflight.size + buffer.size is capped\n  // at `windowSize`, so peak memory is bounded regardless of any\n  // single range's latency.\n  const windowSize = concurrency * 2\n  const inflight = new Map<number, Promise<void>>()\n  const buffer = new Map<number, Uint8Array>()\n  let nextToSchedule = 0\n  let nextToEmit = 0\n  let firstError: unknown = null\n\n  function scheduleNext(): void {\n    while (\n      firstError === null &&\n      // Honour abort here so a completed range that triggers a top-up\n      // doesn't queue one final fetch after the caller aborted. Without\n      // this gate, one extra range request fires post-abort before the\n      // `pull()` loop notices.\n      abort?.aborted !== true &&\n      nextToSchedule < ranges.length &&\n      inflight.size + buffer.size < windowSize\n    ) {\n      const range = ranges[nextToSchedule]\n      if (range === undefined) break\n      const idx = nextToSchedule\n      nextToSchedule++\n      const task = (async () => {\n        try {\n          const data = await fetchRangeWithRetry(\n            raw,\n            accountInfo,\n            options.fileId,\n            range.start,\n            range.end,\n            retryOptions,\n            abort,\n          )\n          buffer.set(idx, data)\n        } catch (err) {\n          if (firstError === null) firstError = err\n        } finally {\n          inflight.delete(idx)\n        }\n      })()\n      inflight.set(idx, task)\n    }\n  }\n\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      // Pre-warm: kick off the initial window so the first `pull` has\n      // something to await. An already-aborted signal surfaces as a\n      // stream error rather than a synchronous throw, matching the\n      // contract callers had with the previous eager implementation.\n      try {\n        abort?.throwIfAborted()\n        scheduleNext()\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    async pull(controller) {\n      try {\n        // Wait until the next in-order chunk is available.\n        while (!buffer.has(nextToEmit)) {\n          abort?.throwIfAborted()\n          if (firstError !== null) throw firstError\n          /* v8 ignore start -- defensive close: every code path that\n             populates `nextToEmit < ranges.length` also schedules into\n             `inflight`. The pre-warm in `start()` plus `scheduleNext()`\n             after each enqueue guarantee that whenever there are\n             pending ranges, at least one is in flight. This guard\n             exists only so a future refactor can't accidentally stall\n             the stream by leaving both maps empty mid-stream. */\n          if (inflight.size === 0) {\n            controller.close()\n            return\n          }\n          /* v8 ignore stop */\n          await Promise.race(inflight.values())\n        }\n\n        const data = buffer.get(nextToEmit)\n        if (data !== undefined) {\n          buffer.delete(nextToEmit)\n          nextToEmit++\n          controller.enqueue(data)\n        }\n\n        // Top up the window now that we freed a slot by emitting.\n        scheduleNext()\n\n        if (\n          nextToEmit >= ranges.length &&\n          buffer.size === 0 &&\n          inflight.size === 0 &&\n          firstError === null\n        ) {\n          controller.close()\n        }\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    cancel() {\n      // Abort propagation handles in-flight requests; just drop buffered\n      // data so it can be GC'd promptly.\n      buffer.clear()\n    },\n  })\n}\n\n/**\n * Fetches a single byte range with bounded retry on transient failures.\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param fileId - ID of the file being downloaded.\n * @param start - Inclusive byte offset where the range begins.\n * @param end - Inclusive byte offset where the range ends.\n * @param retryOptions - Retry settings controlling attempts and backoff.\n * @param signal - Optional abort signal that cancels the range and any pending retry.\n *\n * @returns The range's bytes, or throws after exhausting all retry attempts.\n */\nasync function fetchRangeWithRetry(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  fileId: FileId,\n  start: number,\n  end: number,\n  retryOptions: typeof DEFAULT_RETRY_OPTIONS,\n  signal: AbortSignal | undefined,\n): Promise<Uint8Array> {\n  let lastError: unknown\n  for (let attempt = 0; attempt <= retryOptions.maxRetries; attempt++) {\n    if (attempt > 0) {\n      const delay = computeBackoff(attempt - 1, retryOptions)\n      await sleep(delay, signal)\n    }\n    try {\n      signal?.throwIfAborted()\n      const resp = await raw.downloadFileById(\n        accountInfo.getDownloadUrl(),\n        accountInfo.getAuthToken(),\n        fileId,\n        {\n          range: byteRangeHeader(start, end),\n          ...(signal !== undefined ? { signal } : {}),\n        },\n      )\n      if (!resp.body) throw new Error('Download chunk has no body')\n      return await collectStream(resp.body)\n    } catch (err) {\n      lastError = err\n      // Honour AbortSignal cancellation: don't retry past an abort.\n      if (signal?.aborted) throw err\n      if (err instanceof DOMException && err.name === 'AbortError') throw err\n    }\n  }\n  throw lastError instanceof Error ? lastError : new Error('Range download failed after retries')\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"parallel.js","names":[],"sources":["../../src/download/parallel.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { B2Error, classifyError, NetworkError } from '../errors/index.ts'\nimport { computeBackoff, DEFAULT_RETRY_OPTIONS, type RetryOptions, sleep } from '../http/retry.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport { collectStream } from '../streams/collect.ts'\nimport { IncrementalSha1 } from '../streams/hash.ts'\nimport type { B2ErrorResponse } from '../types/errors.ts'\nimport type { FileId } from '../types/ids.ts'\nimport { DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { normalizeSha1 } from '../util/normalize.ts'\nimport { byteRangeHeader, planRanges } from '../util/plan-ranges.ts'\nimport { normalizeVerifiableSha1 } from '../util/sha1.ts'\nimport { utf8Decoder } from '../util/text-codec.ts'\nimport { assertDownloadSha1, assertDownloadSha1HeaderAgreement } from './checksum.ts'\n\n/** Options for downloading a file using concurrent byte-range requests. */\nexport interface ParallelDownloadOptions {\n  /** ID of the file to download. */\n  readonly fileId: FileId\n  /** Total file size in bytes (must be known in advance). */\n  readonly totalSize: number\n  /** Size of each ranged chunk in bytes. Defaults to 10 MB. */\n  readonly rangeSize?: number\n  /** Maximum number of chunks fetched in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /**\n   * Extra retry attempts per range on transient failures. Defaults to 0 because\n   * `B2Client` already applies `RetryTransport`; set this only when supplying a\n   * raw client that does not already retry transport failures.\n   */\n  readonly maxRetries?: number\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n}\n\ninterface RangeDownloadResult {\n  readonly data: Uint8Array\n  readonly contentSha1: string | null\n}\n\n/**\n * Creates a readable stream that downloads a file using parallel byte-range requests.\n *\n * The file is split into fixed-size ranges fetched in a **sliding\n * window** keyed off the consumer's read pace. The window size is\n * `concurrency * 2`: up to `concurrency` ranges are in flight at once,\n * plus up to `concurrency` completed-but-not-yet-emitted ranges buffered\n * ahead of the read head. New fetches kick off only when the consumer\n * reads a chunk, so a slow downstream pipe (e.g. a saturated network\n * sink or a `pipeTo` consumer that drains slowly) backpressures into\n * the SDK and bounds peak memory to `(concurrency * 2) * rangeSize`.\n *\n * The previous eager implementation scheduled every range into\n * `Promise.all` up front; a slow head-of-line range could hold the\n * entire file in memory while later ranges finished and waited.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Parallel download parameters (file ID, size, concurrency).\n *\n * @returns A `ReadableStream` that yields file bytes in order.\n */\nexport function createParallelDownloadStream(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: ParallelDownloadOptions,\n): ReadableStream<Uint8Array> {\n  const rangeSize = options.rangeSize ?? 10 * 1024 * 1024\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n  const totalSize = options.totalSize\n  // The high-level B2Client already wraps the raw transport in RetryTransport.\n  // Keep the parallel-download outer retry disabled by default so each range\n  // has one retry budget unless callers explicitly opt into an extra raw-client\n  // retry layer.\n  const retryOptions = {\n    ...DEFAULT_RETRY_OPTIONS,\n    maxRetries: options.maxRetries ?? 0,\n  }\n  const abort = options.signal\n\n  const ranges = planRanges(totalSize, rangeSize)\n\n  // `inflight` holds currently-fetching range promises; `buffer` holds\n  // completed ranges waiting for their slot in the emit order. Total\n  // scheduled-but-not-emitted = inflight.size + buffer.size is capped\n  // at `windowSize`, so peak memory is bounded regardless of any\n  // single range's latency.\n  const windowSize = concurrency * 2\n  const inflight = new Map<number, Promise<void>>()\n  const buffer = new Map<number, RangeDownloadResult>()\n  let assembledSha1: IncrementalSha1 | null = null\n  let nextToSchedule = 0\n  let nextToEmit = 0\n  let expectedSha1: string | null | undefined\n  let firstError: unknown = null\n\n  function scheduleNext(): void {\n    while (\n      firstError === null &&\n      // Honour abort here so a completed range that triggers a top-up\n      // doesn't queue one final fetch after the caller aborted. Without\n      // this gate, one extra range request fires post-abort before the\n      // `pull()` loop notices.\n      abort?.aborted !== true &&\n      nextToSchedule < ranges.length &&\n      inflight.size + buffer.size < windowSize\n    ) {\n      const range = ranges[nextToSchedule]\n      if (range === undefined) break\n      const idx = nextToSchedule\n      nextToSchedule++\n      const task = (async () => {\n        try {\n          const result = await fetchRangeWithRetry(\n            raw,\n            accountInfo,\n            options.fileId,\n            range.start,\n            range.end,\n            totalSize,\n            retryOptions,\n            abort,\n          )\n          buffer.set(idx, result)\n        } catch (err) {\n          if (firstError === null) firstError = err\n        } finally {\n          inflight.delete(idx)\n        }\n      })()\n      inflight.set(idx, task)\n    }\n  }\n\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      // Pre-warm: kick off the initial window so the first `pull` has\n      // something to await. An already-aborted signal surfaces as a\n      // stream error rather than a synchronous throw, matching the\n      // contract callers had with the previous eager implementation.\n      try {\n        abort?.throwIfAborted()\n        scheduleNext()\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    async pull(controller) {\n      try {\n        // Wait until the next in-order chunk is available.\n        while (!buffer.has(nextToEmit)) {\n          abort?.throwIfAborted()\n          if (firstError !== null) throw firstError\n          // Zero-byte downloads have no planned ranges and close here. For\n          // non-empty downloads, this guard prevents a future refactor from\n          // stalling the stream if it leaves both maps empty mid-stream.\n          if (inflight.size === 0) {\n            controller.close()\n            return\n          }\n          await Promise.race(inflight.values())\n        }\n\n        const result = buffer.get(nextToEmit)\n        if (result !== undefined) {\n          buffer.delete(nextToEmit)\n          nextToEmit++\n          const rangeSha1 = normalizeVerifiableSha1(result.contentSha1)\n          if (expectedSha1 === undefined) {\n            expectedSha1 = rangeSha1\n          } else {\n            // B2 range responses should agree on the same whole-file SHA-1;\n            // any value or presence change makes verification untrustworthy.\n            assertDownloadSha1HeaderAgreement(expectedSha1, rangeSha1)\n          }\n          if (expectedSha1 !== null) {\n            assembledSha1 ??= new IncrementalSha1()\n            await assembledSha1.update(result.data)\n          }\n          controller.enqueue(result.data)\n        }\n\n        // Top up the window now that we freed a slot by emitting.\n        scheduleNext()\n\n        if (\n          nextToEmit >= ranges.length &&\n          buffer.size === 0 &&\n          inflight.size === 0 &&\n          firstError === null\n        ) {\n          if (expectedSha1 !== undefined && expectedSha1 !== null && assembledSha1 !== null) {\n            assertDownloadSha1(expectedSha1, await assembledSha1.digest())\n          }\n          controller.close()\n        }\n      } catch (err) {\n        controller.error(err)\n      }\n    },\n    cancel() {\n      // Abort propagation handles in-flight requests; just drop buffered\n      // data so it can be GC'd promptly.\n      buffer.clear()\n    },\n  })\n}\n\n/**\n * Fetches a single byte range with bounded retry on transient failures.\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param fileId - ID of the file being downloaded.\n * @param start - Inclusive byte offset where the range begins.\n * @param end - Inclusive byte offset where the range ends.\n * @param totalSize - Expected complete file size.\n * @param retryOptions - Retry settings controlling attempts and backoff.\n * @param signal - Optional abort signal that cancels the range and any pending retry.\n *\n * @returns The range's bytes, or throws after exhausting all retry attempts.\n */\nasync function fetchRangeWithRetry(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  fileId: FileId,\n  start: number,\n  end: number,\n  totalSize: number,\n  retryOptions: RetryOptions,\n  signal: AbortSignal | undefined,\n): Promise<RangeDownloadResult> {\n  let lastError: unknown\n  for (let attempt = 0; attempt <= retryOptions.maxRetries; attempt++) {\n    if (attempt > 0) {\n      const retryAfter =\n        lastError instanceof B2Error && lastError.retryAfter !== undefined\n          ? lastError.retryAfter\n          : undefined\n      const delay = computeBackoff(attempt - 1, retryOptions, retryAfter)\n      await sleep(delay, signal)\n    }\n    try {\n      signal?.throwIfAborted()\n      const resp = await raw.downloadFileById(\n        accountInfo.getDownloadUrl(),\n        accountInfo.getAuthToken(),\n        fileId,\n        {\n          range: byteRangeHeader(start, end),\n          ...(signal !== undefined ? { signal } : {}),\n        },\n      )\n      if (resp.status < 200 || resp.status >= 300) {\n        throw await classifyDownloadResponseError(resp)\n      }\n      if (!resp.body) throw new Error('Download chunk has no body')\n      const data = await collectStream(resp.body)\n      validateRangeResponse(resp, start, end, totalSize, data.byteLength)\n      return {\n        data,\n        contentSha1: normalizeSha1(resp.headers.get('X-Bz-Content-Sha1')),\n      }\n    } catch (err) {\n      lastError = err\n      // Honour AbortSignal cancellation: don't retry past an abort.\n      if (signal?.aborted) throw err\n      if (err instanceof DOMException && err.name === 'AbortError') throw err\n      if (!isRetryableRangeError(err) || attempt === retryOptions.maxRetries) {\n        throw err\n      }\n    }\n  }\n  throw lastError instanceof Error ? lastError : new Error('Range download failed after retries')\n}\n\nclass RangeValidationError extends Error {\n  readonly retryable = false\n\n  constructor(message: string) {\n    super(message)\n    this.name = 'RangeValidationError'\n  }\n}\n\nfunction validateRangeResponse(\n  response: { headers: Headers; status: number },\n  start: number,\n  end: number,\n  totalSize: number,\n  byteLength: number,\n): void {\n  const expectedLength = end - start + 1\n  if (response.status !== 206) {\n    throw new RangeValidationError(\n      `Expected HTTP 206 Partial Content for range ${start}-${end}, got ${response.status}`,\n    )\n  }\n\n  const contentRange = response.headers.get('Content-Range')\n  if (contentRange === null) {\n    throw new RangeValidationError(`Missing Content-Range for range ${start}-${end}`)\n  }\n\n  const match = contentRange.match(/^bytes (\\d+)-(\\d+)\\/(\\d+|\\*)$/)\n  if (match === null) {\n    throw new RangeValidationError(\n      `Invalid Content-Range for range ${start}-${end}: ${contentRange}`,\n    )\n  }\n\n  const actualStart = Number.parseInt(match[1] ?? '', 10)\n  const actualEnd = Number.parseInt(match[2] ?? '', 10)\n  const actualTotal = match[3] ?? ''\n  if (actualStart !== start || actualEnd !== end) {\n    throw new RangeValidationError(\n      `Content-Range ${contentRange} does not match requested range ${start}-${end}`,\n    )\n  }\n\n  if (actualTotal === '*') {\n    throw new RangeValidationError(`Content-Range ${contentRange} does not include total size`)\n  }\n\n  const parsedTotal = Number.parseInt(actualTotal, 10)\n  if (parsedTotal !== totalSize) {\n    throw new RangeValidationError(\n      `Content-Range ${contentRange} does not match expected total size ${totalSize}`,\n    )\n  }\n\n  if (byteLength !== expectedLength) {\n    throw new RangeValidationError(\n      `Expected ${expectedLength} bytes for range ${start}-${end}, got ${byteLength}`,\n    )\n  }\n}\n\nasync function classifyDownloadResponseError(response: {\n  headers: Headers\n  status: number\n  body: ReadableStream<Uint8Array> | null\n}): Promise<B2Error> {\n  let errorBody: B2ErrorResponse = {\n    status: response.status,\n    code: 'internal_error',\n    message: `HTTP ${response.status}`,\n  }\n\n  if (response.body !== null) {\n    const bytes = await collectStream(response.body)\n    try {\n      const parsed = JSON.parse(utf8Decoder.decode(bytes)) as Partial<B2ErrorResponse>\n      errorBody = {\n        status: response.status,\n        code: parsed.code ?? 'internal_error',\n        message: parsed.message ?? `HTTP ${response.status}`,\n      }\n    } catch {\n      // Keep the synthetic errorBody above when the response body is not JSON.\n    }\n  }\n\n  const retryAfterHeader = response.headers.get('Retry-After')\n  const retryAfter = retryAfterHeader !== null ? Number.parseInt(retryAfterHeader, 10) : undefined\n  const requestId = response.headers.get('X-Bz-Request-Id') ?? undefined\n\n  return classifyError(errorBody, {\n    ...(retryAfter !== undefined ? { retryAfter } : {}),\n    ...(requestId !== undefined ? { requestId } : {}),\n  })\n}\n\nfunction isRetryableRangeError(err: unknown): boolean {\n  if (err instanceof B2Error || err instanceof NetworkError) return err.retryable\n  if (hasRetryableFlag(err)) return err.retryable\n  // Bare FetchTransport surfaces network failures as TypeError. Validation\n  // failures use RangeValidationError above, so they never land here.\n  return err instanceof TypeError\n}\n\nfunction hasRetryableFlag(err: unknown): err is { retryable: boolean } {\n  return (\n    typeof err === 'object' &&\n    err !== null &&\n    'retryable' in err &&\n    typeof (err as { retryable?: unknown }).retryable === 'boolean'\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,6BACd,KACA,aACA,SAC4B;CAC5B,MAAM,YAAY,QAAQ,aAAa,KAAK,OAAO;CACnD,MAAM,cAAc,QAAQ,eAAA;CAC5B,MAAM,YAAY,QAAQ;CAK1B,MAAM,eAAe;EACnB,GAAG;EACH,YAAY,QAAQ,cAAc;CACpC;CACA,MAAM,QAAQ,QAAQ;CAEtB,MAAM,SAAS,WAAW,WAAW,SAAS;CAO9C,MAAM,aAAa,cAAc;CACjC,MAAM,2BAAW,IAAI,IAA2B;CAChD,MAAM,yBAAS,IAAI,IAAiC;CACpD,IAAI,gBAAwC;CAC5C,IAAI,iBAAiB;CACrB,IAAI,aAAa;CACjB,IAAI;CACJ,IAAI,aAAsB;CAE1B,SAAS,eAAqB;EAC5B,OACE,eAAe,QAKf,OAAO,YAAY,QACnB,iBAAiB,OAAO,UACxB,SAAS,OAAO,OAAO,OAAO,YAC9B;GACA,MAAM,QAAQ,OAAO;GACrB,IAAI,UAAU,KAAA,GAAW;GACzB,MAAM,MAAM;GACZ;GACA,MAAM,QAAQ,YAAY;IACxB,IAAI;KACF,MAAM,SAAS,MAAM,oBACnB,KACA,aACA,QAAQ,QACR,MAAM,OACN,MAAM,KACN,WACA,cACA,KACF;KACA,OAAO,IAAI,KAAK,MAAM;IACxB,SAAS,KAAK;KACZ,IAAI,eAAe,MAAM,aAAa;IACxC,UAAU;KACR,SAAS,OAAO,GAAG;IACrB;GACF,EAAA,CAAG;GACH,SAAS,IAAI,KAAK,IAAI;EACxB;CACF;CAEA,OAAO,IAAI,eAA2B;EACpC,MAAM,YAAY;GAKhB,IAAI;IACF,OAAO,eAAe;IACtB,aAAa;GACf,SAAS,KAAK;IACZ,WAAW,MAAM,GAAG;GACtB;EACF;EACA,MAAM,KAAK,YAAY;GACrB,IAAI;IAEF,OAAO,CAAC,OAAO,IAAI,UAAU,GAAG;KAC9B,OAAO,eAAe;KACtB,IAAI,eAAe,MAAM,MAAM;KAI/B,IAAI,SAAS,SAAS,GAAG;MACvB,WAAW,MAAM;MACjB;KACF;KACA,MAAM,QAAQ,KAAK,SAAS,OAAO,CAAC;IACtC;IAEA,MAAM,SAAS,OAAO,IAAI,UAAU;IACpC,IAAI,WAAW,KAAA,GAAW;KACxB,OAAO,OAAO,UAAU;KACxB;KACA,MAAM,YAAY,wBAAwB,OAAO,WAAW;KAC5D,IAAI,iBAAiB,KAAA,GACnB,eAAe;UAIf,kCAAkC,cAAc,SAAS;KAE3D,IAAI,iBAAiB,MAAM;MACzB,kBAAkB,IAAI,gBAAgB;MACtC,MAAM,cAAc,OAAO,OAAO,IAAI;KACxC;KACA,WAAW,QAAQ,OAAO,IAAI;IAChC;IAGA,aAAa;IAEb,IACE,cAAc,OAAO,UACrB,OAAO,SAAS,KAChB,SAAS,SAAS,KAClB,eAAe,MACf;KACA,IAAI,iBAAiB,KAAA,KAAa,iBAAiB,QAAQ,kBAAkB,MAC3E,mBAAmB,cAAc,MAAM,cAAc,OAAO,CAAC;KAE/D,WAAW,MAAM;IACnB;GACF,SAAS,KAAK;IACZ,WAAW,MAAM,GAAG;GACtB;EACF;EACA,SAAS;GAGP,OAAO,MAAM;EACf;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,eAAe,oBACb,KACA,aACA,QACA,OACA,KACA,WACA,cACA,QAC8B;CAC9B,IAAI;CACJ,KAAK,IAAI,UAAU,GAAG,WAAW,aAAa,YAAY,WAAW;EACnE,IAAI,UAAU,GAAG;GACf,MAAM,aACJ,qBAAqB,WAAW,UAAU,eAAe,KAAA,IACrD,UAAU,aACV,KAAA;GAEN,MAAM,MADQ,eAAe,UAAU,GAAG,cAAc,UAC5C,GAAO,MAAM;EAC3B;EACA,IAAI;GACF,QAAQ,eAAe;GACvB,MAAM,OAAO,MAAM,IAAI,iBACrB,YAAY,eAAe,GAC3B,YAAY,aAAa,GACzB,QACA;IACE,OAAO,gBAAgB,OAAO,GAAG;IACjC,GAAI,WAAW,KAAA,IAAY,EAAE,OAAO,IAAI,CAAC;GAC3C,CACF;GACA,IAAI,KAAK,SAAS,OAAO,KAAK,UAAU,KACtC,MAAM,MAAM,8BAA8B,IAAI;GAEhD,IAAI,CAAC,KAAK,MAAM,MAAM,IAAI,MAAM,4BAA4B;GAC5D,MAAM,OAAO,MAAM,cAAc,KAAK,IAAI;GAC1C,sBAAsB,MAAM,OAAO,KAAK,WAAW,KAAK,UAAU;GAClE,OAAO;IACL;IACA,aAAa,cAAc,KAAK,QAAQ,IAAI,mBAAmB,CAAC;GAClE;EACF,SAAS,KAAK;GACZ,YAAY;GAEZ,IAAI,QAAQ,SAAS,MAAM;GAC3B,IAAI,eAAe,gBAAgB,IAAI,SAAS,cAAc,MAAM;GACpE,IAAI,CAAC,sBAAsB,GAAG,KAAK,YAAY,aAAa,YAC1D,MAAM;EAEV;CACF;CACA,MAAM,qBAAqB,QAAQ,4BAAY,IAAI,MAAM,qCAAqC;AAChG;AAEA,IAAM,uBAAN,cAAmC,MAAM;CACvC,YAAqB;CAErB,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,SAAS,sBACP,UACA,OACA,KACA,WACA,YACM;CACN,MAAM,iBAAiB,MAAM,QAAQ;CACrC,IAAI,SAAS,WAAW,KACtB,MAAM,IAAI,qBACR,+CAA+C,MAAM,GAAG,IAAI,QAAQ,SAAS,QAC/E;CAGF,MAAM,eAAe,SAAS,QAAQ,IAAI,eAAe;CACzD,IAAI,iBAAiB,MACnB,MAAM,IAAI,qBAAqB,mCAAmC,MAAM,GAAG,KAAK;CAGlF,MAAM,QAAQ,aAAa,MAAM,+BAA+B;CAChE,IAAI,UAAU,MACZ,MAAM,IAAI,qBACR,mCAAmC,MAAM,GAAG,IAAI,IAAI,cACtD;CAGF,MAAM,cAAc,OAAO,SAAS,MAAM,MAAM,IAAI,EAAE;CACtD,MAAM,YAAY,OAAO,SAAS,MAAM,MAAM,IAAI,EAAE;CACpD,MAAM,cAAc,MAAM,MAAM;CAChC,IAAI,gBAAgB,SAAS,cAAc,KACzC,MAAM,IAAI,qBACR,iBAAiB,aAAa,kCAAkC,MAAM,GAAG,KAC3E;CAGF,IAAI,gBAAgB,KAClB,MAAM,IAAI,qBAAqB,iBAAiB,aAAa,6BAA6B;CAI5F,IADoB,OAAO,SAAS,aAAa,EAC7C,MAAgB,WAClB,MAAM,IAAI,qBACR,iBAAiB,aAAa,sCAAsC,WACtE;CAGF,IAAI,eAAe,gBACjB,MAAM,IAAI,qBACR,YAAY,eAAe,mBAAmB,MAAM,GAAG,IAAI,QAAQ,YACrE;AAEJ;AAEA,eAAe,8BAA8B,UAIxB;CACnB,IAAI,YAA6B;EAC/B,QAAQ,SAAS;EACjB,MAAM;EACN,SAAS,QAAQ,SAAS;CAC5B;CAEA,IAAI,SAAS,SAAS,MAAM;EAC1B,MAAM,QAAQ,MAAM,cAAc,SAAS,IAAI;EAC/C,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,YAAY,OAAO,KAAK,CAAC;GACnD,YAAY;IACV,QAAQ,SAAS;IACjB,MAAM,OAAO,QAAQ;IACrB,SAAS,OAAO,WAAW,QAAQ,SAAS;GAC9C;EACF,QAAQ,CAER;CACF;CAEA,MAAM,mBAAmB,SAAS,QAAQ,IAAI,aAAa;CAC3D,MAAM,aAAa,qBAAqB,OAAO,OAAO,SAAS,kBAAkB,EAAE,IAAI,KAAA;CACvF,MAAM,YAAY,SAAS,QAAQ,IAAI,iBAAiB,KAAK,KAAA;CAE7D,OAAO,cAAc,WAAW;EAC9B,GAAI,eAAe,KAAA,IAAY,EAAE,WAAW,IAAI,CAAC;EACjD,GAAI,cAAc,KAAA,IAAY,EAAE,UAAU,IAAI,CAAC;CACjD,CAAC;AACH;AAEA,SAAS,sBAAsB,KAAuB;CACpD,IAAI,eAAe,WAAW,eAAe,cAAc,OAAO,IAAI;CACtE,IAAI,iBAAiB,GAAG,GAAG,OAAO,IAAI;CAGtC,OAAO,eAAe;AACxB;AAEA,SAAS,iBAAiB,KAA6C;CACrE,OACE,OAAO,QAAQ,YACf,QAAQ,QACR,eAAe,OACf,OAAQ,IAAgC,cAAc;AAE1D"}