itd-api 0.0.5 → 0.0.6

package/dist/{index-Dv0LXpMf.d.cts → index-CDGXKy8r.d.cts}

@@ -97,6 +97,39 @@ declare const AttachmentType: Readonly<{
     readonly Audio: "audio";
 }>;
 type AttachmentType = (typeof AttachmentType)[keyof typeof AttachmentType];
+/**
+ * Тип фрагмента разметки в тексте поста или комментария.
+ *
+ * Первые два сервер расставляет сам при разборе текста, остальные приходят от редактора.
+ * Тип открытый: набор может пополниться.
+ *
+ * @example
+ * ```ts
+ * await itd.posts.update(postId, {
+ *   content: 'жирное слово',
+ *   spans: [{ type: SpanType.Bold, offset: 0, length: 6 }],
+ * });
+ * ```
+ */
+declare const SpanType: Readonly<{
+    /** Хэштег. Название без решётки лежит в `tag`. */
+    readonly Hashtag: "hashtag";
+    /** Упоминание. Имя пользователя лежит в `tag`. */
+    readonly Mention: "mention";
+    /** Ссылка. Адрес лежит в `url`, а не в `tag`. */
+    readonly Link: "link";
+    readonly Bold: "bold";
+    readonly Italic: "italic";
+    readonly Underline: "underline";
+    /** Зачёркнутый. */
+    readonly Strike: "strike";
+    /** Спойлер: текст скрыт до нажатия. */
+    readonly Spoiler: "spoiler";
+    /** Моноширинный. */
+    readonly Monospace: "monospace";
+    readonly Quote: "quote";
+}>;
+type SpanType = Loose<(typeof SpanType)[keyof typeof SpanType]>;
 /** На что подаётся жалоба. */
 declare const ReportTargetType: Readonly<{
     readonly Post: "post";
@@ -264,14 +297,16 @@ type UserRef = string;
  * поэтому при работе с эмодзи проверяйте результат.
  */
 interface Span {
-    /** Тип фрагмента: `hashtag`, `mention`, `link` и другие. */
-    type: Loose<'hashtag' | 'mention' | 'link'>;
+    /** Тип фрагмента — см. {@link SpanType}. */
+    type: SpanType;
     /** Смещение от начала текста. */
     offset: number;
     /** Длина фрагмента. */
     length: number;
-    /** Содержимое: имя хэштега без решётки, имя пользователя, адрес ссылки. */
+    /** Имя хэштега без решётки либо имя пользователя. */
     tag?: string;
+    /** Адрес ссылки. Только у `link`: у него вместо `tag` отдельное поле. */
+    url?: string;
 }
 /**
  * Значок-«пин» в профиле — награда или отметка платформы.
@@ -1439,7 +1474,7 @@ declare const DEFAULT_TIMEOUT = 30000;
 /**
  * Версия библиотеки — попадает в `User-Agent`.
  */
-declare const LIBRARY_VERSION = "0.0.5";
+declare const LIBRARY_VERSION = "0.0.6";
 /**
  * `User-Agent` по умолчанию.
  *
@@ -1450,7 +1485,7 @@ declare const LIBRARY_VERSION = "0.0.5";
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.5; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.6; +https://github.com/KiowDev/itd-api)";
 /**
  * Настройки повторов со всеми значениями по умолчанию.
  *
@@ -1610,6 +1645,108 @@ declare class Emitter<Events> {
     removeAllListeners(): void;
 }
 
+/**
+ * Обёртка вокруг запроса.
+ *
+ * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
+ * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
+ *
+ * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
+ * @param next продолжение: либо следующая обёртка, либо настоящий запрос
+ * @returns тело ответа в том виде, в каком его получит вызывающий код
+ *
+ * @example Дописать заголовок ко всем запросам
+ * ```ts
+ * const transformer: Transformer = (request, next) =>
+ *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
+ * ```
+ */
+type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
+/** Что плагин получает при подключении. */
+interface PluginContext {
+    /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
+    baseUrl: string;
+    /** Отладочный вывод клиента, если он включён. */
+    logger: Logger | undefined;
+    /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
+    use(transformer: Transformer): void;
+}
+/**
+ * Плагин клиента.
+ *
+ * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
+ * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
+ * ей достаточно списка обёрток и имён опций, которые он читает.
+ *
+ * @example
+ * ```ts
+ * const logging: ItdPlugin = {
+ *   name: 'logging',
+ *   install({ use, logger }) {
+ *     use(async (request, next) => {
+ *       logger?.info(`${request.method} ${request.path}`);
+ *       return next(request);
+ *     });
+ *   },
+ * };
+ *
+ * itd.use(logging);
+ * ```
+ */
+interface ItdPlugin {
+    /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
+    name: string;
+    /**
+     * Имена опций запроса, которые плагин читает у методов ресурсов.
+     *
+     * Библиотека этих опций не понимает и ничего с ними не делает — только доносит
+     * от вызова метода до обёртки нетронутыми. Без такого списка чужие поля отсеиваются,
+     * чтобы случайная опечатка в параметрах не уезжала на сервер.
+     *
+     * Имена полей самого запроса (`path`, `body`, `headers`, `signal` и прочие из
+     * `RawRequestOptions`) заявить нельзя: подключение такого плагина завершится ошибкой.
+     *
+     * Типы для них плагин объявляет сам, дополняя `RequestOptions`:
+     * ```ts
+     * declare module 'itd-api' {
+     *   interface RequestOptions { encrypt?: string | undefined }
+     * }
+     * ```
+     */
+    optionKeys?: readonly string[];
+    /** Вызывается один раз при подключении. */
+    install(context: PluginContext): void;
+}
+/**
+ * Список подключённых плагинов и собранная из них цепочка обёрток.
+ *
+ * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
+ * каждый запрос, если плагины есть.
+ */
+declare class PluginRegistry {
+    #private;
+    /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
+    get size(): number;
+    /** Имена опций запроса, заявленные плагинами. */
+    get optionKeys(): ReadonlySet<string>;
+    /**
+     * Подключает плагин.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
+     * имя опции
+     */
+    add(plugin: ItdPlugin, context: Omit<PluginContext, 'use'>): void;
+    /**
+     * Прогоняет запрос через цепочку обёрток.
+     *
+     * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
+     * а обёрток единицы — экономить тут не на чем.
+     *
+     * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+     */
+    run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
+}
+
 /**
  * Подключаемые части конвейера.
  *
@@ -1666,6 +1803,15 @@ declare class HttpClient {
     constructor(config: ResolvedConfig, collaborators?: HttpCollaborators);
     /** Базовый URL, к которому обращается клиент. */
     get baseUrl(): string;
+    /**
+     * Имена опций запроса, заявленные плагинами.
+     *
+     * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
+     * если их никто не заявил, отсеивают.
+     */
+    get pluginOptionKeys(): ReadonlySet<string>;
+    /** Подключает список плагинов. Реестр общий с клиентом и пополняется через `itd.use()`. */
+    usePlugins(plugins: PluginRegistry): void;
     /**
      * Подключает недостающие части конвейера.
      *
@@ -2196,7 +2342,14 @@ declare class BaseResource {
     /** @internal */
     protected readonly http: HttpClient;
     constructor(http: HttpClient);
-    /** Переносит общие поля опций запроса в параметры транспорта. */
+    /**
+     * Переносит общие поля опций запроса в параметры транспорта.
+     *
+     * Поля перечислены поимённо, а не скопированы целиком: параметры методов наследуют
+     * {@link RequestOptions} и приносят с собой `limit`, `cursor` и прочее, чему в описании
+     * запроса делать нечего. Исключение — опции, заявленные плагинами: их библиотека
+     * не понимает, но обязана донести до обёрток нетронутыми.
+     */
     protected requestOptions(options: RequestOptions | undefined): Partial<RequestOptions>;
     /**
      * Собирает перебор страниц.
@@ -3181,6 +3334,24 @@ declare class ItdClient {
      * ```
      */
     request<T = unknown>(options: RawRequestOptions): Promise<T>;
+    /**
+     * Подключает плагин.
+     *
+     * Плагин работает на уровне транспорта: видит запрос до отправки и разобранный ответ,
+     * поэтому одна обёртка охватывает сразу все методы клиента. Подключать можно в любой
+     * момент, но обычно это делают сразу после создания клиента.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+     *
+     * @example
+     * ```ts
+     * import { crypt } from 'itd-api-crypto';
+     *
+     * itd.use(crypt());
+     * await itd.posts.create({ content: 'секрет' }, { encrypt: 'invis' });
+     * ```
+     */
+    use(plugin: ItdPlugin): this;
     /**
      * Подписывается на события авторизации.
      *
@@ -3611,4 +3782,4 @@ interface SseTransportOptions {
     idleTimeout?: number;
 }
 
-export { IMAGE_MIME_TYPES as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreatePollInput as D, type CreatePostInput as E, type FileReader as F, type CreateReportInput as G, type Credentials as H, type ItdSession as I, type CredentialsAuth as J, DEFAULT_BASE_URL as K, DEFAULT_TIMEOUT as L, DEFAULT_USER_AGENT as M, DEVICE_ID_HEADER as N, DetectedRuntime as O, type DwellEntry as P, type ErrorContextHook as Q, type FeedParams as R, FeedTab as S, type TokenStorage as T, type FileInput as U, FilesResource as V, type FollowResult as W, type ForgotPasswordInput as X, type Hashtag as Y, type HashtagPostsParams as Z, HashtagsResource as _, ItdClient as a, type Profile as a$, type ImageMimeType as a0, type InteractionEntry as a1, type IsoDate as a2, ItdAbortError as a3, ItdApiError as a4, type ItdApiErrorInit as a5, ItdApiErrorKind as a6, ItdAuthError as a7, type ItdBuilder as a8, ItdConfigError as a9, type NotificationEvent as aA, type NotificationListParams as aB, type NotificationSettings as aC, NotificationType as aD, NotificationsResource as aE, OAuthProvider as aF, type Page as aG, type PageState as aH, PaginationMode as aI, Paginator as aJ, type PaymentMethod as aK, type Pin as aL, type PinPostResult as aM, type PinsResult as aN, PlatformResource as aO, type Poll as aP, PollBuilder as aQ, type PollInput as aR, type PollOption as aS, type PollTransportOptions as aT, type Portal as aU, type Post as aV, PostBuilder as aW, type PostInput as aX, type PostStats as aY, PostsResource as aZ, type PrivacySettings as a_, ItdConflictError as aa, ItdError as ab, ItdErrorCode as ac, ItdErrorKind as ad, type ItdFieldErrors as ae, ItdForbiddenError as af, ItdNetworkError as ag, ItdNotFoundError as ah, ItdPhoneVerificationError as ai, ItdRateLimitError as aj, ItdRealtime as ak, ItdServerError as al, ItdTimeoutError as am, ItdValidationError as an, LIBRARY_VERSION as ao, type LikeResult as ap, LikesVisibility as aq, type Listener as ar, LocalStorageTokenStorage as as, type Logger as at, type Loose as au, MAX_RECONNECT_ATTEMPTS as av, MemoryTokenStorage as aw, type MyProfile as ax, NOTIFICATION_TYPE_ALIASES as ay, type Notification as az, type ItdClientOptions as b, formatNotificationText as b$, type PublicProfile as b0, RECONNECT_BACKOFF as b1, RECONNECT_JITTER as b2, REFRESH_COOKIE as b3, REFRESH_COOKIE_PATH as b4, type RateLimitOptions as b5, type RawRequestOptions as b6, type RealtimeEvents as b7, type RealtimeOptions as b8, RealtimeStatus as b9, SubscriptionResource as bA, type SubscriptionState as bB, TURNSTILE_SITE_KEY as bC, TelemetryResource as bD, type TransportContext as bE, type TransportEvent as bF, UnauthorizedStreamError as bG, type Unsubscribe as bH, type UpdateNotificationSettingsInput as bI, type UpdatePrivacyInput as bJ, type UpdateProfileInput as bK, type UploadOptions as bL, type UploadedFile as bM, type UserId as bN, type UserListParams as bO, type UserPostsParams as bP, type UserRef as bQ, type UserSummary as bR, UsersResource as bS, VIDEO_MIME_TYPES as bT, VerificationResource as bU, type VerificationStatus as bV, type VideoMimeType as bW, WallAccess as bX, canonicalNotificationType as bY, comment as bZ, createTokenStorage as b_, type RealtimeTransport as ba, RealtimeTransportKind as bb, type ReconnectOptions as bc, type RepliesParams as bd, type Report as be, ReportBuilder as bf, type ReportInput as bg, ReportReason as bh, ReportTargetType as bi, ReportsResource as bj, type RequestContext as bk, type RequestOptions as bl, type ResetPasswordInput as bm, type ResponseContext as bn, type RetryContext as bo, type RetryOptions as bp, RuntimeMode as bq, STREAM_PATH as br, SearchResource as bs, type SearchResult as bt, type Session as bu, type SignInResult as bv, SignInStatus as bw, type Span as bx, type SseTransportOptions as by, type Subscription as bz, AUDIO_MIME_TYPES as c, isBuilder as c0, isItdApiError as c1, isItdAuthError as c2, isItdConflictError as c3, isItdError as c4, isItdForbiddenError as c5, isItdNotFoundError as c6, isItdPhoneVerificationError as c7, isItdRateLimitError as c8, isItdServerError as c9, isItdValidationError as ca, isKnownNotificationType as cb, isMyProfile as cc, normalizeNotification as cd, poll as ce, post as cf, readNotificationEvent as cg, readUnreadCountEvent as ch, report as ci, resolveNotificationUrl as cj, toDate as ck, createClient as cl, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, type Actor as f, type AllowedMimeType as g, type Announcement as h, type AnnouncementButton as i, type Attachment as j, AttachmentType as k, type AudioMimeType as l, type AuthInput as m, AuthResource as n, type Author as o, type ChangelogEntry as p, type Clan as q, type ClientHooks as r, type Comment as s, CommentBuilder as t, type CommentInput as u, type CommentReplyTo as v, CommentSort as w, type CommentsParams as x, CommentsResource as y, type CreateCommentInput as z };
+export { IMAGE_MIME_TYPES as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreatePollInput as D, type CreatePostInput as E, type FileReader as F, type CreateReportInput as G, type Credentials as H, type ItdSession as I, type CredentialsAuth as J, DEFAULT_BASE_URL as K, DEFAULT_TIMEOUT as L, DEFAULT_USER_AGENT as M, DEVICE_ID_HEADER as N, DetectedRuntime as O, type DwellEntry as P, type ErrorContextHook as Q, type FeedParams as R, FeedTab as S, type TokenStorage as T, type FileInput as U, FilesResource as V, type FollowResult as W, type ForgotPasswordInput as X, type Hashtag as Y, type HashtagPostsParams as Z, HashtagsResource as _, ItdClient as a, PostsResource as a$, type ImageMimeType as a0, type InteractionEntry as a1, type IsoDate as a2, ItdAbortError as a3, ItdApiError as a4, type ItdApiErrorInit as a5, ItdApiErrorKind as a6, ItdAuthError as a7, type ItdBuilder as a8, ItdConfigError as a9, type Notification as aA, type NotificationEvent as aB, type NotificationListParams as aC, type NotificationSettings as aD, NotificationType as aE, NotificationsResource as aF, OAuthProvider as aG, type Page as aH, type PageState as aI, PaginationMode as aJ, Paginator as aK, type PaymentMethod as aL, type Pin as aM, type PinPostResult as aN, type PinsResult as aO, PlatformResource as aP, type PluginContext as aQ, type Poll as aR, PollBuilder as aS, type PollInput as aT, type PollOption as aU, type PollTransportOptions as aV, type Portal as aW, type Post as aX, PostBuilder as aY, type PostInput as aZ, type PostStats as a_, ItdConflictError as aa, ItdError as ab, ItdErrorCode as ac, ItdErrorKind as ad, type ItdFieldErrors as ae, ItdForbiddenError as af, ItdNetworkError as ag, ItdNotFoundError as ah, ItdPhoneVerificationError as ai, type ItdPlugin as aj, ItdRateLimitError as ak, ItdRealtime as al, ItdServerError as am, ItdTimeoutError as an, ItdValidationError as ao, LIBRARY_VERSION as ap, type LikeResult as aq, LikesVisibility as ar, type Listener as as, LocalStorageTokenStorage as at, type Logger as au, type Loose as av, MAX_RECONNECT_ATTEMPTS as aw, MemoryTokenStorage as ax, type MyProfile as ay, NOTIFICATION_TYPE_ALIASES as az, type ItdClientOptions as b, WallAccess as b$, type PrivacySettings as b0, type Profile as b1, type PublicProfile as b2, RECONNECT_BACKOFF as b3, RECONNECT_JITTER as b4, REFRESH_COOKIE as b5, REFRESH_COOKIE_PATH as b6, type RateLimitOptions as b7, type RawRequestOptions as b8, type RealtimeEvents as b9, SpanType as bA, type SseTransportOptions as bB, type Subscription as bC, SubscriptionResource as bD, type SubscriptionState as bE, TURNSTILE_SITE_KEY as bF, TelemetryResource as bG, type Transformer as bH, type TransportContext as bI, type TransportEvent as bJ, UnauthorizedStreamError as bK, type Unsubscribe as bL, type UpdateNotificationSettingsInput as bM, type UpdatePrivacyInput as bN, type UpdateProfileInput as bO, type UploadOptions as bP, type UploadedFile as bQ, type UserId as bR, type UserListParams as bS, type UserPostsParams as bT, type UserRef as bU, type UserSummary as bV, UsersResource as bW, VIDEO_MIME_TYPES as bX, VerificationResource as bY, type VerificationStatus as bZ, type VideoMimeType as b_, type RealtimeOptions as ba, RealtimeStatus as bb, type RealtimeTransport as bc, RealtimeTransportKind as bd, type ReconnectOptions as be, type RepliesParams as bf, type Report as bg, ReportBuilder as bh, type ReportInput as bi, ReportReason as bj, ReportTargetType as bk, ReportsResource as bl, type RequestContext as bm, type RequestOptions as bn, type ResetPasswordInput as bo, type ResponseContext as bp, type RetryContext as bq, type RetryOptions as br, RuntimeMode as bs, STREAM_PATH as bt, SearchResource as bu, type SearchResult as bv, type Session as bw, type SignInResult as bx, SignInStatus as by, type Span as bz, AUDIO_MIME_TYPES as c, canonicalNotificationType as c0, comment as c1, createTokenStorage as c2, formatNotificationText as c3, isBuilder as c4, isItdApiError as c5, isItdAuthError as c6, isItdConflictError as c7, isItdError as c8, isItdForbiddenError as c9, isItdNotFoundError as ca, isItdPhoneVerificationError as cb, isItdRateLimitError as cc, isItdServerError as cd, isItdValidationError as ce, isKnownNotificationType as cf, isMyProfile as cg, normalizeNotification as ch, poll as ci, post as cj, readNotificationEvent as ck, readUnreadCountEvent as cl, report as cm, resolveNotificationUrl as cn, toDate as co, createClient as cp, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, type Actor as f, type AllowedMimeType as g, type Announcement as h, type AnnouncementButton as i, type Attachment as j, AttachmentType as k, type AudioMimeType as l, type AuthInput as m, AuthResource as n, type Author as o, type ChangelogEntry as p, type Clan as q, type ClientHooks as r, type Comment as s, CommentBuilder as t, type CommentInput as u, type CommentReplyTo as v, CommentSort as w, type CommentsParams as x, CommentsResource as y, type CreateCommentInput as z };

package/dist/{index-Dv0LXpMf.d.ts → index-CDGXKy8r.d.ts}

@@ -97,6 +97,39 @@ declare const AttachmentType: Readonly<{
     readonly Audio: "audio";
 }>;
 type AttachmentType = (typeof AttachmentType)[keyof typeof AttachmentType];
+/**
+ * Тип фрагмента разметки в тексте поста или комментария.
+ *
+ * Первые два сервер расставляет сам при разборе текста, остальные приходят от редактора.
+ * Тип открытый: набор может пополниться.
+ *
+ * @example
+ * ```ts
+ * await itd.posts.update(postId, {
+ *   content: 'жирное слово',
+ *   spans: [{ type: SpanType.Bold, offset: 0, length: 6 }],
+ * });
+ * ```
+ */
+declare const SpanType: Readonly<{
+    /** Хэштег. Название без решётки лежит в `tag`. */
+    readonly Hashtag: "hashtag";
+    /** Упоминание. Имя пользователя лежит в `tag`. */
+    readonly Mention: "mention";
+    /** Ссылка. Адрес лежит в `url`, а не в `tag`. */
+    readonly Link: "link";
+    readonly Bold: "bold";
+    readonly Italic: "italic";
+    readonly Underline: "underline";
+    /** Зачёркнутый. */
+    readonly Strike: "strike";
+    /** Спойлер: текст скрыт до нажатия. */
+    readonly Spoiler: "spoiler";
+    /** Моноширинный. */
+    readonly Monospace: "monospace";
+    readonly Quote: "quote";
+}>;
+type SpanType = Loose<(typeof SpanType)[keyof typeof SpanType]>;
 /** На что подаётся жалоба. */
 declare const ReportTargetType: Readonly<{
     readonly Post: "post";
@@ -264,14 +297,16 @@ type UserRef = string;
  * поэтому при работе с эмодзи проверяйте результат.
  */
 interface Span {
-    /** Тип фрагмента: `hashtag`, `mention`, `link` и другие. */
-    type: Loose<'hashtag' | 'mention' | 'link'>;
+    /** Тип фрагмента — см. {@link SpanType}. */
+    type: SpanType;
     /** Смещение от начала текста. */
     offset: number;
     /** Длина фрагмента. */
     length: number;
-    /** Содержимое: имя хэштега без решётки, имя пользователя, адрес ссылки. */
+    /** Имя хэштега без решётки либо имя пользователя. */
     tag?: string;
+    /** Адрес ссылки. Только у `link`: у него вместо `tag` отдельное поле. */
+    url?: string;
 }
 /**
  * Значок-«пин» в профиле — награда или отметка платформы.
@@ -1439,7 +1474,7 @@ declare const DEFAULT_TIMEOUT = 30000;
 /**
  * Версия библиотеки — попадает в `User-Agent`.
  */
-declare const LIBRARY_VERSION = "0.0.5";
+declare const LIBRARY_VERSION = "0.0.6";
 /**
  * `User-Agent` по умолчанию.
  *
@@ -1450,7 +1485,7 @@ declare const LIBRARY_VERSION = "0.0.5";
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.5; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.6; +https://github.com/KiowDev/itd-api)";
 /**
  * Настройки повторов со всеми значениями по умолчанию.
  *
@@ -1610,6 +1645,108 @@ declare class Emitter<Events> {
     removeAllListeners(): void;
 }
 
+/**
+ * Обёртка вокруг запроса.
+ *
+ * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
+ * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
+ *
+ * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
+ * @param next продолжение: либо следующая обёртка, либо настоящий запрос
+ * @returns тело ответа в том виде, в каком его получит вызывающий код
+ *
+ * @example Дописать заголовок ко всем запросам
+ * ```ts
+ * const transformer: Transformer = (request, next) =>
+ *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
+ * ```
+ */
+type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
+/** Что плагин получает при подключении. */
+interface PluginContext {
+    /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
+    baseUrl: string;
+    /** Отладочный вывод клиента, если он включён. */
+    logger: Logger | undefined;
+    /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
+    use(transformer: Transformer): void;
+}
+/**
+ * Плагин клиента.
+ *
+ * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
+ * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
+ * ей достаточно списка обёрток и имён опций, которые он читает.
+ *
+ * @example
+ * ```ts
+ * const logging: ItdPlugin = {
+ *   name: 'logging',
+ *   install({ use, logger }) {
+ *     use(async (request, next) => {
+ *       logger?.info(`${request.method} ${request.path}`);
+ *       return next(request);
+ *     });
+ *   },
+ * };
+ *
+ * itd.use(logging);
+ * ```
+ */
+interface ItdPlugin {
+    /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
+    name: string;
+    /**
+     * Имена опций запроса, которые плагин читает у методов ресурсов.
+     *
+     * Библиотека этих опций не понимает и ничего с ними не делает — только доносит
+     * от вызова метода до обёртки нетронутыми. Без такого списка чужие поля отсеиваются,
+     * чтобы случайная опечатка в параметрах не уезжала на сервер.
+     *
+     * Имена полей самого запроса (`path`, `body`, `headers`, `signal` и прочие из
+     * `RawRequestOptions`) заявить нельзя: подключение такого плагина завершится ошибкой.
+     *
+     * Типы для них плагин объявляет сам, дополняя `RequestOptions`:
+     * ```ts
+     * declare module 'itd-api' {
+     *   interface RequestOptions { encrypt?: string | undefined }
+     * }
+     * ```
+     */
+    optionKeys?: readonly string[];
+    /** Вызывается один раз при подключении. */
+    install(context: PluginContext): void;
+}
+/**
+ * Список подключённых плагинов и собранная из них цепочка обёрток.
+ *
+ * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
+ * каждый запрос, если плагины есть.
+ */
+declare class PluginRegistry {
+    #private;
+    /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
+    get size(): number;
+    /** Имена опций запроса, заявленные плагинами. */
+    get optionKeys(): ReadonlySet<string>;
+    /**
+     * Подключает плагин.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
+     * имя опции
+     */
+    add(plugin: ItdPlugin, context: Omit<PluginContext, 'use'>): void;
+    /**
+     * Прогоняет запрос через цепочку обёрток.
+     *
+     * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
+     * а обёрток единицы — экономить тут не на чем.
+     *
+     * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+     */
+    run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
+}
+
 /**
  * Подключаемые части конвейера.
  *
@@ -1666,6 +1803,15 @@ declare class HttpClient {
     constructor(config: ResolvedConfig, collaborators?: HttpCollaborators);
     /** Базовый URL, к которому обращается клиент. */
     get baseUrl(): string;
+    /**
+     * Имена опций запроса, заявленные плагинами.
+     *
+     * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
+     * если их никто не заявил, отсеивают.
+     */
+    get pluginOptionKeys(): ReadonlySet<string>;
+    /** Подключает список плагинов. Реестр общий с клиентом и пополняется через `itd.use()`. */
+    usePlugins(plugins: PluginRegistry): void;
     /**
      * Подключает недостающие части конвейера.
      *
@@ -2196,7 +2342,14 @@ declare class BaseResource {
     /** @internal */
     protected readonly http: HttpClient;
     constructor(http: HttpClient);
-    /** Переносит общие поля опций запроса в параметры транспорта. */
+    /**
+     * Переносит общие поля опций запроса в параметры транспорта.
+     *
+     * Поля перечислены поимённо, а не скопированы целиком: параметры методов наследуют
+     * {@link RequestOptions} и приносят с собой `limit`, `cursor` и прочее, чему в описании
+     * запроса делать нечего. Исключение — опции, заявленные плагинами: их библиотека
+     * не понимает, но обязана донести до обёрток нетронутыми.
+     */
     protected requestOptions(options: RequestOptions | undefined): Partial<RequestOptions>;
     /**
      * Собирает перебор страниц.
@@ -3181,6 +3334,24 @@ declare class ItdClient {
      * ```
      */
     request<T = unknown>(options: RawRequestOptions): Promise<T>;
+    /**
+     * Подключает плагин.
+     *
+     * Плагин работает на уровне транспорта: видит запрос до отправки и разобранный ответ,
+     * поэтому одна обёртка охватывает сразу все методы клиента. Подключать можно в любой
+     * момент, но обычно это делают сразу после создания клиента.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+     *
+     * @example
+     * ```ts
+     * import { crypt } from 'itd-api-crypto';
+     *
+     * itd.use(crypt());
+     * await itd.posts.create({ content: 'секрет' }, { encrypt: 'invis' });
+     * ```
+     */
+    use(plugin: ItdPlugin): this;
     /**
      * Подписывается на события авторизации.
      *
@@ -3611,4 +3782,4 @@ interface SseTransportOptions {
     idleTimeout?: number;
 }
 
-export { IMAGE_MIME_TYPES as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreatePollInput as D, type CreatePostInput as E, type FileReader as F, type CreateReportInput as G, type Credentials as H, type ItdSession as I, type CredentialsAuth as J, DEFAULT_BASE_URL as K, DEFAULT_TIMEOUT as L, DEFAULT_USER_AGENT as M, DEVICE_ID_HEADER as N, DetectedRuntime as O, type DwellEntry as P, type ErrorContextHook as Q, type FeedParams as R, FeedTab as S, type TokenStorage as T, type FileInput as U, FilesResource as V, type FollowResult as W, type ForgotPasswordInput as X, type Hashtag as Y, type HashtagPostsParams as Z, HashtagsResource as _, ItdClient as a, type Profile as a$, type ImageMimeType as a0, type InteractionEntry as a1, type IsoDate as a2, ItdAbortError as a3, ItdApiError as a4, type ItdApiErrorInit as a5, ItdApiErrorKind as a6, ItdAuthError as a7, type ItdBuilder as a8, ItdConfigError as a9, type NotificationEvent as aA, type NotificationListParams as aB, type NotificationSettings as aC, NotificationType as aD, NotificationsResource as aE, OAuthProvider as aF, type Page as aG, type PageState as aH, PaginationMode as aI, Paginator as aJ, type PaymentMethod as aK, type Pin as aL, type PinPostResult as aM, type PinsResult as aN, PlatformResource as aO, type Poll as aP, PollBuilder as aQ, type PollInput as aR, type PollOption as aS, type PollTransportOptions as aT, type Portal as aU, type Post as aV, PostBuilder as aW, type PostInput as aX, type PostStats as aY, PostsResource as aZ, type PrivacySettings as a_, ItdConflictError as aa, ItdError as ab, ItdErrorCode as ac, ItdErrorKind as ad, type ItdFieldErrors as ae, ItdForbiddenError as af, ItdNetworkError as ag, ItdNotFoundError as ah, ItdPhoneVerificationError as ai, ItdRateLimitError as aj, ItdRealtime as ak, ItdServerError as al, ItdTimeoutError as am, ItdValidationError as an, LIBRARY_VERSION as ao, type LikeResult as ap, LikesVisibility as aq, type Listener as ar, LocalStorageTokenStorage as as, type Logger as at, type Loose as au, MAX_RECONNECT_ATTEMPTS as av, MemoryTokenStorage as aw, type MyProfile as ax, NOTIFICATION_TYPE_ALIASES as ay, type Notification as az, type ItdClientOptions as b, formatNotificationText as b$, type PublicProfile as b0, RECONNECT_BACKOFF as b1, RECONNECT_JITTER as b2, REFRESH_COOKIE as b3, REFRESH_COOKIE_PATH as b4, type RateLimitOptions as b5, type RawRequestOptions as b6, type RealtimeEvents as b7, type RealtimeOptions as b8, RealtimeStatus as b9, SubscriptionResource as bA, type SubscriptionState as bB, TURNSTILE_SITE_KEY as bC, TelemetryResource as bD, type TransportContext as bE, type TransportEvent as bF, UnauthorizedStreamError as bG, type Unsubscribe as bH, type UpdateNotificationSettingsInput as bI, type UpdatePrivacyInput as bJ, type UpdateProfileInput as bK, type UploadOptions as bL, type UploadedFile as bM, type UserId as bN, type UserListParams as bO, type UserPostsParams as bP, type UserRef as bQ, type UserSummary as bR, UsersResource as bS, VIDEO_MIME_TYPES as bT, VerificationResource as bU, type VerificationStatus as bV, type VideoMimeType as bW, WallAccess as bX, canonicalNotificationType as bY, comment as bZ, createTokenStorage as b_, type RealtimeTransport as ba, RealtimeTransportKind as bb, type ReconnectOptions as bc, type RepliesParams as bd, type Report as be, ReportBuilder as bf, type ReportInput as bg, ReportReason as bh, ReportTargetType as bi, ReportsResource as bj, type RequestContext as bk, type RequestOptions as bl, type ResetPasswordInput as bm, type ResponseContext as bn, type RetryContext as bo, type RetryOptions as bp, RuntimeMode as bq, STREAM_PATH as br, SearchResource as bs, type SearchResult as bt, type Session as bu, type SignInResult as bv, SignInStatus as bw, type Span as bx, type SseTransportOptions as by, type Subscription as bz, AUDIO_MIME_TYPES as c, isBuilder as c0, isItdApiError as c1, isItdAuthError as c2, isItdConflictError as c3, isItdError as c4, isItdForbiddenError as c5, isItdNotFoundError as c6, isItdPhoneVerificationError as c7, isItdRateLimitError as c8, isItdServerError as c9, isItdValidationError as ca, isKnownNotificationType as cb, isMyProfile as cc, normalizeNotification as cd, poll as ce, post as cf, readNotificationEvent as cg, readUnreadCountEvent as ch, report as ci, resolveNotificationUrl as cj, toDate as ck, createClient as cl, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, type Actor as f, type AllowedMimeType as g, type Announcement as h, type AnnouncementButton as i, type Attachment as j, AttachmentType as k, type AudioMimeType as l, type AuthInput as m, AuthResource as n, type Author as o, type ChangelogEntry as p, type Clan as q, type ClientHooks as r, type Comment as s, CommentBuilder as t, type CommentInput as u, type CommentReplyTo as v, CommentSort as w, type CommentsParams as x, CommentsResource as y, type CreateCommentInput as z };
+export { IMAGE_MIME_TYPES as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreatePollInput as D, type CreatePostInput as E, type FileReader as F, type CreateReportInput as G, type Credentials as H, type ItdSession as I, type CredentialsAuth as J, DEFAULT_BASE_URL as K, DEFAULT_TIMEOUT as L, DEFAULT_USER_AGENT as M, DEVICE_ID_HEADER as N, DetectedRuntime as O, type DwellEntry as P, type ErrorContextHook as Q, type FeedParams as R, FeedTab as S, type TokenStorage as T, type FileInput as U, FilesResource as V, type FollowResult as W, type ForgotPasswordInput as X, type Hashtag as Y, type HashtagPostsParams as Z, HashtagsResource as _, ItdClient as a, PostsResource as a$, type ImageMimeType as a0, type InteractionEntry as a1, type IsoDate as a2, ItdAbortError as a3, ItdApiError as a4, type ItdApiErrorInit as a5, ItdApiErrorKind as a6, ItdAuthError as a7, type ItdBuilder as a8, ItdConfigError as a9, type Notification as aA, type NotificationEvent as aB, type NotificationListParams as aC, type NotificationSettings as aD, NotificationType as aE, NotificationsResource as aF, OAuthProvider as aG, type Page as aH, type PageState as aI, PaginationMode as aJ, Paginator as aK, type PaymentMethod as aL, type Pin as aM, type PinPostResult as aN, type PinsResult as aO, PlatformResource as aP, type PluginContext as aQ, type Poll as aR, PollBuilder as aS, type PollInput as aT, type PollOption as aU, type PollTransportOptions as aV, type Portal as aW, type Post as aX, PostBuilder as aY, type PostInput as aZ, type PostStats as a_, ItdConflictError as aa, ItdError as ab, ItdErrorCode as ac, ItdErrorKind as ad, type ItdFieldErrors as ae, ItdForbiddenError as af, ItdNetworkError as ag, ItdNotFoundError as ah, ItdPhoneVerificationError as ai, type ItdPlugin as aj, ItdRateLimitError as ak, ItdRealtime as al, ItdServerError as am, ItdTimeoutError as an, ItdValidationError as ao, LIBRARY_VERSION as ap, type LikeResult as aq, LikesVisibility as ar, type Listener as as, LocalStorageTokenStorage as at, type Logger as au, type Loose as av, MAX_RECONNECT_ATTEMPTS as aw, MemoryTokenStorage as ax, type MyProfile as ay, NOTIFICATION_TYPE_ALIASES as az, type ItdClientOptions as b, WallAccess as b$, type PrivacySettings as b0, type Profile as b1, type PublicProfile as b2, RECONNECT_BACKOFF as b3, RECONNECT_JITTER as b4, REFRESH_COOKIE as b5, REFRESH_COOKIE_PATH as b6, type RateLimitOptions as b7, type RawRequestOptions as b8, type RealtimeEvents as b9, SpanType as bA, type SseTransportOptions as bB, type Subscription as bC, SubscriptionResource as bD, type SubscriptionState as bE, TURNSTILE_SITE_KEY as bF, TelemetryResource as bG, type Transformer as bH, type TransportContext as bI, type TransportEvent as bJ, UnauthorizedStreamError as bK, type Unsubscribe as bL, type UpdateNotificationSettingsInput as bM, type UpdatePrivacyInput as bN, type UpdateProfileInput as bO, type UploadOptions as bP, type UploadedFile as bQ, type UserId as bR, type UserListParams as bS, type UserPostsParams as bT, type UserRef as bU, type UserSummary as bV, UsersResource as bW, VIDEO_MIME_TYPES as bX, VerificationResource as bY, type VerificationStatus as bZ, type VideoMimeType as b_, type RealtimeOptions as ba, RealtimeStatus as bb, type RealtimeTransport as bc, RealtimeTransportKind as bd, type ReconnectOptions as be, type RepliesParams as bf, type Report as bg, ReportBuilder as bh, type ReportInput as bi, ReportReason as bj, ReportTargetType as bk, ReportsResource as bl, type RequestContext as bm, type RequestOptions as bn, type ResetPasswordInput as bo, type ResponseContext as bp, type RetryContext as bq, type RetryOptions as br, RuntimeMode as bs, STREAM_PATH as bt, SearchResource as bu, type SearchResult as bv, type Session as bw, type SignInResult as bx, SignInStatus as by, type Span as bz, AUDIO_MIME_TYPES as c, canonicalNotificationType as c0, comment as c1, createTokenStorage as c2, formatNotificationText as c3, isBuilder as c4, isItdApiError as c5, isItdAuthError as c6, isItdConflictError as c7, isItdError as c8, isItdForbiddenError as c9, isItdNotFoundError as ca, isItdPhoneVerificationError as cb, isItdRateLimitError as cc, isItdServerError as cd, isItdValidationError as ce, isKnownNotificationType as cf, isMyProfile as cg, normalizeNotification as ch, poll as ci, post as cj, readNotificationEvent as ck, readUnreadCountEvent as cl, report as cm, resolveNotificationUrl as cn, toDate as co, createClient as cp, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, type Actor as f, type AllowedMimeType as g, type Announcement as h, type AnnouncementButton as i, type Attachment as j, AttachmentType as k, type AudioMimeType as l, type AuthInput as m, AuthResource as n, type Author as o, type ChangelogEntry as p, type Clan as q, type ClientHooks as r, type Comment as s, CommentBuilder as t, type CommentInput as u, type CommentReplyTo as v, CommentSort as w, type CommentsParams as x, CommentsResource as y, type CreateCommentInput as z };