@cloudsignal/pwa-sdk 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -5,6 +5,74 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2025-01-17
+
+### Added
+
+- **JWT Authentication** - User-linked registrations via JWT tokens from identity providers
+- **Dual Auth Mode** - Support both HMAC (anonymous) and JWT (authenticated) authentication
+- `userToken` config option for JWT tokens (Supabase, Firebase, Auth0, Clerk, custom OIDC)
+- `onTokenExpired` callback for automatic token refresh on 401 errors
+- `setUserToken()` method to upgrade from anonymous to authenticated registration
+- `getAuthMode()` method to check current auth mode ('hmac' | 'jwt')
+- `auth:tokenUpdated` event emitted when auth token is updated/upgraded
+- Full TypeScript types for JWT auth utilities
+
+### Changed
+
+- All API calls now support both HMAC signature and JWT Bearer token authentication
+- Registration API extracts user_id and user_email from JWT claims when in JWT mode
+
+### Use Case
+
+Enables smart notification routing - send in-app notifications when users are online (MQTT connected) and web push when offline by linking registrations to authenticated user identities.
+
+## [1.1.1] - 2025-01-17
+
+### Added
+
+- **Vitest Test Framework** - Comprehensive unit test suite with jsdom environment
+- **DeviceDetector Tests** - 16 tests covering device/browser/OS detection
+- **WakeLockManager Tests** - 16 tests covering screen wake lock functionality
+- **i18n Translation Tests** - 18 tests covering all 20 supported languages
+- **Fingerprint Tests** - 7 tests covering unique device fingerprint generation
+- `test:coverage` script for code coverage reporting
+- Total: 57 unit tests passing
+
+## [1.1.0] - 2025-01-17
+
+### Added
+
+- **Screen Wake Lock** - Prevent screen sleep during critical operations (WakeLockManager)
+- **Offline Request Queue** - IndexedDB-backed queue with exponential backoff retry (OfflineQueueManager)
+- **iOS Install Banner** - Beautiful modal guiding iOS Safari users to install (IOSInstallBanner)
+- **20-Language i18n** - Auto-detects browser language for iOS banner
+  - Supported: en, es, fr, de, it, pt, nl, ru, zh, ja, ko, ar, he, hi, tr, pl, sv, da, no, fi
+- **Network-Aware Heartbeat** - Auto-adjusts interval based on connection type (4G=30s, 3G=60s, 2G=120s)
+- **Battery-Aware Heartbeat** - Pauses heartbeat when battery <15% and not charging
+- **Notification Analytics** - Track displayed/clicked/dismissed events in service worker
+- **Save Data Respect** - Reduces heartbeat frequency when user has Save Data enabled
+
+### New Config Options
+
+- `wakeLock` - Screen wake lock configuration
+- `offlineQueue` - Offline request queue settings
+- `iosInstallBanner` - iOS install banner customization
+- `notificationAnalytics` - Analytics tracking settings
+
+### New Events
+
+- `wakeLock:acquired`, `wakeLock:released`, `wakeLock:error`
+- `offlineQueue:queued`, `offlineQueue:processed`, `offlineQueue:flushed`
+- `iosBanner:shown`, `iosBanner:dismissed`, `iosBanner:installClicked`
+- `heartbeat:intervalChanged`, `heartbeat:pausedForBattery`, `heartbeat:resumedFromBattery`
+
+### Browser Support Notes
+
+- Wake Lock: All modern browsers as of March 2025
+- Battery API: Chromium-based browsers only
+- Network Information API: Chromium-based browsers (graceful fallback)
+
 ## [1.0.0] - 2025-01-14
 
 ### Added

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 CloudSignal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudsignal/pwa-sdk",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "CloudSignal PWA SDK - Progressive Web App features with push notifications, JWT/HMAC authentication, installation management, device tracking, offline queue, wake lock, and notification analytics",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -55,11 +55,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/cloudsignal/vernemq-service.git",
-    "directory": "cloudsignal-pwa-sdk"
+    "url": "https://github.com/cloudsignal/pwa-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/cloudsignal/vernemq-service/issues"
+    "url": "https://github.com/cloudsignal/pwa-sdk/issues"
   },
   "homepage": "https://cloudsignal.io",
   "publishConfig": {