@fiado/type-kit 3.472.0 → 3.473.0

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

@@ -116,3 +116,33 @@ __decorate([
     (0, class_validator_1.IsEnum)(MdmLockModeEnum_1.MdmLockModeEnum),
     __metadata("design:type", String)
 ], BackofficeUpdateProductRequest.prototype, "mdmLockMode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], BackofficeUpdateProductRequest.prototype, "salePriority", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.Matches)(/\S/, { each: true }),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], BackofficeUpdateProductRequest.prototype, "highlights", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], BackofficeUpdateProductRequest.prototype, "warrantyMonths", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], BackofficeUpdateProductRequest.prototype, "launchDate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], BackofficeUpdateProductRequest.prototype, "specs", void 0);

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

@@ -0,0 +1,12 @@
+import { ReservationLineRef } from './ReservationLineRef';
+/** Componente de la línea con las piezas que quedan HELD de la sesión. */
+export declare class HoldStockComponent {
+    sku: string;
+    identifiers: string[];
+}
+/** Body de PUT /private/stores/{storeId}/holds (privateHoldStock); fija las piezas de una línea. */
+export declare class HoldStockRequest extends ReservationLineRef {
+    sessionId: string;
+    retailerId: string;
+    components: HoldStockComponent[];
+}

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

@@ -0,0 +1,47 @@
+"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.HoldStockRequest = exports.HoldStockComponent = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReservationLineRef_1 = require("./ReservationLineRef");
+/** Componente de la línea con las piezas que quedan HELD de la sesión. */
+class HoldStockComponent {
+}
+exports.HoldStockComponent = HoldStockComponent;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HoldStockComponent.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], HoldStockComponent.prototype, "identifiers", void 0);
+/** Body de PUT /private/stores/{storeId}/holds (privateHoldStock); fija las piezas de una línea. */
+class HoldStockRequest extends ReservationLineRef_1.ReservationLineRef {
+}
+exports.HoldStockRequest = HoldStockRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HoldStockRequest.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HoldStockRequest.prototype, "retailerId", 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)(() => HoldStockComponent),
+    __metadata("design:type", Array)
+], HoldStockRequest.prototype, "components", void 0);

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

@@ -1,3 +1,4 @@
+import { ReservePurposeEnum } from '../../enums/ReservePurposeEnum';
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 export declare class ReserveStockRequest {
     sessionId: string;
@@ -7,4 +8,6 @@ export declare class ReserveStockRequest {
     retailerId: string;
     sku: string;
     qty: number;
+    /** GIFT aparta un regalo de Promociones; ausente = apartado normal de venta. */
+    purpose?: ReservePurposeEnum;
 }

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

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReserveStockRequest = void 0;
 const class_validator_1 = require("class-validator");
+const ReservePurposeEnum_1 = require("../../enums/ReservePurposeEnum");
 /** Body de PUT /private/stores/{storeId}/reservations (privateReserveStock); reserva una línea, kit completo. */
 class ReserveStockRequest {
 }
@@ -40,3 +41,8 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], ReserveStockRequest.prototype, "qty", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReservePurposeEnum_1.ReservePurposeEnum),
+    __metadata("design:type", String)
+], ReserveStockRequest.prototype, "purpose", void 0);

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

@@ -2,4 +2,6 @@
 export declare class SuggestPiecesQuery {
     sku: string;
     prefix: string;
+    /** Sesión que pide; incluye sus propias piezas HELD en las sugerencias. */
+    sessionId?: string;
 }

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

@@ -24,3 +24,9 @@ __decorate([
     (0, class_validator_1.MinLength)(4),
     __metadata("design:type", String)
 ], SuggestPiecesQuery.prototype, "prefix", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SuggestPiecesQuery.prototype, "sessionId", void 0);

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

@@ -1,5 +1,6 @@
 import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
 import type { InventoryMovementTypeEnum } from '../../enums/InventoryMovementTypeEnum';
+import type { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 import type { SkuPriceEntry } from './SkuPriceEntry';
 /** Un movimiento del libro de inventario. */
 export interface InventoryMovementEntry {
@@ -11,6 +12,8 @@ export interface InventoryMovementEntry {
     identifier: string | null;
     occurredAt: string;
     createdBy: string;
+    /** Motivo guardado en el MOV#; ausente en los tipos que no llevan motivo. */
+    reason?: InventoryMovementReasonEnum;
 }
 /** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */
 export interface InventoryPieceEntry {

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

@@ -0,0 +1,8 @@
+import type { HoldStockComponent } from '../requests/HoldStockRequest';
+/** Response de privateHoldStock: la línea con las piezas que quedaron HELD. */
+export interface HoldStockResponse {
+    lineId: string;
+    reservationId: string;
+    sessionId: string;
+    components: HoldStockComponent[];
+}

package/bin/retailCatalog/dtos/responses/HoldStockResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -5,6 +5,10 @@ import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
 import type { ProductComponent } from '../ProductComponent';
+/** Componente de un kit en el catálogo de venta, con la categoría de su SKU. */
+export interface StoreCatalogComponent extends ProductComponent {
+    category?: ProductCategoryEnum;
+}
 /** Fila por SKU del catálogo de venta de una tienda (privateGetStoreStockCatalog). */
 export interface StoreCatalogItem {
     sku: string;
@@ -24,7 +28,7 @@ export interface StoreCatalogItem {
     mdmProvider: MdmProviderEnum | null;
     mdmLockMode: MdmLockModeEnum | null;
     /** Solo si es kit. */
-    components?: ProductComponent[];
+    components?: StoreCatalogComponent[];
     /** Producto físico o servicio. Ausente = PRODUCT. */
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */

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

@@ -0,0 +1,5 @@
+/** 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"
+}

package/bin/retailCatalog/enums/InventoryInboundMessageTypeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryInboundMessageTypeEnum = void 0;
+/** Tipo de aviso que el wizard publica en la cola de inventario del catálogo. */
+var InventoryInboundMessageTypeEnum;
+(function (InventoryInboundMessageTypeEnum) {
+    InventoryInboundMessageTypeEnum["SALE_APPLIED"] = "SALE_APPLIED";
+    InventoryInboundMessageTypeEnum["RETURN"] = "RETURN";
+})(InventoryInboundMessageTypeEnum || (exports.InventoryInboundMessageTypeEnum = InventoryInboundMessageTypeEnum = {}));

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

@@ -1,6 +1,6 @@
 /**
  * Estado de una unidad física (IMEI) en inventario.
- * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); RETURNED desde SOLD; DAMAGED.
+ * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); AVAILABLE → HELD → SOLD/AVAILABLE; RETURNED desde SOLD; DAMAGED.
  * @enum {string}
  *
  * @property {string} AVAILABLE - Disponible en stock.
@@ -9,6 +9,7 @@
  * @property {string} RETURNED - Devuelta por el cliente.
  * @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.
  */
 export declare enum InventoryItemStatusEnum {
     AVAILABLE = "AVAILABLE",
@@ -16,5 +17,6 @@ export declare enum InventoryItemStatusEnum {
     SOLD = "SOLD",
     RETURNED = "RETURNED",
     DAMAGED = "DAMAGED",
-    IN_TRANSIT = "IN_TRANSIT"
+    IN_TRANSIT = "IN_TRANSIT",
+    HELD = "HELD"
 }

package/bin/retailCatalog/enums/InventoryItemStatusEnum.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InventoryItemStatusEnum = void 0;
 /**
  * Estado de una unidad física (IMEI) en inventario.
- * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); RETURNED desde SOLD; DAMAGED.
+ * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); AVAILABLE → HELD → SOLD/AVAILABLE; RETURNED desde SOLD; DAMAGED.
  * @enum {string}
  *
  * @property {string} AVAILABLE - Disponible en stock.
@@ -12,6 +12,7 @@ exports.InventoryItemStatusEnum = void 0;
  * @property {string} RETURNED - Devuelta por el cliente.
  * @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.
  */
 var InventoryItemStatusEnum;
 (function (InventoryItemStatusEnum) {
@@ -21,4 +22,5 @@ var InventoryItemStatusEnum;
     InventoryItemStatusEnum["RETURNED"] = "RETURNED";
     InventoryItemStatusEnum["DAMAGED"] = "DAMAGED";
     InventoryItemStatusEnum["IN_TRANSIT"] = "IN_TRANSIT";
+    InventoryItemStatusEnum["HELD"] = "HELD";
 })(InventoryItemStatusEnum || (exports.InventoryItemStatusEnum = InventoryItemStatusEnum = {}));

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

@@ -0,0 +1,4 @@
+/** Motivo de un apartado; sin valor es un apartado normal de venta. */
+export declare enum ReservePurposeEnum {
+    GIFT = "GIFT"
+}

package/bin/retailCatalog/enums/ReservePurposeEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReservePurposeEnum = void 0;
+/** Motivo de un apartado; sin valor es un apartado normal de venta. */
+var ReservePurposeEnum;
+(function (ReservePurposeEnum) {
+    ReservePurposeEnum["GIFT"] = "GIFT";
+})(ReservePurposeEnum || (exports.ReservePurposeEnum = ReservePurposeEnum = {}));

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

@@ -0,0 +1,4 @@
+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;

package/bin/retailCatalog/events/InventoryInboundMessage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,12 @@
+import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
+import { ReturnStockRequest } from '../dtos/requests/ReturnStockRequest';
+/** Aviso de devolución de una venta de la saga en la cola de inventario. */
+export declare class InventoryReturnMessage extends ReturnStockRequest {
+    type: InventoryInboundMessageTypeEnum.RETURN;
+    tenantId: string;
+    storeId: string;
+    /** Sesión de la venta; ubica su marcador IDEMP#SELL. */
+    sessionId: string;
+    /** Fecha de la devolución; es el occurredAt del MOV#. */
+    returnedAt: string;
+}

package/bin/retailCatalog/events/InventoryReturnMessage.js

@@ -0,0 +1,42 @@
+"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.InventoryReturnMessage = void 0;
+const class_validator_1 = require("class-validator");
+const InventoryInboundMessageTypeEnum_1 = require("../enums/InventoryInboundMessageTypeEnum");
+const ReturnStockRequest_1 = require("../dtos/requests/ReturnStockRequest");
+/** Aviso de devolución de una venta de la saga en la cola de inventario. */
+class InventoryReturnMessage extends ReturnStockRequest_1.ReturnStockRequest {
+}
+exports.InventoryReturnMessage = InventoryReturnMessage;
+__decorate([
+    (0, class_validator_1.Equals)(InventoryInboundMessageTypeEnum_1.InventoryInboundMessageTypeEnum.RETURN),
+    __metadata("design:type", String)
+], InventoryReturnMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryReturnMessage.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryReturnMessage.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventoryReturnMessage.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], InventoryReturnMessage.prototype, "returnedAt", void 0);

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

@@ -0,0 +1,12 @@
+import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
+import { SellStockRequest } from '../dtos/requests/SellStockRequest';
+/** Aviso de venta de la saga en la cola de inventario; el catálogo pasa las piezas HELD a SOLD. */
+export declare class InventorySaleAppliedMessage extends SellStockRequest {
+    type: InventoryInboundMessageTypeEnum.SALE_APPLIED;
+    /** La cola es compartida entre silos; el tenant elige las tablas. */
+    tenantId: string;
+    storeId: string;
+    saleId: string;
+    /** Fecha de la venta; fecha el DAY# y el MOV#. */
+    soldAt: string;
+}

package/bin/retailCatalog/events/InventorySaleAppliedMessage.js

@@ -0,0 +1,42 @@
+"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.InventorySaleAppliedMessage = void 0;
+const class_validator_1 = require("class-validator");
+const InventoryInboundMessageTypeEnum_1 = require("../enums/InventoryInboundMessageTypeEnum");
+const SellStockRequest_1 = require("../dtos/requests/SellStockRequest");
+/** Aviso de venta de la saga en la cola de inventario; el catálogo pasa las piezas HELD a SOLD. */
+class InventorySaleAppliedMessage extends SellStockRequest_1.SellStockRequest {
+}
+exports.InventorySaleAppliedMessage = InventorySaleAppliedMessage;
+__decorate([
+    (0, class_validator_1.Equals)(InventoryInboundMessageTypeEnum_1.InventoryInboundMessageTypeEnum.SALE_APPLIED),
+    __metadata("design:type", String)
+], InventorySaleAppliedMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventorySaleAppliedMessage.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], InventorySaleAppliedMessage.prototype, "storeId", void 0);
+__decorate([
+    (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)
+], InventorySaleAppliedMessage.prototype, "soldAt", void 0);

package/bin/retailCatalog/index.d.ts

@@ -74,3 +74,10 @@ export * from './dtos/requests/BackofficeCreateTransferRequest';
 export * from './dtos/requests/BackofficeListTransfersQuery';
 export * from './dtos/responses/TransferResponse';
 export * from './dtos/responses/ListTransfersResponse';
+export * from './enums/ReservePurposeEnum';
+export * from './enums/InventoryInboundMessageTypeEnum';
+export * from './dtos/requests/HoldStockRequest';
+export * from './dtos/responses/HoldStockResponse';
+export * from './events/InventorySaleAppliedMessage';
+export * from './events/InventoryReturnMessage';
+export * from './events/InventoryInboundMessage';

package/bin/retailCatalog/index.js

@@ -99,3 +99,11 @@ __exportStar(require("./dtos/requests/BackofficeCreateTransferRequest"), exports
 __exportStar(require("./dtos/requests/BackofficeListTransfersQuery"), exports);
 __exportStar(require("./dtos/responses/TransferResponse"), exports);
 __exportStar(require("./dtos/responses/ListTransfersResponse"), exports);
+// Venta saga (ciclo 3)
+__exportStar(require("./enums/ReservePurposeEnum"), exports);
+__exportStar(require("./enums/InventoryInboundMessageTypeEnum"), exports);
+__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/InventoryInboundMessage"), exports);

package/bin/retailPromotions/constants/bonusPreMoney.d.ts

@@ -0,0 +1,7 @@
+/** HTTP con los que el request no llegó al handler del processor: los contesta la infraestructura. */
+export declare const PRE_HANDLER_HTTP_STATUSES: ReadonlySet<number>;
+/**
+ * Codes de transaction-processor que prueban que el bono NO movió saldo.
+ * Es whitelist: cualquier otro code se trata como ambiguo (`UNVERIFIED`).
+ */
+export declare const BONUS_PRE_MONEY_CODES: ReadonlySet<string>;

package/bin/retailPromotions/constants/bonusPreMoney.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BONUS_PRE_MONEY_CODES = exports.PRE_HANDLER_HTTP_STATUSES = void 0;
+/** HTTP con los que el request no llegó al handler del processor: los contesta la infraestructura. */
+exports.PRE_HANDLER_HTTP_STATUSES = new Set([401, 403, 404, 405]);
+/**
+ * Codes de transaction-processor que prueban que el bono NO movió saldo.
+ * Es whitelist: cualquier otro code se trata como ambiguo (`UNVERIFIED`).
+ */
+exports.BONUS_PRE_MONEY_CODES = new Set([
+    'USER_NOT_ACTIVE',
+    'ACCOUNT_NOT_FOUND',
+    'ACCOUNT_BLOCKED',
+    'DOCUMENT_ID_NOT_FOUND',
+    'PRODUCT_NOT_FOUND',
+    'ACCOUNT_LEVEL_MAX_MONTHLY_AMOUNT_EXCEEDED',
+    'ACCOUNT_LEVEL_MAX_AVAILABLE_BALANCE_EXCEEDED',
+    'INVALID_REQUEST',
+    // Literal del decorador de idempotencia, no del enum del processor: por eso el Set es de string.
+    'IDEMPOTENCY_KEY_REQUIRED',
+]);

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.d.ts

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

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = void 0;
+const RetailPromotionsErrorCodeEnum_1 = require("../enums/RetailPromotionsErrorCodeEnum");
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_PROMOTION_TRANSITION]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_TEXT_TAKEN]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_NOT_ACTIVE]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_NOT_APPLICABLE]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CUSTOMER_NOT_IDENTIFIED]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.GIFT_NOT_ALLOWED]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INSUFFICIENT_STOCK]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_NOT_FOUND]: 404,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_NOT_APPLICABLE]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_NOT_OWNED]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_NOT_ACTIVE]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_EXHAUSTED]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_ALREADY_APPLIED]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.DISCOUNT_AFTER_QUOTE]: 409,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_SALE_PROMOTION]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_DISCOUNT_CODE]: 422,
+};

package/bin/retailPromotions/constants/salePromotionTransitions.d.ts

@@ -0,0 +1,7 @@
+import { SalePromotionStatusEnum as S } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionTransitionEnum as T } from '../enums/SalePromotionTransitionEnum';
+/** Por cada transición: desde qué estados se permite y a cuál lleva. */
+export declare const SALE_PROMOTION_TRANSITIONS: Readonly<Record<T, {
+    from: readonly S[];
+    to: S;
+}>>;

package/bin/retailPromotions/constants/salePromotionTransitions.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SALE_PROMOTION_TRANSITIONS = void 0;
+const SalePromotionStatusEnum_1 = require("../enums/SalePromotionStatusEnum");
+const SalePromotionTransitionEnum_1 = require("../enums/SalePromotionTransitionEnum");
+/** Por cada transición: desde qué estados se permite y a cuál lleva. */
+exports.SALE_PROMOTION_TRANSITIONS = {
+    [SalePromotionTransitionEnum_1.SalePromotionTransitionEnum.PUBLISH]: { from: [SalePromotionStatusEnum_1.SalePromotionStatusEnum.DRAFT], to: SalePromotionStatusEnum_1.SalePromotionStatusEnum.ACTIVE },
+    [SalePromotionTransitionEnum_1.SalePromotionTransitionEnum.PAUSE]: { from: [SalePromotionStatusEnum_1.SalePromotionStatusEnum.ACTIVE], to: SalePromotionStatusEnum_1.SalePromotionStatusEnum.PAUSED },
+    [SalePromotionTransitionEnum_1.SalePromotionTransitionEnum.RESUME]: { from: [SalePromotionStatusEnum_1.SalePromotionStatusEnum.PAUSED], to: SalePromotionStatusEnum_1.SalePromotionStatusEnum.ACTIVE },
+    [SalePromotionTransitionEnum_1.SalePromotionTransitionEnum.EXPIRE]: { from: [SalePromotionStatusEnum_1.SalePromotionStatusEnum.ACTIVE, SalePromotionStatusEnum_1.SalePromotionStatusEnum.PAUSED], to: SalePromotionStatusEnum_1.SalePromotionStatusEnum.EXPIRED },
+    [SalePromotionTransitionEnum_1.SalePromotionTransitionEnum.ARCHIVE]: { from: [SalePromotionStatusEnum_1.SalePromotionStatusEnum.DRAFT, SalePromotionStatusEnum_1.SalePromotionStatusEnum.ACTIVE, SalePromotionStatusEnum_1.SalePromotionStatusEnum.PAUSED, SalePromotionStatusEnum_1.SalePromotionStatusEnum.EXPIRED], to: SalePromotionStatusEnum_1.SalePromotionStatusEnum.ARCHIVED },
+};

package/bin/retailPromotions/dtos/DiscountCode.d.ts

@@ -0,0 +1,35 @@
+import { CouponScopeEnum } from '../enums/CouponScopeEnum';
+import { CouponStatusEnum } from '../enums/CouponStatusEnum';
+import { DiscountCodeOriginEnum } from '../enums/DiscountCodeOriginEnum';
+import { DiscountCodeStatusEnum } from '../enums/DiscountCodeStatusEnum';
+import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { DiscountValue } from './DiscountValue';
+/**
+ * Código de descuento de Admin VL o cupón emitido por una venta (según `origin`).
+ * Los campos de cupón (`ownerCustomerId`, `issuedBySaleId`, `couponScope`) son `null` en los de Admin.
+ */
+export interface DiscountCode {
+    codeId: string;
+    codeText: string;
+    origin: DiscountCodeOriginEnum;
+    status: DiscountCodeStatusEnum | CouponStatusEnum;
+    discount: DiscountValue;
+    validFrom: string | null;
+    validUntil: string | null;
+    /** `null` = sin tope de usos. */
+    maxUses: number | null;
+    uses: number;
+    skus: string[] | null;
+    storeIds: string[] | null;
+    announceInStore: boolean;
+    appliesTo: PromotionAppliesToEnum;
+    ownerCustomerId: string | null;
+    issuedBySaleId: string | null;
+    issuingStoreId: string | null;
+    couponScope: CouponScopeEnum | null;
+    redeemedBySaleId: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/retailPromotions/dtos/DiscountCode.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailPromotions/dtos/DiscountValue.d.ts

@@ -0,0 +1,7 @@
+import { DiscountTypeEnum } from '../enums/DiscountTypeEnum';
+/** Descuento en $ o %: `amountCents` si es `AMOUNT`, `percentBps` (1000 = 10%) si es `PERCENTAGE`. */
+export interface DiscountValue {
+    type: DiscountTypeEnum;
+    amountCents: number | null;
+    percentBps: number | null;
+}

package/bin/retailPromotions/dtos/DiscountValue.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailPromotions/dtos/LinePromotionDiscount.d.ts

@@ -0,0 +1,10 @@
+/** Desglose por línea de la sesión: qué promo o código la tocó y cuánto bajó. */
+export interface LinePromotionDiscount {
+    lineId: string;
+    promotionId: string | null;
+    promotionVersion: number | null;
+    discountCode: string | null;
+    originalPriceCents: number;
+    discountCents: number;
+    finalPriceCents: number;
+}

package/bin/retailPromotions/dtos/LinePromotionDiscount.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailPromotions/dtos/SalePromotion.d.ts

@@ -0,0 +1,35 @@
+import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
+import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
+/** Promo de venta tal como la devuelve el CRUD. Dinero en centavos, fechas ISO. */
+export interface SalePromotion {
+    promotionId: string;
+    retailerId: string;
+    name: string;
+    /** Texto que ve el cliente en el wizard. */
+    customerText: string;
+    levers: SalePromotionLevers;
+    scope: SalePromotionScope;
+    segmentation: SalePromotionSegmentation;
+    appliesTo: PromotionAppliesToEnum;
+    /** `null` = sin tope. */
+    budgetMaxCents: number | null;
+    budgetConsumedCents: number;
+    redemptionCount: number;
+    validFrom: string | null;
+    /** `null` = permanente. */
+    validUntil: string | null;
+    oncePerCustomer: boolean;
+    status: SalePromotionStatusEnum;
+    /** Derivada; `null` cuando el estado no es `ACTIVE`. */
+    phase: SalePromotionPhaseEnum | null;
+    version: number;
+    pausedAt: string | null;
+    pauseReason: string | null;
+    publishedAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/retailPromotions/dtos/SalePromotion.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });