@anaralabs/lector 3.10.5 → 3.11.0

package/dist/_tsup-dts-rollup.d.ts

@@ -452,7 +452,7 @@ declare const usePdf: <T>(selector: (state: PDFState) => T) => T;
 export { usePdf }
 export { usePdf as usePdf_alias_1 }
 
-export declare const usePDFDocumentContext: ({ onDocumentLoad, source, initialRotation, isZoomFitWidth, zoom, zoomOptions, documentOptions, }: usePDFDocumentParams) => {
+export declare const usePDFDocumentContext: ({ onDocumentLoad, onError, source, initialRotation, isZoomFitWidth, zoom, zoomOptions, documentOptions, }: usePDFDocumentParams) => {
     initialState: InitialPDFState | null | undefined;
 };
 
@@ -465,6 +465,22 @@ export declare interface usePDFDocumentParams {
         proxy: PDFDocumentProxy;
         source: Source;
     }) => void;
+    /**
+     * Called when the document fails to load. Three failure modes:
+     *  - `phase: "pdfjs-load"` — the PDF.js worker / runtime itself failed to load.
+     *  - `phase: "document-load"` — `getDocument()` rejected (network error,
+     *    parse error, password required, etc). `onDocumentLoad` has NOT fired.
+     *  - `phase: "viewport-generation"` — the document loaded successfully and
+     *    `onDocumentLoad` already fired, but resolving page proxies / viewports
+     *    afterwards failed (e.g. corrupted page, transient pdf.js error).
+     * The callback fires in addition to the existing console.error, so existing
+     * consumers see no behavior change.
+     */
+    onError?: ({ error, phase, source, }: {
+        error: unknown;
+        phase: "pdfjs-load" | "document-load" | "viewport-generation";
+        source: Source;
+    }) => void;
     initialRotation?: number;
     isZoomFitWidth?: boolean;
     zoom?: number;

package/dist/index.js

@@ -5388,6 +5388,7 @@ function buildDocumentInitParams(source, pdfJsVersion, overrides) {
 }
 var usePDFDocumentContext = ({
   onDocumentLoad,
+  onError,
   source,
   initialRotation = 0,
   isZoomFitWidth,
@@ -5400,6 +5401,8 @@ var usePDFDocumentContext = ({
   const [rotation] = useState(initialRotation);
   const documentOptionsRef = useRef(documentOptions);
   documentOptionsRef.current = documentOptions;
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
   useEffect(() => {
     const generateViewports = async (pdf) => {
       const pageProxies = [];
@@ -5452,24 +5455,46 @@ var usePDFDocumentContext = ({
           }
           setProgress(progressEvent.loaded / progressEvent.total);
         };
-        return loadingTask.promise.then((proxy) => {
+        return loadingTask.promise.then(async (proxy) => {
           if (isDisposed || loadingTask?.destroyed) {
             return;
           }
           onDocumentLoad?.({ proxy, source });
           setProgress(1);
-          return generateViewports(proxy);
+          try {
+            await generateViewports(proxy);
+          } catch (error) {
+            if (isDisposed || loadingTask?.destroyed) {
+              return;
+            }
+            console.error("Error generating PDF viewports", error);
+            onErrorRef.current?.({
+              error,
+              phase: "viewport-generation",
+              source
+            });
+          }
         }).catch((error) => {
           if (isDisposed || loadingTask?.destroyed) {
             return;
           }
           console.error("Error loading PDF document", error);
+          onErrorRef.current?.({
+            error,
+            phase: "document-load",
+            source
+          });
         });
       }).catch((error) => {
         if (isDisposed) {
           return;
         }
         console.error("Error loading PDF.js", error);
+        onErrorRef.current?.({
+          error,
+          phase: "pdfjs-load",
+          source
+        });
       });
       return () => {
         isDisposed = true;
@@ -5488,6 +5513,7 @@ var Root = forwardRef(
     source,
     loader,
     onDocumentLoad,
+    onError,
     isZoomFitWidth,
     zoom,
     zoomOptions,
@@ -5497,6 +5523,7 @@ var Root = forwardRef(
     const { initialState } = usePDFDocumentContext({
       source,
       onDocumentLoad,
+      onError,
       isZoomFitWidth,
       zoom,
       zoomOptions,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@anaralabs/lector",
-	"version": "3.10.5",
+	"version": "3.11.0",
 	"description": "A headless PDF viewer for React",
 	"author": "andrewdr (https://github.com/andrewdoro)",
 	"license": "MIT",