@fiado/type-kit 3.508.0 → 3.510.0

package/src/rewards/validators/IsRewardInputs.ts

@@ -0,0 +1,18 @@
+import { ValidationArguments, ValidatorConstraint, ValidatorConstraintInterface } from 'class-validator';
+import { JsonValue } from '../../common/types/JsonValue';
+import { isDynamicFormValue, isPlainObject } from '../../dynamicForm/helpers/isDynamicFormValue';
+
+/** `inputs`: `itemKey → inputKey → valor` (dos niveles exactos; la hoja es un DynamicFormValue). */
+@ValidatorConstraint({ name: 'IsRewardInputs', async: false })
+export class IsRewardInputs implements ValidatorConstraintInterface {
+    validate(value: JsonValue, _args: ValidationArguments): boolean {
+        if (!isPlainObject(value)) return false;
+        return Object.values(value).every(
+            (porItem) => isPlainObject(porItem) && Object.values(porItem).every(isDynamicFormValue),
+        );
+    }
+
+    defaultMessage(_args: ValidationArguments): string {
+        return 'inputs debe ser un mapa itemKey → (inputKey → string | number | boolean | {from, to})';
+    }
+}

package/src/rewards/validators/IsRewardTags.ts

@@ -0,0 +1,18 @@
+import { ValidationArguments, ValidatorConstraint, ValidatorConstraintInterface } from 'class-validator';
+import { JsonValue } from '../../common/types/JsonValue';
+import { isPlainObject } from '../../dynamicForm/helpers/isDynamicFormValue';
+import { REWARD_TAGS_MAX_KEYS } from '../constants/RewardsLimits';
+
+/** `source.tags`: mapa texto → texto, máximo `REWARD_TAGS_MAX_KEYS` llaves. */
+@ValidatorConstraint({ name: 'IsRewardTags', async: false })
+export class IsRewardTags implements ValidatorConstraintInterface {
+    validate(value: JsonValue, _args: ValidationArguments): boolean {
+        if (!isPlainObject(value)) return false;
+        const entries = Object.entries(value);
+        return entries.length <= REWARD_TAGS_MAX_KEYS && entries.every(([, tag]) => typeof tag === 'string');
+    }
+
+    defaultMessage(_args: ValidationArguments): string {
+        return `tags debe ser un mapa texto → texto de máximo ${REWARD_TAGS_MAX_KEYS} llaves`;
+    }
+}

package/src/rewardsEligibility/dtos/EventRunResult.ts

@@ -0,0 +1,12 @@
+import { EvaluationOutcomeEnum } from '../enums/EvaluationOutcomeEnum';
+import { GrantRequestStatusEnum } from '../enums/GrantRequestStatusEnum';
+
+/** Resultado de una evaluación suscrita al evento (una corrida con lote de 1). */
+export class EventRunResult {
+    evaluationId: string;
+    runId: string;
+    outcome: EvaluationOutcomeEnum;
+    grantStatus: GrantRequestStatusEnum;
+    /** true si el `idempotencyKey` ya había creado esta corrida. */
+    idempotentReplay: boolean;
+}

package/src/rewardsEligibility/dtos/EventSource.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/** Quién emite el evento. El validador no interpreta `reference`. */
+export class EventSource {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    service!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    reference!: string;
+}

package/src/rewardsEligibility/dtos/GetRunResponse.ts

@@ -0,0 +1,23 @@
+import { RunModeEnum } from '../enums/RunModeEnum';
+import { RunStatusEnum } from '../enums/RunStatusEnum';
+import { TriggerTypeEnum } from '../enums/TriggerTypeEnum';
+import { RunCounts } from './RunCounts';
+import { RunResultItem } from './RunResultItem';
+
+/** Respuesta de `GET /runs/{id}` (spec B 6.2). */
+export class GetRunResponse {
+    runId: string;
+    evaluationId: string;
+    trigger: TriggerTypeEnum;
+    mode: RunModeEnum;
+    status: RunStatusEnum;
+    counts: RunCounts;
+    /** Una página de resultados. */
+    results: RunResultItem[];
+    /** Presente si hay más resultados. */
+    nextToken?: string;
+    /** Epoch en milisegundos. */
+    createdAt: number;
+    /** Epoch en milisegundos. */
+    updatedAt: number;
+}

package/src/rewardsEligibility/dtos/PostEventRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { IsNotEmpty, IsString, Validate, ValidateNested } from 'class-validator';
+import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
+import { IsDynamicFormValues } from '../../dynamicForm/validators/IsDynamicFormValues';
+import { EventSource } from './EventSource';
+
+/**
+ * Cuerpo de `POST /events` (spec B 6.1). El emisor informa qué pasó y quién participó; NO decide
+ * la elegibilidad (E3). Parsear con `excludeExtraneousValues: true`: cualquier campo extra
+ * (p. ej. `prefetchedFacts`) se descarta.
+ */
+export class PostEventRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    eventKey!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    idempotencyKey!: string;
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => EventSource)
+    source!: EventSource;
+
+    /** Los `fields` del tipo de evento (`RewardEventType_GT`), con su valor. */
+    @Expose()
+    @Validate(IsDynamicFormValues)
+    inputs!: Record<string, DynamicFormValue>;
+}

package/src/rewardsEligibility/dtos/PostEventResponse.ts

@@ -0,0 +1,6 @@
+import { EventRunResult } from './EventRunResult';
+
+/** Respuesta 202 de `POST /events`; `runs` vacío si ninguna evaluación escucha el evento. */
+export class PostEventResponse {
+    runs: EventRunResult[];
+}

package/src/rewardsEligibility/dtos/RunCounts.ts

@@ -0,0 +1,12 @@
+/** Conteos de una corrida (mismos nombres que las métricas, spec B 5.7). */
+export class RunCounts {
+    evaluated: number;
+    match: number;
+    noMatch: number;
+    error: number;
+    alreadyGranted: number;
+    quotaExhausted: number;
+    excluded: number;
+    requested: number;
+    requestFailed: number;
+}

package/src/rewardsEligibility/dtos/RunResultItem.ts

@@ -0,0 +1,17 @@
+import { EvaluationOutcomeEnum } from '../enums/EvaluationOutcomeEnum';
+import { GrantRequestStatusEnum } from '../enums/GrantRequestStatusEnum';
+
+/** Un resultado por sujeto, SIN traza (la traza es del backoffice). Asumido hasta cerrar P-7. */
+export class RunResultItem {
+    subjectKey: string;
+    beneficiaryDirectoryId: string;
+    campaignId: string;
+    evaluationId: string;
+    packageId: string;
+    outcome: EvaluationOutcomeEnum;
+    grantStatus: GrantRequestStatusEnum;
+    /** `grantIdFor("rewards-eligibility", idempotencyKey)`; cruza con `GET /grants/{id}` de rewards. */
+    grantId?: string;
+    /** Solo si `outcome` es ERROR. */
+    errorMessage?: string;
+}

package/src/rewardsEligibility/enums/EvaluationOutcomeEnum.ts

@@ -0,0 +1,11 @@
+export enum EvaluationOutcomeEnum {
+    MATCH = 'MATCH',
+    NO_MATCH = 'NO_MATCH',
+    ERROR = 'ERROR',
+    /** La política de frecuencia lo bloqueó. */
+    ALREADY_GRANTED = 'ALREADY_GRANTED',
+    /** Calificó, pero la campaña no tenía cupo. */
+    QUOTA_EXHAUSTED = 'QUOTA_EXHAUSTED',
+    /** El operador lo sacó al aprobar. */
+    EXCLUDED = 'EXCLUDED',
+}

package/src/rewardsEligibility/enums/GrantRequestStatusEnum.ts

@@ -0,0 +1,11 @@
+export enum GrantRequestStatusEnum {
+    NOT_APPLICABLE = 'NOT_APPLICABLE',
+    PENDING_APPROVAL = 'PENDING_APPROVAL',
+    /** Reservado, esperando su tramo de publicación. */
+    QUEUED = 'QUEUED',
+    /** Publicado en RewardsGrantQueue al instante (en línea). */
+    REQUESTED = 'REQUESTED',
+    /** La publicación falló o llegó GRANT_FAILED. */
+    REQUEST_FAILED = 'REQUEST_FAILED',
+    CANCELLED = 'CANCELLED',
+}

package/src/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum.ts

@@ -0,0 +1,8 @@
+export enum RewardsEligibilityErrorCodeEnum {
+    /** 400: faltan campos obligatorios del evento o tienen tipo inválido. */
+    INPUT_INVALID = 'INPUT_INVALID',
+    /** 404: el eventKey no existe o está inactivo. */
+    EVENT_TYPE_NOT_FOUND = 'EVENT_TYPE_NOT_FOUND',
+    /** 404: GET /runs/{id} sin corrida. */
+    RUN_NOT_FOUND = 'RUN_NOT_FOUND',
+}

package/src/rewardsEligibility/enums/RunModeEnum.ts

@@ -0,0 +1,4 @@
+export enum RunModeEnum {
+    LIVE = 'LIVE',
+    SIMULATION = 'SIMULATION',
+}

package/src/rewardsEligibility/enums/RunStatusEnum.ts

@@ -0,0 +1,9 @@
+export enum RunStatusEnum {
+    RUNNING = 'RUNNING',
+    AWAITING_APPROVAL = 'AWAITING_APPROVAL',
+    PUBLISHING = 'PUBLISHING',
+    COMPLETED = 'COMPLETED',
+    PARTIAL = 'PARTIAL',
+    FAILED = 'FAILED',
+    REJECTED = 'REJECTED',
+}

package/src/rewardsEligibility/enums/TriggerTypeEnum.ts

@@ -0,0 +1,5 @@
+export enum TriggerTypeEnum {
+    EVENT = 'EVENT',
+    MANUAL = 'MANUAL',
+    CRON = 'CRON',
+}

package/src/rewardsEligibility/index.ts

@@ -0,0 +1,16 @@
+//Enums
+export * from './enums/EvaluationOutcomeEnum';
+export * from './enums/GrantRequestStatusEnum';
+export * from './enums/RunStatusEnum';
+export * from './enums/RunModeEnum';
+export * from './enums/TriggerTypeEnum';
+export * from './enums/RewardsEligibilityErrorCodeEnum';
+
+//DTOs
+export * from './dtos/EventSource';
+export * from './dtos/PostEventRequest';
+export * from './dtos/EventRunResult';
+export * from './dtos/PostEventResponse';
+export * from './dtos/RunCounts';
+export * from './dtos/RunResultItem';
+export * from './dtos/GetRunResponse';