@floristcloud/api-lib 1.2.161 → 1.2.162

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

@@ -1,18 +1,70 @@
-export * from './pre-order-collection-item.schema';
+export * from './create-pre-order-collection-item-response.schema';
+export * from './create-pre-order-collection-item.schema';
+export * from './delete-group-pre-order-collection-item-request.schema';
+export * from './delete-group-pre-order-collection-item-response.schema';
+export * from './delete-group-pre-order-collection-item-result.schema';
+export * from './get-active-pre-order-collection-item-list-request.schema';
+export * from './get-active-pre-order-collection-item-list-response.schema';
+export * from './get-pre-order-collection-item-grouped-list-for-client-response.schema';
+export * from './get-pre-order-collection-item-list-for-client-response.schema';
+export * from './get-pre-order-collection-item-list-request.schema';
+export * from './get-pre-order-collection-item-list-response.schema';
+export * from './get-pre-order-collection-item-response.schema';
+export * from './has-unique-supplier-add-keys.helper';
+export * from './matching-product.schema';
+export * from './pre-order-collection-item-catalog-filter-for-client-request.schema';
+export * from './pre-order-collection-item-catalog-for-client-list.schema';
+export * from './pre-order-collection-item-catalog-for-client.schema';
+export * from './pre-order-collection-item-catalog-grouped-for-client-list.schema';
+export * from './pre-order-collection-item-catalog-grouped-for-client.schema';
+export * from './pre-order-collection-item-category.schema';
 export * from './pre-order-collection-item-client-pre-order-product.schema';
-export * from './pre-order-collection-item-extended-with-clients-pre-order-product.schema';
+export * from './pre-order-collection-item-extended-for-admin-list.schema';
+export * from './pre-order-collection-item-extended-for-admin.schema';
+export * from './pre-order-collection-item-extended-list.schema';
 export * from './pre-order-collection-item-extended-with-clients-pre-order-product-list.schema';
-export * from './pre-order-collection-item-category.schema';
-export * from './pre-order-collection-item-image.schema';
+export * from './pre-order-collection-item-extended-with-clients-pre-order-product.schema';
+export * from './pre-order-collection-item-extended.schema';
+export * from './pre-order-collection-item-for-admin.schema';
 export * from './pre-order-collection-item-for-client.schema';
-export * from './pre-order-collection-item-catalog-for-client.schema';
-export * from './pre-order-collection-item-catalog-for-client-list.schema';
-export * from './pre-order-collection-item-catalog-grouped-for-client.schema';
-export * from './pre-order-collection-item-catalog-grouped-for-client-list.schema';
-export * from './pre-order-collection-item-catalog-filter-for-client-request.schema';
-export * from './get-pre-order-collection-item-list-for-client-response.schema';
-export * from './get-pre-order-collection-item-grouped-list-for-client-response.schema';
+export * from './pre-order-collection-item-image.schema';
 export * from './pre-order-collection-item-multiplicity-option.schema';
-export * from './delete-group-pre-order-collection-item-request.schema';
-export * from './delete-group-pre-order-collection-item-response.schema';
-export * from './delete-group-pre-order-collection-item-result.schema';
+export * from './pre-order-collection-item-option-update.schema';
+export * from './pre-order-collection-item-position-update.schema';
+export * from './pre-order-collection-item-supplier-admin.shape';
+export * from './pre-order-collection-item-supplier.schema';
+export * from './pre-order-collection-item-update-batch-request.schema';
+export * from './pre-order-collection-item-update-batch-response-data-errors.schema';
+export * from './pre-order-collection-item-update-batch-response-data.schema';
+export * from './pre-order-collection-item-update-batch-response.schema';
+export * from './pre-order-collection-item.schema';
+export * from './supplier-add-analyze-item.schema';
+export * from './supplier-add-analyze-offer.schema';
+export * from './supplier-add-analyze-request.schema';
+export * from './supplier-add-analyze-response-data.schema';
+export * from './supplier-add-analyze-response.schema';
+export * from './supplier-add-execute-created-item.schema';
+export * from './supplier-add-execute-item.schema';
+export * from './supplier-add-execute-request.schema';
+export * from './supplier-add-execute-response-data.schema';
+export * from './supplier-add-execute-response.schema';
+export * from './supplier-add-execute-skipped-item.schema';
+export * from './supplier-add-items-limit.constant';
+export * from './supplier-add-offer-key.schema';
+export * from './supplier-add-sale-price.schema';
+export * from './supplier-sync-analyze-item.schema';
+export * from './supplier-sync-analyze-request.schema';
+export * from './supplier-sync-analyze-response-data.schema';
+export * from './supplier-sync-analyze-response.schema';
+export * from './supplier-sync-current.schema';
+export * from './supplier-sync-execute-item.schema';
+export * from './supplier-sync-execute-request.schema';
+export * from './supplier-sync-execute-response-data.schema';
+export * from './supplier-sync-execute-response.schema';
+export * from './supplier-sync-execute-skipped-item.schema';
+export * from './supplier-sync-items-limit.constant';
+export * from './supplier-sync-proposed.schema';
+export * from './supplier-sync-stale-after-hours.constant';
+export * from './update-pre-order-collection-item-request.schema';
+export * from './update-pre-order-collection-item-response.schema';
+export * from './update-pre-order-collection-item.schema';

package/schemas/pre-order-collection-item/pre-order-collection-item-extended-for-admin-list.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { PreOrderCollectionItemExtendedForAdminSchema } from './pre-order-collection-item-extended-for-admin.schema';
+
+export const PreOrderCollectionItemExtendedForAdminListSchema = z.object({
+    list: z.array(PreOrderCollectionItemExtendedForAdminSchema),
+    total: z.number(),
+});

package/schemas/pre-order-collection-item/pre-order-collection-item-extended-for-admin.schema.ts

@@ -0,0 +1,6 @@
+import { PreOrderCollectionItemExtendedSchema } from './pre-order-collection-item-extended.schema';
+import { PreOrderCollectionItemSupplierAdminShape } from './pre-order-collection-item-supplier-admin.shape';
+
+export const PreOrderCollectionItemExtendedForAdminSchema = PreOrderCollectionItemExtendedSchema.extend(
+    PreOrderCollectionItemSupplierAdminShape,
+);

package/schemas/pre-order-collection-item/pre-order-collection-item-extended-with-clients-pre-order-product-list.schema.ts

@@ -2,6 +2,6 @@ import { z } from 'zod';
 import { PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema } from './pre-order-collection-item-extended-with-clients-pre-order-product.schema';
 
 export const PreOrderCollectionItemExtendedWithClientsPreOrderProductListSchema = z.object({
-    list: PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema.array(),
+    list: z.array(PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema),
     total: z.number(),
 });

package/schemas/pre-order-collection-item/pre-order-collection-item-extended-with-clients-pre-order-product.schema.ts

@@ -1,6 +1,7 @@
-import { PreOrderCollectionItemExtendedSchema } from './pre-order-collection-item-extended.schema';
+import { z } from 'zod';
 import { PreOrderCollectionItemClientPreOrderProductSchema } from './pre-order-collection-item-client-pre-order-product.schema';
+import { PreOrderCollectionItemExtendedSchema } from './pre-order-collection-item-extended.schema';
 
 export const PreOrderCollectionItemExtendedWithClientsPreOrderProductSchema = PreOrderCollectionItemExtendedSchema.extend({
-    clientsWithPreOrderProduct: PreOrderCollectionItemClientPreOrderProductSchema.array(),
+    clientsWithPreOrderProduct: z.array(PreOrderCollectionItemClientPreOrderProductSchema),
 });

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

@@ -1,10 +1,10 @@
 import { z } from 'zod';
-import { TypeSchema } from '../type/type.schema';
 import { CategorySchema } from '../category/category.schema';
 import { ProductImageSchema } from '../product-image/product-image.schema';
+import { TypeSchema } from '../type/type.schema';
+import { MatchingProductSchema } from './matching-product.schema';
 import { PreOrderCollectionItemMultiplicityOptionSchema } from './pre-order-collection-item-multiplicity-option.schema';
 import { PreOrderCollectionItemSchema } from './pre-order-collection-item-base.schema';
-import { MatchingProductSchema } from './matching-product.schema';
 
 export const PreOrderCollectionItemExtendedSchema = PreOrderCollectionItemSchema.extend({
     image: ProductImageSchema.nullable(),

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

@@ -0,0 +1,4 @@
+import { PreOrderCollectionItemSupplierAdminShape } from './pre-order-collection-item-supplier-admin.shape';
+import { PreOrderCollectionItemSchema } from './pre-order-collection-item-base.schema';
+
+export const PreOrderCollectionItemForAdminSchema = PreOrderCollectionItemSchema.extend(PreOrderCollectionItemSupplierAdminShape);

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

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
+
+export const PreOrderCollectionItemOptionUpdateSchema = z.object({
+    title: z.string().nullable().optional(),
+    optionMultiplicity: z.number().nullable().optional(),
+    optionPrice: MoneySchema.nullable().optional(),
+});

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

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
+import { PreOrderCollectionItemOptionUpdateSchema } from './pre-order-collection-item-option-update.schema';
+
+export const PreOrderCollectionItemPositionUpdateSchema = z.object({
+    name: z.string().nullable().optional(),
+    multiplicity: z.number().nullable().optional(),
+    quantity: z.number().nullable().optional(),
+    balance: z.number().nullable().optional(),
+    // Остаток позиции на момент анализа (его заполняет analyze): если передан, balance применяется дельтой
+    // (balance − balanceAtAnalysis) атомарно, и резервы, сделанные предзаказами после анализа, не затираются.
+    balanceAtAnalysis: z.number().nullable().optional(),
+    price: MoneySchema.nullable().optional(),
+    advancedPrice: z.string().nullable().optional(),
+    grower: z.string().nullable().optional(),
+    size: z.string().nullable().optional(),
+    size2: z.string().nullable().optional(),
+    size3: z.string().nullable().optional(),
+    color: z.string().nullable().optional(),
+    country: z.string().nullable().optional(),
+    vat: z.number().nullable().optional(),
+    description: z.string().nullable().optional(),
+    article: z.string().nullable().optional(),
+    salesUnit: z.string().nullable().optional(),
+    group: z.string().nullable().optional(),
+    multiplicityDescription: z.string().nullable().optional(),
+    option1: PreOrderCollectionItemOptionUpdateSchema.optional(),
+    option2: PreOrderCollectionItemOptionUpdateSchema.optional(),
+});

package/schemas/pre-order-collection-item/pre-order-collection-item-supplier-admin.shape.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { PreOrderCollectionItemSupplierSchema } from './pre-order-collection-item-supplier.schema';
+
+/** Поля поставщика в админских схемах позиции; витринные схемы строятся без них. */
+export const PreOrderCollectionItemSupplierAdminShape = {
+    supplier: PreOrderCollectionItemSupplierSchema.nullable(),
+    // Позицию можно синхронизировать с поставщиком: она связана с предложением (supplier != null).
+    isSupplierSyncable: z.boolean(),
+};

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

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { IntegrationProviderEnum } from '../../enum/integration-provider.enum';
+import { Decimal4Schema } from '../decimal4.schema';
+
+export const PreOrderCollectionItemSupplierSchema = z.object({
+    provider: z.nativeEnum(IntegrationProviderEnum),
+    // Код предложения у поставщика (ozexport productCode).
+    offerCode: z.string(),
+    stockType: z.string().nullable(),
+    unitUid: z.string().nullable(),
+    // Закупка за единицу в валюте поставщика, строкой до 4 знаков; null — цены нет.
+    invoicePrice: Decimal4Schema.nullable(),
+    currency: z.string().nullable(),
+    // Когда закупка была замечена у поставщика.
+    observedAt: z.coerce.date().nullable(),
+    departureDate: z.iso.date().nullable(),
+    // Последняя синхронизация позиции с предложением.
+    syncedAt: z.coerce.date().nullable(),
+    // Предложение снято у поставщика — только метка, позиция остаётся открытой/закрытой как была.
+    missingAt: z.coerce.date().nullable(),
+});

package/schemas/pre-order-collection-item/pre-order-collection-item-update-batch-request.schema.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { PreOrderCollectionItemPositionUpdateSchema } from './pre-order-collection-item-position-update.schema';
+
+export const PreOrderCollectionItemUpdateBatchRequestSchema = z.object({
+    updates: z.record(z.string(), PreOrderCollectionItemPositionUpdateSchema),
+});

package/schemas/pre-order-collection-item/pre-order-collection-item-update-batch-response-data-errors.schema.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { ErrorMessageSchema } from '../error-message.schema';
+
+export const PreOrderCollectionItemUpdateBatchResponseDataErrorsSchema = ErrorMessageSchema.extend({
+    uuid: z.string(),
+});

package/schemas/pre-order-collection-item/pre-order-collection-item-update-batch-response-data.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { PreOrderCollectionItemUpdateBatchResponseDataErrorsSchema } from './pre-order-collection-item-update-batch-response-data-errors.schema';
+
+export const PreOrderCollectionItemUpdateBatchResponseDataSchema = z.object({
+    success: z.boolean(),
+    successCount: z.number(),
+    failedCount: z.number(),
+    errors: z.array(PreOrderCollectionItemUpdateBatchResponseDataErrorsSchema),
+});

package/schemas/pre-order-collection-item/pre-order-collection-item-update-batch-response.schema.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { PreOrderCollectionItemUpdateBatchResponseDataSchema } from './pre-order-collection-item-update-batch-response-data.schema';
+
+export const PreOrderCollectionItemUpdateBatchResponseSchema = z.object({
+    data: PreOrderCollectionItemUpdateBatchResponseDataSchema,
+});

package/schemas/pre-order-collection-item/supplier-add-analyze-item.schema.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { SupplierAddSkipReasonEnum } from '../../enum/supplier-add-skip-reason.enum';
+import { SupplierAddAnalyzeOfferSchema } from './supplier-add-analyze-offer.schema';
+
+export const SupplierAddAnalyzeItemSchema = z.object({
+    productCode: z.string(),
+    stockType: z.string(),
+    name: z.string().nullable(),
+    grower: z.string().nullable(),
+    color: z.string().nullable(),
+    size: z.string().nullable(),
+    templateUUID: z.string().nullable(),
+    productImageUUID: z.string().nullable(),
+    willImportCard: z.boolean(),
+    categoryName: z.string().nullable(),
+    offer: SupplierAddAnalyzeOfferSchema.nullable(),
+    existingItemUUID: z.string().nullable(),
+    isSkipped: z.boolean(),
+    skipReason: z.nativeEnum(SupplierAddSkipReasonEnum).optional(),
+});

package/schemas/pre-order-collection-item/supplier-add-analyze-offer.schema.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { SupplierOfferStatusEnum } from '../../enum/supplier-offer-status.enum';
+import { Decimal4Schema } from '../decimal4.schema';
+
+export const SupplierAddAnalyzeOfferSchema = z.object({
+    price: Decimal4Schema.nullable(),
+    currency: z.string(),
+    observedAt: z.coerce.date(),
+    departureDate: z.iso.date().nullable(),
+    status: z.nativeEnum(SupplierOfferStatusEnum),
+    multiplicity: z.number().int(),
+    piecesInUnit: z.number().int().nullable(),
+    minOrderQuantity: z.number().int().nullable(),
+});

package/schemas/pre-order-collection-item/supplier-add-analyze-request.schema.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { IntegrationProviderEnum } from '../../enum/integration-provider.enum';
+import { hasUniqueSupplierAddKeys } from './has-unique-supplier-add-keys.helper';
+import { SUPPLIER_ADD_ITEMS_LIMIT } from './supplier-add-items-limit.constant';
+import { SupplierAddOfferKeySchema } from './supplier-add-offer-key.schema';
+
+export const SupplierAddAnalyzeRequestSchema = z.object({
+    provider: z.literal(IntegrationProviderEnum.OZEXPORT),
+    items: z
+        .array(SupplierAddOfferKeySchema)
+        .min(1)
+        .max(SUPPLIER_ADD_ITEMS_LIMIT)
+        .refine(hasUniqueSupplierAddKeys, { message: 'validation.supplierAdd.duplicateKeys' }),
+});

package/schemas/pre-order-collection-item/supplier-add-analyze-response-data.schema.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { SupplierAddAnalyzeItemSchema } from './supplier-add-analyze-item.schema';
+
+export const SupplierAddAnalyzeResponseDataSchema = z.object({
+    items: z.array(SupplierAddAnalyzeItemSchema),
+});

package/schemas/pre-order-collection-item/supplier-add-analyze-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { SupplierAddAnalyzeResponseDataSchema } from './supplier-add-analyze-response-data.schema';
+
+export const SupplierAddAnalyzeResponseSchema = z.object({
+    message: z.string().optional(),
+    data: SupplierAddAnalyzeResponseDataSchema,
+});

package/schemas/pre-order-collection-item/supplier-add-execute-created-item.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+
+export const SupplierAddExecuteCreatedItemSchema = z.object({
+    productCode: z.string(),
+    stockType: z.string(),
+    itemUUID: z.string(),
+});

package/schemas/pre-order-collection-item/supplier-add-execute-item.schema.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { SupplierAddOfferKeySchema } from './supplier-add-offer-key.schema';
+import { SupplierAddSalePriceSchema } from './supplier-add-sale-price.schema';
+
+// Кратность — Int колонки позиции (int4).
+const MULTIPLICITY_MAX = 2147483647;
+
+export const SupplierAddExecuteItemSchema = SupplierAddOfferKeySchema.extend({
+    price: SupplierAddSalePriceSchema,
+    multiplicity: z.number().int().min(1).max(MULTIPLICITY_MAX).optional(),
+    isOpen: z.boolean().optional(),
+});

package/schemas/pre-order-collection-item/supplier-add-execute-request.schema.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { IntegrationProviderEnum } from '../../enum/integration-provider.enum';
+import { hasUniqueSupplierAddKeys } from './has-unique-supplier-add-keys.helper';
+import { SupplierAddExecuteItemSchema } from './supplier-add-execute-item.schema';
+import { SUPPLIER_ADD_ITEMS_LIMIT } from './supplier-add-items-limit.constant';
+
+export const SupplierAddExecuteRequestSchema = z.object({
+    provider: z.literal(IntegrationProviderEnum.OZEXPORT),
+    items: z
+        .array(SupplierAddExecuteItemSchema)
+        .min(1)
+        .max(SUPPLIER_ADD_ITEMS_LIMIT)
+        .refine(hasUniqueSupplierAddKeys, { message: 'validation.supplierAdd.duplicateKeys' }),
+    // true — добавить и те предложения, которые в коллекции уже есть (ALREADY_IN_COLLECTION не пропускается).
+    allowDuplicates: z.boolean().optional().default(false),
+});

package/schemas/pre-order-collection-item/supplier-add-execute-response-data.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { SupplierAddExecuteCreatedItemSchema } from './supplier-add-execute-created-item.schema';
+import { SupplierAddExecuteSkippedItemSchema } from './supplier-add-execute-skipped-item.schema';
+
+export const SupplierAddExecuteResponseDataSchema = z.object({
+    createdCount: z.number().int(),
+    items: z.array(SupplierAddExecuteCreatedItemSchema),
+    skipped: z.array(SupplierAddExecuteSkippedItemSchema),
+});

package/schemas/pre-order-collection-item/supplier-add-execute-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { SupplierAddExecuteResponseDataSchema } from './supplier-add-execute-response-data.schema';
+
+export const SupplierAddExecuteResponseSchema = z.object({
+    message: z.string().optional(),
+    data: SupplierAddExecuteResponseDataSchema,
+});

package/schemas/pre-order-collection-item/supplier-add-execute-skipped-item.schema.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { SupplierAddSkipReasonEnum } from '../../enum/supplier-add-skip-reason.enum';
+
+export const SupplierAddExecuteSkippedItemSchema = z.object({
+    productCode: z.string(),
+    stockType: z.string(),
+    reason: z.nativeEnum(SupplierAddSkipReasonEnum),
+});

package/schemas/pre-order-collection-item/supplier-add-items-limit.constant.ts

@@ -0,0 +1,2 @@
+// Не больше стольких предложений за один запрос добавления из каталога поставщика (analyze и execute).
+export const SUPPLIER_ADD_ITEMS_LIMIT = 500;

package/schemas/pre-order-collection-item/supplier-add-offer-key.schema.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+const PRODUCT_CODE_MAX_LENGTH = 128;
+
+const STOCK_TYPE_MAX_LENGTH = 64;
+
+export const SupplierAddOfferKeySchema = z.object({
+    productCode: z.string().trim().min(1).max(PRODUCT_CODE_MAX_LENGTH),
+    stockType: z.string().trim().max(STOCK_TYPE_MAX_LENGTH),
+});

package/schemas/pre-order-collection-item/supplier-add-sale-price.schema.ts

@@ -0,0 +1,9 @@
+import { NonNegativeMoneySchema } from '../non-negative-money.schema';
+
+// Decimal(12,2) колонки price позиции коллекции: не больше 10 цифр целой части.
+const SALE_PRICE_INTEGER_DIGITS_MAX = 10;
+
+export const SupplierAddSalePriceSchema = NonNegativeMoneySchema.refine(
+    value => (value.split('.')[0] ?? '').replace(/^0+(?=\d)/, '').length <= SALE_PRICE_INTEGER_DIGITS_MAX,
+    { message: 'validation.money.tooLarge' },
+);

package/schemas/pre-order-collection-item/supplier-sync-analyze-item.schema.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { SupplierSyncChangeEnum } from '../../enum/supplier-sync-change.enum';
+import { SupplierSyncCurrentSchema } from './supplier-sync-current.schema';
+import { SupplierSyncProposedSchema } from './supplier-sync-proposed.schema';
+
+export const SupplierSyncAnalyzeItemSchema = z.object({
+    itemUUID: z.string(),
+    name: z.string(),
+    current: SupplierSyncCurrentSchema,
+    proposed: SupplierSyncProposedSchema.nullable(),
+    change: z.nativeEnum(SupplierSyncChangeEnum),
+    isStale: z.boolean(),
+    isSelectable: z.boolean(),
+    version: z.string(),
+});

package/schemas/pre-order-collection-item/supplier-sync-analyze-request.schema.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { SUPPLIER_SYNC_ITEMS_LIMIT } from './supplier-sync-items-limit.constant';
+
+export const SupplierSyncAnalyzeRequestSchema = z.object({
+    itemUUIDs: z.array(z.string().uuid()).min(1).max(SUPPLIER_SYNC_ITEMS_LIMIT).optional(),
+});

package/schemas/pre-order-collection-item/supplier-sync-analyze-response-data.schema.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { SupplierSyncAnalyzeItemSchema } from './supplier-sync-analyze-item.schema';
+
+export const SupplierSyncAnalyzeResponseDataSchema = z.object({
+    items: z.array(SupplierSyncAnalyzeItemSchema),
+    lastSyncAt: z.coerce.date().nullable(),
+    hasMore: z.boolean(),
+});

package/schemas/pre-order-collection-item/supplier-sync-analyze-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { SupplierSyncAnalyzeResponseDataSchema } from './supplier-sync-analyze-response-data.schema';
+
+export const SupplierSyncAnalyzeResponseSchema = z.object({
+    message: z.string().optional(),
+    data: SupplierSyncAnalyzeResponseDataSchema,
+});

package/schemas/pre-order-collection-item/supplier-sync-current.schema.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { Decimal4Schema } from '../decimal4.schema';
+
+export const SupplierSyncCurrentSchema = z.object({
+    offerCode: z.string(),
+    stockType: z.string(),
+    invoicePrice: Decimal4Schema.nullable(),
+    currency: z.string().nullable(),
+    observedAt: z.coerce.date().nullable(),
+    departureDate: z.iso.date().nullable(),
+    multiplicity: z.number().int(),
+});

package/schemas/pre-order-collection-item/supplier-sync-execute-item.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+// Версия — hex SHA-256 (64 символа); запас на смену формата.
+const VERSION_MAX_LENGTH = 128;
+
+export const SupplierSyncExecuteItemSchema = z.object({
+    itemUUID: z.string().uuid(),
+    version: z.string().min(1).max(VERSION_MAX_LENGTH),
+});

package/schemas/pre-order-collection-item/supplier-sync-execute-request.schema.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { SupplierSyncExecuteItemSchema } from './supplier-sync-execute-item.schema';
+import { SUPPLIER_SYNC_ITEMS_LIMIT } from './supplier-sync-items-limit.constant';
+
+const hasUniqueItemUUIDs = (
+    items: {
+        itemUUID: string;
+    }[],
+): boolean => new Set(items.map(item => item.itemUUID)).size === items.length;
+
+export const SupplierSyncExecuteRequestSchema = z.object({
+    items: z
+        .array(SupplierSyncExecuteItemSchema)
+        .min(1)
+        .max(SUPPLIER_SYNC_ITEMS_LIMIT)
+        .refine(hasUniqueItemUUIDs, { message: 'validation.supplierSync.duplicateItems' }),
+    // true — записать и кратность поставщика (incrementalOrderQuantity); по умолчанию кратность позиции не меняется.
+    applyMultiplicity: z.boolean().optional().default(false),
+});

package/schemas/pre-order-collection-item/supplier-sync-execute-response-data.schema.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { SupplierSyncExecuteSkippedItemSchema } from './supplier-sync-execute-skipped-item.schema';
+
+export const SupplierSyncExecuteResponseDataSchema = z.object({
+    updatedCount: z.number().int(),
+    missingMarkedCount: z.number().int(),
+    skipped: z.array(SupplierSyncExecuteSkippedItemSchema),
+});

package/schemas/pre-order-collection-item/supplier-sync-execute-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { SupplierSyncExecuteResponseDataSchema } from './supplier-sync-execute-response-data.schema';
+
+export const SupplierSyncExecuteResponseSchema = z.object({
+    message: z.string().optional(),
+    data: SupplierSyncExecuteResponseDataSchema,
+});

package/schemas/pre-order-collection-item/supplier-sync-execute-skipped-item.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { SupplierSyncSkipReasonEnum } from '../../enum/supplier-sync-skip-reason.enum';
+
+export const SupplierSyncExecuteSkippedItemSchema = z.object({
+    itemUUID: z.string(),
+    reason: z.nativeEnum(SupplierSyncSkipReasonEnum),
+});

package/schemas/pre-order-collection-item/supplier-sync-items-limit.constant.ts

@@ -0,0 +1,2 @@
+// Не больше стольких позиций за один запрос синхронизации коллекции с поставщиком (analyze и execute).
+export const SUPPLIER_SYNC_ITEMS_LIMIT = 2000;

package/schemas/pre-order-collection-item/supplier-sync-proposed.schema.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { SupplierOfferStatusEnum } from '../../enum/supplier-offer-status.enum';
+import { Decimal4Schema } from '../decimal4.schema';
+
+export const SupplierSyncProposedSchema = z.object({
+    offerCode: z.string(),
+    stockType: z.string(),
+    invoicePrice: Decimal4Schema.nullable(),
+    currency: z.string(),
+    observedAt: z.coerce.date(),
+    departureDate: z.iso.date().nullable(),
+    status: z.nativeEnum(SupplierOfferStatusEnum),
+    multiplicity: z.number().int(),
+});

package/schemas/pre-order-collection-item/supplier-sync-stale-after-hours.constant.ts

@@ -0,0 +1,2 @@
+// Предложение, наблюдавшееся у поставщика раньше стольких часов назад, в предпросмотре синхронизации помечается isStale.
+export const SUPPLIER_SYNC_STALE_AFTER_HOURS = 36;

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

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { UpdatePreOrderCollectionItemSchema } from './update-pre-order-collection-item.schema';
+
+export const UpdatePreOrderCollectionItemRequestSchema = UpdatePreOrderCollectionItemSchema.extend({
+    // Переданный вместе с balance expectedBalance защищает резерв предзаказа от перезаписи устаревшим остатком:
+    // несовпадение отклоняет запись с HTTP 409 (PRE_ORDER_LOCK_CONFLICT).
+    expectedBalance: z.coerce.number().nullable().optional(),
+});

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

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { PreOrderCollectionItemForAdminSchema } from './pre-order-collection-item-for-admin.schema';
+
+export const UpdatePreOrderCollectionItemResponseSchema = z.object({
+    message: z.string().optional(),
+    data: PreOrderCollectionItemForAdminSchema,
+});

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { SalesUnitEnum } from '../../enum';
+import { SalesUnitEnum } from '../../enum/sales-unit.enum';
 import { MoneySchema } from '../money.schema';
 
 export const UpdatePreOrderCollectionItemSchema = z
@@ -7,7 +7,8 @@ export const UpdatePreOrderCollectionItemSchema = z
         productUUID: z.string().nullable(),
         categoryUUID: z.string(),
         isOpen: z.boolean(),
-        preOrderCollectionUUID: z.string(),
+        // preOrderCollectionUUID нет: перенос позиции в другую коллекцию — только через group-actions/move (он
+        // переносит и предзаказы); правка поля напрямую оставляла бы предзаказы в старой коллекции.
         name: z.string(),
         multiplicity: z.coerce.number(),
         quantity: z.coerce.number().nullable(),

package/schemas/pre-order-product/create-pre-order-product.schema.ts

@@ -1,9 +1,11 @@
 import { z } from 'zod';
 import { MoneySchema } from '../money.schema';
 import { MatchingConfigSchema } from './matching-config.schema';
+import { PreOrderProductQuantityRequestSchema } from './pre-order-product-quantity-request.schema';
 import { PreOrderProductSchema } from './pre-order-product-base.schema';
 
 export const CreatePreOrderProductSchema = PreOrderProductSchema.omit({ uuid: true, preOrderUUID: true }).extend({
+    quantity: PreOrderProductQuantityRequestSchema,
     multiplicityOptionUUID: z.uuid().nullable().optional(),
     categoryUUID: z.string().nullable().optional(),
     name: z.string().nullable().optional(),

package/schemas/pre-order-product/delete-many-pre-order-product-by-pre-order-collection-item-response-data.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export const DeleteManyPreOrderProductByPreOrderCollectionItemResponseDataSchema = z.object({
+    success: z.boolean(),
+    // Сколько строк снято этим запросом.
+    deletedCount: z.number().int(),
+    // Сколько строк оставлено: их предзаказ уже сконвертирован в заказ (COMPLETED), строка — часть заказа.
+    skippedCompletedCount: z.number().int(),
+});