mindee 3.16.0 → 3.18.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mindee
 version: !ruby/object:Gem::Version
-  version: 3.16.0
+  version: 3.18.0
 platform: ruby
 authors:
 - Mindee, SA
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-11-14 00:00:00.000000000 Z
+date: 2024-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: marcel
@@ -158,7 +158,6 @@ files:
 - docs/bill_of_lading_v1.md
 - docs/business_card_v1.md
 - docs/carte_grise_v1.md
-- docs/carte_vitale_v1.md
 - docs/code_samples/bank_account_details_v1.txt
 - docs/code_samples/bank_account_details_v2.txt
 - docs/code_samples/bank_check_v1.txt
@@ -167,12 +166,12 @@ files:
 - docs/code_samples/bill_of_lading_v1_async.txt
 - docs/code_samples/business_card_v1_async.txt
 - docs/code_samples/carte_grise_v1.txt
-- docs/code_samples/carte_vitale_v1.txt
 - docs/code_samples/cropper_v1.txt
 - docs/code_samples/custom_v1.txt
 - docs/code_samples/default.txt
 - docs/code_samples/default_async.txt
 - docs/code_samples/delivery_notes_v1_async.txt
+- docs/code_samples/driver_license_v1_async.txt
 - docs/code_samples/energy_bill_fra_v1_async.txt
 - docs/code_samples/eu_driver_license_v1.txt
 - docs/code_samples/expense_receipts_v4.txt
@@ -180,10 +179,10 @@ files:
 - docs/code_samples/expense_receipts_v5_async.txt
 - docs/code_samples/financial_document_v1.txt
 - docs/code_samples/financial_document_v1_async.txt
+- docs/code_samples/french_healthcard_v1_async.txt
 - docs/code_samples/idcard_fr_v1.txt
 - docs/code_samples/idcard_fr_v2.txt
 - docs/code_samples/ind_passport_v1_async.txt
-- docs/code_samples/international_id_v1_async.txt
 - docs/code_samples/international_id_v2_async.txt
 - docs/code_samples/invoice_splitter_v1_async.txt
 - docs/code_samples/invoices_v4.txt
@@ -193,19 +192,22 @@ files:
 - docs/code_samples/nutrition_facts_v1_async.txt
 - docs/code_samples/passport_v1.txt
 - docs/code_samples/payslip_fra_v2_async.txt
+- docs/code_samples/payslip_fra_v3_async.txt
 - docs/code_samples/proof_of_address_v1.txt
 - docs/code_samples/resume_v1_async.txt
 - 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_w9_v1.txt
+- docs/code_samples/workflow_execution.txt
 - docs/cropper_v1.md
 - docs/custom_v1.md
 - docs/delivery_notes_v1.md
+- docs/driver_license_v1.md
 - docs/energy_bill_fra_v1.md
-- docs/eu_driver_license_v1.md
 - docs/expense_receipts_v5.md
 - docs/financial_document_v1.md
+- docs/french_healthcard_v1.md
 - docs/generated_v1.md
 - docs/getting_started.md
 - docs/idcard_fr_v2.md
@@ -218,9 +220,8 @@ files:
 - docs/nutrition_facts_v1.md
 - docs/passport_v1.md
 - docs/payslip_fra_v2.md
-- docs/proof_of_address_v1.md
+- docs/payslip_fra_v3.md
 - docs/resume_v1.md
-- docs/us_driver_license_v1.md
 - docs/us_healthcare_cards_v1.md
 - docs/us_mail_v2.md
 - docs/us_w9_v1.md
@@ -251,16 +252,26 @@ files:
 - lib/mindee/http/endpoint.rb
 - lib/mindee/http/error.rb
 - lib/mindee/http/response_validation.rb
+- lib/mindee/http/workflow_endpoint.rb
 - lib/mindee/image.rb
 - lib/mindee/image/image_compressor.rb
 - lib/mindee/image/image_utils.rb
 - lib/mindee/input.rb
 - lib/mindee/input/local_response.rb
 - lib/mindee/input/sources.rb
+- lib/mindee/input/sources/base64_input_source.rb
+- lib/mindee/input/sources/bytes_input_source.rb
+- lib/mindee/input/sources/file_input_source.rb
+- lib/mindee/input/sources/local_input_source.rb
+- lib/mindee/input/sources/path_input_source.rb
+- lib/mindee/input/sources/url_input_source.rb
 - lib/mindee/parsing.rb
 - lib/mindee/parsing/common.rb
 - lib/mindee/parsing/common/api_response.rb
 - lib/mindee/parsing/common/document.rb
+- lib/mindee/parsing/common/execution.rb
+- lib/mindee/parsing/common/execution_file.rb
+- lib/mindee/parsing/common/execution_priority.rb
 - lib/mindee/parsing/common/extras.rb
 - lib/mindee/parsing/common/extras/cropper_extra.rb
 - lib/mindee/parsing/common/extras/extras.rb
@@ -320,6 +331,9 @@ files:
 - lib/mindee/product/delivery_note/delivery_note_v1.rb
 - lib/mindee/product/delivery_note/delivery_note_v1_document.rb
 - lib/mindee/product/delivery_note/delivery_note_v1_page.rb
+- lib/mindee/product/driver_license/driver_license_v1.rb
+- lib/mindee/product/driver_license/driver_license_v1_document.rb
+- lib/mindee/product/driver_license/driver_license_v1_page.rb
 - lib/mindee/product/eu/driver_license/driver_license_v1.rb
 - lib/mindee/product/eu/driver_license/driver_license_v1_document.rb
 - lib/mindee/product/eu/driver_license/driver_license_v1_page.rb
@@ -344,9 +358,6 @@ files:
 - lib/mindee/product/fr/carte_grise/carte_grise_v1.rb
 - lib/mindee/product/fr/carte_grise/carte_grise_v1_document.rb
 - lib/mindee/product/fr/carte_grise/carte_grise_v1_page.rb
-- lib/mindee/product/fr/carte_vitale/carte_vitale_v1.rb
-- lib/mindee/product/fr/carte_vitale/carte_vitale_v1_document.rb
-- lib/mindee/product/fr/carte_vitale/carte_vitale_v1_page.rb
 - lib/mindee/product/fr/energy_bill/energy_bill_v1.rb
 - lib/mindee/product/fr/energy_bill/energy_bill_v1_document.rb
 - lib/mindee/product/fr/energy_bill/energy_bill_v1_energy_consumer.rb
@@ -356,6 +367,9 @@ files:
 - lib/mindee/product/fr/energy_bill/energy_bill_v1_page.rb
 - lib/mindee/product/fr/energy_bill/energy_bill_v1_subscription.rb
 - lib/mindee/product/fr/energy_bill/energy_bill_v1_taxes_and_contribution.rb
+- lib/mindee/product/fr/health_card/health_card_v1.rb
+- lib/mindee/product/fr/health_card/health_card_v1_document.rb
+- lib/mindee/product/fr/health_card/health_card_v1_page.rb
 - lib/mindee/product/fr/id_card/id_card_v1.rb
 - lib/mindee/product/fr/id_card/id_card_v1_document.rb
 - lib/mindee/product/fr/id_card/id_card_v1_page.rb
@@ -373,6 +387,17 @@ files:
 - lib/mindee/product/fr/payslip/payslip_v2_pay_period.rb
 - lib/mindee/product/fr/payslip/payslip_v2_pto.rb
 - lib/mindee/product/fr/payslip/payslip_v2_salary_detail.rb
+- lib/mindee/product/fr/payslip/payslip_v3.rb
+- lib/mindee/product/fr/payslip/payslip_v3_bank_account_detail.rb
+- lib/mindee/product/fr/payslip/payslip_v3_document.rb
+- lib/mindee/product/fr/payslip/payslip_v3_employee.rb
+- lib/mindee/product/fr/payslip/payslip_v3_employer.rb
+- lib/mindee/product/fr/payslip/payslip_v3_employment.rb
+- lib/mindee/product/fr/payslip/payslip_v3_page.rb
+- lib/mindee/product/fr/payslip/payslip_v3_paid_time_off.rb
+- lib/mindee/product/fr/payslip/payslip_v3_pay_detail.rb
+- lib/mindee/product/fr/payslip/payslip_v3_pay_period.rb
+- lib/mindee/product/fr/payslip/payslip_v3_salary_detail.rb
 - lib/mindee/product/generated/generated_v1.rb
 - lib/mindee/product/generated/generated_v1_document.rb
 - lib/mindee/product/generated/generated_v1_page.rb
@@ -380,9 +405,6 @@ files:
 - lib/mindee/product/ind/indian_passport/indian_passport_v1.rb
 - lib/mindee/product/ind/indian_passport/indian_passport_v1_document.rb
 - lib/mindee/product/ind/indian_passport/indian_passport_v1_page.rb
-- lib/mindee/product/international_id/international_id_v1.rb
-- lib/mindee/product/international_id/international_id_v1_document.rb
-- lib/mindee/product/international_id/international_id_v1_page.rb
 - lib/mindee/product/international_id/international_id_v2.rb
 - lib/mindee/product/international_id/international_id_v2_document.rb
 - lib/mindee/product/international_id/international_id_v2_page.rb

data/docs/eu_driver_license_v1.md

@@ -1,227 +0,0 @@
----
-title: EU Driver License OCR Ruby
-category: 622b805aaec68102ea7fcbc2
-slug: ruby-eu-driver-license-ocr
-parentDoc: 6294d97ee723f1008d2ab28e
----
-The Ruby OCR SDK supports the [Driver License API](https://platform.mindee.com/mindee/eu_driver_license).
-
-Using the [sample below](https://github.com/mindee/client-lib-test-data/blob/main/products/eu_driver_license/default_sample.jpg), we are going to illustrate how to extract the data that we want using the OCR SDK.
-![Driver License sample](https://github.com/mindee/client-lib-test-data/blob/main/products/eu_driver_license/default_sample.jpg?raw=true)
-
-# Quick-Start
-```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
-result = mindee_client.parse(
-  input_source,
-  Mindee::Product::EU::DriverLicense::DriverLicenseV1
-)
-
-# 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
-
-```
-
-**Output (RST):**
-```rst
-########
-Document
-########
-:Mindee ID: b19cc32e-b3e6-4ff9-bdc7-619199355d54
-:Filename: default_sample.jpg
-
-Inference
-#########
-:Product: mindee/eu_driver_license v1.0
-:Rotation applied: Yes
-
-Prediction
-==========
-:Country Code: FR
-:Document ID: 13AA00002
-:Driver License Category: AM A1 B1 B D BE DE
-:Last Name: MARTIN
-:First Name: PAUL
-:Date Of Birth: 1981-07-14
-:Place Of Birth: Utopiacity
-:Expiry Date: 2018-12-31
-:Issue Date: 2013-01-01
-:Issue Authority: 99999UpiaCity
-:MRZ: D1FRA13AA000026181231MARTIN<<9
-:Address:
-
-Page Predictions
-================
-
-Page 0
-------
-:Photo: Polygon with 4 points.
-:Signature: Polygon with 4 points.
-:Country Code: FR
-:Document ID: 13AA00002
-:Driver License Category: AM A1 B1 B D BE DE
-:Last Name: MARTIN
-:First Name: PAUL
-:Date Of Birth: 1981-07-14
-:Place Of Birth: Utopiacity
-:Expiry Date: 2018-12-31
-:Issue Date: 2013-01-01
-:Issue Authority: 99999UpiaCity
-:MRZ: D1FRA13AA000026181231MARTIN<<9
-:Address:
-```
-
-# Field Types
-## Standard Fields
-These fields are generic and used in several products.
-
-### Basic Field
-Each prediction object contains a set of fields that inherit from the generic `Field` class.
-A typical `Field` object will have the following attributes:
-
-* **value** (`String`, `Float`, `Integer`, `Boolean`): corresponds to the field value. Can be `nil` if no value was extracted.
-* **confidence** (Float, nil): the confidence score of the field prediction.
-* **bounding_box** (`Mindee::Geometry::Quadrilateral`, `nil`): contains exactly 4 relative vertices (points) coordinates of a right rectangle containing the field in the document.
-* **polygon** (`Mindee::Geometry::Polygon`, `nil`): contains the relative vertices coordinates (`Point`) of a polygon containing the field in the image.
-* **page_id** (`Integer`, `nil`): the ID of the page, always `nil` when at document-level.
-* **reconstructed** (`Boolean`): indicates whether an object was reconstructed (not extracted as the API gave it).
-
-
-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.
-
-### Date Field
-Aside from the basic `Field` attributes, the date field `DateField` also implements the following: 
-
-* **date_object** (`Date`): an accessible representation of the value as a JavaScript object.
-
-
-### Position Field
-The position field `PositionField` does not implement all the basic `Field` attributes, only **bounding_box**, **polygon** and **page_id**. On top of these, it has access to:
-
-* **rectangle** (`Mindee::Geometry::Quadrilateral`): a Polygon with four points that may be oriented (even beyond canvas).
-* **quadrangle** (`Mindee::Geometry::Quadrilateral`): a free polygon made up of four points.
-
-### String Field
-The text field `StringField` only has one constraint: it's **value** is a `String` (or `nil`).
-
-## Page-Level Fields
-Some fields are constrained to the page level, and so will not be retrievable at document level.
-
-# Attributes
-The following fields are extracted for Driver License V1:
-
-## Address
-**address** ([StringField](#string-field)): EU driver license holders address
-
-```rb
-puts result.document.inference.prediction.address.value
-```
-
-## Driver License Category
-**category** ([StringField](#string-field)): EU driver license holders categories
-
-```rb
-puts result.document.inference.prediction.category.value
-```
-
-## Country Code
-**country_code** ([StringField](#string-field)): Country code extracted as a string.
-
-```rb
-puts result.document.inference.prediction.country_code.value
-```
-
-## Date Of Birth
-**date_of_birth** ([DateField](#date-field)): The date of birth of the document holder
-
-```rb
-puts result.document.inference.prediction.date_of_birth.value
-```
-
-## Document ID
-**document_id** ([StringField](#string-field)): ID number of the Document.
-
-```rb
-puts result.document.inference.prediction.document_id.value
-```
-
-## Expiry Date
-**expiry_date** ([DateField](#date-field)): Date the document expires
-
-```rb
-puts result.document.inference.prediction.expiry_date.value
-```
-
-## First Name
-**first_name** ([StringField](#string-field)): First name(s) of the driver license holder
-
-```rb
-puts result.document.inference.prediction.first_name.value
-```
-
-## Issue Authority
-**issue_authority** ([StringField](#string-field)): Authority that issued the document
-
-```rb
-puts result.document.inference.prediction.issue_authority.value
-```
-
-## Issue Date
-**issue_date** ([DateField](#date-field)): Date the document was issued
-
-```rb
-puts result.document.inference.prediction.issue_date.value
-```
-
-## Last Name
-**last_name** ([StringField](#string-field)): Last name of the driver license holder.
-
-```rb
-puts result.document.inference.prediction.last_name.value
-```
-
-## MRZ
-**mrz** ([StringField](#string-field)): Machine-readable license number
-
-```rb
-puts result.document.inference.prediction.mrz.value
-```
-
-## Photo
-[📄](#page-level-fields "This field is only present on individual pages.")**photo** ([PositionField](#position-field)): Has a photo of the EU driver license holder
-
-```rb
-for photo_elem in result.document.photo do
-  puts photo_elem.polygon
-end
-```
-
-## Place Of Birth
-**place_of_birth** ([StringField](#string-field)): Place where the driver license holder was born
-
-```rb
-puts result.document.inference.prediction.place_of_birth.value
-```
-
-## Signature
-[📄](#page-level-fields "This field is only present on individual pages.")**signature** ([PositionField](#position-field)): Has a signature of the EU driver license holder
-
-```rb
-for signature_elem in result.document.signature do
-  puts signature_elem.polygon
-end
-```
-
-# Questions?
-[Join our Slack](https://join.slack.com/t/mindee-community/shared_invite/zt-2d0ds7dtz-DPAF81ZqTy20chsYpQBW5g)

data/docs/proof_of_address_v1.md

@@ -1,211 +0,0 @@
----
-title: Proof of Address OCR Ruby
-category: 622b805aaec68102ea7fcbc2
-slug: ruby-proof-of-address-ocr
-parentDoc: 6294d97ee723f1008d2ab28e
----
-The Ruby OCR SDK supports the [Proof of Address API](https://platform.mindee.com/mindee/proof_of_address).
-
-Using the [sample below](https://github.com/mindee/client-lib-test-data/blob/main/products/proof_of_address/default_sample.jpg), we are going to illustrate how to extract the data that we want using the OCR SDK.
-![Proof of Address sample](https://github.com/mindee/client-lib-test-data/blob/main/products/proof_of_address/default_sample.jpg?raw=true)
-
-# Quick-Start
-```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
-result = mindee_client.parse(
-  input_source,
-  Mindee::Product::ProofOfAddress::ProofOfAddressV1
-)
-
-# 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
-
-```
-
-**Output (RST):**
-```rst
-########
-Document
-########
-:Mindee ID: 5d2361e9-405e-4fc1-8531-f92a3aef0c38
-:Filename: default_sample.jpg
-
-Inference
-#########
-:Product: mindee/proof_of_address v1.1
-:Rotation applied: Yes
-
-Prediction
-==========
-:Locale: en; en; USD;
-:Issuer Name: PPL ELECTRIC UTILITIES
-:Issuer Company Registrations:
-:Issuer Address: 2 NORTH 9TH STREET CPC-GENN1 ALLENTOWN.PA 18101-1175
-:Recipient Name:
-:Recipient Company Registrations:
-:Recipient Address: 123 MAIN ST ANYTOWN,PA 18062
-:Dates: 2011-07-27
-        2011-07-06
-        2011-08-03
-        2011-07-27
-        2011-06-01
-        2011-07-01
-        2010-07-01
-        2010-08-01
-        2011-07-01
-        2009-08-01
-        2010-07-01
-        2011-07-27
-:Date of Issue: 2011-07-27
-
-Page Predictions
-================
-
-Page 0
-------
-:Locale: en; en; USD;
-:Issuer Name: PPL ELECTRIC UTILITIES
-:Issuer Company Registrations:
-:Issuer Address: 2 NORTH 9TH STREET CPC-GENN1 ALLENTOWN.PA 18101-1175
-:Recipient Name:
-:Recipient Company Registrations:
-:Recipient Address: 123 MAIN ST ANYTOWN,PA 18062
-:Dates: 2011-07-27
-        2011-07-06
-        2011-08-03
-        2011-07-27
-        2011-06-01
-        2011-07-01
-        2010-07-01
-        2010-08-01
-        2011-07-01
-        2009-08-01
-        2010-07-01
-        2011-07-27
-:Date of Issue: 2011-07-27
-```
-
-# Field Types
-## Standard Fields
-These fields are generic and used in several products.
-
-### Basic Field
-Each prediction object contains a set of fields that inherit from the generic `Field` class.
-A typical `Field` object will have the following attributes:
-
-* **value** (`String`, `Float`, `Integer`, `Boolean`): corresponds to the field value. Can be `nil` if no value was extracted.
-* **confidence** (Float, nil): the confidence score of the field prediction.
-* **bounding_box** (`Mindee::Geometry::Quadrilateral`, `nil`): contains exactly 4 relative vertices (points) coordinates of a right rectangle containing the field in the document.
-* **polygon** (`Mindee::Geometry::Polygon`, `nil`): contains the relative vertices coordinates (`Point`) of a polygon containing the field in the image.
-* **page_id** (`Integer`, `nil`): the ID of the page, always `nil` when at document-level.
-* **reconstructed** (`Boolean`): indicates whether an object was reconstructed (not extracted as the API gave it).
-
-
-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.
-
-
-### Company Registration Field
-Aside from the basic `Field` attributes, the company registration field `CompanyRegistrationField` also implements the following:
-
-* **type** (`String`): the type of company.
-
-### Date Field
-Aside from the basic `Field` attributes, the date field `DateField` also implements the following: 
-
-* **date_object** (`Date`): an accessible representation of the value as a JavaScript object.
-
-### Locale Field
-The locale field `LocaleField` only implements the **value**, **confidence** and **page_id** base `Field` attributes, but it comes with its own:
-
-* **language** (`String`): ISO 639-1 language code (e.g.: `en` for English). Can be `nil`.
-* **country** (`String`): ISO 3166-1 alpha-2 or ISO 3166-1 alpha-3 code for countries (e.g.: `GRB` or `GB` for "Great Britain"). Can be `nil`.
-* **currency** (`String`): ISO 4217 code for currencies (e.g.: `USD` for "US Dollars"). Can be `nil`.
-
-### String Field
-The text field `StringField` only has one constraint: it's **value** is a `String` (or `nil`).
-
-# Attributes
-The following fields are extracted for Proof of Address V1:
-
-## Date of Issue
-**date** ([DateField](#date-field)): The date the document was issued.
-
-```rb
-puts result.document.inference.prediction.date.value
-```
-
-## Dates
-**dates** (Array<[DateField](#date-field)>): List of dates found on the document.
-
-```rb
-for dates_elem in result.document.inference.prediction.dates do
-  puts dates_elem.value
-end
-```
-
-## Issuer Address
-**issuer_address** ([StringField](#string-field)): The address of the document's issuer.
-
-```rb
-puts result.document.inference.prediction.issuer_address.value
-```
-
-## Issuer Company Registrations
-**issuer_company_registration** (Array<[CompanyRegistrationField](#company-registration-field)>): List of company registrations found for the issuer.
-
-```rb
-for issuer_company_registration_elem in result.document.inference.prediction.issuer_company_registration do
-  puts issuer_company_registration_elem.value
-end
-```
-
-## Issuer Name
-**issuer_name** ([StringField](#string-field)): The name of the person or company issuing the document.
-
-```rb
-puts result.document.inference.prediction.issuer_name.value
-```
-
-## Locale
-**locale** ([LocaleField](#locale-field)): The locale detected on the document.
-
-```rb
-puts result.document.inference.prediction.locale.value
-```
-
-## Recipient Address
-**recipient_address** ([StringField](#string-field)): The address of the recipient.
-
-```rb
-puts result.document.inference.prediction.recipient_address.value
-```
-
-## Recipient Company Registrations
-**recipient_company_registration** (Array<[CompanyRegistrationField](#company-registration-field)>): List of company registrations found for the recipient.
-
-```rb
-for recipient_company_registration_elem in result.document.inference.prediction.recipient_company_registration do
-  puts recipient_company_registration_elem.value
-end
-```
-
-## Recipient Name
-**recipient_name** ([StringField](#string-field)): The name of the person or company receiving the document.
-
-```rb
-puts result.document.inference.prediction.recipient_name.value
-```
-
-# Questions?
-[Join our Slack](https://join.slack.com/t/mindee-community/shared_invite/zt-2d0ds7dtz-DPAF81ZqTy20chsYpQBW5g)