@fiado/type-kit 3.140.0 → 3.141.0

package/bin/remittance/dtos/RemittanceAuditLog.d.ts

@@ -0,0 +1,42 @@
+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 declare class AuditAppendRequest {
+    entityType: AuditEntityType;
+    /** Id de la entidad afectada (cohortId, segmentId, directoryId…). */
+    entityId: string;
+    action: AuditAction;
+    /** Email del operador (claim del JWT) o "sistema" para jobs. */
+    actor: string;
+    /** Descripción legible ("Editó condiciones del cohort 'Activo'"). */
+    summary: string;
+    /** Snapshot del estado nuevo de la entidad (opcional). */
+    after?: Record<string, unknown>;
+}
+/** Entrada del audit trail (response). */
+export declare 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 declare class AuditListResponse {
+    items: AuditLogEntry[];
+    /** Cursor opaco (base64) para la próxima página; null/ausente = última. */
+    index?: string | null;
+}

package/bin/remittance/dtos/RemittanceAuditLog.js

@@ -0,0 +1,62 @@
+"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.AuditListResponse = exports.AuditLogEntry = exports.AuditAppendRequest = void 0;
+const class_validator_1 = require("class-validator");
+const AuditAction_1 = require("../enums/AuditAction");
+const AuditEntityType_1 = require("../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). */
+class AuditAppendRequest {
+}
+exports.AuditAppendRequest = AuditAppendRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(AuditEntityType_1.AuditEntityType),
+    __metadata("design:type", String)
+], AuditAppendRequest.prototype, "entityType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditAppendRequest.prototype, "entityId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(AuditAction_1.AuditAction),
+    __metadata("design:type", String)
+], AuditAppendRequest.prototype, "action", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditAppendRequest.prototype, "actor", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], AuditAppendRequest.prototype, "summary", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], AuditAppendRequest.prototype, "after", void 0);
+/** Entrada del audit trail (response). */
+class AuditLogEntry {
+}
+exports.AuditLogEntry = AuditLogEntry;
+/** Response de GET /backoffice/audit (paginación estándar index/pageSize). */
+class AuditListResponse {
+}
+exports.AuditListResponse = AuditListResponse;

package/bin/remittance/dtos/RemittanceCohort.d.ts

@@ -0,0 +1,62 @@
+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 declare class CohortCondition {
+    field: CohortField;
+    op: CohortOperator;
+    value: number;
+}
+/** Body de EP-27 POST /backoffice/config/cohorts. */
+export declare class CreateCohortRequest {
+    name: string;
+    description?: string;
+    conditions: CohortCondition[];
+    refresh: CohortRefresh;
+}
+/** Body de EP-28 PUT /backoffice/config/cohorts/{id} (reemplazo completo, patrón Save del mockup). */
+export declare class UpdateCohortRequest {
+    name: string;
+    description?: string;
+    conditions: CohortCondition[];
+    refresh: CohortRefresh;
+}
+/** Cohort completo (response). `memberCount`/`pctTotal` son null si nunca se calculó. */
+export declare 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 declare class CohortListResponse {
+    items: Cohort[];
+}
+/** Response de EP-30 POST /backoffice/config/cohorts/{id}/recalcular. */
+export declare class RecalculateCohortResponse {
+    id: string;
+    memberCount: number;
+    pctTotal: number;
+    lastCalculatedAt: string;
+    nextCalculationAt: string;
+}

package/bin/remittance/dtos/RemittanceCohort.js

@@ -0,0 +1,105 @@
+"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.RecalculateCohortResponse = exports.CohortListResponse = exports.Cohort = exports.UpdateCohortRequest = exports.CreateCohortRequest = exports.CohortCondition = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CohortField_1 = require("../enums/CohortField");
+const CohortOperator_1 = require("../enums/CohortOperator");
+const CohortRefresh_1 = require("../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. */
+class CohortCondition {
+}
+exports.CohortCondition = CohortCondition;
+__decorate([
+    (0, class_validator_1.IsEnum)(CohortField_1.CohortField),
+    __metadata("design:type", String)
+], CohortCondition.prototype, "field", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CohortOperator_1.CohortOperator),
+    __metadata("design:type", String)
+], CohortCondition.prototype, "op", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], CohortCondition.prototype, "value", void 0);
+/** Body de EP-27 POST /backoffice/config/cohorts. */
+class CreateCohortRequest {
+}
+exports.CreateCohortRequest = CreateCohortRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 100),
+    __metadata("design:type", String)
+], CreateCohortRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateCohortRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CohortCondition),
+    __metadata("design:type", Array)
+], CreateCohortRequest.prototype, "conditions", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CohortRefresh_1.CohortRefresh),
+    __metadata("design:type", String)
+], CreateCohortRequest.prototype, "refresh", void 0);
+/** Body de EP-28 PUT /backoffice/config/cohorts/{id} (reemplazo completo, patrón Save del mockup). */
+class UpdateCohortRequest {
+}
+exports.UpdateCohortRequest = UpdateCohortRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 100),
+    __metadata("design:type", String)
+], UpdateCohortRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], UpdateCohortRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CohortCondition),
+    __metadata("design:type", Array)
+], UpdateCohortRequest.prototype, "conditions", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CohortRefresh_1.CohortRefresh),
+    __metadata("design:type", String)
+], UpdateCohortRequest.prototype, "refresh", void 0);
+/** Cohort completo (response). `memberCount`/`pctTotal` son null si nunca se calculó. */
+class Cohort {
+}
+exports.Cohort = Cohort;
+/** Response de EP-26 GET /backoffice/config/cohorts (tabla chica, sin paginación). */
+class CohortListResponse {
+}
+exports.CohortListResponse = CohortListResponse;
+/** Response de EP-30 POST /backoffice/config/cohorts/{id}/recalcular. */
+class RecalculateCohortResponse {
+}
+exports.RecalculateCohortResponse = RecalculateCohortResponse;

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

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

package/bin/remittance/dtos/index.js

@@ -52,3 +52,5 @@ __exportStar(require("./RemittanceBackofficeTxListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeStats"), exports);
 __exportStar(require("./RemittanceUserLimits"), exports);
 __exportStar(require("./RemittanceKyc"), exports);
+__exportStar(require("./RemittanceCohort"), exports);
+__exportStar(require("./RemittanceAuditLog"), exports);

package/bin/remittance/dtos/internal/RemittanceCohortCount.d.ts

@@ -0,0 +1,16 @@
+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 declare class CohortCountRequest {
+    conditions: CohortCondition[];
+}
+export declare class CohortCountResponse {
+    /** Usuarios que cumplen TODAS las condiciones (AND). */
+    count: number;
+    /** Universo total de RemittanceUsers (denominador del % — todos, no solo ACTIVE). */
+    total: number;
+}

package/bin/remittance/dtos/internal/RemittanceCohortCount.js

@@ -0,0 +1,34 @@
+"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.CohortCountResponse = exports.CohortCountRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RemittanceCohort_1 = require("../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).
+ */
+class CohortCountRequest {
+}
+exports.CohortCountRequest = CohortCountRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RemittanceCohort_1.CohortCondition),
+    __metadata("design:type", Array)
+], CohortCountRequest.prototype, "conditions", void 0);
+class CohortCountResponse {
+}
+exports.CohortCountResponse = CohortCountResponse;

package/bin/remittance/enums/AuditAction.d.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 declare enum AuditAction {
+    CREATE = "CREATE",
+    UPDATE = "UPDATE",
+    DELETE = "DELETE",
+    RECALCULATE = "RECALCULATE",
+    SUSPEND = "SUSPEND",
+    REACTIVATE = "REACTIVATE"
+}

package/bin/remittance/enums/AuditAction.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditAction = void 0;
+/**
+ * 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).
+ */
+var AuditAction;
+(function (AuditAction) {
+    AuditAction["CREATE"] = "CREATE";
+    AuditAction["UPDATE"] = "UPDATE";
+    AuditAction["DELETE"] = "DELETE";
+    AuditAction["RECALCULATE"] = "RECALCULATE";
+    AuditAction["SUSPEND"] = "SUSPEND";
+    AuditAction["REACTIVATE"] = "REACTIVATE";
+})(AuditAction || (exports.AuditAction = AuditAction = {}));

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

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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.140.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/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 = ">",
+}

package/src/remittance/enums/CohortRefresh.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 enum CohortRefresh {
+    HORARIO = "horario",
+    DIARIO = "diario",
+    SEMANAL = "semanal",
+}

package/src/remittance/enums/index.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/src/remittance/index.ts

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