itube-specs 0.0.1051 → 0.0.1053

package/SITE_UPDATES.md

@@ -11,6 +11,54 @@
 коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
 кому именно (всем / сайтам с N), что будет, если не сделать.
 
+## 0.0.1053 — 2026-10-26
+
+- **Всем — к сведению:** нативка в конце сеток листингов и похожих (`AdvNativeBottom` в `view/video`, `view/videos`,
+  `view/model-videos`, страницах категории, канала, поиска) больше не ленивая. Контейнер приезжает в серверной
+  разметке, и сеть заполняет его до гидрации, а ленивая гидрация пересобирала уже заполненный iframe — креатив
+  терялся, слот оставался пустым (найдено на hdsex-remaster). Делать ничего не надо.
+- **Сайтам со своими сортировками на страницах на page-composables:** у `useCategoryPage`, `useChannelPage`,
+  `useModelPage` новая опция `sortOptions` (по умолчанию `sortItemsDefault`) — по ней ключи меты и проверка `?sort`.
+  Без неё свои значения `?sort` такой страницы — 404. Образец — коммит hdsex-remaster с этим изменением.
+- **Сайтам с частотным капом преролла (hdsex-remaster):** в `usePlayerSiteHooks()` новый хук `onAdStart()` — старт
+  рекламы в плеере (например, поставить куку капа). Остальным — ничего.
+- **Сайтам с боковой колонкой моделей у плеера (hdsex-remaster):** `appConfig.videoPage.hideAsideModelChips: true` —
+  с 1024px не дублировать чипсой над плеером модель, у которой есть блок в колонке. По умолчанию `false`, ничего не
+  меняется.
+
+## 0.0.1052 — 2026-10-22
+
+- **Всем — к сведению:** мусорные адреса листингов теперь 404. `?page` не натуральное число (`0`, `-1`, `abc`, `01`) —
+  404 в `normalize.global.ts`; `?sort`, которого нет у страницы, — 404 (`useSortGuard`, его зовёт `useMeta`, у страницы
+  категории без `metaKeys` — `useCategoryPage`); `?sort` у страницы без сортировок — тоже 404; модели за последней
+  страницей (API отвечает ошибкой) — 404; пустая пагинация за последней страницей (`UiPagination` с `total = 0`) —
+  404. Значение `?sort`, совпадающее с ключом API сортировки страницы (`-created`, `rank`, `-updated`), — 301 на неё
+  (сортировка по умолчанию — без `sort`). Своя страница со своими сортировками — передавать их в `useMeta`
+  (`sortOptions`), иначе её `?sort` станет 404.
+- **Сайтам, переехавшим со старого движка (videosection-redesign, hdsex-remaster, gay-cool-new):** новый ключ
+  `appConfig.legacySorts` (через `config/site.config.ts`) — старые значения `?sort`, которых нет у страниц или они под
+  другим ключом: старое → ключ API (`''` — аналога нет, 301 на страницу без сортировки). Без карты такие адреса из
+  индекса (`?sort=-views`, `?sort=-videos_count`…) станут 404. Образец — коммит videosection-redesign с этим изменением.
+- **Сайтам с поиском по нишам (videosection-redesign, hdsex-remaster):** фича-флаг `FeatureSearchNicheRedirectEnabled`
+  теперь читает слой: поиск во «чужой» нише (`/search/gay-anal` на straight) — 302 в нишу фразы; нишу и очищенную фразу
+  отдаёт v2 поиска (`POST /bff/search/niche`), как site-flag `isSearchNicheRedirectEnabled` старого движка. Страницы
+  поиска слоя зовут `await useSearchNicheRedirect()` первым; своя страница поиска — добавить тот же вызов до запросов
+  выдачи. hdsex-remaster: свою реализацию (`server/api/search/niche.get.ts`, `redirectToNicheWithResults` в
+  `pages/search/[slug]/index.vue`) удалить — иначе сработают обе.
+- **Сайтам со своей статистикой (hdsex-remaster):** статистика старого движка теперь в слое под `FeatureStatsEnabled`:
+  `plugins/stats.client.ts`, `utils/stats/*`, BFF `/bff/stats/{rotator,user,webcams}`, `useDeviceId`, `useWebcamStats`
+  (его зовут `GridWebcams` и врезки `GridVideos` — клики/показы вебкам-тумб уходят без вызова на сайте), `useStatsPage`
+  (контекст страницы: видео, ролик плейлиста, категория, тег, поиск зовут его сами — ротатор на видео и категории,
+  u-logger там же, где на бою). Тумбы сетки видео получили `data-md5` / `data-thumb-number` / `data-pos-number`.
+  hdsex-remaster: удалить свои `plugins/stats.client.ts`, `utils/stats-{flush,service,rotator,ulogger,webcams}.ts`,
+  `utils/device-id.ts`, `lib/page-info.ts`, `lib/rotator-grid.ts`, `composables/use-webcam-stats.ts`, ручки
+  `server/api/stats/{rotator,user,webcams}.post.ts` и вызовы `useWebcamStats` в своих view — иначе при включённом флаге
+  статистика уйдёт дважды. Телеметрию рекламы (`stats-ad-availability`, `PUT /stats/c`) оставить своей. Остальным —
+  флаг выключен, ничего не меняется.
+- **Сайтам с Яндекс.Метрикой (videosection-redesign; hdsex-remaster — счётчик 94076295 в бэклоге):** счётчик теперь в
+  слое — `plugins/metrika.ts`, id из `runtimeConfig.public.metrikaId` (env `NUXT_PUBLIC_METRIKA_ID`; в `nuxt.config.ts`
+  сайта — `metrikaId: process.env.NUXT_PUBLIC_METRIKA_ID || ''`), цели — `useMetrikaGoal()`. Пусто — счётчика нет.
+
 ## 0.0.1045 — 2026-10-20
 
 - **Сайтам, у которых бэк включает хинди (`/v1/site/languages` отдаёт `name: "in"`, `iso: "hi"` — сейчас

package/app.config.ts

@@ -21,6 +21,10 @@ export default defineAppConfig({
     videos: null as { afterRows: number, inserts: number } | null,
     models: null as { afterRows: number } | null,
   },
+  /** Старые значения `?sort` → ключ API сортировки редизайна (`''` — аналога нет, 301 на страницу без сортировки).
+   *  Значения, совпадающие с ключом API сортировки страницы (`-created`, `rank`), узнаются и без карты;
+   *  прочие неизвестные `?sort` — 404 (`useSortGuard`). */
+  legacySorts: {} as Record<string, string>,
   /** Класс кликабельной части карточек в сетках видео и моделей — для сайтовых хуков (триггер попандера). */
   cardTriggerClass: '',
   /** Состав страницы видео. */
@@ -35,6 +39,8 @@ export default defineAppConfig({
     webcamsBlock: false,
     /** Сколько моделей из хвоста списка уходит во врезки похожих, когда блок Live Cams включён. */
     webcamInserts: 8,
+    /** С 1024px прятать чипсы моделей над плеером, у которых есть блок в боковой колонке (не дублировать ссылку). */
+    hideAsideModelChips: false,
     /** Мета ролика как на старых движках: description — до трёх фраз перехода (недостающие — из тегов), без них —
      *  категории, склейка ключами `meta.videos-slug.tags_and` / `tags_tail`; в title доступен `{thirdText}` — название
      *  в Title Case. Выключено — description из описания ролика. */

package/components/grid/videos.vue

@@ -34,6 +34,9 @@
         :playlist-id="playlistId"
         :playlist="playlist"
         :link-class="cardTriggerClass"
+        :data-md5="cell.video.md5"
+        :data-thumb-number="cell.videoIndex + 1"
+        :data-pos-number="cell.videoIndex + 1"
         class="grid-videos__card"
       />
     </template>
@@ -65,6 +68,9 @@
         :playlist-id="playlistId"
         :playlist="playlist"
         :link-class="cardTriggerClass"
+        :data-md5="cell.video.md5"
+        :data-thumb-number="cell.videoIndex + 1"
+        :data-pos-number="cell.videoIndex + 1"
         class="grid-videos__card"
         loading="lazy"
         hydrate-on-idle
@@ -89,6 +95,9 @@
         :playlist="playlist"
         :hydrate-on-visible="HYDRATE_MARGIN"
         :link-class="cardTriggerClass"
+        :data-md5="cell.video.md5"
+        :data-thumb-number="cell.videoIndex + 1"
+        :data-pos-number="cell.videoIndex + 1"
         class="grid-videos__card"
         loading="lazy"
       />
@@ -141,11 +150,15 @@ const emit = defineEmits<{
 }>();
 
 /** Событие врезки наружу отдаём через хендлер: в шаблоне модель тумбы уже не сузить. */
+const webcamStats = useWebcamStats();
+
 function onInsertClick(cell: IGridCell) {
+  if (cell.webcam) webcamStats.onModelClick({ model: cell.webcam, index: cell.insertIndex });
   if (cell.webcam) emit('model-click', { model: cell.webcam, index: cell.insertIndex });
 }
 
 function onInsertView(cell: IGridCell, element: HTMLElement) {
+  if (cell.webcam) webcamStats.onModelView({ model: cell.webcam, index: cell.insertIndex, element });
   if (cell.webcam) emit('model-view', { model: cell.webcam, index: cell.insertIndex, element });
 }
 

package/components/grid/webcams.vue

@@ -15,8 +15,8 @@
     >
       <WebcamThumb
         :model="model"
-        @click="emit('model-click', { model, index })"
-        @poster="element => emit('model-view', { model, index, element })"
+        @click="onClick({ model, index })"
+        @poster="element => onView({ model, index, element })"
       />
     </li>
   </ul>
@@ -30,13 +30,25 @@ defineProps<{
 }>();
 
 /**
- * Клики и показы тумб сетка отдаёт наружу: индексы она знает, а куда их
- * отправлять — дело сайта (у статистики свой контекст страницы и устройства).
+ * Клики и показы тумб: статистика слоя (`useWebcamStats`, при `FeatureStatsEnabled`) и событиями наружу — для
+ * своей статистики сайта.
  */
 const emit = defineEmits<{
   'model-click': [payload: { model: IStripcashModel, index: number }]
   'model-view': [payload: { model: IStripcashModel, index: number, element: HTMLElement }]
 }>();
+
+const webcamStats = useWebcamStats();
+
+function onClick(payload: { model: IStripcashModel, index: number }) {
+  webcamStats.onModelClick(payload);
+  emit('model-click', payload);
+}
+
+function onView(payload: { model: IStripcashModel, index: number, element: HTMLElement }) {
+  webcamStats.onModelView(payload);
+  emit('model-view', payload);
+}
 </script>
 
 <style lang="scss">

package/components/player/core.vue

@@ -14,6 +14,7 @@
     lazy
     load-on="placeholder"
     @ended="emit('end')"
+    @adstart="siteHooks.onAdStart?.()"
     @advancerequest="onAdvanceRequest"
     @sourcechange="onSourceChange"
     @menurequest="onMenuRequest"

package/components/ui/pagination.vue

@@ -180,6 +180,11 @@ watchEffect(() => {
   if (activeNumber.value > length.value && props.total > 0) {
     navigateTo(linkTo(length.value));
   }
+
+  // за последней страницей, а страниц нет вовсе (API отдал пустую выдачу) — увести некуда, адрес мусорный
+  if (activeNumber.value > 1 && props.total === 0) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' });
+  }
 });
 
 function linkTo(value: string | number) {

package/components/view/model-videos.vue

@@ -38,10 +38,8 @@
       priority
     >
       <template #grid-end>
-        <LazyAdvNativeBottom
-          v-if="featureFlags.AdsNativeEnabled"
-          hydrate-on-visible
-        />
+        <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+        <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
       </template>
     </GridVideos>
     <div

package/components/view/video.vue

@@ -29,6 +29,7 @@
                 v-for="(model, index) in data.models"
                 :key="index"
                 :item="getModelChips(model)"
+                :class="{'view-video__model-chips': hasAsideBlock(model.title)}"
                 is-link
               />
             </template>
@@ -75,11 +76,10 @@
           />
         </template>
 
+        <!-- Без ленивой гидрации: контейнер приезжает в серверной разметке и сеть заполняет его до гидрации,
+        а ленивая гидрация пересобирала уже заполненный iframe — креатив терялся, слот оставался пустым. -->
         <template #grid-end>
-          <LazyAdvNativeBottom
-            v-if="featureFlags.AdsNativeEnabled"
-            hydrate-on-visible
-          />
+          <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
         </template>
       </LazyGridVideos>
     </section>
@@ -126,7 +126,7 @@
 
 <script setup lang="ts">
 import type { IChipsItem, IModelCard, IStripcashModel, IVideoCard, IVideoData, PaginatedResponse } from '../../types';
-import { convertModelToRoundCard } from '../../runtime';
+import { convertModelToRoundCard, convertString } from '../../runtime';
 import { VideosApiService } from '../../services/api/videos.service';
 import type { AsyncDataRequestStatus } from '#app';
 
@@ -232,6 +232,15 @@ const topChips = computed(() => {
 const topChipsStrings = computed(() => topChips.value?.map(item => item.value));
 
 /** Портрет в чипсе — квадратный кроп по лицу; своего у видео нет, его подмешивает BFF. */
+// `videoPage.hideAsideModelChips`: с 1024px чипса модели не нужна тем, у кого есть блок в боковой колонке плеера
+// (`useFetchAsideModels`). Снимок, а не реактивное чтение: список заполняется эффектом, и реактивный класс
+// пересчитывался бы во время гидрации — разметка расходилась бы с серверной.
+const asideModelSlugs = new Set(videoPage.hideAsideModelChips ? useAsideModelSlugs().value : []);
+
+function hasAsideBlock(title: string): boolean {
+  return asideModelSlugs.has(convertString().toSlug(title));
+}
+
 const placeholderOf = useModelPlaceholder();
 
 function getModelChips(model: IVideoData['models'][number]): IChipsItem {
@@ -283,6 +292,12 @@ function getModelChips(model: IVideoData['models'][number]): IChipsItem {
   margin-top: 32px;
 }
 
+.view-video__model-chips {
+  @include from-br(sd) {
+    display: none;
+  }
+}
+
 .view-video__popular-models {
   margin-top: 32px;
 }

package/components/view/videos.vue

@@ -36,10 +36,8 @@
       priority
     >
       <template #grid-end>
-        <LazyAdvNativeBottom
-          v-if="featureFlags.AdsNativeEnabled"
-          hydrate-on-visible
-        />
+        <!-- не ленивая: ленивая гидрация пересобирала заполненный сетью iframe, креатив терялся -->
+        <AdvNativeBottom v-if="featureFlags.AdsNativeEnabled"/>
       </template>
 
       <LazySectionSwiperCards

package/composables/fetch/use-fetch-models-by-letter.ts

@@ -48,5 +48,10 @@ export const useFetchModelsByLetter = async (
     }
   );
 
+  // за последней страницей API моделей отвечает ошибкой, а не пустой страницей — пагинации не на что увести
+  if ((Number(route.query['page']) || 1) > 1 && !data.value?.items?.length) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' });
+  }
+
   return { data, status, refresh };
 };

package/composables/fetch/use-fetch-models-by-phrases.ts

@@ -38,5 +38,10 @@ export const useFetchModelsByPhrases = async (
     }
   );
 
+  // за последней страницей API моделей отвечает ошибкой, а не пустой страницей — пагинации не на что увести
+  if ((Number(route.query['page']) || 1) > 1 && !data.value?.items?.length) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' });
+  }
+
   return { data, status, error };
 };

package/composables/fetch/use-fetch-models.ts

@@ -46,5 +46,10 @@ export const useFetchModels = async (
     }
   );
 
+  // за последней страницей API моделей отвечает ошибкой, а не пустой страницей — пагинации не на что увести
+  if ((Number(route.query['page']) || 1) > 1 && !data.value?.items?.length) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' });
+  }
+
   return { data, status, refresh };
 };

package/composables/page/use-category-page.ts

@@ -1,7 +1,7 @@
 import { CategoriesApiService } from '../../services/api/categories.service';
 import { VideosApiService } from '../../services/api/videos.service';
 import { sortItemsDefault } from '../../lib';
-import type { IBreadcrumbItem, ICardInfo, IChipsItem } from '../../types';
+import type { IBreadcrumbItem, ICardInfo, IChipsItem, INavLinkItem } from '../../types';
 
 /** Слаги категорий, у которых не показываем связанные поисковые фразы. */
 const DISALLOWED_SLUGS = ['18', '19'];
@@ -35,7 +35,11 @@ export async function useCategoryPageData() {
  */
 export function useCategoryPage(
   pageData: Awaited<ReturnType<typeof useCategoryPageData>>,
-  options: { metaKeys?: boolean } = {},
+  options: {
+    metaKeys?: boolean
+    /** Сортировки страницы (по умолчанию `sortItemsDefault`): по ним ключи меты и проверка `?sort` (чужой — 404). */
+    sortOptions?: INavLinkItem[]
+  } = {},
 ) {
   const { categoryInfo, data, status, relatedData } = pageData;
   const { t } = useI18n();
@@ -48,12 +52,20 @@ export function useCategoryPage(
 
   const title = computed(() => categoryInfo.value?.title || '');
 
+  // статистика: ротатор листинга категории + u-logger, как на старом движке
+  useStatsPage(() => ({ rotatorID: 'category', categories: slug.value ? [slug.value] : [] }));
+
+  // с metaKeys `?sort` проверяет useMeta
+  const sortOptions = options.sortOptions || sortItemsDefault;
+
+  if (!options.metaKeys) useSortGuard(sortOptions);
+
   const keysMeta = options.metaKeys
     ? useMeta({
         t,
         pageKey: useGetPureRouteName(),
         brandName: useAppConfig().brandName,
-        sortOptions: sortItemsDefault,
+        sortOptions,
         text: title,
         nicheSafeText: title,
         seo: () => ({

package/composables/page/use-channel-page.ts

@@ -4,7 +4,7 @@ import type { Language } from '../../runtime';
 import { sortItemsDefault } from '../../lib';
 import { ChannelsApiService } from '../../services/api/channels.service';
 import { VideosApiService } from '../../services/api/videos.service';
-import type { IBreadcrumbItem, IChipsItem, IPopularTags } from '../../types';
+import type { IBreadcrumbItem, IChipsItem, IPopularTags, INavLinkItem } from '../../types';
 
 /**
  * Данные страницы канала: карточка канала, видео, популярные теги. Только запросы — их можно запускать в
@@ -37,7 +37,12 @@ export async function useChannelPageData() {
  */
 export function useChannelPage(
   pageData: Awaited<ReturnType<typeof useChannelPageData>>,
-  options: { metaSort?: MaybeRefOrGetter<string>, metaSecondText?: Ref<string> } = {},
+  options: {
+    metaSort?: MaybeRefOrGetter<string>
+    metaSecondText?: Ref<string>
+    /** Сортировки страницы (по умолчанию `sortItemsDefault`): по ним ключи меты и проверка `?sort` (чужой — 404). */
+    sortOptions?: INavLinkItem[]
+  } = {},
 ) {
   const { cardInfo, status, channelTagsData } = pageData;
   const route = useRoute();
@@ -50,7 +55,7 @@ export function useChannelPage(
     t,
     pageKey: useGetPureRouteName(),
     brandName: useAppConfig().brandName,
-    sortOptions: sortItemsDefault,
+    sortOptions: options.sortOptions || sortItemsDefault,
     sort: options.metaSort,
     text: metaTitle,
     secondText: options.metaSecondText,

package/composables/page/use-model-page.ts

@@ -4,7 +4,7 @@ import type { Language } from '../../runtime';
 import { sortItemsDefault } from '../../lib';
 import { ModelsApiService } from '../../services/api/models.service';
 import { VideosApiService } from '../../services/api/videos.service';
-import type { IBreadcrumbItem } from '../../types';
+import type { IBreadcrumbItem, INavLinkItem } from '../../types';
 
 /**
  * Данные страницы модели: видео и карточка модели. Только запросы — их можно запускать в `Promise.all` вместе
@@ -34,7 +34,12 @@ export async function useModelPageData() {
  */
 export function useModelPage(
   pageData: Awaited<ReturnType<typeof useModelPageData>>,
-  options: { metaSort?: MaybeRefOrGetter<string>, metaSecondText?: Ref<string> } = {},
+  options: {
+    metaSort?: MaybeRefOrGetter<string>
+    metaSecondText?: Ref<string>
+    /** Сортировки страницы (по умолчанию `sortItemsDefault`): по ним ключи меты и проверка `?sort` (чужой — 404). */
+    sortOptions?: INavLinkItem[]
+  } = {},
 ) {
   const { status, cardInfo } = pageData;
   const route = useRoute();
@@ -48,7 +53,7 @@ export function useModelPage(
     t,
     pageKey: useGetPureRouteName(),
     brandName: useAppConfig().brandName,
-    sortOptions: sortItemsDefault,
+    sortOptions: options.sortOptions || sortItemsDefault,
     sort: options.metaSort,
     text: metaTitle,
     secondText: options.metaSecondText,

package/composables/page/use-search-page.ts

@@ -20,6 +20,8 @@ export function useSearchPage(
 
   const metaTitle = computed(() => convertString().toCapitalize(slug.value));
 
+  useStatsPage(() => ({ search: slug.value }));
+
   const { meta, h1 } = useMeta({
     t,
     pageKey: useGetPureRouteName(),

package/composables/use-device-id.ts

@@ -0,0 +1,40 @@
+/**
+ * Идентификатор устройства для статистики — кука `itube-uid` на год.
+ *
+ * Тот же ключ и тот же алфавит, что на боевом движке (там `nanoid(42)` из `1234567890qwertyuiopasdfghjklzxcvbnm`):
+ * статистика склеивается по этому id, поэтому формат менять нельзя. Кука ставится на базовый домен с точкой, чтобы
+ * языковые поддомены считались одним устройством.
+ */
+const COOKIE_NAME = 'itube-uid';
+const ALPHABET = '1234567890qwertyuiopasdfghjklzxcvbnm';
+const LENGTH = 42;
+const YEAR_SECONDS = 365 * 24 * 60 * 60;
+
+function generate(): string {
+  const bytes = new Uint8Array(LENGTH);
+  crypto.getRandomValues(bytes);
+
+  return Array.from(bytes, byte => ALPHABET[byte % ALPHABET.length]).join('');
+}
+
+/** Возвращает id устройства, при первом заходе создавая его. */
+export function useDeviceId(): string {
+  // домен куки ставим только если реально находимся на нём: иначе (стенд на localhost, превью-домен) браузер
+  // молча выбрасывает куку и id теряется
+  const configured = useRuntimeConfig().public.xDomain as string | undefined;
+  const host = import.meta.client ? location.hostname : '';
+  const domain = configured && host.endsWith(configured) ? configured : undefined;
+
+  const cookie = useCookie<string | null>(COOKIE_NAME, {
+    maxAge: YEAR_SECONDS,
+    path: '/',
+    domain: domain ? `.${domain}` : undefined,
+    sameSite: 'lax',
+  });
+
+  if (!cookie.value && import.meta.client) {
+    cookie.value = generate();
+  }
+
+  return cookie.value || '';
+}

package/composables/use-meta.ts

@@ -63,6 +63,7 @@ type MetaParams = {
  */
 export function useMeta({ t, pageKey, brandName, sortOptions, sort, text, secondText, thirdText, fourthText, h1Key, seo, nicheSafeText }: MetaParams) {
   const route = useRoute();
+  useSortGuard(sortOptions);
   const { te, locale } = useI18n();
   const defaultNiche = NicheHelper.getSiteDefaultNiche();
   // стейт берём здесь, в setup: computed читается и вне контекста Nuxt (после await, в useHead)

package/composables/use-metrika-goal.ts

@@ -0,0 +1,12 @@
+/**
+ * Цель Яндекс.Метрики сайта: `const reachGoal = useMetrikaGoal()` в setup, `reachGoal('adv.click', params)` в
+ * обработчике. Счётчика нет (`metrikaId` пуст) или тег ещё не встал — тихо ничего.
+ */
+export function useMetrikaGoal() {
+  const id = Number(useRuntimeConfig().public.metrikaId);
+
+  return (goal: string, params?: Record<string, unknown>) => {
+    const ym = import.meta.client ? (window as unknown as { ym?: (...args: unknown[]) => void }).ym : undefined;
+    if (id && typeof ym === 'function') ym(id, 'reachGoal', goal, params);
+  };
+}

package/composables/use-search-niche-redirect.ts

@@ -0,0 +1,44 @@
+import type { Language } from '../runtime';
+import { convertString } from '../runtime';
+import { nichePath, withNichePrefix, type NicheSlugs } from '../config/niches';
+import { SearchApiService } from '../services/api/search.service';
+
+/**
+ * Поиск во «чужой» нише (`/search/gay-anal` на straight) — 302 в нишу фразы, как site-flag
+ * `isSearchNicheRedirectEnabled` старого движка: нишу и очищенную фразу определяет v2 поиска
+ * (`SearchApiService.getQueryNiche`). Включается `FeatureSearchNicheRedirectEnabled`; звать первым `await` страницы
+ * поиска — до запросов выдачи.
+ */
+export async function useSearchNicheRedirect() {
+  if (!useRuntimeConfig().public.featureFlags.FeatureSearchNicheRedirectEnabled) return;
+
+  // всё, что зависит от инстанса Nuxt, — до await: после него контекст потерян
+  const nuxtApp = useNuxtApp();
+  const slug = useSlug();
+  const lang = useLang() as Language;
+  const localePath = useLocalePath();
+  const appConfig = useAppConfig();
+  const currentNiche = NicheHelper.getCurrentNiche();
+  const nicheRouting = {
+    niches: appConfig.niches as string[],
+    defaultNiche: NicheHelper.getSiteDefaultNiche(),
+    slugs: appConfig.nicheSlugs as NicheSlugs | undefined,
+  };
+
+  const { data } = await useAsyncData(
+    `search-niche-${currentNiche}-${lang}-${slug.value}`,
+    () => SearchApiService.getQueryNiche(lang, slug.value, currentNiche).catch(() => null),
+  );
+
+  const niche = data.value?.niche;
+  if (!niche || niche === currentNiche || !nicheRouting.niches.includes(niche)) return;
+
+  const phrase = data.value?.phrase || slug.value;
+  const prefix = nichePath(niche, nicheRouting);
+
+  await nuxtApp.runWithContext(() => {
+    const target = withNichePrefix(localePath(`/search/${encodeURIComponent(convertString().toSlug(phrase))}`), prefix, localePath('/'));
+
+    return navigateTo(target, { redirectCode: 302, replace: true });
+  });
+}

package/composables/use-sort-guard.ts

@@ -0,0 +1,30 @@
+import { resolveSortQuery } from '../runtime';
+import type { INavLinkItem } from '../types';
+
+/**
+ * `?sort` страницы против её сортировок (`resolveSortQuery`): мусор — 404, старые значения
+ * (`appConfig.legacySorts`, ключи API) — 301 на аналог или на страницу без сортировки. Зовётся в setup страницы:
+ * его вызывает `useMeta`, так что листинги проверены без отдельного вызова.
+ */
+export function useSortGuard(sortOptions?: INavLinkItem[]) {
+  const route = useRoute();
+  const raw = route.query['sort'];
+  if (raw === undefined || raw === null) return;
+
+  const legacy = (useAppConfig().legacySorts || {}) as Record<string, string>;
+  const resolution = resolveSortQuery(String(raw), sortOptions || [], legacy);
+
+  if (resolution.action === 'notFound') {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' });
+  }
+
+  if (resolution.action === 'redirect') {
+    const { sort: _sort, ...query } = route.query;
+
+    // в setup не ждём: на сервере ответ-редирект выставляется раньше, чем закончится рендер страницы
+    void navigateTo(
+      { path: route.path, query: resolution.sort ? { ...query, sort: resolution.sort } : query },
+      { redirectCode: 301, replace: true },
+    );
+  }
+}

package/composables/use-stats-page.ts

@@ -0,0 +1,30 @@
+/** Что страница сообщает статистике (на старых движках — data-атрибуты скриптов `info.js` и `u-logger.js`). */
+export interface IStatsPageContext {
+  /** Включает ротатор на странице (`video`, `category`) — на бою он стоял только там. */
+  rotatorID?: string
+  categories?: string[]
+  tags?: string[]
+  models?: string[]
+  search?: string
+  videoMD5?: string
+  videoID?: string
+}
+
+const STATE_KEY = 'stats-page';
+
+/** Контекст статистики текущей страницы — читает `plugins/stats.client.ts`. */
+export const useStatsPageState = () => useState<IStatsPageContext | null>(STATE_KEY, () => null);
+
+/**
+ * Страница отдаёт статистике свой контекст: без вызова на странице есть только статистика вебкам-тумб, с ним —
+ * u-logger (время и интересы) и, с `rotatorID`, ротатор тумб. Звать в setup; данные могут доехать позже — геттер.
+ */
+export function useStatsPage(context: () => IStatsPageContext) {
+  if (!useRuntimeConfig().public.featureFlags.FeatureStatsEnabled) return;
+
+  const state = useStatsPageState();
+
+  watchEffect(() => {
+    state.value = context();
+  });
+}

package/composables/use-webcam-stats.ts

@@ -0,0 +1,45 @@
+import type { IStripcashModel } from '../types';
+import { resolvePageInfo } from '../runtime';
+import { observeWebcamView, sendWebcamClick, trackWebcamViews } from '../utils/stats/webcams';
+
+/**
+ * Статистика вебкам-тумб для места, где они выводятся (`GridWebcams`, врезки `GridVideos`): клик уходит сразу,
+ * показ — по нижней границе тумбы, показы копятся и уезжают одним запросом на уходе со страницы
+ * (`utils/stats/webcams.ts`). Без `FeatureStatsEnabled` — пустые обработчики.
+ */
+export const useWebcamStats = () => {
+  const noop = { onModelClick: (_payload: { model: IStripcashModel, index: number }) => undefined, onModelView: (_payload: { model: IStripcashModel, index: number, element: HTMLElement }) => undefined };
+  if (!useRuntimeConfig().public.featureFlags.FeatureStatsEnabled) return noop;
+
+  // всё контекстное — в setup: обработчики зовутся из событий DOM, вне инстанса
+  const router = useRouter();
+  const deviceId = useDeviceId();
+
+  const statsContext = () => {
+    const route = router.currentRoute.value;
+    const { pageType, pageValue, pageNumber } = resolvePageInfo(route.name, route.params, route.query);
+
+    return { deviceId, niche: NicheHelper.getCurrentNiche() || 'straight', pageType, pageValue, pageNumber };
+  };
+
+  const stopHandlers: Array<() => void> = [];
+  const username = (model: IStripcashModel) => String(model.username || model.id || '');
+
+  onMounted(() => {
+    stopHandlers.push(trackWebcamViews(statsContext()));
+  });
+
+  onBeforeUnmount(() => {
+    stopHandlers.forEach(stop => stop());
+    stopHandlers.length = 0;
+  });
+
+  return {
+    onModelClick: ({ model, index }: { model: IStripcashModel, index: number }) => {
+      sendWebcamClick(statsContext(), username(model), index + 1);
+    },
+    onModelView: ({ model, index, element }: { model: IStripcashModel, index: number, element: HTMLElement }) => {
+      stopHandlers.push(observeWebcamView(element, username(model), index + 1));
+    },
+  };
+};