itube-specs 0.0.1059 → 0.0.1060

package/SITE_UPDATES.md

@@ -11,6 +11,18 @@
 коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
 кому именно (всем / сайтам с N), что будет, если не сделать.
 
+## 0.0.1060 — 2026-11-02
+
+- **Сайтам со своими `assets/scss/vars` (hdsex-remaster и др.), срочно:** с 0.0.1059 (лоадер, `0d412182`) без новых
+  токенов сборка падает на `Undefined variable`. В `_vars.scss`: `$blur-loading: 4px;` и
+  `$blur-loading-spill: $blur-loading * 3;`. В теме: `$loading-bg` (тёмная — `transparent`, светлая —
+  `$color-white-75`) и `$video-preview-loading-bg: transparent;`. Образец — hdsex-remaster.
+
+- **Всем — к сведению:** в строке чипсов над плеером — только топ-категории ролика (`categories[].isTop`, ставит BFF
+  видео по закешированному `/v1/categories/top`, к бекенду — раз в 10 минут на домен/язык/нишу). Нетоповые остаются в
+  блоке под описанием и не возвращаются в строку тегом. Топ-список не пришёл — как раньше, все категории. Делать ничего
+  не надо.
+
 ## 0.0.1059 — 2026-10-30
 
 - **Всем, срочно к сведению:** с 0.0.1056 блок Live Cams и врезки вебкамов пропали из сеток видео на страницах, которые

package/components/view/video.vue

@@ -234,6 +234,11 @@ const categoriesChips = computed((): IChipsItem[] => props.data.categories && pr
   prefix: 'categories',
 })));
 
+// Над плеером — только топ-категории (`isTop` ставит BFF); без пометки (топ-список не пришёл) — все.
+// Теги, совпавшие с нетоповой категорией, всё равно отсекаются по полному списку ниже.
+const topCategoriesChips = computed((): IChipsItem[] => (categoriesChips.value ?? [])
+  .filter((_, index) => props.data.categories[index]?.isTop !== false));
+
 const categoriesTitles = computed<string[]>(() => props.data.categories && props.data.categories?.map(item => item.title?.replace(/\s+/g, '').toLowerCase() ?? ''));
 
 const withoutCategoryTitles = (chips: IChipsItem[]) => (categoriesTitles.value?.length
@@ -258,9 +263,9 @@ const topChips = computed(() => {
       prefix: 'search',
     } as IChipsItem));
   } else if (tagGroupChips.value.length) {
-    return [...categoriesChips.value || [], ...withoutCategoryTitles(tagGroupChips.value)];
+    return [...topCategoriesChips.value, ...withoutCategoryTitles(tagGroupChips.value)];
   } else if (categoriesChips.value || filterTagChips.value) {
-    return [...categoriesChips.value || [], ...filterTagChips.value || []];
+    return [...topCategoriesChips.value, ...filterTagChips.value || []];
   }
   return null;
 });

package/package.json

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

package/runtime/index.ts

@@ -46,6 +46,7 @@ export * from './utils/cleaners/clean-video-card';
 export * from './utils/cleaners/clean-model-info';
 export * from './utils/cleaners/clean-suggest-models';
 export * from './utils/video-data-add-model-portraits';
+export * from './utils/video-data-mark-top-categories';
 export * from './utils/converters/convert-categories-to-footer';
 export * from './utils/converters/convert-categories-to-chips';
 export * from './utils/converters/convert-tag-group-item-to-chips';

package/runtime/utils/__tests__/video-data-mark-top-categories.test.ts

@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest';
+import type { IRawVideoData } from '../../../types';
+import { videoDataMarkTopCategories } from '../video-data-mark-top-categories';
+
+const video = {
+  categories: [{ name: 'cartoon', title: 'Cartoon' }, { name: '3d', title: '3D' }, { name: 'Masturbation', title: 'Masturbation' }],
+} as IRawVideoData;
+
+describe('videoDataMarkTopCategories', () => {
+  it('marks categories from the top list, ignoring case and edge spaces', () => {
+    const result = videoDataMarkTopCategories(video, ['cartoon', 'masturbation ']);
+
+    expect(result.categories.map(category => category.isTop)).toEqual([true, false, true]);
+  });
+
+  it('leaves the video untouched without the top list', () => {
+    expect(videoDataMarkTopCategories(video, null)).toBe(video);
+  });
+});

package/runtime/utils/video-data-mark-top-categories.ts

@@ -0,0 +1,21 @@
+import type { IRawVideoData } from '../../types';
+
+const normalize = (name: string) => name.trim().toLowerCase();
+
+/**
+ * Помечает категории ролика `isTop` по списку топ-категорий: в строку над плеером идут только топовые.
+ * Списка нет (ручка упала) — ролик без пометок, строка покажет все категории, как раньше.
+ * Имена сравниваются без регистра и краевых пробелов: в API встречается `masturbation `.
+ * @param videoData - сырые данные видео
+ * @param topNames - имена топ-категорий
+ */
+export function videoDataMarkTopCategories(videoData: IRawVideoData, topNames: string[] | null): IRawVideoData {
+  if (!videoData?.categories?.length || !topNames) return videoData;
+
+  const top = new Set(topNames.map(normalize));
+
+  return {
+    ...videoData,
+    categories: videoData.categories.map(category => ({ ...category, isTop: top.has(normalize(category.name)) })),
+  };
+}

package/server/api/videos/get-video-by-id/[id].get.ts

@@ -1,5 +1,5 @@
 import type { IRawVideoData, IVideoData, IRawModelCard } from '../../../../types';
-import { cleanVideoData, videoDataAddModelPortraits, getUrlWithProxiedParams } from '../../../../runtime';
+import { cleanVideoData, videoDataAddModelPortraits, videoDataMarkTopCategories, getUrlWithProxiedParams } from '../../../../runtime';
 
 export default defineEventHandler(async (event): Promise<IVideoData> => {
   const theme = useRuntimeConfig(event).public.theme;
@@ -17,15 +17,16 @@ export default defineEventHandler(async (event): Promise<IVideoData> => {
   const videoUrl = getUrlWithProxiedParams(`${apiUrl}/v2/video/url/${id}`, event);
   const modelsUrl = getUrlWithProxiedParams(`${apiUrl}/v2/models/list-by-video-id/${id}`, event);
 
-  const [videoRaw, modelsRaw] = await Promise.all([
+  const [videoRaw, modelsRaw, topCategoryNames] = await Promise.all([
     apiFetch(videoUrl, {
       method: 'GET',
       headers: clientHeaders,
     }),
     apiFetch(modelsUrl, { method: 'GET', headers: clientHeaders }).catch(() => null),
+    getTopCategoryNames(event),
   ]);
 
-  const videoData = withDemoFallbacks(videoRaw.data as IRawVideoData);
+  const videoData = videoDataMarkTopCategories(withDemoFallbacks(videoRaw.data as IRawVideoData), topCategoryNames);
   const modelsData = modelsRaw?.data as Record<'items', Array<IRawModelCard>>;
 
   return cleanVideoData(

package/server/api/videos/get-video-by-url/[url].get.ts

@@ -1,4 +1,4 @@
-import { cleanVideoData, videoDataAddModelPortraits, getUrlWithProxiedParams } from '../../../../runtime';
+import { cleanVideoData, videoDataAddModelPortraits, videoDataMarkTopCategories, getUrlWithProxiedParams } from '../../../../runtime';
 import type { IRawVideoData, IVideoData, IRawModelCard } from '../../../../types';
 
 export default defineEventHandler(async (event): Promise<IVideoData> => {
@@ -15,15 +15,16 @@ export default defineEventHandler(async (event): Promise<IVideoData> => {
   const videoUrl = getUrlWithProxiedParams(`${apiUrl}/v2/video/url/${url}`, event);
   const modelsUrl = getUrlWithProxiedParams(`${apiUrl}/v2/models/list-by-video-url/${url}`, event);
 
-  const [videoRaw, modelsRaw] = await Promise.all([
+  const [videoRaw, modelsRaw, topCategoryNames] = await Promise.all([
     apiFetch(videoUrl, {
       method: 'GET',
       headers: clientHeaders,
     }),
     apiFetch(modelsUrl, { method: 'GET', headers: clientHeaders }).catch(() => null),
+    getTopCategoryNames(event),
   ]);
 
-  const videoData = withDemoFallbacks(videoRaw.data as IRawVideoData);
+  const videoData = videoDataMarkTopCategories(withDemoFallbacks(videoRaw.data as IRawVideoData), topCategoryNames);
   const modelsData = modelsRaw?.data as Record<'items', Array<IRawModelCard>>;
 
   return cleanVideoData(

package/server/utils/top-category-names.ts

@@ -0,0 +1,14 @@
+import type { H3Event } from 'h3';
+import type { IRawCategoryCard } from '../../types';
+
+/**
+ * Имена топ-категорий из кеша BFF (`cachedApiFetch`, 10 минут на домен + язык + нишу): к бекенду ходим
+ * раз в TTL, а не на каждый ролик. Ошибка ручки — `null`, ролик от этого не падает.
+ */
+export async function getTopCategoryNames(event: H3Event): Promise<string[] | null> {
+  const url = `${process.env.NUXT_PUBLIC_API_DOMAIN}/v1/categories/top`;
+
+  return cachedApiFetch<Array<IRawCategoryCard>>(url, event)
+    .then(categories => (Array.isArray(categories) ? categories.map(category => category.name) : null))
+    .catch(() => null);
+}

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

@@ -36,7 +36,9 @@ export interface IRawVideoData {
     sizeCache?: string,
     state?: string,
     title: string,
-    unknownFields?: string
+    unknownFields?: string,
+    /** Не из API: ставит BFF по топ-списку категорий. */
+    isTop?: boolean
   }[];
   actions: null;
   primary_thumb_rank: number; // unused

package/types/video-data.d.ts

@@ -82,6 +82,8 @@ export interface IVideoData {
         name: string;
         title: string;
         icon?: string;
+        /** Топ-категория — попадает в строку над плеером (BFF, по кешу `/v1/categories/top`). */
+        isTop?: boolean;
     }[];
     actions: null;
     channelName: string;