@fiado/type-kit 3.456.0 → 3.457.0

package/_test_/unit/benefitCenter/benefitSuiteConfig.test.ts

@@ -0,0 +1,58 @@
+import "reflect-metadata";
+import { plainToInstance } from "class-transformer";
+import { validateSync } from "class-validator";
+import { BenefitCreateRequest, BenefitCatalogStatusEnum } from "../../../src/benefitCenter/dtos/BenefitCreateRequest";
+import { BenefitUpdateRequest } from "../../../src/benefitCenter/dtos/BenefitUpdateRequest";
+import { BenefitSuiteResponse } from "../../../src/benefitCenter/dtos/BenefitSuiteResponse";
+
+const BASE = {
+    name: "SureKeep",
+    status: BenefitCatalogStatusEnum.ACTIVE,
+    sortOrder: 9,
+    flow: "RETAIL_LOAN",
+    moduleConfig: { modules: [{ moduleEnvVar: "RETAIL_LOAN_CONNECTOR_URL", moduleName: "retail-loan-connector" }] },
+};
+
+const propertiesWithErrors = (dto: object) => validateSync(dto).map((error) => error.property);
+
+describe("BenefitCreateRequest.suiteConfig (I1)", () => {
+    it("acepta el tenant de la suite", () => {
+        const dto = plainToInstance(BenefitCreateRequest, { ...BASE, suiteConfig: { tenantId: "surekeep" } });
+        expect(validateSync(dto)).toHaveLength(0);
+        expect(dto.suiteConfig?.tenantId).toBe("surekeep");
+    });
+
+    it("es opcional: un beneficio sin suite sigue siendo válido", () => {
+        const dto = plainToInstance(BenefitCreateRequest, BASE);
+        expect(validateSync(dto)).toHaveLength(0);
+    });
+
+    it("rechaza un tenant vacío", () => {
+        const dto = plainToInstance(BenefitCreateRequest, { ...BASE, suiteConfig: { tenantId: "" } });
+        expect(propertiesWithErrors(dto)).toContain("suiteConfig");
+    });
+});
+
+describe("BenefitUpdateRequest.suiteConfig (I1)", () => {
+    it("acepta cambiar solo el tenant", () => {
+        const dto = plainToInstance(BenefitUpdateRequest, { suiteConfig: { tenantId: "otra-sofom" } });
+        expect(validateSync(dto)).toHaveLength(0);
+    });
+
+    it("rechaza un tenant vacío", () => {
+        const dto = plainToInstance(BenefitUpdateRequest, { suiteConfig: { tenantId: "" } });
+        expect(propertiesWithErrors(dto)).toContain("suiteConfig");
+    });
+});
+
+describe("BenefitSuiteResponse (I1)", () => {
+    it("el tenant es opcional: un beneficio sin suite no lo trae", () => {
+        const suite: BenefitSuiteResponse = {
+            benefitId: "ben-9",
+            status: BenefitCatalogStatusEnum.ACTIVE,
+            flow: "TOPUPS",
+            name: "Recargas",
+        };
+        expect(suite.tenantId).toBeUndefined();
+    });
+});

package/_test_/unit/loanCredit/customerReadDtos.test.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+import {
+    ContractTypeEnum,
+    CreditSaleContext,
+    LoanContractDownloadUrl,
+    LoanPaymentListItem,
+    LoanPaymentListResponse,
+} from '../../../src/loanCredit/index';
+import { CollectionResultStatus } from '../../../src/collection/enums/CollectionResultStatus';
+import { MechanismType } from '../../../src/collection/enums/MechanismType';
+import { CurrencyId } from '../../../src/currency/enums/CurrencyId';
+import { WizardSessionLookupStatusEnum } from '../../../src/retailWizard/enums/WizardSessionLookupStatusEnum';
+
+describe('loanCredit — DTOs de lectura de cliente (I1)', () => {
+    const payment: LoanPaymentListItem = {
+        paymentId: 'PAY-1',
+        receipt: 'SK-MD-0a1b2c3d4e5f',
+        installmentNumber: 3,
+        attemptId: 'ATT-1',
+        mechanism: Object.values(MechanismType)[0] as MechanismType,
+        result: Object.values(CollectionResultStatus)[0] as CollectionResultStatus,
+        currency: Object.values(CurrencyId)[0] as CurrencyId,
+        collectedCents: 105000,
+        appliedCents: 105000,
+        overpaidCents: 0,
+        reservedCents: 0,
+        needsReview: false,
+        appliedAt: '2026-09-15T14:00:00.000Z',
+    };
+
+    it('el desglose del pago es opcional', () => {
+        expect(payment.appliedCapitalCents).toBeUndefined();
+        const withBreakdown: LoanPaymentListItem = { ...payment, appliedCapitalCents: 81667, appliedInterestCents: 20000, appliedIvaCents: 3200 };
+        expect(withBreakdown.appliedIvaCents).toBe(3200);
+    });
+
+    it('la página de pagos termina cuando no trae nextToken', () => {
+        const page: LoanPaymentListResponse = { items: [payment] };
+        expect(page.nextToken).toBeUndefined();
+    });
+
+    it('el contexto de venta declara el estado de cada lectura', () => {
+        const ok = Object.values(WizardSessionLookupStatusEnum)[0] as WizardSessionLookupStatusEnum;
+        const context: CreditSaleContext = {
+            status: ok,
+            retailCustomerId: 'RC-1',
+            retailCustomerStatus: ok,
+            customerName: null,
+            customerNameStatus: ok,
+            productBrand: 'Samsung',
+            productModel: 'Galaxy A54 5G',
+            productCapacity: '128 GB',
+            retailerId: null,
+            storeId: null,
+            storeName: null,
+            storeNameStatus: ok,
+        };
+        expect(context.productModel).toBe('Galaxy A54 5G');
+    });
+
+    it('la URL del contrato trae su tipo y su vencimiento', () => {
+        const url: LoanContractDownloadUrl = {
+            contractId: 'CT-1',
+            creditId: 'CR-1',
+            type: ContractTypeEnum.CREDIT,
+            url: 'https://s3.example/contract.pdf',
+            expiresAt: '2026-09-21T15:00:00.000Z',
+        };
+        expect(url.type).toBe(ContractTypeEnum.CREDIT);
+    });
+});

package/_test_/unit/retailLoanConnector/contract.test.ts

@@ -0,0 +1,79 @@
+import 'reflect-metadata';
+import {
+    MyCreditDetail,
+    MyDocumentGroup,
+    MyDocumentGroupIdEnum,
+    MyDocumentKindEnum,
+    MyDocumentStatusEnum,
+    MyInstallment,
+    MyInstallmentDisplayStatusEnum,
+    MyPaymentFrequencyEnum,
+    MyPaymentMethodEnum,
+    MyPaymentPage,
+} from '../../../src/retailLoanConnector/index';
+import { LoanCreditStatusEnum, LoanInstallmentStatusEnum } from '../../../src/loanCredit/index';
+import { CollectionResultStatus } from '../../../src/collection/enums/CollectionResultStatus';
+
+describe('retailLoanConnector — contrato app ↔ conector (I1)', () => {
+    it('los ids de grupo de documentos son los que espera el módulo de la app', () => {
+        expect(MyDocumentGroupIdEnum.CONTRACT).toBe('contract');
+        expect(MyDocumentGroupIdEnum.MONTHLY).toBe('monthly');
+    });
+
+    it('el detalle del crédito va en pesos y con frecuencia semanal', () => {
+        const detail: MyCreditDetail = {
+            creditId: 'CR-1',
+            status: LoanCreditStatusEnum.ACTIVE,
+            device: { brand: 'Samsung', model: 'Galaxy A54 5G', capacity: '128 GB' },
+            paymentFrequency: MyPaymentFrequencyEnum.WEEKLY,
+            installmentAmount: 1050,
+            totalInstallments: 12,
+            paidInstallments: 3,
+            remainingBalance: 9450,
+            equipmentPrice: 12999,
+            downPayment: 2600,
+            financedAmount: 10399,
+            annualRate: 120,
+            nextInstallment: { number: 4, dueDate: '2026-09-18', amount: 1050, isOverdue: false },
+        };
+        expect(detail.nextInstallment?.number).toBe(4);
+    });
+
+    it('una cuota lleva su estado real y el que pinta la app', () => {
+        const installment: MyInstallment = {
+            number: 4,
+            dueDate: '2026-09-18',
+            amount: 1050,
+            principal: 846.67,
+            interest: 174.62,
+            iva: 27.94,
+            outstanding: 1050,
+            status: LoanInstallmentStatusEnum.PENDING,
+            displayStatus: MyInstallmentDisplayStatusEnum.NEXT,
+        };
+        expect(installment.displayStatus).toBe('NEXT');
+    });
+
+    it('un pago sin desglose sigue siendo válido', () => {
+        const page: MyPaymentPage = {
+            items: [{
+                paymentId: 'PAY-1',
+                folio: 'SK-MD-0a1b2c3d4e5f',
+                installmentNumber: 3,
+                appliedAt: '2026-09-15T14:00:00.000Z',
+                amount: 1050,
+                method: MyPaymentMethodEnum.PCF_ACCOUNT,
+                result: Object.values(CollectionResultStatus)[0] as CollectionResultStatus,
+            }],
+        };
+        expect(page.items[0]?.principal).toBeUndefined();
+    });
+
+    it('un grupo de documentos declara tipo y estado de cada documento', () => {
+        const group: MyDocumentGroup = {
+            id: MyDocumentGroupIdEnum.CONTRACT,
+            documents: [{ documentRef: 'doc-contract-CT-1', kind: MyDocumentKindEnum.CONTRACT, status: MyDocumentStatusEnum.READY }],
+        };
+        expect(group.documents).toHaveLength(1);
+    });
+});

package/bin/benefitCenter/dtos/BenefitCreateRequest.d.ts

@@ -1,4 +1,5 @@
 import { BenefitModuleConfigRequest } from "./BenefitModuleConfigRequest";
+import { BenefitSuiteConfigRequest } from "./BenefitSuiteConfigRequest";
 /** Mirror enum-like de BenefitCatalogStatus en el type-kit (para validación). */
 export declare enum BenefitCatalogStatusEnum {
     ACTIVE = "ACTIVE",
@@ -16,6 +17,8 @@ export declare class BenefitCreateRequest {
     translationKey?: string;
     requiresEmail?: boolean;
     moduleConfig: BenefitModuleConfigRequest;
+    /** Tenant de la suite (I1). Obligatorio si el flow es RETAIL_LOAN; lo valida el backend. */
+    suiteConfig?: BenefitSuiteConfigRequest;
     /**
      * Reglas de visibilidad. `null` se acepta como "beneficio público"
      * (visible a todos los usuarios); `undefined` también — el backend

package/bin/benefitCenter/dtos/BenefitCreateRequest.js

@@ -13,6 +13,7 @@ exports.BenefitCreateRequest = exports.BenefitCatalogStatusEnum = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const BenefitModuleConfigRequest_1 = require("./BenefitModuleConfigRequest");
+const BenefitSuiteConfigRequest_1 = require("./BenefitSuiteConfigRequest");
 /** Mirror enum-like de BenefitCatalogStatus en el type-kit (para validación). */
 var BenefitCatalogStatusEnum;
 (function (BenefitCatalogStatusEnum) {
@@ -72,6 +73,12 @@ __decorate([
     (0, class_transformer_1.Type)(() => BenefitModuleConfigRequest_1.BenefitModuleConfigRequest),
     __metadata("design:type", BenefitModuleConfigRequest_1.BenefitModuleConfigRequest)
 ], BenefitCreateRequest.prototype, "moduleConfig", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BenefitSuiteConfigRequest_1.BenefitSuiteConfigRequest),
+    __metadata("design:type", BenefitSuiteConfigRequest_1.BenefitSuiteConfigRequest)
+], BenefitCreateRequest.prototype, "suiteConfig", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)((_, value) => value !== null && value !== undefined),
     (0, class_validator_1.IsObject)(),

package/bin/benefitCenter/dtos/BenefitSuiteConfigRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuración de suite de un beneficio (I1): el tenant de FiadoLend/FiadoRetail que atiende este
+ * beneficio (p. ej. la SOFOM). Obligatoria cuando el flow es RETAIL_LOAN; la regla la aplica
+ * benefits-marketplace-business porque depende de los flows en datos.
+ */
+export declare class BenefitSuiteConfigRequest {
+    tenantId: string;
+}

package/bin/benefitCenter/dtos/BenefitSuiteConfigRequest.js

@@ -0,0 +1,26 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitSuiteConfigRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Configuración de suite de un beneficio (I1): el tenant de FiadoLend/FiadoRetail que atiende este
+ * beneficio (p. ej. la SOFOM). Obligatoria cuando el flow es RETAIL_LOAN; la regla la aplica
+ * benefits-marketplace-business porque depende de los flows en datos.
+ */
+class BenefitSuiteConfigRequest {
+}
+exports.BenefitSuiteConfigRequest = BenefitSuiteConfigRequest;
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BenefitSuiteConfigRequest.prototype, "tenantId", void 0);

package/bin/benefitCenter/dtos/BenefitSuiteResponse.d.ts

@@ -0,0 +1,16 @@
+import { BenefitCatalogStatusEnum } from "./BenefitCreateRequest";
+/**
+ * Respuesta de `GET /benefits/{benefitId}/suite` (privado de benefits-marketplace-business, I1).
+ * Lo consume retail-loan-connector para resolver el tenant del beneficio del lado del servidor.
+ * NO evalúa visibilidad: solo describe el beneficio.
+ */
+export interface BenefitSuiteResponse {
+    benefitId: string;
+    status: BenefitCatalogStatusEnum;
+    /** `reference` del Flow (p. ej. "RETAIL_LOAN"). */
+    flow: string;
+    /** Tenant de la suite; ausente si el beneficio no tiene `suiteConfig`. */
+    tenantId?: string;
+    name: string;
+    icon?: string;
+}

package/bin/benefitCenter/dtos/BenefitSuiteResponse.js

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

package/bin/benefitCenter/dtos/BenefitUpdateRequest.d.ts

@@ -1,5 +1,6 @@
 import { BenefitCatalogStatusEnum } from "./BenefitCreateRequest";
 import { BenefitModuleConfigRequest } from "./BenefitModuleConfigRequest";
+import { BenefitSuiteConfigRequest } from "./BenefitSuiteConfigRequest";
 export declare class BenefitUpdateRequest {
     name?: string;
     description?: string;
@@ -10,6 +11,8 @@ export declare class BenefitUpdateRequest {
     translationKey?: string;
     requiresEmail?: boolean;
     moduleConfig?: BenefitModuleConfigRequest;
+    /** Tenant de la suite (I1). `undefined` no toca el campo. */
+    suiteConfig?: BenefitSuiteConfigRequest;
     /**
      * Reglas de visibilidad — patch parcial:
      *   - `undefined` → no toca el campo existente.

package/bin/benefitCenter/dtos/BenefitUpdateRequest.js

@@ -14,6 +14,7 @@ const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const BenefitCreateRequest_1 = require("./BenefitCreateRequest");
 const BenefitModuleConfigRequest_1 = require("./BenefitModuleConfigRequest");
+const BenefitSuiteConfigRequest_1 = require("./BenefitSuiteConfigRequest");
 class BenefitUpdateRequest {
 }
 exports.BenefitUpdateRequest = BenefitUpdateRequest;
@@ -65,6 +66,12 @@ __decorate([
     (0, class_transformer_1.Type)(() => BenefitModuleConfigRequest_1.BenefitModuleConfigRequest),
     __metadata("design:type", BenefitModuleConfigRequest_1.BenefitModuleConfigRequest)
 ], BenefitUpdateRequest.prototype, "moduleConfig", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BenefitSuiteConfigRequest_1.BenefitSuiteConfigRequest),
+    __metadata("design:type", BenefitSuiteConfigRequest_1.BenefitSuiteConfigRequest)
+], BenefitUpdateRequest.prototype, "suiteConfig", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)((_, value) => value !== null && value !== undefined),
     (0, class_validator_1.IsObject)(),

package/bin/benefitCenter/index.d.ts

@@ -37,6 +37,8 @@ export * from "./dtos/BenefitModuleEntryRequest";
 export * from "./dtos/BenefitModuleConfigRequest";
 export * from "./dtos/BenefitCreateRequest";
 export * from "./dtos/BenefitUpdateRequest";
+export * from "./dtos/BenefitSuiteConfigRequest";
+export * from "./dtos/BenefitSuiteResponse";
 export * from "./dtos/BannerTranslationRequest";
 export * from "./dtos/BannerTranslationsRequest";
 export * from "./dtos/BannerContentRequest";

package/bin/benefitCenter/index.js

@@ -57,6 +57,9 @@ __exportStar(require("./dtos/BenefitModuleEntryRequest"), exports);
 __exportStar(require("./dtos/BenefitModuleConfigRequest"), exports);
 __exportStar(require("./dtos/BenefitCreateRequest"), exports);
 __exportStar(require("./dtos/BenefitUpdateRequest"), exports);
+// I1 · suite del beneficio (tenant de FiadoLend/FiadoRetail)
+__exportStar(require("./dtos/BenefitSuiteConfigRequest"), exports);
+__exportStar(require("./dtos/BenefitSuiteResponse"), exports);
 __exportStar(require("./dtos/BannerTranslationRequest"), exports);
 __exportStar(require("./dtos/BannerTranslationsRequest"), exports);
 __exportStar(require("./dtos/BannerContentRequest"), exports);

package/bin/index.d.ts

@@ -115,3 +115,4 @@ export * as UserConfirmations from './userConfirmations';
 export * as PeopleBusiness from './peopleBusiness';
 export * as WebhookBusiness from './webhookBusiness';
 export * as Membership from './membership';
+export * as RetailLoanConnector from './retailLoanConnector';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = exports.Blacklist = 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.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = 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.DatalakeQuery = exports.RetailWizard = exports.RetailCustomer = 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.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 = void 0;
-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 = void 0;
+exports.RetailLoanConnector = 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 = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -219,3 +219,6 @@ exports.WebhookBusiness = __importStar(require("./webhookBusiness"));
 // (MembershipDirectoryUser_GT). Espeja al dominio `services`, que modela lo mismo para
 // servicios de terceros.
 exports.Membership = __importStar(require("./membership"));
+// RetailLoanConnector: contrato público de retail-loan-connector (I1), la puerta de la App Fiado
+// hacia las suites FiadoLend/FiadoRetail. Montos en pesos; el conector convierte desde centavos.
+exports.RetailLoanConnector = __importStar(require("./retailLoanConnector"));

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

@@ -0,0 +1,31 @@
+import { WizardSessionLookupStatusEnum } from '../../../retailWizard/enums/WizardSessionLookupStatusEnum';
+/**
+ * Por qué una columna del contexto de venta salió sin dato. Catálogo CERRADO y propio: nunca
+ * repite el mensaje del lambda vecino, que puede traer datos que este silo no controla.
+ */
+export type SaleContextReason = 'CREDIT_WITHOUT_WIZARD_SESSION' | 'WIZARD_LOOKUP_FAILED' | 'BORROWER_LOOKUP_FAILED' | 'BORROWER_NOT_FOUND' | 'CUSTOMER_ANCHOR_MISSING' | 'CUSTOMER_NAME_LOOKUP_FAILED' | 'CUSTOMER_NOT_FOUND' | 'CUSTOMER_WITHOUT_NAME' | 'STORE_ROSTER_FAILED' | 'STORE_NOT_IN_ROSTER' | 'RETAILER_UNKNOWN';
+/**
+ * Cliente, equipo y tienda de la venta que originó el crédito (loan-credit-business). Son CUATRO
+ * lecturas y cada una lleva su estado: `status` es el del lote al wizard (gobierna las columnas del
+ * equipo), `retailCustomerStatus` el del ancla del cliente, `customerNameStatus` el de su nombre y
+ * `storeNameStatus` el del nombre de la tienda. `NOT_FOUND` y `UNAVAILABLE` NUNCA se colapsan.
+ */
+export interface CreditSaleContext {
+    status: WizardSessionLookupStatusEnum;
+    reason?: SaleContextReason;
+    retailCustomerId: string | null;
+    retailCustomerStatus: WizardSessionLookupStatusEnum;
+    retailCustomerReason?: SaleContextReason;
+    /** PII: nunca se loguea. */
+    customerName: string | null;
+    customerNameStatus: WizardSessionLookupStatusEnum;
+    customerNameReason?: SaleContextReason;
+    productBrand: string | null;
+    productModel: string | null;
+    productCapacity: string | null;
+    retailerId: string | null;
+    storeId: string | null;
+    storeName: string | null;
+    storeNameStatus: WizardSessionLookupStatusEnum;
+    storeNameReason?: SaleContextReason;
+}

package/bin/loanCredit/dtos/responses/CreditSaleContext.js

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

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

@@ -0,0 +1,17 @@
+import { LoanCreditResponse } from './LoanCreditResponse';
+import { CreditSaleContext } from './CreditSaleContext';
+/**
+ * Un crédito de un acreditado (loan-credit-business): el `LoanCreditResponse` MÁS las cifras de su
+ * plan y el contexto de su venta. Montos en cents · instantes ISO-8601 · dueDates `YYYY-MM-DD`.
+ */
+export interface LoanBorrowerCreditItem extends LoanCreditResponse {
+    /** Cupones cubiertos: pagados y pagados por adelantado. La reestructurada no cuenta. */
+    paidInstallments: number;
+    /** `null` = no aplica (el crédito se canceló o caducó); `0` = ya no debe nada. */
+    outstandingBalanceCents: 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`. */
+    overdueAmountCents: number | null;
+    saleContext: CreditSaleContext;
+}

package/bin/loanCredit/dtos/responses/LoanBorrowerCreditItem.js

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

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

@@ -0,0 +1,9 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+/** Enlace prefirmado y temporal del PDF de un contrato. `expiresAt` en ISO-8601. */
+export interface LoanContractDownloadUrl {
+    contractId: string;
+    creditId: string;
+    type: ContractTypeEnum;
+    url: string;
+    expiresAt: string;
+}

package/bin/loanCredit/dtos/responses/LoanContractDownloadUrl.js

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

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

@@ -0,0 +1,21 @@
+import { SaleFinancierEnum } from '../../../retailWizard/enums/SaleFinancierEnum';
+import { LoanCreditResponse } from './LoanCreditResponse';
+import { CreditSaleContext } from './CreditSaleContext';
+/**
+ * Detalle de UN crédito (loan-credit-business): el `LoanCreditResponse` MÁS las cifras de su plan,
+ * el equipo y el contexto de su venta. Montos en cents · instantes ISO-8601.
+ */
+export interface LoanCreditDetail extends LoanCreditResponse {
+    /** SKU del equipo financiado, congelado al originar. Ausente en créditos anteriores a 2026-08. */
+    productSku?: string;
+    /** Tienda que originó la venta. Ausente en créditos anteriores a 2026-08. */
+    storeId?: string;
+    financier: SaleFinancierEnum;
+    paidInstallments: number;
+    outstandingBalanceCents: number | null;
+    overdueDays: number | null;
+    overdueAmountCents: number | null;
+    /** Cuotas vencidas impagas. `0` = nada vencido; `null` acompaña a `overdueDays` en null. */
+    overdueInstallments: number | null;
+    saleContext: CreditSaleContext;
+}

package/bin/loanCredit/dtos/responses/LoanCreditDetail.js

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

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

@@ -0,0 +1,32 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
+import { MechanismType } from '../../../collection/enums/MechanismType';
+import { CurrencyId } from '../../../currency/enums/CurrencyId';
+/** Un pago del historial de un crédito, tal como lo asentó el motor de cobro en `LoanPayment_GT`. */
+export interface LoanPaymentListItem {
+    paymentId: string;
+    /** Folio del pago — la referencia de conciliación. */
+    receipt: string;
+    installmentNumber: number;
+    attemptId: string;
+    mechanism: MechanismType;
+    result: CollectionResultStatus;
+    currency: CurrencyId;
+    collectedCents: number;
+    /** Lo que de verdad se abonó a la cuota. */
+    appliedCents: number;
+    overpaidCents: number;
+    reservedCents: number;
+    needsReview: boolean;
+    appliedAt: string;
+    /** Capital que abonó este pago. Ausente en pagos anteriores al desglose (I1). */
+    appliedCapitalCents?: number;
+    /** Interés que abonó este pago. Ausente en pagos anteriores al desglose (I1). */
+    appliedInterestCents?: number;
+    /** IVA del interés que abonó este pago. Ausente en pagos anteriores al desglose (I1). */
+    appliedIvaCents?: number;
+}
+/** Página del historial. El fin lo marca la AUSENCIA de `nextToken`, nunca una página corta. */
+export interface LoanPaymentListResponse {
+    items: LoanPaymentListItem[];
+    nextToken?: string;
+}

package/bin/loanCredit/dtos/responses/LoanPaymentListItem.js

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

package/bin/loanCredit/index.d.ts

@@ -29,6 +29,11 @@ export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 export * from './dtos/responses/LoanBorrowerResponse';
 export * from './dtos/responses/LoanCreditResponse';
 export * from './dtos/responses/LoanInstallmentResponse';
+export * from './dtos/responses/CreditSaleContext';
+export * from './dtos/responses/LoanBorrowerCreditItem';
+export * from './dtos/responses/LoanCreditDetail';
+export * from './dtos/responses/LoanPaymentListItem';
+export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractResponse';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';

package/bin/loanCredit/index.js

@@ -52,6 +52,12 @@ __exportStar(require("./dtos/requests/ChangeLoanCreditStatusRequest"), exports);
 __exportStar(require("./dtos/responses/LoanBorrowerResponse"), exports);
 __exportStar(require("./dtos/responses/LoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/LoanInstallmentResponse"), exports);
+// Lectura de cliente (I1 · retail-loan-connector): antes locales de loan-credit-business
+__exportStar(require("./dtos/responses/CreditSaleContext"), exports);
+__exportStar(require("./dtos/responses/LoanBorrowerCreditItem"), exports);
+__exportStar(require("./dtos/responses/LoanCreditDetail"), exports);
+__exportStar(require("./dtos/responses/LoanPaymentListItem"), exports);
+__exportStar(require("./dtos/responses/LoanContractDownloadUrl"), exports);
 __exportStar(require("./dtos/responses/LoanContractResponse"), exports);
 __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);

package/bin/retailLoanConnector/dtos/MyCreditDetail.d.ts

@@ -0,0 +1,20 @@
+import { MyCreditSummary } from './MyCreditSummary';
+/** La próxima cuota abierta. `isOverdue` si su estado en loan-credit es OVERDUE. */
+export interface MyNextInstallment {
+    number: number;
+    dueDate: string;
+    amount: number;
+    isOverdue: boolean;
+}
+/** Detalle de un crédito (`GET /benefits/{benefitId}/credits/{creditId}`). Montos en pesos. */
+export interface MyCreditDetail extends MyCreditSummary {
+    equipmentPrice: number;
+    downPayment: number;
+    financedAmount: number;
+    /** Tasa anual ordinaria tal como la guarda loan-credit (`tnaAnnual`). */
+    annualRate: number;
+    activatedAt?: string;
+    firstDueDate?: string;
+    lastDueDate?: string;
+    nextInstallment?: MyNextInstallment;
+}

package/bin/retailLoanConnector/dtos/MyCreditDetail.js

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

package/bin/retailLoanConnector/dtos/MyCreditSummary.d.ts

@@ -0,0 +1,29 @@
+import { LoanCreditStatusEnum } from '../../loanCredit/enums/LoanCreditStatusEnum';
+import { MyPaymentFrequencyEnum } from '../enums/MyPaymentFrequencyEnum';
+/** Equipo financiado. Cada campo puede faltar si el contexto de venta no se pudo leer. */
+export interface MyDevice {
+    brand: string | null;
+    model: string | null;
+    capacity: string | null;
+}
+/** Atraso del crédito. Montos en pesos. `installments` solo viene en el detalle. */
+export interface MyOverdue {
+    amount: number;
+    days: number;
+    installments?: number;
+}
+/**
+ * Un crédito del cliente en la lista (`GET /benefits/{benefitId}/credits`). Montos en pesos con
+ * 2 decimales (DEC-007). `remainingBalance` `null` = no aplica (crédito que nunca contrajo deuda).
+ */
+export interface MyCreditSummary {
+    creditId: string;
+    status: LoanCreditStatusEnum;
+    device: MyDevice;
+    paymentFrequency: MyPaymentFrequencyEnum;
+    installmentAmount: number;
+    totalInstallments: number;
+    paidInstallments: number;
+    remainingBalance: number | null;
+    overdue?: MyOverdue;
+}

package/bin/retailLoanConnector/dtos/MyCreditSummary.js

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

package/bin/retailLoanConnector/dtos/MyDocument.d.ts

@@ -0,0 +1,21 @@
+import { ContractTypeEnum } from '../../loanCredit/enums/ContractTypeEnum';
+import { MyDocumentGroupIdEnum } from '../enums/MyDocumentGroupIdEnum';
+import { MyDocumentKindEnum } from '../enums/MyDocumentKindEnum';
+import { MyDocumentStatusEnum } from '../enums/MyDocumentStatusEnum';
+/**
+ * Un documento del crédito. `documentRef` sigue la convención del módulo de la app:
+ * `doc-contract-<contractId>` para contratos y `doc-stmt-YYYY-MM` para estados de cuenta.
+ */
+export interface MyDocument {
+    documentRef: string;
+    kind: MyDocumentKindEnum;
+    type?: ContractTypeEnum;
+    /** `YYYY-MM`, solo en estados de cuenta. */
+    period?: string;
+    issuedAt?: string;
+    status: MyDocumentStatusEnum;
+}
+export interface MyDocumentGroup {
+    id: MyDocumentGroupIdEnum;
+    documents: MyDocument[];
+}