@fiado/api-invoker 5.120.0 → 5.122.0

package/bin/container.config.js

@@ -2,6 +2,7 @@ import { ContainerModule } from "inversify";
 import { DirectoryApi } from "./directory/index.js";
 import { IdentityApi } from "./identity/index.js";
 import { FileStorageApi } from "./file-storage/index.js";
+import { NotificationMessagesApi } from "./notificationMessages/index.js";
 import NotificationMessagePublisher from "./notificationMessages/queue/NotificationMessagePublisher.js";
 import TernApi from "./tern/api/TernApi.js";
 import PomeloApi from "./pomelo/api/PomeloApi.js";
@@ -20,6 +21,7 @@ import { CardApi } from "./card/index.js";
 import { TransactionPublisher } from "./transaction/index.js";
 import { ContractGeneratorApi } from "./contract-generator/index.js";
 import ContractBusinessApi from "./contract-business/api/ContractBusinessApi.js";
+import PdfRenderBusinessApi from "./pdf-render-business/api/PdfRenderBusinessApi.js";
 import MilestoneBusinessApi from "./milestone-business/api/MilestoneBusinessApi.js";
 import CreditStatementsApi from "./credit-statements/api/CreditStatementsApi.js";
 import ProductCatalogApi from "./product-catalog/ProductCatalogApi.js";
@@ -164,6 +166,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IBiometricsBusinessApi").to(BiometricsBusinessApi);
     bind("IAccountFiadoSAApi").to(AccountFiadoSAApi);
     bind("INotificationMessagesPublisher").to(NotificationMessagePublisher);
+    bind("INotificationMessagesApi").to(NotificationMessagesApi);
     bind("INotificationWSMessagesPublisher").to(NotificationWSMessagePublisher);
     bind("ISessionActivityPublisher").to(SessionActivityPublisher);
     bind("ITransactionPublisher").to(TransactionPublisher);
@@ -172,6 +175,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("ICardApi").to(CardApi);
     bind("IContractGeneratorApi").to(ContractGeneratorApi);
     bind("IContractBusinessApi").to(ContractBusinessApi);
+    bind("IPdfRenderBusinessApi").to(PdfRenderBusinessApi);
     bind("IMilestoneBusinessApi").to(MilestoneBusinessApi);
     bind("ICreditStatementsApi").to(CreditStatementsApi);
     bind("ICollectorApi").to(CollectorApi);

package/bin/index.d.ts

@@ -19,6 +19,7 @@ export * from "./authentication/index.js";
 export * from "./transaction/index.js";
 export * from "./contract-generator/index.js";
 export * from "./contract-business/index.js";
+export * from "./pdf-render-business/index.js";
 export * from "./credit-statements/index.js";
 export * from "./product-catalog/index.js";
 export * from "./collector/index.js";

package/bin/index.js

@@ -19,6 +19,7 @@ export * from "./authentication/index.js";
 export * from "./transaction/index.js";
 export * from "./contract-generator/index.js";
 export * from "./contract-business/index.js";
+export * from "./pdf-render-business/index.js";
 export * from "./credit-statements/index.js";
 export * from "./product-catalog/index.js";
 export * from "./collector/index.js";

package/bin/notificationMessages/api/NotificationMessagesApi.d.ts

@@ -0,0 +1,12 @@
+import type { IHttpRequest } from '@fiado/http-client';
+type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
+import { MomentTemplateListResponse, MomentTemplateResponse, MomentTemplateUpsertRequest } from '@fiado/type-kit/bin/notificationMessages/index.js';
+import { INotificationMessagesApi } from './interfaces/INotificationMessagesApi.js';
+export declare class NotificationMessagesApi implements INotificationMessagesApi {
+    private readonly httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    upsertMomentTemplate(messageType: string, request: MomentTemplateUpsertRequest): Promise<FiadoApiResponse<MomentTemplateResponse>>;
+    listMomentTemplates(messageTypes: readonly string[]): Promise<FiadoApiResponse<MomentTemplateListResponse>>;
+}
+export {};

package/bin/notificationMessages/api/NotificationMessagesApi.js

@@ -0,0 +1,35 @@
+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';
+import { joinUrl } from '../../utils/joinUrl.js';
+const MOMENT_TEMPLATES_PATH = 'notification-messages/private/moment-templates';
+let NotificationMessagesApi = class NotificationMessagesApi {
+    httpRequest;
+    baseUrl = process.env.NOTIFICATION_MESSAGES_URL || '';
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async upsertMomentTemplate(messageType, request) {
+        const url = joinUrl(this.baseUrl, `${MOMENT_TEMPLATES_PATH}/${encodeURIComponent(messageType)}`);
+        return await this.httpRequest.put(url, request);
+    }
+    async listMomentTemplates(messageTypes) {
+        return await this.httpRequest.get(joinUrl(this.baseUrl, MOMENT_TEMPLATES_PATH), { messageTypes: messageTypes.join(',') });
+    }
+};
+NotificationMessagesApi = __decorate([
+    injectable(),
+    __param(0, inject('IHttpRequest')),
+    __metadata("design:paramtypes", [Object])
+], NotificationMessagesApi);
+export { NotificationMessagesApi };

package/bin/notificationMessages/api/interfaces/INotificationMessagesApi.d.ts

@@ -0,0 +1,10 @@
+type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
+import { MomentTemplateListResponse, MomentTemplateResponse, MomentTemplateUpsertRequest } from '@fiado/type-kit/bin/notificationMessages/index.js';
+/** Plantillas push de los momentos del crédito en notification-messages-business (API privada). */
+export interface INotificationMessagesApi {
+    /** Crea o actualiza `ES_<messageType>`. Responde 409 si la fila es del wallet. */
+    upsertMomentTemplate(messageType: string, request: MomentTemplateUpsertRequest): Promise<FiadoApiResponse<MomentTemplateResponse>>;
+    /** Lectura en lote: la plantilla que no existe no viene en `items`. */
+    listMomentTemplates(messageTypes: readonly string[]): Promise<FiadoApiResponse<MomentTemplateListResponse>>;
+}
+export {};

package/bin/notificationMessages/api/interfaces/INotificationMessagesApi.js

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

package/bin/notificationMessages/index.d.ts

@@ -1,2 +1,4 @@
 export * from './queue/NotificationMessagePublisher.js';
 export * from './queue/interfaces/INotificationMessagesPublisher.js';
+export * from './api/NotificationMessagesApi.js';
+export * from './api/interfaces/INotificationMessagesApi.js';

package/bin/notificationMessages/index.js

@@ -1,2 +1,4 @@
 export * from './queue/NotificationMessagePublisher.js';
 export * from './queue/interfaces/INotificationMessagesPublisher.js';
+export * from './api/NotificationMessagesApi.js';
+export * from './api/interfaces/INotificationMessagesApi.js';

package/bin/pdf-render-business/api/PdfRenderBusinessApi.d.ts

@@ -0,0 +1,18 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import type { DocumentUrlResponse, GeneratePdfRequest, MergePdfsRequest, PdfDocumentResponse, RenderDocumentRequest, RenderDocumentResponse } from "@fiado/type-kit/bin/pdfRender/index.js";
+import type { IPdfRenderBusinessApi } from "./interfaces/IPdfRenderBusinessApi.js";
+export default class PdfRenderBusinessApi implements IPdfRenderBusinessApi {
+    private httpRequest;
+    constructor(httpRequest: IHttpRequest);
+    render(request: RenderDocumentRequest): Promise<RenderDocumentResponse>;
+    generatePdf(request: GeneratePdfRequest): Promise<PdfDocumentResponse>;
+    mergePdfs(request: MergePdfsRequest): Promise<PdfDocumentResponse>;
+    getDocumentUrl(key: string): Promise<DocumentUrlResponse>;
+    /**
+     * `@fiado/http-client` devuelve el body HTTP completo, que en este Lambda es el envoltorio
+     * `ApiResponse`; el documento generado está en `data`.
+     */
+    private post;
+    /** La URL base se lee en cada llamada y se normaliza para no duplicar "/" al concatenar. */
+    private url;
+}

package/bin/pdf-render-business/api/PdfRenderBusinessApi.js

@@ -0,0 +1,51 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+let PdfRenderBusinessApi = class PdfRenderBusinessApi {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async render(request) {
+        return await this.post("render", request);
+    }
+    async generatePdf(request) {
+        return await this.post("generate-pdf", request);
+    }
+    async mergePdfs(request) {
+        return await this.post("merge-pdfs", request);
+    }
+    async getDocumentUrl(key) {
+        const response = await this.httpRequest.get(this.url("documents/url"), { key });
+        return response.data;
+    }
+    /**
+     * `@fiado/http-client` devuelve el body HTTP completo, que en este Lambda es el envoltorio
+     * `ApiResponse`; el documento generado está en `data`.
+     */
+    async post(path, body) {
+        const response = await this.httpRequest.post(this.url(path), body);
+        return response.data;
+    }
+    /** La URL base se lee en cada llamada y se normaliza para no duplicar "/" al concatenar. */
+    url(path) {
+        const baseUrl = (process.env.PDF_RENDER_BUSINESS_LAMBDA_URL || "").replace(/\/+$/, "");
+        return `${baseUrl}/${path}`;
+    }
+};
+PdfRenderBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PdfRenderBusinessApi);
+export default PdfRenderBusinessApi;

package/bin/pdf-render-business/api/interfaces/IPdfRenderBusinessApi.d.ts

@@ -0,0 +1,25 @@
+import type { DocumentUrlResponse, GeneratePdfRequest, MergePdfsRequest, PdfDocumentResponse, RenderDocumentRequest, RenderDocumentResponse } from "@fiado/type-kit/bin/pdfRender/index.js";
+/**
+ * Cliente de los endpoints privados de pdf-render-business.
+ *
+ * El Lambda responde con el envoltorio `ApiResponse` (`{ code, date, msg, data }`); este cliente
+ * lo desenvuelve y entrega directamente el contenido de `data`.
+ *
+ * Cada documento queda guardado en el bucket de contratos con la llave por convención
+ * (`{EMPRESA}/{TIPO}/{referenceId}/{uuid}.pdf`); la respuesta trae esa `key`, una URL firmada de
+ * 15 minutos y el `sha256`. El base64 sólo viene si el request pide `includeContent: true`.
+ *
+ * Errores: una respuesta HTTP distinta de 2xx se propaga como el error del cliente HTTP (axios).
+ *
+ * Variable de entorno requerida en el consumidor: `PDF_RENDER_BUSINESS_LAMBDA_URL`.
+ */
+export interface IPdfRenderBusinessApi {
+    /** POST /render — PDF a partir de una plantilla publicada en el bucket de plantillas. */
+    render(request: RenderDocumentRequest): Promise<RenderDocumentResponse>;
+    /** POST /generate-pdf — PDF en A4 a partir de HTML ya resuelto por el consumidor. */
+    generatePdf(request: GeneratePdfRequest): Promise<PdfDocumentResponse>;
+    /** POST /merge-pdfs — une los PDFs en el orden recibido. */
+    mergePdfs(request: MergePdfsRequest): Promise<PdfDocumentResponse>;
+    /** GET /documents/url?key= — nueva URL firmada (15 min) de un documento ya guardado. */
+    getDocumentUrl(key: string): Promise<DocumentUrlResponse>;
+}

package/bin/pdf-render-business/api/interfaces/IPdfRenderBusinessApi.js

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

package/bin/pdf-render-business/index.d.ts

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

package/bin/pdf-render-business/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.120.0",
+  "version": "5.122.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.516.0",
+    "@fiado/type-kit": "^3.526.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -2,7 +2,7 @@ import { ContainerModule } from "inversify";
 import { DirectoryApi, IDirectoryApi } from "./directory/index.js";
 import { IdentityApi, IIdentityApi } from "./identity/index.js";
 import { FileStorageApi, IFileStorageApi } from "./file-storage/index.js";
-import { INotificationMessagesPublisher } from "./notificationMessages/index.js";
+import { INotificationMessagesApi, INotificationMessagesPublisher, NotificationMessagesApi } from "./notificationMessages/index.js";
 import NotificationMessagePublisher from "./notificationMessages/queue/NotificationMessagePublisher.js";
 import { ITernApi } from "./tern/index.js";
 import TernApi from "./tern/api/TernApi.js";
@@ -30,6 +30,8 @@ import { ITransactionApi, ITransactionPublisher, TransactionPublisher } from "./
 import { ContractGeneratorApi, IContractGeneratorApi } from "./contract-generator/index.js";
 import { IContractBusinessApi } from "./contract-business/index.js";
 import ContractBusinessApi from "./contract-business/api/ContractBusinessApi.js";
+import { IPdfRenderBusinessApi } from "./pdf-render-business/index.js";
+import PdfRenderBusinessApi from "./pdf-render-business/api/PdfRenderBusinessApi.js";
 import { IMilestoneBusinessApi } from "./milestone-business/index.js";
 import MilestoneBusinessApi from "./milestone-business/api/MilestoneBusinessApi.js";
 import { ICreditStatementsApi } from "./credit-statements/index.js";
@@ -237,6 +239,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<IBiometricsBusinessApi>("IBiometricsBusinessApi").to(BiometricsBusinessApi);
     bind<IAccountFiadoSAApi>("IAccountFiadoSAApi").to(AccountFiadoSAApi);
     bind<INotificationMessagesPublisher>("INotificationMessagesPublisher").to(NotificationMessagePublisher);
+    bind<INotificationMessagesApi>("INotificationMessagesApi").to(NotificationMessagesApi);
     bind<INotificationWSMessagesPublisher>("INotificationWSMessagesPublisher").to(NotificationWSMessagePublisher);
     bind<ISessionActivityPublisher>("ISessionActivityPublisher").to(SessionActivityPublisher);
     bind<ITransactionPublisher>("ITransactionPublisher").to(TransactionPublisher);
@@ -245,6 +248,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<ICardApi>("ICardApi").to(CardApi);
     bind<IContractGeneratorApi>("IContractGeneratorApi").to(ContractGeneratorApi);
     bind<IContractBusinessApi>("IContractBusinessApi").to(ContractBusinessApi);
+    bind<IPdfRenderBusinessApi>("IPdfRenderBusinessApi").to(PdfRenderBusinessApi);
     bind<IMilestoneBusinessApi>("IMilestoneBusinessApi").to(MilestoneBusinessApi);
     bind<ICreditStatementsApi>("ICreditStatementsApi").to(CreditStatementsApi);
     bind<ICollectorApi>("ICollectorApi").to(CollectorApi);

package/src/index.ts

@@ -19,6 +19,7 @@ export * from "./authentication/index.js";
 export * from "./transaction/index.js";
 export * from "./contract-generator/index.js";
 export * from "./contract-business/index.js";
+export * from "./pdf-render-business/index.js";
 export * from "./credit-statements/index.js";
 export * from "./product-catalog/index.js";
 export * from "./collector/index.js";

package/src/notificationMessages/api/NotificationMessagesApi.ts

@@ -0,0 +1,28 @@
+import { inject, injectable } from 'inversify';
+import type { IHttpRequest } from '@fiado/http-client';
+type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
+import {
+    MomentTemplateListResponse,
+    MomentTemplateResponse,
+    MomentTemplateUpsertRequest,
+} from '@fiado/type-kit/bin/notificationMessages/index.js';
+import { INotificationMessagesApi } from './interfaces/INotificationMessagesApi.js';
+import { joinUrl } from '../../utils/joinUrl.js';
+
+const MOMENT_TEMPLATES_PATH = 'notification-messages/private/moment-templates';
+
+@injectable()
+export class NotificationMessagesApi implements INotificationMessagesApi {
+    private readonly baseUrl = process.env.NOTIFICATION_MESSAGES_URL || '';
+
+    constructor(@inject('IHttpRequest') private readonly httpRequest: IHttpRequest) {}
+
+    async upsertMomentTemplate(messageType: string, request: MomentTemplateUpsertRequest): Promise<FiadoApiResponse<MomentTemplateResponse>> {
+        const url = joinUrl(this.baseUrl, `${MOMENT_TEMPLATES_PATH}/${encodeURIComponent(messageType)}`);
+        return await this.httpRequest.put(url, request);
+    }
+
+    async listMomentTemplates(messageTypes: readonly string[]): Promise<FiadoApiResponse<MomentTemplateListResponse>> {
+        return await this.httpRequest.get(joinUrl(this.baseUrl, MOMENT_TEMPLATES_PATH), { messageTypes: messageTypes.join(',') });
+    }
+}

package/src/notificationMessages/api/interfaces/INotificationMessagesApi.ts

@@ -0,0 +1,14 @@
+type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
+import {
+    MomentTemplateListResponse,
+    MomentTemplateResponse,
+    MomentTemplateUpsertRequest,
+} from '@fiado/type-kit/bin/notificationMessages/index.js';
+
+/** Plantillas push de los momentos del crédito en notification-messages-business (API privada). */
+export interface INotificationMessagesApi {
+    /** Crea o actualiza `ES_<messageType>`. Responde 409 si la fila es del wallet. */
+    upsertMomentTemplate(messageType: string, request: MomentTemplateUpsertRequest): Promise<FiadoApiResponse<MomentTemplateResponse>>;
+    /** Lectura en lote: la plantilla que no existe no viene en `items`. */
+    listMomentTemplates(messageTypes: readonly string[]): Promise<FiadoApiResponse<MomentTemplateListResponse>>;
+}

package/src/notificationMessages/index.ts

@@ -1,2 +1,4 @@
 export * from './queue/NotificationMessagePublisher.js';
-export * from './queue/interfaces/INotificationMessagesPublisher.js';
+export * from './queue/interfaces/INotificationMessagesPublisher.js';
+export * from './api/NotificationMessagesApi.js';
+export * from './api/interfaces/INotificationMessagesApi.js';

package/src/pdf-render-business/api/PdfRenderBusinessApi.ts

@@ -0,0 +1,52 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import type {
+    DocumentUrlResponse,
+    GeneratePdfRequest,
+    MergePdfsRequest,
+    PdfDocumentResponse,
+    RenderDocumentRequest,
+    RenderDocumentResponse,
+} from "@fiado/type-kit/bin/pdfRender/index.js";
+import type { IPdfRenderBusinessApi } from "./interfaces/IPdfRenderBusinessApi.js";
+
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+@injectable()
+export default class PdfRenderBusinessApi implements IPdfRenderBusinessApi {
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async render(request: RenderDocumentRequest): Promise<RenderDocumentResponse> {
+        return await this.post<RenderDocumentResponse>("render", request);
+    }
+
+    async generatePdf(request: GeneratePdfRequest): Promise<PdfDocumentResponse> {
+        return await this.post<PdfDocumentResponse>("generate-pdf", request);
+    }
+
+    async mergePdfs(request: MergePdfsRequest): Promise<PdfDocumentResponse> {
+        return await this.post<PdfDocumentResponse>("merge-pdfs", request);
+    }
+
+    async getDocumentUrl(key: string): Promise<DocumentUrlResponse> {
+        const response = await this.httpRequest.get<FiadoApiResponse<DocumentUrlResponse>>(this.url("documents/url"), { key });
+        return response.data;
+    }
+
+    /**
+     * `@fiado/http-client` devuelve el body HTTP completo, que en este Lambda es el envoltorio
+     * `ApiResponse`; el documento generado está en `data`.
+     */
+    private async post<T>(path: string, body: unknown): Promise<T> {
+        const response = await this.httpRequest.post<FiadoApiResponse<T>>(this.url(path), body);
+        return response.data;
+    }
+
+    /** La URL base se lee en cada llamada y se normaliza para no duplicar "/" al concatenar. */
+    private url(path: string): string {
+        const baseUrl = (process.env.PDF_RENDER_BUSINESS_LAMBDA_URL || "").replace(/\/+$/, "");
+        return `${baseUrl}/${path}`;
+    }
+}

package/src/pdf-render-business/api/interfaces/IPdfRenderBusinessApi.ts

@@ -0,0 +1,36 @@
+import type {
+    DocumentUrlResponse,
+    GeneratePdfRequest,
+    MergePdfsRequest,
+    PdfDocumentResponse,
+    RenderDocumentRequest,
+    RenderDocumentResponse,
+} from "@fiado/type-kit/bin/pdfRender/index.js";
+
+/**
+ * Cliente de los endpoints privados de pdf-render-business.
+ *
+ * El Lambda responde con el envoltorio `ApiResponse` (`{ code, date, msg, data }`); este cliente
+ * lo desenvuelve y entrega directamente el contenido de `data`.
+ *
+ * Cada documento queda guardado en el bucket de contratos con la llave por convención
+ * (`{EMPRESA}/{TIPO}/{referenceId}/{uuid}.pdf`); la respuesta trae esa `key`, una URL firmada de
+ * 15 minutos y el `sha256`. El base64 sólo viene si el request pide `includeContent: true`.
+ *
+ * Errores: una respuesta HTTP distinta de 2xx se propaga como el error del cliente HTTP (axios).
+ *
+ * Variable de entorno requerida en el consumidor: `PDF_RENDER_BUSINESS_LAMBDA_URL`.
+ */
+export interface IPdfRenderBusinessApi {
+    /** POST /render — PDF a partir de una plantilla publicada en el bucket de plantillas. */
+    render(request: RenderDocumentRequest): Promise<RenderDocumentResponse>;
+
+    /** POST /generate-pdf — PDF en A4 a partir de HTML ya resuelto por el consumidor. */
+    generatePdf(request: GeneratePdfRequest): Promise<PdfDocumentResponse>;
+
+    /** POST /merge-pdfs — une los PDFs en el orden recibido. */
+    mergePdfs(request: MergePdfsRequest): Promise<PdfDocumentResponse>;
+
+    /** GET /documents/url?key= — nueva URL firmada (15 min) de un documento ya guardado. */
+    getDocumentUrl(key: string): Promise<DocumentUrlResponse>;
+}

package/src/pdf-render-business/index.ts

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