@fiado/type-kit 3.528.0 → 3.530.0

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

@@ -0,0 +1,24 @@
+import { EvaluationStatusEnum } from '../../../enums/EvaluationStatusEnum';
+import { RunStatusEnum } from '../../../enums/RunStatusEnum';
+import { TriggerTypeEnum } from '../../../enums/TriggerTypeEnum';
+
+export class SegmentUsedByEvaluation {
+    id: string;
+    name: string;
+    campaignId: string;
+    status: EvaluationStatusEnum;
+    triggers: TriggerTypeEnum[];
+}
+
+export class SegmentUsedByRun {
+    runId: string;
+    evaluationId: string;
+    segmentVersion: number;
+    status: RunStatusEnum;
+    createdAt: number;
+}
+
+export class SegmentUsedByResponse {
+    evaluations: SegmentUsedByEvaluation[];
+    runs: SegmentUsedByRun[];
+}

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

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

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

@@ -0,0 +1,5 @@
+import { SegmentVersionSummaryResponse } from './SegmentVersionSummaryResponse';
+
+export class SegmentVersionListResponse {
+    items: SegmentVersionSummaryResponse[];
+}

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

@@ -0,0 +1,25 @@
+import { SegmentStatusEnum } from '../../../enums/SegmentStatusEnum';
+import { PopulationSegmentDefinition } from './PopulationSegmentDefinition';
+import { SegmentLastTest } from './SegmentLastTest';
+import { SegmentParam } from './SegmentParam';
+import { SegmentUsedColumn } from './SegmentUsedColumn';
+
+export class SegmentVersionResponse {
+    segmentId: string;
+    version: number;
+    name: string;
+    description: string;
+    owner: string;
+    status: SegmentStatusEnum;
+    definition: PopulationSegmentDefinition;
+    definitionHash: string;
+    sql: string;
+    params: SegmentParam[];
+    usedColumns: SegmentUsedColumn[];
+    humanSummary: string;
+    lastTest?: SegmentLastTest;
+    createdBy: string;
+    createdAt: string;
+    updatedBy: string;
+    updatedAt: string;
+}

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

@@ -0,0 +1,13 @@
+import { SegmentStatusEnum } from '../../../enums/SegmentStatusEnum';
+import { SegmentLastTest } from './SegmentLastTest';
+
+/** Igual que SegmentVersionResponse sin definition/sql/params/usedColumns/humanSummary. */
+export class SegmentVersionSummaryResponse {
+    segmentId: string;
+    version: number;
+    status: SegmentStatusEnum;
+    lastTest?: SegmentLastTest;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/rewardsEligibility/dtos/backoffice/segments/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/rewardsEligibility/dtos/messages/EvaluateBatchMessage.ts

@@ -0,0 +1,42 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, Equals, IsArray, IsNotEmpty, IsString, Validate, ValidateNested } from 'class-validator';
+import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
+import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
+import { EligibilityMessageTypeEnum } from '../../enums/EligibilityMessageTypeEnum';
+
+/** Un sujeto del lote. No lleva hechos precargados: la evaluacion siempre es en vivo. */
+export class EvaluateBatchSubject {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    subjectKey: string;
+
+    @Expose()
+    @Validate(IsDynamicFormValues)
+    inputs: Record<string, DynamicFormValue>;
+}
+
+/** Lote de hasta 100 sujetos a evaluar en una corrida masiva. */
+export class EvaluateBatchMessage {
+    @Expose()
+    @Equals(EligibilityMessageTypeEnum.EVALUATE_BATCH)
+    messageType: EligibilityMessageTypeEnum.EVALUATE_BATCH;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    runId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    batchId: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(100)
+    @ValidateNested({ each: true })
+    @Type(() => EvaluateBatchSubject)
+    subjects: EvaluateBatchSubject[];
+}

package/src/rewardsEligibility/dtos/messages/GrantBatchMessage.ts

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { Equals, IsInt, IsNotEmpty, IsString, Min } from 'class-validator';
+import { EligibilityMessageTypeEnum } from '../../enums/EligibilityMessageTypeEnum';
+
+/** Publica las entregas (grants) de una parte de un lote de la corrida masiva. */
+export class GrantBatchMessage {
+    @Expose()
+    @Equals(EligibilityMessageTypeEnum.GRANT_BATCH)
+    messageType: EligibilityMessageTypeEnum.GRANT_BATCH;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    runId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    batchId: string;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    part: number;
+}

package/src/rewardsEligibility/dtos/messages/PopulationPageMessage.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { Equals, IsNotEmpty, IsString } from 'class-validator';
+import { EligibilityMessageTypeEnum } from '../../enums/EligibilityMessageTypeEnum';
+
+/** Pide la siguiente pagina de ids del segmento de una corrida masiva. */
+export class PopulationPageMessage {
+    @Expose()
+    @Equals(EligibilityMessageTypeEnum.POPULATION_PAGE)
+    messageType: EligibilityMessageTypeEnum.POPULATION_PAGE;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    runId: string;
+}

package/src/rewardsEligibility/dtos/messages/ReleaseTrancheMessage.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { Equals, IsInt, Min } from 'class-validator';
+import { EligibilityMessageTypeEnum } from '../../enums/EligibilityMessageTypeEnum';
+
+/** Libera el tramo `seq` de la publicacion por tramos (RELEASER). */
+export class ReleaseTrancheMessage {
+    @Expose()
+    @Equals(EligibilityMessageTypeEnum.RELEASE_TRANCHE)
+    messageType: EligibilityMessageTypeEnum.RELEASE_TRANCHE;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    seq: number;
+}

package/src/rewardsEligibility/enums/EligibilityMessageTypeEnum.ts

@@ -0,0 +1,7 @@
+// GRANT_FAILED sigue en RewardsMessageTypeEnum del dominio rewards.
+export enum EligibilityMessageTypeEnum {
+    POPULATION_PAGE = 'POPULATION_PAGE',
+    EVALUATE_BATCH = 'EVALUATE_BATCH',
+    GRANT_BATCH = 'GRANT_BATCH',
+    RELEASE_TRANCHE = 'RELEASE_TRANCHE',
+}

package/src/rewardsEligibility/enums/SegmentAggregateFnEnum.ts

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

package/src/rewardsEligibility/enums/SegmentConditionKindEnum.ts

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

package/src/rewardsEligibility/enums/SegmentErrorCodeEnum.ts

@@ -0,0 +1,16 @@
+export enum SegmentErrorCodeEnum {
+    SEGMENT_NOT_FOUND = 'SEGMENT_NOT_FOUND',
+    SEGMENT_INVALID = 'SEGMENT_INVALID',
+    SEGMENT_TEST_REQUIRED = 'SEGMENT_TEST_REQUIRED',
+    SEGMENT_IN_USE = 'SEGMENT_IN_USE',
+    SEGMENT_NOT_ACTIVE = 'SEGMENT_NOT_ACTIVE',
+    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_VERSION_CONFLICT = 'SEGMENT_VERSION_CONFLICT',
+    SEGMENT_STATUS_TRANSITION_INVALID = 'SEGMENT_STATUS_TRANSITION_INVALID',
+    SEGMENT_EXECUTION_NOT_FOUND = 'SEGMENT_EXECUTION_NOT_FOUND',
+}

package/src/rewardsEligibility/enums/SegmentMatchEnum.ts

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

package/src/rewardsEligibility/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/rewardsEligibility/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/rewardsEligibility/enums/SegmentParamTypeEnum.ts

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

package/src/rewardsEligibility/enums/SegmentStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum SegmentStatusEnum {
+    DRAFT = 'DRAFT',
+    ACTIVE = 'ACTIVE',
+    ARCHIVED = 'ARCHIVED',
+}

package/src/rewardsEligibility/enums/SegmentTestStatusEnum.ts

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

package/src/rewardsEligibility/index.ts

@@ -79,3 +79,50 @@ export * from './dtos/backoffice/MetricsPointResponse';
 export * from './dtos/backoffice/FailedConditionStatResponse';
 export * from './dtos/backoffice/FailedConditionEvaluationResponse';
 export * from './dtos/backoffice/MetricsQuery';
+
+//Segmentos de poblacion (adenda 2026-10-12)
+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';
+
+//Segmentos de poblacion: definicion del constructor (A2)
+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';
+
+//Segmentos de poblacion: request/response del backoffice (A3)
+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';
+
+//Segmentos de poblacion: mensajes SQS, endpoint privado y avance de corrida (A4)
+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';