itd-api 0.0.11 → 0.1.0

package/dist/{chunk-QD4UHJFF.cjs → chunk-73CISRBG.cjs}

@@ -621,8 +621,8 @@ var ItdTimeoutError = class extends ItdError {
   }
 };
 var ItdAbortError = class extends ItdError {
-  constructor(message = "\u0417\u0430\u043F\u0440\u043E\u0441 \u043E\u0442\u043C\u0435\u043D\u0451\u043D") {
-    super(ItdErrorKind.Abort, message);
+  constructor(message = "\u0417\u0430\u043F\u0440\u043E\u0441 \u043E\u0442\u043C\u0435\u043D\u0451\u043D", options) {
+    super(ItdErrorKind.Abort, message, options);
     this.name = "ItdAbortError";
   }
 };
@@ -911,6 +911,15 @@ var AuthManager = class {
   #deviceId;
   /** Общий промис первичной выдачи `deviceId` — чтобы параллельные запросы получили один. */
   #deviceIdLoading = null;
+  /**
+   * Счётчик смен владельца авторизации.
+   *
+   * Растёт при каждой операции, которая заменяет или очищает сессию извне: `clear`,
+   * `setSession`, `setAccessToken`, вход. `#performRefresh` снимает его значение перед
+   * сетевым запросом и сверяет перед записью — иначе запоздавший ответ обновления мог бы
+   * воскресить уже очищенную сессию поверх `signOut`.
+   */
+  #authEpoch = 0;
   constructor(config, send, jar, hooks = {}) {
     this.#config = config;
     this.#send = send;
@@ -956,6 +965,10 @@ var AuthManager = class {
   #rotateAuthScope() {
     this.#authScope = nextAuthScope();
   }
+  /** Отмечает смену владельца авторизации — обесценивает результат идущего обновления. */
+  #invalidateInFlight() {
+    this.#authEpoch += 1;
+  }
   #identityForToken(accessToken) {
     const token = accessToken ? readTokenIdentity(accessToken) : {};
     return {
@@ -1101,6 +1114,7 @@ var AuthManager = class {
   /** Сохраняет токен, полученный извне, — например после подтверждения OTP. */
   async setAccessToken(accessToken) {
     await this.#loadSession();
+    this.#invalidateInFlight();
     this.#transitionAuth(accessToken);
     await this.#saveSession({ ...this.#session ?? {}, accessToken, obtainedAt: Date.now() });
     this.#emitter.emit("tokens", { accessToken });
@@ -1123,6 +1137,7 @@ var AuthManager = class {
   /** Заменяет сессию и связанные с ней cookie целиком. */
   async setSession(session) {
     await this.#loadSession();
+    this.#invalidateInFlight();
     this.#transitionAuth(session.accessToken);
     this.#jar.clear();
     this.#jar.deserialize(session.cookies);
@@ -1139,6 +1154,7 @@ var AuthManager = class {
    */
   async clear() {
     await this.#loadSession();
+    this.#invalidateInFlight();
     this.#transitionAuth(void 0);
     this.#session = null;
     this.#jar.clear();
@@ -1221,6 +1237,7 @@ var AuthManager = class {
     if (!this.#hasRefreshSession()) {
       return this.#reloginOrNull();
     }
+    const epoch = this.#authEpoch;
     try {
       const payload = await this.#send({
         method: "POST",
@@ -1233,6 +1250,9 @@ var AuthManager = class {
       });
       const accessToken = readAccessToken(payload);
       if (!accessToken) return this.#reloginOrNull();
+      if (this.#authEpoch !== epoch) {
+        return this.#session?.accessToken ?? null;
+      }
       const rotated = this.#jar.getValue(
         REFRESH_COOKIE,
         this.#config.baseUrl + REFRESH_COOKIE_PATH
@@ -1248,6 +1268,9 @@ var AuthManager = class {
       return accessToken;
     } catch (error) {
       if (error instanceof ItdApiError) {
+        if (this.#authEpoch !== epoch) {
+          return this.#session?.accessToken ?? null;
+        }
         this.#transitionAuth(void 0);
         this.#session = null;
         this.#jar.clear();
@@ -1317,6 +1340,7 @@ var AuthManager = class {
         "\u0412\u0445\u043E\u0434 \u043F\u043E email \u0438 \u043F\u0430\u0440\u043E\u043B\u044E \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u043F\u043E\u0434\u0442\u0432\u0435\u0440\u0436\u0434\u0435\u043D\u0438\u044F \u043A\u043E\u0434\u043E\u043C \u0438\u0437 \u043F\u0438\u0441\u044C\u043C\u0430. \u0410\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u0432\u0445\u043E\u0434 \u043D\u0435\u0432\u043E\u0437\u043C\u043E\u0436\u0435\u043D: \u0432\u043E\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439\u0442\u0435\u0441\u044C itd.auth.signInWithOtp() \u0438 \u043F\u0435\u0440\u0435\u0434\u0430\u0439\u0442\u0435 \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u043D\u044B\u0439 accessToken \u0432 \u043A\u043E\u043D\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044E \u043A\u043B\u0438\u0435\u043D\u0442\u0430."
       );
     }
+    this.#invalidateInFlight();
     this.#transitionAuth(accessToken);
     await this.#saveSession({ accessToken, obtainedAt: Date.now() });
     this.#emitter.emit("tokens", { accessToken });
@@ -1384,7 +1408,7 @@ function normalizeBaseUrl(baseUrl) {
 }
 
 // src/core/version.ts
-var LIBRARY_VERSION = "0.0.11";
+var LIBRARY_VERSION = "0.1.0";
 
 // src/core/config.ts
 var DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
@@ -1669,6 +1693,396 @@ function withLayerHeaders(request, headers) {
   return { ...request, layerHeaders: { ...request.layerHeaders, ...headers } };
 }
 
+// src/core/plugins.ts
+var NO_KEYS = /* @__PURE__ */ new Set();
+var RESERVED_OPTION_KEYS = /* @__PURE__ */ new Set([
+  "signal",
+  "timeout",
+  "headers",
+  "retry",
+  "method",
+  "path",
+  "service",
+  "baseUrl",
+  "query",
+  "body",
+  "skipAuth",
+  "skipAuthRefresh",
+  "skipQueue",
+  "raw"
+]);
+var RELATION_FIELDS = ["requires", "conflicts", "before", "after"];
+var HOOK_FIELDS = ["onRequest", "onResponse", "onError", "onRetry"];
+function validateNameList(plugin, field) {
+  const values = plugin[field];
+  if (values === void 0) return;
+  if (!Array.isArray(values)) {
+    throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB: ${field} \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u043C\u0430\u0441\u0441\u0438\u0432\u043E\u043C`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (typeof value !== "string" || value.trim() === "") {
+      throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB: ${field} \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u0442 \u043F\u0443\u0441\u0442\u043E\u0435 \u0438\u043C\u044F \u043F\u043B\u0430\u0433\u0438\u043D\u0430`);
+    }
+    if (value === plugin.name) {
+      throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u043D\u0435 \u043C\u043E\u0436\u0435\u0442 \u0443\u043A\u0430\u0437\u0430\u0442\u044C \u0441\u0435\u0431\u044F \u0432 ${field}`);
+    }
+    if (seen.has(value)) {
+      throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB: ${field} \u043F\u043E\u0432\u0442\u043E\u0440\u044F\u0435\u0442 \u0438\u043C\u044F \xAB${value}\xBB`);
+    }
+    seen.add(value);
+  }
+}
+function validateHooks(plugin, hooks) {
+  if (typeof hooks !== "object" || hooks === null) {
+    throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin}\xBB \u043F\u0435\u0440\u0435\u0434\u0430\u043B \u0432 useHooks() \u043D\u0435 \u043E\u0431\u044A\u0435\u043A\u0442`);
+  }
+  for (const field of HOOK_FIELDS) {
+    if (hooks[field] !== void 0 && typeof hooks[field] !== "function") {
+      throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin}\xBB: useHooks().${field} \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u0444\u0443\u043D\u043A\u0446\u0438\u0435\u0439`);
+    }
+  }
+}
+function validatePluginDefinition(plugin) {
+  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");
+  }
+  const keys = plugin.optionKeys ?? [];
+  if (!Array.isArray(keys)) {
+    throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB: optionKeys \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u043C\u0430\u0441\u0441\u0438\u0432\u043E\u043C`);
+  }
+  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(", ")}`
+      );
+    }
+  }
+  for (const field of RELATION_FIELDS) validateNameList(plugin, field);
+}
+function addEdge(from, to, edges, indegree) {
+  const targets = edges.get(from);
+  if (!targets || targets.has(to)) return;
+  targets.add(to);
+  indegree.set(to, (indegree.get(to) ?? 0) + 1);
+}
+function orderPluginDefinitions(plugins) {
+  const entries = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const [sequence, plugin] of plugins.entries()) {
+    validatePluginDefinition(plugin);
+    if (byName.has(plugin.name)) {
+      throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u0443\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0451\u043D`);
+    }
+    const entry = { plugin, sequence };
+    entries.push(entry);
+    byName.set(plugin.name, entry);
+  }
+  for (const { plugin } of entries) {
+    for (const required of plugin.requires ?? []) {
+      if (!byName.has(required)) {
+        throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D\u0443 \xAB${plugin.name}\xBB \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044F \u043F\u043B\u0430\u0433\u0438\u043D \xAB${required}\xBB`);
+      }
+    }
+    for (const conflict of plugin.conflicts ?? []) {
+      if (byName.has(conflict)) {
+        throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u043D\u0435\u0441\u043E\u0432\u043C\u0435\u0441\u0442\u0438\u043C \u0441 \u043F\u043B\u0430\u0433\u0438\u043D\u043E\u043C \xAB${conflict}\xBB`);
+      }
+    }
+    for (const { plugin: other } of entries) {
+      if (other.conflicts?.includes(plugin.name)) {
+        throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u043D\u0435\u0441\u043E\u0432\u043C\u0435\u0441\u0442\u0438\u043C \u0441 \u043F\u043B\u0430\u0433\u0438\u043D\u043E\u043C \xAB${other.name}\xBB`);
+      }
+    }
+  }
+  const edges = /* @__PURE__ */ new Map();
+  const indegree = /* @__PURE__ */ new Map();
+  for (const { plugin } of entries) {
+    edges.set(plugin.name, /* @__PURE__ */ new Set());
+    indegree.set(plugin.name, 0);
+  }
+  for (const { plugin } of entries) {
+    for (const required of plugin.requires ?? []) {
+      addEdge(required, plugin.name, edges, indegree);
+    }
+    for (const target of plugin.before ?? []) {
+      if (byName.has(target)) addEdge(plugin.name, target, edges, indegree);
+    }
+    for (const target of plugin.after ?? []) {
+      if (byName.has(target)) addEdge(target, plugin.name, edges, indegree);
+    }
+  }
+  const ready = entries.filter(({ plugin }) => indegree.get(plugin.name) === 0);
+  ready.sort((a, b) => a.sequence - b.sequence);
+  const ordered = [];
+  while (ready.length > 0) {
+    const current = ready.shift();
+    if (!current) break;
+    ordered.push(current.plugin);
+    for (const target of edges.get(current.plugin.name) ?? []) {
+      const next = (indegree.get(target) ?? 0) - 1;
+      indegree.set(target, next);
+      if (next === 0) {
+        const entry = byName.get(target);
+        if (entry) {
+          ready.push(entry);
+          ready.sort((a, b) => a.sequence - b.sequence);
+        }
+      }
+    }
+  }
+  if (ordered.length !== entries.length) {
+    const cycle = entries.filter(({ plugin }) => (indegree.get(plugin.name) ?? 0) > 0).map(({ plugin }) => plugin.name);
+    throw new ItdConfigError(`\u0446\u0438\u043A\u043B\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u043F\u043E\u0440\u044F\u0434\u043E\u043A \u043F\u043B\u0430\u0433\u0438\u043D\u043E\u0432: ${cycle.join(" \u2192 ")}`);
+  }
+  return ordered;
+}
+function assertPluginRemovable(plugins, name) {
+  const dependent = plugins.find((plugin) => plugin.requires?.includes(name));
+  if (dependent) {
+    throw new ItdConfigError(
+      `\u043D\u0435\u043B\u044C\u0437\u044F \u043E\u0442\u043A\u043B\u044E\u0447\u0438\u0442\u044C \u043F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB: \u043E\u0442 \u043D\u0435\u0433\u043E \u0437\u0430\u0432\u0438\u0441\u0438\u0442 \xAB${dependent.name}\xBB`
+    );
+  }
+}
+var REQUEST_HOOK_DISPATCHERS = /* @__PURE__ */ new WeakMap();
+var PLUGIN_HOOK_SCOPE = /* @__PURE__ */ Symbol("itd-api.plugin-hooks");
+async function dispatchRequestHook(hooks, field, context, request) {
+  const dispatcher = REQUEST_HOOK_DISPATCHERS.get(hooks);
+  if (dispatcher) {
+    await dispatcher(field, context, request);
+    return;
+  }
+  const hook = hooks[field];
+  await hook?.(context);
+}
+var PluginRegistry = class {
+  #entries = /* @__PURE__ */ new Map();
+  #optionKeys = /* @__PURE__ */ new Set();
+  #removing = /* @__PURE__ */ new Set();
+  #cleanups = /* @__PURE__ */ new Set();
+  #ordered = [];
+  /** Сколько плагинов подключено. */
+  get size() {
+    return this.#entries.size;
+  }
+  /** Имена опций активных плагинов. */
+  get optionKeys() {
+    return this.#optionKeys.size === 0 ? NO_KEYS : this.#optionKeys;
+  }
+  /** Имена плагинов в фактическом порядке выполнения. */
+  names() {
+    return this.#ordered.map(({ plugin }) => plugin.name);
+  }
+  /** Подключён ли плагин с таким именем. */
+  has(name) {
+    return this.#entries.has(name);
+  }
+  /** Проверяет добавление без вызова `install()`. @internal */
+  assertCanAdd(plugin) {
+    validatePluginDefinition(plugin);
+    if (this.#removing.has(plugin.name)) {
+      throw new ItdConfigError(
+        `\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u0435\u0449\u0451 \u043E\u0442\u043A\u043B\u044E\u0447\u0430\u0435\u0442\u0441\u044F; \u0434\u043E\u0436\u0434\u0438\u0442\u0435\u0441\u044C \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0438\u044F unuse() \u0438\u043B\u0438 dispose()`
+      );
+    }
+    orderPluginDefinitions([...this.#ordered.map((entry) => entry.plugin), plugin]);
+  }
+  /** Проверяет удаление без изменения реестра. @internal */
+  assertCanRemove(name) {
+    const entry = this.#entries.get(name);
+    if (!entry) return;
+    assertPluginRemovable(
+      this.#ordered.map((current) => current.plugin),
+      name
+    );
+  }
+  /**
+   * Подключает плагин.
+   *
+   * @throws {ItdConfigError} если плагин задан неверно, уже подключён, нарушает зависимости
+   * или заявил занятое имя опции
+   */
+  add(plugin, context) {
+    this.assertCanAdd(plugin);
+    const ordered = orderPluginDefinitions([...this.#ordered.map((entry) => entry.plugin), plugin]);
+    const transformers = [];
+    const hooks = [];
+    const installed = plugin.install({
+      ...context,
+      use: (transformer) => {
+        if (typeof transformer !== "function") {
+          throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u043F\u0435\u0440\u0435\u0434\u0430\u043B \u0432 use() \u043D\u0435 \u0444\u0443\u043D\u043A\u0446\u0438\u044E`);
+        }
+        transformers.push(transformer);
+      },
+      useHooks: (value) => {
+        validateHooks(plugin.name, value);
+        hooks.push({ ...value });
+      }
+    });
+    const teardown = typeof installed === "function" ? installed : void 0;
+    this.#entries.set(plugin.name, {
+      plugin,
+      transformers,
+      hooks,
+      teardown,
+      activeRequests: 0,
+      drain: void 0,
+      finishDrain: void 0
+    });
+    this.#ordered = ordered.map((definition) => {
+      const entry = this.#entries.get(definition.name);
+      if (!entry) throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${definition.name}\xBB \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D`);
+      return entry;
+    });
+    this.#rebuildOptionKeys();
+  }
+  /**
+   * Отключает плагин и вызывает его функцию очистки.
+   *
+   * Новые запросы перестают видеть плагин сразу. Если его обёртка уже выполняется,
+   * очистка дождётся завершения этого логического запроса.
+   *
+   * @returns `false`, если такого плагина не было
+   */
+  async remove(name) {
+    const entry = this.#entries.get(name);
+    if (!entry) return false;
+    this.assertCanRemove(name);
+    this.#entries.delete(name);
+    this.#ordered = this.#ordered.filter((current) => current !== entry);
+    this.#rebuildOptionKeys();
+    this.#removing.add(name);
+    const cleanup = this.#trackCleanup(
+      (async () => {
+        await this.#waitForDrain(entry);
+        await entry.teardown?.();
+      })()
+    );
+    try {
+      await cleanup;
+      return true;
+    } finally {
+      this.#removing.delete(name);
+    }
+  }
+  /**
+   * Отключает все плагины окончательно.
+   *
+   * Очистка идёт изнутри наружу — в порядке, обратном выполнению обёрток.
+   */
+  async dispose() {
+    const entries = [...this.#ordered].reverse();
+    const previousCleanups = [...this.#cleanups];
+    this.#entries.clear();
+    this.#ordered = [];
+    this.#optionKeys.clear();
+    for (const { plugin } of entries) this.#removing.add(plugin.name);
+    const cleanup = this.#trackCleanup(
+      (async () => {
+        const errors = [];
+        const previous = await Promise.allSettled(previousCleanups);
+        for (const result of previous) {
+          if (result.status === "rejected") errors.push(result.reason);
+        }
+        for (const entry of entries) {
+          try {
+            await this.#waitForDrain(entry);
+            await entry.teardown?.();
+          } catch (error) {
+            errors.push(error);
+          } finally {
+            this.#removing.delete(entry.plugin.name);
+          }
+        }
+        if (errors.length > 0) {
+          throw new AggregateError(errors, "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043E\u0441\u0432\u043E\u0431\u043E\u0434\u0438\u0442\u044C \u0440\u0435\u0441\u0443\u0440\u0441\u044B \u043F\u043B\u0430\u0433\u0438\u043D\u043E\u0432");
+        }
+      })()
+    );
+    await cleanup;
+  }
+  /**
+   * Объединяет конструкторские хуки с хуками подключаемых плагинов.
+   *
+   * Возвращённый объект динамический: подключение и отключение плагина начинает действовать
+   * со следующего логического запроса без пересоздания транспорта.
+   */
+  hooks(base) {
+    const hooks = {};
+    REQUEST_HOOK_DISPATCHERS.set(hooks, ((field, context, request) => this.#runHook(field, context, request, base)));
+    return hooks;
+  }
+  /**
+   * Прогоняет запрос через цепочку обёрток.
+   *
+   * Снимок цепочки берётся в начале: `unuse()` влияет на новые запросы, но не обрывает
+   * уже выполняющийся посередине.
+   *
+   * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+   */
+  async run(request, execute) {
+    const entries = [...this.#ordered];
+    for (const entry of entries) entry.activeRequests += 1;
+    const hookScope = entries.flatMap((entry) => entry.hooks);
+    const scoped = (current) => current[PLUGIN_HOOK_SCOPE] === hookScope ? current : { ...current, [PLUGIN_HOOK_SCOPE]: hookScope };
+    const chain = entries.flatMap((entry) => entry.transformers).reduceRight(
+      (next, transformer) => (current) => transformer(scoped(current), (prepared) => next(scoped(prepared))),
+      (current) => execute(scoped(current))
+    );
+    try {
+      return await chain(scoped(request));
+    } finally {
+      for (const entry of entries) {
+        entry.activeRequests -= 1;
+        if (entry.activeRequests === 0) {
+          entry.finishDrain?.();
+          entry.finishDrain = void 0;
+          entry.drain = void 0;
+        }
+      }
+    }
+  }
+  #rebuildOptionKeys() {
+    this.#optionKeys.clear();
+    for (const { plugin } of this.#ordered) {
+      for (const key of plugin.optionKeys ?? []) this.#optionKeys.add(key);
+    }
+  }
+  #waitForDrain(entry) {
+    if (entry.activeRequests === 0) return Promise.resolve();
+    entry.drain ??= new Promise((resolve) => {
+      entry.finishDrain = resolve;
+    });
+    return entry.drain;
+  }
+  #trackCleanup(cleanup) {
+    this.#cleanups.add(cleanup);
+    void cleanup.then(
+      () => this.#cleanups.delete(cleanup),
+      () => this.#cleanups.delete(cleanup)
+    );
+    return cleanup;
+  }
+  async #runHook(field, context, request, base) {
+    const baseHook = base[field];
+    await baseHook?.(context);
+    const scope = request[PLUGIN_HOOK_SCOPE] ?? [];
+    for (const hooks of scope) {
+      const hook = hooks[field];
+      await hook?.(context);
+    }
+  }
+};
+
 // src/core/retry.ts
 var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "OPTIONS"]);
 function isRetryable(error, method, retryWrites) {
@@ -1724,10 +2138,7 @@ function createQueueMiddleware(schedule) {
   return (request, next) => request.skipQueue ? next(request) : schedule(request, () => next(request));
 }
 function createPluginsMiddleware(plugins) {
-  return (request, next) => {
-    if (plugins.size === 0) return next(request);
-    return plugins.run(request, next);
-  };
+  return (request, next) => plugins.run(request, next);
 }
 function createServicesMiddleware(registry) {
   return async (request, next) => {
@@ -1799,16 +2210,21 @@ function createRetryMiddleware(deps) {
       } catch (error) {
         const delay = nextDelay(error, attempt, request, method, backoff);
         if (delay === void 0) throw error;
-        await deps.hooks.onRetry?.({
-          method,
-          path: request.path,
-          url: deps.buildUrl(request),
-          // Умолчания транспорта добавляются после слоя повторов и сюда не входят.
-          headers: new Headers({ ...request.layerHeaders, ...request.headers }),
-          attempt,
-          error,
-          delay
-        });
+        await dispatchRequestHook(
+          deps.hooks,
+          "onRetry",
+          {
+            method,
+            path: request.path,
+            url: deps.buildUrl(request),
+            // Умолчания транспорта добавляются после слоя повторов и сюда не входят.
+            headers: new Headers({ ...request.layerHeaders, ...request.headers }),
+            attempt,
+            error,
+            delay
+          },
+          request
+        );
         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`
         );
@@ -1818,104 +2234,6 @@ function createRetryMiddleware(deps) {
   };
 }
 
-// src/core/plugins.ts
-var NO_KEYS = /* @__PURE__ */ new Set();
-var RESERVED_OPTION_KEYS = /* @__PURE__ */ new Set([
-  "signal",
-  "timeout",
-  "headers",
-  "retry",
-  "method",
-  "path",
-  "service",
-  "baseUrl",
-  "query",
-  "body",
-  "skipAuth",
-  "skipAuthRefresh",
-  "skipQueue",
-  "raw"
-]);
-function validatePluginDefinition(plugin) {
-  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");
-  }
-  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(", ")}`
-      );
-    }
-  }
-}
-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) {
-    validatePluginDefinition(plugin);
-    const name = plugin.name;
-    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 ?? [];
-    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
 function queueAbortError() {
   return new ItdAbortError("\u0417\u0430\u043F\u0440\u043E\u0441 \u043E\u0442\u043C\u0435\u043D\u0451\u043D \u0432\u043E \u0432\u0440\u0435\u043C\u044F \u043E\u0436\u0438\u0434\u0430\u043D\u0438\u044F \u043E\u0447\u0435\u0440\u0435\u0434\u0438");
@@ -2513,7 +2831,7 @@ var Transport = class {
       }
     }
     const context = { method, path: request.path, url, headers, attempt };
-    await this.#config.hooks.onRequest?.(context);
+    await dispatchRequestHook(this.#config.hooks, "onRequest", context, request);
     const timeout = request.timeout ?? this.#config.timeout;
     const abort = createAbortBundle(request.signal, timeout);
     const startedAt = Date.now();
@@ -2534,7 +2852,12 @@ var Transport = class {
       } catch (error) {
         const duration2 = Date.now() - startedAt;
         const failure = this.#toTransportError(error, abort, request, method, timeout);
-        await this.#config.hooks.onError?.({ ...context, duration: duration2, error: failure });
+        await dispatchRequestHook(
+          this.#config.hooks,
+          "onError",
+          { ...context, duration: duration2, error: failure },
+          request
+        );
         this.#config.logger?.warn(
           `\xD7 ${method} ${request.path} (${duration2} \u043C\u0441): ${failure.message}`
         );
@@ -2546,12 +2869,17 @@ var Transport = class {
       }
       if (this.#config.useCookieJar) this.#deps.cookies?.setFromResponse(url, response);
       if (response.ok) {
-        await this.#config.hooks.onResponse?.({
-          ...context,
-          status: response.status,
-          duration: Date.now() - startedAt,
-          response
-        });
+        await dispatchRequestHook(
+          this.#config.hooks,
+          "onResponse",
+          {
+            ...context,
+            status: response.status,
+            duration: Date.now() - startedAt,
+            response
+          },
+          request
+        );
       }
       const payload = await this.#readBodyOrFail(
         response,
@@ -2572,7 +2900,12 @@ var Transport = class {
           response,
           body: payload
         });
-        await this.#config.hooks.onError?.({ ...context, duration, error });
+        await dispatchRequestHook(
+          this.#config.hooks,
+          "onError",
+          { ...context, duration, error },
+          request
+        );
         this.#config.logger?.warn(
           `\u2190 ${response.status} ${method} ${request.path} (${duration} \u043C\u0441): ${error.message}`
         );
@@ -2593,11 +2926,16 @@ var Transport = class {
       await response.body?.cancel().catch(() => {
       });
       const failure = this.#toTransportError(error, abort, request, method, timeout);
-      await this.#config.hooks.onError?.({
-        ...context,
-        duration: Date.now() - startedAt,
-        error: failure
-      });
+      await dispatchRequestHook(
+        this.#config.hooks,
+        "onError",
+        {
+          ...context,
+          duration: Date.now() - startedAt,
+          error: failure
+        },
+        request
+      );
       this.#config.logger?.warn(
         `\xD7 ${method} ${request.path}: \u043D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u0442\u044C \u0442\u0435\u043B\u043E \u043E\u0442\u0432\u0435\u0442\u0430 \u2014 ${failure.message}`
       );
@@ -2648,12 +2986,16 @@ var Transport = class {
   }
   /** Превращает исключение `fetch` в понятную ошибку библиотеки. */
   #toTransportError(error, abort, request, method, timeout) {
-    const aborted = error instanceof Error && error.name === "AbortError";
+    const aborted = abort.signal.aborted || error instanceof Error && error.name === "AbortError";
     if (aborted && abort.timedOut()) {
       return new ItdTimeoutError({ timeout, method, path: request.path });
     }
     if (aborted) {
-      return new ItdAbortError(`\u0417\u0430\u043F\u0440\u043E\u0441 ${method} ${request.path} \u043E\u0442\u043C\u0435\u043D\u0451\u043D`);
+      const reason = request.signal?.reason;
+      return new ItdAbortError(
+        `\u0417\u0430\u043F\u0440\u043E\u0441 ${method} ${request.path} \u043E\u0442\u043C\u0435\u043D\u0451\u043D`,
+        reason !== void 0 ? { cause: reason } : void 0
+      );
     }
     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)}`,
@@ -2951,7 +3293,6 @@ var PollTransport = class {
     const seen = /* @__PURE__ */ new Set();
     let firstRun = true;
     let lastUnreadCount;
-    context.onOpen();
     while (!context.signal.aborted) {
       const token = await context.getToken();
       if (!token) throw new UnauthorizedStreamError();
@@ -2966,6 +3307,7 @@ var PollTransport = class {
       });
       if (response.status === 401) throw new UnauthorizedStreamError();
       if (!response.ok) throw new Error(`\u041E\u043F\u0440\u043E\u0441 \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 \u0432\u0435\u0440\u043D\u0443\u043B \u0441\u0442\u0430\u0442\u0443\u0441 ${response.status}`);
+      context.onOpen();
       const body = await response.json();
       const payload = typeof body === "object" && body !== null && "data" in body ? body.data : body;
       const items = pickArray(payload, "notifications");
@@ -3211,10 +3553,12 @@ var STREAM_PATH = "/api/notifications/stream";
 var SseTransport = class {
   name = "sse";
   #idleTimeout;
+  #handshakeTimeout;
   /** Идентификатор последнего события — отправляется при переподключении. */
   #lastEventId;
   constructor(options = {}) {
     this.#idleTimeout = options.idleTimeout ?? 9e4;
+    this.#handshakeTimeout = options.handshakeTimeout ?? 2e4;
   }
   async connect(context) {
     const token = await context.getToken();
@@ -3225,16 +3569,36 @@ var SseTransport = class {
     headers.set("Authorization", `Bearer ${token}`);
     headers.set("Cache-Control", "no-cache");
     if (this.#lastEventId) headers.set("Last-Event-ID", this.#lastEventId);
-    const response = await context.fetch(url, {
-      method: "GET",
-      headers,
-      signal: context.signal
-    });
-    if (response.status === 401) throw new UnauthorizedStreamError();
-    if (!response.ok) throw new Error(`\u041F\u043E\u0442\u043E\u043A \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 \u0432\u0435\u0440\u043D\u0443\u043B \u0441\u0442\u0430\u0442\u0443\u0441 ${response.status}`);
-    if (!response.body) throw new Error("\u041E\u0442\u0432\u0435\u0442 \u043F\u043E\u0442\u043E\u043A\u0430 \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 \u043F\u0443\u0441\u0442");
-    context.onOpen();
-    await this.#read(response.body, context);
+    const controller = new AbortController();
+    const relayAbort = () => controller.abort(context.signal.reason);
+    if (context.signal.aborted) controller.abort(context.signal.reason);
+    else context.signal.addEventListener("abort", relayAbort, { once: true });
+    try {
+      const response = await this.#handshake(url, headers, context, controller);
+      if (response.status === 401) throw new UnauthorizedStreamError();
+      if (!response.ok) throw new Error(`\u041F\u043E\u0442\u043E\u043A \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 \u0432\u0435\u0440\u043D\u0443\u043B \u0441\u0442\u0430\u0442\u0443\u0441 ${response.status}`);
+      if (!response.body) throw new Error("\u041E\u0442\u0432\u0435\u0442 \u043F\u043E\u0442\u043E\u043A\u0430 \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 \u043F\u0443\u0441\u0442");
+      context.onOpen();
+      await this.#read(response.body, context);
+    } finally {
+      context.signal.removeEventListener("abort", relayAbort);
+    }
+  }
+  /** Выполняет запрос потока, обрывая его, если ответ не пришёл за отведённое время. */
+  async #handshake(url, headers, context, controller) {
+    let expired = false;
+    const timer = this.#handshakeTimeout > 0 ? setTimeout(() => {
+      expired = true;
+      controller.abort(new Error("\u0418\u0441\u0442\u0451\u043A \u0442\u0430\u0439\u043C\u0430\u0443\u0442 \u0440\u0443\u043A\u043E\u043F\u043E\u0436\u0430\u0442\u0438\u044F SSE"));
+    }, this.#handshakeTimeout) : void 0;
+    try {
+      return await context.fetch(url, { method: "GET", headers, signal: controller.signal });
+    } catch (error) {
+      if (expired) throw new Error("\u041F\u043E\u0442\u043E\u043A \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 \u043D\u0435 \u043E\u0442\u0432\u0435\u0442\u0438\u043B: \u0438\u0441\u0442\u0451\u043A \u0442\u0430\u0439\u043C\u0430\u0443\u0442 \u0440\u0443\u043A\u043E\u043F\u043E\u0436\u0430\u0442\u0438\u044F");
+      throw error;
+    } finally {
+      if (timer !== void 0) clearTimeout(timer);
+    }
   }
   async #read(body, context) {
     const reader = body.getReader();
@@ -3306,6 +3670,7 @@ function validateRealtimeOptions(options) {
   positiveInteger(options.maxAttempts, "maxAttempts");
   duration(options.pollInterval, "pollInterval", 1);
   duration(options.idleTimeout, "idleTimeout", 0);
+  duration(options.handshakeTimeout, "handshakeTimeout", 0);
   if (options.jitter !== void 0 && !(options.jitter >= 0 && options.jitter <= 1)) {
     throw new ItdConfigError(
       `realtime.jitter \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u0432 \u0434\u0438\u0430\u043F\u0430\u0437\u043E\u043D\u0435 0\u20261, \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u043E: ${options.jitter}`
@@ -3427,7 +3792,8 @@ var ItdRealtime = class {
       });
     }
     return new SseTransport({
-      ...this.#options.idleTimeout !== void 0 ? { idleTimeout: this.#options.idleTimeout } : {}
+      ...this.#options.idleTimeout !== void 0 ? { idleTimeout: this.#options.idleTimeout } : {},
+      ...this.#options.handshakeTimeout !== void 0 ? { handshakeTimeout: this.#options.handshakeTimeout } : {}
     });
   }
   /** Запускает попытку подключения; повторы планирует сам. */
@@ -3642,6 +4008,11 @@ var Paginator = class {
   #finished = false;
   #pagesLoaded = 0;
   constructor(options) {
+    if (options.maxPages !== void 0 && (!Number.isInteger(options.maxPages) || options.maxPages < 1)) {
+      throw new ItdConfigError(
+        `maxPages \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u0446\u0435\u043B\u044B\u043C \u0447\u0438\u0441\u043B\u043E\u043C \u043D\u0435 \u043C\u0435\u043D\u044C\u0448\u0435 1, \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u043E: ${options.maxPages}`
+      );
+    }
     this.#options = options;
     this.#maxPages = options.maxPages ?? 1e3;
     this.#state = options.start ?? {};
@@ -3691,6 +4062,7 @@ var Paginator = class {
    * @param max сколько элементов достаточно; без него перебираются все страницы
    */
   async collect(max) {
+    if (max !== void 0 && max <= 0) return [];
     const result = [];
     for await (const item of this) {
       result.push(item);
@@ -6166,6 +6538,13 @@ var VerificationResource = class extends BaseResource {
 };
 
 // src/client.ts
+var CLIENT_PLUGIN_REGISTRIES = /* @__PURE__ */ new WeakMap();
+function assertClientCanUsePlugin(client, plugin) {
+  CLIENT_PLUGIN_REGISTRIES.get(client)?.assertCanAdd(plugin);
+}
+function assertClientCanUnusePlugin(client, name) {
+  CLIENT_PLUGIN_REGISTRIES.get(client)?.assertCanRemove(name);
+}
 var ItdClient = class _ItdClient {
   #config;
   #http;
@@ -6203,13 +6582,10 @@ var ItdClient = class _ItdClient {
   subscription;
   /** Сведения о платформе: изменения, анонсы, баннер события. */
   platform;
-  /**
-   * Телеметрия просмотров.
-   *
-   * @experimental Недокументированные эндпоинты. Библиотека никогда не отправляет их сама.
-   */
+  /** Телеметрия просмотров. */
   telemetry;
   constructor(options = {}, internals = {}) {
+    CLIENT_PLUGIN_REGISTRIES.set(this, this.#plugins);
     const config = resolveConfig(options);
     this.#config = config;
     this.#jar = new CookieJar();
@@ -6221,18 +6597,22 @@ var ItdClient = class _ItdClient {
     this.#queues = queues;
     this.#ownsQueues = shared === void 0;
     let authManager;
-    const transport = new Transport(config, {
-      cookies: config.useCookieJar ? this.#jar : void 0,
-      getDeviceId: () => authManager.getDeviceId(),
-      onRateLimit: queues && config.rateLimit?.respectHeaders ? (limit, remaining, request) => this.#throttleByHeaders(limit, remaining, request) : void 0
-    });
+    const hooks = this.#plugins.hooks(config.hooks);
+    const transport = new Transport(
+      { ...config, hooks },
+      {
+        cookies: config.useCookieJar ? this.#jar : void 0,
+        getDeviceId: () => authManager.getDeviceId(),
+        onRateLimit: queues && config.rateLimit?.respectHeaders ? (limit, remaining, request) => this.#throttleByHeaders(limit, remaining, request) : void 0
+      }
+    );
     this.#transport = transport;
     const pluginsLayer = createPluginsMiddleware(this.#plugins);
     const retriesLayer = createRetryMiddleware({
       retry: config.retry,
       rateLimitDelays: config.rateLimit?.retryDelays ?? [],
       pauseQueue: queues ? (ms, request) => queues.for(request.service).pause(ms) : void 0,
-      hooks: config.hooks,
+      hooks,
       logger: config.logger,
       buildUrl: (request) => transport.buildUrl(request)
     });
@@ -6332,6 +6712,26 @@ var ItdClient = class _ItdClient {
     });
     return this;
   }
+  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */
+  pluginNames() {
+    return this.#plugins.names();
+  }
+  /** Подключён ли плагин с таким именем. */
+  hasPlugin(name) {
+    return this.#plugins.has(name);
+  }
+  /**
+   * Отключает плагин и освобождает заведённые им ресурсы.
+   *
+   * Новые запросы перестают видеть плагин сразу. Очистка дождётся логического запроса,
+   * который уже проходил через его обёртку.
+   *
+   * @returns `false`, если такого плагина не было
+   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин
+   */
+  unuse(name) {
+    return this.#plugins.remove(name);
+  }
   /**
    * Регистрирует сервис платформы — домен, отличный от основного.
    *
@@ -6437,13 +6837,25 @@ var ItdClient = class _ItdClient {
    * ```ts
    * await using itd = new ItdClient({ auth: token });
    * // …работа…
-   * // close() вызовется сам на выходе из блока
+   * // dispose() вызовется сам на выходе из блока
    * ```
    */
   async close() {
     this.#disconnectStreams();
     if (this.#ownsQueues) this.#queues?.stop();
   }
+  /**
+   * Окончательно освобождает клиент: выполняет {@link close} и отключает все плагины.
+   *
+   * В отличие от `close()`, после `dispose()` плагины не восстанавливаются автоматически.
+   * Сам клиент остаётся пригоден для обычных запросов; при необходимости плагины можно
+   * подключить заново через {@link use}.
+   */
+  async dispose() {
+    const results = await Promise.allSettled([this.close(), this.#plugins.dispose()]);
+    const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
+    if (errors.length > 0) throw new AggregateError(errors, "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043E\u0441\u0432\u043E\u0431\u043E\u0434\u0438\u0442\u044C \u043A\u043B\u0438\u0435\u043D\u0442");
+  }
   /** Завершает потоки до того, как запросы начнут использовать другой аккаунт. */
   #disconnectStreams() {
     for (const stream of [...this.#streams]) stream.disconnect();
@@ -6451,7 +6863,7 @@ var ItdClient = class _ItdClient {
   }
   /** Позволяет использовать клиент с `await using`. */
   [Symbol.asyncDispose]() {
-    return this.close();
+    return this.dispose();
   }
   static {
     if (typeof Symbol.asyncDispose !== "symbol") {
@@ -6650,10 +7062,13 @@ var ItdAccounts = class _ItdAccounts {
   #eventUnsubscribers = /* @__PURE__ */ new Map();
   /** Плагины для всех: и для уже заведённых аккаунтов, и для будущих. */
   #plugins;
+  /** Имена плагинов, чья асинхронная очистка ещё не завершилась. */
+  #removingPlugins = /* @__PURE__ */ new Set();
   /** Общая очередь. `undefined`, когда у каждого аккаунта своя. */
   #queues;
   #rateLimitScope;
   #emitter;
+  #logger;
   #createClient;
   constructor(options = {}, internals = {}) {
     const { storage, plugins, rateLimitScope, ...base } = options;
@@ -6662,19 +7077,13 @@ var ItdAccounts = class _ItdAccounts {
     }
     this.#base = base;
     this.#storage = storage ?? new MemoryMultiTokenStorage();
-    this.#plugins = [];
-    for (const plugin of plugins ?? []) {
-      validatePluginDefinition(plugin);
-      if (this.#plugins.some((added) => added.name === plugin.name)) {
-        throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u0443\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0451\u043D`);
-      }
-      this.#plugins.push(plugin);
-    }
+    this.#plugins = orderPluginDefinitions(plugins ?? []);
     this.#rateLimitScope = rateLimitScope ?? "account";
     this.#createClient = internals.createClient ?? ((clientOptions, clientInternals) => new ItdClient(clientOptions, clientInternals));
     const rateLimit = this.#rateLimitScope === "shared" ? resolveRateLimit(base.rateLimit) : void 0;
     this.#queues = rateLimit ? new RequestQueuePool(rateLimit) : void 0;
     const logger = typeof base.logger === "object" ? base.logger : void 0;
+    this.#logger = logger;
     this.#emitter = new Emitter(
       (error) => reportListenerError(logger, "\u0430\u043A\u043A\u0430\u0443\u043D\u0442\u043E\u0432", error)
     );
@@ -6740,6 +7149,11 @@ var ItdAccounts = class _ItdAccounts {
       for (const plugin of this.#plugins) client.use(plugin);
     } catch (error) {
       storageControl.revoke();
+      if (client) {
+        void client.dispose().catch((cleanupError) => {
+          this.#reportPluginCleanup("\u043D\u0435\u0443\u0434\u0430\u0447\u043D\u043E\u0433\u043E \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u044F \u0430\u043A\u043A\u0430\u0443\u043D\u0442\u0430", cleanupError);
+        });
+      }
       throw error;
     }
     const unsubscribers = this.#forwardEvents(name, client);
@@ -6821,7 +7235,7 @@ var ItdAccounts = class _ItdAccounts {
     try {
       const errors = [];
       const closing = await Promise.allSettled([
-        client.close(),
+        client.dispose(),
         storageControl?.drain() ?? Promise.resolve()
       ]);
       for (const result of closing) {
@@ -6849,14 +7263,64 @@ var ItdAccounts = class _ItdAccounts {
    * ```
    */
   use(plugin) {
-    validatePluginDefinition(plugin);
-    if (this.#plugins.some((added) => added.name === plugin?.name)) {
-      throw new ItdConfigError(`\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u0443\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0451\u043D`);
+    if (this.#removingPlugins.has(plugin?.name)) {
+      throw new ItdConfigError(
+        `\u043F\u043B\u0430\u0433\u0438\u043D \xAB${plugin.name}\xBB \u0435\u0449\u0451 \u043E\u0442\u043A\u043B\u044E\u0447\u0430\u0435\u0442\u0441\u044F; \u0434\u043E\u0436\u0434\u0438\u0442\u0435\u0441\u044C \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0438\u044F accounts.unuse()`
+      );
     }
-    for (const client of this.#clients.values()) client.use(plugin);
-    this.#plugins.push(plugin);
+    const ordered = orderPluginDefinitions([...this.#plugins, plugin]);
+    const clients = [...this.#clients.values()];
+    for (const client of clients) assertClientCanUsePlugin(client, plugin);
+    const installed = [];
+    try {
+      for (const client of clients) {
+        client.use(plugin);
+        installed.push(client);
+      }
+    } catch (error) {
+      for (const client of installed.reverse()) {
+        void client.unuse(plugin.name).catch((cleanupError) => {
+          this.#reportPluginCleanup(`\u043E\u0442\u043A\u0430\u0442\u0430 \u043F\u043B\u0430\u0433\u0438\u043D\u0430 \xAB${plugin.name}\xBB`, cleanupError);
+        });
+      }
+      throw error;
+    }
+    this.#plugins.splice(0, this.#plugins.length, ...ordered);
     return this;
   }
+  /** Имена общих плагинов в фактическом порядке выполнения обёрток. */
+  pluginNames() {
+    return this.#plugins.map((plugin) => plugin.name);
+  }
+  /** Подключён ли общий плагин с таким именем. */
+  hasPlugin(name) {
+    return this.#plugins.some((plugin) => plugin.name === name);
+  }
+  /**
+   * Отключает общий плагин у существующих клиентов и не применяет его к будущим.
+   *
+   * @returns `false`, если такого плагина не было
+   * @throws {ItdConfigError} если от плагина зависит другой общий плагин
+   */
+  async unuse(name) {
+    const index = this.#plugins.findIndex((plugin) => plugin.name === name);
+    if (index < 0) return false;
+    assertPluginRemovable(this.#plugins, name);
+    const clients = [...this.#clients.values()];
+    for (const client of clients) assertClientCanUnusePlugin(client, name);
+    this.#plugins.splice(index, 1);
+    this.#removingPlugins.add(name);
+    try {
+      const results = await Promise.allSettled(clients.map((client) => client.unuse(name)));
+      const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
+      if (errors.length > 0) {
+        throw new AggregateError(errors, `\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043E\u0442\u043A\u043B\u044E\u0447\u0438\u0442\u044C \u043F\u043B\u0430\u0433\u0438\u043D \xAB${name}\xBB \u0443 \u0432\u0441\u0435\u0445 \u0430\u043A\u043A\u0430\u0443\u043D\u0442\u043E\u0432`);
+      }
+      return true;
+    } finally {
+      this.#removingPlugins.delete(name);
+    }
+  }
   /**
    * Подписывается на события авторизации всех аккаунтов сразу.
    *
@@ -6894,16 +7358,32 @@ var ItdAccounts = class _ItdAccounts {
    * ```ts
    * await using accounts = new ItdAccounts({ storage });
    * // …работа…
-   * // close() вызовется сам на выходе из блока
+   * // dispose() вызовется сам на выходе из блока
    * ```
    */
   async close() {
     await Promise.all([...this.#clients.values()].map((client) => client.close()));
     this.#queues?.stop();
   }
+  /**
+   * Окончательно освобождает контейнер и отключает общие плагины у всех аккаунтов.
+   *
+   * Для временной остановки потоков и очереди без отключения плагинов используйте
+   * {@link close}.
+   */
+  async dispose() {
+    const results = await Promise.allSettled([
+      ...[...this.#clients.values()].map((client) => client.dispose()),
+      Promise.resolve().then(() => this.#queues?.stop())
+    ]);
+    this.#plugins.splice(0);
+    this.#removingPlugins.clear();
+    const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
+    if (errors.length > 0) throw new AggregateError(errors, "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043E\u0441\u0432\u043E\u0431\u043E\u0434\u0438\u0442\u044C \u0430\u043A\u043A\u0430\u0443\u043D\u0442\u044B");
+  }
   /** Позволяет использовать контейнер с `await using`. */
   [Symbol.asyncDispose]() {
-    return this.close();
+    return this.dispose();
   }
   static {
     if (typeof Symbol.asyncDispose !== "symbol") {
@@ -6929,6 +7409,12 @@ var ItdAccounts = class _ItdAccounts {
       storage
     };
   }
+  /** Не теряет ошибку фонового teardown, который синхронный API не может await-нуть. */
+  #reportPluginCleanup(scope, error) {
+    const message = `\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u0442\u044C teardown \u043F\u043E\u0441\u043B\u0435 ${scope}`;
+    if (this.#logger) this.#logger.error(message, error);
+    else console.error(`[itd-api] ${message}`, error);
+  }
   /** Ретранслирует события клиента наружу, добавляя к ним имя аккаунта. */
   #forwardEvents(account, client) {
     return [
@@ -7383,5 +7869,5 @@ exports.scopedTokenStorage = scopedTokenStorage;
 exports.statusDays = statusDays;
 exports.toDate = toDate;
 exports.utcStampToIso = utcStampToIso;
-//# sourceMappingURL=chunk-QD4UHJFF.cjs.map
-//# sourceMappingURL=chunk-QD4UHJFF.cjs.map
+//# sourceMappingURL=chunk-73CISRBG.cjs.map
+//# sourceMappingURL=chunk-73CISRBG.cjs.map