3.3.0

Release Notes

Have a feature request? Contact us

3.3.0 - 2023/11/16

Breaking Changes

  • Changed how mobile capture initialization works. On both the Prepare component and the Wizard component, the function has been renamed from initializeMobileCaptureWithId to initializeMobileCaptureWithUrl and now only requires one parameter (url) instead of three (previously these were mobileId, baseUrl, fullUrl).

Changes & additions

  • Added metadata configuration to allow for additional values to be returned and emitted through the SDK.

3.2.3 - 2023/10/04

Changes & additions

  • Improvements to the behavior of the SDK's Device Select component when handling permission requests. These enhancements ensure a smoother and more intuitive experience when allowing or denying permissions in various scenarios.

  • Added sy-i-translation-336 translation for when camera permission has been denied.

Bug fixes

  • Fixed invalid translation for Send SMS button on Prepare component.

3.2.2 - 2023/09/28

Breaking Changes

  • Visual overhaul.

    • All components have been visually updated to have a sleeker style.

    • New font is being used - Roboto.

    • Icons have been reworked.

  • Discontinued support for the PNG (Portable Network Graphics) format. Consequently, the option to capture images in PNG format will be removed from the available capture options.

  • Removed the sybrin.identity.all.js script in favor of the more optimal implementation of using sybrin.identity.js in conjunction with sybrin.common.js.

Changes & additions

  • Added capability to configure default field edit behavior if not provided from the backend result.

    • Added fieldEditDefault to configuration options.

    • Added fieldListDefault to configuration options.

  • Changed country component to more clearly indicate when search returns no items.

  • Added translation keys for search features:

    • sy-i-translation-330

    • sy-i-translation-331

  • Added a new configurable button to allow triggering a "Send SMS" event from the Prepare component when starting a mobile capture session.

    • Prepare component: Added enableSendSms constructor parameter.

    • Prepare component: Added onSendSms event.

  • Added light threshold functionality that allows for dynamic adjustment of overexposure and underexposure thresholds to prevent the user from getting completely stuck due to poor lighting conditions.

  • Added more details about the device used for capture to the emitted result object for document extraction.

  • Added more details about the device used for capture to the snapshot data object for the header and body callback functions executed during document extraction.

  • Added the following document types:

    • Tanzania Passport

    • Tanzania ID Card

    • Tanzania Driver's License

    • Tanzania Birth Certificate

    • Tanzania Voter Card

    • Ghana ID Card

    • Kenya Foreign Certificate

    • Kenya Birth Certificate

    • Philippines QC Identification Card

    • Generic Birth Certificate

    • Generic Voter Card

  • Added the following translations for new document types:

    • sy-i-translation-332: Birth Certificate

    • sy-i-translation-333: Voter Card

  • Added the ability to filter out specific result fields, so they don't display on the Result component.

  • Added the ability to disable camera capture option on the Prepare and Wizard components.

  • Added the ability to set country priorities on the Country Select and Wizard components.

Bug fixes

  • Fixed document type selection breaking when selecting a generic document scan country and overrides have been provided.

  • Added missing StepType export.

  • When the user clicks "Cancel" during image processing, the SDK now immediately triggers the navigation back to the previous screen. This behavior is consistent regardless of whether the network request is still ongoing.

  • The request for camera permission removed when in read-only mode.

2.7.0 - 2023/06/19

Breaking changes

  • Removed the "Any other country" option from the country select component.

    • Removed corresponding translation (sy-i-translation-27)

Changes & additions

  • Added all countries to country select component.

  • Added a search bar to the country select component.

  • Added corresponding translations for all countries.

  • Improved error feedback for cases where camera permission has been blocked.

Bug fixes

  • Fixed green image snapshots on older devices.

  • Fixed emulation error appearing on older devices.

  • Resolved language change bug to preserve component integrity. Now, when users switch languages, the component remains intact, providing a seamless experience without unnecessary disruptions.

2.6.0 - 2023/05/02

Breaking changes

  • Changed the onContinue event of the Result and Wizard components to emit the DocumentScanResult instance with modifications applied if applicable.

Changes & additions

  • Added USA California Driver's License document type.

  • Added word confidence rating functionality and changed the Result component to handle it accordingly.

  • Added the following initialization properties to the Result and Wizard components to handle word confidence ratings:

    • wordConfidenceThreshold

    • isLowConfidenceEditable

    • isLowConfidenceConfirmable

    • isLowConfidenceBlocking

  • Added the following properties to DocumentScanResult:

    • wordConfidenceResults

    • originalValues

  • Added the following translation keys:

    • sy-i-translation-86: United States of America

    • sy-i-translation-87: California Driver's License

    • sy-i-translation-88: Some fields were captured with a low confidence rating.

    • sy-i-translation-89: Some fields were captured with a low confidence rating. Please review the highlighted values.

Bug fixes

  • Fixed the result component incorrectly displaying the internally used "BackParsedSuccessfully" property.

2.5.1 - 2023/04/14

Changes & additions

  • Changed all sample document images to JPEG format.

Bug fixes

  • Fixed SDK requesting an invalid sample document image when scanning Kenya military ID card.

2.5.0 - 2023/04/12

Breaking changes

  • Changed the way that capture modes are handled. Default behavior is preserved, so applications that do not make use of alternative capture modes will be unaffected by this change.

    • Added more capture modes to allow for more granular control over behavior and button positioning. See JavaScript API functionality section or relevant component sections for more information on the extra modes.

    • Removed the captureMode JavaScript API configuration option. This is now handled on function invocation and component levels instead. The cameraButtonDisplayIcon and cameraButtonDisplayText configuration options are still in use, but they may be moved in a future update.

    • Added a captureMode parameter to the openScanDocument JavaScript API function.

    • Added a captureMode constructor parameter to the Document Scan and Wizard components.

  • In the JavaScript API uploadDocument function, refactored the file and base64 parameters to frontFile and frontBase64.

Changes & additions

  • Added control over image capture formats (currently supports JPEG and PNG, and defaults to JPEG. Previously images were only captured in PNG format).

  • For multi-sided document file uploads, changed the upload screen to more clearly indicate when a file has already been selected by showing more distinct icons and accentuating the action instead of the side on buttons.

  • Added a configuration option to disable file upload functionality.

  • The following translations were modified:

    • sy-i-translation-77 (Prepare component)

    • sy-i-translation-78 (Prepare component)

    • sy-i-translation-79 (Prepare component)

    • sy-i-translation-80 (Prepare component)

  • The following translations were added:

    • sy-i-translation-85 (Document Scan component)

Bug fixes

  • Fixed filter case sensitivity issue on country select component.

  • Fixed mobile capture URLs to generate with a trailing slash.

  • Fixed a bug where the JavaScript API uploadDocument function did not include the option to provide an external back file or base 64 string.

  • Removed unused captureMode configuration option. This is provided to components or capture function calls.

2.4.2 - 2022/12/15

Changes & additions

  • Added Kenya military ID card support.

  • Added manual capture capabilities.

Bug fixes

  • Fixed spinners on iOS.

2.4.0 - 2022/10/26

Breaking changes

  • Changed the authorizationEndpoint configuration option to authEndpoint.

  • Changed guidelines on the Prepare component to show on the initial screen instead of requiring a button press to view in a new window.

  • Removed the setFlowDirection function and the flowDirection initialization property from the Prepare component as it is no longer used since changing the way that guidelines are presented.

  • Removed the setFlowDirection function and the flowDirection initialization property from the Wizard component as it is no longer used since changing the way that guidelines are presented.

  • Removed the exported FlowDirection enum.

  • Removed the onViewGuidelines event from the Prepare component as there is no longer a button to view guidelines.

  • Removed the onViewGuidelines event from the Wizard component as there is no longer a button to view guidelines.

  • Changed prompt behavior and translations to more clearly indicate an instruction prompt along with which side is being captured.

Changes & additions

  • Changed the UI presented during multi-sided document uploads to allow for easier file selection.

  • Added croppedFrontImage and croppedBackImage to DocumentScanResult.

  • Changed the Result component to first check for newly added cropped images, and only show the original images if no cropped images are present.

  • Added a configurable read-only mode to the Prepare component.

  • Changed the Device Select component to display differing device icons based on detected type. It can now display mobile, tablet, webcam and a generic camera for other types.

  • Updated Kenya ID card samples to more suitable images.

  • Added functionality to visually pre-select a default country on the Country Select component based on a provided parameter.

  • Added functionality to visually pre-select a default document type on the Document Select component based on a provided parameter.

  • Instead of always throwing an exception when no video input devices have been detected, the SDK now only throws an exception if no other capture method is available either.

  • Added parameter on Wizard to set camera direction priority.

  • Added parameter on Wizard to set default country.

  • Added parameter on Wizard to set default document type.

  • Added parameter to the uploadDocument function of the JavaScript API to be able to provide an upload modal container.

  • Changed Device Select component listing to attempt using more user-friendly labels on mobile devices that provide bad naming conventions for their cameras.

  • Changed the default translation text for sy-i-translation-27 from "Other" to "Any other country".

  • Changed the default translation text for sy-i-translation-42 from "Please hold the document up to the camera" to "Capturing FRONT".

  • Changed the default translation text for sy-i-translation-43 from "Please flip the document over for rear photo" to "Capturing BACK".

  • Changed the default translation text for sy-i-translation-44 from "Lighting conditions too dark" to "Lighting too dark".

  • Changed the default translation text for sy-i-translation-45 from "Lighting conditions too bright" to "Lighting too bright".

  • Added translation sy-i-translation-71 to use as new capture prompt.

  • Added translation sy-i-translation-72 to use as prompt to indicate that the user must flip the document over.

  • Added translations sy-i-translation-73 to sy-i-translation-80 for use on new multi-sided document prompt.

  • The SDK will now retry accessing the camera for a configurable number of times if it fails to gain access initially.

  • Added mediaStreamRetryCount configuration option.

  • Added mediaStreamRetryDelay configuration option.

  • Added thresholdAdjustAmount configuration option.

  • Added thresholdAdjustMaximum configuration option.

  • Changed blurThreshold default value from 6.5 to 6.7.

  • Added blurThresholdMobileModifier configuration option.

  • Added maxUploadFileSize configuration option.

  • Added showDebugOverlay configuration option.

  • Changed SDK to wait for 3 seconds while running the flip animation before running image analysis again and trying to take the rear photo.

  • Added UseV2 (value is "true") to default headers.

  • Added UseSegmentationBeforeOCR (value is "true") to default headers.

  • Added ValidateBackFront (value is "true") to default headers.

  • Removed the need for the audio permission.

  • Changed the UI loader/spinner.

  • General styling fixes.

Bug fixes

  • Fixed country code filters not working on the Document Select component.

  • Fixed a timing issue that could sometimes cause buttons on the prepare component to be created in an unintended order.

  • Added "WordConfidenceResults" and "IsBackFrontValid" to list of fields to filter out if present on the result.

  • Fixed a bug where the mobile prompt appeared on file upload failure.

  • Fixed the onBeforeUpload event not firing on the Wizard component.

  • Fixed the onScanError event not firing on the Wizard component.

  • Fixed certain permission issues causing the SDK to fail to retrieve or initialize video input devices on Safari and Firefox.

2.3.0 - 2022/07/27

Breaking changes

  • Removed the useIntegrationApi configuration option and replaced it with the integrationMode configuration option.

  • Renamed the authorizationEndpoint property to authEndpoint.

  • Removed the integrationApiBaseUrl configuration option. The authEndpoint and dataExtractionEndpoint properties must now be used.

  • Removed the extractionFrontParamName configuration option. This value can now be modified using the body callback function (dataExtractionBodyCallback).

  • Removed the extractionBackParamName configuration option. This value can now be modified using the body callback function (dataExtractionBodyCallback).

  • Removed the assetHeaders configuration option. Asset headers can now be modified using the asset headers callback function (assetHeadersCallback).

  • Removed the authHeaders configuration option. Authorization headers can now be modified using the authentication headers callback function (authHeadersCallback).

  • Removed the dataExtractionHeaders configuration option. Data extraction headers can now be modified using the data extraction headers callback function (dataExtractionHeadersCallback).

  • Removed the dataExtractionBodyValues configuration option. Data extraction body can now be modified using the data extraction body callback function (dataExtractionBodyCallback).

Changes & additions

  • Added optional middleware service that may be used to obfuscate the identity API key, along with corresponding configuration properties. Please see the middleware service documentation for details on how to implement and use it. Additionally, the SDK can now be configured to integrate with custom services. Relevant configuration properties are:

    • integrationMode

    • authHttpMethod

    • authHeadersCallback

    • authBodyCallback

    • dataExtractionHttpMethod

    • dataExtractionHeadersCallback

    • dataExtractionBodyCallback

    • encryptionKey

  • Added parameters to the Prepare component's mobile capture initialization function to allow more control over the generated URL.

  • Added encryption features.

Bug fixes

  • Fixed an issue with the SDK sometimes defaulting to emulated cameras when present.

  • Fixed issue where the card elements within components were sometimes not sized correctly.

  • Fixed issue where text sometimes was not center aligned where it needed to be.

  • Fixed a bug where the device select component would always appear when set as the first step (regardless of whether or not only a singular viable video input device is present).

2.2.0 - 2022/06/21

Changes & additions

  • Added generic SDK classes to HTML elements to simplify styling over multiple SDKs.

  • Added functionality to be able to edit extracted document data to Result component.

2.1.1 - 2022/06/08

Bug fixes

  • Fixed information blocks on the Prepare component having inconsistent sizes with smaller screens.

  • Fixed an issue with button overflow on the Prepare component when used with smaller screens.

  • Fixed an issue with guidelines not being viewable in Safari on mobile devices.

  • Fixed an issue with using an incorrect camera when pressing Retake on certain devices.

  • Fixed an issue with the video feed being incorrectly mirrored on certain devices.

Changes & additions

  • Added a flip animation to the capture step if a rear photo is required.

2.1.0 - 2022/06/03

Breaking Changes

  • Removed all localization properties available as JavaScript API configuration options. These values can now be modified by making use of the new localization framework. Removed properties are:

    • messagePreparing

    • messagePrepareFront

    • messagePrepareBack

    • messageLightingDark

    • messageLightingBright

    • messageBlurry

    • messageIncompatible

    • messageIncompatibleSafari

  • Name overrides have been removed from country configuration in favor of new localization functionality.

  • Title and subtitle overrides have been removed from document type configuration in favor of new localization functionality.

Changes & additions

  • Comprehensive localization rework (See localization section for details)

    • All components now accept a translations parameter

    • All templates updated to have translatable elements marked with the class sy-i-translation-# (where # is its unique number)

Bug fixes

  • Fixed a bug where an extra blue border displayed on the Document Scan component while capture was in progress.

  • Fixed an issue with poor framerates on certain higher quality webcams.

2.0.0 - 2022/05/17

Breaking Changes

  • Extensive UI overhaul of all components and functionality.

  • Country Select Component:

    • Removed all localization options for a future localization overhaul.

    • Visual UI overhaul.

  • Document Select Component:

    • Removed all localization options for a future localization overhaul.

    • Visual UI overhaul.

  • Document Scan Component:

    • Removed all localization options for a future localization overhaul.

    • Visual UI overhaul.

    • Removed useModal parameter from document scan component (As part of the UI overhaul, there is no longer a modal option).

  • Result Component:

    • Removed all localization options for a future localization overhaul.

    • Visual UI overhaul.

    • Added isSingleStep configuration parameter to toggle "Next" button text to "Complete Step" when needed,

    • Added promptMobileOnRetry configuration parameter to enable prompting for mobile usage when the user clicks "Retry".

  • Wizard Component

    • Removed all localization options for a future localization overhaul.

    • Visual UI overhaul.

    • Added events to bubble up from the newly added prepare component

      • onViewPrivacyPolicy

      • onViewGuidelines

      • onMobileCaptureStart

      • onMobileCaptureCancel

    • Added initialization configuration parameters

      • enableMobileCapture

      • isSingleStep

      • forceMobileCapture

Changes & additions

  • Added prepare component.

  • Added device select component.

  • Added "Other" option to country list. This option supports generic data extraction of passports.

  • Added better alphabetic sorting to selection components.

  • JavaScript API configuration options:

    • Adjusted thresholdAdjustInterval property default value from 10000 to 4000 in order to account for new dimensions.

  • Added optional parameters to the getVideoInputDevices function on the API to specify whether or not the UI should be blocked while loading input devices, along with the capability to specify an element to block.

1.5.1 - 2022/02/24

Changes & additions

  • Added emulation checks.

  • Added a property on data extraction results to indicate which camera was used.

Bug fixes

  • Fixed a bug where certain error responses were handled like a success.

  • Fixed the case of the seaman's book document type's title. (Was previously Seaman's book and is now Seaman's Book)

1.5.0 - 2022/01/13

Changes & additions

  • The SDK is now provides two different options for referencing the main library:

    • A singular file that contains all functionality (sybrin.identity.all.js). This matches implementations from previous versions.

    • A split approach where Identity specific functionality is provided in one file (sybrin.identity.js) and common functionality shared by other Sybrin web SDKs is provided in another (sybrin.common.js). This approach is new and is intended to reduce the overall page size in solutions that make use of multiple Sybrin web SDKs by including common functionality only once.

1.4.0 - 2021/12/02

Changes & additions

  • Added device selection functionality.

1.3.3 - 2021/11/25

Changes & additions

  • Added numeric country code to country selection output. The onCountrySelected events of the country component and the wizard component have been changed to pass down the Alpha-3 country code, the Alpha-2 country code and the numeric country code as parameters in that order.

Bug fixes

  • Fixed wizard component onCountrySelected event only passing the Alpha-3 country code.

1.3.2 - 2021/11/19

Changes & additions

  • Changed the Document Scan Component's internal error handling to always trigger the onScanResult event, even after an onScanError event occurred. While not a breaking change, this could have an external effect on flows where the web SDK has been implemented, specifically where the Document Scan Component's onScanResult and onScanError events are used to manage flow steps.

  • Added configuration to integrate with the companion Sybrin Onboarding API as a middleware proxy when bundled with the web SDK. These configuration options include useIntegrationApi, integrationApiBaseUrl and authToken

  • Added a dataExtractionBodyValues configuration option to pass down additional form body values during the data extraction API call, similar to the dataExtractionHeaders configuration option.

1.3.1 - 2021/11/08

Changes & additions

  • Changed the country select component's onCountrySelected event to additionally pass the Alpha-2 standard country code as a second parameter.

  • Added functionality to retrieve a list of supported country codes in both Alpha-3 and Alpha-2 standards. These are getCountryAlpha3Codes and getCountryAlpha2Codes.

  • Added a useCutout configuration option with a default value of true to toggle whether or not the document cutout should be shown over the video feed.

Bug fixes

  • Fixed some internal memory cleanup errors.

1.3.0 - 2021/10/21

Breaking changes

  • Renamed the documentDetectionInterval configuration option to videoInterval.

  • Removed the messageCapturingFront and messageCapturingBack configuration options as they are no longer used.

Changes & additions

  • Added compatibility check features, along with messageIncompatible and messageIncompatibleSafari configuration options.

  • Added a tokenTimeout configuration option that determines how long a token is valid and will be reused for before a new authentication call is made.

  • Increased the takePictureDelay configuration option default value from 2000 to 5000.

  • Changed the messagePrepareBack configuration option default value from "Please flip the document over" to "Please flip the document over for rear photo"

1.2.3 - 2021/10/14

Changes & additions

  • Slightly decreased the default front capturing threshold for Philippines drivers licenses.

  • Added debug functionality features, along with recordDebugInfo and debugInfoEndpoint configuration options.

Bug fixes

  • Fixed a bug where the modal didn't take up the whole screen when the component was hosted in certain containers.

  • Fixed a bug where components didn't share the same API instance when the wizard was initialized without passing one down.

1.2.2 - 2021/09/28

Changes & additions

  • Added an instructionTextPosition API configuration option that allows configuration of where the instruction text is located while the video feed is being processed. The options are "top", "bottom", or "topandbottom".

  • Added a strongly typed ClientInfo class that is now returned by the getClientInfo call.

  • Added more detailed information to be returned from getClientInfo.

  • Added custom header configuration for authentication (authHeaders) and data extraction (dataExtractionHeaders) API calls that can be set using the API configuration options.

  • Changed the default blur text to "Image too blurry" (see messageBlurry under the API configuration options).

Bug fixes

  • Fixed a memory leak that occurred while the video feed was being processed.

  • Fixed a bug where resizing while the video feed is already open would not properly adjust processing areas.

  • Fixed a bug on iPad where the video feed was blank.

  • Fixed a bug on iPad where the video cutout would sometimes not re-render correctly on resize or orientation change.

  • Fixed some exceptions not being handled properly.

  • Fixed styling being applied to some elements too strictly (would have needed to use !important to style said elements before).

1.2.1 - 2021/09/14

Bug fixes

  • Fixed Correlation ID not being passed down correctly

1.2.0 - 2021/09/10

Breaking changes

  • Changed all onBeforeWebcam events to onBeforeScan.

Changes & additions

  • Inverted the video feed when a frontal camera is being used in order to improve the alignment process.

  • Added typings for Typescript. These can be found under the src folder.

  • The library no longer requires sybrin.identity.css to be included and referenced separately for default component styling to take effect. You may still apply overrides using your own stylesheet by referencing a custom .css file after the library.

  • Added a read-only mode to the wizard component which disables all events.

  • Added an option to set request headers for asset retrieval requests.

  • Added a flattenAssets option which results in the library looking for samples in a flat structure instead of nested within folders for each country. To use this, asset file names must manually be moved one level up and prefixed with the country code and a dash. For instance: gha/passport.png changes to gha-passport.png.

Bug fixes

  • Fixed a bug where the wizard fired the onBeforeStepChanged and onAfterStepChanged events on initialization.

  • Fixed a bug where an error occurred if the SDK was included multiple times.

  • Fixed issue where DocumentScanResult was not being exported from the library.

1.1.0 - 2021/08/19

Changes & additions

  • Added blur detection as well as a configuration option to set the blur threshold.

  • Added lighting detection as well as configuration options to set values and thresholds to use when checking for image overexposure or underexposure.

  • Added version info retrieval functionality.

  • Added client info retrieval functionality.

  • Added instructions page to the document scan component in order to pre-emptively give the user some guidelines on how to ensure a viable document image.

  • Added localization options to document scan component initialization for changing guideline instruction texts.

  • Added useModal configuration option to the document scan component which enables launching the video feed in a modal.

  • Updated wizard component with matching properties for instruction localization and modal usage to pass down to the document scan component upon initialization.

  • Updated the demo application to make use of the newly added client info retrieval functionality and initialize the wizard component to use the newly added modal functionality only when the client environment is not mobile.

Bug fixes

  • Fixed issue with video stream remaining open when using the wizard's back button after the feed had started.

  • Ensured that the video stream always closes when the document scan component is destroyed.

Last updated