MONGODB FIND_ONE_AND_UPDATE - Buscar e Atualizar em Uma Operação

O que é este Node?

O MONGODB FIND_ONE_AND_UPDATE é o node responsável por buscar um documento e atualizá-lo em uma única operação atômica, retornando o documento atualizado.

Por que este Node existe?

Buscar e depois atualizar em operações separadas pode causar race conditions. O MONGODB FIND_ONE_AND_UPDATE existe para:

Operação atômica: Buscar e atualizar de forma segura sem race conditions
Retornar documento: Ver o documento atualizado imediatamente
Upsert: Criar documento se não existir (insert + update em uma operação)
Evitar duplicação: Garantir que apenas um documento seja modificado

Como funciona internamente?

Quando o MONGODB FIND_ONE_AND_UPDATE é executado, o sistema:

Valida configuração: Verifica se as credenciais MongoDB foram fornecidas
Estabelece conexão: Conecta ao servidor MongoDB usando as credenciais
Seleciona coleção: Acessa a coleção especificada no banco de dados
Processa query e update: Substitui variáveis em ambos os objetos
Converte _id: Transforma strings de ObjectId quando necessário
Executa findOneAndUpdate: Busca, atualiza e retorna em uma operação atômica
Aplica $set automático: Envolve o update em operador $set
Suporta upsert: Se upsert:true e não encontrar, cria novo documento
Retorna documento atualizado: Usa returnDocument:'after'
Fecha conexão: Encerra a conexão com MongoDB

Código interno (mongodb.executor.ts:225-248):

private async findOneAndUpdate(
  db: Db,
  collectionName: string,
  query: any,
  update: any,
  options: any,
  context: ExecutionContext,
): Promise<any> {
  const replacedQuery = this.replaceObjectVariables(query, context.variables);
  const replacedUpdate = this.replaceObjectVariables(update, context.variables);
  const parsedQuery = this.parseMongoQuery(replacedQuery);

  const collection = db.collection(collectionName);
  const result = await collection.findOneAndUpdate(
    parsedQuery,
    { $set: replacedUpdate },
    {
      upsert: options.upsert || false,
      returnDocument: 'after',
    },
  );

  return result.value;
}

Quando você DEVE usar este Node?

Use MONGODB FIND_ONE_AND_UPDATE sempre que precisar buscar E atualizar atomicamente:

Casos de uso

Incrementar contador: "Buscar e incrementar visualizações de um post"
Upsert: "Atualizar se existir, criar se não existir"
Evitar race conditions: "Garantir atualização atômica"
Ver resultado: "Atualizar e retornar documento modificado"

Quando NÃO usar MONGODB FIND_ONE_AND_UPDATE

Atualizar múltiplos: Use MONGODB UPDATE para vários documentos
Não precisa ver resultado: Use MONGODB UPDATE (mais rápido)
Substituir completamente: Use MONGODB FIND_ONE_AND_REPLACE
Apenas buscar: Use MONGODB FIND_ONE sem modificar

Parâmetros Detalhados

operation (string, obrigatório)

O que é: Define qual operação MongoDB será executada. Para buscar e atualizar, use "findOneAndUpdate".

Padrão: Nenhum (obrigatório)