@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/util/paginator.js.map

@@ -1 +1 @@
-{"version":3,"file":"paginator.js","sources":["../../src/util/paginator.ts"],"sourcesContent":["/**\n * Generic pagination helpers for B2 list endpoints.\n *\n * B2 returns paginated results as `{ items, nextCursor }` shapes that differ\n * per endpoint (`nextFileName`, `nextFileId`, `nextPartNumber`,\n * `nextApplicationKeyId`, etc.). These helpers let callers iterate without\n * threading the cursor by hand.\n *\n * Two flavours:\n *   - {@link paginatePages} yields each page as the server returned it.\n *     Useful when the caller wants the per-page response object (e.g. for\n *     access to per-page metadata or to control item-iteration order).\n *   - {@link paginateItems} flattens pages and yields individual items.\n *     Useful for the common \"iterate everything\" case.\n *\n * Both helpers honour an optional {@link AbortSignal} that aborts the\n * iteration **between fetches**. They do NOT abort an in-flight network\n * request: the underlying list call has its own `signal` parameter and\n * each consumer must wire that through if mid-flight cancellation is\n * required.\n *\n * @packageDocumentation\n *\n * @example\n * ```ts\n * for await (const file of bucket.paginateFileNames({ prefix: 'photos/' })) {\n *   console.log(file.fileName, file.contentLength)\n * }\n * ```\n *\n */\n\n/**\n * Options accepted by every `paginateX` method on `Bucket` and `B2Client`.\n */\nexport interface PaginatorOptions {\n  /**\n   * Maximum items per page. Forwarded to the underlying list call's\n   * `maxFileCount` / `maxKeyCount` / `maxPartCount` parameter. B2 caps this\n   * at endpoint-specific limits (typically 10000 for files, 100 for parts).\n   */\n  pageSize?: number\n  /**\n   * Aborts the iteration between fetches. When already aborted at call time,\n   * the iterator throws immediately on its first `next()` call.\n   *\n   * Note: this does NOT abort an in-flight HTTP request mid-page. The\n   * iterator checks `signal.throwIfAborted()` only between fetches.\n   */\n  signal?: AbortSignal\n}\n\n/**\n * Function that fetches a single page given a cursor.\n *\n * The cursor is `undefined` for the first page, then takes the value of the\n * previous page's `nextCursor` on subsequent calls. Iteration stops when\n * `nextCursor` is `undefined` (or any other falsy value the caller maps to\n * `undefined`).\n *\n * @typeParam Page - The per-page response shape returned by the B2 endpoint.\n * @typeParam Cursor - The cursor type (typically `string` or a `{name, id}` pair).\n */\nexport type PageFetcher<Page, Cursor> = (cursor: Cursor | undefined) => Promise<{\n  /** The page just fetched. */\n  page: Page\n  /** Cursor for the next page, or `undefined` if there are no more pages. */\n  nextCursor: Cursor | undefined\n}>\n\n/**\n * Async-iterates one page at a time. Stops when `fetcher` returns\n * `nextCursor: undefined`.\n *\n * @typeParam Page - The per-page response shape.\n * @typeParam Cursor - The cursor type used to request the next page.\n *\n * @param fetcher - Function that fetches one page given the current cursor.\n * @param signal - Optional abort signal. Checked before each fetch.\n *\n * @returns An async iterable of pages.\n *\n * @throws DOMException When `signal` is aborted between fetches.\n *\n * @example\n * ```ts\n * for await (const page of paginatePages(\n *   async (cursor) => {\n *     const resp = await bucket.listFileNames({ startFileName: cursor })\n *     return { page: resp, nextCursor: resp.nextFileName ?? undefined }\n *   },\n *   abortSignal,\n * )) {\n *   for (const file of page.files) { ... }\n * }\n * ```\n */\nexport async function* paginatePages<Page, Cursor>(\n  fetcher: PageFetcher<Page, Cursor>,\n  signal: AbortSignal | undefined,\n): AsyncIterableIterator<Page> {\n  let cursor: Cursor | undefined\n  while (true) {\n    signal?.throwIfAborted()\n    const { page, nextCursor } = await fetcher(cursor)\n    yield page\n    if (nextCursor === undefined) return\n    cursor = nextCursor\n  }\n}\n\n/**\n * Async-iterates items by flattening pages. The `extractItems` function\n * pulls the relevant array out of each page (e.g. `page.files`,\n * `page.keys`, `page.parts`). Each item is yielded individually so the\n * caller can `for await (const item of paginator)` rather than nest loops.\n *\n * Aborts between **pages**, not between items: if `signal` is aborted while\n * the caller is processing the items of page N, the iterator will still\n * yield all of page N's remaining items before checking the signal before\n * fetching page N+1.\n *\n * @typeParam Page - The per-page response shape.\n * @typeParam Cursor - The cursor type used to request the next page.\n * @typeParam Item - The item type the caller wants to iterate.\n *\n * @param fetcher - Function that fetches one page given the current cursor.\n * @param extractItems - Pulls the iterable items out of a page.\n * @param signal - Optional abort signal. Checked before each fetch.\n *\n * @returns An async iterable of individual items.\n *\n * @throws DOMException When `signal` is aborted between fetches.\n */\nexport async function* paginateItems<Page, Cursor, Item>(\n  fetcher: PageFetcher<Page, Cursor>,\n  extractItems: (page: Page) => Iterable<Item>,\n  signal: AbortSignal | undefined,\n): AsyncIterableIterator<Item> {\n  for await (const page of paginatePages(fetcher, signal)) {\n    yield* extractItems(page)\n  }\n}\n"],"names":[],"mappings":"AAiGA,gBAAuB,cACrB,SACA,QAC6B;AAC7B,MAAI;AACJ,SAAO,MAAM;AACX,YAAQ,eAAA;AACR,UAAM,EAAE,MAAM,WAAA,IAAe,MAAM,QAAQ,MAAM;AACjD,UAAM;AACN,QAAI,eAAe,OAAW;AAC9B,aAAS;AAAA,EACX;AACF;AAyBA,gBAAuB,cACrB,SACA,cACA,QAC6B;AAC7B,mBAAiB,QAAQ,cAAc,SAAS,MAAM,GAAG;AACvD,WAAO,aAAa,IAAI;AAAA,EAC1B;AACF;"}
+{"version":3,"file":"paginator.js","names":[],"sources":["../../src/util/paginator.ts"],"sourcesContent":["/**\n * Generic pagination helpers for B2 list endpoints.\n *\n * B2 returns paginated results as `{ items, nextCursor }` shapes that differ\n * per endpoint (`nextFileName`, `nextFileId`, `nextPartNumber`,\n * `nextApplicationKeyId`, etc.). These helpers let callers iterate without\n * threading the cursor by hand.\n *\n * Two flavours:\n *   - {@link paginatePages} yields each page as the server returned it.\n *     Useful when the caller wants the per-page response object (e.g. for\n *     access to per-page metadata or to control item-iteration order).\n *   - {@link paginateItems} flattens pages and yields individual items.\n *     Useful for the common \"iterate everything\" case.\n *\n * Both helpers honour an optional {@link AbortSignal} that aborts the\n * iteration **between fetches**. They do NOT abort an in-flight network\n * request: the underlying list call has its own `signal` parameter and\n * each consumer must wire that through if mid-flight cancellation is\n * required.\n *\n * @packageDocumentation\n *\n * @example\n * ```ts\n * for await (const file of bucket.paginateFileNames({ prefix: 'photos/' })) {\n *   console.log(file.fileName, file.contentLength)\n * }\n * ```\n *\n */\n\n/**\n * Options accepted by every `paginateX` method on `Bucket` and `B2Client`.\n */\nexport interface PaginatorOptions {\n  /**\n   * Maximum items per page. Forwarded to the underlying list call's\n   * `maxFileCount` / `maxKeyCount` / `maxPartCount` parameter. B2 caps this\n   * at endpoint-specific limits (typically 10000 for files, 100 for parts).\n   */\n  pageSize?: number\n  /**\n   * Aborts the iteration between fetches. When already aborted at call time,\n   * the iterator throws immediately on its first `next()` call.\n   *\n   * Note: this does NOT abort an in-flight HTTP request mid-page. The\n   * iterator checks `signal.throwIfAborted()` only between fetches.\n   */\n  signal?: AbortSignal\n}\n\n/**\n * Function that fetches a single page given a cursor.\n *\n * The cursor is `undefined` for the first page, then takes the value of the\n * previous page's `nextCursor` on subsequent calls. Iteration stops when\n * `nextCursor` is `undefined` (or any other falsy value the caller maps to\n * `undefined`).\n *\n * @typeParam Page - The per-page response shape returned by the B2 endpoint.\n * @typeParam Cursor - The cursor type (typically `string` or a `{name, id}` pair).\n */\nexport type PageFetcher<Page, Cursor> = (cursor: Cursor | undefined) => Promise<{\n  /** The page just fetched. */\n  page: Page\n  /** Cursor for the next page, or `undefined` if there are no more pages. */\n  nextCursor: Cursor | undefined\n}>\n\n/**\n * Async-iterates one page at a time. Stops when `fetcher` returns\n * `nextCursor: undefined`.\n *\n * @typeParam Page - The per-page response shape.\n * @typeParam Cursor - The cursor type used to request the next page.\n *\n * @param fetcher - Function that fetches one page given the current cursor.\n * @param signal - Optional abort signal. Checked before each fetch.\n *\n * @returns An async iterable of pages.\n *\n * @throws DOMException When `signal` is aborted between fetches.\n *\n * @example\n * ```ts\n * for await (const page of paginatePages(\n *   async (cursor) => {\n *     const resp = await bucket.listFileNames({ startFileName: cursor })\n *     return { page: resp, nextCursor: resp.nextFileName ?? undefined }\n *   },\n *   abortSignal,\n * )) {\n *   for (const file of page.files) { ... }\n * }\n * ```\n */\nexport async function* paginatePages<Page, Cursor>(\n  fetcher: PageFetcher<Page, Cursor>,\n  signal: AbortSignal | undefined,\n): AsyncIterableIterator<Page> {\n  let cursor: Cursor | undefined\n  while (true) {\n    signal?.throwIfAborted()\n    const { page, nextCursor } = await fetcher(cursor)\n    yield page\n    if (nextCursor === undefined) return\n    cursor = nextCursor\n  }\n}\n\n/**\n * Async-iterates items by flattening pages. The `extractItems` function\n * pulls the relevant array out of each page (e.g. `page.files`,\n * `page.keys`, `page.parts`). Each item is yielded individually so the\n * caller can `for await (const item of paginator)` rather than nest loops.\n *\n * Aborts between **pages**, not between items: if `signal` is aborted while\n * the caller is processing the items of page N, the iterator will still\n * yield all of page N's remaining items before checking the signal before\n * fetching page N+1.\n *\n * @typeParam Page - The per-page response shape.\n * @typeParam Cursor - The cursor type used to request the next page.\n * @typeParam Item - The item type the caller wants to iterate.\n *\n * @param fetcher - Function that fetches one page given the current cursor.\n * @param extractItems - Pulls the iterable items out of a page.\n * @param signal - Optional abort signal. Checked before each fetch.\n *\n * @returns An async iterable of individual items.\n *\n * @throws DOMException When `signal` is aborted between fetches.\n */\nexport async function* paginateItems<Page, Cursor, Item>(\n  fetcher: PageFetcher<Page, Cursor>,\n  extractItems: (page: Page) => Iterable<Item>,\n  signal: AbortSignal | undefined,\n): AsyncIterableIterator<Item> {\n  for await (const page of paginatePages(fetcher, signal)) {\n    yield* extractItems(page)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiGA,gBAAuB,cACrB,SACA,QAC6B;CAC7B,IAAI;CACJ,OAAO,MAAM;EACX,QAAQ,eAAe;EACvB,MAAM,EAAE,MAAM,eAAe,MAAM,QAAQ,MAAM;EACjD,MAAM;EACN,IAAI,eAAe,KAAA,GAAW;EAC9B,SAAS;CACX;AACF;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,gBAAuB,cACrB,SACA,cACA,QAC6B;CAC7B,WAAW,MAAM,QAAQ,cAAc,SAAS,MAAM,GACpD,OAAO,aAAa,IAAI;AAE5B"}

package/dist/util/plan-ranges.cjs

@@ -1,28 +1,53 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/util/plan-ranges.ts
+/**
+* Lays out a sequence of contiguous, non-overlapping byte ranges over
+* `[0, totalSize)`. Every produced range is at most `chunkSize` bytes
+* long; the final range may be shorter if `totalSize` is not a multiple
+* of `chunkSize`.
+*
+* Replaces three near-identical hand-rolled loops in
+* `upload/large.ts`, `copy/large.ts`, and `download/parallel.ts`.
+*
+* @param totalSize - Total number of bytes to cover.
+* @param chunkSize - Target size of each range in bytes (last range may be smaller).
+*
+* @returns Ordered, non-overlapping range plans. Empty array when `totalSize === 0`.
+*/
 function planRanges(totalSize, chunkSize) {
-  const plans = [];
-  let offset = 0;
-  let index = 0;
-  while (offset < totalSize) {
-    const length = Math.min(chunkSize, totalSize - offset);
-    const end = offset + length - 1;
-    plans.push({
-      partNumber: index + 1,
-      index,
-      offset,
-      length,
-      start: offset,
-      end
-    });
-    offset += length;
-    index++;
-  }
-  return plans;
+	const plans = [];
+	let offset = 0;
+	let index = 0;
+	while (offset < totalSize) {
+		const length = Math.min(chunkSize, totalSize - offset);
+		const end = offset + length - 1;
+		plans.push({
+			partNumber: index + 1,
+			index,
+			offset,
+			length,
+			start: offset,
+			end
+		});
+		offset += length;
+		index++;
+	}
+	return plans;
 }
+/**
+* Format an HTTP `Range:` request-header value covering the given
+* inclusive byte offsets. Centralises the `bytes=<start>-<end>` template
+* so the upload, copy, and download paths agree on syntax.
+*
+* @param start - Inclusive starting byte.
+* @param end - Inclusive ending byte.
+*
+* @returns The header value (e.g. `'bytes=0-99'`).
+*/
 function byteRangeHeader(start, end) {
-  return `bytes=${start}-${end}`;
+	return `bytes=${start}-${end}`;
 }
+//#endregion
 exports.byteRangeHeader = byteRangeHeader;
 exports.planRanges = planRanges;
-//# sourceMappingURL=plan-ranges.cjs.map
+
+//# sourceMappingURL=plan-ranges.cjs.map

package/dist/util/plan-ranges.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plan-ranges.cjs","sources":["../../src/util/plan-ranges.ts"],"sourcesContent":["/**\n * Inclusive byte range plan for a single chunk of a larger sequence.\n *\n * Carries every commonly-needed shape so the three call sites (multipart\n * upload, server-side multipart copy, parallel-ranged download) can\n * destructure the fields they want without re-deriving them:\n *\n * - `partNumber` is 1-based to match the B2 `b2_upload_part` /\n *   `b2_copy_part` wire format.\n * - `index` is 0-based for callers that key into a `Map` or array slot.\n * - `offset` + `length` are the upload-style framing (where in the\n *   source to read, how many bytes).\n * - `start` + `end` (both inclusive) are the HTTP `Range:` /\n *   `Content-Range:` framing.\n */\nexport interface RangePlan {\n  /** 1-based part number for B2 multipart endpoints. */\n  readonly partNumber: number\n  /** 0-based slot index for in-memory bookkeeping. */\n  readonly index: number\n  /** Inclusive byte offset where this range begins. */\n  readonly offset: number\n  /** Number of bytes in this range. */\n  readonly length: number\n  /** Alias for {@link offset} — convenient for `bytes=start-end` formatters. */\n  readonly start: number\n  /** Inclusive byte offset where this range ends (`offset + length - 1`). */\n  readonly end: number\n}\n\n/**\n * Lays out a sequence of contiguous, non-overlapping byte ranges over\n * `[0, totalSize)`. Every produced range is at most `chunkSize` bytes\n * long; the final range may be shorter if `totalSize` is not a multiple\n * of `chunkSize`.\n *\n * Replaces three near-identical hand-rolled loops in\n * `upload/large.ts`, `copy/large.ts`, and `download/parallel.ts`.\n *\n * @param totalSize - Total number of bytes to cover.\n * @param chunkSize - Target size of each range in bytes (last range may be smaller).\n *\n * @returns Ordered, non-overlapping range plans. Empty array when `totalSize === 0`.\n */\nexport function planRanges(totalSize: number, chunkSize: number): RangePlan[] {\n  const plans: RangePlan[] = []\n  let offset = 0\n  let index = 0\n  while (offset < totalSize) {\n    const length = Math.min(chunkSize, totalSize - offset)\n    const end = offset + length - 1\n    plans.push({\n      partNumber: index + 1,\n      index,\n      offset,\n      length,\n      start: offset,\n      end,\n    })\n    offset += length\n    index++\n  }\n  return plans\n}\n\n/**\n * Format an HTTP `Range:` request-header value covering the given\n * inclusive byte offsets. Centralises the `bytes=<start>-<end>` template\n * so the upload, copy, and download paths agree on syntax.\n *\n * @param start - Inclusive starting byte.\n * @param end - Inclusive ending byte.\n *\n * @returns The header value (e.g. `'bytes=0-99'`).\n */\nexport function byteRangeHeader(start: number, end: number): string {\n  return `bytes=${start}-${end}`\n}\n"],"names":[],"mappings":";;AA4CO,SAAS,WAAW,WAAmB,WAAgC;AAC5E,QAAM,QAAqB,CAAA;AAC3B,MAAI,SAAS;AACb,MAAI,QAAQ;AACZ,SAAO,SAAS,WAAW;AACzB,UAAM,SAAS,KAAK,IAAI,WAAW,YAAY,MAAM;AACrD,UAAM,MAAM,SAAS,SAAS;AAC9B,UAAM,KAAK;AAAA,MACT,YAAY,QAAQ;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP;AAAA,IAAA,CACD;AACD,cAAU;AACV;AAAA,EACF;AACA,SAAO;AACT;AAYO,SAAS,gBAAgB,OAAe,KAAqB;AAClE,SAAO,SAAS,KAAK,IAAI,GAAG;AAC9B;;;"}
+{"version":3,"file":"plan-ranges.cjs","names":[],"sources":["../../src/util/plan-ranges.ts"],"sourcesContent":["/**\n * Inclusive byte range plan for a single chunk of a larger sequence.\n *\n * Carries every commonly-needed shape so the three call sites (multipart\n * upload, server-side multipart copy, parallel-ranged download) can\n * destructure the fields they want without re-deriving them:\n *\n * - `partNumber` is 1-based to match the B2 `b2_upload_part` /\n *   `b2_copy_part` wire format.\n * - `index` is 0-based for callers that key into a `Map` or array slot.\n * - `offset` + `length` are the upload-style framing (where in the\n *   source to read, how many bytes).\n * - `start` + `end` (both inclusive) are the HTTP `Range:` /\n *   `Content-Range:` framing.\n */\nexport interface RangePlan {\n  /** 1-based part number for B2 multipart endpoints. */\n  readonly partNumber: number\n  /** 0-based slot index for in-memory bookkeeping. */\n  readonly index: number\n  /** Inclusive byte offset where this range begins. */\n  readonly offset: number\n  /** Number of bytes in this range. */\n  readonly length: number\n  /** Alias for {@link offset} — convenient for `bytes=start-end` formatters. */\n  readonly start: number\n  /** Inclusive byte offset where this range ends (`offset + length - 1`). */\n  readonly end: number\n}\n\n/**\n * Lays out a sequence of contiguous, non-overlapping byte ranges over\n * `[0, totalSize)`. Every produced range is at most `chunkSize` bytes\n * long; the final range may be shorter if `totalSize` is not a multiple\n * of `chunkSize`.\n *\n * Replaces three near-identical hand-rolled loops in\n * `upload/large.ts`, `copy/large.ts`, and `download/parallel.ts`.\n *\n * @param totalSize - Total number of bytes to cover.\n * @param chunkSize - Target size of each range in bytes (last range may be smaller).\n *\n * @returns Ordered, non-overlapping range plans. Empty array when `totalSize === 0`.\n */\nexport function planRanges(totalSize: number, chunkSize: number): RangePlan[] {\n  const plans: RangePlan[] = []\n  let offset = 0\n  let index = 0\n  while (offset < totalSize) {\n    const length = Math.min(chunkSize, totalSize - offset)\n    const end = offset + length - 1\n    plans.push({\n      partNumber: index + 1,\n      index,\n      offset,\n      length,\n      start: offset,\n      end,\n    })\n    offset += length\n    index++\n  }\n  return plans\n}\n\n/**\n * Format an HTTP `Range:` request-header value covering the given\n * inclusive byte offsets. Centralises the `bytes=<start>-<end>` template\n * so the upload, copy, and download paths agree on syntax.\n *\n * @param start - Inclusive starting byte.\n * @param end - Inclusive ending byte.\n *\n * @returns The header value (e.g. `'bytes=0-99'`).\n */\nexport function byteRangeHeader(start: number, end: number): string {\n  return `bytes=${start}-${end}`\n}\n"],"mappings":";;;;;;;;;;;;;;;AA4CA,SAAgB,WAAW,WAAmB,WAAgC;CAC5E,MAAM,QAAqB,CAAC;CAC5B,IAAI,SAAS;CACb,IAAI,QAAQ;CACZ,OAAO,SAAS,WAAW;EACzB,MAAM,SAAS,KAAK,IAAI,WAAW,YAAY,MAAM;EACrD,MAAM,MAAM,SAAS,SAAS;EAC9B,MAAM,KAAK;GACT,YAAY,QAAQ;GACpB;GACA;GACA;GACA,OAAO;GACP;EACF,CAAC;EACD,UAAU;EACV;CACF;CACA,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,gBAAgB,OAAe,KAAqB;CAClE,OAAO,SAAS,MAAM,GAAG;AAC3B"}

package/dist/util/plan-ranges.js

@@ -1,28 +1,52 @@
+//#region src/util/plan-ranges.ts
+/**
+* Lays out a sequence of contiguous, non-overlapping byte ranges over
+* `[0, totalSize)`. Every produced range is at most `chunkSize` bytes
+* long; the final range may be shorter if `totalSize` is not a multiple
+* of `chunkSize`.
+*
+* Replaces three near-identical hand-rolled loops in
+* `upload/large.ts`, `copy/large.ts`, and `download/parallel.ts`.
+*
+* @param totalSize - Total number of bytes to cover.
+* @param chunkSize - Target size of each range in bytes (last range may be smaller).
+*
+* @returns Ordered, non-overlapping range plans. Empty array when `totalSize === 0`.
+*/
 function planRanges(totalSize, chunkSize) {
-  const plans = [];
-  let offset = 0;
-  let index = 0;
-  while (offset < totalSize) {
-    const length = Math.min(chunkSize, totalSize - offset);
-    const end = offset + length - 1;
-    plans.push({
-      partNumber: index + 1,
-      index,
-      offset,
-      length,
-      start: offset,
-      end
-    });
-    offset += length;
-    index++;
-  }
-  return plans;
+	const plans = [];
+	let offset = 0;
+	let index = 0;
+	while (offset < totalSize) {
+		const length = Math.min(chunkSize, totalSize - offset);
+		const end = offset + length - 1;
+		plans.push({
+			partNumber: index + 1,
+			index,
+			offset,
+			length,
+			start: offset,
+			end
+		});
+		offset += length;
+		index++;
+	}
+	return plans;
 }
+/**
+* Format an HTTP `Range:` request-header value covering the given
+* inclusive byte offsets. Centralises the `bytes=<start>-<end>` template
+* so the upload, copy, and download paths agree on syntax.
+*
+* @param start - Inclusive starting byte.
+* @param end - Inclusive ending byte.
+*
+* @returns The header value (e.g. `'bytes=0-99'`).
+*/
 function byteRangeHeader(start, end) {
-  return `bytes=${start}-${end}`;
+	return `bytes=${start}-${end}`;
 }
-export {
-  byteRangeHeader,
-  planRanges
-};
-//# sourceMappingURL=plan-ranges.js.map
+//#endregion
+export { byteRangeHeader, planRanges };
+
+//# sourceMappingURL=plan-ranges.js.map

package/dist/util/plan-ranges.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-ranges.js","sources":["../../src/util/plan-ranges.ts"],"sourcesContent":["/**\n * Inclusive byte range plan for a single chunk of a larger sequence.\n *\n * Carries every commonly-needed shape so the three call sites (multipart\n * upload, server-side multipart copy, parallel-ranged download) can\n * destructure the fields they want without re-deriving them:\n *\n * - `partNumber` is 1-based to match the B2 `b2_upload_part` /\n *   `b2_copy_part` wire format.\n * - `index` is 0-based for callers that key into a `Map` or array slot.\n * - `offset` + `length` are the upload-style framing (where in the\n *   source to read, how many bytes).\n * - `start` + `end` (both inclusive) are the HTTP `Range:` /\n *   `Content-Range:` framing.\n */\nexport interface RangePlan {\n  /** 1-based part number for B2 multipart endpoints. */\n  readonly partNumber: number\n  /** 0-based slot index for in-memory bookkeeping. */\n  readonly index: number\n  /** Inclusive byte offset where this range begins. */\n  readonly offset: number\n  /** Number of bytes in this range. */\n  readonly length: number\n  /** Alias for {@link offset} — convenient for `bytes=start-end` formatters. */\n  readonly start: number\n  /** Inclusive byte offset where this range ends (`offset + length - 1`). */\n  readonly end: number\n}\n\n/**\n * Lays out a sequence of contiguous, non-overlapping byte ranges over\n * `[0, totalSize)`. Every produced range is at most `chunkSize` bytes\n * long; the final range may be shorter if `totalSize` is not a multiple\n * of `chunkSize`.\n *\n * Replaces three near-identical hand-rolled loops in\n * `upload/large.ts`, `copy/large.ts`, and `download/parallel.ts`.\n *\n * @param totalSize - Total number of bytes to cover.\n * @param chunkSize - Target size of each range in bytes (last range may be smaller).\n *\n * @returns Ordered, non-overlapping range plans. Empty array when `totalSize === 0`.\n */\nexport function planRanges(totalSize: number, chunkSize: number): RangePlan[] {\n  const plans: RangePlan[] = []\n  let offset = 0\n  let index = 0\n  while (offset < totalSize) {\n    const length = Math.min(chunkSize, totalSize - offset)\n    const end = offset + length - 1\n    plans.push({\n      partNumber: index + 1,\n      index,\n      offset,\n      length,\n      start: offset,\n      end,\n    })\n    offset += length\n    index++\n  }\n  return plans\n}\n\n/**\n * Format an HTTP `Range:` request-header value covering the given\n * inclusive byte offsets. Centralises the `bytes=<start>-<end>` template\n * so the upload, copy, and download paths agree on syntax.\n *\n * @param start - Inclusive starting byte.\n * @param end - Inclusive ending byte.\n *\n * @returns The header value (e.g. `'bytes=0-99'`).\n */\nexport function byteRangeHeader(start: number, end: number): string {\n  return `bytes=${start}-${end}`\n}\n"],"names":[],"mappings":"AA4CO,SAAS,WAAW,WAAmB,WAAgC;AAC5E,QAAM,QAAqB,CAAA;AAC3B,MAAI,SAAS;AACb,MAAI,QAAQ;AACZ,SAAO,SAAS,WAAW;AACzB,UAAM,SAAS,KAAK,IAAI,WAAW,YAAY,MAAM;AACrD,UAAM,MAAM,SAAS,SAAS;AAC9B,UAAM,KAAK;AAAA,MACT,YAAY,QAAQ;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP;AAAA,IAAA,CACD;AACD,cAAU;AACV;AAAA,EACF;AACA,SAAO;AACT;AAYO,SAAS,gBAAgB,OAAe,KAAqB;AAClE,SAAO,SAAS,KAAK,IAAI,GAAG;AAC9B;"}
+{"version":3,"file":"plan-ranges.js","names":[],"sources":["../../src/util/plan-ranges.ts"],"sourcesContent":["/**\n * Inclusive byte range plan for a single chunk of a larger sequence.\n *\n * Carries every commonly-needed shape so the three call sites (multipart\n * upload, server-side multipart copy, parallel-ranged download) can\n * destructure the fields they want without re-deriving them:\n *\n * - `partNumber` is 1-based to match the B2 `b2_upload_part` /\n *   `b2_copy_part` wire format.\n * - `index` is 0-based for callers that key into a `Map` or array slot.\n * - `offset` + `length` are the upload-style framing (where in the\n *   source to read, how many bytes).\n * - `start` + `end` (both inclusive) are the HTTP `Range:` /\n *   `Content-Range:` framing.\n */\nexport interface RangePlan {\n  /** 1-based part number for B2 multipart endpoints. */\n  readonly partNumber: number\n  /** 0-based slot index for in-memory bookkeeping. */\n  readonly index: number\n  /** Inclusive byte offset where this range begins. */\n  readonly offset: number\n  /** Number of bytes in this range. */\n  readonly length: number\n  /** Alias for {@link offset} — convenient for `bytes=start-end` formatters. */\n  readonly start: number\n  /** Inclusive byte offset where this range ends (`offset + length - 1`). */\n  readonly end: number\n}\n\n/**\n * Lays out a sequence of contiguous, non-overlapping byte ranges over\n * `[0, totalSize)`. Every produced range is at most `chunkSize` bytes\n * long; the final range may be shorter if `totalSize` is not a multiple\n * of `chunkSize`.\n *\n * Replaces three near-identical hand-rolled loops in\n * `upload/large.ts`, `copy/large.ts`, and `download/parallel.ts`.\n *\n * @param totalSize - Total number of bytes to cover.\n * @param chunkSize - Target size of each range in bytes (last range may be smaller).\n *\n * @returns Ordered, non-overlapping range plans. Empty array when `totalSize === 0`.\n */\nexport function planRanges(totalSize: number, chunkSize: number): RangePlan[] {\n  const plans: RangePlan[] = []\n  let offset = 0\n  let index = 0\n  while (offset < totalSize) {\n    const length = Math.min(chunkSize, totalSize - offset)\n    const end = offset + length - 1\n    plans.push({\n      partNumber: index + 1,\n      index,\n      offset,\n      length,\n      start: offset,\n      end,\n    })\n    offset += length\n    index++\n  }\n  return plans\n}\n\n/**\n * Format an HTTP `Range:` request-header value covering the given\n * inclusive byte offsets. Centralises the `bytes=<start>-<end>` template\n * so the upload, copy, and download paths agree on syntax.\n *\n * @param start - Inclusive starting byte.\n * @param end - Inclusive ending byte.\n *\n * @returns The header value (e.g. `'bytes=0-99'`).\n */\nexport function byteRangeHeader(start: number, end: number): string {\n  return `bytes=${start}-${end}`\n}\n"],"mappings":";;;;;;;;;;;;;;;AA4CA,SAAgB,WAAW,WAAmB,WAAgC;CAC5E,MAAM,QAAqB,CAAC;CAC5B,IAAI,SAAS;CACb,IAAI,QAAQ;CACZ,OAAO,SAAS,WAAW;EACzB,MAAM,SAAS,KAAK,IAAI,WAAW,YAAY,MAAM;EACrD,MAAM,MAAM,SAAS,SAAS;EAC9B,MAAM,KAAK;GACT,YAAY,QAAQ;GACpB;GACA;GACA;GACA,OAAO;GACP;EACF,CAAC;EACD,UAAU;EACV;CACF;CACA,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,gBAAgB,OAAe,KAAqB;CAClE,OAAO,SAAS,MAAM,GAAG;AAC3B"}

package/dist/util/sha1.cjs

@@ -0,0 +1,27 @@
+//#region src/util/sha1.ts
+var sha1HexPattern = /^[0-9a-f]{40}$/i;
+/**
+* Returns whether a value is a verifiable 40-character hexadecimal SHA-1 digest.
+*
+* @param sha1 - SHA-1 value, or null/undefined when unavailable.
+*
+* @returns True when the value is a 40-character hexadecimal SHA-1 digest.
+*/
+function isVerifiableSha1(sha1) {
+	return sha1 !== null && sha1 !== void 0 && sha1HexPattern.test(sha1);
+}
+/**
+* Normalizes a verifiable SHA-1 digest to lowercase.
+*
+* @param sha1 - SHA-1 value, or null/undefined when unavailable.
+*
+* @returns A lowercase SHA-1 digest, or null when the value is not verifiable.
+*/
+function normalizeVerifiableSha1(sha1) {
+	return isVerifiableSha1(sha1) ? sha1.toLowerCase() : null;
+}
+//#endregion
+exports.isVerifiableSha1 = isVerifiableSha1;
+exports.normalizeVerifiableSha1 = normalizeVerifiableSha1;
+
+//# sourceMappingURL=sha1.cjs.map

package/dist/util/sha1.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1.cjs","names":[],"sources":["../../src/util/sha1.ts"],"sourcesContent":["const sha1HexPattern = /^[0-9a-f]{40}$/i\n\n/**\n * Returns whether a value is a verifiable 40-character hexadecimal SHA-1 digest.\n *\n * @param sha1 - SHA-1 value, or null/undefined when unavailable.\n *\n * @returns True when the value is a 40-character hexadecimal SHA-1 digest.\n */\nexport function isVerifiableSha1(sha1: string | null | undefined): sha1 is string {\n  return sha1 !== null && sha1 !== undefined && sha1HexPattern.test(sha1)\n}\n\n/**\n * Normalizes a verifiable SHA-1 digest to lowercase.\n *\n * @param sha1 - SHA-1 value, or null/undefined when unavailable.\n *\n * @returns A lowercase SHA-1 digest, or null when the value is not verifiable.\n */\nexport function normalizeVerifiableSha1(sha1: string | null | undefined): string | null {\n  return isVerifiableSha1(sha1) ? sha1.toLowerCase() : null\n}\n"],"mappings":";AAAA,IAAM,iBAAiB;;;;;;;;AASvB,SAAgB,iBAAiB,MAAiD;CAChF,OAAO,SAAS,QAAQ,SAAS,KAAA,KAAa,eAAe,KAAK,IAAI;AACxE;;;;;;;;AASA,SAAgB,wBAAwB,MAAgD;CACtF,OAAO,iBAAiB,IAAI,IAAI,KAAK,YAAY,IAAI;AACvD"}

package/dist/util/sha1.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Returns whether a value is a verifiable 40-character hexadecimal SHA-1 digest.
+ *
+ * @param sha1 - SHA-1 value, or null/undefined when unavailable.
+ *
+ * @returns True when the value is a 40-character hexadecimal SHA-1 digest.
+ */
+export declare function isVerifiableSha1(sha1: string | null | undefined): sha1 is string;
+/**
+ * Normalizes a verifiable SHA-1 digest to lowercase.
+ *
+ * @param sha1 - SHA-1 value, or null/undefined when unavailable.
+ *
+ * @returns A lowercase SHA-1 digest, or null when the value is not verifiable.
+ */
+export declare function normalizeVerifiableSha1(sha1: string | null | undefined): string | null;
+//# sourceMappingURL=sha1.d.ts.map

package/dist/util/sha1.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1.d.ts","sourceRoot":"","sources":["../../src/util/sha1.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,IAAI,MAAM,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEtF"}

package/dist/util/sha1.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns whether a value is a verifiable 40-character hexadecimal SHA-1 digest.
+ *
+ * @param sha1 - SHA-1 value, or null/undefined when unavailable.
+ *
+ * @returns True when the value is a 40-character hexadecimal SHA-1 digest.
+ */
+export declare function isVerifiableSha1(sha1: string | null | undefined): sha1 is string;
+/**
+ * Normalizes a verifiable SHA-1 digest to lowercase.
+ *
+ * @param sha1 - SHA-1 value, or null/undefined when unavailable.
+ *
+ * @returns A lowercase SHA-1 digest, or null when the value is not verifiable.
+ */
+export declare function normalizeVerifiableSha1(sha1: string | null | undefined): string | null;
+//# sourceMappingURL=sha1.d.ts.map

package/dist/util/sha1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1.d.ts","sourceRoot":"","sources":["../../src/util/sha1.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,IAAI,MAAM,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEtF"}

package/dist/util/sha1.js

@@ -0,0 +1,26 @@
+//#region src/util/sha1.ts
+var sha1HexPattern = /^[0-9a-f]{40}$/i;
+/**
+* Returns whether a value is a verifiable 40-character hexadecimal SHA-1 digest.
+*
+* @param sha1 - SHA-1 value, or null/undefined when unavailable.
+*
+* @returns True when the value is a 40-character hexadecimal SHA-1 digest.
+*/
+function isVerifiableSha1(sha1) {
+	return sha1 !== null && sha1 !== void 0 && sha1HexPattern.test(sha1);
+}
+/**
+* Normalizes a verifiable SHA-1 digest to lowercase.
+*
+* @param sha1 - SHA-1 value, or null/undefined when unavailable.
+*
+* @returns A lowercase SHA-1 digest, or null when the value is not verifiable.
+*/
+function normalizeVerifiableSha1(sha1) {
+	return isVerifiableSha1(sha1) ? sha1.toLowerCase() : null;
+}
+//#endregion
+export { isVerifiableSha1, normalizeVerifiableSha1 };
+
+//# sourceMappingURL=sha1.js.map

package/dist/util/sha1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1.js","names":[],"sources":["../../src/util/sha1.ts"],"sourcesContent":["const sha1HexPattern = /^[0-9a-f]{40}$/i\n\n/**\n * Returns whether a value is a verifiable 40-character hexadecimal SHA-1 digest.\n *\n * @param sha1 - SHA-1 value, or null/undefined when unavailable.\n *\n * @returns True when the value is a 40-character hexadecimal SHA-1 digest.\n */\nexport function isVerifiableSha1(sha1: string | null | undefined): sha1 is string {\n  return sha1 !== null && sha1 !== undefined && sha1HexPattern.test(sha1)\n}\n\n/**\n * Normalizes a verifiable SHA-1 digest to lowercase.\n *\n * @param sha1 - SHA-1 value, or null/undefined when unavailable.\n *\n * @returns A lowercase SHA-1 digest, or null when the value is not verifiable.\n */\nexport function normalizeVerifiableSha1(sha1: string | null | undefined): string | null {\n  return isVerifiableSha1(sha1) ? sha1.toLowerCase() : null\n}\n"],"mappings":";AAAA,IAAM,iBAAiB;;;;;;;;AASvB,SAAgB,iBAAiB,MAAiD;CAChF,OAAO,SAAS,QAAQ,SAAS,KAAA,KAAa,eAAe,KAAK,IAAI;AACxE;;;;;;;;AASA,SAAgB,wBAAwB,MAAgD;CACtF,OAAO,iBAAiB,IAAI,IAAI,KAAK,YAAY,IAAI;AACvD"}

package/dist/util/text-codec.cjs

@@ -1,7 +1,31 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const utf8Encoder = new TextEncoder();
-const utf8Decoder = new TextDecoder();
+//#region src/util/text-codec.ts
+/**
+* Shared UTF-8 codec singletons.
+*
+* Every byte boundary in this SDK is UTF-8: JSON request and response bodies,
+* webhook payloads, simulator stream chunks, and B2 percent-encoding inputs.
+* Allocating a fresh `TextEncoder` / `TextDecoder` per call is wasteful and
+* makes the encoding assumption invisible. Importing these constants makes
+* "we use UTF-8" explicit at every call site and avoids the per-call
+* allocation entirely.
+*
+* Both classes are spec-defined as stateless across encode / decode calls,
+* so a process-wide singleton is safe.
+*
+* @packageDocumentation
+*/
+/**
+* Process-wide UTF-8 `TextEncoder`. Use this instead of
+* `new TextEncoder()` for any string → bytes conversion in the SDK.
+*/
+var utf8Encoder = new TextEncoder();
+/**
+* Process-wide UTF-8 `TextDecoder`. Use this instead of
+* `new TextDecoder()` for any bytes → string conversion in the SDK.
+*/
+var utf8Decoder = new TextDecoder();
+//#endregion
 exports.utf8Decoder = utf8Decoder;
 exports.utf8Encoder = utf8Encoder;
-//# sourceMappingURL=text-codec.cjs.map
+
+//# sourceMappingURL=text-codec.cjs.map

package/dist/util/text-codec.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"text-codec.cjs","sources":["../../src/util/text-codec.ts"],"sourcesContent":["/**\n * Shared UTF-8 codec singletons.\n *\n * Every byte boundary in this SDK is UTF-8: JSON request and response bodies,\n * webhook payloads, simulator stream chunks, and B2 percent-encoding inputs.\n * Allocating a fresh `TextEncoder` / `TextDecoder` per call is wasteful and\n * makes the encoding assumption invisible. Importing these constants makes\n * \"we use UTF-8\" explicit at every call site and avoids the per-call\n * allocation entirely.\n *\n * Both classes are spec-defined as stateless across encode / decode calls,\n * so a process-wide singleton is safe.\n *\n * @packageDocumentation\n */\n\n/**\n * Process-wide UTF-8 `TextEncoder`. Use this instead of\n * `new TextEncoder()` for any string → bytes conversion in the SDK.\n */\nexport const utf8Encoder = new TextEncoder()\n\n/**\n * Process-wide UTF-8 `TextDecoder`. Use this instead of\n * `new TextDecoder()` for any bytes → string conversion in the SDK.\n */\nexport const utf8Decoder = new TextDecoder()\n"],"names":[],"mappings":";;AAoBO,MAAM,cAAc,IAAI,YAAA;AAMxB,MAAM,cAAc,IAAI,YAAA;;;"}
+{"version":3,"file":"text-codec.cjs","names":[],"sources":["../../src/util/text-codec.ts"],"sourcesContent":["/**\n * Shared UTF-8 codec singletons.\n *\n * Every byte boundary in this SDK is UTF-8: JSON request and response bodies,\n * webhook payloads, simulator stream chunks, and B2 percent-encoding inputs.\n * Allocating a fresh `TextEncoder` / `TextDecoder` per call is wasteful and\n * makes the encoding assumption invisible. Importing these constants makes\n * \"we use UTF-8\" explicit at every call site and avoids the per-call\n * allocation entirely.\n *\n * Both classes are spec-defined as stateless across encode / decode calls,\n * so a process-wide singleton is safe.\n *\n * @packageDocumentation\n */\n\n/**\n * Process-wide UTF-8 `TextEncoder`. Use this instead of\n * `new TextEncoder()` for any string → bytes conversion in the SDK.\n */\nexport const utf8Encoder = new TextEncoder()\n\n/**\n * Process-wide UTF-8 `TextDecoder`. Use this instead of\n * `new TextDecoder()` for any bytes → string conversion in the SDK.\n */\nexport const utf8Decoder = new TextDecoder()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,cAAc,IAAI,YAAY;;;;;AAM3C,IAAa,cAAc,IAAI,YAAY"}

package/dist/util/text-codec.js

@@ -1,7 +1,30 @@
-const utf8Encoder = new TextEncoder();
-const utf8Decoder = new TextDecoder();
-export {
-  utf8Decoder,
-  utf8Encoder
-};
-//# sourceMappingURL=text-codec.js.map
+//#region src/util/text-codec.ts
+/**
+* Shared UTF-8 codec singletons.
+*
+* Every byte boundary in this SDK is UTF-8: JSON request and response bodies,
+* webhook payloads, simulator stream chunks, and B2 percent-encoding inputs.
+* Allocating a fresh `TextEncoder` / `TextDecoder` per call is wasteful and
+* makes the encoding assumption invisible. Importing these constants makes
+* "we use UTF-8" explicit at every call site and avoids the per-call
+* allocation entirely.
+*
+* Both classes are spec-defined as stateless across encode / decode calls,
+* so a process-wide singleton is safe.
+*
+* @packageDocumentation
+*/
+/**
+* Process-wide UTF-8 `TextEncoder`. Use this instead of
+* `new TextEncoder()` for any string → bytes conversion in the SDK.
+*/
+var utf8Encoder = new TextEncoder();
+/**
+* Process-wide UTF-8 `TextDecoder`. Use this instead of
+* `new TextDecoder()` for any bytes → string conversion in the SDK.
+*/
+var utf8Decoder = new TextDecoder();
+//#endregion
+export { utf8Decoder, utf8Encoder };
+
+//# sourceMappingURL=text-codec.js.map

package/dist/util/text-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-codec.js","sources":["../../src/util/text-codec.ts"],"sourcesContent":["/**\n * Shared UTF-8 codec singletons.\n *\n * Every byte boundary in this SDK is UTF-8: JSON request and response bodies,\n * webhook payloads, simulator stream chunks, and B2 percent-encoding inputs.\n * Allocating a fresh `TextEncoder` / `TextDecoder` per call is wasteful and\n * makes the encoding assumption invisible. Importing these constants makes\n * \"we use UTF-8\" explicit at every call site and avoids the per-call\n * allocation entirely.\n *\n * Both classes are spec-defined as stateless across encode / decode calls,\n * so a process-wide singleton is safe.\n *\n * @packageDocumentation\n */\n\n/**\n * Process-wide UTF-8 `TextEncoder`. Use this instead of\n * `new TextEncoder()` for any string → bytes conversion in the SDK.\n */\nexport const utf8Encoder = new TextEncoder()\n\n/**\n * Process-wide UTF-8 `TextDecoder`. Use this instead of\n * `new TextDecoder()` for any bytes → string conversion in the SDK.\n */\nexport const utf8Decoder = new TextDecoder()\n"],"names":[],"mappings":"AAoBO,MAAM,cAAc,IAAI,YAAA;AAMxB,MAAM,cAAc,IAAI,YAAA;"}
+{"version":3,"file":"text-codec.js","names":[],"sources":["../../src/util/text-codec.ts"],"sourcesContent":["/**\n * Shared UTF-8 codec singletons.\n *\n * Every byte boundary in this SDK is UTF-8: JSON request and response bodies,\n * webhook payloads, simulator stream chunks, and B2 percent-encoding inputs.\n * Allocating a fresh `TextEncoder` / `TextDecoder` per call is wasteful and\n * makes the encoding assumption invisible. Importing these constants makes\n * \"we use UTF-8\" explicit at every call site and avoids the per-call\n * allocation entirely.\n *\n * Both classes are spec-defined as stateless across encode / decode calls,\n * so a process-wide singleton is safe.\n *\n * @packageDocumentation\n */\n\n/**\n * Process-wide UTF-8 `TextEncoder`. Use this instead of\n * `new TextEncoder()` for any string → bytes conversion in the SDK.\n */\nexport const utf8Encoder = new TextEncoder()\n\n/**\n * Process-wide UTF-8 `TextDecoder`. Use this instead of\n * `new TextDecoder()` for any bytes → string conversion in the SDK.\n */\nexport const utf8Decoder = new TextDecoder()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,cAAc,IAAI,YAAY;;;;;AAM3C,IAAa,cAAc,IAAI,YAAY"}

package/dist/util/to-error.cjs

@@ -1,7 +1,21 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/util/to-error.ts
+/**
+* Coerce an unknown caught value to a real error instance.
+*
+* Existing error objects pass through unchanged so call sites preserve
+* the original stack and any subclass identity. Other values are
+* wrapped in a fresh Error whose message is `String(value)`. Centralises
+* the conditional that previously recurred at every async-boundary
+* catch site in the upload, copy, sync, and stream paths.
+*
+* @param value - Value caught from a `try`/`catch` or rejected promise.
+*
+* @returns An `Error` representing `value`.
+*/
 function toError(value) {
-  return value instanceof Error ? value : new Error(String(value));
+	return value instanceof Error ? value : new Error(String(value));
 }
+//#endregion
 exports.toError = toError;
-//# sourceMappingURL=to-error.cjs.map
+
+//# sourceMappingURL=to-error.cjs.map

package/dist/util/to-error.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"to-error.cjs","sources":["../../src/util/to-error.ts"],"sourcesContent":["/**\n * Coerce an unknown caught value to a real error instance.\n *\n * Existing error objects pass through unchanged so call sites preserve\n * the original stack and any subclass identity. Other values are\n * wrapped in a fresh Error whose message is `String(value)`. Centralises\n * the conditional that previously recurred at every async-boundary\n * catch site in the upload, copy, sync, and stream paths.\n *\n * @param value - Value caught from a `try`/`catch` or rejected promise.\n *\n * @returns An `Error` representing `value`.\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n"],"names":[],"mappings":";;AAaO,SAAS,QAAQ,OAAuB;AAC7C,SAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;;"}
+{"version":3,"file":"to-error.cjs","names":[],"sources":["../../src/util/to-error.ts"],"sourcesContent":["/**\n * Coerce an unknown caught value to a real error instance.\n *\n * Existing error objects pass through unchanged so call sites preserve\n * the original stack and any subclass identity. Other values are\n * wrapped in a fresh Error whose message is `String(value)`. Centralises\n * the conditional that previously recurred at every async-boundary\n * catch site in the upload, copy, sync, and stream paths.\n *\n * @param value - Value caught from a `try`/`catch` or rejected promise.\n *\n * @returns An `Error` representing `value`.\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE"}

package/dist/util/to-error.js

@@ -1,7 +1,21 @@
+//#region src/util/to-error.ts
+/**
+* Coerce an unknown caught value to a real error instance.
+*
+* Existing error objects pass through unchanged so call sites preserve
+* the original stack and any subclass identity. Other values are
+* wrapped in a fresh Error whose message is `String(value)`. Centralises
+* the conditional that previously recurred at every async-boundary
+* catch site in the upload, copy, sync, and stream paths.
+*
+* @param value - Value caught from a `try`/`catch` or rejected promise.
+*
+* @returns An `Error` representing `value`.
+*/
 function toError(value) {
-  return value instanceof Error ? value : new Error(String(value));
+	return value instanceof Error ? value : new Error(String(value));
 }
-export {
-  toError
-};
-//# sourceMappingURL=to-error.js.map
+//#endregion
+export { toError };
+
+//# sourceMappingURL=to-error.js.map

package/dist/util/to-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-error.js","sources":["../../src/util/to-error.ts"],"sourcesContent":["/**\n * Coerce an unknown caught value to a real error instance.\n *\n * Existing error objects pass through unchanged so call sites preserve\n * the original stack and any subclass identity. Other values are\n * wrapped in a fresh Error whose message is `String(value)`. Centralises\n * the conditional that previously recurred at every async-boundary\n * catch site in the upload, copy, sync, and stream paths.\n *\n * @param value - Value caught from a `try`/`catch` or rejected promise.\n *\n * @returns An `Error` representing `value`.\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n"],"names":[],"mappings":"AAaO,SAAS,QAAQ,OAAuB;AAC7C,SAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;"}
+{"version":3,"file":"to-error.js","names":[],"sources":["../../src/util/to-error.ts"],"sourcesContent":["/**\n * Coerce an unknown caught value to a real error instance.\n *\n * Existing error objects pass through unchanged so call sites preserve\n * the original stack and any subclass identity. Other values are\n * wrapped in a fresh Error whose message is `String(value)`. Centralises\n * the conditional that previously recurred at every async-boundary\n * catch site in the upload, copy, sync, and stream paths.\n *\n * @param value - Value caught from a `try`/`catch` or rejected promise.\n *\n * @returns An `Error` representing `value`.\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE"}

package/dist/version.cjs

@@ -1,6 +1,18 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const _package = require("./package.json.cjs");
-const VERSION = _package.default.version;
+//#region src/version.ts
+/**
+* Current SDK version. Read directly from package.json so there is no
+* second-source-of-truth to keep in sync — bumping `version` in package.json
+* automatically propagates here, into the SDK's User-Agent header, and into
+* the published artifact.
+*
+* Works in every runtime the SDK targets:
+*   - Node 22.3+, Bun, Deno: native JSON import attributes.
+*   - Vite builds: the JSON import is replaced with a version-only shim so
+*     published runtime chunks do not carry unrelated package metadata.
+*   - Vitest browser mode: Vite handles the import the same way as build.
+*/
+var VERSION = require("./_virtual/_b2-sdk-version-json.cjs").default.version;
+//#endregion
 exports.VERSION = VERSION;
-//# sourceMappingURL=version.cjs.map
+
+//# sourceMappingURL=version.cjs.map

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here, into the SDK's User-Agent header, and into\n * the published artifact.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22+, Bun, Deno: native JSON import attributes.\n *   - Vite / esbuild / rollup builds: the JSON import is statically inlined\n *     as a JS module exporting the parsed object.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n"],"names":["pkg"],"mappings":";;;AAcO,MAAM,UAAkBA,SAAAA,QAAI;;"}
+{"version":3,"file":"version.cjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here, into the SDK's User-Agent header, and into\n * the published artifact.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22.3+, Bun, Deno: native JSON import attributes.\n *   - Vite builds: the JSON import is replaced with a version-only shim so\n *     published runtime chunks do not carry unrelated package metadata.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n"],"mappings":";;;;;;;;;;;;;AAcA,IAAa,uDAAkB,CAAA,CAAA,QAAI"}

package/dist/version.d.cts

@@ -5,9 +5,9 @@
  * the published artifact.
  *
  * Works in every runtime the SDK targets:
- *   - Node 22+, Bun, Deno: native JSON import attributes.
- *   - Vite / esbuild / rollup builds: the JSON import is statically inlined
- *     as a JS module exporting the parsed object.
+ *   - Node 22.3+, Bun, Deno: native JSON import attributes.
+ *   - Vite builds: the JSON import is replaced with a version-only shim so
+ *     published runtime chunks do not carry unrelated package metadata.
  *   - Vitest browser mode: Vite handles the import the same way as build.
  */
 export declare const VERSION: string;

package/dist/version.d.ts

@@ -5,9 +5,9 @@
  * the published artifact.
  *
  * Works in every runtime the SDK targets:
- *   - Node 22+, Bun, Deno: native JSON import attributes.
- *   - Vite / esbuild / rollup builds: the JSON import is statically inlined
- *     as a JS module exporting the parsed object.
+ *   - Node 22.3+, Bun, Deno: native JSON import attributes.
+ *   - Vite builds: the JSON import is replaced with a version-only shim so
+ *     published runtime chunks do not carry unrelated package metadata.
  *   - Vitest browser mode: Vite handles the import the same way as build.
  */
 export declare const VERSION: string;

package/dist/version.js

@@ -1,6 +1,19 @@
-import pkg from "./package.json.js";
-const VERSION = pkg.version;
-export {
-  VERSION
-};
-//# sourceMappingURL=version.js.map
+import _b2_sdk_version_json_default from "./_virtual/_b2-sdk-version-json.js";
+//#region src/version.ts
+/**
+* Current SDK version. Read directly from package.json so there is no
+* second-source-of-truth to keep in sync — bumping `version` in package.json
+* automatically propagates here, into the SDK's User-Agent header, and into
+* the published artifact.
+*
+* Works in every runtime the SDK targets:
+*   - Node 22.3+, Bun, Deno: native JSON import attributes.
+*   - Vite builds: the JSON import is replaced with a version-only shim so
+*     published runtime chunks do not carry unrelated package metadata.
+*   - Vitest browser mode: Vite handles the import the same way as build.
+*/
+var VERSION = _b2_sdk_version_json_default.version;
+//#endregion
+export { VERSION };
+
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here, into the SDK's User-Agent header, and into\n * the published artifact.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22+, Bun, Deno: native JSON import attributes.\n *   - Vite / esbuild / rollup builds: the JSON import is statically inlined\n *     as a JS module exporting the parsed object.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n"],"names":[],"mappings":";AAcO,MAAM,UAAkB,IAAI;"}
+{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here, into the SDK's User-Agent header, and into\n * the published artifact.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22.3+, Bun, Deno: native JSON import attributes.\n *   - Vite builds: the JSON import is replaced with a version-only shim so\n *     published runtime chunks do not carry unrelated package metadata.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n"],"mappings":";;;;;;;;;;;;;;AAcA,IAAa,UAAkB,6BAAI"}