@fiado/api-invoker 5.67.0 → 5.68.0

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

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { LoanDeviceEnrollRequest, LoanDeviceEnrollResponse, LoanDeviceEnrollStatusRequest, LoanDeviceEnrollStatusResponse, LoanDeviceLastSeenRequest, LoanDeviceLastSeenResponse, LoanDeviceManualLockRequest, LoanDeviceManualLockResponse, LoanDeviceManualUnlockRequest, LoanDeviceManualUnlockResponse, LoanDeviceStatusRequest, LoanDeviceStatusResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { LoanDeviceEnrollRequest, LoanDeviceEnrollResponse, LoanDeviceEnrollStatusRequest, LoanDeviceEnrollStatusResponse, LoanDeviceLastSeenRequest, LoanDeviceLastSeenResponse, LoanDeviceManualLockRequest, LoanDeviceManualLockResponse, LoanDeviceManualUnlockRequest, LoanDeviceManualUnlockResponse, LoanDeviceNotifyRequest, LoanDeviceNotifyResponse, LoanDeviceReleaseRequest, LoanDeviceReleaseResponse, LoanDeviceStatusRequest, LoanDeviceStatusResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { ILoanCreditDeviceApi } from "./interfaces/ILoanCreditDeviceApi.js";
 /**
  * Publisher HTTP de los endpoints de dispositivo/MDM del lambda `loan-credit-business`
@@ -18,10 +18,13 @@ export default class LoanCreditDeviceApi implements ILoanCreditDeviceApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
+    private assertBatchSize;
     enroll(input: LoanDeviceEnrollRequest, tenantId: string): Promise<StandardResponse<LoanDeviceEnrollResponse>>;
     getEnrollStatus(input: LoanDeviceEnrollStatusRequest, tenantId: string): Promise<StandardResponse<LoanDeviceEnrollStatusResponse>>;
     getStatus(input: LoanDeviceStatusRequest, tenantId: string): Promise<StandardResponse<LoanDeviceStatusResponse>>;
     getLastSeen(input: LoanDeviceLastSeenRequest, tenantId: string): Promise<StandardResponse<LoanDeviceLastSeenResponse>>;
     manualLock(input: LoanDeviceManualLockRequest, tenantId: string): Promise<StandardResponse<LoanDeviceManualLockResponse>>;
     manualUnlock(input: LoanDeviceManualUnlockRequest, tenantId: string): Promise<StandardResponse<LoanDeviceManualUnlockResponse>>;
+    notify(input: LoanDeviceNotifyRequest, tenantId: string): Promise<StandardResponse<LoanDeviceNotifyResponse>>;
+    release(input: LoanDeviceReleaseRequest, tenantId: string): Promise<StandardResponse<LoanDeviceReleaseResponse>>;
 }

package/bin/loanCredit/api/LoanCreditDeviceApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+import { LOAN_DEVICE_MAX_BATCH, } from "@fiado/type-kit/bin/loanCredit/index.js";
 /**
  * Publisher HTTP de los endpoints de dispositivo/MDM del lambda `loan-credit-business`
  * (componente 09 SureKeep F2). Contrato y semántica completos → `ILoanCreditDeviceApi`
@@ -30,6 +31,12 @@ let LoanCreditDeviceApi = class LoanCreditDeviceApi {
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
+    // Se corta aquí: mandar un lote que el destino va a rechazar solo gasta un round-trip.
+    assertBatchSize(itemCount) {
+        if (itemCount > LOAN_DEVICE_MAX_BATCH) {
+            throw new Error(`El lote admite hasta ${LOAN_DEVICE_MAX_BATCH} ítems y llegaron ${itemCount}`);
+        }
+    }
     async enroll(input, tenantId) {
         const url = `${this.baseUrl}/private/devices/enroll?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
@@ -54,6 +61,16 @@ let LoanCreditDeviceApi = class LoanCreditDeviceApi {
         const url = `${this.baseUrl}/private/devices/manual-unlock?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async notify(input, tenantId) {
+        this.assertBatchSize(input.items.length);
+        const url = `${this.baseUrl}/private/devices/notify?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async release(input, tenantId) {
+        this.assertBatchSize(input.items.length);
+        const url = `${this.baseUrl}/private/devices/release?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
 };
 LoanCreditDeviceApi = __decorate([
     injectable(),

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

@@ -1,9 +1,10 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { LoanDeviceEnrollRequest, LoanDeviceEnrollResponse, LoanDeviceEnrollStatusRequest, LoanDeviceEnrollStatusResponse, LoanDeviceLastSeenRequest, LoanDeviceLastSeenResponse, LoanDeviceManualLockRequest, LoanDeviceManualLockResponse, LoanDeviceManualUnlockRequest, LoanDeviceManualUnlockResponse, LoanDeviceStatusRequest, LoanDeviceStatusResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { LoanDeviceEnrollRequest, LoanDeviceEnrollResponse, LoanDeviceEnrollStatusRequest, LoanDeviceEnrollStatusResponse, LoanDeviceLastSeenRequest, LoanDeviceLastSeenResponse, LoanDeviceManualLockRequest, LoanDeviceManualLockResponse, LoanDeviceManualUnlockRequest, LoanDeviceManualUnlockResponse, LoanDeviceNotifyRequest, LoanDeviceNotifyResponse, LoanDeviceReleaseRequest, LoanDeviceReleaseResponse, LoanDeviceStatusRequest, LoanDeviceStatusResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
 /**
  * Contrato del publisher de dispositivo/MDM de `loan-credit-business` (componente 09 SureKeep F2).
- * Endpoints PRIVADOS (VPC) que envuelven al motor MDM: enrolamiento del equipo, consulta de estado
- * y bloqueo/desbloqueo manual. El contrato de crédito vive en `ILoanCreditBusinessApi`.
+ * Endpoints PRIVADOS (VPC) que envuelven al motor MDM: enrolamiento del equipo, consulta de estado,
+ * bloqueo/desbloqueo manual, aviso de cobranza y liberación definitiva. El contrato de crédito vive
+ * en `ILoanCreditBusinessApi`.
  *
  * Convenciones (idénticas a `ILoanCreditBusinessApi`):
  * - `tenantId` OBLIGATORIO en todos los métodos — viaja por query `?tenantId=` (convención de los
@@ -12,9 +13,12 @@ import { LoanDeviceEnrollRequest, LoanDeviceEnrollResponse, LoanDeviceEnrollStat
  * - Errores de transporte (falla el lambda entero, no un ítem): el publisher RECHAZA con el
  *   `DomainError` tipado del motor — `400 UNKNOWN_TENANT` / `400` de validación del body /
  *   `5xx` del motor. Nunca fallback: el caller jamás recibe un batch vacío disfrazado de éxito.
- * - Idempotencia: las 3 mutaciones (`enroll`, `manualLock`, `manualUnlock`) son idempotentes por
- *   `input.operationReference` — es el idempotencyKey del caller. Reintentar el mismo lote con la
- *   misma referencia no vuelve a enrolar ni a bloquear; sin ella un retry tras timeout duplica.
+ * - Techo de lote: `notify` y `release` cortan acá el lote de más de `LOAN_DEVICE_MAX_BATCH` ítems,
+ *   sin salir a la red. DEUDA: los otros seis mandan el body tal cual y devuelven el 400 del
+ *   destino, que valida el mismo techo — dos formas de error para la misma causa.
+ * - Idempotencia: las mutaciones (`enroll`, `manualLock`, `manualUnlock`, `notify`, `release`) son
+ *   idempotentes por `input.operationReference` — es el idempotencyKey del caller. Reintentar el
+ *   mismo lote con la misma referencia no repite la operación; sin ella un retry tras timeout duplica.
  *
  * Granularidad POR ÍTEM — el batch NUNCA falla entero:
  * - Cada `results[i]` trae su propio `status` (`SUCCESS` | `PENDING` | `ERROR`) y un `error`
@@ -52,6 +56,30 @@ export interface ILoanCreditDeviceApi {
     getLastSeen(input: LoanDeviceLastSeenRequest, tenantId: string): Promise<StandardResponse<LoanDeviceLastSeenResponse>>;
     /** Bloqueo manual del dispositivo disparado desde el backoffice (acción de un operador). */
     manualLock(input: LoanDeviceManualLockRequest, tenantId: string): Promise<StandardResponse<LoanDeviceManualLockResponse>>;
-    /** Desbloqueo manual del dispositivo disparado desde el backoffice (acción de un operador). */
+    /**
+     * Desbloqueo manual del dispositivo disparado desde el backoffice (acción de un operador).
+     *
+     * ⚠️ El `unlockUntil` del ítem solo aplica en modo `SCHEDULED` y HOY `loan-credit-business` no
+     * lo lee: su `IDeviceControlService.manualUnlock` recibe `{ creditId }` y lo descarta en silencio.
+     */
     manualUnlock(input: LoanDeviceManualUnlockRequest, tenantId: string): Promise<StandardResponse<LoanDeviceManualUnlockResponse>>;
+    /**
+     * Manda al dispositivo el aviso de cobranza (banner o pantalla completa) sin bloquearlo.
+     *
+     * ⚠️ `loan-credit-business` TODAVÍA NO publica esta ruta: no está en su `openapi/private.yaml`
+     * ni en su `PrivateController`. Cablear un consumer antes de ese deploy devuelve 403/404.
+     *
+     * @throws Error si el lote supera `LOAN_DEVICE_MAX_BATCH` ítems (se corta acá, sin salir a la red).
+     */
+    notify(input: LoanDeviceNotifyRequest, tenantId: string): Promise<StandardResponse<LoanDeviceNotifyResponse>>;
+    /**
+     * Libera el dispositivo del MDM de forma DEFINITIVA (crédito liquidado o castigado contablemente).
+     * No es un desbloqueo: saca el equipo del control del proveedor y no se revierte con `manualLock`.
+     *
+     * ⚠️ `loan-credit-business` TODAVÍA NO publica esta ruta: no está en su `openapi/private.yaml`
+     * ni en su `PrivateController`. Cablear un consumer antes de ese deploy devuelve 403/404.
+     *
+     * @throws Error si el lote supera `LOAN_DEVICE_MAX_BATCH` ítems (se corta acá, sin salir a la red).
+     */
+    release(input: LoanDeviceReleaseRequest, tenantId: string): Promise<StandardResponse<LoanDeviceReleaseResponse>>;
 }

package/bin/retailCatalog/api/RetailCatalogBusinessApi.d.ts

@@ -1,6 +1,7 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ImeiProductLookupResponse, IRetailCatalogBusinessApi, ProductsByRetailersResponse, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
+import type { ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import { IRetailCatalogBusinessApi, ProductsByRetailersResponse, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail) para sus
  * endpoints privados del ciclo de venta del IMEI. Contrato y semántica completos →
@@ -20,7 +21,7 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     constructor(httpRequest: IHttpRequest);
     private tenantHeader;
     getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
-    getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
+    validateProduct(retailerId: string, sku: string, issuer: string): Promise<StandardResponse<ValidateProductResponse>>;
     getProductsByRetailers(retailerIds: string[], tenantId: string): Promise<StandardResponse<ProductsByRetailersResponse>>;
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;
     sellInventory(imei: string, body: SellInventoryBody, issuer: string): Promise<StandardResponse<void>>;

package/bin/retailCatalog/api/RetailCatalogBusinessApi.js

@@ -11,7 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
-import { IMEI_PRODUCT_BATCH_MAX, RETAILER_PRODUCTS_BATCH_MAX, } from "./interfaces/IRetailCatalogBusinessApi.js";
+import { RETAILER_PRODUCTS_BATCH_MAX, } from "./interfaces/IRetailCatalogBusinessApi.js";
 /** Header por el que el destino resuelve el silo (issuer Cognito forwardeado por el caller). */
 const TENANT_ISSUER_HEADER = "x-tenant-issuer";
 /**
@@ -41,15 +41,9 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
         const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/catalog`;
         return await this.httpRequest.get(url, undefined, this.tenantHeader(issuer));
     }
-    async getProductsByImei(imeis, tenantId) {
-        // Se corta acá: mandar un lote que el destino va a rechazar solo gasta un round-trip.
-        if (imeis.length > IMEI_PRODUCT_BATCH_MAX) {
-            throw new Error(`El lote admite hasta ${IMEI_PRODUCT_BATCH_MAX} IMEIs y llegaron ${imeis.length}`);
-        }
-        // `URLSearchParams` codifica la coma del separador; el destino hace `split(',')` sobre el
-        // valor ya decodificado por API Gateway.
-        const query = new URLSearchParams({ imeis: imeis.join(","), tenantId });
-        return await this.httpRequest.get(`${this.baseUrl}/private/products/by-imei?${query.toString()}`);
+    async validateProduct(retailerId, sku, issuer) {
+        const path = `${encodeURIComponent(retailerId)}/${encodeURIComponent(sku)}`;
+        return await this.httpRequest.get(`${this.baseUrl}/private/products/${path}`, undefined, this.tenantHeader(issuer));
     }
     async getProductsByRetailers(retailerIds, tenantId) {
         // Se corta aquí: mandar un lote que el destino va a rechazar solo gasta un round-trip.

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

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { MdmLockModeEnum, MdmProviderEnum } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type { MdmLockModeEnum, MdmProviderEnum, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
 /**
  * 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.
@@ -7,15 +7,15 @@ import type { MdmLockModeEnum, MdmProviderEnum } from "@fiado/type-kit/bin/retai
  * ─────────────────────────────────────────────────────────────────────────────
  * TENANT — DOS convenciones conviven acá. Mirá la firma de cada método.
  * ─────────────────────────────────────────────────────────────────────────────
- * Los cinco métodos del ciclo de venta del IMEI toman `issuer` y lo mandan en el header
+ * Todos los métodos menos `getProductsByRetailers` toman `issuer` y lo mandan en el header
  * `x-tenant-issuer` (`PrivateController.issuerFromHeader` → `TenantContextService.withContext`).
- * `getProductsByImei` toma `tenantId` y lo manda por `?tenantId=`
+ * `getProductsByRetailers` toma `tenantId` y lo manda por `?tenantId=`
  * (→ `TenantContextService.withContextByTenantId`), porque su consumidor es un backoffice que no
  * tiene el issuer Cognito. Los privados son `Feature.ANONIMUS` (sin RBAC; la protección es la red
  * VPC), así que el caller DEBE declarar uno de los dos — no hay default.
  *
- * TD: converger los cinco del ciclo de venta a `?tenantId=`, el camino canónico para
- * service-to-service. No se migran acá para no romper al wizard, que ya consume el header.
+ * TD: converger los que van por header a `?tenantId=`, el camino canónico para service-to-service
+ * (TD-014 del destino). No se migran acá para no romper al wizard, que ya consume el header.
  *
  * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
  * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null); cada
@@ -58,28 +58,6 @@ export interface StoreCatalogItem {
     /** Modo de bloqueo pactado; `null` si el producto no lleva MDM. */
     mdmLockMode: MdmLockModeEnum | null;
 }
-/** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
-export declare const IMEI_PRODUCT_BATCH_MAX = 100;
-/** Por que se pudo (o no) resolver el producto de un IMEI del lote. */
-export type ImeiProductLookupStatus = "OK" | "NOT_FOUND" | "UNAVAILABLE" | "INVALID_ID";
-/** Una entrada del lote IMEI->producto (espeja `ImeiProductLookupEntry` del destino). */
-export interface ImeiProductLookupEntry {
-    imei: string;
-    /**
-     * `OK` trae sku/brand/model · `NOT_FOUND` el catalogo no llega al producto (dato POSITIVO) ·
-     * `UNAVAILABLE` no se pudo leer ese IMEI, reintentalo · `INVALID_ID` no tiene forma de IMEI.
-     */
-    status: ImeiProductLookupStatus;
-    sku?: string;
-    /** Marca comercial (p. ej. "Apple"). Solo viene con `status: OK`. */
-    brand?: string;
-    /** Modelo (p. ej. "iPhone 15 Pro"). Solo viene con `status: OK`. */
-    model?: string;
-}
-/** Respuesta del lote: UNA entrada por IMEI pedido, en el MISMO orden. */
-export interface ImeiProductLookupResponse {
-    items: ImeiProductLookupEntry[];
-}
 /** Techo de cadenas por request del lote cadena->catálogo. Lo declara y lo honra el destino. */
 export declare const RETAILER_PRODUCTS_BATCH_MAX = 100;
 /** Body de POST `/private/products/by-retailers`. */
@@ -126,29 +104,20 @@ 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[]>>;
     /**
-     * GET `/private/products/by-imei?imeis=&tenantId=` — resuelve un lote de IMEIs a su producto
-     * (sku + marca + modelo). Para los lambdas que del equipo solo guardan el IMEI.
-     *
-     * ─────────────────────────────────────────────────────────────────────────────
-     * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
-     * ─────────────────────────────────────────────────────────────────────────────
-     * El consumidor es un backoffice que solo tiene el `tenantId` de su contexto; el issuer Cognito
-     * no existe de su lado. El destino entra por `TenantContextService.withContextByTenantId`, con las
-     * mismas garantías (mismo diccionario, AssumeRole del silo, fail-closed sin tenant).
+     * GET `/private/products/{retailerId}/{sku}` — valida que el producto exista y devuelve su
+     * `status`, su `tier`, sus financieras elegibles y su política MDM.
      *
-     * ── El contrato del lote ────────────────────────────────────────────────────────────────────
-     * Devuelve UNA entrada por cada IMEI pedido, en el MISMO orden — el caller nunca reconcilia. Los
-     * repetidos se consultan una sola vez pero salen repetidos. Techo de `IMEI_PRODUCT_BATCH_MAX`
-     * IMEIs por request; el caller parte los lotes mayores.
+     * ⚠️ El tenant va en el header `x-tenant-issuer`, NO por `?tenantId=` — el destino lo resuelve
+     * con `issuerFromHeader` y su `openapi/private.yaml` no declara ningún parámetro de tenant.
      *
-     * Ningún IMEI tumba el lote: el mal formado sale `INVALID_ID`, el que el catálogo no alcanza a
-     * resolver sale `NOT_FOUND` y el que DynamoDB no llegó a leer sale `UNAVAILABLE` (reintentable).
-     * Solo un fallo total del destino rechaza la promesa.
+     * La política MDM viaja completa cuando `mdmEnabled: true`; con `false`, `mdmProvider` y
+     * `mdmLockMode` vienen en `null` (invariante `validateMdmCoherence` del catálogo).
      *
-     * @throws Error si el lote supera el techo (se corta acá, sin salir a la red) ·
-     *   `400 IMEI_BATCH_REQUIRED` si `imeis` viene vacío · `400 UNKNOWN_TENANT` sin `tenantId`.
+     * @throws `404 PRODUCT_NOT_FOUND` el producto no existe para esa cadena ·
+     *   `400 UNKNOWN_TENANT` falta o no se reconoce el issuer ·
+     *   `500 TENANT_ASSUME_ROLE_FAILED` fallo de infra del silo.
      */
-    getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
+    validateProduct(retailerId: string, sku: string, issuer: string): Promise<StandardResponse<ValidateProductResponse>>;
     /**
      * POST `/private/products/by-retailers?tenantId=` — catálogo de productos de VARIAS cadenas en
      * una sola llamada, para el consumidor que arma su vista con N cadenas y no quiere N requests.
@@ -156,8 +125,8 @@ export interface IRetailCatalogBusinessApi {
      * ─────────────────────────────────────────────────────────────────────────────
      * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
      * ─────────────────────────────────────────────────────────────────────────────
-     * Es obligatorio. El destino entra por `TenantContextService.withContextByTenantId`, igual que
-     * `getProductsByImei`.
+     * Es obligatorio. El destino entra por `TenantContextService.withContextByTenantId`, con las
+     * mismas garantías (mismo diccionario, AssumeRole del silo, fail-closed sin tenant).
      *
      * ── El contrato del lote ────────────────────────────────────────────────────────────────────
      * `retailerIds` no puede venir vacío, sin repetidos y con un techo de

package/bin/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.js

@@ -1,4 +1,2 @@
-/** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
-export const IMEI_PRODUCT_BATCH_MAX = 100;
 /** Techo de cadenas por request del lote cadena->catálogo. Lo declara y lo honra el destino. */
 export const RETAILER_PRODUCTS_BATCH_MAX = 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.67.0",
+  "version": "5.68.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",

package/src/loanCredit/api/LoanCreditDeviceApi.ts

@@ -2,6 +2,7 @@ import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
+    LOAN_DEVICE_MAX_BATCH,
     LoanDeviceEnrollRequest,
     LoanDeviceEnrollResponse,
     LoanDeviceEnrollStatusRequest,
@@ -12,6 +13,10 @@ import {
     LoanDeviceManualLockResponse,
     LoanDeviceManualUnlockRequest,
     LoanDeviceManualUnlockResponse,
+    LoanDeviceNotifyRequest,
+    LoanDeviceNotifyResponse,
+    LoanDeviceReleaseRequest,
+    LoanDeviceReleaseResponse,
     LoanDeviceStatusRequest,
     LoanDeviceStatusResponse,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
@@ -36,6 +41,13 @@ export default class LoanCreditDeviceApi implements ILoanCreditDeviceApi {
 
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
 
+    // Se corta aquí: mandar un lote que el destino va a rechazar solo gasta un round-trip.
+    private assertBatchSize(itemCount: number): void {
+        if (itemCount > LOAN_DEVICE_MAX_BATCH) {
+            throw new Error(`El lote admite hasta ${LOAN_DEVICE_MAX_BATCH} ítems y llegaron ${itemCount}`);
+        }
+    }
+
     async enroll(
         input: LoanDeviceEnrollRequest,
         tenantId: string,
@@ -83,4 +95,22 @@ export default class LoanCreditDeviceApi implements ILoanCreditDeviceApi {
         const url = `${this.baseUrl}/private/devices/manual-unlock?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+
+    async notify(
+        input: LoanDeviceNotifyRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanDeviceNotifyResponse>> {
+        this.assertBatchSize(input.items.length);
+        const url = `${this.baseUrl}/private/devices/notify?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async release(
+        input: LoanDeviceReleaseRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanDeviceReleaseResponse>> {
+        this.assertBatchSize(input.items.length);
+        const url = `${this.baseUrl}/private/devices/release?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
 }

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

@@ -10,14 +10,19 @@ import {
     LoanDeviceManualLockResponse,
     LoanDeviceManualUnlockRequest,
     LoanDeviceManualUnlockResponse,
+    LoanDeviceNotifyRequest,
+    LoanDeviceNotifyResponse,
+    LoanDeviceReleaseRequest,
+    LoanDeviceReleaseResponse,
     LoanDeviceStatusRequest,
     LoanDeviceStatusResponse,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 
 /**
  * Contrato del publisher de dispositivo/MDM de `loan-credit-business` (componente 09 SureKeep F2).
- * Endpoints PRIVADOS (VPC) que envuelven al motor MDM: enrolamiento del equipo, consulta de estado
- * y bloqueo/desbloqueo manual. El contrato de crédito vive en `ILoanCreditBusinessApi`.
+ * Endpoints PRIVADOS (VPC) que envuelven al motor MDM: enrolamiento del equipo, consulta de estado,
+ * bloqueo/desbloqueo manual, aviso de cobranza y liberación definitiva. El contrato de crédito vive
+ * en `ILoanCreditBusinessApi`.
  *
  * Convenciones (idénticas a `ILoanCreditBusinessApi`):
  * - `tenantId` OBLIGATORIO en todos los métodos — viaja por query `?tenantId=` (convención de los
@@ -26,9 +31,12 @@ import {
  * - Errores de transporte (falla el lambda entero, no un ítem): el publisher RECHAZA con el
  *   `DomainError` tipado del motor — `400 UNKNOWN_TENANT` / `400` de validación del body /
  *   `5xx` del motor. Nunca fallback: el caller jamás recibe un batch vacío disfrazado de éxito.
- * - Idempotencia: las 3 mutaciones (`enroll`, `manualLock`, `manualUnlock`) son idempotentes por
- *   `input.operationReference` — es el idempotencyKey del caller. Reintentar el mismo lote con la
- *   misma referencia no vuelve a enrolar ni a bloquear; sin ella un retry tras timeout duplica.
+ * - Techo de lote: `notify` y `release` cortan acá el lote de más de `LOAN_DEVICE_MAX_BATCH` ítems,
+ *   sin salir a la red. DEUDA: los otros seis mandan el body tal cual y devuelven el 400 del
+ *   destino, que valida el mismo techo — dos formas de error para la misma causa.
+ * - Idempotencia: las mutaciones (`enroll`, `manualLock`, `manualUnlock`, `notify`, `release`) son
+ *   idempotentes por `input.operationReference` — es el idempotencyKey del caller. Reintentar el
+ *   mismo lote con la misma referencia no repite la operación; sin ella un retry tras timeout duplica.
  *
  * Granularidad POR ÍTEM — el batch NUNCA falla entero:
  * - Cada `results[i]` trae su propio `status` (`SUCCESS` | `PENDING` | `ERROR`) y un `error`
@@ -86,9 +94,41 @@ export interface ILoanCreditDeviceApi {
         tenantId: string,
     ): Promise<StandardResponse<LoanDeviceManualLockResponse>>;
 
-    /** Desbloqueo manual del dispositivo disparado desde el backoffice (acción de un operador). */
+    /**
+     * Desbloqueo manual del dispositivo disparado desde el backoffice (acción de un operador).
+     *
+     * ⚠️ El `unlockUntil` del ítem solo aplica en modo `SCHEDULED` y HOY `loan-credit-business` no
+     * lo lee: su `IDeviceControlService.manualUnlock` recibe `{ creditId }` y lo descarta en silencio.
+     */
     manualUnlock(
         input: LoanDeviceManualUnlockRequest,
         tenantId: string,
     ): Promise<StandardResponse<LoanDeviceManualUnlockResponse>>;
+
+    /**
+     * Manda al dispositivo el aviso de cobranza (banner o pantalla completa) sin bloquearlo.
+     *
+     * ⚠️ `loan-credit-business` TODAVÍA NO publica esta ruta: no está en su `openapi/private.yaml`
+     * ni en su `PrivateController`. Cablear un consumer antes de ese deploy devuelve 403/404.
+     *
+     * @throws Error si el lote supera `LOAN_DEVICE_MAX_BATCH` ítems (se corta acá, sin salir a la red).
+     */
+    notify(
+        input: LoanDeviceNotifyRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanDeviceNotifyResponse>>;
+
+    /**
+     * Libera el dispositivo del MDM de forma DEFINITIVA (crédito liquidado o castigado contablemente).
+     * No es un desbloqueo: saca el equipo del control del proveedor y no se revierte con `manualLock`.
+     *
+     * ⚠️ `loan-credit-business` TODAVÍA NO publica esta ruta: no está en su `openapi/private.yaml`
+     * ni en su `PrivateController`. Cablear un consumer antes de ese deploy devuelve 403/404.
+     *
+     * @throws Error si el lote supera `LOAN_DEVICE_MAX_BATCH` ítems (se corta acá, sin salir a la red).
+     */
+    release(
+        input: LoanDeviceReleaseRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanDeviceReleaseResponse>>;
 }

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -1,9 +1,8 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
+import type { ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
 import {
-    IMEI_PRODUCT_BATCH_MAX,
-    ImeiProductLookupResponse,
     IRetailCatalogBusinessApi,
     ProductsByRetailersBody,
     ProductsByRetailersResponse,
@@ -47,18 +46,17 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
         return await this.httpRequest.get(url, undefined, this.tenantHeader(issuer));
     }
 
-    async getProductsByImei(
-        imeis: string[],
-        tenantId: string,
-    ): Promise<StandardResponse<ImeiProductLookupResponse>> {
-        // Se corta acá: mandar un lote que el destino va a rechazar solo gasta un round-trip.
-        if (imeis.length > IMEI_PRODUCT_BATCH_MAX) {
-            throw new Error(`El lote admite hasta ${IMEI_PRODUCT_BATCH_MAX} IMEIs y llegaron ${imeis.length}`);
-        }
-        // `URLSearchParams` codifica la coma del separador; el destino hace `split(',')` sobre el
-        // valor ya decodificado por API Gateway.
-        const query = new URLSearchParams({ imeis: imeis.join(","), tenantId });
-        return await this.httpRequest.get(`${this.baseUrl}/private/products/by-imei?${query.toString()}`);
+    async validateProduct(
+        retailerId: string,
+        sku: string,
+        issuer: string,
+    ): Promise<StandardResponse<ValidateProductResponse>> {
+        const path = `${encodeURIComponent(retailerId)}/${encodeURIComponent(sku)}`;
+        return await this.httpRequest.get(
+            `${this.baseUrl}/private/products/${path}`,
+            undefined,
+            this.tenantHeader(issuer),
+        );
     }
 
     async getProductsByRetailers(

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

@@ -1,5 +1,9 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { MdmLockModeEnum, MdmProviderEnum } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type {
+    MdmLockModeEnum,
+    MdmProviderEnum,
+    ValidateProductResponse,
+} from "@fiado/type-kit/bin/retailCatalog/index.js";
 
 /**
  * Contrato del publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail)
@@ -8,15 +12,15 @@ import type { MdmLockModeEnum, MdmProviderEnum } from "@fiado/type-kit/bin/retai
  * ─────────────────────────────────────────────────────────────────────────────
  * TENANT — DOS convenciones conviven acá. Mirá la firma de cada método.
  * ─────────────────────────────────────────────────────────────────────────────
- * Los cinco métodos del ciclo de venta del IMEI toman `issuer` y lo mandan en el header
+ * Todos los métodos menos `getProductsByRetailers` toman `issuer` y lo mandan en el header
  * `x-tenant-issuer` (`PrivateController.issuerFromHeader` → `TenantContextService.withContext`).
- * `getProductsByImei` toma `tenantId` y lo manda por `?tenantId=`
+ * `getProductsByRetailers` toma `tenantId` y lo manda por `?tenantId=`
  * (→ `TenantContextService.withContextByTenantId`), porque su consumidor es un backoffice que no
  * tiene el issuer Cognito. Los privados son `Feature.ANONIMUS` (sin RBAC; la protección es la red
  * VPC), así que el caller DEBE declarar uno de los dos — no hay default.
  *
- * TD: converger los cinco del ciclo de venta a `?tenantId=`, el camino canónico para
- * service-to-service. No se migran acá para no romper al wizard, que ya consume el header.
+ * TD: converger los que van por header a `?tenantId=`, el camino canónico para service-to-service
+ * (TD-014 del destino). No se migran acá para no romper al wizard, que ya consume el header.
  *
  * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
  * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null); cada
@@ -67,32 +71,6 @@ export interface StoreCatalogItem {
     mdmLockMode: MdmLockModeEnum | null;
 }
 
-/** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
-export const IMEI_PRODUCT_BATCH_MAX = 100;
-
-/** Por que se pudo (o no) resolver el producto de un IMEI del lote. */
-export type ImeiProductLookupStatus = "OK" | "NOT_FOUND" | "UNAVAILABLE" | "INVALID_ID";
-
-/** Una entrada del lote IMEI->producto (espeja `ImeiProductLookupEntry` del destino). */
-export interface ImeiProductLookupEntry {
-    imei: string;
-    /**
-     * `OK` trae sku/brand/model · `NOT_FOUND` el catalogo no llega al producto (dato POSITIVO) ·
-     * `UNAVAILABLE` no se pudo leer ese IMEI, reintentalo · `INVALID_ID` no tiene forma de IMEI.
-     */
-    status: ImeiProductLookupStatus;
-    sku?: string;
-    /** Marca comercial (p. ej. "Apple"). Solo viene con `status: OK`. */
-    brand?: string;
-    /** Modelo (p. ej. "iPhone 15 Pro"). Solo viene con `status: OK`. */
-    model?: string;
-}
-
-/** Respuesta del lote: UNA entrada por IMEI pedido, en el MISMO orden. */
-export interface ImeiProductLookupResponse {
-    items: ImeiProductLookupEntry[];
-}
-
 /** Techo de cadenas por request del lote cadena->catálogo. Lo declara y lo honra el destino. */
 export const RETAILER_PRODUCTS_BATCH_MAX = 100;
 
@@ -148,29 +126,24 @@ export interface IRetailCatalogBusinessApi {
     getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
 
     /**
-     * GET `/private/products/by-imei?imeis=&tenantId=` — resuelve un lote de IMEIs a su producto
-     * (sku + marca + modelo). Para los lambdas que del equipo solo guardan el IMEI.
-     *
-     * ─────────────────────────────────────────────────────────────────────────────
-     * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
-     * ─────────────────────────────────────────────────────────────────────────────
-     * El consumidor es un backoffice que solo tiene el `tenantId` de su contexto; el issuer Cognito
-     * no existe de su lado. El destino entra por `TenantContextService.withContextByTenantId`, con las
-     * mismas garantías (mismo diccionario, AssumeRole del silo, fail-closed sin tenant).
+     * GET `/private/products/{retailerId}/{sku}` — valida que el producto exista y devuelve su
+     * `status`, su `tier`, sus financieras elegibles y su política MDM.
      *
-     * ── El contrato del lote ────────────────────────────────────────────────────────────────────
-     * Devuelve UNA entrada por cada IMEI pedido, en el MISMO orden — el caller nunca reconcilia. Los
-     * repetidos se consultan una sola vez pero salen repetidos. Techo de `IMEI_PRODUCT_BATCH_MAX`
-     * IMEIs por request; el caller parte los lotes mayores.
+     * ⚠️ El tenant va en el header `x-tenant-issuer`, NO por `?tenantId=` — el destino lo resuelve
+     * con `issuerFromHeader` y su `openapi/private.yaml` no declara ningún parámetro de tenant.
      *
-     * Ningún IMEI tumba el lote: el mal formado sale `INVALID_ID`, el que el catálogo no alcanza a
-     * resolver sale `NOT_FOUND` y el que DynamoDB no llegó a leer sale `UNAVAILABLE` (reintentable).
-     * Solo un fallo total del destino rechaza la promesa.
+     * La política MDM viaja completa cuando `mdmEnabled: true`; con `false`, `mdmProvider` y
+     * `mdmLockMode` vienen en `null` (invariante `validateMdmCoherence` del catálogo).
      *
-     * @throws Error si el lote supera el techo (se corta acá, sin salir a la red) ·
-     *   `400 IMEI_BATCH_REQUIRED` si `imeis` viene vacío · `400 UNKNOWN_TENANT` sin `tenantId`.
+     * @throws `404 PRODUCT_NOT_FOUND` el producto no existe para esa cadena ·
+     *   `400 UNKNOWN_TENANT` falta o no se reconoce el issuer ·
+     *   `500 TENANT_ASSUME_ROLE_FAILED` fallo de infra del silo.
      */
-    getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
+    validateProduct(
+        retailerId: string,
+        sku: string,
+        issuer: string,
+    ): Promise<StandardResponse<ValidateProductResponse>>;
 
     /**
      * POST `/private/products/by-retailers?tenantId=` — catálogo de productos de VARIAS cadenas en
@@ -179,8 +152,8 @@ export interface IRetailCatalogBusinessApi {
      * ─────────────────────────────────────────────────────────────────────────────
      * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
      * ─────────────────────────────────────────────────────────────────────────────
-     * Es obligatorio. El destino entra por `TenantContextService.withContextByTenantId`, igual que
-     * `getProductsByImei`.
+     * Es obligatorio. El destino entra por `TenantContextService.withContextByTenantId`, con las
+     * mismas garantías (mismo diccionario, AssumeRole del silo, fail-closed sin tenant).
      *
      * ── El contrato del lote ────────────────────────────────────────────────────────────────────
      * `retailerIds` no puede venir vacío, sin repetidos y con un techo de