@fiado/type-kit 3.517.0 → 3.518.0

package/_test_/unit/rewardsEligibility/backofficeBarrel.test.ts

@@ -10,6 +10,7 @@ describe('barrel rewardsEligibility incluye el backoffice', () => {
         'CreateRunRequest', 'PopulationRunRequest', 'ApproveRunRequest', 'QuotaImpactResponse', 'RunResponse', 'RunListResponse',
         'RunResultResponse', 'RunResultListResponse', 'CreateRunResponse', 'MetricsPointResponse', 'FailedConditionStatResponse', 'MetricsQuery',
         'MetricsDimensionEnum', 'RuleValueTypeEnum', 'ELIGIBILITY_ID_PATTERN', 'EVENT_KEY_PATTERN', 'REQUEST_ID_PATTERN', 'MAX_QUOTAS_PER_CAMPAIGN',
+        'RulesChatRoleEnum', 'RulesChatTurn', 'GenerateRulesRequest', 'GenerateRulesResponse', 'RULES_CHAT_TURN_MAX_LENGTH', 'RULES_CHAT_MAX_TURNS_HARD',
     ])('exporta %s', (name) => {
         expect((kit as Record<string, object | string | number | RegExp>)[name]).toBeDefined();
     });

package/_test_/unit/rewardsEligibility/events.test.ts

@@ -77,7 +77,7 @@ describe('enums de rewardsEligibility (valores que viajan por HTTP)', () => {
     expect(Object.values(TriggerTypeEnum).sort()).toEqual(['CRON', 'EVENT', 'MANUAL']);
     const codes = Object.values(RewardsEligibilityErrorCodeEnum);
     expect(codes).toEqual(expect.arrayContaining(['EVENT_TYPE_NOT_FOUND', 'INPUT_INVALID', 'RUN_NOT_FOUND']));
-    expect(codes).toHaveLength(30);
+    expect(codes).toHaveLength(35);
   });
 });
 

package/_test_/unit/rewardsEligibility/generateRulesRequest.test.ts

@@ -0,0 +1,50 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { InputFieldTypeEnum } from '../../../src/dynamicForm/enums/InputFieldTypeEnum';
+import { GenerateRulesRequest } from '../../../src/rewardsEligibility/dtos/backoffice/GenerateRulesRequest';
+
+const parse = async (body: object) => {
+    const value = plainToInstance(GenerateRulesRequest, body, { excludeExtraneousValues: true });
+    return { value, errors: await validate(value) };
+};
+const input = { key: 'buyerDirectoryId', type: InputFieldTypeEnum.DIRECTORY, label: 'Comprador', required: true };
+const turn = (content: string, role = 'user') => ({ role, content });
+const valid = { history: [turn('cuentas de menos de 7 días')], inputs: [input] };
+
+describe('GenerateRulesRequest', () => {
+    it('acepta un chat con reglas actuales y el contrato de entrada', async () => {
+        const { errors, value } = await parse({ ...valid, currentRules: { match: 'ALL', groups: [] } });
+        expect(errors).toEqual([]);
+        expect(value.history[0]?.content).toBe('cuentas de menos de 7 días');
+        expect(value.currentRules).toEqual({ match: 'ALL', groups: [] });
+    });
+
+    it('acepta historial vacío y contrato vacío (el lambda decide con AI_CHAT_HISTORY_EMPTY)', async () => {
+        expect((await parse({ history: [], inputs: [] })).errors).toEqual([]);
+    });
+
+    it('rechaza un rol inventado', async () => {
+        expect((await parse({ ...valid, history: [turn('hola', 'system')] })).errors.length).toBeGreaterThan(0);
+    });
+
+    it('rechaza un turno vacío y uno de más de 4000 caracteres', async () => {
+        expect((await parse({ ...valid, history: [turn('')] })).errors.length).toBeGreaterThan(0);
+        expect((await parse({ ...valid, history: [turn('x'.repeat(4001))] })).errors.length).toBeGreaterThan(0);
+        expect((await parse({ ...valid, history: [turn('x'.repeat(4000))] })).errors).toEqual([]);
+    });
+
+    it('rechaza más de 50 turnos (tope de seguridad del DTO)', async () => {
+        expect((await parse({ ...valid, history: Array.from({ length: 51 }, () => turn('a')) })).errors.length).toBeGreaterThan(0);
+    });
+
+    it('rechaza inputs que no es un arreglo y currentRules que no es un objeto', async () => {
+        expect((await parse({ ...valid, inputs: 'x' })).errors.length).toBeGreaterThan(0);
+        expect((await parse({ ...valid, currentRules: 'x' })).errors.length).toBeGreaterThan(0);
+    });
+
+    it('descarta propiedades que no son del contrato', async () => {
+        const { value } = await parse({ ...valid, hack: true });
+        expect('hack' in value).toBe(false);
+    });
+});

package/_test_/unit/rewardsEligibility/generateRulesResponse.test.ts

@@ -0,0 +1,12 @@
+import type { GenerateRulesResponse } from '../../../src/rewardsEligibility/dtos/backoffice/GenerateRulesResponse';
+
+describe('GenerateRulesResponse (forma pública)', () => {
+    it('las tres salidas posibles del chat se pueden armar con la forma pública', () => {
+        const ready: GenerateRulesResponse = { explanation: 'Cuentas de hasta 7 días.', rules: { match: 'ALL', groups: [] }, valid: true };
+        const question: GenerateRulesResponse = { explanation: '¿A qué grupo te refieres?', valid: true };
+        const failed: GenerateRulesResponse = { explanation: 'No pude.', valid: false, problems: ['rules.groups[0].conditions[0].field: campo desconocido'] };
+        expect(ready.rules).toBeDefined();
+        expect(question.rules).toBeUndefined();
+        expect(failed.problems).toHaveLength(1);
+    });
+});

package/_test_/unit/rewardsEligibility/ruleCatalogRich.test.ts

@@ -0,0 +1,18 @@
+import { RuleValueTypeEnum } from '../../../src/rewardsEligibility/enums/RuleValueTypeEnum';
+import type { RuleCatalogFieldResponse } from '../../../src/rewardsEligibility/dtos/backoffice/RuleCatalogResponse';
+
+describe('RuleCatalogFieldResponse enriquecido', () => {
+    it('un campo puede traer descripción, frases de ejemplo y descripción por opción', () => {
+        const field: RuleCatalogFieldResponse = {
+            field: 'status', label: 'Estado de la cuenta', valueType: RuleValueTypeEnum.STRING, operators: ['EQUALS'],
+            description: 'Estado operativo del directorio del usuario.',
+            examplePhrases: ['usuarios activos'],
+            options: [{ value: 'ACTIVE', label: 'ACTIVE', description: 'cuenta operativa' }],
+        };
+        expect(field.options?.[0]?.description).toBe('cuenta operativa');
+    });
+    it('sigue siendo válido sin los campos nuevos', () => {
+        const field: RuleCatalogFieldResponse = { field: 'x', label: 'x', valueType: RuleValueTypeEnum.NUMBER, operators: ['GT'] };
+        expect(field.description).toBeUndefined();
+    });
+});

package/_test_/unit/rewardsEligibility/rulesAiEnums.test.ts

@@ -0,0 +1,15 @@
+import { RewardsEligibilityErrorCodeEnum } from '../../../src/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum';
+import { RulesChatRoleEnum } from '../../../src/rewardsEligibility/enums/RulesChatRoleEnum';
+
+describe('enums de la generación de reglas con IA', () => {
+    it('los roles del chat son user y assistant (los mismos del prompt de benefits)', () => {
+        expect(Object.values(RulesChatRoleEnum)).toEqual(['user', 'assistant']);
+    });
+
+    it.each(['AI_CHAT_HISTORY_EMPTY', 'AI_CHAT_HISTORY_TOO_LONG', 'AI_GENERATION_FAILED', 'AI_RESPONSE_UNPARSEABLE', 'AI_GENERATION_TIMEOUT'] as const)(
+        'el código %s existe y su valor es su nombre',
+        (code) => {
+            expect(RewardsEligibilityErrorCodeEnum[code]).toBe(code);
+        },
+    );
+});

package/bin/rewardsEligibility/constants/BackofficeLimits.d.ts

@@ -10,3 +10,7 @@ export declare const REQUEST_ID_PATTERN: RegExp;
 export declare const MAX_QUOTAS_PER_CAMPAIGN = 9;
 /** Tope de `limit` de los listados paginados. */
 export declare const LIST_PAGE_MAX = 100;
+/** Largo máximo del texto de un turno del chat que genera reglas. */
+export declare 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 declare const RULES_CHAT_MAX_TURNS_HARD = 50;

package/bin/rewardsEligibility/constants/BackofficeLimits.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIST_PAGE_MAX = exports.MAX_QUOTAS_PER_CAMPAIGN = exports.REQUEST_ID_PATTERN = exports.DATE_PATTERN = exports.EVENT_KEY_PATTERN = exports.ELIGIBILITY_ID_PATTERN = void 0;
+exports.RULES_CHAT_MAX_TURNS_HARD = exports.RULES_CHAT_TURN_MAX_LENGTH = exports.LIST_PAGE_MAX = exports.MAX_QUOTAS_PER_CAMPAIGN = exports.REQUEST_ID_PATTERN = exports.DATE_PATTERN = exports.EVENT_KEY_PATTERN = exports.ELIGIBILITY_ID_PATTERN = void 0;
 /** 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). */
 exports.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`). */
@@ -13,3 +13,7 @@ exports.REQUEST_ID_PATTERN = /^[A-Za-z0-9_-]{8,64}$/;
 exports.MAX_QUOTAS_PER_CAMPAIGN = 9;
 /** Tope de `limit` de los listados paginados. */
 exports.LIST_PAGE_MAX = 100;
+/** Largo máximo del texto de un turno del chat que genera reglas. */
+exports.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`). */
+exports.RULES_CHAT_MAX_TURNS_HARD = 50;

package/bin/rewardsEligibility/dtos/backoffice/GenerateRulesRequest.d.ts

@@ -0,0 +1,17 @@
+import { JsonValue } from '../../../common';
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RulesChatTurn } from './RulesChatTurn';
+/**
+ * `POST /rules/generate`: el chat del editor de reglas. El lambda arma el prompt con el catálogo de fuentes y ESTE contrato de entrada
+ * (qué sujetos `DIRECTORY` y qué campos de `input` existen), genera `{ match, groups[] }` y lo valida con el mismo `validateRule` de la evaluación.
+ */
+export declare class GenerateRulesRequest {
+    /** Del turno más viejo al más nuevo; el último es del admin (`user`). Entre 1 y 10 turnos (el lambda responde `AI_CHAT_HISTORY_EMPTY` / `AI_CHAT_HISTORY_TOO_LONG`). */
+    history: RulesChatTurn[];
+    /** Las reglas que el editor tiene ahora (`{ match, groups[] }`), para refinarlas. Ausente = regla nueva. */
+    currentRules?: {
+        [key: string]: JsonValue;
+    };
+    /** Contrato de entrada de la evaluación que se está editando (`InputField[]`, dominio `dynamicForm`): de aquí salen los `subject` y los campos de la fuente `input`. */
+    inputs: InputField[];
+}

package/bin/rewardsEligibility/dtos/backoffice/GenerateRulesRequest.js

@@ -0,0 +1,44 @@
+"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.GenerateRulesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BackofficeLimits_1 = require("../../constants/BackofficeLimits");
+const RulesChatTurn_1 = require("./RulesChatTurn");
+/**
+ * `POST /rules/generate`: el chat del editor de reglas. El lambda arma el prompt con el catálogo de fuentes y ESTE contrato de entrada
+ * (qué sujetos `DIRECTORY` y qué campos de `input` existen), genera `{ match, groups[] }` y lo valida con el mismo `validateRule` de la evaluación.
+ */
+class GenerateRulesRequest {
+}
+exports.GenerateRulesRequest = GenerateRulesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(BackofficeLimits_1.RULES_CHAT_MAX_TURNS_HARD),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RulesChatTurn_1.RulesChatTurn),
+    __metadata("design:type", Array)
+], GenerateRulesRequest.prototype, "history", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], GenerateRulesRequest.prototype, "currentRules", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(30),
+    (0, class_validator_1.IsObject)({ each: true }),
+    __metadata("design:type", Array)
+], GenerateRulesRequest.prototype, "inputs", void 0);

package/bin/rewardsEligibility/dtos/backoffice/GenerateRulesResponse.d.ts

@@ -0,0 +1,18 @@
+import { JsonValue } from '../../../common';
+/**
+ * Respuesta de `POST /rules/generate`. Tres casos:
+ * - Reglas listas: `valid: true` + `rules` (ya validadas contra el catálogo y los inputs: el editor puede cargarlas tal cual).
+ * - La IA pidió una aclaración (o no podía con lo pedido): `valid: true`, SIN `rules`; la pregunta va en `explanation`.
+ * - La IA generó reglas que no pasaron la validación ni tras el reintento: `valid: false`, SIN `rules`, con `problems`.
+ */
+export declare class GenerateRulesResponse {
+    /** Qué hizo (o qué preguntó) la IA, en español. Siempre viene. */
+    explanation: string;
+    /** `{ match, groups[] }` de `@fiado/rules-engine`. */
+    rules?: {
+        [key: string]: JsonValue;
+    };
+    valid: boolean;
+    /** Mensajes legibles de la última salida inválida. Solo con `valid: false`. */
+    problems?: string[];
+}

package/bin/rewardsEligibility/dtos/backoffice/GenerateRulesResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateRulesResponse = void 0;
+/**
+ * Respuesta de `POST /rules/generate`. Tres casos:
+ * - Reglas listas: `valid: true` + `rules` (ya validadas contra el catálogo y los inputs: el editor puede cargarlas tal cual).
+ * - La IA pidió una aclaración (o no podía con lo pedido): `valid: true`, SIN `rules`; la pregunta va en `explanation`.
+ * - La IA generó reglas que no pasaron la validación ni tras el reintento: `valid: false`, SIN `rules`, con `problems`.
+ */
+class GenerateRulesResponse {
+}
+exports.GenerateRulesResponse = GenerateRulesResponse;

package/bin/rewardsEligibility/dtos/backoffice/RuleCatalogResponse.d.ts

@@ -9,11 +9,16 @@ export declare class RuleCatalogFieldResponse {
     operators: string[];
     /** Params del campo (ej. ventana y moneda de `sumAmount`), como formulario dinámico. */
     params?: InputField[];
-    /** Valores posibles si es un enum. */
+    /** Valores posibles si es un enum (con qué significa cada uno, si se sabe). */
     options?: {
         value: string;
         label: string;
+        description?: string;
     }[];
+    /** Qué es este campo, en una frase (tooltip del editor). */
+    description?: string;
+    /** Frases de ejemplo que típicamente piden este campo (ayuda del chat de IA). */
+    examplePhrases?: string[];
 }
 export declare class RuleCatalogSourceResponse {
     source: string;

package/bin/rewardsEligibility/dtos/backoffice/RulesChatTurn.d.ts

@@ -0,0 +1,6 @@
+import { RulesChatRoleEnum } from '../../enums/RulesChatRoleEnum';
+/** Un turno del chat que genera reglas con IA. */
+export declare class RulesChatTurn {
+    role: RulesChatRoleEnum;
+    content: string;
+}

package/bin/rewardsEligibility/dtos/backoffice/RulesChatTurn.js

@@ -0,0 +1,32 @@
+"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.RulesChatTurn = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BackofficeLimits_1 = require("../../constants/BackofficeLimits");
+const RulesChatRoleEnum_1 = require("../../enums/RulesChatRoleEnum");
+/** Un turno del chat que genera reglas con IA. */
+class RulesChatTurn {
+}
+exports.RulesChatTurn = RulesChatTurn;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RulesChatRoleEnum_1.RulesChatRoleEnum),
+    __metadata("design:type", String)
+], RulesChatTurn.prototype, "role", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(BackofficeLimits_1.RULES_CHAT_TURN_MAX_LENGTH),
+    __metadata("design:type", String)
+], RulesChatTurn.prototype, "content", void 0);

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

@@ -49,5 +49,15 @@ export declare enum RewardsEligibilityErrorCodeEnum {
     /** 400: el rango pedido excede el tope de filas de la exportación. */
     EXPORT_TOO_LARGE = "EXPORT_TOO_LARGE",
     /** 503: la tabla de métricas no responde o no existe aún. */
-    METRICS_UNAVAILABLE = "METRICS_UNAVAILABLE"
+    METRICS_UNAVAILABLE = "METRICS_UNAVAILABLE",
+    /** 400: `POST /rules/generate` sin ningún turno de chat. */
+    AI_CHAT_HISTORY_EMPTY = "AI_CHAT_HISTORY_EMPTY",
+    /** 400: el chat tiene más de 10 turnos (se acota el prompt). */
+    AI_CHAT_HISTORY_TOO_LONG = "AI_CHAT_HISTORY_TOO_LONG",
+    /** 503: el motor de IA no respondió o falló. Reintentar. */
+    AI_GENERATION_FAILED = "AI_GENERATION_FAILED",
+    /** 503: la IA respondió algo que no se pudo leer como `{ explanation, rules }`. Reintentar. */
+    AI_RESPONSE_UNPARSEABLE = "AI_RESPONSE_UNPARSEABLE",
+    /** 503: la IA no contestó dentro del presupuesto de tiempo (el gateway corta a los 29 s). Reintentar. */
+    AI_GENERATION_TIMEOUT = "AI_GENERATION_TIMEOUT"
 }

package/bin/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum.js

@@ -55,4 +55,14 @@ var RewardsEligibilityErrorCodeEnum;
     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/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

@@ -31,6 +31,7 @@ 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';
@@ -51,6 +52,9 @@ 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';

package/bin/rewardsEligibility/index.js

@@ -53,6 +53,7 @@ __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);
@@ -73,6 +74,9 @@ __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);

package/package.json

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

package/src/rewardsEligibility/constants/BackofficeLimits.ts

@@ -10,3 +10,7 @@ export const REQUEST_ID_PATTERN = /^[A-Za-z0-9_-]{8,64}$/;
 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/backoffice/GenerateRulesRequest.ts

@@ -0,0 +1,33 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsObject, IsOptional, ValidateNested } from 'class-validator';
+import { JsonValue } from '../../../common';
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+import { RULES_CHAT_MAX_TURNS_HARD } from '../../constants/BackofficeLimits';
+import { RulesChatTurn } from './RulesChatTurn';
+
+/**
+ * `POST /rules/generate`: el chat del editor de reglas. El lambda arma el prompt con el catálogo de fuentes y ESTE contrato de entrada
+ * (qué sujetos `DIRECTORY` y qué campos de `input` existen), genera `{ match, groups[] }` y lo valida con el mismo `validateRule` de la evaluación.
+ */
+export class GenerateRulesRequest {
+    /** Del turno más viejo al más nuevo; el último es del admin (`user`). Entre 1 y 10 turnos (el lambda responde `AI_CHAT_HISTORY_EMPTY` / `AI_CHAT_HISTORY_TOO_LONG`). */
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(RULES_CHAT_MAX_TURNS_HARD)
+    @ValidateNested({ each: true })
+    @Type(() => RulesChatTurn)
+    history: RulesChatTurn[];
+
+    /** Las reglas que el editor tiene ahora (`{ match, groups[] }`), para refinarlas. Ausente = regla nueva. */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    currentRules?: { [key: string]: JsonValue };
+
+    /** Contrato de entrada de la evaluación que se está editando (`InputField[]`, dominio `dynamicForm`): de aquí salen los `subject` y los campos de la fuente `input`. */
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(30)
+    @IsObject({ each: true })
+    inputs: InputField[];
+}

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

@@ -0,0 +1,17 @@
+import { JsonValue } from '../../../common';
+
+/**
+ * Respuesta de `POST /rules/generate`. Tres casos:
+ * - Reglas listas: `valid: true` + `rules` (ya validadas contra el catálogo y los inputs: el editor puede cargarlas tal cual).
+ * - La IA pidió una aclaración (o no podía con lo pedido): `valid: true`, SIN `rules`; la pregunta va en `explanation`.
+ * - La IA generó reglas que no pasaron la validación ni tras el reintento: `valid: false`, SIN `rules`, con `problems`.
+ */
+export class GenerateRulesResponse {
+    /** Qué hizo (o qué preguntó) la IA, en español. Siempre viene. */
+    explanation: string;
+    /** `{ match, groups[] }` de `@fiado/rules-engine`. */
+    rules?: { [key: string]: JsonValue };
+    valid: boolean;
+    /** Mensajes legibles de la última salida inválida. Solo con `valid: false`. */
+    problems?: string[];
+}

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

@@ -10,8 +10,12 @@ export class RuleCatalogFieldResponse {
     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 }[];
+    /** Valores posibles si es un enum (con qué significa cada uno, si se sabe). */
+    options?: { value: string; label: string; description?: string }[];
+    /** Qué es este campo, en una frase (tooltip del editor). */
+    description?: string;
+    /** Frases de ejemplo que típicamente piden este campo (ayuda del chat de IA). */
+    examplePhrases?: string[];
 }
 
 export class RuleCatalogSourceResponse {

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

@@ -0,0 +1,17 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsString, MaxLength } from 'class-validator';
+import { RULES_CHAT_TURN_MAX_LENGTH } from '../../constants/BackofficeLimits';
+import { RulesChatRoleEnum } from '../../enums/RulesChatRoleEnum';
+
+/** Un turno del chat que genera reglas con IA. */
+export class RulesChatTurn {
+    @Expose()
+    @IsEnum(RulesChatRoleEnum)
+    role: RulesChatRoleEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(RULES_CHAT_TURN_MAX_LENGTH)
+    content: string;
+}

package/src/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum.ts

@@ -52,4 +52,14 @@ export enum RewardsEligibilityErrorCodeEnum {
     EXPORT_TOO_LARGE = 'EXPORT_TOO_LARGE',
     /** 503: la tabla de métricas no responde o no existe aún. */
     METRICS_UNAVAILABLE = 'METRICS_UNAVAILABLE',
+    /** 400: `POST /rules/generate` sin ningún turno de chat. */
+    AI_CHAT_HISTORY_EMPTY = 'AI_CHAT_HISTORY_EMPTY',
+    /** 400: el chat tiene más de 10 turnos (se acota el prompt). */
+    AI_CHAT_HISTORY_TOO_LONG = 'AI_CHAT_HISTORY_TOO_LONG',
+    /** 503: el motor de IA no respondió o falló. Reintentar. */
+    AI_GENERATION_FAILED = 'AI_GENERATION_FAILED',
+    /** 503: la IA respondió algo que no se pudo leer como `{ explanation, rules }`. Reintentar. */
+    AI_RESPONSE_UNPARSEABLE = 'AI_RESPONSE_UNPARSEABLE',
+    /** 503: la IA no contestó dentro del presupuesto de tiempo (el gateway corta a los 29 s). Reintentar. */
+    AI_GENERATION_TIMEOUT = 'AI_GENERATION_TIMEOUT',
 }

package/src/rewardsEligibility/enums/RulesChatRoleEnum.ts

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

package/src/rewardsEligibility/index.ts

@@ -42,6 +42,7 @@ export * from './dtos/EvaluationTrigger';
 //Backoffice (fase 3): enums, constantes y DTOs
 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';
@@ -62,6 +63,9 @@ 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';