@fiado/type-kit 3.613.0 → 3.615.0

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/ListPromotedSkusRequest.ts

@@ -11,6 +11,13 @@ export class ListPromotedSkusRequest {
     @IsNotEmpty()
     storeId!: string;
 
+    /** Cadena de la tienda; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+
     /** Nivel del cliente si loan-scoring ya corrió. */
     @Expose()
     @IsOptional()

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

@@ -11,6 +11,13 @@ export class ListSkuPromotionsRequest {
     @IsNotEmpty()
     storeId!: string;
 
+    /** Cadena de la tienda; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+
     /** Nivel del cliente si loan-scoring ya corrió. */
     @Expose()
     @IsOptional()

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/SimulateCreditPlanRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsArray, IsEnum, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { IsArray, IsEnum, IsInt, IsNotEmpty, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 
@@ -61,6 +61,13 @@ export class SimulateCreditPlanRequest {
     @IsEnum(ProductTierEnum)
     productTier?: ProductTierEnum;
 
+    /** Cadena de la tienda que cotiza; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+
     /**
      * Segmentos del cliente, los que devolvió `POST /private/segments/resolve`. Un arreglo vacío
      * declara que el cliente no está en ninguno; ausente declara que el caller no lo consultó.

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/UpdatePromotionRequest.ts

@@ -1,14 +1,17 @@
 import { Expose, Type } from 'class-transformer';
 import {
+    ArrayMaxSize,
     ArrayNotEmpty,
     IsArray,
     IsEnum,
     IsInt,
     IsISO8601,
+    IsNotEmpty,
     IsOptional,
     IsString,
     ValidateNested,
 } from 'class-validator';
+import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -68,6 +71,15 @@ export class UpdatePromotionRequest {
     @IsEnum(ProductTierEnum, { each: true })
     tiers?: ProductTierEnum[] | null;
 
+    /** Cadenas alcanzadas; ausente, `null` o vacío = todas las cadenas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_RETAILER_IDS_MAX_ITEMS)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    retailerIds?: string[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

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;
+}

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

@@ -0,0 +1,47 @@
+import { CohortFactKeyEnum } from '../../enums/CohortFactKeyEnum';
+import { CohortOperatorEnum } from '../../enums/CohortOperatorEnum';
+import { CohortStatusEnum } from '../../enums/CohortStatusEnum';
+
+/** Una condición guardada. `value` y `values` van en `null` cuando el operador no los usa. */
+export interface CohortConditionResponse {
+    field: CohortFactKeyEnum;
+    op: CohortOperatorEnum;
+    value: number | boolean | string | null;
+    values: string[] | null;
+}
+
+/** Un segmento que usa el cohort, con lo mínimo para enlazarlo. */
+export interface CohortSegmentRef {
+    segmentId: string;
+    name: string;
+}
+
+/**
+ * Shape de salida de un cohort (GET / POST / PUT de /cohorts). Sus condiciones se unen con Y.
+ * Los conteos salen del último recálculo; `null` = sin calcular.
+ */
+export interface CohortResponse {
+    cohortId: string;
+    name: string;
+    description: string | null;
+    conditions: CohortConditionResponse[];
+    status: CohortStatusEnum;
+    version: number;
+    memberCount: number | null;
+    /** Porcentaje de los acreditados del tenant, de 0 a 100 con un decimal. `null` = sin calcular. */
+    pctTotal: number | null;
+    countedAt: string | null;
+    /** `true` si nunca se contó o se editó después del último recálculo. */
+    countPending: boolean;
+    /** Segmentos ACTIVE que lo referencian. */
+    usedBySegments: CohortSegmentRef[];
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+
+/** Respuesta de GET /cohorts. */
+export interface CohortListResponse {
+    cohorts: CohortResponse[];
+}

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

@@ -28,6 +28,8 @@ export interface PromotionResponse {
     productCategories: ProductCategoryEnum[] | null;
     /** `null` = alcanza a todas las gamas. */
     tiers: ProductTierEnum[] | null;
+    /** `null` = alcanza a todas las cadenas. */
+    retailerIds: string[] | null;
     /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
     storeIds: string[] | null;
     validFrom: string | null;

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

@@ -1,4 +1,3 @@
-import { SegmentFilterIdEnum } from '../../enums/SegmentFilterIdEnum';
 import { SegmentStatusEnum } from '../../enums/SegmentStatusEnum';
 
 /** Un segmento como lo necesita un selector: sin miembros ni metadatos de edición. */
@@ -6,7 +5,11 @@ export interface SegmentCatalogItem {
     segmentId: string;
     name: string;
     status: SegmentStatusEnum;
-    filterIds: SegmentFilterIdEnum[];
+    cohortIds: string[];
+    /** `true` si el segmento tiene cohorts: su pertenencia depende de los datos del cliente. */
+    dependsOnFacts: boolean;
+    /** @deprecated Mismo contenido que `cohortIds`; usar `cohortIds` o `dependsOnFacts`. */
+    filterIds: string[];
     /** `true` solo en el catch-all, que el resolve nunca devuelve. */
     isDefault: boolean;
 }

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

@@ -0,0 +1,12 @@
+import { SegmentLogEventEnum } from '../../enums/SegmentLogEventEnum';
+
+/** Un evento de la bitácora de un segmento. */
+export interface SegmentLogEntryResponse {
+    segmentId: string;
+    segmentName: string;
+    event: SegmentLogEventEnum;
+    occurredAt: string;
+    performedBy: string;
+    reason: string | null;
+    version: number;
+}

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

@@ -0,0 +1,21 @@
+/** Un segmento como lo pinta una celda de la tabla de clientes. */
+export interface CustomerSegmentRef {
+    segmentId: string;
+    name: string;
+    /** `true` solo en el catch-all: el cliente no pertenece a ningún otro segmento. */
+    isDefault: boolean;
+}
+
+/** Un cliente pedido y sus segmentos. */
+export interface CustomerSegmentsItem {
+    retailCustomerId: string;
+    segments: CustomerSegmentRef[];
+}
+
+/**
+ * Respuesta de la pertenencia a segmentos en lote: una fila por id pedido, en el orden en que
+ * llegaron, así el llamador distingue «ninguno» de «no vino».
+ */
+export interface SegmentMembersResponse {
+    items: CustomerSegmentsItem[];
+}

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

@@ -1,11 +1,10 @@
 import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
-import { SegmentFilterIdEnum } from '../../enums/SegmentFilterIdEnum';
 import { SegmentStatusEnum } from '../../enums/SegmentStatusEnum';
 
 /**
  * Shape de salida de un segmento (GET / POST / PUT de /segments).
  *
- * Un cliente pertenece si cumple AL MENOS UNO de los `filterIds` (OR) **o** está en `memberIds`.
+ * Un cliente pertenece si cumple AL MENOS UNO de los `cohortIds` (OR) **o** está en `memberIds`.
  * No hay prioridad ni desempate: el cliente puede estar en varios segmentos a la vez.
  */
 export interface SegmentResponse {
@@ -13,14 +12,21 @@ export interface SegmentResponse {
     name: string;
     description: string | null;
     colorSlot: SegmentColorSlotEnum;
-    /** Ids del catálogo cerrado. Vacío = no alcanza a nadie por regla. */
-    filterIds: SegmentFilterIdEnum[];
-    /** `retailCustomerId` agregados a mano. Ganan aunque el cliente no cumpla ningún filtro. */
+    /** Cohorts del segmento. Vacío = no alcanza a nadie por regla. */
+    cohortIds: string[];
+    /** `retailCustomerId` agregados a mano. Ganan aunque el cliente no cumpla ningún cohort. */
     memberIds: string[];
-    /** El catch-all implícito. No acepta filtros ni individuos, no se archiva y solo se renombra. */
+    /** El catch-all implícito. No acepta cohorts ni individuos, no se archiva y solo se renombra. */
     isDefault: boolean;
     status: SegmentStatusEnum;
     version: number;
+    /** Clientes del último recálculo. En el catch-all, los que no cayeron en ningún segmento. `null` = sin calcular. */
+    clientCount: number | null;
+    /** Porcentaje de los acreditados del tenant, de 0 a 100 con un decimal. `null` = sin calcular. */
+    pctTotal: number | null;
+    countedAt: string | null;
+    /** `true` si nunca se contó o se editó después del último recálculo. */
+    countPending: boolean;
     createdAt: string;
     updatedAt: string;
     createdBy: string;

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

@@ -0,0 +1,20 @@
+/** Una política de tienda que apunta al segmento. */
+export interface SegmentUsagePolicyRef {
+    policyId: string;
+    name: string;
+    status: string;
+}
+
+/** Una promoción que apunta al segmento. */
+export interface SegmentUsagePromotionRef {
+    promotionId: string;
+    name: string;
+    status: string;
+}
+
+/** Respuesta de GET /segments/:segmentId/usage: dónde se aplica el segmento, con su estado. */
+export interface SegmentUsageResponse {
+    segmentId: string;
+    policies: SegmentUsagePolicyRef[];
+    promotions: SegmentUsagePromotionRef[];
+}

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

@@ -0,0 +1,25 @@
+import { SegmentationRecountStatusEnum } from '../../enums/SegmentationRecountStatusEnum';
+import { SegmentationRecountTriggerEnum } from '../../enums/SegmentationRecountTriggerEnum';
+
+/**
+ * Una corrida del recálculo de conteos de cohorts y segmentos. Los campos de cierre van en `null`
+ * mientras corre.
+ */
+export interface SegmentationRecountRunResponse {
+    runId: string;
+    trigger: SegmentationRecountTriggerEnum;
+    status: SegmentationRecountStatusEnum;
+    /** Quién la disparó. */
+    actor: string;
+    startedAt: string;
+    finishedAt: string | null;
+    /** Acreditados evaluados. */
+    evaluated: number | null;
+    durationMs: number | null;
+    error: string | null;
+}
+
+/** Respuesta de GET /segmentation/recount/runs: la más reciente primero, máximo 50. */
+export interface SegmentationRecountRunsResponse {
+    runs: SegmentationRecountRunResponse[];
+}

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

@@ -0,0 +1,7 @@
+import { SegmentationRecountStatusEnum } from '../../enums/SegmentationRecountStatusEnum';
+
+/** Respuesta de POST /segmentation/recount: la corrida arranca en segundo plano. */
+export interface SegmentationRecountStartResponse {
+    runId: string;
+    status: SegmentationRecountStatusEnum;
+}