@floristcloud/api-lib 1.2.143 → 1.2.145

package/build/commands/category/create-category.command.js

@@ -3,13 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateCategoryContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
-const CreateCategoryRequestSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    multiplicity: zod_1.z.number(),
-    isSizeSeparate: zod_1.z.coerce.boolean(),
-    typeUUID: zod_1.z.string(),
-    isSaveCategoryName: zod_1.z.coerce.boolean(),
-});
+const category_create_schema_1 = require("../../schemas/category/category-create.schema");
+const CreateCategoryRequestSchema = category_create_schema_1.CategoryCreateSchema;
 const CreateCategoryResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: schemas_1.CategorySchema,

package/build/commands/category/get-category-list.query.js

@@ -2,26 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetCategoryListContractQuery = void 0;
 const zod_1 = require("zod");
-const category_schema_1 = require("../../schemas/category/category.schema");
-const order_by_enum_1 = require("../../enum/order-by.enum");
-const enum_1 = require("../../enum");
-const GetCategoryListRequestSchema = zod_1.z.object({
-    page: zod_1.z.coerce.number().optional().default(1),
-    count: zod_1.z.coerce.number().optional().default(10),
-    searchQuery: zod_1.z
-        .string()
-        .optional()
-        .refine(val => !val || val.length < Math.pow(10, 6)),
-    typeUUID: zod_1.z.uuid().optional(),
-    statuses: zod_1.z.array(zod_1.z.nativeEnum(enum_1.CategoryStatusEnum)).default([]),
-    orderByType: zod_1.z.nativeEnum(order_by_enum_1.OrderByEnum).default(order_by_enum_1.OrderByEnum.ASC),
-});
+const category_list_filter_schema_1 = require("../../schemas/category/category-list-filter.schema");
+const category_list_schema_1 = require("../../schemas/category/category-list.schema");
+const GetCategoryListRequestSchema = category_list_filter_schema_1.CategoryListFilterSchema;
 const GetCategoryResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
-    data: zod_1.z.object({
-        categoryList: category_schema_1.CategoryExtendedSchema.array(),
-        total: zod_1.z.number(),
-    }),
+    data: category_list_schema_1.CategoryListSchema,
 });
 var GetCategoryListContractQuery;
 (function (GetCategoryListContractQuery) {

package/build/commands/category/update-category-command.js

@@ -3,15 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateCategoryContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
-const enum_1 = require("../../enum");
-const UpdateCategoryRequestSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    typeUUID: zod_1.z.string(),
-    multiplicity: zod_1.z.number(),
-    isSizeSeparate: zod_1.z.coerce.boolean(),
-    isSaveCategoryName: zod_1.z.coerce.boolean(),
-    status: zod_1.z.nativeEnum(enum_1.CategoryStatusEnum),
-});
+const category_update_schema_1 = require("../../schemas/category/category-update.schema");
+const UpdateCategoryRequestSchema = category_update_schema_1.CategoryUpdateSchema;
 const UpdateCategoryResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: schemas_1.CategorySchema.nullable(),

package/build/commands/category-template/create-category-template.command.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateCategoryTemplateContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
+const localized_name_schema_1 = require("../../schemas/i18n/localized-name.schema");
+// Переводы необязательны: без них шаблон живёт на каноническом имени, как и раньше.
 const CreateCategoryTemplateRequestSchema = schemas_1.CategoryTemplateSchema.pick({
     name: true,
     alias: true,
@@ -11,6 +13,9 @@ const CreateCategoryTemplateRequestSchema = schemas_1.CategoryTemplateSchema.pic
     multiplicity: true,
     isSizeSeparate: true,
     isSaveCategoryName: true,
+}).extend({
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+    typeNameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
 });
 const CreateCategoryTemplateResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/category-template/update-category-template.command.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateCategoryTemplateContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
+const localized_name_schema_1 = require("../../schemas/i18n/localized-name.schema");
+// Переводы вынесены из `pick`: `.partial()` сделал бы их только необязательными, а очистка словаря
+// должна быть выразима явно — как у категории и типа, через `null` или пустой объект.
 const UpdateCategoryTemplateRequestSchema = schemas_1.CategoryTemplateSchema.pick({
     name: true,
     alias: true,
@@ -11,7 +14,12 @@ const UpdateCategoryTemplateRequestSchema = schemas_1.CategoryTemplateSchema.pic
     multiplicity: true,
     isSizeSeparate: true,
     isSaveCategoryName: true,
-}).partial();
+})
+    .partial()
+    .extend({
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+    typeNameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+});
 const UpdateCategoryTemplateResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: schemas_1.CategoryTemplateSchema.optional(),

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/commands/type/create-type.command.js

@@ -3,10 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateTypeContractCommand = void 0;
 const zod_1 = require("zod");
 const type_schema_1 = require("../../schemas/type/type.schema");
-const CreateTypeRequestSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    rank: zod_1.z.number(),
-});
+const type_create_schema_1 = require("../../schemas/type/type-create.schema");
+const CreateTypeRequestSchema = type_create_schema_1.TypeCreateSchema;
 const CreateTypeResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: type_schema_1.TypeSchema,

package/build/commands/type/update-type.command.js

@@ -3,10 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateTypeContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
-const UpdateTypeRequestSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    rank: zod_1.z.number(),
-});
+const type_update_schema_1 = require("../../schemas/type/type-update.schema");
+const UpdateTypeRequestSchema = type_update_schema_1.TypeUpdateSchema;
 const UpdateTypeResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: schemas_1.CategorySchema.nullable(),

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/build/helpers/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./date.helper"), exports);
 __exportStar(require("./pagination.helper"), exports);
 __exportStar(require("./query-boolean.helper"), exports);
+__exportStar(require("./resolve-localized-name.helper"), exports);

package/build/helpers/resolve-localized-name.helper.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLocalizedName = void 0;
+/**
+ * Название сущности на запрошенном языке.
+ *
+ * Один резолвер на бэкенд и оба фронта, чтобы одна и та же категория нигде не подписывалась
+ * по-разному. Перевода нет, он пустой или состоит из пробелов — показываем канон: пустая подпись
+ * хуже подписи на чужом языке.
+ */
+const resolveLocalizedName = (name, translations, language) => {
+    const translated = language ? translations === null || translations === void 0 ? void 0 : translations[language] : undefined;
+    return translated && translated.trim() ? translated : name;
+};
+exports.resolveLocalizedName = resolveLocalizedName;

package/build/schemas/category/category-create.schema.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryCreateSchema = void 0;
+const zod_1 = require("zod");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
+// Поля новой категории. Название на дополнительных языках необязательно: без переводов
+// категория живёт на каноническом имени.
+exports.CategoryCreateSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+    multiplicity: zod_1.z.number(),
+    isSizeSeparate: zod_1.z.coerce.boolean(),
+    typeUUID: zod_1.z.string(),
+    isSaveCategoryName: zod_1.z.coerce.boolean(),
+});

package/build/schemas/category/category-list-filter.schema.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryListFilterSchema = void 0;
+const zod_1 = require("zod");
+const enum_1 = require("../../enum");
+const language_enum_1 = require("../../enum/language.enum");
+const order_by_enum_1 = require("../../enum/order-by.enum");
+// Условия выборки справочника категорий.
+exports.CategoryListFilterSchema = zod_1.z.object({
+    page: zod_1.z.coerce.number().optional().default(1),
+    count: zod_1.z.coerce.number().optional().default(10),
+    searchQuery: zod_1.z
+        .string()
+        .optional()
+        .refine(val => !val || val.length < Math.pow(10, 6)),
+    typeUUID: zod_1.z.uuid().optional(),
+    statuses: zod_1.z.array(zod_1.z.nativeEnum(enum_1.CategoryStatusEnum)).default([]),
+    orderByType: zod_1.z.nativeEnum(order_by_enum_1.OrderByEnum).default(order_by_enum_1.OrderByEnum.ASC),
+    /**
+     * Язык, на котором подписывается список. Передан — справочник сортируется по отображаемому
+     * названию: страницу из двадцати строк клиент пересортировать не может, а порядок «по русскому
+     * алфавиту с английскими подписями» выглядит случайным. Не передан — сортировка по канону.
+     */
+    language: zod_1.z.nativeEnum(language_enum_1.LanguageEnum).optional(),
+});

package/build/schemas/category/category-list.schema.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryListSchema = void 0;
+const zod_1 = require("zod");
+const category_schema_1 = require("./category.schema");
+// Страница справочника категорий вместе с общим числом строк по фильтру.
+exports.CategoryListSchema = zod_1.z.object({
+    categoryList: category_schema_1.CategoryExtendedSchema.array(),
+    total: zod_1.z.number(),
+});

package/build/schemas/category/category-update.schema.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryUpdateSchema = void 0;
+const zod_1 = require("zod");
+const enum_1 = require("../../enum");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
+// Поля редактируемой категории. Переводы отсутствуют в теле — остаются прежними;
+// `null` и пустой объект их очищают.
+exports.CategoryUpdateSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+    typeUUID: zod_1.z.string(),
+    multiplicity: zod_1.z.number(),
+    isSizeSeparate: zod_1.z.coerce.boolean(),
+    isSaveCategoryName: zod_1.z.coerce.boolean(),
+    status: zod_1.z.nativeEnum(enum_1.CategoryStatusEnum),
+});

package/build/schemas/category/category.schema.js

@@ -3,10 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CategoryExtendedSchema = exports.CategorySchema = void 0;
 const zod_1 = require("zod");
 const category_status_enum_1 = require("../../enum/category-status.enum");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
 const type_schema_1 = require("../type/type.schema");
 exports.CategorySchema = zod_1.z.object({
     uuid: zod_1.z.uuid(),
+    // Канон, по нему сходятся импорт, отчёты и выгрузки.
     name: zod_1.z.string(),
+    // Переопределения названия по языкам; какое показать — решает клиент через resolveLocalizedName.
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema,
     multiplicity: zod_1.z.number().nullable(),
     isSizeSeparate: zod_1.z.boolean(),
     isSaveCategoryName: zod_1.z.boolean(),

package/build/schemas/category-template/category-template.schema.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CategoryTemplateListSchema = exports.CategoryTemplateSchema = exports.CategoryTemplateTypeSchema = void 0;
 const zod_1 = require("zod");
 const language_enum_1 = require("../../enum/language.enum");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
 exports.CategoryTemplateTypeSchema = zod_1.z.object({
     name: zod_1.z.string(),
     rank: zod_1.z.number(),
@@ -10,6 +11,10 @@ exports.CategoryTemplateTypeSchema = zod_1.z.object({
 exports.CategoryTemplateSchema = zod_1.z.object({
     uuid: zod_1.z.uuid(),
     name: zod_1.z.string(),
+    // Переводы шаблона наследуют категории и типы новой компании, поэтому правка справочника
+    // здесь доезжает до всех, кто зарегистрируется после неё.
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema,
+    typeNameTranslations: localized_name_schema_1.LocalizedNameSchema,
     alias: zod_1.z.string().array(),
     type: exports.CategoryTemplateTypeSchema,
     language: zod_1.z.nativeEnum(language_enum_1.LanguageEnum),

package/build/schemas/i18n/localized-name.schema.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalizedNameSchema = void 0;
+const zod_1 = require("zod");
+const language_enum_1 = require("../../enum/language.enum");
+/**
+ * Переопределения названия по языкам.
+ *
+ * Канон живёт в поле `name` и остаётся ключом сущности — по нему матчится импорт, сходятся отчёты
+ * и совпадают выгрузки. Сюда кладутся только отличия от канона, поэтому основной язык компании
+ * здесь не хранится: иначе `name` и перевод на тот же язык начали бы расходиться.
+ */
+exports.LocalizedNameSchema = zod_1.z.partialRecord(zod_1.z.enum(language_enum_1.LanguageEnum), zod_1.z.string().trim().max(255));

package/build/schemas/index.js

@@ -14,6 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./i18n/localized-name.schema"), exports);
+__exportStar(require("./category/category-create.schema"), exports);
+__exportStar(require("./category/category-update.schema"), exports);
+__exportStar(require("./category/category-list-filter.schema"), exports);
+__exportStar(require("./category/category-list.schema"), exports);
+__exportStar(require("./type/type-create.schema"), exports);
+__exportStar(require("./type/type-update.schema"), exports);
 __exportStar(require("./company/company.schema"), exports);
 __exportStar(require("./client/client.schema"), exports);
 __exportStar(require("./user/user.schema"), exports);

package/build/schemas/product/product.schema.js

@@ -4,6 +4,7 @@ exports.ProductExtendedForAdminWithStatistic = exports.ProductExtendedForAdminSc
 const zod_1 = require("zod");
 const product_image_schema_1 = require("../product-image/product-image.schema");
 const category_schema_1 = require("../category/category.schema");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
 const type_schema_1 = require("../type/type.schema");
 const consignment_schema_1 = require("../consignment/consignment.schema");
 const enum_1 = require("../../enum");
@@ -73,12 +74,14 @@ exports.ProductExtendedForClientSchema = exports.ProductForClientSchema.merge(zo
         .object({
         uuid: zod_1.z.string(),
         name: zod_1.z.string(),
+        nameTranslations: localized_name_schema_1.LocalizedNameSchema,
     })
         .nullable(),
     type: zod_1.z
         .object({
         uuid: zod_1.z.string(),
         name: zod_1.z.string(),
+        nameTranslations: localized_name_schema_1.LocalizedNameSchema,
     })
         .nullable(),
     image: zod_1.z

package/build/schemas/type/type-create.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeCreateSchema = void 0;
+const zod_1 = require("zod");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
+// Поля нового типа номенклатуры.
+exports.TypeCreateSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+    rank: zod_1.z.number(),
+});

package/build/schemas/type/type-update.schema.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeUpdateSchema = void 0;
+const zod_1 = require("zod");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
+// Поля редактируемого типа номенклатуры. Переводы отсутствуют в теле — остаются прежними;
+// `null` и пустой объект их очищают.
+exports.TypeUpdateSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema.nullish(),
+    rank: zod_1.z.number(),
+});

package/build/schemas/type/type.schema.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypeInCategorySchema = exports.TypeSchema = void 0;
 const zod_1 = require("zod");
+const localized_name_schema_1 = require("../i18n/localized-name.schema");
 exports.TypeSchema = zod_1.z.object({
     uuid: zod_1.z.uuid(),
     name: zod_1.z.string(),
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema,
     rank: zod_1.z.number(),
     deletedAt: zod_1.z.date().nullable(),
     createdAt: zod_1.z.date(),
@@ -13,5 +15,6 @@ exports.TypeSchema = zod_1.z.object({
 exports.TypeInCategorySchema = zod_1.z.object({
     uuid: zod_1.z.uuid(),
     name: zod_1.z.string(),
+    nameTranslations: localized_name_schema_1.LocalizedNameSchema,
     rank: zod_1.z.number(),
 });

package/commands/category/create-category.command.ts

@@ -1,13 +1,8 @@
 import { z } from 'zod';
 import { CategorySchema } from '../../schemas';
+import { CategoryCreateSchema } from '../../schemas/category/category-create.schema';
 
-const CreateCategoryRequestSchema = z.object({
-    name: z.string(),
-    multiplicity: z.number(),
-    isSizeSeparate: z.coerce.boolean(),
-    typeUUID: z.string(),
-    isSaveCategoryName: z.coerce.boolean(),
-});
+const CreateCategoryRequestSchema = CategoryCreateSchema;
 
 const CreateCategoryResponseSchema = z.object({
     message: z.string().optional(),

package/commands/category/get-category-list.query.ts

@@ -1,26 +1,12 @@
 import { z } from 'zod';
-import { CategoryExtendedSchema } from '../../schemas/category/category.schema';
-import { OrderByEnum } from '../../enum/order-by.enum';
-import { CategoryStatusEnum } from '../../enum';
+import { CategoryListFilterSchema } from '../../schemas/category/category-list-filter.schema';
+import { CategoryListSchema } from '../../schemas/category/category-list.schema';
 
-const GetCategoryListRequestSchema = z.object({
-    page: z.coerce.number().optional().default(1),
-    count: z.coerce.number().optional().default(10),
-    searchQuery: z
-        .string()
-        .optional()
-        .refine(val => !val || val.length < Math.pow(10, 6)),
-    typeUUID: z.uuid().optional(),
-    statuses: z.array(z.nativeEnum(CategoryStatusEnum)).default([]),
-    orderByType: z.nativeEnum(OrderByEnum).default(OrderByEnum.ASC),
-});
+const GetCategoryListRequestSchema = CategoryListFilterSchema;
 
 const GetCategoryResponseSchema = z.object({
     message: z.string().optional(),
-    data: z.object({
-        categoryList: CategoryExtendedSchema.array(),
-        total: z.number(),
-    }),
+    data: CategoryListSchema,
 });
 
 export namespace GetCategoryListContractQuery {

package/commands/category/update-category-command.ts

@@ -1,15 +1,8 @@
 import { z } from 'zod';
 import { CategorySchema } from '../../schemas';
-import { CategoryStatusEnum } from '../../enum';
+import { CategoryUpdateSchema } from '../../schemas/category/category-update.schema';
 
-const UpdateCategoryRequestSchema = z.object({
-    name: z.string(),
-    typeUUID: z.string(),
-    multiplicity: z.number(),
-    isSizeSeparate: z.coerce.boolean(),
-    isSaveCategoryName: z.coerce.boolean(),
-    status: z.nativeEnum(CategoryStatusEnum),
-});
+const UpdateCategoryRequestSchema = CategoryUpdateSchema;
 
 const UpdateCategoryResponseSchema = z.object({
     message: z.string().optional(),

package/commands/category-template/create-category-template.command.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import { CategoryTemplateSchema } from '../../schemas';
+import { LocalizedNameSchema } from '../../schemas/i18n/localized-name.schema';
 
+// Переводы необязательны: без них шаблон живёт на каноническом имени, как и раньше.
 const CreateCategoryTemplateRequestSchema = CategoryTemplateSchema.pick({
     name: true,
     alias: true,
@@ -9,6 +11,9 @@ const CreateCategoryTemplateRequestSchema = CategoryTemplateSchema.pick({
     multiplicity: true,
     isSizeSeparate: true,
     isSaveCategoryName: true,
+}).extend({
+    nameTranslations: LocalizedNameSchema.nullish(),
+    typeNameTranslations: LocalizedNameSchema.nullish(),
 });
 
 const CreateCategoryTemplateResponseSchema = z.object({

package/commands/category-template/update-category-template.command.ts

@@ -1,6 +1,9 @@
 import { z } from 'zod';
 import { CategoryTemplateSchema } from '../../schemas';
+import { LocalizedNameSchema } from '../../schemas/i18n/localized-name.schema';
 
+// Переводы вынесены из `pick`: `.partial()` сделал бы их только необязательными, а очистка словаря
+// должна быть выразима явно — как у категории и типа, через `null` или пустой объект.
 const UpdateCategoryTemplateRequestSchema = CategoryTemplateSchema.pick({
     name: true,
     alias: true,
@@ -9,7 +12,12 @@ const UpdateCategoryTemplateRequestSchema = CategoryTemplateSchema.pick({
     multiplicity: true,
     isSizeSeparate: true,
     isSaveCategoryName: true,
-}).partial();
+})
+    .partial()
+    .extend({
+        nameTranslations: LocalizedNameSchema.nullish(),
+        typeNameTranslations: LocalizedNameSchema.nullish(),
+    });
 
 const UpdateCategoryTemplateResponseSchema = z.object({
     message: z.string().optional(),

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/commands/type/create-type.command.ts

@@ -1,10 +1,8 @@
 import { z } from 'zod';
 import { TypeSchema } from '../../schemas/type/type.schema';
+import { TypeCreateSchema } from '../../schemas/type/type-create.schema';
 
-const CreateTypeRequestSchema = z.object({
-    name: z.string(),
-    rank: z.number(),
-});
+const CreateTypeRequestSchema = TypeCreateSchema;
 
 const CreateTypeResponseSchema = z.object({
     message: z.string().optional(),

package/commands/type/update-type.command.ts

@@ -1,10 +1,8 @@
 import { z } from 'zod';
 import { CategorySchema } from '../../schemas';
+import { TypeUpdateSchema } from '../../schemas/type/type-update.schema';
 
-const UpdateTypeRequestSchema = z.object({
-    name: z.string(),
-    rank: z.number(),
-});
+const UpdateTypeRequestSchema = TypeUpdateSchema;
 
 const UpdateTypeResponseSchema = z.object({
     message: z.string().optional(),

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/helpers/index.ts

@@ -1,3 +1,4 @@
 export * from './date.helper';
 export * from './pagination.helper';
 export * from './query-boolean.helper';
+export * from './resolve-localized-name.helper';

package/helpers/resolve-localized-name.helper.ts

@@ -0,0 +1,15 @@
+import { LanguageEnum } from '../enum/language.enum';
+import { LocalizedName } from '../schemas/i18n/localized-name.schema';
+
+/**
+ * Название сущности на запрошенном языке.
+ *
+ * Один резолвер на бэкенд и оба фронта, чтобы одна и та же категория нигде не подписывалась
+ * по-разному. Перевода нет, он пустой или состоит из пробелов — показываем канон: пустая подпись
+ * хуже подписи на чужом языке.
+ */
+export const resolveLocalizedName = (name: string, translations?: LocalizedName | null, language?: LanguageEnum | null): string => {
+    const translated = language ? translations?.[language] : undefined;
+
+    return translated && translated.trim() ? translated : name;
+};

package/package.json

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

package/schemas/category/category-create.schema.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
+
+// Поля новой категории. Название на дополнительных языках необязательно: без переводов
+// категория живёт на каноническом имени.
+export const CategoryCreateSchema = z.object({
+    name: z.string(),
+    nameTranslations: LocalizedNameSchema.nullish(),
+    multiplicity: z.number(),
+    isSizeSeparate: z.coerce.boolean(),
+    typeUUID: z.string(),
+    isSaveCategoryName: z.coerce.boolean(),
+});

package/schemas/category/category-list-filter.schema.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { CategoryStatusEnum } from '../../enum';
+import { LanguageEnum } from '../../enum/language.enum';
+import { OrderByEnum } from '../../enum/order-by.enum';
+
+// Условия выборки справочника категорий.
+export const CategoryListFilterSchema = z.object({
+    page: z.coerce.number().optional().default(1),
+    count: z.coerce.number().optional().default(10),
+    searchQuery: z
+        .string()
+        .optional()
+        .refine(val => !val || val.length < Math.pow(10, 6)),
+    typeUUID: z.uuid().optional(),
+    statuses: z.array(z.nativeEnum(CategoryStatusEnum)).default([]),
+    orderByType: z.nativeEnum(OrderByEnum).default(OrderByEnum.ASC),
+    /**
+     * Язык, на котором подписывается список. Передан — справочник сортируется по отображаемому
+     * названию: страницу из двадцати строк клиент пересортировать не может, а порядок «по русскому
+     * алфавиту с английскими подписями» выглядит случайным. Не передан — сортировка по канону.
+     */
+    language: z.nativeEnum(LanguageEnum).optional(),
+});

package/schemas/category/category-list.schema.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { CategoryExtendedSchema } from './category.schema';
+
+// Страница справочника категорий вместе с общим числом строк по фильтру.
+export const CategoryListSchema = z.object({
+    categoryList: CategoryExtendedSchema.array(),
+    total: z.number(),
+});

package/schemas/category/category-update.schema.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { CategoryStatusEnum } from '../../enum';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
+
+// Поля редактируемой категории. Переводы отсутствуют в теле — остаются прежними;
+// `null` и пустой объект их очищают.
+export const CategoryUpdateSchema = z.object({
+    name: z.string(),
+    nameTranslations: LocalizedNameSchema.nullish(),
+    typeUUID: z.string(),
+    multiplicity: z.number(),
+    isSizeSeparate: z.coerce.boolean(),
+    isSaveCategoryName: z.coerce.boolean(),
+    status: z.nativeEnum(CategoryStatusEnum),
+});

package/schemas/category/category.schema.ts

@@ -1,10 +1,14 @@
 import { z } from 'zod';
 import { CategoryStatusEnum } from '../../enum/category-status.enum';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
 import { TypeSchema } from '../type/type.schema';
 
 export const CategorySchema = z.object({
     uuid: z.uuid(),
+    // Канон, по нему сходятся импорт, отчёты и выгрузки.
     name: z.string(),
+    // Переопределения названия по языкам; какое показать — решает клиент через resolveLocalizedName.
+    nameTranslations: LocalizedNameSchema,
     multiplicity: z.number().nullable(),
     isSizeSeparate: z.boolean(),
     isSaveCategoryName: z.boolean(),

package/schemas/category-template/category-template.schema.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { LanguageEnum } from '../../enum/language.enum';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
 
 export const CategoryTemplateTypeSchema = z.object({
     name: z.string(),
@@ -9,6 +10,10 @@ export const CategoryTemplateTypeSchema = z.object({
 export const CategoryTemplateSchema = z.object({
     uuid: z.uuid(),
     name: z.string(),
+    // Переводы шаблона наследуют категории и типы новой компании, поэтому правка справочника
+    // здесь доезжает до всех, кто зарегистрируется после неё.
+    nameTranslations: LocalizedNameSchema,
+    typeNameTranslations: LocalizedNameSchema,
     alias: z.string().array(),
     type: CategoryTemplateTypeSchema,
     language: z.nativeEnum(LanguageEnum),

package/schemas/i18n/localized-name.schema.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { LanguageEnum } from '../../enum/language.enum';
+
+/**
+ * Переопределения названия по языкам.
+ *
+ * Канон живёт в поле `name` и остаётся ключом сущности — по нему матчится импорт, сходятся отчёты
+ * и совпадают выгрузки. Сюда кладутся только отличия от канона, поэтому основной язык компании
+ * здесь не хранится: иначе `name` и перевод на тот же язык начали бы расходиться.
+ */
+export const LocalizedNameSchema = z.partialRecord(z.enum(LanguageEnum), z.string().trim().max(255));
+
+export type LocalizedName = z.infer<typeof LocalizedNameSchema>;

package/schemas/index.ts

@@ -1,3 +1,10 @@
+export * from './i18n/localized-name.schema';
+export * from './category/category-create.schema';
+export * from './category/category-update.schema';
+export * from './category/category-list-filter.schema';
+export * from './category/category-list.schema';
+export * from './type/type-create.schema';
+export * from './type/type-update.schema';
 export * from './company/company.schema';
 export * from './client/client.schema';
 export * from './user/user.schema';

package/schemas/product/product.schema.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { ProductImageSchema } from '../product-image/product-image.schema';
 import { CategorySchema } from '../category/category.schema';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
 import { TypeSchema } from '../type/type.schema';
 import { ConsignmentSchema } from '../consignment/consignment.schema';
 import { DiscountRulesTypeEnum, ProductMarkEnum, SalesUnitEnum } from '../../enum';
@@ -80,12 +81,14 @@ export const ProductExtendedForClientSchema = ProductForClientSchema.merge(
             .object({
                 uuid: z.string(),
                 name: z.string(),
+                nameTranslations: LocalizedNameSchema,
             })
             .nullable(),
         type: z
             .object({
                 uuid: z.string(),
                 name: z.string(),
+                nameTranslations: LocalizedNameSchema,
             })
             .nullable(),
         image: z

package/schemas/type/type-create.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
+
+// Поля нового типа номенклатуры.
+export const TypeCreateSchema = z.object({
+    name: z.string(),
+    nameTranslations: LocalizedNameSchema.nullish(),
+    rank: z.number(),
+});

package/schemas/type/type-update.schema.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
+
+// Поля редактируемого типа номенклатуры. Переводы отсутствуют в теле — остаются прежними;
+// `null` и пустой объект их очищают.
+export const TypeUpdateSchema = z.object({
+    name: z.string(),
+    nameTranslations: LocalizedNameSchema.nullish(),
+    rank: z.number(),
+});

package/schemas/type/type.schema.ts

@@ -1,8 +1,10 @@
 import { z } from 'zod';
+import { LocalizedNameSchema } from '../i18n/localized-name.schema';
 
 export const TypeSchema = z.object({
     uuid: z.uuid(),
     name: z.string(),
+    nameTranslations: LocalizedNameSchema,
     rank: z.number(),
     deletedAt: z.date().nullable(),
     createdAt: z.date(),
@@ -12,5 +14,6 @@ export const TypeSchema = z.object({
 export const TypeInCategorySchema = z.object({
     uuid: z.uuid(),
     name: z.string(),
+    nameTranslations: LocalizedNameSchema,
     rank: z.number(),
 });