itube-specs 0.0.776 → 0.0.777

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.776",
+  "version": "0.0.777",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {

package/runtime/utils/cleaners/clean-video-data.ts

@@ -1,4 +1,36 @@
-import type { IRawVideoData, IVideoData } from '../../../types';
+import type { IRawVideoData, IVideoData, ISceneGroup, ITimelineGroup } from '../../../types';
+
+// «locations» → «Locations», «living_room» → «Living room».
+const humanize = (value: string): string => {
+    const text = value.replace(/_/g, ' ').trim();
+    return text ? text.charAt(0).toUpperCase() + text.slice(1) : text;
+};
+
+// timelines_groups ({ name, actions:[{ duration?, title }] }) → sceneGroups ({ id, title, scenes:[{ start, title }] }).
+const cleanTimelineGroups = (raw: ITimelineGroup[] | null): ISceneGroup[] | null => {
+    if (!Array.isArray(raw)) return null;
+
+    const groups = raw
+        .filter((group) => Array.isArray(group?.actions) && group.actions.length > 0)
+        .map((group) => ({
+            id: group.name,
+            title: humanize(group.name),
+            scenes: group.actions.map((action) => ({
+                start: Number(action.duration) || 0,
+                title: humanize(action.title),
+            })),
+        }));
+
+    return groups.length ? groups : null;
+};
+
+// hotspots (string[]) → number[] (значения кривой популярности по корзинам).
+const cleanHotspots = (raw: string[] | null): number[] | null => {
+    if (!Array.isArray(raw)) return null;
+
+    const values = raw.map(Number).filter((value) => Number.isFinite(value));
+    return values.length ? values : null;
+};
 
 /** Нормализует сырые данные видео к типу IVideoData. */
 export const cleanVideoData = (data: IRawVideoData): IVideoData => ({
@@ -30,6 +62,6 @@ export const cleanVideoData = (data: IRawVideoData): IVideoData => ({
     thumbNum: data.thumb_number || 0,
     description: data.description || '',
     dislikes: data.dislikes || 0,
-    hotspots: data.hotspots || null,
-    timelinesGroups: data.timelines_groups || null,
+    hotspots: cleanHotspots(data.hotspots),
+    timelinesGroups: cleanTimelineGroups(data.timelines_groups),
 });

package/types/raw/raw-video-data.d.ts

@@ -1,4 +1,5 @@
 import type { IRawThumbUrls } from './raw-thumbs-urls';
+import type { ITimelineGroup } from '../video-data';
 
 export interface IRawVideoData {
     guid: string;
@@ -51,6 +52,6 @@ export interface IRawVideoData {
     reels_url: string;          // unused
     vtt_url: string;
     vtt_sprite_url: string;
-    hotspots: any,
-    timelines_groups: any
+    hotspots: string[],
+    timelines_groups: ITimelineGroup[] | null
 }

package/types/video-data.d.ts

@@ -5,6 +5,29 @@ export interface ITimestamp {
   title: string;
 }
 
+// Сырые группы таймлайна, как приходят с бека.
+export interface ITimelineGroupAction {
+  duration?: number;
+  title: string;
+}
+
+export interface ITimelineGroup {
+  name: string;
+  actions: ITimelineGroupAction[];
+}
+
+// Очищенная форма: id (сырое имя, для иконок), человекочитаемый title, сцены со start.
+export interface ISceneGroupScene {
+  start: number;
+  title: string;
+}
+
+export interface ISceneGroup {
+  id: string;
+  title: string;
+  scenes: ISceneGroupScene[];
+}
+
 export interface IVideoData {
     guid: string;
     md5: string;
@@ -38,6 +61,6 @@ export interface IVideoData {
     isDeleted: boolean;
     thumbNum: number;
     description: string;
-    hotspots: any,
-    timelinesGroups: any
+    hotspots: number[] | null,
+    timelinesGroups: ISceneGroup[] | null
 }