@adnsistemas/pdf-lib 2.6.3 → 2.7.0

package/es/core/objects/PDFRawStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PDFRawStream.d.ts","sourceRoot":"","sources":["../../../src/core/objects/PDFRawStream.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,WAAW,CAAC;AAChC,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,UAAU,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,cAAM,YAAa,SAAQ,SAAS;IAClC,MAAM,CAAC,EAAE,SACD,OAAO,YACH,UAAU,cACR,eAAe,kBACoB;IAEjD,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IAErC,OAAO;IAUP,YAAY,IAAI,UAAU;IAI1B,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,YAAY;IAIzC,iBAAiB,IAAI,MAAM;IAI3B,WAAW,IAAI,UAAU;IAIzB,eAAe,IAAI,MAAM;IAIzB,cAAc,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAG3C;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"PDFRawStream.d.ts","sourceRoot":"","sources":["../../../src/core/objects/PDFRawStream.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,WAAW,CAAC;AAChC,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,UAAU,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,cAAM,YAAa,SAAQ,SAAS;IAClC,MAAM,CAAC,EAAE,SACD,OAAO,YACH,UAAU,cACR,eAAe,kBACoB;IAEjD,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IAErC,OAAO;IAUP,YAAY,IAAI,UAAU;IAI1B,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,YAAY;IAIzC,iBAAiB,IAAI,MAAM;IAI3B,WAAW,IAAI,UAAU;IAIzB,eAAe,IAAI,MAAM;IAIzB,cAAc,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAI3C;AAED,eAAe,YAAY,CAAC"}

package/es/core/objects/PDFRawStream.js

@@ -22,6 +22,7 @@ class PDFRawStream extends PDFStream {
         return this.contents.length;
     }
     updateContents(contents) {
+        this.dict.registerChange();
         this.contents = contents;
     }
 }

package/es/core/objects/PDFRawStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"PDFRawStream.js","sourceRoot":"","sources":["../../../src/core/objects/PDFRawStream.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,YAAa,SAAQ,SAAS;IAUlC,YACE,IAAa,EACb,QAAoB,EACpB,SAA2B;QAE3B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAoB;QACxB,OAAO,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,iBAAiB;QACf,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,QAAoB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;;AAzCM,eAAE,GAAG,CACV,IAAa,EACb,QAAoB,EACpB,SAA2B,EAC3B,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAwCnD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"PDFRawStream.js","sourceRoot":"","sources":["../../../src/core/objects/PDFRawStream.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,YAAa,SAAQ,SAAS;IAUlC,YACE,IAAa,EACb,QAAoB,EACpB,SAA2B;QAE3B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAoB;QACxB,OAAO,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,iBAAiB;QACf,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,QAAoB;QACjC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;;AA1CM,eAAE,GAAG,CACV,IAAa,EACb,QAAoB,EACpB,SAA2B,EAC3B,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAyCnD,eAAe,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adnsistemas/pdf-lib",
-  "version": "2.6.3",
+  "version": "2.7.0",
   "description": "Create and modify PDF files with JavaScript",
   "author": "Andrew Dillon <andrew.dillon.j@gmail.com>",
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
@@ -42,7 +42,8 @@
     "Phakorn Kiong (https://github.com/PhakornKiong)",
     "Donald Ness (https://github.com/programmarchy)",
     "Remus DRAICA (https://github.com/remdra)",
-    "David Abdala (https://github.com/adnsistemas)"
+    "David Abdala (https://github.com/adnsistemas)",
+    "Eran Ohayon (https://github.com/erano067)"
   ],
   "scripts": {
     "release": "yarn release:prep && release-it",

package/src/api/PDFDocument.ts

@@ -1511,8 +1511,12 @@ export default class PDFDocument {
    * @returns Resolves with the bytes of the serialized document.
    */
   async save(options: SaveOptions = {}): Promise<Uint8Array> {
+    // check PDF version
+    const vparts = this.context.header.getVersionString().split('.');
+    const uOS =
+      options.rewrite || Number(vparts[0]) > 1 || Number(vparts[1]) >= 5;
     const {
-      useObjectStreams = true,
+      useObjectStreams = uOS,
       objectsPerTick = 50,
       rewrite = false,
     } = options;
@@ -1573,20 +1577,22 @@ export default class PDFDocument {
     snapshot: DocumentSnapshot,
     options: IncrementalSaveOptions = {},
   ): Promise<Uint8Array> {
+    // check PDF version
+    const vparts = this.context.header.getVersionString().split('.');
+    const uOS = Number(vparts[0]) > 1 || Number(vparts[1]) >= 5;
     const { objectsPerTick = 50 } = options;
 
     assertIs(objectsPerTick, 'objectsPerTick', ['number']);
 
     const saveOptions: SaveOptions = {
+      useObjectStreams: uOS,
       ...options,
       addDefaultPage: false,
       updateFieldAppearances: false,
     };
     await this.prepareForSave(saveOptions);
 
-    const Writer = this.context.pdfFileDetails.useObjectStreams
-      ? PDFStreamWriter
-      : PDFWriter;
+    const Writer = saveOptions.useObjectStreams ? PDFStreamWriter : PDFWriter;
     return Writer.forContextWithSnapshot(
       this.context,
       objectsPerTick,
@@ -1691,6 +1697,66 @@ export default class PDFDocument {
       .filter((ov) => ov.actual || ov.previous.length);
   }
 
+  /**
+   * Saves the current changes to the document as an incremental update, returns the full document,
+   * like save method, and modifies the internal state to be able to continue editing the document
+   * for another incremental update.
+   * This allows you to save multiple incremental updates without reloading the PDF.
+   *
+   * For example:
+   * ```js
+   * const pdfDoc = await PDFDocument.load(pdfBytes, { forIncrementalUpdate: true })
+   *
+   * const page = pdfDoc.getPage(0)
+   * page.drawText('First update')
+   * const firstsave = await pdfDoc.saveAndContinue()
+   *
+   * page.drawText('Second update', { y: 100 })
+   * const secondsave = await pdfDoc.saveAndContinue()
+   * ```
+   *
+   * @param options The options to be used when saving changes.
+   * @returns Resolves with the complete PDF bytes including all updates.
+   */
+  async saveAndContinue(
+    options: IncrementalSaveOptions = {},
+  ): Promise<Uint8Array> {
+    if (!this.context.pdfFileDetails.originalBytes || !this.context.snapshot) {
+      throw new Error(
+        'saveAndContinue() requires the document to be loaded with forIncrementalUpdate: true',
+      );
+    }
+    const originalBytes = this.context.pdfFileDetails.originalBytes;
+    const incrementalBytes = await this.saveIncremental(
+      this.context.snapshot,
+      options,
+    );
+
+    const newPdfBytes = new Uint8Array(
+      originalBytes.byteLength + incrementalBytes.byteLength,
+    );
+    newPdfBytes.set(originalBytes);
+    newPdfBytes.set(incrementalBytes, originalBytes.byteLength);
+
+    this.context.pdfFileDetails.originalBytes = newPdfBytes;
+    this.context.pdfFileDetails.pdfSize = newPdfBytes.byteLength;
+
+    const incrementalStr = new TextDecoder('latin1').decode(incrementalBytes);
+    const startxrefMatch = incrementalStr.match(/startxref\s+(\d+)/);
+    if (startxrefMatch) {
+      this.context.pdfFileDetails.prevStartXRef = parseInt(
+        startxrefMatch[1],
+        10,
+      );
+    } else {
+      this.context.pdfFileDetails.prevStartXRef = originalBytes.byteLength;
+    }
+
+    this.context.snapshot = this.takeSnapshot();
+
+    return newPdfBytes;
+  }
+
   private async prepareForSave(options: SaveOptions): Promise<void> {
     const { addDefaultPage = true, updateFieldAppearances = true } = options;
 

package/src/api/PDFDocumentOptions.ts

@@ -20,6 +20,7 @@ export interface SaveOptions {
 
 export interface IncrementalSaveOptions {
   objectsPerTick?: number;
+  useObjectStreams?: boolean;
 }
 
 export interface Base64SaveOptions extends SaveOptions {

package/src/api/PDFFont.ts

@@ -38,7 +38,7 @@ export default class PDFFont implements Embeddable {
   /** The name of this font. */
   readonly name: string;
 
-  private modified = true;
+  private alreadyEmbedded = false;
   private readonly embedder: FontEmbedder;
 
   private constructor(ref: PDFRef, doc: PDFDocument, embedder: FontEmbedder) {
@@ -68,7 +68,6 @@ export default class PDFFont implements Embeddable {
    */
   encodeText(text: string): PDFHexString {
     assertIs(text, 'text', ['string']);
-    this.modified = true;
     return this.embedder.encodeText(text);
   }
 
@@ -145,10 +144,9 @@ export default class PDFFont implements Embeddable {
    * @returns Resolves when the embedding is complete.
    */
   async embed(): Promise<void> {
-    // TODO: Cleanup orphan embedded objects if a font is embedded multiple times...
-    if (this.modified) {
+    if (!this.alreadyEmbedded) {
       await this.embedder.embedIntoContext(this.doc.context, this.ref);
-      this.modified = false;
+      this.alreadyEmbedded = true;
     }
   }
 }

package/src/core/PDFContext.ts

@@ -429,7 +429,48 @@ class PDFContext {
   }
 
   registerObjectChange(obj: PDFObject) {
-    if (this.snapshot) this.snapshot.markObjForSave(obj);
+    if (!this.snapshot) return;
+
+    const ref = this.getObjectRef(obj);
+    if (ref) {
+      this.snapshot.markRefForSave(ref);
+      return;
+    }
+
+    const containingRef = this.findContainingIndirectObject(obj);
+    if (containingRef) {
+      this.snapshot.markRefForSave(containingRef);
+    }
+  }
+
+  private findContainingIndirectObject(target: PDFObject): PDFRef | undefined {
+    const entries = Array.from(this.indirectObjects.entries());
+    for (let idx = 0, len = entries.length; idx < len; idx++) {
+      const [ref, object] = entries[idx];
+      if (this.objectContains(object, target)) {
+        return ref;
+      }
+    }
+    return undefined;
+  }
+
+  private objectContains(container: PDFObject, target: PDFObject): boolean {
+    if (container === target) return true;
+
+    if (container instanceof PDFDict) {
+      const values = container.values();
+      for (let i = 0, len = values.length; i < len; i++) {
+        if (this.objectContains(values[i], target)) return true;
+      }
+    } else if (container instanceof PDFArray) {
+      for (let i = 0, len = container.size(); i < len; i++) {
+        if (this.objectContains(container.get(i), target)) return true;
+      }
+    } else if (container instanceof PDFStream) {
+      if (this.objectContains(container.dict, target)) return true;
+    }
+
+    return false;
   }
 
   getObjectVersions(ref: PDFRef): PDFObject[] {

package/src/core/objects/PDFArray.ts

@@ -30,10 +30,12 @@ class PDFArray extends PDFObject {
   }
 
   push(object: PDFObject): void {
+    this.registerChange();
     this.array.push(object);
   }
 
   insert(index: number, object: PDFObject): void {
+    this.registerChange();
     this.array.splice(index, 0, object);
   }
 
@@ -43,10 +45,12 @@ class PDFArray extends PDFObject {
   }
 
   remove(index: number): void {
+    this.registerChange();
     this.array.splice(index, 1);
   }
 
   set(idx: number, object: PDFObject): void {
+    this.registerChange();
     this.array[idx] = object;
   }
 
@@ -180,6 +184,10 @@ class PDFArray extends PDFObject {
       }
     }
   }
+
+  registerChange(): void {
+    this.context.registerObjectChange(this);
+  }
 }
 
 export default PDFArray;

package/src/core/objects/PDFRawStream.ts

@@ -45,6 +45,7 @@ class PDFRawStream extends PDFStream {
   }
 
   updateContents(contents: Uint8Array): void {
+    this.dict.registerChange();
     this.contents = contents;
   }
 }

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

@@ -842,6 +842,28 @@ export default class PDFDocument {
      * @returns  {PDFObjectVersions[]} Objects modified in the update, and previous versions
      */
     getChangedObjects(lastUpdateMinusX?: number): PDFObjectVersions[];
+    /**
+     * Saves the current changes to the document as an incremental update, returns the full document,
+     * like save method, and modifies the internal state to be able to continue editing the document
+     * for another incremental update.
+     * This allows you to save multiple incremental updates without reloading the PDF.
+     *
+     * For example:
+     * ```js
+     * const pdfDoc = await PDFDocument.load(pdfBytes, { forIncrementalUpdate: true })
+     *
+     * const page = pdfDoc.getPage(0)
+     * page.drawText('First update')
+     * const firstsave = await pdfDoc.saveAndContinue()
+     *
+     * page.drawText('Second update', { y: 100 })
+     * const secondsave = await pdfDoc.saveAndContinue()
+     * ```
+     *
+     * @param options The options to be used when saving changes.
+     * @returns Resolves with the complete PDF bytes including all updates.
+     */
+    saveAndContinue(options?: IncrementalSaveOptions): Promise<Uint8Array>;
     private prepareForSave;
     private embedAll;
     private updateInfoDict;

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

@@ -17,6 +17,7 @@ export interface SaveOptions {
 }
 export interface IncrementalSaveOptions {
     objectsPerTick?: number;
+    useObjectStreams?: boolean;
 }
 export interface Base64SaveOptions extends SaveOptions {
     dataUri?: boolean;

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

@@ -25,7 +25,7 @@ export default class PDFFont implements Embeddable {
     readonly doc: PDFDocument;
     /** The name of this font. */
     readonly name: string;
-    private modified;
+    private alreadyEmbedded;
     private readonly embedder;
     private constructor();
     /**

package/ts3.4/cjs/core/PDFContext.d.ts

@@ -119,6 +119,8 @@ declare class PDFContext {
     getPopGraphicsStateContentStream(): PDFRef;
     addRandomSuffix(prefix: string, suffixLength?: number): string;
     registerObjectChange(obj: PDFObject): void;
+    private findContainingIndirectObject;
+    private objectContains;
     getObjectVersions(ref: PDFRef): PDFObject[];
     listXrefEntries(xrefIndex?: number): Entry[];
 }

package/ts3.4/cjs/core/objects/PDFArray.d.ts

@@ -59,6 +59,7 @@ declare class PDFArray extends PDFObject {
     sizeInBytes(): number;
     copyBytesInto(buffer: Uint8Array, offset: number): number;
     scalePDFNumbers(x: number, y: number): void;
+    registerChange(): void;
 }
 export default PDFArray;
 //# sourceMappingURL=PDFArray.d.ts.map

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

@@ -842,6 +842,28 @@ export default class PDFDocument {
      * @returns  {PDFObjectVersions[]} Objects modified in the update, and previous versions
      */
     getChangedObjects(lastUpdateMinusX?: number): PDFObjectVersions[];
+    /**
+     * Saves the current changes to the document as an incremental update, returns the full document,
+     * like save method, and modifies the internal state to be able to continue editing the document
+     * for another incremental update.
+     * This allows you to save multiple incremental updates without reloading the PDF.
+     *
+     * For example:
+     * ```js
+     * const pdfDoc = await PDFDocument.load(pdfBytes, { forIncrementalUpdate: true })
+     *
+     * const page = pdfDoc.getPage(0)
+     * page.drawText('First update')
+     * const firstsave = await pdfDoc.saveAndContinue()
+     *
+     * page.drawText('Second update', { y: 100 })
+     * const secondsave = await pdfDoc.saveAndContinue()
+     * ```
+     *
+     * @param options The options to be used when saving changes.
+     * @returns Resolves with the complete PDF bytes including all updates.
+     */
+    saveAndContinue(options?: IncrementalSaveOptions): Promise<Uint8Array>;
     private prepareForSave;
     private embedAll;
     private updateInfoDict;

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

@@ -17,6 +17,7 @@ export interface SaveOptions {
 }
 export interface IncrementalSaveOptions {
     objectsPerTick?: number;
+    useObjectStreams?: boolean;
 }
 export interface Base64SaveOptions extends SaveOptions {
     dataUri?: boolean;

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

@@ -25,7 +25,7 @@ export default class PDFFont implements Embeddable {
     readonly doc: PDFDocument;
     /** The name of this font. */
     readonly name: string;
-    private modified;
+    private alreadyEmbedded;
     private readonly embedder;
     private constructor();
     /**

package/ts3.4/es/core/PDFContext.d.ts

@@ -119,6 +119,8 @@ declare class PDFContext {
     getPopGraphicsStateContentStream(): PDFRef;
     addRandomSuffix(prefix: string, suffixLength?: number): string;
     registerObjectChange(obj: PDFObject): void;
+    private findContainingIndirectObject;
+    private objectContains;
     getObjectVersions(ref: PDFRef): PDFObject[];
     listXrefEntries(xrefIndex?: number): Entry[];
 }

package/ts3.4/es/core/objects/PDFArray.d.ts

@@ -59,6 +59,7 @@ declare class PDFArray extends PDFObject {
     sizeInBytes(): number;
     copyBytesInto(buffer: Uint8Array, offset: number): number;
     scalePDFNumbers(x: number, y: number): void;
+    registerChange(): void;
 }
 export default PDFArray;
 //# sourceMappingURL=PDFArray.d.ts.map