change(fcm): Remove deprecated FCM APIs

Author: lahirumaramba

etc/firebase-admin.api.md

@@ -382,22 +382,12 @@ export namespace messaging {
     export type Message = Message;
     // Warning: (ae-forgotten-export) The symbol "Messaging" needs to be exported by the entry point default-namespace.d.ts
     export type Messaging = Messaging;
-    // Warning: (ae-forgotten-export) The symbol "MessagingConditionResponse" needs to be exported by the entry point default-namespace.d.ts
-    export type MessagingConditionResponse = MessagingConditionResponse;
-    // Warning: (ae-forgotten-export) The symbol "MessagingDeviceGroupResponse" needs to be exported by the entry point default-namespace.d.ts
-    export type MessagingDeviceGroupResponse = MessagingDeviceGroupResponse;
-    // Warning: (ae-forgotten-export) The symbol "MessagingDeviceResult" needs to be exported by the entry point default-namespace.d.ts
-    export type MessagingDeviceResult = MessagingDeviceResult;
-    // Warning: (ae-forgotten-export) The symbol "MessagingDevicesResponse" needs to be exported by the entry point default-namespace.d.ts
-    export type MessagingDevicesResponse = MessagingDevicesResponse;
     // Warning: (ae-forgotten-export) The symbol "MessagingOptions" needs to be exported by the entry point default-namespace.d.ts
     export type MessagingOptions = MessagingOptions;
     // Warning: (ae-forgotten-export) The symbol "MessagingPayload" needs to be exported by the entry point default-namespace.d.ts
     export type MessagingPayload = MessagingPayload;
     // 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 "MessagingTopicResponse" needs to be exported by the entry point default-namespace.d.ts
-    export type MessagingTopicResponse = MessagingTopicResponse;
     // Warning: (ae-forgotten-export) The symbol "MulticastMessage" needs to be exported by the entry point default-namespace.d.ts
     export type MulticastMessage = MulticastMessage;
     // Warning: (ae-forgotten-export) The symbol "Notification" needs to be exported by the entry point default-namespace.d.ts
@@ -511,8 +501,8 @@ export function storage(app?: App): storage.Storage;
 
 // @public (undocumented)
 export namespace storage {
-    // Warning: (ae-forgotten-export) The symbol "Storage" needs to be exported by the entry point default-namespace.d.ts
-    export type Storage = Storage;
+    // Warning: (ae-forgotten-export) The symbol "Storage_2" needs to be exported by the entry point default-namespace.d.ts
+    export type Storage = Storage_2;
 }
 
 ```

etc/firebase-admin.messaging.api.md

@@ -193,20 +193,8 @@ export class Messaging {
     // @deprecated
     enableLegacyHttpTransport(): void;
     send(message: Message, dryRun?: boolean): Promise<string>;
-    // @deprecated
-    sendAll(messages: Message[], dryRun?: boolean): Promise<BatchResponse>;
     sendEach(messages: Message[], dryRun?: boolean): Promise<BatchResponse>;
     sendEachForMulticast(message: MulticastMessage, dryRun?: boolean): Promise<BatchResponse>;
-    // @deprecated
-    sendMulticast(message: MulticastMessage, dryRun?: boolean): Promise<BatchResponse>;
-    // @deprecated
-    sendToCondition(condition: string, payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingConditionResponse>;
-    // @deprecated
-    sendToDevice(registrationTokenOrTokens: string | string[], payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingDevicesResponse>;
-    // @deprecated
-    sendToDeviceGroup(notificationKey: string, payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingDeviceGroupResponse>;
-    // @deprecated
-    sendToTopic(topic: string, payload: MessagingPayload, options?: MessagingOptions): Promise<MessagingTopicResponse>;
     subscribeToTopic(registrationTokenOrTokens: string | string[], topic: string): Promise<MessagingTopicManagementResponse>;
     unsubscribeFromTopic(registrationTokenOrTokens: string | string[], topic: string): Promise<MessagingTopicManagementResponse>;
 }
@@ -310,40 +298,6 @@ export class MessagingClientErrorCode {
     };
 }
 
-// @public
-export interface MessagingConditionResponse {
-    messageId: number;
-}
-
-// @public @deprecated
-export interface MessagingDeviceGroupResponse {
-    failedRegistrationTokens: string[];
-    failureCount: number;
-    successCount: number;
-}
-
-// @public @deprecated
-export interface MessagingDeviceResult {
-    canonicalRegistrationToken?: string;
-    // Warning: (ae-forgotten-export) The symbol "FirebaseError" needs to be exported by the entry point index.d.ts
-    error?: FirebaseError;
-    messageId?: string;
-}
-
-// @public @deprecated
-export interface MessagingDevicesResponse {
-    // (undocumented)
-    canonicalRegistrationTokenCount: number;
-    // (undocumented)
-    failureCount: number;
-    // (undocumented)
-    multicastId: number;
-    // (undocumented)
-    results: MessagingDeviceResult[];
-    // (undocumented)
-    successCount: number;
-}
-
 // @public
 export interface MessagingOptions {
     // (undocumented)
@@ -371,11 +325,6 @@ export interface MessagingTopicManagementResponse {
     successCount: number;
 }
 
-// @public
-export interface MessagingTopicResponse {
-    messageId: number;
-}
-
 // @public
 export interface MulticastMessage extends BaseMessage {
     // (undocumented)
@@ -409,6 +358,7 @@ export interface NotificationMessagePayload {
 
 // @public
 export interface SendResponse {
+    // Warning: (ae-forgotten-export) The symbol "FirebaseError" needs to be exported by the entry point index.d.ts
     error?: FirebaseError;
     messageId?: string;
     success: boolean;

etc/firebase-admin.storage.api.md

@@ -16,12 +16,13 @@ export function getDownloadURL(file: File_2): Promise<string>;
 // Warning: (ae-forgotten-export) The symbol "App" needs to be exported by the entry point index.d.ts
 //
 // @public
-export function getStorage(app?: App): Storage;
+export function getStorage(app?: App): Storage_2;
 
 // @public
-export class Storage {
+class Storage_2 {
     get app(): App;
     bucket(name?: string): Bucket;
 }
+export { Storage_2 as Storage }
 
 ```

src/messaging/batch-request-internal.ts

@@ -56,13 +56,8 @@ export {
 
   // Legacy APIs
   DataMessagePayload,
-  MessagingConditionResponse,
-  MessagingDeviceGroupResponse,
-  MessagingDeviceResult,
-  MessagingDevicesResponse,
   MessagingOptions,
   MessagingPayload,
-  MessagingTopicResponse,
   NotificationMessagePayload,
 } from './messaging-api';
 

src/messaging/index.ts

@@ -22,19 +22,13 @@ import {
   AuthorizedHttp2Client, Http2SessionHandler, Http2RequestConfig,
 } from '../utils/api-request';
 import { createFirebaseError, getErrorCode } from './messaging-errors-internal';
-import { SubRequest, BatchRequestClient } from './batch-request-internal';
 import { getSdkVersion } from '../utils/index';
-import { SendResponse, BatchResponse } from './messaging-api';
+import { SendResponse } from './messaging-api';
 
 
 // FCM backend constants
 const FIREBASE_MESSAGING_TIMEOUT = 15000;
-const FIREBASE_MESSAGING_BATCH_URL = 'https://fcm.googleapis.com/batch';
 const FIREBASE_MESSAGING_HTTP_METHOD: HttpMethod = 'POST';
-const FIREBASE_MESSAGING_HEADERS = {
-  'X-Firebase-Client': `fire-admin-node/${getSdkVersion()}`,
-  'X-Goog-Api-Client': `gl-node/${process.versions.node} fire-admin/${getSdkVersion()}`
-};
 const LEGACY_FIREBASE_MESSAGING_HEADERS = {
   'X-Firebase-Client': `fire-admin-node/${getSdkVersion()}`,
   'X-Goog-Api-Client': `gl-node/${process.versions.node} fire-admin/${getSdkVersion()}`,
@@ -48,7 +42,6 @@ const LEGACY_FIREBASE_MESSAGING_HEADERS = {
 export class FirebaseMessagingRequestHandler {
   private readonly httpClient: AuthorizedHttpClient;
   private readonly http2Client: AuthorizedHttp2Client;
-  private readonly batchClient: BatchRequestClient;
 
   /**
    * @param app - The app used to fetch access tokens to sign API requests.
@@ -57,8 +50,6 @@ export class FirebaseMessagingRequestHandler {
   constructor(app: App) {
     this.httpClient = new AuthorizedHttpClient(app as FirebaseApp);
     this.http2Client = new AuthorizedHttp2Client(app as FirebaseApp);
-    this.batchClient = new BatchRequestClient(
-      this.httpClient, FIREBASE_MESSAGING_BATCH_URL, FIREBASE_MESSAGING_HEADERS);
   }
 
   /**
@@ -162,35 +153,6 @@ export class FirebaseMessagingRequestHandler {
       });
   }
 
-  /**
-   * Sends the given array of sub requests as a single batch to FCM, and parses the result into
-   * a `BatchResponse` object.
-   *
-   * @param requests - An array of sub requests to send.
-   * @returns A promise that resolves when the send operation is complete.
-   */
-  public sendBatchRequest(requests: SubRequest[]): Promise<BatchResponse> {
-    return this.batchClient.send(requests)
-      .then((responses: RequestResponse[]) => {
-        return responses.map((part: RequestResponse) => {
-          return this.buildSendResponse(part);
-        });
-      }).then((responses: SendResponse[]) => {
-        const successCount: number = responses.filter((resp) => resp.success).length;
-        return {
-          responses,
-          successCount,
-          failureCount: responses.length - successCount,
-        };
-      }).catch((err) => {
-        if (err instanceof RequestResponseError) {
-          throw createFirebaseError(err);
-        }
-        // Re-throw the error if it already has the proper format.
-        throw err;
-      });
-  }
-
   private buildSendResponse(response: RequestResponse): SendResponse {
     const result: SendResponse = {
       success: response.status === 200,