@fiado/type-kit 3.528.0 → 3.530.0

package/bin/rewardsEligibility/enums/SegmentStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentStatusEnum = void 0;
+var SegmentStatusEnum;
+(function (SegmentStatusEnum) {
+    SegmentStatusEnum["DRAFT"] = "DRAFT";
+    SegmentStatusEnum["ACTIVE"] = "ACTIVE";
+    SegmentStatusEnum["ARCHIVED"] = "ARCHIVED";
+})(SegmentStatusEnum || (exports.SegmentStatusEnum = SegmentStatusEnum = {}));

package/bin/rewardsEligibility/enums/SegmentTestStatusEnum.d.ts

@@ -0,0 +1,5 @@
+export declare enum SegmentTestStatusEnum {
+    RUNNING = "RUNNING",
+    PASSED = "PASSED",
+    FAILED = "FAILED"
+}

package/bin/rewardsEligibility/enums/SegmentTestStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentTestStatusEnum = void 0;
+var SegmentTestStatusEnum;
+(function (SegmentTestStatusEnum) {
+    SegmentTestStatusEnum["RUNNING"] = "RUNNING";
+    SegmentTestStatusEnum["PASSED"] = "PASSED";
+    SegmentTestStatusEnum["FAILED"] = "FAILED";
+})(SegmentTestStatusEnum || (exports.SegmentTestStatusEnum = SegmentTestStatusEnum = {}));

package/bin/rewardsEligibility/index.d.ts

@@ -68,3 +68,42 @@ export * from './dtos/backoffice/MetricsPointResponse';
 export * from './dtos/backoffice/FailedConditionStatResponse';
 export * from './dtos/backoffice/FailedConditionEvaluationResponse';
 export * from './dtos/backoffice/MetricsQuery';
+export * from './enums/SegmentStatusEnum';
+export * from './enums/SegmentTestStatusEnum';
+export * from './enums/SegmentMatchEnum';
+export * from './enums/SegmentConditionKindEnum';
+export * from './enums/SegmentAggregateFnEnum';
+export * from './enums/SegmentOperatorEnum';
+export * from './enums/SegmentParamTypeEnum';
+export * from './enums/SegmentParamSourceEnum';
+export * from './enums/SegmentErrorCodeEnum';
+export * from './enums/EligibilityMessageTypeEnum';
+export * from './constants/SegmentLimits';
+export * from './dtos/backoffice/segments/SegmentWindow';
+export * from './dtos/backoffice/segments/SegmentColumnCondition';
+export * from './dtos/backoffice/segments/SegmentAggregateCondition';
+export * from './dtos/backoffice/segments/SegmentGroup';
+export * from './dtos/backoffice/segments/PopulationSegmentDefinition';
+export * from './dtos/backoffice/segments/SegmentParam';
+export * from './dtos/backoffice/segments/SegmentUsedColumn';
+export * from './dtos/backoffice/segments/SegmentLastTest';
+export * from './dtos/backoffice/segments/SegmentTestRequest';
+export * from './dtos/backoffice/segments/SegmentTestResponse';
+export * from './dtos/backoffice/segments/SegmentSaveRequest';
+export * from './dtos/backoffice/segments/SegmentStatusRequest';
+export * from './dtos/backoffice/segments/SegmentVersionResponse';
+export * from './dtos/backoffice/segments/SegmentVersionSummaryResponse';
+export * from './dtos/backoffice/segments/SegmentListResponse';
+export * from './dtos/backoffice/segments/SegmentVersionListResponse';
+export * from './dtos/backoffice/segments/SegmentSchemaResponse';
+export * from './dtos/backoffice/segments/SegmentTableSchemaResponse';
+export * from './dtos/backoffice/segments/SegmentUsedByResponse';
+export * from './dtos/messages/PopulationPageMessage';
+export * from './dtos/messages/EvaluateBatchMessage';
+export * from './dtos/messages/GrantBatchMessage';
+export * from './dtos/messages/ReleaseTrancheMessage';
+export * from './dtos/backoffice/segments/PrivateSegmentResponse';
+export * from './dtos/backoffice/segments/SegmentExecutionRequest';
+export * from './dtos/backoffice/segments/SegmentExecutionResponse';
+export * from './dtos/backoffice/segments/SegmentExecutionPageResponse';
+export * from './dtos/backoffice/RunPopulationProgress';

package/bin/rewardsEligibility/index.js

@@ -90,3 +90,46 @@ __exportStar(require("./dtos/backoffice/MetricsPointResponse"), exports);
 __exportStar(require("./dtos/backoffice/FailedConditionStatResponse"), exports);
 __exportStar(require("./dtos/backoffice/FailedConditionEvaluationResponse"), exports);
 __exportStar(require("./dtos/backoffice/MetricsQuery"), exports);
+//Segmentos de poblacion (adenda 2026-10-12)
+__exportStar(require("./enums/SegmentStatusEnum"), exports);
+__exportStar(require("./enums/SegmentTestStatusEnum"), exports);
+__exportStar(require("./enums/SegmentMatchEnum"), exports);
+__exportStar(require("./enums/SegmentConditionKindEnum"), exports);
+__exportStar(require("./enums/SegmentAggregateFnEnum"), exports);
+__exportStar(require("./enums/SegmentOperatorEnum"), exports);
+__exportStar(require("./enums/SegmentParamTypeEnum"), exports);
+__exportStar(require("./enums/SegmentParamSourceEnum"), exports);
+__exportStar(require("./enums/SegmentErrorCodeEnum"), exports);
+__exportStar(require("./enums/EligibilityMessageTypeEnum"), exports);
+__exportStar(require("./constants/SegmentLimits"), exports);
+//Segmentos de poblacion: definicion del constructor (A2)
+__exportStar(require("./dtos/backoffice/segments/SegmentWindow"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentColumnCondition"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentAggregateCondition"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentGroup"), exports);
+__exportStar(require("./dtos/backoffice/segments/PopulationSegmentDefinition"), exports);
+//Segmentos de poblacion: request/response del backoffice (A3)
+__exportStar(require("./dtos/backoffice/segments/SegmentParam"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentUsedColumn"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentLastTest"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentTestRequest"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentTestResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentSaveRequest"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentStatusRequest"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentVersionResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentVersionSummaryResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentListResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentVersionListResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentSchemaResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentTableSchemaResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentUsedByResponse"), exports);
+//Segmentos de poblacion: mensajes SQS, endpoint privado y avance de corrida (A4)
+__exportStar(require("./dtos/messages/PopulationPageMessage"), exports);
+__exportStar(require("./dtos/messages/EvaluateBatchMessage"), exports);
+__exportStar(require("./dtos/messages/GrantBatchMessage"), exports);
+__exportStar(require("./dtos/messages/ReleaseTrancheMessage"), exports);
+__exportStar(require("./dtos/backoffice/segments/PrivateSegmentResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentExecutionRequest"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentExecutionResponse"), exports);
+__exportStar(require("./dtos/backoffice/segments/SegmentExecutionPageResponse"), exports);
+__exportStar(require("./dtos/backoffice/RunPopulationProgress"), exports);

package/package.json

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

package/src/emailVerification/dtos/EmailSetTrustedRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsEmail, IsEnum, IsString } from 'class-validator';
+import { IsBoolean, IsEmail, IsEnum, IsOptional, IsString } from 'class-validator';
 import { EmailTypeEnum } from '../enums/EmailTypeEnum';
 
 /**
@@ -18,4 +18,10 @@ export class EmailSetTrustedRequest {
     @Expose()
     @IsEnum(EmailTypeEnum)
     type!: EmailTypeEnum;
+
+    /** En true, el correo queda como principal del directorio. Sin el campo, no cambia el principal. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    isPrincipal?: boolean;
 }

package/src/retailWizard/dtos/WizardSession.ts

@@ -15,6 +15,8 @@ import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 import type { WizardCreditPromotionBonus } from './WizardCreditPromotionBonus';
+import type { EmailStateEnum } from '../enums/EmailStateEnum';
+import type { EmailTypeEnum } from '../../emailVerification/enums/EmailTypeEnum';
 
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
@@ -68,6 +70,14 @@ export interface WizardSession {
    */
   resumeTarget?: WizardResumeTarget | null;
   consents: WizardConsents | null;
+  /** Estado del correo del cliente en el paso 01. Ausente en sesiones anteriores al correo. */
+  emailState?: EmailStateEnum;
+  /** Tipo del correo: personal o corporativo. */
+  emailType?: EmailTypeEnum;
+  /** Correo enmascarado (`ju•••••@gmail.com`); viaja siempre que la sesión tenga correo. */
+  emailMasked?: string;
+  /** Correo completo: solo con `emailState` CAPTURED, porque lo tecleó el vendedor. */
+  email?: string;
   /** Espejo del estado KYC (fuente = customer). */
   kycStatus: string | null;
   kycModality: KycModality | null;

package/src/retailWizard/dtos/requests/SendEmailOtpRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsEnum } from 'class-validator';
+import { EmailTypeEnum } from '../../../emailVerification/enums/EmailTypeEnum';
+
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+export class SendEmailOtpRequest {
+  @Expose()
+  @IsEmail()
+  email!: string;
+
+  @Expose()
+  @IsEnum(EmailTypeEnum)
+  type!: EmailTypeEnum;
+}

package/src/retailWizard/dtos/requests/VerifyEmailOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+export class VerifyEmailOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

package/src/retailWizard/enums/EmailStateEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+export enum EmailStateEnum {
+    EXISTING = 'EXISTING',
+    CAPTURED = 'CAPTURED',
+    PENDING = 'PENDING',
+}

package/src/retailWizard/index.ts

@@ -29,6 +29,7 @@ export * from './enums/BlockedCategoryEnum';
 export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
+export * from './enums/EmailStateEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -101,6 +102,8 @@ export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
+export * from './dtos/requests/SendEmailOtpRequest';
+export * from './dtos/requests/VerifyEmailOtpRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';

package/src/rewardsEligibility/constants/BackofficeLimits.ts

@@ -14,3 +14,5 @@ export const LIST_PAGE_MAX = 100;
 export const RULES_CHAT_TURN_MAX_LENGTH = 4000;
 /** Tope de seguridad de turnos que acepta el DTO (el límite funcional, 10, lo aplica el lambda con `AI_CHAT_HISTORY_TOO_LONG`). */
 export const RULES_CHAT_MAX_TURNS_HARD = 50;
+/** Llave de un input de una evaluacion (ej. `directoryId`). */
+export const INPUT_KEY_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]{0,63}$/;

package/src/rewardsEligibility/constants/SegmentLimits.ts

@@ -0,0 +1,5 @@
+/** Identificador SQL permitido para tabla/columna (A§4.3 paso 1): minusculas, digitos y guion bajo; nunca texto libre. */
+export const SEGMENT_IDENTIFIER_PATTERN = /^[a-z_][a-z0-9_]*$/;
+export const SEGMENT_MAX_DAYS = 365;
+export const SEGMENT_MAX_PARAMS = 40;
+export const SEGMENT_MAX_AGGREGATES = 8;

package/src/rewardsEligibility/dtos/backoffice/CreateRunRequest.ts

@@ -1,5 +1,5 @@
 import { Expose, Type } from 'class-transformer';
-import { IsEnum, IsOptional, Matches, Validate, ValidateNested } from 'class-validator';
+import { IsEnum, IsObject, IsOptional, Matches, Validate } from 'class-validator';
 import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
 import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
 import { REQUEST_ID_PATTERN } from '../../constants/BackofficeLimits';
@@ -24,7 +24,8 @@ export class CreateRunRequest {
 
     @Expose()
     @IsOptional()
-    @ValidateNested()
+    // `PopulationRunRequest` no tiene campos: class-validator rechaza validar anidado una clase sin metadatos, por eso `@IsObject()`.
+    @IsObject()
     @Type(() => PopulationRunRequest)
     population?: PopulationRunRequest;
 }

package/src/rewardsEligibility/dtos/backoffice/EvaluationRequest.ts

@@ -1,8 +1,8 @@
 import { Expose } from 'class-transformer';
-import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsObject, IsString, Matches, MaxLength } from 'class-validator';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsObject, IsOptional, IsString, Matches, MaxLength } from 'class-validator';
 import { JsonValue } from '../../../common';
 import { InputField } from '../../../dynamicForm/dtos/InputField';
-import { ELIGIBILITY_ID_PATTERN } from '../../constants/BackofficeLimits';
+import { ELIGIBILITY_ID_PATTERN, INPUT_KEY_PATTERN } from '../../constants/BackofficeLimits';
 import { EvaluationReward } from '../EvaluationReward';
 import { EvaluationTrigger } from '../EvaluationTrigger';
 import { GrantPolicy } from '../GrantPolicy';
@@ -66,4 +66,18 @@ export class EvaluationRequest {
     @ArrayMaxSize(10)
     @IsObject({ each: true })
     triggers: EvaluationTrigger[];
+
+    /** Segmento de poblacion (version ACTIVE) que usan las corridas masivas de esta evaluacion. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(ELIGIBILITY_ID_PATTERN)
+    populationSegmentId?: string;
+
+    /** Llave del input `DIRECTORY` que recibe el `directoryid` de cada persona del segmento. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(INPUT_KEY_PATTERN)
+    populationInputKey?: string;
 }

package/src/rewardsEligibility/dtos/backoffice/EvaluationResponse.ts

@@ -19,6 +19,8 @@ export class EvaluationResponse {
     reward: EvaluationReward;
     grantPolicy: GrantPolicy;
     triggers: EvaluationTrigger[];
+    populationSegmentId?: string;
+    populationInputKey?: string;
     createdAt: number;
     updatedAt: number;
     updatedBy: string;

package/src/rewardsEligibility/dtos/backoffice/PopulationRunRequest.ts

@@ -1,11 +1,2 @@
-import { Expose } from 'class-transformer';
-import { Validate } from 'class-validator';
-import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
-import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
-
-/** Corrida por población (fase 4): los `params` de la fuente para esta corrida. El lambda de la fase 3 la rechaza con `POPULATION_RUN_NOT_SUPPORTED`. */
-export class PopulationRunRequest {
-    @Expose()
-    @Validate(IsDynamicFormValues)
-    params: Record<string, DynamicFormValue>;
-}
+/** Sin override de params (A§7.3): cambiar la poblacion = version nueva del segmento. `population: {}` = "usa el segmento de la evaluacion". */
+export class PopulationRunRequest {}

package/src/rewardsEligibility/dtos/backoffice/RunPopulationProgress.ts

@@ -0,0 +1,9 @@
+/** Avance de la corrida masiva: paginas, lotes y sujetos publicados. */
+export class RunPopulationProgress {
+    pagesPublished: number;
+    batchesPublished: number;
+    subjectsPublished: number;
+    exhausted: boolean;
+    stoppedReason?: string;
+    lastAdvanceAt: number;
+}

package/src/rewardsEligibility/dtos/backoffice/RunResponse.ts

@@ -4,6 +4,7 @@ import { RunStatusEnum } from '../../enums/RunStatusEnum';
 import { TriggerTypeEnum } from '../../enums/TriggerTypeEnum';
 import { RunCounts } from '../RunCounts';
 import { QuotaImpactResponse } from './QuotaImpactResponse';
+import { RunPopulationProgress } from './RunPopulationProgress';
 
 /** Corrida para el backoffice (spec 10). */
 export class RunResponse {
@@ -19,6 +20,17 @@ export class RunResponse {
     counts: RunCounts;
     /** Solo con `status: AWAITING_APPROVAL`: cuánto consumiría la corrida de cada cupo y cuánto queda. */
     quotaImpact?: QuotaImpactResponse[];
+    /** Corrida masiva: instante fijo (epoch ms) contra el que se resuelven las ventanas relativas del segmento. */
+    referenceAt?: number;
+    /** Corrida masiva: version del segmento congelada. */
+    segment?: { segmentId: string; version: number };
+    population?: RunPopulationProgress;
+    /** Fallos de entrega (`GRANT_FAILED`) que llegaron tarde, con la corrida ya cerrada. */
+    requestFailedLate?: number;
+    /** Motivo de una corrida `FAILED` que nunca llego a tener `population`. */
+    failureReason?: string;
+    /** Avance del drenaje de una aprobacion masiva. */
+    approvalDrain?: { action: 'GRANT' | 'RELEASE' | 'CANCEL'; enqueued: number; done: boolean };
     requestedBy: string;
     createdAt: number;
     updatedAt: number;

package/src/rewardsEligibility/dtos/backoffice/segments/PopulationSegmentDefinition.ts

@@ -0,0 +1,12 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsEnum, Matches, ValidateNested } from 'class-validator';
+import { SEGMENT_IDENTIFIER_PATTERN } from '../../../constants/SegmentLimits';
+import { SegmentMatchEnum } from '../../../enums/SegmentMatchEnum';
+import { SegmentGroup } from './SegmentGroup';
+
+/** El constructor tal cual (A§4.1): tabla ancla (una fila -> un directoryid), TODAS/ALGUNA global y grupos con su propio TODAS/ALGUNA. */
+export class PopulationSegmentDefinition {
+    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) baseTable: string;
+    @Expose() @IsEnum(SegmentMatchEnum) match: SegmentMatchEnum;
+    @Expose() @IsArray() @ArrayMinSize(1) @ArrayMaxSize(10) @ValidateNested({ each: true }) @Type(() => SegmentGroup) groups: SegmentGroup[];
+}

package/src/rewardsEligibility/dtos/backoffice/segments/PrivateSegmentResponse.ts

@@ -0,0 +1,12 @@
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+import { SegmentParam } from './SegmentParam';
+
+/** Version de un segmento tal como la consumen otros servicios (con el SQL compilado). */
+export class PrivateSegmentResponse {
+    segmentId: string;
+    version: number;
+    name: string;
+    definition: PopulationSegmentDefinition;
+    sql: string;
+    params: SegmentParam[];
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentAggregateCondition.ts

@@ -0,0 +1,22 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, Equals, IsArray, IsEnum, IsNumber, IsOptional, Matches, ValidateNested } from 'class-validator';
+import { SEGMENT_IDENTIFIER_PATTERN } from '../../../constants/SegmentLimits';
+import { SegmentAggregateFnEnum } from '../../../enums/SegmentAggregateFnEnum';
+import { SegmentConditionKindEnum } from '../../../enums/SegmentConditionKindEnum';
+import { SegmentOperatorEnum } from '../../../enums/SegmentOperatorEnum';
+import { SegmentColumnCondition } from './SegmentColumnCondition';
+import { SegmentWindow } from './SegmentWindow';
+
+/** (b) Agregado con ventana relativa sobre una tabla relacionada (existe / cuenta / suma). `filters` elige QUE cuenta (estados, moneda...). */
+export class SegmentAggregateCondition {
+    @Expose() @Equals(SegmentConditionKindEnum.AGGREGATE) kind: SegmentConditionKindEnum.AGGREGATE;
+    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) table: string;
+    @Expose() @IsEnum(SegmentAggregateFnEnum) fn: SegmentAggregateFnEnum;
+    /** Solo SUM. */
+    @Expose() @IsOptional() @Matches(SEGMENT_IDENTIFIER_PATTERN) column?: string;
+    /** COUNT y SUM; EXISTS no lleva. */
+    @Expose() @IsOptional() @IsEnum(SegmentOperatorEnum) op?: SegmentOperatorEnum;
+    @Expose() @IsOptional() @IsNumber() value?: number;
+    @Expose() @ValidateNested() @Type(() => SegmentWindow) window: SegmentWindow;
+    @Expose() @IsArray() @ArrayMaxSize(10) @ValidateNested({ each: true }) @Type(() => SegmentColumnCondition) filters: SegmentColumnCondition[];
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentColumnCondition.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { Equals, IsEnum, IsOptional, Matches } from 'class-validator';
+import { JsonValue } from '../../../../common';
+import { SEGMENT_IDENTIFIER_PATTERN } from '../../../constants/SegmentLimits';
+import { SegmentConditionKindEnum } from '../../../enums/SegmentConditionKindEnum';
+import { SegmentOperatorEnum } from '../../../enums/SegmentOperatorEnum';
+
+/** (a) Columna de una tabla unida por `directoryid`. El tipo de `value` (escalar, lista o `{days}`) lo valida el compilador contra el tipo de Glue. */
+export class SegmentColumnCondition {
+    @Expose() @Equals(SegmentConditionKindEnum.COLUMN) kind: SegmentConditionKindEnum.COLUMN;
+    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) table: string;
+    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) column: string;
+    @Expose() @IsEnum(SegmentOperatorEnum) op: SegmentOperatorEnum;
+    @Expose() @IsOptional() value?: JsonValue;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentExecutionPageResponse.ts

@@ -0,0 +1,8 @@
+export class SegmentExecutionPageResponse {
+    executionId: string;
+    status: string;
+    /** Hasta 1000 `directoryid`. */
+    ids: string[];
+    nextToken?: string;
+    reason?: string;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentExecutionRequest.ts

@@ -0,0 +1,17 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsISO8601, IsOptional, Min } from 'class-validator';
+
+/** Ejecucion de un segmento desde otro servicio (endpoint privado). */
+export class SegmentExecutionRequest {
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    version?: number;
+
+    /** ISO-8601 UTC; por defecto, ahora. Fija la ventana relativa del segmento. */
+    @Expose()
+    @IsOptional()
+    @IsISO8601({ strict: true })
+    referenceAt?: string;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentExecutionResponse.ts

@@ -0,0 +1,7 @@
+export class SegmentExecutionResponse {
+    executionId: string;
+    segmentId: string;
+    version: number;
+    referenceAt: string;
+    status: string;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentGroup.ts

@@ -0,0 +1,27 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsEnum, ValidateNested } from 'class-validator';
+import { SegmentConditionKindEnum } from '../../../enums/SegmentConditionKindEnum';
+import { SegmentMatchEnum } from '../../../enums/SegmentMatchEnum';
+import { SegmentAggregateCondition } from './SegmentAggregateCondition';
+import { SegmentColumnCondition } from './SegmentColumnCondition';
+
+export type SegmentCondition = SegmentColumnCondition | SegmentAggregateCondition;
+
+export class SegmentGroup {
+    @Expose() @IsEnum(SegmentMatchEnum) match: SegmentMatchEnum;
+
+    /** `kind` decide la clase; un `kind` desconocido NO se instancia y la validacion lo rechaza (el objeto queda sin `@Equals` valido). */
+    @Expose()
+    @IsArray() @ArrayMinSize(1) @ArrayMaxSize(20) @ValidateNested({ each: true })
+    @Type(() => Object, {
+        keepDiscriminatorProperty: true,
+        discriminator: {
+            property: 'kind',
+            subTypes: [
+                { value: SegmentColumnCondition, name: SegmentConditionKindEnum.COLUMN },
+                { value: SegmentAggregateCondition, name: SegmentConditionKindEnum.AGGREGATE },
+            ],
+        },
+    })
+    conditions: SegmentCondition[];
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentLastTest.ts

@@ -0,0 +1,8 @@
+export class SegmentLastTest {
+    testedAt: string;
+    count: number;
+    bytesScanned: number;
+    durationMs: number;
+    referenceAt: string;
+    queryExecutionId: string;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentListResponse.ts

@@ -0,0 +1,11 @@
+import { SegmentVersionResponse } from './SegmentVersionResponse';
+
+export class SegmentListItemResponse extends SegmentVersionResponse {
+    /** Evaluaciones de rewards que lo usan (los consumidores externos del endpoint privado NO cuentan). */
+    usedByCount: number;
+}
+
+export class SegmentListResponse {
+    items: SegmentListItemResponse[];
+    nextCursor?: string;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentParam.ts

@@ -0,0 +1,11 @@
+import { SegmentParamSourceEnum } from '../../../enums/SegmentParamSourceEnum';
+import { SegmentParamTypeEnum } from '../../../enums/SegmentParamTypeEnum';
+
+/** Un `?` del SQL, en orden. LITERAL lleva `value` como texto canonico; REFERENCE_AT_MINUS_DAYS lleva `days`. */
+export class SegmentParam {
+    name: string;
+    type: SegmentParamTypeEnum;
+    source: SegmentParamSourceEnum;
+    value?: string;
+    days?: number;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentSaveRequest.ts

@@ -0,0 +1,16 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsIn, IsNotEmpty, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+import { SegmentStatusEnum } from '../../../enums/SegmentStatusEnum';
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+
+/** POST /population-segments y PUT /population-segments/{segmentId}. */
+export class SegmentSaveRequest {
+    @Expose() @IsString() @IsNotEmpty() @MaxLength(160) name: string;
+    @Expose() @IsString() @MaxLength(500) description: string;
+    /** Responsable del segmento (usuario o equipo, texto). */
+    @Expose() @IsString() @IsNotEmpty() @MaxLength(120) owner: string;
+    @Expose() @IsDefined() @ValidateNested() @Type(() => PopulationSegmentDefinition) definition: PopulationSegmentDefinition;
+    /** `testId` de `POST /population-segments/test`: el servidor exige que sea PASSED, vigente y de ESTA definicion. */
+    @Expose() @IsString() @Matches(/^[A-Za-z0-9-]{1,64}$/) testId: string;
+    @Expose() @IsIn([SegmentStatusEnum.DRAFT, SegmentStatusEnum.ACTIVE]) status: SegmentStatusEnum.DRAFT | SegmentStatusEnum.ACTIVE;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentSchemaResponse.ts

@@ -0,0 +1,11 @@
+export class SegmentSchemaTableResponse {
+    table: string;
+    joinKey: string;
+    columnCount: number;
+}
+
+/** `available: false` = ambiente sin datalake accesible: el constructor muestra "no disponible". */
+export class SegmentSchemaResponse {
+    available: boolean;
+    tables: SegmentSchemaTableResponse[];
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentStatusRequest.ts

@@ -0,0 +1,9 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, Min } from 'class-validator';
+import { SegmentStatusEnum } from '../../../enums/SegmentStatusEnum';
+
+/** POST /population-segments/{segmentId}/status: activar un DRAFT (con `version`) o archivar el segmento completo. */
+export class SegmentStatusRequest {
+    @Expose() @IsOptional() @IsInt() @Min(1) version?: number;
+    @Expose() @IsEnum(SegmentStatusEnum) status: SegmentStatusEnum;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentTableSchemaResponse.ts

@@ -0,0 +1,14 @@
+import { SegmentOperatorEnum } from '../../../enums/SegmentOperatorEnum';
+
+export class SegmentColumnSchemaResponse {
+    name: string;
+    type: string;
+    isDate: boolean;
+    operators: SegmentOperatorEnum[];
+}
+
+export class SegmentTableSchemaResponse {
+    table: string;
+    joinKey: string;
+    columns: SegmentColumnSchemaResponse[];
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentTestRequest.ts

@@ -0,0 +1,7 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, ValidateNested } from 'class-validator';
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+
+export class SegmentTestRequest {
+    @Expose() @IsDefined() @ValidateNested() @Type(() => PopulationSegmentDefinition) definition: PopulationSegmentDefinition;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/SegmentTestResponse.ts

@@ -0,0 +1,29 @@
+import { SegmentErrorCodeEnum } from '../../../enums/SegmentErrorCodeEnum';
+import { SegmentTestStatusEnum } from '../../../enums/SegmentTestStatusEnum';
+import { SegmentParam } from './SegmentParam';
+
+export class SegmentTestResultResponse {
+    count: number;
+    /** Ids parciales (`a41f...09c2`), hasta 20. */
+    sampleIds: string[];
+    bytesScanned: number;
+    durationMs: number;
+}
+
+export class SegmentTestErrorResponse {
+    code: SegmentErrorCodeEnum;
+    message: string;
+}
+
+export class SegmentTestResponse {
+    testId: string;
+    status: SegmentTestStatusEnum;
+    referenceAt: string;
+    /** Resumen en lenguaje normal generado de forma determinista (sin IA). */
+    humanSummary: string;
+    /** SQL de solo lectura + params separados (la UI no deja editarlos). */
+    sql: string;
+    params: SegmentParam[];
+    result?: SegmentTestResultResponse;
+    errors?: SegmentTestErrorResponse[];
+}