@backblaze-labs/b2-sdk 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +45 -1
- package/README.md +18 -5
- package/dist/_virtual/_b2-sdk-version-json.cjs +1 -1
- package/dist/_virtual/_b2-sdk-version-json.js +1 -1
- package/dist/auth/reauth-coalescer.cjs +65 -0
- package/dist/auth/reauth-coalescer.cjs.map +1 -0
- package/dist/auth/reauth-coalescer.d.cts +34 -0
- package/dist/auth/reauth-coalescer.d.cts.map +1 -0
- package/dist/auth/reauth-coalescer.d.ts +34 -0
- package/dist/auth/reauth-coalescer.d.ts.map +1 -0
- package/dist/auth/reauth-coalescer.js +65 -0
- package/dist/auth/reauth-coalescer.js.map +1 -0
- package/dist/backup/raw.cjs +37 -15
- package/dist/backup/raw.cjs.map +1 -1
- package/dist/backup/raw.d.cts +2 -2
- package/dist/backup/raw.d.cts.map +1 -1
- package/dist/backup/raw.d.ts +2 -2
- package/dist/backup/raw.d.ts.map +1 -1
- package/dist/backup/raw.js +37 -15
- package/dist/backup/raw.js.map +1 -1
- package/dist/bucket-validation.cjs +111 -0
- package/dist/bucket-validation.cjs.map +1 -0
- package/dist/bucket-validation.d.cts +27 -0
- package/dist/bucket-validation.d.cts.map +1 -0
- package/dist/bucket-validation.d.ts +27 -0
- package/dist/bucket-validation.d.ts.map +1 -0
- package/dist/bucket-validation.js +109 -0
- package/dist/bucket-validation.js.map +1 -0
- package/dist/bucket.cjs +123 -73
- package/dist/bucket.cjs.map +1 -1
- package/dist/bucket.d.cts +156 -61
- package/dist/bucket.d.cts.map +1 -1
- package/dist/bucket.d.ts +156 -61
- package/dist/bucket.d.ts.map +1 -1
- package/dist/bucket.js +123 -73
- package/dist/bucket.js.map +1 -1
- package/dist/client.cjs +29 -8
- package/dist/client.cjs.map +1 -1
- package/dist/client.d.cts +30 -9
- package/dist/client.d.cts.map +1 -1
- package/dist/client.d.ts +30 -9
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +29 -8
- package/dist/client.js.map +1 -1
- package/dist/download/single.cjs +38 -13
- package/dist/download/single.cjs.map +1 -1
- package/dist/download/single.d.cts +10 -4
- package/dist/download/single.d.cts.map +1 -1
- package/dist/download/single.d.ts +10 -4
- package/dist/download/single.d.ts.map +1 -1
- package/dist/download/single.js +38 -13
- package/dist/download/single.js.map +1 -1
- package/dist/errors/index.cjs +27 -4
- package/dist/errors/index.cjs.map +1 -1
- package/dist/errors/index.d.cts +15 -0
- package/dist/errors/index.d.cts.map +1 -1
- package/dist/errors/index.d.ts +15 -0
- package/dist/errors/index.d.ts.map +1 -1
- package/dist/errors/index.js +27 -5
- package/dist/errors/index.js.map +1 -1
- package/dist/http/non-idempotent-mutations.cjs +38 -0
- package/dist/http/non-idempotent-mutations.cjs.map +1 -0
- package/dist/http/non-idempotent-mutations.d.cts +25 -0
- package/dist/http/non-idempotent-mutations.d.cts.map +1 -0
- package/dist/http/non-idempotent-mutations.d.ts +25 -0
- package/dist/http/non-idempotent-mutations.d.ts.map +1 -0
- package/dist/http/non-idempotent-mutations.js +35 -0
- package/dist/http/non-idempotent-mutations.js.map +1 -0
- package/dist/http/transport.cjs +9 -8
- package/dist/http/transport.cjs.map +1 -1
- package/dist/http/transport.d.cts +5 -0
- package/dist/http/transport.d.cts.map +1 -1
- package/dist/http/transport.d.ts +5 -0
- package/dist/http/transport.d.ts.map +1 -1
- package/dist/http/transport.js +9 -8
- package/dist/http/transport.js.map +1 -1
- package/dist/http/user-agent.cjs +12 -1
- package/dist/http/user-agent.cjs.map +1 -1
- package/dist/http/user-agent.d.cts +8 -0
- package/dist/http/user-agent.d.cts.map +1 -1
- package/dist/http/user-agent.d.ts +8 -0
- package/dist/http/user-agent.d.ts.map +1 -1
- package/dist/http/user-agent.js +13 -3
- package/dist/http/user-agent.js.map +1 -1
- package/dist/index.cjs +25 -0
- package/dist/index.d.cts +10 -9
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.ts +10 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -6
- package/dist/notifications/index.cjs +3 -0
- package/dist/notifications/index.d.cts +2 -0
- package/dist/notifications/index.d.cts.map +1 -1
- package/dist/notifications/index.d.ts +2 -0
- package/dist/notifications/index.d.ts.map +1 -1
- package/dist/notifications/index.js +2 -1
- package/dist/object.cjs +12 -1
- package/dist/object.cjs.map +1 -1
- package/dist/object.d.cts +7 -1
- package/dist/object.d.cts.map +1 -1
- package/dist/object.d.ts +7 -1
- package/dist/object.d.ts.map +1 -1
- package/dist/object.js +12 -1
- package/dist/object.js.map +1 -1
- package/dist/partner/auth-core.cjs +4 -23
- package/dist/partner/auth-core.cjs.map +1 -1
- package/dist/partner/auth-core.d.cts +1 -1
- package/dist/partner/auth-core.d.cts.map +1 -1
- package/dist/partner/auth-core.d.ts +1 -1
- package/dist/partner/auth-core.d.ts.map +1 -1
- package/dist/partner/auth-core.js +5 -24
- package/dist/partner/auth-core.js.map +1 -1
- package/dist/partner/client.cjs +25 -10
- package/dist/partner/client.cjs.map +1 -1
- package/dist/partner/client.d.cts +32 -10
- package/dist/partner/client.d.cts.map +1 -1
- package/dist/partner/client.d.ts +32 -10
- package/dist/partner/client.d.ts.map +1 -1
- package/dist/partner/client.js +25 -10
- package/dist/partner/client.js.map +1 -1
- package/dist/partner/endpoint-url.cjs +1 -0
- package/dist/partner/endpoint-url.cjs.map +1 -1
- package/dist/partner/endpoint-url.d.cts +2 -0
- package/dist/partner/endpoint-url.d.cts.map +1 -1
- package/dist/partner/endpoint-url.d.ts +2 -0
- package/dist/partner/endpoint-url.d.ts.map +1 -1
- package/dist/partner/endpoint-url.js +1 -0
- package/dist/partner/endpoint-url.js.map +1 -1
- package/dist/partner/in-memory.cjs.map +1 -1
- package/dist/partner/in-memory.js.map +1 -1
- package/dist/partner/index.cjs +9 -0
- package/dist/partner/index.d.cts +11 -2
- package/dist/partner/index.d.cts.map +1 -1
- package/dist/partner/index.d.ts +11 -2
- package/dist/partner/index.d.ts.map +1 -1
- package/dist/partner/index.js +3 -1
- package/dist/partner/raw.cjs +52 -44
- package/dist/partner/raw.cjs.map +1 -1
- package/dist/partner/raw.d.cts +16 -19
- package/dist/partner/raw.d.cts.map +1 -1
- package/dist/partner/raw.d.ts +16 -19
- package/dist/partner/raw.d.ts.map +1 -1
- package/dist/partner/raw.js +52 -44
- package/dist/partner/raw.js.map +1 -1
- package/dist/partner/redaction.cjs +133 -108
- package/dist/partner/redaction.cjs.map +1 -1
- package/dist/partner/redaction.d.cts +47 -13
- package/dist/partner/redaction.d.cts.map +1 -1
- package/dist/partner/redaction.d.ts +47 -13
- package/dist/partner/redaction.d.ts.map +1 -1
- package/dist/partner/redaction.js +133 -109
- package/dist/partner/redaction.js.map +1 -1
- package/dist/raw/encoding.cjs +29 -10
- package/dist/raw/encoding.cjs.map +1 -1
- package/dist/raw/encoding.d.cts +3 -2
- package/dist/raw/encoding.d.cts.map +1 -1
- package/dist/raw/encoding.d.ts +3 -2
- package/dist/raw/encoding.d.ts.map +1 -1
- package/dist/raw/encoding.js +29 -10
- package/dist/raw/encoding.js.map +1 -1
- package/dist/raw/index.cjs +64 -39
- package/dist/raw/index.cjs.map +1 -1
- package/dist/raw/index.d.cts +21 -19
- package/dist/raw/index.d.cts.map +1 -1
- package/dist/raw/index.d.ts +21 -19
- package/dist/raw/index.d.ts.map +1 -1
- package/dist/raw/index.js +47 -40
- package/dist/raw/index.js.map +1 -1
- package/dist/raw/url.cjs.map +1 -1
- package/dist/raw/url.d.cts +3 -3
- package/dist/raw/url.d.ts +3 -3
- package/dist/raw/url.js.map +1 -1
- package/dist/simulator/index.cjs +456 -125
- package/dist/simulator/index.cjs.map +1 -1
- package/dist/simulator/index.d.cts +16 -1
- package/dist/simulator/index.d.cts.map +1 -1
- package/dist/simulator/index.d.ts +16 -1
- package/dist/simulator/index.d.ts.map +1 -1
- package/dist/simulator/index.js +449 -130
- package/dist/simulator/index.js.map +1 -1
- package/dist/simulator/partner-capabilities.cjs +77 -0
- package/dist/simulator/partner-capabilities.cjs.map +1 -0
- package/dist/simulator/partner-capabilities.d.cts +53 -0
- package/dist/simulator/partner-capabilities.d.cts.map +1 -0
- package/dist/simulator/partner-capabilities.d.ts +53 -0
- package/dist/simulator/partner-capabilities.d.ts.map +1 -0
- package/dist/simulator/partner-capabilities.js +73 -0
- package/dist/simulator/partner-capabilities.js.map +1 -0
- package/dist/simulator/partner.cjs +55 -61
- package/dist/simulator/partner.cjs.map +1 -1
- package/dist/simulator/partner.d.cts +5 -2
- package/dist/simulator/partner.d.cts.map +1 -1
- package/dist/simulator/partner.d.ts +5 -2
- package/dist/simulator/partner.d.ts.map +1 -1
- package/dist/simulator/partner.js +56 -61
- package/dist/simulator/partner.js.map +1 -1
- package/dist/simulator/validation.cjs +160 -30
- package/dist/simulator/validation.cjs.map +1 -1
- package/dist/simulator/validation.d.cts +28 -6
- package/dist/simulator/validation.d.cts.map +1 -1
- package/dist/simulator/validation.d.ts +28 -6
- package/dist/simulator/validation.d.ts.map +1 -1
- package/dist/simulator/validation.js +148 -31
- package/dist/simulator/validation.js.map +1 -1
- package/dist/streams/file-source.cjs +1 -1
- package/dist/streams/file-source.cjs.map +1 -1
- package/dist/streams/file-source.js +1 -1
- package/dist/streams/file-source.js.map +1 -1
- package/dist/streams/hash.cjs +246 -13
- package/dist/streams/hash.cjs.map +1 -1
- package/dist/streams/hash.d.cts +37 -12
- package/dist/streams/hash.d.cts.map +1 -1
- package/dist/streams/hash.d.ts +37 -12
- package/dist/streams/hash.d.ts.map +1 -1
- package/dist/streams/hash.js +246 -15
- package/dist/streams/hash.js.map +1 -1
- package/dist/streams/index.cjs +2 -0
- package/dist/streams/index.d.cts +1 -1
- package/dist/streams/index.d.cts.map +1 -1
- package/dist/streams/index.d.ts +1 -1
- package/dist/streams/index.d.ts.map +1 -1
- package/dist/streams/index.js +2 -2
- package/dist/streams/progress.cjs +63 -4
- package/dist/streams/progress.cjs.map +1 -1
- package/dist/streams/progress.d.cts +28 -2
- package/dist/streams/progress.d.cts.map +1 -1
- package/dist/streams/progress.d.ts +28 -2
- package/dist/streams/progress.d.ts.map +1 -1
- package/dist/streams/progress.js +63 -4
- package/dist/streams/progress.js.map +1 -1
- package/dist/sync/download-staging.cjs +147 -35
- package/dist/sync/download-staging.cjs.map +1 -1
- package/dist/sync/download-staging.d.cts +25 -2
- package/dist/sync/download-staging.d.cts.map +1 -1
- package/dist/sync/download-staging.d.ts +25 -2
- package/dist/sync/download-staging.d.ts.map +1 -1
- package/dist/sync/download-staging.js +146 -36
- package/dist/sync/download-staging.js.map +1 -1
- package/dist/sync/index.d.cts +1 -1
- package/dist/sync/index.d.cts.map +1 -1
- package/dist/sync/index.d.ts +1 -1
- package/dist/sync/index.d.ts.map +1 -1
- package/dist/sync/local-file-io.cjs +5 -1
- package/dist/sync/local-file-io.cjs.map +1 -1
- package/dist/sync/local-file-io.d.cts +2 -0
- package/dist/sync/local-file-io.d.cts.map +1 -1
- package/dist/sync/local-file-io.d.ts +2 -0
- package/dist/sync/local-file-io.d.ts.map +1 -1
- package/dist/sync/local-file-io.js +5 -1
- package/dist/sync/local-file-io.js.map +1 -1
- package/dist/sync/pairing.cjs +1 -0
- package/dist/sync/pairing.cjs.map +1 -1
- package/dist/sync/pairing.js +1 -0
- package/dist/sync/pairing.js.map +1 -1
- package/dist/sync/scanners/b2.cjs +2 -0
- package/dist/sync/scanners/b2.cjs.map +1 -1
- package/dist/sync/scanners/b2.d.cts.map +1 -1
- package/dist/sync/scanners/b2.d.ts.map +1 -1
- package/dist/sync/scanners/b2.js +2 -0
- package/dist/sync/scanners/b2.js.map +1 -1
- package/dist/sync/scanners/local.cjs +150 -33
- package/dist/sync/scanners/local.cjs.map +1 -1
- package/dist/sync/scanners/local.d.cts +6 -0
- package/dist/sync/scanners/local.d.cts.map +1 -1
- package/dist/sync/scanners/local.d.ts +6 -0
- package/dist/sync/scanners/local.d.ts.map +1 -1
- package/dist/sync/scanners/local.js +150 -33
- package/dist/sync/scanners/local.js.map +1 -1
- package/dist/sync/synchronizer.cjs +76 -29
- package/dist/sync/synchronizer.cjs.map +1 -1
- package/dist/sync/synchronizer.d.cts +1 -0
- package/dist/sync/synchronizer.d.cts.map +1 -1
- package/dist/sync/synchronizer.d.ts +1 -0
- package/dist/sync/synchronizer.d.ts.map +1 -1
- package/dist/sync/synchronizer.js +76 -29
- package/dist/sync/synchronizer.js.map +1 -1
- package/dist/sync/types.d.cts +19 -3
- package/dist/sync/types.d.cts.map +1 -1
- package/dist/sync/types.d.ts +19 -3
- package/dist/sync/types.d.ts.map +1 -1
- package/dist/types/backup.d.cts +6 -1
- package/dist/types/backup.d.cts.map +1 -1
- package/dist/types/backup.d.ts +6 -1
- package/dist/types/backup.d.ts.map +1 -1
- package/dist/types/bucket.cjs +81 -11
- package/dist/types/bucket.cjs.map +1 -1
- package/dist/types/bucket.d.cts +190 -39
- package/dist/types/bucket.d.cts.map +1 -1
- package/dist/types/bucket.d.ts +190 -39
- package/dist/types/bucket.d.ts.map +1 -1
- package/dist/types/bucket.js +67 -12
- package/dist/types/bucket.js.map +1 -1
- package/dist/types/download.cjs.map +1 -1
- package/dist/types/download.d.cts +3 -17
- package/dist/types/download.d.cts.map +1 -1
- package/dist/types/download.d.ts +3 -17
- package/dist/types/download.d.ts.map +1 -1
- package/dist/types/download.js.map +1 -1
- package/dist/types/encryption.cjs +18 -0
- package/dist/types/encryption.cjs.map +1 -1
- package/dist/types/encryption.d.cts +21 -11
- package/dist/types/encryption.d.cts.map +1 -1
- package/dist/types/encryption.d.ts +21 -11
- package/dist/types/encryption.d.ts.map +1 -1
- package/dist/types/encryption.js +18 -0
- package/dist/types/encryption.js.map +1 -1
- package/dist/types/file.cjs +3 -0
- package/dist/types/file.cjs.map +1 -1
- package/dist/types/file.d.cts +125 -16
- package/dist/types/file.d.cts.map +1 -1
- package/dist/types/file.d.ts +125 -16
- package/dist/types/file.d.ts.map +1 -1
- package/dist/types/file.js +3 -1
- package/dist/types/file.js.map +1 -1
- package/dist/types/index.d.cts +7 -7
- package/dist/types/index.d.cts.map +1 -1
- package/dist/types/index.d.ts +7 -7
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/key.d.cts +4 -3
- package/dist/types/key.d.cts.map +1 -1
- package/dist/types/key.d.ts +4 -3
- package/dist/types/key.d.ts.map +1 -1
- package/dist/types/notifications.cjs +30 -0
- package/dist/types/notifications.cjs.map +1 -1
- package/dist/types/notifications.d.cts +26 -1
- package/dist/types/notifications.d.cts.map +1 -1
- package/dist/types/notifications.d.ts +26 -1
- package/dist/types/notifications.d.ts.map +1 -1
- package/dist/types/notifications.js +29 -1
- package/dist/types/notifications.js.map +1 -1
- package/dist/types/partner.cjs.map +1 -1
- package/dist/types/partner.d.cts +28 -36
- package/dist/types/partner.d.cts.map +1 -1
- package/dist/types/partner.d.ts +28 -36
- package/dist/types/partner.d.ts.map +1 -1
- package/dist/types/partner.js.map +1 -1
- package/dist/types/upload.d.cts +4 -0
- package/dist/types/upload.d.cts.map +1 -1
- package/dist/types/upload.d.ts +4 -0
- package/dist/types/upload.d.ts.map +1 -1
- package/dist/upload/large.cjs +10 -7
- package/dist/upload/large.cjs.map +1 -1
- package/dist/upload/large.d.cts +15 -6
- package/dist/upload/large.d.cts.map +1 -1
- package/dist/upload/large.d.ts +15 -6
- package/dist/upload/large.d.ts.map +1 -1
- package/dist/upload/large.js +10 -7
- package/dist/upload/large.js.map +1 -1
- package/dist/upload/options.cjs.map +1 -1
- package/dist/upload/options.d.cts +12 -0
- package/dist/upload/options.d.cts.map +1 -1
- package/dist/upload/options.d.ts +12 -0
- package/dist/upload/options.d.ts.map +1 -1
- package/dist/upload/options.js.map +1 -1
- package/dist/upload/resume.cjs +4 -3
- package/dist/upload/resume.cjs.map +1 -1
- package/dist/upload/resume.d.cts +6 -4
- package/dist/upload/resume.d.cts.map +1 -1
- package/dist/upload/resume.d.ts +6 -4
- package/dist/upload/resume.d.ts.map +1 -1
- package/dist/upload/resume.js +4 -3
- package/dist/upload/resume.js.map +1 -1
- package/dist/upload/retry.cjs +17 -10
- package/dist/upload/retry.cjs.map +1 -1
- package/dist/upload/retry.d.cts.map +1 -1
- package/dist/upload/retry.d.ts.map +1 -1
- package/dist/upload/retry.js +17 -10
- package/dist/upload/retry.js.map +1 -1
- package/dist/upload/single.cjs +35 -31
- package/dist/upload/single.cjs.map +1 -1
- package/dist/upload/single.d.cts +6 -0
- package/dist/upload/single.d.cts.map +1 -1
- package/dist/upload/single.d.ts +6 -0
- package/dist/upload/single.d.ts.map +1 -1
- package/dist/upload/single.js +35 -31
- package/dist/upload/single.js.map +1 -1
- package/dist/upload/stream.cjs +12 -1
- package/dist/upload/stream.cjs.map +1 -1
- package/dist/upload/stream.d.cts +6 -0
- package/dist/upload/stream.d.cts.map +1 -1
- package/dist/upload/stream.d.ts +6 -0
- package/dist/upload/stream.d.ts.map +1 -1
- package/dist/upload/stream.js +12 -1
- package/dist/upload/stream.js.map +1 -1
- package/dist/version.cjs +56 -4
- package/dist/version.cjs.map +1 -1
- package/dist/version.d.cts +53 -4
- package/dist/version.d.cts.map +1 -1
- package/dist/version.d.ts +53 -4
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +52 -5
- package/dist/version.js.map +1 -1
- package/package.json +11 -4
package/dist/raw/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":[],"sources":["../../src/raw/index.ts"],"sourcesContent":["/**\n * Low-level 1:1 bindings for every B2 native API endpoint.\n *\n * Each method on {@link RawClient} maps directly to a single `b2_*` HTTP call\n * with fully typed request and response objects. No retry logic, no URL pooling,\n * no automatic reauthorization. Use this when you need precise control over\n * individual API calls; for most use cases prefer the high-level `B2Client`.\n *\n * @packageDocumentation\n */\n\nimport { assertSecureRealmUrl } from '../auth/realms.ts'\nimport { FinishLargeFileResponseBodyError, UploadResponseBodyError } from '../errors/index.ts'\nimport type { RetryOptions } from '../http/retry.ts'\nimport type { HttpTransport } from '../http/transport.ts'\nimport type {\n AllowedBucket,\n ApplicationKey,\n AuthorizeAccountResponse,\n BucketId,\n BucketInfo,\n CancelLargeFileRequest,\n CancelLargeFileResponse,\n CopyFileRequest,\n CopyPartRequest,\n CopyPartResponse,\n CreateBucketRequest,\n CreateKeyRequest,\n DeleteBucketRequest,\n DeleteFileVersionRequest,\n DeleteFileVersionResponse,\n DeleteKeyRequest,\n DownloadAuthorizationRequest,\n DownloadAuthorizationResponse,\n FileVersion,\n FinishLargeFileRequest,\n FullApplicationKey,\n GetBucketNotificationRulesRequest,\n GetBucketNotificationRulesResponse,\n GetFileInfoRequest,\n GetUploadPartUrlRequest,\n GetUploadPartUrlResponse,\n GetUploadUrlRequest,\n GetUploadUrlResponse,\n HideFileRequest,\n ListBucketsRequest,\n ListBucketsResponse,\n ListFileNamesRequest,\n ListFileNamesResponse,\n ListFileVersionsRequest,\n ListFileVersionsResponse,\n ListKeysRequest,\n ListKeysResponse,\n ListPartsRequest,\n ListPartsResponse,\n ListUnfinishedLargeFilesRequest,\n ListUnfinishedLargeFilesResponse,\n SetBucketNotificationRulesRequest,\n SetBucketNotificationRulesResponse,\n StartLargeFileRequest,\n StartLargeFileResponse,\n UpdateBucketRequest,\n UpdateFileLegalHoldRequest,\n UpdateFileLegalHoldResponse,\n UpdateFileRetentionRequest,\n UpdateFileRetentionResponse,\n} from '../types/index.ts'\nimport type { UploadFileHeaders, UploadPartHeaders, UploadPartResponse } from '../types/upload.ts'\nimport { normalizeFileVersionListSha1, normalizeFileVersionSha1 } from '../util/normalize.ts'\nimport { buildFileInfoHeaders, encodeFileName } from './encoding.ts'\nimport { type B2EndpointUrlOptions, b2Url } from './url.ts'\n\nconst B2_NATIVE_API_V3: B2EndpointUrlOptions = { prefix: 'b2api', version: 'v3' }\nconst B2_NATIVE_API_V4: B2EndpointUrlOptions = { prefix: 'b2api', version: 'v4' }\n\n/** Configuration for constructing a {@link RawClient}. */\nexport interface RawClientOptions {\n /** The HTTP transport used to send requests (e.g., FetchTransport or RetryTransport). */\n readonly transport: HttpTransport\n}\n\n/** Optional request controls for {@link RawClient.listFileNames}. */\nexport type ListFileNamesOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.listFileVersions}. */\nexport type ListFileVersionsOptions = RawRequestOptions\n\n/** Optional controls for raw JSON API requests. */\nexport interface RawRequestOptions {\n /** Abort signal for cancelling the request. */\n readonly signal?: AbortSignal\n /** Per-request retry override. */\n readonly retry?: Partial<RetryOptions>\n}\n\n/**\n * @deprecated Use {@link RawRequestOptions}.\n */\nexport type JsonPostOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.finishLargeFile}. */\nexport type FinishLargeFileOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.copyPart}. */\nexport type CopyPartOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.startLargeFile}. */\nexport type StartLargeFileOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.uploadFile}. */\nexport type UploadFileOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.uploadPart}. */\nexport type UploadPartOptions = RawRequestOptions\n\nfunction normalizeRawRequestOptions(\n optionsOrSignal?: RawRequestOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n): RawRequestOptions | undefined {\n if (optionsOrSignal === undefined) {\n return retry === undefined ? undefined : { retry }\n }\n if (isAbortSignal(optionsOrSignal)) {\n return {\n signal: optionsOrSignal,\n ...(retry !== undefined ? { retry } : {}),\n }\n }\n return retry === undefined ? optionsOrSignal : { ...optionsOrSignal, retry }\n}\n\nfunction isAbortSignal(value: unknown): value is AbortSignal {\n // Back-compat only: legacy upload-URL overloads accepted an AbortSignal as\n // the fourth positional argument. Prefer the RawRequestOptions bag.\n return (\n typeof value === 'object' &&\n value !== null &&\n 'aborted' in value &&\n typeof (value as AbortSignal).addEventListener === 'function'\n )\n}\n\nfunction assertCustomUploadTimestamp(value: unknown): asserts value is number {\n if (value === undefined) return\n if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0) return\n throw new TypeError('customUploadTimestamp must be a non-negative safe integer')\n}\n\nfunction assertRawCustomUploadTimestamp(\n value: unknown,\n): asserts value is string | null | undefined {\n if (value === undefined || value === null) return\n if (typeof value === 'string' && /^\\d+$/.test(value)) {\n const timestamp = Number(value)\n if (Number.isSafeInteger(timestamp)) return\n }\n throw new TypeError('customUploadTimestamp must be a non-negative safe integer string or null')\n}\n\nfunction normalizeCreateKeyRequest(request: CreateKeyRequest): CreateKeyRequest {\n const { bucketId, ...withoutDeprecatedBucketId } = request\n if (bucketId !== undefined && withoutDeprecatedBucketId.bucketIds !== undefined) {\n throw new TypeError('createKey accepts either bucketIds or deprecated bucketId, not both')\n }\n if (bucketId === undefined) {\n return withoutDeprecatedBucketId\n }\n return { ...withoutDeprecatedBucketId, bucketIds: [bucketId] }\n}\n\nfunction singleBucketId(bucketIds: readonly BucketId[] | null): BucketId | null {\n return bucketIds?.length === 1 ? (bucketIds[0] ?? null) : null\n}\n\nfunction normalizeKeyResponse<T extends { readonly bucketIds: readonly BucketId[] | null }>(\n key: T,\n): T & { readonly bucketId: BucketId | null } {\n return { ...key, bucketId: singleBucketId(key.bucketIds) }\n}\n\ntype NormalizedAllowedInfo = AuthorizeAccountResponse['apiInfo']['storageApi']['allowed']\ntype NormalizedStorageApiInfo = AuthorizeAccountResponse['apiInfo']['storageApi']\n\ninterface WireAllowedInfo {\n readonly capabilities?: NormalizedAllowedInfo['capabilities']\n readonly buckets?: readonly AllowedBucket[] | null\n readonly bucketId?: BucketId | null\n readonly bucketName?: string | null\n readonly namePrefix?: string | null\n}\n\ntype WireStorageApiInfo = Omit<\n NormalizedStorageApiInfo,\n 'allowed' | 'bucketId' | 'bucketName' | 'infoType' | 'namePrefix'\n> & {\n readonly allowed?: WireAllowedInfo\n readonly capabilities?: NormalizedAllowedInfo['capabilities']\n readonly bucketId?: BucketId | null\n readonly bucketName?: string | null\n readonly infoType?: 'storageApi'\n readonly namePrefix?: string | null\n}\n\ntype WireAuthorizeAccountResponse = Omit<AuthorizeAccountResponse, 'apiInfo'> & {\n readonly apiInfo: Omit<AuthorizeAccountResponse['apiInfo'], 'storageApi'> & {\n readonly storageApi: WireStorageApiInfo\n }\n}\n\nfunction normalizeAllowedBuckets(storageApi: WireStorageApiInfo): readonly AllowedBucket[] | null {\n const allowed = storageApi.allowed\n if (allowed?.buckets !== undefined) {\n return allowed.buckets === null ? null : allowed.buckets.map((bucket) => ({ ...bucket }))\n }\n const bucketId = allowed?.bucketId ?? storageApi.bucketId ?? null\n if (bucketId === null) return null\n return [{ id: bucketId, name: allowed?.bucketName ?? storageApi.bucketName ?? null }]\n}\n\nfunction normalizeAuthorizeAccountResponse(\n response: WireAuthorizeAccountResponse,\n): AuthorizeAccountResponse {\n const storageApi = response.apiInfo.storageApi\n const allowed = storageApi.allowed\n const buckets = normalizeAllowedBuckets(storageApi)\n const singleBucket = buckets?.length === 1 ? buckets[0] : undefined\n const bucketId = singleBucket?.id ?? null\n const bucketName = singleBucket?.name ?? null\n const namePrefix = allowed?.namePrefix ?? storageApi.namePrefix ?? null\n const capabilities = allowed?.capabilities ?? storageApi.capabilities ?? []\n const { allowed: _wireAllowed, capabilities: _legacyCapabilities, ...storageApiBase } = storageApi\n\n return {\n ...response,\n apiInfo: {\n ...response.apiInfo,\n storageApi: {\n ...storageApiBase,\n bucketId,\n bucketName,\n downloadUrl: storageApi.downloadUrl,\n infoType: 'storageApi',\n namePrefix,\n allowed: {\n ...(allowed ?? {}),\n capabilities,\n buckets,\n bucketId,\n bucketName,\n namePrefix,\n },\n },\n },\n }\n}\n\nfunction uploadResponseBodyError(\n err: unknown,\n signal: AbortSignal | undefined,\n): UploadResponseBodyError {\n if (signal?.aborted === true) {\n throw signal.reason ?? new DOMException('Aborted', 'AbortError')\n }\n const message = err instanceof Error ? err.message : 'Upload response body could not be read'\n return new UploadResponseBodyError(message, { cause: err })\n}\n\n/**\n * Low-level client providing 1:1 bindings to all B2 native API endpoints.\n *\n * Each method maps directly to a single B2 API call. Most methods accept\n * `(apiUrl, authToken, request)` and return the JSON response. Upload and\n * download methods accept endpoint-specific parameters instead.\n */\nexport class RawClient {\n /** @internal */\n private readonly transport: HttpTransport\n\n /**\n * Creates a new RawClient with the given transport.\n * @param options - The constructor configuration.\n */\n constructor(options: RawClientOptions) {\n this.transport = options.transport\n }\n\n // --- Auth ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-authorize-account | b2_authorize_account}.\n * @param applicationKeyId - The application key ID for authentication.\n * @param applicationKey - The application key secret.\n * @param realmUrl - The B2 realm URL to authenticate against.\n *\n * @returns The authorization response with API URLs and credentials.\n */\n async authorizeAccount(\n applicationKeyId: string,\n applicationKey: string,\n realmUrl = 'https://api.backblazeb2.com',\n ): Promise<AuthorizeAccountResponse> {\n assertSecureRealmUrl(realmUrl)\n const response = await this.transport.send({\n url: b2Url(realmUrl, { ...B2_NATIVE_API_V4, endpoint: 'b2_authorize_account' }),\n method: 'GET',\n headers: {\n Authorization: `Basic ${btoa(`${applicationKeyId}:${applicationKey}`)}`,\n },\n })\n return normalizeAuthorizeAccountResponse(await response.json<WireAuthorizeAccountResponse>())\n }\n\n // --- Buckets ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-create-bucket | b2_create_bucket}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The created bucket metadata.\n */\n async createBucket(\n apiUrl: string,\n authToken: string,\n request: CreateBucketRequest,\n ): Promise<BucketInfo> {\n return this.postJson<BucketInfo>(apiUrl, authToken, 'b2_create_bucket', request)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-delete-bucket | b2_delete_bucket}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The deleted bucket metadata.\n */\n async deleteBucket(\n apiUrl: string,\n authToken: string,\n request: DeleteBucketRequest,\n ): Promise<BucketInfo> {\n return this.postJson<BucketInfo>(apiUrl, authToken, 'b2_delete_bucket', request)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-buckets | b2_list_buckets}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The list of matching buckets.\n */\n async listBuckets(\n apiUrl: string,\n authToken: string,\n request: ListBucketsRequest,\n ): Promise<ListBucketsResponse> {\n return this.postJson<ListBucketsResponse>(apiUrl, authToken, 'b2_list_buckets', request)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-update-bucket | b2_update_bucket}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated bucket metadata.\n */\n async updateBucket(\n apiUrl: string,\n authToken: string,\n request: UpdateBucketRequest,\n ): Promise<BucketInfo> {\n return this.postJson<BucketInfo>(apiUrl, authToken, 'b2_update_bucket', request)\n }\n\n // --- Files ---\n\n /**\n * Calls `b2_get_upload_url` with legacy positional request controls.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param signal - Optional abort signal for cancellation.\n * @param retry - Optional per-request retry override.\n *\n * @returns The upload URL and authorization token.\n *\n * @deprecated Use the options-bag overload: `getUploadUrl(apiUrl, authToken, request, { signal, retry })`.\n */\n async getUploadUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadUrlRequest,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadUrlResponse>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-upload-url | b2_get_upload_url}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The upload URL and authorization token.\n */\n async getUploadUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadUrlRequest,\n options?: RawRequestOptions,\n ): Promise<GetUploadUrlResponse>\n /**\n * Implementation for both upload URL request-control signatures.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The upload URL and authorization token.\n */\n async getUploadUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadUrlRequest,\n optionsOrSignal?: RawRequestOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadUrlResponse> {\n return this.postJson<GetUploadUrlResponse>(\n apiUrl,\n authToken,\n 'b2_get_upload_url',\n request,\n normalizeRawRequestOptions(optionsOrSignal, retry),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-file | b2_upload_file}.\n *\n * Unlike most methods, this posts directly to the `uploadUrl` obtained\n * from {@link getUploadUrl} rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param signal - Optional legacy abort signal for cancellation.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded file version metadata.\n *\n * @deprecated Use the options-bag overload: `uploadFile(uploadUrl, headers, body, { signal, retry })`.\n */\n async uploadFile(\n uploadUrl: string,\n headers: UploadFileHeaders,\n body: BodyInit,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<FileVersion>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-file | b2_upload_file}.\n *\n * Unlike most methods, this posts directly to the `uploadUrl` obtained\n * from {@link getUploadUrl} rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The uploaded file version metadata.\n */\n async uploadFile(\n uploadUrl: string,\n headers: UploadFileHeaders,\n body: BodyInit,\n options?: UploadFileOptions,\n ): Promise<FileVersion>\n /**\n * Implementation for both upload-file request-control signatures.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded file version metadata.\n */\n async uploadFile(\n uploadUrl: string,\n headers: UploadFileHeaders,\n body: BodyInit,\n optionsOrSignal?: UploadFileOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<FileVersion> {\n const options = normalizeRawRequestOptions(optionsOrSignal, retry)\n const reqHeaders: Record<string, string> = {\n Authorization: headers.authorization,\n 'X-Bz-File-Name': encodeFileName(headers.fileName),\n 'Content-Type': headers.contentType,\n 'Content-Length': String(headers.contentLength),\n 'X-Bz-Content-Sha1': headers.contentSha1,\n ...buildFileInfoHeaders(headers.fileInfo),\n }\n\n if (headers.lastModifiedMillis !== undefined) {\n reqHeaders['X-Bz-Info-src_last_modified_millis'] = String(headers.lastModifiedMillis)\n }\n if (headers.customUploadTimestamp !== undefined) {\n assertCustomUploadTimestamp(headers.customUploadTimestamp)\n reqHeaders['X-Bz-Custom-Upload-Timestamp'] = String(headers.customUploadTimestamp)\n }\n if (headers.contentDisposition) {\n reqHeaders['X-Bz-Info-b2-content-disposition'] = headers.contentDisposition\n }\n if (headers.contentLanguage) {\n reqHeaders['X-Bz-Info-b2-content-language'] = headers.contentLanguage\n }\n if (headers.expires) {\n reqHeaders['X-Bz-Info-b2-expires'] = headers.expires\n }\n if (headers.cacheControl) {\n reqHeaders['X-Bz-Info-b2-cache-control'] = headers.cacheControl\n }\n if (headers.contentEncoding) {\n reqHeaders['X-Bz-Info-b2-content-encoding'] = headers.contentEncoding\n }\n\n applyEncryptionHeaders(reqHeaders, headers.serverSideEncryption)\n applyRetentionHeaders(reqHeaders, headers.fileRetention)\n applyLegalHoldHeader(reqHeaders, headers.legalHold)\n\n const response = await this.transport.send({\n url: uploadUrl,\n method: 'POST',\n headers: reqHeaders,\n body,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n try {\n return normalizeFileVersionSha1(await response.json<FileVersion>())\n } catch (err) {\n throw uploadResponseBodyError(err, options?.signal)\n }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-file-names | b2_list_file_names}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The list of file names and optional continuation token.\n */\n async listFileNames(\n apiUrl: string,\n authToken: string,\n request: ListFileNamesRequest,\n options?: ListFileNamesOptions,\n ): Promise<ListFileNamesResponse> {\n return normalizeFileVersionListSha1(\n await this.postJson<ListFileNamesResponse>(\n apiUrl,\n authToken,\n 'b2_list_file_names',\n request,\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-file-versions | b2_list_file_versions}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The list of file versions and optional continuation token.\n */\n async listFileVersions(\n apiUrl: string,\n authToken: string,\n request: ListFileVersionsRequest,\n options?: ListFileVersionsOptions,\n ): Promise<ListFileVersionsResponse> {\n return normalizeFileVersionListSha1(\n await this.postJson<ListFileVersionsResponse>(\n apiUrl,\n authToken,\n 'b2_list_file_versions',\n request,\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-file-info | b2_get_file_info}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The file version metadata.\n */\n async getFileInfo(\n apiUrl: string,\n authToken: string,\n request: GetFileInfoRequest,\n ): Promise<FileVersion> {\n return normalizeFileVersionSha1(\n await this.postJson<FileVersion>(apiUrl, authToken, 'b2_get_file_info', request),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-hide-file | b2_hide_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The hidden file version metadata.\n */\n async hideFile(\n apiUrl: string,\n authToken: string,\n request: HideFileRequest,\n options?: { readonly signal?: AbortSignal },\n ): Promise<FileVersion> {\n return normalizeFileVersionSha1(\n await this.postJson<FileVersion>(apiUrl, authToken, 'b2_hide_file', request, options),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-delete-file-version | b2_delete_file_version}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The deleted file version identifier.\n */\n async deleteFileVersion(\n apiUrl: string,\n authToken: string,\n request: DeleteFileVersionRequest,\n options?: { readonly signal?: AbortSignal },\n ): Promise<DeleteFileVersionResponse> {\n return this.postJson<DeleteFileVersionResponse>(\n apiUrl,\n authToken,\n 'b2_delete_file_version',\n request,\n options,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-copy-file | b2_copy_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The copied file version metadata.\n */\n async copyFile(\n apiUrl: string,\n authToken: string,\n request: CopyFileRequest,\n options?: RawRequestOptions,\n ): Promise<FileVersion> {\n return normalizeFileVersionSha1(\n await this.postJson<FileVersion>(\n apiUrl,\n authToken,\n 'b2_copy_file',\n withJsonBodyWireSseC(request),\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-copy-part | b2_copy_part}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional abort and retry controls.\n *\n * @returns The copied part metadata.\n */\n async copyPart(\n apiUrl: string,\n authToken: string,\n request: CopyPartRequest,\n options?: CopyPartOptions,\n ): Promise<CopyPartResponse> {\n return this.postJson<CopyPartResponse>(\n apiUrl,\n authToken,\n 'b2_copy_part',\n withJsonBodyWireSseC(request),\n options,\n )\n }\n\n // --- Large Files ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-start-large-file | b2_start_large_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional abort and retry controls.\n *\n * @returns The started large file metadata with file ID.\n */\n async startLargeFile(\n apiUrl: string,\n authToken: string,\n request: StartLargeFileRequest,\n options?: StartLargeFileOptions,\n ): Promise<StartLargeFileResponse> {\n assertRawCustomUploadTimestamp(request.customUploadTimestamp)\n return normalizeFileVersionSha1(\n await this.postJson<StartLargeFileResponse>(\n apiUrl,\n authToken,\n 'b2_start_large_file',\n withJsonBodyWireSseC(request),\n options,\n ),\n )\n }\n\n /**\n * Calls `b2_get_upload_part_url` with legacy positional request controls.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param signal - Optional abort signal for cancellation.\n * @param retry - Optional per-request retry override.\n *\n * @returns The upload part URL and authorization token.\n *\n * @deprecated Use the options-bag overload: `getUploadPartUrl(apiUrl, authToken, request, { signal, retry })`.\n */\n async getUploadPartUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadPartUrlRequest,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadPartUrlResponse>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-upload-part-url | b2_get_upload_part_url}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The upload part URL and authorization token.\n */\n async getUploadPartUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadPartUrlRequest,\n options?: RawRequestOptions,\n ): Promise<GetUploadPartUrlResponse>\n /**\n * Implementation for both upload part URL request-control signatures.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The upload part URL and authorization token.\n */\n async getUploadPartUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadPartUrlRequest,\n optionsOrSignal?: RawRequestOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadPartUrlResponse> {\n return this.postJson<GetUploadPartUrlResponse>(\n apiUrl,\n authToken,\n 'b2_get_upload_part_url',\n request,\n normalizeRawRequestOptions(optionsOrSignal, retry),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-part | b2_upload_part}.\n *\n * Posts directly to the `uploadUrl` obtained from {@link getUploadPartUrl}\n * rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param signal - Optional legacy abort signal for cancellation.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded part metadata.\n *\n * @deprecated Use the options-bag overload: `uploadPart(uploadUrl, headers, body, { signal, retry })`.\n */\n async uploadPart(\n uploadUrl: string,\n headers: UploadPartHeaders,\n body: BodyInit,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<UploadPartResponse>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-part | b2_upload_part}.\n *\n * Posts directly to the `uploadUrl` obtained from {@link getUploadPartUrl}\n * rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The uploaded part metadata.\n */\n async uploadPart(\n uploadUrl: string,\n headers: UploadPartHeaders,\n body: BodyInit,\n options?: UploadPartOptions,\n ): Promise<UploadPartResponse>\n /**\n * Implementation for both upload-part request-control signatures.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded part metadata.\n */\n async uploadPart(\n uploadUrl: string,\n headers: UploadPartHeaders,\n body: BodyInit,\n optionsOrSignal?: UploadPartOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<UploadPartResponse> {\n const options = normalizeRawRequestOptions(optionsOrSignal, retry)\n const reqHeaders: Record<string, string> = {\n Authorization: headers.authorization,\n 'X-Bz-Part-Number': String(headers.partNumber),\n 'Content-Length': String(headers.contentLength),\n 'X-Bz-Content-Sha1': headers.contentSha1,\n }\n\n applyEncryptionHeaders(reqHeaders, headers.serverSideEncryption)\n\n const response = await this.transport.send({\n url: uploadUrl,\n method: 'POST',\n headers: reqHeaders,\n body,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n try {\n return await response.json<UploadPartResponse>()\n } catch (err) {\n throw uploadResponseBodyError(err, options?.signal)\n }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-finish-large-file | b2_finish_large_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional abort and retry controls.\n *\n * @returns The completed file version metadata.\n */\n async finishLargeFile(\n apiUrl: string,\n authToken: string,\n request: FinishLargeFileRequest,\n options?: FinishLargeFileOptions,\n ): Promise<FileVersion> {\n const response = await this.transport.send({\n url: b2Url(apiUrl, { ...B2_NATIVE_API_V3, endpoint: 'b2_finish_large_file' }),\n method: 'POST',\n headers: {\n Authorization: authToken,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(request),\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n\n let fileVersion: FileVersion\n try {\n fileVersion = await response.json<FileVersion>()\n } catch (err) {\n throw new FinishLargeFileResponseBodyError(\n err instanceof Error ? err.message : 'Finish large file response body could not be read',\n { cause: err, fileId: request.fileId },\n )\n }\n return normalizeFileVersionSha1(fileVersion)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-cancel-large-file | b2_cancel_large_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The cancelled large file metadata.\n */\n async cancelLargeFile(\n apiUrl: string,\n authToken: string,\n request: CancelLargeFileRequest,\n options?: RawRequestOptions,\n ): Promise<CancelLargeFileResponse> {\n return this.postJson<CancelLargeFileResponse>(\n apiUrl,\n authToken,\n 'b2_cancel_large_file',\n request,\n options,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-unfinished-large-files | b2_list_unfinished_large_files}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry.\n *\n * @returns The list of unfinished large files and optional continuation token.\n */\n async listUnfinishedLargeFiles(\n apiUrl: string,\n authToken: string,\n request: ListUnfinishedLargeFilesRequest,\n options?: RawRequestOptions,\n ): Promise<ListUnfinishedLargeFilesResponse> {\n return normalizeFileVersionListSha1(\n await this.postJson<ListUnfinishedLargeFilesResponse>(\n apiUrl,\n authToken,\n 'b2_list_unfinished_large_files',\n request,\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-parts | b2_list_parts}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry.\n *\n * @returns The list of uploaded parts and optional continuation token.\n */\n async listParts(\n apiUrl: string,\n authToken: string,\n request: ListPartsRequest,\n options?: RawRequestOptions,\n ): Promise<ListPartsResponse> {\n return this.postJson<ListPartsResponse>(apiUrl, authToken, 'b2_list_parts', request, options)\n }\n\n // --- Downloads ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-download-file-by-id | b2_download_file_by_id}.\n * @param downloadUrl - The B2 download base URL.\n * @param authToken - The authorization token.\n * @param fileId - The unique identifier of the file to download.\n * @param options - Optional download parameters for range requests and cancellation.\n *\n * @returns The response headers, streaming body, and HTTP status code.\n */\n async downloadFileById(\n downloadUrl: string,\n authToken: string,\n fileId: string,\n options?: DownloadFileOptions,\n ): Promise<{\n /** Response headers containing file metadata and B2 info headers. */\n headers: Headers\n /** Streaming response body, or `null` for HEAD-like responses. */\n body: ReadableStream<Uint8Array> | null\n /** HTTP status code (200 for full content, 206 for partial content). */\n status: number\n }> {\n const headers = buildDownloadRequestHeaders(authToken, options)\n const url = appendDownloadOverrides(\n `${b2Url(downloadUrl, {\n ...B2_NATIVE_API_V3,\n endpoint: 'b2_download_file_by_id',\n })}?fileId=${encodeURIComponent(fileId)}`,\n options,\n )\n\n const response = await this.transport.send({\n url,\n method: options?.method ?? 'GET',\n headers,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n })\n\n return { headers: response.headers, body: response.body, status: response.status }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-download-file-by-name | b2_download_file_by_name}.\n * @param downloadUrl - The B2 download base URL.\n * @param authToken - The authorization token.\n * @param bucketName - The name of the bucket containing the file.\n * @param fileName - The name of the file to download.\n * @param options - Optional download parameters for range requests and cancellation.\n *\n * @returns The response headers, streaming body, and HTTP status code.\n */\n async downloadFileByName(\n downloadUrl: string,\n authToken: string,\n bucketName: string,\n fileName: string,\n options?: DownloadFileOptions,\n ): Promise<{\n /** Response headers containing file metadata and B2 info headers. */\n headers: Headers\n /** Streaming response body, or `null` for HEAD-like responses. */\n body: ReadableStream<Uint8Array> | null\n /** HTTP status code (200 for full content, 206 for partial content). */\n status: number\n }> {\n const headers = buildDownloadRequestHeaders(authToken, options)\n const url = appendDownloadOverrides(\n `${downloadUrl}/file/${encodeURIComponent(bucketName)}/${encodeFileName(fileName)}`,\n options,\n )\n\n const response = await this.transport.send({\n url,\n method: options?.method ?? 'GET',\n headers,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n })\n\n return { headers: response.headers, body: response.body, status: response.status }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-download-authorization | b2_get_download_authorization}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The current session authorization token.\n * @param request - The API request parameters.\n *\n * @returns The download authorization token for the specified file prefix.\n */\n async getDownloadAuthorization(\n apiUrl: string,\n authToken: string,\n request: DownloadAuthorizationRequest,\n ): Promise<DownloadAuthorizationResponse> {\n return this.postJson<DownloadAuthorizationResponse>(\n apiUrl,\n authToken,\n 'b2_get_download_authorization',\n request,\n )\n }\n\n // --- Keys ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-create-key | b2_create_key}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The newly created application key with secret.\n */\n async createKey(\n apiUrl: string,\n authToken: string,\n request: CreateKeyRequest,\n ): Promise<FullApplicationKey> {\n const key = await this.postJson<FullApplicationKey>(\n apiUrl,\n authToken,\n 'b2_create_key',\n normalizeCreateKeyRequest(request),\n undefined,\n B2_NATIVE_API_V4,\n )\n return normalizeKeyResponse(key)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-keys | b2_list_keys}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The list of application keys and optional continuation token.\n */\n async listKeys(\n apiUrl: string,\n authToken: string,\n request: ListKeysRequest,\n ): Promise<ListKeysResponse> {\n const response = await this.postJson<ListKeysResponse>(\n apiUrl,\n authToken,\n 'b2_list_keys',\n request,\n undefined,\n B2_NATIVE_API_V4,\n )\n return { ...response, keys: response.keys.map((key) => normalizeKeyResponse(key)) }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-delete-key | b2_delete_key}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The deleted application key metadata.\n */\n async deleteKey(\n apiUrl: string,\n authToken: string,\n request: DeleteKeyRequest,\n ): Promise<ApplicationKey> {\n const key = await this.postJson<ApplicationKey>(\n apiUrl,\n authToken,\n 'b2_delete_key',\n request,\n undefined,\n B2_NATIVE_API_V4,\n )\n return normalizeKeyResponse(key)\n }\n\n // --- Retention / Legal Hold ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-update-file-retention | b2_update_file_retention}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated file retention settings.\n */\n async updateFileRetention(\n apiUrl: string,\n authToken: string,\n request: UpdateFileRetentionRequest,\n ): Promise<UpdateFileRetentionResponse> {\n return this.postJson<UpdateFileRetentionResponse>(\n apiUrl,\n authToken,\n 'b2_update_file_retention',\n request,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-update-file-legal-hold | b2_update_file_legal_hold}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated file legal hold status.\n */\n async updateFileLegalHold(\n apiUrl: string,\n authToken: string,\n request: UpdateFileLegalHoldRequest,\n ): Promise<UpdateFileLegalHoldResponse> {\n return this.postJson<UpdateFileLegalHoldResponse>(\n apiUrl,\n authToken,\n 'b2_update_file_legal_hold',\n request,\n )\n }\n\n // --- Notifications ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-bucket-notification-rules | b2_get_bucket_notification_rules}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The configured event notification rules for the specified bucket.\n */\n async getBucketNotificationRules(\n apiUrl: string,\n authToken: string,\n request: GetBucketNotificationRulesRequest,\n ): Promise<GetBucketNotificationRulesResponse> {\n return this.postJson<GetBucketNotificationRulesResponse>(\n apiUrl,\n authToken,\n 'b2_get_bucket_notification_rules',\n request,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-set-bucket-notification-rules | b2_set_bucket_notification_rules}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated bucket notification rules.\n */\n async setBucketNotificationRules(\n apiUrl: string,\n authToken: string,\n request: SetBucketNotificationRulesRequest,\n ): Promise<SetBucketNotificationRulesResponse> {\n return this.postJson<SetBucketNotificationRulesResponse>(\n apiUrl,\n authToken,\n 'b2_set_bucket_notification_rules',\n request,\n )\n }\n\n // --- Internal ---\n\n /**\n * Sends a JSON POST request to the specified B2 API endpoint.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param endpoint - The B2 API endpoint name.\n * @param body - The JSON request body.\n * @param options - Optional abort and per-request retry settings.\n * @param urlOptions - B2 endpoint path prefix and version settings.\n *\n * @returns The parsed JSON response.\n */\n private async postJson<T>(\n apiUrl: string,\n authToken: string,\n endpoint: string,\n body: unknown,\n options?: RawRequestOptions,\n urlOptions: B2EndpointUrlOptions = B2_NATIVE_API_V3,\n ): Promise<T> {\n const response = await this.transport.send({\n url: b2Url(apiUrl, { ...urlOptions, 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\n// --- Header helpers ---\n\nimport { EncryptionAlgorithm, EncryptionMode, type EncryptionSetting } from '../types/encryption.ts'\nimport type { FileRetentionValue, LegalHoldValue } from '../types/lock.ts'\n\ninterface JsonBodySseCRequest {\n readonly serverSideEncryption?: EncryptionSetting\n readonly sourceServerSideEncryption?: EncryptionSetting\n readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\nfunction withJsonBodyWireSseC<T extends JsonBodySseCRequest>(request: T): T {\n return {\n ...request,\n ...(request.serverSideEncryption !== undefined\n ? { serverSideEncryption: toWireSseC(request.serverSideEncryption) }\n : {}),\n ...(request.sourceServerSideEncryption !== undefined\n ? { sourceServerSideEncryption: toWireSseC(request.sourceServerSideEncryption) }\n : {}),\n ...(request.destinationServerSideEncryption !== undefined\n ? { destinationServerSideEncryption: toWireSseC(request.destinationServerSideEncryption) }\n : {}),\n }\n}\n\nfunction toWireSseC(setting: EncryptionSetting): EncryptionSetting {\n if (setting.mode !== EncryptionMode.SseC) return setting\n // SSE-C settings may be redacted wrappers with non-enumerable key fields.\n // Passing the wrapper through would let toJSON() emit the redaction placeholder;\n // spreading it would drop the key fields. Read directly into a plain wire\n // literal for the B2 JSON body only, and never pass that cleartext literal to\n // diagnostics or logging sinks.\n return {\n mode: EncryptionMode.SseC,\n algorithm: setting.algorithm,\n customerKey: setting.customerKey,\n customerKeyMd5: setting.customerKeyMd5,\n }\n}\n\n/**\n * Applies server-side encryption headers to the request.\n * @param headers - The mutable headers object to populate.\n * @param encryption - The encryption settings, or undefined to skip.\n */\nfunction applyEncryptionHeaders(\n headers: Record<string, string>,\n encryption: EncryptionSetting | undefined,\n): void {\n if (!encryption || encryption.mode === EncryptionMode.None) return\n if (encryption.mode === EncryptionMode.SseB2) {\n headers['X-Bz-Server-Side-Encryption'] = EncryptionAlgorithm.Aes256\n } else if (encryption.mode === EncryptionMode.SseC) {\n headers['X-Bz-Server-Side-Encryption-Customer-Algorithm'] = EncryptionAlgorithm.Aes256\n headers['X-Bz-Server-Side-Encryption-Customer-Key'] = encryption.customerKey\n headers['X-Bz-Server-Side-Encryption-Customer-Key-Md5'] = encryption.customerKeyMd5\n }\n}\n\n/**\n * SSE-C decryption parameters supplied to downloads of files that were\n * uploaded with customer-managed keys.\n */\nexport interface SseCDownloadKey {\n /** Encryption algorithm. Always `EncryptionAlgorithm.Aes256` (`'AES256'`). */\n readonly algorithm: EncryptionAlgorithm\n /**\n * Base64-encoded customer-provided decryption key. This value must be sent as\n * an HTTP request header for SSE-C downloads, so custom transports should not\n * log request headers without redacting them first.\n */\n readonly customerKey: string\n /** Base64-encoded MD5 digest of the decryption key. */\n readonly customerKeyMd5: string\n}\n\n/**\n * Options accepted by {@link RawClient.downloadFileById} and\n * {@link RawClient.downloadFileByName}. Mirrors the B2 native API: range +\n * SSE-C decryption headers + the documented `b2Content*` response-header\n * overrides (query-string parameters on the request URL).\n */\nexport interface DownloadFileOptions {\n /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch headers without the body. */\n readonly method?: 'GET' | 'HEAD'\n /** HTTP Range header value for partial content requests. */\n readonly range?: string\n /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n readonly serverSideEncryption?: SseCDownloadKey\n /** Override the `Content-Disposition` header in the download response. */\n readonly b2ContentDisposition?: string\n /** Override the `Content-Language` header in the download response. */\n readonly b2ContentLanguage?: string\n /** Override the `Content-Encoding` header in the download response. */\n readonly b2ContentEncoding?: string\n /** Override the `Content-Type` header in the download response. */\n readonly b2ContentType?: string\n /** Override the `Cache-Control` header in the download response. */\n readonly b2CacheControl?: string\n /** Override the `Expires` header in the download response. */\n readonly b2Expires?: string\n /** Signal to abort the download. */\n readonly signal?: AbortSignal\n}\n\nconst DOWNLOAD_OVERRIDE_PARAMS = [\n 'b2ContentDisposition',\n 'b2ContentLanguage',\n 'b2ContentEncoding',\n 'b2ContentType',\n 'b2CacheControl',\n 'b2Expires',\n] as const\n\n/**\n * Builds the HTTP request headers for a download: Authorization, optional\n * Range, and optional SSE-C decryption headers.\n *\n * @param authToken - The B2 session authorization token.\n * @param options - Caller-supplied download options.\n *\n * @returns The header map to send with the request.\n */\nfunction buildDownloadRequestHeaders(\n authToken: string,\n options: DownloadFileOptions | undefined,\n): Record<string, string> {\n const headers: Record<string, string> = { Authorization: authToken }\n if (options?.range) headers['Range'] = options.range\n if (options?.serverSideEncryption) {\n const encryption = options.serverSideEncryption\n // SSE-C keys may be redacted wrappers with non-enumerable key fields.\n // Read fields directly; object spread would drop the wire header values.\n applyEncryptionHeaders(headers, {\n mode: EncryptionMode.SseC,\n algorithm: encryption.algorithm,\n customerKey: encryption.customerKey,\n customerKeyMd5: encryption.customerKeyMd5,\n })\n }\n return headers\n}\n\n/**\n * Appends the documented `b2Content*` response-header overrides to a download\n * URL as query-string parameters. B2 echoes the values into the response\n * headers so callers can control content type, disposition, and caching.\n *\n * @param url - The base download URL.\n * @param options - Caller-supplied download options.\n *\n * @returns The URL with any override parameters appended.\n */\nfunction appendDownloadOverrides(url: string, options: DownloadFileOptions | undefined): string {\n if (!options) return url\n const params: string[] = []\n for (const key of DOWNLOAD_OVERRIDE_PARAMS) {\n const value = options[key]\n if (value !== undefined) {\n params.push(`${key}=${encodeURIComponent(value)}`)\n }\n }\n if (params.length === 0) return url\n const separator = url.includes('?') ? '&' : '?'\n return `${url}${separator}${params.join('&')}`\n}\n\n/**\n * Applies file retention headers to the request.\n * @param headers - The mutable headers object to populate.\n * @param retention - The retention settings, or undefined to skip.\n */\nfunction applyRetentionHeaders(\n headers: Record<string, string>,\n retention: FileRetentionValue | undefined,\n): void {\n if (!retention) return\n if (retention.mode) {\n headers['X-Bz-File-Retention-Mode'] = retention.mode\n }\n if (retention.retainUntilTimestamp) {\n headers['X-Bz-File-Retention-Retain-Until-Timestamp'] = String(retention.retainUntilTimestamp)\n }\n}\n\n/**\n * Applies the legal hold header to the request.\n * @param headers - The mutable headers object to populate.\n * @param legalHold - The legal hold value, or undefined to skip.\n */\nfunction applyLegalHoldHeader(\n headers: Record<string, string>,\n legalHold: LegalHoldValue | undefined,\n): void {\n if (!legalHold) return\n headers['X-Bz-File-Legal-Hold'] = legalHold\n}\n\nexport {\n buildFileInfoHeaders,\n decodeFileName,\n encodeFileName,\n parseFileInfoHeaders,\n} from './encoding.ts'\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.cjs","names":[],"sources":["../../src/raw/index.ts"],"sourcesContent":["/**\n * Low-level 1:1 bindings for every B2 native API endpoint.\n *\n * Each method on {@link RawClient} maps directly to a single `b2_*` HTTP call\n * with fully typed request and response objects. No retry logic, no URL pooling,\n * no automatic reauthorization. Use this when you need precise control over\n * individual API calls; for most use cases prefer the high-level `B2Client`.\n * SDK-built B2 native storage API URLs use `/b2api/v4`. JSON endpoints use\n * POST request bodies, including read/list endpoints whose API docs also show\n * GET query examples but document POST JSON compatibility.\n *\n * @packageDocumentation\n */\n\nimport { assertSecureRealmUrl } from '../auth/realms.ts'\nimport { assertValidBucketConfiguration } from '../bucket-validation.ts'\nimport { FinishLargeFileResponseBodyError, UploadResponseBodyError } from '../errors/index.ts'\nimport type { RetryOptions } from '../http/retry.ts'\nimport type { HttpTransport } from '../http/transport.ts'\nimport type {\n AllowedBucket,\n ApplicationKey,\n AuthorizeAccountResponse,\n BucketId,\n BucketInfo,\n CancelLargeFileRequest,\n CancelLargeFileResponse,\n CopyFileRequest,\n CopyPartRequest,\n CopyPartResponse,\n CreateBucketRequest,\n CreateKeyRequest,\n DeleteBucketRequest,\n DeleteFileVersionRequest,\n DeleteFileVersionResponse,\n DeleteKeyRequest,\n DownloadAuthorizationRequest,\n DownloadAuthorizationResponse,\n FileVersion,\n FinishLargeFileRequest,\n FullApplicationKey,\n GetBucketNotificationRulesRequest,\n GetBucketNotificationRulesResponse,\n GetFileInfoRequest,\n GetUploadPartUrlRequest,\n GetUploadPartUrlResponse,\n GetUploadUrlRequest,\n GetUploadUrlResponse,\n HideFileRequest,\n ListBucketsRequest,\n ListBucketsResponse,\n ListFileNamesMaybeDelimiterRequest,\n ListFileNamesRequest,\n ListFileNamesResponse,\n ListFileNamesWithDelimiterRequest,\n ListFileNamesWithDelimiterResponse,\n ListFileVersionsMaybeDelimiterRequest,\n ListFileVersionsRequest,\n ListFileVersionsResponse,\n ListFileVersionsWithDelimiterRequest,\n ListFileVersionsWithDelimiterResponse,\n ListKeysRequest,\n ListKeysResponse,\n ListPartsRequest,\n ListPartsResponse,\n ListUnfinishedLargeFilesRequest,\n ListUnfinishedLargeFilesResponse,\n SetBucketNotificationRulesRequest,\n SetBucketNotificationRulesResponse,\n StartLargeFileRequest,\n StartLargeFileResponse,\n UpdateBucketRequest,\n UpdateFileLegalHoldRequest,\n UpdateFileLegalHoldResponse,\n UpdateFileRetentionRequest,\n UpdateFileRetentionResponse,\n} from '../types/index.ts'\nimport type { UploadFileHeaders, UploadPartHeaders, UploadPartResponse } from '../types/upload.ts'\nimport { normalizeFileVersionListSha1, normalizeFileVersionSha1 } from '../util/normalize.ts'\nimport { buildFileInfoHeaders, encodeFileName } from './encoding.ts'\nimport { type B2EndpointUrlOptions, b2Url } from './url.ts'\n\nexport {\n assertValidBucketConfiguration,\n assertValidBucketInfo,\n assertValidCorsRules,\n} from '../bucket-validation.ts'\nexport {\n BUCKET_INFO_KEY_MAX_BYTES,\n BUCKET_INFO_KEY_MIN_BYTES,\n BUCKET_INFO_KEY_PATTERN,\n BUCKET_INFO_RESERVED_PREFIX,\n BUCKET_INFO_VALUES_MAX_BYTES,\n BucketKeyOption,\n CORS_ALLOWED_OPERATIONS,\n CORS_MAX_AGE_SECONDS_MAX,\n CORS_RULE_MAX_BYTES,\n CORS_RULE_NAME_MAX_LENGTH,\n CORS_RULE_NAME_MIN_LENGTH,\n CORS_RULE_NAME_PATTERN,\n CORS_RULE_NAME_RESERVED_PREFIX,\n CORS_RULES_MAX_COUNT,\n CorsOperation,\n} from '../types/bucket.ts'\n\nconst B2_NATIVE_API: B2EndpointUrlOptions = { prefix: 'b2api', version: 'v4' }\n\n/** Configuration for constructing a {@link RawClient}. */\nexport interface RawClientOptions {\n /** The HTTP transport used to send requests (e.g., FetchTransport or RetryTransport). */\n readonly transport: HttpTransport\n}\n\n/** Optional request controls for {@link RawClient.listFileNames}. */\nexport type ListFileNamesOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.authorizeAccount}. */\nexport type AuthorizeAccountOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.listFileVersions}. */\nexport type ListFileVersionsOptions = RawRequestOptions\n\n/** Optional controls for raw JSON API requests. */\nexport interface RawRequestOptions {\n /** Abort signal for cancelling the request. */\n readonly signal?: AbortSignal\n /** Per-request retry override. */\n readonly retry?: Partial<RetryOptions>\n}\n\n/**\n * @deprecated Use {@link RawRequestOptions}.\n */\nexport type JsonPostOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.finishLargeFile}. */\nexport type FinishLargeFileOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.copyPart}. */\nexport type CopyPartOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.startLargeFile}. */\nexport type StartLargeFileOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.uploadFile}. */\nexport type UploadFileOptions = RawRequestOptions\n\n/** Optional request controls for {@link RawClient.uploadPart}. */\nexport type UploadPartOptions = RawRequestOptions\n\nfunction normalizeRawRequestOptions(\n optionsOrSignal?: RawRequestOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n): RawRequestOptions | undefined {\n if (optionsOrSignal === undefined) {\n return retry === undefined ? undefined : { retry }\n }\n if (isAbortSignal(optionsOrSignal)) {\n return {\n signal: optionsOrSignal,\n ...(retry !== undefined ? { retry } : {}),\n }\n }\n return retry === undefined ? optionsOrSignal : { ...optionsOrSignal, retry }\n}\n\nfunction isAbortSignal(value: unknown): value is AbortSignal {\n // Back-compat only: legacy upload-URL overloads accepted an AbortSignal as\n // the fourth positional argument. Prefer the RawRequestOptions bag.\n return (\n typeof value === 'object' &&\n value !== null &&\n 'aborted' in value &&\n typeof (value as AbortSignal).addEventListener === 'function'\n )\n}\n\nfunction assertCustomUploadTimestamp(value: unknown): asserts value is number {\n if (value === undefined) return\n if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0) return\n throw new TypeError('customUploadTimestamp must be a non-negative safe integer')\n}\n\nfunction assertSafeHttpHeaderValue(name: string, value: string): void {\n if (hasHttpHeaderControlByte(value)) {\n throw new TypeError(`${name} must not contain HTTP control characters`)\n }\n}\n\nfunction hasHttpHeaderControlByte(value: string): boolean {\n for (let i = 0; i < value.length; i += 1) {\n const code = value.charCodeAt(i)\n if (code <= 0x1f || code === 0x7f) return true\n }\n return false\n}\n\nfunction setB2ContentFileInfoHeader(\n headers: Record<string, string>,\n key: string,\n optionName: string,\n value: string | undefined,\n): void {\n if (!value) return\n assertSafeHttpHeaderValue(optionName, value)\n Object.assign(headers, buildFileInfoHeaders({ [key]: value }))\n}\n\nfunction assertRawCustomUploadTimestamp(\n value: unknown,\n): asserts value is string | null | undefined {\n if (value === undefined || value === null) return\n if (typeof value === 'string' && /^\\d+$/.test(value)) {\n const timestamp = Number(value)\n if (Number.isSafeInteger(timestamp)) return\n }\n throw new TypeError('customUploadTimestamp must be a non-negative safe integer string or null')\n}\n\nfunction normalizeCreateKeyRequest(request: CreateKeyRequest): CreateKeyRequest {\n const { bucketId, ...withoutDeprecatedBucketId } = request\n if (bucketId !== undefined && withoutDeprecatedBucketId.bucketIds !== undefined) {\n throw new TypeError('createKey accepts either bucketIds or deprecated bucketId, not both')\n }\n if (bucketId === undefined) {\n return withoutDeprecatedBucketId\n }\n return { ...withoutDeprecatedBucketId, bucketIds: [bucketId] }\n}\n\nfunction singleBucketId(bucketIds: readonly BucketId[] | null): BucketId | null {\n return bucketIds?.length === 1 ? (bucketIds[0] ?? null) : null\n}\n\nfunction normalizeKeyResponse<T extends { readonly bucketIds: readonly BucketId[] | null }>(\n key: T,\n): T & { readonly bucketId: BucketId | null } {\n return { ...key, bucketId: singleBucketId(key.bucketIds) }\n}\n\ntype NormalizedAllowedInfo = AuthorizeAccountResponse['apiInfo']['storageApi']['allowed']\ntype NormalizedStorageApiInfo = AuthorizeAccountResponse['apiInfo']['storageApi']\n\ninterface WireAllowedInfo {\n readonly capabilities?: NormalizedAllowedInfo['capabilities']\n readonly buckets?: readonly AllowedBucket[] | null\n readonly bucketId?: BucketId | null\n readonly bucketName?: string | null\n readonly namePrefix?: string | null\n}\n\ntype WireStorageApiInfo = Omit<\n NormalizedStorageApiInfo,\n 'allowed' | 'bucketId' | 'bucketName' | 'infoType' | 'namePrefix'\n> & {\n readonly allowed?: WireAllowedInfo\n readonly capabilities?: NormalizedAllowedInfo['capabilities']\n readonly bucketId?: BucketId | null\n readonly bucketName?: string | null\n readonly infoType?: 'storageApi'\n readonly namePrefix?: string | null\n}\n\ntype WireAuthorizeAccountResponse = Omit<AuthorizeAccountResponse, 'apiInfo'> & {\n readonly apiInfo: Omit<AuthorizeAccountResponse['apiInfo'], 'storageApi'> & {\n readonly storageApi: WireStorageApiInfo\n }\n}\n\nfunction normalizeAllowedBuckets(storageApi: WireStorageApiInfo): readonly AllowedBucket[] | null {\n const allowed = storageApi.allowed\n if (allowed?.buckets !== undefined) {\n return allowed.buckets === null ? null : allowed.buckets.map((bucket) => ({ ...bucket }))\n }\n const bucketId = allowed?.bucketId ?? storageApi.bucketId ?? null\n if (bucketId === null) return null\n return [{ id: bucketId, name: allowed?.bucketName ?? storageApi.bucketName ?? null }]\n}\n\nfunction normalizeAuthorizeAccountResponse(\n response: WireAuthorizeAccountResponse,\n): AuthorizeAccountResponse {\n const storageApi = response.apiInfo.storageApi\n const allowed = storageApi.allowed\n const buckets = normalizeAllowedBuckets(storageApi)\n const singleBucket = buckets?.length === 1 ? buckets[0] : undefined\n const bucketId = singleBucket?.id ?? null\n const bucketName = singleBucket?.name ?? null\n const namePrefix = allowed?.namePrefix ?? storageApi.namePrefix ?? null\n const capabilities = allowed?.capabilities ?? storageApi.capabilities ?? []\n const { allowed: _wireAllowed, capabilities: _legacyCapabilities, ...storageApiBase } = storageApi\n\n return {\n ...response,\n apiInfo: {\n ...response.apiInfo,\n storageApi: {\n ...storageApiBase,\n bucketId,\n bucketName,\n downloadUrl: storageApi.downloadUrl,\n infoType: 'storageApi',\n namePrefix,\n allowed: {\n ...(allowed ?? {}),\n capabilities,\n buckets,\n bucketId,\n bucketName,\n namePrefix,\n },\n },\n },\n }\n}\n\nfunction uploadResponseBodyError(\n err: unknown,\n signal: AbortSignal | undefined,\n): UploadResponseBodyError {\n if (signal?.aborted === true) {\n throw signal.reason ?? new DOMException('Aborted', 'AbortError')\n }\n const message = err instanceof Error ? err.message : 'Upload response body could not be read'\n return new UploadResponseBodyError(message, { cause: err })\n}\n\n/**\n * Low-level client providing 1:1 bindings to all B2 native API endpoints.\n *\n * Each method maps directly to a single B2 API call. Most methods accept\n * `(apiUrl, authToken, request)` and return the JSON response. Upload and\n * download methods accept endpoint-specific parameters instead.\n */\nexport class RawClient {\n /** @internal */\n private readonly transport: HttpTransport\n\n /**\n * Creates a new RawClient with the given transport.\n * @param options - The constructor configuration.\n */\n constructor(options: RawClientOptions) {\n this.transport = options.transport\n }\n\n // --- Auth ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-authorize-account | b2_authorize_account}.\n * @param applicationKeyId - The application key ID for authentication.\n * @param applicationKey - The application key secret.\n * @param realmUrl - The B2 realm URL to authenticate against.\n * @param options - Optional request controls.\n *\n * @returns The authorization response with API URLs and credentials.\n */\n async authorizeAccount(\n applicationKeyId: string,\n applicationKey: string,\n realmUrl = 'https://api.backblazeb2.com',\n options?: AuthorizeAccountOptions,\n ): Promise<AuthorizeAccountResponse> {\n assertSecureRealmUrl(realmUrl)\n const response = await this.transport.send({\n url: b2Url(realmUrl, { ...B2_NATIVE_API, endpoint: 'b2_authorize_account' }),\n method: 'GET',\n headers: {\n Authorization: `Basic ${btoa(`${applicationKeyId}:${applicationKey}`)}`,\n },\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n return normalizeAuthorizeAccountResponse(await response.json<WireAuthorizeAccountResponse>())\n }\n\n // --- Buckets ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-create-bucket | b2_create_bucket}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The created bucket metadata.\n */\n async createBucket(\n apiUrl: string,\n authToken: string,\n request: CreateBucketRequest,\n ): Promise<BucketInfo> {\n assertValidBucketConfiguration(request)\n return this.postJson<BucketInfo>(apiUrl, authToken, 'b2_create_bucket', request)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-delete-bucket | b2_delete_bucket}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The deleted bucket metadata.\n */\n async deleteBucket(\n apiUrl: string,\n authToken: string,\n request: DeleteBucketRequest,\n ): Promise<BucketInfo> {\n return this.postJson<BucketInfo>(apiUrl, authToken, 'b2_delete_bucket', request)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-buckets | b2_list_buckets}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The list of matching buckets.\n */\n async listBuckets(\n apiUrl: string,\n authToken: string,\n request: ListBucketsRequest,\n ): Promise<ListBucketsResponse> {\n return this.postJson<ListBucketsResponse>(apiUrl, authToken, 'b2_list_buckets', request)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-update-bucket | b2_update_bucket}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated bucket metadata.\n */\n async updateBucket(\n apiUrl: string,\n authToken: string,\n request: UpdateBucketRequest,\n ): Promise<BucketInfo> {\n assertValidBucketConfiguration(request)\n return this.postJson<BucketInfo>(apiUrl, authToken, 'b2_update_bucket', request)\n }\n\n // --- Files ---\n\n /**\n * Calls `b2_get_upload_url` with legacy positional request controls.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param signal - Optional abort signal for cancellation.\n * @param retry - Optional per-request retry override.\n *\n * @returns The upload URL and authorization token.\n *\n * @deprecated Use the options-bag overload: `getUploadUrl(apiUrl, authToken, request, { signal, retry })`.\n */\n async getUploadUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadUrlRequest,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadUrlResponse>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-upload-url | b2_get_upload_url}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The upload URL and authorization token.\n */\n async getUploadUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadUrlRequest,\n options?: RawRequestOptions,\n ): Promise<GetUploadUrlResponse>\n /**\n * Implementation for both upload URL request-control signatures.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The upload URL and authorization token.\n */\n async getUploadUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadUrlRequest,\n optionsOrSignal?: RawRequestOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadUrlResponse> {\n return this.postJson<GetUploadUrlResponse>(\n apiUrl,\n authToken,\n 'b2_get_upload_url',\n request,\n normalizeRawRequestOptions(optionsOrSignal, retry),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-file | b2_upload_file}.\n *\n * Unlike most methods, this posts directly to the `uploadUrl` obtained\n * from {@link getUploadUrl} rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param signal - Optional legacy abort signal for cancellation.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded file version metadata.\n *\n * @deprecated Use the options-bag overload: `uploadFile(uploadUrl, headers, body, { signal, retry })`.\n */\n async uploadFile(\n uploadUrl: string,\n headers: UploadFileHeaders,\n body: BodyInit,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<FileVersion>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-file | b2_upload_file}.\n *\n * Unlike most methods, this posts directly to the `uploadUrl` obtained\n * from {@link getUploadUrl} rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The uploaded file version metadata.\n */\n async uploadFile(\n uploadUrl: string,\n headers: UploadFileHeaders,\n body: BodyInit,\n options?: UploadFileOptions,\n ): Promise<FileVersion>\n /**\n * Implementation for both upload-file request-control signatures.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded file version metadata.\n */\n async uploadFile(\n uploadUrl: string,\n headers: UploadFileHeaders,\n body: BodyInit,\n optionsOrSignal?: UploadFileOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<FileVersion> {\n const options = normalizeRawRequestOptions(optionsOrSignal, retry)\n assertSafeHttpHeaderValue('authorization', headers.authorization)\n assertSafeHttpHeaderValue('contentType', headers.contentType)\n assertSafeHttpHeaderValue('contentSha1', headers.contentSha1)\n const reqHeaders: Record<string, string> = {\n Authorization: headers.authorization,\n 'X-Bz-File-Name': encodeFileName(headers.fileName),\n 'Content-Type': headers.contentType,\n 'Content-Length': String(headers.contentLength),\n 'X-Bz-Content-Sha1': headers.contentSha1,\n ...buildFileInfoHeaders(headers.fileInfo),\n }\n\n if (headers.lastModifiedMillis !== undefined) {\n reqHeaders['X-Bz-Info-src_last_modified_millis'] = String(headers.lastModifiedMillis)\n }\n if (headers.customUploadTimestamp !== undefined) {\n assertCustomUploadTimestamp(headers.customUploadTimestamp)\n reqHeaders['X-Bz-Custom-Upload-Timestamp'] = String(headers.customUploadTimestamp)\n }\n setB2ContentFileInfoHeader(\n reqHeaders,\n 'b2-content-disposition',\n 'contentDisposition',\n headers.contentDisposition,\n )\n setB2ContentFileInfoHeader(\n reqHeaders,\n 'b2-content-language',\n 'contentLanguage',\n headers.contentLanguage,\n )\n setB2ContentFileInfoHeader(reqHeaders, 'b2-expires', 'expires', headers.expires)\n setB2ContentFileInfoHeader(reqHeaders, 'b2-cache-control', 'cacheControl', headers.cacheControl)\n setB2ContentFileInfoHeader(\n reqHeaders,\n 'b2-content-encoding',\n 'contentEncoding',\n headers.contentEncoding,\n )\n\n applyEncryptionHeaders(reqHeaders, headers.serverSideEncryption)\n applyRetentionHeaders(reqHeaders, headers.fileRetention)\n applyLegalHoldHeader(reqHeaders, headers.legalHold)\n\n const response = await this.transport.send({\n url: uploadUrl,\n method: 'POST',\n headers: reqHeaders,\n body,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n try {\n return normalizeFileVersionSha1(await response.json<FileVersion>())\n } catch (err) {\n throw uploadResponseBodyError(err, options?.signal)\n }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-file-names | b2_list_file_names}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The list of file names and optional continuation token. Requests\n * with `delimiter` use the delimiter overload and may include virtual\n * folder rows.\n */\n async listFileNames(\n apiUrl: string,\n authToken: string,\n request: ListFileNamesWithDelimiterRequest,\n options?: ListFileNamesOptions,\n ): Promise<ListFileNamesWithDelimiterResponse>\n async listFileNames(\n apiUrl: string,\n authToken: string,\n request: ListFileNamesRequest,\n options?: ListFileNamesOptions,\n ): Promise<ListFileNamesResponse>\n async listFileNames(\n apiUrl: string,\n authToken: string,\n request: ListFileNamesMaybeDelimiterRequest,\n options?: ListFileNamesOptions,\n ): Promise<ListFileNamesResponse | ListFileNamesWithDelimiterResponse>\n async listFileNames(\n apiUrl: string,\n authToken: string,\n request:\n | ListFileNamesRequest\n | ListFileNamesWithDelimiterRequest\n | ListFileNamesMaybeDelimiterRequest,\n options?: ListFileNamesOptions,\n ): Promise<ListFileNamesResponse | ListFileNamesWithDelimiterResponse> {\n return normalizeFileVersionListSha1(\n await this.postJson<ListFileNamesResponse | ListFileNamesWithDelimiterResponse>(\n apiUrl,\n authToken,\n 'b2_list_file_names',\n request,\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-file-versions | b2_list_file_versions}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The list of file versions and optional continuation token.\n * Requests with `delimiter` use the delimiter overload and may include\n * virtual folder rows.\n */\n async listFileVersions(\n apiUrl: string,\n authToken: string,\n request: ListFileVersionsWithDelimiterRequest,\n options?: ListFileVersionsOptions,\n ): Promise<ListFileVersionsWithDelimiterResponse>\n async listFileVersions(\n apiUrl: string,\n authToken: string,\n request: ListFileVersionsRequest,\n options?: ListFileVersionsOptions,\n ): Promise<ListFileVersionsResponse>\n async listFileVersions(\n apiUrl: string,\n authToken: string,\n request: ListFileVersionsMaybeDelimiterRequest,\n options?: ListFileVersionsOptions,\n ): Promise<ListFileVersionsResponse | ListFileVersionsWithDelimiterResponse>\n async listFileVersions(\n apiUrl: string,\n authToken: string,\n request:\n | ListFileVersionsRequest\n | ListFileVersionsWithDelimiterRequest\n | ListFileVersionsMaybeDelimiterRequest,\n options?: ListFileVersionsOptions,\n ): Promise<ListFileVersionsResponse | ListFileVersionsWithDelimiterResponse> {\n return normalizeFileVersionListSha1(\n await this.postJson<ListFileVersionsResponse | ListFileVersionsWithDelimiterResponse>(\n apiUrl,\n authToken,\n 'b2_list_file_versions',\n request,\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-file-info | b2_get_file_info}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The file version metadata.\n */\n async getFileInfo(\n apiUrl: string,\n authToken: string,\n request: GetFileInfoRequest,\n ): Promise<FileVersion> {\n return normalizeFileVersionSha1(\n await this.postJson<FileVersion>(apiUrl, authToken, 'b2_get_file_info', request),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-hide-file | b2_hide_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The hidden file version metadata.\n */\n async hideFile(\n apiUrl: string,\n authToken: string,\n request: HideFileRequest,\n options?: { readonly signal?: AbortSignal },\n ): Promise<FileVersion> {\n return normalizeFileVersionSha1(\n await this.postJson<FileVersion>(apiUrl, authToken, 'b2_hide_file', request, options),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-delete-file-version | b2_delete_file_version}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The deleted file version identifier.\n */\n async deleteFileVersion(\n apiUrl: string,\n authToken: string,\n request: DeleteFileVersionRequest,\n options?: { readonly signal?: AbortSignal },\n ): Promise<DeleteFileVersionResponse> {\n return this.postJson<DeleteFileVersionResponse>(\n apiUrl,\n authToken,\n 'b2_delete_file_version',\n request,\n options,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-copy-file | b2_copy_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as an abort signal.\n *\n * @returns The copied file version metadata.\n */\n async copyFile(\n apiUrl: string,\n authToken: string,\n request: CopyFileRequest,\n options?: RawRequestOptions,\n ): Promise<FileVersion> {\n return normalizeFileVersionSha1(\n await this.postJson<FileVersion>(\n apiUrl,\n authToken,\n 'b2_copy_file',\n withJsonBodyWireSseC(request),\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-copy-part | b2_copy_part}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional abort and retry controls.\n *\n * @returns The copied part metadata.\n */\n async copyPart(\n apiUrl: string,\n authToken: string,\n request: CopyPartRequest,\n options?: CopyPartOptions,\n ): Promise<CopyPartResponse> {\n return this.postJson<CopyPartResponse>(\n apiUrl,\n authToken,\n 'b2_copy_part',\n withJsonBodyWireSseC(request),\n options,\n )\n }\n\n // --- Large Files ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-start-large-file | b2_start_large_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional abort and retry controls.\n *\n * @returns The started large file metadata with file ID.\n */\n async startLargeFile(\n apiUrl: string,\n authToken: string,\n request: StartLargeFileRequest,\n options?: StartLargeFileOptions,\n ): Promise<StartLargeFileResponse> {\n assertRawCustomUploadTimestamp(request.customUploadTimestamp)\n return normalizeFileVersionSha1(\n await this.postJson<StartLargeFileResponse>(\n apiUrl,\n authToken,\n 'b2_start_large_file',\n withJsonBodyWireSseC(request),\n options,\n ),\n )\n }\n\n /**\n * Calls `b2_get_upload_part_url` with legacy positional request controls.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param signal - Optional abort signal for cancellation.\n * @param retry - Optional per-request retry override.\n *\n * @returns The upload part URL and authorization token.\n *\n * @deprecated Use the options-bag overload: `getUploadPartUrl(apiUrl, authToken, request, { signal, retry })`.\n */\n async getUploadPartUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadPartUrlRequest,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadPartUrlResponse>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-upload-part-url | b2_get_upload_part_url}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The upload part URL and authorization token.\n */\n async getUploadPartUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadPartUrlRequest,\n options?: RawRequestOptions,\n ): Promise<GetUploadPartUrlResponse>\n /**\n * Implementation for both upload part URL request-control signatures.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The upload part URL and authorization token.\n */\n async getUploadPartUrl(\n apiUrl: string,\n authToken: string,\n request: GetUploadPartUrlRequest,\n optionsOrSignal?: RawRequestOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<GetUploadPartUrlResponse> {\n return this.postJson<GetUploadPartUrlResponse>(\n apiUrl,\n authToken,\n 'b2_get_upload_part_url',\n request,\n normalizeRawRequestOptions(optionsOrSignal, retry),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-part | b2_upload_part}.\n *\n * Posts directly to the `uploadUrl` obtained from {@link getUploadPartUrl}\n * rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param signal - Optional legacy abort signal for cancellation.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded part metadata.\n *\n * @deprecated Use the options-bag overload: `uploadPart(uploadUrl, headers, body, { signal, retry })`.\n */\n async uploadPart(\n uploadUrl: string,\n headers: UploadPartHeaders,\n body: BodyInit,\n signal?: AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<UploadPartResponse>\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-upload-part | b2_upload_part}.\n *\n * Posts directly to the `uploadUrl` obtained from {@link getUploadPartUrl}\n * rather than the API URL.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The uploaded part metadata.\n */\n async uploadPart(\n uploadUrl: string,\n headers: UploadPartHeaders,\n body: BodyInit,\n options?: UploadPartOptions,\n ): Promise<UploadPartResponse>\n /**\n * Implementation for both upload-part request-control signatures.\n * @param uploadUrl - The upload endpoint URL.\n * @param headers - The request headers including authorization and content metadata.\n * @param body - The file data to upload.\n * @param optionsOrSignal - Options bag or legacy abort signal.\n * @param retry - Optional legacy per-request retry override.\n *\n * @returns The uploaded part metadata.\n */\n async uploadPart(\n uploadUrl: string,\n headers: UploadPartHeaders,\n body: BodyInit,\n optionsOrSignal?: UploadPartOptions | AbortSignal,\n retry?: Partial<RetryOptions>,\n ): Promise<UploadPartResponse> {\n const options = normalizeRawRequestOptions(optionsOrSignal, retry)\n assertSafeHttpHeaderValue('authorization', headers.authorization)\n assertSafeHttpHeaderValue('contentSha1', headers.contentSha1)\n const reqHeaders: Record<string, string> = {\n Authorization: headers.authorization,\n 'X-Bz-Part-Number': String(headers.partNumber),\n 'Content-Length': String(headers.contentLength),\n 'X-Bz-Content-Sha1': headers.contentSha1,\n }\n\n applyEncryptionHeaders(reqHeaders, headers.serverSideEncryption)\n\n const response = await this.transport.send({\n url: uploadUrl,\n method: 'POST',\n headers: reqHeaders,\n body,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n try {\n return await response.json<UploadPartResponse>()\n } catch (err) {\n throw uploadResponseBodyError(err, options?.signal)\n }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-finish-large-file | b2_finish_large_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional abort and retry controls.\n *\n * @returns The completed file version metadata.\n */\n async finishLargeFile(\n apiUrl: string,\n authToken: string,\n request: FinishLargeFileRequest,\n options?: FinishLargeFileOptions,\n ): Promise<FileVersion> {\n const response = await this.transport.send({\n url: b2Url(apiUrl, { ...B2_NATIVE_API, endpoint: 'b2_finish_large_file' }),\n method: 'POST',\n headers: {\n Authorization: authToken,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(request),\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n ...(options?.retry !== undefined ? { retry: options.retry } : {}),\n })\n\n let fileVersion: FileVersion\n try {\n fileVersion = await response.json<FileVersion>()\n } catch (err) {\n throw new FinishLargeFileResponseBodyError(\n err instanceof Error ? err.message : 'Finish large file response body could not be read',\n { cause: err, fileId: request.fileId },\n )\n }\n return normalizeFileVersionSha1(fileVersion)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-cancel-large-file | b2_cancel_large_file}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry overrides.\n *\n * @returns The cancelled large file metadata.\n */\n async cancelLargeFile(\n apiUrl: string,\n authToken: string,\n request: CancelLargeFileRequest,\n options?: RawRequestOptions,\n ): Promise<CancelLargeFileResponse> {\n return this.postJson<CancelLargeFileResponse>(\n apiUrl,\n authToken,\n 'b2_cancel_large_file',\n request,\n options,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-unfinished-large-files | b2_list_unfinished_large_files}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry.\n *\n * @returns The list of unfinished large files and optional continuation token.\n */\n async listUnfinishedLargeFiles(\n apiUrl: string,\n authToken: string,\n request: ListUnfinishedLargeFilesRequest,\n options?: RawRequestOptions,\n ): Promise<ListUnfinishedLargeFilesResponse> {\n return normalizeFileVersionListSha1(\n await this.postJson<ListUnfinishedLargeFilesResponse>(\n apiUrl,\n authToken,\n 'b2_list_unfinished_large_files',\n request,\n options,\n ),\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-parts | b2_list_parts}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n * @param options - Optional request controls such as cancellation and retry.\n *\n * @returns The list of uploaded parts and optional continuation token.\n */\n async listParts(\n apiUrl: string,\n authToken: string,\n request: ListPartsRequest,\n options?: RawRequestOptions,\n ): Promise<ListPartsResponse> {\n return this.postJson<ListPartsResponse>(apiUrl, authToken, 'b2_list_parts', request, options)\n }\n\n // --- Downloads ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-download-file-by-id | b2_download_file_by_id}.\n * @param downloadUrl - The B2 download base URL.\n * @param authToken - The authorization token.\n * @param fileId - The unique identifier of the file to download.\n * @param options - Optional download parameters for range requests and cancellation.\n *\n * @returns The response headers, streaming body, and HTTP status code.\n */\n async downloadFileById(\n downloadUrl: string,\n authToken: string,\n fileId: string,\n options?: DownloadFileOptions,\n ): Promise<{\n /** Response headers containing file metadata and B2 info headers. */\n headers: Headers\n /** Streaming response body, or `null` for HEAD-like responses. */\n body: ReadableStream<Uint8Array> | null\n /** HTTP status code (200 for full content, 206 for partial content). */\n status: number\n }> {\n const headers = buildDownloadRequestHeaders(authToken, options)\n const url = appendDownloadOverrides(\n `${b2Url(downloadUrl, {\n ...B2_NATIVE_API,\n endpoint: 'b2_download_file_by_id',\n })}?fileId=${encodeURIComponent(fileId)}`,\n options,\n )\n\n const response = await this.transport.send({\n url,\n method: options?.method ?? 'GET',\n headers,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n })\n\n return { headers: response.headers, body: response.body, status: response.status }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-download-file-by-name | b2_download_file_by_name}.\n * @param downloadUrl - The B2 download base URL.\n * @param authToken - The authorization token.\n * @param bucketName - The name of the bucket containing the file.\n * @param fileName - The name of the file to download.\n * @param options - Optional download parameters for range requests and cancellation.\n *\n * @returns The response headers, streaming body, and HTTP status code.\n */\n async downloadFileByName(\n downloadUrl: string,\n authToken: string,\n bucketName: string,\n fileName: string,\n options?: DownloadFileOptions,\n ): Promise<{\n /** Response headers containing file metadata and B2 info headers. */\n headers: Headers\n /** Streaming response body, or `null` for HEAD-like responses. */\n body: ReadableStream<Uint8Array> | null\n /** HTTP status code (200 for full content, 206 for partial content). */\n status: number\n }> {\n const headers = buildDownloadRequestHeaders(authToken, options)\n const url = appendDownloadOverrides(\n `${downloadUrl}/file/${encodeURIComponent(bucketName)}/${encodeFileName(fileName)}`,\n options,\n )\n\n const response = await this.transport.send({\n url,\n method: options?.method ?? 'GET',\n headers,\n ...(options?.signal !== undefined ? { signal: options.signal } : {}),\n })\n\n return { headers: response.headers, body: response.body, status: response.status }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-download-authorization | b2_get_download_authorization}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The current session authorization token.\n * @param request - The API request parameters.\n *\n * @returns The download authorization token for the specified file prefix.\n */\n async getDownloadAuthorization(\n apiUrl: string,\n authToken: string,\n request: DownloadAuthorizationRequest,\n ): Promise<DownloadAuthorizationResponse> {\n return this.postJson<DownloadAuthorizationResponse>(\n apiUrl,\n authToken,\n 'b2_get_download_authorization',\n request,\n )\n }\n\n // --- Keys ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-create-key | b2_create_key}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The newly created application key with secret.\n */\n async createKey(\n apiUrl: string,\n authToken: string,\n request: CreateKeyRequest,\n ): Promise<FullApplicationKey> {\n const key = await this.postJson<FullApplicationKey>(\n apiUrl,\n authToken,\n 'b2_create_key',\n normalizeCreateKeyRequest(request),\n )\n return normalizeKeyResponse(key)\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-list-keys | b2_list_keys}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The list of application keys and optional continuation token.\n */\n async listKeys(\n apiUrl: string,\n authToken: string,\n request: ListKeysRequest,\n ): Promise<ListKeysResponse> {\n const response = await this.postJson<ListKeysResponse>(\n apiUrl,\n authToken,\n 'b2_list_keys',\n request,\n )\n return { ...response, keys: response.keys.map((key) => normalizeKeyResponse(key)) }\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-delete-key | b2_delete_key}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The deleted application key metadata.\n */\n async deleteKey(\n apiUrl: string,\n authToken: string,\n request: DeleteKeyRequest,\n ): Promise<ApplicationKey> {\n const key = await this.postJson<ApplicationKey>(apiUrl, authToken, 'b2_delete_key', request)\n return normalizeKeyResponse(key)\n }\n\n // --- Retention / Legal Hold ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-update-file-retention | b2_update_file_retention}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated file retention settings.\n */\n async updateFileRetention(\n apiUrl: string,\n authToken: string,\n request: UpdateFileRetentionRequest,\n ): Promise<UpdateFileRetentionResponse> {\n return this.postJson<UpdateFileRetentionResponse>(\n apiUrl,\n authToken,\n 'b2_update_file_retention',\n request,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-update-file-legal-hold | b2_update_file_legal_hold}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated file legal hold status.\n */\n async updateFileLegalHold(\n apiUrl: string,\n authToken: string,\n request: UpdateFileLegalHoldRequest,\n ): Promise<UpdateFileLegalHoldResponse> {\n return this.postJson<UpdateFileLegalHoldResponse>(\n apiUrl,\n authToken,\n 'b2_update_file_legal_hold',\n request,\n )\n }\n\n // --- Notifications ---\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-get-bucket-notification-rules | b2_get_bucket_notification_rules}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The configured event notification rules for the specified bucket.\n */\n async getBucketNotificationRules(\n apiUrl: string,\n authToken: string,\n request: GetBucketNotificationRulesRequest,\n ): Promise<GetBucketNotificationRulesResponse> {\n return this.postJson<GetBucketNotificationRulesResponse>(\n apiUrl,\n authToken,\n 'b2_get_bucket_notification_rules',\n request,\n )\n }\n\n /**\n * Calls {@link https://www.backblaze.com/apidocs/b2-set-bucket-notification-rules | b2_set_bucket_notification_rules}.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param request - The API request parameters.\n *\n * @returns The updated bucket notification rules.\n */\n async setBucketNotificationRules(\n apiUrl: string,\n authToken: string,\n request: SetBucketNotificationRulesRequest,\n ): Promise<SetBucketNotificationRulesResponse> {\n return this.postJson<SetBucketNotificationRulesResponse>(\n apiUrl,\n authToken,\n 'b2_set_bucket_notification_rules',\n request,\n )\n }\n\n // --- Internal ---\n\n /**\n * Sends a JSON POST request to the specified B2 API endpoint.\n * @param apiUrl - The B2 API base URL.\n * @param authToken - The authorization token.\n * @param endpoint - The B2 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 apiUrl: string,\n authToken: string,\n endpoint: string,\n body: unknown,\n options?: RawRequestOptions,\n ): Promise<T> {\n const response = await this.transport.send({\n url: b2Url(apiUrl, { ...B2_NATIVE_API, 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\n// --- Header helpers ---\n\nimport {\n EncryptionAlgorithm,\n EncryptionMode,\n type EncryptionSetting,\n type SseCKeyMaterial,\n} from '../types/encryption.ts'\nimport type { FileRetentionValue, LegalHoldValue } from '../types/lock.ts'\n\ninterface JsonBodySseCRequest {\n readonly serverSideEncryption?: EncryptionSetting\n readonly sourceServerSideEncryption?: EncryptionSetting\n readonly destinationServerSideEncryption?: EncryptionSetting\n}\n\nfunction withJsonBodyWireSseC<T extends JsonBodySseCRequest>(request: T): T {\n return {\n ...request,\n ...(request.serverSideEncryption !== undefined\n ? { serverSideEncryption: toWireSseC(request.serverSideEncryption) }\n : {}),\n ...(request.sourceServerSideEncryption !== undefined\n ? { sourceServerSideEncryption: toWireSseC(request.sourceServerSideEncryption) }\n : {}),\n ...(request.destinationServerSideEncryption !== undefined\n ? { destinationServerSideEncryption: toWireSseC(request.destinationServerSideEncryption) }\n : {}),\n }\n}\n\nfunction toWireSseC(setting: EncryptionSetting): EncryptionSetting {\n if (setting.mode !== EncryptionMode.SseC) return setting\n // SSE-C settings may be redacted wrappers with non-enumerable key fields.\n // Passing the wrapper through would let toJSON() emit the redaction placeholder;\n // spreading it would drop the key fields. Read directly into a plain wire\n // literal for the B2 JSON body only, and never pass that cleartext literal to\n // diagnostics or logging sinks.\n return {\n mode: EncryptionMode.SseC,\n algorithm: setting.algorithm,\n customerKey: setting.customerKey,\n customerKeyMd5: setting.customerKeyMd5,\n }\n}\n\n/**\n * Applies server-side encryption headers to the request.\n * @param headers - The mutable headers object to populate.\n * @param encryption - The encryption settings, or undefined to skip.\n */\nfunction applyEncryptionHeaders(\n headers: Record<string, string>,\n encryption: EncryptionSetting | undefined,\n): void {\n if (!encryption || encryption.mode === EncryptionMode.None) return\n if (encryption.mode === EncryptionMode.SseB2) {\n headers['X-Bz-Server-Side-Encryption'] = EncryptionAlgorithm.Aes256\n } else if (encryption.mode === EncryptionMode.SseC) {\n headers['X-Bz-Server-Side-Encryption-Customer-Algorithm'] = EncryptionAlgorithm.Aes256\n headers['X-Bz-Server-Side-Encryption-Customer-Key'] = encryption.customerKey\n headers['X-Bz-Server-Side-Encryption-Customer-Key-Md5'] = encryption.customerKeyMd5\n }\n}\n\n/**\n * SSE-C decryption parameters supplied to downloads of files uploaded with customer-managed keys.\n * `customerKey` is secret key material sent as a request header; custom transports must redact\n * request headers before logging them.\n */\nexport type SseCDownloadKey = SseCKeyMaterial\n\n/**\n * Options accepted by {@link RawClient.downloadFileById} and\n * {@link RawClient.downloadFileByName}. Mirrors the B2 native API: range +\n * SSE-C decryption headers + the documented `b2Content*` response-header\n * overrides (query-string parameters on the request URL).\n */\nexport interface DownloadFileOptions {\n /** HTTP method. Defaults to `'GET'`. Use `'HEAD'` to fetch headers without the body. */\n readonly method?: 'GET' | 'HEAD'\n /** HTTP Range header value for partial content requests. */\n readonly range?: string\n /** SSE-C decryption parameters, required if the file was uploaded with SSE-C. */\n readonly serverSideEncryption?: SseCDownloadKey\n /** Override the `Content-Disposition` header in the download response. */\n readonly b2ContentDisposition?: string\n /** Override the `Content-Language` header in the download response. */\n readonly b2ContentLanguage?: string\n /** Override the `Content-Encoding` header in the download response. */\n readonly b2ContentEncoding?: string\n /** Override the `Content-Type` header in the download response. */\n readonly b2ContentType?: string\n /** Override the `Cache-Control` header in the download response. */\n readonly b2CacheControl?: string\n /** Override the `Expires` header in the download response. */\n readonly b2Expires?: string\n /** Signal to abort the download. */\n readonly signal?: AbortSignal\n}\n\nconst DOWNLOAD_OVERRIDE_PARAMS = [\n 'b2ContentDisposition',\n 'b2ContentLanguage',\n 'b2ContentEncoding',\n 'b2ContentType',\n 'b2CacheControl',\n 'b2Expires',\n] as const\n\n/**\n * Builds the HTTP request headers for a download: Authorization, optional\n * Range, and optional SSE-C decryption headers.\n *\n * @param authToken - The B2 session authorization token.\n * @param options - Caller-supplied download options.\n *\n * @returns The header map to send with the request.\n */\nfunction buildDownloadRequestHeaders(\n authToken: string,\n options: DownloadFileOptions | undefined,\n): Record<string, string> {\n const headers: Record<string, string> = { Authorization: authToken }\n if (options?.range) headers['Range'] = options.range\n if (options?.serverSideEncryption) {\n const encryption = options.serverSideEncryption\n // SSE-C keys may be redacted wrappers with non-enumerable key fields.\n // Read fields directly; object spread would drop the wire header values.\n applyEncryptionHeaders(headers, {\n mode: EncryptionMode.SseC,\n algorithm: encryption.algorithm,\n customerKey: encryption.customerKey,\n customerKeyMd5: encryption.customerKeyMd5,\n })\n }\n return headers\n}\n\n/**\n * Appends the documented `b2Content*` response-header overrides to a download\n * URL as query-string parameters. B2 echoes the values into the response\n * headers so callers can control content type, disposition, and caching.\n *\n * @param url - The base download URL.\n * @param options - Caller-supplied download options.\n *\n * @returns The URL with any override parameters appended.\n */\nfunction appendDownloadOverrides(url: string, options: DownloadFileOptions | undefined): string {\n if (!options) return url\n const params: string[] = []\n for (const key of DOWNLOAD_OVERRIDE_PARAMS) {\n const value = options[key]\n if (value !== undefined) {\n params.push(`${key}=${encodeURIComponent(value)}`)\n }\n }\n if (params.length === 0) return url\n const separator = url.includes('?') ? '&' : '?'\n return `${url}${separator}${params.join('&')}`\n}\n\n/**\n * Applies file retention headers to the request.\n * @param headers - The mutable headers object to populate.\n * @param retention - The retention settings, or undefined to skip.\n */\nfunction applyRetentionHeaders(\n headers: Record<string, string>,\n retention: FileRetentionValue | undefined,\n): void {\n if (!retention) return\n if (retention.mode) {\n headers['X-Bz-File-Retention-Mode'] = retention.mode\n }\n if (retention.retainUntilTimestamp) {\n headers['X-Bz-File-Retention-Retain-Until-Timestamp'] = String(retention.retainUntilTimestamp)\n }\n}\n\n/**\n * Applies the legal hold header to the request.\n * @param headers - The mutable headers object to populate.\n * @param legalHold - The legal hold value, or undefined to skip.\n */\nfunction applyLegalHoldHeader(\n headers: Record<string, string>,\n legalHold: LegalHoldValue | undefined,\n): void {\n if (!legalHold) return\n headers['X-Bz-File-Legal-Hold'] = legalHold\n}\n\nexport {\n buildFileInfoHeaders,\n decodeFileName,\n encodeFileName,\n parseFileInfoHeaders,\n} from './encoding.ts'\n"],"mappings":"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"}
|
package/dist/raw/index.d.cts
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
import { RetryOptions } from '../http/retry.js';
|
|
2
2
|
import { HttpTransport } from '../http/transport.js';
|
|
3
|
-
import { ApplicationKey, AuthorizeAccountResponse, BucketInfo, CancelLargeFileRequest, CancelLargeFileResponse, CopyFileRequest, CopyPartRequest, CopyPartResponse, CreateBucketRequest, CreateKeyRequest, DeleteBucketRequest, DeleteFileVersionRequest, DeleteFileVersionResponse, DeleteKeyRequest, DownloadAuthorizationRequest, DownloadAuthorizationResponse, FileVersion, FinishLargeFileRequest, FullApplicationKey, GetBucketNotificationRulesRequest, GetBucketNotificationRulesResponse, GetFileInfoRequest, GetUploadPartUrlRequest, GetUploadPartUrlResponse, GetUploadUrlRequest, GetUploadUrlResponse, HideFileRequest, ListBucketsRequest, ListBucketsResponse, ListFileNamesRequest, ListFileNamesResponse, ListFileVersionsRequest, ListFileVersionsResponse, ListKeysRequest, ListKeysResponse, ListPartsRequest, ListPartsResponse, ListUnfinishedLargeFilesRequest, ListUnfinishedLargeFilesResponse, SetBucketNotificationRulesRequest, SetBucketNotificationRulesResponse, StartLargeFileRequest, StartLargeFileResponse, UpdateBucketRequest, UpdateFileLegalHoldRequest, UpdateFileLegalHoldResponse, UpdateFileRetentionRequest, UpdateFileRetentionResponse } from '../types/index.js';
|
|
3
|
+
import { ApplicationKey, AuthorizeAccountResponse, BucketInfo, CancelLargeFileRequest, CancelLargeFileResponse, CopyFileRequest, CopyPartRequest, CopyPartResponse, CreateBucketRequest, CreateKeyRequest, DeleteBucketRequest, DeleteFileVersionRequest, DeleteFileVersionResponse, DeleteKeyRequest, DownloadAuthorizationRequest, DownloadAuthorizationResponse, FileVersion, FinishLargeFileRequest, FullApplicationKey, GetBucketNotificationRulesRequest, GetBucketNotificationRulesResponse, GetFileInfoRequest, GetUploadPartUrlRequest, GetUploadPartUrlResponse, GetUploadUrlRequest, GetUploadUrlResponse, HideFileRequest, ListBucketsRequest, ListBucketsResponse, ListFileNamesMaybeDelimiterRequest, ListFileNamesRequest, ListFileNamesResponse, ListFileNamesWithDelimiterRequest, ListFileNamesWithDelimiterResponse, ListFileVersionsMaybeDelimiterRequest, ListFileVersionsRequest, ListFileVersionsResponse, ListFileVersionsWithDelimiterRequest, ListFileVersionsWithDelimiterResponse, ListKeysRequest, ListKeysResponse, ListPartsRequest, ListPartsResponse, ListUnfinishedLargeFilesRequest, ListUnfinishedLargeFilesResponse, SetBucketNotificationRulesRequest, SetBucketNotificationRulesResponse, StartLargeFileRequest, StartLargeFileResponse, UpdateBucketRequest, UpdateFileLegalHoldRequest, UpdateFileLegalHoldResponse, UpdateFileRetentionRequest, UpdateFileRetentionResponse } from '../types/index.js';
|
|
4
4
|
import { UploadFileHeaders, UploadPartHeaders, UploadPartResponse } from '../types/upload.js';
|
|
5
|
-
import {
|
|
5
|
+
import { SseCKeyMaterial } from '../types/encryption.js';
|
|
6
|
+
export { assertValidBucketConfiguration, assertValidBucketInfo, assertValidCorsRules, } from '../bucket-validation.js';
|
|
7
|
+
export { BUCKET_INFO_KEY_MAX_BYTES, BUCKET_INFO_KEY_MIN_BYTES, BUCKET_INFO_KEY_PATTERN, BUCKET_INFO_RESERVED_PREFIX, BUCKET_INFO_VALUES_MAX_BYTES, BucketKeyOption, CORS_ALLOWED_OPERATIONS, CORS_MAX_AGE_SECONDS_MAX, CORS_RULE_MAX_BYTES, CORS_RULE_NAME_MAX_LENGTH, CORS_RULE_NAME_MIN_LENGTH, CORS_RULE_NAME_PATTERN, CORS_RULE_NAME_RESERVED_PREFIX, CORS_RULES_MAX_COUNT, CorsOperation, } from '../types/bucket.js';
|
|
6
8
|
/** Configuration for constructing a {@link RawClient}. */
|
|
7
9
|
export interface RawClientOptions {
|
|
8
10
|
/** The HTTP transport used to send requests (e.g., FetchTransport or RetryTransport). */
|
|
@@ -10,6 +12,8 @@ export interface RawClientOptions {
|
|
|
10
12
|
}
|
|
11
13
|
/** Optional request controls for {@link RawClient.listFileNames}. */
|
|
12
14
|
export type ListFileNamesOptions = RawRequestOptions;
|
|
15
|
+
/** Optional request controls for {@link RawClient.authorizeAccount}. */
|
|
16
|
+
export type AuthorizeAccountOptions = RawRequestOptions;
|
|
13
17
|
/** Optional request controls for {@link RawClient.listFileVersions}. */
|
|
14
18
|
export type ListFileVersionsOptions = RawRequestOptions;
|
|
15
19
|
/** Optional controls for raw JSON API requests. */
|
|
@@ -53,10 +57,11 @@ export declare class RawClient {
|
|
|
53
57
|
* @param applicationKeyId - The application key ID for authentication.
|
|
54
58
|
* @param applicationKey - The application key secret.
|
|
55
59
|
* @param realmUrl - The B2 realm URL to authenticate against.
|
|
60
|
+
* @param options - Optional request controls.
|
|
56
61
|
*
|
|
57
62
|
* @returns The authorization response with API URLs and credentials.
|
|
58
63
|
*/
|
|
59
|
-
authorizeAccount(applicationKeyId: string, applicationKey: string, realmUrl?: string): Promise<AuthorizeAccountResponse>;
|
|
64
|
+
authorizeAccount(applicationKeyId: string, applicationKey: string, realmUrl?: string, options?: AuthorizeAccountOptions): Promise<AuthorizeAccountResponse>;
|
|
60
65
|
/**
|
|
61
66
|
* Calls {@link https://www.backblaze.com/apidocs/b2-create-bucket | b2_create_bucket}.
|
|
62
67
|
* @param apiUrl - The B2 API base URL.
|
|
@@ -152,9 +157,13 @@ export declare class RawClient {
|
|
|
152
157
|
* @param request - The API request parameters.
|
|
153
158
|
* @param options - Optional request controls such as an abort signal.
|
|
154
159
|
*
|
|
155
|
-
* @returns The list of file names and optional continuation token.
|
|
160
|
+
* @returns The list of file names and optional continuation token. Requests
|
|
161
|
+
* with `delimiter` use the delimiter overload and may include virtual
|
|
162
|
+
* folder rows.
|
|
156
163
|
*/
|
|
164
|
+
listFileNames(apiUrl: string, authToken: string, request: ListFileNamesWithDelimiterRequest, options?: ListFileNamesOptions): Promise<ListFileNamesWithDelimiterResponse>;
|
|
157
165
|
listFileNames(apiUrl: string, authToken: string, request: ListFileNamesRequest, options?: ListFileNamesOptions): Promise<ListFileNamesResponse>;
|
|
166
|
+
listFileNames(apiUrl: string, authToken: string, request: ListFileNamesMaybeDelimiterRequest, options?: ListFileNamesOptions): Promise<ListFileNamesResponse | ListFileNamesWithDelimiterResponse>;
|
|
158
167
|
/**
|
|
159
168
|
* Calls {@link https://www.backblaze.com/apidocs/b2-list-file-versions | b2_list_file_versions}.
|
|
160
169
|
* @param apiUrl - The B2 API base URL.
|
|
@@ -163,8 +172,12 @@ export declare class RawClient {
|
|
|
163
172
|
* @param options - Optional request controls such as an abort signal.
|
|
164
173
|
*
|
|
165
174
|
* @returns The list of file versions and optional continuation token.
|
|
175
|
+
* Requests with `delimiter` use the delimiter overload and may include
|
|
176
|
+
* virtual folder rows.
|
|
166
177
|
*/
|
|
178
|
+
listFileVersions(apiUrl: string, authToken: string, request: ListFileVersionsWithDelimiterRequest, options?: ListFileVersionsOptions): Promise<ListFileVersionsWithDelimiterResponse>;
|
|
167
179
|
listFileVersions(apiUrl: string, authToken: string, request: ListFileVersionsRequest, options?: ListFileVersionsOptions): Promise<ListFileVersionsResponse>;
|
|
180
|
+
listFileVersions(apiUrl: string, authToken: string, request: ListFileVersionsMaybeDelimiterRequest, options?: ListFileVersionsOptions): Promise<ListFileVersionsResponse | ListFileVersionsWithDelimiterResponse>;
|
|
168
181
|
/**
|
|
169
182
|
* Calls {@link https://www.backblaze.com/apidocs/b2-get-file-info | b2_get_file_info}.
|
|
170
183
|
* @param apiUrl - The B2 API base URL.
|
|
@@ -434,28 +447,17 @@ export declare class RawClient {
|
|
|
434
447
|
* @param endpoint - The B2 API endpoint name.
|
|
435
448
|
* @param body - The JSON request body.
|
|
436
449
|
* @param options - Optional abort and per-request retry settings.
|
|
437
|
-
* @param urlOptions - B2 endpoint path prefix and version settings.
|
|
438
450
|
*
|
|
439
451
|
* @returns The parsed JSON response.
|
|
440
452
|
*/
|
|
441
453
|
private postJson;
|
|
442
454
|
}
|
|
443
455
|
/**
|
|
444
|
-
* SSE-C decryption parameters supplied to downloads of files
|
|
445
|
-
*
|
|
456
|
+
* SSE-C decryption parameters supplied to downloads of files uploaded with customer-managed keys.
|
|
457
|
+
* `customerKey` is secret key material sent as a request header; custom transports must redact
|
|
458
|
+
* request headers before logging them.
|
|
446
459
|
*/
|
|
447
|
-
export
|
|
448
|
-
/** Encryption algorithm. Always `EncryptionAlgorithm.Aes256` (`'AES256'`). */
|
|
449
|
-
readonly algorithm: EncryptionAlgorithm;
|
|
450
|
-
/**
|
|
451
|
-
* Base64-encoded customer-provided decryption key. This value must be sent as
|
|
452
|
-
* an HTTP request header for SSE-C downloads, so custom transports should not
|
|
453
|
-
* log request headers without redacting them first.
|
|
454
|
-
*/
|
|
455
|
-
readonly customerKey: string;
|
|
456
|
-
/** Base64-encoded MD5 digest of the decryption key. */
|
|
457
|
-
readonly customerKeyMd5: string;
|
|
458
|
-
}
|
|
460
|
+
export type SseCDownloadKey = SseCKeyMaterial;
|
|
459
461
|
/**
|
|
460
462
|
* Options accepted by {@link RawClient.downloadFileById} and
|
|
461
463
|
* {@link RawClient.downloadFileByName}. Mirrors the B2 native API: range +
|
package/dist/raw/index.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/raw/index.js"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/raw/index.js"],"names":[],"mappings":"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"}
|
package/dist/raw/index.d.ts
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
import { RetryOptions } from '../http/retry.js';
|
|
2
2
|
import { HttpTransport } from '../http/transport.js';
|
|
3
|
-
import { ApplicationKey, AuthorizeAccountResponse, BucketInfo, CancelLargeFileRequest, CancelLargeFileResponse, CopyFileRequest, CopyPartRequest, CopyPartResponse, CreateBucketRequest, CreateKeyRequest, DeleteBucketRequest, DeleteFileVersionRequest, DeleteFileVersionResponse, DeleteKeyRequest, DownloadAuthorizationRequest, DownloadAuthorizationResponse, FileVersion, FinishLargeFileRequest, FullApplicationKey, GetBucketNotificationRulesRequest, GetBucketNotificationRulesResponse, GetFileInfoRequest, GetUploadPartUrlRequest, GetUploadPartUrlResponse, GetUploadUrlRequest, GetUploadUrlResponse, HideFileRequest, ListBucketsRequest, ListBucketsResponse, ListFileNamesRequest, ListFileNamesResponse, ListFileVersionsRequest, ListFileVersionsResponse, ListKeysRequest, ListKeysResponse, ListPartsRequest, ListPartsResponse, ListUnfinishedLargeFilesRequest, ListUnfinishedLargeFilesResponse, SetBucketNotificationRulesRequest, SetBucketNotificationRulesResponse, StartLargeFileRequest, StartLargeFileResponse, UpdateBucketRequest, UpdateFileLegalHoldRequest, UpdateFileLegalHoldResponse, UpdateFileRetentionRequest, UpdateFileRetentionResponse } from '../types/index.js';
|
|
3
|
+
import { ApplicationKey, AuthorizeAccountResponse, BucketInfo, CancelLargeFileRequest, CancelLargeFileResponse, CopyFileRequest, CopyPartRequest, CopyPartResponse, CreateBucketRequest, CreateKeyRequest, DeleteBucketRequest, DeleteFileVersionRequest, DeleteFileVersionResponse, DeleteKeyRequest, DownloadAuthorizationRequest, DownloadAuthorizationResponse, FileVersion, FinishLargeFileRequest, FullApplicationKey, GetBucketNotificationRulesRequest, GetBucketNotificationRulesResponse, GetFileInfoRequest, GetUploadPartUrlRequest, GetUploadPartUrlResponse, GetUploadUrlRequest, GetUploadUrlResponse, HideFileRequest, ListBucketsRequest, ListBucketsResponse, ListFileNamesMaybeDelimiterRequest, ListFileNamesRequest, ListFileNamesResponse, ListFileNamesWithDelimiterRequest, ListFileNamesWithDelimiterResponse, ListFileVersionsMaybeDelimiterRequest, ListFileVersionsRequest, ListFileVersionsResponse, ListFileVersionsWithDelimiterRequest, ListFileVersionsWithDelimiterResponse, ListKeysRequest, ListKeysResponse, ListPartsRequest, ListPartsResponse, ListUnfinishedLargeFilesRequest, ListUnfinishedLargeFilesResponse, SetBucketNotificationRulesRequest, SetBucketNotificationRulesResponse, StartLargeFileRequest, StartLargeFileResponse, UpdateBucketRequest, UpdateFileLegalHoldRequest, UpdateFileLegalHoldResponse, UpdateFileRetentionRequest, UpdateFileRetentionResponse } from '../types/index.js';
|
|
4
4
|
import { UploadFileHeaders, UploadPartHeaders, UploadPartResponse } from '../types/upload.js';
|
|
5
|
-
import {
|
|
5
|
+
import { SseCKeyMaterial } from '../types/encryption.js';
|
|
6
|
+
export { assertValidBucketConfiguration, assertValidBucketInfo, assertValidCorsRules, } from '../bucket-validation.js';
|
|
7
|
+
export { BUCKET_INFO_KEY_MAX_BYTES, BUCKET_INFO_KEY_MIN_BYTES, BUCKET_INFO_KEY_PATTERN, BUCKET_INFO_RESERVED_PREFIX, BUCKET_INFO_VALUES_MAX_BYTES, BucketKeyOption, CORS_ALLOWED_OPERATIONS, CORS_MAX_AGE_SECONDS_MAX, CORS_RULE_MAX_BYTES, CORS_RULE_NAME_MAX_LENGTH, CORS_RULE_NAME_MIN_LENGTH, CORS_RULE_NAME_PATTERN, CORS_RULE_NAME_RESERVED_PREFIX, CORS_RULES_MAX_COUNT, CorsOperation, } from '../types/bucket.js';
|
|
6
8
|
/** Configuration for constructing a {@link RawClient}. */
|
|
7
9
|
export interface RawClientOptions {
|
|
8
10
|
/** The HTTP transport used to send requests (e.g., FetchTransport or RetryTransport). */
|
|
@@ -10,6 +12,8 @@ export interface RawClientOptions {
|
|
|
10
12
|
}
|
|
11
13
|
/** Optional request controls for {@link RawClient.listFileNames}. */
|
|
12
14
|
export type ListFileNamesOptions = RawRequestOptions;
|
|
15
|
+
/** Optional request controls for {@link RawClient.authorizeAccount}. */
|
|
16
|
+
export type AuthorizeAccountOptions = RawRequestOptions;
|
|
13
17
|
/** Optional request controls for {@link RawClient.listFileVersions}. */
|
|
14
18
|
export type ListFileVersionsOptions = RawRequestOptions;
|
|
15
19
|
/** Optional controls for raw JSON API requests. */
|
|
@@ -53,10 +57,11 @@ export declare class RawClient {
|
|
|
53
57
|
* @param applicationKeyId - The application key ID for authentication.
|
|
54
58
|
* @param applicationKey - The application key secret.
|
|
55
59
|
* @param realmUrl - The B2 realm URL to authenticate against.
|
|
60
|
+
* @param options - Optional request controls.
|
|
56
61
|
*
|
|
57
62
|
* @returns The authorization response with API URLs and credentials.
|
|
58
63
|
*/
|
|
59
|
-
authorizeAccount(applicationKeyId: string, applicationKey: string, realmUrl?: string): Promise<AuthorizeAccountResponse>;
|
|
64
|
+
authorizeAccount(applicationKeyId: string, applicationKey: string, realmUrl?: string, options?: AuthorizeAccountOptions): Promise<AuthorizeAccountResponse>;
|
|
60
65
|
/**
|
|
61
66
|
* Calls {@link https://www.backblaze.com/apidocs/b2-create-bucket | b2_create_bucket}.
|
|
62
67
|
* @param apiUrl - The B2 API base URL.
|
|
@@ -152,9 +157,13 @@ export declare class RawClient {
|
|
|
152
157
|
* @param request - The API request parameters.
|
|
153
158
|
* @param options - Optional request controls such as an abort signal.
|
|
154
159
|
*
|
|
155
|
-
* @returns The list of file names and optional continuation token.
|
|
160
|
+
* @returns The list of file names and optional continuation token. Requests
|
|
161
|
+
* with `delimiter` use the delimiter overload and may include virtual
|
|
162
|
+
* folder rows.
|
|
156
163
|
*/
|
|
164
|
+
listFileNames(apiUrl: string, authToken: string, request: ListFileNamesWithDelimiterRequest, options?: ListFileNamesOptions): Promise<ListFileNamesWithDelimiterResponse>;
|
|
157
165
|
listFileNames(apiUrl: string, authToken: string, request: ListFileNamesRequest, options?: ListFileNamesOptions): Promise<ListFileNamesResponse>;
|
|
166
|
+
listFileNames(apiUrl: string, authToken: string, request: ListFileNamesMaybeDelimiterRequest, options?: ListFileNamesOptions): Promise<ListFileNamesResponse | ListFileNamesWithDelimiterResponse>;
|
|
158
167
|
/**
|
|
159
168
|
* Calls {@link https://www.backblaze.com/apidocs/b2-list-file-versions | b2_list_file_versions}.
|
|
160
169
|
* @param apiUrl - The B2 API base URL.
|
|
@@ -163,8 +172,12 @@ export declare class RawClient {
|
|
|
163
172
|
* @param options - Optional request controls such as an abort signal.
|
|
164
173
|
*
|
|
165
174
|
* @returns The list of file versions and optional continuation token.
|
|
175
|
+
* Requests with `delimiter` use the delimiter overload and may include
|
|
176
|
+
* virtual folder rows.
|
|
166
177
|
*/
|
|
178
|
+
listFileVersions(apiUrl: string, authToken: string, request: ListFileVersionsWithDelimiterRequest, options?: ListFileVersionsOptions): Promise<ListFileVersionsWithDelimiterResponse>;
|
|
167
179
|
listFileVersions(apiUrl: string, authToken: string, request: ListFileVersionsRequest, options?: ListFileVersionsOptions): Promise<ListFileVersionsResponse>;
|
|
180
|
+
listFileVersions(apiUrl: string, authToken: string, request: ListFileVersionsMaybeDelimiterRequest, options?: ListFileVersionsOptions): Promise<ListFileVersionsResponse | ListFileVersionsWithDelimiterResponse>;
|
|
168
181
|
/**
|
|
169
182
|
* Calls {@link https://www.backblaze.com/apidocs/b2-get-file-info | b2_get_file_info}.
|
|
170
183
|
* @param apiUrl - The B2 API base URL.
|
|
@@ -434,28 +447,17 @@ export declare class RawClient {
|
|
|
434
447
|
* @param endpoint - The B2 API endpoint name.
|
|
435
448
|
* @param body - The JSON request body.
|
|
436
449
|
* @param options - Optional abort and per-request retry settings.
|
|
437
|
-
* @param urlOptions - B2 endpoint path prefix and version settings.
|
|
438
450
|
*
|
|
439
451
|
* @returns The parsed JSON response.
|
|
440
452
|
*/
|
|
441
453
|
private postJson;
|
|
442
454
|
}
|
|
443
455
|
/**
|
|
444
|
-
* SSE-C decryption parameters supplied to downloads of files
|
|
445
|
-
*
|
|
456
|
+
* SSE-C decryption parameters supplied to downloads of files uploaded with customer-managed keys.
|
|
457
|
+
* `customerKey` is secret key material sent as a request header; custom transports must redact
|
|
458
|
+
* request headers before logging them.
|
|
446
459
|
*/
|
|
447
|
-
export
|
|
448
|
-
/** Encryption algorithm. Always `EncryptionAlgorithm.Aes256` (`'AES256'`). */
|
|
449
|
-
readonly algorithm: EncryptionAlgorithm;
|
|
450
|
-
/**
|
|
451
|
-
* Base64-encoded customer-provided decryption key. This value must be sent as
|
|
452
|
-
* an HTTP request header for SSE-C downloads, so custom transports should not
|
|
453
|
-
* log request headers without redacting them first.
|
|
454
|
-
*/
|
|
455
|
-
readonly customerKey: string;
|
|
456
|
-
/** Base64-encoded MD5 digest of the decryption key. */
|
|
457
|
-
readonly customerKeyMd5: string;
|
|
458
|
-
}
|
|
460
|
+
export type SseCDownloadKey = SseCKeyMaterial;
|
|
459
461
|
/**
|
|
460
462
|
* Options accepted by {@link RawClient.downloadFileById} and
|
|
461
463
|
* {@link RawClient.downloadFileByName}. Mirrors the B2 native API: range +
|
package/dist/raw/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/raw/index.js"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/raw/index.js"],"names":[],"mappings":"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"}
|