@fiado/type-kit 3.472.0 → 3.474.0

package/bin/retailPromotions/enums/DiscountTypeEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscountTypeEnum = void 0;
+/**
+ * Tipo de descuento: monto fijo en centavos o porcentaje en puntos base (1000 = 10%).
+ * @enum {string}
+ */
+var DiscountTypeEnum;
+(function (DiscountTypeEnum) {
+    DiscountTypeEnum["AMOUNT"] = "AMOUNT";
+    DiscountTypeEnum["PERCENTAGE"] = "PERCENTAGE";
+})(DiscountTypeEnum || (exports.DiscountTypeEnum = DiscountTypeEnum = {}));

package/bin/retailPromotions/enums/EntitlementKindEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tipo de entrega posterior a la venta.
+ * @enum {string}
+ */
+export declare enum EntitlementKindEnum {
+    WALLET = "WALLET",
+    WARRANTY = "WARRANTY",
+    AIRTIME = "AIRTIME"
+}

package/bin/retailPromotions/enums/EntitlementKindEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitlementKindEnum = void 0;
+/**
+ * Tipo de entrega posterior a la venta.
+ * @enum {string}
+ */
+var EntitlementKindEnum;
+(function (EntitlementKindEnum) {
+    EntitlementKindEnum["WALLET"] = "WALLET";
+    EntitlementKindEnum["WARRANTY"] = "WARRANTY";
+    EntitlementKindEnum["AIRTIME"] = "AIRTIME";
+})(EntitlementKindEnum || (exports.EntitlementKindEnum = EntitlementKindEnum = {}));

package/bin/retailPromotions/enums/EntitlementStateEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado de una entrega posterior a la venta (Wallet, garantía, tiempo aire).
+ * @enum {string}
+ */
+export declare enum EntitlementStateEnum {
+    PENDING = "PENDING",
+    /** Reclamada con lease; hay una llamada al processor en curso. */
+    IN_FLIGHT = "IN_FLIGHT",
+    SETTLED = "SETTLED",
+    /** No se sabe si movió dinero: se concilia a mano, sin reintento. */
+    UNVERIFIED = "UNVERIFIED",
+    VOID = "VOID"
+}

package/bin/retailPromotions/enums/EntitlementStateEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitlementStateEnum = void 0;
+/**
+ * Estado de una entrega posterior a la venta (Wallet, garantía, tiempo aire).
+ * @enum {string}
+ */
+var EntitlementStateEnum;
+(function (EntitlementStateEnum) {
+    EntitlementStateEnum["PENDING"] = "PENDING";
+    /** Reclamada con lease; hay una llamada al processor en curso. */
+    EntitlementStateEnum["IN_FLIGHT"] = "IN_FLIGHT";
+    EntitlementStateEnum["SETTLED"] = "SETTLED";
+    /** No se sabe si movió dinero: se concilia a mano, sin reintento. */
+    EntitlementStateEnum["UNVERIFIED"] = "UNVERIFIED";
+    EntitlementStateEnum["VOID"] = "VOID";
+})(EntitlementStateEnum || (exports.EntitlementStateEnum = EntitlementStateEnum = {}));

package/bin/retailPromotions/enums/GiftModeEnum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cómo se define el regalo: lista cerrada de SKUs o gama (categoría y precio máximo).
+ * @enum {string}
+ */
+export declare enum GiftModeEnum {
+    LIST = "LIST",
+    RANGE = "RANGE"
+}

package/bin/retailPromotions/enums/GiftModeEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GiftModeEnum = void 0;
+/**
+ * Cómo se define el regalo: lista cerrada de SKUs o gama (categoría y precio máximo).
+ * @enum {string}
+ */
+var GiftModeEnum;
+(function (GiftModeEnum) {
+    GiftModeEnum["LIST"] = "LIST";
+    GiftModeEnum["RANGE"] = "RANGE";
+})(GiftModeEnum || (exports.GiftModeEnum = GiftModeEnum = {}));

package/bin/retailPromotions/enums/PromotionAppliesToEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Con qué financiera aplica una promo o un código. Sin valor, el lambda asume `SUREKEEP_ONLY`.
+ * @enum {string}
+ */
+export declare enum PromotionAppliesToEnum {
+    SUREKEEP_ONLY = "SUREKEEP_ONLY",
+    /** También cuando el teléfono se deriva a otra financiera y la venta cuenta como contado. */
+    ANY_FINANCIER = "ANY_FINANCIER"
+}

package/bin/retailPromotions/enums/PromotionAppliesToEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionAppliesToEnum = void 0;
+/**
+ * Con qué financiera aplica una promo o un código. Sin valor, el lambda asume `SUREKEEP_ONLY`.
+ * @enum {string}
+ */
+var PromotionAppliesToEnum;
+(function (PromotionAppliesToEnum) {
+    PromotionAppliesToEnum["SUREKEEP_ONLY"] = "SUREKEEP_ONLY";
+    /** También cuando el teléfono se deriva a otra financiera y la venta cuenta como contado. */
+    PromotionAppliesToEnum["ANY_FINANCIER"] = "ANY_FINANCIER";
+})(PromotionAppliesToEnum || (exports.PromotionAppliesToEnum = PromotionAppliesToEnum = {}));

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Codes de error de retail-promotions-business; el status de cada uno está en
+ * `RETAIL_PROMOTIONS_ERROR_HTTP_STATUS`. Las clases `DomainError` viven en el lambda.
+ * @enum {string}
+ */
+export declare enum RetailPromotionsErrorCodeEnum {
+    INVALID_PROMOTION_TRANSITION = "INVALID_PROMOTION_TRANSITION",
+    CODE_TEXT_TAKEN = "CODE_TEXT_TAKEN",
+    PROMOTION_NOT_ACTIVE = "PROMOTION_NOT_ACTIVE",
+    PROMOTION_NOT_APPLICABLE = "PROMOTION_NOT_APPLICABLE",
+    CUSTOMER_NOT_IDENTIFIED = "CUSTOMER_NOT_IDENTIFIED",
+    GIFT_NOT_ALLOWED = "GIFT_NOT_ALLOWED",
+    INSUFFICIENT_STOCK = "INSUFFICIENT_STOCK",
+    CODE_NOT_FOUND = "CODE_NOT_FOUND",
+    CODE_NOT_APPLICABLE = "CODE_NOT_APPLICABLE",
+    CODE_NOT_OWNED = "CODE_NOT_OWNED",
+    CODE_NOT_ACTIVE = "CODE_NOT_ACTIVE",
+    CODE_EXHAUSTED = "CODE_EXHAUSTED",
+    CODE_ALREADY_APPLIED = "CODE_ALREADY_APPLIED",
+    DISCOUNT_AFTER_QUOTE = "DISCOUNT_AFTER_QUOTE",
+    INVALID_SALE_PROMOTION = "INVALID_SALE_PROMOTION",
+    INVALID_DISCOUNT_CODE = "INVALID_DISCOUNT_CODE",
+    SALE_PROMOTION_NOT_FOUND = "SALE_PROMOTION_NOT_FOUND",
+    SALE_COUPON_NOT_FOUND = "SALE_COUPON_NOT_FOUND",
+    /** La sesión no trae retailer: no se puede acotar la consulta. */
+    MISSING_RETAILER_SCOPE = "MISSING_RETAILER_SCOPE",
+    /** La sesión no trae tienda: no se puede acotar la consulta. */
+    MISSING_STORE_SCOPE = "MISSING_STORE_SCOPE"
+}

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailPromotionsErrorCodeEnum = void 0;
+/**
+ * Codes de error de retail-promotions-business; el status de cada uno está en
+ * `RETAIL_PROMOTIONS_ERROR_HTTP_STATUS`. Las clases `DomainError` viven en el lambda.
+ * @enum {string}
+ */
+var RetailPromotionsErrorCodeEnum;
+(function (RetailPromotionsErrorCodeEnum) {
+    RetailPromotionsErrorCodeEnum["INVALID_PROMOTION_TRANSITION"] = "INVALID_PROMOTION_TRANSITION";
+    RetailPromotionsErrorCodeEnum["CODE_TEXT_TAKEN"] = "CODE_TEXT_TAKEN";
+    RetailPromotionsErrorCodeEnum["PROMOTION_NOT_ACTIVE"] = "PROMOTION_NOT_ACTIVE";
+    RetailPromotionsErrorCodeEnum["PROMOTION_NOT_APPLICABLE"] = "PROMOTION_NOT_APPLICABLE";
+    RetailPromotionsErrorCodeEnum["CUSTOMER_NOT_IDENTIFIED"] = "CUSTOMER_NOT_IDENTIFIED";
+    RetailPromotionsErrorCodeEnum["GIFT_NOT_ALLOWED"] = "GIFT_NOT_ALLOWED";
+    RetailPromotionsErrorCodeEnum["INSUFFICIENT_STOCK"] = "INSUFFICIENT_STOCK";
+    RetailPromotionsErrorCodeEnum["CODE_NOT_FOUND"] = "CODE_NOT_FOUND";
+    RetailPromotionsErrorCodeEnum["CODE_NOT_APPLICABLE"] = "CODE_NOT_APPLICABLE";
+    RetailPromotionsErrorCodeEnum["CODE_NOT_OWNED"] = "CODE_NOT_OWNED";
+    RetailPromotionsErrorCodeEnum["CODE_NOT_ACTIVE"] = "CODE_NOT_ACTIVE";
+    RetailPromotionsErrorCodeEnum["CODE_EXHAUSTED"] = "CODE_EXHAUSTED";
+    RetailPromotionsErrorCodeEnum["CODE_ALREADY_APPLIED"] = "CODE_ALREADY_APPLIED";
+    RetailPromotionsErrorCodeEnum["DISCOUNT_AFTER_QUOTE"] = "DISCOUNT_AFTER_QUOTE";
+    RetailPromotionsErrorCodeEnum["INVALID_SALE_PROMOTION"] = "INVALID_SALE_PROMOTION";
+    RetailPromotionsErrorCodeEnum["INVALID_DISCOUNT_CODE"] = "INVALID_DISCOUNT_CODE";
+    RetailPromotionsErrorCodeEnum["SALE_PROMOTION_NOT_FOUND"] = "SALE_PROMOTION_NOT_FOUND";
+    RetailPromotionsErrorCodeEnum["SALE_COUPON_NOT_FOUND"] = "SALE_COUPON_NOT_FOUND";
+    /** La sesión no trae retailer: no se puede acotar la consulta. */
+    RetailPromotionsErrorCodeEnum["MISSING_RETAILER_SCOPE"] = "MISSING_RETAILER_SCOPE";
+    /** La sesión no trae tienda: no se puede acotar la consulta. */
+    RetailPromotionsErrorCodeEnum["MISSING_STORE_SCOPE"] = "MISSING_STORE_SCOPE";
+})(RetailPromotionsErrorCodeEnum || (exports.RetailPromotionsErrorCodeEnum = RetailPromotionsErrorCodeEnum = {}));

package/bin/retailPromotions/enums/SaleCouponAvailabilityEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Si la venta cerrada ya tiene su cupón: `GENERATING` mientras la cola no lo emite.
+ * @enum {string}
+ */
+export declare enum SaleCouponAvailabilityEnum {
+    GENERATING = "GENERATING",
+    READY = "READY",
+    /** La venta no da cupón. */
+    NONE = "NONE"
+}

package/bin/retailPromotions/enums/SaleCouponAvailabilityEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleCouponAvailabilityEnum = void 0;
+/**
+ * Si la venta cerrada ya tiene su cupón: `GENERATING` mientras la cola no lo emite.
+ * @enum {string}
+ */
+var SaleCouponAvailabilityEnum;
+(function (SaleCouponAvailabilityEnum) {
+    SaleCouponAvailabilityEnum["GENERATING"] = "GENERATING";
+    SaleCouponAvailabilityEnum["READY"] = "READY";
+    /** La venta no da cupón. */
+    SaleCouponAvailabilityEnum["NONE"] = "NONE";
+})(SaleCouponAvailabilityEnum || (exports.SaleCouponAvailabilityEnum = SaleCouponAvailabilityEnum = {}));

package/bin/retailPromotions/enums/SalePromotionLeverEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Las 7 palancas combinables de una promo de venta.
+ * @enum {string}
+ */
+export declare enum SalePromotionLeverEnum {
+    DEVICE_DISCOUNT = "DEVICE_DISCOUNT",
+    ACCESSORY_DISCOUNT = "ACCESSORY_DISCOUNT",
+    GIFT = "GIFT",
+    COUPON = "COUPON",
+    AIRTIME = "AIRTIME",
+    EXTENDED_WARRANTY = "EXTENDED_WARRANTY",
+    WALLET_BONUS = "WALLET_BONUS"
+}

package/bin/retailPromotions/enums/SalePromotionLeverEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionLeverEnum = void 0;
+/**
+ * Las 7 palancas combinables de una promo de venta.
+ * @enum {string}
+ */
+var SalePromotionLeverEnum;
+(function (SalePromotionLeverEnum) {
+    SalePromotionLeverEnum["DEVICE_DISCOUNT"] = "DEVICE_DISCOUNT";
+    SalePromotionLeverEnum["ACCESSORY_DISCOUNT"] = "ACCESSORY_DISCOUNT";
+    SalePromotionLeverEnum["GIFT"] = "GIFT";
+    SalePromotionLeverEnum["COUPON"] = "COUPON";
+    SalePromotionLeverEnum["AIRTIME"] = "AIRTIME";
+    SalePromotionLeverEnum["EXTENDED_WARRANTY"] = "EXTENDED_WARRANTY";
+    SalePromotionLeverEnum["WALLET_BONUS"] = "WALLET_BONUS";
+})(SalePromotionLeverEnum || (exports.SalePromotionLeverEnum = SalePromotionLeverEnum = {}));

package/bin/retailPromotions/enums/SalePromotionLogEventEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Evento del historial de promos de venta. Los automáticos (autopausa, reanudación, vencimiento)
+ * usan el mismo evento con autor `system`.
+ * @enum {string}
+ */
+export declare enum SalePromotionLogEventEnum {
+    CREATE = "CREATE",
+    UPDATE = "UPDATE",
+    PUBLISH = "PUBLISH",
+    PAUSE = "PAUSE",
+    RESUME = "RESUME",
+    EXPIRE = "EXPIRE",
+    ARCHIVE = "ARCHIVE"
+}

package/bin/retailPromotions/enums/SalePromotionLogEventEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionLogEventEnum = void 0;
+/**
+ * Evento del historial de promos de venta. Los automáticos (autopausa, reanudación, vencimiento)
+ * usan el mismo evento con autor `system`.
+ * @enum {string}
+ */
+var SalePromotionLogEventEnum;
+(function (SalePromotionLogEventEnum) {
+    SalePromotionLogEventEnum["CREATE"] = "CREATE";
+    SalePromotionLogEventEnum["UPDATE"] = "UPDATE";
+    SalePromotionLogEventEnum["PUBLISH"] = "PUBLISH";
+    SalePromotionLogEventEnum["PAUSE"] = "PAUSE";
+    SalePromotionLogEventEnum["RESUME"] = "RESUME";
+    SalePromotionLogEventEnum["EXPIRE"] = "EXPIRE";
+    SalePromotionLogEventEnum["ARCHIVE"] = "ARCHIVE";
+})(SalePromotionLogEventEnum || (exports.SalePromotionLogEventEnum = SalePromotionLogEventEnum = {}));

package/bin/retailPromotions/enums/SalePromotionLogFormatEnum.d.ts

@@ -0,0 +1,5 @@
+/** Formato de salida del historial: página JSON o exportación CSV. */
+export declare enum SalePromotionLogFormatEnum {
+    JSON = "JSON",
+    CSV = "CSV"
+}

package/bin/retailPromotions/enums/SalePromotionLogFormatEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionLogFormatEnum = void 0;
+/** Formato de salida del historial: página JSON o exportación CSV. */
+var SalePromotionLogFormatEnum;
+(function (SalePromotionLogFormatEnum) {
+    SalePromotionLogFormatEnum["JSON"] = "JSON";
+    SalePromotionLogFormatEnum["CSV"] = "CSV";
+})(SalePromotionLogFormatEnum || (exports.SalePromotionLogFormatEnum = SalePromotionLogFormatEnum = {}));

package/bin/retailPromotions/enums/SalePromotionPhaseEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fase derivada de la vigencia (hora CDMX) de una promo `ACTIVE`; no se persiste.
+ * @enum {string}
+ */
+export declare enum SalePromotionPhaseEnum {
+    /** Activa con inicio futuro. */
+    SCHEDULED = "SCHEDULED",
+    LIVE = "LIVE",
+    /** Vigente y termina en los próximos 7 días. */
+    EXPIRING_SOON = "EXPIRING_SOON"
+}

package/bin/retailPromotions/enums/SalePromotionPhaseEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionPhaseEnum = void 0;
+/**
+ * Fase derivada de la vigencia (hora CDMX) de una promo `ACTIVE`; no se persiste.
+ * @enum {string}
+ */
+var SalePromotionPhaseEnum;
+(function (SalePromotionPhaseEnum) {
+    /** Activa con inicio futuro. */
+    SalePromotionPhaseEnum["SCHEDULED"] = "SCHEDULED";
+    SalePromotionPhaseEnum["LIVE"] = "LIVE";
+    /** Vigente y termina en los próximos 7 días. */
+    SalePromotionPhaseEnum["EXPIRING_SOON"] = "EXPIRING_SOON";
+})(SalePromotionPhaseEnum || (exports.SalePromotionPhaseEnum = SalePromotionPhaseEnum = {}));

package/bin/retailPromotions/enums/SalePromotionStatusEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Estado persistido de una promo de venta. Programada, permanente y vencida-por-fecha se derivan
+ * de la vigencia; `ARCHIVED` la oculta del listado salvo en el filtro «Archivadas».
+ * @enum {string}
+ */
+export declare enum SalePromotionStatusEnum {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    PAUSED = "PAUSED",
+    EXPIRED = "EXPIRED",
+    ARCHIVED = "ARCHIVED"
+}

package/bin/retailPromotions/enums/SalePromotionStatusEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionStatusEnum = void 0;
+/**
+ * Estado persistido de una promo de venta. Programada, permanente y vencida-por-fecha se derivan
+ * de la vigencia; `ARCHIVED` la oculta del listado salvo en el filtro «Archivadas».
+ * @enum {string}
+ */
+var SalePromotionStatusEnum;
+(function (SalePromotionStatusEnum) {
+    SalePromotionStatusEnum["DRAFT"] = "DRAFT";
+    SalePromotionStatusEnum["ACTIVE"] = "ACTIVE";
+    SalePromotionStatusEnum["PAUSED"] = "PAUSED";
+    SalePromotionStatusEnum["EXPIRED"] = "EXPIRED";
+    SalePromotionStatusEnum["ARCHIVED"] = "ARCHIVED";
+})(SalePromotionStatusEnum || (exports.SalePromotionStatusEnum = SalePromotionStatusEnum = {}));

package/bin/retailPromotions/enums/SalePromotionTransitionEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Acción que pide Admin VL sobre una promo de venta. El destino lo resuelve
+ * `resolveSalePromotionTransition`; una transición no permitida es `INVALID_PROMOTION_TRANSITION`.
+ * @enum {string}
+ */
+export declare enum SalePromotionTransitionEnum {
+    PUBLISH = "PUBLISH",
+    PAUSE = "PAUSE",
+    RESUME = "RESUME",
+    /** Fin ahora. Que no aplique a una promo permanente lo valida el lambda. */
+    EXPIRE = "EXPIRE",
+    ARCHIVE = "ARCHIVE"
+}

package/bin/retailPromotions/enums/SalePromotionTransitionEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionTransitionEnum = void 0;
+/**
+ * Acción que pide Admin VL sobre una promo de venta. El destino lo resuelve
+ * `resolveSalePromotionTransition`; una transición no permitida es `INVALID_PROMOTION_TRANSITION`.
+ * @enum {string}
+ */
+var SalePromotionTransitionEnum;
+(function (SalePromotionTransitionEnum) {
+    SalePromotionTransitionEnum["PUBLISH"] = "PUBLISH";
+    SalePromotionTransitionEnum["PAUSE"] = "PAUSE";
+    SalePromotionTransitionEnum["RESUME"] = "RESUME";
+    /** Fin ahora. Que no aplique a una promo permanente lo valida el lambda. */
+    SalePromotionTransitionEnum["EXPIRE"] = "EXPIRE";
+    SalePromotionTransitionEnum["ARCHIVE"] = "ARCHIVE";
+})(SalePromotionTransitionEnum || (exports.SalePromotionTransitionEnum = SalePromotionTransitionEnum = {}));

package/bin/retailPromotions/helpers/computeBudgetUsedBps.d.ts

@@ -0,0 +1,3 @@
+import { SalePromotion } from '../dtos/SalePromotion';
+/** % de presupuesto consumido en puntos base sobre las promos con tope; `null` si ninguna tiene tope. */
+export declare function computeBudgetUsedBps(promotions: Pick<SalePromotion, 'budgetMaxCents' | 'budgetConsumedCents'>[]): number | null;

package/bin/retailPromotions/helpers/computeBudgetUsedBps.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeBudgetUsedBps = computeBudgetUsedBps;
+/** % de presupuesto consumido en puntos base sobre las promos con tope; `null` si ninguna tiene tope. */
+function computeBudgetUsedBps(promotions) {
+    let maxCents = 0;
+    let consumedCents = 0;
+    for (const { budgetMaxCents, budgetConsumedCents } of promotions) {
+        if (budgetMaxCents === null)
+            continue;
+        maxCents += budgetMaxCents;
+        consumedCents += budgetConsumedCents;
+    }
+    return maxCents > 0 ? Math.floor((consumedCents * 10000) / maxCents) : null;
+}

package/bin/retailPromotions/helpers/resolveSalePromotionTransition.d.ts

@@ -0,0 +1,4 @@
+import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionTransitionEnum } from '../enums/SalePromotionTransitionEnum';
+/** Estado destino de aplicar la transición, o `null` si no se permite desde `from`. */
+export declare function resolveSalePromotionTransition(from: SalePromotionStatusEnum, transition: SalePromotionTransitionEnum): SalePromotionStatusEnum | null;

package/bin/retailPromotions/helpers/resolveSalePromotionTransition.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSalePromotionTransition = resolveSalePromotionTransition;
+const salePromotionTransitions_1 = require("../constants/salePromotionTransitions");
+/** Estado destino de aplicar la transición, o `null` si no se permite desde `from`. */
+function resolveSalePromotionTransition(from, transition) {
+    const rule = salePromotionTransitions_1.SALE_PROMOTION_TRANSITIONS[transition];
+    return rule.from.includes(from) ? rule.to : null;
+}

package/bin/retailPromotions/index.d.ts

@@ -0,0 +1,47 @@
+export * from './enums/SalePromotionStatusEnum';
+export * from './enums/SalePromotionTransitionEnum';
+export * from './enums/SalePromotionPhaseEnum';
+export * from './enums/SalePromotionLeverEnum';
+export * from './enums/SalePromotionLogEventEnum';
+export * from './enums/SalePromotionLogFormatEnum';
+export * from './enums/DiscountTypeEnum';
+export * from './enums/GiftModeEnum';
+export * from './enums/PromotionAppliesToEnum';
+export * from './enums/CouponScopeEnum';
+export * from './enums/CouponStatusEnum';
+export * from './enums/DiscountCodeStatusEnum';
+export * from './enums/DiscountCodeOriginEnum';
+export * from './enums/DiscountCodeTransitionEnum';
+export * from './enums/EntitlementStateEnum';
+export * from './enums/EntitlementKindEnum';
+export * from './enums/SaleCouponAvailabilityEnum';
+export * from './enums/RetailPromotionsErrorCodeEnum';
+export * from './constants/retailPromotionsErrorHttpStatus';
+export * from './constants/salePromotionTransitions';
+export * from './constants/bonusPreMoney';
+export * from './helpers/resolveSalePromotionTransition';
+export * from './helpers/computeBudgetUsedBps';
+export * from './dtos/DiscountValue';
+export * from './dtos/SalePromotionLevers';
+export * from './dtos/SalePromotion';
+export * from './dtos/SalePromotionLogEntry';
+export * from './dtos/DiscountCode';
+export * from './dtos/LinePromotionDiscount';
+export * from './dtos/requests/DiscountValueInput';
+export * from './dtos/requests/SalePromotionLeversInput';
+export * from './dtos/requests/SalePromotionScopeInput';
+export * from './dtos/requests/CreateSalePromotionRequest';
+export * from './dtos/requests/UpdateSalePromotionRequest';
+export * from './dtos/requests/ChangeSalePromotionStatusRequest';
+export * from './dtos/requests/ListSalePromotionsQuery';
+export * from './dtos/requests/ListSalePromotionLogQuery';
+export * from './dtos/requests/CreateDiscountCodeRequest';
+export * from './dtos/requests/ListDiscountCodesQuery';
+export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
+export * from './dtos/requests/ListStoreSalePromotionsQuery';
+export * from './dtos/requests/EvaluateSalePromotionsRequest';
+export * from './dtos/requests/HoldSalePromotionRequest';
+export * from './dtos/requests/GetSaleCouponQuery';
+export * from './dtos/responses/SalePromotionCrudResponses';
+export * from './dtos/responses/DiscountCodeResponses';
+export * from './dtos/responses/WizardSalePromotionResponses';

package/bin/retailPromotions/index.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums/SalePromotionStatusEnum"), exports);
+__exportStar(require("./enums/SalePromotionTransitionEnum"), exports);
+__exportStar(require("./enums/SalePromotionPhaseEnum"), exports);
+__exportStar(require("./enums/SalePromotionLeverEnum"), exports);
+__exportStar(require("./enums/SalePromotionLogEventEnum"), exports);
+__exportStar(require("./enums/SalePromotionLogFormatEnum"), exports);
+__exportStar(require("./enums/DiscountTypeEnum"), exports);
+__exportStar(require("./enums/GiftModeEnum"), exports);
+__exportStar(require("./enums/PromotionAppliesToEnum"), exports);
+__exportStar(require("./enums/CouponScopeEnum"), exports);
+__exportStar(require("./enums/CouponStatusEnum"), exports);
+__exportStar(require("./enums/DiscountCodeStatusEnum"), exports);
+__exportStar(require("./enums/DiscountCodeOriginEnum"), exports);
+__exportStar(require("./enums/DiscountCodeTransitionEnum"), exports);
+__exportStar(require("./enums/EntitlementStateEnum"), exports);
+__exportStar(require("./enums/EntitlementKindEnum"), exports);
+__exportStar(require("./enums/SaleCouponAvailabilityEnum"), exports);
+__exportStar(require("./enums/RetailPromotionsErrorCodeEnum"), exports);
+// Constantes y helpers puros
+__exportStar(require("./constants/retailPromotionsErrorHttpStatus"), exports);
+__exportStar(require("./constants/salePromotionTransitions"), exports);
+__exportStar(require("./constants/bonusPreMoney"), exports);
+__exportStar(require("./helpers/resolveSalePromotionTransition"), exports);
+__exportStar(require("./helpers/computeBudgetUsedBps"), exports);
+// Entidades del dominio
+__exportStar(require("./dtos/DiscountValue"), exports);
+__exportStar(require("./dtos/SalePromotionLevers"), exports);
+__exportStar(require("./dtos/SalePromotion"), exports);
+__exportStar(require("./dtos/SalePromotionLogEntry"), exports);
+__exportStar(require("./dtos/DiscountCode"), exports);
+__exportStar(require("./dtos/LinePromotionDiscount"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/DiscountValueInput"), exports);
+__exportStar(require("./dtos/requests/SalePromotionLeversInput"), exports);
+__exportStar(require("./dtos/requests/SalePromotionScopeInput"), exports);
+__exportStar(require("./dtos/requests/CreateSalePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateSalePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeSalePromotionStatusRequest"), exports);
+__exportStar(require("./dtos/requests/ListSalePromotionsQuery"), exports);
+__exportStar(require("./dtos/requests/ListSalePromotionLogQuery"), exports);
+__exportStar(require("./dtos/requests/CreateDiscountCodeRequest"), exports);
+__exportStar(require("./dtos/requests/ListDiscountCodesQuery"), exports);
+__exportStar(require("./dtos/requests/ChangeDiscountCodeStatusRequest"), exports);
+__exportStar(require("./dtos/requests/ListStoreSalePromotionsQuery"), exports);
+__exportStar(require("./dtos/requests/EvaluateSalePromotionsRequest"), exports);
+__exportStar(require("./dtos/requests/HoldSalePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/GetSaleCouponQuery"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/SalePromotionCrudResponses"), exports);
+__exportStar(require("./dtos/responses/DiscountCodeResponses"), exports);
+__exportStar(require("./dtos/responses/WizardSalePromotionResponses"), exports);

package/bin/retailWizard/dtos/Sale.d.ts

@@ -26,18 +26,18 @@ export interface Sale {
     skus?: string[];
     /** La cancelación aún no confirma la devolución al inventario. */
     inventoryReturnPending?: boolean;
+    /** Venta de la saga: el inventario se aplica y se devuelve por la cola, no por HTTP. */
+    inventoryViaQueue?: boolean;
+    /** Promo de venta congelada al cerrar; `null` = ninguna. */
+    salePromotionId?: string | null;
+    salePromotionVersion?: number | null;
     /** IMEI consumido del silo también en contado (local-first); null en EXTERNAL_REFERRAL (D15). */
     imei: string | null;
-    /**
-     * Lo COBRADO en caja al cerrar. En contado == precio del equipo (lo garantiza `registerPayment`);
-     * en crédito es SOLO el enganche. ⚠️ Su significado es contrato de `SaleCompletedV1` (La Central,
-     * comisión F4): no redefinir — el precio del equipo viaja aparte en `equipmentPriceCents`. 0 en
-     * EXTERNAL_REFERRAL.
-     */
+    /** Lo cobrado en caja al cerrar: enganche + lo no financiado; 0 en EXTERNAL_REFERRAL. Contrato de `SaleCompletedV1`. */
     amountCents: number;
     /**
-     * Precio de lista del equipo al cerrar (de la reserva de la sesión). En contado coincide con
-     * `amountCents`; en crédito es el precio full financiado. `null` en ventas anteriores al campo.
+     * Ancla neta al cerrar (precio − discountCents de la ancla); base de comisión.
+     * `null` en ventas anteriores al campo.
      */
     equipmentPriceCents: number | null;
     /** Enganche cobrado (solo ventas CREDIT; `null` en contado/externa). */

package/bin/retailWizard/dtos/SaleLine.d.ts

@@ -1,8 +1,9 @@
 import type { SoldLineComponent } from '../../retailCatalog/dtos/responses/SellStockResponse';
 import type { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
 import type { WizardLineProduct } from './WizardLineProduct';
+import type { WizardLinePromotionFields } from './WizardLinePromotionFields';
 /** Línea de una venta cerrada; un producto suelto es un solo componente. */
-export interface SaleLine {
+export interface SaleLine extends WizardLinePromotionFields {
     lineId: string;
     sku: string;
     qty: number;
@@ -11,6 +12,8 @@ export interface SaleLine {
     /** Llave del registro PRICE# del que salió el precio. */
     priceSk: string;
     paymentType: LinePaymentTypeEnum;
+    /** Parte financiada de la línea, congelada en la venta. */
+    financedCents?: number;
     components: SoldLineComponent[];
     product?: WizardLineProduct | null;
 }

package/bin/retailWizard/dtos/WizardFinancingPreview.d.ts

@@ -0,0 +1,11 @@
+/** Parte financiada de una línea en el reparto provisional. */
+export interface WizardFinancingPreviewLine {
+    lineId: string;
+    financedCents: number;
+}
+/** Reparto provisional de la sesión; se calcula al leer y no se persiste. */
+export interface WizardFinancingPreview {
+    /** Tope de extras financiables: floor(30% × ancla neta). */
+    capCents: number;
+    lines: WizardFinancingPreviewLine[];
+}

package/bin/retailWizard/dtos/WizardFinancingPreview.js

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

package/bin/retailWizard/dtos/WizardGiftLine.d.ts

@@ -0,0 +1,10 @@
+import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
+import type { WizardReservedLine } from './WizardReservedLine';
+/** Línea GIFT: ligada a un ancla, con su promo y el precio de lista que se regala. */
+export type WizardGiftLine = WizardReservedLine & {
+    role: WizardLineRoleEnum.GIFT;
+    linkedLineId: string;
+    promotionId: string;
+    promotionVersion: number;
+    originalPriceCents: number;
+};

package/bin/retailWizard/dtos/WizardGiftLine.js

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