@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/types/auth.d.cts

@@ -47,6 +47,14 @@ export declare const Capability: {
     readonly ReadBucketNotifications: "readBucketNotifications";
     /** Modify bucket event-notification rules. */
     readonly WriteBucketNotifications: "writeBucketNotifications";
+    /** Read bucket logging settings. */
+    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. */
@@ -73,13 +81,34 @@ export declare const Capability: {
  * from {@link Capability}.
  */
 export type Capability = (typeof Capability)[keyof typeof Capability];
+/** Bucket restriction entry returned by v4 `b2_authorize_account`. */
+export interface AllowedBucket {
+    /** Bucket ID the key can access. */
+    readonly id: BucketId;
+    /** Bucket name when available, or null when B2 does not include it. */
+    readonly name: string | null;
+}
 /** Describes the capabilities and scope restrictions of an authorized application key. */
 export interface AllowedInfo {
     /** List of capabilities granted to this key. */
     readonly capabilities: readonly Capability[];
-    /** Bucket ID this key is restricted to, or null if unrestricted. */
+    /** Bucket restrictions for v4 authorization, or null if unrestricted. */
+    readonly buckets: readonly AllowedBucket[] | null;
+    /**
+     * Bucket ID this key is restricted to when it has exactly one bucket, or null
+     * if unrestricted or multi-bucket.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `buckets`; use `buckets` instead.
+     */
     readonly bucketId: BucketId | null;
-    /** Bucket name this key is restricted to, or null if unrestricted. */
+    /**
+     * Bucket name this key is restricted to when it has exactly one bucket, or
+     * null if unrestricted, multi-bucket, or unknown.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `buckets`; use `buckets` instead.
+     */
     readonly bucketName: string | null;
     /** File name prefix this key is restricted to, or null if unrestricted. */
     readonly namePrefix: string | null;
@@ -90,15 +119,37 @@ export interface StorageApiInfo {
     readonly absoluteMinimumPartSize: number;
     /** Base URL for B2 API calls. */
     readonly apiUrl: string;
-    /** Bucket ID this key is restricted to, or null if unrestricted. */
+    /**
+     * Bucket ID this key is restricted to when it has exactly one bucket, or null
+     * if unrestricted or multi-bucket.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `allowed.buckets`; use `allowed.buckets` instead.
+     */
     readonly bucketId: BucketId | null;
-    /** Bucket name this key is restricted to, or null if unrestricted. */
+    /**
+     * Bucket name this key is restricted to when it has exactly one bucket, or
+     * null if unrestricted, multi-bucket, or unknown.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `allowed.buckets`; use `allowed.buckets` instead.
+     */
     readonly bucketName: string | null;
     /** Base URL for file downloads. */
     readonly downloadUrl: string;
-    /** Discriminator indicating this is storage API info. Always `'storageApi'`. */
+    /**
+     * Discriminator indicating this is storage API info. Always `'storageApi'`.
+     *
+     * @deprecated Removed from the v4 wire shape but normalized by the SDK for
+     * compatibility.
+     */
     readonly infoType: 'storageApi';
-    /** File name prefix this key is restricted to, or null if unrestricted. */
+    /**
+     * File name prefix this key is restricted to, or null if unrestricted.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `allowed.namePrefix`; use `allowed.namePrefix` instead.
+     */
     readonly namePrefix: string | null;
     /** Recommended part size for large file uploads, in bytes. */
     readonly recommendedPartSize: number;
@@ -122,8 +173,9 @@ export interface ApiInfo {
     readonly groupsApi?: GroupsApiInfo;
 }
 /**
- * Response from the `b2_authorize_account` API call.
- * Contains the authorization token and API endpoint URLs needed for subsequent requests.
+ * Normalized SDK-facing response from the `b2_authorize_account` API call.
+ * The SDK uses the v4 endpoint and preserves deprecated v3 compatibility
+ * aliases such as `storageApi.bucketId` and `allowed.bucketId`.
  */
 export interface AuthorizeAccountResponse {
     /** The account ID for the authorized account. */
@@ -144,7 +196,17 @@ export interface AuthorizeAccountRequest {
     readonly applicationKeyId: string;
     /** The application key secret. */
     readonly applicationKey: string;
-    /** Optional realm override (e.g., `'production'`, `'staging'`). Defaults to production. */
+    /**
+     * Optional realm override. Accepts a known realm-map key (`"production"` or
+     * `"staging"`) or a direct base URL. Custom HTTPS hosts are trusted with the
+     * application key during authorize, so never derive this value from untrusted
+     * input. URL values must use HTTPS, or loopback IP literal HTTP for local
+     * testing only; application-key credentials are sent unencrypted over
+     * loopback HTTP. Unsupported schemes, malformed URLs, non-URL strings,
+     * plaintext HTTP hostnames such as `localhost`, and non-loopback plaintext
+     * HTTP are rejected before credentials are sent. URL values must not include
+     * userinfo, query strings, or fragments. Defaults to production.
+     */
     readonly realm?: string;
 }
 //# sourceMappingURL=auth.d.ts.map

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

@@ -47,6 +47,14 @@ export declare const Capability: {
     readonly ReadBucketNotifications: "readBucketNotifications";
     /** Modify bucket event-notification rules. */
     readonly WriteBucketNotifications: "writeBucketNotifications";
+    /** Read bucket logging settings. */
+    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. */
@@ -73,13 +81,34 @@ export declare const Capability: {
  * from {@link Capability}.
  */
 export type Capability = (typeof Capability)[keyof typeof Capability];
+/** Bucket restriction entry returned by v4 `b2_authorize_account`. */
+export interface AllowedBucket {
+    /** Bucket ID the key can access. */
+    readonly id: BucketId;
+    /** Bucket name when available, or null when B2 does not include it. */
+    readonly name: string | null;
+}
 /** Describes the capabilities and scope restrictions of an authorized application key. */
 export interface AllowedInfo {
     /** List of capabilities granted to this key. */
     readonly capabilities: readonly Capability[];
-    /** Bucket ID this key is restricted to, or null if unrestricted. */
+    /** Bucket restrictions for v4 authorization, or null if unrestricted. */
+    readonly buckets: readonly AllowedBucket[] | null;
+    /**
+     * Bucket ID this key is restricted to when it has exactly one bucket, or null
+     * if unrestricted or multi-bucket.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `buckets`; use `buckets` instead.
+     */
     readonly bucketId: BucketId | null;
-    /** Bucket name this key is restricted to, or null if unrestricted. */
+    /**
+     * Bucket name this key is restricted to when it has exactly one bucket, or
+     * null if unrestricted, multi-bucket, or unknown.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `buckets`; use `buckets` instead.
+     */
     readonly bucketName: string | null;
     /** File name prefix this key is restricted to, or null if unrestricted. */
     readonly namePrefix: string | null;
@@ -90,15 +119,37 @@ export interface StorageApiInfo {
     readonly absoluteMinimumPartSize: number;
     /** Base URL for B2 API calls. */
     readonly apiUrl: string;
-    /** Bucket ID this key is restricted to, or null if unrestricted. */
+    /**
+     * Bucket ID this key is restricted to when it has exactly one bucket, or null
+     * if unrestricted or multi-bucket.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `allowed.buckets`; use `allowed.buckets` instead.
+     */
     readonly bucketId: BucketId | null;
-    /** Bucket name this key is restricted to, or null if unrestricted. */
+    /**
+     * Bucket name this key is restricted to when it has exactly one bucket, or
+     * null if unrestricted, multi-bucket, or unknown.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `allowed.buckets`; use `allowed.buckets` instead.
+     */
     readonly bucketName: string | null;
     /** Base URL for file downloads. */
     readonly downloadUrl: string;
-    /** Discriminator indicating this is storage API info. Always `'storageApi'`. */
+    /**
+     * Discriminator indicating this is storage API info. Always `'storageApi'`.
+     *
+     * @deprecated Removed from the v4 wire shape but normalized by the SDK for
+     * compatibility.
+     */
     readonly infoType: 'storageApi';
-    /** File name prefix this key is restricted to, or null if unrestricted. */
+    /**
+     * File name prefix this key is restricted to, or null if unrestricted.
+     *
+     * @deprecated The SDK normalizes this compatibility alias from v4
+     * `allowed.namePrefix`; use `allowed.namePrefix` instead.
+     */
     readonly namePrefix: string | null;
     /** Recommended part size for large file uploads, in bytes. */
     readonly recommendedPartSize: number;
@@ -122,8 +173,9 @@ export interface ApiInfo {
     readonly groupsApi?: GroupsApiInfo;
 }
 /**
- * Response from the `b2_authorize_account` API call.
- * Contains the authorization token and API endpoint URLs needed for subsequent requests.
+ * Normalized SDK-facing response from the `b2_authorize_account` API call.
+ * The SDK uses the v4 endpoint and preserves deprecated v3 compatibility
+ * aliases such as `storageApi.bucketId` and `allowed.bucketId`.
  */
 export interface AuthorizeAccountResponse {
     /** The account ID for the authorized account. */
@@ -144,7 +196,17 @@ export interface AuthorizeAccountRequest {
     readonly applicationKeyId: string;
     /** The application key secret. */
     readonly applicationKey: string;
-    /** Optional realm override (e.g., `'production'`, `'staging'`). Defaults to production. */
+    /**
+     * Optional realm override. Accepts a known realm-map key (`"production"` or
+     * `"staging"`) or a direct base URL. Custom HTTPS hosts are trusted with the
+     * application key during authorize, so never derive this value from untrusted
+     * input. URL values must use HTTPS, or loopback IP literal HTTP for local
+     * testing only; application-key credentials are sent unencrypted over
+     * loopback HTTP. Unsupported schemes, malformed URLs, non-URL strings,
+     * plaintext HTTP hostnames such as `localhost`, and non-loopback plaintext
+     * HTTP are rejected before credentials are sent. URL values must not include
+     * userinfo, query strings, or fragments. Defaults to production.
+     */
     readonly realm?: string;
 }
 //# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.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.js

@@ -1,58 +1,82 @@
-const Capability = {
-  /** List application keys. */
-  ListKeys: "listKeys",
-  /** Create new application keys. */
-  WriteKeys: "writeKeys",
-  /** Delete application keys. */
-  DeleteKeys: "deleteKeys",
-  /** List buckets (subject to key restrictions). */
-  ListBuckets: "listBuckets",
-  /** List bucket names without other metadata. */
-  ListAllBucketNames: "listAllBucketNames",
-  /** Read bucket settings. */
-  ReadBuckets: "readBuckets",
-  /** Create and update buckets. */
-  WriteBuckets: "writeBuckets",
-  /** Remove existing buckets from the account. */
-  DeleteBuckets: "deleteBuckets",
-  /** Read bucket-level Object Lock retention settings. */
-  ReadBucketRetentions: "readBucketRetentions",
-  /** Modify bucket-level Object Lock retention settings. */
-  WriteBucketRetentions: "writeBucketRetentions",
-  /** Read default bucket encryption settings. */
-  ReadBucketEncryption: "readBucketEncryption",
-  /** Modify default bucket encryption settings. */
-  WriteBucketEncryption: "writeBucketEncryption",
-  /** Read bucket replication configuration. */
-  ReadBucketReplications: "readBucketReplications",
-  /** Modify bucket replication configuration. */
-  WriteBucketReplications: "writeBucketReplications",
-  /** Read bucket event-notification rules. */
-  ReadBucketNotifications: "readBucketNotifications",
-  /** Modify bucket event-notification rules. */
-  WriteBucketNotifications: "writeBucketNotifications",
-  /** List file names and versions. */
-  ListFiles: "listFiles",
-  /** Download files. */
-  ReadFiles: "readFiles",
-  /** Mint download authorisation tokens. */
-  ShareFiles: "shareFiles",
-  /** Upload files. */
-  WriteFiles: "writeFiles",
-  /** Delete file versions. */
-  DeleteFiles: "deleteFiles",
-  /** Read per-file legal hold flags. */
-  ReadFileLegalHolds: "readFileLegalHolds",
-  /** Modify per-file legal hold flags. */
-  WriteFileLegalHolds: "writeFileLegalHolds",
-  /** Read per-file Object Lock retention settings. */
-  ReadFileRetentions: "readFileRetentions",
-  /** Modify per-file Object Lock retention settings. */
-  WriteFileRetentions: "writeFileRetentions",
-  /** Shorten governance-mode retention. */
-  BypassGovernance: "bypassGovernance"
+//#region src/types/auth.ts
+/**
+* Named constants for the B2 API capabilities that can be granted to an
+* application key. Each capability controls access to a specific set of
+* API operations.
+*
+* Use these when constructing the `capabilities` array for an application
+* key request, or when checking required capabilities via
+* `B2Client.hasCapabilities`.
+*
+* @example
+* ```ts
+* const check = client.hasCapabilities([Capability.WriteFiles, Capability.ReadFiles])
+* if (!check.ok) throw new Error(`missing: ${check.missing.join(', ')}`)
+* ```
+*/
+var Capability = {
+	/** List application keys. */
+	ListKeys: "listKeys",
+	/** Create new application keys. */
+	WriteKeys: "writeKeys",
+	/** Delete application keys. */
+	DeleteKeys: "deleteKeys",
+	/** List buckets (subject to key restrictions). */
+	ListBuckets: "listBuckets",
+	/** List bucket names without other metadata. */
+	ListAllBucketNames: "listAllBucketNames",
+	/** Read bucket settings. */
+	ReadBuckets: "readBuckets",
+	/** Create and update buckets. */
+	WriteBuckets: "writeBuckets",
+	/** Remove existing buckets from the account. */
+	DeleteBuckets: "deleteBuckets",
+	/** Read bucket-level Object Lock retention settings. */
+	ReadBucketRetentions: "readBucketRetentions",
+	/** Modify bucket-level Object Lock retention settings. */
+	WriteBucketRetentions: "writeBucketRetentions",
+	/** Read default bucket encryption settings. */
+	ReadBucketEncryption: "readBucketEncryption",
+	/** Modify default bucket encryption settings. */
+	WriteBucketEncryption: "writeBucketEncryption",
+	/** Read bucket replication configuration. */
+	ReadBucketReplications: "readBucketReplications",
+	/** Modify bucket replication configuration. */
+	WriteBucketReplications: "writeBucketReplications",
+	/** Read bucket event-notification rules. */
+	ReadBucketNotifications: "readBucketNotifications",
+	/** Modify bucket event-notification rules. */
+	WriteBucketNotifications: "writeBucketNotifications",
+	/** Read bucket logging settings. */
+	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. */
+	ReadFiles: "readFiles",
+	/** Mint download authorisation tokens. */
+	ShareFiles: "shareFiles",
+	/** Upload files. */
+	WriteFiles: "writeFiles",
+	/** Delete file versions. */
+	DeleteFiles: "deleteFiles",
+	/** Read per-file legal hold flags. */
+	ReadFileLegalHolds: "readFileLegalHolds",
+	/** Modify per-file legal hold flags. */
+	WriteFileLegalHolds: "writeFileLegalHolds",
+	/** Read per-file Object Lock retention settings. */
+	ReadFileRetentions: "readFileRetentions",
+	/** Modify per-file Object Lock retention settings. */
+	WriteFileRetentions: "writeFileRetentions",
+	/** Shorten governance-mode retention. */
+	BypassGovernance: "bypassGovernance"
 };
-export {
-  Capability
-};
-//# sourceMappingURL=auth.js.map
+//#endregion
+export { Capability };
+
+//# sourceMappingURL=auth.js.map

package/dist/types/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","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  /** 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/** 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 ID this key is restricted to, or null if unrestricted. */\n  readonly bucketId: BucketId | null\n  /** Bucket name this key is restricted to, or null if unrestricted. */\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  /** Bucket ID this key is restricted to, or null if unrestricted. */\n  readonly bucketId: BucketId | null\n  /** Bucket name this key is restricted to, or null if unrestricted. */\n  readonly bucketName: string | null\n  /** Base URL for file downloads. */\n  readonly downloadUrl: string\n  /** Discriminator indicating this is storage API info. Always `'storageApi'`. */\n  readonly infoType: 'storageApi'\n  /** File name prefix this key is restricted to, or null if unrestricted. */\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 * Response from the `b2_authorize_account` API call.\n * Contains the authorization token and API endpoint URLs needed for subsequent requests.\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  /** Optional realm override (e.g., `'production'`, `'staging'`). Defaults to production. */\n  readonly realm?: string\n}\n"],"names":[],"mappings":"AAiBO,MAAM,aAAa;AAAA;AAAA,EAExB,UAAU;AAAA;AAAA,EAEV,WAAW;AAAA;AAAA,EAEX,YAAY;AAAA;AAAA,EAEZ,aAAa;AAAA;AAAA,EAEb,oBAAoB;AAAA;AAAA,EAEpB,aAAa;AAAA;AAAA,EAEb,cAAc;AAAA;AAAA,EAEd,eAAe;AAAA;AAAA,EAEf,sBAAsB;AAAA;AAAA,EAEtB,uBAAuB;AAAA;AAAA,EAEvB,sBAAsB;AAAA;AAAA,EAEtB,uBAAuB;AAAA;AAAA,EAEvB,wBAAwB;AAAA;AAAA,EAExB,yBAAyB;AAAA;AAAA,EAEzB,yBAAyB;AAAA;AAAA,EAEzB,0BAA0B;AAAA;AAAA,EAE1B,WAAW;AAAA;AAAA,EAEX,WAAW;AAAA;AAAA,EAEX,YAAY;AAAA;AAAA,EAEZ,YAAY;AAAA;AAAA,EAEZ,aAAa;AAAA;AAAA,EAEb,oBAAoB;AAAA;AAAA,EAEpB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA,EAEpB,qBAAqB;AAAA;AAAA,EAErB,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,80 @@
+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 `bz_delete_computer` wire response is a JSON array of these objects.
+ *
+ * @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`.
+ *
+ * @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;;;;;;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"}

package/dist/types/backup.d.ts

@@ -0,0 +1,80 @@
+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 `bz_delete_computer` wire response is a JSON array of these objects.
+ *
+ * @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`.
+ *
+ * @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;;;;;;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"}