@speresps/pdf-module 0.0.0-stage → 1.0.1

package/service/validation/validateData.js

@@ -0,0 +1,73 @@
+function validateObject(data) {
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new Error("PDF data must be an object.");
+    }
+}
+
+function validateColumns(columns) {
+    if (
+        !Array.isArray(columns) ||
+        columns.length === 0 ||
+        !columns.every(col => typeof col === "string" && col.trim())
+    ) {
+        throw new Error("Columns must be a non-empty array of strings.");
+    }
+}
+
+function validateRows(rows) {
+    if (!Array.isArray(rows)) {
+        throw new Error("Table data must be an array.");
+    }
+
+    if (!rows.every(row =>
+        row !== null &&
+        typeof row === "object" &&
+        !Array.isArray(row)
+    )) {
+        throw new Error("Every table row must be an object.");
+    }
+}
+
+function validateTableData(data) {
+    validateObject(data);
+    validateColumns(data.columns);
+    validateRows(data.tableData);
+}
+
+function validatePDFTextData(data) {
+    validateObject(data);
+
+    if (typeof data.text !== "string" || !data.text.trim()) {
+        throw new Error("PDF text must be a non-empty string.");
+    }
+}
+
+function validatePDFTextAndTableData(data) {
+    validatePDFTextData(data);
+    validateColumns(data.columns);
+    validateRows(data.tableData);
+}
+
+function validatePDFPaginationData(data) {
+    validatePDFTextData(data);
+    validateColumns(data.columns);
+
+    if (!Array.isArray(data.paginatedData) || data.paginatedData.length === 0) {
+        throw new Error("Paginated data must be a non-empty array.");
+    }
+
+    for (const page of data.paginatedData) {
+        if (!page || typeof page !== "object") {
+            throw new Error("Every pagination item must be an object.");
+        }
+
+        validateRows(page.data);
+    }
+}
+
+export {
+    validateTableData,
+    validatePDFTextData,
+    validatePDFTextAndTableData,
+    validatePDFPaginationData
+};

package/src/client/downloadPDF.js

@@ -0,0 +1,52 @@
+"use client";
+
+import { getPDFFile } from "../../api/client/clientApi.js";
+
+
+export async function downloadPDF(fileName) {
+
+    if (!fileName) {
+        throw new Error("PDF file name is required.");
+    }
+
+    const result = await getPDFFile(fileName);
+
+    if (!result || !result.success) {
+        throw new Error("Unable to download PDF file.");
+    }
+
+    const binary = atob(result.data);
+
+    const bytes = Uint8Array.from(
+        binary,
+        char => char.charCodeAt(0)
+    );
+
+    const blob = new Blob(
+        [bytes],
+        { type: result.mimeType }
+    );
+
+    const url = URL.createObjectURL(blob);
+
+    const link = document.createElement("a");
+
+    link.href = url;
+    link.download = result.fileName;
+
+    document.body.appendChild(link);
+
+    link.click();
+
+    link.remove();
+
+    setTimeout(() => {
+        URL.revokeObjectURL(url);
+    }, 1000);
+
+    return {
+        success: true,
+        fileName: result.fileName
+    };
+
+}

package/src/client/index.js

@@ -0,0 +1,13 @@
+// pdf-module/client
+
+export {
+    generatePDFTable,
+    generatePDFText,
+    generatePDFTextAndTable,
+    generatePDFTextAndTableWithPagination,
+    existsPDF
+} from "../../api/client/clientApi.js"
+
+export {
+    downloadPDF
+} from "./downloadPDF.js";

package/src/index.js

@@ -0,0 +1 @@
+export * from "./server/index.js";

package/src/server/index.js

@@ -0,0 +1,10 @@
+// pdf-module/server
+
+export {
+    generatePDFTable,
+    generatePDFText,
+    generatePDFTextAndTable,
+    generatePDFTextAndTableWithPagination,
+    downloadPDF,
+    existsPDF
+} from "../../api/server/serverApi.js"

package/template/generatePDFTable/generatePDFTable.js

@@ -0,0 +1,115 @@
+import pdfMake from "pdfmake-rtl/build/pdfmake.js";
+import pdfFonts from "../utils/vfs_fonts.js";
+import { getHeader } from "../utils/header.js";
+import { getFooter } from "../utils/footer.js";
+
+pdfMake.addVirtualFileSystem(pdfFonts.vfs);
+pdfMake.fonts = pdfFonts.fonts;
+
+
+export function generatePDFTable({
+                                     tableData,  // مقدار جدول
+                                     columns,  // مقدار ستونها
+                                     headerTitle, // عنوان هدر
+                                     headerLogoBase64,  // لوگو
+                                     footerInfo, // اطلاعات فوتر
+                                     fileName = "table.pdf", // اسم فایل
+                                     autoDownload = false, // وضعیت دانلود
+                                 }) {
+    const pageMargins = [40, 70, 40, 60]; // [left, top-bottom, top-right-left, bottom]
+    const pageWidthPortrait = 595.28;
+    const pageWidthLandscape = 841.89;
+
+    // محاسبه بیشترین طول محتوا در هر ستون
+    const maxContentWidths = columns.map(col => {
+        const maxLength = Math.max(
+            col.length,
+            ...tableData.map(row => (row[col]?.toString() ?? "").length)
+        );
+        return maxLength;
+    });
+
+    const charWidth = 7;
+    let totalTableWidth = maxContentWidths.reduce((sum, len) => sum + len * charWidth, 0);
+    totalTableWidth += columns.length * 10; // padding
+
+    const usableWidthPortrait = pageWidthPortrait - pageMargins[0] - pageMargins[2]*2+8;
+    const usableWidthLandscape = pageWidthLandscape - pageMargins[0] - pageMargins[2]*2-8;
+
+    const pageOrientation = totalTableWidth > usableWidthPortrait ? "landscape" : "portrait";
+    const usableWidth = pageOrientation === "portrait" ? usableWidthPortrait : usableWidthLandscape;
+
+    // تعیین عرض هر ستون
+    let widths = maxContentWidths.map(w => w * charWidth + 10);
+    const totalWidths = widths.reduce((a, b) => a + b, 0);
+
+    // پخش فضای خالی بین ستون‌ها اگر جا داریم
+    if (totalWidths < usableWidth) {
+        const extraSpace = (usableWidth - totalWidths) / columns.length;
+        widths = widths.map(w => w + extraSpace);
+    }
+
+    const tableBody = [
+        columns.map(col => ({
+            text: col,
+            style: "tableHeader",
+            alignment: "center",
+            font: "Vazirmatn",
+        })),
+        ...tableData.map(row =>
+            columns.map(col => ({
+                text: row[col]?.toString() ?? "",
+                alignment: "center",
+                font: "Vazirmatn",
+            }))
+        )
+    ];
+
+    const docDefinition = {
+        pageOrientation,
+        content: [
+            // { text: "", margin: [0, 7] },
+            {
+                table: {
+                    headerRows: 1,
+                    widths,
+                    body: tableBody,
+                },
+                layout: {
+                    fillColor: (rowIndex) => rowIndex === 0 ? '#eeeeee' : null,
+                    hLineWidth: () => 0.5,
+                    vLineWidth: () => 0.5,
+                    hLineColor: () => '#aaa',
+                    vLineColor: () => '#aaa',
+                },
+            },
+        ],
+        header: getHeader(headerTitle, headerLogoBase64, pageOrientation),
+        footer(currentPage, pageCount) {
+            return getFooter(currentPage, pageCount, footerInfo, pageOrientation);
+        },
+        defaultStyle: {
+            font: "Vazirmatn",
+            fontSize: 12,
+            alignment: "right",
+        },
+        styles: {
+            tableHeader: {
+                bold: true,
+                fontSize: 13,
+                color: 'black',
+                font: "Vazirmatn",
+            },
+        },
+        pageMargins,
+    };
+
+    const pdf = pdfMake.createPdf(docDefinition);
+
+    // برای دانلود مستقیم همان لحظه
+    if (autoDownload) {
+        pdf.download(fileName);
+    }
+
+    return pdf;
+}

package/template/generatePDFText/generatePDFText.js

@@ -0,0 +1,42 @@
+import pdfMake from "pdfmake-rtl/build/pdfmake.js";
+import pdfFonts from "../utils/vfs_fonts.js";
+import { getHeader } from "../utils/header.js";
+import { getFooter } from "../utils/footer.js";
+
+pdfMake.addVirtualFileSystem(pdfFonts.vfs);
+pdfMake.fonts = pdfFonts.fonts;
+
+export function generatePDFText({
+                                    text,
+                                    headerTitle,
+                                    headerLogoBase64,
+                                    footerInfo,
+                                    fileName='text.pdf',
+                                    autoDownload= false }) {
+    const docDefinition = {
+        content: [
+            { text: "", margin: [0, 7] },
+            { text: text, font: "Vazirmatn", direction: "rtl", alignment: "right" }
+        ],
+        header: getHeader(headerTitle, headerLogoBase64),
+        footer(currentPage, pageCount) {
+            return getFooter(currentPage, pageCount, footerInfo);
+        },
+        defaultStyle: {
+            font: "Vazirmatn",
+            fontSize: 16,
+            direction: "rtl",
+            alignment: "right",
+        },
+        pageMargins: [40, 70, 40, 60],
+    };
+
+    const pdfDoc = pdfMake.createPdf(docDefinition);
+
+    // برای دانلود مستقیم همان لحظه
+    if (autoDownload) {
+        pdfDoc.download(fileName);
+    }
+
+    return pdfDoc;
+}

package/template/generatePDFTextAndTable/generatePDFTextAndTable.js

@@ -0,0 +1,126 @@
+import pdfMake from "pdfmake-rtl/build/pdfmake.js";
+import pdfFonts from "../utils/vfs_fonts.js";
+import { getHeader } from "../utils/header.js";
+import { getFooter } from "../utils/footer.js";
+
+pdfMake.addVirtualFileSystem(pdfFonts.vfs);
+pdfMake.fonts = pdfFonts.fonts;
+
+export function generatePDFTextAndTable({
+                                            text, // متن
+                                            columns, //مقدار ستونها
+                                            tableData, // ارایه ردیفهای جدول
+                                            headerTitle,  // عنوان هدر
+                                            headerLogoBase64,  // لوگو
+                                            footerInfo,  // اطلاعات فوتر
+                                            fileName = "table.pdf",  // اسم فایل
+                                            autoDownload = false, // وضعیت دانلود
+                                        }) {
+    const pageMargins = [40, 70, 40, 60]; // left, top-bottom, top-right-left, bottom
+    const pageWidthPortrait = 595.28;
+    const pageWidthLandscape = 841.89;
+
+    // محاسبه بیشترین طول برای هر ستون
+    const maxContentWidths = columns.map(col => {
+        const maxLength = Math.max(
+            col.length,
+            ...tableData.map(row => (row[col]?.toString() ?? "").length)
+        );
+        return maxLength;
+    });
+
+    const charWidth = 7;
+    let totalTableWidth = maxContentWidths.reduce((sum, len) => sum + len * charWidth, 0);
+    totalTableWidth += columns.length * 10; // padding
+
+    const usableWidthPortrait = pageWidthPortrait - pageMargins[0] - pageMargins[2]*2+8;
+    const usableWidthLandscape = pageWidthLandscape - pageMargins[0] - pageMargins[2]*2-8;
+
+    const pageOrientation = totalTableWidth > usableWidthPortrait ? "landscape" : "portrait";
+    const usableWidth = pageOrientation === "portrait" ? usableWidthPortrait : usableWidthLandscape;
+
+    // تعیین عرض هر ستون
+    let widths = maxContentWidths.map(w => w * charWidth + 10);
+    const totalWidths = widths.reduce((a, b) => a + b, 0);
+
+    // اگر فضای خالی وجود دارد، بین ستون‌ها پخش کن
+    if (totalWidths < usableWidth) {
+        const extraSpace = (usableWidth - totalWidths) / columns.length;
+        widths = widths.map(w => w + extraSpace);
+    }
+
+    const tableBody = [
+        columns.map(col => ({
+            text: col,
+            style: "tableHeader",
+            alignment: "center",
+            font: "Vazirmatn",
+        })),
+        ...tableData.map(row =>
+            columns.map(col => ({
+                text: row[col]?.toString() ?? "",
+                alignment: "center",
+                font: "Vazirmatn",
+            }))
+        ),
+    ];
+
+    const content = [
+        // { text: "", margin: [0, 7] },
+        {
+            text,
+            font: "Vazirmatn",
+            fontSize: 16,
+            direction: "rtl",
+            alignment: "right",
+            margin: [0, 0, 0, 20],
+        },
+        {
+            table: {
+                headerRows: 1,
+                widths,
+                body: tableBody,
+            },
+
+            layout: {
+                fillColor: (rowIndex) => (rowIndex === 0 ? "#eeeeee" : null),
+                hLineWidth: () => 0.5,
+                vLineWidth: () => 0.5,
+                hLineColor: () => "#aaa",
+                vLineColor: () => "#aaa",
+            },
+        },
+    ];
+
+    const docDefinition = {
+        pageOrientation,
+        content,
+        header: getHeader(headerTitle, headerLogoBase64, pageOrientation),
+        footer(currentPage, pageCount) {
+            return getFooter(currentPage, pageCount, footerInfo, pageOrientation);
+        },
+        defaultStyle: {
+            font: "Vazirmatn",
+            fontSize: 12,
+            alignment: "right",
+        },
+        styles: {
+            tableHeader: {
+                bold: true,
+                fontSize: 13,
+                color: "black",
+                font: "Vazirmatn",
+            },
+        },
+        pageMargins,
+    };
+
+    const pdf = pdfMake.createPdf(docDefinition);
+
+    // برای دانلود مستقیم همان لحظه
+    if (autoDownload) {
+        pdf.download(fileName);
+    }
+
+    return pdf;
+}

package/template/generatePDFTextAndTableWithPagination/generatePDFTextAndTableWithPagination.js

@@ -0,0 +1,146 @@
+import pdfMake from "pdfmake-rtl/build/pdfmake.js";
+import pdfFonts from "../utils/vfs_fonts.js";
+import { getHeader } from "../utils/header.js";
+import { getFooter } from "../utils/footer.js";
+
+pdfMake.addVirtualFileSystem(pdfFonts.vfs);
+pdfMake.fonts = pdfFonts.fonts;
+
+// این متد روی داده هایی که ساختار صفحه بندی شده دارند استفاده میشود
+//const result=[
+//     {
+//         "page": 1,
+//         "per_page": 10,
+//         "total": 28,
+//         "total_pages": 3,
+//         "data": [
+//             {
+//                 "id": 1,
+//                 "email": "michael.lawson@reqres.in",
+//                 "first_name": "Michael",
+//                 "last_name": "Lawson",
+//                 "avatar": "https://reqres.in/img/faces/7-image.jpg",
+//                 "addr" : "my home"
+//             },
+//                ...
+//          ]}
+export function generatePDFTextAndTableWithPagination({
+                                                          text, // متن بالای جدول
+                                                          columns, // مقدار ستونها
+                                                          paginatedData, // داده های صفحه بندی شده
+                                                          headerTitle, // عنوان هدر
+                                                          headerLogoBase64, // لوگوی هدر
+                                                          footerInfo, // اطلاعات فوتر
+                                                          fileName='text-table-pagination.pdf', //نام فایل
+                                                          autoDownload= false , // وضعیت دانلود
+                                                      }) {
+    const pageMargins = [40, 70, 40, 60]; // left, top-bottom, top-right-left, bottom
+    const pageWidthPortrait = 595.28;
+    const pageWidthLandscape = 841.89;
+
+    const allData = paginatedData.flatMap(p => p.data);
+
+    const maxContentWidths = columns.map(col => {
+        const maxLength = Math.max(
+            col.length,
+            ...allData.map(row => (row[col]?.toString() ?? "").length)
+        );
+        return maxLength;
+    });
+
+    const charWidth = 7;
+    let totalTableWidth = maxContentWidths.reduce((sum, len) => sum + len * charWidth, 0);
+    totalTableWidth += columns.length * 10;
+
+    const usableWidthPortrait = pageWidthPortrait - pageMargins[0] - pageMargins[2]*2+5;
+    const usableWidthLandscape = pageWidthLandscape - pageMargins[0] - pageMargins[2]*2-3;
+
+    const pageOrientation = totalTableWidth > usableWidthPortrait ? "landscape" : "portrait";
+    const usableWidth = pageOrientation === "portrait" ? usableWidthPortrait : usableWidthLandscape;
+
+    let widths = maxContentWidths.map(w => w * charWidth + 10);
+    const totalWidths = widths.reduce((a, b) => a + b, 0);
+
+    if (totalWidths < usableWidth) {
+        const extraSpace = (usableWidth - totalWidths) / columns.length;
+        widths = widths.map(w => w + extraSpace);
+    }
+
+    const content = [];
+
+    paginatedData.forEach((pageData, index) => {
+        const tableBody = [
+            columns.map(col => ({
+                text: col,
+                style: "tableHeader",
+                alignment: "center",
+                font: "Vazirmatn",
+            })),
+            ...pageData.data.map(row =>
+                columns.map(col => ({
+                    text: row[col]?.toString() ?? "",
+                    alignment: "center",
+                    font: "Vazirmatn",
+                }))
+            )
+        ];
+
+        if (index > 0) content.push({ text: "", pageBreak: "before" });
+
+        content.push({
+            text: text,
+            font: "Vazirmatn",
+            fontSize: 16,
+            direction: "rtl",
+            alignment: "right",
+            margin: [0, 0, 0, 20],
+        });
+
+        content.push({
+            table: {
+                headerRows: 1,
+                widths,
+                body: tableBody,
+            },
+            layout: {
+                fillColor: (rowIndex) => rowIndex === 0 ? '#eeeeee' : null,
+                hLineWidth: () => 0.5,
+                vLineWidth: () => 0.5,
+                hLineColor: () => '#aaa',
+                vLineColor: () => '#aaa',
+            },
+        });
+    });
+
+    const docDefinition = {
+        pageOrientation,
+        content,
+        header: getHeader(headerTitle, headerLogoBase64, pageOrientation),
+        footer(currentPage, pageCount) {
+            return getFooter(currentPage, pageCount, footerInfo, pageOrientation);
+        },
+        defaultStyle: {
+            font: "Vazirmatn",
+            fontSize: 12,
+            alignment: "right",
+        },
+        styles: {
+            tableHeader: {
+                bold: true,
+                fontSize: 13,
+                color: 'black',
+                font: "Vazirmatn",
+            }
+        },
+        pageMargins,
+    };
+
+    const pdf = pdfMake.createPdf(docDefinition);
+
+    // برای دانلود مستقیم همان لحظه
+    if (autoDownload) {
+        pdf.download(fileName);
+    }
+
+    return pdf;
+}

package/template/utils/fontEncoder.cjs

@@ -0,0 +1,45 @@
+const fs = require("fs");
+const path = require("path");
+
+const FONT_DIR = path.resolve(__dirname, "../../public/fonts/vazir/ttf");
+
+const fontFiles = [
+    "Vazirmatn-Regular.ttf",
+    "Vazirmatn-Bold.ttf",
+    "Vazirmatn-Light.ttf",
+];
+
+const vfs = {};
+
+for (const file of fontFiles) {
+    const filePath = path.join(FONT_DIR, file);
+
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Font file not found: ${filePath}`);
+    }
+
+    vfs[file] = fs.readFileSync(filePath).toString("base64");
+}
+
+const fonts = {
+    Vazirmatn: {
+        normal: "Vazirmatn-Regular.ttf",
+        bold: "Vazirmatn-Bold.ttf",
+        italics: "Vazirmatn-Light.ttf",
+        bolditalics: "Vazirmatn-Bold.ttf",
+    },
+};
+
+const output = `const pdfFonts = {
+    vfs: ${JSON.stringify(vfs, null, 2)},
+    fonts: ${JSON.stringify(fonts, null, 2)},
+};
+
+export default pdfFonts;
+`;
+
+fs.writeFileSync(
+    path.resolve(__dirname, "./vfs_fonts.js"),
+    output,
+    "utf8"
+);

package/template/utils/footer.js

@@ -0,0 +1,34 @@
+export function getFooter(currentPage, pageCount, siteInfo = {}, pageOrientation) {
+    const {
+        siteName = "نام سایت شما",
+        address = "آدرس شما",
+        phone = "تلفن: ۰۱۲۳۴۵۶۷۸۹",
+        email = "ایمیل: info@example.com",
+        website = "www.example.com",
+    } = siteInfo;
+
+    return {
+        columns: [
+            {
+                text: `${siteName} | ${address} | ${phone} | ${email} | ${website}`,
+                fontSize: 8,
+                font: "Vazirmatn",
+                alignment: "left",
+                textAlign: "left",
+                direction:"ltr",
+                margin: [30, 20, 0, 20], //margin: [left, top-bottom, top-right-left, bottom]
+                width: "56%",
+            },
+            {
+                text: `صفحه ${currentPage} از ${pageCount}`,
+                fontSize: 10,
+                font: "Vazirmatn",
+                alignment: "right",
+                margin: [0, 20, 30, 20], //margin: [left, top-bottom, top-right-left, bottom]
+                width: "44%",
+            },
+        ],
+        margin: [0, 0, 0, 0],
+
+    };
+}

package/template/utils/header.js

@@ -0,0 +1,24 @@
+export function getHeader(title = "عنوان پیش‌ فرض هدر", logoBase64 = null, pageOrientation) {
+    return {
+        columns: [
+            logoBase64
+                ? {
+                    image: logoBase64,
+                    width: 40,
+                    height: 40,
+                    margin: [-10, 0 , 0, 10], //margin: [left, top-bottom, top-right-left, bottom]
+                }
+                : {},
+            {
+                text: title,
+                fontSize: 16,
+                bold: true,
+                alignment: "right",
+                direction: "rtl",
+                margin: [0, 5 , 10, 0], //margin: [left, top-bottom, top-right-left, bottom]
+                font: "Vazirmatn",
+            },
+        ],
+        margin: [30, 20, 30, 20],
+    };
+}