5.4.0 (2026-06-29)
5.3.0 (2026-06-16)
- automate releases with semantic-release and npm OIDC trusted publishing (#272) (fb8bc4a), closes Telefonica/tf-github-cdo-repos#256
- verifyIdentity: new method (#271) (cff1bf1)
openQrScanner: new method to open a native QR code scanner that returns the decoded text of the scanned QR codesetLocatorSdkMode: add optionalcorrelationparameter (Record<string, string>) to pass correlation data alongside the mode
setupLocatorSdkConfig: config parameter now accepts a generic object (Record<string, unknown>) instead of the specificLocatorSdkConfigtypegetLocatorSdkConfig: return type now usesRecord<string, unknown> | nullinstead ofLocatorSdkConfig | null
- Breaking change:
requestPermissionBackgroundLocationnow returns'granted' | 'denied'(removed'settings_change_required') - Breaking change:
requestPermissionBatteryOptimizationnow returns'granted' | 'denied'(removed'settings_change_required')
bottomSheet: Add basic Tag to Sheet of type LIST / SINGLE_SELECTION
- Family Locator SDK request permission methods:
requestPermissionLocation,requestPermissionBackgroundLocation,requestPermissionMicrophone,requestPermissionNotifications,requestPermissionCriticalAlerts,requestPermissionBatteryOptimization
- Breaking change: remove sheet-specific methods:
bottomSheetActionSelector,bottomSheetSingleSelector,bottomSheetInfo - Breaking change: remove
onNativeEvent - Breaking change: remove B2P methods:
getAppDomain,refreshNavBar,increaseAppRatingTrigger,resetAppRatingTrigger,appRatingRemindMeLater - Family Locator SDK methods:
setupLocatorSdkConfig,getLocatorSdkState,setLocatorSdkMode,getLocatorJwtToken,getLocatorPendingPermissions,getLocatorSdkVersion,getLocatorSdkSession,getLocatorSdkMode,getLocatorSdkConfig
openOcrScanner: addedtimeoutMsoption to specify a timeout for the OCR scanning operation. Raises 204 error if closed by user and 408 error if timeout
internalNavigation: support "accessibility-settings" feature
openOcrScanner: new method to open a native OCR scanner that looks for text matching a provided regular expressioninternalNavigation: support "permissions-settings" feature
updateNavigationBar: add isButton
isQualtricsInterceptAvailableForUser: return surveyUrl.
setBiometricsAuthenticationStatus: new method to set the biometrics authentication status on the device.
internalNavigation: support "location-settings" feature
requestAllowMeBiometrics: document "User not logged in" error case
getBiometricsAuthenticationStatus: Get the current status of the biometrics authentication on the device
requestAllowMeBiometrics: new method to start the AllowMe native SDK biometrics flow- App rating, new methods:
increaseAppRatingTrigger,resetAppRatingTrigger,appRatingRemindMeLater setScreenName: support disable params sanitization
triggerPinOrBiometricAuthentication: support new DEVICE_HAS_NO_AUTHENTICATION result case
addOrEditContact: new method to add or edit a contact in the native phone book
- webview bridge: allow multiple instances to work simultaneously in the same page
requestAllowMeBiometrics: new method to start the AllowMe native SDK biometrics flow
getAppDomain: renameappDomaintodomainto follow the spec/doc
getAppDomain: new method to get the app domain.showLineSelector: new method, onpens the native line selector dialog.
refreshNavBar: new method to refresh navigation bar with the response of Visual Modules API
validateDatamobRequirements: fix return types.
validateDatamobRequirements: remove googleAccount.
setQualtricsProperties: fix types.
- Datamob sdk:
unregisterDatamobDeviceAdmin.
- Qualtrics sdk methods:
displayQualtricsIntercept,setQualtricsProperties,isQualtricsInterceptAvailableForUser.
- Datamob sdk methods:
registerDatamobUser,requestDatamobDeviceAdmin,validateDatamobRequirements.
- New
getUnseenNotificationsBadge/setUnseenNotificationsBadgefunctions
- New
getInstallationIdfunction
- Remove
backgroundAnimationoption fromshowLoadingOverlay
- New
showLoadingOverlay/hideLoadingOverlayfunctions - Use web api when available in
readTextFromClipboardandwriteTextToClipboardfunctions - Optimize bundle size
- New
getBatteryInfofunction - New
readTextFromClipboardandwriteTextToClipboardfunctions
- New
downloadBase64function
- New
getTopazValuesfunction
- New
focusNavbarfunction
- New
shareBase64function
nativeConfirm: addeddestructivemodenativeMessag: addedbuttonAccessibilityLabelprop
updateNavigationBaraddsectionNameto top navbar actions- removed tealium methods:
getCustomerHash/setCustomerHash
triggerPinOrBiometricAuthenticationmethod
getDeviceTacmethod
getProfileImage/startProfileImageFlowto read/change the profile imagegetPincodeInfoto get the pincode status
DATA_CONNECTION_INFO: AddPERMISSION_REQUIREDmobileConnectionType
- New
getNetworkConnectionInfofunction
- New
openOnboardingfunction nativeMessage: support forwithDismiss,duration: "PERSISTENT", andactionin response
- New
getDeviceModelfunction - Update
getEsimInfoto returneidif possible - Deprecate
requestSimIccandrequestSimImsi - New
colorVariantoption inupdateNavigationBar - README cleanup
- Add
bottomSheetActions
- Fix left/right action options in updateNavigationBar
- New method
onNavigationBarIconClickedto execute a callback when a NavigationBar icon is clicked
- Update
updateNavigationBarwith new properties
- Add
getAttStatusmethod
- improve TrackingEvent types
- allow ß char in analytics events
- sanitize tracking params in setScreenName in Android/iOS too
- added missing
getRemoteConfigexport
- New
getRemoteConfigfunction exposing firebase remote config
- Fix
setScreenNamein Android when not passing params.
- New
fetchPhoneNumbersandupdatePhoneNumbersmethods.
- New
bottomSheetActionSelectorandbottomSheetInfomethods
- Allow params in setScreenName
- Throw 423 error (locked) when trying to open a bottom sheet when a previous one is already being opened. This will prevent accidentally opening multiple sheets when the user does repeated taps
- Allow icons in
bottomSheetrows
- New
bottomSheetandbottomSheetSingleSelectorfunctions
- Analytics: allow
:in event params
- Analytics: fixes in sanitization and allow / and | chars
- Analytics: truncate long event param values that exceed Firebase limits
- Analytics: expose
sanitizeAnalyticsParamandsanitizeAnalyticsParamsmethods
- fix setScreenName in web (gtag) to log screen name as page_title
- make analytics function resilient to gtag script being blocked by adblocker
- fix Analytics to allow
_chars
- new
showAppRating()function
- Send page_view instead of screen_view in web
- Message ids are now unique across different webviews
- fixed: added missing logout export
- Logout: added new method to end session in native app
- Analytics: added support for GA4 with gtag script in web. Removed old web UA support with google analytics.js script
- Analytics: automatically sanitize GA4 event attribute values.
- New method:
getTopazToken. - Add timeout option to
renewSession. setLoggermethod to log bridge traffic for debugging.
BRIDGE_READYmessage
- Analytics: support GA4/Firebase event format
- HIGHLIGHT_TAB message
- fix how we detect the lib is running inside an iframe.
- Add missing export.
- Add
logEcommerceEventmethod.
- Add
setActionBehaviormethod to allow defining the behavior of close and back buttons in webviews - Upgrade dev dependencies to fix automatically reported vulnerabilities
- Breaking change:
webview-bridgewill be disabled inside iframes by default. It can be enabled by setting adata-enable-webview-bridgeproperty to theiframeelement.
- Expose
setTrackingProperty.
setTrackingProperty: fix typo in medallia.
- Add
setTrackingPropertymethod.
- Add
getEsimInfomethod.
- Fix
TrackingEventtype to bereadonly, so analytics functions can accept immutable events too.
- New method
getCustomerHash. Fetches the current customer subscription hash from the native app (for tracking purposes). For this method to return a valid hash, thesetCustomerHashmethod has to have been called before (typically done from account dashboard page)
- SSR friendly. Not using
windowordocumentwhen not available
- New function:
getDiskSpaceInfo
- New method
setCustomerHash. Sets the hash of the current subscription for the customer, which is used for tracking purposes.
- Analytics: log timing value as integer. Google Analytics expects an integer, not float
- Fix missing export type CustomDimensionIdx in flow type definitions
- Add new analytics dimensions
- Update all the dependencies
- Use Github Actions instead of Travis
- Remove accent marks from analytics event labels.
- Removed non-explicit flow types
- Add
expandedTitletoupdateNavigationBar().
- New function:
getAppMetadata
- More flow types fixes for renewSession
- Fix flow types for renewSession
- Improve changes in 2.9.0. RENEW_SESSION request message now includes the old
accessToken
- Messages to renew webview session.
- Add new flag
showProfileButtontoupdateNavigationBar().
- Update nativeConfirm and nativeAlert arguments type.
- New function:
fetchContactsByPhone
- New function:
requestVibration
- New function:
dismiss
- New function:
checkPermissionStatus - New function:
internalNavigation
- Add 500ms timeout to remote config
- Update setWebViewTitle implementation
- Update documentation
- Internal features. See
APPS-5331
- New function:
onNativeEvent
- New function:
reportStatus
- Update TrackingEvent type for flow
- Only send GA events to selected Trackers
- Fix
isABTestingAvailableflow type.
- Exported functions to A/B testing
isABTestingAvailable
- Add new Google Analytics custom dimensions
webviewBrowserVersion
- Add share function
- Remove visibility from navigation bar options
- Add new Google Analytics custom dimensions
- Add new Google Analytics custom dimensions
- Default values set for
labelandvaluefields when logging analytics events
-
Exported functions from analytics module:
logTimingsetUserProperty
-
Exported constants from analytics module:
CD_WEBAPP_INSTALLEDCD_NOVUM_UIDCD_EVENT_VALUE
-
Added flow definitions file