mindee 3.18.0 → 3.19.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d2f2fd3fa8b6ca9d7756f08d3f7b526b510866d0c75a33ccfab1ff20b3ba2c6
-  data.tar.gz: 7f09aa2efbe008271aa229515ce7f804680ea46d7318c6fe62d57889785762bb
+  metadata.gz: bca81cfda2aa389c5892c16d68e78cb3204a029fe21265180e3de2478a6f8054
+  data.tar.gz: 3004a181239a458018f90258efe35940d1c466a890f92d7f221248970a13a3eb
 SHA512:
-  metadata.gz: 8bfa14969fc8938ca888b4c44a4861c969f816e5611bdf0150cec25677c3a6bb4cbd34d8e8b5a8ff48d2483fe8ed1ae462358a67bcd40176b3184122c65b5e76
-  data.tar.gz: 5afeb6406e28ea57c2a56d7f5e52f90739cb7be1b77648773d3365d52adf72f8ea6b97be16838aa428a32ce5cbc414acabe9b0d61196fc05a2027231062598f9
+  metadata.gz: a2482ecc51f3259b7ffd0b45c4239ef42ba961a83c8c93bc50fe60503857e033d5397dc41ee3fb1defbcb5320ebb134a6aeba7c8b4ba31fa6255f5c7f95b632c
+  data.tar.gz: 6f3d4b075a60c4e9ca8d01b5474568c4799df6584dc777b74489d2228d2c14d0009eca9def8f3ddda7e07527ab6fb79e80b6e9bee996025516a54256b0846b49

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Mindee Ruby API Library Changelog
 
+## v3.19.1 - 2025-01-21
+### Changes
+* :bug: fix extras failing at document level if missing from prediction
+
+
+## v3.19.0 - 2025-01-14
+### Changes
+* :sparkles: add support for US Mail V3
+* :recycle: increase async retry timers
+
+
 ## v3.18.0 - 2024-12-13
 ### Changes
 * :sparkles: allow local downloading of remote sources

data/README.md

@@ -162,6 +162,54 @@ Using the ruby bundler:
 bundle exec ruby ./bin/mindee.rb invoice path/to/your/file.ext
 ```
 
+
+### Enqueue and Parse a Webhook Response
+This is an optional way of handling asynchronous APIs.
+
+```rb
+require 'mindee'
+
+# Init a new client
+mindee_client = Mindee::Client.new(api_key: 'my-api-key')
+
+# Load a file from disk
+input_source = mindee_client.source_from_path('/path/to/the/file.ext')
+
+
+# Parse the file
+enqueue_response = mindee_client.enqueue(
+  input_source,
+  Mindee::Product::InternationalId::InternationalIdV2
+)
+
+job_id = enqueue_response.job.id
+
+# Load the JSON string sent by the Mindee webhook POST callback.
+# Reading the callback data will vary greatly depending on your HTTP server.
+# This is therefore beyond the scope of this example.
+
+local_response = Mindee::Input::LocalResponse.new(request.body.string)
+
+# You can also use a File object as the input.
+# FILE_PATH = File.join('path', 'to', 'file.json').freeze
+# local_response = Mindee::Input::LocalResponse.new(FILE_PATH);
+
+# Optional: verify the HMAC signature.
+unless local_response.valid_hmac_signature?(my_secret_key, 'invalid signature')
+  raise "Invalid HMAC signature!"
+end
+
+
+# Deserialize the response:
+result = mindee_client.load_prediction(
+        Mindee::Product::InternationalId::InternationalIdV2,
+        local_response
+)
+
+# Print a full summary of the parsed data in RST format
+puts result.document
+```
+
 ## Further Reading
 
 There's more to it than that for those that need more features, or want to

data/docs/code_samples/us_mail_v3_async.txt

@@ -0,0 +1,19 @@
+require 'mindee'
+
+# Init a new client
+mindee_client = Mindee::Client.new(api_key: 'my-api-key')
+
+# Load a file from disk
+input_source = mindee_client.source_from_path('/path/to/the/file.ext')
+
+# Parse the file
+result = mindee_client.enqueue_and_parse(
+  input_source,
+  Mindee::Product::US::UsMail::UsMailV3
+)
+
+# Print a full summary of the parsed data in RST format
+puts result.document
+
+# Print the document-level parsed data
+# puts result.document.inference.prediction

data/docs/{us_mail_v2.md → us_mail_v3.md}

@@ -22,7 +22,7 @@ input_source = mindee_client.source_from_path('/path/to/the/file.ext')
 # Parse the file
 result = mindee_client.enqueue_and_parse(
   input_source,
-  Mindee::Product::US::UsMail::UsMailV2
+  Mindee::Product::US::UsMail::UsMailV3
 )
 
 # Print a full summary of the parsed data in RST format
@@ -35,7 +35,20 @@ puts result.document
 
 **Output (RST):**
 ```rst
-:Sender Name: zed
+########
+Document
+########
+:Mindee ID: f9c36f59-977d-4ddc-9f2d-31c294c456ac
+:Filename: default_sample.jpg
+
+Inference
+#########
+:Product: mindee/us_mail v3.0
+:Rotation applied: Yes
+
+Prediction
+==========
+:Sender Name: company zed
 :Sender Address:
   :City: Dallas
   :Complete Address: 54321 Elm Street, Dallas, Texas 54321
@@ -44,11 +57,12 @@ puts result.document
   :Street: 54321 Elm Street
 :Recipient Names: Jane Doe
 :Recipient Addresses:
-  +-----------------+-------------------------------------+-------------------+-------------+------------------------+-------+---------------------------+
-  | City            | Complete Address                    | Is Address Change | Postal Code | Private Mailbox Number | State | Street                    |
-  +=================+=====================================+===================+=============+========================+=======+===========================+
-  | Detroit         | 1234 Market Street PMB 4321, Det... |                   | 12345       | 4321                   | MI    | 1234 Market Street        |
-  +-----------------+-------------------------------------+-------------------+-------------+------------------------+-------+---------------------------+
+  +-----------------+-------------------------------------+-------------------+-------------+------------------------+-------+---------------------------+-----------------+
+  | City            | Complete Address                    | Is Address Change | Postal Code | Private Mailbox Number | State | Street                    | Unit            |
+  +=================+=====================================+===================+=============+========================+=======+===========================+=================+
+  | Detroit         | 1234 Market Street PMB 4321, Det... | False             | 12345       | 4321                   | MI    | 1234 Market Street        |                 |
+  +-----------------+-------------------------------------+-------------------+-------------+------------------------+-------+---------------------------+-----------------+
+:Return to Sender: False
 ```
 
 # Field Types
@@ -78,7 +92,7 @@ Fields which are specific to this product; they are not used in any other produc
 ### Recipient Addresses Field
 The addresses of the recipients.
 
-A `UsMailV2RecipientAddress` implements the following attributes:
+A `UsMailV3RecipientAddress` implements the following attributes:
 
 * `city` (String): The city of the recipient's address.
 * `complete` (String): The complete address of the recipient.
@@ -87,12 +101,13 @@ A `UsMailV2RecipientAddress` implements the following attributes:
 * `private_mailbox_number` (String): The private mailbox number of the recipient's address.
 * `state` (String): Second part of the ISO 3166-2 code, consisting of two letters indicating the US State.
 * `street` (String): The street of the recipient's address.
+* `unit` (String): The unit number of the recipient's address.
 Fields which are specific to this product; they are not used in any other product.
 
 ### Sender Address Field
 The address of the sender.
 
-A `UsMailV2SenderAddress` implements the following attributes:
+A `UsMailV3SenderAddress` implements the following attributes:
 
 * `city` (String): The city of the sender's address.
 * `complete` (String): The complete address of the sender.
@@ -101,10 +116,17 @@ A `UsMailV2SenderAddress` implements the following attributes:
 * `street` (String): The street of the sender's address.
 
 # Attributes
-The following fields are extracted for US Mail V2:
+The following fields are extracted for US Mail V3:
+
+## Return to Sender
+**is_return_to_sender** ([BooleanField](#boolean-field)): Whether the mailing is marked as return to sender.
+
+```rb
+puts result.document.inference.prediction.is_return_to_sender.value
+```
 
 ## Recipient Addresses
-**recipient_addresses** (Array<[UsMailV2RecipientAddress](#recipient-addresses-field)>): The addresses of the recipients.
+**recipient_addresses** (Array<[UsMailV3RecipientAddress](#recipient-addresses-field)>): The addresses of the recipients.
 
 ```rb
 for recipient_addresses_elem in result.document.inference.prediction.recipient_addresses do
@@ -122,7 +144,7 @@ end
 ```
 
 ## Sender Address
-**sender_address** ([UsMailV2SenderAddress](#sender-address-field)): The address of the sender.
+**sender_address** ([UsMailV3SenderAddress](#sender-address-field)): The address of the sender.
 
 ```rb
 puts result.document.inference.prediction.sender_address.value

data/lib/mindee/client.rb

@@ -151,7 +151,7 @@ module Mindee
     #  This performs a cropping operation on the server and will increase response time.
     # @param initial_delay_sec [Integer, Float] initial delay before polling. Defaults to 2.
     # @param delay_sec [Integer, Float] delay between polling attempts. Defaults to 1.5.
-    # @param max_retries [Integer] maximum amount of retries. Defaults to 60.
+    # @param max_retries [Integer] maximum amount of retries. Defaults to 80.
     # @return [Mindee::Parsing::Common::ApiResponse]
     def enqueue_and_parse(
       input_source,
@@ -164,7 +164,7 @@ module Mindee
       cropper: false,
       initial_delay_sec: 2,
       delay_sec: 1.5,
-      max_retries: 60
+      max_retries: 80
     )
       enqueue_res = enqueue(
         input_source,

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

@@ -61,8 +61,7 @@ module Mindee
         private
 
         def inject_full_text_ocr(raw_prediction)
-          return unless raw_prediction.dig('inference', 'pages') &&
-                        raw_prediction['inference']['pages'][0]['extras']['full_text_ocr']
+          return unless raw_prediction.dig('inference', 'pages', 0, 'extras', 'full_text_ocr')
 
           full_text_ocr = String.new
           raw_prediction.dig('inference', 'pages').each do |page|

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

@@ -14,6 +14,12 @@ module Mindee
         def initialize(prediction, page_id = nil, reconstructed: false)
           super
         end
+
+        def to_s
+          return '' if value.nil?
+
+          value ? 'True' : 'False'
+        end
       end
     end
   end

data/lib/mindee/product/ind/indian_passport/indian_passport_v1_document.rb

@@ -6,7 +6,7 @@ module Mindee
   module Product
     module IND
       module IndianPassport
-        # Passport - India API version 1.0 document data.
+        # Passport - India API version 1.2 document data.
         class IndianPassportV1Document < Mindee::Parsing::Common::Prediction
           include Mindee::Parsing::Standard
           # The first line of the address of the passport holder.

data/lib/mindee/product/ind/indian_passport/indian_passport_v1_page.rb

@@ -7,7 +7,7 @@ module Mindee
   module Product
     module IND
       module IndianPassport
-        # Passport - India API version 1.0 page data.
+        # Passport - India API version 1.2 page data.
         class IndianPassportV1Page < Mindee::Parsing::Common::Page
           # @param prediction [Hash]
           def initialize(prediction)

data/lib/mindee/product/us/us_mail/us_mail_v3.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'us_mail_v3_document'
+require_relative 'us_mail_v3_page'
+
+module Mindee
+  module Product
+    module US
+      # US Mail module.
+      module UsMail
+        # US Mail API version 3 inference prediction.
+        class UsMailV3 < Mindee::Parsing::Common::Inference
+          @endpoint_name = 'us_mail'
+          @endpoint_version = '3'
+
+          # @param prediction [Hash]
+          def initialize(prediction)
+            super
+            @prediction = UsMailV3Document.new(prediction['prediction'], nil)
+            @pages = []
+            prediction['pages'].each do |page|
+              if page.key?('prediction') && !page['prediction'].nil? && !page['prediction'].empty?
+                @pages.push(UsMailV3Page.new(page))
+              end
+            end
+          end
+
+          class << self
+            # Name of the endpoint for this product.
+            # @return [String]
+            attr_reader :endpoint_name
+            # Version for this product.
+            # @return [String]
+            attr_reader :endpoint_version
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/us/us_mail/us_mail_v3_document.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'us_mail_v3_sender_address'
+require_relative 'us_mail_v3_recipient_address'
+
+module Mindee
+  module Product
+    module US
+      module UsMail
+        # US Mail API version 3.0 document data.
+        class UsMailV3Document < Mindee::Parsing::Common::Prediction
+          include Mindee::Parsing::Standard
+          # Whether the mailing is marked as return to sender.
+          # @return [Mindee::Parsing::Standard::BooleanField]
+          attr_reader :is_return_to_sender
+          # The addresses of the recipients.
+          # @return [Array<Mindee::Product::US::UsMail::UsMailV3RecipientAddress>]
+          attr_reader :recipient_addresses
+          # The names of the recipients.
+          # @return [Array<Mindee::Parsing::Standard::StringField>]
+          attr_reader :recipient_names
+          # The address of the sender.
+          # @return [Mindee::Product::US::UsMail::UsMailV3SenderAddress]
+          attr_reader :sender_address
+          # The name of the sender.
+          # @return [Mindee::Parsing::Standard::StringField]
+          attr_reader :sender_name
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super()
+            @is_return_to_sender = BooleanField.new(prediction['is_return_to_sender'], page_id)
+            @recipient_addresses = []
+            prediction['recipient_addresses'].each do |item|
+              @recipient_addresses.push(UsMailV3RecipientAddress.new(item, page_id))
+            end
+            @recipient_names = []
+            prediction['recipient_names'].each do |item|
+              @recipient_names.push(StringField.new(item, page_id))
+            end
+            @sender_address = UsMailV3SenderAddress.new(prediction['sender_address'], page_id)
+            @sender_name = StringField.new(prediction['sender_name'], page_id)
+          end
+
+          # @return [String]
+          def to_s
+            sender_address = @sender_address.to_s
+            recipient_names = @recipient_names.join("\n #{' ' * 17}")
+            recipient_addresses = recipient_addresses_to_s
+            out_str = String.new
+            out_str << "\n:Sender Name: #{@sender_name}".rstrip
+            out_str << "\n:Sender Address:"
+            out_str << sender_address
+            out_str << "\n:Recipient Names: #{recipient_names}".rstrip
+            out_str << "\n:Recipient Addresses:"
+            out_str << recipient_addresses
+            out_str << "\n:Return to Sender: #{@is_return_to_sender}".rstrip
+            out_str[1..].to_s
+          end
+
+          private
+
+          # @param char [String]
+          # @return [String]
+          def recipient_addresses_separator(char)
+            out_str = String.new
+            out_str << '  '
+            out_str << "+#{char * 17}"
+            out_str << "+#{char * 37}"
+            out_str << "+#{char * 19}"
+            out_str << "+#{char * 13}"
+            out_str << "+#{char * 24}"
+            out_str << "+#{char * 7}"
+            out_str << "+#{char * 27}"
+            out_str << "+#{char * 17}"
+            out_str << '+'
+            out_str
+          end
+
+          # @return [String]
+          def recipient_addresses_to_s
+            return '' if @recipient_addresses.empty?
+
+            line_items = @recipient_addresses.map(&:to_table_line).join("\n#{recipient_addresses_separator('-')}\n  ")
+            out_str = String.new
+            out_str << "\n#{recipient_addresses_separator('-')}"
+            out_str << "\n  |"
+            out_str << ' City            |'
+            out_str << ' Complete Address                    |'
+            out_str << ' Is Address Change |'
+            out_str << ' Postal Code |'
+            out_str << ' Private Mailbox Number |'
+            out_str << ' State |'
+            out_str << ' Street                    |'
+            out_str << ' Unit            |'
+            out_str << "\n#{recipient_addresses_separator('=')}"
+            out_str << "\n  #{line_items}"
+            out_str << "\n#{recipient_addresses_separator('-')}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/us/us_mail/us_mail_v3_page.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'us_mail_v3_document'
+
+module Mindee
+  module Product
+    module US
+      module UsMail
+        # US Mail API version 3.0 page data.
+        class UsMailV3Page < Mindee::Parsing::Common::Page
+          # @param prediction [Hash]
+          def initialize(prediction)
+            super(prediction)
+            @prediction = UsMailV3PagePrediction.new(
+              prediction['prediction'],
+              prediction['id']
+            )
+          end
+        end
+
+        # US Mail V3 page prediction.
+        class UsMailV3PagePrediction < UsMailV3Document
+          # @return [String]
+          def to_s
+            out_str = String.new
+            out_str << "\n#{super}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/us/us_mail/us_mail_v3_recipient_address.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module US
+      module UsMail
+        # The addresses of the recipients.
+        class UsMailV3RecipientAddress < Mindee::Parsing::Standard::FeatureField
+          include Mindee::Parsing::Standard
+          # The city of the recipient's address.
+          # @return [String]
+          attr_reader :city
+          # The complete address of the recipient.
+          # @return [String]
+          attr_reader :complete
+          # Indicates if the recipient's address is a change of address.
+          # @return [Boolean]
+          attr_reader :is_address_change
+          # The postal code of the recipient's address.
+          # @return [String]
+          attr_reader :postal_code
+          # The private mailbox number of the recipient's address.
+          # @return [String]
+          attr_reader :private_mailbox_number
+          # Second part of the ISO 3166-2 code, consisting of two letters indicating the US State.
+          # @return [String]
+          attr_reader :state
+          # The street of the recipient's address.
+          # @return [String]
+          attr_reader :street
+          # The unit number of the recipient's address.
+          # @return [String]
+          attr_reader :unit
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super(prediction, page_id)
+            @city = prediction['city']
+            @complete = prediction['complete']
+            @is_address_change = prediction['is_address_change']
+            @postal_code = prediction['postal_code']
+            @private_mailbox_number = prediction['private_mailbox_number']
+            @state = prediction['state']
+            @street = prediction['street']
+            @unit = prediction['unit']
+            @page_id = page_id
+          end
+
+          # @return [Hash]
+          def printable_values
+            printable = {}
+            printable[:city] = format_for_display(@city)
+            printable[:complete] = format_for_display(@complete)
+            printable[:is_address_change] = format_for_display(@is_address_change)
+            printable[:postal_code] = format_for_display(@postal_code)
+            printable[:private_mailbox_number] = format_for_display(@private_mailbox_number)
+            printable[:state] = format_for_display(@state)
+            printable[:street] = format_for_display(@street)
+            printable[:unit] = format_for_display(@unit)
+            printable
+          end
+
+          # @return [Hash]
+          def table_printable_values
+            printable = {}
+            printable[:city] = format_for_display(@city, 15)
+            printable[:complete] = format_for_display(@complete, 35)
+            printable[:is_address_change] = format_for_display(@is_address_change, nil)
+            printable[:postal_code] = format_for_display(@postal_code, nil)
+            printable[:private_mailbox_number] = format_for_display(@private_mailbox_number, nil)
+            printable[:state] = format_for_display(@state, nil)
+            printable[:street] = format_for_display(@street, 25)
+            printable[:unit] = format_for_display(@unit, 15)
+            printable
+          end
+
+          # @return [String]
+          def to_table_line
+            printable = table_printable_values
+            out_str = String.new
+            out_str << format('| %- 16s', printable[:city])
+            out_str << format('| %- 36s', printable[:complete])
+            out_str << format('| %- 18s', printable[:is_address_change])
+            out_str << format('| %- 12s', printable[:postal_code])
+            out_str << format('| %- 23s', printable[:private_mailbox_number])
+            out_str << format('| %- 6s', printable[:state])
+            out_str << format('| %- 26s', printable[:street])
+            out_str << format('| %- 16s', printable[:unit])
+            out_str << '|'
+          end
+
+          # @return [String]
+          def to_s
+            printable = printable_values
+            out_str = String.new
+            out_str << "\n  :City: #{printable[:city]}"
+            out_str << "\n  :Complete Address: #{printable[:complete]}"
+            out_str << "\n  :Is Address Change: #{printable[:is_address_change]}"
+            out_str << "\n  :Postal Code: #{printable[:postal_code]}"
+            out_str << "\n  :Private Mailbox Number: #{printable[:private_mailbox_number]}"
+            out_str << "\n  :State: #{printable[:state]}"
+            out_str << "\n  :Street: #{printable[:street]}"
+            out_str << "\n  :Unit: #{printable[:unit]}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/us/us_mail/us_mail_v3_sender_address.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module US
+      module UsMail
+        # The address of the sender.
+        class UsMailV3SenderAddress < Mindee::Parsing::Standard::FeatureField
+          include Mindee::Parsing::Standard
+          # The city of the sender's address.
+          # @return [String]
+          attr_reader :city
+          # The complete address of the sender.
+          # @return [String]
+          attr_reader :complete
+          # The postal code of the sender's address.
+          # @return [String]
+          attr_reader :postal_code
+          # Second part of the ISO 3166-2 code, consisting of two letters indicating the US State.
+          # @return [String]
+          attr_reader :state
+          # The street of the sender's address.
+          # @return [String]
+          attr_reader :street
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super(prediction, page_id)
+            @city = prediction['city']
+            @complete = prediction['complete']
+            @postal_code = prediction['postal_code']
+            @state = prediction['state']
+            @street = prediction['street']
+            @page_id = page_id
+          end
+
+          # @return [Hash]
+          def printable_values
+            printable = {}
+            printable[:city] = format_for_display(@city)
+            printable[:complete] = format_for_display(@complete)
+            printable[:postal_code] = format_for_display(@postal_code)
+            printable[:state] = format_for_display(@state)
+            printable[:street] = format_for_display(@street)
+            printable
+          end
+
+          # @return [String]
+          def to_s
+            printable = printable_values
+            out_str = String.new
+            out_str << "\n  :City: #{printable[:city]}"
+            out_str << "\n  :Complete Address: #{printable[:complete]}"
+            out_str << "\n  :Postal Code: #{printable[:postal_code]}"
+            out_str << "\n  :State: #{printable[:state]}"
+            out_str << "\n  :Street: #{printable[:street]}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product.rb

@@ -36,4 +36,5 @@ 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,7 +3,7 @@
 # Mindee
 module Mindee
   # Current version.
-  VERSION = '3.18.0'
+  VERSION = '3.19.1'
 
   # Finds and return the current platform.
   # @return [String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mindee
 version: !ruby/object:Gem::Version
-  version: 3.18.0
+  version: 3.19.1
 platform: ruby
 authors:
 - Mindee, SA
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-13 00:00:00.000000000 Z
+date: 2025-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: marcel
@@ -198,6 +198,7 @@ files:
 - docs/code_samples/us_driver_license_v1.txt
 - docs/code_samples/us_healthcare_cards_v1_async.txt
 - docs/code_samples/us_mail_v2_async.txt
+- docs/code_samples/us_mail_v3_async.txt
 - docs/code_samples/us_w9_v1.txt
 - docs/code_samples/workflow_execution.txt
 - docs/cropper_v1.md
@@ -223,7 +224,7 @@ files:
 - docs/payslip_fra_v3.md
 - docs/resume_v1.md
 - docs/us_healthcare_cards_v1.md
-- docs/us_mail_v2.md
+- docs/us_mail_v3.md
 - docs/us_w9_v1.md
 - examples/auto_invoice_splitter_extraction.rb
 - examples/auto_multi_receipts_detector_extraction.rb
@@ -470,6 +471,11 @@ files:
 - lib/mindee/product/us/us_mail/us_mail_v2_page.rb
 - lib/mindee/product/us/us_mail/us_mail_v2_recipient_address.rb
 - lib/mindee/product/us/us_mail/us_mail_v2_sender_address.rb
+- lib/mindee/product/us/us_mail/us_mail_v3.rb
+- lib/mindee/product/us/us_mail/us_mail_v3_document.rb
+- lib/mindee/product/us/us_mail/us_mail_v3_page.rb
+- lib/mindee/product/us/us_mail/us_mail_v3_recipient_address.rb
+- lib/mindee/product/us/us_mail/us_mail_v3_sender_address.rb
 - lib/mindee/product/us/w9/w9_v1.rb
 - lib/mindee/product/us/w9/w9_v1_document.rb
 - lib/mindee/product/us/w9/w9_v1_page.rb
@@ -483,7 +489,7 @@ metadata:
   source_code_uri: https://github.com/mindee/mindee-api-ruby
   changelog_uri: https://github.com/mindee/mindee-api-ruby/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -499,7 +505,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.6
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Mindee API Helper Library for Ruby
 test_files: []