@backblaze-labs/b2-sdk 0.2.0 → 0.3.0

package/dist/errors/index.d.ts

@@ -324,6 +324,116 @@ export declare class ChecksumMismatchError extends B2Error {
      */
     constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
 }
+/** Thrown when a Partner group has reached its maximum member count. */
+export declare class TooManyMembersError extends B2Error {
+    /**
+     * Creates a new TooManyMembersError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/**
+ * Compatibility alias for the issue #167 Partner member-limit error name.
+ * @deprecated Use {@link TooManyMembersError}.
+ */
+export declare const TooManyGroupMembersError: typeof TooManyMembersError;
+/** @deprecated Use {@link TooManyMembersError}. */
+export type TooManyGroupMembersError = TooManyMembersError;
+/** Thrown when a Partner group ID is malformed or does not identify a valid group. */
+export declare class InvalidGroupIdError extends B2Error {
+    /**
+     * Creates a new InvalidGroupIdError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/** Thrown when a Partner member email address fails validation. */
+export declare class InvalidEmailError extends B2Error {
+    /**
+     * Creates a new InvalidEmailError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/** Thrown when a Partner API region value is unsupported or malformed. */
+export declare class InvalidRegionError extends B2Error {
+    /**
+     * Creates a new InvalidRegionError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/** Thrown when a Partner account SMS phone number fails validation. */
+export declare class InvalidSmsPhoneError extends B2Error {
+    /**
+     * Creates a new InvalidSmsPhoneError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/**
+ * Compatibility alias for the issue #167 Partner SMS-phone error name.
+ * @deprecated Use {@link InvalidSmsPhoneError}.
+ */
+export declare const MissingSmsPhoneError: typeof InvalidSmsPhoneError;
+/** @deprecated Use {@link InvalidSmsPhoneError}. */
+export type MissingSmsPhoneError = InvalidSmsPhoneError;
+/**
+ * Thrown when B2 returns `method_failure`.
+ *
+ * The documented Partner group-member creation flow uses this code after
+ * server-side creation fails and Backblaze rolls back before callers retry.
+ * The code itself is classified globally, so this class stays endpoint-neutral.
+ */
+export declare class MethodFailureError extends B2Error {
+    /** Always `false` because callers should decide when a documented operation-level retry is safe. */
+    readonly retryable = false;
+    /**
+     * Creates a new MethodFailureError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/**
+ * Compatibility alias for the issue #167 Partner group-member failure name.
+ * @deprecated Use {@link MethodFailureError}.
+ */
+export declare const GroupMemberCreationFailedError: typeof MethodFailureError;
+/** @deprecated Use {@link MethodFailureError}. */
+export type GroupMemberCreationFailedError = MethodFailureError;
+/** Thrown when a Partner group member account ID fails validation. */
+export declare class InvalidMemberAccountIdError extends B2Error {
+    /**
+     * Creates a new InvalidMemberAccountIdError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/** Thrown when an account ID fails Partner or Computer Backup API validation. */
+export declare class InvalidAccountIdError extends B2Error {
+    /**
+     * Creates a new InvalidAccountIdError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
+/** Thrown when a Computer Backup computer ID fails validation. */
+export declare class InvalidComputerIdError extends B2Error {
+    /**
+     * Creates a new InvalidComputerIdError instance.
+     * @param response - Parsed B2 error response body.
+     * @param options - Optional metadata from response headers.
+     */
+    constructor(response: B2ErrorResponse, options?: B2ErrorOptions);
+}
 /**
  * Thrown by client-side capability checks when the application key is missing
  * capabilities required by an operation. Not raised by the server.
@@ -374,6 +484,15 @@ export declare class B2RealmConfigurationError extends B2Error {
      */
     constructor(message: string);
 }
+/** Thrown when Partner authorization returns unusable Partner/Backup auth data. */
+export declare class B2PartnerAuthorizationError extends B2Error {
+    /**
+     * Creates a new B2PartnerAuthorizationError instance.
+     *
+     * @param message - Human-readable description of the invalid Partner authorization state.
+     */
+    constructor(message: string);
+}
 /** Thrown when the SDK refuses to follow an HTTP redirect automatically. */
 export declare class B2RedirectError extends Error {
     /** Always `false` because a blocked redirect is deterministic. */

package/dist/errors/index.d.ts.map

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

package/dist/errors/index.js

@@ -11,9 +11,10 @@ import { KNOWN_B2_ERROR_CODES } from "../types/errors.js";
 * appropriate subclass.
 *
 * Convention: most `B2Error` subclasses represent failures returned by the B2
-* API. The client-side exception is {@link B2RealmConfigurationError}; it
-* extends `B2Error` so realm-validation failures can be handled with the SDK
-* error hierarchy before credentials are sent.
+* API. The client-side exceptions are {@link B2RealmConfigurationError} and
+* {@link B2PartnerAuthorizationError}; they extend `B2Error` so realm- and
+* Partner-authorization failures can be handled with the SDK error hierarchy
+* before or without a server round-trip.
 *
 * Other programming errors and SDK preconditions, such as "not yet authorized",
 * "stream consumed twice", or "called before init", use the native `Error`
@@ -442,6 +443,137 @@ var ChecksumMismatchError = class extends B2Error {
 		this.name = "ChecksumMismatchError";
 	}
 };
+/** Thrown when a Partner group has reached its maximum member count. */
+var TooManyMembersError = class extends B2Error {
+	/**
+	* Creates a new TooManyMembersError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "TooManyMembersError";
+	}
+};
+/**
+* Compatibility alias for the issue #167 Partner member-limit error name.
+* @deprecated Use {@link TooManyMembersError}.
+*/
+var TooManyGroupMembersError = TooManyMembersError;
+/** Thrown when a Partner group ID is malformed or does not identify a valid group. */
+var InvalidGroupIdError = class extends B2Error {
+	/**
+	* Creates a new InvalidGroupIdError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidGroupIdError";
+	}
+};
+/** Thrown when a Partner member email address fails validation. */
+var InvalidEmailError = class extends B2Error {
+	/**
+	* Creates a new InvalidEmailError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidEmailError";
+	}
+};
+/** Thrown when a Partner API region value is unsupported or malformed. */
+var InvalidRegionError = class extends B2Error {
+	/**
+	* Creates a new InvalidRegionError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidRegionError";
+	}
+};
+/** Thrown when a Partner account SMS phone number fails validation. */
+var InvalidSmsPhoneError = class extends B2Error {
+	/**
+	* Creates a new InvalidSmsPhoneError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidSmsPhoneError";
+	}
+};
+/**
+* Compatibility alias for the issue #167 Partner SMS-phone error name.
+* @deprecated Use {@link InvalidSmsPhoneError}.
+*/
+var MissingSmsPhoneError = InvalidSmsPhoneError;
+/**
+* Thrown when B2 returns `method_failure`.
+*
+* The documented Partner group-member creation flow uses this code after
+* server-side creation fails and Backblaze rolls back before callers retry.
+* The code itself is classified globally, so this class stays endpoint-neutral.
+*/
+var MethodFailureError = class extends B2Error {
+	/** Always `false` because callers should decide when a documented operation-level retry is safe. */
+	retryable = false;
+	/**
+	* Creates a new MethodFailureError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "MethodFailureError";
+	}
+};
+/**
+* Compatibility alias for the issue #167 Partner group-member failure name.
+* @deprecated Use {@link MethodFailureError}.
+*/
+var GroupMemberCreationFailedError = MethodFailureError;
+/** Thrown when a Partner group member account ID fails validation. */
+var InvalidMemberAccountIdError = class extends B2Error {
+	/**
+	* Creates a new InvalidMemberAccountIdError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidMemberAccountIdError";
+	}
+};
+/** Thrown when an account ID fails Partner or Computer Backup API validation. */
+var InvalidAccountIdError = class extends B2Error {
+	/**
+	* Creates a new InvalidAccountIdError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidAccountIdError";
+	}
+};
+/** Thrown when a Computer Backup computer ID fails validation. */
+var InvalidComputerIdError = class extends B2Error {
+	/**
+	* Creates a new InvalidComputerIdError instance.
+	* @param response - Parsed B2 error response body.
+	* @param options - Optional metadata from response headers.
+	*/
+	constructor(response, options) {
+		super(response, options);
+		this.name = "InvalidComputerIdError";
+	}
+};
 /**
 * Thrown by client-side capability checks when the application key is missing
 * capabilities required by an operation. Not raised by the server.
@@ -510,6 +642,22 @@ var B2RealmConfigurationError = class extends B2Error {
 		this.name = "B2RealmConfigurationError";
 	}
 };
+/** Thrown when Partner authorization returns unusable Partner/Backup auth data. */
+var B2PartnerAuthorizationError = class extends B2Error {
+	/**
+	* Creates a new B2PartnerAuthorizationError instance.
+	*
+	* @param message - Human-readable description of the invalid Partner authorization state.
+	*/
+	constructor(message) {
+		super({
+			status: 400,
+			code: "bad_request",
+			message
+		});
+		this.name = "B2PartnerAuthorizationError";
+	}
+};
 /** Thrown when the SDK refuses to follow an HTTP redirect automatically. */
 var B2RedirectError = class extends Error {
 	/** Always `false` because a blocked redirect is deterministic. */
@@ -629,6 +777,7 @@ function classifyKnownError(response, code, options) {
 		case "duplicate_bucket_name": return new DuplicateBucketNameError(response, options);
 		case "too_many_buckets": return new TooManyBucketsError(response, options);
 		case "too_many_files": return new TooManyFilesError(response, options);
+		case "too_many_members": return new TooManyMembersError(response, options);
 		case "cap_exceeded":
 		case "storage_cap_exceeded":
 		case "transaction_cap_exceeded":
@@ -637,8 +786,15 @@ function classifyKnownError(response, code, options) {
 		case "service_unavailable": return new ServiceUnavailableError(response, options);
 		case "internal_error": return new InternalError(response, options);
 		case "bad_json": return new BadJsonError(response, options);
+		case "invalid_account_id": return new InvalidAccountIdError(response, options);
 		case "invalid_bucket_id": return new InvalidBucketIdError(response, options);
 		case "invalid_bucket_info": return new InvalidBucketInfoError(response, options);
+		case "invalid_computer_id": return new InvalidComputerIdError(response, options);
+		case "invalid_email": return new InvalidEmailError(response, options);
+		case "invalid_group_id": return new InvalidGroupIdError(response, options);
+		case "invalid_member_account_id": return new InvalidMemberAccountIdError(response, options);
+		case "invalid_region": return new InvalidRegionError(response, options);
+		case "invalid_sms_phone": return new InvalidSmsPhoneError(response, options);
 		case "file_not_present":
 		case "no_such_file": return new FileNotPresentError(response, options);
 		case "out_of_range": return new OutOfRangeError(response, options);
@@ -647,6 +803,7 @@ function classifyKnownError(response, code, options) {
 		case "invalid_file_name": return new InvalidFileNameError(response, options);
 		case "invalid_file_info": return new InvalidFileInfoError(response, options);
 		case "invalid_part_number": return new InvalidPartNumberError(response, options);
+		case "method_failure": return new MethodFailureError(response, options);
 		case "bad_sha1_checksum": return new ChecksumMismatchError(response, options);
 		default: return assertNever(code);
 	}
@@ -680,6 +837,6 @@ function classifyError(response, options) {
 	return classifyUnknownError(response, options);
 }
 //#endregion
-export { AccessDeniedError, B2Error, B2InsufficientCapabilityError, B2RealmConfigurationError, B2RedirectError, B2SsrfError, BadAuthTokenError, BadBucketIdError, BadJsonError, BadRequestError, BadUploadUrlError, CapExceededError, ChecksumMismatchError, ConflictError, DuplicateBucketNameError, ExpiredAuthTokenError, FileNotPresentError, FinishLargeFileResponseBodyError, InternalError, InvalidBucketIdError, InvalidBucketInfoError, InvalidBucketNameError, InvalidFileIdError, InvalidFileInfoError, InvalidFileNameError, InvalidPartNumberError, MethodNotAllowedError, NetworkError, NotFoundError, OutOfRangeError, RangeNotSatisfiableError, RequestTimeoutError, ResumeFileIdMismatchError, ServiceUnavailableError, TooManyBucketsError, TooManyFilesError, TooManyRequestsError, UploadResponseBodyError, classifyError };
+export { AccessDeniedError, B2Error, B2InsufficientCapabilityError, B2PartnerAuthorizationError, B2RealmConfigurationError, B2RedirectError, B2SsrfError, BadAuthTokenError, BadBucketIdError, BadJsonError, BadRequestError, BadUploadUrlError, CapExceededError, ChecksumMismatchError, ConflictError, DuplicateBucketNameError, ExpiredAuthTokenError, FileNotPresentError, FinishLargeFileResponseBodyError, GroupMemberCreationFailedError, InternalError, InvalidAccountIdError, InvalidBucketIdError, InvalidBucketInfoError, InvalidBucketNameError, InvalidComputerIdError, InvalidEmailError, InvalidFileIdError, InvalidFileInfoError, InvalidFileNameError, InvalidGroupIdError, InvalidMemberAccountIdError, InvalidPartNumberError, InvalidRegionError, InvalidSmsPhoneError, MethodFailureError, MethodNotAllowedError, MissingSmsPhoneError, NetworkError, NotFoundError, OutOfRangeError, RangeNotSatisfiableError, RequestTimeoutError, ResumeFileIdMismatchError, ServiceUnavailableError, TooManyBucketsError, TooManyFilesError, TooManyGroupMembersError, TooManyMembersError, TooManyRequestsError, UploadResponseBodyError, classifyError };
 
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/errors/index.ts"],"sourcesContent":["/**\n * Typed error hierarchy for B2 API failures.\n *\n * Every B2 error response maps to a specific {@link B2Error} subclass.\n * Retry behavior is exposed through {@link B2Error.retryable}.\n * Examples include {@link ExpiredAuthTokenError} and {@link CapExceededError}.\n * Use {@link classifyError} to convert a raw error response into the\n * appropriate subclass.\n *\n * Convention: most `B2Error` subclasses represent failures returned by the B2\n * API. The client-side exception is {@link B2RealmConfigurationError}; it\n * extends `B2Error` so realm-validation failures can be handled with the SDK\n * error hierarchy before credentials are sent.\n *\n * Other programming errors and SDK preconditions, such as \"not yet authorized\",\n * \"stream consumed twice\", or \"called before init\", use the native `Error`\n * constructor instead. The direct `Error` outliers are\n * {@link B2InsufficientCapabilityError}, {@link B2RedirectError},\n * {@link B2SsrfError}, {@link NetworkError},\n * {@link ResumeFileIdMismatchError}, {@link UploadResponseBodyError}, and\n * {@link FinishLargeFileResponseBodyError}.\n *\n * @packageDocumentation\n */\n\nimport { redactUrlForError } from '../internal/url-redaction.ts'\nimport {\n  type B2ErrorCode,\n  type B2ErrorResponse,\n  KNOWN_B2_ERROR_CODES,\n  type KnownB2ErrorCode,\n} from '../types/errors.ts'\nimport type { BucketId, LargeFileId } from '../types/ids.ts'\n\n/** Thrown when an explicit resumeFileId is not compatible with the requested upload. */\nexport class ResumeFileIdMismatchError extends Error {\n  /** Caller-supplied unfinished large file ID that failed verification. */\n  readonly fileId: LargeFileId\n  /** Requested destination file name. */\n  readonly fileName: string\n\n  /**\n   * Creates a new resume-file ID mismatch error.\n   * @param fileId - Caller-supplied unfinished large file ID that failed verification.\n   * @param fileName - Requested destination file name.\n   */\n  constructor(fileId: LargeFileId, fileName: string) {\n    super(\n      `uploadLargeFile: resumeFileId ${fileId} does not identify a compatible unfinished large file for ${fileName}.`,\n    )\n    this.name = 'ResumeFileIdMismatchError'\n    this.fileId = fileId\n    this.fileName = fileName\n  }\n}\n\n/** Metadata captured from B2 error response headers. */\nexport interface B2ErrorOptions {\n  /** Retry delay in seconds from the `Retry-After` response header, if present. */\n  readonly retryAfter?: number\n  /** B2 request ID from the `X-Bz-Request-Id` response header, if present. */\n  readonly requestId?: string\n}\n\n/**\n * Base error class for all B2 API errors.\n * Contains the HTTP status, B2 error code, and retry metadata from the response.\n */\nexport class B2Error extends Error {\n  /** HTTP status code returned by the B2 API. */\n  readonly status: number\n  /** B2 error code identifying the error type (e.g. `expired_auth_token`). */\n  readonly code: B2ErrorCode\n  /** B2 request ID from the `X-Bz-Request-Id` response header, if present. */\n  readonly requestId?: string\n  /** Retry delay in seconds from the `Retry-After` response header, if present. */\n  readonly retryAfter?: number\n  /** Whether this error is transient and the request can be retried. */\n  readonly retryable: boolean\n\n  /**\n   * Creates a new B2Error instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional retry and request metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response.message)\n    this.name = 'B2Error'\n    this.status = response.status\n    this.code = response.code\n    if (options?.retryAfter !== undefined) this.retryAfter = options.retryAfter\n    if (options?.requestId !== undefined) this.requestId = options.requestId\n    this.retryable = isTransient(response.status, response.code)\n  }\n}\n\n/** Thrown when the auth token has expired. Triggers automatic re-authorization. */\nexport class ExpiredAuthTokenError extends B2Error {\n  /**\n   * Creates a new ExpiredAuthTokenError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ExpiredAuthTokenError'\n  }\n}\n\n/** Thrown when the auth token is invalid or unauthorized. */\nexport class BadAuthTokenError extends B2Error {\n  /**\n   * Creates a new BadAuthTokenError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadAuthTokenError'\n  }\n}\n\n/** Thrown when the B2 service is temporarily unavailable (HTTP 503). */\nexport class ServiceUnavailableError extends B2Error {\n  /**\n   * Creates a new ServiceUnavailableError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ServiceUnavailableError'\n  }\n}\n\n/** Thrown when B2 reports an internal server error. */\nexport class InternalError extends B2Error {\n  /**\n   * Creates a new InternalError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InternalError'\n  }\n}\n\n/** Thrown when a request times out on the server side (HTTP 408). */\nexport class RequestTimeoutError extends B2Error {\n  /**\n   * Creates a new RequestTimeoutError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'RequestTimeoutError'\n  }\n}\n\n/** Thrown when the client has sent too many requests (HTTP 429). */\nexport class TooManyRequestsError extends B2Error {\n  /**\n   * Creates a new TooManyRequestsError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyRequestsError'\n  }\n}\n\n/** Thrown when the account has reached the maximum number of buckets. */\nexport class TooManyBucketsError extends B2Error {\n  /**\n   * Creates a new TooManyBucketsError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyBucketsError'\n  }\n}\n\n/** Thrown when the bucket or request has reached the maximum number of files. */\nexport class TooManyFilesError extends B2Error {\n  /**\n   * Creates a new TooManyFilesError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyFilesError'\n  }\n}\n\n/** Thrown when a storage, transaction, or download cap has been exceeded. */\nexport class CapExceededError extends B2Error {\n  /**\n   * Creates a new CapExceededError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'CapExceededError'\n  }\n}\n\n/** Thrown when the application key does not have permission for the requested operation. */\nexport class AccessDeniedError extends B2Error {\n  /**\n   * Creates a new AccessDeniedError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'AccessDeniedError'\n  }\n}\n\n/** Thrown when the requested file does not exist. */\nexport class FileNotPresentError extends B2Error {\n  /**\n   * Creates a new FileNotPresentError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'FileNotPresentError'\n  }\n}\n\n/** Thrown when a requested B2 resource does not exist. */\nexport class NotFoundError extends B2Error {\n  /**\n   * Creates a new NotFoundError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'NotFoundError'\n  }\n}\n\n/** Thrown when creating a bucket with a name that already exists in the account. */\nexport class DuplicateBucketNameError extends B2Error {\n  /**\n   * Creates a new DuplicateBucketNameError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'DuplicateBucketNameError'\n  }\n}\n\n/** Thrown when a bucket name is malformed, reserved, or otherwise rejected by B2. */\nexport class InvalidBucketNameError extends B2Error {\n  /**\n   * Creates a new InvalidBucketNameError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidBucketNameError'\n  }\n}\n\n/** Thrown when bucket metadata fails B2 validation. */\nexport class InvalidBucketInfoError extends B2Error {\n  /**\n   * Creates a new InvalidBucketInfoError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidBucketInfoError'\n  }\n}\n\n/** Thrown when a bucket ID is malformed or does not identify a valid bucket. */\nexport class BadBucketIdError extends B2Error {\n  /**\n   * Creates a new BadBucketIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadBucketIdError'\n  }\n}\n\n/** Thrown when the B2 endpoint does not allow the request method. */\nexport class MethodNotAllowedError extends B2Error {\n  /**\n   * Creates a new MethodNotAllowedError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'MethodNotAllowedError'\n  }\n}\n\n/** Thrown when the request conflicts with current B2 resource state. */\nexport class ConflictError extends B2Error {\n  /**\n   * Creates a new ConflictError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ConflictError'\n  }\n}\n\n/** Thrown for general bad request errors (HTTP 400) not covered by a more specific subclass. */\nexport class BadRequestError extends B2Error {\n  /**\n   * Creates a new BadRequestError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadRequestError'\n  }\n}\n\n/** Thrown when B2 cannot parse the JSON request body. */\nexport class BadJsonError extends B2Error {\n  /**\n   * Creates a new BadJsonError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadJsonError'\n  }\n}\n\n/** Thrown when a bucket ID has a valid shape but does not identify a usable bucket. */\nexport class InvalidBucketIdError extends B2Error {\n  /**\n   * Creates a new InvalidBucketIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidBucketIdError'\n  }\n}\n\n/** Thrown when a numeric request parameter is outside the allowed range. */\nexport class OutOfRangeError extends B2Error {\n  /**\n   * Creates a new OutOfRangeError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'OutOfRangeError'\n  }\n}\n\n/** Thrown when a requested byte range cannot be satisfied. */\nexport class RangeNotSatisfiableError extends B2Error {\n  /**\n   * Creates a new RangeNotSatisfiableError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'RangeNotSatisfiableError'\n  }\n}\n\n/** Thrown when a file name is malformed or otherwise rejected by B2. */\nexport class InvalidFileNameError extends B2Error {\n  /**\n   * Creates a new InvalidFileNameError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidFileNameError'\n  }\n}\n\n/** Thrown when file metadata fails B2 validation. */\nexport class InvalidFileInfoError extends B2Error {\n  /**\n   * Creates a new InvalidFileInfoError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidFileInfoError'\n  }\n}\n\n/** Thrown when a file ID is malformed or does not identify a valid file. */\nexport class InvalidFileIdError extends B2Error {\n  /**\n   * Creates a new InvalidFileIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidFileIdError'\n  }\n}\n\n/** Thrown when a multipart upload part number is invalid. */\nexport class InvalidPartNumberError extends B2Error {\n  /**\n   * Creates a new InvalidPartNumberError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidPartNumberError'\n  }\n}\n\n/**\n * Thrown when an upload URL is no longer valid and must be refreshed.\n *\n * Forward-compat insurance: B2 does not currently surface a distinct\n * error code for this case, so {@link classifyError} never actually\n * instantiates this class today. It's part of the public API so\n * consumers can pre-write `instanceof` checks; when B2 documents a\n * `bad_upload_url` (or similar) error code, the `classifyError`\n * switch gets a matching case and existing consumer code starts\n * catching the typed error without any changes on their side.\n *\n * Until then, expect `BadRequestError` for upload-URL invalidation\n * scenarios — that's what B2 currently returns.\n */\nexport class BadUploadUrlError extends B2Error {\n  /**\n   * Creates a new BadUploadUrlError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadUploadUrlError'\n  }\n}\n\n/**\n * Thrown when the uploaded file's SHA-1 checksum does not match the\n * expected value.\n *\n * When B2 returns `bad_sha1_checksum`, {@link classifyError} instantiates\n * this class so callers can handle checksum failures with `instanceof`.\n * Generic `bad_request` checksum failures continue to classify as\n * {@link BadRequestError}.\n */\nexport class ChecksumMismatchError extends B2Error {\n  /**\n   * Creates a new ChecksumMismatchError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ChecksumMismatchError'\n  }\n}\n\n/**\n * Thrown by client-side capability checks when the application key is missing\n * capabilities required by an operation. Not raised by the server.\n */\nexport class B2InsufficientCapabilityError extends Error {\n  /** Capabilities that were required for the operation. */\n  readonly required: readonly string[]\n  /** Capabilities that the current key actually has. */\n  readonly available: readonly string[]\n  /** Capabilities present in `required` but not in `available`. */\n  readonly missing: readonly string[]\n\n  /**\n   * Creates a new B2InsufficientCapabilityError instance.\n   *\n   * @param required - Capabilities the operation requires.\n   * @param available - Capabilities the current key holds.\n   * @param missing - The subset of required that isn't available.\n   */\n  constructor(\n    required: readonly string[],\n    available: readonly string[],\n    missing: readonly string[],\n  ) {\n    super(`Application key is missing capabilities: ${missing.join(', ')}`)\n    this.name = 'B2InsufficientCapabilityError'\n    this.required = required\n    this.available = available\n    this.missing = missing\n  }\n}\n\n/**\n * Thrown when the SDK is asked to fetch a URL whose host is outside the\n * authorized B2 realm. Defense against SSRF / URL-substitution attacks where\n * a compromised or hostile B2 endpoint returns an upload URL pointing at an\n * internal service (e.g. cloud metadata at `169.254.169.254`).\n *\n * Not retryable.\n */\nexport class B2SsrfError extends Error {\n  /** Always `false` — this is a security failure, not transient. */\n  readonly retryable = false\n\n  /**\n   * Creates a new {@link B2SsrfError}.\n   *\n   * @param message - Human-readable description of which URL was rejected and why.\n   * @param url - The URL that was rejected. Stored as a sanitized URL.\n   */\n  constructor(message: string, url: string) {\n    const safeUrl = redactUrlForError(url)\n    super(`${message.split(url).join(safeUrl)} (${safeUrl})`)\n    this.name = 'B2SsrfError'\n    this.url = safeUrl\n  }\n\n  /** Sanitized URL that was rejected. */\n  readonly url: string\n}\n\n/** Thrown when a configured auth realm cannot safely be used for authorization. */\nexport class B2RealmConfigurationError extends B2Error {\n  /**\n   * Creates a new B2RealmConfigurationError instance.\n   *\n   * @param message - Human-readable description of the invalid realm setting.\n   */\n  constructor(message: string) {\n    super({ status: 400, code: 'bad_request', message })\n    this.name = 'B2RealmConfigurationError'\n  }\n}\n\n/** Thrown when the SDK refuses to follow an HTTP redirect automatically. */\nexport class B2RedirectError extends Error {\n  /** Always `false` because a blocked redirect is deterministic. */\n  readonly retryable = false\n  /** Sanitized request URL whose response attempted to redirect. */\n  readonly url: string\n  /** HTTP redirect status code, or 0 for an opaque browser redirect. */\n  readonly status: number\n  /** Sanitized redirect target, or `null` when no Location header was present. */\n  readonly location: string | null\n\n  /**\n   * Creates a new B2RedirectError instance.\n   *\n   * @param url - Request URL whose response attempted to redirect. Stored as a sanitized URL.\n   * @param status - HTTP redirect status code.\n   * @param location - Redirect Location header, if present. Stored as a sanitized URL.\n   */\n  constructor(url: string, status: number, location: string | null) {\n    const safeUrl = redactUrlForError(url)\n    const safeLocation = location !== null ? redactUrlForError(location, { baseUrl: url }) : null\n    super(\n      safeLocation !== null\n        ? `HTTP ${status} redirect blocked for ${safeUrl} to ${safeLocation}`\n        : `HTTP ${status} redirect blocked for ${safeUrl}`,\n    )\n    this.name = 'B2RedirectError'\n    this.url = safeUrl\n    this.status = status\n    this.location = safeLocation\n  }\n}\n\n/** Thrown when a network-level failure occurs (DNS, TCP, TLS). Always retryable. */\nexport class NetworkError extends Error {\n  /** Always `true` since network errors are transient. */\n  readonly retryable = true\n\n  /**\n   * Creates a new NetworkError instance.\n   * @param message - Human-readable description of the network failure.\n   * @param cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message)\n    this.name = 'NetworkError'\n  }\n}\n\n/**\n * Thrown when an upload POST returned a response but its body could not be\n * read. The upload may already have been stored by B2, so retrying this error\n * can create duplicate file versions or parts.\n */\nexport class UploadResponseBodyError extends Error {\n  /** Underlying response body error, when available. */\n  public override readonly cause?: unknown\n\n  /**\n   * Creates a new UploadResponseBodyError instance.\n   * @param message - Human-readable description of the response read failure.\n   * @param options - Optional cause.\n   */\n  constructor(\n    message: string,\n    options: {\n      readonly cause?: unknown\n    } = {},\n  ) {\n    super(message, { cause: options.cause })\n    this.name = 'UploadResponseBodyError'\n    if (options.cause !== undefined) this.cause = options.cause\n  }\n}\n\n/**\n * Thrown when `b2_finish_large_file` returned a response but its body could not\n * be read. The large file may already be committed server-side, so high-level\n * upload paths do not cancel the large file after this error.\n */\nexport class FinishLargeFileResponseBodyError extends Error {\n  /** Ambiguous large file ID that may already be committed server-side. */\n  readonly fileId?: LargeFileId\n  /** Bucket requested by the high-level upload, when available. */\n  readonly bucketId?: BucketId\n  /** File name requested by the high-level upload, when available. */\n  readonly fileName?: string\n\n  /**\n   * Creates a new FinishLargeFileResponseBodyError instance.\n   * @param message - Human-readable description of the response read failure.\n   * @param options - Optional cause and reconciliation metadata.\n   */\n  constructor(\n    message: string,\n    options: {\n      readonly cause?: unknown\n      readonly fileId?: LargeFileId\n      readonly bucketId?: BucketId\n      readonly fileName?: string\n    } = {},\n  ) {\n    super(message, { cause: options.cause })\n    this.name = 'FinishLargeFileResponseBodyError'\n    if (options.cause !== undefined) this.cause = options.cause\n    if (options.fileId !== undefined) this.fileId = options.fileId\n    if (options.bucketId !== undefined) this.bucketId = options.bucketId\n    if (options.fileName !== undefined) this.fileName = options.fileName\n  }\n}\n\nfunction isTransient(status: number, code: B2ErrorCode): boolean {\n  // Request timeout + rate limit.\n  if (status === 408 || status === 429) return true\n  // Transient server errors: internal error (500), bad gateway (502), service\n  // unavailable (503), gateway timeout (504). B2 documents 500 and 503 as\n  // retryable; 502/504 are transient infrastructure failures. 501 (Not\n  // Implemented) is deliberately excluded — it is deterministic, not transient.\n  //\n  // This is keyed on STATUS, not on the `internal_error` code: `RetryTransport`\n  // synthesizes `{ code: 'internal_error' }` for any error response whose body\n  // is not parseable JSON (see transport.ts), including bodyless 4xx like a 404\n  // download miss. Treating that code as transient would wrongly retry 4xx.\n  if (status === 500 || status === 502 || status === 503 || status === 504) return true\n  if (code === 'expired_auth_token') return true\n  if (code === 'service_unavailable' || code === 'request_timeout') return true\n  return false\n}\n\nconst knownB2ErrorCodes: ReadonlySet<string> = new Set(KNOWN_B2_ERROR_CODES)\n\nfunction isKnownB2ErrorCode(code: B2ErrorCode): code is KnownB2ErrorCode {\n  return knownB2ErrorCodes.has(code)\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled B2 error code: ${String(value)}`)\n}\n\nfunction classifyKnownError(\n  response: B2ErrorResponse,\n  code: KnownB2ErrorCode,\n  options?: B2ErrorOptions,\n): B2Error {\n  switch (code) {\n    case 'expired_auth_token':\n      return new ExpiredAuthTokenError(response, options)\n    case 'bad_auth_token':\n    case 'unauthorized':\n      return new BadAuthTokenError(response, options)\n    case 'bad_request':\n      return new BadRequestError(response, options)\n    case 'bad_bucket_name':\n    case 'invalid_bucket_name':\n      return new InvalidBucketNameError(response, options)\n    case 'bad_bucket_id':\n      return new BadBucketIdError(response, options)\n    case 'not_found':\n      return new NotFoundError(response, options)\n    case 'method_not_allowed':\n      return new MethodNotAllowedError(response, options)\n    case 'request_timeout':\n      return new RequestTimeoutError(response, options)\n    case 'too_many_requests':\n      return new TooManyRequestsError(response, options)\n    case 'conflict':\n      return new ConflictError(response, options)\n    case 'duplicate_bucket_name':\n      return new DuplicateBucketNameError(response, options)\n    case 'too_many_buckets':\n      return new TooManyBucketsError(response, options)\n    case 'too_many_files':\n      return new TooManyFilesError(response, options)\n    case 'cap_exceeded':\n    case 'storage_cap_exceeded':\n    case 'transaction_cap_exceeded':\n    case 'download_cap_exceeded':\n      return new CapExceededError(response, options)\n    case 'access_denied':\n      return new AccessDeniedError(response, options)\n    case 'service_unavailable':\n      return new ServiceUnavailableError(response, options)\n    case 'internal_error':\n      return new InternalError(response, options)\n    case 'bad_json':\n      return new BadJsonError(response, options)\n    case 'invalid_bucket_id':\n      return new InvalidBucketIdError(response, options)\n    case 'invalid_bucket_info':\n      return new InvalidBucketInfoError(response, options)\n    case 'file_not_present':\n    case 'no_such_file':\n      return new FileNotPresentError(response, options)\n    case 'out_of_range':\n      return new OutOfRangeError(response, options)\n    case 'range_not_satisfiable':\n      return new RangeNotSatisfiableError(response, options)\n    case 'invalid_file_id':\n      return new InvalidFileIdError(response, options)\n    case 'invalid_file_name':\n      return new InvalidFileNameError(response, options)\n    case 'invalid_file_info':\n      return new InvalidFileInfoError(response, options)\n    case 'invalid_part_number':\n      return new InvalidPartNumberError(response, options)\n    case 'bad_sha1_checksum':\n      return new ChecksumMismatchError(response, options)\n    default:\n      return assertNever(code)\n  }\n}\n\nfunction classifyUnknownError(response: B2ErrorResponse, options?: B2ErrorOptions): B2Error {\n  if (response.status === 429) return new TooManyRequestsError(response, options)\n  if (response.status === 503) return new ServiceUnavailableError(response, options)\n  if (response.status === 408) return new RequestTimeoutError(response, options)\n\n  return new B2Error(response, options)\n}\n\n/**\n * Maps a B2 error response to the appropriate {@link B2Error} subclass.\n * Uses known error codes for exact matching, then falls back to HTTP status\n * codes for unknown future B2 codes.\n *\n * Maintainer note: when B2 documents a new error code, add it to\n * `KNOWN_B2_ERROR_CODES` in `src/types/errors.ts` and add a matching\n * `classifyKnownError` switch case. Unknown codes fall through to the\n * HTTP-status-based heuristic and finally to a generic `B2Error`, which is\n * safe but loses semantic specificity (the caller can't `instanceof` against\n * a precise subclass and the retry decision relies on status alone).\n *\n * @param response - Parsed B2 error response body.\n * @param options - Optional retry and request metadata from response headers.\n *\n * @returns A typed B2Error subclass instance.\n */\nexport function classifyError(response: B2ErrorResponse, options?: B2ErrorOptions): B2Error {\n  // `RetryTransport` and ranged-download parsing synthesize `internal_error`\n  // when a non-JSON response body cannot provide a real B2 code. Only the\n  // documented 500/internal_error pair should classify as InternalError.\n  if (response.code === 'internal_error' && response.status !== 500) {\n    return classifyUnknownError(response, options)\n  }\n\n  if (isKnownB2ErrorCode(response.code)) return classifyKnownError(response, response.code, options)\n\n  return classifyUnknownError(response, options)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/errors/index.ts"],"sourcesContent":["/**\n * Typed error hierarchy for B2 API failures.\n *\n * Every B2 error response maps to a specific {@link B2Error} subclass.\n * Retry behavior is exposed through {@link B2Error.retryable}.\n * Examples include {@link ExpiredAuthTokenError} and {@link CapExceededError}.\n * Use {@link classifyError} to convert a raw error response into the\n * appropriate subclass.\n *\n * Convention: most `B2Error` subclasses represent failures returned by the B2\n * API. The client-side exceptions are {@link B2RealmConfigurationError} and\n * {@link B2PartnerAuthorizationError}; they extend `B2Error` so realm- and\n * Partner-authorization failures can be handled with the SDK error hierarchy\n * before or without a server round-trip.\n *\n * Other programming errors and SDK preconditions, such as \"not yet authorized\",\n * \"stream consumed twice\", or \"called before init\", use the native `Error`\n * constructor instead. The direct `Error` outliers are\n * {@link B2InsufficientCapabilityError}, {@link B2RedirectError},\n * {@link B2SsrfError}, {@link NetworkError},\n * {@link ResumeFileIdMismatchError}, {@link UploadResponseBodyError}, and\n * {@link FinishLargeFileResponseBodyError}.\n *\n * @packageDocumentation\n */\n\nimport { redactUrlForError } from '../internal/url-redaction.ts'\nimport {\n  type B2ErrorCode,\n  type B2ErrorResponse,\n  KNOWN_B2_ERROR_CODES,\n  type KnownB2ErrorCode,\n} from '../types/errors.ts'\nimport type { BucketId, LargeFileId } from '../types/ids.ts'\n\n/** Thrown when an explicit resumeFileId is not compatible with the requested upload. */\nexport class ResumeFileIdMismatchError extends Error {\n  /** Caller-supplied unfinished large file ID that failed verification. */\n  readonly fileId: LargeFileId\n  /** Requested destination file name. */\n  readonly fileName: string\n\n  /**\n   * Creates a new resume-file ID mismatch error.\n   * @param fileId - Caller-supplied unfinished large file ID that failed verification.\n   * @param fileName - Requested destination file name.\n   */\n  constructor(fileId: LargeFileId, fileName: string) {\n    super(\n      `uploadLargeFile: resumeFileId ${fileId} does not identify a compatible unfinished large file for ${fileName}.`,\n    )\n    this.name = 'ResumeFileIdMismatchError'\n    this.fileId = fileId\n    this.fileName = fileName\n  }\n}\n\n/** Metadata captured from B2 error response headers. */\nexport interface B2ErrorOptions {\n  /** Retry delay in seconds from the `Retry-After` response header, if present. */\n  readonly retryAfter?: number\n  /** B2 request ID from the `X-Bz-Request-Id` response header, if present. */\n  readonly requestId?: string\n}\n\n/**\n * Base error class for all B2 API errors.\n * Contains the HTTP status, B2 error code, and retry metadata from the response.\n */\nexport class B2Error extends Error {\n  /** HTTP status code returned by the B2 API. */\n  readonly status: number\n  /** B2 error code identifying the error type (e.g. `expired_auth_token`). */\n  readonly code: B2ErrorCode\n  /** B2 request ID from the `X-Bz-Request-Id` response header, if present. */\n  readonly requestId?: string\n  /** Retry delay in seconds from the `Retry-After` response header, if present. */\n  readonly retryAfter?: number\n  /** Whether this error is transient and the request can be retried. */\n  readonly retryable: boolean\n\n  /**\n   * Creates a new B2Error instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional retry and request metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response.message)\n    this.name = 'B2Error'\n    this.status = response.status\n    this.code = response.code\n    if (options?.retryAfter !== undefined) this.retryAfter = options.retryAfter\n    if (options?.requestId !== undefined) this.requestId = options.requestId\n    this.retryable = isTransient(response.status, response.code)\n  }\n}\n\n/** Thrown when the auth token has expired. Triggers automatic re-authorization. */\nexport class ExpiredAuthTokenError extends B2Error {\n  /**\n   * Creates a new ExpiredAuthTokenError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ExpiredAuthTokenError'\n  }\n}\n\n/** Thrown when the auth token is invalid or unauthorized. */\nexport class BadAuthTokenError extends B2Error {\n  /**\n   * Creates a new BadAuthTokenError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadAuthTokenError'\n  }\n}\n\n/** Thrown when the B2 service is temporarily unavailable (HTTP 503). */\nexport class ServiceUnavailableError extends B2Error {\n  /**\n   * Creates a new ServiceUnavailableError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ServiceUnavailableError'\n  }\n}\n\n/** Thrown when B2 reports an internal server error. */\nexport class InternalError extends B2Error {\n  /**\n   * Creates a new InternalError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InternalError'\n  }\n}\n\n/** Thrown when a request times out on the server side (HTTP 408). */\nexport class RequestTimeoutError extends B2Error {\n  /**\n   * Creates a new RequestTimeoutError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'RequestTimeoutError'\n  }\n}\n\n/** Thrown when the client has sent too many requests (HTTP 429). */\nexport class TooManyRequestsError extends B2Error {\n  /**\n   * Creates a new TooManyRequestsError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyRequestsError'\n  }\n}\n\n/** Thrown when the account has reached the maximum number of buckets. */\nexport class TooManyBucketsError extends B2Error {\n  /**\n   * Creates a new TooManyBucketsError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyBucketsError'\n  }\n}\n\n/** Thrown when the bucket or request has reached the maximum number of files. */\nexport class TooManyFilesError extends B2Error {\n  /**\n   * Creates a new TooManyFilesError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyFilesError'\n  }\n}\n\n/** Thrown when a storage, transaction, or download cap has been exceeded. */\nexport class CapExceededError extends B2Error {\n  /**\n   * Creates a new CapExceededError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'CapExceededError'\n  }\n}\n\n/** Thrown when the application key does not have permission for the requested operation. */\nexport class AccessDeniedError extends B2Error {\n  /**\n   * Creates a new AccessDeniedError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'AccessDeniedError'\n  }\n}\n\n/** Thrown when the requested file does not exist. */\nexport class FileNotPresentError extends B2Error {\n  /**\n   * Creates a new FileNotPresentError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'FileNotPresentError'\n  }\n}\n\n/** Thrown when a requested B2 resource does not exist. */\nexport class NotFoundError extends B2Error {\n  /**\n   * Creates a new NotFoundError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'NotFoundError'\n  }\n}\n\n/** Thrown when creating a bucket with a name that already exists in the account. */\nexport class DuplicateBucketNameError extends B2Error {\n  /**\n   * Creates a new DuplicateBucketNameError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'DuplicateBucketNameError'\n  }\n}\n\n/** Thrown when a bucket name is malformed, reserved, or otherwise rejected by B2. */\nexport class InvalidBucketNameError extends B2Error {\n  /**\n   * Creates a new InvalidBucketNameError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidBucketNameError'\n  }\n}\n\n/** Thrown when bucket metadata fails B2 validation. */\nexport class InvalidBucketInfoError extends B2Error {\n  /**\n   * Creates a new InvalidBucketInfoError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidBucketInfoError'\n  }\n}\n\n/** Thrown when a bucket ID is malformed or does not identify a valid bucket. */\nexport class BadBucketIdError extends B2Error {\n  /**\n   * Creates a new BadBucketIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadBucketIdError'\n  }\n}\n\n/** Thrown when the B2 endpoint does not allow the request method. */\nexport class MethodNotAllowedError extends B2Error {\n  /**\n   * Creates a new MethodNotAllowedError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'MethodNotAllowedError'\n  }\n}\n\n/** Thrown when the request conflicts with current B2 resource state. */\nexport class ConflictError extends B2Error {\n  /**\n   * Creates a new ConflictError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ConflictError'\n  }\n}\n\n/** Thrown for general bad request errors (HTTP 400) not covered by a more specific subclass. */\nexport class BadRequestError extends B2Error {\n  /**\n   * Creates a new BadRequestError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadRequestError'\n  }\n}\n\n/** Thrown when B2 cannot parse the JSON request body. */\nexport class BadJsonError extends B2Error {\n  /**\n   * Creates a new BadJsonError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadJsonError'\n  }\n}\n\n/** Thrown when a bucket ID has a valid shape but does not identify a usable bucket. */\nexport class InvalidBucketIdError extends B2Error {\n  /**\n   * Creates a new InvalidBucketIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidBucketIdError'\n  }\n}\n\n/** Thrown when a numeric request parameter is outside the allowed range. */\nexport class OutOfRangeError extends B2Error {\n  /**\n   * Creates a new OutOfRangeError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'OutOfRangeError'\n  }\n}\n\n/** Thrown when a requested byte range cannot be satisfied. */\nexport class RangeNotSatisfiableError extends B2Error {\n  /**\n   * Creates a new RangeNotSatisfiableError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'RangeNotSatisfiableError'\n  }\n}\n\n/** Thrown when a file name is malformed or otherwise rejected by B2. */\nexport class InvalidFileNameError extends B2Error {\n  /**\n   * Creates a new InvalidFileNameError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidFileNameError'\n  }\n}\n\n/** Thrown when file metadata fails B2 validation. */\nexport class InvalidFileInfoError extends B2Error {\n  /**\n   * Creates a new InvalidFileInfoError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidFileInfoError'\n  }\n}\n\n/** Thrown when a file ID is malformed or does not identify a valid file. */\nexport class InvalidFileIdError extends B2Error {\n  /**\n   * Creates a new InvalidFileIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidFileIdError'\n  }\n}\n\n/** Thrown when a multipart upload part number is invalid. */\nexport class InvalidPartNumberError extends B2Error {\n  /**\n   * Creates a new InvalidPartNumberError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidPartNumberError'\n  }\n}\n\n/**\n * Thrown when an upload URL is no longer valid and must be refreshed.\n *\n * Forward-compat insurance: B2 does not currently surface a distinct\n * error code for this case, so {@link classifyError} never actually\n * instantiates this class today. It's part of the public API so\n * consumers can pre-write `instanceof` checks; when B2 documents a\n * `bad_upload_url` (or similar) error code, the `classifyError`\n * switch gets a matching case and existing consumer code starts\n * catching the typed error without any changes on their side.\n *\n * Until then, expect `BadRequestError` for upload-URL invalidation\n * scenarios — that's what B2 currently returns.\n */\nexport class BadUploadUrlError extends B2Error {\n  /**\n   * Creates a new BadUploadUrlError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'BadUploadUrlError'\n  }\n}\n\n/**\n * Thrown when the uploaded file's SHA-1 checksum does not match the\n * expected value.\n *\n * When B2 returns `bad_sha1_checksum`, {@link classifyError} instantiates\n * this class so callers can handle checksum failures with `instanceof`.\n * Generic `bad_request` checksum failures continue to classify as\n * {@link BadRequestError}.\n */\nexport class ChecksumMismatchError extends B2Error {\n  /**\n   * Creates a new ChecksumMismatchError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'ChecksumMismatchError'\n  }\n}\n\n/** Thrown when a Partner group has reached its maximum member count. */\nexport class TooManyMembersError extends B2Error {\n  /**\n   * Creates a new TooManyMembersError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'TooManyMembersError'\n  }\n}\n\n/**\n * Compatibility alias for the issue #167 Partner member-limit error name.\n * @deprecated Use {@link TooManyMembersError}.\n */\nexport const TooManyGroupMembersError = TooManyMembersError\n/** @deprecated Use {@link TooManyMembersError}. */\nexport type TooManyGroupMembersError = TooManyMembersError\n\n/** Thrown when a Partner group ID is malformed or does not identify a valid group. */\nexport class InvalidGroupIdError extends B2Error {\n  /**\n   * Creates a new InvalidGroupIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidGroupIdError'\n  }\n}\n\n/** Thrown when a Partner member email address fails validation. */\nexport class InvalidEmailError extends B2Error {\n  /**\n   * Creates a new InvalidEmailError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidEmailError'\n  }\n}\n\n/** Thrown when a Partner API region value is unsupported or malformed. */\nexport class InvalidRegionError extends B2Error {\n  /**\n   * Creates a new InvalidRegionError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidRegionError'\n  }\n}\n\n/** Thrown when a Partner account SMS phone number fails validation. */\nexport class InvalidSmsPhoneError extends B2Error {\n  /**\n   * Creates a new InvalidSmsPhoneError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidSmsPhoneError'\n  }\n}\n\n/**\n * Compatibility alias for the issue #167 Partner SMS-phone error name.\n * @deprecated Use {@link InvalidSmsPhoneError}.\n */\nexport const MissingSmsPhoneError = InvalidSmsPhoneError\n/** @deprecated Use {@link InvalidSmsPhoneError}. */\nexport type MissingSmsPhoneError = InvalidSmsPhoneError\n\n/**\n * Thrown when B2 returns `method_failure`.\n *\n * The documented Partner group-member creation flow uses this code after\n * server-side creation fails and Backblaze rolls back before callers retry.\n * The code itself is classified globally, so this class stays endpoint-neutral.\n */\nexport class MethodFailureError extends B2Error {\n  /** Always `false` because callers should decide when a documented operation-level retry is safe. */\n  override readonly retryable = false\n\n  /**\n   * Creates a new MethodFailureError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'MethodFailureError'\n  }\n}\n\n/**\n * Compatibility alias for the issue #167 Partner group-member failure name.\n * @deprecated Use {@link MethodFailureError}.\n */\nexport const GroupMemberCreationFailedError = MethodFailureError\n/** @deprecated Use {@link MethodFailureError}. */\nexport type GroupMemberCreationFailedError = MethodFailureError\n\n/** Thrown when a Partner group member account ID fails validation. */\nexport class InvalidMemberAccountIdError extends B2Error {\n  /**\n   * Creates a new InvalidMemberAccountIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidMemberAccountIdError'\n  }\n}\n\n/** Thrown when an account ID fails Partner or Computer Backup API validation. */\nexport class InvalidAccountIdError extends B2Error {\n  /**\n   * Creates a new InvalidAccountIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidAccountIdError'\n  }\n}\n\n/** Thrown when a Computer Backup computer ID fails validation. */\nexport class InvalidComputerIdError extends B2Error {\n  /**\n   * Creates a new InvalidComputerIdError instance.\n   * @param response - Parsed B2 error response body.\n   * @param options - Optional metadata from response headers.\n   */\n  constructor(response: B2ErrorResponse, options?: B2ErrorOptions) {\n    super(response, options)\n    this.name = 'InvalidComputerIdError'\n  }\n}\n\n/**\n * Thrown by client-side capability checks when the application key is missing\n * capabilities required by an operation. Not raised by the server.\n */\nexport class B2InsufficientCapabilityError extends Error {\n  /** Capabilities that were required for the operation. */\n  readonly required: readonly string[]\n  /** Capabilities that the current key actually has. */\n  readonly available: readonly string[]\n  /** Capabilities present in `required` but not in `available`. */\n  readonly missing: readonly string[]\n\n  /**\n   * Creates a new B2InsufficientCapabilityError instance.\n   *\n   * @param required - Capabilities the operation requires.\n   * @param available - Capabilities the current key holds.\n   * @param missing - The subset of required that isn't available.\n   */\n  constructor(\n    required: readonly string[],\n    available: readonly string[],\n    missing: readonly string[],\n  ) {\n    super(`Application key is missing capabilities: ${missing.join(', ')}`)\n    this.name = 'B2InsufficientCapabilityError'\n    this.required = required\n    this.available = available\n    this.missing = missing\n  }\n}\n\n/**\n * Thrown when the SDK is asked to fetch a URL whose host is outside the\n * authorized B2 realm. Defense against SSRF / URL-substitution attacks where\n * a compromised or hostile B2 endpoint returns an upload URL pointing at an\n * internal service (e.g. cloud metadata at `169.254.169.254`).\n *\n * Not retryable.\n */\nexport class B2SsrfError extends Error {\n  /** Always `false` — this is a security failure, not transient. */\n  readonly retryable = false\n\n  /**\n   * Creates a new {@link B2SsrfError}.\n   *\n   * @param message - Human-readable description of which URL was rejected and why.\n   * @param url - The URL that was rejected. Stored as a sanitized URL.\n   */\n  constructor(message: string, url: string) {\n    const safeUrl = redactUrlForError(url)\n    super(`${message.split(url).join(safeUrl)} (${safeUrl})`)\n    this.name = 'B2SsrfError'\n    this.url = safeUrl\n  }\n\n  /** Sanitized URL that was rejected. */\n  readonly url: string\n}\n\n/** Thrown when a configured auth realm cannot safely be used for authorization. */\nexport class B2RealmConfigurationError extends B2Error {\n  /**\n   * Creates a new B2RealmConfigurationError instance.\n   *\n   * @param message - Human-readable description of the invalid realm setting.\n   */\n  constructor(message: string) {\n    super({ status: 400, code: 'bad_request', message })\n    this.name = 'B2RealmConfigurationError'\n  }\n}\n\n/** Thrown when Partner authorization returns unusable Partner/Backup auth data. */\nexport class B2PartnerAuthorizationError extends B2Error {\n  /**\n   * Creates a new B2PartnerAuthorizationError instance.\n   *\n   * @param message - Human-readable description of the invalid Partner authorization state.\n   */\n  constructor(message: string) {\n    super({ status: 400, code: 'bad_request', message })\n    this.name = 'B2PartnerAuthorizationError'\n  }\n}\n\n/** Thrown when the SDK refuses to follow an HTTP redirect automatically. */\nexport class B2RedirectError extends Error {\n  /** Always `false` because a blocked redirect is deterministic. */\n  readonly retryable = false\n  /** Sanitized request URL whose response attempted to redirect. */\n  readonly url: string\n  /** HTTP redirect status code, or 0 for an opaque browser redirect. */\n  readonly status: number\n  /** Sanitized redirect target, or `null` when no Location header was present. */\n  readonly location: string | null\n\n  /**\n   * Creates a new B2RedirectError instance.\n   *\n   * @param url - Request URL whose response attempted to redirect. Stored as a sanitized URL.\n   * @param status - HTTP redirect status code.\n   * @param location - Redirect Location header, if present. Stored as a sanitized URL.\n   */\n  constructor(url: string, status: number, location: string | null) {\n    const safeUrl = redactUrlForError(url)\n    const safeLocation = location !== null ? redactUrlForError(location, { baseUrl: url }) : null\n    super(\n      safeLocation !== null\n        ? `HTTP ${status} redirect blocked for ${safeUrl} to ${safeLocation}`\n        : `HTTP ${status} redirect blocked for ${safeUrl}`,\n    )\n    this.name = 'B2RedirectError'\n    this.url = safeUrl\n    this.status = status\n    this.location = safeLocation\n  }\n}\n\n/** Thrown when a network-level failure occurs (DNS, TCP, TLS). Always retryable. */\nexport class NetworkError extends Error {\n  /** Always `true` since network errors are transient. */\n  readonly retryable = true\n\n  /**\n   * Creates a new NetworkError instance.\n   * @param message - Human-readable description of the network failure.\n   * @param cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message)\n    this.name = 'NetworkError'\n  }\n}\n\n/**\n * Thrown when an upload POST returned a response but its body could not be\n * read. The upload may already have been stored by B2, so retrying this error\n * can create duplicate file versions or parts.\n */\nexport class UploadResponseBodyError extends Error {\n  /** Underlying response body error, when available. */\n  public override readonly cause?: unknown\n\n  /**\n   * Creates a new UploadResponseBodyError instance.\n   * @param message - Human-readable description of the response read failure.\n   * @param options - Optional cause.\n   */\n  constructor(\n    message: string,\n    options: {\n      readonly cause?: unknown\n    } = {},\n  ) {\n    super(message, { cause: options.cause })\n    this.name = 'UploadResponseBodyError'\n    if (options.cause !== undefined) this.cause = options.cause\n  }\n}\n\n/**\n * Thrown when `b2_finish_large_file` returned a response but its body could not\n * be read. The large file may already be committed server-side, so high-level\n * upload paths do not cancel the large file after this error.\n */\nexport class FinishLargeFileResponseBodyError extends Error {\n  /** Ambiguous large file ID that may already be committed server-side. */\n  readonly fileId?: LargeFileId\n  /** Bucket requested by the high-level upload, when available. */\n  readonly bucketId?: BucketId\n  /** File name requested by the high-level upload, when available. */\n  readonly fileName?: string\n\n  /**\n   * Creates a new FinishLargeFileResponseBodyError instance.\n   * @param message - Human-readable description of the response read failure.\n   * @param options - Optional cause and reconciliation metadata.\n   */\n  constructor(\n    message: string,\n    options: {\n      readonly cause?: unknown\n      readonly fileId?: LargeFileId\n      readonly bucketId?: BucketId\n      readonly fileName?: string\n    } = {},\n  ) {\n    super(message, { cause: options.cause })\n    this.name = 'FinishLargeFileResponseBodyError'\n    if (options.cause !== undefined) this.cause = options.cause\n    if (options.fileId !== undefined) this.fileId = options.fileId\n    if (options.bucketId !== undefined) this.bucketId = options.bucketId\n    if (options.fileName !== undefined) this.fileName = options.fileName\n  }\n}\n\nfunction isTransient(status: number, code: B2ErrorCode): boolean {\n  // Request timeout + rate limit.\n  if (status === 408 || status === 429) return true\n  // Transient server errors: internal error (500), bad gateway (502), service\n  // unavailable (503), gateway timeout (504). B2 documents 500 and 503 as\n  // retryable; 502/504 are transient infrastructure failures. 501 (Not\n  // Implemented) is deliberately excluded — it is deterministic, not transient.\n  //\n  // This is keyed on STATUS, not on the `internal_error` code: `RetryTransport`\n  // synthesizes `{ code: 'internal_error' }` for any error response whose body\n  // is not parseable JSON (see transport.ts), including bodyless 4xx like a 404\n  // download miss. Treating that code as transient would wrongly retry 4xx.\n  if (status === 500 || status === 502 || status === 503 || status === 504) return true\n  if (code === 'expired_auth_token') return true\n  if (code === 'service_unavailable' || code === 'request_timeout') return true\n  return false\n}\n\nconst knownB2ErrorCodes: ReadonlySet<string> = new Set(KNOWN_B2_ERROR_CODES)\n\nfunction isKnownB2ErrorCode(code: B2ErrorCode): code is KnownB2ErrorCode {\n  return knownB2ErrorCodes.has(code)\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled B2 error code: ${String(value)}`)\n}\n\nfunction classifyKnownError(\n  response: B2ErrorResponse,\n  code: KnownB2ErrorCode,\n  options?: B2ErrorOptions,\n): B2Error {\n  switch (code) {\n    case 'expired_auth_token':\n      return new ExpiredAuthTokenError(response, options)\n    case 'bad_auth_token':\n    case 'unauthorized':\n      return new BadAuthTokenError(response, options)\n    case 'bad_request':\n      return new BadRequestError(response, options)\n    case 'bad_bucket_name':\n    case 'invalid_bucket_name':\n      return new InvalidBucketNameError(response, options)\n    case 'bad_bucket_id':\n      return new BadBucketIdError(response, options)\n    case 'not_found':\n      return new NotFoundError(response, options)\n    case 'method_not_allowed':\n      return new MethodNotAllowedError(response, options)\n    case 'request_timeout':\n      return new RequestTimeoutError(response, options)\n    case 'too_many_requests':\n      return new TooManyRequestsError(response, options)\n    case 'conflict':\n      return new ConflictError(response, options)\n    case 'duplicate_bucket_name':\n      return new DuplicateBucketNameError(response, options)\n    case 'too_many_buckets':\n      return new TooManyBucketsError(response, options)\n    case 'too_many_files':\n      return new TooManyFilesError(response, options)\n    case 'too_many_members':\n      return new TooManyMembersError(response, options)\n    case 'cap_exceeded':\n    case 'storage_cap_exceeded':\n    case 'transaction_cap_exceeded':\n    case 'download_cap_exceeded':\n      return new CapExceededError(response, options)\n    case 'access_denied':\n      return new AccessDeniedError(response, options)\n    case 'service_unavailable':\n      return new ServiceUnavailableError(response, options)\n    case 'internal_error':\n      return new InternalError(response, options)\n    case 'bad_json':\n      return new BadJsonError(response, options)\n    case 'invalid_account_id':\n      return new InvalidAccountIdError(response, options)\n    case 'invalid_bucket_id':\n      return new InvalidBucketIdError(response, options)\n    case 'invalid_bucket_info':\n      return new InvalidBucketInfoError(response, options)\n    case 'invalid_computer_id':\n      return new InvalidComputerIdError(response, options)\n    case 'invalid_email':\n      return new InvalidEmailError(response, options)\n    case 'invalid_group_id':\n      return new InvalidGroupIdError(response, options)\n    case 'invalid_member_account_id':\n      return new InvalidMemberAccountIdError(response, options)\n    case 'invalid_region':\n      return new InvalidRegionError(response, options)\n    case 'invalid_sms_phone':\n      return new InvalidSmsPhoneError(response, options)\n    case 'file_not_present':\n    case 'no_such_file':\n      return new FileNotPresentError(response, options)\n    case 'out_of_range':\n      return new OutOfRangeError(response, options)\n    case 'range_not_satisfiable':\n      return new RangeNotSatisfiableError(response, options)\n    case 'invalid_file_id':\n      return new InvalidFileIdError(response, options)\n    case 'invalid_file_name':\n      return new InvalidFileNameError(response, options)\n    case 'invalid_file_info':\n      return new InvalidFileInfoError(response, options)\n    case 'invalid_part_number':\n      return new InvalidPartNumberError(response, options)\n    case 'method_failure':\n      return new MethodFailureError(response, options)\n    case 'bad_sha1_checksum':\n      return new ChecksumMismatchError(response, options)\n    default:\n      return assertNever(code)\n  }\n}\n\nfunction classifyUnknownError(response: B2ErrorResponse, options?: B2ErrorOptions): B2Error {\n  if (response.status === 429) return new TooManyRequestsError(response, options)\n  if (response.status === 503) return new ServiceUnavailableError(response, options)\n  if (response.status === 408) return new RequestTimeoutError(response, options)\n\n  return new B2Error(response, options)\n}\n\n/**\n * Maps a B2 error response to the appropriate {@link B2Error} subclass.\n * Uses known error codes for exact matching, then falls back to HTTP status\n * codes for unknown future B2 codes.\n *\n * Maintainer note: when B2 documents a new error code, add it to\n * `KNOWN_B2_ERROR_CODES` in `src/types/errors.ts` and add a matching\n * `classifyKnownError` switch case. Unknown codes fall through to the\n * HTTP-status-based heuristic and finally to a generic `B2Error`, which is\n * safe but loses semantic specificity (the caller can't `instanceof` against\n * a precise subclass and the retry decision relies on status alone).\n *\n * @param response - Parsed B2 error response body.\n * @param options - Optional retry and request metadata from response headers.\n *\n * @returns A typed B2Error subclass instance.\n */\nexport function classifyError(response: B2ErrorResponse, options?: B2ErrorOptions): B2Error {\n  // `RetryTransport` and ranged-download parsing synthesize `internal_error`\n  // when a non-JSON response body cannot provide a real B2 code. Only the\n  // documented 500/internal_error pair should classify as InternalError.\n  if (response.code === 'internal_error' && response.status !== 500) {\n    return classifyUnknownError(response, options)\n  }\n\n  if (isKnownB2ErrorCode(response.code)) return classifyKnownError(response, response.code, options)\n\n  return classifyUnknownError(response, options)\n}\n"],"mappings":"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"}

package/dist/http/retry.cjs

@@ -4,7 +4,7 @@ var DEFAULT_RETRY_OPTIONS = {
 	maxRetries: 5,
 	maxRetryDelayMs: 64e3,
 	initialRetryDelayMs: 1e3,
-	requestTimeoutMs: 15 * 6e4
+	requestTimeoutMs: 9e5
 };
 /**
 * Computes the delay before the next retry using exponential backoff with jitter.

package/dist/http/retry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"retry.cjs","names":[],"sources":["../../src/http/retry.ts"],"sourcesContent":["/** Configuration for retry behavior on transient failures. */\nexport interface RetryOptions {\n  /** Maximum number of retry attempts before giving up. */\n  readonly maxRetries: number\n  /** Upper bound on retry delay in milliseconds, regardless of backoff calculation. */\n  readonly maxRetryDelayMs: number\n  /** Base delay in milliseconds for the first retry. Doubles on each subsequent attempt. */\n  readonly initialRetryDelayMs: number\n  /**\n   * Optional timeout for each HTTP request attempt. Defaults to 15 minutes\n   * when omitted. The timer covers request dispatch, upload bodies, and\n   * non-streaming response body reads. For `response.body` streams it is an\n   * idle timeout that resets after each received chunk. Set to 0 to disable\n   * the SDK timeout and rely only on the caller's AbortSignal.\n   */\n  readonly requestTimeoutMs?: number\n}\n\n/** Default retry settings: 5 retries, 1s initial delay, 64s max delay, 15 minute timeout. */\nexport const DEFAULT_RETRY_OPTIONS = {\n  maxRetries: 5,\n  maxRetryDelayMs: 64_000,\n  initialRetryDelayMs: 1_000,\n  requestTimeoutMs: 15 * 60_000,\n} satisfies Required<RetryOptions>\n\n/**\n * Computes the delay before the next retry using exponential backoff with jitter.\n * If a `Retry-After` value is provided by the server, it takes precedence over\n * the calculated backoff (still capped at {@link RetryOptions.maxRetryDelayMs}).\n *\n * @param attempt - Zero-based retry attempt index.\n * @param options - Retry configuration with delay bounds.\n * @param retryAfter - Server-provided retry delay in seconds, if any.\n *\n * @returns The delay in milliseconds before the next retry attempt.\n */\nexport function computeBackoff(\n  attempt: number,\n  options: RetryOptions,\n  retryAfter?: number,\n): number {\n  if (retryAfter !== undefined && retryAfter > 0) {\n    return Math.min(retryAfter * 1000, options.maxRetryDelayMs)\n  }\n  const base = options.initialRetryDelayMs * 2 ** attempt\n  const jitter = Math.random() * base * 0.5\n  return Math.min(base + jitter, options.maxRetryDelayMs)\n}\n\n/**\n * Returns a promise that resolves after the given delay. Supports cancellation\n * via an optional AbortSignal.\n *\n * @param ms - Delay in milliseconds.\n * @param signal - Optional abort signal to cancel the sleep early.\n *\n * @returns A promise that resolves when the delay elapses or rejects if aborted.\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason ?? new DOMException('Aborted', 'AbortError'))\n      return\n    }\n    const timer = setTimeout(resolve, ms)\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer)\n        reject(signal.reason ?? new DOMException('Aborted', 'AbortError'))\n      },\n      { once: true },\n    )\n  })\n}\n"],"mappings":";;AAmBA,IAAa,wBAAwB;CACnC,YAAY;CACZ,iBAAiB;CACjB,qBAAqB;CACrB,kBAAkB,KAAK;AACzB;;;;;;;;;;;;AAaA,SAAgB,eACd,SACA,SACA,YACQ;CACR,IAAI,eAAe,KAAA,KAAa,aAAa,GAC3C,OAAO,KAAK,IAAI,aAAa,KAAM,QAAQ,eAAe;CAE5D,MAAM,OAAO,QAAQ,sBAAsB,KAAK;CAChD,MAAM,SAAS,KAAK,OAAO,IAAI,OAAO;CACtC,OAAO,KAAK,IAAI,OAAO,QAAQ,QAAQ,eAAe;AACxD;;;;;;;;;;AAWA,SAAgB,MAAM,IAAY,QAAqC;CACrE,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,QAAQ,SAAS;GACnB,OAAO,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY,CAAC;GACjE;EACF;EACA,MAAM,QAAQ,WAAW,SAAS,EAAE;EACpC,QAAQ,iBACN,eACM;GACJ,aAAa,KAAK;GAClB,OAAO,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY,CAAC;EACnE,GACA,EAAE,MAAM,KAAK,CACf;CACF,CAAC;AACH"}
+{"version":3,"file":"retry.cjs","names":[],"sources":["../../src/http/retry.ts"],"sourcesContent":["/** Configuration for retry behavior on transient failures. */\nexport interface RetryOptions {\n  /** Maximum number of retry attempts before giving up. */\n  readonly maxRetries: number\n  /** Upper bound on retry delay in milliseconds, regardless of backoff calculation. */\n  readonly maxRetryDelayMs: number\n  /** Base delay in milliseconds for the first retry. Doubles on each subsequent attempt. */\n  readonly initialRetryDelayMs: number\n  /**\n   * Optional timeout for each HTTP request attempt. Defaults to 15 minutes\n   * when omitted. The timer covers request dispatch, upload bodies, and\n   * non-streaming response body reads. For `response.body` streams it is an\n   * idle timeout that resets after each received chunk. Set to 0 to disable\n   * the SDK timeout and rely only on the caller's AbortSignal.\n   */\n  readonly requestTimeoutMs?: number\n}\n\n/** Default retry settings: 5 retries, 1s initial delay, 64s max delay, 15 minute timeout. */\nexport const DEFAULT_RETRY_OPTIONS = {\n  maxRetries: 5,\n  maxRetryDelayMs: 64_000,\n  initialRetryDelayMs: 1_000,\n  requestTimeoutMs: 15 * 60_000,\n} satisfies Required<RetryOptions>\n\n/**\n * Computes the delay before the next retry using exponential backoff with jitter.\n * If a `Retry-After` value is provided by the server, it takes precedence over\n * the calculated backoff (still capped at {@link RetryOptions.maxRetryDelayMs}).\n *\n * @param attempt - Zero-based retry attempt index.\n * @param options - Retry configuration with delay bounds.\n * @param retryAfter - Server-provided retry delay in seconds, if any.\n *\n * @returns The delay in milliseconds before the next retry attempt.\n */\nexport function computeBackoff(\n  attempt: number,\n  options: RetryOptions,\n  retryAfter?: number,\n): number {\n  if (retryAfter !== undefined && retryAfter > 0) {\n    return Math.min(retryAfter * 1000, options.maxRetryDelayMs)\n  }\n  const base = options.initialRetryDelayMs * 2 ** attempt\n  const jitter = Math.random() * base * 0.5\n  return Math.min(base + jitter, options.maxRetryDelayMs)\n}\n\n/**\n * Returns a promise that resolves after the given delay. Supports cancellation\n * via an optional AbortSignal.\n *\n * @param ms - Delay in milliseconds.\n * @param signal - Optional abort signal to cancel the sleep early.\n *\n * @returns A promise that resolves when the delay elapses or rejects if aborted.\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason ?? new DOMException('Aborted', 'AbortError'))\n      return\n    }\n    const timer = setTimeout(resolve, ms)\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer)\n        reject(signal.reason ?? new DOMException('Aborted', 'AbortError'))\n      },\n      { once: true },\n    )\n  })\n}\n"],"mappings":";;AAmBA,IAAa,wBAAwB;CACnC,YAAY;CACZ,iBAAiB;CACjB,qBAAqB;CACrB,kBAAkB;AACpB;;;;;;;;;;;;AAaA,SAAgB,eACd,SACA,SACA,YACQ;CACR,IAAI,eAAe,KAAA,KAAa,aAAa,GAC3C,OAAO,KAAK,IAAI,aAAa,KAAM,QAAQ,eAAe;CAE5D,MAAM,OAAO,QAAQ,sBAAsB,KAAK;CAChD,MAAM,SAAS,KAAK,OAAO,IAAI,OAAO;CACtC,OAAO,KAAK,IAAI,OAAO,QAAQ,QAAQ,eAAe;AACxD;;;;;;;;;;AAWA,SAAgB,MAAM,IAAY,QAAqC;CACrE,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,QAAQ,SAAS;GACnB,OAAO,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY,CAAC;GACjE;EACF;EACA,MAAM,QAAQ,WAAW,SAAS,EAAE;EACpC,QAAQ,iBACN,eACM;GACJ,aAAa,KAAK;GAClB,OAAO,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY,CAAC;EACnE,GACA,EAAE,MAAM,KAAK,CACf;CACF,CAAC;AACH"}

package/dist/http/retry.js

@@ -4,7 +4,7 @@ var DEFAULT_RETRY_OPTIONS = {
 	maxRetries: 5,
 	maxRetryDelayMs: 64e3,
 	initialRetryDelayMs: 1e3,
-	requestTimeoutMs: 15 * 6e4
+	requestTimeoutMs: 9e5
 };
 /**
 * Computes the delay before the next retry using exponential backoff with jitter.