@adnsistemas/pdf-lib 1.18.0 → 2.4.2

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@adnsistemas/pdf-lib",
-  "version": "1.18.0",
+  "version": "2.4.2",
   "description": "Create and modify PDF files with JavaScript",
   "author": "Andrew Dillon <andrew.dillon.j@gmail.com>",
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
+  "exports": {
+    ".": {
+      "types": "./cjs/index.d.ts",
+      "require": "./cjs/index.js",
+      "import": "./es/index.js"
+    }
+  },
   "contributors": [
     "jerp (https://github.com/jerp)",
     "Greg Bacchus (https://github.com/gregbacchus)",
@@ -30,36 +38,38 @@
     "Brent McSharry (https://github.com/mcshaz)",
     "Tim Knapp (https://github.com/duffyd)",
     "Ching Chang (https://github.com/ChingChang9)",
+    "François Billioud (https://github.com/Sharcoux)",
+    "Phakorn Kiong (https://github.com/PhakornKiong)",
+    "Donald Ness (https://github.com/programmarchy)",
     "Remus DRAICA (https://github.com/remdra)",
     "David Abdala (https://github.com/adnsistemas)"
   ],
   "scripts": {
-    "release:latest": "yarn publish --tag latest --access public && yarn pack && yarn release:tag",
-    "release:next": "yarn publish --tag next",
+    "release": "yarn release:prep && release-it",
     "release:prep": "yarn clean && yarn lint && yarn typecheck && yarn test && yarn build",
-    "release:tag": "TAG=\"v$(yarn --silent get:version)\" && git tag $TAG && git push origin $TAG",
     "get:version": "node --eval 'console.log(require(`./package.json`).version)'",
     "clean": "rimraf ts3.4 build cjs dist es scratchpad/build coverage tsBuildInfo.json apps/node-build apps/node/tsBuildInfo.json isolate*.log flamegraph.html out.pdf",
     "typecheck": "tsc --noEmit --incremental false --tsBuildInfoFile null",
-    "test": "jest --config jest.json --runInBand",
-    "testw": "jest --config jest.json --watch",
-    "testc": "jest --config jest.json --coverage && open coverage/index.html",
-    "lint": "yarn lint:prettier && yarn lint:tslint:src && yarn lint:tslint:tests",
-    "lint:tslint:src": "tslint --project tsconfig.json --fix",
-    "lint:tslint:tests": "tslint --project tests/tsconfig.json --fix",
-    "lint:prettier": "prettier --write \"./{src,tests,apps}/**/*.{ts,js,json,html,css}\" --loglevel error",
+    "test": "jest --config jest.config.js --runInBand",
+    "testw": "jest --config jest.config.js --watch",
+    "testc": "jest --config jest.config.js --coverage && open coverage/index.html",
+    "lint-staged": "lint-staged",
+    "lint": "yarn lint:prettier && yarn lint:eslint",
+    "lint:eslint": "eslint .",
+    "lint:prettier": "prettier --write \"./{src,tests,apps}/**/*.{ts,js,json,html,css}\" --log-level error",
     "build": "yarn build:cjs && yarn build:es && yarn build:esm && yarn build:esm:min && yarn build:umd && yarn build:umd:min && yarn build:downlevel-dts",
-    "build:cjs": "ttsc --module commonjs --outDir cjs",
-    "build:es": "ttsc --module ES2015 --outDir es",
-    "build:esm": "rollup --config rollup.config.js --file dist/pdf-lib.esm.js --environment MODULE_TYPE:es",
-    "build:esm:min": "rollup --config rollup.config.js --file dist/pdf-lib.esm.min.js --environment MINIFY,MODULE_TYPE:es",
-    "build:umd": "rollup --config rollup.config.js --file dist/pdf-lib.js --environment MODULE_TYPE:umd",
-    "build:umd:min": "rollup --config rollup.config.js --file dist/pdf-lib.min.js --environment MINIFY,MODULE_TYPE:umd",
+    "build:cjs": "tsc --module commonjs --outDir cjs",
+    "build:es": "tsc --module ES2015 --outDir es && node ./scripts/es-build.js",
+    "build:esm": "rollup --config rollup.config.mjs --file dist/pdf-lib.esm.js --environment MODULE_TYPE:es",
+    "build:esm:min": "rollup --config rollup.config.mjs --file dist/pdf-lib.esm.min.js --environment MINIFY,MODULE_TYPE:es",
+    "build:umd": "rollup --config rollup.config.mjs --file dist/pdf-lib.js --environment MODULE_TYPE:umd",
+    "build:umd:min": "rollup --config rollup.config.mjs --file dist/pdf-lib.min.js --environment MINIFY,MODULE_TYPE:umd",
     "build:downlevel-dts": "rimraf ts3.4 && yarn downlevel-dts . ts3.4 && rimraf ts3.4/scratchpad",
-    "scratchpad:start": "ttsc --build scratchpad/tsconfig.json --watch",
+    "build:test": "yarn build:es && yarn build:umd",
+    "scratchpad:start": "tsc --build scratchpad/tsconfig.json --watch",
     "scratchpad:run": "node scratchpad/build/scratchpad/index.js",
     "scratchpad:flame": "rimraf isolate*.log && node --prof scratchpad/build/scratchpad/index.js && node --prof-process --preprocess -j isolate*.log | flamebearer",
-    "apps:node": "ttsc --build apps/node/tsconfig.json && node apps/node-build/index.js",
+    "apps:node": "tsc --build apps/node/tsconfig.json && node apps/node-build/index.js",
     "apps:deno": "deno run --allow-read --allow-write --allow-run apps/deno/index.ts",
     "apps:web": "http-server -c-1 .",
     "apps:web:mac": "bash -c 'sleep 1 && open http://localhost:8080/apps/web/test1.html' & yarn apps:web",
@@ -92,32 +102,43 @@
   "dependencies": {
     "@pdf-lib/standard-fonts": "^1.0.0",
     "@pdf-lib/upng": "^1.0.1",
+    "color": "^4.2.3",
+    "crypto-js": "^4.2.0",
+    "node-html-better-parser": "^1.4.0",
     "pako": "^1.0.11",
-    "tslib": "^1.11.1"
+    "tslib": ">=2"
   },
   "devDependencies": {
+    "@eslint/js": "^8.56.0",
     "@pdf-lib/fontkit": "^1.1.0",
-    "@rollup/plugin-commonjs": "^13.0.0",
-    "@rollup/plugin-json": "^4.1.0",
-    "@rollup/plugin-node-resolve": "^8.0.1",
-    "@types/jest": "^26.0.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/color": "^3.0.1",
+    "@types/crypto-js": "^4.2.2",
+    "@types/jest": "^29.5.12",
     "@types/node-fetch": "^2.5.7",
     "@types/pako": "^1.0.1",
-    "@zerollup/ts-transform-paths": "^1.7.18",
-    "downlevel-dts": "^0.5.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "downlevel-dts": "^0.11.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
     "flamebearer": "^1.1.3",
-    "http-server": "^0.12.3",
-    "jest": "^26.0.1",
-    "node-fetch": "^2.6.0",
-    "prettier": "^2.0.5",
-    "rimraf": "^3.0.2",
-    "rollup": "^2.17.1",
-    "rollup-plugin-terser": "^6.1.0",
-    "ts-jest": "^26.1.0",
-    "tslint": "^6.1.2",
-    "tslint-config-prettier": "^1.18.0",
-    "ttypescript": "^1.5.15",
-    "typescript": "^3.9.5"
+    "globals": "^14.0.0",
+    "http-server": "^14.1.1",
+    "husky": "4",
+    "jest": "29.7.0",
+    "lint-staged": "^15.5.0",
+    "node-fetch": "^3.3.2",
+    "prettier": "^3.2.5",
+    "release-it": "^17.0.3",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.9.6",
+    "ts-jest": "^29.0",
+    "typescript": "^4.9.5"
   },
   "license": "MIT",
   "private": false,
@@ -140,5 +161,15 @@
     "javascript",
     "library"
   ],
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+  "lint-staged": {
+    "{src,tests,apps}/**/*.{ts,js,json,html,css}": [
+      "prettier --check",
+      "eslint --fix"
+    ]
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  }
 }

package/src/api/PDFDocument.ts

@@ -1,26 +1,35 @@
-import Embeddable from 'src/api/Embeddable';
+import {
+  parse as parseHtml,
+  HTMLElement,
+  NodeType,
+} from 'node-html-better-parser';
+import Embeddable from './Embeddable';
 import {
   EncryptedPDFError,
   FontkitNotRegisteredError,
   ForeignPageError,
   RemovePageFromEmptyDocumentError,
-} from 'src/api/errors';
-import PDFEmbeddedPage from 'src/api/PDFEmbeddedPage';
-import PDFFont from 'src/api/PDFFont';
-import PDFImage from 'src/api/PDFImage';
-import PDFPage from 'src/api/PDFPage';
-import PDFForm from 'src/api/form/PDFForm';
-import { PageSizes } from 'src/api/sizes';
-import { StandardFonts } from 'src/api/StandardFonts';
+} from './errors';
+import PDFEmbeddedPage from './PDFEmbeddedPage';
+import PDFFont from './PDFFont';
+import PDFImage from './PDFImage';
+import PDFPage from './PDFPage';
+import PDFForm from './form/PDFForm';
+import { PageSizes } from './sizes';
+import { StandardFonts } from './StandardFonts';
 import {
   CustomFontEmbedder,
   CustomFontSubsetEmbedder,
   JpegEmbedder,
   PageBoundingBox,
   PageEmbeddingMismatchedContextError,
+  PDFArray,
   PDFCatalog,
   PDFContext,
   PDFDict,
+  decodePDFRawStream,
+  PDFStream,
+  PDFRawStream,
   PDFHexString,
   PDFName,
   PDFObjectCopier,
@@ -34,7 +43,7 @@ import {
   PngEmbedder,
   StandardFontEmbedder,
   UnexpectedObjectTypeError,
-} from 'src/core';
+} from '../core';
 import {
   ParseSpeeds,
   AttachmentOptions,
@@ -67,8 +76,21 @@ import FileEmbedder, { AFRelationship } from 'src/core/embedders/FileEmbedder';
 import PDFEmbeddedFile from 'src/api/PDFEmbeddedFile';
 import PDFJavaScript from 'src/api/PDFJavaScript';
 import JavaScriptEmbedder from 'src/core/embedders/JavaScriptEmbedder';
+import { CipherTransformFactory } from '../core/crypto';
+import PDFSvg from './PDFSvg';
+import PDFSecurity, { SecurityOptions } from '../core/security/PDFSecurity';
 import { DocumentSnapshot, IncrementalDocumentSnapshot } from './snapshot';
 
+export type PDFAttachment = {
+  name: string;
+  data: Uint8Array;
+  mimeType: string | undefined;
+  afRelationship: AFRelationship | undefined;
+  description: string | undefined;
+  creationDate: Date | undefined;
+  modificationDate: Date | undefined;
+};
+
 /**
  * Represents a PDF document.
  */
@@ -133,8 +155,10 @@ export default class PDFDocument {
       ignoreEncryption = false,
       parseSpeed = ParseSpeeds.Slow,
       throwOnInvalidObject = false,
+      warnOnInvalidObjects = false,
       updateMetadata = true,
       capNumbers = false,
+      password,
       forIncrementalUpdate = false,
     } = options;
 
@@ -142,6 +166,8 @@ export default class PDFDocument {
     assertIs(ignoreEncryption, 'ignoreEncryption', ['boolean']);
     assertIs(parseSpeed, 'parseSpeed', ['number']);
     assertIs(throwOnInvalidObject, 'throwOnInvalidObject', ['boolean']);
+    assertIs(warnOnInvalidObjects, 'warnOnInvalidObjects', ['boolean']);
+    assertIs(password, 'password', ['string', 'undefined']);
     assertIs(forIncrementalUpdate, 'forIncrementalUpdate', ['boolean']);
 
     const bytes = toUint8Array(pdf);
@@ -149,12 +175,39 @@ export default class PDFDocument {
       bytes,
       parseSpeed,
       throwOnInvalidObject,
+      undefined,
       capNumbers,
+      undefined,
       forIncrementalUpdate,
     ).parseDocument();
-    const pdfDoc = new PDFDocument(context, ignoreEncryption, updateMetadata);
-    if (forIncrementalUpdate) pdfDoc.takeSnapshot();
-    return pdfDoc;
+    if (
+      !!context.lookup(context.trailerInfo.Encrypt) &&
+      password !== undefined
+    ) {
+      // Decrypt
+      const fileIds = context.lookup(context.trailerInfo.ID, PDFArray);
+      const encryptDict = context.lookup(context.trailerInfo.Encrypt, PDFDict);
+      const decryptedContext = await PDFParser.forBytesWithOptions(
+        bytes,
+        parseSpeed,
+        throwOnInvalidObject,
+        warnOnInvalidObjects,
+        capNumbers,
+        new CipherTransformFactory(
+          encryptDict,
+          (fileIds.get(0) as PDFHexString).asBytes(),
+          password,
+        ),
+        forIncrementalUpdate,
+      ).parseDocument();
+      const pdfDoc = new PDFDocument(decryptedContext, true, updateMetadata);
+      if (forIncrementalUpdate) pdfDoc.takeSnapshot();
+      return pdfDoc;
+    } else {
+      const pdfDoc = new PDFDocument(context, ignoreEncryption, updateMetadata);
+      if (forIncrementalUpdate) pdfDoc.takeSnapshot();
+      return pdfDoc;
+    }
   }
 
   /**
@@ -206,6 +259,11 @@ export default class PDFDocument {
 
     this.context = context;
     this.catalog = context.lookup(context.trailerInfo.Root) as PDFCatalog;
+
+    if (!!context.lookup(context.trailerInfo.Encrypt) && context.isDecrypted) {
+      // context.delete(context.trailerInfo.Encrypt);
+      delete context.trailerInfo.Encrypt;
+    }
     this.isEncrypted = !!context.lookup(context.trailerInfo.Encrypt);
 
     this.pageCache = Cache.populatedBy(this.computePages);
@@ -359,6 +417,22 @@ export default class PDFDocument {
     return producer.decodeText();
   }
 
+  /**
+   * Get this document's language metadata. The language appears in the
+   * "Document Properties" section of most PDF readers. For example:
+   * ```js
+   * const language = pdfDoc.getLanguage()
+   * ```
+   * @returns A string containing the RFC 3066 _Language-Tag_ of this document,
+   *          if it has one.
+   */
+  getLanguage(): string | undefined {
+    const language = this.catalog.get(PDFName.of('Lang'));
+    if (!language) return undefined;
+    assertIsLiteralOrHexString(language);
+    return language.decodeText();
+  }
+
   /**
    * Get this document's creation date metadata. The creation date appears in
    * the "Document Properties" section of most PDF readers. For example:
@@ -732,14 +806,14 @@ export default class PDFDocument {
     await srcDoc.flush();
     const copier = PDFObjectCopier.for(srcDoc.context, this.context);
     const srcPages = srcDoc.getPages();
-    const copiedPages: PDFPage[] = new Array(indices.length);
-    for (let idx = 0, len = indices.length; idx < len; idx++) {
-      const srcPage = srcPages[indices[idx]];
-      const copiedPage = copier.copy(srcPage.node);
-      const ref = this.context.register(copiedPage);
-      copiedPages[idx] = PDFPage.of(copiedPage, ref, this);
-    }
-    return copiedPages;
+    // Copy each page in a separate thread
+    const copiedPages = indices
+      .map((i) => srcPages[i])
+      .map(async (page) => copier.copy(page.node))
+      .map((p) =>
+        p.then((copy) => PDFPage.of(copy, this.context.register(copy), this)),
+      );
+    return Promise.all(copiedPages);
   }
 
   /**
@@ -773,6 +847,9 @@ export default class PDFDocument {
     if (this.getCreator() !== undefined) {
       pdfCopy.setCreator(this.getCreator()!);
     }
+    if (this.getLanguage() !== undefined) {
+      pdfCopy.setLanguage(this.getLanguage()!);
+    }
     if (this.getModificationDate() !== undefined) {
       pdfCopy.setModificationDate(this.getModificationDate()!);
     }
@@ -907,6 +984,121 @@ export default class PDFDocument {
     this.embeddedFiles.push(embeddedFile);
   }
 
+  private getRawAttachments() {
+    if (!this.catalog.has(PDFName.of('Names'))) return [];
+    const Names = this.catalog.lookup(PDFName.of('Names'), PDFDict);
+
+    if (!Names.has(PDFName.of('EmbeddedFiles'))) return [];
+    const EmbeddedFiles = Names.lookup(PDFName.of('EmbeddedFiles'), PDFDict);
+
+    if (!EmbeddedFiles.has(PDFName.of('Names'))) return [];
+    const EFNames = EmbeddedFiles.lookup(PDFName.of('Names'), PDFArray);
+
+    const rawAttachments = [];
+    for (let idx = 0, len = EFNames.size(); idx < len; idx += 2) {
+      const fileName = EFNames.lookup(idx) as PDFHexString | PDFString;
+      const fileSpec = EFNames.lookup(idx + 1, PDFDict);
+      rawAttachments.push({ fileName, fileSpec });
+    }
+
+    return rawAttachments;
+  }
+
+  private getSavedAttachments(): PDFAttachment[] {
+    const rawAttachments = this.getRawAttachments();
+    return rawAttachments.flatMap(({ fileName, fileSpec }) => {
+      const efDict = fileSpec.lookup(PDFName.of('EF'));
+      if (!(efDict instanceof PDFDict)) return [];
+
+      const stream = efDict.lookup(PDFName.of('F'));
+      if (!(stream instanceof PDFStream)) return [];
+
+      const afr = fileSpec.lookup(PDFName.of('AFRelationship'));
+      const afRelationship =
+        afr instanceof PDFName
+          ? afr.toString().slice(1) // Remove leading slash
+          : afr instanceof PDFString
+            ? afr.decodeText()
+            : undefined;
+
+      const embeddedFileDict = stream.dict;
+      const subtype = embeddedFileDict.lookup(PDFName.of('Subtype'));
+
+      const mimeType =
+        subtype instanceof PDFName
+          ? subtype.toString().slice(1)
+          : subtype instanceof PDFString
+            ? subtype.decodeText()
+            : undefined;
+
+      const paramsDict = embeddedFileDict.lookup(PDFName.of('Params'), PDFDict);
+
+      let creationDate: Date | undefined;
+      let modificationDate: Date | undefined;
+
+      if (paramsDict instanceof PDFDict) {
+        const creationDateRaw = paramsDict.lookup(PDFName.of('CreationDate'));
+        const modDateRaw = paramsDict.lookup(PDFName.of('ModDate'));
+
+        if (creationDateRaw instanceof PDFString) {
+          creationDate = creationDateRaw.decodeDate();
+        }
+
+        if (modDateRaw instanceof PDFString) {
+          modificationDate = modDateRaw.decodeDate();
+        }
+      }
+
+      const description = (
+        fileSpec.lookup(PDFName.of('Desc')) as PDFHexString
+      ).decodeText();
+
+      return [
+        {
+          name: fileName.decodeText(),
+          data: decodePDFRawStream(stream as PDFRawStream).decode(),
+          mimeType: mimeType?.replace(/#([0-9A-Fa-f]{2})/g, (_, hex) =>
+            String.fromCharCode(parseInt(hex, 16)),
+          ),
+          afRelationship: afRelationship as AFRelationship,
+          description,
+          creationDate,
+          modificationDate,
+        },
+      ];
+    });
+  }
+
+  private getUnsavedAttachments(): PDFAttachment[] {
+    const attachments = this.embeddedFiles.map((file) => {
+      const embedder = file.getEmbedder();
+
+      return {
+        name: embedder.fileName,
+        data: embedder.getFileData(),
+        description: embedder.options.description,
+        mimeType: embedder.options.mimeType,
+        afRelationship: embedder.options.afRelationship,
+        creationDate: embedder.options.creationDate,
+        modificationDate: embedder.options.modificationDate,
+      };
+    });
+
+    return attachments;
+  }
+
+  /**
+   * Get all attachments that are embedded in this document.
+   *
+   * @returns Array of attachments with name and data
+   */
+  getAttachments(): PDFAttachment[] {
+    const savedAttachments = this.getSavedAttachments();
+    const unsavedAttachments = this.getUnsavedAttachments();
+
+    return [...savedAttachments, ...unsavedAttachments];
+  }
+
   /**
    * Embed a font into this document. The input data can be provided in multiple
    * formats:
@@ -1084,6 +1276,36 @@ export default class PDFDocument {
     return pdfImage;
   }
 
+  async embedSvg(svg: string): Promise<PDFSvg> {
+    if (!svg) return new PDFSvg(svg);
+    const parsedSvg = parseHtml(svg);
+    const findImages = (element: HTMLElement): HTMLElement[] => {
+      if (element.tagName === 'image') return [element];
+      else {
+        return element.childNodes
+          .map((child) =>
+            child.nodeType === NodeType.ELEMENT_NODE ? findImages(child) : [],
+          )
+          .flat();
+      }
+    };
+    const images = findImages(parsedSvg);
+    const imagesDict = {} as Record<string, PDFImage>;
+
+    await Promise.all(
+      images.map(async (image) => {
+        const href = image.attributes.href ?? image.attributes['xlink:href'];
+        if (!href || imagesDict[href]) return;
+        const isPng = href.match(/\.png(\?|$)|^data:image\/png;base64/gim);
+        const pdfImage = isPng
+          ? await this.embedPng(href)
+          : await this.embedJpg(href);
+        imagesDict[href] = pdfImage;
+      }),
+    );
+
+    return new PDFSvg(svg, imagesDict);
+  }
   /**
    * Embed one or more PDF pages into this document.
    *
@@ -1237,6 +1459,10 @@ export default class PDFDocument {
     return embeddedPages;
   }
 
+  encrypt(options: SecurityOptions) {
+    this.context.security = PDFSecurity.create(this.context, options).encrypt();
+  }
+
   /**
    * > **NOTE:** You shouldn't need to call this method directly. The [[save]]
    * > and [[saveAsBase64]] methods will automatically ensure that all embedded
@@ -1432,7 +1658,7 @@ export default class PDFDocument {
   }
 
   private updateInfoDict(): void {
-    const pdfLib = `pdf-lib (https://github.com/Hopding/pdf-lib)`;
+    const pdfLib = 'pdf-lib (https://github.com/Hopding/pdf-lib)';
     const now = new Date();
 
     const info = this.getInfoDict();

package/src/api/PDFDocumentOptions.ts

@@ -1,5 +1,5 @@
-import { EmbeddedFileOptions } from 'src/core/embedders/FileEmbedder';
-import { TypeFeatures } from 'src/types/fontkit';
+import { EmbeddedFileOptions } from '../core/embedders/FileEmbedder';
+import { TypeFeatures } from '../types/fontkit';
 
 export enum ParseSpeeds {
   Fastest = Infinity,
@@ -30,8 +30,10 @@ export interface LoadOptions {
   ignoreEncryption?: boolean;
   parseSpeed?: ParseSpeeds | number;
   throwOnInvalidObject?: boolean;
+  warnOnInvalidObjects?: boolean;
   updateMetadata?: boolean;
   capNumbers?: boolean;
+  password?: string;
   forIncrementalUpdate?: boolean;
 }
 

package/src/api/PDFEmbeddedFile.ts

@@ -1,7 +1,7 @@
-import Embeddable from 'src/api/Embeddable';
-import PDFDocument from 'src/api/PDFDocument';
-import FileEmbedder from 'src/core/embedders/FileEmbedder';
-import { PDFName, PDFArray, PDFDict, PDFHexString, PDFRef } from 'src/core';
+import Embeddable from './Embeddable';
+import PDFDocument from './PDFDocument';
+import FileEmbedder from '../core/embedders/FileEmbedder';
+import { PDFName, PDFArray, PDFDict, PDFHexString, PDFRef } from '../core';
 
 /**
  * Represents a file that has been embedded in a [[PDFDocument]].
@@ -87,4 +87,12 @@ export default class PDFEmbeddedFile implements Embeddable {
       this.alreadyEmbedded = true;
     }
   }
+
+  /**
+   * Get the embedder used to embed the file.
+   * @returns the embedder.
+   */
+  getEmbedder() {
+    return this.embedder;
+  }
 }

package/src/api/PDFEmbeddedPage.ts

@@ -1,7 +1,7 @@
-import Embeddable from 'src/api/Embeddable';
-import PDFDocument from 'src/api/PDFDocument';
-import { PDFPageEmbedder, PDFRef } from 'src/core';
-import { assertIs } from 'src/utils';
+import Embeddable from './Embeddable';
+import PDFDocument from './PDFDocument';
+import { PDFPageEmbedder, PDFRef } from '../core';
+import { assertIs } from '../utils';
 
 /**
  * Represents a PDF page that has been embedded in a [[PDFDocument]].

package/src/api/PDFFont.ts

@@ -1,12 +1,12 @@
-import Embeddable from 'src/api//Embeddable';
-import PDFDocument from 'src/api/PDFDocument';
+import Embeddable from './Embeddable';
+import PDFDocument from './PDFDocument';
 import {
   CustomFontEmbedder,
   PDFHexString,
   PDFRef,
   StandardFontEmbedder,
-} from 'src/core';
-import { assertIs, assertOrUndefined } from 'src/utils';
+} from '../core';
+import { assertIs, assertOrUndefined } from '../utils';
 
 export type FontEmbedder = CustomFontEmbedder | StandardFontEmbedder;
 

package/src/api/PDFImage.ts

@@ -1,7 +1,7 @@
-import Embeddable from 'src/api/Embeddable';
-import PDFDocument from 'src/api/PDFDocument';
-import { JpegEmbedder, PDFRef, PngEmbedder } from 'src/core';
-import { assertIs } from 'src/utils';
+import Embeddable from './Embeddable';
+import PDFDocument from './PDFDocument';
+import { JpegEmbedder, PDFRef, PngEmbedder } from '../core';
+import { assertIs } from '../utils';
 
 export type ImageEmbedder = JpegEmbedder | PngEmbedder;
 

package/src/api/PDFJavaScript.ts

@@ -1,7 +1,7 @@
-import Embeddable from 'src/api/Embeddable';
-import PDFDocument from 'src/api/PDFDocument';
-import JavaScriptEmbedder from 'src/core/embedders/JavaScriptEmbedder';
-import { PDFName, PDFArray, PDFDict, PDFHexString, PDFRef } from 'src/core';
+import Embeddable from './Embeddable';
+import PDFDocument from './PDFDocument';
+import JavaScriptEmbedder from '../core/embedders/JavaScriptEmbedder';
+import { PDFName, PDFArray, PDFDict, PDFHexString, PDFRef } from '../core';
 
 /**
  * Represents JavaScript that has been embedded in a [[PDFDocument]].