@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/client.d.cts

@@ -5,10 +5,10 @@ import { HttpTransport } from './http/transport.js';
 import { UrlGuard } from './http/url-guard.js';
 import { RawClient } from './raw/index.js';
 import { AuthorizeAccountResponse, Capability } from './types/auth.js';
-import { BucketInfo, BucketType, CorsRule, LifecycleRule, BucketRetentionPolicy } from './types/bucket.js';
+import { BucketInfo, BucketRetentionPolicy, BucketType, CorsRule, LifecycleRule } from './types/bucket.js';
 import { EncryptionSetting } from './types/encryption.js';
 import { ApplicationKeyId, BucketId } from './types/ids.js';
-import { ApplicationKey, FullApplicationKey, ListKeysResponse } from './types/key.js';
+import { ApplicationKey, CreateKeyOptions, FullApplicationKey, ListKeysResponse } from './types/key.js';
 import { ReplicationConfiguration } from './types/replication.js';
 import { PaginatorOptions } from './util/paginator.js';
 /** Result of {@link B2Client.hasCapabilities}. */
@@ -24,13 +24,24 @@ export interface B2ClientOptions {
     readonly applicationKeyId: string;
     /** The application key secret. */
     readonly applicationKey: string;
-    /** B2 realm to authenticate against. Defaults to `"production"`. */
+    /**
+     * B2 realm to authenticate against. Accepts a known realm-map key
+     * (`"production"` or `"staging"`) or a direct base URL. Custom HTTPS hosts
+     * are trusted with the application key during authorize, so never derive
+     * `realm` from untrusted input. URL values must use HTTPS, or loopback IP
+     * literal HTTP for local testing only; application-key credentials are sent
+     * unencrypted over loopback HTTP. Unsupported schemes, malformed URLs,
+     * non-URL strings, plaintext HTTP hostnames such as `localhost`, and
+     * non-loopback plaintext HTTP are rejected before credentials are sent. URL
+     * values must not include userinfo, query strings, or fragments. Defaults to
+     * `"production"`.
+     */
     readonly realm?: string;
     /** Storage backend for authorization state. Defaults to {@link InMemoryAccountInfo}. */
     readonly accountInfo?: AccountInfo;
     /** Custom HTTP transport. Defaults to {@link FetchTransport}. Wrapped by {@link RetryTransport}. */
     readonly transport?: HttpTransport;
-    /** Override retry behavior (max retries, backoff, jitter). */
+    /** Override retry behavior (max retries, backoff, and per-attempt timeout). */
     readonly retry?: Partial<RetryOptions>;
     /** Custom user-agent string prepended to the SDK default. */
     readonly userAgent?: string;
@@ -46,6 +57,12 @@ export interface B2ClientOptions {
      * transport is the user's responsibility to harden.
      */
     readonly allowedHostSuffixes?: readonly string[];
+    /**
+     * Follow same-origin GET/HEAD redirects in the default fetch transport after
+     * checking each target with the SSRF guard. POST redirects remain blocked.
+     * Defaults to true.
+     */
+    readonly followSameOriginRedirects?: boolean;
 }
 /**
  * High-level B2 client providing ergonomic access to buckets, files, and keys.
@@ -75,6 +92,7 @@ export declare class B2Client {
     private readonly applicationKey;
     private readonly realmUrl;
     private readonly userAllowedSuffixes;
+    private readonly resolvedUploadRetryOptions;
     /**
      * Creates a new B2Client. Call {@link authorize} before making API requests.
      * @param options - Configuration including credentials, realm, and transport settings.
@@ -86,6 +104,7 @@ export declare class B2Client {
      * @returns The authorization response containing tokens, URLs, and capabilities.
      */
     authorize(): Promise<AuthorizeAccountResponse>;
+    private lockUrlGuard;
     /**
      * Refresh credentials after a 401. Returns the fresh auth token so
      * {@link RetryTransport} can rewrite the in-flight request's
@@ -101,7 +120,7 @@ export declare class B2Client {
      * @returns A {@link Bucket} handle for the newly created bucket.
      */
     createBucket(options: {
-        /** Globally unique bucket name (6-50 chars, letters, digits, hyphens). */
+        /** Globally unique bucket name (6-63 chars; letters, digits, hyphens, periods). */
         bucketName: string;
         /** Access level: `"allPrivate"` or `"allPublic"`. */
         bucketType: BucketType;
@@ -154,18 +173,7 @@ export declare class B2Client {
      *
      * @returns The full key including the secret (only returned at creation time).
      */
-    createKey(options: {
-        /** Capabilities to grant (e.g., `["readFiles", "writeFiles"]`). */
-        capabilities: Capability[];
-        /** Human-readable name for the key. */
-        keyName: string;
-        /** Key expiration in seconds from now. Omit for non-expiring keys. */
-        validDurationInSeconds?: number;
-        /** Restrict the key to a single bucket. */
-        bucketId?: BucketId;
-        /** Restrict the key to files with this name prefix. */
-        namePrefix?: string;
-    }): Promise<FullApplicationKey>;
+    createKey(options: CreateKeyOptions): Promise<FullApplicationKey>;
     /**
      * Lists application keys in the account.
      * @param options - Optional pagination settings.

package/dist/client.d.cts.map

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

package/dist/client.d.ts

@@ -5,10 +5,10 @@ import { HttpTransport } from './http/transport.js';
 import { UrlGuard } from './http/url-guard.js';
 import { RawClient } from './raw/index.js';
 import { AuthorizeAccountResponse, Capability } from './types/auth.js';
-import { BucketInfo, BucketType, CorsRule, LifecycleRule, BucketRetentionPolicy } from './types/bucket.js';
+import { BucketInfo, BucketRetentionPolicy, BucketType, CorsRule, LifecycleRule } from './types/bucket.js';
 import { EncryptionSetting } from './types/encryption.js';
 import { ApplicationKeyId, BucketId } from './types/ids.js';
-import { ApplicationKey, FullApplicationKey, ListKeysResponse } from './types/key.js';
+import { ApplicationKey, CreateKeyOptions, FullApplicationKey, ListKeysResponse } from './types/key.js';
 import { ReplicationConfiguration } from './types/replication.js';
 import { PaginatorOptions } from './util/paginator.js';
 /** Result of {@link B2Client.hasCapabilities}. */
@@ -24,13 +24,24 @@ export interface B2ClientOptions {
     readonly applicationKeyId: string;
     /** The application key secret. */
     readonly applicationKey: string;
-    /** B2 realm to authenticate against. Defaults to `"production"`. */
+    /**
+     * B2 realm to authenticate against. Accepts a known realm-map key
+     * (`"production"` or `"staging"`) or a direct base URL. Custom HTTPS hosts
+     * are trusted with the application key during authorize, so never derive
+     * `realm` from untrusted input. URL values must use HTTPS, or loopback IP
+     * literal HTTP for local testing only; application-key credentials are sent
+     * unencrypted over loopback HTTP. Unsupported schemes, malformed URLs,
+     * non-URL strings, plaintext HTTP hostnames such as `localhost`, and
+     * non-loopback plaintext HTTP are rejected before credentials are sent. URL
+     * values must not include userinfo, query strings, or fragments. Defaults to
+     * `"production"`.
+     */
     readonly realm?: string;
     /** Storage backend for authorization state. Defaults to {@link InMemoryAccountInfo}. */
     readonly accountInfo?: AccountInfo;
     /** Custom HTTP transport. Defaults to {@link FetchTransport}. Wrapped by {@link RetryTransport}. */
     readonly transport?: HttpTransport;
-    /** Override retry behavior (max retries, backoff, jitter). */
+    /** Override retry behavior (max retries, backoff, and per-attempt timeout). */
     readonly retry?: Partial<RetryOptions>;
     /** Custom user-agent string prepended to the SDK default. */
     readonly userAgent?: string;
@@ -46,6 +57,12 @@ export interface B2ClientOptions {
      * transport is the user's responsibility to harden.
      */
     readonly allowedHostSuffixes?: readonly string[];
+    /**
+     * Follow same-origin GET/HEAD redirects in the default fetch transport after
+     * checking each target with the SSRF guard. POST redirects remain blocked.
+     * Defaults to true.
+     */
+    readonly followSameOriginRedirects?: boolean;
 }
 /**
  * High-level B2 client providing ergonomic access to buckets, files, and keys.
@@ -75,6 +92,7 @@ export declare class B2Client {
     private readonly applicationKey;
     private readonly realmUrl;
     private readonly userAllowedSuffixes;
+    private readonly resolvedUploadRetryOptions;
     /**
      * Creates a new B2Client. Call {@link authorize} before making API requests.
      * @param options - Configuration including credentials, realm, and transport settings.
@@ -86,6 +104,7 @@ export declare class B2Client {
      * @returns The authorization response containing tokens, URLs, and capabilities.
      */
     authorize(): Promise<AuthorizeAccountResponse>;
+    private lockUrlGuard;
     /**
      * Refresh credentials after a 401. Returns the fresh auth token so
      * {@link RetryTransport} can rewrite the in-flight request's
@@ -101,7 +120,7 @@ export declare class B2Client {
      * @returns A {@link Bucket} handle for the newly created bucket.
      */
     createBucket(options: {
-        /** Globally unique bucket name (6-50 chars, letters, digits, hyphens). */
+        /** Globally unique bucket name (6-63 chars; letters, digits, hyphens, periods). */
         bucketName: string;
         /** Access level: `"allPrivate"` or `"allPublic"`. */
         bucketType: BucketType;
@@ -154,18 +173,7 @@ export declare class B2Client {
      *
      * @returns The full key including the secret (only returned at creation time).
      */
-    createKey(options: {
-        /** Capabilities to grant (e.g., `["readFiles", "writeFiles"]`). */
-        capabilities: Capability[];
-        /** Human-readable name for the key. */
-        keyName: string;
-        /** Key expiration in seconds from now. Omit for non-expiring keys. */
-        validDurationInSeconds?: number;
-        /** Restrict the key to a single bucket. */
-        bucketId?: BucketId;
-        /** Restrict the key to files with this name prefix. */
-        namePrefix?: string;
-    }): Promise<FullApplicationKey>;
+    createKey(options: CreateKeyOptions): Promise<FullApplicationKey>;
     /**
      * Lists application keys in the account.
      * @param options - Optional pagination settings.

package/dist/client.d.ts.map

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