@fiado/type-kit 3.523.0 → 3.524.0

package/_test_/unit/pdfRender/pdfRenderDtos.test.ts

@@ -0,0 +1,66 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    GeneratePdfRequest, MergePdfsRequest, PublishTemplateRequest, RenderDocumentRequest,
+    TemplateLocationRequest, UploadAssetRequest,
+} from '../../../src/pdfRender';
+
+const errorsOf = async <T extends object>(cls: new () => T, body: unknown) =>
+    (await validate(plainToInstance(cls, body) as object, { whitelist: true })).map(e => e.property);
+
+describe('pdfRender render DTOs', () => {
+    it('accepts a deep template ref with data', async () => {
+        expect(await errorsOf(RenderDocumentRequest, {
+            template: { enterprise: 'FIADOSA', partnerId: 'UNE', category: 'CREDITS', documentType: 'CREDIT_CONTRATO_SIMPLE', version: '2' },
+            data: { cliente: { nombre: 'Ana' } },
+        })).toEqual([]);
+    });
+
+    it('accepts a flat template ref without version', async () => {
+        expect(await errorsOf(RenderDocumentRequest, { template: { enterprise: 'PAGO_CONFIADO', documentType: 'TERMS_WALLET_PAGO' }, data: {} })).toEqual([]);
+    });
+
+    it('rejects path traversal and slashes in segments', async () => {
+        expect(await errorsOf(RenderDocumentRequest, { template: { enterprise: '../FIADOSA', documentType: 'A/B' }, data: {} })).toEqual(['template']);
+    });
+
+    it('rejects a non numeric version', async () => {
+        expect(await errorsOf(RenderDocumentRequest, { template: { enterprise: 'FIADOSA', documentType: 'X', version: 'V2' }, data: {} })).toEqual(['template']);
+    });
+
+    it('requires data to be an object', async () => {
+        expect(await errorsOf(RenderDocumentRequest, { template: { enterprise: 'FIADOSA', documentType: 'X' }, data: 'nope' })).toEqual(['data']);
+    });
+
+    it('requires non empty html', async () => {
+        expect(await errorsOf(GeneratePdfRequest, { html: '' })).toEqual(['html']);
+    });
+
+    it('requires between 1 and 50 pdfs', async () => {
+        expect(await errorsOf(MergePdfsRequest, { pdfs: [] })).toEqual(['pdfs']);
+        expect(await errorsOf(MergePdfsRequest, { pdfs: Array(51).fill('JVBERi0=') })).toEqual(['pdfs']);
+        expect(await errorsOf(MergePdfsRequest, { pdfs: ['JVBERi0='] })).toEqual([]);
+    });
+});
+
+describe('pdfRender admin DTOs', () => {
+    it('publish: requires documentType and html, and drops any version', async () => {
+        expect(await errorsOf(PublishTemplateRequest, { template: { enterprise: 'FIADOSA', documentType: 'X' }, html: '<p/>' })).toEqual([]);
+        expect(await errorsOf(PublishTemplateRequest, { template: { enterprise: 'FIADOSA', documentType: 'X' }, html: '' })).toEqual(['html']);
+        const withVersion = plainToInstance(PublishTemplateRequest, { template: { enterprise: 'FIADOSA', documentType: 'X', version: '9' }, html: '<p/>' });
+        await validate(withVersion, { whitelist: true });
+        expect((withVersion.template as unknown as Record<string, unknown>).version).toBeUndefined();
+    });
+
+    it('asset: accepts nested folders and known types, rejects traversal and other types', async () => {
+        expect(await errorsOf(UploadAssetRequest, { enterprise: 'FIADOSA', path: 'fonts/Carlito-Bold.ttf', contentType: 'font/ttf', contentBase64: 'AAAA' })).toEqual([]);
+        expect(await errorsOf(UploadAssetRequest, { enterprise: 'FIADOSA', path: '../x.ttf', contentType: 'font/ttf', contentBase64: 'AAAA' })).toEqual(['path']);
+        expect(await errorsOf(UploadAssetRequest, { enterprise: 'FIADOSA', path: 'x.exe', contentType: 'application/x-msdownload', contentBase64: 'AAAA' })).toEqual(['path', 'contentType']);
+    });
+
+    it('location: enterprise required, partnerId optional', async () => {
+        expect(await errorsOf(TemplateLocationRequest, { enterprise: 'FIADOSA', partnerId: 'UNE', category: 'CREDITS' })).toEqual([]);
+        expect(await errorsOf(TemplateLocationRequest, {})).toEqual(['enterprise']);
+    });
+});

package/bin/index.d.ts

@@ -125,3 +125,4 @@ export * as DynamicForm from './dynamicForm';
 export * as Rewards from './rewards';
 export * as RewardsEligibility from './rewardsEligibility';
 export * as DatalakeReports from './datalakeReports';
+export * as PdfRender from './pdfRender';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = void 0;
-exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = void 0;
+exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -246,3 +246,5 @@ exports.Rewards = __importStar(require("./rewards"));
 // servicios emisores: POST /events (request/response) y GET /runs/{id}.
 exports.RewardsEligibility = __importStar(require("./rewardsEligibility"));
 exports.DatalakeReports = __importStar(require("./datalakeReports"));
+// PdfRender: DTOs del lambda pdf-render-business (plantilla HTML → PDF multitenant y su backoffice).
+exports.PdfRender = __importStar(require("./pdfRender"));

package/bin/pdfRender/dtos/GeneratePdfRequest.d.ts

@@ -0,0 +1,4 @@
+/** HTML ya resuelto por el consumidor; se imprime en A4 con márgenes de 2 mm. */
+export declare class GeneratePdfRequest {
+    html: string;
+}

package/bin/pdfRender/dtos/GeneratePdfRequest.js

@@ -0,0 +1,22 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratePdfRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** HTML ya resuelto por el consumidor; se imprime en A4 con márgenes de 2 mm. */
+class GeneratePdfRequest {
+}
+exports.GeneratePdfRequest = GeneratePdfRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GeneratePdfRequest.prototype, "html", void 0);

package/bin/pdfRender/dtos/MergePdfsRequest.d.ts

@@ -0,0 +1,4 @@
+/** PDFs en base64, en el orden en que deben quedar en el documento final. */
+export declare class MergePdfsRequest {
+    pdfs: string[];
+}

package/bin/pdfRender/dtos/MergePdfsRequest.js

@@ -0,0 +1,24 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MergePdfsRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** PDFs en base64, en el orden en que deben quedar en el documento final. */
+class MergePdfsRequest {
+}
+exports.MergePdfsRequest = MergePdfsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(50),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], MergePdfsRequest.prototype, "pdfs", void 0);

package/bin/pdfRender/dtos/PdfDocumentResponse.d.ts

@@ -0,0 +1,5 @@
+export declare class PdfDocumentResponse {
+    base64: string;
+    pages: number;
+    bytes: number;
+}

package/bin/pdfRender/dtos/PdfDocumentResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfDocumentResponse = void 0;
+class PdfDocumentResponse {
+}
+exports.PdfDocumentResponse = PdfDocumentResponse;

package/bin/pdfRender/dtos/PublishTemplateRequest.d.ts

@@ -0,0 +1,10 @@
+import { TemplateLocationRequest } from "./TemplateLocationRequest";
+/** Tipo de documento al que se le publica una versión nueva. */
+export declare class PublishTemplateTarget extends TemplateLocationRequest {
+    documentType: string;
+}
+/** Publica el HTML como la siguiente versión del tipo de documento. La versión la asigna el servicio. */
+export declare class PublishTemplateRequest {
+    template: PublishTemplateTarget;
+    html: string;
+}

package/bin/pdfRender/dtos/PublishTemplateRequest.js

@@ -0,0 +1,40 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublishTemplateRequest = exports.PublishTemplateTarget = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const TemplateLocationRequest_1 = require("./TemplateLocationRequest");
+/** Tipo de documento al que se le publica una versión nueva. */
+class PublishTemplateTarget extends TemplateLocationRequest_1.TemplateLocationRequest {
+}
+exports.PublishTemplateTarget = PublishTemplateTarget;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(/^[A-Za-z0-9_-]{1,64}$/),
+    __metadata("design:type", String)
+], PublishTemplateTarget.prototype, "documentType", void 0);
+/** Publica el HTML como la siguiente versión del tipo de documento. La versión la asigna el servicio. */
+class PublishTemplateRequest {
+}
+exports.PublishTemplateRequest = PublishTemplateRequest;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PublishTemplateTarget),
+    __metadata("design:type", PublishTemplateTarget)
+], PublishTemplateRequest.prototype, "template", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PublishTemplateRequest.prototype, "html", void 0);

package/bin/pdfRender/dtos/PublishTemplateResponse.d.ts

@@ -0,0 +1,4 @@
+export declare class PublishTemplateResponse {
+    key: string;
+    version: string;
+}

package/bin/pdfRender/dtos/PublishTemplateResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublishTemplateResponse = void 0;
+class PublishTemplateResponse {
+}
+exports.PublishTemplateResponse = PublishTemplateResponse;

package/bin/pdfRender/dtos/RenderDocumentRequest.d.ts

@@ -0,0 +1,6 @@
+import { TemplateRefRequest } from "./TemplateRefRequest";
+export declare class RenderDocumentRequest {
+    template: TemplateRefRequest;
+    /** Variables de la plantilla. Se escapan como HTML salvo que la plantilla use {{{triple}}}. */
+    data: Record<string, unknown>;
+}

package/bin/pdfRender/dtos/RenderDocumentRequest.js

@@ -0,0 +1,29 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderDocumentRequest = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const TemplateRefRequest_1 = require("./TemplateRefRequest");
+class RenderDocumentRequest {
+}
+exports.RenderDocumentRequest = RenderDocumentRequest;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => TemplateRefRequest_1.TemplateRefRequest),
+    __metadata("design:type", TemplateRefRequest_1.TemplateRefRequest)
+], RenderDocumentRequest.prototype, "template", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], RenderDocumentRequest.prototype, "data", void 0);

package/bin/pdfRender/dtos/RenderDocumentResponse.d.ts

@@ -0,0 +1,5 @@
+import { PdfDocumentResponse } from "./PdfDocumentResponse";
+export declare class RenderDocumentResponse extends PdfDocumentResponse {
+    templateVersion: string;
+    renderMs: number;
+}

package/bin/pdfRender/dtos/RenderDocumentResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderDocumentResponse = void 0;
+const PdfDocumentResponse_1 = require("./PdfDocumentResponse");
+class RenderDocumentResponse extends PdfDocumentResponse_1.PdfDocumentResponse {
+}
+exports.RenderDocumentResponse = RenderDocumentResponse;

package/bin/pdfRender/dtos/TemplateLocationRequest.d.ts

@@ -0,0 +1,6 @@
+/** Carpeta del bucket de plantillas: empresa, y opcionalmente partner + categoría. */
+export declare class TemplateLocationRequest {
+    enterprise: string;
+    partnerId?: string;
+    category?: string;
+}

package/bin/pdfRender/dtos/TemplateLocationRequest.js

@@ -0,0 +1,36 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateLocationRequest = void 0;
+const class_validator_1 = require("class-validator");
+const SEGMENT = /^[A-Za-z0-9_-]{1,64}$/;
+/** Carpeta del bucket de plantillas: empresa, y opcionalmente partner + categoría. */
+class TemplateLocationRequest {
+}
+exports.TemplateLocationRequest = TemplateLocationRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateLocationRequest.prototype, "enterprise", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateLocationRequest.prototype, "partnerId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateLocationRequest.prototype, "category", void 0);

package/bin/pdfRender/dtos/TemplateRefRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Referencia a una plantilla del bucket de plantillas.
+ * Layout profundo: {enterprise}/{partnerId}/{category}/{documentType}/V{version}.html
+ * Layout plano:    {enterprise}/{documentType}/V{version}.html
+ * partnerId y category van juntos o no van.
+ */
+export declare class TemplateRefRequest {
+    enterprise: string;
+    partnerId?: string;
+    category?: string;
+    documentType: string;
+    /** Número de versión sin la "V". Sin valor se usa la versión más alta publicada. */
+    version?: string;
+}

package/bin/pdfRender/dtos/TemplateRefRequest.js

@@ -0,0 +1,54 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateRefRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Segmento de ruta S3 permitido: letras, dígitos, guion y guion bajo. */
+const SEGMENT = /^[A-Za-z0-9_-]{1,64}$/;
+/**
+ * Referencia a una plantilla del bucket de plantillas.
+ * Layout profundo: {enterprise}/{partnerId}/{category}/{documentType}/V{version}.html
+ * Layout plano:    {enterprise}/{documentType}/V{version}.html
+ * partnerId y category van juntos o no van.
+ */
+class TemplateRefRequest {
+}
+exports.TemplateRefRequest = TemplateRefRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateRefRequest.prototype, "enterprise", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateRefRequest.prototype, "partnerId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateRefRequest.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], TemplateRefRequest.prototype, "documentType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^[0-9]{1,6}$/),
+    __metadata("design:type", String)
+], TemplateRefRequest.prototype, "version", void 0);

package/bin/pdfRender/dtos/TemplateSummaryResponse.d.ts

@@ -0,0 +1,6 @@
+export declare class TemplateSummaryResponse {
+    documentType: string;
+    /** Versiones publicadas, de menor a mayor. */
+    versions: string[];
+    latestVersion: string;
+}

package/bin/pdfRender/dtos/TemplateSummaryResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateSummaryResponse = void 0;
+class TemplateSummaryResponse {
+}
+exports.TemplateSummaryResponse = TemplateSummaryResponse;

package/bin/pdfRender/dtos/UploadAssetRequest.d.ts

@@ -0,0 +1,9 @@
+export declare const ASSET_CONTENT_TYPES: string[];
+/** Fuente, imagen u hoja de estilo para la carpeta _assets de una empresa o partner. */
+export declare class UploadAssetRequest {
+    enterprise: string;
+    partnerId?: string;
+    path: string;
+    contentType: string;
+    contentBase64: string;
+}

package/bin/pdfRender/dtos/UploadAssetRequest.js

@@ -0,0 +1,49 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadAssetRequest = exports.ASSET_CONTENT_TYPES = void 0;
+const class_validator_1 = require("class-validator");
+const SEGMENT = /^[A-Za-z0-9_-]{1,64}$/;
+/** Ruta relativa dentro de _assets/: hasta 4 carpetas y un archivo, sin "..", con extensión permitida. */
+const ASSET_PATH = /^(?!.*\.\.)([A-Za-z0-9_-]+\/){0,4}[A-Za-z0-9_.()-]+\.(ttf|otf|woff|woff2|png|jpg|jpeg|svg|gif|css)$/;
+exports.ASSET_CONTENT_TYPES = ['font/ttf', 'font/otf', 'font/woff', 'font/woff2', 'image/png', 'image/jpeg', 'image/svg+xml', 'image/gif', 'text/css'];
+/** Fuente, imagen u hoja de estilo para la carpeta _assets de una empresa o partner. */
+class UploadAssetRequest {
+}
+exports.UploadAssetRequest = UploadAssetRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], UploadAssetRequest.prototype, "enterprise", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(SEGMENT),
+    __metadata("design:type", String)
+], UploadAssetRequest.prototype, "partnerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(ASSET_PATH),
+    __metadata("design:type", String)
+], UploadAssetRequest.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(exports.ASSET_CONTENT_TYPES),
+    __metadata("design:type", String)
+], UploadAssetRequest.prototype, "contentType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsBase64)(),
+    __metadata("design:type", String)
+], UploadAssetRequest.prototype, "contentBase64", void 0);

package/bin/pdfRender/dtos/UploadAssetResponse.d.ts

@@ -0,0 +1,4 @@
+export declare class UploadAssetResponse {
+    key: string;
+    bytes: number;
+}

package/bin/pdfRender/dtos/UploadAssetResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadAssetResponse = void 0;
+class UploadAssetResponse {
+}
+exports.UploadAssetResponse = UploadAssetResponse;

package/bin/pdfRender/index.d.ts

@@ -0,0 +1,12 @@
+export * from './dtos/TemplateRefRequest';
+export * from './dtos/RenderDocumentRequest';
+export * from './dtos/GeneratePdfRequest';
+export * from './dtos/MergePdfsRequest';
+export * from './dtos/PdfDocumentResponse';
+export * from './dtos/RenderDocumentResponse';
+export * from './dtos/TemplateLocationRequest';
+export * from './dtos/PublishTemplateRequest';
+export * from './dtos/PublishTemplateResponse';
+export * from './dtos/UploadAssetRequest';
+export * from './dtos/UploadAssetResponse';
+export * from './dtos/TemplateSummaryResponse';

package/bin/pdfRender/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+//dtos
+__exportStar(require("./dtos/TemplateRefRequest"), exports);
+__exportStar(require("./dtos/RenderDocumentRequest"), exports);
+__exportStar(require("./dtos/GeneratePdfRequest"), exports);
+__exportStar(require("./dtos/MergePdfsRequest"), exports);
+__exportStar(require("./dtos/PdfDocumentResponse"), exports);
+__exportStar(require("./dtos/RenderDocumentResponse"), exports);
+__exportStar(require("./dtos/TemplateLocationRequest"), exports);
+__exportStar(require("./dtos/PublishTemplateRequest"), exports);
+__exportStar(require("./dtos/PublishTemplateResponse"), exports);
+__exportStar(require("./dtos/UploadAssetRequest"), exports);
+__exportStar(require("./dtos/UploadAssetResponse"), exports);
+__exportStar(require("./dtos/TemplateSummaryResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.523.0",
+  "version": "3.524.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/index.ts

@@ -209,3 +209,6 @@ export * as Rewards from './rewards';
 // servicios emisores: POST /events (request/response) y GET /runs/{id}.
 export * as RewardsEligibility from './rewardsEligibility';
 export * as DatalakeReports from './datalakeReports';
+
+// PdfRender: DTOs del lambda pdf-render-business (plantilla HTML → PDF multitenant y su backoffice).
+export * as PdfRender from './pdfRender';

package/src/pdfRender/dtos/GeneratePdfRequest.ts

@@ -0,0 +1,7 @@
+import { IsNotEmpty, IsString } from "class-validator";
+
+/** HTML ya resuelto por el consumidor; se imprime en A4 con márgenes de 2 mm. */
+export class GeneratePdfRequest {
+    @IsString() @IsNotEmpty()
+    html!: string;
+}

package/src/pdfRender/dtos/MergePdfsRequest.ts

@@ -0,0 +1,7 @@
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsString } from "class-validator";
+
+/** PDFs en base64, en el orden en que deben quedar en el documento final. */
+export class MergePdfsRequest {
+    @IsArray() @ArrayMinSize(1) @ArrayMaxSize(50) @IsString({ each: true })
+    pdfs!: string[];
+}

package/src/pdfRender/dtos/PdfDocumentResponse.ts

@@ -0,0 +1,5 @@
+export class PdfDocumentResponse {
+    base64!: string;
+    pages!: number;
+    bytes!: number;
+}

package/src/pdfRender/dtos/PublishTemplateRequest.ts

@@ -0,0 +1,18 @@
+import { IsDefined, IsNotEmpty, IsString, Matches, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { TemplateLocationRequest } from "./TemplateLocationRequest";
+
+/** Tipo de documento al que se le publica una versión nueva. */
+export class PublishTemplateTarget extends TemplateLocationRequest {
+    @IsString() @IsNotEmpty() @Matches(/^[A-Za-z0-9_-]{1,64}$/)
+    documentType!: string;
+}
+
+/** Publica el HTML como la siguiente versión del tipo de documento. La versión la asigna el servicio. */
+export class PublishTemplateRequest {
+    @IsDefined() @ValidateNested() @Type(() => PublishTemplateTarget)
+    template!: PublishTemplateTarget;
+
+    @IsString() @IsNotEmpty()
+    html!: string;
+}

package/src/pdfRender/dtos/PublishTemplateResponse.ts

@@ -0,0 +1,4 @@
+export class PublishTemplateResponse {
+    key!: string;
+    version!: string;
+}

package/src/pdfRender/dtos/RenderDocumentRequest.ts

@@ -0,0 +1,12 @@
+import { IsDefined, IsObject, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { TemplateRefRequest } from "./TemplateRefRequest";
+
+export class RenderDocumentRequest {
+    @IsDefined() @ValidateNested() @Type(() => TemplateRefRequest)
+    template!: TemplateRefRequest;
+
+    /** Variables de la plantilla. Se escapan como HTML salvo que la plantilla use {{{triple}}}. */
+    @IsDefined() @IsObject()
+    data!: Record<string, unknown>;
+}

package/src/pdfRender/dtos/RenderDocumentResponse.ts

@@ -0,0 +1,6 @@
+import { PdfDocumentResponse } from "./PdfDocumentResponse";
+
+export class RenderDocumentResponse extends PdfDocumentResponse {
+    templateVersion!: string;
+    renderMs!: number;
+}

package/src/pdfRender/dtos/TemplateLocationRequest.ts

@@ -0,0 +1,15 @@
+import { IsNotEmpty, IsOptional, IsString, Matches } from "class-validator";
+
+const SEGMENT = /^[A-Za-z0-9_-]{1,64}$/;
+
+/** Carpeta del bucket de plantillas: empresa, y opcionalmente partner + categoría. */
+export class TemplateLocationRequest {
+    @IsString() @IsNotEmpty() @Matches(SEGMENT)
+    enterprise!: string;
+
+    @IsOptional() @IsString() @Matches(SEGMENT)
+    partnerId?: string;
+
+    @IsOptional() @IsString() @Matches(SEGMENT)
+    category?: string;
+}

package/src/pdfRender/dtos/TemplateRefRequest.ts

@@ -0,0 +1,28 @@
+import { IsNotEmpty, IsOptional, IsString, Matches } from "class-validator";
+
+/** Segmento de ruta S3 permitido: letras, dígitos, guion y guion bajo. */
+const SEGMENT = /^[A-Za-z0-9_-]{1,64}$/;
+
+/**
+ * Referencia a una plantilla del bucket de plantillas.
+ * Layout profundo: {enterprise}/{partnerId}/{category}/{documentType}/V{version}.html
+ * Layout plano:    {enterprise}/{documentType}/V{version}.html
+ * partnerId y category van juntos o no van.
+ */
+export class TemplateRefRequest {
+    @IsString() @IsNotEmpty() @Matches(SEGMENT)
+    enterprise!: string;
+
+    @IsOptional() @IsString() @Matches(SEGMENT)
+    partnerId?: string;
+
+    @IsOptional() @IsString() @Matches(SEGMENT)
+    category?: string;
+
+    @IsString() @IsNotEmpty() @Matches(SEGMENT)
+    documentType!: string;
+
+    /** Número de versión sin la "V". Sin valor se usa la versión más alta publicada. */
+    @IsOptional() @IsString() @Matches(/^[0-9]{1,6}$/)
+    version?: string;
+}

package/src/pdfRender/dtos/TemplateSummaryResponse.ts

@@ -0,0 +1,6 @@
+export class TemplateSummaryResponse {
+    documentType!: string;
+    /** Versiones publicadas, de menor a mayor. */
+    versions!: string[];
+    latestVersion!: string;
+}

package/src/pdfRender/dtos/UploadAssetRequest.ts

@@ -0,0 +1,25 @@
+import { IsBase64, IsIn, IsNotEmpty, IsOptional, IsString, Matches } from "class-validator";
+
+const SEGMENT = /^[A-Za-z0-9_-]{1,64}$/;
+/** Ruta relativa dentro de _assets/: hasta 4 carpetas y un archivo, sin "..", con extensión permitida. */
+const ASSET_PATH = /^(?!.*\.\.)([A-Za-z0-9_-]+\/){0,4}[A-Za-z0-9_.()-]+\.(ttf|otf|woff|woff2|png|jpg|jpeg|svg|gif|css)$/;
+
+export const ASSET_CONTENT_TYPES = ['font/ttf', 'font/otf', 'font/woff', 'font/woff2', 'image/png', 'image/jpeg', 'image/svg+xml', 'image/gif', 'text/css'];
+
+/** Fuente, imagen u hoja de estilo para la carpeta _assets de una empresa o partner. */
+export class UploadAssetRequest {
+    @IsString() @IsNotEmpty() @Matches(SEGMENT)
+    enterprise!: string;
+
+    @IsOptional() @IsString() @Matches(SEGMENT)
+    partnerId?: string;
+
+    @IsString() @Matches(ASSET_PATH)
+    path!: string;
+
+    @IsString() @IsIn(ASSET_CONTENT_TYPES)
+    contentType!: string;
+
+    @IsString() @IsNotEmpty() @IsBase64()
+    contentBase64!: string;
+}

package/src/pdfRender/dtos/UploadAssetResponse.ts

@@ -0,0 +1,4 @@
+export class UploadAssetResponse {
+    key!: string;
+    bytes!: number;
+}

package/src/pdfRender/index.ts

@@ -0,0 +1,13 @@
+//dtos
+export * from './dtos/TemplateRefRequest';
+export * from './dtos/RenderDocumentRequest';
+export * from './dtos/GeneratePdfRequest';
+export * from './dtos/MergePdfsRequest';
+export * from './dtos/PdfDocumentResponse';
+export * from './dtos/RenderDocumentResponse';
+export * from './dtos/TemplateLocationRequest';
+export * from './dtos/PublishTemplateRequest';
+export * from './dtos/PublishTemplateResponse';
+export * from './dtos/UploadAssetRequest';
+export * from './dtos/UploadAssetResponse';
+export * from './dtos/TemplateSummaryResponse';