@backblaze-labs/b2-sdk 0.1.0

package/dist/download/single.cjs

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const encoding = require("../raw/encoding.cjs");
+const progress = require("../streams/progress.cjs");
+const ids = require("../types/ids.cjs");
+const bestEffort = require("../util/best-effort.cjs");
+const normalize = require("../util/normalize.cjs");
+async function downloadById(raw, accountInfo, options) {
+  const resp = await raw.downloadFileById(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.fileId,
+    toRawDownloadOptions(options)
+  );
+  const headers = extractDownloadHeaders(resp.headers);
+  return {
+    headers,
+    // HEAD requests legitimately have no body; return an empty stream so the
+    // result shape stays consistent.
+    body: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress)
+  };
+}
+async function downloadByName(raw, accountInfo, options) {
+  const resp = await raw.downloadFileByName(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.bucketName,
+    options.fileName,
+    toRawDownloadOptions(options)
+  );
+  const headers = extractDownloadHeaders(resp.headers);
+  return {
+    headers,
+    body: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress)
+  };
+}
+async function headById(raw, accountInfo, options) {
+  const resp = await raw.downloadFileById(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.fileId,
+    { ...toRawDownloadOptions(options), method: "HEAD" }
+  );
+  if (resp.body !== null) {
+    const body = resp.body;
+    await bestEffort.bestEffort(() => body.cancel());
+  }
+  return { headers: extractDownloadHeaders(resp.headers) };
+}
+async function headByName(raw, accountInfo, options) {
+  const resp = await raw.downloadFileByName(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.bucketName,
+    options.fileName,
+    { ...toRawDownloadOptions(options), method: "HEAD" }
+  );
+  if (resp.body !== null) {
+    const body = resp.body;
+    await bestEffort.bestEffort(() => body.cancel());
+  }
+  return { headers: extractDownloadHeaders(resp.headers) };
+}
+function toRawDownloadOptions(options) {
+  return {
+    ...options.method !== void 0 ? { method: options.method } : {},
+    ...options.range !== void 0 ? { range: options.range } : {},
+    ...options.serverSideEncryption !== void 0 ? { serverSideEncryption: options.serverSideEncryption } : {},
+    ...options.b2ContentDisposition !== void 0 ? { b2ContentDisposition: options.b2ContentDisposition } : {},
+    ...options.b2ContentLanguage !== void 0 ? { b2ContentLanguage: options.b2ContentLanguage } : {},
+    ...options.b2ContentEncoding !== void 0 ? { b2ContentEncoding: options.b2ContentEncoding } : {},
+    ...options.b2ContentType !== void 0 ? { b2ContentType: options.b2ContentType } : {},
+    ...options.b2CacheControl !== void 0 ? { b2CacheControl: options.b2CacheControl } : {},
+    ...options.b2Expires !== void 0 ? { b2Expires: options.b2Expires } : {},
+    ...options.signal !== void 0 ? { signal: options.signal } : {}
+  };
+}
+function emptyStream() {
+  return new ReadableStream({
+    start(controller) {
+      controller.close();
+    }
+  });
+}
+function instrumentProgress(body, totalBytes, listener) {
+  if (listener === void 0) return body;
+  const tracker = new progress.ProgressTracker(listener, totalBytes, 1);
+  const transform = new TransformStream({
+    transform(chunk, controller) {
+      tracker.addBytes(chunk.byteLength);
+      controller.enqueue(chunk);
+    },
+    flush() {
+      tracker.completePart();
+    }
+  });
+  return body.pipeThrough(transform);
+}
+function extractDownloadHeaders(headers) {
+  const fileInfo = encoding.parseFileInfoHeaders(headers);
+  return {
+    contentType: headers.get("Content-Type") ?? "application/octet-stream",
+    contentLength: Number.parseInt(headers.get("Content-Length") ?? "0", 10),
+    // B2 sends the literal `'none'` for multipart-finished files; collapse
+    // to `null` so the typed `string | null` actually means "no SHA-1".
+    contentSha1: normalize.normalizeSha1(headers.get("X-Bz-Content-Sha1")),
+    fileId: ids.fileId(headers.get("X-Bz-File-Id") ?? ""),
+    fileName: decodeURIComponent(headers.get("X-Bz-File-Name") ?? ""),
+    fileInfo,
+    uploadTimestamp: Number.parseInt(headers.get("X-Bz-Upload-Timestamp") ?? "0", 10)
+  };
+}
+exports.downloadById = downloadById;
+exports.downloadByName = downloadByName;
+exports.headById = headById;
+exports.headByName = headByName;
+//# sourceMappingURL=single.cjs.map

package/dist/download/single.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"single.cjs","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 type { DownloadHeaders } from '../types/download.ts'\nimport { type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { bestEffort } from '../util/best-effort.ts'\nimport { normalizeSha1 } from '../util/normalize.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  /** Streaming body of the downloaded file. */\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: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress),\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: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress),\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 * 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 fileInfo = parseFileInfoHeaders(headers)\n\n  return {\n    contentType: headers.get('Content-Type') ?? 'application/octet-stream',\n    contentLength: Number.parseInt(headers.get('Content-Length') ?? '0', 10),\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('X-Bz-Content-Sha1')),\n    fileId: fileIdOf(headers.get('X-Bz-File-Id') ?? ''),\n    fileName: decodeURIComponent(headers.get('X-Bz-File-Name') ?? ''),\n    fileInfo,\n    uploadTimestamp: Number.parseInt(headers.get('X-Bz-Upload-Timestamp') ?? '0', 10),\n  }\n}\n"],"names":["bestEffort","ProgressTracker","parseFileInfoHeaders","normalizeSha1","fileIdOf"],"mappings":"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"}

package/dist/download/single.d.cts

@@ -0,0 +1,152 @@
+import { AccountInfo } from '../auth/account-info.js';
+import { RawClient, SseCDownloadKey } from '../raw/index.js';
+import { ProgressListener } from '../streams/progress.js';
+import { DownloadHeaders } from '../types/download.js';
+import { FileId } from '../types/ids.js';
+/** Result of a single-request file download. */
+export interface DownloadResult {
+    /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */
+    readonly headers: DownloadHeaders;
+    /** Streaming body of the downloaded file. */
+    readonly body: ReadableStream<Uint8Array>;
+}
+/**
+ * Result of a HEAD-style metadata fetch. Unlike {@link DownloadResult},
+ * this shape has **no** `body` field — the SDK consumes and discards the
+ * (logically empty) HEAD response body internally so callers never have
+ * to remember to `body.cancel()` after a metadata-only fetch.
+ */
+export interface HeadResult {
+    /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */
+    readonly headers: DownloadHeaders;
+}
+/** Shared download options exposed at the high-level facade. */
+interface DownloadCommonOptions {
+    /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only response headers without streaming the body. */
+    readonly method?: 'GET' | 'HEAD';
+    /** Optional HTTP Range header value (e.g. `bytes=0-999`). */
+    readonly range?: string;
+    /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */
+    readonly serverSideEncryption?: SseCDownloadKey;
+    /** Override the response `Content-Disposition` header. */
+    readonly b2ContentDisposition?: string;
+    /** Override the response `Content-Language` header. */
+    readonly b2ContentLanguage?: string;
+    /** Override the response `Content-Encoding` header. */
+    readonly b2ContentEncoding?: string;
+    /** Override the response `Content-Type` header. */
+    readonly b2ContentType?: string;
+    /** Override the response `Cache-Control` header. */
+    readonly b2CacheControl?: string;
+    /** Override the response `Expires` header. */
+    readonly b2Expires?: string;
+    /** Signal to abort the download. */
+    readonly signal?: AbortSignal;
+    /**
+     * 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`
+     * 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
+     * tracker's `completePart()` event will not fire. That is intentional:
+     * progress is byte-driven, not request-driven.
+     */
+    readonly onProgress?: ProgressListener;
+}
+/** Options for downloading a file by its unique ID. */
+export interface DownloadByIdOptions extends DownloadCommonOptions {
+    /** ID of the file version to download. */
+    readonly fileId: FileId;
+}
+/** Options for downloading a file by bucket name and file path. */
+export interface DownloadByNameOptions extends DownloadCommonOptions {
+    /** Name of the bucket containing the file. */
+    readonly bucketName: string;
+    /** Full file name (path) within the bucket. */
+    readonly fileName: string;
+}
+/**
+ * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits
+ * `method` (always HEAD) and `onProgress` (no body to track).
+ */
+type HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress'>;
+/** Options for a HEAD-by-ID request. */
+export interface HeadByIdOptions extends HeadCommonOptions {
+    /** ID of the file version to inspect. */
+    readonly fileId: FileId;
+}
+/** Options for a HEAD-by-name request. */
+export interface HeadByNameOptions extends HeadCommonOptions {
+    /** Name of the bucket containing the file. */
+    readonly bucketName: string;
+    /** Full file name (path) within the bucket. */
+    readonly fileName: string;
+}
+/**
+ * Downloads a file by its unique ID in a single HTTP request.
+ *
+ * Returns a streaming body suitable for small-to-medium files. For large files
+ * that benefit from concurrent ranged fetches, use
+ * {@link createParallelDownloadStream} instead.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - Download parameters.
+ *
+ * @returns Parsed headers and a readable stream of file bytes.
+ */
+export declare function downloadById(raw: RawClient, accountInfo: AccountInfo, options: DownloadByIdOptions): Promise<DownloadResult>;
+/**
+ * Downloads a file by bucket name and file path in a single HTTP request.
+ *
+ * Returns a streaming body suitable for small-to-medium files. For large files
+ * that benefit from concurrent ranged fetches, use
+ * {@link createParallelDownloadStream} instead.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - Download parameters.
+ *
+ * @returns Parsed headers and a readable stream of file bytes.
+ */
+export declare function downloadByName(raw: RawClient, accountInfo: AccountInfo, options: DownloadByNameOptions): Promise<DownloadResult>;
+/**
+ * Issues a HEAD-by-ID request and returns parsed headers only. Drains
+ * the (logically empty) response body internally so callers don't have
+ * to remember to `body.cancel()` themselves.
+ *
+ * Prefer this over `downloadById({ method: 'HEAD' })` — same wire-level
+ * effect, but the caller-facing result has no `body` field at all so
+ * there's nothing to clean up.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - HEAD parameters (file ID + the same response-header
+ *   overrides and abort signal that `downloadById` accepts).
+ *
+ * @returns Parsed download headers (no body field).
+ */
+export declare function headById(raw: RawClient, accountInfo: AccountInfo, options: HeadByIdOptions): Promise<HeadResult>;
+/**
+ * Issues a HEAD-by-name request and returns parsed headers only. Drains
+ * the (logically empty) response body internally so callers don't have
+ * to remember to `body.cancel()` themselves.
+ *
+ * Prefer this over `downloadByName({ method: 'HEAD' })` — same wire-level
+ * effect, but the caller-facing result has no `body` field at all so
+ * there's nothing to clean up.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - HEAD parameters (bucket + file name + the same
+ *   response-header overrides and abort signal that `downloadByName`
+ *   accepts).
+ *
+ * @returns Parsed download headers (no body field).
+ */
+export declare function headByName(raw: RawClient, accountInfo: AccountInfo, options: HeadByNameOptions): Promise<HeadResult>;
+export {};
+//# sourceMappingURL=single.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"single.d.ts","sourceRoot":"","sources":["../../src/download/single.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAuB,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtF,OAAO,EAAE,KAAK,gBAAgB,EAAmB,MAAM,wBAAwB,CAAA;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,KAAK,MAAM,EAAsB,MAAM,iBAAiB,CAAA;AAIjE,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAClC;AAED,gEAAgE;AAChE,UAAU,qBAAqB;IAC7B,gHAAgH;IAChH,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,iFAAiF;IACjF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,eAAe,CAAA;IAC/C,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,mDAAmD;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;CACvC;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,KAAK,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAA;AAE7E,wCAAwC;AACxC,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAezB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,UAAU,CAAC,CAmBrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/download/single.d.ts

@@ -0,0 +1,152 @@
+import { AccountInfo } from '../auth/account-info.js';
+import { RawClient, SseCDownloadKey } from '../raw/index.js';
+import { ProgressListener } from '../streams/progress.js';
+import { DownloadHeaders } from '../types/download.js';
+import { FileId } from '../types/ids.js';
+/** Result of a single-request file download. */
+export interface DownloadResult {
+    /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */
+    readonly headers: DownloadHeaders;
+    /** Streaming body of the downloaded file. */
+    readonly body: ReadableStream<Uint8Array>;
+}
+/**
+ * Result of a HEAD-style metadata fetch. Unlike {@link DownloadResult},
+ * this shape has **no** `body` field — the SDK consumes and discards the
+ * (logically empty) HEAD response body internally so callers never have
+ * to remember to `body.cancel()` after a metadata-only fetch.
+ */
+export interface HeadResult {
+    /** Parsed B2 response headers (content type, SHA-1, file info, etc.). */
+    readonly headers: DownloadHeaders;
+}
+/** Shared download options exposed at the high-level facade. */
+interface DownloadCommonOptions {
+    /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only response headers without streaming the body. */
+    readonly method?: 'GET' | 'HEAD';
+    /** Optional HTTP Range header value (e.g. `bytes=0-999`). */
+    readonly range?: string;
+    /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */
+    readonly serverSideEncryption?: SseCDownloadKey;
+    /** Override the response `Content-Disposition` header. */
+    readonly b2ContentDisposition?: string;
+    /** Override the response `Content-Language` header. */
+    readonly b2ContentLanguage?: string;
+    /** Override the response `Content-Encoding` header. */
+    readonly b2ContentEncoding?: string;
+    /** Override the response `Content-Type` header. */
+    readonly b2ContentType?: string;
+    /** Override the response `Cache-Control` header. */
+    readonly b2CacheControl?: string;
+    /** Override the response `Expires` header. */
+    readonly b2Expires?: string;
+    /** Signal to abort the download. */
+    readonly signal?: AbortSignal;
+    /**
+     * 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`
+     * 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
+     * tracker's `completePart()` event will not fire. That is intentional:
+     * progress is byte-driven, not request-driven.
+     */
+    readonly onProgress?: ProgressListener;
+}
+/** Options for downloading a file by its unique ID. */
+export interface DownloadByIdOptions extends DownloadCommonOptions {
+    /** ID of the file version to download. */
+    readonly fileId: FileId;
+}
+/** Options for downloading a file by bucket name and file path. */
+export interface DownloadByNameOptions extends DownloadCommonOptions {
+    /** Name of the bucket containing the file. */
+    readonly bucketName: string;
+    /** Full file name (path) within the bucket. */
+    readonly fileName: string;
+}
+/**
+ * Shared HEAD options. Mirrors {@link DownloadCommonOptions} but omits
+ * `method` (always HEAD) and `onProgress` (no body to track).
+ */
+type HeadCommonOptions = Omit<DownloadCommonOptions, 'method' | 'onProgress'>;
+/** Options for a HEAD-by-ID request. */
+export interface HeadByIdOptions extends HeadCommonOptions {
+    /** ID of the file version to inspect. */
+    readonly fileId: FileId;
+}
+/** Options for a HEAD-by-name request. */
+export interface HeadByNameOptions extends HeadCommonOptions {
+    /** Name of the bucket containing the file. */
+    readonly bucketName: string;
+    /** Full file name (path) within the bucket. */
+    readonly fileName: string;
+}
+/**
+ * Downloads a file by its unique ID in a single HTTP request.
+ *
+ * Returns a streaming body suitable for small-to-medium files. For large files
+ * that benefit from concurrent ranged fetches, use
+ * {@link createParallelDownloadStream} instead.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - Download parameters.
+ *
+ * @returns Parsed headers and a readable stream of file bytes.
+ */
+export declare function downloadById(raw: RawClient, accountInfo: AccountInfo, options: DownloadByIdOptions): Promise<DownloadResult>;
+/**
+ * Downloads a file by bucket name and file path in a single HTTP request.
+ *
+ * Returns a streaming body suitable for small-to-medium files. For large files
+ * that benefit from concurrent ranged fetches, use
+ * {@link createParallelDownloadStream} instead.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - Download parameters.
+ *
+ * @returns Parsed headers and a readable stream of file bytes.
+ */
+export declare function downloadByName(raw: RawClient, accountInfo: AccountInfo, options: DownloadByNameOptions): Promise<DownloadResult>;
+/**
+ * Issues a HEAD-by-ID request and returns parsed headers only. Drains
+ * the (logically empty) response body internally so callers don't have
+ * to remember to `body.cancel()` themselves.
+ *
+ * Prefer this over `downloadById({ method: 'HEAD' })` — same wire-level
+ * effect, but the caller-facing result has no `body` field at all so
+ * there's nothing to clean up.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - HEAD parameters (file ID + the same response-header
+ *   overrides and abort signal that `downloadById` accepts).
+ *
+ * @returns Parsed download headers (no body field).
+ */
+export declare function headById(raw: RawClient, accountInfo: AccountInfo, options: HeadByIdOptions): Promise<HeadResult>;
+/**
+ * Issues a HEAD-by-name request and returns parsed headers only. Drains
+ * the (logically empty) response body internally so callers don't have
+ * to remember to `body.cancel()` themselves.
+ *
+ * Prefer this over `downloadByName({ method: 'HEAD' })` — same wire-level
+ * effect, but the caller-facing result has no `body` field at all so
+ * there's nothing to clean up.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param options - HEAD parameters (bucket + file name + the same
+ *   response-header overrides and abort signal that `downloadByName`
+ *   accepts).
+ *
+ * @returns Parsed download headers (no body field).
+ */
+export declare function headByName(raw: RawClient, accountInfo: AccountInfo, options: HeadByNameOptions): Promise<HeadResult>;
+export {};
+//# sourceMappingURL=single.d.ts.map

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

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

package/dist/download/single.js

@@ -0,0 +1,117 @@
+import { parseFileInfoHeaders } from "../raw/encoding.js";
+import { ProgressTracker } from "../streams/progress.js";
+import { fileId } from "../types/ids.js";
+import { bestEffort } from "../util/best-effort.js";
+import { normalizeSha1 } from "../util/normalize.js";
+async function downloadById(raw, accountInfo, options) {
+  const resp = await raw.downloadFileById(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.fileId,
+    toRawDownloadOptions(options)
+  );
+  const headers = extractDownloadHeaders(resp.headers);
+  return {
+    headers,
+    // HEAD requests legitimately have no body; return an empty stream so the
+    // result shape stays consistent.
+    body: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress)
+  };
+}
+async function downloadByName(raw, accountInfo, options) {
+  const resp = await raw.downloadFileByName(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.bucketName,
+    options.fileName,
+    toRawDownloadOptions(options)
+  );
+  const headers = extractDownloadHeaders(resp.headers);
+  return {
+    headers,
+    body: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress)
+  };
+}
+async function headById(raw, accountInfo, options) {
+  const resp = await raw.downloadFileById(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.fileId,
+    { ...toRawDownloadOptions(options), method: "HEAD" }
+  );
+  if (resp.body !== null) {
+    const body = resp.body;
+    await bestEffort(() => body.cancel());
+  }
+  return { headers: extractDownloadHeaders(resp.headers) };
+}
+async function headByName(raw, accountInfo, options) {
+  const resp = await raw.downloadFileByName(
+    accountInfo.getDownloadUrl(),
+    accountInfo.getAuthToken(),
+    options.bucketName,
+    options.fileName,
+    { ...toRawDownloadOptions(options), method: "HEAD" }
+  );
+  if (resp.body !== null) {
+    const body = resp.body;
+    await bestEffort(() => body.cancel());
+  }
+  return { headers: extractDownloadHeaders(resp.headers) };
+}
+function toRawDownloadOptions(options) {
+  return {
+    ...options.method !== void 0 ? { method: options.method } : {},
+    ...options.range !== void 0 ? { range: options.range } : {},
+    ...options.serverSideEncryption !== void 0 ? { serverSideEncryption: options.serverSideEncryption } : {},
+    ...options.b2ContentDisposition !== void 0 ? { b2ContentDisposition: options.b2ContentDisposition } : {},
+    ...options.b2ContentLanguage !== void 0 ? { b2ContentLanguage: options.b2ContentLanguage } : {},
+    ...options.b2ContentEncoding !== void 0 ? { b2ContentEncoding: options.b2ContentEncoding } : {},
+    ...options.b2ContentType !== void 0 ? { b2ContentType: options.b2ContentType } : {},
+    ...options.b2CacheControl !== void 0 ? { b2CacheControl: options.b2CacheControl } : {},
+    ...options.b2Expires !== void 0 ? { b2Expires: options.b2Expires } : {},
+    ...options.signal !== void 0 ? { signal: options.signal } : {}
+  };
+}
+function emptyStream() {
+  return new ReadableStream({
+    start(controller) {
+      controller.close();
+    }
+  });
+}
+function instrumentProgress(body, totalBytes, listener) {
+  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);
+    },
+    flush() {
+      tracker.completePart();
+    }
+  });
+  return body.pipeThrough(transform);
+}
+function extractDownloadHeaders(headers) {
+  const fileInfo = parseFileInfoHeaders(headers);
+  return {
+    contentType: headers.get("Content-Type") ?? "application/octet-stream",
+    contentLength: Number.parseInt(headers.get("Content-Length") ?? "0", 10),
+    // B2 sends the literal `'none'` for multipart-finished files; collapse
+    // to `null` so the typed `string | null` actually means "no SHA-1".
+    contentSha1: normalizeSha1(headers.get("X-Bz-Content-Sha1")),
+    fileId: fileId(headers.get("X-Bz-File-Id") ?? ""),
+    fileName: decodeURIComponent(headers.get("X-Bz-File-Name") ?? ""),
+    fileInfo,
+    uploadTimestamp: Number.parseInt(headers.get("X-Bz-Upload-Timestamp") ?? "0", 10)
+  };
+}
+export {
+  downloadById,
+  downloadByName,
+  headById,
+  headByName
+};
+//# sourceMappingURL=single.js.map

package/dist/download/single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single.js","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 type { DownloadHeaders } from '../types/download.ts'\nimport { type FileId, fileId as fileIdOf } from '../types/ids.ts'\nimport { bestEffort } from '../util/best-effort.ts'\nimport { normalizeSha1 } from '../util/normalize.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  /** Streaming body of the downloaded file. */\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: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress),\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: instrumentProgress(resp.body ?? emptyStream(), headers.contentLength, options.onProgress),\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 * 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 fileInfo = parseFileInfoHeaders(headers)\n\n  return {\n    contentType: headers.get('Content-Type') ?? 'application/octet-stream',\n    contentLength: Number.parseInt(headers.get('Content-Length') ?? '0', 10),\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('X-Bz-Content-Sha1')),\n    fileId: fileIdOf(headers.get('X-Bz-File-Id') ?? ''),\n    fileName: decodeURIComponent(headers.get('X-Bz-File-Name') ?? ''),\n    fileInfo,\n    uploadTimestamp: Number.parseInt(headers.get('X-Bz-Upload-Timestamp') ?? '0', 10),\n  }\n}\n"],"names":["fileIdOf"],"mappings":"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"}