itd-api 0.4.0 → 0.5.0

package/dist/{multi-storage-C8R5Crwo.cjs → multi-storage-mBuCOVZY.cjs}

@@ -1,4 +1,4 @@
-const require_storage = require("./storage-ycBqLBRB.cjs");
+const require_storage = require("./storage-dF8Tio5y.cjs");
 //#region node_modules/set-cookie-parser/lib/set-cookie.js
 var defaultParseOptions = {
 	decodeValues: true,
@@ -139,6 +139,102 @@ parseSetCookie.parse = parseSetCookie;
 parseSetCookie.parseString = parseString;
 parseSetCookie.splitCookiesString = splitCookiesString;
 //#endregion
+//#region src/core/url.ts
+/**
+* Собирает строку запроса.
+*
+* Правила:
+* - `undefined` и `null` пропускаются целиком — не нужно чистить объект перед вызовом;
+* - `boolean` превращается в `true` / `false`;
+* - массив повторяет ключ (`ids=1&ids=2`).
+*
+* @returns строка вида `?a=1&b=2` либо пустая строка, если параметров нет
+*
+* @example
+* ```ts
+* buildQuery({ tab: 'popular', limit: 20, cursor: undefined });
+* // '?tab=popular&limit=20'
+* ```
+*/
+function buildQuery(params) {
+	if (!params) return "";
+	const search = new URLSearchParams();
+	for (const [key, value] of Object.entries(params)) {
+		if (value === void 0 || value === null) continue;
+		if (Array.isArray(value)) {
+			for (const item of value) {
+				if (item === void 0 || item === null) continue;
+				search.append(key, String(item));
+			}
+			continue;
+		}
+		search.append(key, String(value));
+	}
+	const query = search.toString();
+	return query ? `?${query}` : "";
+}
+/**
+* Кодирует значение для подстановки в путь.
+*
+* Нужно для сегментов, которые могут содержать что угодно, — прежде всего хэштегов
+* в `/api/hashtags/{tag}/posts`.
+*
+* @throws {ItdConfigError} если значение пустое
+*/
+function encodePathSegment(value, name = "параметр пути") {
+	if (typeof value !== "string" || value.trim() === "") throw new require_storage.ItdConfigError(`${name} должен быть непустой строкой, получено: ${JSON.stringify(value)}`);
+	return encodeURIComponent(value);
+}
+/** Хост из URL в нижнем регистре. Пустая строка, если разобрать не удалось. */
+function hostOf(url) {
+	try {
+		return new URL(url).hostname.toLowerCase();
+	} catch {
+		return "";
+	}
+}
+/** Origin из URL — схема, хост и порт. Пустая строка, если разобрать не удалось. */
+function originOf(url) {
+	try {
+		return new URL(url).origin;
+	} catch {
+		return "";
+	}
+}
+/** Тот же хост либо его поддомен. Принимает хосты, а не адреса. */
+function isSameSite(primaryHost, host) {
+	if (!primaryHost || !host) return false;
+	return host === primaryHost || host.endsWith(`.${primaryHost}`);
+}
+/**
+* Склеивает базовый URL и путь.
+*
+* Завершающий слэш пути сохраняется: он значим для `/api/notifications/`
+* и `/api/v1/subscription/`, без него сервер отвечает ошибкой.
+*
+* @example
+* ```ts
+* joinUrl('https://xn--d1ah4a.com/', '/api/notifications/');
+* // 'https://xn--d1ah4a.com/api/notifications/'
+* ```
+*/
+function joinUrl(baseUrl, path) {
+	return `${baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+}
+/** Приводит базовый URL к каноничному виду и проверяет, что он вообще похож на URL. */
+function normalizeBaseUrl(baseUrl) {
+	if (typeof baseUrl !== "string" || baseUrl.trim() === "") throw new require_storage.ItdConfigError(`baseUrl должен быть непустой строкой с абсолютным URL, получено: ${JSON.stringify(baseUrl)}`);
+	let parsed;
+	try {
+		parsed = new URL(baseUrl);
+	} catch {
+		throw new require_storage.ItdConfigError(`baseUrl должен быть абсолютным URL, получено: ${JSON.stringify(baseUrl)}`);
+	}
+	if (parsed.protocol !== "http:" && parsed.protocol !== "https:") throw new require_storage.ItdConfigError(`baseUrl должен использовать http или https, получено: ${parsed.protocol}`);
+	if (parsed.username || parsed.password || parsed.search || parsed.hash) throw new require_storage.ItdConfigError("baseUrl не должен содержать логин, пароль, query-параметры или fragment");
+	return parsed.origin + (parsed.pathname === "/" ? "" : parsed.pathname.replace(/\/$/, ""));
+}
+//#endregion
 //#region src/core/cookies.ts
 /** Имя cookie-флага «есть refresh-сессия». Ставится сайтом итд.com рядом с refresh-токеном. */
 const AUTH_FLAG_COOKIE = "is_auth";
@@ -154,13 +250,6 @@ const REFRESH_COOKIE = "refresh_token";
 const REFRESH_COOKIE_PATH = "/api/v1/auth";
 /** Разделитель origin и содержимого cookie при сериализации. В origin пробелов не бывает. */
 const SERIALIZED_SEPARATOR = " ";
-function originOf(url) {
-	try {
-		return new URL(url).origin;
-	} catch {
-		return "";
-	}
-}
 /** Дата в миллисекунды. Некорректная дата считается отсутствующей, а не `NaN`. */
 function toTimestamp(date) {
 	if (!date) return void 0;
@@ -341,9 +430,9 @@ const FileTransferMode = Object.freeze({
 	Stream: "stream"
 });
 /** Размер очереди потокового вложения по умолчанию — 4 МиБ. */
-const DEFAULT_FILE_STREAM_BUFFER_BYTES = 4 * 1024 * 1024;
+const DEFAULT_FILE_STREAM_BUFFER_BYTES = 4194304;
 /** Предел размера файла, скачиваемого по адресу, — 100 МиБ. */
-const DEFAULT_URL_FILE_MAX_BYTES = 100 * 1024 * 1024;
+const DEFAULT_URL_FILE_MAX_BYTES = 104857600;
 //#endregion
 //#region src/core/attachments/limits.ts
 /** Проверяет числовую границу до обращения к источнику. */
@@ -354,7 +443,8 @@ function optionalBytes(value, name) {
 }
 /** Создаёт типизированную ошибку превышения размера вложения. */
 function fileTooLarge(url, limit, actual) {
-	return new require_storage.ItdFileError(`файл${url ? ` по адресу ${url}` : ""} больше предела в ${limit} байт: ${actual}`, {
+	const source = url ? ` по адресу ${url}` : "";
+	return new require_storage.ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {
 		reason: require_storage.ItdFileErrorReason.TooLarge,
 		...url ? { url } : {},
 		limit,
@@ -530,98 +620,52 @@ function controlledTokenStorage(storage, account) {
 * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
 */
 var MemoryMultiTokenStorage = class {
-	#sessions = /* @__PURE__ */ new Map();
+	#store = new require_storage.MemoryKeyValueStore();
 	constructor(initial) {
-		for (const [account, session] of Object.entries(initial ?? {})) this.#sessions.set(account, require_storage.copySession(session));
+		for (const [account, session] of Object.entries(initial ?? {})) this.#store.set(accountKey(account), require_storage.copySession(session));
 	}
 	get(account) {
-		const session = this.#sessions.get(account);
+		const session = this.#store.get(accountKey(account));
 		return session ? require_storage.copySession(session) : null;
 	}
 	set(account, session) {
-		this.#sessions.set(account, require_storage.copySession(session));
+		this.#store.set(accountKey(account), require_storage.copySession(session));
 	}
 	clear(account) {
-		this.#sessions.delete(account);
+		this.#store.delete(accountKey(account));
 	}
 	accounts() {
-		return [...this.#sessions.keys()];
+		return this.#store.keys(ACCOUNT_KEY_PREFIX).map(accountFromKey);
 	}
 };
-/**
-* Собирает {@link MultiTokenStorage} из четырёх функций — когда заводить класс избыточно.
-* Аналог `createTokenStorage` для нескольких аккаунтов.
-*/
-function createMultiTokenStorage(handlers) {
-	return handlers;
+const ACCOUNT_KEY_PREFIX = "accounts/";
+function accountKey(account) {
+	return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;
 }
-/** Создаёт запись без прототипа: имена `__proto__` и `constructor` остаются обычными ключами. */
-function emptySessionRecord() {
-	return Object.create(null);
-}
-/** Копирует внешний снимок в запись без унаследованных свойств. */
-function normalizeSessionRecord(record) {
-	const normalized = emptySessionRecord();
-	for (const [account, session] of Object.entries(record ?? {})) normalized[account] = require_storage.copySession(session);
-	return normalized;
+function accountFromKey(key) {
+	return decodeURIComponent(key.slice(9));
 }
 /**
-* Мультихранилище поверх источника, который читается и пишется целиком.
-*
-* Решает главную проблему такого способа хранения — **гонку «прочитать, изменить,
-* записать»**: десять аккаунтов пишут в одну запись, и наивная реализация теряла бы
-* чужие сессии. Источник читается один раз, дальше слепок живёт в памяти, а записи
-* выстраиваются в цепочку и идут по очереди.
+* Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.
 *
-* Внутри процесса этого достаточно. Несколько процессов, пишущих в одну запись,
-* по-прежнему затирают друг друга — как и несколько экземпляров этого адаптера,
-* направленных на один источник в одном процессе.
+* Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому
+* запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.
 */
-function createRecordMultiStorage(source) {
-	/** Слепок записи. `undefined` — источник ещё не читался. */
-	let snapshot;
-	/** Общий промис чтения: параллельные вызовы на холодном старте читают источник один раз. */
-	let loading = null;
-	/** Цепочка записей. Ошибка одной не останавливает следующие. */
-	let writing = Promise.resolve();
-	const load = async () => {
-		if (snapshot !== void 0) return snapshot;
-		loading ??= source.read().then((value) => {
-			snapshot = normalizeSessionRecord(value);
-			return snapshot;
-		}).finally(() => {
-			loading = null;
-		});
-		return loading;
-	};
-	const flush = () => {
-		const current = normalizeSessionRecord(snapshot ?? null);
-		const operation = async () => {
-			if (source.remove && Object.keys(current).length === 0) await source.remove();
-			else await source.write(current);
-		};
-		writing = writing.then(operation, operation);
-		return writing;
-	};
+function createMultiTokenStorage(store, options = {}) {
+	const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;
+	if (typeof prefix !== "string") throw new require_storage.ItdConfigError("prefix MultiTokenStorage должен быть строкой");
+	const backend = require_storage.createKeyValueStore(store);
+	if (!require_storage.isEnumerableKeyValueStore(backend)) throw new require_storage.ItdConfigError("MultiTokenStorage требует KeyValueStore с методом keys()");
+	const key = (account) => `${prefix}${encodeURIComponent(account)}`;
 	return {
 		async get(account) {
-			const current = await load();
-			const session = Object.hasOwn(current, account) ? current[account] : void 0;
+			const session = await backend.get(key(account));
 			return session ? require_storage.copySession(session) : null;
 		},
-		async set(account, session) {
-			const current = await load();
-			current[account] = require_storage.copySession(session);
-			await flush();
-		},
-		async clear(account) {
-			const current = await load();
-			if (!Object.hasOwn(current, account)) return;
-			delete current[account];
-			await flush();
-		},
+		set: (account, session) => backend.set(key(account), require_storage.copySession(session)),
+		clear: (account) => backend.delete(key(account)),
 		async accounts() {
-			return Object.keys(await load());
+			return (await require_storage.collectKeyValueStoreKeys(backend, prefix)).map((value) => decodeURIComponent(value.slice(prefix.length)));
 		}
 	};
 }
@@ -680,6 +724,12 @@ Object.defineProperty(exports, "boundedFileStream", {
 		return boundedFileStream;
 	}
 });
+Object.defineProperty(exports, "buildQuery", {
+	enumerable: true,
+	get: function() {
+		return buildQuery;
+	}
+});
 Object.defineProperty(exports, "controlledTokenStorage", {
 	enumerable: true,
 	get: function() {
@@ -692,10 +742,10 @@ Object.defineProperty(exports, "createMultiTokenStorage", {
 		return createMultiTokenStorage;
 	}
 });
-Object.defineProperty(exports, "createRecordMultiStorage", {
+Object.defineProperty(exports, "encodePathSegment", {
 	enumerable: true,
 	get: function() {
-		return createRecordMultiStorage;
+		return encodePathSegment;
 	}
 });
 Object.defineProperty(exports, "fileTooLarge", {
@@ -704,6 +754,12 @@ Object.defineProperty(exports, "fileTooLarge", {
 		return fileTooLarge;
 	}
 });
+Object.defineProperty(exports, "hostOf", {
+	enumerable: true,
+	get: function() {
+		return hostOf;
+	}
+});
 Object.defineProperty(exports, "isBoundedFileStream", {
 	enumerable: true,
 	get: function() {
@@ -722,12 +778,36 @@ Object.defineProperty(exports, "isRestorableSession", {
 		return isRestorableSession;
 	}
 });
+Object.defineProperty(exports, "isSameSite", {
+	enumerable: true,
+	get: function() {
+		return isSameSite;
+	}
+});
+Object.defineProperty(exports, "joinUrl", {
+	enumerable: true,
+	get: function() {
+		return joinUrl;
+	}
+});
+Object.defineProperty(exports, "normalizeBaseUrl", {
+	enumerable: true,
+	get: function() {
+		return normalizeBaseUrl;
+	}
+});
 Object.defineProperty(exports, "optionalBytes", {
 	enumerable: true,
 	get: function() {
 		return optionalBytes;
 	}
 });
+Object.defineProperty(exports, "originOf", {
+	enumerable: true,
+	get: function() {
+		return originOf;
+	}
+});
 Object.defineProperty(exports, "resolveFileStreamOptions", {
 	enumerable: true,
 	get: function() {
@@ -741,4 +821,4 @@ Object.defineProperty(exports, "scopedTokenStorage", {
 	}
 });
 
-//# sourceMappingURL=multi-storage-C8R5Crwo.cjs.map
+//# sourceMappingURL=multi-storage-mBuCOVZY.cjs.map

package/dist/multi-storage-mBuCOVZY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-storage-mBuCOVZY.cjs","names":["ItdConfigError","#byOrigin","#matching","ItdConfigError","ItdFileError","ItdFileErrorReason","ItdConfigError","ItdFileError","ItdFileErrorReason","ItdConfigError","#store","MemoryKeyValueStore","copySession","ItdConfigError","createKeyValueStore","isEnumerableKeyValueStore","collectKeyValueStoreKeys"],"sources":["../node_modules/set-cookie-parser/lib/set-cookie.js","../src/core/url.ts","../src/core/cookies.ts","../src/core/attachments/contracts.ts","../src/core/attachments/limits.ts","../src/core/attachments/bounded-stream.ts","../src/core/attachments/options.ts","../src/core/multi-storage.ts"],"sourcesContent":["var defaultParseOptions = {\n  decodeValues: true,\n  map: false,\n  silent: false,\n  split: \"auto\", // auto = split strings but not arrays\n};\n\nfunction isForbiddenKey(key) {\n  return typeof key !== \"string\" || key in {};\n}\n\nfunction createNullObj() {\n  return Object.create(null);\n}\n\nfunction isNonEmptyString(str) {\n  return typeof str === \"string\" && !!str.trim();\n}\n\nfunction parseString(setCookieValue, options) {\n  var parts = setCookieValue.split(\";\").filter(isNonEmptyString);\n\n  var nameValuePairStr = parts.shift();\n  if (!nameValuePairStr) {\n    return null;\n  }\n  var parsed = parseNameValuePair(nameValuePairStr);\n  var name = parsed.name;\n  var value = parsed.value;\n\n  options = options\n    ? Object.assign({}, defaultParseOptions, options)\n    : defaultParseOptions;\n\n  if (isForbiddenKey(name)) {\n    return null;\n  }\n\n  try {\n    value = options.decodeValues ? decodeURIComponent(value) : value; // decode cookie value\n  } catch (e) {\n    console.error(\n      \"set-cookie-parser: failed to decode cookie value. Set options.decodeValues=false to disable decoding.\",\n      e\n    );\n  }\n\n  var cookie = createNullObj();\n  cookie.name = name;\n  cookie.value = value;\n\n  parts.forEach(function (part) {\n    var sides = part.split(\"=\");\n    var key = sides.shift().trim().toLowerCase();\n    if (isForbiddenKey(key)) {\n      return;\n    }\n    var value = sides.join(\"=\").trim();\n    if (key === \"expires\") {\n      cookie.expires = new Date(value);\n    } else if (key === \"max-age\") {\n      var n = parseInt(value, 10);\n      if (!Number.isNaN(n)) cookie.maxAge = n;\n    } else if (key === \"secure\") {\n      cookie.secure = true;\n    } else if (key === \"httponly\") {\n      cookie.httpOnly = true;\n    } else if (key === \"samesite\") {\n      cookie.sameSite = value;\n    } else if (key === \"partitioned\") {\n      cookie.partitioned = true;\n    } else if (key) {\n      cookie[key] = value;\n    }\n  });\n\n  return cookie;\n}\n\nfunction parseNameValuePair(nameValuePairStr) {\n  // Parses name-value-pair according to rfc6265bis draft\n\n  var name = \"\";\n  var value = \"\";\n  var nameValueArr = nameValuePairStr.split(\"=\");\n  if (nameValueArr.length > 1) {\n    name = nameValueArr.shift();\n    value = nameValueArr.join(\"=\"); // everything after the first =, joined by a \"=\" if there was more than one part\n  } else {\n    value = nameValuePairStr;\n  }\n\n  return { name: name, value: value };\n}\n\nfunction parseSetCookie(input, options) {\n  options = options\n    ? Object.assign({}, defaultParseOptions, options)\n    : defaultParseOptions;\n\n  if (!input) {\n    if (!options.map) {\n      return [];\n    } else {\n      return createNullObj();\n    }\n  }\n\n  if (input.headers) {\n    if (typeof input.headers.getSetCookie === \"function\") {\n      // for fetch responses - they combine headers of the same type in the headers array,\n      // but getSetCookie returns an uncombined array\n      input = input.headers.getSetCookie();\n    } else if (input.headers[\"set-cookie\"]) {\n      // fast-path for node.js (which automatically normalizes header names to lower-case)\n      input = input.headers[\"set-cookie\"];\n    } else {\n      // slow-path for other environments - see #25\n      var sch =\n        input.headers[\n          Object.keys(input.headers).find(function (key) {\n            return key.toLowerCase() === \"set-cookie\";\n          })\n        ];\n      // warn if called on a request-like object with a cookie header rather than a set-cookie header - see #34, 36\n      if (!sch && input.headers.cookie && !options.silent) {\n        console.warn(\n          \"Warning: set-cookie-parser appears to have been called on a request object. It is designed to parse Set-Cookie headers from responses, not Cookie headers from requests. Set the option {silent: true} to suppress this warning.\"\n        );\n      }\n      input = sch;\n    }\n  }\n\n  var split = options.split;\n  var isArray = Array.isArray(input);\n\n  if (split === \"auto\") {\n    split = !isArray;\n  }\n\n  if (!isArray) {\n    input = [input];\n  }\n\n  input = input.filter(isNonEmptyString);\n\n  if (split) {\n    input = input.map(splitCookiesString).flat();\n  }\n\n  if (!options.map) {\n    return input\n      .map(function (str) {\n        return parseString(str, options);\n      })\n      .filter(Boolean);\n  } else {\n    var cookies = createNullObj();\n    return input.reduce(function (cookies, str) {\n      var cookie = parseString(str, options);\n      if (cookie && !isForbiddenKey(cookie.name)) {\n        cookies[cookie.name] = cookie;\n      }\n      return cookies;\n    }, cookies);\n  }\n}\n\n/*\n  Set-Cookie header field-values are sometimes comma joined in one string. This splits them without choking on commas\n  that are within a single set-cookie field-value, such as in the Expires portion.\n\n  This is uncommon, but explicitly allowed - see https://tools.ietf.org/html/rfc2616#section-4.2\n  Node.js does this for every header *except* set-cookie - see https://github.com/nodejs/node/blob/d5e363b77ebaf1caf67cd7528224b651c86815c1/lib/_http_incoming.js#L128\n  React Native's fetch does this for *every* header, including set-cookie.\n\n  Based on: https://github.com/google/j2objc/commit/16820fdbc8f76ca0c33472810ce0cb03d20efe25\n  Credits to: https://github.com/tomball for original and https://github.com/chrusart for JavaScript implementation\n*/\nfunction splitCookiesString(cookiesString) {\n  if (Array.isArray(cookiesString)) {\n    return cookiesString;\n  }\n  if (typeof cookiesString !== \"string\") {\n    return [];\n  }\n\n  var cookiesStrings = [];\n  var pos = 0;\n  var start;\n  var ch;\n  var lastComma;\n  var nextStart;\n  var cookiesSeparatorFound;\n\n  function skipWhitespace() {\n    while (pos < cookiesString.length && /\\s/.test(cookiesString.charAt(pos))) {\n      pos += 1;\n    }\n    return pos < cookiesString.length;\n  }\n\n  function notSpecialChar() {\n    ch = cookiesString.charAt(pos);\n\n    return ch !== \"=\" && ch !== \";\" && ch !== \",\";\n  }\n\n  while (pos < cookiesString.length) {\n    start = pos;\n    cookiesSeparatorFound = false;\n\n    while (skipWhitespace()) {\n      ch = cookiesString.charAt(pos);\n      if (ch === \",\") {\n        // ',' is a cookie separator if we have later first '=', not ';' or ','\n        lastComma = pos;\n        pos += 1;\n\n        skipWhitespace();\n        nextStart = pos;\n\n        while (pos < cookiesString.length && notSpecialChar()) {\n          pos += 1;\n        }\n\n        // currently special character\n        if (pos < cookiesString.length && cookiesString.charAt(pos) === \"=\") {\n          // we found cookies separator\n          cookiesSeparatorFound = true;\n          // pos is inside the next cookie, so back up and return it.\n          pos = nextStart;\n          cookiesStrings.push(cookiesString.substring(start, lastComma));\n          start = pos;\n        } else {\n          // in param ',' or param separator ';',\n          // we continue from that comma\n          pos = lastComma + 1;\n        }\n      } else {\n        pos += 1;\n      }\n    }\n\n    if (!cookiesSeparatorFound || pos >= cookiesString.length) {\n      cookiesStrings.push(cookiesString.substring(start, cookiesString.length));\n    }\n  }\n\n  return cookiesStrings;\n}\n\n// named export for CJS\nparseSetCookie.parseSetCookie = parseSetCookie;\n// for backwards compatibility\nparseSetCookie.parse = parseSetCookie;\nparseSetCookie.parseString = parseString;\nparseSetCookie.splitCookiesString = splitCookiesString;\n\n// EXPORTS\n// (this section is replaced by build-cjs.js)\n\n// named export for ESM\nexport { parseSetCookie };\n// for backwards compatibility\nexport default parseSetCookie;\nexport { parseSetCookie as parse, parseString, splitCookiesString };\n","import { ItdConfigError } from './errors.js';\n\n/** Значение параметра запроса. `undefined` и `null` в строку не попадают. */\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | readonly (string | number | boolean)[];\n\n/** Параметры строки запроса. */\nexport type QueryParams = Record<string, QueryValue>;\n\n/**\n * Собирает строку запроса.\n *\n * Правила:\n * - `undefined` и `null` пропускаются целиком — не нужно чистить объект перед вызовом;\n * - `boolean` превращается в `true` / `false`;\n * - массив повторяет ключ (`ids=1&ids=2`).\n *\n * @returns строка вида `?a=1&b=2` либо пустая строка, если параметров нет\n *\n * @example\n * ```ts\n * buildQuery({ tab: 'popular', limit: 20, cursor: undefined });\n * // '?tab=popular&limit=20'\n * ```\n */\nexport function buildQuery(params?: QueryParams): string {\n  if (!params) return '';\n\n  const search = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        if (item === undefined || item === null) continue;\n        search.append(key, String(item));\n      }\n      continue;\n    }\n\n    search.append(key, String(value));\n  }\n\n  const query = search.toString();\n  return query ? `?${query}` : '';\n}\n\n/**\n * Кодирует значение для подстановки в путь.\n *\n * Нужно для сегментов, которые могут содержать что угодно, — прежде всего хэштегов\n * в `/api/hashtags/{tag}/posts`.\n *\n * @throws {ItdConfigError} если значение пустое\n */\nexport function encodePathSegment(value: string, name = 'параметр пути'): string {\n  if (typeof value !== 'string' || value.trim() === '') {\n    throw new ItdConfigError(\n      `${name} должен быть непустой строкой, получено: ${JSON.stringify(value)}`,\n    );\n  }\n  return encodeURIComponent(value);\n}\n\n/** Хост из URL в нижнем регистре. Пустая строка, если разобрать не удалось. */\nexport function hostOf(url: string): string {\n  try {\n    return new URL(url).hostname.toLowerCase();\n  } catch {\n    return '';\n  }\n}\n\n/** Origin из URL — схема, хост и порт. Пустая строка, если разобрать не удалось. */\nexport function originOf(url: string): string {\n  try {\n    return new URL(url).origin;\n  } catch {\n    return '';\n  }\n}\n\n/** Тот же хост либо его поддомен. Принимает хосты, а не адреса. */\nexport function isSameSite(primaryHost: string, host: string): boolean {\n  if (!primaryHost || !host) return false;\n  return host === primaryHost || host.endsWith(`.${primaryHost}`);\n}\n\n/**\n * Склеивает базовый URL и путь.\n *\n * Завершающий слэш пути сохраняется: он значим для `/api/notifications/`\n * и `/api/v1/subscription/`, без него сервер отвечает ошибкой.\n *\n * @example\n * ```ts\n * joinUrl('https://xn--d1ah4a.com/', '/api/notifications/');\n * // 'https://xn--d1ah4a.com/api/notifications/'\n * ```\n */\nexport function joinUrl(baseUrl: string, path: string): string {\n  const base = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n  const suffix = path.startsWith('/') ? path : `/${path}`;\n  return `${base}${suffix}`;\n}\n\n/** Приводит базовый URL к каноничному виду и проверяет, что он вообще похож на URL. */\nexport function normalizeBaseUrl(baseUrl: string): string {\n  if (typeof baseUrl !== 'string' || baseUrl.trim() === '') {\n    throw new ItdConfigError(\n      `baseUrl должен быть непустой строкой с абсолютным URL, получено: ${JSON.stringify(baseUrl)}`,\n    );\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(baseUrl);\n  } catch {\n    throw new ItdConfigError(\n      `baseUrl должен быть абсолютным URL, получено: ${JSON.stringify(baseUrl)}`,\n    );\n  }\n\n  if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n    throw new ItdConfigError(\n      `baseUrl должен использовать http или https, получено: ${parsed.protocol}`,\n    );\n  }\n\n  if (parsed.username || parsed.password || parsed.search || parsed.hash) {\n    throw new ItdConfigError(\n      'baseUrl не должен содержать логин, пароль, query-параметры или fragment',\n    );\n  }\n\n  return parsed.origin + (parsed.pathname === '/' ? '' : parsed.pathname.replace(/\\/$/, ''));\n}\n","import { parse as parseSetCookie, splitCookiesString } from 'set-cookie-parser';\nimport { originOf } from './url.js';\n\n/** Cookie, сохранённая в jar. */\ninterface StoredCookie {\n  name: string;\n  value: string;\n  path: string;\n  /** Момент истечения, мс с начала эпохи. `undefined` — сессионная cookie. */\n  expires: number | undefined;\n  secure: boolean;\n}\n\n/** Имя cookie-флага «есть refresh-сессия». Ставится сайтом итд.com рядом с refresh-токеном. */\nexport const AUTH_FLAG_COOKIE = 'is_auth';\n\n/**\n * Имя cookie с refresh-токеном.\n *\n * `POST /api/v1/auth/refresh` читает токен **только отсюда** — тело запроса сервер игнорирует.\n * Cookie помечена `HttpOnly`, поэтому в браузере её не прочитать и не выставить; вне браузера\n * она проходит через jar, и туда же кладётся токен, переданный строкой.\n */\nexport const REFRESH_COOKIE = 'refresh_token';\n\n/** Путь, которым сервер ограничивает {@link REFRESH_COOKIE}. */\nexport const REFRESH_COOKIE_PATH = '/api/v1/auth';\n\n/** Разделитель origin и содержимого cookie при сериализации. В origin пробелов не бывает. */\nconst SERIALIZED_SEPARATOR = ' ';\n\n/** Дата в миллисекунды. Некорректная дата считается отсутствующей, а не `NaN`. */\nfunction toTimestamp(date: Date | undefined): number | undefined {\n  if (!date) return undefined;\n  const time = date.getTime();\n  return Number.isFinite(time) ? time : undefined;\n}\n\nfunction pathOf(url: string): string {\n  try {\n    return new URL(url).pathname || '/';\n  } catch {\n    return '/';\n  }\n}\n\n/**\n * Подходит ли путь cookie запросу.\n *\n * Правило из RFC 6265: путь cookie должен быть префиксом пути запроса, причём граница\n * должна проходить по сегменту — `/api` не подходит запросу `/apiary`.\n */\nfunction pathMatches(cookiePath: string, requestPath: string): boolean {\n  if (cookiePath === '/' || cookiePath === requestPath) return true;\n  if (!requestPath.startsWith(cookiePath)) return false;\n  return cookiePath.endsWith('/') || requestPath[cookiePath.length] === '/';\n}\n\n/**\n * Минимальное хранилище cookie для сред без своего.\n *\n * Refresh-токен итд.com приходит в `Set-Cookie`, а `fetch` вне браузера cookie не хранит —\n * без jar сессию не продлить. В браузере и React Native не используется: там cookie ведёт\n * сама среда.\n *\n * Реализована практическая часть RFC 6265: origin, путь, срок жизни, флаг `Secure`.\n * Доменные cookie для поддоменов намеренно не поддерживаются — API работает с одного хоста.\n */\nexport class CookieJar {\n  readonly #byOrigin = new Map<string, Map<string, StoredCookie>>();\n\n  /**\n   * Забирает `Set-Cookie` из ответа.\n   *\n   * Использует `Headers.getSetCookie()`, где он есть (Node 20+, undici). В остальных средах\n   * заголовки склеены в одну строку, и её нельзя резать по запятой напрямую: запятая есть\n   * внутри `Expires=Wed, 09 Jun 2027 …`. Разделением занимается `set-cookie-parser`.\n   */\n  setFromResponse(url: string, response: Response): void {\n    const headers = response.headers as Headers & { getSetCookie?: () => string[] };\n\n    const raw =\n      typeof headers.getSetCookie === 'function'\n        ? headers.getSetCookie()\n        : splitCookiesString(headers.get('set-cookie') ?? '');\n\n    if (raw.length > 0) this.setFromStrings(url, raw);\n  }\n\n  /**\n   * Кладёт cookie напрямую, минуя `Set-Cookie`.\n   *\n   * Нужно ровно в одном случае: пользователь передал refresh-токен строкой, а сервер читает\n   * его только из cookie. Значение не кодируется — оно уходит в заголовок как есть.\n   */\n  set(url: string, name: string, value: string, path = '/'): void {\n    this.setFromStrings(url, [`${name}=${value}; Path=${path}`]);\n  }\n\n  /** Сохраняет cookie из готовых строк `Set-Cookie`. */\n  setFromStrings(url: string, setCookieStrings: string[]): void {\n    const origin = originOf(url);\n    if (!origin) return;\n\n    const jar = this.#byOrigin.get(origin) ?? new Map<string, StoredCookie>();\n\n    for (const parsed of parseSetCookie(setCookieStrings)) {\n      // Битую дату (её легко получить, если заголовки склеены неправильно) считаем\n      // отсутствующей: сессионная cookie лучше, чем cookie со сроком NaN, которая\n      // не истекает и одновременно нигде не находится.\n      const expires = toTimestamp(parsed.expires);\n      const maxAgeExpires =\n        typeof parsed.maxAge === 'number' && Number.isFinite(parsed.maxAge)\n          ? Date.now() + parsed.maxAge * 1000\n          : undefined;\n\n      // Max-Age приоритетнее Expires — так требует RFC 6265.\n      const expiresAt = maxAgeExpires ?? expires;\n\n      // Удаление cookie сервером: срок в прошлом либо Max-Age=0.\n      if (expiresAt !== undefined && expiresAt <= Date.now()) {\n        jar.delete(parsed.name);\n        continue;\n      }\n\n      jar.set(parsed.name, {\n        name: parsed.name,\n        value: parsed.value,\n        path: parsed.path ?? '/',\n        expires: expiresAt,\n        secure: parsed.secure ?? false,\n      });\n    }\n\n    this.#byOrigin.set(origin, jar);\n  }\n\n  /**\n   * Собирает значение заголовка `Cookie` для запроса.\n   *\n   * @returns строка вида `a=1; b=2` либо `undefined`, если подходящих cookie нет\n   */\n  getHeader(url: string): string | undefined {\n    const cookies = this.#matching(url);\n    if (cookies.length === 0) return undefined;\n    return cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join('; ');\n  }\n\n  /**\n   * Значение действующей cookie.\n   *\n   * Нужно, чтобы забрать обновлённый refresh-токен: сервер ротирует его при каждом\n   * продлении сессии, и сохранять надо именно новое значение.\n   *\n   * @param url если указан, учитываются origin, путь и флаг `Secure`\n   */\n  getValue(name: string, url?: string): string | undefined {\n    if (url) return this.#matching(url).find((cookie) => cookie.name === name)?.value;\n\n    const now = Date.now();\n    for (const jar of this.#byOrigin.values()) {\n      const cookie = jar.get(name);\n      if (cookie && (cookie.expires === undefined || cookie.expires > now)) return cookie.value;\n    }\n    return undefined;\n  }\n\n  /**\n   * Есть ли действующая cookie с таким именем.\n   *\n   * Используется для проверки флага {@link AUTH_FLAG_COOKIE} перед запросом обновления\n   * токена: у анонима refresh-сессии нет, и дёргать API незачем.\n   */\n  has(name: string, url?: string): boolean {\n    if (url) return this.#matching(url).some((cookie) => cookie.name === name);\n\n    const now = Date.now();\n    for (const jar of this.#byOrigin.values()) {\n      const cookie = jar.get(name);\n      if (cookie && (cookie.expires === undefined || cookie.expires > now)) return true;\n    }\n    return false;\n  }\n\n  /** Сохраняет содержимое jar для записи в {@link TokenStorage}. */\n  serialize(): string[] {\n    const result: string[] = [];\n    const now = Date.now();\n\n    for (const [origin, jar] of this.#byOrigin) {\n      for (const cookie of jar.values()) {\n        if (cookie.expires !== undefined && cookie.expires <= now) continue;\n\n        const parts = [`${cookie.name}=${cookie.value}`, `Path=${cookie.path}`];\n        if (cookie.expires !== undefined) {\n          parts.push(`Expires=${new Date(cookie.expires).toUTCString()}`);\n        }\n        if (cookie.secure) parts.push('Secure');\n\n        result.push(`${origin}${SERIALIZED_SEPARATOR}${parts.join('; ')}`);\n      }\n    }\n\n    return result;\n  }\n\n  /** Восстанавливает jar из результата {@link serialize}. Некорректные записи молча пропускаются. */\n  deserialize(entries: readonly string[] | undefined): void {\n    if (!entries) return;\n\n    for (const entry of entries) {\n      const separatorAt = entry.indexOf(SERIALIZED_SEPARATOR);\n      if (separatorAt <= 0) continue;\n\n      const origin = entry.slice(0, separatorAt);\n      const setCookie = entry.slice(separatorAt + 1);\n      if (!originOf(origin)) continue;\n\n      this.setFromStrings(origin, [setCookie]);\n    }\n  }\n\n  /** Удаляет все cookie. */\n  clear(): void {\n    this.#byOrigin.clear();\n  }\n\n  /** Действующие cookie, подходящие запросу: тот же origin, подходящий путь, не истёкшие. */\n  #matching(url: string): StoredCookie[] {\n    const origin = originOf(url);\n    const jar = this.#byOrigin.get(origin);\n    if (!jar) return [];\n\n    const isSecureRequest = origin.startsWith('https:');\n    const requestPath = pathOf(url);\n    const now = Date.now();\n    const result: StoredCookie[] = [];\n\n    for (const cookie of jar.values()) {\n      if (cookie.expires !== undefined && cookie.expires <= now) {\n        jar.delete(cookie.name);\n        continue;\n      }\n      if (cookie.secure && !isSecureRequest) continue;\n      if (!pathMatches(cookie.path, requestPath)) continue;\n\n      result.push(cookie);\n    }\n\n    return result;\n  }\n}\n","/** Способ передачи содержимого вложения. */\nexport const FileTransferMode = Object.freeze({\n  /** Сначала получить файл целиком, затем отправить его как `Blob`. */\n  Buffer: 'buffer',\n  /** Передавать данные по мере чтения, не собирая файл целиком в памяти. */\n  Stream: 'stream',\n} as const);\nexport type FileTransferMode = (typeof FileTransferMode)[keyof typeof FileTransferMode];\n\n/** Размер очереди потокового вложения по умолчанию — 4 МиБ. */\nexport const DEFAULT_FILE_STREAM_BUFFER_BYTES = 4 * 1024 * 1024;\n\n/** Предел размера файла, скачиваемого по адресу, — 100 МиБ. */\nexport const DEFAULT_URL_FILE_MAX_BYTES = 100 * 1024 * 1024;\n\n/** Что доступно источнику при открытии файла. */\nexport interface FileContext {\n  /** Общая отмена текущей попытки, включая её таймаут. */\n  signal?: AbortSignal | undefined;\n  /** `fetch` клиента — с переданными пользователем настройками. */\n  fetch: typeof fetch;\n  /** Номер попытки отправки, начиная с 1. */\n  attempt: number;\n}\n\n/** Готовое содержимое файла. */\nexport interface FileContent {\n  file: Blob | ArrayBuffer | Uint8Array;\n  /** Имя влияет на определение MIME, если `contentType` не задан. */\n  filename?: string | undefined;\n  /** MIME без параметров. Если не указан, определяется по имени или `Blob`. */\n  contentType?: string | undefined;\n}\n\n/** Открытый поток файла. */\nexport interface FileStreamContent {\n  stream: ReadableStream<Uint8Array>;\n  filename?: string | undefined;\n  contentType?: string | undefined;\n  /** Размер, если он известен до чтения. */\n  size?: number | undefined;\n  /** Освобождает внешний ресурс после завершения попытки. */\n  close?: (() => void | Promise<void>) | undefined;\n}\n\n/** Буферный источник, который вычисляется непосредственно перед первой попыткой. */\nexport interface LazyFile {\n  load: (context: FileContext) => FileContent | Promise<FileContent>;\n}\n\n/**\n * Повторяемый потоковый источник.\n *\n * `open` вызывается для каждой попытки отправки. Он обязан возвращать новый поток:\n * уже прочитанный `ReadableStream` повторно использовать нельзя.\n */\nexport interface StreamFile {\n  open: (context: FileContext) => FileStreamContent | Promise<FileStreamContent>;\n}\n\n/** Общие настройки потоковой передачи. */\nexport interface FileStreamOptions {\n  /** Буферный или потоковый режим. По умолчанию `'buffer'`. */\n  mode?: FileTransferMode | undefined;\n  /** Максимальный размер файла. Без значения размер не ограничивается. */\n  maxBytes?: number | undefined;\n  /**\n   * Верхняя граница очереди, которой управляет библиотека. По умолчанию 4 МиБ.\n   *\n   * Сетевой рантайм может иметь собственные внутренние буферы сверх этого значения.\n   */\n  streamBufferBytes?: number | undefined;\n}\n\n/** Файл, который нужно получить по HTTP(S). */\nexport interface UrlFile extends UrlFileOptions {\n  url: string;\n}\n\n/** Настройки файла по HTTP(S). */\nexport interface UrlFileOptions extends FileStreamOptions {\n  filename?: string | undefined;\n  /** По умолчанию берётся из `Content-Type` ответа. */\n  contentType?: string | undefined;\n}\n\n/** Файл для загрузки. Голый поток не принимается, потому что его нельзя повторить. */\nexport type FileInput =\n  | Blob\n  | ArrayBuffer\n  | Uint8Array\n  | FileContent\n  | UrlFile\n  | LazyFile\n  | StreamFile;\n\n/** Настройки фабрики пользовательского потока. */\nexport interface FromStreamOptions extends Omit<FileStreamOptions, 'mode'> {\n  filename?: string | undefined;\n  contentType?: string | undefined;\n  /** Размер, если он известен заранее. */\n  size?: number | undefined;\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.js';\n\n/** Проверяет числовую границу до обращения к источнику. */\nexport function optionalBytes(value: number | undefined, name: string): number | undefined {\n  if (value === undefined) return undefined;\n  if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) {\n    throw new ItdConfigError(\n      `${name} должен быть неотрицательным целым числом, получено: ${value}`,\n    );\n  }\n  return value;\n}\n\n/** Создаёт типизированную ошибку превышения размера вложения. */\nexport function fileTooLarge(url: string | undefined, limit: number, actual: number): ItdFileError {\n  const source = url ? ` по адресу ${url}` : '';\n  return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {\n    reason: ItdFileErrorReason.TooLarge,\n    ...(url ? { url } : {}),\n    limit,\n    actual,\n  });\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.js';\nimport { DEFAULT_FILE_STREAM_BUFFER_BYTES } from './contracts.js';\nimport { fileTooLarge, optionalBytes } from './limits.js';\n\n/** Потоки, на которые уже наложены счётчик размера и backpressure. */\nconst BOUNDED_FILE_STREAMS = new WeakSet<ReadableStream<Uint8Array>>();\n\n/** Настройки ограничивающей поток обёртки. */\nexport interface BoundedFileStreamOptions {\n  maxBytes?: number | undefined;\n  streamBufferBytes?: number | undefined;\n  signal?: AbortSignal | undefined;\n  url?: string | undefined;\n  retryableRead?: boolean | undefined;\n}\n\n/** Приводит произвольный чанк потока к байтам. */\nfunction asBytes(value: Uint8Array): Uint8Array {\n  return value instanceof Uint8Array ? value : new Uint8Array(value);\n}\n\n/** Проверяет значение без обращения к методам потенциально чужого объекта. */\nexport function isReadableByteStream(value: unknown): value is ReadableStream<Uint8Array> {\n  return typeof ReadableStream !== 'undefined' && value instanceof ReadableStream;\n}\n\n/**\n * Ограничивает размер и очередь потока. Отмена результирующего потока отменяет исходный.\n *\n * @internal\n */\nexport function boundedFileStream(\n  source: ReadableStream<Uint8Array>,\n  options: BoundedFileStreamOptions = {},\n): ReadableStream<Uint8Array> {\n  const maxBytes = optionalBytes(options.maxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  const reader = source.getReader();\n  let total = 0;\n  let finished = false;\n  let abortListener: (() => void) | undefined;\n\n  const cleanup = () => {\n    if (abortListener) options.signal?.removeEventListener('abort', abortListener);\n    abortListener = undefined;\n  };\n\n  const stream = new ReadableStream<Uint8Array>(\n    {\n      start(controller) {\n        if (!options.signal) return;\n        abortListener = () => {\n          finished = true;\n          void reader.cancel(options.signal?.reason).catch(() => {});\n          controller.error(options.signal?.reason ?? new DOMException('Aborted', 'AbortError'));\n          cleanup();\n        };\n        if (options.signal.aborted) abortListener();\n        else options.signal.addEventListener('abort', abortListener, { once: true });\n      },\n      async pull(controller) {\n        if (finished) return;\n\n        try {\n          const next = await reader.read();\n          if (finished) return;\n          if (next.done) {\n            finished = true;\n            cleanup();\n            controller.close();\n            return;\n          }\n\n          const chunk = asBytes(next.value);\n          total += chunk.byteLength;\n          if (maxBytes !== undefined && total > maxBytes) {\n            finished = true;\n            await reader.cancel().catch(() => {});\n            cleanup();\n            controller.error(fileTooLarge(options.url, maxBytes, total));\n            return;\n          }\n\n          controller.enqueue(chunk);\n        } catch (error) {\n          finished = true;\n          cleanup();\n          if (error instanceof ItdFileError) {\n            controller.error(error);\n            return;\n          }\n          controller.error(\n            new ItdFileError('не удалось прочитать поток вложения', {\n              reason: ItdFileErrorReason.Read,\n              ...(options.url ? { url: options.url } : {}),\n              retryable: options.retryableRead ?? false,\n              cause: error,\n            }),\n          );\n        }\n      },\n      async cancel(reason) {\n        finished = true;\n        cleanup();\n        await reader.cancel(reason).catch(() => {});\n      },\n    },\n    {\n      highWaterMark: streamBufferBytes,\n      size: (chunk) => chunk.byteLength,\n    },\n  );\n  BOUNDED_FILE_STREAMS.add(stream);\n  return stream;\n}\n\n/** Наложены ли на поток ограничения библиотеки. @internal */\nexport function isBoundedFileStream(stream: ReadableStream<Uint8Array>): boolean {\n  return BOUNDED_FILE_STREAMS.has(stream);\n}\n","import { ItdConfigError } from '../errors.js';\nimport {\n  DEFAULT_FILE_STREAM_BUFFER_BYTES,\n  type FileStreamOptions,\n  FileTransferMode,\n} from './contracts.js';\nimport { optionalBytes } from './limits.js';\n\n/** Проверяет и дополняет настройки потока. @internal */\nexport function resolveFileStreamOptions(\n  options: FileStreamOptions,\n  defaultMaxBytes?: number,\n): {\n  mode: FileTransferMode;\n  maxBytes: number | undefined;\n  streamBufferBytes: number;\n} {\n  const mode = options.mode ?? FileTransferMode.Buffer;\n  if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) {\n    throw new ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);\n  }\n  if (mode === FileTransferMode.Stream && typeof ReadableStream === 'undefined') {\n    throw new ItdConfigError(\n      \"эта среда не поддерживает ReadableStream; используйте mode: 'buffer'\",\n    );\n  }\n\n  const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  return { mode, maxBytes, streamBufferBytes };\n}\n","import { AUTH_FLAG_COOKIE, CookieJar } from './cookies.js';\nimport { ItdConfigError } from './errors.js';\nimport {\n  collectKeyValueStoreKeys,\n  createKeyValueStore,\n  type EnumerableKeyValueStore,\n  isEnumerableKeyValueStore,\n  MemoryKeyValueStore,\n} from './key-value-store.js';\nimport { copySession, type ItdSession, type TokenStorage } from './storage.js';\n\n/**\n * Хранилище сессий нескольких аккаунтов.\n *\n * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:\n * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,\n * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:\n * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения\n * на длину ключа остаются за адаптером.\n *\n * Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Хранилище поверх enumerable Redis backend\n * ```ts\n * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport interface MultiTokenStorage {\n  /** Прочитать сессию аккаунта. `null`, если её нет. */\n  get(account: string): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию аккаунта целиком. */\n  set(account: string, session: ItdSession): void | Promise<void>;\n  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(account: string): void | Promise<void>;\n  /**\n   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов\n   * после перезапуска процесса.\n   *\n   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,\n   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.\n   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после\n   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.\n   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть\n   * доступны по имени.\n   */\n  accounts(): readonly string[] | Promise<readonly string[]>;\n}\n\n/**\n * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает\n * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.\n */\nexport function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage {\n  return {\n    get: () => storage.get(account),\n    set: (session) => storage.set(account, session),\n    clear: () => storage.clear(account),\n  };\n}\n\n/**\n * Можно ли восстановить авторизованный аккаунт из записи.\n *\n * Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет\n * выполнить ни одного авторизованного запроса.\n *\n * @internal\n */\nexport function isRestorableSession(session: ItdSession | null): session is ItdSession {\n  if (!session) return false;\n  if (session.accessToken || session.refreshToken) return true;\n\n  const jar = new CookieJar();\n  jar.deserialize(session.cookies);\n  return jar.has(AUTH_FLAG_COOKIE);\n}\n\n/**\n * Управляемый срез хранилища для клиента аккаунта.\n *\n * После `revoke()` новые записи не доходят до общего хранилища, а `drain()` позволяет\n * дождаться уже начатых. Так удалённый клиент или завершившийся с опозданием refresh\n * не воскресят сессию после `removeAccount(..., { forget: true })`.\n *\n * @internal\n */\nexport interface ControlledTokenStorage {\n  storage: TokenStorage;\n  revoke(): void;\n  drain(): Promise<void>;\n}\n\n/** @internal */\nexport function controlledTokenStorage(\n  storage: MultiTokenStorage,\n  account: string,\n): ControlledTokenStorage {\n  let revoked = false;\n  const pending = new Set<Promise<void>>();\n\n  const mutate = (operation: () => void | Promise<void>): Promise<void> => {\n    if (revoked) return Promise.resolve();\n\n    const promise = Promise.resolve().then(operation);\n    pending.add(promise);\n    void promise.then(\n      () => pending.delete(promise),\n      () => pending.delete(promise),\n    );\n    return promise;\n  };\n\n  return {\n    storage: {\n      get: () => (revoked ? null : storage.get(account)),\n      set: (session) => mutate(() => storage.set(account, session)),\n      clear: () => mutate(() => storage.clear(account)),\n    },\n    revoke() {\n      revoked = true;\n    },\n    async drain() {\n      await Promise.all([...pending]);\n    },\n  };\n}\n\n/**\n * Мультихранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`\n * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.\n */\nexport class MemoryMultiTokenStorage implements MultiTokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: Readonly<Record<string, ItdSession>> | null) {\n    for (const [account, session] of Object.entries(initial ?? {})) {\n      this.#store.set(accountKey(account), copySession(session));\n    }\n  }\n\n  get(account: string): ItdSession | null {\n    const session = this.#store.get(accountKey(account));\n    return session ? copySession(session) : null;\n  }\n\n  set(account: string, session: ItdSession): void {\n    this.#store.set(accountKey(account), copySession(session));\n  }\n\n  clear(account: string): void {\n    this.#store.delete(accountKey(account));\n  }\n\n  accounts(): string[] {\n    return this.#store.keys(ACCOUNT_KEY_PREFIX).map(accountFromKey);\n  }\n}\n\nconst ACCOUNT_KEY_PREFIX = 'accounts/';\n\nfunction accountKey(account: string): string {\n  return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;\n}\n\nfunction accountFromKey(key: string): string {\n  return decodeURIComponent(key.slice(ACCOUNT_KEY_PREFIX.length));\n}\n\n/** Настройки доменного адаптера нескольких сессий. */\nexport interface MultiTokenStorageAdapterOptions {\n  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */\n  prefix?: string | undefined;\n}\n\n/**\n * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.\n *\n * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому\n * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.\n */\nexport function createMultiTokenStorage(\n  store: EnumerableKeyValueStore<ItdSession>,\n  options: MultiTokenStorageAdapterOptions = {},\n): MultiTokenStorage {\n  const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;\n  if (typeof prefix !== 'string') {\n    throw new ItdConfigError('prefix MultiTokenStorage должен быть строкой');\n  }\n  const backend = createKeyValueStore(store);\n  if (!isEnumerableKeyValueStore(backend)) {\n    throw new ItdConfigError('MultiTokenStorage требует KeyValueStore с методом keys()');\n  }\n  const key = (account: string) => `${prefix}${encodeURIComponent(account)}`;\n  return {\n    async get(account) {\n      const session = await backend.get(key(account));\n      return session ? copySession(session) : null;\n    },\n    set: (account, session) => backend.set(key(account), copySession(session)),\n    clear: (account) => backend.delete(key(account)),\n    async accounts() {\n      const keys = await collectKeyValueStoreKeys(backend, prefix);\n      return keys.map((value) => decodeURIComponent(value.slice(prefix.length)));\n    },\n  };\n}\n"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/{multi-storage-DP_ujJw1.d.cts → multi-storage-s_PcWPGH.d.cts}

@@ -1,4 +1,4 @@
-import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.cjs";
+import { o as EnumerableKeyValueStore, r as TokenStorage, t as ItdSession } from "./storage-Doe3lpFQ.cjs";
 //#region src/core/attachments/contracts.d.ts
 /** Способ передачи содержимого вложения. */
 declare const FileTransferMode: Readonly<{
@@ -97,20 +97,9 @@ interface FromStreamOptions extends Omit<FileStreamOptions, 'mode'> {
  *
  * Все методы могут быть как синхронными, так и асинхронными.
  *
- * @example Своё хранилище поверх Redis
+ * @example Хранилище поверх enumerable Redis backend
  * ```ts
- * const storage = createMultiTokenStorage({
- *   get: async (account) => JSON.parse((await redis.get(`itd:session:${account}`)) ?? 'null'),
- *   set: async (account, session) => {
- *     await redis.set(`itd:session:${account}`, JSON.stringify(session));
- *     await redis.sadd('itd:accounts', account);
- *   },
- *   clear: async (account) => {
- *     await redis.del(`itd:session:${account}`);
- *     await redis.srem('itd:accounts', account);
- *   },
- *   accounts: () => redis.smembers('itd:accounts'),
- * });
+ * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));
  * ```
  */
 interface MultiTokenStorage {
@@ -152,33 +141,18 @@ declare class MemoryMultiTokenStorage implements MultiTokenStorage {
   clear(account: string): void;
   accounts(): string[];
 }
-/**
- * Собирает {@link MultiTokenStorage} из четырёх функций — когда заводить класс избыточно.
- * Аналог `createTokenStorage` для нескольких аккаунтов.
- */
-declare function createMultiTokenStorage(handlers: MultiTokenStorage): MultiTokenStorage;
-/** Источник, который читается и пишется целиком: файл, ключ в `localStorage`, строка в БД. */
-interface RecordStorageSource {
-  /** Прочитать все сессии разом. `null` — записи ещё нет. */
-  read(): Promise<Record<string, ItdSession> | null>;
-  /** Записать все сессии разом. */
-  write(record: Record<string, ItdSession>): Promise<void>;
-  /** Вызывается вместо {@link RecordStorageSource.write}, когда не осталось ни одной сессии. */
-  remove?(): Promise<void>;
+/** Настройки доменного адаптера нескольких сессий. */
+interface MultiTokenStorageAdapterOptions {
+  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */
+  prefix?: string | undefined;
 }
 /**
- * Мультихранилище поверх источника, который читается и пишется целиком.
- *
- * Решает главную проблему такого способа хранения — **гонку «прочитать, изменить,
- * записать»**: десять аккаунтов пишут в одну запись, и наивная реализация теряла бы
- * чужие сессии. Источник читается один раз, дальше слепок живёт в памяти, а записи
- * выстраиваются в цепочку и идут по очереди.
+ * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.
  *
- * Внутри процесса этого достаточно. Несколько процессов, пишущих в одну запись,
- * по-прежнему затирают друг друга — как и несколько экземпляров этого адаптера,
- * направленных на один источник в одном процессе.
+ * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому
+ * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.
  */
-declare function createRecordMultiStorage(source: RecordStorageSource): MultiTokenStorage;
+declare function createMultiTokenStorage(store: EnumerableKeyValueStore<ItdSession>, options?: MultiTokenStorageAdapterOptions): MultiTokenStorage;
 //#endregion
-export { StreamFile as _, createRecordMultiStorage as a, DEFAULT_URL_FILE_MAX_BYTES as c, FileInput as d, FileStreamContent as f, LazyFile as g, FromStreamOptions as h, createMultiTokenStorage as i, FileContent as l, FileTransferMode as m, MultiTokenStorage as n, scopedTokenStorage as o, FileStreamOptions as p, RecordStorageSource as r, DEFAULT_FILE_STREAM_BUFFER_BYTES as s, MemoryMultiTokenStorage as t, FileContext as u, UrlFile as v, UrlFileOptions as y };
-//# sourceMappingURL=multi-storage-DP_ujJw1.d.cts.map
+export { UrlFile as _, scopedTokenStorage as a, FileContent as c, FileStreamContent as d, FileStreamOptions as f, StreamFile as g, LazyFile as h, createMultiTokenStorage as i, FileContext as l, FromStreamOptions as m, MultiTokenStorage as n, DEFAULT_FILE_STREAM_BUFFER_BYTES as o, FileTransferMode as p, MultiTokenStorageAdapterOptions as r, DEFAULT_URL_FILE_MAX_BYTES as s, MemoryMultiTokenStorage as t, FileInput as u, UrlFileOptions as v };
+//# sourceMappingURL=multi-storage-s_PcWPGH.d.cts.map