@fiado/type-kit 3.493.0 → 3.494.0

package/_test_/unit/remittance/RemittanceUnitellerSnapshot.test.ts

@@ -0,0 +1,75 @@
+import type {
+    RemittanceMonthlySection,
+    RemittanceOrphanRow,
+    RemittancePoolBalanceSection,
+    RemittanceSnapshotSection,
+    RemittanceUnitellerSnapshot,
+} from "../../../src/remittance/dtos/RemittanceUnitellerSnapshot";
+
+// Interfaces TypeScript puros sin class-validator — el valor del test es:
+// (a) compile-time check de que la shape es la esperada (si cambia, falla build)
+// (b) fixture canonico que docs el shape para consumers (fiado-dashboard).
+// Si el consolidator server-side produce algo que no matchea esto, falla el type-check en el dashboard.
+
+describe("RemittanceUnitellerSnapshot shape", () => {
+    const emptySection: RemittanceSnapshotSection = {
+        ok: 0, soloFiado: 0, soloUniteller: 0,
+        diffMonto: 0, diffFx: 0, diffCost: 0, diffRate: 0,
+        totalMontoUsd: 0,
+    };
+
+    const poolBalance: RemittancePoolBalanceSection = {
+        balanceUsd: 125428.75,
+        reportedBalanceUsd: 125430.5,
+        diffUsd: -1.75,
+        asOf: "2026-10-02",
+        staleness: "FRESH",
+    };
+
+    const orphan: RemittanceOrphanRow = {
+        txIdentifier: "5649809531",
+        statementDate: "2026-10-02",
+        reportType: "TX_DETAILS",
+        amountUsd: 500,
+        processingFee: 3,
+    };
+
+    const monthlySection: RemittanceMonthlySection = {
+        envios: emptySection,
+        cancels: emptySection,
+        itemsUrl: "https://admin-dashboard.fiado.online/conciliacion/pago-confiado/uniteller?mes=2026-10",
+    };
+
+    const snapshot: RemittanceUnitellerSnapshot = {
+        calculatedAt: "2026-10-02T19:00:00.000Z",
+        envios: emptySection,
+        cancels: emptySection,
+        poolBalance,
+        orphans: [orphan],
+        byMonth: { "2026-10": monthlySection },
+    };
+
+    it("estructura canonica con todos los campos required", () => {
+        expect(snapshot.calculatedAt).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/);
+        expect(snapshot.envios).toBe(emptySection);
+        expect(snapshot.cancels).toBe(emptySection);
+        expect(snapshot.poolBalance).toBe(poolBalance);
+        expect(snapshot.orphans).toHaveLength(1);
+        expect(snapshot.byMonth["2026-10"]).toBe(monthlySection);
+    });
+
+    it("itemsUrl es opcional en RemittanceMonthlySection", () => {
+        const withoutUrl: RemittanceMonthlySection = { envios: emptySection, cancels: emptySection };
+        expect(withoutUrl.itemsUrl).toBeUndefined();
+    });
+
+    it("staleness acepta los 3 valores del union", () => {
+        const states: Array<RemittancePoolBalanceSection["staleness"]> = ["FRESH", "STALE", "MISSING"];
+        expect(states).toEqual(["FRESH", "STALE", "MISSING"]);
+    });
+
+    it("reportType acepta los 3 valores del union", () => {
+        const types: Array<RemittanceOrphanRow["reportType"]> = ["TX_DETAILS", "CANCEL_TX", "VOID_TX"];
+        expect(types).toEqual(["TX_DETAILS", "CANCEL_TX", "VOID_TX"]);
+    });
+});

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

@@ -1,6 +1,7 @@
 import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { MechanismType } from '../../../collection/enums/MechanismType';
 import { CurrencyId } from '../../../currency/enums/CurrencyId';
+import { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
 /** Un pago del historial de un crédito, tal como lo asentó el motor de cobro en `LoanPayment_GT`. */
 export interface LoanPaymentListItem {
     paymentId: string;
@@ -24,6 +25,10 @@ export interface LoanPaymentListItem {
     appliedInterestCents?: number;
     /** IVA del interés que abonó este pago. Ausente en pagos anteriores al desglose (I1). */
     appliedIvaCents?: number;
+    /** Qué cobró el pago: cuota, abono a capital, adelanto, liquidación o recuperación. Ausente en pagos viejos. */
+    chargeKind?: LoanChargeKindEnum;
+    /** Saldo de capital del crédito después de este pago. Ausente en pagos viejos. */
+    creditPrincipalBalanceAfterCents?: number;
 }
 /** Página del historial. El fin lo marca la AUSENCIA de `nextToken`, nunca una página corta. */
 export interface LoanPaymentListResponse {

package/bin/remittance/dtos/RemittanceUnitellerSnapshot.d.ts

@@ -0,0 +1,37 @@
+export interface RemittanceSnapshotSection {
+    ok: number;
+    soloFiado: number;
+    soloUniteller: number;
+    diffMonto: number;
+    diffFx: number;
+    diffCost: number;
+    diffRate: number;
+    totalMontoUsd: number;
+}
+export interface RemittancePoolBalanceSection {
+    balanceUsd: number;
+    reportedBalanceUsd: number;
+    diffUsd: number;
+    asOf: string;
+    staleness: "FRESH" | "STALE" | "MISSING";
+}
+export interface RemittanceOrphanRow {
+    txIdentifier: string;
+    statementDate: string;
+    reportType: "TX_DETAILS" | "CANCEL_TX" | "VOID_TX";
+    amountUsd: number;
+    processingFee: number;
+}
+export interface RemittanceMonthlySection {
+    envios: RemittanceSnapshotSection;
+    cancels: RemittanceSnapshotSection;
+    itemsUrl?: string;
+}
+export interface RemittanceUnitellerSnapshot {
+    calculatedAt: string;
+    envios: RemittanceSnapshotSection;
+    cancels: RemittanceSnapshotSection;
+    poolBalance: RemittancePoolBalanceSection;
+    orphans: RemittanceOrphanRow[];
+    byMonth: Record<string, RemittanceMonthlySection>;
+}

package/bin/remittance/dtos/RemittanceUnitellerSnapshot.js

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

package/bin/remittance/dtos/index.d.ts

@@ -53,3 +53,4 @@ export * from "./RemittanceFavoriteItem";
 export * from "./RemittanceFavoriteListResponse";
 export * from "./RemittanceBackofficeCancelCloseRequest";
 export * from "./RemittanceBackofficeCancelCloseResponse";
+export * from "./RemittanceUnitellerSnapshot";

package/bin/remittance/dtos/index.js

@@ -69,3 +69,4 @@ __exportStar(require("./RemittanceFavoriteItem"), exports);
 __exportStar(require("./RemittanceFavoriteListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeCancelCloseRequest"), exports);
 __exportStar(require("./RemittanceBackofficeCancelCloseResponse"), exports);
+__exportStar(require("./RemittanceUnitellerSnapshot"), exports);

package/package.json

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

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

@@ -1,6 +1,7 @@
 import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { MechanismType } from '../../../collection/enums/MechanismType';
 import { CurrencyId } from '../../../currency/enums/CurrencyId';
+import { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
 
 /** Un pago del historial de un crédito, tal como lo asentó el motor de cobro en `LoanPayment_GT`. */
 export interface LoanPaymentListItem {
@@ -25,6 +26,10 @@ export interface LoanPaymentListItem {
     appliedInterestCents?: number;
     /** IVA del interés que abonó este pago. Ausente en pagos anteriores al desglose (I1). */
     appliedIvaCents?: number;
+    /** Qué cobró el pago: cuota, abono a capital, adelanto, liquidación o recuperación. Ausente en pagos viejos. */
+    chargeKind?: LoanChargeKindEnum;
+    /** Saldo de capital del crédito después de este pago. Ausente en pagos viejos. */
+    creditPrincipalBalanceAfterCents?: number;
 }
 
 /** Página del historial. El fin lo marca la AUSENCIA de `nextToken`, nunca una página corta. */

package/src/remittance/dtos/RemittanceUnitellerSnapshot.ts

@@ -0,0 +1,41 @@
+export interface RemittanceSnapshotSection {
+    ok: number;
+    soloFiado: number;
+    soloUniteller: number;
+    diffMonto: number;
+    diffFx: number;
+    diffCost: number;
+    diffRate: number;
+    totalMontoUsd: number;
+}
+
+export interface RemittancePoolBalanceSection {
+    balanceUsd: number;
+    reportedBalanceUsd: number;
+    diffUsd: number;
+    asOf: string;                        // YYYY-MM-DD | "N/A"
+    staleness: "FRESH" | "STALE" | "MISSING";
+}
+
+export interface RemittanceOrphanRow {
+    txIdentifier: string;
+    statementDate: string;               // YYYY-MM-DD
+    reportType: "TX_DETAILS" | "CANCEL_TX" | "VOID_TX";
+    amountUsd: number;
+    processingFee: number;
+}
+
+export interface RemittanceMonthlySection {
+    envios: RemittanceSnapshotSection;
+    cancels: RemittanceSnapshotSection;
+    itemsUrl?: string;                   // opcional — link a la vista de detalle
+}
+
+export interface RemittanceUnitellerSnapshot {
+    calculatedAt: string;                // ISO UTC
+    envios: RemittanceSnapshotSection;
+    cancels: RemittanceSnapshotSection;
+    poolBalance: RemittancePoolBalanceSection;
+    orphans: RemittanceOrphanRow[];
+    byMonth: Record<string, RemittanceMonthlySection>;   // key = "YYYY-MM"
+}

package/src/remittance/dtos/index.ts

@@ -53,3 +53,4 @@ export * from "./RemittanceFavoriteItem";
 export * from "./RemittanceFavoriteListResponse";
 export * from "./RemittanceBackofficeCancelCloseRequest";
 export * from "./RemittanceBackofficeCancelCloseResponse";
+export * from "./RemittanceUnitellerSnapshot";