@fiado/type-kit 3.81.0 → 3.83.0

package/_test_/unit/platformRbac/enums/__snapshots__/permissionBits.test.ts.snap

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
 
-exports[`PERMISSION_BIT_ORDER PERMS_VERSION es número estable 1`] = `1113835415`;
+exports[`PERMISSION_BIT_ORDER PERMS_VERSION es número estable 1`] = `231160135`;
 
 exports[`PERMISSION_BIT_ORDER append-only: snapshot del ORDEN COMPLETO (rompe ante cualquier reorden/inserción) 1`] = `
 [
@@ -117,5 +117,6 @@ exports[`PERMISSION_BIT_ORDER append-only: snapshot del ORDEN COMPLETO (rompe an
   "agents.notification.send",
   "agents.export.run",
   "agents.catalog.view",
+  "agents.group.manage",
 ]
 `;

package/bin/platformRbac/enums/Permission.d.ts

@@ -141,7 +141,8 @@ export declare enum Permission {
     AGENTS_CHAT_SEND = "agents.chat.send",
     AGENTS_NOTIFICATION_SEND = "agents.notification.send",
     AGENTS_EXPORT_RUN = "agents.export.run",
-    AGENTS_CATALOG_VIEW = "agents.catalog.view"
+    AGENTS_CATALOG_VIEW = "agents.catalog.view",
+    AGENTS_GROUP_MANAGE = "agents.group.manage"
 }
 /**
  * Orden CANÓNICO y APPEND-ONLY de los permisos para el bitset del token.

package/bin/platformRbac/enums/Permission.js

@@ -183,6 +183,8 @@ var Permission;
     Permission["AGENTS_NOTIFICATION_SEND"] = "agents.notification.send";
     Permission["AGENTS_EXPORT_RUN"] = "agents.export.run";
     Permission["AGENTS_CATALOG_VIEW"] = "agents.catalog.view";
+    // Gestión de grupos del tenant AGENTS (scope TENANT — el operador). Espejo de retail.retailer.manage.
+    Permission["AGENTS_GROUP_MANAGE"] = "agents.group.manage";
 })(Permission || (exports.Permission = Permission = {}));
 /**
  * Orden CANÓNICO y APPEND-ONLY de los permisos para el bitset del token.
@@ -310,6 +312,7 @@ exports.PERMISSION_BIT_ORDER = [
     Permission.AGENTS_NOTIFICATION_SEND,
     Permission.AGENTS_EXPORT_RUN,
     Permission.AGENTS_CATALOG_VIEW,
+    Permission.AGENTS_GROUP_MANAGE,
 ];
 function djb2(input) {
     let h = 5381;

package/bin/riskProfile/dtos/private/AnalisisTransaccionalResponse.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Respuesta de `POST /risk/backoffice/profiles/{directoryId}/analisis-transaccional`
+ * (BO-03 §3.4). El BO calcula server-side los 3 criterios de Vía B
+ * (Manual de Cumplimiento v1.1 §8.30) sobre la ventana indicada y devuelve
+ * un folio determinístico para que el caller lo adjunte como evidencia.
+ */
+/** Criterio (i): no hay alertas reportables (UNUSUAL/WORRYING) abiertas en la ventana. */
+export declare class CriterioAlertasAbiertas {
+    pass: boolean;
+    count: number;
+}
+/** Criterio (ii): el volumen de entradas observado cae dentro de [declarado×0.5, declarado×1.5]. */
+export declare class CriterioVolumenEnRango {
+    pass: boolean;
+    observado: number;
+    declarado: number;
+    min: number;
+    max: number;
+}
+/** Criterio (iii): el nivel de riesgo no empeoró más de 2 niveles en la ventana. */
+export declare class CriterioRiesgoEstable {
+    pass: boolean;
+    delta: number;
+}
+export declare class AnalisisTransaccionalCriterios {
+    alertasAbiertas: CriterioAlertasAbiertas;
+    volumenEnRango: CriterioVolumenEnRango;
+    riesgoEstable: CriterioRiesgoEstable;
+}
+export declare class AnalisisTransaccionalVentana {
+    from: string;
+    to: string;
+}
+export declare class AnalisisTransaccionalResponse {
+    /** Folio determinístico = hash(directoryId, from, to). */
+    folio: string;
+    ventana: AnalisisTransaccionalVentana;
+    criterios: AnalisisTransaccionalCriterios;
+    /** true si y solo si los 3 criterios pasan. */
+    viaBPermitida: boolean;
+}

package/bin/riskProfile/dtos/private/AnalisisTransaccionalResponse.js

@@ -0,0 +1,112 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalisisTransaccionalResponse = exports.AnalisisTransaccionalVentana = exports.AnalisisTransaccionalCriterios = exports.CriterioRiesgoEstable = exports.CriterioVolumenEnRango = exports.CriterioAlertasAbiertas = void 0;
+const class_transformer_1 = require("class-transformer");
+/**
+ * Respuesta de `POST /risk/backoffice/profiles/{directoryId}/analisis-transaccional`
+ * (BO-03 §3.4). El BO calcula server-side los 3 criterios de Vía B
+ * (Manual de Cumplimiento v1.1 §8.30) sobre la ventana indicada y devuelve
+ * un folio determinístico para que el caller lo adjunte como evidencia.
+ */
+/** Criterio (i): no hay alertas reportables (UNUSUAL/WORRYING) abiertas en la ventana. */
+class CriterioAlertasAbiertas {
+}
+exports.CriterioAlertasAbiertas = CriterioAlertasAbiertas;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], CriterioAlertasAbiertas.prototype, "pass", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CriterioAlertasAbiertas.prototype, "count", void 0);
+/** Criterio (ii): el volumen de entradas observado cae dentro de [declarado×0.5, declarado×1.5]. */
+class CriterioVolumenEnRango {
+}
+exports.CriterioVolumenEnRango = CriterioVolumenEnRango;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], CriterioVolumenEnRango.prototype, "pass", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CriterioVolumenEnRango.prototype, "observado", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CriterioVolumenEnRango.prototype, "declarado", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CriterioVolumenEnRango.prototype, "min", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CriterioVolumenEnRango.prototype, "max", void 0);
+/** Criterio (iii): el nivel de riesgo no empeoró más de 2 niveles en la ventana. */
+class CriterioRiesgoEstable {
+}
+exports.CriterioRiesgoEstable = CriterioRiesgoEstable;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], CriterioRiesgoEstable.prototype, "pass", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], CriterioRiesgoEstable.prototype, "delta", void 0);
+class AnalisisTransaccionalCriterios {
+}
+exports.AnalisisTransaccionalCriterios = AnalisisTransaccionalCriterios;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", CriterioAlertasAbiertas)
+], AnalisisTransaccionalCriterios.prototype, "alertasAbiertas", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", CriterioVolumenEnRango)
+], AnalisisTransaccionalCriterios.prototype, "volumenEnRango", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", CriterioRiesgoEstable)
+], AnalisisTransaccionalCriterios.prototype, "riesgoEstable", void 0);
+class AnalisisTransaccionalVentana {
+}
+exports.AnalisisTransaccionalVentana = AnalisisTransaccionalVentana;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AnalisisTransaccionalVentana.prototype, "from", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AnalisisTransaccionalVentana.prototype, "to", void 0);
+class AnalisisTransaccionalResponse {
+}
+exports.AnalisisTransaccionalResponse = AnalisisTransaccionalResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], AnalisisTransaccionalResponse.prototype, "folio", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", AnalisisTransaccionalVentana)
+], AnalisisTransaccionalResponse.prototype, "ventana", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", AnalisisTransaccionalCriterios)
+], AnalisisTransaccionalResponse.prototype, "criterios", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Boolean)
+], AnalisisTransaccionalResponse.prototype, "viaBPermitida", void 0);

package/bin/riskProfile/dtos/private/CreateClientFinancialHistoryRequest.js

@@ -33,7 +33,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsIn)(["declaredMonthlyIncome", "manualRiskLevel", "customHighAmount", "customMonthlyIncrease"]),
+    (0, class_validator_1.IsIn)(["declaredMonthlyIncome", "manualRiskLevel", "customHighAmount", "customMonthlyIncrease", "riskLevel"]),
     __metadata("design:type", String)
 ], CreateClientFinancialHistoryRequest.prototype, "field", void 0);
 __decorate([

package/bin/riskProfile/index.d.ts

@@ -41,3 +41,4 @@ export * from './dtos/private/CreateClientFinancialHistoryRequest';
 export * from './dtos/private/ClientFinancialHistoryResponse';
 export * from './dtos/private/ListClientFinancialHistoryResponse';
 export * from './dtos/private/CreateProfileNoteRequest';
+export * from './dtos/private/AnalisisTransaccionalResponse';

package/bin/riskProfile/index.js

@@ -59,3 +59,4 @@ __exportStar(require("./dtos/private/CreateClientFinancialHistoryRequest"), expo
 __exportStar(require("./dtos/private/ClientFinancialHistoryResponse"), exports);
 __exportStar(require("./dtos/private/ListClientFinancialHistoryResponse"), exports);
 __exportStar(require("./dtos/private/CreateProfileNoteRequest"), exports);
+__exportStar(require("./dtos/private/AnalisisTransaccionalResponse"), exports);

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

@@ -0,0 +1,34 @@
+/**
+ * Contrato de respuesta del endpoint de contadores de transaction-business:
+ * `GET /private/counters/directory/{directoryId}`.
+ *
+ * Reemplaza a los contadores de activity-business (en deprecación). Lo consume
+ * el cliente de `@fiado/api-invoker` y los lambdas que necesitan contadores
+ * agregados (ej. risk-profile-business para el análisis transaccional de Vía B).
+ */
+export type CounterWindow = "day" | "week" | "month" | "quarter" | "semester" | "year" | "allTime";
+/** Resultado agregado de un contador en una ventana. */
+export interface CounterWindowResult {
+    count: number;
+    totalAmount: number;
+}
+/** Ventana de rango arbitrario, fechas calendario MX inclusivas (YYYY-MM-DD). */
+export interface CounterDateRange {
+    from: string;
+    to: string;
+}
+export declare class CounterQueryResult {
+    counterId: string;
+    type: "unique" | "composite";
+    components?: string[];
+    windows: Partial<Record<CounterWindow, CounterWindowResult>>;
+    /** Resultado de la ventana de rango [from,to]; presente solo si se pidió `range`. */
+    range?: CounterWindowResult;
+}
+export declare class CounterQueryResponse {
+    computedAt: string;
+    windowsRequested: CounterWindow[];
+    /** Eco del rango solicitado; presente solo si se pidió. */
+    rangeRequested?: CounterDateRange;
+    results: CounterQueryResult[];
+}

package/bin/transaction/dtos/CounterQueryResponse.js

@@ -0,0 +1,55 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CounterQueryResponse = exports.CounterQueryResult = void 0;
+const class_transformer_1 = require("class-transformer");
+class CounterQueryResult {
+}
+exports.CounterQueryResult = CounterQueryResult;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], CounterQueryResult.prototype, "counterId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], CounterQueryResult.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], CounterQueryResult.prototype, "components", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Object)
+], CounterQueryResult.prototype, "windows", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Object)
+], CounterQueryResult.prototype, "range", void 0);
+class CounterQueryResponse {
+}
+exports.CounterQueryResponse = CounterQueryResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], CounterQueryResponse.prototype, "computedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], CounterQueryResponse.prototype, "windowsRequested", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Object)
+], CounterQueryResponse.prototype, "rangeRequested", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], CounterQueryResponse.prototype, "results", void 0);

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

@@ -0,0 +1,13 @@
+/**
+ * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
+ * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
+ */
+export declare class UpdateR27StatusRequest {
+    newR27Status: number;
+    resolutionDate: string;
+    resolutionCause: number;
+    signedBy: string;
+    signedByName: string;
+    dictamenS3Key: string;
+    contentHash: string;
+}

package/bin/transaction/dtos/UpdateR27StatusRequest.js

@@ -0,0 +1,10 @@
+"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

@@ -0,0 +1,13 @@
+/**
+ * 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).
+ */
+export declare class UpdateR27StatusResponse {
+    success: boolean;
+    folio: string;
+    id: string;
+    r27Status: number;
+    disputeOrFraudStatus: string;
+    updatedAt: string;
+}

package/bin/transaction/dtos/UpdateR27StatusResponse.js

@@ -0,0 +1,11 @@
+"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/index.d.ts

@@ -1,3 +1,5 @@
+export * from './dtos/UpdateR27StatusRequest';
+export * from './dtos/UpdateR27StatusResponse';
 export * from './dtos/TransactionCreateRequest';
 export * from './dtos/TransactionCreateResponse';
 export * from './dtos/TransactionGetDetailResponse';

package/bin/transaction/index.js

@@ -15,6 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 //dtos
+__exportStar(require("./dtos/UpdateR27StatusRequest"), exports);
+__exportStar(require("./dtos/UpdateR27StatusResponse"), exports);
 __exportStar(require("./dtos/TransactionCreateRequest"), exports);
 __exportStar(require("./dtos/TransactionCreateResponse"), exports);
 __exportStar(require("./dtos/TransactionGetDetailResponse"), exports);

package/package.json

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

package/src/platformRbac/enums/Permission.ts

@@ -184,6 +184,8 @@ export enum Permission {
     AGENTS_NOTIFICATION_SEND = 'agents.notification.send',
     AGENTS_EXPORT_RUN = 'agents.export.run',
     AGENTS_CATALOG_VIEW = 'agents.catalog.view',
+    // Gestión de grupos del tenant AGENTS (scope TENANT — el operador). Espejo de retail.retailer.manage.
+    AGENTS_GROUP_MANAGE = 'agents.group.manage',
 }
 
 /**
@@ -312,6 +314,7 @@ export const PERMISSION_BIT_ORDER: readonly Permission[] = [
     Permission.AGENTS_NOTIFICATION_SEND,
     Permission.AGENTS_EXPORT_RUN,
     Permission.AGENTS_CATALOG_VIEW,
+    Permission.AGENTS_GROUP_MANAGE,
 ] as const;
 
 function djb2(input: string): number {

package/src/riskProfile/dtos/private/AnalisisTransaccionalResponse.ts

@@ -0,0 +1,49 @@
+import { Expose } from "class-transformer";
+
+/**
+ * Respuesta de `POST /risk/backoffice/profiles/{directoryId}/analisis-transaccional`
+ * (BO-03 §3.4). El BO calcula server-side los 3 criterios de Vía B
+ * (Manual de Cumplimiento v1.1 §8.30) sobre la ventana indicada y devuelve
+ * un folio determinístico para que el caller lo adjunte como evidencia.
+ */
+
+/** Criterio (i): no hay alertas reportables (UNUSUAL/WORRYING) abiertas en la ventana. */
+export class CriterioAlertasAbiertas {
+    @Expose() pass!: boolean;
+    @Expose() count!: number;
+}
+
+/** Criterio (ii): el volumen de entradas observado cae dentro de [declarado×0.5, declarado×1.5]. */
+export class CriterioVolumenEnRango {
+    @Expose() pass!: boolean;
+    @Expose() observado!: number;
+    @Expose() declarado!: number;
+    @Expose() min!: number;
+    @Expose() max!: number;
+}
+
+/** Criterio (iii): el nivel de riesgo no empeoró más de 2 niveles en la ventana. */
+export class CriterioRiesgoEstable {
+    @Expose() pass!: boolean;
+    @Expose() delta!: number;
+}
+
+export class AnalisisTransaccionalCriterios {
+    @Expose() alertasAbiertas!: CriterioAlertasAbiertas;
+    @Expose() volumenEnRango!: CriterioVolumenEnRango;
+    @Expose() riesgoEstable!: CriterioRiesgoEstable;
+}
+
+export class AnalisisTransaccionalVentana {
+    @Expose() from!: string;
+    @Expose() to!: string;
+}
+
+export class AnalisisTransaccionalResponse {
+    /** Folio determinístico = hash(directoryId, from, to). */
+    @Expose() folio!: string;
+    @Expose() ventana!: AnalisisTransaccionalVentana;
+    @Expose() criterios!: AnalisisTransaccionalCriterios;
+    /** true si y solo si los 3 criterios pasan. */
+    @Expose() viaBPermitida!: boolean;
+}

package/src/riskProfile/dtos/private/CreateClientFinancialHistoryRequest.ts

@@ -17,10 +17,11 @@ export class CreateClientFinancialHistoryRequest {
     @IsNotEmpty()
     directoryId!: string;
 
-    // Campo que cambió. Enum acotado a los 4 factores declarados del MVP (§3.2).
+    // Campo que cambió. Los 4 factores declarados (§3.2) + `riskLevel` para
+    // auditar el recálculo automático del nivel (triggeredBy=SYSTEM, BO-03 §iii).
     @Expose()
     @IsString()
-    @IsIn(["declaredMonthlyIncome", "manualRiskLevel", "customHighAmount", "customMonthlyIncrease"])
+    @IsIn(["declaredMonthlyIncome", "manualRiskLevel", "customHighAmount", "customMonthlyIncrease", "riskLevel"])
     field!: string;
 
     // Valor anterior: number, o null/omitido en alta (sin valor previo).

package/src/riskProfile/index.ts

@@ -46,4 +46,5 @@ export * from './dtos/private/CreateClientFinancialHistoryRequest';
 export * from './dtos/private/ClientFinancialHistoryResponse';
 export * from './dtos/private/ListClientFinancialHistoryResponse';
 export * from './dtos/private/CreateProfileNoteRequest';
+export * from './dtos/private/AnalisisTransaccionalResponse';
 

package/src/transaction/dtos/CounterQueryResponse.ts

@@ -0,0 +1,42 @@
+import { Expose } from "class-transformer";
+
+/**
+ * Contrato de respuesta del endpoint de contadores de transaction-business:
+ * `GET /private/counters/directory/{directoryId}`.
+ *
+ * Reemplaza a los contadores de activity-business (en deprecación). Lo consume
+ * el cliente de `@fiado/api-invoker` y los lambdas que necesitan contadores
+ * agregados (ej. risk-profile-business para el análisis transaccional de Vía B).
+ */
+
+export type CounterWindow =
+    | "day" | "week" | "month" | "quarter" | "semester" | "year" | "allTime";
+
+/** Resultado agregado de un contador en una ventana. */
+export interface CounterWindowResult {
+    count: number;
+    totalAmount: number;
+}
+
+/** Ventana de rango arbitrario, fechas calendario MX inclusivas (YYYY-MM-DD). */
+export interface CounterDateRange {
+    from: string;
+    to: string;
+}
+
+export class CounterQueryResult {
+    @Expose() counterId!: string;
+    @Expose() type!: "unique" | "composite";
+    @Expose() components?: string[];
+    @Expose() windows!: Partial<Record<CounterWindow, CounterWindowResult>>;
+    /** Resultado de la ventana de rango [from,to]; presente solo si se pidió `range`. */
+    @Expose() range?: CounterWindowResult;
+}
+
+export class CounterQueryResponse {
+    @Expose() computedAt!: string;
+    @Expose() windowsRequested!: CounterWindow[];
+    /** Eco del rango solicitado; presente solo si se pidió. */
+    @Expose() rangeRequested?: CounterDateRange;
+    @Expose() results!: CounterQueryResult[];
+}

package/src/transaction/dtos/UpdateR27StatusRequest.ts

@@ -0,0 +1,13 @@
+/**
+ * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
+ * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
+ */
+export class UpdateR27StatusRequest {
+    newR27Status: number;     // 102 | 104
+    resolutionDate: string;   // ISO datetime, <= ahora
+    resolutionCause: number;  // 701-709 (catalogo R27 sentido_resolucion)
+    signedBy: string;         // email del Titular UNE
+    signedByName: string;
+    dictamenS3Key: string;    // path en fiado-prod-data-lake
+    contentHash: string;      // sha256:...
+}

package/src/transaction/dtos/UpdateR27StatusResponse.ts

@@ -0,0 +1,13 @@
+/**
+ * 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).
+ */
+export class UpdateR27StatusResponse {
+    success: boolean;
+    folio: string;
+    id: string;
+    r27Status: number;
+    disputeOrFraudStatus: string;
+    updatedAt: string;
+}

package/src/transaction/index.ts

@@ -1,4 +1,6 @@
 //dtos
+export * from './dtos/UpdateR27StatusRequest';
+export * from './dtos/UpdateR27StatusResponse';
 export * from './dtos/TransactionCreateRequest';
 export * from './dtos/TransactionCreateResponse';
 export * from './dtos/TransactionGetDetailResponse';