@fiado/type-kit 3.139.0 → 3.141.0

package/bin/remittance/enums/AuditEntityType.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditEntityType = void 0;
+/**
+ * Módulo/dominio afectado por una entrada del audit trail (PK de RemittanceAuditLog_GT).
+ */
+var AuditEntityType;
+(function (AuditEntityType) {
+    AuditEntityType["COHORT"] = "COHORT";
+    AuditEntityType["COMMITTEE"] = "COMMITTEE";
+    AuditEntityType["SEGMENT"] = "SEGMENT";
+    AuditEntityType["PRICING"] = "PRICING";
+    AuditEntityType["PROMOTION"] = "PROMOTION";
+    AuditEntityType["RULE"] = "RULE";
+    AuditEntityType["USER"] = "USER";
+})(AuditEntityType || (exports.AuditEntityType = AuditEntityType = {}));

package/bin/remittance/enums/CohortField.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Campos conductuales del rule builder de Cohorts (Dashboard Ops · Configuración §3).
+ * Los valores son los del mockup (snake_case) para que el front no traduzca.
+ *
+ * MVP soporta 6 campos; TX_POST_REACTIVACION está DIFERIDO (el backend lo rechaza
+ * hasta que exista el contador denormalizado `txSinceReactivation` en el connector).
+ */
+export declare enum CohortField {
+    /** # de tx totales (RemittanceUsers_GT.txCount). */
+    TX_TOTALES = "tx_totales",
+    /** Días desde el signup (now − (unirSignupDate ?? createdAt)). */
+    DIAS_DESDE_SIGNUP = "dias_desde_signup",
+    /** Días desde la última tx (now − lastTxAt). */
+    DIAS_DESDE_ULTIMA_TX = "dias_desde_ultima_tx",
+    /** Días sin actividad — sinónimo de DIAS_DESDE_ULTIMA_TX. */
+    DIAS_SIN_TX = "dias_sin_tx",
+    /** Monto total histórico en USD (RemittanceUsers_GT.totalSentUSD). */
+    MONTO_TOTAL_HISTORICO = "monto_total_historico",
+    /** Tx en los últimos 30 días (query nivel-tx por usuario). */
+    TX_ULTIMOS_30_DIAS = "tx_ultimos_30_dias",
+    /** # de tx tras reactivación — DIFERIDO (no-MVP, el backend lo rechaza). */
+    TX_POST_REACTIVACION = "tx_post_reactivacion"
+}

package/bin/remittance/enums/CohortField.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortField = void 0;
+/**
+ * Campos conductuales del rule builder de Cohorts (Dashboard Ops · Configuración §3).
+ * Los valores son los del mockup (snake_case) para que el front no traduzca.
+ *
+ * MVP soporta 6 campos; TX_POST_REACTIVACION está DIFERIDO (el backend lo rechaza
+ * hasta que exista el contador denormalizado `txSinceReactivation` en el connector).
+ */
+var CohortField;
+(function (CohortField) {
+    /** # de tx totales (RemittanceUsers_GT.txCount). */
+    CohortField["TX_TOTALES"] = "tx_totales";
+    /** Días desde el signup (now − (unirSignupDate ?? createdAt)). */
+    CohortField["DIAS_DESDE_SIGNUP"] = "dias_desde_signup";
+    /** Días desde la última tx (now − lastTxAt). */
+    CohortField["DIAS_DESDE_ULTIMA_TX"] = "dias_desde_ultima_tx";
+    /** Días sin actividad — sinónimo de DIAS_DESDE_ULTIMA_TX. */
+    CohortField["DIAS_SIN_TX"] = "dias_sin_tx";
+    /** Monto total histórico en USD (RemittanceUsers_GT.totalSentUSD). */
+    CohortField["MONTO_TOTAL_HISTORICO"] = "monto_total_historico";
+    /** Tx en los últimos 30 días (query nivel-tx por usuario). */
+    CohortField["TX_ULTIMOS_30_DIAS"] = "tx_ultimos_30_dias";
+    /** # de tx tras reactivación — DIFERIDO (no-MVP, el backend lo rechaza). */
+    CohortField["TX_POST_REACTIVACION"] = "tx_post_reactivacion";
+})(CohortField || (exports.CohortField = CohortField = {}));

package/bin/remittance/enums/CohortOperator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Operadores de comparación del rule builder de Cohorts. Los valores son los
+ * símbolos que renderiza el mockup; todas las condiciones se evalúan en AND.
+ */
+export declare enum CohortOperator {
+    LT = "<",
+    LTE = "<=",
+    EQ = "==",
+    GTE = ">=",
+    GT = ">"
+}

package/bin/remittance/enums/CohortOperator.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortOperator = void 0;
+/**
+ * Operadores de comparación del rule builder de Cohorts. Los valores son los
+ * símbolos que renderiza el mockup; todas las condiciones se evalúan en AND.
+ */
+var CohortOperator;
+(function (CohortOperator) {
+    CohortOperator["LT"] = "<";
+    CohortOperator["LTE"] = "<=";
+    CohortOperator["EQ"] = "==";
+    CohortOperator["GTE"] = ">=";
+    CohortOperator["GT"] = ">";
+})(CohortOperator || (exports.CohortOperator = CohortOperator = {}));

package/bin/remittance/enums/CohortRefresh.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Frecuencia de recálculo de un cohort. Un solo cron horario en remittance-business
+ * honra las 3 frecuencias respetando `nextCalculationAt` (+1h / +1d / +7d).
+ */
+export declare enum CohortRefresh {
+    HORARIO = "horario",
+    DIARIO = "diario",
+    SEMANAL = "semanal"
+}

package/bin/remittance/enums/CohortRefresh.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortRefresh = void 0;
+/**
+ * Frecuencia de recálculo de un cohort. Un solo cron horario en remittance-business
+ * honra las 3 frecuencias respetando `nextCalculationAt` (+1h / +1d / +7d).
+ */
+var CohortRefresh;
+(function (CohortRefresh) {
+    CohortRefresh["HORARIO"] = "horario";
+    CohortRefresh["DIARIO"] = "diario";
+    CohortRefresh["SEMANAL"] = "semanal";
+})(CohortRefresh || (exports.CohortRefresh = CohortRefresh = {}));

package/bin/remittance/enums/index.d.ts

@@ -5,3 +5,8 @@ export * from "./RemittanceUserState";
 export * from "./RemittanceCancelledByEnum";
 export * from "./RemittanceCancelOutcomeEnum";
 export * from "./FeeAbsorbedByEnum";
+export * from "./CohortField";
+export * from "./CohortOperator";
+export * from "./CohortRefresh";
+export * from "./AuditAction";
+export * from "./AuditEntityType";

package/bin/remittance/enums/index.js

@@ -21,3 +21,8 @@ __exportStar(require("./RemittanceUserState"), exports);
 __exportStar(require("./RemittanceCancelledByEnum"), exports);
 __exportStar(require("./RemittanceCancelOutcomeEnum"), exports);
 __exportStar(require("./FeeAbsorbedByEnum"), exports);
+__exportStar(require("./CohortField"), exports);
+__exportStar(require("./CohortOperator"), exports);
+__exportStar(require("./CohortRefresh"), exports);
+__exportStar(require("./AuditAction"), exports);
+__exportStar(require("./AuditEntityType"), exports);

package/bin/remittance/index.d.ts

@@ -2,3 +2,4 @@ export * from "./enums";
 export * from "./dtos";
 export * from "./dtos/internal/RemittanceCreditBackRequest";
 export * from "./dtos/internal/RemittanceCreditBackResponse";
+export * from "./dtos/internal/RemittanceCohortCount";

package/bin/remittance/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./enums"), exports);
 __exportStar(require("./dtos"), exports);
 __exportStar(require("./dtos/internal/RemittanceCreditBackRequest"), exports);
 __exportStar(require("./dtos/internal/RemittanceCreditBackResponse"), exports);
+__exportStar(require("./dtos/internal/RemittanceCohortCount"), exports);

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.d.ts

@@ -0,0 +1,5 @@
+export declare class CancelFundingReferenceRequest {
+    fundingId: string;
+    directoryId: string;
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -0,0 +1,31 @@
+"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.CancelFundingReferenceRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelFundingReferenceRequest {
+}
+exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "fundingId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelFundingReferenceResponse {
+    fundingId: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingReferenceResponse = void 0;
+class CancelFundingReferenceResponse {
+}
+exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

package/bin/walletFunding/dtos/CancelFundingRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+export declare class CancelFundingRequest {
+    idempotencyKey: string;
+    providerModuleName: string;
+}

package/bin/{platformRbac/dtos/ResendOtpRequest.js → walletFunding/dtos/CancelFundingRequest.js}

@@ -9,28 +9,25 @@ 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.ResendOtpRequest = void 0;
-const class_transformer_1 = require("class-transformer");
+exports.CancelFundingRequest = void 0;
 const class_validator_1 = require("class-validator");
 /**
- * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
- * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
- * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
- * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
- * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
  */
-class ResendOtpRequest {
+class CancelFundingRequest {
 }
-exports.ResendOtpRequest = ResendOtpRequest;
+exports.CancelFundingRequest = CancelFundingRequest;
 __decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsEmail)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
-], ResendOtpRequest.prototype, "email", void 0);
+], CancelFundingRequest.prototype, "idempotencyKey", void 0);
 __decorate([
-    (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(128),
     __metadata("design:type", String)
-], ResendOtpRequest.prototype, "tenantId", void 0);
+], CancelFundingRequest.prototype, "providerModuleName", void 0);

package/bin/walletFunding/dtos/CancelFundingResponse.d.ts

@@ -0,0 +1,14 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+export declare class CancelFundingResponse {
+    fundingId: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingResponse = void 0;
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+class CancelFundingResponse {
+}
+exports.CancelFundingResponse = CancelFundingResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -0,0 +1,3 @@
+export declare class CancelWalletFundingRequest {
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -0,0 +1,21 @@
+"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.CancelWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelWalletFundingRequest {
+}
+exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelWalletFundingResponse {
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    fundingId?: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelWalletFundingResponse = void 0;
+class CancelWalletFundingResponse {
+}
+exports.CancelWalletFundingResponse = CancelWalletFundingResponse;

package/package.json

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

package/src/remittance/dtos/RemittanceAuditLog.ts

@@ -0,0 +1,60 @@
+import { IsEnum, IsObject, IsOptional, IsString, MaxLength } from "class-validator";
+import { AuditAction } from "../enums/AuditAction";
+import { AuditEntityType } from "../enums/AuditEntityType";
+
+/**
+ * DTOs del audit trail del backoffice de remesas (RemittanceAuditLog_GT, dueño:
+ * remittance-business). Append-only: registra "quién cambió qué, cuándo" en cada
+ * mutación (Configuración, Variables Operativas y, a futuro, suspend/reactivate
+ * desde el connector vía api-invoker — por eso el request vive en type-kit).
+ *
+ * MVP persiste `summary` + `after` (snapshot nuevo); `before` se agrega después
+ * si la UI quiere diff visual.
+ */
+
+/** Request de append (helper `recordAudit` en rb; futuro cross-lambda). */
+export class AuditAppendRequest {
+    @IsEnum(AuditEntityType)
+    entityType!: AuditEntityType;
+
+    /** Id de la entidad afectada (cohortId, segmentId, directoryId…). */
+    @IsString()
+    entityId!: string;
+
+    @IsEnum(AuditAction)
+    action!: AuditAction;
+
+    /** Email del operador (claim del JWT) o "sistema" para jobs. */
+    @IsString()
+    actor!: string;
+
+    /** Descripción legible ("Editó condiciones del cohort 'Activo'"). */
+    @IsString()
+    @MaxLength(500)
+    summary!: string;
+
+    /** Snapshot del estado nuevo de la entidad (opcional). */
+    @IsOptional()
+    @IsObject()
+    after?: Record<string, unknown>;
+}
+
+/** Entrada del audit trail (response). */
+export class AuditLogEntry {
+    entityType!: AuditEntityType;
+    /** SK: ISO-8601 + `#<uuid>` (orden cronológico + unicidad dentro del entityType). */
+    at!: string;
+    actor!: string;
+    entityId!: string;
+    action!: AuditAction;
+    summary!: string;
+    after!: Record<string, unknown> | null;
+    createdAt!: string;
+}
+
+/** Response de GET /backoffice/audit (paginación estándar index/pageSize). */
+export class AuditListResponse {
+    items!: AuditLogEntry[];
+    /** Cursor opaco (base64) para la próxima página; null/ausente = última. */
+    index?: string | null;
+}

package/src/remittance/dtos/RemittanceBackofficeTransaction.ts

@@ -9,6 +9,12 @@ export class RemittanceBackofficeTransaction {
     directoryId!: string;
     txNumber!: string;
     marketplaceTransactionNumber?: string;
+    /**
+     * Nombre del remitente (usuario de remesas). Se resuelve en el connector
+     * uniendo `directoryId` → `RemittanceUser.fullName` (tabla de remesas), NO
+     * viene de directory. `null` si el usuario aún no tiene `fullName` snapshotteado.
+     */
+    senderName?: string | null;
     beneficiaryId!: string;
     beneficiaryName!: string;
     countryISO!: string;

package/src/remittance/dtos/RemittanceBackofficeUserView.ts

@@ -6,6 +6,12 @@
 export class RemittanceBackofficeUserView {
     directoryId!: string;
     unirEmail!: string;
+    /** Nombre del usuario (snapshot de identidad UNIR en la tabla de remesas). `null` si aún no se snapshoteó. */
+    fullName?: string | null;
+    /** Ciudad del usuario (RemittanceUser.addressCity). `null` si no está poblada. */
+    city?: string | null;
+    /** Estado/provincia del usuario (RemittanceUser.addressState). `null` si no está poblada. */
+    state?: string | null;
     status!: string;
     remitterStatus?: string;
     remitterLevel?: string;

package/src/remittance/dtos/RemittanceCohort.ts

@@ -0,0 +1,112 @@
+import { Type } from "class-transformer";
+import {
+    ArrayMinSize,
+    IsArray,
+    IsEnum,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Length,
+    MaxLength,
+    ValidateNested,
+} from "class-validator";
+import { CohortField } from "../enums/CohortField";
+import { CohortOperator } from "../enums/CohortOperator";
+import { CohortRefresh } from "../enums/CohortRefresh";
+
+/**
+ * DTOs de Cohorts (Dashboard Ops · Configuración §3, EP-26..30).
+ *
+ * Un cohort es un grupo dinámico de clientes definido por condiciones en AND
+ * (rule builder del mockup) que se recalcula periódicamente. Dueño de la tabla:
+ * remittance-business (RemittanceCohorts_GT). Solo se persiste el count (D4.5),
+ * nunca la membership.
+ */
+
+/** Condición del rule builder: `SI <field> <op> <value>`. Todas en AND. */
+export class CohortCondition {
+    @IsEnum(CohortField)
+    field!: CohortField;
+
+    @IsEnum(CohortOperator)
+    op!: CohortOperator;
+
+    @IsNumber()
+    value!: number;
+}
+
+/** Body de EP-27 POST /backoffice/config/cohorts. */
+export class CreateCohortRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions!: CohortCondition[];
+
+    @IsEnum(CohortRefresh)
+    refresh!: CohortRefresh;
+}
+
+/** Body de EP-28 PUT /backoffice/config/cohorts/{id} (reemplazo completo, patrón Save del mockup). */
+export class UpdateCohortRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions!: CohortCondition[];
+
+    @IsEnum(CohortRefresh)
+    refresh!: CohortRefresh;
+}
+
+/** Cohort completo (response). `memberCount`/`pctTotal` son null si nunca se calculó. */
+export class Cohort {
+    id!: string;
+    name!: string;
+    description!: string | null;
+    conditions!: CohortCondition[];
+    refresh!: CohortRefresh;
+    /** Clientes actualmente en el cohort (snapshot del último recálculo). */
+    memberCount!: number | null;
+    /** % del total de RemittanceUsers (denominador = todos, no solo ACTIVE). 0-100. */
+    pctTotal!: number | null;
+    lastCalculatedAt!: string | null;
+    /** ISO — próxima corrida que el cron horario debe honrar (derivado de `refresh`). */
+    nextCalculationAt!: string;
+    createdAt!: string;
+    updatedAt!: string;
+    createdBy!: string;
+    updatedBy!: string;
+}
+
+/** Response de EP-26 GET /backoffice/config/cohorts (tabla chica, sin paginación). */
+export class CohortListResponse {
+    items!: Cohort[];
+}
+
+/** Response de EP-30 POST /backoffice/config/cohorts/{id}/recalcular. */
+export class RecalculateCohortResponse {
+    id!: string;
+    memberCount!: number;
+    pctTotal!: number;
+    lastCalculatedAt!: string;
+    nextCalculationAt!: string;
+}

package/src/remittance/dtos/index.ts

@@ -36,3 +36,5 @@ export * from "./RemittanceBackofficeTxListResponse";
 export * from "./RemittanceBackofficeStats";
 export * from "./RemittanceUserLimits";
 export * from "./RemittanceKyc";
+export * from "./RemittanceCohort";
+export * from "./RemittanceAuditLog";

package/src/remittance/dtos/internal/RemittanceCohortCount.ts

@@ -0,0 +1,24 @@
+import { Type } from "class-transformer";
+import { ArrayMinSize, IsArray, ValidateNested } from "class-validator";
+import { CohortCondition } from "../RemittanceCohort";
+
+/**
+ * Contrato interno del puente de recálculo de Cohorts (Opción A):
+ * remittance-business pide al uniteller-connector (dueño de RemittanceUsers_GT /
+ * RemittanceTransactions_GT) cuántos usuarios cumplen las condiciones, vía
+ * api-invoker → POST /backoffice/config/cohorts/count (privado).
+ */
+export class CohortCountRequest {
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions!: CohortCondition[];
+}
+
+export class CohortCountResponse {
+    /** Usuarios que cumplen TODAS las condiciones (AND). */
+    count!: number;
+    /** Universo total de RemittanceUsers (denominador del % — todos, no solo ACTIVE). */
+    total!: number;
+}

package/src/remittance/enums/AuditAction.ts

@@ -0,0 +1,12 @@
+/**
+ * Acción registrada en el audit trail del backoffice de remesas (RemittanceAuditLog_GT).
+ * SUSPEND/REACTIVATE quedan listos para el flujo futuro de Operación (EP-02/03).
+ */
+export enum AuditAction {
+    CREATE = "CREATE",
+    UPDATE = "UPDATE",
+    DELETE = "DELETE",
+    RECALCULATE = "RECALCULATE",
+    SUSPEND = "SUSPEND",
+    REACTIVATE = "REACTIVATE",
+}

package/src/remittance/enums/AuditEntityType.ts

@@ -0,0 +1,12 @@
+/**
+ * Módulo/dominio afectado por una entrada del audit trail (PK de RemittanceAuditLog_GT).
+ */
+export enum AuditEntityType {
+    COHORT = "COHORT",
+    COMMITTEE = "COMMITTEE",
+    SEGMENT = "SEGMENT",
+    PRICING = "PRICING",
+    PROMOTION = "PROMOTION",
+    RULE = "RULE",
+    USER = "USER",
+}

package/src/remittance/enums/CohortField.ts

@@ -0,0 +1,23 @@
+/**
+ * Campos conductuales del rule builder de Cohorts (Dashboard Ops · Configuración §3).
+ * Los valores son los del mockup (snake_case) para que el front no traduzca.
+ *
+ * MVP soporta 6 campos; TX_POST_REACTIVACION está DIFERIDO (el backend lo rechaza
+ * hasta que exista el contador denormalizado `txSinceReactivation` en el connector).
+ */
+export enum CohortField {
+    /** # de tx totales (RemittanceUsers_GT.txCount). */
+    TX_TOTALES = "tx_totales",
+    /** Días desde el signup (now − (unirSignupDate ?? createdAt)). */
+    DIAS_DESDE_SIGNUP = "dias_desde_signup",
+    /** Días desde la última tx (now − lastTxAt). */
+    DIAS_DESDE_ULTIMA_TX = "dias_desde_ultima_tx",
+    /** Días sin actividad — sinónimo de DIAS_DESDE_ULTIMA_TX. */
+    DIAS_SIN_TX = "dias_sin_tx",
+    /** Monto total histórico en USD (RemittanceUsers_GT.totalSentUSD). */
+    MONTO_TOTAL_HISTORICO = "monto_total_historico",
+    /** Tx en los últimos 30 días (query nivel-tx por usuario). */
+    TX_ULTIMOS_30_DIAS = "tx_ultimos_30_dias",
+    /** # de tx tras reactivación — DIFERIDO (no-MVP, el backend lo rechaza). */
+    TX_POST_REACTIVACION = "tx_post_reactivacion",
+}

package/src/remittance/enums/CohortOperator.ts

@@ -0,0 +1,11 @@
+/**
+ * Operadores de comparación del rule builder de Cohorts. Los valores son los
+ * símbolos que renderiza el mockup; todas las condiciones se evalúan en AND.
+ */
+export enum CohortOperator {
+    LT = "<",
+    LTE = "<=",
+    EQ = "==",
+    GTE = ">=",
+    GT = ">",
+}