@backblaze-labs/b2-sdk 0.2.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/auth.cjs

@@ -51,6 +51,10 @@ var Capability = {
 	ReadBucketLogging: "readBucketLogging",
 	/** Modify bucket logging settings. */
 	WriteBucketLogging: "writeBucketLogging",
+	/** Read bucket lifecycle rule settings. */
+	ReadBucketLifecycleRules: "readBucketLifecycleRules",
+	/** Modify bucket lifecycle rule settings. */
+	WriteBucketLifecycleRules: "writeBucketLifecycleRules",
 	/** List file names and versions. */
 	ListFiles: "listFiles",
 	/** Download files. */

package/dist/types/auth.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"auth.cjs","names":[],"sources":["../../src/types/auth.ts"],"sourcesContent":["import type { AccountId, AuthToken, BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 API capabilities that can be granted to an\n * application key. Each capability controls access to a specific set of\n * API operations.\n *\n * Use these when constructing the `capabilities` array for an application\n * key request, or when checking required capabilities via\n * `B2Client.hasCapabilities`.\n *\n * @example\n * ```ts\n * const check = client.hasCapabilities([Capability.WriteFiles, Capability.ReadFiles])\n * if (!check.ok) throw new Error(`missing: ${check.missing.join(', ')}`)\n * ```\n */\nexport const Capability = {\n  /** List application keys. */\n  ListKeys: 'listKeys',\n  /** Create new application keys. */\n  WriteKeys: 'writeKeys',\n  /** Delete application keys. */\n  DeleteKeys: 'deleteKeys',\n  /** List buckets (subject to key restrictions). */\n  ListBuckets: 'listBuckets',\n  /** List bucket names without other metadata. */\n  ListAllBucketNames: 'listAllBucketNames',\n  /** Read bucket settings. */\n  ReadBuckets: 'readBuckets',\n  /** Create and update buckets. */\n  WriteBuckets: 'writeBuckets',\n  /** Remove existing buckets from the account. */\n  DeleteBuckets: 'deleteBuckets',\n  /** Read bucket-level Object Lock retention settings. */\n  ReadBucketRetentions: 'readBucketRetentions',\n  /** Modify bucket-level Object Lock retention settings. */\n  WriteBucketRetentions: 'writeBucketRetentions',\n  /** Read default bucket encryption settings. */\n  ReadBucketEncryption: 'readBucketEncryption',\n  /** Modify default bucket encryption settings. */\n  WriteBucketEncryption: 'writeBucketEncryption',\n  /** Read bucket replication configuration. */\n  ReadBucketReplications: 'readBucketReplications',\n  /** Modify bucket replication configuration. */\n  WriteBucketReplications: 'writeBucketReplications',\n  /** Read bucket event-notification rules. */\n  ReadBucketNotifications: 'readBucketNotifications',\n  /** Modify bucket event-notification rules. */\n  WriteBucketNotifications: 'writeBucketNotifications',\n  /** Read bucket logging settings. */\n  ReadBucketLogging: 'readBucketLogging',\n  /** Modify bucket logging settings. */\n  WriteBucketLogging: 'writeBucketLogging',\n  /** List file names and versions. */\n  ListFiles: 'listFiles',\n  /** Download files. */\n  ReadFiles: 'readFiles',\n  /** Mint download authorisation tokens. */\n  ShareFiles: 'shareFiles',\n  /** Upload files. */\n  WriteFiles: 'writeFiles',\n  /** Delete file versions. */\n  DeleteFiles: 'deleteFiles',\n  /** Read per-file legal hold flags. */\n  ReadFileLegalHolds: 'readFileLegalHolds',\n  /** Modify per-file legal hold flags. */\n  WriteFileLegalHolds: 'writeFileLegalHolds',\n  /** Read per-file Object Lock retention settings. */\n  ReadFileRetentions: 'readFileRetentions',\n  /** Modify per-file Object Lock retention settings. */\n  WriteFileRetentions: 'writeFileRetentions',\n  /** Shorten governance-mode retention. */\n  BypassGovernance: 'bypassGovernance',\n} as const\n\n/**\n * A B2 API capability that can be granted to an application key. Derived\n * from {@link Capability}.\n */\nexport type Capability = (typeof Capability)[keyof typeof Capability]\n\n/** Bucket restriction entry returned by v4 `b2_authorize_account`. */\nexport interface AllowedBucket {\n  /** Bucket ID the key can access. */\n  readonly id: BucketId\n  /** Bucket name when available, or null when B2 does not include it. */\n  readonly name: string | null\n}\n\n/** Describes the capabilities and scope restrictions of an authorized application key. */\nexport interface AllowedInfo {\n  /** List of capabilities granted to this key. */\n  readonly capabilities: readonly Capability[]\n  /** Bucket restrictions for v4 authorization, or null if unrestricted. */\n  readonly buckets: readonly AllowedBucket[] | null\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** File name prefix this key is restricted to, or null if unrestricted. */\n  readonly namePrefix: string | null\n}\n\n/** Configuration for the B2 Cloud Storage API returned during authorization. */\nexport interface StorageApiInfo {\n  /** Minimum allowed part size for large file uploads, in bytes. */\n  readonly absoluteMinimumPartSize: number\n  /** Base URL for B2 API calls. */\n  readonly apiUrl: string\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** Base URL for file downloads. */\n  readonly downloadUrl: string\n  /**\n   * Discriminator indicating this is storage API info. Always `'storageApi'`.\n   *\n   * @deprecated Removed from the v4 wire shape but normalized by the SDK for\n   * compatibility.\n   */\n  readonly infoType: 'storageApi'\n  /**\n   * File name prefix this key is restricted to, or null if unrestricted.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.namePrefix`; use `allowed.namePrefix` instead.\n   */\n  readonly namePrefix: string | null\n  /** Recommended part size for large file uploads, in bytes. */\n  readonly recommendedPartSize: number\n  /** Base URL for the S3-compatible API. */\n  readonly s3ApiUrl: string\n  /** Capabilities and scope of the authorized key. */\n  readonly allowed: AllowedInfo\n}\n\n/** Configuration for the B2 Groups API returned during authorization. */\nexport interface GroupsApiInfo {\n  /** Base URL for Groups API calls. */\n  readonly groupsApiUrl: string\n  /** Discriminator indicating this is groups API info. Always `'groupsApi'`. */\n  readonly infoType: 'groupsApi'\n}\n\n/** Container for all API-specific configuration returned by `b2_authorize_account`. */\nexport interface ApiInfo {\n  /** Storage API configuration (always present). */\n  readonly storageApi: StorageApiInfo\n  /** Groups API configuration (present only when the account has groups enabled). */\n  readonly groupsApi?: GroupsApiInfo\n}\n\n/**\n * Normalized SDK-facing response from the `b2_authorize_account` API call.\n * The SDK uses the v4 endpoint and preserves deprecated v3 compatibility\n * aliases such as `storageApi.bucketId` and `allowed.bucketId`.\n */\nexport interface AuthorizeAccountResponse {\n  /** The account ID for the authorized account. */\n  readonly accountId: AccountId\n  /** Authorization token to use in subsequent API calls. */\n  readonly authorizationToken: AuthToken\n  /** API-specific configuration including endpoint URLs and key scope. */\n  readonly apiInfo: ApiInfo\n  /** Expiration timestamp of the application key in milliseconds, or null if the key does not expire. */\n  readonly applicationKeyExpirationTimestamp: number | null\n}\n\n/**\n * Request parameters for the `b2_authorize_account` API call.\n * Credentials are sent via HTTP Basic auth in the raw API, but represented here as fields.\n */\nexport interface AuthorizeAccountRequest {\n  /** The application key ID (account ID or app key ID). */\n  readonly applicationKeyId: string\n  /** The application key secret. */\n  readonly applicationKey: string\n  /**\n   * Optional realm override. Accepts a known realm-map key (`\"production\"` or\n   * `\"staging\"`) or a direct base URL. Custom HTTPS hosts are trusted with the\n   * application key during authorize, so never derive this value from untrusted\n   * input. URL values must use HTTPS, or loopback IP literal HTTP for local\n   * testing only; application-key credentials are sent unencrypted over\n   * loopback HTTP. Unsupported schemes, malformed URLs, non-URL strings,\n   * plaintext HTTP hostnames such as `localhost`, and non-loopback plaintext\n   * HTTP are rejected before credentials are sent. URL values must not include\n   * userinfo, query strings, or fragments. Defaults to production.\n   */\n  readonly realm?: string\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,IAAa,aAAa;;CAExB,UAAU;;CAEV,WAAW;;CAEX,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,aAAa;;CAEb,cAAc;;CAEd,eAAe;;CAEf,sBAAsB;;CAEtB,uBAAuB;;CAEvB,sBAAsB;;CAEtB,uBAAuB;;CAEvB,wBAAwB;;CAExB,yBAAyB;;CAEzB,yBAAyB;;CAEzB,0BAA0B;;CAE1B,mBAAmB;;CAEnB,oBAAoB;;CAEpB,WAAW;;CAEX,WAAW;;CAEX,YAAY;;CAEZ,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,qBAAqB;;CAErB,oBAAoB;;CAEpB,qBAAqB;;CAErB,kBAAkB;AACpB"}
+{"version":3,"file":"auth.cjs","names":[],"sources":["../../src/types/auth.ts"],"sourcesContent":["import type { AccountId, AuthToken, BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 API capabilities that can be granted to an\n * application key. Each capability controls access to a specific set of\n * API operations.\n *\n * Use these when constructing the `capabilities` array for an application\n * key request, or when checking required capabilities via\n * `B2Client.hasCapabilities`.\n *\n * @example\n * ```ts\n * const check = client.hasCapabilities([Capability.WriteFiles, Capability.ReadFiles])\n * if (!check.ok) throw new Error(`missing: ${check.missing.join(', ')}`)\n * ```\n */\nexport const Capability = {\n  /** List application keys. */\n  ListKeys: 'listKeys',\n  /** Create new application keys. */\n  WriteKeys: 'writeKeys',\n  /** Delete application keys. */\n  DeleteKeys: 'deleteKeys',\n  /** List buckets (subject to key restrictions). */\n  ListBuckets: 'listBuckets',\n  /** List bucket names without other metadata. */\n  ListAllBucketNames: 'listAllBucketNames',\n  /** Read bucket settings. */\n  ReadBuckets: 'readBuckets',\n  /** Create and update buckets. */\n  WriteBuckets: 'writeBuckets',\n  /** Remove existing buckets from the account. */\n  DeleteBuckets: 'deleteBuckets',\n  /** Read bucket-level Object Lock retention settings. */\n  ReadBucketRetentions: 'readBucketRetentions',\n  /** Modify bucket-level Object Lock retention settings. */\n  WriteBucketRetentions: 'writeBucketRetentions',\n  /** Read default bucket encryption settings. */\n  ReadBucketEncryption: 'readBucketEncryption',\n  /** Modify default bucket encryption settings. */\n  WriteBucketEncryption: 'writeBucketEncryption',\n  /** Read bucket replication configuration. */\n  ReadBucketReplications: 'readBucketReplications',\n  /** Modify bucket replication configuration. */\n  WriteBucketReplications: 'writeBucketReplications',\n  /** Read bucket event-notification rules. */\n  ReadBucketNotifications: 'readBucketNotifications',\n  /** Modify bucket event-notification rules. */\n  WriteBucketNotifications: 'writeBucketNotifications',\n  /** Read bucket logging settings. */\n  ReadBucketLogging: 'readBucketLogging',\n  /** Modify bucket logging settings. */\n  WriteBucketLogging: 'writeBucketLogging',\n  /** Read bucket lifecycle rule settings. */\n  ReadBucketLifecycleRules: 'readBucketLifecycleRules',\n  /** Modify bucket lifecycle rule settings. */\n  WriteBucketLifecycleRules: 'writeBucketLifecycleRules',\n  /** List file names and versions. */\n  ListFiles: 'listFiles',\n  /** Download files. */\n  ReadFiles: 'readFiles',\n  /** Mint download authorisation tokens. */\n  ShareFiles: 'shareFiles',\n  /** Upload files. */\n  WriteFiles: 'writeFiles',\n  /** Delete file versions. */\n  DeleteFiles: 'deleteFiles',\n  /** Read per-file legal hold flags. */\n  ReadFileLegalHolds: 'readFileLegalHolds',\n  /** Modify per-file legal hold flags. */\n  WriteFileLegalHolds: 'writeFileLegalHolds',\n  /** Read per-file Object Lock retention settings. */\n  ReadFileRetentions: 'readFileRetentions',\n  /** Modify per-file Object Lock retention settings. */\n  WriteFileRetentions: 'writeFileRetentions',\n  /** Shorten governance-mode retention. */\n  BypassGovernance: 'bypassGovernance',\n} as const\n\n/**\n * A B2 API capability that can be granted to an application key. Derived\n * from {@link Capability}.\n */\nexport type Capability = (typeof Capability)[keyof typeof Capability]\n\n/** Bucket restriction entry returned by v4 `b2_authorize_account`. */\nexport interface AllowedBucket {\n  /** Bucket ID the key can access. */\n  readonly id: BucketId\n  /** Bucket name when available, or null when B2 does not include it. */\n  readonly name: string | null\n}\n\n/** Describes the capabilities and scope restrictions of an authorized application key. */\nexport interface AllowedInfo {\n  /** List of capabilities granted to this key. */\n  readonly capabilities: readonly Capability[]\n  /** Bucket restrictions for v4 authorization, or null if unrestricted. */\n  readonly buckets: readonly AllowedBucket[] | null\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** File name prefix this key is restricted to, or null if unrestricted. */\n  readonly namePrefix: string | null\n}\n\n/** Configuration for the B2 Cloud Storage API returned during authorization. */\nexport interface StorageApiInfo {\n  /** Minimum allowed part size for large file uploads, in bytes. */\n  readonly absoluteMinimumPartSize: number\n  /** Base URL for B2 API calls. */\n  readonly apiUrl: string\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** Base URL for file downloads. */\n  readonly downloadUrl: string\n  /**\n   * Discriminator indicating this is storage API info. Always `'storageApi'`.\n   *\n   * @deprecated Removed from the v4 wire shape but normalized by the SDK for\n   * compatibility.\n   */\n  readonly infoType: 'storageApi'\n  /**\n   * File name prefix this key is restricted to, or null if unrestricted.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.namePrefix`; use `allowed.namePrefix` instead.\n   */\n  readonly namePrefix: string | null\n  /** Recommended part size for large file uploads, in bytes. */\n  readonly recommendedPartSize: number\n  /** Base URL for the S3-compatible API. */\n  readonly s3ApiUrl: string\n  /** Capabilities and scope of the authorized key. */\n  readonly allowed: AllowedInfo\n}\n\n/** Configuration for the B2 Groups API returned during authorization. */\nexport interface GroupsApiInfo {\n  /** Base URL for Groups API calls. */\n  readonly groupsApiUrl: string\n  /** Discriminator indicating this is groups API info. Always `'groupsApi'`. */\n  readonly infoType: 'groupsApi'\n}\n\n/** Container for all API-specific configuration returned by `b2_authorize_account`. */\nexport interface ApiInfo {\n  /** Storage API configuration (always present). */\n  readonly storageApi: StorageApiInfo\n  /** Groups API configuration (present only when the account has groups enabled). */\n  readonly groupsApi?: GroupsApiInfo\n}\n\n/**\n * Normalized SDK-facing response from the `b2_authorize_account` API call.\n * The SDK uses the v4 endpoint and preserves deprecated v3 compatibility\n * aliases such as `storageApi.bucketId` and `allowed.bucketId`.\n */\nexport interface AuthorizeAccountResponse {\n  /** The account ID for the authorized account. */\n  readonly accountId: AccountId\n  /** Authorization token to use in subsequent API calls. */\n  readonly authorizationToken: AuthToken\n  /** API-specific configuration including endpoint URLs and key scope. */\n  readonly apiInfo: ApiInfo\n  /** Expiration timestamp of the application key in milliseconds, or null if the key does not expire. */\n  readonly applicationKeyExpirationTimestamp: number | null\n}\n\n/**\n * Request parameters for the `b2_authorize_account` API call.\n * Credentials are sent via HTTP Basic auth in the raw API, but represented here as fields.\n */\nexport interface AuthorizeAccountRequest {\n  /** The application key ID (account ID or app key ID). */\n  readonly applicationKeyId: string\n  /** The application key secret. */\n  readonly applicationKey: string\n  /**\n   * Optional realm override. Accepts a known realm-map key (`\"production\"` or\n   * `\"staging\"`) or a direct base URL. Custom HTTPS hosts are trusted with the\n   * application key during authorize, so never derive this value from untrusted\n   * input. URL values must use HTTPS, or loopback IP literal HTTP for local\n   * testing only; application-key credentials are sent unencrypted over\n   * loopback HTTP. Unsupported schemes, malformed URLs, non-URL strings,\n   * plaintext HTTP hostnames such as `localhost`, and non-loopback plaintext\n   * HTTP are rejected before credentials are sent. URL values must not include\n   * userinfo, query strings, or fragments. Defaults to production.\n   */\n  readonly realm?: string\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,IAAa,aAAa;;CAExB,UAAU;;CAEV,WAAW;;CAEX,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,aAAa;;CAEb,cAAc;;CAEd,eAAe;;CAEf,sBAAsB;;CAEtB,uBAAuB;;CAEvB,sBAAsB;;CAEtB,uBAAuB;;CAEvB,wBAAwB;;CAExB,yBAAyB;;CAEzB,yBAAyB;;CAEzB,0BAA0B;;CAE1B,mBAAmB;;CAEnB,oBAAoB;;CAEpB,0BAA0B;;CAE1B,2BAA2B;;CAE3B,WAAW;;CAEX,WAAW;;CAEX,YAAY;;CAEZ,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,qBAAqB;;CAErB,oBAAoB;;CAEpB,qBAAqB;;CAErB,kBAAkB;AACpB"}

package/dist/types/auth.d.cts

@@ -51,6 +51,10 @@ export declare const Capability: {
     readonly ReadBucketLogging: "readBucketLogging";
     /** Modify bucket logging settings. */
     readonly WriteBucketLogging: "writeBucketLogging";
+    /** Read bucket lifecycle rule settings. */
+    readonly ReadBucketLifecycleRules: "readBucketLifecycleRules";
+    /** Modify bucket lifecycle rule settings. */
+    readonly WriteBucketLifecycleRules: "writeBucketLifecycleRules";
     /** List file names and versions. */
     readonly ListFiles: "listFiles";
     /** Download files. */

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

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

package/dist/types/auth.d.ts

@@ -51,6 +51,10 @@ export declare const Capability: {
     readonly ReadBucketLogging: "readBucketLogging";
     /** Modify bucket logging settings. */
     readonly WriteBucketLogging: "writeBucketLogging";
+    /** Read bucket lifecycle rule settings. */
+    readonly ReadBucketLifecycleRules: "readBucketLifecycleRules";
+    /** Modify bucket lifecycle rule settings. */
+    readonly WriteBucketLifecycleRules: "writeBucketLifecycleRules";
     /** List file names and versions. */
     readonly ListFiles: "listFiles";
     /** Download files. */

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU;IACrB,6BAA6B;;IAE7B,mCAAmC;;IAEnC,+BAA+B;;IAE/B,kDAAkD;;IAElD,gDAAgD;;IAEhD,4BAA4B;;IAE5B,iCAAiC;;IAEjC,gDAAgD;;IAEhD,wDAAwD;;IAExD,0DAA0D;;IAE1D,+CAA+C;;IAE/C,iDAAiD;;IAEjD,6CAA6C;;IAE7C,+CAA+C;;IAE/C,4CAA4C;;IAE5C,8CAA8C;;IAE9C,oCAAoC;;IAEpC,sCAAsC;;IAEtC,oCAAoC;;IAEpC,sBAAsB;;IAEtB,0CAA0C;;IAE1C,oBAAoB;;IAEpB,4BAA4B;;IAE5B,sCAAsC;;IAEtC,wCAAwC;;IAExC,oDAAoD;;IAEpD,sDAAsD;;IAEtD,yCAAyC;;CAEjC,CAAA;AAEV;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAErE,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAA;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAA;IACjD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAA;IACxC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAC9B;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;CAC/B;AAED,uFAAuF;AACvF,MAAM,WAAW,OAAO;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;IACnC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAA;IACtC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,uGAAuG;IACvG,QAAQ,CAAC,iCAAiC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1D;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,kCAAkC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.js"],"names":[],"mappings":"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"}

package/dist/types/auth.js

@@ -51,6 +51,10 @@ var Capability = {
 	ReadBucketLogging: "readBucketLogging",
 	/** Modify bucket logging settings. */
 	WriteBucketLogging: "writeBucketLogging",
+	/** Read bucket lifecycle rule settings. */
+	ReadBucketLifecycleRules: "readBucketLifecycleRules",
+	/** Modify bucket lifecycle rule settings. */
+	WriteBucketLifecycleRules: "writeBucketLifecycleRules",
 	/** List file names and versions. */
 	ListFiles: "listFiles",
 	/** Download files. */

package/dist/types/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","names":[],"sources":["../../src/types/auth.ts"],"sourcesContent":["import type { AccountId, AuthToken, BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 API capabilities that can be granted to an\n * application key. Each capability controls access to a specific set of\n * API operations.\n *\n * Use these when constructing the `capabilities` array for an application\n * key request, or when checking required capabilities via\n * `B2Client.hasCapabilities`.\n *\n * @example\n * ```ts\n * const check = client.hasCapabilities([Capability.WriteFiles, Capability.ReadFiles])\n * if (!check.ok) throw new Error(`missing: ${check.missing.join(', ')}`)\n * ```\n */\nexport const Capability = {\n  /** List application keys. */\n  ListKeys: 'listKeys',\n  /** Create new application keys. */\n  WriteKeys: 'writeKeys',\n  /** Delete application keys. */\n  DeleteKeys: 'deleteKeys',\n  /** List buckets (subject to key restrictions). */\n  ListBuckets: 'listBuckets',\n  /** List bucket names without other metadata. */\n  ListAllBucketNames: 'listAllBucketNames',\n  /** Read bucket settings. */\n  ReadBuckets: 'readBuckets',\n  /** Create and update buckets. */\n  WriteBuckets: 'writeBuckets',\n  /** Remove existing buckets from the account. */\n  DeleteBuckets: 'deleteBuckets',\n  /** Read bucket-level Object Lock retention settings. */\n  ReadBucketRetentions: 'readBucketRetentions',\n  /** Modify bucket-level Object Lock retention settings. */\n  WriteBucketRetentions: 'writeBucketRetentions',\n  /** Read default bucket encryption settings. */\n  ReadBucketEncryption: 'readBucketEncryption',\n  /** Modify default bucket encryption settings. */\n  WriteBucketEncryption: 'writeBucketEncryption',\n  /** Read bucket replication configuration. */\n  ReadBucketReplications: 'readBucketReplications',\n  /** Modify bucket replication configuration. */\n  WriteBucketReplications: 'writeBucketReplications',\n  /** Read bucket event-notification rules. */\n  ReadBucketNotifications: 'readBucketNotifications',\n  /** Modify bucket event-notification rules. */\n  WriteBucketNotifications: 'writeBucketNotifications',\n  /** Read bucket logging settings. */\n  ReadBucketLogging: 'readBucketLogging',\n  /** Modify bucket logging settings. */\n  WriteBucketLogging: 'writeBucketLogging',\n  /** List file names and versions. */\n  ListFiles: 'listFiles',\n  /** Download files. */\n  ReadFiles: 'readFiles',\n  /** Mint download authorisation tokens. */\n  ShareFiles: 'shareFiles',\n  /** Upload files. */\n  WriteFiles: 'writeFiles',\n  /** Delete file versions. */\n  DeleteFiles: 'deleteFiles',\n  /** Read per-file legal hold flags. */\n  ReadFileLegalHolds: 'readFileLegalHolds',\n  /** Modify per-file legal hold flags. */\n  WriteFileLegalHolds: 'writeFileLegalHolds',\n  /** Read per-file Object Lock retention settings. */\n  ReadFileRetentions: 'readFileRetentions',\n  /** Modify per-file Object Lock retention settings. */\n  WriteFileRetentions: 'writeFileRetentions',\n  /** Shorten governance-mode retention. */\n  BypassGovernance: 'bypassGovernance',\n} as const\n\n/**\n * A B2 API capability that can be granted to an application key. Derived\n * from {@link Capability}.\n */\nexport type Capability = (typeof Capability)[keyof typeof Capability]\n\n/** Bucket restriction entry returned by v4 `b2_authorize_account`. */\nexport interface AllowedBucket {\n  /** Bucket ID the key can access. */\n  readonly id: BucketId\n  /** Bucket name when available, or null when B2 does not include it. */\n  readonly name: string | null\n}\n\n/** Describes the capabilities and scope restrictions of an authorized application key. */\nexport interface AllowedInfo {\n  /** List of capabilities granted to this key. */\n  readonly capabilities: readonly Capability[]\n  /** Bucket restrictions for v4 authorization, or null if unrestricted. */\n  readonly buckets: readonly AllowedBucket[] | null\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** File name prefix this key is restricted to, or null if unrestricted. */\n  readonly namePrefix: string | null\n}\n\n/** Configuration for the B2 Cloud Storage API returned during authorization. */\nexport interface StorageApiInfo {\n  /** Minimum allowed part size for large file uploads, in bytes. */\n  readonly absoluteMinimumPartSize: number\n  /** Base URL for B2 API calls. */\n  readonly apiUrl: string\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** Base URL for file downloads. */\n  readonly downloadUrl: string\n  /**\n   * Discriminator indicating this is storage API info. Always `'storageApi'`.\n   *\n   * @deprecated Removed from the v4 wire shape but normalized by the SDK for\n   * compatibility.\n   */\n  readonly infoType: 'storageApi'\n  /**\n   * File name prefix this key is restricted to, or null if unrestricted.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.namePrefix`; use `allowed.namePrefix` instead.\n   */\n  readonly namePrefix: string | null\n  /** Recommended part size for large file uploads, in bytes. */\n  readonly recommendedPartSize: number\n  /** Base URL for the S3-compatible API. */\n  readonly s3ApiUrl: string\n  /** Capabilities and scope of the authorized key. */\n  readonly allowed: AllowedInfo\n}\n\n/** Configuration for the B2 Groups API returned during authorization. */\nexport interface GroupsApiInfo {\n  /** Base URL for Groups API calls. */\n  readonly groupsApiUrl: string\n  /** Discriminator indicating this is groups API info. Always `'groupsApi'`. */\n  readonly infoType: 'groupsApi'\n}\n\n/** Container for all API-specific configuration returned by `b2_authorize_account`. */\nexport interface ApiInfo {\n  /** Storage API configuration (always present). */\n  readonly storageApi: StorageApiInfo\n  /** Groups API configuration (present only when the account has groups enabled). */\n  readonly groupsApi?: GroupsApiInfo\n}\n\n/**\n * Normalized SDK-facing response from the `b2_authorize_account` API call.\n * The SDK uses the v4 endpoint and preserves deprecated v3 compatibility\n * aliases such as `storageApi.bucketId` and `allowed.bucketId`.\n */\nexport interface AuthorizeAccountResponse {\n  /** The account ID for the authorized account. */\n  readonly accountId: AccountId\n  /** Authorization token to use in subsequent API calls. */\n  readonly authorizationToken: AuthToken\n  /** API-specific configuration including endpoint URLs and key scope. */\n  readonly apiInfo: ApiInfo\n  /** Expiration timestamp of the application key in milliseconds, or null if the key does not expire. */\n  readonly applicationKeyExpirationTimestamp: number | null\n}\n\n/**\n * Request parameters for the `b2_authorize_account` API call.\n * Credentials are sent via HTTP Basic auth in the raw API, but represented here as fields.\n */\nexport interface AuthorizeAccountRequest {\n  /** The application key ID (account ID or app key ID). */\n  readonly applicationKeyId: string\n  /** The application key secret. */\n  readonly applicationKey: string\n  /**\n   * Optional realm override. Accepts a known realm-map key (`\"production\"` or\n   * `\"staging\"`) or a direct base URL. Custom HTTPS hosts are trusted with the\n   * application key during authorize, so never derive this value from untrusted\n   * input. URL values must use HTTPS, or loopback IP literal HTTP for local\n   * testing only; application-key credentials are sent unencrypted over\n   * loopback HTTP. Unsupported schemes, malformed URLs, non-URL strings,\n   * plaintext HTTP hostnames such as `localhost`, and non-loopback plaintext\n   * HTTP are rejected before credentials are sent. URL values must not include\n   * userinfo, query strings, or fragments. Defaults to production.\n   */\n  readonly realm?: string\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,IAAa,aAAa;;CAExB,UAAU;;CAEV,WAAW;;CAEX,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,aAAa;;CAEb,cAAc;;CAEd,eAAe;;CAEf,sBAAsB;;CAEtB,uBAAuB;;CAEvB,sBAAsB;;CAEtB,uBAAuB;;CAEvB,wBAAwB;;CAExB,yBAAyB;;CAEzB,yBAAyB;;CAEzB,0BAA0B;;CAE1B,mBAAmB;;CAEnB,oBAAoB;;CAEpB,WAAW;;CAEX,WAAW;;CAEX,YAAY;;CAEZ,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,qBAAqB;;CAErB,oBAAoB;;CAEpB,qBAAqB;;CAErB,kBAAkB;AACpB"}
+{"version":3,"file":"auth.js","names":[],"sources":["../../src/types/auth.ts"],"sourcesContent":["import type { AccountId, AuthToken, BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 API capabilities that can be granted to an\n * application key. Each capability controls access to a specific set of\n * API operations.\n *\n * Use these when constructing the `capabilities` array for an application\n * key request, or when checking required capabilities via\n * `B2Client.hasCapabilities`.\n *\n * @example\n * ```ts\n * const check = client.hasCapabilities([Capability.WriteFiles, Capability.ReadFiles])\n * if (!check.ok) throw new Error(`missing: ${check.missing.join(', ')}`)\n * ```\n */\nexport const Capability = {\n  /** List application keys. */\n  ListKeys: 'listKeys',\n  /** Create new application keys. */\n  WriteKeys: 'writeKeys',\n  /** Delete application keys. */\n  DeleteKeys: 'deleteKeys',\n  /** List buckets (subject to key restrictions). */\n  ListBuckets: 'listBuckets',\n  /** List bucket names without other metadata. */\n  ListAllBucketNames: 'listAllBucketNames',\n  /** Read bucket settings. */\n  ReadBuckets: 'readBuckets',\n  /** Create and update buckets. */\n  WriteBuckets: 'writeBuckets',\n  /** Remove existing buckets from the account. */\n  DeleteBuckets: 'deleteBuckets',\n  /** Read bucket-level Object Lock retention settings. */\n  ReadBucketRetentions: 'readBucketRetentions',\n  /** Modify bucket-level Object Lock retention settings. */\n  WriteBucketRetentions: 'writeBucketRetentions',\n  /** Read default bucket encryption settings. */\n  ReadBucketEncryption: 'readBucketEncryption',\n  /** Modify default bucket encryption settings. */\n  WriteBucketEncryption: 'writeBucketEncryption',\n  /** Read bucket replication configuration. */\n  ReadBucketReplications: 'readBucketReplications',\n  /** Modify bucket replication configuration. */\n  WriteBucketReplications: 'writeBucketReplications',\n  /** Read bucket event-notification rules. */\n  ReadBucketNotifications: 'readBucketNotifications',\n  /** Modify bucket event-notification rules. */\n  WriteBucketNotifications: 'writeBucketNotifications',\n  /** Read bucket logging settings. */\n  ReadBucketLogging: 'readBucketLogging',\n  /** Modify bucket logging settings. */\n  WriteBucketLogging: 'writeBucketLogging',\n  /** Read bucket lifecycle rule settings. */\n  ReadBucketLifecycleRules: 'readBucketLifecycleRules',\n  /** Modify bucket lifecycle rule settings. */\n  WriteBucketLifecycleRules: 'writeBucketLifecycleRules',\n  /** List file names and versions. */\n  ListFiles: 'listFiles',\n  /** Download files. */\n  ReadFiles: 'readFiles',\n  /** Mint download authorisation tokens. */\n  ShareFiles: 'shareFiles',\n  /** Upload files. */\n  WriteFiles: 'writeFiles',\n  /** Delete file versions. */\n  DeleteFiles: 'deleteFiles',\n  /** Read per-file legal hold flags. */\n  ReadFileLegalHolds: 'readFileLegalHolds',\n  /** Modify per-file legal hold flags. */\n  WriteFileLegalHolds: 'writeFileLegalHolds',\n  /** Read per-file Object Lock retention settings. */\n  ReadFileRetentions: 'readFileRetentions',\n  /** Modify per-file Object Lock retention settings. */\n  WriteFileRetentions: 'writeFileRetentions',\n  /** Shorten governance-mode retention. */\n  BypassGovernance: 'bypassGovernance',\n} as const\n\n/**\n * A B2 API capability that can be granted to an application key. Derived\n * from {@link Capability}.\n */\nexport type Capability = (typeof Capability)[keyof typeof Capability]\n\n/** Bucket restriction entry returned by v4 `b2_authorize_account`. */\nexport interface AllowedBucket {\n  /** Bucket ID the key can access. */\n  readonly id: BucketId\n  /** Bucket name when available, or null when B2 does not include it. */\n  readonly name: string | null\n}\n\n/** Describes the capabilities and scope restrictions of an authorized application key. */\nexport interface AllowedInfo {\n  /** List of capabilities granted to this key. */\n  readonly capabilities: readonly Capability[]\n  /** Bucket restrictions for v4 authorization, or null if unrestricted. */\n  readonly buckets: readonly AllowedBucket[] | null\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `buckets`; use `buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** File name prefix this key is restricted to, or null if unrestricted. */\n  readonly namePrefix: string | null\n}\n\n/** Configuration for the B2 Cloud Storage API returned during authorization. */\nexport interface StorageApiInfo {\n  /** Minimum allowed part size for large file uploads, in bytes. */\n  readonly absoluteMinimumPartSize: number\n  /** Base URL for B2 API calls. */\n  readonly apiUrl: string\n  /**\n   * Bucket ID this key is restricted to when it has exactly one bucket, or null\n   * if unrestricted or multi-bucket.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketId: BucketId | null\n  /**\n   * Bucket name this key is restricted to when it has exactly one bucket, or\n   * null if unrestricted, multi-bucket, or unknown.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.buckets`; use `allowed.buckets` instead.\n   */\n  readonly bucketName: string | null\n  /** Base URL for file downloads. */\n  readonly downloadUrl: string\n  /**\n   * Discriminator indicating this is storage API info. Always `'storageApi'`.\n   *\n   * @deprecated Removed from the v4 wire shape but normalized by the SDK for\n   * compatibility.\n   */\n  readonly infoType: 'storageApi'\n  /**\n   * File name prefix this key is restricted to, or null if unrestricted.\n   *\n   * @deprecated The SDK normalizes this compatibility alias from v4\n   * `allowed.namePrefix`; use `allowed.namePrefix` instead.\n   */\n  readonly namePrefix: string | null\n  /** Recommended part size for large file uploads, in bytes. */\n  readonly recommendedPartSize: number\n  /** Base URL for the S3-compatible API. */\n  readonly s3ApiUrl: string\n  /** Capabilities and scope of the authorized key. */\n  readonly allowed: AllowedInfo\n}\n\n/** Configuration for the B2 Groups API returned during authorization. */\nexport interface GroupsApiInfo {\n  /** Base URL for Groups API calls. */\n  readonly groupsApiUrl: string\n  /** Discriminator indicating this is groups API info. Always `'groupsApi'`. */\n  readonly infoType: 'groupsApi'\n}\n\n/** Container for all API-specific configuration returned by `b2_authorize_account`. */\nexport interface ApiInfo {\n  /** Storage API configuration (always present). */\n  readonly storageApi: StorageApiInfo\n  /** Groups API configuration (present only when the account has groups enabled). */\n  readonly groupsApi?: GroupsApiInfo\n}\n\n/**\n * Normalized SDK-facing response from the `b2_authorize_account` API call.\n * The SDK uses the v4 endpoint and preserves deprecated v3 compatibility\n * aliases such as `storageApi.bucketId` and `allowed.bucketId`.\n */\nexport interface AuthorizeAccountResponse {\n  /** The account ID for the authorized account. */\n  readonly accountId: AccountId\n  /** Authorization token to use in subsequent API calls. */\n  readonly authorizationToken: AuthToken\n  /** API-specific configuration including endpoint URLs and key scope. */\n  readonly apiInfo: ApiInfo\n  /** Expiration timestamp of the application key in milliseconds, or null if the key does not expire. */\n  readonly applicationKeyExpirationTimestamp: number | null\n}\n\n/**\n * Request parameters for the `b2_authorize_account` API call.\n * Credentials are sent via HTTP Basic auth in the raw API, but represented here as fields.\n */\nexport interface AuthorizeAccountRequest {\n  /** The application key ID (account ID or app key ID). */\n  readonly applicationKeyId: string\n  /** The application key secret. */\n  readonly applicationKey: string\n  /**\n   * Optional realm override. Accepts a known realm-map key (`\"production\"` or\n   * `\"staging\"`) or a direct base URL. Custom HTTPS hosts are trusted with the\n   * application key during authorize, so never derive this value from untrusted\n   * input. URL values must use HTTPS, or loopback IP literal HTTP for local\n   * testing only; application-key credentials are sent unencrypted over\n   * loopback HTTP. Unsupported schemes, malformed URLs, non-URL strings,\n   * plaintext HTTP hostnames such as `localhost`, and non-loopback plaintext\n   * HTTP are rejected before credentials are sent. URL values must not include\n   * userinfo, query strings, or fragments. Defaults to production.\n   */\n  readonly realm?: string\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,IAAa,aAAa;;CAExB,UAAU;;CAEV,WAAW;;CAEX,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,aAAa;;CAEb,cAAc;;CAEd,eAAe;;CAEf,sBAAsB;;CAEtB,uBAAuB;;CAEvB,sBAAsB;;CAEtB,uBAAuB;;CAEvB,wBAAwB;;CAExB,yBAAyB;;CAEzB,yBAAyB;;CAEzB,0BAA0B;;CAE1B,mBAAmB;;CAEnB,oBAAoB;;CAEpB,0BAA0B;;CAE1B,2BAA2B;;CAE3B,WAAW;;CAEX,WAAW;;CAEX,YAAY;;CAEZ,YAAY;;CAEZ,aAAa;;CAEb,oBAAoB;;CAEpB,qBAAqB;;CAErB,oBAAoB;;CAEpB,qBAAqB;;CAErB,kBAAkB;AACpB"}

package/dist/types/backup.d.cts

@@ -0,0 +1,85 @@
+import { AccountId, ComputerId } from './ids.js';
+/**
+ * Request parameters for `bz_list_computers`.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ListComputersRequest {
+    /** Account ID whose active computer backups should be listed. */
+    readonly accountId: AccountId;
+    /** Computer ID to start listing from for pagination. */
+    readonly startComputerId?: ComputerId;
+    /** Maximum number of computers to return. The documented range is 1 through 500. */
+    readonly maxComputerCount?: number;
+}
+/**
+ * Computer Backup record returned by list and delete operations.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ComputerBackup {
+    /** Unique identifier for the computer backup. */
+    readonly computerId: ComputerId;
+    /** Name of the computer backup. */
+    readonly computerName: string;
+    /** Timestamp in milliseconds of the last file uploaded by the backup client. */
+    readonly lastFileUploadedTimestamp: number;
+}
+/**
+ * Result object returned by `bz_list_computers`.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ListComputersResult {
+    /** Next computer ID to use for pagination, or null if all computers have been listed. */
+    readonly nextComputerId: ComputerId | null;
+    /** Active computer backups matching the request. */
+    readonly computers: readonly ComputerBackup[];
+}
+/**
+ * Wire response from `bz_list_computers`.
+ *
+ * The `bz_list_computers` wire response is a single JSON object containing a
+ * pagination cursor and the list of computers.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export type ListComputersResponse = ListComputersResult;
+/**
+ * Request parameters for `bz_delete_computer`.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface DeleteComputerRequest {
+    /** Account ID that owns the computer backup. */
+    readonly accountId: AccountId;
+    /** Computer ID of the backup to delete. */
+    readonly computerId: ComputerId;
+}
+/**
+ * Single result element returned by `bz_delete_computer`.
+ *
+ * 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.
+ */
+export interface DeleteComputerResult {
+    /** Unique identifier for the deleted computer backup. */
+    readonly computerId: ComputerId;
+    /** Name of the deleted computer backup. */
+    readonly computerName: string;
+    /** Timestamp in milliseconds of the last file uploaded by the backup client. */
+    readonly lastFileUploadedTimestamp: number;
+}
+/**
+ * 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[];
+//# sourceMappingURL=backup.d.ts.map

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

@@ -0,0 +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;;;;;;;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

@@ -0,0 +1,85 @@
+import { AccountId, ComputerId } from './ids.js';
+/**
+ * Request parameters for `bz_list_computers`.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ListComputersRequest {
+    /** Account ID whose active computer backups should be listed. */
+    readonly accountId: AccountId;
+    /** Computer ID to start listing from for pagination. */
+    readonly startComputerId?: ComputerId;
+    /** Maximum number of computers to return. The documented range is 1 through 500. */
+    readonly maxComputerCount?: number;
+}
+/**
+ * Computer Backup record returned by list and delete operations.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ComputerBackup {
+    /** Unique identifier for the computer backup. */
+    readonly computerId: ComputerId;
+    /** Name of the computer backup. */
+    readonly computerName: string;
+    /** Timestamp in milliseconds of the last file uploaded by the backup client. */
+    readonly lastFileUploadedTimestamp: number;
+}
+/**
+ * Result object returned by `bz_list_computers`.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ListComputersResult {
+    /** Next computer ID to use for pagination, or null if all computers have been listed. */
+    readonly nextComputerId: ComputerId | null;
+    /** Active computer backups matching the request. */
+    readonly computers: readonly ComputerBackup[];
+}
+/**
+ * Wire response from `bz_list_computers`.
+ *
+ * The `bz_list_computers` wire response is a single JSON object containing a
+ * pagination cursor and the list of computers.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export type ListComputersResponse = ListComputersResult;
+/**
+ * Request parameters for `bz_delete_computer`.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface DeleteComputerRequest {
+    /** Account ID that owns the computer backup. */
+    readonly accountId: AccountId;
+    /** Computer ID of the backup to delete. */
+    readonly computerId: ComputerId;
+}
+/**
+ * Single result element returned by `bz_delete_computer`.
+ *
+ * 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.
+ */
+export interface DeleteComputerResult {
+    /** Unique identifier for the deleted computer backup. */
+    readonly computerId: ComputerId;
+    /** Name of the deleted computer backup. */
+    readonly computerName: string;
+    /** Timestamp in milliseconds of the last file uploaded by the backup client. */
+    readonly lastFileUploadedTimestamp: number;
+}
+/**
+ * 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[];
+//# sourceMappingURL=backup.d.ts.map

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

@@ -0,0 +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;;;;;;;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"}