feat: added e2e tests for TokenMessage and fixed doc comment links

Author: demolaf

packages/dart_firebase_admin/lib/src/messaging/messaging_api.dart

@@ -41,7 +41,7 @@ sealed class Message extends _BaseMessage {
 
 /// A message targeting a specific registration token.
 ///
-/// See [Send to individual devices](https://firebase.google.com/docs/cloud-messaging/send-message#send-messages-to-specific-devices)
+/// See [Send to individual devices](https://firebase.google.com/docs/cloud-messaging/send/admin-sdk#send-messages-to-specific-devices)
 class TokenMessage extends Message {
   TokenMessage({
     required this.token,
@@ -71,7 +71,7 @@ class TokenMessage extends Message {
 
 /// A message targeting a topic.
 ///
-/// See [Send to a topic](https://firebase.google.com/docs/cloud-messaging/send-message#send-messages-to-topics)
+/// See [Send to a topic](https://firebase.google.com/docs/cloud-messaging/send-topic-messages)
 class TopicMessage extends Message {
   TopicMessage({
     required this.topic,
@@ -101,7 +101,7 @@ class TopicMessage extends Message {
 
 /// A message targeting a condition.
 ///
-/// See [Send to topic conditions](https://firebase.google.com/docs/cloud-messaging/send-topic-messages).
+/// See [Send to topic conditions](https://firebase.google.com/docs/cloud-messaging/send-topic-messages#sending-to-topic-conditions).
 class ConditionMessage extends Message {
   ConditionMessage({
     required this.condition,
@@ -131,6 +131,8 @@ class ConditionMessage extends Message {
 
 /// Payload for the [Messaging.sendEachForMulticast] method. The payload contains all the fields
 /// in the BaseMessage type, and a list of tokens.
+///
+/// See [Send to multiple devices](https://firebase.google.com/docs/cloud-messaging/send/admin-sdk#send-messages-to-multiple-devices)
 class MulticastMessage extends _BaseMessage {
   MulticastMessage({
     super.data,

packages/dart_firebase_admin/test/integration/messaging/messaging_test.dart

@@ -53,6 +53,25 @@ void main() {
         expect(messageId, matches(RegExp(r'^projects/.*/messages/.*$')));
       });
 
+      test(
+        'send(TokenMessage, dryRun) returns a message ID for a registered device token',
+        () async {
+          final messageId = await messaging.send(
+            TokenMessage(
+              token: registrationToken,
+              notification: Notification(
+                title: 'Integration Test',
+                body: 'Testing TokenMessage success path',
+              ),
+            ),
+            dryRun: true,
+          );
+          expect(messageId, matches(RegExp(r'^projects/.*/messages/.*$')));
+        },
+        skip:
+            'No FCM emulator available. Requires a real FCM registration token from a client app.',
+      );
+
       test('send(ConditionMessage, dryRun) returns a message ID', () async {
         final messageId = await messaging.send(
           ConditionMessage(

packages/dart_firebase_admin/test/unit/messaging/messaging_test.dart

@@ -187,6 +187,25 @@ void main() {
       );
     });
 
+    test('sends a TokenMessage with token set on the request', () async {
+      when(
+        () => messages.send(any(), any()),
+      ).thenAnswer((_) => Future.value(fmc1.Message(name: 'test')));
+
+      const token = 'my-device-token';
+      final result = await messaging.send(TokenMessage(token: token));
+
+      expect(result, 'test');
+
+      final capture = verify(() => messages.send(captureAny(), captureAny()))
+        ..called(1);
+
+      final request = capture.captured.first as fmc1.SendMessageRequest;
+      expect(request.message?.token, token);
+      expect(request.message?.topic, isNull);
+      expect(request.message?.condition, isNull);
+    });
+
     test(
       'sends a ConditionMessage with condition set on the request',
       () async {