@fiado/type-kit 3.613.0 → 3.614.0

package/bin/loanOfferings/index.d.ts

@@ -16,6 +16,16 @@ export * from './enums/SegmentStatusEnum';
 export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
 export * from './enums/PrepaymentMinimumModeEnum';
+export * from './enums/CohortStatusEnum';
+export * from './enums/CohortFactKeyEnum';
+export * from './enums/CohortFactTypeEnum';
+export * from './enums/CohortOperatorEnum';
+export * from './enums/CohortConditionOutcomeEnum';
+export * from './enums/CohortLogEventEnum';
+export * from './enums/SegmentLogEventEnum';
+export * from './enums/SegmentMembershipReasonEnum';
+export * from './enums/SegmentationRecountTriggerEnum';
+export * from './enums/SegmentationRecountStatusEnum';
 export * from './constants/promotionSkuBatch';
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
@@ -43,7 +53,16 @@ export * from './dtos/requests/ChangeStorePolicyStatusRequest';
 export * from './dtos/requests/CreateSegmentRequest';
 export * from './dtos/requests/UpdateSegmentRequest';
 export * from './dtos/requests/ChangeSegmentStatusRequest';
+export * from './dtos/requests/CustomerSegmentFacts';
 export * from './dtos/requests/ResolveCustomerSegmentsRequest';
+export * from './dtos/requests/ResolveSegmentMembersRequest';
+export * from './dtos/requests/TestCustomerSegmentsRequest';
+export * from './dtos/requests/CohortCondition';
+export * from './dtos/requests/CreateCohortRequest';
+export * from './dtos/requests/UpdateCohortRequest';
+export * from './dtos/requests/ChangeCohortStatusRequest';
+export * from './dtos/requests/TestCohortRequest';
+export * from './dtos/requests/ListCohortsQuery';
 export * from './dtos/requests/ComputeAmortizationScheduleRequest';
 export * from './dtos/requests/ListSegmentCatalogQuery';
 export * from './dtos/requests/PromotionSkuInput';
@@ -66,5 +85,15 @@ export * from './dtos/responses/SegmentResponse';
 export * from './dtos/responses/SegmentFilterResponse';
 export * from './dtos/responses/SegmentCatalogResponse';
 export * from './dtos/responses/ResolveCustomerSegmentsResponse';
+export * from './dtos/responses/SegmentMembersResponse';
+export * from './dtos/responses/SegmentUsageResponse';
+export * from './dtos/responses/TestCustomerSegmentsResponse';
+export * from './dtos/responses/SegmentLogEntryResponse';
+export * from './dtos/responses/SegmentationRecountStartResponse';
+export * from './dtos/responses/SegmentationRecountRunResponse';
+export * from './dtos/responses/CohortResponse';
+export * from './dtos/responses/CohortCatalogResponse';
+export * from './dtos/responses/TestCohortResponse';
+export * from './dtos/responses/CohortLogEntryResponse';
 export * from './dtos/responses/AmortizationScheduleRow';
 export * from './dtos/responses/AmortizationScheduleResponse';

package/bin/loanOfferings/index.js

@@ -33,6 +33,16 @@ __exportStar(require("./enums/SegmentStatusEnum"), exports);
 __exportStar(require("./enums/SegmentColorSlotEnum"), exports);
 __exportStar(require("./enums/SegmentFilterIdEnum"), exports);
 __exportStar(require("./enums/PrepaymentMinimumModeEnum"), exports);
+__exportStar(require("./enums/CohortStatusEnum"), exports);
+__exportStar(require("./enums/CohortFactKeyEnum"), exports);
+__exportStar(require("./enums/CohortFactTypeEnum"), exports);
+__exportStar(require("./enums/CohortOperatorEnum"), exports);
+__exportStar(require("./enums/CohortConditionOutcomeEnum"), exports);
+__exportStar(require("./enums/CohortLogEventEnum"), exports);
+__exportStar(require("./enums/SegmentLogEventEnum"), exports);
+__exportStar(require("./enums/SegmentMembershipReasonEnum"), exports);
+__exportStar(require("./enums/SegmentationRecountTriggerEnum"), exports);
+__exportStar(require("./enums/SegmentationRecountStatusEnum"), exports);
 // Constantes
 __exportStar(require("./constants/promotionSkuBatch"), exports);
 // Entity DTOs
@@ -63,7 +73,16 @@ __exportStar(require("./dtos/requests/ChangeStorePolicyStatusRequest"), exports)
 __exportStar(require("./dtos/requests/CreateSegmentRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateSegmentRequest"), exports);
 __exportStar(require("./dtos/requests/ChangeSegmentStatusRequest"), exports);
+__exportStar(require("./dtos/requests/CustomerSegmentFacts"), exports);
 __exportStar(require("./dtos/requests/ResolveCustomerSegmentsRequest"), exports);
+__exportStar(require("./dtos/requests/ResolveSegmentMembersRequest"), exports);
+__exportStar(require("./dtos/requests/TestCustomerSegmentsRequest"), exports);
+__exportStar(require("./dtos/requests/CohortCondition"), exports);
+__exportStar(require("./dtos/requests/CreateCohortRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateCohortRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeCohortStatusRequest"), exports);
+__exportStar(require("./dtos/requests/TestCohortRequest"), exports);
+__exportStar(require("./dtos/requests/ListCohortsQuery"), exports);
 __exportStar(require("./dtos/requests/ComputeAmortizationScheduleRequest"), exports);
 __exportStar(require("./dtos/requests/ListSegmentCatalogQuery"), exports);
 __exportStar(require("./dtos/requests/PromotionSkuInput"), exports);
@@ -87,5 +106,15 @@ __exportStar(require("./dtos/responses/SegmentResponse"), exports);
 __exportStar(require("./dtos/responses/SegmentFilterResponse"), exports);
 __exportStar(require("./dtos/responses/SegmentCatalogResponse"), exports);
 __exportStar(require("./dtos/responses/ResolveCustomerSegmentsResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentMembersResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentUsageResponse"), exports);
+__exportStar(require("./dtos/responses/TestCustomerSegmentsResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentLogEntryResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentationRecountStartResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentationRecountRunResponse"), exports);
+__exportStar(require("./dtos/responses/CohortResponse"), exports);
+__exportStar(require("./dtos/responses/CohortCatalogResponse"), exports);
+__exportStar(require("./dtos/responses/TestCohortResponse"), exports);
+__exportStar(require("./dtos/responses/CohortLogEntryResponse"), exports);
 __exportStar(require("./dtos/responses/AmortizationScheduleRow"), exports);
 __exportStar(require("./dtos/responses/AmortizationScheduleResponse"), exports);

package/package.json

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

package/src/loanCredit/dtos/requests/SegmentFactsBatchRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsString } from 'class-validator';
+
+/** Body de `POST /private/borrowers/segment-facts`: datos para segmentar de hasta 100 clientes retail. */
+export class SegmentFactsBatchRequest {
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(100)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    retailCustomerIds!: string[];
+}

package/src/loanCredit/dtos/requests/SegmentFactsPageRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/** Body de `POST /private/borrowers/segment-facts/page`: una página de la cartera de acreditados. */
+export class SegmentFactsPageRequest {
+    /** Cursor opaco de la página anterior. Ausente en la primera página. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    cursor?: string;
+
+    /** Acreditados por página. Ausente = 100. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+}

package/src/loanCredit/dtos/responses/BorrowerSegmentFacts.ts

@@ -0,0 +1,24 @@
+import { CreditPlanLevelEnum } from '../../../loanOfferings/enums/CreditPlanLevelEnum';
+
+/**
+ * Datos del acreditado para evaluar cohorts, ya normalizados: sin acreditado, conteos y días en
+ * `0`; `sciLevel` ausente si no hay evaluación o el nivel es `ALL` / `NOT_ELIGIBLE`.
+ */
+export interface BorrowerSegmentFacts {
+    sciLevel?: CreditPlanLevelEnum;
+    totalCredits: number;
+    activeCredits: number;
+    completedCredits: number;
+    lifetimeWriteOffs: number;
+    currentArrearsDays: number;
+    /** Sin cuotas en la ventana de 180 días cuenta como `0`. */
+    delinquencyDaysLast6M: number;
+    lifetimeRestructures: number;
+}
+
+/** Un cliente retail y sus datos para segmentar. `borrowerId` en `null` = no tiene acreditado. */
+export interface BorrowerSegmentFactsItem {
+    retailCustomerId: string;
+    borrowerId: string | null;
+    facts: BorrowerSegmentFacts;
+}

package/src/loanCredit/dtos/responses/SegmentFactsBatchResponse.ts

@@ -0,0 +1,6 @@
+import { BorrowerSegmentFactsItem } from './BorrowerSegmentFacts';
+
+/** Respuesta de `POST /private/borrowers/segment-facts`: un ítem por id pedido, en el mismo orden. */
+export interface SegmentFactsBatchResponse {
+    items: BorrowerSegmentFactsItem[];
+}

package/src/loanCredit/dtos/responses/SegmentFactsPageResponse.ts

@@ -0,0 +1,8 @@
+import { BorrowerSegmentFactsItem } from './BorrowerSegmentFacts';
+
+/** Respuesta de `POST /private/borrowers/segment-facts/page`. */
+export interface SegmentFactsPageResponse {
+    items: BorrowerSegmentFactsItem[];
+    /** Cursor de la siguiente página. `null` = ya no quedan acreditados. */
+    nextCursor: string | null;
+}

package/src/loanCredit/index.ts

@@ -198,3 +198,10 @@ export * from './dtos/requests/UpdateReconcileModeRequest';
 export * from './dtos/responses/ReconcileModeView';
 export * from './dtos/requests/RunDevicePostureBackfillRequest';
 export * from './dtos/responses/DevicePostureBackfillResult';
+
+// Datos del cliente para evaluar cohorts de segmentos
+export * from './dtos/requests/SegmentFactsBatchRequest';
+export * from './dtos/requests/SegmentFactsPageRequest';
+export * from './dtos/responses/BorrowerSegmentFacts';
+export * from './dtos/responses/SegmentFactsBatchResponse';
+export * from './dtos/responses/SegmentFactsPageResponse';

package/src/loanOfferings/dtos/requests/ChangeCohortStatusRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CohortStatusEnum } from '../../enums/CohortStatusEnum';
+
+/**
+ * Body de PUT /cohorts/:cohortId/status — archiva o reactiva un cohort. No se archiva uno que use
+ * un segmento activo. `reason` queda en la bitácora.
+ */
+export class ChangeCohortStatusRequest {
+    @Expose()
+    @IsEnum(CohortStatusEnum)
+    status!: CohortStatusEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

package/src/loanOfferings/dtos/requests/CohortCondition.ts

@@ -0,0 +1,33 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { CohortFactKeyEnum } from '../../enums/CohortFactKeyEnum';
+import { CohortOperatorEnum } from '../../enums/CohortOperatorEnum';
+
+/**
+ * Una condición de cohort: «dato operador valor». Las condiciones de un cohort se unen con Y.
+ * Que el operador aplique al tipo del dato y que el valor tenga el tipo correcto lo valida el
+ * lambda (422), contra el catálogo.
+ */
+export class CohortCondition {
+    @Expose()
+    @IsEnum(CohortFactKeyEnum)
+    field!: CohortFactKeyEnum;
+
+    @Expose()
+    @IsEnum(CohortOperatorEnum)
+    op!: CohortOperatorEnum;
+
+    /** Valor a comparar en los operadores de un solo valor. Tipado estricto: `3` no es `"3"`. */
+    @Expose()
+    @IsOptional()
+    value?: number | boolean | string;
+
+    /** Lista de opciones; solo con `IN` y `NOT_IN`. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    @ArrayMaxSize(10)
+    values?: string[];
+}

package/src/loanOfferings/dtos/requests/CreateCohortRequest.ts

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsOptional, IsString, MaxLength, ValidateNested } from 'class-validator';
+import { CohortCondition } from './CohortCondition';
+
+/**
+ * Body de POST /cohorts — alta de un cohort. Nace en `ACTIVE`; `cohortId`, `status`, `version` y
+ * la auditoría los asigna el lambda. El nombre es único entre los cohorts activos.
+ */
+export class CreateCohortRequest {
+    @Expose()
+    @IsString()
+    @MaxLength(120)
+    name!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    /** Condiciones unidas con Y: el cliente entra si cumple todas. */
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions!: CohortCondition[];
+}

package/src/loanOfferings/dtos/requests/CreateSegmentRequest.ts

@@ -1,12 +1,12 @@
 import { Expose } from 'class-transformer';
-import { IsArray, IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
 import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
 
 /**
  * Body de POST /segments — alta de un segmento de clientes.
  * Nace en `ACTIVE`: `segmentId`, `status`, `version`, `isDefault` y la auditoría los asigna el
- * lambda y NO viajan en el request. Que cada filtro exista en el catálogo y tenga fuente lo valida
- * el lambda contra `GET /segments/filters`.
+ * lambda y NO viajan en el request. Que cada cohort exista y esté activo lo valida el lambda, igual
+ * que la regla de tener al menos un cohort o un individuo.
  */
 export class CreateSegmentRequest {
     @Expose()
@@ -27,19 +27,20 @@ export class CreateSegmentRequest {
     colorSlot?: SegmentColorSlotEnum;
 
     /**
-     * Filtros del catálogo cerrado. Un cliente pertenece si cumple AL MENOS UNO — es un OR, no un
-     * AND. Se valida contra el catálogo en el lambda (422), no acá, para poder nombrar el filtro
-     * desconocido y el que todavía no tiene fuente.
+     * Cohorts del segmento. Un cliente pertenece si cumple AL MENOS UNO — es un OR entre cohorts;
+     * dentro de cada cohort las condiciones se unen con Y.
      */
     @Expose()
     @IsOptional()
     @IsArray()
     @IsString({ each: true })
-    filterIds?: string[];
+    @IsNotEmpty({ each: true })
+    @ArrayMaxSize(20)
+    cohortIds?: string[];
 
     /**
-     * Clientes agregados a mano por `retailCustomerId`. Ganan siempre, cumplan o no un filtro.
-     * Un segmento puede nacer SOLO con esta lista, sin ningún filtro activo.
+     * Clientes agregados a mano por `retailCustomerId`. Ganan siempre, cumplan o no un cohort.
+     * Un segmento puede nacer SOLO con esta lista, sin ningún cohort.
      */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/requests/CustomerSegmentFacts.ts

@@ -0,0 +1,79 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, Min } from 'class-validator';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+
+/**
+ * Datos del cliente contra los que se evalúan los cohorts. Las llaves son las de
+ * `CohortFactKeyEnum`. Todos opcionales: un dato ausente hace que su condición no se cumpla.
+ *
+ * Cliente sin acreditado: conteos y días en `0`, `sciLevel` ausente. `sciLevel` en `ALL` o
+ * `NOT_ELIGIBLE` se manda ausente.
+ */
+export class CustomerSegmentFacts {
+    /** Nivel de la última evaluación SCI del acreditado. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CreditPlanLevelEnum)
+    sciLevel?: CreditPlanLevelEnum;
+
+    /** Créditos en toda la vida del cliente, en cualquier estado. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    totalCredits?: number;
+
+    /** Créditos vivos hoy. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    activeCredits?: number;
+
+    /** Créditos liquidados en toda la vida del cliente. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    completedCredits?: number;
+
+    /** Créditos con baja contable en toda la vida del cliente. `0` es ninguno. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    lifetimeWriteOffs?: number;
+
+    /** Días de atraso hoy. `0` es al corriente. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    currentArrearsDays?: number;
+
+    /** Días de mora en la ventana de 180 días. Sin cuotas en la ventana cuenta como `0`. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    delinquencyDaysLast6M?: number;
+
+    /** Reestructuras en toda la vida del cliente. `0` es ninguna. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    lifetimeRestructures?: number;
+
+    /** Colaborador de la red. Hoy ningún sistema lo produce: se usa la lista manual del segmento. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    isEmployee?: boolean;
+
+    /** Tiene cuenta PCF. Sin fuente mientras no se defina qué cuenta como cuenta PCF. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    hasPcfAccount?: boolean;
+}

package/src/loanOfferings/dtos/requests/ListCohortsQuery.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional } from 'class-validator';
+import { CohortStatusEnum } from '../../enums/CohortStatusEnum';
+
+/** Query de GET /cohorts (backoffice). El tenant sale del token. Sin `status` devuelve todos. */
+export class ListCohortsQuery {
+    @Expose()
+    @IsOptional()
+    @IsEnum(CohortStatusEnum)
+    status?: CohortStatusEnum;
+}

package/src/loanOfferings/dtos/requests/ResolveCustomerSegmentsRequest.ts

@@ -1,57 +1,13 @@
 import { Expose } from 'class-transformer';
-import { IsBoolean, IsEnum, IsInt, IsOptional, IsString, Min } from 'class-validator';
-import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { IsString } from 'class-validator';
+import { CustomerSegmentFacts } from './CustomerSegmentFacts';
 
 /**
- * Body de POST /private/segments/resolve — los hechos del cliente contra los que se evalúan los
- * filtros. Los junta quien ya tiene al cliente delante (el wizard o el motor de crédito); este
- * lambda no sale a buscarlos a otro silo en el camino caliente.
- *
- * Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar que el cliente
- * califica, y de las dos salidas la segura es dejarlo fuera.
+ * Body de POST /private/segments/resolve — el cliente y, opcionalmente, sus datos para evaluar los
+ * cohorts. Si el llamador no manda los datos, loan-offerings los pide a loan-credit.
  */
-export class ResolveCustomerSegmentsRequest {
+export class ResolveCustomerSegmentsRequest extends CustomerSegmentFacts {
     @Expose()
     @IsString()
     retailCustomerId!: string;
-
-    /** Colaborador de la red. Hoy ningún sistema lo produce — ver la lista de individuos. */
-    @Expose()
-    @IsOptional()
-    @IsBoolean()
-    isEmployee?: boolean;
-
-    /** Nivel que resolvió loan-scoring a partir del SCI. */
-    @Expose()
-    @IsOptional()
-    @IsEnum(CreditPlanLevelEnum)
-    sciLevel?: CreditPlanLevelEnum;
-
-    /** Créditos cerrados en toda la vida del cliente. */
-    @Expose()
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    completedCredits?: number;
-
-    /** Días de mora acumulados en la ventana de 180 días. `0` es sin mora. */
-    @Expose()
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    delinquencyDaysLast6M?: number;
-
-    /** Bajas contables vitalicias. `0` es ninguna. */
-    @Expose()
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    lifetimeWriteOffs?: number;
-
-    /** Reestructuras vitalicias. `0` es ninguna. */
-    @Expose()
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    lifetimeRestructures?: number;
 }

package/src/loanOfferings/dtos/requests/ResolveSegmentMembersRequest.ts

@@ -0,0 +1,17 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, ValidateNested } from 'class-validator';
+import { ResolveCustomerSegmentsRequest } from './ResolveCustomerSegmentsRequest';
+
+/**
+ * Body de POST /private/segments/members — pertenencia a segmentos en lote, con cohorts. Cada
+ * cliente viaja con sus datos si el llamador los tiene; los que falten los pide loan-offerings.
+ */
+export class ResolveSegmentMembersRequest {
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(100)
+    @ValidateNested({ each: true })
+    @Type(() => ResolveCustomerSegmentsRequest)
+    customers!: ResolveCustomerSegmentsRequest[];
+}

package/src/loanOfferings/dtos/requests/TestCohortRequest.ts

@@ -0,0 +1,21 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsString, ValidateNested } from 'class-validator';
+import { CohortCondition } from './CohortCondition';
+
+/**
+ * Body de POST /cohorts/test — prueba unas condiciones, guardadas o no, con un cliente. Devuelve
+ * los datos del cliente y el resultado de cada condición.
+ */
+export class TestCohortRequest {
+    @Expose()
+    @IsString()
+    retailCustomerId!: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions!: CohortCondition[];
+}

package/src/loanOfferings/dtos/requests/TestCustomerSegmentsRequest.ts

@@ -0,0 +1,9 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/** Body de POST /segments/test — en qué segmentos cae un cliente y por qué. */
+export class TestCustomerSegmentsRequest {
+    @Expose()
+    @IsString()
+    retailCustomerId!: string;
+}

package/src/loanOfferings/dtos/requests/UpdateCohortRequest.ts

@@ -0,0 +1,37 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsOptional, IsString, MaxLength, ValidateNested } from 'class-validator';
+import { CohortCondition } from './CohortCondition';
+
+/**
+ * Body de PUT /cohorts/:cohortId — edición parcial; ausente deja el campo como está. Sube
+ * `version`. El cambio de estado va por su endpoint dedicado.
+ */
+export class UpdateCohortRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(120)
+    name?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    /** Reemplaza todas las condiciones. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions?: CohortCondition[];
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

package/src/loanOfferings/dtos/requests/UpdateSegmentRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsArray, IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
 import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
 
 /**
@@ -27,12 +27,14 @@ export class UpdateSegmentRequest {
     @IsEnum(SegmentColorSlotEnum)
     colorSlot?: SegmentColorSlotEnum;
 
-    /** Reemplaza la lista entera; `[]` deja el segmento sin filtros. */
+    /** Reemplaza la lista entera; `[]` deja el segmento sin cohorts. */
     @Expose()
     @IsOptional()
     @IsArray()
     @IsString({ each: true })
-    filterIds?: string[];
+    @IsNotEmpty({ each: true })
+    @ArrayMaxSize(20)
+    cohortIds?: string[];
 
     /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. */
     @Expose()

package/src/loanOfferings/dtos/responses/CohortCatalogResponse.ts

@@ -0,0 +1,36 @@
+import { CohortFactKeyEnum } from '../../enums/CohortFactKeyEnum';
+import { CohortFactTypeEnum } from '../../enums/CohortFactTypeEnum';
+import { CohortOperatorEnum } from '../../enums/CohortOperatorEnum';
+
+/** Una opción de un dato de tipo `SELECT`. */
+export interface CohortFactOption {
+    value: string;
+    label: string;
+}
+
+/**
+ * Un dato del cliente tal como lo pinta el armador de cohorts. El front lo toma de acá en vez de
+ * duplicar la lista.
+ */
+export interface CohortFactFieldResponse {
+    key: CohortFactKeyEnum;
+    type: CohortFactTypeEnum;
+    label: string;
+    unit: string | null;
+    /** Solo en `SELECT`. */
+    options: CohortFactOption[] | null;
+    /** Operadores que admite su tipo. */
+    operators: CohortOperatorEnum[];
+    /**
+     * `false` cuando ningún sistema produce el dato: el armador lo muestra deshabilitado y el lambda
+     * rechaza guardar un cohort que lo use (422).
+     */
+    hasSource: boolean;
+    /** Por qué no tiene fuente. `null` cuando `hasSource` es `true`. */
+    missingSourceReason: string | null;
+}
+
+/** Respuesta de GET /cohorts/catalog. */
+export interface CohortCatalogResponse {
+    fields: CohortFactFieldResponse[];
+}

package/src/loanOfferings/dtos/responses/CohortLogEntryResponse.ts

@@ -0,0 +1,12 @@
+import { CohortLogEventEnum } from '../../enums/CohortLogEventEnum';
+
+/** Un evento de la bitácora de un cohort. */
+export interface CohortLogEntryResponse {
+    cohortId: string;
+    cohortName: string;
+    event: CohortLogEventEnum;
+    occurredAt: string;
+    performedBy: string;
+    reason: string | null;
+    version: number;
+}