@backblaze-labs/b2-sdk 0.1.0

package/dist/auth/in-memory.d.ts

@@ -0,0 +1,147 @@
+import { AuthorizeAccountResponse } from '../types/auth.js';
+import { BucketId } from '../types/ids.js';
+import { AccountInfo, UploadUrlEntry } from './account-info.js';
+/**
+ * In-memory implementation of {@link AccountInfo}.
+ * Stores the authorization response and upload URL pools in plain object fields.
+ * Suitable for short-lived processes or tests; state is lost when the process exits.
+ */
+export declare class InMemoryAccountInfo implements AccountInfo {
+    /** Cached authorization response, or null before authorize() is called. */
+    private auth;
+    /** Pool of reusable small-file upload URLs, keyed by bucket ID. */
+    private readonly uploadUrls;
+    /** Pool of reusable large-file part upload URLs, keyed by file ID. */
+    private readonly partUploadUrls;
+    /**
+     * Store a fresh authorization response, replacing any previous state.
+     *
+     * @param auth - The authorize account response to store.
+     */
+    setAuth(auth: AuthorizeAccountResponse): void;
+    /**
+     * Return the current authorization response, or null if not authorized.
+     *
+     * @returns The cached authorization response, or null if not yet authorized.
+     */
+    getAuth(): AuthorizeAccountResponse | null;
+    /** Discard all cached authorization state and upload URLs. */
+    clear(): void;
+    /**
+     * Base URL for B2 API calls.
+     *
+     * @returns The base URL for B2 API calls.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getApiUrl(): string;
+    /**
+     * Base URL for file downloads.
+     *
+     * @returns The base URL for file downloads.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getDownloadUrl(): string;
+    /**
+     * Current authorization token.
+     *
+     * @returns The current authorization token.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getAuthToken(): string;
+    /**
+     * The authorized account ID.
+     *
+     * @returns The authorized account identifier.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getAccountId(): string;
+    /**
+     * Server-recommended part size for large file uploads, in bytes.
+     *
+     * @returns The server-recommended part size in bytes.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getRecommendedPartSize(): number;
+    /**
+     * Smallest allowed part size for large file uploads, in bytes.
+     *
+     * @returns The smallest allowed part size in bytes.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getAbsoluteMinimumPartSize(): number;
+    /**
+     * Base URL for the S3-compatible API.
+     *
+     * @returns The base URL for the S3-compatible API.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getS3ApiUrl(): string;
+    /**
+     * Bucket ID the key is restricted to, or null if unrestricted.
+     *
+     * @returns The restricted bucket identifier, or null if the key is unrestricted.
+     *
+     * @throws Error if not yet authorized.
+     */
+    getAllowedBucketId(): BucketId | null;
+    /**
+     * Take an upload URL from the pool for the given bucket, or null if none available.
+     *
+     * @param bucketId - The bucket to check out an upload URL for.
+     *
+     * @returns A reusable upload URL entry, or null if none are available.
+     */
+    checkoutUploadUrl(bucketId: BucketId): UploadUrlEntry | null;
+    /**
+     * Return a still-valid upload URL to the pool for reuse.
+     *
+     * @param bucketId - The bucket the upload URL belongs to.
+     * @param entry - The upload URL entry to return to the pool.
+     */
+    returnUploadUrl(bucketId: BucketId, entry: UploadUrlEntry): void;
+    /**
+     * Remove an upload URL from the pool after an upload error.
+     *
+     * @param bucketId - The bucket the failed upload URL belongs to.
+     * @param entry - The upload URL entry to remove from the pool.
+     */
+    evictUploadUrl(bucketId: BucketId, entry: UploadUrlEntry): void;
+    /**
+     * Take a large-file part upload URL from the pool, or null if none available.
+     *
+     * @param fileId - The large file to check out a part upload URL for.
+     *
+     * @returns A reusable part upload URL entry, or null if none are available.
+     */
+    checkoutPartUploadUrl(fileId: string): UploadUrlEntry | null;
+    /**
+     * Return a still-valid part upload URL to the pool for reuse.
+     *
+     * @param fileId - The large file the part upload URL belongs to.
+     * @param entry - The part upload URL entry to return to the pool.
+     */
+    returnPartUploadUrl(fileId: string, entry: UploadUrlEntry): void;
+    /**
+     * Remove a part upload URL from the pool after an error.
+     *
+     * @param fileId - The large file the failed part upload URL belongs to.
+     * @param entry - The part upload URL entry to remove from the pool.
+     */
+    evictPartUploadUrl(fileId: string, entry: UploadUrlEntry): void;
+    /**
+     * Retrieve the cached auth response or throw if not yet authorized.
+     *
+     * @returns The cached authorization response.
+     *
+     * @throws Error if authorize() has not been called.
+     */
+    private requireAuth;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/auth/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/auth/in-memory.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGpE;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,2EAA2E;IAC3E,OAAO,CAAC,IAAI,CAAwC;IACpD,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI;IAM7C;;;;OAIG;IACH,OAAO,IAAI,wBAAwB,GAAG,IAAI;IAI1C,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAMb;;;;;;OAMG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;;OAMG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;OAMG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,sBAAsB,IAAI,MAAM;IAIhC;;;;;;OAMG;IACH,0BAA0B,IAAI,MAAM;IAIpC;;;;;;OAMG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;;OAMG;IACH,kBAAkB,IAAI,QAAQ,GAAG,IAAI;IAIrC;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI;IAI5D;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAIhE;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAI/D;;;;;;OAMG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAI5D;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAIhE;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAI/D;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAIpB"}

package/dist/auth/in-memory.js

@@ -0,0 +1,184 @@
+import { UploadUrlPool } from "./upload-url-pool.js";
+class InMemoryAccountInfo {
+  /** Cached authorization response, or null before authorize() is called. */
+  auth = null;
+  /** Pool of reusable small-file upload URLs, keyed by bucket ID. */
+  uploadUrls = new UploadUrlPool();
+  /** Pool of reusable large-file part upload URLs, keyed by file ID. */
+  partUploadUrls = new UploadUrlPool();
+  /**
+   * Store a fresh authorization response, replacing any previous state.
+   *
+   * @param auth - The authorize account response to store.
+   */
+  setAuth(auth) {
+    this.auth = auth;
+    this.uploadUrls.clear();
+    this.partUploadUrls.clear();
+  }
+  /**
+   * Return the current authorization response, or null if not authorized.
+   *
+   * @returns The cached authorization response, or null if not yet authorized.
+   */
+  getAuth() {
+    return this.auth;
+  }
+  /** Discard all cached authorization state and upload URLs. */
+  clear() {
+    this.auth = null;
+    this.uploadUrls.clear();
+    this.partUploadUrls.clear();
+  }
+  /**
+   * Base URL for B2 API calls.
+   *
+   * @returns The base URL for B2 API calls.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getApiUrl() {
+    return this.requireAuth().apiInfo.storageApi.apiUrl;
+  }
+  /**
+   * Base URL for file downloads.
+   *
+   * @returns The base URL for file downloads.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getDownloadUrl() {
+    return this.requireAuth().apiInfo.storageApi.downloadUrl;
+  }
+  /**
+   * Current authorization token.
+   *
+   * @returns The current authorization token.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getAuthToken() {
+    return this.requireAuth().authorizationToken;
+  }
+  /**
+   * The authorized account ID.
+   *
+   * @returns The authorized account identifier.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getAccountId() {
+    return this.requireAuth().accountId;
+  }
+  /**
+   * Server-recommended part size for large file uploads, in bytes.
+   *
+   * @returns The server-recommended part size in bytes.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getRecommendedPartSize() {
+    return this.requireAuth().apiInfo.storageApi.recommendedPartSize;
+  }
+  /**
+   * Smallest allowed part size for large file uploads, in bytes.
+   *
+   * @returns The smallest allowed part size in bytes.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getAbsoluteMinimumPartSize() {
+    return this.requireAuth().apiInfo.storageApi.absoluteMinimumPartSize;
+  }
+  /**
+   * Base URL for the S3-compatible API.
+   *
+   * @returns The base URL for the S3-compatible API.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getS3ApiUrl() {
+    return this.requireAuth().apiInfo.storageApi.s3ApiUrl;
+  }
+  /**
+   * Bucket ID the key is restricted to, or null if unrestricted.
+   *
+   * @returns The restricted bucket identifier, or null if the key is unrestricted.
+   *
+   * @throws Error if not yet authorized.
+   */
+  getAllowedBucketId() {
+    return this.requireAuth().apiInfo.storageApi.allowed.bucketId ?? null;
+  }
+  /**
+   * Take an upload URL from the pool for the given bucket, or null if none available.
+   *
+   * @param bucketId - The bucket to check out an upload URL for.
+   *
+   * @returns A reusable upload URL entry, or null if none are available.
+   */
+  checkoutUploadUrl(bucketId) {
+    return this.uploadUrls.checkout(bucketId);
+  }
+  /**
+   * Return a still-valid upload URL to the pool for reuse.
+   *
+   * @param bucketId - The bucket the upload URL belongs to.
+   * @param entry - The upload URL entry to return to the pool.
+   */
+  returnUploadUrl(bucketId, entry) {
+    this.uploadUrls.checkin(bucketId, entry);
+  }
+  /**
+   * Remove an upload URL from the pool after an upload error.
+   *
+   * @param bucketId - The bucket the failed upload URL belongs to.
+   * @param entry - The upload URL entry to remove from the pool.
+   */
+  evictUploadUrl(bucketId, entry) {
+    this.uploadUrls.evict(bucketId, entry);
+  }
+  /**
+   * Take a large-file part upload URL from the pool, or null if none available.
+   *
+   * @param fileId - The large file to check out a part upload URL for.
+   *
+   * @returns A reusable part upload URL entry, or null if none are available.
+   */
+  checkoutPartUploadUrl(fileId) {
+    return this.partUploadUrls.checkout(fileId);
+  }
+  /**
+   * Return a still-valid part upload URL to the pool for reuse.
+   *
+   * @param fileId - The large file the part upload URL belongs to.
+   * @param entry - The part upload URL entry to return to the pool.
+   */
+  returnPartUploadUrl(fileId, entry) {
+    this.partUploadUrls.checkin(fileId, entry);
+  }
+  /**
+   * Remove a part upload URL from the pool after an error.
+   *
+   * @param fileId - The large file the failed part upload URL belongs to.
+   * @param entry - The part upload URL entry to remove from the pool.
+   */
+  evictPartUploadUrl(fileId, entry) {
+    this.partUploadUrls.evict(fileId, entry);
+  }
+  /**
+   * Retrieve the cached auth response or throw if not yet authorized.
+   *
+   * @returns The cached authorization response.
+   *
+   * @throws Error if authorize() has not been called.
+   */
+  requireAuth() {
+    if (!this.auth) throw new Error("Not authorized. Call authorize() first.");
+    return this.auth;
+  }
+}
+export {
+  InMemoryAccountInfo
+};
+//# sourceMappingURL=in-memory.js.map

package/dist/auth/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sources":["../../src/auth/in-memory.ts"],"sourcesContent":["import type { AuthorizeAccountResponse } from '../types/auth.ts'\nimport type { BucketId } from '../types/ids.ts'\nimport type { AccountInfo, UploadUrlEntry } from './account-info.ts'\nimport { UploadUrlPool } from './upload-url-pool.ts'\n\n/**\n * In-memory implementation of {@link AccountInfo}.\n * Stores the authorization response and upload URL pools in plain object fields.\n * Suitable for short-lived processes or tests; state is lost when the process exits.\n */\nexport class InMemoryAccountInfo implements AccountInfo {\n  /** Cached authorization response, or null before authorize() is called. */\n  private auth: AuthorizeAccountResponse | null = null\n  /** Pool of reusable small-file upload URLs, keyed by bucket ID. */\n  private readonly uploadUrls = new UploadUrlPool()\n  /** Pool of reusable large-file part upload URLs, keyed by file ID. */\n  private readonly partUploadUrls = new UploadUrlPool()\n\n  /**\n   * Store a fresh authorization response, replacing any previous state.\n   *\n   * @param auth - The authorize account response to store.\n   */\n  setAuth(auth: AuthorizeAccountResponse): void {\n    this.auth = auth\n    this.uploadUrls.clear()\n    this.partUploadUrls.clear()\n  }\n\n  /**\n   * Return the current authorization response, or null if not authorized.\n   *\n   * @returns The cached authorization response, or null if not yet authorized.\n   */\n  getAuth(): AuthorizeAccountResponse | null {\n    return this.auth\n  }\n\n  /** Discard all cached authorization state and upload URLs. */\n  clear(): void {\n    this.auth = null\n    this.uploadUrls.clear()\n    this.partUploadUrls.clear()\n  }\n\n  /**\n   * Base URL for B2 API calls.\n   *\n   * @returns The base URL for B2 API calls.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getApiUrl(): string {\n    return this.requireAuth().apiInfo.storageApi.apiUrl\n  }\n\n  /**\n   * Base URL for file downloads.\n   *\n   * @returns The base URL for file downloads.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getDownloadUrl(): string {\n    return this.requireAuth().apiInfo.storageApi.downloadUrl\n  }\n\n  /**\n   * Current authorization token.\n   *\n   * @returns The current authorization token.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getAuthToken(): string {\n    return this.requireAuth().authorizationToken as string\n  }\n\n  /**\n   * The authorized account ID.\n   *\n   * @returns The authorized account identifier.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getAccountId(): string {\n    return this.requireAuth().accountId as string\n  }\n\n  /**\n   * Server-recommended part size for large file uploads, in bytes.\n   *\n   * @returns The server-recommended part size in bytes.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getRecommendedPartSize(): number {\n    return this.requireAuth().apiInfo.storageApi.recommendedPartSize\n  }\n\n  /**\n   * Smallest allowed part size for large file uploads, in bytes.\n   *\n   * @returns The smallest allowed part size in bytes.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getAbsoluteMinimumPartSize(): number {\n    return this.requireAuth().apiInfo.storageApi.absoluteMinimumPartSize\n  }\n\n  /**\n   * Base URL for the S3-compatible API.\n   *\n   * @returns The base URL for the S3-compatible API.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getS3ApiUrl(): string {\n    return this.requireAuth().apiInfo.storageApi.s3ApiUrl\n  }\n\n  /**\n   * Bucket ID the key is restricted to, or null if unrestricted.\n   *\n   * @returns The restricted bucket identifier, or null if the key is unrestricted.\n   *\n   * @throws Error if not yet authorized.\n   */\n  getAllowedBucketId(): BucketId | null {\n    return this.requireAuth().apiInfo.storageApi.allowed.bucketId ?? null\n  }\n\n  /**\n   * Take an upload URL from the pool for the given bucket, or null if none available.\n   *\n   * @param bucketId - The bucket to check out an upload URL for.\n   *\n   * @returns A reusable upload URL entry, or null if none are available.\n   */\n  checkoutUploadUrl(bucketId: BucketId): UploadUrlEntry | null {\n    return this.uploadUrls.checkout(bucketId as string)\n  }\n\n  /**\n   * Return a still-valid upload URL to the pool for reuse.\n   *\n   * @param bucketId - The bucket the upload URL belongs to.\n   * @param entry - The upload URL entry to return to the pool.\n   */\n  returnUploadUrl(bucketId: BucketId, entry: UploadUrlEntry): void {\n    this.uploadUrls.checkin(bucketId as string, entry)\n  }\n\n  /**\n   * Remove an upload URL from the pool after an upload error.\n   *\n   * @param bucketId - The bucket the failed upload URL belongs to.\n   * @param entry - The upload URL entry to remove from the pool.\n   */\n  evictUploadUrl(bucketId: BucketId, entry: UploadUrlEntry): void {\n    this.uploadUrls.evict(bucketId as string, entry)\n  }\n\n  /**\n   * Take a large-file part upload URL from the pool, or null if none available.\n   *\n   * @param fileId - The large file to check out a part upload URL for.\n   *\n   * @returns A reusable part upload URL entry, or null if none are available.\n   */\n  checkoutPartUploadUrl(fileId: string): UploadUrlEntry | null {\n    return this.partUploadUrls.checkout(fileId)\n  }\n\n  /**\n   * Return a still-valid part upload URL to the pool for reuse.\n   *\n   * @param fileId - The large file the part upload URL belongs to.\n   * @param entry - The part upload URL entry to return to the pool.\n   */\n  returnPartUploadUrl(fileId: string, entry: UploadUrlEntry): void {\n    this.partUploadUrls.checkin(fileId, entry)\n  }\n\n  /**\n   * Remove a part upload URL from the pool after an error.\n   *\n   * @param fileId - The large file the failed part upload URL belongs to.\n   * @param entry - The part upload URL entry to remove from the pool.\n   */\n  evictPartUploadUrl(fileId: string, entry: UploadUrlEntry): void {\n    this.partUploadUrls.evict(fileId, entry)\n  }\n\n  /**\n   * Retrieve the cached auth response or throw if not yet authorized.\n   *\n   * @returns The cached authorization response.\n   *\n   * @throws Error if authorize() has not been called.\n   */\n  private requireAuth(): AuthorizeAccountResponse {\n    if (!this.auth) throw new Error('Not authorized. Call authorize() first.')\n    return this.auth\n  }\n}\n"],"names":[],"mappings":";AAUO,MAAM,oBAA2C;AAAA;AAAA,EAE9C,OAAwC;AAAA;AAAA,EAE/B,aAAa,IAAI,cAAA;AAAA;AAAA,EAEjB,iBAAiB,IAAI,cAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOtC,QAAQ,MAAsC;AAC5C,SAAK,OAAO;AACZ,SAAK,WAAW,MAAA;AAChB,SAAK,eAAe,MAAA;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAA2C;AACzC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,OAAO;AACZ,SAAK,WAAW,MAAA;AAChB,SAAK,eAAe,MAAA;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAoB;AAClB,WAAO,KAAK,YAAA,EAAc,QAAQ,WAAW;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,iBAAyB;AACvB,WAAO,KAAK,YAAA,EAAc,QAAQ,WAAW;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,eAAuB;AACrB,WAAO,KAAK,cAAc;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,eAAuB;AACrB,WAAO,KAAK,cAAc;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,yBAAiC;AAC/B,WAAO,KAAK,YAAA,EAAc,QAAQ,WAAW;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,6BAAqC;AACnC,WAAO,KAAK,YAAA,EAAc,QAAQ,WAAW;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,cAAsB;AACpB,WAAO,KAAK,YAAA,EAAc,QAAQ,WAAW;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,qBAAsC;AACpC,WAAO,KAAK,cAAc,QAAQ,WAAW,QAAQ,YAAY;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,kBAAkB,UAA2C;AAC3D,WAAO,KAAK,WAAW,SAAS,QAAkB;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,gBAAgB,UAAoB,OAA6B;AAC/D,SAAK,WAAW,QAAQ,UAAoB,KAAK;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAe,UAAoB,OAA6B;AAC9D,SAAK,WAAW,MAAM,UAAoB,KAAK;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,sBAAsB,QAAuC;AAC3D,WAAO,KAAK,eAAe,SAAS,MAAM;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,QAAgB,OAA6B;AAC/D,SAAK,eAAe,QAAQ,QAAQ,KAAK;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,mBAAmB,QAAgB,OAA6B;AAC9D,SAAK,eAAe,MAAM,QAAQ,KAAK;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,cAAwC;AAC9C,QAAI,CAAC,KAAK,KAAM,OAAM,IAAI,MAAM,yCAAyC;AACzE,WAAO,KAAK;AAAA,EACd;AACF;"}

package/dist/auth/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const inMemory = require("./in-memory.cjs");
+const uploadUrlPool = require("./upload-url-pool.cjs");
+const realms = require("./realms.cjs");
+exports.InMemoryAccountInfo = inMemory.InMemoryAccountInfo;
+exports.UploadUrlPool = uploadUrlPool.UploadUrlPool;
+exports.REALM_URLS = realms.REALM_URLS;
+exports.getRealmUrl = realms.getRealmUrl;
+//# sourceMappingURL=index.cjs.map

package/dist/auth/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/auth/index.d.cts

@@ -0,0 +1,6 @@
+/** @packageDocumentation */
+export type { AccountInfo, UploadUrlEntry } from './account-info.js';
+export { InMemoryAccountInfo } from './in-memory.js';
+export { UploadUrlPool } from './upload-url-pool.js';
+export { getRealmUrl, REALM_URLS } from './realms.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.js"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

package/dist/auth/index.d.ts

@@ -0,0 +1,6 @@
+/** @packageDocumentation */
+export type { AccountInfo, UploadUrlEntry } from './account-info.js';
+export { InMemoryAccountInfo } from './in-memory.js';
+export { UploadUrlPool } from './upload-url-pool.js';
+export { getRealmUrl, REALM_URLS } from './realms.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.js"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

package/dist/auth/index.js

@@ -0,0 +1,10 @@
+import { InMemoryAccountInfo } from "./in-memory.js";
+import { UploadUrlPool } from "./upload-url-pool.js";
+import { REALM_URLS, getRealmUrl } from "./realms.js";
+export {
+  InMemoryAccountInfo,
+  REALM_URLS,
+  UploadUrlPool,
+  getRealmUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/auth/realms.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const REALM_URLS = {
+  production: "https://api.backblazeb2.com",
+  staging: "https://api.backblazeb2.com"
+};
+function getRealmUrl(realm) {
+  return REALM_URLS[realm] ?? realm;
+}
+exports.REALM_URLS = REALM_URLS;
+exports.getRealmUrl = getRealmUrl;
+//# sourceMappingURL=realms.cjs.map

package/dist/auth/realms.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"realms.cjs","sources":["../../src/auth/realms.ts"],"sourcesContent":["/** Map of known realm names to their base API URLs. */\nexport const REALM_URLS: Record<string, string> = {\n  production: 'https://api.backblazeb2.com',\n  staging: 'https://api.backblazeb2.com',\n}\n\n/**\n * Resolve a realm name to its base API URL.\n * If the realm is not a known name, it is returned as-is (assumed to be a URL).\n *\n * @param realm - The realm name or direct URL to resolve.\n *\n * @returns The base API URL for the given realm.\n */\nexport function getRealmUrl(realm: string): string {\n  return REALM_URLS[realm] ?? realm\n}\n"],"names":[],"mappings":";;AACO,MAAM,aAAqC;AAAA,EAChD,YAAY;AAAA,EACZ,SAAS;AACX;AAUO,SAAS,YAAY,OAAuB;AACjD,SAAO,WAAW,KAAK,KAAK;AAC9B;;;"}

package/dist/auth/realms.d.cts

@@ -0,0 +1,12 @@
+/** Map of known realm names to their base API URLs. */
+export declare const REALM_URLS: Record<string, string>;
+/**
+ * Resolve a realm name to its base API URL.
+ * If the realm is not a known name, it is returned as-is (assumed to be a URL).
+ *
+ * @param realm - The realm name or direct URL to resolve.
+ *
+ * @returns The base API URL for the given realm.
+ */
+export declare function getRealmUrl(realm: string): string;
+//# sourceMappingURL=realms.d.ts.map

package/dist/auth/realms.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realms.d.ts","sourceRoot":"","sources":["../../src/auth/realms.js"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG7C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/auth/realms.d.ts

@@ -0,0 +1,12 @@
+/** Map of known realm names to their base API URLs. */
+export declare const REALM_URLS: Record<string, string>;
+/**
+ * Resolve a realm name to its base API URL.
+ * If the realm is not a known name, it is returned as-is (assumed to be a URL).
+ *
+ * @param realm - The realm name or direct URL to resolve.
+ *
+ * @returns The base API URL for the given realm.
+ */
+export declare function getRealmUrl(realm: string): string;
+//# sourceMappingURL=realms.d.ts.map

package/dist/auth/realms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realms.d.ts","sourceRoot":"","sources":["../../src/auth/realms.js"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG7C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/auth/realms.js

@@ -0,0 +1,12 @@
+const REALM_URLS = {
+  production: "https://api.backblazeb2.com",
+  staging: "https://api.backblazeb2.com"
+};
+function getRealmUrl(realm) {
+  return REALM_URLS[realm] ?? realm;
+}
+export {
+  REALM_URLS,
+  getRealmUrl
+};
+//# sourceMappingURL=realms.js.map

package/dist/auth/realms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realms.js","sources":["../../src/auth/realms.ts"],"sourcesContent":["/** Map of known realm names to their base API URLs. */\nexport const REALM_URLS: Record<string, string> = {\n  production: 'https://api.backblazeb2.com',\n  staging: 'https://api.backblazeb2.com',\n}\n\n/**\n * Resolve a realm name to its base API URL.\n * If the realm is not a known name, it is returned as-is (assumed to be a URL).\n *\n * @param realm - The realm name or direct URL to resolve.\n *\n * @returns The base API URL for the given realm.\n */\nexport function getRealmUrl(realm: string): string {\n  return REALM_URLS[realm] ?? realm\n}\n"],"names":[],"mappings":"AACO,MAAM,aAAqC;AAAA,EAChD,YAAY;AAAA,EACZ,SAAS;AACX;AAUO,SAAS,YAAY,OAAuB;AACjD,SAAO,WAAW,KAAK,KAAK;AAC9B;"}

package/dist/auth/upload-url-pool.cjs

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class UploadUrlPool {
+  /** Map from key (bucket ID or file ID) to a stack of available entries. */
+  pools = /* @__PURE__ */ new Map();
+  /**
+   * Take an upload URL from the pool, or return null if none are available.
+   *
+   * @param key - The bucket ID or file ID to look up.
+   *
+   * @returns An upload URL entry, or null if the pool is empty for the given key.
+   */
+  checkout(key) {
+    const pool = this.pools.get(key);
+    if (!pool || pool.length === 0) return null;
+    return pool.pop() ?? null;
+  }
+  /**
+   * Return a still-valid upload URL to the pool for future reuse.
+   *
+   * @param key - The bucket ID or file ID the entry belongs to.
+   * @param entry - The upload URL entry to return to the pool.
+   */
+  checkin(key, entry) {
+    let pool = this.pools.get(key);
+    if (!pool) {
+      pool = [];
+      this.pools.set(key, pool);
+    }
+    pool.push(entry);
+  }
+  /**
+   * Remove a specific upload URL from the pool (e.g. after an upload error).
+   *
+   * @param key - The bucket ID or file ID the entry belongs to.
+   * @param entry - The failed upload URL entry to remove.
+   */
+  evict(key, entry) {
+    const pool = this.pools.get(key);
+    if (!pool) return;
+    const idx = pool.findIndex((e) => e.uploadUrl === entry.uploadUrl);
+    if (idx !== -1) {
+      pool.splice(idx, 1);
+    }
+  }
+  /** Remove all entries from every key in the pool. */
+  clear() {
+    this.pools.clear();
+  }
+}
+exports.UploadUrlPool = UploadUrlPool;
+//# sourceMappingURL=upload-url-pool.cjs.map

package/dist/auth/upload-url-pool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-url-pool.cjs","sources":["../../src/auth/upload-url-pool.ts"],"sourcesContent":["import type { UploadUrlEntry } from './account-info.ts'\n\n/**\n * Manages a pool of reusable upload URLs keyed by bucket ID or file ID.\n * URLs are checked out before an upload, checked back in on success, and\n * evicted on error so they are not reused.\n */\nexport class UploadUrlPool {\n  /** Map from key (bucket ID or file ID) to a stack of available entries. */\n  private readonly pools = new Map<string, UploadUrlEntry[]>()\n\n  /**\n   * Take an upload URL from the pool, or return null if none are available.\n   *\n   * @param key - The bucket ID or file ID to look up.\n   *\n   * @returns An upload URL entry, or null if the pool is empty for the given key.\n   */\n  checkout(key: string): UploadUrlEntry | null {\n    const pool = this.pools.get(key)\n    if (!pool || pool.length === 0) return null\n    return pool.pop() ?? null\n  }\n\n  /**\n   * Return a still-valid upload URL to the pool for future reuse.\n   *\n   * @param key - The bucket ID or file ID the entry belongs to.\n   * @param entry - The upload URL entry to return to the pool.\n   */\n  checkin(key: string, entry: UploadUrlEntry): void {\n    let pool = this.pools.get(key)\n    if (!pool) {\n      pool = []\n      this.pools.set(key, pool)\n    }\n    pool.push(entry)\n  }\n\n  /**\n   * Remove a specific upload URL from the pool (e.g. after an upload error).\n   *\n   * @param key - The bucket ID or file ID the entry belongs to.\n   * @param entry - The failed upload URL entry to remove.\n   */\n  evict(key: string, entry: UploadUrlEntry): void {\n    const pool = this.pools.get(key)\n    if (!pool) return\n    const idx = pool.findIndex((e) => e.uploadUrl === entry.uploadUrl)\n    if (idx !== -1) {\n      pool.splice(idx, 1)\n    }\n  }\n\n  /** Remove all entries from every key in the pool. */\n  clear(): void {\n    this.pools.clear()\n  }\n}\n"],"names":[],"mappings":";;AAOO,MAAM,cAAc;AAAA;AAAA,EAER,4BAAY,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS7B,SAAS,KAAoC;AAC3C,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAC/B,QAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AACvC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAQ,KAAa,OAA6B;AAChD,QAAI,OAAO,KAAK,MAAM,IAAI,GAAG;AAC7B,QAAI,CAAC,MAAM;AACT,aAAO,CAAA;AACP,WAAK,MAAM,IAAI,KAAK,IAAI;AAAA,IAC1B;AACA,SAAK,KAAK,KAAK;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,KAAa,OAA6B;AAC9C,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAC/B,QAAI,CAAC,KAAM;AACX,UAAM,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,cAAc,MAAM,SAAS;AACjE,QAAI,QAAQ,IAAI;AACd,WAAK,OAAO,KAAK,CAAC;AAAA,IACpB;AAAA,EACF;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,MAAM,MAAA;AAAA,EACb;AACF;;"}

package/dist/auth/upload-url-pool.d.cts

@@ -0,0 +1,35 @@
+import { UploadUrlEntry } from './account-info.js';
+/**
+ * Manages a pool of reusable upload URLs keyed by bucket ID or file ID.
+ * URLs are checked out before an upload, checked back in on success, and
+ * evicted on error so they are not reused.
+ */
+export declare class UploadUrlPool {
+    /** Map from key (bucket ID or file ID) to a stack of available entries. */
+    private readonly pools;
+    /**
+     * Take an upload URL from the pool, or return null if none are available.
+     *
+     * @param key - The bucket ID or file ID to look up.
+     *
+     * @returns An upload URL entry, or null if the pool is empty for the given key.
+     */
+    checkout(key: string): UploadUrlEntry | null;
+    /**
+     * Return a still-valid upload URL to the pool for future reuse.
+     *
+     * @param key - The bucket ID or file ID the entry belongs to.
+     * @param entry - The upload URL entry to return to the pool.
+     */
+    checkin(key: string, entry: UploadUrlEntry): void;
+    /**
+     * Remove a specific upload URL from the pool (e.g. after an upload error).
+     *
+     * @param key - The bucket ID or file ID the entry belongs to.
+     * @param entry - The failed upload URL entry to remove.
+     */
+    evict(key: string, entry: UploadUrlEntry): void;
+    /** Remove all entries from every key in the pool. */
+    clear(): void;
+}
+//# sourceMappingURL=upload-url-pool.d.ts.map

package/dist/auth/upload-url-pool.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-url-pool.d.ts","sourceRoot":"","sources":["../../src/auth/upload-url-pool.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAM5C;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IASjD;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAS/C,qDAAqD;IACrD,KAAK,IAAI,IAAI;CAGd"}

package/dist/auth/upload-url-pool.d.ts

@@ -0,0 +1,35 @@
+import { UploadUrlEntry } from './account-info.js';
+/**
+ * Manages a pool of reusable upload URLs keyed by bucket ID or file ID.
+ * URLs are checked out before an upload, checked back in on success, and
+ * evicted on error so they are not reused.
+ */
+export declare class UploadUrlPool {
+    /** Map from key (bucket ID or file ID) to a stack of available entries. */
+    private readonly pools;
+    /**
+     * Take an upload URL from the pool, or return null if none are available.
+     *
+     * @param key - The bucket ID or file ID to look up.
+     *
+     * @returns An upload URL entry, or null if the pool is empty for the given key.
+     */
+    checkout(key: string): UploadUrlEntry | null;
+    /**
+     * Return a still-valid upload URL to the pool for future reuse.
+     *
+     * @param key - The bucket ID or file ID the entry belongs to.
+     * @param entry - The upload URL entry to return to the pool.
+     */
+    checkin(key: string, entry: UploadUrlEntry): void;
+    /**
+     * Remove a specific upload URL from the pool (e.g. after an upload error).
+     *
+     * @param key - The bucket ID or file ID the entry belongs to.
+     * @param entry - The failed upload URL entry to remove.
+     */
+    evict(key: string, entry: UploadUrlEntry): void;
+    /** Remove all entries from every key in the pool. */
+    clear(): void;
+}
+//# sourceMappingURL=upload-url-pool.d.ts.map

package/dist/auth/upload-url-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-url-pool.d.ts","sourceRoot":"","sources":["../../src/auth/upload-url-pool.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAM5C;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IASjD;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAS/C,qDAAqD;IACrD,KAAK,IAAI,IAAI;CAGd"}