@cloudsignal/pwa-sdk 2.0.0 → 2.1.0

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/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;
@@ -1473,6 +1482,64 @@ 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) {
+        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 +3325,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,