@prmichaelsen/firebase-admin-sdk-v8 2.0.6 → 2.0.8

package/dist/index.d.mts

@@ -91,6 +91,15 @@ interface FirestoreDocument {
  * Generic data object
  */
 type DataObject = Record<string, any>;
+/**
+ * Document reference (simplified version for REST API)
+ */
+interface DocumentReference {
+    /** Document ID */
+    id: string;
+    /** Collection path */
+    path: string;
+}
 /**
  * Set options for document writes
  */
@@ -311,19 +320,20 @@ declare function setDocument(collectionPath: string, documentId: string, data: D
  * @param {string} collectionPath - Collection path (e.g., 'users' or 'users/uid/posts')
  * @param {DataObject} data - Document data
  * @param {string} [documentId] - Optional document ID (auto-generated if not provided)
- * @returns {Promise<string>} Created document ID
+ * @returns {Promise<DocumentReference>} Document reference with id and path
  * @throws {Error} If the operation fails
  *
  * @example
  * ```typescript
- * const docId = await addDocument('users', {
+ * const docRef = await addDocument('users', {
  *   name: 'John Doe',
  *   email: 'john@example.com',
  *   createdAt: new Date()
  * });
+ * console.log('Created document:', docRef.id);
  * ```
  */
-declare function addDocument(collectionPath: string, data: DataObject, documentId?: string): Promise<string>;
+declare function addDocument(collectionPath: string, data: DataObject, documentId?: string): Promise<DocumentReference>;
 /**
  * Get a document from Firestore
  *
@@ -512,4 +522,4 @@ declare function getAdminAccessToken(): Promise<string>;
  */
 declare function clearTokenCache(): void;
 
-export { type BatchWrite, type BatchWriteResult, type DataObject, type DecodedIdToken, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FirestoreDocument, type FirestoreValue, type QueryFilter, type QueryOptions, type QueryOrder, type ServiceAccount, type SetOptions, type TokenResponse, type UpdateOptions, type UserInfo, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, deleteDocument, getAdminAccessToken, getAuth, getConfig, getDocument, getProjectId, getServiceAccount, getUserFromToken, initializeApp, queryDocuments, setDocument, updateDocument, verifyIdToken };
+export { type BatchWrite, type BatchWriteResult, type DataObject, type DecodedIdToken, type DocumentReference, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FirestoreDocument, type FirestoreValue, type QueryFilter, type QueryOptions, type QueryOrder, type ServiceAccount, type SetOptions, type TokenResponse, type UpdateOptions, type UserInfo, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, deleteDocument, getAdminAccessToken, getAuth, getConfig, getDocument, getProjectId, getServiceAccount, getUserFromToken, initializeApp, queryDocuments, setDocument, updateDocument, verifyIdToken };

package/dist/index.d.ts

@@ -91,6 +91,15 @@ interface FirestoreDocument {
  * Generic data object
  */
 type DataObject = Record<string, any>;
+/**
+ * Document reference (simplified version for REST API)
+ */
+interface DocumentReference {
+    /** Document ID */
+    id: string;
+    /** Collection path */
+    path: string;
+}
 /**
  * Set options for document writes
  */
@@ -311,19 +320,20 @@ declare function setDocument(collectionPath: string, documentId: string, data: D
  * @param {string} collectionPath - Collection path (e.g., 'users' or 'users/uid/posts')
  * @param {DataObject} data - Document data
  * @param {string} [documentId] - Optional document ID (auto-generated if not provided)
- * @returns {Promise<string>} Created document ID
+ * @returns {Promise<DocumentReference>} Document reference with id and path
  * @throws {Error} If the operation fails
  *
  * @example
  * ```typescript
- * const docId = await addDocument('users', {
+ * const docRef = await addDocument('users', {
  *   name: 'John Doe',
  *   email: 'john@example.com',
  *   createdAt: new Date()
  * });
+ * console.log('Created document:', docRef.id);
  * ```
  */
-declare function addDocument(collectionPath: string, data: DataObject, documentId?: string): Promise<string>;
+declare function addDocument(collectionPath: string, data: DataObject, documentId?: string): Promise<DocumentReference>;
 /**
  * Get a document from Firestore
  *
@@ -512,4 +522,4 @@ declare function getAdminAccessToken(): Promise<string>;
  */
 declare function clearTokenCache(): void;
 
-export { type BatchWrite, type BatchWriteResult, type DataObject, type DecodedIdToken, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FirestoreDocument, type FirestoreValue, type QueryFilter, type QueryOptions, type QueryOrder, type ServiceAccount, type SetOptions, type TokenResponse, type UpdateOptions, type UserInfo, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, deleteDocument, getAdminAccessToken, getAuth, getConfig, getDocument, getProjectId, getServiceAccount, getUserFromToken, initializeApp, queryDocuments, setDocument, updateDocument, verifyIdToken };
+export { type BatchWrite, type BatchWriteResult, type DataObject, type DecodedIdToken, type DocumentReference, FieldValue, type FieldValue$1 as FieldValueSentinel, FieldValueType, type FirestoreDocument, type FirestoreValue, type QueryFilter, type QueryOptions, type QueryOrder, type ServiceAccount, type SetOptions, type TokenResponse, type UpdateOptions, type UserInfo, type WhereFilterOp, addDocument, batchWrite, clearConfig, clearTokenCache, deleteDocument, getAdminAccessToken, getAuth, getConfig, getDocument, getProjectId, getServiceAccount, getUserFromToken, initializeApp, queryDocuments, setDocument, updateDocument, verifyIdToken };

package/dist/index.js

@@ -722,7 +722,11 @@ async function addDocument(collectionPath, data, documentId) {
     throw new Error(`Failed to add document: ${errorText}`);
   }
   const result = await response.json();
-  return result.name.split("/").pop();
+  const docId = result.name.split("/").pop();
+  return {
+    id: docId,
+    path: `${collectionPath}/${docId}`
+  };
 }
 async function getDocument(collectionPath, documentId) {
   const accessToken = await getAdminAccessToken();

package/dist/index.mjs

@@ -679,7 +679,11 @@ async function addDocument(collectionPath, data, documentId) {
     throw new Error(`Failed to add document: ${errorText}`);
   }
   const result = await response.json();
-  return result.name.split("/").pop();
+  const docId = result.name.split("/").pop();
+  return {
+    id: docId,
+    path: `${collectionPath}/${docId}`
+  };
 }
 async function getDocument(collectionPath, documentId) {
   const accessToken = await getAdminAccessToken();

package/package.json

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