@heripo/pdf-parser 0.1.23 → 0.1.25

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>;
     /**

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>;
     /**

package/dist/index.js

@@ -703,6 +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-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;
@@ -714,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() {
@@ -807,12 +835,30 @@ var PythonEnvironment = class {
       throw new Error(`Failed to install pyarrow. Exit code: ${result.code}`);
     }
   }
+  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",
-      "docling-serve"
+      "--no-deps",
+      DOCLING_SERVE_PACKAGE
     ]);
     if (result.code !== 0) {
       this.logger.error(
@@ -824,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
@@ -3831,6 +3894,7 @@ var PDFParser = class {
   enableImagePdfFallback;
   client = null;
   environment;
+  recoveryPromise = null;
   constructor(options) {
     const {
       logger,
@@ -3915,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,
@@ -3953,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;
@@ -4036,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;