@backblaze-labs/b2-sdk 0.2.0 → 0.3.0

package/dist/backup/client.d.cts

@@ -0,0 +1,238 @@
+import { RetryOptions } from '../http/retry.js';
+import { HttpTransport } from '../http/transport.js';
+import { UrlGuard } from '../http/url-guard.js';
+import { PartnerAccountInfo } from '../partner/account-info.js';
+import { ComputerBackup, DeleteComputerResponse, ListComputersResult } from '../types/backup.js';
+import { AccountId, ComputerId } from '../types/ids.js';
+import { PartnerAuthorizeResponse } from '../types/partner.js';
+import { BackupRawClient } from './raw.js';
+/**
+ * Configuration options for creating a {@link BackupClient}.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface BackupClientOptions {
+    /** The Master Application Key ID for the partner administrator account. */
+    readonly masterKeyId: string;
+    /** The Master Application Key secret. */
+    readonly masterKey: string;
+    /**
+     * B2 realm to authenticate against. Accepts a known realm-map key
+     * (`"production"` or `"staging"`) or a direct base URL. Custom HTTPS hosts
+     * and loopback IP literal HTTP URLs for local testing are trusted with the
+     * Master Application Key during Partner authorize, so never derive `realm`
+     * from untrusted input. Defaults to `"production"`.
+     */
+    readonly realm?: string;
+    /**
+     * Shared Partner authorization state. Defaults to
+     * {@link InMemoryPartnerAccountInfo}. Pass the same store to
+     * {@link BackupClient} and Partner clients when both surfaces should reuse
+     * one Partner token. Cached authorization whose endpoints fail this client's
+     * realm policy is ignored locally until `authorize()` replaces it; shared
+     * stores are not cleared during construction.
+     */
+    readonly partnerAccountInfo?: PartnerAccountInfo;
+    /** Custom HTTP transport. Defaults to `FetchTransport`. Wrapped by `RetryTransport`. */
+    readonly transport?: HttpTransport;
+    /** Override retry behavior (max retries, backoff, and per-attempt timeout). */
+    readonly retry?: Partial<RetryOptions>;
+    /** Custom user-agent string prepended to the SDK default. */
+    readonly userAgent?: string;
+    /**
+     * Additional SSRF allow-list host suffixes for the default transport.
+     *
+     * Only consulted when {@link BackupClientOptions.transport} is unset; a
+     * custom transport is the user's responsibility to harden.
+     */
+    readonly additionalAllowedHostSuffixes?: readonly string[];
+    /**
+     * Explicitly disable the default SSRF guard after authorize.
+     *
+     * Intended only for controlled simulator/private-proxy tests. Never enable
+     * it for URLs derived from untrusted input or production credentials.
+     */
+    readonly disableSsrfGuard?: boolean;
+    /**
+     * Follow same-origin GET/HEAD redirects in the default fetch transport after
+     * checking each target with the SSRF guard. POST redirects remain blocked.
+     * Defaults to true.
+     */
+    readonly followSameOriginRedirects?: boolean;
+    /**
+     * Allow direct custom authorize realms for tests or private proxies.
+     * Leave disabled unless the configured host is trusted with the Master
+     * Application Key.
+     */
+    readonly allowCustomAuthorizeRealm?: boolean;
+}
+/**
+ * Options for Partner authorization performed by {@link BackupClient}.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface BackupAuthorizeOptions {
+    /** Abort signal for cancelling the authorize request. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for listing Computer Backup records.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ListComputersOptions {
+    /**
+     * Account whose active computer backups should be listed. Defaults to the
+     * partner administrator account ID from authorization.
+     */
+    readonly accountId?: AccountId;
+    /** Computer ID to start listing from for pagination. */
+    readonly startComputerId?: ComputerId;
+    /** Maximum computers to return in this page. Forwarded to `maxComputerCount`. */
+    readonly pageSize?: number;
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for paginating Computer Backup records.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface PaginateComputersOptions extends Omit<ListComputersOptions, 'startComputerId'> {
+    /**
+     * Aborts the iteration between page fetches. The signal is also forwarded to
+     * each underlying list request.
+     */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for deleting a Computer Backup record.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface DeleteComputerOptions {
+    /**
+     * Account that owns the computer backup. Defaults to the partner
+     * administrator account ID from authorization.
+     */
+    readonly accountId?: AccountId;
+    /** Computer ID of the backup to delete. */
+    readonly computerId: ComputerId;
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+}
+/** Redacted JSON diagnostic shape emitted by {@link BackupClient.toJSON}. */
+export interface BackupClientJson {
+    /** Object kind for log consumers. */
+    readonly type: 'BackupClient';
+    /** Redacted Master Application Key credential placeholder. */
+    readonly credentials: string;
+    /** Redacted Partner token placeholder, or unauthorized state. */
+    readonly authorization: string;
+    /** Whether this client currently has Partner authorization state. */
+    readonly authorized: boolean;
+    /** Current default URL guard suffixes, or null when a custom transport owns guarding. */
+    readonly urlGuardAllowedSuffixes: readonly string[] | null;
+}
+/**
+ * High-level Computer Backup API client for listing and deleting backup records.
+ *
+ * The client uses Partner authorization and the `backupApiUrl` returned by
+ * `authorizePartner`. The target account must belong to a group with
+ * Enterprise Controls enabled, and the caller must be a group admin. Deleting
+ * a backup also requires the Enterprise Controls setting that permits admins
+ * to delete member backups.
+ *
+ * @example
+ * ```ts
+ * const backup = new BackupClient({
+ *   masterKeyId: process.env.B2_MASTER_KEY_ID,
+ *   masterKey: process.env.B2_MASTER_KEY,
+ * })
+ * await backup.authorize()
+ * for await (const computer of backup.paginateComputers()) {
+ *   console.log(computer.computerName)
+ * }
+ * ```
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export declare class BackupClient {
+    /** Low-level client for direct Computer Backup API calls. */
+    readonly raw: BackupRawClient;
+    /** Partner authorization state storage (tokens, URLs, capabilities). */
+    readonly partnerAccountInfo: PartnerAccountInfo;
+    /**
+     * SSRF allow-list applied by the default transport. `null` when
+     * a custom transport was supplied; in that case the SDK does not own the
+     * guard.
+     */
+    readonly urlGuard: UrlGuard | null;
+    private readonly authCore;
+    /**
+     * Creates a new BackupClient. Call {@link authorize} before making API requests
+     * unless `partnerAccountInfo` already contains valid Partner authorization.
+     *
+     * @param options - Configuration including credentials, realm, and transport settings.
+     */
+    constructor(options: BackupClientOptions);
+    /**
+     * Authenticates with B2 Partner authorization and stores the authorization state.
+     *
+     * @param options - Optional abort signal.
+     *
+     * @returns The Partner authorization response containing tokens, URLs, and capabilities.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    authorize(options?: BackupAuthorizeOptions): Promise<PartnerAuthorizeResponse>;
+    /**
+     * Lists active Computer Backup records for an account.
+     *
+     * @param options - Optional target account and pagination settings.
+     *
+     * @returns A normalized page of computer backup records with an optional continuation cursor.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    listComputers(options?: ListComputersOptions): Promise<ListComputersResult>;
+    /**
+     * Async iterator that yields every active Computer Backup record for an account.
+     *
+     * @param options - Optional target account, page size, and abort signal.
+     *
+     * @returns An async iterable of {@link ComputerBackup} entries.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    paginateComputers(options?: PaginateComputersOptions): AsyncIterableIterator<ComputerBackup>;
+    /**
+     * Deletes a Computer Backup record.
+     *
+     * This destructive mutation is not automatically retried or reauthorized in
+     * place; callers should reconcile backup state before issuing a new delete
+     * after an ambiguous failure.
+     *
+     * @param options - Target account, computer ID, and optional abort signal.
+     *
+     * @returns The deleted computer backup record array.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    deleteComputer(options: DeleteComputerOptions): Promise<DeleteComputerResponse>;
+    private ensureBackupAuthorization;
+    private backupCoordinates;
+    /**
+     * Hides credentials and Partner tokens from `JSON.stringify(client)`.
+     *
+     * @returns A redacted diagnostic object.
+     */
+    toJSON(): BackupClientJson;
+    /**
+     * Hides credentials and Partner tokens from default stringification.
+     *
+     * @returns A short redacted label.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/backup/client.d.ts

@@ -0,0 +1,238 @@
+import { RetryOptions } from '../http/retry.js';
+import { HttpTransport } from '../http/transport.js';
+import { UrlGuard } from '../http/url-guard.js';
+import { PartnerAccountInfo } from '../partner/account-info.js';
+import { ComputerBackup, DeleteComputerResponse, ListComputersResult } from '../types/backup.js';
+import { AccountId, ComputerId } from '../types/ids.js';
+import { PartnerAuthorizeResponse } from '../types/partner.js';
+import { BackupRawClient } from './raw.js';
+/**
+ * Configuration options for creating a {@link BackupClient}.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface BackupClientOptions {
+    /** The Master Application Key ID for the partner administrator account. */
+    readonly masterKeyId: string;
+    /** The Master Application Key secret. */
+    readonly masterKey: string;
+    /**
+     * B2 realm to authenticate against. Accepts a known realm-map key
+     * (`"production"` or `"staging"`) or a direct base URL. Custom HTTPS hosts
+     * and loopback IP literal HTTP URLs for local testing are trusted with the
+     * Master Application Key during Partner authorize, so never derive `realm`
+     * from untrusted input. Defaults to `"production"`.
+     */
+    readonly realm?: string;
+    /**
+     * Shared Partner authorization state. Defaults to
+     * {@link InMemoryPartnerAccountInfo}. Pass the same store to
+     * {@link BackupClient} and Partner clients when both surfaces should reuse
+     * one Partner token. Cached authorization whose endpoints fail this client's
+     * realm policy is ignored locally until `authorize()` replaces it; shared
+     * stores are not cleared during construction.
+     */
+    readonly partnerAccountInfo?: PartnerAccountInfo;
+    /** Custom HTTP transport. Defaults to `FetchTransport`. Wrapped by `RetryTransport`. */
+    readonly transport?: HttpTransport;
+    /** Override retry behavior (max retries, backoff, and per-attempt timeout). */
+    readonly retry?: Partial<RetryOptions>;
+    /** Custom user-agent string prepended to the SDK default. */
+    readonly userAgent?: string;
+    /**
+     * Additional SSRF allow-list host suffixes for the default transport.
+     *
+     * Only consulted when {@link BackupClientOptions.transport} is unset; a
+     * custom transport is the user's responsibility to harden.
+     */
+    readonly additionalAllowedHostSuffixes?: readonly string[];
+    /**
+     * Explicitly disable the default SSRF guard after authorize.
+     *
+     * Intended only for controlled simulator/private-proxy tests. Never enable
+     * it for URLs derived from untrusted input or production credentials.
+     */
+    readonly disableSsrfGuard?: boolean;
+    /**
+     * Follow same-origin GET/HEAD redirects in the default fetch transport after
+     * checking each target with the SSRF guard. POST redirects remain blocked.
+     * Defaults to true.
+     */
+    readonly followSameOriginRedirects?: boolean;
+    /**
+     * Allow direct custom authorize realms for tests or private proxies.
+     * Leave disabled unless the configured host is trusted with the Master
+     * Application Key.
+     */
+    readonly allowCustomAuthorizeRealm?: boolean;
+}
+/**
+ * Options for Partner authorization performed by {@link BackupClient}.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface BackupAuthorizeOptions {
+    /** Abort signal for cancelling the authorize request. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for listing Computer Backup records.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface ListComputersOptions {
+    /**
+     * Account whose active computer backups should be listed. Defaults to the
+     * partner administrator account ID from authorization.
+     */
+    readonly accountId?: AccountId;
+    /** Computer ID to start listing from for pagination. */
+    readonly startComputerId?: ComputerId;
+    /** Maximum computers to return in this page. Forwarded to `maxComputerCount`. */
+    readonly pageSize?: number;
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for paginating Computer Backup records.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface PaginateComputersOptions extends Omit<ListComputersOptions, 'startComputerId'> {
+    /**
+     * Aborts the iteration between page fetches. The signal is also forwarded to
+     * each underlying list request.
+     */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for deleting a Computer Backup record.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export interface DeleteComputerOptions {
+    /**
+     * Account that owns the computer backup. Defaults to the partner
+     * administrator account ID from authorization.
+     */
+    readonly accountId?: AccountId;
+    /** Computer ID of the backup to delete. */
+    readonly computerId: ComputerId;
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+}
+/** Redacted JSON diagnostic shape emitted by {@link BackupClient.toJSON}. */
+export interface BackupClientJson {
+    /** Object kind for log consumers. */
+    readonly type: 'BackupClient';
+    /** Redacted Master Application Key credential placeholder. */
+    readonly credentials: string;
+    /** Redacted Partner token placeholder, or unauthorized state. */
+    readonly authorization: string;
+    /** Whether this client currently has Partner authorization state. */
+    readonly authorized: boolean;
+    /** Current default URL guard suffixes, or null when a custom transport owns guarding. */
+    readonly urlGuardAllowedSuffixes: readonly string[] | null;
+}
+/**
+ * High-level Computer Backup API client for listing and deleting backup records.
+ *
+ * The client uses Partner authorization and the `backupApiUrl` returned by
+ * `authorizePartner`. The target account must belong to a group with
+ * Enterprise Controls enabled, and the caller must be a group admin. Deleting
+ * a backup also requires the Enterprise Controls setting that permits admins
+ * to delete member backups.
+ *
+ * @example
+ * ```ts
+ * const backup = new BackupClient({
+ *   masterKeyId: process.env.B2_MASTER_KEY_ID,
+ *   masterKey: process.env.B2_MASTER_KEY,
+ * })
+ * await backup.authorize()
+ * for await (const computer of backup.paginateComputers()) {
+ *   console.log(computer.computerName)
+ * }
+ * ```
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export declare class BackupClient {
+    /** Low-level client for direct Computer Backup API calls. */
+    readonly raw: BackupRawClient;
+    /** Partner authorization state storage (tokens, URLs, capabilities). */
+    readonly partnerAccountInfo: PartnerAccountInfo;
+    /**
+     * SSRF allow-list applied by the default transport. `null` when
+     * a custom transport was supplied; in that case the SDK does not own the
+     * guard.
+     */
+    readonly urlGuard: UrlGuard | null;
+    private readonly authCore;
+    /**
+     * Creates a new BackupClient. Call {@link authorize} before making API requests
+     * unless `partnerAccountInfo` already contains valid Partner authorization.
+     *
+     * @param options - Configuration including credentials, realm, and transport settings.
+     */
+    constructor(options: BackupClientOptions);
+    /**
+     * Authenticates with B2 Partner authorization and stores the authorization state.
+     *
+     * @param options - Optional abort signal.
+     *
+     * @returns The Partner authorization response containing tokens, URLs, and capabilities.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    authorize(options?: BackupAuthorizeOptions): Promise<PartnerAuthorizeResponse>;
+    /**
+     * Lists active Computer Backup records for an account.
+     *
+     * @param options - Optional target account and pagination settings.
+     *
+     * @returns A normalized page of computer backup records with an optional continuation cursor.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    listComputers(options?: ListComputersOptions): Promise<ListComputersResult>;
+    /**
+     * Async iterator that yields every active Computer Backup record for an account.
+     *
+     * @param options - Optional target account, page size, and abort signal.
+     *
+     * @returns An async iterable of {@link ComputerBackup} entries.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    paginateComputers(options?: PaginateComputersOptions): AsyncIterableIterator<ComputerBackup>;
+    /**
+     * Deletes a Computer Backup record.
+     *
+     * This destructive mutation is not automatically retried or reauthorized in
+     * place; callers should reconcile backup state before issuing a new delete
+     * after an ambiguous failure.
+     *
+     * @param options - Target account, computer ID, and optional abort signal.
+     *
+     * @returns The deleted computer backup record array.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    deleteComputer(options: DeleteComputerOptions): Promise<DeleteComputerResponse>;
+    private ensureBackupAuthorization;
+    private backupCoordinates;
+    /**
+     * Hides credentials and Partner tokens from `JSON.stringify(client)`.
+     *
+     * @returns A redacted diagnostic object.
+     */
+    toJSON(): BackupClientJson;
+    /**
+     * Hides credentials and Partner tokens from default stringification.
+     *
+     * @returns A short redacted label.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=client.d.ts.map

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

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