itube-specs 0.0.1066 → 0.0.1068

package/SITE_UPDATES.md

@@ -11,6 +11,27 @@
 коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
 кому именно (всем / сайтам с N), что будет, если не сделать.
 
+## 0.0.1068 — 2026-11-03
+
+- **Всем — решить флаг:** верификация возраста (редирект на agerify, пока не пройдена) снова работает, за флагом
+  `FeatureAgeVerificationEnabled`. Список стран общий, в слое (`runtime/utils/server/age.ts`); сейчас для проверки
+  только `NL` (GB и штат KS временно сняты). Хотите проверку — добавьте `FeatureAgeVerificationEnabled: true` в
+  `config/feature-flags.config.ts` (gay-cool-new включил). Без флага ничего не меняется.
+
+## 0.0.1067 — 2026-11-03
+
+- **hdsex-remaster, videosection-redesign — удалить оверрайды FapHouse, иначе блок под плеером будет ДВАЖДЫ:**
+  карусель FapHouse переехала в слой (`components/adv/faphouse/{index,promo}.vue`, `lib/faphouse.ts`,
+  `composables/fetch/use-fetch-faphouse.ts`, `server/api/faphouse/videos.get.ts`, `types/faphouse.d.ts`, ключи
+  `faphouse.promo_text/promo_action`, `advertising`, `ad_short`) и рендерится самим `view/video.vue` сразу после
+  `ViewVideoAfterPlayerSlot`, с отступом под боковую колонку с 1024px. Удалить у себя эти файлы (и
+  `composables/use-fetch-faphouse.ts`) и убрать `<LazyAdvFaphouse>` с его стилем из своего
+  `components/view/video-after-player-slot.vue`. Клик по блоку шлёт цель Метрики `adv.faphouse_click_<ниша>`, как
+  было в videosection. Свои `faphouse.promo_text` с `%niche%` в i18n сайта оставить — в слое текст без ниши.
+- **Всем — решить флаг:** FapHouse включается флагом `AdsFaphouseEnabled` и конфигом
+  `runtimeConfig.public.faphouseConfig` (образец — `config/faphouse.config.ts` hdsex-remaster: `utm.campaign`,
+  `utm.content`, `utm.term` = домен, `utm.feedContent`, `itemsLimit`). Без флага блока нет, делать ничего не надо.
+
 ## 0.0.1065 — 2026-11-02
 
 - **Всем — к сведению:** шапка на десктопе как на gay.cool-рефе: высота 65px (было 71), строка поиска 40px, поиск

package/components/adv/faphouse/index.vue

@@ -0,0 +1,243 @@
+<!-- Партнёрский блок FapHouse под плеером — по макету редизайна (v0-dark-eta, /video/1).
+
+Заголовка у блока нет: рекламу помечает плашка «AD» на каждой тумбе плюс
+`aria-label` секции. Под лентой — широкая промо-кнопка на тур (AdvFaphousePromo).
+
+На десктопе (от 1024px, как в макете) пять тумб в ряд; ниже — горизонтальная
+лента: карточка занимает 42% ширины, поэтому третья обрезается краем и видно,
+что лента прокручивается. Лента вылезает за поля контейнера до краёв экрана —
+так в макете (`-mx-4 px-4`).
+
+Поведение тумбы повторяет боевое: постер по умолчанию, при наведении на его
+место кладётся mp4-превью (`previewUrl`) — только на десктопе, на тач-устройствах
+превью не грузится вообще.
+
+Данные — `useFetchFaphouse()` через BFF-прокси фида партнёрки. Блок целиком
+гейтится флагом `AdsFaphouseEnabled` и не рендерится при пустом списке. -->
+<template>
+  <section
+    v-if="isEnabled && items.length"
+    :aria-label="t('advertising')"
+    class="adv-faphouse"
+  >
+    <ul class="adv-faphouse__items">
+      <li
+        v-for="(item, index) in items"
+        :key="`faphouse-${index}`"
+        class="adv-faphouse__item"
+      >
+        <a
+          :href="item.url"
+          class="adv-faphouse__link"
+          target="_blank"
+          rel="nofollow noopener sponsored"
+          @click="onClick"
+          @mouseenter="onPreviewShow(index)"
+          @mouseleave="onPreviewHide"
+        >
+          <span class="adv-faphouse__poster">
+            <UiImg
+              :src="item.imageUrl"
+              :alt="item.title"
+              class="adv-faphouse__img"
+              width="335"
+              height="188"
+              sizes="240px"
+              loading="lazy"
+            />
+            <video
+              v-if="previewIndex === index && item.previewUrl"
+              :src="item.previewUrl"
+              class="adv-faphouse__video"
+              muted
+              loop
+              autoplay
+              playsinline
+            />
+            <span class="adv-faphouse__ad">{{ t('ad_short') }}</span>
+            <span
+              v-if="item.duration"
+              class="adv-faphouse__duration"
+            >{{ formatDuration(item.duration) }}</span>
+          </span>
+          <span class="adv-faphouse__item-title _truncate">{{ item.title }}</span>
+        </a>
+      </li>
+    </ul>
+
+    <AdvFaphousePromo class="adv-faphouse__promo" />
+  </section>
+</template>
+
+<script setup lang="ts">
+import { faphouseClickGoal } from '../../../lib/faphouse';
+
+const { t } = useI18n();
+const reachGoal = useMetrikaGoal();
+
+const onClick = () => reachGoal(...faphouseClickGoal(NicheHelper.getCurrentNiche()));
+
+const isEnabled = computed(() => !!useRuntimeConfig().public.featureFlags.AdsFaphouseEnabled);
+
+const { items } = isEnabled.value ? await useFetchFaphouse() : { items: computed(() => []) };
+
+const isMobile = useState<boolean>('isMobile');
+const previewIndex = ref(-1);
+
+const onPreviewShow = (index: number) => {
+  if (isMobile.value) return;
+
+  previewIndex.value = index;
+};
+
+const onPreviewHide = () => {
+  previewIndex.value = -1;
+};
+
+/** Фид отдаёт длительность секундами; часы показываем только если они есть. */
+function formatDuration(duration: string | number): string {
+  if (typeof duration === 'string') return duration;
+
+  const total = Math.max(0, Math.round(duration));
+  const hours = Math.floor(total / 3600);
+  const minutes = Math.floor((total % 3600) / 60);
+  const seconds = String(total % 60).padStart(2, '0');
+
+  return hours
+    ? `${hours}:${String(minutes).padStart(2, '0')}:${seconds}`
+    : `${minutes}:${seconds}`;
+}
+</script>
+
+<style lang="scss">
+.adv-faphouse {
+  display: grid;
+  row-gap: 16px;
+  margin-bottom: 24px;
+}
+
+.adv-faphouse__items {
+  display: grid;
+  grid-auto-flow: column;
+
+  // лента: карточка в 42% ширины, третья обрезается краем — видно, что она листается
+  grid-auto-columns: 42%;
+  gap: 12px;
+  overflow-x: auto;
+  scrollbar-width: none;
+  scroll-snap-type: x mandatory;
+
+  // лента идёт до краёв экрана, за поля контейнера
+  margin-inline: calc(-1 * var(--container-padding-inline));
+  padding-inline: var(--container-padding-inline);
+
+  &::-webkit-scrollbar {
+    display: none;
+  }
+
+  @include from-br(sd) {
+    grid-auto-flow: row;
+    grid-template-columns: repeat(5, minmax(0, 1fr));
+    gap: 16px;
+    overflow-x: visible;
+    margin-inline: 0;
+    padding-inline: 0;
+  }
+}
+
+.adv-faphouse__item {
+  min-width: 0;
+  scroll-snap-align: start;
+}
+
+.adv-faphouse__link {
+  display: grid;
+  row-gap: 10px;
+  color: $faphouse-item-text;
+}
+
+.adv-faphouse__poster {
+  position: relative;
+  display: block;
+  overflow: hidden;
+  aspect-ratio: 16 / 9;
+  background-color: $faphouse-poster-bg;
+
+  // в макете rounded-lg = 8px; наш $radius-lg — это 10px, поэтому $radius-md
+  border-radius: $radius-md;
+}
+
+.adv-faphouse__img,
+.adv-faphouse__video {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+/* Наезд постера — как у видео-тумб макета */
+@media (hover: hover) {
+  .adv-faphouse__img {
+    transition: .3s var(--ease-in-out) transform;
+  }
+
+  .adv-faphouse__link:is(:hover, :focus-visible) .adv-faphouse__img {
+    transform: scale(1.05);
+  }
+
+  .adv-faphouse__link:is(:hover, :focus-visible) .adv-faphouse__item-title {
+    color: $faphouse-item-text--hover;
+  }
+
+  .adv-faphouse__item-title {
+    transition: var(--transition) color;
+  }
+}
+
+.adv-faphouse__video {
+  position: absolute;
+  inset: 0;
+  z-index: $z-index-plus;
+}
+
+/* Плашки выше превью: пометка «реклама» обязана быть видна и когда тумба проигрывает
+   ролик. Порядка в разметке тут мало — у превью свой z-index, он бы их накрыл. */
+.adv-faphouse__ad,
+.adv-faphouse__duration {
+  position: absolute;
+  z-index: $z-index-loader;
+  border-radius: $radius-small;
+}
+
+.adv-faphouse__ad {
+  /* 9px в шкале микро-размеров слоя нет (ближайшие 10 и 11), а в макете плашка
+     именно 9px с плотной строкой — как и наша собственная пометка «реклама» на
+     нативных слотах (adv/spot.vue). Держим их одинаковыми. */
+  font-size: 9px;
+  line-height: 1.25;
+  top: 6px;
+  right: 6px;
+  padding: 1px 4px;
+  font-weight: 700;
+  text-transform: uppercase;
+  color: $faphouse-ad-text;
+  background-color: $faphouse-ad-bg;
+}
+
+.adv-faphouse__duration {
+  @include font-xs;
+
+  bottom: 8px;
+  left: 8px;
+  padding: 2px 6px;
+  font-weight: 500;
+  color: $faphouse-duration-text;
+  background-color: $faphouse-duration-bg;
+}
+
+.adv-faphouse__item-title {
+  @include font-sm;
+
+  // обрезка — общим модификатором `_truncate`, число строк через его переменную
+  --line-clamp: 2;
+}
+</style>

package/components/adv/faphouse/promo.vue

@@ -0,0 +1,73 @@
+<!-- Промо-кнопка FapHouse («…GET ACCESS») — широкая плашка под каруселью.
+Текст — общий ключ `faphouse.promo_text`; сайт с нишевой формулировкой перекрывает его своим (с `%niche%`-токеном
+при `nichePostTranslation`). Ссылка на тур строится из ниши и utm-меток сайта (`runtimeConfig.public.faphouseConfig`). -->
+<template>
+  <a
+    :href="link"
+    :data-niche="niche"
+    class="adv-faphouse-promo"
+    target="_blank"
+    rel="nofollow noopener sponsored"
+    @click="reachGoal(...faphouseClickGoal(niche))"
+  >
+    <span class="adv-faphouse-promo__text">{{ t('faphouse.promo_text') }}</span>
+    <span class="adv-faphouse-promo__action">{{ t('faphouse.promo_action') }}</span>
+  </a>
+</template>
+
+<script setup lang="ts">
+import { faphouseClickGoal, faphouseTourLink } from '../../../lib/faphouse';
+
+const { t } = useI18n();
+const reachGoal = useMetrikaGoal();
+
+const niche = computed(() => NicheHelper.getCurrentNiche());
+const link = computed(() => faphouseTourLink(niche.value, useRuntimeConfig().public.faphouseConfig));
+</script>
+
+<style lang="scss">
+.adv-faphouse-promo {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  align-items: center;
+  justify-content: center;
+  padding: 10px 12px;
+  background-image: linear-gradient(to bottom, $faphouse-promo-bg-from, $faphouse-promo-bg-to);
+  color: $faphouse-promo-text;
+
+  // в макете rounded-lg = 8px; наш $radius-lg — это 10px
+  border-radius: $radius-md;
+  text-align: center;
+
+  @include hover(box-shadow) {
+    box-shadow: $faphouse-promo-shadow--hover;
+  }
+}
+
+.adv-faphouse-promo__text {
+  @include font-2xs;
+
+  font-weight: 800;
+
+  @include from-br(xm) {
+    @include font-sm;
+  }
+}
+
+.adv-faphouse-promo__action {
+  @include font-xs;
+
+  padding: 6px 12px;
+  font-weight: 700;
+  text-transform: uppercase;
+  color: $faphouse-promo-action-text;
+  background-color: $faphouse-promo-action-bg;
+  border-radius: $radius-small;
+  white-space: nowrap;
+
+  @include from-br(xm) {
+    @include font-sm;
+  }
+}
+</style>

package/components/view/video.vue

@@ -52,6 +52,11 @@
 
     <ViewVideoAfterPlayerSlot :data="data"/>
 
+    <LazyAdvFaphouse
+      class="view-video__faphouse"
+      hydrate-on-idle
+    />
+
     <section
       v-if="related"
       :class="{'_loading': status === 'pending'}"
@@ -343,6 +348,13 @@ function getModelChips(model: IVideoData['models'][number]): IChipsItem {
   margin-top: 32px;
 }
 
+/* С 1024px справа от плеера колонка (288px + 16px отступа) — блок партнёрки живёт в ширине плеера. */
+.view-video__faphouse {
+  @include from-br(sd) {
+    padding-right: 304px;
+  }
+}
+
 .view-video__video-aside {
   @include from-br(md) {
     display: flex;

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

@@ -0,0 +1,25 @@
+import type { IFaphouseVideo } from '../../types';
+
+/**
+ * Тумбы промо-карусели FapHouse.
+ *
+ * Данные — ручка партнёрки через BFF-прокси (`server/api/faphouse/videos.get.ts`).
+ * Ниша и язык уходят query-параметрами: прокси перекладывает их в заголовки
+ * `X-Niche` / `X-Language`, которых ручка требует обязательно.
+ */
+export const useFetchFaphouse = async (niche?: string) => {
+  const config = useRuntimeConfig().public.faphouseConfig;
+  const quantity = config?.itemsLimit || 5;
+  const currentNiche = niche || NicheHelper.getCurrentNiche();
+  const { locale } = useI18n();
+
+  const { data } = await useFetch<{ items: IFaphouseVideo[] }>('/bff/faphouse/videos', {
+    query: { niche: currentNiche, lang: locale, quantity },
+    key: `faphouse-${currentNiche}-${locale.value}`,
+    default: () => ({ items: [] }),
+  });
+
+  const items = computed<IFaphouseVideo[]>(() => data.value?.items || []);
+
+  return { items };
+};

package/i18n/locales/de-DE.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ Schau und lade VOLLE Videos in HD & 4K 🔥",
+    "promo_action": "ZUGANG ERHALTEN"
+  },
+  "advertising": "Werbung",
+  "ad_short": "Ad",
   "webcams": {
     "live_cams": "Live Cams",
     "online_now": "{count} online",

package/i18n/locales/en-US.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ Watch and download FULL videos in HD & 4K quality 🔥",
+    "promo_action": "GET ACCESS"
+  },
+  "advertising": "Advertising",
+  "ad_short": "Ad",
   "my_uploads": {
     "title": "My videos",
     "filter_label": "Filter by status",

package/i18n/locales/es-ES.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ Mira y descarga vídeos COMPLETOS en HD y 4K 🔥",
+    "promo_action": "OBTENER ACCESO"
+  },
+  "advertising": "Publicidad",
+  "ad_short": "Ad",
   "webcams": {
     "live_cams": "Cams en directo",
     "online_now": "{count} en línea",

package/i18n/locales/fr-FR.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ Regardez et téléchargez des vidéos COMPLÈTES en HD et 4K 🔥",
+    "promo_action": "OBTENIR L’ACCÈS"
+  },
+  "advertising": "Publicité",
+  "ad_short": "Ad",
   "webcams": {
     "live_cams": "Cams en direct",
     "online_now": "{count} en ligne",

package/i18n/locales/it-IT.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ Guarda e scarica video COMPLETI in HD e 4K 🔥",
+    "promo_action": "OTTIENI ACCESSO"
+  },
+  "advertising": "Pubblicità",
+  "ad_short": "Ad",
   "webcams": {
     "live_cams": "Cam in diretta",
     "online_now": "{count} online",

package/i18n/locales/ja-JP.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ 動画のフル版をHD・4K画質で視聴・ダウンロード 🔥",
+    "promo_action": "アクセスする"
+  },
+  "advertising": "広告",
+  "ad_short": "PR",
   "webcams": {
     "live_cams": "ライブチャット",
     "online_now": "{count}人がオンライン",

package/i18n/locales/ko-KR.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ 영상 전체를 HD·4K 화질로 감상하고 다운로드 🔥",
+    "promo_action": "액세스 받기"
+  },
+  "advertising": "광고",
+  "ad_short": "AD",
   "webcams": {
     "live_cams": "라이브 캠",
     "online_now": "{count}명 접속 중",

package/i18n/locales/ru-RU.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ Смотрите и скачивайте ПОЛНЫЕ видео в качестве HD и 4K 🔥",
+    "promo_action": "ПОЛУЧИТЬ ДОСТУП"
+  },
+  "advertising": "Реклама",
+  "ad_short": "Ad",
   "webcams": {
     "live_cams": "Трансляции",
     "online_now": "{count} онлайн",

package/i18n/locales/zh-CN.json

@@ -1,4 +1,10 @@
 {
+  "faphouse": {
+    "promo_text": "❤️ 观看并下载完整视频，支持 HD 和 4K 🔥",
+    "promo_action": "获取访问权限"
+  },
+  "advertising": "广告",
+  "ad_short": "Ad",
   "webcams": {
     "live_cams": "真人视讯",
     "online_now": "{count} 人在线",

package/lib/faphouse.ts

@@ -0,0 +1,42 @@
+import type { Niche } from '../runtime';
+
+/**
+ * Промо-карусель FapHouse («Suggested to you») под плеером.
+ *
+ * Ссылка на тур: `https://faphouse.com/{нишевый префикс}tour?utm_*` — префикс
+ * задаёт раздел FapHouse (у shemale он исторически `transgender/`), utm-метки
+ * приходят из конфига сайта (`runtimeConfig.public.faphouseConfig`), потому
+ * что `utm_term` — это домен сайта.
+ */
+export const FAPHOUSE_NICHE_PREFIX: Record<string, string> = {
+  straight: '',
+  gay: 'gay/',
+  shemale: 'transgender/',
+};
+
+export type FaphouseConfigType = {
+  baseUrl?: string;
+  itemsLimit?: number;
+  utm?: { campaign?: string, content?: string, term?: string, feedContent?: string };
+};
+
+/** Ссылка на тур FapHouse для ниши. */
+export function faphouseTourLink(niche: Niche | string, config?: FaphouseConfigType): string {
+  const prefix = FAPHOUSE_NICHE_PREFIX[niche] ?? '';
+  const base = config?.baseUrl || 'https://faphouse.com';
+  const utm = config?.utm || {};
+  const params = new URLSearchParams();
+
+  if (utm.campaign) params.set('utm_campaign', utm.campaign);
+  if (utm.content) params.set('utm_content', utm.content);
+  if (utm.term) params.set('utm_term', utm.term);
+
+  const query = params.toString();
+
+  return `${base}/${prefix}tour${query ? `?${query}` : ''}`;
+}
+
+/** Цель Метрики на клик по FapHouse — имена и параметры боевого videosection (`js/enums/metrika-events.enum.js`). */
+export function faphouseClickGoal(niche: string): [string, Record<string, unknown>] {
+  return [`adv.faphouse_click_${niche}`, { adv_faphouse_click: { niche } }];
+}

package/lib/index.ts

@@ -19,3 +19,4 @@ export * from './scheme/categories-navigation';
 export * from './scheme/navigation-items';
 export * from './scheme/profile-navigation-items';
 export * from './scheme/additional-links-items';
+export * from './faphouse';

package/middleware/age.global.ts

@@ -1,25 +1,21 @@
-// Возрастная верификация: СЕЙЧАС ОТКЛЮЧЕНА (middleware сразу возвращает return).
-// Логика проверки гео + статуса верификации с редиректом на форму сохранена ниже
-// в закомментированном виде — раскомментировать при включении.
-// import { isGeoMatch, getAgeValidationUrl, isAgeVerified } from '../runtime';
-// import { navigateTo } from '#app';
+import { isGeoMatch, getAgeValidationUrl, isAgeVerified } from '../runtime';
 
-export default defineNuxtRouteMiddleware(async (_to) => {
-  return;
-  // if (!import.meta.server) return;
-  // if (to.path.startsWith('/bff/age/verify')) return;
-  //
-  // const event = useRequestEvent();
-  //
-  // const config = useRuntimeConfig();
-  // if (!(await isGeoMatch(event, config))) return;
-  //
-  // const verified = await isAgeVerified(event, config);
-  //
-  // if (!verified) {
-  //     const { url } = await getAgeValidationUrl(event, to.path, config);
-  //     if (url) {
-  //         return navigateTo(url, { external: true });
-  //     }
-  // }
+export default defineNuxtRouteMiddleware(async (to) => {
+  if (!import.meta.server) return;
+  if (to.path.startsWith('/bff/age/verify')) return;
+
+  const config = useRuntimeConfig();
+  if (!config.public.featureFlags?.FeatureAgeVerificationEnabled) return;
+
+  const event = useRequestEvent();
+  if (!(await isGeoMatch(event, config))) return;
+
+  const verified = await isAgeVerified(event, config);
+
+  if (!verified) {
+    const { url } = await getAgeValidationUrl(event, to.path, config);
+    if (url) {
+      return navigateTo(url, { external: true });
+    }
+  }
 });

package/nuxt.config.ts

@@ -88,6 +88,7 @@ export default defineNuxtConfig({
       // runtimeConfig: по ней выбирается вариант портрета из `portraits`.
       theme: '',
       webcamsConfig: {},
+      faphouseConfig: {},
       locales: {
         codes: [],
         default: 'en',

package/package.json

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

package/runtime/utils/server/age.ts

@@ -1,10 +1,10 @@
 import { getCookie } from 'h3';
 import { getClientHeaders } from './get-client-headers';
 
-/** Возвращает true если пользователь находится в регионе где требуется верификация возраста (GB, штат KS). */
+/** Возвращает true если пользователь находится в регионе где требуется верификация возраста. */
 export async function isGeoMatch(event, _config) {
-  const AGE_VERIFY_REGIONS = ['KS'];
-  const AGE_VERIFY_COUNTRIES = ['GB'];
+  const AGE_VERIFY_REGIONS: string[] = [];
+  const AGE_VERIFY_COUNTRIES = ['NL'];
 
   const headers = getClientHeaders(event);
   const countryCode = headers[ 'countryCode' ];

package/server/api/faphouse/videos.get.ts

@@ -0,0 +1,54 @@
+import type { IFaphouseVideo } from '../../../types';
+
+type RawFaphouseItem = {
+  url?: string;
+  original_url?: string;
+  title?: string;
+  image_url?: string;
+  image2x_url?: string;
+  preview_url?: string;
+  duration?: number;
+  quality?: string;
+};
+
+/**
+ * BFF-прокси фида FapHouse (`GET /v1/faphouse/videos`).
+ *
+ * Ниша и язык уходят заголовками `X-Niche` / `X-Language` — так требует ручка;
+ * клиент передаёт их query-параметрами `niche` и `lang`, потому что до BFF свои
+ * заголовки он не проставляет. utm-метки партнёрки (`utm-campaign`,
+ * `utm-content`) берём из конфига сайта: их API подставляет в ссылки роликов, а
+ * значения per-site.
+ */
+export default defineEventHandler(async (event): Promise<{ items: IFaphouseVideo[], total: number }> => {
+  const apiUrl = process.env.NUXT_PUBLIC_API_DOMAIN;
+  const query = getQuery(event);
+  const config = useRuntimeConfig(event).public.faphouseConfig;
+
+  const url = new URL(`${apiUrl}/v1/faphouse/videos`);
+  url.searchParams.set('quantity', String(query.quantity || config?.itemsLimit || 5));
+  if (config?.utm?.campaign) url.searchParams.set('utm-campaign', config.utm.campaign);
+  if (config?.utm?.feedContent) url.searchParams.set('utm-content', config.utm.feedContent);
+
+  const raw = await apiFetch(url.toString(), {
+    headers: {
+      ...event.node.req.headers,
+      'x-niche': String(query.niche || ''),
+      'x-language': String(query.lang || event.node.req.headers['x-language'] || 'en'),
+    } as HeadersInit,
+  });
+
+  const items: RawFaphouseItem[] = raw?.data?.items || [];
+
+  return {
+    total: raw?.data?.total || 0,
+    items: items.map(item => ({
+      url: item.url || item.original_url || '',
+      title: item.title || '',
+      imageUrl: item.image_url || item.image2x_url || '',
+      previewUrl: item.preview_url || '',
+      duration: item.duration || 0,
+      quality: item.quality || '',
+    })).filter(item => item.url && item.imageUrl),
+  };
+});

package/types/faphouse.d.ts

@@ -0,0 +1,14 @@
+/** Тумба промо-карусели FapHouse (партнёрский фид). */
+export interface IFaphouseVideo {
+  /** Ссылка на видео на faphouse.com (уже с utm-метками партнёрки). */
+  url: string;
+  /** Постер тумбы. */
+  imageUrl: string;
+  /** Видео-превью для ховера (mp4). */
+  previewUrl?: string;
+  title: string;
+  /** Длительность: строка вида `20:26` или секунды. */
+  duration?: string | number;
+  /** `hd` | `sd` — бейдж качества. */
+  quality?: string;
+}

package/types/index.d.ts

@@ -84,3 +84,4 @@ export * from './switcher-item';
 export * from './webcam-facet';
 export * from './webcam-models-response';
 export * from './upload.d.ts';
+export * from './faphouse.d.ts';