pdf-visual-compare 0.0.6 → 1.0.0

package/out/compare.pdf.d.ts

@@ -1,2 +1,2 @@
 import { ComparePdfOptions } from './types';
-export default function comparePdf(actualPdfFilePath: string, expectedPdfFilePath: string, opts?: ComparePdfOptions): Promise<boolean>;
+export default function comparePdf(actualPdfFilePathOrBuffer: string | ArrayBufferLike, expectedPdfFilePathOrBuffer: string | ArrayBufferLike, opts?: ComparePdfOptions): Promise<boolean>;

package/out/compare.pdf.js

@@ -7,35 +7,43 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const pdf_to_png_converter_1 = require("pdf-to-png-converter");
 const png_visual_compare_1 = __importDefault(require("png-visual-compare"));
-async function comparePdf(actualPdfFilePath, expectedPdfFilePath, opts) {
-    const actualPdfFilePathResolved = (0, path_1.resolve)(actualPdfFilePath);
-    if (!(0, fs_1.existsSync)(actualPdfFilePathResolved)) {
+async function comparePdf(actualPdfFilePathOrBuffer, expectedPdfFilePathOrBuffer, opts) {
+    if (!Buffer.isBuffer(actualPdfFilePathOrBuffer) && !(0, fs_1.existsSync)(actualPdfFilePathOrBuffer)) {
         throw Error('Actual PDF file not found.');
     }
-    const expectedPdfFilePathResolved = (0, path_1.resolve)(expectedPdfFilePath);
-    if (!(0, fs_1.existsSync)(expectedPdfFilePathResolved)) {
+    if (!Buffer.isBuffer(expectedPdfFilePathOrBuffer) && !(0, fs_1.existsSync)(expectedPdfFilePathOrBuffer)) {
         throw Error('Expected PDF file not found.');
     }
-    const pdfToPngConvertOpts = opts?.pdfToPngConvertOptions ?? {};
-    pdfToPngConvertOpts.viewportScale = pdfToPngConvertOpts.viewportScale ?? 2.0;
-    pdfToPngConvertOpts.outputFileMask = pdfToPngConvertOpts.outputFileMask ?? 'comparePdf';
+    const pdfToPngConvertOpts = opts?.pdfToPngConvertOptions ?? {
+        viewportScale: 2.0,
+        outputFileMask: 'comparePdf',
+    };
+    const diffsOutputFolder = opts?.diffsOutputFolder
+        ? opts.diffsOutputFolder
+        : (0, path_1.resolve)(`./comparePdfOutput`);
+    const compareThreshold = opts?.compareThreshold
+        ? opts?.compareThreshold
+        : 0;
+    const excludedAreas = opts?.excludedAreas
+        ? opts.excludedAreas
+        : [];
+    if (compareThreshold < 0) {
+        throw Error('Compare Threshold cannot be less than 0.');
+    }
     const [actualPdfPngPages, expectedPdfPngPages] = await Promise.all([
-        (0, pdf_to_png_converter_1.pdfToPng)(actualPdfFilePathResolved, pdfToPngConvertOpts),
-        (0, pdf_to_png_converter_1.pdfToPng)((0, path_1.resolve)(expectedPdfFilePath), pdfToPngConvertOpts),
+        (0, pdf_to_png_converter_1.pdfToPng)(actualPdfFilePathOrBuffer, pdfToPngConvertOpts),
+        (0, pdf_to_png_converter_1.pdfToPng)(expectedPdfFilePathOrBuffer, pdfToPngConvertOpts),
     ]);
     if (actualPdfPngPages.length !== expectedPdfPngPages.length) {
         return false;
     }
     let overallCompareResult = true;
-    const diffsOutputFolder = opts?.diffsOutputFolder ?? (0, path_1.resolve)(`./test-results/comparePdf/${(0, path_1.parse)(actualPdfFilePathResolved).base}_vs_${(0, path_1.parse)(expectedPdfFilePath).base}`);
     actualPdfPngPages.forEach((actualPdfPngPage, index) => {
-        let comparePngOpts = {};
-        if (opts?.excludedAreas && opts.excludedAreas[index].excludedAreas) {
-            comparePngOpts = { ...opts.excludedAreas[index] };
-        }
-        comparePngOpts.diffFilePath = comparePngOpts.diffFilePath ?? (0, path_1.resolve)(diffsOutputFolder, `diff_${actualPdfPngPage.name}`);
-        const compareResult = (0, png_visual_compare_1.default)(actualPdfPngPage.content, expectedPdfPngPages.find((expectedPdfPngPage) => expectedPdfPngPage.name === actualPdfPngPage.name).content, comparePngOpts);
-        if (compareResult > 0) {
+        const comparePngOpts = { ...opts?.pdfToPngConvertOptions, ...excludedAreas[index] };
+        comparePngOpts.diffFilePath = (0, path_1.resolve)(diffsOutputFolder, `diff_${actualPdfPngPage.name}`);
+        const expectedPdfPngPage = expectedPdfPngPages.find((expectedPdfPngPage) => expectedPdfPngPage.name === actualPdfPngPage.name);
+        const compareResult = (0, png_visual_compare_1.default)(actualPdfPngPage.content, expectedPdfPngPage.content, comparePngOpts);
+        if (compareResult > compareThreshold) {
             overallCompareResult = false;
         }
     });

package/out/compare.pdf.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.pdf.js","sourceRoot":"","sources":["../src/compare.pdf.ts"],"names":[],"mappings":";;;;;AAAA,2BAAgC;AAChC,+BAAsC;AACtC,+DAA+D;AAC/D,4EAAmE;AAGpD,KAAK,UAAU,UAAU,CAAC,iBAAyB,EAAE,mBAA2B,EAAE,IAAwB;IACrH,MAAM,yBAAyB,GAAW,IAAA,cAAO,EAAC,iBAAiB,CAAC,CAAA;IACpE,IAAG,CAAC,IAAA,eAAU,EAAC,yBAAyB,CAAC,EAAE;QACvC,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAA;KAC5C;IAED,MAAM,2BAA2B,GAAW,IAAA,cAAO,EAAC,mBAAmB,CAAC,CAAA;IACxE,IAAG,CAAC,IAAA,eAAU,EAAC,2BAA2B,CAAC,EAAE;QACzC,MAAM,KAAK,CAAC,8BAA8B,CAAC,CAAA;KAC9C;IAED,MAAM,mBAAmB,GAAoB,IAAI,EAAE,sBAAsB,IAAI,EAAE,CAAC;IAChF,mBAAmB,CAAC,aAAa,GAAG,mBAAmB,CAAC,aAAa,IAAI,GAAG,CAAC;IAC7E,mBAAmB,CAAC,cAAc,GAAG,mBAAmB,CAAC,cAAc,IAAI,YAAY,CAAC;IAExF,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/D,IAAA,+BAAQ,EAAC,yBAAyB,EAAE,mBAAmB,CAAC;QACxD,IAAA,+BAAQ,EAAC,IAAA,cAAO,EAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KAC9D,CAAC,CAAC;IAEH,IAAI,iBAAiB,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE;QACzD,OAAO,KAAK,CAAC;KAChB;IAED,IAAI,oBAAoB,GAAG,IAAI,CAAC;IAEhC,MAAM,iBAAiB,GACnB,IAAI,EAAE,iBAAiB,IAAI,IAAA,cAAO,EAAC,6BAA6B,IAAA,YAAK,EAAC,yBAAyB,CAAC,CAAC,IAAI,OAAO,IAAA,YAAK,EAAC,mBAAmB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnJ,iBAAiB,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE;QAClD,IAAI,cAAc,GAAsB,EAAE,CAAC;QAE3C,IAAI,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE;YAChE,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;SACrD;QACD,cAAc,CAAC,YAAY,GAAG,cAAc,CAAC,YAAY,IAAI,IAAA,cAAO,EAAC,iBAAiB,EAAE,QAAQ,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzH,MAAM,aAAa,GAAW,IAAA,4BAAU,EACpC,gBAAgB,CAAC,OAAO,EACvB,mBAAmB,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI,CAAmB,CAAC,OAAO,EAC9H,cAAc,CACjB,CAAC;QAEF,IAAI,aAAa,GAAG,CAAC,EAAE;YACnB,oBAAoB,GAAG,KAAK,CAAC;SAChC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC;AAChC,CAAC;AAjDD,6BAiDC"}
+{"version":3,"file":"compare.pdf.js","sourceRoot":"","sources":["../src/compare.pdf.ts"],"names":[],"mappings":";;;;;AAAA,2BAAgC;AAChC,+BAA+B;AAC/B,+DAA+D;AAC/D,4EAAmE;AAGpD,KAAK,UAAU,UAAU,CACtC,yBAAmD,EACnD,2BAAqD,EACrD,IAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAA,eAAU,EAAC,yBAAmC,CAAC,EAAE;QACnG,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;KAC3C;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAAC,IAAI,CAAC,IAAA,eAAU,EAAC,2BAAqC,CAAC,EAAE;QACvG,MAAM,KAAK,CAAC,8BAA8B,CAAC,CAAC;KAC7C;IAED,MAAM,mBAAmB,GAAoB,IAAI,EAAE,sBAAsB,IAAI;QAC3E,aAAa,EAAE,GAAG;QAClB,cAAc,EAAE,YAAY;KAC7B,CAAC;IACF,MAAM,iBAAiB,GAAW,IAAI,EAAE,iBAAiB;QACvD,CAAC,CAAC,IAAI,CAAC,iBAAiB;QACxB,CAAC,CAAC,IAAA,cAAO,EAAC,oBAAoB,CAAC,CAAC;IAClC,MAAM,gBAAgB,GAAW,IAAI,EAAE,gBAAgB;QACrD,CAAC,CAAC,IAAI,EAAE,gBAAgB;QACxB,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa;QACvC,CAAC,CAAC,IAAI,CAAC,aAAa;QACpB,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,gBAAgB,GAAG,CAAC,EAAE;QACxB,MAAM,KAAK,CAAC,0CAA0C,CAAC,CAAC;KACzD;IAED,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjE,IAAA,+BAAQ,EAAC,yBAAyB,EAAE,mBAAmB,CAAC;QACxD,IAAA,+BAAQ,EAAC,2BAA2B,EAAE,mBAAmB,CAAC;KAC3D,CAAC,CAAC;IAEH,IAAI,iBAAiB,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE;QAC3D,OAAO,KAAK,CAAC;KACd;IAED,IAAI,oBAAoB,GAAG,IAAI,CAAC;IAChC,iBAAiB,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE;QACpD,MAAM,cAAc,GAAsB,EAAE,GAAG,IAAI,EAAE,sBAAsB,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACvG,cAAc,CAAC,YAAY,GAAG,IAAA,cAAO,EAAC,iBAAiB,EAAE,QAAQ,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QAE1F,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,IAAI,CACjD,CAAC,kBAAkB,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI,CACzD,CAAC;QACnB,MAAM,aAAa,GAAW,IAAA,4BAAU,EAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAE/G,IAAI,aAAa,GAAG,gBAAgB,EAAE;YACpC,oBAAoB,GAAG,KAAK,CAAC;SAC9B;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAvDD,6BAuDC"}

package/out/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[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];

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gEAAuC;AACvC,kBAAe,qBAAU,CAAC;AAC1B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,gEAAuC;AACvC,kBAAe,qBAAU,CAAC;AAC1B,0CAAwB"}

package/out/types/compare.options.d.ts

@@ -1,6 +1,7 @@
-import { PdfToPngOptions, ExcludedPageArea } from '.';
+import { ExcludedPageArea, PdfToPngOptions } from '.';
 export declare type ComparePdfOptions = {
     diffsOutputFolder?: string;
     pdfToPngConvertOptions?: PdfToPngOptions;
-    excludedAreas: ExcludedPageArea[];
+    excludedAreas?: ExcludedPageArea[];
+    compareThreshold?: number;
 };

package/out/types/excluded.page.area.d.ts

@@ -1,4 +1,4 @@
-import { Area, Color } from ".";
+import { Area, Color } from '.';
 export declare type ExcludedPageArea = {
     pageNumber: number;
     excludedAreas?: Area[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pdf-visual-compare",
-  "version": "0.0.6",
-  "description": "Visual regression testing library for PDFs in Js/Ts",
+  "version": "1.0.0",
+  "description": "Visual regression testing library for PDFs in Js/Ts without binary and OS dependencies.",
   "keywords": [
     "pdf",
     "pdf regression",
@@ -28,7 +28,7 @@
     "clean": "rimraf ./out ./coverage ./test-results",
     "docker:build": "docker build --compress -t test-pdf-visual-compare .",
     "predocker:run": "npm run clean",
-    "docker:run": "docker run --rm -it -v $PWD/test-results:/usr/pkg/test-results test-pdf-visual-compare",
+    "docker:run": "docker run --rm -it -v ./test-results:/usr/pkg/test-results test-pdf-visual-compare",
     "docker:test": "jest",
     "license-checker": "npx license-checker --production --onlyAllow 'MIT; MIT OR X11; BSD; ISC; Apache-2.0; Unlicense'",
     "lint": "eslint .",
@@ -39,18 +39,18 @@
     "tsc": "tsc --pretty"
   },
   "dependencies": {
-    "pdf-to-png-converter": "0.1.1",
-    "png-visual-compare": "0.4.8"
+    "pdf-to-png-converter": "1.0.0",
+    "png-visual-compare": "0.4.12"
   },
   "devDependencies": {
-    "@types/jest": "27.4.0",
-    "@types/node": "17.0.8",
-    "@typescript-eslint/eslint-plugin": "5.9.0",
-    "@typescript-eslint/parser": "5.9.0",
-    "eslint": "8.6.0",
-    "jest": "27.4.7",
-    "ts-jest": "27.1.2",
-    "ts-node": "10.4.0",
-    "typescript": "4.5.4"
+    "@types/jest": "27.5.0",
+    "@types/node": "17.0.31",
+    "@typescript-eslint/eslint-plugin": "5.22.0",
+    "@typescript-eslint/parser": "5.22.0",
+    "eslint": "8.15.0",
+    "jest": "28.1.0",
+    "ts-jest": "28.0.1",
+    "ts-node": "10.7.0",
+    "typescript": "4.6.4"
   }
 }