@fiado/type-kit 3.185.0 → 3.186.0

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

@@ -0,0 +1,44 @@
+/**
+ * Un renglón de la tabla de amortización (M2 §3.3). Todos los montos en cents.
+ */
+export interface AmortizationRowResponse {
+    /** Número de cuota semanal (1-based). */
+    week: number;
+    capitalCents: number;
+    interestCents: number;
+    /** IVA 16% sobre el interés de la cuota. */
+    ivaCents: number;
+    /** capital + interés + IVA de la cuota. */
+    totalPaymentCents: number;
+    /** Saldo insoluto de capital tras aplicar la cuota. */
+    remainingBalanceCents: number;
+}
+/**
+ * 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.
+ *
+ * NOTA (supuesto F1): `catAnnual` se calcula con la metodología estándar CONDUSEF (TIR anualizada)
+ * — pendiente de confirmar fórmula/ejemplos oficiales con Jaime/M2.
+ */
+export interface SimulationResultResponse {
+    planId: string;
+    planCode: string;
+    productPriceCents: number;
+    downPaymentPct: number;
+    downPaymentCents: number;
+    /** Capital financiado = precio − enganche (antes de comisión de apertura). */
+    financedAmountCents: number;
+    openingCommissionCents: number;
+    termWeeks: number;
+    tnaAnnual: number;
+    /** Cuota semanal sin IVA (capital + interés), constante en amortización francesa. */
+    weeklyPaymentSinIvaCents: number;
+    totalCapitalCents: number;
+    totalInterestCents: number;
+    totalIvaCents: number;
+    /** Total a pagar = capital + interés + IVA (+ comisión de apertura). */
+    totalToPayCents: number;
+    /** Costo Anual Total (decimal, ej. 2.87 = 287%). Metodología estándar CONDUSEF (supuesto). */
+    catAnnual: number;
+    schedule: AmortizationRowResponse[];
+}

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Nivel de cliente al que aplica un plan de crédito SureKeep (M6 §4/§5 · modelo-datos §6.1).
+ * `ALL` = plan que aplica a todos los niveles (Jaime modela EMPLEADO como tipo de venta
+ * con nivel "todos", no como un nivel propio — corrección 2026-07-10).
+ * @enum {string}
+ */
+export declare enum CreditPlanLevelEnum {
+    BRONZE = "BRONZE",
+    SILVER = "SILVER",
+    GOLD = "GOLD",
+    ALL = "ALL"
+}

package/bin/loanOfferings/enums/CreditPlanLevelEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditPlanLevelEnum = void 0;
+/**
+ * Nivel de cliente al que aplica un plan de crédito SureKeep (M6 §4/§5 · modelo-datos §6.1).
+ * `ALL` = plan que aplica a todos los niveles (Jaime modela EMPLEADO como tipo de venta
+ * con nivel "todos", no como un nivel propio — corrección 2026-07-10).
+ * @enum {string}
+ */
+var CreditPlanLevelEnum;
+(function (CreditPlanLevelEnum) {
+    CreditPlanLevelEnum["BRONZE"] = "BRONZE";
+    CreditPlanLevelEnum["SILVER"] = "SILVER";
+    CreditPlanLevelEnum["GOLD"] = "GOLD";
+    CreditPlanLevelEnum["ALL"] = "ALL";
+})(CreditPlanLevelEnum || (exports.CreditPlanLevelEnum = CreditPlanLevelEnum = {}));

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

@@ -0,0 +1,8 @@
+/**
+ * Estado de un plan de crédito (modelo-datos §6.1). Soft-delete vía status (nunca DELETE físico).
+ * @enum {string}
+ */
+export declare enum CreditPlanStatusEnum {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE"
+}

package/bin/loanOfferings/enums/CreditPlanStatusEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditPlanStatusEnum = void 0;
+/**
+ * Estado de un plan de crédito (modelo-datos §6.1). Soft-delete vía status (nunca DELETE físico).
+ * @enum {string}
+ */
+var CreditPlanStatusEnum;
+(function (CreditPlanStatusEnum) {
+    CreditPlanStatusEnum["ACTIVE"] = "ACTIVE";
+    CreditPlanStatusEnum["INACTIVE"] = "INACTIVE";
+})(CreditPlanStatusEnum || (exports.CreditPlanStatusEnum = CreditPlanStatusEnum = {}));

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

@@ -0,0 +1,9 @@
+/**
+ * Estado de una financiera (modelo-datos §6.3). Desactivar la quita del wizard sin afectar
+ * créditos existentes (M6 §6).
+ * @enum {string}
+ */
+export declare enum FinancierStatusEnum {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE"
+}

package/bin/loanOfferings/enums/FinancierStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FinancierStatusEnum = void 0;
+/**
+ * Estado de una financiera (modelo-datos §6.3). Desactivar la quita del wizard sin afectar
+ * créditos existentes (M6 §6).
+ * @enum {string}
+ */
+var FinancierStatusEnum;
+(function (FinancierStatusEnum) {
+    FinancierStatusEnum["ACTIVE"] = "ACTIVE";
+    FinancierStatusEnum["INACTIVE"] = "INACTIVE";
+})(FinancierStatusEnum || (exports.FinancierStatusEnum = FinancierStatusEnum = {}));

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

@@ -0,0 +1,9 @@
+/**
+ * Tipo de financiera (M6 §6 · modelo-datos §6.3). `INTERNAL` = SureKeep (SOFOM propia);
+ * `EXTERNAL` = financiera de terceros con derivación por URL (PayJoy / KREDIYA / LESPAGO).
+ * @enum {string}
+ */
+export declare enum FinancierTypeEnum {
+    INTERNAL = "INTERNAL",
+    EXTERNAL = "EXTERNAL"
+}

package/bin/loanOfferings/enums/FinancierTypeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FinancierTypeEnum = void 0;
+/**
+ * Tipo de financiera (M6 §6 · modelo-datos §6.3). `INTERNAL` = SureKeep (SOFOM propia);
+ * `EXTERNAL` = financiera de terceros con derivación por URL (PayJoy / KREDIYA / LESPAGO).
+ * @enum {string}
+ */
+var FinancierTypeEnum;
+(function (FinancierTypeEnum) {
+    FinancierTypeEnum["INTERNAL"] = "INTERNAL";
+    FinancierTypeEnum["EXTERNAL"] = "EXTERNAL";
+})(FinancierTypeEnum || (exports.FinancierTypeEnum = FinancierTypeEnum = {}));

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

@@ -0,0 +1,15 @@
+/**
+ * Gama del equipo (modelo-datos §4.1 `RetailProduct.tier` · §6.1 `eligibleTiers`).
+ *
+ * NOTA (supuesto F1): conceptualmente esta gama pertenece al dominio de catálogo retail
+ * (`retail-catalog-business`), cuyo dominio type-kit aún no existe. Se define aquí para poder
+ * tipar `CreditPlan.eligibleTiers` y `Financier.eligibleTiers` sin bloquear. Al publicarse el
+ * dominio `retailCatalog`, consolidar allí y reexportar (coordinar con la pista Retail).
+ * @enum {string}
+ */
+export declare enum ProductTierEnum {
+    LOW = "LOW",
+    MID = "MID",
+    HIGH = "HIGH",
+    PREMIUM = "PREMIUM"
+}

package/bin/loanOfferings/enums/ProductTierEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductTierEnum = void 0;
+/**
+ * Gama del equipo (modelo-datos §4.1 `RetailProduct.tier` · §6.1 `eligibleTiers`).
+ *
+ * NOTA (supuesto F1): conceptualmente esta gama pertenece al dominio de catálogo retail
+ * (`retail-catalog-business`), cuyo dominio type-kit aún no existe. Se define aquí para poder
+ * tipar `CreditPlan.eligibleTiers` y `Financier.eligibleTiers` sin bloquear. Al publicarse el
+ * dominio `retailCatalog`, consolidar allí y reexportar (coordinar con la pista Retail).
+ * @enum {string}
+ */
+var ProductTierEnum;
+(function (ProductTierEnum) {
+    ProductTierEnum["LOW"] = "LOW";
+    ProductTierEnum["MID"] = "MID";
+    ProductTierEnum["HIGH"] = "HIGH";
+    ProductTierEnum["PREMIUM"] = "PREMIUM";
+})(ProductTierEnum || (exports.ProductTierEnum = ProductTierEnum = {}));

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

@@ -0,0 +1,13 @@
+/**
+ * Tipo de venta al que aplica un plan de crédito (M6 §4 · modelo-datos §6.1).
+ * Un plan puede configurarse para uno o más tipos (por eso `CreditPlan.saleTypes` es array).
+ * @enum {string}
+ */
+export declare enum SaleTypeEnum {
+    /** Cliente sin historial previo con SureKeep (primera compra). */
+    NEW = "NEW",
+    /** Cliente que ya tuvo un crédito con SureKeep (recompra / renovación). */
+    REPURCHASE = "REPURCHASE",
+    /** Empleado de VentasLuga que compra para uso personal (condiciones preferenciales). */
+    EMPLOYEE = "EMPLOYEE"
+}

package/bin/loanOfferings/enums/SaleTypeEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleTypeEnum = void 0;
+/**
+ * Tipo de venta al que aplica un plan de crédito (M6 §4 · modelo-datos §6.1).
+ * Un plan puede configurarse para uno o más tipos (por eso `CreditPlan.saleTypes` es array).
+ * @enum {string}
+ */
+var SaleTypeEnum;
+(function (SaleTypeEnum) {
+    /** Cliente sin historial previo con SureKeep (primera compra). */
+    SaleTypeEnum["NEW"] = "NEW";
+    /** Cliente que ya tuvo un crédito con SureKeep (recompra / renovación). */
+    SaleTypeEnum["REPURCHASE"] = "REPURCHASE";
+    /** Empleado de VentasLuga que compra para uso personal (condiciones preferenciales). */
+    SaleTypeEnum["EMPLOYEE"] = "EMPLOYEE";
+})(SaleTypeEnum || (exports.SaleTypeEnum = SaleTypeEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -0,0 +1,21 @@
+export * from './enums/CreditPlanLevelEnum';
+export * from './enums/SaleTypeEnum';
+export * from './enums/ProductTierEnum';
+export * from './enums/CreditPlanStatusEnum';
+export * from './enums/FinancierTypeEnum';
+export * from './enums/FinancierStatusEnum';
+export * from './dtos/CreditPlan';
+export * from './dtos/Financier';
+export * from './dtos/RetailerCreditPlan';
+export * from './dtos/requests/CreateCreditPlanRequest';
+export * from './dtos/requests/UpdateCreditPlanRequest';
+export * from './dtos/requests/ChangeCreditPlanStatusRequest';
+export * from './dtos/requests/SimulateCreditPlanRequest';
+export * from './dtos/requests/CreateFinancierRequest';
+export * from './dtos/requests/UpdateFinancierRequest';
+export * from './dtos/requests/ChangeFinancierStatusRequest';
+export * from './dtos/requests/ReorderFinancierRequest';
+export * from './dtos/responses/CreditPlanResponse';
+export * from './dtos/responses/FinancierResponse';
+export * from './dtos/responses/RetailerCreditPlanResponse';
+export * from './dtos/responses/SimulationResultResponse';

package/bin/loanOfferings/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums/CreditPlanLevelEnum"), exports);
+__exportStar(require("./enums/SaleTypeEnum"), exports);
+__exportStar(require("./enums/ProductTierEnum"), exports);
+__exportStar(require("./enums/CreditPlanStatusEnum"), exports);
+__exportStar(require("./enums/FinancierTypeEnum"), exports);
+__exportStar(require("./enums/FinancierStatusEnum"), exports);
+// Entity DTOs
+__exportStar(require("./dtos/CreditPlan"), exports);
+__exportStar(require("./dtos/Financier"), exports);
+__exportStar(require("./dtos/RetailerCreditPlan"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/CreateCreditPlanRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateCreditPlanRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeCreditPlanStatusRequest"), exports);
+__exportStar(require("./dtos/requests/SimulateCreditPlanRequest"), exports);
+__exportStar(require("./dtos/requests/CreateFinancierRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateFinancierRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeFinancierStatusRequest"), exports);
+__exportStar(require("./dtos/requests/ReorderFinancierRequest"), 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);

package/package.json

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

package/src/index.ts

@@ -105,5 +105,8 @@ export * as EmailVerification from './emailVerification';
 export * as RetailOrg from './retailOrg';
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 export * as LoanConfig from './loanConfig';
+// LoanOfferings: DTOs/enums del lambda loan-offerings-business (comp 07 — planes de crédito,
+// financieras, M:N retailer↔plan y simulador de cuota; SureKeep Fase 1 — pista Loan).
+export * as LoanOfferings from './loanOfferings';
 export * from './messaging';
 export * from './complaint';

package/src/loanOfferings/dtos/CreditPlan.ts

@@ -0,0 +1,171 @@
+import { Expose } from 'class-transformer';
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Matches,
+    Max,
+    Min,
+} from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { CreditPlanLevelEnum } from '../enums/CreditPlanLevelEnum';
+import { CreditPlanStatusEnum } from '../enums/CreditPlanStatusEnum';
+import { ProductTierEnum } from '../enums/ProductTierEnum';
+import { SaleTypeEnum } from '../enums/SaleTypeEnum';
+
+/**
+ * CreditPlan — plan de crédito del catálogo SOFOM SureKeep (modelo-datos §6.1 · M6 §4).
+ * Entidad completa del dominio `loan-offerings-business` (SureKeep Fase 1 — pista Loan).
+ *
+ * Convenciones: montos en **cents** (entero); porcentajes **decimal sobre 1** (`0.40` = 40%);
+ * TNA decimal (`2.60` = 260%). El PLAN es dueño de los umbrales SCI por nivel
+ * (`minSciScore`/`maxSciScore`, resolución 2026-07-15) y del techo de enganche `maxDownPaymentPct`.
+ */
+export class CreditPlan {
+    @Expose()
+    @IsString()
+    planId!: string;
+
+    /** Código único por tenant: `BRONZE_NEW` | `SILVER_NEW` | `GOLD_NEW` | `EMPLOYEE`. */
+    @Expose()
+    @IsString()
+    code!: string;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    description!: string;
+
+    @Expose()
+    @IsEnum(CreditPlanLevelEnum)
+    level!: CreditPlanLevelEnum;
+
+    /** Array: un plan puede aplicar a varios tipos de venta (M6 §4). */
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(SaleTypeEnum, { each: true })
+    saleTypes!: SaleTypeEnum[];
+
+    /** Gamas elegibles del plan; `null` = todas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    eligibleTiers!: ProductTierEnum[] | null;
+
+    /** Enganche MÍNIMO como decimal sobre 1 (`0.40` = 40%). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    minDownPaymentPct!: number;
+
+    /** Techo de enganche (decimal sobre 1); `null` = sin techo definido (F1: TBD). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    maxDownPaymentPct!: number | null;
+
+    /** Plazos válidos en semanas (subconjunto del catálogo maestro). */
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsInt({ each: true })
+    @Min(1, { each: true })
+    termWeeksOptions!: number[];
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    maxFinancedAmountCents!: number;
+
+    /** Tasa Nominal Anual como decimal (`2.60` = 260%); rango de negocio [2.00, 2.60]. */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    tnaAnnual!: number;
+
+    /** IVA sobre intereses (decimal); fijo `0.16` en México. */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    ivaOnInterest!: number;
+
+    /** Comisión de apertura (decimal sobre 1); default `0`. */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    openingCommissionPct!: number;
+
+    /** Corrimiento de cuotas al pagar fuera de fecha (M6 §4 "Corrimiento"). */
+    @Expose()
+    @IsBoolean()
+    paymentShift!: boolean;
+
+    /** Cota inferior del rango SCI del nivel (0-100); `null` mientras TBD. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    minSciScore!: number | null;
+
+    /** Cota superior del rango SCI del nivel (0-100); `null` mientras TBD. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    maxSciScore!: number | null;
+
+    /** Versión del plan; incrementa en cada publicación de cambios. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    version!: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    validFrom!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    validUntil!: string | null;
+
+    @Expose()
+    @IsEnum(CreditPlanStatusEnum)
+    status!: CreditPlanStatusEnum;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+}

package/src/loanOfferings/dtos/Financier.ts

@@ -0,0 +1,91 @@
+import { Expose } from 'class-transformer';
+import {
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsObject,
+    IsOptional,
+    IsString,
+    Matches,
+    Min,
+} from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { FinancierStatusEnum } from '../enums/FinancierStatusEnum';
+import { FinancierTypeEnum } from '../enums/FinancierTypeEnum';
+import { ProductTierEnum } from '../enums/ProductTierEnum';
+
+/**
+ * Financier — financiera del catálogo mostrado al cliente (modelo-datos §6.3 · M6 §6).
+ * Entidad completa del dominio `loan-offerings-business` (SureKeep Fase 1 — pista Loan).
+ * SureKeep (INTERNAL) va primero (`displayOrder=1`); las externas después.
+ */
+export class Financier {
+    @Expose()
+    @IsString()
+    financierId!: string;
+
+    /** Grafía canónica: `SUREKEEP` | `PAYJOY` | `KREDIYA` | `LESPAGO`. */
+    @Expose()
+    @IsString()
+    code!: string;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsEnum(FinancierTypeEnum)
+    type!: FinancierTypeEnum;
+
+    /** Orden de presentación en el wizard (M1 paso 4). Reorder renumera. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    displayOrder!: number;
+
+    /** Texto mostrado en el wizard (ej. "RECOMENDADO"). */
+    @Expose()
+    @IsString()
+    label!: string;
+
+    /** Solo EXTERNAL: URL de derivación; `null` para INTERNAL. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    externalRedirectUrl!: string | null;
+
+    /** Gamas que la financiera acepta por defecto; `null` = todas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    eligibleTiers!: ProductTierEnum[] | null;
+
+    /** Configuración específica por financiera; `null` si no aplica. */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    config!: Record<string, unknown> | null;
+
+    @Expose()
+    @IsEnum(FinancierStatusEnum)
+    status!: FinancierStatusEnum;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+}

package/src/loanOfferings/dtos/RetailerCreditPlan.ts

@@ -0,0 +1,49 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsOptional, IsString, Matches } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+
+/**
+ * RetailerCreditPlan — enlace M:N "qué planes ofrece cada retailer" (modelo-datos §6.2).
+ * Activación explícita e idempotente por retailer. Entidad del dominio `loan-offerings-business`.
+ */
+export class RetailerCreditPlan {
+    @Expose()
+    @IsString()
+    retailerId!: string;
+
+    @Expose()
+    @IsString()
+    planId!: string;
+
+    @Expose()
+    @IsBoolean()
+    active!: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    activatedAt!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    deactivatedAt!: string | null;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+}

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

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { CreditPlanStatusEnum } from '../../enums/CreditPlanStatusEnum';
+
+/**
+ * Body de PUT /credit-plans/:planId/status — activar / inactivar un plan.
+ * Desactivar no afecta créditos existentes; solo deja de estar disponible para nuevas ventas.
+ */
+export class ChangeCreditPlanStatusRequest {
+    @Expose()
+    @IsEnum(CreditPlanStatusEnum)
+    status!: CreditPlanStatusEnum;
+}

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

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { FinancierStatusEnum } from '../../enums/FinancierStatusEnum';
+
+/**
+ * Body de PUT /financiers/:financierId/status — activar / inactivar una financiera.
+ * Desactivar la quita del wizard sin afectar créditos existentes (M6 §6).
+ */
+export class ChangeFinancierStatusRequest {
+    @Expose()
+    @IsEnum(FinancierStatusEnum)
+    status!: FinancierStatusEnum;
+}