@fiado/type-kit 3.363.0 → 3.365.0

package/_test_/unit/loanOfferings/promotionRequests.test.ts

@@ -0,0 +1,62 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  CreatePromotionRequest,
+  CreditPlanLevelEnum,
+  UpdatePromotionRequest,
+} from '../../../src/loanOfferings/index';
+
+/** El alta mínima válida. */
+const base = {
+  name: 'Enganche 5 puntos menos',
+  description: 'Baja el enganche mínimo cinco puntos en Plata',
+  effect: { downPaymentDeltaPct: 0.05 },
+  segmentId: 'SEG_SILVER',
+  targetLevels: ['SILVER'],
+};
+
+const errorProperties = async (
+  raw: Record<string, unknown>,
+  dtoClass: typeof CreatePromotionRequest | typeof UpdatePromotionRequest = CreatePromotionRequest,
+): Promise<string[]> => {
+  const instance = plainToInstance(dtoClass, raw, { excludeExtraneousValues: true });
+  return (await validate(instance as object)).map((error) => error.property);
+};
+
+describe('CreatePromotionRequest', () => {
+  it('valida con los obligatorios y tipa el nivel al enum', async () => {
+    const dto = plainToInstance(CreatePromotionRequest, base, { excludeExtraneousValues: true });
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.targetLevels).toEqual([CreditPlanLevelEnum.SILVER]);
+  });
+
+  it('rechaza una fecha que no es ISO 8601', async () => {
+    expect(await errorProperties({ ...base, validFrom: 'mañana' })).toContain('validFrom');
+    expect(await errorProperties({ ...base, validUntil: '31/12/2026' })).toContain('validUntil');
+    expect(await errorProperties({ ...base, validUntil: '' })).toContain('validUntil');
+  });
+
+  it('acepta la fecha desnuda y el instante completo', async () => {
+    expect(await errorProperties({ ...base, validUntil: '2026-12-31' })).toHaveLength(0);
+    expect(await errorProperties({ ...base, validFrom: '2026-12-31T10:00:00.000Z' })).toHaveLength(0);
+  });
+
+  it('acepta null en las fechas: es vigencia abierta, no una fecha inválida', async () => {
+    expect(await errorProperties({ ...base, validFrom: null, validUntil: null })).toHaveLength(0);
+  });
+
+  it('exige al menos un nivel', async () => {
+    expect(await errorProperties({ ...base, targetLevels: [] })).toContain('targetLevels');
+  });
+});
+
+describe('UpdatePromotionRequest', () => {
+  it('el parche vacío es válido', async () => {
+    expect(await errorProperties({}, UpdatePromotionRequest)).toHaveLength(0);
+  });
+
+  it('rechaza una fecha que no es ISO 8601', async () => {
+    expect(await errorProperties({ validUntil: 'el viernes' }, UpdatePromotionRequest)).toContain('validUntil');
+  });
+});

package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.d.ts

@@ -28,4 +28,12 @@ export declare class OriginateLoanCreditRequest {
     clientLevelAtOrigination?: ClientLevelEnum;
     /** IMEI del equipo si ya se conoce (también puede fijarse en el paso 09 vía activate-check). */
     imei?: string;
+    /**
+     * Tienda donde se vende. El motor la persiste y la reenvía al simulador del catálogo en cada
+     * cotización — al RE-cotizar el wizard no la vuelve a mandar, así que sin guardarla la venta
+     * perdería su promoción a mitad del paso 06.
+     */
+    storeId?: string;
+    /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
+    productSku?: string;
 }

package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.js

@@ -89,3 +89,15 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], OriginateLoanCreditRequest.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "productSku", void 0);

package/bin/loanOfferings/dtos/PromotionEffect.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Palanca que la promoción aplica sobre el plan de crédito. Al menos una clave debe venir presente
+ * (el lambda rechaza el efecto vacío con 422). Montos en **cents**; porcentajes y TNA en decimal,
+ * igual que `CreditPlan`.
+ */
+export interface PromotionEffect {
+    /** Delta NEGATIVO sobre el enganche mínimo del plan (`-0.20` = veinte puntos menos). */
+    downPaymentDeltaPct: number | null;
+    /** Bono que se abona a la tarjeta PCF al activar el crédito. */
+    pcfBonusCents: number | null;
+    /** TNA que reemplaza a la del plan, siempre hacia abajo (`1.80` = 180% en vez de 200%). */
+    tnaOverride: number | null;
+    /** Techo de monto financiable que reemplaza al del plan. */
+    maxAmountOverrideCents: number | null;
+}

package/bin/loanOfferings/dtos/PromotionEffect.js

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

package/bin/loanOfferings/dtos/requests/ChangePromotionStatusRequest.d.ts

@@ -0,0 +1,10 @@
+import { PromotionStatusEnum } from '../../enums/PromotionStatusEnum';
+/**
+ * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar o vencer.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * `reason` acompaña la pausa y queda en la bitácora.
+ */
+export declare class ChangePromotionStatusRequest {
+    status: PromotionStatusEnum;
+    reason?: string | null;
+}

package/bin/loanOfferings/dtos/requests/ChangePromotionStatusRequest.js

@@ -0,0 +1,34 @@
+"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.ChangePromotionStatusRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const PromotionStatusEnum_1 = require("../../enums/PromotionStatusEnum");
+/**
+ * Body de PUT /promotions/:promotionId/status — publicar, pausar, reanudar o vencer.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * `reason` acompaña la pausa y queda en la bitácora.
+ */
+class ChangePromotionStatusRequest {
+}
+exports.ChangePromotionStatusRequest = ChangePromotionStatusRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(PromotionStatusEnum_1.PromotionStatusEnum),
+    __metadata("design:type", String)
+], ChangePromotionStatusRequest.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ChangePromotionStatusRequest.prototype, "reason", void 0);

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.d.ts

@@ -0,0 +1,26 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionEffectInput } from './PromotionEffectInput';
+/**
+ * Body de POST /promotions — alta de una promoción del motor.
+ * Nace en `DRAFT`: el estado, `promotionId`, `version`, los contadores de consumo y la auditoría
+ * los asigna el lambda y NO viajan en el request. `budgetMaxCents` ausente/`null` = sin tope.
+ */
+export declare class CreatePromotionRequest {
+    name: string;
+    description: string;
+    effect: PromotionEffectInput;
+    /** Segmento de clientes al que apunta la promoción. */
+    segmentId: string;
+    targetLevels: CreditPlanLevelEnum[];
+    /** SKUs alcanzados; ausente o `null` = todos los productos. */
+    productSkus?: string[] | null;
+    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    storeIds?: string[] | null;
+    validFrom?: string | null;
+    validUntil?: string | null;
+    /**
+     * Tope de presupuesto en cents; `null` = sin tope. El signo lo valida el lambda (422): un
+     * presupuesto negativo es un request bien formado que el negocio rechaza.
+     */
+    budgetMaxCents?: number | null;
+}

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.js

@@ -0,0 +1,84 @@
+"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.CreatePromotionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const PromotionEffectInput_1 = require("./PromotionEffectInput");
+/**
+ * Body de POST /promotions — alta de una promoción del motor.
+ * Nace en `DRAFT`: el estado, `promotionId`, `version`, los contadores de consumo y la auditoría
+ * los asigna el lambda y NO viajan en el request. `budgetMaxCents` ausente/`null` = sin tope.
+ */
+class CreatePromotionRequest {
+}
+exports.CreatePromotionRequest = CreatePromotionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PromotionEffectInput_1.PromotionEffectInput),
+    __metadata("design:type", PromotionEffectInput_1.PromotionEffectInput)
+], CreatePromotionRequest.prototype, "effect", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "segmentId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "targetLevels", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "productSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "storeIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "validFrom", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CreatePromotionRequest.prototype, "budgetMaxCents", void 0);

package/bin/loanOfferings/dtos/requests/PromotionEffectInput.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Efecto de la promoción tal como viaja en el body (alta y edición). Acá se valida solo la FORMA
+ * (que sea número o entero). Las cotas de negocio — rango de cada palanca y que venga al menos una
+ * clave — las valida el lambda con 422: son reglas del negocio sobre un body bien formado.
+ */
+export declare class PromotionEffectInput {
+    /** Delta NEGATIVO sobre el enganche mínimo (`-0.20` = veinte puntos menos); rango [-1, 0]. */
+    downPaymentDeltaPct?: number | null;
+    /** Bono a la tarjeta PCF, en cents. */
+    pcfBonusCents?: number | null;
+    /** TNA que reemplaza a la del plan, hacia abajo (`1.80` = 180%); rango [0, 2.60]. */
+    tnaOverride?: number | null;
+    /** Techo de monto financiable que reemplaza al del plan, en cents. */
+    maxAmountOverrideCents?: number | null;
+}

package/bin/loanOfferings/dtos/requests/PromotionEffectInput.js

@@ -0,0 +1,46 @@
+"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.PromotionEffectInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Efecto de la promoción tal como viaja en el body (alta y edición). Acá se valida solo la FORMA
+ * (que sea número o entero). Las cotas de negocio — rango de cada palanca y que venga al menos una
+ * clave — las valida el lambda con 422: son reglas del negocio sobre un body bien formado.
+ */
+class PromotionEffectInput {
+}
+exports.PromotionEffectInput = PromotionEffectInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], PromotionEffectInput.prototype, "downPaymentDeltaPct", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PromotionEffectInput.prototype, "pcfBonusCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], PromotionEffectInput.prototype, "tnaOverride", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PromotionEffectInput.prototype, "maxAmountOverrideCents", void 0);

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.d.ts

@@ -2,10 +2,18 @@
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
  * decimal sobre 1. `customerSciScore` opcional: si viene, se valida contra el rango SCI del plan.
+ *
+ * `storeId` y `productSku` describen DÓNDE y QUÉ se está vendiendo: con ellos el simulador resuelve
+ * qué promoción aplica. Sin ellos, las promociones acotadas a una tienda o a un SKU quedan fuera —
+ * el simulador no adivina, y dar un beneficio que no corresponde es peor que no darlo.
  */
 export declare class SimulateCreditPlanRequest {
     productPriceCents: number;
     downPaymentPct: number;
     termWeeks: number;
     customerSciScore?: number;
+    /** Tienda donde se vende. Sin él no se resuelven las promociones acotadas por tienda. */
+    storeId?: string;
+    /** SKU del equipo. Sin él no se resuelven las promociones acotadas por producto. */
+    productSku?: string;
 }

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.js

@@ -16,6 +16,10 @@ const class_validator_1 = require("class-validator");
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
  * decimal sobre 1. `customerSciScore` opcional: si viene, se valida contra el rango SCI del plan.
+ *
+ * `storeId` y `productSku` describen DÓNDE y QUÉ se está vendiendo: con ellos el simulador resuelve
+ * qué promoción aplica. Sin ellos, las promociones acotadas a una tienda o a un SKU quedan fuera —
+ * el simulador no adivina, y dar un beneficio que no corresponde es peor que no darlo.
  */
 class SimulateCreditPlanRequest {
 }
@@ -47,3 +51,15 @@ __decorate([
     (0, class_validator_1.Max)(100),
     __metadata("design:type", Number)
 ], SimulateCreditPlanRequest.prototype, "customerSciScore", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "productSku", void 0);

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.d.ts

@@ -0,0 +1,20 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionEffectInput } from './PromotionEffectInput';
+/**
+ * Body de PUT /promotions/:promotionId — edición parcial (todos los campos opcionales).
+ * Solo se admite sobre `DRAFT` y `PUBLISHED`, y sube `version`. El cambio de estado va por su
+ * endpoint dedicado. `effect` se reemplaza entero cuando viene, no se mergea clave a clave.
+ */
+export declare class UpdatePromotionRequest {
+    name?: string;
+    description?: string;
+    effect?: PromotionEffectInput;
+    segmentId?: string;
+    targetLevels?: CreditPlanLevelEnum[];
+    productSkus?: string[] | null;
+    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    storeIds?: string[] | null;
+    validFrom?: string | null;
+    validUntil?: string | null;
+    budgetMaxCents?: number | null;
+}

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.js

@@ -0,0 +1,89 @@
+"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.UpdatePromotionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const PromotionEffectInput_1 = require("./PromotionEffectInput");
+/**
+ * Body de PUT /promotions/:promotionId — edición parcial (todos los campos opcionales).
+ * Solo se admite sobre `DRAFT` y `PUBLISHED`, y sube `version`. El cambio de estado va por su
+ * endpoint dedicado. `effect` se reemplaza entero cuando viene, no se mergea clave a clave.
+ */
+class UpdatePromotionRequest {
+}
+exports.UpdatePromotionRequest = UpdatePromotionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PromotionEffectInput_1.PromotionEffectInput),
+    __metadata("design:type", PromotionEffectInput_1.PromotionEffectInput)
+], UpdatePromotionRequest.prototype, "effect", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "segmentId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "targetLevels", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "productSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "storeIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "validFrom", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], UpdatePromotionRequest.prototype, "budgetMaxCents", void 0);

package/bin/loanOfferings/dtos/responses/PromotionLogEntryResponse.d.ts

@@ -0,0 +1,17 @@
+import { PromotionLogEventEnum } from '../../enums/PromotionLogEventEnum';
+import { PromotionStatusEnum } from '../../enums/PromotionStatusEnum';
+/**
+ * Fila del tab «Auditoría»: un evento de la bitácora de promociones.
+ * `fromStatus` es `null` en el alta; `reason` solo viene cargado en la pausa.
+ */
+export interface PromotionLogEntryResponse {
+    promotionId: string;
+    promotionName: string;
+    event: PromotionLogEventEnum;
+    occurredAt: string;
+    performedBy: string;
+    fromStatus: PromotionStatusEnum | null;
+    toStatus: PromotionStatusEnum | null;
+    reason: string | null;
+    version: number;
+}

package/bin/loanOfferings/dtos/responses/PromotionLogEntryResponse.js

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

package/bin/loanOfferings/dtos/responses/PromotionResponse.d.ts

@@ -0,0 +1,44 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
+import { PromotionPhaseEnum } from '../../enums/PromotionPhaseEnum';
+import { PromotionStatusEnum } from '../../enums/PromotionStatusEnum';
+import { PromotionEffect } from '../PromotionEffect';
+/**
+ * Shape de salida de una promoción (GET / POST / PUT de /promotions).
+ * Montos en cents; porcentajes y TNA en decimal.
+ *
+ * `effectKind` y `phase` son DERIVADOS y no viven en la tabla: el primero sale de las claves de
+ * `effect`, el segundo de las fechas contra hoy y solo cuando el estado es `PUBLISHED`.
+ */
+export interface PromotionResponse {
+    promotionId: string;
+    name: string;
+    description: string;
+    effect: PromotionEffect;
+    /** Derivado de las claves de `effect`; `COMBO` si hay dos o más, `null` si no hay ninguna. */
+    effectKind: PromotionEffectKindEnum | null;
+    segmentId: string;
+    targetLevels: CreditPlanLevelEnum[];
+    /** `null` = alcanza a todos los productos. */
+    productSkus: string[] | null;
+    /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
+    storeIds: string[] | null;
+    validFrom: string | null;
+    validUntil: string | null;
+    status: PromotionStatusEnum;
+    /** Fase de vigencia derivada; `null` cuando el estado no es `PUBLISHED`. */
+    phase: PromotionPhaseEnum | null;
+    /** Tope de presupuesto; `null` = sin tope. */
+    budgetMaxCents: number | null;
+    budgetConsumedCents: number;
+    creditsGenerated: number;
+    version: number;
+    pausedAt: string | null;
+    pauseReason: string | null;
+    publishedAt: string | null;
+    publishedBy: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/loanOfferings/dtos/responses/PromotionResponse.js

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

package/bin/loanOfferings/dtos/responses/SimulationResultResponse.d.ts

@@ -1,3 +1,4 @@
+import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 /**
  * Un renglón de la tabla de amortización (M2 §3.3). Todos los montos en cents.
  */
@@ -13,6 +14,18 @@ export interface AmortizationRowResponse {
     /** Saldo insoluto de capital tras aplicar la cuota. */
     remainingBalanceCents: number;
 }
+/**
+ * Promoción que el simulador aplicó a esta cotización. Sin este bloque la cuota cambia y nadie
+ * puede explicar por qué: es lo que hace auditable la regla de que gana una sola promoción.
+ */
+export interface AppliedPromotionResponse {
+    promotionId: string;
+    name: string;
+    /** Versión de la promoción al cotizar — el operador la edita y sube. */
+    version: number;
+    /** Palancas del plan que la promoción pisó. */
+    appliedEffects: PromotionEffectKindEnum[];
+}
 /**
  * Resultado del simulador de cuota (POST /private/credit-plans/:planId/simulate,
  * GET /credit-plans/:planId/simulator). Amortización francesa + IVA 16% + comisión de apertura + CAT.
@@ -41,4 +54,9 @@ export interface SimulationResultResponse {
     /** Costo Anual Total (decimal, ej. 2.87 = 287%). Metodología estándar CONDUSEF (supuesto). */
     catAnnual: number;
     schedule: AmortizationRowResponse[];
+    /**
+     * Promoción aplicada, o `null` si ninguna alcanzaba a esta venta. Los montos de arriba YA la
+     * incluyen: es el porqué de la cuota, no un extra a sumar.
+     */
+    appliedPromotion: AppliedPromotionResponse | null;
 }

package/bin/loanOfferings/enums/PromotionEffectKindEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Naturaleza del efecto de una promoción, DERIVADA de las claves presentes en `effect`.
+ * `COMBO` cuando hay dos o más claves. No se persiste: se calcula al responder.
+ * @enum {string}
+ */
+export declare enum PromotionEffectKindEnum {
+    DOWN_PAYMENT_DELTA = "DOWN_PAYMENT_DELTA",
+    PCF_BONUS = "PCF_BONUS",
+    TNA_OVERRIDE = "TNA_OVERRIDE",
+    MAX_AMOUNT_OVERRIDE = "MAX_AMOUNT_OVERRIDE",
+    COMBO = "COMBO"
+}

package/bin/loanOfferings/enums/PromotionEffectKindEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionEffectKindEnum = void 0;
+/**
+ * Naturaleza del efecto de una promoción, DERIVADA de las claves presentes en `effect`.
+ * `COMBO` cuando hay dos o más claves. No se persiste: se calcula al responder.
+ * @enum {string}
+ */
+var PromotionEffectKindEnum;
+(function (PromotionEffectKindEnum) {
+    PromotionEffectKindEnum["DOWN_PAYMENT_DELTA"] = "DOWN_PAYMENT_DELTA";
+    PromotionEffectKindEnum["PCF_BONUS"] = "PCF_BONUS";
+    PromotionEffectKindEnum["TNA_OVERRIDE"] = "TNA_OVERRIDE";
+    PromotionEffectKindEnum["MAX_AMOUNT_OVERRIDE"] = "MAX_AMOUNT_OVERRIDE";
+    PromotionEffectKindEnum["COMBO"] = "COMBO";
+})(PromotionEffectKindEnum || (exports.PromotionEffectKindEnum = PromotionEffectKindEnum = {}));

package/bin/loanOfferings/enums/PromotionLogEventEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Evento de la bitácora de promociones (`<T>LoanPromotionLog_GT`), que alimenta el tab «Auditoría».
+ * @enum {string}
+ */
+export declare enum PromotionLogEventEnum {
+    CREATE = "CREATE",
+    PUBLISH = "PUBLISH",
+    PAUSE = "PAUSE",
+    RESUME = "RESUME",
+    EXPIRE = "EXPIRE",
+    UPDATE = "UPDATE"
+}