@fiado/type-kit 3.515.0 → 3.517.0

package/src/group/dtos/GroupResponse.ts

@@ -1,4 +1,5 @@
 import { GroupStatus } from "../enums/GroupStatus"
+import type { GroupOwnerItem } from "../../referral-business/dtos/GroupOwnersByGroupIdsResponse"
 
 
 export class GroupResponse {
@@ -17,6 +18,9 @@ export class GroupResponse {
     imageUrl?: string | null
     imageUrlSigned?: string | null
     parentGroupId: string
+    // Agente OWNER_<grupo> resuelto en vivo desde referral-business. null = sin owner o no se pudo resolver;
+    // ausente = la lectura no lo pidió. Reemplaza a leaderNames/leaderEmail/leaderDirectoryId (ya no se escriben).
+    owner?: GroupOwnerItem | null
 }
 
 

package/src/referral-business/dtos/GroupOwnersByGroupIdsRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de groupIds por request del endpoint batch de owners de grupo.
+export const GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH = 100;
+
+// Body de POST /private/agents/owners/by-group-ids; la lista vacía es válida y responde {}.
+export class GroupOwnersByGroupIdsRequest {
+    @IsArray()
+    @ArrayMaxSize(GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH)
+    @IsString({ each: true })
+    groupIds!: string[];
+}

package/src/referral-business/dtos/GroupOwnersByGroupIdsResponse.ts

@@ -0,0 +1,11 @@
+// Agente OWNER_<grupo> de Agents_GT (excluye DELETE; ACTIVE gana). name/email null si no se pudieron resolver.
+export interface GroupOwnerItem {
+    agentId: string;
+    directoryId: string;
+    name: string | null;
+    email: string | null;
+    status: string;
+}
+
+// Respuesta de POST /private/agents/owners/by-group-ids; un grupo sin owner no aparece.
+export type GroupOwnersByGroupIdsResponse = Record<string, GroupOwnerItem>;

package/src/referral-business/index.ts

@@ -4,3 +4,5 @@ export * from './enums/AgentRoleEnum';
 //dtos
 export * from './dtos/AgentsByDirectoryIdsRequest';
 export * from './dtos/AgentsByDirectoryIdsResponse';
+export * from './dtos/GroupOwnersByGroupIdsRequest';
+export * from './dtos/GroupOwnersByGroupIdsResponse';

package/src/rewardsEligibility/constants/BackofficeLimits.ts

@@ -0,0 +1,12 @@
+/** 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;

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;
+}

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

@@ -0,0 +1,7 @@
+import { InputFieldTypeEnum } from '../../../dynamicForm/enums/InputFieldTypeEnum';
+
+/** `GET /input-types`: tipos del formulario dinámico compartido. */
+export class InputTypeResponse {
+    type: InputFieldTypeEnum;
+    label: string;
+}

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

@@ -0,0 +1,14 @@
+/** Un día de métricas preagregadas (spec 5.7). Solo cuenta resultados que llegaron a un estado final. */
+export class MetricsPointResponse {
+    /** `AAAA-MM-DD` (UTC). */
+    date: string;
+    evaluated: number;
+    match: number;
+    noMatch: number;
+    error: number;
+    alreadyGranted: number;
+    quotaExhausted: number;
+    excluded: number;
+    requested: number;
+    requestFailed: number;
+}

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

@@ -0,0 +1,10 @@
+import { MetricsDimensionEnum } from '../../enums/MetricsDimensionEnum';
+
+/** Query params ya validados de `GET /metrics` (`from`/`to` = `AAAA-MM-DD`, UTC, inclusivos). */
+export class MetricsQuery {
+    dimension: MetricsDimensionEnum;
+    /** Obligatorio salvo con `dimension: ALL`. */
+    value?: string;
+    from: string;
+    to: string;
+}

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

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { Validate } from 'class-validator';
+import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
+import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
+
+/** Corrida por población (fase 4): los `params` de la fuente para esta corrida. El lambda de la fase 3 la rechaza con `POPULATION_RUN_NOT_SUPPORTED`. */
+export class PopulationRunRequest {
+    @Expose()
+    @Validate(IsDynamicFormValues)
+    params: Record<string, DynamicFormValue>;
+}

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

@@ -0,0 +1,12 @@
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+
+/** `GET /population-sources`: fuente de población para un disparador `CRON` (la ejecución llega en la fase 4). */
+export class PopulationSourceResponse {
+    source: string;
+    label: string;
+    description: string;
+    /** Formulario de los params de la fuente. */
+    paramsSchema: InputField[];
+    /** Keys de input que la fuente provee por sujeto. */
+    provides: string[];
+}

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

@@ -0,0 +1,9 @@
+/** Lo que una corrida en espera de aprobación consumiría de un cupo (spec 7.5). */
+export class QuotaImpactResponse {
+    quotaId: string;
+    /** Ventana vigente al consultar (`TOTAL`, `2026-W41`…). */
+    window: string;
+    limit: number;
+    consumed: number;
+    wouldConsume: number;
+}

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

@@ -0,0 +1,11 @@
+import { QuotaPeriodEnum } from '../../enums/QuotaPeriodEnum';
+
+/** `GET /campaigns/{id}/quotas`: consumo actual de un cupo en su ventana vigente. */
+export class QuotaUsageResponse {
+    quotaId: string;
+    period: QuotaPeriodEnum;
+    /** Ventana vigente: `TOTAL`, `2026-10-08` (DAY), `2026-W41` (WEEK) o `2026-10` (MONTH). */
+    window: string;
+    limit: number;
+    consumed: number;
+}

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

@@ -0,0 +1,34 @@
+import { JsonValue } from '../../../common';
+import { EvaluationOutcomeEnum } from '../../enums/EvaluationOutcomeEnum';
+import { TraceOriginEnum } from '../../enums/TraceOriginEnum';
+
+/** Una condición evaluada: qué se esperaba, qué se encontró y de dónde salió el dato (spec 5.4). */
+export class TraceConditionResponse {
+    source: string;
+    subject?: string;
+    field: string;
+    params?: Record<string, string | number | boolean>;
+    op: string;
+    expected: JsonValue;
+    actual?: JsonValue;
+    /** `MATCH`, `NO_MATCH` o `ERROR`. */
+    outcome: EvaluationOutcomeEnum;
+    origin?: TraceOriginEnum;
+    /** Solo si `origin` es `PREFETCHED`. */
+    asOf?: string;
+    /** Solo si `outcome` es `ERROR`. */
+    error?: { code: string; message: string };
+}
+
+export class TraceGroupResponse {
+    match: 'ALL' | 'ANY';
+    outcome: EvaluationOutcomeEnum;
+    conditions: TraceConditionResponse[];
+}
+
+/** Traza completa de una evaluación: por qué cumplió o no (criterio de éxito 4). */
+export class ResultTraceResponse {
+    match: 'ALL' | 'ANY';
+    outcome: EvaluationOutcomeEnum;
+    groups: TraceGroupResponse[];
+}

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

@@ -0,0 +1,28 @@
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RuleValueTypeEnum } from '../../enums/RuleValueTypeEnum';
+
+/** Un campo que una fuente resuelve para las reglas (`GET /rule-catalog`). */
+export class RuleCatalogFieldResponse {
+    field: string;
+    label: string;
+    valueType: RuleValueTypeEnum;
+    /** Operadores válidos para este campo (`GT`, `LTE`, `IN`…). */
+    operators: string[];
+    /** Params del campo (ej. ventana y moneda de `sumAmount`), como formulario dinámico. */
+    params?: InputField[];
+    /** Valores posibles si es un enum. */
+    options?: { value: string; label: string }[];
+}
+
+export class RuleCatalogSourceResponse {
+    source: string;
+    label: string;
+    description: string;
+    fields: RuleCatalogFieldResponse[];
+}
+
+export class RuleCatalogResponse {
+    sources: RuleCatalogSourceResponse[];
+    /** Etiqueta legible de cada operador (`GTE` → «≥»). */
+    operators: Record<string, string>;
+}

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

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