@backblaze-labs/b2-sdk 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -7,6 +7,49 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-01
+
+> Upgrading across the v4 native-API changes below? See [MIGRATION.md](./MIGRATION.md) for per-change migration steps.
+
+### Added
+
+- **Streaming and SSE-C polish helpers.** `IncrementalSha256` and the streams `sha256Hex()` helper are now available for SHA-256 checksum workflows, `SseCKeyMaterial` is the shared SSE-C key shape, and `EncryptionKey.generate()` mints random SSE-C keys with the existing redacted key wrapper.
+- **Named bucket/key option constants.** `BucketKeyOption.S3` and `KnownBucketKeyOption` document the currently known B2 bucket/application-key option while the response fields remain open to future B2-added option strings.
+- **Local sync symlink policy.** Built-in local scans and `synchronize()` now accept `localSymlinks: 'skip' | 'follow'`; follow mode only follows child symlink targets that resolve inside the configured local root and deduplicates repeated followed directory targets.
+- **Transfer progress cadence control.** Upload and single-request download options now accept `progressIntervalMillis`; set it to `0` to restore per-chunk byte progress callbacks.
+- **B2Simulator v4 route and GET/query compatibility.** The public simulator now accepts canonical `/b2api/v4` JSON routes while continuing to support `/b2api/v3`, rejects unsupported future version segments explicitly, and parses documented GET query forms for supported storage read/list and copy endpoints while preserving POST JSON compatibility. Closes #111.
+- **Partner redaction helpers are public.** The `@backblaze-labs/b2-sdk/partner` subpath now exports `PARTNER_TOKEN_REDACTED`, `APPLICATION_KEY_REDACTED`, and the pure `*ToRedactedJson` projection helpers and JSON result types for secret-scrubbed Partner authorization, group-member creation, and B2 Reserve trial-account responses. Closes #225.
+
+### Changed
+
+- **User-Agent release channel now distinguishes published SDK builds from development traffic.** `VERSION` remains the package semver string, while the outbound SDK product token reports `b2-sdk-typescript/<version>` only for stable publish-path builds and `b2-sdk-typescript/dev` for source, CI, `npm pack`, and prerelease builds. Closes #257.
+- **Partner group `b2Stats` counters are numbers, not strings.** BREAKING: `PartnerB2Stats.b2BytesStoredCount`, `b2FilesStoredCount`, and `bucketCount` are now `number` — matching what live B2 `b2_list_groups` / `b2_list_group_members` actually return — instead of the previously-assumed quoted decimal `string`. Callers that coerced these with `Number(...)` / `parseInt(...)` should drop the conversion. The Partner stats timestamps (`b2StatsAsOfTimestamp`, `groupStats.createdTimestamp`, `groupStats.groupStatsAsOfTimestamp`) are documented and modeled as B2's `dYYYYMMDD_mHHMMSS` string format rather than ISO 8601, and the `B2Simulator` now emits that shape (and `B2_GOOD_STANDING`) to match live B2. Confirmed against live B2. Closes #214.
+- **`b2_list_group_members` returns a single object, not an array.** BREAKING: `ListGroupMembersResponse` is now the single `ListGroupMembersResult` object (`{ groupId, groupName, groupMembers, nextEmail }`) that live B2 returns, matching `b2_list_groups`, rather than a one-element array. `PartnerClient.listGroupMembers()` and `PartnerRawClient.listGroupMembers()` resolve to that object — read `response.groupMembers` / `response.nextEmail` directly instead of `response[0]`. `PartnerClient.paginateGroupMembers()` is unchanged, and the `B2Simulator` now emits the object shape. Confirmed against live B2.
+- **Repository Node.js 22 CI and toolchain checks now use the JSDoc lint floor.**
+  CI and contributor docs now use Node 22.22.2+ for full project checks while
+  the published SDK runtime contract remains Node.js 22.3+. Closes #282.
+- **Progress byte callbacks are coalesced by default.** Transfer `onProgress` byte-only callbacks are throttled to the SDK's 100 ms default interval, while part-completion and final progress callbacks still emit immediately. Use `progressIntervalMillis: 0` when per-chunk progress sampling is required.
+- **Bucket default retention metadata now matches B2's nested wire shape.** BREAKING: `BucketInfo.defaultRetention` was removed because B2 does not return a top-level default-retention field; read `bucket.info.fileLockConfiguration.value?.defaultRetention` instead. `Bucket.getDefaultRetention()` now reads that nested field and can return `undefined` when file-lock configuration is unreadable. The nested default retention type also includes B2's unset response shape `{ mode: null, period: null }`; callers that checked `BucketRetentionMode.None` for unset bucket defaults should handle `null` mode on response metadata.
+- **Bucket replication configuration is now capability-filtered.** BREAKING: `BucketInfo.replicationConfiguration` changed from a bare `ReplicationConfiguration` to the wrapped `{ isClientAuthorizedToRead: boolean; value: ReplicationConfiguration | null }` shape B2 returns, and `Bucket.getReplication()` returns that wrapper. Callers accessing `.replicationConfiguration.asReplicationSource` must move to `.replicationConfiguration.value?.asReplicationSource`; `value` is `null` when replication is not configured or the caller is not authorized to read it (fail-closed). Request shapes (`CreateBucketRequest` / `UpdateBucketRequest`) keep the bare `ReplicationConfiguration`.
+- **Bucket default server-side encryption is now capability-filtered.** BREAKING: `BucketInfo.defaultServerSideEncryption` changed from a bare `EncryptionSetting` to the wrapped `{ isClientAuthorizedToRead: boolean; value: BucketDefaultServerSideEncryption | null }` shape B2 returns; check `bucket.info.defaultServerSideEncryption.isClientAuthorizedToRead` before reading `.value`, which is `null` only when the caller is not authorized to read it (fail-closed). When readable, an unset bucket default is represented as B2's `{ mode: null, algorithm: null }` no-encryption wire shape. The readable value type `BucketDefaultServerSideEncryption` is `PublicEncryptionSetting`, matching the public SSE response union used for file and part metadata; B2 only sets SSE-B2 or none as a bucket default and never exposes SSE-C key material. Request shapes (`CreateBucketRequest` / `UpdateBucketRequest` and the `B2Client.createBucket` / `updateBucket` options) now accept `BucketDefaultServerSideEncryptionSetting` (`SseB2Setting | NoEncryption`) and reject SSE-C, which B2 cannot use as a bucket default. Closes #210.
+- **Event notification custom headers match the B2 wire shape.** BREAKING: `EventNotificationRule.targetConfiguration.customHeaders` is now the documented array of `{ name, value }` objects instead of a lookup record, with simulator validation and round-trip behavior aligned to `b2_get_bucket_notification_rules` / `b2_set_bucket_notification_rules`. Existing record-shaped caller data can be migrated with `recordToNotificationCustomHeaders()`, and responses can be converted back to a lookup with `notificationCustomHeadersToRecord()`. Closes #189.
+- **List endpoints model folder and hide entries as a discriminated union.** BREAKING: `FileVersion.action` narrowed from `FileAction` to `ConcreteFileAction` because a virtual folder row is no longer a `FileVersion`. `ListFileNamesResponse.files` is now `readonly ListedFileVersion[]` and never includes hide markers; `ListFileNamesWithDelimiterResponse.files` is now `readonly FileNameListEntry[]` (`ListedFileVersion | FolderFileVersion`). `ListFileVersionsResponse.files` is now `readonly ListedConcreteFileVersion[]` (`ListedFileVersion | ListedHideFileVersion`), and `ListFileVersionsWithDelimiterResponse.files` is now `readonly FileVersionListEntry[]` (`ListedConcreteFileVersion | FolderFileVersion`). `b2_list_file_versions` hide markers use the listed hide-row shape with omitted Object Lock/encryption metadata and `contentType: "application/x-bz-hide-marker"`; `Bucket.unhideFile()` now returns that `ListedHideFileVersion | null` shape. `B2SyncPath.allVersions` changed from `FileVersion[]` to `ListedConcreteFileVersion[]`, so hidden sync version history now uses the listed hide-row shape rather than full `FileVersion` metadata. New literal and dynamic `delimiter?: string` overloads on `RawClient.listFileNames` / `listFileVersions` and the `Bucket.listFileNames` / `listFileVersions` / `paginateFileNames` / `paginateFileVersions` facades surface folder unions only when delimiter may be present; `FolderFileVersion` virtual-folder rows have `fileId: null` and `contentType: null`, and non-delimiter facade calls reject folder/null-ID rows before returning them. The simulator now honors the `delimiter` (and its `prefix` interaction), emits folder entries only for visible file-name listings, and keeps hide markers in file-version listings. Closes #191.
+- **Raw native storage endpoints now use the published `/b2api/v4` route.** All SDK-owned B2 native storage URLs are built from a single centralized v4 policy in the raw URL builder, replacing the previous mix of `/b2api/v3` and `/b2api/v4` per-endpoint segments. The version is no longer a per-call parameter, so endpoint/version drift is structurally prevented. This is runtime-compatible (B2 accepts both routes and the auth token is version-agnostic) and `RawClient` public method signatures are unchanged; read/list endpoints remain POST JSON as the docs permit. Closes #104.
+- **Bucket type request and response contracts are now separate.** BREAKING: `BucketInfo.bucketType` is now the open `BucketResponseType` (`KnownBucketResponseType | (string & {})`), which adds the response-only `'shared'` value (`KnownBucketResponseType.Shared`) and tolerates future B2-added types, so exhaustive switches over the old closed `BucketType` on a response now need a default case. Create/update requests still accept only the settable `BucketType` (`allPublic` / `allPrivate` / `snapshot` / `restricted`). `ListBucketsRequest.bucketTypes` (and the `B2Client.listBuckets` filter option) changed from `BucketType[]` to `BucketTypesFilter` (`readonly ['all'] | readonly BucketListType[]`), which accepts `'shared'`, future type strings, and the special `['all']`; the simulator now rejects empty filters, `'all'` mixed with other values, and non-string entries at runtime, matching B2. Closes #107.
+
+### Fixed
+
+- **B2-to-local sync removes the managed download staging root on completion.** Completed downloads now clean the SDK-owned `.b2sdk-download-staging` directory after per-run staging entries are gone, including no-op follow-up syncs that only find an older marker-only staging root. Closes #156.
+- **Progress throttling drains part-boundary bytes safely.** A pending coalesced byte-progress update is emitted before the part-completion update, delayed progress listener errors no longer escape detached timers, and pending progress timers are cleared on transfer cleanup.
+- **Followed local symlinks stay inside the sync root.** `localSymlinks: 'follow'` skips file and directory symlink targets outside the local root, avoids repeated traversal of the same followed directory identity, and `synchronize()` now honors followed in-root file targets before upload actions.
+- **B2 content file-info upload headers are now percent-encoded.** `contentDisposition`, `contentLanguage`, `expires`, `cacheControl`, and `contentEncoding` values sent as `X-Bz-Info-b2-*` upload headers are now encoded with B2 file-info encoding, matching the custom `fileInfo` path, so values with `%`, non-ASCII, or other unsafe characters round-trip correctly. These values must now be passed raw (unencoded). Closes #213.
+- **Partner and Computer Backup API paths pin their wire version per method.** Partner group-management endpoints (`b2_list_groups`, `b2_list_group_members`, `b2_create_group_member`, `b2_eject_group_member`, `b2_reserve_trial_create_account`) now target `/b2api/v4`, matching the Partner API docs' code samples, while Partner `b2_authorize_account` stays on `/b2api/v3` (the version B2 documents for the suite-grouped `apiInfo` response) and Computer Backup stays on `api/backup/v1`. Each version comes from a single per-suite URL builder instead of a per-call segment, and request-construction guardrails assert the pinned version per method so the routes cannot silently drift. A gated live smoke (`tests/integration/partner-backup-contracts.test.ts`, master-key credentials) is included to confirm, when run, that live B2 accepts the read-only routes at their pinned versions. Closes #228.
+- **Partner and Computer Backup mutations no longer replay on 401 reauth.** Non-idempotent Partner/Backup mutations (`b2_create_group_member`, `b2_eject_group_member`, `b2_reserve_trial_create_account`, `bz_delete_computer`) are tagged `idempotent: false`, and `RetryTransport` now blocks both transient retries and expired-token reauth-replay for them from a single shared endpoint registry. Previously the retry-suppression (raw client `maxRetries: 0`) and the transport's reauth-replay guard were separate lists that could drift, risking a double account-create or delete if a new mutation was added to one but not the other; a known mutation URL now also fails closed if a transport wrapper strips the marker. The exported `HttpRequest` type gains an optional `idempotent?: false` field for custom transports. Closes #215.
+- **Storage reauthorization coalesces concurrent 401s into a single refresh.** Expired-token reauth on `B2Client` now shares one in-flight `authorizeAccount` across all waiting requests through a shared coalescer (the Partner client's bespoke in-flight state machine was lifted into the same helper), instead of firing one authorize per concurrent 401. A failed or aborted refresh no longer clears the existing token first, so the client stays recoverable, and per-request `AbortSignal`s are honored (one waiter aborting does not cancel the shared refresh for the others). New `B2ClientAuthorizeOptions` / `AuthorizeAccountOptions` exports expose the abort signal on authorize and reauthorize. Closes #216.
+- **B2Simulator large-file lock echo fidelity.** `b2_start_large_file` and `b2_list_unfinished_large_files` now redact the `fileRetention` / `legalHold` echoes for callers lacking `readFileRetentions` / `readFileLegalHolds`, matching B2's capability-filtered response shape; previously the simulator always reported `isClientAuthorizedToRead: true`. The `StartLargeFileResponse` / `UnfinishedLargeFile` DTOs already expose the `fileRetention` / `legalHold` / `serverSideEncryption` echo fields and no longer carry a phantom top-level bucket `defaultRetention`. Closes #41.
+- **Upload retries no longer replay spoofable post-start network errors.** High-level uploads still retry network failures before an upload POST is attempted, but a post-start `NetworkError` with nested `ECONNREFUSED` no longer bypasses the default protection against ambiguous single-request replay. Set `retryResponseBodyFailures: true` only when duplicate versions or replayed parts are acceptable.
+- **SSE-B2 large-file uploads no longer repeat encryption headers on each part.** SSE-B2 (B2-managed) encryption is configured once on `b2_start_large_file`; `b2_upload_part` only accepts customer-key headers, so the SDK no longer sends the SSE-B2 `serverSideEncryption` setting on each part upload. SSE-C customer keys are still applied per part.
+
 ## [0.3.0] - 2026-08-18
 
 ### Added
@@ -261,7 +304,8 @@ First public release of `@backblaze-labs/b2-sdk`. Everything below is new in thi
 - TypeDoc for API documentation
 - Vitest test suite with 486 tests across 20 files at ≥ 95% statement coverage. Tests run cleanly under both vitest (Node) and Bun's vitest-compat (no module-level mocking required)
 
-[Unreleased]: git+https://github.com/backblaze-labs/b2-sdk-typescript/compare/v0.3.0...HEAD
+[Unreleased]: git+https://github.com/backblaze-labs/b2-sdk-typescript/compare/v0.4.0...HEAD
+[0.4.0]: git+https://github.com/backblaze-labs/b2-sdk-typescript/compare/v0.3.0...v0.4.0
 [0.3.0]: git+https://github.com/backblaze-labs/b2-sdk-typescript/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/backblaze-labs/b2-sdk-typescript/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/backblaze-labs/b2-sdk-typescript/releases/tag/v0.1.0

package/README.md

@@ -401,6 +401,7 @@ await bucket.setNotificationRules([
       targetType: 'webhook',
       url: 'https://my-app.com/webhooks/b2',
       hmacSha256SigningSecret: process.env.B2_WEBHOOK_SECRET,
+      customHeaders: [{ name: 'X-B2-Source', value: 'uploads' }],
     },
   },
 ])
@@ -524,6 +525,18 @@ and per-request retry overrides: pass `{ signal, retry }` to `getUploadUrl`,
 `getUploadPartUrl`, `uploadFile`, and `uploadPart`. The older positional
 `signal, retry` form remains available only for source compatibility.
 
+### Raw native API version policy
+
+`RawClient` builds SDK-owned B2 native storage URLs with `/b2api/v4`, matching the
+current published native API docs. The version is centralized in the raw URL
+builder path; upload and download URLs returned by B2 are used as returned.
+
+Raw JSON endpoints use POST bodies, including read/list operations whose docs
+also show GET query examples such as `b2_get_upload_url`, `b2_get_file_info`,
+`b2_list_file_names`, and `b2_list_keys`. B2 documents POST JSON compatibility
+for these operations, so the SDK keeps the long-standing POST shape while moving
+the path version to v4.
+
 Every export is documented with full type signatures in the [API reference](https://backblaze-labs.github.io/b2-sdk-typescript/).
 
 ## Sync filters
@@ -580,12 +593,12 @@ const client = new B2Client({
 Every request the SDK issues carries a User-Agent header that Backblaze can grep server logs by:
 
 ```
-b2-sdk-typescript/<version> (typescript; @backblaze-labs/b2-sdk; node/<node-version>; linux; x64)
+b2-sdk-typescript/<version-or-dev> (typescript; @backblaze-labs/b2-sdk; node/<node-version>; linux; x64)
 ```
 
 Both `b2-sdk-typescript/` (stable product token) and `@backblaze-labs/b2-sdk` (npm package name) are part of the documented contract — log queries that match either one find every request issued by this SDK. The comment block also reports the runtime (`node/<version>`, `bun/<version>`, `deno/<version>`, or `browser`) plus the OS and architecture on non-browser runtimes.
 
-The version is read straight from `package.json` via a JSON import attribute, so bumping the package version automatically propagates to the UA, the published artifact, and the runtime constant. There is no second source of truth to keep in sync.
+The public `VERSION` constant is always the package semver string. The User-Agent product token reports that semver only from a stable published package; source, CI, `npm pack`, and prerelease builds report `b2-sdk-typescript/dev` so development traffic stays distinguishable.
 
 To prepend your own application identifier:
 
@@ -595,7 +608,7 @@ const client = new B2Client({
   applicationKey,
   userAgent: 'my-app/1.0',
 })
-// → "my-app/1.0 b2-sdk-typescript/<version> (typescript; @backblaze-labs/b2-sdk; node/<node-version>; linux; x64)"
+// → "my-app/1.0 b2-sdk-typescript/<version-or-dev> (typescript; @backblaze-labs/b2-sdk; node/<node-version>; linux; x64)"
 ```
 
 ## SSRF guard
@@ -773,14 +786,14 @@ So you get both: an `npm install`-ready `dist/` (ESM + CJS + DTS), *and* a `src/
 
 | Runtime | Version | Status |
 |---|---|---|
-| Node.js | 22.3+ | Primary target. CI runs the fast suite on Linux, Windows, and macOS for Node 22.18 + 24; slow and coverage jobs run on Linux. `FileSource` uses weaker size/mtime validation on Windows because portable dev/inode and ctime fields are unreliable there. |
+| Node.js | 22.3+ | Primary target. CI runs the fast suite on Linux, Windows, and macOS for Node 22.22.2 + 24; slow and coverage jobs run on Linux. `FileSource` uses weaker size/mtime validation on Windows because portable dev/inode and ctime fields are unreliable there. |
 | Bun | latest | Tested in CI via `bun test src/` + example typecheck. |
 | Deno | 2.x | Source isomorphism verified in CI via `deno check` against `src/`. |
 | Browsers | Chromium, Firefox, WebKit (last 2 evergreen) | Tested in CI via Playwright. |
 | Cloudflare Workers | - | Compatible target when the standard Web APIs above are available; not yet smoke-tested in CI with a Workers runtime. |
 | Vercel Edge | - | Compatible target when the standard Web APIs above are available; not yet smoke-tested in CI with Vercel Edge. |
 
-Requires: `fetch`, Web Streams, `crypto.subtle`, `AbortSignal`. Node < 22.3 is not supported (Node 20 reached EOL April 2026). `FileSource(path)` throws on older Node 22.x runtimes that lack synchronous `process.getBuiltinModule()`; `FileSource.fromPath(path)` remains the async construction path for supported Node filesystem platforms. On Windows, `FileSource` is supported with weaker size/mtime validation because portable dev/inode and ctime fields are unreliable there.
+Requires: `fetch`, Web Streams, `crypto.subtle`, `AbortSignal`. Node < 22.3 is not supported (Node 20 reached EOL April 2026). `FileSource(path)` throws on runtimes that lack `process.getBuiltinModule('node:fs')`; `FileSource.fromPath(path)` remains the async construction path for supported Node filesystem platforms. On Windows, `FileSource` is supported with weaker size/mtime validation because portable dev/inode and ctime fields are unreliable there.
 
 The browser test suite (`pnpm test:browser`) runs the same source against real Chromium, Firefox, and WebKit instances. Only Node-specific tests (filename pattern `*.node.test.ts`, covering `node:fs`, `node:os`, `node:util.inspect`) are skipped.
 

package/dist/_virtual/_b2-sdk-version-json.cjs

@@ -1,4 +1,4 @@
 //#region \0b2-sdk-version-json
-var _b2_sdk_version_json_default = { "version": "0.3.0" };
+var _b2_sdk_version_json_default = { "version": "0.4.0" };
 //#endregion
 exports.default = _b2_sdk_version_json_default;

package/dist/_virtual/_b2-sdk-version-json.js

@@ -1,4 +1,4 @@
 //#region \0b2-sdk-version-json
-var _b2_sdk_version_json_default = { "version": "0.3.0" };
+var _b2_sdk_version_json_default = { "version": "0.4.0" };
 //#endregion
 export { _b2_sdk_version_json_default as default };

package/dist/auth/reauth-coalescer.cjs

@@ -0,0 +1,65 @@
+const require_abort = require("../util/abort.cjs");
+//#region src/auth/reauth-coalescer.ts
+/**
+* Coalesces concurrent reauthorization requests into one in-flight refresh.
+* Each caller waits independently with its own abort signal. The shared
+* refresh receives a coalescer-owned signal and is aborted only when every
+* active waiter has stopped waiting before the refresh settles. A successful,
+* failed, or aborted refresh clears the in-flight slot so the next call can
+* start a new refresh.
+*
+* @internal
+*/
+var ReauthCoalescer = class {
+	#refresh;
+	#inflight = null;
+	/**
+	* Creates a new reauthorization coalescer.
+	*
+	* @param refresh - The callback that performs one shared refresh.
+	*/
+	constructor(refresh) {
+		this.#refresh = refresh;
+	}
+	/**
+	* Runs or joins the current refresh. If `signal` is already aborted, the
+	* refresh callback is not called. If this waiter aborts while other waiters
+	* remain, only this call rejects; the shared refresh continues for the
+	* remaining waiters.
+	*
+	* @param signal - Optional abort signal for this waiter.
+	*
+	* @returns The shared refresh result.
+	*/
+	run(signal) {
+		require_abort.throwIfSignalAborted(signal);
+		const inflight = this.#inflight ?? this.start();
+		inflight.waiters += 1;
+		return require_abort.raceWithAbort(inflight.promise, signal).finally(() => {
+			inflight.waiters -= 1;
+			if (inflight.waiters === 0 && !inflight.settled && !inflight.controller.signal.aborted)
+ /* v8 ignore next -- waiters can only leave an unsettled refresh by aborting their signal */
+			inflight.controller.abort(signal?.aborted === true ? require_abort.abortReason(signal) : void 0);
+		});
+	}
+	start() {
+		const controller = new AbortController();
+		const inflight = {
+			controller,
+			promise: require_abort.raceWithAbort(this.#refresh(controller.signal), controller.signal).finally(() => {
+				/* v8 ignore next -- defensive: callers cannot start a replacement while this is current */
+				if (this.#inflight?.controller !== controller) return;
+				this.#inflight.settled = true;
+				this.#inflight = null;
+			}),
+			waiters: 0,
+			settled: false
+		};
+		this.#inflight = inflight;
+		return inflight;
+	}
+};
+//#endregion
+exports.ReauthCoalescer = ReauthCoalescer;
+
+//# sourceMappingURL=reauth-coalescer.cjs.map

package/dist/auth/reauth-coalescer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reauth-coalescer.cjs","names":[],"sources":["../../src/auth/reauth-coalescer.ts"],"sourcesContent":["import { abortReason, raceWithAbort, throwIfSignalAborted } from '../util/abort.ts'\n\n/** Callback that performs the shared reauthorization work. */\nexport type ReauthRefresh<T> = (signal: AbortSignal) => Promise<T>\n\ninterface InflightReauth<T> {\n  readonly controller: AbortController\n  readonly promise: Promise<T>\n  waiters: number\n  settled: boolean\n}\n\n/**\n * Coalesces concurrent reauthorization requests into one in-flight refresh.\n * Each caller waits independently with its own abort signal. The shared\n * refresh receives a coalescer-owned signal and is aborted only when every\n * active waiter has stopped waiting before the refresh settles. A successful,\n * failed, or aborted refresh clears the in-flight slot so the next call can\n * start a new refresh.\n *\n * @internal\n */\nexport class ReauthCoalescer<T> {\n  readonly #refresh: ReauthRefresh<T>\n  #inflight: InflightReauth<T> | null = null\n\n  /**\n   * Creates a new reauthorization coalescer.\n   *\n   * @param refresh - The callback that performs one shared refresh.\n   */\n  constructor(refresh: ReauthRefresh<T>) {\n    this.#refresh = refresh\n  }\n\n  /**\n   * Runs or joins the current refresh. If `signal` is already aborted, the\n   * refresh callback is not called. If this waiter aborts while other waiters\n   * remain, only this call rejects; the shared refresh continues for the\n   * remaining waiters.\n   *\n   * @param signal - Optional abort signal for this waiter.\n   *\n   * @returns The shared refresh result.\n   */\n  run(signal?: AbortSignal): Promise<T> {\n    throwIfSignalAborted(signal)\n    const inflight = this.#inflight ?? this.start()\n    inflight.waiters += 1\n    return raceWithAbort(inflight.promise, signal).finally(() => {\n      inflight.waiters -= 1\n      if (inflight.waiters === 0 && !inflight.settled && !inflight.controller.signal.aborted) {\n        /* v8 ignore next -- waiters can only leave an unsettled refresh by aborting their signal */\n        inflight.controller.abort(signal?.aborted === true ? abortReason(signal) : undefined)\n      }\n    })\n  }\n\n  private start(): InflightReauth<T> {\n    const controller = new AbortController()\n    const promise = raceWithAbort(this.#refresh(controller.signal), controller.signal).finally(\n      () => {\n        /* v8 ignore next -- defensive: callers cannot start a replacement while this is current */\n        if (this.#inflight?.controller !== controller) return\n        this.#inflight.settled = true\n        this.#inflight = null\n      },\n    )\n    const inflight: InflightReauth<T> = {\n      controller,\n      promise,\n      waiters: 0,\n      settled: false,\n    }\n    this.#inflight = inflight\n    return inflight\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,IAAa,kBAAb,MAAgC;CAC9B;CACA,YAAsC;;;;;;CAOtC,YAAY,SAA2B;EACrC,KAAK,WAAW;CAClB;;;;;;;;;;;CAYA,IAAI,QAAkC;EACpC,cAAA,qBAAqB,MAAM;EAC3B,MAAM,WAAW,KAAK,aAAa,KAAK,MAAM;EAC9C,SAAS,WAAW;EACpB,OAAO,cAAA,cAAc,SAAS,SAAS,MAAM,CAAC,CAAC,cAAc;GAC3D,SAAS,WAAW;GACpB,IAAI,SAAS,YAAY,KAAK,CAAC,SAAS,WAAW,CAAC,SAAS,WAAW,OAAO;;GAE7E,SAAS,WAAW,MAAM,QAAQ,YAAY,OAAO,cAAA,YAAY,MAAM,IAAI,KAAA,CAAS;EAExF,CAAC;CACH;CAEA,QAAmC;EACjC,MAAM,aAAa,IAAI,gBAAgB;EASvC,MAAM,WAA8B;GAClC;GACA,SAVc,cAAA,cAAc,KAAK,SAAS,WAAW,MAAM,GAAG,WAAW,MAAM,CAAC,CAAC,cAC3E;;IAEJ,IAAI,KAAK,WAAW,eAAe,YAAY;IAC/C,KAAK,UAAU,UAAU;IACzB,KAAK,YAAY;GACnB,CAIA;GACA,SAAS;GACT,SAAS;EACX;EACA,KAAK,YAAY;EACjB,OAAO;CACT;AACF"}

package/dist/auth/reauth-coalescer.d.cts

@@ -0,0 +1,34 @@
+/** Callback that performs the shared reauthorization work. */
+export type ReauthRefresh<T> = (signal: AbortSignal) => Promise<T>;
+/**
+ * Coalesces concurrent reauthorization requests into one in-flight refresh.
+ * Each caller waits independently with its own abort signal. The shared
+ * refresh receives a coalescer-owned signal and is aborted only when every
+ * active waiter has stopped waiting before the refresh settles. A successful,
+ * failed, or aborted refresh clears the in-flight slot so the next call can
+ * start a new refresh.
+ *
+ * @internal
+ */
+export declare class ReauthCoalescer<T> {
+    #private;
+    /**
+     * Creates a new reauthorization coalescer.
+     *
+     * @param refresh - The callback that performs one shared refresh.
+     */
+    constructor(refresh: ReauthRefresh<T>);
+    /**
+     * Runs or joins the current refresh. If `signal` is already aborted, the
+     * refresh callback is not called. If this waiter aborts while other waiters
+     * remain, only this call rejects; the shared refresh continues for the
+     * remaining waiters.
+     *
+     * @param signal - Optional abort signal for this waiter.
+     *
+     * @returns The shared refresh result.
+     */
+    run(signal?: AbortSignal): Promise<T>;
+    private start;
+}
+//# sourceMappingURL=reauth-coalescer.d.ts.map

package/dist/auth/reauth-coalescer.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reauth-coalescer.d.ts","sourceRoot":"","sources":["../../src/auth/reauth-coalescer.js"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AASlE;;;;;;;;;GASG;AACH,qBAAa,eAAe,CAAC,CAAC;;IAI5B;;;;OAIG;gBACS,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IAIrC;;;;;;;;;OASG;IACH,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAarC,OAAO,CAAC,KAAK;CAmBd"}

package/dist/auth/reauth-coalescer.d.ts

@@ -0,0 +1,34 @@
+/** Callback that performs the shared reauthorization work. */
+export type ReauthRefresh<T> = (signal: AbortSignal) => Promise<T>;
+/**
+ * Coalesces concurrent reauthorization requests into one in-flight refresh.
+ * Each caller waits independently with its own abort signal. The shared
+ * refresh receives a coalescer-owned signal and is aborted only when every
+ * active waiter has stopped waiting before the refresh settles. A successful,
+ * failed, or aborted refresh clears the in-flight slot so the next call can
+ * start a new refresh.
+ *
+ * @internal
+ */
+export declare class ReauthCoalescer<T> {
+    #private;
+    /**
+     * Creates a new reauthorization coalescer.
+     *
+     * @param refresh - The callback that performs one shared refresh.
+     */
+    constructor(refresh: ReauthRefresh<T>);
+    /**
+     * Runs or joins the current refresh. If `signal` is already aborted, the
+     * refresh callback is not called. If this waiter aborts while other waiters
+     * remain, only this call rejects; the shared refresh continues for the
+     * remaining waiters.
+     *
+     * @param signal - Optional abort signal for this waiter.
+     *
+     * @returns The shared refresh result.
+     */
+    run(signal?: AbortSignal): Promise<T>;
+    private start;
+}
+//# sourceMappingURL=reauth-coalescer.d.ts.map

package/dist/auth/reauth-coalescer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reauth-coalescer.d.ts","sourceRoot":"","sources":["../../src/auth/reauth-coalescer.js"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AASlE;;;;;;;;;GASG;AACH,qBAAa,eAAe,CAAC,CAAC;;IAI5B;;;;OAIG;gBACS,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IAIrC;;;;;;;;;OASG;IACH,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAarC,OAAO,CAAC,KAAK;CAmBd"}

package/dist/auth/reauth-coalescer.js

@@ -0,0 +1,65 @@
+import { abortReason, raceWithAbort, throwIfSignalAborted } from "../util/abort.js";
+//#region src/auth/reauth-coalescer.ts
+/**
+* Coalesces concurrent reauthorization requests into one in-flight refresh.
+* Each caller waits independently with its own abort signal. The shared
+* refresh receives a coalescer-owned signal and is aborted only when every
+* active waiter has stopped waiting before the refresh settles. A successful,
+* failed, or aborted refresh clears the in-flight slot so the next call can
+* start a new refresh.
+*
+* @internal
+*/
+var ReauthCoalescer = class {
+	#refresh;
+	#inflight = null;
+	/**
+	* Creates a new reauthorization coalescer.
+	*
+	* @param refresh - The callback that performs one shared refresh.
+	*/
+	constructor(refresh) {
+		this.#refresh = refresh;
+	}
+	/**
+	* Runs or joins the current refresh. If `signal` is already aborted, the
+	* refresh callback is not called. If this waiter aborts while other waiters
+	* remain, only this call rejects; the shared refresh continues for the
+	* remaining waiters.
+	*
+	* @param signal - Optional abort signal for this waiter.
+	*
+	* @returns The shared refresh result.
+	*/
+	run(signal) {
+		throwIfSignalAborted(signal);
+		const inflight = this.#inflight ?? this.start();
+		inflight.waiters += 1;
+		return raceWithAbort(inflight.promise, signal).finally(() => {
+			inflight.waiters -= 1;
+			if (inflight.waiters === 0 && !inflight.settled && !inflight.controller.signal.aborted)
+ /* v8 ignore next -- waiters can only leave an unsettled refresh by aborting their signal */
+			inflight.controller.abort(signal?.aborted === true ? abortReason(signal) : void 0);
+		});
+	}
+	start() {
+		const controller = new AbortController();
+		const inflight = {
+			controller,
+			promise: raceWithAbort(this.#refresh(controller.signal), controller.signal).finally(() => {
+				/* v8 ignore next -- defensive: callers cannot start a replacement while this is current */
+				if (this.#inflight?.controller !== controller) return;
+				this.#inflight.settled = true;
+				this.#inflight = null;
+			}),
+			waiters: 0,
+			settled: false
+		};
+		this.#inflight = inflight;
+		return inflight;
+	}
+};
+//#endregion
+export { ReauthCoalescer };
+
+//# sourceMappingURL=reauth-coalescer.js.map

package/dist/auth/reauth-coalescer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reauth-coalescer.js","names":[],"sources":["../../src/auth/reauth-coalescer.ts"],"sourcesContent":["import { abortReason, raceWithAbort, throwIfSignalAborted } from '../util/abort.ts'\n\n/** Callback that performs the shared reauthorization work. */\nexport type ReauthRefresh<T> = (signal: AbortSignal) => Promise<T>\n\ninterface InflightReauth<T> {\n  readonly controller: AbortController\n  readonly promise: Promise<T>\n  waiters: number\n  settled: boolean\n}\n\n/**\n * Coalesces concurrent reauthorization requests into one in-flight refresh.\n * Each caller waits independently with its own abort signal. The shared\n * refresh receives a coalescer-owned signal and is aborted only when every\n * active waiter has stopped waiting before the refresh settles. A successful,\n * failed, or aborted refresh clears the in-flight slot so the next call can\n * start a new refresh.\n *\n * @internal\n */\nexport class ReauthCoalescer<T> {\n  readonly #refresh: ReauthRefresh<T>\n  #inflight: InflightReauth<T> | null = null\n\n  /**\n   * Creates a new reauthorization coalescer.\n   *\n   * @param refresh - The callback that performs one shared refresh.\n   */\n  constructor(refresh: ReauthRefresh<T>) {\n    this.#refresh = refresh\n  }\n\n  /**\n   * Runs or joins the current refresh. If `signal` is already aborted, the\n   * refresh callback is not called. If this waiter aborts while other waiters\n   * remain, only this call rejects; the shared refresh continues for the\n   * remaining waiters.\n   *\n   * @param signal - Optional abort signal for this waiter.\n   *\n   * @returns The shared refresh result.\n   */\n  run(signal?: AbortSignal): Promise<T> {\n    throwIfSignalAborted(signal)\n    const inflight = this.#inflight ?? this.start()\n    inflight.waiters += 1\n    return raceWithAbort(inflight.promise, signal).finally(() => {\n      inflight.waiters -= 1\n      if (inflight.waiters === 0 && !inflight.settled && !inflight.controller.signal.aborted) {\n        /* v8 ignore next -- waiters can only leave an unsettled refresh by aborting their signal */\n        inflight.controller.abort(signal?.aborted === true ? abortReason(signal) : undefined)\n      }\n    })\n  }\n\n  private start(): InflightReauth<T> {\n    const controller = new AbortController()\n    const promise = raceWithAbort(this.#refresh(controller.signal), controller.signal).finally(\n      () => {\n        /* v8 ignore next -- defensive: callers cannot start a replacement while this is current */\n        if (this.#inflight?.controller !== controller) return\n        this.#inflight.settled = true\n        this.#inflight = null\n      },\n    )\n    const inflight: InflightReauth<T> = {\n      controller,\n      promise,\n      waiters: 0,\n      settled: false,\n    }\n    this.#inflight = inflight\n    return inflight\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,IAAa,kBAAb,MAAgC;CAC9B;CACA,YAAsC;;;;;;CAOtC,YAAY,SAA2B;EACrC,KAAK,WAAW;CAClB;;;;;;;;;;;CAYA,IAAI,QAAkC;EACpC,qBAAqB,MAAM;EAC3B,MAAM,WAAW,KAAK,aAAa,KAAK,MAAM;EAC9C,SAAS,WAAW;EACpB,OAAO,cAAc,SAAS,SAAS,MAAM,CAAC,CAAC,cAAc;GAC3D,SAAS,WAAW;GACpB,IAAI,SAAS,YAAY,KAAK,CAAC,SAAS,WAAW,CAAC,SAAS,WAAW,OAAO;;GAE7E,SAAS,WAAW,MAAM,QAAQ,YAAY,OAAO,YAAY,MAAM,IAAI,KAAA,CAAS;EAExF,CAAC;CACH;CAEA,QAAmC;EACjC,MAAM,aAAa,IAAI,gBAAgB;EASvC,MAAM,WAA8B;GAClC;GACA,SAVc,cAAc,KAAK,SAAS,WAAW,MAAM,GAAG,WAAW,MAAM,CAAC,CAAC,cAC3E;;IAEJ,IAAI,KAAK,WAAW,eAAe,YAAY;IAC/C,KAAK,UAAU,UAAU;IACzB,KAAK,YAAY;GACnB,CAIA;GACA,SAAS;GACT,SAAS;EACX;EACA,KAAK,YAAY;EACjB,OAAO;CACT;AACF"}

package/dist/backup/raw.cjs

@@ -1,16 +1,42 @@
 const require_url = require("../raw/url.cjs");
 const require_endpoint_url = require("../partner/endpoint-url.cjs");
 //#region src/backup/raw.ts
-var BACKUP_API_V1 = {
+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.
 *
@@ -81,10 +107,10 @@ var BackupRawClient = class {
 	* @experimental Computer Backup API surface; shape may change as the Backup API docs evolve.
 	*/
 	async deleteComputer(backupApiUrl, authToken, request, options) {
-		return this.postJson(backupApiUrl, authToken, "bz_delete_computer", {
+		return normalizeDeleteComputerResponse(await this.postNonRetryingMutationJson(backupApiUrl, authToken, "bz_delete_computer", {
 			accountId: request.accountId,
 			computerId: request.computerId
-		}, require_endpoint_url.nonRetryingMutationRequestOptions(options));
+		}, options));
 	}
 	safeBackupApiUrl(backupApiUrl) {
 		return require_endpoint_url.validatePartnerEndpointUrl(backupApiUrl, "backupApiUrl", backupEndpointAllowedSuffixes(this.transport, this.authorizedEndpointSuffixes));
@@ -102,10 +128,7 @@ var BackupRawClient = class {
 	*/
 	async getJson(backupApiUrl, authToken, endpoint, query, options) {
 		return (await this.transport.send({
-			url: require_endpoint_url.withQueryString(require_url.b2Url(this.safeBackupApiUrl(backupApiUrl), {
-				...BACKUP_API_V1,
-				endpoint
-			}), query),
+			url: require_endpoint_url.withQueryString(backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint), query),
 			method: "GET",
 			headers: { Authorization: authToken },
 			...options?.signal !== void 0 ? { signal: options.signal } : {},
@@ -113,7 +136,7 @@ var BackupRawClient = class {
 		})).json();
 	}
 	/**
-	* Sends a JSON POST request to the specified Computer Backup API endpoint.
+	* 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.
@@ -123,20 +146,19 @@ var BackupRawClient = class {
 	*
 	* @returns The parsed JSON response.
 	*/
-	async postJson(backupApiUrl, authToken, endpoint, body, options) {
+	async postNonRetryingMutationJson(backupApiUrl, authToken, endpoint, body, options) {
+		const requestOptions = require_endpoint_url.nonRetryingMutationRequestOptions(options);
 		return (await this.transport.send({
-			url: require_url.b2Url(this.safeBackupApiUrl(backupApiUrl), {
-				...BACKUP_API_V1,
-				endpoint
-			}),
+			url: backupEndpointUrl(this.safeBackupApiUrl(backupApiUrl), endpoint),
 			method: "POST",
 			headers: {
 				Authorization: authToken,
 				"Content-Type": "application/json"
 			},
 			body: JSON.stringify(body),
-			...options?.signal !== void 0 ? { signal: options.signal } : {},
-			...options?.retry !== void 0 ? { retry: options.retry } : {}
+			...requestOptions.signal !== void 0 ? { signal: requestOptions.signal } : {},
+			...requestOptions.idempotent !== void 0 ? { idempotent: requestOptions.idempotent } : {},
+			...requestOptions.retry !== void 0 ? { retry: requestOptions.retry } : {}
 		})).json();
 	}
 };

package/dist/backup/raw.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"raw.cjs","names":[],"sources":["../../src/backup/raw.ts"],"sourcesContent":["import 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  ListComputersRequest,\n  ListComputersResponse,\n} from '../types/backup.ts'\n\nconst BACKUP_API_V1: B2EndpointUrlOptions = { prefix: 'api/backup', version: 'v1' }\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\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    return this.postJson<DeleteComputerResponse>(\n      backupApiUrl,\n      authToken,\n      'bz_delete_computer',\n      {\n        accountId: request.accountId,\n        computerId: request.computerId,\n      },\n      nonRetryingMutationRequestOptions(options),\n    )\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(\n        b2Url(this.safeBackupApiUrl(backupApiUrl), { ...BACKUP_API_V1, endpoint }),\n        query,\n      ),\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 JSON 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 postJson<T>(\n    backupApiUrl: string,\n    authToken: string,\n    endpoint: string,\n    body: unknown,\n    options?: BackupRawRequestOptions,\n  ): Promise<T> {\n    const response = await this.transport.send({\n      url: b2Url(this.safeBackupApiUrl(backupApiUrl), { ...BACKUP_API_V1, endpoint }),\n      method: 'POST',\n      headers: {\n        Authorization: authToken,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n      ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n      ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n    })\n    return response.json<T>()\n  }\n}\n"],"mappings":";;;AAiBA,IAAM,gBAAsC;CAAE,QAAQ;CAAc,SAAS;AAAK;AAqClF,SAAS,8BACP,WACA,oBACmB;CACnB,OAAO,qBAAA,wBAAwB,WAAW,oBAAoB;EAC5D,cACE;EACF,eACE;CACJ,CAAC;AACH;;;;;;;;;;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;EACjC,OAAO,KAAK,SACV,cACA,WACA,sBACA;GACE,WAAW,QAAQ;GACnB,YAAY,QAAQ;EACtB,GACA,qBAAA,kCAAkC,OAAO,CAC3C;CACF;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;EAaZ,QAAO,MAZgB,KAAK,UAAU,KAAK;GACzC,KAAK,qBAAA,gBACH,YAAA,MAAM,KAAK,iBAAiB,YAAY,GAAG;IAAE,GAAG;IAAe;GAAS,CAAC,GACzE,KACF;GACA,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,SACZ,cACA,WACA,UACA,MACA,SACY;EAYZ,QAAO,MAXgB,KAAK,UAAU,KAAK;GACzC,KAAK,YAAA,MAAM,KAAK,iBAAiB,YAAY,GAAG;IAAE,GAAG;IAAe;GAAS,CAAC;GAC9E,QAAQ;GACR,SAAS;IACP,eAAe;IACf,gBAAgB;GAClB;GACA,MAAM,KAAK,UAAU,IAAI;GACzB,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;AACF"}
+{"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

@@ -107,7 +107,7 @@ export declare class BackupRawClient {
      */
     private getJson;
     /**
-     * Sends a JSON POST request to the specified Computer Backup API endpoint.
+     * 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.
@@ -117,6 +117,6 @@ export declare class BackupRawClient {
      *
      * @returns The parsed JSON response.
      */
-    private postJson;
+    private postNonRetryingMutationJson;
 }
 //# sourceMappingURL=raw.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/backup/raw.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AASzD,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAI3B,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;AAcD;;;;;;;;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;IAalC,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;OAUG;YACW,OAAO;IAsBrB;;;;;;;;;;OAUG;YACW,QAAQ;CAoBvB"}
+{"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

@@ -107,7 +107,7 @@ export declare class BackupRawClient {
      */
     private getJson;
     /**
-     * Sends a JSON POST request to the specified Computer Backup API endpoint.
+     * 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.
@@ -117,6 +117,6 @@ export declare class BackupRawClient {
      *
      * @returns The parsed JSON response.
      */
-    private postJson;
+    private postNonRetryingMutationJson;
 }
 //# sourceMappingURL=raw.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/backup/raw.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AASzD,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAI3B,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;AAcD;;;;;;;;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;IAalC,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;OAUG;YACW,OAAO;IAsBrB;;;;;;;;;;OAUG;YACW,QAAQ;CAoBvB"}
+{"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"}