> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/sdks/sdk-web/changelogs/sdk-web-wc.md).

# @facephi/sdk-web-wc

Historial de versiones y cambios de la librería \`@facephi/sdk-web-wc\`.

## @facephi/sdk-web-wc

## 3.40.1

Release: 05-10-2026

### Patch Changes

* Fixed the SelphID widget emitting a false license error (SDK\_111) when `disabled` is set on the SDK provider.
* Updated the Selphi and SelphID widget versions.

## 3.40.0

Release: 18-09-2026

### Minor Changes

* Updated selphi widget version

## 3.39.3

Release: 17-09-2026

### Patch Changes

* Fixed the SDK not stopping with an expired-URL error when the process URL was no longer valid.

  Fixed a misleading internal tracking error being reported instead of the real cause when the SDK stopped.

  Fixed the SDK staying on the loading animation after an expired URL stopped the process.
* Fixed recoverable capture errors ending IDV flows before the user could retry.

  Fixed the retry-limit screen being replaced by a generic error once the widget closed itself.

  Fixed a failed capture attempt reporting an error verdict on a step the user could still complete.
* Fixed the close button of the terms and conditions link modal being out of reach on mobile.

## 3.39.2

Release: 16-09-2026

### Patch Changes

* Fixed PDF links opening blank on mobile browsers and WebViews when the terms and conditions modal is enabled.

  Added pinch to zoom, zoom controls and selectable text to the documents opened in the terms and conditions modal.

  Marked the required consents of the terms and conditions with an asterisk.

## 3.39.1

Release: 15-09-2026

### Patch Changes

* Added a CSS variable to customize the overlay color of the SelphID code reader scan area.
* Added an error for expired operation URLs, which now stops the process instead of continuing.
* Renamed the Terms and Conditions widget `TermsConditions` property to `termsConditions`.

  Added a `consents` property to the Terms and Conditions widget to require several individual consents, each with its own text, optional link and required flag. The accepted consents are reported with the `userAccept` event.

  Added a `modalLinks` property to the Terms and Conditions widget to open the links of the legal content and of the consents in a modal, without leaving the flow.

  Removed the Terms and Conditions widget `termsLinkText` property. Its text is now part of `checkboxLabelText`.
* Fixed text rendering too bold in Safari.
* Added a dedicated result status for captures that exhaust the retry limit, previously reported as expired.

  Fixed facial capture reporting its IDV events as a document capture.

## 3.39.0

Release: 07-09-2026

### Minor Changes

* Added the emitFinishQr event, fired on both peers when the QR flow finishes.
* Added a new minCaptureTime property that keeps the capture open until the recorded video reaches a minimum duration in seconds
* Added the `codeReader` property to SelphID for an optional QR/code capture step.
* Added a `checkCapabilities` utility in the `/capabilities.mjs` subpath to check device requirements before the SDK provider is mounted.
* Added T\&C consent checkbox (replacing scroll-to-accept) with checkboxLabelText and termsLinkText.

  Added widget theme-color support for dark mode.

  Updated default strings for T\&C and Choose Document button.

### Patch Changes

* Added a minimum of two `tipAnimations` entries to the validation; an empty entry keeps the default animation for that platform.

  Added a minimum of three `tutorialAnimations` entries to the validation.

  Added a support has been added for customising the `livenessMove` animation.
* added start event on emitTrackStatus for selphi and selphid widgets
* Fixed a build failure in consumer apps caused by an unresolved internal validation module.
* Fixed steps property formatting for tracking.

## 3.38.1

Release: 13-08-2026

### Patch Changes

* Added max attempts handling to Selphi and SelphID widgets
* Fixed a non-blocking error incorrectly halting biometric and document capture widgets.

  Fixed a failed flow request leaving the SDK stuck on the loading screen.

  Fixed state from a previous execution persisting into the next one.
* Added new CSS variables for Selphi animations: --wrapper-color-tutorial-border-error and --wrapper-color-tutorial-glow-error.

## 3.38.0

Release: 24-07-2026

### Minor Changes

* Added support for the file-uploader as a workflow step. After a successful upload, the workflow now advances automatically to the next step, consistent with the Selphi and SelphID capture widgets.
* Added a `livenessMode` setting for the Selphi widget.
* Added `--wrapper-color-capture-neutral` to customize the SelphID capture frame border color.
* Added declarative validation of the SDK settings, with its severity controlled by the new `settingsStrictness` prop.
* Updated selphid engine version.

### Patch Changes

* Added alias names for several props that take precedence over the legacy names. The legacy names remained fully supported and now emitted a deprecation warning when used.
* Added support for a themed logo in the low-code workflow.

## 3.37.6

Release: 10-07-2026

### Patch Changes

* Classified selphid engine init load errors, retried transient failures, and terminated workers on load-error
* Fixed selphid timeout race condition

## 3.37.5

Release: 02-07-2026

### Patch Changes

* Updated uuid dependency
* Deprecated country property in SelphID widget
* Added the Terms and Conditions workflow widget with sanitized content, localized actions, tracking, cancellation handling, generated typings, and isolated provider theme styles.
* Added `--text-font` and `--title-font` theme variables with Poppins as the default typeface (Regular for body text, Semibold for titles).
* Added the possibility to use the same widget several times in a workflow
* Reduced embedded Poppins payload from \~417KB to \~32KB using a glyph subset and WOFF2.

## 3.37.4

Release: 11-06-2026

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-recording\@2.6.5
  * @facephi/sdk-video-assistance\@1.1.5

## 3.37.3

Release: 08-06-2026

### Patch Changes

* Increased in18njs version and moved lodash resolution to sdk-wc

## 3.37.2

Release: 29-05-2026

### Patch Changes

* VideoProvider now forwards `cameraId` and `cameraType` from resolved video settings to the video recording hook.
* Updated dependencies
  * @facephi/sdk-video-recording\@2.6.4

## 3.37.1

Release: 20-05-2026

### Patch Changes

* Fixed camera permission when QR enabled.
* Added correct first animation id in QR workflows
* Fixed Selphi/SelphID initial tip Lottie for initial-tip-width and initial-tip-height
* Limited the file size and type in the fileUploader
* added cameraSwitch improvements
* Removed axios from the packages where it was not used and added a resolution
* Added initial loading status in sdk-provider
* Added tracking on the IAD platform.
* Updated dependencies
  * @facephi/sdk-video-assistance\@1.1.4
  * @facephi/sdk-video-recording\@2.6.3

## 3.37.0

Release: 08-05-2026

### Minor Changes

* Added a new parameter called DPI to SelphID
* Added widgetLoaded and userCancel events to the file uploader widget, as well as new event detail types
* Added 'emitTrackStatus' event to track components status
* Added qr widget standalone
* Updated the Selphi component.

### Patch Changes

* Updated packages to address vulnerabilities.
* Removed CSS --color-tutorial-success. Added color-tutorial-tshirt for animations.
* Fix multiple EmitOperationId emissions
* Fixed css application in IDV flows
* Fixed video recording behaviour when license is not valid
* Prevented duplicate continue events in the QR widget.
* Added accessibility improvements to the FileUploader component.
* Updated dependencies
  * @facephi/sdk-video-assistance\@1.1.3
  * @facephi/sdk-video-recording\@2.6.2

## 3.36.2

Release: 14-04-2026

### Patch Changes

* Resolved picomatch vulnerability

## 3.36.1

Release: 09-04-2026

### Patch Changes

* Updated dependencies
* Add `antispoofPayloadSize` to the Selphi widget (`PayloadSize` from `@facephi/selphi-web-component`, default `Small`)
* Updated dependencies
  * @facephi/sdk-metrics\@1.0.2
  * @facephi/sdk-video-recording\@2.6.1

## 3.36.0

Release: 01-04-2026

### Minor Changes

* Removed tokenizerLocation prop from Selphi and SelphID
* Added IAD tracking asset platform IDV
* Created new local recording feature as part of the video identification
* Updated video recording error messages

### Patch Changes

* Added logic to filter options in chooseDocument if documentType or country are provided
* Fixed videorecording for QR flows on mobile: from now on, the videorecording socket does not keep opened when the user is back on the desktop view
* Fixed sync desktop and mobile view with QR
* Updated dependencies
  * @facephi/sdk-video-recording\@2.6.0

## 3.35.2

Release: 05-03-2026

### Patch Changes

* Fixed qrExtraParams loose in qr widget url

## 3.35.1

Release: 26-02-2026

### Patch Changes

* Fixed vulnerabilities and removed unused packages
* Fixed gif resource not found
* Fixed proxy autentication error
* Updated dependencies
  * @facephi/sdk-voice-recognition\@1.0.2
  * @facephi/sdk-video-assistance\@1.1.2
  * @facephi/sdk-video-recording\@2.5.1
  * @facephi/sdk-metrics\@1.0.1

## 3.35.0

Release: 12-02-2026

### Minor Changes

* Updated widgets version to 6.35.0

### Patch Changes

* Renamed the SDK CSS variables to kebab case
* Added control variable to prevent stopVideo from being called twice
* Added customised to facephi-qr-widget
* Customised CSS views in the SDK
* Customizable initial-tip view, both colours and animations.
* Added customised to chose-document
* Added correct usage of CSS variables from the SDK.

## 3.29.0

Release: 10-02-2026

### Minor Changes

* Added ID for Civil Validation Widget
* Added tokenize feature, new generic error instead of the timeout and civil validation widget

## 3.28.0

Release: 22-01-2026

### Minor Changes

* Deleted unused language property in the Selphi and SelphID wrappers

### Patch Changes

* Fixed environment variable compatibility (Vite)
* Added proxy as possible resources path when it is added as prop to the SDK

## 3.27.2

Release: 23-12-2025

### Patch Changes

* Fixed the theme application in sdk-provider

## 3.27.1

Release: 17-12-2025

### Patch Changes

* Added sendFinish event to QR-widget

## 3.27.0

Release: 17-12-2025

### Minor Changes

* Added Angular library output

### Patch Changes

* Fixed error related with import.meta.env in CRA environments

## 3.26.0

Release: 05-12-2025

### Minor Changes

* Extended the scope of the proxy property to enable video recording functionality through a proxy server
* Refactored sdk-web to include IDV business logic compatibility
* sdk-metrics for IDV
* Created new idv and idv tracking services to start idv workflows and track idv assets respectively
* Replaced this bind variable by state in store
* Introduced an optional authenticationId parameter to SDK to perform ‘authentication’ operations in IDV integrations

### Patch Changes

* Fixed cipher service test and transformed ocr result object
* Updated dependencies
  * @facephi/sdk-video-recording\@2.5.0
  * @facephi/sdk-metrics\@1.0.0

## 3.25.1

Release: 28-11-2025

### Patch Changes

* Updated version as latest

## 3.25.0

Release: 24-11-2025

### Minor Changes

* Added new `file-uploader-widget` component with drag & drop capabilities

## 3.24.1

Release: 10-11-2025

### Patch Changes

* Unnecessary tracking errors have been changed to warnings

## 3.24.0

Release: 03-11-2025

### Minor Changes

* Updated Selphi Widget

## 3.23.1

Release: 03-11-2025

### Patch Changes

* Updated Selphi Widget

## 3.23.0

Release: 29-10-2025

### Minor Changes

* Uploaded Selphi and Selphid version used by sdk component

## 3.22.0

Release: 07-10-2025

### Minor Changes

* A new parameter has been enabled that allows you to add a URL to redirect services to a proxy.

## 3.21.2

Release: 29-09-2025

### Patch Changes

* Updated selphi & selphid widgets to latest version

## 3.21.1

Release: 22-09-2025

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-recruitment\@1.3.1
  * @facephi/sdk-video-assistance\@1.1.1
  * @facephi/sdk-video-recording\@2.4.1

## 3.21.0

Release: 19-09-2025

### Minor Changes

* Enabled diagnostic timer functionality for Selphi widget

### Patch Changes

* Added customerId to QR flow
* Updated dependencies

## 3.20.3

Release: 15-09-2025

### Patch Changes

* Improved compatibility with shadow root integration

## 3.20.2

Release: 08-09-2025

### Patch Changes

* Upgraded selphid version to 6.18.3

## 3.20.1

Release: 03-09-2025

### Patch Changes

* Updated widget versions to 6.18.1

## 3.20.0

Release: 03-09-2025

### Minor Changes

* Added a new log to control tracking errors
* Enabled usage of new property enableDocumentFlip for Selphid widget
* Added RENAP Widget
* Added error codes for IDV

## 3.19.0

Release: 19-08-2025

### Minor Changes

* Implemented a global error manager for sdk-web-wc
* Added the data encryption management service in sdk-web-wc due to the requirements of the new IDV services
* Fixed error to ensure security service is available to be consumed
* Added generateBrowserCache methods to download Selphi or SelphID resources before its initialization

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-recruitment\@1.3.0
  * @facephi/sdk-video-assistance\@1.1.0

## 3.18.0

Release: 11-08-2025

### Minor Changes

* Updated selphi widget to version 6.17.0

## 3.17.0

Release: 31-07-2025

### Minor Changes

* Fixed previewImage property compatibility
* Added option for export self-contained bundle for CDN environments
* Implemented widgets css variable for error icon max width and tutorial modal property

## 3.16.0

Release: 25-07-2025

### Minor Changes

* Updated widgets version to latest

## 3.15.0

Release: 25-06-2025

### Minor Changes

* Consumed animation and translation files directly from sdk without the use of any CDN
* Added livenessMoveResult to sendSelphi for landings

## 3.14.2

Release: 13-06-2025

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-recording\@2.4.0

## 3.14.1

Release: 12-06-2025

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-recording\@2.3.0

## 3.14.0

Release: 09-06-2025

### Minor Changes

* Added bidirectional styling with --wraper variables & theme
* Skipped timeout error view from widget for landing use cases

## 3.13.0

Release: 05-06-2025

### Minor Changes

* Fixed the emitWorkflowEvent of the SDK Provider so that the event is only emitted when the workflow property is active
* New script to automatically base64-encode tokenizer/licensing worker during build.

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-recording\@2.2.0

## 3.12.0

Release: 29-05-2025

### Minor Changes

* A new enhancement has been added to the SDK Provider lifecycle to improve its compatibility with frameworks.

### Patch Changes

* Fixed styling compatibility issues between using wrapper variables and original widget variables

## 3.11.1

Release: 22-05-2025

### Patch Changes

* Fixed tutorial prop default value

## 3.11.0

Release: 22-05-2025

### Minor Changes

* Sent antispoofing results to backend when service is enabled
* Added support for custom translations via a JSON object provided in the language settings parameter or url

### Patch Changes

* Updated widgets to 6.13.0
* Added new widget prop names in SDK wrappers

## 3.10.0

Release: 07-05-2025

### Minor Changes

* Handled assigned worker and wasm memory to ensure good performance on low capability devices
* In this pr we have modified the css of the results widget so that in the case that it is used on a mobile device, the information resulting from the capture is still displayed.

## 3.9.0

Release: 22-04-2025

### Minor Changes

* Improved logic for video recording services
* Adapted autoselect engine logic

### Patch Changes

* Updated CSS variables for selphi and selphid widgets, and cleaned up global styles
* Updated dependencies
  * @facephi/sdk-video-recruitment\@1.2.0
  * @facephi/sdk-video-recording\@2.1.0

## 3.8.1

Release: 31-03-2025

### Patch Changes

* Added CDN\_URL to build

## 3.8.0

Release: 31-03-2025

### Minor Changes

* New video recording flow
* Changes for bun management and export in video-recording

### Patch Changes

* Changed video recording process
* Updated dependencies
  * @facephi/sdk-video-recording\@2.0.0

## 3.7.0

Release: 24-03-2025

### Minor Changes

* Updated widget versions and added enableVideoTimer prop

## 3.6.0

Release: 14-03-2025

### Minor Changes

* Added resourcePath prop to sdk-provider
* Fixed QR Workflow on Mobile Devices
* Implemented new widget props into sdk widget wrappers for full compatibility

### Patch Changes

* Updated tokenizer worker
* Upgraded Selphi and Selphid to v6.10.0
* Added tokenize prop to SelphidWidget for result tokenization

## 3.5.8

Release: 06-03-2025

### Patch Changes

* Updated internal dependencies

## 3.5.7

Release: 26-02-2025

### Patch Changes

* Conditionally rendered mask based on test state

## 3.5.6

Release: 25-02-2025

### Patch Changes

* Fixed issue with workflowprovider when loading

## 3.5.5

Release: 25-02-2025

### Patch Changes

* Improved error handling via sdk with workflow

## 3.5.4

Release: 21-02-2025

### Patch Changes

* Fixed typos on widget wrappers for sdk

## 3.5.3

Release: 20-02-2025

### Patch Changes

* Updated sdk with last version of selphi and selphid widgets

## 3.5.2

Release: 19-02-2025

### Patch Changes

* Fixed asset types for full document images

## 3.5.1

Release: 18-02-2025

### Patch Changes

* Added missing translations for sdk

## 3.5.0

Release: 18-02-2025

### Minor Changes

* Updated strings and logic to show correct language on result components

## 3.4.2

Release: 11-02-2025

### Patch Changes

* Fixed Graph resources assignation to empty object

## 3.4.1

Release: 10-02-2025

### Patch Changes

* Verified variables before accessing its properties and values

## 3.4.0

Release: 07-02-2025

### Minor Changes

* Added testing, improved tracking logic and implemented mask element

## 3.3.4

Release: 30-01-2025

### Patch Changes

* Fixed to remove unnecessary check origin request in debug mode

## 3.3.3

Release: 23-01-2025

### Patch Changes

* Updated widgets version

## 3.3.2

Release: 23-01-2025

### Patch Changes

* Fixed sdk loader

## 3.3.1

Release: 22-01-2025

### Patch Changes

* Prepared SDK version for non workflow use cases

## 3.3.0

Release: 15-01-2025

### Minor Changes

* Added video assistance widget

### Patch Changes

* Updated dependencies
  * @facephi/sdk-video-assistance\@1.0.0

## 3.2.2

Release: 15-01-2025

### Patch Changes

* Fixed Translations
* Fixed translations wait for Request

## 3.2.1

Release: 14-01-2025

### Patch Changes

* Fixed Disabled when calling services of landing

## 3.2.0

Release: 10-01-2025

### Minor Changes

* Added WaitRequest parameter in SDK, with this parameter set to true it will wait for the requested requests

## 3.1.1

Release: 08-01-2025

### Patch Changes

* Fixed Results screen does not make api call when using QR
* Fixed: Requested ideal resolution when changing cameras
* Updated dependencies
  * @facephi/sdk-video-recording\@1.1.2

## 3.1.0

Release: 08-01-2025

### Minor Changes

* Added check of license origin, minor bug fixed

## 3.0.5

Release: 18-12-2024

### Patch Changes

* Fixed Emit Api Error in WorkflowEvents

## 3.0.4

Release: 13-12-2024

### Patch Changes

* Fixed styles for VideoRecruitment in Iphone in Safari
* Updated dependencies
  * @facephi/sdk-video-recruitment\@1.1.3

## 3.0.3

Release: 13-12-2024

### Patch Changes

* Removed a necessary dependency on axios and buffer

## 3.0.2

### Patch Changes

* Included tablet resolution in media query for video recruitment
* Updated dependencies
  * @facephi/sdk-video-recruitment\@1.1.2

## 3.0.1

Release: 10-12-2024

### Patch Changes

* Fixed problem when propagating original widget events

## 3.0.0

Release: 05-12-2024

### Major Changes

* Refactored SDK Web including new version of widgets in Web Components

### Minor Changes

* Added Results Component in Desktop View in Mode QR
* Supported Customizable Button Text in Results Widget
* Added CDN for SDK Web Resources
* Added trackings full Images
* Added Advanced Tracking Events
* Improved country prop validation logic

### Patch Changes

* Fixed Video
* Fixed Document Validation Widget skip
* Fixed VideoRecording in flow
* Fixed recover Events Missing
* Fixed Next Step Widget
* Fixed widget unknown
* Fixed Video Recruitment Finish
* Added object-fit in image
* Fixed multiple issues for landing
* Fixed bug with camera switching on Samsung
* Got loading when video recording exists
* Fixed video, waited channel before loading selphid and selphi widget
* Updated selphid and selphi to 6.6.1
* Fixed Button text Results Widget
* Removed listener decorators in voice widget
* Fixed Next Step
* Fixed problem when tracking document one side
* Fixed QR with videorecording
* Added Finish Event
* Updated widgets to 6.4.0
* Fixed Landing Api Key
* Fixed generate operationId in landing
* Fixed Send Selphi in Landing
* Added Event for Load Sdk provider
* Fixed ContentType assets
* Parsed settings for web component widgets
* Fixed Problem with qr event on finish
* Waited for the recording when it is required
* Fixed Error with contentType
* Fixed emit Data
* Updated selphid and selphi to 6.7.0
* Updated dependencies
* Updated dependencies
  * @facephi/sdk-video-recording\@1.1.1