@fiado/type-kit 3.516.0 → 3.518.0

package/bin/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum.js

@@ -9,4 +9,60 @@ var RewardsEligibilityErrorCodeEnum;
     RewardsEligibilityErrorCodeEnum["EVENT_TYPE_NOT_FOUND"] = "EVENT_TYPE_NOT_FOUND";
     /** 404: GET /runs/{id} sin corrida. */
     RewardsEligibilityErrorCodeEnum["RUN_NOT_FOUND"] = "RUN_NOT_FOUND";
+    // ── Backoffice (fase 3) ──
+    /** 400: el cuerpo no cumple el DTO (solo nombres de propiedad, nunca valores). */
+    RewardsEligibilityErrorCodeEnum["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    /** 400: `limit` fuera de rango o `cursor` que no devolvió esta API. */
+    RewardsEligibilityErrorCodeEnum["INVALID_PAGE"] = "INVALID_PAGE";
+    /** 400: un filtro de query (`outcome`, `status`, `dimension`, fechas…) no es válido. */
+    RewardsEligibilityErrorCodeEnum["INVALID_FILTER"] = "INVALID_FILTER";
+    /** 503: el índice de listado aún no existe en la tabla (pendiente de infraestructura). */
+    RewardsEligibilityErrorCodeEnum["LIST_INDEX_NOT_AVAILABLE"] = "LIST_INDEX_NOT_AVAILABLE";
+    /** 409: otra persona editó la misma fila. */
+    RewardsEligibilityErrorCodeEnum["VERSION_CONFLICT"] = "VERSION_CONFLICT";
+    /** 400: el id de la ruta no coincide con el del cuerpo. */
+    RewardsEligibilityErrorCodeEnum["REQUEST_ID_MISMATCH"] = "REQUEST_ID_MISMATCH";
+    /** 409: la transición de estado no está permitida. */
+    RewardsEligibilityErrorCodeEnum["INVALID_STATUS_TRANSITION"] = "INVALID_STATUS_TRANSITION";
+    RewardsEligibilityErrorCodeEnum["CAMPAIGN_NOT_FOUND"] = "CAMPAIGN_NOT_FOUND";
+    RewardsEligibilityErrorCodeEnum["CAMPAIGN_ALREADY_EXISTS"] = "CAMPAIGN_ALREADY_EXISTS";
+    RewardsEligibilityErrorCodeEnum["CAMPAIGN_INVALID"] = "CAMPAIGN_INVALID";
+    RewardsEligibilityErrorCodeEnum["EVALUATION_NOT_FOUND"] = "EVALUATION_NOT_FOUND";
+    RewardsEligibilityErrorCodeEnum["EVALUATION_ALREADY_EXISTS"] = "EVALUATION_ALREADY_EXISTS";
+    /** 400: la evaluación no pasa las validaciones del spec 5.1 (lista TODOS los problemas). */
+    RewardsEligibilityErrorCodeEnum["EVALUATION_INVALID"] = "EVALUATION_INVALID";
+    /** 409: la evaluación o su campaña no están en condiciones de correr (estado o vigencia). */
+    RewardsEligibilityErrorCodeEnum["EVALUATION_NOT_RUNNABLE"] = "EVALUATION_NOT_RUNNABLE";
+    RewardsEligibilityErrorCodeEnum["EVENT_TYPE_ALREADY_EXISTS"] = "EVENT_TYPE_ALREADY_EXISTS";
+    RewardsEligibilityErrorCodeEnum["EVENT_TYPE_INVALID"] = "EVENT_TYPE_INVALID";
+    /** 409: el tipo de evento lo escuchan evaluaciones ACTIVAS. */
+    RewardsEligibilityErrorCodeEnum["EVENT_TYPE_IN_USE"] = "EVENT_TYPE_IN_USE";
+    RewardsEligibilityErrorCodeEnum["PACKAGE_NOT_FOUND"] = "PACKAGE_NOT_FOUND";
+    /** 503: rewards-business no respondió al consultar un paquete. */
+    RewardsEligibilityErrorCodeEnum["PACKAGE_LOOKUP_UNAVAILABLE"] = "PACKAGE_LOOKUP_UNAVAILABLE";
+    /** 400: la evaluación no tiene disparador MANUAL. */
+    RewardsEligibilityErrorCodeEnum["MANUAL_TRIGGER_MISSING"] = "MANUAL_TRIGGER_MISSING";
+    /** 400: la corrida manual por población llega con la fase 4 (cron masivo). */
+    RewardsEligibilityErrorCodeEnum["POPULATION_RUN_NOT_SUPPORTED"] = "POPULATION_RUN_NOT_SUPPORTED";
+    /** 409: la corrida no está esperando aprobación. */
+    RewardsEligibilityErrorCodeEnum["RUN_NOT_AWAITING_APPROVAL"] = "RUN_NOT_AWAITING_APPROVAL";
+    /** 409: la corrida tiene más de un registro de reserva (aprobación masiva = fase 4). */
+    RewardsEligibilityErrorCodeEnum["APPROVAL_RUN_TOO_LARGE"] = "APPROVAL_RUN_TOO_LARGE";
+    RewardsEligibilityErrorCodeEnum["RESULT_NOT_FOUND"] = "RESULT_NOT_FOUND";
+    /** 409: solo se reintenta un sujeto en ERROR o REQUEST_FAILED de una corrida LIVE cerrada. */
+    RewardsEligibilityErrorCodeEnum["RESULT_NOT_RETRYABLE"] = "RESULT_NOT_RETRYABLE";
+    /** 400: el rango pedido excede el tope de filas de la exportación. */
+    RewardsEligibilityErrorCodeEnum["EXPORT_TOO_LARGE"] = "EXPORT_TOO_LARGE";
+    /** 503: la tabla de métricas no responde o no existe aún. */
+    RewardsEligibilityErrorCodeEnum["METRICS_UNAVAILABLE"] = "METRICS_UNAVAILABLE";
+    /** 400: `POST /rules/generate` sin ningún turno de chat. */
+    RewardsEligibilityErrorCodeEnum["AI_CHAT_HISTORY_EMPTY"] = "AI_CHAT_HISTORY_EMPTY";
+    /** 400: el chat tiene más de 10 turnos (se acota el prompt). */
+    RewardsEligibilityErrorCodeEnum["AI_CHAT_HISTORY_TOO_LONG"] = "AI_CHAT_HISTORY_TOO_LONG";
+    /** 503: el motor de IA no respondió o falló. Reintentar. */
+    RewardsEligibilityErrorCodeEnum["AI_GENERATION_FAILED"] = "AI_GENERATION_FAILED";
+    /** 503: la IA respondió algo que no se pudo leer como `{ explanation, rules }`. Reintentar. */
+    RewardsEligibilityErrorCodeEnum["AI_RESPONSE_UNPARSEABLE"] = "AI_RESPONSE_UNPARSEABLE";
+    /** 503: la IA no contestó dentro del presupuesto de tiempo (el gateway corta a los 29 s). Reintentar. */
+    RewardsEligibilityErrorCodeEnum["AI_GENERATION_TIMEOUT"] = "AI_GENERATION_TIMEOUT";
 })(RewardsEligibilityErrorCodeEnum || (exports.RewardsEligibilityErrorCodeEnum = RewardsEligibilityErrorCodeEnum = {}));

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

@@ -0,0 +1,9 @@
+/** Tipo de valor de un campo del catálogo de reglas (`GET /rule-catalog`). */
+export declare enum RuleValueTypeEnum {
+    NUMBER = "NUMBER",
+    STRING = "STRING",
+    BOOLEAN = "BOOLEAN",
+    DATE = "DATE",
+    /** Lista de textos (ej. `directory.scope`). */
+    STRING_LIST = "STRING_LIST"
+}

package/bin/rewardsEligibility/enums/RuleValueTypeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuleValueTypeEnum = void 0;
+/** Tipo de valor de un campo del catálogo de reglas (`GET /rule-catalog`). */
+var RuleValueTypeEnum;
+(function (RuleValueTypeEnum) {
+    RuleValueTypeEnum["NUMBER"] = "NUMBER";
+    RuleValueTypeEnum["STRING"] = "STRING";
+    RuleValueTypeEnum["BOOLEAN"] = "BOOLEAN";
+    RuleValueTypeEnum["DATE"] = "DATE";
+    /** Lista de textos (ej. `directory.scope`). */
+    RuleValueTypeEnum["STRING_LIST"] = "STRING_LIST";
+})(RuleValueTypeEnum || (exports.RuleValueTypeEnum = RuleValueTypeEnum = {}));

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

@@ -0,0 +1,5 @@
+/** Quién habló en un turno del chat que genera reglas con IA (`POST /rules/generate`). */
+export declare enum RulesChatRoleEnum {
+    USER = "user",
+    ASSISTANT = "assistant"
+}

package/bin/rewardsEligibility/enums/RulesChatRoleEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesChatRoleEnum = void 0;
+/** Quién habló en un turno del chat que genera reglas con IA (`POST /rules/generate`). */
+var RulesChatRoleEnum;
+(function (RulesChatRoleEnum) {
+    RulesChatRoleEnum["USER"] = "user";
+    RulesChatRoleEnum["ASSISTANT"] = "assistant";
+})(RulesChatRoleEnum || (exports.RulesChatRoleEnum = RulesChatRoleEnum = {}));

package/bin/rewardsEligibility/index.d.ts

@@ -29,3 +29,41 @@ export * from './dtos/CampaignAlerts';
 export * from './dtos/PopulationRef';
 export * from './dtos/EvaluationReward';
 export * from './dtos/EvaluationTrigger';
+export * from './enums/MetricsDimensionEnum';
+export * from './enums/RuleValueTypeEnum';
+export * from './enums/RulesChatRoleEnum';
+export * from './constants/BackofficeLimits';
+export * from './dtos/backoffice/CampaignRequest';
+export * from './dtos/backoffice/CampaignStatusRequest';
+export * from './dtos/backoffice/CampaignResponse';
+export * from './dtos/backoffice/CampaignListResponse';
+export * from './dtos/backoffice/QuotaUsageResponse';
+export * from './dtos/backoffice/CampaignSummaryResponse';
+export * from './dtos/backoffice/EventTypeRequest';
+export * from './dtos/backoffice/EventTypeResponse';
+export * from './dtos/backoffice/EventTypeListResponse';
+export * from './dtos/backoffice/EvaluationRequest';
+export * from './dtos/backoffice/EvaluationStatusRequest';
+export * from './dtos/backoffice/EvaluationResponse';
+export * from './dtos/backoffice/EvaluationListResponse';
+export * from './dtos/backoffice/ResultTraceResponse';
+export * from './dtos/backoffice/SimulateRequest';
+export * from './dtos/backoffice/SimulateResponse';
+export * from './dtos/backoffice/RuleCatalogResponse';
+export * from './dtos/backoffice/PopulationSourceResponse';
+export * from './dtos/backoffice/InputTypeResponse';
+export * from './dtos/backoffice/RulesChatTurn';
+export * from './dtos/backoffice/GenerateRulesRequest';
+export * from './dtos/backoffice/GenerateRulesResponse';
+export * from './dtos/backoffice/CreateRunRequest';
+export * from './dtos/backoffice/PopulationRunRequest';
+export * from './dtos/backoffice/ApproveRunRequest';
+export * from './dtos/backoffice/QuotaImpactResponse';
+export * from './dtos/backoffice/RunResponse';
+export * from './dtos/backoffice/RunListResponse';
+export * from './dtos/backoffice/RunResultResponse';
+export * from './dtos/backoffice/RunResultListResponse';
+export * from './dtos/backoffice/CreateRunResponse';
+export * from './dtos/backoffice/MetricsPointResponse';
+export * from './dtos/backoffice/FailedConditionStatResponse';
+export * from './dtos/backoffice/MetricsQuery';

package/bin/rewardsEligibility/index.js

@@ -50,3 +50,42 @@ __exportStar(require("./dtos/CampaignAlerts"), exports);
 __exportStar(require("./dtos/PopulationRef"), exports);
 __exportStar(require("./dtos/EvaluationReward"), exports);
 __exportStar(require("./dtos/EvaluationTrigger"), exports);
+//Backoffice (fase 3): enums, constantes y DTOs
+__exportStar(require("./enums/MetricsDimensionEnum"), exports);
+__exportStar(require("./enums/RuleValueTypeEnum"), exports);
+__exportStar(require("./enums/RulesChatRoleEnum"), exports);
+__exportStar(require("./constants/BackofficeLimits"), exports);
+__exportStar(require("./dtos/backoffice/CampaignRequest"), exports);
+__exportStar(require("./dtos/backoffice/CampaignStatusRequest"), exports);
+__exportStar(require("./dtos/backoffice/CampaignResponse"), exports);
+__exportStar(require("./dtos/backoffice/CampaignListResponse"), exports);
+__exportStar(require("./dtos/backoffice/QuotaUsageResponse"), exports);
+__exportStar(require("./dtos/backoffice/CampaignSummaryResponse"), exports);
+__exportStar(require("./dtos/backoffice/EventTypeRequest"), exports);
+__exportStar(require("./dtos/backoffice/EventTypeResponse"), exports);
+__exportStar(require("./dtos/backoffice/EventTypeListResponse"), exports);
+__exportStar(require("./dtos/backoffice/EvaluationRequest"), exports);
+__exportStar(require("./dtos/backoffice/EvaluationStatusRequest"), exports);
+__exportStar(require("./dtos/backoffice/EvaluationResponse"), exports);
+__exportStar(require("./dtos/backoffice/EvaluationListResponse"), exports);
+__exportStar(require("./dtos/backoffice/ResultTraceResponse"), exports);
+__exportStar(require("./dtos/backoffice/SimulateRequest"), exports);
+__exportStar(require("./dtos/backoffice/SimulateResponse"), exports);
+__exportStar(require("./dtos/backoffice/RuleCatalogResponse"), exports);
+__exportStar(require("./dtos/backoffice/PopulationSourceResponse"), exports);
+__exportStar(require("./dtos/backoffice/InputTypeResponse"), exports);
+__exportStar(require("./dtos/backoffice/RulesChatTurn"), exports);
+__exportStar(require("./dtos/backoffice/GenerateRulesRequest"), exports);
+__exportStar(require("./dtos/backoffice/GenerateRulesResponse"), exports);
+__exportStar(require("./dtos/backoffice/CreateRunRequest"), exports);
+__exportStar(require("./dtos/backoffice/PopulationRunRequest"), exports);
+__exportStar(require("./dtos/backoffice/ApproveRunRequest"), exports);
+__exportStar(require("./dtos/backoffice/QuotaImpactResponse"), exports);
+__exportStar(require("./dtos/backoffice/RunResponse"), exports);
+__exportStar(require("./dtos/backoffice/RunListResponse"), exports);
+__exportStar(require("./dtos/backoffice/RunResultResponse"), exports);
+__exportStar(require("./dtos/backoffice/RunResultListResponse"), exports);
+__exportStar(require("./dtos/backoffice/CreateRunResponse"), exports);
+__exportStar(require("./dtos/backoffice/MetricsPointResponse"), exports);
+__exportStar(require("./dtos/backoffice/FailedConditionStatResponse"), exports);
+__exportStar(require("./dtos/backoffice/MetricsQuery"), exports);

package/package.json

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

package/src/rewardsEligibility/constants/BackofficeLimits.ts

@@ -0,0 +1,16 @@
+/** Id de campaña, evaluación (minúsculas, dígitos y guion; 2 a 64; sin `#` ni `:` porque entran en llaves compuestas y en la idempotencyKey). */
+export const ELIGIBILITY_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/;
+/** `eventKey` de un tipo de evento: MAYÚSCULAS con guion bajo (ej. `PHONE_SALES_CODE_REDEEMED`). */
+export const EVENT_KEY_PATTERN = /^[A-Z][A-Z0-9_]{2,63}$/;
+/** Fecha de vigencia de una campaña (UTC, inclusiva). */
+export const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/** Id de solicitud que genera el backoffice al abrir el formulario de una corrida manual (llave de idempotencia). */
+export const REQUEST_ID_PATTERN = /^[A-Za-z0-9_-]{8,64}$/;
+/** Cupos por campaña que caben junto a las reservas de una transacción (100 − 90 − registro del lote). */
+export const MAX_QUOTAS_PER_CAMPAIGN = 9;
+/** Tope de `limit` de los listados paginados. */
+export const LIST_PAGE_MAX = 100;
+/** Largo máximo del texto de un turno del chat que genera reglas. */
+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;

package/src/rewardsEligibility/dtos/CampaignAlerts.ts

@@ -1,4 +1,13 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsNumber, Max, Min } from 'class-validator';
+
 /** Umbrales de consumo (0 a 1) que avisan a los operadores (spec B 5.6). */
 export class CampaignAlerts {
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(5)
+    @IsNumber({}, { each: true })
+    @Min(0.01, { each: true })
+    @Max(1, { each: true })
     thresholds: number[];
 }

package/src/rewardsEligibility/dtos/CampaignQuota.ts

@@ -1,9 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsString, Matches, Min } from 'class-validator';
 import { QuotaPeriodEnum } from '../enums/QuotaPeriodEnum';
 
 /** Un cupo de campania: cantidad maxima de premios (no dinero) en un periodo (spec B 5.6). */
 export class CampaignQuota {
-    /** Unico dentro de la campania (ej. `primeros-500`). Entra en la llave del consumo (`{id}#{periodo}`). */
+    /** Unico dentro de la campania (ej. `primeros-500`). Entra en la llave del consumo (`{id}#{periodo}`): sin `#`. */
+    @Expose()
+    @IsString()
+    @Matches(/^[a-z0-9][a-z0-9-]{0,62}$/)
     id: string;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
     limit: number;
+
+    @Expose()
+    @IsEnum(QuotaPeriodEnum)
     period: QuotaPeriodEnum;
 }

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

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsOptional, IsString, Matches } from 'class-validator';
+
+/** `POST /runs/{id}/approve`: aprueba todo salvo los sujetos excluidos (`subjectKey`). */
+export class ApproveRunRequest {
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(1000)
+    @IsString({ each: true })
+    @Matches(/^[A-Za-z0-9_-]{8,128}$/, { each: true })
+    excludeSubjectKeys?: string[];
+}

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

@@ -0,0 +1,7 @@
+import { CampaignResponse } from './CampaignResponse';
+
+export class CampaignListResponse {
+    items: CampaignResponse[];
+    /** Cursor opaco de la página siguiente; ausente en la última. */
+    nextCursor?: string;
+}

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

@@ -0,0 +1,53 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsDefined, IsEnum, IsNotEmpty, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+import { DATE_PATTERN, ELIGIBILITY_ID_PATTERN, MAX_QUOTAS_PER_CAMPAIGN } from '../../constants/BackofficeLimits';
+import { QuotaExhaustedActionEnum } from '../../enums/QuotaExhaustedActionEnum';
+import { CampaignAlerts } from '../CampaignAlerts';
+import { CampaignQuota } from '../CampaignQuota';
+
+/** Crear (POST) o reemplazar (PUT) una campaña. `status`, `pausedReason` y las fechas de auditoría las pone el servidor (el estado cambia con `POST /campaigns/{id}/status`). */
+export class CampaignRequest {
+    @Expose()
+    @IsString()
+    @Matches(ELIGIBILITY_ID_PATTERN)
+    id: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    name: string;
+
+    /** Qué se quiere lograr (texto libre). */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(500)
+    objective: string;
+
+    /** `AAAA-MM-DD` (UTC, inclusiva). */
+    @Expose()
+    @Matches(DATE_PATTERN)
+    startsAt: string;
+
+    @Expose()
+    @Matches(DATE_PATTERN)
+    endsAt: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(MAX_QUOTAS_PER_CAMPAIGN)
+    @ValidateNested({ each: true })
+    @Type(() => CampaignQuota)
+    quotas: CampaignQuota[];
+
+    @Expose()
+    @IsEnum(QuotaExhaustedActionEnum)
+    onExhausted: QuotaExhaustedActionEnum;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => CampaignAlerts)
+    alerts: CampaignAlerts;
+}

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

@@ -0,0 +1,24 @@
+import { CampaignPausedReasonEnum } from '../../enums/CampaignPausedReasonEnum';
+import { CampaignStatusEnum } from '../../enums/CampaignStatusEnum';
+import { QuotaExhaustedActionEnum } from '../../enums/QuotaExhaustedActionEnum';
+import { CampaignAlerts } from '../CampaignAlerts';
+import { CampaignQuota } from '../CampaignQuota';
+
+/** Una campaña (spec B 5.6). */
+export class CampaignResponse {
+    id: string;
+    name: string;
+    objective: string;
+    status: CampaignStatusEnum;
+    /** Solo si `status` es `PAUSED`. */
+    pausedReason?: CampaignPausedReasonEnum;
+    startsAt: string;
+    endsAt: string;
+    quotas: CampaignQuota[];
+    onExhausted: QuotaExhaustedActionEnum;
+    alerts: CampaignAlerts;
+    /** Epoch en milisegundos. */
+    createdAt: number;
+    updatedAt: number;
+    updatedBy: string;
+}

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

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { CampaignStatusEnum } from '../../enums/CampaignStatusEnum';
+
+/** Cuerpo de `POST /campaigns/{id}/status`: activar, pausar, terminar o archivar. */
+export class CampaignStatusRequest {
+    @Expose()
+    @IsEnum(CampaignStatusEnum)
+    status: CampaignStatusEnum;
+}

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

@@ -0,0 +1,26 @@
+import { CampaignPausedReasonEnum } from '../../enums/CampaignPausedReasonEnum';
+import { CampaignStatusEnum } from '../../enums/CampaignStatusEnum';
+
+/** Fila de la tabla ejecutiva `GET /campaigns/summary` (spec 10.1). */
+export class CampaignSummaryResponse {
+    campaignId: string;
+    name: string;
+    status: CampaignStatusEnum;
+    pausedReason?: CampaignPausedReasonEnum;
+    startsAt: string;
+    endsAt: string;
+    evaluated: number;
+    matched: number;
+    requested: number;
+    quotaExhausted: number;
+    /** Cupo más restrictivo, de 0 a 1 (0 si la campaña no tiene cupos). */
+    quotaUsed: number;
+    /** Ritmo diario de pedidos de los últimos 7 días (para proyectar el agotamiento). */
+    dailyRate: number;
+    /** `AAAA-MM-DD` estimada en que se agota el cupo más restrictivo al ritmo actual; ausente si no aplica. */
+    projectedExhaustionDate?: string;
+    /** Valor entregado: lo calcula rewards por `campaignId`; este lambda no lo informa. */
+    value?: { amount: number; currency: string }[];
+    /** Entregados de verdad según rewards; este lambda no lo informa. */
+    granted?: number;
+}

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

@@ -0,0 +1,30 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsOptional, Matches, Validate, ValidateNested } from 'class-validator';
+import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
+import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
+import { REQUEST_ID_PATTERN } from '../../constants/BackofficeLimits';
+import { RunModeEnum } from '../../enums/RunModeEnum';
+import { PopulationRunRequest } from './PopulationRunRequest';
+
+/** `POST /evaluations/{id}/runs` (spec 10): una corrida manual de UN sujeto (`inputs`) o de una población (`population`, fase 4). */
+export class CreateRunRequest {
+    /** Id de solicitud que genera el backoffice al abrir el formulario: es la llave de idempotencia (doble clic = misma corrida). */
+    @Expose()
+    @Matches(REQUEST_ID_PATTERN)
+    requestId: string;
+
+    @Expose()
+    @IsEnum(RunModeEnum)
+    mode: RunModeEnum;
+
+    @Expose()
+    @IsOptional()
+    @Validate(IsDynamicFormValues)
+    inputs?: Record<string, DynamicFormValue>;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PopulationRunRequest)
+    population?: PopulationRunRequest;
+}

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

@@ -0,0 +1,10 @@
+import { RunResponse } from './RunResponse';
+import { RunResultResponse } from './RunResultResponse';
+
+/** Respuesta de `POST /evaluations/{id}/runs`: la corrida y, si es de un sujeto, su resultado con traza (spec 7.3). */
+export class CreateRunResponse {
+    run: RunResponse;
+    result?: RunResultResponse;
+    /** `true` si el `requestId` ya existía: es la MISMA corrida de antes. */
+    idempotentReplay: boolean;
+}

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

@@ -0,0 +1,6 @@
+import { EvaluationResponse } from './EvaluationResponse';
+
+export class EvaluationListResponse {
+    items: EvaluationResponse[];
+    nextCursor?: string;
+}

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

@@ -0,0 +1,69 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsObject, IsString, Matches, MaxLength } from 'class-validator';
+import { JsonValue } from '../../../common';
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { ELIGIBILITY_ID_PATTERN } from '../../constants/BackofficeLimits';
+import { EvaluationReward } from '../EvaluationReward';
+import { EvaluationTrigger } from '../EvaluationTrigger';
+import { GrantPolicy } from '../GrantPolicy';
+
+/**
+ * Crear (POST) o reemplazar (PUT) una evaluación (spec 5.1). `status`, `version` y auditoría los pone el servidor.
+ * Aquí solo se valida la FORMA gruesa; las reglas del spec 5.1 (llaves únicas, `validateRule`, paquete ACTIVO, disparadores…)
+ * las valida el lambda, que devuelve TODOS los problemas juntos.
+ */
+export class EvaluationRequest {
+    @Expose()
+    @IsString()
+    @Matches(ELIGIBILITY_ID_PATTERN)
+    id: string;
+
+    @Expose()
+    @IsString()
+    @Matches(ELIGIBILITY_ID_PATTERN)
+    campaignId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(160)
+    name: string;
+
+    @Expose()
+    @IsString()
+    @MaxLength(500)
+    description: string;
+
+    /** Contrato de entrada (`InputField[]`, dominio `dynamicForm`). */
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(30)
+    @IsObject({ each: true })
+    inputs: InputField[];
+
+    /** Reglas de `@fiado/rules-engine` (`{ match, groups[] }`). */
+    @Expose()
+    @IsObject()
+    rules: { [key: string]: JsonValue };
+
+    /** Llave del input `DIRECTORY` al que se le entrega el premio. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    beneficiaryInput: string;
+
+    @Expose()
+    @IsObject()
+    reward: EvaluationReward;
+
+    @Expose()
+    @IsObject()
+    grantPolicy: GrantPolicy;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(10)
+    @IsObject({ each: true })
+    triggers: EvaluationTrigger[];
+}

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

@@ -0,0 +1,25 @@
+import { JsonValue } from '../../../common';
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { EvaluationStatusEnum } from '../../enums/EvaluationStatusEnum';
+import { EvaluationReward } from '../EvaluationReward';
+import { EvaluationTrigger } from '../EvaluationTrigger';
+import { GrantPolicy } from '../GrantPolicy';
+
+export class EvaluationResponse {
+    id: string;
+    campaignId: string;
+    name: string;
+    description: string;
+    status: EvaluationStatusEnum;
+    /** Sube con cada edición de una evaluación `ACTIVE`. */
+    version: number;
+    inputs: InputField[];
+    rules: { [key: string]: JsonValue };
+    beneficiaryInput: string;
+    reward: EvaluationReward;
+    grantPolicy: GrantPolicy;
+    triggers: EvaluationTrigger[];
+    createdAt: number;
+    updatedAt: number;
+    updatedBy: string;
+}

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

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { EvaluationStatusEnum } from '../../enums/EvaluationStatusEnum';
+
+/** Cuerpo de `POST /evaluations/{id}/status`: activar, pausar o archivar. */
+export class EvaluationStatusRequest {
+    @Expose()
+    @IsEnum(EvaluationStatusEnum)
+    status: EvaluationStatusEnum;
+}

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

@@ -0,0 +1,6 @@
+import { EventTypeResponse } from './EventTypeResponse';
+
+export class EventTypeListResponse {
+    items: EventTypeResponse[];
+    nextCursor?: string;
+}

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

@@ -0,0 +1,41 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsObject, IsString, Matches, MaxLength } from 'class-validator';
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RewardStatusEnum } from '../../../rewards/enums/RewardStatusEnum';
+import { EVENT_KEY_PATTERN } from '../../constants/BackofficeLimits';
+
+/** Alta (POST) o reemplazo (PUT) de un tipo de evento (spec 5.2). Los `fields` se validan a fondo en el lambda (`InputFieldValidationService`). */
+export class EventTypeRequest {
+    @Expose()
+    @IsString()
+    @Matches(EVENT_KEY_PATTERN)
+    eventKey: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    name: string;
+
+    @Expose()
+    @IsString()
+    @MaxLength(500)
+    description: string;
+
+    /** Servicio que lo emite (ej. `phone-sales`). */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    emitter: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(30)
+    @IsObject({ each: true })
+    fields: InputField[];
+
+    @Expose()
+    @IsEnum(RewardStatusEnum)
+    status: RewardStatusEnum;
+}

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

@@ -0,0 +1,13 @@
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RewardStatusEnum } from '../../../rewards/enums/RewardStatusEnum';
+
+export class EventTypeResponse {
+    eventKey: string;
+    name: string;
+    description: string;
+    emitter: string;
+    fields: InputField[];
+    status: RewardStatusEnum;
+    createdAt: number;
+    updatedAt: number;
+}

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

@@ -0,0 +1,8 @@
+/** Condición que más hace fallar la regla (`GET /metrics/failed-conditions`). */
+export class FailedConditionStatResponse {
+    /** `{source}.{field}`. */
+    key: string;
+    /** Etiqueta legible (del catálogo de reglas; si no está, la propia `key`). */
+    label: string;
+    count: number;
+}