@fiado/type-kit 3.539.0 → 3.541.0

package/package.json

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

package/src/retailCustomer/dtos/requests/EnsureCustomerByPhoneRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches, MinLength } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/**
+ * POST /private/customers/ensure-by-phone — da de alta al cliente solo con su celular verificado,
+ * o devuelve el que ya existe con ese número.
+ */
+export class EnsureCustomerByPhoneRequest {
+    @Expose()
+    @IsString()
+    @Matches(regexPhoneMx, { message: 'phone debe tener 10 dígitos' })
+    phone!: string;
+
+    /** Tienda del primer contacto; no cambia si el cliente ya existía. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    originStoreId!: string;
+}

package/src/retailCustomer/dtos/responses/EnsureCustomerByPhoneResponse.ts

@@ -0,0 +1,6 @@
+import { CustomerResponse } from './CustomerResponse';
+
+/** Cliente resuelto por celular; `created` dice si esta llamada lo dio de alta. */
+export interface EnsureCustomerByPhoneResponse extends CustomerResponse {
+    created: boolean;
+}

package/src/retailCustomer/index.ts

@@ -24,6 +24,7 @@ export * from './dtos/requests/KycReviewRequest';
 export * from './dtos/requests/WelcomeAccreditationRequest';
 export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/requests/UpsertPromotionBonusRequest';
+export * from './dtos/requests/EnsureCustomerByPhoneRequest';
 
 // Response DTOs
 export * from './dtos/responses/CustomerResponse';
@@ -31,6 +32,7 @@ export * from './dtos/responses/Customer360Response';
 export * from './dtos/responses/WelcomeBonusResponse';
 export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './dtos/responses/PromotionBonusEntryResponse';
+export * from './dtos/responses/EnsureCustomerByPhoneResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/CustomerCreatedV1';

package/src/retailWizard/dtos/AccessorySaleLine.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsInt, IsOptional, IsString, Min, MinLength } from 'class-validator';
+
+/** Línea del carrito de accesorios; el precio lo pone el catálogo, no el request. */
+export class AccessorySaleLine {
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  sku!: string;
+
+  @Expose()
+  @IsInt()
+  @Min(1)
+  qty!: number;
+
+  /** Serie de cada pieza cuando el SKU se rastrea por pieza; ausente si se rastrea por cantidad. */
+  @Expose()
+  @IsOptional()
+  @IsArray()
+  @ArrayMaxSize(100)
+  @IsString({ each: true })
+  identifiers?: string[];
+}

package/src/retailWizard/dtos/Sale.ts

@@ -1,6 +1,7 @@
 import type { SaleTypeEnum } from '../enums/SaleTypeEnum';
 import type { SaleStatusEnum } from '../enums/SaleStatusEnum';
 import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import type { SaleChannelEnum } from '../enums/SaleChannelEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
@@ -18,7 +19,10 @@ export interface Sale {
   storeId: string;
   sellerRetailUserId: string;
   retailCustomerId: string;
-  wizardSessionId: string;
+  /** Sesión del wizard que cerró la venta; ausente en la venta de mostrador. */
+  wizardSessionId?: string;
+  /** Canal de la venta; ausente = `WIZARD` (ventas anteriores al campo). */
+  saleChannel?: SaleChannelEnum;
   type: SaleTypeEnum;
   externalProvider: ExternalProviderEnum | null;
   /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */

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

@@ -0,0 +1,64 @@
+import { Expose, Type } from 'class-transformer';
+import {
+  ArrayMaxSize,
+  ArrayMinSize,
+  IsArray,
+  IsBoolean,
+  IsDefined,
+  IsEnum,
+  IsInt,
+  IsOptional,
+  IsString,
+  Min,
+  MinLength,
+  ValidateNested,
+} from 'class-validator';
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+import { AccessorySaleLine } from '../AccessorySaleLine';
+
+/**
+ * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
+ */
+export class CreateAccessorySaleRequest {
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  otpChallengeId!: string;
+
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ArrayMaxSize(50)
+  @ValidateNested({ each: true })
+  @Type(() => AccessorySaleLine)
+  lines!: AccessorySaleLine[];
+
+  @Expose()
+  @IsEnum(SalePaymentMethodEnum)
+  paymentMethod!: SalePaymentMethodEnum;
+
+  @Expose()
+  @IsInt()
+  @Min(0)
+  amountCents!: number;
+
+  @Expose()
+  @IsDefined()
+  @ValidateNested()
+  @Type(() => SalePaymentDetail)
+  paymentDetail!: SalePaymentDetail;
+
+  /** El cliente aceptó el aviso de privacidad; sin `true` el back responde 400 PRIVACY_NOTICE_REQUIRED. */
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  privacyNoticeAccepted?: boolean;
+
+  /** Versión del aviso de privacidad que se mostró. */
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  privacyNoticeVersion!: string;
+}

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

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsBoolean, IsOptional, IsString, MaxLength, MinLength, ValidateNested } from 'class-validator';
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
+
+/**
+ * POST /portal/sales/:saleId/cancel — el vendedor cancela una venta cerrada de su tienda, dentro de la
+ * ventana. Mismas validaciones que `BackofficeCancelSaleRequest`, sin la excepción de cancelación tardía.
+ */
+export class PortalCancelSaleRequest {
+    @Expose()
+    @IsString()
+    @MinLength(10)
+    @MaxLength(200)
+    reason!: string;
+
+    /** Equipo o piezas confirmados en tienda; ausente cuenta como no confirmado. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    equipmentVerified?: boolean;
+
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ReturnPieceCondition)
+    returnConditions?: ReturnPieceCondition[];
+}

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

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/** POST /wizard/accessory-sales/otp — manda el OTP al celular del cliente del mostrador. */
+export class SendAccessoryOtpRequest {
+  @Expose()
+  @IsString()
+  @Matches(regexPhoneMx, { message: 'phone debe tener 10 dígitos' })
+  phone!: string;
+}

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

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/accessory-sales/otp/{otpChallengeId}/verify — código que dicta el cliente. */
+export class VerifyAccessoryOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

package/src/retailWizard/dtos/responses/AccessoryOtpChallenge.ts

@@ -0,0 +1,7 @@
+/** Reto OTP del mostrador de accesorios (send y resend). `phoneMasked` muestra solo los últimos 4 dígitos. */
+export interface AccessoryOtpChallenge {
+  otpChallengeId: string;
+  phoneMasked: string;
+  expiresAt: string;
+  resendAvailableAt: string;
+}

package/src/retailWizard/dtos/responses/VerifyAccessoryOtpResponse.ts

@@ -0,0 +1,7 @@
+/** Reto verificado: ampara una sola venta hasta `usableUntil`. */
+export interface VerifyAccessoryOtpResponse {
+  otpChallengeId: string;
+  verified: true;
+  verifiedAt: string;
+  usableUntil: string;
+}

package/src/retailWizard/enums/SaleChannelEnum.ts

@@ -0,0 +1,5 @@
+/** Canal por el que se cerró la venta: el wizard por sesión o el mostrador de accesorios. */
+export enum SaleChannelEnum {
+    WIZARD = 'WIZARD',
+    ACCESSORY_COUNTER = 'ACCESSORY_COUNTER',
+}

package/src/retailWizard/index.ts

@@ -32,6 +32,7 @@ export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
 export * from './enums/EmailStateEnum';
+export * from './enums/SaleChannelEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -57,6 +58,7 @@ export * from './dtos/WizardFinancingPreview';
 export * from './dtos/WizardReservedLine';
 export * from './dtos/WizardGiftLine';
 export * from './dtos/SaleLine';
+export * from './dtos/AccessorySaleLine';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';
@@ -108,6 +110,9 @@ export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/requests/SendEmailOtpRequest';
 export * from './dtos/requests/VerifyEmailOtpRequest';
+export * from './dtos/requests/SendAccessoryOtpRequest';
+export * from './dtos/requests/VerifyAccessoryOtpRequest';
+export * from './dtos/requests/CreateAccessorySaleRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';
@@ -128,6 +133,8 @@ export * from './dtos/responses/ProspectResumeResponse';
 export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
+export * from './dtos/responses/AccessoryOtpChallenge';
+export * from './dtos/responses/VerifyAccessoryOtpResponse';
 
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums
@@ -160,6 +167,7 @@ export * from './dtos/requests/ApplySaleExceptionRequest';
 export * from './dtos/requests/AddSaleExceptionNoteRequest';
 export * from './dtos/requests/RunSalesReportRequest';
 export * from './dtos/requests/BackofficeCancelSaleRequest';
+export * from './dtos/requests/PortalCancelSaleRequest';
 
 // Responses
 export * from './dtos/responses/BackofficeSalesStatsResponse';

package/src/rewardsEligibility/constants/SegmentLimits.ts

@@ -1,5 +1 @@
-/** 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;
+export * from '../../rules/constants/SegmentLimits';

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

@@ -1,12 +1 @@
-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[];
-}
+export * from '../../../../rules/dtos/population/PopulationSegmentDefinition';

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

@@ -1,22 +1 @@
-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[];
-}
+export * from '../../../../rules/dtos/population/SegmentAggregateCondition';

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

@@ -1,15 +1 @@
-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;
-}
+export * from '../../../../rules/dtos/population/SegmentColumnCondition';

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

@@ -1,27 +1 @@
-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[];
-}
+export * from '../../../../rules/dtos/population/SegmentGroup';

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

@@ -1,11 +1 @@
-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;
-}
+export * from '../../../../rules/dtos/population/SegmentParam';

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

@@ -1,11 +1 @@
-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[];
-}
+export * from '../../../../rules/dtos/population/SegmentSchemaResponse';

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

@@ -1,14 +1 @@
-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[];
-}
+export * from '../../../../rules/dtos/population/SegmentTableSchemaResponse';

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

@@ -1,5 +1 @@
-export class SegmentUsedColumn {
-    table: string;
-    column: string;
-    type: string;
-}
+export * from '../../../../rules/dtos/population/SegmentUsedColumn';

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

@@ -1,9 +1 @@
-import { Expose } from 'class-transformer';
-import { IsInt, Matches, Max, Min } from 'class-validator';
-import { SEGMENT_IDENTIFIER_PATTERN, SEGMENT_MAX_DAYS } from '../../../constants/SegmentLimits';
-
-/** Ventana relativa [referenceAt - days, referenceAt) sobre una columna de fecha (A§4.1). */
-export class SegmentWindow {
-    @Expose() @Matches(SEGMENT_IDENTIFIER_PATTERN) dateColumn: string;
-    @Expose() @IsInt() @Min(1) @Max(SEGMENT_MAX_DAYS) days: number;
-}
+export * from '../../../../rules/dtos/population/SegmentWindow';

package/src/rewardsEligibility/enums/SegmentAggregateFnEnum.ts

@@ -1,5 +1 @@
-export enum SegmentAggregateFnEnum {
-    EXISTS = 'EXISTS',
-    COUNT = 'COUNT',
-    SUM = 'SUM',
-}
+export * from '../../rules/enums/SegmentAggregateFnEnum';

package/src/rewardsEligibility/enums/SegmentConditionKindEnum.ts

@@ -1,4 +1 @@
-export enum SegmentConditionKindEnum {
-    COLUMN = 'COLUMN',
-    AGGREGATE = 'AGGREGATE',
-}
+export * from '../../rules/enums/SegmentConditionKindEnum';

package/src/rewardsEligibility/enums/SegmentMatchEnum.ts

@@ -1,4 +1 @@
-export enum SegmentMatchEnum {
-    ALL = 'ALL',
-    ANY = 'ANY',
-}
+export * from '../../rules/enums/SegmentMatchEnum';

package/src/rewardsEligibility/enums/SegmentOperatorEnum.ts

@@ -1,16 +1 @@
-export enum SegmentOperatorEnum {
-    EQUALS = 'EQUALS',
-    NOT_EQUALS = 'NOT_EQUALS',
-    IN = 'IN',
-    NOT_IN = 'NOT_IN',
-    IS_NULL = 'IS_NULL',
-    IS_NOT_NULL = 'IS_NOT_NULL',
-    GT = 'GT',
-    GTE = 'GTE',
-    LT = 'LT',
-    LTE = 'LTE',
-    CONTAINS = 'CONTAINS',
-    ANY_IN = 'ANY_IN',
-    WITHIN_LAST_DAYS = 'WITHIN_LAST_DAYS',
-    NOT_WITHIN_LAST_DAYS = 'NOT_WITHIN_LAST_DAYS',
-}
+export * from '../../rules/enums/SegmentOperatorEnum';

package/src/rewardsEligibility/enums/SegmentParamSourceEnum.ts

@@ -1,5 +1 @@
-export enum SegmentParamSourceEnum {
-    LITERAL = 'LITERAL',
-    REFERENCE_AT = 'REFERENCE_AT',
-    REFERENCE_AT_MINUS_DAYS = 'REFERENCE_AT_MINUS_DAYS',
-}
+export * from '../../rules/enums/SegmentParamSourceEnum';

package/src/rewardsEligibility/enums/SegmentParamTypeEnum.ts

@@ -1,7 +1 @@
-export enum SegmentParamTypeEnum {
-    STRING = 'STRING',
-    INTEGER = 'INTEGER',
-    DECIMAL = 'DECIMAL',
-    BOOLEAN = 'BOOLEAN',
-    TIMESTAMP = 'TIMESTAMP',
-}
+export * from '../../rules/enums/SegmentParamTypeEnum';

package/src/rules/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/rules/dtos/population/PopulationCompileRequest.ts

@@ -0,0 +1,9 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+
+/** Compila una definicion a SQL parametrizado (POST /population/compile). `consumer` solo para logs/metricas. */
+export class PopulationCompileRequest {
+    @Expose() @IsOptional() @IsString() consumer?: string;
+    @Expose() @IsDefined() @ValidateNested() @Type(() => PopulationSegmentDefinition) definition: PopulationSegmentDefinition;
+}

package/src/rules/dtos/population/PopulationCompileResponse.ts

@@ -0,0 +1,10 @@
+import { SegmentParam } from './SegmentParam';
+import { SegmentUsedColumn } from './SegmentUsedColumn';
+
+export class PopulationCompileResponse {
+    sql: string;
+    params: SegmentParam[];
+    usedColumns: SegmentUsedColumn[];
+    humanSummary: string;
+    definitionHash: string;
+}

package/src/rules/dtos/population/PopulationExecutionPageResponse.ts

@@ -0,0 +1,11 @@
+import { PopulationErrorCodeEnum } from '../../enums/PopulationErrorCodeEnum';
+import { PopulationExecutionStatusEnum } from '../../enums/PopulationExecutionStatusEnum';
+
+/** Pagina de hasta 1000 ids. Sin `nextToken` = ultima pagina. */
+export class PopulationExecutionPageResponse {
+    executionId: string;
+    status: PopulationExecutionStatusEnum;
+    ids: string[];
+    nextToken?: string;
+    reason?: PopulationErrorCodeEnum;
+}

package/src/rules/dtos/population/PopulationExecutionRequest.ts

@@ -0,0 +1,13 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsISO8601, IsNotEmpty, IsOptional, IsString, MaxLength, MinLength, ValidateNested } from 'class-validator';
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+
+/** Inicia una ejecucion de poblacion (POST /population/executions). El central recompila; `expectedSql` activa G3 (SEGMENT_SCHEMA_DRIFT). */
+export class PopulationExecutionRequest {
+    @Expose() @IsOptional() @IsString() consumer?: string;
+    @Expose() @IsDefined() @ValidateNested() @Type(() => PopulationSegmentDefinition) definition: PopulationSegmentDefinition;
+    @Expose() @IsISO8601({ strict: true }) referenceAt: string;
+    @Expose() @IsString() @MinLength(32) @MaxLength(128) idempotencyKey: string;
+    @Expose() @IsOptional() @IsString() @IsNotEmpty() expectedSql?: string;
+    @Expose() @IsOptional() @IsString() @MinLength(1) @MaxLength(256) afterDirectoryId?: string;
+}

package/src/rules/dtos/population/PopulationExecutionResponse.ts

@@ -0,0 +1,6 @@
+import { PopulationExecutionStatusEnum } from '../../enums/PopulationExecutionStatusEnum';
+
+export class PopulationExecutionResponse {
+    executionId: string;
+    status: PopulationExecutionStatusEnum;
+}

package/src/rules/dtos/population/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/rules/dtos/population/PopulationTestRequest.ts

@@ -0,0 +1,10 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsISO8601, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+
+/** Prueba sin estado de una definicion (POST /population/tests). `referenceAt` ISO-8601 con zona; por defecto, ahora. */
+export class PopulationTestRequest {
+    @Expose() @IsOptional() @IsString() consumer?: string;
+    @Expose() @IsDefined() @ValidateNested() @Type(() => PopulationSegmentDefinition) definition: PopulationSegmentDefinition;
+    @Expose() @IsOptional() @IsISO8601({ strict: true }) referenceAt?: string;
+}

package/src/rules/dtos/population/PopulationTestResponse.ts

@@ -0,0 +1,29 @@
+import { PopulationErrorCodeEnum } from '../../enums/PopulationErrorCodeEnum';
+import { PopulationTestStatusEnum } from '../../enums/PopulationTestStatusEnum';
+import { SegmentParam } from './SegmentParam';
+
+export class PopulationTestResultResponse {
+    count: number;
+    sampleIds: string[];
+    bytesScanned: number;
+    durationMs: number;
+}
+
+export class PopulationTestErrorResponse {
+    code: PopulationErrorCodeEnum;
+    message: string;
+}
+
+/** `queryExecutionId` sale del count (lastTest de rewards). Estado RUNNING: el cliente reconsulta por `testId`. */
+export class PopulationTestResponse {
+    testId: string;
+    status: PopulationTestStatusEnum;
+    referenceAt: string;
+    definitionHash: string;
+    humanSummary: string;
+    sql: string;
+    params: SegmentParam[];
+    queryExecutionId?: string;
+    result?: PopulationTestResultResponse;
+    errors?: PopulationTestErrorResponse[];
+}