@adnsistemas/pdf-lib 2.7.3 → 2.8.0

package/es/core/structures/PDFCatalog.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adnsistemas/pdf-lib",
-  "version": "2.7.3",
+  "version": "2.8.0",
   "description": "Create and modify PDF files with JavaScript",
   "author": "Andrew Dillon <andrew.dillon.j@gmail.com>",
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
@@ -43,7 +43,9 @@
     "Donald Ness (https://github.com/programmarchy)",
     "Remus DRAICA (https://github.com/remdra)",
     "David Abdala (https://github.com/adnsistemas)",
-    "Eran Ohayon (https://github.com/erano067)"
+    "Eran Ohayon (https://github.com/erano067)",
+    "Shaun Verch (https://github.com/sverch)",
+    "Guido Flohr (https://github.com/gflohr)"
   ],
   "scripts": {
     "release": "yarn release:prep && release-it",

package/src/api/PDFDocument.ts

@@ -82,7 +82,7 @@ import PDFSecurity, { SecurityOptions } from '../core/security/PDFSecurity';
 import { IncrementalDocumentSnapshot } from './snapshot';
 import type { DocumentSnapshot } from './snapshot';
 
-export type PDFAttachment = {
+export type BasePDFAttachment = {
   name: string;
   data: Uint8Array;
   mimeType: string | undefined;
@@ -92,6 +92,17 @@ export type PDFAttachment = {
   modificationDate: Date | undefined;
 };
 
+export type SavedPDFAttachment = BasePDFAttachment & {
+  embeddedFileDict: PDFDict;
+  specRef: PDFRef;
+};
+
+export type UnsavedPDFAttachment = BasePDFAttachment & {
+  pdfEmbeddedFile: PDFEmbeddedFile;
+};
+
+export type PDFAttachment = UnsavedPDFAttachment | SavedPDFAttachment;
+
 export type PDFObjectVersions = {
   ref: PDFRef;
   actual: PDFObject | undefined;
@@ -1011,15 +1022,19 @@ export default class PDFDocument {
     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 });
+      rawAttachments.push({
+        fileName,
+        fileSpec,
+        specRef: EFNames.get(idx + 1) as PDFRef,
+      });
     }
 
     return rawAttachments;
   }
 
-  private getSavedAttachments(): PDFAttachment[] {
+  private getSavedAttachments(): SavedPDFAttachment[] {
     const rawAttachments = this.getRawAttachments();
-    return rawAttachments.flatMap(({ fileName, fileSpec }) => {
+    return rawAttachments.flatMap(({ fileName, fileSpec, specRef }) => {
       const efDict = fileSpec.lookup(PDFName.of('EF'));
       if (!(efDict instanceof PDFDict)) return [];
 
@@ -1062,9 +1077,12 @@ export default class PDFDocument {
         }
       }
 
-      const description = (
-        fileSpec.lookup(PDFName.of('Desc')) as PDFHexString
-      ).decodeText();
+      const descRaw = fileSpec.lookup(PDFName.of('Desc'));
+      let description: string | undefined;
+
+      if (descRaw instanceof PDFHexString) {
+        description = descRaw.decodeText();
+      }
 
       return [
         {
@@ -1077,13 +1095,16 @@ export default class PDFDocument {
           description,
           creationDate,
           modificationDate,
+          embeddedFileDict: efDict,
+          specRef,
         },
       ];
     });
   }
 
-  private getUnsavedAttachments(): PDFAttachment[] {
-    const attachments = this.embeddedFiles.map((file) => {
+  private getUnsavedAttachments(): UnsavedPDFAttachment[] {
+    const attachments = this.embeddedFiles.flatMap((file) => {
+      if (file.getAlreadyEmbedded()) return [];
       const embedder = file.getEmbedder();
 
       return {
@@ -1094,6 +1115,7 @@ export default class PDFDocument {
         afRelationship: embedder.options.afRelationship,
         creationDate: embedder.options.creationDate,
         modificationDate: embedder.options.modificationDate,
+        pdfEmbeddedFile: file,
       };
     });
 
@@ -1112,6 +1134,49 @@ export default class PDFDocument {
     return [...savedAttachments, ...unsavedAttachments];
   }
 
+  /**
+   * Removes an attachment from PDF, based on name.
+   * @param {string} name Name of the attachmet to remove.
+   */
+  detach(name: string) {
+    const attachedFiles = this.getAttachments();
+    attachedFiles.forEach((file) => {
+      if (file.name !== name) return;
+      // the file wasn't embedded into context yet
+      if ('pdfEmbeddedFile' in file) {
+        const i = this.embeddedFiles.findIndex(
+          (f) => file.pdfEmbeddedFile === f,
+        );
+        if (i !== undefined) this.embeddedFiles.splice(i, 1);
+      } else {
+        // remove references from catalog
+        const namesArr = this.catalog
+          .Names()
+          ?.lookup(PDFName.of('EmbeddedFiles'), PDFDict)
+          .lookup(PDFName.of('Names'), PDFArray);
+        const iNames = namesArr?.indexOf(file.specRef);
+        if (iNames !== undefined && iNames > 0) {
+          // attachment spec ref
+          namesArr?.remove(iNames);
+          // attachment name
+          namesArr?.remove(iNames - 1);
+        }
+        // AF-Tag for PDF-A3 compliance
+        const AF = this.catalog.AttachedFiles();
+        const afIndex = AF?.indexOf(file.specRef);
+        if (afIndex !== undefined) AF?.remove(afIndex);
+
+        // remove references from context
+        const streamRef = this.context
+          .lookupMaybe(file.specRef, PDFDict)
+          ?.lookupMaybe(PDFName.of('EF'), PDFDict)
+          ?.get(PDFName.of('F')) as PDFRef | undefined;
+        if (streamRef) this.context.delete(streamRef);
+        this.context.delete(file.specRef);
+      }
+    });
+  }
+
   /**
    * Embed a font into this document. The input data can be provided in multiple
    * formats:

package/src/api/PDFEmbeddedFile.ts

@@ -95,4 +95,16 @@ export default class PDFEmbeddedFile implements Embeddable {
   getEmbedder() {
     return this.embedder;
   }
+
+  /**
+   * Returns whether or not this file has already been embedded.
+   * @returns true if the file has already been embedded, false otherwise.
+   */
+  getAlreadyEmbedded() {
+    return this.alreadyEmbedded;
+  }
+
+  getRef() {
+    return this.ref;
+  }
 }

package/src/api/PDFPage.ts

@@ -1275,7 +1275,7 @@ export default class PDFPage {
         rotate: options.rotate ?? degrees(0),
         color: options.color ?? undefined,
         borderColor: options.borderColor ?? undefined,
-        borderWidth: options.borderWidth ?? 0,
+        borderWidth: options.borderWidth ?? 1,
         borderDashArray: options.borderDashArray ?? undefined,
         borderDashPhase: options.borderDashPhase ?? undefined,
         borderLineCap: options.borderLineCap ?? undefined,

package/src/api/operations.ts

@@ -845,11 +845,11 @@ const getDrawingOperator = ({
   borderColor?: Color;
   fillRule?: FillRule;
 }) => {
-  if (color && borderColor && borderWidth) {
+  if (color && borderColor && borderWidth !== 0) {
     return fillAndStroke;
   } else if (color) {
     return fillRule === FillRule.EvenOdd ? fillEvenOdd : fill;
-  } else if (borderColor && borderWidth) {
+  } else if (borderColor && borderWidth !== 0) {
     return stroke;
   }
   return undefined;

package/src/core/embedders/JpegEmbedder.ts

@@ -29,7 +29,11 @@ const ChannelToColorSpace: { [idx: number]: ColorSpace | undefined } = {
  */
 class JpegEmbedder {
   static async for(imageData: Uint8Array) {
-    const dataView = new DataView(imageData.buffer);
+    const dataView = new DataView(
+      imageData.buffer,
+      imageData.byteOffset,
+      imageData.byteLength,
+    );
 
     const soi = dataView.getUint16(0);
     if (soi !== 0xffd8) throw new Error('SOI not found in JPEG');

package/src/core/structures/PDFCatalog.ts

@@ -5,6 +5,7 @@ import PDFContext from '../PDFContext';
 import PDFPageTree from './PDFPageTree';
 import { PDFAcroForm } from '../acroform';
 import ViewerPreferences from '../interactive/ViewerPreferences';
+import PDFArray from '../objects/PDFArray';
 
 class PDFCatalog extends PDFDict {
   static withContextAndPages = (
@@ -28,6 +29,14 @@ class PDFCatalog extends PDFDict {
     return this.lookupMaybe(PDFName.of('AcroForm'), PDFDict);
   }
 
+  Names(): PDFDict | undefined {
+    return this.lookupMaybe(PDFName.of('Names'), PDFDict);
+  }
+
+  AttachedFiles(): PDFArray | undefined {
+    return this.lookupMaybe(PDFName.of('AF'), PDFArray);
+  }
+
   getAcroForm(): PDFAcroForm | undefined {
     const dict = this.AcroForm();
     if (!dict) return undefined;

package/ts3.4/cjs/api/PDFDocument.d.ts

@@ -4,17 +4,18 @@ import PDFImage from './PDFImage';
 import PDFPage from './PDFPage';
 import PDFForm from './form/PDFForm';
 import { StandardFonts } from './StandardFonts';
-import { PageBoundingBox, PDFCatalog, PDFContext } from '../core';
+import { PageBoundingBox, PDFCatalog, PDFContext, PDFDict } from '../core';
 import { AttachmentOptions, SaveOptions, Base64SaveOptions, LoadOptions, CreateOptions, EmbedFontOptions, SetTitleOptions, IncrementalSaveOptions } from './PDFDocumentOptions';
 import PDFObject from '../core/objects/PDFObject';
 import PDFRef from '../core/objects/PDFRef';
 import { Fontkit } from '../types/fontkit';
 import { TransformationMatrix } from '../types/matrix';
 import { AFRelationship } from '../core/embedders/FileEmbedder';
+import PDFEmbeddedFile from './PDFEmbeddedFile';
 import PDFSvg from './PDFSvg';
 import { SecurityOptions } from '../core/security/PDFSecurity';
 import { DocumentSnapshot } from './snapshot';
-export type PDFAttachment = {
+export type BasePDFAttachment = {
     name: string;
     data: Uint8Array;
     mimeType: string | undefined;
@@ -23,6 +24,14 @@ export type PDFAttachment = {
     creationDate: Date | undefined;
     modificationDate: Date | undefined;
 };
+export type SavedPDFAttachment = BasePDFAttachment & {
+    embeddedFileDict: PDFDict;
+    specRef: PDFRef;
+};
+export type UnsavedPDFAttachment = BasePDFAttachment & {
+    pdfEmbeddedFile: PDFEmbeddedFile;
+};
+export type PDFAttachment = UnsavedPDFAttachment | SavedPDFAttachment;
 export type PDFObjectVersions = {
     ref: PDFRef;
     actual: PDFObject | undefined;
@@ -575,6 +584,11 @@ export default class PDFDocument {
      * @returns Array of attachments with name and data
      */
     getAttachments(): PDFAttachment[];
+    /**
+     * Removes an attachment from PDF, based on name.
+     * @param {string} name Name of the attachmet to remove.
+     */
+    detach(name: string): void;
     /**
      * Embed a font into this document. The input data can be provided in multiple
      * formats:

package/ts3.4/cjs/api/PDFEmbeddedFile.d.ts

@@ -40,5 +40,11 @@ export default class PDFEmbeddedFile implements Embeddable {
      * @returns the embedder.
      */
     getEmbedder(): FileEmbedder;
+    /**
+     * Returns whether or not this file has already been embedded.
+     * @returns true if the file has already been embedded, false otherwise.
+     */
+    getAlreadyEmbedded(): boolean;
+    getRef(): PDFRef;
 }
 //# sourceMappingURL=PDFEmbeddedFile.d.ts.map

package/ts3.4/cjs/core/structures/PDFCatalog.d.ts

@@ -4,11 +4,14 @@ import PDFContext from '../PDFContext';
 import PDFPageTree from './PDFPageTree';
 import { PDFAcroForm } from '../acroform';
 import ViewerPreferences from '../interactive/ViewerPreferences';
+import PDFArray from '../objects/PDFArray';
 declare class PDFCatalog extends PDFDict {
     static withContextAndPages: (context: PDFContext, pages: PDFPageTree | PDFRef) => PDFCatalog;
     static fromMapWithContext: (map: DictMap, context: PDFContext) => PDFCatalog;
     Pages(): PDFPageTree;
     AcroForm(): PDFDict | undefined;
+    Names(): PDFDict | undefined;
+    AttachedFiles(): PDFArray | undefined;
     getAcroForm(): PDFAcroForm | undefined;
     getOrCreateAcroForm(): PDFAcroForm;
     ViewerPreferences(): PDFDict | undefined;

package/ts3.4/es/api/PDFDocument.d.ts

@@ -4,17 +4,18 @@ import PDFImage from './PDFImage';
 import PDFPage from './PDFPage';
 import PDFForm from './form/PDFForm';
 import { StandardFonts } from './StandardFonts';
-import { PageBoundingBox, PDFCatalog, PDFContext } from '../core';
+import { PageBoundingBox, PDFCatalog, PDFContext, PDFDict } from '../core';
 import { AttachmentOptions, SaveOptions, Base64SaveOptions, LoadOptions, CreateOptions, EmbedFontOptions, SetTitleOptions, IncrementalSaveOptions } from './PDFDocumentOptions';
 import PDFObject from '../core/objects/PDFObject';
 import PDFRef from '../core/objects/PDFRef';
 import { Fontkit } from '../types/fontkit';
 import { TransformationMatrix } from '../types/matrix';
 import { AFRelationship } from '../core/embedders/FileEmbedder';
+import PDFEmbeddedFile from './PDFEmbeddedFile';
 import PDFSvg from './PDFSvg';
 import { SecurityOptions } from '../core/security/PDFSecurity';
 import { DocumentSnapshot } from './snapshot';
-export type PDFAttachment = {
+export type BasePDFAttachment = {
     name: string;
     data: Uint8Array;
     mimeType: string | undefined;
@@ -23,6 +24,14 @@ export type PDFAttachment = {
     creationDate: Date | undefined;
     modificationDate: Date | undefined;
 };
+export type SavedPDFAttachment = BasePDFAttachment & {
+    embeddedFileDict: PDFDict;
+    specRef: PDFRef;
+};
+export type UnsavedPDFAttachment = BasePDFAttachment & {
+    pdfEmbeddedFile: PDFEmbeddedFile;
+};
+export type PDFAttachment = UnsavedPDFAttachment | SavedPDFAttachment;
 export type PDFObjectVersions = {
     ref: PDFRef;
     actual: PDFObject | undefined;
@@ -575,6 +584,11 @@ export default class PDFDocument {
      * @returns Array of attachments with name and data
      */
     getAttachments(): PDFAttachment[];
+    /**
+     * Removes an attachment from PDF, based on name.
+     * @param {string} name Name of the attachmet to remove.
+     */
+    detach(name: string): void;
     /**
      * Embed a font into this document. The input data can be provided in multiple
      * formats:

package/ts3.4/es/api/PDFEmbeddedFile.d.ts

@@ -40,5 +40,11 @@ export default class PDFEmbeddedFile implements Embeddable {
      * @returns the embedder.
      */
     getEmbedder(): FileEmbedder;
+    /**
+     * Returns whether or not this file has already been embedded.
+     * @returns true if the file has already been embedded, false otherwise.
+     */
+    getAlreadyEmbedded(): boolean;
+    getRef(): PDFRef;
 }
 //# sourceMappingURL=PDFEmbeddedFile.d.ts.map

package/ts3.4/es/core/structures/PDFCatalog.d.ts

@@ -4,11 +4,14 @@ import PDFContext from '../PDFContext';
 import PDFPageTree from './PDFPageTree';
 import { PDFAcroForm } from '../acroform';
 import ViewerPreferences from '../interactive/ViewerPreferences';
+import PDFArray from '../objects/PDFArray';
 declare class PDFCatalog extends PDFDict {
     static withContextAndPages: (context: PDFContext, pages: PDFPageTree | PDFRef) => PDFCatalog;
     static fromMapWithContext: (map: DictMap, context: PDFContext) => PDFCatalog;
     Pages(): PDFPageTree;
     AcroForm(): PDFDict | undefined;
+    Names(): PDFDict | undefined;
+    AttachedFiles(): PDFArray | undefined;
     getAcroForm(): PDFAcroForm | undefined;
     getOrCreateAcroForm(): PDFAcroForm;
     ViewerPreferences(): PDFDict | undefined;