@fiado/type-kit 3.560.0 → 3.562.0

package/_test_/unit/directDeposit/directDepositDtos.test.ts

@@ -0,0 +1,38 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { GetDirectDepositFormatByDirectoryRequest, GetDirectDepositFormatRequest } from '../../../src/directDeposit';
+
+const parse = async <T extends object>(cls: new () => T, query: unknown) => {
+    const instance = plainToInstance(cls, query);
+    const errors = (await validate(instance as object, { whitelist: true })).map(e => e.property);
+    return { instance, errors };
+};
+
+describe('GetDirectDepositFormatRequest (app: el directoryId sale del token)', () => {
+    it('convierte percentage de string (query) a número', async () => {
+        const { instance, errors } = await parse(GetDirectDepositFormatRequest, { percentage: '50' });
+        expect(errors).toEqual([]);
+        expect(instance.percentage).toBe(50);
+    });
+
+    it('percentage es opcional', async () => {
+        expect((await parse(GetDirectDepositFormatRequest, {})).errors).toEqual([]);
+    });
+
+    it.each(['0', '101', '12.5', 'abc'])('rechaza percentage=%s', async (percentage) => {
+        expect((await parse(GetDirectDepositFormatRequest, { percentage })).errors).toEqual(['percentage']);
+    });
+});
+
+describe('GetDirectDepositFormatByDirectoryRequest (agentes y backoffice)', () => {
+    it('acepta directoryId con percentage', async () => {
+        const { instance, errors } = await parse(GetDirectDepositFormatByDirectoryRequest, { directoryId: 'dir-1', percentage: '30' });
+        expect(errors).toEqual([]);
+        expect(instance.percentage).toBe(30);
+    });
+
+    it.each([[{}], [{ directoryId: '' }]])('directoryId es obligatorio (%j)', async (query) => {
+        expect((await parse(GetDirectDepositFormatByDirectoryRequest, query)).errors).toEqual(['directoryId']);
+    });
+});

package/_test_/unit/pdfGenerator/pdfGeneratorDtos.test.ts

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { PdfGeneratorRequest } from '../../../src/pdfGenerator';
+
+const errorsOf = async (body: unknown) =>
+    (await validate(plainToInstance(PdfGeneratorRequest, body) as object, { whitelist: true })).map(e => e.property);
+
+describe('pdfGenerator DTOs', () => {
+    it('acepta html con page y provider', async () => {
+        expect(await errorsOf({
+            html: '<p>x</p>',
+            page: { size: 'A4', margin: { top: '45pt', right: '45pt', bottom: '45pt', left: '45pt' } },
+            provider: 'pdflib',
+        })).toEqual([]);
+    });
+
+    it('acepta solo html', async () => {
+        expect(await errorsOf({ html: '<p>x</p>' })).toEqual([]);
+    });
+
+    it('rechaza html vacío y provider desconocido', async () => {
+        expect((await errorsOf({ html: '', provider: 'chrome' })).sort()).toEqual(['html', 'provider']);
+    });
+
+    it('rechaza page que no es objeto', async () => {
+        expect(await errorsOf({ html: '<p>x</p>', page: 'A4' })).toEqual(['page']);
+    });
+});

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/directDeposit/dtos/DirectDepositFormatResponse.d.ts

@@ -0,0 +1,4 @@
+/** `data` de la respuesta: el PDF del formato Direct Deposit en base64. */
+export declare class DirectDepositFormatResponse {
+    format: string;
+}

package/bin/directDeposit/dtos/DirectDepositFormatResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectDepositFormatResponse = void 0;
+/** `data` de la respuesta: el PDF del formato Direct Deposit en base64. */
+class DirectDepositFormatResponse {
+}
+exports.DirectDepositFormatResponse = DirectDepositFormatResponse;

package/bin/directDeposit/dtos/GetDirectDepositFormatByDirectoryRequest.d.ts

@@ -0,0 +1,6 @@
+/** Query de GET /agents/direct-deposit y /backoffice/direct-deposit (+ /v2): formato de un tercero. */
+export declare class GetDirectDepositFormatByDirectoryRequest {
+    directoryId: string;
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    percentage?: number;
+}

package/bin/directDeposit/dtos/GetDirectDepositFormatByDirectoryRequest.js

@@ -0,0 +1,31 @@
+"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.GetDirectDepositFormatByDirectoryRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de GET /agents/direct-deposit y /backoffice/direct-deposit (+ /v2): formato de un tercero. */
+class GetDirectDepositFormatByDirectoryRequest {
+}
+exports.GetDirectDepositFormatByDirectoryRequest = GetDirectDepositFormatByDirectoryRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GetDirectDepositFormatByDirectoryRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], GetDirectDepositFormatByDirectoryRequest.prototype, "percentage", void 0);

package/bin/directDeposit/dtos/GetDirectDepositFormatRequest.d.ts

@@ -0,0 +1,5 @@
+/** Query de GET /direct-deposit (app) de direct-deposit-export-business. El directoryId sale del token. */
+export declare class GetDirectDepositFormatRequest {
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    percentage?: number;
+}

package/bin/directDeposit/dtos/GetDirectDepositFormatRequest.js

@@ -0,0 +1,26 @@
+"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.GetDirectDepositFormatRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de GET /direct-deposit (app) de direct-deposit-export-business. El directoryId sale del token. */
+class GetDirectDepositFormatRequest {
+}
+exports.GetDirectDepositFormatRequest = GetDirectDepositFormatRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], GetDirectDepositFormatRequest.prototype, "percentage", void 0);

package/bin/directDeposit/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/GetDirectDepositFormatRequest';
+export * from './dtos/GetDirectDepositFormatByDirectoryRequest';
+export * from './dtos/DirectDepositFormatResponse';

package/bin/directDeposit/index.js

@@ -0,0 +1,20 @@
+"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 });
+//dtos
+__exportStar(require("./dtos/GetDirectDepositFormatRequest"), exports);
+__exportStar(require("./dtos/GetDirectDepositFormatByDirectoryRequest"), exports);
+__exportStar(require("./dtos/DirectDepositFormatResponse"), exports);

package/bin/pdfGenerator/dtos/PdfGeneratorPageConfig.d.ts

@@ -0,0 +1,28 @@
+/** Tamaño nombrado o personalizado en puntos PDF (1pt = 1/72in). */
+export type PdfGeneratorPageSize = 'LETTER' | 'A4' | 'LEGAL' | {
+    width: number;
+    height: number;
+};
+/** Texto por página en el margen; acepta los tokens {page} y {pages}. */
+export declare class PdfGeneratorPageBoxText {
+    left?: string;
+    center?: string;
+    right?: string;
+    fontSize?: number;
+}
+/**
+ * Configuración de hoja de pdf-generator-business. Las longitudes de margen llevan unidad
+ * (mm, cm, in, pt, px). Sin `page`, el lambda usa el @page de la plantilla o A4 con 2 mm.
+ */
+export declare class PdfGeneratorPageConfig {
+    size?: PdfGeneratorPageSize;
+    orientation?: 'portrait' | 'landscape';
+    margin?: {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+    };
+    header?: PdfGeneratorPageBoxText;
+    footer?: PdfGeneratorPageBoxText;
+}

package/bin/pdfGenerator/dtos/PdfGeneratorPageConfig.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfGeneratorPageConfig = exports.PdfGeneratorPageBoxText = void 0;
+/** Texto por página en el margen; acepta los tokens {page} y {pages}. */
+class PdfGeneratorPageBoxText {
+}
+exports.PdfGeneratorPageBoxText = PdfGeneratorPageBoxText;
+/**
+ * Configuración de hoja de pdf-generator-business. Las longitudes de margen llevan unidad
+ * (mm, cm, in, pt, px). Sin `page`, el lambda usa el @page de la plantilla o A4 con 2 mm.
+ */
+class PdfGeneratorPageConfig {
+}
+exports.PdfGeneratorPageConfig = PdfGeneratorPageConfig;

package/bin/pdfGenerator/dtos/PdfGeneratorRequest.d.ts

@@ -0,0 +1,9 @@
+import { PdfGeneratorPageConfig } from './PdfGeneratorPageConfig';
+/** POST /generate-pdf de pdf-generator-business: HTML ya armado → PDF en base64. */
+export declare class PdfGeneratorRequest {
+    html: string;
+    /** La valida a fondo el propio lambda (400 con el campo que falla). */
+    page?: PdfGeneratorPageConfig;
+    /** Override del motor para este request (default del lambda: pdflib). */
+    provider?: 'pdflib' | 'puppeteer';
+}

package/bin/pdfGenerator/dtos/PdfGeneratorRequest.js

@@ -0,0 +1,33 @@
+"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.PdfGeneratorRequest = void 0;
+const class_validator_1 = require("class-validator");
+const PdfGeneratorPageConfig_1 = require("./PdfGeneratorPageConfig");
+/** POST /generate-pdf de pdf-generator-business: HTML ya armado → PDF en base64. */
+class PdfGeneratorRequest {
+}
+exports.PdfGeneratorRequest = PdfGeneratorRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PdfGeneratorRequest.prototype, "html", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", PdfGeneratorPageConfig_1.PdfGeneratorPageConfig)
+], PdfGeneratorRequest.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(['pdflib', 'puppeteer']),
+    __metadata("design:type", String)
+], PdfGeneratorRequest.prototype, "provider", void 0);

package/bin/pdfGenerator/dtos/PdfGeneratorResponse.d.ts

@@ -0,0 +1,4 @@
+/** Respuesta de POST /generate-pdf. El header X-Pdf-Provider indica el motor usado. */
+export declare class PdfGeneratorResponse {
+    base64: string;
+}

package/bin/pdfGenerator/dtos/PdfGeneratorResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfGeneratorResponse = void 0;
+/** Respuesta de POST /generate-pdf. El header X-Pdf-Provider indica el motor usado. */
+class PdfGeneratorResponse {
+}
+exports.PdfGeneratorResponse = PdfGeneratorResponse;

package/bin/pdfGenerator/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/PdfGeneratorPageConfig';
+export * from './dtos/PdfGeneratorRequest';
+export * from './dtos/PdfGeneratorResponse';

package/bin/pdfGenerator/index.js

@@ -0,0 +1,20 @@
+"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 });
+//dtos
+__exportStar(require("./dtos/PdfGeneratorPageConfig"), exports);
+__exportStar(require("./dtos/PdfGeneratorRequest"), exports);
+__exportStar(require("./dtos/PdfGeneratorResponse"), exports);

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.560.0",
+  "version": "3.562.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/directDeposit/dtos/DirectDepositFormatResponse.ts

@@ -0,0 +1,4 @@
+/** `data` de la respuesta: el PDF del formato Direct Deposit en base64. */
+export class DirectDepositFormatResponse {
+    format!: string;
+}

package/src/directDeposit/dtos/GetDirectDepositFormatByDirectoryRequest.ts

@@ -0,0 +1,12 @@
+import { Type } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/** Query de GET /agents/direct-deposit y /backoffice/direct-deposit (+ /v2): formato de un tercero. */
+export class GetDirectDepositFormatByDirectoryRequest {
+    @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    @IsOptional() @Type(() => Number) @IsInt() @Min(1) @Max(100)
+    percentage?: number;
+}

package/src/directDeposit/dtos/GetDirectDepositFormatRequest.ts

@@ -0,0 +1,9 @@
+import { Type } from 'class-transformer';
+import { IsInt, IsOptional, Max, Min } from 'class-validator';
+
+/** Query de GET /direct-deposit (app) de direct-deposit-export-business. El directoryId sale del token. */
+export class GetDirectDepositFormatRequest {
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    @IsOptional() @Type(() => Number) @IsInt() @Min(1) @Max(100)
+    percentage?: number;
+}

package/src/directDeposit/index.ts

@@ -0,0 +1,4 @@
+//dtos
+export * from './dtos/GetDirectDepositFormatRequest';
+export * from './dtos/GetDirectDepositFormatByDirectoryRequest';
+export * from './dtos/DirectDepositFormatResponse';

package/src/pdfGenerator/dtos/PdfGeneratorPageConfig.ts

@@ -0,0 +1,22 @@
+/** Tamaño nombrado o personalizado en puntos PDF (1pt = 1/72in). */
+export type PdfGeneratorPageSize = 'LETTER' | 'A4' | 'LEGAL' | { width: number; height: number };
+
+/** Texto por página en el margen; acepta los tokens {page} y {pages}. */
+export class PdfGeneratorPageBoxText {
+    left?: string;
+    center?: string;
+    right?: string;
+    fontSize?: number;
+}
+
+/**
+ * Configuración de hoja de pdf-generator-business. Las longitudes de margen llevan unidad
+ * (mm, cm, in, pt, px). Sin `page`, el lambda usa el @page de la plantilla o A4 con 2 mm.
+ */
+export class PdfGeneratorPageConfig {
+    size?: PdfGeneratorPageSize;
+    orientation?: 'portrait' | 'landscape';
+    margin?: { top?: string; right?: string; bottom?: string; left?: string };
+    header?: PdfGeneratorPageBoxText;
+    footer?: PdfGeneratorPageBoxText;
+}

package/src/pdfGenerator/dtos/PdfGeneratorRequest.ts

@@ -0,0 +1,16 @@
+import { IsIn, IsNotEmpty, IsObject, IsOptional, IsString } from 'class-validator';
+import { PdfGeneratorPageConfig } from './PdfGeneratorPageConfig';
+
+/** POST /generate-pdf de pdf-generator-business: HTML ya armado → PDF en base64. */
+export class PdfGeneratorRequest {
+    @IsString() @IsNotEmpty()
+    html!: string;
+
+    /** La valida a fondo el propio lambda (400 con el campo que falla). */
+    @IsOptional() @IsObject()
+    page?: PdfGeneratorPageConfig;
+
+    /** Override del motor para este request (default del lambda: pdflib). */
+    @IsOptional() @IsIn(['pdflib', 'puppeteer'])
+    provider?: 'pdflib' | 'puppeteer';
+}

package/src/pdfGenerator/dtos/PdfGeneratorResponse.ts

@@ -0,0 +1,4 @@
+/** Respuesta de POST /generate-pdf. El header X-Pdf-Provider indica el motor usado. */
+export class PdfGeneratorResponse {
+    base64!: string;
+}

package/src/pdfGenerator/index.ts

@@ -0,0 +1,4 @@
+//dtos
+export * from './dtos/PdfGeneratorPageConfig';
+export * from './dtos/PdfGeneratorRequest';
+export * from './dtos/PdfGeneratorResponse';

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. */