@backblaze-labs/b2-sdk 0.2.0 → 0.4.0

package/dist/backup/raw.cjs

@@ -0,0 +1,168 @@
+const require_url = require("../raw/url.cjs");
+const require_endpoint_url = require("../partner/endpoint-url.cjs");
+//#region src/backup/raw.ts
+var BACKUP_API = {
+	prefix: "api/backup",
+	version: "v1"
+};
+/**
+* Normalizes the `bz_delete_computer` wire response to the array-shaped schema.
+*
+* The Backblaze apidocs response *schema* declares a JSON array, but the
+* accompanying *example* shows a single bare object. This tolerates both: an
+* array passes through unchanged, and a lone object is wrapped in a
+* single-element array, so callers always receive a {@link DeleteComputerResponse}
+* regardless of which shape live B2 returns.
+*
+* @param raw - The parsed `bz_delete_computer` JSON body.
+*
+* @returns The response as the canonical array shape.
+*
+* @throws TypeError When the body is neither an array nor an object.
+*/
+function normalizeDeleteComputerResponse(raw) {
+	if (Array.isArray(raw)) return raw;
+	if (raw !== null && typeof raw === "object") return [raw];
+	throw new TypeError("bz_delete_computer returned an unexpected response body shape");
+}
+function backupEndpointAllowedSuffixes(transport, authorizedSuffixes) {
+	return require_endpoint_url.endpointAllowedSuffixes(transport, authorizedSuffixes, {
+		missingGuard: "Computer Backup endpoint requests require BackupClient.authorize() or a locked URL guard before sending Partner tokens",
+		unlockedGuard: "Computer Backup endpoint requests require a locked URL guard before sending Partner tokens"
+	});
+}
+function backupEndpointUrl(backupApiUrl, endpoint) {
+	return require_url.b2Url(backupApiUrl, {
+		...BACKUP_API,
+		endpoint
+	});
+}
+/**
+* Low-level client for Computer Backup API endpoint bindings.
+*
+* Each method maps directly to one `bz_*` HTTP call under the
+* `/api/backup/v1/` route using the `backupApiUrl` returned by Partner
+* authorization.
+*
+* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+*/
+var BackupRawClient = class {
+	/** @internal */
+	transport;
+	authorizedEndpointSuffixes;
+	/**
+	* Creates a new BackupRawClient with the given transport.
+	*
+	* @param options - The constructor configuration.
+	*/
+	constructor(options) {
+		this.transport = options.transport;
+		this.authorizedEndpointSuffixes = Array.from(options.authorizedBackupEndpointSuffixes ?? []);
+	}
+	/**
+	* Replaces the validated Computer Backup endpoint host suffixes.
+	*
+	* @param suffixes - Host suffixes derived from Partner authorization.
+	*
+	* @internal
+	*/
+	setAuthorizedEndpointSuffixes(suffixes) {
+		this.authorizedEndpointSuffixes = Array.from(suffixes);
+	}
+	/**
+	* Calls `bz_list_computers`.
+	*
+	* Uses the documented GET form. The wire response is a single JSON object
+	* with a `nextComputerId` cursor and active computer backup records.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+	* @param authToken - The Partner authorization token.
+	* @param request - The computer listing query parameters.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The single-object computer backup wire response.
+	*
+	* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+	*/
+	async listComputers(backupApiUrl, authToken, request, options) {
+		return this.getJson(backupApiUrl, authToken, "bz_list_computers", {
+			accountId: request.accountId,
+			...request.startComputerId !== void 0 ? { startComputerId: request.startComputerId } : {},
+			...request.maxComputerCount !== void 0 ? { maxComputerCount: request.maxComputerCount } : {}
+		}, options);
+	}
+	/**
+	* Calls `bz_delete_computer`.
+	*
+	* The documented wire response is a JSON array of deletion records. This
+	* destructive mutation is not automatically retried or reauthorized in place.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+	* @param authToken - The Partner authorization token.
+	* @param request - The computer deletion request body.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The deleted computer backup record array.
+	*
+	* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+	*/
+	async deleteComputer(backupApiUrl, authToken, request, options) {
+		return normalizeDeleteComputerResponse(await this.postNonRetryingMutationJson(backupApiUrl, authToken, "bz_delete_computer", {
+			accountId: request.accountId,
+			computerId: request.computerId
+		}, options));
+	}
+	safeBackupApiUrl(backupApiUrl) {
+		return require_endpoint_url.validatePartnerEndpointUrl(backupApiUrl, "backupApiUrl", backupEndpointAllowedSuffixes(this.transport, this.authorizedEndpointSuffixes));
+	}
+	/**
+	* Sends a JSON GET request to the specified Computer Backup API endpoint.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL.
+	* @param authToken - The Partner authorization token.
+	* @param endpoint - The Computer Backup API endpoint name.
+	* @param query - The query-string parameters.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The parsed JSON response.
+	*/
+	async getJson(backupApiUrl, authToken, endpoint, query, options) {
+		return (await this.transport.send({
+			url: require_endpoint_url.withQueryString(backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint), query),
+			method: "GET",
+			headers: { Authorization: authToken },
+			...options?.signal !== void 0 ? { signal: options.signal } : {},
+			...options?.retry !== void 0 ? { retry: options.retry } : {}
+		})).json();
+	}
+	/**
+	* Sends a non-retrying JSON mutation POST request to the specified Computer Backup API endpoint.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL.
+	* @param authToken - The Partner authorization token.
+	* @param endpoint - The Computer Backup API endpoint name.
+	* @param body - The JSON request body.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The parsed JSON response.
+	*/
+	async postNonRetryingMutationJson(backupApiUrl, authToken, endpoint, body, options) {
+		const requestOptions = require_endpoint_url.nonRetryingMutationRequestOptions(options);
+		return (await this.transport.send({
+			url: backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint),
+			method: "POST",
+			headers: {
+				Authorization: authToken,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(body),
+			...requestOptions.signal !== void 0 ? { signal: requestOptions.signal } : {},
+			...requestOptions.idempotent !== void 0 ? { idempotent: requestOptions.idempotent } : {},
+			...requestOptions.retry !== void 0 ? { retry: requestOptions.retry } : {}
+		})).json();
+	}
+};
+//#endregion
+exports.BackupRawClient = BackupRawClient;
+
+//# sourceMappingURL=raw.cjs.map

package/dist/backup/raw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.cjs","names":[],"sources":["../../src/backup/raw.ts"],"sourcesContent":["import type { BackupNonIdempotentMutationEndpoint } from '../http/non-idempotent-mutations.ts'\nimport type { RetryOptions } from '../http/retry.ts'\nimport type { HttpTransport } from '../http/transport.ts'\nimport {\n  endpointAllowedSuffixes,\n  nonRetryingMutationRequestOptions,\n  type QueryParams,\n  validatePartnerEndpointUrl,\n  withQueryString,\n} from '../partner/endpoint-url.ts'\nimport { type B2EndpointUrlOptions, b2Url } from '../raw/url.ts'\nimport type {\n  DeleteComputerRequest,\n  DeleteComputerResponse,\n  DeleteComputerResult,\n  ListComputersRequest,\n  ListComputersResponse,\n} from '../types/backup.ts'\n\nconst BACKUP_API: B2EndpointUrlOptions = { prefix: 'api/backup', version: 'v1' }\n\n/**\n * Normalizes the `bz_delete_computer` wire response to the array-shaped schema.\n *\n * The Backblaze apidocs response *schema* declares a JSON array, but the\n * accompanying *example* shows a single bare object. This tolerates both: an\n * array passes through unchanged, and a lone object is wrapped in a\n * single-element array, so callers always receive a {@link DeleteComputerResponse}\n * regardless of which shape live B2 returns.\n *\n * @param raw - The parsed `bz_delete_computer` JSON body.\n *\n * @returns The response as the canonical array shape.\n *\n * @throws TypeError When the body is neither an array nor an object.\n */\nfunction normalizeDeleteComputerResponse(raw: unknown): DeleteComputerResponse {\n  if (Array.isArray(raw)) return raw as DeleteComputerResponse\n  if (raw !== null && typeof raw === 'object') return [raw as DeleteComputerResult]\n  throw new TypeError('bz_delete_computer returned an unexpected response body shape')\n}\n\n/** Configuration for constructing a {@link BackupRawClient}. */\nexport interface BackupRawClientOptions {\n  /**\n   * The HTTP transport used to send requests.\n   *\n   * Computer Backup endpoint calls validate URLs against suffixes recorded by\n   * Partner authorization. A rehydrated client that skips authorization must\n   * use `authorizedBackupEndpointSuffixes` or a transport with a locked\n   * `urlGuard`. Because Partner authorize responses redact\n   * `authorizationToken` under `JSON.stringify`, durable caches should persist\n   * `partnerAuthorizeResponseForPersistence(auth)` only to encrypted or\n   * otherwise credential-grade storage, or use another secure token-preserving\n   * representation.\n   */\n  readonly transport: HttpTransport\n  /**\n   * Validated Computer Backup endpoint host suffixes restored from cached\n   * Partner authorization. Facades normally manage this after authorization;\n   * direct raw clients can pass trusted suffixes derived from\n   * `derivePartnerAllowedSuffixes()`. Do not derive this cache with\n   * `JSON.stringify(authorizePartner())`, which intentionally stores a redacted\n   * token placeholder instead of a usable Partner token. Rehydrating that\n   * placeholder fails fast.\n   */\n  readonly authorizedBackupEndpointSuffixes?: readonly string[]\n}\n\n/** Optional controls for raw Computer Backup API requests. */\nexport interface BackupRawRequestOptions {\n  /** Abort signal for cancelling the request. */\n  readonly signal?: AbortSignal\n  /** Per-request retry override. */\n  readonly retry?: Partial<RetryOptions>\n}\n\nfunction backupEndpointAllowedSuffixes(\n  transport: HttpTransport,\n  authorizedSuffixes: readonly string[],\n): readonly string[] {\n  return endpointAllowedSuffixes(transport, authorizedSuffixes, {\n    missingGuard:\n      'Computer Backup endpoint requests require BackupClient.authorize() or a locked URL guard before sending Partner tokens',\n    unlockedGuard:\n      'Computer Backup endpoint requests require a locked URL guard before sending Partner tokens',\n  })\n}\n\nfunction backupEndpointUrl(backupApiUrl: string, endpoint: string): string {\n  return b2Url(backupApiUrl, { ...BACKUP_API, endpoint })\n}\n\n/**\n * Low-level client for Computer Backup API endpoint bindings.\n *\n * Each method maps directly to one `bz_*` HTTP call under the\n * `/api/backup/v1/` route using the `backupApiUrl` returned by Partner\n * authorization.\n *\n * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.\n */\nexport class BackupRawClient {\n  /** @internal */\n  private readonly transport: HttpTransport\n  private authorizedEndpointSuffixes: readonly string[]\n\n  /**\n   * Creates a new BackupRawClient with the given transport.\n   *\n   * @param options - The constructor configuration.\n   */\n  constructor(options: BackupRawClientOptions) {\n    this.transport = options.transport\n    this.authorizedEndpointSuffixes = Array.from(options.authorizedBackupEndpointSuffixes ?? [])\n  }\n\n  /**\n   * Replaces the validated Computer Backup endpoint host suffixes.\n   *\n   * @param suffixes - Host suffixes derived from Partner authorization.\n   *\n   * @internal\n   */\n  setAuthorizedEndpointSuffixes(suffixes: readonly string[]): void {\n    this.authorizedEndpointSuffixes = Array.from(suffixes)\n  }\n\n  /**\n   * Calls `bz_list_computers`.\n   *\n   * Uses the documented GET form. The wire response is a single JSON object\n   * with a `nextComputerId` cursor and active computer backup records.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.\n   * @param authToken - The Partner authorization token.\n   * @param request - The computer listing query parameters.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The single-object computer backup wire response.\n   *\n   * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.\n   */\n  async listComputers(\n    backupApiUrl: string,\n    authToken: string,\n    request: ListComputersRequest,\n    options?: BackupRawRequestOptions,\n  ): Promise<ListComputersResponse> {\n    return this.getJson<ListComputersResponse>(\n      backupApiUrl,\n      authToken,\n      'bz_list_computers',\n      {\n        accountId: request.accountId,\n        ...(request.startComputerId !== undefined\n          ? { startComputerId: request.startComputerId }\n          : {}),\n        ...(request.maxComputerCount !== undefined\n          ? { maxComputerCount: request.maxComputerCount }\n          : {}),\n      },\n      options,\n    )\n  }\n\n  /**\n   * Calls `bz_delete_computer`.\n   *\n   * The documented wire response is a JSON array of deletion records. This\n   * destructive mutation is not automatically retried or reauthorized in place.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.\n   * @param authToken - The Partner authorization token.\n   * @param request - The computer deletion request body.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The deleted computer backup record array.\n   *\n   * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.\n   */\n  async deleteComputer(\n    backupApiUrl: string,\n    authToken: string,\n    request: DeleteComputerRequest,\n    options?: BackupRawRequestOptions,\n  ): Promise<DeleteComputerResponse> {\n    const response = await this.postNonRetryingMutationJson<unknown>(\n      backupApiUrl,\n      authToken,\n      'bz_delete_computer',\n      {\n        accountId: request.accountId,\n        computerId: request.computerId,\n      },\n      options,\n    )\n    return normalizeDeleteComputerResponse(response)\n  }\n\n  private safeBackupApiUrl(backupApiUrl: string): string {\n    return validatePartnerEndpointUrl(\n      backupApiUrl,\n      'backupApiUrl',\n      backupEndpointAllowedSuffixes(this.transport, this.authorizedEndpointSuffixes),\n    )\n  }\n\n  /**\n   * Sends a JSON GET request to the specified Computer Backup API endpoint.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL.\n   * @param authToken - The Partner authorization token.\n   * @param endpoint - The Computer Backup API endpoint name.\n   * @param query - The query-string parameters.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The parsed JSON response.\n   */\n  private async getJson<T>(\n    backupApiUrl: string,\n    authToken: string,\n    endpoint: string,\n    query: QueryParams,\n    options?: BackupRawRequestOptions,\n  ): Promise<T> {\n    const response = await this.transport.send({\n      url: withQueryString(backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint), query),\n      method: 'GET',\n      headers: {\n        Authorization: authToken,\n      },\n      ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n      ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n    })\n    return response.json<T>()\n  }\n\n  /**\n   * Sends a non-retrying JSON mutation POST request to the specified Computer Backup API endpoint.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL.\n   * @param authToken - The Partner authorization token.\n   * @param endpoint - The Computer Backup API endpoint name.\n   * @param body - The JSON request body.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The parsed JSON response.\n   */\n  private async postNonRetryingMutationJson<T>(\n    backupApiUrl: string,\n    authToken: string,\n    endpoint: BackupNonIdempotentMutationEndpoint,\n    body: unknown,\n    options?: BackupRawRequestOptions,\n  ): Promise<T> {\n    const requestOptions = nonRetryingMutationRequestOptions(options)\n    const response = await this.transport.send({\n      url: backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint),\n      method: 'POST',\n      headers: {\n        Authorization: authToken,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n      ...(requestOptions.signal !== undefined ? { signal: requestOptions.signal } : {}),\n      ...(requestOptions.idempotent !== undefined ? { idempotent: requestOptions.idempotent } : {}),\n      ...(requestOptions.retry !== undefined ? { retry: requestOptions.retry } : {}),\n    })\n    return response.json<T>()\n  }\n}\n"],"mappings":";;;AAmBA,IAAM,aAAmC;CAAE,QAAQ;CAAc,SAAS;AAAK;;;;;;;;;;;;;;;;AAiB/E,SAAS,gCAAgC,KAAsC;CAC7E,IAAI,MAAM,QAAQ,GAAG,GAAG,OAAO;CAC/B,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU,OAAO,CAAC,GAA2B;CAChF,MAAM,IAAI,UAAU,+DAA+D;AACrF;AAqCA,SAAS,8BACP,WACA,oBACmB;CACnB,OAAO,qBAAA,wBAAwB,WAAW,oBAAoB;EAC5D,cACE;EACF,eACE;CACJ,CAAC;AACH;AAEA,SAAS,kBAAkB,cAAsB,UAA0B;CACzE,OAAO,YAAA,MAAM,cAAc;EAAE,GAAG;EAAY;CAAS,CAAC;AACxD;;;;;;;;;;AAWA,IAAa,kBAAb,MAA6B;;CAE3B;CACA;;;;;;CAOA,YAAY,SAAiC;EAC3C,KAAK,YAAY,QAAQ;EACzB,KAAK,6BAA6B,MAAM,KAAK,QAAQ,oCAAoC,CAAC,CAAC;CAC7F;;;;;;;;CASA,8BAA8B,UAAmC;EAC/D,KAAK,6BAA6B,MAAM,KAAK,QAAQ;CACvD;;;;;;;;;;;;;;;;CAiBA,MAAM,cACJ,cACA,WACA,SACA,SACgC;EAChC,OAAO,KAAK,QACV,cACA,WACA,qBACA;GACE,WAAW,QAAQ;GACnB,GAAI,QAAQ,oBAAoB,KAAA,IAC5B,EAAE,iBAAiB,QAAQ,gBAAgB,IAC3C,CAAC;GACL,GAAI,QAAQ,qBAAqB,KAAA,IAC7B,EAAE,kBAAkB,QAAQ,iBAAiB,IAC7C,CAAC;EACP,GACA,OACF;CACF;;;;;;;;;;;;;;;;CAiBA,MAAM,eACJ,cACA,WACA,SACA,SACiC;EAWjC,OAAO,gCAAgC,MAVhB,KAAK,4BAC1B,cACA,WACA,sBACA;GACE,WAAW,QAAQ;GACnB,YAAY,QAAQ;EACtB,GACA,OACF,CAC+C;CACjD;CAEA,iBAAyB,cAA8B;EACrD,OAAO,qBAAA,2BACL,cACA,gBACA,8BAA8B,KAAK,WAAW,KAAK,0BAA0B,CAC/E;CACF;;;;;;;;;;;;CAaA,MAAc,QACZ,cACA,WACA,UACA,OACA,SACY;EAUZ,QAAO,MATgB,KAAK,UAAU,KAAK;GACzC,KAAK,qBAAA,gBAAgB,kBAAkB,KAAK,iBAAiB,YAAY,GAAG,QAAQ,GAAG,KAAK;GAC5F,QAAQ;GACR,SAAS,EACP,eAAe,UACjB;GACA,GAAI,SAAS,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;GAClE,GAAI,SAAS,UAAU,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EACjE,CAAC,EAAA,CACe,KAAQ;CAC1B;;;;;;;;;;;;CAaA,MAAc,4BACZ,cACA,WACA,UACA,MACA,SACY;EACZ,MAAM,iBAAiB,qBAAA,kCAAkC,OAAO;EAahE,QAAO,MAZgB,KAAK,UAAU,KAAK;GACzC,KAAK,kBAAkB,KAAK,iBAAiB,YAAY,GAAG,QAAQ;GACpE,QAAQ;GACR,SAAS;IACP,eAAe;IACf,gBAAgB;GAClB;GACA,MAAM,KAAK,UAAU,IAAI;GACzB,GAAI,eAAe,WAAW,KAAA,IAAY,EAAE,QAAQ,eAAe,OAAO,IAAI,CAAC;GAC/E,GAAI,eAAe,eAAe,KAAA,IAAY,EAAE,YAAY,eAAe,WAAW,IAAI,CAAC;GAC3F,GAAI,eAAe,UAAU,KAAA,IAAY,EAAE,OAAO,eAAe,MAAM,IAAI,CAAC;EAC9E,CAAC,EAAA,CACe,KAAQ;CAC1B;AACF"}

package/dist/backup/raw.d.cts

@@ -0,0 +1,122 @@
+import { RetryOptions } from '../http/retry.js';
+import { HttpTransport } from '../http/transport.js';
+import { DeleteComputerRequest, DeleteComputerResponse, ListComputersRequest, ListComputersResponse } from '../types/backup.js';
+/** Configuration for constructing a {@link BackupRawClient}. */
+export interface BackupRawClientOptions {
+    /**
+     * The HTTP transport used to send requests.
+     *
+     * Computer Backup endpoint calls validate URLs against suffixes recorded by
+     * Partner authorization. A rehydrated client that skips authorization must
+     * use `authorizedBackupEndpointSuffixes` or a transport with a locked
+     * `urlGuard`. Because Partner authorize responses redact
+     * `authorizationToken` under `JSON.stringify`, durable caches should persist
+     * `partnerAuthorizeResponseForPersistence(auth)` only to encrypted or
+     * otherwise credential-grade storage, or use another secure token-preserving
+     * representation.
+     */
+    readonly transport: HttpTransport;
+    /**
+     * Validated Computer Backup endpoint host suffixes restored from cached
+     * Partner authorization. Facades normally manage this after authorization;
+     * direct raw clients can pass trusted suffixes derived from
+     * `derivePartnerAllowedSuffixes()`. Do not derive this cache with
+     * `JSON.stringify(authorizePartner())`, which intentionally stores a redacted
+     * token placeholder instead of a usable Partner token. Rehydrating that
+     * placeholder fails fast.
+     */
+    readonly authorizedBackupEndpointSuffixes?: readonly string[];
+}
+/** Optional controls for raw Computer Backup API requests. */
+export interface BackupRawRequestOptions {
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+    /** Per-request retry override. */
+    readonly retry?: Partial<RetryOptions>;
+}
+/**
+ * Low-level client for Computer Backup API endpoint bindings.
+ *
+ * Each method maps directly to one `bz_*` HTTP call under the
+ * `/api/backup/v1/` route using the `backupApiUrl` returned by Partner
+ * authorization.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export declare class BackupRawClient {
+    /** @internal */
+    private readonly transport;
+    private authorizedEndpointSuffixes;
+    /**
+     * Creates a new BackupRawClient with the given transport.
+     *
+     * @param options - The constructor configuration.
+     */
+    constructor(options: BackupRawClientOptions);
+    /**
+     * Replaces the validated Computer Backup endpoint host suffixes.
+     *
+     * @param suffixes - Host suffixes derived from Partner authorization.
+     *
+     * @internal
+     */
+    setAuthorizedEndpointSuffixes(suffixes: readonly string[]): void;
+    /**
+     * Calls `bz_list_computers`.
+     *
+     * Uses the documented GET form. The wire response is a single JSON object
+     * with a `nextComputerId` cursor and active computer backup records.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+     * @param authToken - The Partner authorization token.
+     * @param request - The computer listing query parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The single-object computer backup wire response.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    listComputers(backupApiUrl: string, authToken: string, request: ListComputersRequest, options?: BackupRawRequestOptions): Promise<ListComputersResponse>;
+    /**
+     * Calls `bz_delete_computer`.
+     *
+     * The documented wire response is a JSON array of deletion records. This
+     * destructive mutation is not automatically retried or reauthorized in place.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+     * @param authToken - The Partner authorization token.
+     * @param request - The computer deletion request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The deleted computer backup record array.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    deleteComputer(backupApiUrl: string, authToken: string, request: DeleteComputerRequest, options?: BackupRawRequestOptions): Promise<DeleteComputerResponse>;
+    private safeBackupApiUrl;
+    /**
+     * Sends a JSON GET request to the specified Computer Backup API endpoint.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL.
+     * @param authToken - The Partner authorization token.
+     * @param endpoint - The Computer Backup API endpoint name.
+     * @param query - The query-string parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private getJson;
+    /**
+     * Sends a non-retrying JSON mutation POST request to the specified Computer Backup API endpoint.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL.
+     * @param authToken - The Partner authorization token.
+     * @param endpoint - The Computer Backup API endpoint name.
+     * @param body - The JSON request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private postNonRetryingMutationJson;
+}
+//# sourceMappingURL=raw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/backup/raw.js"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AASzD,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EAEtB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAyB3B,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,gCAAgC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9D;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CACvC;AAkBD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,0BAA0B,CAAmB;IAErD;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAK3C;;;;;;OAMG;IACH,6BAA6B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIhE;;;;;;;;;;;;;;OAcG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAclC,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;OAUG;YACW,OAAO;IAmBrB;;;;;;;;;;OAUG;YACW,2BAA2B;CAsB1C"}

package/dist/backup/raw.d.ts

@@ -0,0 +1,122 @@
+import { RetryOptions } from '../http/retry.js';
+import { HttpTransport } from '../http/transport.js';
+import { DeleteComputerRequest, DeleteComputerResponse, ListComputersRequest, ListComputersResponse } from '../types/backup.js';
+/** Configuration for constructing a {@link BackupRawClient}. */
+export interface BackupRawClientOptions {
+    /**
+     * The HTTP transport used to send requests.
+     *
+     * Computer Backup endpoint calls validate URLs against suffixes recorded by
+     * Partner authorization. A rehydrated client that skips authorization must
+     * use `authorizedBackupEndpointSuffixes` or a transport with a locked
+     * `urlGuard`. Because Partner authorize responses redact
+     * `authorizationToken` under `JSON.stringify`, durable caches should persist
+     * `partnerAuthorizeResponseForPersistence(auth)` only to encrypted or
+     * otherwise credential-grade storage, or use another secure token-preserving
+     * representation.
+     */
+    readonly transport: HttpTransport;
+    /**
+     * Validated Computer Backup endpoint host suffixes restored from cached
+     * Partner authorization. Facades normally manage this after authorization;
+     * direct raw clients can pass trusted suffixes derived from
+     * `derivePartnerAllowedSuffixes()`. Do not derive this cache with
+     * `JSON.stringify(authorizePartner())`, which intentionally stores a redacted
+     * token placeholder instead of a usable Partner token. Rehydrating that
+     * placeholder fails fast.
+     */
+    readonly authorizedBackupEndpointSuffixes?: readonly string[];
+}
+/** Optional controls for raw Computer Backup API requests. */
+export interface BackupRawRequestOptions {
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+    /** Per-request retry override. */
+    readonly retry?: Partial<RetryOptions>;
+}
+/**
+ * Low-level client for Computer Backup API endpoint bindings.
+ *
+ * Each method maps directly to one `bz_*` HTTP call under the
+ * `/api/backup/v1/` route using the `backupApiUrl` returned by Partner
+ * authorization.
+ *
+ * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+ */
+export declare class BackupRawClient {
+    /** @internal */
+    private readonly transport;
+    private authorizedEndpointSuffixes;
+    /**
+     * Creates a new BackupRawClient with the given transport.
+     *
+     * @param options - The constructor configuration.
+     */
+    constructor(options: BackupRawClientOptions);
+    /**
+     * Replaces the validated Computer Backup endpoint host suffixes.
+     *
+     * @param suffixes - Host suffixes derived from Partner authorization.
+     *
+     * @internal
+     */
+    setAuthorizedEndpointSuffixes(suffixes: readonly string[]): void;
+    /**
+     * Calls `bz_list_computers`.
+     *
+     * Uses the documented GET form. The wire response is a single JSON object
+     * with a `nextComputerId` cursor and active computer backup records.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+     * @param authToken - The Partner authorization token.
+     * @param request - The computer listing query parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The single-object computer backup wire response.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    listComputers(backupApiUrl: string, authToken: string, request: ListComputersRequest, options?: BackupRawRequestOptions): Promise<ListComputersResponse>;
+    /**
+     * Calls `bz_delete_computer`.
+     *
+     * The documented wire response is a JSON array of deletion records. This
+     * destructive mutation is not automatically retried or reauthorized in place.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+     * @param authToken - The Partner authorization token.
+     * @param request - The computer deletion request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The deleted computer backup record array.
+     *
+     * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+     */
+    deleteComputer(backupApiUrl: string, authToken: string, request: DeleteComputerRequest, options?: BackupRawRequestOptions): Promise<DeleteComputerResponse>;
+    private safeBackupApiUrl;
+    /**
+     * Sends a JSON GET request to the specified Computer Backup API endpoint.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL.
+     * @param authToken - The Partner authorization token.
+     * @param endpoint - The Computer Backup API endpoint name.
+     * @param query - The query-string parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private getJson;
+    /**
+     * Sends a non-retrying JSON mutation POST request to the specified Computer Backup API endpoint.
+     *
+     * @param backupApiUrl - The Computer Backup API base URL.
+     * @param authToken - The Partner authorization token.
+     * @param endpoint - The Computer Backup API endpoint name.
+     * @param body - The JSON request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private postNonRetryingMutationJson;
+}
+//# sourceMappingURL=raw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/backup/raw.js"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AASzD,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EAEtB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAyB3B,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,gCAAgC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9D;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CACvC;AAkBD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,0BAA0B,CAAmB;IAErD;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAK3C;;;;;;OAMG;IACH,6BAA6B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIhE;;;;;;;;;;;;;;OAcG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAclC,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;OAUG;YACW,OAAO;IAmBrB;;;;;;;;;;OAUG;YACW,2BAA2B;CAsB1C"}

package/dist/backup/raw.js

@@ -0,0 +1,168 @@
+import { b2Url } from "../raw/url.js";
+import { endpointAllowedSuffixes, nonRetryingMutationRequestOptions, validatePartnerEndpointUrl, withQueryString } from "../partner/endpoint-url.js";
+//#region src/backup/raw.ts
+var BACKUP_API = {
+	prefix: "api/backup",
+	version: "v1"
+};
+/**
+* Normalizes the `bz_delete_computer` wire response to the array-shaped schema.
+*
+* The Backblaze apidocs response *schema* declares a JSON array, but the
+* accompanying *example* shows a single bare object. This tolerates both: an
+* array passes through unchanged, and a lone object is wrapped in a
+* single-element array, so callers always receive a {@link DeleteComputerResponse}
+* regardless of which shape live B2 returns.
+*
+* @param raw - The parsed `bz_delete_computer` JSON body.
+*
+* @returns The response as the canonical array shape.
+*
+* @throws TypeError When the body is neither an array nor an object.
+*/
+function normalizeDeleteComputerResponse(raw) {
+	if (Array.isArray(raw)) return raw;
+	if (raw !== null && typeof raw === "object") return [raw];
+	throw new TypeError("bz_delete_computer returned an unexpected response body shape");
+}
+function backupEndpointAllowedSuffixes(transport, authorizedSuffixes) {
+	return endpointAllowedSuffixes(transport, authorizedSuffixes, {
+		missingGuard: "Computer Backup endpoint requests require BackupClient.authorize() or a locked URL guard before sending Partner tokens",
+		unlockedGuard: "Computer Backup endpoint requests require a locked URL guard before sending Partner tokens"
+	});
+}
+function backupEndpointUrl(backupApiUrl, endpoint) {
+	return b2Url(backupApiUrl, {
+		...BACKUP_API,
+		endpoint
+	});
+}
+/**
+* Low-level client for Computer Backup API endpoint bindings.
+*
+* Each method maps directly to one `bz_*` HTTP call under the
+* `/api/backup/v1/` route using the `backupApiUrl` returned by Partner
+* authorization.
+*
+* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+*/
+var BackupRawClient = class {
+	/** @internal */
+	transport;
+	authorizedEndpointSuffixes;
+	/**
+	* Creates a new BackupRawClient with the given transport.
+	*
+	* @param options - The constructor configuration.
+	*/
+	constructor(options) {
+		this.transport = options.transport;
+		this.authorizedEndpointSuffixes = Array.from(options.authorizedBackupEndpointSuffixes ?? []);
+	}
+	/**
+	* Replaces the validated Computer Backup endpoint host suffixes.
+	*
+	* @param suffixes - Host suffixes derived from Partner authorization.
+	*
+	* @internal
+	*/
+	setAuthorizedEndpointSuffixes(suffixes) {
+		this.authorizedEndpointSuffixes = Array.from(suffixes);
+	}
+	/**
+	* Calls `bz_list_computers`.
+	*
+	* Uses the documented GET form. The wire response is a single JSON object
+	* with a `nextComputerId` cursor and active computer backup records.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+	* @param authToken - The Partner authorization token.
+	* @param request - The computer listing query parameters.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The single-object computer backup wire response.
+	*
+	* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+	*/
+	async listComputers(backupApiUrl, authToken, request, options) {
+		return this.getJson(backupApiUrl, authToken, "bz_list_computers", {
+			accountId: request.accountId,
+			...request.startComputerId !== void 0 ? { startComputerId: request.startComputerId } : {},
+			...request.maxComputerCount !== void 0 ? { maxComputerCount: request.maxComputerCount } : {}
+		}, options);
+	}
+	/**
+	* Calls `bz_delete_computer`.
+	*
+	* The documented wire response is a JSON array of deletion records. This
+	* destructive mutation is not automatically retried or reauthorized in place.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.
+	* @param authToken - The Partner authorization token.
+	* @param request - The computer deletion request body.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The deleted computer backup record array.
+	*
+	* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
+	*/
+	async deleteComputer(backupApiUrl, authToken, request, options) {
+		return normalizeDeleteComputerResponse(await this.postNonRetryingMutationJson(backupApiUrl, authToken, "bz_delete_computer", {
+			accountId: request.accountId,
+			computerId: request.computerId
+		}, options));
+	}
+	safeBackupApiUrl(backupApiUrl) {
+		return validatePartnerEndpointUrl(backupApiUrl, "backupApiUrl", backupEndpointAllowedSuffixes(this.transport, this.authorizedEndpointSuffixes));
+	}
+	/**
+	* Sends a JSON GET request to the specified Computer Backup API endpoint.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL.
+	* @param authToken - The Partner authorization token.
+	* @param endpoint - The Computer Backup API endpoint name.
+	* @param query - The query-string parameters.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The parsed JSON response.
+	*/
+	async getJson(backupApiUrl, authToken, endpoint, query, options) {
+		return (await this.transport.send({
+			url: withQueryString(backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint), query),
+			method: "GET",
+			headers: { Authorization: authToken },
+			...options?.signal !== void 0 ? { signal: options.signal } : {},
+			...options?.retry !== void 0 ? { retry: options.retry } : {}
+		})).json();
+	}
+	/**
+	* Sends a non-retrying JSON mutation POST request to the specified Computer Backup API endpoint.
+	*
+	* @param backupApiUrl - The Computer Backup API base URL.
+	* @param authToken - The Partner authorization token.
+	* @param endpoint - The Computer Backup API endpoint name.
+	* @param body - The JSON request body.
+	* @param options - Optional abort and per-request retry settings.
+	*
+	* @returns The parsed JSON response.
+	*/
+	async postNonRetryingMutationJson(backupApiUrl, authToken, endpoint, body, options) {
+		const requestOptions = nonRetryingMutationRequestOptions(options);
+		return (await this.transport.send({
+			url: backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint),
+			method: "POST",
+			headers: {
+				Authorization: authToken,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(body),
+			...requestOptions.signal !== void 0 ? { signal: requestOptions.signal } : {},
+			...requestOptions.idempotent !== void 0 ? { idempotent: requestOptions.idempotent } : {},
+			...requestOptions.retry !== void 0 ? { retry: requestOptions.retry } : {}
+		})).json();
+	}
+};
+//#endregion
+export { BackupRawClient };
+
+//# sourceMappingURL=raw.js.map

package/dist/backup/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","names":[],"sources":["../../src/backup/raw.ts"],"sourcesContent":["import type { BackupNonIdempotentMutationEndpoint } from '../http/non-idempotent-mutations.ts'\nimport type { RetryOptions } from '../http/retry.ts'\nimport type { HttpTransport } from '../http/transport.ts'\nimport {\n  endpointAllowedSuffixes,\n  nonRetryingMutationRequestOptions,\n  type QueryParams,\n  validatePartnerEndpointUrl,\n  withQueryString,\n} from '../partner/endpoint-url.ts'\nimport { type B2EndpointUrlOptions, b2Url } from '../raw/url.ts'\nimport type {\n  DeleteComputerRequest,\n  DeleteComputerResponse,\n  DeleteComputerResult,\n  ListComputersRequest,\n  ListComputersResponse,\n} from '../types/backup.ts'\n\nconst BACKUP_API: B2EndpointUrlOptions = { prefix: 'api/backup', version: 'v1' }\n\n/**\n * Normalizes the `bz_delete_computer` wire response to the array-shaped schema.\n *\n * The Backblaze apidocs response *schema* declares a JSON array, but the\n * accompanying *example* shows a single bare object. This tolerates both: an\n * array passes through unchanged, and a lone object is wrapped in a\n * single-element array, so callers always receive a {@link DeleteComputerResponse}\n * regardless of which shape live B2 returns.\n *\n * @param raw - The parsed `bz_delete_computer` JSON body.\n *\n * @returns The response as the canonical array shape.\n *\n * @throws TypeError When the body is neither an array nor an object.\n */\nfunction normalizeDeleteComputerResponse(raw: unknown): DeleteComputerResponse {\n  if (Array.isArray(raw)) return raw as DeleteComputerResponse\n  if (raw !== null && typeof raw === 'object') return [raw as DeleteComputerResult]\n  throw new TypeError('bz_delete_computer returned an unexpected response body shape')\n}\n\n/** Configuration for constructing a {@link BackupRawClient}. */\nexport interface BackupRawClientOptions {\n  /**\n   * The HTTP transport used to send requests.\n   *\n   * Computer Backup endpoint calls validate URLs against suffixes recorded by\n   * Partner authorization. A rehydrated client that skips authorization must\n   * use `authorizedBackupEndpointSuffixes` or a transport with a locked\n   * `urlGuard`. Because Partner authorize responses redact\n   * `authorizationToken` under `JSON.stringify`, durable caches should persist\n   * `partnerAuthorizeResponseForPersistence(auth)` only to encrypted or\n   * otherwise credential-grade storage, or use another secure token-preserving\n   * representation.\n   */\n  readonly transport: HttpTransport\n  /**\n   * Validated Computer Backup endpoint host suffixes restored from cached\n   * Partner authorization. Facades normally manage this after authorization;\n   * direct raw clients can pass trusted suffixes derived from\n   * `derivePartnerAllowedSuffixes()`. Do not derive this cache with\n   * `JSON.stringify(authorizePartner())`, which intentionally stores a redacted\n   * token placeholder instead of a usable Partner token. Rehydrating that\n   * placeholder fails fast.\n   */\n  readonly authorizedBackupEndpointSuffixes?: readonly string[]\n}\n\n/** Optional controls for raw Computer Backup API requests. */\nexport interface BackupRawRequestOptions {\n  /** Abort signal for cancelling the request. */\n  readonly signal?: AbortSignal\n  /** Per-request retry override. */\n  readonly retry?: Partial<RetryOptions>\n}\n\nfunction backupEndpointAllowedSuffixes(\n  transport: HttpTransport,\n  authorizedSuffixes: readonly string[],\n): readonly string[] {\n  return endpointAllowedSuffixes(transport, authorizedSuffixes, {\n    missingGuard:\n      'Computer Backup endpoint requests require BackupClient.authorize() or a locked URL guard before sending Partner tokens',\n    unlockedGuard:\n      'Computer Backup endpoint requests require a locked URL guard before sending Partner tokens',\n  })\n}\n\nfunction backupEndpointUrl(backupApiUrl: string, endpoint: string): string {\n  return b2Url(backupApiUrl, { ...BACKUP_API, endpoint })\n}\n\n/**\n * Low-level client for Computer Backup API endpoint bindings.\n *\n * Each method maps directly to one `bz_*` HTTP call under the\n * `/api/backup/v1/` route using the `backupApiUrl` returned by Partner\n * authorization.\n *\n * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.\n */\nexport class BackupRawClient {\n  /** @internal */\n  private readonly transport: HttpTransport\n  private authorizedEndpointSuffixes: readonly string[]\n\n  /**\n   * Creates a new BackupRawClient with the given transport.\n   *\n   * @param options - The constructor configuration.\n   */\n  constructor(options: BackupRawClientOptions) {\n    this.transport = options.transport\n    this.authorizedEndpointSuffixes = Array.from(options.authorizedBackupEndpointSuffixes ?? [])\n  }\n\n  /**\n   * Replaces the validated Computer Backup endpoint host suffixes.\n   *\n   * @param suffixes - Host suffixes derived from Partner authorization.\n   *\n   * @internal\n   */\n  setAuthorizedEndpointSuffixes(suffixes: readonly string[]): void {\n    this.authorizedEndpointSuffixes = Array.from(suffixes)\n  }\n\n  /**\n   * Calls `bz_list_computers`.\n   *\n   * Uses the documented GET form. The wire response is a single JSON object\n   * with a `nextComputerId` cursor and active computer backup records.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.\n   * @param authToken - The Partner authorization token.\n   * @param request - The computer listing query parameters.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The single-object computer backup wire response.\n   *\n   * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.\n   */\n  async listComputers(\n    backupApiUrl: string,\n    authToken: string,\n    request: ListComputersRequest,\n    options?: BackupRawRequestOptions,\n  ): Promise<ListComputersResponse> {\n    return this.getJson<ListComputersResponse>(\n      backupApiUrl,\n      authToken,\n      'bz_list_computers',\n      {\n        accountId: request.accountId,\n        ...(request.startComputerId !== undefined\n          ? { startComputerId: request.startComputerId }\n          : {}),\n        ...(request.maxComputerCount !== undefined\n          ? { maxComputerCount: request.maxComputerCount }\n          : {}),\n      },\n      options,\n    )\n  }\n\n  /**\n   * Calls `bz_delete_computer`.\n   *\n   * The documented wire response is a JSON array of deletion records. This\n   * destructive mutation is not automatically retried or reauthorized in place.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL from `authorizePartner`.\n   * @param authToken - The Partner authorization token.\n   * @param request - The computer deletion request body.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The deleted computer backup record array.\n   *\n   * @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.\n   */\n  async deleteComputer(\n    backupApiUrl: string,\n    authToken: string,\n    request: DeleteComputerRequest,\n    options?: BackupRawRequestOptions,\n  ): Promise<DeleteComputerResponse> {\n    const response = await this.postNonRetryingMutationJson<unknown>(\n      backupApiUrl,\n      authToken,\n      'bz_delete_computer',\n      {\n        accountId: request.accountId,\n        computerId: request.computerId,\n      },\n      options,\n    )\n    return normalizeDeleteComputerResponse(response)\n  }\n\n  private safeBackupApiUrl(backupApiUrl: string): string {\n    return validatePartnerEndpointUrl(\n      backupApiUrl,\n      'backupApiUrl',\n      backupEndpointAllowedSuffixes(this.transport, this.authorizedEndpointSuffixes),\n    )\n  }\n\n  /**\n   * Sends a JSON GET request to the specified Computer Backup API endpoint.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL.\n   * @param authToken - The Partner authorization token.\n   * @param endpoint - The Computer Backup API endpoint name.\n   * @param query - The query-string parameters.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The parsed JSON response.\n   */\n  private async getJson<T>(\n    backupApiUrl: string,\n    authToken: string,\n    endpoint: string,\n    query: QueryParams,\n    options?: BackupRawRequestOptions,\n  ): Promise<T> {\n    const response = await this.transport.send({\n      url: withQueryString(backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint), query),\n      method: 'GET',\n      headers: {\n        Authorization: authToken,\n      },\n      ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n      ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n    })\n    return response.json<T>()\n  }\n\n  /**\n   * Sends a non-retrying JSON mutation POST request to the specified Computer Backup API endpoint.\n   *\n   * @param backupApiUrl - The Computer Backup API base URL.\n   * @param authToken - The Partner authorization token.\n   * @param endpoint - The Computer Backup API endpoint name.\n   * @param body - The JSON request body.\n   * @param options - Optional abort and per-request retry settings.\n   *\n   * @returns The parsed JSON response.\n   */\n  private async postNonRetryingMutationJson<T>(\n    backupApiUrl: string,\n    authToken: string,\n    endpoint: BackupNonIdempotentMutationEndpoint,\n    body: unknown,\n    options?: BackupRawRequestOptions,\n  ): Promise<T> {\n    const requestOptions = nonRetryingMutationRequestOptions(options)\n    const response = await this.transport.send({\n      url: backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint),\n      method: 'POST',\n      headers: {\n        Authorization: authToken,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n      ...(requestOptions.signal !== undefined ? { signal: requestOptions.signal } : {}),\n      ...(requestOptions.idempotent !== undefined ? { idempotent: requestOptions.idempotent } : {}),\n      ...(requestOptions.retry !== undefined ? { retry: requestOptions.retry } : {}),\n    })\n    return response.json<T>()\n  }\n}\n"],"mappings":";;;AAmBA,IAAM,aAAmC;CAAE,QAAQ;CAAc,SAAS;AAAK;;;;;;;;;;;;;;;;AAiB/E,SAAS,gCAAgC,KAAsC;CAC7E,IAAI,MAAM,QAAQ,GAAG,GAAG,OAAO;CAC/B,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU,OAAO,CAAC,GAA2B;CAChF,MAAM,IAAI,UAAU,+DAA+D;AACrF;AAqCA,SAAS,8BACP,WACA,oBACmB;CACnB,OAAO,wBAAwB,WAAW,oBAAoB;EAC5D,cACE;EACF,eACE;CACJ,CAAC;AACH;AAEA,SAAS,kBAAkB,cAAsB,UAA0B;CACzE,OAAO,MAAM,cAAc;EAAE,GAAG;EAAY;CAAS,CAAC;AACxD;;;;;;;;;;AAWA,IAAa,kBAAb,MAA6B;;CAE3B;CACA;;;;;;CAOA,YAAY,SAAiC;EAC3C,KAAK,YAAY,QAAQ;EACzB,KAAK,6BAA6B,MAAM,KAAK,QAAQ,oCAAoC,CAAC,CAAC;CAC7F;;;;;;;;CASA,8BAA8B,UAAmC;EAC/D,KAAK,6BAA6B,MAAM,KAAK,QAAQ;CACvD;;;;;;;;;;;;;;;;CAiBA,MAAM,cACJ,cACA,WACA,SACA,SACgC;EAChC,OAAO,KAAK,QACV,cACA,WACA,qBACA;GACE,WAAW,QAAQ;GACnB,GAAI,QAAQ,oBAAoB,KAAA,IAC5B,EAAE,iBAAiB,QAAQ,gBAAgB,IAC3C,CAAC;GACL,GAAI,QAAQ,qBAAqB,KAAA,IAC7B,EAAE,kBAAkB,QAAQ,iBAAiB,IAC7C,CAAC;EACP,GACA,OACF;CACF;;;;;;;;;;;;;;;;CAiBA,MAAM,eACJ,cACA,WACA,SACA,SACiC;EAWjC,OAAO,gCAAgC,MAVhB,KAAK,4BAC1B,cACA,WACA,sBACA;GACE,WAAW,QAAQ;GACnB,YAAY,QAAQ;EACtB,GACA,OACF,CAC+C;CACjD;CAEA,iBAAyB,cAA8B;EACrD,OAAO,2BACL,cACA,gBACA,8BAA8B,KAAK,WAAW,KAAK,0BAA0B,CAC/E;CACF;;;;;;;;;;;;CAaA,MAAc,QACZ,cACA,WACA,UACA,OACA,SACY;EAUZ,QAAO,MATgB,KAAK,UAAU,KAAK;GACzC,KAAK,gBAAgB,kBAAkB,KAAK,iBAAiB,YAAY,GAAG,QAAQ,GAAG,KAAK;GAC5F,QAAQ;GACR,SAAS,EACP,eAAe,UACjB;GACA,GAAI,SAAS,WAAW,KAAA,IAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;GAClE,GAAI,SAAS,UAAU,KAAA,IAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EACjE,CAAC,EAAA,CACe,KAAQ;CAC1B;;;;;;;;;;;;CAaA,MAAc,4BACZ,cACA,WACA,UACA,MACA,SACY;EACZ,MAAM,iBAAiB,kCAAkC,OAAO;EAahE,QAAO,MAZgB,KAAK,UAAU,KAAK;GACzC,KAAK,kBAAkB,KAAK,iBAAiB,YAAY,GAAG,QAAQ;GACpE,QAAQ;GACR,SAAS;IACP,eAAe;IACf,gBAAgB;GAClB;GACA,MAAM,KAAK,UAAU,IAAI;GACzB,GAAI,eAAe,WAAW,KAAA,IAAY,EAAE,QAAQ,eAAe,OAAO,IAAI,CAAC;GAC/E,GAAI,eAAe,eAAe,KAAA,IAAY,EAAE,YAAY,eAAe,WAAW,IAAI,CAAC;GAC3F,GAAI,eAAe,UAAU,KAAA,IAAY,EAAE,OAAO,eAAe,MAAM,IAAI,CAAC;EAC9E,CAAC,EAAA,CACe,KAAQ;CAC1B;AACF"}