mindee 4.18.0 → 4.19.0

package/CHANGELOG.md

@@ -1,6 +1,21 @@
 # CHANGELOG
 
-## v.4.18.0 - 2024-11-14
+## v4.19.0 - 2024-11-27
+### Changes
+* :coffin: remove support for international ID V1
+* :sparkles: add support for workflows
+* :sparkles: add configurable http request timeout
+### Fixes
+* :bug: fix http errors improperly showing as 500 in rare instances
+
+
+## v4.18.1 - 2024-11-19
+### Fixes
+* :bug: fix composed API server response not properly filling full_text_ocr in pages
+* :arrow_up: bump dependencies
+
+
+## v4.18.0 - 2024-11-14
 ### Changes
 * :sparkles: add support for business cards V1
 * :sparkles: add support for delivery note V1.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mindee",
-    "version": "4.18.0",
+    "version": "4.19.0",
     "description": "Mindee Client Library for Node.js",
     "main": "src/index.js",
     "bin": "bin/mindee.js",
@@ -9,7 +9,7 @@
         "build": "tsc --build",
         "build-for-dist": "tsc --build && cp LICENSE README.md CHANGELOG.md ./dist",
         "clean": "rm -rf ./dist ./docs/_build",
-        "test": "mocha 'tests/**/*.spec.ts'",
+        "test": "mocha 'tests/**/*.spec.ts' --config .mocharc.json",
         "test-integration": "mocha 'tests/**/*.integration.ts'",
         "lint": "eslint  './src/**/*.ts' --report-unused-disable-directives && echo 'Your .ts files look good.'",
         "lint-fix": "eslint './src/**/*.ts' --fix",
@@ -41,18 +41,18 @@
     "homepage": "https://mindee.com/",
     "devDependencies": {
         "@types/chai": "^4.3.4",
-        "@types/mocha": "^9.1.1",
+        "@types/mocha": "^10.0.9",
         "@types/node": "^18.15.11",
-        "@typescript-eslint/eslint-plugin": "^5.57.1",
-        "@typescript-eslint/parser": "^5.57.1",
+        "@typescript-eslint/eslint-plugin": "^8.15.0",
+        "@typescript-eslint/parser": "^8.15.0",
         "chai": "^4.3.10",
-        "eslint": "^8.49.0",
-        "eslint-plugin-jsdoc": "^46.8.2",
-        "mocha": "^10.1.0",
-        "nock": "^13.3.3",
-        "ts-node": "^10.9.1",
-        "typedoc": "~0.23",
-        "typescript": "^5.0.4"
+        "eslint": "^9.15.0",
+        "eslint-plugin-jsdoc": "^50.5.0",
+        "mocha": "^10.8.2",
+        "nock": "^13.5.6",
+        "ts-node": "^10.9.2",
+        "typedoc": "~0.26.11",
+        "typescript": "^5.6.3"
     },
     "dependencies": {
         "commander": "~9.4.1",

package/src/cli.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cli = void 0;
+exports.cli = cli;
 const commander_1 = require("commander");
 const product = __importStar(require("./product"));
 const client_1 = require("./client");
@@ -491,4 +491,3 @@ function cli() {
     });
     program.parse(process.argv);
 }
-exports.cli = cli;

package/src/client.d.ts

@@ -1,14 +1,27 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 import { Readable } from "stream";
 import { Base64Input, BufferInput, BytesInput, InputSource, LocalResponse, PageOptions, PathInput, StreamInput, UrlInput } from "./input";
 import { Endpoint } from "./http";
-import { AsyncPredictResponse, FeedbackResponse, Inference, PredictResponse, StringDict } from "./parsing/common";
+import { AsyncPredictResponse, ExecutionPriority, FeedbackResponse, Inference, PredictResponse, StringDict } from "./parsing/common";
+import { GeneratedV1 } from "./product";
+import { WorkflowResponse } from "./parsing/common/workflowResponse";
+/**
+ * Common options for workflows & predictions.
+ */
+interface BaseOptions {
+    /**
+     * Whether to include the full ocr text. Only available on compatible APIs.
+     */
+    fullText?: boolean;
+    /**
+     * If set, remove pages from the document as specified.
+     * This is done before sending the file to the server and is useful to avoid page limitations.
+     */
+    pageOptions?: PageOptions;
+}
 /**
  * Options relating to predictions.
  */
-export interface PredictOptions {
+export interface PredictOptions extends BaseOptions {
     /** A custom endpoint. */
     endpoint?: Endpoint;
     /**
@@ -17,19 +30,28 @@ export interface PredictOptions {
      * This performs a full OCR operation on the server and will increase response time.
      */
     allWords?: boolean;
-    /**
-     * Whether to include the full ocr text. Only available on compatible APIs.
-     */
-    fullText?: boolean;
     /**
      * Whether to include cropper results for each page.
      */
     cropper?: boolean;
+}
+/**
+ * Options relating to workflows.
+ * @category Workflow
+ */
+export interface WorkflowOptions extends BaseOptions {
     /**
-     * If set, remove pages from the document as specified.
-     * This is done before sending the file to the server and is useful to avoid page limitations.
+     * Alias to give to the document.
      */
-    pageOptions?: PageOptions;
+    alias?: string;
+    /**
+     * Priority to give to the document.
+     */
+    priority?: ExecutionPriority;
+    /**
+     * A unique, encrypted URL for accessing the document validation interface without requiring authentication.
+     */
+    publicUrl?: string;
 }
 /**
  * Asynchronous polling parameters.
@@ -114,6 +136,15 @@ export declare class Client {
      */
     parseQueued<T extends Inference>(productClass: new (httpResponse: StringDict) => T, queueId: string, params?: PredictOptions): Promise<AsyncPredictResponse<T>>;
     loadPrediction<T extends Inference>(productClass: new (httpResponse: StringDict) => T, localResponse: LocalResponse): Promise<AsyncPredictResponse<T> | PredictResponse<T>>;
+    /**
+     * Send the document to an asynchronous endpoint and return its ID in the queue.
+     * @param inputSource file to send to the API.
+     * @param workflowId ID of the workflow.
+     * @param params parameters relating to prediction options.
+     * @category Workflow
+     * @returns a `Promise` containing the job (queue) corresponding to a document.
+     */
+    executeWorkflow(inputSource: InputSource, workflowId: string, params?: WorkflowOptions): Promise<WorkflowResponse<GeneratedV1>>;
     /**
      * Fetch prediction results from a document already processed.
      *
@@ -207,3 +238,4 @@ export declare class Client {
      */
     docFromBuffer(buffer: Buffer, filename: string): BufferInput;
 }
+export {};

package/src/client.js

@@ -16,6 +16,8 @@ const inference_1 = require("./parsing/common/inference");
 const product_1 = require("./product");
 const promises_1 = require("node:timers/promises");
 const errors_1 = require("./errors");
+const workflowResponse_1 = require("./parsing/common/workflowResponse");
+const workflowEndpoint_1 = require("./http/workflowEndpoint");
 /**
  * Mindee Client class that centralizes most basic operations.
  *
@@ -122,10 +124,32 @@ class Client {
             }
             return new common_1.PredictResponse(productClass, localResponse.asDict());
         }
-        catch (err) {
+        catch {
             throw new errors_1.MindeeError("No prediction found in local response.");
         }
     }
+    /**
+     * Send the document to an asynchronous endpoint and return its ID in the queue.
+     * @param inputSource file to send to the API.
+     * @param workflowId ID of the workflow.
+     * @param params parameters relating to prediction options.
+     * @category Workflow
+     * @returns a `Promise` containing the job (queue) corresponding to a document.
+     */
+    async executeWorkflow(inputSource, workflowId, params = {}) {
+        const workflowEndpoint = new workflowEndpoint_1.WorkflowEndpoint(__classPrivateFieldGet(this, _Client_instances, "m", _Client_buildApiSettings).call(this), workflowId);
+        if (inputSource === undefined) {
+            throw new Error("The 'parse' function requires an input document.");
+        }
+        const rawResponse = await workflowEndpoint.executeWorkflow({
+            inputDoc: inputSource,
+            alias: params.alias,
+            priority: params.priority,
+            pageOptions: params?.pageOptions,
+            fullText: this.getBooleanParam(params.fullText),
+        });
+        return new workflowResponse_1.WorkflowResponse(product_1.GeneratedV1, rawResponse.data);
+    }
     /**
      * Fetch prediction results from a document already processed.
      *

package/src/geometry/boundingBoxUtils.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBBoxForPolygons = exports.getBbox = exports.mergeBbox = exports.getBoundingBoxFromBBox = exports.getBoundingBox = void 0;
+exports.getBoundingBox = getBoundingBox;
+exports.getBoundingBoxFromBBox = getBoundingBoxFromBBox;
+exports.mergeBbox = mergeBbox;
+exports.getBbox = getBbox;
+exports.getBBoxForPolygons = getBBoxForPolygons;
 const boundingBox_1 = require("./boundingBox");
 /**
  * Given a Polygon, calculate a polygon that encompasses all points.
@@ -9,7 +13,6 @@ function getBoundingBox(polygon) {
     const bbox = getBbox(polygon);
     return getBoundingBoxFromBBox(bbox);
 }
-exports.getBoundingBox = getBoundingBox;
 /**
  * Given a BBox, generate the associated bounding box.
  */
@@ -21,14 +24,12 @@ function getBoundingBoxFromBBox(bbox) {
         [bbox.xMin, bbox.yMax],
     ];
 }
-exports.getBoundingBoxFromBBox = getBoundingBoxFromBBox;
 /**
  * Given 2 bbox, merge them.
  */
 function mergeBbox(bbox1, bbox2) {
     return new boundingBox_1.BBox(Math.min(bbox1.xMin, bbox2.xMin), Math.min(bbox1.yMin, bbox2.yMin), Math.max(bbox1.xMax, bbox2.xMax), Math.max(bbox1.yMax, bbox2.yMax));
 }
-exports.mergeBbox = mergeBbox;
 /**
  * Given a Polygon, calculate a BBox that encompasses all points.
  */
@@ -37,7 +38,6 @@ function getBbox(polygon) {
     const allX = polygon.map((point) => point[0]);
     return new boundingBox_1.BBox(Math.min(...allX), Math.min(...allY), Math.max(...allX), Math.max(...allY));
 }
-exports.getBbox = getBbox;
 /**
  * Given polygons, calculate a BBox that encompasses all points.
  */
@@ -46,4 +46,3 @@ function getBBoxForPolygons(polygons) {
     const allX = polygons.flatMap((polygon) => polygon.map((point) => point[0]));
     return new boundingBox_1.BBox(Math.min(...allX), Math.min(...allY), Math.max(...allX), Math.max(...allY));
 }
-exports.getBBoxForPolygons = getBBoxForPolygons;

package/src/geometry/polygonUtils.js

@@ -1,6 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compareOnX = exports.compareOnY = exports.getMinXCoordinate = exports.getMinYCoordinate = exports.relativeX = exports.isPointInPolygonX = exports.getMinMaxX = exports.isPointInX = exports.relativeY = exports.isPointInPolygonY = exports.getMinMaxY = exports.isPointInY = exports.getCentroid = void 0;
+exports.getCentroid = getCentroid;
+exports.isPointInY = isPointInY;
+exports.getMinMaxY = getMinMaxY;
+exports.isPointInPolygonY = isPointInPolygonY;
+exports.relativeY = relativeY;
+exports.isPointInX = isPointInX;
+exports.getMinMaxX = getMinMaxX;
+exports.isPointInPolygonX = isPointInPolygonX;
+exports.relativeX = relativeX;
+exports.getMinYCoordinate = getMinYCoordinate;
+exports.getMinXCoordinate = getMinXCoordinate;
+exports.compareOnY = compareOnY;
+exports.compareOnX = compareOnX;
 /**
  * Get the central point (centroid) given a list of points.
  */
@@ -14,14 +26,12 @@ function getCentroid(vertices) {
         .reduce((prev, cur) => prev + cur);
     return [xSum / numbVertices, ySum / numbVertices];
 }
-exports.getCentroid = getCentroid;
 /**
  * Determine if a Point is within two Y coordinates.
  */
 function isPointInY(centroid, yMin, yMax) {
     return yMin <= centroid[1] && centroid[1] <= yMax;
 }
-exports.isPointInY = isPointInY;
 /**
  * Get the maximum and minimum Y coordinates in a given list of Points.
  */
@@ -29,7 +39,6 @@ function getMinMaxY(vertices) {
     const points = vertices.map((point) => point[1]);
     return { min: Math.min(...points), max: Math.max(...points) };
 }
-exports.getMinMaxY = getMinMaxY;
 /**
  * Determine if a Point is within a Polygon's Y axis.
  */
@@ -37,7 +46,6 @@ function isPointInPolygonY(centroid, polygon) {
     const yCoords = getMinMaxY(polygon);
     return isPointInY(centroid, yCoords.min, yCoords.max);
 }
-exports.isPointInPolygonY = isPointInPolygonY;
 /**
  * Calculate the relative Y position of a Polygon.
  *
@@ -49,14 +57,12 @@ function relativeY(polygon) {
         .reduce((prev, cur) => prev + cur);
     return polygon.length * sum;
 }
-exports.relativeY = relativeY;
 /**
  * Determine if a Point is within two X coordinates.
  */
 function isPointInX(centroid, xMin, xMax) {
     return xMin <= centroid[0] && centroid[0] <= xMax;
 }
-exports.isPointInX = isPointInX;
 /**
  * Get the maximum and minimum X coordinates in a given list of Points.
  */
@@ -64,7 +70,6 @@ function getMinMaxX(vertices) {
     const points = vertices.map((point) => point[0]);
     return { min: Math.min(...points), max: Math.max(...points) };
 }
-exports.getMinMaxX = getMinMaxX;
 /**
  * Determine if a Point is within a Polygon's X axis.
  */
@@ -72,7 +77,6 @@ function isPointInPolygonX(centroid, polygon) {
     const xCoords = getMinMaxX(polygon);
     return isPointInX(centroid, xCoords.min, xCoords.max);
 }
-exports.isPointInPolygonX = isPointInPolygonX;
 /**
  * Calculate the relative X position of a Polygon.
  *
@@ -84,7 +88,6 @@ function relativeX(polygon) {
         .reduce((prev, cur) => prev + cur);
     return polygon.length * sum;
 }
-exports.relativeX = relativeX;
 function getMinYCoordinate(polygon) {
     return polygon.sort((point1, point2) => {
         if (point1[1] < point2[1]) {
@@ -96,7 +99,6 @@ function getMinYCoordinate(polygon) {
         return 0;
     })[0][1];
 }
-exports.getMinYCoordinate = getMinYCoordinate;
 function getMinXCoordinate(polygon) {
     return polygon.sort((point1, point2) => {
         if (point1[0] < point2[0]) {
@@ -108,7 +110,6 @@ function getMinXCoordinate(polygon) {
         return 0;
     })[0][0];
 }
-exports.getMinXCoordinate = getMinXCoordinate;
 function compareOnY(polygon1, polygon2) {
     const sort = getMinYCoordinate(polygon1) - getMinYCoordinate(polygon2);
     if (sort === 0) {
@@ -116,7 +117,6 @@ function compareOnY(polygon1, polygon2) {
     }
     return sort < 0 ? -1 : 1;
 }
-exports.compareOnY = compareOnY;
 function compareOnX(polygon1, polygon2) {
     const sort = getMinXCoordinate(polygon1) - getMinXCoordinate(polygon2);
     if (sort === 0) {
@@ -124,4 +124,3 @@ function compareOnX(polygon1, polygon2) {
     }
     return sort < 0 ? -1 : 1;
 }
-exports.compareOnX = compareOnX;

package/src/http/apiSettings.d.ts

@@ -1,6 +1,7 @@
 export declare const API_KEY_ENVVAR_NAME: string;
 export declare const API_HOST_ENVVAR_NAME: string;
 export declare const STANDARD_API_OWNER: string;
+export declare const TIMEOUT_DEFAULT: number;
 interface MindeeApiConstructorProps {
     apiKey: string;
 }
@@ -8,6 +9,7 @@ export declare class ApiSettings {
     apiKey: string;
     baseHeaders: Record<string, string>;
     hostname: string;
+    timeout: number;
     constructor({ apiKey, }: MindeeApiConstructorProps);
     protected apiKeyFromEnv(): string;
     protected hostnameFromEnv(): string;

package/src/http/apiSettings.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiSettings = exports.STANDARD_API_OWNER = exports.API_HOST_ENVVAR_NAME = exports.API_KEY_ENVVAR_NAME = void 0;
+exports.ApiSettings = exports.TIMEOUT_DEFAULT = exports.STANDARD_API_OWNER = exports.API_HOST_ENVVAR_NAME = exports.API_KEY_ENVVAR_NAME = void 0;
 /* eslint-disable @typescript-eslint/naming-convention */
 const logger_1 = require("../logger");
 const package_json_1 = require("../../package.json");
@@ -31,6 +31,7 @@ const os = __importStar(require("os"));
 exports.API_KEY_ENVVAR_NAME = "MINDEE_API_KEY";
 exports.API_HOST_ENVVAR_NAME = "MINDEE_API_HOST";
 exports.STANDARD_API_OWNER = "mindee";
+exports.TIMEOUT_DEFAULT = 120;
 const DEFAULT_MINDEE_API_HOST = "api.mindee.net";
 const USER_AGENT = `mindee-api-nodejs@v${package_json_1.version} nodejs-${process.version} ${os.type().toLowerCase()}`;
 class ApiSettings {
@@ -50,6 +51,7 @@ class ApiSettings {
             Authorization: `Token ${this.apiKey}`,
         };
         this.hostname = this.hostnameFromEnv();
+        this.timeout = process.env.MINDEE_REQUEST_TIMEOUT ? parseInt(process.env.MINDEE_REQUEST_TIMEOUT) : exports.TIMEOUT_DEFAULT;
     }
     apiKeyFromEnv() {
         const envVarValue = process.env[exports.API_KEY_ENVVAR_NAME];

package/src/http/baseEndpoint.d.ts

@@ -1,8 +1,7 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { ApiSettings } from "./apiSettings";
 import { IncomingMessage, ClientRequest } from "http";
 import { RequestOptions } from "https";
+import { InputSource, PageOptions } from "../input";
 export interface EndpointResponse {
     messageObj: IncomingMessage;
     data: {
@@ -15,7 +14,15 @@ export interface EndpointResponse {
 export declare abstract class BaseEndpoint {
     /** Settings relating to the API. */
     settings: ApiSettings;
-    protected constructor(settings: ApiSettings);
+    /** Entire root of the URL for API calls. */
+    urlRoot: string;
+    protected constructor(settings: ApiSettings, urlRoot: string);
+    /**
+     * Cuts a document's pages according to the given options.
+     * @param inputDoc input document.
+     * @param pageOptions page cutting options.
+     */
+    protected cutDocPages(inputDoc: InputSource, pageOptions: PageOptions): Promise<void>;
     /**
      * Reads a response from the API and processes it.
      * @param options options related to the request itself.

package/src/http/baseEndpoint.js

@@ -3,12 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseEndpoint = void 0;
 const logger_1 = require("../logger");
 const https_1 = require("https");
+const base_1 = require("../input/base");
 /**
  * Base endpoint for the Mindee API.
  */
 class BaseEndpoint {
-    constructor(settings) {
+    constructor(settings, urlRoot) {
         this.settings = settings;
+        this.urlRoot = urlRoot;
+    }
+    /**
+     * Cuts a document's pages according to the given options.
+     * @param inputDoc input document.
+     * @param pageOptions page cutting options.
+     */
+    async cutDocPages(inputDoc, pageOptions) {
+        if (inputDoc instanceof base_1.LocalInputSource && inputDoc.isPdf()) {
+            await inputDoc.cutPdf(pageOptions);
+        }
     }
     /**
      * Reads a response from the API and processes it.
@@ -46,7 +58,7 @@ class BaseEndpoint {
                         reject(error);
                     }
                 }
-                catch (error) {
+                catch {
                     logger_1.logger.error("Could not parse the return as JSON.");
                     logger_1.logger.debug(responseBody);
                     resolve({

package/src/http/endpoint.d.ts

@@ -1,15 +1,8 @@
 import { InputSource } from "../input";
-import { PageOptions } from "../input";
 import { ApiSettings } from "./apiSettings";
 import { BaseEndpoint, EndpointResponse } from "./baseEndpoint";
 import { StringDict } from "../parsing/common";
-export interface PredictParams {
-    inputDoc: InputSource;
-    includeWords: boolean;
-    fullText: boolean;
-    pageOptions?: PageOptions;
-    cropper: boolean;
-}
+import { PredictParams } from "./httpParams";
 /**
  * Endpoint for a product (OTS or Custom).
  */
@@ -21,11 +14,9 @@ export declare class Endpoint extends BaseEndpoint {
     owner: string;
     /** Product's version, as a string. */
     version: string;
-    /** Entire root of the URL for API calls. */
-    urlRoot: string;
     constructor(urlName: string, owner: string, version: string, settings: ApiSettings);
     /**
-     * Sends a prediction to the API and parses out the result.
+     * Sends a document to the API and parses out the result.
      * Throws an error if the server's response contains one.
      * @param {PredictParams} params parameters relating to prediction options.
      * @category Synchronous
@@ -40,6 +31,7 @@ export declare class Endpoint extends BaseEndpoint {
      * @returns a `Promise` containing queue data.
      */
     predictAsync(params: PredictParams): Promise<EndpointResponse>;
+    private extractStatusMessage;
     /**
      * Requests the results of a queued document from the API.
      * Throws an error if the server's response contains one.

package/src/http/endpoint.js

@@ -7,7 +7,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _Endpoint_instances, _Endpoint_cutDocPages, _Endpoint_predictReqPost, _Endpoint_predictAsyncReqPost, _Endpoint_documentQueueReqGet, _Endpoint_documentGetReq, _Endpoint_documentFeedbackPutReq;
+var _Endpoint_instances, _Endpoint_predictReqPost, _Endpoint_predictAsyncReqPost, _Endpoint_documentQueueReqGet, _Endpoint_documentGetReq, _Endpoint_documentFeedbackPutReq;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Endpoint = void 0;
 const url_1 = require("url");
@@ -21,15 +21,14 @@ const responseValidation_1 = require("./responseValidation");
  */
 class Endpoint extends baseEndpoint_1.BaseEndpoint {
     constructor(urlName, owner, version, settings) {
-        super(settings);
+        super(settings, `/v1/products/${owner}/${urlName}/v${version}`);
         _Endpoint_instances.add(this);
         this.owner = owner;
         this.urlName = urlName;
         this.version = version;
-        this.urlRoot = `/v1/products/${owner}/${urlName}/v${version}`;
     }
     /**
-     * Sends a prediction to the API and parses out the result.
+     * Sends a document to the API and parses out the result.
      * Throws an error if the server's response contains one.
      * @param {PredictParams} params parameters relating to prediction options.
      * @category Synchronous
@@ -38,11 +37,11 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
     async predict(params) {
         await params.inputDoc.init();
         if (params.pageOptions !== undefined) {
-            await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_cutDocPages).call(this, params.inputDoc, params.pageOptions);
+            await super.cutDocPages(params.inputDoc, params.pageOptions);
         }
         const response = await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_predictReqPost).call(this, params.inputDoc, params.includeWords, params.fullText, params.cropper);
         if (!(0, responseValidation_1.isValidSyncResponse)(response)) {
-            (0, error_1.handleError)(this.urlName, response, response.messageObj?.statusMessage);
+            (0, error_1.handleError)(this.urlName, response, this.extractStatusMessage(response));
         }
         return response;
     }
@@ -56,14 +55,28 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
     async predictAsync(params) {
         await params.inputDoc.init();
         if (params.pageOptions !== undefined) {
-            await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_cutDocPages).call(this, params.inputDoc, params.pageOptions);
+            await super.cutDocPages(params.inputDoc, params.pageOptions);
         }
         const response = await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_predictAsyncReqPost).call(this, params.inputDoc, params.includeWords, params.fullText, params.cropper);
         if (!(0, responseValidation_1.isValidAsyncResponse)(response)) {
-            (0, error_1.handleError)(this.urlName, response, response.messageObj?.statusMessage);
+            (0, error_1.handleError)(this.urlName, response, this.extractStatusMessage(response));
         }
         return response;
     }
+    extractStatusMessage(response) {
+        if (response.messageObj?.statusMessage !== undefined && response.messageObj?.statusMessage !== null) {
+            return response.messageObj?.statusMessage;
+        }
+        const errorDetail = response.data?.api_request?.error?.detail;
+        if (errorDetail) {
+            return JSON.stringify(errorDetail);
+        }
+        const errorMessage = response.data?.api_request?.error?.message;
+        if (errorMessage) {
+            return JSON.stringify(errorMessage);
+        }
+        return undefined;
+    }
     /**
      * Requests the results of a queued document from the API.
      * Throws an error if the server's response contains one.
@@ -75,7 +88,7 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
         const queueResponse = await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_documentQueueReqGet).call(this, queueId);
         const queueStatusCode = queueResponse.messageObj.statusCode;
         if (!(0, responseValidation_1.isValidAsyncResponse)(queueResponse)) {
-            (0, error_1.handleError)(this.urlName, queueResponse, queueResponse.messageObj?.statusMessage);
+            (0, error_1.handleError)(this.urlName, queueResponse, this.extractStatusMessage(queueResponse));
         }
         if (queueStatusCode === 302 &&
             queueResponse.messageObj.headers.location !== undefined) {
@@ -93,7 +106,7 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
     async getDocument(documentId) {
         const response = await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_documentGetReq).call(this, documentId);
         if (!(0, responseValidation_1.isValidAsyncResponse)(response)) {
-            (0, error_1.handleError)("document", response, response.messageObj?.statusMessage);
+            (0, error_1.handleError)("document", response, this.extractStatusMessage(response));
         }
         return response;
     }
@@ -105,7 +118,7 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
     async sendFeedback(documentId, feedback) {
         const response = await __classPrivateFieldGet(this, _Endpoint_instances, "m", _Endpoint_documentFeedbackPutReq).call(this, documentId, feedback);
         if (!(0, responseValidation_1.isValidSyncResponse)(response)) {
-            (0, error_1.handleError)("feedback", response, response.messageObj?.statusMessage);
+            (0, error_1.handleError)("feedback", response, this.extractStatusMessage(response));
         }
         return response;
     }
@@ -148,6 +161,7 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
                 headers: headers,
                 hostname: this.settings.hostname,
                 path: path,
+                timeout: this.settings.timeout,
             };
             const req = this.readResponse(options, resolve, reject);
             form.pipe(req);
@@ -157,17 +171,7 @@ class Endpoint extends baseEndpoint_1.BaseEndpoint {
     }
 }
 exports.Endpoint = Endpoint;
-_Endpoint_instances = new WeakSet(), _Endpoint_cutDocPages = 
-/**
- * Cuts a document's pages according to the given options.
- * @param inputDoc input document.
- * @param pageOptions page cutting options.
- */
-async function _Endpoint_cutDocPages(inputDoc, pageOptions) {
-    if (inputDoc instanceof base_1.LocalInputSource && inputDoc.isPdf()) {
-        await inputDoc.cutPdf(pageOptions);
-    }
-}, _Endpoint_predictReqPost = function _Endpoint_predictReqPost(input, includeWords = false, fullText = false, cropper = false) {
+_Endpoint_instances = new WeakSet(), _Endpoint_predictReqPost = function _Endpoint_predictReqPost(input, includeWords = false, fullText = false, cropper = false) {
     return this.sendFileForPrediction(input, "predict", includeWords, fullText, cropper);
 }, _Endpoint_predictAsyncReqPost = function _Endpoint_predictAsyncReqPost(input, includeWords = false, fullText = false, cropper = false) {
     return this.sendFileForPrediction(input, "predict_async", includeWords, fullText, cropper);