@fiado/type-kit 3.578.0 → 3.580.0

package/_test_/unit/retailOrg/dtos/retailerIntegration.test.ts

@@ -0,0 +1,92 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    ActivateRetailerIntegrationRequest,
+    ActivateRetailerIntegrationResponse,
+    RetailIntegrationSystemEnum,
+    Retailer,
+    RetailerStatusEnum,
+    RetailerTypeEnum,
+    RetailerValidationDto,
+} from '../../../../src/retailOrg/index';
+
+const base = {
+    retailerId: 'ret_001',
+    parentId: 'ROOT',
+    type: RetailerTypeEnum.CHAIN,
+    name: 'Tiendas del Centro',
+    legalName: 'Tiendas del Centro SA de CV',
+    rfc: 'VEN123456ABC',
+    contactEmail: 'contacto@tdc.mx',
+    contactPhone: '+525512345678',
+    address: { city: 'CDMX', region: 'CDMX', zipCode: '01000' },
+    status: RetailerStatusEnum.ACTIVE,
+    createdAt: '2026-07-14T10:00:00.000Z',
+    updatedAt: '2026-07-14T10:00:00.000Z',
+    createdBy: 'user_1',
+    updatedBy: 'user_1',
+};
+const flag = {
+    integrationSystem: RetailIntegrationSystemEnum.ZENTRAL,
+    integrationActivatedAt: '2026-10-25T10:00:00.000Z',
+    integrationActivatedBy: 'user_1',
+};
+const errorsOf = async <T extends object>(cls: new () => T, plain: object) =>
+    (await validate(plainToInstance(cls, plain))).map(e => e.property);
+
+describe('RetailIntegrationSystemEnum', () => {
+    it('solo trae ZENTRAL', () => {
+        expect(Object.values(RetailIntegrationSystemEnum)).toEqual(['ZENTRAL']);
+    });
+});
+
+describe('Retailer con bandera de integración', () => {
+    it('sin bandera sigue siendo válido', async () => {
+        expect(await errorsOf(Retailer, base)).toEqual([]);
+    });
+
+    it('con bandera completa es válido', async () => {
+        expect(await errorsOf(Retailer, { ...base, ...flag })).toEqual([]);
+    });
+
+    it('rechaza un sistema fuera del enum y una fecha no ISO', async () => {
+        const errors = await errorsOf(Retailer, { ...base, ...flag, integrationSystem: 'OTRO', integrationActivatedAt: 'ayer' });
+        expect(errors).toEqual(expect.arrayContaining(['integrationSystem', 'integrationActivatedAt']));
+    });
+
+    it('rechaza un integrationActivatedBy que no es texto', async () => {
+        expect(await errorsOf(Retailer, { ...base, ...flag, integrationActivatedBy: 7 })).toContain('integrationActivatedBy');
+    });
+});
+
+describe('RetailerValidationDto', () => {
+    it('admite la bandera opcional', () => {
+        const dto: RetailerValidationDto = {
+            retailerId: 'ret_001', name: 'x', type: RetailerTypeEnum.CHAIN, status: RetailerStatusEnum.ACTIVE, parentId: 'ROOT',
+            integrationSystem: RetailIntegrationSystemEnum.ZENTRAL, integrationActivatedAt: flag.integrationActivatedAt,
+        };
+        expect(dto.integrationSystem).toBe('ZENTRAL');
+    });
+});
+
+describe('ActivateRetailerIntegrationRequest', () => {
+    it('acepta ZENTRAL', async () => {
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL' })).toEqual([]);
+    });
+
+    it('exige integrationSystem dentro del enum', async () => {
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, {})).toContain('integrationSystem');
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, { integrationSystem: 'OTRO' })).toContain('integrationSystem');
+    });
+});
+
+describe('ActivateRetailerIntegrationResponse', () => {
+    it('es el Retailer con la bandera obligatoria', async () => {
+        const response: ActivateRetailerIntegrationResponse = plainToInstance(Retailer, { ...base, ...flag }) as ActivateRetailerIntegrationResponse;
+        expect(response.integrationSystem).toBe(RetailIntegrationSystemEnum.ZENTRAL);
+        // @ts-expect-error la bandera es obligatoria en la respuesta
+        const missing: ActivateRetailerIntegrationResponse = { ...base };
+        expect(missing).toBeDefined();
+    });
+});

package/_test_/unit/retailWizard/centralOutboundAndLiveCheck.test.ts

@@ -0,0 +1,63 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as RetailWizard from '../../../src/retailWizard';
+import { InventoryItemStatusEnum } from '../../../src/retailCatalog';
+import type { WizardReservedLine, WizardSession } from '../../../src/retailWizard';
+
+const validMessage = {
+  messageType: 'CENTRAL_SALE_REGISTER',
+  tenantId: 'tenant-1',
+  retailerId: 'retailer-1',
+  storeId: 'store-1',
+  saleId: 'sale-1',
+};
+
+const errorsOf = (plain: Record<string, unknown>) =>
+  validateSync(plainToInstance(RetailWizard.RetailCentralOutboundMessage, plain)).map((e) => e.property);
+
+describe('retailWizard — consulta en vivo, cola de salida a Central y línea LOST', () => {
+  it('WizardSession acepta centralLiveCheck opcional', () => {
+    const checked: Pick<WizardSession, 'centralLiveCheck'> = {
+      centralLiveCheck: RetailWizard.CentralLiveCheckEnum.UNVERIFIED,
+    };
+    const empty: Pick<WizardSession, 'centralLiveCheck'> = {};
+    expect(checked.centralLiveCheck).toBe('UNVERIFIED');
+    expect(empty).toEqual({});
+  });
+
+  it('RetailCentralOutboundMessageTypeEnum expone registro y cancelación', () => {
+    expect(Object.values(RetailWizard.RetailCentralOutboundMessageTypeEnum)).toEqual([
+      'CENTRAL_SALE_REGISTER', 'CENTRAL_SALE_CANCEL',
+    ]);
+  });
+
+  it('RetailCentralOutboundMessage valida un mensaje completo', () => {
+    expect(errorsOf(validMessage)).toEqual([]);
+    expect(errorsOf({ ...validMessage, messageType: 'CENTRAL_SALE_CANCEL' })).toEqual([]);
+  });
+
+  it('RetailCentralOutboundMessage rechaza messageType desconocido y campos vacíos', () => {
+    expect(errorsOf({ ...validMessage, messageType: 'SALE_COMPLETED' })).toEqual(['messageType']);
+    expect(errorsOf({ ...validMessage, saleId: '' })).toEqual(['saleId']);
+    expect(errorsOf({ messageType: 'CENTRAL_SALE_REGISTER' }).sort()).toEqual(
+      ['retailerId', 'saleId', 'storeId', 'tenantId'],
+    );
+  });
+
+  it('WizardLineStatusEnum suma LOST y conserva los anteriores', () => {
+    expect(Object.values(RetailWizard.WizardLineStatusEnum)).toEqual(['PENDING', 'RESERVED', 'RELEASING', 'LOST']);
+  });
+
+  it('WizardReservedLine acepta lostReason opcional con el estado que dejó Central', () => {
+    const lost: Pick<WizardReservedLine, 'status' | 'lostReason'> = {
+      status: RetailWizard.WizardLineStatusEnum.LOST,
+      lostReason: InventoryItemStatusEnum.SOLD,
+    };
+    const reserved: Pick<WizardReservedLine, 'status' | 'lostReason'> = {
+      status: RetailWizard.WizardLineStatusEnum.RESERVED,
+    };
+    expect(lost.lostReason).toBe('SOLD');
+    expect(reserved).toEqual({ status: 'RESERVED' });
+  });
+});

package/_test_/unit/retailWizard/centralSaleStatus.test.ts

@@ -0,0 +1,49 @@
+import 'reflect-metadata';
+import * as RetailWizard from '../../../src/retailWizard';
+import type { Sale } from '../../../src/retailWizard';
+
+describe('retailWizard — estados central de la venta', () => {
+  it('CentralSyncStatusEnum suma SENDING, ACCEPTED y REJECTED y conserva SENT', () => {
+    expect(Object.values(RetailWizard.CentralSyncStatusEnum)).toEqual([
+      'PENDING', 'SENT', 'FAILED', 'N_A', 'SENDING', 'ACCEPTED', 'REJECTED',
+    ]);
+  });
+
+  it('CentralCancelStatusEnum expone los estados de la cancelación en Central', () => {
+    expect(Object.values(RetailWizard.CentralCancelStatusEnum)).toEqual([
+      'PENDING', 'SENDING', 'ACCEPTED', 'REJECTED', 'FAILED', 'NOT_SENT',
+    ]);
+  });
+
+  it('CentralLiveCheckEnum expone el resultado de la consulta en vivo', () => {
+    expect(Object.values(RetailWizard.CentralLiveCheckEnum)).toEqual(['VERIFIED', 'UNVERIFIED']);
+  });
+
+  it('SaleExceptionTypeEnum no gana valores CENTRAL_*', () => {
+    expect(Object.values(RetailWizard.SaleExceptionTypeEnum).filter((v) => v.startsWith('CENTRAL_'))).toEqual([]);
+  });
+
+  it('Sale acepta los campos central* opcionales', () => {
+    const central: Pick<Sale,
+      | 'centralCancelStatus' | 'centralFirstAttemptAt' | 'centralRetryWindowStartAt' | 'centralLastAttemptAt'
+      | 'centralLeaseUntil' | 'centralAttempts' | 'centralLastErrorCode' | 'centralAcceptedAt'
+      | 'centralCancelFirstAttemptAt' | 'centralCancelRetryWindowStartAt' | 'centralCancelAcceptedAt'
+      | 'centralLiveCheck'> = {
+      centralCancelStatus: RetailWizard.CentralCancelStatusEnum.PENDING,
+      centralFirstAttemptAt: '2026-10-25T10:00:00.000Z',
+      centralRetryWindowStartAt: '2026-10-25T10:00:00.000Z',
+      centralLastAttemptAt: '2026-10-25T10:05:00.000Z',
+      centralLeaseUntil: '2026-10-25T10:08:00.000Z',
+      centralAttempts: 2,
+      centralLastErrorCode: 'INVALID_STORE',
+      centralAcceptedAt: '2026-10-25T10:06:00.000Z',
+      centralCancelFirstAttemptAt: '2026-10-26T10:00:00.000Z',
+      centralCancelRetryWindowStartAt: '2026-10-26T10:00:00.000Z',
+      centralCancelAcceptedAt: '2026-10-26T10:01:00.000Z',
+      centralLiveCheck: RetailWizard.CentralLiveCheckEnum.VERIFIED,
+    };
+    const empty: Pick<Sale, keyof typeof central> = {};
+    expect(Object.keys(central)).toHaveLength(12);
+    expect(empty).toEqual({});
+  });
+});

package/_test_/unit/retailWizard/multiItemShapes.test.ts

@@ -11,8 +11,8 @@ import {
 import { MdmProviderEnum, ProductCategoryEnum, TrackingModeEnum } from '../../../src/retailCatalog';
 
 describe('enums del inventario multi-item', () => {
-  it('WizardLineStatusEnum tiene los 3 estados de la línea', () => {
-    expect(Object.values(WizardLineStatusEnum)).toEqual(['PENDING', 'RESERVED', 'RELEASING']);
+  it('WizardLineStatusEnum tiene los 4 estados de la línea', () => {
+    expect(Object.values(WizardLineStatusEnum)).toEqual(['PENDING', 'RESERVED', 'RELEASING', 'LOST']);
   });
   it('LinePaymentTypeEnum distingue crédito y contado', () => {
     expect(Object.values(LinePaymentTypeEnum)).toEqual(['CREDIT', 'CASH']);

package/bin/platformRbac/dtos/UpdateLevelEntityRequest.d.ts

@@ -1,8 +1,10 @@
 /**
- * Body del PUT que renombra un grupo. `tenantId`, `level` y el id del grupo viajan en el path.
+ * Body del PUT que renombra un grupo o lo mueve de padre. `tenantId`, `level` y el id del grupo viajan en el path.
  * `actedBy` es el cognitoSub de quien accionó en el backoffice — es lo único que queda en la auditoría.
  */
 export declare class UpdateLevelEntityRequest {
     displayName?: string;
+    /** Nuevo padre del grupo; el manager lo valida igual que en el alta. */
+    parentId?: string;
     actedBy: string;
 }

package/bin/platformRbac/dtos/UpdateLevelEntityRequest.js

@@ -13,7 +13,7 @@ exports.UpdateLevelEntityRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * Body del PUT que renombra un grupo. `tenantId`, `level` y el id del grupo viajan en el path.
+ * Body del PUT que renombra un grupo o lo mueve de padre. `tenantId`, `level` y el id del grupo viajan en el path.
  * `actedBy` es el cognitoSub de quien accionó en el backoffice — es lo único que queda en la auditoría.
  */
 class UpdateLevelEntityRequest {
@@ -27,6 +27,13 @@ __decorate([
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
 ], UpdateLevelEntityRequest.prototype, "displayName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpdateLevelEntityRequest.prototype, "parentId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/retailCatalog/dtos/requests/ReturnStockRequest.d.ts

@@ -6,4 +6,6 @@ export declare class ReturnStockRequest {
     /** Fecha de la venta; fija el día de negocio del contador DAY# que se descuenta. */
     soldAt: string;
     lines: ReturnStockLine[];
+    /** Primer intento de cancelar en Central; si viene, la pieza se libera por las dos mitades. */
+    centralCancelFirstAttemptAt?: string;
 }

package/bin/retailCatalog/dtos/requests/ReturnStockRequest.js

@@ -36,3 +36,8 @@ __decorate([
     (0, class_transformer_1.Type)(() => ReturnStockLine_1.ReturnStockLine),
     __metadata("design:type", Array)
 ], ReturnStockRequest.prototype, "lines", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], ReturnStockRequest.prototype, "centralCancelFirstAttemptAt", void 0);

package/bin/retailCatalog/dtos/requests/SellInventoryRequest.d.ts

@@ -0,0 +1,9 @@
+/** Body de PUT /private/inventory/{imei}/sell (privateSellInventory); venta de una pieza por IMEI. */
+export declare class SellInventoryRequest {
+    /** Sesión del wizard titular de la reserva activa. */
+    sessionId: string;
+    /** Comprador al que se vende la pieza. */
+    customerId: string;
+    /** Venta a la que pertenece; sella la pieza con ella. */
+    saleId: string;
+}

package/bin/retailCatalog/dtos/requests/SellInventoryRequest.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SellInventoryRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Body de PUT /private/inventory/{imei}/sell (privateSellInventory); venta de una pieza por IMEI. */
+class SellInventoryRequest {
+}
+exports.SellInventoryRequest = SellInventoryRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SellInventoryRequest.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SellInventoryRequest.prototype, "customerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SellInventoryRequest.prototype, "saleId", void 0);

package/bin/retailCatalog/dtos/requests/SellStockRequest.d.ts

@@ -4,6 +4,6 @@ export declare class SellStockRequest {
     sessionId: string;
     retailerId: string;
     lines: StockLine[];
-    /** Venta a la que pertenece; liga los MOV# de la TX con ella. */
-    saleId?: string;
+    /** Venta a la que pertenece; sella las piezas y liga los MOV# de la TX con ella. */
+    saleId: string;
 }

package/bin/retailCatalog/dtos/requests/SellStockRequest.js

@@ -33,7 +33,7 @@ __decorate([
     __metadata("design:type", Array)
 ], SellStockRequest.prototype, "lines", void 0);
 __decorate([
-    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], SellStockRequest.prototype, "saleId", void 0);

package/bin/retailCatalog/dtos/responses/RenewReservationsResponse.d.ts

@@ -1,8 +1,14 @@
+import type { WizardLineStatusEnum } from '../../../retailWizard/enums/WizardLineStatusEnum';
+import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
 /** Vencimiento nuevo de una línea renovada. */
 export interface RenewedReservationLine {
     lineId: string;
     reservationId: string;
     expiresAt: string;
+    /** Solo presente si la renovación no pudo sostener la pieza (LOST). */
+    status?: WizardLineStatusEnum;
+    /** Solo en LOST: estado en que Central dejó la pieza (SOLD, IN_TRANSIT o DAMAGED). */
+    lostReason?: InventoryItemStatusEnum;
 }
 /** Response de privateRenewReservations. */
 export interface RenewReservationsResponse {

package/bin/retailCatalog/enums/InventoryInboundMessageTypeEnum.d.ts

@@ -1,5 +1,6 @@
 /** Tipo de aviso que el wizard publica en la cola de inventario del catálogo. */
 export declare enum InventoryInboundMessageTypeEnum {
     SALE_APPLIED = "SALE_APPLIED",
-    RETURN = "RETURN"
+    RETURN = "RETURN",
+    CENTRAL_SALE_ACCEPTED = "CENTRAL_SALE_ACCEPTED"
 }

package/bin/retailCatalog/enums/InventoryInboundMessageTypeEnum.js

@@ -6,4 +6,5 @@ var InventoryInboundMessageTypeEnum;
 (function (InventoryInboundMessageTypeEnum) {
     InventoryInboundMessageTypeEnum["SALE_APPLIED"] = "SALE_APPLIED";
     InventoryInboundMessageTypeEnum["RETURN"] = "RETURN";
+    InventoryInboundMessageTypeEnum["CENTRAL_SALE_ACCEPTED"] = "CENTRAL_SALE_ACCEPTED";
 })(InventoryInboundMessageTypeEnum || (exports.InventoryInboundMessageTypeEnum = InventoryInboundMessageTypeEnum = {}));

package/bin/retailCatalog/enums/InventoryItemStatusEnum.d.ts

@@ -10,6 +10,7 @@
  * @property {string} DAMAGED - Dañada, fuera de stock vendible.
  * @property {string} IN_TRANSIT - En traspaso entre tiendas, fuera de stock vendible.
  * @property {string} HELD - Capturada por una sesión de venta; no vence hasta venderse o soltarse.
+ * @property {string} INACTIVE - Baja suave; fuera de stock vendible.
  */
 export declare enum InventoryItemStatusEnum {
     AVAILABLE = "AVAILABLE",
@@ -18,5 +19,6 @@ export declare enum InventoryItemStatusEnum {
     RETURNED = "RETURNED",
     DAMAGED = "DAMAGED",
     IN_TRANSIT = "IN_TRANSIT",
-    HELD = "HELD"
+    HELD = "HELD",
+    INACTIVE = "INACTIVE"
 }

package/bin/retailCatalog/enums/InventoryItemStatusEnum.js

@@ -13,6 +13,7 @@ exports.InventoryItemStatusEnum = void 0;
  * @property {string} DAMAGED - Dañada, fuera de stock vendible.
  * @property {string} IN_TRANSIT - En traspaso entre tiendas, fuera de stock vendible.
  * @property {string} HELD - Capturada por una sesión de venta; no vence hasta venderse o soltarse.
+ * @property {string} INACTIVE - Baja suave; fuera de stock vendible.
  */
 var InventoryItemStatusEnum;
 (function (InventoryItemStatusEnum) {
@@ -23,4 +24,5 @@ var InventoryItemStatusEnum;
     InventoryItemStatusEnum["DAMAGED"] = "DAMAGED";
     InventoryItemStatusEnum["IN_TRANSIT"] = "IN_TRANSIT";
     InventoryItemStatusEnum["HELD"] = "HELD";
+    InventoryItemStatusEnum["INACTIVE"] = "INACTIVE";
 })(InventoryItemStatusEnum || (exports.InventoryItemStatusEnum = InventoryItemStatusEnum = {}));

package/bin/retailCatalog/events/InventoryCentralSaleAcceptedMessage.d.ts

@@ -0,0 +1,13 @@
+import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
+import { StockLine } from '../dtos/requests/StockLine';
+/** Aviso de que Central registró la venta; el catálogo confirma sus accesorios pendientes. */
+export declare class InventoryCentralSaleAcceptedMessage {
+    type: InventoryInboundMessageTypeEnum.CENTRAL_SALE_ACCEPTED;
+    tenantId: string;
+    retailerId: string;
+    storeId: string;
+    saleId: string;
+    lines: StockLine[];
+    /** Fecha en que Central aceptó la venta; es el acceptedAt del SKPEND#. */
+    acceptedAt: string;
+}

package/bin/retailCatalog/events/InventoryCentralSaleAcceptedMessage.js

@@ -0,0 +1,55 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryCentralSaleAcceptedMessage = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const InventoryInboundMessageTypeEnum_1 = require("../enums/InventoryInboundMessageTypeEnum");
+const StockLine_1 = require("../dtos/requests/StockLine");
+/** Aviso de que Central registró la venta; el catálogo confirma sus accesorios pendientes. */
+class InventoryCentralSaleAcceptedMessage {
+}
+exports.InventoryCentralSaleAcceptedMessage = InventoryCentralSaleAcceptedMessage;
+__decorate([
+    (0, class_validator_1.Equals)(InventoryInboundMessageTypeEnum_1.InventoryInboundMessageTypeEnum.CENTRAL_SALE_ACCEPTED),
+    __metadata("design:type", String)
+], InventoryCentralSaleAcceptedMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryCentralSaleAcceptedMessage.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryCentralSaleAcceptedMessage.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryCentralSaleAcceptedMessage.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryCentralSaleAcceptedMessage.prototype, "saleId", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => StockLine_1.StockLine),
+    __metadata("design:type", Array)
+], InventoryCentralSaleAcceptedMessage.prototype, "lines", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], InventoryCentralSaleAcceptedMessage.prototype, "acceptedAt", void 0);

package/bin/retailCatalog/events/InventoryInboundMessage.d.ts

@@ -1,4 +1,5 @@
+import type { InventoryCentralSaleAcceptedMessage } from './InventoryCentralSaleAcceptedMessage';
 import type { InventoryReturnMessage } from './InventoryReturnMessage';
 import type { InventorySaleAppliedMessage } from './InventorySaleAppliedMessage';
 /** Cualquier aviso de la cola de inventario; se discrimina por `type`. */
-export type InventoryInboundMessage = InventorySaleAppliedMessage | InventoryReturnMessage;
+export type InventoryInboundMessage = InventorySaleAppliedMessage | InventoryReturnMessage | InventoryCentralSaleAcceptedMessage;

package/bin/retailCatalog/events/InventorySaleAppliedMessage.d.ts

@@ -6,8 +6,6 @@ export declare class InventorySaleAppliedMessage extends SellStockRequest {
     /** La cola es compartida entre silos; el tenant elige las tablas. */
     tenantId: string;
     storeId: string;
-    /** El ValidateIf anula el @IsOptional que hereda de SellStockRequest: aquí saleId es obligatorio. */
-    saleId: string;
     /** Fecha de la venta; fecha el DAY# y el MOV#. */
     soldAt: string;
 }

package/bin/retailCatalog/events/InventorySaleAppliedMessage.js

@@ -31,12 +31,6 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], InventorySaleAppliedMessage.prototype, "storeId", void 0);
-__decorate([
-    (0, class_validator_1.ValidateIf)(() => true),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], InventorySaleAppliedMessage.prototype, "saleId", void 0);
 __decorate([
     (0, class_validator_1.IsISO8601)(),
     __metadata("design:type", String)

package/bin/retailCatalog/index.d.ts

@@ -46,6 +46,7 @@ export * from './dtos/requests/ReserveStockRequest';
 export * from './dtos/requests/RenewReservationsRequest';
 export * from './dtos/requests/SuggestPiecesQuery';
 export * from './dtos/requests/SellStockRequest';
+export * from './dtos/requests/SellInventoryRequest';
 export * from './dtos/requests/ReleaseStockRequest';
 export * from './dtos/requests/ReturnStockRequest';
 export * from './dtos/requests/SyncInventoryRequest';
@@ -82,4 +83,5 @@ export * from './dtos/requests/HoldStockRequest';
 export * from './dtos/responses/HoldStockResponse';
 export * from './events/InventorySaleAppliedMessage';
 export * from './events/InventoryReturnMessage';
+export * from './events/InventoryCentralSaleAcceptedMessage';
 export * from './events/InventoryInboundMessage';

package/bin/retailCatalog/index.js

@@ -70,6 +70,7 @@ __exportStar(require("./dtos/requests/ReserveStockRequest"), exports);
 __exportStar(require("./dtos/requests/RenewReservationsRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestPiecesQuery"), exports);
 __exportStar(require("./dtos/requests/SellStockRequest"), exports);
+__exportStar(require("./dtos/requests/SellInventoryRequest"), exports);
 __exportStar(require("./dtos/requests/ReleaseStockRequest"), exports);
 __exportStar(require("./dtos/requests/ReturnStockRequest"), exports);
 __exportStar(require("./dtos/requests/SyncInventoryRequest"), exports);
@@ -108,4 +109,5 @@ __exportStar(require("./dtos/requests/HoldStockRequest"), exports);
 __exportStar(require("./dtos/responses/HoldStockResponse"), exports);
 __exportStar(require("./events/InventorySaleAppliedMessage"), exports);
 __exportStar(require("./events/InventoryReturnMessage"), exports);
+__exportStar(require("./events/InventoryCentralSaleAcceptedMessage"), exports);
 __exportStar(require("./events/InventoryInboundMessage"), exports);

package/bin/retailIntegration/constants/retailIntegrationErrorHttpStatus.d.ts

@@ -0,0 +1,3 @@
+import { RetailIntegrationErrorCodeEnum } from '../enums/RetailIntegrationErrorCodeEnum';
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+export declare const RETAIL_INTEGRATION_ERROR_HTTP_STATUS: Readonly<Record<RetailIntegrationErrorCodeEnum, 404 | 409 | 422>>;

package/bin/retailIntegration/constants/retailIntegrationErrorHttpStatus.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RETAIL_INTEGRATION_ERROR_HTTP_STATUS = void 0;
+const RetailIntegrationErrorCodeEnum_1 = require("../enums/RetailIntegrationErrorCodeEnum");
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+exports.RETAIL_INTEGRATION_ERROR_HTTP_STATUS = {
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.ENTITY_MANAGED_BY_INTEGRATION]: 422,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.RECONCILIATION_ALREADY_RUNNING]: 409,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.RECONCILIATION_NOT_FOUND]: 404,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.RESERVATION_LOST]: 409,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.PRODUCT_NO_LONGER_SELLABLE]: 409,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.STORE_NOT_OPERATIONAL]: 422,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.CENTRAL_SYNC_NOT_RESENDABLE]: 409,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.SALE_NOT_FOUND]: 404,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.RETAILER_ALREADY_INTEGRATED]: 409,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.RETAILER_NOT_INTEGRATED]: 422,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.CREDIT_REQUIRES_MDM]: 422,
+    [RetailIntegrationErrorCodeEnum_1.RetailIntegrationErrorCodeEnum.RETAILER_INTEGRATION_MISMATCH]: 422,
+};

package/bin/retailIntegration/constants/retailIntegrationLimits.d.ts

@@ -18,3 +18,5 @@ export declare const RETAIL_ZIP_CODE_MAX_LENGTH = 10;
 export declare const RETAIL_SKU_PATTERN: RegExp;
 /** Decimal del contrato: string con dos decimales, nunca negativo. */
 export declare const RETAIL_DECIMAL_PATTERN: RegExp;
+/** Tope de identificadores por consulta de inventario en vivo. */
+export declare const RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = 50;

package/bin/retailIntegration/constants/retailIntegrationLimits.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RETAIL_DECIMAL_PATTERN = exports.RETAIL_SKU_PATTERN = exports.RETAIL_ZIP_CODE_MAX_LENGTH = exports.RETAIL_ZIP_CODE_MIN_LENGTH = exports.RETAIL_STORE_CODE_MAX_LENGTH = exports.RETAIL_ZONE_ID_PATTERN = exports.RETAIL_ENTITY_ID_PATTERN = exports.RETAIL_TENANT_ID_PATTERN = exports.RETAIL_LIST_LIMIT_MAX = exports.RETAIL_LIST_LIMIT_MIN = exports.RETAIL_EVENT_ID_MAX_LENGTH = void 0;
+exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = exports.RETAIL_DECIMAL_PATTERN = exports.RETAIL_SKU_PATTERN = exports.RETAIL_ZIP_CODE_MAX_LENGTH = exports.RETAIL_ZIP_CODE_MIN_LENGTH = exports.RETAIL_STORE_CODE_MAX_LENGTH = exports.RETAIL_ZONE_ID_PATTERN = exports.RETAIL_ENTITY_ID_PATTERN = exports.RETAIL_TENANT_ID_PATTERN = exports.RETAIL_LIST_LIMIT_MAX = exports.RETAIL_LIST_LIMIT_MIN = exports.RETAIL_EVENT_ID_MAX_LENGTH = void 0;
 /** Tope de `eventId`: el límite seguro de una llave de DynamoDB. */
 exports.RETAIL_EVENT_ID_MAX_LENGTH = 1024;
 /** Rango de `limit` en las listas paginadas del retailer. */
@@ -21,3 +21,5 @@ exports.RETAIL_ZIP_CODE_MAX_LENGTH = 10;
 exports.RETAIL_SKU_PATTERN = /^(?=.{1,64}$)[A-Za-z0-9-]+(?: +[A-Za-z0-9-]+)*$/;
 /** Decimal del contrato: string con dos decimales, nunca negativo. */
 exports.RETAIL_DECIMAL_PATTERN = /^\d+\.\d{2}$/;
+/** Tope de identificadores por consulta de inventario en vivo. */
+exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = 50;

package/bin/retailIntegration/dtos/CancelRetailSaleRequest.d.ts

@@ -0,0 +1,6 @@
+/** Cuerpo de `POST /private/retail/sales/cancel`; el `saleId` es el mismo del registro. */
+export declare class CancelRetailSaleRequest {
+    saleId: string;
+    cancelledAt: string;
+    reason: string;
+}

package/bin/retailIntegration/dtos/CancelRetailSaleRequest.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelRetailSaleRequest = void 0;
+const class_validator_1 = require("class-validator");
+const IsIsoDateTimeWithZone_1 = require("../validators/IsIsoDateTimeWithZone");
+/** Cuerpo de `POST /private/retail/sales/cancel`; el `saleId` es el mismo del registro. */
+class CancelRetailSaleRequest {
+}
+exports.CancelRetailSaleRequest = CancelRetailSaleRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], CancelRetailSaleRequest.prototype, "saleId", void 0);
+__decorate([
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    __metadata("design:type", String)
+], CancelRetailSaleRequest.prototype, "cancelledAt", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], CancelRetailSaleRequest.prototype, "reason", void 0);

package/bin/retailIntegration/dtos/CheckRetailInventoryRequest.d.ts

@@ -0,0 +1,7 @@
+import { RetailTenantQuery } from './RetailTenantQuery';
+/** Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv. */
+export declare class CheckRetailInventoryRequest extends RetailTenantQuery {
+    storeId: string;
+    identifiers: string[];
+    sessionId: string;
+}