@floristcloud/api-lib 1.2.133 → 1.2.134

package/build/commands/pre-order-collection-item/get-pre-order-collection-item-extended-with-clients-pre-order-product-list.query.js

@@ -4,16 +4,31 @@ exports.GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListContractQ
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
 const enum_1 = require("../../enum");
-const GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListRequestSchema = zod_1.z.object({
+const pagination_helper_1 = require("../../helpers/pagination.helper");
+const GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListRequestSchema = zod_1.z
+    .object({
+    // Пагинация опциональна: без page/count отдаётся весь отфильтрованный список (поведение до FC-475).
+    // Неполная пара отклоняется — иначе `?count=20` молча вернул бы всю коллекцию с HTTP 200.
+    page: zod_1.z.coerce.number().int().positive().optional().describe('1-based page number, requires "count".'),
+    count: zod_1.z.coerce.number().int().positive().optional().describe('Positions per page. Without it the whole list is returned.'),
     preOrderCollectionUUID: zod_1.z.string().optional(),
+    // Точечный режим: одна позиция коллекции — «кто её предзаказал».
+    preOrderCollectionItemUUID: zod_1.z.string().optional(),
+    // Поиск по позиции (название / категория / артикул).
     searchQuery: zod_1.z.string().optional(),
+    // Поиск по клиенту (имя / код) внутри вложенного списка предзаказов.
+    clientSearchQuery: zod_1.z.string().optional(),
     statuses: zod_1.z.nativeEnum(enum_1.PreOrderStatusEnum).array().optional(),
     preOrderCreatedAtFrom: zod_1.z.coerce.date().optional(),
     preOrderCreatedAtTo: zod_1.z.coerce.date().optional(),
+})
+    .refine(pagination_helper_1.isPaginationPairComplete, {
+    message: 'validation.pageAndCountGoTogether',
+    path: ['count'],
 });
 const GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
-    data: zod_1.z.array(schemas_1.PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema),
+    data: schemas_1.PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema,
 });
 var GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListContractQuery;
 (function (GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListContractQuery) {

package/build/helpers/pagination.helper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPageAccompaniedByCount = void 0;
+exports.isPaginationPairComplete = exports.isPageAccompaniedByCount = void 0;
 /**
  * `page` имеет смысл только вместе с `count`.
  *
@@ -10,3 +10,12 @@ exports.isPageAccompaniedByCount = void 0;
  */
 const isPageAccompaniedByCount = (value) => value.page === undefined || value.count !== undefined;
 exports.isPageAccompaniedByCount = isPageAccompaniedByCount;
+/**
+ * Строгий вариант: валидны только «оба параметра» или «ни одного».
+ *
+ * Нужен там, где `count` в одиночку — правдоподобная форма запроса («дай 20 строк»), а не описка:
+ * такой запрос молча вернул бы весь список с HTTP 200, и клиент не отличил бы это от «данных
+ * ровно столько». Отчёты обходятся односторонней проверкой выше — там пара всегда приходит из UI.
+ */
+const isPaginationPairComplete = (value) => (value.page === undefined) === (value.count === undefined);
+exports.isPaginationPairComplete = isPaginationPairComplete;

package/build/schemas/pre-order-collection-item/pre-order-collection-item.schema.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PreOrderCollectionItemGroupedListSchema = exports.PreOrderCollectionItemGroupedSchema = exports.PreOrderCollectionItemExtendedWithPreOrderCollectionListSchema = exports.PreOrderCollectionItemExtendedWithPreOrderCollectionSchema = exports.PreOrderCollectionItemExtendedListSchema = exports.PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema = exports.PreOrderCollectionItemExtendedSchema = exports.MatchingProductSchema = exports.UpdatePreOrderCollectionItemSchema = exports.CreatePreOrderCollectionItemSchema = exports.PreOrderCollectionItemSchema = void 0;
+exports.PreOrderCollectionItemGroupedListSchema = exports.PreOrderCollectionItemGroupedSchema = exports.PreOrderCollectionItemExtendedWithPreOrderCollectionListSchema = exports.PreOrderCollectionItemExtendedWithPreOrderCollectionSchema = exports.PreOrderCollectionItemExtendedListSchema = exports.PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema = exports.PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema = exports.PreOrderCollectionItemClientPreOrderProductSchema = exports.PreOrderCollectionItemExtendedSchema = exports.MatchingProductSchema = exports.UpdatePreOrderCollectionItemSchema = exports.CreatePreOrderCollectionItemSchema = exports.PreOrderCollectionItemSchema = void 0;
 const zod_1 = require("zod");
 const type_schema_1 = require("../type/type.schema");
 const category_schema_1 = require("../category/category.schema");
 const product_image_schema_1 = require("../product-image/product-image.schema");
 const client_1 = require("../client");
 const pre_order_product_schema_1 = require("../pre-order-product/pre-order-product.schema");
+const pre_order_schema_1 = require("../pre-order/pre-order.schema");
 const enum_1 = require("../../enum");
 const pre_order_collection_item_multiplicity_option_schema_1 = require("./pre-order-collection-item-multiplicity-option.schema");
 const money_schema_1 = require("../money.schema");
@@ -112,8 +113,18 @@ exports.PreOrderCollectionItemExtendedSchema = exports.PreOrderCollectionItemSch
     multiplicityOptions: zod_1.z.array(pre_order_collection_item_multiplicity_option_schema_1.PreOrderCollectionItemMultiplicityOptionSchema).optional(),
     preOrderedQuantity: zod_1.z.number().optional(),
 });
+// Метаданные предзаказа для колонок «№ / дата / статус» в списке «кто предзаказал позицию».
+exports.PreOrderCollectionItemClientPreOrderProductSchema = zod_1.z.object({
+    client: client_1.ClientSchema,
+    preOrderProduct: pre_order_product_schema_1.PreOrderProductSchema,
+    preOrder: pre_order_schema_1.PreOrderSchema.pick({ uuid: true, preOrderNum: true, status: true, createdAt: true }),
+});
 exports.PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema = exports.PreOrderCollectionItemExtendedSchema.extend({
-    clientsWithPreOrderProduct: zod_1.z.array(zod_1.z.object({ client: client_1.ClientSchema, preOrderProduct: pre_order_product_schema_1.PreOrderProductSchema })),
+    clientsWithPreOrderProduct: zod_1.z.array(exports.PreOrderCollectionItemClientPreOrderProductSchema),
+});
+exports.PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema = zod_1.z.object({
+    list: zod_1.z.array(exports.PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema),
+    total: zod_1.z.number(),
 });
 exports.PreOrderCollectionItemExtendedListSchema = zod_1.z.object({
     list: zod_1.z.array(exports.PreOrderCollectionItemExtendedSchema),

package/commands/pre-order-collection-item/get-pre-order-collection-item-extended-with-clients-pre-order-product-list.query.ts

@@ -1,18 +1,33 @@
 import { z } from 'zod';
-import { PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema } from '../../schemas';
+import { PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema } from '../../schemas';
 import { PreOrderStatusEnum } from '../../enum';
+import { isPaginationPairComplete } from '../../helpers/pagination.helper';
 
-const GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListRequestSchema = z.object({
-    preOrderCollectionUUID: z.string().optional(),
-    searchQuery: z.string().optional(),
-    statuses: z.nativeEnum(PreOrderStatusEnum).array().optional(),
-    preOrderCreatedAtFrom: z.coerce.date().optional(),
-    preOrderCreatedAtTo: z.coerce.date().optional(),
-});
+const GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListRequestSchema = z
+    .object({
+        // Пагинация опциональна: без page/count отдаётся весь отфильтрованный список (поведение до FC-475).
+        // Неполная пара отклоняется — иначе `?count=20` молча вернул бы всю коллекцию с HTTP 200.
+        page: z.coerce.number().int().positive().optional().describe('1-based page number, requires "count".'),
+        count: z.coerce.number().int().positive().optional().describe('Positions per page. Without it the whole list is returned.'),
+        preOrderCollectionUUID: z.string().optional(),
+        // Точечный режим: одна позиция коллекции — «кто её предзаказал».
+        preOrderCollectionItemUUID: z.string().optional(),
+        // Поиск по позиции (название / категория / артикул).
+        searchQuery: z.string().optional(),
+        // Поиск по клиенту (имя / код) внутри вложенного списка предзаказов.
+        clientSearchQuery: z.string().optional(),
+        statuses: z.nativeEnum(PreOrderStatusEnum).array().optional(),
+        preOrderCreatedAtFrom: z.coerce.date().optional(),
+        preOrderCreatedAtTo: z.coerce.date().optional(),
+    })
+    .refine(isPaginationPairComplete, {
+        message: 'validation.pageAndCountGoTogether',
+        path: ['count'],
+    });
 
 const GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListResponseSchema = z.object({
     message: z.string().optional(),
-    data: z.array(PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema),
+    data: PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema,
 });
 
 export namespace GetPreOrderCollectionItemExtendedWithClientsPreOrderProductListContractQuery {

package/helpers/pagination.helper.ts

@@ -7,3 +7,13 @@
  */
 export const isPageAccompaniedByCount = (value: { page?: number; count?: number }): boolean =>
     value.page === undefined || value.count !== undefined;
+
+/**
+ * Строгий вариант: валидны только «оба параметра» или «ни одного».
+ *
+ * Нужен там, где `count` в одиночку — правдоподобная форма запроса («дай 20 строк»), а не описка:
+ * такой запрос молча вернул бы весь список с HTTP 200, и клиент не отличил бы это от «данных
+ * ровно столько». Отчёты обходятся односторонней проверкой выше — там пара всегда приходит из UI.
+ */
+export const isPaginationPairComplete = (value: { page?: number; count?: number }): boolean =>
+    (value.page === undefined) === (value.count === undefined);

package/package.json

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

package/schemas/pre-order-collection-item/pre-order-collection-item.schema.ts

@@ -4,6 +4,7 @@ import { CategorySchema } from '../category/category.schema';
 import { ProductImageSchema } from '../product-image/product-image.schema';
 import { ClientSchema } from '../client';
 import { PreOrderProductSchema } from '../pre-order-product/pre-order-product.schema';
+import { PreOrderSchema } from '../pre-order/pre-order.schema';
 import { SalesUnitEnum } from '../../enum';
 import { PreOrderCollectionItemMultiplicityOptionSchema } from './pre-order-collection-item-multiplicity-option.schema';
 import { MoneySchema } from '../money.schema';
@@ -115,8 +116,20 @@ export const PreOrderCollectionItemExtendedSchema = PreOrderCollectionItemSchema
     preOrderedQuantity: z.number().optional(),
 });
 
+// Метаданные предзаказа для колонок «№ / дата / статус» в списке «кто предзаказал позицию».
+export const PreOrderCollectionItemClientPreOrderProductSchema = z.object({
+    client: ClientSchema,
+    preOrderProduct: PreOrderProductSchema,
+    preOrder: PreOrderSchema.pick({ uuid: true, preOrderNum: true, status: true, createdAt: true }),
+});
+
 export const PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema = PreOrderCollectionItemExtendedSchema.extend({
-    clientsWithPreOrderProduct: z.array(z.object({ client: ClientSchema, preOrderProduct: PreOrderProductSchema })),
+    clientsWithPreOrderProduct: z.array(PreOrderCollectionItemClientPreOrderProductSchema),
+});
+
+export const PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema = z.object({
+    list: z.array(PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema),
+    total: z.number(),
 });
 
 export const PreOrderCollectionItemExtendedListSchema = z.object({