@snabcentr/client-core 4.4.0 → 4.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snabcentr/client-core",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "author": "Snabcentr Ltd.",
   "repository": "https://gitlab.snabcentr.met/web/angular/snabcentr-client-core-lib",
   "license": "Commercial",

package/release_notes.tmp

@@ -1,4 +1,4 @@
-## 4.4.0 (2026-06-22)
+## 4.5.0 (2026-06-25)
 
 No changes.
 

package/types/snabcentr-client-core.d.ts

@@ -6287,10 +6287,11 @@ declare class ScCatalogFilterService {
  * Сервис редиректа на родительскую категорию при недоступности (HTTP 404) товара или категории.
  *
  * Запрашивает у бэкенда родительскую категорию недоступной сущности и выполняет редирект:
- * - на сервере (SSR) — выставляет HTTP-статус 302 и заголовок `Location` для корректного редиректа поисковых ботов;
- * - в браузере — выполняет навигацию средствами {@link Router}.
+ * - на сервере (SSR) при доступном {@link RESPONSE} — выставляет HTTP-статус 302 и заголовок `Location` для корректного редиректа поисковых ботов;
+ * - на сервере без {@link RESPONSE} (например, dev-сервер `ng serve`) — завершает поток ошибкой 404, чтобы отобразилась страница ошибки;
+ * - в браузере — выполняет полную навигацию на родительскую категорию.
  *
- * Если родительская категория не найдена, поток завершается ошибкой {@link HttpErrorResponse},
+ * Если родительская категория не найдена, поток также завершается ошибкой {@link HttpErrorResponse},
  * чтобы вызывающий код отобразил страницу ошибки.
  */
 declare class ScCatalogRedirectService {
@@ -6312,8 +6313,18 @@ declare class ScCatalogRedirectService {
     private readonly isServer;
     /**
      * Данные об ответе на запрос (доступны только на сервере при SSR).
+     *
+     * Angular 21 (миграция SSR): {@link RESPONSE} — кастомный Express-токен, который провайдится в `server.ts`
+     * через CommonEngine. На upgrade-ветке `server.ts` остался на CommonEngine, поэтому при слиянии здесь
+     * ничего менять не нужно. Если `server.ts` мигрируют на `AngularNodeAppEngine` + `createNodeRequestHandler`,
+     * замените {@link RESPONSE} на нативный `RESPONSE_INIT` (`InjectionToken<ResponseInit | null>` из `@angular/core`);
+     * см. серверную ветку в {@link redirectToParentCategory$}.
      */
     private readonly response;
+    /**
+     * Документ текущей страницы.
+     */
+    private readonly document;
     /**
      * Выполняет редирект на родительскую категорию недоступной категории.
      *
@@ -8770,7 +8781,17 @@ declare const IS_BROWSER: InjectionToken<boolean>;
  */
 declare const IS_SERVER: InjectionToken<boolean>;
 /**
- * Токен для получения данных об ответе на запрос.
+ * Токен для получения данных об ответе на запрос (Express `Response`), доступен только на сервере при SSR.
+ *
+ * Переходное состояние: `server.ts` приложений сейчас работает на `CommonEngine` из `@angular/ssr/node`,
+ * который провайдит этот кастомный токен per-request. `CommonEngine` помечен deprecated; целевой стек —
+ * `AngularNodeAppEngine` + `createNodeRequestHandler`. При миграции `server.ts` на этот стек откажитесь от
+ * данного токена в пользу нативного `RESPONSE_INIT` (`InjectionToken<ResponseInit | null>` из `@angular/core`):
+ * движок провайдит его автоматически и применяет `status`/`headers` к ответу после рендера. До миграции
+ * `server.ts` токен остаётся рабочим механизмом SSR-редиректов и менять его не требуется.
+ *
+ * @deprecated Переходный токен SSR-ответа: при миграции `server.ts` на `AngularNodeAppEngine` будет заменён
+ * нативным `RESPONSE_INIT`. Метка-напоминание; до миграции токен остаётся рабочим, удалять/менять не требуется.
  */
 declare const RESPONSE: InjectionToken<Response<any, Record<string, any>>>;