@fiado/api-invoker 4.73.0 → 4.75.0

package/bin/auth-business/AuthBusinessApi.d.ts

@@ -1,5 +1,6 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { IAuthBusinessApi } from "./interfaces/IAuthBusinessApi.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import type { IAuthBusinessApi } from "./interfaces/IAuthBusinessApi.js";
+import type { SignUpProspectRequest, SignUpProspectResponse } from "@fiado/type-kit/bin/auth/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 export declare class AuthBusinessApi implements IAuthBusinessApi {
     private httpRequest;
@@ -8,5 +9,6 @@ export declare class AuthBusinessApi implements IAuthBusinessApi {
     deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
         deletedCount: number;
     }>>;
+    signUpProspect(request: SignUpProspectRequest): Promise<FiadoApiResponse<SignUpProspectResponse>>;
 }
 export {};

package/bin/auth-business/AuthBusinessApi.js

@@ -15,14 +15,24 @@ import dotenv from 'dotenv';
 dotenv.config();
 let AuthBusinessApi = class AuthBusinessApi {
     httpRequest;
-    baseUrl = process.env.AUTH_BUSINESS_LAMBDA_URL || "";
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//private"
+    // ni, si alguien limpia ese valor en SSM, un "...localprivate/..." sin slash.
+    baseUrl = (process.env.AUTH_BUSINESS_LAMBDA_URL || "").replace(/\/+$/, "");
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
     async deleteByDirectoryId(directoryId) {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        const url = `${this.baseUrl}/private/directory/${directoryId}`;
         return await this.httpRequest.delete(url);
     }
+    async signUpProspect(request) {
+        // ⚠️ Ruta PROPUESTA, no confirmada: esta es la primera operación privada de `auth-business`
+        // (su openapi/private.yaml está vacío y su PrivateController es una clase vacía). Podría
+        // terminar resolviéndose por el estilo `POST /` + header `operationName` que usan los otros
+        // clientes de auth. Se confirma con el equipo dueño al construir el endpoint.
+        const url = `${this.baseUrl}/private/signup-prospect`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 AuthBusinessApi = __decorate([
     injectable(),

package/bin/auth-business/interfaces/IAuthBusinessApi.d.ts

@@ -1,3 +1,4 @@
+import type { SignUpProspectRequest, SignUpProspectResponse } from "@fiado/type-kit/bin/auth/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
  * Interfaz para el servicio Auth Business (auth-business).
@@ -11,5 +12,19 @@ export interface IAuthBusinessApi {
     deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
         deletedCount: number;
     }>>;
+    /**
+     * Alta M2M de prospecto: crea (o reusa) onboarding + People + DirectoryUser y devuelve
+     * la identidad Fiado. Lo usa el paso 01d del wizard de SureKeep.
+     *
+     * `tenantId` es explícito — la variante de agente lo tiene hardcodeado a FIADO_BETA.
+     *
+     * ⚠️ NO es idempotente del lado del destino: el consumidor DEBE hacer lookup por teléfono
+     * antes de llamar, o creará People duplicados (el `peopleId` se regenera en cada llamada).
+     *
+     * ⚠️ PII: el request lleva nombre y teléfono — nunca loguees el payload completo.
+     *
+     * @throws propaga el error del destino; nunca devuelve fallback.
+     */
+    signUpProspect(request: SignUpProspectRequest): Promise<FiadoApiResponse<SignUpProspectResponse>>;
 }
 export {};

package/bin/container.config.js

@@ -125,6 +125,8 @@ import { PerformanceProfileApi } from "./performance-profile/index.js";
 import { AuthBusinessApi } from "./auth-business/index.js";
 import { PresenceWebsocketApi } from "./presence-websocket/index.js";
 import { NotificationWebsocketApi } from "./notificationWebsockets/index.js";
+// KYC verifications business — lectura confirmatoria server-side del KYC por directoryId (SureKeep F2)
+import { KycVerificationsBusinessApi } from "./kyc/index.js";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -264,4 +266,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IAuthBusinessApi").to(AuthBusinessApi);
     bind("IPresenceWebsocketApi").to(PresenceWebsocketApi);
     bind("INotificationWebsocketApi").to(NotificationWebsocketApi);
+    // KYC verifications business — lectura confirmatoria server-side del KYC por directoryId.
+    // La consume el wizard de SureKeep F2 tras el aviso async del stream de `KycVerifications`.
+    bind("IKycVerificationsBusinessApi").to(KycVerificationsBusinessApi);
 });

package/bin/index.d.ts

@@ -81,6 +81,7 @@ export * from "./retailOrg/index.js";
 export * from "./retailCustomer/index.js";
 export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";
+export * from "./shortlink/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";
 export * from "./loanCollectorAssignment/index.js";
@@ -102,3 +103,4 @@ export * from "./membership/index.js";
 export * from "./performance-profile/index.js";
 export * from "./auth-business/index.js";
 export * from "./presence-websocket/index.js";
+export * from "./kyc/index.js";

package/bin/index.js

@@ -81,6 +81,7 @@ export * from "./retailOrg/index.js";
 export * from "./retailCustomer/index.js";
 export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";
+export * from "./shortlink/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";
 export * from "./loanCollectorAssignment/index.js";
@@ -102,3 +103,4 @@ export * from "./membership/index.js";
 export * from "./performance-profile/index.js";
 export * from "./auth-business/index.js";
 export * from "./presence-websocket/index.js";
+export * from "./kyc/index.js";

package/bin/kyc/api/KycVerificationsBusinessApi.d.ts

@@ -0,0 +1,11 @@
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { IHttpRequest } from "@fiado/http-client";
+import type { KycByDirectoryResponse } from "@fiado/type-kit/bin/kyc/index.js";
+import type { IKycVerificationsBusinessApi } from "./interfaces/IKycVerificationsBusinessApi.js";
+/** Contrato y semántica completos → `IKycVerificationsBusinessApi` (`StandardResponse` → leer `result.data`). */
+export declare class KycVerificationsBusinessApi implements IKycVerificationsBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    getByDirectory(directoryId: string): Promise<StandardResponse<KycByDirectoryResponse>>;
+}

package/bin/kyc/api/KycVerificationsBusinessApi.js

@@ -0,0 +1,36 @@
+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 → `IKycVerificationsBusinessApi` (`StandardResponse` → leer `result.data`). */
+let KycVerificationsBusinessApi = class KycVerificationsBusinessApi {
+    httpRequest;
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//private"
+    // ni, si alguien limpia ese valor en SSM, un "...localprivate/..." sin slash.
+    baseUrl = (process.env.KYC_VERIFICATIONS_BUSINESS_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async getByDirectory(directoryId) {
+        // ⚠️ El endpoint del otro lado TODAVÍA NO EXISTE — lo construye el Plan 2 del KYC de
+        // SureKeep F2. Este client se escribe contra el contrato del spec; si el Plan 2 cambia
+        // la ruta o el shape, hay que sincronizar ambos lados en el mismo turno.
+        const url = `${this.baseUrl}/private/verifications/by-directory/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+};
+KycVerificationsBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], KycVerificationsBusinessApi);
+export { KycVerificationsBusinessApi };

package/bin/kyc/api/interfaces/IKycVerificationsBusinessApi.d.ts

@@ -0,0 +1,32 @@
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { KycByDirectoryResponse } from "@fiado/type-kit/bin/kyc/index.js";
+/**
+ * Publisher del privado de `kyc-verifications-business`.
+ *
+ * Devuelve `StandardResponse<T>` → leer `result.data`, igual que el resto de los módulos
+ * de SureKeep F2 (`retailCustomer`, `retailCatalog`, `loanCredit`, …). NO uses
+ * `FiadoApiResponse`: los dos tipos NO son intercambiables en TypeScript
+ * (`code`/`date` admiten `null` en uno y no en el otro).
+ *
+ * Env var requerida en el consumer: `KYC_VERIFICATIONS_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   KYC_VERIFICATIONS_BUSINESS_URL: '{{resolve:ssm:kyc-verifications-business}}'
+ *
+ * El endpoint es GLOBAL: se lee por `directoryId`, que ya es global en Fiado.
+ * NO lleva parámetro de tenant (ni `?tenantId=` ni header `x-tenant-issuer`).
+ *
+ * ⚠️ La respuesta lleva PII (CURP y nombre completo en `person`): nunca la loguees ni la
+ * expongas en un endpoint de alta frecuencia.
+ */
+export interface IKycVerificationsBusinessApi {
+    /**
+     * Estado consolidado del KYC de un directorio + estados crudos + datos de persona.
+     *
+     * ⚠️ Si el directorio NO tiene ninguna verificación, el destino responde **404** —
+     * no un cuerpo vacío. El consumidor debe manejar ese caso explícitamente.
+     *
+     * @throws propaga el error del destino; nunca devuelve fallback.
+     */
+    getByDirectory(directoryId: string): Promise<StandardResponse<KycByDirectoryResponse>>;
+}

package/bin/kyc/api/interfaces/IKycVerificationsBusinessApi.js

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

package/bin/kyc/index.d.ts

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

package/bin/kyc/index.js

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IKycVerificationsBusinessApi.js';
+export * from './api/KycVerificationsBusinessApi.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/bin/shortlink/api/ShortlinkBusinessApi.d.ts

@@ -0,0 +1,10 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { CreateShortLinkRequest, CreateShortLinkResponse } from "@fiado/type-kit/bin/shortlink/index.js";
+import { IShortlinkBusinessApi } from "./interfaces/IShortlinkBusinessApi.js";
+export default class ShortlinkBusinessApi implements IShortlinkBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    createLink(payload: CreateShortLinkRequest): Promise<StandardResponse<CreateShortLinkResponse>>;
+}

package/bin/shortlink/api/ShortlinkBusinessApi.js

@@ -0,0 +1,32 @@
+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";
+let ShortlinkBusinessApi = class ShortlinkBusinessApi {
+    httpRequest;
+    // La SSM `shortlink-business` apunta a la API PRIVADA (VPC-only). Se limpian las barras
+    // finales porque el buildspec publica la URL terminada en `/v1/`.
+    baseUrl = (process.env.SHORTLINK_BUSINESS_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async createLink(payload) {
+        const url = `${this.baseUrl}/private/links`;
+        return await this.httpRequest.post(url, payload);
+    }
+};
+ShortlinkBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], ShortlinkBusinessApi);
+export default ShortlinkBusinessApi;

package/bin/shortlink/api/interfaces/IShortlinkBusinessApi.d.ts

@@ -0,0 +1,25 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { CreateShortLinkRequest, CreateShortLinkResponse } from "@fiado/type-kit/bin/shortlink/index.js";
+/**
+ * Contrato del publisher HTTP del lambda `shortlink-business` para su endpoint privado
+ * de creación de links (service-to-service, VPC-only).
+ *
+ * Consumidor previsto:
+ *   - `retail-wizard-business` → QR de instalación de la app (paso 09, D9) y link de KYC
+ *     en modalidad `CUSTOMER_LINK` (paso 02, QR en tablet o SMS).
+ *
+ * A diferencia de los clients de retail-customer / retail-catalog, este **NO lleva tenant**:
+ * `shortlink-business` es un servicio global de plataforma, no está siloizado por SOFOM.
+ *
+ * URL: `SHORTLINK_BUSINESS_URL` (SSM `shortlink-business`, que apunta a la API PRIVADA).
+ */
+export interface IShortlinkBusinessApi {
+    /**
+     * Acorta una URL. Devuelve el código y la URL corta lista para mandar por SMS o pintar como QR.
+     *
+     * `payload.expireAt` es **obligatorio en la práctica**: va en epoch **segundos** y debe ser
+     * futuro. Si falta o ya venció, el destino responde 400 `INVALID_EXPIRE_AT`.
+     * `payload.destination` debe ser **HTTPS** o responde 400 `INVALID_DESTINATION_URL`.
+     */
+    createLink(payload: CreateShortLinkRequest): Promise<StandardResponse<CreateShortLinkResponse>>;
+}

package/bin/shortlink/api/interfaces/IShortlinkBusinessApi.js

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

package/bin/shortlink/index.d.ts

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

package/bin/shortlink/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.73.0",
+  "version": "4.75.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.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.199.0",
+    "@fiado/type-kit": "^3.202.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/auth-business/AuthBusinessApi.ts

@@ -1,7 +1,8 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import dotenv from 'dotenv';
-import { IAuthBusinessApi } from "./interfaces/IAuthBusinessApi.js";
+import type { IAuthBusinessApi } from "./interfaces/IAuthBusinessApi.js";
+import type { SignUpProspectRequest, SignUpProspectResponse } from "@fiado/type-kit/bin/auth/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 
 dotenv.config();
@@ -9,12 +10,23 @@ dotenv.config();
 @injectable()
 export class AuthBusinessApi implements IAuthBusinessApi {
 
-    private readonly baseUrl = process.env.AUTH_BUSINESS_LAMBDA_URL || "";
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//private"
+    // ni, si alguien limpia ese valor en SSM, un "...localprivate/..." sin slash.
+    private readonly baseUrl = (process.env.AUTH_BUSINESS_LAMBDA_URL || "").replace(/\/+$/, "");
 
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
 
     async deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{ deletedCount: number }>> {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        const url = `${this.baseUrl}/private/directory/${directoryId}`;
         return await this.httpRequest.delete<FiadoApiResponse<{ deletedCount: number }>>(url);
     }
+
+    async signUpProspect(request: SignUpProspectRequest): Promise<FiadoApiResponse<SignUpProspectResponse>> {
+        // ⚠️ Ruta PROPUESTA, no confirmada: esta es la primera operación privada de `auth-business`
+        // (su openapi/private.yaml está vacío y su PrivateController es una clase vacía). Podría
+        // terminar resolviéndose por el estilo `POST /` + header `operationName` que usan los otros
+        // clientes de auth. Se confirma con el equipo dueño al construir el endpoint.
+        const url = `${this.baseUrl}/private/signup-prospect`;
+        return await this.httpRequest.post<FiadoApiResponse<SignUpProspectResponse>>(url, request);
+    }
 }

package/src/auth-business/interfaces/IAuthBusinessApi.ts

@@ -1,3 +1,5 @@
+import type { SignUpProspectRequest, SignUpProspectResponse } from "@fiado/type-kit/bin/auth/index.js";
+
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 
 /**
@@ -12,4 +14,19 @@ export interface IAuthBusinessApi {
      */
     // TODO(type-kit): swap a Directory.DeleteByDirectoryResponse cuando se publique
     deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{ deletedCount: number }>>;
+
+    /**
+     * Alta M2M de prospecto: crea (o reusa) onboarding + People + DirectoryUser y devuelve
+     * la identidad Fiado. Lo usa el paso 01d del wizard de SureKeep.
+     *
+     * `tenantId` es explícito — la variante de agente lo tiene hardcodeado a FIADO_BETA.
+     *
+     * ⚠️ NO es idempotente del lado del destino: el consumidor DEBE hacer lookup por teléfono
+     * antes de llamar, o creará People duplicados (el `peopleId` se regenera en cada llamada).
+     *
+     * ⚠️ PII: el request lleva nombre y teléfono — nunca loguees el payload completo.
+     *
+     * @throws propaga el error del destino; nunca devuelve fallback.
+     */
+    signUpProspect(request: SignUpProspectRequest): Promise<FiadoApiResponse<SignUpProspectResponse>>;
 }

package/src/container.config.ts

@@ -185,6 +185,8 @@ import { IPerformanceProfileApi, PerformanceProfileApi } from "./performance-pro
 import { IAuthBusinessApi, AuthBusinessApi } from "./auth-business/index.js";
 import { IPresenceWebsocketApi, PresenceWebsocketApi } from "./presence-websocket/index.js";
 import { INotificationWebsocketApi, NotificationWebsocketApi } from "./notificationWebsockets/index.js";
+// KYC verifications business — lectura confirmatoria server-side del KYC por directoryId (SureKeep F2)
+import { IKycVerificationsBusinessApi, KycVerificationsBusinessApi } from "./kyc/index.js";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -346,4 +348,8 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<IAuthBusinessApi>("IAuthBusinessApi").to(AuthBusinessApi);
     bind<IPresenceWebsocketApi>("IPresenceWebsocketApi").to(PresenceWebsocketApi);
     bind<INotificationWebsocketApi>("INotificationWebsocketApi").to(NotificationWebsocketApi);
+
+    // KYC verifications business — lectura confirmatoria server-side del KYC por directoryId.
+    // La consume el wizard de SureKeep F2 tras el aviso async del stream de `KycVerifications`.
+    bind<IKycVerificationsBusinessApi>("IKycVerificationsBusinessApi").to(KycVerificationsBusinessApi);
 });

package/src/index.ts

@@ -81,6 +81,7 @@ export * from "./retailOrg/index.js";
 export * from "./retailCustomer/index.js";
 export * from "./retailCatalog/index.js";
 export * from "./retailCards/index.js";
+export * from "./shortlink/index.js";
 export * from "./loanConfig/index.js";
 export * from "./loanOfferings/index.js";
 export * from "./loanCollectorAssignment/index.js";
@@ -102,3 +103,4 @@ export * from "./membership/index.js";
 export * from "./performance-profile/index.js";
 export * from "./auth-business/index.js";
 export * from "./presence-websocket/index.js";
+export * from "./kyc/index.js";

package/src/kyc/api/KycVerificationsBusinessApi.ts

@@ -0,0 +1,24 @@
+import { inject, injectable } from "inversify";
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { IHttpRequest } from "@fiado/http-client";
+import type { KycByDirectoryResponse } from "@fiado/type-kit/bin/kyc/index.js";
+import type { IKycVerificationsBusinessApi } from "./interfaces/IKycVerificationsBusinessApi.js";
+
+/** Contrato y semántica completos → `IKycVerificationsBusinessApi` (`StandardResponse` → leer `result.data`). */
+@injectable()
+export class KycVerificationsBusinessApi implements IKycVerificationsBusinessApi {
+
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//private"
+    // ni, si alguien limpia ese valor en SSM, un "...localprivate/..." sin slash.
+    private readonly baseUrl = (process.env.KYC_VERIFICATIONS_BUSINESS_URL || "").replace(/\/+$/, "");
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+
+    async getByDirectory(directoryId: string): Promise<StandardResponse<KycByDirectoryResponse>> {
+        // ⚠️ El endpoint del otro lado TODAVÍA NO EXISTE — lo construye el Plan 2 del KYC de
+        // SureKeep F2. Este client se escribe contra el contrato del spec; si el Plan 2 cambia
+        // la ruta o el shape, hay que sincronizar ambos lados en el mismo turno.
+        const url = `${this.baseUrl}/private/verifications/by-directory/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get<StandardResponse<KycByDirectoryResponse>>(url);
+    }
+}

package/src/kyc/api/interfaces/IKycVerificationsBusinessApi.ts

@@ -0,0 +1,33 @@
+import type { StandardResponse } from "@fiado/gateway-adapter";
+import type { KycByDirectoryResponse } from "@fiado/type-kit/bin/kyc/index.js";
+
+/**
+ * Publisher del privado de `kyc-verifications-business`.
+ *
+ * Devuelve `StandardResponse<T>` → leer `result.data`, igual que el resto de los módulos
+ * de SureKeep F2 (`retailCustomer`, `retailCatalog`, `loanCredit`, …). NO uses
+ * `FiadoApiResponse`: los dos tipos NO son intercambiables en TypeScript
+ * (`code`/`date` admiten `null` en uno y no en el otro).
+ *
+ * Env var requerida en el consumer: `KYC_VERIFICATIONS_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   KYC_VERIFICATIONS_BUSINESS_URL: '{{resolve:ssm:kyc-verifications-business}}'
+ *
+ * El endpoint es GLOBAL: se lee por `directoryId`, que ya es global en Fiado.
+ * NO lleva parámetro de tenant (ni `?tenantId=` ni header `x-tenant-issuer`).
+ *
+ * ⚠️ La respuesta lleva PII (CURP y nombre completo en `person`): nunca la loguees ni la
+ * expongas en un endpoint de alta frecuencia.
+ */
+export interface IKycVerificationsBusinessApi {
+    /**
+     * Estado consolidado del KYC de un directorio + estados crudos + datos de persona.
+     *
+     * ⚠️ Si el directorio NO tiene ninguna verificación, el destino responde **404** —
+     * no un cuerpo vacío. El consumidor debe manejar ese caso explícitamente.
+     *
+     * @throws propaga el error del destino; nunca devuelve fallback.
+     */
+    getByDirectory(directoryId: string): Promise<StandardResponse<KycByDirectoryResponse>>;
+}

package/src/kyc/index.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IKycVerificationsBusinessApi.js';
+export * from './api/KycVerificationsBusinessApi.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). */

package/src/shortlink/api/ShortlinkBusinessApi.ts

@@ -0,0 +1,24 @@
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import {
+    CreateShortLinkRequest,
+    CreateShortLinkResponse,
+} from "@fiado/type-kit/bin/shortlink/index.js";
+import { IShortlinkBusinessApi } from "./interfaces/IShortlinkBusinessApi.js";
+
+@injectable()
+export default class ShortlinkBusinessApi implements IShortlinkBusinessApi {
+    // La SSM `shortlink-business` apunta a la API PRIVADA (VPC-only). Se limpian las barras
+    // finales porque el buildspec publica la URL terminada en `/v1/`.
+    private readonly baseUrl = (process.env.SHORTLINK_BUSINESS_URL || "").replace(/\/+$/, "");
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async createLink(
+        payload: CreateShortLinkRequest,
+    ): Promise<StandardResponse<CreateShortLinkResponse>> {
+        const url = `${this.baseUrl}/private/links`;
+        return await this.httpRequest.post(url, payload);
+    }
+}

package/src/shortlink/api/interfaces/IShortlinkBusinessApi.ts

@@ -0,0 +1,29 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+import {
+    CreateShortLinkRequest,
+    CreateShortLinkResponse,
+} from "@fiado/type-kit/bin/shortlink/index.js";
+
+/**
+ * Contrato del publisher HTTP del lambda `shortlink-business` para su endpoint privado
+ * de creación de links (service-to-service, VPC-only).
+ *
+ * Consumidor previsto:
+ *   - `retail-wizard-business` → QR de instalación de la app (paso 09, D9) y link de KYC
+ *     en modalidad `CUSTOMER_LINK` (paso 02, QR en tablet o SMS).
+ *
+ * A diferencia de los clients de retail-customer / retail-catalog, este **NO lleva tenant**:
+ * `shortlink-business` es un servicio global de plataforma, no está siloizado por SOFOM.
+ *
+ * URL: `SHORTLINK_BUSINESS_URL` (SSM `shortlink-business`, que apunta a la API PRIVADA).
+ */
+export interface IShortlinkBusinessApi {
+    /**
+     * Acorta una URL. Devuelve el código y la URL corta lista para mandar por SMS o pintar como QR.
+     *
+     * `payload.expireAt` es **obligatorio en la práctica**: va en epoch **segundos** y debe ser
+     * futuro. Si falta o ya venció, el destino responde 400 `INVALID_EXPIRE_AT`.
+     * `payload.destination` debe ser **HTTPS** o responde 400 `INVALID_DESTINATION_URL`.
+     */
+    createLink(payload: CreateShortLinkRequest): Promise<StandardResponse<CreateShortLinkResponse>>;
+}

package/src/shortlink/index.ts

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