@prmichaelsen/firebase-admin-sdk-v8 2.0.17 → 2.0.19

package/dist/index.d.mts

@@ -287,18 +287,18 @@ declare function getUserFromToken(idToken: string): Promise<UserInfo>;
 declare function getAuth(): any;
 
 /**
- * Firebase Admin SDK v8 - Firestore REST API
- * Provides CRUD operations for Firestore using REST API
+ * Firebase Admin SDK v8 - Firestore CRUD Operations
+ * All Firestore document operations using REST API
  */
 
 /**
  * Set a document in Firestore (create or overwrite)
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @param {DataObject} data - Document data
- * @param {SetOptions} [options] - Set options (merge, mergeFields)
- * @returns {Promise<void>}
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @param data - Document data
+ * @param options - Set options (merge, mergeFields)
+ * @returns Promise that resolves when document is set
  * @throws {Error} If the operation fails
  *
  * @example
@@ -317,10 +317,10 @@ declare function setDocument(collectionPath: string, documentId: string, data: D
 /**
  * Add a document to Firestore collection
  *
- * @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<DocumentReference>} Document reference with id and path
+ * @param collectionPath - Collection path (e.g., 'users' or 'users/uid/posts')
+ * @param data - Document data
+ * @param documentId - Optional document ID (auto-generated if not provided)
+ * @returns Document reference with id and path
  * @throws {Error} If the operation fails
  *
  * @example
@@ -337,9 +337,9 @@ declare function addDocument(collectionPath: string, data: DataObject, documentI
 /**
  * Get a document from Firestore
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @returns {Promise<DataObject | null>} Document data or null if not found
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @returns Document data or null if not found
  * @throws {Error} If the operation fails
  *
  * @example
@@ -354,10 +354,10 @@ declare function getDocument(collectionPath: string, documentId: string): Promis
 /**
  * Update a document in Firestore
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @param {DataObject} data - Data to update
- * @returns {Promise<void>}
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @param data - Data to update
+ * @returns Promise that resolves when document is updated
  * @throws {Error} If the operation fails
  *
  * @example
@@ -372,9 +372,9 @@ declare function updateDocument(collectionPath: string, documentId: string, data
 /**
  * Delete a document from Firestore
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @returns {Promise<void>}
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @returns Promise that resolves when document is deleted
  * @throws {Error} If the operation fails
  *
  * @example
@@ -386,9 +386,9 @@ declare function deleteDocument(collectionPath: string, documentId: string): Pro
 /**
  * Query documents in a collection with advanced filtering
  *
- * @param {string} collectionPath - Collection path
- * @param {QueryOptions} [options] - Query options (where, orderBy, limit, etc.)
- * @returns {Promise<Array<{ id: string; data: DataObject }>>} Array of documents
+ * @param collectionPath - Collection path
+ * @param options - Query options (where, orderBy, limit, etc.)
+ * @returns Array of documents with id and data
  * @throws {Error} If the operation fails
  *
  * @example
@@ -410,8 +410,8 @@ declare function queryDocuments(collectionPath: string, options?: QueryOptions):
 /**
  * Perform batch write operations (set, update, delete)
  *
- * @param {BatchWrite[]} operations - Array of batch operations
- * @returns {Promise<BatchWriteResult>} Batch write result
+ * @param operations - Array of batch operations
+ * @returns Batch write result
  * @throws {Error} If the operation fails
  *
  * @example

package/dist/index.d.ts

@@ -287,18 +287,18 @@ declare function getUserFromToken(idToken: string): Promise<UserInfo>;
 declare function getAuth(): any;
 
 /**
- * Firebase Admin SDK v8 - Firestore REST API
- * Provides CRUD operations for Firestore using REST API
+ * Firebase Admin SDK v8 - Firestore CRUD Operations
+ * All Firestore document operations using REST API
  */
 
 /**
  * Set a document in Firestore (create or overwrite)
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @param {DataObject} data - Document data
- * @param {SetOptions} [options] - Set options (merge, mergeFields)
- * @returns {Promise<void>}
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @param data - Document data
+ * @param options - Set options (merge, mergeFields)
+ * @returns Promise that resolves when document is set
  * @throws {Error} If the operation fails
  *
  * @example
@@ -317,10 +317,10 @@ declare function setDocument(collectionPath: string, documentId: string, data: D
 /**
  * Add a document to Firestore collection
  *
- * @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<DocumentReference>} Document reference with id and path
+ * @param collectionPath - Collection path (e.g., 'users' or 'users/uid/posts')
+ * @param data - Document data
+ * @param documentId - Optional document ID (auto-generated if not provided)
+ * @returns Document reference with id and path
  * @throws {Error} If the operation fails
  *
  * @example
@@ -337,9 +337,9 @@ declare function addDocument(collectionPath: string, data: DataObject, documentI
 /**
  * Get a document from Firestore
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @returns {Promise<DataObject | null>} Document data or null if not found
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @returns Document data or null if not found
  * @throws {Error} If the operation fails
  *
  * @example
@@ -354,10 +354,10 @@ declare function getDocument(collectionPath: string, documentId: string): Promis
 /**
  * Update a document in Firestore
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @param {DataObject} data - Data to update
- * @returns {Promise<void>}
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @param data - Data to update
+ * @returns Promise that resolves when document is updated
  * @throws {Error} If the operation fails
  *
  * @example
@@ -372,9 +372,9 @@ declare function updateDocument(collectionPath: string, documentId: string, data
 /**
  * Delete a document from Firestore
  *
- * @param {string} collectionPath - Collection path
- * @param {string} documentId - Document ID
- * @returns {Promise<void>}
+ * @param collectionPath - Collection path
+ * @param documentId - Document ID
+ * @returns Promise that resolves when document is deleted
  * @throws {Error} If the operation fails
  *
  * @example
@@ -386,9 +386,9 @@ declare function deleteDocument(collectionPath: string, documentId: string): Pro
 /**
  * Query documents in a collection with advanced filtering
  *
- * @param {string} collectionPath - Collection path
- * @param {QueryOptions} [options] - Query options (where, orderBy, limit, etc.)
- * @returns {Promise<Array<{ id: string; data: DataObject }>>} Array of documents
+ * @param collectionPath - Collection path
+ * @param options - Query options (where, orderBy, limit, etc.)
+ * @returns Array of documents with id and data
  * @throws {Error} If the operation fails
  *
  * @example
@@ -410,8 +410,8 @@ declare function queryDocuments(collectionPath: string, options?: QueryOptions):
 /**
  * Perform batch write operations (set, update, delete)
  *
- * @param {BatchWrite[]} operations - Array of batch operations
- * @returns {Promise<BatchWriteResult>} Batch write result
+ * @param operations - Array of batch operations
+ * @returns Batch write result
  * @throws {Error} If the operation fails
  *
  * @example

package/dist/index.js

@@ -331,78 +331,6 @@ function getAuth() {
   };
 }
 
-// src/token-generation.ts
-function base64UrlEncode(str) {
-  return btoa(str).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
-}
-function base64UrlEncodeBuffer(buffer) {
-  return btoa(String.fromCharCode(...buffer)).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
-}
-async function createJWT(serviceAccount) {
-  const now = Math.floor(Date.now() / 1e3);
-  const expiry = now + 3600;
-  const header = {
-    alg: "RS256",
-    typ: "JWT"
-  };
-  const payload = {
-    iss: serviceAccount.client_email,
-    sub: serviceAccount.client_email,
-    aud: serviceAccount.token_uri,
-    iat: now,
-    exp: expiry,
-    scope: "https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/datastore https://www.googleapis.com/auth/firebase"
-  };
-  const encodedHeader = base64UrlEncode(JSON.stringify(header));
-  const encodedPayload = base64UrlEncode(JSON.stringify(payload));
-  const unsignedToken = `${encodedHeader}.${encodedPayload}`;
-  const pemContents = serviceAccount.private_key.replace("-----BEGIN PRIVATE KEY-----", "").replace("-----END PRIVATE KEY-----", "").replace(/\s/g, "");
-  const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
-  const cryptoKey = await crypto.subtle.importKey(
-    "pkcs8",
-    binaryDer,
-    { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" },
-    false,
-    ["sign"]
-  );
-  const signature = await crypto.subtle.sign(
-    "RSASSA-PKCS1-v1_5",
-    cryptoKey,
-    new TextEncoder().encode(unsignedToken)
-  );
-  const encodedSignature = base64UrlEncodeBuffer(new Uint8Array(signature));
-  return `${unsignedToken}.${encodedSignature}`;
-}
-var cachedAccessToken = null;
-var tokenExpiry = 0;
-async function getAdminAccessToken() {
-  if (cachedAccessToken && Date.now() < tokenExpiry) {
-    return cachedAccessToken;
-  }
-  const serviceAccount = getServiceAccount();
-  const jwt = await createJWT(serviceAccount);
-  const response = await fetch(serviceAccount.token_uri, {
-    method: "POST",
-    headers: { "Content-Type": "application/x-www-form-urlencoded" },
-    body: new URLSearchParams({
-      grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
-      assertion: jwt
-    })
-  });
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`Failed to get access token: ${errorText}`);
-  }
-  const data = await response.json();
-  cachedAccessToken = data.access_token;
-  tokenExpiry = Date.now() + data.expires_in * 1e3 - 6e4;
-  return cachedAccessToken;
-}
-function clearTokenCache() {
-  cachedAccessToken = null;
-  tokenExpiry = 0;
-}
-
 // src/field-value.ts
 function serverTimestamp() {
   return {
@@ -679,7 +607,79 @@ function removeFieldTransforms(data) {
   return result;
 }
 
-// src/firestore-rest.ts
+// src/token-generation.ts
+function base64UrlEncode(str) {
+  return btoa(str).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+function base64UrlEncodeBuffer(buffer) {
+  return btoa(String.fromCharCode(...buffer)).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+async function createJWT(serviceAccount) {
+  const now = Math.floor(Date.now() / 1e3);
+  const expiry = now + 3600;
+  const header = {
+    alg: "RS256",
+    typ: "JWT"
+  };
+  const payload = {
+    iss: serviceAccount.client_email,
+    sub: serviceAccount.client_email,
+    aud: serviceAccount.token_uri,
+    iat: now,
+    exp: expiry,
+    scope: "https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/datastore https://www.googleapis.com/auth/firebase"
+  };
+  const encodedHeader = base64UrlEncode(JSON.stringify(header));
+  const encodedPayload = base64UrlEncode(JSON.stringify(payload));
+  const unsignedToken = `${encodedHeader}.${encodedPayload}`;
+  const pemContents = serviceAccount.private_key.replace("-----BEGIN PRIVATE KEY-----", "").replace("-----END PRIVATE KEY-----", "").replace(/\s/g, "");
+  const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
+  const cryptoKey = await crypto.subtle.importKey(
+    "pkcs8",
+    binaryDer,
+    { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const signature = await crypto.subtle.sign(
+    "RSASSA-PKCS1-v1_5",
+    cryptoKey,
+    new TextEncoder().encode(unsignedToken)
+  );
+  const encodedSignature = base64UrlEncodeBuffer(new Uint8Array(signature));
+  return `${unsignedToken}.${encodedSignature}`;
+}
+var cachedAccessToken = null;
+var tokenExpiry = 0;
+async function getAdminAccessToken() {
+  if (cachedAccessToken && Date.now() < tokenExpiry) {
+    return cachedAccessToken;
+  }
+  const serviceAccount = getServiceAccount();
+  const jwt = await createJWT(serviceAccount);
+  const response = await fetch(serviceAccount.token_uri, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
+      assertion: jwt
+    })
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to get access token: ${errorText}`);
+  }
+  const data = await response.json();
+  cachedAccessToken = data.access_token;
+  tokenExpiry = Date.now() + data.expires_in * 1e3 - 6e4;
+  return cachedAccessToken;
+}
+function clearTokenCache() {
+  cachedAccessToken = null;
+  tokenExpiry = 0;
+}
+
+// src/firestore/operations.ts
 var FIRESTORE_API = "https://firestore.googleapis.com/v1";
 async function commitWrites(writes) {
   const accessToken = await getAdminAccessToken();

package/dist/index.mjs

@@ -288,78 +288,6 @@ function getAuth() {
   };
 }
 
-// src/token-generation.ts
-function base64UrlEncode(str) {
-  return btoa(str).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
-}
-function base64UrlEncodeBuffer(buffer) {
-  return btoa(String.fromCharCode(...buffer)).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
-}
-async function createJWT(serviceAccount) {
-  const now = Math.floor(Date.now() / 1e3);
-  const expiry = now + 3600;
-  const header = {
-    alg: "RS256",
-    typ: "JWT"
-  };
-  const payload = {
-    iss: serviceAccount.client_email,
-    sub: serviceAccount.client_email,
-    aud: serviceAccount.token_uri,
-    iat: now,
-    exp: expiry,
-    scope: "https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/datastore https://www.googleapis.com/auth/firebase"
-  };
-  const encodedHeader = base64UrlEncode(JSON.stringify(header));
-  const encodedPayload = base64UrlEncode(JSON.stringify(payload));
-  const unsignedToken = `${encodedHeader}.${encodedPayload}`;
-  const pemContents = serviceAccount.private_key.replace("-----BEGIN PRIVATE KEY-----", "").replace("-----END PRIVATE KEY-----", "").replace(/\s/g, "");
-  const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
-  const cryptoKey = await crypto.subtle.importKey(
-    "pkcs8",
-    binaryDer,
-    { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" },
-    false,
-    ["sign"]
-  );
-  const signature = await crypto.subtle.sign(
-    "RSASSA-PKCS1-v1_5",
-    cryptoKey,
-    new TextEncoder().encode(unsignedToken)
-  );
-  const encodedSignature = base64UrlEncodeBuffer(new Uint8Array(signature));
-  return `${unsignedToken}.${encodedSignature}`;
-}
-var cachedAccessToken = null;
-var tokenExpiry = 0;
-async function getAdminAccessToken() {
-  if (cachedAccessToken && Date.now() < tokenExpiry) {
-    return cachedAccessToken;
-  }
-  const serviceAccount = getServiceAccount();
-  const jwt = await createJWT(serviceAccount);
-  const response = await fetch(serviceAccount.token_uri, {
-    method: "POST",
-    headers: { "Content-Type": "application/x-www-form-urlencoded" },
-    body: new URLSearchParams({
-      grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
-      assertion: jwt
-    })
-  });
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`Failed to get access token: ${errorText}`);
-  }
-  const data = await response.json();
-  cachedAccessToken = data.access_token;
-  tokenExpiry = Date.now() + data.expires_in * 1e3 - 6e4;
-  return cachedAccessToken;
-}
-function clearTokenCache() {
-  cachedAccessToken = null;
-  tokenExpiry = 0;
-}
-
 // src/field-value.ts
 function serverTimestamp() {
   return {
@@ -636,7 +564,79 @@ function removeFieldTransforms(data) {
   return result;
 }
 
-// src/firestore-rest.ts
+// src/token-generation.ts
+function base64UrlEncode(str) {
+  return btoa(str).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+function base64UrlEncodeBuffer(buffer) {
+  return btoa(String.fromCharCode(...buffer)).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+async function createJWT(serviceAccount) {
+  const now = Math.floor(Date.now() / 1e3);
+  const expiry = now + 3600;
+  const header = {
+    alg: "RS256",
+    typ: "JWT"
+  };
+  const payload = {
+    iss: serviceAccount.client_email,
+    sub: serviceAccount.client_email,
+    aud: serviceAccount.token_uri,
+    iat: now,
+    exp: expiry,
+    scope: "https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/datastore https://www.googleapis.com/auth/firebase"
+  };
+  const encodedHeader = base64UrlEncode(JSON.stringify(header));
+  const encodedPayload = base64UrlEncode(JSON.stringify(payload));
+  const unsignedToken = `${encodedHeader}.${encodedPayload}`;
+  const pemContents = serviceAccount.private_key.replace("-----BEGIN PRIVATE KEY-----", "").replace("-----END PRIVATE KEY-----", "").replace(/\s/g, "");
+  const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
+  const cryptoKey = await crypto.subtle.importKey(
+    "pkcs8",
+    binaryDer,
+    { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const signature = await crypto.subtle.sign(
+    "RSASSA-PKCS1-v1_5",
+    cryptoKey,
+    new TextEncoder().encode(unsignedToken)
+  );
+  const encodedSignature = base64UrlEncodeBuffer(new Uint8Array(signature));
+  return `${unsignedToken}.${encodedSignature}`;
+}
+var cachedAccessToken = null;
+var tokenExpiry = 0;
+async function getAdminAccessToken() {
+  if (cachedAccessToken && Date.now() < tokenExpiry) {
+    return cachedAccessToken;
+  }
+  const serviceAccount = getServiceAccount();
+  const jwt = await createJWT(serviceAccount);
+  const response = await fetch(serviceAccount.token_uri, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
+      assertion: jwt
+    })
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to get access token: ${errorText}`);
+  }
+  const data = await response.json();
+  cachedAccessToken = data.access_token;
+  tokenExpiry = Date.now() + data.expires_in * 1e3 - 6e4;
+  return cachedAccessToken;
+}
+function clearTokenCache() {
+  cachedAccessToken = null;
+  tokenExpiry = 0;
+}
+
+// src/firestore/operations.ts
 var FIRESTORE_API = "https://firestore.googleapis.com/v1";
 async function commitWrites(writes) {
   const accessToken = await getAdminAccessToken();

package/package.json

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