Extract API doc and remove hyperlink due to duplicate names from function overload

Author: yvonnep165

etc/firebase-admin.api.md

@@ -376,6 +376,8 @@ export namespace messaging {
     export type FcmOptions = FcmOptions;
     // Warning: (ae-forgotten-export) The symbol "FidMessage" needs to be exported by the entry point default-namespace.d.ts
     export type FidMessage = FidMessage;
+    // Warning: (ae-forgotten-export) The symbol "FidMulticastMessage" needs to be exported by the entry point default-namespace.d.ts
+    export type FidMulticastMessage = FidMulticastMessage;
     // Warning: (ae-forgotten-export) The symbol "LightSettings" needs to be exported by the entry point default-namespace.d.ts
     export type LightSettings = LightSettings;
     // Warning: (ae-forgotten-export) The symbol "Message" needs to be exported by the entry point default-namespace.d.ts
@@ -389,6 +391,8 @@ export namespace messaging {
     // Warning: (ae-forgotten-export) The symbol "MessagingTopicManagementResponse" needs to be exported by the entry point default-namespace.d.ts
     export type MessagingTopicManagementResponse = MessagingTopicManagementResponse;
     // Warning: (ae-forgotten-export) The symbol "MulticastMessage" needs to be exported by the entry point default-namespace.d.ts
+    //
+    // @deprecated
     export type MulticastMessage = MulticastMessage;
     // Warning: (ae-forgotten-export) The symbol "Notification" needs to be exported by the entry point default-namespace.d.ts
     export type Notification = Notification;

etc/firebase-admin.messaging.api.md

@@ -173,6 +173,11 @@ export interface FidMessage extends BaseMessage {
     fid: string;
 }
 
+// @public
+export interface FidMulticastMessage extends BaseMessage {
+    fids: string[];
+}
+
 // Warning: (ae-forgotten-export) The symbol "PrefixedFirebaseError" needs to be exported by the entry point index.d.ts
 //
 // @public
@@ -201,7 +206,9 @@ export class Messaging {
     enableLegacyHttpTransport(): void;
     send(message: Message, dryRun?: boolean): Promise<string>;
     sendEach(messages: Message[], dryRun?: boolean): Promise<BatchResponse>;
+    // @deprecated
     sendEachForMulticast(message: MulticastMessage, dryRun?: boolean): Promise<BatchResponse>;
+    sendEachForMulticast(message: FidMulticastMessage, dryRun?: boolean): Promise<BatchResponse>;
     subscribeToTopic(registrationTokenOrTokens: string | string[], topic: string): Promise<MessagingTopicManagementResponse>;
     unsubscribeFromTopic(registrationTokenOrTokens: string | string[], topic: string): Promise<MessagingTopicManagementResponse>;
 }
@@ -332,7 +339,7 @@ export interface MessagingTopicManagementResponse {
     successCount: number;
 }
 
-// @public
+// @public @deprecated
 export interface MulticastMessage extends BaseMessage {
     fids?: string[];
     // @deprecated

src/messaging/messaging-api.ts

@@ -58,7 +58,7 @@ export interface ConditionMessage extends BaseMessage {
 export type Message = FidMessage | TokenMessage | TopicMessage | ConditionMessage;
 
 /**
- * Payload for the {@link Messaging.sendEachForMulticast} method.
+ * Payload for the `sendEachForMulticast` method.
  *
  * @deprecated Use {@link FidMulticastMessage} instead.
  */
@@ -76,7 +76,7 @@ export interface MulticastMessage extends BaseMessage {
 }
 
 /**
- * Payload for the {@link Messaging.sendEachForMulticast} method containing only FIDs.
+ * Payload for the `sendEachForMulticast` method containing only FIDs.
  */
 export interface FidMulticastMessage extends BaseMessage {
   /**
@@ -1034,7 +1034,7 @@ export interface MessagingTopicManagementResponse {
 
 /**
  * Interface representing the server response from the
- * {@link Messaging.sendEach} and {@link Messaging.sendEachForMulticast} methods.
+ * {@link Messaging.sendEach} and `sendEachForMulticast` methods.
  */
 export interface BatchResponse {