@fiado/type-kit 3.556.0 → 3.558.0

package/bin/notificationMessages/dtos/DisputeNotificationData.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
+ * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ */
+export declare class DisputeNotificationData {
+    id: string;
+    folio: string;
+    folioId?: string;
+}

package/bin/notificationMessages/dtos/DisputeNotificationData.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeNotificationData = void 0;
+/**
+ * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
+ * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ */
+class DisputeNotificationData {
+}
+exports.DisputeNotificationData = DisputeNotificationData;

package/bin/notificationMessages/index.d.ts

@@ -1,5 +1,6 @@
 export * from './dtos/NotificationQueueMessageRequest';
 export * from './dtos/QueueMessageDestination';
+export * from './dtos/DisputeNotificationData';
 export * from './dtos/QueueMessageVariableValues';
 export * from './dtos/NotificationTemplate';
 export * from './dtos/MomentTemplateUpsertRequest';

package/bin/notificationMessages/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./dtos/NotificationQueueMessageRequest"), exports);
 __exportStar(require("./dtos/QueueMessageDestination"), exports);
+__exportStar(require("./dtos/DisputeNotificationData"), exports);
 __exportStar(require("./dtos/QueueMessageVariableValues"), exports);
 __exportStar(require("./dtos/NotificationTemplate"), exports);
 __exportStar(require("./dtos/MomentTemplateUpsertRequest"), exports);

package/bin/rules/dtos/population/PopulationSegmentDefinition.d.ts

@@ -1,8 +1,11 @@
 import { SegmentMatchEnum } from '../../enums/SegmentMatchEnum';
+import { SegmentOutputEnum } from '../../enums/SegmentOutputEnum';
 import { SegmentGroup } from './SegmentGroup';
 /** El constructor tal cual (A§4.1): tabla ancla (una fila -> un directoryid), TODAS/ALGUNA global y grupos con su propio TODAS/ALGUNA. */
 export declare class PopulationSegmentDefinition {
     baseTable: string;
+    /** Que se devuelve por fila. Ausente = DIRECTORY_ID. PHONE devuelve el telefono (sirve para personas sin cuenta); en ese caso `ids`/`afterDirectoryId` llevan telefonos. */
+    output?: SegmentOutputEnum;
     match: SegmentMatchEnum;
     groups: SegmentGroup[];
 }

package/bin/rules/dtos/population/PopulationSegmentDefinition.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const SegmentLimits_1 = require("../../constants/SegmentLimits");
 const SegmentMatchEnum_1 = require("../../enums/SegmentMatchEnum");
+const SegmentOutputEnum_1 = require("../../enums/SegmentOutputEnum");
 const SegmentGroup_1 = require("./SegmentGroup");
 /** El constructor tal cual (A§4.1): tabla ancla (una fila -> un directoryid), TODAS/ALGUNA global y grupos con su propio TODAS/ALGUNA. */
 class PopulationSegmentDefinition {
@@ -24,6 +25,12 @@ __decorate([
     (0, class_validator_1.Matches)(SegmentLimits_1.SEGMENT_IDENTIFIER_PATTERN),
     __metadata("design:type", String)
 ], PopulationSegmentDefinition.prototype, "baseTable", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SegmentOutputEnum_1.SegmentOutputEnum),
+    __metadata("design:type", String)
+], PopulationSegmentDefinition.prototype, "output", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsEnum)(SegmentMatchEnum_1.SegmentMatchEnum),

package/bin/rules/enums/SegmentOutputEnum.d.ts

@@ -0,0 +1,5 @@
+/** Que devuelve la poblacion: el directoryId (por defecto) o el telefono (personas sin cuenta, que no tienen directoryId). */
+export declare enum SegmentOutputEnum {
+    DIRECTORY_ID = "DIRECTORY_ID",
+    PHONE = "PHONE"
+}

package/bin/rules/enums/SegmentOutputEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentOutputEnum = void 0;
+/** Que devuelve la poblacion: el directoryId (por defecto) o el telefono (personas sin cuenta, que no tienen directoryId). */
+var SegmentOutputEnum;
+(function (SegmentOutputEnum) {
+    SegmentOutputEnum["DIRECTORY_ID"] = "DIRECTORY_ID";
+    SegmentOutputEnum["PHONE"] = "PHONE";
+})(SegmentOutputEnum || (exports.SegmentOutputEnum = SegmentOutputEnum = {}));

package/bin/rules/index.d.ts

@@ -14,6 +14,7 @@ export * from './dtos/RulesTraceResponse';
 export * from './dtos/EvaluateRulesRequest';
 export * from './dtos/EvaluateRulesResponse';
 export * from './enums/SegmentMatchEnum';
+export * from './enums/SegmentOutputEnum';
 export * from './enums/SegmentConditionKindEnum';
 export * from './enums/SegmentAggregateFnEnum';
 export * from './enums/SegmentOperatorEnum';

package/bin/rules/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./dtos/EvaluateRulesRequest"), exports);
 __exportStar(require("./dtos/EvaluateRulesResponse"), exports);
 //Poblacion (movido desde rewardsEligibility; alli queda re-export)
 __exportStar(require("./enums/SegmentMatchEnum"), exports);
+__exportStar(require("./enums/SegmentOutputEnum"), exports);
 __exportStar(require("./enums/SegmentConditionKindEnum"), exports);
 __exportStar(require("./enums/SegmentAggregateFnEnum"), exports);
 __exportStar(require("./enums/SegmentOperatorEnum"), exports);

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

@@ -0,0 +1,32 @@
+import { DisputeRefundSummary } from './DisputeRefundSummary';
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+/**
+ * `data` de GET disputes/transaction/{code}/{transactionNumber} (pública, app).
+ * Devuelve el folio completo (todos los atributos de DisputeOrFraudLog) más los campos
+ * normalizados/enriquecidos que la app necesita para el detalle del movimiento.
+ * Vale desde cualquier movimiento ligado al folio (tx reclamada, abono o reversa).
+ */
+export declare class DisputeGetDetailResponse {
+    id: string;
+    disputeOrFraudFolio: string;
+    directoryId: string;
+    disputeOrFraudStatus: R27StatusEnum;
+    disputeOrFraudStatusUpdate: string;
+    dateOfDisputedTx: string;
+    disputedTxNumber: string;
+    amountOfDisputedTx: number;
+    /** Sentido del dictamen (701-705 improcedente, 706-709 procedente). '' hasta el dictamen. */
+    disputeResolutionCause: string;
+    disputeResolutionDate: string;
+    /** Siempre presente (0 si nunca se reabrió). Botón "segunda revisión": status 102 + causa 701-705 + reopenCount 0. */
+    reopenCount: number;
+    reopenedAt?: string;
+    reopenedReason?: string;
+    refundTransactionId?: string;
+    /** Abono (provisional o por dictamen). */
+    refund?: DisputeRefundSummary;
+    /** Reversa del abono; la fecha del abono original está en `refund.executedAt`. */
+    reversal?: DisputeRefundSummary;
+    /** Resto de atributos del folio (merchant, statusHistory, etc.). */
+    [attribute: string]: unknown;
+}

package/bin/transaction/dtos/DisputeGetDetailResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeGetDetailResponse = void 0;
+/**
+ * `data` de GET disputes/transaction/{code}/{transactionNumber} (pública, app).
+ * Devuelve el folio completo (todos los atributos de DisputeOrFraudLog) más los campos
+ * normalizados/enriquecidos que la app necesita para el detalle del movimiento.
+ * Vale desde cualquier movimiento ligado al folio (tx reclamada, abono o reversa).
+ */
+class DisputeGetDetailResponse {
+}
+exports.DisputeGetDetailResponse = DisputeGetDetailResponse;

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

@@ -0,0 +1,14 @@
+import { DisputeRefundStatus } from '../enums/DisputeRefundStatus';
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+/**
+ * Reintegro (abono o reversa) ligado a una reclamación, tal como lo consume la app
+ * en el detalle del movimiento. Resumen de una fila de DisputeRefund_GT.
+ */
+export declare class DisputeRefundSummary {
+    id: string;
+    transactionId?: string;
+    status: DisputeRefundStatus;
+    amount: number;
+    channel?: RefundChannelEnum;
+    executedAt?: string;
+}

package/bin/transaction/dtos/DisputeRefundSummary.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeRefundSummary = void 0;
+/**
+ * Reintegro (abono o reversa) ligado a una reclamación, tal como lo consume la app
+ * en el detalle del movimiento. Resumen de una fila de DisputeRefund_GT.
+ */
+class DisputeRefundSummary {
+}
+exports.DisputeRefundSummary = DisputeRefundSummary;

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

@@ -0,0 +1,11 @@
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+/**
+ * Evento R27 compacto incluido en las respuestas de disputes-business
+ * (reapertura y firma de dictamen). El Dashboard usa `eventId` como
+ * `folioEventId` al autorizar el reintegro.
+ */
+export declare class R27EventPayload {
+    eventId: string;
+    code: R27StatusEnum;
+    occurredAt: string;
+}

package/bin/transaction/dtos/R27EventPayload.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R27EventPayload = void 0;
+/**
+ * Evento R27 compacto incluido en las respuestas de disputes-business
+ * (reapertura y firma de dictamen). El Dashboard usa `eventId` como
+ * `folioEventId` al autorizar el reintegro.
+ */
+class R27EventPayload {
+}
+exports.R27EventPayload = R27EventPayload;

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

@@ -0,0 +1,12 @@
+/**
+ * Instrucción de reintegro adjunta a la firma del dictamen (UpdateR27StatusRequest.refundInstruction).
+ * Política SP1:
+ *   1 = post-dictamen 2FA (el Dashboard genera la tx antes de cerrar el folio)
+ *   2 = T+2 provisional (ya abonado — se confirma el id existente)
+ *   3 = error operativo (reintegro manual)
+ */
+export declare class RefundInstruction {
+    camino: 1 | 2 | 3;
+    /** Id de la tx de refund en el ledger. Presente cuando el refund ya ocurrió. */
+    refundTransactionId?: string;
+}

package/bin/transaction/dtos/RefundInstruction.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundInstruction = void 0;
+/**
+ * Instrucción de reintegro adjunta a la firma del dictamen (UpdateR27StatusRequest.refundInstruction).
+ * Política SP1:
+ *   1 = post-dictamen 2FA (el Dashboard genera la tx antes de cerrar el folio)
+ *   2 = T+2 provisional (ya abonado — se confirma el id existente)
+ *   3 = error operativo (reintegro manual)
+ */
+class RefundInstruction {
+}
+exports.RefundInstruction = RefundInstruction;

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

@@ -0,0 +1,15 @@
+import { R27EventPayload } from './R27EventPayload';
+/**
+ * Response 200 de la reapertura de reclamación (102 -> 103):
+ * privada POST disputes/{folioId}/reopen (CS/OC) y pública POST disputes/reopen/{folioId} (app).
+ * Idempotente: si el folio ya estaba en 103 con el mismo motivo responde este mismo shape.
+ */
+export declare class ReopenDisputeResponse {
+    success: boolean;
+    folio: string;
+    id: string;
+    currentStatus: number;
+    reopenCount: number;
+    updatedAt: string;
+    lastEvent?: R27EventPayload;
+}

package/bin/transaction/dtos/ReopenDisputeResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReopenDisputeResponse = void 0;
+/**
+ * Response 200 de la reapertura de reclamación (102 -> 103):
+ * privada POST disputes/{folioId}/reopen (CS/OC) y pública POST disputes/reopen/{folioId} (app).
+ * Idempotente: si el folio ya estaba en 103 con el mismo motivo responde este mismo shape.
+ */
+class ReopenDisputeResponse {
+}
+exports.ReopenDisputeResponse = ReopenDisputeResponse;

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

@@ -2,6 +2,7 @@
  * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
  * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
  */
+import { RefundInstruction } from './RefundInstruction';
 export declare class UpdateR27StatusRequest {
     newR27Status: number;
     resolutionDate: string;
@@ -10,4 +11,6 @@ export declare class UpdateR27StatusRequest {
     signedByName: string;
     dictamenS3Key: string;
     contentHash: string;
+    /** Opcional (backward compat). Sólo se persiste refundTransactionId si resolutionCause ∈ 706-709. */
+    refundInstruction?: RefundInstruction;
 }

package/bin/transaction/dtos/UpdateR27StatusRequest.js

@@ -1,10 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateR27StatusRequest = void 0;
-/**
- * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
- * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
- */
 class UpdateR27StatusRequest {
 }
 exports.UpdateR27StatusRequest = UpdateR27StatusRequest;

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

@@ -3,6 +3,7 @@
  * mismo valor numerico (101-104): r27Status es el nombre del contrato, mapeado
  * internamente a disputeOrFraudStatus (vocabulario que ya lee la app).
  */
+import { R27EventPayload } from './R27EventPayload';
 export declare class UpdateR27StatusResponse {
     success: boolean;
     folio: string;
@@ -10,4 +11,6 @@ export declare class UpdateR27StatusResponse {
     r27Status: number;
     disputeOrFraudStatus: string;
     updatedAt: string;
+    lastEvent?: R27EventPayload;
+    refundTransactionId?: string;
 }

package/bin/transaction/dtos/UpdateR27StatusResponse.js

@@ -1,11 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateR27StatusResponse = void 0;
-/**
- * Response 200 del endpoint BO-R27. `r27Status` y `disputeOrFraudStatus` son el
- * mismo valor numerico (101-104): r27Status es el nombre del contrato, mapeado
- * internamente a disputeOrFraudStatus (vocabulario que ya lee la app).
- */
 class UpdateR27StatusResponse {
 }
 exports.UpdateR27StatusResponse = UpdateR27StatusResponse;

package/bin/transaction/enums/R27ActorRoleEnum.d.ts

@@ -0,0 +1,8 @@
+/** Rol de quien ejecuta una transición R27 (`statusHistory[].actor.role`). Valores reales en DDB. */
+export declare enum R27ActorRoleEnum {
+    CLIENT = "client",
+    OFICIAL_CUMPLIMIENTO = "oficial_cumplimiento",
+    TITULAR_UNE = "TitularUNE",
+    BACKOFFICE = "BACKOFFICE",
+    SYSTEM = "System"
+}

package/bin/transaction/enums/R27ActorRoleEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R27ActorRoleEnum = void 0;
+/** Rol de quien ejecuta una transición R27 (`statusHistory[].actor.role`). Valores reales en DDB. */
+var R27ActorRoleEnum;
+(function (R27ActorRoleEnum) {
+    R27ActorRoleEnum["CLIENT"] = "client";
+    R27ActorRoleEnum["OFICIAL_CUMPLIMIENTO"] = "oficial_cumplimiento";
+    R27ActorRoleEnum["TITULAR_UNE"] = "TitularUNE";
+    R27ActorRoleEnum["BACKOFFICE"] = "BACKOFFICE";
+    R27ActorRoleEnum["SYSTEM"] = "System";
+})(R27ActorRoleEnum || (exports.R27ActorRoleEnum = R27ActorRoleEnum = {}));

package/bin/transaction/enums/R27StatusEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado R27 (CNBV) de una reclamación. Se persiste como string en
+ * `DisputeOrFraudLog.disputeOrFraudStatus` y en `statusHistory[].code`.
+ *   101 pendiente · 102 1er dictamen · 103 reapertura (máx 1) · 104 2° dictamen (terminal)
+ */
+export declare enum R27StatusEnum {
+    PENDING = "101",
+    RESOLVED = "102",
+    REOPENED = "103",
+    RESOLVED_AFTER_REOPEN = "104"
+}

package/bin/transaction/enums/R27StatusEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R27StatusEnum = void 0;
+/**
+ * Estado R27 (CNBV) de una reclamación. Se persiste como string en
+ * `DisputeOrFraudLog.disputeOrFraudStatus` y en `statusHistory[].code`.
+ *   101 pendiente · 102 1er dictamen · 103 reapertura (máx 1) · 104 2° dictamen (terminal)
+ */
+var R27StatusEnum;
+(function (R27StatusEnum) {
+    R27StatusEnum["PENDING"] = "101";
+    R27StatusEnum["RESOLVED"] = "102";
+    R27StatusEnum["REOPENED"] = "103";
+    R27StatusEnum["RESOLVED_AFTER_REOPEN"] = "104";
+})(R27StatusEnum || (exports.R27StatusEnum = R27StatusEnum = {}));

package/bin/transaction/index.d.ts

@@ -2,6 +2,11 @@ export * from './dtos/CounterQueryResponse';
 export * from './dtos/UpdateR27StatusRequest';
 export * from './dtos/UpdateR27StatusResponse';
 export * from './dtos/ReopenDisputeRequest';
+export * from './dtos/ReopenDisputeResponse';
+export * from './dtos/R27EventPayload';
+export * from './dtos/RefundInstruction';
+export * from './dtos/DisputeRefundSummary';
+export * from './dtos/DisputeGetDetailResponse';
 export * from './dtos/CreateDisputePrivateRequest';
 export * from './dtos/TransactionCreateRequest';
 export * from './dtos/TransactionCreateResponse';
@@ -36,6 +41,8 @@ export * from './enums/TransactionSourceEnum';
 export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
+export * from './enums/R27StatusEnum';
+export * from './enums/R27ActorRoleEnum';
 export * from './enums/ActivityProblemStatusEnum';
 export * from './enums/RefundChannelEnum';
 export * from './enums/RefundPathTypeEnum';

package/bin/transaction/index.js

@@ -19,6 +19,11 @@ __exportStar(require("./dtos/CounterQueryResponse"), exports);
 __exportStar(require("./dtos/UpdateR27StatusRequest"), exports);
 __exportStar(require("./dtos/UpdateR27StatusResponse"), exports);
 __exportStar(require("./dtos/ReopenDisputeRequest"), exports);
+__exportStar(require("./dtos/ReopenDisputeResponse"), exports);
+__exportStar(require("./dtos/R27EventPayload"), exports);
+__exportStar(require("./dtos/RefundInstruction"), exports);
+__exportStar(require("./dtos/DisputeRefundSummary"), exports);
+__exportStar(require("./dtos/DisputeGetDetailResponse"), exports);
 __exportStar(require("./dtos/CreateDisputePrivateRequest"), exports);
 __exportStar(require("./dtos/TransactionCreateRequest"), exports);
 __exportStar(require("./dtos/TransactionCreateResponse"), exports);
@@ -54,6 +59,8 @@ __exportStar(require("./enums/TransactionSourceEnum"), exports);
 __exportStar(require("./enums/TransactionStatusEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudStatusEnum"), exports);
+__exportStar(require("./enums/R27StatusEnum"), exports);
+__exportStar(require("./enums/R27ActorRoleEnum"), exports);
 __exportStar(require("./enums/ActivityProblemStatusEnum"), exports);
 __exportStar(require("./enums/RefundChannelEnum"), exports);
 __exportStar(require("./enums/RefundPathTypeEnum"), exports);

package/package.json

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

package/src/notificationMessages/dtos/DisputeNotificationData.ts

@@ -0,0 +1,9 @@
+/**
+ * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
+ * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ */
+export class DisputeNotificationData {
+    id: string;        // templateId (DISPUTE_DICTAMEN_PROCEDENTE, DISPUTE_REOPEN_CONFIRMED, ...)
+    folio: string;     // disputeOrFraudFolio
+    folioId?: string;  // id del folio en DisputeOrFraudLog
+}

package/src/notificationMessages/index.ts

@@ -1,5 +1,6 @@
 export * from './dtos/NotificationQueueMessageRequest';
 export * from './dtos/QueueMessageDestination';
+export * from './dtos/DisputeNotificationData';
 export * from './dtos/QueueMessageVariableValues';
 export * from './dtos/NotificationTemplate';
 export * from './dtos/MomentTemplateUpsertRequest';

package/src/rules/dtos/population/PopulationSegmentDefinition.ts

@@ -1,12 +1,15 @@
 import { Expose, Type } from 'class-transformer';
-import { ArrayMaxSize, ArrayMinSize, IsArray, IsEnum, Matches, ValidateNested } from 'class-validator';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsEnum, IsOptional, Matches, ValidateNested } from 'class-validator';
 import { SEGMENT_IDENTIFIER_PATTERN } from '../../constants/SegmentLimits';
 import { SegmentMatchEnum } from '../../enums/SegmentMatchEnum';
+import { SegmentOutputEnum } from '../../enums/SegmentOutputEnum';
 import { SegmentGroup } from './SegmentGroup';
 
 /** El constructor tal cual (A§4.1): tabla ancla (una fila -> un directoryid), TODAS/ALGUNA global y grupos con su propio TODAS/ALGUNA. */
 export class PopulationSegmentDefinition {
     @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) baseTable: string;
+    /** Que se devuelve por fila. Ausente = DIRECTORY_ID. PHONE devuelve el telefono (sirve para personas sin cuenta); en ese caso `ids`/`afterDirectoryId` llevan telefonos. */
+    @Expose() @IsOptional() @IsEnum(SegmentOutputEnum) output?: SegmentOutputEnum;
     @Expose() @IsEnum(SegmentMatchEnum) match: SegmentMatchEnum;
     @Expose() @IsArray() @ArrayMinSize(1) @ArrayMaxSize(10) @ValidateNested({ each: true }) @Type(() => SegmentGroup) groups: SegmentGroup[];
 }

package/src/rules/enums/SegmentOutputEnum.ts

@@ -0,0 +1,5 @@
+/** Que devuelve la poblacion: el directoryId (por defecto) o el telefono (personas sin cuenta, que no tienen directoryId). */
+export enum SegmentOutputEnum {
+    DIRECTORY_ID = 'DIRECTORY_ID',
+    PHONE = 'PHONE',
+}

package/src/rules/index.ts

@@ -21,6 +21,7 @@ export * from './dtos/EvaluateRulesResponse';
 
 //Poblacion (movido desde rewardsEligibility; alli queda re-export)
 export * from './enums/SegmentMatchEnum';
+export * from './enums/SegmentOutputEnum';
 export * from './enums/SegmentConditionKindEnum';
 export * from './enums/SegmentAggregateFnEnum';
 export * from './enums/SegmentOperatorEnum';

package/src/transaction/dtos/DisputeGetDetailResponse.ts

@@ -0,0 +1,33 @@
+import { DisputeRefundSummary } from './DisputeRefundSummary';
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+
+/**
+ * `data` de GET disputes/transaction/{code}/{transactionNumber} (pública, app).
+ * Devuelve el folio completo (todos los atributos de DisputeOrFraudLog) más los campos
+ * normalizados/enriquecidos que la app necesita para el detalle del movimiento.
+ * Vale desde cualquier movimiento ligado al folio (tx reclamada, abono o reversa).
+ */
+export class DisputeGetDetailResponse {
+    id: string;
+    disputeOrFraudFolio: string;
+    directoryId: string;
+    disputeOrFraudStatus: R27StatusEnum;
+    disputeOrFraudStatusUpdate: string;
+    dateOfDisputedTx: string;
+    disputedTxNumber: string;
+    amountOfDisputedTx: number;
+    /** Sentido del dictamen (701-705 improcedente, 706-709 procedente). '' hasta el dictamen. */
+    disputeResolutionCause: string;
+    disputeResolutionDate: string;
+    /** Siempre presente (0 si nunca se reabrió). Botón "segunda revisión": status 102 + causa 701-705 + reopenCount 0. */
+    reopenCount: number;
+    reopenedAt?: string;
+    reopenedReason?: string;
+    refundTransactionId?: string;
+    /** Abono (provisional o por dictamen). */
+    refund?: DisputeRefundSummary;
+    /** Reversa del abono; la fecha del abono original está en `refund.executedAt`. */
+    reversal?: DisputeRefundSummary;
+    /** Resto de atributos del folio (merchant, statusHistory, etc.). */
+    [attribute: string]: unknown;
+}

package/src/transaction/dtos/DisputeRefundSummary.ts

@@ -0,0 +1,15 @@
+import { DisputeRefundStatus } from '../enums/DisputeRefundStatus';
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+
+/**
+ * Reintegro (abono o reversa) ligado a una reclamación, tal como lo consume la app
+ * en el detalle del movimiento. Resumen de una fila de DisputeRefund_GT.
+ */
+export class DisputeRefundSummary {
+    id: string;
+    transactionId?: string;        // id de la tx en PagoConfiadoTx_GT
+    status: DisputeRefundStatus;
+    amount: number;
+    channel?: RefundChannelEnum;
+    executedAt?: string;           // ISO — fecha del abono / de la reversa
+}

package/src/transaction/dtos/R27EventPayload.ts

@@ -0,0 +1,12 @@
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+
+/**
+ * Evento R27 compacto incluido en las respuestas de disputes-business
+ * (reapertura y firma de dictamen). El Dashboard usa `eventId` como
+ * `folioEventId` al autorizar el reintegro.
+ */
+export class R27EventPayload {
+    eventId: string;
+    code: R27StatusEnum;
+    occurredAt: string;
+}

package/src/transaction/dtos/RefundInstruction.ts

@@ -0,0 +1,12 @@
+/**
+ * Instrucción de reintegro adjunta a la firma del dictamen (UpdateR27StatusRequest.refundInstruction).
+ * Política SP1:
+ *   1 = post-dictamen 2FA (el Dashboard genera la tx antes de cerrar el folio)
+ *   2 = T+2 provisional (ya abonado — se confirma el id existente)
+ *   3 = error operativo (reintegro manual)
+ */
+export class RefundInstruction {
+    camino: 1 | 2 | 3;
+    /** Id de la tx de refund en el ledger. Presente cuando el refund ya ocurrió. */
+    refundTransactionId?: string;
+}

package/src/transaction/dtos/ReopenDisputeResponse.ts

@@ -0,0 +1,16 @@
+import { R27EventPayload } from './R27EventPayload';
+
+/**
+ * Response 200 de la reapertura de reclamación (102 -> 103):
+ * privada POST disputes/{folioId}/reopen (CS/OC) y pública POST disputes/reopen/{folioId} (app).
+ * Idempotente: si el folio ya estaba en 103 con el mismo motivo responde este mismo shape.
+ */
+export class ReopenDisputeResponse {
+    success: boolean;
+    folio: string;
+    id: string;
+    currentStatus: number;      // 103
+    reopenCount: number;        // 1
+    updatedAt: string;          // ISO
+    lastEvent?: R27EventPayload; // ausente en folios legacy sin statusHistory
+}

package/src/transaction/dtos/UpdateR27StatusRequest.ts

@@ -2,6 +2,8 @@
  * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
  * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
  */
+import { RefundInstruction } from './RefundInstruction';
+
 export class UpdateR27StatusRequest {
     newR27Status: number;     // 102 | 104
     resolutionDate: string;   // ISO datetime, <= ahora
@@ -10,4 +12,6 @@ export class UpdateR27StatusRequest {
     signedByName: string;
     dictamenS3Key: string;    // path en fiado-prod-data-lake
     contentHash: string;      // sha256:...
+    /** Opcional (backward compat). Sólo se persiste refundTransactionId si resolutionCause ∈ 706-709. */
+    refundInstruction?: RefundInstruction;
 }

package/src/transaction/dtos/UpdateR27StatusResponse.ts

@@ -3,6 +3,8 @@
  * mismo valor numerico (101-104): r27Status es el nombre del contrato, mapeado
  * internamente a disputeOrFraudStatus (vocabulario que ya lee la app).
  */
+import { R27EventPayload } from './R27EventPayload';
+
 export class UpdateR27StatusResponse {
     success: boolean;
     folio: string;
@@ -10,4 +12,6 @@ export class UpdateR27StatusResponse {
     r27Status: number;
     disputeOrFraudStatus: string;
     updatedAt: string;
+    lastEvent?: R27EventPayload;     // evento 102/104 recién agregado a statusHistory
+    refundTransactionId?: string;    // sólo cierres procedentes con refund ligado
 }

package/src/transaction/enums/R27ActorRoleEnum.ts

@@ -0,0 +1,8 @@
+/** Rol de quien ejecuta una transición R27 (`statusHistory[].actor.role`). Valores reales en DDB. */
+export enum R27ActorRoleEnum {
+    CLIENT = "client",
+    OFICIAL_CUMPLIMIENTO = "oficial_cumplimiento",
+    TITULAR_UNE = "TitularUNE",
+    BACKOFFICE = "BACKOFFICE",
+    SYSTEM = "System",
+}

package/src/transaction/enums/R27StatusEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado R27 (CNBV) de una reclamación. Se persiste como string en
+ * `DisputeOrFraudLog.disputeOrFraudStatus` y en `statusHistory[].code`.
+ *   101 pendiente · 102 1er dictamen · 103 reapertura (máx 1) · 104 2° dictamen (terminal)
+ */
+export enum R27StatusEnum {
+    PENDING = "101",
+    RESOLVED = "102",
+    REOPENED = "103",
+    RESOLVED_AFTER_REOPEN = "104",
+}

package/src/transaction/index.ts

@@ -3,6 +3,11 @@ export * from './dtos/CounterQueryResponse';
 export * from './dtos/UpdateR27StatusRequest';
 export * from './dtos/UpdateR27StatusResponse';
 export * from './dtos/ReopenDisputeRequest';
+export * from './dtos/ReopenDisputeResponse';
+export * from './dtos/R27EventPayload';
+export * from './dtos/RefundInstruction';
+export * from './dtos/DisputeRefundSummary';
+export * from './dtos/DisputeGetDetailResponse';
 export * from './dtos/CreateDisputePrivateRequest';
 export * from './dtos/TransactionCreateRequest';
 export * from './dtos/TransactionCreateResponse';
@@ -41,6 +46,8 @@ export * from './enums/TransactionSourceEnum';
 export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
+export * from './enums/R27StatusEnum';
+export * from './enums/R27ActorRoleEnum';
 export * from './enums/ActivityProblemStatusEnum';
 export * from './enums/RefundChannelEnum';
 export * from './enums/RefundPathTypeEnum';