@fiado/api-invoker 5.121.0 → 5.123.0

package/bin/container.config.js

@@ -21,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";
@@ -174,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/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.121.0",
+  "version": "5.123.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.522.0",
+    "@fiado/type-kit": "^3.526.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -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";
@@ -246,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/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';