@ng-native/firebase-messaging 0.0.0-stage → 0.19.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ashley Hunter
+
+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/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @ng-native/firebase-messaging
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The app's Firebase Installation ID (FID), registered with Firebase Cloud Messaging, for a backend
+that sends push notifications through FCM's HTTP v1 API with the `fid` target.
+
+Alpha: APIs may change before 1.0.
+
+## Install
+
+```sh
+npx expo install @ng-native/firebase-messaging expo-notifications
+```
+
+Add `"@ng-native/firebase-messaging"` to the plugins in `app.json`, with Expo's
+`ios.googleServicesFile` and `android.googleServicesFile`, then rebuild the app: it needs a
+development build, not Expo Go.
+
+## Example
+
+```ts
+import { Service, effect, inject } from '@angular/core';
+import { FirebaseMessaging } from '@ng-native/firebase-messaging';
+
+@Service()
+export class Push {
+  private readonly messaging = inject(FirebaseMessaging);
+
+  constructor() {
+    effect(() => {
+      const fid = this.messaging.installationId();
+      if (fid) void sendToBackend(fid);
+    });
+  }
+
+  enable(): Promise<string | null> {
+    return this.messaging.register();
+  }
+}
+```
+
+The documentation is at
+[ng-native.com/packages/firebase-messaging](https://ng-native.com/packages/firebase-messaging).

package/android/build.gradle

@@ -0,0 +1,20 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'dev.ngnative.firebasemessaging'
+version = '1.0.0'
+
+android {
+  namespace "dev.ngnative.firebasemessaging"
+  defaultConfig {
+    versionCode 1
+    versionName '1.0.0'
+  }
+}
+
+dependencies {
+  // The version the reporter's FID registration was built on; FirebaseInstallations comes with it.
+  implementation 'com.google.firebase:firebase-messaging:25.1.2'
+}

package/android/src/main/java/dev/ngnative/firebasemessaging/FirebaseMessagingModule.kt

@@ -0,0 +1,34 @@
+package dev.ngnative.firebasemessaging
+
+import com.google.android.gms.tasks.Task
+import com.google.firebase.installations.FirebaseInstallations
+import com.google.firebase.messaging.FirebaseMessaging
+import expo.modules.kotlin.Promise
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+/**
+ * The app's Firebase Installation ID (FID), and its registration with FCM, so a backend can send
+ * to it through FCM's HTTP v1 API with the message's `fid` target. Android has no APNs token, so
+ * `register` ignores its argument.
+ */
+class FirebaseMessagingModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("NgNativeFirebaseMessaging")
+
+    AsyncFunction("getInstallationId") { promise: Promise ->
+      settle(FirebaseInstallations.getInstance().id, promise)
+    }
+
+    AsyncFunction("register") { _: String?, promise: Promise ->
+      settle(FirebaseMessaging.getInstance().register(), promise)
+    }
+  }
+
+  private fun <T> settle(task: Task<T>, promise: Promise) {
+    task.addOnCompleteListener {
+      if (it.isSuccessful) promise.resolve(it.result)
+      else promise.reject("ERR_FIREBASE_MESSAGING", it.exception?.message, it.exception)
+    }
+  }
+}

package/app.plugin.cjs

@@ -0,0 +1,61 @@
+/**
+ * `"plugins": ["@ng-native/firebase-messaging"]` in app.json: turns on FCM registration by
+ * installation ID, which both platforms leave off (registering then fails with "API disabled"),
+ * and turns off Firebase's app delegate proxy on iOS, which would swizzle the push methods
+ * `expo-notifications` owns. The APNs token reaches FCM through `register()` instead.
+ *
+ * In the Podfile it gives `GoogleUtilities` modules, without which CocoaPods refuses to link
+ * Firebase's Swift pods as the static libraries an Expo app builds.
+ *
+ * Firebase's config files are Expo's own `ios.googleServicesFile` and `android.googleServicesFile`.
+ */
+const MANIFEST_FLAG = 'firebase_messaging_installation_id_enabled';
+
+function infoPlist(plist) {
+  plist.FirebaseMessagingInstallationIdEnabled = true;
+  plist.FirebaseAppDelegateProxyEnabled = false;
+  return plist;
+}
+
+const MODULAR = "pod 'GoogleUtilities', :modular_headers => true";
+
+function podfile(contents) {
+  if (/^[ \t]*pod ['"]GoogleUtilities['"]/m.test(contents)) return contents;
+  const expo = /^([ \t]*)use_expo_modules!.*$/m.exec(contents);
+  if (!expo) throw new Error('[angular-native] The Podfile has no use_expo_modules! to add to.');
+  const end = expo.index + expo[0].length;
+  return `${contents.slice(0, end)}\n${expo[1]}${MODULAR}${contents.slice(end)}`;
+}
+
+function androidManifest(manifest) {
+  const application = manifest.manifest.application?.[0];
+  if (!application) throw new Error('[angular-native] AndroidManifest.xml has no <application>.');
+  const items = (application['meta-data'] ??= []);
+  const found = items.find((item) => item.$['android:name'] === MANIFEST_FLAG);
+  if (found) found.$['android:value'] = 'true';
+  else items.push({ $: { 'android:name': MANIFEST_FLAG, 'android:value': 'true' } });
+  return manifest;
+}
+
+module.exports = function withFirebaseMessaging(config) {
+  const projectRoot = config._internal?.projectRoot ?? process.cwd();
+  const { withInfoPlist, withPodfile, withAndroidManifest } = require(
+    require.resolve('expo/config-plugins', { paths: [projectRoot] }),
+  );
+  const withPlist = withInfoPlist(config, (ios) => {
+    ios.modResults = infoPlist(ios.modResults);
+    return ios;
+  });
+  const withPods = withPodfile(withPlist, (pods) => {
+    pods.modResults.contents = podfile(pods.modResults.contents);
+    return pods;
+  });
+  return withAndroidManifest(withPods, (android) => {
+    android.modResults = androidManifest(android.modResults);
+    return android;
+  });
+};
+
+module.exports.infoPlist = infoPlist;
+module.exports.podfile = podfile;
+module.exports.androidManifest = androidManifest;

package/dist/firebase-messaging.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `FirebaseMessaging`: the app's Firebase Installation ID (FID), registered with FCM, for a backend
+ * that sends through FCM's HTTP v1 API to the message's `fid` target.
+ *
+ * ```ts
+ * import { FirebaseMessaging } from '@ng-native/firebase-messaging';
+ *
+ * private readonly messaging = inject(FirebaseMessaging);
+ *
+ * constructor() {
+ *   effect(() => {
+ *     const fid = this.messaging.installationId();
+ *     if (fid) void this.api.savePushTarget(fid);
+ *   });
+ * }
+ *
+ * enablePush(): Promise<string | null> {
+ *   return this.messaging.register();
+ * }
+ * ```
+ *
+ * FCM rejects a send to an FID with `UNREGISTERED` until `register()` has run. On iOS FCM delivers
+ * over APNs, so registering takes the APNs token `Notifications` reports; on Android it needs no
+ * token. Either way it asks for the notification permission first. When the platform rolls the
+ * push token, the installation is registered again, and `installationId` is set again. Firebase
+ * can also replace the FID by itself, so each time the app comes back to the front the FID is read
+ * again, and `installationId` follows it.
+ *
+ * Without the native module (Expo Go, the web host, a test that provides nothing) every call
+ * answers null.
+ */
+import { InjectionToken, type Signal } from '@angular/core';
+import * as i0 from "@angular/core";
+/** The native module's functions. A test provides a fake. */
+export interface NativeFirebaseMessaging {
+    getInstallationId(): Promise<string>;
+    /** Registers the installation with FCM. iOS needs the APNs token as hex; Android ignores it. */
+    register(apnsToken: string | null): Promise<void>;
+}
+export declare class FirebaseMessaging {
+    /** Null in a build without the package's native half. */
+    static readonly SOURCE: InjectionToken<NativeFirebaseMessaging | null>;
+    private readonly native;
+    private readonly notifications;
+    private readonly errors;
+    private readonly os;
+    private readonly id;
+    private registered;
+    /** Counts FID reads, so one that settles after a newer one does not overwrite it. */
+    private reads;
+    /** The FID, each time a registration answers; null until one has. For the app's backend. */
+    readonly installationId: Signal<string | null>;
+    constructor();
+    /**
+     * Registers this installation with FCM and answers its FID. Null without the notification
+     * permission or the native module.
+     */
+    register(): Promise<string | null>;
+    /** The FID, without registering it. Null without the native module. */
+    getInstallationId(): Promise<string | null>;
+    /** Firebase replaces an FID it can no longer use without saying so to JavaScript. */
+    private readAgain;
+    private registerWith;
+    private read;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FirebaseMessaging, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}

package/dist/firebase-messaging.js

@@ -0,0 +1,112 @@
+/**
+ * `FirebaseMessaging`: the app's Firebase Installation ID (FID), registered with FCM, for a backend
+ * that sends through FCM's HTTP v1 API to the message's `fid` target.
+ *
+ * ```ts
+ * import { FirebaseMessaging } from '@ng-native/firebase-messaging';
+ *
+ * private readonly messaging = inject(FirebaseMessaging);
+ *
+ * constructor() {
+ *   effect(() => {
+ *     const fid = this.messaging.installationId();
+ *     if (fid) void this.api.savePushTarget(fid);
+ *   });
+ * }
+ *
+ * enablePush(): Promise<string | null> {
+ *   return this.messaging.register();
+ * }
+ * ```
+ *
+ * FCM rejects a send to an FID with `UNREGISTERED` until `register()` has run. On iOS FCM delivers
+ * over APNs, so registering takes the APNs token `Notifications` reports; on Android it needs no
+ * token. Either way it asks for the notification permission first. When the platform rolls the
+ * push token, the installation is registered again, and `installationId` is set again. Firebase
+ * can also replace the FID by itself, so each time the app comes back to the front the FID is read
+ * again, and `installationId` follows it.
+ *
+ * Without the native module (Expo Go, the web host, a test that provides nothing) every call
+ * answers null.
+ */
+import { DestroyRef, ErrorHandler, InjectionToken, Service, effect, inject, signal, } from '@angular/core';
+import { OS } from '@ng-native/device';
+import { Permission } from '@ng-native/expo';
+import { Notifications } from '@ng-native/expo/notifications';
+import * as i0 from "@angular/core";
+export class FirebaseMessaging {
+    /** Null in a build without the package's native half. */
+    static SOURCE = new InjectionToken('angular-native.firebaseMessagingSource', {
+        factory: () => globalThis.expo?.modules?.NgNativeFirebaseMessaging ?? null,
+    });
+    native = inject(FirebaseMessaging.SOURCE);
+    notifications = inject(Notifications);
+    errors = inject(ErrorHandler);
+    os = inject(OS);
+    id = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "id" }] : /* istanbul ignore next */ []));
+    registered = false;
+    /** Counts FID reads, so one that settles after a newer one does not overwrite it. */
+    reads = 0;
+    /** The FID, each time a registration answers; null until one has. For the app's backend. */
+    installationId = this.id.asReadonly();
+    constructor() {
+        // A rolled APNs token is one FCM does not have, and pushes stop arriving until it does. A
+        // registration that fails goes to the ErrorHandler, since nothing awaits it.
+        effect(() => {
+            const token = this.notifications.devicePushToken();
+            if (!token || !this.registered)
+                return;
+            this.registerWith(this.os === 'ios' ? token.data : null).catch((failure) => this.errors.handleError(failure));
+        });
+        const stop = inject(Permission.FOREGROUND)?.(() => this.readAgain());
+        if (stop)
+            inject(DestroyRef).onDestroy(stop);
+    }
+    /**
+     * Registers this installation with FCM and answers its FID. Null without the notification
+     * permission or the native module.
+     */
+    async register() {
+        if (!this.native)
+            return null;
+        // Android needs no token, and asking for one would fetch FCM's deprecated registration token.
+        if (this.os !== 'ios') {
+            return (await this.notifications.permission.ensure()) ? this.registerWith(null) : null;
+        }
+        const token = await this.notifications.getDevicePushToken();
+        return token ? this.registerWith(token.data) : null;
+    }
+    /** The FID, without registering it. Null without the native module. */
+    async getInstallationId() {
+        return (await this.native?.getInstallationId()) ?? null;
+    }
+    /** Firebase replaces an FID it can no longer use without saying so to JavaScript. */
+    readAgain() {
+        const native = this.native;
+        if (!native || !this.registered)
+            return;
+        this.read(native).catch((failure) => this.errors.handleError(failure));
+    }
+    async registerWith(apnsToken) {
+        const native = this.native;
+        if (!native)
+            return null;
+        await native.register(apnsToken);
+        this.registered = true;
+        return this.read(native);
+    }
+    async read(native) {
+        const read = ++this.reads;
+        const id = await native.getInstallationId();
+        if (read === this.reads)
+            this.id.set(id);
+        return id;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: FirebaseMessaging, deps: [], target: i0.ɵɵFactoryTarget.Service });
+    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.0", ngImport: i0, type: FirebaseMessaging });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: FirebaseMessaging, decorators: [{
+            type: Service
+        }], ctorParameters: () => [] });
+//# sourceMappingURL=firebase-messaging.js.map

package/dist/firebase-messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-messaging.js","sourceRoot":"","sources":["../src/firebase-messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,OAAO,EACP,MAAM,EACN,MAAM,EACN,MAAM,GAEP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;;AAU9D,MAAM,OAAO,iBAAiB;IAC5B,yDAAyD;IACzD,MAAM,CAAU,MAAM,GAAG,IAAI,cAAc,CACzC,wCAAwC,EACxC;QACE,OAAO,EAAE,GAAG,EAAE,CAEV,UAGD,CAAC,IAAI,EAAE,OAAO,EAAE,yBAAyB,IAAI,IAAI;KACrD,CACF,CAAC;IAEe,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1C,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9B,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAChB,EAAE,GAAG,MAAM,CAAgB,IAAI;2EAAC,CAAC;IAC1C,UAAU,GAAG,KAAK,CAAC;IAC3B,qFAAqF;IAC7E,KAAK,GAAG,CAAC,CAAC;IAElB,4FAA4F;IACnF,cAAc,GAA0B,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAEtE;QACE,0FAA0F;QAC1F,6EAA6E;QAC7E,MAAM,CAAC,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU;gBAAE,OAAO;YACvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAgB,EAAE,EAAE,CAClF,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CACjC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACrE,IAAI,IAAI;YAAE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,8FAA8F;QAC9F,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,IAAI,IAAI,CAAC;IAC1D,CAAC;IAED,qFAAqF;IAC7E,SAAS;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,SAAwB;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAA+B;QAChD,MAAM,IAAI,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;uGA/EU,iBAAiB;wGAAjB,iBAAiB;;2FAAjB,iBAAiB;kBAD7B,OAAO","sourcesContent":["/**\n * `FirebaseMessaging`: the app's Firebase Installation ID (FID), registered with FCM, for a backend\n * that sends through FCM's HTTP v1 API to the message's `fid` target.\n *\n * ```ts\n * import { FirebaseMessaging } from '@ng-native/firebase-messaging';\n *\n * private readonly messaging = inject(FirebaseMessaging);\n *\n * constructor() {\n *   effect(() => {\n *     const fid = this.messaging.installationId();\n *     if (fid) void this.api.savePushTarget(fid);\n *   });\n * }\n *\n * enablePush(): Promise<string | null> {\n *   return this.messaging.register();\n * }\n * ```\n *\n * FCM rejects a send to an FID with `UNREGISTERED` until `register()` has run. On iOS FCM delivers\n * over APNs, so registering takes the APNs token `Notifications` reports; on Android it needs no\n * token. Either way it asks for the notification permission first. When the platform rolls the\n * push token, the installation is registered again, and `installationId` is set again. Firebase\n * can also replace the FID by itself, so each time the app comes back to the front the FID is read\n * again, and `installationId` follows it.\n *\n * Without the native module (Expo Go, the web host, a test that provides nothing) every call\n * answers null.\n */\nimport {\n  DestroyRef,\n  ErrorHandler,\n  InjectionToken,\n  Service,\n  effect,\n  inject,\n  signal,\n  type Signal,\n} from '@angular/core';\nimport { OS } from '@ng-native/device';\nimport { Permission } from '@ng-native/expo';\nimport { Notifications } from '@ng-native/expo/notifications';\n\n/** The native module's functions. A test provides a fake. */\nexport interface NativeFirebaseMessaging {\n  getInstallationId(): Promise<string>;\n  /** Registers the installation with FCM. iOS needs the APNs token as hex; Android ignores it. */\n  register(apnsToken: string | null): Promise<void>;\n}\n\n@Service()\nexport class FirebaseMessaging {\n  /** Null in a build without the package's native half. */\n  static readonly SOURCE = new InjectionToken<NativeFirebaseMessaging | null>(\n    'angular-native.firebaseMessagingSource',\n    {\n      factory: () =>\n        (\n          globalThis as {\n            expo?: { modules?: { NgNativeFirebaseMessaging?: NativeFirebaseMessaging } };\n          }\n        ).expo?.modules?.NgNativeFirebaseMessaging ?? null,\n    },\n  );\n\n  private readonly native = inject(FirebaseMessaging.SOURCE);\n  private readonly notifications = inject(Notifications);\n  private readonly errors = inject(ErrorHandler);\n  private readonly os = inject(OS);\n  private readonly id = signal<string | null>(null);\n  private registered = false;\n  /** Counts FID reads, so one that settles after a newer one does not overwrite it. */\n  private reads = 0;\n\n  /** The FID, each time a registration answers; null until one has. For the app's backend. */\n  readonly installationId: Signal<string | null> = this.id.asReadonly();\n\n  constructor() {\n    // A rolled APNs token is one FCM does not have, and pushes stop arriving until it does. A\n    // registration that fails goes to the ErrorHandler, since nothing awaits it.\n    effect(() => {\n      const token = this.notifications.devicePushToken();\n      if (!token || !this.registered) return;\n      this.registerWith(this.os === 'ios' ? token.data : null).catch((failure: unknown) =>\n        this.errors.handleError(failure),\n      );\n    });\n    const stop = inject(Permission.FOREGROUND)?.(() => this.readAgain());\n    if (stop) inject(DestroyRef).onDestroy(stop);\n  }\n\n  /**\n   * Registers this installation with FCM and answers its FID. Null without the notification\n   * permission or the native module.\n   */\n  async register(): Promise<string | null> {\n    if (!this.native) return null;\n    // Android needs no token, and asking for one would fetch FCM's deprecated registration token.\n    if (this.os !== 'ios') {\n      return (await this.notifications.permission.ensure()) ? this.registerWith(null) : null;\n    }\n    const token = await this.notifications.getDevicePushToken();\n    return token ? this.registerWith(token.data) : null;\n  }\n\n  /** The FID, without registering it. Null without the native module. */\n  async getInstallationId(): Promise<string | null> {\n    return (await this.native?.getInstallationId()) ?? null;\n  }\n\n  /** Firebase replaces an FID it can no longer use without saying so to JavaScript. */\n  private readAgain(): void {\n    const native = this.native;\n    if (!native || !this.registered) return;\n    this.read(native).catch((failure: unknown) => this.errors.handleError(failure));\n  }\n\n  private async registerWith(apnsToken: string | null): Promise<string | null> {\n    const native = this.native;\n    if (!native) return null;\n    await native.register(apnsToken);\n    this.registered = true;\n    return this.read(native);\n  }\n\n  private async read(native: NativeFirebaseMessaging): Promise<string> {\n    const read = ++this.reads;\n    const id = await native.getInstallationId();\n    if (read === this.reads) this.id.set(id);\n    return id;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { FirebaseMessaging, type NativeFirebaseMessaging } from './firebase-messaging.ts';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { FirebaseMessaging } from "./firebase-messaging.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgC,MAAM,yBAAyB,CAAC","sourcesContent":["export { FirebaseMessaging, type NativeFirebaseMessaging } from './firebase-messaging.ts';\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["FirebaseMessagingModule"]
+  },
+  "android": {
+    "modules": ["dev.ngnative.firebasemessaging.FirebaseMessagingModule"]
+  }
+}

package/ios/FirebaseMessagingModule.swift

@@ -0,0 +1,60 @@
+import ExpoModulesCore
+import FirebaseCore
+import FirebaseInstallations
+import FirebaseMessaging
+
+/**
+ * The app's Firebase Installation ID (FID), and its registration with FCM, so a backend can send
+ * to it through FCM's HTTP v1 API with the message's `fid` target.
+ *
+ * FCM delivers over APNs on iOS, so `register` takes the APNs token `expo-notifications` reported,
+ * as the lowercase hex it hands JavaScript. Firebase's app delegate proxy is off (the config
+ * plugin turns it off, since `expo-notifications` owns those methods), so this is the only way the
+ * token reaches FCM.
+ */
+public class FirebaseMessagingModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("NgNativeFirebaseMessaging")
+
+    AsyncFunction("getInstallationId") { () async throws -> String in
+      try await Self.configure()
+      return try await Installations.installations().installationID()
+    }
+
+    AsyncFunction("register") { (apnsToken: String?) async throws in
+      try await Self.configure()
+      guard let apnsToken, let token = Self.data(hex: apnsToken) else {
+        throw Exception(
+          name: "ERR_APNS_TOKEN",
+          description: "FCM needs the APNs token on iOS, and none was given.")
+      }
+      await MainActor.run { Messaging.messaging().apnsToken = token }
+      try await Messaging.messaging().register()
+    }
+  }
+
+  /** Configures Firebase on first use unless the app has; without the plist, configure() aborts. */
+  @MainActor
+  private static func configure() throws {
+    if FirebaseApp.app() != nil { return }
+    guard Bundle.main.path(forResource: "GoogleService-Info", ofType: "plist") != nil else {
+      throw Exception(
+        name: "ERR_NO_FIREBASE_CONFIG",
+        description: "GoogleService-Info.plist is not in the app. "
+          + "Set ios.googleServicesFile in app.json and rebuild.")
+    }
+    FirebaseApp.configure()
+  }
+
+  private static func data(hex: String) -> Data? {
+    let bytes = Array(hex.utf8)
+    guard bytes.count % 2 == 0 else { return nil }
+    var data = Data(capacity: bytes.count / 2)
+    for index in stride(from: 0, to: bytes.count, by: 2) {
+      let pair = String(decoding: bytes[index..<index + 2], as: UTF8.self)
+      guard let byte = UInt8(pair, radix: 16) else { return nil }
+      data.append(byte)
+    }
+    return data
+  }
+}

package/ios/NgNativeFirebaseMessaging.podspec

@@ -0,0 +1,27 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'NgNativeFirebaseMessaging'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = 'Angular Native'
+  s.homepage       = 'https://github.com/ng-native/ng-native'
+  s.platforms      = { :ios => '16.4' }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/ng-native/ng-native.git' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'FirebaseCore'
+  s.dependency 'FirebaseInstallations'
+  # 12.16 added registration by installation ID; 12.18 fixed it for an app with a legacy FCM token
+  # cached.
+  s.dependency 'FirebaseMessaging', '>= 12.18.0'
+
+  s.source_files = '**/*.swift'
+  s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }
+end

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@ng-native/firebase-messaging",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.19.0",
+  "description": "Firebase Cloud Messaging by installation ID for Angular Native: registers the app's Firebase Installation ID with FCM, for a backend that sends through FCM's HTTP v1 API.",
+  "keywords": [
+    "angular",
+    "react-native",
+    "angular-native",
+    "expo",
+    "firebase",
+    "fcm",
+    "push-notifications",
+    "ios",
+    "android"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "peerDependencies": {
+    "@angular/core": "^22.0.0",
+    "@ng-native/device": "0.19.0",
+    "@ng-native/expo": "0.19.0",
+    "expo": "^57.0.0 || ^58.0.0",
+    "expo-notifications": "^57.0.0 || ^58.0.0"
+  },
+  "nx": {
+    "tags": [
+      "scope:firebase-messaging",
+      "layer:expo-addon"
+    ]
+  },
+  "license": "MIT",
+  "homepage": "https://ng-native.com/packages/firebase-messaging",
+  "bugs": {
+    "url": "https://github.com/ng-native/ng-native/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ng-native/ng-native.git",
+    "directory": "packages/firebase-messaging"
+  },
+  "files": [
+    "dist",
+    "app.plugin.cjs",
+    "expo-module.config.json",
+    "ios",
+    "android/build.gradle",
+    "android/src"
+  ],
+  "devDependencies": {
+    "@angular/core": "22.2.0",
+    "@babel/core": "^7.29.7",
+    "@ng-native/device": "0.19.0",
+    "@ng-native/expo": "0.19.0",
+    "typescript": "~6.0.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./app.plugin.cjs": "./app.plugin.cjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "ngc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "types": "dist/index.d.ts"
 }