ng2-pdfjs-viewer 26.0.0 → 26.0.1

package/fesm2022/ng2-pdfjs-viewer-ai.mjs

@@ -13,6 +13,12 @@
 // service, a plain script). The full component re-exports these symbols from
 // the package root for backwards compatibility.
 //
+// SECURITY: this sends a fetch from wherever you construct it — in a browser
+// app, that is the user's browser. Don't point `endpoint` directly at a hosted
+// cloud LLM (OpenAI, Azure, …): the API key would be exposed to the client, and
+// most providers block direct browser calls via CORS. Use a local model
+// (Ollama, LM Studio) or your own backend proxy. See the AI Assistant guide.
+//
 // Usage:
 //   import { PdfAiAssistant } from "ng2-pdfjs-viewer/ai";
 //   const text = await viewer.getDocumentText();

package/fesm2022/ng2-pdfjs-viewer.mjs

@@ -1687,6 +1687,7 @@ class PdfJsViewerComponent {
                 const eventBus = this.PDFViewerApplication.eventBus;
                 const handlers = {
                     documentloaded: () => {
+                        this.documentLoaded = true;
                         if (this.diagnosticLogs)
                             console.debug("PdfJsViewer: The document has now been loaded!");
                         this.onDocumentLoad.emit();
@@ -2023,12 +2024,39 @@ class PdfJsViewerComponent {
      * PDF.js text layer. The raw material for BYO-AI chat/summarize flows.
      */
     async getDocumentText(from, to) {
+        // The document may not have finished loading the instant this is called
+        // (e.g. an AI 'ask' fired immediately after the viewer appears). Wait for
+        // 'documentloaded' so we don't extract empty text; fall back on timeout.
+        if (!this.documentLoaded) {
+            await this.waitForDocumentLoad(15000);
+        }
         const result = await this.dispatchAction("get-document-text", { from, to }, "user-interaction");
         if (!result.success) {
             throw new Error(result.error || "getDocumentText failed");
         }
         return result.data ?? [];
     }
+    /**
+     * Resolve once the current document has loaded, or after timeoutMs (in which
+     * case callers proceed with whatever the viewer can provide). Never rejects.
+     */
+    waitForDocumentLoad(timeoutMs) {
+        if (this.documentLoaded)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                sub.unsubscribe();
+                clearTimeout(timer);
+                resolve();
+            };
+            const sub = this.onDocumentLoad.subscribe(() => finish());
+            const timer = setTimeout(finish, timeoutMs);
+        });
+    }
     /**
      * Read the document aloud from the current (or given) page using the
      * browser's speech synthesis. Progress arrives on onReadAloudStateChange.
@@ -2178,6 +2206,8 @@ class PdfJsViewerComponent {
         // A new load lifts the failed-document latch (the documentInit relay
         // also clears it, but that is enablement-gated and can race fast loads)
         this.documentLoadFailed = false;
+        // Text isn't extractable until the new document finishes loading.
+        this.documentLoaded = false;
         this.cdr.markForCheck();
         if (!this.setupExternalWindow()) {
             return; // popup blocked - nothing to navigate
@@ -2389,6 +2419,9 @@ class PdfJsViewerComponent {
     // actions dispatched against a failed load settle immediately instead of
     // queueing forever.
     documentLoadFailed = false;
+    // True once the current document fires 'documentloaded'. getDocumentText()
+    // awaits this so an AI 'ask' fired before render doesn't extract empty text.
+    documentLoaded = false;
     // Universal Action Dispatcher - ALL actions go through readiness-based queuing
     dispatchAction(action, payload, source = "property-change", level) {
         if (this.externalWindow && !this.externalWindowWarned) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng2-pdfjs-viewer",
-  "version": "26.0.0",
+  "version": "26.0.1",
   "description": "The most comprehensive Angular PDF viewer, powered by Mozilla PDF.js 6 — view, annotate, sign, fill forms, search, and read aloud from one component. 7M+ downloads, mobile-first, production-ready.",
   "author": {
     "name": "Aneesh Goapalakrishnan",

package/types/ng2-pdfjs-viewer.d.ts

@@ -554,6 +554,11 @@ declare class PdfJsViewerComponent implements OnInit, OnDestroy, OnChanges, Afte
      * PDF.js text layer. The raw material for BYO-AI chat/summarize flows.
      */
     getDocumentText(from?: number, to?: number): Promise<DocumentPageText[]>;
+    /**
+     * Resolve once the current document has loaded, or after timeoutMs (in which
+     * case callers proceed with whatever the viewer can provide). Never rejects.
+     */
+    private waitForDocumentLoad;
     /**
      * Read the document aloud from the current (or given) page using the
      * browser's speech synthesis. Progress arrives on onReadAloudStateChange.
@@ -606,6 +611,7 @@ declare class PdfJsViewerComponent implements OnInit, OnDestroy, OnChanges, Afte
     private navigateToViewer;
     private externalWindowWarned;
     private documentLoadFailed;
+    private documentLoaded;
     private dispatchAction;
     private getRequiredReadinessLevel;
     private hasRequiredReadiness;