@fiado/api-invoker 4.49.0 → 4.51.0

package/bin/identity/IdentityApi.d.ts

@@ -1,5 +1,6 @@
 import { IIdentityApi } from "./interfaces/IIdentityApi.js";
-import { IHttpRequest } from "@fiado/http-client";
+import { LegacyApiResponse } from "./interfaces/LegacyApiResponse.js";
+import type { IHttpRequest } from "@fiado/http-client";
 import { PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse, PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse } from "@fiado/type-kit/bin/identity/index.js";
 export declare class IdentityApi implements IIdentityApi {
     private httpRequest;
@@ -13,8 +14,10 @@ export declare class IdentityApi implements IIdentityApi {
     getPeopleByFullName(fullName: string): Promise<any>;
     privateGetDocumentsUrlSigned(directoryId: string, documentNames: string[]): Promise<any>;
     getUserDocuments(directoryId: string): Promise<any>;
-    privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse>;
-    privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]>;
-    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse>;
-    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void>;
+    privateGetPeopleByDirectoryId(directoryId: string): Promise<LegacyApiResponse<PeopleResponse>>;
+    privateGetLastAgentDocument(directoryId: string): Promise<LegacyApiResponse<AgentDocumentKeyResponse[]>>;
+    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<LegacyApiResponse<DocumentUploadResponse>>;
+    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<LegacyApiResponse<unknown>>;
+    privateSearchPeople(fullName: string): Promise<LegacyApiResponse<PeopleResponse[]>>;
+    privateUpdatePeople(directoryId: string, data: PeopleUpdateRequest): Promise<LegacyApiResponse<unknown>>;
 }

package/bin/identity/IdentityApi.js

@@ -76,6 +76,8 @@ let IdentityApi = class IdentityApi {
         return await this.httpRequest.get(url);
     }
     // ── Gemelos PRIVATE de los endpoints de agentes (proxy RBAC v2, DEC-PROT-011) ──
+    // Retornan el ENVELOPE legacy completo (httpRequest devuelve response.data = el body de identity),
+    // para que el proxy /v2 de people-business lo re-emita campo por campo (drop-in, sin doble-wrap).
     async privateGetPeopleByDirectoryId(directoryId) {
         if (!directoryId) {
             throw new Error("Directory ID is required.");
@@ -105,7 +107,21 @@ let IdentityApi = class IdentityApi {
             throw new Error("Directory ID is required.");
         }
         const url = `${this.baseUrl}identities/private/agents/people/${directoryId}/selfverified`;
-        await this.httpRequest.put(url, data);
+        return await this.httpRequest.put(url, data);
+    }
+    async privateSearchPeople(fullName) {
+        if (!fullName || !fullName.trim()) {
+            throw new Error("fullName is required.");
+        }
+        const url = `${this.baseUrl}identities/people/search?fullName=${encodeURIComponent(fullName)}`;
+        return await this.httpRequest.get(url);
+    }
+    async privateUpdatePeople(directoryId, data) {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.");
+        }
+        const url = `${this.baseUrl}identities/private/agents/people/${directoryId}`;
+        return await this.httpRequest.put(url, data);
     }
 };
 IdentityApi = __decorate([

package/bin/identity/index.d.ts

@@ -1,2 +1,3 @@
 export * from './interfaces/IIdentityApi.js';
+export * from './interfaces/LegacyApiResponse.js';
 export * from './IdentityApi.js';

package/bin/identity/index.js

@@ -1,2 +1,3 @@
 export * from './interfaces/IIdentityApi.js';
+export * from './interfaces/LegacyApiResponse.js';
 export * from './IdentityApi.js';

package/bin/identity/interfaces/IIdentityApi.d.ts

@@ -1,4 +1,5 @@
 import { PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse, PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse } from "@fiado/type-kit/bin/identity/index.js";
+import { LegacyApiResponse } from "./LegacyApiResponse.js";
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
  */
@@ -36,11 +37,15 @@ export interface IIdentityApi {
      */
     getUserDocuments(directoryId: string): Promise<any>;
     /** Gemelo private de agentGetPeopleByDirectoryId (con masking del manager). */
-    privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse>;
+    privateGetPeopleByDirectoryId(directoryId: string): Promise<LegacyApiResponse<PeopleResponse>>;
     /** Gemelo private de getUserDocumentsAgents (último documento). */
-    privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]>;
+    privateGetLastAgentDocument(directoryId: string): Promise<LegacyApiResponse<AgentDocumentKeyResponse[]>>;
     /** Gemelo private de uploadDocumentAgent. actorDirectoryId = autor de la observación (DEC-PROT-012). */
-    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse>;
+    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<LegacyApiResponse<DocumentUploadResponse>>;
     /** Gemelo private de agentPutPeoplePeopleIdSelfVerified. */
-    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void>;
+    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<LegacyApiResponse<unknown>>;
+    /** Gemelo private de agentGetPeopleSearch (búsqueda por nombre; devuelve lista). */
+    privateSearchPeople(fullName: string): Promise<LegacyApiResponse<PeopleResponse[]>>;
+    /** Gemelo private de editar persona (PUT sin /selfverified). */
+    privateUpdatePeople(directoryId: string, data: PeopleUpdateRequest): Promise<LegacyApiResponse<unknown>>;
 }

package/bin/identity/interfaces/LegacyApiResponse.d.ts

@@ -0,0 +1,7 @@
+export interface LegacyApiResponse<T> {
+    code: string;
+    description?: string | null;
+    msg?: string | null;
+    data: T;
+    date?: string;
+}

package/bin/identity/interfaces/LegacyApiResponse.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.49.0",
+  "version": "4.51.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/identity/IdentityApi.ts

@@ -1,6 +1,7 @@
 import {inject, injectable} from "inversify";
 import {IIdentityApi} from "./interfaces/IIdentityApi.js";
-import {IHttpRequest} from "@fiado/http-client";
+import {LegacyApiResponse} from "./interfaces/LegacyApiResponse.js";
+import type {IHttpRequest} from "@fiado/http-client";
 import dotenv from 'dotenv';
 import {
     PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse,
@@ -98,23 +99,25 @@ export class IdentityApi implements IIdentityApi {
     }
 
     // ── Gemelos PRIVATE de los endpoints de agentes (proxy RBAC v2, DEC-PROT-011) ──
-    async privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse> {
+    // Retornan el ENVELOPE legacy completo (httpRequest devuelve response.data = el body de identity),
+    // para que el proxy /v2 de people-business lo re-emita campo por campo (drop-in, sin doble-wrap).
+    async privateGetPeopleByDirectoryId(directoryId: string): Promise<LegacyApiResponse<PeopleResponse>> {
         if (!directoryId) {
             throw new Error("Directory ID is required.")
         }
         const url = `${this.baseUrl}identities/private/agents/people/${directoryId}`;
-        return await this.httpRequest.get<PeopleResponse>(url);
+        return await this.httpRequest.get<LegacyApiResponse<PeopleResponse>>(url);
     }
 
-    async privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]> {
+    async privateGetLastAgentDocument(directoryId: string): Promise<LegacyApiResponse<AgentDocumentKeyResponse[]>> {
         if (!directoryId) {
             throw new Error("Directory ID is required.")
         }
         const url = `${this.baseUrl}identities/private/agents/documents/${directoryId}/last`;
-        return await this.httpRequest.get<AgentDocumentKeyResponse[]>(url);
+        return await this.httpRequest.get<LegacyApiResponse<AgentDocumentKeyResponse[]>>(url);
     }
 
-    async privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse> {
+    async privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<LegacyApiResponse<DocumentUploadResponse>> {
         if (!directoryId) {
             throw new Error("Directory ID is required.")
         }
@@ -122,14 +125,30 @@ export class IdentityApi implements IIdentityApi {
             throw new Error("actorDirectoryId is required.")
         }
         const url = `${this.baseUrl}identities/private/agents/documents/${directoryId}/upload?actorDirectoryId=${encodeURIComponent(actorDirectoryId)}`;
-        return await this.httpRequest.put<DocumentUploadResponse>(url, document);
+        return await this.httpRequest.put<LegacyApiResponse<DocumentUploadResponse>>(url, document);
     }
 
-    async privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void> {
+    async privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<LegacyApiResponse<unknown>> {
         if (!directoryId) {
             throw new Error("Directory ID is required.")
         }
         const url = `${this.baseUrl}identities/private/agents/people/${directoryId}/selfverified`;
-        await this.httpRequest.put<void>(url, data);
+        return await this.httpRequest.put<LegacyApiResponse<unknown>>(url, data);
+    }
+
+    async privateSearchPeople(fullName: string): Promise<LegacyApiResponse<PeopleResponse[]>> {
+        if (!fullName || !fullName.trim()) {
+            throw new Error("fullName is required.")
+        }
+        const url = `${this.baseUrl}identities/people/search?fullName=${encodeURIComponent(fullName)}`;
+        return await this.httpRequest.get<LegacyApiResponse<PeopleResponse[]>>(url);
+    }
+
+    async privateUpdatePeople(directoryId: string, data: PeopleUpdateRequest): Promise<LegacyApiResponse<unknown>> {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.")
+        }
+        const url = `${this.baseUrl}identities/private/agents/people/${directoryId}`;
+        return await this.httpRequest.put<LegacyApiResponse<unknown>>(url, data);
     }
 }

package/src/identity/index.ts

@@ -1,4 +1,5 @@
 
 
 export * from './interfaces/IIdentityApi.js';
+export * from './interfaces/LegacyApiResponse.js';
 export * from './IdentityApi.js';

package/src/identity/interfaces/IIdentityApi.ts

@@ -2,6 +2,7 @@ import {
     PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse,
     PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse,
 } from "@fiado/type-kit/bin/identity/index.js";
+import { LegacyApiResponse } from "./LegacyApiResponse.js";
 
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
@@ -48,12 +49,18 @@ export interface IIdentityApi {
     getUserDocuments(directoryId: string): Promise<any>
 
     // ── Gemelos PRIVATE de los endpoints de agentes (proxy RBAC v2, DEC-PROT-011) ──
+    // Devuelven el ENVELOPE legacy completo (LegacyApiResponse) tal como lo emite identity,
+    // para que el proxy /v2 de people-business lo re-emita campo por campo (drop-in exacto, sin doble-wrap).
     /** Gemelo private de agentGetPeopleByDirectoryId (con masking del manager). */
-    privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse>;
+    privateGetPeopleByDirectoryId(directoryId: string): Promise<LegacyApiResponse<PeopleResponse>>;
     /** Gemelo private de getUserDocumentsAgents (último documento). */
-    privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]>;
+    privateGetLastAgentDocument(directoryId: string): Promise<LegacyApiResponse<AgentDocumentKeyResponse[]>>;
     /** Gemelo private de uploadDocumentAgent. actorDirectoryId = autor de la observación (DEC-PROT-012). */
-    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse>;
+    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<LegacyApiResponse<DocumentUploadResponse>>;
     /** Gemelo private de agentPutPeoplePeopleIdSelfVerified. */
-    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void>;
+    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<LegacyApiResponse<unknown>>;
+    /** Gemelo private de agentGetPeopleSearch (búsqueda por nombre; devuelve lista). */
+    privateSearchPeople(fullName: string): Promise<LegacyApiResponse<PeopleResponse[]>>;
+    /** Gemelo private de editar persona (PUT sin /selfverified). */
+    privateUpdatePeople(directoryId: string, data: PeopleUpdateRequest): Promise<LegacyApiResponse<unknown>>;
 }

package/src/identity/interfaces/LegacyApiResponse.ts

@@ -0,0 +1,11 @@
+// Envelope de respuesta de los lambdas legacy Fiado (@fiado/request-handler + @fiado/backend-toolkit):
+// el body HTTP es { code, description, msg, data, date }. Los métodos que pegan a endpoints legacy
+// devuelven este envelope COMPLETO (httpRequest.get/put retorna response.data = el body), NO solo `data`.
+// Tiparlo así evita el doble-wrap en el consumidor (que re-emite el envelope campo por campo para ser drop-in).
+export interface LegacyApiResponse<T> {
+    code: string;
+    description?: string | null;
+    msg?: string | null;
+    data: T;
+    date?: string;
+}