Merge pull request #641 from embedpdf/feature/add-page-object-number

Add PdfPageObject.objectNumber

Author: bobsingor

.changeset/engines-page-object-number.md

@@ -0,0 +1,5 @@
+---
+'@embedpdf/engines': patch
+---
+
+Populate `PdfPageObject.objectNumber` from PDFium's `EPDFDoc_GetPageObjectNumberByIndex` in `openDocumentBuffer` and `importPages`, so pages now expose their PDF indirect-object number alongside their index, size, and rotation.

.changeset/models-page-object-number.md

@@ -0,0 +1,5 @@
+---
+'@embedpdf/models': patch
+---
+
+Add `objectNumber: number` to `PdfPageObject`, populated by the engine from `EPDFDoc_GetPageObjectNumberByIndex`. Lets consumers correlate pages with their PDF indirect-object numbers (e.g. for linking, debugging, or round-tripping raw object references). `PdfPageObject` is engine-owned — only the engine constructs it — so this is additive for all practical consumers.

packages/engines/src/lib/pdfium/engine.ts

@@ -384,6 +384,7 @@ export class PdfiumNative implements IPdfiumExecutor {
       }
 
       const rotation = this.pdfiumModule.EPDF_GetPageRotationByIndex(docPtr, index) as Rotation;
+      const objectNumber = this.pdfiumModule.EPDFDoc_GetPageObjectNumberByIndex(docPtr, index);
 
       const page = {
         index,
@@ -392,6 +393,7 @@ export class PdfiumNative implements IPdfiumExecutor {
           height: this.pdfiumModule.pdfium.getValue(sizePtr + 4, 'float'),
         },
         rotation,
+        objectNumber,
       };
 
       pages.push(page);
@@ -2738,6 +2740,10 @@ export class PdfiumNative implements IPdfiumExecutor {
         destCtx.docPtr,
         newPageIndex,
       ) as Rotation;
+      const objectNumber = this.pdfiumModule.EPDFDoc_GetPageObjectNumberByIndex(
+        destCtx.docPtr,
+        newPageIndex,
+      );
 
       newPages.push({
         index: newPageIndex,
@@ -2746,6 +2752,7 @@ export class PdfiumNative implements IPdfiumExecutor {
           height: this.pdfiumModule.pdfium.getValue(sizePtr + 4, 'float'),
         },
         rotation,
+        objectNumber,
       });
     }
 

packages/models/src/pdf.ts

@@ -21,6 +21,14 @@ export interface PdfPageObject {
    * Rotation of this page
    */
   rotation: Rotation;
+
+  /**
+   * PDF indirect-object number of this page's Page dictionary, as returned by
+   * `EPDFDoc_GetPageObjectNumberByIndex`. Useful for correlating pages with
+   * raw PDF references. Will be `0` when PDFium cannot resolve the page
+   * dictionary (e.g. XFA pages, which have no `CPDF_Page`).
+   */
+  objectNumber: number;
 }
 
 /**