@snabcentr/client-core 4.8.0 → 4.10.0

package/fesm2022/snabcentr-client-core.mjs

@@ -2,7 +2,7 @@ import * as i1 from 'rxjs';
 import { of, startWith as startWith$1, Subject, ReplaySubject, partition, combineLatest, map as map$1, debounceTime, switchMap, tap, filter, shareReplay, distinctUntilChanged, BehaviorSubject, materialize, dematerialize, merge, distinctUntilKeyChanged, skip, first, catchError as catchError$1, throwError, expand, takeWhile, toArray, EMPTY, take, defaultIfEmpty, concatMap, finalize, takeUntil, timeout, interval, share, scan } from 'rxjs';
 import { map, startWith, catchError } from 'rxjs/operators';
 import { parseISO, parse, isValid, format } from 'date-fns';
-import { isString, isNil, isObject, isDate, isMatch, isArray, get, isNumber, isBoolean } from 'lodash-es';
+import { isString, isNil, isObject, isDate, isMatch, isArray, omit, get, isNumber, isBoolean } from 'lodash-es';
 import * as i0 from '@angular/core';
 import { InjectionToken, inject, PLATFORM_ID, Inject, Optional, Injectable, EventEmitter, DestroyRef, LOCALE_ID, Pipe, RESPONSE_INIT, RendererFactory2 } from '@angular/core';
 import { WA_LOCAL_STORAGE, WA_USER_AGENT, WA_WINDOW } from '@ng-web-apis/common';
@@ -7635,36 +7635,36 @@ class SchemaOrgFactory {
      *
      * @param product Данные о продукте.
      * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
      */
-    generateForProductItem(product, productPath) {
+    generateForProductItem(product, productPath, id) {
         const productUrl = `${this.urls.siteUrl}${productPath.replace(':id', this.idOrSlugPipe.transform(product).toString())}`;
         // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-        const image = this.mediaImageTransformerPipe.transform(product?.getImagePreview() ?? product.image, true);
+        const image = this.mediaImageTransformerPipe.transform(product?.getImagePreview?.() ?? product.image, true);
         const description = product.properties?.description;
         const priceValidUntil = this.normalizePriceValidUntil(product.discount?.expiredAt);
         return {
             '@context': 'https://schema.org',
             '@type': 'Product',
+            ...(id && { '@id': id }),
             name: product.name,
             ...(image && { image }),
             ...(description && { description }),
             mpn: product.code,
             url: productUrl,
-            offers: [
-                {
-                    '@type': 'Offer',
-                    priceCurrency: 'RUB',
-                    ...(priceValidUntil && { priceValidUntil }),
-                    price: product.costRub,
-                    availability: this.getAvailability(product),
-                    itemCondition: 'https://schema.org/NewCondition',
-                    seller: {
-                        '@type': 'Organization',
-                        name: this.companyInfo.name,
-                    },
-                    url: productUrl,
+            offers: {
+                '@type': 'Offer',
+                priceCurrency: 'RUB',
+                ...(priceValidUntil && { priceValidUntil }),
+                price: product.costRub,
+                availability: this.getAvailability(product),
+                itemCondition: 'https://schema.org/NewCondition',
+                seller: {
+                    '@type': 'Organization',
+                    name: this.companyInfo.name,
                 },
-            ],
+                url: productUrl,
+            },
         };
     }
     /**
@@ -7675,13 +7675,15 @@ class SchemaOrgFactory {
      * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
      * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
      * @param breadcrumbs Данные о хлебных крошках для категории.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
      */
-    generateForCategoryItem(category, products, categoryPath, productPath, breadcrumbs) {
+    generateForCategoryItem(category, products, categoryPath, productPath, breadcrumbs, id) {
         const description = category.seo?.description ?? category.properties?.description;
         const image = this.mediaImageTransformerPipe.transform(category.image, true);
         return {
             '@context': 'https://schema.org',
             '@type': 'CollectionPage',
+            ...(id && { '@id': id }),
             name: category.seo?.title ?? category.name,
             ...(description && { description }),
             url: this.getCategoryCanonicalUrl(category, categoryPath),
@@ -7699,12 +7701,6 @@ class SchemaOrgFactory {
                 name: category.name,
                 ...(description && { description }),
             },
-            // Информация о сайте.
-            isPartOf: {
-                '@type': 'WebSite',
-                name: this.companyInfo.name,
-                url: this.urls.siteUrl,
-            },
             // Связанные страницы.
             relatedLink: [
                 `${this.urls.siteUrl}${categoryPath.replace(':id', '')}`,
@@ -7745,6 +7741,223 @@ class SchemaOrgFactory {
             ],
         };
     }
+    /**
+     * Генерирует и возвращает схему данных OnlineStore на основе данных компании из окружения.
+     */
+    // eslint-disable-next-line sonarjs/function-return-type
+    generateForOrganization() {
+        const postalAddress = this.createPostalAddress(this.companyInfo.address);
+        return {
+            '@context': 'https://schema.org',
+            '@type': 'OnlineStore',
+            '@id': `${this.urls.siteUrl}#organization`,
+            name: this.companyInfo.name,
+            legalName: this.companyInfo.name,
+            url: this.urls.siteUrl,
+            logo: this.urls.logoUrl,
+            image: this.urls.logoUrl,
+            email: this.companyInfo.mail,
+            telephone: this.companyInfo.phone,
+            ...(postalAddress && { address: postalAddress }),
+            legalAddress: this.createPostalAddress({ streetAddress: this.companyInfo.legalAddress }),
+            // TODO: Перечислить все розничные магазины.
+            // hasPOS: [],
+            taxID: this.companyInfo.inn,
+            identifier: {
+                '@type': 'PropertyValue',
+                propertyID: 'OGRN',
+                value: this.companyInfo.ogrn,
+            },
+            contactPoint: this.createOrganizationContactPoints(),
+            ...(this.companyInfo.warehouseAddress.length > 0 && {
+                location: this.companyInfo.warehouseAddress.map((warehouseAddress) => ({
+                    '@type': 'Place',
+                    name: `${this.companyInfo.name} — склад самовывоза`,
+                    address: warehouseAddress,
+                })),
+            }),
+        };
+    }
+    /**
+     * Генерирует и возвращает схему данных для указанной новости.
+     *
+     * @param news Данные о новости.
+     * @param newsPath Url путь к новости. В пути должен присутствовать шаблон ':id', обозначающий идентификатор новости для подстановки.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
+     */
+    generateForNewsArticle(news, newsPath, id) {
+        const newsUrl = `${this.urls.siteUrl}${newsPath.replace(':id', news.id.toString())}`;
+        const image = this.mediaImageTransformerPipe.transform(news.image, true);
+        const headline = news.seo?.title ?? news.subject;
+        const description = news.seo?.description;
+        const datePublished = this.normalizeSchemaDate(news.createdAt);
+        const articleBody = news.text ? this.stripHtml(news.text) : undefined;
+        return {
+            '@context': 'https://schema.org',
+            '@type': 'NewsArticle',
+            ...(id && { '@id': id }),
+            headline,
+            ...(description && { description }),
+            ...(image && { image }),
+            ...(datePublished && { datePublished }),
+            ...(articleBody && { articleBody }),
+            url: newsUrl,
+            mainEntityOfPage: newsUrl,
+            author: {
+                '@type': 'Organization',
+                name: this.companyInfo.name,
+                url: this.urls.siteUrl,
+            },
+            publisher: {
+                '@type': 'Organization',
+                name: this.companyInfo.name,
+                logo: {
+                    '@type': 'ImageObject',
+                    url: this.urls.logoUrl,
+                },
+            },
+        };
+    }
+    /**
+     * Генерирует и возвращает схему данных FAQPage для страницы с вопросами и ответами.
+     *
+     * @param items Список вопросов и ответов.
+     * @param pagePath Url путь к странице FAQ.
+     * @param pageName Необязательное название страницы.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
+     */
+    generateForFaqPage(items, pagePath, pageName, id) {
+        const pageUrl = `${this.urls.siteUrl}${pagePath}`;
+        return {
+            '@context': 'https://schema.org',
+            '@type': 'FAQPage',
+            ...(id && { '@id': id }),
+            ...(pageName && { name: pageName }),
+            url: pageUrl,
+            mainEntity: items.map((item) => ({
+                '@type': 'Question',
+                name: item.question,
+                acceptedAnswer: {
+                    '@type': 'Answer',
+                    text: this.stripHtml(item.answer),
+                },
+            })),
+        };
+    }
+    /**
+     * Объединяет несколько JSON-LD сущностей в один документ с `@graph`.
+     *
+     * @param data Массив JSON-LD сущностей для объединения.
+     */
+    // eslint-disable-next-line class-methods-use-this,sonarjs/function-return-type
+    merge(data) {
+        return {
+            '@context': 'https://schema.org',
+            '@graph': data.map((item) => omit(item, '@context')),
+        };
+    }
+    /**
+     * Формирует PostalAddress из структурированного адреса компании.
+     *
+     * @param address Структурированный адрес компании.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    createPostalAddress(address) {
+        const streetAddress = [address.streetAddress, address.extendedAddress].filter(Boolean).join(', ');
+        if (!streetAddress && !address.locality && !address.region && !address.postalCode && !address.country) {
+            return undefined;
+        }
+        return {
+            '@type': 'PostalAddress',
+            ...(streetAddress && { streetAddress }),
+            ...(address.locality && { addressLocality: address.locality }),
+            ...(address.region && { addressRegion: address.region }),
+            ...(address.postalCode && { postalCode: address.postalCode }),
+            ...(address.country && { addressCountry: address.country }),
+        };
+    }
+    /**
+     * Формирует список ContactPoint для Organization.
+     */
+    createOrganizationContactPoints() {
+        const contactPoints = [
+            {
+                '@type': 'ContactPoint',
+                contactType: 'customer service',
+                telephone: this.companyInfo.phone,
+                email: this.companyInfo.mail,
+                areaServed: 'RU',
+                availableLanguage: 'Russian',
+            },
+        ];
+        if (this.companyInfo.secondaryPhone) {
+            contactPoints.push({
+                '@type': 'ContactPoint',
+                contactType: 'customer service',
+                telephone: this.companyInfo.secondaryPhone,
+                areaServed: 'RU',
+                availableLanguage: 'Russian',
+            });
+        }
+        if (this.companyInfo.hr) {
+            contactPoints.push({
+                '@type': 'ContactPoint',
+                contactType: 'HR',
+                telephone: this.companyInfo.hr.phone,
+                email: this.companyInfo.hr.mail,
+                areaServed: 'RU',
+                availableLanguage: 'Russian',
+            });
+        }
+        return contactPoints;
+    }
+    /**
+     * Удаляет HTML-разметку из текста.
+     *
+     * @param html Текст с HTML-разметкой.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    stripHtml(html) {
+        const withoutTags = html
+            .split('<')
+            .map((part, index) => {
+            if (index === 0) {
+                return part;
+            }
+            const closeTagIndex = part.indexOf('>');
+            return closeTagIndex === -1 ? part : ` ${part.slice(closeTagIndex + 1)}`;
+        })
+            .join('');
+        return withoutTags
+            .replaceAll(/\s+/g, ' ')
+            .replaceAll(/ ([.,!?;:])/g, '$1')
+            .trim();
+    }
+    /**
+     * Нормализует дату в формат Schema.org (ISO 8601).
+     *
+     * @param dateValue Дата для нормализации.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    normalizeSchemaDate(dateValue) {
+        if (!dateValue) {
+            return undefined;
+        }
+        if (/^\d{4}-\d{2}-\d{2}/.test(dateValue)) {
+            return dateValue;
+        }
+        const withTimeMatch = /^(\d{2})\.(\d{2})\.(\d{4}) (\d{2}):(\d{2})$/.exec(dateValue);
+        if (withTimeMatch) {
+            const [, day, month, year, hours, minutes] = withTimeMatch;
+            return `${year}-${month}-${day}T${hours}:${minutes}:00`;
+        }
+        const dateOnlyMatch = /^(\d{2})\.(\d{2})\.(\d{4})$/.exec(dateValue);
+        if (!dateOnlyMatch) {
+            return undefined;
+        }
+        const [, day, month, year] = dateOnlyMatch;
+        return `${year}-${month}-${day}`;
+    }
     /**
      * Нормализует дату окончания цены в формат Schema.org (YYYY-MM-DD).
      *
@@ -7766,9 +7979,9 @@ class SchemaOrgFactory {
     // eslint-disable-next-line class-methods-use-this
     getAvailability(product) {
         if (product.onOrder) {
-            return 'PreOrder';
+            return 'https://schema.org/PreOrder';
         }
-        return product.stockCount?.length ? 'InStock' : 'OutOfStock';
+        return product.stockCount?.length ? 'https://schema.org/InStock' : 'https://schema.org/OutOfStock';
     }
     /**
      * Проверяет, является ли категория виртуальной.
@@ -7812,21 +8025,19 @@ class SchemaOrgFactory {
                 url: productUrl,
                 ...(image && { image }),
                 ...(description && { description }),
-                offers: [
-                    {
-                        '@type': 'Offer',
-                        priceCurrency: 'RUB',
-                        ...(priceValidUntil && { priceValidUntil }),
-                        price: product.costRub,
-                        availability: this.getAvailability(product),
-                        itemCondition: 'https://schema.org/NewCondition',
-                        seller: {
-                            '@type': 'Organization',
-                            name: this.companyInfo.name,
-                        },
-                        url: productUrl,
+                offers: {
+                    '@type': 'Offer',
+                    priceCurrency: 'RUB',
+                    ...(priceValidUntil && { priceValidUntil }),
+                    price: product.costRub,
+                    availability: this.getAvailability(product),
+                    itemCondition: 'https://schema.org/NewCondition',
+                    seller: {
+                        '@type': 'Organization',
+                        name: this.companyInfo.name,
                     },
-                ],
+                    url: productUrl,
+                },
             },
         };
     }
@@ -7848,14 +8059,21 @@ class SchemaOrgFactory {
             itemListOrder: 'https://schema.org/ItemListUnordered',
             itemListElement: [
                 // Добавляем подкатегории в начало списка.
-                ...childCategories.slice(0, 5).map((subCategory, index) => ({
-                    '@type': 'ListItem',
-                    position: index + 1,
-                    name: subCategory.name,
-                    url: this.getCategoryCanonicalUrl(subCategory, categoryPath),
-                    image: this.mediaImageTransformerPipe.transform(subCategory.image, true),
-                    description: subCategory.seo?.description ?? subCategory.properties?.description,
-                })),
+                ...childCategories.slice(0, 5).map((subCategory, index) => {
+                    const image = this.mediaImageTransformerPipe.transform(subCategory.image, true);
+                    const description = subCategory.seo?.description ?? subCategory.properties?.description;
+                    return {
+                        '@type': 'ListItem',
+                        position: index + 1,
+                        item: {
+                            '@type': 'CollectionPage',
+                            name: subCategory.name,
+                            url: this.getCategoryCanonicalUrl(subCategory, categoryPath),
+                            ...(image && { image }),
+                            ...(description && { description }),
+                        },
+                    };
+                }),
                 // Добавляем товары после подкатегорий.
                 ...products.slice(0, 10).map((product, index) => this.createProductsListItem(product, childCategories.length + index + 1, productPath)),
             ],
@@ -7868,37 +8086,46 @@ class SchemaOrgFactory {
      * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
      */
     createCatalogBreadcrumbsList(breadcrumbs, categoryPath) {
+        const catalogUrl = `${this.urls.siteUrl}${categoryPath.replace(':id', '')}`;
         const breadcrumbItems = [
             // Всегда добавляем главную страницу.
-            {
-                '@type': 'ListItem',
-                position: 1,
-                name: 'Главная',
-                item: this.urls.siteUrl,
-            },
+            this.createBreadcrumbListItem(1, 'Главная', this.urls.siteUrl),
             // Добавляем каталог.
-            {
-                '@type': 'ListItem',
-                position: 2,
-                name: 'Каталог',
-                item: `${this.urls.siteUrl}/${categoryPath}`,
-            },
+            this.createBreadcrumbListItem(2, 'Каталог', catalogUrl),
         ];
         // Добавляем существующие breadcrumbs с корректировкой позиций.
         breadcrumbs.forEach((item, index) => {
             const link = isArray(item.routerLink) ? item.routerLink.join('/') : item.routerLink;
-            breadcrumbItems.push({
-                '@type': 'ListItem',
-                position: index + 3, // Начинаем с позиции 3 (после Главная и Каталог).
-                name: item.label,
-                item: link ? `${this.urls.siteUrl}/${link}` : undefined,
-            });
+            breadcrumbItems.push(this.createBreadcrumbListItem(index + 3, item.label, link ? `${this.urls.siteUrl}/${link}` : undefined));
         });
         return {
             '@type': 'BreadcrumbList',
+            itemListOrder: 'https://schema.org/ItemListOrderAscending',
             itemListElement: breadcrumbItems,
         };
     }
+    /**
+     * Создаёт элемент BreadcrumbList в формате, рекомендованном Schema.org.
+     *
+     * @param position Позиция элемента в цепочке.
+     * @param name Название элемента.
+     * @param url URL элемента.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    createBreadcrumbListItem(position, name, url) {
+        return {
+            '@type': 'ListItem',
+            position,
+            ...(url
+                ? {
+                    item: {
+                        '@id': url,
+                        name,
+                    },
+                }
+                : { name }),
+        };
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.16", ngImport: i0, type: SchemaOrgFactory, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.16", ngImport: i0, type: SchemaOrgFactory, providedIn: 'root' }); }
 }
@@ -7954,6 +8181,10 @@ class ScSeoService {
          * Объект {@link Document}, предоставляющий доступ к DOM страницы.
          */
         this.document = inject(DOCUMENT);
+        /**
+         * Фабрика для создания данных Schema.org.
+         */
+        this.schemaOrgFactory = inject(SchemaOrgFactory);
         /**
          * Фабрика для создания экземпляров {@link Renderer2}.
          */
@@ -7969,8 +8200,9 @@ class ScSeoService {
      * @param resource Ресурс на основе которого необходимо установить мета-теги.
      * @param img Изображение. Если не пришло, то будет установлено значение по умолчанию.
      * @param robots Список robots-тегов для страницы.
+     * @param schemaOrgData Данные Schema.org для встраивания на странице.
      */
-    setFromResource(resource, img = this.urls.logoUrl, robots = ['index', 'follow']) {
+    setFromResource(resource, img, robots, schemaOrgData) {
         const updatedResource = {
             title: this.replaceTemplates(resource?.title ?? this.defaultSeo.title, resource?.instanceData ?? {}),
             description: this.replaceTemplates(resource?.description ?? this.defaultSeo.description, resource?.instanceData ?? {}),
@@ -7978,21 +8210,24 @@ class ScSeoService {
             meta: resource?.meta ?? [],
         };
         const url = `${this.urls.siteUrl}${this.router.url}`;
-        this.setMetaTags(updatedResource.title, updatedResource.description, updatedResource.keywords, updatedResource.meta, robots);
-        this.setOpenGraphMetaTags(updatedResource.title, updatedResource.description, url, img);
+        this.setMetaTags(updatedResource.title, updatedResource.description, updatedResource.keywords, updatedResource.meta, robots ?? ['index', 'follow']);
+        this.setOpenGraphMetaTags(updatedResource.title, updatedResource.description, url, img ?? this.urls.logoUrl);
         this.setCanonicalLink(url);
+        // Устанавливаем Schema.org параметры.
+        this.setSchemaOrgData(this.schemaOrgFactory.merge([this.schemaOrgFactory.generateForOrganization(), ...(schemaOrgData ? [schemaOrgData] : [])]));
     }
     /**
      * Устанавливает seo параметры со значением по умолчанию.
      *
      * @param title Заголовок страницы.
      * @param robots Список robots тегов для страницы.
+     * @param schemaOrgData Данные Schema.org для встраивания на странице.
      */
-    setByDefault(title, robots = ['index', 'follow']) {
+    setByDefault(title, robots, schemaOrgData) {
         this.setFromResource({
             title: `${title ?? this.defaultSeo.title} - ${this.companyInfo.name}`,
             description: title ? `${title}, ${this.defaultSeo.description}` : this.defaultSeo.description,
-        }, this.urls.logoUrl, robots);
+        }, this.urls.logoUrl, robots ?? ['index', 'follow'], schemaOrgData);
     }
     /**
      * Устанавливает seo параметры со значением по умолчанию. Устанавливает значение "не индексировать" для поисковых роботов.
@@ -8023,9 +8258,7 @@ class ScSeoService {
         this.setOpenGraphMetaTags(title, description, url, this.mediaImageTransformerPipe.transform(item.image, true));
         this.setCanonicalLink(url);
         // Устанавливаем Schema.org параметры.
-        if (schemaOrgData) {
-            this.setSchemaOrgData(schemaOrgData);
-        }
+        this.setSchemaOrgData(this.schemaOrgFactory.merge([this.schemaOrgFactory.generateForOrganization(), ...(schemaOrgData ? [schemaOrgData] : [])]));
     }
     /**
      * Заменяет шаблоны в тексте на значения из объекта.