@snabcentr/client-core 2.66.14 → 3.0.1-dev

package/order/classes/index.d.ts

@@ -3,7 +3,8 @@ export * from './sc-order-base';
 export * from './sc-order-draft';
 export * from './sc-order-draft-short';
 export * from './sc-order-delivery';
-export * from './sc-order-history';
+export * from './sc-order-history-user';
+export * from './sc-i-order-history';
 export * from './sc-order-item';
 export * from './sc-order-payment';
 export * from './sc-order-short';

package/order/classes/sc-i-order-history.d.ts

@@ -0,0 +1,23 @@
+import { ScIReferencesTypes, ScOrderStateStatus } from '../../references';
+import { ScIOrderHistoryUser } from './sc-order-history-user';
+/**
+ * Запись истории изменения статуса заказа.
+ */
+export interface ScIOrderHistory {
+    /**
+     * Краткие данные о пользователе.
+     */
+    user: ScIOrderHistoryUser;
+    /**
+     * Данные о статусе заказа из справочника.
+     */
+    status: ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>;
+    /**
+     * Данные детализирующего статуса заказа.
+     */
+    statusDetail?: ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>;
+    /**
+     * Дата и время изменения статуса в формате `Y-m-d H:i:s`.
+     */
+    createdAt: string;
+}

package/order/classes/sc-order-history-user.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Краткие данные о пользователе в записи истории статуса заказа.
+ */
+export interface ScIOrderHistoryUser {
+    /**
+     * Тип пользователя.
+     */
+    type: string;
+    /**
+     * ФИО пользователя.
+     */
+    name: string;
+    /**
+     * Номер телефона в международном формате, например +7XXXXXXXXXX или +375XXXXXXXXX.
+     */
+    phone: string;
+    /**
+     * Адрес электронной почты.
+     */
+    email: string;
+}

package/order/classes/sc-order-short.d.ts

@@ -1,4 +1,4 @@
-import { ScOrderStateStatus } from '../../references';
+import { ScIReferencesTypes, ScISalesDirection, ScOrderStateStatus } from '../../references';
 import { ScIOrderShort } from '../internal';
 import { ScOrderBase } from './sc-order-base';
 import { ScIOrderDelivery } from './sc-order-delivery';
@@ -10,11 +10,15 @@ export declare class ScOrderShort extends ScOrderBase implements ScIOrderShort {
     /**
      * @inheritDoc
      */
-    status: ScOrderStateStatus;
+    status: ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>;
     /**
      * @inheritDoc
      */
-    direction: number;
+    statusDetail: ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>;
+    /**
+     * @inheritDoc
+     */
+    salesDirection: ScISalesDirection;
     /**
      * @inheritDoc
      */

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

@@ -1,7 +1,9 @@
 import { ScContragent } from '../../contragent/dto/sc-contragent';
+import { ScIReferencesTypes } from '../../references';
+import { ScOrderStateStatus } from '../../references/enums/sc-order-state-status';
 import { ScDeliveryType, ScPaymentType } from '../enums';
 import { ScIOrder } from '../internal';
-import { ScIOrderHistory } from './sc-order-history';
+import { ScIOrderHistory } from './sc-i-order-history';
 import { ScOrderItem } from './sc-order-item';
 import { ScOrderShort } from './sc-order-short';
 /**
@@ -12,6 +14,14 @@ export declare class ScOrder extends ScOrderShort implements ScIOrder {
      * @inheritDoc
      */
     products: ScOrderItem[];
+    /**
+     * @inheritDoc
+     */
+    nextStatuses?: Array<ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>>;
+    /**
+     * @inheritDoc
+     */
+    tags?: string[];
     /**
      * @inheritDoc
      */
@@ -45,7 +55,7 @@ export declare class ScOrder extends ScOrderShort implements ScIOrder {
          */
         name: string;
         /**
-         * Номер телефона. В формате "79203436527" или "+79203436527".
+         * Номер телефона в международном формате, например `+7XXXXXXXXXX`.
          */
         phone: string;
         /**

package/order/internal/sc-i-order-base.d.ts

@@ -7,7 +7,7 @@ export interface ScIOrderBase {
      */
     id: number;
     /**
-     * Дата и время создания заказа.
+     * Дата и время создания заказа в формате `Y-m-d H:i:s`.
      */
     createdAt: string;
     /**

package/order/internal/sc-i-order-short.d.ts

@@ -1,4 +1,4 @@
-import { ScOrderStateStatus } from '../../references';
+import { ScIReferencesTypes, ScISalesDirection, ScOrderStateStatus } from '../../references';
 import { ScIOrderDelivery } from '../classes/sc-order-delivery';
 import { ScIOrderPayment } from '../classes/sc-order-payment';
 import { ScOrderShort } from '../classes/sc-order-short';
@@ -10,11 +10,15 @@ export interface ScIOrderShort extends ScIOrderBase {
     /**
      * Идентификатор статуса.
      */
-    status: ScOrderStateStatus;
+    status: ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>;
     /**
-     * Направление продаж.
+     * Детализирующий статус заказа.
      */
-    direction: number;
+    statusDetail: ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>;
+    /**
+     * Данные о направлении продаж.
+     */
+    salesDirection: ScISalesDirection;
     /**
      * Данные об оплате заказа.
      */

package/order/internal/sc-i-order.d.ts

@@ -1,6 +1,7 @@
 import { ScContragent } from '../../contragent/dto/sc-contragent';
-import { ScIOrderDelivery } from '../classes/sc-order-delivery';
-import { ScIOrderHistory } from '../classes/sc-order-history';
+import { ScIReferencesTypes } from '../../references/dto/sc-i-references-types';
+import { ScOrderStateStatus } from '../../references/enums/sc-order-state-status';
+import { ScIOrderHistory } from '../classes/sc-i-order-history';
 import { ScOrderShort } from '../classes/sc-order-short';
 import { ScDeliveryType, ScPaymentType } from '../enums';
 import { ScIOrderItem } from './sc-i-order-item';
@@ -12,35 +13,35 @@ export interface ScIOrder extends ScIOrderShort {
     /**
      * Список продуктов заказа.
      */
-    products: ScIOrderItem[];
+    readonly products: ScIOrderItem[];
+    /**
+     * Список статусов, в которые текущий пользователь может перевести заказ.
+     */
+    readonly nextStatuses?: Array<ScIReferencesTypes<ScOrderStateStatus, typeof ScOrderStateStatus>>;
     /**
      * Список записей истории изменения статусов заказа.
      */
-    history?: ScIOrderHistory[];
+    readonly history?: ScIOrderHistory[];
     /**
      * Список счетов заказа.
      */
-    invoices?: string[];
+    readonly invoices?: string[];
     /**
      * Комментарий клиента к заказу.
      */
-    comment?: string;
+    readonly comment?: string;
     /**
      * Изображение, прикрепленное к заказу клиентом во время создания.
      */
-    image?: string;
-    /**
-     * Данные о доставке заказа.
-     */
-    delivery: ScIOrderDelivery;
+    readonly image?: string;
     /**
      * Данные о контрагенте клиента.
      */
-    contragent?: ScContragent;
+    readonly contragent?: ScContragent;
     /**
      * Закрепленный за заказом пользователь.
      */
-    attachedUser?: {
+    readonly attachedUser?: {
         /**
          * Тип пользователя.
          */
@@ -50,7 +51,7 @@ export interface ScIOrder extends ScIOrderShort {
          */
         name: string;
         /**
-         * Номер телефона. В формате "79203436527" или "+79203436527".
+         * Номер телефона в международном формате, например `+7XXXXXXXXXX`.
          */
         phone: string;
         /**
@@ -58,10 +59,14 @@ export interface ScIOrder extends ScIOrderShort {
          */
         email: string;
     };
+    /**
+     * Список тегов заказа.
+     */
+    readonly tags?: string[];
     /**
      * Дата последнего обновления статуса и информации об оплате.
      */
-    lastUpdateDate: Date;
+    readonly lastUpdateDate: Date;
     /**
      * Тип оплаты.
      */

package/order/services/sc-orders.service.d.ts

@@ -2,6 +2,7 @@ import { HttpParams } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import { ScIPaginate } from '../../pagination';
 import { ScDeliveryCost } from '../classes/sc-delivery-cost';
+import { ScIOrderHistory } from '../classes/sc-i-order-history';
 import { ScOrder } from '../classes/sc-order';
 import { ScOrderItem } from '../classes/sc-order-item';
 import { ScOrderShort } from '../classes/sc-order-short';
@@ -104,6 +105,20 @@ export declare class ScOrdersService implements ScIOrderLoader<ScOrderItem, ScOr
      * @param orderId Идентификатор заказа.
      */
     cancel$(orderId: number): Observable<undefined>;
+    /**
+     * Изменяет статус заказа и возвращает обновлённые данные заказа.
+     *
+     * @param orderId Идентификатор заказа.
+     * @param status Slug нового статуса заказа.
+     * @param statusDetail Slug детализирующего статуса заказа.
+     */
+    changeOrderStatus$(orderId: number, status: string, statusDetail?: string | null): Observable<ScOrder>;
+    /**
+     * Возвращает историю изменения статусов заказа.
+     *
+     * @param orderId Идентификатор заказа.
+     */
+    getOrderStatusHistory$(orderId: number): Observable<ScIOrderHistory[]>;
     /**
      * Возвращает информацию о стоимости доставки.
      *
@@ -112,6 +127,13 @@ export declare class ScOrdersService implements ScIOrderLoader<ScOrderItem, ScOr
      * @param date Дата доставки.
      */
     getDeliveryCost$(addressId: number, warehouseId: number, date: string): Observable<ScDeliveryCost>;
+    /**
+     * Подставляет в кэш полного заказа актуальные данные после мутации на сервере.
+     *
+     * @param orderId Идентификатор заказа.
+     * @param order Данные заказа.
+     */
+    private syncOrderCache;
     static ɵfac: i0.ɵɵFactoryDeclaration<ScOrdersService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ScOrdersService>;
 }

package/package.json

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

package/esm2022/order/classes/sc-order-history.mjs

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2Mtb3JkZXItaGlzdG9yeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3Byb2plY3RzL2NvcmUvb3JkZXIvY2xhc3Nlcy9zYy1vcmRlci1oaXN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqINCU0LDQvdC90YvQtSDQvtCxINC40YHRgtC+0YDQuNC4INC40LfQvNC10L3QtdC90LjRjyDRgdGC0LDRgtGD0YHQvtCyINC30LDQutCw0LfQsC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBTY0lPcmRlckhpc3Rvcnkge1xuICAgIC8qKlxuICAgICAqINCY0LzRjyDQv9C+0LvRjNC30L7QstCw0YLQtdC70Y8g0LjQt9C80LXQvdC40LLRiNC10LPQviDRgdGC0LDRgtGD0YEuXG4gICAgICovXG4gICAgdXNlck5hbWU6IHN0cmluZztcblxuICAgIC8qKlxuICAgICAqINCU0LDRgtCwINC4INCy0YDQtdC80Y8g0LjQt9C80LXQvdC10L3QuNGPINGB0YLQsNGC0YPRgdCwINCyINGE0L7RgNC80LDRgtC1IFwi0JTQlC7QnNCcLtCT0JPQk9CTINCn0Kc60JzQnFwiLlxuICAgICAqL1xuICAgIGNyZWF0ZWRBdDogc3RyaW5nO1xuXG4gICAgLyoqXG4gICAgICog0JjQtNC10L3RgtC40YTQuNC60LDRgtC+0YAg0YHRgtCw0YLRg9GB0LAuXG4gICAgICovXG4gICAgc3RhdHVzOiBudW1iZXI7XG59XG4iXX0=

package/order/classes/sc-order-history.d.ts

@@ -1,17 +0,0 @@
-/**
- * Данные об истории изменения статусов заказа.
- */
-export interface ScIOrderHistory {
-    /**
-     * Имя пользователя изменившего статус.
-     */
-    userName: string;
-    /**
-     * Дата и время изменения статуса в формате "ДД.ММ.ГГГГ ЧЧ:ММ".
-     */
-    createdAt: string;
-    /**
-     * Идентификатор статуса.
-     */
-    status: number;
-}