@fiado/api-invoker 5.66.0 → 5.68.0

package/bin/datacultrConnector/api/interfaces/IDatacultrConnectorApi.d.ts

@@ -1,5 +1,6 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { DeviceAutoLockScheduleRequest, DeviceAutoLockScheduleResponse, DeviceEnrollInitiateResponse, DeviceEnrollRequest, DeviceEnrollStatusRequest, DeviceEnrollStatusResponse, DeviceLastSeenRequest, DeviceLastSeenResponse, DeviceLockRequest, DeviceLockResponse, DeviceNotifyRequest, DeviceNotifyResponse, DevicePinUnlockRequest, DevicePinUnlockResponse, DeviceReleaseInitiateResponse, DeviceReleaseRequest, DeviceReleaseStatusRequest, DeviceReleaseStatusResponse, DeviceStatusRequest, DeviceStatusResponse, DeviceUnlockRequest, DeviceUnlockResponse } from "@fiado/type-kit/bin/mdm/index.js";
+import { DeviceBatchRequest, DeviceBatchResult, DeviceSingleResult } from "../../../utils/MdmEnvelopes.js";
 /**
  * Contrato del publisher HTTP del lambda `datacultr-connector` — el provider MDM que traduce el
  * contrato agnóstico de dispositivo (`@fiado/type-kit/bin/mdm`) a la API de Datacultr. Su consumidor
@@ -46,22 +47,7 @@ import { DeviceAutoLockScheduleRequest, DeviceAutoLockScheduleResponse, DeviceEn
  *
  * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
  */
-/**
- * Sobre de entrada de los endpoints batch del connector. No vive en `@fiado/type-kit/bin/mdm`
- * porque los DTOs publicados son de UN imei; el sobre es dominio del líder (gap E8), migrar a
- * type-kit cuando lo publique.
- */
-export interface DeviceBatchRequest<TItem> {
-    items: TItem[];
-}
-/** Sobre de salida de los endpoints batch: viaja dentro de `StandardResponse.data`. Mismo gap E8. */
-export interface DeviceBatchResult<TItem> {
-    results: TItem[];
-}
-/** Sobre de salida de los endpoints de UN solo IMEI. Hoy solo `pinUnlock` no es batch. */
-export interface DeviceSingleResult<TItem> {
-    result: TItem;
-}
+export * from "../../../utils/MdmEnvelopes.js";
 export interface IDatacultrConnectorApi {
     /**
      * POST `/devices/enroll` — pre-registra la expectativa de enrolamiento de cada IMEI.

package/bin/datacultrConnector/api/interfaces/IDatacultrConnectorApi.js

@@ -1 +1,49 @@
-export {};
+/**
+ * Contrato del publisher HTTP del lambda `datacultr-connector` — el provider MDM que traduce el
+ * contrato agnóstico de dispositivo (`@fiado/type-kit/bin/mdm`) a la API de Datacultr. Su consumidor
+ * es el módulo `device/` de `loan-credit-business` (`MdmConnectorClient`), que NUNCA le pega por
+ * `http-client` directo: entre lambdas Fiado se habla siempre por `@fiado/api-invoker`.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * PATHS — `/devices/...`, SIN prefijo `/private`.
+ * ─────────────────────────────────────────────────────────────────────────────
+ * A diferencia de la mayoría de los privados Fiado (`/private/...`), el `PrivateController` de este
+ * connector declara los paths como `/devices/enroll`, `/devices/status`, etc. El aislamiento no lo da
+ * el prefijo sino la red: la API privada es `EndpointConfiguration: PRIVATE` con ResourcePolicy que
+ * deniega todo lo que no venga de los VPC Endpoints de Fiado.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * SIN TENANT — hoy el connector es efectivamente single-tenant.
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Ningún método lleva `tenantId` porque el destino NO lo resuelve: su `PrivateController` no lee
+ * `X-Tenant-Id` ni `x-tenant-issuer` (cero referencias en el repo). Las credenciales de Datacultr
+ * salen de un único secret del lambda. DEUDA a levantar cuando el connector implemente M6
+ * (multi-tenant del MDM): ahí este contrato suma el tenant y pasa a ser un cambio MAJOR.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * AUTORIZACIÓN — `Feature.ANONIMUS`.
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Los privados del connector son `Feature.ANONIMUS`: sin RBAC y sin claims. La única protección es
+ * la VPC, así que el caller no manda `Authorization` ni headers de identidad.
+ *
+ * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
+ * Errores de transporte (falla el lambda entero, no un ítem): el publisher RECHAZA con el
+ * `DomainError` tipado del destino. Nunca fallback: el caller jamás recibe un batch vacío
+ * disfrazado de éxito.
+ *
+ * Granularidad POR ÍTEM — el batch NUNCA falla entero:
+ * - Cada `results[i]` trae su propio `status` (`SUCCESS` | `PENDING` | `ERROR`) y un `error` opcional.
+ *   Un 200 puede traer ítems en `ERROR`: el caller TIENE que recorrer `results` y decidir por ítem.
+ * - El `error.code` del ítem es un `MdmErrorCodeEnum` (`PROVIDER_NOT_SUPPORTED`, `DEVICE_NOT_FOUND`,
+ *   `PROVIDER_TIMEOUT`, …). El `status` no lleva el motivo: el motivo vive solo en `error`.
+ *
+ * Env var requerida en el consumer: `DATACULTR_CONNECTOR_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   DATACULTR_CONNECTOR_URL: '{{resolve:ssm:datacultr-connector}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ */
+// Los sobres viven en `utils/MdmEnvelopes` porque los comparten todos los connectors MDM.
+// Se re-exportan acá para no cambiar la superficie pública de `@fiado/api-invoker`.
+export * from "../../../utils/MdmEnvelopes.js";

package/bin/index.d.ts

@@ -114,3 +114,4 @@ export * from "./collection-engine/index.js";
 export * from "./domain-callback/index.js";
 export * from "./datacultrConnector/index.js";
 export * from "./webhook-business/index.js";
+export * from "./trustonicConnector/index.js";

package/bin/index.js

@@ -114,3 +114,4 @@ export * from "./collection-engine/index.js";
 export * from "./domain-callback/index.js";
 export * from "./datacultrConnector/index.js";
 export * from "./webhook-business/index.js";
+export * from "./trustonicConnector/index.js";

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/bin/trustonicConnector/api/TrustonicConnectorApi.d.ts

@@ -0,0 +1,34 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { StandardResponse } from "@fiado/gateway-adapter";
+import { DeviceAutoLockScheduleRequest, DeviceAutoLockScheduleResponse, DeviceEnrollInitiateResponse, DeviceEnrollRequest, DeviceEnrollStatusRequest, DeviceEnrollStatusResponse, DeviceLastSeenRequest, DeviceLastSeenResponse, DeviceLockRequest, DeviceLockResponse, DeviceNotifyRequest, DeviceNotifyResponse, DevicePinUnlockRequest, DevicePinUnlockResponse, DeviceReleaseInitiateResponse, DeviceReleaseRequest, DeviceReleaseStatusRequest, DeviceReleaseStatusResponse, DeviceStatusRequest, DeviceStatusResponse, DeviceUnlockRequest, DeviceUnlockResponse } from "@fiado/type-kit/bin/mdm/index.js";
+import { DeviceBatchRequest, DeviceBatchResult } from "../../utils/MdmEnvelopes.js";
+import { DeviceInitiateBatchResult, DevicePollingBatchRequest, ITrustonicConnectorApi } from "./interfaces/ITrustonicConnectorApi.js";
+/**
+ * Publisher HTTP del lambda `trustonic-connector` (segundo provider MDM de SureKeep). Contrato y
+ * semántica completos → `ITrustonicConnectorApi` (paths sin prefijo `/private`, sin tenant,
+ * `StandardResponse` → leer `result.data`, granularidad por ítem, y las cinco diferencias reales
+ * contra el connector de Datacultr).
+ *
+ * Env var requerida en el consumer: `TRUSTONIC_CONNECTOR_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   TRUSTONIC_CONNECTOR_URL: '{{resolve:ssm:trustonic-connector}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ */
+export default class TrustonicConnectorApi implements ITrustonicConnectorApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    enrollDevices(input: DeviceBatchRequest<DeviceEnrollRequest>): Promise<StandardResponse<DeviceInitiateBatchResult<DeviceEnrollInitiateResponse>>>;
+    enrollStatus(input: DevicePollingBatchRequest<DeviceEnrollStatusRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceEnrollStatusResponse>>>;
+    getStatus(input: DeviceBatchRequest<DeviceStatusRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceStatusResponse>>>;
+    getLastSeen(input: DeviceBatchRequest<DeviceLastSeenRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceLastSeenResponse>>>;
+    lockDevices(input: DeviceBatchRequest<DeviceLockRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceLockResponse>>>;
+    unlockDevices(input: DeviceBatchRequest<DeviceUnlockRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceUnlockResponse>>>;
+    autoLockSchedule(input: DeviceBatchRequest<DeviceAutoLockScheduleRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceAutoLockScheduleResponse>>>;
+    pinUnlock(input: DevicePinUnlockRequest): Promise<StandardResponse<DevicePinUnlockResponse>>;
+    notifyDevices(input: DeviceBatchRequest<DeviceNotifyRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceNotifyResponse>>>;
+    releaseDevices(input: DeviceBatchRequest<DeviceReleaseRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceReleaseInitiateResponse>>>;
+    releaseStatus(input: DevicePollingBatchRequest<DeviceReleaseStatusRequest>): Promise<StandardResponse<DeviceBatchResult<DeviceReleaseStatusResponse>>>;
+}

package/bin/trustonicConnector/api/TrustonicConnectorApi.js

@@ -0,0 +1,73 @@
+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 `trustonic-connector` (segundo provider MDM de SureKeep). Contrato y
+ * semántica completos → `ITrustonicConnectorApi` (paths sin prefijo `/private`, sin tenant,
+ * `StandardResponse` → leer `result.data`, granularidad por ítem, y las cinco diferencias reales
+ * contra el connector de Datacultr).
+ *
+ * Env var requerida en el consumer: `TRUSTONIC_CONNECTOR_URL`.
+ * El template.yml del consumer la setea con:
+ *
+ *   TRUSTONIC_CONNECTOR_URL: '{{resolve:ssm:trustonic-connector}}'
+ *
+ * Convención CLAUDE.md global: SSM key = nombre del lambda owner de la URL.
+ */
+let TrustonicConnectorApi = class TrustonicConnectorApi {
+    httpRequest;
+    // El buildspec publica la URL en SSM con "/" final — se normaliza para no armar "//devices".
+    baseUrl = (process.env.TRUSTONIC_CONNECTOR_URL || "").replace(/\/+$/, "");
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async enrollDevices(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/enroll`, input);
+    }
+    async enrollStatus(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/enroll/status`, input);
+    }
+    async getStatus(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/status`, input);
+    }
+    async getLastSeen(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/last-seen`, input);
+    }
+    async lockDevices(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/lock`, input);
+    }
+    async unlockDevices(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/unlock`, input);
+    }
+    async autoLockSchedule(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/auto-lock-schedule`, input);
+    }
+    async pinUnlock(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/pin-unlock`, input);
+    }
+    async notifyDevices(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/notify`, input);
+    }
+    async releaseDevices(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/release`, input);
+    }
+    async releaseStatus(input) {
+        return await this.httpRequest.post(`${this.baseUrl}/devices/release/status`, input);
+    }
+};
+TrustonicConnectorApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], TrustonicConnectorApi);
+export default TrustonicConnectorApi;