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

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.8.0] - 2026-03-12
+
+### Added
+- **Firestore Batch Get by Paths (`getAllByPaths`)**: Fetch multiple documents from different collections in a single REST API call
+  - `getAllByPaths([{ collection, id }])` - Batch get up to 100 documents from arbitrary paths via `documents:batchGet` endpoint
+  - Returns results in the same order as input refs
+  - Missing documents return `null` (no throw)
+  - Supports subcollection paths (e.g., `users/uid1/profile`)
+  - 7 unit tests + 3 e2e tests
+
 ## [2.7.0] - 2026-03-12
 
 ### Added
@@ -16,6 +26,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Supports subcollection paths
   - 8 unit tests + 5 e2e tests
 
+### Fixed
+- **FCM**: `sendMessage` now uses `getProjectId()` instead of `getConfig().projectId`, fixing silent failure when `initializeApp()` hasn't been called (falls back to `FIREBASE_PROJECT_ID` env var)
+
 ### Changed
 - Total unit tests increased from 498 to 506 (+8 tests)
 

package/dist/index.d.mts

@@ -656,6 +656,26 @@ declare function queryDocuments(collectionPath: string, options?: QueryOptions):
  * ```
  */
 declare function getAll(collectionPath: string, documentIds: string[]): Promise<(DataObject | null)[]>;
+/**
+ * Batch get multiple documents from different collections by their full paths
+ * Uses the documents:batchGet REST API endpoint
+ *
+ * @param documentRefs - Array of { collection, id } tuples pointing to documents (max 100)
+ * @returns Array of results in the same order as documentRefs. Missing documents return null.
+ * @throws {Error} If the operation fails or more than 100 documents requested
+ *
+ * @example
+ * ```typescript
+ * const docs = await getAllByPaths([
+ *   { collection: 'users/uid1/profile', id: 'default' },
+ *   { collection: 'users/uid2/profile', id: 'default' },
+ * ]);
+ * ```
+ */
+declare function getAllByPaths(documentRefs: Array<{
+    collection: string;
+    id: string;
+}>): Promise<(DataObject | null)[]>;
 /**
  * Perform batch write operations (set, update, delete)
  *
@@ -1266,4 +1286,4 @@ declare function getAdminAccessToken(): Promise<string>;
  */
 declare function clearTokenCache(): void;
 
-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 };
+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, getAllByPaths, 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

@@ -656,6 +656,26 @@ declare function queryDocuments(collectionPath: string, options?: QueryOptions):
  * ```
  */
 declare function getAll(collectionPath: string, documentIds: string[]): Promise<(DataObject | null)[]>;
+/**
+ * Batch get multiple documents from different collections by their full paths
+ * Uses the documents:batchGet REST API endpoint
+ *
+ * @param documentRefs - Array of { collection, id } tuples pointing to documents (max 100)
+ * @returns Array of results in the same order as documentRefs. Missing documents return null.
+ * @throws {Error} If the operation fails or more than 100 documents requested
+ *
+ * @example
+ * ```typescript
+ * const docs = await getAllByPaths([
+ *   { collection: 'users/uid1/profile', id: 'default' },
+ *   { collection: 'users/uid2/profile', id: 'default' },
+ * ]);
+ * ```
+ */
+declare function getAllByPaths(documentRefs: Array<{
+    collection: string;
+    id: string;
+}>): Promise<(DataObject | null)[]>;
 /**
  * Perform batch write operations (set, update, delete)
  *
@@ -1266,4 +1286,4 @@ declare function getAdminAccessToken(): Promise<string>;
  */
 declare function clearTokenCache(): void;
 
-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 };
+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, getAllByPaths, 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

@@ -217,6 +217,7 @@ __export(index_exports, {
   generateSignedUrl: () => generateSignedUrl,
   getAdminAccessToken: () => getAdminAccessToken,
   getAll: () => getAll,
+  getAllByPaths: () => getAllByPaths,
   getAuth: () => getAuth,
   getConfig: () => getConfig,
   getDocument: () => getDocument,
@@ -1553,6 +1554,44 @@ async function getAll(collectionPath, documentIds) {
   }
   return documents.map((docPath) => resultMap.get(docPath) ?? null);
 }
+async function getAllByPaths(documentRefs) {
+  if (documentRefs.length === 0) return [];
+  if (documentRefs.length > 100) {
+    throw new Error("getAllByPaths supports a maximum of 100 documents per request");
+  }
+  for (const ref of documentRefs) {
+    validateDocumentPath("collection", ref.collection, ref.id);
+  }
+  const accessToken = await getAdminAccessToken();
+  const projectId = getProjectId();
+  const basePath = `projects/${projectId}/databases/(default)/documents`;
+  const documents = documentRefs.map((ref) => `${basePath}/${ref.collection}/${ref.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();
@@ -2296,6 +2335,7 @@ init_service_account();
   generateSignedUrl,
   getAdminAccessToken,
   getAll,
+  getAllByPaths,
   getAuth,
   getConfig,
   getDocument,

package/dist/index.mjs

@@ -1304,6 +1304,44 @@ async function getAll(collectionPath, documentIds) {
   }
   return documents.map((docPath) => resultMap.get(docPath) ?? null);
 }
+async function getAllByPaths(documentRefs) {
+  if (documentRefs.length === 0) return [];
+  if (documentRefs.length > 100) {
+    throw new Error("getAllByPaths supports a maximum of 100 documents per request");
+  }
+  for (const ref of documentRefs) {
+    validateDocumentPath("collection", ref.collection, ref.id);
+  }
+  const accessToken = await getAdminAccessToken();
+  const projectId = getProjectId();
+  const basePath = `projects/${projectId}/databases/(default)/documents`;
+  const documents = documentRefs.map((ref) => `${basePath}/${ref.collection}/${ref.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();
@@ -2035,6 +2073,7 @@ export {
   generateSignedUrl,
   getAdminAccessToken,
   getAll,
+  getAllByPaths,
   getAuth,
   getConfig,
   getDocument,

package/package.json

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