@backblaze-labs/b2-sdk 0.3.0 → 0.4.0

package/dist/sync/types.d.cts

@@ -1,5 +1,5 @@
 import { EncryptionSetting } from '../types/encryption.js';
-import { FileVersion } from '../types/file.js';
+import { FileVersion, ListedConcreteFileVersion } from '../types/file.js';
 import { SyncSha1State } from './sha1-metadata.js';
 /**
  * Strategy for comparing source and destination files.
@@ -17,6 +17,8 @@ export type CompareMode = 'modtime' | 'size' | 'sha1' | 'none';
 export type KeepMode = 'no-delete' | 'delete' | 'keep-days';
 /** Direction of a sync operation. */
 export type SyncDirection = 'local-to-b2' | 'b2-to-local' | 'b2-to-b2';
+/** Policy for child symlinks encountered by {@link LocalFolder} scans. */
+export type LocalSymlinkPolicy = 'skip' | 'follow';
 /**
  * Glob string or regular expression used to include or exclude sync paths.
  *
@@ -91,6 +93,13 @@ export interface SyncScanOptions extends SyncFilterOptions {
      * continuing toward unbounded heap growth. Defaults to the SDK scan limit.
      */
     readonly maxScanEntries?: number;
+    /**
+     * How the built-in local scanner handles child symlinks. Defaults to `'skip'`.
+     * `'follow'` only follows targets that resolve inside the configured root and skips repeated
+     * followed directory identities. Symlinked roots are still followed because the configured root
+     * is the scan boundary.
+     */
+    readonly localSymlinks?: LocalSymlinkPolicy;
 }
 /** Common metadata for a file discovered during a folder scan. */
 export interface SyncPath {
@@ -151,7 +160,7 @@ export interface B2SyncPath extends SyncPath {
     /** The most recent visible file version. */
     readonly selectedVersion: FileVersion;
     /** All versions of this file, sorted newest first. */
-    readonly allVersions: FileVersion[];
+    readonly allVersions: ListedConcreteFileVersion[];
 }
 /** Discriminated event types emitted during synchronization. */
 export type SyncEventType = 'upload-start' | 'upload-done' | 'download-start' | 'download-done' | 'copy-start' | 'copy-done' | 'hide' | 'delete-remote' | 'delete-local' | 'skip' | 'error' | 'compare';
@@ -162,7 +171,7 @@ export type SyncEventType = 'upload-start' | 'upload-done' | 'download-start' |
  */
 export type SyncActionEventType = 'upload-start' | 'upload-done' | 'download-start' | 'download-done' | 'copy-start' | 'copy-done' | 'hide' | 'delete-remote' | 'delete-local';
 /** Machine-readable reasons emitted with scanner and diagnostic skip events. */
-export type SyncSkipReason = 'outside-prefix' | 'unsafe-name' | 'local-unsafe-name' | 'relative-path-collision' | 'local-path-collision' | 'filesystem-error' | 'path-too-long-for-regexp' | 'scan-skip-overflow' | 'stale-download-partial';
+export type SyncSkipReason = 'outside-prefix' | 'unsafe-name' | 'local-unsafe-name' | 'relative-path-collision' | 'local-path-collision' | 'filesystem-error' | 'path-too-long-for-regexp' | 'scan-skip-overflow' | 'stale-download-partial' | 'local-symlink' | 'local-symlink-loop';
 /**
  * Per-action progress event (transfer or metadata change). All
  * action-event variants share the same shape; the `type` tag distinguishes
@@ -274,6 +283,13 @@ export interface SyncOptions extends SyncFilterOptions {
     readonly downloadIdleTimeoutMillis?: number;
     /** Maximum scanner entries retained before failing with a defined scan-limit error. */
     readonly maxScanEntries?: number;
+    /**
+     * How built-in local scans handle child symlinks. Defaults to `'skip'`.
+     * `'follow'` only follows targets that resolve inside the local root; B2-to-local syncs still
+     * skip child symlinks during destination scans so download/delete actions never target them.
+     * Symlinked roots are controlled separately by the sync root safety checks.
+     */
+    readonly localSymlinks?: LocalSymlinkPolicy;
     /** Optional provider for per-file encryption settings. */
     readonly encryptionProvider?: SyncEncryptionProvider;
 }

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

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

package/dist/sync/types.d.ts

@@ -1,5 +1,5 @@
 import { EncryptionSetting } from '../types/encryption.js';
-import { FileVersion } from '../types/file.js';
+import { FileVersion, ListedConcreteFileVersion } from '../types/file.js';
 import { SyncSha1State } from './sha1-metadata.js';
 /**
  * Strategy for comparing source and destination files.
@@ -17,6 +17,8 @@ export type CompareMode = 'modtime' | 'size' | 'sha1' | 'none';
 export type KeepMode = 'no-delete' | 'delete' | 'keep-days';
 /** Direction of a sync operation. */
 export type SyncDirection = 'local-to-b2' | 'b2-to-local' | 'b2-to-b2';
+/** Policy for child symlinks encountered by {@link LocalFolder} scans. */
+export type LocalSymlinkPolicy = 'skip' | 'follow';
 /**
  * Glob string or regular expression used to include or exclude sync paths.
  *
@@ -91,6 +93,13 @@ export interface SyncScanOptions extends SyncFilterOptions {
      * continuing toward unbounded heap growth. Defaults to the SDK scan limit.
      */
     readonly maxScanEntries?: number;
+    /**
+     * How the built-in local scanner handles child symlinks. Defaults to `'skip'`.
+     * `'follow'` only follows targets that resolve inside the configured root and skips repeated
+     * followed directory identities. Symlinked roots are still followed because the configured root
+     * is the scan boundary.
+     */
+    readonly localSymlinks?: LocalSymlinkPolicy;
 }
 /** Common metadata for a file discovered during a folder scan. */
 export interface SyncPath {
@@ -151,7 +160,7 @@ export interface B2SyncPath extends SyncPath {
     /** The most recent visible file version. */
     readonly selectedVersion: FileVersion;
     /** All versions of this file, sorted newest first. */
-    readonly allVersions: FileVersion[];
+    readonly allVersions: ListedConcreteFileVersion[];
 }
 /** Discriminated event types emitted during synchronization. */
 export type SyncEventType = 'upload-start' | 'upload-done' | 'download-start' | 'download-done' | 'copy-start' | 'copy-done' | 'hide' | 'delete-remote' | 'delete-local' | 'skip' | 'error' | 'compare';
@@ -162,7 +171,7 @@ export type SyncEventType = 'upload-start' | 'upload-done' | 'download-start' |
  */
 export type SyncActionEventType = 'upload-start' | 'upload-done' | 'download-start' | 'download-done' | 'copy-start' | 'copy-done' | 'hide' | 'delete-remote' | 'delete-local';
 /** Machine-readable reasons emitted with scanner and diagnostic skip events. */
-export type SyncSkipReason = 'outside-prefix' | 'unsafe-name' | 'local-unsafe-name' | 'relative-path-collision' | 'local-path-collision' | 'filesystem-error' | 'path-too-long-for-regexp' | 'scan-skip-overflow' | 'stale-download-partial';
+export type SyncSkipReason = 'outside-prefix' | 'unsafe-name' | 'local-unsafe-name' | 'relative-path-collision' | 'local-path-collision' | 'filesystem-error' | 'path-too-long-for-regexp' | 'scan-skip-overflow' | 'stale-download-partial' | 'local-symlink' | 'local-symlink-loop';
 /**
  * Per-action progress event (transfer or metadata change). All
  * action-event variants share the same shape; the `type` tag distinguishes
@@ -274,6 +283,13 @@ export interface SyncOptions extends SyncFilterOptions {
     readonly downloadIdleTimeoutMillis?: number;
     /** Maximum scanner entries retained before failing with a defined scan-limit error. */
     readonly maxScanEntries?: number;
+    /**
+     * How built-in local scans handle child symlinks. Defaults to `'skip'`.
+     * `'follow'` only follows targets that resolve inside the local root; B2-to-local syncs still
+     * skip child symlinks during destination scans so download/delete actions never target them.
+     * Symlinked roots are controlled separately by the sync root safety checks.
+     */
+    readonly localSymlinks?: LocalSymlinkPolicy;
     /** Optional provider for per-file encryption settings. */
     readonly encryptionProvider?: SyncEncryptionProvider;
 }

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

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

package/dist/types/backup.d.cts

@@ -59,7 +59,8 @@ export interface DeleteComputerRequest {
 /**
  * Single result element returned by `bz_delete_computer`.
  *
- * The `bz_delete_computer` wire response is a JSON array of these objects.
+ * The SDK models the `bz_delete_computer` wire response as a JSON array of
+ * these objects and keeps the simulator aligned with that array-shaped schema.
  *
  * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
  */
@@ -74,6 +75,10 @@ export interface DeleteComputerResult {
 /**
  * Array-shaped wire response from `bz_delete_computer`.
  *
+ * The apidocs response schema declares an array while its example shows a bare
+ * object; the raw client normalizes both wire shapes to this array type, and
+ * the simulator emits the array shape.
+ *
  * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
  */
 export type DeleteComputerResponse = readonly DeleteComputerResult[];

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

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/types/backup.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAA;IACrC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/types/backup.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAA;IACrC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,oBAAoB,EAAE,CAAA"}

package/dist/types/backup.d.ts

@@ -59,7 +59,8 @@ export interface DeleteComputerRequest {
 /**
  * Single result element returned by `bz_delete_computer`.
  *
- * The `bz_delete_computer` wire response is a JSON array of these objects.
+ * The SDK models the `bz_delete_computer` wire response as a JSON array of
+ * these objects and keeps the simulator aligned with that array-shaped schema.
  *
  * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
  */
@@ -74,6 +75,10 @@ export interface DeleteComputerResult {
 /**
  * Array-shaped wire response from `bz_delete_computer`.
  *
+ * The apidocs response schema declares an array while its example shows a bare
+ * object; the raw client normalizes both wire shapes to this array type, and
+ * the simulator emits the array shape.
+ *
  * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
  */
 export type DeleteComputerResponse = readonly DeleteComputerResult[];

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

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/types/backup.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAA;IACrC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/types/backup.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAA;IACrC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAC3C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,oBAAoB,EAAE,CAAA"}

package/dist/types/bucket.cjs

@@ -1,10 +1,6 @@
 //#region src/types/bucket.ts
 /**
-* Named constants for the bucket access level.
-*
-* The {@link BucketType} type alias is derived from the values of this
-* object, so the const is the single source of truth: adding a key here
-* automatically widens the type union.
+* Named constants for bucket types accepted by create/update bucket requests.
 *
 * @example
 * ```ts
@@ -21,6 +17,34 @@ var BucketType = {
 	/** B2-restricted bucket (e.g., for S3-compatible workflows). */
 	Restricted: "restricted"
 };
+/** Named constants for documented bucket response types known to the SDK. */
+var KnownBucketResponseType = {
+	...BucketType,
+	/** Response-only bucket type for buckets shared with the account. */
+	Shared: "shared"
+};
+/**
+* Named constants for option flags returned on buckets and application keys.
+*
+* B2 currently documents only the S3-compatible API option.
+*/
+var BucketKeyOption = { 
+/** Enables the S3-compatible API surface for the bucket or key. */
+S3: "s3" };
+/** Minimum UTF-8 byte length for each bucketInfo key. */
+var BUCKET_INFO_KEY_MIN_BYTES = 1;
+/** Maximum UTF-8 byte length for each bucketInfo key. */
+var BUCKET_INFO_KEY_MAX_BYTES = 50;
+/** Maximum aggregate UTF-8 byte length of all bucketInfo values. */
+var BUCKET_INFO_VALUES_MAX_BYTES = 1e4;
+/** Reserved bucketInfo key prefix used by Backblaze. */
+var BUCKET_INFO_RESERVED_PREFIX = "b2-";
+/**
+* BucketInfo keys must match this regular-expression source. B2 accepts
+* letters, digits, and these characters: `. _ ~ ! # $ % ^ & * ' | + -` plus the
+* backtick.
+*/
+var BUCKET_INFO_KEY_PATTERN = "^[A-Za-z0-9._`~!#$%^&*'|+-]+$";
 /**
 * Named constants for the B2 + S3 operations a CORS rule can permit.
 *
@@ -47,17 +71,48 @@ var CorsOperation = {
 	B2UploadFile: "b2_upload_file",
 	/** Native B2 multipart-part upload. */
 	B2UploadPart: "b2_upload_part",
-	/** S3-compatible DELETE. */
-	S3Delete: "s3_delete",
 	/** S3-compatible GET. */
 	S3Get: "s3_get",
-	/** S3-compatible HEAD. */
-	S3Head: "s3_head",
-	/** S3-compatible POST. */
+	/**
+	* S3-compatible POST.
+	*
+	* @deprecated B2 bucket CORS rules do not accept `s3_post`. This member is
+	* preserved so existing imports continue to compile. Use one of
+	* {@link CORS_ALLOWED_OPERATIONS} for newly validated bucket CORS rules.
+	*/
 	S3Post: "s3_post",
 	/** S3-compatible PUT. */
-	S3Put: "s3_put"
+	S3Put: "s3_put",
+	/** S3-compatible HEAD. */
+	S3Head: "s3_head",
+	/** S3-compatible DELETE. */
+	S3Delete: "s3_delete"
 };
+/** All CORS operations accepted by B2 bucket CORS rules. */
+var CORS_ALLOWED_OPERATIONS = [
+	CorsOperation.B2DownloadFileByName,
+	CorsOperation.B2DownloadFileById,
+	CorsOperation.B2UploadFile,
+	CorsOperation.B2UploadPart,
+	CorsOperation.S3Get,
+	CorsOperation.S3Put,
+	CorsOperation.S3Head,
+	CorsOperation.S3Delete
+];
+/** Maximum number of CORS rules allowed on a bucket. */
+var CORS_RULES_MAX_COUNT = 100;
+/** Minimum character length for a CORS rule name. */
+var CORS_RULE_NAME_MIN_LENGTH = 6;
+/** Maximum character length for a CORS rule name. */
+var CORS_RULE_NAME_MAX_LENGTH = 63;
+/** CORS rule names must match this regular-expression source. */
+var CORS_RULE_NAME_PATTERN = "^[A-Za-z0-9-]+$";
+/** Reserved CORS rule-name prefix used by Backblaze. */
+var CORS_RULE_NAME_RESERVED_PREFIX = "b2-";
+/** Exclusive UTF-8 byte-size ceiling for each CORS rule definition. */
+var CORS_RULE_MAX_BYTES = 1e3;
+/** Maximum accepted CORS preflight cache duration in seconds. */
+var CORS_MAX_AGE_SECONDS_MAX = 86400;
 /**
 * Named constants for the bucket-level Object Lock retention mode.
 *
@@ -73,8 +128,23 @@ var BucketRetentionMode = {
 	None: "none"
 };
 //#endregion
+exports.BUCKET_INFO_KEY_MAX_BYTES = BUCKET_INFO_KEY_MAX_BYTES;
+exports.BUCKET_INFO_KEY_MIN_BYTES = BUCKET_INFO_KEY_MIN_BYTES;
+exports.BUCKET_INFO_KEY_PATTERN = BUCKET_INFO_KEY_PATTERN;
+exports.BUCKET_INFO_RESERVED_PREFIX = BUCKET_INFO_RESERVED_PREFIX;
+exports.BUCKET_INFO_VALUES_MAX_BYTES = BUCKET_INFO_VALUES_MAX_BYTES;
+exports.BucketKeyOption = BucketKeyOption;
 exports.BucketRetentionMode = BucketRetentionMode;
 exports.BucketType = BucketType;
+exports.CORS_ALLOWED_OPERATIONS = CORS_ALLOWED_OPERATIONS;
+exports.CORS_MAX_AGE_SECONDS_MAX = CORS_MAX_AGE_SECONDS_MAX;
+exports.CORS_RULES_MAX_COUNT = CORS_RULES_MAX_COUNT;
+exports.CORS_RULE_MAX_BYTES = CORS_RULE_MAX_BYTES;
+exports.CORS_RULE_NAME_MAX_LENGTH = CORS_RULE_NAME_MAX_LENGTH;
+exports.CORS_RULE_NAME_MIN_LENGTH = CORS_RULE_NAME_MIN_LENGTH;
+exports.CORS_RULE_NAME_PATTERN = CORS_RULE_NAME_PATTERN;
+exports.CORS_RULE_NAME_RESERVED_PREFIX = CORS_RULE_NAME_RESERVED_PREFIX;
 exports.CorsOperation = CorsOperation;
+exports.KnownBucketResponseType = KnownBucketResponseType;
 
 //# sourceMappingURL=bucket.cjs.map

package/dist/types/bucket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bucket.cjs","names":[],"sources":["../../src/types/bucket.ts"],"sourcesContent":["import type { EncryptionSetting } from './encryption.ts'\nimport type { AccountId, BucketId } from './ids.ts'\nimport type { ReplicationConfiguration } from './replication.ts'\n\n/**\n * Named constants for the bucket access level.\n *\n * The {@link BucketType} type alias is derived from the values of this\n * object, so the const is the single source of truth: adding a key here\n * automatically widens the type union.\n *\n * @example\n * ```ts\n * await client.createBucket({ bucketName: 'my-app-logs', bucketType: BucketType.AllPrivate })\n * ```\n */\nexport const BucketType = {\n  /** Publicly downloadable without authentication. */\n  AllPublic: 'allPublic',\n  /** Requires a valid auth token to download. */\n  AllPrivate: 'allPrivate',\n  /** Internal snapshot bucket type, generally not user-created. */\n  Snapshot: 'snapshot',\n  /** B2-restricted bucket (e.g., for S3-compatible workflows). */\n  Restricted: 'restricted',\n} as const\n\n/** Access level for a B2 bucket. Derived from {@link BucketType}. */\nexport type BucketType = (typeof BucketType)[keyof typeof BucketType]\n\n/** Rule that automatically hides or deletes files after a specified number of days. */\nexport interface LifecycleRule {\n  /** Days after hiding before automatic deletion, or null to never auto-delete hidden files. */\n  readonly daysFromHidingToDeleting?: number | null\n  /** Days after upload before automatic hiding, or null to never auto-hide. */\n  readonly daysFromUploadingToHiding?: number | null\n  /** Days after starting before automatic cancellation of unfinished large files, or null to never auto-cancel. */\n  readonly daysFromStartingToCancelingUnfinishedLargeFiles?: number | null\n  /** File name prefix this rule applies to. Empty string matches all files. */\n  readonly fileNamePrefix: string\n}\n\n/**\n * Named constants for the B2 + S3 operations a CORS rule can permit.\n *\n * @example\n * ```ts\n * await bucket.update({\n *   corsRules: [{\n *     corsRuleName: 'browser-downloads',\n *     allowedOrigins: ['https://example.com'],\n *     allowedOperations: [CorsOperation.B2DownloadFileByName, CorsOperation.S3Get],\n *     allowedHeaders: null,\n *     exposeHeaders: null,\n *     maxAgeSeconds: 3600,\n *   }],\n * })\n * ```\n */\nexport const CorsOperation = {\n  /** Native B2 download-by-name request. */\n  B2DownloadFileByName: 'b2_download_file_by_name',\n  /** Native B2 download-by-id request. */\n  B2DownloadFileById: 'b2_download_file_by_id',\n  /** Native B2 small-file upload. */\n  B2UploadFile: 'b2_upload_file',\n  /** Native B2 multipart-part upload. */\n  B2UploadPart: 'b2_upload_part',\n  /** S3-compatible DELETE. */\n  S3Delete: 's3_delete',\n  /** S3-compatible GET. */\n  S3Get: 's3_get',\n  /** S3-compatible HEAD. */\n  S3Head: 's3_head',\n  /** S3-compatible POST. */\n  S3Post: 's3_post',\n  /** S3-compatible PUT. */\n  S3Put: 's3_put',\n} as const\n\n/**\n * A B2 or S3 operation that a CORS rule can permit. Derived from\n * {@link CorsOperation}.\n */\nexport type CorsOperation = (typeof CorsOperation)[keyof typeof CorsOperation]\n\n/** Cross-Origin Resource Sharing (CORS) rule for browser-based access to a bucket. */\nexport interface CorsRule {\n  /** Unique name identifying this CORS rule within the bucket. */\n  readonly corsRuleName: string\n  /** Origins allowed to make cross-origin requests (e.g., `'https://example.com'`). */\n  readonly allowedOrigins: readonly string[]\n  /** B2 and S3 operations permitted by this rule. */\n  readonly allowedOperations: readonly CorsOperation[]\n  /** Request headers allowed in preflight requests, or null if none are allowed. */\n  readonly allowedHeaders: readonly string[] | null\n  /** Response headers exposed to the browser, or null if none are exposed. */\n  readonly exposeHeaders: readonly string[] | null\n  /** Maximum time (in seconds) browsers may cache the preflight response. */\n  readonly maxAgeSeconds: number\n}\n\n/**\n * Named constants for the bucket-level Object Lock retention mode.\n *\n * Pair with {@link BucketRetentionPolicy} when setting a bucket's default\n * retention: `{ mode: BucketRetentionMode.Compliance, period: { duration: 30, unit: 'days' } }`.\n */\nexport const BucketRetentionMode = {\n  /** Files cannot be deleted or modified during the retention period, even by the account owner. */\n  Compliance: 'compliance',\n  /** Files cannot be deleted during retention except by callers with the `bypassGovernance` capability. */\n  Governance: 'governance',\n  /** No default retention is applied to new uploads. */\n  None: 'none',\n} as const\n\n/** Bucket-level Object Lock retention mode. Derived from {@link BucketRetentionMode}. */\nexport type BucketRetentionMode = (typeof BucketRetentionMode)[keyof typeof BucketRetentionMode]\n\n/** Duration and unit for a retention period. */\nexport interface RetentionPeriod {\n  /** Length of the retention period. */\n  readonly duration: number\n  /** Time unit for the retention period. */\n  readonly unit: 'days' | 'years'\n}\n\n/** Default Object Lock retention policy applied to new files in a bucket. */\nexport interface BucketRetentionPolicy {\n  /** Retention mode for the policy. */\n  readonly mode: BucketRetentionMode\n  /** Retention period, or null when mode is `'none'`. */\n  readonly period: RetentionPeriod | null\n}\n\n/**\n * Complete bucket metadata as returned by the B2 API.\n * Corresponds to the bucket object in responses from `b2_list_buckets`, `b2_create_bucket`, and `b2_update_bucket`.\n */\nexport interface BucketInfo {\n  /** Account that owns this bucket. */\n  readonly accountId: AccountId\n  /** Unique identifier for this bucket. */\n  readonly bucketId: BucketId\n  /** Globally unique name of this bucket. */\n  readonly bucketName: string\n  /** Access level of this bucket. */\n  readonly bucketType: BucketType\n  /** User-defined key-value metadata stored on the bucket. */\n  readonly bucketInfo: Record<string, string>\n  /** CORS rules configured on this bucket. */\n  readonly corsRules: readonly CorsRule[]\n  /** Default server-side encryption setting for new files in this bucket. */\n  readonly defaultServerSideEncryption: EncryptionSetting\n  /** File Lock configuration including authorization status and current settings. */\n  readonly fileLockConfiguration: {\n    /** Whether the caller is authorized to read file lock settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** File lock settings, or null if the caller lacks read authorization. */\n    readonly value: {\n      /** Whether Object Lock is enabled on this bucket. */\n      readonly isFileLockEnabled: boolean\n      /** Default retention policy for newly uploaded files. */\n      readonly defaultRetention: BucketRetentionPolicy\n    } | null\n  }\n  /** Lifecycle rules configured on this bucket. */\n  readonly lifecycleRules: readonly LifecycleRule[]\n  /** Set of options enabled on this bucket (e.g., `'s3'`). */\n  readonly options: readonly string[]\n  /** Monotonically increasing revision number, incremented on each bucket update. */\n  readonly revision: number\n  /** Default retention policy for newly uploaded files. */\n  readonly defaultRetention: BucketRetentionPolicy\n  /** Cross-region replication configuration for this bucket. */\n  readonly replicationConfiguration: ReplicationConfiguration\n}\n\n/**\n * Request parameters for the `b2_create_bucket` API call.\n */\nexport interface CreateBucketRequest {\n  /** Account that will own the new bucket. */\n  readonly accountId: AccountId\n  /** Globally unique name for the bucket. */\n  readonly bucketName: string\n  /** Access level for the bucket. */\n  readonly bucketType: BucketType\n  /** Optional user-defined key-value metadata. */\n  readonly bucketInfo?: Record<string, string>\n  /** Optional CORS rules. */\n  readonly corsRules?: readonly CorsRule[]\n  /** Optional default server-side encryption setting. */\n  readonly defaultServerSideEncryption?: EncryptionSetting\n  /** Optional default Object Lock retention policy. */\n  readonly defaultRetention?: BucketRetentionPolicy\n  /** Whether to enable Object Lock on the bucket. Cannot be changed after creation. */\n  readonly fileLockEnabled?: boolean\n  /** Optional lifecycle rules. */\n  readonly lifecycleRules?: readonly LifecycleRule[]\n  /** Optional replication configuration. */\n  readonly replicationConfiguration?: ReplicationConfiguration\n}\n\n/**\n * Request parameters for the `b2_update_bucket` API call.\n */\nexport interface UpdateBucketRequest {\n  /** Account that owns the bucket. */\n  readonly accountId: AccountId\n  /** ID of the bucket to update. */\n  readonly bucketId: BucketId\n  /** New access level for the bucket. */\n  readonly bucketType?: BucketType\n  /** Updated user-defined key-value metadata. Replaces all existing metadata. */\n  readonly bucketInfo?: Record<string, string>\n  /** Updated CORS rules. Replaces all existing rules. */\n  readonly corsRules?: readonly CorsRule[]\n  /** Updated default server-side encryption setting. */\n  readonly defaultServerSideEncryption?: EncryptionSetting\n  /** Updated default Object Lock retention policy. */\n  readonly defaultRetention?: BucketRetentionPolicy\n  /** Whether to enable Object Lock. Can only transition from disabled to enabled. */\n  readonly fileLockEnabled?: boolean\n  /** Updated lifecycle rules. Replaces all existing rules. */\n  readonly lifecycleRules?: readonly LifecycleRule[]\n  /** Updated replication configuration. */\n  readonly replicationConfiguration?: ReplicationConfiguration\n  /** Optimistic locking: only update if the bucket's current revision matches this value. */\n  readonly ifRevisionIs?: number\n}\n\n/**\n * Request parameters for the `b2_list_buckets` API call.\n */\nexport interface ListBucketsRequest {\n  /** Account whose buckets to list. */\n  readonly accountId: AccountId\n  /** Optional filter to return only the bucket with this ID. */\n  readonly bucketId?: BucketId\n  /** Optional filter to return only the bucket with this name. */\n  readonly bucketName?: string\n  /** Optional filter to return only buckets of these types. */\n  readonly bucketTypes?: readonly BucketType[]\n}\n\n/** Response from the `b2_list_buckets` API call. */\nexport interface ListBucketsResponse {\n  /** Array of buckets matching the request filters. */\n  readonly buckets: readonly BucketInfo[]\n}\n\n/**\n * Request parameters for the `b2_delete_bucket` API call.\n */\nexport interface DeleteBucketRequest {\n  /** Account that owns the bucket. */\n  readonly accountId: AccountId\n  /** ID of the bucket to delete. The bucket must be empty. */\n  readonly bucketId: BucketId\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,aAAa;;CAExB,WAAW;;CAEX,YAAY;;CAEZ,UAAU;;CAEV,YAAY;AACd;;;;;;;;;;;;;;;;;;AAkCA,IAAa,gBAAgB;;CAE3B,sBAAsB;;CAEtB,oBAAoB;;CAEpB,cAAc;;CAEd,cAAc;;CAEd,UAAU;;CAEV,OAAO;;CAEP,QAAQ;;CAER,QAAQ;;CAER,OAAO;AACT;;;;;;;AA8BA,IAAa,sBAAsB;;CAEjC,YAAY;;CAEZ,YAAY;;CAEZ,MAAM;AACR"}
+{"version":3,"file":"bucket.cjs","names":[],"sources":["../../src/types/bucket.ts"],"sourcesContent":["import type { NoEncryption, PublicEncryptionSetting, SseB2Setting } from './encryption.ts'\nimport type { AccountId, BucketId } from './ids.ts'\nimport type { ReplicationConfiguration } from './replication.ts'\n\n/**\n * Named constants for bucket types accepted by create/update bucket requests.\n *\n * @example\n * ```ts\n * await client.createBucket({ bucketName: 'my-app-logs', bucketType: BucketType.AllPrivate })\n * ```\n */\nexport const BucketType = {\n  /** Publicly downloadable without authentication. */\n  AllPublic: 'allPublic',\n  /** Requires a valid auth token to download. */\n  AllPrivate: 'allPrivate',\n  /** Internal snapshot bucket type, generally not user-created. */\n  Snapshot: 'snapshot',\n  /** B2-restricted bucket (e.g., for S3-compatible workflows). */\n  Restricted: 'restricted',\n} as const\n\n/** Bucket access levels accepted by B2 bucket create/update requests. */\nexport type BucketType = (typeof BucketType)[keyof typeof BucketType]\n\n/** Named constants for documented bucket response types known to the SDK. */\nexport const KnownBucketResponseType = {\n  ...BucketType,\n  /** Response-only bucket type for buckets shared with the account. */\n  Shared: 'shared',\n} as const\n\n/** Closed union of documented bucket response types known to the SDK. */\nexport type KnownBucketResponseType =\n  (typeof KnownBucketResponseType)[keyof typeof KnownBucketResponseType]\n\n/** Bucket type returned by B2 bucket responses, including future B2-added values. */\nexport type BucketResponseType = KnownBucketResponseType | (string & {})\n\n/**\n * Bucket type value accepted by `b2_list_buckets.bucketTypes`.\n *\n * This includes future B2-added strings, so TypeScript cannot statically exclude\n * the special `'all'` value from this open string type. Runtime validation still\n * enforces that `'all'` is only valid as `['all']` and that filters are non-empty.\n */\nexport type BucketListType = BucketResponseType\n\n/**\n * Bucket type filter accepted by `b2_list_buckets`.\n *\n * Use `['all']` by itself to request all bucket types. Other filters may include\n * documented response types such as `'shared'` and future B2-added type strings.\n * Because future bucket types are modeled as an open string, TypeScript cannot\n * reject empty arrays or mixed arrays containing `'all'`; B2 and the simulator\n * reject them at runtime.\n */\nexport type BucketTypesFilter = readonly ['all'] | readonly BucketListType[]\n\n/**\n * Named constants for option flags returned on buckets and application keys.\n *\n * B2 currently documents only the S3-compatible API option.\n */\nexport const BucketKeyOption = {\n  /** Enables the S3-compatible API surface for the bucket or key. */\n  S3: 's3',\n} as const\n\n/** Documented option flag returned on bucket and application key metadata. */\nexport type KnownBucketKeyOption = (typeof BucketKeyOption)[keyof typeof BucketKeyOption]\n\n/** Option flag returned on bucket and application key metadata, open to future B2-added strings. */\nexport type BucketKeyOption = KnownBucketKeyOption | (string & {})\n\n/** Minimum UTF-8 byte length for each bucketInfo key. */\nexport const BUCKET_INFO_KEY_MIN_BYTES = 1\n/** Maximum UTF-8 byte length for each bucketInfo key. */\nexport const BUCKET_INFO_KEY_MAX_BYTES = 50\n/** Maximum aggregate UTF-8 byte length of all bucketInfo values. */\nexport const BUCKET_INFO_VALUES_MAX_BYTES = 10_000\n/** Reserved bucketInfo key prefix used by Backblaze. */\nexport const BUCKET_INFO_RESERVED_PREFIX = 'b2-'\n/**\n * BucketInfo keys must match this regular-expression source. B2 accepts\n * letters, digits, and these characters: `. _ ~ ! # $ % ^ & * ' | + -` plus the\n * backtick.\n */\nexport const BUCKET_INFO_KEY_PATTERN = \"^[A-Za-z0-9._`~!#$%^&*'|+-]+$\"\n\n/** Rule that automatically hides or deletes files after a specified number of days. */\nexport interface LifecycleRule {\n  /** Days after hiding before automatic deletion, or null to never auto-delete hidden files. */\n  readonly daysFromHidingToDeleting?: number | null\n  /** Days after upload before automatic hiding, or null to never auto-hide. */\n  readonly daysFromUploadingToHiding?: number | null\n  /** Days after starting before automatic cancellation of unfinished large files, or null to never auto-cancel. */\n  readonly daysFromStartingToCancelingUnfinishedLargeFiles?: number | null\n  /** File name prefix this rule applies to. Empty string matches all files. */\n  readonly fileNamePrefix: string\n}\n\n/**\n * Named constants for the B2 + S3 operations a CORS rule can permit.\n *\n * @example\n * ```ts\n * await bucket.update({\n *   corsRules: [{\n *     corsRuleName: 'browser-downloads',\n *     allowedOrigins: ['https://example.com'],\n *     allowedOperations: [CorsOperation.B2DownloadFileByName, CorsOperation.S3Get],\n *     allowedHeaders: null,\n *     exposeHeaders: null,\n *     maxAgeSeconds: 3600,\n *   }],\n * })\n * ```\n */\nexport const CorsOperation = {\n  /** Native B2 download-by-name request. */\n  B2DownloadFileByName: 'b2_download_file_by_name',\n  /** Native B2 download-by-id request. */\n  B2DownloadFileById: 'b2_download_file_by_id',\n  /** Native B2 small-file upload. */\n  B2UploadFile: 'b2_upload_file',\n  /** Native B2 multipart-part upload. */\n  B2UploadPart: 'b2_upload_part',\n  /** S3-compatible GET. */\n  S3Get: 's3_get',\n  /**\n   * S3-compatible POST.\n   *\n   * @deprecated B2 bucket CORS rules do not accept `s3_post`. This member is\n   * preserved so existing imports continue to compile. Use one of\n   * {@link CORS_ALLOWED_OPERATIONS} for newly validated bucket CORS rules.\n   */\n  S3Post: 's3_post',\n  /** S3-compatible PUT. */\n  S3Put: 's3_put',\n  /** S3-compatible HEAD. */\n  S3Head: 's3_head',\n  /** S3-compatible DELETE. */\n  S3Delete: 's3_delete',\n} as const\n\n/**\n * A B2 or S3 operation that a CORS rule can permit. Derived from\n * {@link CorsOperation}.\n *\n * @remarks This includes the deprecated `s3_post` compatibility member. Use\n * {@link CorsAllowedOperation} for bucket CORS rules accepted by B2.\n */\nexport type CorsOperation = (typeof CorsOperation)[keyof typeof CorsOperation]\n\n/** All CORS operations accepted by B2 bucket CORS rules. */\nexport const CORS_ALLOWED_OPERATIONS = [\n  CorsOperation.B2DownloadFileByName,\n  CorsOperation.B2DownloadFileById,\n  CorsOperation.B2UploadFile,\n  CorsOperation.B2UploadPart,\n  CorsOperation.S3Get,\n  CorsOperation.S3Put,\n  CorsOperation.S3Head,\n  CorsOperation.S3Delete,\n] as const satisfies readonly CorsOperation[]\n\n/** B2 bucket CORS operation values accepted by validated CORS rules. */\nexport type CorsAllowedOperation = (typeof CORS_ALLOWED_OPERATIONS)[number]\n\n/** Maximum number of CORS rules allowed on a bucket. */\nexport const CORS_RULES_MAX_COUNT = 100\n/** Minimum character length for a CORS rule name. */\nexport const CORS_RULE_NAME_MIN_LENGTH = 6\n/** Maximum character length for a CORS rule name. */\nexport const CORS_RULE_NAME_MAX_LENGTH = 63\n/** CORS rule names must match this regular-expression source. */\nexport const CORS_RULE_NAME_PATTERN = '^[A-Za-z0-9-]+$'\n/** Reserved CORS rule-name prefix used by Backblaze. */\nexport const CORS_RULE_NAME_RESERVED_PREFIX = 'b2-'\n/** Exclusive UTF-8 byte-size ceiling for each CORS rule definition. */\nexport const CORS_RULE_MAX_BYTES = 1_000\n/** Maximum accepted CORS preflight cache duration in seconds. */\nexport const CORS_MAX_AGE_SECONDS_MAX = 86_400\n\n/**\n * Cross-Origin Resource Sharing (CORS) rule for browser-based access to a bucket.\n * A bucket may have up to {@link CORS_RULES_MAX_COUNT} rules, and each rule's\n * name, allowed origins, allowed operations, allowed headers, and exposed\n * headers must total less than {@link CORS_RULE_MAX_BYTES} UTF-8 bytes.\n */\nexport interface CorsRule {\n  /**\n   * Unique name identifying this CORS rule within the bucket.\n   * Must be 6-63 characters, match `[A-Za-z0-9-]`, and not start with `b2-`.\n   */\n  readonly corsRuleName: string\n  /**\n   * Origins allowed to make cross-origin requests (e.g., `'https://example.com'`).\n   * At least one origin is required.\n   */\n  readonly allowedOrigins: readonly string[]\n  /**\n   * B2 and S3 operations permitted by this rule.\n   * At least one operation is required, and every value must be from\n   * {@link CORS_ALLOWED_OPERATIONS}.\n   */\n  readonly allowedOperations: readonly CorsAllowedOperation[]\n  /**\n   * Request headers allowed in preflight requests, or null/omitted if none are allowed.\n   */\n  readonly allowedHeaders?: readonly string[] | null\n  /**\n   * Response headers exposed to the browser, or null/omitted if none are exposed.\n   */\n  readonly exposeHeaders?: readonly string[] | null\n  /** Maximum time (0-86400 seconds) browsers may cache the preflight response. */\n  readonly maxAgeSeconds: number\n}\n\n/**\n * Named constants for the bucket-level Object Lock retention mode.\n *\n * Pair with {@link BucketRetentionPolicy} when setting a bucket's default\n * retention: `{ mode: BucketRetentionMode.Compliance, period: { duration: 30, unit: 'days' } }`.\n */\nexport const BucketRetentionMode = {\n  /** Files cannot be deleted or modified during the retention period, even by the account owner. */\n  Compliance: 'compliance',\n  /** Files cannot be deleted during retention except by callers with the `bypassGovernance` capability. */\n  Governance: 'governance',\n  /** No default retention is applied to new uploads. */\n  None: 'none',\n} as const\n\n/** Bucket-level Object Lock retention mode. Derived from {@link BucketRetentionMode}. */\nexport type BucketRetentionMode = (typeof BucketRetentionMode)[keyof typeof BucketRetentionMode]\n\n/** Duration and unit for a retention period. */\nexport interface RetentionPeriod {\n  /** Length of the retention period. */\n  readonly duration: number\n  /** Time unit for the retention period. */\n  readonly unit: 'days' | 'years'\n}\n\n/** Default Object Lock retention policy applied to new files in a bucket. */\nexport interface BucketRetentionPolicy {\n  /** Retention mode for the policy. */\n  readonly mode: BucketRetentionMode\n  /** Retention period, or null when mode is `'none'`. */\n  readonly period: RetentionPeriod | null\n}\n\n/** B2 response shape for a bucket with no default Object Lock retention. */\nexport interface NoBucketDefaultRetention {\n  /** B2 returns null when no bucket default retention policy is configured. */\n  readonly mode: null\n  /** No retention period is configured. */\n  readonly period: null\n}\n\n/** Default Object Lock retention as returned in bucket metadata. */\nexport type BucketDefaultRetention = BucketRetentionPolicy | NoBucketDefaultRetention\n\n/** Cross-region replication settings as returned by readable B2 bucket metadata. */\nexport interface ReadableReplicationConfiguration {\n  /** Whether the caller is authorized to read replication settings. */\n  readonly isClientAuthorizedToRead: boolean\n  /** Replication settings, or null when none are configured or the caller is not authorized to read them. */\n  readonly value: ReplicationConfiguration | null\n}\n\n/** Bucket default server-side encryption setting returned by B2 bucket responses. */\nexport type BucketDefaultServerSideEncryption = PublicEncryptionSetting\n\n/** Bucket default server-side encryption setting accepted by B2 bucket requests. */\nexport type BucketDefaultServerSideEncryptionSetting = SseB2Setting | NoEncryption\n\n/**\n * Complete bucket metadata as returned by the B2 API.\n * Corresponds to the bucket object in responses from `b2_list_buckets`, `b2_create_bucket`, and `b2_update_bucket`.\n */\nexport interface BucketInfo {\n  /** Account that owns this bucket. */\n  readonly accountId: AccountId\n  /** Unique identifier for this bucket. */\n  readonly bucketId: BucketId\n  /** Globally unique name of this bucket. */\n  readonly bucketName: string\n  /** Access level or response-only type of this bucket. */\n  readonly bucketType: BucketResponseType\n  /** User-defined key-value metadata stored on the bucket. */\n  readonly bucketInfo: Record<string, string>\n  /** CORS rules configured on this bucket. */\n  readonly corsRules: readonly CorsRule[]\n  /** Default server-side encryption setting for new files in this bucket. */\n  readonly defaultServerSideEncryption: {\n    /** Whether the caller is authorized to read default server-side encryption settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** Default server-side encryption settings, or null if the caller lacks read authorization. */\n    readonly value: BucketDefaultServerSideEncryption | null\n  }\n  /** File Lock configuration including authorization status and current settings. */\n  readonly fileLockConfiguration: {\n    /** Whether the caller is authorized to read file lock settings. */\n    readonly isClientAuthorizedToRead: boolean\n    /** File lock settings, or null if the caller lacks read authorization. */\n    readonly value: {\n      /** Whether Object Lock is enabled on this bucket. */\n      readonly isFileLockEnabled: boolean\n      /** Default retention policy for newly uploaded files. */\n      readonly defaultRetention: BucketDefaultRetention\n    } | null\n  }\n  /** Lifecycle rules configured on this bucket. */\n  readonly lifecycleRules: readonly LifecycleRule[]\n  /** Set of options enabled on this bucket (e.g., {@link BucketKeyOption.S3}). */\n  readonly options: readonly BucketKeyOption[]\n  /** Monotonically increasing revision number, incremented on each bucket update. */\n  readonly revision: number\n  /** Cross-region replication configuration, filtered by caller authorization. */\n  readonly replicationConfiguration: ReadableReplicationConfiguration\n}\n\n/**\n * Request parameters for the `b2_create_bucket` API call.\n */\nexport interface CreateBucketRequest {\n  /** Account that will own the new bucket. */\n  readonly accountId: AccountId\n  /** Globally unique name for the bucket. */\n  readonly bucketName: string\n  /** Access level for the bucket. */\n  readonly bucketType: BucketType\n  /**\n   * Optional user-defined key-value metadata.\n   * Keys must be 1-50 UTF-8 bytes and must not start with `b2-`; the aggregate\n   * UTF-8 byte length of all values must be at most 10,000 bytes. Keys must\n   * match {@link BUCKET_INFO_KEY_PATTERN}. BucketInfo has no documented\n   * pair-count cap.\n   */\n  readonly bucketInfo?: Record<string, string>\n  /**\n   * Optional CORS rules.\n   * A bucket may have at most 100 rules. Each rule name must be unique, 6-63\n   * characters, match `[A-Za-z0-9-]`, and not start with `b2-`. Each rule's\n   * name, origins, operations, allowed headers, and exposed headers must total\n   * less than 1,000 UTF-8 bytes. `maxAgeSeconds` must be at most 86,400.\n   */\n  readonly corsRules?: readonly CorsRule[]\n  /** Optional default server-side encryption setting. */\n  readonly defaultServerSideEncryption?: BucketDefaultServerSideEncryptionSetting\n  /** Optional default Object Lock retention policy. */\n  readonly defaultRetention?: BucketRetentionPolicy\n  /** Whether to enable Object Lock on the bucket. Cannot be changed after creation. */\n  readonly fileLockEnabled?: boolean\n  /** Optional lifecycle rules. */\n  readonly lifecycleRules?: readonly LifecycleRule[]\n  /** Optional replication configuration. */\n  readonly replicationConfiguration?: ReplicationConfiguration\n}\n\n/**\n * Request parameters for the `b2_update_bucket` API call.\n */\nexport interface UpdateBucketRequest {\n  /** Account that owns the bucket. */\n  readonly accountId: AccountId\n  /** ID of the bucket to update. */\n  readonly bucketId: BucketId\n  /** New access level for the bucket. */\n  readonly bucketType?: BucketType\n  /**\n   * Updated user-defined key-value metadata. Replaces all existing metadata.\n   * Keys must be 1-50 UTF-8 bytes and must not start with `b2-`; the aggregate\n   * UTF-8 byte length of all values must be at most 10,000 bytes. Keys must\n   * match {@link BUCKET_INFO_KEY_PATTERN}. BucketInfo has no documented\n   * pair-count cap.\n   */\n  readonly bucketInfo?: Record<string, string>\n  /**\n   * Updated CORS rules. Replaces all existing rules.\n   * A bucket may have at most 100 rules. Each rule name must be unique, 6-63\n   * characters, match `[A-Za-z0-9-]`, and not start with `b2-`. Each rule's\n   * name, origins, operations, allowed headers, and exposed headers must total\n   * less than 1,000 UTF-8 bytes. `maxAgeSeconds` must be at most 86,400.\n   */\n  readonly corsRules?: readonly CorsRule[]\n  /** Updated default server-side encryption setting. */\n  readonly defaultServerSideEncryption?: BucketDefaultServerSideEncryptionSetting\n  /** Updated default Object Lock retention policy. */\n  readonly defaultRetention?: BucketRetentionPolicy\n  /** Whether to enable Object Lock. Can only transition from disabled to enabled. */\n  readonly fileLockEnabled?: boolean\n  /** Updated lifecycle rules. Replaces all existing rules. */\n  readonly lifecycleRules?: readonly LifecycleRule[]\n  /** Updated replication configuration. */\n  readonly replicationConfiguration?: ReplicationConfiguration\n  /** Optimistic locking: only update if the bucket's current revision matches this value. */\n  readonly ifRevisionIs?: number\n}\n\n/**\n * Request parameters for the `b2_list_buckets` API call.\n */\nexport interface ListBucketsRequest {\n  /** Account whose buckets to list. */\n  readonly accountId: AccountId\n  /** Optional filter to return only the bucket with this ID. */\n  readonly bucketId?: BucketId\n  /** Optional filter to return only the bucket with this name. */\n  readonly bucketName?: string\n  /** Optional filter to return only buckets of these types. */\n  readonly bucketTypes?: BucketTypesFilter\n}\n\n/** Response from the `b2_list_buckets` API call. */\nexport interface ListBucketsResponse {\n  /** Array of buckets matching the request filters. */\n  readonly buckets: readonly BucketInfo[]\n}\n\n/**\n * Request parameters for the `b2_delete_bucket` API call.\n */\nexport interface DeleteBucketRequest {\n  /** Account that owns the bucket. */\n  readonly accountId: AccountId\n  /** ID of the bucket to delete. The bucket must be empty. */\n  readonly bucketId: BucketId\n}\n"],"mappings":";;;;;;;;;AAYA,IAAa,aAAa;;CAExB,WAAW;;CAEX,YAAY;;CAEZ,UAAU;;CAEV,YAAY;AACd;;AAMA,IAAa,0BAA0B;CACrC,GAAG;;CAEH,QAAQ;AACV;;;;;;AAkCA,IAAa,kBAAkB;;AAE7B,IAAI,KACN;;AASA,IAAa,4BAA4B;;AAEzC,IAAa,4BAA4B;;AAEzC,IAAa,+BAA+B;;AAE5C,IAAa,8BAA8B;;;;;;AAM3C,IAAa,0BAA0B;;;;;;;;;;;;;;;;;;AA+BvC,IAAa,gBAAgB;;CAE3B,sBAAsB;;CAEtB,oBAAoB;;CAEpB,cAAc;;CAEd,cAAc;;CAEd,OAAO;;;;;;;;CAQP,QAAQ;;CAER,OAAO;;CAEP,QAAQ;;CAER,UAAU;AACZ;;AAYA,IAAa,0BAA0B;CACrC,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;AAChB;;AAMA,IAAa,uBAAuB;;AAEpC,IAAa,4BAA4B;;AAEzC,IAAa,4BAA4B;;AAEzC,IAAa,yBAAyB;;AAEtC,IAAa,iCAAiC;;AAE9C,IAAa,sBAAsB;;AAEnC,IAAa,2BAA2B;;;;;;;AA2CxC,IAAa,sBAAsB;;CAEjC,YAAY;;CAEZ,YAAY;;CAEZ,MAAM;AACR"}