itd-api 0.7.1 → 0.7.2

package/dist/rest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#runtime","#resources","#assertActive","#disposed","#disposePromise","#dispose"],"sources":["../../src/rest/client.ts"],"sourcesContent":["import { installAsyncDisposeFallback } from '../core/async-dispose.js';\nimport { type AuthProvider, anonymousAuth, bearerToken } from '../core/auth-provider.js';\nimport { ItdStateError } from '../core/errors.js';\nimport { type ClientRuntime, createClientRuntime } from '../core/execution/client-runtime.js';\nimport type { RawRequestOptions, RuntimeOptions } from '../core/options.js';\nimport type { ClientPlugin } from '../core/plugins/contracts.js';\nimport type { RateLimitBucketState } from '../core/scheduling/rate-limit.js';\nimport type { ServiceDefinition } from '../core/services.js';\nimport { ITD_CATALOG } from '../domain/catalog.js';\nimport type { CommentsResource } from '../resources/comments.js';\nimport type { FilesResource } from '../resources/files.js';\nimport type { HashtagsResource } from '../resources/hashtags.js';\nimport type { NotificationsResource } from '../resources/notifications.js';\nimport type { PlatformResource } from '../resources/platform.js';\nimport type { PostsResource } from '../resources/posts.js';\nimport type { ReportsResource } from '../resources/reports.js';\nimport type { SearchResource } from '../resources/search.js';\nimport type { SubscriptionResource } from '../resources/subscription.js';\nimport type { TelemetryResource } from '../resources/telemetry.js';\nimport type { UsersResource } from '../resources/users.js';\nimport type { VerificationResource } from '../resources/verification.js';\nimport { createResources, type RestResources } from './resources.js';\n\n/** Опции конструктора {@link ItdRestClient}. */\nexport interface RestClientOptions extends RuntimeOptions {\n  /**\n   * Авторизация. Строка — сокращение для {@link bearerToken}.\n   *\n   * Без неё доступны только публичные эндпоинты. Токен здесь считается готовым: продлевать\n   * его клиент не умеет и на `401` отвечает ошибкой. Сессия, которая входит по паролю\n   * и продлевает себя сама, живёт в полном `ItdClient`.\n   */\n  auth?: string | AuthProvider | undefined;\n}\n\n/**\n * Минимальный клиент REST API итд.com.\n *\n * Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами\n * и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.\n * Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,\n * браузерные приложения.\n *\n * @example\n * ```ts\n * import { createRestClient } from 'itd-api/rest';\n *\n * const api = createRestClient({ auth: process.env.ITD_TOKEN });\n * const feed = await api.posts.list({ tab: 'popular' });\n * ```\n */\nexport class ItdRestClient {\n  readonly #runtime: ClientRuntime;\n  readonly #resources: RestResources;\n  /** Общий результат терминальной очистки для идемпотентных повторных вызовов. */\n  #disposePromise: Promise<void> | undefined;\n  #disposed = false;\n\n  /** Профили, подписки, блокировки, приватность. */\n  get users(): UsersResource {\n    return this.#resources.users;\n  }\n\n  /** Лента, публикация, реакции, репосты, комментарии к постам. */\n  get posts(): PostsResource {\n    return this.#resources.posts;\n  }\n\n  /** Ответы на комментарии и действия над ними. */\n  get comments(): CommentsResource {\n    return this.#resources.comments;\n  }\n\n  /** Загрузка файлов и медиа. */\n  get files(): FilesResource {\n    return this.#resources.files;\n  }\n\n  /** Уведомления: список, счётчик, отметки о прочтении, настройки. */\n  get notifications(): NotificationsResource {\n    return this.#resources.notifications;\n  }\n\n  /** Хэштеги и посты по ним. */\n  get hashtags(): HashtagsResource {\n    return this.#resources.hashtags;\n  }\n\n  /** Глобальный поиск по пользователям и хэштегам. */\n  get search(): SearchResource {\n    return this.#resources.search;\n  }\n\n  /** Жалобы на контент и пользователей. */\n  get reports(): ReportsResource {\n    return this.#resources.reports;\n  }\n\n  /** Верификация профиля. */\n  get verification(): VerificationResource {\n    return this.#resources.verification;\n  }\n\n  /** Подписка и способы оплаты. */\n  get subscription(): SubscriptionResource {\n    return this.#resources.subscription;\n  }\n\n  /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */\n  get platform(): PlatformResource {\n    return this.#resources.platform;\n  }\n\n  /** Телеметрия просмотров. */\n  get telemetry(): TelemetryResource {\n    return this.#resources.telemetry;\n  }\n\n  constructor(options: RestClientOptions = {}) {\n    const { auth, ...runtimeOptions } = options;\n\n    this.#runtime = createClientRuntime(runtimeOptions, {\n      catalog: ITD_CATALOG,\n      assertActive: (action) => this.#assertActive(action),\n      auth: () => resolveAuthProvider(auth),\n    });\n    this.#resources = createResources({\n      http: this.#runtime.http,\n      fetch: this.#runtime.config.fetch,\n    });\n  }\n\n  #assertActive(action: string): void {\n    if (!this.#disposed) return;\n    throw new ItdStateError(\n      `Клиент уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`,\n    );\n  }\n\n  /** Базовый URL, к которому обращается клиент. */\n  get baseUrl(): string {\n    return this.#runtime.config.baseUrl;\n  }\n\n  /**\n   * Выполняет произвольный запрос к API.\n   *\n   * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся\n   * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.\n   *\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  request<T = unknown>(options: RawRequestOptions): Promise<T> {\n    return this.#runtime.http.request<T>({\n      ...options,\n      operationId: options.operationId ?? 'raw',\n    });\n  }\n\n  /**\n   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.\n   *\n   * Пустой массив при `rateLimit: false`.\n   */\n  rateLimitState(): RateLimitBucketState[] {\n    return this.#runtime.rateLimitState();\n  }\n\n  /**\n   * Подключает плагин.\n   *\n   * Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.\n   * Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.\n   *\n   * @throws {ItdConfigError} если плагин задан неверно или уже подключён\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  use(plugin: ClientPlugin): this {\n    this.#assertActive('подключить плагин');\n    this.#runtime.plugins.add(plugin, {\n      baseUrl: this.#runtime.config.baseUrl,\n      logger: this.#runtime.config.logger,\n    });\n    return this;\n  }\n\n  /**\n   * Отключает плагин и освобождает заведённые им ресурсы.\n   *\n   * @returns `false`, если такого плагина не было\n   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин\n   */\n  unuse(name: string): Promise<boolean> {\n    return this.#runtime.plugins.remove(name);\n  }\n\n  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */\n  pluginNames(): string[] {\n    return this.#runtime.plugins.names();\n  }\n\n  /** Подключён ли плагин с таким именем. */\n  hasPlugin(name: string): boolean {\n    return this.#runtime.plugins.has(name);\n  }\n\n  /**\n   * Регистрирует сервис платформы — домен, отличный от основного.\n   *\n   * @throws {ItdConfigError} если определение неверно или имя уже занято\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  defineService(definition: ServiceDefinition): this {\n    this.#assertActive('зарегистрировать сервис');\n    this.#runtime.services.define(definition);\n    return this;\n  }\n\n  /**\n   * Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.\n   *\n   * После вызова клиентом можно пользоваться снова. Терминальное освобождение —\n   * это {@link dispose}.\n   */\n  async close(): Promise<void> {\n    try {\n      await this.#resources.closeTelemetry(false);\n    } finally {\n      this.#runtime.close();\n    }\n  }\n\n  /**\n   * Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые\n   * запросы и отключает все плагины.\n   *\n   * Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы\n   * возвращают тот же результат очистки.\n   *\n   * @example\n   * ```ts\n   * await using api = createRestClient({ auth: token });\n   * ```\n   */\n  dispose(): Promise<void> {\n    if (this.#disposePromise) return this.#disposePromise;\n    this.#disposed = true;\n    this.#disposePromise = this.#dispose();\n    return this.#disposePromise;\n  }\n\n  async #dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    // Телеметрия уходит через ещё установленный plugin pipeline и мимо проверки состояния.\n    this.#resources.prepareTelemetryClose();\n    try {\n      await this.#resources.closeTelemetry(true);\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      this.#runtime.close();\n      await this.#runtime.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    if (errors.length > 0) throw new AggregateError(errors, 'Не удалось освободить клиент');\n  }\n\n  /** Позволяет использовать клиент с `await using`. */\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n\n  static {\n    installAsyncDisposeFallback(ItdRestClient);\n  }\n}\n\n/** Приводит опцию `auth` к провайдеру конвейера. */\nfunction resolveAuthProvider(auth: RestClientOptions['auth']): AuthProvider {\n  if (auth === undefined) return anonymousAuth();\n  return typeof auth === 'string' ? bearerToken(auth) : auth;\n}\n\n/**\n * Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });\n * ```\n */\nexport function createRestClient(options: RestClientOptions = {}): ItdRestClient {\n  return new ItdRestClient(options);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#runtime","#features","#resources","#assertActive","#disposed","#disposePromise","#dispose"],"sources":["../../src/rest/client.ts"],"sourcesContent":["import { installAsyncDisposeFallback } from '../core/async-dispose.js';\nimport { type AuthProvider, anonymousAuth, bearerToken } from '../core/auth-provider.js';\nimport { ItdConfigError, ItdStateError } from '../core/errors.js';\nimport { type ClientRuntime, createClientRuntime } from '../core/execution/client-runtime.js';\nimport { ExtensibleOperationCatalog } from '../core/feature-catalog.js';\nimport { type ClientFeature, FeatureRegistry } from '../core/features.js';\nimport type { RawRequestOptions, RuntimeOptions } from '../core/options.js';\nimport type { ClientPlugin } from '../core/plugins/contracts.js';\nimport type { RateLimitBucketState } from '../core/scheduling/rate-limit.js';\nimport type { ServiceDefinition } from '../core/services.js';\nimport { ITD_CATALOG } from '../domain/catalog.js';\nimport type { CommentsResource } from '../resources/comments.js';\nimport type { FilesResource } from '../resources/files.js';\nimport type { HashtagsResource } from '../resources/hashtags.js';\nimport type { NotificationsResource } from '../resources/notifications.js';\nimport type { PlatformResource } from '../resources/platform.js';\nimport type { PostsResource } from '../resources/posts.js';\nimport type { ReportsResource } from '../resources/reports.js';\nimport type { SearchResource } from '../resources/search.js';\nimport { createStatusFeature } from '../resources/status.js';\nimport type { SubscriptionResource } from '../resources/subscription.js';\nimport type { TelemetryResource } from '../resources/telemetry.js';\nimport type { UsersResource } from '../resources/users.js';\nimport type { VerificationResource } from '../resources/verification.js';\nimport { createResources, type RestResources } from './resources.js';\n\n/** Опции конструктора {@link ItdRestClient}. */\nexport interface RestClientOptions extends RuntimeOptions {\n  /**\n   * Авторизация. Строка — сокращение для {@link bearerToken}.\n   *\n   * Без неё доступны только публичные эндпоинты. Токен здесь считается готовым: продлевать\n   * его клиент не умеет и на `401` отвечает ошибкой. Сессия, которая входит по паролю\n   * и продлевает себя сама, живёт в полном `ItdClient`.\n   */\n  auth?: string | AuthProvider | undefined;\n}\n\n/**\n * Минимальный клиент REST API итд.com.\n *\n * Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами\n * и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.\n * Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,\n * браузерные приложения.\n *\n * @example\n * ```ts\n * import { createRestClient } from 'itd-api/rest';\n *\n * const api = createRestClient({ auth: process.env.ITD_TOKEN });\n * const feed = await api.posts.list({ tab: 'popular' });\n * ```\n */\nexport class ItdRestClient {\n  readonly #runtime: ClientRuntime;\n  readonly #features: FeatureRegistry;\n  readonly #resources: RestResources;\n  /** Общий результат терминальной очистки для идемпотентных повторных вызовов. */\n  #disposePromise: Promise<void> | undefined;\n  #disposed = false;\n\n  /** Профили, подписки, блокировки, приватность. */\n  get users(): UsersResource {\n    return this.#resources.users;\n  }\n\n  /** Лента, публикация, реакции, репосты, комментарии к постам. */\n  get posts(): PostsResource {\n    return this.#resources.posts;\n  }\n\n  /** Ответы на комментарии и действия над ними. */\n  get comments(): CommentsResource {\n    return this.#resources.comments;\n  }\n\n  /** Загрузка файлов и медиа. */\n  get files(): FilesResource {\n    return this.#resources.files;\n  }\n\n  /** Уведомления: список, счётчик, отметки о прочтении, настройки. */\n  get notifications(): NotificationsResource {\n    return this.#resources.notifications;\n  }\n\n  /** Хэштеги и посты по ним. */\n  get hashtags(): HashtagsResource {\n    return this.#resources.hashtags;\n  }\n\n  /** Глобальный поиск по пользователям и хэштегам. */\n  get search(): SearchResource {\n    return this.#resources.search;\n  }\n\n  /** Жалобы на контент и пользователей. */\n  get reports(): ReportsResource {\n    return this.#resources.reports;\n  }\n\n  /** Верификация профиля. */\n  get verification(): VerificationResource {\n    return this.#resources.verification;\n  }\n\n  /** Подписка и способы оплаты. */\n  get subscription(): SubscriptionResource {\n    return this.#resources.subscription;\n  }\n\n  /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */\n  get platform(): PlatformResource {\n    return this.#resources.platform;\n  }\n\n  /** Телеметрия просмотров. */\n  get telemetry(): TelemetryResource {\n    return this.#resources.telemetry;\n  }\n\n  constructor(options: RestClientOptions = {}) {\n    const { auth, ...runtimeOptions } = options;\n    const catalog = new ExtensibleOperationCatalog(ITD_CATALOG);\n\n    this.#runtime = createClientRuntime(runtimeOptions, {\n      catalog,\n      assertActive: (action) => this.#assertActive(action),\n      auth: () => resolveAuthProvider(auth),\n    });\n    this.#features = new FeatureRegistry({\n      http: this.#runtime.http,\n      services: this.#runtime.services,\n      serviceOverrides: this.#runtime.config.services,\n      catalog,\n      baseUrl: this.#runtime.config.baseUrl,\n      clock: this.#runtime.config.clock,\n      logger: this.#runtime.config.logger,\n      assertActive: (action) => this.#assertActive(action),\n      registerBucket: (name, definition) => this.#runtime.registerRateLimitBucket(name, definition),\n    });\n    const status = this.#features.install(createStatusFeature());\n    this.#resources = createResources({\n      http: this.#runtime.http,\n      fetch: this.#runtime.config.fetch,\n      status,\n    });\n  }\n\n  #assertActive(action: string): void {\n    if (!this.#disposed) return;\n    throw new ItdStateError(\n      `Клиент уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`,\n    );\n  }\n\n  /** Базовый URL, к которому обращается клиент. */\n  get baseUrl(): string {\n    return this.#runtime.config.baseUrl;\n  }\n\n  /**\n   * Выполняет произвольный запрос к API.\n   *\n   * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся\n   * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.\n   *\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  request<T = unknown>(options: RawRequestOptions): Promise<T> {\n    return this.#runtime.http.request<T>({\n      ...options,\n      operationId: options.operationId ?? 'raw',\n    });\n  }\n\n  /**\n   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.\n   *\n   * Пустой массив при `rateLimit: false`.\n   */\n  rateLimitState(): RateLimitBucketState[] {\n    return this.#runtime.rateLimitState();\n  }\n\n  /** Устанавливает REST feature поверх общего request pipeline клиента. */\n  install<TApi>(feature: ClientFeature<TApi>): TApi {\n    return this.#features.install(feature);\n  }\n\n  /** Устанавливает REST feature и публикует его API как readonly-свойство клиента. */\n  withFeature<const K extends string, TApi>(\n    key: K,\n    feature: ClientFeature<TApi>,\n  ): this & { readonly [P in K]: TApi } {\n    this.#assertActive('установить feature');\n    if (typeof key !== 'string' || key.trim() === '' || key !== key.trim()) {\n      throw new ItdConfigError('Свойство feature должно иметь непустое имя без краевых пробелов');\n    }\n    if (key === 'then' || key in this) {\n      throw new ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);\n    }\n    if (!Object.isExtensible(this)) {\n      throw new ItdConfigError('Нельзя опубликовать feature на нерасширяемом клиенте');\n    }\n\n    const api = this.install(feature);\n    Object.defineProperty(this, key, {\n      value: api,\n      enumerable: true,\n      configurable: false,\n      writable: false,\n    });\n    return this as this & { readonly [P in K]: TApi };\n  }\n\n  /** Имена установленных feature в порядке установки. */\n  featureNames(): string[] {\n    return this.#features.names();\n  }\n\n  /** Установлен ли feature с таким именем. */\n  hasFeature(name: string): boolean {\n    return this.#features.has(name);\n  }\n\n  /**\n   * Подключает плагин.\n   *\n   * Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.\n   * Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.\n   *\n   * @throws {ItdConfigError} если плагин задан неверно или уже подключён\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  use(plugin: ClientPlugin): this {\n    this.#assertActive('подключить плагин');\n    this.#runtime.plugins.add(plugin, {\n      baseUrl: this.#runtime.config.baseUrl,\n      logger: this.#runtime.config.logger,\n    });\n    return this;\n  }\n\n  /**\n   * Отключает плагин и освобождает заведённые им ресурсы.\n   *\n   * @returns `false`, если такого плагина не было\n   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин\n   */\n  unuse(name: string): Promise<boolean> {\n    return this.#runtime.plugins.remove(name);\n  }\n\n  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */\n  pluginNames(): string[] {\n    return this.#runtime.plugins.names();\n  }\n\n  /** Подключён ли плагин с таким именем. */\n  hasPlugin(name: string): boolean {\n    return this.#runtime.plugins.has(name);\n  }\n\n  /**\n   * Регистрирует сервис платформы — домен, отличный от основного.\n   *\n   * @throws {ItdConfigError} если определение неверно или имя уже занято\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  defineService(definition: ServiceDefinition): this {\n    this.#assertActive('зарегистрировать сервис');\n    this.#runtime.services.define(definition);\n    return this;\n  }\n\n  /**\n   * Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.\n   *\n   * После вызова клиентом можно пользоваться снова. Терминальное освобождение —\n   * это {@link dispose}.\n   */\n  async close(): Promise<void> {\n    const errors: unknown[] = [];\n    try {\n      try {\n        await this.#features.close();\n      } catch (error) {\n        errors.push(error);\n      }\n      try {\n        await this.#resources.closeTelemetry(false);\n      } catch (error) {\n        errors.push(error);\n      }\n    } finally {\n      this.#runtime.close();\n    }\n    if (errors.length === 1) throw errors[0];\n    if (errors.length > 1) throw new AggregateError(errors, 'Не удалось закрыть клиент');\n  }\n\n  /**\n   * Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые\n   * запросы и отключает все плагины.\n   *\n   * Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы\n   * возвращают тот же результат очистки.\n   *\n   * @example\n   * ```ts\n   * await using api = createRestClient({ auth: token });\n   * ```\n   */\n  dispose(): Promise<void> {\n    if (this.#disposePromise) return this.#disposePromise;\n    this.#disposed = true;\n    this.#disposePromise = this.#dispose();\n    return this.#disposePromise;\n  }\n\n  async #dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    // Телеметрия уходит через ещё установленный plugin pipeline и мимо проверки состояния.\n    this.#resources.prepareTelemetryClose();\n    try {\n      await this.#features.close();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      await this.#resources.closeTelemetry(true);\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      await this.#features.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      this.#runtime.close();\n      await this.#runtime.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    if (errors.length > 0) throw new AggregateError(errors, 'Не удалось освободить клиент');\n  }\n\n  /** Позволяет использовать клиент с `await using`. */\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n\n  static {\n    installAsyncDisposeFallback(ItdRestClient);\n  }\n}\n\n/** Приводит опцию `auth` к провайдеру конвейера. */\nfunction resolveAuthProvider(auth: RestClientOptions['auth']): AuthProvider {\n  if (auth === undefined) return anonymousAuth();\n  return typeof auth === 'string' ? bearerToken(auth) : auth;\n}\n\n/**\n * Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });\n * ```\n */\nexport function createRestClient(options: RestClientOptions = {}): ItdRestClient {\n  return new ItdRestClient(options);\n}\n"],"mappings":"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"}

package/dist/shared/{auth-provider-CTJkKfgy.cjs → auth-provider-CG8oCQ9F.cjs}

@@ -1,4 +1,4 @@
-const require_url = require("./url-yjl2c8Ie.cjs");
+const require_url = require("./url-BaMCQpYH.cjs");
 //#region src/core/auth-provider.ts
 /**
 * Идентификатор устройства, общий для провайдеров без сессии.
@@ -105,4 +105,4 @@ Object.defineProperty(exports, "tokenProvider", {
 	}
 });
 
-//# sourceMappingURL=auth-provider-CTJkKfgy.cjs.map
+//# sourceMappingURL=auth-provider-CG8oCQ9F.cjs.map

package/dist/shared/{auth-provider-CTJkKfgy.cjs.map → auth-provider-CG8oCQ9F.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"auth-provider-CTJkKfgy.cjs","names":["createDeviceId"],"sources":["../../src/core/auth-provider.ts"],"sourcesContent":["import type { UserId } from '../models/common.js';\nimport type { ResolvedRuntimeConfig } from './config.js';\nimport type { CookieJar } from './cookies.js';\nimport type { RequestHandler } from './execution/pipeline.js';\nimport { createDeviceId } from './runtime.js';\n\n/** Области аккаунта и конкретной сессии для локального состояния плагинов. */\nexport interface AuthIdentity {\n  /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */\n  userId?: UserId | undefined;\n  /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */\n  sessionId?: string | undefined;\n}\n\n/**\n * Что конвейер запросов спрашивает у авторизации.\n *\n * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про\n * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым\n * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.\n *\n * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —\n * {@link bearerToken}, {@link tokenProvider} и {@link anonymousAuth}.\n */\nexport interface AuthProvider {\n  /**\n   * Текущий токен доступа.\n   *\n   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен\n   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.\n   */\n  token(): Promise<string | null>;\n  /**\n   * Готовит состояние авторизации до входа транспортной попытки в очередь.\n   *\n   * Чтение хранилища, обращение к внешнему источнику токена и отложенный вход асинхронны,\n   * поэтому обязаны завершиться до захвата слота очереди.\n   */\n  prepare(): Promise<void>;\n  /**\n   * Заголовки уже подготовленной авторизации.\n   *\n   * Синхронность существенна: слой стоит внутри очереди, непосредственно перед транспортом,\n   * и не должен запускать I/O. Зато запрос, отстоявший в очереди, получает самый свежий токен.\n   */\n  currentHeaders(): Record<string, string>;\n  /**\n   * Реакция на ответ `401`.\n   *\n   * @returns `true`, если токен обновлён и повторять попытку имеет смысл\n   */\n  recover(): Promise<boolean>;\n  /** Значение заголовка `X-Device-Id`. Отправляется и с анонимными запросами. */\n  deviceId(): Promise<string>;\n  /** Снимает подписки при терминальном освобождении владельца. */\n  dispose(): void;\n}\n\n/**\n * Что фабрика авторизации получает от собранного runtime.\n *\n * `handler` — тот же обработчик, которым пользуются ресурсы: вход и продление проходят\n * через общий конвейер с точечными skip-флагами, а не через второй, независимо\n * эволюционирующий путь.\n *\n * @internal\n */\nexport interface AuthProviderDeps {\n  config: ResolvedRuntimeConfig;\n  handler: RequestHandler;\n  cookies: CookieJar;\n  /** Вызывается синхронно перед сменой владельца авторизации. */\n  onAccountChange?: (() => void) | undefined;\n}\n\n/**\n * Идентификатор устройства, общий для провайдеров без сессии.\n *\n * Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,\n * поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса\n * значение не переживает — в этом и разница с полноценной сессией.\n */\nfunction localDeviceId(): () => Promise<string> {\n  let deviceId: string | undefined;\n\n  return () => {\n    deviceId ??= createDeviceId();\n    return Promise.resolve(deviceId);\n  };\n}\n\n/**\n * Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.\n *\n * @example\n * ```ts\n * const api = createRestClient(); // публичные эндпоинты доступны и без токена\n * ```\n */\nexport function anonymousAuth(): AuthProvider {\n  return {\n    token: () => Promise.resolve(null),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => ({}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Готовый Bearer-токен: ни хранилища, ни продления.\n *\n * Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.\n * Для сессии, которая продлевает себя сама, нужен полный клиент.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });\n * ```\n */\nexport function bearerToken(accessToken: string): AuthProvider {\n  const headers = { Authorization: `Bearer ${accessToken}` };\n\n  return {\n    token: () => Promise.resolve(accessToken),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => headers,\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.\n *\n * Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,\n * а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что\n * подстановка заголовков обязана быть синхронной.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });\n * ```\n */\nexport function tokenProvider(\n  getToken: () => string | null | Promise<string | null>,\n): AuthProvider {\n  let cached: string | null = null;\n\n  const read = async () => {\n    cached = await getToken();\n    return cached;\n  };\n\n  return {\n    token: read,\n    prepare: async () => {\n      await read();\n    },\n    currentHeaders: () => (cached ? { Authorization: `Bearer ${cached}` } : {}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {\n      cached = null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAkFA,SAAS,gBAAuC;CAC9C,IAAI;CAEJ,aAAa;EACX,aAAaA,YAAAA,eAAe;EAC5B,OAAO,QAAQ,QAAQ,QAAQ;CACjC;AACF;;;;;;;;;AAUA,SAAgB,gBAA8B;CAC5C,OAAO;EACL,aAAa,QAAQ,QAAQ,IAAI;EACjC,eAAe,QAAQ,QAAQ;EAC/B,uBAAuB,CAAC;EACxB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;AAaA,SAAgB,YAAY,aAAmC;CAC7D,MAAM,UAAU,EAAE,eAAe,UAAU,cAAc;CAEzD,OAAO;EACL,aAAa,QAAQ,QAAQ,WAAW;EACxC,eAAe,QAAQ,QAAQ;EAC/B,sBAAsB;EACtB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;;AAcA,SAAgB,cACd,UACc;CACd,IAAI,SAAwB;CAE5B,MAAM,OAAO,YAAY;EACvB,SAAS,MAAM,SAAS;EACxB,OAAO;CACT;CAEA,OAAO;EACL,OAAO;EACP,SAAS,YAAY;GACnB,MAAM,KAAK;EACb;EACA,sBAAuB,SAAS,EAAE,eAAe,UAAU,SAAS,IAAI,CAAC;EACzE,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe;GACb,SAAS;EACX;CACF;AACF"}
+{"version":3,"file":"auth-provider-CG8oCQ9F.cjs","names":["createDeviceId"],"sources":["../../src/core/auth-provider.ts"],"sourcesContent":["import type { UserId } from '../models/common.js';\nimport type { ResolvedRuntimeConfig } from './config.js';\nimport type { CookieJar } from './cookies.js';\nimport type { RequestHandler } from './execution/pipeline.js';\nimport { createDeviceId } from './runtime.js';\n\n/** Области аккаунта и конкретной сессии для локального состояния плагинов. */\nexport interface AuthIdentity {\n  /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */\n  userId?: UserId | undefined;\n  /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */\n  sessionId?: string | undefined;\n}\n\n/**\n * Что конвейер запросов спрашивает у авторизации.\n *\n * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про\n * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым\n * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.\n *\n * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —\n * {@link bearerToken}, {@link tokenProvider} и {@link anonymousAuth}.\n */\nexport interface AuthProvider {\n  /**\n   * Текущий токен доступа.\n   *\n   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен\n   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.\n   */\n  token(): Promise<string | null>;\n  /**\n   * Готовит состояние авторизации до входа транспортной попытки в очередь.\n   *\n   * Чтение хранилища, обращение к внешнему источнику токена и отложенный вход асинхронны,\n   * поэтому обязаны завершиться до захвата слота очереди.\n   */\n  prepare(): Promise<void>;\n  /**\n   * Заголовки уже подготовленной авторизации.\n   *\n   * Синхронность существенна: слой стоит внутри очереди, непосредственно перед транспортом,\n   * и не должен запускать I/O. Зато запрос, отстоявший в очереди, получает самый свежий токен.\n   */\n  currentHeaders(): Record<string, string>;\n  /**\n   * Реакция на ответ `401`.\n   *\n   * @returns `true`, если токен обновлён и повторять попытку имеет смысл\n   */\n  recover(): Promise<boolean>;\n  /** Значение заголовка `X-Device-Id`. Отправляется и с анонимными запросами. */\n  deviceId(): Promise<string>;\n  /** Снимает подписки при терминальном освобождении владельца. */\n  dispose(): void;\n}\n\n/**\n * Что фабрика авторизации получает от собранного runtime.\n *\n * `handler` — тот же обработчик, которым пользуются ресурсы: вход и продление проходят\n * через общий конвейер с точечными skip-флагами, а не через второй, независимо\n * эволюционирующий путь.\n *\n * @internal\n */\nexport interface AuthProviderDeps {\n  config: ResolvedRuntimeConfig;\n  handler: RequestHandler;\n  cookies: CookieJar;\n  /** Вызывается синхронно перед сменой владельца авторизации. */\n  onAccountChange?: (() => void) | undefined;\n}\n\n/**\n * Идентификатор устройства, общий для провайдеров без сессии.\n *\n * Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,\n * поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса\n * значение не переживает — в этом и разница с полноценной сессией.\n */\nfunction localDeviceId(): () => Promise<string> {\n  let deviceId: string | undefined;\n\n  return () => {\n    deviceId ??= createDeviceId();\n    return Promise.resolve(deviceId);\n  };\n}\n\n/**\n * Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.\n *\n * @example\n * ```ts\n * const api = createRestClient(); // публичные эндпоинты доступны и без токена\n * ```\n */\nexport function anonymousAuth(): AuthProvider {\n  return {\n    token: () => Promise.resolve(null),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => ({}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Готовый Bearer-токен: ни хранилища, ни продления.\n *\n * Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.\n * Для сессии, которая продлевает себя сама, нужен полный клиент.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });\n * ```\n */\nexport function bearerToken(accessToken: string): AuthProvider {\n  const headers = { Authorization: `Bearer ${accessToken}` };\n\n  return {\n    token: () => Promise.resolve(accessToken),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => headers,\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.\n *\n * Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,\n * а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что\n * подстановка заголовков обязана быть синхронной.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });\n * ```\n */\nexport function tokenProvider(\n  getToken: () => string | null | Promise<string | null>,\n): AuthProvider {\n  let cached: string | null = null;\n\n  const read = async () => {\n    cached = await getToken();\n    return cached;\n  };\n\n  return {\n    token: read,\n    prepare: async () => {\n      await read();\n    },\n    currentHeaders: () => (cached ? { Authorization: `Bearer ${cached}` } : {}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {\n      cached = null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAkFA,SAAS,gBAAuC;CAC9C,IAAI;CAEJ,aAAa;EACX,aAAaA,YAAAA,eAAe;EAC5B,OAAO,QAAQ,QAAQ,QAAQ;CACjC;AACF;;;;;;;;;AAUA,SAAgB,gBAA8B;CAC5C,OAAO;EACL,aAAa,QAAQ,QAAQ,IAAI;EACjC,eAAe,QAAQ,QAAQ;EAC/B,uBAAuB,CAAC;EACxB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;AAaA,SAAgB,YAAY,aAAmC;CAC7D,MAAM,UAAU,EAAE,eAAe,UAAU,cAAc;CAEzD,OAAO;EACL,aAAa,QAAQ,QAAQ,WAAW;EACxC,eAAe,QAAQ,QAAQ;EAC/B,sBAAsB;EACtB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;;AAcA,SAAgB,cACd,UACc;CACd,IAAI,SAAwB;CAE5B,MAAM,OAAO,YAAY;EACvB,SAAS,MAAM,SAAS;EACxB,OAAO;CACT;CAEA,OAAO;EACL,OAAO;EACP,SAAS,YAAY;GACnB,MAAM,KAAK;EACb;EACA,sBAAuB,SAAS,EAAE,eAAe,UAAU,SAAS,IAAI,CAAC;EACzE,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe;GACb,SAAS;EACX;CACF;AACF"}

package/dist/shared/{auth-provider-BfogACAb.js → auth-provider-mYqxsSVa.js}

@@ -1,4 +1,4 @@
-import { et as createDeviceId } from "./url-CYXgxqGx.js";
+import { nt as createDeviceId } from "./url-IU0xN9wX.js";
 //#region src/core/auth-provider.ts
 /**
 * Идентификатор устройства, общий для провайдеров без сессии.
@@ -88,4 +88,4 @@ function tokenProvider(getToken) {
 //#endregion
 export { bearerToken as n, tokenProvider as r, anonymousAuth as t };
 
-//# sourceMappingURL=auth-provider-BfogACAb.js.map
+//# sourceMappingURL=auth-provider-mYqxsSVa.js.map

package/dist/shared/{auth-provider-BfogACAb.js.map → auth-provider-mYqxsSVa.js.map}

@@ -1 +1 @@
-{"version":3,"file":"auth-provider-BfogACAb.js","names":[],"sources":["../../src/core/auth-provider.ts"],"sourcesContent":["import type { UserId } from '../models/common.js';\nimport type { ResolvedRuntimeConfig } from './config.js';\nimport type { CookieJar } from './cookies.js';\nimport type { RequestHandler } from './execution/pipeline.js';\nimport { createDeviceId } from './runtime.js';\n\n/** Области аккаунта и конкретной сессии для локального состояния плагинов. */\nexport interface AuthIdentity {\n  /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */\n  userId?: UserId | undefined;\n  /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */\n  sessionId?: string | undefined;\n}\n\n/**\n * Что конвейер запросов спрашивает у авторизации.\n *\n * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про\n * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым\n * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.\n *\n * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —\n * {@link bearerToken}, {@link tokenProvider} и {@link anonymousAuth}.\n */\nexport interface AuthProvider {\n  /**\n   * Текущий токен доступа.\n   *\n   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен\n   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.\n   */\n  token(): Promise<string | null>;\n  /**\n   * Готовит состояние авторизации до входа транспортной попытки в очередь.\n   *\n   * Чтение хранилища, обращение к внешнему источнику токена и отложенный вход асинхронны,\n   * поэтому обязаны завершиться до захвата слота очереди.\n   */\n  prepare(): Promise<void>;\n  /**\n   * Заголовки уже подготовленной авторизации.\n   *\n   * Синхронность существенна: слой стоит внутри очереди, непосредственно перед транспортом,\n   * и не должен запускать I/O. Зато запрос, отстоявший в очереди, получает самый свежий токен.\n   */\n  currentHeaders(): Record<string, string>;\n  /**\n   * Реакция на ответ `401`.\n   *\n   * @returns `true`, если токен обновлён и повторять попытку имеет смысл\n   */\n  recover(): Promise<boolean>;\n  /** Значение заголовка `X-Device-Id`. Отправляется и с анонимными запросами. */\n  deviceId(): Promise<string>;\n  /** Снимает подписки при терминальном освобождении владельца. */\n  dispose(): void;\n}\n\n/**\n * Что фабрика авторизации получает от собранного runtime.\n *\n * `handler` — тот же обработчик, которым пользуются ресурсы: вход и продление проходят\n * через общий конвейер с точечными skip-флагами, а не через второй, независимо\n * эволюционирующий путь.\n *\n * @internal\n */\nexport interface AuthProviderDeps {\n  config: ResolvedRuntimeConfig;\n  handler: RequestHandler;\n  cookies: CookieJar;\n  /** Вызывается синхронно перед сменой владельца авторизации. */\n  onAccountChange?: (() => void) | undefined;\n}\n\n/**\n * Идентификатор устройства, общий для провайдеров без сессии.\n *\n * Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,\n * поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса\n * значение не переживает — в этом и разница с полноценной сессией.\n */\nfunction localDeviceId(): () => Promise<string> {\n  let deviceId: string | undefined;\n\n  return () => {\n    deviceId ??= createDeviceId();\n    return Promise.resolve(deviceId);\n  };\n}\n\n/**\n * Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.\n *\n * @example\n * ```ts\n * const api = createRestClient(); // публичные эндпоинты доступны и без токена\n * ```\n */\nexport function anonymousAuth(): AuthProvider {\n  return {\n    token: () => Promise.resolve(null),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => ({}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Готовый Bearer-токен: ни хранилища, ни продления.\n *\n * Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.\n * Для сессии, которая продлевает себя сама, нужен полный клиент.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });\n * ```\n */\nexport function bearerToken(accessToken: string): AuthProvider {\n  const headers = { Authorization: `Bearer ${accessToken}` };\n\n  return {\n    token: () => Promise.resolve(accessToken),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => headers,\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.\n *\n * Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,\n * а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что\n * подстановка заголовков обязана быть синхронной.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });\n * ```\n */\nexport function tokenProvider(\n  getToken: () => string | null | Promise<string | null>,\n): AuthProvider {\n  let cached: string | null = null;\n\n  const read = async () => {\n    cached = await getToken();\n    return cached;\n  };\n\n  return {\n    token: read,\n    prepare: async () => {\n      await read();\n    },\n    currentHeaders: () => (cached ? { Authorization: `Bearer ${cached}` } : {}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {\n      cached = null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAkFA,SAAS,gBAAuC;CAC9C,IAAI;CAEJ,aAAa;EACX,aAAa,eAAe;EAC5B,OAAO,QAAQ,QAAQ,QAAQ;CACjC;AACF;;;;;;;;;AAUA,SAAgB,gBAA8B;CAC5C,OAAO;EACL,aAAa,QAAQ,QAAQ,IAAI;EACjC,eAAe,QAAQ,QAAQ;EAC/B,uBAAuB,CAAC;EACxB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;AAaA,SAAgB,YAAY,aAAmC;CAC7D,MAAM,UAAU,EAAE,eAAe,UAAU,cAAc;CAEzD,OAAO;EACL,aAAa,QAAQ,QAAQ,WAAW;EACxC,eAAe,QAAQ,QAAQ;EAC/B,sBAAsB;EACtB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;;AAcA,SAAgB,cACd,UACc;CACd,IAAI,SAAwB;CAE5B,MAAM,OAAO,YAAY;EACvB,SAAS,MAAM,SAAS;EACxB,OAAO;CACT;CAEA,OAAO;EACL,OAAO;EACP,SAAS,YAAY;GACnB,MAAM,KAAK;EACb;EACA,sBAAuB,SAAS,EAAE,eAAe,UAAU,SAAS,IAAI,CAAC;EACzE,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe;GACb,SAAS;EACX;CACF;AACF"}
+{"version":3,"file":"auth-provider-mYqxsSVa.js","names":[],"sources":["../../src/core/auth-provider.ts"],"sourcesContent":["import type { UserId } from '../models/common.js';\nimport type { ResolvedRuntimeConfig } from './config.js';\nimport type { CookieJar } from './cookies.js';\nimport type { RequestHandler } from './execution/pipeline.js';\nimport { createDeviceId } from './runtime.js';\n\n/** Области аккаунта и конкретной сессии для локального состояния плагинов. */\nexport interface AuthIdentity {\n  /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */\n  userId?: UserId | undefined;\n  /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */\n  sessionId?: string | undefined;\n}\n\n/**\n * Что конвейер запросов спрашивает у авторизации.\n *\n * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про\n * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым\n * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.\n *\n * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —\n * {@link bearerToken}, {@link tokenProvider} и {@link anonymousAuth}.\n */\nexport interface AuthProvider {\n  /**\n   * Текущий токен доступа.\n   *\n   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен\n   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.\n   */\n  token(): Promise<string | null>;\n  /**\n   * Готовит состояние авторизации до входа транспортной попытки в очередь.\n   *\n   * Чтение хранилища, обращение к внешнему источнику токена и отложенный вход асинхронны,\n   * поэтому обязаны завершиться до захвата слота очереди.\n   */\n  prepare(): Promise<void>;\n  /**\n   * Заголовки уже подготовленной авторизации.\n   *\n   * Синхронность существенна: слой стоит внутри очереди, непосредственно перед транспортом,\n   * и не должен запускать I/O. Зато запрос, отстоявший в очереди, получает самый свежий токен.\n   */\n  currentHeaders(): Record<string, string>;\n  /**\n   * Реакция на ответ `401`.\n   *\n   * @returns `true`, если токен обновлён и повторять попытку имеет смысл\n   */\n  recover(): Promise<boolean>;\n  /** Значение заголовка `X-Device-Id`. Отправляется и с анонимными запросами. */\n  deviceId(): Promise<string>;\n  /** Снимает подписки при терминальном освобождении владельца. */\n  dispose(): void;\n}\n\n/**\n * Что фабрика авторизации получает от собранного runtime.\n *\n * `handler` — тот же обработчик, которым пользуются ресурсы: вход и продление проходят\n * через общий конвейер с точечными skip-флагами, а не через второй, независимо\n * эволюционирующий путь.\n *\n * @internal\n */\nexport interface AuthProviderDeps {\n  config: ResolvedRuntimeConfig;\n  handler: RequestHandler;\n  cookies: CookieJar;\n  /** Вызывается синхронно перед сменой владельца авторизации. */\n  onAccountChange?: (() => void) | undefined;\n}\n\n/**\n * Идентификатор устройства, общий для провайдеров без сессии.\n *\n * Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,\n * поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса\n * значение не переживает — в этом и разница с полноценной сессией.\n */\nfunction localDeviceId(): () => Promise<string> {\n  let deviceId: string | undefined;\n\n  return () => {\n    deviceId ??= createDeviceId();\n    return Promise.resolve(deviceId);\n  };\n}\n\n/**\n * Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.\n *\n * @example\n * ```ts\n * const api = createRestClient(); // публичные эндпоинты доступны и без токена\n * ```\n */\nexport function anonymousAuth(): AuthProvider {\n  return {\n    token: () => Promise.resolve(null),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => ({}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Готовый Bearer-токен: ни хранилища, ни продления.\n *\n * Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.\n * Для сессии, которая продлевает себя сама, нужен полный клиент.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });\n * ```\n */\nexport function bearerToken(accessToken: string): AuthProvider {\n  const headers = { Authorization: `Bearer ${accessToken}` };\n\n  return {\n    token: () => Promise.resolve(accessToken),\n    prepare: () => Promise.resolve(),\n    currentHeaders: () => headers,\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {},\n  };\n}\n\n/**\n * Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.\n *\n * Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,\n * а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что\n * подстановка заголовков обязана быть синхронной.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });\n * ```\n */\nexport function tokenProvider(\n  getToken: () => string | null | Promise<string | null>,\n): AuthProvider {\n  let cached: string | null = null;\n\n  const read = async () => {\n    cached = await getToken();\n    return cached;\n  };\n\n  return {\n    token: read,\n    prepare: async () => {\n      await read();\n    },\n    currentHeaders: () => (cached ? { Authorization: `Bearer ${cached}` } : {}),\n    recover: () => Promise.resolve(false),\n    deviceId: localDeviceId(),\n    dispose: () => {\n      cached = null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAkFA,SAAS,gBAAuC;CAC9C,IAAI;CAEJ,aAAa;EACX,aAAa,eAAe;EAC5B,OAAO,QAAQ,QAAQ,QAAQ;CACjC;AACF;;;;;;;;;AAUA,SAAgB,gBAA8B;CAC5C,OAAO;EACL,aAAa,QAAQ,QAAQ,IAAI;EACjC,eAAe,QAAQ,QAAQ;EAC/B,uBAAuB,CAAC;EACxB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;AAaA,SAAgB,YAAY,aAAmC;CAC7D,MAAM,UAAU,EAAE,eAAe,UAAU,cAAc;CAEzD,OAAO;EACL,aAAa,QAAQ,QAAQ,WAAW;EACxC,eAAe,QAAQ,QAAQ;EAC/B,sBAAsB;EACtB,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe,CAAC;CAClB;AACF;;;;;;;;;;;;;AAcA,SAAgB,cACd,UACc;CACd,IAAI,SAAwB;CAE5B,MAAM,OAAO,YAAY;EACvB,SAAS,MAAM,SAAS;EACxB,OAAO;CACT;CAEA,OAAO;EACL,OAAO;EACP,SAAS,YAAY;GACnB,MAAM,KAAK;EACb;EACA,sBAAuB,SAAS,EAAE,eAAe,UAAU,SAAS,IAAI,CAAC;EACzE,eAAe,QAAQ,QAAQ,KAAK;EACpC,UAAU,cAAc;EACxB,eAAe;GACb,SAAS;EACX;CACF;AACF"}