mindee 4.5.0 → 4.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32670ffa1c3f59d5dfb573f0543ef36e80e79341acacdcb5722249425e775fa9
-  data.tar.gz: 6e3c47dad7eeacae2b6d06277deda1e2e9e90903e83883263021e306920e99f0
+  metadata.gz: c37efc128220eca42a9c5af127911697d47bd4179166d9faec47f04988221d4d
+  data.tar.gz: da2158c80baa262b083baf4696a5d5f2d6b4226999713262419a4c98165cbd80
 SHA512:
-  metadata.gz: 6324e2e4f0b75435fcb5baade6dbad8fb693de5cc74fff3171f53598d791486a4043826bea965ee79c58cf3988d0d69c449240f3607ec2a201c79b14f0dcdb2d
-  data.tar.gz: 6394379b7ea271aba332256587ba406b03c3230a8647fed74d57ef474436e9b0b729be902cc60d7ee8be1ae9913f2173673c62c8f7e31383802c25bffd2d112a
+  metadata.gz: d5c02591130934ad5dcd7e6a87a22e753f4a3cf7bed31a0913c9f4296cc5ed4f741d085267a59d171d6e7146b34542878ae03ca920060ec9ef2e113c9bbd6f74
+  data.tar.gz: 6ba9a4dee2c426885452d19805bfd1582ecf76f0902c420d32cc6c7521085e50a2eb5c8ec7368a820612ae425ae37bdf53487df486d29275a534c87cfbc93f3f

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Mindee Ruby API Library Changelog
 
+## v4.6.0 - 2025-06-03
+### Changes
+* :sparkles: add support for address fields
+
+
 ## v4.5.0 - 2025-05-27
 ### Changes
 * :sparkles: add support for Financial Document v1.14

data/docs/global_products/financial_document_v1.md

@@ -224,6 +224,21 @@ A typical `Field` object will have the following attributes:
 Aside from the previous attributes, all basic fields have access to a `to_s` method that can be used to print their value as a string.
 
 
+### AddressField
+Aside from the basic `BaseField` attributes, the address field `AddressField` also implements the following:
+
+* **street_number** (`String`): String representation of the street number. Can be `nil`.
+* **street_name** (`String`): Name of the street. Can be `nil`.
+* **po_box** (`String`): String representation of the PO Box number. Can be `nil`.
+* **address_complement** (`String`): Address complement. Can be `nil`.
+* **city** (`String`): City name. Can be `nil`.
+* **postal_code** (`String`): String representation of the postal code. Can be `nil`.
+* **state** (`String`): State name. Can be `nil`.
+* **country** (`String`): Country name. Can be `nil`.
+
+Note: The `value` field of an AddressField should be a concatenation of the rest of the values.
+
+
 ### Amount Field
 The amount field `AmountField` only has one constraint: its **value** is a `Float` (or `nil`).
 
@@ -304,7 +319,7 @@ A `FinancialDocumentV1LineItem` implements the following attributes:
 The following fields are extracted for Financial Document V1:
 
 ## Billing Address
-**billing_address** ([StringField](#string-field)): The customer's address used for billing.
+**billing_address** ([AddressField](#address-field)): The customer's address used for billing.
 
 ```rb
 puts result.document.inference.prediction.billing_address.value
@@ -331,7 +346,7 @@ puts result.document.inference.prediction.category.value
 ```
 
 ## Customer Address
-**customer_address** ([StringField](#string-field)): The address of the customer.
+**customer_address** ([AddressField](#address-field)): The address of the customer.
 
 ```rb
 puts result.document.inference.prediction.customer_address.value
@@ -466,7 +481,7 @@ end
 ```
 
 ## Shipping Address
-**shipping_address** ([StringField](#string-field)): The customer's address used for shipping.
+**shipping_address** ([AddressField](#address-field)): The customer's address used for shipping.
 
 ```rb
 puts result.document.inference.prediction.shipping_address.value
@@ -497,7 +512,7 @@ puts result.document.inference.prediction.subcategory.value
 ```
 
 ## Supplier Address
-**supplier_address** ([StringField](#string-field)): The address of the supplier or merchant.
+**supplier_address** ([AddressField](#address-field)): The address of the supplier or merchant.
 
 ```rb
 puts result.document.inference.prediction.supplier_address.value

data/docs/global_products/invoices_v4.md

@@ -216,6 +216,21 @@ A typical `Field` object will have the following attributes:
 Aside from the previous attributes, all basic fields have access to a `to_s` method that can be used to print their value as a string.
 
 
+### AddressField
+Aside from the basic `BaseField` attributes, the address field `AddressField` also implements the following:
+
+* **street_number** (`String`): String representation of the street number. Can be `nil`.
+* **street_name** (`String`): Name of the street. Can be `nil`.
+* **po_box** (`String`): String representation of the PO Box number. Can be `nil`.
+* **address_complement** (`String`): Address complement. Can be `nil`.
+* **city** (`String`): City name. Can be `nil`.
+* **postal_code** (`String`): String representation of the postal code. Can be `nil`.
+* **state** (`String`): State name. Can be `nil`.
+* **country** (`String`): Country name. Can be `nil`.
+
+Note: The `value` field of an AddressField should be a concatenation of the rest of the values.
+
+
 ### Amount Field
 The amount field `AmountField` only has one constraint: its **value** is a `Float` (or `nil`).
 
@@ -296,7 +311,7 @@ A `InvoiceV4LineItem` implements the following attributes:
 The following fields are extracted for Invoice V4:
 
 ## Billing Address
-**billing_address** ([StringField](#string-field)): The customer billing address.
+**billing_address** ([AddressField](#address-field)): The customer billing address.
 
 ```rb
 puts result.document.inference.prediction.billing_address.value
@@ -322,7 +337,7 @@ puts result.document.inference.prediction.category.value
 ```
 
 ## Customer Address
-**customer_address** ([StringField](#string-field)): The address of the customer.
+**customer_address** ([AddressField](#address-field)): The address of the customer.
 
 ```rb
 puts result.document.inference.prediction.customer_address.value
@@ -441,7 +456,7 @@ end
 ```
 
 ## Shipping Address
-**shipping_address** ([StringField](#string-field)): Customer's delivery address.
+**shipping_address** ([AddressField](#address-field)): Customer's delivery address.
 
 ```rb
 puts result.document.inference.prediction.shipping_address.value
@@ -472,7 +487,7 @@ puts result.document.inference.prediction.subcategory.value
 ```
 
 ## Supplier Address
-**supplier_address** ([StringField](#string-field)): The address of the supplier or merchant.
+**supplier_address** ([AddressField](#address-field)): The address of the supplier or merchant.
 
 ```rb
 puts result.document.inference.prediction.supplier_address.value

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

@@ -53,7 +53,7 @@ module Mindee
           out_str << "\n:Product: #{@product.name} v#{@product.version}"
           out_str << "\n:Rotation applied: #{is_rotation_applied}"
           out_str << "\n\nPrediction\n=========="
-          out_str << "\n#{@prediction.to_s.size.positive? ? "#{@prediction}\n" : ''}"
+          out_str << "\n#{"#{@prediction}\n" if @prediction.to_s.size.positive?}"
           if @pages.any? { |page| !page.prediction.nil? }
             out_str << "\nPage Predictions\n================\n\n"
             out_str << @pages.map(&:to_s).join("\n\n")

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative 'string_field'
+
+module Mindee
+  module Parsing
+    module Standard
+      # Represents physical-address information.
+      class AddressField < Mindee::Parsing::Standard::StringField
+        # Street number
+        # @return [String, nil]
+        attr_reader :street_number
+        # Street name
+        # @return [String, nil]
+        attr_reader :street_name
+        # PO Box number
+        # @return [String, nil]
+        attr_reader :po_box
+        # Address complement
+        # @return [String, nil]
+        attr_reader :address_complement
+        #  City name.
+        # @return [String, nil]
+        attr_reader :city
+        # Postal or ZIP code.
+        # @return [String, nil]
+        attr_reader :postal_code
+        # State, province or region.
+        # @return [String, nil]
+        attr_reader :state
+        # Country.
+        # @return [String, nil]
+        attr_reader :country
+
+        def initialize(prediction, page_id = nil, reconstructed: false)
+          super
+          @street_number = prediction['street_number']
+          @street_name = prediction['street_name']
+          @po_box = prediction['po_box']
+          @address_complement = prediction['address_complement']
+          @city = prediction['city']
+          @postal_code = prediction['postal_code']
+          @state = prediction['state']
+          @country = prediction['country']
+        end
+      end
+    end
+  end
+end

data/lib/mindee/parsing/standard.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative 'standard/address_field'
 require_relative 'standard/amount_field'
 require_relative 'standard/base_field'
 require_relative 'standard/boolean_field'

data/lib/mindee/parsing/universal/universal_object_field.rb

@@ -95,7 +95,7 @@ module Mindee
         end
 
         def handle_default_field(name, value)
-          @all_values[name] = value.nil? ? nil : value.to_s
+          @all_values[name] = value&.to_s
         end
       end
 

data/lib/mindee/product/financial_document/financial_document_v1_document.rb

@@ -10,13 +10,13 @@ module Mindee
       class FinancialDocumentV1Document < Mindee::Parsing::Common::Prediction
         include Mindee::Parsing::Standard
         # The customer's address used for billing.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :billing_address
         # The purchase category.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :category
         # The address of the customer.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :customer_address
         # List of company registration numbers associated to the customer.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
@@ -65,13 +65,13 @@ module Mindee
         # @return [Array<Mindee::Parsing::Standard::StringField>]
         attr_reader :reference_numbers
         # The customer's address used for shipping.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :shipping_address
         # The purchase subcategory for transport, food and shooping.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :subcategory
         # The address of the supplier or merchant.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :supplier_address
         # List of company registration numbers associated to the supplier.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
@@ -114,7 +114,7 @@ module Mindee
         # @param page_id [Integer, nil]
         def initialize(prediction, page_id)
           super
-          @billing_address = Parsing::Standard::StringField.new(
+          @billing_address = Parsing::Standard::AddressField.new(
             prediction['billing_address'],
             page_id
           )
@@ -122,7 +122,7 @@ module Mindee
             prediction['category'],
             page_id
           )
-          @customer_address = Parsing::Standard::StringField.new(
+          @customer_address = Parsing::Standard::AddressField.new(
             prediction['customer_address'],
             page_id
           )
@@ -182,7 +182,7 @@ module Mindee
           prediction['reference_numbers'].each do |item|
             @reference_numbers.push(Parsing::Standard::StringField.new(item, page_id))
           end
-          @shipping_address = Parsing::Standard::StringField.new(
+          @shipping_address = Parsing::Standard::AddressField.new(
             prediction['shipping_address'],
             page_id
           )
@@ -190,7 +190,7 @@ module Mindee
             prediction['subcategory'],
             page_id
           )
-          @supplier_address = Parsing::Standard::StringField.new(
+          @supplier_address = Parsing::Standard::AddressField.new(
             prediction['supplier_address'],
             page_id
           )

data/lib/mindee/product/invoice/invoice_v4_document.rb

@@ -10,13 +10,13 @@ module Mindee
       class InvoiceV4Document < Mindee::Parsing::Common::Prediction
         include Mindee::Parsing::Standard
         # The customer billing address.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :billing_address
         # The purchase category.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :category
         # The address of the customer.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :customer_address
         # List of company registration numbers associated to the customer.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
@@ -58,13 +58,13 @@ module Mindee
         # @return [Array<Mindee::Parsing::Standard::StringField>]
         attr_reader :reference_numbers
         # Customer's delivery address.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :shipping_address
         # The purchase subcategory for transport, food and shopping.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :subcategory
         # The address of the supplier or merchant.
-        # @return [Mindee::Parsing::Standard::StringField]
+        # @return [Mindee::Parsing::Standard::AddressField]
         attr_reader :supplier_address
         # List of company registration numbers associated to the supplier.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
@@ -101,7 +101,7 @@ module Mindee
         # @param page_id [Integer, nil]
         def initialize(prediction, page_id)
           super
-          @billing_address = Parsing::Standard::StringField.new(
+          @billing_address = Parsing::Standard::AddressField.new(
             prediction['billing_address'],
             page_id
           )
@@ -109,7 +109,7 @@ module Mindee
             prediction['category'],
             page_id
           )
-          @customer_address = Parsing::Standard::StringField.new(
+          @customer_address = Parsing::Standard::AddressField.new(
             prediction['customer_address'],
             page_id
           )
@@ -159,7 +159,7 @@ module Mindee
           prediction['reference_numbers'].each do |item|
             @reference_numbers.push(Parsing::Standard::StringField.new(item, page_id))
           end
-          @shipping_address = Parsing::Standard::StringField.new(
+          @shipping_address = Parsing::Standard::AddressField.new(
             prediction['shipping_address'],
             page_id
           )
@@ -167,7 +167,7 @@ module Mindee
             prediction['subcategory'],
             page_id
           )
-          @supplier_address = Parsing::Standard::StringField.new(
+          @supplier_address = Parsing::Standard::AddressField.new(
             prediction['supplier_address'],
             page_id
           )

data/lib/mindee/version.rb

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

data/mindee.gemspec

@@ -37,7 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake', '~> 13.2'
   spec.add_development_dependency 'rbs', '~> 3.6'
   spec.add_development_dependency 'rspec', '~> 3.13'
-  spec.add_development_dependency 'rubocop', '~> 1.75'
+  spec.add_development_dependency 'rubocop', '~> 1.76'
   spec.add_development_dependency 'steep', '~> 1.7'
   spec.add_development_dependency 'yard', '~> 0.9'
 end

data/sig/mindee/parsing/standard/address_field.rbs

@@ -0,0 +1,18 @@
+# lib/mindee/parsing/standard/address_field.rb
+module Mindee
+  module Parsing
+    module Standard
+      class AddressField < StringField
+        def street_number: -> String
+        def street_name: -> String
+        def po_box: -> String
+        def address_complement: -> String
+        def city: -> String
+        def postal_code: -> String
+        def state: -> String
+        def country: -> String
+        def initialize: (Hash[Symbol | String, untyped], ?Integer?, ?reconstructed: bool) -> void
+      end
+    end
+  end
+end

data/sig/mindee/product/financial_document/financial_document_v1_document.rbs

@@ -5,9 +5,9 @@ module Mindee
     module FinancialDocument
       class FinancialDocumentV1Document < Parsing::Common::Prediction
         def initialize: (Hash[Symbol | String, untyped], Integer?) -> void
-        def billing_address: -> (Parsing::Standard::StringField)
+        def billing_address: -> (Parsing::Standard::AddressField)
         def category: -> (Parsing::Standard::ClassificationField)
-        def customer_address: -> (Parsing::Standard::StringField)
+        def customer_address: -> (Parsing::Standard::AddressField)
         def customer_company_registrations: -> (Array[Parsing::Standard::CompanyRegistrationField])
         def customer_id: -> (Parsing::Standard::StringField)
         def customer_name: -> (Parsing::Standard::StringField)
@@ -23,9 +23,9 @@ module Mindee
         def po_number: -> (Parsing::Standard::StringField)
         def receipt_number: -> (Parsing::Standard::StringField)
         def reference_numbers: -> (Array[Parsing::Standard::StringField])
-        def shipping_address: -> (Parsing::Standard::StringField)
+        def shipping_address: -> (Parsing::Standard::AddressField)
         def subcategory: -> (Parsing::Standard::ClassificationField)
-        def supplier_address: -> (Parsing::Standard::StringField)
+        def supplier_address: -> (Parsing::Standard::AddressField)
         def supplier_company_registrations: -> (Array[Parsing::Standard::CompanyRegistrationField])
         def supplier_email: -> (Parsing::Standard::StringField)
         def supplier_name: -> (Parsing::Standard::StringField)

data/sig/mindee/product/invoice/invoice_v4_document.rbs

@@ -5,9 +5,9 @@ module Mindee
     module Invoice
       class InvoiceV4Document < Parsing::Common::Prediction
         def initialize: (Hash[Symbol | String, untyped], Integer?) -> void
-        def billing_address: -> (Parsing::Standard::StringField)
+        def billing_address: -> (Parsing::Standard::AddressField)
         def category: -> (Parsing::Standard::ClassificationField)
-        def customer_address: -> (Parsing::Standard::StringField)
+        def customer_address: -> (Parsing::Standard::AddressField)
         def customer_company_registrations: -> (Array[Parsing::Standard::CompanyRegistrationField])
         def customer_id: -> (Parsing::Standard::StringField)
         def customer_name: -> (Parsing::Standard::StringField)
@@ -21,9 +21,9 @@ module Mindee
         def payment_date: -> (Parsing::Standard::DateField)
         def po_number: -> (Parsing::Standard::StringField)
         def reference_numbers: -> (Array[Parsing::Standard::StringField])
-        def shipping_address: -> (Parsing::Standard::StringField)
+        def shipping_address: -> (Parsing::Standard::AddressField)
         def subcategory: -> (Parsing::Standard::ClassificationField)
-        def supplier_address: -> (Parsing::Standard::StringField)
+        def supplier_address: -> (Parsing::Standard::AddressField)
         def supplier_company_registrations: -> (Array[Parsing::Standard::CompanyRegistrationField])
         def supplier_email: -> (Parsing::Standard::StringField)
         def supplier_name: -> (Parsing::Standard::StringField)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mindee
 version: !ruby/object:Gem::Version
-  version: 4.5.0
+  version: 4.6.0
 platform: ruby
 authors:
 - Mindee, SA
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-28 00:00:00.000000000 Z
+date: 2025-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -148,14 +148,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.75'
+        version: '1.76'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.75'
+        version: '1.76'
 - !ruby/object:Gem::Dependency
   name: steep
   requirement: !ruby/object:Gem::Requirement
@@ -341,6 +341,7 @@ files:
 - lib/mindee/parsing/common/workflow_response.rb
 - lib/mindee/parsing/standard.rb
 - lib/mindee/parsing/standard/abstract_field.rb
+- lib/mindee/parsing/standard/address_field.rb
 - lib/mindee/parsing/standard/amount_field.rb
 - lib/mindee/parsing/standard/base_field.rb
 - lib/mindee/parsing/standard/boolean_field.rb
@@ -588,6 +589,7 @@ files:
 - sig/mindee/parsing/common/product.rbs
 - sig/mindee/parsing/common/workflow_response.rbs
 - sig/mindee/parsing/standard/abstract_field.rbs
+- sig/mindee/parsing/standard/address_field.rbs
 - sig/mindee/parsing/standard/amount_field.rbs
 - sig/mindee/parsing/standard/base_field.rbs
 - sig/mindee/parsing/standard/boolean_field.rbs