@firebase/messaging 0.12.26 → 0.13.0-20260526192810

package/dist/internal.d.ts

@@ -14,10 +14,18 @@ import { Unsubscribe } from '@firebase/util';
  * Deletes the registration token associated with this {@link Messaging} instance and unsubscribes
  * the {@link Messaging} instance from the push subscription.
  *
+ * If there is no legacy registration token but the client has FID-based registration metadata
+ * (from {@link register}), this deletes that registration on the server, clears local metadata, and
+ * invokes {@link onUnregistered} with the removed FID when successful.
+ *
  * @param messaging - The {@link Messaging} instance.
  *
  * @returns The promise resolves when the token has been successfully deleted.
  *
+ * @deprecated Use {@link onUnregistered} to observe when the client is no longer
+ * registered and update your backend accordingly, instead of explicitly deleting the
+ * registration token with this API.
+ *
  * @public
  */
 export declare function deleteToken(messaging: Messaging): Promise<boolean>;
@@ -67,6 +75,9 @@ export declare function getMessaging(app?: FirebaseApp): Messaging;
  *
  * @returns The promise resolves with an FCM registration token.
  *
+ * @deprecated Use {@link register} together with {@link onRegistered} for Firebase
+ * Installation ID-based messaging instead of retrieving an FCM registration token with this API.
+ *
  * @public
  */
 export declare function getToken(messaging: Messaging, options?: GetTokenOptions): Promise<string>;
@@ -215,6 +226,68 @@ export { Observer }
  * @public
  */
 export declare function onMessage(messaging: Messaging, nextOrObserver: NextFn<MessagePayload> | Observer<MessagePayload>): Unsubscribe;
+
+/**
+ * Subscribes to an event that the app instance is registered with FCM via Firebase Installation ID (FID).
+ * Use the FID passed to the callback to upload it to your application server. When you receive an FID
+ * after calling {@link register}, instruct your backend to remove any legacy token for this instance.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param nextOrObserver - A function or observer object called when an FID is registered.
+ * @returns Unsubscribe function to stop listening.
+ *
+ * @public
+ */
+export declare function onRegistered(messaging: Messaging, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;
+
+/**
+ * Subscribes to an event that the app instance is unregistered from FCM (FID no longer active).
+ * Use this to notify your backend to remove this FID to prevent 404 errors on send.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param nextOrObserver - A function or observer object called with the unregistered FID.
+ * @returns Unsubscribe function to stop listening.
+ *
+ * @public
+ */
+export declare function onUnregistered(messaging: Messaging, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;
+
+/**
+ * Registers the app instance with FCM using its Firebase Installation ID (FID). The FID is
+ * delivered via the {@link onRegistered} callback, not as a return value. Call this to establish
+ * an FID-based identity; once {@link onRegistered} provides an FID, instruct your backend to
+ * remove any legacy token previously associated with this instance. The backend send API
+ * supports FID as a target.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param options - Optional. VAPID key and/or service worker registration (same as getToken).
+ * @returns Promise that resolves when registration has been initiated; FID is delivered via onRegistered.
+ *
+ * @public
+ */
+export declare function register(messaging: Messaging, options?: RegisterOptions): Promise<void>;
+
+/**
+ * Options for {@link register}. Same shape as GetTokenOptions for SW and VAPID configuration.
+ *
+ * @public
+ */
+export declare interface RegisterOptions {
+    /** Optional VAPID key. See {@link GetTokenOptions.vapidKey}. */
+    vapidKey?: string;
+    /** Optional service worker registration. See {@link GetTokenOptions.serviceWorkerRegistration}. */
+    serviceWorkerRegistration?: ServiceWorkerRegistration;
+}
+
+/**
+ * Unregisters the app instance from FCM by deleting its FID-based registration.
+ * On success, triggers {@link onUnregistered} (if registered) with the unregistered FID.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ *
+ * @public
+ */
+export declare function unregister(messaging: Messaging): Promise<void>;
 export { Unsubscribe }
 
 export { }

package/dist/private.d.ts

@@ -14,10 +14,18 @@ import { Unsubscribe } from '@firebase/util';
  * Deletes the registration token associated with this {@link Messaging} instance and unsubscribes
  * the {@link Messaging} instance from the push subscription.
  *
+ * If there is no legacy registration token but the client has FID-based registration metadata
+ * (from {@link register}), this deletes that registration on the server, clears local metadata, and
+ * invokes {@link onUnregistered} with the removed FID when successful.
+ *
  * @param messaging - The {@link Messaging} instance.
  *
  * @returns The promise resolves when the token has been successfully deleted.
  *
+ * @deprecated Use {@link onUnregistered} to observe when the client is no longer
+ * registered and update your backend accordingly, instead of explicitly deleting the
+ * registration token with this API.
+ *
  * @public
  */
 export declare function deleteToken(messaging: Messaging): Promise<boolean>;
@@ -64,6 +72,9 @@ export declare function getMessaging(app?: FirebaseApp): Messaging;
  *
  * @returns The promise resolves with an FCM registration token.
  *
+ * @deprecated Use {@link register} together with {@link onRegistered} for Firebase
+ * Installation ID-based messaging instead of retrieving an FCM registration token with this API.
+ *
  * @public
  */
 export declare function getToken(messaging: Messaging, options?: GetTokenOptions): Promise<string>;
@@ -212,6 +223,68 @@ export { Observer }
  * @public
  */
 export declare function onMessage(messaging: Messaging, nextOrObserver: NextFn<MessagePayload> | Observer<MessagePayload>): Unsubscribe;
+
+/**
+ * Subscribes to an event that the app instance is registered with FCM via Firebase Installation ID (FID).
+ * Use the FID passed to the callback to upload it to your application server. When you receive an FID
+ * after calling {@link register}, instruct your backend to remove any legacy token for this instance.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param nextOrObserver - A function or observer object called when an FID is registered.
+ * @returns Unsubscribe function to stop listening.
+ *
+ * @public
+ */
+export declare function onRegistered(messaging: Messaging, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;
+
+/**
+ * Subscribes to an event that the app instance is unregistered from FCM (FID no longer active).
+ * Use this to notify your backend to remove this FID to prevent 404 errors on send.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param nextOrObserver - A function or observer object called with the unregistered FID.
+ * @returns Unsubscribe function to stop listening.
+ *
+ * @public
+ */
+export declare function onUnregistered(messaging: Messaging, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;
+
+/**
+ * Registers the app instance with FCM using its Firebase Installation ID (FID). The FID is
+ * delivered via the {@link onRegistered} callback, not as a return value. Call this to establish
+ * an FID-based identity; once {@link onRegistered} provides an FID, instruct your backend to
+ * remove any legacy token previously associated with this instance. The backend send API
+ * supports FID as a target.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param options - Optional. VAPID key and/or service worker registration (same as getToken).
+ * @returns Promise that resolves when registration has been initiated; FID is delivered via onRegistered.
+ *
+ * @public
+ */
+export declare function register(messaging: Messaging, options?: RegisterOptions): Promise<void>;
+
+/**
+ * Options for {@link register}. Same shape as GetTokenOptions for SW and VAPID configuration.
+ *
+ * @public
+ */
+export declare interface RegisterOptions {
+    /** Optional VAPID key. See {@link GetTokenOptions.vapidKey}. */
+    vapidKey?: string;
+    /** Optional service worker registration. See {@link GetTokenOptions.serviceWorkerRegistration}. */
+    serviceWorkerRegistration?: ServiceWorkerRegistration;
+}
+
+/**
+ * Unregisters the app instance from FCM by deleting its FID-based registration.
+ * On success, triggers {@link onUnregistered} (if registered) with the unregistered FID.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ *
+ * @public
+ */
+export declare function unregister(messaging: Messaging): Promise<void>;
 export { Unsubscribe }
 
 export { }

package/dist/src/api/onRegistered.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { NextFn, Observer, Unsubscribe } from '../interfaces/public-types';
+import { MessagingService } from '../messaging-service';
+/**
+ * Subscribes to an event that the app instance is registered with FCM via Firebase Installation ID (FID).
+ * Use the FID passed to the callback to upload it to your application server.
+ *
+ * @param messaging - The {@link MessagingService} instance.
+ * @param nextOrObserver - A function or observer object called when an FID is registered.
+ * @returns Unsubscribe function to stop listening.
+ */
+export declare function onRegistered(messaging: MessagingService, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;

package/dist/src/api/onUnregistered.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { NextFn, Observer, Unsubscribe } from '../interfaces/public-types';
+import { MessagingService } from '../messaging-service';
+/**
+ * Subscribes to an event that the app instance is unregistered from FCM so the FID is no longer active.
+ * Use this to notify your backend to remove this FID to prevent 404 errors on send.
+ *
+ * @param messaging - The {@link MessagingService} instance.
+ * @param nextOrObserver - A function or observer object called with the unregistered FID.
+ * @returns Unsubscribe function to stop listening.
+ */
+export declare function onUnregistered(messaging: MessagingService, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;

package/dist/src/api/register.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { MessagingService } from '../messaging-service';
+import { RegisterOptions } from '../interfaces/public-types';
+/**
+ * Registers the app instance with FCM using its Firebase Installation ID (FID). The FID is
+ * delivered via the `onRegistered` callback. Call this to establish an FID-based identity.
+ * Once `onRegistered` provides an FID, instruct your backend to remove any legacy token
+ * previously associated with this instance. The backend send API supports FID as a target.
+ *
+ * When called multiple times, `onRegistered` is invoked on each call with the current FID.
+ * Backend registration sync runs on first register, when the FID changes, or on weekly refresh.
+ *
+ * @param messaging - The MessagingService instance.
+ * @param options - Optional. Same options as getToken (vapidKey, serviceWorkerRegistration).
+ */
+export declare function register(messaging: MessagingService, options?: RegisterOptions): Promise<void>;

package/dist/src/api/unregister.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { MessagingService } from '../messaging-service';
+/**
+ * Unregisters the app instance from FCM by deleting its FID-based registration.
+ *
+ * On success, triggers the `onUnregistered` callback (if set) with the unregistered FID.
+ *
+ * @param messaging - The MessagingService instance.
+ */
+export declare function unregister(messaging: MessagingService): Promise<void>;

package/dist/src/api.d.ts

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 import { FirebaseApp } from '@firebase/app';
-import { GetTokenOptions, MessagePayload, Messaging } from './interfaces/public-types';
+import { GetTokenOptions, MessagePayload, Messaging, RegisterOptions } from './interfaces/public-types';
 import { NextFn, Observer, Unsubscribe } from '@firebase/util';
 /**
  * Retrieves a Firebase Cloud Messaging instance.
@@ -46,6 +46,9 @@ export declare function getMessagingInSw(app?: FirebaseApp): Messaging;
  *
  * @returns The promise resolves with an FCM registration token.
  *
+ * @deprecated Use {@link register} together with {@link onRegistered} for Firebase
+ * Installation ID-based messaging instead of retrieving an FCM registration token with this API.
+ *
  * @public
  */
 export declare function getToken(messaging: Messaging, options?: GetTokenOptions): Promise<string>;
@@ -53,10 +56,18 @@ export declare function getToken(messaging: Messaging, options?: GetTokenOptions
  * Deletes the registration token associated with this {@link Messaging} instance and unsubscribes
  * the {@link Messaging} instance from the push subscription.
  *
+ * If there is no legacy registration token but the client has FID-based registration metadata
+ * (from {@link register}), this deletes that registration on the server, clears local metadata, and
+ * invokes {@link onUnregistered} with the removed FID when successful.
+ *
  * @param messaging - The {@link Messaging} instance.
  *
  * @returns The promise resolves when the token has been successfully deleted.
  *
+ * @deprecated Use {@link onUnregistered} to observe when the client is no longer
+ * registered and update your backend accordingly, instead of explicitly deleting the
+ * registration token with this API.
+ *
  * @public
  */
 export declare function deleteToken(messaging: Messaging): Promise<boolean>;
@@ -82,11 +93,57 @@ export declare function onMessage(messaging: Messaging, nextOrObserver: NextFn<M
  * @param nextOrObserver - This function, or observer object with `next` defined, is called when a
  * message is received and the app is currently in the background.
  *
- * @returns To stop listening for messages execute this returned function
+ * @returns To stop listening for messages execute this returned function.
  *
  * @public
  */
 export declare function onBackgroundMessage(messaging: Messaging, nextOrObserver: NextFn<MessagePayload> | Observer<MessagePayload>): Unsubscribe;
+/**
+ * Registers the app instance with FCM using its Firebase Installation ID (FID). The FID is
+ * delivered via the {@link onRegistered} callback, not as a return value. Call this to establish
+ * an FID-based identity; once {@link onRegistered} provides an FID, instruct your backend to
+ * remove any legacy token previously associated with this instance. The backend send API
+ * supports FID as a target.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param options - Optional. VAPID key and/or service worker registration (same as getToken).
+ * @returns Promise that resolves when registration has been initiated; FID is delivered via onRegistered.
+ *
+ * @public
+ */
+export declare function register(messaging: Messaging, options?: RegisterOptions): Promise<void>;
+/**
+ * Unregisters the app instance from FCM by deleting its FID-based registration.
+ * On success, triggers {@link onUnregistered} (if registered) with the unregistered FID.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ *
+ * @public
+ */
+export declare function unregister(messaging: Messaging): Promise<void>;
+/**
+ * Subscribes to an event that the app instance is registered with FCM via Firebase Installation ID (FID).
+ * Use the FID passed to the callback to upload it to your application server. When you receive an FID
+ * after calling {@link register}, instruct your backend to remove any legacy token for this instance.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param nextOrObserver - A function or observer object called when an FID is registered.
+ * @returns Unsubscribe function to stop listening.
+ *
+ * @public
+ */
+export declare function onRegistered(messaging: Messaging, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;
+/**
+ * Subscribes to an event that the app instance is unregistered from FCM (FID no longer active).
+ * Use this to notify your backend to remove this FID to prevent 404 errors on send.
+ *
+ * @param messaging - The {@link Messaging} instance.
+ * @param nextOrObserver - A function or observer object called with the unregistered FID.
+ * @returns Unsubscribe function to stop listening.
+ *
+ * @public
+ */
+export declare function onUnregistered(messaging: Messaging, nextOrObserver: NextFn<string> | Observer<string>): Unsubscribe;
 /**
  * Enables or disables Firebase Cloud Messaging message delivery metrics export to BigQuery. By
  * default, message delivery metrics are not exported to BigQuery. Use this method to enable or

package/dist/src/helpers/fid-change-registration.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { IdChangeUnsubscribeFn, Installations } from '@firebase/installations';
+import { MessagingService } from '../messaging-service';
+/**
+ * Re-runs FCM FID registration when push subscription keys change (e.g. `pushsubscriptionchange`
+ * in the service worker). No-op if the app instance was never registered via `register()`.
+ * Best-effort: callers should catch failures when permission or push may be unavailable.
+ */
+export declare function refreshFidRegistrationIfStored(messaging: MessagingService): Promise<string | undefined>;
+/**
+ * When the Firebase Installation ID changes, re-run `register()` so FCM registration and
+ * onRegistered run for the new FID. No-op if no onRegistered handler is set or the app
+ * instance was never registered with FCM.
+ */
+export declare function subscribeFidChangeRegistration(messaging: MessagingService, installations: Installations): IdChangeUnsubscribeFn;

package/dist/src/helpers/logToFirelog.d.ts

@@ -18,6 +18,8 @@ import { LogEvent, LogRequest } from '../interfaces/logging-types';
 import { MessagePayloadInternal } from '../interfaces/internal-message-payload';
 import { MessagingService } from '../messaging-service';
 export declare function startLoggingService(messaging: MessagingService): void;
+/** Clears queued Firelog events, cancels any pending flush timer, and stops the logging loop. */
+export declare function stopLoggingServiceAndClearQueue(messaging: MessagingService): void;
 /**
  *
  * @param messaging the messaging instance.

package/dist/src/helpers/migrate-old-database.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { TokenDetails } from '../interfaces/token-details';
+import { TokenDetails } from '../interfaces/registration-details';
 export interface V2TokenDetails {
     fcmToken: string;
     swScope: string;

package/dist/src/index.d.ts

@@ -22,7 +22,7 @@
  */
 import '@firebase/installations';
 import { Messaging } from './interfaces/public-types';
-export { getToken, deleteToken, onMessage, getMessagingInWindow as getMessaging } from './api';
+export { getToken, deleteToken, register, unregister, onMessage, onRegistered, onUnregistered, getMessagingInWindow as getMessaging } from './api';
 export { isWindowSupported as isSupported } from './api/isSupported';
 export * from './interfaces/public-types';
 declare module '@firebase/component' {

package/dist/src/index.sw.d.ts

@@ -17,7 +17,7 @@
 import '@firebase/installations';
 import { Messaging } from './interfaces/public-types';
 export * from './interfaces/public-types';
-export { onBackgroundMessage, getMessagingInSw as getMessaging, experimentalSetDeliveryMetricsExportedToBigQueryEnabled } from './api';
+export { onBackgroundMessage, onRegistered, onUnregistered, getMessagingInSw as getMessaging, experimentalSetDeliveryMetricsExportedToBigQueryEnabled } from './api';
 export { isSwSupported as isSupported } from './api/isSupported';
 declare module '@firebase/component' {
     interface NameServiceMapping {

package/dist/src/interfaces/internal-message-payload.d.ts

@@ -53,7 +53,8 @@ export interface FcmOptionsInternal {
 }
 export declare enum MessageType {
     PUSH_RECEIVED = "push-received",
-    NOTIFICATION_CLICKED = "notification-clicked"
+    NOTIFICATION_CLICKED = "notification-clicked",
+    FID_REGISTERED = "fid-registered"
 }
 /** Additional data of a message sent from the FN Console. */
 export interface ConsoleMessageData {
@@ -62,4 +63,9 @@ export interface ConsoleMessageData {
     [CONSOLE_CAMPAIGN_NAME]?: string;
     [CONSOLE_CAMPAIGN_ANALYTICS_ENABLED]?: '1';
 }
+export interface FidRegisteredPayload {
+    isFirebaseMessaging: boolean;
+    messageType: MessageType.FID_REGISTERED;
+    fid: string;
+}
 export {};

package/dist/src/interfaces/public-types.d.ts

@@ -121,6 +121,17 @@ export interface GetTokenOptions {
      */
     serviceWorkerRegistration?: ServiceWorkerRegistration;
 }
+/**
+ * Options for {@link register}. Same shape as GetTokenOptions for SW and VAPID configuration.
+ *
+ * @public
+ */
+export interface RegisterOptions {
+    /** Optional VAPID key. See {@link GetTokenOptions.vapidKey}. */
+    vapidKey?: string;
+    /** Optional service worker registration. See {@link GetTokenOptions.serviceWorkerRegistration}. */
+    serviceWorkerRegistration?: ServiceWorkerRegistration;
+}
 /**
  * Public interface of the Firebase Cloud Messaging SDK.
  *

package/dist/src/internals/idb-manager.d.ts

@@ -14,14 +14,27 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { deleteDB, openDB } from 'idb';
 import { FirebaseInternalDependencies } from '../interfaces/internal-dependencies';
-import { TokenDetails } from '../interfaces/token-details';
+import { TokenDetails } from '../interfaces/registration-details';
 export declare const DATABASE_NAME = "firebase-messaging-database";
-/** Gets record(s) from the objectStore that match the given key. */
+export interface FidRegistrationDetails {
+    fid: string;
+    lastRegisterTime: number;
+    vapidKey?: string;
+}
+interface IdbImpl {
+    openDB: typeof openDB;
+    deleteDB: typeof deleteDB;
+}
+export declare function _setIdbForTests(impl: IdbImpl): void;
+export declare function _resetIdbForTests(): void;
 export declare function dbGet(firebaseDependencies: FirebaseInternalDependencies): Promise<TokenDetails | undefined>;
-/** Assigns or overwrites the record for the given key with the given value. */
 export declare function dbSet(firebaseDependencies: FirebaseInternalDependencies, tokenDetails: TokenDetails): Promise<TokenDetails>;
-/** Removes record(s) from the objectStore that match the given key. */
 export declare function dbRemove(firebaseDependencies: FirebaseInternalDependencies): Promise<void>;
+export declare function dbGetFidRegistration(firebaseDependencies: FirebaseInternalDependencies): Promise<FidRegistrationDetails | undefined>;
+export declare function dbSetFidRegistration(firebaseDependencies: FirebaseInternalDependencies, details: FidRegistrationDetails): Promise<FidRegistrationDetails>;
+export declare function dbRemoveFidRegistration(firebaseDependencies: FirebaseInternalDependencies): Promise<void>;
 /** Deletes the DB. Useful for tests. */
 export declare function dbDelete(): Promise<void>;
+export {};

package/dist/src/internals/register-fid.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { MessagingService } from '../messaging-service';
+/**
+ * For the new FID-based register path:
+ * - Create (or refresh) an FCM Web registration in the backend via CreateRegistration.
+ * - Use the FIS auth token produced by the installations instance (implicitly associated with FID).
+ * - CreateRegistration must echo the installation in `name` (e.g.
+ *   `projects/{projectId}/registrations/{fid}`); it must match `expectedFid` from
+ *   Installations.getId(). On mismatch we refresh the auth token and retry, then fail with
+ *   `fid-registration-failed`.
+ */
+export declare function registerFcmRegistrationWithFid(messaging: MessagingService, expectedFid: string): Promise<void>;

package/dist/src/internals/requests.d.ts

@@ -14,16 +14,30 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { SubscriptionOptions, TokenDetails } from '../interfaces/token-details';
+import { SubscriptionOptions, TokenDetails } from '../interfaces/registration-details';
 import { FirebaseInternalDependencies } from '../interfaces/internal-dependencies';
+/** Max attempts (initial fetch + retries) when CreateRegistration `fetch()` throws. */
+export declare const FID_REGISTRATION_FETCH_MAX_ATTEMPTS = 3;
+/** Base delay in ms; backoff is `BASE * 2^attempt` after each failed attempt. */
+export declare const FID_REGISTRATION_FETCH_BASE_BACKOFF_MS = 1000;
 export interface ApiResponse {
     token?: string;
+    /**
+     * CreateRegistration resource name, e.g. `projects/{projectId}/registrations/{fid}`.
+     */
+    name?: string;
     error?: {
         message: string;
     };
 }
 export interface ApiRequestBody {
+    fcm_sdk_version?: string;
     web: {
+        /**
+         * Client identifier for the registration: the site host (e.g. `www.example.com`) when the
+         * service worker scope is a URL, otherwise the app name.
+         */
+        origin: string;
         endpoint: string;
         p256dh: string;
         auth: string;
@@ -31,5 +45,25 @@ export interface ApiRequestBody {
     };
 }
 export declare function requestGetToken(firebaseDependencies: FirebaseInternalDependencies, subscriptionOptions: SubscriptionOptions): Promise<string>;
+/**
+ * Creates (or refreshes) an FCM Web registration via CreateRegistration.
+ *
+ * This is used by the FID-based register path, where we don't require the returned FCM token, but
+ * we do require a non-empty `name` (echoing the Firebase Installation ID) in the success response body.
+ */
+export interface CreateRegistrationResult {
+    /** Firebase Installation ID parsed from the CreateRegistration response `name` field. */
+    responseFid: string;
+}
+export declare function requestCreateRegistration(firebaseDependencies: FirebaseInternalDependencies, subscriptionOptions: SubscriptionOptions): Promise<CreateRegistrationResult>;
+/**
+ * Deletes an FCM Web registration via DeleteRegistration using the Firebase Installation ID (FID).
+ */
+export declare function requestDeleteRegistration(firebaseDependencies: FirebaseInternalDependencies, fid: string): Promise<void>;
 export declare function requestUpdateToken(firebaseDependencies: FirebaseInternalDependencies, tokenDetails: TokenDetails): Promise<string>;
 export declare function requestDeleteToken(firebaseDependencies: FirebaseInternalDependencies, token: string): Promise<void>;
+/**
+ * Hostname for the registering web client (e.g. `www.example.com`), or the app name
+ * (`appNameFallback`) when the scope cannot be resolved (e.g. some test environments).
+ */
+export declare function getRegistrationOrigin(swScope: string, appNameFallback: string): string;

package/dist/src/internals/token-manager.d.ts

@@ -17,7 +17,10 @@
 import { MessagingService } from '../messaging-service';
 export declare function getTokenInternal(messaging: MessagingService): Promise<string>;
 /**
- * This method deletes the token from the database, unsubscribes the token from FCM, and unregisters
- * the push subscription if it exists.
+ * Revokes the app's FCM registration: legacy token (getToken/deleteToken) and/or FID-based
+ * registration (register/unregister), clears local caches, notifies onUnregistered when a stored
+ * FID existed, then unsubscribes the push subscription when present.
  */
-export declare function deleteTokenInternal(messaging: MessagingService): Promise<boolean>;
+export declare function revokeRegistrationInternal(messaging: MessagingService): Promise<boolean>;
+export declare function notifyOnRegistered(messaging: MessagingService, fid: string): void;
+export declare function notifyOnUnregistered(messaging: MessagingService, fid: string): void;