itd-api 0.0.6 → 0.0.7

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

@@ -156,22 +156,46 @@ declare const RealtimeStatus: Readonly<{
 }>;
 type RealtimeStatus = (typeof RealtimeStatus)[keyof typeof RealtimeStatus];
 /**
- * Кто может писать на стену профиля.
+ * Уровень доступа к разделу профиля.
  *
- * Документация перечисляет значения не полностью, поэтому тип открытый: объект ниже —
- * справочник известных значений, но сервер может прислать и другое.
+ * Общий набор значений для полей `wallAccess` и `likesVisibility` настроек приватности.
+ * Тип открытый: сервер может прислать значение вне этого перечня.
  */
+declare const AccessType: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
+}>;
+type AccessType = Loose<(typeof AccessType)[keyof typeof AccessType]>;
+/** Кто может писать на стену профиля. Псевдоним {@link AccessType}. */
 declare const WallAccess: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
     readonly Everyone: "everyone";
 }>;
-type WallAccess = Loose<(typeof WallAccess)[keyof typeof WallAccess]>;
-/** Кто видит реакции пользователя. Список в документации неполный. */
+type WallAccess = AccessType;
+/** Кто видит реакции пользователя. Псевдоним {@link AccessType}. */
 declare const LikesVisibility: Readonly<{
-    readonly Everyone: "everyone";
+    /** Никто. */
+    readonly Nobody: "nobody";
     /** Только взаимные подписки. */
     readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
 }>;
-type LikesVisibility = Loose<(typeof LikesVisibility)[keyof typeof LikesVisibility]>;
+type LikesVisibility = AccessType;
 /**
  * Канонический тип уведомления (новое поколение имён).
  *
@@ -208,6 +232,55 @@ declare const NotificationType: Readonly<{
     readonly VerificationRejected: "verification_rejected";
 }>;
 type NotificationType = Loose<(typeof NotificationType)[keyof typeof NotificationType]>;
+/**
+ * Тип взаимодействия с контентом в телеметрии (`POST /api/v1/x`, поле `t`).
+ *
+ * Кодируется числом.
+ */
+declare const InteractionType: Readonly<{
+    /** Открытие фотографии. */
+    readonly PhotoOpen: 1;
+    /** Прогресс просмотра видео. Несёт поля `pm`/`dm`. */
+    readonly VideoProgress: 2;
+}>;
+type InteractionType = (typeof InteractionType)[keyof typeof InteractionType];
+/**
+ * Источник показа поста в телеметрии (поле `s`).
+ *
+ * Кодируется числом. Поле применимо к источникам `PostPage` и `Link`; для лент источник
+ * передаётся контекстом `sc`.
+ */
+declare const ViewSource: Readonly<{
+    readonly FeedGlobal: 1;
+    readonly FeedFollowing: 2;
+    readonly FeedClan: 3;
+    readonly Profile: 4;
+    readonly Hashtag: 5;
+    readonly PostPage: 6;
+    readonly Link: 7;
+    readonly Search: 8;
+}>;
+type ViewSource = (typeof ViewSource)[keyof typeof ViewSource];
+/**
+ * Причина завершения просмотра поста в телеметрии (`POST /api/v1/i`, поле `r`).
+ *
+ * Кодируется числом.
+ */
+declare const ViewReason: Readonly<{
+    /** Пост ушёл из зоны видимости при обычной прокрутке. */
+    readonly Normal: 0;
+    /** Потеря фокуса окна. */
+    readonly Blur: 1;
+    /** Вкладка скрыта. */
+    readonly Hidden: 2;
+    /** Уход со страницы (`pagehide`). */
+    readonly PageHide: 3;
+    /** Элемент перестал наблюдаться. */
+    readonly Unobserve: 4;
+    /** Достигнут порог времени просмотра. */
+    readonly ThresholdMet: 5;
+}>;
+type ViewReason = (typeof ViewReason)[keyof typeof ViewReason];
 /**
  * Строковые коды ошибок из поля `code`.
  *
@@ -1474,7 +1547,7 @@ declare const DEFAULT_TIMEOUT = 30000;
 /**
  * Версия библиотеки — попадает в `User-Agent`.
  */
-declare const LIBRARY_VERSION = "0.0.6";
+declare const LIBRARY_VERSION = "0.0.7";
 /**
  * `User-Agent` по умолчанию.
  *
@@ -1485,7 +1558,7 @@ declare const LIBRARY_VERSION = "0.0.6";
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.6; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.7; +https://github.com/KiowDev/itd-api)";
 /**
  * Настройки повторов со всеми значениями по умолчанию.
  *
@@ -2833,54 +2906,6 @@ declare class PlatformResource extends BaseResource {
     /** Загружает баннер текущего события — виджет «портал». */
     portal(options?: RequestOptions): Promise<Portal>;
 }
-/** Запись о времени просмотра поста. */
-interface DwellEntry {
-    /** Идентификатор поста. */
-    postId: string;
-    /** Сколько миллисекунд пост был виден. */
-    duration: number;
-    /** Служебная метка показа из поля `vs` объекта поста. */
-    vs?: string;
-}
-/** Запись о взаимодействии с контентом. */
-interface InteractionEntry {
-    /** Тип взаимодействия: `photo_open`, `video_progress` и подобные. */
-    type: string;
-    /** Значение, смысл которого зависит от типа: доля просмотра, номер кадра. */
-    value?: number;
-    /** Идентификатор поста. */
-    postId?: string;
-    /** Идентификатор вложения. */
-    attachmentId?: string;
-    /** Служебная метка показа. */
-    vs?: string;
-}
-/**
- * Телеметрия просмотров.
- *
- * @experimental Эндпоинты `/api/v1/i` и `/api/v1/x` нигде не описаны, а схема их полей
- * не проверена на реальных запросах и может измениться без предупреждения.
- *
- * **Библиотека никогда не отправляет телеметрию сама.** Эти методы нужны только тем,
- * кто пишет собственный клиент платформы; всем остальным их вызывать не требуется.
- *
- * Доступна как `itd.telemetry`.
- */
-declare class TelemetryResource extends BaseResource {
-    /**
-     * Отправляет время просмотра постов.
-     *
-     * @experimental Имена полей на проводе сжаты (`ai`, `v`, `s`), и их соответствие
-     * смыслу **не проверено** на реальных запросах. Может измениться без предупреждения.
-     */
-    dwell(entries: DwellEntry[], options?: RequestOptions): Promise<unknown>;
-    /**
-     * Отправляет события взаимодействия с контентом.
-     *
-     * @experimental См. предупреждение у {@link TelemetryResource}.
-     */
-    interaction(entries: InteractionEntry[], options?: RequestOptions): Promise<unknown>;
-}
 
 /** Параметры запроса списка уведомлений. */
 interface NotificationListParams extends RequestOptions {
@@ -3121,6 +3146,96 @@ declare class PostsResource extends BaseResource {
     voiceComment(postId: string, audio: FileInput, options?: RequestOptions): Promise<Comment>;
 }
 
+/**
+ * Общие опции запроса телеметрии.
+ *
+ * Помимо {@link RequestOptions} позволяет задать `sid` — идентификатор сессии телеметрии.
+ * По умолчанию он заводится один на объект {@link TelemetryResource}.
+ */
+interface TelemetryOptions extends RequestOptions {
+    /** Переопределяет идентификатор сессии телеметрии (`sid`) для этого запроса. */
+    sid?: string;
+}
+/**
+ * Событие просмотра поста для {@link TelemetryResource.dwell}.
+ *
+ * Пост определяется меткой показа `vs` и, при наличии, контекстом источника `sc`; поля
+ * `postId` эндпоинт `/api/v1/i` не принимает.
+ */
+interface DwellEntry {
+    /** Метка показа — поле `vs` объекта поста. Уходит в поле `v`. */
+    vs: string;
+    /** Время появления поста в зоне видимости, epoch-мс. Поле `et`. */
+    enterAt: number;
+    /** Время ухода из зоны видимости, epoch-мс. Поле `xt`. */
+    exitAt: number;
+    /** Причина завершения просмотра. Поле `r`. */
+    reason: ViewReason;
+    /**
+     * Длительность просмотра в мс. Поле `md`.
+     *
+     * Если не задано, вычисляется как `exitAt − enterAt`.
+     */
+    durationMs?: number;
+    /** Контекст источника показа. Поле `sc`. */
+    sourceContext?: string;
+    /** Источник показа. Применим к `PostPage`/`Link`. Поле `s`. */
+    source?: ViewSource;
+    /** Повторный просмотр: пост уже встречался в этой сессии. Уходит как `b: 1`. */
+    repeat?: boolean;
+}
+/** Событие взаимодействия с контентом для {@link TelemetryResource.interaction}. */
+interface InteractionEntry {
+    /** Тип взаимодействия. Поле `t`. */
+    type: InteractionType;
+    /** Метка показа — поле `vs` объекта поста. Поле `v`. */
+    vs: string;
+    /** Идентификатор поста. Поле `ai`. */
+    postId: string;
+    /** Индекс вложения (с нуля) — для {@link InteractionType.PhotoOpen}. Поле `mi`. */
+    mediaIndex?: number;
+    /** Источник показа. Поле `s`. */
+    source?: ViewSource;
+    /** Просмотрено мс — для {@link InteractionType.VideoProgress}. Поле `pm`. */
+    positionMs?: number;
+    /** Длительность видео в мс — для {@link InteractionType.VideoProgress}. Поле `dm`. */
+    durationMs?: number;
+}
+/**
+ * Телеметрия просмотров.
+ *
+ * @experimental Недокументированные эндпоинты `/api/v1/i` (просмотры) и `/api/v1/x`
+ * (взаимодействия); формат полей может измениться без предупреждения.
+ *
+ * Методы не вызываются автоматически — телеметрия отправляется только явным вызовом.
+ *
+ * Оба эндпоинта принимают конверт `{ sid, e }`, где `sid` — идентификатор сессии
+ * телеметрии: по умолчанию один на объект, переопределяется опцией `sid`.
+ *
+ * Доступна как `itd.telemetry`.
+ */
+declare class TelemetryResource extends BaseResource {
+    #private;
+    /**
+     * Идентификатор сессии телеметрии (`sid`).
+     *
+     * Создаётся лениво при первом обращении и далее неизменен.
+     */
+    get sessionId(): string;
+    /**
+     * Отправляет события просмотра постов (`POST /api/v1/i`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    dwell(entries: DwellEntry[], options?: TelemetryOptions): Promise<unknown>;
+    /**
+     * Отправляет события взаимодействия с контентом (`POST /api/v1/x`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    interaction(entries: InteractionEntry[], options?: TelemetryOptions): Promise<unknown>;
+}
+
 /**
  * Параметры списков пользователей.
  *
@@ -3782,4 +3897,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, 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 };
+export { HashtagsResource as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreateCommentInput as D, type CreatePollInput as E, type FileReader as F, type CreatePostInput as G, type CreateReportInput as H, type ItdSession as I, type Credentials as J, type CredentialsAuth as K, DEFAULT_BASE_URL as L, DEFAULT_TIMEOUT as M, DEFAULT_USER_AGENT as N, DEVICE_ID_HEADER as O, DetectedRuntime as P, type DwellEntry as Q, type ErrorContextHook as R, type FeedParams as S, type TokenStorage as T, FeedTab as U, type FileInput as V, FilesResource as W, type FollowResult as X, type ForgotPasswordInput as Y, type Hashtag as Z, type HashtagPostsParams as _, ItdClient as a, type PostInput as a$, IMAGE_MIME_TYPES as a0, type ImageMimeType as a1, type InteractionEntry as a2, InteractionType as a3, type IsoDate as a4, ItdAbortError as a5, ItdApiError as a6, type ItdApiErrorInit as a7, ItdApiErrorKind as a8, ItdAuthError as a9, type MyProfile as aA, NOTIFICATION_TYPE_ALIASES as aB, type Notification as aC, type NotificationEvent as aD, type NotificationListParams as aE, type NotificationSettings as aF, NotificationType as aG, NotificationsResource as aH, OAuthProvider as aI, type Page as aJ, type PageState as aK, PaginationMode as aL, Paginator as aM, type PaymentMethod as aN, type Pin as aO, type PinPostResult as aP, type PinsResult as aQ, PlatformResource as aR, type PluginContext as aS, type Poll as aT, PollBuilder as aU, type PollInput as aV, type PollOption as aW, type PollTransportOptions as aX, type Portal as aY, type Post as aZ, PostBuilder as a_, type ItdBuilder as aa, ItdConfigError as ab, ItdConflictError as ac, ItdError as ad, ItdErrorCode as ae, ItdErrorKind as af, type ItdFieldErrors as ag, ItdForbiddenError as ah, ItdNetworkError as ai, ItdNotFoundError as aj, ItdPhoneVerificationError as ak, type ItdPlugin as al, ItdRateLimitError as am, ItdRealtime as an, ItdServerError as ao, ItdTimeoutError as ap, ItdValidationError as aq, LIBRARY_VERSION as ar, type LikeResult as as, LikesVisibility as at, type Listener as au, LocalStorageTokenStorage as av, type Logger as aw, type Loose as ax, MAX_RECONNECT_ATTEMPTS as ay, MemoryTokenStorage as az, type ItdClientOptions as b, VerificationResource as b$, type PostStats as b0, PostsResource as b1, type PrivacySettings as b2, type Profile as b3, type PublicProfile as b4, RECONNECT_BACKOFF as b5, RECONNECT_JITTER as b6, REFRESH_COOKIE as b7, REFRESH_COOKIE_PATH as b8, type RateLimitOptions as b9, SignInStatus as bA, type Span as bB, SpanType as bC, type SseTransportOptions as bD, type Subscription as bE, SubscriptionResource as bF, type SubscriptionState as bG, TURNSTILE_SITE_KEY as bH, type TelemetryOptions as bI, TelemetryResource as bJ, type Transformer as bK, type TransportContext as bL, type TransportEvent as bM, UnauthorizedStreamError as bN, type Unsubscribe as bO, type UpdateNotificationSettingsInput as bP, type UpdatePrivacyInput as bQ, type UpdateProfileInput as bR, type UploadOptions as bS, type UploadedFile as bT, type UserId as bU, type UserListParams as bV, type UserPostsParams as bW, type UserRef as bX, type UserSummary as bY, UsersResource as bZ, VIDEO_MIME_TYPES as b_, type RawRequestOptions as ba, type RealtimeEvents as bb, type RealtimeOptions as bc, RealtimeStatus as bd, type RealtimeTransport as be, RealtimeTransportKind as bf, type ReconnectOptions as bg, type RepliesParams as bh, type Report as bi, ReportBuilder as bj, type ReportInput as bk, ReportReason as bl, ReportTargetType as bm, ReportsResource as bn, type RequestContext as bo, type RequestOptions as bp, type ResetPasswordInput as bq, type ResponseContext as br, type RetryContext as bs, type RetryOptions as bt, RuntimeMode as bu, STREAM_PATH as bv, SearchResource as bw, type SearchResult as bx, type Session as by, type SignInResult as bz, AUDIO_MIME_TYPES as c, type VerificationStatus as c0, type VideoMimeType as c1, ViewReason as c2, ViewSource as c3, WallAccess as c4, canonicalNotificationType as c5, comment as c6, createTokenStorage as c7, formatNotificationText as c8, isBuilder as c9, isItdApiError as ca, isItdAuthError as cb, isItdConflictError as cc, isItdError as cd, isItdForbiddenError as ce, isItdNotFoundError as cf, isItdPhoneVerificationError as cg, isItdRateLimitError as ch, isItdServerError as ci, isItdValidationError as cj, isKnownNotificationType as ck, isMyProfile as cl, normalizeNotification as cm, poll as cn, post as co, readNotificationEvent as cp, readUnreadCountEvent as cq, report as cr, resolveNotificationUrl as cs, toDate as ct, createClient as cu, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, AccessType as f, type Actor as g, type AllowedMimeType as h, type Announcement as i, type AnnouncementButton as j, type Attachment as k, AttachmentType as l, type AudioMimeType as m, type AuthInput as n, AuthResource as o, type Author as p, type ChangelogEntry as q, type Clan as r, type ClientHooks as s, type Comment as t, CommentBuilder as u, type CommentInput as v, type CommentReplyTo as w, CommentSort as x, type CommentsParams as y, CommentsResource as z };

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

@@ -156,22 +156,46 @@ declare const RealtimeStatus: Readonly<{
 }>;
 type RealtimeStatus = (typeof RealtimeStatus)[keyof typeof RealtimeStatus];
 /**
- * Кто может писать на стену профиля.
+ * Уровень доступа к разделу профиля.
  *
- * Документация перечисляет значения не полностью, поэтому тип открытый: объект ниже —
- * справочник известных значений, но сервер может прислать и другое.
+ * Общий набор значений для полей `wallAccess` и `likesVisibility` настроек приватности.
+ * Тип открытый: сервер может прислать значение вне этого перечня.
  */
+declare const AccessType: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
+}>;
+type AccessType = Loose<(typeof AccessType)[keyof typeof AccessType]>;
+/** Кто может писать на стену профиля. Псевдоним {@link AccessType}. */
 declare const WallAccess: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
     readonly Everyone: "everyone";
 }>;
-type WallAccess = Loose<(typeof WallAccess)[keyof typeof WallAccess]>;
-/** Кто видит реакции пользователя. Список в документации неполный. */
+type WallAccess = AccessType;
+/** Кто видит реакции пользователя. Псевдоним {@link AccessType}. */
 declare const LikesVisibility: Readonly<{
-    readonly Everyone: "everyone";
+    /** Никто. */
+    readonly Nobody: "nobody";
     /** Только взаимные подписки. */
     readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
 }>;
-type LikesVisibility = Loose<(typeof LikesVisibility)[keyof typeof LikesVisibility]>;
+type LikesVisibility = AccessType;
 /**
  * Канонический тип уведомления (новое поколение имён).
  *
@@ -208,6 +232,55 @@ declare const NotificationType: Readonly<{
     readonly VerificationRejected: "verification_rejected";
 }>;
 type NotificationType = Loose<(typeof NotificationType)[keyof typeof NotificationType]>;
+/**
+ * Тип взаимодействия с контентом в телеметрии (`POST /api/v1/x`, поле `t`).
+ *
+ * Кодируется числом.
+ */
+declare const InteractionType: Readonly<{
+    /** Открытие фотографии. */
+    readonly PhotoOpen: 1;
+    /** Прогресс просмотра видео. Несёт поля `pm`/`dm`. */
+    readonly VideoProgress: 2;
+}>;
+type InteractionType = (typeof InteractionType)[keyof typeof InteractionType];
+/**
+ * Источник показа поста в телеметрии (поле `s`).
+ *
+ * Кодируется числом. Поле применимо к источникам `PostPage` и `Link`; для лент источник
+ * передаётся контекстом `sc`.
+ */
+declare const ViewSource: Readonly<{
+    readonly FeedGlobal: 1;
+    readonly FeedFollowing: 2;
+    readonly FeedClan: 3;
+    readonly Profile: 4;
+    readonly Hashtag: 5;
+    readonly PostPage: 6;
+    readonly Link: 7;
+    readonly Search: 8;
+}>;
+type ViewSource = (typeof ViewSource)[keyof typeof ViewSource];
+/**
+ * Причина завершения просмотра поста в телеметрии (`POST /api/v1/i`, поле `r`).
+ *
+ * Кодируется числом.
+ */
+declare const ViewReason: Readonly<{
+    /** Пост ушёл из зоны видимости при обычной прокрутке. */
+    readonly Normal: 0;
+    /** Потеря фокуса окна. */
+    readonly Blur: 1;
+    /** Вкладка скрыта. */
+    readonly Hidden: 2;
+    /** Уход со страницы (`pagehide`). */
+    readonly PageHide: 3;
+    /** Элемент перестал наблюдаться. */
+    readonly Unobserve: 4;
+    /** Достигнут порог времени просмотра. */
+    readonly ThresholdMet: 5;
+}>;
+type ViewReason = (typeof ViewReason)[keyof typeof ViewReason];
 /**
  * Строковые коды ошибок из поля `code`.
  *
@@ -1474,7 +1547,7 @@ declare const DEFAULT_TIMEOUT = 30000;
 /**
  * Версия библиотеки — попадает в `User-Agent`.
  */
-declare const LIBRARY_VERSION = "0.0.6";
+declare const LIBRARY_VERSION = "0.0.7";
 /**
  * `User-Agent` по умолчанию.
  *
@@ -1485,7 +1558,7 @@ declare const LIBRARY_VERSION = "0.0.6";
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.6; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.7; +https://github.com/KiowDev/itd-api)";
 /**
  * Настройки повторов со всеми значениями по умолчанию.
  *
@@ -2833,54 +2906,6 @@ declare class PlatformResource extends BaseResource {
     /** Загружает баннер текущего события — виджет «портал». */
     portal(options?: RequestOptions): Promise<Portal>;
 }
-/** Запись о времени просмотра поста. */
-interface DwellEntry {
-    /** Идентификатор поста. */
-    postId: string;
-    /** Сколько миллисекунд пост был виден. */
-    duration: number;
-    /** Служебная метка показа из поля `vs` объекта поста. */
-    vs?: string;
-}
-/** Запись о взаимодействии с контентом. */
-interface InteractionEntry {
-    /** Тип взаимодействия: `photo_open`, `video_progress` и подобные. */
-    type: string;
-    /** Значение, смысл которого зависит от типа: доля просмотра, номер кадра. */
-    value?: number;
-    /** Идентификатор поста. */
-    postId?: string;
-    /** Идентификатор вложения. */
-    attachmentId?: string;
-    /** Служебная метка показа. */
-    vs?: string;
-}
-/**
- * Телеметрия просмотров.
- *
- * @experimental Эндпоинты `/api/v1/i` и `/api/v1/x` нигде не описаны, а схема их полей
- * не проверена на реальных запросах и может измениться без предупреждения.
- *
- * **Библиотека никогда не отправляет телеметрию сама.** Эти методы нужны только тем,
- * кто пишет собственный клиент платформы; всем остальным их вызывать не требуется.
- *
- * Доступна как `itd.telemetry`.
- */
-declare class TelemetryResource extends BaseResource {
-    /**
-     * Отправляет время просмотра постов.
-     *
-     * @experimental Имена полей на проводе сжаты (`ai`, `v`, `s`), и их соответствие
-     * смыслу **не проверено** на реальных запросах. Может измениться без предупреждения.
-     */
-    dwell(entries: DwellEntry[], options?: RequestOptions): Promise<unknown>;
-    /**
-     * Отправляет события взаимодействия с контентом.
-     *
-     * @experimental См. предупреждение у {@link TelemetryResource}.
-     */
-    interaction(entries: InteractionEntry[], options?: RequestOptions): Promise<unknown>;
-}
 
 /** Параметры запроса списка уведомлений. */
 interface NotificationListParams extends RequestOptions {
@@ -3121,6 +3146,96 @@ declare class PostsResource extends BaseResource {
     voiceComment(postId: string, audio: FileInput, options?: RequestOptions): Promise<Comment>;
 }
 
+/**
+ * Общие опции запроса телеметрии.
+ *
+ * Помимо {@link RequestOptions} позволяет задать `sid` — идентификатор сессии телеметрии.
+ * По умолчанию он заводится один на объект {@link TelemetryResource}.
+ */
+interface TelemetryOptions extends RequestOptions {
+    /** Переопределяет идентификатор сессии телеметрии (`sid`) для этого запроса. */
+    sid?: string;
+}
+/**
+ * Событие просмотра поста для {@link TelemetryResource.dwell}.
+ *
+ * Пост определяется меткой показа `vs` и, при наличии, контекстом источника `sc`; поля
+ * `postId` эндпоинт `/api/v1/i` не принимает.
+ */
+interface DwellEntry {
+    /** Метка показа — поле `vs` объекта поста. Уходит в поле `v`. */
+    vs: string;
+    /** Время появления поста в зоне видимости, epoch-мс. Поле `et`. */
+    enterAt: number;
+    /** Время ухода из зоны видимости, epoch-мс. Поле `xt`. */
+    exitAt: number;
+    /** Причина завершения просмотра. Поле `r`. */
+    reason: ViewReason;
+    /**
+     * Длительность просмотра в мс. Поле `md`.
+     *
+     * Если не задано, вычисляется как `exitAt − enterAt`.
+     */
+    durationMs?: number;
+    /** Контекст источника показа. Поле `sc`. */
+    sourceContext?: string;
+    /** Источник показа. Применим к `PostPage`/`Link`. Поле `s`. */
+    source?: ViewSource;
+    /** Повторный просмотр: пост уже встречался в этой сессии. Уходит как `b: 1`. */
+    repeat?: boolean;
+}
+/** Событие взаимодействия с контентом для {@link TelemetryResource.interaction}. */
+interface InteractionEntry {
+    /** Тип взаимодействия. Поле `t`. */
+    type: InteractionType;
+    /** Метка показа — поле `vs` объекта поста. Поле `v`. */
+    vs: string;
+    /** Идентификатор поста. Поле `ai`. */
+    postId: string;
+    /** Индекс вложения (с нуля) — для {@link InteractionType.PhotoOpen}. Поле `mi`. */
+    mediaIndex?: number;
+    /** Источник показа. Поле `s`. */
+    source?: ViewSource;
+    /** Просмотрено мс — для {@link InteractionType.VideoProgress}. Поле `pm`. */
+    positionMs?: number;
+    /** Длительность видео в мс — для {@link InteractionType.VideoProgress}. Поле `dm`. */
+    durationMs?: number;
+}
+/**
+ * Телеметрия просмотров.
+ *
+ * @experimental Недокументированные эндпоинты `/api/v1/i` (просмотры) и `/api/v1/x`
+ * (взаимодействия); формат полей может измениться без предупреждения.
+ *
+ * Методы не вызываются автоматически — телеметрия отправляется только явным вызовом.
+ *
+ * Оба эндпоинта принимают конверт `{ sid, e }`, где `sid` — идентификатор сессии
+ * телеметрии: по умолчанию один на объект, переопределяется опцией `sid`.
+ *
+ * Доступна как `itd.telemetry`.
+ */
+declare class TelemetryResource extends BaseResource {
+    #private;
+    /**
+     * Идентификатор сессии телеметрии (`sid`).
+     *
+     * Создаётся лениво при первом обращении и далее неизменен.
+     */
+    get sessionId(): string;
+    /**
+     * Отправляет события просмотра постов (`POST /api/v1/i`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    dwell(entries: DwellEntry[], options?: TelemetryOptions): Promise<unknown>;
+    /**
+     * Отправляет события взаимодействия с контентом (`POST /api/v1/x`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    interaction(entries: InteractionEntry[], options?: TelemetryOptions): Promise<unknown>;
+}
+
 /**
  * Параметры списков пользователей.
  *
@@ -3782,4 +3897,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, 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 };
+export { HashtagsResource as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreateCommentInput as D, type CreatePollInput as E, type FileReader as F, type CreatePostInput as G, type CreateReportInput as H, type ItdSession as I, type Credentials as J, type CredentialsAuth as K, DEFAULT_BASE_URL as L, DEFAULT_TIMEOUT as M, DEFAULT_USER_AGENT as N, DEVICE_ID_HEADER as O, DetectedRuntime as P, type DwellEntry as Q, type ErrorContextHook as R, type FeedParams as S, type TokenStorage as T, FeedTab as U, type FileInput as V, FilesResource as W, type FollowResult as X, type ForgotPasswordInput as Y, type Hashtag as Z, type HashtagPostsParams as _, ItdClient as a, type PostInput as a$, IMAGE_MIME_TYPES as a0, type ImageMimeType as a1, type InteractionEntry as a2, InteractionType as a3, type IsoDate as a4, ItdAbortError as a5, ItdApiError as a6, type ItdApiErrorInit as a7, ItdApiErrorKind as a8, ItdAuthError as a9, type MyProfile as aA, NOTIFICATION_TYPE_ALIASES as aB, type Notification as aC, type NotificationEvent as aD, type NotificationListParams as aE, type NotificationSettings as aF, NotificationType as aG, NotificationsResource as aH, OAuthProvider as aI, type Page as aJ, type PageState as aK, PaginationMode as aL, Paginator as aM, type PaymentMethod as aN, type Pin as aO, type PinPostResult as aP, type PinsResult as aQ, PlatformResource as aR, type PluginContext as aS, type Poll as aT, PollBuilder as aU, type PollInput as aV, type PollOption as aW, type PollTransportOptions as aX, type Portal as aY, type Post as aZ, PostBuilder as a_, type ItdBuilder as aa, ItdConfigError as ab, ItdConflictError as ac, ItdError as ad, ItdErrorCode as ae, ItdErrorKind as af, type ItdFieldErrors as ag, ItdForbiddenError as ah, ItdNetworkError as ai, ItdNotFoundError as aj, ItdPhoneVerificationError as ak, type ItdPlugin as al, ItdRateLimitError as am, ItdRealtime as an, ItdServerError as ao, ItdTimeoutError as ap, ItdValidationError as aq, LIBRARY_VERSION as ar, type LikeResult as as, LikesVisibility as at, type Listener as au, LocalStorageTokenStorage as av, type Logger as aw, type Loose as ax, MAX_RECONNECT_ATTEMPTS as ay, MemoryTokenStorage as az, type ItdClientOptions as b, VerificationResource as b$, type PostStats as b0, PostsResource as b1, type PrivacySettings as b2, type Profile as b3, type PublicProfile as b4, RECONNECT_BACKOFF as b5, RECONNECT_JITTER as b6, REFRESH_COOKIE as b7, REFRESH_COOKIE_PATH as b8, type RateLimitOptions as b9, SignInStatus as bA, type Span as bB, SpanType as bC, type SseTransportOptions as bD, type Subscription as bE, SubscriptionResource as bF, type SubscriptionState as bG, TURNSTILE_SITE_KEY as bH, type TelemetryOptions as bI, TelemetryResource as bJ, type Transformer as bK, type TransportContext as bL, type TransportEvent as bM, UnauthorizedStreamError as bN, type Unsubscribe as bO, type UpdateNotificationSettingsInput as bP, type UpdatePrivacyInput as bQ, type UpdateProfileInput as bR, type UploadOptions as bS, type UploadedFile as bT, type UserId as bU, type UserListParams as bV, type UserPostsParams as bW, type UserRef as bX, type UserSummary as bY, UsersResource as bZ, VIDEO_MIME_TYPES as b_, type RawRequestOptions as ba, type RealtimeEvents as bb, type RealtimeOptions as bc, RealtimeStatus as bd, type RealtimeTransport as be, RealtimeTransportKind as bf, type ReconnectOptions as bg, type RepliesParams as bh, type Report as bi, ReportBuilder as bj, type ReportInput as bk, ReportReason as bl, ReportTargetType as bm, ReportsResource as bn, type RequestContext as bo, type RequestOptions as bp, type ResetPasswordInput as bq, type ResponseContext as br, type RetryContext as bs, type RetryOptions as bt, RuntimeMode as bu, STREAM_PATH as bv, SearchResource as bw, type SearchResult as bx, type Session as by, type SignInResult as bz, AUDIO_MIME_TYPES as c, type VerificationStatus as c0, type VideoMimeType as c1, ViewReason as c2, ViewSource as c3, WallAccess as c4, canonicalNotificationType as c5, comment as c6, createTokenStorage as c7, formatNotificationText as c8, isBuilder as c9, isItdApiError as ca, isItdAuthError as cb, isItdConflictError as cc, isItdError as cd, isItdForbiddenError as ce, isItdNotFoundError as cf, isItdPhoneVerificationError as cg, isItdRateLimitError as ch, isItdServerError as ci, isItdValidationError as cj, isKnownNotificationType as ck, isMyProfile as cl, normalizeNotification as cm, poll as cn, post as co, readNotificationEvent as cp, readUnreadCountEvent as cq, report as cr, resolveNotificationUrl as cs, toDate as ct, createClient as cu, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, AccessType as f, type Actor as g, type AllowedMimeType as h, type Announcement as i, type AnnouncementButton as j, type Attachment as k, AttachmentType as l, type AudioMimeType as m, type AuthInput as n, AuthResource as o, type Author as p, type ChangelogEntry as q, type Clan as r, type ClientHooks as s, type Comment as t, CommentBuilder as u, type CommentInput as v, type CommentReplyTo as w, CommentSort as x, type CommentsParams as y, CommentsResource as z };