mindee 4.7.0.pre.rc3 → 4.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98d48175f2f2787a85bf193ac18cb41f569b3ffa7fcd609508662380b50b5a49
-  data.tar.gz: bf3670916d3c4be7c865184d5350c3a397ef0c9d4f3d014b16d837e91ce23ff5
+  metadata.gz: 35d4295c966072c96459d8875cad5795c333a4a115dc25670e350db20ec8c4ae
+  data.tar.gz: 07e8e9b002996da15e742d6f5607bcd651cec10e3ca1f7218b9e1e0d764e0900
 SHA512:
-  metadata.gz: 6bc3903e692541cedb045eefc597d47b6eddea1eb5a146ede8c80766ff6e5f8d59e285ab5a366ea1a673c4092c1670cf5e72504403082ba851416a9670ccc3eb
-  data.tar.gz: 18cc292275a5dbff543327d6eac8954ee1ebb206f7e361bc2b576cff7948ae6d637fc78c78ff8d1146ba3fbc2d453c5ff99b58538f739c8b153c0fdf78304412
+  metadata.gz: c2f326f4e1df9fe406fd625fc557bc5212dcffccb349744e0ba68ae734f9d5ed21cf0cb5381a2a6408aa5fd7f5ff0d462dda42c0295c91a5d514340454404d22
+  data.tar.gz: 61807c6f40dbc3955ffb519ee1f5a3698fb4a67048fa9ebec0e284b36e260e2c042b5b9f8cedd7d895587d43501c1d34d8d0909c82681f430a43dc0fed40fa90

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Mindee Ruby API Library Changelog
 
+## v4.7.0 - 2025-09-18
+Including RC changes and fixes. 
+### Changes
+* :sparkles: add support for V2 Mindee API
+* :sparkles: add missing accessors for PDF fixing options in `LocalInputSource`
+* :recycle: add many missing internal types
+### Fixes
+* :recycle: update existing PDF fixing syntax
+* :bug: fix for polygon points not correctly initialized
+* :bug: fix user agent not being able to access version number
+* :bug: fix invalid types for many V1 features
+* :bug: fix V1 errors sometimes having the wrong code
+* :bug: fix many presumably immutable fields having non-readonly parameters
+* :bug: fix broken `resources` accessor in `ApiRequest` object
+
+
 ## v4.7.0-rc3 - 2025-08-29
 ### Fixes
 * :bug: fix user agent not being able to access version number
@@ -16,7 +32,6 @@
 ## v4.7.0-rc1 - 2025-08-13
 ### Changes
 * :sparkles: add support for client V2 & associated features
-
 ### Fixes
 * :recycle: add many missing internal types
 * :bug: fix invalid types for many V1 features
@@ -178,7 +193,6 @@
 * :sparkles: add support for cropper Extra
 * :sparkles: add support for full text Extra
 * :sparkles: add support for invoice splitter auto-extraction
-
 ### Fixes
 * :bug: fixed a bug that prevented longer decimals from appearing in the string representation of some objects
 * :bug: fixed a bug that caused non-table elements to unexpectedly appear truncated when printed to the console
@@ -249,7 +263,6 @@
 * :sparkles: add support for EU Driver License V1
 * :recycle: update existing products
 * :arrow_up: upgrade test lib
-
 ### Fixes
 * :memo: add missing default async sample code
 * :bug: fix rst display issues
@@ -277,7 +290,6 @@
 * :sparkles: add support for Carte Grise V1
 * :sparkles: add page number attributes to doc
 * :arrow_up: update tests, docs & display format for some products
-
 ### Fixes
 * :bug: fix page id not working on newer custom models
 
@@ -293,7 +305,6 @@
 * :sparkles: add direct access to `raw_http` response
 * :memo: upgrade reference & guide documentation
 * :test_tube: **EXPERIMENTAL** add PDF repair option
-
 ### Fixes
 * :bug: fix display issues with `PositionField`
 
@@ -308,7 +319,6 @@
 * :sparkles: add support for US Driver License
 * :recycle: update unit tests & dependencies
 * :arrow_up: update Bank Checks (#46)
-
 ### Fixes
 * :bug: fix `all_words` display (#47)
 * :bug: fix empty `position_field` (#47)
@@ -323,7 +333,6 @@
 * :recycle: harmonize naming with other client libraries
 * :art: moved most parsing modules into their own respective modules
 * :art: separated common, standard & custom parsing features into their own modules
-
 ### Changes
 * :sparkles: add support for asynchronous endpoints
 * :sparkles: add support for Invoice Splitter V1
@@ -337,7 +346,6 @@
 * :pencil2: document all previously non-documented class
 * :recycle: match file hierarchy with module nesting
 * :recycle: rewrite tutorials to match new syntax
-
 ### Fixes
 * :bug: fix: pages now use the proper `orientation` property
 * :zap: optimize: only a single endpoint is now created on document upload
@@ -374,8 +382,7 @@
 * :boom: it should be up to the user to handle API errors
 * :wastebasket: remove deprecated APIs
 * :recycle: refactor CLI tool
-
-### Additions
+### Changes
 * :sparkles: add support for Invoice v4.1 and Receipt v4.1
 * :sparkles: add EU license plates
 * :sparkles: add shipping containers support

data/docs/code_samples/default_v2.txt

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'mindee'
 
 input_path = '/path/to/the/file.ext'
@@ -11,8 +13,18 @@ mindee_client = Mindee::ClientV2.new(api_key: api_key)
 inference_params = Mindee::Input::InferenceParameters.new(
     # ID of the model, required.
     model_id,
-    # If set to `true`, will enable Retrieval-Augmented Generation.
-    rag: false,
+
+    # Options: set to `true` or `false` to override defaults
+
+    # Enhance extraction accuracy with Retrieval-Augmented Generation.
+    rag: nil,
+    # Extract the full text content from the document as strings.
+    raw_text: nil,
+    # Calculate bounding box polygons for all fields.
+    polygon: nil,
+    # Boost the precision and accuracy of all extractions.
+    # Calculate confidence scores for all fields.
+    confidence: nil
 )
 
 # Load a file from disk

data/lib/mindee/geometry/polygon.rb

@@ -5,6 +5,15 @@ module Mindee
   module Geometry
     # Contains any number of vertex coordinates (Points).
     class Polygon < Array
+      # @param server_response [Hash] Raw server response hash.
+      def initialize(server_response)
+        points = []
+        server_response.map do |point|
+          points << Point.new(point[0], point[1])
+        end
+        super(points)
+      end
+
       # Get the central point (centroid) of the polygon.
       # @return [Mindee::Geometry::Point]
       def centroid

data/lib/mindee/geometry/utils.rb

@@ -17,19 +17,6 @@ module Mindee
       )
     end
 
-    # Transform a prediction into a Polygon.
-    # @param prediction [Hash]
-    # @return [Mindee::Geometry::Polygon]
-    def self.polygon_from_prediction(prediction)
-      polygon = Polygon.new
-      return polygon if prediction.nil?
-
-      prediction.each do |point|
-        polygon << Point.new(point[0], point[1])
-      end
-      polygon
-    end
-
     # Gets the points of a bounding box for a given set of points
     # @param vertices [Array<Mindee::Geometry::Point>]
     # @return [Array<Float>]
@@ -39,7 +26,7 @@ module Mindee
       [x_coords.min, y_coords.min, x_coords.max, y_coords.max]
     end
 
-    # Creates the bounding bounding box for a given set of points
+    # Creates the bounding box for a given set of points
     # @param vertices [Array<Mindee::Geometry::Point>]
     # @return [Mindee::Geometry::Quadrilateral]
     def self.get_bounding_box(vertices)

data/lib/mindee/http/mindee_api_v2.rb

@@ -123,8 +123,14 @@ module Mindee
                       file_data, file_metadata = input_source.read_contents(close: params.close_file)
                       [['file', file_data, file_metadata]] # : Array[untyped]
                     end
-        form_data.push ['model_id', params.model_id]
-        form_data.push ['rag', 'true'] if params.rag
+        form_data.push(['model_id', params.model_id])
+
+        # deal with optional features
+        form_data.push(['rag', params.rag.to_s]) unless params.rag.nil?
+        form_data.push(['raw_text', params.raw_text.to_s]) unless params.raw_text.nil?
+        form_data.push(['polygon', params.polygon.to_s]) unless params.polygon.nil?
+        form_data.push(['confidence', params.confidence.to_s]) unless params.confidence.nil?
+
         form_data.push ['file_alias', params.file_alias] if params.file_alias
         unless params.webhook_ids.nil? || params.webhook_ids.empty?
           form_data.push ['webhook_ids', params.webhook_ids.join(',')]

data/lib/mindee/input/inference_parameters.rb

@@ -7,9 +7,21 @@ module Mindee
       # @return [String] ID of the model (required).
       attr_reader :model_id
 
-      # @return [Boolean, nil] Enable Retrieval-Augmented Generation.
+      # @return [Boolean, nil] Enhance extraction accuracy with Retrieval-Augmented Generation.
       attr_reader :rag
 
+      # @return [Boolean, nil] Extract the full text content from the document as strings,
+      #   and fill the raw_text` attribute.
+      attr_reader :raw_text
+
+      # @return [Boolean, nil] Calculate bounding box polygons for all fields,
+      #   and fill their `locations` attribute.
+      attr_reader :polygon
+
+      # @return [Boolean, nil] Boost the precision and accuracy of all extractions.
+      #   Calculate confidence scores for all fields, and fill their confidence attribute.
+      attr_reader :confidence
+
       # @return [String, nil] Optional alias for the file.
       attr_reader :file_alias
 
@@ -22,21 +34,39 @@ module Mindee
       # @return [Boolean, nil] Whether to close the file after parsing.
       attr_reader :close_file
 
+      # rubocop:disable Metrics/ParameterLists
       # @param [String] model_id ID of the model
-      # @param [FalseClass] rag Whether to enable rag.
+      # @param [nil] rag Whether to enable RAG.
+      # @param [nil] raw_text Whether to enable rax text.
+      # @param [nil] polygon Whether to enable polygons.
+      # @param [nil] confidence Whether to enable confidence scores.
       # @param [nil] file_alias File alias, if applicable.
       # @param [nil] webhook_ids
       # @param [nil] polling_options
       # @param [TrueClass] close_file
-      def initialize(model_id, rag: false, file_alias: nil, webhook_ids: nil, polling_options: nil, close_file: true)
+      def initialize(
+        model_id,
+        rag: nil,
+        raw_text: nil,
+        polygon: nil,
+        confidence: nil,
+        file_alias: nil,
+        webhook_ids: nil,
+        polling_options: nil,
+        close_file: true
+      )
         raise Errors::MindeeInputError, 'Model ID is required.' if model_id.empty? || model_id.nil?
 
         @model_id = model_id
-        @rag = rag || false
+        @rag = rag
+        @raw_text = raw_text
+        @polygon = polygon
+        @confidence = confidence
         @file_alias = file_alias
         @webhook_ids = webhook_ids || []
         @polling_options = get_clean_polling_options(polling_options)
         @close_file = close_file.nil? || close_file
+        # rubocop:enable Metrics/ParameterLists
       end
 
       # Validates the parameters for async auto-polling
@@ -70,7 +100,10 @@ module Mindee
         end
 
         model_id = params.fetch(:model_id)
-        rag = params.fetch(:rag, false)
+        rag = params.fetch(:rag, nil)
+        raw_text = params.fetch(:raw_text, nil)
+        polygon = params.fetch(:polygon, nil)
+        confidence = params.fetch(:confidence, nil)
         file_alias = params.fetch(:file_alias, nil)
         webhook_ids = params.fetch(:webhook_ids, [])
         polling_options_input = params.fetch(:page_options, PollingOptions.new)
@@ -83,8 +116,8 @@ module Mindee
           )
         end
         close_file = params.fetch(:close_file, true)
-        InferenceParameters.new(model_id, rag: rag, file_alias: file_alias, webhook_ids: webhook_ids,
-                                          close_file: close_file)
+        InferenceParameters.new(model_id, rag: rag, raw_text: raw_text, polygon: polygon, confidence: confidence,
+                                          file_alias: file_alias, webhook_ids: webhook_ids, close_file: close_file)
       end
 
       private

data/lib/mindee/parsing/common/ocr/ocr.rb

@@ -23,7 +23,7 @@ module Mindee
           def initialize(prediction)
             @text = prediction['text']
             @confidence = prediction['confidence']
-            @polygon = Geometry.polygon_from_prediction(prediction['polygon'])
+            @polygon = Mindee::Geometry::Polygon.new(prediction['polygon'])
             @bounding_box = Geometry.get_bounding_box(@polygon) unless @polygon.nil? || @polygon.empty?
           end
 

data/lib/mindee/parsing/standard/abstract_field.rb

@@ -21,7 +21,7 @@ module Mindee
         # @param page_id [Integer, nil]
         def initialize(prediction, page_id)
           @confidence = prediction['confidence'] if prediction.key?('confidence')
-          @polygon = Geometry.polygon_from_prediction(prediction['polygon']) if prediction.key?('polygon')
+          @polygon = Mindee::Geometry::Polygon.new(prediction['polygon']) if prediction.key?('polygon')
           @bounding_box = Geometry.get_bounding_box(@polygon) unless @polygon.nil? || @polygon.empty?
           @page_id = page_id || prediction['page_id']
         end

data/lib/mindee/parsing/standard/position_field.rb

@@ -20,7 +20,7 @@ module Mindee
         # @param page_id [Integer, nil]
         def initialize(prediction, page_id)
           unless prediction['polygon'].nil? || prediction['polygon'].empty?
-            @polygon = Geometry.polygon_from_prediction(prediction['polygon'])
+            @polygon = Mindee::Geometry::Polygon.new(prediction['polygon'])
           end
           @quadrangle = to_quadrilateral(prediction, 'quadrangle')
           @rectangle = to_quadrilateral(prediction, 'rectangle')

data/lib/mindee/parsing/v2/field/base_field.rb

@@ -20,13 +20,16 @@ module Mindee
           # @param indent_level [Integer] Level of indentation for rst display.
           def initialize(raw_prediction, indent_level = 0)
             @indent_level = indent_level
-            @confidence = raw_prediction.key?('confidence') ? raw_prediction['confidence'] : nil
-            @locations = if raw_prediction.key?('locations')
-                           raw_prediction['locations'].map do |location|
+            confidence = raw_prediction['confidence']
+            @confidence = FieldConfidence.new(confidence) unless confidence.nil? || confidence.empty?
+
+            locations = raw_prediction['locations']
+            @locations = if locations.nil? || locations.empty?
+                           []
+                         else
+                           locations.map do |location|
                              FieldLocation.new(location)
                            end
-                         else
-                           []
                          end
           end
 

data/lib/mindee/parsing/v2/field/field_confidence.rb

@@ -19,70 +19,107 @@ module Mindee
           LOW = 'Low'
 
           # List of valid values, as frozen strings.
-          VALID_VALUES = [CERTAIN, HIGH, MEDIUM, LOW].freeze
+          VALID_VALUES = ['Certain', 'High', 'Medium', 'Low'].freeze
 
           # @param value [String] The confidence level value.
           # @raise [ArgumentError] If the value is not a valid confidence level.
           def initialize(value)
-            unless VALID_VALUES.include?(value)
+            case value
+            when 'Certain' then @value = CERTAIN
+            when 'High' then @value = HIGH
+            when 'Medium' then @value = MEDIUM
+            when 'Low' then @value = LOW
+            else
               raise ArgumentError,
-                    "Invalid confidence level: #{value}. Must be one of: #{VALID_VALUES.join(', ')}"
+                    "Invalid confidence level: '#{value}'. Must be one of: #{VALID_VALUES.join(', ')}"
             end
 
             @value = value
           end
 
-          # Create a FieldConfidence from a string value.
-          # @param value [String] The confidence level string.
-          # @return [FieldConfidence] The confidence instance.
-          def self.from_string(value)
-            new(value)
+          # String representation of the confidence level.
+          # @return [String] The confidence level value.
+          def to_s
+            @value
           end
 
-          # Check if this is a certain confidence level.
-          # @return [Boolean] `true` if confidence is certain.
-          def certain?
-            @value == CERTAIN
+          # String representation of the confidence level.
+          # @return [Integer] The confidence level value as an integer: 1 is LOW, 4 is HIGH.
+          def to_i
+            val_to_i(@value)
           end
 
-          # Check if this is a high confidence level.
-          # @return [Boolean] `true` if confidence is high.
-          def high?
-            @value == HIGH
+          # Inspect method for debugging.
+          # @return [String] Debug representation.
+          def inspect
+            "#<#{self.class.name}:#{@value}>"
           end
 
-          # Check if this is a medium confidence level.
-          # @return [Boolean] `true` if confidence is medium.
-          def medium?
-            @value == MEDIUM
-          end
+          # Using 'case' breaks steep ...
+          # rubocop:disable Style/CaseLikeIf
 
-          # Check if this is a low confidence level.
-          # @return [Boolean] `true` if confidence is low.
-          def low?
-            @value == LOW
+          # Equality of two FieldConfidence instances.
+          # @param other [String, Integer, FieldConfidence] The other confidence to compare.
+          # @return [Boolean] `true` if they have the same value.
+          def ==(other)
+            if other.is_a?(FieldConfidence)
+              @value == other.value
+            elsif other.is_a?(String)
+              @value == other
+            elsif other.is_a?(Integer)
+              to_i == other
+            else
+              raise ArgumentError, "Invalid type: #{other.class}"
+            end
           end
 
-          # String representation of the confidence level.
-          # @return [String] The confidence level value.
-          def to_s
-            @value
+          # Greater than or equality of two FieldConfidence instances.
+          # @param other [String, Integer, FieldConfidence] The other confidence to compare.
+          def >=(other)
+            if other.is_a?(FieldConfidence)
+              to_i >= val_to_i(other.value)
+            elsif other.is_a?(String)
+              to_i >= val_to_i(other)
+            elsif other.is_a?(Integer)
+              to_i >= other
+            else
+              raise ArgumentError, "Invalid type: #{other.class}"
+            end
           end
 
-          # Compare two FieldConfidence instances.
-          # @param other [FieldConfidence] The other confidence to compare.
-          # @return [Boolean] `true` if they have the same value.
-          def ==(other)
-            other.is_a?(FieldConfidence) && @value == other.value
+          # less than or equality of two FieldConfidence instances.
+          # # @param other [String, Integer, FieldConfidence] The other confidence to compare.
+          def <=(other)
+            if other.is_a?(FieldConfidence)
+              to_i <= val_to_i(other.value)
+            elsif other.is_a?(String)
+              to_i <= val_to_i(other)
+            elsif other.is_a?(Integer)
+              to_i <= other
+            else
+              raise ArgumentError, "Invalid type: #{other.class}"
+            end
           end
 
-          # Make instances comparable and hashable
+          # rubocop:enable Style/CaseLikeIf
+
+          # Aliases for the comparison operators.
           alias eql? ==
+          alias gteql? >=
+          alias lteql? <=
 
-          # Inspect method for debugging.
-          # @return [String] Debug representation.
-          def inspect
-            "#<#{self.class.name}:#{@value}>"
+          protected
+
+          def val_to_i(value)
+            case value
+            when CERTAIN then 4
+            when HIGH then 3
+            when MEDIUM then 2
+            when LOW then 1
+            else
+              raise ArgumentError,
+                    "Invalid confidence level: '#{value}'. Must be one of: #{VALID_VALUES.join(', ')}"
+            end
           end
         end
       end

data/lib/mindee/parsing/v2/field/field_location.rb

@@ -16,11 +16,8 @@ module Mindee
 
           # @param server_response [Hash] Raw server response hash.
           def initialize(server_response)
-            polygon_data = server_response['polygon'] || server_response[:polygon]
-            @polygon = polygon_data ? Mindee::Geometry::Polygon.new(polygon_data) : nil
-
-            page_id = server_response['page'] || server_response[:page]
-            @page = page_id.is_a?(Float) || page_id.is_a?(Integer) ? page_id.to_i : nil
+            @polygon = Mindee::Geometry::Polygon.new(server_response['polygon'])
+            @page = server_response['page']
           end
 
           # String representation of the polygon (empty string when none).

data/lib/mindee/parsing/v2/field/inference_fields.rb

@@ -6,7 +6,8 @@ module Mindee
   module Parsing
     module V2
       module Field
-        # Collection of inference fields that extends Hash functionality.
+        # Represents a hash-like collection of inference fields, providing methods for
+        # retrieval and string representation.
         class InferenceFields < Hash
           # @return [Integer] Level of indentation for rst display.
           attr_reader :indent_level
@@ -29,23 +30,37 @@ module Mindee
             self[key]
           end
 
-          # Allow dot notation access to fields.
-          # @param method_name [Symbol] The method name (field key).
-          # @return [BaseField, nil] The field or nil if not found.
-          def method_missing(method_name, *args, &block)
-            key = method_name.to_s
-            if key?(key)
-              self[key]
-            else
-              super
-            end
+          # Get a field by key and ensure it is a SimpleField.
+          # @param key [String] Field key to retrieve.
+          # @return [SimpleField] The SimpleField.
+          # @raise [TypeError] If the field is not a SimpleField.
+          def get_simple_field(key)
+            field = self[key]
+            raise TypeError, "Field #{key} is not a SimpleField" unless field.is_a?(SimpleField)
+
+            field
           end
 
-          # Check if method_missing should handle the method.
-          # @param method_name [Symbol] The method name.
-          # @return [Boolean] `true` if the method should be handled.
-          def respond_to_missing?(method_name, include_private = false)
-            key?(method_name.to_s) || super
+          # Get a field by key and ensure it is a ListField.
+          # @param key [String] Field key to retrieve.
+          # @return [ListField] The ListField.
+          # @raise [TypeError] If the field is not a ListField.
+          def get_list_field(key)
+            field = self[key]
+            raise TypeError, "Field #{key} is not a ListField" unless field.is_a?(ListField)
+
+            field
+          end
+
+          # Get a field by key and ensure it is an ObjectField.
+          # @param key [String] Field key to retrieve.
+          # @return [ObjectField] The ObjectField.
+          # @raise [TypeError] If the field is not an ObjectField.
+          def get_object_field(key)
+            field = self[key]
+            raise TypeError, "Field #{key} is not a ObjectField" unless field.is_a?(ObjectField)
+
+            field
           end
 
           # rubocop:disable Metrics/CyclomaticComplexity
@@ -64,13 +79,7 @@ module Mindee
               line = "#{padding}:#{field_key}:"
 
               case (field_value.class.name || '').split('::').last
-              when 'ListField'
-                # Check if ListField has items and they're not empty
-                list_f = field_value # @type var list_f: ListField
-                if defined?(list_f.items) && list_f.items && !list_f.items.empty?
-                  line += list_f.to_s
-                end
-              when 'ObjectField'
+              when 'ListField', 'ObjectField'
                 line += field_value.to_s
               when 'SimpleField'
                 # Check if SimpleField has a non-empty value

data/lib/mindee/parsing/v2/field/list_field.rb

@@ -8,7 +8,6 @@ module Mindee
       module Field
         # Represents a field that contains a list of items.
         class ListField < BaseField
-          include Enumerable
           # @return [Array<ListField | ObjectField | SimpleField>] Items contained in the list.
           attr_reader :items
 
@@ -29,10 +28,36 @@ module Mindee
             end
           end
 
+          # Return only simple fields.
+          # @return [Array<SimpleField>] Simple fields contained in the list.
+          # @raise [TypeError] If the fields are not SimpleField.
+          def simple_items
+            fields = []
+            @items.each do |item|
+              raise TypeError, "Invalid field type detected: #{item.class}" unless item.is_a?(SimpleField)
+
+              fields << item
+            end
+            fields
+          end
+
+          # Return only object fields.
+          # @return [Array<ObjectField>] Object fields contained in the list.
+          # @raise [TypeError] If the fields are not ObjectField.
+          def object_items
+            fields = []
+            @items.each do |item|
+              raise TypeError, "Invalid field type detected: #{item.class}" unless item.is_a?(ObjectField)
+
+              fields << item
+            end
+            fields
+          end
+
           # String representation of the list field.
           # @return [String] Formatted string with bullet points for each item.
           def to_s
-            return "\n" if @items.empty?
+            return '' unless @items && !@items.empty?
 
             parts = ['']
             @items.each do |item|
@@ -47,40 +72,6 @@ module Mindee
 
             parts.join("\n  * ")
           end
-
-          # Check if the list is empty.
-          # @return [Boolean] `true` if the list has no items.
-          def empty?
-            @items.empty?
-          end
-
-          # Get the number of items in the list.
-          # @return [Integer] Number of items.
-          def size
-            @items.size
-          end
-
-          # Get the number of items in the list (alias for size).
-          # @return [Integer] Number of items.
-          def length
-            @items.length
-          end
-
-          # Get an item by index.
-          # @param index [Integer] The index of the item to retrieve.
-          # @return [BaseField, nil] The item at the given index.
-          def [](index)
-            @items[index]
-          end
-
-          # Iterator for Enumerator inheritance.
-          # NOTE: Untyped due to incomplete support in current supported version of RBS.
-          def each(&block)
-            return to_enum(:each) unless block_given?
-
-            @items.each(&block)
-            self
-          end
         end
       end
     end

data/lib/mindee/parsing/v2/field/object_field.rb

@@ -78,22 +78,12 @@ module Mindee
             out_str
           end
 
-          # Allow dot notation access to nested fields.
-          # @param method_name [Symbol] The method name (field key).
-          # @return [ObjectField, nil] The field or nil if not found.
-          def method_missing(method_name, ...)
-            if @fields.respond_to?(method_name)
-              @fields.send(method_name, ...)
-            else
-              super
-            end
-          end
-
-          # Check if method_missing should handle the method.
-          # @param method_name [Symbol] The method name.
-          # @return [Boolean] `true` if the method should be handled.
-          def respond_to_missing?(method_name, include_private = false)
-            @fields.respond_to?(method_name) || super
+          # Get a field by key and ensure it is a SimpleField.
+          # @param key [String] Field key to retrieve.
+          # @return [SimpleField] The SimpleField.
+          # @raise [TypeError] If the field is not a SimpleField.
+          def get_simple_field(key)
+            @fields.get_simple_field(key)
           end
         end
       end

data/lib/mindee/parsing/v2/field/simple_field.rb

@@ -15,7 +15,12 @@ module Mindee
           # @param indent_level [Integer] Level of indentation for rst display.
           def initialize(server_response, indent_level = 0)
             super
-            @value = server_response.key?('value') ? server_response['value'] : nil
+            value = server_response['value']
+            @value = if value.is_a?(Integer)
+                       value.to_f
+                     else
+                       value
+                     end
           end
 
           # String representation of the field value.

data/lib/mindee/parsing/v2/inference.rb

@@ -3,20 +3,23 @@
 require_relative 'inference_model'
 require_relative 'inference_file'
 require_relative 'inference_result'
+require_relative 'inference_active_options'
 
 module Mindee
   module Parsing
     module V2
       # Complete data returned by an inference request.
       class Inference
+        # @return [String] Identifier of the inference (when provided by API).
+        attr_reader :id
         # @return [InferenceModel] Information about the model used.
         attr_reader :model
         # @return [InferenceFile] Information about the processed file.
         attr_reader :file
+        # @return [InferenceActiveOptions] Options which were activated during the inference.
+        attr_reader :active_options
         # @return [InferenceResult] Result contents.
         attr_reader :result
-        # @return [String] Identifier of the inference (when provided by API).
-        attr_reader :id
 
         # @param server_response [Hash] Hash representation of the JSON returned by the service.
         def initialize(server_response)
@@ -24,6 +27,7 @@ module Mindee
 
           @model  = InferenceModel.new(server_response['model'])
           @file   = InferenceFile.new(server_response['file'])
+          @active_options = InferenceActiveOptions.new(server_response['active_options'])
           @result = InferenceResult.new(server_response['result'])
 
           @id = server_response['id']
@@ -35,11 +39,9 @@ module Mindee
           [
             'Inference',
             '#########',
-            'Model',
-            '=====',
-            ":ID: #{@model.id}",
-            '',
+            @model.to_s,
             @file.to_s,
+            @active_options.to_s,
             @result.to_s,
             '',
           ].join("\n")

data/lib/mindee/parsing/v2/inference_active_options.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Mindee
+  module Parsing
+    module V2
+      # Options which were activated during the inference.
+      class InferenceActiveOptions
+        # @return [Boolean] Whether the Raw Text feature was activated.
+        attr_reader :raw_text
+        # @return [Boolean] Whether the polygon feature was activated.
+        attr_reader :polygon
+        # @return [Boolean] Whether the confidence feature was activated.
+        attr_reader :confidence
+        # @return [Boolean] Whether the Retrieval-Augmented Generation feature was activated.
+        attr_reader :rag
+
+        # @param server_response [Hash] Raw JSON parsed into a Hash.
+        def initialize(server_response)
+          @raw_text = server_response['raw_text']
+          @polygon = server_response['polygon']
+          @confidence = server_response['confidence']
+          @rag = server_response['rag']
+        end
+
+        # String representation.
+        # @return [String]
+        def to_s
+          parts = [
+            'Active Options',
+            '==============',
+            ":Raw Text: #{@raw_text ? 'True' : 'False'}",
+            ":Polygon: #{@polygon ? 'True' : 'False'}",
+            ":Confidence: #{@confidence ? 'True' : 'False'}",
+            ":RAG: #{@rag ? 'True' : 'False'}",
+            '',
+          ]
+          parts.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/mindee/parsing/v2/inference_model.rb

@@ -12,6 +12,18 @@ module Mindee
         def initialize(server_response)
           @id = server_response['id']
         end
+
+        # String representation.
+        # @return [String]
+        def to_s
+          parts = [
+            'Model',
+            '=====',
+            ":ID: #{@id}",
+            '',
+          ]
+          parts.join("\n")
+        end
       end
     end
   end

data/lib/mindee/parsing/v2/inference_result.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'field/inference_fields'
-require_relative 'inference_result_options'
+require_relative 'raw_text'
 
 module Mindee
   module Parsing
@@ -10,8 +10,8 @@ module Mindee
       class InferenceResult
         # @return [Mindee::Parsing::V2::Field::InferenceFields] Fields produced by the model.
         attr_reader :fields
-        # @return [Mindee::Parsing::V2::InferenceResultOptions, nil] Optional extra data.
-        attr_reader :options
+        # @return [Mindee::Parsing::V2::RawText, nil] Optional extra data.
+        attr_reader :raw_text
 
         # @param server_response [Hash] Hash version of the JSON returned by the API.
         def initialize(server_response)
@@ -19,9 +19,7 @@ module Mindee
 
           @fields = Field::InferenceFields.new(server_response['fields'])
 
-          return unless server_response.key?('options') && server_response['options']
-
-          @options = InferenceResultOptions.new(server_response['options'])
+          @raw_text = server_response['raw_text'] ? RawText.new(server_response['raw_text']) : nil
         end
 
         # String representation.
@@ -32,15 +30,6 @@ module Mindee
             '======',
             @fields.to_s,
           ]
-
-          if @options
-            parts += [
-              'Options',
-              '=======',
-              @options.to_s,
-            ]
-          end
-
           parts.join("\n")
         end
       end

data/lib/mindee/parsing/v2/raw_text.rb

@@ -3,17 +3,17 @@
 module Mindee
   module Parsing
     module V2
-      # Raw text extracted from a given page.
+      # Raw text extracted from all pages in the document.
       class RawText
-        # @return [Integer] Page number where the text was found.
-        attr_reader :page
-        # @return [String] Text content.
-        attr_reader :content
+        # @return [Array[Mindee::Parsing::V2::RawTextPage]] List of pages with their extracted text content.
+        attr_reader :pages
 
         # @param server_response [Hash] Raw JSON parsed into a Hash.
         def initialize(server_response)
-          @page = server_response['page']
-          @content = server_response['content']
+          @pages = []
+          server_response.fetch('pages', []).each do |page|
+            @pages.push RawTextPage.new(page)
+          end
         end
       end
     end

data/lib/mindee/parsing/v2/raw_text_page.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Mindee
+  module Parsing
+    module V2
+      # Raw text extracted from a single page.
+      class RawTextPage
+        # @return [Boolean] Text content of the page as a single string. '\n' is used to separate lines.
+        attr_reader :content
+
+        # @param server_response [Hash] Raw JSON parsed into a Hash.
+        def initialize(server_response)
+          @content = server_response['content']
+        end
+      end
+    end
+  end
+end

data/lib/mindee/parsing/v2.rb

@@ -8,8 +8,9 @@ require_relative 'v2/inference_file'
 require_relative 'v2/inference_model'
 require_relative 'v2/inference_response'
 require_relative 'v2/inference_result'
-require_relative 'v2/inference_result_options'
+require_relative 'v2/inference_active_options'
 require_relative 'v2/job'
 require_relative 'v2/job_response'
 require_relative 'v2/job_webhook'
 require_relative 'v2/raw_text'
+require_relative 'v2/raw_text_page'

data/lib/mindee/version.rb

@@ -3,7 +3,7 @@
 # Mindee
 module Mindee
   # Current version.
-  VERSION = '4.7.0-rc3'
+  VERSION = '4.7.0'
 
   # Finds and return the current platform.
   # @return [Symbol, Hash[String | Symbol, Regexp], Nil?]

data/sig/mindee/geometry/polygon.rbs

@@ -2,6 +2,7 @@
 module Mindee
   module Geometry
     class Polygon < Array[Point]
+      def initialize: (Array[::Mindee::Geometry::Point | Array[Float]]) -> void
       def centroid: -> Point
       def point_in_y?: (Point) -> bool
     end

data/sig/mindee/input/inference_parameters.rbs

@@ -3,15 +3,21 @@ module Mindee
   module Input
     class InferenceParameters
       attr_reader close_file: bool
+      attr_reader confidence: bool?
       attr_reader file_alias: String?
       attr_reader model_id: String
       attr_reader polling_options: PollingOptions
+      attr_reader polygon: bool?
       attr_reader rag: bool?
+      attr_reader raw_text: bool?
       attr_reader webhook_ids: Array[String]?
 
       def initialize: (
           String,
           ?rag: bool?,
+          ?raw_text: bool?,
+          ?polygon: bool?,
+          ?confidence: bool?,
           ?file_alias: String?,
           ?webhook_ids: Array[String]?,
           ?polling_options: Hash[Symbol | String, untyped] | PollingOptions?,

data/sig/mindee/parsing/v2/field/field_confidence.rbs

@@ -12,14 +12,17 @@ module Mindee
           VALID_VALUES: Array[String]
           def initialize: (String) -> void
           def self.from_string: (String) -> FieldConfidence
-          def certain?: -> bool
-          def high?: -> bool
-          def medium?: -> bool
-          def low?: -> bool
+          def to_i: -> Integer
           def to_s: -> String
-          def ==: (FieldConfidence) -> bool
-          def eql?: (FieldConfidence) -> bool
+          def ==: (String | Integer | FieldConfidence) -> bool
+          def eql?: (String | Integer | FieldConfidence) -> bool
+          def <=: (String | Integer | FieldConfidence) -> bool
+          def lteql? : (String | Integer | FieldConfidence) -> bool
+          def >=: (String | Integer | FieldConfidence) -> bool
+          def gteql?: (String | Integer | FieldConfidence) -> bool
           def inspect: -> String
+
+          def val_to_i: (String) -> Integer
         end
       end
     end

data/sig/mindee/parsing/v2/field/field_location.rbs

@@ -4,8 +4,8 @@ module Mindee
     module V2
       module Field
         class FieldLocation
-          attr_reader page: Integer?
-          attr_reader polygon: Geometry::Polygon?
+          attr_reader page: Integer
+          attr_reader polygon: Geometry::Polygon
 
           def initialize: (Hash[String | Symbol, untyped]) -> void
           def to_s: -> String

data/sig/mindee/parsing/v2/field/inference_fields.rbs

@@ -6,11 +6,12 @@ module Mindee
         class InferenceFields < Hash[String, ListField | ObjectField | SimpleField?]
           attr_reader indent_level: Integer
 
+          def get_list_field: (String) -> ListField
+          def get_simple_field: (String) -> SimpleField
+          def get_object_field: (String) -> ObjectField
           def logger: () -> Logger
           def initialize: (Hash[String | Symbol, untyped], ?Integer) -> void
           def get: (String) -> (ListField | ObjectField | SimpleField?)
-          def method_missing: (Symbol, *untyped) -> (ListField | ObjectField | SimpleField?)
-          def respond_to_missing?: (Symbol, ?bool) -> bool
           def to_s: (?Integer) -> String
         end
       end

data/sig/mindee/parsing/v2/field/list_field.rbs

@@ -6,8 +6,10 @@ module Mindee
         class ListField < BaseField
           include Enumerable[BaseField]
 
-          attr_reader items: Array[BaseField]
+          attr_reader items: Array[SimpleField | ObjectField | ListField]
           def initialize: (Hash[String | Symbol, untyped], ?Integer) -> void
+          def object_items: -> Array[ObjectField]
+          def simple_items: -> Array[SimpleField]
           def to_s: -> String
           def empty?: -> bool
           def size: -> Integer

data/sig/mindee/parsing/v2/field/object_field.rbs

@@ -8,12 +8,11 @@ module Mindee
         class ObjectField < BaseField
           attr_reader fields: InferenceFields
           def initialize: (Hash[String | Symbol, untyped], ?Integer) -> void
+          def get_simple_field: (String) -> SimpleField
           def multi_str: -> String
-          def respond_to_missing?: (Symbol, bool) -> bool
           def single_str: -> String
           def to_s: -> String
           def to_s_from_list: -> String
-          def method_missing: (Symbol, *untyped, untyped) -> (ObjectField?)
         end
       end
     end

data/sig/mindee/parsing/v2/field/simple_field.rbs

@@ -4,7 +4,7 @@ module Mindee
     module V2
       module Field
         class SimpleField < BaseField
-          attr_reader value: String | Integer | Float | bool?
+          attr_reader value: String | Integer | Float | bool | nil
 
           def initialize: (Hash[String | Symbol, untyped], ?Integer) -> void
           def to_s: -> String

data/sig/mindee/parsing/v2/inference.rbs

@@ -3,9 +3,10 @@ module Mindee
   module Parsing
     module V2
       class Inference
-        attr_reader file: InferenceFile
         attr_reader id: String
         attr_reader model: InferenceModel
+        attr_reader file: InferenceFile
+        attr_reader active_options: InferenceActiveOptions
         attr_reader result: InferenceResult
 
         def initialize: (Hash[String | Symbol, untyped]) -> void

data/sig/mindee/parsing/v2/inference_active_options.rbs

@@ -0,0 +1,14 @@
+module Mindee
+  module Parsing
+    module V2
+      class InferenceActiveOptions
+        attr_reader confidence: bool
+        attr_reader polygon: bool
+        attr_reader rag: bool
+        attr_reader raw_text: bool
+
+        def initialize: (Hash[String | Symbol, untyped]) -> void
+      end
+    end
+  end
+end

data/sig/mindee/parsing/v2/inference_result.rbs

@@ -4,7 +4,8 @@ module Mindee
     module V2
       class InferenceResult
         attr_reader fields: Field::InferenceFields
-        attr_reader options: InferenceResultOptions?
+        attr_reader raw_text: RawText?
+
         def initialize: (Hash[String | Symbol, untyped]) -> void
         def to_s: -> String
       end

data/sig/mindee/parsing/v2/raw_text.rbs

@@ -3,8 +3,8 @@ module Mindee
   module Parsing
     module V2
       class RawText
-        attr_reader page: Integer?
-        attr_reader content: String?
+        attr_reader pages: Array[RawTextPage]
+
         def initialize: (Hash[String | Symbol, untyped]) -> void
       end
     end

data/sig/mindee/parsing/v2/{inference_result_options.rbs → raw_text_page.rbs}

@@ -1,9 +1,9 @@
-# lib/mindee/parsing/v2/inference_result_options.rb
 module Mindee
   module Parsing
     module V2
-      class InferenceResultOptions
-        attr_reader raw_texts: Array[RawText]
+      class RawTextPage
+        attr_reader content: string
+
         def initialize: (Hash[String | Symbol, untyped]) -> void
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mindee
 version: !ruby/object:Gem::Version
-  version: 4.7.0.pre.rc3
+  version: 4.7.0
 platform: ruby
 authors:
 - Mindee, SA
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-29 00:00:00.000000000 Z
+date: 2025-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -377,15 +377,16 @@ files:
 - lib/mindee/parsing/v2/field/object_field.rb
 - lib/mindee/parsing/v2/field/simple_field.rb
 - lib/mindee/parsing/v2/inference.rb
+- lib/mindee/parsing/v2/inference_active_options.rb
 - lib/mindee/parsing/v2/inference_file.rb
 - lib/mindee/parsing/v2/inference_model.rb
 - lib/mindee/parsing/v2/inference_response.rb
 - lib/mindee/parsing/v2/inference_result.rb
-- lib/mindee/parsing/v2/inference_result_options.rb
 - lib/mindee/parsing/v2/job.rb
 - lib/mindee/parsing/v2/job_response.rb
 - lib/mindee/parsing/v2/job_webhook.rb
 - lib/mindee/parsing/v2/raw_text.rb
+- lib/mindee/parsing/v2/raw_text_page.rb
 - lib/mindee/pdf.rb
 - lib/mindee/pdf/extracted_pdf.rb
 - lib/mindee/pdf/pdf_compressor.rb
@@ -650,15 +651,16 @@ files:
 - sig/mindee/parsing/v2/field/object_field.rbs
 - sig/mindee/parsing/v2/field/simple_field.rbs
 - sig/mindee/parsing/v2/inference.rbs
+- sig/mindee/parsing/v2/inference_active_options.rbs
 - sig/mindee/parsing/v2/inference_file.rbs
 - sig/mindee/parsing/v2/inference_model.rbs
 - sig/mindee/parsing/v2/inference_response.rbs
 - sig/mindee/parsing/v2/inference_result.rbs
-- sig/mindee/parsing/v2/inference_result_options.rbs
 - sig/mindee/parsing/v2/job.rbs
 - sig/mindee/parsing/v2/job_response.rbs
 - sig/mindee/parsing/v2/job_webhook.rbs
 - sig/mindee/parsing/v2/raw_text.rbs
+- sig/mindee/parsing/v2/raw_text_page.rbs
 - sig/mindee/pdf/extracted_pdf.rbs
 - sig/mindee/pdf/pdf_compressor.rbs
 - sig/mindee/pdf/pdf_extractor.rbs
@@ -858,9 +860,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.2.33
 signing_key:

data/lib/mindee/parsing/v2/inference_result_options.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'raw_text'
-
-module Mindee
-  module Parsing
-    module V2
-      # Optional data returned alongside an inference.
-      class InferenceResultOptions
-        # @return [Array<RawText>] Collection of raw texts per page.
-        attr_reader :raw_texts
-
-        # @param server_response [Hash] Raw JSON parsed into a Hash.
-        def initialize(server_response)
-          raw = server_response['raw_texts']
-          @raw_texts = raw.is_a?(Array) ? raw.map { |rt| RawText.new(rt) } : []
-        end
-      end
-    end
-  end
-end