@spacelr/sdk 0.5.1 → 0.6.0

package/dist/index.d.mts

@@ -1285,9 +1285,15 @@ declare class DatabaseModule {
     collection<T = Record<string, unknown>>(name: string): CollectionRef<T>;
 }
 
+/**
+ * Push subscription platform. `web` = VAPID WebPush; `android`/`ios` = native
+ * device tokens; `web-fcm` = a web Firebase Cloud Messaging registration token.
+ * Defined locally so `@spacelr/sdk` stays a standalone, dependency-free package.
+ */
+type PushPlatform = 'web' | 'android' | 'ios' | 'web-fcm';
 interface PushSubscriptionInfo {
     id: string;
-    platform: 'web' | 'android' | 'ios';
+    platform: PushPlatform;
     endpoint?: string;
     deviceToken?: string;
     deviceId?: string;
@@ -1318,9 +1324,9 @@ declare class NotificationsModule {
     private detectDeviceName;
     /** Get the VAPID public key for Web Push setup */
     getVapidPublicKey(): Promise<VapidKeyResponse>;
-    /** Register a push subscription (web, android, or ios) */
+    /** Register a push subscription (web, android, ios, or web-fcm) */
     subscribe(subscription: {
-        platform: 'web' | 'android' | 'ios';
+        platform: PushPlatform;
         endpoint?: string;
         keys?: {
             p256dh: string;
@@ -1329,7 +1335,16 @@ declare class NotificationsModule {
         deviceToken?: string;
     }, deviceName?: string): Promise<PushSubscriptionInfo>;
     /** Unregister a push subscription */
-    unsubscribe(platform: 'web' | 'android' | 'ios', identifier: string): Promise<{
+    unsubscribe(platform: PushPlatform, identifier: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Unregister a push subscription by its `id` (as returned by
+     * {@link getSubscriptions}). Robust regardless of platform — use this to
+     * remove a listed device (e.g. web-fcm rows whose raw token is not returned
+     * by the listing and so cannot be passed to {@link unsubscribe}).
+     */
+    unsubscribeById(subscriptionId: string): Promise<{
         deleted: boolean;
     }>;
     /** Get all subscriptions for the current user */
@@ -1344,6 +1359,12 @@ declare class NotificationsModule {
      * Helper: Register a mobile device push token (FCM or APNs).
      */
     registerDevicePush(deviceToken: string, platform: 'android' | 'ios', deviceName?: string): Promise<PushSubscriptionInfo>;
+    /**
+     * Registers a web Firebase Cloud Messaging registration token (obtained via
+     * the Firebase JS SDK `getToken()`), so `notifications.send` delivers to this
+     * browser through the project's FCM provider instead of VAPID WebPush.
+     */
+    registerWebFcm(fcmToken: string, deviceName?: string): Promise<PushSubscriptionInfo>;
     private urlBase64ToUint8Array;
 }
 

package/dist/index.d.ts

@@ -1285,9 +1285,15 @@ declare class DatabaseModule {
     collection<T = Record<string, unknown>>(name: string): CollectionRef<T>;
 }
 
+/**
+ * Push subscription platform. `web` = VAPID WebPush; `android`/`ios` = native
+ * device tokens; `web-fcm` = a web Firebase Cloud Messaging registration token.
+ * Defined locally so `@spacelr/sdk` stays a standalone, dependency-free package.
+ */
+type PushPlatform = 'web' | 'android' | 'ios' | 'web-fcm';
 interface PushSubscriptionInfo {
     id: string;
-    platform: 'web' | 'android' | 'ios';
+    platform: PushPlatform;
     endpoint?: string;
     deviceToken?: string;
     deviceId?: string;
@@ -1318,9 +1324,9 @@ declare class NotificationsModule {
     private detectDeviceName;
     /** Get the VAPID public key for Web Push setup */
     getVapidPublicKey(): Promise<VapidKeyResponse>;
-    /** Register a push subscription (web, android, or ios) */
+    /** Register a push subscription (web, android, ios, or web-fcm) */
     subscribe(subscription: {
-        platform: 'web' | 'android' | 'ios';
+        platform: PushPlatform;
         endpoint?: string;
         keys?: {
             p256dh: string;
@@ -1329,7 +1335,16 @@ declare class NotificationsModule {
         deviceToken?: string;
     }, deviceName?: string): Promise<PushSubscriptionInfo>;
     /** Unregister a push subscription */
-    unsubscribe(platform: 'web' | 'android' | 'ios', identifier: string): Promise<{
+    unsubscribe(platform: PushPlatform, identifier: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Unregister a push subscription by its `id` (as returned by
+     * {@link getSubscriptions}). Robust regardless of platform — use this to
+     * remove a listed device (e.g. web-fcm rows whose raw token is not returned
+     * by the listing and so cannot be passed to {@link unsubscribe}).
+     */
+    unsubscribeById(subscriptionId: string): Promise<{
         deleted: boolean;
     }>;
     /** Get all subscriptions for the current user */
@@ -1344,6 +1359,12 @@ declare class NotificationsModule {
      * Helper: Register a mobile device push token (FCM or APNs).
      */
     registerDevicePush(deviceToken: string, platform: 'android' | 'ios', deviceName?: string): Promise<PushSubscriptionInfo>;
+    /**
+     * Registers a web Firebase Cloud Messaging registration token (obtained via
+     * the Firebase JS SDK `getToken()`), so `notifications.send` delivers to this
+     * browser through the project's FCM provider instead of VAPID WebPush.
+     */
+    registerWebFcm(fcmToken: string, deviceName?: string): Promise<PushSubscriptionInfo>;
     private urlBase64ToUint8Array;
 }
 

package/dist/index.js

@@ -2747,7 +2747,7 @@ var NotificationsModule = class {
       authenticated: true
     });
   }
-  /** Register a push subscription (web, android, or ios) */
+  /** Register a push subscription (web, android, ios, or web-fcm) */
   async subscribe(subscription, deviceName) {
     return this.http.request({
       method: "POST",
@@ -2775,6 +2775,19 @@ var NotificationsModule = class {
       authenticated: true
     });
   }
+  /**
+   * Unregister a push subscription by its `id` (as returned by
+   * {@link getSubscriptions}). Robust regardless of platform — use this to
+   * remove a listed device (e.g. web-fcm rows whose raw token is not returned
+   * by the listing and so cannot be passed to {@link unsubscribe}).
+   */
+  async unsubscribeById(subscriptionId) {
+    return this.http.request({
+      method: "DELETE",
+      path: `/notifications/subscriptions/${encodeURIComponent(subscriptionId)}`,
+      authenticated: true
+    });
+  }
   /** Get all subscriptions for the current user */
   async getSubscriptions() {
     return this.http.request({
@@ -2833,6 +2846,25 @@ var NotificationsModule = class {
       deviceName
     );
   }
+  /**
+   * Registers a web Firebase Cloud Messaging registration token (obtained via
+   * the Firebase JS SDK `getToken()`), so `notifications.send` delivers to this
+   * browser through the project's FCM provider instead of VAPID WebPush.
+   */
+  async registerWebFcm(fcmToken, deviceName) {
+    if (/^https?:\/\//i.test(fcmToken)) {
+      console.warn(
+        "[spacelr] registerWebFcm received what looks like a Web Push endpoint URL, not a Firebase FCM registration token. A web-fcm token must come from getToken(getMessaging(app), { vapidKey, serviceWorkerRegistration }). For plain (non-FCM) Web Push, use registerBrowserPush instead."
+      );
+    }
+    return this.subscribe(
+      {
+        platform: "web-fcm",
+        deviceToken: fcmToken
+      },
+      deviceName
+    );
+  }
   urlBase64ToUint8Array(base64String) {
     const padding = "=".repeat((4 - base64String.length % 4) % 4);
     const base64 = (base64String + padding).replace(/-/g, "+").replace(/_/g, "/");