mindee 3.20.0 → 4.0.0

data/lib/mindee/product/us/w9/w9_v1.rb

@@ -13,16 +13,16 @@ module Mindee
         class W9V1 < Mindee::Parsing::Common::Inference
           @endpoint_name = 'us_w9'
           @endpoint_version = '1'
+          @has_async = false
+          @has_sync = true
 
           # @param prediction [Hash]
           def initialize(prediction)
             super
-            @prediction = W9V1Document.new
+            @prediction = W9V1Document.new(prediction['prediction'], nil)
             @pages = []
             prediction['pages'].each do |page|
-              if page.key?('prediction') && !page['prediction'].nil? && !page['prediction'].empty?
-                @pages.push(W9V1Page.new(page))
-              end
+              @pages.push(W9V1Page.new(page))
             end
           end
 
@@ -33,6 +33,12 @@ module Mindee
             # Version for this product.
             # @return [String]
             attr_reader :endpoint_version
+            # Whether this product has access to an asynchronous endpoint.
+            # @return [bool]
+            attr_reader :has_async
+            # Whether this product has access to synchronous endpoint.
+            # @return [bool]
+            attr_reader :has_sync
           end
         end
       end

data/lib/mindee/product/us/w9/w9_v1_page.rb

@@ -11,11 +11,15 @@ module Mindee
         class W9V1Page < Mindee::Parsing::Common::Page
           # @param prediction [Hash]
           def initialize(prediction)
-            super(prediction)
-            @prediction = W9V1PagePrediction.new(
-              prediction['prediction'],
-              prediction['id']
-            )
+            super
+            @prediction = if prediction['prediction'].empty?
+                            nil
+                          else
+                            W9V1PagePrediction.new(
+                              prediction['prediction'],
+                              prediction['id']
+                            )
+                          end
           end
         end
 
@@ -63,19 +67,46 @@ module Mindee
           # @param prediction [Hash]
           # @param page_id [Integer, nil]
           def initialize(prediction, page_id)
-            @address = StringField.new(prediction['address'], page_id)
-            @business_name = StringField.new(prediction['business_name'], page_id)
-            @city_state_zip = StringField.new(prediction['city_state_zip'], page_id)
-            @ein = StringField.new(prediction['ein'], page_id)
-            @name = StringField.new(prediction['name'], page_id)
-            @signature_date_position = PositionField.new(prediction['signature_date_position'], page_id)
-            @signature_position = PositionField.new(prediction['signature_position'], page_id)
-            @ssn = StringField.new(prediction['ssn'], page_id)
-            @tax_classification = StringField.new(prediction['tax_classification'], page_id)
-            @tax_classification_llc = StringField.new(prediction['tax_classification_llc'], page_id)
-            @tax_classification_other_details = StringField.new(prediction['tax_classification_other_details'], page_id)
-            @w9_revision_date = StringField.new(prediction['w9_revision_date'], page_id)
-            super()
+            @address = Parsing::Standard::StringField.new(
+              prediction['address'],
+              page_id
+            )
+            @business_name = Parsing::Standard::StringField.new(
+              prediction['business_name'],
+              page_id
+            )
+            @city_state_zip = Parsing::Standard::StringField.new(
+              prediction['city_state_zip'],
+              page_id
+            )
+            @ein = Parsing::Standard::StringField.new(prediction['ein'], page_id)
+            @name = Parsing::Standard::StringField.new(prediction['name'], page_id)
+            @signature_date_position = Parsing::Standard::PositionField.new(
+              prediction['signature_date_position'],
+              page_id
+            )
+            @signature_position = Parsing::Standard::PositionField.new(
+              prediction['signature_position'],
+              page_id
+            )
+            @ssn = Parsing::Standard::StringField.new(prediction['ssn'], page_id)
+            @tax_classification = Parsing::Standard::StringField.new(
+              prediction['tax_classification'],
+              page_id
+            )
+            @tax_classification_llc = Parsing::Standard::StringField.new(
+              prediction['tax_classification_llc'],
+              page_id
+            )
+            @tax_classification_other_details = Parsing::Standard::StringField.new(
+              prediction['tax_classification_other_details'],
+              page_id
+            )
+            @w9_revision_date = Parsing::Standard::StringField.new(
+              prediction['w9_revision_date'],
+              page_id
+            )
+            super
           end
 
           # @return [String]

data/lib/mindee/product.rb

@@ -3,15 +3,12 @@
 require_relative 'product/barcode_reader/barcode_reader_v1'
 require_relative 'product/bill_of_lading/bill_of_lading_v1'
 require_relative 'product/business_card/business_card_v1'
-require_relative 'product/custom/custom_v1'
 require_relative 'product/cropper/cropper_v1'
 require_relative 'product/delivery_note/delivery_note_v1'
 require_relative 'product/driver_license/driver_license_v1'
 require_relative 'product/eu/license_plate/license_plate_v1'
-require_relative 'product/eu/driver_license/driver_license_v1'
 require_relative 'product/fr/bank_account_details/bank_account_details_v1'
 require_relative 'product/fr/bank_account_details/bank_account_details_v2'
-require_relative 'product/fr/bank_statement/bank_statement_v1'
 require_relative 'product/fr/bank_statement/bank_statement_v2'
 require_relative 'product/fr/carte_grise/carte_grise_v1'
 require_relative 'product/fr/id_card/id_card_v1'
@@ -21,7 +18,6 @@ require_relative 'product/fr/health_card/health_card_v1'
 require_relative 'product/fr/payslip/payslip_v2'
 require_relative 'product/fr/payslip/payslip_v3'
 require_relative 'product/financial_document/financial_document_v1'
-require_relative 'product/generated/generated_v1'
 require_relative 'product/ind/indian_passport/indian_passport_v1'
 require_relative 'product/invoice/invoice_v4'
 require_relative 'product/invoice_splitter/invoice_splitter_v1'
@@ -29,13 +25,10 @@ require_relative 'product/international_id/international_id_v2'
 require_relative 'product/multi_receipts_detector/multi_receipts_detector_v1'
 require_relative 'product/nutrition_facts_label/nutrition_facts_label_v1'
 require_relative 'product/passport/passport_v1'
-require_relative 'product/proof_of_address/proof_of_address_v1'
-require_relative 'product/receipt/receipt_v4'
 require_relative 'product/receipt/receipt_v5'
 require_relative 'product/resume/resume_v1'
+require_relative 'product/universal/universal'
 require_relative 'product/us/bank_check/bank_check_v1'
-require_relative 'product/us/driver_license/driver_license_v1'
 require_relative 'product/us/healthcare_card/healthcare_card_v1'
-require_relative 'product/us/us_mail/us_mail_v2'
 require_relative 'product/us/us_mail/us_mail_v3'
 require_relative 'product/us/w9/w9_v1'

data/lib/mindee/version.rb

@@ -3,10 +3,10 @@
 # Mindee
 module Mindee
   # Current version.
-  VERSION = '3.20.0'
+  VERSION = '4.0.0'
 
   # Finds and return the current platform.
-  # @return [String]
+  # @return [Symbol, Hash[Symbol | String, Regexp], Nil?]
   def self.find_platform
     host = RbConfig::CONFIG['host_os']
     platforms = {

data/lib/mindee.rb

@@ -1,9 +1,17 @@
 # frozen_string_literal: true
 
 require 'mindee/client'
-require 'mindee/extraction'
+require 'mindee/logging'
 
 module Mindee
+  # Mindee internal error module.
+  module Errors
+  end
+
+  # Custom extraction module
+  module Extraction
+  end
+
   # Mindee internal http module.
   module HTTP
   end
@@ -29,8 +37,8 @@ module Mindee
     end
   end
 
-  # Custom extraction module
-  module Extraction
+  # Logging
+  module Logging
   end
 
   # Parsing internals and fields.
@@ -39,16 +47,12 @@ module Mindee
     module Common
     end
 
-    # Custom fields and functions.
-    module Custom
-    end
-
     # Standard fields and functions.
     module Standard
     end
 
-    # Generated fields and functions.
-    module Generated
+    # Universal fields and functions.
+    module Universal
     end
   end
 
@@ -66,8 +70,17 @@ module Mindee
     module FR
     end
 
+    # Indian-specific products.
+    module IND
+    end
+
     # US-specific products.
     module US
     end
   end
 end
+
+# Shorthand to call the logger from anywhere.
+def logger
+  Mindee::Logging.logger
+end

data/mindee.gemspec

@@ -6,20 +6,18 @@ Gem::Specification.new do |spec|
   spec.name          = 'mindee'
   spec.version       = Mindee::VERSION
   spec.authors       = ['Mindee, SA']
-  spec.email         = ['devrel@mindee.co']
+  spec.email         = ['opensource@mindee.co']
 
   spec.summary       = 'Mindee API Helper Library for Ruby'
   spec.description   = "Quickly and easily connect to Mindee's API services using Ruby."
   spec.homepage      = 'https://github.com/mindee/mindee-api-ruby'
   spec.license       = 'MIT'
 
-  spec.metadata['homepage_uri'] = 'https://mindee.com/'
-  spec.metadata['source_code_uri'] = 'https://github.com/mindee/mindee-api-ruby'
-  spec.metadata['changelog_uri'] = 'https://github.com/mindee/mindee-api-ruby/blob/main/CHANGELOG.md'
+  spec.metadata['homepage_uri']      = 'https://mindee.com/'
+  spec.metadata['source_code_uri']   = 'https://github.com/mindee/mindee-api-ruby'
+  spec.metadata['changelog_uri']     = 'https://github.com/mindee/mindee-api-ruby/blob/main/CHANGELOG.md'
   spec.metadata['rubygems_mfa_required'] = 'true'
 
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(.github|spec|features)/}) }
   end
@@ -27,15 +25,19 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.6')
-
-  spec.add_runtime_dependency 'marcel', '~> 1.0.2'
-  spec.add_runtime_dependency 'mini_magick', '>=4', '< 6'
-  spec.add_runtime_dependency 'origamindee', '~> 3.1.0'
-  spec.add_runtime_dependency 'pdf-reader', '~> 2.12.0'
-
-  spec.add_development_dependency 'rake', '~> 12.3.3'
-  spec.add_development_dependency 'rspec', '~> 3.12.0'
-  spec.add_development_dependency 'rubocop', '~> 1.49.0'
-  spec.add_development_dependency 'yard', '~> 0.9.34'
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.0')
+
+  spec.add_dependency 'base64', '~> 0.1.0'
+  spec.add_dependency 'marcel', '~> 1.0.4'
+  spec.add_dependency 'mini_magick', '>= 4', '< 6'
+  spec.add_dependency 'origamindee', '~> 4.0.0'
+  spec.add_dependency 'pdf-reader', '~> 2.13.0'
+
+  spec.add_development_dependency 'prism', '~> 1.3'
+  spec.add_development_dependency 'rake', '~> 13.2.1'
+  spec.add_development_dependency 'rbs', '~> 3.6'
+  spec.add_development_dependency 'rspec', '~> 3.13.0'
+  spec.add_development_dependency 'rubocop', '~> 1.70.0'
+  spec.add_development_dependency 'steep', '~> 1.7.1'
+  spec.add_development_dependency 'yard', '~> 0.9.37'
 end

data/sig/custom/marcel.rbs

@@ -0,0 +1,3 @@
+module Marcel
+  MimeType: untyped
+end

data/sig/custom/mini_magick.rbs

@@ -0,0 +1,24 @@
+# Stub for the mini_magick library.
+module MiniMagick
+  class Image
+    def format: (String, ?Integer?, ?Hash[Symbol, untyped]?) -> Net::BufferedIO
+    def self.format: (String, ?Integer?, ?Hash[Symbol, untyped]?) -> Net::BufferedIO
+    def self.quality: (String) -> Net::BufferedIO
+    def self.crop: (String) -> Net::BufferedIO
+    def self.height: () -> Integer
+    def height: () -> Integer
+    def self.width: () -> Integer
+    def width: () -> Integer
+    def self.read: (untyped) -> self
+    def self.resolution: () -> Array[Float | Integer]
+    def self.write: (StringIO | String) -> Net::BufferedIO
+    def write: (StringIO | String) -> Net::BufferedIO
+    def quality: (Integer) -> void
+    def self.resize: (String) -> void
+    def resize: (String) -> void
+    def self.to_blob: () -> String
+    def to_blob: () -> String
+    def self.[]: (?untyped) -> untyped
+    def []: (?untyped) -> untyped
+  end
+end

data/sig/custom/net_http.rbs

@@ -0,0 +1,34 @@
+# This is a stub of mock type declarations for the net/http standard library, which isn't
+# currently supported by Steep.
+# Do not mess with it unless Steep fixes the handling of this library.
+
+module Net
+  class BufferedIO
+  end
+  class HTTP
+    def self.start: [T] (String?, Integer?, use_ssl: bool?, ?read_timeout: Integer) { (HTTP) -> T } -> T
+
+    def request: (untyped) -> untyped
+
+    # Stub for the HTTP POST request class.
+    class Post
+      def initialize: (untyped, Hash[String, String]?) -> void
+      def set_form: (untyped, String?) -> void
+      def new: (untyped, untyped) -> void
+    end
+
+    # Stub for the HTTP GET request class.
+    class Get
+      def initialize: (untyped, ?Hash[String, String]?) -> void
+      def new: (untyped, untyped) -> void
+      def basic_auth: (untyped, untyped) -> void
+      def []=: (?untyped, ?untyped) -> bool
+    end
+  end
+
+  class HTTPRedirection
+    def []: (untyped) -> untyped
+    def body: -> untyped
+    def code: -> String?
+  end
+end

data/sig/custom/origami.rbs

@@ -0,0 +1,54 @@
+# Stubs for the origami library.
+# This one _should_ exist, but it would take too long, so this is a stub.
+module Origami
+  class Array
+    def each: { (untyped) -> untyped } -> untyped
+  end
+  class PDF
+    def self.read: (StringIO) -> untyped
+    def initialize: () -> void
+    def append_page: (Page) -> void
+    def delete_pages_at: (::Array[Integer]) -> void
+    def pages: () -> untyped
+    def save: (StringIO) -> void
+    def to_io_stream: -> StringIO
+    class LinearParser
+      def initialize: (Hash[Symbol, untyped]) -> void
+      def new: (Hash[Symbol, untyped]) -> void
+      def parse: (StringIO?) -> PDF
+    end
+  end
+
+  class Page
+    def initialize: () -> void
+    def add_xobject: (Graphics::ImageXObject, String) -> untyped
+    def Contents: (?untyped?) -> untyped
+  end
+
+  module Graphics
+    class ImageXObject
+      def initialize: () -> void
+
+      def BitsPerComponent=: (Integer) -> untyped
+      def ColorSpace=: (Symbol) -> untyped
+      def data=: (StringIO) -> untyped
+      def self.from_image_file: (StringIO, String) -> untyped
+      def Height=: (Integer | Float) -> untyped
+      def Width=: (Integer | Float) -> untyped
+    end
+  end
+
+  class InvalidPDFError < StandardError
+  end
+
+  class Parser
+    VERBOSE_QUIET: String
+  end
+
+  class Stream
+    def initialize: (?String) -> untyped
+    def data : () -> untyped
+    def data= : (String | StringIO) -> void
+    def dictionary : -> Hash[Symbol, untyped]
+  end
+end

data/sig/mindee/client.rbs

@@ -0,0 +1,63 @@
+OTS_OWNER: String
+
+module Mindee
+  OTS_OWNER: String
+
+  class PageOptions
+    attr_accessor page_indexes: Array[Integer]
+    attr_accessor operation: :KEEP_ONLY | :REMOVE
+    attr_accessor on_min_pages: Integer?
+
+    def initialize: (params: Hash[Symbol | String, untyped]) -> void
+  end
+
+  class ParseOptions
+    attr_accessor all_words: bool
+    attr_accessor full_text: bool
+    attr_accessor close_file: bool
+    attr_accessor page_options: PageOptions
+    attr_accessor cropper: bool
+    attr_accessor initial_delay_sec: Integer | Float
+    attr_accessor delay_sec: Integer | Float
+    attr_accessor max_retries: Integer
+
+    def initialize: (params: Hash[Symbol | String, untyped]) -> void
+  end
+
+  class WorkflowOptions
+    attr_accessor document_alias: (String?)
+    attr_accessor priority: (Symbol?)
+    attr_accessor full_text: bool
+    attr_accessor public_url: (String?)
+    attr_accessor page_options: (PageOptions)
+
+    def initialize: (params: Hash[Symbol | String, untyped]) -> void
+  end
+
+  class Client
+    def initialize: (api_key: String) -> void
+    def logger: () -> untyped
+    def parse: (Input::Source::LocalInputSource | Input::Source::URLInputSource, untyped, ?endpoint: (HTTP::Endpoint?), options: ParseOptions | Hash[Symbol | String, untyped]) -> Parsing::Common::ApiResponse
+    def parse_sync: (Input::Source::LocalInputSource | Input::Source::URLInputSource, untyped, HTTP::Endpoint, ParseOptions) -> Parsing::Common::ApiResponse
+    def enqueue: (Input::Source::LocalInputSource | Input::Source::URLInputSource, untyped, ?endpoint: (HTTP::Endpoint?), options: ParseOptions|Hash[Symbol | String, untyped]) -> Parsing::Common::ApiResponse
+    def parse_queued: (String, singleton(Parsing::Common::Inference), ?endpoint: HTTP::Endpoint?) -> Parsing::Common::ApiResponse
+    def enqueue_and_parse: (Input::Source::URLInputSource|Input::Source::LocalInputSource, untyped, HTTP::Endpoint, ParseOptions) -> Parsing::Common::ApiResponse
+    def execute_workflow: (Input::Source::URLInputSource|Input::Source::LocalInputSource, String, options: (Hash[Symbol | String, untyped] | WorkflowOptions)) -> Parsing::Common::WorkflowResponse
+    def load_prediction: (singleton(Parsing::Common::Inference), Input::LocalResponse) -> Parsing::Common::ApiResponse
+    def source_from_path: (String, ?repair_pdf: bool) -> Input::Source::PathInputSource
+    def source_from_bytes: (String, String, ?repair_pdf: bool) -> Input::Source::BytesInputSource
+    def source_from_b64string: (String, String, ?repair_pdf: bool) -> Input::Source::Base64InputSource
+    def source_from_file: (File, String, ?repair_pdf: bool) -> Input::Source::FileInputSource
+    def source_from_url: (String) -> Input::Source::URLInputSource
+    def create_endpoint: (endpoint_name: String, account_name: String, version: String) -> HTTP::Endpoint
+
+    private
+    def normalize_parse_options: ((Hash[Symbol | String, untyped] | ParseOptions)) -> ParseOptions
+    def process_pdf_if_required: (Input::Source::LocalInputSource, ParseOptions | WorkflowOptions) -> void
+    def initialize_endpoint: (singleton(Parsing::Common::Inference), ?endpoint_name: String, ?account_name: String, ?version: String) -> HTTP::Endpoint
+    def validate_async_params: (Integer | Float, Integer | Float, Integer) -> void
+    def fix_endpoint_name: (singleton(Parsing::Common::Inference), String?) -> String?
+    def fix_account_name: (String) -> String
+    def fix_version: (singleton(Parsing::Common::Inference), String) -> String
+  end
+end

data/sig/mindee/errors/mindee_error.rbs

@@ -0,0 +1,13 @@
+# lib/mindee/errors/mindee_error.rb
+module Mindee
+  module Errors
+    class MindeeError < StandardError
+    end
+    class MindeeAPIError < MindeeError
+    end
+    class MindeeConfigurationError < MindeeError
+    end
+    class MindeeGeometryError < MindeeError
+    end
+  end
+end

data/sig/mindee/errors/mindee_http_error.rbs

@@ -0,0 +1,16 @@
+# lib/mindee/errors/mindee_http_error.rb
+module Mindee
+  module Errors
+    class MindeeHTTPError < Errors::MindeeError
+      def status_code: -> untyped
+      def api_code: -> untyped
+      def api_details: -> untyped
+      def api_message: -> untyped
+      def initialize: (untyped, untyped, untyped) -> untyped
+    end
+    class MindeeHTTPClientError < MindeeHTTPError
+    end
+    class MindeeHTTPServerError < MindeeHTTPError
+    end
+  end
+end

data/sig/mindee/errors/mindee_input_error.rbs

@@ -0,0 +1,17 @@
+# lib/mindee/errors/mindee_input_error.rb
+module Mindee
+  module Errors
+    class MindeeInputError < MindeeError
+    end
+    class MindeeSourceError < MindeeInputError
+    end
+    class MindeeMimeTypeError < MindeeSourceError
+      def invalid_mimetype: -> untyped
+      def initialize: (untyped) -> untyped
+    end
+    class MindeeImageError < MindeeInputError
+    end
+    class MindeePDFError < MindeeInputError
+    end
+  end
+end

data/sig/mindee/extraction/multi_receipts_extractor.rbs

@@ -0,0 +1,6 @@
+# lib/mindee/extraction/multi_receipts_extractor.rb
+module Mindee
+  module Extraction
+    def self.extract_receipts: (untyped, untyped) -> Array[untyped]
+  end
+end

data/sig/mindee/geometry/min_max.rbs

@@ -0,0 +1,10 @@
+# lib/mindee/geometry/min_max.rb
+module Mindee
+  module Geometry
+    class MinMax
+      def min: -> untyped
+      def max: -> untyped
+      def initialize: (untyped, untyped) -> untyped
+    end
+  end
+end

data/sig/mindee/geometry/point.rbs

@@ -0,0 +1,13 @@
+# lib/mindee/geometry/point.rb
+module Mindee
+  module Geometry
+    class Point
+      def x: -> untyped
+      def x=: (untyped) -> untyped
+      def y: -> untyped
+      def y=: (untyped) -> untyped
+      def initialize: (untyped, untyped) -> untyped
+      def []: (untyped) -> bot
+    end
+  end
+end

data/sig/mindee/geometry/polygon.rbs

@@ -0,0 +1,9 @@
+# lib/mindee/geometry/polygon.rb
+module Mindee
+  module Geometry
+    class Polygon < Array[untyped]
+      def centroid: -> untyped
+      def point_in_y?: (untyped) -> untyped
+    end
+  end
+end

data/sig/mindee/geometry/quadrilateral.rbs

@@ -0,0 +1,18 @@
+# lib/mindee/geometry/quadrilateral.rb
+module Mindee
+  module Geometry
+    class Quadrilateral
+      def top_left: -> Point
+      def top_left=: (Point) -> bool
+      def top_right: -> Point
+      def top_right=: (Point) -> untyped
+      def bottom_right: -> Point
+      def bottom_right=: (Point) -> untyped
+      def bottom_left: -> Point
+      def bottom_left=: (Point) -> untyped
+      def initialize: (Point, Point, Point, Point) -> void
+      def []: (Integer) -> Point
+      def size: -> Integer
+    end
+  end
+end

data/sig/mindee/geometry/utils.rbs

@@ -0,0 +1,13 @@
+# lib/mindee/geometry/utils.rb
+module Mindee
+  module Geometry
+    def self.quadrilateral_from_prediction: (untyped) -> untyped
+    def self.polygon_from_prediction: (untyped) -> untyped
+    def self.get_bbox: (untyped) -> [untyped, untyped, untyped, untyped]
+    def self.get_bounding_box: (untyped) -> Quadrilateral
+    def self.get_centroid: (untyped) -> untyped
+    def self.get_min_max_y: (untyped) -> untyped
+    def self.get_min_max_x: (untyped) -> untyped
+    def self.below?: (untyped, untyped, untyped, untyped) -> bool
+  end
+end

data/sig/mindee/http/endpoint.rbs

@@ -0,0 +1,26 @@
+# lib/mindee/http/endpoint.rb
+module Mindee
+  module HTTP
+    API_KEY_ENV_NAME: String
+    API_KEY_DEFAULT: nil
+    BASE_URL_ENV_NAME: String
+    BASE_URL_DEFAULT: String
+    REQUEST_TIMEOUT_ENV_NAME: String
+    TIMEOUT_DEFAULT: Integer
+    USER_AGENT: String
+    class Endpoint
+      def logger: () -> untyped
+      def api_key: -> String?
+      def request_timeout: -> Integer
+      def url_root: -> String
+      def initialize: (untyped, untyped, untyped, ?api_key: String) -> String
+      def predict: (untyped, untyped, untyped, untyped, untyped) -> [untyped, untyped]
+      def predict_async: (untyped, untyped, untyped, untyped, untyped) -> [untyped, untyped]
+      def parse_async: (untyped) -> [untyped, untyped]
+      def predict_req_post: (untyped, ?all_words: false, ?full_text: false, ?close_file: true, ?cropper: false) -> untyped
+      def document_queue_req_get: (untyped, untyped, untyped, untyped, untyped) -> untyped
+      def document_queue_req: (untyped) -> untyped
+      def check_api_key: -> nil
+    end
+  end
+end

data/sig/mindee/http/http_error_handler.rbs

@@ -0,0 +1,10 @@
+# lib/mindee/http/http_error_handler.rb
+module Mindee
+  module HTTP
+    module ErrorHandler
+      def extract_error: (untyped) -> nil
+      def create_error_obj: (untyped) -> (Hash[String, String] | Hash[untyped, untyped])?
+      def self.handle_error: (untyped, untyped) -> untyped
+    end
+  end
+end

data/sig/mindee/http/response_validation.rbs

@@ -0,0 +1,10 @@
+# lib/mindee/http/response_validation.rb
+module Mindee
+  module HTTP
+    module ResponseValidation
+      def self.valid_sync_response?: (untyped) -> bool
+      def self.valid_async_response?: (untyped) -> bool
+      def self.clean_request!: (untyped) -> nil
+    end
+  end
+end