@cloudsignal/pwa-sdk 2.0.0 → 2.1.2

package/CHANGELOG.md

@@ -5,6 +5,19 @@ 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).
 
+## [2.1.0] - 2026-04-23
+
+### Added
+
+- **Auto-register PWA installations on `initialize()`** — when the SDK detects it is running in standalone / installed mode, it automatically POSTs to `/api/v1/registration/install-only` so the device shows up in the Clients tab without requiring the user to enable push first. A subsequent `registerForPush()` call upgrades the same row server-side (matched by browser fingerprint).
+- `registerInstallation()` public method on `CloudSignalPWA` for manual install tracking.
+- `install:registered` event fires after the backend acknowledges the install registration. Payload: `{ registrationId }`.
+- Installation registrations are guarded by a localStorage flag (`isInstallationRegistered` / `markInstallationRegistered`) so repeat `initialize()` calls within the same storage session are no-ops.
+
+### Fixed
+
+- Restores the auto-install-registration feature originally shipped in 1.2.3 that was inadvertently removed in commit `42935abf`.
+
 ## [2.0.0] - 2026-04-23
 
 ### Changed (BREAKING)

package/dist/{chunk-IQHSODT4.js → chunk-NSF32IGO.js}

@@ -93,5 +93,3 @@ function isValidUUID(value) {
 }
 
 export { generateAuthHeaders, generateHMACSignature, isValidUUID, makeAuthenticatedRequest };
-//# sourceMappingURL=chunk-IQHSODT4.js.map
-//# sourceMappingURL=chunk-IQHSODT4.js.map

package/dist/hmac-YQQ5XQWC.js

@@ -0,0 +1 @@
+export { generateAuthHeaders, generateHMACSignature, isValidUUID, makeAuthenticatedRequest } from './chunk-NSF32IGO.js';

package/dist/index.cjs

@@ -1141,6 +1141,15 @@ function removeRegistrationId(organizationId, serviceId) {
   const key = `registration_${organizationId}_${serviceId}`;
   return removeStorageItem(key);
 }
+function isInstallationRegistered(organizationId, serviceId) {
+  const key = `install_registered_${organizationId}_${serviceId}`;
+  return getStorageItem(key) === true;
+}
+function markInstallationRegistered(organizationId, serviceId, registrationId) {
+  const key = `install_registered_${organizationId}_${serviceId}`;
+  setStorageItem(`install_id_${organizationId}_${serviceId}`, registrationId);
+  return setStorageItem(key, true);
+}
 var IndexedDBStorage = class {
   constructor(dbName = "CloudSignalPWA", dbVersion = 1) {
     this.db = null;
@@ -1451,6 +1460,13 @@ var PushNotificationManager = class {
         this.onTokenExpired
       );
       if (!response.ok) {
+        if (response.status === 422) {
+          const body = await response.clone().json().catch(() => null);
+          if (body?.detail?.code === "user_identity_required") {
+            this.log("Skipping push registration: service requires user identity");
+            return null;
+          }
+        }
         const errorText = await response.text();
         throw new Error(`Registration failed: ${response.status} - ${errorText}`);
       }
@@ -1473,6 +1489,71 @@ var PushNotificationManager = class {
       return null;
     }
   }
+  /**
+   * Register a PWA installation without a push subscription.
+   *
+   * Tracks users who installed the PWA (standalone display mode) but
+   * haven't granted notification permission yet. A subsequent
+   * ``registerForPush()`` call upgrades the same row to a full push
+   * registration (matched server-side by browser fingerprint).
+   *
+   * Guarded by a localStorage flag so repeat ``initialize()`` calls in
+   * the same storage session are no-ops.
+   */
+  async registerInstallation() {
+    try {
+      if (isInstallationRegistered(this.organizationId, this.serviceId)) {
+        this.log("Installation already registered, skipping");
+        return null;
+      }
+      const fingerprint = await generateBrowserFingerprint();
+      const deviceInfo = this.deviceDetector.getDeviceInfo();
+      const platformInfo = this.deviceDetector.getPlatformInfo();
+      const installationData = {
+        service_id: this.serviceId,
+        browser_fingerprint: fingerprint || void 0,
+        device_type: deviceInfo.deviceType,
+        device_model: deviceInfo.deviceModel,
+        browser_name: platformInfo.browser,
+        browser_version: platformInfo.browserVersion,
+        os_name: platformInfo.os,
+        os_version: platformInfo.osVersion,
+        user_agent: platformInfo.userAgent,
+        display_mode: "standalone",
+        is_installed: true,
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        language: navigator.language || "en-US"
+      };
+      const url = `${this.serviceUrl}/api/v1/registration/install-only`;
+      const response = await makeAuthenticatedRequestWithContext(
+        this.authContext,
+        "POST",
+        url,
+        installationData,
+        this.onTokenExpired
+      );
+      if (!response.ok) {
+        if (response.status === 422) {
+          const body = await response.clone().json().catch(() => null);
+          if (body?.detail?.code === "user_identity_required") {
+            this.log("Skipping install-only registration: service requires user identity");
+            return null;
+          }
+        }
+        const errorText = await response.text();
+        throw new Error(`Installation registration failed: ${response.status} - ${errorText}`);
+      }
+      const result = await response.json();
+      markInstallationRegistered(this.organizationId, this.serviceId, result.registration_id);
+      this.log(`Installation registered: ${result.registration_id}`);
+      return { registrationId: result.registration_id };
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.log(`Installation registration failed: ${err.message}`, "error");
+      this.onError?.(err);
+      return null;
+    }
+  }
   /**
    * Unregister from push notifications
    */
@@ -3258,11 +3339,19 @@ var CloudSignalPWA = class {
         this.configureNotificationAnalytics(swReg);
       }
       if (this.iosInstallBanner && this.config.iosInstallBanner?.showOnFirstVisit !== false) {
-        const installState = this.installationManager.getState();
-        if (!installState.isInstalled) {
+        const installState2 = this.installationManager.getState();
+        if (!installState2.isInstalled) {
           this.iosInstallBanner.show();
         }
       }
+      const installState = this.installationManager.getState();
+      if (installState.isInstalled) {
+        this.log("PWA installation detected, registering\u2026");
+        const installResult = await this.pushNotificationManager.registerInstallation();
+        if (installResult) {
+          this.emit("install:registered", { registrationId: installResult.registrationId });
+        }
+      }
       this.initialized = true;
       const result = {
         success: true,
@@ -4171,5 +4260,3 @@ exports.removeStorageItem = removeStorageItem;
 exports.setRegistrationId = setRegistrationId;
 exports.setStorageItem = setStorageItem;
 exports.updateAuthToken = updateAuthToken;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/index.d.mts

@@ -521,7 +521,7 @@ interface NotificationAction {
 /**
  * Event types emitted by the SDK
  */
-type PWAEvent = 'install:available' | 'install:accepted' | 'install:dismissed' | 'install:completed' | 'install:error' | 'push:registered' | 'push:unregistered' | 'push:updated' | 'push:error' | 'push:received' | 'push:clicked' | 'permission:granted' | 'permission:denied' | 'permission:prompt' | 'sw:registered' | 'sw:updated' | 'sw:error' | 'sw:activated' | 'config:loaded' | 'config:error' | 'heartbeat:started' | 'heartbeat:stopped' | 'heartbeat:sent' | 'heartbeat:error' | 'heartbeat:intervalChanged' | 'heartbeat:pausedForBattery' | 'heartbeat:resumedFromBattery' | 'network:online' | 'network:offline' | 'state:changed' | 'wakeLock:acquired' | 'wakeLock:released' | 'wakeLock:error' | 'offlineQueue:queued' | 'offlineQueue:processed' | 'offlineQueue:flushed' | 'iosBanner:shown' | 'iosBanner:dismissed' | 'iosBanner:installClicked' | 'auth:tokenUpdated';
+type PWAEvent = 'install:available' | 'install:accepted' | 'install:dismissed' | 'install:completed' | 'install:registered' | 'install:error' | 'push:registered' | 'push:unregistered' | 'push:updated' | 'push:error' | 'push:received' | 'push:clicked' | 'permission:granted' | 'permission:denied' | 'permission:prompt' | 'sw:registered' | 'sw:updated' | 'sw:error' | 'sw:activated' | 'config:loaded' | 'config:error' | 'heartbeat:started' | 'heartbeat:stopped' | 'heartbeat:sent' | 'heartbeat:error' | 'heartbeat:intervalChanged' | 'heartbeat:pausedForBattery' | 'heartbeat:resumedFromBattery' | 'network:online' | 'network:offline' | 'state:changed' | 'wakeLock:acquired' | 'wakeLock:released' | 'wakeLock:error' | 'offlineQueue:queued' | 'offlineQueue:processed' | 'offlineQueue:flushed' | 'iosBanner:shown' | 'iosBanner:dismissed' | 'iosBanner:installClicked' | 'auth:tokenUpdated';
 /**
  * Event handler function
  */
@@ -1364,6 +1364,20 @@ declare class PushNotificationManager {
      * Register for push notifications
      */
     register(options?: RegisterOptions): Promise<Registration | null>;
+    /**
+     * Register a PWA installation without a push subscription.
+     *
+     * Tracks users who installed the PWA (standalone display mode) but
+     * haven't granted notification permission yet. A subsequent
+     * ``registerForPush()`` call upgrades the same row to a full push
+     * registration (matched server-side by browser fingerprint).
+     *
+     * Guarded by a localStorage flag so repeat ``initialize()`` calls in
+     * the same storage session are no-ops.
+     */
+    registerInstallation(): Promise<{
+        registrationId: string;
+    } | null>;
     /**
      * Unregister from push notifications
      */

package/dist/index.d.ts

@@ -521,7 +521,7 @@ interface NotificationAction {
 /**
  * Event types emitted by the SDK
  */
-type PWAEvent = 'install:available' | 'install:accepted' | 'install:dismissed' | 'install:completed' | 'install:error' | 'push:registered' | 'push:unregistered' | 'push:updated' | 'push:error' | 'push:received' | 'push:clicked' | 'permission:granted' | 'permission:denied' | 'permission:prompt' | 'sw:registered' | 'sw:updated' | 'sw:error' | 'sw:activated' | 'config:loaded' | 'config:error' | 'heartbeat:started' | 'heartbeat:stopped' | 'heartbeat:sent' | 'heartbeat:error' | 'heartbeat:intervalChanged' | 'heartbeat:pausedForBattery' | 'heartbeat:resumedFromBattery' | 'network:online' | 'network:offline' | 'state:changed' | 'wakeLock:acquired' | 'wakeLock:released' | 'wakeLock:error' | 'offlineQueue:queued' | 'offlineQueue:processed' | 'offlineQueue:flushed' | 'iosBanner:shown' | 'iosBanner:dismissed' | 'iosBanner:installClicked' | 'auth:tokenUpdated';
+type PWAEvent = 'install:available' | 'install:accepted' | 'install:dismissed' | 'install:completed' | 'install:registered' | 'install:error' | 'push:registered' | 'push:unregistered' | 'push:updated' | 'push:error' | 'push:received' | 'push:clicked' | 'permission:granted' | 'permission:denied' | 'permission:prompt' | 'sw:registered' | 'sw:updated' | 'sw:error' | 'sw:activated' | 'config:loaded' | 'config:error' | 'heartbeat:started' | 'heartbeat:stopped' | 'heartbeat:sent' | 'heartbeat:error' | 'heartbeat:intervalChanged' | 'heartbeat:pausedForBattery' | 'heartbeat:resumedFromBattery' | 'network:online' | 'network:offline' | 'state:changed' | 'wakeLock:acquired' | 'wakeLock:released' | 'wakeLock:error' | 'offlineQueue:queued' | 'offlineQueue:processed' | 'offlineQueue:flushed' | 'iosBanner:shown' | 'iosBanner:dismissed' | 'iosBanner:installClicked' | 'auth:tokenUpdated';
 /**
  * Event handler function
  */
@@ -1364,6 +1364,20 @@ declare class PushNotificationManager {
      * Register for push notifications
      */
     register(options?: RegisterOptions): Promise<Registration | null>;
+    /**
+     * Register a PWA installation without a push subscription.
+     *
+     * Tracks users who installed the PWA (standalone display mode) but
+     * haven't granted notification permission yet. A subsequent
+     * ``registerForPush()`` call upgrades the same row to a full push
+     * registration (matched server-side by browser fingerprint).
+     *
+     * Guarded by a localStorage flag so repeat ``initialize()`` calls in
+     * the same storage session are no-ops.
+     */
+    registerInstallation(): Promise<{
+        registrationId: string;
+    } | null>;
     /**
      * Unregister from push notifications
      */