@fiado/type-kit 3.561.0 → 3.562.0

package/_test_/unit/directDeposit/directDepositDtos.test.ts

@@ -0,0 +1,38 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { GetDirectDepositFormatByDirectoryRequest, GetDirectDepositFormatRequest } from '../../../src/directDeposit';
+
+const parse = async <T extends object>(cls: new () => T, query: unknown) => {
+    const instance = plainToInstance(cls, query);
+    const errors = (await validate(instance as object, { whitelist: true })).map(e => e.property);
+    return { instance, errors };
+};
+
+describe('GetDirectDepositFormatRequest (app: el directoryId sale del token)', () => {
+    it('convierte percentage de string (query) a número', async () => {
+        const { instance, errors } = await parse(GetDirectDepositFormatRequest, { percentage: '50' });
+        expect(errors).toEqual([]);
+        expect(instance.percentage).toBe(50);
+    });
+
+    it('percentage es opcional', async () => {
+        expect((await parse(GetDirectDepositFormatRequest, {})).errors).toEqual([]);
+    });
+
+    it.each(['0', '101', '12.5', 'abc'])('rechaza percentage=%s', async (percentage) => {
+        expect((await parse(GetDirectDepositFormatRequest, { percentage })).errors).toEqual(['percentage']);
+    });
+});
+
+describe('GetDirectDepositFormatByDirectoryRequest (agentes y backoffice)', () => {
+    it('acepta directoryId con percentage', async () => {
+        const { instance, errors } = await parse(GetDirectDepositFormatByDirectoryRequest, { directoryId: 'dir-1', percentage: '30' });
+        expect(errors).toEqual([]);
+        expect(instance.percentage).toBe(30);
+    });
+
+    it.each([[{}], [{ directoryId: '' }]])('directoryId es obligatorio (%j)', async (query) => {
+        expect((await parse(GetDirectDepositFormatByDirectoryRequest, query)).errors).toEqual(['directoryId']);
+    });
+});

package/_test_/unit/pdfGenerator/pdfGeneratorDtos.test.ts

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { PdfGeneratorRequest } from '../../../src/pdfGenerator';
+
+const errorsOf = async (body: unknown) =>
+    (await validate(plainToInstance(PdfGeneratorRequest, body) as object, { whitelist: true })).map(e => e.property);
+
+describe('pdfGenerator DTOs', () => {
+    it('acepta html con page y provider', async () => {
+        expect(await errorsOf({
+            html: '<p>x</p>',
+            page: { size: 'A4', margin: { top: '45pt', right: '45pt', bottom: '45pt', left: '45pt' } },
+            provider: 'pdflib',
+        })).toEqual([]);
+    });
+
+    it('acepta solo html', async () => {
+        expect(await errorsOf({ html: '<p>x</p>' })).toEqual([]);
+    });
+
+    it('rechaza html vacío y provider desconocido', async () => {
+        expect((await errorsOf({ html: '', provider: 'chrome' })).sort()).toEqual(['html', 'provider']);
+    });
+
+    it('rechaza page que no es objeto', async () => {
+        expect(await errorsOf({ html: '<p>x</p>', page: 'A4' })).toEqual(['page']);
+    });
+});

package/bin/directDeposit/dtos/DirectDepositFormatResponse.d.ts

@@ -0,0 +1,4 @@
+/** `data` de la respuesta: el PDF del formato Direct Deposit en base64. */
+export declare class DirectDepositFormatResponse {
+    format: string;
+}

package/bin/directDeposit/dtos/DirectDepositFormatResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectDepositFormatResponse = void 0;
+/** `data` de la respuesta: el PDF del formato Direct Deposit en base64. */
+class DirectDepositFormatResponse {
+}
+exports.DirectDepositFormatResponse = DirectDepositFormatResponse;

package/bin/directDeposit/dtos/GetDirectDepositFormatByDirectoryRequest.d.ts

@@ -0,0 +1,6 @@
+/** Query de GET /agents/direct-deposit y /backoffice/direct-deposit (+ /v2): formato de un tercero. */
+export declare class GetDirectDepositFormatByDirectoryRequest {
+    directoryId: string;
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    percentage?: number;
+}

package/bin/directDeposit/dtos/GetDirectDepositFormatByDirectoryRequest.js

@@ -0,0 +1,31 @@
+"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.GetDirectDepositFormatByDirectoryRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de GET /agents/direct-deposit y /backoffice/direct-deposit (+ /v2): formato de un tercero. */
+class GetDirectDepositFormatByDirectoryRequest {
+}
+exports.GetDirectDepositFormatByDirectoryRequest = GetDirectDepositFormatByDirectoryRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GetDirectDepositFormatByDirectoryRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], GetDirectDepositFormatByDirectoryRequest.prototype, "percentage", void 0);

package/bin/directDeposit/dtos/GetDirectDepositFormatRequest.d.ts

@@ -0,0 +1,5 @@
+/** Query de GET /direct-deposit (app) de direct-deposit-export-business. El directoryId sale del token. */
+export declare class GetDirectDepositFormatRequest {
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    percentage?: number;
+}

package/bin/directDeposit/dtos/GetDirectDepositFormatRequest.js

@@ -0,0 +1,26 @@
+"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.GetDirectDepositFormatRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de GET /direct-deposit (app) de direct-deposit-export-business. El directoryId sale del token. */
+class GetDirectDepositFormatRequest {
+}
+exports.GetDirectDepositFormatRequest = GetDirectDepositFormatRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], GetDirectDepositFormatRequest.prototype, "percentage", void 0);

package/bin/directDeposit/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/GetDirectDepositFormatRequest';
+export * from './dtos/GetDirectDepositFormatByDirectoryRequest';
+export * from './dtos/DirectDepositFormatResponse';

package/bin/directDeposit/index.js

@@ -0,0 +1,20 @@
+"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/GetDirectDepositFormatRequest"), exports);
+__exportStar(require("./dtos/GetDirectDepositFormatByDirectoryRequest"), exports);
+__exportStar(require("./dtos/DirectDepositFormatResponse"), exports);

package/bin/pdfGenerator/dtos/PdfGeneratorPageConfig.d.ts

@@ -0,0 +1,28 @@
+/** Tamaño nombrado o personalizado en puntos PDF (1pt = 1/72in). */
+export type PdfGeneratorPageSize = 'LETTER' | 'A4' | 'LEGAL' | {
+    width: number;
+    height: number;
+};
+/** Texto por página en el margen; acepta los tokens {page} y {pages}. */
+export declare class PdfGeneratorPageBoxText {
+    left?: string;
+    center?: string;
+    right?: string;
+    fontSize?: number;
+}
+/**
+ * Configuración de hoja de pdf-generator-business. Las longitudes de margen llevan unidad
+ * (mm, cm, in, pt, px). Sin `page`, el lambda usa el @page de la plantilla o A4 con 2 mm.
+ */
+export declare class PdfGeneratorPageConfig {
+    size?: PdfGeneratorPageSize;
+    orientation?: 'portrait' | 'landscape';
+    margin?: {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+    };
+    header?: PdfGeneratorPageBoxText;
+    footer?: PdfGeneratorPageBoxText;
+}

package/bin/pdfGenerator/dtos/PdfGeneratorPageConfig.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfGeneratorPageConfig = exports.PdfGeneratorPageBoxText = void 0;
+/** Texto por página en el margen; acepta los tokens {page} y {pages}. */
+class PdfGeneratorPageBoxText {
+}
+exports.PdfGeneratorPageBoxText = PdfGeneratorPageBoxText;
+/**
+ * Configuración de hoja de pdf-generator-business. Las longitudes de margen llevan unidad
+ * (mm, cm, in, pt, px). Sin `page`, el lambda usa el @page de la plantilla o A4 con 2 mm.
+ */
+class PdfGeneratorPageConfig {
+}
+exports.PdfGeneratorPageConfig = PdfGeneratorPageConfig;

package/bin/pdfGenerator/dtos/PdfGeneratorRequest.d.ts

@@ -0,0 +1,9 @@
+import { PdfGeneratorPageConfig } from './PdfGeneratorPageConfig';
+/** POST /generate-pdf de pdf-generator-business: HTML ya armado → PDF en base64. */
+export declare class PdfGeneratorRequest {
+    html: string;
+    /** La valida a fondo el propio lambda (400 con el campo que falla). */
+    page?: PdfGeneratorPageConfig;
+    /** Override del motor para este request (default del lambda: pdflib). */
+    provider?: 'pdflib' | 'puppeteer';
+}

package/bin/pdfGenerator/dtos/PdfGeneratorRequest.js

@@ -0,0 +1,33 @@
+"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.PdfGeneratorRequest = void 0;
+const class_validator_1 = require("class-validator");
+const PdfGeneratorPageConfig_1 = require("./PdfGeneratorPageConfig");
+/** POST /generate-pdf de pdf-generator-business: HTML ya armado → PDF en base64. */
+class PdfGeneratorRequest {
+}
+exports.PdfGeneratorRequest = PdfGeneratorRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PdfGeneratorRequest.prototype, "html", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", PdfGeneratorPageConfig_1.PdfGeneratorPageConfig)
+], PdfGeneratorRequest.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(['pdflib', 'puppeteer']),
+    __metadata("design:type", String)
+], PdfGeneratorRequest.prototype, "provider", void 0);

package/bin/pdfGenerator/dtos/PdfGeneratorResponse.d.ts

@@ -0,0 +1,4 @@
+/** Respuesta de POST /generate-pdf. El header X-Pdf-Provider indica el motor usado. */
+export declare class PdfGeneratorResponse {
+    base64: string;
+}

package/bin/pdfGenerator/dtos/PdfGeneratorResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfGeneratorResponse = void 0;
+/** Respuesta de POST /generate-pdf. El header X-Pdf-Provider indica el motor usado. */
+class PdfGeneratorResponse {
+}
+exports.PdfGeneratorResponse = PdfGeneratorResponse;

package/bin/pdfGenerator/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/PdfGeneratorPageConfig';
+export * from './dtos/PdfGeneratorRequest';
+export * from './dtos/PdfGeneratorResponse';

package/bin/pdfGenerator/index.js

@@ -0,0 +1,20 @@
+"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/PdfGeneratorPageConfig"), exports);
+__exportStar(require("./dtos/PdfGeneratorRequest"), exports);
+__exportStar(require("./dtos/PdfGeneratorResponse"), exports);

package/package.json

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

package/src/directDeposit/dtos/DirectDepositFormatResponse.ts

@@ -0,0 +1,4 @@
+/** `data` de la respuesta: el PDF del formato Direct Deposit en base64. */
+export class DirectDepositFormatResponse {
+    format!: string;
+}

package/src/directDeposit/dtos/GetDirectDepositFormatByDirectoryRequest.ts

@@ -0,0 +1,12 @@
+import { Type } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/** Query de GET /agents/direct-deposit y /backoffice/direct-deposit (+ /v2): formato de un tercero. */
+export class GetDirectDepositFormatByDirectoryRequest {
+    @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    @IsOptional() @Type(() => Number) @IsInt() @Min(1) @Max(100)
+    percentage?: number;
+}

package/src/directDeposit/dtos/GetDirectDepositFormatRequest.ts

@@ -0,0 +1,9 @@
+import { Type } from 'class-transformer';
+import { IsInt, IsOptional, Max, Min } from 'class-validator';
+
+/** Query de GET /direct-deposit (app) de direct-deposit-export-business. El directoryId sale del token. */
+export class GetDirectDepositFormatRequest {
+    /** Porcentaje del cheque a depositar (1–100). Default 100. */
+    @IsOptional() @Type(() => Number) @IsInt() @Min(1) @Max(100)
+    percentage?: number;
+}

package/src/directDeposit/index.ts

@@ -0,0 +1,4 @@
+//dtos
+export * from './dtos/GetDirectDepositFormatRequest';
+export * from './dtos/GetDirectDepositFormatByDirectoryRequest';
+export * from './dtos/DirectDepositFormatResponse';

package/src/pdfGenerator/dtos/PdfGeneratorPageConfig.ts

@@ -0,0 +1,22 @@
+/** Tamaño nombrado o personalizado en puntos PDF (1pt = 1/72in). */
+export type PdfGeneratorPageSize = 'LETTER' | 'A4' | 'LEGAL' | { width: number; height: number };
+
+/** Texto por página en el margen; acepta los tokens {page} y {pages}. */
+export class PdfGeneratorPageBoxText {
+    left?: string;
+    center?: string;
+    right?: string;
+    fontSize?: number;
+}
+
+/**
+ * Configuración de hoja de pdf-generator-business. Las longitudes de margen llevan unidad
+ * (mm, cm, in, pt, px). Sin `page`, el lambda usa el @page de la plantilla o A4 con 2 mm.
+ */
+export class PdfGeneratorPageConfig {
+    size?: PdfGeneratorPageSize;
+    orientation?: 'portrait' | 'landscape';
+    margin?: { top?: string; right?: string; bottom?: string; left?: string };
+    header?: PdfGeneratorPageBoxText;
+    footer?: PdfGeneratorPageBoxText;
+}

package/src/pdfGenerator/dtos/PdfGeneratorRequest.ts

@@ -0,0 +1,16 @@
+import { IsIn, IsNotEmpty, IsObject, IsOptional, IsString } from 'class-validator';
+import { PdfGeneratorPageConfig } from './PdfGeneratorPageConfig';
+
+/** POST /generate-pdf de pdf-generator-business: HTML ya armado → PDF en base64. */
+export class PdfGeneratorRequest {
+    @IsString() @IsNotEmpty()
+    html!: string;
+
+    /** La valida a fondo el propio lambda (400 con el campo que falla). */
+    @IsOptional() @IsObject()
+    page?: PdfGeneratorPageConfig;
+
+    /** Override del motor para este request (default del lambda: pdflib). */
+    @IsOptional() @IsIn(['pdflib', 'puppeteer'])
+    provider?: 'pdflib' | 'puppeteer';
+}

package/src/pdfGenerator/dtos/PdfGeneratorResponse.ts

@@ -0,0 +1,4 @@
+/** Respuesta de POST /generate-pdf. El header X-Pdf-Provider indica el motor usado. */
+export class PdfGeneratorResponse {
+    base64!: string;
+}

package/src/pdfGenerator/index.ts

@@ -0,0 +1,4 @@
+//dtos
+export * from './dtos/PdfGeneratorPageConfig';
+export * from './dtos/PdfGeneratorRequest';
+export * from './dtos/PdfGeneratorResponse';