@heripo/pdf-parser 0.1.24 → 0.1.26

package/dist/index.d.cts

@@ -130,6 +130,7 @@ declare class PDFParser {
     private readonly enableImagePdfFallback;
     private client;
     private environment?;
+    private recoveryPromise;
     constructor(options: Options);
     init(): Promise<void>;
     /**
@@ -137,6 +138,7 @@ declare class PDFParser {
      * This typically indicates the Docling server has crashed.
      */
     private isConnectionRefusedError;
+    private canRecoverLocalServer;
     /**
      * Restart the Docling server after it has crashed.
      * This kills any existing process on the port, starts a new server,
@@ -146,6 +148,9 @@ declare class PDFParser {
      * which guarantees this.port is defined.
      */
     private restartServer;
+    private recoverServer;
+    isReady(): Promise<boolean>;
+    ensureReady(): Promise<void>;
     private waitForServerReady;
     parse(url: string, reportId: string, onComplete: ConversionCompleteCallback, cleanupAfterCallback: boolean, options: PDFConvertOptions, abortSignal?: AbortSignal): Promise<TokenUsageReport | null>;
     /**
@@ -174,7 +179,7 @@ declare class ImagePdfFallbackError extends Error {
 
 /**
  * Error thrown when the uploaded PDF does not appear to be
- * a Korean archaeological investigation report.
+ * an archaeological investigation report.
  */
 declare class InvalidDocumentTypeError extends Error {
     readonly reason: string;

package/dist/index.d.ts

@@ -130,6 +130,7 @@ declare class PDFParser {
     private readonly enableImagePdfFallback;
     private client;
     private environment?;
+    private recoveryPromise;
     constructor(options: Options);
     init(): Promise<void>;
     /**
@@ -137,6 +138,7 @@ declare class PDFParser {
      * This typically indicates the Docling server has crashed.
      */
     private isConnectionRefusedError;
+    private canRecoverLocalServer;
     /**
      * Restart the Docling server after it has crashed.
      * This kills any existing process on the port, starts a new server,
@@ -146,6 +148,9 @@ declare class PDFParser {
      * which guarantees this.port is defined.
      */
     private restartServer;
+    private recoverServer;
+    isReady(): Promise<boolean>;
+    ensureReady(): Promise<void>;
     private waitForServerReady;
     parse(url: string, reportId: string, onComplete: ConversionCompleteCallback, cleanupAfterCallback: boolean, options: PDFConvertOptions, abortSignal?: AbortSignal): Promise<TokenUsageReport | null>;
     /**
@@ -174,7 +179,7 @@ declare class ImagePdfFallbackError extends Error {
 
 /**
  * Error thrown when the uploaded PDF does not appear to be
- * a Korean archaeological investigation report.
+ * an archaeological investigation report.
  */
 declare class InvalidDocumentTypeError extends Error {
     readonly reason: string;

package/dist/index.js

@@ -703,14 +703,32 @@ function validatePythonVersion(version, context = "system") {
 }
 
 // src/environment/python-environment.ts
+var DOCLING_SERVE_PACKAGE = "docling-serve==1.16.1";
 var DOCLING_RUNTIME_PACKAGES = [
-  "docling-serve==1.16.1",
-  "docling-jobkit==1.17.0",
-  "docling==2.90.0",
-  "docling-core==2.74.0",
+  "docling-jobkit==1.16.0",
+  "docling==2.88.0",
+  "docling-core==2.73.0",
   "docling-ibm-models==3.13.0",
   "docling-parse==5.9.0"
 ];
+var DOCLING_SERVE_RUNTIME_PACKAGES = [
+  "fastapi[standard]<0.130.0",
+  "httpx~=0.28",
+  "pydantic~=2.10",
+  "pydantic-settings~=2.4",
+  "python-multipart<0.1.0,>=0.0.14",
+  "typer~=0.12",
+  "uvicorn[standard]<1.0.0,>=0.29.0",
+  "websockets<17.0,>=14.0",
+  "scalar-fastapi>=1.0.3",
+  "docling-mcp>=1.0.0",
+  "opentelemetry-api==1.36.0",
+  "opentelemetry-sdk==1.36.0",
+  "opentelemetry-exporter-otlp==1.36.0",
+  "opentelemetry-instrumentation-fastapi==0.57b0",
+  "opentelemetry-exporter-prometheus==0.57b0",
+  "prometheus-client>=0.21.0"
+];
 var PythonEnvironment = class {
   constructor(logger, venvPath) {
     this.logger = logger;
@@ -722,6 +740,8 @@ var PythonEnvironment = class {
     await this.upgradePip();
     await this.installSetuptools();
     await this.installPyArrow();
+    await this.installDoclingRuntimePackages();
+    await this.installDoclingServeRuntimePackages();
     await this.installDoclingServe();
   }
   async checkPythonVersion() {
@@ -815,13 +835,31 @@ var PythonEnvironment = class {
       throw new Error(`Failed to install pyarrow. Exit code: ${result.code}`);
     }
   }
-  async installDoclingServe() {
+  async installDoclingRuntimePackages() {
     const pipPath = join2(this.venvPath, "bin", "pip");
     const result = await spawnAsync(pipPath, [
       "install",
       "--upgrade",
       ...DOCLING_RUNTIME_PACKAGES
     ]);
+    if (result.code !== 0) {
+      this.logger.error(
+        "[DoclingEnvironment] Failed to install docling runtime packages:",
+        result.stderr
+      );
+      throw new Error(
+        `Failed to install docling runtime packages. Exit code: ${result.code}`
+      );
+    }
+  }
+  async installDoclingServe() {
+    const pipPath = join2(this.venvPath, "bin", "pip");
+    const result = await spawnAsync(pipPath, [
+      "install",
+      "--upgrade",
+      "--no-deps",
+      DOCLING_SERVE_PACKAGE
+    ]);
     if (result.code !== 0) {
       this.logger.error(
         "[DoclingEnvironment] Failed to install docling-serve:",
@@ -832,6 +870,23 @@ var PythonEnvironment = class {
       );
     }
   }
+  async installDoclingServeRuntimePackages() {
+    const pipPath = join2(this.venvPath, "bin", "pip");
+    const result = await spawnAsync(pipPath, [
+      "install",
+      "--upgrade",
+      ...DOCLING_SERVE_RUNTIME_PACKAGES
+    ]);
+    if (result.code !== 0) {
+      this.logger.error(
+        "[DoclingEnvironment] Failed to install docling-serve runtime packages:",
+        result.stderr
+      );
+      throw new Error(
+        `Failed to install docling-serve runtime packages. Exit code: ${result.code}`
+      );
+    }
+  }
 };
 
 // src/environment/docling-environment.ts
@@ -1045,7 +1100,7 @@ import { z } from "zod";
 var InvalidDocumentTypeError = class extends Error {
   constructor(reason) {
     super(
-      `The uploaded PDF does not appear to be a Korean archaeological investigation report. Reason: ${reason}`
+      `The uploaded PDF does not appear to be an archaeological investigation report. Reason: ${reason}`
     );
     this.reason = reason;
   }
@@ -3550,7 +3605,7 @@ var PDFConverter = class {
   }
   documentTypeValidated = false;
   /**
-   * Validate that the PDF is a Korean archaeological investigation report.
+   * Validate that the PDF is an archaeological investigation report.
    * Skipped when no documentValidationModel is configured or for non-local URLs.
    * Only runs once per converter instance (flag prevents duplicate checks on recursive calls).
    */
@@ -3839,6 +3894,7 @@ var PDFParser = class {
   enableImagePdfFallback;
   client = null;
   environment;
+  recoveryPromise = null;
   constructor(options) {
     const {
       logger,
@@ -3923,15 +3979,30 @@ var PDFParser = class {
    */
   isConnectionRefusedError(error) {
     if (error instanceof Error) {
+      const errorWithMetadata = error;
       if (error.message.includes("ECONNREFUSED")) {
         return true;
       }
-      if (error.cause instanceof Error && error.cause.message.includes("ECONNREFUSED")) {
+      if (errorWithMetadata.code === "ECONNREFUSED") {
         return true;
       }
+      return this.isConnectionRefusedError(errorWithMetadata.cause);
+    }
+    if (typeof error === "object" && error !== null) {
+      const errorLike = error;
+      if (errorLike.code === "ECONNREFUSED") {
+        return true;
+      }
+      if (typeof errorLike.message === "string" && errorLike.message.includes("ECONNREFUSED")) {
+        return true;
+      }
+      return this.isConnectionRefusedError(errorLike.cause);
     }
     return false;
   }
+  canRecoverLocalServer() {
+    return !this.baseUrl && this.port !== void 0;
+  }
   /**
    * Restart the Docling server after it has crashed.
    * This kills any existing process on the port, starts a new server,
@@ -3961,6 +4032,46 @@ var PDFParser = class {
     await this.waitForServerReady();
     this.logger.info("[PDFParser] Server restarted successfully");
   }
+  async recoverServer(message) {
+    this.logger.warn(message);
+    if (!this.recoveryPromise) {
+      this.recoveryPromise = this.restartServer().finally(() => {
+        this.recoveryPromise = null;
+      });
+    } else {
+      this.logger.warn("[PDFParser] Server recovery already in progress...");
+    }
+    await this.recoveryPromise;
+  }
+  async isReady() {
+    if (!this.client) {
+      return false;
+    }
+    try {
+      await this.client.health();
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async ensureReady() {
+    if (!this.client) {
+      throw new Error(
+        "PDFParser is not initialized. Call init() before checking readiness"
+      );
+    }
+    try {
+      await this.client.health();
+    } catch (error) {
+      if (this.canRecoverLocalServer()) {
+        await this.recoverServer(
+          "[PDFParser] Health check failed, attempting server recovery..."
+        );
+        return;
+      }
+      throw error;
+    }
+  }
   async waitForServerReady() {
     const maxAttempts = PDF_PARSER.MAX_HEALTH_CHECK_ATTEMPTS;
     const checkInterval = PDF_PARSER.HEALTH_CHECK_INTERVAL_MS;
@@ -4044,18 +4155,16 @@ var PDFParser = class {
    * Recovery is only attempted in local server mode (no baseUrl, port defined).
    */
   async executeWithRecovery(fn, abortSignal) {
-    const canRecover = !this.baseUrl && this.port !== void 0;
     const maxAttempts = PDF_PARSER.MAX_SERVER_RECOVERY_ATTEMPTS;
     const tryExecute = async (attempt) => {
       try {
         return await fn();
       } catch (error) {
         if (abortSignal?.aborted) throw error;
-        if (canRecover && this.isConnectionRefusedError(error) && attempt < maxAttempts) {
-          this.logger.warn(
+        if (this.canRecoverLocalServer() && this.isConnectionRefusedError(error) && attempt < maxAttempts) {
+          await this.recoverServer(
             "[PDFParser] Connection refused, attempting server recovery..."
           );
-          await this.restartServer();
           return tryExecute(attempt + 1);
         }
         throw error;