@prmichaelsen/firebase-admin-sdk-v8 2.5.3 → 2.7.0

package/.claude/settings.local.json

@@ -7,7 +7,15 @@
       "Bash(git add:*)",
       "Bash(grep:*)",
       "Bash(npm test:*)",
-      "Bash(npm run:*)"
+      "Bash(npm run:*)",
+      "Bash(bash:*)",
+      "Bash(npx jest:*)",
+      "WebFetch(domain:agentbase.me)",
+      "WebSearch",
+      "WebFetch(domain:firebase.google.com)",
+      "WebFetch(domain:developers.google.com)",
+      "Bash(npx tsc:*)",
+      "Bash(node --env-file=.env node_modules/.bin/jest --config jest.e2e.config.js --testPathPatterns='firestore/operations.e2e' 2>&1 | tail -20)"
     ]
   }
 }

package/CHANGELOG.md

@@ -5,6 +5,39 @@ 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.7.0] - 2026-03-12
+
+### Added
+- **Firestore Batch Get (`getAll`)**: Fetch multiple documents in a single REST API call
+  - `getAll(collectionPath, documentIds)` - Batch get up to 100 documents via `documents:batchGet` endpoint
+  - Returns results in the same order as input document IDs
+  - Missing documents return `null` (no throw)
+  - Enforces 100-document limit with clear error message
+  - Supports subcollection paths
+  - 8 unit tests + 5 e2e tests
+
+### Changed
+- Total unit tests increased from 498 to 506 (+8 tests)
+
+## [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

@@ -640,6 +640,22 @@ declare function queryDocuments(collectionPath: string, options?: QueryOptions):
     id: string;
     data: DataObject;
 }>>;
+/**
+ * Batch get multiple documents from Firestore
+ * Uses the documents:batchGet REST API endpoint
+ *
+ * @param collectionPath - The collection containing the documents
+ * @param documentIds - Array of document IDs to fetch (max 100)
+ * @returns Array of results in the same order as documentIds. Missing documents return null.
+ * @throws {Error} If the operation fails or more than 100 documents requested
+ *
+ * @example
+ * ```typescript
+ * const users = await getAll('users', ['user1', 'user2', 'user3']);
+ * // users[0] = { name: 'Alice', ... } or null if not found
+ * ```
+ */
+declare function getAll(collectionPath: string, documentIds: string[]): Promise<(DataObject | null)[]>;
 /**
  * Perform batch write operations (set, update, delete)
  *
@@ -1006,6 +1022,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 +1266,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, getAll, 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

@@ -640,6 +640,22 @@ declare function queryDocuments(collectionPath: string, options?: QueryOptions):
     id: string;
     data: DataObject;
 }>>;
+/**
+ * Batch get multiple documents from Firestore
+ * Uses the documents:batchGet REST API endpoint
+ *
+ * @param collectionPath - The collection containing the documents
+ * @param documentIds - Array of document IDs to fetch (max 100)
+ * @returns Array of results in the same order as documentIds. Missing documents return null.
+ * @throws {Error} If the operation fails or more than 100 documents requested
+ *
+ * @example
+ * ```typescript
+ * const users = await getAll('users', ['user1', 'user2', 'user3']);
+ * // users[0] = { name: 'Alice', ... } or null if not found
+ * ```
+ */
+declare function getAll(collectionPath: string, documentIds: string[]): Promise<(DataObject | null)[]>;
 /**
  * Perform batch write operations (set, update, delete)
  *
@@ -1006,6 +1022,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 +1266,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, getAll, 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

@@ -216,6 +216,7 @@ __export(index_exports, {
   fileExists: () => fileExists,
   generateSignedUrl: () => generateSignedUrl,
   getAdminAccessToken: () => getAdminAccessToken,
+  getAll: () => getAll,
   getAuth: () => getAuth,
   getConfig: () => getConfig,
   getDocument: () => getDocument,
@@ -231,9 +232,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,
@@ -1511,6 +1515,44 @@ async function queryDocuments(collectionPath, options) {
     data: convertFromFirestoreFormat(result.document.fields)
   }));
 }
+async function getAll(collectionPath, documentIds) {
+  if (documentIds.length === 0) return [];
+  if (documentIds.length > 100) {
+    throw new Error("getAll supports a maximum of 100 documents per request");
+  }
+  for (const id of documentIds) {
+    validateDocumentPath("collectionPath", collectionPath, id);
+  }
+  const accessToken = await getAdminAccessToken();
+  const projectId = getProjectId();
+  const basePath = `projects/${projectId}/databases/(default)/documents`;
+  const documents = documentIds.map((id) => `${basePath}/${collectionPath}/${id}`);
+  const url = `${FIRESTORE_API}/${basePath}:batchGet`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${accessToken}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ documents })
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to batch get documents: ${errorText}`);
+  }
+  const results = await response.json();
+  const resultMap = /* @__PURE__ */ new Map();
+  for (const result of results) {
+    if (result.found) {
+      const name = result.found.name;
+      const data = convertFromFirestoreFormat(result.found.fields);
+      resultMap.set(name, data);
+    } else if (result.missing) {
+      resultMap.set(result.missing, null);
+    }
+  }
+  return documents.map((docPath) => resultMap.get(docPath) ?? null);
+}
 async function batchWrite(operations) {
   const accessToken = await getAdminAccessToken();
   const projectId = getProjectId();
@@ -2142,6 +2184,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 accessToken = await getAdminAccessToken();
+  const projectId = getProjectId();
+  const url = `${FCM_BASE_URL}/projects/${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();
@@ -2163,6 +2295,7 @@ init_service_account();
   fileExists,
   generateSignedUrl,
   getAdminAccessToken,
+  getAll,
   getAuth,
   getConfig,
   getDocument,
@@ -2178,9 +2311,12 @@ init_service_account();
   listFiles,
   listUsers,
   queryDocuments,
+  sendMessage,
   setCustomUserClaims,
   setDocument,
   signInWithCustomToken,
+  subscribeToTopic,
+  unsubscribeFromTopic,
   updateDocument,
   updateUser,
   uploadFile,

package/dist/index.mjs

@@ -1266,6 +1266,44 @@ async function queryDocuments(collectionPath, options) {
     data: convertFromFirestoreFormat(result.document.fields)
   }));
 }
+async function getAll(collectionPath, documentIds) {
+  if (documentIds.length === 0) return [];
+  if (documentIds.length > 100) {
+    throw new Error("getAll supports a maximum of 100 documents per request");
+  }
+  for (const id of documentIds) {
+    validateDocumentPath("collectionPath", collectionPath, id);
+  }
+  const accessToken = await getAdminAccessToken();
+  const projectId = getProjectId();
+  const basePath = `projects/${projectId}/databases/(default)/documents`;
+  const documents = documentIds.map((id) => `${basePath}/${collectionPath}/${id}`);
+  const url = `${FIRESTORE_API}/${basePath}:batchGet`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${accessToken}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ documents })
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to batch get documents: ${errorText}`);
+  }
+  const results = await response.json();
+  const resultMap = /* @__PURE__ */ new Map();
+  for (const result of results) {
+    if (result.found) {
+      const name = result.found.name;
+      const data = convertFromFirestoreFormat(result.found.fields);
+      resultMap.set(name, data);
+    } else if (result.missing) {
+      resultMap.set(result.missing, null);
+    }
+  }
+  return documents.map((docPath) => resultMap.get(docPath) ?? null);
+}
 async function batchWrite(operations) {
   const accessToken = await getAdminAccessToken();
   const projectId = getProjectId();
@@ -1891,6 +1929,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 accessToken = await getAdminAccessToken();
+  const projectId = getProjectId();
+  const url = `${FCM_BASE_URL}/projects/${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,
@@ -1908,6 +2034,7 @@ export {
   fileExists,
   generateSignedUrl,
   getAdminAccessToken,
+  getAll,
   getAuth,
   getConfig,
   getDocument,
@@ -1923,9 +2050,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.3",
+  "version": "2.7.0",
   "description": "Firebase Admin SDK for Cloudflare Workers and edge runtimes using REST APIs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",