@firebase/firestore-types

Document Data Typing

This feature allows developers to extend the DocumentData type to define custom types for their documents, ensuring type safety when manipulating Firestore documents.

import { DocumentData } from '@firebase/firestore-types';

interface User extends DocumentData {
  name: string;
  age: number;
}

const user: User = { name: 'John Doe', age: 30 };

Query Typing

Developers can use types like Query and QuerySnapshot to handle Firestore queries with type safety, ensuring that the operations on queries are correctly typed.

import { Query, QuerySnapshot } from '@firebase/firestore-types';

function fetchUsers(query: Query): Promise<QuerySnapshot> {
  return query.get();
}

Transaction and Batch Typing

This feature provides types for Firestore transactions and batches, allowing developers to manage multiple document updates with type assurance.

import { Firestore, WriteBatch, Transaction } from '@firebase/firestore-types';

function updateMultipleDocs(firestore: Firestore) {
  const batch: WriteBatch = firestore.batch();
  const transaction: Transaction = firestore.runTransaction(async (t) => {
    // transaction logic here
  });
}