firestoreMerge

// Define a function to merge updates into a post
const mergePost = firestoreMerge('posts')

// Use the function to merge updates into a post
const postId = 'post-id-1'
await mergePost(postId, { title: 'Updated title' })

// Define a function to merge updates into a post for a specific user
const userId = 'user-id-1'
const mergePostForUser = firestoreMerge(`users/${userId}/posts`)

const postId = 'post-id-1'
await mergePostForUser(postId, { title: 'Updated title' })

// Define a function to merge updates into a post for a user
const mergePostForUser = firestoreMerge(({ userId }) => `users/${userId}/posts`)

const postId = 'post-id-1'
const userId = 'user-id-1'
await mergePostForUser(postId, { title: 'Updated title' }, { userId })

const postId = 'post-id-1'
const ref = await mergePost(postId, { title: 'Updated title' })

// The value returned is a DocumentReference
console.log(ref.path) // outputs the path of the updated document

type Post = {
  title: string
  content: string
}

const mergePost = firestoreMerge<Post>('posts')

const postId = 'post-id-1'

// This merge is allowed as it matches the Post type
await mergePost(postId, { title: 'Updated title' })

// This merge is not allowed as 'views' is not part of the Post type
await mergePost(postId, { views: 100 })

// The mergePost function will now include metadata.
const mergePost = firestoreMerge<Post>('posts', { addMetadata: true })

await mergePost('post-id-1', { title: 'My Merged Post' })

// The post will have an updated 'metadata.timeUpdated' field.