itd-api 0.0.10 → 0.0.11

package/dist/{chunk-BN4AC3DP.cjs → chunk-QD4UHJFF.cjs}

@@ -674,18 +674,24 @@ function decodeBase64Url(segment) {
   const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
   return new TextDecoder().decode(bytes);
 }
-function readTokenSubject(token) {
+function readTokenIdentity(token) {
   try {
     const payload = token.split(".")[1];
-    if (!payload) return void 0;
+    if (!payload) return {};
     const parsed = JSON.parse(decodeBase64Url(payload));
-    if (typeof parsed !== "object" || parsed === null) return void 0;
-    const subject = parsed.sub;
-    return typeof subject === "string" && subject.length > 0 ? subject : void 0;
+    if (typeof parsed !== "object" || parsed === null) return {};
+    const { sub, sid } = parsed;
+    return {
+      ...typeof sub === "string" && sub.length > 0 ? { subject: sub } : {},
+      ...typeof sid === "string" && sid.length > 0 ? { sessionId: sid } : {}
+    };
   } catch {
-    return void 0;
+    return {};
   }
 }
+function readTokenSubject(token) {
+  return readTokenIdentity(token).subject;
+}
 
 // src/core/runtime.ts
 var RuntimeMode = Object.freeze({
@@ -878,6 +884,7 @@ var AuthManager = class {
   #send;
   #jar;
   #emitter;
+  #hooks;
   /** `undefined` — сессия ещё не читалась из хранилища. */
   #session;
   /**
@@ -889,8 +896,12 @@ var AuthManager = class {
   #refreshing = null;
   /** Общий промис входа по логину и паролю. */
   #signingIn = null;
-  /** Непрозрачная версия владельца клиента для разделения состояния плагинов. */
+  /** Fallback-область для изоляции состояния плагинов, когда JWT-идентичность недоступна. */
   #authScope = nextAuthScope();
+  /** Последний токен внешнего источника; `undefined` означает, что источник ещё не читался. */
+  #externalToken;
+  /** Идентификаторы последнего токена внешнего источника для синхронных потребителей. */
+  #externalIdentity;
   /**
    * Идентификатор устройства.
    *
@@ -900,10 +911,11 @@ var AuthManager = class {
   #deviceId;
   /** Общий промис первичной выдачи `deviceId` — чтобы параллельные запросы получили один. */
   #deviceIdLoading = null;
-  constructor(config, send, jar) {
+  constructor(config, send, jar, hooks = {}) {
     this.#config = config;
     this.#send = send;
     this.#jar = jar;
+    this.#hooks = hooks;
     this.#emitter = new Emitter(
       (error) => reportListenerError(config.logger, "\u0430\u0432\u0442\u043E\u0440\u0438\u0437\u0430\u0446\u0438\u0438", error)
     );
@@ -916,13 +928,63 @@ var AuthManager = class {
   get once() {
     return this.#emitter.once.bind(this.#emitter);
   }
-  /** Непрозрачная область авторизации; токен и идентификатор пользователя не раскрываются. */
+  /**
+   * Непрозрачная fallback-область авторизации.
+   *
+   * Изолирует состояние плагинов, когда идентичность аккаунта из JWT недоступна (непрозрачный
+   * токен): значение уникально для владельца и сменяется при замене или очистке сессии.
+   */
   getAuthScope() {
     return this.#authScope;
   }
+  /** Загружает сессию и возвращает идентификаторы аккаунта и сессии для плагинов. */
+  async getAuthIdentity() {
+    const session = await this.#loadSession();
+    if (session?.accessToken) return this.#identityForToken(session.accessToken);
+    const auth = this.#config.auth;
+    if (typeof auth === "object" && auth !== null && "getToken" in auth) {
+      const token = await this.#readExternalToken(() => auth.getToken());
+      return this.#identityForToken(token ?? void 0);
+    }
+    return {};
+  }
+  /** Идентификаторы аккаунта и сессии без чтения хранилища. @internal */
+  getCurrentAuthIdentity() {
+    const session = this.#session === void 0 ? this.#sessionFromConfig(this.#config.auth) : this.#session;
+    return session?.accessToken ? this.#identityForToken(session.accessToken) : this.#externalIdentity ?? {};
+  }
   #rotateAuthScope() {
     this.#authScope = nextAuthScope();
   }
+  #identityForToken(accessToken) {
+    const token = accessToken ? readTokenIdentity(accessToken) : {};
+    return {
+      ...token.subject ? { userId: token.subject } : {},
+      ...token.sessionId ? { sessionId: token.sessionId } : {}
+    };
+  }
+  async #readExternalToken(getToken) {
+    const token = await getToken() ?? null;
+    const current = this.#identityForToken(token ?? void 0);
+    if (this.#externalToken !== void 0 && this.#externalToken !== token) {
+      this.#rotateAuthScope();
+      const previous = this.#externalIdentity ?? {};
+      const changed = previous.userId !== void 0 && current.userId !== void 0 ? previous.userId !== current.userId : true;
+      if (changed) this.#hooks.onAccountChange?.();
+    }
+    this.#externalToken = token;
+    this.#externalIdentity = current;
+    return token;
+  }
+  /** Меняет fallback и завершает realtime, только если фактически сменился аккаунт. */
+  #transitionAuth(accessToken, rotateFallback = true) {
+    const knownPrevious = this.#session !== void 0;
+    const previous = this.#identityForToken(this.#session?.accessToken);
+    const current = this.#identityForToken(accessToken);
+    const changed = previous.userId !== void 0 && current.userId !== void 0 ? previous.userId !== current.userId : previous.userId !== current.userId || rotateFallback;
+    if (rotateFallback || changed) this.#rotateAuthScope();
+    if (knownPrevious && changed) this.#hooks.onAccountChange?.();
+  }
   /**
    * Есть ли признак живой refresh-сессии.
    *
@@ -983,7 +1045,7 @@ var AuthManager = class {
     const auth = this.#config.auth;
     if (!auth) return null;
     if (typeof auth === "object" && "getToken" in auth) {
-      return await auth.getToken() ?? null;
+      return this.#readExternalToken(() => auth.getToken());
     }
     if (typeof auth === "object" && "email" in auth) {
       return this.#signInWithCredentials(auth);
@@ -1038,7 +1100,8 @@ var AuthManager = class {
   }
   /** Сохраняет токен, полученный извне, — например после подтверждения OTP. */
   async setAccessToken(accessToken) {
-    this.#rotateAuthScope();
+    await this.#loadSession();
+    this.#transitionAuth(accessToken);
     await this.#saveSession({ ...this.#session ?? {}, accessToken, obtainedAt: Date.now() });
     this.#emitter.emit("tokens", { accessToken });
   }
@@ -1059,7 +1122,8 @@ var AuthManager = class {
   }
   /** Заменяет сессию и связанные с ней cookie целиком. */
   async setSession(session) {
-    this.#rotateAuthScope();
+    await this.#loadSession();
+    this.#transitionAuth(session.accessToken);
     this.#jar.clear();
     this.#jar.deserialize(session.cookies);
     if (session.deviceId) this.#deviceId = session.deviceId;
@@ -1074,8 +1138,9 @@ var AuthManager = class {
    * новую запись в списке сессий.
    */
   async clear() {
+    await this.#loadSession();
+    this.#transitionAuth(void 0);
     this.#session = null;
-    this.#rotateAuthScope();
     this.#jar.clear();
     await this.#config.storage.clear();
     if (this.#deviceId) await this.#saveSession({ deviceId: this.#deviceId });
@@ -1172,6 +1237,7 @@ var AuthManager = class {
         REFRESH_COOKIE,
         this.#config.baseUrl + REFRESH_COOKIE_PATH
       );
+      this.#transitionAuth(accessToken, false);
       await this.#saveSession({
         ...this.#session ?? {},
         accessToken,
@@ -1182,8 +1248,8 @@ var AuthManager = class {
       return accessToken;
     } catch (error) {
       if (error instanceof ItdApiError) {
+        this.#transitionAuth(void 0);
         this.#session = null;
-        this.#rotateAuthScope();
         this.#jar.clear();
         await this.#config.storage.clear();
         const relogged = await this.#reloginOrNull();
@@ -1251,7 +1317,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.#rotateAuthScope();
+    this.#transitionAuth(accessToken);
     await this.#saveSession({ accessToken, obtainedAt: Date.now() });
     this.#emitter.emit("tokens", { accessToken });
     this.#emitter.emit("signIn", { accessToken });
@@ -1318,7 +1384,7 @@ function normalizeBaseUrl(baseUrl) {
 }
 
 // src/core/version.ts
-var LIBRARY_VERSION = "0.0.10";
+var LIBRARY_VERSION = "0.0.11";
 
 // src/core/config.ts
 var DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
@@ -3292,6 +3358,18 @@ var ItdRealtime = class {
   get transport() {
     return this.#transport.name;
   }
+  /** Базовый URL клиента, создавшего поток. @internal */
+  get baseUrl() {
+    return this.#deps.baseUrl;
+  }
+  /** Идентификаторы аккаунта и сессии клиента, создавшего поток. @internal */
+  getAuthIdentity() {
+    return this.#deps.getAuthIdentity?.();
+  }
+  /** Непрозрачная область авторизации создавшего поток клиента. @internal */
+  getAuthScope() {
+    return this.#deps.getAuthScope?.();
+  }
   /** Подписывается на событие потока. @returns функция отписки */
   on(event, listener) {
     return this.#emitter.on(event, listener);
@@ -6168,7 +6246,9 @@ var ItdClient = class _ItdClient {
     } : 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);
+    authManager = new AuthManager(config, authHandler, this.#jar, {
+      onAccountChange: () => this.#disconnectStreams()
+    });
     this.#authManager = authManager;
     const middlewares = [];
     if (queues) {
@@ -6247,7 +6327,8 @@ var ItdClient = class _ItdClient {
     this.#plugins.add(plugin, {
       baseUrl: this.#config.baseUrl,
       logger: this.#config.logger,
-      getAuthScope: () => this.#authManager.getAuthScope()
+      getAuthScope: () => this.#authManager.getAuthScope(),
+      getAuthIdentity: () => this.#authManager.getAuthIdentity()
     });
     return this;
   }
@@ -6307,7 +6388,8 @@ var ItdClient = class _ItdClient {
    * Создаёт поток уведомлений в реальном времени.
    *
    * Каждый вызов даёт новый независимый поток; обычно он нужен один на приложение.
-   * Соединение поднимается методом `connect()` и держится само.
+   * Соединение поднимается методом `connect()` и держится само. Замена авторизации на токен
+   * другого пользователя завершает все потоки клиента; смена только сессии их не затрагивает.
    *
    * @example
    * ```ts
@@ -6328,6 +6410,8 @@ var ItdClient = class _ItdClient {
         baseUrl: this.#config.baseUrl,
         fetch: this.#config.fetch,
         baseHeaders: (url) => this.#transport.platformHeaders(url),
+        getAuthIdentity: () => this.#authManager.getCurrentAuthIdentity(),
+        getAuthScope: () => this.#authManager.getAuthScope(),
         getToken: () => this.#authManager.getAccessToken(),
         refresh: () => this.#authManager.onUnauthorized(),
         fetchUnreadCount: () => this.notifications.count(),
@@ -6357,10 +6441,14 @@ var ItdClient = class _ItdClient {
    * ```
    */
   async close() {
-    for (const stream of this.#streams) stream.disconnect();
-    this.#streams.clear();
+    this.#disconnectStreams();
     if (this.#ownsQueues) this.#queues?.stop();
   }
+  /** Завершает потоки до того, как запросы начнут использовать другой аккаунт. */
+  #disconnectStreams() {
+    for (const stream of [...this.#streams]) stream.disconnect();
+    this.#streams.clear();
+  }
   /** Позволяет использовать клиент с `await using`. */
   [Symbol.asyncDispose]() {
     return this.close();
@@ -7295,5 +7383,5 @@ exports.scopedTokenStorage = scopedTokenStorage;
 exports.statusDays = statusDays;
 exports.toDate = toDate;
 exports.utcStampToIso = utcStampToIso;
-//# sourceMappingURL=chunk-BN4AC3DP.cjs.map
-//# sourceMappingURL=chunk-BN4AC3DP.cjs.map
+//# sourceMappingURL=chunk-QD4UHJFF.cjs.map
+//# sourceMappingURL=chunk-QD4UHJFF.cjs.map