@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/object.cjs

@@ -1,212 +1,255 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const parallel = require("./download/parallel.cjs");
-const single$1 = require("./download/single.cjs");
-const large = require("./upload/large.cjs");
-const single = require("./upload/single.cjs");
-const stream = require("./upload/stream.cjs");
-class B2Object {
-  /** The file name (path) within the bucket. */
-  fileName;
-  client;
-  bucket;
-  /**
-   * @param client - The parent B2Client instance.
-   * @param bucket - The parent Bucket this object belongs to.
-   * @param fileName - The file path within the bucket.
-   *
-   * @internal
-   */
-  constructor(client, bucket, fileName) {
-    this.client = client;
-    this.bucket = bucket;
-    this.fileName = fileName;
-  }
-  /**
-   * Uploads data to this file name. Automatically uses multipart upload for large files.
-   * @param options - Upload configuration including data source and optional settings.
-   *
-   * @returns Metadata for the uploaded file version.
-   */
-  async upload(options) {
-    const recommendedPartSize = this.client.accountInfo.getRecommendedPartSize();
-    const isLarge = options.source.size > recommendedPartSize;
-    if (isLarge) {
-      return large.uploadLargeFile(this.client.raw, this.client.accountInfo, {
-        bucketId: this.bucket.id,
-        fileName: this.fileName,
-        ...options
-      });
-    }
-    const { resume: _resume, resumeFileId: _resumeFileId, ...smallOptions } = options;
-    return single.uploadSmallFile(this.client.raw, this.client.accountInfo, {
-      bucketId: this.bucket.id,
-      fileName: this.fileName,
-      ...smallOptions
-    });
-  }
-  /**
-   * Downloads this file by name. Pass `method: 'HEAD'` to fetch only the
-   * response headers (file metadata) without streaming the body.
-   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.
-   *
-   * @returns The download result with response headers and body stream.
-   */
-  async download(options) {
-    return single$1.downloadByName(this.client.raw, this.client.accountInfo, {
-      bucketName: this.bucket.name,
-      fileName: this.fileName,
-      ...options
-    });
-  }
-  /**
-   * Fetches response headers for this file via HTTP HEAD. Returns a
-   * body-less result so callers never have to drain the (logically
-   * empty) HEAD body themselves.
-   *
-   * @param options - Optional range, SSE-C decryption, response-header
-   *   overrides, and abort signal. Same shape as {@link B2Object.download}'s
-   *   options minus `method` (always HEAD) and `onProgress` (no body).
-   *
-   * @returns Parsed download headers (content type, SHA-1, file info, etc.).
-   */
-  async head(options) {
-    return single$1.headByName(this.client.raw, this.client.accountInfo, {
-      bucketName: this.bucket.name,
-      fileName: this.fileName,
-      ...options
-    });
-  }
-  /**
-   * Downloads a specific version of this file by ID. Pass `method: 'HEAD'`
-   * to fetch only the response headers (file metadata) without streaming the body.
-   * @param fileId - The file version ID to download.
-   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.
-   *
-   * @returns The download result with response headers and body stream.
-   */
-  async downloadById(fileId, options) {
-    return single$1.downloadById(this.client.raw, this.client.accountInfo, {
-      fileId,
-      ...options
-    });
-  }
-  /**
-   * Fetches response headers for a specific version of this file by ID
-   * via HTTP HEAD. Returns a body-less result so callers never have to
-   * drain the (logically empty) HEAD body themselves.
-   *
-   * @param fileId - The file version ID to inspect.
-   * @param options - Optional range, SSE-C decryption, response-header
-   *   overrides, and abort signal.
-   *
-   * @returns Parsed download headers.
-   */
-  async headById(fileId, options) {
-    return single$1.headById(this.client.raw, this.client.accountInfo, {
-      fileId,
-      ...options
-    });
-  }
-  /**
-   * Creates a parallel-download ReadableStream that fetches the file in concurrent ranged chunks.
-   * @param fileId - The file version ID to download.
-   * @param totalSize - Total file size in bytes (needed to compute range boundaries).
-   * @param options - Concurrency, range size, and abort signal.
-   *
-   * @returns A Web ReadableStream of file data in sequential order.
-   */
-  createReadStream(fileId, totalSize, options) {
-    return parallel.createParallelDownloadStream(this.client.raw, this.client.accountInfo, {
-      fileId,
-      totalSize,
-      ...options
-    });
-  }
-  /**
-   * Creates a Web `WritableStream` that uploads streamed data into this file
-   * using the multipart protocol. Pipe a `ReadableStream<Uint8Array>` into the
-   * returned `writable` and await `done` to get the final {@link FileVersion}.
-   *
-   * Note: streaming uploads do not support resume because the size and per-part
-   * hashes are not known in advance. Use {@link upload} with a buffered source
-   * when resume is required.
-   *
-   * @param options - Streaming upload parameters (part size, concurrency, encryption).
-   *
-   * @returns A handle with the writable sink and a completion promise.
-   */
-  createWriteStream(options) {
-    return stream.createWriteStream(this.client.raw, this.client.accountInfo, {
-      bucketId: this.bucket.id,
-      fileName: this.fileName,
-      ...options ?? {}
-    });
-  }
-  /**
-   * Retrieves metadata for a specific file version.
-   * @param fileId - The file version ID to look up.
-   *
-   * @returns The file version metadata.
-   */
-  async getFileInfo(fileId) {
-    return this.client.raw.getFileInfo(
-      this.client.accountInfo.getApiUrl(),
-      this.client.accountInfo.getAuthToken(),
-      { fileId }
-    );
-  }
-  /**
-   * Hides this file by creating a hide marker at this file name.
-   *
-   * @returns Metadata for the newly created hide marker.
-   */
-  async hide() {
-    return this.bucket.hideFile(this.fileName);
-  }
-  /**
-   * Permanently deletes a specific version of this file.
-   * @param fileId - The unique identifier of the file version to delete.
-   */
-  async deleteVersion(fileId) {
-    await this.bucket.deleteFileVersion(this.fileName, fileId);
-  }
-  /**
-   * Sets or updates the Object Lock retention policy on a specific file
-   * version of this file.
-   *
-   * The bucket must have Object Lock enabled (`fileLockEnabled: true` at
-   * creation time). Governance-mode retention can be shortened or removed
-   * by passing `bypassGovernance: true` together with an application key
-   * that carries the `bypassGovernance` capability; compliance-mode
-   * retention cannot be shortened by anyone until the
-   * `retainUntilTimestamp` elapses.
-   *
-   * @param fileId - The file version to apply the policy to.
-   * @param retention - The retention policy to apply.
-   * @param options - Optional flag for shortening governance-mode retention.
-   *
-   * @returns Metadata for the updated file version.
-   */
-  async setRetention(fileId, retention, options) {
-    return this.bucket.updateFileRetention(this.fileName, fileId, retention, options);
-  }
-  /**
-   * Toggles the legal hold flag on a specific file version of this file.
-   *
-   * Legal hold is independent of retention: a file can be on legal hold
-   * without any retention policy, and vice versa. The bucket must have
-   * Object Lock enabled, and any caller must hold the `writeFileLegalHolds`
-   * capability.
-   *
-   * @param fileId - The file version to apply the flag to.
-   * @param legalHold - `'on'` to apply the hold, `'off'` to remove it.
-   *
-   * @returns Metadata for the updated file version.
-   */
-  async setLegalHold(fileId, legalHold) {
-    return this.bucket.updateFileLegalHold(this.fileName, fileId, legalHold);
-  }
+const require_single = require("./download/single.cjs");
+const require_upload_retry_options = require("./internal/upload-retry-options.cjs");
+const require_parallel = require("./download/parallel.cjs");
+const require_large = require("./upload/large.cjs");
+const require_options = require("./upload/options.cjs");
+const require_single$1 = require("./upload/single.cjs");
+const require_stream = require("./upload/stream.cjs");
+//#region src/object.ts
+function bucketDefaultRetentionSnapshot(info) {
+	const fileLock = info.fileLockConfiguration;
+	if (!fileLock.isClientAuthorizedToRead) return { unreadable: true };
+	if (fileLock.value === null) return { unreadable: false };
+	return {
+		retention: fileLock.value.defaultRetention,
+		unreadable: false
+	};
 }
+function resumeNeedsFreshBucketDefaults(options) {
+	return (options.resume === true || options.resumeFileId !== void 0) && (options.serverSideEncryption === void 0 || options.fileRetention === void 0);
+}
+/**
+* Handle to a specific file (by name) within a B2 bucket.
+*
+* Provides file-scoped upload, download, and management operations.
+* Obtained via {@link Bucket.file}.
+*
+* @example
+* ```ts
+* const obj = bucket.file('photos/2026/sunset.jpg')
+* await obj.upload({ source: new BufferSource(data) })
+* const result = await obj.download()
+* ```
+*/
+var B2Object = class {
+	/** The file name (path) within the bucket. */
+	fileName;
+	client;
+	bucket;
+	uploadRetryOptions;
+	/**
+	* @param client - The parent B2Client instance.
+	* @param bucket - The parent Bucket this object belongs to.
+	* @param fileName - The file path within the bucket.
+	* @param uploadRetryOptions - Resolved client upload retry defaults.
+	*
+	* @internal
+	*/
+	constructor(client, bucket, fileName, uploadRetryOptions) {
+		this.client = client;
+		this.bucket = bucket;
+		this.fileName = fileName;
+		this.uploadRetryOptions = uploadRetryOptions;
+	}
+	/**
+	* Uploads data to this file name. Automatically uses multipart upload for large files.
+	* @param options - Upload configuration including data source and optional settings.
+	*
+	* @returns Metadata for the uploaded file version.
+	*/
+	async upload(options) {
+		const recommendedPartSize = this.client.accountInfo.getRecommendedPartSize();
+		const isLarge = options.source.size > recommendedPartSize;
+		const uploadRetryOptions = require_upload_retry_options.mergeUploadRetryOptions(this.uploadRetryOptions, options.retry);
+		if (isLarge) {
+			const bucketInfo = resumeNeedsFreshBucketDefaults(options) ? await this.fetchFreshBucketInfo() : this.bucket.info;
+			const bucketDefaultRetention = bucketDefaultRetentionSnapshot(bucketInfo);
+			return require_large.uploadLargeFile(this.client.raw, this.client.accountInfo, {
+				...options,
+				bucketId: this.bucket.id,
+				fileName: this.fileName,
+				retry: uploadRetryOptions,
+				bucketDefaultServerSideEncryption: bucketInfo.defaultServerSideEncryption,
+				...bucketDefaultRetention.retention !== void 0 ? { bucketDefaultRetention: bucketDefaultRetention.retention } : {},
+				...bucketDefaultRetention.unreadable ? { bucketDefaultRetentionUnreadable: true } : {}
+			});
+		}
+		require_options.rejectSmallResumeFileId(options, "B2Object.upload");
+		const smallOptions = require_options.stripResumeOnlyOptions(options);
+		return require_single$1.uploadSmallFile(this.client.raw, this.client.accountInfo, {
+			...smallOptions,
+			bucketId: this.bucket.id,
+			fileName: this.fileName,
+			retry: uploadRetryOptions
+		});
+	}
+	async fetchFreshBucketInfo() {
+		const found = (await this.client.listBuckets({ bucketId: this.bucket.id }))[0];
+		if (!found) throw new Error(`Bucket ${this.bucket.id} not found`);
+		return found.info;
+	}
+	/**
+	* Downloads this file by name. Pass `method: 'HEAD'` to fetch only the
+	* response headers (file metadata) without streaming the body.
+	* @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.
+	*
+	* @returns The download result with response headers and body stream.
+	*/
+	async download(options) {
+		return require_single.downloadByName(this.client.raw, this.client.accountInfo, {
+			bucketName: this.bucket.name,
+			fileName: this.fileName,
+			...options
+		});
+	}
+	/**
+	* Fetches response headers for this file via HTTP HEAD. Returns a
+	* body-less result so callers never have to drain the (logically
+	* empty) HEAD body themselves.
+	*
+	* @param options - Optional range, SSE-C decryption, response-header
+	*   overrides, and abort signal. Same shape as {@link B2Object.download}'s
+	*   options minus `method` (always HEAD) and `onProgress` (no body).
+	*
+	* @returns Parsed download headers (content type, SHA-1, file info, etc.).
+	*/
+	async head(options) {
+		return require_single.headByName(this.client.raw, this.client.accountInfo, {
+			bucketName: this.bucket.name,
+			fileName: this.fileName,
+			...options
+		});
+	}
+	/**
+	* Downloads a specific version of this file by ID. Pass `method: 'HEAD'`
+	* to fetch only the response headers (file metadata) without streaming the body.
+	* @param fileId - The file version ID to download.
+	* @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.
+	*
+	* @returns The download result with response headers and body stream.
+	*/
+	async downloadById(fileId, options) {
+		return require_single.downloadById(this.client.raw, this.client.accountInfo, {
+			fileId,
+			...options
+		});
+	}
+	/**
+	* Fetches response headers for a specific version of this file by ID
+	* via HTTP HEAD. Returns a body-less result so callers never have to
+	* drain the (logically empty) HEAD body themselves.
+	*
+	* @param fileId - The file version ID to inspect.
+	* @param options - Optional range, SSE-C decryption, response-header
+	*   overrides, and abort signal.
+	*
+	* @returns Parsed download headers.
+	*/
+	async headById(fileId, options) {
+		return require_single.headById(this.client.raw, this.client.accountInfo, {
+			fileId,
+			...options
+		});
+	}
+	/**
+	* Creates a parallel-download ReadableStream that fetches the file in concurrent ranged chunks.
+	* @param fileId - The file version ID to download.
+	* @param totalSize - Total file size in bytes (needed to compute range boundaries).
+	* @param options - Concurrency, range size, SSE-C decryption, and abort signal.
+	*
+	* @returns A Web ReadableStream of file data in sequential order.
+	*/
+	createReadStream(fileId, totalSize, options) {
+		return require_parallel.createParallelDownloadStream(this.client.raw, this.client.accountInfo, {
+			fileId,
+			totalSize,
+			...options
+		});
+	}
+	/**
+	* Creates a Web `WritableStream` that uploads streamed data into this file
+	* using the multipart protocol. Pipe a `ReadableStream<Uint8Array>` into the
+	* returned `writable` and await `done` to get the final {@link FileVersion}.
+	*
+	* Note: streaming uploads do not support resume because the size and per-part
+	* hashes are not known in advance. Use {@link upload} with a buffered source
+	* when resume is required.
+	*
+	* @param options - Streaming upload parameters (part size, concurrency, encryption).
+	*
+	* @returns A handle with the writable sink and a completion promise.
+	*/
+	createWriteStream(options) {
+		const uploadRetryOptions = require_upload_retry_options.mergeUploadRetryOptions(this.uploadRetryOptions, options?.retry);
+		return require_stream.createWriteStream(this.client.raw, this.client.accountInfo, {
+			...options ?? {},
+			bucketId: this.bucket.id,
+			fileName: this.fileName,
+			retry: uploadRetryOptions
+		});
+	}
+	/**
+	* Retrieves metadata for a specific file version.
+	* @param fileId - The file version ID to look up.
+	*
+	* @returns The file version metadata.
+	*/
+	async getFileInfo(fileId) {
+		return this.client.raw.getFileInfo(this.client.accountInfo.getApiUrl(), this.client.accountInfo.getAuthToken(), { fileId });
+	}
+	/**
+	* Hides this file by creating a hide marker at this file name.
+	*
+	* @returns Metadata for the newly created hide marker.
+	*/
+	async hide() {
+		return this.bucket.hideFile(this.fileName);
+	}
+	/**
+	* Permanently deletes a specific version of this file.
+	* @param fileId - The unique identifier of the file version to delete.
+	*/
+	async deleteVersion(fileId) {
+		await this.bucket.deleteFileVersion(this.fileName, fileId);
+	}
+	/**
+	* Sets or updates the Object Lock retention policy on a specific file
+	* version of this file.
+	*
+	* The bucket must have Object Lock enabled (`fileLockEnabled: true` at
+	* creation time). Governance-mode retention can be shortened or removed
+	* by passing `bypassGovernance: true` together with an application key
+	* that carries the `bypassGovernance` capability; compliance-mode
+	* retention cannot be shortened by anyone until the
+	* `retainUntilTimestamp` elapses.
+	*
+	* @param fileId - The file version to apply the policy to.
+	* @param retention - The retention policy to apply.
+	* @param options - Optional flag for shortening governance-mode retention.
+	*
+	* @returns Metadata for the updated file version.
+	*/
+	async setRetention(fileId, retention, options) {
+		return this.bucket.updateFileRetention(this.fileName, fileId, retention, options);
+	}
+	/**
+	* Toggles the legal hold flag on a specific file version of this file.
+	*
+	* Legal hold is independent of retention: a file can be on legal hold
+	* without any retention policy, and vice versa. The bucket must have
+	* Object Lock enabled, and any caller must hold the `writeFileLegalHolds`
+	* capability.
+	*
+	* @param fileId - The file version to apply the flag to.
+	* @param legalHold - `'on'` to apply the hold, `'off'` to remove it.
+	*
+	* @returns Metadata for the updated file version.
+	*/
+	async setLegalHold(fileId, legalHold) {
+		return this.bucket.updateFileLegalHold(this.fileName, fileId, legalHold);
+	}
+};
+//#endregion
 exports.B2Object = B2Object;
-//# sourceMappingURL=object.cjs.map
+
+//# sourceMappingURL=object.cjs.map

package/dist/object.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"object.cjs","sources":["../src/object.ts"],"sourcesContent":["import type { Bucket } from './bucket.ts'\nimport type { B2Client } from './client.ts'\nimport { createParallelDownloadStream } from './download/parallel.ts'\nimport { type DownloadResult, downloadByName } from './download/single.ts'\nimport { type HeadResult, downloadById, headById, headByName } from './download/single.ts'\nimport type { SseCDownloadKey } from './raw/index.ts'\nimport type { ProgressListener } from './streams/progress.ts'\nimport type { ContentSource } from './streams/source.ts'\nimport type { EncryptionSetting } from './types/encryption.ts'\nimport type { FileVersion } from './types/file.ts'\nimport type { FileId, LargeFileId } from './types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './types/lock.ts'\nimport { uploadLargeFile } from './upload/large.ts'\nimport { uploadSmallFile } from './upload/single.ts'\nimport { type UploadWriteHandle, createWriteStream } from './upload/stream.ts'\n\n/** Options accepted by {@link B2Object.download} and {@link B2Object.downloadById}. */\nexport interface DownloadCallOptions {\n  /**\n   * HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only\n   * response headers. Prefer the dedicated {@link B2Object.head} /\n   * {@link Bucket.head} method over this option — those return a\n   * body-less result so callers never have to remember to drain the\n   * empty body of a HEAD response.\n   */\n  readonly method?: 'GET' | 'HEAD'\n  /** HTTP Range header value (e.g., `\"bytes=0-999\"`). */\n  readonly range?: string\n  /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n  readonly serverSideEncryption?: SseCDownloadKey\n  /** Override the response `Content-Disposition` header. */\n  readonly b2ContentDisposition?: string\n  /** Override the response `Content-Language` header. */\n  readonly b2ContentLanguage?: string\n  /** Override the response `Content-Encoding` header. */\n  readonly b2ContentEncoding?: string\n  /** Override the response `Content-Type` header. */\n  readonly b2ContentType?: string\n  /** Override the response `Cache-Control` header. */\n  readonly b2CacheControl?: string\n  /** Override the response `Expires` header. */\n  readonly b2Expires?: string\n  /** Abort signal for cancelling the download. */\n  readonly signal?: AbortSignal\n  /**\n   * Callback invoked as the response body is consumed.\n   *\n   * Progress is byte-driven, not request-driven: the callback fires per\n   * chunk as the caller reads the returned `body` stream, and the final\n   * `partsCompleted: 1` event only fires once the stream is read to\n   * completion. Downloads that are dropped or aborted partway through\n   * will NOT emit a `completePart()` event.\n   */\n  readonly onProgress?: ProgressListener\n}\n\n/**\n * Options accepted by {@link B2Object.head} / {@link Bucket.head}.\n * Same shape as {@link DownloadCallOptions} minus `method` (always\n * HEAD) and `onProgress` (no body to track).\n */\nexport type HeadCallOptions = Omit<DownloadCallOptions, 'method' | 'onProgress'>\n\n/**\n * Handle to a specific file (by name) within a B2 bucket.\n *\n * Provides file-scoped upload, download, and management operations.\n * Obtained via {@link Bucket.file}.\n *\n * @example\n * ```ts\n * const obj = bucket.file('photos/2026/sunset.jpg')\n * await obj.upload({ source: new BufferSource(data) })\n * const result = await obj.download()\n * ```\n */\nexport class B2Object {\n  /** The file name (path) within the bucket. */\n  readonly fileName: string\n  private readonly client: B2Client\n  private readonly bucket: Bucket\n\n  /**\n   * @param client - The parent B2Client instance.\n   * @param bucket - The parent Bucket this object belongs to.\n   * @param fileName - The file path within the bucket.\n   *\n   * @internal\n   */\n  constructor(client: B2Client, bucket: Bucket, fileName: string) {\n    this.client = client\n    this.bucket = bucket\n    this.fileName = fileName\n  }\n\n  /**\n   * Uploads data to this file name. Automatically uses multipart upload for large files.\n   * @param options - Upload configuration including data source and optional settings.\n   *\n   * @returns Metadata for the uploaded file version.\n   */\n  async upload(options: {\n    /** Data source to upload. */\n    source: ContentSource\n    /** MIME type. Defaults to auto-detection by B2. */\n    contentType?: string\n    /** Custom key-value metadata stored with the file. */\n    fileInfo?: Record<string, string>\n    /** Server-side encryption settings. */\n    serverSideEncryption?: EncryptionSetting\n    /** File retention policy (requires file lock). */\n    fileRetention?: FileRetentionValue\n    /** Legal hold status. */\n    legalHold?: LegalHoldValue\n    /** Last-modified timestamp in milliseconds since epoch. */\n    lastModifiedMillis?: number\n    /** Part size override for multipart uploads, in bytes. */\n    partSize?: number\n    /** Number of concurrent part uploads for large files. */\n    concurrency?: number\n    /** Callback invoked with upload progress events. */\n    onProgress?: ProgressListener\n    /** Abort signal for cancelling the upload. */\n    signal?: AbortSignal\n    /**\n     * Resume an unfinished multipart upload for this file name when one\n     * exists. Only meaningful on the large-file path. Ignored on the\n     * small-file path.\n     */\n    resume?: boolean\n    /**\n     * Resume into a specific large-file ID, bypassing discovery.\n     * Overrides the `resume` discovery path.\n     */\n    resumeFileId?: LargeFileId\n  }): Promise<FileVersion> {\n    const recommendedPartSize = this.client.accountInfo.getRecommendedPartSize()\n    const isLarge = options.source.size > recommendedPartSize\n\n    if (isLarge) {\n      return uploadLargeFile(this.client.raw, this.client.accountInfo, {\n        bucketId: this.bucket.id,\n        fileName: this.fileName,\n        ...options,\n      })\n    }\n\n    // Small-file path doesn't accept resume options.\n    const { resume: _resume, resumeFileId: _resumeFileId, ...smallOptions } = options\n    return uploadSmallFile(this.client.raw, this.client.accountInfo, {\n      bucketId: this.bucket.id,\n      fileName: this.fileName,\n      ...smallOptions,\n    })\n  }\n\n  /**\n   * Downloads this file by name. Pass `method: 'HEAD'` to fetch only the\n   * response headers (file metadata) without streaming the body.\n   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.\n   *\n   * @returns The download result with response headers and body stream.\n   */\n  async download(options?: DownloadCallOptions): Promise<DownloadResult> {\n    return downloadByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.bucket.name,\n      fileName: this.fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Fetches response headers for this file via HTTP HEAD. Returns a\n   * body-less result so callers never have to drain the (logically\n   * empty) HEAD body themselves.\n   *\n   * @param options - Optional range, SSE-C decryption, response-header\n   *   overrides, and abort signal. Same shape as {@link B2Object.download}'s\n   *   options minus `method` (always HEAD) and `onProgress` (no body).\n   *\n   * @returns Parsed download headers (content type, SHA-1, file info, etc.).\n   */\n  async head(options?: HeadCallOptions): Promise<HeadResult> {\n    return headByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.bucket.name,\n      fileName: this.fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Downloads a specific version of this file by ID. Pass `method: 'HEAD'`\n   * to fetch only the response headers (file metadata) without streaming the body.\n   * @param fileId - The file version ID to download.\n   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.\n   *\n   * @returns The download result with response headers and body stream.\n   */\n  async downloadById(fileId: FileId, options?: DownloadCallOptions): Promise<DownloadResult> {\n    return downloadById(this.client.raw, this.client.accountInfo, {\n      fileId,\n      ...options,\n    })\n  }\n\n  /**\n   * Fetches response headers for a specific version of this file by ID\n   * via HTTP HEAD. Returns a body-less result so callers never have to\n   * drain the (logically empty) HEAD body themselves.\n   *\n   * @param fileId - The file version ID to inspect.\n   * @param options - Optional range, SSE-C decryption, response-header\n   *   overrides, and abort signal.\n   *\n   * @returns Parsed download headers.\n   */\n  async headById(fileId: FileId, options?: HeadCallOptions): Promise<HeadResult> {\n    return headById(this.client.raw, this.client.accountInfo, {\n      fileId,\n      ...options,\n    })\n  }\n\n  /**\n   * Creates a parallel-download ReadableStream that fetches the file in concurrent ranged chunks.\n   * @param fileId - The file version ID to download.\n   * @param totalSize - Total file size in bytes (needed to compute range boundaries).\n   * @param options - Concurrency, range size, and abort signal.\n   *\n   * @returns A Web ReadableStream of file data in sequential order.\n   */\n  createReadStream(\n    fileId: FileId,\n    totalSize: number,\n    options?: {\n      /** Size of each ranged GET request in bytes. Defaults to 8 MB. */\n      rangeSize?: number\n      /** Number of concurrent range requests. Defaults to 4. */\n      concurrency?: number\n      /** Abort signal for cancelling the download. */\n      signal?: AbortSignal\n    },\n  ): ReadableStream<Uint8Array> {\n    return createParallelDownloadStream(this.client.raw, this.client.accountInfo, {\n      fileId,\n      totalSize,\n      ...options,\n    })\n  }\n\n  /**\n   * Creates a Web `WritableStream` that uploads streamed data into this file\n   * using the multipart protocol. Pipe a `ReadableStream<Uint8Array>` into the\n   * returned `writable` and await `done` to get the final {@link FileVersion}.\n   *\n   * Note: streaming uploads do not support resume because the size and per-part\n   * hashes are not known in advance. Use {@link upload} with a buffered source\n   * when resume is required.\n   *\n   * @param options - Streaming upload parameters (part size, concurrency, encryption).\n   *\n   * @returns A handle with the writable sink and a completion promise.\n   */\n  createWriteStream(options?: {\n    /** MIME type. Defaults to `b2/x-auto`. */\n    contentType?: string\n    /** Custom key-value metadata stored with the file. */\n    fileInfo?: Record<string, string>\n    /** Server-side encryption applied to each part. */\n    serverSideEncryption?: EncryptionSetting\n    /** Target part size in bytes. Defaults to the account's recommended part size. */\n    partSize?: number\n    /** Maximum number of parts uploaded in parallel. Defaults to 4. */\n    concurrency?: number\n    /** Callback invoked with upload progress events. */\n    onProgress?: ProgressListener\n    /** Abort signal that cancels the upload and the unfinished large file. */\n    signal?: AbortSignal\n  }): UploadWriteHandle {\n    return createWriteStream(this.client.raw, this.client.accountInfo, {\n      bucketId: this.bucket.id,\n      fileName: this.fileName,\n      ...(options ?? {}),\n    })\n  }\n\n  /**\n   * Retrieves metadata for a specific file version.\n   * @param fileId - The file version ID to look up.\n   *\n   * @returns The file version metadata.\n   */\n  async getFileInfo(fileId: FileId): Promise<FileVersion> {\n    return this.client.raw.getFileInfo(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { fileId },\n    )\n  }\n\n  /**\n   * Hides this file by creating a hide marker at this file name.\n   *\n   * @returns Metadata for the newly created hide marker.\n   */\n  async hide(): Promise<FileVersion> {\n    return this.bucket.hideFile(this.fileName)\n  }\n\n  /**\n   * Permanently deletes a specific version of this file.\n   * @param fileId - The unique identifier of the file version to delete.\n   */\n  async deleteVersion(fileId: FileId): Promise<void> {\n    await this.bucket.deleteFileVersion(this.fileName, fileId)\n  }\n\n  /**\n   * Sets or updates the Object Lock retention policy on a specific file\n   * version of this file.\n   *\n   * The bucket must have Object Lock enabled (`fileLockEnabled: true` at\n   * creation time). Governance-mode retention can be shortened or removed\n   * by passing `bypassGovernance: true` together with an application key\n   * that carries the `bypassGovernance` capability; compliance-mode\n   * retention cannot be shortened by anyone until the\n   * `retainUntilTimestamp` elapses.\n   *\n   * @param fileId - The file version to apply the policy to.\n   * @param retention - The retention policy to apply.\n   * @param options - Optional flag for shortening governance-mode retention.\n   *\n   * @returns Metadata for the updated file version.\n   */\n  async setRetention(\n    fileId: FileId,\n    retention: FileRetentionValue,\n    options?: { bypassGovernance?: boolean },\n  ) {\n    return this.bucket.updateFileRetention(this.fileName, fileId, retention, options)\n  }\n\n  /**\n   * Toggles the legal hold flag on a specific file version of this file.\n   *\n   * Legal hold is independent of retention: a file can be on legal hold\n   * without any retention policy, and vice versa. The bucket must have\n   * Object Lock enabled, and any caller must hold the `writeFileLegalHolds`\n   * capability.\n   *\n   * @param fileId - The file version to apply the flag to.\n   * @param legalHold - `'on'` to apply the hold, `'off'` to remove it.\n   *\n   * @returns Metadata for the updated file version.\n   */\n  async setLegalHold(fileId: FileId, legalHold: LegalHoldValue) {\n    return this.bucket.updateFileLegalHold(this.fileName, fileId, legalHold)\n  }\n}\n"],"names":["uploadLargeFile","uploadSmallFile","downloadByName","headByName","downloadById","headById","createParallelDownloadStream","createWriteStream"],"mappings":"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"}
+{"version":3,"file":"object.cjs","names":[],"sources":["../src/object.ts"],"sourcesContent":["import type { Bucket } from './bucket.ts'\nimport type { B2Client } from './client.ts'\nimport { createParallelDownloadStream } from './download/parallel.ts'\nimport {\n  type DownloadResult,\n  downloadById,\n  downloadByName,\n  type HeadResult,\n  headById,\n  headByName,\n} from './download/single.ts'\nimport type { RetryOptions } from './http/retry.ts'\nimport { mergeUploadRetryOptions } from './internal/upload-retry-options.ts'\nimport type { SseCDownloadKey } from './raw/index.ts'\nimport type { ProgressListener } from './streams/progress.ts'\nimport type { BucketRetentionPolicy } from './types/bucket.ts'\nimport type { FileVersion } from './types/file.ts'\nimport type { FileId } from './types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './types/lock.ts'\nimport { uploadLargeFile } from './upload/large.ts'\nimport {\n  type B2ObjectUploadOptions,\n  type B2ObjectWriteStreamOptions,\n  rejectSmallResumeFileId,\n  stripResumeOnlyOptions,\n} from './upload/options.ts'\nimport { uploadSmallFile } from './upload/single.ts'\nimport { createWriteStream, type UploadWriteHandle } from './upload/stream.ts'\n\ninterface BucketDefaultRetentionSnapshot {\n  readonly retention?: BucketRetentionPolicy\n  readonly unreadable: boolean\n}\n\nfunction bucketDefaultRetentionSnapshot(info: Bucket['info']): BucketDefaultRetentionSnapshot {\n  const fileLock = info.fileLockConfiguration\n  if (!fileLock.isClientAuthorizedToRead) return { unreadable: true }\n  if (fileLock.value === null) return { unreadable: false }\n  return { retention: fileLock.value.defaultRetention, unreadable: false }\n}\n\nfunction resumeNeedsFreshBucketDefaults(options: B2ObjectUploadOptions): boolean {\n  const resumeRequested = options.resume === true || options.resumeFileId !== undefined\n  return (\n    resumeRequested &&\n    (options.serverSideEncryption === undefined || options.fileRetention === undefined)\n  )\n}\n\n/** Options accepted by {@link B2Object.download} and {@link B2Object.downloadById}. */\nexport interface DownloadCallOptions {\n  /**\n   * HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch only\n   * response headers. Prefer the dedicated {@link B2Object.head} /\n   * {@link Bucket.head} method over this option — those return a\n   * body-less result so callers never have to remember to drain the\n   * empty body of a HEAD response.\n   */\n  readonly method?: 'GET' | 'HEAD'\n  /** HTTP Range header value (e.g., `\"bytes=0-999\"`). */\n  readonly range?: string\n  /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n  readonly serverSideEncryption?: SseCDownloadKey\n  /** Override the response `Content-Disposition` header. */\n  readonly b2ContentDisposition?: string\n  /** Override the response `Content-Language` header. */\n  readonly b2ContentLanguage?: string\n  /** Override the response `Content-Encoding` header. */\n  readonly b2ContentEncoding?: string\n  /** Override the response `Content-Type` header. */\n  readonly b2ContentType?: string\n  /** Override the response `Cache-Control` header. */\n  readonly b2CacheControl?: string\n  /** Override the response `Expires` header. */\n  readonly b2Expires?: string\n  /** Abort signal for cancelling the download. */\n  readonly signal?: AbortSignal\n  /**\n   * Callback invoked as the response body is consumed.\n   *\n   * Progress is byte-driven, not request-driven: the callback fires per\n   * chunk as the caller reads the returned `body` stream, and the final\n   * `partsCompleted: 1` event only fires once the stream is read to\n   * completion. Downloads that are dropped or aborted partway through\n   * will NOT emit a `completePart()` event.\n   */\n  readonly onProgress?: ProgressListener\n}\n\n/**\n * Options accepted by {@link B2Object.head} / {@link Bucket.head}.\n * Same shape as {@link DownloadCallOptions} minus `method` (always\n * HEAD) and `onProgress` (no body to track).\n */\nexport type HeadCallOptions = Omit<DownloadCallOptions, 'method' | 'onProgress'>\n\n/**\n * Handle to a specific file (by name) within a B2 bucket.\n *\n * Provides file-scoped upload, download, and management operations.\n * Obtained via {@link Bucket.file}.\n *\n * @example\n * ```ts\n * const obj = bucket.file('photos/2026/sunset.jpg')\n * await obj.upload({ source: new BufferSource(data) })\n * const result = await obj.download()\n * ```\n */\nexport class B2Object {\n  /** The file name (path) within the bucket. */\n  readonly fileName: string\n  private readonly client: B2Client\n  private readonly bucket: Bucket\n  private readonly uploadRetryOptions: RetryOptions\n\n  /**\n   * @param client - The parent B2Client instance.\n   * @param bucket - The parent Bucket this object belongs to.\n   * @param fileName - The file path within the bucket.\n   * @param uploadRetryOptions - Resolved client upload retry defaults.\n   *\n   * @internal\n   */\n  constructor(\n    client: B2Client,\n    bucket: Bucket,\n    fileName: string,\n    uploadRetryOptions: RetryOptions,\n  ) {\n    this.client = client\n    this.bucket = bucket\n    this.fileName = fileName\n    this.uploadRetryOptions = uploadRetryOptions\n  }\n\n  /**\n   * Uploads data to this file name. Automatically uses multipart upload for large files.\n   * @param options - Upload configuration including data source and optional settings.\n   *\n   * @returns Metadata for the uploaded file version.\n   */\n  async upload(options: B2ObjectUploadOptions): Promise<FileVersion> {\n    const recommendedPartSize = this.client.accountInfo.getRecommendedPartSize()\n    const isLarge = options.source.size > recommendedPartSize\n    const uploadRetryOptions = mergeUploadRetryOptions(this.uploadRetryOptions, options.retry)\n\n    if (isLarge) {\n      const bucketInfo = resumeNeedsFreshBucketDefaults(options)\n        ? await this.fetchFreshBucketInfo()\n        : this.bucket.info\n      const bucketDefaultRetention = bucketDefaultRetentionSnapshot(bucketInfo)\n      return uploadLargeFile(this.client.raw, this.client.accountInfo, {\n        ...options,\n        bucketId: this.bucket.id,\n        fileName: this.fileName,\n        retry: uploadRetryOptions,\n        bucketDefaultServerSideEncryption: bucketInfo.defaultServerSideEncryption,\n        ...(bucketDefaultRetention.retention !== undefined\n          ? { bucketDefaultRetention: bucketDefaultRetention.retention }\n          : {}),\n        ...(bucketDefaultRetention.unreadable ? { bucketDefaultRetentionUnreadable: true } : {}),\n      })\n    }\n    rejectSmallResumeFileId(options, 'B2Object.upload')\n    const smallOptions = stripResumeOnlyOptions(options)\n    return uploadSmallFile(this.client.raw, this.client.accountInfo, {\n      ...smallOptions,\n      bucketId: this.bucket.id,\n      fileName: this.fileName,\n      retry: uploadRetryOptions,\n    })\n  }\n\n  private async fetchFreshBucketInfo(): Promise<Bucket['info']> {\n    const fresh = await this.client.listBuckets({ bucketId: this.bucket.id })\n    const found = fresh[0]\n    if (!found) throw new Error(`Bucket ${this.bucket.id} not found`)\n    return found.info\n  }\n\n  /**\n   * Downloads this file by name. Pass `method: 'HEAD'` to fetch only the\n   * response headers (file metadata) without streaming the body.\n   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.\n   *\n   * @returns The download result with response headers and body stream.\n   */\n  async download(options?: DownloadCallOptions): Promise<DownloadResult> {\n    return downloadByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.bucket.name,\n      fileName: this.fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Fetches response headers for this file via HTTP HEAD. Returns a\n   * body-less result so callers never have to drain the (logically\n   * empty) HEAD body themselves.\n   *\n   * @param options - Optional range, SSE-C decryption, response-header\n   *   overrides, and abort signal. Same shape as {@link B2Object.download}'s\n   *   options minus `method` (always HEAD) and `onProgress` (no body).\n   *\n   * @returns Parsed download headers (content type, SHA-1, file info, etc.).\n   */\n  async head(options?: HeadCallOptions): Promise<HeadResult> {\n    return headByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.bucket.name,\n      fileName: this.fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Downloads a specific version of this file by ID. Pass `method: 'HEAD'`\n   * to fetch only the response headers (file metadata) without streaming the body.\n   * @param fileId - The file version ID to download.\n   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.\n   *\n   * @returns The download result with response headers and body stream.\n   */\n  async downloadById(fileId: FileId, options?: DownloadCallOptions): Promise<DownloadResult> {\n    return downloadById(this.client.raw, this.client.accountInfo, {\n      fileId,\n      ...options,\n    })\n  }\n\n  /**\n   * Fetches response headers for a specific version of this file by ID\n   * via HTTP HEAD. Returns a body-less result so callers never have to\n   * drain the (logically empty) HEAD body themselves.\n   *\n   * @param fileId - The file version ID to inspect.\n   * @param options - Optional range, SSE-C decryption, response-header\n   *   overrides, and abort signal.\n   *\n   * @returns Parsed download headers.\n   */\n  async headById(fileId: FileId, options?: HeadCallOptions): Promise<HeadResult> {\n    return headById(this.client.raw, this.client.accountInfo, {\n      fileId,\n      ...options,\n    })\n  }\n\n  /**\n   * Creates a parallel-download ReadableStream that fetches the file in concurrent ranged chunks.\n   * @param fileId - The file version ID to download.\n   * @param totalSize - Total file size in bytes (needed to compute range boundaries).\n   * @param options - Concurrency, range size, SSE-C decryption, and abort signal.\n   *\n   * @returns A Web ReadableStream of file data in sequential order.\n   */\n  createReadStream(\n    fileId: FileId,\n    totalSize: number,\n    options?: {\n      /** Size of each ranged GET request in bytes. Defaults to 10 MB. */\n      rangeSize?: number\n      /** Number of concurrent range requests. Defaults to 4. */\n      concurrency?: number\n      /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n      serverSideEncryption?: SseCDownloadKey\n      /** Abort signal for cancelling the download. */\n      signal?: AbortSignal\n    },\n  ): ReadableStream<Uint8Array> {\n    return createParallelDownloadStream(this.client.raw, this.client.accountInfo, {\n      fileId,\n      totalSize,\n      ...options,\n    })\n  }\n\n  /**\n   * Creates a Web `WritableStream` that uploads streamed data into this file\n   * using the multipart protocol. Pipe a `ReadableStream<Uint8Array>` into the\n   * returned `writable` and await `done` to get the final {@link FileVersion}.\n   *\n   * Note: streaming uploads do not support resume because the size and per-part\n   * hashes are not known in advance. Use {@link upload} with a buffered source\n   * when resume is required.\n   *\n   * @param options - Streaming upload parameters (part size, concurrency, encryption).\n   *\n   * @returns A handle with the writable sink and a completion promise.\n   */\n  createWriteStream(options?: B2ObjectWriteStreamOptions): UploadWriteHandle {\n    const uploadRetryOptions = mergeUploadRetryOptions(this.uploadRetryOptions, options?.retry)\n    return createWriteStream(this.client.raw, this.client.accountInfo, {\n      ...(options ?? {}),\n      bucketId: this.bucket.id,\n      fileName: this.fileName,\n      retry: uploadRetryOptions,\n    })\n  }\n\n  /**\n   * Retrieves metadata for a specific file version.\n   * @param fileId - The file version ID to look up.\n   *\n   * @returns The file version metadata.\n   */\n  async getFileInfo(fileId: FileId): Promise<FileVersion> {\n    return this.client.raw.getFileInfo(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { fileId },\n    )\n  }\n\n  /**\n   * Hides this file by creating a hide marker at this file name.\n   *\n   * @returns Metadata for the newly created hide marker.\n   */\n  async hide(): Promise<FileVersion> {\n    return this.bucket.hideFile(this.fileName)\n  }\n\n  /**\n   * Permanently deletes a specific version of this file.\n   * @param fileId - The unique identifier of the file version to delete.\n   */\n  async deleteVersion(fileId: FileId): Promise<void> {\n    await this.bucket.deleteFileVersion(this.fileName, fileId)\n  }\n\n  /**\n   * Sets or updates the Object Lock retention policy on a specific file\n   * version of this file.\n   *\n   * The bucket must have Object Lock enabled (`fileLockEnabled: true` at\n   * creation time). Governance-mode retention can be shortened or removed\n   * by passing `bypassGovernance: true` together with an application key\n   * that carries the `bypassGovernance` capability; compliance-mode\n   * retention cannot be shortened by anyone until the\n   * `retainUntilTimestamp` elapses.\n   *\n   * @param fileId - The file version to apply the policy to.\n   * @param retention - The retention policy to apply.\n   * @param options - Optional flag for shortening governance-mode retention.\n   *\n   * @returns Metadata for the updated file version.\n   */\n  async setRetention(\n    fileId: FileId,\n    retention: FileRetentionValue,\n    options?: { bypassGovernance?: boolean },\n  ) {\n    return this.bucket.updateFileRetention(this.fileName, fileId, retention, options)\n  }\n\n  /**\n   * Toggles the legal hold flag on a specific file version of this file.\n   *\n   * Legal hold is independent of retention: a file can be on legal hold\n   * without any retention policy, and vice versa. The bucket must have\n   * Object Lock enabled, and any caller must hold the `writeFileLegalHolds`\n   * capability.\n   *\n   * @param fileId - The file version to apply the flag to.\n   * @param legalHold - `'on'` to apply the hold, `'off'` to remove it.\n   *\n   * @returns Metadata for the updated file version.\n   */\n  async setLegalHold(fileId: FileId, legalHold: LegalHoldValue) {\n    return this.bucket.updateFileLegalHold(this.fileName, fileId, legalHold)\n  }\n}\n"],"mappings":"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"}

package/dist/object.d.cts

@@ -1,13 +1,13 @@
 import { Bucket } from './bucket.js';
 import { B2Client } from './client.js';
 import { DownloadResult, HeadResult } from './download/single.js';
+import { RetryOptions } from './http/retry.js';
 import { SseCDownloadKey } from './raw/index.js';
 import { ProgressListener } from './streams/progress.js';
-import { ContentSource } from './streams/source.js';
-import { EncryptionSetting } from './types/encryption.js';
 import { FileVersion } from './types/file.js';
-import { FileId, LargeFileId } from './types/ids.js';
+import { FileId } from './types/ids.js';
 import { FileRetentionValue, LegalHoldValue } from './types/lock.js';
+import { B2ObjectUploadOptions, B2ObjectWriteStreamOptions } from './upload/options.js';
 import { UploadWriteHandle } from './upload/stream.js';
 /** Options accepted by {@link B2Object.download} and {@link B2Object.downloadById}. */
 export interface DownloadCallOptions {
@@ -72,55 +72,24 @@ export declare class B2Object {
     readonly fileName: string;
     private readonly client;
     private readonly bucket;
+    private readonly uploadRetryOptions;
     /**
      * @param client - The parent B2Client instance.
      * @param bucket - The parent Bucket this object belongs to.
      * @param fileName - The file path within the bucket.
+     * @param uploadRetryOptions - Resolved client upload retry defaults.
      *
      * @internal
      */
-    constructor(client: B2Client, bucket: Bucket, fileName: string);
+    constructor(client: B2Client, bucket: Bucket, fileName: string, uploadRetryOptions: RetryOptions);
     /**
      * Uploads data to this file name. Automatically uses multipart upload for large files.
      * @param options - Upload configuration including data source and optional settings.
      *
      * @returns Metadata for the uploaded file version.
      */
-    upload(options: {
-        /** Data source to upload. */
-        source: ContentSource;
-        /** MIME type. Defaults to auto-detection by B2. */
-        contentType?: string;
-        /** Custom key-value metadata stored with the file. */
-        fileInfo?: Record<string, string>;
-        /** Server-side encryption settings. */
-        serverSideEncryption?: EncryptionSetting;
-        /** File retention policy (requires file lock). */
-        fileRetention?: FileRetentionValue;
-        /** Legal hold status. */
-        legalHold?: LegalHoldValue;
-        /** Last-modified timestamp in milliseconds since epoch. */
-        lastModifiedMillis?: number;
-        /** Part size override for multipart uploads, in bytes. */
-        partSize?: number;
-        /** Number of concurrent part uploads for large files. */
-        concurrency?: number;
-        /** Callback invoked with upload progress events. */
-        onProgress?: ProgressListener;
-        /** Abort signal for cancelling the upload. */
-        signal?: AbortSignal;
-        /**
-         * Resume an unfinished multipart upload for this file name when one
-         * exists. Only meaningful on the large-file path. Ignored on the
-         * small-file path.
-         */
-        resume?: boolean;
-        /**
-         * Resume into a specific large-file ID, bypassing discovery.
-         * Overrides the `resume` discovery path.
-         */
-        resumeFileId?: LargeFileId;
-    }): Promise<FileVersion>;
+    upload(options: B2ObjectUploadOptions): Promise<FileVersion>;
+    private fetchFreshBucketInfo;
     /**
      * Downloads this file by name. Pass `method: 'HEAD'` to fetch only the
      * response headers (file metadata) without streaming the body.
@@ -166,15 +135,17 @@ export declare class B2Object {
      * Creates a parallel-download ReadableStream that fetches the file in concurrent ranged chunks.
      * @param fileId - The file version ID to download.
      * @param totalSize - Total file size in bytes (needed to compute range boundaries).
-     * @param options - Concurrency, range size, and abort signal.
+     * @param options - Concurrency, range size, SSE-C decryption, and abort signal.
      *
      * @returns A Web ReadableStream of file data in sequential order.
      */
     createReadStream(fileId: FileId, totalSize: number, options?: {
-        /** Size of each ranged GET request in bytes. Defaults to 8 MB. */
+        /** Size of each ranged GET request in bytes. Defaults to 10 MB. */
         rangeSize?: number;
         /** Number of concurrent range requests. Defaults to 4. */
         concurrency?: number;
+        /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */
+        serverSideEncryption?: SseCDownloadKey;
         /** Abort signal for cancelling the download. */
         signal?: AbortSignal;
     }): ReadableStream<Uint8Array>;
@@ -191,22 +162,7 @@ export declare class B2Object {
      *
      * @returns A handle with the writable sink and a completion promise.
      */
-    createWriteStream(options?: {
-        /** MIME type. Defaults to `b2/x-auto`. */
-        contentType?: string;
-        /** Custom key-value metadata stored with the file. */
-        fileInfo?: Record<string, string>;
-        /** Server-side encryption applied to each part. */
-        serverSideEncryption?: EncryptionSetting;
-        /** Target part size in bytes. Defaults to the account's recommended part size. */
-        partSize?: number;
-        /** Maximum number of parts uploaded in parallel. Defaults to 4. */
-        concurrency?: number;
-        /** Callback invoked with upload progress events. */
-        onProgress?: ProgressListener;
-        /** Abort signal that cancels the upload and the unfinished large file. */
-        signal?: AbortSignal;
-    }): UploadWriteHandle;
+    createWriteStream(options?: B2ObjectWriteStreamOptions): UploadWriteHandle;
     /**
      * Retrieves metadata for a specific file version.
      * @param fileId - The file version ID to look up.