@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/auth/realms.d.cts

@@ -1,12 +1,35 @@
-/** Map of known realm names to their base API URLs. */
+/** Name of a verified built-in auth realm alias. */
+export type RealmName = 'production' | 'staging';
+/**
+ * Built-in realm aliases to their `b2_authorize_account` base API URLs.
+ * The object remains a mutable `Record<string, string>` for source
+ * compatibility with earlier SDK versions that let applications add local
+ * aliases. SDK internals validate only the built-in aliases in
+ * `VERIFIED_REALM_URLS`; pass direct custom realm URLs to `B2Client` instead
+ * of relying on mutation for new code.
+ */
 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).
+ * Validate a realm URL before it is used for credential-bearing authorization.
+ * Any accepted custom HTTPS host receives the application key during authorize;
+ * do not derive custom realm URLs from untrusted input. Realm URLs must be base
+ * URLs without userinfo, query strings, or fragments.
+ *
+ * @param realmUrl - The resolved realm URL to validate.
+ *
+ * @throws B2RealmConfigurationError when the realm URL is not absolute, is not
+ * a base URL, uses an unsupported scheme, or uses non-loopback plaintext HTTP.
+ * Loopback IP HTTP is accepted only for local testing and sends the application
+ * key unencrypted to whichever process is listening on that address and port.
+ */
+export declare function assertSecureRealmUrl(realmUrl: string): void;
+/**
+ * Resolve a realm name to its base API URL. Unknown strings are returned
+ * unchanged so callers can resolve custom aliases before authorization.
  *
  * @param realm - The realm name or direct URL to resolve.
  *
- * @returns The base API URL for the given realm.
+ * @returns The mapped base API URL for a known realm, otherwise `realm`.
  */
 export declare function getRealmUrl(realm: string): string;
 //# sourceMappingURL=realms.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"realms.d.ts","sourceRoot":"","sources":["../../src/auth/realms.js"],"names":[],"mappings":"AAGA,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAShD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA8B,CAAA;AA4D5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU3D;AAMD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/auth/realms.d.ts

@@ -1,12 +1,35 @@
-/** Map of known realm names to their base API URLs. */
+/** Name of a verified built-in auth realm alias. */
+export type RealmName = 'production' | 'staging';
+/**
+ * Built-in realm aliases to their `b2_authorize_account` base API URLs.
+ * The object remains a mutable `Record<string, string>` for source
+ * compatibility with earlier SDK versions that let applications add local
+ * aliases. SDK internals validate only the built-in aliases in
+ * `VERIFIED_REALM_URLS`; pass direct custom realm URLs to `B2Client` instead
+ * of relying on mutation for new code.
+ */
 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).
+ * Validate a realm URL before it is used for credential-bearing authorization.
+ * Any accepted custom HTTPS host receives the application key during authorize;
+ * do not derive custom realm URLs from untrusted input. Realm URLs must be base
+ * URLs without userinfo, query strings, or fragments.
+ *
+ * @param realmUrl - The resolved realm URL to validate.
+ *
+ * @throws B2RealmConfigurationError when the realm URL is not absolute, is not
+ * a base URL, uses an unsupported scheme, or uses non-loopback plaintext HTTP.
+ * Loopback IP HTTP is accepted only for local testing and sends the application
+ * key unencrypted to whichever process is listening on that address and port.
+ */
+export declare function assertSecureRealmUrl(realmUrl: string): void;
+/**
+ * Resolve a realm name to its base API URL. Unknown strings are returned
+ * unchanged so callers can resolve custom aliases before authorization.
  *
  * @param realm - The realm name or direct URL to resolve.
  *
- * @returns The base API URL for the given realm.
+ * @returns The mapped base API URL for a known realm, otherwise `realm`.
  */
 export declare function getRealmUrl(realm: string): string;
 //# sourceMappingURL=realms.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"realms.d.ts","sourceRoot":"","sources":["../../src/auth/realms.js"],"names":[],"mappings":"AAGA,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAShD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA8B,CAAA;AA4D5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU3D;AAMD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/auth/realms.js

@@ -1,12 +1,83 @@
-const REALM_URLS = {
-  production: "https://api.backblazeb2.com",
-  staging: "https://api.backblazeb2.com"
+import { redactUrlForError } from "../internal/url-redaction.js";
+import { B2RealmConfigurationError } from "../errors/index.js";
+//#region src/auth/realms.ts
+var VERIFIED_REALM_URLS = {
+	/** Public production B2 Native API authorize endpoint. */
+	production: "https://api.backblazeb2.com",
+	/** Backblaze staging authorize endpoint from the official Python SDK realm map. */
+	staging: "https://api.backblaze.net"
 };
+/**
+* Built-in realm aliases to their `b2_authorize_account` base API URLs.
+* The object remains a mutable `Record<string, string>` for source
+* compatibility with earlier SDK versions that let applications add local
+* aliases. SDK internals validate only the built-in aliases in
+* `VERIFIED_REALM_URLS`; pass direct custom realm URLs to `B2Client` instead
+* of relying on mutation for new code.
+*/
+var REALM_URLS = { ...VERIFIED_REALM_URLS };
+var HTTP_REALM_URL_WITH_HOST = /^https?:\/\/[^/?#]/i;
+function parseAbsoluteRealmUrl(realmUrl) {
+	try {
+		return new URL(realmUrl);
+	} catch {
+		return null;
+	}
+}
+function realmUrlForError(realmUrl, url = parseAbsoluteRealmUrl(realmUrl)) {
+	return redactUrlForError(url ?? realmUrl, { invalidUrlLabel: "<invalid realm URL>" });
+}
+function isLoopbackHost(hostname) {
+	const host = hostname.toLowerCase();
+	if (host === "[::1]" || host === "::1") return true;
+	const parts = host.split(".");
+	return parts.length === 4 && parts[0] === "127" && parts.every((part) => /^\d+$/.test(part) && Number(part) <= 255);
+}
+function assertAuthorizableRealmScheme(realmUrl, url) {
+	if ((url.protocol === "https:" || url.protocol === "http:") && (!HTTP_REALM_URL_WITH_HOST.test(realmUrl) || url.hostname === "")) throw new B2RealmConfigurationError(`realm URL must be an absolute HTTP(S) URL with a hostname for authorization: ${realmUrlForError(realmUrl, url)}`);
+	if (url.protocol === "https:") return;
+	if (url.protocol === "http:" && isLoopbackHost(url.hostname)) return;
+	if (url.protocol === "http:") throw new B2RealmConfigurationError(`refusing to send credentials over plaintext HTTP realm: ${realmUrlForError(realmUrl, url)}`);
+	throw new B2RealmConfigurationError(`realm URL must use HTTPS or loopback IP HTTP for authorization: ${realmUrlForError(realmUrl, url)}`);
+}
+function assertRealmBaseUrl(realmUrl, url) {
+	if (url.username === "" && url.password === "" && url.search === "" && url.hash === "") return;
+	throw new B2RealmConfigurationError(`realm URL must not include credentials, query, or fragment for authorization: ${realmUrlForError(realmUrl, url)}`);
+}
+/**
+* Validate a realm URL before it is used for credential-bearing authorization.
+* Any accepted custom HTTPS host receives the application key during authorize;
+* do not derive custom realm URLs from untrusted input. Realm URLs must be base
+* URLs without userinfo, query strings, or fragments.
+*
+* @param realmUrl - The resolved realm URL to validate.
+*
+* @throws B2RealmConfigurationError when the realm URL is not absolute, is not
+* a base URL, uses an unsupported scheme, or uses non-loopback plaintext HTTP.
+* Loopback IP HTTP is accepted only for local testing and sends the application
+* key unencrypted to whichever process is listening on that address and port.
+*/
+function assertSecureRealmUrl(realmUrl) {
+	const url = parseAbsoluteRealmUrl(realmUrl);
+	if (url === null) throw new B2RealmConfigurationError(`realm URL must be absolute for authorization: ${realmUrlForError(realmUrl, url)}`);
+	assertRealmBaseUrl(realmUrl, url);
+	assertAuthorizableRealmScheme(realmUrl, url);
+}
+function isRealmName(realm) {
+	return Object.hasOwn(VERIFIED_REALM_URLS, realm);
+}
+/**
+* Resolve a realm name to its base API URL. Unknown strings are returned
+* unchanged so callers can resolve custom aliases before authorization.
+*
+* @param realm - The realm name or direct URL to resolve.
+*
+* @returns The mapped base API URL for a known realm, otherwise `realm`.
+*/
 function getRealmUrl(realm) {
-  return REALM_URLS[realm] ?? realm;
+	return isRealmName(realm) ? VERIFIED_REALM_URLS[realm] : realm;
 }
-export {
-  REALM_URLS,
-  getRealmUrl
-};
-//# sourceMappingURL=realms.js.map
+//#endregion
+export { REALM_URLS, assertSecureRealmUrl, getRealmUrl };
+
+//# sourceMappingURL=realms.js.map

package/dist/auth/realms.js.map

@@ -1 +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;"}
+{"version":3,"file":"realms.js","names":[],"sources":["../../src/auth/realms.ts"],"sourcesContent":["import { B2RealmConfigurationError } from '../errors/index.ts'\nimport { redactUrlForError } from '../internal/url-redaction.ts'\n\n/** Name of a verified built-in auth realm alias. */\nexport type RealmName = 'production' | 'staging'\n\nconst VERIFIED_REALM_URLS = {\n  /** Public production B2 Native API authorize endpoint. */\n  production: 'https://api.backblazeb2.com',\n  /** Backblaze staging authorize endpoint from the official Python SDK realm map. */\n  staging: 'https://api.backblaze.net',\n} as const satisfies Record<RealmName, string>\n\n/**\n * Built-in realm aliases to their `b2_authorize_account` base API URLs.\n * The object remains a mutable `Record<string, string>` for source\n * compatibility with earlier SDK versions that let applications add local\n * aliases. SDK internals validate only the built-in aliases in\n * `VERIFIED_REALM_URLS`; pass direct custom realm URLs to `B2Client` instead\n * of relying on mutation for new code.\n */\nexport const REALM_URLS: Record<string, string> = { ...VERIFIED_REALM_URLS }\n\n// `new URL('https:example.com')` normalizes to `https://example.com/`;\n// require the raw URL to use authority syntax before credentials are sent.\nconst HTTP_REALM_URL_WITH_HOST = /^https?:\\/\\/[^/?#]/i\n\nfunction parseAbsoluteRealmUrl(realmUrl: string): URL | null {\n  try {\n    return new URL(realmUrl)\n  } catch {\n    return null\n  }\n}\n\nfunction realmUrlForError(realmUrl: string, url = parseAbsoluteRealmUrl(realmUrl)): string {\n  return redactUrlForError(url ?? realmUrl, { invalidUrlLabel: '<invalid realm URL>' })\n}\n\nfunction isLoopbackHost(hostname: string): boolean {\n  const host = hostname.toLowerCase()\n  if (host === '[::1]' || host === '::1') return true\n\n  // Intentionally excludes `localhost`: it is resolver-controlled, while this\n  // gate decides whether application-key credentials may be sent over HTTP.\n  const parts = host.split('.')\n  return (\n    parts.length === 4 &&\n    parts[0] === '127' &&\n    parts.every((part) => /^\\d+$/.test(part) && Number(part) <= 255)\n  )\n}\n\nfunction assertAuthorizableRealmScheme(realmUrl: string, url: URL): void {\n  if (\n    (url.protocol === 'https:' || url.protocol === 'http:') &&\n    (!HTTP_REALM_URL_WITH_HOST.test(realmUrl) || url.hostname === '')\n  ) {\n    throw new B2RealmConfigurationError(\n      `realm URL must be an absolute HTTP(S) URL with a hostname for authorization: ${realmUrlForError(realmUrl, url)}`,\n    )\n  }\n  if (url.protocol === 'https:') return\n  if (url.protocol === 'http:' && isLoopbackHost(url.hostname)) return\n  if (url.protocol === 'http:') {\n    throw new B2RealmConfigurationError(\n      `refusing to send credentials over plaintext HTTP realm: ${realmUrlForError(realmUrl, url)}`,\n    )\n  }\n  throw new B2RealmConfigurationError(\n    `realm URL must use HTTPS or loopback IP HTTP for authorization: ${realmUrlForError(realmUrl, url)}`,\n  )\n}\n\nfunction assertRealmBaseUrl(realmUrl: string, url: URL): void {\n  if (url.username === '' && url.password === '' && url.search === '' && url.hash === '') return\n  throw new B2RealmConfigurationError(\n    `realm URL must not include credentials, query, or fragment for authorization: ${realmUrlForError(realmUrl, url)}`,\n  )\n}\n\n/**\n * Validate a realm URL before it is used for credential-bearing authorization.\n * Any accepted custom HTTPS host receives the application key during authorize;\n * do not derive custom realm URLs from untrusted input. Realm URLs must be base\n * URLs without userinfo, query strings, or fragments.\n *\n * @param realmUrl - The resolved realm URL to validate.\n *\n * @throws B2RealmConfigurationError when the realm URL is not absolute, is not\n * a base URL, uses an unsupported scheme, or uses non-loopback plaintext HTTP.\n * Loopback IP HTTP is accepted only for local testing and sends the application\n * key unencrypted to whichever process is listening on that address and port.\n */\nexport function assertSecureRealmUrl(realmUrl: string): void {\n  const url = parseAbsoluteRealmUrl(realmUrl)\n  if (url === null) {\n    throw new B2RealmConfigurationError(\n      `realm URL must be absolute for authorization: ${realmUrlForError(realmUrl, url)}`,\n    )\n  }\n\n  assertRealmBaseUrl(realmUrl, url)\n  assertAuthorizableRealmScheme(realmUrl, url)\n}\n\nfunction isRealmName(realm: string): realm is RealmName {\n  return Object.hasOwn(VERIFIED_REALM_URLS, realm)\n}\n\n/**\n * Resolve a realm name to its base API URL. Unknown strings are returned\n * unchanged so callers can resolve custom aliases before authorization.\n *\n * @param realm - The realm name or direct URL to resolve.\n *\n * @returns The mapped base API URL for a known realm, otherwise `realm`.\n */\nexport function getRealmUrl(realm: string): string {\n  return isRealmName(realm) ? VERIFIED_REALM_URLS[realm] : realm\n}\n"],"mappings":";;;AAMA,IAAM,sBAAsB;;CAE1B,YAAY;;CAEZ,SAAS;AACX;;;;;;;;;AAUA,IAAa,aAAqC,EAAE,GAAG,oBAAoB;AAI3E,IAAM,2BAA2B;AAEjC,SAAS,sBAAsB,UAA8B;CAC3D,IAAI;EACF,OAAO,IAAI,IAAI,QAAQ;CACzB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,iBAAiB,UAAkB,MAAM,sBAAsB,QAAQ,GAAW;CACzF,OAAO,kBAAkB,OAAO,UAAU,EAAE,iBAAiB,sBAAsB,CAAC;AACtF;AAEA,SAAS,eAAe,UAA2B;CACjD,MAAM,OAAO,SAAS,YAAY;CAClC,IAAI,SAAS,WAAW,SAAS,OAAO,OAAO;CAI/C,MAAM,QAAQ,KAAK,MAAM,GAAG;CAC5B,OACE,MAAM,WAAW,KACjB,MAAM,OAAO,SACb,MAAM,OAAO,SAAS,QAAQ,KAAK,IAAI,KAAK,OAAO,IAAI,KAAK,GAAG;AAEnE;AAEA,SAAS,8BAA8B,UAAkB,KAAgB;CACvE,KACG,IAAI,aAAa,YAAY,IAAI,aAAa,aAC9C,CAAC,yBAAyB,KAAK,QAAQ,KAAK,IAAI,aAAa,KAE9D,MAAM,IAAI,0BACR,gFAAgF,iBAAiB,UAAU,GAAG,GAChH;CAEF,IAAI,IAAI,aAAa,UAAU;CAC/B,IAAI,IAAI,aAAa,WAAW,eAAe,IAAI,QAAQ,GAAG;CAC9D,IAAI,IAAI,aAAa,SACnB,MAAM,IAAI,0BACR,2DAA2D,iBAAiB,UAAU,GAAG,GAC3F;CAEF,MAAM,IAAI,0BACR,mEAAmE,iBAAiB,UAAU,GAAG,GACnG;AACF;AAEA,SAAS,mBAAmB,UAAkB,KAAgB;CAC5D,IAAI,IAAI,aAAa,MAAM,IAAI,aAAa,MAAM,IAAI,WAAW,MAAM,IAAI,SAAS,IAAI;CACxF,MAAM,IAAI,0BACR,iFAAiF,iBAAiB,UAAU,GAAG,GACjH;AACF;;;;;;;;;;;;;;AAeA,SAAgB,qBAAqB,UAAwB;CAC3D,MAAM,MAAM,sBAAsB,QAAQ;CAC1C,IAAI,QAAQ,MACV,MAAM,IAAI,0BACR,iDAAiD,iBAAiB,UAAU,GAAG,GACjF;CAGF,mBAAmB,UAAU,GAAG;CAChC,8BAA8B,UAAU,GAAG;AAC7C;AAEA,SAAS,YAAY,OAAmC;CACtD,OAAO,OAAO,OAAO,qBAAqB,KAAK;AACjD;;;;;;;;;AAUA,SAAgB,YAAY,OAAuB;CACjD,OAAO,YAAY,KAAK,IAAI,oBAAoB,SAAS;AAC3D"}

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

@@ -1,52 +1,56 @@
-"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();
-  }
-}
+//#region src/auth/upload-url-pool.ts
+/**
+* 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.
+*/
+var UploadUrlPool = class {
+	/** 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();
+	}
+};
+//#endregion
 exports.UploadUrlPool = UploadUrlPool;
-//# sourceMappingURL=upload-url-pool.cjs.map
+
+//# sourceMappingURL=upload-url-pool.cjs.map

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

@@ -1 +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;;"}
+{"version":3,"file":"upload-url-pool.cjs","names":[],"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"],"mappings":";;;;;;AAOA,IAAa,gBAAb,MAA2B;;CAEzB,wBAAyB,IAAI,IAA8B;;;;;;;;CAS3D,SAAS,KAAoC;EAC3C,MAAM,OAAO,KAAK,MAAM,IAAI,GAAG;EAC/B,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,OAAO;EACvC,OAAO,KAAK,IAAI,KAAK;CACvB;;;;;;;CAQA,QAAQ,KAAa,OAA6B;EAChD,IAAI,OAAO,KAAK,MAAM,IAAI,GAAG;EAC7B,IAAI,CAAC,MAAM;GACT,OAAO,CAAC;GACR,KAAK,MAAM,IAAI,KAAK,IAAI;EAC1B;EACA,KAAK,KAAK,KAAK;CACjB;;;;;;;CAQA,MAAM,KAAa,OAA6B;EAC9C,MAAM,OAAO,KAAK,MAAM,IAAI,GAAG;EAC/B,IAAI,CAAC,MAAM;EACX,MAAM,MAAM,KAAK,WAAW,MAAM,EAAE,cAAc,MAAM,SAAS;EACjE,IAAI,QAAQ,IACV,KAAK,OAAO,KAAK,CAAC;CAEtB;;CAGA,QAAc;EACZ,KAAK,MAAM,MAAM;CACnB;AACF"}

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

@@ -1,52 +1,56 @@
-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();
-  }
-}
-export {
-  UploadUrlPool
+//#region src/auth/upload-url-pool.ts
+/**
+* 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.
+*/
+var UploadUrlPool = class {
+	/** 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();
+	}
 };
-//# sourceMappingURL=upload-url-pool.js.map
+//#endregion
+export { UploadUrlPool };
+
+//# sourceMappingURL=upload-url-pool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"upload-url-pool.js","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;"}
+{"version":3,"file":"upload-url-pool.js","names":[],"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"],"mappings":";;;;;;AAOA,IAAa,gBAAb,MAA2B;;CAEzB,wBAAyB,IAAI,IAA8B;;;;;;;;CAS3D,SAAS,KAAoC;EAC3C,MAAM,OAAO,KAAK,MAAM,IAAI,GAAG;EAC/B,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,OAAO;EACvC,OAAO,KAAK,IAAI,KAAK;CACvB;;;;;;;CAQA,QAAQ,KAAa,OAA6B;EAChD,IAAI,OAAO,KAAK,MAAM,IAAI,GAAG;EAC7B,IAAI,CAAC,MAAM;GACT,OAAO,CAAC;GACR,KAAK,MAAM,IAAI,KAAK,IAAI;EAC1B;EACA,KAAK,KAAK,KAAK;CACjB;;;;;;;CAQA,MAAM,KAAa,OAA6B;EAC9C,MAAM,OAAO,KAAK,MAAM,IAAI,GAAG;EAC/B,IAAI,CAAC,MAAM;EACX,MAAM,MAAM,KAAK,WAAW,MAAM,EAAE,cAAc,MAAM,SAAS;EACjE,IAAI,QAAQ,IACV,KAAK,OAAO,KAAK,CAAC;CAEtB;;CAGA,QAAc;EACZ,KAAK,MAAM,MAAM;CACnB;AACF"}