itd-api 0.6.0 → 0.7.1

package/dist/rest/index.d.cts

@@ -0,0 +1,138 @@
+import { $ as UserSummary, $t as RateLimitPacing, A as isItdFileError, B as Notification, Bt as RateLimitOptions, C as ItdStateError, Ct as ReportReason, D as isItdAuthError, Dt as ViewReason, E as isItdApiError, Et as SpanType, F as isItdServerError, Ft as Logger, G as FollowResult, Gt as ResponseContext, H as Actor, Ht as RequestContext, I as isItdStateError, It as OperationRequestOptions, J as PinsResult, Jt as RetryOptions, K as MyProfile, Kt as RetryContext, L as isItdValidationError, Lt as PaginationOptions, M as isItdNotFoundError, Mt as Unsubscribe, N as isItdPhoneVerificationError, Nt as ClientHooks, O as isItdConflictError, Ot as ViewSource, P as isItdRateLimitError, Pt as ErrorContextHook, Q as SubscriptionState, Qt as ServiceDefinition, R as NotificationEvent, Rt as RateLimitBucketContext, S as ItdServerError, T as ItdValidationError, Tt as ServiceState, Ut as RequestExtensions, V as NotificationSettings, Vt as RawRequestOptions, W as Author, Wt as RequestOptions, X as Profile, Xt as QueryParams, Y as PrivacySettings, Yt as RuntimeOptions, Z as PublicProfile, Zt as QueryValue, _ as ItdForbiddenError, _t as InteractionType, a as ItdAbortError, an as ItdOperationDefinition, at as DEFAULT_BASE_URL, b as ItdPhoneVerificationError, bt as Loose, c as ItdApiErrorKind, cn as isBuiltInOperationId, ct as IsoDate, d as ItdConflictError, dn as operationRetrySafety, dt as UserRef, en as RuntimeMode, f as ItdError, fn as BUCKET_LIMITS, ft as AccessType, g as ItdFileErrorReason, gn as RetrySafety, gt as IncidentKind, h as ItdFileError, hn as OperationMethod, ht as FeedTab, i as formatNotificationText, in as CustomOperationId, it as tokenProvider, j as isItdForbiddenError, jt as Listener, k as isItdError, kt as WallAccess, l as ItdAuthError, ln as operationBucket, lt as Span, m as ItdFieldErrors, mn as RateLimitBucket, mt as CommentSort, n as canonicalNotificationType, nn as systemClock, nt as anonymousAuth, o as ItdApiError, on as OPERATIONS, ot as STATUS_SERVICE, p as ItdErrorKind, pn as DEFAULT_RATE_LIMIT_BUCKET, pt as AttachmentType, q as Pin, qt as RetryDecisionContext, r as isKnownNotificationType, rn as BuiltInOperationId, rt as bearerToken, s as ItdApiErrorInit, sn as OperationId, st as LIBRARY_VERSION, t as resolveNotificationUrl, tn as ItdClock, tt as AuthProvider, u as ItdConfigError, un as operationMethod, ut as UserId, v as ItdNetworkError, vt as ItdErrorCode, w as ItdTimeoutError, wt as ReportTargetType, x as ItdRateLimitError, xt as NotificationType, y as ItdNotFoundError, yt as LikesVisibility, z as normalizeNotification, zt as RateLimitBucketOverride } from "../shared/url-B6-bXHKt.cjs";
+import { $ as poll, $t as CreatePostData, A as TelemetryResource, At as FilesResource, B as ReportInput, Bt as PinPostResult, C as DwellEntry, Ct as Report, D as TelemetryBatchOptions, Dt as UpdateNotificationSettingsInput, E as TelemetryBatch, Et as NotificationsResource, F as SubscriptionResource, Ft as Attachment, G as UserPostsParams, Gt as CommentBuilder, H as CommentsParams, Ht as PollOption, I as SearchResource, It as Comment, J as PostInput, Jt as BuilderInput, K as CreatePostInput, Kt as CommentInput, L as SearchResult, Lt as CommentReplyTo, M as ViewTracker, Mt as UploadedFile, N as ViewTrackerInput, Nt as CommentsResource, O as TelemetryClock, Ot as HashtagPostsParams, P as ViewTrackerOptions, Pt as RepliesParams, Q as PollInput, Qt as CreatePollInput, R as ReportsResource, Rt as Hashtag, S as UsersResource, Sn as PluginTeardown, St as Portal, T as PhotoOpenInput, Tt as NotificationListParams, U as FeedParams, Ut as Post, V as report, Vt as Poll, W as PostsResource, Wt as PostStats, X as post, Xt as isBuilder, Y as PostUpdateInput, Yt as ItdBuilder, Z as PollBuilder, Zt as CreateCommentInput, _ as fromUrl, _n as AttemptNext, _t as StatusIncidentLine, a as isMyProfile, an as PaginationMode, at as MarkupContent, b as UpdateProfileInput, bn as OperationTransformer, bt as ChangelogEntry, c as ALLOWED_MIME_TYPES, cn as mapPage, ct as TextMarkup, d as AudioMimeType, dn as Subscription, dt as PlatformClientVersion, en as CreateReportInput, et as ParseMarkupOptions, f as IMAGE_MIME_TYPES, ft as PlatformResource, g as fromStream, gn as AttemptInterceptor, gt as StatusDay, h as VideoMimeType, hn as AttemptExtensions, ht as ServiceStatus, i as statusDays, in as PageState, it as MarkupBuilder, j as VideoProgressInput, jt as UploadOptions, k as TelemetryOptions, kt as HashtagsResource, l as AUDIO_MIME_TYPES, ln as PaymentMethod, lt as autoSpans, m as VIDEO_MIME_TYPES, mn as AttemptContext, mt as PlatformStatus, n as SpanRenderFormat, nt as parseMarkdown, o as toDate, on as Paginator, ot as MarkupInput, p as ImageMimeType, pn as RateLimitBucketState, pt as PlatformVersions, q as PostBuilder, qt as comment, r as renderSpans, rn as Page, rt as AutoSpansOptions, s as utcStampToIso, sn as PaginatorOptions, st as MarkupSpan, t as RenderSpansOptions, tn as UpdatePostInput, tt as parseHtml, u as AllowedMimeType, un as Session, ut as markup, v as VerificationResource, vn as ClientPlugin, vt as Announcement, w as InteractionEntry, wt as VerificationStatus, x as UserListParams, xn as PluginApi, xt as Clan, y as UpdatePrivacyInput, yn as OperationExtensions, yt as AnnouncementButton, z as ReportBuilder, zt as LikeResult } from "../shared/render-DMp_3Nzk.cjs";
+import { a as FileStreamOptions, c as LazyFile, d as UrlFileOptions, i as FileStreamContent, l as StreamFile, n as FileContext, o as FileTransferMode, r as FileInput, s as FromStreamOptions, t as FileContent, u as UrlFile } from "../shared/contracts-BoT7msmq.cjs";
+//#region src/rest/client.d.ts
+/** Опции конструктора {@link ItdRestClient}. */
+interface RestClientOptions extends RuntimeOptions {
+  /**
+   * Авторизация. Строка — сокращение для {@link bearerToken}.
+   *
+   * Без неё доступны только публичные эндпоинты. Токен здесь считается готовым: продлевать
+   * его клиент не умеет и на `401` отвечает ошибкой. Сессия, которая входит по паролю
+   * и продлевает себя сама, живёт в полном `ItdClient`.
+   */
+  auth?: string | AuthProvider | undefined;
+}
+/**
+ * Минимальный клиент REST API итд.com.
+ *
+ * Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами
+ * и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.
+ * Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,
+ * браузерные приложения.
+ *
+ * @example
+ * ```ts
+ * import { createRestClient } from 'itd-api/rest';
+ *
+ * const api = createRestClient({ auth: process.env.ITD_TOKEN });
+ * const feed = await api.posts.list({ tab: 'popular' });
+ * ```
+ */
+declare class ItdRestClient {
+  #private;
+  /** Профили, подписки, блокировки, приватность. */
+  get users(): UsersResource;
+  /** Лента, публикация, реакции, репосты, комментарии к постам. */
+  get posts(): PostsResource;
+  /** Ответы на комментарии и действия над ними. */
+  get comments(): CommentsResource;
+  /** Загрузка файлов и медиа. */
+  get files(): FilesResource;
+  /** Уведомления: список, счётчик, отметки о прочтении, настройки. */
+  get notifications(): NotificationsResource;
+  /** Хэштеги и посты по ним. */
+  get hashtags(): HashtagsResource;
+  /** Глобальный поиск по пользователям и хэштегам. */
+  get search(): SearchResource;
+  /** Жалобы на контент и пользователей. */
+  get reports(): ReportsResource;
+  /** Верификация профиля. */
+  get verification(): VerificationResource;
+  /** Подписка и способы оплаты. */
+  get subscription(): SubscriptionResource;
+  /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */
+  get platform(): PlatformResource;
+  /** Телеметрия просмотров. */
+  get telemetry(): TelemetryResource;
+  constructor(options?: RestClientOptions);
+  /** Базовый URL, к которому обращается клиент. */
+  get baseUrl(): string;
+  /**
+   * Выполняет произвольный запрос к API.
+   *
+   * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся
+   * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.
+   *
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
+  request<T = unknown>(options: RawRequestOptions): Promise<T>;
+  /**
+   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.
+   *
+   * Пустой массив при `rateLimit: false`.
+   */
+  rateLimitState(): RateLimitBucketState[];
+  /**
+   * Подключает плагин.
+   *
+   * Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.
+   * Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.
+   *
+   * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
+  use(plugin: ClientPlugin): this;
+  /**
+   * Отключает плагин и освобождает заведённые им ресурсы.
+   *
+   * @returns `false`, если такого плагина не было
+   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин
+   */
+  unuse(name: string): Promise<boolean>;
+  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */
+  pluginNames(): string[];
+  /** Подключён ли плагин с таким именем. */
+  hasPlugin(name: string): boolean;
+  /**
+   * Регистрирует сервис платформы — домен, отличный от основного.
+   *
+   * @throws {ItdConfigError} если определение неверно или имя уже занято
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
+  defineService(definition: ServiceDefinition): this;
+  /**
+   * Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.
+   *
+   * После вызова клиентом можно пользоваться снова. Терминальное освобождение —
+   * это {@link dispose}.
+   */
+  close(): Promise<void>;
+  /**
+   * Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые
+   * запросы и отключает все плагины.
+   *
+   * Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы
+   * возвращают тот же результат очистки.
+   *
+   * @example
+   * ```ts
+   * await using api = createRestClient({ auth: token });
+   * ```
+   */
+  dispose(): Promise<void>;
+  /** Позволяет использовать клиент с `await using`. */
+  [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.
+ *
+ * @example
+ * ```ts
+ * const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });
+ * ```
+ */
+declare function createRestClient(options?: RestClientOptions): ItdRestClient;
+//#endregion
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type Actor, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthProvider, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type ChangelogEntry, type Clan, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, type MyProfile, type Notification, type NotificationEvent, type NotificationListParams, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type ItdOperationDefinition as OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RawRequestOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResponseContext, type RestClientOptions, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, type RuntimeOptions, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createRestClient, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
+//# sourceMappingURL=index.d.cts.map

package/dist/rest/index.d.ts

@@ -0,0 +1,138 @@
+import { $ as UserSummary, $t as RateLimitPacing, A as isItdFileError, B as Notification, Bt as RateLimitOptions, C as ItdStateError, Ct as ReportReason, D as isItdAuthError, Dt as ViewReason, E as isItdApiError, Et as SpanType, F as isItdServerError, Ft as Logger, G as FollowResult, Gt as ResponseContext, H as Actor, Ht as RequestContext, I as isItdStateError, It as OperationRequestOptions, J as PinsResult, Jt as RetryOptions, K as MyProfile, Kt as RetryContext, L as isItdValidationError, Lt as PaginationOptions, M as isItdNotFoundError, Mt as Unsubscribe, N as isItdPhoneVerificationError, Nt as ClientHooks, O as isItdConflictError, Ot as ViewSource, P as isItdRateLimitError, Pt as ErrorContextHook, Q as SubscriptionState, Qt as ServiceDefinition, R as NotificationEvent, Rt as RateLimitBucketContext, S as ItdServerError, T as ItdValidationError, Tt as ServiceState, Ut as RequestExtensions, V as NotificationSettings, Vt as RawRequestOptions, W as Author, Wt as RequestOptions, X as Profile, Xt as QueryParams, Y as PrivacySettings, Yt as RuntimeOptions, Z as PublicProfile, Zt as QueryValue, _ as ItdForbiddenError, _t as InteractionType, a as ItdAbortError, an as ItdOperationDefinition, at as DEFAULT_BASE_URL, b as ItdPhoneVerificationError, bt as Loose, c as ItdApiErrorKind, cn as isBuiltInOperationId, ct as IsoDate, d as ItdConflictError, dn as operationRetrySafety, dt as UserRef, en as RuntimeMode, f as ItdError, fn as BUCKET_LIMITS, ft as AccessType, g as ItdFileErrorReason, gn as RetrySafety, gt as IncidentKind, h as ItdFileError, hn as OperationMethod, ht as FeedTab, i as formatNotificationText, in as CustomOperationId, it as tokenProvider, j as isItdForbiddenError, jt as Listener, k as isItdError, kt as WallAccess, l as ItdAuthError, ln as operationBucket, lt as Span, m as ItdFieldErrors, mn as RateLimitBucket, mt as CommentSort, n as canonicalNotificationType, nn as systemClock, nt as anonymousAuth, o as ItdApiError, on as OPERATIONS, ot as STATUS_SERVICE, p as ItdErrorKind, pn as DEFAULT_RATE_LIMIT_BUCKET, pt as AttachmentType, q as Pin, qt as RetryDecisionContext, r as isKnownNotificationType, rn as BuiltInOperationId, rt as bearerToken, s as ItdApiErrorInit, sn as OperationId, st as LIBRARY_VERSION, t as resolveNotificationUrl, tn as ItdClock, tt as AuthProvider, u as ItdConfigError, un as operationMethod, ut as UserId, v as ItdNetworkError, vt as ItdErrorCode, w as ItdTimeoutError, wt as ReportTargetType, x as ItdRateLimitError, xt as NotificationType, y as ItdNotFoundError, yt as LikesVisibility, z as normalizeNotification, zt as RateLimitBucketOverride } from "../shared/url-B6-bXHKt.js";
+import { $ as poll, $t as CreatePostData, A as TelemetryResource, At as FilesResource, B as ReportInput, Bt as PinPostResult, C as DwellEntry, Ct as Report, D as TelemetryBatchOptions, Dt as UpdateNotificationSettingsInput, E as TelemetryBatch, Et as NotificationsResource, F as SubscriptionResource, Ft as Attachment, G as UserPostsParams, Gt as CommentBuilder, H as CommentsParams, Ht as PollOption, I as SearchResource, It as Comment, J as PostInput, Jt as BuilderInput, K as CreatePostInput, Kt as CommentInput, L as SearchResult, Lt as CommentReplyTo, M as ViewTracker, Mt as UploadedFile, N as ViewTrackerInput, Nt as CommentsResource, O as TelemetryClock, Ot as HashtagPostsParams, P as ViewTrackerOptions, Pt as RepliesParams, Q as PollInput, Qt as CreatePollInput, R as ReportsResource, Rt as Hashtag, S as UsersResource, Sn as PluginTeardown, St as Portal, T as PhotoOpenInput, Tt as NotificationListParams, U as FeedParams, Ut as Post, V as report, Vt as Poll, W as PostsResource, Wt as PostStats, X as post, Xt as isBuilder, Y as PostUpdateInput, Yt as ItdBuilder, Z as PollBuilder, Zt as CreateCommentInput, _ as fromUrl, _n as AttemptNext, _t as StatusIncidentLine, a as isMyProfile, an as PaginationMode, at as MarkupContent, b as UpdateProfileInput, bn as OperationTransformer, bt as ChangelogEntry, c as ALLOWED_MIME_TYPES, cn as mapPage, ct as TextMarkup, d as AudioMimeType, dn as Subscription, dt as PlatformClientVersion, en as CreateReportInput, et as ParseMarkupOptions, f as IMAGE_MIME_TYPES, ft as PlatformResource, g as fromStream, gn as AttemptInterceptor, gt as StatusDay, h as VideoMimeType, hn as AttemptExtensions, ht as ServiceStatus, i as statusDays, in as PageState, it as MarkupBuilder, j as VideoProgressInput, jt as UploadOptions, k as TelemetryOptions, kt as HashtagsResource, l as AUDIO_MIME_TYPES, ln as PaymentMethod, lt as autoSpans, m as VIDEO_MIME_TYPES, mn as AttemptContext, mt as PlatformStatus, n as SpanRenderFormat, nt as parseMarkdown, o as toDate, on as Paginator, ot as MarkupInput, p as ImageMimeType, pn as RateLimitBucketState, pt as PlatformVersions, q as PostBuilder, qt as comment, r as renderSpans, rn as Page, rt as AutoSpansOptions, s as utcStampToIso, sn as PaginatorOptions, st as MarkupSpan, t as RenderSpansOptions, tn as UpdatePostInput, tt as parseHtml, u as AllowedMimeType, un as Session, ut as markup, v as VerificationResource, vn as ClientPlugin, vt as Announcement, w as InteractionEntry, wt as VerificationStatus, x as UserListParams, xn as PluginApi, xt as Clan, y as UpdatePrivacyInput, yn as OperationExtensions, yt as AnnouncementButton, z as ReportBuilder, zt as LikeResult } from "../shared/render-DZrxhC5_.js";
+import { a as FileStreamOptions, c as LazyFile, d as UrlFileOptions, i as FileStreamContent, l as StreamFile, n as FileContext, o as FileTransferMode, r as FileInput, s as FromStreamOptions, t as FileContent, u as UrlFile } from "../shared/contracts-BoT7msmq.js";
+//#region src/rest/client.d.ts
+/** Опции конструктора {@link ItdRestClient}. */
+interface RestClientOptions extends RuntimeOptions {
+  /**
+   * Авторизация. Строка — сокращение для {@link bearerToken}.
+   *
+   * Без неё доступны только публичные эндпоинты. Токен здесь считается готовым: продлевать
+   * его клиент не умеет и на `401` отвечает ошибкой. Сессия, которая входит по паролю
+   * и продлевает себя сама, живёт в полном `ItdClient`.
+   */
+  auth?: string | AuthProvider | undefined;
+}
+/**
+ * Минимальный клиент REST API итд.com.
+ *
+ * Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами
+ * и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.
+ * Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,
+ * браузерные приложения.
+ *
+ * @example
+ * ```ts
+ * import { createRestClient } from 'itd-api/rest';
+ *
+ * const api = createRestClient({ auth: process.env.ITD_TOKEN });
+ * const feed = await api.posts.list({ tab: 'popular' });
+ * ```
+ */
+declare class ItdRestClient {
+  #private;
+  /** Профили, подписки, блокировки, приватность. */
+  get users(): UsersResource;
+  /** Лента, публикация, реакции, репосты, комментарии к постам. */
+  get posts(): PostsResource;
+  /** Ответы на комментарии и действия над ними. */
+  get comments(): CommentsResource;
+  /** Загрузка файлов и медиа. */
+  get files(): FilesResource;
+  /** Уведомления: список, счётчик, отметки о прочтении, настройки. */
+  get notifications(): NotificationsResource;
+  /** Хэштеги и посты по ним. */
+  get hashtags(): HashtagsResource;
+  /** Глобальный поиск по пользователям и хэштегам. */
+  get search(): SearchResource;
+  /** Жалобы на контент и пользователей. */
+  get reports(): ReportsResource;
+  /** Верификация профиля. */
+  get verification(): VerificationResource;
+  /** Подписка и способы оплаты. */
+  get subscription(): SubscriptionResource;
+  /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */
+  get platform(): PlatformResource;
+  /** Телеметрия просмотров. */
+  get telemetry(): TelemetryResource;
+  constructor(options?: RestClientOptions);
+  /** Базовый URL, к которому обращается клиент. */
+  get baseUrl(): string;
+  /**
+   * Выполняет произвольный запрос к API.
+   *
+   * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся
+   * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.
+   *
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
+  request<T = unknown>(options: RawRequestOptions): Promise<T>;
+  /**
+   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.
+   *
+   * Пустой массив при `rateLimit: false`.
+   */
+  rateLimitState(): RateLimitBucketState[];
+  /**
+   * Подключает плагин.
+   *
+   * Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.
+   * Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.
+   *
+   * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
+  use(plugin: ClientPlugin): this;
+  /**
+   * Отключает плагин и освобождает заведённые им ресурсы.
+   *
+   * @returns `false`, если такого плагина не было
+   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин
+   */
+  unuse(name: string): Promise<boolean>;
+  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */
+  pluginNames(): string[];
+  /** Подключён ли плагин с таким именем. */
+  hasPlugin(name: string): boolean;
+  /**
+   * Регистрирует сервис платформы — домен, отличный от основного.
+   *
+   * @throws {ItdConfigError} если определение неверно или имя уже занято
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
+  defineService(definition: ServiceDefinition): this;
+  /**
+   * Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.
+   *
+   * После вызова клиентом можно пользоваться снова. Терминальное освобождение —
+   * это {@link dispose}.
+   */
+  close(): Promise<void>;
+  /**
+   * Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые
+   * запросы и отключает все плагины.
+   *
+   * Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы
+   * возвращают тот же результат очистки.
+   *
+   * @example
+   * ```ts
+   * await using api = createRestClient({ auth: token });
+   * ```
+   */
+  dispose(): Promise<void>;
+  /** Позволяет использовать клиент с `await using`. */
+  [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.
+ *
+ * @example
+ * ```ts
+ * const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });
+ * ```
+ */
+declare function createRestClient(options?: RestClientOptions): ItdRestClient;
+//#endregion
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type Actor, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthProvider, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type ChangelogEntry, type Clan, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, type MyProfile, type Notification, type NotificationEvent, type NotificationListParams, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type ItdOperationDefinition as OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RawRequestOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResponseContext, type RestClientOptions, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, type RuntimeOptions, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createRestClient, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
+//# sourceMappingURL=index.d.ts.map

package/dist/rest/index.js

@@ -0,0 +1,238 @@
+import { $ as RuntimeMode, A as operationRetrySafety, C as ViewSource, D as isBuiltInOperationId, E as OPERATIONS, H as RetrySafety, K as DEFAULT_BASE_URL, M as DEFAULT_RATE_LIMIT_BUCKET, N as createClientRuntime, O as operationBucket, Q as RateLimitPacing, S as ViewReason, T as ITD_CATALOG, Y as LIBRARY_VERSION, at as systemClock, b as ServiceState, c as AccessType, d as FeedTab, f as IncidentKind, g as NotificationType, h as LikesVisibility, j as BUCKET_LIMITS, k as operationMethod, l as AttachmentType, m as ItdErrorCode, n as formatNotificationText, o as canonicalNotificationType, ot as installAsyncDisposeFallback, p as InteractionType, q as STATUS_SERVICE, r as normalizeNotification, s as isKnownNotificationType, t as resolveNotificationUrl, u as CommentSort, v as ReportReason, w as WallAccess, x as SpanType, y as ReportTargetType } from "../shared/url-CYXgxqGx.js";
+import { A as isItdStateError, C as isItdError, D as isItdPhoneVerificationError, E as isItdNotFoundError, O as isItdRateLimitError, S as isItdConflictError, T as isItdForbiddenError, _ as ItdStateError, a as ItdConfigError, b as isItdApiError, c as ItdErrorKind, d as ItdForbiddenError, f as ItdNetworkError, g as ItdServerError, h as ItdRateLimitError, i as ItdAuthError, j as isItdValidationError, k as isItdServerError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, r as ItdApiErrorKind, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason, v as ItdTimeoutError, w as isItdFileError, x as isItdAuthError, y as ItdValidationError } from "../shared/errors-Bhrd2fJd.js";
+import { E as mapPage, S as isBuilder, T as Paginator, _ as ALLOWED_MIME_TYPES, a as fromStream, b as VIDEO_MIME_TYPES, c as report, d as autoSpans, f as markup, g as utcStampToIso, h as toDate, i as isMyProfile, l as post, m as parseMarkdown, n as renderSpans, o as fromUrl, p as parseHtml, r as statusDays, s as createResources, t as SpanRenderFormat, u as poll, v as AUDIO_MIME_TYPES, w as PaginationMode, x as comment, y as IMAGE_MIME_TYPES } from "../shared/render-vtLixIiU.js";
+import { c as FileTransferMode } from "../shared/options-DtATYdLr.js";
+import { n as bearerToken, r as tokenProvider, t as anonymousAuth } from "../shared/auth-provider-BfogACAb.js";
+//#region src/rest/client.ts
+/**
+* Минимальный клиент REST API итд.com.
+*
+* Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами
+* и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.
+* Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,
+* браузерные приложения.
+*
+* @example
+* ```ts
+* import { createRestClient } from 'itd-api/rest';
+*
+* const api = createRestClient({ auth: process.env.ITD_TOKEN });
+* const feed = await api.posts.list({ tab: 'popular' });
+* ```
+*/
+var ItdRestClient = class ItdRestClient {
+	#runtime;
+	#resources;
+	/** Общий результат терминальной очистки для идемпотентных повторных вызовов. */
+	#disposePromise;
+	#disposed = false;
+	/** Профили, подписки, блокировки, приватность. */
+	get users() {
+		return this.#resources.users;
+	}
+	/** Лента, публикация, реакции, репосты, комментарии к постам. */
+	get posts() {
+		return this.#resources.posts;
+	}
+	/** Ответы на комментарии и действия над ними. */
+	get comments() {
+		return this.#resources.comments;
+	}
+	/** Загрузка файлов и медиа. */
+	get files() {
+		return this.#resources.files;
+	}
+	/** Уведомления: список, счётчик, отметки о прочтении, настройки. */
+	get notifications() {
+		return this.#resources.notifications;
+	}
+	/** Хэштеги и посты по ним. */
+	get hashtags() {
+		return this.#resources.hashtags;
+	}
+	/** Глобальный поиск по пользователям и хэштегам. */
+	get search() {
+		return this.#resources.search;
+	}
+	/** Жалобы на контент и пользователей. */
+	get reports() {
+		return this.#resources.reports;
+	}
+	/** Верификация профиля. */
+	get verification() {
+		return this.#resources.verification;
+	}
+	/** Подписка и способы оплаты. */
+	get subscription() {
+		return this.#resources.subscription;
+	}
+	/** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */
+	get platform() {
+		return this.#resources.platform;
+	}
+	/** Телеметрия просмотров. */
+	get telemetry() {
+		return this.#resources.telemetry;
+	}
+	constructor(options = {}) {
+		const { auth, ...runtimeOptions } = options;
+		this.#runtime = createClientRuntime(runtimeOptions, {
+			catalog: ITD_CATALOG,
+			assertActive: (action) => this.#assertActive(action),
+			auth: () => resolveAuthProvider(auth)
+		});
+		this.#resources = createResources({
+			http: this.#runtime.http,
+			fetch: this.#runtime.config.fetch
+		});
+	}
+	#assertActive(action) {
+		if (!this.#disposed) return;
+		throw new ItdStateError(`Клиент уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`);
+	}
+	/** Базовый URL, к которому обращается клиент. */
+	get baseUrl() {
+		return this.#runtime.config.baseUrl;
+	}
+	/**
+	* Выполняет произвольный запрос к API.
+	*
+	* Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся
+	* с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.
+	*
+	* @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+	*/
+	request(options) {
+		return this.#runtime.http.request({
+			...options,
+			operationId: options.operationId ?? "raw"
+		});
+	}
+	/**
+	* Остаток серверных лимитов по бакетам, через которые уже проходили запросы.
+	*
+	* Пустой массив при `rateLimit: false`.
+	*/
+	rateLimitState() {
+		return this.#runtime.rateLimitState();
+	}
+	/**
+	* Подключает плагин.
+	*
+	* Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.
+	* Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.
+	*
+	* @throws {ItdConfigError} если плагин задан неверно или уже подключён
+	* @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+	*/
+	use(plugin) {
+		this.#assertActive("подключить плагин");
+		this.#runtime.plugins.add(plugin, {
+			baseUrl: this.#runtime.config.baseUrl,
+			logger: this.#runtime.config.logger
+		});
+		return this;
+	}
+	/**
+	* Отключает плагин и освобождает заведённые им ресурсы.
+	*
+	* @returns `false`, если такого плагина не было
+	* @throws {ItdConfigError} если от плагина зависит другой подключённый плагин
+	*/
+	unuse(name) {
+		return this.#runtime.plugins.remove(name);
+	}
+	/** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */
+	pluginNames() {
+		return this.#runtime.plugins.names();
+	}
+	/** Подключён ли плагин с таким именем. */
+	hasPlugin(name) {
+		return this.#runtime.plugins.has(name);
+	}
+	/**
+	* Регистрирует сервис платформы — домен, отличный от основного.
+	*
+	* @throws {ItdConfigError} если определение неверно или имя уже занято
+	* @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+	*/
+	defineService(definition) {
+		this.#assertActive("зарегистрировать сервис");
+		this.#runtime.services.define(definition);
+		return this;
+	}
+	/**
+	* Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.
+	*
+	* После вызова клиентом можно пользоваться снова. Терминальное освобождение —
+	* это {@link dispose}.
+	*/
+	async close() {
+		try {
+			await this.#resources.closeTelemetry(false);
+		} finally {
+			this.#runtime.close();
+		}
+	}
+	/**
+	* Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые
+	* запросы и отключает все плагины.
+	*
+	* Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы
+	* возвращают тот же результат очистки.
+	*
+	* @example
+	* ```ts
+	* await using api = createRestClient({ auth: token });
+	* ```
+	*/
+	dispose() {
+		if (this.#disposePromise) return this.#disposePromise;
+		this.#disposed = true;
+		this.#disposePromise = this.#dispose();
+		return this.#disposePromise;
+	}
+	async #dispose() {
+		const errors = [];
+		this.#resources.prepareTelemetryClose();
+		try {
+			await this.#resources.closeTelemetry(true);
+		} catch (error) {
+			errors.push(error);
+		}
+		try {
+			this.#runtime.close();
+			await this.#runtime.dispose();
+		} catch (error) {
+			errors.push(error);
+		}
+		if (errors.length > 0) throw new AggregateError(errors, "Не удалось освободить клиент");
+	}
+	/** Позволяет использовать клиент с `await using`. */
+	[Symbol.asyncDispose]() {
+		return this.dispose();
+	}
+	static {
+		installAsyncDisposeFallback(ItdRestClient);
+	}
+};
+/** Приводит опцию `auth` к провайдеру конвейера. */
+function resolveAuthProvider(auth) {
+	if (auth === void 0) return anonymousAuth();
+	return typeof auth === "string" ? bearerToken(auth) : auth;
+}
+/**
+* Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });
+* ```
+*/
+function createRestClient(options = {}) {
+	return new ItdRestClient(options);
+}
+//#endregion
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, AttachmentType, BUCKET_LIMITS, CommentSort, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, NotificationType, OPERATIONS, PaginationMode, Paginator, RateLimitPacing, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, ServiceState, SpanRenderFormat, SpanType, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createRestClient, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
+
+//# sourceMappingURL=index.js.map

package/dist/rest/index.js.map

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