feat: ✨ expose getPDFPageCount to return the number of pages in a pdf

CHANGELOG.md

@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## v1.7.0
+
+### Changes
+
+- expose `getPDFPageCount` to return the number of pages in a PDF without rendering
+
 ## v1.6.9 (26/01/2026)
 
 ### Fixes

docs/docs/Utils/get-pdf-page-count.mdx

@@ -0,0 +1,15 @@
+---
+sidebar_position: 2
+---
+
+# getPDFPageCount
+
+- Type : `(file: string) => Promise<number>`
+
+> The parameter should be a valid Object URL of type string. If you have an object of type [File](https://developer.mozilla.org/fr/docs/Web/API/File) ( typically generated by file upload libraries) in hand you must use [URL.createObjectURL()](https://developer.mozilla.org/fr/docs/Web/API/URL/createObjectURL) to generate a valid URL object.
+
+```javascript
+getPDFPageCount(file).then((pageCount) => {
+  // Do something with the page count
+})
+```

src/index.ts

@@ -18,6 +18,7 @@ import {
   toBase64,
 } from './utils/functions'
 import getImagesFromPDF from './utils/getImagesFromPDF'
+import getPDFPageCount from './utils/getPDFPageCount'
 import { dataURItoBlob } from './utils/image'
 
 export type {
@@ -36,6 +37,7 @@ export {
   AnnotationLens,
   AnnotationViewer,
   getImagesFromPDF,
+  getPDFPageCount,
   drawShape,
   drawLayer,
   setShapeConfig,

src/utils/getPDFPageCount.spec.tsx

@@ -0,0 +1,18 @@
+import brokenPDF from 'cypress/assets/broken-pdf.pdf'
+import multiPage from 'cypress/assets/multi-page.pdf'
+
+import getPDFPageCount from './getPDFPageCount'
+
+describe('getPDFPageCount', () => {
+  it('should return the number of PDF pages', () => {
+    getPDFPageCount(multiPage).then((pageCount) => {
+      expect(pageCount).to.equal(5)
+    })
+  })
+
+  it('should catch error when the PDF is broken', () => {
+    getPDFPageCount(brokenPDF).catch((error) => {
+      expect(error.name).to.equal('InvalidPDFException')
+    })
+  })
+})

src/utils/getPDFPageCount.ts

@@ -0,0 +1,16 @@
+import {
+  getDocument,
+  GlobalWorkerOptions,
+  PDFDocumentProxy,
+  version,
+} from 'pdfjs-dist'
+
+GlobalWorkerOptions.workerSrc = `//cdnjs.cloudflare.com/ajax/libs/pdf.js/${version}/pdf.worker.js`
+
+export default function getPDFPageCount(file: string) {
+  return new Promise<number>((resolve, reject) => {
+    getDocument(file)
+      .promise.then((document: PDFDocumentProxy) => resolve(document.numPages))
+      .catch((error) => reject(error))
+  })
+}