@fiado/type-kit 3.640.0 → 3.641.0

package/_test_/unit/reconciliation/reconciliationShapes.test.ts

@@ -23,6 +23,25 @@ describe('formas del contrato', () => {
         expect(Object.keys(reversal)).not.toContain('sandbox');
     });
 
+    it('un registro marcado por su dueño como prueba trae sandbox', () => {
+        const test: Reconciliation.ReconciliationFeedRecord = {
+            recordId: 'pay-9', tenantId: 'surekeep', concept: ReconciliationFeedConceptEnum.INSTALLMENT_COLLECTION, matchKey: 'att-9',
+            amountCents: 100, currency: CurrencyId.MXN, occurredAt: '2026-10-20T15:00:00.000Z', feedDay: '2026-10-20', refs: {}, sandbox: true,
+        };
+        expect(test.sandbox).toBe(true);
+    });
+
+    it('RunCompleted y DiscrepancyFound tienen su detail-type', () => {
+        expect(Reconciliation.ReconciliationEventDetailTypeEnum.RECONCILIATION_RUN_COMPLETED).toBe('reconciliation.ReconciliationRunCompleted');
+        expect(Reconciliation.ReconciliationEventDetailTypeEnum.RECONCILIATION_DISCREPANCY_FOUND).toBe('reconciliation.ReconciliationDiscrepancyFound');
+        const found: Reconciliation.ReconciliationDiscrepancyFoundEventDetail = {
+            eventId: 'surekeep#m8-gateway-sofom#INSTALLMENT_COLLECTION#att-1', tenantId: 'surekeep', definitionId: 'm8-gateway-sofom',
+            itemKey: 'INSTALLMENT_COLLECTION#att-1', layer: ReconciliationLayerEnum.ITEM, state: ReconciliationItemStateEnum.MISSING_IN_EXECUTED,
+            periodKey: '2026-11-02', runId: 'run-1', foundAt: '2026-11-04T10:00:00.000Z',
+        };
+        expect(found.state).toBe('MISSING_IN_EXECUTED');
+    });
+
     it('el feed de notas usa la misma envoltura con sus registros', () => {
         const page: Reconciliation.PrivateListReconciliationFeedResponse<TransferNote.TransferNoteSettlementFeedRecord> = {
             records: [],

package/bin/reconciliation/dtos/ReconciliationFeedRecord.d.ts

@@ -39,4 +39,6 @@ export interface ReconciliationFeedRecord {
     feedDay: string;
     counterpartyType?: TransferNotePartyTypeEnum;
     refs: ReconciliationFeedRefs;
+    /** El dueño marca la operación de prueba; el motor la deja en TEST, fuera del cuadre. Sin el campo, es productiva. */
+    sandbox?: boolean;
 }

package/bin/reconciliation/events/ReconciliationDiscrepancyFoundEventDetail.d.ts

@@ -0,0 +1,17 @@
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+import { ReconciliationLayerEnum } from '../enums/ReconciliationLayerEnum';
+export declare class ReconciliationDiscrepancyFoundEventDetail {
+    /** Fijo por partida (`{tenantId}#{definitionId}#{itemKey}`): sale una vez y un reenvío llega con el mismo id. */
+    eventId: string;
+    tenantId: string;
+    definitionId: string;
+    itemKey: string;
+    layer: ReconciliationLayerEnum;
+    state: ReconciliationItemStateEnum;
+    periodKey: string;
+    differenceCents?: number;
+    counterpartyId?: string;
+    runId: string;
+    /** ISO 8601. */
+    foundAt: string;
+}

package/bin/reconciliation/events/ReconciliationDiscrepancyFoundEventDetail.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconciliationDiscrepancyFoundEventDetail = void 0;
+// `detail` de ReconciliationDiscrepancyFound: una partida entró en diferencia; sin datos personales.
+class ReconciliationDiscrepancyFoundEventDetail {
+}
+exports.ReconciliationDiscrepancyFoundEventDetail = ReconciliationDiscrepancyFoundEventDetail;

package/bin/reconciliation/events/ReconciliationItemMatchedEventDetail.d.ts

@@ -3,7 +3,11 @@ import { ReconciliationRuleTypeEnum } from '../enums/ReconciliationRuleTypeEnum'
 export declare const RECONCILIATION_EVENTS_SOURCE = "fiado.reconciliation";
 export declare enum ReconciliationEventDetailTypeEnum {
     /** Una partida BANK_STATEMENT con `refs.noteId` quedó en OK; sale una vez por partida. */
-    RECONCILIATION_ITEM_MATCHED = "reconciliation.ReconciliationItemMatched"
+    RECONCILIATION_ITEM_MATCHED = "reconciliation.ReconciliationItemMatched",
+    /** Una corrida terminó (COMPLETED o FAILED); sale una vez por intento de la corrida. */
+    RECONCILIATION_RUN_COMPLETED = "reconciliation.ReconciliationRunCompleted",
+    /** Una partida entró en diferencia; sale una vez por partida. */
+    RECONCILIATION_DISCREPANCY_FOUND = "reconciliation.ReconciliationDiscrepancyFound"
 }
 export declare class ReconciliationItemMatchedEventDetail {
     /** Fijo por partida: un reenvío llega con el mismo id y el consumidor lo descarta. */

package/bin/reconciliation/events/ReconciliationItemMatchedEventDetail.js

@@ -7,6 +7,10 @@ var ReconciliationEventDetailTypeEnum;
 (function (ReconciliationEventDetailTypeEnum) {
     /** Una partida BANK_STATEMENT con `refs.noteId` quedó en OK; sale una vez por partida. */
     ReconciliationEventDetailTypeEnum["RECONCILIATION_ITEM_MATCHED"] = "reconciliation.ReconciliationItemMatched";
+    /** Una corrida terminó (COMPLETED o FAILED); sale una vez por intento de la corrida. */
+    ReconciliationEventDetailTypeEnum["RECONCILIATION_RUN_COMPLETED"] = "reconciliation.ReconciliationRunCompleted";
+    /** Una partida entró en diferencia; sale una vez por partida. */
+    ReconciliationEventDetailTypeEnum["RECONCILIATION_DISCREPANCY_FOUND"] = "reconciliation.ReconciliationDiscrepancyFound";
 })(ReconciliationEventDetailTypeEnum || (exports.ReconciliationEventDetailTypeEnum = ReconciliationEventDetailTypeEnum = {}));
 // `detail` de ReconciliationItemMatched; transfer-note llena con él la confirmación de FSA.
 class ReconciliationItemMatchedEventDetail {

package/bin/reconciliation/events/ReconciliationRunCompletedEventDetail.d.ts

@@ -0,0 +1,27 @@
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+import { ReconciliationRuleTypeEnum } from '../enums/ReconciliationRuleTypeEnum';
+import { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStatusEnum';
+export declare class ReconciliationRunCompletedEventDetail {
+    /**
+     * Fijo por intento y resultado (`{tenantId}#{definitionId}#{runId}#{status}#{inicio del intento}`): un reenvío llega con el
+     * mismo id, y el reintento de una corrida FAILED (mismo `runId`) que termina COMPLETED llega con otro.
+     */
+    eventId: string;
+    tenantId: string;
+    definitionId: string;
+    runId: string;
+    periodKey: string;
+    ruleType: ReconciliationRuleTypeEnum;
+    status: ReconciliationRunStatusEnum;
+    countsByState: {
+        state: ReconciliationItemStateEnum;
+        count: number;
+    }[];
+    rejectedRecordCount: number;
+    /** Code de la causa cuando la corrida falló. */
+    failureCode?: string;
+    /** Llave del resumen en el bucket de conciliación (`{tenantId}/{definitionId}/{periodKey}/{layer}.json`). */
+    summaryObjectKey?: string;
+    /** ISO 8601. */
+    finishedAt: string;
+}

package/bin/reconciliation/events/ReconciliationRunCompletedEventDetail.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconciliationRunCompletedEventDetail = void 0;
+// `detail` de ReconciliationRunCompleted: el resultado de una corrida, sin datos personales.
+class ReconciliationRunCompletedEventDetail {
+}
+exports.ReconciliationRunCompletedEventDetail = ReconciliationRunCompletedEventDetail;

package/bin/reconciliation/index.d.ts

@@ -27,3 +27,5 @@ export * from './dtos/responses/ReconciliationResponses';
 export * from './dtos/responses/PrivateReconciliationResponses';
 export * from './dtos/responses/ReconciliationFeedResponses';
 export * from './events/ReconciliationItemMatchedEventDetail';
+export * from './events/ReconciliationRunCompletedEventDetail';
+export * from './events/ReconciliationDiscrepancyFoundEventDetail';

package/bin/reconciliation/index.js

@@ -49,3 +49,5 @@ __exportStar(require("./dtos/responses/PrivateReconciliationResponses"), exports
 __exportStar(require("./dtos/responses/ReconciliationFeedResponses"), exports);
 // Eventos
 __exportStar(require("./events/ReconciliationItemMatchedEventDetail"), exports);
+__exportStar(require("./events/ReconciliationRunCompletedEventDetail"), exports);
+__exportStar(require("./events/ReconciliationDiscrepancyFoundEventDetail"), exports);

package/package.json

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

package/src/reconciliation/dtos/ReconciliationFeedRecord.ts

@@ -41,4 +41,6 @@ export interface ReconciliationFeedRecord {
     feedDay: string;
     counterpartyType?: TransferNotePartyTypeEnum;
     refs: ReconciliationFeedRefs;
+    /** El dueño marca la operación de prueba; el motor la deja en TEST, fuera del cuadre. Sin el campo, es productiva. */
+    sandbox?: boolean;
 }

package/src/reconciliation/events/ReconciliationDiscrepancyFoundEventDetail.ts

@@ -0,0 +1,19 @@
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+import { ReconciliationLayerEnum } from '../enums/ReconciliationLayerEnum';
+
+// `detail` de ReconciliationDiscrepancyFound: una partida entró en diferencia; sin datos personales.
+export class ReconciliationDiscrepancyFoundEventDetail {
+    /** Fijo por partida (`{tenantId}#{definitionId}#{itemKey}`): sale una vez y un reenvío llega con el mismo id. */
+    eventId!: string;
+    tenantId!: string;
+    definitionId!: string;
+    itemKey!: string;
+    layer!: ReconciliationLayerEnum;
+    state!: ReconciliationItemStateEnum;
+    periodKey!: string;
+    differenceCents?: number;
+    counterpartyId?: string;
+    runId!: string;
+    /** ISO 8601. */
+    foundAt!: string;
+}

package/src/reconciliation/events/ReconciliationItemMatchedEventDetail.ts

@@ -7,6 +7,10 @@ export const RECONCILIATION_EVENTS_SOURCE = 'fiado.reconciliation';
 export enum ReconciliationEventDetailTypeEnum {
     /** Una partida BANK_STATEMENT con `refs.noteId` quedó en OK; sale una vez por partida. */
     RECONCILIATION_ITEM_MATCHED = 'reconciliation.ReconciliationItemMatched',
+    /** Una corrida terminó (COMPLETED o FAILED); sale una vez por intento de la corrida. */
+    RECONCILIATION_RUN_COMPLETED = 'reconciliation.ReconciliationRunCompleted',
+    /** Una partida entró en diferencia; sale una vez por partida. */
+    RECONCILIATION_DISCREPANCY_FOUND = 'reconciliation.ReconciliationDiscrepancyFound',
 }
 
 // `detail` de ReconciliationItemMatched; transfer-note llena con él la confirmación de FSA.

package/src/reconciliation/events/ReconciliationRunCompletedEventDetail.ts

@@ -0,0 +1,26 @@
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+import { ReconciliationRuleTypeEnum } from '../enums/ReconciliationRuleTypeEnum';
+import { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStatusEnum';
+
+// `detail` de ReconciliationRunCompleted: el resultado de una corrida, sin datos personales.
+export class ReconciliationRunCompletedEventDetail {
+    /**
+     * Fijo por intento y resultado (`{tenantId}#{definitionId}#{runId}#{status}#{inicio del intento}`): un reenvío llega con el
+     * mismo id, y el reintento de una corrida FAILED (mismo `runId`) que termina COMPLETED llega con otro.
+     */
+    eventId!: string;
+    tenantId!: string;
+    definitionId!: string;
+    runId!: string;
+    periodKey!: string;
+    ruleType!: ReconciliationRuleTypeEnum;
+    status!: ReconciliationRunStatusEnum;
+    countsByState!: { state: ReconciliationItemStateEnum; count: number }[];
+    rejectedRecordCount!: number;
+    /** Code de la causa cuando la corrida falló. */
+    failureCode?: string;
+    /** Llave del resumen en el bucket de conciliación (`{tenantId}/{definitionId}/{periodKey}/{layer}.json`). */
+    summaryObjectKey?: string;
+    /** ISO 8601. */
+    finishedAt!: string;
+}

package/src/reconciliation/index.ts

@@ -38,3 +38,5 @@ export * from './dtos/responses/ReconciliationFeedResponses';
 
 // Eventos
 export * from './events/ReconciliationItemMatchedEventDetail';
+export * from './events/ReconciliationRunCompletedEventDetail';
+export * from './events/ReconciliationDiscrepancyFoundEventDetail';