@fiado/api-invoker 4.5.0 → 4.7.0

package/src/ai-engine-connector/AiEngineApi.ts

@@ -1,28 +1,28 @@
-import dotenv from 'dotenv';
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { IAiEngineApi } from "./interfaces/IAiEngineApi";
-import { AiAnalyzeRequest, AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-import { log } from "@fiado/logger";
-dotenv.config();
-
-@injectable()
-export class AiEngineApi implements IAiEngineApi {
-
-    private readonly baseUrl = process.env.AI_ENGINE_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private readonly httpRequest: IHttpRequest) {}
-
-    public async analyze(prompt: string, systemPrompt?: string, modelId?: string): Promise<FiadoApiResponse<AiAnalyzeResponse>> {
-        try {
-            const url = `${this.baseUrl}ai/analyze`;
-            const body: AiAnalyzeRequest = { prompt, systemPrompt, modelId };
-            log.info(`Calling AI Engine at: ${url}`);
-            return await this.httpRequest.post(url, body, { 'operationName': 'aiAnalyze' });
-        } catch (error) {
-            log.error('Error calling AI Engine from api-invoker', error as Error);
-            throw new Error('Error calling AI Engine from api-invoker');
-        }
-    }
-}
+import dotenv from 'dotenv';
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { IAiEngineApi } from "./interfaces/IAiEngineApi";
+import { AiAnalyzeRequest, AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine";
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import { log } from "@fiado/logger";
+dotenv.config();
+
+@injectable()
+export class AiEngineApi implements IAiEngineApi {
+
+    private readonly baseUrl = process.env.AI_ENGINE_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private readonly httpRequest: IHttpRequest) {}
+
+    public async analyze(prompt: string, systemPrompt?: string, modelId?: string): Promise<FiadoApiResponse<AiAnalyzeResponse>> {
+        try {
+            const url = `${this.baseUrl}ai/analyze`;
+            const body: AiAnalyzeRequest = { prompt, systemPrompt, modelId };
+            log.info(`Calling AI Engine at: ${url}`);
+            return await this.httpRequest.post(url, body, { 'operationName': 'aiAnalyze' });
+        } catch (error) {
+            log.error('Error calling AI Engine from api-invoker', error as Error);
+            throw new Error('Error calling AI Engine from api-invoker');
+        }
+    }
+}

package/src/ai-engine-connector/index.ts

@@ -1,2 +1,2 @@
-export * from './interfaces/IAiEngineApi';
-export * from './AiEngineApi';
+export * from './interfaces/IAiEngineApi';
+export * from './AiEngineApi';

package/src/ai-engine-connector/interfaces/IAiEngineApi.ts

@@ -1,6 +1,6 @@
-import { AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-
-export interface IAiEngineApi {
-    analyze(prompt: string, systemPrompt?: string, modelId?: string): Promise<FiadoApiResponse<AiAnalyzeResponse>>;
-}
+import { AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine";
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+
+export interface IAiEngineApi {
+    analyze(prompt: string, systemPrompt?: string, modelId?: string): Promise<FiadoApiResponse<AiAnalyzeResponse>>;
+}

package/src/appselectondata/AppSelectionDataApi.ts

@@ -1,33 +1,33 @@
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import dotenv from 'dotenv';
-import { IdentificationParameter } from "@fiado/type-kit/bin/blacklist";
-import { IAppSelectionDataApi } from "./interfaces/IAppSelectionDataApi";
-dotenv.config();
-
-@injectable()
-export class AppSelectionDataApi implements IAppSelectionDataApi {
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-    private readonly baseUrl = process.env.APP_SELECTION_DATA_URL || "";
-
-    async getList(params: {pageSize?:number,index?:string,dataType?:string}): Promise<any> {
-        const queryParams = []
-
-        if (params?.pageSize) {
-            queryParams.push(`pageSize=${params.pageSize}`)
-        }
-
-        if (params?.index) {
-            queryParams.push(`index=${params.index}`)
-        }
-
-        if (params?.dataType) {
-            queryParams.push(`dataType=${params.dataType}`)
-        }
-
-        const url = `${this.baseUrl}appselectiondata?${queryParams.join('&')}`;
-        return await this.httpRequest.get(`${url}`);
-    }
-    
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import dotenv from 'dotenv';
+import { IdentificationParameter } from "@fiado/type-kit/bin/blacklist";
+import { IAppSelectionDataApi } from "./interfaces/IAppSelectionDataApi";
+dotenv.config();
+
+@injectable()
+export class AppSelectionDataApi implements IAppSelectionDataApi {
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+    private readonly baseUrl = process.env.APP_SELECTION_DATA_URL || "";
+
+    async getList(params: {pageSize?:number,index?:string,dataType?:string}): Promise<any> {
+        const queryParams = []
+
+        if (params?.pageSize) {
+            queryParams.push(`pageSize=${params.pageSize}`)
+        }
+
+        if (params?.index) {
+            queryParams.push(`index=${params.index}`)
+        }
+
+        if (params?.dataType) {
+            queryParams.push(`dataType=${params.dataType}`)
+        }
+
+        const url = `${this.baseUrl}appselectiondata?${queryParams.join('&')}`;
+        return await this.httpRequest.get(`${url}`);
+    }
+    
 }

package/src/appselectondata/index.ts

@@ -1,3 +1,3 @@
-
-export * from './interfaces/IAppSelectionDataApi';
+
+export * from './interfaces/IAppSelectionDataApi';
 export * from './AppSelectionDataApi';

package/src/appselectondata/interfaces/IAppSelectionDataApi.ts

@@ -1,17 +1,17 @@
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-
-/**
- * Interfaz que define las operaciones que se pueden realizar en el servicio de black list.
- */
-export interface IAppSelectionDataApi {
-
-    /**
-     * Obtener por parametro de identificacion.
-     * @param identificationParameter tipo de parametro.
-     * @param value valor del parametro.
-     * @returns Una promesa que resuelve a void.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    getList(params: {pageSize?:number,index?:string,dataType?:string}): Promise<FiadoApiResponse<void>>;
-
-}
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+
+/**
+ * Interfaz que define las operaciones que se pueden realizar en el servicio de black list.
+ */
+export interface IAppSelectionDataApi {
+
+    /**
+     * Obtener por parametro de identificacion.
+     * @param identificationParameter tipo de parametro.
+     * @param value valor del parametro.
+     * @returns Una promesa que resuelve a void.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    getList(params: {pageSize?:number,index?:string,dataType?:string}): Promise<FiadoApiResponse<void>>;
+
+}

package/src/authentication/AuthenticationApi.ts

@@ -1,30 +1,30 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication";
-import { inject, injectable } from "inversify";
-import { IAuthenticationApi } from "./interfaces/IAuthenticationApi";
-
-@injectable()
-export class AuthenticationApi implements IAuthenticationApi {
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-
-    async signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any> {
-        const url = `${process.env.AUTH_LAMBDA_URL}`;
-        const operation = "postSignUpAdditionalCard";
-
-        return await this.httpRequest.post(url, createAdditionalCard, { 'operationName': operation });
-    }
-
-    async deleteAuthSessionByDirectoryId    (directoryId: string): Promise<any> {
-        const url = `${process.env.AUTH_LAMBDA_URL}`;
-        const operation = "deleteAuthSessionByDirectoryId";
-
-        return await this.httpRequest.post(url, {directoryId}, { 'operationName': operation });
-    }
-
-    async signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<any> {
-        const url = `${process.env.AUTH_LAMBDA_URL}`;
-        const operation = "postSignUpBackofficeBulk";
-        return await this.httpRequest.post(url, input, { 'operationName': operation });
-    }
+import { IHttpRequest } from "@fiado/http-client";
+import { SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication";
+import { inject, injectable } from "inversify";
+import { IAuthenticationApi } from "./interfaces/IAuthenticationApi";
+
+@injectable()
+export class AuthenticationApi implements IAuthenticationApi {
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+
+    async signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any> {
+        const url = `${process.env.AUTH_LAMBDA_URL}`;
+        const operation = "postSignUpAdditionalCard";
+
+        return await this.httpRequest.post(url, createAdditionalCard, { 'operationName': operation });
+    }
+
+    async deleteAuthSessionByDirectoryId    (directoryId: string): Promise<any> {
+        const url = `${process.env.AUTH_LAMBDA_URL}`;
+        const operation = "deleteAuthSessionByDirectoryId";
+
+        return await this.httpRequest.post(url, {directoryId}, { 'operationName': operation });
+    }
+
+    async signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<any> {
+        const url = `${process.env.AUTH_LAMBDA_URL}`;
+        const operation = "postSignUpBackofficeBulk";
+        return await this.httpRequest.post(url, input, { 'operationName': operation });
+    }
 }

package/src/authentication/index.ts

@@ -1,5 +1,5 @@
-
-
-
-export * from './interfaces/IAuthenticationApi';
+
+
+
+export * from './interfaces/IAuthenticationApi';
 export * from './AuthenticationApi';

package/src/authentication/interfaces/IAuthenticationApi.ts

@@ -1,9 +1,9 @@
-import { DirectoryBatchSummaryResponse, SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication";
-
-export interface IAuthenticationApi {
-
-    signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any>;
-    deleteAuthSessionByDirectoryId(directoryId: string): Promise<any>;
-
-    signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<DirectoryBatchSummaryResponse>;
+import { DirectoryBatchSummaryResponse, SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication";
+
+export interface IAuthenticationApi {
+
+    signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any>;
+    deleteAuthSessionByDirectoryId(directoryId: string): Promise<any>;
+
+    signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<DirectoryBatchSummaryResponse>;
 }

package/src/bankAccount/BankAccountApi.ts

@@ -1,35 +1,35 @@
-import { ApiResponse } from "@fiado/gateway-adapter";
-import { IHttpRequest } from "@fiado/http-client";
-import { inject, injectable } from "inversify";
-import { IBankAccountApi } from "./interfaces/IBankAccountApi";
-import GetExternalBankAccountResponse from "@fiado/type-kit/bin/bankAccount/dtos/GetExternalBankAccountResponse";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-import { GetExternalBankResponse } from "@fiado/type-kit/bin/bankAccount";
-
-
-@injectable()
-export default class BankAccountApi implements IBankAccountApi {
-    private readonly baseUrl = process.env.BANK_ACCOUNT_LAMBDA_UR || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async getBankAccountById(bankAccountId: string): Promise<FiadoApiResponse<GetExternalBankAccountResponse>> {
-        const url = `${this.baseUrl}/accounts/${bankAccountId}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getBankById(bankId: string): Promise<FiadoApiResponse<GetExternalBankResponse>> {
-        const url = `${this.baseUrl}/banks/${bankId}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getBankByCode(bankCode?: string, shortBankCode?: string): Promise<FiadoApiResponse<GetExternalBankResponse[]>> {
-        const url = `${this.baseUrl}/banks`;
-        const params = {
-            ...bankCode && { bankCode: bankCode },
-            ...shortBankCode && { shortBankCode: shortBankCode },
-        };
-        return await this.httpRequest.get(url, { params });
-    }
+import { ApiResponse } from "@fiado/gateway-adapter";
+import { IHttpRequest } from "@fiado/http-client";
+import { inject, injectable } from "inversify";
+import { IBankAccountApi } from "./interfaces/IBankAccountApi";
+import GetExternalBankAccountResponse from "@fiado/type-kit/bin/bankAccount/dtos/GetExternalBankAccountResponse";
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import { GetExternalBankResponse } from "@fiado/type-kit/bin/bankAccount";
+
+
+@injectable()
+export default class BankAccountApi implements IBankAccountApi {
+    private readonly baseUrl = process.env.BANK_ACCOUNT_LAMBDA_UR || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async getBankAccountById(bankAccountId: string): Promise<FiadoApiResponse<GetExternalBankAccountResponse>> {
+        const url = `${this.baseUrl}/accounts/${bankAccountId}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getBankById(bankId: string): Promise<FiadoApiResponse<GetExternalBankResponse>> {
+        const url = `${this.baseUrl}/banks/${bankId}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getBankByCode(bankCode?: string, shortBankCode?: string): Promise<FiadoApiResponse<GetExternalBankResponse[]>> {
+        const url = `${this.baseUrl}/banks`;
+        const params = {
+            ...bankCode && { bankCode: bankCode },
+            ...shortBankCode && { shortBankCode: shortBankCode },
+        };
+        return await this.httpRequest.get(url, { params });
+    }
 }

package/src/bankAccount/index.ts

@@ -1,2 +1,2 @@
-export * from './interfaces/IBankAccountApi';
+export * from './interfaces/IBankAccountApi';
 export * from './BankAccountApi';

package/src/bankAccount/interfaces/IBankAccountApi.ts

@@ -1,7 +1,7 @@
-export interface IBankAccountApi {
-    getBankAccountById(bankAccountId: string): Promise<any>;
-
-    getBankById(bankId: string): Promise<any>;
-
-    getBankByCode(bankCode?: string, shortBankCode?: string): Promise<any>;
+export interface IBankAccountApi {
+    getBankAccountById(bankAccountId: string): Promise<any>;
+
+    getBankById(bankId: string): Promise<any>;
+
+    getBankByCode(bankCode?: string, shortBankCode?: string): Promise<any>;
 }

package/src/bbvaRst/api/BBVARstApi.ts

@@ -1,17 +1,17 @@
-import {IBBVARstApi} from "./interfaces/IBBVARstApi";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst";
-
-@injectable()
-export class BBVARstApi implements IBBVARstApi {
-    private readonly baseUrl = process.env.BBVA_RSTA_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async create(request: CreateRSTTransactionRequest): Promise<any> {
-        const url = `${this.baseUrl}/create`;
-        return await this.httpRequest.post(url, request);
-    }
+import {IBBVARstApi} from "./interfaces/IBBVARstApi";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst";
+
+@injectable()
+export class BBVARstApi implements IBBVARstApi {
+    private readonly baseUrl = process.env.BBVA_RSTA_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async create(request: CreateRSTTransactionRequest): Promise<any> {
+        const url = `${this.baseUrl}/create`;
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/bbvaRst/api/interfaces/IBBVARstApi.ts

@@ -1,5 +1,5 @@
-import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst";
-
-export interface IBBVARstApi {
-    create(request: CreateRSTTransactionRequest): Promise<any>;
+import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst";
+
+export interface IBBVARstApi {
+    create(request: CreateRSTTransactionRequest): Promise<any>;
 }

package/src/bbvaRst/index.ts

@@ -1,2 +1,2 @@
-export * from './api/interfaces/IBBVARstApi';
+export * from './api/interfaces/IBBVARstApi';
 export * from './api/BBVARstApi';

package/src/benefits-marketplace/api/BenefitsMarketplaceApi.ts

@@ -1,35 +1,35 @@
-import {IBenefitsMarketplaceApi} from "./interfaces/IBenefitsMarketplaceApi";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
-import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse";
-
-@injectable()
-export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
-    private readonly baseUrl = process.env.BENEFITS_MARKETPLACE_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
-        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async consultPayment(
-        moduleName: string,
-        transactionNumber: string,
-    ): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
-        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}/transactions/${encodeURIComponent(transactionNumber)}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getLeafDisplay(
-        benefitId: string,
-        leafId: string,
-    ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>> {
-        const url = `${this.baseUrl}/${encodeURIComponent(benefitId)}/leaves/${encodeURIComponent(leafId)}/display`;
-        return await this.httpRequest.get(url);
-    }
-}
+import {IBenefitsMarketplaceApi} from "./interfaces/IBenefitsMarketplaceApi";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse";
+
+@injectable()
+export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
+    private readonly baseUrl = process.env.BENEFITS_MARKETPLACE_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
+        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async consultPayment(
+        moduleName: string,
+        transactionNumber: string,
+    ): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
+        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}/transactions/${encodeURIComponent(transactionNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getLeafDisplay(
+        benefitId: string,
+        leafId: string,
+    ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>> {
+        const url = `${this.baseUrl}/${encodeURIComponent(benefitId)}/leaves/${encodeURIComponent(leafId)}/display`;
+        return await this.httpRequest.get(url);
+    }
+}

package/src/benefits-marketplace/api/dtos/BenefitLeafDisplayResponse.ts

@@ -1,21 +1,21 @@
-/**
- * Respuesta del endpoint privado `GET /{benefitId}/leaves/{leafId}/display`
- * del marketplace. Pensado para que el procesador resuelva nombres legibles
- * (categoria/servicio) al armar la transacción, sin descargar el árbol entero
- * del catálogo.
- *
- * Equivalente conceptual al `subcategoria`/`servicio` que el procesador lee
- * del catálogo SPEI cuando arma `productDetail.targetName`.
- */
-export interface BenefitLeafDisplayResponse {
-    /**
-     * Nombre de la subcategoría a la que pertenece el leaf (ej. "TELMEX", "CFE").
-     * El procesador lo usa como `targetName` con `.toUpperCase()`, paridad con SPEI.
-     */
-    subcategoryName: string;
-    /**
-     * Nombre del servicio específico dentro de la subcategoría (ej. "Telmex Hogar Plan 500").
-     * Disponible para descripciones / detalle de transacción si el caller lo necesita.
-     */
-    serviceName: string;
-}
+/**
+ * Respuesta del endpoint privado `GET /{benefitId}/leaves/{leafId}/display`
+ * del marketplace. Pensado para que el procesador resuelva nombres legibles
+ * (categoria/servicio) al armar la transacción, sin descargar el árbol entero
+ * del catálogo.
+ *
+ * Equivalente conceptual al `subcategoria`/`servicio` que el procesador lee
+ * del catálogo SPEI cuando arma `productDetail.targetName`.
+ */
+export interface BenefitLeafDisplayResponse {
+    /**
+     * Nombre de la subcategoría a la que pertenece el leaf (ej. "TELMEX", "CFE").
+     * El procesador lo usa como `targetName` con `.toUpperCase()`, paridad con SPEI.
+     */
+    subcategoryName: string;
+    /**
+     * Nombre del servicio específico dentro de la subcategoría (ej. "Telmex Hogar Plan 500").
+     * Disponible para descripciones / detalle de transacción si el caller lo necesita.
+     */
+    serviceName: string;
+}