@fiado/type-kit 3.452.0 → 3.454.0

package/_test_/unit/transaction/refund-dtos.test.ts

@@ -21,6 +21,8 @@ describe('Refund DTOs', () => {
       refundCase: {
         pathType: RefundPathTypeEnum.DICTAMEN_PROCEDE,
         caseFolio: 'FOLIO-001',
+        folioId: 'e8b34db9-11cc-4d7a-b6c9-7f2a91b8c001',
+        folioEventId: '9a41c3d0-f78b-4d54-9c62-1e8d5f2b7003',
         originalTransactionId: 'TX-123',
         originalAmount: 1000,
         originalChannel: 'SPEI_IN',
@@ -75,4 +77,31 @@ describe('Refund DTOs', () => {
     expect(confirmRequest.speiTrackingKey).toBe('SPE-TRACK-001');
     expect(confirmRequest.executedAt).toBe('2026-09-17T22:00:00Z');
   });
+
+  it('AuthorizeRefundRequest expone folioId y folioEventId como campos requeridos de refundCase', () => {
+    const req: AuthorizeRefundRequest = {
+      idempotencyKey: 'k',
+      directoryId: 'd',
+      peopleId: 'p',
+      productCatalogId: 'MEX_REFUND_PCF',
+      operation: 'ADD',
+      amount: { total: 100, currencyId: 'MXN' },
+      refundChannel: RefundChannelEnum.INTERNAL_PCF,
+      refundCase: {
+        pathType: RefundPathTypeEnum.DICTAMEN_PROCEDE,
+        caseFolio: 'F',
+        folioId: 'uuid-folio',
+        folioEventId: 'uuid-event',
+        originalTransactionId: null,
+        originalAmount: 100,
+        originalChannel: 'PCF_P2P',
+      },
+      approval: { makerUserId: 'm', checkerUserId: null, minuteS3Key: null },
+      reason: 'r',
+      evidence: { dictamenS3Key: null, incidentReportS3Key: null, objectionFormS3Key: null },
+      pldOverrideMinuteS3Key: null,
+    };
+    expect(req.refundCase.folioId).toBe('uuid-folio');
+    expect(req.refundCase.folioEventId).toBe('uuid-event');
+  });
 });

package/bin/transaction/dtos/AuthorizeRefundRequest.d.ts

@@ -19,6 +19,25 @@ export interface AuthorizeRefundRequest {
     refundCase: {
         pathType: RefundPathTypeEnum;
         caseFolio: string;
+        /**
+         * UUID del registro `DisputeOrFraudLog` que originó el reintegro (fuente
+         * autoritativa del folio). El BO lo persiste en el ledger como
+         * `PagoConfiadoTx_GT.disputeOrFraudLogId` para cerrar el vínculo con la
+         * reclamación (antes del rediseño quedaba en "ND").
+         */
+        folioId: string;
+        /**
+         * UUID del evento R27 específico dentro de `DisputeOrFraudLog.statusHistory[]`
+         * que autoriza este reintegro. Preserva el ligado inmutable evento↔movimiento
+         * en `DisputeRefund_GT.folioEventId`: un folio que reingresa (103) tras un
+         * dictamen no procedente y genera un segundo refund puede tener 2 entradas
+         * en `DisputeRefund_GT`, cada una apuntando a su evento R27 propio.
+         *
+         * Lo obtiene el Dashboard del response de `disputes-business` al firmar el
+         * dictamen (`lastEvent.eventId`). Es inmutable — no se recalcula ni se
+         * reasigna una vez enviado.
+         */
+        folioEventId: string;
         originalTransactionId: string | null;
         originalAmount: number;
         /**

package/bin/transaction/dtos/TransactionCreateRequest.d.ts

@@ -27,6 +27,18 @@ export declare class TransactionCreateRequest {
     sessionId: string;
     disputeOrFraudFolio?: string;
     disputeOrFraudId?: string;
+    /**
+     * UUID del `DisputeOrFraudLog` que originó esta transacción (típicamente un
+     * reintegro PCF). Se persiste en `PagoConfiadoTx_GT.disputeOrFraudLogId`, que
+     * indexa el GSI `disputeOrFraudLogId-createdAt-index` usado por el Dashboard
+     * y por el reporte R27 CNBV para conectar el ledger con el folio.
+     *
+     * Antes del rediseño refund/eventos R27 este campo no viajaba en el
+     * `TransactionCreateRequest` y quedaba en "ND" en el ledger — el join
+     * folio↔tx sólo era posible por `disputeOrFraudFolio` (el folio humano), que
+     * no basta cuando un mismo folio genera dos movimientos (REFUND + REVERSAL).
+     */
+    disputeOrFraudLogId?: string;
     currencyId: CountryId;
     operation: OperationEnum;
     notional: Notional;

package/bin/transaction/dtos/TransactionCreateRequest.js

@@ -121,6 +121,11 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], TransactionCreateRequest.prototype, "disputeOrFraudId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], TransactionCreateRequest.prototype, "disputeOrFraudLogId", void 0);
 __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsEnum)(country_1.CountryId),

package/package.json

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

package/src/transaction/dtos/AuthorizeRefundRequest.ts

@@ -17,6 +17,25 @@ export interface AuthorizeRefundRequest {
     refundCase: {
         pathType: RefundPathTypeEnum;
         caseFolio: string;
+        /**
+         * UUID del registro `DisputeOrFraudLog` que originó el reintegro (fuente
+         * autoritativa del folio). El BO lo persiste en el ledger como
+         * `PagoConfiadoTx_GT.disputeOrFraudLogId` para cerrar el vínculo con la
+         * reclamación (antes del rediseño quedaba en "ND").
+         */
+        folioId: string;
+        /**
+         * UUID del evento R27 específico dentro de `DisputeOrFraudLog.statusHistory[]`
+         * que autoriza este reintegro. Preserva el ligado inmutable evento↔movimiento
+         * en `DisputeRefund_GT.folioEventId`: un folio que reingresa (103) tras un
+         * dictamen no procedente y genera un segundo refund puede tener 2 entradas
+         * en `DisputeRefund_GT`, cada una apuntando a su evento R27 propio.
+         *
+         * Lo obtiene el Dashboard del response de `disputes-business` al firmar el
+         * dictamen (`lastEvent.eventId`). Es inmutable — no se recalcula ni se
+         * reasigna una vez enviado.
+         */
+        folioEventId: string;
         originalTransactionId: string | null;
         originalAmount: number;
         /**

package/src/transaction/dtos/TransactionCreateRequest.ts

@@ -93,6 +93,21 @@ export class TransactionCreateRequest {
     @IsOptional()
     disputeOrFraudId?: string;
 
+    /**
+     * UUID del `DisputeOrFraudLog` que originó esta transacción (típicamente un
+     * reintegro PCF). Se persiste en `PagoConfiadoTx_GT.disputeOrFraudLogId`, que
+     * indexa el GSI `disputeOrFraudLogId-createdAt-index` usado por el Dashboard
+     * y por el reporte R27 CNBV para conectar el ledger con el folio.
+     *
+     * Antes del rediseño refund/eventos R27 este campo no viajaba en el
+     * `TransactionCreateRequest` y quedaba en "ND" en el ledger — el join
+     * folio↔tx sólo era posible por `disputeOrFraudFolio` (el folio humano), que
+     * no basta cuando un mismo folio genera dos movimientos (REFUND + REVERSAL).
+     */
+    @IsString()
+    @IsOptional()
+    disputeOrFraudLogId?: string;
+
     @IsNotEmpty()
     @IsEnum(CountryId)
     currencyId: CountryId;