@backblaze-labs/b2-sdk 0.3.0 → 0.4.0

package/dist/download/single.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"single.cjs","names":[],"sources":["../../src/download/single.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { parseFileInfoHeaders } from '../raw/encoding.ts'\nimport type { DownloadFileOptions, RawClient, SseCDownloadKey } from '../raw/index.ts'\nimport { type ProgressListener, ProgressTracker } from '../streams/progress.ts'\nimport {\n  DownloadClientUnauthorizedToReadMarker,\n  DownloadHeaderName,\n  type DownloadHeaderParseIssue,\n  type DownloadHeaders,\n  type DownloadServerSideEncryption,\n} from '../types/download.ts'\nimport { EncryptionAlgorithm, EncryptionMode } from '../types/encryption.ts'\nimport { type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { type FileRetentionValue, LegalHoldValue, RetentionMode } from '../types/lock.ts'\nimport { bestEffort } from '../util/best-effort.ts'\nimport { normalizeSha1 } from '../util/normalize.ts'\nimport { verifyDownloadStream } from './checksum.ts'\n\n/** Result of a single-request file download. */\nexport interface DownloadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n  /**\n   * Streaming body of the downloaded file.\n   *\n   * If checksum verification fails, the stream errors after bytes have already\n   * flowed; discard any partially written output on `ChecksumMismatchError`.\n   */\n  readonly body: ReadableStream<Uint8Array>\n}\n\n/**\n * Result of a HEAD-style metadata fetch. Unlike {@link DownloadResult},\n * this shape has **no** `body` field — the SDK consumes and discards the\n * (logically empty) HEAD response body internally so callers never have\n * to remember to `body.cancel()` after a metadata-only fetch.\n */\nexport interface HeadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n}\n\n/** Shared download options exposed at the high-level facade. */\ninterface DownloadCommonOptions {\n  /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only response headers without streaming the body. */\n  readonly method?: 'GET' | 'HEAD'\n  /** Optional HTTP Range header value (e.g. `bytes=0-999`). */\n  readonly range?: string\n  /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n  readonly serverSideEncryption?: SseCDownloadKey\n  /** Override the response `Content-Disposition` header. */\n  readonly b2ContentDisposition?: string\n  /** Override the response `Content-Language` header. */\n  readonly b2ContentLanguage?: string\n  /** Override the response `Content-Encoding` header. */\n  readonly b2ContentEncoding?: string\n  /** Override the response `Content-Type` header. */\n  readonly b2ContentType?: string\n  /** Override the response `Cache-Control` header. */\n  readonly b2CacheControl?: string\n  /** Override the response `Expires` header. */\n  readonly b2Expires?: string\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n  /**\n   * Callback invoked as bytes flow through the returned `body` stream.\n   *\n   * Wraps the response body in a `TransformStream` that increments a\n   * `ProgressTracker` per chunk and emits a `partsCompleted: 1` event when\n   * the stream finishes. `totalBytes` is the response's `Content-Length`\n   * header (or `null` if the server didn't send one — rare for B2).\n   *\n   * If the caller does not read the returned body to completion, the\n   * tracker's `completePart()` event will not fire. That is intentional:\n   * progress is byte-driven, not request-driven.\n   */\n  readonly onProgress?: ProgressListener\n}\n\n/** Options for downloading a file by its unique ID. */\nexport interface DownloadByIdOptions extends DownloadCommonOptions {\n  /** ID of the file version to download. */\n  readonly fileId: FileId\n}\n\n/** Options for downloading a file by bucket name and file path. */\nexport interface DownloadByNameOptions extends DownloadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits\n * `method` (always HEAD) and `onProgress` (no body to track).\n */\ntype HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress'>\n\n/** Options for a HEAD-by-ID request. */\nexport interface HeadByIdOptions extends HeadCommonOptions {\n  /** ID of the file version to inspect. */\n  readonly fileId: FileId\n}\n\n/** Options for a HEAD-by-name request. */\nexport interface HeadByNameOptions extends HeadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Downloads a file by its unique ID in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByIdOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    // HEAD requests legitimately have no body; return an empty stream so the\n    // result shape stays consistent.\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Downloads a file by bucket name and file path in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByNameOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Issues a HEAD-by-ID request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadById({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (file ID + the same response-header\n *   overrides and abort signal that `downloadById` accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByIdOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  // Body for HEAD is normally `null` per the fetch spec. Some transports\n  // (notably the SDK's `B2Simulator`) synthesize a non-null body for\n  // shape consistency. In either case, cancelling is a no-op for the\n  // caller; wrap in `bestEffort` so a stream-lifecycle quirk in a\n  // future runtime can't fail an otherwise-successful HEAD.\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Issues a HEAD-by-name request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadByName({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (bucket + file name + the same\n *   response-header overrides and abort signal that `downloadByName`\n *   accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByNameOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Translates the public download-options shape into the raw client's\n * {@link DownloadFileOptions}, dropping the request-target fields (`fileId`,\n * `bucketName`, `fileName`) that don't apply at the transport layer.\n *\n * @param options - Caller-supplied download options.\n *\n * @returns The raw transport-layer options.\n */\nfunction toRawDownloadOptions(options: DownloadCommonOptions): DownloadFileOptions {\n  return {\n    ...(options.method !== undefined ? { method: options.method } : {}),\n    ...(options.range !== undefined ? { range: options.range } : {}),\n    ...(options.serverSideEncryption !== undefined\n      ? { serverSideEncryption: options.serverSideEncryption }\n      : {}),\n    ...(options.b2ContentDisposition !== undefined\n      ? { b2ContentDisposition: options.b2ContentDisposition }\n      : {}),\n    ...(options.b2ContentLanguage !== undefined\n      ? { b2ContentLanguage: options.b2ContentLanguage }\n      : {}),\n    ...(options.b2ContentEncoding !== undefined\n      ? { b2ContentEncoding: options.b2ContentEncoding }\n      : {}),\n    ...(options.b2ContentType !== undefined ? { b2ContentType: options.b2ContentType } : {}),\n    ...(options.b2CacheControl !== undefined ? { b2CacheControl: options.b2CacheControl } : {}),\n    ...(options.b2Expires !== undefined ? { b2Expires: options.b2Expires } : {}),\n    ...(options.signal !== undefined ? { signal: options.signal } : {}),\n  }\n}\n\n/**\n * Builds an immediately-closed empty ReadableStream. Used as the body of a\n * HEAD download response so callers always get a stream they can `pipeTo`.\n *\n * @returns A ReadableStream that yields zero bytes and immediately closes.\n */\nfunction emptyStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream({\n    start(controller) {\n      controller.close()\n    },\n  })\n}\n\n/**\n * Applies stream wrappers common to single-request downloads.\n *\n * Full-body GET downloads are checksum-verified when B2 supplies a real\n * whole-file SHA-1. HEAD requests and ranged GETs are skipped because the\n * response body is empty or partial while `X-Bz-Content-Sha1` describes the\n * full file version.\n *\n * @param body - Download response body.\n * @param headers - Parsed download headers.\n * @param options - Caller-supplied download options.\n *\n * @returns A stream wrapped for checksum verification and progress reporting.\n */\nfunction prepareDownloadBody(\n  body: ReadableStream<Uint8Array>,\n  headers: DownloadHeaders,\n  options: DownloadCommonOptions,\n): ReadableStream<Uint8Array> {\n  const shouldVerify = options.method !== 'HEAD' && options.range === undefined\n  const verifiedBody = shouldVerify ? verifyDownloadStream(body, headers.contentSha1) : body\n  return instrumentProgress(verifiedBody, headers.contentLength, options.onProgress)\n}\n\n/**\n * Wraps a body stream with a `TransformStream` that increments a\n * {@link ProgressTracker} for each chunk and reports `partsCompleted: 1`\n * when the stream finishes.\n *\n * When `listener` is undefined the function short-circuits and returns\n * the original stream, so unobserved downloads pay no overhead.\n *\n * @param body - The download response body to wrap.\n * @param totalBytes - Expected total bytes (response `Content-Length`).\n * @param listener - Caller-supplied progress callback, or undefined.\n *\n * @returns A stream that emits the same bytes and reports progress.\n */\nfunction instrumentProgress(\n  body: ReadableStream<Uint8Array>,\n  totalBytes: number,\n  listener: ProgressListener | undefined,\n): ReadableStream<Uint8Array> {\n  if (listener === undefined) return body\n  const tracker = new ProgressTracker(listener, totalBytes, 1)\n  const transform = new TransformStream<Uint8Array, Uint8Array>({\n    transform(chunk, controller) {\n      tracker.addBytes(chunk.byteLength)\n      controller.enqueue(chunk)\n    },\n    flush() {\n      tracker.completePart()\n    },\n  })\n  return body.pipeThrough(transform)\n}\n\n/**\n * Extracts B2-specific download headers into a structured object.\n * @param headers - The HTTP response headers from the download.\n *\n * @returns The parsed download metadata.\n */\nfunction extractDownloadHeaders(headers: Headers): DownloadHeaders {\n  const headerParseIssues: DownloadHeaderParseIssue[] = []\n  const fileInfo = parseFileInfoHeaders(headers)\n  const clientUnauthorizedToRead = parseClientUnauthorizedToRead(headers, headerParseIssues)\n  const contentDisposition = optionalHeader(headers, DownloadHeaderName.ContentDisposition)\n  const contentLanguage = optionalHeader(headers, DownloadHeaderName.ContentLanguage)\n  const contentEncoding = optionalHeader(headers, DownloadHeaderName.ContentEncoding)\n  const cacheControl = optionalHeader(headers, DownloadHeaderName.CacheControl)\n  const expires = optionalHeader(headers, DownloadHeaderName.Expires)\n  const contentRange = optionalHeader(headers, DownloadHeaderName.ContentRange)\n  const serverSideEncryption = parseDownloadServerSideEncryption(headers, headerParseIssues)\n  const fileRetention = parseDownloadFileRetention(\n    headers,\n    clientUnauthorizedToRead,\n    headerParseIssues,\n  )\n  const legalHold = parseDownloadLegalHold(headers, clientUnauthorizedToRead, headerParseIssues)\n\n  return {\n    contentType: headers.get(DownloadHeaderName.ContentType) ?? 'application/octet-stream',\n    contentLength: Number.parseInt(headers.get(DownloadHeaderName.ContentLength) ?? '0', 10),\n    ...(contentDisposition !== undefined ? { contentDisposition } : {}),\n    ...(contentLanguage !== undefined ? { contentLanguage } : {}),\n    ...(contentEncoding !== undefined ? { contentEncoding } : {}),\n    ...(cacheControl !== undefined ? { cacheControl } : {}),\n    ...(expires !== undefined ? { expires } : {}),\n    ...(contentRange !== undefined ? { contentRange } : {}),\n    // B2 sends the literal `'none'` for multipart-finished files; collapse\n    // to `null` so the typed `string | null` actually means \"no SHA-1\".\n    contentSha1: normalizeSha1(headers.get(DownloadHeaderName.ContentSha1)),\n    fileId: fileIdOf(headers.get(DownloadHeaderName.FileId) ?? ''),\n    fileName: decodeURIComponent(headers.get(DownloadHeaderName.FileName) ?? ''),\n    fileInfo,\n    uploadTimestamp: Number.parseInt(headers.get(DownloadHeaderName.UploadTimestamp) ?? '0', 10),\n    ...(serverSideEncryption !== undefined ? { serverSideEncryption } : {}),\n    ...(fileRetention !== undefined ? { fileRetention } : {}),\n    ...(legalHold !== undefined ? { legalHold } : {}),\n    ...(clientUnauthorizedToRead !== undefined ? { clientUnauthorizedToRead } : {}),\n    ...(headerParseIssues.length > 0 ? { headerParseIssues } : {}),\n  }\n}\n\nfunction optionalHeader(headers: Headers, name: string): string | undefined {\n  return headers.get(name) ?? undefined\n}\n\nfunction parseDownloadServerSideEncryption(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadServerSideEncryption | undefined {\n  const managedAlgorithm = optionalHeader(headers, DownloadHeaderName.ServerSideEncryption)\n  if (managedAlgorithm !== undefined) {\n    if (managedAlgorithm !== EncryptionAlgorithm.Aes256) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ServerSideEncryption,\n        value: managedAlgorithm,\n      })\n      return undefined\n    }\n    return { mode: EncryptionMode.SseB2, algorithm: managedAlgorithm }\n  }\n\n  const customerAlgorithm = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n  )\n  const customerKeyMd5 = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerKeyMd5,\n  )\n  if (customerAlgorithm === undefined || customerKeyMd5 === undefined) return undefined\n  if (customerAlgorithm !== EncryptionAlgorithm.Aes256) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n      value: customerAlgorithm,\n    })\n    return undefined\n  }\n  return { mode: EncryptionMode.SseC, algorithm: customerAlgorithm, customerKeyMd5 }\n}\n\nfunction parseDownloadFileRetention(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['fileRetention'] {\n  if (\n    clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileRetentionMode) ===\n      true ||\n    clientUnauthorizedToRead?.includes(\n      DownloadClientUnauthorizedToReadMarker.FileRetentionRetainUntilTimestamp,\n    ) === true\n  ) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawMode = optionalHeader(headers, DownloadHeaderName.FileRetentionMode)\n  const rawRetainUntilTimestamp = optionalHeader(\n    headers,\n    DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n  )\n  if (rawMode === undefined && rawRetainUntilTimestamp === undefined) return undefined\n  return {\n    isClientAuthorizedToRead: true,\n    value: {\n      mode: parseRetentionMode(rawMode, headerParseIssues),\n      retainUntilTimestamp: parseRetentionTimestamp(rawRetainUntilTimestamp, headerParseIssues),\n    },\n  }\n}\n\nfunction parseRetentionMode(\n  rawMode: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): FileRetentionValue['mode'] {\n  if (rawMode === undefined) return null\n  if (rawMode === RetentionMode.Compliance || rawMode === RetentionMode.Governance) {\n    return rawMode\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileRetentionMode, value: rawMode })\n  return null\n}\n\nfunction parseRetentionTimestamp(\n  rawTimestamp: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): number | null {\n  if (rawTimestamp === undefined) return null\n  if (!/^\\d+$/.test(rawTimestamp)) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n      value: rawTimestamp,\n    })\n    return null\n  }\n  const parsed = Number.parseInt(rawTimestamp, 10)\n  if (Number.isFinite(parsed)) return parsed\n  headerParseIssues.push({\n    headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n    value: rawTimestamp,\n  })\n  return null\n}\n\nfunction parseDownloadLegalHold(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['legalHold'] {\n  if (clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileLegalHold)) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawLegalHold = optionalHeader(headers, DownloadHeaderName.FileLegalHold)\n  if (rawLegalHold === undefined) return undefined\n  if (rawLegalHold === LegalHoldValue.On || rawLegalHold === LegalHoldValue.Off) {\n    return { isClientAuthorizedToRead: true, value: rawLegalHold }\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileLegalHold, value: rawLegalHold })\n  return { isClientAuthorizedToRead: true, value: null }\n}\n\nfunction parseClientUnauthorizedToRead(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['clientUnauthorizedToRead'] {\n  const value = optionalHeader(headers, DownloadHeaderName.ClientUnauthorizedToRead)\n  if (value === undefined) return undefined\n  const headerNames = value\n    .split(',')\n    .map((header) => header.trim())\n    .filter((header) => header.length > 0)\n  const knownHeaderNames = headerNames.filter(isDownloadClientUnauthorizedToReadMarker)\n  for (const headerName of headerNames) {\n    if (!isDownloadClientUnauthorizedToReadMarker(headerName)) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ClientUnauthorizedToRead,\n        value: headerName,\n      })\n    }\n  }\n  return knownHeaderNames.length > 0 ? knownHeaderNames : undefined\n}\n\nfunction isDownloadClientUnauthorizedToReadMarker(\n  headerName: string,\n): headerName is DownloadClientUnauthorizedToReadMarker {\n  return Object.values(DownloadClientUnauthorizedToReadMarker).includes(\n    headerName as DownloadClientUnauthorizedToReadMarker,\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"single.cjs","names":[],"sources":["../../src/download/single.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { parseFileInfoHeaders } from '../raw/encoding.ts'\nimport type { DownloadFileOptions, RawClient, SseCDownloadKey } from '../raw/index.ts'\nimport { type ProgressListener, ProgressTracker } from '../streams/progress.ts'\nimport {\n  DownloadClientUnauthorizedToReadMarker,\n  DownloadHeaderName,\n  type DownloadHeaderParseIssue,\n  type DownloadHeaders,\n  type DownloadServerSideEncryption,\n} from '../types/download.ts'\nimport { EncryptionAlgorithm, EncryptionMode } from '../types/encryption.ts'\nimport { type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { type FileRetentionValue, LegalHoldValue, RetentionMode } from '../types/lock.ts'\nimport { bestEffort } from '../util/best-effort.ts'\nimport { normalizeSha1 } from '../util/normalize.ts'\nimport { verifyDownloadStream } from './checksum.ts'\n\n/** Result of a single-request file download. */\nexport interface DownloadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n  /**\n   * Streaming body of the downloaded file.\n   *\n   * If checksum verification fails, the stream errors after bytes have already\n   * flowed; discard any partially written output on `ChecksumMismatchError`.\n   */\n  readonly body: ReadableStream<Uint8Array>\n}\n\n/**\n * Result of a HEAD-style metadata fetch. Unlike {@link DownloadResult},\n * this shape has **no** `body` field — the SDK consumes and discards the\n * (logically empty) HEAD response body internally so callers never have\n * to remember to `body.cancel()` after a metadata-only fetch.\n */\nexport interface HeadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n}\n\n/** Shared download options exposed at the high-level facade. */\ninterface DownloadCommonOptions {\n  /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only response headers without streaming the body. */\n  readonly method?: 'GET' | 'HEAD'\n  /** Optional HTTP Range header value (e.g. `bytes=0-999`). */\n  readonly range?: string\n  /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n  readonly serverSideEncryption?: SseCDownloadKey\n  /** Override the response `Content-Disposition` header. */\n  readonly b2ContentDisposition?: string\n  /** Override the response `Content-Language` header. */\n  readonly b2ContentLanguage?: string\n  /** Override the response `Content-Encoding` header. */\n  readonly b2ContentEncoding?: string\n  /** Override the response `Content-Type` header. */\n  readonly b2ContentType?: string\n  /** Override the response `Cache-Control` header. */\n  readonly b2CacheControl?: string\n  /** Override the response `Expires` header. */\n  readonly b2Expires?: string\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n  /**\n   * Callback invoked as bytes flow through the returned `body` stream.\n   *\n   * Wraps the response body so the SDK increments a `ProgressTracker` per\n   * chunk and emits a `partsCompleted: 1` event when the stream finishes.\n   * `totalBytes` is the response's `Content-Length`\n   * header (or `null` if the server didn't send one — rare for B2).\n   *\n   * If the caller does not read the returned body to completion, the\n   * tracker's `completePart()` event will not fire. That is intentional:\n   * progress is byte-driven, not request-driven.\n   */\n  readonly onProgress?: ProgressListener\n  /**\n   * Minimum milliseconds between byte-only progress callbacks. Defaults to\n   * the SDK's 100 ms progress interval; set to 0 for per-chunk callbacks.\n   * The final completion callback is always emitted immediately.\n   */\n  readonly progressIntervalMillis?: number\n}\n\n/** Options for downloading a file by its unique ID. */\nexport interface DownloadByIdOptions extends DownloadCommonOptions {\n  /** ID of the file version to download. */\n  readonly fileId: FileId\n}\n\n/** Options for downloading a file by bucket name and file path. */\nexport interface DownloadByNameOptions extends DownloadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits\n * `method` (always HEAD) and `onProgress` (no body to track).\n */\ntype HeadCommonOptions = Omit<\n  DownloadCommonOptions,\n  'method' | 'onProgress' | 'progressIntervalMillis'\n>\n\n/** Options for a HEAD-by-ID request. */\nexport interface HeadByIdOptions extends HeadCommonOptions {\n  /** ID of the file version to inspect. */\n  readonly fileId: FileId\n}\n\n/** Options for a HEAD-by-name request. */\nexport interface HeadByNameOptions extends HeadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Downloads a file by its unique ID in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByIdOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    // HEAD requests legitimately have no body; return an empty stream so the\n    // result shape stays consistent.\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Downloads a file by bucket name and file path in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByNameOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Issues a HEAD-by-ID request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadById({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (file ID + the same response-header\n *   overrides and abort signal that `downloadById` accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByIdOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  // Body for HEAD is normally `null` per the fetch spec. Some transports\n  // (notably the SDK's `B2Simulator`) synthesize a non-null body for\n  // shape consistency. In either case, cancelling is a no-op for the\n  // caller; wrap in `bestEffort` so a stream-lifecycle quirk in a\n  // future runtime can't fail an otherwise-successful HEAD.\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Issues a HEAD-by-name request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadByName({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (bucket + file name + the same\n *   response-header overrides and abort signal that `downloadByName`\n *   accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByNameOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Translates the public download-options shape into the raw client's\n * {@link DownloadFileOptions}, dropping the request-target fields (`fileId`,\n * `bucketName`, `fileName`) that don't apply at the transport layer.\n *\n * @param options - Caller-supplied download options.\n *\n * @returns The raw transport-layer options.\n */\nfunction toRawDownloadOptions(options: DownloadCommonOptions): DownloadFileOptions {\n  return {\n    ...(options.method !== undefined ? { method: options.method } : {}),\n    ...(options.range !== undefined ? { range: options.range } : {}),\n    ...(options.serverSideEncryption !== undefined\n      ? { serverSideEncryption: options.serverSideEncryption }\n      : {}),\n    ...(options.b2ContentDisposition !== undefined\n      ? { b2ContentDisposition: options.b2ContentDisposition }\n      : {}),\n    ...(options.b2ContentLanguage !== undefined\n      ? { b2ContentLanguage: options.b2ContentLanguage }\n      : {}),\n    ...(options.b2ContentEncoding !== undefined\n      ? { b2ContentEncoding: options.b2ContentEncoding }\n      : {}),\n    ...(options.b2ContentType !== undefined ? { b2ContentType: options.b2ContentType } : {}),\n    ...(options.b2CacheControl !== undefined ? { b2CacheControl: options.b2CacheControl } : {}),\n    ...(options.b2Expires !== undefined ? { b2Expires: options.b2Expires } : {}),\n    ...(options.signal !== undefined ? { signal: options.signal } : {}),\n  }\n}\n\n/**\n * Builds an immediately-closed empty ReadableStream. Used as the body of a\n * HEAD download response so callers always get a stream they can `pipeTo`.\n *\n * @returns A ReadableStream that yields zero bytes and immediately closes.\n */\nfunction emptyStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream({\n    start(controller) {\n      controller.close()\n    },\n  })\n}\n\n/**\n * Applies stream wrappers common to single-request downloads.\n *\n * Full-body GET downloads are checksum-verified when B2 supplies a real\n * whole-file SHA-1. HEAD requests and ranged GETs are skipped because the\n * response body is empty or partial while `X-Bz-Content-Sha1` describes the\n * full file version.\n *\n * @param body - Download response body.\n * @param headers - Parsed download headers.\n * @param options - Caller-supplied download options.\n *\n * @returns A stream wrapped for checksum verification and progress reporting.\n */\nfunction prepareDownloadBody(\n  body: ReadableStream<Uint8Array>,\n  headers: DownloadHeaders,\n  options: DownloadCommonOptions,\n): ReadableStream<Uint8Array> {\n  const shouldVerify = options.method !== 'HEAD' && options.range === undefined\n  const verifiedBody = shouldVerify ? verifyDownloadStream(body, headers.contentSha1) : body\n  return instrumentProgress(\n    verifiedBody,\n    headers.contentLength,\n    options.onProgress,\n    options.progressIntervalMillis,\n  )\n}\n\n/**\n * Wraps a body stream so the SDK increments a {@link ProgressTracker} for\n * each chunk and reports `partsCompleted: 1` when the stream finishes.\n *\n * When `listener` is undefined the function short-circuits and returns\n * the original stream, so unobserved downloads pay no overhead.\n *\n * @param body - The download response body to wrap.\n * @param totalBytes - Expected total bytes (response `Content-Length`).\n * @param listener - Caller-supplied progress callback, or undefined.\n * @param progressIntervalMillis - Optional byte-progress throttle interval.\n *\n * @returns A stream that emits the same bytes and reports progress.\n */\nfunction instrumentProgress(\n  body: ReadableStream<Uint8Array>,\n  totalBytes: number,\n  listener: ProgressListener | undefined,\n  progressIntervalMillis: number | undefined,\n): ReadableStream<Uint8Array> {\n  if (listener === undefined) return body\n  const tracker = new ProgressTracker(listener, totalBytes, 1, {\n    ...(progressIntervalMillis !== undefined ? { minIntervalMs: progressIntervalMillis } : {}),\n  })\n  const reader = body.getReader()\n  let released = false\n\n  function releaseReader(): void {\n    if (released) return\n    released = true\n    reader.releaseLock()\n  }\n\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await reader.read()\n        if (done) {\n          tracker.completePart()\n          tracker.dispose()\n          releaseReader()\n          controller.close()\n          return\n        }\n        tracker.addBytes(value.byteLength)\n        controller.enqueue(value)\n      } catch (err) {\n        tracker.dispose()\n        releaseReader()\n        throw err\n      }\n    },\n    async cancel(reason) {\n      tracker.dispose()\n      try {\n        await reader.cancel(reason)\n      } finally {\n        releaseReader()\n      }\n    },\n  })\n}\n\n/**\n * Extracts B2-specific download headers into a structured object.\n * @param headers - The HTTP response headers from the download.\n *\n * @returns The parsed download metadata.\n */\nfunction extractDownloadHeaders(headers: Headers): DownloadHeaders {\n  const headerParseIssues: DownloadHeaderParseIssue[] = []\n  const fileInfo = parseFileInfoHeaders(headers)\n  const clientUnauthorizedToRead = parseClientUnauthorizedToRead(headers, headerParseIssues)\n  const contentDisposition = optionalHeader(headers, DownloadHeaderName.ContentDisposition)\n  const contentLanguage = optionalHeader(headers, DownloadHeaderName.ContentLanguage)\n  const contentEncoding = optionalHeader(headers, DownloadHeaderName.ContentEncoding)\n  const cacheControl = optionalHeader(headers, DownloadHeaderName.CacheControl)\n  const expires = optionalHeader(headers, DownloadHeaderName.Expires)\n  const contentRange = optionalHeader(headers, DownloadHeaderName.ContentRange)\n  const serverSideEncryption = parseDownloadServerSideEncryption(headers, headerParseIssues)\n  const fileRetention = parseDownloadFileRetention(\n    headers,\n    clientUnauthorizedToRead,\n    headerParseIssues,\n  )\n  const legalHold = parseDownloadLegalHold(headers, clientUnauthorizedToRead, headerParseIssues)\n\n  return {\n    contentType: headers.get(DownloadHeaderName.ContentType) ?? 'application/octet-stream',\n    contentLength: Number.parseInt(headers.get(DownloadHeaderName.ContentLength) ?? '0', 10),\n    ...(contentDisposition !== undefined ? { contentDisposition } : {}),\n    ...(contentLanguage !== undefined ? { contentLanguage } : {}),\n    ...(contentEncoding !== undefined ? { contentEncoding } : {}),\n    ...(cacheControl !== undefined ? { cacheControl } : {}),\n    ...(expires !== undefined ? { expires } : {}),\n    ...(contentRange !== undefined ? { contentRange } : {}),\n    // B2 sends the literal `'none'` for multipart-finished files; collapse\n    // to `null` so the typed `string | null` actually means \"no SHA-1\".\n    contentSha1: normalizeSha1(headers.get(DownloadHeaderName.ContentSha1)),\n    fileId: fileIdOf(headers.get(DownloadHeaderName.FileId) ?? ''),\n    fileName: decodeURIComponent(headers.get(DownloadHeaderName.FileName) ?? ''),\n    fileInfo,\n    uploadTimestamp: Number.parseInt(headers.get(DownloadHeaderName.UploadTimestamp) ?? '0', 10),\n    ...(serverSideEncryption !== undefined ? { serverSideEncryption } : {}),\n    ...(fileRetention !== undefined ? { fileRetention } : {}),\n    ...(legalHold !== undefined ? { legalHold } : {}),\n    ...(clientUnauthorizedToRead !== undefined ? { clientUnauthorizedToRead } : {}),\n    ...(headerParseIssues.length > 0 ? { headerParseIssues } : {}),\n  }\n}\n\nfunction optionalHeader(headers: Headers, name: string): string | undefined {\n  return headers.get(name) ?? undefined\n}\n\nfunction parseDownloadServerSideEncryption(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadServerSideEncryption | undefined {\n  const managedAlgorithm = optionalHeader(headers, DownloadHeaderName.ServerSideEncryption)\n  if (managedAlgorithm !== undefined) {\n    if (managedAlgorithm !== EncryptionAlgorithm.Aes256) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ServerSideEncryption,\n        value: managedAlgorithm,\n      })\n      return undefined\n    }\n    return { mode: EncryptionMode.SseB2, algorithm: managedAlgorithm }\n  }\n\n  const customerAlgorithm = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n  )\n  const customerKeyMd5 = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerKeyMd5,\n  )\n  if (customerAlgorithm === undefined || customerKeyMd5 === undefined) return undefined\n  if (customerAlgorithm !== EncryptionAlgorithm.Aes256) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n      value: customerAlgorithm,\n    })\n    return undefined\n  }\n  return { mode: EncryptionMode.SseC, algorithm: customerAlgorithm, customerKeyMd5 }\n}\n\nfunction parseDownloadFileRetention(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['fileRetention'] {\n  if (\n    clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileRetentionMode) ===\n      true ||\n    clientUnauthorizedToRead?.includes(\n      DownloadClientUnauthorizedToReadMarker.FileRetentionRetainUntilTimestamp,\n    ) === true\n  ) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawMode = optionalHeader(headers, DownloadHeaderName.FileRetentionMode)\n  const rawRetainUntilTimestamp = optionalHeader(\n    headers,\n    DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n  )\n  if (rawMode === undefined && rawRetainUntilTimestamp === undefined) return undefined\n  return {\n    isClientAuthorizedToRead: true,\n    value: {\n      mode: parseRetentionMode(rawMode, headerParseIssues),\n      retainUntilTimestamp: parseRetentionTimestamp(rawRetainUntilTimestamp, headerParseIssues),\n    },\n  }\n}\n\nfunction parseRetentionMode(\n  rawMode: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): FileRetentionValue['mode'] {\n  if (rawMode === undefined) return null\n  if (rawMode === RetentionMode.Compliance || rawMode === RetentionMode.Governance) {\n    return rawMode\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileRetentionMode, value: rawMode })\n  return null\n}\n\nfunction parseRetentionTimestamp(\n  rawTimestamp: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): number | null {\n  if (rawTimestamp === undefined) return null\n  if (!/^\\d+$/.test(rawTimestamp)) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n      value: rawTimestamp,\n    })\n    return null\n  }\n  const parsed = Number.parseInt(rawTimestamp, 10)\n  if (Number.isFinite(parsed)) return parsed\n  headerParseIssues.push({\n    headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n    value: rawTimestamp,\n  })\n  return null\n}\n\nfunction parseDownloadLegalHold(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['legalHold'] {\n  if (clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileLegalHold)) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawLegalHold = optionalHeader(headers, DownloadHeaderName.FileLegalHold)\n  if (rawLegalHold === undefined) return undefined\n  if (rawLegalHold === LegalHoldValue.On || rawLegalHold === LegalHoldValue.Off) {\n    return { isClientAuthorizedToRead: true, value: rawLegalHold }\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileLegalHold, value: rawLegalHold })\n  return { isClientAuthorizedToRead: true, value: null }\n}\n\nfunction parseClientUnauthorizedToRead(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['clientUnauthorizedToRead'] {\n  const value = optionalHeader(headers, DownloadHeaderName.ClientUnauthorizedToRead)\n  if (value === undefined) return undefined\n  const headerNames = value\n    .split(',')\n    .map((header) => header.trim())\n    .filter((header) => header.length > 0)\n  const knownHeaderNames = headerNames.filter(isDownloadClientUnauthorizedToReadMarker)\n  for (const headerName of headerNames) {\n    if (!isDownloadClientUnauthorizedToReadMarker(headerName)) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ClientUnauthorizedToRead,\n        value: headerName,\n      })\n    }\n  }\n  return knownHeaderNames.length > 0 ? knownHeaderNames : undefined\n}\n\nfunction isDownloadClientUnauthorizedToReadMarker(\n  headerName: string,\n): headerName is DownloadClientUnauthorizedToReadMarker {\n  return Object.values(DownloadClientUnauthorizedToReadMarker).includes(\n    headerName as DownloadClientUnauthorizedToReadMarker,\n  )\n}\n"],"mappings":"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"}

package/dist/download/single.d.cts

@@ -50,9 +50,9 @@ interface DownloadCommonOptions {
     /**
      * Callback invoked as bytes flow through the returned `body` stream.
      *
-     * Wraps the response body in a `TransformStream` that increments a
-     * `ProgressTracker` per chunk and emits a `partsCompleted: 1` event when
-     * the stream finishes. `totalBytes` is the response's `Content-Length`
+     * Wraps the response body so the SDK increments a `ProgressTracker` per
+     * chunk and emits a `partsCompleted: 1` event when the stream finishes.
+     * `totalBytes` is the response's `Content-Length`
      * header (or `null` if the server didn't send one — rare for B2).
      *
      * If the caller does not read the returned body to completion, the
@@ -60,6 +60,12 @@ interface DownloadCommonOptions {
      * progress is byte-driven, not request-driven.
      */
     readonly onProgress?: ProgressListener;
+    /**
+     * Minimum milliseconds between byte-only progress callbacks. Defaults to
+     * the SDK's 100 ms progress interval; set to 0 for per-chunk callbacks.
+     * The final completion callback is always emitted immediately.
+     */
+    readonly progressIntervalMillis?: number;
 }
 /** Options for downloading a file by its unique ID. */
 export interface DownloadByIdOptions extends DownloadCommonOptions {
@@ -77,7 +83,7 @@ export interface DownloadByNameOptions extends DownloadCommonOptions {
  * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits
  * `method` (always HEAD) and `onProgress` (no body to track).
  */
-type HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress'>;
+type HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress' | 'progressIntervalMillis'>;
 /** Options for a HEAD-by-ID request. */
 export interface HeadByIdOptions extends HeadCommonOptions {
     /** ID of the file version to inspect. */

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

@@ -1 +1 @@
-{"version":3,"file":"single.d.ts","sourceRoot":"","sources":["../../src/download/single.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"single.d.ts","sourceRoot":"","sources":["../../src/download/single.js"],"names":[],"mappings":"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"}

package/dist/download/single.d.ts

@@ -50,9 +50,9 @@ interface DownloadCommonOptions {
     /**
      * Callback invoked as bytes flow through the returned `body` stream.
      *
-     * Wraps the response body in a `TransformStream` that increments a
-     * `ProgressTracker` per chunk and emits a `partsCompleted: 1` event when
-     * the stream finishes. `totalBytes` is the response's `Content-Length`
+     * Wraps the response body so the SDK increments a `ProgressTracker` per
+     * chunk and emits a `partsCompleted: 1` event when the stream finishes.
+     * `totalBytes` is the response's `Content-Length`
      * header (or `null` if the server didn't send one — rare for B2).
      *
      * If the caller does not read the returned body to completion, the
@@ -60,6 +60,12 @@ interface DownloadCommonOptions {
      * progress is byte-driven, not request-driven.
      */
     readonly onProgress?: ProgressListener;
+    /**
+     * Minimum milliseconds between byte-only progress callbacks. Defaults to
+     * the SDK's 100 ms progress interval; set to 0 for per-chunk callbacks.
+     * The final completion callback is always emitted immediately.
+     */
+    readonly progressIntervalMillis?: number;
 }
 /** Options for downloading a file by its unique ID. */
 export interface DownloadByIdOptions extends DownloadCommonOptions {
@@ -77,7 +83,7 @@ export interface DownloadByNameOptions extends DownloadCommonOptions {
  * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits
  * `method` (always HEAD) and `onProgress` (no body to track).
  */
-type HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress'>;
+type HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress' | 'progressIntervalMillis'>;
 /** Options for a HEAD-by-ID request. */
 export interface HeadByIdOptions extends HeadCommonOptions {
     /** ID of the file version to inspect. */

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

@@ -1 +1 @@
-{"version":3,"file":"single.d.ts","sourceRoot":"","sources":["../../src/download/single.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"single.d.ts","sourceRoot":"","sources":["../../src/download/single.js"],"names":[],"mappings":"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"}

package/dist/download/single.js

@@ -154,12 +154,11 @@ function emptyStream() {
 * @returns A stream wrapped for checksum verification and progress reporting.
 */
 function prepareDownloadBody(body, headers, options) {
-	return instrumentProgress(options.method !== "HEAD" && options.range === void 0 ? verifyDownloadStream(body, headers.contentSha1) : body, headers.contentLength, options.onProgress);
+	return instrumentProgress(options.method !== "HEAD" && options.range === void 0 ? verifyDownloadStream(body, headers.contentSha1) : body, headers.contentLength, options.onProgress, options.progressIntervalMillis);
 }
 /**
-* Wraps a body stream with a `TransformStream` that increments a
-* {@link ProgressTracker} for each chunk and reports `partsCompleted: 1`
-* when the stream finishes.
+* Wraps a body stream so the SDK increments a {@link ProgressTracker} for
+* each chunk and reports `partsCompleted: 1` when the stream finishes.
 *
 * When `listener` is undefined the function short-circuits and returns
 * the original stream, so unobserved downloads pay no overhead.
@@ -167,22 +166,48 @@ function prepareDownloadBody(body, headers, options) {
 * @param body - The download response body to wrap.
 * @param totalBytes - Expected total bytes (response `Content-Length`).
 * @param listener - Caller-supplied progress callback, or undefined.
+* @param progressIntervalMillis - Optional byte-progress throttle interval.
 *
 * @returns A stream that emits the same bytes and reports progress.
 */
-function instrumentProgress(body, totalBytes, listener) {
+function instrumentProgress(body, totalBytes, listener, progressIntervalMillis) {
 	if (listener === void 0) return body;
-	const tracker = new ProgressTracker(listener, totalBytes, 1);
-	const transform = new TransformStream({
-		transform(chunk, controller) {
-			tracker.addBytes(chunk.byteLength);
-			controller.enqueue(chunk);
+	const tracker = new ProgressTracker(listener, totalBytes, 1, { ...progressIntervalMillis !== void 0 ? { minIntervalMs: progressIntervalMillis } : {} });
+	const reader = body.getReader();
+	let released = false;
+	function releaseReader() {
+		if (released) return;
+		released = true;
+		reader.releaseLock();
+	}
+	return new ReadableStream({
+		async pull(controller) {
+			try {
+				const { done, value } = await reader.read();
+				if (done) {
+					tracker.completePart();
+					tracker.dispose();
+					releaseReader();
+					controller.close();
+					return;
+				}
+				tracker.addBytes(value.byteLength);
+				controller.enqueue(value);
+			} catch (err) {
+				tracker.dispose();
+				releaseReader();
+				throw err;
+			}
 		},
-		flush() {
-			tracker.completePart();
+		async cancel(reason) {
+			tracker.dispose();
+			try {
+				await reader.cancel(reason);
+			} finally {
+				releaseReader();
+			}
 		}
 	});
-	return body.pipeThrough(transform);
 }
 /**
 * Extracts B2-specific download headers into a structured object.

package/dist/download/single.js.map

@@ -1 +1 @@
-{"version":3,"file":"single.js","names":[],"sources":["../../src/download/single.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { parseFileInfoHeaders } from '../raw/encoding.ts'\nimport type { DownloadFileOptions, RawClient, SseCDownloadKey } from '../raw/index.ts'\nimport { type ProgressListener, ProgressTracker } from '../streams/progress.ts'\nimport {\n  DownloadClientUnauthorizedToReadMarker,\n  DownloadHeaderName,\n  type DownloadHeaderParseIssue,\n  type DownloadHeaders,\n  type DownloadServerSideEncryption,\n} from '../types/download.ts'\nimport { EncryptionAlgorithm, EncryptionMode } from '../types/encryption.ts'\nimport { type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { type FileRetentionValue, LegalHoldValue, RetentionMode } from '../types/lock.ts'\nimport { bestEffort } from '../util/best-effort.ts'\nimport { normalizeSha1 } from '../util/normalize.ts'\nimport { verifyDownloadStream } from './checksum.ts'\n\n/** Result of a single-request file download. */\nexport interface DownloadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n  /**\n   * Streaming body of the downloaded file.\n   *\n   * If checksum verification fails, the stream errors after bytes have already\n   * flowed; discard any partially written output on `ChecksumMismatchError`.\n   */\n  readonly body: ReadableStream<Uint8Array>\n}\n\n/**\n * Result of a HEAD-style metadata fetch. Unlike {@link DownloadResult},\n * this shape has **no** `body` field — the SDK consumes and discards the\n * (logically empty) HEAD response body internally so callers never have\n * to remember to `body.cancel()` after a metadata-only fetch.\n */\nexport interface HeadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n}\n\n/** Shared download options exposed at the high-level facade. */\ninterface DownloadCommonOptions {\n  /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only response headers without streaming the body. */\n  readonly method?: 'GET' | 'HEAD'\n  /** Optional HTTP Range header value (e.g. `bytes=0-999`). */\n  readonly range?: string\n  /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n  readonly serverSideEncryption?: SseCDownloadKey\n  /** Override the response `Content-Disposition` header. */\n  readonly b2ContentDisposition?: string\n  /** Override the response `Content-Language` header. */\n  readonly b2ContentLanguage?: string\n  /** Override the response `Content-Encoding` header. */\n  readonly b2ContentEncoding?: string\n  /** Override the response `Content-Type` header. */\n  readonly b2ContentType?: string\n  /** Override the response `Cache-Control` header. */\n  readonly b2CacheControl?: string\n  /** Override the response `Expires` header. */\n  readonly b2Expires?: string\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n  /**\n   * Callback invoked as bytes flow through the returned `body` stream.\n   *\n   * Wraps the response body in a `TransformStream` that increments a\n   * `ProgressTracker` per chunk and emits a `partsCompleted: 1` event when\n   * the stream finishes. `totalBytes` is the response's `Content-Length`\n   * header (or `null` if the server didn't send one — rare for B2).\n   *\n   * If the caller does not read the returned body to completion, the\n   * tracker's `completePart()` event will not fire. That is intentional:\n   * progress is byte-driven, not request-driven.\n   */\n  readonly onProgress?: ProgressListener\n}\n\n/** Options for downloading a file by its unique ID. */\nexport interface DownloadByIdOptions extends DownloadCommonOptions {\n  /** ID of the file version to download. */\n  readonly fileId: FileId\n}\n\n/** Options for downloading a file by bucket name and file path. */\nexport interface DownloadByNameOptions extends DownloadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits\n * `method` (always HEAD) and `onProgress` (no body to track).\n */\ntype HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress'>\n\n/** Options for a HEAD-by-ID request. */\nexport interface HeadByIdOptions extends HeadCommonOptions {\n  /** ID of the file version to inspect. */\n  readonly fileId: FileId\n}\n\n/** Options for a HEAD-by-name request. */\nexport interface HeadByNameOptions extends HeadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Downloads a file by its unique ID in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByIdOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    // HEAD requests legitimately have no body; return an empty stream so the\n    // result shape stays consistent.\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Downloads a file by bucket name and file path in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByNameOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Issues a HEAD-by-ID request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadById({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (file ID + the same response-header\n *   overrides and abort signal that `downloadById` accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByIdOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  // Body for HEAD is normally `null` per the fetch spec. Some transports\n  // (notably the SDK's `B2Simulator`) synthesize a non-null body for\n  // shape consistency. In either case, cancelling is a no-op for the\n  // caller; wrap in `bestEffort` so a stream-lifecycle quirk in a\n  // future runtime can't fail an otherwise-successful HEAD.\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Issues a HEAD-by-name request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadByName({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (bucket + file name + the same\n *   response-header overrides and abort signal that `downloadByName`\n *   accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByNameOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Translates the public download-options shape into the raw client's\n * {@link DownloadFileOptions}, dropping the request-target fields (`fileId`,\n * `bucketName`, `fileName`) that don't apply at the transport layer.\n *\n * @param options - Caller-supplied download options.\n *\n * @returns The raw transport-layer options.\n */\nfunction toRawDownloadOptions(options: DownloadCommonOptions): DownloadFileOptions {\n  return {\n    ...(options.method !== undefined ? { method: options.method } : {}),\n    ...(options.range !== undefined ? { range: options.range } : {}),\n    ...(options.serverSideEncryption !== undefined\n      ? { serverSideEncryption: options.serverSideEncryption }\n      : {}),\n    ...(options.b2ContentDisposition !== undefined\n      ? { b2ContentDisposition: options.b2ContentDisposition }\n      : {}),\n    ...(options.b2ContentLanguage !== undefined\n      ? { b2ContentLanguage: options.b2ContentLanguage }\n      : {}),\n    ...(options.b2ContentEncoding !== undefined\n      ? { b2ContentEncoding: options.b2ContentEncoding }\n      : {}),\n    ...(options.b2ContentType !== undefined ? { b2ContentType: options.b2ContentType } : {}),\n    ...(options.b2CacheControl !== undefined ? { b2CacheControl: options.b2CacheControl } : {}),\n    ...(options.b2Expires !== undefined ? { b2Expires: options.b2Expires } : {}),\n    ...(options.signal !== undefined ? { signal: options.signal } : {}),\n  }\n}\n\n/**\n * Builds an immediately-closed empty ReadableStream. Used as the body of a\n * HEAD download response so callers always get a stream they can `pipeTo`.\n *\n * @returns A ReadableStream that yields zero bytes and immediately closes.\n */\nfunction emptyStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream({\n    start(controller) {\n      controller.close()\n    },\n  })\n}\n\n/**\n * Applies stream wrappers common to single-request downloads.\n *\n * Full-body GET downloads are checksum-verified when B2 supplies a real\n * whole-file SHA-1. HEAD requests and ranged GETs are skipped because the\n * response body is empty or partial while `X-Bz-Content-Sha1` describes the\n * full file version.\n *\n * @param body - Download response body.\n * @param headers - Parsed download headers.\n * @param options - Caller-supplied download options.\n *\n * @returns A stream wrapped for checksum verification and progress reporting.\n */\nfunction prepareDownloadBody(\n  body: ReadableStream<Uint8Array>,\n  headers: DownloadHeaders,\n  options: DownloadCommonOptions,\n): ReadableStream<Uint8Array> {\n  const shouldVerify = options.method !== 'HEAD' && options.range === undefined\n  const verifiedBody = shouldVerify ? verifyDownloadStream(body, headers.contentSha1) : body\n  return instrumentProgress(verifiedBody, headers.contentLength, options.onProgress)\n}\n\n/**\n * Wraps a body stream with a `TransformStream` that increments a\n * {@link ProgressTracker} for each chunk and reports `partsCompleted: 1`\n * when the stream finishes.\n *\n * When `listener` is undefined the function short-circuits and returns\n * the original stream, so unobserved downloads pay no overhead.\n *\n * @param body - The download response body to wrap.\n * @param totalBytes - Expected total bytes (response `Content-Length`).\n * @param listener - Caller-supplied progress callback, or undefined.\n *\n * @returns A stream that emits the same bytes and reports progress.\n */\nfunction instrumentProgress(\n  body: ReadableStream<Uint8Array>,\n  totalBytes: number,\n  listener: ProgressListener | undefined,\n): ReadableStream<Uint8Array> {\n  if (listener === undefined) return body\n  const tracker = new ProgressTracker(listener, totalBytes, 1)\n  const transform = new TransformStream<Uint8Array, Uint8Array>({\n    transform(chunk, controller) {\n      tracker.addBytes(chunk.byteLength)\n      controller.enqueue(chunk)\n    },\n    flush() {\n      tracker.completePart()\n    },\n  })\n  return body.pipeThrough(transform)\n}\n\n/**\n * Extracts B2-specific download headers into a structured object.\n * @param headers - The HTTP response headers from the download.\n *\n * @returns The parsed download metadata.\n */\nfunction extractDownloadHeaders(headers: Headers): DownloadHeaders {\n  const headerParseIssues: DownloadHeaderParseIssue[] = []\n  const fileInfo = parseFileInfoHeaders(headers)\n  const clientUnauthorizedToRead = parseClientUnauthorizedToRead(headers, headerParseIssues)\n  const contentDisposition = optionalHeader(headers, DownloadHeaderName.ContentDisposition)\n  const contentLanguage = optionalHeader(headers, DownloadHeaderName.ContentLanguage)\n  const contentEncoding = optionalHeader(headers, DownloadHeaderName.ContentEncoding)\n  const cacheControl = optionalHeader(headers, DownloadHeaderName.CacheControl)\n  const expires = optionalHeader(headers, DownloadHeaderName.Expires)\n  const contentRange = optionalHeader(headers, DownloadHeaderName.ContentRange)\n  const serverSideEncryption = parseDownloadServerSideEncryption(headers, headerParseIssues)\n  const fileRetention = parseDownloadFileRetention(\n    headers,\n    clientUnauthorizedToRead,\n    headerParseIssues,\n  )\n  const legalHold = parseDownloadLegalHold(headers, clientUnauthorizedToRead, headerParseIssues)\n\n  return {\n    contentType: headers.get(DownloadHeaderName.ContentType) ?? 'application/octet-stream',\n    contentLength: Number.parseInt(headers.get(DownloadHeaderName.ContentLength) ?? '0', 10),\n    ...(contentDisposition !== undefined ? { contentDisposition } : {}),\n    ...(contentLanguage !== undefined ? { contentLanguage } : {}),\n    ...(contentEncoding !== undefined ? { contentEncoding } : {}),\n    ...(cacheControl !== undefined ? { cacheControl } : {}),\n    ...(expires !== undefined ? { expires } : {}),\n    ...(contentRange !== undefined ? { contentRange } : {}),\n    // B2 sends the literal `'none'` for multipart-finished files; collapse\n    // to `null` so the typed `string | null` actually means \"no SHA-1\".\n    contentSha1: normalizeSha1(headers.get(DownloadHeaderName.ContentSha1)),\n    fileId: fileIdOf(headers.get(DownloadHeaderName.FileId) ?? ''),\n    fileName: decodeURIComponent(headers.get(DownloadHeaderName.FileName) ?? ''),\n    fileInfo,\n    uploadTimestamp: Number.parseInt(headers.get(DownloadHeaderName.UploadTimestamp) ?? '0', 10),\n    ...(serverSideEncryption !== undefined ? { serverSideEncryption } : {}),\n    ...(fileRetention !== undefined ? { fileRetention } : {}),\n    ...(legalHold !== undefined ? { legalHold } : {}),\n    ...(clientUnauthorizedToRead !== undefined ? { clientUnauthorizedToRead } : {}),\n    ...(headerParseIssues.length > 0 ? { headerParseIssues } : {}),\n  }\n}\n\nfunction optionalHeader(headers: Headers, name: string): string | undefined {\n  return headers.get(name) ?? undefined\n}\n\nfunction parseDownloadServerSideEncryption(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadServerSideEncryption | undefined {\n  const managedAlgorithm = optionalHeader(headers, DownloadHeaderName.ServerSideEncryption)\n  if (managedAlgorithm !== undefined) {\n    if (managedAlgorithm !== EncryptionAlgorithm.Aes256) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ServerSideEncryption,\n        value: managedAlgorithm,\n      })\n      return undefined\n    }\n    return { mode: EncryptionMode.SseB2, algorithm: managedAlgorithm }\n  }\n\n  const customerAlgorithm = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n  )\n  const customerKeyMd5 = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerKeyMd5,\n  )\n  if (customerAlgorithm === undefined || customerKeyMd5 === undefined) return undefined\n  if (customerAlgorithm !== EncryptionAlgorithm.Aes256) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n      value: customerAlgorithm,\n    })\n    return undefined\n  }\n  return { mode: EncryptionMode.SseC, algorithm: customerAlgorithm, customerKeyMd5 }\n}\n\nfunction parseDownloadFileRetention(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['fileRetention'] {\n  if (\n    clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileRetentionMode) ===\n      true ||\n    clientUnauthorizedToRead?.includes(\n      DownloadClientUnauthorizedToReadMarker.FileRetentionRetainUntilTimestamp,\n    ) === true\n  ) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawMode = optionalHeader(headers, DownloadHeaderName.FileRetentionMode)\n  const rawRetainUntilTimestamp = optionalHeader(\n    headers,\n    DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n  )\n  if (rawMode === undefined && rawRetainUntilTimestamp === undefined) return undefined\n  return {\n    isClientAuthorizedToRead: true,\n    value: {\n      mode: parseRetentionMode(rawMode, headerParseIssues),\n      retainUntilTimestamp: parseRetentionTimestamp(rawRetainUntilTimestamp, headerParseIssues),\n    },\n  }\n}\n\nfunction parseRetentionMode(\n  rawMode: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): FileRetentionValue['mode'] {\n  if (rawMode === undefined) return null\n  if (rawMode === RetentionMode.Compliance || rawMode === RetentionMode.Governance) {\n    return rawMode\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileRetentionMode, value: rawMode })\n  return null\n}\n\nfunction parseRetentionTimestamp(\n  rawTimestamp: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): number | null {\n  if (rawTimestamp === undefined) return null\n  if (!/^\\d+$/.test(rawTimestamp)) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n      value: rawTimestamp,\n    })\n    return null\n  }\n  const parsed = Number.parseInt(rawTimestamp, 10)\n  if (Number.isFinite(parsed)) return parsed\n  headerParseIssues.push({\n    headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n    value: rawTimestamp,\n  })\n  return null\n}\n\nfunction parseDownloadLegalHold(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['legalHold'] {\n  if (clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileLegalHold)) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawLegalHold = optionalHeader(headers, DownloadHeaderName.FileLegalHold)\n  if (rawLegalHold === undefined) return undefined\n  if (rawLegalHold === LegalHoldValue.On || rawLegalHold === LegalHoldValue.Off) {\n    return { isClientAuthorizedToRead: true, value: rawLegalHold }\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileLegalHold, value: rawLegalHold })\n  return { isClientAuthorizedToRead: true, value: null }\n}\n\nfunction parseClientUnauthorizedToRead(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['clientUnauthorizedToRead'] {\n  const value = optionalHeader(headers, DownloadHeaderName.ClientUnauthorizedToRead)\n  if (value === undefined) return undefined\n  const headerNames = value\n    .split(',')\n    .map((header) => header.trim())\n    .filter((header) => header.length > 0)\n  const knownHeaderNames = headerNames.filter(isDownloadClientUnauthorizedToReadMarker)\n  for (const headerName of headerNames) {\n    if (!isDownloadClientUnauthorizedToReadMarker(headerName)) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ClientUnauthorizedToRead,\n        value: headerName,\n      })\n    }\n  }\n  return knownHeaderNames.length > 0 ? knownHeaderNames : undefined\n}\n\nfunction isDownloadClientUnauthorizedToReadMarker(\n  headerName: string,\n): headerName is DownloadClientUnauthorizedToReadMarker {\n  return Object.values(DownloadClientUnauthorizedToReadMarker).includes(\n    headerName as DownloadClientUnauthorizedToReadMarker,\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"single.js","names":[],"sources":["../../src/download/single.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { parseFileInfoHeaders } from '../raw/encoding.ts'\nimport type { DownloadFileOptions, RawClient, SseCDownloadKey } from '../raw/index.ts'\nimport { type ProgressListener, ProgressTracker } from '../streams/progress.ts'\nimport {\n  DownloadClientUnauthorizedToReadMarker,\n  DownloadHeaderName,\n  type DownloadHeaderParseIssue,\n  type DownloadHeaders,\n  type DownloadServerSideEncryption,\n} from '../types/download.ts'\nimport { EncryptionAlgorithm, EncryptionMode } from '../types/encryption.ts'\nimport { type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { type FileRetentionValue, LegalHoldValue, RetentionMode } from '../types/lock.ts'\nimport { bestEffort } from '../util/best-effort.ts'\nimport { normalizeSha1 } from '../util/normalize.ts'\nimport { verifyDownloadStream } from './checksum.ts'\n\n/** Result of a single-request file download. */\nexport interface DownloadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n  /**\n   * Streaming body of the downloaded file.\n   *\n   * If checksum verification fails, the stream errors after bytes have already\n   * flowed; discard any partially written output on `ChecksumMismatchError`.\n   */\n  readonly body: ReadableStream<Uint8Array>\n}\n\n/**\n * Result of a HEAD-style metadata fetch. Unlike {@link DownloadResult},\n * this shape has **no** `body` field — the SDK consumes and discards the\n * (logically empty) HEAD response body internally so callers never have\n * to remember to `body.cancel()` after a metadata-only fetch.\n */\nexport interface HeadResult {\n  /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */\n  readonly headers: DownloadHeaders\n}\n\n/** Shared download options exposed at the high-level facade. */\ninterface DownloadCommonOptions {\n  /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only response headers without streaming the body. */\n  readonly method?: 'GET' | 'HEAD'\n  /** Optional HTTP Range header value (e.g. `bytes=0-999`). */\n  readonly range?: string\n  /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n  readonly serverSideEncryption?: SseCDownloadKey\n  /** Override the response `Content-Disposition` header. */\n  readonly b2ContentDisposition?: string\n  /** Override the response `Content-Language` header. */\n  readonly b2ContentLanguage?: string\n  /** Override the response `Content-Encoding` header. */\n  readonly b2ContentEncoding?: string\n  /** Override the response `Content-Type` header. */\n  readonly b2ContentType?: string\n  /** Override the response `Cache-Control` header. */\n  readonly b2CacheControl?: string\n  /** Override the response `Expires` header. */\n  readonly b2Expires?: string\n  /** Signal to abort the download. */\n  readonly signal?: AbortSignal\n  /**\n   * Callback invoked as bytes flow through the returned `body` stream.\n   *\n   * Wraps the response body so the SDK increments a `ProgressTracker` per\n   * chunk and emits a `partsCompleted: 1` event when the stream finishes.\n   * `totalBytes` is the response's `Content-Length`\n   * header (or `null` if the server didn't send one — rare for B2).\n   *\n   * If the caller does not read the returned body to completion, the\n   * tracker's `completePart()` event will not fire. That is intentional:\n   * progress is byte-driven, not request-driven.\n   */\n  readonly onProgress?: ProgressListener\n  /**\n   * Minimum milliseconds between byte-only progress callbacks. Defaults to\n   * the SDK's 100 ms progress interval; set to 0 for per-chunk callbacks.\n   * The final completion callback is always emitted immediately.\n   */\n  readonly progressIntervalMillis?: number\n}\n\n/** Options for downloading a file by its unique ID. */\nexport interface DownloadByIdOptions extends DownloadCommonOptions {\n  /** ID of the file version to download. */\n  readonly fileId: FileId\n}\n\n/** Options for downloading a file by bucket name and file path. */\nexport interface DownloadByNameOptions extends DownloadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits\n * `method` (always HEAD) and `onProgress` (no body to track).\n */\ntype HeadCommonOptions = Omit<\n  DownloadCommonOptions,\n  'method' | 'onProgress' | 'progressIntervalMillis'\n>\n\n/** Options for a HEAD-by-ID request. */\nexport interface HeadByIdOptions extends HeadCommonOptions {\n  /** ID of the file version to inspect. */\n  readonly fileId: FileId\n}\n\n/** Options for a HEAD-by-name request. */\nexport interface HeadByNameOptions extends HeadCommonOptions {\n  /** Name of the bucket containing the file. */\n  readonly bucketName: string\n  /** Full file name (path) within the bucket. */\n  readonly fileName: string\n}\n\n/**\n * Downloads a file by its unique ID in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByIdOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    // HEAD requests legitimately have no body; return an empty stream so the\n    // result shape stays consistent.\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Downloads a file by bucket name and file path in a single HTTP request.\n *\n * Returns a streaming body suitable for small-to-medium files. For large files\n * that benefit from concurrent ranged fetches, use\n * {@link createParallelDownloadStream} instead.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - Download parameters.\n *\n * @returns Parsed headers and a readable stream of file bytes.\n */\nexport async function downloadByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: DownloadByNameOptions,\n): Promise<DownloadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    toRawDownloadOptions(options),\n  )\n\n  const headers = extractDownloadHeaders(resp.headers)\n  return {\n    headers,\n    body: prepareDownloadBody(resp.body ?? emptyStream(), headers, options),\n  }\n}\n\n/**\n * Issues a HEAD-by-ID request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadById({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (file ID + the same response-header\n *   overrides and abort signal that `downloadById` accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headById(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByIdOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileById(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.fileId,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  // Body for HEAD is normally `null` per the fetch spec. Some transports\n  // (notably the SDK's `B2Simulator`) synthesize a non-null body for\n  // shape consistency. In either case, cancelling is a no-op for the\n  // caller; wrap in `bestEffort` so a stream-lifecycle quirk in a\n  // future runtime can't fail an otherwise-successful HEAD.\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Issues a HEAD-by-name request and returns parsed headers only. Drains\n * the (logically empty) response body internally so callers don't have\n * to remember to `body.cancel()` themselves.\n *\n * Prefer this over `downloadByName({ method: 'HEAD' })` — same wire-level\n * effect, but the caller-facing result has no `body` field at all so\n * there's nothing to clean up.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - HEAD parameters (bucket + file name + the same\n *   response-header overrides and abort signal that `downloadByName`\n *   accepts).\n *\n * @returns Parsed download headers (no body field).\n */\nexport async function headByName(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: HeadByNameOptions,\n): Promise<HeadResult> {\n  const resp = await raw.downloadFileByName(\n    accountInfo.getDownloadUrl(),\n    accountInfo.getAuthToken(),\n    options.bucketName,\n    options.fileName,\n    { ...toRawDownloadOptions(options), method: 'HEAD' },\n  )\n  if (resp.body !== null) {\n    // Bind to a local so the type narrowing carries into the closure;\n    // bare `resp.body` in the lambda would re-broaden to `... | null`.\n    const body = resp.body\n    await bestEffort(() => body.cancel())\n  }\n  return { headers: extractDownloadHeaders(resp.headers) }\n}\n\n/**\n * Translates the public download-options shape into the raw client's\n * {@link DownloadFileOptions}, dropping the request-target fields (`fileId`,\n * `bucketName`, `fileName`) that don't apply at the transport layer.\n *\n * @param options - Caller-supplied download options.\n *\n * @returns The raw transport-layer options.\n */\nfunction toRawDownloadOptions(options: DownloadCommonOptions): DownloadFileOptions {\n  return {\n    ...(options.method !== undefined ? { method: options.method } : {}),\n    ...(options.range !== undefined ? { range: options.range } : {}),\n    ...(options.serverSideEncryption !== undefined\n      ? { serverSideEncryption: options.serverSideEncryption }\n      : {}),\n    ...(options.b2ContentDisposition !== undefined\n      ? { b2ContentDisposition: options.b2ContentDisposition }\n      : {}),\n    ...(options.b2ContentLanguage !== undefined\n      ? { b2ContentLanguage: options.b2ContentLanguage }\n      : {}),\n    ...(options.b2ContentEncoding !== undefined\n      ? { b2ContentEncoding: options.b2ContentEncoding }\n      : {}),\n    ...(options.b2ContentType !== undefined ? { b2ContentType: options.b2ContentType } : {}),\n    ...(options.b2CacheControl !== undefined ? { b2CacheControl: options.b2CacheControl } : {}),\n    ...(options.b2Expires !== undefined ? { b2Expires: options.b2Expires } : {}),\n    ...(options.signal !== undefined ? { signal: options.signal } : {}),\n  }\n}\n\n/**\n * Builds an immediately-closed empty ReadableStream. Used as the body of a\n * HEAD download response so callers always get a stream they can `pipeTo`.\n *\n * @returns A ReadableStream that yields zero bytes and immediately closes.\n */\nfunction emptyStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream({\n    start(controller) {\n      controller.close()\n    },\n  })\n}\n\n/**\n * Applies stream wrappers common to single-request downloads.\n *\n * Full-body GET downloads are checksum-verified when B2 supplies a real\n * whole-file SHA-1. HEAD requests and ranged GETs are skipped because the\n * response body is empty or partial while `X-Bz-Content-Sha1` describes the\n * full file version.\n *\n * @param body - Download response body.\n * @param headers - Parsed download headers.\n * @param options - Caller-supplied download options.\n *\n * @returns A stream wrapped for checksum verification and progress reporting.\n */\nfunction prepareDownloadBody(\n  body: ReadableStream<Uint8Array>,\n  headers: DownloadHeaders,\n  options: DownloadCommonOptions,\n): ReadableStream<Uint8Array> {\n  const shouldVerify = options.method !== 'HEAD' && options.range === undefined\n  const verifiedBody = shouldVerify ? verifyDownloadStream(body, headers.contentSha1) : body\n  return instrumentProgress(\n    verifiedBody,\n    headers.contentLength,\n    options.onProgress,\n    options.progressIntervalMillis,\n  )\n}\n\n/**\n * Wraps a body stream so the SDK increments a {@link ProgressTracker} for\n * each chunk and reports `partsCompleted: 1` when the stream finishes.\n *\n * When `listener` is undefined the function short-circuits and returns\n * the original stream, so unobserved downloads pay no overhead.\n *\n * @param body - The download response body to wrap.\n * @param totalBytes - Expected total bytes (response `Content-Length`).\n * @param listener - Caller-supplied progress callback, or undefined.\n * @param progressIntervalMillis - Optional byte-progress throttle interval.\n *\n * @returns A stream that emits the same bytes and reports progress.\n */\nfunction instrumentProgress(\n  body: ReadableStream<Uint8Array>,\n  totalBytes: number,\n  listener: ProgressListener | undefined,\n  progressIntervalMillis: number | undefined,\n): ReadableStream<Uint8Array> {\n  if (listener === undefined) return body\n  const tracker = new ProgressTracker(listener, totalBytes, 1, {\n    ...(progressIntervalMillis !== undefined ? { minIntervalMs: progressIntervalMillis } : {}),\n  })\n  const reader = body.getReader()\n  let released = false\n\n  function releaseReader(): void {\n    if (released) return\n    released = true\n    reader.releaseLock()\n  }\n\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await reader.read()\n        if (done) {\n          tracker.completePart()\n          tracker.dispose()\n          releaseReader()\n          controller.close()\n          return\n        }\n        tracker.addBytes(value.byteLength)\n        controller.enqueue(value)\n      } catch (err) {\n        tracker.dispose()\n        releaseReader()\n        throw err\n      }\n    },\n    async cancel(reason) {\n      tracker.dispose()\n      try {\n        await reader.cancel(reason)\n      } finally {\n        releaseReader()\n      }\n    },\n  })\n}\n\n/**\n * Extracts B2-specific download headers into a structured object.\n * @param headers - The HTTP response headers from the download.\n *\n * @returns The parsed download metadata.\n */\nfunction extractDownloadHeaders(headers: Headers): DownloadHeaders {\n  const headerParseIssues: DownloadHeaderParseIssue[] = []\n  const fileInfo = parseFileInfoHeaders(headers)\n  const clientUnauthorizedToRead = parseClientUnauthorizedToRead(headers, headerParseIssues)\n  const contentDisposition = optionalHeader(headers, DownloadHeaderName.ContentDisposition)\n  const contentLanguage = optionalHeader(headers, DownloadHeaderName.ContentLanguage)\n  const contentEncoding = optionalHeader(headers, DownloadHeaderName.ContentEncoding)\n  const cacheControl = optionalHeader(headers, DownloadHeaderName.CacheControl)\n  const expires = optionalHeader(headers, DownloadHeaderName.Expires)\n  const contentRange = optionalHeader(headers, DownloadHeaderName.ContentRange)\n  const serverSideEncryption = parseDownloadServerSideEncryption(headers, headerParseIssues)\n  const fileRetention = parseDownloadFileRetention(\n    headers,\n    clientUnauthorizedToRead,\n    headerParseIssues,\n  )\n  const legalHold = parseDownloadLegalHold(headers, clientUnauthorizedToRead, headerParseIssues)\n\n  return {\n    contentType: headers.get(DownloadHeaderName.ContentType) ?? 'application/octet-stream',\n    contentLength: Number.parseInt(headers.get(DownloadHeaderName.ContentLength) ?? '0', 10),\n    ...(contentDisposition !== undefined ? { contentDisposition } : {}),\n    ...(contentLanguage !== undefined ? { contentLanguage } : {}),\n    ...(contentEncoding !== undefined ? { contentEncoding } : {}),\n    ...(cacheControl !== undefined ? { cacheControl } : {}),\n    ...(expires !== undefined ? { expires } : {}),\n    ...(contentRange !== undefined ? { contentRange } : {}),\n    // B2 sends the literal `'none'` for multipart-finished files; collapse\n    // to `null` so the typed `string | null` actually means \"no SHA-1\".\n    contentSha1: normalizeSha1(headers.get(DownloadHeaderName.ContentSha1)),\n    fileId: fileIdOf(headers.get(DownloadHeaderName.FileId) ?? ''),\n    fileName: decodeURIComponent(headers.get(DownloadHeaderName.FileName) ?? ''),\n    fileInfo,\n    uploadTimestamp: Number.parseInt(headers.get(DownloadHeaderName.UploadTimestamp) ?? '0', 10),\n    ...(serverSideEncryption !== undefined ? { serverSideEncryption } : {}),\n    ...(fileRetention !== undefined ? { fileRetention } : {}),\n    ...(legalHold !== undefined ? { legalHold } : {}),\n    ...(clientUnauthorizedToRead !== undefined ? { clientUnauthorizedToRead } : {}),\n    ...(headerParseIssues.length > 0 ? { headerParseIssues } : {}),\n  }\n}\n\nfunction optionalHeader(headers: Headers, name: string): string | undefined {\n  return headers.get(name) ?? undefined\n}\n\nfunction parseDownloadServerSideEncryption(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadServerSideEncryption | undefined {\n  const managedAlgorithm = optionalHeader(headers, DownloadHeaderName.ServerSideEncryption)\n  if (managedAlgorithm !== undefined) {\n    if (managedAlgorithm !== EncryptionAlgorithm.Aes256) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ServerSideEncryption,\n        value: managedAlgorithm,\n      })\n      return undefined\n    }\n    return { mode: EncryptionMode.SseB2, algorithm: managedAlgorithm }\n  }\n\n  const customerAlgorithm = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n  )\n  const customerKeyMd5 = optionalHeader(\n    headers,\n    DownloadHeaderName.ServerSideEncryptionCustomerKeyMd5,\n  )\n  if (customerAlgorithm === undefined || customerKeyMd5 === undefined) return undefined\n  if (customerAlgorithm !== EncryptionAlgorithm.Aes256) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.ServerSideEncryptionCustomerAlgorithm,\n      value: customerAlgorithm,\n    })\n    return undefined\n  }\n  return { mode: EncryptionMode.SseC, algorithm: customerAlgorithm, customerKeyMd5 }\n}\n\nfunction parseDownloadFileRetention(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['fileRetention'] {\n  if (\n    clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileRetentionMode) ===\n      true ||\n    clientUnauthorizedToRead?.includes(\n      DownloadClientUnauthorizedToReadMarker.FileRetentionRetainUntilTimestamp,\n    ) === true\n  ) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawMode = optionalHeader(headers, DownloadHeaderName.FileRetentionMode)\n  const rawRetainUntilTimestamp = optionalHeader(\n    headers,\n    DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n  )\n  if (rawMode === undefined && rawRetainUntilTimestamp === undefined) return undefined\n  return {\n    isClientAuthorizedToRead: true,\n    value: {\n      mode: parseRetentionMode(rawMode, headerParseIssues),\n      retainUntilTimestamp: parseRetentionTimestamp(rawRetainUntilTimestamp, headerParseIssues),\n    },\n  }\n}\n\nfunction parseRetentionMode(\n  rawMode: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): FileRetentionValue['mode'] {\n  if (rawMode === undefined) return null\n  if (rawMode === RetentionMode.Compliance || rawMode === RetentionMode.Governance) {\n    return rawMode\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileRetentionMode, value: rawMode })\n  return null\n}\n\nfunction parseRetentionTimestamp(\n  rawTimestamp: string | undefined,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): number | null {\n  if (rawTimestamp === undefined) return null\n  if (!/^\\d+$/.test(rawTimestamp)) {\n    headerParseIssues.push({\n      headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n      value: rawTimestamp,\n    })\n    return null\n  }\n  const parsed = Number.parseInt(rawTimestamp, 10)\n  if (Number.isFinite(parsed)) return parsed\n  headerParseIssues.push({\n    headerName: DownloadHeaderName.FileRetentionRetainUntilTimestamp,\n    value: rawTimestamp,\n  })\n  return null\n}\n\nfunction parseDownloadLegalHold(\n  headers: Headers,\n  clientUnauthorizedToRead: DownloadHeaders['clientUnauthorizedToRead'],\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['legalHold'] {\n  if (clientUnauthorizedToRead?.includes(DownloadClientUnauthorizedToReadMarker.FileLegalHold)) {\n    return { isClientAuthorizedToRead: false, value: null }\n  }\n\n  const rawLegalHold = optionalHeader(headers, DownloadHeaderName.FileLegalHold)\n  if (rawLegalHold === undefined) return undefined\n  if (rawLegalHold === LegalHoldValue.On || rawLegalHold === LegalHoldValue.Off) {\n    return { isClientAuthorizedToRead: true, value: rawLegalHold }\n  }\n  headerParseIssues.push({ headerName: DownloadHeaderName.FileLegalHold, value: rawLegalHold })\n  return { isClientAuthorizedToRead: true, value: null }\n}\n\nfunction parseClientUnauthorizedToRead(\n  headers: Headers,\n  headerParseIssues: DownloadHeaderParseIssue[],\n): DownloadHeaders['clientUnauthorizedToRead'] {\n  const value = optionalHeader(headers, DownloadHeaderName.ClientUnauthorizedToRead)\n  if (value === undefined) return undefined\n  const headerNames = value\n    .split(',')\n    .map((header) => header.trim())\n    .filter((header) => header.length > 0)\n  const knownHeaderNames = headerNames.filter(isDownloadClientUnauthorizedToReadMarker)\n  for (const headerName of headerNames) {\n    if (!isDownloadClientUnauthorizedToReadMarker(headerName)) {\n      headerParseIssues.push({\n        headerName: DownloadHeaderName.ClientUnauthorizedToRead,\n        value: headerName,\n      })\n    }\n  }\n  return knownHeaderNames.length > 0 ? knownHeaderNames : undefined\n}\n\nfunction isDownloadClientUnauthorizedToReadMarker(\n  headerName: string,\n): headerName is DownloadClientUnauthorizedToReadMarker {\n  return Object.values(DownloadClientUnauthorizedToReadMarker).includes(\n    headerName as DownloadClientUnauthorizedToReadMarker,\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuIA,eAAsB,aACpB,KACA,aACA,SACyB;CACzB,MAAM,OAAO,MAAM,IAAI,iBACrB,YAAY,eAAe,GAC3B,YAAY,aAAa,GACzB,QAAQ,QACR,qBAAqB,OAAO,CAC9B;CAEA,MAAM,UAAU,uBAAuB,KAAK,OAAO;CACnD,OAAO;EACL;EAGA,MAAM,oBAAoB,KAAK,QAAQ,YAAY,GAAG,SAAS,OAAO;CACxE;AACF;;;;;;;;;;;;;;AAeA,eAAsB,eACpB,KACA,aACA,SACyB;CACzB,MAAM,OAAO,MAAM,IAAI,mBACrB,YAAY,eAAe,GAC3B,YAAY,aAAa,GACzB,QAAQ,YACR,QAAQ,UACR,qBAAqB,OAAO,CAC9B;CAEA,MAAM,UAAU,uBAAuB,KAAK,OAAO;CACnD,OAAO;EACL;EACA,MAAM,oBAAoB,KAAK,QAAQ,YAAY,GAAG,SAAS,OAAO;CACxE;AACF;;;;;;;;;;;;;;;;;AAkBA,eAAsB,SACpB,KACA,aACA,SACqB;CACrB,MAAM,OAAO,MAAM,IAAI,iBACrB,YAAY,eAAe,GAC3B,YAAY,aAAa,GACzB,QAAQ,QACR;EAAE,GAAG,qBAAqB,OAAO;EAAG,QAAQ;CAAO,CACrD;CAMA,IAAI,KAAK,SAAS,MAAM;EAGtB,MAAM,OAAO,KAAK;EAClB,MAAM,iBAAiB,KAAK,OAAO,CAAC;CACtC;CACA,OAAO,EAAE,SAAS,uBAAuB,KAAK,OAAO,EAAE;AACzD;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,WACpB,KACA,aACA,SACqB;CACrB,MAAM,OAAO,MAAM,IAAI,mBACrB,YAAY,eAAe,GAC3B,YAAY,aAAa,GACzB,QAAQ,YACR,QAAQ,UACR;EAAE,GAAG,qBAAqB,OAAO;EAAG,QAAQ;CAAO,CACrD;CACA,IAAI,KAAK,SAAS,MAAM;EAGtB,MAAM,OAAO,KAAK;EAClB,MAAM,iBAAiB,KAAK,OAAO,CAAC;CACtC;CACA,OAAO,EAAE,SAAS,uBAAuB,KAAK,OAAO,EAAE;AACzD;;;;;;;;;;AAWA,SAAS,qBAAqB,SAAqD;CACjF,OAAO;EACL,GAAI,QAAQ,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;EACjE,GAAI,QAAQ,UAAU,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EAC9D,GAAI,QAAQ,yBAAyB,KAAA,IACjC,EAAE,sBAAsB,QAAQ,qBAAqB,IACrD,CAAC;EACL,GAAI,QAAQ,yBAAyB,KAAA,IACjC,EAAE,sBAAsB,QAAQ,qBAAqB,IACrD,CAAC;EACL,GAAI,QAAQ,sBAAsB,KAAA,IAC9B,EAAE,mBAAmB,QAAQ,kBAAkB,IAC/C,CAAC;EACL,GAAI,QAAQ,sBAAsB,KAAA,IAC9B,EAAE,mBAAmB,QAAQ,kBAAkB,IAC/C,CAAC;EACL,GAAI,QAAQ,kBAAkB,KAAA,IAAY,EAAE,eAAe,QAAQ,cAAc,IAAI,CAAC;EACtF,GAAI,QAAQ,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,QAAQ,eAAe,IAAI,CAAC;EACzF,GAAI,QAAQ,cAAc,KAAA,IAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;EAC1E,GAAI,QAAQ,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;CACnE;AACF;;;;;;;AAQA,SAAS,cAA0C;CACjD,OAAO,IAAI,eAAe,EACxB,MAAM,YAAY;EAChB,WAAW,MAAM;CACnB,EACF,CAAC;AACH;;;;;;;;;;;;;;;AAgBA,SAAS,oBACP,MACA,SACA,SAC4B;CAG5B,OAAO,mBAFc,QAAQ,WAAW,UAAU,QAAQ,UAAU,KAAA,IAChC,qBAAqB,MAAM,QAAQ,WAAW,IAAI,MAGpF,QAAQ,eACR,QAAQ,YACR,QAAQ,sBACV;AACF;;;;;;;;;;;;;;;AAgBA,SAAS,mBACP,MACA,YACA,UACA,wBAC4B;CAC5B,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,MAAM,UAAU,IAAI,gBAAgB,UAAU,YAAY,GAAG,EAC3D,GAAI,2BAA2B,KAAA,IAAY,EAAE,eAAe,uBAAuB,IAAI,CAAC,EAC1F,CAAC;CACD,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAI,WAAW;CAEf,SAAS,gBAAsB;EAC7B,IAAI,UAAU;EACd,WAAW;EACX,OAAO,YAAY;CACrB;CAEA,OAAO,IAAI,eAA2B;EACpC,MAAM,KAAK,YAAY;GACrB,IAAI;IACF,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;IAC1C,IAAI,MAAM;KACR,QAAQ,aAAa;KACrB,QAAQ,QAAQ;KAChB,cAAc;KACd,WAAW,MAAM;KACjB;IACF;IACA,QAAQ,SAAS,MAAM,UAAU;IACjC,WAAW,QAAQ,KAAK;GAC1B,SAAS,KAAK;IACZ,QAAQ,QAAQ;IAChB,cAAc;IACd,MAAM;GACR;EACF;EACA,MAAM,OAAO,QAAQ;GACnB,QAAQ,QAAQ;GAChB,IAAI;IACF,MAAM,OAAO,OAAO,MAAM;GAC5B,UAAU;IACR,cAAc;GAChB;EACF;CACF,CAAC;AACH;;;;;;;AAQA,SAAS,uBAAuB,SAAmC;CACjE,MAAM,oBAAgD,CAAC;CACvD,MAAM,WAAW,qBAAqB,OAAO;CAC7C,MAAM,2BAA2B,8BAA8B,SAAS,iBAAiB;CACzF,MAAM,qBAAqB,eAAe,SAAS,mBAAmB,kBAAkB;CACxF,MAAM,kBAAkB,eAAe,SAAS,mBAAmB,eAAe;CAClF,MAAM,kBAAkB,eAAe,SAAS,mBAAmB,eAAe;CAClF,MAAM,eAAe,eAAe,SAAS,mBAAmB,YAAY;CAC5E,MAAM,UAAU,eAAe,SAAS,mBAAmB,OAAO;CAClE,MAAM,eAAe,eAAe,SAAS,mBAAmB,YAAY;CAC5E,MAAM,uBAAuB,kCAAkC,SAAS,iBAAiB;CACzF,MAAM,gBAAgB,2BACpB,SACA,0BACA,iBACF;CACA,MAAM,YAAY,uBAAuB,SAAS,0BAA0B,iBAAiB;CAE7F,OAAO;EACL,aAAa,QAAQ,IAAI,mBAAmB,WAAW,KAAK;EAC5D,eAAe,OAAO,SAAS,QAAQ,IAAI,mBAAmB,aAAa,KAAK,KAAK,EAAE;EACvF,GAAI,uBAAuB,KAAA,IAAY,EAAE,mBAAmB,IAAI,CAAC;EACjE,GAAI,oBAAoB,KAAA,IAAY,EAAE,gBAAgB,IAAI,CAAC;EAC3D,GAAI,oBAAoB,KAAA,IAAY,EAAE,gBAAgB,IAAI,CAAC;EAC3D,GAAI,iBAAiB,KAAA,IAAY,EAAE,aAAa,IAAI,CAAC;EACrD,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;EAC3C,GAAI,iBAAiB,KAAA,IAAY,EAAE,aAAa,IAAI,CAAC;EAGrD,aAAa,cAAc,QAAQ,IAAI,mBAAmB,WAAW,CAAC;EACtE,QAAQ,OAAS,QAAQ,IAAI,mBAAmB,MAAM,KAAK,EAAE;EAC7D,UAAU,mBAAmB,QAAQ,IAAI,mBAAmB,QAAQ,KAAK,EAAE;EAC3E;EACA,iBAAiB,OAAO,SAAS,QAAQ,IAAI,mBAAmB,eAAe,KAAK,KAAK,EAAE;EAC3F,GAAI,yBAAyB,KAAA,IAAY,EAAE,qBAAqB,IAAI,CAAC;EACrE,GAAI,kBAAkB,KAAA,IAAY,EAAE,cAAc,IAAI,CAAC;EACvD,GAAI,cAAc,KAAA,IAAY,EAAE,UAAU,IAAI,CAAC;EAC/C,GAAI,6BAA6B,KAAA,IAAY,EAAE,yBAAyB,IAAI,CAAC;EAC7E,GAAI,kBAAkB,SAAS,IAAI,EAAE,kBAAkB,IAAI,CAAC;CAC9D;AACF;AAEA,SAAS,eAAe,SAAkB,MAAkC;CAC1E,OAAO,QAAQ,IAAI,IAAI,KAAK,KAAA;AAC9B;AAEA,SAAS,kCACP,SACA,mBAC0C;CAC1C,MAAM,mBAAmB,eAAe,SAAS,mBAAmB,oBAAoB;CACxF,IAAI,qBAAqB,KAAA,GAAW;EAClC,IAAI,qBAAqB,oBAAoB,QAAQ;GACnD,kBAAkB,KAAK;IACrB,YAAY,mBAAmB;IAC/B,OAAO;GACT,CAAC;GACD;EACF;EACA,OAAO;GAAE,MAAM,eAAe;GAAO,WAAW;EAAiB;CACnE;CAEA,MAAM,oBAAoB,eACxB,SACA,mBAAmB,qCACrB;CACA,MAAM,iBAAiB,eACrB,SACA,mBAAmB,kCACrB;CACA,IAAI,sBAAsB,KAAA,KAAa,mBAAmB,KAAA,GAAW,OAAO,KAAA;CAC5E,IAAI,sBAAsB,oBAAoB,QAAQ;EACpD,kBAAkB,KAAK;GACrB,YAAY,mBAAmB;GAC/B,OAAO;EACT,CAAC;EACD;CACF;CACA,OAAO;EAAE,MAAM,eAAe;EAAM,WAAW;EAAmB;CAAe;AACnF;AAEA,SAAS,2BACP,SACA,0BACA,mBACkC;CAClC,IACE,0BAA0B,SAAS,uCAAuC,iBAAiB,MACzF,QACF,0BAA0B,SACxB,uCAAuC,iCACzC,MAAM,MAEN,OAAO;EAAE,0BAA0B;EAAO,OAAO;CAAK;CAGxD,MAAM,UAAU,eAAe,SAAS,mBAAmB,iBAAiB;CAC5E,MAAM,0BAA0B,eAC9B,SACA,mBAAmB,iCACrB;CACA,IAAI,YAAY,KAAA,KAAa,4BAA4B,KAAA,GAAW,OAAO,KAAA;CAC3E,OAAO;EACL,0BAA0B;EAC1B,OAAO;GACL,MAAM,mBAAmB,SAAS,iBAAiB;GACnD,sBAAsB,wBAAwB,yBAAyB,iBAAiB;EAC1F;CACF;AACF;AAEA,SAAS,mBACP,SACA,mBAC4B;CAC5B,IAAI,YAAY,KAAA,GAAW,OAAO;CAClC,IAAI,YAAY,cAAc,cAAc,YAAY,cAAc,YACpE,OAAO;CAET,kBAAkB,KAAK;EAAE,YAAY,mBAAmB;EAAmB,OAAO;CAAQ,CAAC;CAC3F,OAAO;AACT;AAEA,SAAS,wBACP,cACA,mBACe;CACf,IAAI,iBAAiB,KAAA,GAAW,OAAO;CACvC,IAAI,CAAC,QAAQ,KAAK,YAAY,GAAG;EAC/B,kBAAkB,KAAK;GACrB,YAAY,mBAAmB;GAC/B,OAAO;EACT,CAAC;EACD,OAAO;CACT;CACA,MAAM,SAAS,OAAO,SAAS,cAAc,EAAE;CAC/C,IAAI,OAAO,SAAS,MAAM,GAAG,OAAO;CACpC,kBAAkB,KAAK;EACrB,YAAY,mBAAmB;EAC/B,OAAO;CACT,CAAC;CACD,OAAO;AACT;AAEA,SAAS,uBACP,SACA,0BACA,mBAC8B;CAC9B,IAAI,0BAA0B,SAAS,uCAAuC,aAAa,GACzF,OAAO;EAAE,0BAA0B;EAAO,OAAO;CAAK;CAGxD,MAAM,eAAe,eAAe,SAAS,mBAAmB,aAAa;CAC7E,IAAI,iBAAiB,KAAA,GAAW,OAAO,KAAA;CACvC,IAAI,iBAAiB,eAAe,MAAM,iBAAiB,eAAe,KACxE,OAAO;EAAE,0BAA0B;EAAM,OAAO;CAAa;CAE/D,kBAAkB,KAAK;EAAE,YAAY,mBAAmB;EAAe,OAAO;CAAa,CAAC;CAC5F,OAAO;EAAE,0BAA0B;EAAM,OAAO;CAAK;AACvD;AAEA,SAAS,8BACP,SACA,mBAC6C;CAC7C,MAAM,QAAQ,eAAe,SAAS,mBAAmB,wBAAwB;CACjF,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;CAChC,MAAM,cAAc,MACjB,MAAM,GAAG,CAAC,CACV,KAAK,WAAW,OAAO,KAAK,CAAC,CAAC,CAC9B,QAAQ,WAAW,OAAO,SAAS,CAAC;CACvC,MAAM,mBAAmB,YAAY,OAAO,wCAAwC;CACpF,KAAK,MAAM,cAAc,aACvB,IAAI,CAAC,yCAAyC,UAAU,GACtD,kBAAkB,KAAK;EACrB,YAAY,mBAAmB;EAC/B,OAAO;CACT,CAAC;CAGL,OAAO,iBAAiB,SAAS,IAAI,mBAAmB,KAAA;AAC1D;AAEA,SAAS,yCACP,YACsD;CACtD,OAAO,OAAO,OAAO,sCAAsC,CAAC,CAAC,SAC3D,UACF;AACF"}

package/dist/errors/index.cjs

@@ -12,10 +12,11 @@ const require_errors = require("../types/errors.cjs");
 * appropriate subclass.
 *
 * Convention: most `B2Error` subclasses represent failures returned by the B2
-* API. The client-side exceptions are {@link B2RealmConfigurationError} and
-* {@link B2PartnerAuthorizationError}; they extend `B2Error` so realm- and
-* Partner-authorization failures can be handled with the SDK error hierarchy
-* before or without a server round-trip.
+* API. The client-side exceptions are {@link B2BucketConfigurationError},
+* {@link B2RealmConfigurationError}, and {@link B2PartnerAuthorizationError};
+* they extend `B2Error` so validation, realm-, and Partner-authorization
+* failures can be handled with the SDK error hierarchy before or without a
+* server round-trip.
 *
 * Other programming errors and SDK preconditions, such as "not yet authorized",
 * "stream consumed twice", or "called before init", use the native `Error`
@@ -659,6 +660,27 @@ var B2PartnerAuthorizationError = class extends B2Error {
 		this.name = "B2PartnerAuthorizationError";
 	}
 };
+/** Thrown when bucket create/update metadata fails SDK client-side validation. */
+var B2BucketConfigurationError = class extends B2Error {
+	/** The request field that failed validation. */
+	field;
+	/**
+	* Creates a new B2BucketConfigurationError instance.
+	*
+	* @param field - The bucket configuration field that failed validation.
+	* @param message - Human-readable validation failure.
+	* @param code - B2-style error code for the rejected field.
+	*/
+	constructor(field, message, code = "bad_request") {
+		super({
+			status: 400,
+			code,
+			message
+		});
+		this.name = "B2BucketConfigurationError";
+		this.field = field;
+	}
+};
 /** Thrown when the SDK refuses to follow an HTTP redirect automatically. */
 var B2RedirectError = class extends Error {
 	/** Always `false` because a blocked redirect is deterministic. */
@@ -839,6 +861,7 @@ function classifyError(response, options) {
 }
 //#endregion
 exports.AccessDeniedError = AccessDeniedError;
+exports.B2BucketConfigurationError = B2BucketConfigurationError;
 exports.B2Error = B2Error;
 exports.B2InsufficientCapabilityError = B2InsufficientCapabilityError;
 exports.B2PartnerAuthorizationError = B2PartnerAuthorizationError;