@fiado/type-kit 3.492.0 → 3.493.1

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/_test_/unit/retailWizard/creditPromotionBonusContract.test.ts

@@ -13,6 +13,16 @@ describe('bono de crédito en el contrato del wizard', () => {
         expect(session.creditPromotionBonus?.status).toBe('RESERVED');
     });
 
+    it('el bono RESERVED lleva el instante en que entró en reserva', () => {
+        const bonus: WizardCreditPromotionBonus = {
+            promotionId: 'promo-1',
+            amountCents: 5_000,
+            status: LoanOfferings.PromotionBonusStatusEnum.RESERVED,
+            pendingSince: '2026-10-02T15:00:00.000Z',
+        };
+        expect(bonus.pendingSince).toBe('2026-10-02T15:00:00.000Z');
+    });
+
     it('la sesión sin bono resuelto lo omite o lo manda null', () => {
         const absent: Pick<WizardSession, 'creditPromotionBonus'> = {};
         const nulled: Pick<WizardSession, 'creditPromotionBonus'> = { creditPromotionBonus: null };

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/bin/retailWizard/dtos/WizardCreditPromotionBonus.d.ts

@@ -5,4 +5,7 @@ export interface WizardCreditPromotionBonus {
     amountCents: number;
     /** `RESERVED` = en proceso; los otros tres son terminales. */
     status: PromotionBonusStatusEnum;
+    /** ISO 8601 del instante en que el bono entró en RESERVED por primera vez.
+     *  Lo sella el wizard una vez y no cambia después. */
+    pendingSince?: string;
 }

package/package.json

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

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";

package/src/retailWizard/dtos/WizardCreditPromotionBonus.ts

@@ -6,4 +6,7 @@ export interface WizardCreditPromotionBonus {
     amountCents: number;
     /** `RESERVED` = en proceso; los otros tres son terminales. */
     status: PromotionBonusStatusEnum;
+    /** ISO 8601 del instante en que el bono entró en RESERVED por primera vez.
+     *  Lo sella el wizard una vez y no cambia después. */
+    pendingSince?: string;
 }