@fiado/type-kit 3.538.0 → 3.540.0

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

@@ -0,0 +1,6 @@
+/** Resultado de evaluar una regla para un sujeto (`POST /evaluate`). */
+export declare enum RulesOutcomeEnum {
+    MATCH = "MATCH",
+    NO_MATCH = "NO_MATCH",
+    ERROR = "ERROR"
+}

package/bin/rules/enums/RulesOutcomeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesOutcomeEnum = void 0;
+/** Resultado de evaluar una regla para un sujeto (`POST /evaluate`). */
+var RulesOutcomeEnum;
+(function (RulesOutcomeEnum) {
+    RulesOutcomeEnum["MATCH"] = "MATCH";
+    RulesOutcomeEnum["NO_MATCH"] = "NO_MATCH";
+    RulesOutcomeEnum["ERROR"] = "ERROR";
+})(RulesOutcomeEnum || (exports.RulesOutcomeEnum = RulesOutcomeEnum = {}));

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

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

package/bin/rules/enums/RulesValueTypeEnum.js

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

package/bin/rules/index.d.ts

@@ -0,0 +1,15 @@
+export * from './enums/RulesOutcomeEnum';
+export * from './enums/RulesGenerationStatusEnum';
+export * from './enums/RulesChatRoleEnum';
+export * from './enums/RulesValueTypeEnum';
+export * from './enums/RulesErrorCodeEnum';
+export * from './constants/RulesLimits';
+export * from './dtos/RulesCatalogResponse';
+export * from './dtos/ValidateRulesRequest';
+export * from './dtos/ValidateRulesResponse';
+export * from './dtos/RulesChatMessage';
+export * from './dtos/GenerateRulesRequest';
+export * from './dtos/GenerateRulesResponse';
+export * from './dtos/RulesTraceResponse';
+export * from './dtos/EvaluateRulesRequest';
+export * from './dtos/EvaluateRulesResponse';

package/bin/rules/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+//Enums
+__exportStar(require("./enums/RulesOutcomeEnum"), exports);
+__exportStar(require("./enums/RulesGenerationStatusEnum"), exports);
+__exportStar(require("./enums/RulesChatRoleEnum"), exports);
+__exportStar(require("./enums/RulesValueTypeEnum"), exports);
+__exportStar(require("./enums/RulesErrorCodeEnum"), exports);
+//Constants
+__exportStar(require("./constants/RulesLimits"), exports);
+//DTOs
+__exportStar(require("./dtos/RulesCatalogResponse"), exports);
+__exportStar(require("./dtos/ValidateRulesRequest"), exports);
+__exportStar(require("./dtos/ValidateRulesResponse"), exports);
+__exportStar(require("./dtos/RulesChatMessage"), exports);
+__exportStar(require("./dtos/GenerateRulesRequest"), exports);
+__exportStar(require("./dtos/GenerateRulesResponse"), exports);
+__exportStar(require("./dtos/RulesTraceResponse"), exports);
+__exportStar(require("./dtos/EvaluateRulesRequest"), exports);
+__exportStar(require("./dtos/EvaluateRulesResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -213,3 +213,6 @@ export * as DatalakeReports from './datalakeReports';
 
 // PdfRender: DTOs del lambda pdf-render-business (plantilla HTML → PDF multitenant y su backoffice).
 export * as PdfRender from './pdfRender';
+
+// Rules: DTOs del lambda central rules-business (catálogo, validación, generación con IA y evaluación de reglas).
+export * as Rules from './rules';

package/src/retailCustomer/dtos/requests/EnsureCustomerByPhoneRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches, MinLength } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/**
+ * POST /private/customers/ensure-by-phone — da de alta al cliente solo con su celular verificado,
+ * o devuelve el que ya existe con ese número.
+ */
+export class EnsureCustomerByPhoneRequest {
+    @Expose()
+    @IsString()
+    @Matches(regexPhoneMx, { message: 'phone debe tener 10 dígitos' })
+    phone!: string;
+
+    /** Tienda del primer contacto; no cambia si el cliente ya existía. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    originStoreId!: string;
+}

package/src/retailCustomer/dtos/responses/EnsureCustomerByPhoneResponse.ts

@@ -0,0 +1,6 @@
+import { CustomerResponse } from './CustomerResponse';
+
+/** Cliente resuelto por celular; `created` dice si esta llamada lo dio de alta. */
+export interface EnsureCustomerByPhoneResponse extends CustomerResponse {
+    created: boolean;
+}

package/src/retailCustomer/index.ts

@@ -24,6 +24,7 @@ export * from './dtos/requests/KycReviewRequest';
 export * from './dtos/requests/WelcomeAccreditationRequest';
 export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/requests/UpsertPromotionBonusRequest';
+export * from './dtos/requests/EnsureCustomerByPhoneRequest';
 
 // Response DTOs
 export * from './dtos/responses/CustomerResponse';
@@ -31,6 +32,7 @@ export * from './dtos/responses/Customer360Response';
 export * from './dtos/responses/WelcomeBonusResponse';
 export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './dtos/responses/PromotionBonusEntryResponse';
+export * from './dtos/responses/EnsureCustomerByPhoneResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/CustomerCreatedV1';

package/src/retailWizard/dtos/AccessorySaleLine.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsInt, IsOptional, IsString, Min, MinLength } from 'class-validator';
+
+/** Línea del carrito de accesorios; el precio lo pone el catálogo, no el request. */
+export class AccessorySaleLine {
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  sku!: string;
+
+  @Expose()
+  @IsInt()
+  @Min(1)
+  qty!: number;
+
+  /** Serie de cada pieza cuando el SKU se rastrea por pieza; ausente si se rastrea por cantidad. */
+  @Expose()
+  @IsOptional()
+  @IsArray()
+  @ArrayMaxSize(100)
+  @IsString({ each: true })
+  identifiers?: string[];
+}

package/src/retailWizard/dtos/Sale.ts

@@ -1,6 +1,7 @@
 import type { SaleTypeEnum } from '../enums/SaleTypeEnum';
 import type { SaleStatusEnum } from '../enums/SaleStatusEnum';
 import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import type { SaleChannelEnum } from '../enums/SaleChannelEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
@@ -18,7 +19,10 @@ export interface Sale {
   storeId: string;
   sellerRetailUserId: string;
   retailCustomerId: string;
-  wizardSessionId: string;
+  /** Sesión del wizard que cerró la venta; ausente en la venta de mostrador. */
+  wizardSessionId?: string;
+  /** Canal de la venta; ausente = `WIZARD` (ventas anteriores al campo). */
+  saleChannel?: SaleChannelEnum;
   type: SaleTypeEnum;
   externalProvider: ExternalProviderEnum | null;
   /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */

package/src/retailWizard/dtos/requests/CreateAccessorySaleRequest.ts

@@ -0,0 +1,64 @@
+import { Expose, Type } from 'class-transformer';
+import {
+  ArrayMaxSize,
+  ArrayMinSize,
+  IsArray,
+  IsBoolean,
+  IsDefined,
+  IsEnum,
+  IsInt,
+  IsOptional,
+  IsString,
+  Min,
+  MinLength,
+  ValidateNested,
+} from 'class-validator';
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+import { AccessorySaleLine } from '../AccessorySaleLine';
+
+/**
+ * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
+ */
+export class CreateAccessorySaleRequest {
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  otpChallengeId!: string;
+
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ArrayMaxSize(50)
+  @ValidateNested({ each: true })
+  @Type(() => AccessorySaleLine)
+  lines!: AccessorySaleLine[];
+
+  @Expose()
+  @IsEnum(SalePaymentMethodEnum)
+  paymentMethod!: SalePaymentMethodEnum;
+
+  @Expose()
+  @IsInt()
+  @Min(0)
+  amountCents!: number;
+
+  @Expose()
+  @IsDefined()
+  @ValidateNested()
+  @Type(() => SalePaymentDetail)
+  paymentDetail!: SalePaymentDetail;
+
+  /** El cliente aceptó el aviso de privacidad; sin `true` el back responde 400 PRIVACY_NOTICE_REQUIRED. */
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  privacyNoticeAccepted?: boolean;
+
+  /** Versión del aviso de privacidad que se mostró. */
+  @Expose()
+  @IsString()
+  @MinLength(1)
+  privacyNoticeVersion!: string;
+}

package/src/retailWizard/dtos/requests/PortalCancelSaleRequest.ts

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsBoolean, IsOptional, IsString, MaxLength, MinLength, ValidateNested } from 'class-validator';
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
+
+/**
+ * POST /portal/sales/:saleId/cancel — el vendedor cancela una venta cerrada de su tienda, dentro de la
+ * ventana. Mismas validaciones que `BackofficeCancelSaleRequest`, sin la excepción de cancelación tardía.
+ */
+export class PortalCancelSaleRequest {
+    @Expose()
+    @IsString()
+    @MinLength(10)
+    @MaxLength(200)
+    reason!: string;
+
+    /** Equipo o piezas confirmados en tienda; ausente cuenta como no confirmado. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    equipmentVerified?: boolean;
+
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ReturnPieceCondition)
+    returnConditions?: ReturnPieceCondition[];
+}

package/src/retailWizard/dtos/requests/SendAccessoryOtpRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/** POST /wizard/accessory-sales/otp — manda el OTP al celular del cliente del mostrador. */
+export class SendAccessoryOtpRequest {
+  @Expose()
+  @IsString()
+  @Matches(regexPhoneMx, { message: 'phone debe tener 10 dígitos' })
+  phone!: string;
+}

package/src/retailWizard/dtos/requests/VerifyAccessoryOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/accessory-sales/otp/{otpChallengeId}/verify — código que dicta el cliente. */
+export class VerifyAccessoryOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

package/src/retailWizard/dtos/responses/AccessoryOtpChallenge.ts

@@ -0,0 +1,7 @@
+/** Reto OTP del mostrador de accesorios (send y resend). `phoneMasked` muestra solo los últimos 4 dígitos. */
+export interface AccessoryOtpChallenge {
+  otpChallengeId: string;
+  phoneMasked: string;
+  expiresAt: string;
+  resendAvailableAt: string;
+}

package/src/retailWizard/dtos/responses/VerifyAccessoryOtpResponse.ts

@@ -0,0 +1,7 @@
+/** Reto verificado: ampara una sola venta hasta `usableUntil`. */
+export interface VerifyAccessoryOtpResponse {
+  otpChallengeId: string;
+  verified: true;
+  verifiedAt: string;
+  usableUntil: string;
+}

package/src/retailWizard/enums/SaleChannelEnum.ts

@@ -0,0 +1,5 @@
+/** Canal por el que se cerró la venta: el wizard por sesión o el mostrador de accesorios. */
+export enum SaleChannelEnum {
+    WIZARD = 'WIZARD',
+    ACCESSORY_COUNTER = 'ACCESSORY_COUNTER',
+}

package/src/retailWizard/index.ts

@@ -32,6 +32,7 @@ export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
 export * from './enums/EmailStateEnum';
+export * from './enums/SaleChannelEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -57,6 +58,7 @@ export * from './dtos/WizardFinancingPreview';
 export * from './dtos/WizardReservedLine';
 export * from './dtos/WizardGiftLine';
 export * from './dtos/SaleLine';
+export * from './dtos/AccessorySaleLine';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';
@@ -108,6 +110,9 @@ export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/requests/SendEmailOtpRequest';
 export * from './dtos/requests/VerifyEmailOtpRequest';
+export * from './dtos/requests/SendAccessoryOtpRequest';
+export * from './dtos/requests/VerifyAccessoryOtpRequest';
+export * from './dtos/requests/CreateAccessorySaleRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';
@@ -128,6 +133,8 @@ export * from './dtos/responses/ProspectResumeResponse';
 export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
+export * from './dtos/responses/AccessoryOtpChallenge';
+export * from './dtos/responses/VerifyAccessoryOtpResponse';
 
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums
@@ -160,6 +167,7 @@ export * from './dtos/requests/ApplySaleExceptionRequest';
 export * from './dtos/requests/AddSaleExceptionNoteRequest';
 export * from './dtos/requests/RunSalesReportRequest';
 export * from './dtos/requests/BackofficeCancelSaleRequest';
+export * from './dtos/requests/PortalCancelSaleRequest';
 
 // Responses
 export * from './dtos/responses/BackofficeSalesStatsResponse';

package/src/rules/constants/RulesLimits.ts

@@ -0,0 +1,8 @@
+/** Máximo de sujetos por llamada a `POST /evaluate` (si no, 400 `TOO_MANY_SUBJECTS`). */
+export const RULES_MAX_SUBJECTS_PER_CALL = 100;
+/** Fuente especial: datos que el llamador manda en la llamada, no se resuelven ni se piden en `items`. */
+export const RULES_INPUT_SOURCE = 'input';
+/** Máximo de campos del contrato de `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;

package/src/rules/dtos/EvaluateRulesRequest.ts

@@ -0,0 +1,67 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsISO8601, IsObject, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { JsonValue } from '../../common';
+import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
+
+/** A quién se le evalúa la regla. */
+export class RulesEvaluationSubject {
+    @Expose()
+    @IsString()
+    directoryId: string;
+
+    /** Otros participantes del evento: llegan al motor como `ctx.subjects[key] = { directoryId }`. */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    subjects?: Record<string, { directoryId: string }>;
+
+    /** Datos escalares del evento: forman la fuente `input`. */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    inputs?: Record<string, DynamicFormValue>;
+}
+
+export class RuleToEvaluate {
+    @Expose()
+    @IsString()
+    id: string;
+
+    /** La regla (`{ match, groups[] }`). */
+    @Expose()
+    @IsObject()
+    rule: { [key: string]: JsonValue };
+}
+
+/** `POST /evaluate`. El límite de 100 sujetos lo valida el lambda (400 `TOO_MANY_SUBJECTS`), no el DTO. */
+export class EvaluateRulesRequest {
+    /** Quién llama (solo logs y métricas). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    consumer?: string;
+
+    /** Ids de ítems del catálogo (`source:key`) que las reglas pueden usar. */
+    @Expose()
+    @IsArray()
+    @IsString({ each: true })
+    items: string[];
+
+    @Expose()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => RuleToEvaluate)
+    rules: RuleToEvaluate[];
+
+    @Expose()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => RulesEvaluationSubject)
+    subjects: RulesEvaluationSubject[];
+
+    /** Fecha ISO 8601; por defecto, el momento de la llamada. */
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    referenceAt?: string;
+}

package/src/rules/dtos/EvaluateRulesResponse.ts

@@ -0,0 +1,19 @@
+import { RulesOutcomeEnum } from '../enums/RulesOutcomeEnum';
+import { RulesTraceResponse } from './RulesTraceResponse';
+
+/** Resultado de una regla para un sujeto. */
+export class RuleEvaluationResult {
+    ruleId: string;
+    /** Posición del sujeto en `EvaluateRulesRequest.subjects`. */
+    subjectIndex: number;
+    directoryId: string;
+    outcome: RulesOutcomeEnum;
+    trace?: RulesTraceResponse;
+    /** Solo si `outcome` es `ERROR`. */
+    errorMessage?: string;
+}
+
+/** `POST /evaluate`: ordenado por regla y, dentro de cada regla, por `subjectIndex`. */
+export class EvaluateRulesResponse {
+    results: RuleEvaluationResult[];
+}

package/src/rules/dtos/GenerateRulesRequest.ts

@@ -0,0 +1,49 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsObject, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { JsonValue } from '../../common';
+import { InputField } from '../../dynamicForm/dtos/InputField';
+import { RULES_MAX_INPUT_CONTRACT } from '../constants/RulesLimits';
+import { RulesChatMessage } from './RulesChatMessage';
+
+/** `POST /generate`: el chat que genera una regla con IA sobre el catálogo de los ítems indicados. */
+export class GenerateRulesRequest {
+    /** Quién llama (solo logs y métricas). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    consumer?: string;
+
+    /** Ids de ítems del catálogo (`source:key`) que la IA puede usar. */
+    @Expose()
+    @IsArray()
+    @IsString({ each: true })
+    items: string[];
+
+    /** Contrato de la fuente `input` (`InputField[]`, dominio `dynamicForm`). */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(RULES_MAX_INPUT_CONTRACT)
+    @IsObject({ each: true })
+    inputContract?: InputField[];
+
+    /** Del turno más viejo al más nuevo; el último es del usuario. */
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => RulesChatMessage)
+    messages: RulesChatMessage[];
+
+    /** Contexto libre del llamador para el prompt. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    context?: string;
+
+    /** La regla que el editor tiene ahora, para refinarla. Ausente = regla nueva. */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    currentRule?: { [key: string]: JsonValue };
+}

package/src/rules/dtos/GenerateRulesResponse.ts

@@ -0,0 +1,11 @@
+import { JsonValue } from '../../common';
+import { RulesGenerationStatusEnum } from '../enums/RulesGenerationStatusEnum';
+
+/** Resultado de `POST /generate`. `status: OK` con `rule: null` = la IA hizo una pregunta (sin regla). */
+export class GenerateRulesResponse {
+    status: RulesGenerationStatusEnum;
+    rule: { [key: string]: JsonValue } | null;
+    explanation: string;
+    /** Problemas de validación (vacío salvo `FAILED`). */
+    errors: string[];
+}

package/src/rules/dtos/RulesCatalogResponse.ts

@@ -0,0 +1,35 @@
+import { InputField } from '../../dynamicForm/dtos/InputField';
+import { RulesValueTypeEnum } from '../enums/RulesValueTypeEnum';
+
+/** Un campo que un ítem del catálogo resuelve para las reglas. */
+export class RulesCatalogFieldResponse {
+    field: string;
+    label: string;
+    valueType: RulesValueTypeEnum;
+    /** Operadores válidos para este campo (`GT`, `LTE`, `IN`…). */
+    operators: string[];
+    /** Params del campo (ej. ventana y moneda de `sumAmount`), como formulario dinámico. */
+    params?: InputField[];
+    /** Valores posibles si es un enum (con qué significa cada uno, si se sabe). */
+    options?: { value: string; label: string; description?: string }[];
+    /** Qué es este campo, en una frase. */
+    description?: string;
+    /** Frases de ejemplo que típicamente piden este campo (ayuda del chat de IA). */
+    examplePhrases?: string[];
+}
+
+/** Un ítem del catálogo: una fuente + una llave de búsqueda (`source:key`). */
+export class RulesCatalogItemResponse {
+    id: string;
+    source: string;
+    key: string;
+    label: string;
+    description: string;
+    fields: RulesCatalogFieldResponse[];
+}
+
+export class RulesCatalogResponse {
+    items: RulesCatalogItemResponse[];
+    /** Etiqueta legible de cada operador (`GTE` → «≥»). */
+    operators: Record<string, string>;
+}

package/src/rules/dtos/RulesChatMessage.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/RulesLimits';
+import { RulesChatRoleEnum } from '../enums/RulesChatRoleEnum';
+
+/** Un turno del chat que genera reglas con IA. */
+export class RulesChatMessage {
+    @Expose()
+    @IsEnum(RulesChatRoleEnum)
+    role: RulesChatRoleEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(RULES_CHAT_TURN_MAX_LENGTH)
+    content: string;
+}

package/src/rules/dtos/RulesTraceResponse.ts

@@ -0,0 +1,32 @@
+import { JsonValue } from '../../common';
+import { RulesOutcomeEnum } from '../enums/RulesOutcomeEnum';
+
+/**
+ * Una condición evaluada: qué se esperaba y qué se encontró.
+ * Sin `origin`/`asOf`: el central no sabe de dónde salió el dato; el consumidor (rewards) los agrega.
+ */
+export class RulesTraceConditionResponse {
+    source: string;
+    subject?: string;
+    field: string;
+    params?: Record<string, string | number | boolean>;
+    op: string;
+    expected: JsonValue;
+    actual?: JsonValue;
+    outcome: RulesOutcomeEnum;
+    /** Solo si `outcome` es `ERROR`. */
+    error?: { code: string; message: string };
+}
+
+export class RulesTraceGroupResponse {
+    match: 'ALL' | 'ANY';
+    outcome: RulesOutcomeEnum;
+    conditions: RulesTraceConditionResponse[];
+}
+
+/** Traza completa de una evaluación: por qué cumplió o no. */
+export class RulesTraceResponse {
+    match: 'ALL' | 'ANY';
+    outcome: RulesOutcomeEnum;
+    groups: RulesTraceGroupResponse[];
+}