mindee 5.0.0-alpha1 → 5.0.0-rc1

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # CHANGELOG
 
+## 5.0.0-rc1 - 2026-01-17
+### Changes
+* :boom: drop support for node.js 18
+* :boom: :recycle: separate polling options
+
+
+## 5.0.0-alpha2 - 2026-01-16
+### Changes
+* :recycle: use node test methods
+* :recycle: v1 ocr word should be a class
+* :recycle: make v2 products top level
+* :bug: fix for optional node-poppler
+
+
+## 5.0.0-alpha1 - 2026-01-13
+### :boom: :recycle: base for v5
+* :arrow_up: update file-type
+* :recycle: migrate to ES modules (node18)
+* :coffin: remove support for obsolete/unused products:
+  * API builder (no longer maintained, use v2)
+* :coffin: remove support for unused products available in v2:
+  * nutrition facts
+  * business card
+  * US healthcare cards
+  * bill of lading
+* :coffin: remove support for unused products:
+  * delivery note
+  * payslip_fra_v2_async
+  * idcard_fr_v1
+  * ind_passport_v1_async
+  * us_mail_v3_async
+  * energy_bill_fra_v1_async
+  * french_healthcard_v1_async
+  * payslip_fra_v3_async
+* :recycle: use undici for HTTP requests and mocking
+* :sparkles: add ability for a user to specify their own undici `Dispatcher` instance
+* :sparkles: add basic V2 CLI
+* :recycle: :boom: rework of directory structure
+* :recycle: :boom: rework input source errors
+* :sparkles: handle abort signal stream inputs
+* :sparkles: add support for all utility products
+* :boom: :sparkles:  move PDF and image libraries to optional dependencies
+
+
 ## v4.36.3 - 2026-01-20
 ### Fixes
 * :bug: fix streams not loading properly

package/package.json

@@ -1,25 +1,25 @@
 {
     "name": "mindee",
-    "version": "5.0.0-alpha1",
+    "version": "5.0.0-rc1",
     "description": "Mindee Client Library for Node.js",
     "main": "src/index.js",
-    "bin": "bin/mindee.js",
+    "bin": {
+        "mindeeV1": "bin/mindeeV1.js",
+        "mindeeV2": "bin/mindeeV2.js"
+    },
     "license": "MIT",
     "type": "module",
     "scripts": {
         "build": "tsc --build && tsc-alias",
         "build-for-dist": "tsc --build && tsc-alias && cp LICENSE README.md CHANGELOG.md ./dist",
         "clean": "rm -rf ./dist ./docs/_build",
-        "test": "mocha --grep \"#omitOptionalDeps\" --invert \"tests/**/*.spec.ts\"",
-        "test-light": "mocha --grep \"#includeOptionalDeps\" --invert \"tests/**/*.spec.ts\"",
-        "test-integration": "mocha --grep \"#omitOptionalDeps\" --invert \"tests/**/*.integration.ts\"",
-        "test-integration-light": "mocha --grep \"#includeOptionalDeps\" --invert \"tests/**/*.integration.ts\"",
-        "test-v1": "mocha --grep \"#omitOptionalDeps\" --invert \"tests/v1/**/*.spec.ts\"",
-        "test-v1-light": "mocha --grep \"#includeOptionalDeps\" --invert \"tests/v1/**/*.spec.ts\"",
-        "test-v2": "mocha --grep \"#omitOptionalDeps\" --invert \"tests/v2/**/*.spec.ts\"",
-        "test-v2-light": "mocha --grep \"#includeOptionalDeps\" --invert \"tests/v2/**/*.spec.ts\"",
-        "lint": "tsc --noEmit && eslint './src/**/*.ts' --report-unused-disable-directives && echo 'Your .ts files look good.'",
-        "lint-fix": "eslint './src/**/*.ts' --fix",
+        "test": "mocha --grep '#OptionalDepsRemoved' --invert 'tests/**/*.spec.ts'",
+        "test-light": "mocha --grep '#OptionalDepsRequired' --invert 'tests/**/*.spec.ts'",
+        "test-integration": "mocha --grep '#OptionalDepsRemoved' --invert 'tests/**/*.integration.ts'",
+        "test-integration-light": "mocha --grep '#OptionalDepsRequired' --invert 'tests/**/*.integration.ts'",
+        "test-v2": "tsc --noEmit && node --import tsx --test 'tests/v2/**/*.spec.ts'",
+        "lint": "tsc --noEmit && eslint --report-unused-disable-directives './src/**/*.ts' './tests/**/*.ts'",
+        "lint-fix": "eslint --fix --report-unused-disable-directives './src/**/*.ts' './tests/**/*.ts'",
         "docs": "typedoc --out docs/_build ./src/index.ts",
         "docs-for-dist": "typedoc --out docs/_build ./src/index.ts && cp -r ./docs/code_samples ./docs/_build/"
     },
@@ -31,7 +31,7 @@
         "CHANGELOG.md"
     ],
     "engines": {
-        "node": ">= 18.17"
+        "node": ">= 20.1"
     },
     "repository": {
         "type": "git",
@@ -47,33 +47,31 @@
     },
     "homepage": "https://mindee.com/",
     "devDependencies": {
-        "@types/chai": "^5.2.3",
         "@types/mocha": "^10.0.10",
         "@types/node": "^18.19.130",
         "@types/tmp": "^0.2.6",
-        "@typescript-eslint/eslint-plugin": "^8.52.0",
-        "@typescript-eslint/parser": "^8.52.0",
-        "chai": "^6.2.2",
+        "@typescript-eslint/eslint-plugin": "^8.55.0",
+        "@typescript-eslint/parser": "^8.55.0",
         "eslint": "^9.39.2",
-        "eslint-plugin-jsdoc": "^50.6.17",
-        "mocha": "^11.7.5",
+        "eslint-plugin-jsdoc": "^52.0.4",
+        "mocha": "^11.3.0",
         "tsc-alias": "^1.8.16",
         "tsx": "^4.21.0",
-        "typedoc": "~0.28.15",
+        "typedoc": "~0.28.16",
         "typescript": "^5.9.3"
     },
     "dependencies": {
         "commander": "~9.4.1",
         "file-type": "^19.6.0",
-        "node-poppler": "^7.2.4",
         "tmp": "^0.2.3",
         "tslib": "^2.8.1",
         "undici": "^6.23.0"
     },
     "optionalDependencies": {
-        "sharp": "~0.34.5",
         "@cantoo/pdf-lib": "^2.3.2",
-        "pdf.js-extract": "^0.2.1"
+        "node-poppler": "^7.2.4",
+        "pdf.js-extract": "^0.2.1",
+        "sharp": "~0.34.5"
     },
     "keywords": [
         "typescript",

package/src/geometry/bbox.d.ts

@@ -0,0 +1,9 @@
+/** A simple bounding box defined by 4 coordinates: xMin, yMin, xMax, yMax */
+export declare class BBox {
+    xMin: number;
+    yMin: number;
+    xMax: number;
+    yMax: number;
+    constructor(xMin: number, yMin: number, xMax: number, yMax: number);
+    mergeBbox(bbox: BBox): BBox;
+}

package/src/geometry/bbox.js

@@ -0,0 +1,13 @@
+import { mergeBbox } from "../geometry/boundingBoxUtils.js";
+/** A simple bounding box defined by 4 coordinates: xMin, yMin, xMax, yMax */
+export class BBox {
+    constructor(xMin, yMin, xMax, yMax) {
+        this.xMin = xMin;
+        this.yMin = yMin;
+        this.xMax = xMax;
+        this.yMax = yMax;
+    }
+    mergeBbox(bbox) {
+        return mergeBbox(this, bbox);
+    }
+}

package/src/geometry/boundingBox.d.ts

@@ -1,13 +1,5 @@
 import { Point } from "./point.js";
 import { Polygon } from "./polygon.js";
-/** A simple bounding box defined by 4 coordinates: xMin, yMin, xMax, yMax */
-export declare class BBox {
-    xMin: number;
-    yMin: number;
-    xMax: number;
-    yMax: number;
-    constructor(xMin: number, yMin: number, xMax: number, yMax: number);
-}
 /** A bounding box defined by 4 points. */
 export declare class BoundingBox extends Polygon {
     constructor(topLeft: Point, topRight: Point, bottomRight: Point, bottomLeft: Point);

package/src/geometry/boundingBox.js

@@ -1,13 +1,4 @@
 import { Polygon } from "./polygon.js";
-/** A simple bounding box defined by 4 coordinates: xMin, yMin, xMax, yMax */
-export class BBox {
-    constructor(xMin, yMin, xMax, yMax) {
-        this.xMin = xMin;
-        this.yMin = yMin;
-        this.xMax = xMax;
-        this.yMax = yMax;
-    }
-}
 /** A bounding box defined by 4 points. */
 export class BoundingBox extends Polygon {
     constructor(topLeft, topRight, bottomRight, bottomLeft) {

package/src/geometry/boundingBoxUtils.d.ts

@@ -1,4 +1,5 @@
-import { BoundingBox, BBox } from "./boundingBox.js";
+import { BoundingBox } from "./boundingBox.js";
+import { BBox } from "./bbox.js";
 import { Polygon } from "./polygon.js";
 /**
  * Given a Polygon, calculate a polygon that encompasses all points.

package/src/geometry/boundingBoxUtils.js

@@ -1,4 +1,5 @@
-import { BoundingBox, BBox } from "./boundingBox.js";
+import { BoundingBox } from "./boundingBox.js";
+import { BBox } from "./bbox.js";
 /**
  * Given a Polygon, calculate a polygon that encompasses all points.
  */

package/src/geometry/index.d.ts

@@ -1,6 +1,7 @@
 export { Polygon } from "./polygon.js";
 export { compareOnX, compareOnY, getCentroid, isPointInPolygonX, isPointInPolygonY, relativeX, relativeY, getMinMaxX, getMinMaxY, } from "./polygonUtils.js";
-export { BoundingBox, BBox } from "./boundingBox.js";
+export { BoundingBox } from "./boundingBox.js";
+export { BBox } from "./bbox.js";
 export { getBbox, getBBoxForPolygons, getBoundingBox, getBoundingBoxFromBBox, mergeBbox, } from "./boundingBoxUtils.js";
 export type { MinMax } from "./minMax.js";
 export type { Point } from "./point.js";

package/src/geometry/index.js

@@ -1,4 +1,5 @@
 export { Polygon } from "./polygon.js";
 export { compareOnX, compareOnY, getCentroid, isPointInPolygonX, isPointInPolygonY, relativeX, relativeY, getMinMaxX, getMinMaxY, } from "./polygonUtils.js";
-export { BoundingBox, BBox } from "./boundingBox.js";
+export { BoundingBox } from "./boundingBox.js";
+export { BBox } from "./bbox.js";
 export { getBbox, getBBoxForPolygons, getBoundingBox, getBoundingBoxFromBBox, mergeBbox, } from "./boundingBoxUtils.js";

package/src/image/extractedImage.js

@@ -1,10 +1,10 @@
 import { Buffer } from "node:buffer";
 import { MindeeError } from "../errors/index.js";
 import { writeFileSync } from "node:fs";
+import { writeFile } from "fs/promises";
 import path from "node:path";
-import { logger } from "../logger.js";
 import { BufferInput, MIMETYPES } from "../input/index.js";
-import { writeFile } from "fs/promises";
+import { logger } from "../logger.js";
 import { loadOptionalDependency } from "../dependency/index.js";
 /**
  * Generic class for image extraction

package/src/index.d.ts

@@ -1,7 +1,10 @@
 export { InputSource, Base64Input, BufferInput, BytesInput, PathInput, StreamInput, UrlInput, PageOptionsOperation, } from "./input/index.js";
 export type { PageOptions } from "./input/index.js";
 export * as image from "./image/index.js";
+export * as pdf from "./pdf/index.js";
+export * as geometry from "./geometry/index.js";
 export * as v1 from "./v1/index.js";
 export * as v2 from "./v2/index.js";
-export { Client, InferenceFile, InferenceModel, JobResponse, ErrorResponse, } from "./v2/index.js";
+export * as product from "./v2/product/index.js";
+export { Client, JobResponse, ErrorResponse, } from "./v2/index.js";
 export type { PollingOptions } from "./v2/index.js";

package/src/index.js

@@ -1,7 +1,12 @@
+// Core
 export { InputSource, Base64Input, BufferInput, BytesInput, PathInput, StreamInput, UrlInput, PageOptionsOperation, } from "./input/index.js";
 export * as image from "./image/index.js";
+export * as pdf from "./pdf/index.js";
+export * as geometry from "./geometry/index.js";
 // V1
 export * as v1 from "./v1/index.js";
 // V2
 export * as v2 from "./v2/index.js";
-export { Client, InferenceFile, InferenceModel, JobResponse, ErrorResponse, } from "./v2/index.js";
+// Consider v2 the default
+export * as product from "./v2/product/index.js";
+export { Client, JobResponse, ErrorResponse, } from "./v2/index.js";

package/src/pdf/pdfCompressor.js

@@ -1,9 +1,9 @@
 import { logger } from "../logger.js";
 import tmp from "tmp";
-import { extractTextFromPdf, hasSourceText } from "./pdfUtils.js";
 import * as fs from "node:fs";
 import { compressImage } from "../image/index.js";
 import { loadOptionalDependency } from "../dependency/index.js";
+import { extractTextFromPdf, hasSourceText } from "./pdfUtils.js";
 let pdfLib = null;
 async function getPdfLib() {
     if (!pdfLib) {
@@ -33,8 +33,8 @@ export async function compressPdf(pdfData, imageQuality = 85, forceSourceTextCom
             }
         }
         else {
-            logger.warn("Found text inside of the provided PDF file. Compression operation aborted since disableSourceText "
-                + "is set to 'true'.");
+            logger.warn("Found text inside of the provided PDF file. " +
+                "Compression operation aborted since disableSourceText is set to 'true'.");
             return pdfData;
         }
     }

package/src/v1/parsing/common/ocrPage.js

@@ -4,7 +4,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _OcrPage_instances, _OcrPage_areWordsOnSameLine, _OcrPage_toLines;
-import { compareOnX, compareOnY, getCentroid, isPointInPolygonY, } from "../../../geometry/index.js";
+import { compareOnX, compareOnY, isPointInPolygonY, } from "../../../geometry/index.js";
+import { Word } from "../../../v1/parsing/standard/index.js";
 export class OcrPage {
     constructor(rawPrediction) {
         _OcrPage_instances.add(this);
@@ -15,7 +16,7 @@ export class OcrPage {
         const allWords = [];
         if (rawPrediction["all_words"]) {
             rawPrediction["all_words"].forEach((word) => {
-                allWords.push(word);
+                allWords.push(new Word(word));
             });
         }
         this.allWords = allWords.sort((word1, word2) => compareOnY(word1.polygon, word2.polygon));
@@ -40,8 +41,8 @@ export class OcrPage {
     }
 }
 _OcrPage_instances = new WeakSet(), _OcrPage_areWordsOnSameLine = function _OcrPage_areWordsOnSameLine(currentWord, nextWord) {
-    const currentInNext = isPointInPolygonY(getCentroid(currentWord.polygon), nextWord.polygon);
-    const nextInCurrent = isPointInPolygonY(getCentroid(nextWord.polygon), currentWord.polygon);
+    const currentInNext = isPointInPolygonY(currentWord.polygon.getCentroid(), nextWord.polygon);
+    const nextInCurrent = isPointInPolygonY(nextWord.polygon.getCentroid(), currentWord.polygon);
     return nextInCurrent || currentInNext;
 }, _OcrPage_toLines = function _OcrPage_toLines() {
     const lines = [];

package/src/v1/parsing/standard/index.d.ts

@@ -12,4 +12,4 @@ export { Taxes, TaxField } from "./tax.js";
 export { StringField } from "./text.js";
 export { PaymentDetailsField } from "./paymentDetails.js";
 export { PositionField } from "./position.js";
-export type { Word } from "./word.js";
+export { Word } from "./word.js";

package/src/v1/parsing/standard/index.js

@@ -11,3 +11,4 @@ export { Taxes, TaxField } from "./tax.js";
 export { StringField } from "./text.js";
 export { PaymentDetailsField } from "./paymentDetails.js";
 export { PositionField } from "./position.js";
+export { Word } from "./word.js";

package/src/v1/parsing/standard/word.d.ts

@@ -1,10 +1,12 @@
-import * as geometry from "../../../geometry/index.js";
-export type Word = {
+import { Polygon } from "../../../geometry/index.js";
+import { StringDict } from "../../../parsing/index.js";
+export declare class Word {
     /**
      * Contains the relative vertices coordinates (points) of a polygon containing
      * the field in the document.
      */
-    polygon: geometry.Polygon;
+    polygon: Polygon;
     text: string;
     confidence: number;
-};
+    constructor(rawPrediction: StringDict);
+}

package/src/v1/parsing/standard/word.js

@@ -1 +1,9 @@
-export {};
+import { Polygon } from "../../../geometry/index.js";
+export class Word {
+    constructor(rawPrediction) {
+        this.polygon = new Polygon(...rawPrediction["polygon"]);
+        this.text = rawPrediction["text"];
+        this.confidence = rawPrediction["confidence"];
+    }
+}
+;

package/src/v2/client/baseParameters.d.ts

@@ -1,5 +1,3 @@
-import { ValidatedPollingOptions } from "../../v2/client/pollingOptions.js";
-import { PollingOptions } from "../../v2/index.js";
 /**
  * Constructor parameters for BaseParameters and its subclasses.
  */
@@ -7,7 +5,6 @@ export interface BaseParametersConstructor {
     modelId: string;
     alias?: string;
     webhookIds?: string[];
-    pollingOptions?: PollingOptions;
     closeFile?: boolean;
 }
 /**
@@ -43,21 +40,12 @@ export declare abstract class BaseParameters {
      * If empty, no webhooks will be used.
      */
     webhookIds?: string[];
-    /**
-     * Client-side polling configuration (see {@link PollingOptions}).
-     */
-    pollingOptions?: PollingOptions;
     /**
      * By default, the file is closed once the upload is finished.
      * Set to `false` to keep it open.
      */
     closeFile?: boolean;
     protected constructor(params: BaseParametersConstructor);
-    /**
-     * Checks the values for asynchronous parsing. Returns their corrected value if they are undefined.
-     * @returns A valid `AsyncOptions`.
-     */
-    getValidatedPollingOptions(): ValidatedPollingOptions;
     /**
      * Returns the form data to send to the API.
      * @returns A `FormData` object.

package/src/v2/client/baseParameters.js

@@ -26,42 +26,6 @@ export class BaseParameters {
         this.alias = params.alias;
         this.webhookIds = params.webhookIds;
         this.closeFile = params.closeFile;
-        this.pollingOptions = params.pollingOptions;
-    }
-    /**
-     * Checks the values for asynchronous parsing. Returns their corrected value if they are undefined.
-     * @returns A valid `AsyncOptions`.
-     */
-    getValidatedPollingOptions() {
-        const minDelaySec = 1;
-        const minInitialDelay = 1;
-        const minRetries = 2;
-        let newAsyncParams;
-        if (this.pollingOptions === undefined) {
-            newAsyncParams = {
-                delaySec: 1.5,
-                initialDelaySec: 2,
-                maxRetries: 80
-            };
-        }
-        else {
-            newAsyncParams = { ...this.pollingOptions };
-            if (!newAsyncParams.delaySec ||
-                !newAsyncParams.initialDelaySec ||
-                !newAsyncParams.maxRetries) {
-                throw Error("Invalid polling options.");
-            }
-            if (newAsyncParams.delaySec < minDelaySec) {
-                throw Error(`Cannot set auto-parsing delay to less than ${minDelaySec} second(s).`);
-            }
-            if (newAsyncParams.initialDelaySec < minInitialDelay) {
-                throw Error(`Cannot set initial parsing delay to less than ${minInitialDelay} second(s).`);
-            }
-            if (newAsyncParams.maxRetries < minRetries) {
-                throw Error(`Cannot set retry to less than ${minRetries}.`);
-            }
-        }
-        return newAsyncParams;
     }
     /**
      * Returns the form data to send to the API.

package/src/v2/client/index.d.ts

@@ -1,2 +1,3 @@
-export type { PollingOptions, ValidatedPollingOptions } from "./pollingOptions.js";
+export { PollingOptions } from "./pollingOptions.js";
+export type { PollingOptionsConstructor } from "./pollingOptions.js";
 export { BaseParameters } from "./baseParameters.js";

package/src/v2/client/index.js

@@ -1 +1,2 @@
+export { PollingOptions } from "./pollingOptions.js";
 export { BaseParameters } from "./baseParameters.js";

package/src/v2/client/pollingOptions.d.ts

@@ -1,3 +1,14 @@
+export interface TimerOptions {
+    ref?: boolean;
+    signal?: AbortSignal;
+}
+export interface PollingOptionsConstructor {
+    initialDelaySec?: number;
+    delaySec?: number;
+    maxRetries?: number;
+    initialTimerOptions?: TimerOptions;
+    recurringTimerOptions?: TimerOptions;
+}
 /**
  * Parameters for the internal polling loop in `enqueueAndGetInference()`.
  *
@@ -24,13 +35,13 @@
  *
  * const inference = await client.enqueueAndGetInference(inputDoc, params);
  */
-export interface PollingOptions {
+export declare class PollingOptions {
     /** Number of seconds to wait *before the first poll*. */
-    initialDelaySec?: number;
+    initialDelaySec: number;
     /** Interval in seconds between two consecutive polls. */
-    delaySec?: number;
+    delaySec: number;
     /** Maximum number of polling attempts (including the first one). */
-    maxRetries?: number;
+    maxRetries: number;
     /** Options passed to the initial `setTimeout()`. */
     initialTimerOptions?: {
         ref?: boolean;
@@ -41,9 +52,7 @@ export interface PollingOptions {
         ref?: boolean;
         signal?: AbortSignal;
     };
-}
-export interface ValidatedPollingOptions extends PollingOptions {
-    initialDelaySec: number;
-    delaySec: number;
-    maxRetries: number;
+    constructor(params?: PollingOptionsConstructor);
+    validateOptions(): void;
+    toString(): string;
 }

package/src/v2/client/pollingOptions.js

@@ -1 +1,78 @@
-export {};
+import { MindeeConfigurationError } from "../../errors/index.js";
+import { logger } from "../../logger.js";
+const minInitialDelay = 1;
+const minDelaySec = 1;
+const minRetries = 2;
+/**
+ * Parameters for the internal polling loop in `enqueueAndGetInference()`.
+ *
+ * Default behavior:
+ * - `initialDelaySec` = 2s
+ * - `delaySec` = 1.5s
+ * - `maxRetries` = 80
+ *
+ * Validation rules:
+ * - `initialDelaySec` >= 1
+ * - `delaySec` >= 1
+ * - `maxRetries` >= 2
+ *
+ * The `initialTimerOptions` and `recurringTimerOptions` objects let you pass an
+ * `AbortSignal` or make the timer `unref`-ed to the `setTimeout()`.
+ *
+ * @category ClientV2
+ * @example
+ * const params = {
+ *   initialDelaySec: 4,
+ *   delaySec: 2,
+ *   maxRetries: 50
+ * };
+ *
+ * const inference = await client.enqueueAndGetInference(inputDoc, params);
+ */
+export class PollingOptions {
+    constructor(params) {
+        if (!params) {
+            params = {};
+        }
+        if (!params.initialDelaySec) {
+            this.initialDelaySec = 2;
+        }
+        else {
+            this.initialDelaySec = params.initialDelaySec;
+        }
+        if (!params.delaySec) {
+            this.delaySec = 1.5;
+        }
+        else {
+            this.delaySec = params.delaySec;
+        }
+        if (!params.maxRetries) {
+            this.maxRetries = 80;
+        }
+        else {
+            this.maxRetries = params.maxRetries;
+        }
+        if (params.initialTimerOptions) {
+            this.initialTimerOptions = params.initialTimerOptions;
+        }
+        if (params.recurringTimerOptions) {
+            this.recurringTimerOptions = params.recurringTimerOptions;
+        }
+        this.validateOptions();
+        logger.debug(`Polling options initialized: ${this.toString()}`);
+    }
+    validateOptions() {
+        if (this.delaySec < minDelaySec) {
+            throw new MindeeConfigurationError(`Cannot set auto-parsing delay to less than ${minDelaySec} second(s).`);
+        }
+        if (this.initialDelaySec < minInitialDelay) {
+            throw new MindeeConfigurationError(`Cannot set initial parsing delay to less than ${minInitialDelay} second(s).`);
+        }
+        if (this.maxRetries < minRetries) {
+            throw new MindeeConfigurationError(`Cannot set retry to less than ${minRetries}.`);
+        }
+    }
+    toString() {
+        return `{ initialDelaySec: ${this.initialDelaySec}, delaySec: ${this.delaySec}, maxRetries: ${this.maxRetries} }`;
+    }
+}

package/src/v2/client.d.ts

@@ -2,7 +2,7 @@ import { Dispatcher } from "undici";
 import { InputSource } from "../input/index.js";
 import { JobResponse } from "./parsing/index.js";
 import { MindeeApiV2 } from "./http/mindeeApiV2.js";
-import { ValidatedPollingOptions } from "./client/index.js";
+import { PollingOptions, PollingOptionsConstructor } from "./client/index.js";
 import { BaseProduct } from "../v2/product/baseProduct.js";
 /**
  * Options for the V2 Mindee Client.
@@ -65,15 +65,16 @@ export declare class Client {
      * @param inputSource file or URL to parse.
      * @param params parameters relating to prediction options.
      *
+     * @param pollingOptions options for the polling loop, see {@link PollingOptions}.
      * @typeParam T an extension of an `Inference`. Can be omitted as it will be inferred from the `productClass`.
      * @category Synchronous
      * @returns a `Promise` containing parsing results.
      */
-    enqueueAndGetResult<P extends typeof BaseProduct>(product: P, inputSource: InputSource, params: InstanceType<P["parametersClass"]> | ConstructorParameters<P["parametersClass"]>[0]): Promise<InstanceType<P["responseClass"]>>;
+    enqueueAndGetResult<P extends typeof BaseProduct>(product: P, inputSource: InputSource, params: InstanceType<P["parametersClass"]> | ConstructorParameters<P["parametersClass"]>[0], pollingOptions?: PollingOptionsConstructor): Promise<InstanceType<P["responseClass"]>>;
     /**
      * Send a document to an endpoint and poll the server until the result is sent or
      * until the maximum number of tries is reached.
      * @protected
      */
-    protected pollForResult<P extends typeof BaseProduct>(product: typeof BaseProduct, pollingOptions: ValidatedPollingOptions, queueId: string): Promise<InstanceType<P["responseClass"]>>;
+    protected pollForResult<P extends typeof BaseProduct>(product: typeof BaseProduct, pollingOptions: PollingOptions, queueId: string): Promise<InstanceType<P["responseClass"]>>;
 }

package/src/v2/client.js

@@ -4,6 +4,7 @@ import { errorHandler } from "../errors/handler.js";
 import { LOG_LEVELS, logger } from "../logger.js";
 import { MindeeApiV2 } from "./http/mindeeApiV2.js";
 import { MindeeHttpErrorV2 } from "./http/errors.js";
+import { PollingOptions } from "./client/index.js";
 /**
  * Mindee Client V2 class that centralizes most basic operations.
  *
@@ -76,15 +77,16 @@ export class Client {
      * @param inputSource file or URL to parse.
      * @param params parameters relating to prediction options.
      *
+     * @param pollingOptions options for the polling loop, see {@link PollingOptions}.
      * @typeParam T an extension of an `Inference`. Can be omitted as it will be inferred from the `productClass`.
      * @category Synchronous
      * @returns a `Promise` containing parsing results.
      */
-    async enqueueAndGetResult(product, inputSource, params) {
+    async enqueueAndGetResult(product, inputSource, params, pollingOptions) {
         const paramsInstance = new product.parametersClass(params);
-        const pollingOptions = paramsInstance.getValidatedPollingOptions();
+        const pollingOptionsInstance = new PollingOptions(pollingOptions);
         const jobResponse = await this.enqueue(product, inputSource, paramsInstance);
-        return await this.pollForResult(product, pollingOptions, jobResponse.job.id);
+        return await this.pollForResult(product, pollingOptionsInstance, jobResponse.job.id);
     }
     /**
      * Send a document to an endpoint and poll the server until the result is sent or
@@ -114,8 +116,7 @@ export class Client {
             await setTimeout(pollingOptions.delaySec * 1000, undefined, pollingOptions.recurringTimerOptions);
             retryCounter++;
         }
-        throw new MindeeError("Asynchronous parsing request timed out after " +
-            pollingOptions.delaySec * retryCounter +
-            " seconds");
+        throw new MindeeError(`Polling failed to retrieve a result after ${retryCounter} attempts. ` +
+            "You can increase poll attempts by passing the pollingOptions argument to enqueueAndGetResult()");
     }
 }

package/src/v2/index.d.ts

@@ -1,7 +1,6 @@
 export * as http from "./http/index.js";
 export * as parsing from "./parsing/index.js";
 export * as product from "./product/index.js";
-export { LocalResponse } from "./parsing/localResponse.js";
 export { Client } from "./client.js";
-export { InferenceFile, InferenceModel, JobResponse, ErrorResponse, } from "./parsing/index.js";
-export type { PollingOptions } from "./client/index.js";
+export { JobResponse, ErrorResponse, LocalResponse, } from "./parsing/index.js";
+export type { PollingOptions, BaseParameters } from "./client/index.js";

package/src/v2/index.js

@@ -1,6 +1,5 @@
 export * as http from "./http/index.js";
 export * as parsing from "./parsing/index.js";
 export * as product from "./product/index.js";
-export { LocalResponse } from "./parsing/localResponse.js";
 export { Client } from "./client.js";
-export { InferenceFile, InferenceModel, JobResponse, ErrorResponse, } from "./parsing/index.js";
+export { JobResponse, ErrorResponse, LocalResponse, } from "./parsing/index.js";

package/src/v2/parsing/inference/baseInference.d.ts

@@ -1,5 +1,5 @@
 import { InferenceModel } from "./inferenceModel.js";
-import { InferenceFile } from "../../../v2/index.js";
+import { InferenceFile } from "./inferenceFile.js";
 import { StringDict } from "../../../parsing/index.js";
 export declare abstract class BaseInference {
     /**

package/src/v2/parsing/inference/baseInference.js

@@ -1,5 +1,5 @@
 import { InferenceModel } from "./inferenceModel.js";
-import { InferenceFile } from "../../../v2/index.js";
+import { InferenceFile } from "./inferenceFile.js";
 export class BaseInference {
     constructor(serverResponse) {
         this.id = serverResponse["id"];