@snabcentr/client-core 3.10.0 → 3.11.0

package/fesm2022/snabcentr-client-core.mjs

@@ -7741,12 +7741,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', '')}`,
@@ -7824,6 +7818,72 @@ class SchemaOrgFactory {
             }),
         };
     }
+    /**
+     * Генерирует и возвращает схему данных для указанной новости.
+     *
+     * @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`.
      *
@@ -7891,6 +7951,53 @@ class SchemaOrgFactory {
         }
         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).
      *
@@ -8133,8 +8240,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 ?? {}),
@@ -8142,23 +8250,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.generateForOrganization());
+        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 параметры со значением по умолчанию. Устанавливает значение "не индексировать" для поисковых роботов.