O que é um arquivo package.json no Node.js e qual é o…

O package.json é um manifesto do projeto Node.js que contém metadados necessários para gerir dependências, construir e executar a aplicação.

Campos principais e seu papel:

name: Nome do projeto.
version: Versão atual do projeto.
description: Breve descrição do projeto.
keywords: Array de palavras-chave para descrever o projeto.
homepage: URL da página principal do projeto.
bugs: Objeto com informações sobre o rastreador de bugs.
license: Tipo de licença do projeto.
author: Informação sobre o autor do projeto.
contributors: Lista de contribuidores.
files: Array de arquivos incluídos ao publicar o pacote.
main: Ponto de entrada da aplicação (arquivo principal).
browser: Ponto de entrada para a parte cliente (se aplicável).
bin: Comandos que devem estar disponíveis globalmente ao instalar o pacote.
man: Caminhos para arquivos de páginas man.
directories: Objeto com caminhos para diretórios do projeto (por exemplo, lib, bin, man, doc).
repository: Objeto com informações do repositório de código fonte.
scripts: Objeto que contém scripts que podem ser executados com npm.
config: Objeto para configurações específicas de scripts.
dependencies: Objeto com dependências necessárias para produção.
devDependencies: Objeto com dependências apenas necessárias para desenvolvimento e testes.
peerDependencies: Dependências das quais também deve depender o usuário do pacote.
bundledDependencies: Array de nomes de dependências que devem ser empacotadas com o pacote.
optionalDependencies: Dependências que podem ser instaladas, mas sua ausência não causará erro.
engines: Objeto que indica as versões suportadas de Node.js e npm.
os: Array de sistemas operacionais nos quais funciona o projeto.
cpu: Array de arquiteturas de CPU nas quais funciona o projeto.
preferGlobal: Valor booleano que indica se o pacote deve ser instalado globalmente.
private: Valor booleano que indica se o pacote é privado e não deve ser publicado no npm.
publishConfig: Configurações para publicar no npm.

{
  "name": "my-node-app", // Nome do projeto
  "version": "1.0.0", // Versão do projeto
  "description": "Aplicação simples de Node.js",
  "main": "index.js", // Ponto de entrada
  "scripts": {
    "start": "node index.js", // Script de início
    "test": "echo \"Erro: nenhuma test especificada\" && exit 1" // Script para testes
  },
  "keywords": [
    "node",
    "exemplo"
  ],
  "author": "Seu Nome",
  "license": "ISC",
  "dependencies": { // Dependências para produção
    "express": "^4.18.2"
  },
  "devDependencies": { // Dependências para desenvolvimento
    "nodemon": "^2.0.20"
  }
}

package.json desempenha um papel fundamental na gestão de dependências (instalação, atualização, remoção), na definição de scripts para automatizar tarefas (início, teste, construção), na provisão de metadados do projeto para npm e outras ferramentas, bem como na garantia da reprodutibilidade da construção do projeto.

O que é um arquivo package.json no Node.js e qual é o seu papel num projeto?