@snabcentr/client-core 2.64.2 → 2.65.0

package/cart/internal/sc-i-cart-item-dto.d.ts

@@ -1,4 +1,4 @@
-import { ScIProductDTO } from '../../catalog/internal/sc-i-product-dto';
+import { ScIProduct } from '../../catalog/interfaces/sc-i-product';
 import { ScIConfiguratorSearchProductBase } from '../../configurator/dto/sc-i-configurator-search-product-base';
 /**
  * DTO единичной позиции товара/услуги в корзине.
@@ -13,7 +13,7 @@ export interface ScICartItemDTO {
     /**
      * Данные о товаре. Равен `null` если товар отсутствует.
      */
-    product: ScIProductDTO | null;
+    product: ScIProduct | null;
     /**
      * Количество товара/услуги.
      */

package/catalog/classes/index.d.ts

@@ -1,2 +1,3 @@
 export * from './sc-cached-data';
 export * from './sc-cached-item';
+export * from './sc-catalog-item';

package/catalog/classes/sc-catalog-item.d.ts

@@ -0,0 +1,31 @@
+import { ScCatalogableItem } from '../../common/classes/sc-catalogable-item';
+import { ScISeo } from '../../seo/interfaces/sc-i-seo';
+import { ScIProperties } from '../dto/sc-i-properties';
+import { ScICatalogItem } from '../interfaces/sc-i-catalog-item';
+/**
+ * Данные об элементе каталога.
+ */
+export declare class ScCatalogItem<P> extends ScCatalogableItem implements ScICatalogItem<P> {
+    /**
+     * @inheritDoc
+     */
+    parentCategory?: P;
+    /**
+     * @inheritDoc
+     */
+    properties?: ScIProperties;
+    /**
+     * @inheritDoc
+     */
+    seo?: ScISeo;
+    /**
+     * @inheritDoc
+     */
+    image?: string;
+    /**
+     * Инициализирует экземпляр класса {@link ScCatalogItem}.
+     *
+     * @param data Данные для первоначальной инициализации.
+     */
+    constructor(data?: ScICatalogItem<P>);
+}

package/catalog/dto/index.d.ts

@@ -1,9 +1,7 @@
 export * from './sc-i-discount';
 export * from './sc-i-product-images';
-export * from './sc-i-seo';
 export * from './sc-i-properties';
 export * from './sc-category';
 export * from './sc-product';
 export * from './sc-virtual-category';
-export * from './sc-seo-resource';
 export * from './sc-i-product-notify-when-in-stock';

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

@@ -1,13 +1,12 @@
 import { ScIConfiguratorSettingsBase } from '../../configurator/dto/sc-i-configurator-settings-base';
-import { ScICategoryDTO } from '../internal/sc-i-category-dto';
+import { ScCatalogItem } from '../classes/sc-catalog-item';
+import { ScICategory } from '../interfaces/sc-i-category';
+import { ScIProduct } from '../interfaces/sc-i-product';
 import { ScIFilterTreeCategory } from '../internal/sc-i-filter-tree-category';
-import { ScIProperties } from './sc-i-properties';
-import { ScProduct } from './sc-product';
-import { ScSeoResource } from './sc-seo-resource';
 /**
  * Модель данных категории товаров.
  */
-export declare class ScCategory extends ScSeoResource implements ScICategoryDTO {
+export declare class ScCategory extends ScCatalogItem<ScICategory> implements ScICategory {
     /**
      * Признак, что категория является избранной для клиента.
      *
@@ -15,57 +14,35 @@ export declare class ScCategory extends ScSeoResource implements ScICategoryDTO
      */
     get isFavorite(): boolean;
     /**
-     * Идентификатор категории.
+     * @inheritDoc
      */
-    id: number;
+    isHidden: boolean;
     /**
-     * Символьное обозначение (slug) категории.
-     */
-    slug: string;
-    /**
-     * Название категории.
-     */
-    name: string;
-    /**
-     * Признак того, что категория является основной для некоторого товара или услуги.
+     * @inheritDoc
      */
     isPrimary?: boolean;
     /**
-     * Список свойств. Число свойств в объекте не ограничено.
+     * @inheritDoc
      */
-    properties?: ScIProperties;
+    categories?: ScICategory[];
     /**
-     * Объект родительской категории.
+     * @inheritDoc
      */
-    parentCategory?: ScCategory;
+    products?: ScIProduct[];
     /**
-     * Список дочерних категорий.
+     * @inheritDoc
      */
-    categories?: ScCategory[];
+    hasChild?: boolean;
     /**
-     * Признак наличия дочерних категорий.
+     * @inheritDoc
      */
-    hasChild?: boolean;
+    configuratorSettings?: ScIConfiguratorSettingsBase;
     /**
      * Дата загрузки категории.
      *
      * @deprecated
      */
     loadedAt?: Date;
-    /**
-     * Признак, что информация о категории загружается.
-     *
-     * @deprecated
-     */
-    isLoading: boolean;
-    /**
-     * Список товаров в категории.
-     */
-    products?: ScProduct[];
-    /**
-     * Настройки конфигуратора.
-     */
-    configuratorSettings?: ScIConfiguratorSettingsBase;
     /**
      * Признак, что в категории необходимо отобразить конфигуратор.
      */
@@ -76,12 +53,6 @@ export declare class ScCategory extends ScSeoResource implements ScICategoryDTO
      * @deprecated
      */
     filter?: ScIFilterTreeCategory | '*';
-    /**
-     * Признак, что категория является скелетоном.
-     *
-     * @deprecated
-     */
-    isSkeleton: boolean;
     /**
      * Признак, что категория является избранной для клиента.
      */
@@ -89,9 +60,9 @@ export declare class ScCategory extends ScSeoResource implements ScICategoryDTO
     /**
      * Инициализирует экземпляр класса {@link ScCategory}.
      *
-     * @param categoryDTO DTO с данными о категории товаров.
+     * @param data DTO с данными о категории товаров.
      */
-    constructor(categoryDTO: ScICategoryDTO);
+    constructor(data: ScICategory);
     /**
      * Возвращает среднюю стоимость м2.
      */
@@ -100,10 +71,6 @@ export declare class ScCategory extends ScSeoResource implements ScICategoryDTO
      * Признак, что в категории есть товары для отображения.
      */
     get isNotHiddenProducts(): boolean;
-    /**
-     * Признак, что в категории или вложенных подкатегориях есть товары для отображения.
-     */
-    get isNotHiddenProductsIncludeSubcategories(): boolean;
     /**
      * Признак, что категория является избранной для клиента.
      *
@@ -155,7 +122,7 @@ export declare class ScCategory extends ScSeoResource implements ScICategoryDTO
      * @param sortFcn Функция сортировки товаров.
      * @deprecated
      */
-    sortProduct(sortFcn: ((a: ScProduct, b: ScProduct) => number) | undefined): void;
+    sortProduct(sortFcn: ((a: ScIProduct, b: ScIProduct) => number) | undefined): void;
     /**
      * Устанавливает флаг избранных товаров клиента всем вложенным позициям на основе флага из родительской категории.
      *

package/catalog/dto/sc-product.d.ts

@@ -3,105 +3,84 @@ import { ScICurrency } from '../../references/dto/sc-i-currency';
 import { ScIProductUnit } from '../../references/dto/sc-i-product-unit';
 import { ScIWarehouseStockCount } from '../../warehouse/dto/sc-i-warehouse-stock-count';
 import { ScIWarehouse } from '../../warehouse/dto/sc-warehouse';
-import { ScIProductDTO } from '../internal/sc-i-product-dto';
+import { ScCatalogItem } from '../classes/sc-catalog-item';
+import { ScICategory } from '../interfaces/sc-i-category';
+import { ScIProduct } from '../interfaces/sc-i-product';
 import { ScPriceHistory } from '../types/sc-price-history';
-import { ScCategory } from './sc-category';
 import { ScIDiscount } from './sc-i-discount';
 import { ScIProductImages } from './sc-i-product-images';
-import { ScIProperties } from './sc-i-properties';
-import { ScSeoResource } from './sc-seo-resource';
 /**
  * Модель данных товара/услуги.
  */
-export declare class ScProduct extends ScSeoResource implements ScIProductDTO {
+export declare class ScProduct extends ScCatalogItem<ScICategory> implements ScIProduct {
     /**
-     * Идентификатор товара/услуги.
+     * @inheritDoc
      */
-    id: number;
+    isHidden: boolean;
     /**
-     * Символьное обозначение (slug) товара.
-     */
-    slug: string;
-    /**
-     * Артикул.
-     */
-    code: string;
-    /**
-     * Артикул поставщика.
+     * @inheritDoc
      */
     supplierSku?: string;
     /**
-     * Название товара.
-     */
-    name: string;
-    /**
-     * Стоимость товара или услуги в валюте.
+     * С@inheritDoc
      */
     cost?: number;
     /**
-     * Стоимость товара или услуги в рублях.
+     * @inheritDoc
      */
     costRub?: number;
     /**
-     * Дата установки цены.
+     * @inheritDoc
      */
     costDate?: string;
     /**
-     * Валюта товара или услуги.
+     * @inheritDoc
      */
     currency: ScICurrency;
     /**
-     * Единица измерения.
+     * @inheritDoc
      */
     unit: ScIProductUnit;
     /**
-     * Минимальное количество товара для заказа.
+     * @inheritDoc
      */
     minCount?: number;
     /**
-     * Данные о количество товара, доступном на складах.
+     * @inheritDoc
      */
     stockCount?: ScIWarehouseStockCount[];
     /**
-     * Признак товара "Под заказ".
+     * @inheritDoc
      */
     onOrder?: boolean;
     /**
-     * Норма упаковки.
+     * @inheritDoc
      */
     pack?: string;
     /**
-     * Признак, что товар, услуга или категория являются избранными для клиента.
+     * @inheritDoc
      */
     isFavorite: boolean;
     /**
-     * Признак, что товар или услуга, был ранее заказан.
+     * @inheritDoc
      */
     isPreviouslyOrdered?: boolean;
     /**
-     * Список изображений.
+     * @inheritDoc
      */
     readonly images?: readonly ScIProductImages[];
     /**
-     * Список категорий товара.
+     * @inheritDoc
      */
-    categories: ScCategory[];
+    categories: ScICategory[];
     /**
-     * Список свойств. Число свойств в объекте не ограничено.
-     */
-    properties?: ScIProperties;
-    /**
-     * Данные о клиентской скидке.
+     * @inheritDoc
      */
     discount?: ScIDiscount;
     /**
-     * Родительская категория, в которой находится товар или услуга.
-     */
-    parentCategory?: ScCategory;
-    /**
-     * Основная категория для товара или услуги.
+     * @inheritDoc
      */
-    primaryCategory?: ScCategory;
+    primaryCategory?: ScICategory;
     /**
      * Признак наличия изображения у товара.
      */
@@ -130,17 +109,13 @@ export declare class ScProduct extends ScSeoResource implements ScIProductDTO {
      * Признак необходимости игнорировать проверку минимального количества и кратности при добавлении товара в корзину и создании заказа.
      */
     ignoreMinCountCheck: boolean;
-    /**
-     * Признак того, что продукт является скрытым.
-     */
-    isHidden?: boolean;
     /**
      * Инициализирует экземпляр класса {@link ScProduct}.
      *
-     * @param productDTO Данные о продукте.
+     * @param data Данные о продукте.
      * @param ord Порядок следования продукта в списке.
      */
-    constructor(productDTO: ScIProductDTO | null, ord?: number);
+    constructor(data: ScIProduct | null, ord?: number);
     /**
      * Стоимость товара или услуги с валютой и единицей измерения.
      */

package/catalog/dto/sc-virtual-category.d.ts

@@ -1,44 +1,27 @@
-import { ScIVirtualCategoryDTO } from '../internal/sc-i-virtual-category-dto';
-import { ScCategory } from './sc-category';
-import { ScIProperties } from './sc-i-properties';
-import { ScProduct } from './sc-product';
-import { ScSeoResource } from './sc-seo-resource';
+import { ScCatalogItem } from '../classes/sc-catalog-item';
+import { ScICategory } from '../interfaces/sc-i-category';
+import { ScIProduct } from '../interfaces/sc-i-product';
+import { ScIVirtualCategory } from '../interfaces/sc-i-virtual-category';
 /**
  * Данные о виртуальной категории.
  */
-export declare class ScVirtualCategory extends ScSeoResource implements ScIVirtualCategoryDTO {
+export declare class ScVirtualCategory extends ScCatalogItem<ScIVirtualCategory> implements ScIVirtualCategory {
     /**
-     * Название категории.
+     * @inheritDoc
      */
-    name: string;
+    childCategories?: ScIVirtualCategory[];
     /**
-     * Символьный идентификатор виртуальной категории.
+     * @inheritDoc
      */
-    slug: string;
+    products?: ScIProduct[];
     /**
-     * Список свойств. Число свойств в объекте не ограничено.
+     * @inheritDoc
      */
-    properties?: ScIProperties;
-    /**
-     * Данные о родительской виртуальной категории.
-     */
-    parentCategory?: ScVirtualCategory;
-    /**
-     * Список дочерних виртуальных категорий.
-     */
-    childCategories?: ScVirtualCategory[];
-    /**
-     * Список продуктов привязанных к виртуальной категории.
-     */
-    products?: ScProduct[];
-    /**
-     * Список категорий продуктов привязанных к виртуальной категории.
-     */
-    productCategories?: ScCategory[];
+    productCategories?: ScICategory[];
     /**
      * Инициализирует экземпляр класса {@link ScVirtualCategory}.
      *
-     * @param virtualCategoryDTO Данные о виртуальной категории.
+     * @param data Данные о виртуальной категории.
      */
-    constructor(virtualCategoryDTO: ScIVirtualCategoryDTO);
+    constructor(data: ScIVirtualCategory);
 }

package/catalog/interfaces/index.d.ts

@@ -1,3 +1,7 @@
+export * from './sc-i-catalog-item';
+export * from './sc-i-product';
+export * from './sc-i-category';
+export * from './sc-i-virtual-category';
 export * from './sc-i-category-product-params';
 export * from './sc-i-category-products-pagination-params';
 export * from './sc-catalog-filter';

package/catalog/interfaces/sc-i-catalog-item.d.ts

@@ -0,0 +1,16 @@
+import { ScICatalogableItem } from '../../common/interfaces/sc-i-catalogable-item';
+import { ScISeoResource } from '../../seo/interfaces/sc-i-seo-resource';
+import { ScIProperties } from '../dto/sc-i-properties';
+/**
+ * Данные об элементе каталога.
+ */
+export interface ScICatalogItem<P> extends ScICatalogableItem, ScISeoResource {
+    /**
+     * Данные о родительской категории.
+     */
+    parentCategory?: P;
+    /**
+     * Список свойств. Число свойств в объекте не ограничено.
+     */
+    properties?: ScIProperties;
+}

package/catalog/interfaces/sc-i-category.d.ts

@@ -0,0 +1,29 @@
+import { ScIPrimaryCatalogableItem } from '../../common/interfaces/sc-i-primary-catalogable-item';
+import { ScIConfiguratorSearchProductBase } from '../../configurator/dto/sc-i-configurator-search-product-base';
+import { ScICatalogItem } from './sc-i-catalog-item';
+import { ScIProduct } from './sc-i-product';
+/**
+ * Данные о категории товаров.
+ */
+export interface ScICategory extends ScICatalogItem<ScICategory>, ScIPrimaryCatalogableItem {
+    /**
+     * Признак, что категория являются избранной для клиента.
+     */
+    isFavorite?: boolean;
+    /**
+     * Список дочерних категорий.
+     */
+    categories?: ScICategory[];
+    /**
+     * Список товаров в категории.
+     */
+    products?: ScIProduct[];
+    /**
+     * Признак наличия дочерних категорий.
+     */
+    hasChild?: boolean;
+    /**
+     * Параметры введенные в конфигуратор, при добавлении позиции в корзину.
+     */
+    configuratorSettings?: ScIConfiguratorSearchProductBase;
+}

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

@@ -1,35 +1,20 @@
+import { ScIHiddenCatalogableItem } from '../../common/interfaces/sc-i-hidden-catalogable-item';
 import { ScICurrency } from '../../references/dto/sc-i-currency';
 import { ScIProductUnit } from '../../references/dto/sc-i-product-unit';
+import { ScISeoResource } from '../../seo/interfaces/sc-i-seo-resource';
 import { ScIWarehouseStockCount } from '../../warehouse/dto/sc-i-warehouse-stock-count';
 import { ScIDiscount } from '../dto/sc-i-discount';
 import { ScIProductImages } from '../dto/sc-i-product-images';
-import { ScIProperties } from '../dto/sc-i-properties';
-import { ScICategoryDTO } from './sc-i-category-dto';
-import { ScISeoResourceDTO } from './sc-i-seo-resource-dto';
+import { ScICatalogItem } from './sc-i-catalog-item';
+import { ScICategory } from './sc-i-category';
 /**
  * Модель данных для товаров каталога.
  */
-export interface ScIProductDTO extends ScISeoResourceDTO {
-    /**
-     * Идентификатор товара/услуги.
-     */
-    id: number;
-    /**
-     * Символьное обозначение (slug) категории.
-     */
-    slug: string;
-    /**
-     * Артикул.
-     */
-    code: string;
+export interface ScIProduct extends ScICatalogItem<ScICategory>, ScIHiddenCatalogableItem, ScISeoResource {
     /**
      * Артикул поставщика.
      */
     supplierSku?: string;
-    /**
-     * Название товара.
-     */
-    name: string;
     /**
      * Стоимость товара или услуги в валюте.
      */
@@ -81,17 +66,13 @@ export interface ScIProductDTO extends ScISeoResourceDTO {
     /**
      * Список категорий товара.
      */
-    categories: ScICategoryDTO[];
-    /**
-     * Список свойств. Число свойств в объекте не ограничено.
-     */
-    properties?: ScIProperties;
+    categories: ScICategory[];
     /**
      * Данные о клиентской скидке.
      */
     discount?: ScIDiscount;
     /**
-     * Признак того, что продукт является скрытым.
+     * Основная категория для товара или услуги.
      */
-    isHidden?: boolean;
+    primaryCategory?: ScICategory;
 }

package/catalog/interfaces/sc-i-virtual-category.d.ts

@@ -0,0 +1,20 @@
+import { ScICatalogItem } from './sc-i-catalog-item';
+import { ScICategory } from './sc-i-category';
+import { ScIProduct } from './sc-i-product';
+/**
+ * Данные о виртуальной категории.
+ */
+export interface ScIVirtualCategory extends ScICatalogItem<ScIVirtualCategory> {
+    /**
+     * Список дочерних виртуальных категорий.
+     */
+    childCategories?: ScIVirtualCategory[];
+    /**
+     * Список продуктов привязанных к виртуальной категории.
+     */
+    products?: ScIProduct[];
+    /**
+     * Список категорий продуктов привязанных к виртуальной категории.
+     */
+    productCategories?: ScICategory[];
+}

package/catalog/internal/index.d.ts

@@ -1,5 +1 @@
-export * from './sc-i-category-dto';
 export * from './sc-i-filter-tree-category';
-export * from './sc-i-product-dto';
-export * from './sc-i-virtual-category-dto';
-export * from './sc-i-seo-resource-dto';

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

@@ -11,6 +11,7 @@ import { ScIProductNotifyWhenInStock } from '../dto/sc-i-product-notify-when-in-
 import { ScProduct } from '../dto/sc-product';
 import { ScVirtualCategory } from '../dto/sc-virtual-category';
 import { ScMimeTypes } from '../enums/sc-mime-types';
+import { ScICategory } from '../interfaces/sc-i-category';
 import { ScICategoryProductParams } from '../interfaces/sc-i-category-product-params';
 import { ScICategoryProductPaginationParams } from '../interfaces/sc-i-category-products-pagination-params';
 import { ScPriceHistory } from '../types/sc-price-history';
@@ -111,7 +112,7 @@ export declare class ScCatalogService {
     /**
      * Возвращает {@link Observable} корневых категорий с настройками отображения, чтобы реагировать на изменения.
      */
-    getFilteredRootCategories$(): Observable<ScCategory[]>;
+    getFilteredRootCategories$(): Observable<ScICategory[]>;
     /**
      * Возвращает {@link Observable} содержимого виртуальной категории.
      *
@@ -131,7 +132,7 @@ export declare class ScCatalogService {
     /**
      * Создает запрос получения корневых категорий.
      */
-    getRootCategories$(): Observable<ScCategory[] | null>;
+    getRootCategories$(): Observable<ScICategory[] | null>;
     /**
      * Раскрывает каталог до указанной категории.
      *

package/catalog/services/sc-favorite.service.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { ScCategory } from '../dto';
+import { ScCategory } from '../dto/sc-category';
 import * as i0 from "@angular/core";
 /**
  * Сервис для работы с избранными товарами и категориями.

package/common/classes/index.d.ts

@@ -1 +1,10 @@
+export * from './sc-identity';
+export * from './sc-named-identity';
+export * from './sc-coded-identity';
+export * from './sc-reference';
+export * from './sc-updatable-named-identity';
+export * from './sc-deletable-named-identity';
 export * from './sc-image';
+export * from './sc-catalogable-item';
+export * from './sc-hidden-catalogable-item';
+export * from './sc-primary-catalogable-item';

package/common/classes/sc-catalogable-item.d.ts

@@ -0,0 +1,17 @@
+import { ScICatalogableItem } from '../interfaces/sc-i-catalogable-item';
+import { ScCodedIdentity } from './sc-coded-identity';
+/**
+ * Данные об элементе каталога.
+ */
+export declare class ScCatalogableItem extends ScCodedIdentity implements ScICatalogableItem {
+    /**
+     * @inheritDoc
+     */
+    slug: string;
+    /**
+     * Инициализирует экземпляр класса {@link ScCatalogableItem}.
+     *
+     * @param data Данные для первоначальной инициализации.
+     */
+    protected constructor(data?: ScICatalogableItem);
+}

package/common/classes/sc-coded-identity.d.ts

@@ -0,0 +1,17 @@
+import { ScICodedIdentity } from '../interfaces/sc-i-coded-identity';
+import { ScNamedIdentity } from './sc-named-identity';
+/**
+ * Базовая идентифицируемая сущность содержащая название и артикул.
+ */
+export declare class ScCodedIdentity<T = number> extends ScNamedIdentity<T> implements ScICodedIdentity<T> {
+    /**
+     * @inheritDoc
+     */
+    code: string;
+    /**
+     * Инициализирует экземпляр класса {@link ScCodedIdentity}.
+     *
+     * @param data Данные для первоначальной инициализации.
+     */
+    constructor(data?: Partial<ScICodedIdentity<T>>);
+}

package/common/classes/sc-deletable-named-identity.d.ts

@@ -0,0 +1,17 @@
+import { ScIDeletableNamedIdentity } from '../interfaces/sc-i-deletable-named-identity';
+import { ScUpdatableNamedIdentity } from './sc-updatable-named-identity';
+/**
+ * Базовая идентифицируемая сущность содержащая название, дату изменения и удаления.
+ */
+export declare abstract class ScDeletableNamedIdentity extends ScUpdatableNamedIdentity implements ScIDeletableNamedIdentity {
+    /**
+     * @inheritDoc
+     */
+    deletedAt?: Date;
+    /**
+     * Инициализирует экземпляр класса {@link ScUpdatableNamedIdentity}.
+     *
+     * @param data Данные для первоначальной инициализации.
+     */
+    protected constructor(data?: ScIDeletableNamedIdentity);
+}