itube-specs 0.0.812 → 0.0.814

package/README.md

@@ -1,8 +1,9 @@
 # itube-specs
 
 Общий **Nuxt Layer** для сайтов itube. Держит единую базу: компоненты, composables, сервисы, утилиты,
-runtime-хелперы, типы и lib-данные. Приложения расширяют слой (`extends: ['itube-specs']`) и форкаются
-под разные сайты одной ниши — поэтому слой должен оставаться **самодостаточным и site-agnostic**.
+runtime-хелперы, типы, lib-данные, а также middleware, SSR-плагины и BFF-хендлеры (`server/api`).
+Приложения расширяют слой (`extends: ['itube-specs']`) и форкаются под разные сайты одной ниши —
+поэтому слой должен оставаться **самодостаточным и site-agnostic**.
 
 > Bitbucket: https://bitbucket.org/luckytube/specs/src/master/
 
@@ -76,9 +77,15 @@ runtime/       # runtime-значения и хелперы (barrel index.ts)
   constants/   # доменные `as const` (Niche, PlaylistType, AdSpotType, …)
   utils/       # чистые хелперы, cleaners/, converters/
 types/         # .d.ts типы (barrel index.d.ts — с расширением .d.ts в реэкспортах)
-lib/           # статические scheme/config-данные (barrel index.ts)
+lib/           # статические scheme/config-данные (barrel index.ts): scheme/*, css-breakpoints
+middleware/    # глобальные: auth.global, normalize.global, age.global
+plugins/       # SSR/клиент: country/countries/mobile (SSR), services.client, sentry.client, adv
+server/        # BFF: api/** (тонкие прокси к внешнему API), utils/metrics, plugins/*, tasks
 ```
 
+> `middleware`/`plugins`/`server` обязаны быть в `files` (whitelist) — иначе не попадут в паблиш
+> (см. раздел `files`/`exports`).
+
 ---
 
 ## Импорты
@@ -87,8 +94,9 @@ lib/           # статические scheme/config-данные (barrel index
 через имя пакета. Приложения импортируют как `itube-specs/runtime`, `itube-specs/services/...`,
 `itube-specs/utils/...`, а типы — `itube-specs/types`.
 
-Алиасы `~/…`/`@/…` в файле слоя резолвятся на **приложение**, не на слой — для кода слоя их не используем
-(допустимо только для намеренных app-зависимостей, например рекламный компонент → `~/config`/`~/utils`).
+Алиасы `~/…`/`@/…` в файле слоя резолвятся на **приложение**, не на слой — в коде слоя их не используем.
+Сейчас таких app-зависимостей в слое не осталось: то, что раньше приходило из приложения (фича-флаги,
+ad-конфиг), теперь читается из `runtimeConfig.public` (значения задаёт приложение).
 
 ### `files` / `exports`
 
@@ -105,10 +113,12 @@ lib/           # статические scheme/config-данные (barrel index
 
 ## Что живёт в слое, а что в приложении
 
-- **Слой:** переиспользуемые компоненты, composables, API-сервисы, доменные утилиты, runtime-константы/хелперы,
-  типы, scheme/lib-данные — всё site-agnostic.
-- **Приложение:** фича-флаги и прочий `config/`, `assets/scss` (токены), плагины (`$features`, реклама,
-  sentry), страницы, i18n-локали, BFF-хендлеры `server/` — всё site-specific и завязанное на окружение.
+- **Слой:** компоненты, composables, API-сервисы, доменные утилиты, runtime-константы/хелперы, типы,
+  `lib/` (scheme, css-breakpoints), middleware (`auth`/`normalize`/`age`), SSR-плагины
+  (`country`/`mobile`/`services`/`sentry`/`adv`), BFF-хендлеры `server/api/**` — всё site-agnostic.
+- **Приложение:** только per-site — **значения** config (флаги/реклама/локали) через `runtimeConfig.public`
+  (слой держит пустые контейнеры-заглушки), `assets/scss` (токены), страницы, i18n-локали и остаток
+  `server/`, завязанный на локали (`locale-guard`, `site/languages`, `is-locale-blocked`).
 
 ---
 
@@ -130,5 +140,6 @@ lib/           # статические scheme/config-данные (barrel index
 ## Тесты
 
 Vitest через `@nuxt/test-utils`. В слое — **только тесты без app-специфичного окружения** (чистая логика
-composables/utils/runtime). Компонентные тесты с монтированием SFC и всё, что требует app-инжектов
-(`$features`, SCSS-токены), живёт в **приложении** — в слое нет ни scss-инъекции, ни плагинов приложения.
+composables/utils/runtime). Компонентные тесты с монтированием SFC (нужна SCSS-инъекция токенов, которой в слое
+нет) живут в **приложении**. Значения `runtimeConfig` (`featureFlags`/`adsConfig`) в слое — пустые контейнеры,
+поэтому его код при бутстрапе в CI не падает, но реальные значения приходят только из приложения.

package/package.json

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