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

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(./agent/scripts/acp.version-check-for-updates.sh:*)",
+      "Bash(test:*)",
+      "Bash(ls:*)",
+      "Bash(git add:*)"
+    ]
+  }
+}

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.5.2] - 2026-03-03
+
+### Fixed
+- **Firestore Query**: Fixed null/undefined and NaN value queries in Firestore
+- Added support for `where('field', '==', null)` queries using `unaryFilter` with `IS_NULL` operator
+- Added support for `where('field', '==', NaN)` queries using `unaryFilter` with `IS_NAN` operator
+- Previously, null/NaN queries would fail because they incorrectly used `fieldFilter` instead of `unaryFilter`
+- Firestore REST API requires `unaryFilter` for these special value comparisons
+- All 463 tests passing with fix
+
 ## [2.5.1] - 2026-02-24
 
 ### Fixed

package/dist/index.js

@@ -1100,13 +1100,31 @@ function buildStructuredQuery(collectionPath, options) {
     from: [fromClause]
   };
   if (options?.where && options.where.length > 0) {
-    const filters = options.where.map((filter) => ({
-      fieldFilter: {
-        field: { fieldPath: filter.field },
-        op: mapWhereOp(filter.op),
-        value: toFirestoreValue(filter.value)
+    const filters = options.where.map((filter) => {
+      if ((filter.value === null || filter.value === void 0) && filter.op === "==") {
+        return {
+          unaryFilter: {
+            field: { fieldPath: filter.field },
+            op: "IS_NULL"
+          }
+        };
       }
-    }));
+      if (filter.value !== filter.value && filter.op === "==") {
+        return {
+          unaryFilter: {
+            field: { fieldPath: filter.field },
+            op: "IS_NAN"
+          }
+        };
+      }
+      return {
+        fieldFilter: {
+          field: { fieldPath: filter.field },
+          op: mapWhereOp(filter.op),
+          value: toFirestoreValue(filter.value)
+        }
+      };
+    });
     if (filters.length === 1) {
       query.where = filters[0];
     } else {

package/dist/index.mjs

@@ -859,13 +859,31 @@ function buildStructuredQuery(collectionPath, options) {
     from: [fromClause]
   };
   if (options?.where && options.where.length > 0) {
-    const filters = options.where.map((filter) => ({
-      fieldFilter: {
-        field: { fieldPath: filter.field },
-        op: mapWhereOp(filter.op),
-        value: toFirestoreValue(filter.value)
+    const filters = options.where.map((filter) => {
+      if ((filter.value === null || filter.value === void 0) && filter.op === "==") {
+        return {
+          unaryFilter: {
+            field: { fieldPath: filter.field },
+            op: "IS_NULL"
+          }
+        };
       }
-    }));
+      if (filter.value !== filter.value && filter.op === "==") {
+        return {
+          unaryFilter: {
+            field: { fieldPath: filter.field },
+            op: "IS_NAN"
+          }
+        };
+      }
+      return {
+        fieldFilter: {
+          field: { fieldPath: filter.field },
+          op: mapWhereOp(filter.op),
+          value: toFirestoreValue(filter.value)
+        }
+      };
+    });
     if (filters.length === 1) {
       query.where = filters[0];
     } else {

package/package.json

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