@prmichaelsen/firebase-admin-sdk-v8 2.5.2 → 2.6.0

package/.claude/settings.local.json

@@ -4,7 +4,16 @@
       "Bash(./agent/scripts/acp.version-check-for-updates.sh:*)",
       "Bash(test:*)",
       "Bash(ls:*)",
-      "Bash(git add:*)"
+      "Bash(git add:*)",
+      "Bash(grep:*)",
+      "Bash(npm test:*)",
+      "Bash(npm run:*)",
+      "Bash(bash:*)",
+      "Bash(npx jest:*)",
+      "WebFetch(domain:agentbase.me)",
+      "WebSearch",
+      "WebFetch(domain:firebase.google.com)",
+      "WebFetch(domain:developers.google.com)"
     ]
   }
 }

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.0] - 2026-03-07
+
+### Added
+- **Firebase Cloud Messaging (FCM)**: Server-side push notification support via FCM HTTP v1 API
+  - `sendMessage()` - Send notifications to devices, topics, or conditions
+  - `subscribeToTopic()` - Subscribe up to 1000 device tokens to a topic
+  - `unsubscribeFromTopic()` - Unsubscribe device tokens from a topic
+  - Full TypeScript types for Message, Notification, AndroidConfig, WebpushConfig, ApnsConfig
+  - Platform-specific configuration support (Android, Web, iOS)
+  - Data-only messages and notification+data payloads
+  - Topic name normalization (auto-prefixes `/topics/` when missing)
+  - 29 comprehensive unit tests
+- New module: `src/messaging/` (client, types, index)
+- New exported types: `Message`, `FcmNotification`, `AndroidConfig`, `AndroidNotification`, `WebpushConfig`, `ApnsConfig`, `FcmOptions`, `SendResponse`, `TopicManagementResponse`, `TopicManagementError`
+
+### Changed
+- Total unit tests increased from 469 to 498 (+29 tests)
+- Total test suites increased from 16 to 17
+
 ## [2.5.2] - 2026-03-03
 
 ### Fixed

package/dist/index.d.mts

@@ -1006,6 +1006,153 @@ interface ResumableUploadOptions extends UploadOptions {
  */
 declare function uploadFileResumable(path: string, data: ArrayBuffer | Uint8Array | Blob | ReadableStream<Uint8Array>, contentType: string, options?: ResumableUploadOptions): Promise<FileMetadata>;
 
+/**
+ * Firebase Cloud Messaging (FCM) Types
+ * Based on FCM HTTP v1 API specification
+ */
+interface Message {
+    /** Device registration token (mutually exclusive with topic/condition) */
+    token?: string;
+    /** Topic name (mutually exclusive with token/condition) */
+    topic?: string;
+    /** Condition expression for topic combinations (mutually exclusive with token/topic) */
+    condition?: string;
+    /** Basic notification payload displayed on all platforms */
+    notification?: Notification;
+    /** Custom key-value data payload */
+    data?: Record<string, string>;
+    /** Android-specific configuration */
+    android?: AndroidConfig;
+    /** Web push protocol configuration */
+    webpush?: WebpushConfig;
+    /** Apple Push Notification Service configuration */
+    apns?: ApnsConfig;
+    /** FCM-specific options */
+    fcm_options?: FcmOptions;
+}
+interface Notification {
+    title?: string;
+    body?: string;
+    image?: string;
+}
+interface AndroidConfig {
+    collapse_key?: string;
+    priority?: 'high' | 'normal';
+    ttl?: string;
+    restricted_package_name?: string;
+    data?: Record<string, string>;
+    notification?: AndroidNotification;
+    fcm_options?: AndroidFcmOptions;
+    direct_boot_ok?: boolean;
+}
+interface AndroidNotification {
+    title?: string;
+    body?: string;
+    icon?: string;
+    color?: string;
+    sound?: string;
+    tag?: string;
+    click_action?: string;
+    body_loc_key?: string;
+    body_loc_args?: string[];
+    title_loc_key?: string;
+    title_loc_args?: string[];
+    channel_id?: string;
+    ticker?: string;
+    sticky?: boolean;
+    event_time?: string;
+    local_only?: boolean;
+    notification_priority?: AndroidNotificationPriority;
+    default_sound?: boolean;
+    default_vibrate_timings?: boolean;
+    default_light_settings?: boolean;
+    vibrate_timings?: string[];
+    visibility?: 'VISIBILITY_UNSPECIFIED' | 'PRIVATE' | 'PUBLIC' | 'SECRET';
+    notification_count?: number;
+    light_settings?: LightSettings;
+    image?: string;
+}
+type AndroidNotificationPriority = 'PRIORITY_UNSPECIFIED' | 'PRIORITY_MIN' | 'PRIORITY_LOW' | 'PRIORITY_DEFAULT' | 'PRIORITY_HIGH' | 'PRIORITY_MAX';
+interface LightSettings {
+    color: {
+        red: number;
+        green: number;
+        blue: number;
+        alpha: number;
+    };
+    light_on_duration: string;
+    light_off_duration: string;
+}
+interface AndroidFcmOptions {
+    analytics_label?: string;
+}
+interface WebpushConfig {
+    headers?: Record<string, string>;
+    data?: Record<string, string>;
+    notification?: Record<string, unknown>;
+    fcm_options?: WebpushFcmOptions;
+}
+interface WebpushFcmOptions {
+    link?: string;
+    analytics_label?: string;
+}
+interface ApnsConfig {
+    headers?: Record<string, string>;
+    payload?: Record<string, unknown>;
+    fcm_options?: ApnsFcmOptions;
+}
+interface ApnsFcmOptions {
+    analytics_label?: string;
+    image?: string;
+}
+interface FcmOptions {
+    analytics_label?: string;
+}
+interface SendResponse {
+    /** Full resource name: "projects/{id}/messages/{id}" */
+    name: string;
+}
+interface TopicManagementResponse {
+    successCount: number;
+    failureCount: number;
+    errors: TopicManagementError[];
+}
+interface TopicManagementError {
+    index: number;
+    error: string;
+}
+
+/**
+ * Firebase Cloud Messaging (FCM) Client
+ * Implements FCM HTTP v1 API for sending messages and managing topic subscriptions.
+ */
+
+/**
+ * Send a message via FCM HTTP v1 API.
+ *
+ * Exactly one of `message.token`, `message.topic`, or `message.condition` must be set.
+ *
+ * @param message - The message to send
+ * @returns The message resource name (e.g. "projects/my-project/messages/123")
+ */
+declare function sendMessage(message: Message): Promise<string>;
+/**
+ * Subscribe device tokens to a topic.
+ *
+ * @param tokens - Array of device registration tokens (max 1000)
+ * @param topic - Topic name (with or without "/topics/" prefix)
+ * @returns Results with success/failure counts and per-token errors
+ */
+declare function subscribeToTopic(tokens: string[], topic: string): Promise<TopicManagementResponse>;
+/**
+ * Unsubscribe device tokens from a topic.
+ *
+ * @param tokens - Array of device registration tokens (max 1000)
+ * @param topic - Topic name (with or without "/topics/" prefix)
+ * @returns Results with success/failure counts and per-token errors
+ */
+declare function unsubscribeFromTopic(tokens: string[], topic: string): Promise<TopicManagementResponse>;
+
 /**
  * Firebase Admin SDK v8 - Field Value Helpers
  * Special field values for Firestore operations
@@ -1103,4 +1250,4 @@ declare function getAdminAccessToken(): Promise<string>;
  */
 declare function clearTokenCache(): void;
 
-export { type BatchWrite, type BatchWriteResult, type CreateUserRequest, type CustomClaims, type CustomTokenSignInResponse, type DataObject, type DecodedIdToken, type DocumentReference, type DownloadOptions, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FileMetadata, type FirestoreDocument, type FirestoreValue, type ListFilesResult, type ListOptions, type ListUsersResult, type QueryFilter, type QueryOptions, type QueryOrder, type ResumableUploadOptions, type ServiceAccount, type SessionCookieOptions, type SetOptions, type SignedUrlOptions, type TokenResponse, type UpdateOptions, type UpdateUserRequest, type UploadOptions, type UserInfo, type UserRecord, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, countDocuments, createCustomToken, createSessionCookie, createUser, deleteDocument, deleteFile, deleteUser, downloadFile, fileExists, generateSignedUrl, getAdminAccessToken, getAuth, getConfig, getDocument, getFileMetadata, getProjectId, getServiceAccount, getUserByEmail, getUserByUid, getUserFromToken, initializeApp, iterateCollection, listDocuments, listFiles, listUsers, queryDocuments, setCustomUserClaims, setDocument, signInWithCustomToken, updateDocument, updateUser, uploadFile, uploadFileResumable, verifyIdToken, verifySessionCookie };
+export { type AndroidConfig, type AndroidNotification, type ApnsConfig, type BatchWrite, type BatchWriteResult, type CreateUserRequest, type CustomClaims, type CustomTokenSignInResponse, type DataObject, type DecodedIdToken, type DocumentReference, type DownloadOptions, type Notification as FcmNotification, type FcmOptions, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FileMetadata, type FirestoreDocument, type FirestoreValue, type ListFilesResult, type ListOptions, type ListUsersResult, type Message, type QueryFilter, type QueryOptions, type QueryOrder, type ResumableUploadOptions, type SendResponse, type ServiceAccount, type SessionCookieOptions, type SetOptions, type SignedUrlOptions, type TokenResponse, type TopicManagementError, type TopicManagementResponse, type UpdateOptions, type UpdateUserRequest, type UploadOptions, type UserInfo, type UserRecord, type WebpushConfig, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, countDocuments, createCustomToken, createSessionCookie, createUser, deleteDocument, deleteFile, deleteUser, downloadFile, fileExists, generateSignedUrl, getAdminAccessToken, getAuth, getConfig, getDocument, getFileMetadata, getProjectId, getServiceAccount, getUserByEmail, getUserByUid, getUserFromToken, initializeApp, iterateCollection, listDocuments, listFiles, listUsers, queryDocuments, sendMessage, setCustomUserClaims, setDocument, signInWithCustomToken, subscribeToTopic, unsubscribeFromTopic, updateDocument, updateUser, uploadFile, uploadFileResumable, verifyIdToken, verifySessionCookie };

package/dist/index.d.ts

@@ -1006,6 +1006,153 @@ interface ResumableUploadOptions extends UploadOptions {
  */
 declare function uploadFileResumable(path: string, data: ArrayBuffer | Uint8Array | Blob | ReadableStream<Uint8Array>, contentType: string, options?: ResumableUploadOptions): Promise<FileMetadata>;
 
+/**
+ * Firebase Cloud Messaging (FCM) Types
+ * Based on FCM HTTP v1 API specification
+ */
+interface Message {
+    /** Device registration token (mutually exclusive with topic/condition) */
+    token?: string;
+    /** Topic name (mutually exclusive with token/condition) */
+    topic?: string;
+    /** Condition expression for topic combinations (mutually exclusive with token/topic) */
+    condition?: string;
+    /** Basic notification payload displayed on all platforms */
+    notification?: Notification;
+    /** Custom key-value data payload */
+    data?: Record<string, string>;
+    /** Android-specific configuration */
+    android?: AndroidConfig;
+    /** Web push protocol configuration */
+    webpush?: WebpushConfig;
+    /** Apple Push Notification Service configuration */
+    apns?: ApnsConfig;
+    /** FCM-specific options */
+    fcm_options?: FcmOptions;
+}
+interface Notification {
+    title?: string;
+    body?: string;
+    image?: string;
+}
+interface AndroidConfig {
+    collapse_key?: string;
+    priority?: 'high' | 'normal';
+    ttl?: string;
+    restricted_package_name?: string;
+    data?: Record<string, string>;
+    notification?: AndroidNotification;
+    fcm_options?: AndroidFcmOptions;
+    direct_boot_ok?: boolean;
+}
+interface AndroidNotification {
+    title?: string;
+    body?: string;
+    icon?: string;
+    color?: string;
+    sound?: string;
+    tag?: string;
+    click_action?: string;
+    body_loc_key?: string;
+    body_loc_args?: string[];
+    title_loc_key?: string;
+    title_loc_args?: string[];
+    channel_id?: string;
+    ticker?: string;
+    sticky?: boolean;
+    event_time?: string;
+    local_only?: boolean;
+    notification_priority?: AndroidNotificationPriority;
+    default_sound?: boolean;
+    default_vibrate_timings?: boolean;
+    default_light_settings?: boolean;
+    vibrate_timings?: string[];
+    visibility?: 'VISIBILITY_UNSPECIFIED' | 'PRIVATE' | 'PUBLIC' | 'SECRET';
+    notification_count?: number;
+    light_settings?: LightSettings;
+    image?: string;
+}
+type AndroidNotificationPriority = 'PRIORITY_UNSPECIFIED' | 'PRIORITY_MIN' | 'PRIORITY_LOW' | 'PRIORITY_DEFAULT' | 'PRIORITY_HIGH' | 'PRIORITY_MAX';
+interface LightSettings {
+    color: {
+        red: number;
+        green: number;
+        blue: number;
+        alpha: number;
+    };
+    light_on_duration: string;
+    light_off_duration: string;
+}
+interface AndroidFcmOptions {
+    analytics_label?: string;
+}
+interface WebpushConfig {
+    headers?: Record<string, string>;
+    data?: Record<string, string>;
+    notification?: Record<string, unknown>;
+    fcm_options?: WebpushFcmOptions;
+}
+interface WebpushFcmOptions {
+    link?: string;
+    analytics_label?: string;
+}
+interface ApnsConfig {
+    headers?: Record<string, string>;
+    payload?: Record<string, unknown>;
+    fcm_options?: ApnsFcmOptions;
+}
+interface ApnsFcmOptions {
+    analytics_label?: string;
+    image?: string;
+}
+interface FcmOptions {
+    analytics_label?: string;
+}
+interface SendResponse {
+    /** Full resource name: "projects/{id}/messages/{id}" */
+    name: string;
+}
+interface TopicManagementResponse {
+    successCount: number;
+    failureCount: number;
+    errors: TopicManagementError[];
+}
+interface TopicManagementError {
+    index: number;
+    error: string;
+}
+
+/**
+ * Firebase Cloud Messaging (FCM) Client
+ * Implements FCM HTTP v1 API for sending messages and managing topic subscriptions.
+ */
+
+/**
+ * Send a message via FCM HTTP v1 API.
+ *
+ * Exactly one of `message.token`, `message.topic`, or `message.condition` must be set.
+ *
+ * @param message - The message to send
+ * @returns The message resource name (e.g. "projects/my-project/messages/123")
+ */
+declare function sendMessage(message: Message): Promise<string>;
+/**
+ * Subscribe device tokens to a topic.
+ *
+ * @param tokens - Array of device registration tokens (max 1000)
+ * @param topic - Topic name (with or without "/topics/" prefix)
+ * @returns Results with success/failure counts and per-token errors
+ */
+declare function subscribeToTopic(tokens: string[], topic: string): Promise<TopicManagementResponse>;
+/**
+ * Unsubscribe device tokens from a topic.
+ *
+ * @param tokens - Array of device registration tokens (max 1000)
+ * @param topic - Topic name (with or without "/topics/" prefix)
+ * @returns Results with success/failure counts and per-token errors
+ */
+declare function unsubscribeFromTopic(tokens: string[], topic: string): Promise<TopicManagementResponse>;
+
 /**
  * Firebase Admin SDK v8 - Field Value Helpers
  * Special field values for Firestore operations
@@ -1103,4 +1250,4 @@ declare function getAdminAccessToken(): Promise<string>;
  */
 declare function clearTokenCache(): void;
 
-export { type BatchWrite, type BatchWriteResult, type CreateUserRequest, type CustomClaims, type CustomTokenSignInResponse, type DataObject, type DecodedIdToken, type DocumentReference, type DownloadOptions, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FileMetadata, type FirestoreDocument, type FirestoreValue, type ListFilesResult, type ListOptions, type ListUsersResult, type QueryFilter, type QueryOptions, type QueryOrder, type ResumableUploadOptions, type ServiceAccount, type SessionCookieOptions, type SetOptions, type SignedUrlOptions, type TokenResponse, type UpdateOptions, type UpdateUserRequest, type UploadOptions, type UserInfo, type UserRecord, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, countDocuments, createCustomToken, createSessionCookie, createUser, deleteDocument, deleteFile, deleteUser, downloadFile, fileExists, generateSignedUrl, getAdminAccessToken, getAuth, getConfig, getDocument, getFileMetadata, getProjectId, getServiceAccount, getUserByEmail, getUserByUid, getUserFromToken, initializeApp, iterateCollection, listDocuments, listFiles, listUsers, queryDocuments, setCustomUserClaims, setDocument, signInWithCustomToken, updateDocument, updateUser, uploadFile, uploadFileResumable, verifyIdToken, verifySessionCookie };
+export { type AndroidConfig, type AndroidNotification, type ApnsConfig, type BatchWrite, type BatchWriteResult, type CreateUserRequest, type CustomClaims, type CustomTokenSignInResponse, type DataObject, type DecodedIdToken, type DocumentReference, type DownloadOptions, type Notification as FcmNotification, type FcmOptions, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FileMetadata, type FirestoreDocument, type FirestoreValue, type ListFilesResult, type ListOptions, type ListUsersResult, type Message, type QueryFilter, type QueryOptions, type QueryOrder, type ResumableUploadOptions, type SendResponse, type ServiceAccount, type SessionCookieOptions, type SetOptions, type SignedUrlOptions, type TokenResponse, type TopicManagementError, type TopicManagementResponse, type UpdateOptions, type UpdateUserRequest, type UploadOptions, type UserInfo, type UserRecord, type WebpushConfig, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, countDocuments, createCustomToken, createSessionCookie, createUser, deleteDocument, deleteFile, deleteUser, downloadFile, fileExists, generateSignedUrl, getAdminAccessToken, getAuth, getConfig, getDocument, getFileMetadata, getProjectId, getServiceAccount, getUserByEmail, getUserByUid, getUserFromToken, initializeApp, iterateCollection, listDocuments, listFiles, listUsers, queryDocuments, sendMessage, setCustomUserClaims, setDocument, signInWithCustomToken, subscribeToTopic, unsubscribeFromTopic, updateDocument, updateUser, uploadFile, uploadFileResumable, verifyIdToken, verifySessionCookie };

package/dist/index.js

@@ -231,9 +231,12 @@ __export(index_exports, {
   listFiles: () => listFiles,
   listUsers: () => listUsers,
   queryDocuments: () => queryDocuments,
+  sendMessage: () => sendMessage,
   setCustomUserClaims: () => setCustomUserClaims,
   setDocument: () => setDocument,
   signInWithCustomToken: () => signInWithCustomToken,
+  subscribeToTopic: () => subscribeToTopic,
+  unsubscribeFromTopic: () => unsubscribeFromTopic,
   updateDocument: () => updateDocument,
   updateUser: () => updateUser,
   uploadFile: () => uploadFile,
@@ -2142,6 +2145,96 @@ async function uploadFromStream(bucket, path, stream, contentType, chunkSize, op
   }
 }
 
+// src/messaging/client.ts
+init_token_generation();
+init_config();
+var FCM_BASE_URL = "https://fcm.googleapis.com/v1";
+var IID_BASE_URL = "https://iid.googleapis.com/iid/v1";
+async function sendMessage(message) {
+  const targets = [message.token, message.topic, message.condition].filter(Boolean);
+  if (targets.length === 0) {
+    throw new Error("One of token, topic, or condition must be specified");
+  }
+  if (targets.length > 1) {
+    throw new Error("Only one of token, topic, or condition can be specified");
+  }
+  const config = getConfig();
+  const accessToken = await getAdminAccessToken();
+  const url = `${FCM_BASE_URL}/projects/${config.projectId}/messages:send`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${accessToken}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ message })
+  });
+  if (!response.ok) {
+    let errorDetail;
+    try {
+      const errorBody = await response.json();
+      errorDetail = JSON.stringify(errorBody);
+    } catch {
+      errorDetail = await response.text();
+    }
+    throw new Error(`FCM send failed (${response.status}): ${errorDetail}`);
+  }
+  const result = await response.json();
+  return result.name;
+}
+async function subscribeToTopic(tokens, topic) {
+  return manageTopicSubscription(tokens, topic, "batchAdd");
+}
+async function unsubscribeFromTopic(tokens, topic) {
+  return manageTopicSubscription(tokens, topic, "batchRemove");
+}
+async function manageTopicSubscription(tokens, topic, action) {
+  if (tokens.length === 0) {
+    throw new Error("At least one token is required");
+  }
+  if (tokens.length > 1e3) {
+    throw new Error("Maximum 1000 tokens per request");
+  }
+  const accessToken = await getAdminAccessToken();
+  const url = `${IID_BASE_URL}:${action}`;
+  const topicPath = topic.startsWith("/topics/") ? topic : `/topics/${topic}`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${accessToken}`,
+      "Content-Type": "application/json",
+      "access_token_auth": "true"
+    },
+    body: JSON.stringify({
+      to: topicPath,
+      registration_tokens: tokens
+    })
+  });
+  if (!response.ok) {
+    let errorDetail;
+    try {
+      errorDetail = await response.text();
+    } catch {
+      errorDetail = `HTTP ${response.status}`;
+    }
+    throw new Error(`FCM topic ${action} failed (${response.status}): ${errorDetail}`);
+  }
+  const result = await response.json();
+  let successCount = 0;
+  let failureCount = 0;
+  const errors = [];
+  for (let i = 0; i < result.results.length; i++) {
+    const entry = result.results[i];
+    if (entry.error) {
+      failureCount++;
+      errors.push({ index: i, error: entry.error });
+    } else {
+      successCount++;
+    }
+  }
+  return { successCount, failureCount, errors };
+}
+
 // src/index.ts
 init_token_generation();
 init_service_account();
@@ -2178,9 +2271,12 @@ init_service_account();
   listFiles,
   listUsers,
   queryDocuments,
+  sendMessage,
   setCustomUserClaims,
   setDocument,
   signInWithCustomToken,
+  subscribeToTopic,
+  unsubscribeFromTopic,
   updateDocument,
   updateUser,
   uploadFile,

package/dist/index.mjs

@@ -1891,6 +1891,94 @@ async function uploadFromStream(bucket, path, stream, contentType, chunkSize, op
     reader.releaseLock();
   }
 }
+
+// src/messaging/client.ts
+var FCM_BASE_URL = "https://fcm.googleapis.com/v1";
+var IID_BASE_URL = "https://iid.googleapis.com/iid/v1";
+async function sendMessage(message) {
+  const targets = [message.token, message.topic, message.condition].filter(Boolean);
+  if (targets.length === 0) {
+    throw new Error("One of token, topic, or condition must be specified");
+  }
+  if (targets.length > 1) {
+    throw new Error("Only one of token, topic, or condition can be specified");
+  }
+  const config = getConfig();
+  const accessToken = await getAdminAccessToken();
+  const url = `${FCM_BASE_URL}/projects/${config.projectId}/messages:send`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${accessToken}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ message })
+  });
+  if (!response.ok) {
+    let errorDetail;
+    try {
+      const errorBody = await response.json();
+      errorDetail = JSON.stringify(errorBody);
+    } catch {
+      errorDetail = await response.text();
+    }
+    throw new Error(`FCM send failed (${response.status}): ${errorDetail}`);
+  }
+  const result = await response.json();
+  return result.name;
+}
+async function subscribeToTopic(tokens, topic) {
+  return manageTopicSubscription(tokens, topic, "batchAdd");
+}
+async function unsubscribeFromTopic(tokens, topic) {
+  return manageTopicSubscription(tokens, topic, "batchRemove");
+}
+async function manageTopicSubscription(tokens, topic, action) {
+  if (tokens.length === 0) {
+    throw new Error("At least one token is required");
+  }
+  if (tokens.length > 1e3) {
+    throw new Error("Maximum 1000 tokens per request");
+  }
+  const accessToken = await getAdminAccessToken();
+  const url = `${IID_BASE_URL}:${action}`;
+  const topicPath = topic.startsWith("/topics/") ? topic : `/topics/${topic}`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${accessToken}`,
+      "Content-Type": "application/json",
+      "access_token_auth": "true"
+    },
+    body: JSON.stringify({
+      to: topicPath,
+      registration_tokens: tokens
+    })
+  });
+  if (!response.ok) {
+    let errorDetail;
+    try {
+      errorDetail = await response.text();
+    } catch {
+      errorDetail = `HTTP ${response.status}`;
+    }
+    throw new Error(`FCM topic ${action} failed (${response.status}): ${errorDetail}`);
+  }
+  const result = await response.json();
+  let successCount = 0;
+  let failureCount = 0;
+  const errors = [];
+  for (let i = 0; i < result.results.length; i++) {
+    const entry = result.results[i];
+    if (entry.error) {
+      failureCount++;
+      errors.push({ index: i, error: entry.error });
+    } else {
+      successCount++;
+    }
+  }
+  return { successCount, failureCount, errors };
+}
 export {
   FieldValue,
   addDocument,
@@ -1923,9 +2011,12 @@ export {
   listFiles,
   listUsers,
   queryDocuments,
+  sendMessage,
   setCustomUserClaims,
   setDocument,
   signInWithCustomToken,
+  subscribeToTopic,
+  unsubscribeFromTopic,
   updateDocument,
   updateUser,
   uploadFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/firebase-admin-sdk-v8",
-  "version": "2.5.2",
+  "version": "2.6.0",
   "description": "Firebase Admin SDK for Cloudflare Workers and edge runtimes using REST APIs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",