@floristcloud/api-lib 1.2.143 → 1.2.144

package/build/commands/product/webshop/get-product-list-for-client.query.js

@@ -20,6 +20,12 @@ const GetProductListForClientRequestSchema = zod_1.z.object({
     typeUUID: zod_1.z.string().optional(),
     searchQuery: zod_1.z.string().optional(),
     marks: zod_1.z.nativeEnum(enum_1.ProductMarkEnum).array().optional(),
+    // Без `sortBy` порядок остаётся прежним — по категории, названию и размеру. Сортировка по цене
+    // идёт по базовому прайсу, скидки клиента её не двигают: см. ProductClientSortByEnum.
+    sortBy: zod_1.z.nativeEnum(enum_1.ProductClientSortByEnum).optional(),
+    // Без `.default()`: он уезжает в `_output`, а значит и в опубликованный `Request`, делая поле
+    // обязательным для клиентов. Отсутствующее направление билдер и так читает как ASC.
+    sortOrder: zod_1.z.nativeEnum(enum_1.OrderByEnum).optional(),
 });
 const GetProductListForClientResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/enum/index.js

@@ -65,6 +65,7 @@ __exportStar(require("./position-report-type.enum"), exports);
 __exportStar(require("./discount-price-routing.enum"), exports);
 __exportStar(require("./sales-unit.enum"), exports);
 __exportStar(require("./product-mark.enum"), exports);
+__exportStar(require("./product-client-sort-by.enum"), exports);
 __exportStar(require("./sales-by-position-group-by.enum"), exports);
 __exportStar(require("./client-import-entity-property.enum"), exports);
 __exportStar(require("./client-import-errors.enum"), exports);

package/build/enum/product-client-sort-by.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductClientSortByEnum = void 0;
+/**
+ * Поле сортировки списка товаров витрины. Значение совпадает с именем поля ответа, чтобы клиент
+ * сортировал «по тому, что видит».
+ *
+ * `PRICE` — это базовый прайс товара, без скидок клиента. Порядок задаётся в SQL до пагинации, а
+ * скидки накладываются уже на выбранную страницу, поэтому сортировать по цене со скидкой значило бы
+ * либо считать её для всей выборки в памяти, либо продублировать цепочку правил в SQL. У клиента со
+ * сквозным процентом порядок от этого не меняется; расходится он там, где действует правило от
+ * себестоимости (COST_PLUS_MARKUP) или точечный ITEM_DISCOUNT.
+ */
+var ProductClientSortByEnum;
+(function (ProductClientSortByEnum) {
+    ProductClientSortByEnum["PRICE"] = "price";
+})(ProductClientSortByEnum || (exports.ProductClientSortByEnum = ProductClientSortByEnum = {}));

package/commands/product/webshop/get-product-list-for-client.query.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { ProductMarkEnum } from '../../../enum';
+import { OrderByEnum, ProductClientSortByEnum, ProductMarkEnum } from '../../../enum';
 import { ProductListExtendedForClientSchema } from '../../../schemas';
 
 const GetProductListForClientRequestSchema = z.object({
@@ -18,6 +18,12 @@ const GetProductListForClientRequestSchema = z.object({
     typeUUID: z.string().optional(),
     searchQuery: z.string().optional(),
     marks: z.nativeEnum(ProductMarkEnum).array().optional(),
+    // Без `sortBy` порядок остаётся прежним — по категории, названию и размеру. Сортировка по цене
+    // идёт по базовому прайсу, скидки клиента её не двигают: см. ProductClientSortByEnum.
+    sortBy: z.nativeEnum(ProductClientSortByEnum).optional(),
+    // Без `.default()`: он уезжает в `_output`, а значит и в опубликованный `Request`, делая поле
+    // обязательным для клиентов. Отсутствующее направление билдер и так читает как ASC.
+    sortOrder: z.nativeEnum(OrderByEnum).optional(),
 });
 
 const GetProductListForClientResponseSchema = z.object({

package/enum/index.ts

@@ -49,6 +49,7 @@ export * from './position-report-type.enum';
 export * from './discount-price-routing.enum';
 export * from './sales-unit.enum';
 export * from './product-mark.enum';
+export * from './product-client-sort-by.enum';
 export * from './sales-by-position-group-by.enum';
 export * from './client-import-entity-property.enum';
 export * from './client-import-errors.enum';

package/enum/product-client-sort-by.enum.ts

@@ -0,0 +1,13 @@
+/**
+ * Поле сортировки списка товаров витрины. Значение совпадает с именем поля ответа, чтобы клиент
+ * сортировал «по тому, что видит».
+ *
+ * `PRICE` — это базовый прайс товара, без скидок клиента. Порядок задаётся в SQL до пагинации, а
+ * скидки накладываются уже на выбранную страницу, поэтому сортировать по цене со скидкой значило бы
+ * либо считать её для всей выборки в памяти, либо продублировать цепочку правил в SQL. У клиента со
+ * сквозным процентом порядок от этого не меняется; расходится он там, где действует правило от
+ * себестоимости (COST_PLUS_MARKUP) или точечный ITEM_DISCOUNT.
+ */
+export enum ProductClientSortByEnum {
+    PRICE = 'price',
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.143",
+    "version": "1.2.144",
     "description": "",
     "main": "./build/index.js",
     "scripts": {