itd-api 0.7.0 → 0.7.2

package/dist/rest/index.js.map

@@ -0,0 +1 @@
+{"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-CG8oCQ9F.cjs

@@ -0,0 +1,108 @@
+const require_url = require("./url-BaMCQpYH.cjs");
+//#region src/core/auth-provider.ts
+/**
+* Идентификатор устройства, общий для провайдеров без сессии.
+*
+* Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,
+* поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса
+* значение не переживает — в этом и разница с полноценной сессией.
+*/
+function localDeviceId() {
+	let deviceId;
+	return () => {
+		deviceId ??= require_url.createDeviceId();
+		return Promise.resolve(deviceId);
+	};
+}
+/**
+* Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.
+*
+* @example
+* ```ts
+* const api = createRestClient(); // публичные эндпоинты доступны и без токена
+* ```
+*/
+function anonymousAuth() {
+	return {
+		token: () => Promise.resolve(null),
+		prepare: () => Promise.resolve(),
+		currentHeaders: () => ({}),
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {}
+	};
+}
+/**
+* Готовый Bearer-токен: ни хранилища, ни продления.
+*
+* Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.
+* Для сессии, которая продлевает себя сама, нужен полный клиент.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });
+* ```
+*/
+function bearerToken(accessToken) {
+	const headers = { Authorization: `Bearer ${accessToken}` };
+	return {
+		token: () => Promise.resolve(accessToken),
+		prepare: () => Promise.resolve(),
+		currentHeaders: () => headers,
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {}
+	};
+}
+/**
+* Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.
+*
+* Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,
+* а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что
+* подстановка заголовков обязана быть синхронной.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });
+* ```
+*/
+function tokenProvider(getToken) {
+	let cached = null;
+	const read = async () => {
+		cached = await getToken();
+		return cached;
+	};
+	return {
+		token: read,
+		prepare: async () => {
+			await read();
+		},
+		currentHeaders: () => cached ? { Authorization: `Bearer ${cached}` } : {},
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {
+			cached = null;
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "anonymousAuth", {
+	enumerable: true,
+	get: function() {
+		return anonymousAuth;
+	}
+});
+Object.defineProperty(exports, "bearerToken", {
+	enumerable: true,
+	get: function() {
+		return bearerToken;
+	}
+});
+Object.defineProperty(exports, "tokenProvider", {
+	enumerable: true,
+	get: function() {
+		return tokenProvider;
+	}
+});
+
+//# sourceMappingURL=auth-provider-CG8oCQ9F.cjs.map

package/dist/shared/auth-provider-CG8oCQ9F.cjs.map

@@ -0,0 +1 @@
+{"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-mYqxsSVa.js

@@ -0,0 +1,91 @@
+import { nt as createDeviceId } from "./url-IU0xN9wX.js";
+//#region src/core/auth-provider.ts
+/**
+* Идентификатор устройства, общий для провайдеров без сессии.
+*
+* Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,
+* поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса
+* значение не переживает — в этом и разница с полноценной сессией.
+*/
+function localDeviceId() {
+	let deviceId;
+	return () => {
+		deviceId ??= createDeviceId();
+		return Promise.resolve(deviceId);
+	};
+}
+/**
+* Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.
+*
+* @example
+* ```ts
+* const api = createRestClient(); // публичные эндпоинты доступны и без токена
+* ```
+*/
+function anonymousAuth() {
+	return {
+		token: () => Promise.resolve(null),
+		prepare: () => Promise.resolve(),
+		currentHeaders: () => ({}),
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {}
+	};
+}
+/**
+* Готовый Bearer-токен: ни хранилища, ни продления.
+*
+* Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.
+* Для сессии, которая продлевает себя сама, нужен полный клиент.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });
+* ```
+*/
+function bearerToken(accessToken) {
+	const headers = { Authorization: `Bearer ${accessToken}` };
+	return {
+		token: () => Promise.resolve(accessToken),
+		prepare: () => Promise.resolve(),
+		currentHeaders: () => headers,
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {}
+	};
+}
+/**
+* Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.
+*
+* Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,
+* а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что
+* подстановка заголовков обязана быть синхронной.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });
+* ```
+*/
+function tokenProvider(getToken) {
+	let cached = null;
+	const read = async () => {
+		cached = await getToken();
+		return cached;
+	};
+	return {
+		token: read,
+		prepare: async () => {
+			await read();
+		},
+		currentHeaders: () => cached ? { Authorization: `Bearer ${cached}` } : {},
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {
+			cached = null;
+		}
+	};
+}
+//#endregion
+export { bearerToken as n, tokenProvider as r, anonymousAuth as t };
+
+//# sourceMappingURL=auth-provider-mYqxsSVa.js.map

package/dist/shared/auth-provider-mYqxsSVa.js.map

@@ -0,0 +1 @@
+{"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"}

package/dist/shared/contracts-BoT7msmq.d.cts

@@ -0,0 +1,84 @@
+//#region src/core/attachments/contracts.d.ts
+/** Способ передачи содержимого вложения. */
+declare const FileTransferMode: Readonly<{
+  /** Сначала получить файл целиком, затем отправить его как `Blob`. */
+  readonly Buffer: "buffer";
+  /** Передавать данные по мере чтения, не собирая файл целиком в памяти. */
+  readonly Stream: "stream";
+}>;
+type FileTransferMode = (typeof FileTransferMode)[keyof typeof FileTransferMode];
+/** Что доступно источнику при открытии файла. */
+interface FileContext {
+  /** Общая отмена текущей попытки, включая её таймаут. */
+  signal?: AbortSignal | undefined;
+  /** `fetch` клиента — с переданными пользователем настройками. */
+  fetch: typeof fetch;
+  /** Номер попытки отправки, начиная с 1. */
+  attempt: number;
+}
+/** Готовое содержимое файла. */
+interface FileContent {
+  file: Blob | ArrayBuffer | Uint8Array;
+  /** Имя влияет на определение MIME, если `contentType` не задан. */
+  filename?: string | undefined;
+  /** MIME без параметров. Если не указан, определяется по имени или `Blob`. */
+  contentType?: string | undefined;
+}
+/** Открытый поток файла. */
+interface FileStreamContent {
+  stream: ReadableStream<Uint8Array>;
+  filename?: string | undefined;
+  contentType?: string | undefined;
+  /** Размер, если он известен до чтения. */
+  size?: number | undefined;
+  /** Освобождает внешний ресурс после завершения попытки. */
+  close?: (() => void | Promise<void>) | undefined;
+}
+/** Буферный источник, который вычисляется непосредственно перед первой попыткой. */
+interface LazyFile {
+  load: (context: FileContext) => FileContent | Promise<FileContent>;
+}
+/**
+ * Повторяемый потоковый источник.
+ *
+ * `open` вызывается для каждой попытки отправки. Он обязан возвращать новый поток:
+ * уже прочитанный `ReadableStream` повторно использовать нельзя.
+ */
+interface StreamFile {
+  open: (context: FileContext) => FileStreamContent | Promise<FileStreamContent>;
+}
+/** Общие настройки потоковой передачи. */
+interface FileStreamOptions {
+  /** Буферный или потоковый режим. По умолчанию `'buffer'`. */
+  mode?: FileTransferMode | undefined;
+  /** Максимальный размер файла. Без значения размер не ограничивается. */
+  maxBytes?: number | undefined;
+  /**
+   * Верхняя граница очереди, которой управляет библиотека. По умолчанию 4 МиБ.
+   *
+   * Сетевой рантайм может иметь собственные внутренние буферы сверх этого значения.
+   */
+  streamBufferBytes?: number | undefined;
+}
+/** Файл, который нужно получить по HTTP(S). */
+interface UrlFile extends UrlFileOptions {
+  url: string;
+}
+/** Настройки файла по HTTP(S). */
+interface UrlFileOptions extends FileStreamOptions {
+  filename?: string | undefined;
+  /** По умолчанию берётся из `Content-Type` ответа. */
+  contentType?: string | undefined;
+}
+/** Файл для загрузки. Голый поток не принимается, потому что его нельзя повторить. */
+type FileInput = Blob | ArrayBuffer | Uint8Array | FileContent | UrlFile | LazyFile | StreamFile;
+/** Настройки фабрики пользовательского потока. */
+interface FromStreamOptions extends Omit<FileStreamOptions, 'mode'> {
+  filename?: string | undefined;
+  contentType?: string | undefined;
+  /** Размер, если он известен заранее. */
+  size?: number | undefined;
+}
+//#endregion
+export { FileStreamOptions as a, LazyFile as c, UrlFileOptions as d, FileStreamContent as i, StreamFile as l, FileContext as n, FileTransferMode as o, FileInput as r, FromStreamOptions as s, FileContent as t, UrlFile as u };
+//# sourceMappingURL=contracts-BoT7msmq.d.cts.map

package/dist/shared/contracts-BoT7msmq.d.ts

@@ -0,0 +1,84 @@
+//#region src/core/attachments/contracts.d.ts
+/** Способ передачи содержимого вложения. */
+declare const FileTransferMode: Readonly<{
+  /** Сначала получить файл целиком, затем отправить его как `Blob`. */
+  readonly Buffer: "buffer";
+  /** Передавать данные по мере чтения, не собирая файл целиком в памяти. */
+  readonly Stream: "stream";
+}>;
+type FileTransferMode = (typeof FileTransferMode)[keyof typeof FileTransferMode];
+/** Что доступно источнику при открытии файла. */
+interface FileContext {
+  /** Общая отмена текущей попытки, включая её таймаут. */
+  signal?: AbortSignal | undefined;
+  /** `fetch` клиента — с переданными пользователем настройками. */
+  fetch: typeof fetch;
+  /** Номер попытки отправки, начиная с 1. */
+  attempt: number;
+}
+/** Готовое содержимое файла. */
+interface FileContent {
+  file: Blob | ArrayBuffer | Uint8Array;
+  /** Имя влияет на определение MIME, если `contentType` не задан. */
+  filename?: string | undefined;
+  /** MIME без параметров. Если не указан, определяется по имени или `Blob`. */
+  contentType?: string | undefined;
+}
+/** Открытый поток файла. */
+interface FileStreamContent {
+  stream: ReadableStream<Uint8Array>;
+  filename?: string | undefined;
+  contentType?: string | undefined;
+  /** Размер, если он известен до чтения. */
+  size?: number | undefined;
+  /** Освобождает внешний ресурс после завершения попытки. */
+  close?: (() => void | Promise<void>) | undefined;
+}
+/** Буферный источник, который вычисляется непосредственно перед первой попыткой. */
+interface LazyFile {
+  load: (context: FileContext) => FileContent | Promise<FileContent>;
+}
+/**
+ * Повторяемый потоковый источник.
+ *
+ * `open` вызывается для каждой попытки отправки. Он обязан возвращать новый поток:
+ * уже прочитанный `ReadableStream` повторно использовать нельзя.
+ */
+interface StreamFile {
+  open: (context: FileContext) => FileStreamContent | Promise<FileStreamContent>;
+}
+/** Общие настройки потоковой передачи. */
+interface FileStreamOptions {
+  /** Буферный или потоковый режим. По умолчанию `'buffer'`. */
+  mode?: FileTransferMode | undefined;
+  /** Максимальный размер файла. Без значения размер не ограничивается. */
+  maxBytes?: number | undefined;
+  /**
+   * Верхняя граница очереди, которой управляет библиотека. По умолчанию 4 МиБ.
+   *
+   * Сетевой рантайм может иметь собственные внутренние буферы сверх этого значения.
+   */
+  streamBufferBytes?: number | undefined;
+}
+/** Файл, который нужно получить по HTTP(S). */
+interface UrlFile extends UrlFileOptions {
+  url: string;
+}
+/** Настройки файла по HTTP(S). */
+interface UrlFileOptions extends FileStreamOptions {
+  filename?: string | undefined;
+  /** По умолчанию берётся из `Content-Type` ответа. */
+  contentType?: string | undefined;
+}
+/** Файл для загрузки. Голый поток не принимается, потому что его нельзя повторить. */
+type FileInput = Blob | ArrayBuffer | Uint8Array | FileContent | UrlFile | LazyFile | StreamFile;
+/** Настройки фабрики пользовательского потока. */
+interface FromStreamOptions extends Omit<FileStreamOptions, 'mode'> {
+  filename?: string | undefined;
+  contentType?: string | undefined;
+  /** Размер, если он известен заранее. */
+  size?: number | undefined;
+}
+//#endregion
+export { FileStreamOptions as a, LazyFile as c, UrlFileOptions as d, FileStreamContent as i, StreamFile as l, FileContext as n, FileTransferMode as o, FileInput as r, FromStreamOptions as s, FileContent as t, UrlFile as u };
+//# sourceMappingURL=contracts-BoT7msmq.d.ts.map