@fiado/type-kit 3.494.0 → 3.495.0

package/_test_/unit/loanCredit/dtos/originateLoanCreditRequest.test.ts

@@ -0,0 +1,56 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { OriginateLoanCreditRequest } from '../../../../src/loanCredit/dtos/requests/OriginateLoanCreditRequest';
+
+const BASE = {
+    wizardSessionId: 'WS-1',
+    borrowerId: 'B-1',
+    planId: 'PLAN-1',
+    termWeeks: 12,
+    equipmentPriceCents: 500000,
+    downPaymentCents: 100000,
+    storeId: 'ST-1',
+};
+
+/** Igual que `validateRequest` del motor: whitelist sin rechazar extras. */
+const validateWhitelisted = (body: object) => {
+    const dto = plainToInstance(OriginateLoanCreditRequest, body);
+    return validate(dto, { whitelist: true, forbidNonWhitelisted: false }).then((errors) => ({ dto, errors }));
+};
+
+describe('OriginateLoanCreditRequest', () => {
+    it('acepta el request con tienda y vendedor y conserva los dos', async () => {
+        const { dto, errors } = await validateWhitelisted({ ...BASE, sellerId: 'U-1' });
+
+        expect(errors).toEqual([]);
+        expect(dto.storeId).toBe('ST-1');
+        expect(dto.sellerId).toBe('U-1');
+    });
+
+    it('rechaza el request sin tienda: sin ella el motor no resuelve la promoción ni la cartera', async () => {
+        const { storeId: _omitted, ...withoutStore } = BASE;
+        const { errors } = await validateWhitelisted(withoutStore);
+
+        expect(errors.some((error) => error.property === 'storeId')).toBe(true);
+    });
+
+    it('rechaza la tienda vacía', async () => {
+        const { errors } = await validateWhitelisted({ ...BASE, storeId: '' });
+
+        expect(errors.some((error) => error.property === 'storeId')).toBe(true);
+    });
+
+    it('acepta el request sin vendedor: los créditos viejos los llena el backfill', async () => {
+        const { dto, errors } = await validateWhitelisted(BASE);
+
+        expect(errors).toEqual([]);
+        expect(dto.sellerId).toBeUndefined();
+    });
+
+    it('rechaza el vendedor vacío: un sellerId en blanco sería una llave de GSI inválida', async () => {
+        const { errors } = await validateWhitelisted({ ...BASE, sellerId: '' });
+
+        expect(errors.some((error) => error.property === 'sellerId')).toBe(true);
+    });
+});

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

@@ -0,0 +1,119 @@
+import 'reflect-metadata';
+import type { CreditSaleContext } from '../../../src/loanCredit/index';
+import type { WizardSessionLookupEntry } from '../../../src/retailWizard/index';
+import { WizardSessionLookupStatusEnum } from '../../../src/retailWizard/enums/WizardSessionLookupStatusEnum';
+import {
+    LoanCreditStatusEnum,
+    LoanInstallmentStatusEnum,
+    type SellerCreditDetailResponse,
+    type SellerCreditListResponse,
+    type SellerCreditRow,
+} from '../../../src/loanCredit/index';
+
+describe('loanCredit — contrato de la cartera del vendedor', () => {
+    it('el contexto de venta publica la venta que cerró la sesión', () => {
+        const context: CreditSaleContext = {
+            status: WizardSessionLookupStatusEnum.OK,
+            retailCustomerId: 'RC-1',
+            retailCustomerStatus: WizardSessionLookupStatusEnum.OK,
+            customerName: null,
+            customerNameStatus: WizardSessionLookupStatusEnum.OK,
+            productBrand: 'Samsung',
+            productModel: 'A15',
+            productCapacity: null,
+            retailerId: 'R-1',
+            storeId: 'ST-1',
+            storeName: null,
+            storeNameStatus: WizardSessionLookupStatusEnum.OK,
+            saleId: 'S-1',
+        };
+
+        expect(context.saleId).toBe('S-1');
+    });
+
+    it('la entrada del lote del wizard publica al vendedor de la sesión', () => {
+        const entry: WizardSessionLookupEntry = {
+            wizardSessionId: 'WS-1',
+            status: WizardSessionLookupStatusEnum.OK,
+            sellerRetailUserId: 'U-1',
+        };
+
+        expect(entry.sellerRetailUserId).toBe('U-1');
+    });
+
+    const saleContext: CreditSaleContext = {
+        status: WizardSessionLookupStatusEnum.OK,
+        retailCustomerId: 'RC-1',
+        retailCustomerStatus: WizardSessionLookupStatusEnum.OK,
+        customerName: 'Ana López',
+        customerNameStatus: WizardSessionLookupStatusEnum.OK,
+        productBrand: 'Samsung',
+        productModel: 'A15',
+        productCapacity: null,
+        retailerId: 'R-1',
+        storeId: 'ST-1',
+        storeName: null,
+        storeNameStatus: WizardSessionLookupStatusEnum.OK,
+        saleId: 'S-1',
+    };
+
+    it('la fila de la cartera lleva el resumen del plan y la cuota vigente', () => {
+        const row: SellerCreditRow = {
+            creditId: 'CR-1',
+            status: LoanCreditStatusEnum.ACTIVE,
+            termWeeks: 12,
+            equipmentPriceCents: 500000,
+            imei: '356789012345678',
+            createdAt: '2026-09-01T00:00:00.000Z',
+            summaryUnavailable: false,
+            paidInstallments: 1,
+            outstandingBalanceCents: 300000,
+            overdueDays: 0,
+            overdueAmountCents: 0,
+            currentInstallment: {
+                creditId: 'CR-1',
+                installmentNumber: 2,
+                status: LoanInstallmentStatusEnum.PENDING,
+                dueDate: '2026-10-05',
+                capitalCents: 8000,
+                interestCents: 1500,
+                ivaCents: 500,
+                totalCents: 10000,
+                outstandingBalanceCents: 10000,
+            },
+            saleContext,
+        };
+        const list: SellerCreditListResponse = { items: [row], count: 1, truncated: false };
+
+        expect(list.items[0]?.currentInstallment?.installmentNumber).toBe(2);
+    });
+
+    it('la fila sin plan legible declara summaryUnavailable y deja las cifras en null', () => {
+        const row: SellerCreditRow = {
+            creditId: 'CR-2',
+            status: LoanCreditStatusEnum.IN_ARREARS,
+            termWeeks: 12,
+            equipmentPriceCents: 500000,
+            createdAt: '2026-09-01T00:00:00.000Z',
+            summaryUnavailable: true,
+            paidInstallments: null,
+            outstandingBalanceCents: null,
+            overdueDays: null,
+            overdueAmountCents: null,
+            currentInstallment: null,
+            saleContext,
+        };
+
+        expect(row.paidInstallments).toBeNull();
+    });
+
+    it('el detalle es el crédito, su plan y sus últimos cobros', () => {
+        const detail: SellerCreditDetailResponse = {
+            credit: {} as SellerCreditDetailResponse['credit'],
+            installments: [],
+            recentPayments: [],
+        };
+
+        expect(detail.recentPayments).toEqual([]);
+    });
+});

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

@@ -30,10 +30,14 @@ export declare class OriginateLoanCreditRequest {
     imei?: string;
     /**
      * Tienda donde se vende. El motor la persiste y la reenvía al simulador del catálogo en cada
-     * cotización — al RE-cotizar el wizard no la vuelve a mandar, así que sin guardarla la venta
-     * perdería su promoción a mitad del paso 06.
+     * cotización. Obligatoria: sin ella el crédito no tiene tienda en su cartera.
      */
-    storeId?: string;
+    storeId: string;
+    /**
+     * Vendedor que origina: el `retailUserId` de retail-org que la sesión del wizard guarda como
+     * `sellerRetailUserId`. Llave de la cartera del vendedor en loan-credit.
+     */
+    sellerId?: string;
     /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
     productSku?: string;
 }

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

@@ -91,10 +91,17 @@ __decorate([
 ], OriginateLoanCreditRequest.prototype, "imei", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], OriginateLoanCreditRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "sellerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -28,4 +28,6 @@ export interface CreditSaleContext {
     storeName: string | null;
     storeNameStatus: WizardSessionLookupStatusEnum;
     storeNameReason?: SaleContextReason;
+    /** Venta que cerró la sesión. `null` si no cerró; ausente si el lote al wizard no respondió. */
+    saleId?: string | null;
 }

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

@@ -0,0 +1,10 @@
+import { LoanCreditDetail } from './LoanCreditDetail';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+import { LoanPaymentListItem } from './LoanPaymentListItem';
+/** Detalle de un crédito propio del vendedor (`GET /seller/credits/{creditId}`): crédito, plan y últimos cobros. */
+export interface SellerCreditDetailResponse {
+    credit: LoanCreditDetail;
+    installments: LoanInstallmentResponse[];
+    /** Los últimos cobros asentados, del más reciente al más viejo (máximo 3). */
+    recentPayments: LoanPaymentListItem[];
+}

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

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

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

@@ -0,0 +1,7 @@
+import { SellerCreditRow } from './SellerCreditRow';
+/** La cartera viva COMPLETA del vendedor, sin paginar. `truncated` = se alcanzó el tope de lectura. */
+export interface SellerCreditListResponse {
+    items: SellerCreditRow[];
+    count: number;
+    truncated: boolean;
+}

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

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

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

@@ -0,0 +1,25 @@
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { CreditSaleContext } from './CreditSaleContext';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+/**
+ * Una fila de la cartera del vendedor (`GET /seller/credits`, loan-credit-business). Montos en
+ * cents · instantes ISO-8601. Con `summaryUnavailable` las cifras del plan llegan en `null`, nunca en cero.
+ */
+export interface SellerCreditRow {
+    creditId: string;
+    status: LoanCreditStatusEnum;
+    termWeeks: number;
+    equipmentPriceCents: number;
+    clientLevelAtOrigination?: ClientLevelEnum;
+    imei?: string;
+    createdAt: string;
+    summaryUnavailable: boolean;
+    paidInstallments: number | null;
+    outstandingBalanceCents: 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ó. */
+    currentInstallment: LoanInstallmentResponse | null;
+    saleContext: CreditSaleContext;
+}

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

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

package/bin/loanCredit/index.d.ts

@@ -40,6 +40,9 @@ export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';
 export * from './dtos/responses/ActivationCheckResponse';
+export * from './dtos/responses/SellerCreditRow';
+export * from './dtos/responses/SellerCreditListResponse';
+export * from './dtos/responses/SellerCreditDetailResponse';
 export * from './enums/LoanDeviceMdmStatusEnum';
 export * from './enums/LoanDeviceLockReasonEnum';
 export { MdmOperationStatusEnum } from '../mdm/enums/MdmOperationStatusEnum';

package/bin/loanCredit/index.js

@@ -64,6 +64,10 @@ __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/SignLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/ActivationCheckResponse"), exports);
+// Cartera del vendedor (pantalla Cobro del Portal Vendedor)
+__exportStar(require("./dtos/responses/SellerCreditRow"), exports);
+__exportStar(require("./dtos/responses/SellerCreditListResponse"), exports);
+__exportStar(require("./dtos/responses/SellerCreditDetailResponse"), exports);
 // Device / MDM — contrato hacia los callers de loan-credit
 __exportStar(require("./enums/LoanDeviceMdmStatusEnum"), exports);
 __exportStar(require("./enums/LoanDeviceLockReasonEnum"), exports);

package/bin/retailWizard/dtos/WizardSessionLookupEntry.d.ts

@@ -24,4 +24,6 @@ export interface WizardSessionLookupEntry {
     /** La venta que cerro esta sesion; `null` si todavia no cerro. */
     saleId?: string | null;
     folio?: string | null;
+    /** Vendedor de la sesión (`retailUserId` de retail-org). `null` si la sesión no lo tiene. */
+    sellerRetailUserId?: string | null;
 }

package/package.json

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

package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts

@@ -84,13 +84,22 @@ export class OriginateLoanCreditRequest {
 
     /**
      * Tienda donde se vende. El motor la persiste y la reenvía al simulador del catálogo en cada
-     * cotización — al RE-cotizar el wizard no la vuelve a mandar, así que sin guardarla la venta
-     * perdería su promoción a mitad del paso 06.
+     * cotización. Obligatoria: sin ella el crédito no tiene tienda en su cartera.
+     */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    /**
+     * Vendedor que origina: el `retailUserId` de retail-org que la sesión del wizard guarda como
+     * `sellerRetailUserId`. Llave de la cartera del vendedor en loan-credit.
      */
     @Expose()
     @IsOptional()
     @IsString()
-    storeId?: string;
+    @IsNotEmpty()
+    sellerId?: string;
 
     /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
     @Expose()

package/src/loanCredit/dtos/responses/CreditSaleContext.ts

@@ -41,4 +41,6 @@ export interface CreditSaleContext {
     storeName: string | null;
     storeNameStatus: WizardSessionLookupStatusEnum;
     storeNameReason?: SaleContextReason;
+    /** Venta que cerró la sesión. `null` si no cerró; ausente si el lote al wizard no respondió. */
+    saleId?: string | null;
 }

package/src/loanCredit/dtos/responses/SellerCreditDetailResponse.ts

@@ -0,0 +1,11 @@
+import { LoanCreditDetail } from './LoanCreditDetail';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+import { LoanPaymentListItem } from './LoanPaymentListItem';
+
+/** Detalle de un crédito propio del vendedor (`GET /seller/credits/{creditId}`): crédito, plan y últimos cobros. */
+export interface SellerCreditDetailResponse {
+    credit: LoanCreditDetail;
+    installments: LoanInstallmentResponse[];
+    /** Los últimos cobros asentados, del más reciente al más viejo (máximo 3). */
+    recentPayments: LoanPaymentListItem[];
+}

package/src/loanCredit/dtos/responses/SellerCreditListResponse.ts

@@ -0,0 +1,8 @@
+import { SellerCreditRow } from './SellerCreditRow';
+
+/** La cartera viva COMPLETA del vendedor, sin paginar. `truncated` = se alcanzó el tope de lectura. */
+export interface SellerCreditListResponse {
+    items: SellerCreditRow[];
+    count: number;
+    truncated: boolean;
+}

package/src/loanCredit/dtos/responses/SellerCreditRow.ts

@@ -0,0 +1,26 @@
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { CreditSaleContext } from './CreditSaleContext';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+
+/**
+ * Una fila de la cartera del vendedor (`GET /seller/credits`, loan-credit-business). Montos en
+ * cents · instantes ISO-8601. Con `summaryUnavailable` las cifras del plan llegan en `null`, nunca en cero.
+ */
+export interface SellerCreditRow {
+    creditId: string;
+    status: LoanCreditStatusEnum;
+    termWeeks: number;
+    equipmentPriceCents: number;
+    clientLevelAtOrigination?: ClientLevelEnum;
+    imei?: string;
+    createdAt: string;
+    summaryUnavailable: boolean;
+    paidInstallments: number | null;
+    outstandingBalanceCents: 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ó. */
+    currentInstallment: LoanInstallmentResponse | null;
+    saleContext: CreditSaleContext;
+}

package/src/loanCredit/index.ts

@@ -49,6 +49,10 @@ export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';
 export * from './dtos/responses/ActivationCheckResponse';
+// Cartera del vendedor (pantalla Cobro del Portal Vendedor)
+export * from './dtos/responses/SellerCreditRow';
+export * from './dtos/responses/SellerCreditListResponse';
+export * from './dtos/responses/SellerCreditDetailResponse';
 
 // Device / MDM — contrato hacia los callers de loan-credit
 export * from './enums/LoanDeviceMdmStatusEnum';

package/src/retailWizard/dtos/WizardSessionLookupEntry.ts

@@ -25,4 +25,6 @@ export interface WizardSessionLookupEntry {
     /** La venta que cerro esta sesion; `null` si todavia no cerro. */
     saleId?: string | null;
     folio?: string | null;
+    /** Vendedor de la sesión (`retailUserId` de retail-org). `null` si la sesión no lo tiene. */
+    sellerRetailUserId?: string | null;
 }