@fiado/type-kit 3.559.0 → 3.561.0

package/_test_/unit/retailPromotions/constants.test.ts

@@ -43,10 +43,15 @@ describe('catálogo de errores', () => {
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_FOUND).toBe(404);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.DISCOUNT_AFTER_QUOTE).toBe(409);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_OWNED).toBe(422);
-    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(31);
+    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(32);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.SPLIT_FINANCING_DISABLED).toBe(409);
   });
 
+  it('la forma de pago que la promo no acepta es 422', () => {
+    expect(RetailPromotionsErrorCodeEnum.PROMOTION_PAYMENT_NOT_ELIGIBLE).toBe('PROMOTION_PAYMENT_NOT_ELIGIBLE');
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.PROMOTION_PAYMENT_NOT_ELIGIBLE).toBe(422);
+  });
+
   it('promo de regalo y de venta mandadas en el campo equivocado son 422', () => {
     expect(RetailPromotionsErrorCodeEnum.PROMOTION_KIND_MISMATCH).toBe('PROMOTION_KIND_MISMATCH');
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.PROMOTION_KIND_MISMATCH).toBe(422);

package/_test_/unit/retailPromotions/salePromotionRequests.test.ts

@@ -8,6 +8,7 @@ import {
   ListSalePromotionLogQuery,
   ListSalePromotionsQuery,
   PromotionAppliesToEnum,
+  PromotionPaymentOptionEnum,
   SalePromotionTransitionEnum,
   UpdateSalePromotionRequest,
 } from '../../../src/retailPromotions/index';
@@ -157,3 +158,23 @@ describe('queries paginadas', () => {
     expect(await errorPaths(ListSalePromotionLogQuery, { format: 'XLSX' })).toContain('format');
   });
 });
+
+describe('paymentOptions en alta y edición', () => {
+  it.each([CreateSalePromotionRequest, UpdateSalePromotionRequest])('%p acepta lista del enum, null o ausente', async (dto) => {
+    const full = dto === CreateSalePromotionRequest ? base : {};
+    const all = Object.values(PromotionPaymentOptionEnum);
+    expect(await errorPaths(dto, { ...full, paymentOptions: all })).toEqual([]);
+    expect(await errorPaths(dto, { ...full, paymentOptions: null })).toEqual([]);
+    expect(await errorPaths(dto, full)).toEqual([]);
+  });
+
+  it.each([CreateSalePromotionRequest, UpdateSalePromotionRequest])('%p rechaza un valor fuera del enum', async (dto) => {
+    const full = dto === CreateSalePromotionRequest ? base : {};
+    expect(await errorPaths(dto, { ...full, paymentOptions: ['SUREKEEP', 'BITCOIN'] })).toEqual(['paymentOptions']);
+    expect(await errorPaths(dto, { ...full, paymentOptions: 'CASH' })).toEqual(['paymentOptions']);
+  });
+
+  it('el enum trae las 8 formas de pago', () => {
+    expect(Object.values(PromotionPaymentOptionEnum)).toEqual(['SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA', 'CASH', 'CARD', 'WIRE']);
+  });
+});

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

@@ -16,8 +16,6 @@ const validSale = {
   paymentMethod: SalePaymentMethodEnum.CASH,
   amountCents: 39800,
   paymentDetail: { cashConfirmedInRegister: true },
-  privacyNoticeAccepted: true,
-  privacyNoticeVersion: 'AVISO-2026-10',
 };
 
 describe('CreateAccessorySaleRequest', () => {
@@ -52,12 +50,12 @@ describe('CreateAccessorySaleRequest', () => {
     expect(errorsOf(CreateAccessorySaleRequest, rest)).toContain('paymentDetail');
   });
 
-  it('exige la versión del aviso de privacidad', () => {
-    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, privacyNoticeVersion: '' })).toContain('privacyNoticeVersion');
-  });
-
-  it('privacyNoticeAccepted no booleano → error de formato', () => {
-    expect(errorsOf(CreateAccessorySaleRequest, { ...validSale, privacyNoticeAccepted: 'si' })).toContain('privacyNoticeAccepted');
+  it('no lleva aviso de privacidad: privacyNoticeAccepted y privacyNoticeVersion se descartan', () => {
+    const payload = { ...validSale, privacyNoticeAccepted: true, privacyNoticeVersion: 'AVISO-2026-10' };
+    const dto = plainToInstance(CreateAccessorySaleRequest, payload, { excludeExtraneousValues: true });
+    expect(dto).not.toHaveProperty('privacyNoticeAccepted');
+    expect(dto).not.toHaveProperty('privacyNoticeVersion');
+    expect(validateSync(dto)).toEqual([]);
   });
 
   it('el medio WIRE (SPEI) es válido', () => {

package/bin/notificationMessages/dtos/DisputeNotificationData.d.ts

@@ -1,9 +1,19 @@
+import { ProviderCode } from '../../provider/enums/ProviderCode';
 /**
  * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
  * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ *
+ * Para abrir la ficha al tocar el push, la app navega al detalle del movimiento con
+ * `transactionNumber` + `providerCode` (mismo par que usan
+ * `/trx/transactions/code/{providerCode}/id/{transactionNumber}` y
+ * `/disputes/transaction/{providerCode}/{transactionNumber}`).
  */
 export declare class DisputeNotificationData {
     id: string;
     folio: string;
     folioId?: string;
+    /** Número de la transacción reclamada. Ausente si el folio no tiene transacción real (alta desde el Dashboard). */
+    transactionNumber?: string;
+    /** Código del proveedor de esa transacción (Pago ConFiado = P9429). */
+    providerCode?: ProviderCode;
 }

package/bin/notificationMessages/dtos/DisputeNotificationData.js

@@ -4,6 +4,11 @@ exports.DisputeNotificationData = void 0;
 /**
  * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
  * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ *
+ * Para abrir la ficha al tocar el push, la app navega al detalle del movimiento con
+ * `transactionNumber` + `providerCode` (mismo par que usan
+ * `/trx/transactions/code/{providerCode}/id/{transactionNumber}` y
+ * `/disputes/transaction/{providerCode}/{transactionNumber}`).
  */
 class DisputeNotificationData {
 }

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -35,4 +35,5 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CATALOG_SKU_NOT_FOUND]: 404,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SPLIT_FINANCING_DISABLED]: 409,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_NOT_STACKABLE]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
 };

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

@@ -1,4 +1,5 @@
 import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum';
 import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
 import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
 import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
@@ -12,7 +13,10 @@ export interface SalePromotion {
     levers: SalePromotionLevers;
     scope: SalePromotionScope;
     segmentation: SalePromotionSegmentation;
+    /** @deprecated Usa `paymentOptions`; se deriva de ella. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. */
+    paymentOptions: PromotionPaymentOptionEnum[] | null;
     /** `null` = sin tope. */
     budgetMaxCents: number | null;
     budgetConsumedCents: number;

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.d.ts

@@ -1,4 +1,5 @@
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 /** Body de publicCreateSalePromotion. Nace en `DRAFT`; el retailer sale del token. */
@@ -8,8 +9,10 @@ export declare class CreateSalePromotionRequest {
     levers: SalePromotionLeversInput;
     scope?: SalePromotionScopeInput | null;
     segmentation?: SalePromotionSegmentationInput | null;
-    /** Ausente = `SUREKEEP_ONLY`. */
+    /** @deprecated Usa `paymentOptions`; solo se lee si `paymentOptions` no viene. Ausente = `SUREKEEP_ONLY`. */
     appliesTo?: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. Ausente = `[SUREKEEP]`. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
     /** `null` = sin tope. */
     budgetMaxCents?: number | null;
     validFrom?: string | null;

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.js

@@ -13,6 +13,7 @@ exports.CreateSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
+const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const SalePromotionLeversInput_1 = require("./SalePromotionLeversInput");
 const SalePromotionScopeInput_1 = require("./SalePromotionScopeInput");
 /** Body de publicCreateSalePromotion. Nace en `DRAFT`; el retailer sale del token. */
@@ -57,6 +58,13 @@ __decorate([
     (0, class_validator_1.IsEnum)(PromotionAppliesToEnum_1.PromotionAppliesToEnum),
     __metadata("design:type", String)
 ], CreateSalePromotionRequest.prototype, "appliesTo", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(PromotionPaymentOptionEnum_1.PromotionPaymentOptionEnum, { each: true }),
+    __metadata("design:type", Array)
+], CreateSalePromotionRequest.prototype, "paymentOptions", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.d.ts

@@ -1,4 +1,5 @@
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 /** Body de publicUpdateSalePromotion: parche; el lambda crea una versión nueva para ventas futuras. */
@@ -8,8 +9,10 @@ export declare class UpdateSalePromotionRequest {
     levers?: SalePromotionLeversInput;
     scope?: SalePromotionScopeInput | null;
     segmentation?: SalePromotionSegmentationInput | null;
-    /** Ausente = conserva el valor actual. */
+    /** @deprecated Usa `paymentOptions`; solo se lee si `paymentOptions` no viene. Ausente = conserva el valor actual. */
     appliesTo?: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. Ausente = conserva el valor actual. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
     /** `null` = sin tope. */
     budgetMaxCents?: number | null;
     validFrom?: string | null;

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.js

@@ -13,6 +13,7 @@ exports.UpdateSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
+const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const SalePromotionLeversInput_1 = require("./SalePromotionLeversInput");
 const SalePromotionScopeInput_1 = require("./SalePromotionScopeInput");
 /** Body de publicUpdateSalePromotion: parche; el lambda crea una versión nueva para ventas futuras. */
@@ -59,6 +60,13 @@ __decorate([
     (0, class_validator_1.IsEnum)(PromotionAppliesToEnum_1.PromotionAppliesToEnum),
     __metadata("design:type", String)
 ], UpdateSalePromotionRequest.prototype, "appliesTo", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(PromotionPaymentOptionEnum_1.PromotionPaymentOptionEnum, { each: true }),
+    __metadata("design:type", Array)
+], UpdateSalePromotionRequest.prototype, "paymentOptions", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailPromotions/dtos/responses/WizardSalePromotionResponses.d.ts

@@ -3,6 +3,7 @@ import { CouponStatusEnum } from '../../enums/CouponStatusEnum';
 import { EntitlementKindEnum } from '../../enums/EntitlementKindEnum';
 import { EntitlementStateEnum } from '../../enums/EntitlementStateEnum';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { RetailPromotionsErrorCodeEnum } from '../../enums/RetailPromotionsErrorCodeEnum';
 import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEnum';
 import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
@@ -25,8 +26,10 @@ export interface StoreSalePromotionItem {
     levers: SalePromotionLevers;
     /** Para cruzar con cada equipo; todo `null` = fila «Toda la tienda». */
     scope: SalePromotionScope;
-    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    /** @deprecated Usa `paymentOptions`. SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = cualquier otra lista. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable: boolean;
     /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */
@@ -68,8 +71,10 @@ export interface EvaluatedSalePromotion {
     giftOptions: GiftOption[];
     giftChooseCount: number | null;
     afterSale: AfterSaleBenefit[];
-    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    /** @deprecated Usa `paymentOptions`. SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = cualquier otra lista. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable: boolean;
     /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */

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

@@ -1,5 +1,6 @@
 /**
  * Con qué financiera aplica una promo o un código. Sin valor, el lambda asume `SUREKEEP_ONLY`.
+ * En promos de venta lo reemplaza `paymentOptions` (`PromotionPaymentOptionEnum`).
  * @enum {string}
  */
 export declare enum PromotionAppliesToEnum {

package/bin/retailPromotions/enums/PromotionAppliesToEnum.js

@@ -3,6 +3,7 @@ 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`.
+ * En promos de venta lo reemplaza `paymentOptions` (`PromotionPaymentOptionEnum`).
  * @enum {string}
  */
 var PromotionAppliesToEnum;

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

@@ -0,0 +1,15 @@
+/**
+ * Forma de pago con la que aplica una promo de venta. SUREKEEP = crédito SureKeep; PAYJOY…INNOVA = derivada
+ * a esa financiera; CASH, CARD y WIRE = contado con ese medio de cobro.
+ * @enum {string}
+ */
+export declare enum PromotionPaymentOptionEnum {
+    SUREKEEP = "SUREKEEP",
+    PAYJOY = "PAYJOY",
+    CREDIYA = "CREDIYA",
+    LESPAGO = "LESPAGO",
+    INNOVA = "INNOVA",
+    CASH = "CASH",
+    CARD = "CARD",
+    WIRE = "WIRE"
+}

package/bin/retailPromotions/enums/PromotionPaymentOptionEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionPaymentOptionEnum = void 0;
+/**
+ * Forma de pago con la que aplica una promo de venta. SUREKEEP = crédito SureKeep; PAYJOY…INNOVA = derivada
+ * a esa financiera; CASH, CARD y WIRE = contado con ese medio de cobro.
+ * @enum {string}
+ */
+var PromotionPaymentOptionEnum;
+(function (PromotionPaymentOptionEnum) {
+    PromotionPaymentOptionEnum["SUREKEEP"] = "SUREKEEP";
+    PromotionPaymentOptionEnum["PAYJOY"] = "PAYJOY";
+    PromotionPaymentOptionEnum["CREDIYA"] = "CREDIYA";
+    PromotionPaymentOptionEnum["LESPAGO"] = "LESPAGO";
+    PromotionPaymentOptionEnum["INNOVA"] = "INNOVA";
+    PromotionPaymentOptionEnum["CASH"] = "CASH";
+    PromotionPaymentOptionEnum["CARD"] = "CARD";
+    PromotionPaymentOptionEnum["WIRE"] = "WIRE";
+})(PromotionPaymentOptionEnum || (exports.PromotionPaymentOptionEnum = PromotionPaymentOptionEnum = {}));

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

@@ -46,5 +46,7 @@ export declare enum RetailPromotionsErrorCodeEnum {
     /** Con el reparto apagado no se aplican palancas de precio ni código; los regalos sí. */
     SPLIT_FINANCING_DISABLED = "SPLIT_FINANCING_DISABLED",
     /** La promo no acumulable choca con otra en la misma línea. */
-    PROMOTION_NOT_STACKABLE = "PROMOTION_NOT_STACKABLE"
+    PROMOTION_NOT_STACKABLE = "PROMOTION_NOT_STACKABLE",
+    /** La promo no acepta la forma de pago o el medio de cobro de la venta. */
+    PROMOTION_PAYMENT_NOT_ELIGIBLE = "PROMOTION_PAYMENT_NOT_ELIGIBLE"
 }

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -51,4 +51,6 @@ var RetailPromotionsErrorCodeEnum;
     RetailPromotionsErrorCodeEnum["SPLIT_FINANCING_DISABLED"] = "SPLIT_FINANCING_DISABLED";
     /** La promo no acumulable choca con otra en la misma línea. */
     RetailPromotionsErrorCodeEnum["PROMOTION_NOT_STACKABLE"] = "PROMOTION_NOT_STACKABLE";
+    /** La promo no acepta la forma de pago o el medio de cobro de la venta. */
+    RetailPromotionsErrorCodeEnum["PROMOTION_PAYMENT_NOT_ELIGIBLE"] = "PROMOTION_PAYMENT_NOT_ELIGIBLE";
 })(RetailPromotionsErrorCodeEnum || (exports.RetailPromotionsErrorCodeEnum = RetailPromotionsErrorCodeEnum = {}));

package/bin/retailPromotions/index.d.ts

@@ -7,6 +7,7 @@ export * from './enums/SalePromotionLogFormatEnum';
 export * from './enums/DiscountTypeEnum';
 export * from './enums/GiftModeEnum';
 export * from './enums/PromotionAppliesToEnum';
+export * from './enums/PromotionPaymentOptionEnum';
 export * from './enums/CouponScopeEnum';
 export * from './enums/CouponStatusEnum';
 export * from './enums/DiscountCodeStatusEnum';

package/bin/retailPromotions/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./enums/SalePromotionLogFormatEnum"), exports);
 __exportStar(require("./enums/DiscountTypeEnum"), exports);
 __exportStar(require("./enums/GiftModeEnum"), exports);
 __exportStar(require("./enums/PromotionAppliesToEnum"), exports);
+__exportStar(require("./enums/PromotionPaymentOptionEnum"), exports);
 __exportStar(require("./enums/CouponScopeEnum"), exports);
 __exportStar(require("./enums/CouponStatusEnum"), exports);
 __exportStar(require("./enums/DiscountCodeStatusEnum"), exports);

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

@@ -10,8 +10,4 @@ export declare class CreateAccessorySaleRequest {
     paymentMethod: SalePaymentMethodEnum;
     amountCents: number;
     paymentDetail: SalePaymentDetail;
-    /** El cliente aceptó el aviso de privacidad; sin `true` el back responde 400 PRIVACY_NOTICE_REQUIRED. */
-    privacyNoticeAccepted?: boolean;
-    /** Versión del aviso de privacidad que se mostró. */
-    privacyNoticeVersion: string;
 }

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

@@ -49,15 +49,3 @@ __decorate([
     (0, class_transformer_1.Type)(() => SalePaymentDetail_1.SalePaymentDetail),
     __metadata("design:type", SalePaymentDetail_1.SalePaymentDetail)
 ], CreateAccessorySaleRequest.prototype, "paymentDetail", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsBoolean)(),
-    __metadata("design:type", Boolean)
-], CreateAccessorySaleRequest.prototype, "privacyNoticeAccepted", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MinLength)(1),
-    __metadata("design:type", String)
-], CreateAccessorySaleRequest.prototype, "privacyNoticeVersion", void 0);

package/bin/retailWizard/dtos/responses/PrivateWizardSessionResponse.d.ts

@@ -1,3 +1,4 @@
+import type { ExternalProviderEnum } from '../../enums/ExternalProviderEnum';
 import type { PaymentMethodEnum } from '../../enums/PaymentMethodEnum';
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
@@ -27,6 +28,8 @@ export interface PrivateWizardSessionResponse {
     folio?: string | null;
     /** Forma de pago que eligió el vendedor; existe antes que `creditId`. */
     paymentMethod?: PaymentMethodEnum | null;
+    /** Financiera de la venta derivada (`paymentMethod = EXTERNAL`); `null` en las demás. */
+    externalProvider?: ExternalProviderEnum | null;
     /** Cobro de contado; `null` mientras no se cobra. */
     payment?: WizardPayment | null;
     /** Valor efectivo del flag SPLIT_FINANCING_ENABLED del wizard. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.559.0",
+  "version": "3.561.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/notificationMessages/dtos/DisputeNotificationData.ts

@@ -1,9 +1,20 @@
+import { ProviderCode } from '../../provider/enums/ProviderCode';
+
 /**
  * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
  * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ *
+ * Para abrir la ficha al tocar el push, la app navega al detalle del movimiento con
+ * `transactionNumber` + `providerCode` (mismo par que usan
+ * `/trx/transactions/code/{providerCode}/id/{transactionNumber}` y
+ * `/disputes/transaction/{providerCode}/{transactionNumber}`).
  */
 export class DisputeNotificationData {
     id: string;        // templateId (DISPUTE_DICTAMEN_PROCEDENTE, DISPUTE_REOPEN_CONFIRMED, ...)
     folio: string;     // disputeOrFraudFolio
     folioId?: string;  // id del folio en DisputeOrFraudLog
+    /** Número de la transacción reclamada. Ausente si el folio no tiene transacción real (alta desde el Dashboard). */
+    transactionNumber?: string;
+    /** Código del proveedor de esa transacción (Pago ConFiado = P9429). */
+    providerCode?: ProviderCode;
 }

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -33,4 +33,5 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 |
     [C.CATALOG_SKU_NOT_FOUND]: 404,
     [C.SPLIT_FINANCING_DISABLED]: 409,
     [C.PROMOTION_NOT_STACKABLE]: 422,
+    [C.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
 };

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -1,4 +1,5 @@
 import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum';
 import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
 import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
 import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
@@ -13,7 +14,10 @@ export interface SalePromotion {
     levers: SalePromotionLevers;
     scope: SalePromotionScope;
     segmentation: SalePromotionSegmentation;
+    /** @deprecated Usa `paymentOptions`; se deriva de ella. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. */
+    paymentOptions: PromotionPaymentOptionEnum[] | null;
     /** `null` = sin tope. */
     budgetMaxCents: number | null;
     budgetConsumedCents: number;

package/src/retailPromotions/dtos/requests/CreateSalePromotionRequest.ts

@@ -1,5 +1,6 @@
 import { Expose, Type } from 'class-transformer';
 import {
+    IsArray,
     IsBoolean,
     IsDefined,
     IsEnum,
@@ -11,6 +12,7 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 
@@ -43,12 +45,19 @@ export class CreateSalePromotionRequest {
     @Type(() => SalePromotionSegmentationInput)
     segmentation?: SalePromotionSegmentationInput | null;
 
-    /** Ausente = `SUREKEEP_ONLY`. */
+    /** @deprecated Usa `paymentOptions`; solo se lee si `paymentOptions` no viene. Ausente = `SUREKEEP_ONLY`. */
     @Expose()
     @IsOptional()
     @IsEnum(PromotionAppliesToEnum)
     appliesTo?: PromotionAppliesToEnum;
 
+    /** Formas de pago con las que aplica; `null` = cualquiera. Ausente = `[SUREKEEP]`. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(PromotionPaymentOptionEnum, { each: true })
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
+
     /** `null` = sin tope. */
     @Expose()
     @IsOptional()

package/src/retailPromotions/dtos/requests/UpdateSalePromotionRequest.ts

@@ -1,5 +1,6 @@
 import { Expose, Type } from 'class-transformer';
 import {
+    IsArray,
     IsBoolean,
     IsEnum,
     IsInt,
@@ -10,6 +11,7 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 
@@ -44,12 +46,19 @@ export class UpdateSalePromotionRequest {
     @Type(() => SalePromotionSegmentationInput)
     segmentation?: SalePromotionSegmentationInput | null;
 
-    /** Ausente = conserva el valor actual. */
+    /** @deprecated Usa `paymentOptions`; solo se lee si `paymentOptions` no viene. Ausente = conserva el valor actual. */
     @Expose()
     @IsOptional()
     @IsEnum(PromotionAppliesToEnum)
     appliesTo?: PromotionAppliesToEnum;
 
+    /** Formas de pago con las que aplica; `null` = cualquiera. Ausente = conserva el valor actual. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(PromotionPaymentOptionEnum, { each: true })
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
+
     /** `null` = sin tope. */
     @Expose()
     @IsOptional()

package/src/retailPromotions/dtos/responses/WizardSalePromotionResponses.ts

@@ -3,6 +3,7 @@ import { CouponStatusEnum } from '../../enums/CouponStatusEnum';
 import { EntitlementKindEnum } from '../../enums/EntitlementKindEnum';
 import { EntitlementStateEnum } from '../../enums/EntitlementStateEnum';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { RetailPromotionsErrorCodeEnum } from '../../enums/RetailPromotionsErrorCodeEnum';
 import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEnum';
 import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
@@ -27,8 +28,10 @@ export interface StoreSalePromotionItem {
     levers: SalePromotionLevers;
     /** Para cruzar con cada equipo; todo `null` = fila «Toda la tienda». */
     scope: SalePromotionScope;
-    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    /** @deprecated Usa `paymentOptions`. SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = cualquier otra lista. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable: boolean;
     /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */
@@ -74,8 +77,10 @@ export interface EvaluatedSalePromotion {
     giftOptions: GiftOption[];
     giftChooseCount: number | null;
     afterSale: AfterSaleBenefit[];
-    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    /** @deprecated Usa `paymentOptions`. SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = cualquier otra lista. */
     appliesTo: PromotionAppliesToEnum;
+    /** Formas de pago con las que aplica; `null` = cualquiera. */
+    paymentOptions?: PromotionPaymentOptionEnum[] | null;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable: boolean;
     /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */

package/src/retailPromotions/enums/PromotionAppliesToEnum.ts

@@ -1,5 +1,6 @@
 /**
  * Con qué financiera aplica una promo o un código. Sin valor, el lambda asume `SUREKEEP_ONLY`.
+ * En promos de venta lo reemplaza `paymentOptions` (`PromotionPaymentOptionEnum`).
  * @enum {string}
  */
 export enum PromotionAppliesToEnum {

package/src/retailPromotions/enums/PromotionPaymentOptionEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Forma de pago con la que aplica una promo de venta. SUREKEEP = crédito SureKeep; PAYJOY…INNOVA = derivada
+ * a esa financiera; CASH, CARD y WIRE = contado con ese medio de cobro.
+ * @enum {string}
+ */
+export enum PromotionPaymentOptionEnum {
+    SUREKEEP = 'SUREKEEP',
+    PAYJOY = 'PAYJOY',
+    CREDIYA = 'CREDIYA',
+    LESPAGO = 'LESPAGO',
+    INNOVA = 'INNOVA',
+    CASH = 'CASH',
+    CARD = 'CARD',
+    WIRE = 'WIRE',
+}

package/src/retailPromotions/enums/RetailPromotionsErrorCodeEnum.ts

@@ -47,4 +47,6 @@ export enum RetailPromotionsErrorCodeEnum {
     SPLIT_FINANCING_DISABLED = 'SPLIT_FINANCING_DISABLED',
     /** La promo no acumulable choca con otra en la misma línea. */
     PROMOTION_NOT_STACKABLE = 'PROMOTION_NOT_STACKABLE',
+    /** La promo no acepta la forma de pago o el medio de cobro de la venta. */
+    PROMOTION_PAYMENT_NOT_ELIGIBLE = 'PROMOTION_PAYMENT_NOT_ELIGIBLE',
 }

package/src/retailPromotions/index.ts

@@ -8,6 +8,7 @@ export * from './enums/SalePromotionLogFormatEnum';
 export * from './enums/DiscountTypeEnum';
 export * from './enums/GiftModeEnum';
 export * from './enums/PromotionAppliesToEnum';
+export * from './enums/PromotionPaymentOptionEnum';
 export * from './enums/CouponScopeEnum';
 export * from './enums/CouponStatusEnum';
 export * from './enums/DiscountCodeStatusEnum';

package/src/retailWizard/dtos/requests/CreateAccessorySaleRequest.ts

@@ -3,14 +3,10 @@ import {
   ArrayMaxSize,
   ArrayMinSize,
   IsArray,
-  IsBoolean,
   IsDefined,
   IsEnum,
   IsInt,
-  IsOptional,
-  IsString,
   Min,
-  MinLength,
   ValidateNested,
 } from 'class-validator';
 import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
@@ -44,16 +40,4 @@ export class CreateAccessorySaleRequest {
   @ValidateNested()
   @Type(() => SalePaymentDetail)
   paymentDetail!: SalePaymentDetail;
-
-  /** El cliente aceptó el aviso de privacidad; sin `true` el back responde 400 PRIVACY_NOTICE_REQUIRED. */
-  @Expose()
-  @IsOptional()
-  @IsBoolean()
-  privacyNoticeAccepted?: boolean;
-
-  /** Versión del aviso de privacidad que se mostró. */
-  @Expose()
-  @IsString()
-  @MinLength(1)
-  privacyNoticeVersion!: string;
 }

package/src/retailWizard/dtos/responses/PrivateWizardSessionResponse.ts

@@ -1,3 +1,4 @@
+import type { ExternalProviderEnum } from '../../enums/ExternalProviderEnum';
 import type { PaymentMethodEnum } from '../../enums/PaymentMethodEnum';
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
@@ -28,6 +29,8 @@ export interface PrivateWizardSessionResponse {
   folio?: string | null;
   /** Forma de pago que eligió el vendedor; existe antes que `creditId`. */
   paymentMethod?: PaymentMethodEnum | null;
+  /** Financiera de la venta derivada (`paymentMethod = EXTERNAL`); `null` en las demás. */
+  externalProvider?: ExternalProviderEnum | null;
   /** Cobro de contado; `null` mientras no se cobra. */
   payment?: WizardPayment | null;
   /** Valor efectivo del flag SPLIT_FINANCING_ENABLED del wizard. */