@react-native-firebase/firestore 23.7.0 → 23.8.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [23.8.0](https://github.com/invertase/react-native-firebase/compare/v23.7.0...v23.8.0) (2026-01-13)
+
+### Features
+
+- **firestore:** add VectorValue type and vector() API ([8de9b68](https://github.com/invertase/react-native-firebase/commit/8de9b68dbe5288b7a5c05e607e34f9713f2d7fd2))
+
 ## [23.7.0](https://github.com/invertase/react-native-firebase/compare/v23.6.0...v23.7.0) (2025-12-08)
 
 **Note:** Version bump only for package @react-native-firebase/firestore

package/android/src/reactnative/java/io/invertase/firebase/firestore/ReactNativeFirebaseFirestoreSerialize.java

@@ -40,6 +40,7 @@ import com.google.firebase.firestore.GeoPoint;
 import com.google.firebase.firestore.MetadataChanges;
 import com.google.firebase.firestore.QuerySnapshot;
 import com.google.firebase.firestore.SnapshotMetadata;
+import com.google.firebase.firestore.VectorValue;
 import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
@@ -71,6 +72,7 @@ public class ReactNativeFirebaseFirestoreSerialize {
   private static final int INT_OBJECT = 16;
   private static final int INT_INTEGER = 17;
   private static final int INT_NEGATIVE_ZERO = 18;
+  private static final int INT_VECTOR = 19;
   private static final int INT_UNKNOWN = -999;
 
   // Keys
@@ -404,6 +406,12 @@ public class ReactNativeFirebaseFirestoreSerialize {
       return typeArray;
     }
 
+    if (value instanceof VectorValue) {
+      typeArray.pushInt(INT_VECTOR);
+      typeArray.pushArray(Arguments.fromArray(((VectorValue) value).toArray()));
+      return typeArray;
+    }
+
     Log.w(TAG, "Unknown object of type " + value.getClass());
 
     typeArray.pushInt(INT_UNKNOWN);
@@ -520,6 +528,12 @@ public class ReactNativeFirebaseFirestoreSerialize {
         }
       case INT_OBJECT:
         return parseReadableMap(firestore, typeArray.getMap(1));
+      case INT_VECTOR:
+        ReadableArray vals = typeArray.getArray(1);
+        int length = vals != null ? vals.size() : 0;
+        double[] doubles = new double[length];
+        for (int i = 0; i < length; i++) doubles[i] = vals.getDouble(i);
+        return FieldValue.vector(doubles);
       case INT_UNKNOWN:
       default:
         return null;

package/ios/RNFBFirestore/RNFBFirestoreSerialize.m

@@ -16,8 +16,10 @@
  *
  */
 
-#import "RNFBFirestoreSerialize.h"
+#import "FirebaseFirestore/FIRVectorValue.h"
+
 #import "RNFBFirestoreCommon.h"
+#import "RNFBFirestoreSerialize.h"
 #import "RNFBPreferences.h"
 
 @implementation RNFBFirestoreSerialize
@@ -58,6 +60,7 @@ enum TYPE_MAP {
   INT_OBJECT,
   INT_INTEGER,
   INT_NEGATIVE_ZERO,
+  INT_VECTOR,
   INT_UNKNOWN = -999,
 };
 
@@ -358,6 +361,14 @@ enum TYPE_MAP {
     return typeArray;
   }
 
+  // Vector
+  if ([value isKindOfClass:[FIRVectorValue class]]) {
+    FIRVectorValue *vector = (FIRVectorValue *)value;
+    typeArray[0] = @(INT_VECTOR);
+    typeArray[1] = vector.array;
+    return typeArray;
+  }
+
   typeArray[0] = @(INT_UNKNOWN);
   return typeArray;
 }
@@ -466,6 +477,8 @@ enum TYPE_MAP {
     }
     case INT_OBJECT:
       return [self parseNSDictionary:firestore dictionary:typeMap[1]];
+    case INT_VECTOR:
+      return [FIRFieldValue vectorWithArray:typeMap[1]];
     case INT_UNKNOWN:
     default:
       return nil;

package/lib/FirestoreStatics.js

@@ -23,6 +23,7 @@ import FirestoreFieldValue from './FirestoreFieldValue';
 import FirestoreGeoPoint from './FirestoreGeoPoint';
 import FirestoreTimestamp from './FirestoreTimestamp';
 import { Filter } from './FirestoreFilter';
+import FirestoreVectorValue from './FirestoreVectorValue';
 export default {
   Blob: FirestoreBlob,
   FieldPath: FirestoreFieldPath,
@@ -30,6 +31,10 @@ export default {
   GeoPoint: FirestoreGeoPoint,
   Timestamp: createDeprecationProxy(FirestoreTimestamp),
   Filter: createDeprecationProxy(Filter),
+  VectorValue: FirestoreVectorValue,
+  vector(values) {
+    return new FirestoreVectorValue(values);
+  },
 
   CACHE_SIZE_UNLIMITED: -1,
 

package/lib/FirestoreVectorValue.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+import { isArray, isNumber } from '@react-native-firebase/app/lib/common';
+
+export default class FirestoreVectorValue {
+  constructor(values) {
+    if (values === undefined) {
+      this._values = [];
+      return;
+    }
+
+    if (!isArray(values)) {
+      throw new Error(
+        "firebase.firestore.VectorValue(values?) 'values' expected an array of numbers or undefined.",
+      );
+    }
+
+    for (let i = 0; i < values.length; i++) {
+      const v = values[i];
+      if (!isNumber(v)) {
+        throw new Error(
+          `firebase.firestore.VectorValue(values?) 'values[${i}]' expected a number value.`,
+        );
+      }
+    }
+
+    // Store a shallow copy to ensure immutability semantics for the input array
+    this._values = values.slice();
+  }
+
+  static fromJSON(json) {
+    parsedVector = JSON.parse(json);
+    return new FirestoreVectorValue(parsedVector.vectorValues);
+  }
+
+  isEqual(other) {
+    if (!(other instanceof FirestoreVectorValue)) {
+      throw new Error(
+        "firebase.firestore.VectorValue.isEqual(*) 'other' expected a VectorValue instance.",
+      );
+    }
+
+    const a = this._values;
+    const b = other._values;
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      // Use strict equality; Firestore numbers allow NaN/Infinity – equality semantics match JS
+      if (a[i] !== b[i]) return false;
+    }
+    return true;
+  }
+
+  toArray() {
+    return this._values.slice();
+  }
+
+  toJSON() {
+    return { vectorValues: this._values.slice() };
+  }
+}

package/lib/index.d.ts

@@ -2127,6 +2127,7 @@ export namespace FirebaseFirestoreTypes {
      * @param logLevel The verbosity you set for activity and error logging.
      */
     setLogLevel(logLevel: 'debug' | 'error' | 'silent'): void;
+    SDK_VERSION: string;
   }
 
   /**
@@ -2147,6 +2148,11 @@ export namespace FirebaseFirestoreTypes {
    *
    */
   export class Module extends FirebaseModule {
+    /**
+     * The current `FirebaseApp` instance for this Firebase service.
+     */
+    app: ReactNativeFirebase.FirebaseApp;
+
     /**
      * Creates a write batch, used for performing multiple writes as a single atomic operation.
      * The maximum number of writes allowed in a single WriteBatch is 500, but note that each usage
@@ -2371,10 +2377,19 @@ export namespace FirebaseFirestoreTypes {
       : T;
 }
 
-declare const defaultExport: ReactNativeFirebase.FirebaseModuleWithStaticsAndApp<
+type FirestoreNamespace = ReactNativeFirebase.FirebaseModuleWithStaticsAndApp<
   FirebaseFirestoreTypes.Module,
   FirebaseFirestoreTypes.Statics
->;
+> & {
+  firestore: ReactNativeFirebase.FirebaseModuleWithStaticsAndApp<
+    FirebaseFirestoreTypes.Module,
+    FirebaseFirestoreTypes.Statics
+  >;
+  firebase: ReactNativeFirebase.Module;
+  app(name?: string): ReactNativeFirebase.FirebaseApp;
+};
+
+declare const defaultExport: FirestoreNamespace;
 
 export const firebase: ReactNativeFirebase.Module & {
   firestore: typeof defaultExport;

package/lib/modular/VectorValue.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Represents a vector type in Firestore documents. Create an instance with vector().
+ */
+export declare class VectorValue {
+  // Note the values array and constructor are not public APIs.
+
+  /**
+   * Builds a VectorValue instance from a JSON object created by VectorValue.toJSON().
+   *
+   * @param json a JSON object represention of a VectorValue instance.
+   */
+  static fromJSON(json: object): VectorValue;
+
+  /**
+   * Returns true if the two VectorValue values have the same raw number arrays, returns false otherwise.
+   */
+  isEqual(other: VectorValue): boolean;
+
+  /**
+   * Returns a copy of the raw number array form of the vector.
+   */
+  toArray(): number[];
+
+  /**
+   * Returns a JSON-serializable representation of this VectorValue instance.
+   */
+  toJSON(): { values: number[] };
+}
+
+export declare function vector(values?: number[]): VectorValue;

package/lib/modular/VectorValue.js

@@ -0,0 +1,11 @@
+import FirestoreVectorValue from '../FirestoreVectorValue';
+
+export const VectorValue = FirestoreVectorValue;
+
+/**
+ * @param {number[]=} values
+ * @returns {VectorValue}
+ */
+export function vector(values) {
+  return new VectorValue(values);
+}

package/lib/modular/index.d.ts

@@ -785,3 +785,4 @@ export * from './FieldPath';
 export * from './FieldValue';
 export * from './GeoPoint';
 export * from './Timestamp';
+export * from './VectorValue';

package/lib/modular/index.js

@@ -407,4 +407,5 @@ export * from './FieldPath';
 export * from './FieldValue';
 export * from './GeoPoint';
 export * from './Timestamp';
+export * from './VectorValue';
 export { Filter } from '../FirestoreFilter';

package/lib/utils/serialize.js

@@ -32,6 +32,7 @@ import FirestorePath from '../FirestorePath';
 import FirestoreTimestamp from '../FirestoreTimestamp';
 import { getTypeMapInt, getTypeMapName } from './typemap';
 import { Bytes } from '../modular/Bytes';
+import FirestoreVectorValue from '../FirestoreVectorValue';
 
 // To avoid React Native require cycle warnings
 let FirestoreDocumentReference = null;
@@ -189,6 +190,10 @@ export function generateNativeData(value, ignoreUndefined) {
       return getTypeMapInt('fieldvalue', [value._type, value._elements]);
     }
 
+    if (value instanceof FirestoreVectorValue) {
+      return getTypeMapInt('vector', value.toArray());
+    }
+
     return getTypeMapInt('object', buildNativeMap(value, ignoreUndefined));
   }
 
@@ -279,6 +284,8 @@ export function parseNativeData(firestore, nativeArray) {
       return new FirestoreTimestamp(value[0], value[1]);
     case 'blob':
       return Bytes.fromBase64String(value);
+    case 'vector':
+      return new FirestoreVectorValue(value);
     default:
       // eslint-disable-next-line no-console
       console.warn(`Unknown data type received from native channel: ${type}`);

package/lib/utils/typemap.js

@@ -37,6 +37,7 @@ const MAP = {
   object: 16,
   integer: 17,
   negativeZero: 18,
+  vector: 19,
   unknown: -999,
 };
 

package/lib/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-module.exports = '23.7.0';
+module.exports = '23.8.0';

package/lib/web/convert.js

@@ -10,6 +10,8 @@ import {
   deleteField,
   arrayUnion,
   arrayRemove,
+  vector,
+  VectorValue,
 } from '@react-native-firebase/app/lib/internal/web/firebaseFirestore';
 
 const INT_NAN = 0;
@@ -31,6 +33,7 @@ const INT_FIELDVALUE = 15;
 const INT_OBJECT = 16;
 const INT_INTEGER = 17;
 const INT_NEGATIVE_ZERO = 18;
+const INT_VECTOR = 19;
 const INT_UNKNOWN = -999;
 
 const TYPE = 'type';
@@ -175,6 +178,12 @@ export function buildTypeMap(value) {
     return out;
   }
 
+  if (value instanceof VectorValue) {
+    out.push(INT_VECTOR);
+    out.push(value.toArray());
+    return out;
+  }
+
   if (typeof value === 'object') {
     out.push(INT_OBJECT);
     out.push(objectToWriteable(value));
@@ -253,6 +262,8 @@ export function parseTypeMap(firestore, typedArray) {
       }
     case INT_OBJECT:
       return readableToObject(firestore, typedArray[1]);
+    case INT_VECTOR:
+      return vector(typedArray[1]);
     case INT_UNKNOWN:
     default:
       return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/firestore",
-  "version": "23.7.0",
+  "version": "23.8.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Firebase - Cloud Firestore is a NoSQL cloud database to store and sync data between your React Native application and Firebase's database. The API matches the Firebase Web SDK whilst taking advantage of the native SDKs performance and offline capabilities.",
   "main": "lib/index.js",
@@ -30,11 +30,11 @@
     "react-native-url-polyfill": "3.0.0"
   },
   "peerDependencies": {
-    "@react-native-firebase/app": "23.7.0"
+    "@react-native-firebase/app": "23.8.0"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "gitHead": "2a30c0b1e41a2b239172afd167f98a03fd422f2c"
+  "gitHead": "724ddcfea6ebe93875e5a54ff38ca57ab5990822"
 }