2.2.0

Release Notes

Have a feature request? Contact us

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