mindee 5.4.0 → 5.6.0

package/src/v1/parsing/common/extras/cropperExtra.d.ts

@@ -1,7 +1,9 @@
 import { PositionField } from "../../../../v1/parsing/standard/position.js";
 import { StringDict } from "../../../../parsing/stringDict.js";
 import { ExtraField } from "./extras.js";
+/** Cropper extra payload returned by compatible APIs. */
 export declare class CropperExtra extends ExtraField {
+    /** Cropped regions detected on the page. */
     cropping: PositionField[];
     constructor(rawPrediction: StringDict, pageId?: number);
     /**

package/src/v1/parsing/common/extras/cropperExtra.js

@@ -1,9 +1,12 @@
 import { PositionField } from "../../../../v1/parsing/standard/position.js";
+// eslint-disable-next-line no-restricted-imports
 import { cleanOutString } from "../summaryHelper.js";
 import { ExtraField } from "./extras.js";
+/** Cropper extra payload returned by compatible APIs. */
 export class CropperExtra extends ExtraField {
     constructor(rawPrediction, pageId) {
         super();
+        /** Cropped regions detected on the page. */
         this.cropping = [];
         if (rawPrediction["cropping"] !== undefined) {
             rawPrediction["cropping"].forEach((crop) => {

package/src/v1/parsing/common/extras/extras.d.ts

@@ -1,9 +1,12 @@
+/** Base class for optional extras attached to predictions. */
 export declare abstract class ExtraField {
 }
 interface ExtraDict<T extends ExtraField> {
     [key: string]: T | (() => string);
 }
+/** Dictionary-like container for extra fields. */
 export declare class Extras<ExtraT extends ExtraField = ExtraField> implements ExtraDict<ExtraT> {
+    /** Dynamic map of extra values keyed by extra name. */
     [key: string]: ExtraT | (() => string);
     constructor(fields: Record<string, ExtraT>);
     /**

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

@@ -1,5 +1,7 @@
+/** Base class for optional extras attached to predictions. */
 export class ExtraField {
 }
+/** Dictionary-like container for extra fields. */
 export class Extras {
     constructor(fields) {
         if (Object.keys(fields).length > 0) {

package/src/v1/parsing/common/extras/fullTextOcrExtra.d.ts

@@ -1,7 +1,10 @@
 import { StringDict } from "../../../../parsing/stringDict.js";
 import { ExtraField } from "./extras.js";
+/** Full-text OCR extra payload returned by compatible APIs. */
 export declare class FullTextOcrExtra extends ExtraField {
+    /** Concatenated OCR content. */
     content?: string;
+    /** OCR language hints associated with the content. */
     languages?: string;
     constructor(rawPrediction: StringDict);
     /**

package/src/v1/parsing/common/extras/fullTextOcrExtra.js

@@ -1,4 +1,5 @@
 import { ExtraField } from "./extras.js";
+/** Full-text OCR extra payload returned by compatible APIs. */
 export class FullTextOcrExtra extends ExtraField {
     constructor(rawPrediction) {
         super();

package/src/v1/parsing/common/extras/ragExtra.d.ts

@@ -1,5 +1,6 @@
 import { ExtraField } from "./extras.js";
 import { StringDict } from "../../../../parsing/stringDict.js";
+/** RAG extra payload returned by compatible APIs. */
 export declare class RAGExtra extends ExtraField {
     /**
      * ID reference of the document matched by the Retrieval-Augmented Generation.

package/src/v1/parsing/common/extras/ragExtra.js

@@ -1,4 +1,5 @@
 import { ExtraField } from "./extras.js";
+/** RAG extra payload returned by compatible APIs. */
 export class RAGExtra extends ExtraField {
     constructor(rawPrediction) {
         super();

package/src/v1/parsing/common/feedback/feedbackResponse.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports
 import { ApiResponse } from "../apiResponse.js";
 /**
  * Wrapper for feedback response.

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

@@ -10,7 +10,7 @@ export { AsyncPredictResponse } from "./asyncPredictResponse.js";
 export { PredictResponse } from "./predictResponse.js";
 export { Prediction } from "./prediction.js";
 export { Page } from "./page.js";
-export { cleanOutString, lineSeparator, floatToString, cleanSpecialChars } from "./summaryHelper.js";
+export { cleanOutString, lineSeparator, floatToString, cleanSpecialChars, cleanAndTruncate } from "./summaryHelper.js";
 export * as extras from "./extras/index.js";
 export { parseDate } from "../../../parsing/dateParser.js";
 export { WorkflowResponse } from "./workflowResponse.js";

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

@@ -9,7 +9,7 @@ export { AsyncPredictResponse } from "./asyncPredictResponse.js";
 export { PredictResponse } from "./predictResponse.js";
 export { Prediction } from "./prediction.js";
 export { Page } from "./page.js";
-export { cleanOutString, lineSeparator, floatToString, cleanSpecialChars } from "./summaryHelper.js";
+export { cleanOutString, lineSeparator, floatToString, cleanSpecialChars, cleanAndTruncate } from "./summaryHelper.js";
 export * as extras from "./extras/index.js";
 export { parseDate } from "../../../parsing/dateParser.js";
 export { WorkflowResponse } from "./workflowResponse.js";

package/src/v1/parsing/common/inference.d.ts

@@ -4,6 +4,7 @@ import type { Prediction } from "./prediction.js";
 import { Product } from "./product.js";
 import { Extras } from "./extras/index.js";
 /**
+ * Generic base class for parsed v1 inference payloads.
  *
  * @typeParam DocT an extension of a `Prediction`. Is generic by default to
  * allow for easier optional `PageT` generic typing.
@@ -29,6 +30,7 @@ export declare abstract class Inference<DocT extends Prediction = Prediction, Pa
     /**
      * Default string representation.
      */
+    /** Returns a human-readable representation of the inference payload. */
     toString(): string;
     /**
      * Takes in an input string and replaces line breaks with `\n`.

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

@@ -1,6 +1,7 @@
 import { CropperExtra, FullTextOcrExtra, RAGExtra } from "./extras/index.js";
 import { MindeeConfigurationError } from "../../../errors/index.js";
 /**
+ * Generic base class for parsed v1 inference payloads.
  *
  * @typeParam DocT an extension of a `Prediction`. Is generic by default to
  * allow for easier optional `PageT` generic typing.
@@ -35,6 +36,7 @@ export class Inference {
     /**
      * Default string representation.
      */
+    /** Returns a human-readable representation of the inference payload. */
     toString() {
         let pages = "";
         if (this.pages.toString().length > 0) {

package/src/v1/parsing/common/prediction.d.ts

@@ -1,2 +1,3 @@
+/** Marker base type for v1 prediction payload models. */
 export declare class Prediction {
 }

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

@@ -1,2 +1,3 @@
+/** Marker base type for v1 prediction payload models. */
 export class Prediction {
 }

package/src/v1/parsing/common/summaryHelper.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Cleans a string by removing all new line characters.
+ * @param outStr Output string.
+ */
 export declare function cleanOutString(outStr: string): string;
 /**
  *
@@ -9,9 +13,16 @@ export declare function lineSeparator(columnSizes: number[], separator: string):
 /**
  * Replaces all special characters like \n, \r, \t, with an equivalent that can be displayed on a single line.
  * Also trims line breaks at the end of the string.
- * @param outStr
+ * @param outStr Output string.
  */
 export declare function cleanSpecialChars(outStr: string): string;
+/**
+ * Cleans a string with `cleanSpecialChars` and truncates it to `maxLength` characters,
+ * appending "..." when truncation occurs. Returns an empty string for null/undefined/empty input.
+ * @param value String to clean and truncate.
+ * @param maxLength Maximum length of the returned string (including the "..." suffix when truncated).
+ */
+export declare function cleanAndTruncate(value: string | null | undefined, maxLength: number): string;
 /**
  * Return a float as a string with at least 2 levels of precision.
  */

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

@@ -1,3 +1,7 @@
+/**
+ * Cleans a string by removing all new line characters.
+ * @param outStr Output string.
+ */
 export function cleanOutString(outStr) {
     const lines = / \n/gm;
     return outStr.replace(lines, "\n");
@@ -18,7 +22,7 @@ export function lineSeparator(columnSizes, separator) {
 /**
  * Replaces all special characters like \n, \r, \t, with an equivalent that can be displayed on a single line.
  * Also trims line breaks at the end of the string.
- * @param outStr
+ * @param outStr Output string.
  */
 export function cleanSpecialChars(outStr) {
     return outStr
@@ -26,6 +30,19 @@ export function cleanSpecialChars(outStr) {
         .replace(/\r/g, "\\r")
         .replace(/\t/g, "\\t");
 }
+/**
+ * Cleans a string with `cleanSpecialChars` and truncates it to `maxLength` characters,
+ * appending "..." when truncation occurs. Returns an empty string for null/undefined/empty input.
+ * @param value String to clean and truncate.
+ * @param maxLength Maximum length of the returned string (including the "..." suffix when truncated).
+ */
+export function cleanAndTruncate(value, maxLength) {
+    if (!value) {
+        return "";
+    }
+    const cleaned = cleanSpecialChars(value);
+    return cleaned.length <= maxLength ? cleaned : cleaned.slice(0, maxLength - 3) + "...";
+}
 /**
  * Return a float as a string with at least 2 levels of precision.
  */

package/src/v1/parsing/generated/generatedObject.d.ts

@@ -13,6 +13,10 @@ export declare class GeneratedObjectField {
     /** All potentially present fields. */
     [key: string]: string | number | boolean | object | undefined;
     constructor({ prediction, pageId, }: BaseFieldConstructor);
+    private static readonly positionFieldNames;
+    private static isPositionField;
+    private assignPositionField;
+    private assignScalarField;
     /**
      * ReSTructured-compliant string representation.
      Takes into account level of indentation & displays elements as list elements.
@@ -25,7 +29,9 @@ export declare class GeneratedObjectField {
      * @returns
      */
     private toNumberString;
+    /** Returns the default string representation. */
     toString(): string;
+    /** Returns a field value by key from this generated object. */
     get(fieldName: string): string | number | boolean | object | undefined;
 }
 /**

package/src/v1/parsing/generated/generatedObject.js

@@ -8,44 +8,50 @@ export class GeneratedObjectField {
             if (fieldName === "page_id") {
                 itemPageId = fieldValue;
             }
-            else if (["polygon", "rectangle", "quadrangle", "bounding_box"].includes(fieldName)) {
-                Object.assign(this, {
-                    [fieldName]: new PositionField({
-                        prediction: { [fieldName]: fieldValue },
-                        valueKey: fieldName,
-                        pageId: pageId,
-                    }),
-                });
-                this.printableValues.push(fieldName);
-            }
             else if (fieldName === "confidence") {
                 this.confidence = fieldValue;
             }
             else if (fieldName === "raw_value") {
                 this.rawValue = fieldValue;
             }
+            else if (GeneratedObjectField.isPositionField(fieldName)) {
+                this.assignPositionField(fieldName, fieldValue, pageId);
+            }
             else {
-                if (fieldValue !== null &&
-                    fieldValue !== undefined &&
-                    typeof fieldValue === "number" &&
-                    !isNaN(fieldValue) &&
-                    fieldName !== "degrees") {
-                    Object.assign(this, { [fieldName]: this.toNumberString(fieldValue) });
-                }
-                else if (typeof fieldValue === "boolean") {
-                    Object.assign(this, { [fieldName]: fieldValue });
-                }
-                else {
-                    Object.assign(this, {
-                        [fieldName]: (fieldValue !== undefined && fieldValue !== null) ?
-                            String(fieldValue) : null,
-                    });
-                }
-                this.printableValues.push(fieldName);
+                this.assignScalarField(fieldName, fieldValue);
             }
             this.pageId = pageId ?? itemPageId;
         }
     }
+    static isPositionField(fieldName) {
+        return GeneratedObjectField.positionFieldNames.has(fieldName);
+    }
+    assignPositionField(fieldName, fieldValue, pageId) {
+        Object.assign(this, {
+            [fieldName]: new PositionField({
+                prediction: { [fieldName]: fieldValue },
+                valueKey: fieldName,
+                pageId: pageId,
+            }),
+        });
+        this.printableValues.push(fieldName);
+    }
+    assignScalarField(fieldName, fieldValue) {
+        if (typeof fieldValue === "number" &&
+            !isNaN(fieldValue) &&
+            fieldName !== "degrees") {
+            Object.assign(this, { [fieldName]: this.toNumberString(fieldValue) });
+        }
+        else if (typeof fieldValue === "boolean") {
+            Object.assign(this, { [fieldName]: fieldValue });
+        }
+        else {
+            Object.assign(this, {
+                [fieldName]: (fieldValue !== undefined && fieldValue !== null) ? String(fieldValue) : null,
+            });
+        }
+        this.printableValues.push(fieldName);
+    }
     /**
      * ReSTructured-compliant string representation.
      Takes into account level of indentation & displays elements as list elements.
@@ -71,13 +77,18 @@ export class GeneratedObjectField {
         }
         return n.toString();
     }
+    /** Returns the default string representation. */
     toString() {
         return this.toStringLevel();
     }
+    /** Returns a field value by key from this generated object. */
     get(fieldName) {
         return this[fieldName];
     }
 }
+GeneratedObjectField.positionFieldNames = new Set([
+    "polygon", "rectangle", "quadrangle", "bounding_box",
+]);
 /**
  * Checks whether a field is a custom object or not.
  * @param strDict input dictionary to check.

package/src/v1/parsing/localResponse.d.ts

@@ -6,5 +6,6 @@ import { StringDict } from "../../parsing/index.js";
  * Note: Has to be initialized through init() before use.
  */
 export declare class LocalResponse extends LocalResponseBase {
+    /** Loads a local JSON payload into a typed prediction response wrapper. */
     loadPrediction<T extends Inference>(productClass: new (httpResponse: StringDict) => T): Promise<AsyncPredictResponse<T> | PredictResponse<T>>;
 }

package/src/v1/parsing/localResponse.js

@@ -6,6 +6,7 @@ import { MindeeError } from "../../errors/index.js";
  * Note: Has to be initialized through init() before use.
  */
 export class LocalResponse extends LocalResponseBase {
+    /** Loads a local JSON payload into a typed prediction response wrapper. */
     async loadPrediction(productClass) {
         /**
          * Load a prediction.

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

@@ -5,10 +5,15 @@ import { StringDict } from "../../../parsing/stringDict.js";
  * @property {boolean} reconstructed - Is the object reconstructed (not extracted by the API).
  * @property {number} pageId - Page ID for multi-page document.
  */
+/** Constructor payload shared by standard v1 fields. */
 export interface BaseFieldConstructor {
+    /** Raw field payload from API response. */
     prediction: StringDict;
+    /** Key to read from `prediction` as field value. */
     valueKey?: string;
+    /** Whether the field was reconstructed locally. */
     reconstructed?: boolean;
+    /** Optional page identifier for multi-page documents. */
     pageId?: number;
 }
 /**
@@ -25,6 +30,7 @@ export declare class BaseField {
      * @param {BaseFieldConstructor} constructor Constructor parameters.
      */
     constructor({ prediction, valueKey, reconstructed, pageId, }: BaseFieldConstructor);
+    /** Compares two field values for semantic equality. */
     compare(other: BaseField): boolean;
     /**
      * @param {BaseField[]} array - Array of Fields

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

@@ -17,6 +17,7 @@ export class BaseField {
             this.pageId = pageId !== undefined ? pageId : prediction["page_id"];
         }
     }
+    /** Compares two field values for semantic equality. */
     compare(other) {
         if (this.value === null && other.value === null)
             return true;

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

@@ -4,7 +4,7 @@ export interface FieldConstructor {
     prediction: StringDict;
     valueKey?: string;
     reconstructed?: boolean;
-    pageId?: number | undefined;
+    pageId?: number;
 }
 /**
  * A field containing a text value.

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

@@ -9,6 +9,7 @@ export declare class CompanyRegistrationField extends Field {
     /** Type of company registration. */
     type: string;
     constructor({ prediction, valueKey, reconstructed, pageId, }: BaseFieldConstructor);
+    /** Returns a row-formatted representation for table output. */
     toTableLine(): string;
     toString(): string;
     private printableValues;

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

@@ -8,6 +8,7 @@ export class CompanyRegistrationField extends Field {
         super({ prediction, valueKey, reconstructed, pageId });
         this.type = prediction["type"];
     }
+    /** Returns a row-formatted representation for table output. */
     toTableLine() {
         const printable = this.printableValues();
         return `| ${printable["type"].padEnd(15)} | ${printable["value"].padEnd(20)} `;

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

@@ -14,5 +14,6 @@ export declare class DateField extends Field {
      * @param {BaseFieldConstructor} constructor Constructor parameters.
      */
     constructor({ prediction, valueKey, reconstructed, pageId, }: BaseFieldConstructor);
+    /** Compares two dates by calendar day (year/month/day). */
     static compareDates(date1: Date, date2: Date): boolean;
 }

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

@@ -23,6 +23,7 @@ export class DateField extends Field {
             }
         }
     }
+    /** Compares two dates by calendar day (year/month/day). */
     static compareDates(date1, date2) {
         return date1.getFullYear() === date2.getFullYear() &&
             date1.getMonth() === date2.getMonth() &&

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

@@ -26,15 +26,15 @@ interface PaymentDetailsConstructor {
 export declare class PaymentDetailsField extends Field {
     #private;
     /** Synonym for the `iban` property */
-    value?: string | undefined;
+    value?: string;
     /** The account number. */
-    accountNumber: string | undefined;
+    accountNumber?: string;
     /** The International Bank Account Number (IBAN). */
-    iban: string | undefined;
+    iban?: string;
     /** The routing number. */
-    routingNumber: string | undefined;
+    routingNumber?: string;
     /** The bank's SWIFT Business Identifier Code (BIC). */
-    swift: string | undefined;
+    swift?: string;
     /**
      * @param {PaymentDetailsConstructor} constructor Constructor parameters.
      */

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

@@ -3,7 +3,7 @@ import { Polygon } from "../../../geometry/index.js";
 export interface PositionFieldConstructor {
     prediction: StringDict;
     valueKey?: string;
-    pageId?: number | undefined;
+    pageId?: number;
 }
 /**
  * A field indicating a position or area on the document.
@@ -18,7 +18,7 @@ export declare class PositionField {
     /** Rectangle that may be oriented (can go beyond the canvas). */
     rectangle: Polygon;
     /** The document page on which the information was found. */
-    pageId: number | undefined;
+    pageId?: number;
     constructor({ prediction, pageId }: PositionFieldConstructor);
     /**
      * Default string representation.

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

@@ -44,6 +44,7 @@ export declare class TaxField extends Field {
  */
 export declare class Taxes extends Array<TaxField> {
     #private;
+    /** Populates the taxes collection from raw prediction entries. */
     init(prediction: StringDict[] | undefined, pageId: number | undefined): this;
     /**
      * Default string representation.

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

@@ -86,6 +86,7 @@ export class Taxes extends Array {
         super(...arguments);
         _Taxes_instances.add(this);
     }
+    /** Populates the taxes collection from raw prediction entries. */
     init(prediction = [], pageId) {
         for (const entry of prediction) {
             this.push(new TaxField({

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

@@ -4,7 +4,7 @@ export interface FieldConstructor {
     prediction: StringDict;
     valueKey?: string;
     reconstructed?: boolean;
-    pageId?: number | undefined;
+    pageId?: number;
 }
 /**
  * A field containing a text value.

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

@@ -1,12 +1,15 @@
 import { Polygon } from "../../../geometry/index.js";
 import { StringDict } from "../../../parsing/index.js";
+/** OCR word item with text, confidence, and location polygon. */
 export declare class Word {
     /**
      * Contains the relative vertices coordinates (points) of a polygon containing
      * the field in the document.
      */
     polygon: Polygon;
+    /** OCR text content for the word. */
     text: string;
+    /** Confidence score for the OCR word. */
     confidence: number;
     constructor(rawPrediction: StringDict);
 }

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

@@ -1,4 +1,5 @@
 import { Polygon } from "../../../geometry/index.js";
+/** OCR word item with text, confidence, and location polygon. */
 export class Word {
     constructor(rawPrediction) {
         this.polygon = new Polygon(...rawPrediction["polygon"]);

package/src/v1/product/financialDocument/financialDocumentV1LineItem.js

@@ -3,8 +3,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _FinancialDocumentV1LineItem_instances, _FinancialDocumentV1LineItem_printableValues;
-import { cleanSpecialChars, floatToString } from "../../../v1/parsing/common/index.js";
+var _FinancialDocumentV1LineItem_instances, _a, _FinancialDocumentV1LineItem_parseNumber, _FinancialDocumentV1LineItem_printableValues;
+import { cleanAndTruncate, floatToString } from "../../../v1/parsing/common/index.js";
 import { Polygon } from "../../../geometry/index.js";
 /**
  * List of line item present on the document.
@@ -21,47 +21,12 @@ export class FinancialDocumentV1LineItem {
         this.polygon = new Polygon();
         this.description = prediction["description"];
         this.productCode = prediction["product_code"];
-        if (prediction["quantity"] !== undefined &&
-            prediction["quantity"] !== null &&
-            !isNaN(prediction["quantity"])) {
-            this.quantity = +parseFloat(prediction["quantity"]);
-        }
-        else {
-            this.quantity = null;
-        }
-        if (prediction["tax_amount"] !== undefined &&
-            prediction["tax_amount"] !== null &&
-            !isNaN(prediction["tax_amount"])) {
-            this.taxAmount = +parseFloat(prediction["tax_amount"]);
-        }
-        else {
-            this.taxAmount = null;
-        }
-        if (prediction["tax_rate"] !== undefined &&
-            prediction["tax_rate"] !== null &&
-            !isNaN(prediction["tax_rate"])) {
-            this.taxRate = +parseFloat(prediction["tax_rate"]);
-        }
-        else {
-            this.taxRate = null;
-        }
-        if (prediction["total_amount"] !== undefined &&
-            prediction["total_amount"] !== null &&
-            !isNaN(prediction["total_amount"])) {
-            this.totalAmount = +parseFloat(prediction["total_amount"]);
-        }
-        else {
-            this.totalAmount = null;
-        }
+        this.quantity = __classPrivateFieldGet(_a, _a, "m", _FinancialDocumentV1LineItem_parseNumber).call(_a, prediction["quantity"]);
+        this.taxAmount = __classPrivateFieldGet(_a, _a, "m", _FinancialDocumentV1LineItem_parseNumber).call(_a, prediction["tax_amount"]);
+        this.taxRate = __classPrivateFieldGet(_a, _a, "m", _FinancialDocumentV1LineItem_parseNumber).call(_a, prediction["tax_rate"]);
+        this.totalAmount = __classPrivateFieldGet(_a, _a, "m", _FinancialDocumentV1LineItem_parseNumber).call(_a, prediction["total_amount"]);
         this.unitMeasure = prediction["unit_measure"];
-        if (prediction["unit_price"] !== undefined &&
-            prediction["unit_price"] !== null &&
-            !isNaN(prediction["unit_price"])) {
-            this.unitPrice = +parseFloat(prediction["unit_price"]);
-        }
-        else {
-            this.unitPrice = null;
-        }
+        this.unitPrice = __classPrivateFieldGet(_a, _a, "m", _FinancialDocumentV1LineItem_parseNumber).call(_a, prediction["unit_price"]);
         this.pageId = prediction["page_id"];
         this.confidence = prediction["confidence"] ? prediction.confidence : 0.0;
         if (prediction["polygon"]) {
@@ -114,27 +79,20 @@ export class FinancialDocumentV1LineItem {
             " |");
     }
 }
-_FinancialDocumentV1LineItem_instances = new WeakSet(), _FinancialDocumentV1LineItem_printableValues = function _FinancialDocumentV1LineItem_printableValues() {
+_a = FinancialDocumentV1LineItem, _FinancialDocumentV1LineItem_instances = new WeakSet(), _FinancialDocumentV1LineItem_parseNumber = function _FinancialDocumentV1LineItem_parseNumber(value) {
+    if (value === undefined || value === null || isNaN(value)) {
+        return null;
+    }
+    return +parseFloat(value);
+}, _FinancialDocumentV1LineItem_printableValues = function _FinancialDocumentV1LineItem_printableValues() {
     return {
-        description: this.description ?
-            this.description.length <= 36 ?
-                cleanSpecialChars(this.description) :
-                cleanSpecialChars(this.description).slice(0, 33) + "..." :
-            "",
-        productCode: this.productCode ?
-            this.productCode.length <= 12 ?
-                cleanSpecialChars(this.productCode) :
-                cleanSpecialChars(this.productCode).slice(0, 9) + "..." :
-            "",
+        description: cleanAndTruncate(this.description, 36),
+        productCode: cleanAndTruncate(this.productCode, 12),
         quantity: this.quantity !== undefined ? floatToString(this.quantity) : "",
         taxAmount: this.taxAmount !== undefined ? floatToString(this.taxAmount) : "",
         taxRate: this.taxRate !== undefined ? floatToString(this.taxRate) : "",
         totalAmount: this.totalAmount !== undefined ? floatToString(this.totalAmount) : "",
-        unitMeasure: this.unitMeasure ?
-            this.unitMeasure.length <= 15 ?
-                cleanSpecialChars(this.unitMeasure) :
-                cleanSpecialChars(this.unitMeasure).slice(0, 12) + "..." :
-            "",
+        unitMeasure: cleanAndTruncate(this.unitMeasure, 15),
         unitPrice: this.unitPrice !== undefined ? floatToString(this.unitPrice) : "",
     };
 };

package/src/v1/product/generated/generatedV1Prediction.d.ts

@@ -1,6 +1,7 @@
 import { Prediction } from "../../../v1/parsing/common/index.js";
 import { GeneratedListField } from "../../../v1/parsing/generated/index.js";
 import { StringField } from "../../../v1/parsing/standard/index.js";
+/** Dynamic prediction container for generated v1 products. */
 export declare class GeneratedV1Prediction implements Prediction {
     /** Map of all fields in the document. */
     fields: Map<string, any>;