@snabcentr/client-core 2.64.2 → 2.65.0

package/guards/index.d.ts

@@ -1,3 +1,2 @@
-export * from './catalog-seo.guard';
 export * from './sc-auth-as-client.guard';
 export * from './sc-id-or-slug.guard';

package/helpers/sc-image-helper.d.ts

@@ -1,4 +1,4 @@
-import { ScProduct } from '../catalog/dto';
+import { ScProduct } from '../catalog/dto/sc-product';
 import { ScIImage } from '../common/interfaces/sc-i-image';
 import * as i0 from "@angular/core";
 /**

package/helpers/sc-units-helper.d.ts

@@ -1,4 +1,4 @@
-import { ScProduct } from '../catalog';
+import { ScProduct } from '../catalog/dto/sc-product';
 import * as i0 from "@angular/core";
 /**
  * Клас-помощник для работы со значениями единиц измерения товара.

package/news/classes/index.d.ts

@@ -1,2 +1 @@
 export * from './sc-news';
-export * from './sc-news-tile';

package/news/classes/sc-news.d.ts

@@ -1,33 +1,38 @@
-import { ScSeoResource } from '../../catalog/dto/sc-seo-resource';
-import { ScINewsDTO } from '../internal/sc-i-news-dto';
+import { ScIdentity } from '../../common/classes/sc-identity';
+import { ScISeo } from '../../seo/interfaces/sc-i-seo';
+import { ScINews } from '../interfaces/sc-i-news';
 /**
  * Модель данных новости.
  */
-export declare class ScNews extends ScSeoResource {
+export declare class ScNews extends ScIdentity implements ScINews {
     /**
-     * Идентификатор новости.
+     * @inheritDoc
      */
-    id: number;
+    subject: string;
     /**
-     * Заголовок новости.
+     * @inheritDoc
      */
-    subject: string;
+    image?: string;
+    /**
+     * @inheritDoc
+     */
+    imageWebp?: string;
     /**
-     * Дата и время создания новости.
+     * @inheritDoc
      */
     createdAt: string;
     /**
-     * Строка HTML с содержимым новости.
+     * @inheritDoc
      */
     text: string;
     /**
-     * Ссылка на основное изображение новости в формате WebP.
+     * @inheritDoc
      */
-    imageWebp?: string;
+    seo?: ScISeo;
     /**
      * Инициализирует экземпляр класса {@link ScCategory}.
      *
-     * @param newsDTO Данные для инициализации.
+     * @param data Данные для инициализации.
      */
-    constructor(newsDTO: ScINewsDTO);
+    constructor(data: ScINews);
 }

package/news/index.d.ts

@@ -1,4 +1,4 @@
+export * from './interfaces';
 export * from './classes';
-export * from './services/sc-news.service';
-export * from './internal/sc-i-news-dto';
-export * from './tokens/sc-count-last-news';
+export * from './services';
+export * from './tokens';

package/news/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './sc-i-news';
+export * from './sc-i-news-tile';

package/news/interfaces/sc-i-news-tile.d.ts

@@ -0,0 +1,22 @@
+import { ScIIdentity } from '../../common/interfaces/sc-i-identity';
+/**
+ * Краткие данные о новости.
+ */
+export interface ScINewsTile extends ScIIdentity {
+    /**
+     * Заголовок.
+     */
+    subject: string;
+    /**
+     * Ссылка на основное изображение.
+     */
+    image?: string;
+    /**
+     * Ссылка на основное изображение в формате WebP.
+     */
+    imageWebp?: string;
+    /**
+     * Дата и время создания записи.
+     */
+    createdAt: string;
+}

package/news/interfaces/sc-i-news.d.ts

@@ -0,0 +1,11 @@
+import { ScISeoResource } from '../../seo/interfaces/sc-i-seo-resource';
+import { ScINewsTile } from './sc-i-news-tile';
+/**
+ * Данные о новости.
+ */
+export interface ScINews extends Omit<ScINewsTile, 'image'>, ScISeoResource {
+    /**
+     * HTML-строка с содержимым новости.
+     */
+    text: string;
+}

package/news/services/index.d.ts

@@ -0,0 +1 @@
+export * from './sc-news.service';

package/news/services/sc-news.service.d.ts

@@ -1,6 +1,7 @@
 import { Observable } from 'rxjs';
 import { ScIPaginate, ScIPaginationParams } from '../../pagination';
-import { ScNews, ScNewsTile } from '../classes';
+import { ScNews } from '../classes/sc-news';
+import { ScINewsTile } from '../interfaces/sc-i-news-tile';
 import * as i0 from "@angular/core";
 /**
  * Сервис для получения списка новостей.
@@ -31,7 +32,7 @@ export declare class ScNewsService {
      *
      * @param params параметры пагинации новостей.
      */
-    getListOfNews$(params: ScIPaginationParams): Observable<ScIPaginate<ScNewsTile>>;
+    getListOfNews$(params: ScIPaginationParams): Observable<ScIPaginate<ScINewsTile>>;
     /**
      * Возвращает {@link Observable} полной информации о новости.
      *
@@ -41,7 +42,7 @@ export declare class ScNewsService {
     /**
      * Возвращает {@link Observable} получения списка последних новостей.
      */
-    getLastNewsList$(): Observable<ScIPaginate<ScNewsTile>>;
+    getLastNewsList$(): Observable<ScIPaginate<ScINewsTile>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ScNewsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ScNewsService>;
 }

package/news/tokens/index.d.ts

@@ -0,0 +1 @@
+export * from './sc-count-last-news';

package/package.json

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

package/public-api.d.ts

@@ -25,10 +25,9 @@ export * from './pipes';
 export * from './questionnaire';
 export * from './reclamation';
 export * from './references';
-export * from './sc-json-ld';
 export * from './search';
+export * from './seo';
 export * from './suggestion';
-export * from './services';
 export * from './tokens';
 export * from './ui';
 export * from './user';

package/search/services/sc-search.service.d.ts

@@ -1,9 +1,10 @@
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
-import { ScCategory, ScFiltersTreeCatalog } from '../../catalog';
-import { ScIUrls } from '../../config';
-import { ScUserMetrikaService } from '../../user-metrika';
-import { ScISimpleSearch } from '..';
+import { ScCategory } from '../../catalog/dto/sc-category';
+import { ScFiltersTreeCatalog } from '../../catalog/types/sc-filters-tree-catalog';
+import { ScIUrls } from '../../config/sc-i-urls';
+import { ScUserMetrikaService } from '../../user-metrika/services/sc-user-metrika.service';
+import { ScISimpleSearch } from '../dto/sc-i-simple-search';
 import * as i0 from "@angular/core";
 /**
  * Сервис поиска по каталогу.

package/seo/classes/index.d.ts

@@ -0,0 +1 @@
+export * from './schema-org-factory';

package/seo/classes/schema-org-factory.d.ts

@@ -0,0 +1,88 @@
+import { CollectionPage, Product, WithContext } from 'schema-dts';
+import { ScICategory } from '../../catalog/interfaces/sc-i-category';
+import { ScIProduct } from '../../catalog/interfaces/sc-i-product';
+import { ScIVirtualCategory } from '../../catalog/interfaces/sc-i-virtual-category';
+import { ScISchemaOrgBreadcrumbList } from '../interfaces/sc-i-schema-org-breadcrumb-list';
+import * as i0 from "@angular/core";
+/**
+ * Механизмы генерации схем данных Schema.org.
+ */
+export declare class SchemaOrgFactory {
+    /**
+     * Данные о компании.
+     */
+    private readonly companyInfo;
+    /**
+     * Список ссылок приложения.
+     */
+    private readonly urls;
+    /**
+     * Пайп, возвращающий идентификатор или символьное обозначение (slug) исходя из настроек окружения.
+     */
+    private idOrSlugPipe;
+    /**
+     * Пайп для формирования полного URI изображения на media сервере.
+     */
+    private readonly mediaImageTransformerPipe;
+    /**
+     * Генерирует и возвращает схему данных для указанного продукта.
+     *
+     * @param product Данные о продукте.
+     * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
+     */
+    generateForProductItem(product: ScIProduct, productPath: string): WithContext<Product>;
+    /**
+     * Генерирует и возвращает схему данных для указанного продукта.
+     *
+     * @param category Данные о категории.
+     * @param products Данные о продуктах категории.
+     * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
+     * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
+     * @param breadcrumbs Данные о хлебных крошках для категории.
+     */
+    generateForCategoryItem(category: ScICategory | ScIVirtualCategory, products: ScIProduct[], categoryPath: string, productPath: string, breadcrumbs: ScISchemaOrgBreadcrumbList): WithContext<CollectionPage>;
+    /**
+     * Нормализует дату окончания цены в формат Schema.org (YYYY-MM-DD).
+     *
+     * @param expiredAt Дата для нормализации
+     */
+    private normalizePriceValidUntil;
+    /**
+     * Определяет доступность товара по данным продукта.
+     *
+     * @param product Данные о продукте.
+     */
+    private getAvailability;
+    /**
+     * Проверяет, является ли категория виртуальной.
+     *
+     * @param category Данные о категории для проверки.
+     */
+    private isVirtualCategory;
+    /**
+     * Возвращает URL для указанной категории.
+     *
+     * @param category Данные о категории
+     * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
+     */
+    private getCategoryCanonicalUrl;
+    /**
+     * Создаёт элемент списка ItemList с кратким Product для страницы категории.
+     *
+     * @param product Данные о продукте.
+     * @param position Позиция в списке.
+     * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
+     */
+    private createProductsListItem;
+    /**
+     * Создает mainEntity для указанной категории товаров.
+     *
+     * @param category Данные о категории.
+     * @param products Данные о товарах категории.
+     * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
+     * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
+     */
+    private createCategoryMainEntity;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SchemaOrgFactory, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SchemaOrgFactory>;
+}

package/seo/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interfaces';
+export * from './classes';
+export * from './services';
+export * from './types';

package/seo/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+export * from './sc-i-schema-org-breadcrumb-list';
+export * from './sc-i-default-page-meta';
+export * from './sc-i-seo';
+export * from './sc-i-seo-resource';

package/seo/interfaces/sc-i-default-page-meta.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Метаданные страницы по умолчанию.
+ */
+export interface ScIDefaultPageMeta {
+    /**
+     * Заголовок.
+     */
+    readonly title: string;
+    /**
+     * Описание.
+     */
+    readonly description: string;
+    /**
+     * Ключевые слова.
+     */
+    readonly keywords: string;
+}

package/seo/interfaces/sc-i-schema-org-breadcrumb-list.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Интерфейс для структурированных данных хлебных крошек согласно Schema.org.
+ *
+ * @see https://schema.org/BreadcrumbList
+ */
+export interface ScISchemaOrgBreadcrumbList {
+    /**
+     * Тип схемы Schema.org для хлебных крошек.
+     */
+    '@type': 'BreadcrumbList';
+    /**
+     * Список элементов навигации (хлебных крошек).
+     * Каждый элемент представляет один уровень навигации.
+     */
+    itemListElement: Array<{
+        /**
+         * Тип элемента списка согласно Schema.org.
+         */
+        '@type': 'ListItem';
+        /**
+         * Позиция элемента в списке навигации (начиная с 1).
+         */
+        position: number;
+        /**
+         * Отображаемое название элемента навигации.
+         */
+        name: string;
+        /**
+         * URL-адрес страницы (опционально).
+         * Если не указан, элемент считается неактивным.
+         */
+        item?: string;
+    }>;
+}

package/seo/interfaces/sc-i-seo-resource.d.ts

@@ -0,0 +1,14 @@
+import { ScISeo } from './sc-i-seo';
+/**
+ * Данные объекта имеющего seo-данные.
+ */
+export interface ScISeoResource {
+    /**
+     * Seo-данные.
+     */
+    seo?: ScISeo;
+    /**
+     * Ссылка на основное изображение.
+     */
+    image?: string;
+}

package/{catalog/dto → seo/interfaces}/sc-i-seo.d.ts

@@ -1,19 +1,8 @@
+import { ScIDefaultPageMeta } from './sc-i-default-page-meta';
 /**
- * Модель seo-данных товара/категории.
+ * Seo-данные.
  */
-export interface ScISeo {
-    /**
-     * Заголовок товара/категории.
-     */
-    title?: string;
-    /**
-     * Ключевые слова товара/категории.
-     */
-    keywords?: string;
-    /**
-     * Описание товара/категории.
-     */
-    description?: string;
+export interface ScISeo extends Partial<ScIDefaultPageMeta> {
     /**
      * Массив дополнительных значений метатегов.
      */

package/seo/services/index.d.ts

@@ -0,0 +1 @@
+export * from './sc-seo.service';

package/seo/services/sc-seo.service.d.ts

@@ -0,0 +1,125 @@
+import { Thing, WithContext } from 'schema-dts';
+import { ScICatalogItem } from '../../catalog/interfaces/sc-i-catalog-item';
+import { ScICategory } from '../../catalog/interfaces/sc-i-category';
+import { ScISeo } from '../interfaces/sc-i-seo';
+import { RobotsTagType } from '../types/robots-tag-type';
+import * as i0 from "@angular/core";
+/**
+ * Сервис управления SEO-параметрами.
+ */
+export declare class ScSeoService {
+    /**
+     * Данные о компании.
+     */
+    private readonly companyInfo;
+    /**
+     * Метаданные по умолчанию.
+     */
+    private readonly defaultSeo;
+    /**
+     * Метаданные страницы каталога по умолчанию.
+     */
+    private readonly catalogDefaultSeo;
+    /**
+     * Признак необходимости использовать Id или Slug при маршрутизации.
+     */
+    private readonly idOrSlugInRoute;
+    /**
+     * Список ссылок приложения.
+     */
+    private readonly urls;
+    /**
+     * Пайп, возвращающий идентификатор или символьное обозначение (slug) исходя из настроек окружения.
+     */
+    private idOrSlugPipe;
+    /**
+     * Пайп для формирования полного URI изображения на media сервере.
+     */
+    private readonly mediaImageTransformerPipe;
+    /**
+     * Сервис установки метаданных страницы.
+     */
+    private readonly metaService;
+    /**
+     * Сервис маршрутизации.
+     */
+    private readonly router;
+    /**
+     * Сервис управления заголовком страницы.
+     */
+    private readonly titleService;
+    /**
+     * Объект {@link Document}, предоставляющий доступ к DOM страницы.
+     */
+    private readonly document;
+    /**
+     * Фабрика для создания экземпляров {@link Renderer2}.
+     */
+    private readonly rendererFactory;
+    /**
+     * Экземпляр {@link Renderer2} для безопасной работы с DOM.
+     */
+    private readonly renderer;
+    /**
+     * Устанавливает seo параметры на основе указанного ресурса. Если какого-то тега нет, будет установлено значение по умолчанию.
+     *
+     * @param resource Ресурс на основе которого необходимо установить мета-теги.
+     * @param img Изображение. Если не пришло, то будет установлено значение по умолчанию.
+     * @param robots Список robots-тегов для страницы.
+     */
+    setFromResource(resource?: ScISeo, img?: string, robots?: RobotsTagType[]): void;
+    /**
+     * Устанавливает seo параметры со значением по умолчанию.
+     *
+     * @param title Заголовок страницы.
+     * @param robots Список robots тегов для страницы.
+     */
+    setByDefault(title?: string, robots?: RobotsTagType[]): void;
+    /**
+     * Устанавливает seo параметры со значением по умолчанию. Устанавливает значение "не индексировать" для поисковых роботов.
+     *
+     * @param title Заголовок страницы.
+     */
+    setByDefaultAsNoIndexed(title?: string): void;
+    /**
+     * Устанавливает seo-параметры для указанного элемента каталога.
+     *
+     * @param item Данные об элементе каталога.
+     * @param urlPath Url путь к элементу каталога. В пути должен присутствовать шаблон ':id', обозначающий идентификатор элемента каталога для подстановки.
+     * @param schemaOrgData Данные Schema.org элемента каталога
+     */
+    setForCategoryItem(item: ScICatalogItem<ScICategory>, urlPath: string, schemaOrgData?: WithContext<Thing>): void;
+    /**
+     * Устанавливает все meta-теги страницы. Если какой-либо из параметров не указан, для него устанавливается значение по умолчанию.
+     *
+     * @param title Заголовок страницы.
+     * @param description Описание страницы.
+     * @param keywords Ключевые слова страницы.
+     * @param meta Массив дополнительных значений метатегов.
+     * @param robots Список robots тегов для страницы.
+     */
+    private setMetaTags;
+    /**
+     * Устанавливает Open Graph meta-теги.
+     *
+     * @param ogTitle Заголовок.
+     * @param ogDescription Описание.
+     * @param ogUrl Url.
+     * @param ogImg Ссылка на изображение.
+     */
+    private setOpenGraphMetaTags;
+    /**
+     * Устанавливает тег канонической страницы <link rel="canonical" href="..." />.
+     *
+     * @param url URL который необходимо использовать в качестве ссылки.
+     */
+    private setCanonicalLink;
+    /**
+     * Устанавливает Schema.org объект страницы.
+     *
+     * @param data Данные Schema.org для встраивания на странице.
+     */
+    private setSchemaOrgData;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScSeoService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ScSeoService>;
+}

package/seo/types/index.d.ts

@@ -0,0 +1 @@
+export * from './robots-tag-type';

package/tokens/sc-default-page-meta.d.ts

@@ -1,5 +1,5 @@
 import { InjectionToken } from '@angular/core';
-import { ScIDefaultPageMeta } from '../config/sc-i-default-page-meta';
+import { ScIDefaultPageMeta } from '../seo/interfaces/sc-i-default-page-meta';
 /**
  * Токен внедрения мета-данных страницы по умолчанию.
  */

package/catalog/dto/sc-i-seo-resource.d.ts

@@ -1,10 +0,0 @@
-import { ScISeo } from '.';
-/**
- * Модель данных объекта имеющего SEO данные.
- */
-export interface ScISeoResource {
-    /**
-     * SEO данные.
-     */
-    seo?: ScISeo;
-}

package/catalog/dto/sc-seo-resource.d.ts

@@ -1,22 +0,0 @@
-import { ScISeoResourceDTO } from '../internal/sc-i-seo-resource-dto';
-import { ScISeo } from './sc-i-seo';
-import { ScISeoResource } from './sc-i-seo-resource';
-/**
- * Модель данных объекта имеющего SEO данные.
- */
-export declare class ScSeoResource implements ScISeoResource {
-    /**
-     * SEO данные.
-     */
-    seo?: ScISeo;
-    /**
-     * Ссылка на основное изображение.
-     */
-    image?: string;
-    /**
-     * Инициализирует экземпляр класса {@link ScSeoResource}.
-     *
-     * @param seoResourceDTO Данные для инициализации.
-     */
-    constructor(seoResourceDTO: ScISeoResource | ScISeoResourceDTO | null | undefined);
-}

package/catalog/internal/sc-i-category-dto.d.ts

@@ -1,48 +0,0 @@
-import { ScIConfiguratorSearchProductBase } from '../../configurator/dto/sc-i-configurator-search-product-base';
-import { ScIProperties } from '../dto/sc-i-properties';
-import { ScISeoResourceDTO } from './sc-i-seo-resource-dto';
-/**
- * Модель данных категории товаров DTO.
- */
-export interface ScICategoryDTO extends ScISeoResourceDTO {
-    /**
-     * Идентификатор категории.
-     */
-    id: number;
-    /**
-     * Символьное обозначение (slug) категории.
-     */
-    slug: string;
-    /**
-     * Название категории.
-     */
-    name: string;
-    /**
-     * Признак того, что категория является основной для некоторого товара или услуги.
-     */
-    isPrimary?: boolean;
-    /**
-     * Признак, что категория являются избранной для клиента.
-     */
-    isFavorite?: boolean;
-    /**
-     * Список свойств. Число свойств в объекте не ограничено.
-     */
-    properties?: ScIProperties;
-    /**
-     * Объект родительской категории.
-     */
-    parentCategory?: ScICategoryDTO;
-    /**
-     * Список дочерних категорий.
-     */
-    categories?: ScICategoryDTO[];
-    /**
-     * Признак наличия дочерних категорий.
-     */
-    hasChild?: boolean;
-    /**
-     * Параметры введенные в конфигуратор, при добавлении позиции в корзину.
-     */
-    configuratorParams?: ScIConfiguratorSearchProductBase;
-}

package/catalog/internal/sc-i-seo-resource-dto.d.ts

@@ -1,10 +0,0 @@
-import { ScISeo } from '../dto';
-/**
- * Модель данных объекта имеющего SEO данные.
- */
-export interface ScISeoResourceDTO {
-    /**
-     * SEO данные.
-     */
-    _Seo?: ScISeo;
-}