@pdfme/manipulator 5.3.6

package/dist/esm/src/index.js

@@ -0,0 +1,150 @@
+import { PDFDocument, RotationTypes } from '@pdfme/pdf-lib';
+export const merge = async (pdfs) => {
+    if (!pdfs.length) {
+        throw new Error('[@pdfme/manipulator] At least one PDF is required for merging');
+    }
+    const mergedPdf = await PDFDocument.create();
+    for (const buffer of pdfs) {
+        const srcDoc = await PDFDocument.load(buffer);
+        const copiedPages = await mergedPdf.copyPages(srcDoc, srcDoc.getPageIndices());
+        copiedPages.forEach((page) => mergedPdf.addPage(page));
+    }
+    return mergedPdf.save();
+};
+export const split = async (pdf, ranges) => {
+    if (!ranges.length) {
+        throw new Error('[@pdfme/manipulator] At least one range is required for splitting');
+    }
+    const originalPdf = await PDFDocument.load(pdf);
+    const numPages = originalPdf.getPages().length;
+    const result = [];
+    for (const { start = 0, end = numPages - 1 } of ranges) {
+        if (start < 0 || end >= numPages || start > end) {
+            throw new Error(`[@pdfme/manipulator] Invalid range: start=${start}, end=${end}, total pages=${numPages}`);
+        }
+        const newPdf = await PDFDocument.create();
+        const pages = await newPdf.copyPages(originalPdf, Array.from({ length: end - start + 1 }, (_, i) => i + start));
+        pages.forEach((page) => newPdf.addPage(page));
+        result.push(await newPdf.save());
+    }
+    return result;
+};
+export const remove = async (pdf, pages) => {
+    if (!pages.length) {
+        throw new Error('[@pdfme/manipulator] At least one page number is required for removal');
+    }
+    const pdfDoc = await PDFDocument.load(pdf);
+    const numPages = pdfDoc.getPageCount();
+    if (pages.some((page) => page < 0 || page >= numPages)) {
+        throw new Error(`[@pdfme/manipulator] Invalid page number: pages must be between 0 and ${numPages - 1}`);
+    }
+    pages.sort((a, b) => b - a).forEach((pageIndex) => pdfDoc.removePage(pageIndex));
+    return pdfDoc.save();
+};
+export const insert = async (basePdf, inserts) => {
+    inserts.sort((a, b) => a.position - b.position);
+    let currentPdf = basePdf;
+    let offset = 0;
+    for (let i = 0; i < inserts.length; i++) {
+        const { pdf, position } = inserts[i];
+        const actualPos = position + offset;
+        const basePdfDoc = await PDFDocument.load(currentPdf);
+        const insertDoc = await PDFDocument.load(pdf);
+        const numPages = basePdfDoc.getPageCount();
+        if (actualPos < 0 || actualPos > numPages) {
+            throw new Error(`[@pdfme/manipulator] Invalid position: must be between 0 and ${numPages}`);
+        }
+        const newPdfDoc = await PDFDocument.create();
+        if (actualPos > 0) {
+            const beforePages = await newPdfDoc.copyPages(basePdfDoc, Array.from({ length: actualPos }, (_, idx) => idx));
+            beforePages.forEach((page) => newPdfDoc.addPage(page));
+        }
+        const insertPages = await newPdfDoc.copyPages(insertDoc, insertDoc.getPageIndices());
+        insertPages.forEach((page) => newPdfDoc.addPage(page));
+        if (actualPos < numPages) {
+            const afterPages = await newPdfDoc.copyPages(basePdfDoc, Array.from({ length: numPages - actualPos }, (_, idx) => idx + actualPos));
+            afterPages.forEach((page) => newPdfDoc.addPage(page));
+        }
+        currentPdf = await newPdfDoc.save();
+        offset += insertDoc.getPageCount();
+    }
+    return currentPdf;
+};
+export const rotate = async (pdf, degrees, pageNumbers) => {
+    if (!Number.isInteger(degrees) || degrees % 90 !== 0) {
+        throw new Error('[@pdfme/manipulator] Rotation degrees must be a multiple of 90');
+    }
+    const pdfDoc = await PDFDocument.load(pdf);
+    const pages = pdfDoc.getPages();
+    if (!pages.length) {
+        throw new Error('[@pdfme/manipulator] PDF has no pages to rotate');
+    }
+    const normalizedDegrees = ((degrees % 360) + 360) % 360;
+    if (normalizedDegrees % 90 !== 0) {
+        throw new Error('[@pdfme/manipulator] Rotation degrees must be a multiple of 90');
+    }
+    if (pageNumbers) {
+        if (pageNumbers.some((page) => page < 0 || page >= pages.length)) {
+            throw new Error(`[@pdfme/manipulator] Invalid page number: pages must be between 0 and ${pages.length - 1}`);
+        }
+    }
+    const pagesToRotate = pageNumbers || pages.map((_, i) => i);
+    pagesToRotate.forEach((pageNum) => {
+        const page = pages[pageNum];
+        if (page) {
+            page.setRotation({
+                type: RotationTypes.Degrees,
+                angle: normalizedDegrees % 360,
+            });
+        }
+    });
+    return pdfDoc.save();
+};
+export const move = async (pdf, operation) => {
+    const { from, to } = operation;
+    const pdfDoc = await PDFDocument.load(pdf);
+    const currentPageCount = pdfDoc.getPageCount();
+    if (from < 0 || from >= currentPageCount || to < 0 || to >= currentPageCount) {
+        throw new Error(`[@pdfme/manipulator] Invalid page number: from=${from}, to=${to}, total pages=${currentPageCount}`);
+    }
+    if (from === to) {
+        return pdf;
+    }
+    const page = pdfDoc.getPage(from);
+    pdfDoc.removePage(from);
+    const adjustedTo = from < to ? to - 1 : to;
+    pdfDoc.insertPage(adjustedTo, page);
+    return pdfDoc.save();
+};
+export const organize = async (pdf, actions) => {
+    if (!actions.length) {
+        throw new Error('[@pdfme/manipulator] At least one action is required');
+    }
+    let currentPdf = await PDFDocument.load(pdf);
+    for (const action of actions) {
+        const currentBuffer = (await currentPdf.save()).buffer;
+        switch (action.type) {
+            case 'remove':
+                currentPdf = await PDFDocument.load(await remove(currentBuffer, [action.data.position]));
+                break;
+            case 'insert':
+                currentPdf = await PDFDocument.load(await insert(currentBuffer, [action.data]));
+                break;
+            case 'replace': {
+                const withoutTarget = await remove(currentBuffer, [action.data.position]);
+                currentPdf = await PDFDocument.load(await insert(withoutTarget, [action.data]));
+                break;
+            }
+            case 'rotate':
+                currentPdf = await PDFDocument.load(await rotate(currentBuffer, action.data.degrees, [action.data.position]));
+                break;
+            case 'move':
+                currentPdf = await PDFDocument.load(await move(currentBuffer, action.data));
+                break;
+            default:
+                throw new Error(`[@pdfme/manipulator] Unknown action type: ${action.type}`);
+        }
+    }
+    return currentPdf.save();
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types/__tests__/index.test.d.ts

@@ -0,0 +1 @@
+import 'jest-image-snapshot';

package/dist/types/__tests__/utils.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="node" />
+/// <reference types="node" />
+export declare const createTestPDF: (pageCount: number) => Promise<ArrayBuffer>;
+export declare const pdfToImages: (pdf: ArrayBuffer) => Promise<Buffer[]>;
+export declare const getPDFPageCount: (pdf: ArrayBuffer) => Promise<number>;

package/dist/types/src/index.d.ts

@@ -0,0 +1,45 @@
+export declare const merge: (pdfs: ArrayBuffer[]) => Promise<ArrayBuffer>;
+export declare const split: (pdf: ArrayBuffer, ranges: {
+    start?: number;
+    end?: number;
+}[]) => Promise<ArrayBuffer[]>;
+export declare const remove: (pdf: ArrayBuffer, pages: number[]) => Promise<ArrayBuffer>;
+export declare const insert: (basePdf: ArrayBuffer, inserts: {
+    pdf: ArrayBuffer;
+    position: number;
+}[]) => Promise<ArrayBuffer>;
+export declare const rotate: (pdf: ArrayBuffer, degrees: 0 | 90 | 180 | 270 | 360, pageNumbers?: number[]) => Promise<ArrayBuffer>;
+export declare const move: (pdf: ArrayBuffer, operation: {
+    from: number;
+    to: number;
+}) => Promise<ArrayBuffer>;
+export declare const organize: (pdf: ArrayBuffer, actions: ({
+    type: 'remove';
+    data: {
+        position: number;
+    };
+} | {
+    type: 'insert';
+    data: {
+        pdf: ArrayBuffer;
+        position: number;
+    };
+} | {
+    type: 'replace';
+    data: {
+        pdf: ArrayBuffer;
+        position: number;
+    };
+} | {
+    type: 'rotate';
+    data: {
+        position: number;
+        degrees: 0 | 90 | 180 | 270 | 360;
+    };
+} | {
+    type: 'move';
+    data: {
+        from: number;
+        to: number;
+    };
+})[]) => Promise<ArrayBuffer>;

package/jest.setup.js

@@ -0,0 +1,2 @@
+const { toMatchImageSnapshot } = require('jest-image-snapshot');
+expect.extend({ toMatchImageSnapshot });

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@pdfme/manipulator",
+  "version": "5.3.6",
+  "sideEffects": false,
+  "author": "hand-dot",
+  "license": "MIT",
+  "keywords": [
+    "pdf",
+    "pdf-generation",
+    "pdf-designer",
+    "pdf-viewer",
+    "typescript",
+    "react"
+  ],
+  "description": "TypeScript base PDF generator and React base UI. Open source, developed by the community, and completely free to use under the MIT license!",
+  "homepage": "https://pdfme.com",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:pdfme/pdfme.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pdfme/pdfme/issues"
+  },
+  "main": "dist/cjs/src/index.js",
+  "module": "dist/esm/src/index.js",
+  "types": "dist/types/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/src/index.js",
+      "require": "./dist/cjs/src/index.js",
+      "types": "./dist/types/src/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "tsc -p tsconfig.esm.json -w",
+    "build": "npm-run-all --parallel build:cjs build:esm",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "clean": "rimraf dist",
+    "lint": "eslint --ext .ts src",
+    "test": "jest",
+    "test:update-snapshots": "jest --updateSnapshot",
+    "prune": "ts-prune src",
+    "prettier": "prettier --write 'src/**/*.ts'"
+  },
+  "dependencies": {
+    "@pdfme/pdf-lib": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@pdfme/converter": "*",
+    "@types/estree": "^1.0.6"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "setupFilesAfterEnv": [
+      "<rootDir>/jest.setup.js"
+    ],
+    "testMatch": [
+      "**/__tests__/**/*.test.ts"
+    ],
+    "transform": {
+      "^.+\\.tsx?$": [
+        "ts-jest",
+        {
+          "tsconfig": "./tsconfig.json"
+        }
+      ]
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,236 @@
+import { PDFDocument, RotationTypes } from '@pdfme/pdf-lib';
+
+export const merge = async (pdfs: ArrayBuffer[]): Promise<ArrayBuffer> => {
+  if (!pdfs.length) {
+    throw new Error('[@pdfme/manipulator] At least one PDF is required for merging');
+  }
+
+  const mergedPdf = await PDFDocument.create();
+  for (const buffer of pdfs) {
+    const srcDoc = await PDFDocument.load(buffer);
+    const copiedPages = await mergedPdf.copyPages(srcDoc, srcDoc.getPageIndices());
+    copiedPages.forEach((page) => mergedPdf.addPage(page));
+  }
+  return mergedPdf.save();
+};
+
+export const split = async (
+  pdf: ArrayBuffer,
+  ranges: { start?: number; end?: number }[]
+): Promise<ArrayBuffer[]> => {
+  if (!ranges.length) {
+    throw new Error('[@pdfme/manipulator] At least one range is required for splitting');
+  }
+
+  const originalPdf = await PDFDocument.load(pdf);
+  const numPages = originalPdf.getPages().length;
+  const result: ArrayBuffer[] = [];
+
+  for (const { start = 0, end = numPages - 1 } of ranges) {
+    if (start < 0 || end >= numPages || start > end) {
+      throw new Error(
+        `[@pdfme/manipulator] Invalid range: start=${start}, end=${end}, total pages=${numPages}`
+      );
+    }
+
+    const newPdf = await PDFDocument.create();
+    const pages = await newPdf.copyPages(
+      originalPdf,
+      Array.from({ length: end - start + 1 }, (_, i) => i + start)
+    );
+    pages.forEach((page) => newPdf.addPage(page));
+    result.push(await newPdf.save());
+  }
+  return result;
+};
+
+export const remove = async (pdf: ArrayBuffer, pages: number[]): Promise<ArrayBuffer> => {
+  if (!pages.length) {
+    throw new Error('[@pdfme/manipulator] At least one page number is required for removal');
+  }
+
+  const pdfDoc = await PDFDocument.load(pdf);
+  const numPages = pdfDoc.getPageCount();
+
+  if (pages.some((page) => page < 0 || page >= numPages)) {
+    throw new Error(
+      `[@pdfme/manipulator] Invalid page number: pages must be between 0 and ${numPages - 1}`
+    );
+  }
+
+  pages.sort((a, b) => b - a).forEach((pageIndex) => pdfDoc.removePage(pageIndex));
+  return pdfDoc.save();
+};
+
+export const insert = async (
+  basePdf: ArrayBuffer,
+  inserts: { pdf: ArrayBuffer; position: number }[]
+): Promise<ArrayBuffer> => {
+  inserts.sort((a, b) => a.position - b.position);
+
+  let currentPdf = basePdf;
+  let offset = 0;
+
+  for (let i = 0; i < inserts.length; i++) {
+    const { pdf, position } = inserts[i];
+    const actualPos = position + offset;
+
+    const basePdfDoc = await PDFDocument.load(currentPdf);
+    const insertDoc = await PDFDocument.load(pdf);
+    const numPages = basePdfDoc.getPageCount();
+
+    if (actualPos < 0 || actualPos > numPages) {
+      throw new Error(`[@pdfme/manipulator] Invalid position: must be between 0 and ${numPages}`);
+    }
+
+    const newPdfDoc = await PDFDocument.create();
+
+    if (actualPos > 0) {
+      const beforePages = await newPdfDoc.copyPages(
+        basePdfDoc,
+        Array.from({ length: actualPos }, (_, idx) => idx)
+      );
+      beforePages.forEach((page) => newPdfDoc.addPage(page));
+    }
+
+    const insertPages = await newPdfDoc.copyPages(insertDoc, insertDoc.getPageIndices());
+    insertPages.forEach((page) => newPdfDoc.addPage(page));
+
+    if (actualPos < numPages) {
+      const afterPages = await newPdfDoc.copyPages(
+        basePdfDoc,
+        Array.from({ length: numPages - actualPos }, (_, idx) => idx + actualPos)
+      );
+      afterPages.forEach((page) => newPdfDoc.addPage(page));
+    }
+
+    currentPdf = await newPdfDoc.save();
+
+    offset += insertDoc.getPageCount();
+  }
+
+  return currentPdf;
+};
+
+export const rotate = async (
+  pdf: ArrayBuffer,
+  degrees: 0 | 90 | 180 | 270 | 360,
+  pageNumbers?: number[]
+): Promise<ArrayBuffer> => {
+  if (!Number.isInteger(degrees) || degrees % 90 !== 0) {
+    throw new Error('[@pdfme/manipulator] Rotation degrees must be a multiple of 90');
+  }
+
+  const pdfDoc = await PDFDocument.load(pdf);
+  const pages = pdfDoc.getPages();
+
+  if (!pages.length) {
+    throw new Error('[@pdfme/manipulator] PDF has no pages to rotate');
+  }
+
+  const normalizedDegrees = ((degrees % 360) + 360) % 360;
+
+  if (normalizedDegrees % 90 !== 0) {
+    throw new Error('[@pdfme/manipulator] Rotation degrees must be a multiple of 90');
+  }
+
+  if (pageNumbers) {
+    if (pageNumbers.some((page) => page < 0 || page >= pages.length)) {
+      throw new Error(
+        `[@pdfme/manipulator] Invalid page number: pages must be between 0 and ${pages.length - 1}`
+      );
+    }
+  }
+
+  const pagesToRotate = pageNumbers || pages.map((_, i) => i);
+  pagesToRotate.forEach((pageNum) => {
+    const page = pages[pageNum];
+    if (page) {
+      page.setRotation({
+        type: RotationTypes.Degrees,
+        angle: normalizedDegrees % 360,
+      });
+    }
+  });
+  return pdfDoc.save();
+};
+
+export const move = async (
+  pdf: ArrayBuffer,
+  operation: { from: number; to: number }
+): Promise<ArrayBuffer> => {
+  const { from, to } = operation;
+  const pdfDoc = await PDFDocument.load(pdf);
+  const currentPageCount = pdfDoc.getPageCount();
+
+  if (from < 0 || from >= currentPageCount || to < 0 || to >= currentPageCount) {
+    throw new Error(
+      `[@pdfme/manipulator] Invalid page number: from=${from}, to=${to}, total pages=${currentPageCount}`
+    );
+  }
+
+  if (from === to) {
+    return pdf;
+  }
+
+  const page = pdfDoc.getPage(from);
+  pdfDoc.removePage(from);
+
+  const adjustedTo = from < to ? to - 1 : to;
+  pdfDoc.insertPage(adjustedTo, page);
+
+  return pdfDoc.save();
+};
+
+
+export const organize = async (
+  pdf: ArrayBuffer,
+  actions: Array<
+    | { type: 'remove'; data: { position: number } }
+    | { type: 'insert'; data: { pdf: ArrayBuffer; position: number } }
+    | { type: 'replace'; data: { pdf: ArrayBuffer; position: number } }
+    | { type: 'rotate'; data: { position: number; degrees: 0 | 90 | 180 | 270 | 360 } }
+    | { type: 'move'; data: { from: number; to: number } }
+  >
+): Promise<ArrayBuffer> => {
+  if (!actions.length) {
+    throw new Error('[@pdfme/manipulator] At least one action is required');
+  }
+
+  let currentPdf = await PDFDocument.load(pdf);
+
+  for (const action of actions) {
+    const currentBuffer = (await currentPdf.save()).buffer;
+
+    switch (action.type) {
+      case 'remove':
+        currentPdf = await PDFDocument.load(await remove(currentBuffer, [action.data.position]));
+        break;
+
+      case 'insert':
+        currentPdf = await PDFDocument.load(await insert(currentBuffer, [action.data]));
+        break;
+
+      case 'replace': {
+        const withoutTarget = await remove(currentBuffer, [action.data.position]);
+        currentPdf = await PDFDocument.load(await insert(withoutTarget, [action.data]));
+        break;
+      }
+
+      case 'rotate':
+        currentPdf = await PDFDocument.load(
+          await rotate(currentBuffer, action.data.degrees, [action.data.position])
+        );
+        break;
+
+      case 'move':
+        currentPdf = await PDFDocument.load(await move(currentBuffer, action.data));
+        break;
+
+      default:
+        throw new Error(`[@pdfme/manipulator] Unknown action type: ${(action as any).type}`);
+    }
+  }
+
+  return currentPdf.save();
+};

package/tsconfig.cjs.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base",
+  "compilerOptions": {
+    "module": "commonjs",
+    "outDir": "./dist/cjs",
+    "declaration": true,
+    "declarationDir": "dist/types",
+    "skipLibCheck": true
+  }
+}

package/tsconfig.esm.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base",
+  "compilerOptions": {
+    "module": "ESNext",
+    "outDir": "./dist/esm",
+    "declaration": true,
+    "declarationDir": "dist/types",
+    "skipLibCheck": true
+  }
+}

package/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "./tsconfig.esm",
+  "compilerOptions": {
+    "outDir": "./dist",
+  }
+}