@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/upload/concurrency.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"concurrency.cjs","sources":["../../src/upload/concurrency.ts"],"sourcesContent":["/**\n * Bounded concurrency primitive.\n *\n * Limits the number of concurrent operations to a fixed maximum. Callers\n * {@link acquire} a slot before starting work and {@link release} it when done.\n * If all slots are taken, `acquire` returns a promise that resolves when a slot\n * becomes available.\n */\nexport class Semaphore {\n  private current = 0\n  private readonly queue: (() => void)[] = []\n\n  /**\n   * @param limit - Maximum number of concurrent acquisitions. Must be a\n   *   positive integer; values `<= 0` would create a semaphore that\n   *   never lets anything through (all `acquire()` calls would queue\n   *   forever), so the constructor throws fast instead.\n   *\n   * @throws `RangeError` when `limit` is not a positive integer.\n   */\n  constructor(private readonly limit: number) {\n    if (!Number.isInteger(limit) || limit <= 0) {\n      throw new RangeError(\n        `Semaphore limit must be a positive integer; received ${limit}. A non-positive limit produces a deadlocked semaphore — fail fast at construction instead.`,\n      )\n    }\n  }\n\n  /**\n   * Acquires a slot, waiting if the limit has been reached.\n   * @returns A promise that resolves when a slot is available.\n   */\n  async acquire(): Promise<void> {\n    if (this.current < this.limit) {\n      this.current++\n      return\n    }\n    return new Promise<void>((resolve) => {\n      this.queue.push(resolve)\n    })\n  }\n\n  /** Releases a slot, unblocking the next queued caller if any. */\n  release(): void {\n    const next = this.queue.shift()\n    if (next) {\n      next()\n    } else {\n      this.current--\n    }\n  }\n\n  /**\n   * Number of slots currently available.\n   *\n   * @returns The count of free concurrency slots.\n   */\n  get available(): number {\n    return this.limit - this.current\n  }\n}\n\n/**\n * Maps over an array with bounded concurrency.\n *\n * @param items - Input items to process.\n * @param concurrency - Maximum number of items processed in parallel.\n * @param fn - Async function applied to each item.\n *\n * @returns Results in the same order as the input items.\n */\nexport async function mapConcurrent<T, R>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>,\n): Promise<R[]> {\n  const sem = new Semaphore(concurrency)\n  const results: R[] = new Array(items.length)\n  const tasks = items.map(async (item, i) => {\n    await sem.acquire()\n    try {\n      results[i] = await fn(item, i)\n    } finally {\n      sem.release()\n    }\n  })\n  await Promise.all(tasks)\n  return results\n}\n"],"names":[],"mappings":";;AAQO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYrB,YAA6B,OAAe;AAAf,SAAA,QAAA;AAC3B,QAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GAAG;AAC1C,YAAM,IAAI;AAAA,QACR,wDAAwD,KAAK;AAAA,MAAA;AAAA,IAEjE;AAAA,EACF;AAAA,EAjBQ,UAAU;AAAA,EACD,QAAwB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBzC,MAAM,UAAyB;AAC7B,QAAI,KAAK,UAAU,KAAK,OAAO;AAC7B,WAAK;AACL;AAAA,IACF;AACA,WAAO,IAAI,QAAc,CAAC,YAAY;AACpC,WAAK,MAAM,KAAK,OAAO;AAAA,IACzB,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,UAAgB;AACd,UAAM,OAAO,KAAK,MAAM,MAAA;AACxB,QAAI,MAAM;AACR,WAAA;AAAA,IACF,OAAO;AACL,WAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,YAAoB;AACtB,WAAO,KAAK,QAAQ,KAAK;AAAA,EAC3B;AACF;;"}
+{"version":3,"file":"concurrency.cjs","names":[],"sources":["../../src/upload/concurrency.ts"],"sourcesContent":["/**\n * Bounded concurrency primitive.\n *\n * Limits the number of concurrent operations to a fixed maximum. Callers\n * {@link acquire} a slot before starting work and {@link release} it when done.\n * If all slots are taken, `acquire` returns a promise that resolves when a slot\n * becomes available.\n */\nexport class Semaphore {\n  private current = 0\n  private readonly queue: (() => void)[] = []\n\n  /**\n   * @param limit - Maximum number of concurrent acquisitions. Must be a\n   *   positive integer; values `<= 0` would create a semaphore that\n   *   never lets anything through (all `acquire()` calls would queue\n   *   forever), so the constructor throws fast instead.\n   *\n   * @throws `RangeError` when `limit` is not a positive integer.\n   */\n  constructor(private readonly limit: number) {\n    if (!Number.isInteger(limit) || limit <= 0) {\n      throw new RangeError(\n        `Semaphore limit must be a positive integer; received ${limit}. A non-positive limit produces a deadlocked semaphore — fail fast at construction instead.`,\n      )\n    }\n  }\n\n  /**\n   * Acquires a slot, waiting if the limit has been reached.\n   * @returns A promise that resolves when a slot is available.\n   */\n  async acquire(): Promise<void> {\n    if (this.current < this.limit) {\n      this.current++\n      return\n    }\n    return new Promise<void>((resolve) => {\n      this.queue.push(resolve)\n    })\n  }\n\n  /** Releases a slot, unblocking the next queued caller if any. */\n  release(): void {\n    const next = this.queue.shift()\n    if (next) {\n      next()\n    } else {\n      this.current--\n    }\n  }\n\n  /**\n   * Number of slots currently available.\n   *\n   * @returns The count of free concurrency slots.\n   */\n  get available(): number {\n    return this.limit - this.current\n  }\n}\n\n/**\n * Maps over an array with bounded concurrency.\n *\n * @param items - Input items to process.\n * @param concurrency - Maximum number of items processed in parallel.\n * @param fn - Async function applied to each item.\n *\n * @returns Results in the same order as the input items.\n */\nexport async function mapConcurrent<T, R>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>,\n): Promise<R[]> {\n  const sem = new Semaphore(concurrency)\n  const results: R[] = new Array(items.length)\n  const tasks = items.map(async (item, i) => {\n    await sem.acquire()\n    try {\n      results[i] = await fn(item, i)\n    } finally {\n      sem.release()\n    }\n  })\n  await Promise.all(tasks)\n  return results\n}\n"],"mappings":";;;;;;;;;AAQA,IAAa,YAAb,MAAuB;CAYQ;CAX7B,UAAkB;CAClB,QAAyC,CAAC;;;;;;;;;CAU1C,YAAY,OAAgC;EAAf,KAAA,QAAA;EAC3B,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,WACR,wDAAwD,MAAM,4FAChE;CAEJ;;;;;CAMA,MAAM,UAAyB;EAC7B,IAAI,KAAK,UAAU,KAAK,OAAO;GAC7B,KAAK;GACL;EACF;EACA,OAAO,IAAI,SAAe,YAAY;GACpC,KAAK,MAAM,KAAK,OAAO;EACzB,CAAC;CACH;;CAGA,UAAgB;EACd,MAAM,OAAO,KAAK,MAAM,MAAM;EAC9B,IAAI,MACF,KAAK;OAEL,KAAK;CAET;;;;;;CAOA,IAAI,YAAoB;EACtB,OAAO,KAAK,QAAQ,KAAK;CAC3B;AACF;;;;;;;;;;AAWA,eAAsB,cACpB,OACA,aACA,IACc;CACd,MAAM,MAAM,IAAI,UAAU,WAAW;CACrC,MAAM,UAAe,IAAI,MAAM,MAAM,MAAM;CAC3C,MAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,MAAM;EACzC,MAAM,IAAI,QAAQ;EAClB,IAAI;GACF,QAAQ,KAAK,MAAM,GAAG,MAAM,CAAC;EAC/B,UAAU;GACR,IAAI,QAAQ;EACd;CACF,CAAC;CACD,MAAM,QAAQ,IAAI,KAAK;CACvB,OAAO;AACT"}

package/dist/upload/concurrency.js

@@ -1,54 +1,80 @@
-class Semaphore {
-  /**
-   * @param limit - Maximum number of concurrent acquisitions. Must be a
-   *   positive integer; values `<= 0` would create a semaphore that
-   *   never lets anything through (all `acquire()` calls would queue
-   *   forever), so the constructor throws fast instead.
-   *
-   * @throws `RangeError` when `limit` is not a positive integer.
-   */
-  constructor(limit) {
-    this.limit = limit;
-    if (!Number.isInteger(limit) || limit <= 0) {
-      throw new RangeError(
-        `Semaphore limit must be a positive integer; received ${limit}. A non-positive limit produces a deadlocked semaphore — fail fast at construction instead.`
-      );
-    }
-  }
-  current = 0;
-  queue = [];
-  /**
-   * Acquires a slot, waiting if the limit has been reached.
-   * @returns A promise that resolves when a slot is available.
-   */
-  async acquire() {
-    if (this.current < this.limit) {
-      this.current++;
-      return;
-    }
-    return new Promise((resolve) => {
-      this.queue.push(resolve);
-    });
-  }
-  /** Releases a slot, unblocking the next queued caller if any. */
-  release() {
-    const next = this.queue.shift();
-    if (next) {
-      next();
-    } else {
-      this.current--;
-    }
-  }
-  /**
-   * Number of slots currently available.
-   *
-   * @returns The count of free concurrency slots.
-   */
-  get available() {
-    return this.limit - this.current;
-  }
-}
-export {
-  Semaphore
+//#region src/upload/concurrency.ts
+/**
+* Bounded concurrency primitive.
+*
+* Limits the number of concurrent operations to a fixed maximum. Callers
+* {@link acquire} a slot before starting work and {@link release} it when done.
+* If all slots are taken, `acquire` returns a promise that resolves when a slot
+* becomes available.
+*/
+var Semaphore = class {
+	limit;
+	current = 0;
+	queue = [];
+	/**
+	* @param limit - Maximum number of concurrent acquisitions. Must be a
+	*   positive integer; values `<= 0` would create a semaphore that
+	*   never lets anything through (all `acquire()` calls would queue
+	*   forever), so the constructor throws fast instead.
+	*
+	* @throws `RangeError` when `limit` is not a positive integer.
+	*/
+	constructor(limit) {
+		this.limit = limit;
+		if (!Number.isInteger(limit) || limit <= 0) throw new RangeError(`Semaphore limit must be a positive integer; received ${limit}. A non-positive limit produces a deadlocked semaphore — fail fast at construction instead.`);
+	}
+	/**
+	* Acquires a slot, waiting if the limit has been reached.
+	* @returns A promise that resolves when a slot is available.
+	*/
+	async acquire() {
+		if (this.current < this.limit) {
+			this.current++;
+			return;
+		}
+		return new Promise((resolve) => {
+			this.queue.push(resolve);
+		});
+	}
+	/** Releases a slot, unblocking the next queued caller if any. */
+	release() {
+		const next = this.queue.shift();
+		if (next) next();
+		else this.current--;
+	}
+	/**
+	* Number of slots currently available.
+	*
+	* @returns The count of free concurrency slots.
+	*/
+	get available() {
+		return this.limit - this.current;
+	}
 };
-//# sourceMappingURL=concurrency.js.map
+/**
+* Maps over an array with bounded concurrency.
+*
+* @param items - Input items to process.
+* @param concurrency - Maximum number of items processed in parallel.
+* @param fn - Async function applied to each item.
+*
+* @returns Results in the same order as the input items.
+*/
+async function mapConcurrent(items, concurrency, fn) {
+	const sem = new Semaphore(concurrency);
+	const results = new Array(items.length);
+	const tasks = items.map(async (item, i) => {
+		await sem.acquire();
+		try {
+			results[i] = await fn(item, i);
+		} finally {
+			sem.release();
+		}
+	});
+	await Promise.all(tasks);
+	return results;
+}
+//#endregion
+export { Semaphore, mapConcurrent };
+
+//# sourceMappingURL=concurrency.js.map

package/dist/upload/concurrency.js.map

@@ -1 +1 @@
-{"version":3,"file":"concurrency.js","sources":["../../src/upload/concurrency.ts"],"sourcesContent":["/**\n * Bounded concurrency primitive.\n *\n * Limits the number of concurrent operations to a fixed maximum. Callers\n * {@link acquire} a slot before starting work and {@link release} it when done.\n * If all slots are taken, `acquire` returns a promise that resolves when a slot\n * becomes available.\n */\nexport class Semaphore {\n  private current = 0\n  private readonly queue: (() => void)[] = []\n\n  /**\n   * @param limit - Maximum number of concurrent acquisitions. Must be a\n   *   positive integer; values `<= 0` would create a semaphore that\n   *   never lets anything through (all `acquire()` calls would queue\n   *   forever), so the constructor throws fast instead.\n   *\n   * @throws `RangeError` when `limit` is not a positive integer.\n   */\n  constructor(private readonly limit: number) {\n    if (!Number.isInteger(limit) || limit <= 0) {\n      throw new RangeError(\n        `Semaphore limit must be a positive integer; received ${limit}. A non-positive limit produces a deadlocked semaphore — fail fast at construction instead.`,\n      )\n    }\n  }\n\n  /**\n   * Acquires a slot, waiting if the limit has been reached.\n   * @returns A promise that resolves when a slot is available.\n   */\n  async acquire(): Promise<void> {\n    if (this.current < this.limit) {\n      this.current++\n      return\n    }\n    return new Promise<void>((resolve) => {\n      this.queue.push(resolve)\n    })\n  }\n\n  /** Releases a slot, unblocking the next queued caller if any. */\n  release(): void {\n    const next = this.queue.shift()\n    if (next) {\n      next()\n    } else {\n      this.current--\n    }\n  }\n\n  /**\n   * Number of slots currently available.\n   *\n   * @returns The count of free concurrency slots.\n   */\n  get available(): number {\n    return this.limit - this.current\n  }\n}\n\n/**\n * Maps over an array with bounded concurrency.\n *\n * @param items - Input items to process.\n * @param concurrency - Maximum number of items processed in parallel.\n * @param fn - Async function applied to each item.\n *\n * @returns Results in the same order as the input items.\n */\nexport async function mapConcurrent<T, R>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>,\n): Promise<R[]> {\n  const sem = new Semaphore(concurrency)\n  const results: R[] = new Array(items.length)\n  const tasks = items.map(async (item, i) => {\n    await sem.acquire()\n    try {\n      results[i] = await fn(item, i)\n    } finally {\n      sem.release()\n    }\n  })\n  await Promise.all(tasks)\n  return results\n}\n"],"names":[],"mappings":"AAQO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYrB,YAA6B,OAAe;AAAf,SAAA,QAAA;AAC3B,QAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GAAG;AAC1C,YAAM,IAAI;AAAA,QACR,wDAAwD,KAAK;AAAA,MAAA;AAAA,IAEjE;AAAA,EACF;AAAA,EAjBQ,UAAU;AAAA,EACD,QAAwB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBzC,MAAM,UAAyB;AAC7B,QAAI,KAAK,UAAU,KAAK,OAAO;AAC7B,WAAK;AACL;AAAA,IACF;AACA,WAAO,IAAI,QAAc,CAAC,YAAY;AACpC,WAAK,MAAM,KAAK,OAAO;AAAA,IACzB,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,UAAgB;AACd,UAAM,OAAO,KAAK,MAAM,MAAA;AACxB,QAAI,MAAM;AACR,WAAA;AAAA,IACF,OAAO;AACL,WAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,YAAoB;AACtB,WAAO,KAAK,QAAQ,KAAK;AAAA,EAC3B;AACF;"}
+{"version":3,"file":"concurrency.js","names":[],"sources":["../../src/upload/concurrency.ts"],"sourcesContent":["/**\n * Bounded concurrency primitive.\n *\n * Limits the number of concurrent operations to a fixed maximum. Callers\n * {@link acquire} a slot before starting work and {@link release} it when done.\n * If all slots are taken, `acquire` returns a promise that resolves when a slot\n * becomes available.\n */\nexport class Semaphore {\n  private current = 0\n  private readonly queue: (() => void)[] = []\n\n  /**\n   * @param limit - Maximum number of concurrent acquisitions. Must be a\n   *   positive integer; values `<= 0` would create a semaphore that\n   *   never lets anything through (all `acquire()` calls would queue\n   *   forever), so the constructor throws fast instead.\n   *\n   * @throws `RangeError` when `limit` is not a positive integer.\n   */\n  constructor(private readonly limit: number) {\n    if (!Number.isInteger(limit) || limit <= 0) {\n      throw new RangeError(\n        `Semaphore limit must be a positive integer; received ${limit}. A non-positive limit produces a deadlocked semaphore — fail fast at construction instead.`,\n      )\n    }\n  }\n\n  /**\n   * Acquires a slot, waiting if the limit has been reached.\n   * @returns A promise that resolves when a slot is available.\n   */\n  async acquire(): Promise<void> {\n    if (this.current < this.limit) {\n      this.current++\n      return\n    }\n    return new Promise<void>((resolve) => {\n      this.queue.push(resolve)\n    })\n  }\n\n  /** Releases a slot, unblocking the next queued caller if any. */\n  release(): void {\n    const next = this.queue.shift()\n    if (next) {\n      next()\n    } else {\n      this.current--\n    }\n  }\n\n  /**\n   * Number of slots currently available.\n   *\n   * @returns The count of free concurrency slots.\n   */\n  get available(): number {\n    return this.limit - this.current\n  }\n}\n\n/**\n * Maps over an array with bounded concurrency.\n *\n * @param items - Input items to process.\n * @param concurrency - Maximum number of items processed in parallel.\n * @param fn - Async function applied to each item.\n *\n * @returns Results in the same order as the input items.\n */\nexport async function mapConcurrent<T, R>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>,\n): Promise<R[]> {\n  const sem = new Semaphore(concurrency)\n  const results: R[] = new Array(items.length)\n  const tasks = items.map(async (item, i) => {\n    await sem.acquire()\n    try {\n      results[i] = await fn(item, i)\n    } finally {\n      sem.release()\n    }\n  })\n  await Promise.all(tasks)\n  return results\n}\n"],"mappings":";;;;;;;;;AAQA,IAAa,YAAb,MAAuB;CAYQ;CAX7B,UAAkB;CAClB,QAAyC,CAAC;;;;;;;;;CAU1C,YAAY,OAAgC;EAAf,KAAA,QAAA;EAC3B,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,WACR,wDAAwD,MAAM,4FAChE;CAEJ;;;;;CAMA,MAAM,UAAyB;EAC7B,IAAI,KAAK,UAAU,KAAK,OAAO;GAC7B,KAAK;GACL;EACF;EACA,OAAO,IAAI,SAAe,YAAY;GACpC,KAAK,MAAM,KAAK,OAAO;EACzB,CAAC;CACH;;CAGA,UAAgB;EACd,MAAM,OAAO,KAAK,MAAM,MAAM;EAC9B,IAAI,MACF,KAAK;OAEL,KAAK;CAET;;;;;;CAOA,IAAI,YAAoB;EACtB,OAAO,KAAK,QAAQ,KAAK;CAC3B;AACF;;;;;;;;;;AAWA,eAAsB,cACpB,OACA,aACA,IACc;CACd,MAAM,MAAM,IAAI,UAAU,WAAW;CACrC,MAAM,UAAe,IAAI,MAAM,MAAM,MAAM;CAC3C,MAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,MAAM;EACzC,MAAM,IAAI,QAAQ;EAClB,IAAI;GACF,QAAQ,KAAK,MAAM,GAAG,MAAM,CAAC;EAC/B,UAAU;GACR,IAAI,QAAQ;EACd;CACF,CAAC;CACD,MAAM,QAAQ,IAAI,KAAK;CACvB,OAAO;AACT"}

package/dist/upload/finish.cjs

@@ -0,0 +1,54 @@
+const require_errors_index = require("../errors/index.cjs");
+const require_abort = require("../util/abort.cjs");
+//#region src/upload/finish.ts
+/**
+* Calls `b2_finish_large_file` and classifies failures after dispatch that can
+* hide an already-committed file as ambiguous finish failures.
+*
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state.
+* @param context - Finish request data and reconciliation metadata.
+*
+* @returns The completed file version metadata.
+*/
+async function finishLargeFileWithAbortReconciliation(raw, accountInfo, context) {
+	context.signal?.throwIfAborted();
+	try {
+		return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			fileId: context.fileId,
+			partSha1Array: context.partSha1s
+		}, context.signal === void 0 && context.retry === void 0 ? void 0 : {
+			...context.signal !== void 0 ? { signal: context.signal } : {},
+			...context.retry !== void 0 ? { retry: context.retry } : {}
+		});
+	} catch (err) {
+		if (err instanceof require_errors_index.FinishLargeFileResponseBodyError) throw finishLargeFileResponseBodyErrorWithContext(err, context);
+		if (isAmbiguousFinishDispatchFailure(err, context.signal)) throw new require_errors_index.FinishLargeFileResponseBodyError("b2_finish_large_file failed after dispatch; final file state is ambiguous.", {
+			cause: err,
+			fileId: context.fileId,
+			bucketId: context.bucketId,
+			fileName: context.fileName
+		});
+		throw err;
+	}
+}
+function finishLargeFileResponseBodyErrorWithContext(err, context) {
+	if (err.fileId === context.fileId && err.bucketId === context.bucketId && err.fileName === context.fileName) return err;
+	return new require_errors_index.FinishLargeFileResponseBodyError(err.message, {
+		cause: err.cause ?? err,
+		fileId: context.fileId,
+		bucketId: context.bucketId,
+		fileName: context.fileName
+	});
+}
+function isAmbiguousFinishDispatchFailure(err, signal) {
+	if (err instanceof require_errors_index.NetworkError) return true;
+	if (require_abort.isTimeoutError(err)) return true;
+	if (signal?.aborted !== true) return false;
+	if (signal.reason !== void 0 && Object.is(err, signal.reason)) return true;
+	return require_abort.isAbortError(err);
+}
+//#endregion
+exports.finishLargeFileWithAbortReconciliation = finishLargeFileWithAbortReconciliation;
+
+//# sourceMappingURL=finish.cjs.map

package/dist/upload/finish.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.cjs","names":[],"sources":["../../src/upload/finish.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { FinishLargeFileResponseBodyError, NetworkError } from '../errors/index.ts'\nimport type { RetryOptions } from '../http/retry.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { FileVersion } from '../types/file.ts'\nimport type { BucketId, LargeFileId } from '../types/ids.ts'\nimport { isAbortError, isTimeoutError } from '../util/abort.ts'\n\n/** Context for safely finalizing a large file. */\nexport interface FinishLargeFileContext {\n  readonly fileId: LargeFileId\n  readonly bucketId: BucketId\n  readonly fileName: string\n  readonly partSha1s: readonly string[]\n  readonly signal?: AbortSignal\n  readonly retry?: Partial<RetryOptions>\n}\n\n/**\n * Calls `b2_finish_large_file` and classifies failures after dispatch that can\n * hide an already-committed file as ambiguous finish failures.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param context - Finish request data and reconciliation metadata.\n *\n * @returns The completed file version metadata.\n */\nexport async function finishLargeFileWithAbortReconciliation(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  context: FinishLargeFileContext,\n): Promise<FileVersion> {\n  context.signal?.throwIfAborted()\n  try {\n    return await raw.finishLargeFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      {\n        fileId: context.fileId,\n        partSha1Array: context.partSha1s,\n      },\n      context.signal === undefined && context.retry === undefined\n        ? undefined\n        : {\n            ...(context.signal !== undefined ? { signal: context.signal } : {}),\n            ...(context.retry !== undefined ? { retry: context.retry } : {}),\n          },\n    )\n  } catch (err) {\n    if (err instanceof FinishLargeFileResponseBodyError) {\n      throw finishLargeFileResponseBodyErrorWithContext(err, context)\n    }\n    if (isAmbiguousFinishDispatchFailure(err, context.signal)) {\n      throw new FinishLargeFileResponseBodyError(\n        'b2_finish_large_file failed after dispatch; final file state is ambiguous.',\n        {\n          cause: err,\n          fileId: context.fileId,\n          bucketId: context.bucketId,\n          fileName: context.fileName,\n        },\n      )\n    }\n    throw err\n  }\n}\n\nfunction finishLargeFileResponseBodyErrorWithContext(\n  err: FinishLargeFileResponseBodyError,\n  context: FinishLargeFileContext,\n): FinishLargeFileResponseBodyError {\n  if (\n    err.fileId === context.fileId &&\n    err.bucketId === context.bucketId &&\n    err.fileName === context.fileName\n  ) {\n    return err\n  }\n  return new FinishLargeFileResponseBodyError(err.message, {\n    cause: err.cause ?? err,\n    fileId: context.fileId,\n    bucketId: context.bucketId,\n    fileName: context.fileName,\n  })\n}\n\nfunction isAmbiguousFinishDispatchFailure(err: unknown, signal: AbortSignal | undefined): boolean {\n  if (err instanceof NetworkError) return true\n  if (isTimeoutError(err)) return true\n  if (signal?.aborted !== true) return false\n  if (signal.reason !== undefined && Object.is(err, signal.reason)) return true\n  return isAbortError(err)\n}\n"],"mappings":";;;;;;;;;;;;;AA4BA,eAAsB,uCACpB,KACA,aACA,SACsB;CACtB,QAAQ,QAAQ,eAAe;CAC/B,IAAI;EACF,OAAO,MAAM,IAAI,gBACf,YAAY,UAAU,GACtB,YAAY,aAAa,GACzB;GACE,QAAQ,QAAQ;GAChB,eAAe,QAAQ;EACzB,GACA,QAAQ,WAAW,KAAA,KAAa,QAAQ,UAAU,KAAA,IAC9C,KAAA,IACA;GACE,GAAI,QAAQ,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;GACjE,GAAI,QAAQ,UAAU,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EAChE,CACN;CACF,SAAS,KAAK;EACZ,IAAI,eAAe,qBAAA,kCACjB,MAAM,4CAA4C,KAAK,OAAO;EAEhE,IAAI,iCAAiC,KAAK,QAAQ,MAAM,GACtD,MAAM,IAAI,qBAAA,iCACR,8EACA;GACE,OAAO;GACP,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,UAAU,QAAQ;EACpB,CACF;EAEF,MAAM;CACR;AACF;AAEA,SAAS,4CACP,KACA,SACkC;CAClC,IACE,IAAI,WAAW,QAAQ,UACvB,IAAI,aAAa,QAAQ,YACzB,IAAI,aAAa,QAAQ,UAEzB,OAAO;CAET,OAAO,IAAI,qBAAA,iCAAiC,IAAI,SAAS;EACvD,OAAO,IAAI,SAAS;EACpB,QAAQ,QAAQ;EAChB,UAAU,QAAQ;EAClB,UAAU,QAAQ;CACpB,CAAC;AACH;AAEA,SAAS,iCAAiC,KAAc,QAA0C;CAChG,IAAI,eAAe,qBAAA,cAAc,OAAO;CACxC,IAAI,cAAA,eAAe,GAAG,GAAG,OAAO;CAChC,IAAI,QAAQ,YAAY,MAAM,OAAO;CACrC,IAAI,OAAO,WAAW,KAAA,KAAa,OAAO,GAAG,KAAK,OAAO,MAAM,GAAG,OAAO;CACzE,OAAO,cAAA,aAAa,GAAG;AACzB"}

package/dist/upload/finish.d.cts

@@ -0,0 +1,26 @@
+import { AccountInfo } from '../auth/account-info.js';
+import { RetryOptions } from '../http/retry.js';
+import { RawClient } from '../raw/index.js';
+import { FileVersion } from '../types/file.js';
+import { BucketId, LargeFileId } from '../types/ids.js';
+/** Context for safely finalizing a large file. */
+export interface FinishLargeFileContext {
+    readonly fileId: LargeFileId;
+    readonly bucketId: BucketId;
+    readonly fileName: string;
+    readonly partSha1s: readonly string[];
+    readonly signal?: AbortSignal;
+    readonly retry?: Partial<RetryOptions>;
+}
+/**
+ * Calls `b2_finish_large_file` and classifies failures after dispatch that can
+ * hide an already-committed file as ambiguous finish failures.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param context - Finish request data and reconciliation metadata.
+ *
+ * @returns The completed file version metadata.
+ */
+export declare function finishLargeFileWithAbortReconciliation(raw: RawClient, accountInfo: AccountInfo, context: FinishLargeFileContext): Promise<FileVersion>;
+//# sourceMappingURL=finish.d.ts.map

package/dist/upload/finish.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../src/upload/finish.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG5D,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,sCAAsC,CAC1D,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAkCtB"}

package/dist/upload/finish.d.ts

@@ -0,0 +1,26 @@
+import { AccountInfo } from '../auth/account-info.js';
+import { RetryOptions } from '../http/retry.js';
+import { RawClient } from '../raw/index.js';
+import { FileVersion } from '../types/file.js';
+import { BucketId, LargeFileId } from '../types/ids.js';
+/** Context for safely finalizing a large file. */
+export interface FinishLargeFileContext {
+    readonly fileId: LargeFileId;
+    readonly bucketId: BucketId;
+    readonly fileName: string;
+    readonly partSha1s: readonly string[];
+    readonly signal?: AbortSignal;
+    readonly retry?: Partial<RetryOptions>;
+}
+/**
+ * Calls `b2_finish_large_file` and classifies failures after dispatch that can
+ * hide an already-committed file as ambiguous finish failures.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state.
+ * @param context - Finish request data and reconciliation metadata.
+ *
+ * @returns The completed file version metadata.
+ */
+export declare function finishLargeFileWithAbortReconciliation(raw: RawClient, accountInfo: AccountInfo, context: FinishLargeFileContext): Promise<FileVersion>;
+//# sourceMappingURL=finish.d.ts.map

package/dist/upload/finish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../src/upload/finish.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG5D,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,sCAAsC,CAC1D,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAkCtB"}

package/dist/upload/finish.js

@@ -0,0 +1,54 @@
+import { FinishLargeFileResponseBodyError, NetworkError } from "../errors/index.js";
+import { isAbortError, isTimeoutError } from "../util/abort.js";
+//#region src/upload/finish.ts
+/**
+* Calls `b2_finish_large_file` and classifies failures after dispatch that can
+* hide an already-committed file as ambiguous finish failures.
+*
+* @param raw - Low-level B2 API client.
+* @param accountInfo - Authorized account state.
+* @param context - Finish request data and reconciliation metadata.
+*
+* @returns The completed file version metadata.
+*/
+async function finishLargeFileWithAbortReconciliation(raw, accountInfo, context) {
+	context.signal?.throwIfAborted();
+	try {
+		return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {
+			fileId: context.fileId,
+			partSha1Array: context.partSha1s
+		}, context.signal === void 0 && context.retry === void 0 ? void 0 : {
+			...context.signal !== void 0 ? { signal: context.signal } : {},
+			...context.retry !== void 0 ? { retry: context.retry } : {}
+		});
+	} catch (err) {
+		if (err instanceof FinishLargeFileResponseBodyError) throw finishLargeFileResponseBodyErrorWithContext(err, context);
+		if (isAmbiguousFinishDispatchFailure(err, context.signal)) throw new FinishLargeFileResponseBodyError("b2_finish_large_file failed after dispatch; final file state is ambiguous.", {
+			cause: err,
+			fileId: context.fileId,
+			bucketId: context.bucketId,
+			fileName: context.fileName
+		});
+		throw err;
+	}
+}
+function finishLargeFileResponseBodyErrorWithContext(err, context) {
+	if (err.fileId === context.fileId && err.bucketId === context.bucketId && err.fileName === context.fileName) return err;
+	return new FinishLargeFileResponseBodyError(err.message, {
+		cause: err.cause ?? err,
+		fileId: context.fileId,
+		bucketId: context.bucketId,
+		fileName: context.fileName
+	});
+}
+function isAmbiguousFinishDispatchFailure(err, signal) {
+	if (err instanceof NetworkError) return true;
+	if (isTimeoutError(err)) return true;
+	if (signal?.aborted !== true) return false;
+	if (signal.reason !== void 0 && Object.is(err, signal.reason)) return true;
+	return isAbortError(err);
+}
+//#endregion
+export { finishLargeFileWithAbortReconciliation };
+
+//# sourceMappingURL=finish.js.map

package/dist/upload/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","names":[],"sources":["../../src/upload/finish.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport { FinishLargeFileResponseBodyError, NetworkError } from '../errors/index.ts'\nimport type { RetryOptions } from '../http/retry.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { FileVersion } from '../types/file.ts'\nimport type { BucketId, LargeFileId } from '../types/ids.ts'\nimport { isAbortError, isTimeoutError } from '../util/abort.ts'\n\n/** Context for safely finalizing a large file. */\nexport interface FinishLargeFileContext {\n  readonly fileId: LargeFileId\n  readonly bucketId: BucketId\n  readonly fileName: string\n  readonly partSha1s: readonly string[]\n  readonly signal?: AbortSignal\n  readonly retry?: Partial<RetryOptions>\n}\n\n/**\n * Calls `b2_finish_large_file` and classifies failures after dispatch that can\n * hide an already-committed file as ambiguous finish failures.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param context - Finish request data and reconciliation metadata.\n *\n * @returns The completed file version metadata.\n */\nexport async function finishLargeFileWithAbortReconciliation(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  context: FinishLargeFileContext,\n): Promise<FileVersion> {\n  context.signal?.throwIfAborted()\n  try {\n    return await raw.finishLargeFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      {\n        fileId: context.fileId,\n        partSha1Array: context.partSha1s,\n      },\n      context.signal === undefined && context.retry === undefined\n        ? undefined\n        : {\n            ...(context.signal !== undefined ? { signal: context.signal } : {}),\n            ...(context.retry !== undefined ? { retry: context.retry } : {}),\n          },\n    )\n  } catch (err) {\n    if (err instanceof FinishLargeFileResponseBodyError) {\n      throw finishLargeFileResponseBodyErrorWithContext(err, context)\n    }\n    if (isAmbiguousFinishDispatchFailure(err, context.signal)) {\n      throw new FinishLargeFileResponseBodyError(\n        'b2_finish_large_file failed after dispatch; final file state is ambiguous.',\n        {\n          cause: err,\n          fileId: context.fileId,\n          bucketId: context.bucketId,\n          fileName: context.fileName,\n        },\n      )\n    }\n    throw err\n  }\n}\n\nfunction finishLargeFileResponseBodyErrorWithContext(\n  err: FinishLargeFileResponseBodyError,\n  context: FinishLargeFileContext,\n): FinishLargeFileResponseBodyError {\n  if (\n    err.fileId === context.fileId &&\n    err.bucketId === context.bucketId &&\n    err.fileName === context.fileName\n  ) {\n    return err\n  }\n  return new FinishLargeFileResponseBodyError(err.message, {\n    cause: err.cause ?? err,\n    fileId: context.fileId,\n    bucketId: context.bucketId,\n    fileName: context.fileName,\n  })\n}\n\nfunction isAmbiguousFinishDispatchFailure(err: unknown, signal: AbortSignal | undefined): boolean {\n  if (err instanceof NetworkError) return true\n  if (isTimeoutError(err)) return true\n  if (signal?.aborted !== true) return false\n  if (signal.reason !== undefined && Object.is(err, signal.reason)) return true\n  return isAbortError(err)\n}\n"],"mappings":";;;;;;;;;;;;;AA4BA,eAAsB,uCACpB,KACA,aACA,SACsB;CACtB,QAAQ,QAAQ,eAAe;CAC/B,IAAI;EACF,OAAO,MAAM,IAAI,gBACf,YAAY,UAAU,GACtB,YAAY,aAAa,GACzB;GACE,QAAQ,QAAQ;GAChB,eAAe,QAAQ;EACzB,GACA,QAAQ,WAAW,KAAA,KAAa,QAAQ,UAAU,KAAA,IAC9C,KAAA,IACA;GACE,GAAI,QAAQ,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;GACjE,GAAI,QAAQ,UAAU,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EAChE,CACN;CACF,SAAS,KAAK;EACZ,IAAI,eAAe,kCACjB,MAAM,4CAA4C,KAAK,OAAO;EAEhE,IAAI,iCAAiC,KAAK,QAAQ,MAAM,GACtD,MAAM,IAAI,iCACR,8EACA;GACE,OAAO;GACP,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,UAAU,QAAQ;EACpB,CACF;EAEF,MAAM;CACR;AACF;AAEA,SAAS,4CACP,KACA,SACkC;CAClC,IACE,IAAI,WAAW,QAAQ,UACvB,IAAI,aAAa,QAAQ,YACzB,IAAI,aAAa,QAAQ,UAEzB,OAAO;CAET,OAAO,IAAI,iCAAiC,IAAI,SAAS;EACvD,OAAO,IAAI,SAAS;EACpB,QAAQ,QAAQ;EAChB,UAAU,QAAQ;EAClB,UAAU,QAAQ;CACpB,CAAC;AACH;AAEA,SAAS,iCAAiC,KAAc,QAA0C;CAChG,IAAI,eAAe,cAAc,OAAO;CACxC,IAAI,eAAe,GAAG,GAAG,OAAO;CAChC,IAAI,QAAQ,YAAY,MAAM,OAAO;CACrC,IAAI,OAAO,WAAW,KAAA,KAAa,OAAO,GAAG,KAAK,OAAO,MAAM,GAAG,OAAO;CACzE,OAAO,aAAa,GAAG;AACzB"}