@fiado/type-kit 3.471.0 → 3.473.0

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,46 @@
+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/responses/SalePromotionCrudResponses';
+export * from './dtos/responses/DiscountCodeResponses';
+export * from './dtos/responses/WizardSalePromotionResponses';

package/bin/retailPromotions/index.js

@@ -0,0 +1,67 @@
+"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);
+// 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,8 @@
+import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
+import type { WizardReservedLine } from './WizardReservedLine';
+/** Línea GIFT: siempre ligada a un ancla y con el precio de lista que se regala. */
+export type WizardGiftLine = WizardReservedLine & {
+    role: WizardLineRoleEnum.GIFT;
+    linkedLineId: string;
+    originalPriceCents: number;
+};

package/bin/retailWizard/dtos/WizardGiftLine.js

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

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

@@ -0,0 +1,15 @@
+import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
+/** Campos de Promociones en la línea de sesión y de venta; solo los escribe su endpoint M2M. */
+export interface WizardLinePromotionFields {
+    role?: WizardLineRoleEnum;
+    promotionId?: string;
+    promotionVersion?: number;
+    /** Línea ancla a la que va ligado el regalo. */
+    linkedLineId?: string;
+    /** Solo en la línea ancla. */
+    discountCode?: string;
+    /** Descuento total de la línea; neto = basePriceCents × qty − discountCents. */
+    discountCents?: number;
+    /** Precio antes del descuento; en un regalo, el valor de lista con la línea a $0. */
+    originalPriceCents?: number;
+}

package/bin/retailWizard/dtos/WizardLinePromotionFields.js

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

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

@@ -4,8 +4,9 @@ import type { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
 import type { WizardLineStatusEnum } from '../enums/WizardLineStatusEnum';
 import type { WizardLineIdentifiers } from './WizardLineIdentifiers';
 import type { WizardLineProduct } from './WizardLineProduct';
+import type { WizardLinePromotionFields } from './WizardLinePromotionFields';
 /** Línea de la venta en curso; los campos de precio son `null` mientras la línea está PENDING. */
-export interface WizardReservedLine {
+export interface WizardReservedLine extends WizardLinePromotionFields {
     lineId: string;
     sku: string;
     qty: number;
@@ -26,6 +27,8 @@ export interface WizardReservedLine {
     paymentType: LinePaymentTypeEnum | null;
     /** Ítems que la línea suma al tope de 100 de la venta. */
     sellItemCost: number | null;
+    /** Parte financiada de la línea; se escribe al cotizar y se congela con el crédito. */
+    financedCents?: number;
     mdmEnabled?: boolean;
     mdmProvider?: MdmProviderEnum | null;
     /** Solo si la línea es un kit. */

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

@@ -6,6 +6,7 @@ import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { OccupationEnum } from '../enums/OccupationEnum';
 import type { WizardBlockedSummary } from './WizardBlocked';
 import type { WizardConsents } from './WizardConsents';
+import type { WizardFinancingPreview } from './WizardFinancingPreview';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
@@ -113,6 +114,15 @@ export interface WizardSession {
     reservedLines?: WizardReservedLine[];
     /** Línea elegida para financiar; `null` si la venta es de contado o aún no se elige. */
     financedLineId?: string | null;
+    /** Reparto provisional mientras haya líneas; se calcula al leer, no se persiste. */
+    financingPreview?: WizardFinancingPreview | null;
+    /** Marca de la saga: todas las piezas rastreadas de las líneas vivas quedaron HELD. */
+    piecesHeldAt?: string | null;
+    /** Promo de venta que fijó Promociones; `null` = ninguna. */
+    salePromotionId?: string | null;
+    salePromotionVersion?: number | null;
+    /** Enganche cobrado que queda por reembolsar tras cancelar. */
+    refundPendingCents?: number;
     paymentMethod: PaymentMethodEnum | null;
     externalProvider: ExternalProviderEnum | null;
     /** Folio de cobro server-side (D11), idempotente, sobrevive al volver atrás. */

package/bin/retailWizard/dtos/requests/AddProductRequest.d.ts

@@ -8,4 +8,6 @@ export declare class AddProductRequest {
     cashPriceCents?: number;
     /** Piezas de la línea; ausente = 1. */
     qty?: number;
+    /** Línea viva que este kit reemplaza («Cambiar por el kit»). */
+    replacesLineId?: string;
 }

package/bin/retailWizard/dtos/requests/AddProductRequest.js

@@ -44,3 +44,10 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], AddProductRequest.prototype, "qty", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], AddProductRequest.prototype, "replacesLineId", void 0);

package/bin/retailWizard/dtos/requests/ApplyLinePromotionRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion (privateApplyLinePromotion, M2M de Promociones).
+ * Reemplaza la promo de la línea por valor: un campo ausente queda borrado. `tenantId` va en el query.
+ * Nunca toca role ni linkedLineId: los GIFT los gestiona el PUT …/gifts. Responde 204 sin body.
+ */
+export declare class ApplyLinePromotionRequest {
+    promotionId?: string;
+    /** Va junto con promotionId; las versiones de Promociones empiezan en 1. */
+    promotionVersion?: number;
+    /** Solo en la línea ancla. */
+    discountCode?: string;
+    /** Descuento total de la línea; 0 mientras el código espera revalidarse. */
+    discountCents?: number;
+    originalPriceCents?: number;
+}

package/bin/retailWizard/dtos/requests/ApplyLinePromotionRequest.js

@@ -0,0 +1,58 @@
+"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.ApplyLinePromotionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const hasPromotion = (o) => o.promotionId !== undefined || o.promotionVersion !== undefined;
+/**
+ * PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion (privateApplyLinePromotion, M2M de Promociones).
+ * Reemplaza la promo de la línea por valor: un campo ausente queda borrado. `tenantId` va en el query.
+ * Nunca toca role ni linkedLineId: los GIFT los gestiona el PUT …/gifts. Responde 204 sin body.
+ */
+class ApplyLinePromotionRequest {
+}
+exports.ApplyLinePromotionRequest = ApplyLinePromotionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasPromotion),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ApplyLinePromotionRequest.prototype, "promotionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(hasPromotion),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ApplyLinePromotionRequest.prototype, "promotionVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ApplyLinePromotionRequest.prototype, "discountCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ApplyLinePromotionRequest.prototype, "discountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ApplyLinePromotionRequest.prototype, "originalPriceCents", void 0);

package/bin/retailWizard/dtos/requests/ApplySalePromotionRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PUT /private/wizard/sessions/{id}/sale-promotion (privateApplySalePromotion, M2M de Promociones).
+ * Ambos en `null` = «Ninguna»; la versión va solo con la promo. `tenantId` va en el query.
+ * Responde 204 sin body.
+ */
+export declare class ApplySalePromotionRequest {
+    salePromotionId: string | null;
+    salePromotionVersion: number | null;
+}