--- updatedAt: 2025-02-13T15:14:48.000Z agentTools: projectIndex: https://vision.truepic.dev/llms.txt --- # Lens Web SDK Changelog A version-by-version history all of Lens Web SDK releases since the beginning of time ## v1.22.0 *Released 1/22/2025* * Internal maintenance and bug fixes. ## v1.21.0 *Released 12/17/2024* * Internal maintenance and bug fixes. ## v1.20.0 *Released 12/11/2024* * `LensError` now includes a `details` property that can contain additional context. For example, `LensUserAgentError` includes a `userAgent` object that contains the parsed user agent. * Internal maintenance and bug fixes. ## v1.19.0 *Released 11/4/2024* * The `config.appVersion` option when initializing the library is now optional. * Internal maintenance and bug fixes. ## v1.18.0 *Released 10/2/2024* * Added a new `location.preciseAccuracyMax` option to [`open()`](https://vision.truepic.dev/docs/lens-web-sdk-reference#open-the-camera) that sets the maximum number of meters allowed for accuracy when precise location is required. * Internal maintenance and bug fixes. ## v1.17.0 *Released 8/19/2024* * The font used for text throughout the camera can now be customized with the CSS variable `--lens-camera-font-family`. See [Style Customizations](https://vision.truepic.dev/docs/lens-web-sdk-reference#style-customizations) for more details. ## v1.16.0 *Released 7/15/2024* * Videos can now be up to 60 seconds in length, increased from 30 seconds. ## v1.15.1 *Released 6/20/2024* * Fixed an issue preventing Chrome WebViews. ## v1.15.0 *Released 6/18/2024* * Added support for Safari and Chrome WebViews. ## v1.14.0 *Released 6/3/2024* * Internal maintenance and bug fixes. ## v1.13.0 *Released 5/29/2024* * Added support for Safari's private mode, which previously failed when taking a capture. ## v1.12.0 *Released 5/17/2024* * Internal maintenance and bug fixes. ## v1.11.0 *Released 5/2/2024* * Added security improvements for enhanced capture authenticity and integrity. * Fixed an issue that caused captures to fail when location was not required. ## v1.10.0 *Released 4/5/2024* * Added an `id` property to the [capture object](https://vision.truepic.dev/docs/lens-web-sdk-reference#capture-object), which is a unique, randomly generated identifier for the capture while in the browser. * Added a `status` property to the [capture object](https://vision.truepic.dev/docs/lens-web-sdk-reference#capture-object) that contains the current status of the capture, all of which are enumerated in a new `STATUSES` constant. * Added a config option, [`storeCaptures`](https://vision.truepic.dev/docs/lens-web-sdk-reference#open-the-camera), which stores captures in the browser for reference indefinitely, rather than only during the period of pending and active upload. It defaults to false. * Added a feature that automatically pauses and resumes uploads when page visibility changes, such as switching tabs or backgrounding the browser. * Improved upload handling by ensuring media that are pending upload are not longer lost if the page is reloaded. Captures are automatically stored in the browser and re-enqueued for upload. A new [`captures-loaded` event](https://vision.truepic.dev/docs/lens-web-sdk-reference#captures-loaded) is fired when this happens after the camera is initialized. * Added a function, [`deleteCapture()`](https://vision.truepic.dev/docs/lens-web-sdk-reference#delete-a-capture), which deletes a single capture stored in the browser, and [`deleteAllCaptures()`](https://vision.truepic.dev/docs/lens-web-sdk-reference#delete-all-captures)deletes them all. * Added a function, [`retryUpload()`](https://vision.truepic.dev/docs/lens-web-sdk-reference#retry-upload), which manually retries an upload. * Added a cap of 25 upload attempts per capture. If all attempts fail, the status of the capture is set to `ERROR`, and it must be manually retried using `retryUpload()`. * Added a class,[`LensUploadError`](https://vision.truepic.dev/docs/lens-web-sdk-reference#lensuploaderror), which is thrown for every failed upload attempt. ## v1.9.1 *Released 2/27/2024* * Internal maintenance and bug fixes. ## v1.9.0 *Released 2/20/2024* * Internal maintenance and bug fixes. ## v1.8.0 *Released 2/8/2024* * Added a function, [`isUserAgentSupported()`](https://vision.truepic.dev/docs/lens-web-sdk-reference#check-browser-support), to check whether the current browser (user agent) is supported. * Added a function, [`useExternalUploadIndicator`](https://vision.truepic.dev/docs/lens-web-sdk-reference#move-or-remove-the-upload-indicator), that moves or removes the upload indicator from the default position. * User interface improvements. ## v1.7.0 *Released 1/26/2024* * Added an option, [`allowModeChange`](https://vision.truepic.dev/docs/lens-web-sdk-reference#open-the-camera), to configure whether to allow the user to change the mode from photo or video in the camera. * Fixed an issue causing style bleeding. * User interface improvements. ## v1.6.0 *Released 12/1/2023* * Internal maintenance and bug fixes. ## v1.5.0 *Released 10/13/2023* * Internal maintenance and bug fixes. ## v1.4.0 *Released 4/14/2023* * Added a new feature that allows you to configure whether the user should be prompted for location permission and if it is required for capture. You can also set whether precise location permission is required. All of this can be configured when calling [`open()`](https://vision.truepic.dev/docs/lens-web-sdk-reference#open-the-camera). As a result of this change, precise location is now required by default, whereas it wasn't previously. ## v1.3.0 *Released 1/31/2023* * Added support for Apple and Android-based tablets, including iPads and Galaxy Tablets. See the [web integration guide](https://vision.truepic.dev/docs/lens-web-sdk#device--browser-support) for an updated list of device and browser support. ## v1.2.0 *Released 1/11/2023* * Improved how upload retries are handled. * Added an [error event](https://vision.truepic.dev/docs/lens-web-sdk-reference#error), which fires when an error occurs that may be useful to your integration. ## v1.1.0 *Released 11/30/2022* * Added support to set [process options on camera open](https://vision.truepic.dev/docs/lens-web-sdk-reference#open-the-camera). This feature unlocks the ability to do location comparison on each capture, as well as toggle on/off specific services in parity with the [options available](https://vision.truepic.dev/reference/post_captures) in a `POST` upload capture request to the web API. ## v1.0.1 *Released 11/10/2022* * Lowered JPEG quality from 100 to 95, which reduces file size by half with minimal perceptible change. ## v1.0.0 *Released 10/3/2022* * Initial release! :tada: