v3.x

Author: agordn52

.gitignore

@@ -72,3 +72,6 @@ build/
 !**/ios/**/default.mode2v3
 !**/ios/**/default.pbxuser
 !**/ios/**/default.perspectivev3
+
+CLAUDE.md
+.claude

CHANGELOG.md

@@ -1,3 +1,27 @@
+## [3.0.0] - 2026-02-06
+
+### Added
+- `LaravelNotifyFcmNotInitializedException` custom exception for clearer error handling when the package is not initialized.
+- New test suite with unit, integration, API service, and interceptor tests.
+- Proper type annotations on `apiServiceFcm` return type and interceptors getter.
+
+### Changed
+- **BREAKING**: `init()` no longer requires a `firebaseMessaging` parameter. The package no longer manages `FirebaseMessaging` internally -- consumers must manage Firebase directly.
+- **BREAKING**: `storeFcmDevice()` now requires `fcmToken` as a positional parameter and returns `Future<bool?>` instead of `Future<NotificationSettings?>`.
+- **BREAKING**: `enableFcmDevice()` and `disableFcmDevice()` now require `fcmToken` as a positional parameter and `sanctumToken` as a named parameter.
+- **BREAKING**: Sanctum token is now passed per-call instead of being stored as instance state. Removed `getSanctumToken()` and `setSanctumToken()` methods.
+- Authentication header (`Authorization: Bearer`) is now set at the API request level instead of via the interceptor.
+- Interceptor now gracefully handles uninitialized state instead of throwing.
+- Upgraded `nylo_support` to ^7.0.0, `device_meta` to ^3.0.0, `dio` to ^5.9.0.
+
+### Removed
+- **BREAKING**: `firebase_messaging` direct dependency. Consumers must add `firebase_messaging` to their own `pubspec.yaml` and pass the FCM token to this package.
+- **BREAKING**: `getFirebaseMessaging()` method.
+- **BREAKING**: `getFcmToken()` static method.
+- **BREAKING**: `getSanctumToken()` and `setSanctumToken()` methods.
+- CLI scaffolding system (`bin/main.dart`, `lib/cli_dialog/`, `lib/stubs/`, `lib/slate_laravel_notify_fcm.dart`, `lib/models/`).
+- `pretty_dio_logger` dependency.
+
 ## [2.1.5] - 2025-12-17
 
 * Add extra check to `getFcmToken` method to ensure token is not null

README.md

@@ -33,24 +33,8 @@ dart pub add laravel_notify_fcm
 
 ### Usage
 
-Using Nylo? Run the following command to scaffold the necessary files for FCM notifications.
-
-``` bash
-dart run laravel_notify_fcm:main install
-```
-
-This will create the following files:
-- Provider - `FirebaseMessagingProvider` (lib/providers/firebase_messaging_provider.dart)
-  - This will initialize the package to send notifications to the device.
-- Page - `EnableNotificationsPage` (lib/pages/enable_notifications_page.dart)
-  - This page will request permission to send notifications to the device.
-  - You can navigate to it by calling `routeTo(EnableNotificationsPage.path);`.
-- Event - `RegisterForNotificationsEvent` (lib/events/register_for_notifications_event.dart)
-  - This event will be dispatched to request permission to send notifications to the device.
-
 ``` dart
 import 'package:laravel_notify_fcm/laravel_notify_fcm.dart';
-
 ```
 
 ### Adding a device to the database
@@ -59,28 +43,30 @@ First, call `init` to initialize the package.
 
 Parameters:
 - `url` - The URL to your Laravel app where the package will send the device token.
-- `firebaseMessaging` - The FirebaseMessaging instance.
 - `debugMode` - Whether to enable debug mode. The default is `false`.
 
 ```dart
-FirebaseMessaging firebaseMessaging = FirebaseMessaging.instance;
-
 await LaravelNotifyFcm.instance.init(
   url: 'https://example.com/api/fcm',
-  firebaseMessaging: firebaseMessaging,
 );
 ```
 
-Then, call `storeFcmDevice` to add the device to the database.
+Then, call `storeFcmDevice` to register the device with your Laravel backend.
+
+Parameters:
+- `fcmToken` - The FCM token from `FirebaseMessaging.instance.getToken()`.
+- `sanctumToken` - A valid Laravel Sanctum token for the authenticated user.
 
 ``` dart
+String? fcmToken = await FirebaseMessaging.instance.getToken();
 
 await LaravelNotifyFcm.storeFcmDevice(
+  fcmToken,
   sanctumToken: 'from your Laravel user',
 );
 ```
 
-This method will request permission to send notifications to the device. If the user accepts, the device will be added to the database.
+This will send the device token and metadata to your Laravel backend via a PUT `/device` request.
 
 View our [docs](https://github.com/nylo-core/laravel-fcm-channel) on Laravel FCM Channel to start sending notifications.
 

bin/main.dart

@@ -1,14 +1,11 @@
-import 'package:firebase_messaging/firebase_messaging.dart';
 import 'package:flutter/material.dart';
 import 'package:laravel_notify_fcm/laravel_notify_fcm.dart';
 
 void main() async {
   // Firebase.initializeApp();
   WidgetsFlutterBinding.ensureInitialized();
-  FirebaseMessaging firebaseMessaging = FirebaseMessaging.instance;
 
   LaravelNotifyFcm.instance.init(
-    firebaseMessaging: firebaseMessaging,
     url: "https://example.com/api/fcm",
     debugMode: true,
   );
@@ -52,9 +49,6 @@ class _MyHomePageState extends State<MyHomePage> {
             child: Text("Enable notifications"),
             onTap: () async {
               // get your sanctum token from your Laravel app
-
-              await LaravelNotifyFcm.storeFcmDevice(
-                  sanctumToken: 'sanctumToken');
             },
           ),
         ),