@fiado/type-kit 3.517.0 → 3.519.0

package/_test_/unit/retailWizard/fixtures/saleWithoutPhone.strict.ts

@@ -0,0 +1,57 @@
+import { SaleTypeEnum } from '../../../../src/retailWizard/enums/SaleTypeEnum';
+import { SaleFinancierEnum } from '../../../../src/retailWizard/enums/SaleFinancierEnum';
+import type { Sale } from '../../../../src/retailWizard/dtos/Sale';
+import type { SaleCompletedV1 } from '../../../../src/retailWizard/events/SaleCompletedV1';
+import type { SaleCompletedV2 } from '../../../../src/retailWizard/events/SaleCompletedV2';
+import type { CommissionSaleInput } from '../../../../src/retailCommission/dtos/CommissionAccrual';
+
+// Venta de contado sin teléfono; el test lo compila con strict, como los consumidores.
+export const saleSku: Sale['sku'] = null;
+
+export const completedV1: SaleCompletedV1 = {
+  saleId: 's-1',
+  folio: 'LG-T001-VTA-abcde-2026W40',
+  retailerId: 'r-1',
+  storeId: 'st-1',
+  retailCustomerId: 'c-1',
+  sku: null,
+  imei: null,
+  amountCents: 35000,
+  type: SaleTypeEnum.CASH,
+  soldAt: '2026-10-08T12:00:00.000Z',
+  occurredAt: '2026-10-08T12:00:00.000Z',
+};
+
+export const completedV2: SaleCompletedV2 = {
+  saleId: 's-1',
+  folio: 'LG-T001-VTA-abcde-2026W40',
+  retailerId: 'r-1',
+  storeId: 'st-1',
+  sellerRetailUserId: 'u-1',
+  retailCustomerId: 'c-1',
+  sku: null,
+  brand: null,
+  imei: null,
+  amountCents: 35000,
+  equipmentPriceCents: null,
+  downPaymentCents: null,
+  creditId: null,
+  type: SaleTypeEnum.CASH,
+  externalProvider: null,
+  soldAt: '2026-10-08T12:00:00.000Z',
+  occurredAt: '2026-10-08T12:00:00.000Z',
+};
+
+export const commissionInput: CommissionSaleInput = {
+  saleId: 's-1',
+  sellerId: 'u-1',
+  retailerId: 'r-1',
+  storeId: 'st-1',
+  sku: null,
+  brand: null,
+  equipmentPriceCents: null,
+  amountCents: 35000,
+  financier: Object.values(SaleFinancierEnum)[0],
+  paymentType: 'CASH',
+  soldAt: '2026-10-08T12:00:00.000Z',
+};

package/_test_/unit/retailWizard/saleWithoutPhone.test.ts

@@ -0,0 +1,46 @@
+import 'reflect-metadata';
+import * as path from 'path';
+import * as ts from 'typescript';
+import {
+  commissionInput,
+  completedV1,
+  completedV2,
+  saleSku,
+} from './fixtures/saleWithoutPhone.strict';
+
+const FIXTURE = path.join(__dirname, 'fixtures', 'saleWithoutPhone.strict.ts');
+
+// Los consumidores compilan con strict; sin strictNullChecks null cabe en string y no prueba nada.
+function strictDiagnostics(): string[] {
+  const program = ts.createProgram([FIXTURE], {
+    strict: true,
+    noEmit: true,
+    skipLibCheck: true,
+    experimentalDecorators: true,
+    emitDecoratorMetadata: true,
+    target: ts.ScriptTarget.ES2020,
+    module: ts.ModuleKind.CommonJS,
+    moduleResolution: ts.ModuleResolutionKind.Node10,
+  });
+  return ts
+    .getPreEmitDiagnostics(program)
+    .filter((d) => d.file?.fileName === FIXTURE)
+    .map((d) => ts.flattenDiagnosticMessageText(d.messageText, '\n'));
+}
+
+describe('venta sin teléfono — sku nullable', () => {
+  it('Sale, SaleCompletedV1/V2 y CommissionSaleInput aceptan sku null en strict', () => {
+    expect(strictDiagnostics()).toEqual([]);
+  });
+
+  it('el payload viaja con sku null', () => {
+    expect(saleSku).toBeNull();
+    expect(completedV2.sku).toBeNull();
+    expect(commissionInput.sku).toBeNull();
+  });
+
+  it('SaleCompletedV1 omite equipmentPriceCents sin equipo', () => {
+    expect(completedV1.sku).toBeNull();
+    expect(completedV1).not.toHaveProperty('equipmentPriceCents');
+  });
+});

package/_test_/unit/retailWizard/saleWithoutPhoneLines.test.ts

@@ -0,0 +1,82 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  LinePaymentTypeEnum,
+  RetailCommissionInboundMessage,
+  RetailCommissionInboundMessageTypeEnum,
+  SaleTypeEnum,
+  type WizardLineProduct,
+} from '../../../src/retailWizard';
+import { ItemTypeEnum, ProductCategoryEnum, TrackingModeEnum } from '../../../src/retailCatalog';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf(payload: object): string[] {
+  return paths(validateSync(plainToInstance(RetailCommissionInboundMessage, payload) as object));
+}
+
+describe('venta sin teléfono — phoneCount en el mensaje a comisiones', () => {
+  const kit = {
+    lineId: 'L1',
+    sku: 'KIT-1',
+    qty: 1,
+    netCents: 349900,
+    itemType: ItemTypeEnum.PRODUCT,
+    category: ProductCategoryEnum.ACCESSORY,
+    tier: null,
+    brand: null,
+    paymentType: LinePaymentTypeEnum.CASH,
+  };
+  const message = (line: object) => ({
+    type: RetailCommissionInboundMessageTypeEnum.SALE_COMPLETED,
+    tenantId: 't',
+    retailerId: 'ret',
+    storeId: 'st',
+    saleId: 'sale-1',
+    sessionId: 'ses-1',
+    sellerRetailUserId: 'seller-1',
+    saleType: SaleTypeEnum.CASH,
+    externalProvider: null,
+    creditId: null,
+    soldAt: '2026-10-08T20:00:00.000Z',
+    occurredAt: '2026-10-08T20:00:00.000Z',
+    lines: [line],
+  });
+
+  it('un mensaje viejo sin phoneCount sigue validando', () => expect(errorsOf(message(kit))).toEqual([]));
+
+  it('acepta phoneCount en 0 y positivo', () => {
+    expect(errorsOf(message({ ...kit, phoneCount: 0 }))).toEqual([]);
+    expect(errorsOf(message({ ...kit, phoneCount: 2 }))).toEqual([]);
+  });
+
+  it('rechaza phoneCount negativo o no entero', () => {
+    expect(errorsOf(message({ ...kit, phoneCount: -1 }))).toEqual(['lines.0.phoneCount']);
+    expect(errorsOf(message({ ...kit, phoneCount: 1.5 }))).toEqual(['lines.0.phoneCount']);
+  });
+});
+
+describe('venta sin teléfono — itemType en la ficha de la línea de sesión', () => {
+  const base: WizardLineProduct = {
+    brand: 'Genérico',
+    model: 'Funda',
+    capacity: null,
+    color: null,
+    imageUrl: null,
+    tier: null,
+    category: ProductCategoryEnum.ACCESSORY,
+    trackingMode: TrackingModeEnum.QUANTITY,
+  };
+
+  it('acepta itemType y también su ausencia', () => {
+    const service: WizardLineProduct = { ...base, itemType: ItemTypeEnum.SERVICE };
+    expect(service.itemType).toBe(ItemTypeEnum.SERVICE);
+    expect(base.itemType).toBeUndefined();
+  });
+});

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/retailCommission/dtos/CommissionAccrual.d.ts

@@ -69,7 +69,8 @@ export interface CommissionSaleInput {
     sellerId: string;
     retailerId: string;
     storeId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono: se comisiona solo por accesorios. */
+    sku: string | null;
     brand: string | null;
     /**
      * 🔴 **La base de comisión es el PRECIO DEL EQUIPO, no lo cobrado en caja.**

package/bin/retailWizard/dtos/Sale.d.ts

@@ -20,8 +20,9 @@ export interface Sale {
     wizardSessionId: string;
     type: SaleTypeEnum;
     externalProvider: ExternalProviderEnum | null;
-    sku: string;
-    /** Líneas vendidas; `sku` e `imei` siguen siendo los del teléfono financiado o de la línea principal. */
+    /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */
+    sku: string | null;
+    /** Líneas vendidas; `sku` e `imei` son los del teléfono, o `null` si la venta no lleva teléfono. */
     lines?: SaleLine[];
     /** SKUs de líneas y componentes, para filtrar ventas por SKU. */
     skus?: string[];

package/bin/retailWizard/dtos/WizardLineProduct.d.ts

@@ -1,3 +1,4 @@
+import type { ItemTypeEnum } from '../../retailCatalog/enums/ItemTypeEnum';
 import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../retailCatalog/enums/TrackingModeEnum';
@@ -12,4 +13,6 @@ export interface WizardLineProduct {
     tier: ProductTierEnum | null;
     category: ProductCategoryEnum;
     trackingMode: TrackingModeEnum;
+    /** Producto físico o servicio; ausente en líneas viejas (el consumidor lo toma como PRODUCT). */
+    itemType?: ItemTypeEnum;
 }

package/bin/retailWizard/events/RetailCommissionInboundMessage.d.ts

@@ -21,6 +21,8 @@ export declare class RetailCommissionInboundLine {
     brand: string | null;
     paymentType: LinePaymentTypeEnum;
     role?: WizardLineRoleEnum;
+    /** Teléfonos que trae la línea (kit), congelados al cerrar; ausente en mensajes viejos. */
+    phoneCount?: number;
 }
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 export declare class RetailCommissionInboundMessage {

package/bin/retailWizard/events/RetailCommissionInboundMessage.js

@@ -72,6 +72,12 @@ __decorate([
     (0, class_validator_1.IsEnum)(WizardLineRoleEnum_1.WizardLineRoleEnum),
     __metadata("design:type", String)
 ], RetailCommissionInboundLine.prototype, "role", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailCommissionInboundLine.prototype, "phoneCount", void 0);
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 class RetailCommissionInboundMessage {
 }

package/bin/retailWizard/events/SaleCompletedV1.d.ts

@@ -10,7 +10,8 @@ export interface SaleCompletedV1 {
     retailerId: string;
     storeId: string;
     retailCustomerId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono. */
+    sku: string | null;
     imei: string | null;
     /**
      * Lo cobrado en caja al cerrar: enganche + lo no financiado (en contado, el total).
@@ -22,7 +23,7 @@ export interface SaleCompletedV1 {
      * sin `type` un crédito con $1,300 de enganche era indistinguible de un contado de $1,300.
      */
     type?: SaleTypeEnum;
-    /** Precio de lista del equipo; en contado coincide con `amountCents`. */
+    /** Precio de lista del equipo; en contado coincide con `amountCents`. Sin equipo se omite. */
     equipmentPriceCents?: number;
     /** Enganche cobrado (solo `type=CREDIT`). */
     downPaymentCents?: number;

package/bin/retailWizard/events/SaleCompletedV2.d.ts

@@ -23,7 +23,8 @@ export interface SaleCompletedV2 {
     /** Quién vendió — el eje del cálculo de comisión. Es lo que más falta en la V1. */
     sellerRetailUserId: string;
     retailCustomerId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono. */
+    sku: string | null;
     /** Marca del equipo, del snapshot congelado al cerrar. `null` si no se pudo resolver. */
     brand: string | null;
     imei: string | null;

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.519.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/retailCommission/dtos/CommissionAccrual.ts

@@ -72,7 +72,8 @@ export interface CommissionSaleInput {
     sellerId: string;
     retailerId: string;
     storeId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono: se comisiona solo por accesorios. */
+    sku: string | null;
     brand: string | null;
     /**
      * 🔴 **La base de comisión es el PRECIO DEL EQUIPO, no lo cobrado en caja.**

package/src/retailWizard/dtos/Sale.ts

@@ -21,8 +21,9 @@ export interface Sale {
   wizardSessionId: string;
   type: SaleTypeEnum;
   externalProvider: ExternalProviderEnum | null;
-  sku: string;
-  /** Líneas vendidas; `sku` e `imei` siguen siendo los del teléfono financiado o de la línea principal. */
+  /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */
+  sku: string | null;
+  /** Líneas vendidas; `sku` e `imei` son los del teléfono, o `null` si la venta no lleva teléfono. */
   lines?: SaleLine[];
   /** SKUs de líneas y componentes, para filtrar ventas por SKU. */
   skus?: string[];

package/src/retailWizard/dtos/WizardLineProduct.ts

@@ -1,3 +1,4 @@
+import type { ItemTypeEnum } from '../../retailCatalog/enums/ItemTypeEnum';
 import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../retailCatalog/enums/TrackingModeEnum';
@@ -13,4 +14,6 @@ export interface WizardLineProduct {
     tier: ProductTierEnum | null;
     category: ProductCategoryEnum;
     trackingMode: TrackingModeEnum;
+    /** Producto físico o servicio; ausente en líneas viejas (el consumidor lo toma como PRODUCT). */
+    itemType?: ItemTypeEnum;
 }

package/src/retailWizard/events/RetailCommissionInboundMessage.ts

@@ -62,6 +62,12 @@ export class RetailCommissionInboundLine {
     @IsOptional()
     @IsEnum(WizardLineRoleEnum)
     role?: WizardLineRoleEnum;
+
+    /** Teléfonos que trae la línea (kit), congelados al cerrar; ausente en mensajes viejos. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    phoneCount?: number;
 }
 
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */

package/src/retailWizard/events/SaleCompletedV1.ts

@@ -11,7 +11,8 @@ export interface SaleCompletedV1 {
   retailerId: string;
   storeId: string;
   retailCustomerId: string;
-  sku: string;
+  /** `null` en la venta sin teléfono. */
+  sku: string | null;
   imei: string | null;
   /**
    * Lo cobrado en caja al cerrar: enganche + lo no financiado (en contado, el total).
@@ -23,7 +24,7 @@ export interface SaleCompletedV1 {
    * sin `type` un crédito con $1,300 de enganche era indistinguible de un contado de $1,300.
    */
   type?: SaleTypeEnum;
-  /** Precio de lista del equipo; en contado coincide con `amountCents`. */
+  /** Precio de lista del equipo; en contado coincide con `amountCents`. Sin equipo se omite. */
   equipmentPriceCents?: number;
   /** Enganche cobrado (solo `type=CREDIT`). */
   downPaymentCents?: number;

package/src/retailWizard/events/SaleCompletedV2.ts

@@ -24,7 +24,8 @@ export interface SaleCompletedV2 {
     /** Quién vendió — el eje del cálculo de comisión. Es lo que más falta en la V1. */
     sellerRetailUserId: string;
     retailCustomerId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono. */
+    sku: string | null;
     /** Marca del equipo, del snapshot congelado al cerrar. `null` si no se pudo resolver. */
     brand: string | null;
     imei: string | null;

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';