@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/bucket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bucket.cjs","sources":["../src/bucket.ts"],"sourcesContent":["import type { B2Client } from './client.ts'\nimport { copyLargeFile } from './copy/large.ts'\nimport {\n  type DownloadResult,\n  type HeadResult,\n  downloadByName,\n  headByName,\n} from './download/single.ts'\nimport { B2Object, type DownloadCallOptions, type HeadCallOptions } from './object.ts'\nimport type { ProgressListener } from './streams/progress.ts'\nimport type { ContentSource } from './streams/source.ts'\nimport type {\n  BucketInfo,\n  BucketRetentionPolicy,\n  BucketType,\n  CorsRule,\n  LifecycleRule,\n} from './types/bucket.ts'\nimport type { DownloadAuthorizationResponse } from './types/download.ts'\nimport type { EncryptionSetting } from './types/encryption.ts'\nimport type {\n  FileVersion,\n  ListFileNamesResponse,\n  ListFileVersionsResponse,\n  MetadataDirective,\n} from './types/file.ts'\nimport type { ApplicationKeyId, BucketId, FileId, LargeFileId } from './types/ids.ts'\nimport { accountId } from './types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './types/lock.ts'\nimport type {\n  EventNotificationRule,\n  GetBucketNotificationRulesResponse,\n} from './types/notifications.ts'\nimport type { ReplicationConfiguration, ReplicationRule } from './types/replication.ts'\nimport type { CancelLargeFileResponse, PartInfo, UnfinishedLargeFile } from './types/upload.ts'\nimport { Semaphore } from './upload/concurrency.ts'\nimport { uploadLargeFile } from './upload/large.ts'\nimport { uploadSmallFile } from './upload/single.ts'\nimport { DEFAULT_BULK_CONCURRENCY, DEFAULT_PAGE_SIZE } from './util/defaults.ts'\nimport { type PaginatorOptions, paginateItems } from './util/paginator.ts'\nimport { toError } from './util/to-error.ts'\n\n/** A target for bulk deletion: a file name and its specific version ID. */\nexport interface DeleteTarget {\n  /** File name (path) of the version to delete. */\n  readonly fileName: string\n  /** Unique identifier of the file version. */\n  readonly fileId: FileId\n}\n\n/** Per-target error encountered during bulk deletion. */\nexport interface DeleteError {\n  /** The target that failed. */\n  readonly target: DeleteTarget\n  /** The error thrown by the underlying `deleteFileVersion` call. */\n  readonly error: Error\n}\n\n/** Aggregate result of a {@link Bucket.deleteMany} run. */\nexport interface DeleteManyResult {\n  /** Number of file versions successfully deleted. */\n  readonly deleted: number\n  /** Per-target failures. Empty on full success. */\n  readonly errors: readonly DeleteError[]\n}\n\n/** Emitted by {@link Bucket.deleteAll} once a file version has been successfully deleted. */\nexport interface DeleteAllDeleteEvent {\n  /** Discriminant identifying a successful delete. */\n  readonly type: 'delete'\n  /** File name of the deleted version. */\n  readonly fileName: string\n  /** Unique identifier of the deleted version. */\n  readonly fileId: FileId\n}\n\n/** Emitted by {@link Bucket.deleteAll} when a single delete call fails (other versions keep streaming). */\nexport interface DeleteAllErrorEvent {\n  /** Discriminant identifying a per-version delete failure. */\n  readonly type: 'error'\n  /** File name of the version that failed to delete. */\n  readonly fileName: string\n  /** Unique identifier of the version that failed to delete. */\n  readonly fileId: FileId\n  /** Human-readable failure reason taken from the underlying error. */\n  readonly message: string\n}\n\n/** Emitted by {@link Bucket.deleteAll} in `dryRun` mode for every version that would have been deleted. */\nexport interface DeleteAllSkipEvent {\n  /** Discriminant identifying a dry-run skip. */\n  readonly type: 'skip'\n  /** File name of the version that would have been deleted. */\n  readonly fileName: string\n  /** Unique identifier of the version that would have been deleted. */\n  readonly fileId: FileId\n}\n\n/** Event yielded by {@link Bucket.deleteAll} as it streams through file versions. */\nexport type DeleteAllEvent = DeleteAllDeleteEvent | DeleteAllErrorEvent | DeleteAllSkipEvent\n\n/**\n * Handle to a B2 bucket providing upload, download, listing, and management operations.\n *\n * Obtained via {@link B2Client.createBucket}, {@link B2Client.listBuckets}, or {@link B2Client.getBucket}.\n *\n * @example\n * ```ts\n * const bucket = await client.getBucket('my-bucket')\n * await bucket.upload({ fileName: 'hello.txt', source: new BufferSource(data) })\n * ```\n */\nexport class Bucket {\n  /** Unique identifier for this bucket. */\n  readonly id: BucketId\n  /** Human-readable bucket name. */\n  readonly name: string\n  /** Full bucket metadata as returned by the B2 API. */\n  readonly info: BucketInfo\n  private readonly client: B2Client\n\n  /**\n   * @param client - The parent B2Client instance.\n   * @param info - The bucket metadata from the API.\n   *\n   * @internal\n   */\n  constructor(client: B2Client, info: BucketInfo) {\n    this.client = client\n    this.info = info\n    this.id = info.bucketId\n    this.name = info.bucketName\n  }\n\n  /**\n   * Returns a {@link B2Object} handle for a specific file name in this bucket.\n   * @param fileName - The file path within the bucket.\n   *\n   * @returns A B2Object handle bound to this bucket and file name.\n   */\n  file(fileName: string): B2Object {\n    return new B2Object(this.client, this, fileName)\n  }\n\n  /**\n   * Uploads a file to this bucket. Automatically uses multipart upload for files\n   * larger than the recommended part size.\n   * @param options - Upload configuration including file name, source data, and optional settings.\n   *\n   * @returns Metadata for the uploaded file version.\n   */\n  async upload(options: {\n    /** Destination file name (path) in the bucket. */\n    fileName: string\n    /** Data source to upload. Use {@link BufferSource}, {@link BlobSource}, or {@link StreamSource}. */\n    source: ContentSource\n    /** MIME type. Defaults to `\"b2/x-auto\"` (auto-detected 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 on the bucket). */\n    fileRetention?: FileRetentionValue\n    /** Legal hold status for the file. */\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 consulted on the large-file path (source size\n     * greater than `recommendedPartSize`). On the small-file path this\n     * option is silently ignored. Sliceable sources only — `StreamSource`\n     * rejects resume because it can't replay parts.\n     */\n    resume?: boolean\n    /**\n     * Resume into a specific large-file ID. Overrides the `resume`\n     * discovery path. The local `partSize` must match the server-side\n     * plan.\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.id,\n        ...options,\n      })\n    }\n\n    // Strip resume / resumeFileId from the small-file path: the\n    // signature there doesn't accept them, and they're meaningless for\n    // single-request uploads.\n    const { resume: _resume, resumeFileId: _resumeFileId, ...smallOptions } = options\n    return uploadSmallFile(this.client.raw, this.client.accountInfo, {\n      bucketId: this.id,\n      ...smallOptions,\n    })\n  }\n\n  /**\n   * Downloads a file from this bucket by name. Pass `method: 'HEAD'` in\n   * `options` to fetch only the response headers (file metadata) without\n   * streaming the body.\n   * @param fileName - The file name (path) to download.\n   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.\n   *\n   * @returns The download result containing response headers and a readable body stream.\n   */\n  async download(fileName: string, options?: DownloadCallOptions): Promise<DownloadResult> {\n    return downloadByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.name,\n      fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Fetches the response headers (file metadata) for a file via HTTP\n   * HEAD. Returns a body-less result so callers never have to drain\n   * the (logically empty) HEAD body themselves.\n   *\n   * Use this for metadata-only checks like \"does this file exist\", \"what\n   * is its current SHA-1\", \"what is its Content-Length\". For full file\n   * retrieval use {@link Bucket.download}.\n   *\n   * @param fileName - The file name (path) to inspect.\n   * @param options - Optional range, SSE-C decryption, response-header\n   *   overrides, and abort signal. Same shape as {@link Bucket.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   * @example\n   * ```ts\n   * const { headers } = await bucket.head('photos/2026/sunset.jpg')\n   * console.log(headers.contentLength, headers.contentSha1)\n   * ```\n   */\n  async head(fileName: string, options?: HeadCallOptions): Promise<HeadResult> {\n    return headByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.name,\n      fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Lists file names in this bucket (most recent versions only).\n   * @param options - Optional filtering and pagination settings.\n   *\n   * @returns A page of file versions with an optional continuation token.\n   */\n  async listFileNames(options?: {\n    /** Start listing after this file name (for pagination). */\n    startFileName?: string\n    /**\n     * Maximum number of files to return per request (1-10000).\n     * Forwarded to the raw API's `maxFileCount` parameter.\n     */\n    pageSize?: number\n    /** Only list files with names starting with this prefix. */\n    prefix?: string\n    /** Delimiter for virtual directory grouping (typically `\"/\"`). */\n    delimiter?: string\n  }): Promise<ListFileNamesResponse> {\n    return this.client.raw.listFileNames(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        bucketId: this.id,\n        ...(options?.startFileName !== undefined ? { startFileName: options.startFileName } : {}),\n        ...(options?.pageSize !== undefined ? { maxFileCount: options.pageSize } : {}),\n        ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n        ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n      },\n    )\n  }\n\n  /**\n   * Lists all file versions in this bucket, including hidden files.\n   * @param options - Optional filtering and pagination settings.\n   *\n   * @returns A page of file versions with an optional continuation token.\n   */\n  async listFileVersions(options?: {\n    /** Start listing after this file name (for pagination). */\n    startFileName?: string\n    /** Start listing after this file ID (for pagination within a file name). */\n    startFileId?: FileId\n    /**\n     * Maximum number of file versions to return per request (1-10000).\n     * Forwarded to the raw API's `maxFileCount` parameter.\n     */\n    pageSize?: number\n    /** Only list files with names starting with this prefix. */\n    prefix?: string\n    /** Delimiter for virtual directory grouping. */\n    delimiter?: string\n  }): Promise<ListFileVersionsResponse> {\n    return this.client.raw.listFileVersions(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        bucketId: this.id,\n        ...(options?.startFileName !== undefined ? { startFileName: options.startFileName } : {}),\n        ...(options?.startFileId !== undefined ? { startFileId: options.startFileId } : {}),\n        ...(options?.pageSize !== undefined ? { maxFileCount: options.pageSize } : {}),\n        ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n        ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n      },\n    )\n  }\n\n  /**\n   * Async iterator that yields the latest visible version of every file in\n   * the bucket, automatically handling pagination via `listFileNames`.\n   *\n   * Hidden files (those whose latest version is a hide marker) are NOT\n   * yielded by this iterator. Use {@link paginateFileVersions} when you\n   * need full version history.\n   *\n   * @param options - Filter + pagination + abort options. `pageSize` is\n   *   forwarded to `b2_list_file_names`'s `maxFileCount` (default 1000,\n   *   B2-capped at 10000).\n   *\n   * @returns An async iterable of {@link FileVersion} entries.\n   *\n   * @example\n   * ```ts\n   * for await (const file of bucket.paginateFileNames({ prefix: 'photos/' })) {\n   *   console.log(file.fileName, file.contentLength)\n   * }\n   * ```\n   */\n  paginateFileNames(\n    options?: {\n      /** Only yield files whose names start with this prefix. */\n      prefix?: string\n      /** Delimiter for virtual directory grouping (typically `'/'`). */\n      delimiter?: string\n    } & PaginatorOptions,\n  ): AsyncIterableIterator<FileVersion> {\n    return paginateItems(\n      async (cursor: string | undefined) => {\n        const resp = await this.listFileNames({\n          pageSize: options?.pageSize ?? DEFAULT_PAGE_SIZE,\n          ...(cursor !== undefined ? { startFileName: cursor } : {}),\n          ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n          ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n        })\n        return { page: resp, nextCursor: resp.nextFileName ?? undefined }\n      },\n      // Real B2 surfaces hide markers as rows in `b2_list_file_names`. This\n      // iterator's documented contract is \"latest VISIBLE version\", so we\n      // drop hide-action rows here. Callers who need full history should\n      // use `paginateFileVersions`.\n      (page) => page.files.filter((f) => f.action !== 'hide'),\n      options?.signal,\n    )\n  }\n\n  /**\n   * Async iterator that yields every version of every file in the bucket,\n   * including hidden files and historical versions, automatically handling\n   * pagination via `listFileVersions`.\n   *\n   * The two-cursor `(nextFileName, nextFileId)` continuation that the raw\n   * endpoint exposes is threaded internally; callers iterate flat.\n   *\n   * @param options - Filter + pagination + abort options.\n   *\n   * @returns An async iterable of {@link FileVersion} entries.\n   */\n  paginateFileVersions(\n    options?: {\n      /** Only yield versions whose names start with this prefix. */\n      prefix?: string\n      /** Delimiter for virtual directory grouping. */\n      delimiter?: string\n    } & PaginatorOptions,\n  ): AsyncIterableIterator<FileVersion> {\n    type Cursor = { fileName: string; fileId: FileId | undefined }\n    return paginateItems(\n      async (cursor: Cursor | undefined) => {\n        const resp = await this.listFileVersions({\n          pageSize: options?.pageSize ?? DEFAULT_PAGE_SIZE,\n          ...(cursor !== undefined ? { startFileName: cursor.fileName } : {}),\n          ...(cursor?.fileId !== undefined ? { startFileId: cursor.fileId } : {}),\n          ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n          ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n        })\n        const nextCursor: Cursor | undefined =\n          resp.nextFileName !== null\n            ? { fileName: resp.nextFileName, fileId: resp.nextFileId ?? undefined }\n            : undefined\n        return { page: resp, nextCursor }\n      },\n      (page) => page.files,\n      options?.signal,\n    )\n  }\n\n  /**\n   * Async iterator that yields every unfinished large file in the bucket,\n   * automatically handling pagination via `listUnfinishedLargeFiles`.\n   *\n   * Useful for janitorial scripts that want to inspect or cancel abandoned\n   * multipart uploads (typically followed by {@link cancelLargeFile} on\n   * the underlying raw client).\n   *\n   * @param options - Filter + pagination + abort options. `pageSize` is\n   *   B2-capped at 100 for this endpoint.\n   *\n   * @returns An async iterable of unfinished-large-file metadata entries.\n   */\n  paginateUnfinishedLargeFiles(\n    options?: {\n      /** Only yield large files whose names start with this prefix. */\n      namePrefix?: string\n    } & PaginatorOptions,\n  ): AsyncIterableIterator<UnfinishedLargeFile> {\n    return paginateItems(\n      async (cursor: LargeFileId | undefined) => {\n        const resp = await this.listUnfinishedLargeFiles({\n          pageSize: options?.pageSize ?? 100,\n          ...(cursor !== undefined ? { startFileId: cursor } : {}),\n          ...(options?.namePrefix !== undefined ? { namePrefix: options.namePrefix } : {}),\n        })\n        return { page: resp, nextCursor: resp.nextFileId ?? undefined }\n      },\n      (page) => page.files,\n      options?.signal,\n    )\n  }\n\n  /**\n   * Async iterator that yields every uploaded part for a specific large\n   * file, automatically handling pagination via `listParts`.\n   *\n   * @param largeFileId - The unfinished large file to enumerate parts of.\n   * @param options - Pagination + abort options. `pageSize` is B2-capped\n   *   at 1000 for this endpoint; the default is 1000.\n   *\n   * @returns An async iterable of {@link PartInfo} entries.\n   */\n  paginateParts(\n    largeFileId: LargeFileId,\n    options?: PaginatorOptions,\n  ): AsyncIterableIterator<PartInfo> {\n    return paginateItems(\n      async (cursor: number | undefined) => {\n        const resp = await this.client.raw.listParts(\n          this.client.accountInfo.getApiUrl(),\n          this.client.accountInfo.getAuthToken(),\n          {\n            fileId: largeFileId,\n            maxPartCount: options?.pageSize ?? DEFAULT_PAGE_SIZE,\n            ...(cursor !== undefined ? { startPartNumber: cursor } : {}),\n          },\n        )\n        return { page: resp, nextCursor: resp.nextPartNumber ?? undefined }\n      },\n      (page) => page.parts,\n      options?.signal,\n    )\n  }\n\n  /**\n   * Looks up the latest visible version of a file by name.\n   * Uses `listFileNames` under the hood; returns `null` when the file does not\n   * exist or its latest version is a hide marker.\n   * @param fileName - The exact file path to look up.\n   *\n   * @returns The latest {@link FileVersion}, or `null` if not found.\n   */\n  async getFileInfoByName(fileName: string): Promise<FileVersion | null> {\n    // `listFileNames` returns the most recent version per file name,\n    // which may be a hide marker (real B2: `action: 'hide'`,\n    // `contentLength: 0`). This helper's contract is \"latest LIVE\n    // version\", so we treat a hide-action match as \"not found\".\n    const resp = await this.listFileNames({ prefix: fileName, pageSize: 1 })\n    const match = resp.files.find((f) => f.fileName === fileName)\n    if (!match || match.action === 'hide') return null\n    return match\n  }\n\n  /**\n   * Removes the latest hide marker for a file, restoring visibility of the\n   * previous upload. Returns the deleted hide marker, or `null` if there was\n   * no hide marker to remove (file is already visible or does not exist).\n   * @param fileName - The file path to unhide.\n   *\n   * @returns The deleted hide marker version, or `null` if nothing was hidden.\n   */\n  async unhideFile(fileName: string): Promise<FileVersion | null> {\n    // The latest version of a hidden file appears in listFileVersions but not\n    // in listFileNames. Walk versions until we find the hide marker on top.\n    const resp = await this.listFileVersions({ prefix: fileName, pageSize: 100 })\n    const versions = resp.files.filter((f) => f.fileName === fileName)\n    if (versions.length === 0) return null\n    // listFileVersions sorts by name asc then upload timestamp desc, so the\n    // first entry is the latest version.\n    const latest = versions[0]\n    if (!latest || latest.action !== 'hide') return null\n    await this.deleteFileVersion(fileName, latest.fileId)\n    return latest\n  }\n\n  /**\n   * Hides a file by creating a hide marker. The file remains in version history but is no longer visible in `listFileNames`.\n   * @param fileName - The file path to hide.\n   *\n   * @returns Metadata for the newly created hide marker.\n   */\n  async hideFile(fileName: string): Promise<FileVersion> {\n    return this.client.raw.hideFile(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id, fileName },\n    )\n  }\n\n  /**\n   * Permanently deletes a specific file version. Both file name and file ID are required.\n   *\n   * If the file is under Object Lock retention, B2 will reject the\n   * delete: compliance-mode files cannot be deleted until the retention\n   * expires; governance-mode files require `bypassGovernance: true`\n   * AND a calling key with the `bypassGovernance` capability. Files on\n   * legal hold cannot be deleted by anyone until the hold is removed.\n   *\n   * @param fileName - The file path of the version to delete.\n   * @param fileId - The unique identifier of the file version to delete.\n   * @param options - Optional flag for bypassing governance retention.\n   */\n  async deleteFileVersion(\n    fileName: string,\n    fileId: FileId,\n    options?: { bypassGovernance?: boolean },\n  ): Promise<void> {\n    await this.client.raw.deleteFileVersion(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        fileName,\n        fileId,\n        ...(options?.bypassGovernance !== undefined\n          ? { bypassGovernance: options.bypassGovernance }\n          : {}),\n      },\n    )\n  }\n\n  /**\n   * Cancels an in-progress large file upload so the partial parts are not\n   * retained or billed. The most common reason to call this is to clean up\n   * abandoned multipart uploads surfaced by {@link listUnfinishedLargeFiles}.\n   * @param fileId - The unique identifier of the unfinished large file to cancel.\n   *\n   * @returns Metadata about the cancelled large file.\n   */\n  async cancelLargeFile(fileId: LargeFileId): Promise<CancelLargeFileResponse> {\n    return this.client.raw.cancelLargeFile(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { fileId },\n    )\n  }\n\n  /**\n   * Lists large files in this bucket that were started but never finished or\n   * cancelled. Wraps `b2_list_unfinished_large_files`.\n   * @param options - Optional pagination filters.\n   *\n   * @returns The page of unfinished large files plus a continuation token.\n   */\n  async listUnfinishedLargeFiles(options?: {\n    /** Restrict results to files whose name starts with this prefix. */\n    namePrefix?: string\n    /** Start listing after this file ID (for pagination). */\n    startFileId?: LargeFileId\n    /**\n     * Maximum number of files to return per request (1-100). Forwarded\n     * to the raw API's `maxFileCount` parameter.\n     */\n    pageSize?: number\n  }) {\n    return this.client.raw.listUnfinishedLargeFiles(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        bucketId: this.id,\n        ...(options?.namePrefix !== undefined ? { namePrefix: options.namePrefix } : {}),\n        ...(options?.startFileId !== undefined ? { startFileId: options.startFileId } : {}),\n        ...(options?.pageSize !== undefined ? { maxFileCount: options.pageSize } : {}),\n      },\n    )\n  }\n\n  /**\n   * Deletes many file versions with bounded concurrency. Errors from individual\n   * deletes are collected and returned rather than thrown, so partial success\n   * does not abort the run.\n   *\n   * When `options.signal` is supplied and aborted, in-flight deletes\n   * complete (they're already on the wire), but no new deletes start\n   * after the abort fires. Subsequent targets are short-circuited to an\n   * error entry so the result tally reflects what actually happened.\n   * @param targets - File versions to delete.\n   * @param options - Optional concurrency override and abort signal.\n   *   Concurrency defaults to the SDK-wide bulk-metadata setting\n   *   (currently 10, higher than transfer concurrency because each\n   *   task is a single tiny API round-trip).\n   *\n   * @returns A summary of successes and per-target errors.\n   */\n  async deleteMany(\n    targets: readonly DeleteTarget[],\n    options?: { concurrency?: number; signal?: AbortSignal },\n  ): Promise<DeleteManyResult> {\n    const concurrency = options?.concurrency ?? DEFAULT_BULK_CONCURRENCY\n    const sem = new Semaphore(concurrency)\n    const signal = options?.signal\n    let deleted = 0\n    const errors: DeleteError[] = []\n\n    await Promise.all(\n      targets.map(async (target) => {\n        await sem.acquire()\n        try {\n          // Honour abort BETWEEN acquisitions: in-flight deletes\n          // complete (they're already on the wire), but new tasks don't\n          // start once the signal fires. Without this gate, aborting a\n          // 1000-item deleteMany would still let the next `concurrency`\n          // tasks dispatch before the caller's await returned.\n          if (signal?.aborted) {\n            errors.push({\n              target,\n              error: toError(signal.reason ?? 'aborted'),\n            })\n            return\n          }\n          await this.deleteFileVersion(target.fileName, target.fileId)\n          deleted++\n        } catch (err) {\n          errors.push({\n            target,\n            error: toError(err),\n          })\n        } finally {\n          sem.release()\n        }\n      }),\n    )\n\n    return { deleted, errors }\n  }\n\n  /**\n   * Async generator that streams every file version in the bucket (optionally\n   * filtered by prefix) and deletes each one. Yields a {@link DeleteAllEvent}\n   * per file version. With `dryRun: true`, no deletes are performed but `skip`\n   * events are still emitted.\n   * @param options - Optional prefix filter, page size, and dry-run flag.\n   *\n   * @returns An async generator of per-file events.\n   */\n  async *deleteAll(options?: {\n    /** Only delete file versions whose names start with this prefix. */\n    prefix?: string\n    /** Number of file versions fetched per API page (default 1000). */\n    pageSize?: number\n    /** If true, yield `skip` events without actually deleting anything. */\n    dryRun?: boolean\n  }): AsyncGenerator<DeleteAllEvent> {\n    const dryRun = options?.dryRun ?? false\n    const pageSize = options?.pageSize ?? DEFAULT_PAGE_SIZE\n\n    let startFileName: string | undefined\n    let startFileId: FileId | undefined\n    while (true) {\n      const page = await this.listFileVersions({\n        pageSize,\n        ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n        ...(startFileName !== undefined ? { startFileName } : {}),\n        ...(startFileId !== undefined ? { startFileId } : {}),\n      })\n\n      for (const version of page.files) {\n        if (dryRun) {\n          yield { type: 'skip', fileName: version.fileName, fileId: version.fileId }\n          continue\n        }\n        try {\n          await this.deleteFileVersion(version.fileName, version.fileId)\n          yield { type: 'delete', fileName: version.fileName, fileId: version.fileId }\n        } catch (err) {\n          yield {\n            type: 'error',\n            fileName: version.fileName,\n            fileId: version.fileId,\n            message: toError(err).message,\n          }\n        }\n      }\n\n      if (!page.nextFileName) break\n      startFileName = page.nextFileName\n      startFileId = page.nextFileId ?? undefined\n    }\n  }\n\n  /**\n   * Creates a server-side copy of a file within or across buckets.\n   * @param options - Copy configuration including source file ID and destination name.\n   *\n   * @returns Metadata for the newly created file version.\n   */\n  async copyFile(options: {\n    /** File ID of the source file to copy. */\n    sourceFileId: FileId\n    /** Destination file name in the target bucket. */\n    fileName: string\n    /** Target bucket ID. Defaults to this bucket if omitted. */\n    destinationBucketId?: BucketId\n    /** Whether to copy or replace file metadata. */\n    metadataDirective?: MetadataDirective\n    /** Override content type (only with `REPLACE` metadata directive). */\n    contentType?: string\n    /** Override file info (only with `REPLACE` metadata directive). */\n    fileInfo?: Record<string, string>\n    /** Server-side encryption for the destination file. */\n    serverSideEncryption?: EncryptionSetting\n  }): Promise<FileVersion> {\n    return this.client.raw.copyFile(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      options,\n    )\n  }\n\n  /**\n   * Copies a file via the server-side multipart protocol. Each part is copied\n   * by reference through `b2_copy_part`; data never traverses the client. Falls\n   * back to a single `copyFile` call when the source fits within a single part.\n   * @param options - Copy parameters including source file ID, destination name, part size, and concurrency.\n   *\n   * @returns Metadata for the newly created destination file version.\n   */\n  async copyLargeFile(options: {\n    /** File ID of the source file to copy. */\n    sourceFileId: FileId\n    /** Destination file name in the target bucket. */\n    fileName: string\n    /** Target bucket ID. Defaults to this bucket if omitted. */\n    destinationBucketId?: BucketId\n    /** Override content type for the destination. */\n    contentType?: string\n    /** Custom file info for the destination. */\n    fileInfo?: Record<string, string>\n    /** Server-side encryption for the destination file. */\n    destinationServerSideEncryption?: EncryptionSetting\n    /** SSE-C settings for the source if it was uploaded with SSE-C. */\n    sourceServerSideEncryption?: EncryptionSetting\n    /** Part size in bytes. Defaults to the account's recommended part size. */\n    partSize?: number\n    /**\n     * Maximum number of parts copied in parallel. Defaults to the\n     * SDK-wide transfer concurrency.\n     */\n    concurrency?: number\n    /**\n     * Optional abort signal. Aborting cancels any remaining parts and\n     * triggers a best-effort `cancelLargeFile` on the unfinished upload.\n     */\n    signal?: AbortSignal\n  }): Promise<FileVersion> {\n    return copyLargeFile(this.client.raw, this.client.accountInfo, {\n      sourceFileId: options.sourceFileId,\n      fileName: options.fileName,\n      ...(options.destinationBucketId !== undefined\n        ? { destinationBucketId: options.destinationBucketId }\n        : { destinationBucketId: this.id }),\n      ...(options.contentType !== undefined ? { contentType: options.contentType } : {}),\n      ...(options.fileInfo !== undefined ? { fileInfo: options.fileInfo } : {}),\n      ...(options.destinationServerSideEncryption !== undefined\n        ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n        : {}),\n      ...(options.sourceServerSideEncryption !== undefined\n        ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n        : {}),\n      ...(options.partSize !== undefined ? { partSize: options.partSize } : {}),\n      ...(options.concurrency !== undefined ? { concurrency: options.concurrency } : {}),\n      ...(options.signal !== undefined ? { signal: options.signal } : {}),\n    })\n  }\n\n  /**\n   * Updates bucket settings such as type, CORS, lifecycle rules, and encryption.\n   * @param options - Fields to update. Omitted fields are left unchanged.\n   *\n   * @returns Updated bucket metadata.\n   */\n  async update(options: {\n    /** Change the bucket access level. */\n    bucketType?: BucketType\n    /** Replace custom bucket metadata. */\n    bucketInfo?: Record<string, string>\n    /** Replace CORS rules. */\n    corsRules?: CorsRule[]\n    /** Change default server-side encryption. */\n    defaultServerSideEncryption?: EncryptionSetting\n    /** Change default file retention policy. */\n    defaultRetention?: BucketRetentionPolicy\n    /** Replace lifecycle rules. */\n    lifecycleRules?: LifecycleRule[]\n    /** Update replication configuration. */\n    replicationConfiguration?: ReplicationConfiguration\n    /** Optimistic locking: only update if the bucket revision matches. */\n    ifRevisionIs?: number\n  }): Promise<BucketInfo> {\n    return this.client.raw.updateBucket(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        accountId: accountId(this.client.accountInfo.getAccountId()),\n        bucketId: this.id,\n        ...options,\n      },\n    )\n  }\n\n  /**\n   * Permanently deletes this bucket. The bucket must be empty (no file versions).\n   *\n   * @returns The deleted bucket metadata.\n   */\n  async delete(): Promise<BucketInfo> {\n    return this.client.deleteBucket(this.id)\n  }\n\n  /**\n   * Gets a download authorization token scoped to a file name prefix in this bucket.\n   * @param fileNamePrefix - Only authorize downloads of files starting with this prefix.\n   * @param validDurationInSeconds - How long the authorization is valid (1-604800 seconds).\n   *\n   * @returns The download authorization response containing a time-limited token.\n   */\n  async getDownloadAuthorization(\n    fileNamePrefix: string,\n    validDurationInSeconds: number,\n  ): Promise<DownloadAuthorizationResponse> {\n    return this.client.raw.getDownloadAuthorization(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id, fileNamePrefix, validDurationInSeconds },\n    )\n  }\n\n  /**\n   * Gets the event notification rules configured for this bucket.\n   *\n   * @returns The current notification rules for this bucket.\n   */\n  async getNotificationRules(): Promise<GetBucketNotificationRulesResponse> {\n    return this.client.raw.getBucketNotificationRules(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id },\n    )\n  }\n\n  /**\n   * Replaces the event notification rules for this bucket.\n   * @param rules - The new set of notification rules to apply.\n   *\n   * @returns The updated notification rules for this bucket.\n   */\n  async setNotificationRules(\n    rules: EventNotificationRule[],\n  ): Promise<GetBucketNotificationRulesResponse> {\n    return this.client.raw.setBucketNotificationRules(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id, eventNotificationRules: rules },\n    )\n  }\n\n  /**\n   * Updates the file retention policy for a specific file version. Requires file lock on the bucket.\n   * @param fileName - The file path of the version to update.\n   * @param fileId - The unique identifier of the file version.\n   * @param retention - The new retention policy to apply.\n   * @param options - Optional flags. Set `bypassGovernance: true` to shorten governance-mode retention.\n   *\n   * @returns The updated file retention metadata.\n   */\n  async updateFileRetention(\n    fileName: string,\n    fileId: FileId,\n    retention: FileRetentionValue,\n    options?: { bypassGovernance?: boolean },\n  ) {\n    return this.client.raw.updateFileRetention(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        fileName,\n        fileId,\n        fileRetention: retention,\n        ...(options?.bypassGovernance !== undefined\n          ? { bypassGovernance: options.bypassGovernance }\n          : {}),\n      },\n    )\n  }\n\n  /**\n   * Updates the legal hold status for a specific file version. Requires file lock on the bucket.\n   * @param fileName - The file path of the version to update.\n   * @param fileId - The unique identifier of the file version.\n   * @param legalHold - The new legal hold status to apply.\n   *\n   * @returns The updated legal hold metadata.\n   */\n  async updateFileLegalHold(fileName: string, fileId: FileId, legalHold: LegalHoldValue) {\n    return this.client.raw.updateFileLegalHold(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { fileName, fileId, legalHold },\n    )\n  }\n\n  /**\n   * Refetches this bucket's metadata from B2 so callers operating on\n   * replication / lifecycle / retention configuration always start from the\n   * server-of-record state.\n   *\n   * Bucket configuration is monotonically revisioned by B2: B2 increments\n   * `revision` on every accepted update. The local {@link info} snapshot\n   * captured at construction time goes stale as soon as anyone else (or any\n   * prior `update()` call) mutates the bucket, so the ergonomic\n   * add/remove helpers below always refresh before composing the next\n   * `setX()` call. The result is that each helper is safe to call without\n   * the caller having to thread BucketInfo through their code.\n   *\n   * @returns Fresh {@link BucketInfo} for this bucket.\n   *\n   * @throws If the bucket no longer exists.\n   */\n  private async refresh(): Promise<BucketInfo> {\n    const fresh = await this.client.listBuckets({ bucketId: this.id })\n    const found = fresh[0]\n    if (!found) throw new Error(`Bucket ${this.id} not found`)\n    return found.info\n  }\n\n  /**\n   * Returns the current cross-region replication configuration, refetched\n   * from B2.\n   *\n   * Use this when you need to read replication state without composing a\n   * write. For add/remove flows the helper methods below handle the\n   * refresh-then-set sequence for you.\n   *\n   * @returns The current {@link ReplicationConfiguration}.\n   */\n  async getReplication(): Promise<ReplicationConfiguration> {\n    const fresh = await this.refresh()\n    return fresh.replicationConfiguration\n  }\n\n  /**\n   * Replaces this bucket's complete replication configuration.\n   * @param replication - The new configuration. Pass an empty source/destination\n   *   pair (`{ asReplicationSource: null, asReplicationDestination: null }`)\n   *   to clear replication entirely.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async setReplication(replication: ReplicationConfiguration): Promise<BucketInfo> {\n    return this.update({ replicationConfiguration: replication })\n  }\n\n  /**\n   * Adds (or replaces by `replicationRuleName`) a single replication rule\n   * on this bucket while leaving any other rules, the source key, and the\n   * destination key mapping untouched.\n   *\n   * When this is the very first source-side rule, `sourceApplicationKeyId`\n   * must be supplied to seed `asReplicationSource.sourceApplicationKeyId`;\n   * for subsequent calls the existing source key is reused unless the\n   * caller explicitly overrides it.\n   *\n   * @param rule - The replication rule to add or replace.\n   * @param options - Optional source application key ID override (or seed\n   *   when no source side exists yet).\n   *\n   * @returns The updated bucket metadata.\n   *\n   * @throws If no source-side replication exists yet and the caller did\n   *   not supply `sourceApplicationKeyId`.\n   */\n  async addReplicationRule(\n    rule: ReplicationRule,\n    options?: { sourceApplicationKeyId?: ApplicationKeyId },\n  ): Promise<BucketInfo> {\n    const current = (await this.refresh()).replicationConfiguration\n    const existingSource = current.asReplicationSource\n    const sourceKey = options?.sourceApplicationKeyId ?? existingSource?.sourceApplicationKeyId\n    if (!sourceKey) {\n      throw new Error(\n        'addReplicationRule: no existing source-side replication; pass options.sourceApplicationKeyId',\n      )\n    }\n    const existingRules = existingSource?.replicationRules ?? []\n    const without = existingRules.filter((r) => r.replicationRuleName !== rule.replicationRuleName)\n    return this.setReplication({\n      asReplicationSource: {\n        sourceApplicationKeyId: sourceKey,\n        replicationRules: [...without, rule],\n      },\n      asReplicationDestination: current.asReplicationDestination,\n    })\n  }\n\n  /**\n   * Removes a single replication rule by name. No-ops cleanly when the rule\n   * is not present (returns the unchanged-but-revision-bumped bucket info).\n   *\n   * @param replicationRuleName - Name of the rule to remove.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async removeReplicationRule(replicationRuleName: string): Promise<BucketInfo> {\n    const current = (await this.refresh()).replicationConfiguration\n    const existingSource = current.asReplicationSource\n    if (!existingSource) {\n      return this.setReplication(current)\n    }\n    const filtered = existingSource.replicationRules.filter(\n      (r) => r.replicationRuleName !== replicationRuleName,\n    )\n    return this.setReplication({\n      asReplicationSource: {\n        sourceApplicationKeyId: existingSource.sourceApplicationKeyId,\n        replicationRules: filtered,\n      },\n      asReplicationDestination: current.asReplicationDestination,\n    })\n  }\n\n  /**\n   * Returns the current lifecycle rules for this bucket, refetched from B2.\n   *\n   * @returns The current array of {@link LifecycleRule}s.\n   */\n  async getLifecycleRules(): Promise<readonly LifecycleRule[]> {\n    const fresh = await this.refresh()\n    return fresh.lifecycleRules\n  }\n\n  /**\n   * Replaces this bucket's lifecycle rules in their entirety.\n   * @param rules - The new rule set. Pass `[]` to remove all lifecycle\n   *   automation.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async setLifecycleRules(rules: readonly LifecycleRule[]): Promise<BucketInfo> {\n    return this.update({ lifecycleRules: [...rules] })\n  }\n\n  /**\n   * Adds (or replaces, matched by `fileNamePrefix`) a single lifecycle rule\n   * while leaving any other rules untouched.\n   *\n   * Matching on prefix mirrors B2's own data model: each unique prefix can\n   * have at most one rule, and a `b2_update_bucket` call that contains two\n   * rules with the same prefix is rejected. The helper enforces this for\n   * the caller.\n   *\n   * @param rule - The lifecycle rule to add or replace.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async addLifecycleRule(rule: LifecycleRule): Promise<BucketInfo> {\n    const current = await this.getLifecycleRules()\n    const without = current.filter((r) => r.fileNamePrefix !== rule.fileNamePrefix)\n    return this.setLifecycleRules([...without, rule])\n  }\n\n  /**\n   * Removes a single lifecycle rule by prefix. No-ops cleanly when the rule\n   * is not present.\n   *\n   * @param fileNamePrefix - The prefix of the rule to remove.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async removeLifecycleRule(fileNamePrefix: string): Promise<BucketInfo> {\n    const current = await this.getLifecycleRules()\n    return this.setLifecycleRules(current.filter((r) => r.fileNamePrefix !== fileNamePrefix))\n  }\n\n  /**\n   * Returns the current default Object Lock retention policy for new\n   * uploads to this bucket, refetched from B2.\n   *\n   * @returns The default {@link BucketRetentionPolicy} (which may be\n   *   `{ mode: 'none', period: null }` when Object Lock is enabled on the\n   *   bucket but no default is set).\n   */\n  async getDefaultRetention(): Promise<BucketRetentionPolicy> {\n    const fresh = await this.refresh()\n    return fresh.defaultRetention\n  }\n\n  /**\n   * Sets (or clears, by passing `{ mode: 'none', period: null }`) the\n   * default Object Lock retention policy applied to new uploads.\n   *\n   * Object Lock must already be enabled on the bucket. Buckets created\n   * without `fileLockEnabled: true` cannot accept a default retention\n   * policy and B2 will reject this call.\n   *\n   * @param policy - The new default retention policy.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async setDefaultRetention(policy: BucketRetentionPolicy): Promise<BucketInfo> {\n    return this.update({ defaultRetention: policy })\n  }\n}\n"],"names":["B2Object","uploadLargeFile","uploadSmallFile","downloadByName","headByName","paginateItems","DEFAULT_PAGE_SIZE","concurrency","DEFAULT_BULK_CONCURRENCY","Semaphore","toError","copyLargeFile","accountId"],"mappings":"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"}
+{"version":3,"file":"bucket.cjs","names":[],"sources":["../src/bucket.ts"],"sourcesContent":["import type { B2Client } from './client.ts'\nimport { copyLargeFile } from './copy/large.ts'\nimport {\n  type DownloadResult,\n  downloadByName,\n  type HeadResult,\n  headByName,\n} from './download/single.ts'\nimport type { RetryOptions } from './http/retry.ts'\nimport { mergeUploadRetryOptions } from './internal/upload-retry-options.ts'\nimport { B2Object, type DownloadCallOptions, type HeadCallOptions } from './object.ts'\nimport type {\n  BucketInfo,\n  BucketRetentionPolicy,\n  BucketType,\n  CorsRule,\n  LifecycleRule,\n} from './types/bucket.ts'\nimport type { DownloadAuthorizationResponse } from './types/download.ts'\nimport type { EncryptionSetting } from './types/encryption.ts'\nimport type {\n  FileVersion,\n  ListFileNamesResponse,\n  ListFileVersionsResponse,\n  MetadataDirective,\n} from './types/file.ts'\nimport type { ApplicationKeyId, BucketId, FileId, LargeFileId } from './types/ids.ts'\nimport { accountId } from './types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from './types/lock.ts'\nimport type {\n  EventNotificationRule,\n  GetBucketNotificationRulesResponse,\n} from './types/notifications.ts'\nimport type { ReplicationConfiguration, ReplicationRule } from './types/replication.ts'\nimport type { CancelLargeFileResponse, PartInfo, UnfinishedLargeFile } from './types/upload.ts'\nimport type { CleanupFailureListener } from './upload/cancel.ts'\nimport { Semaphore } from './upload/concurrency.ts'\nimport { uploadLargeFile } from './upload/large.ts'\nimport {\n  type BucketUploadOptions,\n  rejectSmallResumeFileId,\n  stripResumeOnlyOptions,\n} from './upload/options.ts'\nimport { uploadSmallFile } from './upload/single.ts'\nimport { DEFAULT_BULK_CONCURRENCY, DEFAULT_PAGE_SIZE } from './util/defaults.ts'\nimport { type PaginatorOptions, paginateItems } from './util/paginator.ts'\nimport { toError } from './util/to-error.ts'\n\n/** A target for bulk deletion: a file name and its specific version ID. */\nexport interface DeleteTarget {\n  /** File name (path) of the version to delete. */\n  readonly fileName: string\n  /** Unique identifier of the file version. */\n  readonly fileId: FileId\n}\n\n/** Per-target error encountered during bulk deletion. */\nexport interface DeleteError {\n  /** The target that failed. */\n  readonly target: DeleteTarget\n  /** The error thrown by the underlying `deleteFileVersion` call. */\n  readonly error: Error\n}\n\n/** Aggregate result of a {@link Bucket.deleteMany} run. */\nexport interface DeleteManyResult {\n  /** Number of file versions successfully deleted. */\n  readonly deleted: number\n  /** Per-target failures. Empty on full success. */\n  readonly errors: readonly DeleteError[]\n}\n\n/** Emitted by {@link Bucket.deleteAll} once a file version has been successfully deleted. */\nexport interface DeleteAllDeleteEvent {\n  /** Discriminant identifying a successful delete. */\n  readonly type: 'delete'\n  /** File name of the deleted version. */\n  readonly fileName: string\n  /** Unique identifier of the deleted version. */\n  readonly fileId: FileId\n}\n\n/** Emitted by {@link Bucket.deleteAll} when a single delete call fails (other versions keep streaming). */\nexport interface DeleteAllErrorEvent {\n  /** Discriminant identifying a per-version delete failure. */\n  readonly type: 'error'\n  /** File name of the version that failed to delete. */\n  readonly fileName: string\n  /** Unique identifier of the version that failed to delete. */\n  readonly fileId: FileId\n  /** Human-readable failure reason taken from the underlying error. */\n  readonly message: string\n}\n\n/** Emitted by {@link Bucket.deleteAll} in `dryRun` mode for every version that would have been deleted. */\nexport interface DeleteAllSkipEvent {\n  /** Discriminant identifying a dry-run skip. */\n  readonly type: 'skip'\n  /** File name of the version that would have been deleted. */\n  readonly fileName: string\n  /** Unique identifier of the version that would have been deleted. */\n  readonly fileId: FileId\n}\n\n/** Event yielded by {@link Bucket.deleteAll} as it streams through file versions. */\nexport type DeleteAllEvent = DeleteAllDeleteEvent | DeleteAllErrorEvent | DeleteAllSkipEvent\n\ninterface BucketDefaultRetentionSnapshot {\n  readonly retention?: BucketRetentionPolicy\n  readonly unreadable: boolean\n}\n\nfunction bucketDefaultRetentionSnapshot(info: BucketInfo): 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: BucketUploadOptions): 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/**\n * Handle to a B2 bucket providing upload, download, listing, and management operations.\n *\n * Obtained via {@link B2Client.createBucket}, {@link B2Client.listBuckets}, or {@link B2Client.getBucket}.\n *\n * @example\n * ```ts\n * const bucket = await client.getBucket('my-bucket')\n * await bucket.upload({ fileName: 'hello.txt', source: new BufferSource(data) })\n * ```\n */\nexport class Bucket {\n  /** Unique identifier for this bucket. */\n  readonly id: BucketId\n  /** Human-readable bucket name. */\n  readonly name: string\n  /** Full bucket metadata as returned by the B2 API. */\n  readonly info: BucketInfo\n  private readonly client: B2Client\n  private readonly uploadRetryOptions: RetryOptions\n\n  /**\n   * @param client - The parent B2Client instance.\n   * @param info - The bucket metadata from the API.\n   * @param uploadRetryOptions - Resolved client upload retry defaults.\n   *\n   * @internal\n   */\n  constructor(client: B2Client, info: BucketInfo, uploadRetryOptions: RetryOptions) {\n    this.client = client\n    this.info = info\n    this.id = info.bucketId\n    this.name = info.bucketName\n    this.uploadRetryOptions = uploadRetryOptions\n  }\n\n  /**\n   * Returns a {@link B2Object} handle for a specific file name in this bucket.\n   * @param fileName - The file path within the bucket.\n   *\n   * @returns A B2Object handle bound to this bucket and file name.\n   */\n  file(fileName: string): B2Object {\n    return new B2Object(this.client, this, fileName, this.uploadRetryOptions)\n  }\n\n  /**\n   * Uploads a file to this bucket. Automatically uses multipart upload for files\n   * larger than the recommended part size.\n   * @param options - Upload configuration including file name, source data, and optional settings.\n   *\n   * @returns Metadata for the uploaded file version.\n   */\n  async upload(options: BucketUploadOptions): 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) ? await this.refresh() : this.info\n      const bucketDefaultRetention = bucketDefaultRetentionSnapshot(bucketInfo)\n      return uploadLargeFile(this.client.raw, this.client.accountInfo, {\n        ...options,\n        bucketId: this.id,\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, 'Bucket.upload')\n    const smallOptions = stripResumeOnlyOptions(options)\n    return uploadSmallFile(this.client.raw, this.client.accountInfo, {\n      ...smallOptions,\n      bucketId: this.id,\n      retry: uploadRetryOptions,\n    })\n  }\n\n  /**\n   * Downloads a file from this bucket by name. Pass `method: 'HEAD'` in\n   * `options` to fetch only the response headers (file metadata) without\n   * streaming the body.\n   * @param fileName - The file name (path) to download.\n   * @param options - Optional method, range, SSE-C decryption, response-header overrides, and abort signal.\n   *\n   * @returns The download result containing response headers and a readable body stream.\n   */\n  async download(fileName: string, options?: DownloadCallOptions): Promise<DownloadResult> {\n    return downloadByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.name,\n      fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Fetches the response headers (file metadata) for a file via HTTP\n   * HEAD. Returns a body-less result so callers never have to drain\n   * the (logically empty) HEAD body themselves.\n   *\n   * Use this for metadata-only checks like \"does this file exist\", \"what\n   * is its current SHA-1\", \"what is its Content-Length\". For full file\n   * retrieval use {@link Bucket.download}.\n   *\n   * @param fileName - The file name (path) to inspect.\n   * @param options - Optional range, SSE-C decryption, response-header\n   *   overrides, and abort signal. Same shape as {@link Bucket.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   * @example\n   * ```ts\n   * const { headers } = await bucket.head('photos/2026/sunset.jpg')\n   * console.log(headers.contentLength, headers.contentSha1)\n   * ```\n   */\n  async head(fileName: string, options?: HeadCallOptions): Promise<HeadResult> {\n    return headByName(this.client.raw, this.client.accountInfo, {\n      bucketName: this.name,\n      fileName,\n      ...options,\n    })\n  }\n\n  /**\n   * Lists file names in this bucket (most recent versions only).\n   * @param options - Optional filtering and pagination settings.\n   *\n   * @returns A page of file versions with an optional continuation token.\n   */\n  async listFileNames(options?: {\n    /** Start listing after this file name (for pagination). */\n    startFileName?: string\n    /**\n     * Maximum number of files to return per request (1-10000).\n     * Forwarded to the raw API's `maxFileCount` parameter.\n     */\n    pageSize?: number\n    /** Only list files with names starting with this prefix. */\n    prefix?: string\n    /** Delimiter for virtual directory grouping (typically `\"/\"`). */\n    delimiter?: string\n    /** Optional abort signal for the listing request. */\n    signal?: AbortSignal\n  }): Promise<ListFileNamesResponse> {\n    return this.client.raw.listFileNames(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        bucketId: this.id,\n        ...(options?.startFileName !== undefined ? { startFileName: options.startFileName } : {}),\n        ...(options?.pageSize !== undefined ? { maxFileCount: options.pageSize } : {}),\n        ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n        ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n      },\n      {\n        ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n      },\n    )\n  }\n\n  /**\n   * Lists all file versions in this bucket, including hidden files.\n   * @param options - Optional filtering and pagination settings.\n   *\n   * @returns A page of file versions with an optional continuation token.\n   */\n  async listFileVersions(options?: {\n    /** Start listing after this file name (for pagination). */\n    startFileName?: string\n    /** Start listing after this file ID (for pagination within a file name). */\n    startFileId?: FileId\n    /**\n     * Maximum number of file versions to return per request (1-10000).\n     * Forwarded to the raw API's `maxFileCount` parameter.\n     */\n    pageSize?: number\n    /** Only list files with names starting with this prefix. */\n    prefix?: string\n    /** Delimiter for virtual directory grouping. */\n    delimiter?: string\n    /** Optional abort signal for the listing request. */\n    signal?: AbortSignal\n  }): Promise<ListFileVersionsResponse> {\n    return this.client.raw.listFileVersions(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        bucketId: this.id,\n        ...(options?.startFileName !== undefined ? { startFileName: options.startFileName } : {}),\n        ...(options?.startFileId !== undefined ? { startFileId: options.startFileId } : {}),\n        ...(options?.pageSize !== undefined ? { maxFileCount: options.pageSize } : {}),\n        ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n        ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n      },\n      {\n        ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n      },\n    )\n  }\n\n  /**\n   * Async iterator that yields the latest visible version of every file in\n   * the bucket, automatically handling pagination via `listFileNames`.\n   *\n   * Hidden files (those whose latest version is a hide marker) are NOT\n   * yielded by this iterator. Use {@link paginateFileVersions} when you\n   * need full version history.\n   *\n   * @param options - Filter + pagination + abort options. `pageSize` is\n   *   forwarded to `b2_list_file_names`'s `maxFileCount` (default 1000,\n   *   B2-capped at 10000).\n   *\n   * @returns An async iterable of {@link FileVersion} entries.\n   *\n   * @example\n   * ```ts\n   * for await (const file of bucket.paginateFileNames({ prefix: 'photos/' })) {\n   *   console.log(file.fileName, file.contentLength)\n   * }\n   * ```\n   */\n  paginateFileNames(\n    options?: {\n      /** Only yield files whose names start with this prefix. */\n      prefix?: string\n      /** Delimiter for virtual directory grouping (typically `'/'`). */\n      delimiter?: string\n    } & PaginatorOptions,\n  ): AsyncIterableIterator<FileVersion> {\n    return paginateItems(\n      async (cursor: string | undefined) => {\n        const resp = await this.listFileNames({\n          pageSize: options?.pageSize ?? DEFAULT_PAGE_SIZE,\n          ...(cursor !== undefined ? { startFileName: cursor } : {}),\n          ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n          ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n          ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n        })\n        return { page: resp, nextCursor: resp.nextFileName ?? undefined }\n      },\n      // Real B2 surfaces hide markers as rows in `b2_list_file_names`. This\n      // iterator's documented contract is \"latest VISIBLE version\", so we\n      // drop hide-action rows here. Callers who need full history should\n      // use `paginateFileVersions`.\n      (page) => page.files.filter((f) => f.action !== 'hide'),\n      options?.signal,\n    )\n  }\n\n  /**\n   * Async iterator that yields every version of every file in the bucket,\n   * including hidden files and historical versions, automatically handling\n   * pagination via `listFileVersions`.\n   *\n   * The two-cursor `(nextFileName, nextFileId)` continuation that the raw\n   * endpoint exposes is threaded internally; callers iterate flat.\n   *\n   * @param options - Filter + pagination + abort options.\n   *\n   * @returns An async iterable of {@link FileVersion} entries.\n   */\n  paginateFileVersions(\n    options?: {\n      /** Only yield versions whose names start with this prefix. */\n      prefix?: string\n      /** Delimiter for virtual directory grouping. */\n      delimiter?: string\n    } & PaginatorOptions,\n  ): AsyncIterableIterator<FileVersion> {\n    type Cursor = { fileName: string; fileId: FileId | undefined }\n    return paginateItems(\n      async (cursor: Cursor | undefined) => {\n        const resp = await this.listFileVersions({\n          pageSize: options?.pageSize ?? DEFAULT_PAGE_SIZE,\n          ...(cursor !== undefined ? { startFileName: cursor.fileName } : {}),\n          ...(cursor?.fileId !== undefined ? { startFileId: cursor.fileId } : {}),\n          ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n          ...(options?.delimiter !== undefined ? { delimiter: options.delimiter } : {}),\n          ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n        })\n        const nextCursor: Cursor | undefined =\n          resp.nextFileName !== null\n            ? { fileName: resp.nextFileName, fileId: resp.nextFileId ?? undefined }\n            : undefined\n        return { page: resp, nextCursor }\n      },\n      (page) => page.files,\n      options?.signal,\n    )\n  }\n\n  /**\n   * Async iterator that yields every unfinished large file in the bucket,\n   * automatically handling pagination via `listUnfinishedLargeFiles`.\n   *\n   * Useful for janitorial scripts that want to inspect or cancel abandoned\n   * multipart uploads (typically followed by {@link cancelLargeFile} on\n   * the underlying raw client).\n   *\n   * @param options - Filter + pagination + abort options. `pageSize` is\n   *   B2-capped at 100 for this endpoint.\n   *\n   * @returns An async iterable of unfinished-large-file metadata entries.\n   */\n  paginateUnfinishedLargeFiles(\n    options?: {\n      /** Only yield large files whose names start with this prefix. */\n      namePrefix?: string\n    } & PaginatorOptions,\n  ): AsyncIterableIterator<UnfinishedLargeFile> {\n    return paginateItems(\n      async (cursor: LargeFileId | undefined) => {\n        const resp = await this.listUnfinishedLargeFiles({\n          pageSize: options?.pageSize ?? 100,\n          ...(cursor !== undefined ? { startFileId: cursor } : {}),\n          ...(options?.namePrefix !== undefined ? { namePrefix: options.namePrefix } : {}),\n          ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n        })\n        return { page: resp, nextCursor: resp.nextFileId ?? undefined }\n      },\n      (page) => page.files,\n      options?.signal,\n    )\n  }\n\n  /**\n   * Async iterator that yields every uploaded part for a specific large\n   * file, automatically handling pagination via `listParts`.\n   *\n   * @param largeFileId - The unfinished large file to enumerate parts of.\n   * @param options - Pagination + abort options. `pageSize` is B2-capped\n   *   at 1000 for this endpoint; the default is 1000.\n   *\n   * @returns An async iterable of {@link PartInfo} entries.\n   */\n  paginateParts(\n    largeFileId: LargeFileId,\n    options?: PaginatorOptions,\n  ): AsyncIterableIterator<PartInfo> {\n    return paginateItems(\n      async (cursor: number | undefined) => {\n        const resp = await this.client.raw.listParts(\n          this.client.accountInfo.getApiUrl(),\n          this.client.accountInfo.getAuthToken(),\n          {\n            fileId: largeFileId,\n            maxPartCount: options?.pageSize ?? DEFAULT_PAGE_SIZE,\n            ...(cursor !== undefined ? { startPartNumber: cursor } : {}),\n          },\n          options?.signal !== undefined ? { signal: options.signal } : undefined,\n        )\n        return { page: resp, nextCursor: resp.nextPartNumber ?? undefined }\n      },\n      (page) => page.parts,\n      options?.signal,\n    )\n  }\n\n  /**\n   * Looks up the latest visible version of a file by name.\n   * Uses `listFileNames` under the hood; returns `null` when the file does not\n   * exist or its latest version is a hide marker.\n   * @param fileName - The exact file path to look up.\n   *\n   * @returns The latest {@link FileVersion}, or `null` if not found.\n   */\n  async getFileInfoByName(fileName: string): Promise<FileVersion | null> {\n    // `listFileNames` returns the most recent version per file name,\n    // which may be a hide marker (real B2: `action: 'hide'`,\n    // `contentLength: 0`). This helper's contract is \"latest LIVE\n    // version\", so we treat a hide-action match as \"not found\".\n    const resp = await this.listFileNames({ prefix: fileName, pageSize: 1 })\n    const match = resp.files.find((f) => f.fileName === fileName)\n    if (!match || match.action === 'hide') return null\n    return match\n  }\n\n  /**\n   * Removes the latest hide marker for a file, restoring visibility of the\n   * previous upload. Returns the deleted hide marker, or `null` if there was\n   * no hide marker to remove (file is already visible or does not exist).\n   * @param fileName - The file path to unhide.\n   *\n   * @returns The deleted hide marker version, or `null` if nothing was hidden.\n   */\n  async unhideFile(fileName: string): Promise<FileVersion | null> {\n    // The latest version of a hidden file appears in listFileVersions but not\n    // in listFileNames. Walk versions until we find the hide marker on top.\n    const resp = await this.listFileVersions({ prefix: fileName, pageSize: 100 })\n    const versions = resp.files.filter((f) => f.fileName === fileName)\n    if (versions.length === 0) return null\n    // listFileVersions sorts by name asc then upload timestamp desc, so the\n    // first entry is the latest version.\n    const latest = versions[0]\n    if (latest?.action !== 'hide') return null\n    await this.deleteFileVersion(fileName, latest.fileId)\n    return latest\n  }\n\n  /**\n   * Hides a file by creating a hide marker. The file remains in version history but is no longer visible in `listFileNames`.\n   * @param fileName - The file path to hide.\n   * @param options - Optional request controls such as an abort signal.\n   *\n   * @returns Metadata for the newly created hide marker.\n   */\n  async hideFile(fileName: string, options?: { signal?: AbortSignal }): Promise<FileVersion> {\n    return this.client.raw.hideFile(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id, fileName },\n      options,\n    )\n  }\n\n  /**\n   * Permanently deletes a specific file version. Both file name and file ID are required.\n   *\n   * If the file is under Object Lock retention, B2 will reject the\n   * delete: compliance-mode files cannot be deleted until the retention\n   * expires; governance-mode files require `bypassGovernance: true`\n   * AND a calling key with the `bypassGovernance` capability. Files on\n   * legal hold cannot be deleted by anyone until the hold is removed.\n   *\n   * @param fileName - The file path of the version to delete.\n   * @param fileId - The unique identifier of the file version to delete.\n   * @param options - Optional governance and abort controls.\n   */\n  async deleteFileVersion(\n    fileName: string,\n    fileId: FileId,\n    options?: { bypassGovernance?: boolean; signal?: AbortSignal },\n  ): Promise<void> {\n    await this.client.raw.deleteFileVersion(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        fileName,\n        fileId,\n        ...(options?.bypassGovernance !== undefined\n          ? { bypassGovernance: options.bypassGovernance }\n          : {}),\n      },\n      options?.signal !== undefined ? { signal: options.signal } : undefined,\n    )\n  }\n\n  /**\n   * Cancels an in-progress large file upload so the partial parts are not\n   * retained or billed. The most common reason to call this is to clean up\n   * abandoned multipart uploads surfaced by {@link listUnfinishedLargeFiles}.\n   * @param fileId - The unique identifier of the unfinished large file to cancel.\n   *\n   * @returns Metadata about the cancelled large file.\n   */\n  async cancelLargeFile(fileId: LargeFileId): Promise<CancelLargeFileResponse> {\n    return this.client.raw.cancelLargeFile(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { fileId },\n    )\n  }\n\n  /**\n   * Lists large files in this bucket that were started but never finished or\n   * cancelled. Wraps `b2_list_unfinished_large_files`.\n   * @param options - Optional pagination filters.\n   *\n   * @returns The page of unfinished large files plus a continuation token.\n   */\n  async listUnfinishedLargeFiles(options?: {\n    /** Restrict results to files whose name starts with this prefix. */\n    namePrefix?: string\n    /** Start listing at this file ID, inclusive (for pagination). */\n    startFileId?: LargeFileId\n    /**\n     * Maximum number of files to return per request (1-100). Forwarded\n     * to the raw API's `maxFileCount` parameter.\n     */\n    pageSize?: number\n    /** Abort signal for cancelling the list request. */\n    signal?: AbortSignal\n  }) {\n    return this.client.raw.listUnfinishedLargeFiles(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        bucketId: this.id,\n        ...(options?.namePrefix !== undefined ? { namePrefix: options.namePrefix } : {}),\n        ...(options?.startFileId !== undefined ? { startFileId: options.startFileId } : {}),\n        ...(options?.pageSize !== undefined ? { maxFileCount: options.pageSize } : {}),\n      },\n      options?.signal !== undefined ? { signal: options.signal } : undefined,\n    )\n  }\n\n  /**\n   * Deletes many file versions with bounded concurrency. Errors from individual\n   * deletes are collected and returned rather than thrown, so partial success\n   * does not abort the run.\n   *\n   * When `options.signal` is supplied and aborted, in-flight deletes\n   * complete (they're already on the wire), but no new deletes start\n   * after the abort fires. Subsequent targets are short-circuited to an\n   * error entry so the result tally reflects what actually happened.\n   * @param targets - File versions to delete.\n   * @param options - Optional concurrency override and abort signal.\n   *   Concurrency defaults to the SDK-wide bulk-metadata setting\n   *   (currently 10, higher than transfer concurrency because each\n   *   task is a single tiny API round-trip).\n   *\n   * @returns A summary of successes and per-target errors.\n   */\n  async deleteMany(\n    targets: readonly DeleteTarget[],\n    options?: { concurrency?: number; signal?: AbortSignal },\n  ): Promise<DeleteManyResult> {\n    const concurrency = options?.concurrency ?? DEFAULT_BULK_CONCURRENCY\n    const sem = new Semaphore(concurrency)\n    const signal = options?.signal\n    let deleted = 0\n    const errors: DeleteError[] = []\n\n    await Promise.all(\n      targets.map(async (target) => {\n        await sem.acquire()\n        try {\n          // Honour abort BETWEEN acquisitions: in-flight deletes\n          // complete (they're already on the wire), but new tasks don't\n          // start once the signal fires. Without this gate, aborting a\n          // 1000-item deleteMany would still let the next `concurrency`\n          // tasks dispatch before the caller's await returned.\n          if (signal?.aborted) {\n            errors.push({\n              target,\n              error: toError(signal.reason ?? 'aborted'),\n            })\n            return\n          }\n          await this.deleteFileVersion(target.fileName, target.fileId)\n          deleted++\n        } catch (err) {\n          errors.push({\n            target,\n            error: toError(err),\n          })\n        } finally {\n          sem.release()\n        }\n      }),\n    )\n\n    return { deleted, errors }\n  }\n\n  /**\n   * Async generator that streams every file version in the bucket (optionally\n   * filtered by prefix) and deletes each one. Yields a {@link DeleteAllEvent}\n   * per file version. With `dryRun: true`, no deletes are performed but `skip`\n   * events are still emitted.\n   * @param options - Optional prefix filter, page size, and dry-run flag.\n   *\n   * @returns An async generator of per-file events.\n   */\n  async *deleteAll(options?: {\n    /** Only delete file versions whose names start with this prefix. */\n    prefix?: string\n    /** Number of file versions fetched per API page (default 1000). */\n    pageSize?: number\n    /** If true, yield `skip` events without actually deleting anything. */\n    dryRun?: boolean\n  }): AsyncGenerator<DeleteAllEvent> {\n    const dryRun = options?.dryRun ?? false\n    const pageSize = options?.pageSize ?? DEFAULT_PAGE_SIZE\n\n    let startFileName: string | undefined\n    let startFileId: FileId | undefined\n    while (true) {\n      const page = await this.listFileVersions({\n        pageSize,\n        ...(options?.prefix !== undefined ? { prefix: options.prefix } : {}),\n        ...(startFileName !== undefined ? { startFileName } : {}),\n        ...(startFileId !== undefined ? { startFileId } : {}),\n      })\n\n      for (const version of page.files) {\n        if (dryRun) {\n          yield { type: 'skip', fileName: version.fileName, fileId: version.fileId }\n          continue\n        }\n        try {\n          await this.deleteFileVersion(version.fileName, version.fileId)\n          yield { type: 'delete', fileName: version.fileName, fileId: version.fileId }\n        } catch (err) {\n          yield {\n            type: 'error',\n            fileName: version.fileName,\n            fileId: version.fileId,\n            message: toError(err).message,\n          }\n        }\n      }\n\n      if (!page.nextFileName) break\n      startFileName = page.nextFileName\n      startFileId = page.nextFileId ?? undefined\n    }\n  }\n\n  /**\n   * Creates a server-side copy of a file within or across buckets.\n   * @param options - Copy configuration including source file ID and destination name.\n   *\n   * @returns Metadata for the newly created file version.\n   */\n  async copyFile(options: {\n    /** File ID of the source file to copy. */\n    sourceFileId: FileId\n    /** Destination file name in the target bucket. */\n    fileName: string\n    /** Target bucket ID. Defaults to this bucket if omitted. */\n    destinationBucketId?: BucketId\n    /** Whether to copy or replace file metadata. */\n    metadataDirective?: MetadataDirective\n    /** Override content type (only with `REPLACE` metadata directive). */\n    contentType?: string\n    /** Override file info (only with `REPLACE` metadata directive). */\n    fileInfo?: Record<string, string>\n    /**\n     * @deprecated Renamed to `destinationServerSideEncryption` for consistency with\n     * multipart copy. Still honored as a fallback when the new field is absent.\n     */\n    serverSideEncryption?: EncryptionSetting\n    /** Server-side encryption for the destination file. Preferred over `serverSideEncryption`. */\n    destinationServerSideEncryption?: EncryptionSetting\n    /** SSE-C settings for the source if it was uploaded with SSE-C. */\n    sourceServerSideEncryption?: EncryptionSetting\n    /** Optional abort signal for cancelling the copy request. */\n    signal?: AbortSignal\n  }): Promise<FileVersion> {\n    const { serverSideEncryption, destinationServerSideEncryption, signal, ...copyOptions } =\n      options\n    const destinationEncryption = destinationServerSideEncryption ?? serverSideEncryption\n    return this.client.raw.copyFile(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        ...copyOptions,\n        ...(destinationEncryption !== undefined\n          ? { destinationServerSideEncryption: destinationEncryption }\n          : {}),\n      },\n      signal !== undefined ? { signal } : undefined,\n    )\n  }\n\n  /**\n   * Copies a file via the server-side multipart protocol. Each part is copied\n   * by reference through `b2_copy_part`; data never traverses the client. Falls\n   * back to a single `copyFile` call when the source fits within a single part.\n   * @param options - Copy parameters including source file ID, destination name, part size, and concurrency.\n   *\n   * @returns Metadata for the newly created destination file version.\n   */\n  async copyLargeFile(options: {\n    /** File ID of the source file to copy. */\n    sourceFileId: FileId\n    /** Destination file name in the target bucket. */\n    fileName: string\n    /** Target bucket ID. Defaults to this bucket if omitted. */\n    destinationBucketId?: BucketId\n    /** Override content type for the destination. */\n    contentType?: string\n    /** Custom file info for the destination. */\n    fileInfo?: Record<string, string>\n    /** Server-side encryption for the destination file. */\n    destinationServerSideEncryption?: EncryptionSetting\n    /** SSE-C settings for the source if it was uploaded with SSE-C. */\n    sourceServerSideEncryption?: EncryptionSetting\n    /**\n     * Callback invoked if best-effort cancellation fails, or if cancellation is\n     * skipped because `b2_finish_large_file` may already have committed.\n     */\n    onCleanupFailure?: CleanupFailureListener\n    /** Part size in bytes. Defaults to the account's recommended part size. */\n    partSize?: number\n    /**\n     * Maximum number of parts copied in parallel. Defaults to the\n     * SDK-wide transfer concurrency.\n     */\n    concurrency?: number\n    /**\n     * Optional abort signal. Aborting cancels any remaining parts and\n     * triggers a best-effort `cancelLargeFile` on the unfinished upload.\n     */\n    signal?: AbortSignal\n  }): Promise<FileVersion> {\n    return copyLargeFile(this.client.raw, this.client.accountInfo, {\n      sourceFileId: options.sourceFileId,\n      fileName: options.fileName,\n      ...(options.destinationBucketId !== undefined\n        ? { destinationBucketId: options.destinationBucketId }\n        : { destinationBucketId: this.id }),\n      ...(options.contentType !== undefined ? { contentType: options.contentType } : {}),\n      ...(options.fileInfo !== undefined ? { fileInfo: options.fileInfo } : {}),\n      ...(options.destinationServerSideEncryption !== undefined\n        ? { destinationServerSideEncryption: options.destinationServerSideEncryption }\n        : {}),\n      ...(options.sourceServerSideEncryption !== undefined\n        ? { sourceServerSideEncryption: options.sourceServerSideEncryption }\n        : {}),\n      ...(options.partSize !== undefined ? { partSize: options.partSize } : {}),\n      ...(options.concurrency !== undefined ? { concurrency: options.concurrency } : {}),\n      ...(options.onCleanupFailure !== undefined\n        ? { onCleanupFailure: options.onCleanupFailure }\n        : {}),\n      ...(options.signal !== undefined ? { signal: options.signal } : {}),\n    })\n  }\n\n  /**\n   * Updates bucket settings such as type, CORS, lifecycle rules, and encryption.\n   * @param options - Fields to update. Omitted fields are left unchanged.\n   *\n   * @returns Updated bucket metadata.\n   */\n  async update(options: {\n    /** Change the bucket access level. */\n    bucketType?: BucketType\n    /** Replace custom bucket metadata. */\n    bucketInfo?: Record<string, string>\n    /** Replace CORS rules. */\n    corsRules?: CorsRule[]\n    /** Change default server-side encryption. */\n    defaultServerSideEncryption?: EncryptionSetting\n    /** Change default file retention policy. */\n    defaultRetention?: BucketRetentionPolicy\n    /** Replace lifecycle rules. */\n    lifecycleRules?: LifecycleRule[]\n    /** Update replication configuration. */\n    replicationConfiguration?: ReplicationConfiguration\n    /** Optimistic locking: only update if the bucket revision matches. */\n    ifRevisionIs?: number\n  }): Promise<BucketInfo> {\n    return this.client.raw.updateBucket(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        accountId: accountId(this.client.accountInfo.getAccountId()),\n        bucketId: this.id,\n        ...options,\n      },\n    )\n  }\n\n  /**\n   * Permanently deletes this bucket. The bucket must be empty (no file versions).\n   *\n   * @returns The deleted bucket metadata.\n   */\n  async delete(): Promise<BucketInfo> {\n    return this.client.deleteBucket(this.id)\n  }\n\n  /**\n   * Gets a download authorization token scoped to a file name prefix in this bucket.\n   * @param fileNamePrefix - Only authorize downloads of files starting with this prefix.\n   * @param validDurationInSeconds - How long the authorization is valid (1-604800 seconds).\n   *\n   * @returns The download authorization response containing a time-limited token.\n   */\n  async getDownloadAuthorization(\n    fileNamePrefix: string,\n    validDurationInSeconds: number,\n  ): Promise<DownloadAuthorizationResponse> {\n    return this.client.raw.getDownloadAuthorization(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id, fileNamePrefix, validDurationInSeconds },\n    )\n  }\n\n  /**\n   * Gets the event notification rules configured for this bucket.\n   *\n   * @returns The current notification rules for this bucket.\n   */\n  async getNotificationRules(): Promise<GetBucketNotificationRulesResponse> {\n    return this.client.raw.getBucketNotificationRules(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id },\n    )\n  }\n\n  /**\n   * Replaces the event notification rules for this bucket.\n   * @param rules - The new set of notification rules to apply.\n   *\n   * @returns The updated notification rules for this bucket.\n   */\n  async setNotificationRules(\n    rules: EventNotificationRule[],\n  ): Promise<GetBucketNotificationRulesResponse> {\n    return this.client.raw.setBucketNotificationRules(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { bucketId: this.id, eventNotificationRules: rules },\n    )\n  }\n\n  /**\n   * Updates the file retention policy for a specific file version. Requires file lock on the bucket.\n   * @param fileName - The file path of the version to update.\n   * @param fileId - The unique identifier of the file version.\n   * @param retention - The new retention policy to apply.\n   * @param options - Optional flags. Set `bypassGovernance: true` to shorten governance-mode retention.\n   *\n   * @returns The updated file retention metadata.\n   */\n  async updateFileRetention(\n    fileName: string,\n    fileId: FileId,\n    retention: FileRetentionValue,\n    options?: { bypassGovernance?: boolean },\n  ) {\n    return this.client.raw.updateFileRetention(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      {\n        fileName,\n        fileId,\n        fileRetention: retention,\n        ...(options?.bypassGovernance !== undefined\n          ? { bypassGovernance: options.bypassGovernance }\n          : {}),\n      },\n    )\n  }\n\n  /**\n   * Updates the legal hold status for a specific file version. Requires file lock on the bucket.\n   * @param fileName - The file path of the version to update.\n   * @param fileId - The unique identifier of the file version.\n   * @param legalHold - The new legal hold status to apply.\n   *\n   * @returns The updated legal hold metadata.\n   */\n  async updateFileLegalHold(fileName: string, fileId: FileId, legalHold: LegalHoldValue) {\n    return this.client.raw.updateFileLegalHold(\n      this.client.accountInfo.getApiUrl(),\n      this.client.accountInfo.getAuthToken(),\n      { fileName, fileId, legalHold },\n    )\n  }\n\n  /**\n   * Refetches this bucket's metadata from B2 so callers operating on\n   * replication / lifecycle / retention configuration always start from the\n   * server-of-record state.\n   *\n   * Bucket configuration is monotonically revisioned by B2: B2 increments\n   * `revision` on every accepted update. The local {@link info} snapshot\n   * captured at construction time goes stale as soon as anyone else (or any\n   * prior `update()` call) mutates the bucket, so the ergonomic\n   * add/remove helpers below always refresh before composing the next\n   * `setX()` call. The result is that each helper is safe to call without\n   * the caller having to thread BucketInfo through their code.\n   *\n   * @returns Fresh {@link BucketInfo} for this bucket.\n   *\n   * @throws If the bucket no longer exists.\n   */\n  private async refresh(): Promise<BucketInfo> {\n    const fresh = await this.client.listBuckets({ bucketId: this.id })\n    const found = fresh[0]\n    if (!found) throw new Error(`Bucket ${this.id} not found`)\n    return found.info\n  }\n\n  /**\n   * Returns the current cross-region replication configuration, refetched\n   * from B2.\n   *\n   * Use this when you need to read replication state without composing a\n   * write. For add/remove flows the helper methods below handle the\n   * refresh-then-set sequence for you.\n   *\n   * @returns The current {@link ReplicationConfiguration}.\n   */\n  async getReplication(): Promise<ReplicationConfiguration> {\n    const fresh = await this.refresh()\n    return fresh.replicationConfiguration\n  }\n\n  /**\n   * Replaces this bucket's complete replication configuration.\n   * @param replication - The new configuration. Pass an empty source/destination\n   *   pair (`{ asReplicationSource: null, asReplicationDestination: null }`)\n   *   to clear replication entirely.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async setReplication(replication: ReplicationConfiguration): Promise<BucketInfo> {\n    return this.update({ replicationConfiguration: replication })\n  }\n\n  /**\n   * Adds (or replaces by `replicationRuleName`) a single replication rule\n   * on this bucket while leaving any other rules, the source key, and the\n   * destination key mapping untouched.\n   *\n   * When this is the very first source-side rule, `sourceApplicationKeyId`\n   * must be supplied to seed `asReplicationSource.sourceApplicationKeyId`;\n   * for subsequent calls the existing source key is reused unless the\n   * caller explicitly overrides it.\n   *\n   * @param rule - The replication rule to add or replace.\n   * @param options - Optional source application key ID override (or seed\n   *   when no source side exists yet).\n   *\n   * @returns The updated bucket metadata.\n   *\n   * @throws If no source-side replication exists yet and the caller did\n   *   not supply `sourceApplicationKeyId`.\n   */\n  async addReplicationRule(\n    rule: ReplicationRule,\n    options?: { sourceApplicationKeyId?: ApplicationKeyId },\n  ): Promise<BucketInfo> {\n    const current = (await this.refresh()).replicationConfiguration\n    const existingSource = current.asReplicationSource\n    const sourceKey = options?.sourceApplicationKeyId ?? existingSource?.sourceApplicationKeyId\n    if (!sourceKey) {\n      throw new Error(\n        'addReplicationRule: no existing source-side replication; pass options.sourceApplicationKeyId',\n      )\n    }\n    const existingRules = existingSource?.replicationRules ?? []\n    const without = existingRules.filter((r) => r.replicationRuleName !== rule.replicationRuleName)\n    return this.setReplication({\n      asReplicationSource: {\n        sourceApplicationKeyId: sourceKey,\n        replicationRules: [...without, rule],\n      },\n      asReplicationDestination: current.asReplicationDestination,\n    })\n  }\n\n  /**\n   * Removes a single replication rule by name. No-ops cleanly when the rule\n   * is not present (returns the unchanged-but-revision-bumped bucket info).\n   *\n   * @param replicationRuleName - Name of the rule to remove.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async removeReplicationRule(replicationRuleName: string): Promise<BucketInfo> {\n    const current = (await this.refresh()).replicationConfiguration\n    const existingSource = current.asReplicationSource\n    if (!existingSource) {\n      return this.setReplication(current)\n    }\n    const filtered = existingSource.replicationRules.filter(\n      (r) => r.replicationRuleName !== replicationRuleName,\n    )\n    return this.setReplication({\n      asReplicationSource: {\n        sourceApplicationKeyId: existingSource.sourceApplicationKeyId,\n        replicationRules: filtered,\n      },\n      asReplicationDestination: current.asReplicationDestination,\n    })\n  }\n\n  /**\n   * Returns the current lifecycle rules for this bucket, refetched from B2.\n   *\n   * @returns The current array of {@link LifecycleRule}s.\n   */\n  async getLifecycleRules(): Promise<readonly LifecycleRule[]> {\n    const fresh = await this.refresh()\n    return fresh.lifecycleRules\n  }\n\n  /**\n   * Replaces this bucket's lifecycle rules in their entirety.\n   * @param rules - The new rule set. Pass `[]` to remove all lifecycle\n   *   automation.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async setLifecycleRules(rules: readonly LifecycleRule[]): Promise<BucketInfo> {\n    return this.update({ lifecycleRules: [...rules] })\n  }\n\n  /**\n   * Adds (or replaces, matched by `fileNamePrefix`) a single lifecycle rule\n   * while leaving any other rules untouched.\n   *\n   * Matching on prefix mirrors B2's own data model: each unique prefix can\n   * have at most one rule, and a `b2_update_bucket` call that contains two\n   * rules with the same prefix is rejected. The helper enforces this for\n   * the caller.\n   *\n   * @param rule - The lifecycle rule to add or replace.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async addLifecycleRule(rule: LifecycleRule): Promise<BucketInfo> {\n    const current = await this.getLifecycleRules()\n    const without = current.filter((r) => r.fileNamePrefix !== rule.fileNamePrefix)\n    return this.setLifecycleRules([...without, rule])\n  }\n\n  /**\n   * Removes a single lifecycle rule by prefix. No-ops cleanly when the rule\n   * is not present.\n   *\n   * @param fileNamePrefix - The prefix of the rule to remove.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async removeLifecycleRule(fileNamePrefix: string): Promise<BucketInfo> {\n    const current = await this.getLifecycleRules()\n    return this.setLifecycleRules(current.filter((r) => r.fileNamePrefix !== fileNamePrefix))\n  }\n\n  /**\n   * Returns the current default Object Lock retention policy for new\n   * uploads to this bucket, refetched from B2.\n   *\n   * @returns The default {@link BucketRetentionPolicy} (which may be\n   *   `{ mode: 'none', period: null }` when Object Lock is enabled on the\n   *   bucket but no default is set).\n   */\n  async getDefaultRetention(): Promise<BucketRetentionPolicy> {\n    const fresh = await this.refresh()\n    return fresh.defaultRetention\n  }\n\n  /**\n   * Sets (or clears, by passing `{ mode: 'none', period: null }`) the\n   * default Object Lock retention policy applied to new uploads.\n   *\n   * Object Lock must already be enabled on the bucket. Buckets created\n   * without `fileLockEnabled: true` cannot accept a default retention\n   * policy and B2 will reject this call.\n   *\n   * @param policy - The new default retention policy.\n   *\n   * @returns The updated bucket metadata.\n   */\n  async setDefaultRetention(policy: BucketRetentionPolicy): Promise<BucketInfo> {\n    return this.update({ defaultRetention: policy })\n  }\n}\n"],"mappings":"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"}

package/dist/bucket.d.cts

@@ -1,8 +1,7 @@
 import { B2Client } from './client.js';
 import { DownloadResult, HeadResult } from './download/single.js';
+import { RetryOptions } from './http/retry.js';
 import { B2Object, DownloadCallOptions, HeadCallOptions } from './object.js';
-import { ProgressListener } from './streams/progress.js';
-import { ContentSource } from './streams/source.js';
 import { BucketInfo, BucketRetentionPolicy, BucketType, CorsRule, LifecycleRule } from './types/bucket.js';
 import { DownloadAuthorizationResponse } from './types/download.js';
 import { EncryptionSetting } from './types/encryption.js';
@@ -12,6 +11,8 @@ import { FileRetentionValue, LegalHoldValue } from './types/lock.js';
 import { EventNotificationRule, GetBucketNotificationRulesResponse } from './types/notifications.js';
 import { ReplicationConfiguration, ReplicationRule } from './types/replication.js';
 import { CancelLargeFileResponse, PartInfo, UnfinishedLargeFile } from './types/upload.js';
+import { CleanupFailureListener } from './upload/cancel.js';
+import { BucketUploadOptions } from './upload/options.js';
 import { PaginatorOptions } from './util/paginator.js';
 /** A target for bulk deletion: a file name and its specific version ID. */
 export interface DeleteTarget {
@@ -84,13 +85,15 @@ export declare class Bucket {
     /** Full bucket metadata as returned by the B2 API. */
     readonly info: BucketInfo;
     private readonly client;
+    private readonly uploadRetryOptions;
     /**
      * @param client - The parent B2Client instance.
      * @param info - The bucket metadata from the API.
+     * @param uploadRetryOptions - Resolved client upload retry defaults.
      *
      * @internal
      */
-    constructor(client: B2Client, info: BucketInfo);
+    constructor(client: B2Client, info: BucketInfo, uploadRetryOptions: RetryOptions);
     /**
      * Returns a {@link B2Object} handle for a specific file name in this bucket.
      * @param fileName - The file path within the bucket.
@@ -105,46 +108,7 @@ export declare class Bucket {
      *
      * @returns Metadata for the uploaded file version.
      */
-    upload(options: {
-        /** Destination file name (path) in the bucket. */
-        fileName: string;
-        /** Data source to upload. Use {@link BufferSource}, {@link BlobSource}, or {@link StreamSource}. */
-        source: ContentSource;
-        /** MIME type. Defaults to `"b2/x-auto"` (auto-detected 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 on the bucket). */
-        fileRetention?: FileRetentionValue;
-        /** Legal hold status for the file. */
-        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 consulted on the large-file path (source size
-         * greater than `recommendedPartSize`). On the small-file path this
-         * option is silently ignored. Sliceable sources only — `StreamSource`
-         * rejects resume because it can't replay parts.
-         */
-        resume?: boolean;
-        /**
-         * Resume into a specific large-file ID. Overrides the `resume`
-         * discovery path. The local `partSize` must match the server-side
-         * plan.
-         */
-        resumeFileId?: LargeFileId;
-    }): Promise<FileVersion>;
+    upload(options: BucketUploadOptions): Promise<FileVersion>;
     /**
      * Downloads a file from this bucket by name. Pass `method: 'HEAD'` in
      * `options` to fetch only the response headers (file metadata) without
@@ -196,6 +160,8 @@ export declare class Bucket {
         prefix?: string;
         /** Delimiter for virtual directory grouping (typically `"/"`). */
         delimiter?: string;
+        /** Optional abort signal for the listing request. */
+        signal?: AbortSignal;
     }): Promise<ListFileNamesResponse>;
     /**
      * Lists all file versions in this bucket, including hidden files.
@@ -217,6 +183,8 @@ export declare class Bucket {
         prefix?: string;
         /** Delimiter for virtual directory grouping. */
         delimiter?: string;
+        /** Optional abort signal for the listing request. */
+        signal?: AbortSignal;
     }): Promise<ListFileVersionsResponse>;
     /**
      * Async iterator that yields the latest visible version of every file in
@@ -312,10 +280,13 @@ export declare class Bucket {
     /**
      * Hides a file by creating a hide marker. The file remains in version history but is no longer visible in `listFileNames`.
      * @param fileName - The file path to hide.
+     * @param options - Optional request controls such as an abort signal.
      *
      * @returns Metadata for the newly created hide marker.
      */
-    hideFile(fileName: string): Promise<FileVersion>;
+    hideFile(fileName: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<FileVersion>;
     /**
      * Permanently deletes a specific file version. Both file name and file ID are required.
      *
@@ -327,10 +298,11 @@ export declare class Bucket {
      *
      * @param fileName - The file path of the version to delete.
      * @param fileId - The unique identifier of the file version to delete.
-     * @param options - Optional flag for bypassing governance retention.
+     * @param options - Optional governance and abort controls.
      */
     deleteFileVersion(fileName: string, fileId: FileId, options?: {
         bypassGovernance?: boolean;
+        signal?: AbortSignal;
     }): Promise<void>;
     /**
      * Cancels an in-progress large file upload so the partial parts are not
@@ -351,13 +323,15 @@ export declare class Bucket {
     listUnfinishedLargeFiles(options?: {
         /** Restrict results to files whose name starts with this prefix. */
         namePrefix?: string;
-        /** Start listing after this file ID (for pagination). */
+        /** Start listing at this file ID, inclusive (for pagination). */
         startFileId?: LargeFileId;
         /**
          * Maximum number of files to return per request (1-100). Forwarded
          * to the raw API's `maxFileCount` parameter.
          */
         pageSize?: number;
+        /** Abort signal for cancelling the list request. */
+        signal?: AbortSignal;
     }): Promise<import('./index.js').ListUnfinishedLargeFilesResponse>;
     /**
      * Deletes many file versions with bounded concurrency. Errors from individual
@@ -416,8 +390,17 @@ export declare class Bucket {
         contentType?: string;
         /** Override file info (only with `REPLACE` metadata directive). */
         fileInfo?: Record<string, string>;
-        /** Server-side encryption for the destination file. */
+        /**
+         * @deprecated Renamed to `destinationServerSideEncryption` for consistency with
+         * multipart copy. Still honored as a fallback when the new field is absent.
+         */
         serverSideEncryption?: EncryptionSetting;
+        /** Server-side encryption for the destination file. Preferred over `serverSideEncryption`. */
+        destinationServerSideEncryption?: EncryptionSetting;
+        /** SSE-C settings for the source if it was uploaded with SSE-C. */
+        sourceServerSideEncryption?: EncryptionSetting;
+        /** Optional abort signal for cancelling the copy request. */
+        signal?: AbortSignal;
     }): Promise<FileVersion>;
     /**
      * Copies a file via the server-side multipart protocol. Each part is copied
@@ -442,6 +425,11 @@ export declare class Bucket {
         destinationServerSideEncryption?: EncryptionSetting;
         /** SSE-C settings for the source if it was uploaded with SSE-C. */
         sourceServerSideEncryption?: EncryptionSetting;
+        /**
+         * Callback invoked if best-effort cancellation fails, or if cancellation is
+         * skipped because `b2_finish_large_file` may already have committed.
+         */
+        onCleanupFailure?: CleanupFailureListener;
         /** Part size in bytes. Defaults to the account's recommended part size. */
         partSize?: number;
         /**

package/dist/bucket.d.cts.map

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