@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

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"}