@fiado/type-kit 3.573.0 → 3.575.0

package/bin/rules/dtos/ValidateRulesRequest.js

@@ -13,6 +13,7 @@ exports.ValidateRulesRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const RulesLimits_1 = require("../constants/RulesLimits");
+const EvaluationStrategyEnum_1 = require("../enums/EvaluationStrategyEnum");
 /** `POST /validate`: valida una regla guardada contra el catálogo de los ítems indicados y el contrato de `input`. */
 class ValidateRulesRequest {
 }
@@ -42,3 +43,17 @@ __decorate([
     (0, class_validator_1.IsObject)({ each: true }),
     __metadata("design:type", Array)
 ], ValidateRulesRequest.prototype, "inputContract", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(EvaluationStrategyEnum_1.EvaluationStrategyEnum),
+    __metadata("design:type", String)
+], ValidateRulesRequest.prototype, "evaluationStrategy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_RETURN_FIELDS),
+    (0, class_validator_1.Matches)(RulesLimits_1.RETURN_FIELD_ID_PATTERN, { each: true }),
+    __metadata("design:type", Array)
+], ValidateRulesRequest.prototype, "returnFields", void 0);

package/bin/rules/dtos/datalake/EvaluationExecutionRequest.d.ts

@@ -0,0 +1,21 @@
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RuleToEvaluate, RulesEvaluationSubject } from '../EvaluateRulesRequest';
+/**
+ * `POST /evaluate/executions`: inicia UNA query Athena por lote (hasta 1000 sujetos).
+ * `rules` ausente = modo "solo campos" (exige `returnFields` ≥ 1: esa regla la valida el lambda).
+ */
+export declare class EvaluationExecutionRequest {
+    /** Quién llama (solo logs y métricas). */
+    consumer?: string;
+    /** Ids de ítems del catálogo (`source:key`) que las reglas pueden usar. */
+    items: string[];
+    rules?: RuleToEvaluate[];
+    /** Contrato de la fuente `input` (tipos de las columnas `i_<llave>`). */
+    inputContract?: InputField[];
+    subjects: RulesEvaluationSubject[];
+    /** Fecha ISO 8601 con hora (ancla del cálculo, nunca `now()`). */
+    referenceAt: string;
+    returnFields?: string[];
+    /** Mismo lote reintentado = mismo `QueryExecutionId`. */
+    idempotencyKey: string;
+}

package/bin/rules/dtos/datalake/EvaluationExecutionRequest.js

@@ -0,0 +1,83 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationExecutionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RulesLimits_1 = require("../../constants/RulesLimits");
+const EvaluateRulesRequest_1 = require("../EvaluateRulesRequest");
+/**
+ * `POST /evaluate/executions`: inicia UNA query Athena por lote (hasta 1000 sujetos).
+ * `rules` ausente = modo "solo campos" (exige `returnFields` ≥ 1: esa regla la valida el lambda).
+ */
+class EvaluationExecutionRequest {
+}
+exports.EvaluationExecutionRequest = EvaluationExecutionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], EvaluationExecutionRequest.prototype, "consumer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], EvaluationExecutionRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => EvaluateRulesRequest_1.RuleToEvaluate),
+    __metadata("design:type", Array)
+], EvaluationExecutionRequest.prototype, "rules", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_INPUT_CONTRACT),
+    (0, class_validator_1.IsObject)({ each: true }),
+    __metadata("design:type", Array)
+], EvaluationExecutionRequest.prototype, "inputContract", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_SUBJECTS_PER_DATALAKE_CALL),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => EvaluateRulesRequest_1.RulesEvaluationSubject),
+    __metadata("design:type", Array)
+], EvaluationExecutionRequest.prototype, "subjects", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/),
+    __metadata("design:type", String)
+], EvaluationExecutionRequest.prototype, "referenceAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_RETURN_FIELDS),
+    (0, class_validator_1.Matches)(RulesLimits_1.RETURN_FIELD_ID_PATTERN, { each: true }),
+    __metadata("design:type", Array)
+], EvaluationExecutionRequest.prototype, "returnFields", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(32),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], EvaluationExecutionRequest.prototype, "idempotencyKey", void 0);

package/bin/rules/dtos/datalake/EvaluationExecutionResponse.d.ts

@@ -0,0 +1,6 @@
+import { PopulationExecutionStatusEnum } from '../../enums/PopulationExecutionStatusEnum';
+/** Respuesta de `POST /evaluate/executions`. */
+export declare class EvaluationExecutionResponse {
+    executionId: string;
+    status: PopulationExecutionStatusEnum;
+}

package/bin/rules/dtos/datalake/EvaluationExecutionResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationExecutionResponse = void 0;
+/** Respuesta de `POST /evaluate/executions`. */
+class EvaluationExecutionResponse {
+}
+exports.EvaluationExecutionResponse = EvaluationExecutionResponse;

package/bin/rules/dtos/datalake/EvaluationExecutionResultsResponse.d.ts

@@ -0,0 +1,11 @@
+import { PopulationExecutionStatusEnum } from '../../enums/PopulationExecutionStatusEnum';
+import { RulesErrorCodeEnum } from '../../enums/RulesErrorCodeEnum';
+import { RuleEvaluationResult } from '../EvaluateRulesResponse';
+/** Pagina de resultados. Sin `nextToken` = última página. `reason` solo si `status` es `FAILED`. */
+export declare class EvaluationExecutionResultsResponse {
+    executionId: string;
+    status: PopulationExecutionStatusEnum;
+    results: RuleEvaluationResult[];
+    nextToken?: string;
+    reason?: RulesErrorCodeEnum;
+}

package/bin/rules/dtos/datalake/EvaluationExecutionResultsResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationExecutionResultsResponse = void 0;
+/** Pagina de resultados. Sin `nextToken` = última página. `reason` solo si `status` es `FAILED`. */
+class EvaluationExecutionResultsResponse {
+}
+exports.EvaluationExecutionResultsResponse = EvaluationExecutionResultsResponse;

package/bin/rules/dtos/datalake/EvaluationResultsRequest.d.ts

@@ -0,0 +1,11 @@
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RuleToEvaluate } from '../EvaluateRulesRequest';
+/** `POST /evaluate/executions/{id}/results`: pagina de resultados. Reglas, ítems e `inputContract` deben ser los del inicio. */
+export declare class EvaluationResultsRequest {
+    consumer?: string;
+    items: string[];
+    rules?: RuleToEvaluate[];
+    inputContract?: InputField[];
+    returnFields?: string[];
+    nextToken?: string;
+}

package/bin/rules/dtos/datalake/EvaluationResultsRequest.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationResultsRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RulesLimits_1 = require("../../constants/RulesLimits");
+const EvaluateRulesRequest_1 = require("../EvaluateRulesRequest");
+/** `POST /evaluate/executions/{id}/results`: pagina de resultados. Reglas, ítems e `inputContract` deben ser los del inicio. */
+class EvaluationResultsRequest {
+}
+exports.EvaluationResultsRequest = EvaluationResultsRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], EvaluationResultsRequest.prototype, "consumer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], EvaluationResultsRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => EvaluateRulesRequest_1.RuleToEvaluate),
+    __metadata("design:type", Array)
+], EvaluationResultsRequest.prototype, "rules", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_INPUT_CONTRACT),
+    (0, class_validator_1.IsObject)({ each: true }),
+    __metadata("design:type", Array)
+], EvaluationResultsRequest.prototype, "inputContract", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_RETURN_FIELDS),
+    (0, class_validator_1.Matches)(RulesLimits_1.RETURN_FIELD_ID_PATTERN, { each: true }),
+    __metadata("design:type", Array)
+], EvaluationResultsRequest.prototype, "returnFields", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], EvaluationResultsRequest.prototype, "nextToken", void 0);

package/bin/rules/dtos/datalake/ReturnFieldsCatalogResponse.d.ts

@@ -0,0 +1,17 @@
+import { RulesValueTypeEnum } from '../../enums/RulesValueTypeEnum';
+/** Un campo del catálogo que se puede devolver (`GET /return-fields`). */
+export declare class ReturnableFieldResponse {
+    /** `fuente:campo`. */
+    id: string;
+    source: string;
+    field: string;
+    label: string;
+    description: string;
+    valueType: RulesValueTypeEnum;
+    datalakeCompatible: boolean;
+}
+export declare class ReturnFieldsCatalogResponse {
+    /** `false` si el datalake no está disponible en el ambiente. */
+    available: boolean;
+    fields: ReturnableFieldResponse[];
+}

package/bin/rules/dtos/datalake/ReturnFieldsCatalogResponse.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReturnFieldsCatalogResponse = exports.ReturnableFieldResponse = void 0;
+/** Un campo del catálogo que se puede devolver (`GET /return-fields`). */
+class ReturnableFieldResponse {
+}
+exports.ReturnableFieldResponse = ReturnableFieldResponse;
+class ReturnFieldsCatalogResponse {
+}
+exports.ReturnFieldsCatalogResponse = ReturnFieldsCatalogResponse;

package/bin/rules/dtos/population/SegmentTableSchemaResponse.d.ts

@@ -5,6 +5,8 @@ export declare class SegmentColumnSchemaResponse {
     root?: string;
     type: string;
     isDate: boolean;
+    /** La hoja está detrás de al menos un `array<struct>`: semántica de elemento (`any_match`). */
+    inArray?: boolean;
     operators: SegmentOperatorEnum[];
 }
 export declare class SegmentTableSchemaResponse {

package/bin/rules/enums/EvaluationStrategyEnum.d.ts

@@ -0,0 +1,5 @@
+/** Cómo evalúa el central una regla: `LIVE` (resolvers en vivo, default) o `DATALAKE` (una query Athena por lote). */
+export declare enum EvaluationStrategyEnum {
+    LIVE = "LIVE",
+    DATALAKE = "DATALAKE"
+}

package/bin/rules/enums/EvaluationStrategyEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationStrategyEnum = void 0;
+/** Cómo evalúa el central una regla: `LIVE` (resolvers en vivo, default) o `DATALAKE` (una query Athena por lote). */
+var EvaluationStrategyEnum;
+(function (EvaluationStrategyEnum) {
+    EvaluationStrategyEnum["LIVE"] = "LIVE";
+    EvaluationStrategyEnum["DATALAKE"] = "DATALAKE";
+})(EvaluationStrategyEnum || (exports.EvaluationStrategyEnum = EvaluationStrategyEnum = {}));

package/bin/rules/enums/RulesErrorCodeEnum.d.ts

@@ -3,5 +3,15 @@ export declare enum RulesErrorCodeEnum {
     UNKNOWN_CATALOG_ITEM = "UNKNOWN_CATALOG_ITEM",
     DUPLICATE_SOURCE_IN_ITEMS = "DUPLICATE_SOURCE_IN_ITEMS",
     TOO_MANY_SUBJECTS = "TOO_MANY_SUBJECTS",
-    VALIDATION_ERROR = "VALIDATION_ERROR"
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    /** 400: la regla usa `params`, o una tabla que el campo necesita no existe en el ambiente. */
+    RULE_NOT_DATALAKE_COMPATIBLE = "RULE_NOT_DATALAKE_COMPATIBLE",
+    /** 503: el datalake no está disponible. */
+    DATALAKE_UNAVAILABLE = "DATALAKE_UNAVAILABLE",
+    /** La query del datalake terminó en error. */
+    DATALAKE_EVALUATION_FAILED = "DATALAKE_EVALUATION_FAILED",
+    /** La query del datalake superó el tiempo de espera (reintentable). */
+    DATALAKE_EVALUATION_TIMEOUT = "DATALAKE_EVALUATION_TIMEOUT",
+    /** 400: un id de `returnFields` no existe en el catálogo ni en el esquema del datalake. */
+    UNKNOWN_RETURN_FIELD = "UNKNOWN_RETURN_FIELD"
 }

package/bin/rules/enums/RulesErrorCodeEnum.js

@@ -8,4 +8,14 @@ var RulesErrorCodeEnum;
     RulesErrorCodeEnum["DUPLICATE_SOURCE_IN_ITEMS"] = "DUPLICATE_SOURCE_IN_ITEMS";
     RulesErrorCodeEnum["TOO_MANY_SUBJECTS"] = "TOO_MANY_SUBJECTS";
     RulesErrorCodeEnum["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    /** 400: la regla usa `params`, o una tabla que el campo necesita no existe en el ambiente. */
+    RulesErrorCodeEnum["RULE_NOT_DATALAKE_COMPATIBLE"] = "RULE_NOT_DATALAKE_COMPATIBLE";
+    /** 503: el datalake no está disponible. */
+    RulesErrorCodeEnum["DATALAKE_UNAVAILABLE"] = "DATALAKE_UNAVAILABLE";
+    /** La query del datalake terminó en error. */
+    RulesErrorCodeEnum["DATALAKE_EVALUATION_FAILED"] = "DATALAKE_EVALUATION_FAILED";
+    /** La query del datalake superó el tiempo de espera (reintentable). */
+    RulesErrorCodeEnum["DATALAKE_EVALUATION_TIMEOUT"] = "DATALAKE_EVALUATION_TIMEOUT";
+    /** 400: un id de `returnFields` no existe en el catálogo ni en el esquema del datalake. */
+    RulesErrorCodeEnum["UNKNOWN_RETURN_FIELD"] = "UNKNOWN_RETURN_FIELD";
 })(RulesErrorCodeEnum || (exports.RulesErrorCodeEnum = RulesErrorCodeEnum = {}));

package/bin/rules/index.d.ts

@@ -40,3 +40,9 @@ export * from './dtos/population/PopulationTestResponse';
 export * from './dtos/population/PopulationExecutionRequest';
 export * from './dtos/population/PopulationExecutionResponse';
 export * from './dtos/population/PopulationExecutionPageResponse';
+export * from './enums/EvaluationStrategyEnum';
+export * from './dtos/datalake/EvaluationExecutionRequest';
+export * from './dtos/datalake/EvaluationExecutionResponse';
+export * from './dtos/datalake/EvaluationResultsRequest';
+export * from './dtos/datalake/EvaluationExecutionResultsResponse';
+export * from './dtos/datalake/ReturnFieldsCatalogResponse';

package/bin/rules/index.js

@@ -61,3 +61,10 @@ __exportStar(require("./dtos/population/PopulationTestResponse"), exports);
 __exportStar(require("./dtos/population/PopulationExecutionRequest"), exports);
 __exportStar(require("./dtos/population/PopulationExecutionResponse"), exports);
 __exportStar(require("./dtos/population/PopulationExecutionPageResponse"), exports);
+//Evaluacion DATALAKE, campos devueltos y ejecucion asincrona
+__exportStar(require("./enums/EvaluationStrategyEnum"), exports);
+__exportStar(require("./dtos/datalake/EvaluationExecutionRequest"), exports);
+__exportStar(require("./dtos/datalake/EvaluationExecutionResponse"), exports);
+__exportStar(require("./dtos/datalake/EvaluationResultsRequest"), exports);
+__exportStar(require("./dtos/datalake/EvaluationExecutionResultsResponse"), exports);
+__exportStar(require("./dtos/datalake/ReturnFieldsCatalogResponse"), exports);

package/package.json

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

package/src/retailCommission/dtos/CommissionApi.ts

@@ -476,6 +476,27 @@ export interface MyCommissionsTotals {
     netCents: number;
 }
 
+/**
+ * Lo que un cierre todavía abierto va a mover en el saldo del vendedor, calculado al momento con la
+ * misma cuenta del cierre: cada venta con el «Cuándo se paga» de su plan, menos lo ya acreditado al
+ * momento, más los ajustes del corte.
+ */
+export interface MyCommissionsUpcomingCut {
+    periodId: string;
+    periodStart: string;
+    periodEnd: string;
+    /** Día del cierre en México (`yyyy-mm-dd`): el lunes siguiente al domingo del corte. */
+    cutDate: string;
+    /** Lo que el cierre deja por depositar; negativo si descuenta. */
+    payableCents: number;
+    /** De `payableCents`, lo que viene de ajustes del corte. */
+    adjustmentsCents: number;
+    /** Lo que el cierre retiene hasta el día 1. */
+    retainedCents: number;
+    /** Día en que se libera lo retenido (`yyyy-mm-dd`); `null` si no retiene. */
+    releaseDate: string | null;
+}
+
 /**
  * `GET /commissions/me?weeks=` — las comisiones del vendedor que llama. El vendedor sale del token;
  * no se puede pedir el de otro.
@@ -485,6 +506,11 @@ export interface GetMyCommissionsResponse {
     period: { periodId: string; periodStart: string; periodEnd: string };
     /** El corte en curso; `null` si todavía no tiene ventas, renta ni ajustes. */
     week: CommissionSellerBreakdown | null;
+    /**
+     * Los cierres pendientes con algo que mover: el del corte anterior si todavía no cierra y el del
+     * corte en curso, del más próximo al más lejano. Ausente en motores anteriores.
+     */
+    upcomingCuts?: MyCommissionsUpcomingCut[];
     /** Cortes cuya semana empieza en el mes de hoy: cerrados, el anterior aún sin cerrar y el en curso. */
     month: MyCommissionsTotals;
     /** Cortes cuya semana empieza en el año de hoy: cerrados, el anterior aún sin cerrar y el en curso. */

package/src/rewardsEligibility/constants/BatchLimits.ts

@@ -0,0 +1,2 @@
+/** Máximo de sujetos de un `EvaluateBatchMessage` (lote de una evaluación DATALAKE). */
+export const EVALUATE_BATCH_MAX_SUBJECTS = 1000;

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

@@ -2,6 +2,7 @@ import { Expose, Type } from 'class-transformer';
 import { IsEnum, IsObject, IsOptional, Matches, Validate } from 'class-validator';
 import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
 import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
+import { IsRewardInputs } from '../../validators/IsRewardInputs';
 import { REQUEST_ID_PATTERN } from '../../constants/BackofficeLimits';
 import { RunModeEnum } from '../../enums/RunModeEnum';
 import { PopulationRunRequest } from './PopulationRunRequest';
@@ -28,4 +29,10 @@ export class CreateRunRequest {
     @IsObject()
     @Type(() => PopulationRunRequest)
     population?: PopulationRunRequest;
+
+    /** Valores escritos por el operador para ESTA corrida: itemKey → inputKey → valor. */
+    @Expose()
+    @IsOptional()
+    @Validate(IsRewardInputs)
+    rewardInputs?: Record<string, Record<string, DynamicFormValue>>;
 }

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

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsObject, IsOptional, IsString, Matches, MaxLength } from 'class-validator';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, Matches, MaxLength } from 'class-validator';
 import { JsonValue } from '../../../common';
+import { EvaluationStrategyEnum } from '../../../rules/enums/EvaluationStrategyEnum';
 import { InputField } from '../../../dynamicForm/dtos/InputField';
 import { ELIGIBILITY_ID_PATTERN, INPUT_KEY_PATTERN } from '../../constants/BackofficeLimits';
 import { EvaluationReward } from '../EvaluationReward';
@@ -80,4 +81,10 @@ export class EvaluationRequest {
     @IsString()
     @Matches(INPUT_KEY_PATTERN)
     populationInputKey?: string;
+
+    /** Estrategia de evaluación de las corridas masivas; ausente = `LIVE`. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(EvaluationStrategyEnum)
+    evaluationStrategy?: EvaluationStrategyEnum;
 }

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

@@ -1,4 +1,5 @@
 import { JsonValue } from '../../../common';
+import { EvaluationStrategyEnum } from '../../../rules/enums/EvaluationStrategyEnum';
 import { InputField } from '../../../dynamicForm/dtos/InputField';
 import { EvaluationStatusEnum } from '../../enums/EvaluationStatusEnum';
 import { EvaluationReward } from '../EvaluationReward';
@@ -21,6 +22,8 @@ export class EvaluationResponse {
     triggers: EvaluationTrigger[];
     populationSegmentId?: string;
     populationInputKey?: string;
+    /** Ausente = `LIVE`. */
+    evaluationStrategy?: EvaluationStrategyEnum;
     createdAt: number;
     updatedAt: number;
     updatedBy: string;

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

@@ -2,6 +2,7 @@ import { Expose, Type } from 'class-transformer';
 import { IsOptional, IsString, Matches, Validate, ValidateNested } from 'class-validator';
 import { DynamicFormValue } from '../../../dynamicForm/types/DynamicFormValue';
 import { IsDynamicFormValues } from '../../../dynamicForm/validators/IsDynamicFormValues';
+import { IsRewardInputs } from '../../validators/IsRewardInputs';
 import { ELIGIBILITY_ID_PATTERN } from '../../constants/BackofficeLimits';
 import { EvaluationRequest } from './EvaluationRequest';
 
@@ -22,4 +23,10 @@ export class SimulateRequest {
     @Expose()
     @Validate(IsDynamicFormValues)
     inputs: Record<string, DynamicFormValue>;
+
+    /** Valores escritos por el operador para ESTA corrida: itemKey → inputKey → valor. */
+    @Expose()
+    @IsOptional()
+    @Validate(IsRewardInputs)
+    rewardInputs?: Record<string, Record<string, DynamicFormValue>>;
 }

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

@@ -2,6 +2,7 @@ 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 { EVALUATE_BATCH_MAX_SUBJECTS } from '../../constants/BatchLimits';
 import { EligibilityMessageTypeEnum } from '../../enums/EligibilityMessageTypeEnum';
 
 /** Un sujeto del lote. No lleva hechos precargados: la evaluacion siempre es en vivo. */
@@ -16,7 +17,7 @@ export class EvaluateBatchSubject {
     inputs: Record<string, DynamicFormValue>;
 }
 
-/** Lote de hasta 100 sujetos a evaluar en una corrida masiva. */
+/** Lote de hasta 1000 sujetos a evaluar en una corrida masiva. */
 export class EvaluateBatchMessage {
     @Expose()
     @Equals(EligibilityMessageTypeEnum.EVALUATE_BATCH)
@@ -35,7 +36,7 @@ export class EvaluateBatchMessage {
     @Expose()
     @IsArray()
     @ArrayMinSize(1)
-    @ArrayMaxSize(100)
+    @ArrayMaxSize(EVALUATE_BATCH_MAX_SUBJECTS)
     @ValidateNested({ each: true })
     @Type(() => EvaluateBatchSubject)
     subjects: EvaluateBatchSubject[];

package/src/rewardsEligibility/index.ts

@@ -43,6 +43,8 @@ export * from './enums/MetricsDimensionEnum';
 export * from './enums/RuleValueTypeEnum';
 export * from './enums/RulesChatRoleEnum';
 export * from './constants/BackofficeLimits';
+export * from './constants/BatchLimits';
+export * from './validators/IsRewardInputs';
 export * from './dtos/backoffice/CampaignRequest';
 export * from './dtos/backoffice/CampaignStatusRequest';
 export * from './dtos/backoffice/CampaignResponse';

package/src/rewardsEligibility/types/RewardInputRef.ts

@@ -1,4 +1,8 @@
+import { InputFieldTypeEnum } from '../../dynamicForm/enums/InputFieldTypeEnum';
 import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
 
-/** Valor de un input de `reward.inputs`: constante o tomado de un input de la evaluacion (spec B 5.1). */
-export type RewardInputRef = { const: DynamicFormValue } | { input: string };
+/**
+ * Valor de un input de `reward.inputs`: constante, tomado de un input de la evaluacion (spec B 5.1)
+ * o de un campo del usuario leído del datalake (`field`). `as` lo fija el backend al guardar (tipo de la dependencia destino).
+ */
+export type RewardInputRef = { const: DynamicFormValue } | { input: string } | { field: string; fallback?: DynamicFormValue; as?: InputFieldTypeEnum };

package/src/rewardsEligibility/validators/IsRewardInputs.ts

@@ -0,0 +1,16 @@
+import { ValidationArguments, ValidatorConstraint, ValidatorConstraintInterface } from 'class-validator';
+import { JsonValue } from '../../common/types/JsonValue';
+import { isDynamicFormValue, isPlainObject } from '../../dynamicForm/helpers/isDynamicFormValue';
+
+/** Valida `itemKey → inputKey → DynamicFormValue` (dos niveles exactos). */
+@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((inner) => isPlainObject(inner) && Object.values(inner).every(isDynamicFormValue));
+    }
+
+    defaultMessage(_args: ValidationArguments): string {
+        return 'rewardInputs debe ser un mapa itemKey → inputKey → string | number | boolean | {from, to}';
+    }
+}

package/src/rules/constants/RulesLimits.ts

@@ -6,3 +6,9 @@ export const RULES_INPUT_SOURCE = 'input';
 export const RULES_MAX_INPUT_CONTRACT = 30;
 /** Largo máximo (caracteres) del contenido de un turno del chat de `POST /generate`. */
 export const RULES_CHAT_TURN_MAX_LENGTH = 4000;
+/** Máximo de sujetos por query asíncrona de evaluación DATALAKE (`POST /evaluate/executions`). */
+export const RULES_MAX_SUBJECTS_PER_DATALAKE_CALL = 1000;
+/** Máximo de `returnFields` por llamada. */
+export const RULES_MAX_RETURN_FIELDS = 20;
+/** Id de campo devuelto: `fuente:campo` (campo del catálogo) o `tabla.ruta.hoja` (hoja del esquema aplanado de Glue). */
+export const RETURN_FIELD_ID_PATTERN = /^(?:[a-z][a-z0-9-]*:[A-Za-z][A-Za-z0-9_]*|[a-z_][a-z0-9_]*(?:\.[a-z_][a-z0-9_]*){1,8})$/;

package/src/rules/dtos/EvaluateRulesRequest.ts

@@ -1,7 +1,10 @@
 import { Expose, Type } from 'class-transformer';
-import { IsArray, IsISO8601, IsObject, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ArrayMaxSize, IsArray, IsEnum, IsISO8601, IsObject, IsOptional, IsString, Matches, ValidateNested } from 'class-validator';
 import { JsonValue } from '../../common';
+import { InputField } from '../../dynamicForm/dtos/InputField';
 import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
+import { RETURN_FIELD_ID_PATTERN, RULES_MAX_INPUT_CONTRACT, RULES_MAX_RETURN_FIELDS } from '../constants/RulesLimits';
+import { EvaluationStrategyEnum } from '../enums/EvaluationStrategyEnum';
 
 /** A quién se le evalúa la regla. */
 export class RulesEvaluationSubject {
@@ -64,4 +67,26 @@ export class EvaluateRulesRequest {
     @IsOptional()
     @IsISO8601()
     referenceAt?: string;
+
+    /** Estrategia de evaluación; ausente = `LIVE`. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(EvaluationStrategyEnum)
+    evaluationStrategy?: EvaluationStrategyEnum;
+
+    /** Campos a devolver por sujeto (`fuente:campo` o `tabla.ruta.hoja`); máx. 20. Se leen del datalake. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(RULES_MAX_RETURN_FIELDS)
+    @Matches(RETURN_FIELD_ID_PATTERN, { each: true })
+    returnFields?: string[];
+
+    /** Contrato de la fuente `input` (tipos de las columnas `i_<llave>` en DATALAKE). */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(RULES_MAX_INPUT_CONTRACT)
+    @IsObject({ each: true })
+    inputContract?: InputField[];
 }

package/src/rules/dtos/EvaluateRulesResponse.ts

@@ -1,3 +1,4 @@
+import { JsonValue } from '../../common';
 import { RulesOutcomeEnum } from '../enums/RulesOutcomeEnum';
 import { RulesTraceResponse } from './RulesTraceResponse';
 
@@ -11,6 +12,8 @@ export class RuleEvaluationResult {
     trace?: RulesTraceResponse;
     /** Solo si `outcome` es `ERROR`. */
     errorMessage?: string;
+    /** Campos devueltos pedidos en `returnFields`: clave = id del campo; `null` = sin dato. */
+    returned?: Record<string, JsonValue>;
 }
 
 /** `POST /evaluate`: ordenado por regla y, dentro de cada regla, por `subjectIndex`. */