@fiado/type-kit 3.537.0 → 3.539.0

package/bin/index.d.ts

@@ -65,6 +65,7 @@ export * as Event from './event';
 export * as NotificationWS from './notificationWS';
 export * as ZendeskMessaging from './zendeskMessaging';
 export * as ReferralBusiness from './referral-business';
+export * as UsMarketGrowthBusiness from './usmarketgrowth-business';
 export * as ComissionBusiness from './comission-business';
 export * as Credit from './credit';
 export * as CreditEngine from './creditEngine';
@@ -126,3 +127,4 @@ export * as Rewards from './rewards';
 export * as RewardsEligibility from './rewardsEligibility';
 export * as DatalakeReports from './datalakeReports';
 export * as PdfRender from './pdfRender';
+export * as Rules from './rules';

package/bin/index.js

@@ -37,8 +37,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
-exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = void 0;
-exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = void 0;
+exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = void 0;
+exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -106,6 +106,7 @@ exports.Event = __importStar(require("./event"));
 exports.NotificationWS = __importStar(require("./notificationWS"));
 exports.ZendeskMessaging = __importStar(require("./zendeskMessaging"));
 exports.ReferralBusiness = __importStar(require("./referral-business"));
+exports.UsMarketGrowthBusiness = __importStar(require("./usmarketgrowth-business"));
 exports.ComissionBusiness = __importStar(require("./comission-business"));
 exports.Credit = __importStar(require("./credit"));
 exports.CreditEngine = __importStar(require("./creditEngine"));
@@ -248,3 +249,5 @@ exports.RewardsEligibility = __importStar(require("./rewardsEligibility"));
 exports.DatalakeReports = __importStar(require("./datalakeReports"));
 // PdfRender: DTOs del lambda pdf-render-business (plantilla HTML → PDF multitenant y su backoffice).
 exports.PdfRender = __importStar(require("./pdfRender"));
+// Rules: DTOs del lambda central rules-business (catálogo, validación, generación con IA y evaluación de reglas).
+exports.Rules = __importStar(require("./rules"));

package/bin/rules/constants/RulesLimits.d.ts

@@ -0,0 +1,8 @@
+/** Máximo de sujetos por llamada a `POST /evaluate` (si no, 400 `TOO_MANY_SUBJECTS`). */
+export declare 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 declare const RULES_INPUT_SOURCE = "input";
+/** Máximo de campos del contrato de `input`. */
+export declare const RULES_MAX_INPUT_CONTRACT = 30;
+/** Largo máximo (caracteres) del contenido de un turno del chat de `POST /generate`. */
+export declare const RULES_CHAT_TURN_MAX_LENGTH = 4000;

package/bin/rules/constants/RulesLimits.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RULES_CHAT_TURN_MAX_LENGTH = exports.RULES_MAX_INPUT_CONTRACT = exports.RULES_INPUT_SOURCE = exports.RULES_MAX_SUBJECTS_PER_CALL = void 0;
+/** Máximo de sujetos por llamada a `POST /evaluate` (si no, 400 `TOO_MANY_SUBJECTS`). */
+exports.RULES_MAX_SUBJECTS_PER_CALL = 100;
+/** Fuente especial: datos que el llamador manda en la llamada, no se resuelven ni se piden en `items`. */
+exports.RULES_INPUT_SOURCE = 'input';
+/** Máximo de campos del contrato de `input`. */
+exports.RULES_MAX_INPUT_CONTRACT = 30;
+/** Largo máximo (caracteres) del contenido de un turno del chat de `POST /generate`. */
+exports.RULES_CHAT_TURN_MAX_LENGTH = 4000;

package/bin/rules/dtos/EvaluateRulesRequest.d.ts

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

package/bin/rules/dtos/EvaluateRulesRequest.js

@@ -0,0 +1,84 @@
+"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.EvaluateRulesRequest = exports.RuleToEvaluate = exports.RulesEvaluationSubject = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** A quién se le evalúa la regla. */
+class RulesEvaluationSubject {
+}
+exports.RulesEvaluationSubject = RulesEvaluationSubject;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RulesEvaluationSubject.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], RulesEvaluationSubject.prototype, "subjects", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], RulesEvaluationSubject.prototype, "inputs", void 0);
+class RuleToEvaluate {
+}
+exports.RuleToEvaluate = RuleToEvaluate;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RuleToEvaluate.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], RuleToEvaluate.prototype, "rule", void 0);
+/** `POST /evaluate`. El límite de 100 sujetos lo valida el lambda (400 `TOO_MANY_SUBJECTS`), no el DTO. */
+class EvaluateRulesRequest {
+}
+exports.EvaluateRulesRequest = EvaluateRulesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], EvaluateRulesRequest.prototype, "consumer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], EvaluateRulesRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RuleToEvaluate),
+    __metadata("design:type", Array)
+], EvaluateRulesRequest.prototype, "rules", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RulesEvaluationSubject),
+    __metadata("design:type", Array)
+], EvaluateRulesRequest.prototype, "subjects", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], EvaluateRulesRequest.prototype, "referenceAt", void 0);

package/bin/rules/dtos/EvaluateRulesResponse.d.ts

@@ -0,0 +1,17 @@
+import { RulesOutcomeEnum } from '../enums/RulesOutcomeEnum';
+import { RulesTraceResponse } from './RulesTraceResponse';
+/** Resultado de una regla para un sujeto. */
+export declare 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 declare class EvaluateRulesResponse {
+    results: RuleEvaluationResult[];
+}

package/bin/rules/dtos/EvaluateRulesResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluateRulesResponse = exports.RuleEvaluationResult = void 0;
+/** Resultado de una regla para un sujeto. */
+class RuleEvaluationResult {
+}
+exports.RuleEvaluationResult = RuleEvaluationResult;
+/** `POST /evaluate`: ordenado por regla y, dentro de cada regla, por `subjectIndex`. */
+class EvaluateRulesResponse {
+}
+exports.EvaluateRulesResponse = EvaluateRulesResponse;

package/bin/rules/dtos/GenerateRulesRequest.d.ts

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

package/bin/rules/dtos/GenerateRulesRequest.js

@@ -0,0 +1,60 @@
+"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 RulesLimits_1 = require("../constants/RulesLimits");
+const RulesChatMessage_1 = require("./RulesChatMessage");
+/** `POST /generate`: el chat que genera una regla con IA sobre el catálogo de los ítems indicados. */
+class GenerateRulesRequest {
+}
+exports.GenerateRulesRequest = GenerateRulesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GenerateRulesRequest.prototype, "consumer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], GenerateRulesRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_INPUT_CONTRACT),
+    (0, class_validator_1.IsObject)({ each: true }),
+    __metadata("design:type", Array)
+], GenerateRulesRequest.prototype, "inputContract", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RulesChatMessage_1.RulesChatMessage),
+    __metadata("design:type", Array)
+], GenerateRulesRequest.prototype, "messages", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GenerateRulesRequest.prototype, "context", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], GenerateRulesRequest.prototype, "currentRule", void 0);

package/bin/rules/dtos/GenerateRulesResponse.d.ts

@@ -0,0 +1,12 @@
+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 declare class GenerateRulesResponse {
+    status: RulesGenerationStatusEnum;
+    rule: {
+        [key: string]: JsonValue;
+    } | null;
+    explanation: string;
+    /** Problemas de validación (vacío salvo `FAILED`). */
+    errors: string[];
+}

package/bin/rules/dtos/GenerateRulesResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateRulesResponse = void 0;
+/** Resultado de `POST /generate`. `status: OK` con `rule: null` = la IA hizo una pregunta (sin regla). */
+class GenerateRulesResponse {
+}
+exports.GenerateRulesResponse = GenerateRulesResponse;

package/bin/rules/dtos/RulesCatalogResponse.d.ts

@@ -0,0 +1,36 @@
+import { InputField } from '../../dynamicForm/dtos/InputField';
+import { RulesValueTypeEnum } from '../enums/RulesValueTypeEnum';
+/** Un campo que un ítem del catálogo resuelve para las reglas. */
+export declare 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 declare class RulesCatalogItemResponse {
+    id: string;
+    source: string;
+    key: string;
+    label: string;
+    description: string;
+    fields: RulesCatalogFieldResponse[];
+}
+export declare class RulesCatalogResponse {
+    items: RulesCatalogItemResponse[];
+    /** Etiqueta legible de cada operador (`GTE` → «≥»). */
+    operators: Record<string, string>;
+}

package/bin/rules/dtos/RulesCatalogResponse.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesCatalogResponse = exports.RulesCatalogItemResponse = exports.RulesCatalogFieldResponse = void 0;
+/** Un campo que un ítem del catálogo resuelve para las reglas. */
+class RulesCatalogFieldResponse {
+}
+exports.RulesCatalogFieldResponse = RulesCatalogFieldResponse;
+/** Un ítem del catálogo: una fuente + una llave de búsqueda (`source:key`). */
+class RulesCatalogItemResponse {
+}
+exports.RulesCatalogItemResponse = RulesCatalogItemResponse;
+class RulesCatalogResponse {
+}
+exports.RulesCatalogResponse = RulesCatalogResponse;

package/bin/rules/dtos/RulesChatMessage.d.ts

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

package/bin/rules/dtos/RulesChatMessage.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.RulesChatMessage = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RulesLimits_1 = require("../constants/RulesLimits");
+const RulesChatRoleEnum_1 = require("../enums/RulesChatRoleEnum");
+/** Un turno del chat que genera reglas con IA. */
+class RulesChatMessage {
+}
+exports.RulesChatMessage = RulesChatMessage;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RulesChatRoleEnum_1.RulesChatRoleEnum),
+    __metadata("design:type", String)
+], RulesChatMessage.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)(RulesLimits_1.RULES_CHAT_TURN_MAX_LENGTH),
+    __metadata("design:type", String)
+], RulesChatMessage.prototype, "content", void 0);

package/bin/rules/dtos/RulesTraceResponse.d.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 declare 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 declare class RulesTraceGroupResponse {
+    match: 'ALL' | 'ANY';
+    outcome: RulesOutcomeEnum;
+    conditions: RulesTraceConditionResponse[];
+}
+/** Traza completa de una evaluación: por qué cumplió o no. */
+export declare class RulesTraceResponse {
+    match: 'ALL' | 'ANY';
+    outcome: RulesOutcomeEnum;
+    groups: RulesTraceGroupResponse[];
+}

package/bin/rules/dtos/RulesTraceResponse.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesTraceResponse = exports.RulesTraceGroupResponse = exports.RulesTraceConditionResponse = void 0;
+/**
+ * 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.
+ */
+class RulesTraceConditionResponse {
+}
+exports.RulesTraceConditionResponse = RulesTraceConditionResponse;
+class RulesTraceGroupResponse {
+}
+exports.RulesTraceGroupResponse = RulesTraceGroupResponse;
+/** Traza completa de una evaluación: por qué cumplió o no. */
+class RulesTraceResponse {
+}
+exports.RulesTraceResponse = RulesTraceResponse;

package/bin/rules/dtos/ValidateRulesRequest.d.ts

@@ -0,0 +1,15 @@
+import { JsonValue } from '../../common';
+import { InputField } from '../../dynamicForm/dtos/InputField';
+/** `POST /validate`: valida una regla guardada contra el catálogo de los ítems indicados y el contrato de `input`. */
+export declare class ValidateRulesRequest {
+    /** Quién llama (solo logs y métricas). */
+    consumer?: string;
+    /** Ids de ítems del catálogo (`source:key`) contra los que se valida. */
+    items: string[];
+    /** La regla (`{ match, groups[] }`). */
+    rule: {
+        [key: string]: JsonValue;
+    };
+    /** Contrato de la fuente `input` (`InputField[]`, dominio `dynamicForm`). */
+    inputContract?: InputField[];
+}

package/bin/rules/dtos/ValidateRulesRequest.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.ValidateRulesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RulesLimits_1 = require("../constants/RulesLimits");
+/** `POST /validate`: valida una regla guardada contra el catálogo de los ítems indicados y el contrato de `input`. */
+class ValidateRulesRequest {
+}
+exports.ValidateRulesRequest = ValidateRulesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ValidateRulesRequest.prototype, "consumer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], ValidateRulesRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], ValidateRulesRequest.prototype, "rule", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(RulesLimits_1.RULES_MAX_INPUT_CONTRACT),
+    (0, class_validator_1.IsObject)({ each: true }),
+    __metadata("design:type", Array)
+], ValidateRulesRequest.prototype, "inputContract", void 0);

package/bin/rules/dtos/ValidateRulesResponse.d.ts

@@ -0,0 +1,6 @@
+/** Resultado de `POST /validate`. */
+export declare class ValidateRulesResponse {
+    valid: boolean;
+    /** Mensajes de `validateRule`, tal cual (vacío si `valid`). */
+    errors: string[];
+}

package/bin/rules/dtos/ValidateRulesResponse.js

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

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

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

package/bin/rules/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 /generate`). */
+var RulesChatRoleEnum;
+(function (RulesChatRoleEnum) {
+    RulesChatRoleEnum["USER"] = "user";
+    RulesChatRoleEnum["ASSISTANT"] = "assistant";
+})(RulesChatRoleEnum || (exports.RulesChatRoleEnum = RulesChatRoleEnum = {}));

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

@@ -0,0 +1,7 @@
+/** Códigos de error 400 del lambda central de reglas. */
+export declare enum RulesErrorCodeEnum {
+    UNKNOWN_CATALOG_ITEM = "UNKNOWN_CATALOG_ITEM",
+    DUPLICATE_SOURCE_IN_ITEMS = "DUPLICATE_SOURCE_IN_ITEMS",
+    TOO_MANY_SUBJECTS = "TOO_MANY_SUBJECTS",
+    VALIDATION_ERROR = "VALIDATION_ERROR"
+}

package/bin/rules/enums/RulesErrorCodeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesErrorCodeEnum = void 0;
+/** Códigos de error 400 del lambda central de reglas. */
+var RulesErrorCodeEnum;
+(function (RulesErrorCodeEnum) {
+    RulesErrorCodeEnum["UNKNOWN_CATALOG_ITEM"] = "UNKNOWN_CATALOG_ITEM";
+    RulesErrorCodeEnum["DUPLICATE_SOURCE_IN_ITEMS"] = "DUPLICATE_SOURCE_IN_ITEMS";
+    RulesErrorCodeEnum["TOO_MANY_SUBJECTS"] = "TOO_MANY_SUBJECTS";
+    RulesErrorCodeEnum["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+})(RulesErrorCodeEnum || (exports.RulesErrorCodeEnum = RulesErrorCodeEnum = {}));

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

@@ -0,0 +1,6 @@
+/** Estado de la generación de una regla con IA (`POST /generate`). */
+export declare enum RulesGenerationStatusEnum {
+    OK = "OK",
+    REPAIRED = "REPAIRED",
+    FAILED = "FAILED"
+}

package/bin/rules/enums/RulesGenerationStatusEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesGenerationStatusEnum = void 0;
+/** Estado de la generación de una regla con IA (`POST /generate`). */
+var RulesGenerationStatusEnum;
+(function (RulesGenerationStatusEnum) {
+    RulesGenerationStatusEnum["OK"] = "OK";
+    RulesGenerationStatusEnum["REPAIRED"] = "REPAIRED";
+    RulesGenerationStatusEnum["FAILED"] = "FAILED";
+})(RulesGenerationStatusEnum || (exports.RulesGenerationStatusEnum = RulesGenerationStatusEnum = {}));

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/bin/usmarketgrowth-business/dtos/PromoterByDirectoryIdResponse.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Promotor de US Market Growth ligado a un directorio. Respuesta del privado
+ * `GET /private/promoters/directoryId/{directoryId}` de `usmarketgrowth-business` (DEC-053).
+ *
+ * Si el directorio no es de un promotor, el endpoint responde 404 `PROMOTER_NOT_FOUND`.
+ */
+export interface PromoterByDirectoryIdResponse {
+    promoterId: string;
+    directoryId: string;
+    name: string;
+    phoneNumber: string;
+    email: string;
+    /** Código de referido que se le asignó (paso 6). */
+    referralCode?: string;
+    /** Grupo que se le creó (paso 6). */
+    groupId?: string;
+    groupName?: string;
+    /** Estado del contrato en DocuSign (paso 4). */
+    contractStatus?: string;
+    /** ISO 8601. */
+    createdAt: string;
+}

package/bin/usmarketgrowth-business/dtos/PromoterByDirectoryIdResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/usmarketgrowth-business/index.d.ts

@@ -0,0 +1 @@
+export * from './dtos/PromoterByDirectoryIdResponse';

package/bin/usmarketgrowth-business/index.js

@@ -0,0 +1,18 @@
+"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 });
+//dtos
+__exportStar(require("./dtos/PromoterByDirectoryIdResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -65,6 +65,7 @@ export * as Event from './event';
 export * as NotificationWS from './notificationWS';
 export * as ZendeskMessaging from './zendeskMessaging';
 export * as ReferralBusiness from './referral-business';
+export * as UsMarketGrowthBusiness from './usmarketgrowth-business';
 export * as ComissionBusiness from './comission-business';
 export * as Credit from './credit';
 export * as CreditEngine from './creditEngine';
@@ -212,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/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[];
+}

package/src/rules/dtos/ValidateRulesRequest.ts

@@ -0,0 +1,33 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsObject, IsOptional, IsString } from 'class-validator';
+import { JsonValue } from '../../common';
+import { InputField } from '../../dynamicForm/dtos/InputField';
+import { RULES_MAX_INPUT_CONTRACT } from '../constants/RulesLimits';
+
+/** `POST /validate`: valida una regla guardada contra el catálogo de los ítems indicados y el contrato de `input`. */
+export class ValidateRulesRequest {
+    /** Quién llama (solo logs y métricas). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    consumer?: string;
+
+    /** Ids de ítems del catálogo (`source:key`) contra los que se valida. */
+    @Expose()
+    @IsArray()
+    @IsString({ each: true })
+    items: string[];
+
+    /** La regla (`{ match, groups[] }`). */
+    @Expose()
+    @IsObject()
+    rule: { [key: string]: JsonValue };
+
+    /** Contrato de la fuente `input` (`InputField[]`, dominio `dynamicForm`). */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(RULES_MAX_INPUT_CONTRACT)
+    @IsObject({ each: true })
+    inputContract?: InputField[];
+}

package/src/rules/dtos/ValidateRulesResponse.ts

@@ -0,0 +1,6 @@
+/** Resultado de `POST /validate`. */
+export class ValidateRulesResponse {
+    valid: boolean;
+    /** Mensajes de `validateRule`, tal cual (vacío si `valid`). */
+    errors: string[];
+}

package/src/rules/enums/RulesChatRoleEnum.ts

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

package/src/rules/enums/RulesErrorCodeEnum.ts

@@ -0,0 +1,7 @@
+/** Códigos de error 400 del lambda central de reglas. */
+export enum RulesErrorCodeEnum {
+    UNKNOWN_CATALOG_ITEM = 'UNKNOWN_CATALOG_ITEM',
+    DUPLICATE_SOURCE_IN_ITEMS = 'DUPLICATE_SOURCE_IN_ITEMS',
+    TOO_MANY_SUBJECTS = 'TOO_MANY_SUBJECTS',
+    VALIDATION_ERROR = 'VALIDATION_ERROR',
+}

package/src/rules/enums/RulesGenerationStatusEnum.ts

@@ -0,0 +1,6 @@
+/** Estado de la generación de una regla con IA (`POST /generate`). */
+export enum RulesGenerationStatusEnum {
+    OK = 'OK',
+    REPAIRED = 'REPAIRED',
+    FAILED = 'FAILED',
+}

package/src/rules/enums/RulesOutcomeEnum.ts

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

package/src/rules/enums/RulesValueTypeEnum.ts

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

package/src/rules/index.ts

@@ -0,0 +1,20 @@
+//Enums
+export * from './enums/RulesOutcomeEnum';
+export * from './enums/RulesGenerationStatusEnum';
+export * from './enums/RulesChatRoleEnum';
+export * from './enums/RulesValueTypeEnum';
+export * from './enums/RulesErrorCodeEnum';
+
+//Constants
+export * from './constants/RulesLimits';
+
+//DTOs
+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/src/usmarketgrowth-business/dtos/PromoterByDirectoryIdResponse.ts

@@ -0,0 +1,22 @@
+/**
+ * Promotor de US Market Growth ligado a un directorio. Respuesta del privado
+ * `GET /private/promoters/directoryId/{directoryId}` de `usmarketgrowth-business` (DEC-053).
+ *
+ * Si el directorio no es de un promotor, el endpoint responde 404 `PROMOTER_NOT_FOUND`.
+ */
+export interface PromoterByDirectoryIdResponse {
+    promoterId: string;
+    directoryId: string;
+    name: string;
+    phoneNumber: string;
+    email: string;
+    /** Código de referido que se le asignó (paso 6). */
+    referralCode?: string;
+    /** Grupo que se le creó (paso 6). */
+    groupId?: string;
+    groupName?: string;
+    /** Estado del contrato en DocuSign (paso 4). */
+    contractStatus?: string;
+    /** ISO 8601. */
+    createdAt: string;
+}

package/src/usmarketgrowth-business/index.ts

@@ -0,0 +1,2 @@
+//dtos
+export * from './dtos/PromoterByDirectoryIdResponse';