@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/partner/redaction.js

@@ -0,0 +1,257 @@
+import { B2PartnerAuthorizationError } from "../errors/index.js";
+import { APPLICATION_KEY_REDACTED, PARTNER_TOKEN_REDACTED } from "./redaction-placeholders.js";
+//#region src/partner/redaction.ts
+var inspectSymbol = Symbol.for("nodejs.util.inspect.custom");
+function installPortableJsonHook(target, toJson) {
+	const originalPrototype = Object.getPrototypeOf(target);
+	const redactionPrototype = Object.create(originalPrototype);
+	Object.defineProperty(redactionPrototype, "toJSON", {
+		value: toJson,
+		enumerable: false,
+		configurable: true
+	});
+	Object.setPrototypeOf(target, redactionPrototype);
+	Object.defineProperty(target, "toJSON", {
+		value: toJson,
+		enumerable: false,
+		configurable: true
+	});
+}
+/**
+* Returns a redacted copy for log serializers that intentionally hide tokens.
+*
+* @param auth - Partner authorization response to render safely.
+*
+* @returns A plain object with the Partner token replaced by a placeholder.
+*/
+function partnerAuthorizeResponseToRedactedJson(auth) {
+	return {
+		...auth,
+		authorizationToken: PARTNER_TOKEN_REDACTED
+	};
+}
+/**
+* Returns a redacted copy for log serializers that intentionally hide group-member keys.
+*
+* @param result - Create group member result to render safely.
+*
+* @returns A plain object with the application key secret replaced by a placeholder.
+*/
+function createGroupMemberResultToRedactedJson(result) {
+	return {
+		...result,
+		applicationKey: APPLICATION_KEY_REDACTED
+	};
+}
+/**
+* Returns a redacted copy for log serializers that intentionally hide group-member keys.
+*
+* @param response - Create group member response to render safely.
+*
+* @returns A plain array with every application key secret replaced by a placeholder.
+*/
+function createGroupMemberResponseToRedactedJson(response) {
+	return response.map((result) => createGroupMemberResultToRedactedJson(result));
+}
+/**
+* Returns a redacted copy for log serializers that intentionally hide trial account keys.
+*
+* @param result - Reserve trial account result to render safely.
+*
+* @returns A plain object with the application key secret replaced by a placeholder.
+*/
+function reserveTrialCreateAccountResultToRedactedJson(result) {
+	return {
+		...result,
+		applicationKey: APPLICATION_KEY_REDACTED
+	};
+}
+/**
+* Returns a redacted copy for log serializers that intentionally hide trial account keys.
+*
+* @param response - Reserve trial account response to render safely.
+*
+* @returns A plain array with every application key secret replaced by a placeholder.
+*/
+function reserveTrialCreateAccountResponseToRedactedJson(response) {
+	return response.map((result) => reserveTrialCreateAccountResultToRedactedJson(result));
+}
+/**
+* Adds non-enumerable serialization and inspection hooks that redact the
+* Partner token through `JSON.stringify`, `toString`, and Node `util.inspect`
+* while preserving direct property access.
+*
+* `JSON.stringify` no longer round-trips `authorizationToken` from protected
+* authorize responses. Persist trusted auth caches with
+* `partnerAuthorizeResponseForPersistence(auth)` only into encrypted or
+* otherwise credential-grade storage, or read `authorizationToken` directly
+* into secure storage before serializing.
+*
+* This does not make the object universally log-safe: object spread,
+* `Object.assign`, `Object.entries`, `structuredClone`, and serializers that
+* walk enumerable properties can still expose the raw token.
+*
+* @param auth - Partner authorization response to protect from accidental inspection.
+*
+* @returns The same auth object with inspection hooks installed when possible.
+*/
+function redactPartnerAuthorizeResponse(auth) {
+	const target = Object.isExtensible(auth) ? auth : { ...auth };
+	const toRedactedJson = () => partnerAuthorizeResponseToRedactedJson(target);
+	const toRedactedString = () => `[PartnerAuthorizeResponse ${PARTNER_TOKEN_REDACTED}]`;
+	installPortableJsonHook(target, toRedactedJson);
+	Object.defineProperties(target, {
+		toString: {
+			value: toRedactedString,
+			enumerable: false,
+			configurable: true
+		},
+		[inspectSymbol]: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		}
+	});
+	return target;
+}
+/**
+* Adds non-enumerable serialization and inspection hooks that redact the
+* application key secret while preserving direct property access.
+*
+* @param result - Create group member result to protect from accidental logging.
+*
+* @returns The same result object with redaction hooks installed when possible.
+*/
+function redactCreateGroupMemberResult(result) {
+	const target = Object.isExtensible(result) ? result : { ...result };
+	const toRedactedJson = () => createGroupMemberResultToRedactedJson(target);
+	const toRedactedString = () => `[CreateGroupMemberResult ${APPLICATION_KEY_REDACTED}]`;
+	installPortableJsonHook(target, toRedactedJson);
+	Object.defineProperties(target, {
+		toString: {
+			value: toRedactedString,
+			enumerable: false,
+			configurable: true
+		},
+		[inspectSymbol]: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		}
+	});
+	return target;
+}
+/**
+* Adds non-enumerable serialization and inspection hooks that redact all
+* create-group-member application key secrets while preserving direct access.
+*
+* @param response - Create group member response to protect from accidental logging.
+*
+* @returns The same response array with redaction hooks installed when possible.
+*
+* @throws B2PartnerAuthorizationError if the response is not an array.
+*/
+function redactCreateGroupMemberResponse(response) {
+	if (!Array.isArray(response)) throw new B2PartnerAuthorizationError("b2_create_group_member response was not a JSON array");
+	const target = Object.isExtensible(response) ? response : [...response];
+	const writableTarget = target;
+	for (let i = 0; i < writableTarget.length; i++) {
+		const result = writableTarget[i];
+		if (result !== void 0) writableTarget[i] = redactCreateGroupMemberResult(result);
+	}
+	const toRedactedJson = () => createGroupMemberResponseToRedactedJson(target);
+	const toRedactedString = () => `[CreateGroupMemberResponse ${APPLICATION_KEY_REDACTED}]`;
+	Object.defineProperties(target, {
+		toJSON: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		},
+		toString: {
+			value: toRedactedString,
+			enumerable: false,
+			configurable: true
+		},
+		[inspectSymbol]: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		}
+	});
+	return target;
+}
+/**
+* Adds non-enumerable serialization and inspection hooks that redact the
+* application key secret while preserving direct property access.
+*
+* `JSON.stringify` redacts because the response contains newly minted
+* application key secrets that are commonly logged as batch results. Callers
+* that need to persist the key should read `applicationKey` directly into
+* secure storage before serializing the object.
+*
+* @param result - Reserve trial account result to protect from accidental logging.
+*
+* @returns The same result object with redaction hooks installed when possible.
+*/
+function redactReserveTrialCreateAccountResult(result) {
+	const target = Object.isExtensible(result) ? result : { ...result };
+	const toRedactedJson = () => reserveTrialCreateAccountResultToRedactedJson(target);
+	const toRedactedString = () => `[ReserveTrialCreateAccountResult ${APPLICATION_KEY_REDACTED}]`;
+	installPortableJsonHook(target, toRedactedJson);
+	Object.defineProperties(target, {
+		toString: {
+			value: toRedactedString,
+			enumerable: false,
+			configurable: true
+		},
+		[inspectSymbol]: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		}
+	});
+	return target;
+}
+/**
+* Adds non-enumerable serialization and inspection hooks that redact all
+* reserve-trial application key secrets while preserving direct property access.
+*
+* @param response - Reserve trial account response to protect from accidental logging.
+*
+* @returns The same response array with redaction hooks installed when possible.
+*
+* @throws B2PartnerAuthorizationError if the response is not an array.
+*/
+function redactReserveTrialCreateAccountResponse(response) {
+	if (!Array.isArray(response)) throw new B2PartnerAuthorizationError("b2_reserve_trial_create_account response was not a JSON array");
+	const target = Object.isExtensible(response) ? response : [...response];
+	const writableTarget = target;
+	for (let i = 0; i < writableTarget.length; i++) {
+		const result = writableTarget[i];
+		if (result !== void 0) writableTarget[i] = redactReserveTrialCreateAccountResult(result);
+	}
+	const toRedactedJson = () => reserveTrialCreateAccountResponseToRedactedJson(target);
+	const toRedactedString = () => `[ReserveTrialCreateAccountResponse ${APPLICATION_KEY_REDACTED}]`;
+	Object.defineProperties(target, {
+		toJSON: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		},
+		toString: {
+			value: toRedactedString,
+			enumerable: false,
+			configurable: true
+		},
+		[inspectSymbol]: {
+			value: toRedactedJson,
+			enumerable: false,
+			configurable: true
+		}
+	});
+	return target;
+}
+//#endregion
+export { PARTNER_TOKEN_REDACTED, createGroupMemberResponseToRedactedJson, createGroupMemberResultToRedactedJson, partnerAuthorizeResponseToRedactedJson, redactCreateGroupMemberResponse, redactCreateGroupMemberResult, redactPartnerAuthorizeResponse, redactReserveTrialCreateAccountResponse, redactReserveTrialCreateAccountResult, reserveTrialCreateAccountResponseToRedactedJson, reserveTrialCreateAccountResultToRedactedJson };
+
+//# sourceMappingURL=redaction.js.map

package/dist/partner/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","names":[],"sources":["../../src/partner/redaction.ts"],"sourcesContent":["import { B2PartnerAuthorizationError } from '../errors/index.ts'\nimport type {\n  CreateGroupMemberResponse,\n  CreateGroupMemberResult,\n  PartnerAuthorizeResponse,\n  ReserveTrialCreateAccountResponse,\n  ReserveTrialCreateAccountResult,\n} from '../types/partner.ts'\nimport { APPLICATION_KEY_REDACTED, PARTNER_TOKEN_REDACTED } from './redaction-placeholders.ts'\n\nexport {\n  APPLICATION_KEY_REDACTED,\n  PARTNER_TOKEN_REDACTED,\n} from './redaction-placeholders.ts'\n\n/**\n * JSON-safe Partner authorize response with the Partner token replaced by a\n * placeholder string.\n */\nexport interface RedactedPartnerAuthorizeResponseJson\n  extends Omit<PartnerAuthorizeResponse, 'authorizationToken'> {\n  /** Redacted Partner authorization token placeholder. */\n  readonly authorizationToken: string\n}\n\nexport type RedactedCreateGroupMemberResultJson = Omit<\n  CreateGroupMemberResult,\n  'applicationKey'\n> & {\n  readonly applicationKey: string\n}\n\nexport type RedactedCreateGroupMemberResponseJson = readonly RedactedCreateGroupMemberResultJson[]\n\nexport type RedactedReserveTrialCreateAccountResultJson = Omit<\n  ReserveTrialCreateAccountResult,\n  'applicationKey'\n> & {\n  readonly applicationKey: string\n}\n\nexport type RedactedReserveTrialCreateAccountResponseJson =\n  readonly RedactedReserveTrialCreateAccountResultJson[]\n\nconst inspectSymbol = Symbol.for('nodejs.util.inspect.custom')\n\n// Bun/WebKit only honor object toJSON hooks when they are inherited, while Node\n// honors own hooks. Install both shapes so SDK safe serialization is portable.\nfunction installPortableJsonHook<T extends object>(target: T, toJson: () => unknown): void {\n  const originalPrototype = Object.getPrototypeOf(target)\n  const redactionPrototype = Object.create(originalPrototype) as object\n  Object.defineProperty(redactionPrototype, 'toJSON', {\n    value: toJson,\n    enumerable: false,\n    configurable: true,\n  })\n  Object.setPrototypeOf(target, redactionPrototype)\n  Object.defineProperty(target, 'toJSON', {\n    value: toJson,\n    enumerable: false,\n    configurable: true,\n  })\n}\n\n/**\n * Returns a redacted copy for log serializers that intentionally hide tokens.\n *\n * @param auth - Partner authorization response to render safely.\n *\n * @returns A plain object with the Partner token replaced by a placeholder.\n */\nexport function partnerAuthorizeResponseToRedactedJson(\n  auth: PartnerAuthorizeResponse,\n): RedactedPartnerAuthorizeResponseJson {\n  return {\n    ...auth,\n    authorizationToken: PARTNER_TOKEN_REDACTED,\n  }\n}\n\n/**\n * Returns a redacted copy for log serializers that intentionally hide group-member keys.\n *\n * @param result - Create group member result to render safely.\n *\n * @returns A plain object with the application key secret replaced by a placeholder.\n */\nexport function createGroupMemberResultToRedactedJson(\n  result: CreateGroupMemberResult,\n): RedactedCreateGroupMemberResultJson {\n  return {\n    ...result,\n    applicationKey: APPLICATION_KEY_REDACTED,\n  }\n}\n\n/**\n * Returns a redacted copy for log serializers that intentionally hide group-member keys.\n *\n * @param response - Create group member response to render safely.\n *\n * @returns A plain array with every application key secret replaced by a placeholder.\n */\nexport function createGroupMemberResponseToRedactedJson(\n  response: CreateGroupMemberResponse,\n): RedactedCreateGroupMemberResponseJson {\n  return response.map((result) => createGroupMemberResultToRedactedJson(result))\n}\n\n/**\n * Returns a redacted copy for log serializers that intentionally hide trial account keys.\n *\n * @param result - Reserve trial account result to render safely.\n *\n * @returns A plain object with the application key secret replaced by a placeholder.\n */\nexport function reserveTrialCreateAccountResultToRedactedJson(\n  result: ReserveTrialCreateAccountResult,\n): RedactedReserveTrialCreateAccountResultJson {\n  return {\n    ...result,\n    applicationKey: APPLICATION_KEY_REDACTED,\n  }\n}\n\n/**\n * Returns a redacted copy for log serializers that intentionally hide trial account keys.\n *\n * @param response - Reserve trial account response to render safely.\n *\n * @returns A plain array with every application key secret replaced by a placeholder.\n */\nexport function reserveTrialCreateAccountResponseToRedactedJson(\n  response: ReserveTrialCreateAccountResponse,\n): RedactedReserveTrialCreateAccountResponseJson {\n  return response.map((result) => reserveTrialCreateAccountResultToRedactedJson(result))\n}\n\n/**\n * Adds non-enumerable serialization and inspection hooks that redact the\n * Partner token through `JSON.stringify`, `toString`, and Node `util.inspect`\n * while preserving direct property access.\n *\n * `JSON.stringify` no longer round-trips `authorizationToken` from protected\n * authorize responses. Persist trusted auth caches with\n * `partnerAuthorizeResponseForPersistence(auth)` only into encrypted or\n * otherwise credential-grade storage, or read `authorizationToken` directly\n * into secure storage before serializing.\n *\n * This does not make the object universally log-safe: object spread,\n * `Object.assign`, `Object.entries`, `structuredClone`, and serializers that\n * walk enumerable properties can still expose the raw token.\n *\n * @param auth - Partner authorization response to protect from accidental inspection.\n *\n * @returns The same auth object with inspection hooks installed when possible.\n */\nexport function redactPartnerAuthorizeResponse(\n  auth: PartnerAuthorizeResponse,\n): PartnerAuthorizeResponse {\n  const target = Object.isExtensible(auth) ? auth : { ...auth }\n  const toRedactedJson = (): RedactedPartnerAuthorizeResponseJson =>\n    partnerAuthorizeResponseToRedactedJson(target)\n  const toRedactedString = (): string => `[PartnerAuthorizeResponse ${PARTNER_TOKEN_REDACTED}]`\n\n  installPortableJsonHook(target, toRedactedJson)\n  Object.defineProperties(target, {\n    toString: {\n      value: toRedactedString,\n      enumerable: false,\n      configurable: true,\n    },\n    [inspectSymbol]: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n  })\n\n  return target\n}\n\n/**\n * Adds non-enumerable serialization and inspection hooks that redact the\n * application key secret while preserving direct property access.\n *\n * @param result - Create group member result to protect from accidental logging.\n *\n * @returns The same result object with redaction hooks installed when possible.\n */\nexport function redactCreateGroupMemberResult(\n  result: CreateGroupMemberResult,\n): CreateGroupMemberResult {\n  const target = Object.isExtensible(result) ? result : { ...result }\n  const toRedactedJson = (): RedactedCreateGroupMemberResultJson =>\n    createGroupMemberResultToRedactedJson(target)\n  const toRedactedString = (): string => `[CreateGroupMemberResult ${APPLICATION_KEY_REDACTED}]`\n\n  installPortableJsonHook(target, toRedactedJson)\n  Object.defineProperties(target, {\n    toString: {\n      value: toRedactedString,\n      enumerable: false,\n      configurable: true,\n    },\n    [inspectSymbol]: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n  })\n\n  return target\n}\n\n/**\n * Adds non-enumerable serialization and inspection hooks that redact all\n * create-group-member application key secrets while preserving direct access.\n *\n * @param response - Create group member response to protect from accidental logging.\n *\n * @returns The same response array with redaction hooks installed when possible.\n *\n * @throws B2PartnerAuthorizationError if the response is not an array.\n */\nexport function redactCreateGroupMemberResponse(\n  response: CreateGroupMemberResponse,\n): CreateGroupMemberResponse {\n  if (!Array.isArray(response)) {\n    throw new B2PartnerAuthorizationError('b2_create_group_member response was not a JSON array')\n  }\n\n  const target = Object.isExtensible(response) ? response : [...response]\n  const writableTarget = target as CreateGroupMemberResult[]\n  for (let i = 0; i < writableTarget.length; i++) {\n    const result = writableTarget[i]\n    if (result !== undefined) writableTarget[i] = redactCreateGroupMemberResult(result)\n  }\n\n  const toRedactedJson = (): RedactedCreateGroupMemberResponseJson =>\n    createGroupMemberResponseToRedactedJson(target)\n  const toRedactedString = (): string => `[CreateGroupMemberResponse ${APPLICATION_KEY_REDACTED}]`\n\n  Object.defineProperties(target, {\n    toJSON: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n    toString: {\n      value: toRedactedString,\n      enumerable: false,\n      configurable: true,\n    },\n    [inspectSymbol]: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n  })\n\n  return target\n}\n\n/**\n * Adds non-enumerable serialization and inspection hooks that redact the\n * application key secret while preserving direct property access.\n *\n * `JSON.stringify` redacts because the response contains newly minted\n * application key secrets that are commonly logged as batch results. Callers\n * that need to persist the key should read `applicationKey` directly into\n * secure storage before serializing the object.\n *\n * @param result - Reserve trial account result to protect from accidental logging.\n *\n * @returns The same result object with redaction hooks installed when possible.\n */\nexport function redactReserveTrialCreateAccountResult(\n  result: ReserveTrialCreateAccountResult,\n): ReserveTrialCreateAccountResult {\n  const target = Object.isExtensible(result) ? result : { ...result }\n  const toRedactedJson = (): RedactedReserveTrialCreateAccountResultJson =>\n    reserveTrialCreateAccountResultToRedactedJson(target)\n  const toRedactedString = (): string =>\n    `[ReserveTrialCreateAccountResult ${APPLICATION_KEY_REDACTED}]`\n\n  installPortableJsonHook(target, toRedactedJson)\n  Object.defineProperties(target, {\n    toString: {\n      value: toRedactedString,\n      enumerable: false,\n      configurable: true,\n    },\n    [inspectSymbol]: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n  })\n\n  return target\n}\n\n/**\n * Adds non-enumerable serialization and inspection hooks that redact all\n * reserve-trial application key secrets while preserving direct property access.\n *\n * @param response - Reserve trial account response to protect from accidental logging.\n *\n * @returns The same response array with redaction hooks installed when possible.\n *\n * @throws B2PartnerAuthorizationError if the response is not an array.\n */\nexport function redactReserveTrialCreateAccountResponse(\n  response: ReserveTrialCreateAccountResponse,\n): ReserveTrialCreateAccountResponse {\n  if (!Array.isArray(response)) {\n    throw new B2PartnerAuthorizationError(\n      'b2_reserve_trial_create_account response was not a JSON array',\n    )\n  }\n\n  const target = Object.isExtensible(response) ? response : [...response]\n  const writableTarget = target as ReserveTrialCreateAccountResult[]\n  for (let i = 0; i < writableTarget.length; i++) {\n    const result = writableTarget[i]\n    if (result !== undefined) writableTarget[i] = redactReserveTrialCreateAccountResult(result)\n  }\n\n  const toRedactedJson = (): RedactedReserveTrialCreateAccountResponseJson =>\n    reserveTrialCreateAccountResponseToRedactedJson(target)\n  const toRedactedString = (): string =>\n    `[ReserveTrialCreateAccountResponse ${APPLICATION_KEY_REDACTED}]`\n\n  Object.defineProperties(target, {\n    toJSON: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n    toString: {\n      value: toRedactedString,\n      enumerable: false,\n      configurable: true,\n    },\n    [inspectSymbol]: {\n      value: toRedactedJson,\n      enumerable: false,\n      configurable: true,\n    },\n  })\n\n  return target\n}\n"],"mappings":"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"}

package/dist/raw/encoding.cjs

@@ -1,47 +1,86 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const textCodec = require("../util/text-codec.cjs");
-const SAFE_CHARS = new Set(
-  "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/".split("")
-);
+const require_text_codec = require("../util/text-codec.cjs");
+//#region src/raw/encoding.ts
+/**
+* Characters that B2 treats as safe (not percent-encoded) in file names.
+*
+* Per the B2 docs, everything except `a-z A-Z 0-9 - . _ ~ / ! $ & ' ( ) * + , ; = : @`
+* must be percent-encoded using UTF-8 byte values.
+*/
+var SAFE_CHARS = new Set("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/".split(""));
+/**
+* Percent-encodes a file name using the B2-specific encoding rules.
+*
+* Unlike standard `encodeURIComponent`, B2 keeps `/` and several other
+* characters unencoded while encoding all other non-ASCII and special
+* characters as uppercase percent-encoded UTF-8 bytes.
+*
+* @param name - The raw (unencoded) file name.
+*
+* @returns The percent-encoded file name suitable for `X-Bz-File-Name` headers.
+*/
 function encodeFileName(name) {
-  const encoded = [];
-  for (const char of name) {
-    if (SAFE_CHARS.has(char)) {
-      encoded.push(char);
-    } else {
-      const bytes = textCodec.utf8Encoder.encode(char);
-      for (const byte of bytes) {
-        encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, "0")}`);
-      }
-    }
-  }
-  return encoded.join("");
+	const encoded = [];
+	for (const char of name) if (SAFE_CHARS.has(char)) encoded.push(char);
+	else {
+		const bytes = require_text_codec.utf8Encoder.encode(char);
+		for (const byte of bytes) encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, "0")}`);
+	}
+	return encoded.join("");
 }
+/**
+* Decodes a B2 percent-encoded file name back to a plain string.
+*
+* B2 percent-encoding is compatible with standard `decodeURIComponent`,
+* so this is a thin wrapper.
+*
+* @param encoded - The percent-encoded file name from B2.
+*
+* @returns The decoded file name.
+*/
 function decodeFileName(encoded) {
-  return decodeURIComponent(encoded);
+	return decodeURIComponent(encoded);
 }
+/**
+* Converts a file-info map into `X-Bz-Info-*` HTTP headers.
+*
+* Both keys and values are percent-encoded with {@link encodeFileName}
+* to satisfy B2 header requirements.
+*
+* @param fileInfo - Key/value pairs to attach as custom file info, or `undefined`.
+*
+* @returns A record of header name/value pairs (empty if `fileInfo` is `undefined`).
+*/
 function buildFileInfoHeaders(fileInfo) {
-  if (!fileInfo) return {};
-  const headers = {};
-  for (const [key, value] of Object.entries(fileInfo)) {
-    headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value);
-  }
-  return headers;
+	if (!fileInfo) return {};
+	const headers = {};
+	for (const [key, value] of Object.entries(fileInfo)) headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value);
+	return headers;
 }
+/**
+* Extracts custom file-info key/value pairs from B2 response headers.
+*
+* Scans for headers prefixed with `x-bz-info-` and decodes both the
+* key suffix and value using {@link decodeFileName}.
+*
+* @param headers - The HTTP response headers from a B2 download or file-info call.
+*
+* @returns A record of decoded file-info key/value pairs.
+*/
 function parseFileInfoHeaders(headers) {
-  const info = {};
-  headers.forEach((value, key) => {
-    const lower = key.toLowerCase();
-    if (lower.startsWith("x-bz-info-")) {
-      const infoKey = decodeFileName(lower.slice("x-bz-info-".length));
-      info[infoKey] = decodeFileName(value);
-    }
-  });
-  return info;
+	const info = {};
+	headers.forEach((value, key) => {
+		const lower = key.toLowerCase();
+		if (lower.startsWith("x-bz-info-")) {
+			const infoKey = decodeFileName(lower.slice(10));
+			info[infoKey] = decodeFileName(value);
+		}
+	});
+	return info;
 }
+//#endregion
 exports.buildFileInfoHeaders = buildFileInfoHeaders;
 exports.decodeFileName = decodeFileName;
 exports.encodeFileName = encodeFileName;
 exports.parseFileInfoHeaders = parseFileInfoHeaders;
-//# sourceMappingURL=encoding.cjs.map
+
+//# sourceMappingURL=encoding.cjs.map

package/dist/raw/encoding.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.cjs","sources":["../../src/raw/encoding.ts"],"sourcesContent":["import { utf8Encoder } from '../util/text-codec.ts'\n\n/**\n * Characters that B2 treats as safe (not percent-encoded) in file names.\n *\n * Per the B2 docs, everything except `a-z A-Z 0-9 - . _ ~ / ! $ & ' ( ) * + , ; = : @`\n * must be percent-encoded using UTF-8 byte values.\n */\nconst SAFE_CHARS = new Set(\n  \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/\".split(''),\n)\n\n/**\n * Percent-encodes a file name using the B2-specific encoding rules.\n *\n * Unlike standard `encodeURIComponent`, B2 keeps `/` and several other\n * characters unencoded while encoding all other non-ASCII and special\n * characters as uppercase percent-encoded UTF-8 bytes.\n *\n * @param name - The raw (unencoded) file name.\n *\n * @returns The percent-encoded file name suitable for `X-Bz-File-Name` headers.\n */\nexport function encodeFileName(name: string): string {\n  const encoded: string[] = []\n  for (const char of name) {\n    if (SAFE_CHARS.has(char)) {\n      encoded.push(char)\n    } else {\n      const bytes = utf8Encoder.encode(char)\n      for (const byte of bytes) {\n        encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, '0')}`)\n      }\n    }\n  }\n  return encoded.join('')\n}\n\n/**\n * Decodes a B2 percent-encoded file name back to a plain string.\n *\n * B2 percent-encoding is compatible with standard `decodeURIComponent`,\n * so this is a thin wrapper.\n *\n * @param encoded - The percent-encoded file name from B2.\n *\n * @returns The decoded file name.\n */\nexport function decodeFileName(encoded: string): string {\n  return decodeURIComponent(encoded)\n}\n\n/**\n * Converts a file-info map into `X-Bz-Info-*` HTTP headers.\n *\n * Both keys and values are percent-encoded with {@link encodeFileName}\n * to satisfy B2 header requirements.\n *\n * @param fileInfo - Key/value pairs to attach as custom file info, or `undefined`.\n *\n * @returns A record of header name/value pairs (empty if `fileInfo` is `undefined`).\n */\nexport function buildFileInfoHeaders(\n  fileInfo: Record<string, string> | undefined,\n): Record<string, string> {\n  if (!fileInfo) return {}\n  const headers: Record<string, string> = {}\n  for (const [key, value] of Object.entries(fileInfo)) {\n    headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value)\n  }\n  return headers\n}\n\n/**\n * Extracts custom file-info key/value pairs from B2 response headers.\n *\n * Scans for headers prefixed with `x-bz-info-` and decodes both the\n * key suffix and value using {@link decodeFileName}.\n *\n * @param headers - The HTTP response headers from a B2 download or file-info call.\n *\n * @returns A record of decoded file-info key/value pairs.\n */\nexport function parseFileInfoHeaders(headers: Headers): Record<string, string> {\n  const info: Record<string, string> = {}\n  headers.forEach((value, key) => {\n    const lower = key.toLowerCase()\n    if (lower.startsWith('x-bz-info-')) {\n      const infoKey = decodeFileName(lower.slice('x-bz-info-'.length))\n      info[infoKey] = decodeFileName(value)\n    }\n  })\n  return info\n}\n"],"names":["utf8Encoder"],"mappings":";;;AAQA,MAAM,aAAa,IAAI;AAAA,EACrB,mFAAmF,MAAM,EAAE;AAC7F;AAaO,SAAS,eAAe,MAAsB;AACnD,QAAM,UAAoB,CAAA;AAC1B,aAAW,QAAQ,MAAM;AACvB,QAAI,WAAW,IAAI,IAAI,GAAG;AACxB,cAAQ,KAAK,IAAI;AAAA,IACnB,OAAO;AACL,YAAM,QAAQA,UAAAA,YAAY,OAAO,IAAI;AACrC,iBAAW,QAAQ,OAAO;AACxB,gBAAQ,KAAK,IAAI,KAAK,SAAS,EAAE,EAAE,YAAA,EAAc,SAAS,GAAG,GAAG,CAAC,EAAE;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACA,SAAO,QAAQ,KAAK,EAAE;AACxB;AAYO,SAAS,eAAe,SAAyB;AACtD,SAAO,mBAAmB,OAAO;AACnC;AAYO,SAAS,qBACd,UACwB;AACxB,MAAI,CAAC,SAAU,QAAO,CAAA;AACtB,QAAM,UAAkC,CAAA;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACnD,YAAQ,aAAa,eAAe,GAAG,CAAC,EAAE,IAAI,eAAe,KAAK;AAAA,EACpE;AACA,SAAO;AACT;AAYO,SAAS,qBAAqB,SAA0C;AAC7E,QAAM,OAA+B,CAAA;AACrC,UAAQ,QAAQ,CAAC,OAAO,QAAQ;AAC9B,UAAM,QAAQ,IAAI,YAAA;AAClB,QAAI,MAAM,WAAW,YAAY,GAAG;AAClC,YAAM,UAAU,eAAe,MAAM,MAAM,aAAa,MAAM,CAAC;AAC/D,WAAK,OAAO,IAAI,eAAe,KAAK;AAAA,IACtC;AAAA,EACF,CAAC;AACD,SAAO;AACT;;;;;"}
+{"version":3,"file":"encoding.cjs","names":[],"sources":["../../src/raw/encoding.ts"],"sourcesContent":["import { utf8Encoder } from '../util/text-codec.ts'\n\n/**\n * Characters that B2 treats as safe (not percent-encoded) in file names.\n *\n * Per the B2 docs, everything except `a-z A-Z 0-9 - . _ ~ / ! $ & ' ( ) * + , ; = : @`\n * must be percent-encoded using UTF-8 byte values.\n */\nconst SAFE_CHARS = new Set(\n  \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/\".split(''),\n)\n\n/**\n * Percent-encodes a file name using the B2-specific encoding rules.\n *\n * Unlike standard `encodeURIComponent`, B2 keeps `/` and several other\n * characters unencoded while encoding all other non-ASCII and special\n * characters as uppercase percent-encoded UTF-8 bytes.\n *\n * @param name - The raw (unencoded) file name.\n *\n * @returns The percent-encoded file name suitable for `X-Bz-File-Name` headers.\n */\nexport function encodeFileName(name: string): string {\n  const encoded: string[] = []\n  for (const char of name) {\n    if (SAFE_CHARS.has(char)) {\n      encoded.push(char)\n    } else {\n      const bytes = utf8Encoder.encode(char)\n      for (const byte of bytes) {\n        encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, '0')}`)\n      }\n    }\n  }\n  return encoded.join('')\n}\n\n/**\n * Decodes a B2 percent-encoded file name back to a plain string.\n *\n * B2 percent-encoding is compatible with standard `decodeURIComponent`,\n * so this is a thin wrapper.\n *\n * @param encoded - The percent-encoded file name from B2.\n *\n * @returns The decoded file name.\n */\nexport function decodeFileName(encoded: string): string {\n  return decodeURIComponent(encoded)\n}\n\n/**\n * Converts a file-info map into `X-Bz-Info-*` HTTP headers.\n *\n * Both keys and values are percent-encoded with {@link encodeFileName}\n * to satisfy B2 header requirements.\n *\n * @param fileInfo - Key/value pairs to attach as custom file info, or `undefined`.\n *\n * @returns A record of header name/value pairs (empty if `fileInfo` is `undefined`).\n */\nexport function buildFileInfoHeaders(\n  fileInfo: Record<string, string> | undefined,\n): Record<string, string> {\n  if (!fileInfo) return {}\n  const headers: Record<string, string> = {}\n  for (const [key, value] of Object.entries(fileInfo)) {\n    headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value)\n  }\n  return headers\n}\n\n/**\n * Extracts custom file-info key/value pairs from B2 response headers.\n *\n * Scans for headers prefixed with `x-bz-info-` and decodes both the\n * key suffix and value using {@link decodeFileName}.\n *\n * @param headers - The HTTP response headers from a B2 download or file-info call.\n *\n * @returns A record of decoded file-info key/value pairs.\n */\nexport function parseFileInfoHeaders(headers: Headers): Record<string, string> {\n  const info: Record<string, string> = {}\n  headers.forEach((value, key) => {\n    const lower = key.toLowerCase()\n    if (lower.startsWith('x-bz-info-')) {\n      const infoKey = decodeFileName(lower.slice('x-bz-info-'.length))\n      info[infoKey] = decodeFileName(value)\n    }\n  })\n  return info\n}\n"],"mappings":";;;;;;;;AAQA,IAAM,aAAa,IAAI,IACrB,mFAAmF,MAAM,EAAE,CAC7F;;;;;;;;;;;;AAaA,SAAgB,eAAe,MAAsB;CACnD,MAAM,UAAoB,CAAC;CAC3B,KAAK,MAAM,QAAQ,MACjB,IAAI,WAAW,IAAI,IAAI,GACrB,QAAQ,KAAK,IAAI;MACZ;EACL,MAAM,QAAQ,mBAAA,YAAY,OAAO,IAAI;EACrC,KAAK,MAAM,QAAQ,OACjB,QAAQ,KAAK,IAAI,KAAK,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;CAEvE;CAEF,OAAO,QAAQ,KAAK,EAAE;AACxB;;;;;;;;;;;AAYA,SAAgB,eAAe,SAAyB;CACtD,OAAO,mBAAmB,OAAO;AACnC;;;;;;;;;;;AAYA,SAAgB,qBACd,UACwB;CACxB,IAAI,CAAC,UAAU,OAAO,CAAC;CACvB,MAAM,UAAkC,CAAC;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAChD,QAAQ,aAAa,eAAe,GAAG,OAAO,eAAe,KAAK;CAEpE,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,qBAAqB,SAA0C;CAC7E,MAAM,OAA+B,CAAC;CACtC,QAAQ,SAAS,OAAO,QAAQ;EAC9B,MAAM,QAAQ,IAAI,YAAY;EAC9B,IAAI,MAAM,WAAW,YAAY,GAAG;GAClC,MAAM,UAAU,eAAe,MAAM,MAAM,EAAmB,CAAC;GAC/D,KAAK,WAAW,eAAe,KAAK;EACtC;CACF,CAAC;CACD,OAAO;AACT"}

package/dist/raw/encoding.js

@@ -1,47 +1,83 @@
 import { utf8Encoder } from "../util/text-codec.js";
-const SAFE_CHARS = new Set(
-  "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/".split("")
-);
+//#region src/raw/encoding.ts
+/**
+* Characters that B2 treats as safe (not percent-encoded) in file names.
+*
+* Per the B2 docs, everything except `a-z A-Z 0-9 - . _ ~ / ! $ & ' ( ) * + , ; = : @`
+* must be percent-encoded using UTF-8 byte values.
+*/
+var SAFE_CHARS = new Set("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/".split(""));
+/**
+* Percent-encodes a file name using the B2-specific encoding rules.
+*
+* Unlike standard `encodeURIComponent`, B2 keeps `/` and several other
+* characters unencoded while encoding all other non-ASCII and special
+* characters as uppercase percent-encoded UTF-8 bytes.
+*
+* @param name - The raw (unencoded) file name.
+*
+* @returns The percent-encoded file name suitable for `X-Bz-File-Name` headers.
+*/
 function encodeFileName(name) {
-  const encoded = [];
-  for (const char of name) {
-    if (SAFE_CHARS.has(char)) {
-      encoded.push(char);
-    } else {
-      const bytes = utf8Encoder.encode(char);
-      for (const byte of bytes) {
-        encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, "0")}`);
-      }
-    }
-  }
-  return encoded.join("");
+	const encoded = [];
+	for (const char of name) if (SAFE_CHARS.has(char)) encoded.push(char);
+	else {
+		const bytes = utf8Encoder.encode(char);
+		for (const byte of bytes) encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, "0")}`);
+	}
+	return encoded.join("");
 }
+/**
+* Decodes a B2 percent-encoded file name back to a plain string.
+*
+* B2 percent-encoding is compatible with standard `decodeURIComponent`,
+* so this is a thin wrapper.
+*
+* @param encoded - The percent-encoded file name from B2.
+*
+* @returns The decoded file name.
+*/
 function decodeFileName(encoded) {
-  return decodeURIComponent(encoded);
+	return decodeURIComponent(encoded);
 }
+/**
+* Converts a file-info map into `X-Bz-Info-*` HTTP headers.
+*
+* Both keys and values are percent-encoded with {@link encodeFileName}
+* to satisfy B2 header requirements.
+*
+* @param fileInfo - Key/value pairs to attach as custom file info, or `undefined`.
+*
+* @returns A record of header name/value pairs (empty if `fileInfo` is `undefined`).
+*/
 function buildFileInfoHeaders(fileInfo) {
-  if (!fileInfo) return {};
-  const headers = {};
-  for (const [key, value] of Object.entries(fileInfo)) {
-    headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value);
-  }
-  return headers;
+	if (!fileInfo) return {};
+	const headers = {};
+	for (const [key, value] of Object.entries(fileInfo)) headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value);
+	return headers;
 }
+/**
+* Extracts custom file-info key/value pairs from B2 response headers.
+*
+* Scans for headers prefixed with `x-bz-info-` and decodes both the
+* key suffix and value using {@link decodeFileName}.
+*
+* @param headers - The HTTP response headers from a B2 download or file-info call.
+*
+* @returns A record of decoded file-info key/value pairs.
+*/
 function parseFileInfoHeaders(headers) {
-  const info = {};
-  headers.forEach((value, key) => {
-    const lower = key.toLowerCase();
-    if (lower.startsWith("x-bz-info-")) {
-      const infoKey = decodeFileName(lower.slice("x-bz-info-".length));
-      info[infoKey] = decodeFileName(value);
-    }
-  });
-  return info;
+	const info = {};
+	headers.forEach((value, key) => {
+		const lower = key.toLowerCase();
+		if (lower.startsWith("x-bz-info-")) {
+			const infoKey = decodeFileName(lower.slice(10));
+			info[infoKey] = decodeFileName(value);
+		}
+	});
+	return info;
 }
-export {
-  buildFileInfoHeaders,
-  decodeFileName,
-  encodeFileName,
-  parseFileInfoHeaders
-};
-//# sourceMappingURL=encoding.js.map
+//#endregion
+export { buildFileInfoHeaders, decodeFileName, encodeFileName, parseFileInfoHeaders };
+
+//# sourceMappingURL=encoding.js.map

package/dist/raw/encoding.js.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.js","sources":["../../src/raw/encoding.ts"],"sourcesContent":["import { utf8Encoder } from '../util/text-codec.ts'\n\n/**\n * Characters that B2 treats as safe (not percent-encoded) in file names.\n *\n * Per the B2 docs, everything except `a-z A-Z 0-9 - . _ ~ / ! $ & ' ( ) * + , ; = : @`\n * must be percent-encoded using UTF-8 byte values.\n */\nconst SAFE_CHARS = new Set(\n  \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/\".split(''),\n)\n\n/**\n * Percent-encodes a file name using the B2-specific encoding rules.\n *\n * Unlike standard `encodeURIComponent`, B2 keeps `/` and several other\n * characters unencoded while encoding all other non-ASCII and special\n * characters as uppercase percent-encoded UTF-8 bytes.\n *\n * @param name - The raw (unencoded) file name.\n *\n * @returns The percent-encoded file name suitable for `X-Bz-File-Name` headers.\n */\nexport function encodeFileName(name: string): string {\n  const encoded: string[] = []\n  for (const char of name) {\n    if (SAFE_CHARS.has(char)) {\n      encoded.push(char)\n    } else {\n      const bytes = utf8Encoder.encode(char)\n      for (const byte of bytes) {\n        encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, '0')}`)\n      }\n    }\n  }\n  return encoded.join('')\n}\n\n/**\n * Decodes a B2 percent-encoded file name back to a plain string.\n *\n * B2 percent-encoding is compatible with standard `decodeURIComponent`,\n * so this is a thin wrapper.\n *\n * @param encoded - The percent-encoded file name from B2.\n *\n * @returns The decoded file name.\n */\nexport function decodeFileName(encoded: string): string {\n  return decodeURIComponent(encoded)\n}\n\n/**\n * Converts a file-info map into `X-Bz-Info-*` HTTP headers.\n *\n * Both keys and values are percent-encoded with {@link encodeFileName}\n * to satisfy B2 header requirements.\n *\n * @param fileInfo - Key/value pairs to attach as custom file info, or `undefined`.\n *\n * @returns A record of header name/value pairs (empty if `fileInfo` is `undefined`).\n */\nexport function buildFileInfoHeaders(\n  fileInfo: Record<string, string> | undefined,\n): Record<string, string> {\n  if (!fileInfo) return {}\n  const headers: Record<string, string> = {}\n  for (const [key, value] of Object.entries(fileInfo)) {\n    headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value)\n  }\n  return headers\n}\n\n/**\n * Extracts custom file-info key/value pairs from B2 response headers.\n *\n * Scans for headers prefixed with `x-bz-info-` and decodes both the\n * key suffix and value using {@link decodeFileName}.\n *\n * @param headers - The HTTP response headers from a B2 download or file-info call.\n *\n * @returns A record of decoded file-info key/value pairs.\n */\nexport function parseFileInfoHeaders(headers: Headers): Record<string, string> {\n  const info: Record<string, string> = {}\n  headers.forEach((value, key) => {\n    const lower = key.toLowerCase()\n    if (lower.startsWith('x-bz-info-')) {\n      const infoKey = decodeFileName(lower.slice('x-bz-info-'.length))\n      info[infoKey] = decodeFileName(value)\n    }\n  })\n  return info\n}\n"],"names":[],"mappings":";AAQA,MAAM,aAAa,IAAI;AAAA,EACrB,mFAAmF,MAAM,EAAE;AAC7F;AAaO,SAAS,eAAe,MAAsB;AACnD,QAAM,UAAoB,CAAA;AAC1B,aAAW,QAAQ,MAAM;AACvB,QAAI,WAAW,IAAI,IAAI,GAAG;AACxB,cAAQ,KAAK,IAAI;AAAA,IACnB,OAAO;AACL,YAAM,QAAQ,YAAY,OAAO,IAAI;AACrC,iBAAW,QAAQ,OAAO;AACxB,gBAAQ,KAAK,IAAI,KAAK,SAAS,EAAE,EAAE,YAAA,EAAc,SAAS,GAAG,GAAG,CAAC,EAAE;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACA,SAAO,QAAQ,KAAK,EAAE;AACxB;AAYO,SAAS,eAAe,SAAyB;AACtD,SAAO,mBAAmB,OAAO;AACnC;AAYO,SAAS,qBACd,UACwB;AACxB,MAAI,CAAC,SAAU,QAAO,CAAA;AACtB,QAAM,UAAkC,CAAA;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACnD,YAAQ,aAAa,eAAe,GAAG,CAAC,EAAE,IAAI,eAAe,KAAK;AAAA,EACpE;AACA,SAAO;AACT;AAYO,SAAS,qBAAqB,SAA0C;AAC7E,QAAM,OAA+B,CAAA;AACrC,UAAQ,QAAQ,CAAC,OAAO,QAAQ;AAC9B,UAAM,QAAQ,IAAI,YAAA;AAClB,QAAI,MAAM,WAAW,YAAY,GAAG;AAClC,YAAM,UAAU,eAAe,MAAM,MAAM,aAAa,MAAM,CAAC;AAC/D,WAAK,OAAO,IAAI,eAAe,KAAK;AAAA,IACtC;AAAA,EACF,CAAC;AACD,SAAO;AACT;"}
+{"version":3,"file":"encoding.js","names":[],"sources":["../../src/raw/encoding.ts"],"sourcesContent":["import { utf8Encoder } from '../util/text-codec.ts'\n\n/**\n * Characters that B2 treats as safe (not percent-encoded) in file names.\n *\n * Per the B2 docs, everything except `a-z A-Z 0-9 - . _ ~ / ! $ & ' ( ) * + , ; = : @`\n * must be percent-encoded using UTF-8 byte values.\n */\nconst SAFE_CHARS = new Set(\n  \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~!$&'()*+,;=:@/\".split(''),\n)\n\n/**\n * Percent-encodes a file name using the B2-specific encoding rules.\n *\n * Unlike standard `encodeURIComponent`, B2 keeps `/` and several other\n * characters unencoded while encoding all other non-ASCII and special\n * characters as uppercase percent-encoded UTF-8 bytes.\n *\n * @param name - The raw (unencoded) file name.\n *\n * @returns The percent-encoded file name suitable for `X-Bz-File-Name` headers.\n */\nexport function encodeFileName(name: string): string {\n  const encoded: string[] = []\n  for (const char of name) {\n    if (SAFE_CHARS.has(char)) {\n      encoded.push(char)\n    } else {\n      const bytes = utf8Encoder.encode(char)\n      for (const byte of bytes) {\n        encoded.push(`%${byte.toString(16).toUpperCase().padStart(2, '0')}`)\n      }\n    }\n  }\n  return encoded.join('')\n}\n\n/**\n * Decodes a B2 percent-encoded file name back to a plain string.\n *\n * B2 percent-encoding is compatible with standard `decodeURIComponent`,\n * so this is a thin wrapper.\n *\n * @param encoded - The percent-encoded file name from B2.\n *\n * @returns The decoded file name.\n */\nexport function decodeFileName(encoded: string): string {\n  return decodeURIComponent(encoded)\n}\n\n/**\n * Converts a file-info map into `X-Bz-Info-*` HTTP headers.\n *\n * Both keys and values are percent-encoded with {@link encodeFileName}\n * to satisfy B2 header requirements.\n *\n * @param fileInfo - Key/value pairs to attach as custom file info, or `undefined`.\n *\n * @returns A record of header name/value pairs (empty if `fileInfo` is `undefined`).\n */\nexport function buildFileInfoHeaders(\n  fileInfo: Record<string, string> | undefined,\n): Record<string, string> {\n  if (!fileInfo) return {}\n  const headers: Record<string, string> = {}\n  for (const [key, value] of Object.entries(fileInfo)) {\n    headers[`X-Bz-Info-${encodeFileName(key)}`] = encodeFileName(value)\n  }\n  return headers\n}\n\n/**\n * Extracts custom file-info key/value pairs from B2 response headers.\n *\n * Scans for headers prefixed with `x-bz-info-` and decodes both the\n * key suffix and value using {@link decodeFileName}.\n *\n * @param headers - The HTTP response headers from a B2 download or file-info call.\n *\n * @returns A record of decoded file-info key/value pairs.\n */\nexport function parseFileInfoHeaders(headers: Headers): Record<string, string> {\n  const info: Record<string, string> = {}\n  headers.forEach((value, key) => {\n    const lower = key.toLowerCase()\n    if (lower.startsWith('x-bz-info-')) {\n      const infoKey = decodeFileName(lower.slice('x-bz-info-'.length))\n      info[infoKey] = decodeFileName(value)\n    }\n  })\n  return info\n}\n"],"mappings":";;;;;;;;AAQA,IAAM,aAAa,IAAI,IACrB,mFAAmF,MAAM,EAAE,CAC7F;;;;;;;;;;;;AAaA,SAAgB,eAAe,MAAsB;CACnD,MAAM,UAAoB,CAAC;CAC3B,KAAK,MAAM,QAAQ,MACjB,IAAI,WAAW,IAAI,IAAI,GACrB,QAAQ,KAAK,IAAI;MACZ;EACL,MAAM,QAAQ,YAAY,OAAO,IAAI;EACrC,KAAK,MAAM,QAAQ,OACjB,QAAQ,KAAK,IAAI,KAAK,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;CAEvE;CAEF,OAAO,QAAQ,KAAK,EAAE;AACxB;;;;;;;;;;;AAYA,SAAgB,eAAe,SAAyB;CACtD,OAAO,mBAAmB,OAAO;AACnC;;;;;;;;;;;AAYA,SAAgB,qBACd,UACwB;CACxB,IAAI,CAAC,UAAU,OAAO,CAAC;CACvB,MAAM,UAAkC,CAAC;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAChD,QAAQ,aAAa,eAAe,GAAG,OAAO,eAAe,KAAK;CAEpE,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,qBAAqB,SAA0C;CAC7E,MAAM,OAA+B,CAAC;CACtC,QAAQ,SAAS,OAAO,QAAQ;EAC9B,MAAM,QAAQ,IAAI,YAAY;EAC9B,IAAI,MAAM,WAAW,YAAY,GAAG;GAClC,MAAM,UAAU,eAAe,MAAM,MAAM,EAAmB,CAAC;GAC/D,KAAK,WAAW,eAAe,KAAK;EACtC;CACF,CAAC;CACD,OAAO;AACT"}