itd-api 0.0.6 → 0.0.7

package/dist/{chunk-K7NBFQEE.cjs → chunk-3RNNZJZ4.cjs}

@@ -616,14 +616,18 @@ var RealtimeStatus = Object.freeze({
   Error: "error",
   Disconnected: "disconnected"
 });
-var WallAccess = Object.freeze({
-  Everyone: "everyone"
-});
-var LikesVisibility = Object.freeze({
-  Everyone: "everyone",
+var AccessType = Object.freeze({
+  /** Никто. */
+  Nobody: "nobody",
   /** Только взаимные подписки. */
-  Mutual: "mutual"
+  Mutual: "mutual",
+  /** Подписчики. */
+  Followers: "followers",
+  /** Все. */
+  Everyone: "everyone"
 });
+var WallAccess = AccessType;
+var LikesVisibility = AccessType;
 var NotificationType = Object.freeze({
   /** Реакция на пост. Старое имя — `like`. */
   PostReaction: "post_reaction",
@@ -652,6 +656,36 @@ var NotificationType = Object.freeze({
   /** Верификация отклонена. Приходит только по REST. */
   VerificationRejected: "verification_rejected"
 });
+var InteractionType = Object.freeze({
+  /** Открытие фотографии. */
+  PhotoOpen: 1,
+  /** Прогресс просмотра видео. Несёт поля `pm`/`dm`. */
+  VideoProgress: 2
+});
+var ViewSource = Object.freeze({
+  FeedGlobal: 1,
+  FeedFollowing: 2,
+  FeedClan: 3,
+  Profile: 4,
+  Hashtag: 5,
+  PostPage: 6,
+  Link: 7,
+  Search: 8
+});
+var ViewReason = Object.freeze({
+  /** Пост ушёл из зоны видимости при обычной прокрутке. */
+  Normal: 0,
+  /** Потеря фокуса окна. */
+  Blur: 1,
+  /** Вкладка скрыта. */
+  Hidden: 2,
+  /** Уход со страницы (`pagehide`). */
+  PageHide: 3,
+  /** Элемент перестал наблюдаться. */
+  Unobserve: 4,
+  /** Достигнут порог времени просмотра. */
+  ThresholdMet: 5
+});
 var ItdErrorCode = Object.freeze({
   BAD_REQUEST: "BAD_REQUEST",
   UNAUTHORIZED: "UNAUTHORIZED",
@@ -1716,7 +1750,7 @@ function normalizeBaseUrl(baseUrl) {
 // src/core/config.ts
 var DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
 var DEFAULT_TIMEOUT = 3e4;
-var LIBRARY_VERSION = "0.0.6";
+var LIBRARY_VERSION = "0.0.7";
 var DEFAULT_USER_AGENT = `Mozilla/5.0 (compatible; itd-api/${LIBRARY_VERSION}; +https://github.com/KiowDev/itd-api)`;
 var DEFAULT_RATE_LIMIT_DELAYS = Object.freeze([1e3, 5e3, 3e4, 6e4, 9e4]);
 function requirePositive(value, name) {
@@ -4243,49 +4277,6 @@ var PlatformResource = class extends BaseResource {
     });
   }
 };
-var TelemetryResource = class extends BaseResource {
-  /**
-   * Отправляет время просмотра постов.
-   *
-   * @experimental Имена полей на проводе сжаты (`ai`, `v`, `s`), и их соответствие
-   * смыслу **не проверено** на реальных запросах. Может измениться без предупреждения.
-   */
-  dwell(entries, options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: "/api/v1/i",
-      body: {
-        items: entries.map((entry) => ({
-          ai: entry.postId,
-          v: entry.duration,
-          ...entry.vs ? { s: entry.vs } : {}
-        }))
-      },
-      ...this.requestOptions(options)
-    });
-  }
-  /**
-   * Отправляет события взаимодействия с контентом.
-   *
-   * @experimental См. предупреждение у {@link TelemetryResource}.
-   */
-  interaction(entries, options = {}) {
-    return this.http.request({
-      method: "POST",
-      path: "/api/v1/x",
-      body: {
-        items: entries.map((entry) => ({
-          t: entry.type,
-          ...entry.value !== void 0 ? { v: entry.value } : {},
-          ...entry.postId ? { ai: entry.postId } : {},
-          ...entry.attachmentId ? { mi: entry.attachmentId } : {},
-          ...entry.vs ? { s: entry.vs } : {}
-        }))
-      },
-      ...this.requestOptions(options)
-    });
-  }
-};
 
 // src/resources/notifications.ts
 var READ_BATCH_SIZE = 20;
@@ -4775,6 +4766,70 @@ var PostsResource = class extends BaseResource {
   }
 };
 
+// src/resources/telemetry.ts
+var TelemetryResource = class extends BaseResource {
+  /** Идентификатор сессии телеметрии, общий для всех событий этого объекта. */
+  #sessionId;
+  /**
+   * Идентификатор сессии телеметрии (`sid`).
+   *
+   * Создаётся лениво при первом обращении и далее неизменен.
+   */
+  get sessionId() {
+    this.#sessionId ??= createDeviceId();
+    return this.#sessionId;
+  }
+  /**
+   * Отправляет события просмотра постов (`POST /api/v1/i`).
+   *
+   * @experimental См. предупреждение у {@link TelemetryResource}.
+   */
+  dwell(entries, options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: "/api/v1/i",
+      body: {
+        sid: options.sid ?? this.sessionId,
+        e: entries.map((entry) => ({
+          md: entry.durationMs ?? entry.exitAt - entry.enterAt,
+          et: entry.enterAt,
+          xt: entry.exitAt,
+          r: entry.reason,
+          v: entry.vs,
+          ...entry.sourceContext !== void 0 ? { sc: entry.sourceContext } : {},
+          ...entry.source !== void 0 ? { s: entry.source } : {},
+          ...entry.repeat ? { b: 1 } : {}
+        }))
+      },
+      ...this.requestOptions(options)
+    });
+  }
+  /**
+   * Отправляет события взаимодействия с контентом (`POST /api/v1/x`).
+   *
+   * @experimental См. предупреждение у {@link TelemetryResource}.
+   */
+  interaction(entries, options = {}) {
+    return this.http.request({
+      method: "POST",
+      path: "/api/v1/x",
+      body: {
+        sid: options.sid ?? this.sessionId,
+        e: entries.map((entry) => ({
+          t: entry.type,
+          v: entry.vs,
+          ai: entry.postId,
+          ...entry.mediaIndex !== void 0 ? { mi: entry.mediaIndex } : {},
+          ...entry.source !== void 0 ? { s: entry.source } : {},
+          ...entry.positionMs !== void 0 ? { pm: Math.round(entry.positionMs) } : {},
+          ...entry.durationMs !== void 0 ? { dm: Math.round(entry.durationMs) } : {}
+        }))
+      },
+      ...this.requestOptions(options)
+    });
+  }
+};
+
 // src/resources/users.ts
 var UsersResource = class extends BaseResource {
   /** Загружает свой профиль — с подпиской и признаком подтверждённого телефона. */
@@ -5397,6 +5452,7 @@ exports.ALLOWED_MIME_TYPES = ALLOWED_MIME_TYPES;
 exports.AUDIO_MIME_TYPES = AUDIO_MIME_TYPES;
 exports.AUTH_FLAG_COOKIE = AUTH_FLAG_COOKIE;
 exports.AUTH_PATHS = AUTH_PATHS;
+exports.AccessType = AccessType;
 exports.AttachmentType = AttachmentType;
 exports.CommentSort = CommentSort;
 exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
@@ -5406,6 +5462,7 @@ exports.DEVICE_ID_HEADER = DEVICE_ID_HEADER;
 exports.DetectedRuntime = DetectedRuntime;
 exports.FeedTab = FeedTab;
 exports.IMAGE_MIME_TYPES = IMAGE_MIME_TYPES;
+exports.InteractionType = InteractionType;
 exports.ItdAbortError = ItdAbortError;
 exports.ItdApiError = ItdApiError;
 exports.ItdApiErrorKind = ItdApiErrorKind;
@@ -5450,6 +5507,8 @@ exports.SpanType = SpanType;
 exports.TURNSTILE_SITE_KEY = TURNSTILE_SITE_KEY;
 exports.UnauthorizedStreamError = UnauthorizedStreamError;
 exports.VIDEO_MIME_TYPES = VIDEO_MIME_TYPES;
+exports.ViewReason = ViewReason;
+exports.ViewSource = ViewSource;
 exports.WallAccess = WallAccess;
 exports.canonicalNotificationType = canonicalNotificationType;
 exports.comment = comment;
@@ -5477,5 +5536,5 @@ exports.readUnreadCountEvent = readUnreadCountEvent;
 exports.report = report;
 exports.resolveNotificationUrl = resolveNotificationUrl;
 exports.toDate = toDate;
-//# sourceMappingURL=chunk-K7NBFQEE.cjs.map
-//# sourceMappingURL=chunk-K7NBFQEE.cjs.map
+//# sourceMappingURL=chunk-3RNNZJZ4.cjs.map
+//# sourceMappingURL=chunk-3RNNZJZ4.cjs.map