@fiado/api-invoker 4.72.0 → 4.74.0

package/bin/index.d.ts

@@ -84,6 +84,7 @@ export * from "./retailCards/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";
 export * from "./loanCollectorAssignment/index.js";
+export * from "./loanCredit/index.js";
 export * from "./messages-business/index.js";
 export * from "./totp-security/index.js";
 export * from "./equality-connector/index.js";

package/bin/index.js

@@ -84,6 +84,7 @@ export * from "./retailCards/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";
 export * from "./loanCollectorAssignment/index.js";
+export * from "./loanCredit/index.js";
 export * from "./messages-business/index.js";
 export * from "./totp-security/index.js";
 export * from "./equality-connector/index.js";

package/bin/loanCredit/api/LoanCreditBusinessApi.d.ts

@@ -0,0 +1,28 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { ActivationCheckRequest, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
+/**
+ * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
+ * Contrato y semántica completos → `ILoanCreditBusinessApi` (tenantId obligatorio,
+ * `StandardResponse` → leer `result.data`).
+ *
+ * Env var requerida en el consumer: `LOAN_CREDIT_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   LOAN_CREDIT_BUSINESS_URL: '{{resolve:ssm:loan-credit-business}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ */
+export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    originate(input: OriginateLoanCreditRequest, tenantId: string): Promise<StandardResponse<OriginateLoanCreditResponse>>;
+    quote(creditId: string, input: QuoteLoanCreditRequest, tenantId: string): Promise<StandardResponse<QuoteLoanCreditResponse>>;
+    sign(creditId: string, input: SignLoanCreditRequest, tenantId: string): Promise<StandardResponse<SignLoanCreditResponse>>;
+    activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;
+    getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
+    getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+}

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -0,0 +1,67 @@
+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";
+/**
+ * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
+ * Contrato y semántica completos → `ILoanCreditBusinessApi` (tenantId obligatorio,
+ * `StandardResponse` → leer `result.data`).
+ *
+ * Env var requerida en el consumer: `LOAN_CREDIT_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   LOAN_CREDIT_BUSINESS_URL: '{{resolve:ssm:loan-credit-business}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ */
+let LoanCreditBusinessApi = class LoanCreditBusinessApi {
+    httpRequest;
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//private".
+    baseUrl = (process.env.LOAN_CREDIT_BUSINESS_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async originate(input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/originate?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async quote(creditId, input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/quote?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async sign(creditId, input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/sign?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async activateCheck(creditId, input, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/activate-check?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async getCredit(creditId, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+    async getBorrowerByRetailCustomer(retailCustomerId, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+    async upsertBorrower(input, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+};
+LoanCreditBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], LoanCreditBusinessApi);
+export default LoanCreditBusinessApi;

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.d.ts

@@ -0,0 +1,57 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { ActivationCheckRequest, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
+/**
+ * Contrato del publisher de `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito
+ * SOFOM, pista Loan). Endpoints PRIVADOS (VPC) consumidos por `retail-wizard-business` (pasos
+ * 05/06/08/09 del wizard) y el BO.
+ *
+ * Convenciones (idénticas a `ILoanOfferingsBusinessApi`):
+ * - `tenantId` OBLIGATORIO en todos los métodos — viaja por query `?tenantId=` (convención de los
+ *   privados Fiado). Sin él el lambda responde `400 UNKNOWN_TENANT` (fail-closed, nunca default).
+ * - Retorna `StandardResponse<T>` → leer `result.data` (NO `result.body`).
+ * - Errores: el publisher RECHAZA con `DomainError` tipado del motor — `404 CREDIT_NOT_FOUND` /
+ *   `404 BORROWER_NOT_FOUND` / `409 ACTIVE_CREDIT_EXISTS` / `409 IMEI_IN_USE` /
+ *   `422 PLAN_INACTIVE` / `400 CHECKLIST_INCOMPLETE` / `400 OTP_INVALID` / `OTP_EXPIRED` /
+ *   `OTP_MAX_ATTEMPTS` / `400 CREDIT_NOT_PENDING` / `400 INVALID_TRANSITION`. Nunca fallback.
+ *
+ * Env var requerida en el consumer:
+ *
+ *   LOAN_CREDIT_BUSINESS_URL: '{{resolve:ssm:loan-credit-business}}'
+ */
+export interface ILoanCreditBusinessApi {
+    /**
+     * Origina el crédito (M2 §4): valida (sin otro crédito vivo, plan activo, IMEI libre), cotiza
+     * contra el simulador de loan-offerings y persiste crédito `PENDING_ACTIVATION` + cuotas +
+     * contratos draft. IDEMPOTENTE por `input.wizardSessionId` (reintenta seguro).
+     */
+    originate(input: OriginateLoanCreditRequest, tenantId: string): Promise<StandardResponse<OriginateLoanCreditResponse>>;
+    /**
+     * Paso 06 — re-cotiza el crédito `PENDING_ACTIVATION` (nuevo plazo/enganche) y regenera su
+     * plan de cuotas. Rechaza si el contrato ya se firmó (términos congelados).
+     */
+    quote(creditId: string, input: QuoteLoanCreditRequest, tenantId: string): Promise<StandardResponse<QuoteLoanCreditResponse>>;
+    /**
+     * Paso 08 — firma FES en 2 tiempos (M2 §4.4): sin `otpCode` inicia (genera PDFs + envía OTP
+     * dedicado vía messages-business); con `otpCode` verifica y firma (sha256 + NOM-151 +
+     * `activationChecklist.contractSigned = true`).
+     */
+    sign(creditId: string, input: SignLoanCreditRequest, tenantId: string): Promise<StandardResponse<SignLoanCreditResponse>>;
+    /**
+     * Marca condiciones del checklist de activación (M2 §5): `downPayment` (paso 07),
+     * `imeiEnrolled`/`lockVerified` (paso 09, dispara el MDM vía abstracción). Con las 4 en `true`
+     * el crédito pasa a `ACTIVE` (vencimientos +7d, ventana de cancelación 7d).
+     */
+    activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;
+    /** Estado completo del crédito (checklist, status, términos). */
+    getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
+    /**
+     * Busca el acreditado por su FK al cliente retail (lookup del wizard/scoring).
+     * `404 BORROWER_NOT_FOUND` si el evento KYC aún no lo hidrató.
+     */
+    getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    /**
+     * Upsert idempotente del acreditado por `retailCustomerId` (mismo contrato que el consumidor
+     * del evento `CustomerKycVerifiedV1` — fallback operativo mientras la cola no exista).
+     */
+    upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+}

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.js

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

package/bin/loanCredit/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/ILoanCreditBusinessApi.js";
+export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/bin/loanCredit/index.js

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/ILoanCreditBusinessApi.js";
+export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/bin/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.d.ts

@@ -31,6 +31,20 @@ export interface StoreCatalogItem {
     imei: string;
     cashPriceCents: number;
     available: boolean;
+    /** Marca comercial (p. ej. "Apple"). */
+    brand: string;
+    /** Modelo (p. ej. "iPhone 15 Pro"). */
+    model: string;
+    /** Capacidad de almacenamiento (p. ej. "128GB"). */
+    capacity: string;
+    /** Color comercial (p. ej. "Black"). */
+    color: string;
+    /** Imagen del producto; `null` si no tiene una cargada. */
+    imageUrl: string | null;
+    /** Gama del producto (PREMIUM/HIGH/…); el consumidor decide si la usa para ordenar. */
+    tier: string;
+    /** Financieras alternativas habilitadas (derivación externa, paso 04 del wizard). */
+    eligibleFinanciers: string[];
 }
 /** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */
 export interface ReserveInventoryResult {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.72.0",
-  "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
+  "version": "4.74.0",
+  "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicaci\u00f3n entre ellas a trav\u00e9s de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.196.0",
+    "@fiado/type-kit": "^3.199.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/index.ts

@@ -84,6 +84,7 @@ export * from "./retailCards/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";
 export * from "./loanCollectorAssignment/index.js";
+export * from "./loanCredit/index.js";
 export * from "./messages-business/index.js";
 export * from "./totp-security/index.js";
 export * from "./equality-connector/index.js";

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -0,0 +1,96 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import {
+    ActivationCheckRequest,
+    ActivationCheckResponse,
+    LoanBorrowerResponse,
+    LoanCreditResponse,
+    OriginateLoanCreditRequest,
+    OriginateLoanCreditResponse,
+    QuoteLoanCreditRequest,
+    QuoteLoanCreditResponse,
+    SignLoanCreditRequest,
+    SignLoanCreditResponse,
+    UpsertLoanBorrowerRequest,
+} from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
+
+/**
+ * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
+ * Contrato y semántica completos → `ILoanCreditBusinessApi` (tenantId obligatorio,
+ * `StandardResponse` → leer `result.data`).
+ *
+ * Env var requerida en el consumer: `LOAN_CREDIT_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   LOAN_CREDIT_BUSINESS_URL: '{{resolve:ssm:loan-credit-business}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ */
+@injectable()
+export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//private".
+    private readonly baseUrl = (process.env.LOAN_CREDIT_BUSINESS_URL || "").replace(/\/+$/, "");
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async originate(
+        input: OriginateLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<OriginateLoanCreditResponse>> {
+        const url = `${this.baseUrl}/private/credits/originate?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async quote(
+        creditId: string,
+        input: QuoteLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<QuoteLoanCreditResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/quote?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async sign(
+        creditId: string,
+        input: SignLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SignLoanCreditResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/sign?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async activateCheck(
+        creditId: string,
+        input: ActivationCheckRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ActivationCheckResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/activate-check?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async getCredit(
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getBorrowerByRetailCustomer(
+        retailCustomerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerResponse>> {
+        const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async upsertBorrower(
+        input: UpsertLoanBorrowerRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerResponse>> {
+        const url = `${this.baseUrl}/private/borrowers?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+}

package/src/loanCredit/api/interfaces/ILoanCreditBusinessApi.ts

@@ -0,0 +1,100 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import {
+    ActivationCheckRequest,
+    ActivationCheckResponse,
+    LoanBorrowerResponse,
+    LoanCreditResponse,
+    OriginateLoanCreditRequest,
+    OriginateLoanCreditResponse,
+    QuoteLoanCreditRequest,
+    QuoteLoanCreditResponse,
+    SignLoanCreditRequest,
+    SignLoanCreditResponse,
+    UpsertLoanBorrowerRequest,
+} from "@fiado/type-kit/bin/loanCredit/index.js";
+
+/**
+ * Contrato del publisher de `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito
+ * SOFOM, pista Loan). Endpoints PRIVADOS (VPC) consumidos por `retail-wizard-business` (pasos
+ * 05/06/08/09 del wizard) y el BO.
+ *
+ * Convenciones (idénticas a `ILoanOfferingsBusinessApi`):
+ * - `tenantId` OBLIGATORIO en todos los métodos — viaja por query `?tenantId=` (convención de los
+ *   privados Fiado). Sin él el lambda responde `400 UNKNOWN_TENANT` (fail-closed, nunca default).
+ * - Retorna `StandardResponse<T>` → leer `result.data` (NO `result.body`).
+ * - Errores: el publisher RECHAZA con `DomainError` tipado del motor — `404 CREDIT_NOT_FOUND` /
+ *   `404 BORROWER_NOT_FOUND` / `409 ACTIVE_CREDIT_EXISTS` / `409 IMEI_IN_USE` /
+ *   `422 PLAN_INACTIVE` / `400 CHECKLIST_INCOMPLETE` / `400 OTP_INVALID` / `OTP_EXPIRED` /
+ *   `OTP_MAX_ATTEMPTS` / `400 CREDIT_NOT_PENDING` / `400 INVALID_TRANSITION`. Nunca fallback.
+ *
+ * Env var requerida en el consumer:
+ *
+ *   LOAN_CREDIT_BUSINESS_URL: '{{resolve:ssm:loan-credit-business}}'
+ */
+export interface ILoanCreditBusinessApi {
+    /**
+     * Origina el crédito (M2 §4): valida (sin otro crédito vivo, plan activo, IMEI libre), cotiza
+     * contra el simulador de loan-offerings y persiste crédito `PENDING_ACTIVATION` + cuotas +
+     * contratos draft. IDEMPOTENTE por `input.wizardSessionId` (reintenta seguro).
+     */
+    originate(
+        input: OriginateLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<OriginateLoanCreditResponse>>;
+
+    /**
+     * Paso 06 — re-cotiza el crédito `PENDING_ACTIVATION` (nuevo plazo/enganche) y regenera su
+     * plan de cuotas. Rechaza si el contrato ya se firmó (términos congelados).
+     */
+    quote(
+        creditId: string,
+        input: QuoteLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<QuoteLoanCreditResponse>>;
+
+    /**
+     * Paso 08 — firma FES en 2 tiempos (M2 §4.4): sin `otpCode` inicia (genera PDFs + envía OTP
+     * dedicado vía messages-business); con `otpCode` verifica y firma (sha256 + NOM-151 +
+     * `activationChecklist.contractSigned = true`).
+     */
+    sign(
+        creditId: string,
+        input: SignLoanCreditRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SignLoanCreditResponse>>;
+
+    /**
+     * Marca condiciones del checklist de activación (M2 §5): `downPayment` (paso 07),
+     * `imeiEnrolled`/`lockVerified` (paso 09, dispara el MDM vía abstracción). Con las 4 en `true`
+     * el crédito pasa a `ACTIVE` (vencimientos +7d, ventana de cancelación 7d).
+     */
+    activateCheck(
+        creditId: string,
+        input: ActivationCheckRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ActivationCheckResponse>>;
+
+    /** Estado completo del crédito (checklist, status, términos). */
+    getCredit(
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditResponse>>;
+
+    /**
+     * Busca el acreditado por su FK al cliente retail (lookup del wizard/scoring).
+     * `404 BORROWER_NOT_FOUND` si el evento KYC aún no lo hidrató.
+     */
+    getBorrowerByRetailCustomer(
+        retailCustomerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerResponse>>;
+
+    /**
+     * Upsert idempotente del acreditado por `retailCustomerId` (mismo contrato que el consumidor
+     * del evento `CustomerKycVerifiedV1` — fallback operativo mientras la cola no exista).
+     */
+    upsertBorrower(
+        input: UpsertLoanBorrowerRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerResponse>>;
+}

package/src/loanCredit/index.ts

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/ILoanCreditBusinessApi.js";
+export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/src/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.ts

@@ -33,6 +33,23 @@ export interface StoreCatalogItem {
     imei: string;
     cashPriceCents: number;
     available: boolean;
+    // Atributos del producto (2026-07-21, MINOR aditivo). El consumidor real —el paso 03 del wizard—
+    // pinta TARJETAS DE PRODUCTO: sin marca/modelo/capacidad el catálogo es inusable en la UI. El
+    // destino ya cargaba el producto completo para su join anti-N+1, así que no cuesta I/O extra.
+    /** Marca comercial (p. ej. "Apple"). */
+    brand: string;
+    /** Modelo (p. ej. "iPhone 15 Pro"). */
+    model: string;
+    /** Capacidad de almacenamiento (p. ej. "128GB"). */
+    capacity: string;
+    /** Color comercial (p. ej. "Black"). */
+    color: string;
+    /** Imagen del producto; `null` si no tiene una cargada. */
+    imageUrl: string | null;
+    /** Gama del producto (PREMIUM/HIGH/…); el consumidor decide si la usa para ordenar. */
+    tier: string;
+    /** Financieras alternativas habilitadas (derivación externa, paso 04 del wizard). */
+    eligibleFinanciers: string[];
 }
 
 /** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */