@fiado/type-kit 3.545.0 → 3.547.0

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

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  PrepaymentMinimum,
+  PrepaymentMinimumModeEnum,
+  UpdateCreditPlanRequest,
+} from '../../../src/loanOfferings/index';
+
+const errorsOf = async (prepaymentMinimum: Record<string, unknown>): Promise<string[]> => {
+  const dto = plainToInstance(UpdateCreditPlanRequest, { prepaymentMinimum }, { excludeExtraneousValues: true });
+  const errors = await validate(dto as object);
+  return errors.flatMap((error) => (error.children ?? []).map((child) => child.property).concat(error.children?.length ? [] : [error.property]));
+};
+
+describe('UpdateCreditPlanRequest.prepaymentMinimum', () => {
+  it('tipa el mínimo del abono y conserva sus campos', async () => {
+    const dto = plainToInstance(
+      UpdateCreditPlanRequest,
+      { prepaymentMinimum: { mode: 'PERCENT_OF_PERIOD_PAYMENT', periodPaymentPct: 0.5 } },
+      { excludeExtraneousValues: true },
+    );
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.prepaymentMinimum).toBeInstanceOf(PrepaymentMinimum);
+    expect(dto.prepaymentMinimum?.periodPaymentPct).toBe(0.5);
+  });
+
+  it('acepta cualquier monto, porcentaje del pago del periodo y monto fijo', async () => {
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.ANY })).toEqual([]);
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.PERCENT_OF_PERIOD_PAYMENT, periodPaymentPct: 1 })).toEqual([]);
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.FIXED, amountCents: 10_000 })).toEqual([]);
+  });
+
+  it('rechaza un modo desconocido, un porcentaje fuera de (0, 1] y un monto menor a un centavo', async () => {
+    expect(await errorsOf({ mode: 'HALF' })).toContain('mode');
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.PERCENT_OF_PERIOD_PAYMENT, periodPaymentPct: 1.5 })).toContain('periodPaymentPct');
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.PERCENT_OF_PERIOD_PAYMENT, periodPaymentPct: 0 })).toContain('periodPaymentPct');
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.FIXED, amountCents: 0 })).toContain('amountCents');
+  });
+});

package/_test_/unit/loanRetailAudit/loanRetailAuditContracts.test.ts

@@ -0,0 +1,139 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as LoanRetailAudit from '../../../src/loanRetailAudit';
+import { LoanRetailAudit as FromRoot } from '../../../src';
+
+const {
+    AuditTrailRecordedV1,
+    CreatePiiAccessLogRequest,
+    ListAuditTrailQuery,
+    AuditTrailActionEnum,
+    LoanAuditEntityTypeEnum,
+    RetailAuditEntityTypeEnum,
+    PiiResourceTypeEnum,
+    PiiAccessActionEnum,
+    AUDIT_TRAIL_ENTITY_TYPES,
+} = LoanRetailAudit;
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+    const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+    return validateSync(dto).map((e) => e.property);
+}
+
+const validEvent = {
+    eventId: '01JABCDEF0123456789XYZABCD',
+    entityType: RetailAuditEntityTypeEnum.SALE,
+    entityId: 'sale-1',
+    action: AuditTrailActionEnum.SALE_CANCEL,
+    changes: [{ field: 'status', oldValue: 'COMPLETED', newValue: 'CANCELLED' }],
+    context: [{ key: 'saleType', value: 'CASH' }],
+    performedBy: 'user-1',
+    sourceLambda: 'retail-wizard-business',
+    occurredAt: '2026-10-19T12:00:00.000Z',
+    tenantId: 'surekeep',
+    reason: 'cliente se arrepintió',
+};
+
+describe('AuditTrailRecordedV1', () => {
+    it('acepta un evento completo de Retail', () => {
+        expect(errorsOf(AuditTrailRecordedV1, validEvent)).toEqual([]);
+    });
+
+    it('acepta un entityType de Loan y un alta sin oldValue ni contexto', () => {
+        expect(
+            errorsOf(AuditTrailRecordedV1, {
+                ...validEvent,
+                entityType: LoanAuditEntityTypeEnum.CREDIT,
+                action: AuditTrailActionEnum.CREATE,
+                changes: [{ field: 'status', newValue: 'ACTIVE' }],
+                context: [],
+                tenantId: undefined,
+                reason: undefined,
+            }),
+        ).toEqual([]);
+    });
+
+    it('rechaza entityType y action fuera del catálogo', () => {
+        expect(errorsOf(AuditTrailRecordedV1, { ...validEvent, entityType: 'RetailCustomer' })).toContain('entityType');
+        expect(errorsOf(AuditTrailRecordedV1, { ...validEvent, action: 'BOOM' })).toContain('action');
+    });
+
+    it('exige eventId, sourceLambda, performedBy y occurredAt ISO', () => {
+        const errors = errorsOf(AuditTrailRecordedV1, {
+            ...validEvent,
+            eventId: '',
+            sourceLambda: undefined,
+            performedBy: '',
+            occurredAt: 'ayer',
+        });
+        expect(errors).toEqual(expect.arrayContaining(['eventId', 'sourceLambda', 'performedBy', 'occurredAt']));
+    });
+
+    it('valida cada cambio y cada entrada de contexto', () => {
+        expect(errorsOf(AuditTrailRecordedV1, { ...validEvent, changes: [{ oldValue: 'x' }] })).toContain('changes');
+        expect(errorsOf(AuditTrailRecordedV1, { ...validEvent, context: [{ key: 'k', value: 3 }] })).toContain('context');
+    });
+});
+
+describe('CreatePiiAccessLogRequest', () => {
+    const valid = {
+        accessId: '01JABCDEF0123456789XYZABCD',
+        occurredAt: '2026-10-19T12:00:00.000Z',
+        correlationId: 'req-1',
+        actorId: 'user-1',
+        sourceLambda: 'retail-customer-business',
+        operationName: 'publicGetCustomer',
+        action: PiiAccessActionEnum.READ,
+        resourceType: PiiResourceTypeEnum.RETAIL_CUSTOMER,
+        resourceId: 'cust-1',
+        fields: ['phone', 'curp'],
+    };
+
+    it('acepta un acceso de detalle y uno de listado con resourceIds', () => {
+        expect(errorsOf(CreatePiiAccessLogRequest, valid)).toEqual([]);
+        expect(errorsOf(CreatePiiAccessLogRequest, { ...valid, resourceId: '(list)', resourceIds: ['a', 'b'] })).toEqual([]);
+    });
+
+    it('rechaza el resourceType viejo y una acción desconocida', () => {
+        expect(errorsOf(CreatePiiAccessLogRequest, { ...valid, resourceType: 'RetailCustomer' })).toContain('resourceType');
+        expect(errorsOf(CreatePiiAccessLogRequest, { ...valid, action: 'DELETE' })).toContain('action');
+    });
+
+    it('exige accessId, actor, campos y fecha ISO', () => {
+        const errors = errorsOf(CreatePiiAccessLogRequest, { ...valid, accessId: '', actorId: undefined, fields: [], occurredAt: 'x' });
+        expect(errors).toEqual(expect.arrayContaining(['accessId', 'actorId', 'fields', 'occurredAt']));
+    });
+});
+
+describe('ListAuditTrailQuery', () => {
+    it('acepta entityType de Loan o Retail con orden, límite y cursor', () => {
+        expect(errorsOf(ListAuditTrailQuery, { entityType: 'CUSTOMER', entityId: 'c-1', order: 'asc', limit: '50', nextToken: 'abc' })).toEqual([]);
+        expect(errorsOf(ListAuditTrailQuery, { entityType: 'LoanParameter', entityId: 'p-1' })).toEqual([]);
+    });
+
+    it('rechaza entityType desconocido, orden inválido y límite fuera de rango', () => {
+        const errors = errorsOf(ListAuditTrailQuery, { entityType: 'FOO', entityId: 'x', order: 'up', limit: '500' });
+        expect(errors).toEqual(expect.arrayContaining(['entityType', 'order', 'limit']));
+    });
+
+    it('exige entityId', () => {
+        expect(errorsOf(ListAuditTrailQuery, { entityType: 'SALE' })).toContain('entityId');
+    });
+});
+
+describe('catálogos', () => {
+    it('AUDIT_TRAIL_ENTITY_TYPES une Loan y Retail sin repetidos', () => {
+        const all = [...Object.values(LoanAuditEntityTypeEnum), ...Object.values(RetailAuditEntityTypeEnum)];
+        expect([...AUDIT_TRAIL_ENTITY_TYPES].sort()).toEqual([...all].sort());
+        expect(new Set(all).size).toBe(all.length);
+    });
+
+    it('PiiResourceTypeEnum es SCREAMING_SNAKE', () => {
+        Object.values(PiiResourceTypeEnum).forEach((v) => expect(v).toMatch(/^[A-Z][A-Z_]*$/));
+    });
+
+    it('se exporta en la raíz como LoanRetailAudit', () => {
+        expect(FromRoot.AuditTrailRecordedV1).toBe(AuditTrailRecordedV1);
+    });
+});

package/bin/index.d.ts

@@ -129,3 +129,4 @@ export * as RewardsEligibility from './rewardsEligibility';
 export * as DatalakeReports from './datalakeReports';
 export * as PdfRender from './pdfRender';
 export * as Rules from './rules';
+export * as LoanRetailAudit from './loanRetailAudit';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.FiadoIncFavorite = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = void 0;
-exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
+exports.LoanRetailAudit = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -252,3 +252,6 @@ exports.DatalakeReports = __importStar(require("./datalakeReports"));
 exports.PdfRender = __importStar(require("./pdfRender"));
 // Rules: DTOs del lambda central rules-business (catálogo, validación, generación con IA y evaluación de reglas).
 exports.Rules = __importStar(require("./rules"));
+// LoanRetailAudit: contrato del lambda central loan-retail-audit-business (bitácora y accesos a PII
+// de Loan y Retail): mensaje de su cola, POST /private/pii-access-logs y GET /private/audit-trail.
+exports.LoanRetailAudit = __importStar(require("./loanRetailAudit"));

package/bin/loanCredit/dtos/responses/CreditCustomerListItem.d.ts

@@ -25,6 +25,8 @@ export interface CreditCustomerCredit {
     settledCreditsCount: number | null;
     writtenOffCreditsCount: number | null;
     outstandingBalanceCents: number | null;
+    /** Deuda total de sus créditos vivos: capital, interés e IVA que faltan de las cuotas abiertas. `null` = no aplica. */
+    totalDebtCents?: number | null;
     arrearsDays: number | null;
     lastPaymentAt: string | null;
     /** Ausente en créditos sin pago desde que existe el campo: el front cae a `lastPaymentAt`. */

package/bin/loanCredit/dtos/responses/LoanBorrowerCreditItem.d.ts

@@ -9,6 +9,8 @@ export interface LoanBorrowerCreditItem extends LoanCreditResponse {
     paidInstallments: number;
     /** `null` = no aplica (el crédito se canceló o caducó); `0` = ya no debe nada. */
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     /** Días desde el vencimiento impago más viejo; `0` al día; `null` si no hay atraso que medir. */
     overdueDays: number | null;
     /** Suma del TOTAL de las cuotas vencidas impagas. Sigue a `overdueDays` en `null`/`0`. */

package/bin/loanCredit/dtos/responses/LoanCreditDetail.d.ts

@@ -13,6 +13,8 @@ export interface LoanCreditDetail extends LoanCreditResponse {
     financier: SaleFinancierEnum;
     paidInstallments: number;
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     overdueDays: number | null;
     overdueAmountCents: number | null;
     /** Cuotas vencidas impagas. `0` = nada vencido; `null` acompaña a `overdueDays` en null. */

package/bin/loanCredit/dtos/responses/LoanPrepaymentQuote.d.ts

@@ -3,8 +3,10 @@ export interface LoanPrepaymentQuote {
     creditId: string;
     /** Saldo insoluto que se le informa al cliente. */
     outstandingCapitalCents: number;
-    /** Pago del periodo: el mínimo del abono. */
+    /** Pago del periodo. */
     periodPaymentCents: number;
+    /** Mínimo del abono según el plan del crédito; con mínimo `ANY`, 1 centavo. */
+    minAmountCents?: number;
     /** Monto de liquidación anticipada: el techo del abono. */
     settlementAmountCents: number;
 }

package/bin/loanCredit/dtos/responses/SellerCreditRow.d.ts

@@ -17,6 +17,8 @@ export interface SellerCreditRow {
     summaryUnavailable: boolean;
     paidInstallments: number | null;
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     overdueDays: number | null;
     overdueAmountCents: number | null;
     /** Primera cuota que todavía se debe; `null` si ya no debe nada o si el plan no se leyó. */

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

@@ -2,6 +2,7 @@ import { CreditPlanLevelEnum } from '../enums/CreditPlanLevelEnum';
 import { CreditPlanStatusEnum } from '../enums/CreditPlanStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from './PrepaymentMinimum';
 /**
  * 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).
@@ -49,4 +50,6 @@ export declare class CreditPlan {
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
+    /** Mínimo del abono a capital; ausente = `ANY` (cualquier monto). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/bin/loanOfferings/dtos/CreditPlan.js

@@ -17,6 +17,7 @@ const CreditPlanLevelEnum_1 = require("../enums/CreditPlanLevelEnum");
 const CreditPlanStatusEnum_1 = require("../enums/CreditPlanStatusEnum");
 const ProductTierEnum_1 = require("../enums/ProductTierEnum");
 const SaleTypeEnum_1 = require("../enums/SaleTypeEnum");
+const PrepaymentMinimum_1 = require("./PrepaymentMinimum");
 /**
  * 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).
@@ -182,3 +183,10 @@ __decorate([
     (0, class_validator_1.Matches)(regex_1.regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' }),
     __metadata("design:type", String)
 ], CreditPlan.prototype, "updatedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PrepaymentMinimum_1.PrepaymentMinimum),
+    __metadata("design:type", PrepaymentMinimum_1.PrepaymentMinimum)
+], CreditPlan.prototype, "prepaymentMinimum", void 0);

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

@@ -0,0 +1,12 @@
+import { PrepaymentMinimumModeEnum } from '../enums/PrepaymentMinimumModeEnum';
+/**
+ * Mínimo del abono a capital de un plan. El máximo no depende del plan: es lo que falta para liquidar.
+ * Sin este campo en el plan, el mínimo es `ANY`.
+ */
+export declare class PrepaymentMinimum {
+    mode: PrepaymentMinimumModeEnum;
+    /** Sólo `PERCENT_OF_PERIOD_PAYMENT`: decimal sobre 1 del pago del periodo (`0.5` = 50 %). */
+    periodPaymentPct?: number | null;
+    /** Sólo `FIXED`: monto mínimo en cents. */
+    amountCents?: number | null;
+}

package/bin/loanOfferings/dtos/PrepaymentMinimum.js

@@ -0,0 +1,42 @@
+"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.PrepaymentMinimum = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const PrepaymentMinimumModeEnum_1 = require("../enums/PrepaymentMinimumModeEnum");
+/**
+ * Mínimo del abono a capital de un plan. El máximo no depende del plan: es lo que falta para liquidar.
+ * Sin este campo en el plan, el mínimo es `ANY`.
+ */
+class PrepaymentMinimum {
+}
+exports.PrepaymentMinimum = PrepaymentMinimum;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(PrepaymentMinimumModeEnum_1.PrepaymentMinimumModeEnum),
+    __metadata("design:type", String)
+], PrepaymentMinimum.prototype, "mode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0.0001),
+    (0, class_validator_1.Max)(1),
+    __metadata("design:type", Number)
+], PrepaymentMinimum.prototype, "periodPaymentPct", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PrepaymentMinimum.prototype, "amountCents", void 0);

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

@@ -1,6 +1,7 @@
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 /**
  * Body de POST /credit-plans — alta de un plan (SureKeep Fase 1 — pista Loan).
  * Campos server-assigned (`planId`, `version`, `ivaOnInterest`=0.16, `status`, auditoría) NO viajan
@@ -24,4 +25,6 @@ export declare class CreateCreditPlanRequest {
     maxSciScore?: number | null;
     validFrom?: string | null;
     validUntil?: string | null;
+    /** Mínimo del abono a capital; ausente = sin cambios (en el alta: `ANY`). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

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

@@ -15,6 +15,7 @@ const class_validator_1 = require("class-validator");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const SaleTypeEnum_1 = require("../../enums/SaleTypeEnum");
+const PrepaymentMinimum_1 = require("../PrepaymentMinimum");
 /**
  * Body de POST /credit-plans — alta de un plan (SureKeep Fase 1 — pista Loan).
  * Campos server-assigned (`planId`, `version`, `ivaOnInterest`=0.16, `status`, auditoría) NO viajan
@@ -135,3 +136,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CreateCreditPlanRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PrepaymentMinimum_1.PrepaymentMinimum),
+    __metadata("design:type", PrepaymentMinimum_1.PrepaymentMinimum)
+], CreateCreditPlanRequest.prototype, "prepaymentMinimum", void 0);

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

@@ -1,5 +1,6 @@
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 /**
  * Body de PUT /credit-plans/:planId — edición parcial de parámetros del plan (todos opcionales).
  * En F1 el PUT puede editar `min/maxSciScore` por-plan (DEC-004); el guard atómico anti-huecos
@@ -22,4 +23,6 @@ export declare class UpdateCreditPlanRequest {
     maxSciScore?: number | null;
     validFrom?: string | null;
     validUntil?: string | null;
+    /** Mínimo del abono a capital; ausente = sin cambios (en el alta: `ANY`). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

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

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const SaleTypeEnum_1 = require("../../enums/SaleTypeEnum");
+const PrepaymentMinimum_1 = require("../PrepaymentMinimum");
 /**
  * Body de PUT /credit-plans/:planId — edición parcial de parámetros del plan (todos opcionales).
  * En F1 el PUT puede editar `min/maxSciScore` por-plan (DEC-004); el guard atómico anti-huecos
@@ -132,3 +133,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], UpdateCreditPlanRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PrepaymentMinimum_1.PrepaymentMinimum),
+    __metadata("design:type", PrepaymentMinimum_1.PrepaymentMinimum)
+], UpdateCreditPlanRequest.prototype, "prepaymentMinimum", void 0);

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

@@ -2,6 +2,7 @@ import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { CreditPlanStatusEnum } from '../../enums/CreditPlanStatusEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 /**
  * Shape de salida de un plan de crédito (GET / POST / PUT de /credit-plans).
  * Montos en cents; porcentajes y TNA en decimal.
@@ -32,4 +33,6 @@ export interface CreditPlanResponse {
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
+    /** Mínimo del abono a capital; ausente = `ANY` (cualquier monto). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

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

@@ -0,0 +1,9 @@
+/** Cómo se fija el mínimo del abono a capital de un plan. */
+export declare enum PrepaymentMinimumModeEnum {
+    /** Sin mínimo: el cliente abona el monto que quiera. */
+    ANY = "ANY",
+    /** Un porcentaje del pago del periodo (`periodPaymentPct`). */
+    PERCENT_OF_PERIOD_PAYMENT = "PERCENT_OF_PERIOD_PAYMENT",
+    /** Un monto fijo (`amountCents`). */
+    FIXED = "FIXED"
+}

package/bin/loanOfferings/enums/PrepaymentMinimumModeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrepaymentMinimumModeEnum = void 0;
+/** Cómo se fija el mínimo del abono a capital de un plan. */
+var PrepaymentMinimumModeEnum;
+(function (PrepaymentMinimumModeEnum) {
+    /** Sin mínimo: el cliente abona el monto que quiera. */
+    PrepaymentMinimumModeEnum["ANY"] = "ANY";
+    /** Un porcentaje del pago del periodo (`periodPaymentPct`). */
+    PrepaymentMinimumModeEnum["PERCENT_OF_PERIOD_PAYMENT"] = "PERCENT_OF_PERIOD_PAYMENT";
+    /** Un monto fijo (`amountCents`). */
+    PrepaymentMinimumModeEnum["FIXED"] = "FIXED";
+})(PrepaymentMinimumModeEnum || (exports.PrepaymentMinimumModeEnum = PrepaymentMinimumModeEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -15,7 +15,9 @@ export * from './enums/StorePolicyPhaseEnum';
 export * from './enums/SegmentStatusEnum';
 export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
+export * from './enums/PrepaymentMinimumModeEnum';
 export * from './dtos/CreditPlan';
+export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
 export * from './dtos/PromotionEffect';

package/bin/loanOfferings/index.js

@@ -32,8 +32,10 @@ __exportStar(require("./enums/StorePolicyPhaseEnum"), exports);
 __exportStar(require("./enums/SegmentStatusEnum"), exports);
 __exportStar(require("./enums/SegmentColorSlotEnum"), exports);
 __exportStar(require("./enums/SegmentFilterIdEnum"), exports);
+__exportStar(require("./enums/PrepaymentMinimumModeEnum"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
+__exportStar(require("./dtos/PrepaymentMinimum"), exports);
 __exportStar(require("./dtos/Financier"), exports);
 __exportStar(require("./dtos/RetailerCreditPlan"), exports);
 __exportStar(require("./dtos/PromotionEffect"), exports);

package/bin/loanRetailAudit/constants/auditTrailEntityTypes.d.ts

@@ -0,0 +1,6 @@
+import { LoanAuditEntityTypeEnum } from '../enums/LoanAuditEntityTypeEnum';
+import { RetailAuditEntityTypeEnum } from '../enums/RetailAuditEntityTypeEnum';
+/** Cualquier `entityType` que acepta el central, de Loan o de Retail. */
+export type AuditTrailEntityType = LoanAuditEntityTypeEnum | RetailAuditEntityTypeEnum;
+export declare const AUDIT_TRAIL_ENTITY_TYPES: readonly AuditTrailEntityType[];
+export declare const AUDIT_TRAIL_MAX_PAGE_SIZE = 100;

package/bin/loanRetailAudit/constants/auditTrailEntityTypes.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIT_TRAIL_MAX_PAGE_SIZE = exports.AUDIT_TRAIL_ENTITY_TYPES = void 0;
+const LoanAuditEntityTypeEnum_1 = require("../enums/LoanAuditEntityTypeEnum");
+const RetailAuditEntityTypeEnum_1 = require("../enums/RetailAuditEntityTypeEnum");
+exports.AUDIT_TRAIL_ENTITY_TYPES = [
+    ...Object.values(LoanAuditEntityTypeEnum_1.LoanAuditEntityTypeEnum),
+    ...Object.values(RetailAuditEntityTypeEnum_1.RetailAuditEntityTypeEnum),
+];
+exports.AUDIT_TRAIL_MAX_PAGE_SIZE = 100;

package/bin/loanRetailAudit/dtos/AuditTrailChange.d.ts

@@ -0,0 +1,8 @@
+/** Un campo que cambió; los valores van serializados a string y nunca llevan PII. */
+export declare class AuditTrailChange {
+    field: string;
+    /** Ausente en un alta. */
+    oldValue?: string;
+    /** Ausente en una baja. */
+    newValue?: string;
+}

package/bin/loanRetailAudit/dtos/AuditTrailChange.js

@@ -0,0 +1,36 @@
+"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.AuditTrailChange = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Un campo que cambió; los valores van serializados a string y nunca llevan PII. */
+class AuditTrailChange {
+}
+exports.AuditTrailChange = AuditTrailChange;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuditTrailChange.prototype, "field", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditTrailChange.prototype, "oldValue", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditTrailChange.prototype, "newValue", void 0);

package/bin/loanRetailAudit/dtos/AuditTrailContextEntry.d.ts

@@ -0,0 +1,5 @@
+/** Dato que la acción no cambió y se guarda para leer la entrada sin abrir otra pantalla. */
+export declare class AuditTrailContextEntry {
+    key: string;
+    value: string;
+}

package/bin/loanRetailAudit/dtos/AuditTrailContextEntry.js

@@ -0,0 +1,29 @@
+"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.AuditTrailContextEntry = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Dato que la acción no cambió y se guarda para leer la entrada sin abrir otra pantalla. */
+class AuditTrailContextEntry {
+}
+exports.AuditTrailContextEntry = AuditTrailContextEntry;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuditTrailContextEntry.prototype, "key", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditTrailContextEntry.prototype, "value", void 0);

package/bin/loanRetailAudit/dtos/requests/CreatePiiAccessLogRequest.d.ts

@@ -0,0 +1,19 @@
+import { PiiAccessActionEnum } from '../../enums/PiiAccessActionEnum';
+import { PiiResourceTypeEnum } from '../../enums/PiiResourceTypeEnum';
+/** Body de `POST /private/pii-access-logs` (privateCreatePiiAccessLog); el tenant va en `?tenantId=`. */
+export declare class CreatePiiAccessLogRequest {
+    /** ULID generado por quien llama; con `occurredAt` forma el sk, así un reintento no duplica. */
+    accessId: string;
+    occurredAt: string;
+    correlationId: string;
+    actorId: string;
+    sourceLambda: string;
+    operationName: string;
+    action: PiiAccessActionEnum;
+    resourceType: PiiResourceTypeEnum;
+    /** Id del recurso, o `(list)` en un listado con los ids en `resourceIds`. */
+    resourceId: string;
+    /** Nombres de los campos PII que viajaron; nunca sus valores. */
+    fields: string[];
+    resourceIds?: string[];
+}