Usar npm con Pier

El registro de Pier sigue la especificación HTTP del registro de npm de extremo a extremo, así que cualquier versión de npm de la 7 a la 11 funciona con él sin necesidad de flags especiales.

Configurar

.npmrc en la raíz de tu proyecto (o ~/.npmrc para un valor global por defecto):

registry=https://YOUR-PIER-HOST/registry/npm/
//YOUR-PIER-HOST/registry/npm/:_authToken=pier_npm_…
always-auth=true

always-auth=true es inofensivo en npm 7+ y obligatorio para yarn 1 — mantenlo para que el .npmrc sirva para ambos clientes.

Instalar

# Paquete público — proxiado desde npmjs.org si el proxy upstream está activado
npm install left-pad

# Paquete privado
npm install @your-org/internal-lib

# dist-tag específico
npm install @your-org/internal-lib@beta

Publicar

# package.json contiene la versión
npm publish

# O fija el destino sin tocar .npmrc
npm publish --registry=https://YOUR-PIER-HOST/registry/npm/

Iniciar sesión (flujo por navegador)

npm login --auth-type=web --registry=https://YOUR-PIER-HOST/registry/npm/
# → abre el navegador, autentícate en el panel de Pier (con 2FA)
# → el token pier_npm_… se escribe en .npmrc automáticamente

El npm login clásico (sin --auth-type=web) usa el flujo de creación de usuario de CouchDB — también soportado. El flujo web hereda el 2FA del panel; el flujo de CouchDB no solicita OTP. Si necesitas exigir 2FA en cada emisión de token, desactiva el login de CouchDB en los ajustes del panel.

Dist-tags

npm dist-tag add @your-org/[email protected] beta
npm dist-tag ls @your-org/lib
npm dist-tag rm @your-org/lib beta

Marcar como obsoleto

npm deprecate @your-org/[email protected] "use 1.2.x"
npm deprecate @your-org/[email protected] ""   # revertir la obsolescencia

Despublicar

npm unpublish @your-org/[email protected]
npm unpublish @your-org/lib --force    # paquete completo

Matriz de versiones

Versión de npm	Estado	Notas
7	✓	Funciona sin configuración adicional
8	✓	Funciona sin configuración adicional
9	✓	Funciona sin configuración adicional
10	✓	Funciona sin configuración adicional
11	✓	La advertencia de configuración de always-auth es inofensiva

Errores comunes

• 401 Unauthorized al instalar — falta el token o falta always-auth=true en el .npmrc. Consulta Solución de problemas.
• 409 Conflict al publicar — la versión ya existe. Increméntala en package.json.
• npm warn Unknown project config "always-auth" en npm 11 — el flag está obsoleto pero sigue respetándose. Puedes ignorar la advertencia.

Relacionado

• Configuración — guía paso a paso de la configuración inicial.
• Publicar — flujo de publicación completo.
• Integración con CI — npm en GitHub Actions y GitLab CI.