itube-specs 0.0.716 → 0.0.719

package/composables/use-fetch-videos.ts

@@ -8,7 +8,7 @@ export const useFetchVideos = async (
     apiMethod: (...args: any[]) => Promise<PaginatedResponse<IVideoCard>>
 ) => {
     const route = useRoute();
-    
+
     const headers = useRequestHeaders()[ 'user-agent' ] ?? '';
     const mobile = isMobileDevice(headers);
     const perPage = mobile ? 12 : 48;
@@ -28,7 +28,7 @@ export const useFetchVideos = async (
                 [ 'per-page' ]: perPage,
             },
             filters.value,
-            getSelectedQuery(route, sortItemsDefault) || '-popularity,-primary_thumb_rank'
+            getSelectedQuery(route, sortItemsDefault) || '-country_order'
         )(),
         {
             watch: [

package/lib/scheme/sort-items-default.ts

@@ -5,7 +5,7 @@ export const sortItemsDefault: Array<IChipsItem> = [
     title: 'sort.trending',
     value: 'trending',
     key: 'sort',
-    query: '-popularity',
+    query: '-country_order',
   },
   {
     title: 'sort.new',

package/package.json

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

package/runtime/utils/server/age.ts

@@ -1,6 +1,7 @@
 import { getCookie } from 'h3';
 import { getClientHeaders } from './get-client-headers';
 
+/** Возвращает true если пользователь находится в регионе где требуется верификация возраста (GB, штат KS). */
 export async function isGeoMatch(event, config) {
     const AGE_VERIFY_REGIONS = ['KS'];
     const AGE_VERIFY_COUNTRIES = ['GB'];
@@ -13,6 +14,7 @@ export async function isGeoMatch(event, config) {
         || AGE_VERIFY_REGIONS.includes(stateCode);
 }
 
+/** Проверяет через API прошёл ли пользователь верификацию возраста по session_id из cookie или контекста. */
 export async function isAgeVerified(event, config) {
     const apiUrl = config.public.apiDomain;
     const sessionId = getCookie(event, 'session_id') || event?.context.sessionId;
@@ -33,6 +35,11 @@ export async function isAgeVerified(event, config) {
     return res.data === true;
 }
 
+/**
+ * Запрашивает у API URL для редиректа на страницу верификации возраста.
+ * @param backPath - путь на который вернуть пользователя после верификации
+ * @returns URL редиректа и countryCode пользователя
+ */
 export async function getAgeValidationUrl(event, backPath: string, config) {
     const sessionId = event.context?.sessionId || getCookie(event, 'session_id');
     const apiUrl = config.public.apiDomain;

package/runtime/utils/server/api-helper.ts

@@ -1,8 +1,12 @@
 import type { NitroFetchOptions } from "nitropack/types";
 
-/** Хелпер для работы с API */
+/** Клиентский хелпер для запросов через BFF (/bff prefix). Автоматически добавляет x-domain заголовок. */
 export class ApiHelper {
-    /** Метод для получения данных */
+    /**
+     * @param path - путь без /bff префикса, например `/videos/list`
+     * @param fetchOptions - стандартные опции $fetch
+     * @param runtimeConfig - useRuntimeConfig() для получения xDomain
+     */
     static async fetch<T>(
         path: string,
         fetchOptions: NitroFetchOptions<string>,

package/runtime/utils/server/get-client-headers.ts

@@ -1,3 +1,7 @@
+/**
+ * Извлекает гео-данные и клиентские параметры из заголовков запроса.
+ * Поддерживает заголовки Cloudflare (cf-ipcountry, cf-region) и кастомные (x-country-code, x-region-code).
+ */
 export function getClientHeaders(event: any) {
   const headers = event.node.req.headers;
 

package/runtime/utils/server/get-url-with-proxied-params.ts

@@ -1,3 +1,4 @@
+/** Копирует query-параметры из текущего запроса (event) в переданный URL. Используется для проксирования запросов с сохранением параметров. */
 export function getUrlWithProxiedParams(url: string, event) {
     const _url = new URL(url);
     _url.search = new URLSearchParams(getQuery(event));

package/runtime/utils/server/parse-api-error.ts

@@ -1,3 +1,7 @@
+/**
+ * Нормализует ошибку API в строку.
+ * Обрабатывает форматы: `data.error`, `error`, строку, массив и объект с вложенными значениями.
+ */
 export function parseApiError(error: any): string {
   const fallback = 'Unknown error occurred.';
 

package/runtime/utils/server/server-api-helper.ts

@@ -2,7 +2,13 @@ import type { H3Event } from "h3";
 import { getHeaders } from "h3";
 import type { FetchOptions } from "ofetch";
 
+/** Серверный хелпер для запросов к внешнему API. Проксирует заголовки клиента и разворачивает `response.data`. */
 export class ServerApiHelper {
+    /**
+     * @param url - полный URL внешнего API
+     * @param event - H3Event для проброса заголовков клиента
+     * @param requestOptions - дополнительные опции fetch (method, body и т.д.)
+     */
     public static async fetch<T>(url: string, event: H3Event, requestOptions?: FetchOptions): Promise<T> {
         try {
             const response = await $fetch<{ data: T }>(url, {