@fiado/type-kit 3.363.0 → 3.364.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/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 {
+    /** Puntos de enganche que se restan al mínimo del plan (decimal sobre 1: `0.05` = 5 puntos). */
+    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 (decimal: `2.10` = 210%). */
+    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,24 @@
+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;
+    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,77 @@
+"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.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 {
+    /** Puntos de enganche a restar del mínimo del plan (decimal sobre 1). */
+    downPaymentDeltaPct?: number | null;
+    /** Bono a la tarjeta PCF, en cents. */
+    pcfBonusCents?: number | null;
+    /** TNA que reemplaza a la del plan (decimal); rango de negocio [2.00, 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/UpdatePromotionRequest.d.ts

@@ -0,0 +1,18 @@
+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;
+    validFrom?: string | null;
+    validUntil?: string | null;
+    budgetMaxCents?: number | null;
+}

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

@@ -0,0 +1,82 @@
+"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.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,42 @@
+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;
+    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/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"
+}

package/bin/loanOfferings/enums/PromotionLogEventEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionLogEventEnum = void 0;
+/**
+ * Evento de la bitácora de promociones (`<T>LoanPromotionLog_GT`), que alimenta el tab «Auditoría».
+ * @enum {string}
+ */
+var PromotionLogEventEnum;
+(function (PromotionLogEventEnum) {
+    PromotionLogEventEnum["CREATE"] = "CREATE";
+    PromotionLogEventEnum["PUBLISH"] = "PUBLISH";
+    PromotionLogEventEnum["PAUSE"] = "PAUSE";
+    PromotionLogEventEnum["RESUME"] = "RESUME";
+    PromotionLogEventEnum["EXPIRE"] = "EXPIRE";
+    PromotionLogEventEnum["UPDATE"] = "UPDATE";
+})(PromotionLogEventEnum || (exports.PromotionLogEventEnum = PromotionLogEventEnum = {}));

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

@@ -0,0 +1,11 @@
+/**
+ * Fase de vigencia de una promoción PUBLICADA, derivada de `validFrom`/`validUntil` contra hoy.
+ * No se persiste — así no hace falta un cron que mueva estados a medianoche. `null` cuando el
+ * estado persistido no es `PUBLISHED`.
+ * @enum {string}
+ */
+export declare enum PromotionPhaseEnum {
+    SCHEDULED = "SCHEDULED",
+    ACTIVE = "ACTIVE",
+    EXPIRED = "EXPIRED"
+}

package/bin/loanOfferings/enums/PromotionPhaseEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionPhaseEnum = void 0;
+/**
+ * Fase de vigencia de una promoción PUBLICADA, derivada de `validFrom`/`validUntil` contra hoy.
+ * No se persiste — así no hace falta un cron que mueva estados a medianoche. `null` cuando el
+ * estado persistido no es `PUBLISHED`.
+ * @enum {string}
+ */
+var PromotionPhaseEnum;
+(function (PromotionPhaseEnum) {
+    PromotionPhaseEnum["SCHEDULED"] = "SCHEDULED";
+    PromotionPhaseEnum["ACTIVE"] = "ACTIVE";
+    PromotionPhaseEnum["EXPIRED"] = "EXPIRED";
+})(PromotionPhaseEnum || (exports.PromotionPhaseEnum = PromotionPhaseEnum = {}));

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

@@ -0,0 +1,12 @@
+/**
+ * Estado PERSISTIDO de una promoción del motor (portal-admin-sk-promociones).
+ * `EXPIRED` es terminal. La «fase» que ve el operador (programada / activa / vencida) NO se guarda:
+ * se deriva de las fechas — ver `PromotionPhaseEnum`.
+ * @enum {string}
+ */
+export declare enum PromotionStatusEnum {
+    DRAFT = "DRAFT",
+    PUBLISHED = "PUBLISHED",
+    PAUSED = "PAUSED",
+    EXPIRED = "EXPIRED"
+}

package/bin/loanOfferings/enums/PromotionStatusEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionStatusEnum = void 0;
+/**
+ * Estado PERSISTIDO de una promoción del motor (portal-admin-sk-promociones).
+ * `EXPIRED` es terminal. La «fase» que ve el operador (programada / activa / vencida) NO se guarda:
+ * se deriva de las fechas — ver `PromotionPhaseEnum`.
+ * @enum {string}
+ */
+var PromotionStatusEnum;
+(function (PromotionStatusEnum) {
+    PromotionStatusEnum["DRAFT"] = "DRAFT";
+    PromotionStatusEnum["PUBLISHED"] = "PUBLISHED";
+    PromotionStatusEnum["PAUSED"] = "PAUSED";
+    PromotionStatusEnum["EXPIRED"] = "EXPIRED";
+})(PromotionStatusEnum || (exports.PromotionStatusEnum = PromotionStatusEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -4,9 +4,14 @@ export * from './enums/ProductTierEnum';
 export * from './enums/CreditPlanStatusEnum';
 export * from './enums/FinancierTypeEnum';
 export * from './enums/FinancierStatusEnum';
+export * from './enums/PromotionStatusEnum';
+export * from './enums/PromotionEffectKindEnum';
+export * from './enums/PromotionPhaseEnum';
+export * from './enums/PromotionLogEventEnum';
 export * from './dtos/CreditPlan';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
+export * from './dtos/PromotionEffect';
 export * from './dtos/requests/CreateCreditPlanRequest';
 export * from './dtos/requests/UpdateCreditPlanRequest';
 export * from './dtos/requests/ChangeCreditPlanStatusRequest';
@@ -15,7 +20,13 @@ export * from './dtos/requests/CreateFinancierRequest';
 export * from './dtos/requests/UpdateFinancierRequest';
 export * from './dtos/requests/ChangeFinancierStatusRequest';
 export * from './dtos/requests/ReorderFinancierRequest';
+export * from './dtos/requests/PromotionEffectInput';
+export * from './dtos/requests/CreatePromotionRequest';
+export * from './dtos/requests/UpdatePromotionRequest';
+export * from './dtos/requests/ChangePromotionStatusRequest';
 export * from './dtos/responses/CreditPlanResponse';
 export * from './dtos/responses/FinancierResponse';
 export * from './dtos/responses/RetailerCreditPlanResponse';
 export * from './dtos/responses/SimulationResultResponse';
+export * from './dtos/responses/PromotionResponse';
+export * from './dtos/responses/PromotionLogEntryResponse';

package/bin/loanOfferings/index.js

@@ -21,10 +21,15 @@ __exportStar(require("./enums/ProductTierEnum"), exports);
 __exportStar(require("./enums/CreditPlanStatusEnum"), exports);
 __exportStar(require("./enums/FinancierTypeEnum"), exports);
 __exportStar(require("./enums/FinancierStatusEnum"), exports);
+__exportStar(require("./enums/PromotionStatusEnum"), exports);
+__exportStar(require("./enums/PromotionEffectKindEnum"), exports);
+__exportStar(require("./enums/PromotionPhaseEnum"), exports);
+__exportStar(require("./enums/PromotionLogEventEnum"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/Financier"), exports);
 __exportStar(require("./dtos/RetailerCreditPlan"), exports);
+__exportStar(require("./dtos/PromotionEffect"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/CreateCreditPlanRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateCreditPlanRequest"), exports);
@@ -34,8 +39,14 @@ __exportStar(require("./dtos/requests/CreateFinancierRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateFinancierRequest"), exports);
 __exportStar(require("./dtos/requests/ChangeFinancierStatusRequest"), exports);
 __exportStar(require("./dtos/requests/ReorderFinancierRequest"), exports);
+__exportStar(require("./dtos/requests/PromotionEffectInput"), exports);
+__exportStar(require("./dtos/requests/CreatePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/UpdatePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/ChangePromotionStatusRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/FinancierResponse"), exports);
 __exportStar(require("./dtos/responses/RetailerCreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/SimulationResultResponse"), exports);
+__exportStar(require("./dtos/responses/PromotionResponse"), exports);
+__exportStar(require("./dtos/responses/PromotionLogEntryResponse"), exports);

package/bin/retailCustomer/dtos/responses/Customer360Response.d.ts

@@ -1,9 +1,26 @@
+import { Status } from '../../../card/enums/Status';
+import { VirtualOrPhysical } from '../../../card/enums/VirtualOrPhysical';
 import { CustomerResponse } from './CustomerResponse';
 /** Resumen de wallet (nivel N1/N2 + saldo) para el Cliente 360. */
 export interface Customer360Wallet {
     accountLevel: 1 | 2 | null;
     clabe: string | null;
-    balanceCents: number;
+    /**
+     * Saldo en centavos, o `null` cuando la fuente no lo trajo. Era `number` a secas y eso obligaba
+     * a mandar `0` por un bloque ilegible, indistinguible de un saldo cero real.
+     */
+    balanceCents: number | null;
+}
+/**
+ * Tarjeta del cliente para el Cliente 360. Los campos espejan lo que devuelve `CardResponse` de
+ * `fiado-card-business`; `issued` en `false` deja los demás en `null` (no hay tarjeta que describir).
+ */
+export interface Customer360Card {
+    issued: boolean;
+    /** Últimos dígitos del PAN, tal como los nombra `CardResponse.panLastDigit`. */
+    panLastDigit: string | null;
+    status: Status | null;
+    virtualOrPhysical: VirtualOrPhysical | null;
 }
 /** Ítem de compra en el historial del Cliente 360 (del GSI customerId-soldAt). */
 export interface Customer360Purchase {
@@ -28,6 +45,8 @@ export interface Customer360Prospect {
 export interface Customer360Response {
     customer: CustomerResponse;
     wallet: Customer360Wallet;
+    /** Tarjeta del cliente. Opcional: los consumidores que no la piden siguen compilando igual. */
+    card?: Customer360Card;
     purchases: Customer360Purchase[];
     prospects: Customer360Prospect[];
 }

package/bin/retailCustomer/dtos/responses/CustomerResponse.d.ts

@@ -1,3 +1,4 @@
+import { KycReview } from '../KycReview';
 import { RetailAddress } from '../RetailAddress';
 import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
 import { KycModalityEnum } from '../../enums/KycModalityEnum';
@@ -44,6 +45,11 @@ export interface CustomerResponse {
     kycStatus: RetailKycStatusEnum;
     kycModality: KycModalityEnum | null;
     kycScore: number | null;
+    /**
+     * Veredicto manual del oficial de Cumplimiento (D21), ya persistido en el cliente. Ausente
+     * mientras nadie resolvió el KYC a mano — opcional para no romper a los consumidores actuales.
+     */
+    kycReview?: KycReview;
     metamapVerificationId: string | null;
     pldFlag: boolean;
     notes: string | null;

package/package.json

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

package/src/loanOfferings/dtos/PromotionEffect.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 {
+    /** Puntos de enganche que se restan al mínimo del plan (decimal sobre 1: `0.05` = 5 puntos). */
+    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 (decimal: `2.10` = 210%). */
+    tnaOverride: number | null;
+    /** Techo de monto financiable que reemplaza al del plan. */
+    maxAmountOverrideCents: number | null;
+}

package/src/loanOfferings/dtos/requests/ChangePromotionStatusRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+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 class ChangePromotionStatusRequest {
+    @Expose()
+    @IsEnum(PromotionStatusEnum)
+    status!: PromotionStatusEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    reason?: string | null;
+}

package/src/loanOfferings/dtos/requests/CreatePromotionRequest.ts

@@ -0,0 +1,70 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsOptional,
+    IsString,
+    ValidateNested,
+} from 'class-validator';
+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 class CreatePromotionRequest {
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    description!: string;
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => PromotionEffectInput)
+    effect!: PromotionEffectInput;
+
+    /** Segmento de clientes al que apunta la promoción. */
+    @Expose()
+    @IsString()
+    segmentId!: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(CreditPlanLevelEnum, { each: true })
+    targetLevels!: CreditPlanLevelEnum[];
+
+    /** SKUs alcanzados; ausente o `null` = todos los productos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    productSkus?: string[] | null;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validFrom?: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    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.
+     */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    budgetMaxCents?: number | null;
+}

package/src/loanOfferings/dtos/requests/PromotionEffectInput.ts

@@ -0,0 +1,33 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNumber, IsOptional } from '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.
+ */
+export class PromotionEffectInput {
+    /** Puntos de enganche a restar del mínimo del plan (decimal sobre 1). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    downPaymentDeltaPct?: number | null;
+
+    /** Bono a la tarjeta PCF, en cents. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    pcfBonusCents?: number | null;
+
+    /** TNA que reemplaza a la del plan (decimal); rango de negocio [2.00, 2.60]. */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    tnaOverride?: number | null;
+
+    /** Techo de monto financiable que reemplaza al del plan, en cents. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    maxAmountOverrideCents?: number | null;
+}

package/src/loanOfferings/dtos/requests/UpdatePromotionRequest.ts

@@ -0,0 +1,69 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsOptional,
+    IsString,
+    ValidateNested,
+} from 'class-validator';
+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 class UpdatePromotionRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    name?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    description?: string;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PromotionEffectInput)
+    effect?: PromotionEffectInput;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    segmentId?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(CreditPlanLevelEnum, { each: true })
+    targetLevels?: CreditPlanLevelEnum[];
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    productSkus?: string[] | null;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validFrom?: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validUntil?: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    budgetMaxCents?: number | null;
+}

package/src/loanOfferings/dtos/responses/PromotionLogEntryResponse.ts

@@ -0,0 +1,18 @@
+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/src/loanOfferings/dtos/responses/PromotionResponse.ts

@@ -0,0 +1,43 @@
+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;
+    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/src/loanOfferings/enums/PromotionEffectKindEnum.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 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/src/loanOfferings/enums/PromotionLogEventEnum.ts

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

package/src/loanOfferings/enums/PromotionPhaseEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Fase de vigencia de una promoción PUBLICADA, derivada de `validFrom`/`validUntil` contra hoy.
+ * No se persiste — así no hace falta un cron que mueva estados a medianoche. `null` cuando el
+ * estado persistido no es `PUBLISHED`.
+ * @enum {string}
+ */
+export enum PromotionPhaseEnum {
+    SCHEDULED = 'SCHEDULED',
+    ACTIVE = 'ACTIVE',
+    EXPIRED = 'EXPIRED',
+}

package/src/loanOfferings/enums/PromotionStatusEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Estado PERSISTIDO de una promoción del motor (portal-admin-sk-promociones).
+ * `EXPIRED` es terminal. La «fase» que ve el operador (programada / activa / vencida) NO se guarda:
+ * se deriva de las fechas — ver `PromotionPhaseEnum`.
+ * @enum {string}
+ */
+export enum PromotionStatusEnum {
+    DRAFT = 'DRAFT',
+    PUBLISHED = 'PUBLISHED',
+    PAUSED = 'PAUSED',
+    EXPIRED = 'EXPIRED',
+}

package/src/loanOfferings/index.ts

@@ -5,11 +5,16 @@ export * from './enums/ProductTierEnum';
 export * from './enums/CreditPlanStatusEnum';
 export * from './enums/FinancierTypeEnum';
 export * from './enums/FinancierStatusEnum';
+export * from './enums/PromotionStatusEnum';
+export * from './enums/PromotionEffectKindEnum';
+export * from './enums/PromotionPhaseEnum';
+export * from './enums/PromotionLogEventEnum';
 
 // Entity DTOs
 export * from './dtos/CreditPlan';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
+export * from './dtos/PromotionEffect';
 
 // Request DTOs
 export * from './dtos/requests/CreateCreditPlanRequest';
@@ -20,9 +25,15 @@ export * from './dtos/requests/CreateFinancierRequest';
 export * from './dtos/requests/UpdateFinancierRequest';
 export * from './dtos/requests/ChangeFinancierStatusRequest';
 export * from './dtos/requests/ReorderFinancierRequest';
+export * from './dtos/requests/PromotionEffectInput';
+export * from './dtos/requests/CreatePromotionRequest';
+export * from './dtos/requests/UpdatePromotionRequest';
+export * from './dtos/requests/ChangePromotionStatusRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';
 export * from './dtos/responses/FinancierResponse';
 export * from './dtos/responses/RetailerCreditPlanResponse';
 export * from './dtos/responses/SimulationResultResponse';
+export * from './dtos/responses/PromotionResponse';
+export * from './dtos/responses/PromotionLogEntryResponse';

package/src/retailCustomer/dtos/responses/Customer360Response.ts

@@ -1,10 +1,28 @@
+import { Status } from '../../../card/enums/Status';
+import { VirtualOrPhysical } from '../../../card/enums/VirtualOrPhysical';
 import { CustomerResponse } from './CustomerResponse';
 
 /** Resumen de wallet (nivel N1/N2 + saldo) para el Cliente 360. */
 export interface Customer360Wallet {
     accountLevel: 1 | 2 | null;
     clabe: string | null;
-    balanceCents: number;
+    /**
+     * Saldo en centavos, o `null` cuando la fuente no lo trajo. Era `number` a secas y eso obligaba
+     * a mandar `0` por un bloque ilegible, indistinguible de un saldo cero real.
+     */
+    balanceCents: number | null;
+}
+
+/**
+ * Tarjeta del cliente para el Cliente 360. Los campos espejan lo que devuelve `CardResponse` de
+ * `fiado-card-business`; `issued` en `false` deja los demás en `null` (no hay tarjeta que describir).
+ */
+export interface Customer360Card {
+    issued: boolean;
+    /** Últimos dígitos del PAN, tal como los nombra `CardResponse.panLastDigit`. */
+    panLastDigit: string | null;
+    status: Status | null;
+    virtualOrPhysical: VirtualOrPhysical | null;
 }
 
 /** Ítem de compra en el historial del Cliente 360 (del GSI customerId-soldAt). */
@@ -32,6 +50,8 @@ export interface Customer360Prospect {
 export interface Customer360Response {
     customer: CustomerResponse;
     wallet: Customer360Wallet;
+    /** Tarjeta del cliente. Opcional: los consumidores que no la piden siguen compilando igual. */
+    card?: Customer360Card;
     purchases: Customer360Purchase[];
     prospects: Customer360Prospect[];
 }

package/src/retailCustomer/dtos/responses/CustomerResponse.ts

@@ -1,3 +1,4 @@
+import { KycReview } from '../KycReview';
 import { RetailAddress } from '../RetailAddress';
 import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
 import { KycModalityEnum } from '../../enums/KycModalityEnum';
@@ -45,6 +46,11 @@ export interface CustomerResponse {
     kycStatus: RetailKycStatusEnum;
     kycModality: KycModalityEnum | null;
     kycScore: number | null;
+    /**
+     * Veredicto manual del oficial de Cumplimiento (D21), ya persistido en el cliente. Ausente
+     * mientras nadie resolvió el KYC a mano — opcional para no romper a los consumidores actuales.
+     */
+    kycReview?: KycReview;
     metamapVerificationId: string | null;
     pldFlag: boolean;
     notes: string | null;