notificare-web/CHANGELOG.md

The official Notificare JS library.

# CHANGELOG

## 4.2.2

- Improve how long content overflows in the push onboarding and in-app messages.
- Wait for the in-app message action event before executing the presenter

## 4.2.1

- Fix issue where the camera remained active after dismissing modal
- Fix parseInboxResponse() parameters validation (user-inbox)
- Fix issue where custom events could be logged when Notificare was not ready

## 4.2.0

- Recover when a device is removed remotely

# 4.1.0

- Allow unsetting user data fields

## 4.0.1

- Filter invisible and expired inbox items
- Prevent overlaying in-app messages on top of the push onboarding
- Prevent overlaying in-app messages on top of notifications

## 4.0.0

- Device identifiers become long-lived
- Add support for customisable hosts

#### Breaking changes

- `NotificareDevice.id` attribute no longer contains the push token. Use `getSubscription()` from `notificare-web/push` instead.
- The `NotificareDevice` data model was reduced to only publicly relevant attributes.
- `onDeviceRegistered` only triggers once, when the device is created.
- `NotificareTransport` was moved to `notificare-web/push`.

## 4.0.0-beta.2

- Changed the `subscriptionId` properties to a more robust data model
- Allow `configure()` to be called more than once, provided Notificare is unlaunched.

## 4.0.0-beta.1

- Device identifiers become long-lived
- Add support for customisable hosts

#### Breaking changes

- `NotificareDevice.id` attribute no longer contains the push token. Use `getSubscriptionId()` from `notificare-web/push` instead.
- The `NotificareDevice` data model was reduced to only publicly relevant attributes.
- `onDeviceRegistered` only triggers once, when the device is created.
- `NotificareTransport` was moved to `notificare-web/push`.

## 3.6.0

- Report back errors in `launch()` and `unlaunch()`
- Remove push onboarding branding
- Add support for the URLResolver notification type

## 3.5.0

- Session close events now report the time when they happened instead of when they're sent
- Prevent duplicate session close events
- Recover push enrolment based on browser permission
- Remove onboarding elements when un-launching

## 3.4.0

- Fix device's last registered date encoding
- Remove the default icon from the notification preview when there is no `image` support
- Refresh the WebPush subscription when the current one is considered valid
- Fallback to presenting the root page when the notification contains invalid content
- Prevent concurrent registrations when the permission changes

## 3.3.0

- Set the last onboarding attempt when accepting it preventing re-prompting when notifications are blocked
- Enable remote notifications when manually changing the permission after opting-in

## 3.2.0

- Monitor notification permission changes
- Add `onNotificationSettingsChanged` event for a more accurate `allowedUI`
- Fix device do not disturb returning `null` instead of `undefined`
- Fix auto-enable remote notifications blocking the launch flow
- Prevent the `onDeviceRegistered` event from invoking before the `onReady` event
- Ensure `hasRemoteNotificationEnabled()` returns an accurate value when `onDeviceRegistered` is executed

## 3.2.0-beta.1

- Monitor notification permission changes
- Add `onNotificationSettingsChanged` event for a more accurate `allowedUI`
- Fix device do not disturb returning `null` instead of `undefined`
- Fix auto-enable remote notifications blocking the launch flow
- Prevent the `onDeviceRegistered` event from invoking before the `onReady` event
- Ensure `hasRemoteNotificationEnabled()` returns an accurate value when `onDeviceRegistered` is executed

## 3.1.1

- Update JS target to ES6 for CommonJS builds

## 3.1.0

#### Important changes since 3.0.0

- Add support for dark mode
- Add `data-notificare-theme` attribute to override the default theme
- Add utility to load external stylesheets
- Prevent click outside to dismiss the auto-onboarding prompt
- Process notifications in the service worker when possible
- Fix standalone mode detection in Safari Desktop & Chrome Mobile
- Fix open notification in Chrome Mobile
- Fix in-app browser action reply tracker
- Export `NotificareOptions`

## 3.1.0-beta.2

- Add `data-notificare-theme` attribute to override the default theme
- Prevent click outside to dismiss the auto-onboarding prompt

## 3.1.0-beta.1

- Add support for dark mode
- Add utility to load external stylesheets
- Process notifications in the service worker when possible
- Fix standalone mode detection in Safari Desktop & Chrome Mobile
- Fix open notification in Chrome Mobile
- Fix in-app browser action reply tracker
- Export `NotificareOptions`

## 3.0.0

Check our [migration guide](./MIGRATION.md) before adopting the v3.x generation.

- Explicitly resolve Notificare Links
- Show passes natively whenever possible
- Fix exported definition files

## 3.0.0-beta.3

Check our [migration guide](./MIGRATION.md) before adopting the v3.x generation.

- Fix user registration for Web Push devices
- Prevent undefined string in asset url
- Fix launch flow for disabled auto-badge apps
- Add `onInboxUpdated` event

## 3.0.0-beta.2

Check our [migration guide](./MIGRATION.md) before adopting the v3.x generation.

- Fix notification UI for image content
- Prevent Safari Push from replacing Web Push
- Auto-enable remote notifications & location updates when opted-in
- Improve location clean-ups
- Add default location for the service worker
- Add validation to options
- Change the configuration file from `config.json` to `notificare-services.json`
- Change the package from `notificare` to `notificare-web`
- Distribute production-ready CSS files through `notificare-web`
- Add CSS resets to improve UI consistency
- Fix duplicate replies in quick actions
- Add migration from v2 storage
- Add `ignoreTemporaryDevices` and `ignoreUnsupportedWebPushDevices` options
- Fix readiness state in service worker
- Add allowedUI getter

## 3.0.0-beta.1

Check our [migration guide](./MIGRATION-3.0.md) before adopting the v3.x generation.