@fiado/api-invoker 5.127.0 → 5.129.0

package/bin/container.config.js

@@ -147,6 +147,8 @@ import { CentralPaymentsWebhookApi } from "./central-payments-webhook/index.js";
 // publisher de GRANT_FAILED + cliente del validador (rewards-eligibility-business)
 import { RewardsGrantPublisher, RewardsBusinessApi } from "./rewards-business/index.js";
 import { RewardsEligibilityPublisher, RewardsEligibilityBusinessApi } from "./rewards-eligibility-business/index.js";
+// Rules — cliente del lambda central de reglas (rules-business)
+import { RulesApi } from "./rules-business/index.js";
 import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js";
 import DomainCallbackApi from "./domain-callback/api/DomainCallbackApi.js";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
@@ -318,6 +320,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // El productor necesita REWARDS_ELIGIBILITY_QUEUE_URL y sqs:SendMessage sobre la cola.
     bind("IRewardsEligibilityPublisher").to(RewardsEligibilityPublisher);
     bind("IRewardsEligibilityBusinessApi").to(RewardsEligibilityBusinessApi);
+    bind("IRulesApi").to(RulesApi);
     // Collection engine — motor de cobro central multitenant (collect/deregister)
     bind("ICollectionEngineApi").to(CollectionEngineApi);
     // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)

package/bin/index.d.ts

@@ -127,3 +127,4 @@ export * from "./webhook-business/index.js";
 export * from "./trustonicConnector/index.js";
 export * from "./rewards-business/index.js";
 export * from "./rewards-eligibility-business/index.js";
+export * from "./rules-business/index.js";

package/bin/index.js

@@ -127,3 +127,4 @@ export * from "./webhook-business/index.js";
 export * from "./trustonicConnector/index.js";
 export * from "./rewards-business/index.js";
 export * from "./rewards-eligibility-business/index.js";
+export * from "./rules-business/index.js";

package/bin/retailCustomer/api/RetailCustomerBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, EnsureCustomerByPhoneRequest, EnsureCustomerByPhoneResponse, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "./dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "./dtos/CustomersPage.js";
 import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
@@ -24,6 +24,7 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     upsertCustomerFromKyc(payload: UpsertCustomerFromKycRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
+    ensureCustomerByPhone(payload: EnsureCustomerByPhoneRequest, tenantId: string): Promise<StandardResponse<EnsureCustomerByPhoneResponse>>;
     setAccountResult(customerId: string, payload: AccountResultRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     getCustomerByPhone(phone: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     getCustomer(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;

package/bin/retailCustomer/api/RetailCustomerBusinessApi.js

@@ -35,6 +35,10 @@ let RetailCustomerBusinessApi = class RetailCustomerBusinessApi {
         const url = `${this.baseUrl}/private/customers/upsert-from-kyc?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, payload);
     }
+    async ensureCustomerByPhone(payload, tenantId) {
+        const url = `${this.baseUrl}/private/customers/ensure-by-phone?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, payload);
+    }
     async setAccountResult(customerId, payload, tenantId) {
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/account-result?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.put(url, payload);

package/bin/retailCustomer/api/interfaces/IRetailCustomerBusinessApi.d.ts

@@ -1,18 +1,18 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, EnsureCustomerByPhoneRequest, EnsureCustomerByPhoneResponse, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "../dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "../dtos/CustomersPage.js";
 import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
- * para sus 7 endpoints privados de cliente (service-to-service, VPC-only).
+ * para sus endpoints privados de cliente (service-to-service, VPC-only).
  *
  * Consumidor previsto:
  *   - `retail-wizard-business` → upsert del cliente post-KYC, aterrizaje del resultado de apertura
  *     de cuenta (D35), y lecturas del cliente por teléfono / id durante la saga de venta.
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 7 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en todos los métodos — no es un detalle de firma.
  * ─────────────────────────────────────────────────────────────────────────────
  * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC), así que
  * el lambda destino no tiene `AuthContext.issuer` y NO puede inferir el silo. El caller declara el
@@ -54,6 +54,15 @@ export interface IRetailCustomerBusinessApi {
      * aditivo al type-kit (backlog) — no acá.
      */
     upsertCustomerFromKyc(payload: UpsertCustomerFromKycRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
+    /**
+     * POST /private/customers/ensure-by-phone?tenantId= — devuelve el cliente de ese celular o lo da
+     * de alta solo con el celular (ya verificado por OTP). Idempotente: dos llamadas con el mismo
+     * número devuelven el mismo cliente. `created=true` solo cuando esta llamada lo dio de alta.
+     *
+     * @throws `422 CUSTOMER_INACTIVE` si el número es de un cliente dado de baja.
+     * @throws `400 VALIDATION_ERROR` si el celular no trae 10 dígitos o falta la tienda.
+     */
+    ensureCustomerByPhone(payload: EnsureCustomerByPhoneRequest, tenantId: string): Promise<StandardResponse<EnsureCustomerByPhoneResponse>>;
     /**
      * PUT /private/customers/{customerId}/account-result?tenantId= — aterriza el resultado terminal de
      * la apertura de cuenta async (D35). Solo acepta OPEN/FAILED (nunca el intermedio OPENING). OPEN

package/bin/rules-business/api/RulesApi.d.ts

@@ -0,0 +1,17 @@
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { IHttpRequest } from "@fiado/http-client";
+import type { EvaluateRulesRequest, EvaluateRulesResponse, GenerateRulesRequest, GenerateRulesResponse, RulesCatalogResponse, ValidateRulesRequest, ValidateRulesResponse } from "@fiado/type-kit/bin/rules/index.js";
+import type { IRulesApi } from "./interfaces/IRulesApi.js";
+/**
+ * Contrato y semántica completos → `IRulesApi` (`StandardResponse` → leer `result.data`).
+ * Env: `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`).
+ */
+export declare class RulesApi implements IRulesApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    catalog(items: string[], consumer?: string): Promise<StandardResponse<RulesCatalogResponse>>;
+    validate(request: ValidateRulesRequest): Promise<StandardResponse<ValidateRulesResponse>>;
+    generate(request: GenerateRulesRequest): Promise<StandardResponse<GenerateRulesResponse>>;
+    evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>>;
+}

package/bin/rules-business/api/RulesApi.js

@@ -0,0 +1,45 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+/**
+ * Contrato y semántica completos → `IRulesApi` (`StandardResponse` → leer `result.data`).
+ * Env: `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`).
+ */
+let RulesApi = class RulesApi {
+    httpRequest;
+    // El buildspec publica la URL en SSM con "/" final (`.../v1/`): se normaliza para no armar "//catalog".
+    baseUrl = (process.env.RULES_BUSINESS_LAMBDA_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async catalog(items, consumer) {
+        const consumerQuery = consumer === undefined ? "" : `&consumer=${encodeURIComponent(consumer)}`;
+        const url = `${this.baseUrl}/catalog?items=${encodeURIComponent(items.join(","))}${consumerQuery}`;
+        return await this.httpRequest.get(url);
+    }
+    async validate(request) {
+        return await this.httpRequest.post(`${this.baseUrl}/validate`, request);
+    }
+    async generate(request) {
+        return await this.httpRequest.post(`${this.baseUrl}/generate`, request);
+    }
+    async evaluate(request) {
+        return await this.httpRequest.post(`${this.baseUrl}/evaluate`, request);
+    }
+};
+RulesApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], RulesApi);
+export { RulesApi };

package/bin/rules-business/api/interfaces/IRulesApi.d.ts

@@ -0,0 +1,18 @@
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { EvaluateRulesRequest, EvaluateRulesResponse, GenerateRulesRequest, GenerateRulesResponse, RulesCatalogResponse, ValidateRulesRequest, ValidateRulesResponse } from "@fiado/type-kit/bin/rules/index.js";
+/**
+ * Cliente del lambda central `rules-business` (catálogo, validación, generación con IA y evaluación de reglas).
+ *
+ * Configuración: env `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`, API PRIVADA, stage `v1`).
+ * Todas las respuestas son `StandardResponse` → leer `result.data`.
+ */
+export interface IRulesApi {
+    /** GET /catalog — ítems pedidos (`source:key`) en el orden canónico del registro, no en el orden pedido. */
+    catalog(items: string[], consumer?: string): Promise<StandardResponse<RulesCatalogResponse>>;
+    /** POST /validate — valida la forma de una regla contra los ítems indicados. */
+    validate(request: ValidateRulesRequest): Promise<StandardResponse<ValidateRulesResponse>>;
+    /** POST /generate — genera/ajusta una regla con IA a partir del chat. */
+    generate(request: GenerateRulesRequest): Promise<StandardResponse<GenerateRulesResponse>>;
+    /** POST /evaluate — evalúa reglas sobre hasta 100 sujetos por llamada (400 `TOO_MANY_SUBJECTS`). */
+    evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>>;
+}

package/bin/rules-business/api/interfaces/IRulesApi.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IRulesApi.js';
+export * from './api/RulesApi.js';

package/bin/rules-business/index.js

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IRulesApi.js';
+export * from './api/RulesApi.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.127.0",
+  "version": "5.129.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.533.0",
+    "@fiado/type-kit": "^3.540.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -213,6 +213,8 @@ import { ICentralPaymentsWebhookApi, CentralPaymentsWebhookApi } from "./central
 // publisher de GRANT_FAILED + cliente del validador (rewards-eligibility-business)
 import { IRewardsGrantPublisher, IRewardsBusinessApi, RewardsGrantPublisher, RewardsBusinessApi } from "./rewards-business/index.js";
 import { IRewardsEligibilityPublisher, IRewardsEligibilityBusinessApi, RewardsEligibilityPublisher, RewardsEligibilityBusinessApi } from "./rewards-eligibility-business/index.js";
+// Rules — cliente del lambda central de reglas (rules-business)
+import { IRulesApi, RulesApi } from "./rules-business/index.js";
 // Collection engine — cliente del motor de cobro central (collect/deregister)
 import { ICollectionEngineApi } from "./collection-engine/index.js";
 import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js";
@@ -417,6 +419,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // El productor necesita REWARDS_ELIGIBILITY_QUEUE_URL y sqs:SendMessage sobre la cola.
     bind<IRewardsEligibilityPublisher>("IRewardsEligibilityPublisher").to(RewardsEligibilityPublisher);
     bind<IRewardsEligibilityBusinessApi>("IRewardsEligibilityBusinessApi").to(RewardsEligibilityBusinessApi);
+    bind<IRulesApi>("IRulesApi").to(RulesApi);
 
     // Collection engine — motor de cobro central multitenant (collect/deregister)
     bind<ICollectionEngineApi>("ICollectionEngineApi").to(CollectionEngineApi);

package/src/index.ts

@@ -127,3 +127,4 @@ export * from "./webhook-business/index.js";
 export * from "./trustonicConnector/index.js";
 export * from "./rewards-business/index.js";
 export * from "./rewards-eligibility-business/index.js";
+export * from "./rules-business/index.js";

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -3,6 +3,8 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     UpsertCustomerFromKycRequest,
+    EnsureCustomerByPhoneRequest,
+    EnsureCustomerByPhoneResponse,
     AccountResultRequest,
     CustomerResponse,
     PromotionBonusEntryResponse,
@@ -45,6 +47,14 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
         return await this.httpRequest.post(url, payload);
     }
 
+    async ensureCustomerByPhone(
+        payload: EnsureCustomerByPhoneRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<EnsureCustomerByPhoneResponse>> {
+        const url = `${this.baseUrl}/private/customers/ensure-by-phone?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, payload);
+    }
+
     async setAccountResult(
         customerId: string,
         payload: AccountResultRequest,

package/src/retailCustomer/api/interfaces/IRetailCustomerBusinessApi.ts

@@ -1,6 +1,8 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     UpsertCustomerFromKycRequest,
+    EnsureCustomerByPhoneRequest,
+    EnsureCustomerByPhoneResponse,
     AccountResultRequest,
     CustomerResponse,
     PromotionBonusEntryResponse,
@@ -16,14 +18,14 @@ import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
 
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
- * para sus 7 endpoints privados de cliente (service-to-service, VPC-only).
+ * para sus endpoints privados de cliente (service-to-service, VPC-only).
  *
  * Consumidor previsto:
  *   - `retail-wizard-business` → upsert del cliente post-KYC, aterrizaje del resultado de apertura
  *     de cuenta (D35), y lecturas del cliente por teléfono / id durante la saga de venta.
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 7 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en todos los métodos — no es un detalle de firma.
  * ─────────────────────────────────────────────────────────────────────────────
  * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC), así que
  * el lambda destino no tiene `AuthContext.issuer` y NO puede inferir el silo. El caller declara el
@@ -69,6 +71,19 @@ export interface IRetailCustomerBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<CustomerResponse>>;
 
+    /**
+     * POST /private/customers/ensure-by-phone?tenantId= — devuelve el cliente de ese celular o lo da
+     * de alta solo con el celular (ya verificado por OTP). Idempotente: dos llamadas con el mismo
+     * número devuelven el mismo cliente. `created=true` solo cuando esta llamada lo dio de alta.
+     *
+     * @throws `422 CUSTOMER_INACTIVE` si el número es de un cliente dado de baja.
+     * @throws `400 VALIDATION_ERROR` si el celular no trae 10 dígitos o falta la tienda.
+     */
+    ensureCustomerByPhone(
+        payload: EnsureCustomerByPhoneRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<EnsureCustomerByPhoneResponse>>;
+
     /**
      * PUT /private/customers/{customerId}/account-result?tenantId= — aterriza el resultado terminal de
      * la apertura de cuenta async (D35). Solo acepta OPEN/FAILED (nunca el intermedio OPENING). OPEN

package/src/rules-business/api/RulesApi.ts

@@ -0,0 +1,44 @@
+import { inject, injectable } from "inversify";
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { IHttpRequest } from "@fiado/http-client";
+import type {
+    EvaluateRulesRequest,
+    EvaluateRulesResponse,
+    GenerateRulesRequest,
+    GenerateRulesResponse,
+    RulesCatalogResponse,
+    ValidateRulesRequest,
+    ValidateRulesResponse,
+} from "@fiado/type-kit/bin/rules/index.js";
+import type { IRulesApi } from "./interfaces/IRulesApi.js";
+
+/**
+ * Contrato y semántica completos → `IRulesApi` (`StandardResponse` → leer `result.data`).
+ * Env: `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`).
+ */
+@injectable()
+export class RulesApi implements IRulesApi {
+
+    // El buildspec publica la URL en SSM con "/" final (`.../v1/`): se normaliza para no armar "//catalog".
+    private readonly baseUrl = (process.env.RULES_BUSINESS_LAMBDA_URL || "").replace(/\/+$/, "");
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+
+    async catalog(items: string[], consumer?: string): Promise<StandardResponse<RulesCatalogResponse>> {
+        const consumerQuery = consumer === undefined ? "" : `&consumer=${encodeURIComponent(consumer)}`;
+        const url = `${this.baseUrl}/catalog?items=${encodeURIComponent(items.join(","))}${consumerQuery}`;
+        return await this.httpRequest.get<StandardResponse<RulesCatalogResponse>>(url);
+    }
+
+    async validate(request: ValidateRulesRequest): Promise<StandardResponse<ValidateRulesResponse>> {
+        return await this.httpRequest.post<StandardResponse<ValidateRulesResponse>>(`${this.baseUrl}/validate`, request);
+    }
+
+    async generate(request: GenerateRulesRequest): Promise<StandardResponse<GenerateRulesResponse>> {
+        return await this.httpRequest.post<StandardResponse<GenerateRulesResponse>>(`${this.baseUrl}/generate`, request);
+    }
+
+    async evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>> {
+        return await this.httpRequest.post<StandardResponse<EvaluateRulesResponse>>(`${this.baseUrl}/evaluate`, request);
+    }
+}

package/src/rules-business/api/interfaces/IRulesApi.ts

@@ -0,0 +1,30 @@
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type {
+    EvaluateRulesRequest,
+    EvaluateRulesResponse,
+    GenerateRulesRequest,
+    GenerateRulesResponse,
+    RulesCatalogResponse,
+    ValidateRulesRequest,
+    ValidateRulesResponse,
+} from "@fiado/type-kit/bin/rules/index.js";
+
+/**
+ * Cliente del lambda central `rules-business` (catálogo, validación, generación con IA y evaluación de reglas).
+ *
+ * Configuración: env `RULES_BUSINESS_LAMBDA_URL` (SSM `fiado-rulesbusiness-lambda`, API PRIVADA, stage `v1`).
+ * Todas las respuestas son `StandardResponse` → leer `result.data`.
+ */
+export interface IRulesApi {
+    /** GET /catalog — ítems pedidos (`source:key`) en el orden canónico del registro, no en el orden pedido. */
+    catalog(items: string[], consumer?: string): Promise<StandardResponse<RulesCatalogResponse>>;
+
+    /** POST /validate — valida la forma de una regla contra los ítems indicados. */
+    validate(request: ValidateRulesRequest): Promise<StandardResponse<ValidateRulesResponse>>;
+
+    /** POST /generate — genera/ajusta una regla con IA a partir del chat. */
+    generate(request: GenerateRulesRequest): Promise<StandardResponse<GenerateRulesResponse>>;
+
+    /** POST /evaluate — evalúa reglas sobre hasta 100 sujetos por llamada (400 `TOO_MANY_SUBJECTS`). */
+    evaluate(request: EvaluateRulesRequest): Promise<StandardResponse<EvaluateRulesResponse>>;
+}

package/src/rules-business/index.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IRulesApi.js';
+export * from './api/RulesApi.js';