@fiado/type-kit 3.539.0 → 3.541.0

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

@@ -0,0 +1,5 @@
+export class SegmentUsedColumn {
+    table: string;
+    column: string;
+    type: string;
+}

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

@@ -0,0 +1,9 @@
+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;
+}

package/src/rules/enums/PopulationErrorCodeEnum.ts

@@ -0,0 +1,12 @@
+/** Codigos de error del canal de poblacion. Los 8 primeros coinciden con SegmentErrorCodeEnum. */
+export enum PopulationErrorCodeEnum {
+    SEGMENT_INVALID = 'SEGMENT_INVALID',
+    SEGMENT_BLOCKED_COLUMN = 'SEGMENT_BLOCKED_COLUMN',
+    SEGMENT_SCHEMA_DRIFT = 'SEGMENT_SCHEMA_DRIFT',
+    SEGMENT_BYTES_EXCEEDED = 'SEGMENT_BYTES_EXCEEDED',
+    SEGMENT_QUERY_FAILED = 'SEGMENT_QUERY_FAILED',
+    SEGMENT_DATALAKE_UNAVAILABLE = 'SEGMENT_DATALAKE_UNAVAILABLE',
+    SEGMENT_DATALAKE_UNAVAILABLE_IN_ENV = 'SEGMENT_DATALAKE_UNAVAILABLE_IN_ENV',
+    SEGMENT_EXECUTION_NOT_FOUND = 'SEGMENT_EXECUTION_NOT_FOUND',
+    SEGMENT_NEXT_TOKEN_EXPIRED = 'SEGMENT_NEXT_TOKEN_EXPIRED',
+}

package/src/rules/enums/PopulationExecutionStatusEnum.ts

@@ -0,0 +1,6 @@
+export enum PopulationExecutionStatusEnum {
+    RUNNING = 'RUNNING',
+    SUCCEEDED = 'SUCCEEDED',
+    FAILED = 'FAILED',
+    CANCELLED = 'CANCELLED',
+}

package/src/rules/enums/PopulationTestStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum PopulationTestStatusEnum {
+    RUNNING = 'RUNNING',
+    PASSED = 'PASSED',
+    FAILED = 'FAILED',
+}

package/src/rules/enums/SegmentAggregateFnEnum.ts

@@ -0,0 +1,5 @@
+export enum SegmentAggregateFnEnum {
+    EXISTS = 'EXISTS',
+    COUNT = 'COUNT',
+    SUM = 'SUM',
+}

package/src/rules/enums/SegmentConditionKindEnum.ts

@@ -0,0 +1,4 @@
+export enum SegmentConditionKindEnum {
+    COLUMN = 'COLUMN',
+    AGGREGATE = 'AGGREGATE',
+}

package/src/rules/enums/SegmentMatchEnum.ts

@@ -0,0 +1,4 @@
+export enum SegmentMatchEnum {
+    ALL = 'ALL',
+    ANY = 'ANY',
+}

package/src/rules/enums/SegmentOperatorEnum.ts

@@ -0,0 +1,16 @@
+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',
+}

package/src/rules/enums/SegmentParamSourceEnum.ts

@@ -0,0 +1,5 @@
+export enum SegmentParamSourceEnum {
+    LITERAL = 'LITERAL',
+    REFERENCE_AT = 'REFERENCE_AT',
+    REFERENCE_AT_MINUS_DAYS = 'REFERENCE_AT_MINUS_DAYS',
+}

package/src/rules/enums/SegmentParamTypeEnum.ts

@@ -0,0 +1,7 @@
+export enum SegmentParamTypeEnum {
+    STRING = 'STRING',
+    INTEGER = 'INTEGER',
+    DECIMAL = 'DECIMAL',
+    BOOLEAN = 'BOOLEAN',
+    TIMESTAMP = 'TIMESTAMP',
+}

package/src/rules/index.ts

@@ -18,3 +18,33 @@ export * from './dtos/GenerateRulesResponse';
 export * from './dtos/RulesTraceResponse';
 export * from './dtos/EvaluateRulesRequest';
 export * from './dtos/EvaluateRulesResponse';
+
+//Poblacion (movido desde rewardsEligibility; alli queda re-export)
+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 './constants/SegmentLimits';
+export * from './dtos/population/SegmentWindow';
+export * from './dtos/population/SegmentColumnCondition';
+export * from './dtos/population/SegmentAggregateCondition';
+export * from './dtos/population/SegmentGroup';
+export * from './dtos/population/PopulationSegmentDefinition';
+export * from './dtos/population/SegmentParam';
+export * from './dtos/population/SegmentUsedColumn';
+export * from './dtos/population/SegmentSchemaResponse';
+export * from './dtos/population/SegmentTableSchemaResponse';
+
+//Poblacion: endpoints del canal /population/*
+export * from './enums/PopulationErrorCodeEnum';
+export * from './enums/PopulationTestStatusEnum';
+export * from './enums/PopulationExecutionStatusEnum';
+export * from './dtos/population/PopulationCompileRequest';
+export * from './dtos/population/PopulationCompileResponse';
+export * from './dtos/population/PopulationTestRequest';
+export * from './dtos/population/PopulationTestResponse';
+export * from './dtos/population/PopulationExecutionRequest';
+export * from './dtos/population/PopulationExecutionResponse';
+export * from './dtos/population/PopulationExecutionPageResponse';