@fiado/type-kit 3.613.0 → 3.615.0

package/bin/loanOfferings/enums/CohortFactKeyEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortFactKeyEnum = void 0;
+/**
+ * Datos del cliente sobre los que se arma una condición de cohort. Catálogo cerrado: un dato
+ * nuevo es un cambio de código en quien lo calcula y en quien lo evalúa.
+ * @enum {string}
+ */
+var CohortFactKeyEnum;
+(function (CohortFactKeyEnum) {
+    CohortFactKeyEnum["SCI_LEVEL"] = "sciLevel";
+    CohortFactKeyEnum["TOTAL_CREDITS"] = "totalCredits";
+    CohortFactKeyEnum["ACTIVE_CREDITS"] = "activeCredits";
+    CohortFactKeyEnum["COMPLETED_CREDITS"] = "completedCredits";
+    CohortFactKeyEnum["LIFETIME_WRITE_OFFS"] = "lifetimeWriteOffs";
+    CohortFactKeyEnum["CURRENT_ARREARS_DAYS"] = "currentArrearsDays";
+    CohortFactKeyEnum["DELINQUENCY_DAYS_LAST_6M"] = "delinquencyDaysLast6M";
+    CohortFactKeyEnum["LIFETIME_RESTRUCTURES"] = "lifetimeRestructures";
+    CohortFactKeyEnum["IS_EMPLOYEE"] = "isEmployee";
+    CohortFactKeyEnum["HAS_PCF_ACCOUNT"] = "hasPcfAccount";
+})(CohortFactKeyEnum || (exports.CohortFactKeyEnum = CohortFactKeyEnum = {}));

package/bin/loanOfferings/enums/CohortFactTypeEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tipo de un dato del catálogo de cohorts. Define qué operadores admite y cómo se pinta el valor.
+ * @enum {string}
+ */
+export declare enum CohortFactTypeEnum {
+    NUMBER = "NUMBER",
+    SELECT = "SELECT",
+    BOOLEAN = "BOOLEAN"
+}

package/bin/loanOfferings/enums/CohortFactTypeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortFactTypeEnum = void 0;
+/**
+ * Tipo de un dato del catálogo de cohorts. Define qué operadores admite y cómo se pinta el valor.
+ * @enum {string}
+ */
+var CohortFactTypeEnum;
+(function (CohortFactTypeEnum) {
+    CohortFactTypeEnum["NUMBER"] = "NUMBER";
+    CohortFactTypeEnum["SELECT"] = "SELECT";
+    CohortFactTypeEnum["BOOLEAN"] = "BOOLEAN";
+})(CohortFactTypeEnum || (exports.CohortFactTypeEnum = CohortFactTypeEnum = {}));

package/bin/loanOfferings/enums/CohortLogEventEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Evento de la bitácora de un cohort.
+ * @enum {string}
+ */
+export declare enum CohortLogEventEnum {
+    CREATED = "CREATED",
+    UPDATED = "UPDATED",
+    ARCHIVED = "ARCHIVED",
+    REACTIVATED = "REACTIVATED"
+}

package/bin/loanOfferings/enums/CohortLogEventEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortLogEventEnum = void 0;
+/**
+ * Evento de la bitácora de un cohort.
+ * @enum {string}
+ */
+var CohortLogEventEnum;
+(function (CohortLogEventEnum) {
+    CohortLogEventEnum["CREATED"] = "CREATED";
+    CohortLogEventEnum["UPDATED"] = "UPDATED";
+    CohortLogEventEnum["ARCHIVED"] = "ARCHIVED";
+    CohortLogEventEnum["REACTIVATED"] = "REACTIVATED";
+})(CohortLogEventEnum || (exports.CohortLogEventEnum = CohortLogEventEnum = {}));

package/bin/loanOfferings/enums/CohortOperatorEnum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Operador de una condición de cohort. `IN` y `NOT_IN` comparan contra una lista (`values`); el
+ * resto, contra un solo valor (`value`).
+ * @enum {string}
+ */
+export declare enum CohortOperatorEnum {
+    EQUALS = "EQUALS",
+    NOT_EQUALS = "NOT_EQUALS",
+    GT = "GT",
+    GTE = "GTE",
+    LT = "LT",
+    LTE = "LTE",
+    IN = "IN",
+    NOT_IN = "NOT_IN"
+}

package/bin/loanOfferings/enums/CohortOperatorEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortOperatorEnum = void 0;
+/**
+ * Operador de una condición de cohort. `IN` y `NOT_IN` comparan contra una lista (`values`); el
+ * resto, contra un solo valor (`value`).
+ * @enum {string}
+ */
+var CohortOperatorEnum;
+(function (CohortOperatorEnum) {
+    CohortOperatorEnum["EQUALS"] = "EQUALS";
+    CohortOperatorEnum["NOT_EQUALS"] = "NOT_EQUALS";
+    CohortOperatorEnum["GT"] = "GT";
+    CohortOperatorEnum["GTE"] = "GTE";
+    CohortOperatorEnum["LT"] = "LT";
+    CohortOperatorEnum["LTE"] = "LTE";
+    CohortOperatorEnum["IN"] = "IN";
+    CohortOperatorEnum["NOT_IN"] = "NOT_IN";
+})(CohortOperatorEnum || (exports.CohortOperatorEnum = CohortOperatorEnum = {}));

package/bin/loanOfferings/enums/CohortStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado persistido de un cohort. No hay borrado: `ARCHIVED` lo saca de la evaluación y de los
+ * selectores, y los segmentos que lo usaban siguen resolviendo su nombre.
+ * @enum {string}
+ */
+export declare enum CohortStatusEnum {
+    ACTIVE = "ACTIVE",
+    ARCHIVED = "ARCHIVED"
+}

package/bin/loanOfferings/enums/CohortStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortStatusEnum = void 0;
+/**
+ * Estado persistido de un cohort. No hay borrado: `ARCHIVED` lo saca de la evaluación y de los
+ * selectores, y los segmentos que lo usaban siguen resolviendo su nombre.
+ * @enum {string}
+ */
+var CohortStatusEnum;
+(function (CohortStatusEnum) {
+    CohortStatusEnum["ACTIVE"] = "ACTIVE";
+    CohortStatusEnum["ARCHIVED"] = "ARCHIVED";
+})(CohortStatusEnum || (exports.CohortStatusEnum = CohortStatusEnum = {}));

package/bin/loanOfferings/enums/SegmentFilterIdEnum.d.ts

@@ -4,6 +4,8 @@
  *
  * El nombre y la descripción que ve el operador NO viven acá: los sirve
  * `GET /segments/filters`, junto con la marca de si el filtro tiene fuente de datos hoy.
+ * @deprecated El segmento se arma con cohorts (`cohortIds`). Se conserva para migrar los filtros
+ * viejos y para los consumidores que todavía lo importan.
  * @enum {string}
  */
 export declare enum SegmentFilterIdEnum {

package/bin/loanOfferings/enums/SegmentFilterIdEnum.js

@@ -7,6 +7,8 @@ exports.SegmentFilterIdEnum = void 0;
  *
  * El nombre y la descripción que ve el operador NO viven acá: los sirve
  * `GET /segments/filters`, junto con la marca de si el filtro tiene fuente de datos hoy.
+ * @deprecated El segmento se arma con cohorts (`cohortIds`). Se conserva para migrar los filtros
+ * viejos y para los consumidores que todavía lo importan.
  * @enum {string}
  */
 var SegmentFilterIdEnum;

package/bin/loanOfferings/enums/SegmentLogEventEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Evento de la bitácora de un segmento.
+ * @enum {string}
+ */
+export declare enum SegmentLogEventEnum {
+    CREATED = "CREATED",
+    UPDATED = "UPDATED",
+    ARCHIVED = "ARCHIVED",
+    REACTIVATED = "REACTIVATED"
+}

package/bin/loanOfferings/enums/SegmentLogEventEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentLogEventEnum = void 0;
+/**
+ * Evento de la bitácora de un segmento.
+ * @enum {string}
+ */
+var SegmentLogEventEnum;
+(function (SegmentLogEventEnum) {
+    SegmentLogEventEnum["CREATED"] = "CREATED";
+    SegmentLogEventEnum["UPDATED"] = "UPDATED";
+    SegmentLogEventEnum["ARCHIVED"] = "ARCHIVED";
+    SegmentLogEventEnum["REACTIVATED"] = "REACTIVATED";
+})(SegmentLogEventEnum || (exports.SegmentLogEventEnum = SegmentLogEventEnum = {}));

package/bin/loanOfferings/enums/SegmentMembershipReasonEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Por qué un cliente entra a un segmento: está en la lista manual (`MEMBER`) o cumple al menos
+ * uno de sus cohorts (`COHORT`). Si cumple las dos, gana la lista manual.
+ * @enum {string}
+ */
+export declare enum SegmentMembershipReasonEnum {
+    MEMBER = "MEMBER",
+    COHORT = "COHORT"
+}

package/bin/loanOfferings/enums/SegmentMembershipReasonEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentMembershipReasonEnum = void 0;
+/**
+ * Por qué un cliente entra a un segmento: está en la lista manual (`MEMBER`) o cumple al menos
+ * uno de sus cohorts (`COHORT`). Si cumple las dos, gana la lista manual.
+ * @enum {string}
+ */
+var SegmentMembershipReasonEnum;
+(function (SegmentMembershipReasonEnum) {
+    SegmentMembershipReasonEnum["MEMBER"] = "MEMBER";
+    SegmentMembershipReasonEnum["COHORT"] = "COHORT";
+})(SegmentMembershipReasonEnum || (exports.SegmentMembershipReasonEnum = SegmentMembershipReasonEnum = {}));

package/bin/loanOfferings/enums/SegmentationRecountStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado de una corrida de recálculo de conteos de cohorts y segmentos.
+ * @enum {string}
+ */
+export declare enum SegmentationRecountStatusEnum {
+    RUNNING = "RUNNING",
+    FINISHED = "FINISHED",
+    FAILED = "FAILED"
+}

package/bin/loanOfferings/enums/SegmentationRecountStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentationRecountStatusEnum = void 0;
+/**
+ * Estado de una corrida de recálculo de conteos de cohorts y segmentos.
+ * @enum {string}
+ */
+var SegmentationRecountStatusEnum;
+(function (SegmentationRecountStatusEnum) {
+    SegmentationRecountStatusEnum["RUNNING"] = "RUNNING";
+    SegmentationRecountStatusEnum["FINISHED"] = "FINISHED";
+    SegmentationRecountStatusEnum["FAILED"] = "FAILED";
+})(SegmentationRecountStatusEnum || (exports.SegmentationRecountStatusEnum = SegmentationRecountStatusEnum = {}));

package/bin/loanOfferings/enums/SegmentationRecountTriggerEnum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Qué disparó un recálculo de conteos: la corrida nocturna o el botón del backoffice.
+ * @enum {string}
+ */
+export declare enum SegmentationRecountTriggerEnum {
+    NIGHTLY = "NIGHTLY",
+    MANUAL = "MANUAL"
+}

package/bin/loanOfferings/enums/SegmentationRecountTriggerEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentationRecountTriggerEnum = void 0;
+/**
+ * Qué disparó un recálculo de conteos: la corrida nocturna o el botón del backoffice.
+ * @enum {string}
+ */
+var SegmentationRecountTriggerEnum;
+(function (SegmentationRecountTriggerEnum) {
+    SegmentationRecountTriggerEnum["NIGHTLY"] = "NIGHTLY";
+    SegmentationRecountTriggerEnum["MANUAL"] = "MANUAL";
+})(SegmentationRecountTriggerEnum || (exports.SegmentationRecountTriggerEnum = SegmentationRecountTriggerEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -16,7 +16,18 @@ 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 './constants/promotionRetailerScope';
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';
@@ -43,7 +54,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 +86,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,8 +33,19 @@ __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);
+__exportStar(require("./constants/promotionRetailerScope"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/PrepaymentMinimum"), exports);
@@ -63,7 +74,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 +107,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.615.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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

@@ -120,4 +120,11 @@ export class OriginateLoanCreditRequest {
     @IsOptional()
     @IsEnum(ProductTierEnum)
     productTier?: ProductTierEnum;
+
+    /** Cadena de la tienda que vende; sin ella no se resuelven las promociones acotadas por cadena. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
 }

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/constants/promotionRetailerScope.ts

@@ -0,0 +1,2 @@
+/** Tope de cadenas por promoción de crédito. */
+export const PROMOTION_RETAILER_IDS_MAX_ITEMS = 50;

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/CreatePromotionRequest.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';
@@ -65,6 +68,15 @@ export class CreatePromotionRequest {
     @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()