@fiado/type-kit 3.584.0 → 3.586.0

package/bin/retailIntegration/constants/retailIntegrationLimits.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RETAIL_EVENT_DECIMAL_PATTERN = exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = exports.RETAIL_EVENT_STOCK_MAX = exports.RETAIL_LONG_TEXT_MAX_LENGTH = exports.RETAIL_SHORT_TEXT_MAX_LENGTH = exports.RETAIL_ID_TEXT_MAX_LENGTH = exports.RETAIL_EVENT_PIECES_MAX = 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;
+exports.RETAIL_MOVEMENTS_RANGE_MAX_MS = exports.RETAIL_LINE_INDEX_MAX = exports.RETAIL_LINE_INDEX_MIN = exports.RETAIL_ERROR_CODE_MAX_LENGTH = exports.RETAIL_EXTERNAL_ID_PATTERN = exports.RETAIL_NEXT_TOKEN_MAX_LENGTH = exports.RETAIL_EVENT_DECIMAL_PATTERN = exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = exports.RETAIL_EVENT_STOCK_MAX = exports.RETAIL_LONG_TEXT_MAX_LENGTH = exports.RETAIL_SHORT_TEXT_MAX_LENGTH = exports.RETAIL_ID_TEXT_MAX_LENGTH = exports.RETAIL_EVENT_PIECES_MAX = 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. */
@@ -37,3 +37,14 @@ exports.RETAIL_EVENT_STOCK_MAX = 200;
 exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = 50;
 /** Decimal de los eventos del retailer: hasta 12 enteros y dos decimales, nunca negativo. */
 exports.RETAIL_EVENT_DECIMAL_PATTERN = /^\d{1,12}\.\d{2}$/;
+/** Tope del `nextToken` opaco que devuelve Zentral. */
+exports.RETAIL_NEXT_TOKEN_MAX_LENGTH = 2048;
+/** Id que asigna Zentral, como `externalSaleId`: no vacío, sin espacios y de a lo más 64. */
+exports.RETAIL_EXTERNAL_ID_PATTERN = /^\S{1,64}$/;
+/** Tope del `code` en el cuerpo de error de Zentral. */
+exports.RETAIL_ERROR_CODE_MAX_LENGTH = 64;
+/** Rango de `lineIndex` en un error de línea de venta. */
+exports.RETAIL_LINE_INDEX_MIN = 0;
+exports.RETAIL_LINE_INDEX_MAX = 999;
+/** Rango máximo de `GET /inventory/movements`: 7 días en milisegundos. */
+exports.RETAIL_MOVEMENTS_RANGE_MAX_MS = 7 * 24 * 60 * 60 * 1000;

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

@@ -1,5 +1,8 @@
 import { RetailTenantQuery } from './RetailTenantQuery';
-/** Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv. */
+/**
+ * Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv.
+ * @deprecated el live-check se va a quitar; el inventario se toma de movimientos y de la lectura diaria.
+ */
 export declare class CheckRetailInventoryRequest extends RetailTenantQuery {
     storeId: string;
     identifiers: string[];

package/bin/retailIntegration/dtos/CheckRetailInventoryRequest.js

@@ -18,7 +18,10 @@ const RetailTenantQuery_1 = require("./RetailTenantQuery");
 function csvToArray({ value }) {
     return typeof value === 'string' ? value.split(',').map((item) => item.trim()) : value;
 }
-/** Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv. */
+/**
+ * Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv.
+ * @deprecated el live-check se va a quitar; el inventario se toma de movimientos y de la lectura diaria.
+ */
 class CheckRetailInventoryRequest extends RetailTenantQuery_1.RetailTenantQuery {
 }
 exports.CheckRetailInventoryRequest = CheckRetailInventoryRequest;

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

@@ -1,5 +1,5 @@
-import { RetailListQuery } from './RetailListQuery';
-/** Query de `GET /private/retail/inventory`; el inventario es por tienda y no pagina. */
-export declare class GetRetailInventoryRequest extends RetailListQuery {
+import { RetailPagedQuery } from './RetailPagedQuery';
+/** Query de `GET /private/retail/inventory`; el inventario es por tienda y pagina con `limit`/`nextToken`. */
+export declare class GetRetailInventoryRequest extends RetailPagedQuery {
     storeId: string;
 }

package/bin/retailIntegration/dtos/GetRetailInventoryRequest.js

@@ -11,9 +11,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetRetailInventoryRequest = void 0;
 const class_validator_1 = require("class-validator");
-const RetailListQuery_1 = require("./RetailListQuery");
-/** Query de `GET /private/retail/inventory`; el inventario es por tienda y no pagina. */
-class GetRetailInventoryRequest extends RetailListQuery_1.RetailListQuery {
+const RetailPagedQuery_1 = require("./RetailPagedQuery");
+/** Query de `GET /private/retail/inventory`; el inventario es por tienda y pagina con `limit`/`nextToken`. */
+class GetRetailInventoryRequest extends RetailPagedQuery_1.RetailPagedQuery {
 }
 exports.GetRetailInventoryRequest = GetRetailInventoryRequest;
 __decorate([

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

@@ -0,0 +1,6 @@
+import { RetailPagedQuery } from './RetailPagedQuery';
+/** Query de `GET /private/retail/inventory/movements`: rango `[from, to)` de a lo más 7 días. */
+export declare class ListRetailInventoryMovementsRequest extends RetailPagedQuery {
+    from: string;
+    to: string;
+}

package/bin/retailIntegration/dtos/ListRetailInventoryMovementsRequest.js

@@ -0,0 +1,29 @@
+"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.ListRetailInventoryMovementsRequest = void 0;
+const class_validator_1 = require("class-validator");
+const IsIsoDateTimeWithZone_1 = require("../validators/IsIsoDateTimeWithZone");
+const IsMovementsRangeValid_1 = require("../validators/IsMovementsRangeValid");
+const RetailPagedQuery_1 = require("./RetailPagedQuery");
+/** Query de `GET /private/retail/inventory/movements`: rango `[from, to)` de a lo más 7 días. */
+class ListRetailInventoryMovementsRequest extends RetailPagedQuery_1.RetailPagedQuery {
+}
+exports.ListRetailInventoryMovementsRequest = ListRetailInventoryMovementsRequest;
+__decorate([
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    __metadata("design:type", String)
+], ListRetailInventoryMovementsRequest.prototype, "from", void 0);
+__decorate([
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    (0, class_validator_1.Validate)(IsMovementsRangeValid_1.IsMovementsRangeValid),
+    __metadata("design:type", String)
+], ListRetailInventoryMovementsRequest.prototype, "to", void 0);

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

@@ -12,4 +12,10 @@ export declare class ReconciliationPageMessage {
     storeId?: string;
     /** Veces que el mensaje ya se re-encoló. */
     requeueCount?: number;
+    /** Cursor de Zentral para la siguiente página del inventario de la tienda. */
+    nextToken?: string;
+    /** Inicio del rango de movimientos, incluido. */
+    from?: string;
+    /** Fin del rango de movimientos, excluido. */
+    to?: string;
 }

package/bin/retailIntegration/dtos/ReconciliationPageMessage.js

@@ -13,6 +13,7 @@ exports.ReconciliationPageMessage = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const ReconciliationEntityEnum_1 = require("../enums/ReconciliationEntityEnum");
+const IsIsoDateTimeWithZone_1 = require("../validators/IsIsoDateTimeWithZone");
 /** Mensaje de la cola de revisión: una página, o una tienda completa en inventario. */
 class ReconciliationPageMessage {
 }
@@ -60,3 +61,22 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], ReconciliationPageMessage.prototype, "requeueCount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], ReconciliationPageMessage.prototype, "nextToken", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    __metadata("design:type", String)
+], ReconciliationPageMessage.prototype, "from", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    __metadata("design:type", String)
+], ReconciliationPageMessage.prototype, "to", void 0);

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

@@ -1,5 +1,5 @@
 import { RetailInventoryMeta, RetailPageMeta } from '../models/RetailPageMeta';
-import { RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
+import { RetailSystemInventoryMovement, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
 import { RetailSystemProduct } from '../models/RetailSystemProduct';
 import { RetailSystemStore } from '../models/RetailSystemStore';
 import { RetailSystemUser } from '../models/RetailSystemUser';
@@ -19,6 +19,11 @@ export interface GetRetailInventoryResponse {
     stock: RetailSystemStock[];
     meta: RetailInventoryMeta;
 }
+/** `data` de `GET /private/retail/inventory/movements`. */
+export interface ListRetailInventoryMovementsResponse {
+    items: RetailSystemInventoryMovement[];
+    meta: RetailPageMeta;
+}
 /** `data` de `GET /private/retail/users`. */
 export interface ListRetailUsersResponse {
     items: RetailSystemUser[];
@@ -32,7 +37,10 @@ export interface RegisterRetailSaleResponse {
 export interface CancelRetailSaleResponse {
     saleId: string;
 }
-/** `data` de `GET /private/retail/inventory/live-check`: los identificadores que el retailer lista en la tienda. */
+/**
+ * `data` de `GET /private/retail/inventory/live-check`: los identificadores que el retailer lista en la tienda.
+ * @deprecated el live-check se va a quitar; el inventario se toma de movimientos y de la lectura diaria.
+ */
 export interface CheckRetailInventoryResponse {
     listed: string[];
     generatedAt: string;

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

@@ -0,0 +1,41 @@
+import { ReceiveInventoryEventRequest } from './ReceiveInventoryEventRequest';
+/** `meta` de una página de Zentral; `nextToken` en `null` cierra la lectura y nunca se omite. */
+export declare class RetailSystemPageMeta {
+    count: number;
+    nextToken: string | null;
+}
+/** Página de una lista de Zentral; cada consumidor valida sus renglones de `data`. */
+export declare class RetailSystemPageResponse {
+    data: unknown[];
+    meta: RetailSystemPageMeta;
+}
+/** `data` de una página de `GET /inventory`: piezas y existencias crudas. */
+export declare class RetailSystemInventoryData {
+    pieces: unknown[];
+    stock: unknown[];
+}
+/** `meta` de una página de `GET /inventory`; `generatedAt` es igual en toda la lectura. */
+export declare class RetailSystemInventoryMeta extends RetailSystemPageMeta {
+    storeId: string;
+    generatedAt: string;
+}
+/** Respuesta de `GET /inventory` de Zentral. */
+export declare class RetailSystemInventoryResponse {
+    data: RetailSystemInventoryData;
+    meta: RetailSystemInventoryMeta;
+}
+/** `data` de `POST /sales` de Zentral. */
+export declare class RetailSystemSaleResponse {
+    externalSaleId: string;
+}
+/** Cuerpo de error de Zentral; `lineIndex` solo viene en errores de una línea de venta. */
+export declare class RetailSystemErrorBody {
+    code: string;
+    msg?: string;
+    lineIndex?: number;
+}
+/** Respuesta de `GET /inventory/movements`: cada elemento es el mismo sobre del webhook de inventario. */
+export declare class RetailSystemMovementsResponse {
+    data: ReceiveInventoryEventRequest[];
+    meta: RetailSystemPageMeta;
+}

package/bin/retailIntegration/dtos/RetailSystemResponses.js

@@ -0,0 +1,136 @@
+"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.RetailSystemMovementsResponse = exports.RetailSystemErrorBody = exports.RetailSystemSaleResponse = exports.RetailSystemInventoryResponse = exports.RetailSystemInventoryMeta = exports.RetailSystemInventoryData = exports.RetailSystemPageResponse = exports.RetailSystemPageMeta = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const retailIntegrationLimits_1 = require("../constants/retailIntegrationLimits");
+const IsIsoDateTimeWithZone_1 = require("../validators/IsIsoDateTimeWithZone");
+const payloadValidators_1 = require("../validators/payloadValidators");
+const ReceiveInventoryEventRequest_1 = require("./ReceiveInventoryEventRequest");
+/** `meta` de una página de Zentral; `nextToken` en `null` cierra la lectura y nunca se omite. */
+class RetailSystemPageMeta {
+}
+exports.RetailSystemPageMeta = RetailSystemPageMeta;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailSystemPageMeta.prototype, "count", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_NEXT_TOKEN_MAX_LENGTH),
+    __metadata("design:type", String)
+], RetailSystemPageMeta.prototype, "nextToken", void 0);
+/** Página de una lista de Zentral; cada consumidor valida sus renglones de `data`. */
+class RetailSystemPageResponse {
+}
+exports.RetailSystemPageResponse = RetailSystemPageResponse;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RetailSystemPageResponse.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemPageMeta),
+    __metadata("design:type", RetailSystemPageMeta)
+], RetailSystemPageResponse.prototype, "meta", void 0);
+/** `data` de una página de `GET /inventory`: piezas y existencias crudas. */
+class RetailSystemInventoryData {
+}
+exports.RetailSystemInventoryData = RetailSystemInventoryData;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RetailSystemInventoryData.prototype, "pieces", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RetailSystemInventoryData.prototype, "stock", void 0);
+/** `meta` de una página de `GET /inventory`; `generatedAt` es igual en toda la lectura. */
+class RetailSystemInventoryMeta extends RetailSystemPageMeta {
+}
+exports.RetailSystemInventoryMeta = RetailSystemInventoryMeta;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_ENTITY_ID_PATTERN),
+    __metadata("design:type", String)
+], RetailSystemInventoryMeta.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    __metadata("design:type", String)
+], RetailSystemInventoryMeta.prototype, "generatedAt", void 0);
+/** Respuesta de `GET /inventory` de Zentral. */
+class RetailSystemInventoryResponse {
+}
+exports.RetailSystemInventoryResponse = RetailSystemInventoryResponse;
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemInventoryData),
+    __metadata("design:type", RetailSystemInventoryData)
+], RetailSystemInventoryResponse.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemInventoryMeta),
+    __metadata("design:type", RetailSystemInventoryMeta)
+], RetailSystemInventoryResponse.prototype, "meta", void 0);
+/** `data` de `POST /sales` de Zentral. */
+class RetailSystemSaleResponse {
+}
+exports.RetailSystemSaleResponse = RetailSystemSaleResponse;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_ID_TEXT_MAX_LENGTH),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_EXTERNAL_ID_PATTERN),
+    __metadata("design:type", String)
+], RetailSystemSaleResponse.prototype, "externalSaleId", void 0);
+/** Cuerpo de error de Zentral; `lineIndex` solo viene en errores de una línea de venta. */
+class RetailSystemErrorBody {
+}
+exports.RetailSystemErrorBody = RetailSystemErrorBody;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_ERROR_CODE_MAX_LENGTH),
+    __metadata("design:type", String)
+], RetailSystemErrorBody.prototype, "code", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailSystemErrorBody.prototype, "msg", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(retailIntegrationLimits_1.RETAIL_LINE_INDEX_MIN),
+    (0, class_validator_1.Max)(retailIntegrationLimits_1.RETAIL_LINE_INDEX_MAX),
+    __metadata("design:type", Number)
+], RetailSystemErrorBody.prototype, "lineIndex", void 0);
+/** Respuesta de `GET /inventory/movements`: cada elemento es el mismo sobre del webhook de inventario. */
+class RetailSystemMovementsResponse {
+}
+exports.RetailSystemMovementsResponse = RetailSystemMovementsResponse;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReceiveInventoryEventRequest_1.ReceiveInventoryEventRequest),
+    __metadata("design:type", Array)
+], RetailSystemMovementsResponse.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemPageMeta),
+    __metadata("design:type", RetailSystemPageMeta)
+], RetailSystemMovementsResponse.prototype, "meta", void 0);

package/bin/retailIntegration/enums/ReconciliationEntityEnum.d.ts

@@ -3,5 +3,6 @@ export declare enum ReconciliationEntityEnum {
     STORES = "STORES",
     USERS = "USERS",
     CATALOG = "CATALOG",
-    INVENTORY = "INVENTORY"
+    INVENTORY = "INVENTORY",
+    MOVEMENTS = "MOVEMENTS"
 }

package/bin/retailIntegration/enums/ReconciliationEntityEnum.js

@@ -8,4 +8,5 @@ var ReconciliationEntityEnum;
     ReconciliationEntityEnum["USERS"] = "USERS";
     ReconciliationEntityEnum["CATALOG"] = "CATALOG";
     ReconciliationEntityEnum["INVENTORY"] = "INVENTORY";
+    ReconciliationEntityEnum["MOVEMENTS"] = "MOVEMENTS";
 })(ReconciliationEntityEnum || (exports.ReconciliationEntityEnum = ReconciliationEntityEnum = {}));

package/bin/retailIntegration/enums/ReconciliationTriggerEnum.d.ts

@@ -1,6 +1,8 @@
-/** Quién abrió la corrida: el reloj horario, el botón «Actualizar» o la activación del retailer. */
+/** Quién abrió la corrida: el reloj horario o diario, el botón «Actualizar», la activación o una discrepancia. */
 export declare enum ReconciliationTriggerEnum {
     SCHEDULED = "SCHEDULED",
     MANUAL = "MANUAL",
-    ACTIVATION = "ACTIVATION"
+    ACTIVATION = "ACTIVATION",
+    DISCREPANCY = "DISCREPANCY",
+    DAILY = "DAILY"
 }

package/bin/retailIntegration/enums/ReconciliationTriggerEnum.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReconciliationTriggerEnum = void 0;
-/** Quién abrió la corrida: el reloj horario, el botón «Actualizar» o la activación del retailer. */
+/** Quién abrió la corrida: el reloj horario o diario, el botón «Actualizar», la activación o una discrepancia. */
 var ReconciliationTriggerEnum;
 (function (ReconciliationTriggerEnum) {
     ReconciliationTriggerEnum["SCHEDULED"] = "SCHEDULED";
     ReconciliationTriggerEnum["MANUAL"] = "MANUAL";
     ReconciliationTriggerEnum["ACTIVATION"] = "ACTIVATION";
+    ReconciliationTriggerEnum["DISCREPANCY"] = "DISCREPANCY";
+    ReconciliationTriggerEnum["DAILY"] = "DAILY";
 })(ReconciliationTriggerEnum || (exports.ReconciliationTriggerEnum = ReconciliationTriggerEnum = {}));

package/bin/retailIntegration/index.d.ts

@@ -2,6 +2,7 @@ export * from './constants/retailIntegrationLimits';
 export * from './constants/retailIntegrationErrorHttpStatus';
 export * from './enums';
 export * from './validators/IsIsoDateTimeWithZone';
+export * from './validators/IsMovementsRangeValid';
 export * from './dtos/RetailEventEnvelope';
 export * from './dtos/ReceiveStoreEventRequest';
 export * from './dtos/ReceiveRetailUserEventRequest';
@@ -21,11 +22,13 @@ export * from './dtos/RetailPagedQuery';
 export * from './dtos/ListRetailStoresRequest';
 export * from './dtos/ListRetailCatalogRequest';
 export * from './dtos/GetRetailInventoryRequest';
+export * from './dtos/ListRetailInventoryMovementsRequest';
 export * from './dtos/ListRetailUsersRequest';
 export * from './dtos/RegisterRetailSaleRequest';
 export * from './dtos/CancelRetailSaleRequest';
 export * from './dtos/CheckRetailInventoryRequest';
 export * from './dtos/RetailOutboundResponses';
+export * from './dtos/RetailSystemResponses';
 export * from './models/RetailPageMeta';
 export * from './models/RetailSystemStore';
 export * from './models/RetailSystemProduct';

package/bin/retailIntegration/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./constants/retailIntegrationLimits"), exports);
 __exportStar(require("./constants/retailIntegrationErrorHttpStatus"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./validators/IsIsoDateTimeWithZone"), exports);
+__exportStar(require("./validators/IsMovementsRangeValid"), exports);
 __exportStar(require("./dtos/RetailEventEnvelope"), exports);
 __exportStar(require("./dtos/ReceiveStoreEventRequest"), exports);
 __exportStar(require("./dtos/ReceiveRetailUserEventRequest"), exports);
@@ -37,11 +38,13 @@ __exportStar(require("./dtos/RetailPagedQuery"), exports);
 __exportStar(require("./dtos/ListRetailStoresRequest"), exports);
 __exportStar(require("./dtos/ListRetailCatalogRequest"), exports);
 __exportStar(require("./dtos/GetRetailInventoryRequest"), exports);
+__exportStar(require("./dtos/ListRetailInventoryMovementsRequest"), exports);
 __exportStar(require("./dtos/ListRetailUsersRequest"), exports);
 __exportStar(require("./dtos/RegisterRetailSaleRequest"), exports);
 __exportStar(require("./dtos/CancelRetailSaleRequest"), exports);
 __exportStar(require("./dtos/CheckRetailInventoryRequest"), exports);
 __exportStar(require("./dtos/RetailOutboundResponses"), exports);
+__exportStar(require("./dtos/RetailSystemResponses"), exports);
 __exportStar(require("./models/RetailPageMeta"), exports);
 __exportStar(require("./models/RetailSystemStore"), exports);
 __exportStar(require("./models/RetailSystemProduct"), exports);

package/bin/retailIntegration/models/RetailPageMeta.d.ts

@@ -3,8 +3,10 @@ export interface RetailPageMeta {
     count: number;
     nextToken: string | null;
 }
-/** `meta` del inventario de una tienda. */
+/** `meta` del inventario de una tienda; `count` y `nextToken` llegan cuando la lectura pagina. */
 export interface RetailInventoryMeta {
     storeId: string;
     generatedAt: string;
+    count?: number;
+    nextToken?: string | null;
 }

package/bin/retailIntegration/models/RetailSystemInventory.d.ts

@@ -1,4 +1,5 @@
-import { RetailPieceReasonEnum, RetailPieceStatusEnum } from '../enums';
+import type { InventoryEventPayload } from '../dtos/InventoryEventPayload';
+import { InventoryEventTypeEnum, RetailPieceReasonEnum, RetailPieceStatusEnum } from '../enums';
 export type RetailPieceStatus = `${RetailPieceStatusEnum}`;
 export type RetailPieceReason = `${RetailPieceReasonEnum}`;
 /** Pieza con IMEI o número de serie. */
@@ -15,3 +16,10 @@ export interface RetailSystemStock {
     storeId: string;
     qty: number;
 }
+/** Movimiento de inventario de Zentral: el mismo sobre que llega a `POST /webhooks/inventory`. */
+export interface RetailSystemInventoryMovement {
+    eventId: string;
+    eventType: `${InventoryEventTypeEnum}`;
+    occurredAt: string;
+    payload: InventoryEventPayload;
+}

package/bin/retailIntegration/validators/IsMovementsRangeValid.d.ts

@@ -0,0 +1,6 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/** `to`: mayor que `from` y a lo más 7 días después; sin `from` legible lo rechaza su propio validador. */
+export declare class IsMovementsRangeValid implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailIntegration/validators/IsMovementsRangeValid.js

@@ -0,0 +1,28 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsMovementsRangeValid = void 0;
+const class_validator_1 = require("class-validator");
+const retailIntegrationLimits_1 = require("../constants/retailIntegrationLimits");
+/** `to`: mayor que `from` y a lo más 7 días después; sin `from` legible lo rechaza su propio validador. */
+let IsMovementsRangeValid = class IsMovementsRangeValid {
+    validate(value, args) {
+        const from = Date.parse(String(args.object.from));
+        const to = Date.parse(String(value));
+        if (Number.isNaN(from) || Number.isNaN(to))
+            return true;
+        return to > from && to - from <= retailIntegrationLimits_1.RETAIL_MOVEMENTS_RANGE_MAX_MS;
+    }
+    defaultMessage() {
+        return 'to debe ser mayor que from y a lo más 7 días después';
+    }
+};
+exports.IsMovementsRangeValid = IsMovementsRangeValid;
+exports.IsMovementsRangeValid = IsMovementsRangeValid = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isMovementsRangeValid', async: false })
+], IsMovementsRangeValid);

package/bin/rewards/dtos/backoffice/BackofficeGrantItemResponse.d.ts

@@ -1,7 +1,16 @@
 import { GrantItemResponse } from '../responses/GrantItemResponse';
+import { LimitWaitReasonEnum } from '../../enums/LimitWaitReasonEnum';
 import { BackofficeGrantAttemptResponse } from './BackofficeGrantAttemptResponse';
 export declare class BackofficeGrantItemResponse extends GrantItemResponse {
     /** Nombre de la recompensa congelada en la entrega. */
     name: string;
     attempts: BackofficeGrantAttemptResponse[];
+    /** Motivo de la espera por tope; solo cuando el ítem está en `WAITING_LIMIT`. */
+    waitReason?: LimitWaitReasonEnum;
+    /** Epoch ms del próximo intento programado. */
+    retryNotBefore?: number;
+    /** Epoch ms en que el ítem entró en espera. */
+    waitingSince?: number;
+    /** Cantidad de rechazos por tope acumulados. */
+    limitRejections?: number;
 }

package/bin/rewards/enums/GrantItemStatusEnum.d.ts

@@ -5,6 +5,8 @@ export declare enum GrantItemStatusEnum {
      * ocurrido y el adaptador debe reconciliar antes de reintentar.
      */
     PROCESSING = "PROCESSING",
+    /** Espera por tope de nivel de la cuenta destino: no es `PROCESSING` ni `FAILED`; se reintenta solo. */
+    WAITING_LIMIT = "WAITING_LIMIT",
     GRANTED = "GRANTED",
     FAILED = "FAILED",
     SKIPPED = "SKIPPED"

package/bin/rewards/enums/GrantItemStatusEnum.js

@@ -9,6 +9,8 @@ var GrantItemStatusEnum;
      * ocurrido y el adaptador debe reconciliar antes de reintentar.
      */
     GrantItemStatusEnum["PROCESSING"] = "PROCESSING";
+    /** Espera por tope de nivel de la cuenta destino: no es `PROCESSING` ni `FAILED`; se reintenta solo. */
+    GrantItemStatusEnum["WAITING_LIMIT"] = "WAITING_LIMIT";
     GrantItemStatusEnum["GRANTED"] = "GRANTED";
     GrantItemStatusEnum["FAILED"] = "FAILED";
     GrantItemStatusEnum["SKIPPED"] = "SKIPPED";

package/bin/rewards/enums/LimitWaitReasonEnum.d.ts

@@ -0,0 +1,7 @@
+/** Motivo por el que un ítem espera: `processorCode` del rechazo por tope de nivel de la cuenta destino. */
+export declare enum LimitWaitReasonEnum {
+    /** Tope mensual de monto del nivel de la cuenta. */
+    MONTHLY_AMOUNT_EXCEEDED = "ACCOUNT_LEVEL_MAX_MONTHLY_AMOUNT_EXCEEDED",
+    /** Tope de saldo disponible del nivel de la cuenta. */
+    AVAILABLE_BALANCE_EXCEEDED = "ACCOUNT_LEVEL_MAX_AVAILABLE_BALANCE_EXCEEDED"
+}

package/bin/rewards/enums/LimitWaitReasonEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitWaitReasonEnum = void 0;
+/** Motivo por el que un ítem espera: `processorCode` del rechazo por tope de nivel de la cuenta destino. */
+var LimitWaitReasonEnum;
+(function (LimitWaitReasonEnum) {
+    /** Tope mensual de monto del nivel de la cuenta. */
+    LimitWaitReasonEnum["MONTHLY_AMOUNT_EXCEEDED"] = "ACCOUNT_LEVEL_MAX_MONTHLY_AMOUNT_EXCEEDED";
+    /** Tope de saldo disponible del nivel de la cuenta. */
+    LimitWaitReasonEnum["AVAILABLE_BALANCE_EXCEEDED"] = "ACCOUNT_LEVEL_MAX_AVAILABLE_BALANCE_EXCEEDED";
+})(LimitWaitReasonEnum || (exports.LimitWaitReasonEnum = LimitWaitReasonEnum = {}));

package/bin/rewards/enums/RewardItemCodeEnum.d.ts

@@ -0,0 +1,9 @@
+/** Códigos de resultado de un ítem de entrega que no vienen del proveedor. */
+export declare enum RewardItemCodeEnum {
+    /** El monto del ítem supera el máximo permitido. */
+    AMOUNT_ABOVE_MAX = "AMOUNT_ABOVE_MAX",
+    /** Venció la espera por tope (30 días desde `waitingSince`). */
+    LIMIT_WAIT_EXPIRED = "LIMIT_WAIT_EXPIRED",
+    /** Resultado desconocido agotado: no se puede asegurar si el abono ocurrió. */
+    OUTCOME_UNKNOWN = "OUTCOME_UNKNOWN"
+}

package/bin/rewards/enums/RewardItemCodeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardItemCodeEnum = void 0;
+/** Códigos de resultado de un ítem de entrega que no vienen del proveedor. */
+var RewardItemCodeEnum;
+(function (RewardItemCodeEnum) {
+    /** El monto del ítem supera el máximo permitido. */
+    RewardItemCodeEnum["AMOUNT_ABOVE_MAX"] = "AMOUNT_ABOVE_MAX";
+    /** Venció la espera por tope (30 días desde `waitingSince`). */
+    RewardItemCodeEnum["LIMIT_WAIT_EXPIRED"] = "LIMIT_WAIT_EXPIRED";
+    /** Resultado desconocido agotado: no se puede asegurar si el abono ocurrió. */
+    RewardItemCodeEnum["OUTCOME_UNKNOWN"] = "OUTCOME_UNKNOWN";
+})(RewardItemCodeEnum || (exports.RewardItemCodeEnum = RewardItemCodeEnum = {}));

package/bin/rewards/index.d.ts

@@ -1,6 +1,8 @@
 export * from './enums/RewardsMessageTypeEnum';
 export * from './enums/GrantStatusEnum';
 export * from './enums/GrantItemStatusEnum';
+export * from './enums/LimitWaitReasonEnum';
+export * from './enums/RewardItemCodeEnum';
 export * from './enums/GrantRejectReasonEnum';
 export * from './enums/GrantFailedReasonEnum';
 export * from './enums/ItemErrorCategoryEnum';

package/bin/rewards/index.js

@@ -18,6 +18,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums/RewardsMessageTypeEnum"), exports);
 __exportStar(require("./enums/GrantStatusEnum"), exports);
 __exportStar(require("./enums/GrantItemStatusEnum"), exports);
+__exportStar(require("./enums/LimitWaitReasonEnum"), exports);
+__exportStar(require("./enums/RewardItemCodeEnum"), exports);
 __exportStar(require("./enums/GrantRejectReasonEnum"), exports);
 __exportStar(require("./enums/GrantFailedReasonEnum"), exports);
 __exportStar(require("./enums/ItemErrorCategoryEnum"), exports);