@fiado/api-invoker 4.70.0 → 4.72.0

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

@@ -0,0 +1,75 @@
+import { StandardResponse } from "@fiado/gateway-adapter";
+
+/**
+ * Contrato del publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail)
+ * para sus endpoints privados del ciclo de venta del IMEI, consumidos por el wizard F2.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * TENANT — header `x-tenant-issuer` (NO `?tenantId=`).
+ * ─────────────────────────────────────────────────────────────────────────────
+ * A diferencia de customer/cards/loan-config (que resuelven el silo por `?tenantId=` canónico), este
+ * lambda resuelve el tenant por el ISSUER Cognito forwardeado en el header `x-tenant-issuer`
+ * (`PrivateController.issuerFromHeader` → `TenantContextService.withContext(issuer)`). Los privados son
+ * `Feature.ANONIMUS` (sin RBAC; la protección es la red VPC), así que el caller DEBE declarar el issuer.
+ *
+ * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
+ * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null); cada
+ * consumer mapea a su propio error de dominio.
+ *
+ * DTOs de catálogo/reserva: el lambda destino NO publica todavía estos shapes en `@fiado/type-kit`
+ * (`StoreCatalogItem`, `ReserveInventoryResult`), así que se declaran INLINE aquí (TD: migrar a
+ * type-kit cuando el contrato se estabilice). El shape espeja `StoreCatalogItemResponse` /
+ * `ReserveInventoryResponse` del `retail-catalog-business`.
+ *
+ * Env var requerida en el consumer: `RETAIL_CATALOG_BUSINESS_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   RETAIL_CATALOG_BUSINESS_URL: '{{resolve:ssm:retail-catalog-business}}'
+ */
+
+/** Ítem del catálogo vendible de un store (espeja `StoreCatalogItemResponse` del destino). */
+export interface StoreCatalogItem {
+    sku: string;
+    imei: string;
+    cashPriceCents: number;
+    available: boolean;
+}
+
+/** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */
+export interface ReserveInventoryResult {
+    reservationExpiresAt: string;
+}
+
+/** Body de PUT `/private/inventory/{imei}/reserve`. */
+export interface ReserveInventoryBody {
+    sku: string;
+    sessionId: string;
+}
+
+/** Body de PUT `/private/inventory/{imei}/sell` (DEC-020 del destino: `customerId` puebla `soldToCustomerId`). */
+export interface SellInventoryBody {
+    sessionId: string;
+    customerId: string;
+}
+
+/** Body de PUT `/private/inventory/{imei}/release` (DEC-018 del destino: verifica titularidad de la sesión). */
+export interface ReleaseReservationBody {
+    sessionId: string;
+}
+
+export interface IRetailCatalogBusinessApi {
+    /** GET `/private/stores/{storeId}/catalog` — catálogo vendible (sku, imei, precio de contado, disponibilidad). */
+    getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
+
+    /** PUT `/private/inventory/{imei}/reserve` — reserva atómica del IMEI para una sesión (AVAILABLE → RESERVED). */
+    reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;
+
+    /** PUT `/private/inventory/{imei}/sell` — vende el IMEI (RESERVED → SOLD). */
+    sellInventory(imei: string, body: SellInventoryBody, issuer: string): Promise<StandardResponse<void>>;
+
+    /** PUT `/private/inventory/{imei}/release` — libera la reserva (RESERVED → AVAILABLE, titularidad de la sesión). */
+    releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;
+
+    /** PUT `/private/inventory/{imei}/return` — devuelve el IMEI vendido al stock (SOLD → AVAILABLE, sin body). */
+    returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+}

package/src/retailCatalog/index.ts

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

package/src/riskProfile/api/RiskProfileApi.ts

@@ -5,6 +5,7 @@ import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/
 type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
 type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
 import { ResponseOptions } from "@fiado/gateway-adapter";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 import {
     SetCustomAlarmRequest,
     SetCustomAlarmResponse,
@@ -86,4 +87,9 @@ export default class RiskProfileApi implements IRiskProfileApi {
         return await this.httpRequest.get(url);
     }
 
+    async deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{ deletedCount: number }>> {
+        const url = `${this.baseUrl}/private/directory/${directoryId}`;
+        return await this.httpRequest.delete<FiadoApiResponse<{ deletedCount: number }>>(url);
+    }
+
 }

package/src/riskProfile/api/interfaces/IRiskProfileApi.ts

@@ -2,6 +2,7 @@ import {CreatePrivateAlarm, CreateRiskProfileRequest} from "@fiado/type-kit/bin/
 type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
 type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
 import { ResponseOptions } from "@fiado/gateway-adapter";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 import {
     SetCustomAlarmRequest,
     SetCustomAlarmResponse,
@@ -67,4 +68,12 @@ export interface IRiskProfileApi {
      * Paginación: pasar `continuationToken` de la respuesta previa; `null` = fin.
      */
     listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>>;
+
+    /**
+     * Borra en cascada el perfil de riesgo asociado a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    // TODO(type-kit): swap a Directory.DeleteByDirectoryResponse cuando se publique
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{ deletedCount: number }>>;
 }

package/src/zendesk/ZendeskApi.ts

@@ -21,4 +21,9 @@ export class ZendeskApi implements IZendeskApi {
         const url: string = `${this.baseUrl}tickets/create`;
         return await this.httpRequest.post(url,data);
     }
+
+    async deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{ deletedCount: number }>> {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete<FiadoApiResponse<{ deletedCount: number }>>(url);
+    }
 }

package/src/zendesk/interfaces/IZendeskApi.ts

@@ -7,4 +7,12 @@ import { HelpdeskCreateTicketRequest, HelpdeskCreateUserRequest } from '@fiado/t
 export interface IZendeskApi {
     createUser(data: HelpdeskCreateUserRequest): Promise<FiadoApiResponse<any>>;
     createTicket(data: HelpdeskCreateTicketRequest): Promise<FiadoApiResponse<any>>;
+
+    /**
+     * Borra en cascada los registros de Zendesk asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    // TODO(type-kit): swap a Directory.DeleteByDirectoryResponse cuando se publique
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{ deletedCount: number }>>;
 }