@fiado/type-kit 3.616.0 → 3.618.0

package/_test_/unit/transferNote/transferNoteConfigAndPrivate.test.ts

@@ -0,0 +1,202 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as TransferNote from '../../../src/transferNote';
+import { CurrencyId } from '../../../src/currency/enums/CurrencyId';
+
+const {
+    UpdateTransferNoteConfigRequest,
+    TransferNoteConfigRecordTypeEnum,
+    TransferNotePartyTypeEnum,
+    TransferNoteConceptEnum,
+    TransferNoteConceptSignEnum,
+    PrivateIssueTransferNoteRequest,
+    PrivateCaptureTransferNoteSpeiRequest,
+    PrivateGetTransferNoteQuery,
+    PrivateListTransferNotesQuery,
+    PrivateConfirmTransferNoteSettlementRequest,
+    PrivateRunTransferNoteCutoffRequest,
+    PrivateCreateTransferNoteAdjustmentRequest,
+    PrivateGetTransferNoteItemBySourceQuery,
+    TransferNoteFeedConceptEnum,
+    TransferNoteErrorCodeEnum,
+    TRANSFER_NOTE_ERROR_HTTP_STATUS,
+    TRANSFER_NOTE_DEFAULT_FEE_CENTS,
+} = TransferNote;
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+    const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+    return validateSync(dto).map((e) => e.property);
+}
+
+const service = { tenantId: 'surekeep', author: 'conciliacion-dashboard' };
+const caller = { ...service, actor: 'operador@fsa.mx' };
+const longReason = 'emisión manual por corte fallido del lunes';
+
+describe('UpdateTransferNoteConfigRequest', () => {
+    it('acepta un registro de cada tipo con su sub-shape', () => {
+        expect(
+            errorsOf(UpdateTransferNoteConfigRequest, {
+                recordType: TransferNoteConfigRecordTypeEnum.TENANT,
+                tenant: { activeFrom: '2026-11-02', currency: CurrencyId.MXN },
+            }),
+        ).toEqual([]);
+        expect(
+            errorsOf(UpdateTransferNoteConfigRequest, {
+                recordType: TransferNoteConfigRecordTypeEnum.PARTY,
+                party: {
+                    partyType: TransferNotePartyTypeEnum.RETAILER,
+                    displayName: 'Tienda Centro',
+                    retailerId: 'r-1',
+                    clabe: '012180001234567891',
+                    contactEmail: 'pagos@tienda.mx',
+                },
+            }),
+        ).toEqual([]);
+        expect(
+            errorsOf(UpdateTransferNoteConfigRequest, {
+                recordType: TransferNoteConfigRecordTypeEnum.CONCEPT,
+                concept: {
+                    payerPartyType: TransferNotePartyTypeEnum.SOFOM,
+                    payeePartyType: TransferNotePartyTypeEnum.RETAILER,
+                    sign: TransferNoteConceptSignEnum.POSITIVE,
+                    activeFrom: '2026-11-02',
+                    rateCents: 5000,
+                },
+            }),
+        ).toEqual([]);
+        expect(
+            errorsOf(UpdateTransferNoteConfigRequest, {
+                recordType: TransferNoteConfigRecordTypeEnum.PAIR,
+                pair: { payerPartyId: 'fsa', payeePartyId: 'sk', activeFrom: '2026-11-02' },
+            }),
+        ).toEqual([]);
+    });
+
+    it('rechaza tipo desconocido y registro sin su sub-shape', () => {
+        expect(errorsOf(UpdateTransferNoteConfigRequest, { recordType: 'GLOBAL' })).toContain('recordType');
+        expect(errorsOf(UpdateTransferNoteConfigRequest, { recordType: TransferNoteConfigRecordTypeEnum.PAIR })).toContain('pair');
+    });
+
+    it('valida el sub-shape: CLABE de 18 dígitos, correo y retailerId de un retailer', () => {
+        const errors = errorsOf(UpdateTransferNoteConfigRequest, {
+            recordType: TransferNoteConfigRecordTypeEnum.PARTY,
+            party: { partyType: TransferNotePartyTypeEnum.RETAILER, displayName: 'Tienda', clabe: '123', contactEmail: 'x' },
+        });
+        expect(errors).toContain('party');
+    });
+
+    it('no tiene campo de comisión por cobranza', () => {
+        const dto = plainToInstance(
+            UpdateTransferNoteConfigRequest,
+            { recordType: 'TENANT', tenant: { activeFrom: '2026-11-02', currency: 'MXN', collectionFeeCents: 100 } },
+            { excludeExtraneousValues: true },
+        );
+        expect(dto.tenant).not.toHaveProperty('collectionFeeCents');
+    });
+});
+
+describe('espejo privado', () => {
+    it('agrega tenantId, author y actor a la versión pública', () => {
+        expect(errorsOf(PrivateIssueTransferNoteRequest, { ...caller, pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual([]);
+        expect(errorsOf(PrivateIssueTransferNoteRequest, { pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual(
+            expect.arrayContaining(['tenantId', 'author', 'actor']),
+        );
+        expect(errorsOf(PrivateIssueTransferNoteRequest, { ...caller, actor: 'operador', pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toContain('actor');
+        expect(
+            errorsOf(PrivateCaptureTransferNoteSpeiRequest, {
+                ...caller,
+                trackingKey: 'K1',
+                paidAt: '2026-10-29T15:00:00.000Z',
+                amountCents: 100,
+            }),
+        ).toEqual([]);
+    });
+
+    it('las lecturas privadas también exigen author y actor', () => {
+        expect(errorsOf(PrivateGetTransferNoteQuery, caller)).toEqual([]);
+        expect(errorsOf(PrivateGetTransferNoteQuery, { tenantId: 'surekeep' })).toEqual(expect.arrayContaining(['author', 'actor']));
+        expect(errorsOf(PrivateListTransferNotesQuery, { ...caller, limit: '20' })).toEqual([]);
+    });
+
+    it('confirm-settlement pide el caller con el email del operador', () => {
+        expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, caller)).toEqual([]);
+        expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, service)).toContain('actor');
+    });
+
+    it('el corte manual pide tenant, semana y author', () => {
+        expect(errorsOf(PrivateRunTransferNoteCutoffRequest, { ...service, isoWeek: '2026-W43' })).toEqual([]);
+        expect(errorsOf(PrivateRunTransferNoteCutoffRequest, { ...service, isoWeek: 'W43' })).toContain('isoWeek');
+        expect(Object.keys(plainToInstance(PrivateRunTransferNoteCutoffRequest, caller, { excludeExtraneousValues: true }))).not.toContain('actor');
+    });
+
+    it('el ajuste es idempotente por adjustmentKey y lleva monto entero distinto de cero', () => {
+        const adjustment = {
+            ...service,
+            adjustmentKey: 'surekeep#def-1#item-9',
+            sourceItemId: 'item-9',
+            amountCents: -1500,
+            reason: 'cobro duplicado',
+        };
+        expect(errorsOf(PrivateCreateTransferNoteAdjustmentRequest, adjustment)).toEqual([]);
+        expect(errorsOf(PrivateCreateTransferNoteAdjustmentRequest, { ...adjustment, adjustmentKey: '', amountCents: 0 })).toEqual(
+            expect.arrayContaining(['adjustmentKey', 'amountCents']),
+        );
+    });
+
+    it('by-source pide author, concepto del item y registro de origen, sin actor', () => {
+        expect(
+            errorsOf(PrivateGetTransferNoteItemBySourceQuery, {
+                tenantId: 'surekeep',
+                author: 'reconciliation-engine-business',
+                concept: TransferNoteConceptEnum.ORIGINATION_BONUS,
+                sourceRecordId: 'contract-1',
+            }),
+        ).toEqual([]);
+        expect(errorsOf(PrivateGetTransferNoteItemBySourceQuery, { tenantId: 'surekeep', concept: 'SIGNED_CREDIT' })).toEqual(
+            expect.arrayContaining(['author', 'concept', 'sourceRecordId']),
+        );
+        expect(new PrivateGetTransferNoteItemBySourceQuery()).toBeInstanceOf(TransferNote.PrivateTransferNoteCaller);
+        expect(new PrivateGetTransferNoteItemBySourceQuery()).not.toBeInstanceOf(TransferNote.PrivateTransferNoteOperatorCaller);
+    });
+});
+
+describe('catálogos', () => {
+    it('conceptos de REQ-48 y feeds de notas', () => {
+        expect(Object.values(TransferNoteConceptEnum)).toEqual(
+            expect.arrayContaining([
+                'INSTALLMENT_COLLECTION',
+                'CREDIT_PROMOTION_REIMBURSEMENT',
+                'SALE_PROMOTION_REIMBURSEMENT',
+                'DEVICE_PAYMENT',
+                'DOWN_PAYMENT',
+                'ORIGINATION_BONUS',
+                'ACCOUNT_OPENING',
+                'ADJUSTMENT',
+            ]),
+        );
+        expect(Object.values(TransferNoteFeedConceptEnum)).toEqual(['TRANSFER_NOTE_ITEM', 'TRANSFER_NOTE_SETTLEMENT']);
+    });
+
+    it('los bonos de retail-customer viajan en SALE_PROMOTION_REIMBURSEMENT', () => {
+        expect(Object.values(TransferNoteConceptEnum)).not.toContain('WELCOME_BONUS_REIMBURSEMENT');
+        expect(Object.values(TransferNoteConceptEnum)).not.toContain('REFERRAL_BONUS_REIMBURSEMENT');
+        expect(Object.values(TransferNoteConceptEnum)).toContain('SALE_COMMISSION');
+    });
+
+    it('tarifas por omisión de REQ-52 en centavos', () => {
+        expect(TRANSFER_NOTE_DEFAULT_FEE_CENTS).toEqual({
+            [TransferNoteConceptEnum.ORIGINATION_BONUS]: 5000,
+            [TransferNoteConceptEnum.ACCOUNT_OPENING]: 2500,
+        });
+    });
+
+    it('cada code tiene un status del catálogo cerrado', () => {
+        for (const code of Object.values(TransferNoteErrorCodeEnum)) {
+            expect([400, 404, 409, 422, 502]).toContain(TRANSFER_NOTE_ERROR_HTTP_STATUS[code]);
+        }
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.WEEK_ALREADY_CUT]).toBe(409);
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.AUTHOR_NOT_ALLOWED]).toBe(422);
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.TRANSFER_NOTE_ITEM_NOT_FOUND]).toBe(404);
+    });
+});

package/_test_/unit/transferNote/transferNoteEventsAndFeeds.test.ts

@@ -0,0 +1,112 @@
+import 'reflect-metadata';
+import { readdirSync, readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import * as Reconciliation from '../../../src/reconciliation';
+import * as TransferNote from '../../../src/transferNote';
+import { CurrencyId } from '../../../src/currency/enums/CurrencyId';
+
+const { ReconciliationFeedConceptEnum, ReconciliationFeedErrorCodeEnum, RECONCILIATION_FEED_ERROR_HTTP_STATUS } = Reconciliation;
+const { TransferNoteConceptEnum, TransferNotePartyTypeEnum, TransferNoteStatusEnum, TransferNoteErrorCodeEnum } = TransferNote;
+
+// Lo que lee el cliente genérico de feeds del motor, sin saber de qué dueño viene.
+const readGeneric = (record: Reconciliation.ReconciliationFeedRecord): string =>
+    `${record.concept}#${record.matchKey}#${record.amountCents}#${record.refs.reversesRecordId ?? ''}`;
+
+const sourceFiles = (dir: string): string[] =>
+    readdirSync(dir).flatMap((name) => {
+        const path = join(dir, name);
+        return statSync(path).isDirectory() ? sourceFiles(path) : [path];
+    });
+
+describe('eventos de transferNote', () => {
+    it('TransferNoteReconciled vive en transferNote con su source y detailType', () => {
+        expect(TransferNote.TRANSFER_NOTE_EVENTS_SOURCE).toBe('fiado.transferNote');
+        expect(TransferNote.TransferNoteEventDetailTypeEnum.TRANSFER_NOTE_RECONCILED).toBe('transferNote.TransferNoteReconciled');
+        const detail: TransferNote.TransferNoteReconciledEventDetail = {
+            eventId: 'surekeep#n-1#RECONCILED',
+            tenantId: 'surekeep',
+            noteId: 'n-1',
+            pairKey: 'FSA#SK',
+            isoWeek: '2026-W44',
+            netAmountCents: 125000,
+            currency: CurrencyId.MXN,
+            reconciledAt: '2026-10-29T10:00:00.000Z',
+        };
+        expect(detail.noteId).toBe('n-1');
+    });
+});
+
+describe('registros de feed de notas con la forma base', () => {
+    it('un item de nota se lee con el cliente genérico y su reversa va en refs', () => {
+        const reversal: TransferNote.TransferNoteItemFeedRecord = {
+            recordId: 'it-2',
+            tenantId: 'surekeep',
+            concept: ReconciliationFeedConceptEnum.TRANSFER_NOTE_ITEM,
+            matchKey: 'att-1',
+            amountCents: -15000,
+            currency: CurrencyId.MXN,
+            occurredAt: '2026-10-20T15:00:00.000Z',
+            feedDay: '2026-10-27',
+            refs: { noteId: 'n-1', itemId: 'it-2', attemptId: 'att-1', creditId: 'cr-1', reversesRecordId: 'it-1' },
+            itemConcept: TransferNoteConceptEnum.INSTALLMENT_COLLECTION,
+            pairKey: 'FSA#SK',
+            sourceRecordId: 'pay-1#rev',
+            includedAt: '2026-10-27T06:01:00.000Z',
+        };
+        expect(readGeneric(reversal)).toBe('TRANSFER_NOTE_ITEM#att-1#-15000#it-1');
+        expect(Object.keys(reversal)).not.toContain('reversedItemId');
+        expect(Object.keys(reversal)).not.toContain('noteId');
+    });
+
+    it('la liquidación de una nota se lee con el cliente genérico', () => {
+        const settlement: TransferNote.TransferNoteSettlementFeedRecord = {
+            recordId: 'n-1',
+            tenantId: 'surekeep',
+            concept: ReconciliationFeedConceptEnum.TRANSFER_NOTE_SETTLEMENT,
+            matchKey: 'n-1',
+            amountCents: 125000,
+            currency: CurrencyId.MXN,
+            occurredAt: '2026-10-27T06:01:00.000Z',
+            feedDay: '2026-10-27',
+            counterpartyType: TransferNotePartyTypeEnum.RETAILER,
+            refs: { noteId: 'n-1', trackingKey: 'BBVA123', retailerId: 'r-1' },
+            pairKey: 'FSA#SK',
+            payerPartyType: TransferNotePartyTypeEnum.GATEWAY,
+            payerPartyId: 'fsa',
+            payeePartyType: TransferNotePartyTypeEnum.RETAILER,
+            payeePartyId: 'r-1',
+            status: TransferNoteStatusEnum.SENT,
+            dueAt: '2026-10-29T06:00:00.000Z',
+            payeeClabe: '012180001234567890',
+        };
+        expect(readGeneric(settlement)).toBe('TRANSFER_NOTE_SETTLEMENT#n-1#125000#');
+        expect(Object.keys(settlement)).not.toContain('netAmountCents');
+        expect(Object.keys(settlement)).not.toContain('issuedAt');
+    });
+
+    it('los refs de notas no admiten llaves fuera de la lista cerrada', () => {
+        const refs: TransferNote.TransferNoteItemFeedRecord['refs'] = {
+            noteId: 'n-1',
+            itemId: 'it-1',
+            // @ts-expect-error sourceRecordId no está en la lista cerrada de refs
+            sourceRecordId: 'pay-1',
+        };
+        expect(refs.noteId).toBe('n-1');
+    });
+});
+
+describe('FEED_RECORD_NOT_FOUND con una sola fuente', () => {
+    it('transferNote reusa el code y el status del feed genérico', () => {
+        expect(TransferNoteErrorCodeEnum.FEED_RECORD_NOT_FOUND).toBe(ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND);
+        expect(TransferNote.TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.FEED_RECORD_NOT_FOUND]).toBe(
+            RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND],
+        );
+    });
+
+    it('el string literal solo se declara en reconciliation', () => {
+        const declaring = [...sourceFiles(join(__dirname, '../../../src/transferNote')), ...sourceFiles(join(__dirname, '../../../src/reconciliation'))]
+            .filter((file) => readFileSync(file, 'utf8').includes("'FEED_RECORD_NOT_FOUND'"))
+            .map((file) => file.replace(/.*\/src\//, 'src/'));
+        expect(declaring).toEqual(['src/reconciliation/enums/ReconciliationFeedErrorCodeEnum.ts']);
+    });
+});

package/_test_/unit/transferNote/transferNoteRequests.test.ts

@@ -0,0 +1,138 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as TransferNote from '../../../src/transferNote';
+import { TransferNote as FromRoot } from '../../../src';
+
+const {
+    IssueTransferNoteRequest,
+    PreviewTransferNoteRequest,
+    CaptureTransferNoteSpeiRequest,
+    CaptureRetailerTransferNoteSpeiRequest,
+    RevertTransferNoteSpeiRequest,
+    CancelTransferNoteRequest,
+    DisputeTransferNoteRequest,
+    ResolveTransferNoteDisputeRequest,
+    ListTransferNotesQuery,
+    ListRetailerTransferNotesQuery,
+    ListTransferNotePoolQuery,
+    ListTransferNoteItemsQuery,
+    TransferNoteDisputeCategoryEnum,
+    TransferNoteDisputeDecisionEnum,
+    TransferNoteStatusEnum,
+    TransferNoteItemStatusEnum,
+    TransferNoteConceptEnum,
+} = TransferNote;
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+    const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+    return validateSync(dto).map((e) => e.property);
+}
+
+const longReason = 'el corte omitió dos cobros de la semana';
+
+describe('export del dominio', () => {
+    it('se exporta desde el index raíz', () => {
+        expect(FromRoot.IssueTransferNoteRequest).toBe(IssueTransferNoteRequest);
+        expect(FromRoot.TransferNoteStatusEnum.ISSUED).toBe('ISSUED');
+    });
+});
+
+describe('IssueTransferNoteRequest', () => {
+    it('acepta selección de items o par + semana, con razón de 20+', () => {
+        expect(errorsOf(IssueTransferNoteRequest, { pairKey: 'p-1', itemIds: ['i-1'], reason: longReason })).toEqual([]);
+        expect(errorsOf(IssueTransferNoteRequest, { pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual([]);
+    });
+
+    it('exige exactamente uno de itemIds o isoWeek', () => {
+        expect(errorsOf(IssueTransferNoteRequest, { pairKey: 'p-1', reason: longReason })).toContain('itemIds');
+        expect(
+            errorsOf(IssueTransferNoteRequest, { pairKey: 'p-1', itemIds: ['i-1'], isoWeek: '2026-W43', reason: longReason }),
+        ).toContain('itemIds');
+    });
+
+    it('rechaza razón corta, semana mal formada y selección vacía', () => {
+        const errors = errorsOf(IssueTransferNoteRequest, { pairKey: '', isoWeek: '2026-43', reason: 'corta' });
+        expect(errors).toEqual(expect.arrayContaining(['pairKey', 'isoWeek', 'reason']));
+        expect(errorsOf(IssueTransferNoteRequest, { pairKey: 'p-1', itemIds: [], reason: longReason })).toContain('itemIds');
+    });
+
+    it('cuenta la razón sin espacios de relleno', () => {
+        expect(errorsOf(IssueTransferNoteRequest, { pairKey: 'p-1', isoWeek: '2026-W43', reason: `   corta${' '.repeat(20)}` })).toContain(
+            'reason',
+        );
+    });
+});
+
+describe('PreviewTransferNoteRequest', () => {
+    it('no pide razón y aplica la misma selección', () => {
+        expect(errorsOf(PreviewTransferNoteRequest, { pairKey: 'p-1', isoWeek: '2026-W01' })).toEqual([]);
+        expect(errorsOf(PreviewTransferNoteRequest, { pairKey: 'p-1' })).toContain('itemIds');
+    });
+});
+
+describe('captura y reversa de SPEI', () => {
+    const spei = { trackingKey: 'BNET01002610290000001', paidAt: '2026-10-29T15:00:00.000Z', amountCents: 125000 };
+
+    it('acepta clave, fecha ISO y monto entero positivo', () => {
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, spei)).toEqual([]);
+        expect(errorsOf(CaptureRetailerTransferNoteSpeiRequest, spei)).toEqual([]);
+    });
+
+    it('rechaza clave vacía, fecha inválida y monto no entero o no positivo', () => {
+        const errors = errorsOf(CaptureTransferNoteSpeiRequest, { trackingKey: '', paidAt: 'hoy', amountCents: 10.5 });
+        expect(errors).toEqual(expect.arrayContaining(['trackingKey', 'paidAt', 'amountCents']));
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, { ...spei, amountCents: 0 })).toContain('amountCents');
+    });
+
+    it('la reversa y la cancelación exigen razón', () => {
+        expect(errorsOf(RevertTransferNoteSpeiRequest, { reason: 'SPEI duplicado' })).toEqual([]);
+        expect(errorsOf(RevertTransferNoteSpeiRequest, { reason: '  ' })).toContain('reason');
+        expect(errorsOf(CancelTransferNoteRequest, {})).toContain('reason');
+    });
+});
+
+describe('objeción', () => {
+    it('acepta las 4 categorías con razón de 20+', () => {
+        for (const category of Object.values(TransferNoteDisputeCategoryEnum)) {
+            expect(errorsOf(DisputeTransferNoteRequest, { category, reason: longReason })).toEqual([]);
+        }
+        expect(Object.values(TransferNoteDisputeCategoryEnum)).toHaveLength(4);
+    });
+
+    it('rechaza categoría desconocida y razón corta', () => {
+        expect(errorsOf(DisputeTransferNoteRequest, { category: 'LATE', reason: 'mal' })).toEqual(
+            expect.arrayContaining(['category', 'reason']),
+        );
+    });
+
+    it('la resolución acepta o rechaza con razón', () => {
+        expect(errorsOf(ResolveTransferNoteDisputeRequest, { decision: TransferNoteDisputeDecisionEnum.ACCEPT, reason: 'faltaban items' })).toEqual([]);
+        expect(errorsOf(ResolveTransferNoteDisputeRequest, { decision: 'MAYBE' })).toEqual(expect.arrayContaining(['decision', 'reason']));
+    });
+});
+
+describe('queries de listado', () => {
+    it('acepta filtros, límite y cursor', () => {
+        const query = { status: TransferNoteStatusEnum.SENT, isoWeek: '2026-W43', limit: '50', nextToken: 'abc' };
+        expect(errorsOf(ListTransferNotesQuery, query)).toEqual([]);
+        expect(errorsOf(ListRetailerTransferNotesQuery, query)).toEqual([]);
+        expect(
+            errorsOf(ListTransferNotePoolQuery, {
+                pairKey: 'p-1',
+                status: TransferNoteItemStatusEnum.POOLED,
+                concept: TransferNoteConceptEnum.INSTALLMENT_COLLECTION,
+                from: '2026-10-19',
+                to: '2026-10-25',
+            }),
+        ).toEqual([]);
+        expect(errorsOf(ListTransferNoteItemsQuery, { limit: '10' })).toEqual([]);
+    });
+
+    it('rechaza estado desconocido y límite fuera de rango', () => {
+        expect(errorsOf(ListTransferNotesQuery, { status: 'PAID', limit: '500' })).toEqual(expect.arrayContaining(['status', 'limit']));
+        expect(errorsOf(ListTransferNotePoolQuery, { status: TransferNoteStatusEnum.ISSUED, from: 'ayer' })).toEqual(
+            expect.arrayContaining(['status', 'from']),
+        );
+    });
+});

package/bin/account/dtos/BankAccountMCSendTransferRequest.d.ts

@@ -1,10 +1,16 @@
 export declare class BankAccountMCSendTransferRequest {
     transactionNumber: string;
     amount: number;
-    beneficiaryEmail: string;
-    beneficiaryPhoneNumber: string;
+    /** Intención por email/teléfono: obligatorios salvo que venga beneficiaryExternalAccountId. */
+    beneficiaryEmail?: string;
+    beneficiaryPhoneNumber?: string;
     beneficiaryName?: string;
     beneficiaryLastName?: string;
     concept?: string;
     externalAccountId?: string;
+    /**
+     * Push directo a una tarjeta del mismo programa (CARD_PUSH_FUNDS): cd_ de la tarjeta del
+     * beneficiario, usuario de Fiado. Si viene, CP acredita en la misma llamada sin intención.
+     */
+    beneficiaryExternalAccountId?: string;
 }

package/bin/account/dtos/BankAccountMCSendTransferResponse.d.ts

@@ -1,6 +1,9 @@
 import { TransactionStatusEnum } from "../../transaction";
 export declare class BankAccountMCSendTransferResponse {
+    /** Ids tx_ de los movimientos contables en CP, unidos por "|". */
     externalTransactionId: string;
+    /** Id mt_ de la network transfer en CP: sirve para consultar, cancelar o auditar el envío. */
+    externalTransferId?: string;
     transactionStatus: TransactionStatusEnum;
     transactionNumber: string;
 }

package/bin/index.d.ts

@@ -134,3 +134,5 @@ export * as Meetings from './meetings';
 export * as LoanRetailAudit from './loanRetailAudit';
 export * as TaskManager from './task-manager-business';
 export * as CustomerMessages from './customerMessages';
+export * as TransferNote from './transferNote';
+export * as Reconciliation from './reconciliation';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 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.FiadoIncFavorite = 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.MessageMoments = 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.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.GsfConnector = 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.UsMarketGrowthBusiness = 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 = exports.IssuanceBusiness = exports.Blacklist = void 0;
-exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Meetings = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = 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 = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = void 0;
+exports.Reconciliation = exports.TransferNote = exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Meetings = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = 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 = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -263,3 +263,9 @@ exports.LoanRetailAudit = __importStar(require("./loanRetailAudit"));
 exports.TaskManager = __importStar(require("./task-manager-business"));
 // CustomerMessages: historial de mensajes del cliente por venta o crédito, contador de cobranza y envío manual.
 exports.CustomerMessages = __importStar(require("./customerMessages"));
+// TransferNote: contrato de transfer-note-business (notas de transferencia entre partes de un tenant):
+// endpoints públicos, rutas de retailer, espejo privado con author, ajustes y registros de sus feeds.
+exports.TransferNote = __importStar(require("./transferNote"));
+// Reconciliation: contrato de reconciliation-engine-business (definiciones, corridas, partidas y resoluciones),
+// su espejo privado con author, el feed genérico que implementa cada dueño y sus eventos.
+exports.Reconciliation = __importStar(require("./reconciliation"));

package/bin/loanRetailAudit/enums/AuditTrailActionEnum.d.ts

@@ -35,5 +35,16 @@ export declare enum AuditTrailActionEnum {
     ADJUST = "ADJUST",
     PAUSE = "PAUSE",
     RESUME = "RESUME",
-    EXPIRE = "EXPIRE"
+    EXPIRE = "EXPIRE",
+    TRANSFER_NOTE_ISSUE = "TRANSFER_NOTE_ISSUE",
+    TRANSFER_NOTE_SPEI_CAPTURE = "TRANSFER_NOTE_SPEI_CAPTURE",
+    TRANSFER_NOTE_SPEI_REVERT = "TRANSFER_NOTE_SPEI_REVERT",
+    TRANSFER_NOTE_RECEPTION_CONFIRM = "TRANSFER_NOTE_RECEPTION_CONFIRM",
+    TRANSFER_NOTE_SETTLEMENT_CONFIRM = "TRANSFER_NOTE_SETTLEMENT_CONFIRM",
+    TRANSFER_NOTE_CANCEL = "TRANSFER_NOTE_CANCEL",
+    TRANSFER_NOTE_DISPUTE = "TRANSFER_NOTE_DISPUTE",
+    TRANSFER_NOTE_DISPUTE_RESOLVE = "TRANSFER_NOTE_DISPUTE_RESOLVE",
+    RECONCILIATION_ITEM_RESOLVE = "RECONCILIATION_ITEM_RESOLVE",
+    RECONCILIATION_ITEM_REACTIVATE = "RECONCILIATION_ITEM_REACTIVATE",
+    RECONCILIATION_ITEM_NOTE = "RECONCILIATION_ITEM_NOTE"
 }

package/bin/loanRetailAudit/enums/AuditTrailActionEnum.js

@@ -40,4 +40,16 @@ var AuditTrailActionEnum;
     AuditTrailActionEnum["PAUSE"] = "PAUSE";
     AuditTrailActionEnum["RESUME"] = "RESUME";
     AuditTrailActionEnum["EXPIRE"] = "EXPIRE";
+    // M8: la configuración de notas y de definiciones reusa UPDATE.
+    AuditTrailActionEnum["TRANSFER_NOTE_ISSUE"] = "TRANSFER_NOTE_ISSUE";
+    AuditTrailActionEnum["TRANSFER_NOTE_SPEI_CAPTURE"] = "TRANSFER_NOTE_SPEI_CAPTURE";
+    AuditTrailActionEnum["TRANSFER_NOTE_SPEI_REVERT"] = "TRANSFER_NOTE_SPEI_REVERT";
+    AuditTrailActionEnum["TRANSFER_NOTE_RECEPTION_CONFIRM"] = "TRANSFER_NOTE_RECEPTION_CONFIRM";
+    AuditTrailActionEnum["TRANSFER_NOTE_SETTLEMENT_CONFIRM"] = "TRANSFER_NOTE_SETTLEMENT_CONFIRM";
+    AuditTrailActionEnum["TRANSFER_NOTE_CANCEL"] = "TRANSFER_NOTE_CANCEL";
+    AuditTrailActionEnum["TRANSFER_NOTE_DISPUTE"] = "TRANSFER_NOTE_DISPUTE";
+    AuditTrailActionEnum["TRANSFER_NOTE_DISPUTE_RESOLVE"] = "TRANSFER_NOTE_DISPUTE_RESOLVE";
+    AuditTrailActionEnum["RECONCILIATION_ITEM_RESOLVE"] = "RECONCILIATION_ITEM_RESOLVE";
+    AuditTrailActionEnum["RECONCILIATION_ITEM_REACTIVATE"] = "RECONCILIATION_ITEM_REACTIVATE";
+    AuditTrailActionEnum["RECONCILIATION_ITEM_NOTE"] = "RECONCILIATION_ITEM_NOTE";
 })(AuditTrailActionEnum || (exports.AuditTrailActionEnum = AuditTrailActionEnum = {}));

package/bin/loanRetailAudit/enums/LoanAuditEntityTypeEnum.d.ts

@@ -8,5 +8,9 @@ export declare enum LoanAuditEntityTypeEnum {
     SEGMENT = "SEGMENT",
     LOAN_PARAMETER = "LoanParameter",
     LOAN_ASSIGNMENT_RULE = "LoanAssignmentRule",
-    LOAN_COLLECTOR_ASSIGNMENT = "LoanCollectorAssignment"
+    LOAN_COLLECTOR_ASSIGNMENT = "LoanCollectorAssignment",
+    TRANSFER_NOTE = "TRANSFER_NOTE",
+    TRANSFER_NOTE_CONFIG = "TRANSFER_NOTE_CONFIG",
+    RECONCILIATION_DEFINITION = "RECONCILIATION_DEFINITION",
+    RECONCILIATION_ITEM = "RECONCILIATION_ITEM"
 }

package/bin/loanRetailAudit/enums/LoanAuditEntityTypeEnum.js

@@ -13,4 +13,8 @@ var LoanAuditEntityTypeEnum;
     LoanAuditEntityTypeEnum["LOAN_PARAMETER"] = "LoanParameter";
     LoanAuditEntityTypeEnum["LOAN_ASSIGNMENT_RULE"] = "LoanAssignmentRule";
     LoanAuditEntityTypeEnum["LOAN_COLLECTOR_ASSIGNMENT"] = "LoanCollectorAssignment";
+    LoanAuditEntityTypeEnum["TRANSFER_NOTE"] = "TRANSFER_NOTE";
+    LoanAuditEntityTypeEnum["TRANSFER_NOTE_CONFIG"] = "TRANSFER_NOTE_CONFIG";
+    LoanAuditEntityTypeEnum["RECONCILIATION_DEFINITION"] = "RECONCILIATION_DEFINITION";
+    LoanAuditEntityTypeEnum["RECONCILIATION_ITEM"] = "RECONCILIATION_ITEM";
 })(LoanAuditEntityTypeEnum || (exports.LoanAuditEntityTypeEnum = LoanAuditEntityTypeEnum = {}));

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.d.ts

@@ -0,0 +1,6 @@
+import { ReconciliationErrorCodeEnum as C } from '../enums/ReconciliationErrorCodeEnum';
+import { ReconciliationFeedErrorCodeEnum } from '../enums/ReconciliationFeedErrorCodeEnum';
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio · 502 falló el dueño del dinero. */
+export declare const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422 | 502>>;
+/** Status HTTP de los codes del feed genérico. */
+export declare const RECONCILIATION_FEED_ERROR_HTTP_STATUS: Readonly<Record<ReconciliationFeedErrorCodeEnum, 404>>;

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECONCILIATION_FEED_ERROR_HTTP_STATUS = exports.RECONCILIATION_ERROR_HTTP_STATUS = void 0;
+const ReconciliationErrorCodeEnum_1 = require("../enums/ReconciliationErrorCodeEnum");
+const ReconciliationFeedErrorCodeEnum_1 = require("../enums/ReconciliationFeedErrorCodeEnum");
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio · 502 falló el dueño del dinero. */
+exports.RECONCILIATION_ERROR_HTTP_STATUS = {
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.DEFINITION_NOT_FOUND]: 404,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.RUN_IN_PROGRESS]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ITEM_NOT_FOUND]: 404,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ITEM_ALREADY_RESOLVED]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_IN_PROGRESS]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_UNDER_EXECUTED]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_NOT_ALLOWED]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_REJECTED]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_UNAVAILABLE]: 502,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ITEM_ADJUSTED]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.AUTHOR_NOT_ALLOWED]: 422,
+};
+/** Status HTTP de los codes del feed genérico. */
+exports.RECONCILIATION_FEED_ERROR_HTTP_STATUS = {
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]: 404,
+};

package/bin/reconciliation/constants/reconciliationValidation.d.ts

@@ -0,0 +1,8 @@
+/** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
+export declare const RECONCILIATION_PERIOD_KEY_PATTERN: RegExp;
+/** Mes `YYYY-MM`. */
+export declare const RECONCILIATION_MONTH_PATTERN: RegExp;
+/** Largo mínimo de una nota de investigación. */
+export declare const RECONCILIATION_MIN_NOTE_LENGTH = 10;
+/** Registros por página de un feed de dueño. */
+export declare const RECONCILIATION_FEED_PAGE_SIZE = 500;

package/bin/reconciliation/constants/reconciliationValidation.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECONCILIATION_FEED_PAGE_SIZE = exports.RECONCILIATION_MIN_NOTE_LENGTH = exports.RECONCILIATION_MONTH_PATTERN = exports.RECONCILIATION_PERIOD_KEY_PATTERN = void 0;
+/** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
+exports.RECONCILIATION_PERIOD_KEY_PATTERN = /^\d{4}-((0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?|W(0[1-9]|[1-4]\d|5[0-3]))$/;
+/** Mes `YYYY-MM`. */
+exports.RECONCILIATION_MONTH_PATTERN = /^\d{4}-(0[1-9]|1[0-2])$/;
+/** Largo mínimo de una nota de investigación. */
+exports.RECONCILIATION_MIN_NOTE_LENGTH = 10;
+/** Registros por página de un feed de dueño. */
+exports.RECONCILIATION_FEED_PAGE_SIZE = 500;