pdf-lite 1.3.3 → 1.4.0

package/dist/index.js

@@ -7,3 +7,4 @@ export * from './pdf/index.js';
 export * from './security/index.js';
 export * from './signing/index.js';
 export * from './utils/index.js';
+export * from './annotations/index.js';

package/dist/pdf/pdf-document.d.ts

@@ -12,7 +12,6 @@ import { PdfTrailerEntries } from '../core/objects/pdf-trailer.js';
 import { PdfDocumentSecurityStoreObject } from '../signing/document-security-store.js';
 import { ByteArray } from '../types.js';
 import { PdfDocumentVerificationResult, PdfSigner } from '../signing/signer.js';
-import { PdfXfaManager } from '../xfa/manager.js';
 import { PdfAcroFormManager } from '../acroform/manager.js';
 import { PdfFontManager } from '../fonts/font-manager.js';
 /**
@@ -39,9 +38,9 @@ export declare class PdfDocument extends PdfObject {
     signer: PdfSigner;
     /** Security handler for encryption/decryption operations */
     securityHandler?: PdfSecurityHandler;
-    private _xfa?;
-    private _acroForm?;
-    private _fonts?;
+    /**  */
+    readonly acroForm: PdfAcroFormManager;
+    readonly fonts: PdfFontManager;
     private hasEncryptionDictionary?;
     private toBeCommitted;
     /**
@@ -65,12 +64,6 @@ export declare class PdfDocument extends PdfObject {
     });
     get header(): PdfComment | undefined;
     set header(comment: PdfComment | undefined);
-    /** XFA manager for handling XFA forms */
-    get xfa(): PdfXfaManager;
-    /** AcroForm manager for handling form fields */
-    get acroForm(): PdfAcroFormManager;
-    /** Font manager for embedding and managing fonts */
-    get fonts(): PdfFontManager;
     /**
      * Creates a PdfDocument from an array of PDF objects.
      * Parses objects into revisions based on EOF comments.
@@ -93,6 +86,16 @@ export declare class PdfDocument extends PdfObject {
      * @param objects - PDF objects to add to the document
      */
     add(...objects: PdfObject[]): void;
+    /**
+     * Packs non-stream indirect objects into compressed ObjStm containers.
+     * Objects that already have an object number are left unchanged.
+     * Appearance streams and other PdfStream objects must NOT be passed here —
+     * only non-stream indirect objects (dictionaries, arrays, etc.) are eligible.
+     *
+     * @param objects - Non-stream indirect objects to compress into ObjStm
+     * @param batchSize - Maximum objects per ObjStm container (default 100)
+     */
+    addObjectsAsStream(objects: PdfIndirectObject[], batchSize?: number): void;
     /**
      * Gets the latest (most recent) revision of the document.
      *
@@ -284,7 +287,7 @@ export declare class PdfDocument extends PdfObject {
      *
      * @returns A cloned PdfDocument instance
      */
-    clone(): this;
+    cloneImpl(): this;
     /**
      * Creates a PdfDocument from a byte stream.
      *

package/dist/pdf/pdf-document.js

@@ -17,7 +17,6 @@ import { PdfStartXRef } from '../core/objects/pdf-start-xref.js';
 import { FoundCompressedObjectError } from './errors.js';
 import { PdfReader } from './pdf-reader.js';
 import { PdfSigner } from '../signing/signer.js';
-import { PdfXfaManager } from '../xfa/manager.js';
 import { PdfAcroFormManager } from '../acroform/manager.js';
 import { PdfFontManager } from '../fonts/font-manager.js';
 import { concatUint8Arrays } from '../utils/concatUint8Arrays.js';
@@ -45,9 +44,9 @@ export class PdfDocument extends PdfObject {
     signer;
     /** Security handler for encryption/decryption operations */
     securityHandler;
-    _xfa;
-    _acroForm;
-    _fonts;
+    /**  */
+    acroForm;
+    fonts;
     hasEncryptionDictionary = false;
     toBeCommitted = [];
     /**
@@ -81,6 +80,8 @@ export class PdfDocument extends PdfObject {
         this.calculateOffsets();
         this.securityHandler =
             options?.securityHandler ?? this.getSecurityHandler();
+        this.acroForm = new PdfAcroFormManager(this);
+        this.fonts = new PdfFontManager(this);
     }
     get header() {
         return this.revisions[0].header;
@@ -89,27 +90,6 @@ export class PdfDocument extends PdfObject {
         if (comment)
             this.revisions[0].header = comment;
     }
-    /** XFA manager for handling XFA forms */
-    get xfa() {
-        if (!this._xfa) {
-            this._xfa = new PdfXfaManager(this);
-        }
-        return this._xfa;
-    }
-    /** AcroForm manager for handling form fields */
-    get acroForm() {
-        if (!this._acroForm) {
-            this._acroForm = new PdfAcroFormManager(this);
-        }
-        return this._acroForm;
-    }
-    /** Font manager for embedding and managing fonts */
-    get fonts() {
-        if (!this._fonts) {
-            this._fonts = new PdfFontManager(this);
-        }
-        return this._fonts;
-    }
     /**
      * Creates a PdfDocument from an array of PDF objects.
      * Parses objects into revisions based on EOF comments.
@@ -170,6 +150,36 @@ export class PdfDocument extends PdfObject {
             this.latestRevision.addObject(obj);
         }
     }
+    /**
+     * Packs non-stream indirect objects into compressed ObjStm containers.
+     * Objects that already have an object number are left unchanged.
+     * Appearance streams and other PdfStream objects must NOT be passed here —
+     * only non-stream indirect objects (dictionaries, arrays, etc.) are eligible.
+     *
+     * @param objects - Non-stream indirect objects to compress into ObjStm
+     * @param batchSize - Maximum objects per ObjStm container (default 100)
+     */
+    addObjectsAsStream(objects, batchSize = 100) {
+        if (objects.length === 0)
+            return;
+        for (let start = 0; start < objects.length; start += batchSize) {
+            const batch = objects.slice(start, Math.min(start + batchSize, objects.length));
+            // Pre-assign a contiguous block of object numbers for the batch
+            const xref = this.latestRevision.xref;
+            const startNum = xref.reserveObjectNumbers(batch.length);
+            for (let i = 0; i < batch.length; i++) {
+                if (!batch[i].inPdf()) {
+                    batch[i].objectNumber = startNum + i;
+                }
+            }
+            // Build the ObjStm and apply FlateDecode compression
+            const objStream = PdfObjStream.fromObjects(batch);
+            objStream.addFilter('FlateDecode');
+            // Add the container — xref.addObject() auto-registers children as type-2 entries
+            const container = new PdfIndirectObject({ content: objStream });
+            this.add(container);
+        }
+    }
     /**
      * Gets the latest (most recent) revision of the document.
      *
@@ -729,7 +739,7 @@ export class PdfDocument extends PdfObject {
      *
      * @returns A cloned PdfDocument instance
      */
-    clone() {
+    cloneImpl() {
         const clonedRevisions = this.revisions.map((rev) => rev.clone());
         return new PdfDocument({
             revisions: clonedRevisions,

package/dist/pdf/pdf-revision.d.ts

@@ -124,7 +124,7 @@ export declare class PdfRevision extends PdfObject {
      *
      * @returns A cloned PdfRevision instance
      */
-    clone(): this;
+    cloneImpl(): this;
     protected tokenize(): PdfToken[];
     toBytes(): ByteArray;
 }

package/dist/pdf/pdf-revision.js

@@ -250,7 +250,7 @@ export class PdfRevision extends PdfObject {
      *
      * @returns A cloned PdfRevision instance
      */
-    clone() {
+    cloneImpl() {
         const clonedObjects = this.objects.map((obj) => obj.clone());
         return new PdfRevision({ objects: clonedObjects });
     }

package/dist/pdf/pdf-xref-lookup.d.ts

@@ -110,6 +110,14 @@ export declare class PdfXrefLookup {
      * @returns The updated xref object
      */
     update(): PdfIndirectObject<PdfXRefStream> | PdfXRefTable;
+    /**
+     * Reserves a contiguous block of object numbers without registering objects.
+     * Use this to pre-assign numbers to objects that will live inside an ObjStm.
+     *
+     * @param count - Number of object numbers to reserve
+     * @returns The first reserved object number
+     */
+    reserveObjectNumbers(count: number): number;
     /**
      * Adds an indirect object to the xref lookup.
      * Assigns an object number if not already set.

package/dist/pdf/pdf-xref-lookup.js

@@ -305,6 +305,18 @@ export class PdfXrefLookup {
         this.object = newObject;
         return this.object;
     }
+    /**
+     * Reserves a contiguous block of object numbers without registering objects.
+     * Use this to pre-assign numbers to objects that will live inside an ObjStm.
+     *
+     * @param count - Number of object numbers to reserve
+     * @returns The first reserved object number
+     */
+    reserveObjectNumbers(count) {
+        const startNum = this.size;
+        this.size += count;
+        return startNum;
+    }
     /**
      * Adds an indirect object to the xref lookup.
      * Assigns an object number if not already set.

package/dist/security/handlers/base.js

@@ -87,11 +87,14 @@ export class PdfSecurityHandler {
             else if (obj instanceof PdfString) {
                 const decryptedData = await this.decrypt('string', obj.raw, objectNumber, generationNumber);
                 obj.raw = decryptedData;
+                obj.setModified(false);
             }
             else if (obj instanceof PdfStream) {
                 const decryptedData = await this.decrypt('stream', obj.raw, objectNumber, generationNumber);
                 obj.raw = decryptedData;
                 await decryptObject(obj.header);
+                obj.setModified(false);
+                obj.header.setModified(false);
             }
             else if (obj instanceof PdfDictionary) {
                 const values = obj.values;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-lite",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "main": "dist/index.js",
   "type": "module",
   "exports": {

package/dist/xfa/index.d.ts

@@ -1 +0,0 @@
-export { PdfXfaManager } from './manager.js';

package/dist/xfa/index.js

@@ -1 +0,0 @@
-export { PdfXfaManager } from './manager.js';

package/dist/xfa/manager.d.ts

@@ -1,44 +0,0 @@
-import { PdfDocument } from '../pdf/pdf-document.js';
-/**
- * Manages XFA (XML Forms Architecture) forms in PDF documents.
- * Provides methods to read and write XFA form data as XML.
- */
-export declare class PdfXfaManager {
-    private document;
-    private _datasetsStream?;
-    constructor(document: PdfDocument);
-    /**
-     * Checks if the document contains XFA forms.
-     * @returns True if the document has XFA forms, false otherwise
-     */
-    hasXfaForms(): Promise<boolean>;
-    /**
-     * Reads the XFA form data as XML string.
-     * @returns The XFA datasets XML content, or null if no XFA form exists
-     */
-    readXml(): Promise<string | null>;
-    /**
-     * Writes XML content to the XFA datasets stream.
-     * @param xml The XML content to write
-     * @throws Error if the document doesn't have XFA forms
-     */
-    writeXml(xml: string): Promise<void>;
-    /**
-     * Gets the AcroForm dictionary from the document catalog.
-     * @returns The AcroForm dictionary or null if not found
-     */
-    private getAcroForm;
-    /**
-     * Gets the XFA datasets stream.
-     * Caches the stream for subsequent calls to preserve modifications.
-     * @returns The datasets stream or null if not found
-     */
-    private getDatasetsStream;
-    /**
-     * Finds the XFA dataset object reference from the XFA array.
-     * XFA array structure: [(name1) ref1 (name2) ref2 ...]
-     * @param xfaArray The XFA array from the AcroForm
-     * @returns The object reference to the datasets stream, or null if not found
-     */
-    private findXfaDatasetReference;
-}

package/dist/xfa/manager.js

@@ -1,136 +0,0 @@
-import { PdfStream } from '../core/objects/pdf-stream.js';
-import { PdfDictionary } from '../core/objects/pdf-dictionary.js';
-import { PdfArray } from '../core/objects/pdf-array.js';
-import { PdfString } from '../core/objects/pdf-string.js';
-import { PdfObjectReference } from '../core/objects/pdf-object-reference.js';
-import { PdfIndirectObject } from '../core/index.js';
-/**
- * Manages XFA (XML Forms Architecture) forms in PDF documents.
- * Provides methods to read and write XFA form data as XML.
- */
-export class PdfXfaManager {
-    document;
-    _datasetsStream;
-    constructor(document) {
-        this.document = document;
-    }
-    /**
-     * Checks if the document contains XFA forms.
-     * @returns True if the document has XFA forms, false otherwise
-     */
-    async hasXfaForms() {
-        try {
-            const stream = await this.getDatasetsStream();
-            return stream !== null;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Reads the XFA form data as XML string.
-     * @returns The XFA datasets XML content, or null if no XFA form exists
-     */
-    async readXml() {
-        const stream = await this.getDatasetsStream();
-        if (!stream)
-            return null;
-        // Get decompressed data without modifying the original stream
-        const decompressed = stream.content.decode();
-        // Return the raw XML content as string
-        const decoder = new TextDecoder();
-        return decoder.decode(decompressed);
-    }
-    /**
-     * Writes XML content to the XFA datasets stream.
-     * @param xml The XML content to write
-     * @throws Error if the document doesn't have XFA forms
-     */
-    async writeXml(xml) {
-        const stream = await this.getDatasetsStream();
-        if (!stream) {
-            throw new Error('Document does not contain XFA forms');
-        }
-        // Update the cached stream directly with the new XML content
-        const datasetsIndirect = new PdfIndirectObject({
-            ...stream,
-            content: PdfStream.fromString(xml),
-        });
-        const isIncremental = this.document.isIncremental();
-        this.document.setIncremental(true);
-        await this.document.commit(datasetsIndirect);
-        this.document.setIncremental(isIncremental);
-        // Reset cached stream to force re-fetch if needed
-        this._datasetsStream = undefined;
-    }
-    /**
-     * Gets the AcroForm dictionary from the document catalog.
-     * @returns The AcroForm dictionary or null if not found
-     */
-    async getAcroForm() {
-        const catalog = this.document.root;
-        const acroFormRef = catalog.content.get('AcroForm');
-        if (!acroFormRef)
-            return null;
-        if (acroFormRef instanceof PdfObjectReference) {
-            const acroFormObject = await this.document.readObject({
-                objectNumber: acroFormRef.objectNumber,
-                generationNumber: acroFormRef.generationNumber,
-            });
-            if (!acroFormObject)
-                return null;
-            return acroFormObject.content.as(PdfDictionary);
-        }
-        else if (acroFormRef instanceof PdfDictionary) {
-            return acroFormRef;
-        }
-        return null;
-    }
-    /**
-     * Gets the XFA datasets stream.
-     * Caches the stream for subsequent calls to preserve modifications.
-     * @returns The datasets stream or null if not found
-     */
-    async getDatasetsStream() {
-        if (this._datasetsStream) {
-            return this._datasetsStream;
-        }
-        const acroForm = await this.getAcroForm();
-        if (!acroForm)
-            return null;
-        const xfaArray = acroForm.get('XFA');
-        if (!(xfaArray instanceof PdfArray))
-            return null;
-        const datasetsRef = this.findXfaDatasetReference(xfaArray);
-        if (!datasetsRef)
-            return null;
-        const datasetObject = await this.document.readObject({
-            objectNumber: datasetsRef.objectNumber,
-            generationNumber: datasetsRef.generationNumber,
-            allowUnindexed: true,
-        });
-        if (!datasetObject)
-            return null;
-        return datasetObject;
-    }
-    /**
-     * Finds the XFA dataset object reference from the XFA array.
-     * XFA array structure: [(name1) ref1 (name2) ref2 ...]
-     * @param xfaArray The XFA array from the AcroForm
-     * @returns The object reference to the datasets stream, or null if not found
-     */
-    findXfaDatasetReference(xfaArray) {
-        const items = xfaArray.items;
-        // XFA array alternates between name strings and object references
-        for (let i = 0; i < items.length - 1; i += 2) {
-            const name = items[i];
-            const ref = items[i + 1];
-            if (name instanceof PdfString && name.value === 'datasets') {
-                if (ref instanceof PdfObjectReference) {
-                    return ref;
-                }
-            }
-        }
-        return null;
-    }
-}