@backblaze-labs/b2-sdk 0.1.0

package/dist/types/upload.d.cts

@@ -0,0 +1,219 @@
+import { EncryptionSetting } from './encryption.js';
+import { BucketId, LargeFileId } from './ids.js';
+import { FileRetentionValue, LegalHoldValue } from './lock.js';
+/** Request parameters for the `b2_get_upload_url` API call. */
+export interface GetUploadUrlRequest {
+    /** Bucket to get an upload URL for. */
+    readonly bucketId: BucketId;
+}
+/** Response from the `b2_get_upload_url` API call. Contains a one-time upload URL and auth token. */
+export interface GetUploadUrlResponse {
+    /** Bucket this upload URL targets. */
+    readonly bucketId: BucketId;
+    /** URL to POST file data to. */
+    readonly uploadUrl: string;
+    /** Authorization token to include in the upload request. */
+    readonly authorizationToken: string;
+}
+/**
+ * Headers required when uploading a file via `b2_upload_file`.
+ * Sent as HTTP headers on the upload POST request.
+ */
+export interface UploadFileHeaders {
+    /** Authorization token from `b2_get_upload_url`. */
+    readonly authorization: string;
+    /** URL-encoded file name including path within the bucket. */
+    readonly fileName: string;
+    /** MIME type of the file. Use `'b2/x-auto'` for automatic detection. */
+    readonly contentType: string;
+    /** Size of the file content in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of the content, or `'hex_digits_at_end'` / `'do_not_verify'` for deferred verification. */
+    readonly contentSha1: string | 'hex_digits_at_end' | 'do_not_verify';
+    /** Optional user-defined key-value metadata for the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Optional server-side encryption setting. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** Optional Object Lock retention for the file. */
+    readonly fileRetention?: FileRetentionValue;
+    /** Optional legal hold for the file. */
+    readonly legalHold?: LegalHoldValue;
+    /** Optional last-modified timestamp in milliseconds (stored as `src_last_modified_millis` in file info). */
+    readonly lastModifiedMillis?: number;
+    /** Optional Content-Disposition header value for downloads. */
+    readonly contentDisposition?: string;
+    /** Optional Content-Language header value for downloads. */
+    readonly contentLanguage?: string;
+    /** Optional Expires header value for downloads. */
+    readonly expires?: string;
+    /** Optional Cache-Control header value for downloads. */
+    readonly cacheControl?: string;
+    /** Optional Content-Encoding header value for downloads. */
+    readonly contentEncoding?: string;
+}
+/** Request parameters for the `b2_start_large_file` API call. Initiates a multi-part upload. */
+export interface StartLargeFileRequest {
+    /** Bucket to upload the large file to. */
+    readonly bucketId: BucketId;
+    /** Full path and name of the file within the bucket. */
+    readonly fileName: string;
+    /** MIME type of the file. Use `'b2/x-auto'` for automatic detection. */
+    readonly contentType: string;
+    /** Optional user-defined key-value metadata for the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Optional server-side encryption setting. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** Optional Object Lock retention for the file. */
+    readonly fileRetention?: FileRetentionValue;
+    /** Optional legal hold for the file. */
+    readonly legalHold?: LegalHoldValue;
+}
+/** Response from the `b2_start_large_file` API call. */
+export interface StartLargeFileResponse {
+    /** ID assigned to this large file upload. Use this to upload parts and finish the file. */
+    readonly fileId: LargeFileId;
+    /** Name of the file being uploaded. */
+    readonly fileName: string;
+    /** Account that owns this file. */
+    readonly accountId: string;
+    /** Bucket the file is being uploaded to. */
+    readonly bucketId: BucketId;
+    /** MIME type of the file. */
+    readonly contentType: string;
+    /** User-defined key-value metadata stored with the file. */
+    readonly fileInfo: Record<string, string>;
+}
+/** Request parameters for the `b2_get_upload_part_url` API call. */
+export interface GetUploadPartUrlRequest {
+    /** ID of the large file to get a part upload URL for. */
+    readonly fileId: LargeFileId;
+}
+/** Response from the `b2_get_upload_part_url` API call. Contains a one-time part upload URL and auth token. */
+export interface GetUploadPartUrlResponse {
+    /** ID of the large file this upload URL targets. */
+    readonly fileId: LargeFileId;
+    /** URL to POST part data to. */
+    readonly uploadUrl: string;
+    /** Authorization token to include in the part upload request. */
+    readonly authorizationToken: string;
+}
+/**
+ * Headers required when uploading a part via `b2_upload_part`.
+ * Sent as HTTP headers on the part upload POST request.
+ */
+export interface UploadPartHeaders {
+    /** Authorization token from `b2_get_upload_part_url`. */
+    readonly authorization: string;
+    /** Part number (1 to 10000). Parts are assembled in order to form the complete file. */
+    readonly partNumber: number;
+    /** Size of this part in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of the part content, or `'hex_digits_at_end'` / `'do_not_verify'` for deferred verification. */
+    readonly contentSha1: string | 'hex_digits_at_end' | 'do_not_verify';
+    /** Optional server-side encryption setting for this part. */
+    readonly serverSideEncryption?: EncryptionSetting;
+}
+/** Response from the `b2_upload_part` API call. */
+export interface UploadPartResponse {
+    /** ID of the large file this part belongs to. */
+    readonly fileId: LargeFileId;
+    /** Part number within the large file. */
+    readonly partNumber: number;
+    /** Size of the uploaded part in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of the uploaded part content. */
+    readonly contentSha1: string;
+    /** Server-side encryption applied to this part. */
+    readonly serverSideEncryption: EncryptionSetting;
+    /** UTC timestamp (milliseconds) when this part was uploaded. */
+    readonly uploadTimestamp: number;
+}
+/**
+ * Request parameters for the `b2_finish_large_file` API call.
+ * Assembles previously uploaded parts into a single complete file.
+ */
+export interface FinishLargeFileRequest {
+    /** ID of the large file to finish. */
+    readonly fileId: LargeFileId;
+    /** Ordered array of SHA-1 checksums, one per part, matching the upload order. */
+    readonly partSha1Array: readonly string[];
+}
+/** Request parameters for the `b2_cancel_large_file` API call. */
+export interface CancelLargeFileRequest {
+    /** ID of the large file upload to cancel. */
+    readonly fileId: LargeFileId;
+}
+/** Response from the `b2_cancel_large_file` API call. */
+export interface CancelLargeFileResponse {
+    /** ID of the cancelled large file. */
+    readonly fileId: LargeFileId;
+    /** Account that owned the large file. */
+    readonly accountId: string;
+    /** Bucket the large file was being uploaded to. */
+    readonly bucketId: BucketId;
+    /** Name of the cancelled file. */
+    readonly fileName: string;
+}
+/** Request parameters for the `b2_list_unfinished_large_files` API call. */
+export interface ListUnfinishedLargeFilesRequest {
+    /** Bucket to list unfinished large files from. */
+    readonly bucketId: BucketId;
+    /** Only return files whose names start with this prefix. */
+    readonly namePrefix?: string;
+    /** File ID to start listing from (exclusive). Used for pagination. */
+    readonly startFileId?: LargeFileId;
+    /** Maximum number of files to return. */
+    readonly maxFileCount?: number;
+}
+/** Metadata for an in-progress large file upload that has not yet been finished or cancelled. */
+export interface UnfinishedLargeFile {
+    /** ID of the large file. */
+    readonly fileId: LargeFileId;
+    /** Name of the file. */
+    readonly fileName: string;
+    /** Account that owns this file. */
+    readonly accountId: string;
+    /** Bucket the file is being uploaded to. */
+    readonly bucketId: BucketId;
+    /** MIME type of the file. */
+    readonly contentType: string;
+    /** User-defined key-value metadata stored with the file. */
+    readonly fileInfo: Record<string, string>;
+}
+/** Response from the `b2_list_unfinished_large_files` API call. */
+export interface ListUnfinishedLargeFilesResponse {
+    /** Array of unfinished large files. */
+    readonly files: readonly UnfinishedLargeFile[];
+    /** Next file ID to use for pagination, or null if all files have been listed. */
+    readonly nextFileId: LargeFileId | null;
+}
+/** Request parameters for the `b2_list_parts` API call. Lists parts uploaded for a large file. */
+export interface ListPartsRequest {
+    /** ID of the large file to list parts for. */
+    readonly fileId: LargeFileId;
+    /** Part number to start listing from (inclusive). Used for pagination. */
+    readonly startPartNumber?: number;
+    /** Maximum number of parts to return. */
+    readonly maxPartCount?: number;
+}
+/** Metadata for a single uploaded part of a large file. */
+export interface PartInfo {
+    /** ID of the large file this part belongs to. */
+    readonly fileId: LargeFileId;
+    /** Part number within the large file. */
+    readonly partNumber: number;
+    /** Size of this part in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of this part's content. */
+    readonly contentSha1: string;
+    /** UTC timestamp (milliseconds) when this part was uploaded. */
+    readonly uploadTimestamp: number;
+}
+/** Response from the `b2_list_parts` API call. */
+export interface ListPartsResponse {
+    /** Array of uploaded parts. */
+    readonly parts: readonly PartInfo[];
+    /** Next part number to use for pagination, or null if all parts have been listed. */
+    readonly nextPartNumber: number | null;
+}
+//# sourceMappingURL=upload.d.ts.map

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

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

package/dist/types/upload.d.ts

@@ -0,0 +1,219 @@
+import { EncryptionSetting } from './encryption.js';
+import { BucketId, LargeFileId } from './ids.js';
+import { FileRetentionValue, LegalHoldValue } from './lock.js';
+/** Request parameters for the `b2_get_upload_url` API call. */
+export interface GetUploadUrlRequest {
+    /** Bucket to get an upload URL for. */
+    readonly bucketId: BucketId;
+}
+/** Response from the `b2_get_upload_url` API call. Contains a one-time upload URL and auth token. */
+export interface GetUploadUrlResponse {
+    /** Bucket this upload URL targets. */
+    readonly bucketId: BucketId;
+    /** URL to POST file data to. */
+    readonly uploadUrl: string;
+    /** Authorization token to include in the upload request. */
+    readonly authorizationToken: string;
+}
+/**
+ * Headers required when uploading a file via `b2_upload_file`.
+ * Sent as HTTP headers on the upload POST request.
+ */
+export interface UploadFileHeaders {
+    /** Authorization token from `b2_get_upload_url`. */
+    readonly authorization: string;
+    /** URL-encoded file name including path within the bucket. */
+    readonly fileName: string;
+    /** MIME type of the file. Use `'b2/x-auto'` for automatic detection. */
+    readonly contentType: string;
+    /** Size of the file content in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of the content, or `'hex_digits_at_end'` / `'do_not_verify'` for deferred verification. */
+    readonly contentSha1: string | 'hex_digits_at_end' | 'do_not_verify';
+    /** Optional user-defined key-value metadata for the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Optional server-side encryption setting. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** Optional Object Lock retention for the file. */
+    readonly fileRetention?: FileRetentionValue;
+    /** Optional legal hold for the file. */
+    readonly legalHold?: LegalHoldValue;
+    /** Optional last-modified timestamp in milliseconds (stored as `src_last_modified_millis` in file info). */
+    readonly lastModifiedMillis?: number;
+    /** Optional Content-Disposition header value for downloads. */
+    readonly contentDisposition?: string;
+    /** Optional Content-Language header value for downloads. */
+    readonly contentLanguage?: string;
+    /** Optional Expires header value for downloads. */
+    readonly expires?: string;
+    /** Optional Cache-Control header value for downloads. */
+    readonly cacheControl?: string;
+    /** Optional Content-Encoding header value for downloads. */
+    readonly contentEncoding?: string;
+}
+/** Request parameters for the `b2_start_large_file` API call. Initiates a multi-part upload. */
+export interface StartLargeFileRequest {
+    /** Bucket to upload the large file to. */
+    readonly bucketId: BucketId;
+    /** Full path and name of the file within the bucket. */
+    readonly fileName: string;
+    /** MIME type of the file. Use `'b2/x-auto'` for automatic detection. */
+    readonly contentType: string;
+    /** Optional user-defined key-value metadata for the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Optional server-side encryption setting. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** Optional Object Lock retention for the file. */
+    readonly fileRetention?: FileRetentionValue;
+    /** Optional legal hold for the file. */
+    readonly legalHold?: LegalHoldValue;
+}
+/** Response from the `b2_start_large_file` API call. */
+export interface StartLargeFileResponse {
+    /** ID assigned to this large file upload. Use this to upload parts and finish the file. */
+    readonly fileId: LargeFileId;
+    /** Name of the file being uploaded. */
+    readonly fileName: string;
+    /** Account that owns this file. */
+    readonly accountId: string;
+    /** Bucket the file is being uploaded to. */
+    readonly bucketId: BucketId;
+    /** MIME type of the file. */
+    readonly contentType: string;
+    /** User-defined key-value metadata stored with the file. */
+    readonly fileInfo: Record<string, string>;
+}
+/** Request parameters for the `b2_get_upload_part_url` API call. */
+export interface GetUploadPartUrlRequest {
+    /** ID of the large file to get a part upload URL for. */
+    readonly fileId: LargeFileId;
+}
+/** Response from the `b2_get_upload_part_url` API call. Contains a one-time part upload URL and auth token. */
+export interface GetUploadPartUrlResponse {
+    /** ID of the large file this upload URL targets. */
+    readonly fileId: LargeFileId;
+    /** URL to POST part data to. */
+    readonly uploadUrl: string;
+    /** Authorization token to include in the part upload request. */
+    readonly authorizationToken: string;
+}
+/**
+ * Headers required when uploading a part via `b2_upload_part`.
+ * Sent as HTTP headers on the part upload POST request.
+ */
+export interface UploadPartHeaders {
+    /** Authorization token from `b2_get_upload_part_url`. */
+    readonly authorization: string;
+    /** Part number (1 to 10000). Parts are assembled in order to form the complete file. */
+    readonly partNumber: number;
+    /** Size of this part in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of the part content, or `'hex_digits_at_end'` / `'do_not_verify'` for deferred verification. */
+    readonly contentSha1: string | 'hex_digits_at_end' | 'do_not_verify';
+    /** Optional server-side encryption setting for this part. */
+    readonly serverSideEncryption?: EncryptionSetting;
+}
+/** Response from the `b2_upload_part` API call. */
+export interface UploadPartResponse {
+    /** ID of the large file this part belongs to. */
+    readonly fileId: LargeFileId;
+    /** Part number within the large file. */
+    readonly partNumber: number;
+    /** Size of the uploaded part in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of the uploaded part content. */
+    readonly contentSha1: string;
+    /** Server-side encryption applied to this part. */
+    readonly serverSideEncryption: EncryptionSetting;
+    /** UTC timestamp (milliseconds) when this part was uploaded. */
+    readonly uploadTimestamp: number;
+}
+/**
+ * Request parameters for the `b2_finish_large_file` API call.
+ * Assembles previously uploaded parts into a single complete file.
+ */
+export interface FinishLargeFileRequest {
+    /** ID of the large file to finish. */
+    readonly fileId: LargeFileId;
+    /** Ordered array of SHA-1 checksums, one per part, matching the upload order. */
+    readonly partSha1Array: readonly string[];
+}
+/** Request parameters for the `b2_cancel_large_file` API call. */
+export interface CancelLargeFileRequest {
+    /** ID of the large file upload to cancel. */
+    readonly fileId: LargeFileId;
+}
+/** Response from the `b2_cancel_large_file` API call. */
+export interface CancelLargeFileResponse {
+    /** ID of the cancelled large file. */
+    readonly fileId: LargeFileId;
+    /** Account that owned the large file. */
+    readonly accountId: string;
+    /** Bucket the large file was being uploaded to. */
+    readonly bucketId: BucketId;
+    /** Name of the cancelled file. */
+    readonly fileName: string;
+}
+/** Request parameters for the `b2_list_unfinished_large_files` API call. */
+export interface ListUnfinishedLargeFilesRequest {
+    /** Bucket to list unfinished large files from. */
+    readonly bucketId: BucketId;
+    /** Only return files whose names start with this prefix. */
+    readonly namePrefix?: string;
+    /** File ID to start listing from (exclusive). Used for pagination. */
+    readonly startFileId?: LargeFileId;
+    /** Maximum number of files to return. */
+    readonly maxFileCount?: number;
+}
+/** Metadata for an in-progress large file upload that has not yet been finished or cancelled. */
+export interface UnfinishedLargeFile {
+    /** ID of the large file. */
+    readonly fileId: LargeFileId;
+    /** Name of the file. */
+    readonly fileName: string;
+    /** Account that owns this file. */
+    readonly accountId: string;
+    /** Bucket the file is being uploaded to. */
+    readonly bucketId: BucketId;
+    /** MIME type of the file. */
+    readonly contentType: string;
+    /** User-defined key-value metadata stored with the file. */
+    readonly fileInfo: Record<string, string>;
+}
+/** Response from the `b2_list_unfinished_large_files` API call. */
+export interface ListUnfinishedLargeFilesResponse {
+    /** Array of unfinished large files. */
+    readonly files: readonly UnfinishedLargeFile[];
+    /** Next file ID to use for pagination, or null if all files have been listed. */
+    readonly nextFileId: LargeFileId | null;
+}
+/** Request parameters for the `b2_list_parts` API call. Lists parts uploaded for a large file. */
+export interface ListPartsRequest {
+    /** ID of the large file to list parts for. */
+    readonly fileId: LargeFileId;
+    /** Part number to start listing from (inclusive). Used for pagination. */
+    readonly startPartNumber?: number;
+    /** Maximum number of parts to return. */
+    readonly maxPartCount?: number;
+}
+/** Metadata for a single uploaded part of a large file. */
+export interface PartInfo {
+    /** ID of the large file this part belongs to. */
+    readonly fileId: LargeFileId;
+    /** Part number within the large file. */
+    readonly partNumber: number;
+    /** Size of this part in bytes. */
+    readonly contentLength: number;
+    /** SHA-1 checksum of this part's content. */
+    readonly contentSha1: string;
+    /** UTC timestamp (milliseconds) when this part was uploaded. */
+    readonly uploadTimestamp: number;
+}
+/** Response from the `b2_list_parts` API call. */
+export interface ListPartsResponse {
+    /** Array of uploaded parts. */
+    readonly parts: readonly PartInfo[];
+    /** Next part number to use for pagination, or null if all parts have been listed. */
+    readonly nextPartNumber: number | null;
+}
+//# sourceMappingURL=upload.d.ts.map

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

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

package/dist/upload/cancel.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const bestEffort = require("../util/best-effort.cjs");
+async function cancelLargeFileBestEffort(raw, accountInfo, fileId) {
+  await bestEffort.bestEffort(
+    () => raw.cancelLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), { fileId })
+  );
+}
+exports.cancelLargeFileBestEffort = cancelLargeFileBestEffort;
+//# sourceMappingURL=cancel.cjs.map

package/dist/upload/cancel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.cjs","sources":["../../src/upload/cancel.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { LargeFileId } from '../types/ids.ts'\nimport { bestEffort } from '../util/best-effort.ts'\n\n/**\n * Cancels an unfinished large file on a best-effort basis. Used at every\n * error-handling boundary in the multipart upload, write-stream, and\n * server-side copy paths to roll back in-progress uploads without\n * letting a cancellation failure mask the underlying error the caller\n * is about to see.\n *\n * Centralising the call removes a five-line `bestEffort` block that\n * recurred at six sites with identical shape — the only thing that\n * changed was the captured `fileId` and the surrounding error trail.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state for the API URL + token.\n * @param fileId - The in-progress large file ID to cancel.\n *\n * @returns A promise that always resolves, regardless of the cancel\n *   call's outcome.\n */\nexport async function cancelLargeFileBestEffort(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  fileId: LargeFileId,\n): Promise<void> {\n  await bestEffort(() =>\n    raw.cancelLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), { fileId }),\n  )\n}\n"],"names":["bestEffort"],"mappings":";;;AAuBA,eAAsB,0BACpB,KACA,aACA,QACe;AACf,QAAMA,WAAAA;AAAAA,IAAW,MACf,IAAI,gBAAgB,YAAY,UAAA,GAAa,YAAY,gBAAgB,EAAE,OAAA,CAAQ;AAAA,EAAA;AAEvF;;"}

package/dist/upload/cancel.d.cts

@@ -0,0 +1,23 @@
+import { AccountInfo } from '../auth/account-info.js';
+import { RawClient } from '../raw/index.js';
+import { LargeFileId } from '../types/ids.js';
+/**
+ * Cancels an unfinished large file on a best-effort basis. Used at every
+ * error-handling boundary in the multipart upload, write-stream, and
+ * server-side copy paths to roll back in-progress uploads without
+ * letting a cancellation failure mask the underlying error the caller
+ * is about to see.
+ *
+ * Centralising the call removes a five-line `bestEffort` block that
+ * recurred at six sites with identical shape — the only thing that
+ * changed was the captured `fileId` and the surrounding error trail.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state for the API URL + token.
+ * @param fileId - The in-progress large file ID to cancel.
+ *
+ * @returns A promise that always resolves, regardless of the cancel
+ *   call's outcome.
+ */
+export declare function cancelLargeFileBestEffort(raw: RawClient, accountInfo: AccountInfo, fileId: LargeFileId): Promise<void>;
+//# sourceMappingURL=cancel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/upload/cancel.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/upload/cancel.d.ts

@@ -0,0 +1,23 @@
+import { AccountInfo } from '../auth/account-info.js';
+import { RawClient } from '../raw/index.js';
+import { LargeFileId } from '../types/ids.js';
+/**
+ * Cancels an unfinished large file on a best-effort basis. Used at every
+ * error-handling boundary in the multipart upload, write-stream, and
+ * server-side copy paths to roll back in-progress uploads without
+ * letting a cancellation failure mask the underlying error the caller
+ * is about to see.
+ *
+ * Centralising the call removes a five-line `bestEffort` block that
+ * recurred at six sites with identical shape — the only thing that
+ * changed was the captured `fileId` and the surrounding error trail.
+ *
+ * @param raw - Low-level B2 API client.
+ * @param accountInfo - Authorized account state for the API URL + token.
+ * @param fileId - The in-progress large file ID to cancel.
+ *
+ * @returns A promise that always resolves, regardless of the cancel
+ *   call's outcome.
+ */
+export declare function cancelLargeFileBestEffort(raw: RawClient, accountInfo: AccountInfo, fileId: LargeFileId): Promise<void>;
+//# sourceMappingURL=cancel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/upload/cancel.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/upload/cancel.js

@@ -0,0 +1,10 @@
+import { bestEffort } from "../util/best-effort.js";
+async function cancelLargeFileBestEffort(raw, accountInfo, fileId) {
+  await bestEffort(
+    () => raw.cancelLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), { fileId })
+  );
+}
+export {
+  cancelLargeFileBestEffort
+};
+//# sourceMappingURL=cancel.js.map

package/dist/upload/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sources":["../../src/upload/cancel.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport type { LargeFileId } from '../types/ids.ts'\nimport { bestEffort } from '../util/best-effort.ts'\n\n/**\n * Cancels an unfinished large file on a best-effort basis. Used at every\n * error-handling boundary in the multipart upload, write-stream, and\n * server-side copy paths to roll back in-progress uploads without\n * letting a cancellation failure mask the underlying error the caller\n * is about to see.\n *\n * Centralising the call removes a five-line `bestEffort` block that\n * recurred at six sites with identical shape — the only thing that\n * changed was the captured `fileId` and the surrounding error trail.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state for the API URL + token.\n * @param fileId - The in-progress large file ID to cancel.\n *\n * @returns A promise that always resolves, regardless of the cancel\n *   call's outcome.\n */\nexport async function cancelLargeFileBestEffort(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  fileId: LargeFileId,\n): Promise<void> {\n  await bestEffort(() =>\n    raw.cancelLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), { fileId }),\n  )\n}\n"],"names":[],"mappings":";AAuBA,eAAsB,0BACpB,KACA,aACA,QACe;AACf,QAAM;AAAA,IAAW,MACf,IAAI,gBAAgB,YAAY,UAAA,GAAa,YAAY,gBAAgB,EAAE,OAAA,CAAQ;AAAA,EAAA;AAEvF;"}

package/dist/upload/concurrency.cjs

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+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;
+  }
+}
+exports.Semaphore = Semaphore;
+//# sourceMappingURL=concurrency.cjs.map

package/dist/upload/concurrency.cjs.map

@@ -0,0 +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;;"}