@microblink/blinkid-in-browser-sdk - npm Package Versions

5.14.2

• We've expanded support for part:: selector by exposing all nested web components.
• We've fixed styles regarding width and height for camera scanning UI to provide more flexibility to developers.

5.14.1

• We've added support for part:: selector to provide more flexibility when customizing built-in UI. #35

UI bug fixes

• We've fixed a bug where a user couldn't upload an image after the camera scan failed to start.
• We've fixed a bug where the video feed wasn't released in the scenario where the UI component was removed from the DOM.
• We've reverted style changes regarding width and height for camera scanning UI to provide more flexibility to developers.
• We've improved memory management during the initialization of the UI component to avoid the creation of unnecessary web workers.

5.14.0

Back side support added:

• Thailand - ID Card

Improvements

• Extraction of father’s and mother’s names from Mexico Voter ID Card
• The driver license unique card number is extracted as document_additional_number for Australian Driving Licenses, regions New South Wales, Northern Territory, Queensland, Victoria and Western Australia
• We've improved the accuracy of barcode scanning on identity documents

Changes to BlinkID(Combined) Recognizer

• We've added two new result fields - fathersName and mothersName both in BlinkID and BlinkIDCombined Recognizers, as well as in VIZ result

Changes to BarcodeRecognizer

• We’ve removed support for aztec and dataMatrix barcode formats

Changes to MRTDRecognizer

• We've added MRTD_TYPE_BORDER_CROSSING_CARD type to MRTD enum

Platform-related SDK changes

• We've added a camera management UI module for the selection of connected cameras
  • We've added VideoRecognizer.changeCameraDevice method that can be used to change the active camera device during the scanning session
• We've improved accessibility of the UI component by changing background contrasts and increasing default font sizes

Bug fixes

• We've optimised memory usage of the SDK by fixing a problem where every refresh of the UI component would result in a new instance of web worker

5.13.0

New additions to our supported document list

We’ve added 61 new documents:

Europe

• Austria - Paper Passport
• Belarus - Paper Passport
• Belgium - Paper Passport (beta)
• Bulgaria - Paper Passport
• Estonia - Paper Passport
• France - Paper Passport (beta)
• Georgia - Paper Passport (beta)
• Germany - Paper Passport
• Greece - Paper Passport
• Hungary- Paper Passport
• Italy - Paper Passport (beta)
• Kosovo - Paper Passport
• Moldova - Paper Passport (beta)
• Poland - Paper Passport
• Portugal - Paper Passport
• Spain - Paper Passport
• Switzerland - Paper Passport
• UK - Paper Passport

Middle East and Africa

• Algeria - Paper Passport (beta)
• Egypt - Paper Passport (beta)
• Eswatini - Paper Passport
• Ghana - Paper Passport
• Iran - Paper Passport (beta)
• Iraq - Paper Passport (beta)
• Israel - Paper Passport (beta)
• Jordan - Paper Passport (beta)
• Kenya - Polycarbonate Passport
• Libya - Polycarbonate Passport (beta)
• Morocco - Paper Passport (beta)
• Nigeria - Paper Passport
• Nigeria - Polycarbonate Passport (beta)
• Qatar - ID Card (front only, beta)
• Saudi Arabia - Paper Passport
• Syria - Paper Passport
• Tanzania - ID Card (beta)
• Tanzania - Voter ID (front only, beta)
• Tunisia - Paper Passport
• Turkey - Paper Passport
• Zimbabwe - Paper Passport

Latin America and the Caribbean

• Argentina - Paper Passport
• Brazil - Paper Passport (beta)
• Guatemala - Paper Passport
• Haiti - Paper Passport
• Honduras - Paper Passport (beta)
• Mexico - Paper Passport (beta)
• Mexico - Nayarit - Driving Licence (beta)

Asia

• Bangladesh - Paper Passport
• China - Paper Passport (beta)
• India - Paper Passport
• Indonesia - Paper Passport
• Japan - Paper Passport
• Nepal - Paper Passport
• Pakistan - Paper Passport
• Philippines - Paper Passport
• South Korea - Paper Passport (beta)
• Sri Lanka - Paper Passport
• Uzbekistan - Paper Passport

Oceania

• Australia - Paper Passport

Northern America

• Canada - Paper Passport
• Canada - Weapon Permit (front only, beta)
• USA - Paper Passport (beta)

Back side support added:

• Greece - ID Card
• Burkina Faso - ID Card
• Democratic Republic of the Congo - Driving Licence
• Mexico - Veracruz - Driving Licence
• Canada - Citizenship Certificate

No longer BETA:

• Belarus - Driving Licence
• UK - Polycarbonate Passport
• Argentina - Alien ID
• Bahamas - Driving Licence
• Mexico - Durango - Driving Licence
• Venezuela - ID Card
• USA - Kansas - ID Card

Changes to BlinkID(Combined) Recognizer

• We’ve renamed the Swaziland country to Eswatini in results and ClassInfo structure
• Improved result validation
  • FieldIdentificationFailed processing status is used to indicate if unexpected fields are present on the document. Those fields are then deleted from the result
• We are filling out COUNTRY and REGION fields in ClassInfo, without the field TYPE of document, when using BarcodeID mode for scanning documents where the Front side is not supported, and back side results are extracted from AAMVA compliant barcodes
  • This applies only if ClassInfo isn’t already prepopulated in some other way and when you’re not in FullRecognition mode

Improvements

• We can now extract the date of birth from the document number on the South Korean identity card and from the personal identification number on the driving licence

Anonymization

• We’ve added anonymization support for new documents:
  • Document number on Germany paper bio-data page Passport
  • Document number on South Korea Identity Card
  • Personal identification number on South Korea driving licence
  • Personal identification number on South Korea paper bio-data page Passport

Platform-related SDK changes

• We've improved the performance of the SDK by adding support for WebAssembly SIMD.
  • This increases the scanning performance on compatible browsers up to 77% and up to 94% in cases when WebAssembly threads are also supported.
  • Keep in mind that this feature requires a compatible browser (Chrome 91 and Firefox 90 or newer versions). Only advanced and advanced-threads binaries are using SIMD. In case that the browser doesn't support this feature, basic binary will be used.
• We've reduced the memory fragmentation during video processing, resulting in a smaller memory footprint.

5.12.0

New additions to our supported documents list

We've added 15 new documents:

Europe

• North Macedonia - Polycarbonate Passport

Middle East and Africa

• Botswana - ID Card
• Sudan - Polycarbonate Passport

Latin America & the Caribbean

• Mexico - Baja California Sur - Driving Licence (beta)
• Mexico - Campeche - Driving Licence (beta)
• Mexico - Colima - Driving Licence (beta)

Oceania

• Australia - Health Insurance Card (front only, beta)

Asia

• Azerbaijan - Polycarbonate Passport (beta)
• Tajikistan - Polycarbonate Passport (beta)

Northern America

• Canada - Citizenship Certificate (front only, beta)
• Canada - Ontario - Health Insurance Card (front only)
• Canada - Quebec - Health Insurance Card (front only, beta)
• USA - Military ID Card
• USA - Rhode Island - ID Card
• USA - South Carolina - ID Card

Back side support added:

• Ireland - Passport Card
• Mexico - Puebla - Driving Licence
• Singapore - S PASS

No longer BETA:

• Finland - Polycarbonate Passport
• Ireland - Passport Card
• Ireland - Polycarbonate Passport
• Kosovo - Driving Licence
• Latvia - Polycarbonate Alien Passport
• Latvia - Polycarbonate Passport
• Poland - Polycarbonate Passport
• Cameroon - ID Card
• Ghana - ID Card
• Iraq - ID Card
• Tanzania - Driving Licence
• Turkey - Polycarbonate Passport
• Uganda - Driving Licence
• Bolivia - Minors ID
• Chile - Driving Licence
• Ecuador - Driving Licence
• Haiti - Driving Licence
• India - Karnataka - Driving Licence
• India - Maharashtra - Driving Licence
• Pakistan - Punjab - Driving Licence
• USA - Global Entry Card
• USA - New Mexico - ID Card
• USA - Wisconsin - ID Card

Changes to BlinkID(Combined) Recognizer

• We've added the parameter maxAllowedMismatchesPerField to settings. When this is set to a non-zero value, DataMatch will pass as long as the number of mismatched characters doesn't exceed the specified value.
• We've enabled the return of image and back-side data results, even when the State is Uncertain. Keep in mind that returned images, in this case, might be blurry or low quality.
  • This applies to all images: face image, full document image, and signature image.

Improvements

• We can now extract information from NRIC numbers on Malaysian documents that have the asterisk (*) character in it.
• While using FullRecognitionMode for scanning unsupported Passports, we are now taking ClassInfo from MRZ
• We are now correctly handling fully cropped vertical images
• Fix for correct parsing of Bermuda Driving Licence AAMVA-compliant barcode dates
• Fix for correct calculation of check digit for Saudi Arabia ID Card MRZ

Postprocess improvement

• We are splitting names and descriptors into two different results (e.g., Nom d’ usage, Epouse, Geb. etc.), where descriptors are in their separate field name_additional_info, for these documents:
  • France
    • ID Card
    • Residence Permit
  • Germany
    • ID Card
  • Luxembourg
    • ID Card
  • Netherlands
    • Driving Licence
    • Polycarbonate Passport

Sanitization of names

• We are removing title prefixes (e.g., Mrs., Mr., Ing., etc.) from full_name, first_name and last_name for these documents:
  • Austria
    • Driving Licence
    • ID Card
  • Czechia
    • Driving Licence
  • Germany
    • ID Card
  • Thailand
    • ID Card
  • UK
    • Driving Licence

Anonymization

• We've added anonymization support for new documents:
  • Document number on Germany Polycarbonate Passport
  • Document number on Hong Kong Polycarbonate Passport
  • Document number, personal ID number on Singapore Polycarbonate Passport

SDK changes

• We've added a mechanism to automatically delete an instance of worker script in case of unsuccessful SDK initialization.
  • New method WasmSDK.delete() was added for this purpose and is available on every instance of the SDK.
• We've changed improper error handling in the VideoRecognizer class.
  • From now on, it's possible to catch all errors that happen during the video recognition.

5.11.4

• Generated missing assets when UI component is used as NPM package

5.11.3

• We’ve fixed a bug that would cause recognizerOptions to work incorrectly on still images

5.11.2

SDK changes

• We've exposed a couple of functions that are used by the SDK to determine which WebAssembly bundle to load and from which location
  • Function detectWasmType() returns the best possible WebAssembly bundle based on the features a browser supports.
  • Function wasmFolder( WasmType ) returns the name of the resources subfolder of the provided WebAssembly bundle type.
  • For more information on how to implement these functions, see WasmLoadUtils.ts file.

UI Improvements

• You can now set a camera feedback message to the user when BlinkID IDBarcode recognizer is used
  • Set showCameraFeedbackBarcodeMessage property to display a custom message.
  • Use translations property to translate a custom message.
• Camera rectangle cursor is more responsive now when BlinkID IDBarcode recognizer is used.

Bugfixes

• Container width size on UI component for action label (Scan or choose from gallery) and action buttons (Device camera and From gallery) are now responsive on Safari.

5.11.1

• We've fixed a broken rollup.config.js which resulted in unusable UMD development bundle

5.11.0

Breaking changes

• We've changed the way how recognizer options are set up when using the UI component
  • You can now specify how a recognizer should behave by using the new recognizerOptions property.
  • To see the full list of available recognizer options, as well as examples on how to use them, check out the relevant source code.
• We've removed property and attribute anonymization from the UI component since it can now be defined with the new recognizerOptions property

Newly supported identity documents:

We’ve added 98 new documents:

Europe

• Albania - Driver Card (front only)
• Albania - Professional Driver License (front only)
• Belarus - Driver License (front only, beta)
• Belgium - Minors ID (beta)
• Czechia - Residence Permit
• Finland - Alien ID
• Finland - Residence Permit (beta)
• Georgia - Driver License (front only)
• Greece - Residence Permit
• Ireland - Passport Card (beta)
• Ireland - Public Services Card (beta)
• Kosovo - Driver License (front only, beta)
• Latvia - Alien ID
• Luxembourg - ID Card
• Moldova - ID Card (beta)
• North Macedonia - Driver License (front only)
• North Macedonia - ID Card
• Poland - Passport (beta)
• Slovenia - Residence Permit (beta)
• Spain - Alien ID
• UK - Passport (beta)

Middle East and Africa

• Algeria - Driver License
• Burkina Faso - ID Card (front only)
• Cameroon - ID Card (beta)
• Democratic Republic Of The Congo - Driver License (front only, beta)
• Egypt - Driver License (beta)
• Ghana - ID Card (beta)
• Iraq - ID Card (beta)
• Ivory Coast - Driver License (front only, beta)
• Ivory Coast - ID Card
• Lebanon - ID Card (beta)
• Morocco - Driver License
• Mozambique - Driver License (front only, beta)
• Oman - Driver License (beta)
• Rwanda - ID Card (front only)
• Senegal - ID Card
• Tanzania - Driver License (front only, beta)
• Tunisia - Driver License (front only)
• Uganda - Driver License (front only, beta)

Latin America & the Caribbean

• Argentina - Alien ID (beta)
• Bahamas - ID Card (front only, beta)
• Bolivia - Minors ID (beta)
• Jamaica - Driver License
• Mexico - Residence Permit (beta)
• Mexico - Chiapas - Driver License (front only)
• Mexico - Coahuila - Driver License (beta)
• Mexico - Durango - Driver License(front only, beta)
• Mexico - Guerrero-cocula - Driver License (beta)
• Mexico - Guerrero-juchitan - Driver License (beta)
• Mexico - Guerrero-tepecoacuilco - Driver License (front only, beta)
• Mexico - Guerrero-tlacoapa - Driver License (front only, beta)
• Mexico - Hidalgo - Driver License
• Mexico - Mexico - Driver License (beta)
• Mexico - Morelos - Driver License (front only)
• Mexico - Oaxaca - Driver License
• Mexico - Puebla - Driver License (front only, beta)
• Mexico - San Luis Potosi - Driver License (front only)
• Mexico - Sinaloa - Driver License (front only, beta)
• Mexico - Sonora - Driver License (beta)
• Mexico - Tabasco - Driver License (beta)
• Mexico - Yucatan - Driver License (beta)
• Mexico - Zacatecas - Driver License (beta)
• Panama - Temporary Residence Permit (beta)
• Peru - Minors ID (beta)
• Trinidad And Tobago - Driver License (front only, beta)
• Trinidad And Tobago - ID Card

Oceania

• Australia - South Australia - Proof Of Age Card (front only, beta)

Asia

• Armenia - ID Card
• Bangladesh - Driver License (beta)
• Cambodia - Driver License (front only, beta)
• India - Gujarat - Driving Licence (front only, beta)
• India - Karnataka - Driving Licence (front only, beta)
• India - Kerala - Driving Licence (beta)
• India - Madhya Pradesh - Driving Licence (front only, beta)
• India - Maharashtra - Driving Licence (front only, beta)
• India - Punjab - Driving Licence (front only, beta)
• India - Tamil Nadu - Driving Licence (beta)
• Kyrgyzstan - ID Card
• Malaysia - Mypolis (beta)
• Malaysia - Refugee ID (front only)
• Myanmar - Driver License (beta)
• Pakistan - Punjab - Driving Licence (front only, beta)
• Sri Lanka - Driving Licence (front only)
• Thailand - Alien ID (front only)
• Thailand - Driver License (beta)
• Uzbekistan - Driver License (front only, beta)

Northern America

• Canada - Tribal ID (beta)
• Canada - Nova Scotia - ID Card (beta)
• Canada - Saskatchewan - ID Card (beta)
• USA - Border Crossing Card (front only)
• USA - Global Entry Card (beta)
• USA - Nexus Card (beta)
• USA - Veteran ID (front only)
• USA - Work Permit
• USA - Mississippi - ID Card (beta)
• USA - Montana - ID Card
• USA - New Mexico - ID Card (beta)
• USA - Wisconsin - ID Card (beta)

Back side support added:

• Hungary - Residence Permit
• Luxembourg - Residence Permit (no longer beta)
• Mauritius - ID Card
• Colombia - Alien ID (no longer beta)
• Mexico - Baja California - Driver License
• Mexico - Chihuahua - Driver License
• Mexico - Guanajuato - Driver License
• Mexico - Michoacan - Driver License
• Malaysia - MyKid
• Malaysia - MyPR

No longer beta:

• Albania - Passport
• Malta - Residence Permit
• Switzerland - Residence Permit
• Bolivia - Driver License
• Chile - Passport
• El Salvador - ID Card
• Peru - ID Card
• Singapore - S Pass (front only)

Changes to the BlinkId(Combined)Recognizer

• You can now retrieve an image of the document owner along with cropped images of the document itself whenever you’re scanning an AAMVA-compliant ID:
  • Using BarcodeId as a RecognitionMode lets you scan US driver licenses and IDs that BlinkID can’t read from the Visual Inspection Zone (VIZ) alone. Use it to extract:
    • A face image from the front side
    • Barcode data from the back side
    • Cropped document images of both sides
  • You can disable this RecognitionMode by setting enableBarcodeId to false in the RecognitionModeFilter.
• We've improved data extraction through the MRZ:
  • We now allow standard M/F values for gender on Mexican documents (along with localized H/M values)
• We're now converting dates to the Gregorian calendar for:
  • Taiwan documents with Republic of China (ROC) calendar dates
  • Saudi documents with Islamic calendar dates
• We're now auto-filling all ‘partial’ dates found on identity documents (showing year or month-year only):
  • Date of issue will be converted to the first day of the (first) month
    • E.g. '1999' will be converted to '01.01.1999.'
    • E.g. '03.1999.' will be converted to '01.03.1999.'
  • Date of expiry will be converted to the last day of the (last) month
    • E.g. '1999' will be converted to '31.12.1999.'
    • E.g. '03.1999.' will be converted to '31.03.1999.'

Changes to the UI component

• You can now scan identity documents with barcodes, for example US driver’s licenses, with BlinkId(Combined)Recognizer
  • A user will now receive a feedback message whenever barcode scanning is taking place, with instructions to point the camera closer to the barcode, if needs be.
  • This change should result in better results when scanning the aforementioned documents.

Performance improvements

• We've added three different flavors of WebAssembly builds to the SDK, to provide better performance across all browsers
  • Unless defined otherwise, the SDK will load the best possible bundle during initialization:
    • Basic Same as the existing WebAssembly build, most compatible, but least performant.
    • Advanced WebAssembly build that provides better performance but requires a browser with advanced features.
    • AdvancedWithThreads Most performant WebAssembly build which requires a proper setup of COOP and COEP headers on the server-side.
  • For more information about different WebAssembly builds and how to use them properly, check out the relevant section in our official documentation

Bugfixes

• We fixed the initialization problem that prevented the SDK from loading on iOS 13 and older versions