@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/types/errors.d.cts

@@ -1,9 +1,18 @@
 /**
- * Known B2 API error codes.
- * The union includes a `string & {}` fallback to allow unknown error codes
- * while still providing autocomplete for well-known values.
+ * B2 API error codes documented by the SDK.
+ * This list drives `KnownB2ErrorCode`; `B2ErrorCode` adds a string fallback
+ * so callers can receive unknown future server codes while keeping autocomplete
+ * for known values.
  */
-export type B2ErrorCode = 'expired_auth_token' | 'bad_auth_token' | 'unauthorized' | 'bad_request' | 'bad_bucket_id' | 'not_found' | 'method_not_allowed' | 'request_timeout' | 'conflict' | 'duplicate_bucket_name' | 'too_many_buckets' | 'too_many_files' | 'cap_exceeded' | 'storage_cap_exceeded' | 'transaction_cap_exceeded' | 'access_denied' | 'service_unavailable' | 'internal_error' | 'bad_json' | 'invalid_bucket_id' | 'file_not_present' | 'no_such_file' | 'out_of_range' | 'range_not_satisfiable' | 'invalid_file_id' | 'invalid_part_number' | 'bad_sha1_checksum' | 'download_cap_exceeded' | (string & {});
+export declare const KNOWN_B2_ERROR_CODES: readonly ["expired_auth_token", "bad_auth_token", "unauthorized", "bad_request", "bad_bucket_name", "bad_bucket_id", "not_found", "method_not_allowed", "request_timeout", "too_many_requests", "conflict", "duplicate_bucket_name", "too_many_buckets", "too_many_files", "too_many_members", "cap_exceeded", "storage_cap_exceeded", "transaction_cap_exceeded", "download_cap_exceeded", "access_denied", "service_unavailable", "internal_error", "bad_json", "invalid_account_id", "invalid_bucket_id", "invalid_bucket_name", "invalid_bucket_info", "invalid_computer_id", "invalid_email", "invalid_group_id", "invalid_member_account_id", "invalid_region", "invalid_sms_phone", "file_not_present", "no_such_file", "out_of_range", "range_not_satisfiable", "invalid_file_id", "invalid_file_name", "invalid_file_info", "invalid_part_number", "method_failure", "bad_sha1_checksum"];
+/** B2 error codes documented by the SDK and classified exhaustively. */
+export type KnownB2ErrorCode = (typeof KNOWN_B2_ERROR_CODES)[number];
+/**
+ * B2 API error code value.
+ * Known codes are enumerated for autocomplete; unknown future server codes are
+ * still accepted as strings.
+ */
+export type B2ErrorCode = KnownB2ErrorCode | (string & {});
 /** Standard error response body returned by the B2 API on failure. */
 export interface B2ErrorResponse {
     /** HTTP status code from the B2 API response. */

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,eAAe,GACf,WAAW,GACX,oBAAoB,GACpB,iBAAiB,GACjB,UAAU,GACV,uBAAuB,GACvB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,sBAAsB,GACtB,0BAA0B,GAC1B,eAAe,GACf,qBAAqB,GACrB,gBAAgB,GAChB,UAAU,GACV,mBAAmB,GACnB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,uBAAuB,GACvB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,uBAAuB,GACvB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjB,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,o2BA4CvB,CAAA;AAEV,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1D,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}

package/dist/types/errors.d.ts

@@ -1,9 +1,18 @@
 /**
- * Known B2 API error codes.
- * The union includes a `string & {}` fallback to allow unknown error codes
- * while still providing autocomplete for well-known values.
+ * B2 API error codes documented by the SDK.
+ * This list drives `KnownB2ErrorCode`; `B2ErrorCode` adds a string fallback
+ * so callers can receive unknown future server codes while keeping autocomplete
+ * for known values.
  */
-export type B2ErrorCode = 'expired_auth_token' | 'bad_auth_token' | 'unauthorized' | 'bad_request' | 'bad_bucket_id' | 'not_found' | 'method_not_allowed' | 'request_timeout' | 'conflict' | 'duplicate_bucket_name' | 'too_many_buckets' | 'too_many_files' | 'cap_exceeded' | 'storage_cap_exceeded' | 'transaction_cap_exceeded' | 'access_denied' | 'service_unavailable' | 'internal_error' | 'bad_json' | 'invalid_bucket_id' | 'file_not_present' | 'no_such_file' | 'out_of_range' | 'range_not_satisfiable' | 'invalid_file_id' | 'invalid_part_number' | 'bad_sha1_checksum' | 'download_cap_exceeded' | (string & {});
+export declare const KNOWN_B2_ERROR_CODES: readonly ["expired_auth_token", "bad_auth_token", "unauthorized", "bad_request", "bad_bucket_name", "bad_bucket_id", "not_found", "method_not_allowed", "request_timeout", "too_many_requests", "conflict", "duplicate_bucket_name", "too_many_buckets", "too_many_files", "too_many_members", "cap_exceeded", "storage_cap_exceeded", "transaction_cap_exceeded", "download_cap_exceeded", "access_denied", "service_unavailable", "internal_error", "bad_json", "invalid_account_id", "invalid_bucket_id", "invalid_bucket_name", "invalid_bucket_info", "invalid_computer_id", "invalid_email", "invalid_group_id", "invalid_member_account_id", "invalid_region", "invalid_sms_phone", "file_not_present", "no_such_file", "out_of_range", "range_not_satisfiable", "invalid_file_id", "invalid_file_name", "invalid_file_info", "invalid_part_number", "method_failure", "bad_sha1_checksum"];
+/** B2 error codes documented by the SDK and classified exhaustively. */
+export type KnownB2ErrorCode = (typeof KNOWN_B2_ERROR_CODES)[number];
+/**
+ * B2 API error code value.
+ * Known codes are enumerated for autocomplete; unknown future server codes are
+ * still accepted as strings.
+ */
+export type B2ErrorCode = KnownB2ErrorCode | (string & {});
 /** Standard error response body returned by the B2 API on failure. */
 export interface B2ErrorResponse {
     /** HTTP status code from the B2 API response. */

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,eAAe,GACf,WAAW,GACX,oBAAoB,GACpB,iBAAiB,GACjB,UAAU,GACV,uBAAuB,GACvB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,sBAAsB,GACtB,0BAA0B,GAC1B,eAAe,GACf,qBAAqB,GACrB,gBAAgB,GAChB,UAAU,GACV,mBAAmB,GACnB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,uBAAuB,GACvB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,uBAAuB,GACvB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjB,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,o2BA4CvB,CAAA;AAEV,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1D,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}

package/dist/types/errors.js

@@ -0,0 +1,56 @@
+//#region src/types/errors.ts
+/**
+* B2 API error codes documented by the SDK.
+* This list drives `KnownB2ErrorCode`; `B2ErrorCode` adds a string fallback
+* so callers can receive unknown future server codes while keeping autocomplete
+* for known values.
+*/
+var KNOWN_B2_ERROR_CODES = [
+	"expired_auth_token",
+	"bad_auth_token",
+	"unauthorized",
+	"bad_request",
+	"bad_bucket_name",
+	"bad_bucket_id",
+	"not_found",
+	"method_not_allowed",
+	"request_timeout",
+	"too_many_requests",
+	"conflict",
+	"duplicate_bucket_name",
+	"too_many_buckets",
+	"too_many_files",
+	"too_many_members",
+	"cap_exceeded",
+	"storage_cap_exceeded",
+	"transaction_cap_exceeded",
+	"download_cap_exceeded",
+	"access_denied",
+	"service_unavailable",
+	"internal_error",
+	"bad_json",
+	"invalid_account_id",
+	"invalid_bucket_id",
+	"invalid_bucket_name",
+	"invalid_bucket_info",
+	"invalid_computer_id",
+	"invalid_email",
+	"invalid_group_id",
+	"invalid_member_account_id",
+	"invalid_region",
+	"invalid_sms_phone",
+	"file_not_present",
+	"no_such_file",
+	"out_of_range",
+	"range_not_satisfiable",
+	"invalid_file_id",
+	"invalid_file_name",
+	"invalid_file_info",
+	"invalid_part_number",
+	"method_failure",
+	"bad_sha1_checksum"
+];
+//#endregion
+export { KNOWN_B2_ERROR_CODES };
+
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":["/**\n * B2 API error codes documented by the SDK.\n * This list drives `KnownB2ErrorCode`; `B2ErrorCode` adds a string fallback\n * so callers can receive unknown future server codes while keeping autocomplete\n * for known values.\n */\nexport const KNOWN_B2_ERROR_CODES = [\n  'expired_auth_token',\n  'bad_auth_token',\n  'unauthorized',\n  'bad_request',\n  'bad_bucket_name',\n  'bad_bucket_id',\n  'not_found',\n  'method_not_allowed',\n  'request_timeout',\n  'too_many_requests',\n  'conflict',\n  'duplicate_bucket_name',\n  'too_many_buckets',\n  'too_many_files',\n  'too_many_members',\n  'cap_exceeded',\n  'storage_cap_exceeded',\n  'transaction_cap_exceeded',\n  'download_cap_exceeded',\n  'access_denied',\n  'service_unavailable',\n  'internal_error',\n  'bad_json',\n  'invalid_account_id',\n  'invalid_bucket_id',\n  'invalid_bucket_name',\n  'invalid_bucket_info',\n  'invalid_computer_id',\n  'invalid_email',\n  'invalid_group_id',\n  'invalid_member_account_id',\n  'invalid_region',\n  'invalid_sms_phone',\n  'file_not_present',\n  'no_such_file',\n  'out_of_range',\n  'range_not_satisfiable',\n  'invalid_file_id',\n  'invalid_file_name',\n  'invalid_file_info',\n  'invalid_part_number',\n  'method_failure',\n  'bad_sha1_checksum',\n] as const\n\n/** B2 error codes documented by the SDK and classified exhaustively. */\nexport type KnownB2ErrorCode = (typeof KNOWN_B2_ERROR_CODES)[number]\n\n/**\n * B2 API error code value.\n * Known codes are enumerated for autocomplete; unknown future server codes are\n * still accepted as strings.\n */\nexport type B2ErrorCode = KnownB2ErrorCode | (string & {})\n\n/** Standard error response body returned by the B2 API on failure. */\nexport interface B2ErrorResponse {\n  /** HTTP status code from the B2 API response. */\n  readonly status: number\n  /** Machine-readable error code identifying the specific failure. */\n  readonly code: B2ErrorCode\n  /** Human-readable description of the error. */\n  readonly message: string\n}\n"],"mappings":";;;;;;;AAMA,IAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/types/file.cjs

@@ -1,23 +1,40 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const FileAction = {
-  /** Large file upload started but not yet finished. */
-  Start: "start",
-  /** Normal upload (small or finished large file). */
-  Upload: "upload",
-  /** Hide marker (soft delete). */
-  Hide: "hide",
-  /** Virtual folder marker. */
-  Folder: "folder",
-  /** Created via server-side copy. */
-  Copy: "copy"
+//#region src/types/file.ts
+/**
+* Named constants for the action that created a file version.
+*
+* @example
+* ```ts
+* if (file.action === FileAction.Hide) { ... }
+* ```
+*/
+var FileAction = {
+	/** Large file upload started but not yet finished. */
+	Start: "start",
+	/** Normal upload (small or finished large file). */
+	Upload: "upload",
+	/** Hide marker (soft delete). */
+	Hide: "hide",
+	/** Virtual folder marker. */
+	Folder: "folder",
+	/** Created via server-side copy. */
+	Copy: "copy"
 };
-const MetadataDirective = {
-  /** Preserve the source file's contentType and fileInfo. */
-  Copy: "COPY",
-  /** Use the values provided in the copy request. */
-  Replace: "REPLACE"
+/**
+* Named constants for how metadata is handled during a file copy.
+*
+* @example
+* ```ts
+* await bucket.copyFile({ ..., metadataDirective: MetadataDirective.Replace })
+* ```
+*/
+var MetadataDirective = {
+	/** Preserve the source file's contentType and fileInfo. */
+	Copy: "COPY",
+	/** Use the values provided in the copy request. */
+	Replace: "REPLACE"
 };
+//#endregion
 exports.FileAction = FileAction;
 exports.MetadataDirective = MetadataDirective;
-//# sourceMappingURL=file.cjs.map
+
+//# sourceMappingURL=file.cjs.map

package/dist/types/file.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"file.cjs","sources":["../../src/types/file.ts"],"sourcesContent":["import type { EncryptionSetting } from './encryption.ts'\nimport type { AccountId, BucketId, FileId } from './ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './lock.ts'\n\n/**\n * Named constants for the action that created a file version.\n *\n * @example\n * ```ts\n * if (file.action === FileAction.Hide) { ... }\n * ```\n */\nexport const FileAction = {\n  /** Large file upload started but not yet finished. */\n  Start: 'start',\n  /** Normal upload (small or finished large file). */\n  Upload: 'upload',\n  /** Hide marker (soft delete). */\n  Hide: 'hide',\n  /** Virtual folder marker. */\n  Folder: 'folder',\n  /** Created via server-side copy. */\n  Copy: 'copy',\n} as const\n\n/**\n * The action that created a file version. Derived from {@link FileAction}.\n *\n * - `'start'`: large file upload started but not yet finished.\n * - `'upload'`: file was uploaded normally.\n * - `'hide'`: file was hidden (soft-deleted).\n * - `'folder'`: virtual folder marker.\n * - `'copy'`: file was created via server-side copy.\n */\nexport type FileAction = (typeof FileAction)[keyof typeof FileAction]\n\n/**\n * Complete metadata for a single file version in B2.\n * Returned by `b2_get_file_info`, `b2_list_file_names`, `b2_list_file_versions`,\n * `b2_upload_file`, `b2_copy_file`, and other file-related endpoints.\n */\nexport interface FileVersion {\n  /** Account that owns this file. */\n  readonly accountId: AccountId\n  /** Action that created this file version. */\n  readonly action: FileAction\n  /** Bucket containing this file. */\n  readonly bucketId: BucketId\n  /** Size of the file content in bytes. */\n  readonly contentLength: number\n  /** MD5 checksum of the content, or null if not available. */\n  readonly contentMd5: string | null\n  /** SHA-1 checksum of the content, or null if not available (e.g., large files). */\n  readonly contentSha1: string | null\n  /** MIME type of the file content. */\n  readonly contentType: string\n  /** Unique identifier for this file version. */\n  readonly fileId: FileId\n  /** User-defined key-value metadata stored with the file. */\n  readonly fileInfo: Record<string, string>\n  /** Full path and name of the file within the bucket. */\n  readonly fileName: string\n  /** Object Lock retention settings for this file version. */\n  readonly fileRetention: {\n    /** Whether the caller is authorized to read retention settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Retention settings, or null if the caller lacks read authorization. */\n    readonly value: FileRetentionValue | null\n  }\n  /** Legal hold status for this file version. */\n  readonly legalHold: {\n    /** Whether the caller is authorized to read legal hold status. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Legal hold value, or null if the caller lacks read authorization. */\n    readonly value: LegalHoldValue | null\n  }\n  /** Replication status, or null if replication is not configured. */\n  readonly replicationStatus: 'pending' | 'completed' | 'failed' | 'replica' | null\n  /** Server-side encryption settings applied to this file version. */\n  readonly serverSideEncryption: EncryptionSetting\n  /** UTC timestamp (milliseconds) when this version was uploaded. */\n  readonly uploadTimestamp: number\n}\n\n/** Request parameters for the `b2_list_file_names` API call. Lists the most recent version of each file in a bucket. */\nexport interface ListFileNamesRequest {\n  /** Bucket to list files from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Maximum number of files to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_names` API call. */\nexport interface ListFileNamesResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all files have been listed. */\n  readonly nextFileName: string | null\n}\n\n/** Request parameters for the `b2_list_file_versions` API call. Lists all versions of files in a bucket. */\nexport interface ListFileVersionsRequest {\n  /** Bucket to list file versions from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Return file versions starting after this ID. Used with startFileName for pagination. */\n  readonly startFileId?: FileId\n  /** Maximum number of file versions to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_versions` API call. */\nexport interface ListFileVersionsResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all versions have been listed. */\n  readonly nextFileName: string | null\n  /** Next file ID to use for pagination, or null if all versions have been listed. */\n  readonly nextFileId: FileId | null\n}\n\n/** Request parameters for the `b2_get_file_info` API call. */\nexport interface GetFileInfoRequest {\n  /** ID of the file version to retrieve info for. */\n  readonly fileId: FileId\n}\n\n/** Request parameters for the `b2_hide_file` API call. Hides a file so it no longer appears in `b2_list_file_names`. */\nexport interface HideFileRequest {\n  /** Bucket containing the file to hide. */\n  readonly bucketId: BucketId\n  /** Name of the file to hide. */\n  readonly fileName: string\n}\n\n/** Request parameters for the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionRequest {\n  /** Name of the file version to delete. */\n  readonly fileName: string\n  /** ID of the file version to delete. */\n  readonly fileId: FileId\n  /** If true, bypass governance-mode retention. Requires the `bypassGovernance` capability. */\n  readonly bypassGovernance?: boolean\n}\n\n/** Response from the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionResponse {\n  /** ID of the deleted file version. */\n  readonly fileId: FileId\n  /** Name of the deleted file. */\n  readonly fileName: string\n}\n\n/**\n * Named constants for how metadata is handled during a file copy.\n *\n * @example\n * ```ts\n * await bucket.copyFile({ ..., metadataDirective: MetadataDirective.Replace })\n * ```\n */\nexport const MetadataDirective = {\n  /** Preserve the source file's contentType and fileInfo. */\n  Copy: 'COPY',\n  /** Use the values provided in the copy request. */\n  Replace: 'REPLACE',\n} as const\n\n/** Controls how metadata is handled during a file copy. Derived from {@link MetadataDirective}. */\nexport type MetadataDirective = (typeof MetadataDirective)[keyof typeof MetadataDirective]\n\n/** Request parameters for the `b2_copy_file` API call. Performs a server-side file copy. */\nexport interface CopyFileRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** Destination bucket ID. Defaults to the source bucket if omitted. */\n  readonly destinationBucketId?: BucketId\n  /** Name for the destination file. */\n  readonly fileName: string\n  /** Byte range to copy (e.g., `'bytes=0-999'`). Omit to copy the entire file. */\n  readonly range?: string\n  /** Whether to copy or replace the source file's metadata. */\n  readonly metadataDirective?: MetadataDirective\n  /** MIME type for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly contentType?: string\n  /** User-defined metadata for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly fileInfo?: Record<string, string>\n  /** Object Lock retention for the destination file. */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold for the destination file. */\n  readonly legalHold?: LegalHoldValue\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination file. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Request parameters for the `b2_copy_part` API call. Copies a byte range into a large file part. */\nexport interface CopyPartRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** ID of the large file being assembled. */\n  readonly largeFileId: FileId\n  /** Part number (1-based) for this part within the large file. */\n  readonly partNumber: number\n  /** Byte range to copy from the source (e.g., `'bytes=0-999'`). Omit to copy the entire source. */\n  readonly range?: string\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination part. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Response from the `b2_copy_part` API call. */\nexport interface CopyPartResponse {\n  /** ID of the large file this part belongs to. */\n  readonly fileId: FileId\n  /** Part number within the large file. */\n  readonly partNumber: number\n  /** Size of the copied part in bytes. */\n  readonly contentLength: number\n  /** SHA-1 checksum of the copied part content. */\n  readonly contentSha1: string\n}\n"],"names":[],"mappings":";;AAYO,MAAM,aAAa;AAAA;AAAA,EAExB,OAAO;AAAA;AAAA,EAEP,QAAQ;AAAA;AAAA,EAER,MAAM;AAAA;AAAA,EAEN,QAAQ;AAAA;AAAA,EAER,MAAM;AACR;AAqJO,MAAM,oBAAoB;AAAA;AAAA,EAE/B,MAAM;AAAA;AAAA,EAEN,SAAS;AACX;;;"}
+{"version":3,"file":"file.cjs","names":[],"sources":["../../src/types/file.ts"],"sourcesContent":["import type { EncryptionSetting, PublicEncryptionSetting } from './encryption.ts'\nimport type { AccountId, BucketId, FileId } from './ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './lock.ts'\n\n/**\n * Named constants for the action that created a file version.\n *\n * @example\n * ```ts\n * if (file.action === FileAction.Hide) { ... }\n * ```\n */\nexport const FileAction = {\n  /** Large file upload started but not yet finished. */\n  Start: 'start',\n  /** Normal upload (small or finished large file). */\n  Upload: 'upload',\n  /** Hide marker (soft delete). */\n  Hide: 'hide',\n  /** Virtual folder marker. */\n  Folder: 'folder',\n  /** Created via server-side copy. */\n  Copy: 'copy',\n} as const\n\n/**\n * The action that created a file version. Derived from {@link FileAction}.\n *\n * - `'start'`: large file upload started but not yet finished.\n * - `'upload'`: file was uploaded normally.\n * - `'hide'`: file was hidden (soft-deleted).\n * - `'folder'`: virtual folder marker.\n * - `'copy'`: file was created via server-side copy.\n */\nexport type FileAction = (typeof FileAction)[keyof typeof FileAction]\n\n/**\n * Replication status for a file version or unfinished large file.\n *\n * B2 returns these uppercase wire values as-is and omits the containing\n * `replicationStatus` field when the file is not covered by a replication rule.\n */\nexport type ReplicationStatus = 'PENDING' | 'COMPLETED' | 'FAILED' | 'REPLICA'\n\n/**\n * Complete metadata for a single file version in B2.\n * Returned by `b2_get_file_info`, `b2_list_file_names`, `b2_list_file_versions`,\n * `b2_upload_file`, `b2_copy_file`, and other file-related endpoints.\n */\nexport interface FileVersion {\n  /** Account that owns this file. */\n  readonly accountId: AccountId\n  /** Action that created this file version. */\n  readonly action: FileAction\n  /** Bucket containing this file. */\n  readonly bucketId: BucketId\n  /** Size of the file content in bytes. */\n  readonly contentLength: number\n  /** MD5 checksum of the content, or null if not available. */\n  readonly contentMd5: string | null\n  /** SHA-1 checksum of the content, or null if not available (e.g., large files). */\n  readonly contentSha1: string | null\n  /** MIME type of the file content. */\n  readonly contentType: string\n  /** Unique identifier for this file version. */\n  readonly fileId: FileId\n  /** User-defined key-value metadata stored with the file. */\n  readonly fileInfo: Record<string, string>\n  /** Full path and name of the file within the bucket. */\n  readonly fileName: string\n  /** Object Lock retention settings for this file version. */\n  readonly fileRetention: {\n    /** Whether the caller is authorized to read retention settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Retention settings, or null if the caller lacks read authorization. */\n    readonly value: FileRetentionValue | null\n  }\n  /** Legal hold status for this file version. */\n  readonly legalHold: {\n    /** Whether the caller is authorized to read legal hold status. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Legal hold value, or null if the caller lacks read authorization. */\n    readonly value: LegalHoldValue | null\n  }\n  /** Replication status when this file is covered by a replication rule. */\n  readonly replicationStatus?: ReplicationStatus\n  /** Server-side encryption settings applied to this file version. */\n  readonly serverSideEncryption: PublicEncryptionSetting\n  /** UTC timestamp (milliseconds) when this version was uploaded. */\n  readonly uploadTimestamp: number\n}\n\n/** Request parameters for the `b2_list_file_names` API call. Lists the most recent version of each file in a bucket. */\nexport interface ListFileNamesRequest {\n  /** Bucket to list files from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Maximum number of files to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_names` API call. */\nexport interface ListFileNamesResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all files have been listed. */\n  readonly nextFileName: string | null\n}\n\n/** Request parameters for the `b2_list_file_versions` API call. Lists all versions of files in a bucket. */\nexport interface ListFileVersionsRequest {\n  /** Bucket to list file versions from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Return file versions starting after this ID. Used with startFileName for pagination. */\n  readonly startFileId?: FileId\n  /** Maximum number of file versions to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_versions` API call. */\nexport interface ListFileVersionsResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all versions have been listed. */\n  readonly nextFileName: string | null\n  /** Next file ID to use for pagination, or null if all versions have been listed. */\n  readonly nextFileId: FileId | null\n}\n\n/** Request parameters for the `b2_get_file_info` API call. */\nexport interface GetFileInfoRequest {\n  /** ID of the file version to retrieve info for. */\n  readonly fileId: FileId\n}\n\n/** Request parameters for the `b2_hide_file` API call. Hides a file so it no longer appears in `b2_list_file_names`. */\nexport interface HideFileRequest {\n  /** Bucket containing the file to hide. */\n  readonly bucketId: BucketId\n  /** Name of the file to hide. */\n  readonly fileName: string\n}\n\n/** Request parameters for the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionRequest {\n  /** Name of the file version to delete. */\n  readonly fileName: string\n  /** ID of the file version to delete. */\n  readonly fileId: FileId\n  /** If true, bypass governance-mode retention. Requires the `bypassGovernance` capability. */\n  readonly bypassGovernance?: boolean\n}\n\n/** Response from the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionResponse {\n  /** ID of the deleted file version. */\n  readonly fileId: FileId\n  /** Name of the deleted file. */\n  readonly fileName: string\n}\n\n/**\n * Named constants for how metadata is handled during a file copy.\n *\n * @example\n * ```ts\n * await bucket.copyFile({ ..., metadataDirective: MetadataDirective.Replace })\n * ```\n */\nexport const MetadataDirective = {\n  /** Preserve the source file's contentType and fileInfo. */\n  Copy: 'COPY',\n  /** Use the values provided in the copy request. */\n  Replace: 'REPLACE',\n} as const\n\n/** Controls how metadata is handled during a file copy. Derived from {@link MetadataDirective}. */\nexport type MetadataDirective = (typeof MetadataDirective)[keyof typeof MetadataDirective]\n\n/** Request parameters for the `b2_copy_file` API call. Performs a server-side file copy. */\nexport interface CopyFileRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** Destination bucket ID. Defaults to the source bucket if omitted. */\n  readonly destinationBucketId?: BucketId\n  /** Name for the destination file. */\n  readonly fileName: string\n  /** Byte range to copy (e.g., `'bytes=0-999'`). Omit to copy the entire file. */\n  readonly range?: string\n  /** Whether to copy or replace the source file's metadata. */\n  readonly metadataDirective?: MetadataDirective\n  /** MIME type for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly contentType?: string\n  /** User-defined metadata for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly fileInfo?: Record<string, string>\n  /** Object Lock retention for the destination file. */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold for the destination file. */\n  readonly legalHold?: LegalHoldValue\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination file. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Request parameters for the `b2_copy_part` API call. Copies a byte range into a large file part. */\nexport interface CopyPartRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** ID of the large file being assembled. */\n  readonly largeFileId: FileId\n  /** Part number (1-based) for this part within the large file. */\n  readonly partNumber: number\n  /** Byte range to copy from the source (e.g., `'bytes=0-999'`). Omit to copy the entire source. */\n  readonly range?: string\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination part. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Response from the `b2_copy_part` API call. */\nexport interface CopyPartResponse {\n  /** ID of the large file this part belongs to. */\n  readonly fileId: FileId\n  /** Part number within the large file. */\n  readonly partNumber: number\n  /** Size of the copied part in bytes. */\n  readonly contentLength: number\n  /** SHA-1 checksum of the copied part content. */\n  readonly contentSha1: string\n  /** MD5 checksum of the copied part content, or null if not available. */\n  readonly contentMd5: string | null\n  /** Server-side encryption applied to this copied part. */\n  readonly serverSideEncryption: PublicEncryptionSetting\n  /** UTC timestamp (milliseconds) when this part was copied. */\n  readonly uploadTimestamp: number\n}\n"],"mappings":";;;;;;;;;AAYA,IAAa,aAAa;;CAExB,OAAO;;CAEP,QAAQ;;CAER,MAAM;;CAEN,QAAQ;;CAER,MAAM;AACR;;;;;;;;;AA6JA,IAAa,oBAAoB;;CAE/B,MAAM;;CAEN,SAAS;AACX"}

package/dist/types/file.d.cts

@@ -1,4 +1,4 @@
-import { EncryptionSetting } from './encryption.js';
+import { EncryptionSetting, PublicEncryptionSetting } from './encryption.js';
 import { AccountId, BucketId, FileId } from './ids.js';
 import { FileRetentionValue, LegalHoldValue } from './lock.js';
 /**
@@ -31,6 +31,13 @@ export declare const FileAction: {
  * - `'copy'`: file was created via server-side copy.
  */
 export type FileAction = (typeof FileAction)[keyof typeof FileAction];
+/**
+ * Replication status for a file version or unfinished large file.
+ *
+ * B2 returns these uppercase wire values as-is and omits the containing
+ * `replicationStatus` field when the file is not covered by a replication rule.
+ */
+export type ReplicationStatus = 'PENDING' | 'COMPLETED' | 'FAILED' | 'REPLICA';
 /**
  * Complete metadata for a single file version in B2.
  * Returned by `b2_get_file_info`, `b2_list_file_names`, `b2_list_file_versions`,
@@ -71,10 +78,10 @@ export interface FileVersion {
         /** Legal hold value, or null if the caller lacks read authorization. */
         readonly value: LegalHoldValue | null;
     };
-    /** Replication status, or null if replication is not configured. */
-    readonly replicationStatus: 'pending' | 'completed' | 'failed' | 'replica' | null;
+    /** Replication status when this file is covered by a replication rule. */
+    readonly replicationStatus?: ReplicationStatus;
     /** Server-side encryption settings applied to this file version. */
-    readonly serverSideEncryption: EncryptionSetting;
+    readonly serverSideEncryption: PublicEncryptionSetting;
     /** UTC timestamp (milliseconds) when this version was uploaded. */
     readonly uploadTimestamp: number;
 }
@@ -216,5 +223,11 @@ export interface CopyPartResponse {
     readonly contentLength: number;
     /** SHA-1 checksum of the copied part content. */
     readonly contentSha1: string;
+    /** MD5 checksum of the copied part content, or null if not available. */
+    readonly contentMd5: string | null;
+    /** Server-side encryption applied to this copied part. */
+    readonly serverSideEncryption: PublicEncryptionSetting;
+    /** UTC timestamp (milliseconds) when this part was copied. */
+    readonly uploadTimestamp: number;
 }
 //# sourceMappingURL=file.d.ts.map

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

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

package/dist/types/file.d.ts

@@ -1,4 +1,4 @@
-import { EncryptionSetting } from './encryption.js';
+import { EncryptionSetting, PublicEncryptionSetting } from './encryption.js';
 import { AccountId, BucketId, FileId } from './ids.js';
 import { FileRetentionValue, LegalHoldValue } from './lock.js';
 /**
@@ -31,6 +31,13 @@ export declare const FileAction: {
  * - `'copy'`: file was created via server-side copy.
  */
 export type FileAction = (typeof FileAction)[keyof typeof FileAction];
+/**
+ * Replication status for a file version or unfinished large file.
+ *
+ * B2 returns these uppercase wire values as-is and omits the containing
+ * `replicationStatus` field when the file is not covered by a replication rule.
+ */
+export type ReplicationStatus = 'PENDING' | 'COMPLETED' | 'FAILED' | 'REPLICA';
 /**
  * Complete metadata for a single file version in B2.
  * Returned by `b2_get_file_info`, `b2_list_file_names`, `b2_list_file_versions`,
@@ -71,10 +78,10 @@ export interface FileVersion {
         /** Legal hold value, or null if the caller lacks read authorization. */
         readonly value: LegalHoldValue | null;
     };
-    /** Replication status, or null if replication is not configured. */
-    readonly replicationStatus: 'pending' | 'completed' | 'failed' | 'replica' | null;
+    /** Replication status when this file is covered by a replication rule. */
+    readonly replicationStatus?: ReplicationStatus;
     /** Server-side encryption settings applied to this file version. */
-    readonly serverSideEncryption: EncryptionSetting;
+    readonly serverSideEncryption: PublicEncryptionSetting;
     /** UTC timestamp (milliseconds) when this version was uploaded. */
     readonly uploadTimestamp: number;
 }
@@ -216,5 +223,11 @@ export interface CopyPartResponse {
     readonly contentLength: number;
     /** SHA-1 checksum of the copied part content. */
     readonly contentSha1: string;
+    /** MD5 checksum of the copied part content, or null if not available. */
+    readonly contentMd5: string | null;
+    /** Server-side encryption applied to this copied part. */
+    readonly serverSideEncryption: PublicEncryptionSetting;
+    /** UTC timestamp (milliseconds) when this part was copied. */
+    readonly uploadTimestamp: number;
 }
 //# sourceMappingURL=file.d.ts.map

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

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

package/dist/types/file.js

@@ -1,23 +1,39 @@
-const FileAction = {
-  /** Large file upload started but not yet finished. */
-  Start: "start",
-  /** Normal upload (small or finished large file). */
-  Upload: "upload",
-  /** Hide marker (soft delete). */
-  Hide: "hide",
-  /** Virtual folder marker. */
-  Folder: "folder",
-  /** Created via server-side copy. */
-  Copy: "copy"
+//#region src/types/file.ts
+/**
+* Named constants for the action that created a file version.
+*
+* @example
+* ```ts
+* if (file.action === FileAction.Hide) { ... }
+* ```
+*/
+var FileAction = {
+	/** Large file upload started but not yet finished. */
+	Start: "start",
+	/** Normal upload (small or finished large file). */
+	Upload: "upload",
+	/** Hide marker (soft delete). */
+	Hide: "hide",
+	/** Virtual folder marker. */
+	Folder: "folder",
+	/** Created via server-side copy. */
+	Copy: "copy"
 };
-const MetadataDirective = {
-  /** Preserve the source file's contentType and fileInfo. */
-  Copy: "COPY",
-  /** Use the values provided in the copy request. */
-  Replace: "REPLACE"
+/**
+* Named constants for how metadata is handled during a file copy.
+*
+* @example
+* ```ts
+* await bucket.copyFile({ ..., metadataDirective: MetadataDirective.Replace })
+* ```
+*/
+var MetadataDirective = {
+	/** Preserve the source file's contentType and fileInfo. */
+	Copy: "COPY",
+	/** Use the values provided in the copy request. */
+	Replace: "REPLACE"
 };
-export {
-  FileAction,
-  MetadataDirective
-};
-//# sourceMappingURL=file.js.map
+//#endregion
+export { FileAction, MetadataDirective };
+
+//# sourceMappingURL=file.js.map

package/dist/types/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sources":["../../src/types/file.ts"],"sourcesContent":["import type { EncryptionSetting } from './encryption.ts'\nimport type { AccountId, BucketId, FileId } from './ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './lock.ts'\n\n/**\n * Named constants for the action that created a file version.\n *\n * @example\n * ```ts\n * if (file.action === FileAction.Hide) { ... }\n * ```\n */\nexport const FileAction = {\n  /** Large file upload started but not yet finished. */\n  Start: 'start',\n  /** Normal upload (small or finished large file). */\n  Upload: 'upload',\n  /** Hide marker (soft delete). */\n  Hide: 'hide',\n  /** Virtual folder marker. */\n  Folder: 'folder',\n  /** Created via server-side copy. */\n  Copy: 'copy',\n} as const\n\n/**\n * The action that created a file version. Derived from {@link FileAction}.\n *\n * - `'start'`: large file upload started but not yet finished.\n * - `'upload'`: file was uploaded normally.\n * - `'hide'`: file was hidden (soft-deleted).\n * - `'folder'`: virtual folder marker.\n * - `'copy'`: file was created via server-side copy.\n */\nexport type FileAction = (typeof FileAction)[keyof typeof FileAction]\n\n/**\n * Complete metadata for a single file version in B2.\n * Returned by `b2_get_file_info`, `b2_list_file_names`, `b2_list_file_versions`,\n * `b2_upload_file`, `b2_copy_file`, and other file-related endpoints.\n */\nexport interface FileVersion {\n  /** Account that owns this file. */\n  readonly accountId: AccountId\n  /** Action that created this file version. */\n  readonly action: FileAction\n  /** Bucket containing this file. */\n  readonly bucketId: BucketId\n  /** Size of the file content in bytes. */\n  readonly contentLength: number\n  /** MD5 checksum of the content, or null if not available. */\n  readonly contentMd5: string | null\n  /** SHA-1 checksum of the content, or null if not available (e.g., large files). */\n  readonly contentSha1: string | null\n  /** MIME type of the file content. */\n  readonly contentType: string\n  /** Unique identifier for this file version. */\n  readonly fileId: FileId\n  /** User-defined key-value metadata stored with the file. */\n  readonly fileInfo: Record<string, string>\n  /** Full path and name of the file within the bucket. */\n  readonly fileName: string\n  /** Object Lock retention settings for this file version. */\n  readonly fileRetention: {\n    /** Whether the caller is authorized to read retention settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Retention settings, or null if the caller lacks read authorization. */\n    readonly value: FileRetentionValue | null\n  }\n  /** Legal hold status for this file version. */\n  readonly legalHold: {\n    /** Whether the caller is authorized to read legal hold status. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Legal hold value, or null if the caller lacks read authorization. */\n    readonly value: LegalHoldValue | null\n  }\n  /** Replication status, or null if replication is not configured. */\n  readonly replicationStatus: 'pending' | 'completed' | 'failed' | 'replica' | null\n  /** Server-side encryption settings applied to this file version. */\n  readonly serverSideEncryption: EncryptionSetting\n  /** UTC timestamp (milliseconds) when this version was uploaded. */\n  readonly uploadTimestamp: number\n}\n\n/** Request parameters for the `b2_list_file_names` API call. Lists the most recent version of each file in a bucket. */\nexport interface ListFileNamesRequest {\n  /** Bucket to list files from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Maximum number of files to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_names` API call. */\nexport interface ListFileNamesResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all files have been listed. */\n  readonly nextFileName: string | null\n}\n\n/** Request parameters for the `b2_list_file_versions` API call. Lists all versions of files in a bucket. */\nexport interface ListFileVersionsRequest {\n  /** Bucket to list file versions from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Return file versions starting after this ID. Used with startFileName for pagination. */\n  readonly startFileId?: FileId\n  /** Maximum number of file versions to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_versions` API call. */\nexport interface ListFileVersionsResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all versions have been listed. */\n  readonly nextFileName: string | null\n  /** Next file ID to use for pagination, or null if all versions have been listed. */\n  readonly nextFileId: FileId | null\n}\n\n/** Request parameters for the `b2_get_file_info` API call. */\nexport interface GetFileInfoRequest {\n  /** ID of the file version to retrieve info for. */\n  readonly fileId: FileId\n}\n\n/** Request parameters for the `b2_hide_file` API call. Hides a file so it no longer appears in `b2_list_file_names`. */\nexport interface HideFileRequest {\n  /** Bucket containing the file to hide. */\n  readonly bucketId: BucketId\n  /** Name of the file to hide. */\n  readonly fileName: string\n}\n\n/** Request parameters for the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionRequest {\n  /** Name of the file version to delete. */\n  readonly fileName: string\n  /** ID of the file version to delete. */\n  readonly fileId: FileId\n  /** If true, bypass governance-mode retention. Requires the `bypassGovernance` capability. */\n  readonly bypassGovernance?: boolean\n}\n\n/** Response from the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionResponse {\n  /** ID of the deleted file version. */\n  readonly fileId: FileId\n  /** Name of the deleted file. */\n  readonly fileName: string\n}\n\n/**\n * Named constants for how metadata is handled during a file copy.\n *\n * @example\n * ```ts\n * await bucket.copyFile({ ..., metadataDirective: MetadataDirective.Replace })\n * ```\n */\nexport const MetadataDirective = {\n  /** Preserve the source file's contentType and fileInfo. */\n  Copy: 'COPY',\n  /** Use the values provided in the copy request. */\n  Replace: 'REPLACE',\n} as const\n\n/** Controls how metadata is handled during a file copy. Derived from {@link MetadataDirective}. */\nexport type MetadataDirective = (typeof MetadataDirective)[keyof typeof MetadataDirective]\n\n/** Request parameters for the `b2_copy_file` API call. Performs a server-side file copy. */\nexport interface CopyFileRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** Destination bucket ID. Defaults to the source bucket if omitted. */\n  readonly destinationBucketId?: BucketId\n  /** Name for the destination file. */\n  readonly fileName: string\n  /** Byte range to copy (e.g., `'bytes=0-999'`). Omit to copy the entire file. */\n  readonly range?: string\n  /** Whether to copy or replace the source file's metadata. */\n  readonly metadataDirective?: MetadataDirective\n  /** MIME type for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly contentType?: string\n  /** User-defined metadata for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly fileInfo?: Record<string, string>\n  /** Object Lock retention for the destination file. */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold for the destination file. */\n  readonly legalHold?: LegalHoldValue\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination file. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Request parameters for the `b2_copy_part` API call. Copies a byte range into a large file part. */\nexport interface CopyPartRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** ID of the large file being assembled. */\n  readonly largeFileId: FileId\n  /** Part number (1-based) for this part within the large file. */\n  readonly partNumber: number\n  /** Byte range to copy from the source (e.g., `'bytes=0-999'`). Omit to copy the entire source. */\n  readonly range?: string\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination part. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Response from the `b2_copy_part` API call. */\nexport interface CopyPartResponse {\n  /** ID of the large file this part belongs to. */\n  readonly fileId: FileId\n  /** Part number within the large file. */\n  readonly partNumber: number\n  /** Size of the copied part in bytes. */\n  readonly contentLength: number\n  /** SHA-1 checksum of the copied part content. */\n  readonly contentSha1: string\n}\n"],"names":[],"mappings":"AAYO,MAAM,aAAa;AAAA;AAAA,EAExB,OAAO;AAAA;AAAA,EAEP,QAAQ;AAAA;AAAA,EAER,MAAM;AAAA;AAAA,EAEN,QAAQ;AAAA;AAAA,EAER,MAAM;AACR;AAqJO,MAAM,oBAAoB;AAAA;AAAA,EAE/B,MAAM;AAAA;AAAA,EAEN,SAAS;AACX;"}
+{"version":3,"file":"file.js","names":[],"sources":["../../src/types/file.ts"],"sourcesContent":["import type { EncryptionSetting, PublicEncryptionSetting } from './encryption.ts'\nimport type { AccountId, BucketId, FileId } from './ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './lock.ts'\n\n/**\n * Named constants for the action that created a file version.\n *\n * @example\n * ```ts\n * if (file.action === FileAction.Hide) { ... }\n * ```\n */\nexport const FileAction = {\n  /** Large file upload started but not yet finished. */\n  Start: 'start',\n  /** Normal upload (small or finished large file). */\n  Upload: 'upload',\n  /** Hide marker (soft delete). */\n  Hide: 'hide',\n  /** Virtual folder marker. */\n  Folder: 'folder',\n  /** Created via server-side copy. */\n  Copy: 'copy',\n} as const\n\n/**\n * The action that created a file version. Derived from {@link FileAction}.\n *\n * - `'start'`: large file upload started but not yet finished.\n * - `'upload'`: file was uploaded normally.\n * - `'hide'`: file was hidden (soft-deleted).\n * - `'folder'`: virtual folder marker.\n * - `'copy'`: file was created via server-side copy.\n */\nexport type FileAction = (typeof FileAction)[keyof typeof FileAction]\n\n/**\n * Replication status for a file version or unfinished large file.\n *\n * B2 returns these uppercase wire values as-is and omits the containing\n * `replicationStatus` field when the file is not covered by a replication rule.\n */\nexport type ReplicationStatus = 'PENDING' | 'COMPLETED' | 'FAILED' | 'REPLICA'\n\n/**\n * Complete metadata for a single file version in B2.\n * Returned by `b2_get_file_info`, `b2_list_file_names`, `b2_list_file_versions`,\n * `b2_upload_file`, `b2_copy_file`, and other file-related endpoints.\n */\nexport interface FileVersion {\n  /** Account that owns this file. */\n  readonly accountId: AccountId\n  /** Action that created this file version. */\n  readonly action: FileAction\n  /** Bucket containing this file. */\n  readonly bucketId: BucketId\n  /** Size of the file content in bytes. */\n  readonly contentLength: number\n  /** MD5 checksum of the content, or null if not available. */\n  readonly contentMd5: string | null\n  /** SHA-1 checksum of the content, or null if not available (e.g., large files). */\n  readonly contentSha1: string | null\n  /** MIME type of the file content. */\n  readonly contentType: string\n  /** Unique identifier for this file version. */\n  readonly fileId: FileId\n  /** User-defined key-value metadata stored with the file. */\n  readonly fileInfo: Record<string, string>\n  /** Full path and name of the file within the bucket. */\n  readonly fileName: string\n  /** Object Lock retention settings for this file version. */\n  readonly fileRetention: {\n    /** Whether the caller is authorized to read retention settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Retention settings, or null if the caller lacks read authorization. */\n    readonly value: FileRetentionValue | null\n  }\n  /** Legal hold status for this file version. */\n  readonly legalHold: {\n    /** Whether the caller is authorized to read legal hold status. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Legal hold value, or null if the caller lacks read authorization. */\n    readonly value: LegalHoldValue | null\n  }\n  /** Replication status when this file is covered by a replication rule. */\n  readonly replicationStatus?: ReplicationStatus\n  /** Server-side encryption settings applied to this file version. */\n  readonly serverSideEncryption: PublicEncryptionSetting\n  /** UTC timestamp (milliseconds) when this version was uploaded. */\n  readonly uploadTimestamp: number\n}\n\n/** Request parameters for the `b2_list_file_names` API call. Lists the most recent version of each file in a bucket. */\nexport interface ListFileNamesRequest {\n  /** Bucket to list files from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Maximum number of files to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_names` API call. */\nexport interface ListFileNamesResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all files have been listed. */\n  readonly nextFileName: string | null\n}\n\n/** Request parameters for the `b2_list_file_versions` API call. Lists all versions of files in a bucket. */\nexport interface ListFileVersionsRequest {\n  /** Bucket to list file versions from. */\n  readonly bucketId: BucketId\n  /** Return files starting after this name (exclusive). Used for pagination. */\n  readonly startFileName?: string\n  /** Return file versions starting after this ID. Used with startFileName for pagination. */\n  readonly startFileId?: FileId\n  /** Maximum number of file versions to return (1 to 10000). */\n  readonly maxFileCount?: number\n  /** Only return files whose names start with this prefix. */\n  readonly prefix?: string\n  /** Delimiter for virtual folder grouping (typically `'/'`). */\n  readonly delimiter?: string\n}\n\n/** Response from the `b2_list_file_versions` API call. */\nexport interface ListFileVersionsResponse {\n  /** Array of file versions matching the request. */\n  readonly files: readonly FileVersion[]\n  /** Next file name to use for pagination, or null if all versions have been listed. */\n  readonly nextFileName: string | null\n  /** Next file ID to use for pagination, or null if all versions have been listed. */\n  readonly nextFileId: FileId | null\n}\n\n/** Request parameters for the `b2_get_file_info` API call. */\nexport interface GetFileInfoRequest {\n  /** ID of the file version to retrieve info for. */\n  readonly fileId: FileId\n}\n\n/** Request parameters for the `b2_hide_file` API call. Hides a file so it no longer appears in `b2_list_file_names`. */\nexport interface HideFileRequest {\n  /** Bucket containing the file to hide. */\n  readonly bucketId: BucketId\n  /** Name of the file to hide. */\n  readonly fileName: string\n}\n\n/** Request parameters for the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionRequest {\n  /** Name of the file version to delete. */\n  readonly fileName: string\n  /** ID of the file version to delete. */\n  readonly fileId: FileId\n  /** If true, bypass governance-mode retention. Requires the `bypassGovernance` capability. */\n  readonly bypassGovernance?: boolean\n}\n\n/** Response from the `b2_delete_file_version` API call. */\nexport interface DeleteFileVersionResponse {\n  /** ID of the deleted file version. */\n  readonly fileId: FileId\n  /** Name of the deleted file. */\n  readonly fileName: string\n}\n\n/**\n * Named constants for how metadata is handled during a file copy.\n *\n * @example\n * ```ts\n * await bucket.copyFile({ ..., metadataDirective: MetadataDirective.Replace })\n * ```\n */\nexport const MetadataDirective = {\n  /** Preserve the source file's contentType and fileInfo. */\n  Copy: 'COPY',\n  /** Use the values provided in the copy request. */\n  Replace: 'REPLACE',\n} as const\n\n/** Controls how metadata is handled during a file copy. Derived from {@link MetadataDirective}. */\nexport type MetadataDirective = (typeof MetadataDirective)[keyof typeof MetadataDirective]\n\n/** Request parameters for the `b2_copy_file` API call. Performs a server-side file copy. */\nexport interface CopyFileRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** Destination bucket ID. Defaults to the source bucket if omitted. */\n  readonly destinationBucketId?: BucketId\n  /** Name for the destination file. */\n  readonly fileName: string\n  /** Byte range to copy (e.g., `'bytes=0-999'`). Omit to copy the entire file. */\n  readonly range?: string\n  /** Whether to copy or replace the source file's metadata. */\n  readonly metadataDirective?: MetadataDirective\n  /** MIME type for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly contentType?: string\n  /** User-defined metadata for the destination file (only used when metadataDirective is `'REPLACE'`). */\n  readonly fileInfo?: Record<string, string>\n  /** Object Lock retention for the destination file. */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold for the destination file. */\n  readonly legalHold?: LegalHoldValue\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination file. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Request parameters for the `b2_copy_part` API call. Copies a byte range into a large file part. */\nexport interface CopyPartRequest {\n  /** ID of the source file version to copy from. */\n  readonly sourceFileId: FileId\n  /** ID of the large file being assembled. */\n  readonly largeFileId: FileId\n  /** Part number (1-based) for this part within the large file. */\n  readonly partNumber: number\n  /** Byte range to copy from the source (e.g., `'bytes=0-999'`). Omit to copy the entire source. */\n  readonly range?: string\n  /** SSE-C settings for reading the source file, if the source is encrypted with SSE-C. */\n  readonly sourceServerSideEncryption?: EncryptionSetting\n  /** Server-side encryption to apply to the destination part. */\n  readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\n/** Response from the `b2_copy_part` API call. */\nexport interface CopyPartResponse {\n  /** ID of the large file this part belongs to. */\n  readonly fileId: FileId\n  /** Part number within the large file. */\n  readonly partNumber: number\n  /** Size of the copied part in bytes. */\n  readonly contentLength: number\n  /** SHA-1 checksum of the copied part content. */\n  readonly contentSha1: string\n  /** MD5 checksum of the copied part content, or null if not available. */\n  readonly contentMd5: string | null\n  /** Server-side encryption applied to this copied part. */\n  readonly serverSideEncryption: PublicEncryptionSetting\n  /** UTC timestamp (milliseconds) when this part was copied. */\n  readonly uploadTimestamp: number\n}\n"],"mappings":";;;;;;;;;AAYA,IAAa,aAAa;;CAExB,OAAO;;CAEP,QAAQ;;CAER,MAAM;;CAEN,QAAQ;;CAER,MAAM;AACR;;;;;;;;;AA6JA,IAAa,oBAAoB;;CAE/B,MAAM;;CAEN,SAAS;AACX"}

package/dist/types/ids.cjs

@@ -1,27 +1,101 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/types/ids.ts
+/**
+* Creates a branded {@link AccountId} from a raw string.
+* @param raw - The raw account ID string from the B2 API.
+*
+* @returns A branded AccountId value.
+*/
 function accountId(raw) {
-  return raw;
+	return raw;
 }
+/**
+* Creates a branded {@link BucketId} from a raw string.
+* @param raw - The raw bucket ID string from the B2 API.
+*
+* @returns A branded BucketId value.
+*/
 function bucketId(raw) {
-  return raw;
+	return raw;
 }
+/**
+* Creates a branded {@link FileId} from a raw string.
+* @param raw - The raw file ID string from the B2 API.
+*
+* @returns A branded FileId value.
+*/
 function fileId(raw) {
-  return raw;
+	return raw;
 }
+/**
+* Creates a branded {@link KeyId} from a raw string.
+* @param raw - The raw key ID string from the B2 API.
+*
+* @returns A branded KeyId value.
+*/
 function keyId(raw) {
-  return raw;
+	return raw;
 }
+/**
+* Creates a branded {@link ApplicationKeyId} from a raw string.
+* @param raw - The raw application key ID string from the B2 API.
+*
+* @returns A branded ApplicationKeyId value.
+*/
 function applicationKeyId(raw) {
-  return raw;
+	return raw;
 }
+/**
+* Creates a branded {@link GroupId} from a raw string.
+* @param raw - The raw group ID string from the Partner API.
+*
+* @returns A branded GroupId value.
+*/
+function groupId(raw) {
+	return raw;
+}
+/**
+* Creates a branded {@link ComputerId} from a raw string.
+* @param raw - The raw computer ID string from the Computer Backup API.
+*
+* @returns A branded ComputerId value.
+*/
+function computerId(raw) {
+	return raw;
+}
+/**
+* Creates a branded {@link PartnerToken} from a raw authorization token string.
+* @param raw - The raw Partner/Backup authorization token from the B2 API.
+*
+* @returns A branded PartnerToken value.
+*/
+function partnerToken(raw) {
+	return raw;
+}
+/**
+* Creates a branded {@link LargeFileId} from a raw string.
+*
+* `LargeFileId` is the same wire-level shape as `FileId` but is a
+* distinct brand so that "ID of an in-progress multipart upload" and
+* "ID of a committed file version" don't get mixed up by accident.
+* `b2_start_large_file` returns one; `b2_finish_large_file` consumes it
+* and produces a regular `FileId`.
+*
+* @param raw - The raw large-file ID string from the B2 API.
+*
+* @returns A branded LargeFileId value.
+*/
 function largeFileId(raw) {
-  return raw;
+	return raw;
 }
+//#endregion
 exports.accountId = accountId;
 exports.applicationKeyId = applicationKeyId;
 exports.bucketId = bucketId;
+exports.computerId = computerId;
 exports.fileId = fileId;
+exports.groupId = groupId;
 exports.keyId = keyId;
 exports.largeFileId = largeFileId;
-//# sourceMappingURL=ids.cjs.map
+exports.partnerToken = partnerToken;
+
+//# sourceMappingURL=ids.cjs.map