itd-api 0.0.7 → 0.0.8

package/dist/{chunk-3RNNZJZ4.cjs → chunk-ATCZ4T2K.cjs}

@@ -1295,13 +1295,23 @@ function readAccessToken(payload) {
   const token = payload.accessToken;
   return typeof token === "string" && token.length > 0 ? token : void 0;
 }
+function reportListenerError(logger, scope, error) {
+  const message = `\u041E\u0448\u0438\u0431\u043A\u0430 \u0432 \u043E\u0431\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0435 \u0441\u043E\u0431\u044B\u0442\u0438\u044F ${scope}`;
+  if (logger) logger.error(message, error);
+  else console.error(`[itd-api] ${message}`, error);
+}
 var AuthManager = class {
   #config;
-  #http;
+  #send;
   #jar;
-  #emitter = new Emitter();
+  #emitter;
   /** `undefined` — сессия ещё не читалась из хранилища. */
   #session;
+  /**
+   * Общий промис чтения сессии из хранилища. Дедупликация: параллельные запросы на холодном
+   * старте читают хранилище один раз и не заводят каждый свой `deviceId`.
+   */
+  #loading = null;
   /** Общий промис обновления: к нему присоединяются все, кто получил 401. */
   #refreshing = null;
   /** Общий промис входа по логину и паролю. */
@@ -1313,10 +1323,15 @@ var AuthManager = class {
    * поэтому `clear()` его не трогает.
    */
   #deviceId;
-  constructor(config, http, jar) {
+  /** Общий промис первичной выдачи `deviceId` — чтобы параллельные запросы получили один. */
+  #deviceIdLoading = null;
+  constructor(config, send, jar) {
     this.#config = config;
-    this.#http = http;
+    this.#send = send;
     this.#jar = jar;
+    this.#emitter = new Emitter(
+      (error) => reportListenerError(config.logger, "\u0430\u0432\u0442\u043E\u0440\u0438\u0437\u0430\u0446\u0438\u0438", error)
+    );
   }
   /** Подписка на события авторизации. */
   get on() {
@@ -1358,8 +1373,14 @@ var AuthManager = class {
    * сервер связывает с ним запись в списке сессий, и плавающее значение плодило бы
    * по новой сессии на каждый старт.
    */
-  async getDeviceId() {
-    if (this.#deviceId) return this.#deviceId;
+  getDeviceId() {
+    if (this.#deviceId) return Promise.resolve(this.#deviceId);
+    this.#deviceIdLoading ??= this.#resolveDeviceId().finally(() => {
+      this.#deviceIdLoading = null;
+    });
+    return this.#deviceIdLoading;
+  }
+  async #resolveDeviceId() {
     const session = await this.#loadSession();
     const deviceId = this.#config.deviceId ?? session?.deviceId ?? createDeviceId();
     this.#deviceId = deviceId;
@@ -1462,8 +1483,14 @@ var AuthManager = class {
     if (this.#deviceId) await this.#saveSession({ deviceId: this.#deviceId });
     this.#emitter.emit("signOut", void 0);
   }
-  async #loadSession() {
-    if (this.#session !== void 0) return this.#session;
+  #loadSession() {
+    if (this.#session !== void 0) return Promise.resolve(this.#session);
+    this.#loading ??= this.#performLoad().finally(() => {
+      this.#loading = null;
+    });
+    return this.#loading;
+  }
+  async #performLoad() {
     const stored = await this.#config.storage.get() ?? null;
     if (stored?.cookies) this.#jar.deserialize(stored.cookies);
     const fromConfig = this.#sessionFromConfig(this.#config.auth);
@@ -1531,17 +1558,14 @@ var AuthManager = class {
       return this.#reloginOrNull();
     }
     try {
-      const payload = await this.#http.request({
+      const payload = await this.#send({
         method: "POST",
         path: AUTH_PATHS.refresh,
+        skipQueue: true,
+        skipAuth: true,
+        skipAuthRefresh: true
         // Тела нет намеренно: сервер читает refresh-токен только из cookie — см.
         // #seedRefreshCookie. По той же причине не нужен и устаревший Bearer.
-        skipAuth: true,
-        // Без этого 401 на самом обновлении вызвал бы новое обновление — и так по кругу.
-        skipAuthRefresh: true,
-        // Обновление почти всегда запускается изнутри запроса, который занимает место
-        // в очереди и ждёт его результата. Встать в ту же очередь — значит зависнуть.
-        skipQueue: true
       });
       const accessToken = readAccessToken(payload);
       if (!accessToken) return this.#reloginOrNull();
@@ -1613,15 +1637,13 @@ var AuthManager = class {
   }
   async #performSignIn(credentials) {
     const turnstileToken = await this.#resolveTurnstileToken(credentials);
-    const payload = await this.#http.request({
+    const payload = await this.#send({
       method: "POST",
       path: AUTH_PATHS.signIn,
       body: { email: credentials.email, password: credentials.password, turnstileToken },
+      skipQueue: true,
       skipAuth: true,
-      skipAuthRefresh: true,
-      // Отложенный вход происходит при сборке заголовков уже начатого запроса — тот держит
-      // место в очереди и ждёт токена. См. `skipQueue` в RawRequestOptions.
-      skipQueue: true
+      skipAuthRefresh: true
     });
     const accessToken = readAccessToken(payload);
     if (!accessToken) {
@@ -1747,10 +1769,12 @@ function normalizeBaseUrl(baseUrl) {
   return parsed.origin + (parsed.pathname === "/" ? "" : parsed.pathname.replace(/\/$/, ""));
 }
 
+// src/core/version.ts
+var LIBRARY_VERSION = "0.0.8";
+
 // src/core/config.ts
 var DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
 var DEFAULT_TIMEOUT = 3e4;
-var LIBRARY_VERSION = "0.0.7";
 var DEFAULT_USER_AGENT = `Mozilla/5.0 (compatible; itd-api/${LIBRARY_VERSION}; +https://github.com/KiowDev/itd-api)`;
 var DEFAULT_RATE_LIMIT_DELAYS = Object.freeze([1e3, 5e3, 3e4, 6e4, 9e4]);
 function requirePositive(value, name) {
@@ -1895,183 +1919,520 @@ function resolveConfig(options = {}) {
   };
 }
 
-// src/core/redact.ts
-var SECRET_HEADERS = /* @__PURE__ */ new Set(["authorization", "cookie", "set-cookie", "x-api-key"]);
-var SECRET_FIELDS = /* @__PURE__ */ new Set([
-  "password",
-  "oldpassword",
-  "newpassword",
-  "accesstoken",
-  "refreshtoken",
-  "currentpassword",
-  "flowtoken",
-  "token",
-  "turnstiletoken",
-  "otp"
-]);
-function maskSecret(value) {
-  if (value.length <= 8) return "\u2026";
-  return `${value.slice(0, 4)}\u2026(${value.length})\u2026${value.slice(-3)}`;
-}
-function redactHeaders(headers) {
-  const result = {};
-  headers.forEach((value, name) => {
-    if (SECRET_HEADERS.has(name.toLowerCase())) {
-      const spaceAt = value.indexOf(" ");
-      result[name] = spaceAt > 0 ? `${value.slice(0, spaceAt)} ${maskSecret(value.slice(spaceAt + 1))}` : maskSecret(value);
-      return;
-    }
-    result[name] = value;
-  });
-  return result;
-}
-function redactBody(body) {
-  if (body === null || body === void 0) return body;
-  if (typeof FormData !== "undefined" && body instanceof FormData) return "[FormData]";
-  if (isBlob(body)) return "[Blob]";
-  if (body instanceof ArrayBuffer || ArrayBuffer.isView(body)) return "[binary]";
-  if (Array.isArray(body)) return body.map(redactBody);
-  if (typeof body === "object") {
-    const result = {};
-    for (const [key, value] of Object.entries(body)) {
-      result[key] = SECRET_FIELDS.has(key.toLowerCase()) ? "[\u0441\u043A\u0440\u044B\u0442\u043E]" : redactBody(value);
-    }
-    return result;
+// src/core/http.ts
+var HttpClient = class {
+  #handler;
+  #plugins;
+  #baseUrl;
+  constructor(deps) {
+    this.#handler = deps.handler;
+    this.#plugins = deps.plugins;
+    this.#baseUrl = deps.baseUrl;
   }
-  return body;
-}
+  /** Базовый URL, к которому обращается клиент. */
+  get baseUrl() {
+    return this.#baseUrl;
+  }
+  /**
+   * Имена опций запроса, заявленные плагинами.
+   *
+   * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
+   * если их никто не заявил, отсеивают.
+   */
+  get pluginOptionKeys() {
+    return this.#plugins.optionKeys;
+  }
+  /**
+   * Выполняет запрос к API через собранный конвейер.
+   *
+   * @typeParam T ожидаемая форма ответа после снятия обёртки `{ data: … }`
+   * @throws {ItdApiError} если сервер ответил статусом ≥ 400
+   * @throws {ItdTimeoutError} если истёк таймаут
+   * @throws {ItdAbortError} если запрос отменён через `signal`
+   * @throws {ItdNetworkError} если запрос не дошёл до сервера
+   */
+  request(options) {
+    return this.#handler(options);
+  }
+};
 
-// src/core/unwrap.ts
-function unwrapData(body) {
-  if (typeof body !== "object" || body === null || Array.isArray(body)) return body;
-  const keys = Object.keys(body);
-  if (keys.length !== 1 || keys[0] !== "data") return body;
-  return body.data;
+// src/core/pipeline.ts
+function composePipeline(middlewares, final) {
+  return middlewares.reduceRight(
+    (next, middleware) => (request) => middleware(request, next),
+    final
+  );
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+function withLayerHeaders(request, headers) {
+  return { ...request, layerHeaders: { ...request.layerHeaders, ...headers } };
 }
-function asString(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
+
+// src/core/retry.ts
+var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "OPTIONS"]);
+function isRetryable(error, method, retryWrites) {
+  if (error instanceof ItdAbortError) return false;
+  const safeToRepeat = retryWrites || IDEMPOTENT_METHODS.has(method);
+  if (error instanceof ItdApiError) {
+    if (error.status === 429) return true;
+    if (error.status >= 500) return safeToRepeat;
+    return false;
+  }
+  if (error instanceof ItdNetworkError || error instanceof ItdTimeoutError) return safeToRepeat;
+  return false;
 }
-function pickArray(source, field) {
-  if (typeof source !== "object" || source === null) return [];
-  const value = source[field];
-  return Array.isArray(value) ? value : [];
+function backoffDelay(attempt, options, random) {
+  const exponential = options.baseDelay * 2 ** (attempt - 1);
+  const capped = Math.min(exponential, options.maxDelay);
+  const spread = capped * options.jitter * (random() * 2 - 1);
+  return Math.max(0, Math.round(capped + spread));
 }
-function pickObject(source, field) {
-  if (typeof source !== "object" || source === null) return void 0;
-  const value = source[field];
-  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
-  return value;
+function createRetryScheduler(options, random = Math.random) {
+  return (error, attempt, method) => {
+    if (attempt >= options.attempts) return void 0;
+    if (options.shouldRetry) {
+      return options.shouldRetry(error, attempt) ? backoffDelay(attempt, options, random) : void 0;
+    }
+    if (!isRetryable(error, method, options.retryWrites)) return void 0;
+    if (error instanceof ItdApiError && error.retryAfter !== void 0) {
+      return error.retryAfter > options.maxDelay ? void 0 : error.retryAfter;
+    }
+    return backoffDelay(attempt, options, random);
+  };
 }
-function pickBoolean(source, field, fallback = false) {
-  if (typeof source !== "object" || source === null) return fallback;
-  const value = source[field];
-  return typeof value === "boolean" ? value : fallback;
+
+// src/core/middleware.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function pickNumber(source, field, fallback) {
-  if (typeof source !== "object" || source === null) return fallback;
-  const value = source[field];
-  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+function createQueueMiddleware(schedule) {
+  return (request, next) => request.skipQueue ? next(request) : schedule(() => next(request));
 }
-function pickString(source, field) {
-  if (typeof source !== "object" || source === null) return void 0;
-  const value = source[field];
-  return typeof value === "string" && value.length > 0 ? value : void 0;
+function createPluginsMiddleware(plugins) {
+  return (request, next) => {
+    if (plugins.size === 0) return next(request);
+    return plugins.run(request, next);
+  };
 }
-
-// src/core/error-factory.ts
-function collectFieldErrors(source) {
-  const result = {};
-  const errors = source.errors;
-  if (isRecord(errors)) {
-    for (const [field, value] of Object.entries(errors)) {
-      if (Array.isArray(value)) {
-        const messages = value.filter((item) => typeof item === "string");
-        if (messages.length > 0) result[field] = messages;
-      } else if (typeof value === "string") {
-        result[field] = [value];
+async function applyAuth(request, deps) {
+  if (request.skipAuth) return request;
+  const headers = await deps.getAuthHeaders();
+  return Object.keys(headers).length > 0 ? withLayerHeaders(request, headers) : request;
+}
+function createAuthMiddleware(deps) {
+  return async (request, next) => {
+    const authorized = await applyAuth(request, deps);
+    try {
+      return await next(authorized);
+    } catch (error) {
+      if (request.skipAuthRefresh || !deps.autoRefresh || !isItdApiError(error) || error.status !== 401) {
+        throw error;
       }
+      const refreshed = await deps.onUnauthorized();
+      if (!refreshed) throw error;
+      const retried = await applyAuth({ ...request, skipAuthRefresh: true }, deps);
+      return next(retried);
     }
-  }
-  const violations = source.violations;
-  if (Array.isArray(violations)) {
-    for (const violation of violations) {
-      if (!isRecord(violation)) continue;
-      const field = asString(violation.field) ?? asString(violation.property);
-      const message = asString(violation.message);
-      if (!field || !message) continue;
-      const existing = result[field];
-      if (existing) existing.push(message);
-      else result[field] = [message];
-    }
-  }
-  return result;
-}
-function parseErrorBody(body, status, statusText = "") {
-  const fallbackMessage = statusText ? `HTTP ${status} ${statusText}` : `HTTP ${status}`;
-  if (typeof body === "string") {
-    return {
-      code: "UNKNOWN_ERROR",
-      message: asString(body.trim()) ?? fallbackMessage,
-      detail: void 0,
-      title: void 0,
-      fieldErrors: {},
-      userId: void 0
-    };
-  }
-  if (!isRecord(body)) {
-    return {
-      code: "UNKNOWN_ERROR",
-      message: fallbackMessage,
-      detail: void 0,
-      title: void 0,
-      fieldErrors: {},
-      userId: void 0
-    };
-  }
-  if (body.type === "validation") {
-    const target = asString(body.on);
-    return {
-      code: "VALIDATION_ERROR",
-      message: target ? `\u041F\u0440\u043E\u0432\u0435\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0439\u0434\u0435\u043D\u0430: \u043D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u044B\u0435 \u0434\u0430\u043D\u043D\u044B\u0435 \u0432 \xAB${target}\xBB` : "\u041F\u0440\u043E\u0432\u0435\u0440\u043A\u0430 \u0432\u0445\u043E\u0434\u043D\u044B\u0445 \u0434\u0430\u043D\u043D\u044B\u0445 \u043D\u0435 \u043F\u0440\u043E\u0439\u0434\u0435\u043D\u0430",
-      detail: void 0,
-      title: void 0,
-      fieldErrors: {},
-      userId: void 0
-    };
-  }
-  const inner = isRecord(body.error) ? body.error : body;
-  const message = asString(inner.message) ?? asString(inner.detail) ?? asString(inner.title) ?? // `{ "error": "Invalid token" }` — так отвечает сервер на недействительный токен.
-  asString(body.error) ?? fallbackMessage;
-  return {
-    code: asString(inner.code) ?? asString(body.code) ?? "UNKNOWN_ERROR",
-    message,
-    detail: asString(inner.detail),
-    title: asString(inner.title),
-    fieldErrors: { ...collectFieldErrors(body), ...collectFieldErrors(inner) },
-    userId: asString(inner.userId) ?? asString(body.userId)
   };
 }
-function parseRetryAfter(header, now = Date.now()) {
-  if (!header) return void 0;
-  const seconds = Number(header);
-  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
-  const date = Date.parse(header);
-  if (Number.isFinite(date)) return Math.max(0, date - now);
-  return void 0;
-}
-function readIntHeader(headers, name) {
-  const raw = headers?.get(name);
-  if (raw === null || raw === void 0) return void 0;
-  const value = Number.parseInt(raw, 10);
-  return Number.isFinite(value) ? value : void 0;
+function resolveBackoff(retry, global) {
+  if (retry === void 0) return global;
+  if (retry === false) return void 0;
+  const resolved = resolveRetry(retry);
+  return resolved ? createRetryScheduler(resolved) : void 0;
 }
-function readRateLimit(headers) {
-  return {
-    limit: readIntHeader(headers, "x-ratelimit-limit"),
-    remaining: readIntHeader(headers, "x-ratelimit-remaining")
+function createRetryMiddleware(deps) {
+  const globalScheduler = deps.retry ? createRetryScheduler(deps.retry) : void 0;
+  const nextDelay = (error, attempt, method, backoff) => {
+    if (isItdRateLimitError(error)) {
+      const wait = error.retryAfter ?? deps.rateLimitDelays[attempt - 1];
+      if (wait === void 0) return void 0;
+      deps.pauseQueue?.(wait);
+      deps.logger?.debug(`\u043B\u0438\u043C\u0438\u0442 \u0447\u0430\u0441\u0442\u043E\u0442\u044B, \u043F\u043E\u043F\u044B\u0442\u043A\u0430 ${attempt + 1} \u0447\u0435\u0440\u0435\u0437 ${wait} \u043C\u0441`);
+      return wait;
+    }
+    return backoff?.(error, attempt, method);
+  };
+  return async (request, next) => {
+    const method = request.method.toUpperCase();
+    const backoff = resolveBackoff(request.retry, globalScheduler);
+    for (let attempt = 1; ; attempt++) {
+      try {
+        return await next({ ...request, attempt });
+      } catch (error) {
+        const delay = nextDelay(error, attempt, method, backoff);
+        if (delay === void 0) throw error;
+        await deps.hooks.onRetry?.({
+          method,
+          path: request.path,
+          url: deps.buildUrl(request),
+          headers: new Headers(),
+          attempt,
+          error,
+          delay
+        });
+        deps.logger?.debug(
+          `\u043F\u043E\u0432\u0442\u043E\u0440 ${method} ${request.path}, \u043F\u043E\u043F\u044B\u0442\u043A\u0430 ${attempt + 1} \u0447\u0435\u0440\u0435\u0437 ${delay} \u043C\u0441`
+        );
+        await sleep(delay);
+      }
+    }
+  };
+}
+
+// src/core/plugins.ts
+var NO_KEYS = /* @__PURE__ */ new Set();
+var RESERVED_OPTION_KEYS = /* @__PURE__ */ new Set([
+  "signal",
+  "timeout",
+  "headers",
+  "retry",
+  "method",
+  "path",
+  "query",
+  "body",
+  "skipAuth",
+  "skipAuthRefresh",
+  "skipQueue",
+  "raw"
+]);
+var PluginRegistry = class {
+  #transformers = [];
+  #optionKeys = /* @__PURE__ */ new Set();
+  #names = /* @__PURE__ */ new Set();
+  /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
+  get size() {
+    return this.#transformers.length;
+  }
+  /** Имена опций запроса, заявленные плагинами. */
+  get optionKeys() {
+    return this.#optionKeys.size === 0 ? NO_KEYS : this.#optionKeys;
+  }
+  /**
+   * Подключает плагин.
+   *
+   * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
+   * имя опции
+   */
+  add(plugin, context) {
+    if (typeof plugin?.install !== "function") {
+      throw new ItdConfigError("\u041F\u043B\u0430\u0433\u0438\u043D \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u043E\u0431\u044A\u0435\u043A\u0442\u043E\u043C \u0441 \u043C\u0435\u0442\u043E\u0434\u043E\u043C install()");
+    }
+    const name = plugin.name;
+    if (typeof name !== "string" || name.trim() === "") {
+      throw new ItdConfigError("\u0423 \u043F\u043B\u0430\u0433\u0438\u043D\u0430 \u0434\u043E\u043B\u0436\u043D\u043E \u0431\u044B\u0442\u044C \u043D\u0435\u043F\u0443\u0441\u0442\u043E\u0435 \u0438\u043C\u044F");
+    }
+    if (this.#names.has(name)) {
+      throw new ItdConfigError(`\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0443\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0451\u043D`);
+    }
+    const keys = plugin.optionKeys ?? [];
+    for (const key of keys) {
+      if (typeof key !== "string" || key.trim() === "") {
+        throw new ItdConfigError(`\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0437\u0430\u044F\u0432\u0438\u043B \u043F\u0443\u0441\u0442\u043E\u0435 \u0438\u043C\u044F \u043E\u043F\u0446\u0438\u0438`);
+      }
+      if (RESERVED_OPTION_KEYS.has(key)) {
+        throw new ItdConfigError(
+          `\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0437\u0430\u044F\u0432\u0438\u043B \u043E\u043F\u0446\u0438\u044E \xAB${key}\xBB: \u044D\u0442\u043E \u043F\u043E\u043B\u0435 \u0437\u0430\u043F\u0440\u043E\u0441\u0430, \u0438\u043C\u044F \u0437\u0430\u043D\u044F\u0442\u043E. \u0417\u0430\u043D\u044F\u0442\u044B\u0435 \u0438\u043C\u0435\u043D\u0430: ${[...RESERVED_OPTION_KEYS].join(", ")}`
+        );
+      }
+    }
+    const before = this.#transformers.length;
+    try {
+      plugin.install({
+        ...context,
+        use: (transformer) => {
+          if (typeof transformer !== "function") {
+            throw new ItdConfigError(`\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u043F\u0435\u0440\u0435\u0434\u0430\u043B \u0432 use() \u043D\u0435 \u0444\u0443\u043D\u043A\u0446\u0438\u044E`);
+          }
+          this.#transformers.push(transformer);
+        }
+      });
+    } catch (error) {
+      this.#transformers.length = before;
+      throw error;
+    }
+    this.#names.add(name);
+    for (const key of keys) this.#optionKeys.add(key);
+  }
+  /**
+   * Прогоняет запрос через цепочку обёрток.
+   *
+   * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
+   * а обёрток единицы — экономить тут не на чем.
+   *
+   * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+   */
+  run(request, execute) {
+    const chain = this.#transformers.reduceRight(
+      (next, transformer) => (current) => transformer(current, next),
+      execute
+    );
+    return chain(request);
+  }
+};
+
+// src/core/rate-limit.ts
+var RequestQueue = class {
+  #concurrency;
+  /** Минимальный промежуток между стартами, мс. `0` — без ограничения частоты. */
+  #minGap;
+  #waiting = [];
+  #active = 0;
+  /** Момент, раньше которого следующий запрос стартовать не должен. */
+  #nextSlot = 0;
+  #timer;
+  constructor(options) {
+    this.#concurrency = options.concurrency;
+    this.#minGap = options.rps ? 1e3 / options.rps : 0;
+  }
+  /** Сколько задач выполняется прямо сейчас. */
+  get active() {
+    return this.#active;
+  }
+  /** Сколько задач ждёт очереди. */
+  get pending() {
+    return this.#waiting.length;
+  }
+  /**
+   * Ставит задачу в очередь.
+   *
+   * @returns результат задачи; ошибка задачи пробрасывается без изменений
+   */
+  schedule(task) {
+    return new Promise((resolve, reject) => {
+      const run = () => {
+        this.#active += 1;
+        task().then(resolve, reject).finally(() => {
+          this.#active -= 1;
+          this.#drain();
+        });
+      };
+      this.#waiting.push({ run, cancel: reject });
+      this.#drain();
+    });
+  }
+  /**
+   * Останавливает очередь: снимает отложенную паузу и отклоняет ещё не начатые задачи
+   * ошибкой `ItdAbortError`. Уже выполняющиеся задачи доводятся до конца.
+   */
+  stop() {
+    if (this.#timer !== void 0) {
+      clearTimeout(this.#timer);
+      this.#timer = void 0;
+    }
+    this.#nextSlot = 0;
+    const pending = this.#waiting.splice(0, this.#waiting.length);
+    for (const task of pending) {
+      task.cancel(new ItdAbortError("\u041A\u043B\u0438\u0435\u043D\u0442 \u0437\u0430\u043A\u0440\u044B\u0442, \u0437\u0430\u043F\u0440\u043E\u0441 \u043E\u0442\u043C\u0435\u043D\u0451\u043D"));
+    }
+  }
+  /**
+   * Придерживает всю очередь на заданное время.
+   *
+   * Вызывается при получении `429` с заголовком `Retry-After`: тормозить нужно все запросы,
+   * а не только тот, который наткнулся на лимит, — иначе остальные продолжат добивать API.
+   */
+  pause(ms) {
+    if (ms <= 0) return;
+    this.#nextSlot = Math.max(this.#nextSlot, Date.now() + ms);
+  }
+  /** Запускает столько ожидающих задач, сколько позволяют ограничения. */
+  #drain() {
+    if (this.#waiting.length === 0) return;
+    if (this.#active >= this.#concurrency) return;
+    if (this.#timer !== void 0) return;
+    const now = Date.now();
+    if (this.#nextSlot > now) {
+      this.#timer = setTimeout(() => {
+        this.#timer = void 0;
+        this.#drain();
+      }, this.#nextSlot - now);
+      return;
+    }
+    const next = this.#waiting.shift();
+    if (!next) return;
+    if (this.#minGap > 0) this.#nextSlot = now + this.#minGap;
+    next.run();
+    this.#drain();
+  }
+};
+
+// src/core/redact.ts
+var SECRET_HEADERS = /* @__PURE__ */ new Set(["authorization", "cookie", "set-cookie", "x-api-key"]);
+var SECRET_FIELDS = /* @__PURE__ */ new Set([
+  "password",
+  "oldpassword",
+  "newpassword",
+  "accesstoken",
+  "refreshtoken",
+  "currentpassword",
+  "flowtoken",
+  "token",
+  "turnstiletoken",
+  "otp"
+]);
+function maskSecret(value) {
+  if (value.length <= 8) return "\u2026";
+  return `${value.slice(0, 4)}\u2026(${value.length})\u2026${value.slice(-3)}`;
+}
+function redactHeaders(headers) {
+  const result = {};
+  headers.forEach((value, name) => {
+    if (SECRET_HEADERS.has(name.toLowerCase())) {
+      const spaceAt = value.indexOf(" ");
+      result[name] = spaceAt > 0 ? `${value.slice(0, spaceAt)} ${maskSecret(value.slice(spaceAt + 1))}` : maskSecret(value);
+      return;
+    }
+    result[name] = value;
+  });
+  return result;
+}
+function redactBody(body) {
+  if (body === null || body === void 0) return body;
+  if (typeof FormData !== "undefined" && body instanceof FormData) return "[FormData]";
+  if (isBlob(body)) return "[Blob]";
+  if (body instanceof ArrayBuffer || ArrayBuffer.isView(body)) return "[binary]";
+  if (Array.isArray(body)) return body.map(redactBody);
+  if (typeof body === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(body)) {
+      result[key] = SECRET_FIELDS.has(key.toLowerCase()) ? "[\u0441\u043A\u0440\u044B\u0442\u043E]" : redactBody(value);
+    }
+    return result;
+  }
+  return body;
+}
+
+// src/core/unwrap.ts
+function unwrapData(body) {
+  if (typeof body !== "object" || body === null || Array.isArray(body)) return body;
+  const keys = Object.keys(body);
+  if (keys.length !== 1 || keys[0] !== "data") return body;
+  return body.data;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function pickArray(source, field) {
+  if (typeof source !== "object" || source === null) return [];
+  const value = source[field];
+  return Array.isArray(value) ? value : [];
+}
+function pickObject(source, field) {
+  if (typeof source !== "object" || source === null) return void 0;
+  const value = source[field];
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  return value;
+}
+function pickBoolean(source, field, fallback = false) {
+  if (typeof source !== "object" || source === null) return fallback;
+  const value = source[field];
+  return typeof value === "boolean" ? value : fallback;
+}
+function pickNumber(source, field, fallback) {
+  if (typeof source !== "object" || source === null) return fallback;
+  const value = source[field];
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function pickString(source, field) {
+  if (typeof source !== "object" || source === null) return void 0;
+  const value = source[field];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+
+// src/core/error-factory.ts
+function collectFieldErrors(source) {
+  const result = {};
+  const errors = source.errors;
+  if (isRecord(errors)) {
+    for (const [field, value] of Object.entries(errors)) {
+      if (Array.isArray(value)) {
+        const messages = value.filter((item) => typeof item === "string");
+        if (messages.length > 0) result[field] = messages;
+      } else if (typeof value === "string") {
+        result[field] = [value];
+      }
+    }
+  }
+  const violations = source.violations;
+  if (Array.isArray(violations)) {
+    for (const violation of violations) {
+      if (!isRecord(violation)) continue;
+      const field = asString(violation.field) ?? asString(violation.property);
+      const message = asString(violation.message);
+      if (!field || !message) continue;
+      const existing = result[field];
+      if (existing) existing.push(message);
+      else result[field] = [message];
+    }
+  }
+  return result;
+}
+function parseErrorBody(body, status, statusText = "") {
+  const fallbackMessage = statusText ? `HTTP ${status} ${statusText}` : `HTTP ${status}`;
+  if (typeof body === "string") {
+    return {
+      code: "UNKNOWN_ERROR",
+      message: asString(body.trim()) ?? fallbackMessage,
+      detail: void 0,
+      title: void 0,
+      fieldErrors: {},
+      userId: void 0
+    };
+  }
+  if (!isRecord(body)) {
+    return {
+      code: "UNKNOWN_ERROR",
+      message: fallbackMessage,
+      detail: void 0,
+      title: void 0,
+      fieldErrors: {},
+      userId: void 0
+    };
+  }
+  if (body.type === "validation") {
+    const target = asString(body.on);
+    return {
+      code: "VALIDATION_ERROR",
+      message: target ? `\u041F\u0440\u043E\u0432\u0435\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0439\u0434\u0435\u043D\u0430: \u043D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u044B\u0435 \u0434\u0430\u043D\u043D\u044B\u0435 \u0432 \xAB${target}\xBB` : "\u041F\u0440\u043E\u0432\u0435\u0440\u043A\u0430 \u0432\u0445\u043E\u0434\u043D\u044B\u0445 \u0434\u0430\u043D\u043D\u044B\u0445 \u043D\u0435 \u043F\u0440\u043E\u0439\u0434\u0435\u043D\u0430",
+      detail: void 0,
+      title: void 0,
+      fieldErrors: {},
+      userId: void 0
+    };
+  }
+  const inner = isRecord(body.error) ? body.error : body;
+  const message = asString(inner.message) ?? asString(inner.detail) ?? asString(inner.title) ?? // `{ "error": "Invalid token" }` — так отвечает сервер на недействительный токен.
+  asString(body.error) ?? fallbackMessage;
+  return {
+    code: asString(inner.code) ?? asString(body.code) ?? "UNKNOWN_ERROR",
+    message,
+    detail: asString(inner.detail),
+    title: asString(inner.title),
+    fieldErrors: { ...collectFieldErrors(body), ...collectFieldErrors(inner) },
+    userId: asString(inner.userId) ?? asString(body.userId)
+  };
+}
+function parseRetryAfter(header, now = Date.now()) {
+  if (!header) return void 0;
+  const seconds = Number(header);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(header);
+  if (Number.isFinite(date)) return Math.max(0, date - now);
+  return void 0;
+}
+function readIntHeader(headers, name) {
+  const raw = headers?.get(name);
+  if (raw === null || raw === void 0) return void 0;
+  const value = Number.parseInt(raw, 10);
+  return Number.isFinite(value) ? value : void 0;
+}
+function readRateLimit(headers) {
+  return {
+    limit: readIntHeader(headers, "x-ratelimit-limit"),
+    remaining: readIntHeader(headers, "x-ratelimit-remaining")
   };
 }
 var REQUEST_ID_HEADERS = ["x-request-id", "x-requestid", "request-id", "x-correlation-id"];
@@ -2141,11 +2502,7 @@ function createApiError(context) {
   return new Ctor(init);
 }
 
-// src/core/http.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-var EMPTY_KEYS = /* @__PURE__ */ new Set();
+// src/core/transport.ts
 function setHeader(headers, name, value) {
   try {
     headers.set(name, value);
@@ -2196,137 +2553,47 @@ function createAbortBundle(userSignal, timeout) {
     }
   };
 }
-var HttpClient = class {
+var Transport = class {
   #config;
-  #collaborators;
-  #plugins;
-  constructor(config, collaborators = {}) {
+  #deps;
+  constructor(config, deps) {
     this.#config = config;
-    this.#collaborators = collaborators;
+    this.#deps = deps;
   }
-  /** Базовый URL, к которому обращается клиент. */
+  /** Базовый URL, к которому обращается транспорт. */
   get baseUrl() {
     return this.#config.baseUrl;
   }
   /**
-   * Имена опций запроса, заявленные плагинами.
-   *
-   * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
-   * если их никто не заявил, отсеивают.
-   */
-  get pluginOptionKeys() {
-    return this.#plugins?.optionKeys ?? EMPTY_KEYS;
-  }
-  /** Подключает список плагинов. Реестр общий с клиентом и пополняется через `itd.use()`. */
-  usePlugins(plugins) {
-    this.#plugins = plugins;
-  }
-  /**
-   * Подключает недостающие части конвейера.
-   *
-   * Нужно из-за кольцевой зависимости: слой авторизации сам выполняет запросы, поэтому
-   * не может быть передан в конструктор до создания транспорта.
-   */
-  setCollaborators(collaborators) {
-    this.#collaborators = { ...this.#collaborators, ...collaborators };
-  }
-  /**
-   * Выполняет запрос к API.
+   * Выполняет один сетевой запрос.
    *
-   * @typeParam T ожидаемая форма ответа после снятия обёртки `{ data: … }`
    * @throws {ItdApiError} если сервер ответил статусом ≥ 400
    * @throws {ItdTimeoutError} если истёк таймаут
    * @throws {ItdAbortError} если запрос отменён через `signal`
    * @throws {ItdNetworkError} если запрос не дошёл до сервера
    */
-  async request(options) {
-    const task = () => this.#withPlugins(options);
-    if (!this.#collaborators.schedule || options.skipQueue) return task();
-    return this.#collaborators.schedule(task);
-  }
-  /**
-   * Прогоняет запрос через обёртки плагинов.
-   *
-   * Цепочка стоит **снаружи повторов и внутри очереди**: плагин должен увидеть запрос
-   * и ответ по одному разу, независимо от того, сколько попыток понадобилось, — иначе,
-   * например, текст поста зашифруется повторно на второй попытке.
-   */
-  #withPlugins(options) {
-    const plugins = this.#plugins;
-    if (!plugins || plugins.size === 0) return this.#withRetries(options);
-    return plugins.run(options, (request) => this.#withRetries(request));
-  }
-  async #withRetries(options) {
-    const method = options.method.toUpperCase();
-    for (let attempt = 1; ; attempt++) {
-      try {
-        return await this.#attempt(options, attempt);
-      } catch (error) {
-        const delay = this.#collaborators.nextRetryDelay?.(error, attempt, method);
-        if (delay === void 0) throw error;
-        await this.#config.hooks.onRetry?.({
-          method,
-          path: options.path,
-          url: this.#buildUrl(options),
-          headers: new Headers(),
-          attempt,
-          error,
-          delay
-        });
-        this.#config.logger?.debug(
-          `\u043F\u043E\u0432\u0442\u043E\u0440 ${method} ${options.path}, \u043F\u043E\u043F\u044B\u0442\u043A\u0430 ${attempt + 1} \u0447\u0435\u0440\u0435\u0437 ${delay} \u043C\u0441`
-        );
-        await sleep(delay);
-      }
-    }
-  }
-  #buildUrl(options) {
-    return joinUrl(this.#config.baseUrl, options.path) + buildQuery(options.query);
-  }
-  async #buildHeaders(options, url) {
-    const headers = new Headers();
-    headers.set("Accept", "application/json");
-    headers.set("X-Requested-With", "XMLHttpRequest");
-    if (this.#config.userAgent) setHeader(headers, "User-Agent", this.#config.userAgent);
-    if (this.#collaborators.getDeviceId) {
-      setHeader(headers, "X-Device-Id", await this.#collaborators.getDeviceId());
-    }
-    for (const [name, value] of Object.entries(this.#config.headers))
-      setHeader(headers, name, value);
-    if (!options.skipAuth && this.#collaborators.getAuthHeaders) {
-      const auth = await this.#collaborators.getAuthHeaders();
-      for (const [name, value] of Object.entries(auth)) setHeader(headers, name, value);
-    }
-    if (this.#config.useCookieJar && this.#collaborators.getCookieHeader) {
-      const cookie = this.#collaborators.getCookieHeader(url);
-      if (cookie) setHeader(headers, "Cookie", cookie);
-    }
-    for (const [name, value] of Object.entries(options.headers ?? {})) {
-      setHeader(headers, name, value);
-    }
-    return headers;
-  }
-  async #attempt(options, attempt) {
-    const method = options.method.toUpperCase();
-    const url = this.#buildUrl(options);
-    const headers = await this.#buildHeaders(options, url);
+  send = async (request) => {
+    const method = request.method.toUpperCase();
+    const url = this.buildUrl(request);
+    const headers = await this.#buildHeaders(request, url);
+    const attempt = request.attempt ?? 1;
     let body;
-    if (options.body !== void 0 && options.body !== null) {
-      if (isRawBody(options.body)) {
-        body = options.body;
+    if (request.body !== void 0 && request.body !== null) {
+      if (isRawBody(request.body)) {
+        body = request.body;
       } else {
-        body = JSON.stringify(options.body);
+        body = JSON.stringify(request.body);
         if (!headers.has("Content-Type")) headers.set("Content-Type", "application/json");
       }
     }
-    const context = { method, path: options.path, url, headers, attempt };
+    const context = { method, path: request.path, url, headers, attempt };
     await this.#config.hooks.onRequest?.(context);
-    const timeout = options.timeout ?? this.#config.timeout;
-    const abort = createAbortBundle(options.signal, timeout);
+    const timeout = request.timeout ?? this.#config.timeout;
+    const abort = createAbortBundle(request.signal, timeout);
     const startedAt = Date.now();
-    this.#config.logger?.debug(`\u2192 ${method} ${options.path}`, {
+    this.#config.logger?.debug(`\u2192 ${method} ${request.path}`, {
       headers: redactHeaders(headers),
-      body: redactBody(options.body)
+      body: redactBody(request.body)
     });
     let response;
     try {
@@ -2339,31 +2606,24 @@ var HttpClient = class {
       });
     } catch (error) {
       const duration2 = Date.now() - startedAt;
-      const failure = this.#toTransportError(error, abort, options, method, timeout);
+      const failure = this.#toTransportError(error, abort, request, method, timeout);
       await this.#config.hooks.onError?.({ ...context, duration: duration2, error: failure });
-      this.#config.logger?.warn(`\xD7 ${method} ${options.path} (${duration2} \u043C\u0441): ${failure.message}`);
+      this.#config.logger?.warn(`\xD7 ${method} ${request.path} (${duration2} \u043C\u0441): ${failure.message}`);
       throw failure;
     } finally {
       abort.cleanup();
     }
     const duration = Date.now() - startedAt;
-    if (this.#collaborators.onRateLimit) {
+    if (this.#deps.onRateLimit) {
       const { limit, remaining } = readRateLimit(response.headers);
-      this.#collaborators.onRateLimit(limit, remaining);
+      this.#deps.onRateLimit(limit, remaining);
     }
-    if (this.#config.useCookieJar) this.#collaborators.saveCookies?.(url, response);
+    if (this.#config.useCookieJar) this.#deps.cookies?.setFromResponse(url, response);
     const payload = await readBody(response);
     if (!response.ok) {
-      if (response.status === 401 && !options.skipAuthRefresh && this.#config.autoRefresh && this.#collaborators.onUnauthorized) {
-        const refreshed = await this.#collaborators.onUnauthorized();
-        if (refreshed) {
-          this.#config.logger?.debug(`\u0442\u043E\u043A\u0435\u043D \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D, \u043F\u043E\u0432\u0442\u043E\u0440\u044F\u044E ${method} ${options.path}`);
-          return this.#attempt({ ...options, skipAuthRefresh: true }, attempt);
-        }
-      }
       const error = createApiError({
         method,
-        path: options.path,
+        path: request.path,
         status: response.status,
         statusText: response.statusText,
         headers: response.headers,
@@ -2372,7 +2632,7 @@ var HttpClient = class {
       });
       await this.#config.hooks.onError?.({ ...context, duration, error });
       this.#config.logger?.warn(
-        `\u2190 ${response.status} ${method} ${options.path} (${duration} \u043C\u0441): ${error.message}`
+        `\u2190 ${response.status} ${method} ${request.path} (${duration} \u043C\u0441): ${error.message}`
       );
       throw error;
     }
@@ -2382,219 +2642,56 @@ var HttpClient = class {
       duration,
       response
     });
-    this.#config.logger?.debug(`\u2190 ${response.status} ${method} ${options.path} (${duration} \u043C\u0441)`);
-    return options.raw ? payload : unwrapData(payload);
-  }
-  /** Превращает исключение `fetch` в понятную ошибку библиотеки. */
-  #toTransportError(error, abort, options, method, timeout) {
-    const aborted = error instanceof Error && error.name === "AbortError";
-    if (aborted && abort.timedOut()) {
-      return new ItdTimeoutError({ timeout, method, path: options.path });
-    }
-    if (aborted) {
-      return new ItdAbortError(`\u0417\u0430\u043F\u0440\u043E\u0441 ${method} ${options.path} \u043E\u0442\u043C\u0435\u043D\u0451\u043D`);
-    }
-    return new ItdNetworkError(
-      `\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0432\u044B\u043F\u043E\u043B\u043D\u0438\u0442\u044C ${method} ${options.path}: ${error instanceof Error ? error.message : String(error)}`,
-      { method, path: options.path, cause: error }
-    );
-  }
-};
-
-// src/core/plugins.ts
-var NO_KEYS = /* @__PURE__ */ new Set();
-var RESERVED_OPTION_KEYS = /* @__PURE__ */ new Set([
-  "signal",
-  "timeout",
-  "headers",
-  "retry",
-  "method",
-  "path",
-  "query",
-  "body",
-  "skipAuth",
-  "skipAuthRefresh",
-  "skipQueue",
-  "raw"
-]);
-var PluginRegistry = class {
-  #transformers = [];
-  #optionKeys = /* @__PURE__ */ new Set();
-  #names = /* @__PURE__ */ new Set();
-  /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
-  get size() {
-    return this.#transformers.length;
-  }
-  /** Имена опций запроса, заявленные плагинами. */
-  get optionKeys() {
-    return this.#optionKeys.size === 0 ? NO_KEYS : this.#optionKeys;
-  }
-  /**
-   * Подключает плагин.
-   *
-   * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
-   * имя опции
-   */
-  add(plugin, context) {
-    if (typeof plugin?.install !== "function") {
-      throw new ItdConfigError("\u041F\u043B\u0430\u0433\u0438\u043D \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u043E\u0431\u044A\u0435\u043A\u0442\u043E\u043C \u0441 \u043C\u0435\u0442\u043E\u0434\u043E\u043C install()");
-    }
-    const name = plugin.name;
-    if (typeof name !== "string" || name.trim() === "") {
-      throw new ItdConfigError("\u0423 \u043F\u043B\u0430\u0433\u0438\u043D\u0430 \u0434\u043E\u043B\u0436\u043D\u043E \u0431\u044B\u0442\u044C \u043D\u0435\u043F\u0443\u0441\u0442\u043E\u0435 \u0438\u043C\u044F");
-    }
-    if (this.#names.has(name)) {
-      throw new ItdConfigError(`\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0443\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0451\u043D`);
-    }
-    const keys = plugin.optionKeys ?? [];
-    for (const key of keys) {
-      if (typeof key !== "string" || key.trim() === "") {
-        throw new ItdConfigError(`\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0437\u0430\u044F\u0432\u0438\u043B \u043F\u0443\u0441\u0442\u043E\u0435 \u0438\u043C\u044F \u043E\u043F\u0446\u0438\u0438`);
-      }
-      if (RESERVED_OPTION_KEYS.has(key)) {
-        throw new ItdConfigError(
-          `\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0437\u0430\u044F\u0432\u0438\u043B \u043E\u043F\u0446\u0438\u044E \xAB${key}\xBB: \u044D\u0442\u043E \u043F\u043E\u043B\u0435 \u0437\u0430\u043F\u0440\u043E\u0441\u0430, \u0438\u043C\u044F \u0437\u0430\u043D\u044F\u0442\u043E. \u0417\u0430\u043D\u044F\u0442\u044B\u0435 \u0438\u043C\u0435\u043D\u0430: ${[...RESERVED_OPTION_KEYS].join(", ")}`
-        );
-      }
-    }
-    const before = this.#transformers.length;
-    try {
-      plugin.install({
-        ...context,
-        use: (transformer) => {
-          if (typeof transformer !== "function") {
-            throw new ItdConfigError(`\u041F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u043F\u0435\u0440\u0435\u0434\u0430\u043B \u0432 use() \u043D\u0435 \u0444\u0443\u043D\u043A\u0446\u0438\u044E`);
-          }
-          this.#transformers.push(transformer);
-        }
-      });
-    } catch (error) {
-      this.#transformers.length = before;
-      throw error;
-    }
-    this.#names.add(name);
-    for (const key of keys) this.#optionKeys.add(key);
-  }
-  /**
-   * Прогоняет запрос через цепочку обёрток.
-   *
-   * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
-   * а обёрток единицы — экономить тут не на чем.
-   *
-   * @param execute настоящий запрос, вызывается самой внутренней обёрткой
-   */
-  run(request, execute) {
-    const chain = this.#transformers.reduceRight(
-      (next, transformer) => (current) => transformer(current, next),
-      execute
-    );
-    return chain(request);
-  }
-};
-
-// src/core/rate-limit.ts
-var RequestQueue = class {
-  #concurrency;
-  /** Минимальный промежуток между стартами, мс. `0` — без ограничения частоты. */
-  #minGap;
-  #waiting = [];
-  #active = 0;
-  /** Момент, раньше которого следующий запрос стартовать не должен. */
-  #nextSlot = 0;
-  #timer;
-  constructor(options) {
-    this.#concurrency = options.concurrency;
-    this.#minGap = options.rps ? 1e3 / options.rps : 0;
-  }
-  /** Сколько задач выполняется прямо сейчас. */
-  get active() {
-    return this.#active;
-  }
-  /** Сколько задач ждёт очереди. */
-  get pending() {
-    return this.#waiting.length;
-  }
-  /**
-   * Ставит задачу в очередь.
-   *
-   * @returns результат задачи; ошибка задачи пробрасывается без изменений
-   */
-  schedule(task) {
-    return new Promise((resolve, reject) => {
-      const run = () => {
-        this.#active += 1;
-        task().then(resolve, reject).finally(() => {
-          this.#active -= 1;
-          this.#drain();
-        });
-      };
-      this.#waiting.push({ run });
-      this.#drain();
-    });
+    this.#config.logger?.debug(`\u2190 ${response.status} ${method} ${request.path} (${duration} \u043C\u0441)`);
+    return request.raw ? payload : unwrapData(payload);
+  };
+  /** Итоговый URL со строкой запроса. Нужен и слою повторов — для хука `onRetry`. */
+  buildUrl(request) {
+    return joinUrl(this.#config.baseUrl, request.path) + buildQuery(request.query);
   }
   /**
-   * Придерживает всю очередь на заданное время.
+   * Собирает заголовки запроса.
    *
-   * Вызывается при получении `429` с заголовком `Retry-After`: тормозить нужно все запросы,
-   * а не только тот, который наткнулся на лимит, — иначе остальные продолжат добивать API.
-   */
-  pause(ms) {
-    if (ms <= 0) return;
-    this.#nextSlot = Math.max(this.#nextSlot, Date.now() + ms);
-  }
-  /** Запускает столько ожидающих задач, сколько позволяют ограничения. */
-  #drain() {
-    if (this.#waiting.length === 0) return;
-    if (this.#active >= this.#concurrency) return;
-    if (this.#timer !== void 0) return;
-    const now = Date.now();
-    if (this.#nextSlot > now) {
-      this.#timer = setTimeout(() => {
-        this.#timer = void 0;
-        this.#drain();
-      }, this.#nextSlot - now);
-      return;
-    }
-    const next = this.#waiting.shift();
-    if (!next) return;
-    if (this.#minGap > 0) this.#nextSlot = now + this.#minGap;
-    next.run();
-    this.#drain();
-  }
-};
-
-// src/core/retry.ts
-var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "OPTIONS"]);
-function isRetryable(error, method, retryWrites) {
-  if (error instanceof ItdAbortError) return false;
-  const safeToRepeat = retryWrites || IDEMPOTENT_METHODS.has(method);
-  if (error instanceof ItdApiError) {
-    if (error.status === 429) return true;
-    if (error.status >= 500) return safeToRepeat;
-    return false;
+   * Порядок важен: сначала умолчания библиотеки, затем заголовки клиента, затем то,
+   * что добавили слои конвейера (авторизация), и только в самом конце — заголовки
+   * конкретного вызова. Так пользователь может переопределить что угодно.
+   */
+  async #buildHeaders(request, url) {
+    const headers = new Headers();
+    headers.set("Accept", "application/json");
+    headers.set("X-Requested-With", "XMLHttpRequest");
+    if (this.#config.userAgent) setHeader(headers, "User-Agent", this.#config.userAgent);
+    if (this.#deps.getDeviceId) {
+      setHeader(headers, "X-Device-Id", await this.#deps.getDeviceId());
+    }
+    for (const [name, value] of Object.entries(this.#config.headers))
+      setHeader(headers, name, value);
+    for (const [name, value] of Object.entries(request.layerHeaders ?? {}))
+      setHeader(headers, name, value);
+    if (this.#config.useCookieJar && this.#deps.cookies) {
+      const cookie = this.#deps.cookies.getHeader(url);
+      if (cookie) setHeader(headers, "Cookie", cookie);
+    }
+    for (const [name, value] of Object.entries(request.headers ?? {})) {
+      setHeader(headers, name, value);
+    }
+    return headers;
   }
-  if (error instanceof ItdNetworkError || error instanceof ItdTimeoutError) return safeToRepeat;
-  return false;
-}
-function backoffDelay(attempt, options, random) {
-  const exponential = options.baseDelay * 2 ** (attempt - 1);
-  const capped = Math.min(exponential, options.maxDelay);
-  const spread = capped * options.jitter * (random() * 2 - 1);
-  return Math.max(0, Math.round(capped + spread));
-}
-function createRetryScheduler(options, random = Math.random) {
-  return (error, attempt, method) => {
-    if (attempt >= options.attempts) return void 0;
-    if (options.shouldRetry) {
-      return options.shouldRetry(error, attempt) ? backoffDelay(attempt, options, random) : void 0;
+  /** Превращает исключение `fetch` в понятную ошибку библиотеки. */
+  #toTransportError(error, abort, request, method, timeout) {
+    const aborted = error instanceof Error && error.name === "AbortError";
+    if (aborted && abort.timedOut()) {
+      return new ItdTimeoutError({ timeout, method, path: request.path });
     }
-    if (!isRetryable(error, method, options.retryWrites)) return void 0;
-    if (error instanceof ItdApiError && error.retryAfter !== void 0) {
-      return error.retryAfter > options.maxDelay ? void 0 : error.retryAfter;
+    if (aborted) {
+      return new ItdAbortError(`\u0417\u0430\u043F\u0440\u043E\u0441 ${method} ${request.path} \u043E\u0442\u043C\u0435\u043D\u0451\u043D`);
     }
-    return backoffDelay(attempt, options, random);
-  };
-}
+    return new ItdNetworkError(
+      `\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0432\u044B\u043F\u043E\u043B\u043D\u0438\u0442\u044C ${method} ${request.path}: ${error instanceof Error ? error.message : String(error)}`,
+      { method, path: request.path, cause: error }
+    );
+  }
+};
 
 // src/notifications/type-map.ts
 var NOTIFICATION_TYPE_ALIASES = Object.freeze({
@@ -3034,7 +3131,7 @@ var RealtimeTransportKind = Object.freeze({
 var ItdRealtime = class {
   #deps;
   #options;
-  #emitter = new Emitter();
+  #emitter;
   #transport;
   #maxAttempts;
   #controller;
@@ -3056,6 +3153,11 @@ var ItdRealtime = class {
     this.#options = options;
     this.#maxAttempts = options.maxAttempts ?? MAX_RECONNECT_ATTEMPTS;
     this.#transport = this.#createTransport();
+    this.#emitter = new Emitter((error) => {
+      const message = "\u041E\u0448\u0438\u0431\u043A\u0430 \u0432 \u043E\u0431\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0435 \u0441\u043E\u0431\u044B\u0442\u0438\u044F realtime";
+      if (deps.logger) deps.logger.error(message, error);
+      else console.error(`[itd-api] ${message}`, error);
+    });
   }
   /** Текущее состояние соединения. */
   get status() {
@@ -3107,6 +3209,7 @@ var ItdRealtime = class {
     this.#controller = void 0;
     this.#attempt = 0;
     this.#setStatus(RealtimeStatus.Disconnected);
+    this.#deps.onClose?.();
   }
   /** Снимает все подписки. Соединение при этом не закрывается. */
   removeAllListeners() {
@@ -3405,6 +3508,14 @@ var Paginator = class {
   }
 };
 
+// src/types/options.ts
+var REQUEST_OPTION_KEYS = [
+  "signal",
+  "timeout",
+  "headers",
+  "retry"
+];
+
 // src/resources/base.ts
 var BaseResource = class {
   /** @internal */
@@ -3413,28 +3524,25 @@ var BaseResource = class {
     this.http = http;
   }
   /**
-   * Переносит общие поля опций запроса в параметры транспорта.
+   * Переносит опции запроса в описание транспорта.
    *
-   * Поля перечислены поимённо, а не скопированы целиком: параметры методов наследуют
-   * {@link RequestOptions} и приносят с собой `limit`, `cursor` и прочее, чему в описании
-   * запроса делать нечего. Исключение — опции, заявленные плагинами: их библиотека
+   * Копируются только поля {@link REQUEST_OPTION_KEYS} и опции, заявленные плагинами:
+   * параметры методов наследуют {@link RequestOptions} и приносят с собой `limit`, `cursor`
+   * и прочее, чему в описании запроса делать нечего. Чужие опции плагинов библиотека
    * не понимает, но обязана донести до обёрток нетронутыми.
    */
   requestOptions(options) {
     if (!options) return {};
-    const result = {
-      ...options.signal !== void 0 ? { signal: options.signal } : {},
-      ...options.timeout !== void 0 ? { timeout: options.timeout } : {},
-      ...options.headers !== void 0 ? { headers: options.headers } : {},
-      ...options.retry !== void 0 ? { retry: options.retry } : {}
-    };
-    const pluginKeys = this.http.pluginOptionKeys;
-    if (pluginKeys.size === 0) return result;
     const source = options;
-    const target = result;
+    const result = {};
+    for (const key of REQUEST_OPTION_KEYS) {
+      const value = source[key];
+      if (value !== void 0) result[key] = value;
+    }
+    const pluginKeys = this.http.pluginOptionKeys;
     for (const key of pluginKeys) {
       const value = source[key];
-      if (value !== void 0) target[key] = value;
+      if (value !== void 0) result[key] = value;
     }
     return result;
   }
@@ -3454,6 +3562,42 @@ var BaseResource = class {
       ...options?.start !== void 0 ? { start: options.start } : {}
     });
   }
+  /**
+   * Собирает пару «загрузка страницы + перебор» из одного описания.
+   *
+   * Путь, параметры запроса и разбор ответа задаются один раз; `list` и `iterate`
+   * строятся из них.
+   *
+   * @example
+   * ```ts
+   * #feed = this.paginated<Post, FeedParams>({
+   *   path: () => '/api/posts',
+   *   query: (p) => ({ tab: p.tab, limit: p.limit }),
+   *   start: (p) => (p.cursor ? { cursor: p.cursor } : {}),
+   *   read: (body) => readCursorPage<Post>(body, 'posts'),
+   *   mode: PaginationMode.Cursor,
+   * });
+   * ```
+   */
+  paginated(spec) {
+    const load = async (params, state) => {
+      const body = await this.http.request({
+        method: "GET",
+        path: spec.path(params),
+        query: withPageState(spec.query(params), state),
+        ...this.requestOptions(params)
+      });
+      return spec.read(body, state);
+    };
+    return {
+      list: (params) => load(params, spec.start(params)),
+      iterate: (params) => this.paginate(spec.mode, (state) => load(params, state), {
+        ...params.maxPages !== void 0 ? { maxPages: params.maxPages } : {},
+        ...params.signal !== void 0 ? { signal: params.signal } : {},
+        start: spec.start(params)
+      })
+    };
+  }
 };
 function withPageState(query, state) {
   return {
@@ -3771,6 +3915,14 @@ var AuthResource = class extends BaseResource {
 // src/resources/comments.ts
 var CommentsResource = class extends BaseResource {
   #uploadFiles;
+  /** Ответы на комментарий: `/api/comments/{id}/replies`, постраничная пагинация. */
+  #replies = this.paginated({
+    path: (p) => `/api/comments/${encodePathSegment(p.commentId, "commentId")}/replies`,
+    query: (p) => ({ limit: p.limit }),
+    start: (p) => p.page !== void 0 ? { page: p.page } : {},
+    read: (body) => readPagedPage(body, "replies"),
+    mode: PaginationMode.Page
+  });
   constructor(http, deps) {
     super(http);
     this.#uploadFiles = deps.uploadFiles;
@@ -3780,31 +3932,12 @@ var CommentsResource = class extends BaseResource {
    *
    * Здесь пагинация **постраничная**, в отличие от комментариев к посту, где курсорная.
    */
-  async replies(commentId, params = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: `/api/comments/${encodePathSegment(commentId, "commentId")}/replies`,
-      query: { limit: params.limit, page: params.page },
-      ...this.requestOptions(params)
-    });
-    return readPagedPage(body, "replies");
+  replies(commentId, params = {}) {
+    return this.#replies.list({ ...params, commentId });
   }
   /** Перебирает ответы на комментарий. */
   iterateReplies(commentId, params = {}) {
-    const path = `/api/comments/${encodePathSegment(commentId, "commentId")}/replies`;
-    return this.paginate(
-      PaginationMode.Page,
-      async (state) => {
-        const body = await this.http.request({
-          method: "GET",
-          path,
-          query: withPageState({ limit: params.limit }, state),
-          ...this.requestOptions(params)
-        });
-        return readPagedPage(body, "replies");
-      },
-      { ...params, ...params.page !== void 0 ? { start: { page: params.page } } : {} }
-    );
+    return this.#replies.iterate({ ...params, commentId });
   }
   /**
    * Отвечает на комментарий.
@@ -3939,19 +4072,14 @@ function assertAllowedMime(mimeType, filename) {
 var DEFAULT_UPLOAD_TIMEOUT = 3e5;
 var FilesResource = class extends BaseResource {
   #readFile;
+  /**
+   * @param deps.readFile чтение файлов с диска. Передаёт точка входа `itd-api/node`;
+   * в основном бандле его нет, чтобы браузерные сборщики не пытались разрешить `node:fs`.
+   */
   constructor(http, deps = {}) {
     super(http);
     this.#readFile = deps.readFile;
   }
-  /**
-   * Подключает чтение файлов с диска.
-   *
-   * Вызывается точкой входа `itd-api/node`; в основном бандле работы с файловой
-   * системой нет, чтобы браузерные сборщики не пытались разрешить `node:fs`.
-   */
-  setFileReader(readFile) {
-    this.#readFile = readFile;
-  }
   /**
    * Загружает файл и возвращает его идентификатор.
    *
@@ -4061,8 +4189,16 @@ var FilesResource = class extends BaseResource {
   }
 };
 
-// src/resources/misc.ts
+// src/resources/hashtags.ts
 var HashtagsResource = class extends BaseResource {
+  /** Посты по хэштегу: `/api/hashtags/{tag}/posts`, курсорная пагинация. */
+  #posts = this.paginated({
+    path: (p) => `/api/hashtags/${encodePathSegment(p.tag, "tag")}/posts`,
+    query: (p) => ({ limit: p.limit }),
+    start: (p) => p.cursor ? { cursor: p.cursor } : {},
+    read: (body) => readCursorPage(body, "posts"),
+    mode: PaginationMode.Cursor
+  });
   /**
    * Ищет хэштеги.
    *
@@ -4089,214 +4225,52 @@ var HashtagsResource = class extends BaseResource {
   }
   /**
    * Загружает страницу постов по хэштегу.
-   *
-   * @param tag название без решётки; кодируется автоматически, поэтому кириллица
-   * и пробелы допустимы
-   */
-  async posts(tag, params = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: `/api/hashtags/${encodePathSegment(tag, "tag")}/posts`,
-      query: { limit: params.limit, cursor: params.cursor },
-      ...this.requestOptions(params)
-    });
-    return readCursorPage(body, "posts");
-  }
-  /** Перебирает посты по хэштегу. */
-  iteratePosts(tag, params = {}) {
-    const path = `/api/hashtags/${encodePathSegment(tag, "tag")}/posts`;
-    return this.paginate(
-      PaginationMode.Cursor,
-      async (state) => {
-        const body = await this.http.request({
-          method: "GET",
-          path,
-          query: withPageState({ limit: params.limit }, state),
-          ...this.requestOptions(params)
-        });
-        return readCursorPage(body, "posts");
-      },
-      { ...params, ...params.cursor ? { start: { cursor: params.cursor } } : {} }
-    );
-  }
-};
-var SearchResource = class extends BaseResource {
-  /**
-   * Ищет пользователей и хэштеги одним запросом.
-   *
-   * @example
-   * ```ts
-   * const { users, hashtags } = await itd.search.all('арт');
-   * ```
-   */
-  async all(query, options = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: "/api/search",
-      query: { q: query },
-      ...this.requestOptions(options)
-    });
-    return {
-      users: pickArray(body, "users"),
-      hashtags: pickArray(body, "hashtags")
-    };
-  }
-};
-var ReportsResource = class extends BaseResource {
-  /**
-   * Отправляет жалобу.
-   *
-   * Повторная жалоба на тот же объект отклоняется сервером с сообщением
-   * «Вы уже отправляли жалобу на этот контент».
-   *
-   * @example
-   * ```ts
-   * await itd.reports.create(report.post(postId).reason('spam'));
-   * await itd.reports.create({ targetType: 'user', targetId, reason: 'fraud' });
-   * ```
-   */
-  create(input, options = {}) {
-    const data = resolveReport(input);
-    return this.http.request({
-      method: "POST",
-      path: "/api/reports",
-      body: data,
-      ...this.requestOptions(options)
-    });
-  }
-};
-var VerificationResource = class extends BaseResource {
-  /** Загружает статус заявки. Значение `none` означает, что заявка не подавалась. */
-  status(options = {}) {
-    return this.http.request({
-      method: "GET",
-      path: "/api/verification/status",
-      ...this.requestOptions(options)
-    });
-  }
-  /** Подаёт заявку на верификацию с видео. */
-  submit(videoUrl, options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: "/api/verification/submit",
-      body: { videoUrl },
-      ...this.requestOptions(options)
-    });
-  }
-};
-var SubscriptionResource = class extends BaseResource {
-  /** Загружает состояние подписки и её цену. */
-  status(options = {}) {
-    return this.http.request({
-      method: "GET",
-      // Завершающий слэш обязателен.
-      path: "/api/v1/subscription/",
-      ...this.requestOptions(options)
-    });
-  }
-  /**
-   * Запускает оплату подписки.
-   *
-   * Форма ответа в документации API не описана, поэтому тип результата не уточняется.
-   */
-  pay(options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: "/api/v1/subscription/pay",
-      ...this.requestOptions(options)
-    });
-  }
-  /** Включает или отключает автопродление. */
-  setAutoRenewal(enabled, options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: "/api/v1/subscription/auto-renewal",
-      body: { enabled },
-      ...this.requestOptions(options)
-    });
-  }
-  /** Запускает привязку карты. */
-  bindCard(options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: "/api/v1/subscription/bind-card",
-      ...this.requestOptions(options)
-    });
-  }
-  /** Загружает список способов оплаты. Пустой массив, если карт нет. */
-  async methods(options = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: "/api/v1/subscription/methods",
-      ...this.requestOptions(options)
-    });
-    return Array.isArray(body) ? body : [];
-  }
-  /** Делает способ оплаты основным. */
-  setDefaultMethod(methodId, options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: `/api/v1/subscription/methods/${encodePathSegment(methodId, "methodId")}/default`,
-      ...this.requestOptions(options)
-    });
-  }
-  /** Удаляет способ оплаты. */
-  removeMethod(methodId, options = {}) {
-    return this.http.request({
-      method: "DELETE",
-      path: `/api/v1/subscription/methods/${encodePathSegment(methodId, "methodId")}`,
-      ...this.requestOptions(options)
-    });
-  }
-};
-var PlatformResource = class extends BaseResource {
-  /** Загружает журнал изменений. */
-  async changelog(options = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: "/api/platform/changelog",
-      ...this.requestOptions(options)
-    });
-    return Array.isArray(body) ? body : [];
-  }
-  /** Загружает анонсы платформы. */
-  async announcements(options = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: "/api/platform/announcements",
-      ...this.requestOptions(options)
-    });
-    return pickArray(body, "announcements");
-  }
-  /** Загружает баннер текущего события — виджет «портал». */
-  portal(options = {}) {
-    return this.http.request({
-      method: "GET",
-      path: "/api/v1/portal",
-      ...this.requestOptions(options)
-    });
+   *
+   * @param tag название без решётки; кодируется автоматически, поэтому кириллица
+   * и пробелы допустимы
+   */
+  posts(tag, params = {}) {
+    return this.#posts.list({ ...params, tag });
+  }
+  /** Перебирает посты по хэштегу. */
+  iteratePosts(tag, params = {}) {
+    return this.#posts.iterate({ ...params, tag });
   }
 };
 
 // src/resources/notifications.ts
+var NOTIFICATION_SETTING_KEYS = [
+  "enabled",
+  "sound",
+  "follows",
+  "wallPosts",
+  "likes",
+  "comments",
+  "mentions"
+];
 var READ_BATCH_SIZE = 20;
 function readSettings(body) {
-  return {
-    enabled: pickBoolean(body, "enabled", true),
-    sound: pickBoolean(body, "sound", true),
-    follows: pickBoolean(body, "follows", true),
-    wallPosts: pickBoolean(body, "wallPosts", true),
-    likes: pickBoolean(body, "likes", true),
-    comments: pickBoolean(body, "comments", true),
-    mentions: pickBoolean(body, "mentions", true)
-  };
+  const settings = {};
+  for (const key of NOTIFICATION_SETTING_KEYS) settings[key] = pickBoolean(body, key, true);
+  return settings;
 }
 var NotificationsResource = class extends BaseResource {
+  /** Уведомления: `/api/notifications/`, пагинация по смещению. */
+  #list = this.paginated({
+    // Завершающий слэш обязателен: без него сервер отвечает ошибкой.
+    path: () => "/api/notifications/",
+    query: (p) => ({ limit: p.limit }),
+    start: (p) => ({ offset: p.offset ?? 0 }),
+    read: (body, state) => {
+      const page = readOffsetPage(body, "notifications", state.offset ?? 0);
+      return { ...page, items: page.items.map(normalizeNotification) };
+    },
+    mode: PaginationMode.Offset
+  });
   /**
    * Загружает страницу уведомлений.
    *
-   * Пагинация здесь основана на смещении. Сайт итд.com оборачивает смещение в строку
-   * и притворяется, что это курсор; библиотека отдаёт честное число.
+   * Пагинация здесь основана на смещении.
    *
    * @example
    * ```ts
@@ -4305,19 +4279,7 @@ var NotificationsResource = class extends BaseResource {
    * ```
    */
   list(params = {}) {
-    return this.#loadPage(params, params.offset ?? 0);
-  }
-  /** Общая загрузка страницы для {@link list} и {@link iterate}. */
-  async #loadPage(params, offset) {
-    const body = await this.http.request({
-      method: "GET",
-      // Завершающий слэш обязателен: без него сервер отвечает ошибкой.
-      path: "/api/notifications/",
-      query: { limit: params.limit, offset },
-      ...this.requestOptions(params)
-    });
-    const page = readOffsetPage(body, "notifications", offset);
-    return { ...page, items: page.items.map(normalizeNotification) };
+    return this.#list.list(params);
   }
   /**
    * Перебирает уведомления.
@@ -4330,11 +4292,7 @@ var NotificationsResource = class extends BaseResource {
    * ```
    */
   iterate(params = {}) {
-    return this.paginate(
-      PaginationMode.Offset,
-      (state) => this.#loadPage(params, state.offset ?? 0),
-      { ...params, ...params.offset !== void 0 ? { start: { offset: params.offset } } : {} }
-    );
+    return this.#list.iterate(params);
   }
   /** Загружает число непрочитанных уведомлений. */
   async count(options = {}) {
@@ -4406,15 +4364,7 @@ var NotificationsResource = class extends BaseResource {
    */
   async updateSettings(input, options = {}) {
     const payload = {};
-    for (const key of [
-      "enabled",
-      "sound",
-      "follows",
-      "wallPosts",
-      "likes",
-      "comments",
-      "mentions"
-    ]) {
+    for (const key of NOTIFICATION_SETTING_KEYS) {
       const value = input[key];
       if (value !== void 0) payload[key] = value;
     }
@@ -4428,9 +4378,74 @@ var NotificationsResource = class extends BaseResource {
   }
 };
 
+// src/resources/platform.ts
+var PlatformResource = class extends BaseResource {
+  /** Загружает журнал изменений. */
+  async changelog(options = {}) {
+    const body = await this.http.request({
+      method: "GET",
+      path: "/api/platform/changelog",
+      ...this.requestOptions(options)
+    });
+    return Array.isArray(body) ? body : [];
+  }
+  /** Загружает анонсы платформы. */
+  async announcements(options = {}) {
+    const body = await this.http.request({
+      method: "GET",
+      path: "/api/platform/announcements",
+      ...this.requestOptions(options)
+    });
+    return pickArray(body, "announcements");
+  }
+  /** Загружает баннер текущего события — виджет «портал». */
+  portal(options = {}) {
+    return this.http.request({
+      method: "GET",
+      path: "/api/v1/portal",
+      ...this.requestOptions(options)
+    });
+  }
+};
+
 // src/resources/posts.ts
+function cursorStart(params) {
+  return params.cursor ? { cursor: params.cursor } : {};
+}
 var PostsResource = class extends BaseResource {
   #uploadFiles;
+  /** Лента: `/api/posts`, курсорная пагинация. */
+  #feed = this.paginated({
+    path: () => "/api/posts",
+    query: (p) => ({ tab: p.tab, limit: p.limit }),
+    start: cursorStart,
+    read: (body) => readCursorPage(body, "posts"),
+    mode: PaginationMode.Cursor
+  });
+  /** Стена пользователя: `/api/posts/user/{user}`. */
+  #wall = this.paginated({
+    path: (p) => `/api/posts/user/${encodePathSegment(p.user, "user")}`,
+    query: (p) => ({ limit: p.limit, sort: p.sort, pinnedPostId: p.pinnedPostId }),
+    start: cursorStart,
+    read: (body) => readCursorPage(body, "posts"),
+    mode: PaginationMode.Cursor
+  });
+  /** Понравившиеся посты пользователя: `/api/posts/user/{user}/liked`. */
+  #liked = this.paginated({
+    path: (p) => `/api/posts/user/${encodePathSegment(p.user, "user")}/liked`,
+    query: (p) => ({ limit: p.limit }),
+    start: cursorStart,
+    read: (body) => readCursorPage(body, "posts"),
+    mode: PaginationMode.Cursor
+  });
+  /** Комментарии к посту: курсор лежит рядом со списком, поэтому свой reader. */
+  #comments = this.paginated({
+    path: (p) => `/api/posts/${encodePathSegment(p.postId, "postId")}/comments`,
+    query: (p) => ({ limit: p.limit, sort: p.sort }),
+    start: cursorStart,
+    read: (body) => readFlatCursorPage(body, "comments"),
+    mode: PaginationMode.Cursor
+  });
   constructor(http, deps) {
     super(http);
     this.#uploadFiles = deps.uploadFiles;
@@ -4444,14 +4459,8 @@ var PostsResource = class extends BaseResource {
    * const next = await itd.posts.list({ tab: FeedTab.Following, cursor: page.nextCursor ?? undefined });
    * ```
    */
-  async list(params = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: "/api/posts",
-      query: { tab: params.tab, limit: params.limit, cursor: params.cursor },
-      ...this.requestOptions(params)
-    });
-    return readCursorPage(body, "posts");
+  list(params = {}) {
+    return this.#feed.list(params);
   }
   /**
    * Перебирает ленту, сама подставляя курсоры.
@@ -4464,19 +4473,7 @@ var PostsResource = class extends BaseResource {
    * ```
    */
   iterate(params = {}) {
-    return this.paginate(
-      PaginationMode.Cursor,
-      async (state) => {
-        const body = await this.http.request({
-          method: "GET",
-          path: "/api/posts",
-          query: withPageState({ tab: params.tab, limit: params.limit }, state),
-          ...this.requestOptions(params)
-        });
-        return readCursorPage(body, "posts");
-      },
-      { ...params, ...params.cursor ? { start: { cursor: params.cursor } } : {} }
-    );
+    return this.#feed.iterate(params);
   }
   /**
    * Публикует пост.
@@ -4630,66 +4627,20 @@ var PostsResource = class extends BaseResource {
    *
    * Принимает и UUID, и имя пользователя.
    */
-  async byUser(user, params = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: `/api/posts/user/${encodePathSegment(user, "user")}`,
-      query: {
-        limit: params.limit,
-        cursor: params.cursor,
-        sort: params.sort,
-        pinnedPostId: params.pinnedPostId
-      },
-      ...this.requestOptions(params)
-    });
-    return readCursorPage(body, "posts");
+  byUser(user, params = {}) {
+    return this.#wall.list({ ...params, user });
   }
   /** Перебирает стену пользователя. Что именно в неё входит — см. {@link byUser}. */
   iterateByUser(user, params = {}) {
-    const path = `/api/posts/user/${encodePathSegment(user, "user")}`;
-    return this.paginate(
-      PaginationMode.Cursor,
-      async (state) => {
-        const body = await this.http.request({
-          method: "GET",
-          path,
-          query: withPageState(
-            { limit: params.limit, sort: params.sort, pinnedPostId: params.pinnedPostId },
-            state
-          ),
-          ...this.requestOptions(params)
-        });
-        return readCursorPage(body, "posts");
-      },
-      { ...params, ...params.cursor ? { start: { cursor: params.cursor } } : {} }
-    );
+    return this.#wall.iterate({ ...params, user });
   }
   /** Загружает страницу постов, которые пользователь отметил реакцией. */
-  async likedByUser(user, params = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: `/api/posts/user/${encodePathSegment(user, "user")}/liked`,
-      query: { limit: params.limit, cursor: params.cursor },
-      ...this.requestOptions(params)
-    });
-    return readCursorPage(body, "posts");
+  likedByUser(user, params = {}) {
+    return this.#liked.list({ ...params, user });
   }
   /** Перебирает посты, которые пользователь отметил реакцией. */
   iterateLikedByUser(user, params = {}) {
-    const path = `/api/posts/user/${encodePathSegment(user, "user")}/liked`;
-    return this.paginate(
-      PaginationMode.Cursor,
-      async (state) => {
-        const body = await this.http.request({
-          method: "GET",
-          path,
-          query: withPageState({ limit: params.limit }, state),
-          ...this.requestOptions(params)
-        });
-        return readCursorPage(body, "posts");
-      },
-      { ...params, ...params.cursor ? { start: { cursor: params.cursor } } : {} }
-    );
+    return this.#liked.iterate({ ...params, user });
   }
   /**
    * Загружает страницу комментариев к посту.
@@ -4697,31 +4648,12 @@ var PostsResource = class extends BaseResource {
    * У этого эндпоинта курсор и признак продолжения лежат рядом со списком, а не внутри
    * объекта `pagination`, как у остальных, — разница скрыта внутри.
    */
-  async comments(postId, params = {}) {
-    const body = await this.http.request({
-      method: "GET",
-      path: `/api/posts/${encodePathSegment(postId, "postId")}/comments`,
-      query: { limit: params.limit, cursor: params.cursor, sort: params.sort },
-      ...this.requestOptions(params)
-    });
-    return readFlatCursorPage(body, "comments");
+  comments(postId, params = {}) {
+    return this.#comments.list({ ...params, postId });
   }
   /** Перебирает комментарии к посту. */
   iterateComments(postId, params = {}) {
-    const path = `/api/posts/${encodePathSegment(postId, "postId")}/comments`;
-    return this.paginate(
-      PaginationMode.Cursor,
-      async (state) => {
-        const body = await this.http.request({
-          method: "GET",
-          path,
-          query: withPageState({ limit: params.limit, sort: params.sort }, state),
-          ...this.requestOptions(params)
-        });
-        return readFlatCursorPage(body, "comments");
-      },
-      { ...params, ...params.cursor ? { start: { cursor: params.cursor } } : {} }
-    );
+    return this.#comments.iterate({ ...params, postId });
   }
   /**
    * Комментирует пост.
@@ -4766,6 +4698,122 @@ var PostsResource = class extends BaseResource {
   }
 };
 
+// src/resources/reports.ts
+var ReportsResource = class extends BaseResource {
+  /**
+   * Отправляет жалобу.
+   *
+   * Повторная жалоба на тот же объект отклоняется сервером с сообщением
+   * «Вы уже отправляли жалобу на этот контент».
+   *
+   * @example
+   * ```ts
+   * await itd.reports.create(report.post(postId).reason('spam'));
+   * await itd.reports.create({ targetType: 'user', targetId, reason: 'fraud' });
+   * ```
+   */
+  create(input, options = {}) {
+    const data = resolveReport(input);
+    return this.http.request({
+      method: "POST",
+      path: "/api/reports",
+      body: data,
+      ...this.requestOptions(options)
+    });
+  }
+};
+
+// src/resources/search.ts
+var SearchResource = class extends BaseResource {
+  /**
+   * Ищет пользователей и хэштеги одним запросом.
+   *
+   * @example
+   * ```ts
+   * const { users, hashtags } = await itd.search.all('арт');
+   * ```
+   */
+  async all(query, options = {}) {
+    const body = await this.http.request({
+      method: "GET",
+      path: "/api/search",
+      query: { q: query },
+      ...this.requestOptions(options)
+    });
+    return {
+      users: pickArray(body, "users"),
+      hashtags: pickArray(body, "hashtags")
+    };
+  }
+};
+
+// src/resources/subscription.ts
+var SubscriptionResource = class extends BaseResource {
+  /** Загружает состояние подписки и её цену. */
+  status(options = {}) {
+    return this.http.request({
+      method: "GET",
+      // Завершающий слэш обязателен.
+      path: "/api/v1/subscription/",
+      ...this.requestOptions(options)
+    });
+  }
+  /**
+   * Запускает оплату подписки.
+   *
+   * Форма ответа в документации API не описана, поэтому тип результата не уточняется.
+   */
+  pay(options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: "/api/v1/subscription/pay",
+      ...this.requestOptions(options)
+    });
+  }
+  /** Включает или отключает автопродление. */
+  setAutoRenewal(enabled, options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: "/api/v1/subscription/auto-renewal",
+      body: { enabled },
+      ...this.requestOptions(options)
+    });
+  }
+  /** Запускает привязку карты. */
+  bindCard(options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: "/api/v1/subscription/bind-card",
+      ...this.requestOptions(options)
+    });
+  }
+  /** Загружает список способов оплаты. Пустой массив, если карт нет. */
+  async methods(options = {}) {
+    const body = await this.http.request({
+      method: "GET",
+      path: "/api/v1/subscription/methods",
+      ...this.requestOptions(options)
+    });
+    return Array.isArray(body) ? body : [];
+  }
+  /** Делает способ оплаты основным. */
+  setDefaultMethod(methodId, options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: `/api/v1/subscription/methods/${encodePathSegment(methodId, "methodId")}/default`,
+      ...this.requestOptions(options)
+    });
+  }
+  /** Удаляет способ оплаты. */
+  removeMethod(methodId, options = {}) {
+    return this.http.request({
+      method: "DELETE",
+      path: `/api/v1/subscription/methods/${encodePathSegment(methodId, "methodId")}`,
+      ...this.requestOptions(options)
+    });
+  }
+};
+
 // src/resources/telemetry.ts
 var TelemetryResource = class extends BaseResource {
   /** Идентификатор сессии телеметрии, общий для всех событий этого объекта. */
@@ -4832,6 +4880,21 @@ var TelemetryResource = class extends BaseResource {
 
 // src/resources/users.ts
 var UsersResource = class extends BaseResource {
+  /**
+   * Списки пользователей: подписчики, подписки, заблокированные.
+   *
+   * Путь приходит в параметрах — так один описатель обслуживает все три эндпоинта. Имена
+   * полей перечислены с запасом: списки приходят под `users`, но альтернативное имя ничего
+   * не стоит и спасает, если эндпоинт назовёт список по-своему. `page` уходит в запрос, хотя
+   * сервер его сейчас не читает (см. {@link followers}): когда починят — заработает само.
+   */
+  #userList = this.paginated({
+    path: (p) => p.path,
+    query: (p) => ({ limit: p.limit }),
+    start: (p) => p.page !== void 0 ? { page: p.page } : {},
+    read: (body) => readPagedPage(body, "users", "followers", "following", "blocked"),
+    mode: PaginationMode.Page
+  });
   /** Загружает свой профиль — с подпиской и признаком подтверждённого телефона. */
   me(options = {}) {
     return this.http.request({
@@ -5077,38 +5140,33 @@ var UsersResource = class extends BaseResource {
       ...this.requestOptions(options)
     });
   }
-  /**
-   * Загружает одну страницу списка пользователей.
-   *
-   * Имена полей перечислены с запасом: списки подписчиков и заблокированных приходят
-   * под `users`, но альтернативное имя ничего не стоит и спасает, если эндпоинт назовёт
-   * список по-своему.
-   *
-   * `page` уходит в запрос, хотя сервер его сейчас не читает (см. {@link followers}):
-   * когда пагинацию починят, работать начнёт само.
-   */
-  async #loadUserPage(path, params, state) {
-    const body = await this.http.request({
+  #userPage(path, params) {
+    return this.#userList.list({ ...params, path });
+  }
+  #userPaginator(path, params) {
+    return this.#userList.iterate({ ...params, path });
+  }
+};
+
+// src/resources/verification.ts
+var VerificationResource = class extends BaseResource {
+  /** Загружает статус заявки. Значение `none` означает, что заявка не подавалась. */
+  status(options = {}) {
+    return this.http.request({
       method: "GET",
-      path,
-      query: withPageState({ limit: params.limit }, state),
-      ...this.requestOptions(params)
+      path: "/api/verification/status",
+      ...this.requestOptions(options)
     });
-    return readPagedPage(body, "users", "followers", "following", "blocked");
   }
-  #userPage(path, params) {
-    return this.#loadUserPage(path, params, {
-      ...params.page !== void 0 ? { page: params.page } : {}
+  /** Подаёт заявку на верификацию с видео. */
+  submit(videoUrl, options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: "/api/verification/submit",
+      body: { videoUrl },
+      ...this.requestOptions(options)
     });
   }
-  #userPaginator(path, params) {
-    return this.paginate(
-      PaginationMode.Page,
-      (state) => this.#loadUserPage(path, params, state),
-      // Без `start` перебор начинался бы с первой страницы, молча игнорируя `page`.
-      { ...params, ...params.page !== void 0 ? { start: { page: params.page } } : {} }
-    );
-  }
 };
 
 // src/client.ts
@@ -5119,6 +5177,8 @@ var ItdClient = class {
   #jar;
   #queue;
   #plugins = new PluginRegistry();
+  /** Порождённые потоки уведомлений — чтобы `close()` мог закрыть их разом. */
+  #streams = /* @__PURE__ */ new Set();
   /** Авторизация, сессии и пароли. */
   auth;
   /** Профили, подписки, блокировки, приватность. */
@@ -5149,26 +5209,56 @@ var ItdClient = class {
    * @experimental Недокументированные эндпоинты. Библиотека никогда не отправляет их сама.
    */
   telemetry;
-  constructor(options = {}) {
-    this.#config = resolveConfig(options);
+  constructor(options = {}, internals = {}) {
+    const config = resolveConfig(options);
+    this.#config = config;
     this.#jar = new CookieJar();
-    this.#http = new HttpClient(this.#config);
-    this.#authManager = new AuthManager(this.#config, this.#http, this.#jar);
-    this.#queue = this.#config.rateLimit ? new RequestQueue(this.#config.rateLimit) : void 0;
-    this.#http.usePlugins(this.#plugins);
-    this.#http.setCollaborators({
-      getAuthHeaders: () => this.#authManager.getAuthHeaders(),
-      getDeviceId: () => this.#authManager.getDeviceId(),
-      onUnauthorized: () => this.#authManager.onUnauthorized(),
-      getCookieHeader: (url) => this.#jar.getHeader(url),
-      saveCookies: (url, response) => this.#jar.setFromResponse(url, response),
-      ...this.#queue ? { schedule: this.#queue.schedule.bind(this.#queue) } : {},
-      // Планировщик нужен, даже когда обычные повторы выключены: лимит частоты
-      // живёт по своим правилам и настраивается отдельно, в `rateLimit`.
-      ...this.#config.retry || this.#config.rateLimit ? { nextRetryDelay: this.#createRetryScheduler() } : {},
-      ...this.#queue && this.#config.rateLimit?.respectHeaders ? { onRateLimit: this.#throttleByHeaders.bind(this) } : {}
+    const queue = config.rateLimit ? new RequestQueue(config.rateLimit) : void 0;
+    this.#queue = queue;
+    let authManager;
+    const transport = new Transport(config, {
+      cookies: config.useCookieJar ? this.#jar : void 0,
+      getDeviceId: () => authManager.getDeviceId(),
+      onRateLimit: queue && config.rateLimit?.respectHeaders ? (limit, remaining) => this.#throttleByHeaders(limit, remaining) : void 0
     });
-    this.files = new FilesResource(this.#http);
+    const pluginsLayer = createPluginsMiddleware(this.#plugins);
+    const retriesLayer = createRetryMiddleware({
+      retry: config.retry,
+      rateLimitDelays: config.rateLimit?.retryDelays ?? [],
+      pauseQueue: queue ? (ms) => queue.pause(ms) : void 0,
+      hooks: config.hooks,
+      logger: config.logger,
+      buildUrl: (request) => transport.buildUrl(request)
+    });
+    const authRetry = config.retry ? {
+      attempts: config.retry.attempts,
+      baseDelay: config.retry.baseDelay,
+      maxDelay: config.retry.maxDelay,
+      jitter: config.retry.jitter,
+      retryWrites: true,
+      ...config.retry.shouldRetry ? { shouldRetry: config.retry.shouldRetry } : {}
+    } : void 0;
+    const authPipeline = composePipeline([pluginsLayer, retriesLayer], transport.send);
+    const authHandler = (request) => authRetry && request.retry === void 0 ? authPipeline({ ...request, retry: authRetry }) : authPipeline(request);
+    authManager = new AuthManager(config, authHandler, this.#jar);
+    this.#authManager = authManager;
+    const middlewares = [];
+    if (queue) middlewares.push(createQueueMiddleware(queue.schedule.bind(queue)));
+    middlewares.push(pluginsLayer);
+    middlewares.push(retriesLayer);
+    middlewares.push(
+      createAuthMiddleware({
+        getAuthHeaders: () => authManager.getAuthHeaders(),
+        onUnauthorized: () => authManager.onUnauthorized(),
+        autoRefresh: config.autoRefresh
+      })
+    );
+    const handler = composePipeline(middlewares, transport.send);
+    this.#http = new HttpClient({ handler, plugins: this.#plugins, baseUrl: config.baseUrl });
+    this.files = new FilesResource(
+      this.#http,
+      internals.fileReader ? { readFile: internals.fileReader } : {}
+    );
     const uploadFiles = (files, requestOptions) => this.files.uploadMany(files, requestOptions ?? {});
     this.auth = new AuthResource(this.#http, { auth: this.#authManager });
     this.users = new UsersResource(this.#http);
@@ -5258,17 +5348,44 @@ var ItdClient = class {
    * ```
    */
   realtime(options = {}) {
-    return new ItdRealtime(
+    let stream;
+    stream = new ItdRealtime(
       {
         baseUrl: this.#config.baseUrl,
         fetch: this.#config.fetch,
         getToken: () => this.#authManager.getAccessToken(),
         refresh: () => this.#authManager.onUnauthorized(),
         fetchUnreadCount: () => this.notifications.count(),
+        onClose: () => this.#streams.delete(stream),
         logger: this.#config.logger
       },
       options
     );
+    this.#streams.add(stream);
+    return stream;
+  }
+  /**
+   * Освобождает ресурсы клиента: останавливает очередь запросов (снимает отложенные паузы)
+   * и закрывает все потоки уведомлений, созданные через {@link realtime}.
+   *
+   * После вызова клиентом можно пользоваться снова — новые запросы поднимут всё заново,
+   * но уже созданные потоки останутся закрытыми.
+   *
+   * @example
+   * ```ts
+   * await using itd = new ItdClient({ auth: token });
+   * // …работа…
+   * // close() вызовется сам на выходе из блока
+   * ```
+   */
+  async close() {
+    for (const stream of this.#streams) stream.disconnect();
+    this.#streams.clear();
+    this.#queue?.stop();
+  }
+  /** Позволяет использовать клиент с `await using`. */
+  [Symbol.asyncDispose]() {
+    return this.close();
   }
   /** Текущая сессия целиком — чтобы сохранить её самостоятельно. */
   getSession() {
@@ -5278,16 +5395,6 @@ var ItdClient = class {
   setSession(session) {
     return this.#authManager.setSession(session);
   }
-  /**
-   * Подключает чтение файлов с диска.
-   *
-   * Вызывается из `itd-api/node`; напрямую обычно не нужно.
-   *
-   * @internal
-   */
-  setFileReader(readFile) {
-    this.files.setFileReader(readFile);
-  }
   /**
    * Придерживает очередь, когда лимит сервера исчерпан.
    *
@@ -5308,35 +5415,12 @@ var ItdClient = class {
       `\u043B\u0438\u043C\u0438\u0442 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0438\u0441\u0447\u0435\u0440\u043F\u0430\u043D (${remaining} \u0438\u0437 ${limit ?? "?"}), \u043E\u0447\u0435\u0440\u0435\u0434\u044C \u0436\u0434\u0451\u0442 ${first} \u043C\u0441`
     );
   }
-  /**
-   * Собирает планировщик повторов и связывает его с очередью.
-   *
-   * Ответ `429` обрабатывается отдельно от прочих ошибок. Причина в том, что сервер
-   * не присылает `Retry-After` и не сообщает время сброса окна: экспоненциальный откат
-   * в сотни миллисекунд здесь бесполезен, а окно измеряется десятками секунд. Вместо
-   * расчёта берётся лестница пауз `rateLimit.retryDelays`, и она не зависит
-   * от `retry.attempts`, у которого совсем другая задача.
-   *
-   * Пауза накладывается на всю очередь: иначе остальные запросы продолжат добивать API,
-   * пока первый ждёт.
-   */
-  #createRetryScheduler() {
-    const retry = this.#config.retry;
-    const scheduler = retry ? createRetryScheduler(retry) : void 0;
-    const queue = this.#queue;
-    const delays = this.#config.rateLimit?.retryDelays ?? [];
-    return (error, attempt, method) => {
-      if (isItdRateLimitError(error)) {
-        const wait = error.retryAfter ?? delays[attempt - 1];
-        if (wait === void 0) return void 0;
-        queue?.pause(wait);
-        this.#config.logger?.debug(`\u043B\u0438\u043C\u0438\u0442 \u0447\u0430\u0441\u0442\u043E\u0442\u044B, \u043F\u043E\u043F\u044B\u0442\u043A\u0430 ${attempt + 1} \u0447\u0435\u0440\u0435\u0437 ${wait} \u043C\u0441`);
-        return wait;
-      }
-      return scheduler?.(error, attempt, method);
-    };
-  }
 };
+if (typeof Symbol.asyncDispose !== "symbol") {
+  const prototype = ItdClient.prototype;
+  prototype[/* @__PURE__ */ Symbol.for("Symbol.asyncDispose")] = prototype.undefined;
+  delete prototype.undefined;
+}
 function createClient(options = {}) {
   return new ItdClient(options);
 }
@@ -5536,5 +5620,5 @@ exports.readUnreadCountEvent = readUnreadCountEvent;
 exports.report = report;
 exports.resolveNotificationUrl = resolveNotificationUrl;
 exports.toDate = toDate;
-//# sourceMappingURL=chunk-3RNNZJZ4.cjs.map
-//# sourceMappingURL=chunk-3RNNZJZ4.cjs.map
+//# sourceMappingURL=chunk-ATCZ4T2K.cjs.map
+//# sourceMappingURL=chunk-ATCZ4T2K.cjs.map