Uso de CLI bun publish

bun publish dist

Opciones de Publicación

--accessstring

La bandera --access se puede usar para establecer el nivel de acceso del paquete que se publica. El nivel de acceso puede ser public o restricted. Los paquetes sin ámbito son siempre públicos, y intentar publicar un paquete sin ámbito con --access restricted resultará en un error.

bun publish --access public

--access también se puede establecer en el campo publishConfig de tu package.json.

{
  "publishConfig": {
    "access": "restricted"
  }
}

--tagstring default: latest

Establece la etiqueta de la versión del paquete que se publica. Por defecto, la etiqueta es latest. La versión inicial de un paquete siempre recibe la etiqueta latest además de la etiqueta especificada.

bun publish --tag alpha

--tag también se puede establecer en el campo publishConfig de tu package.json.

{
  "publishConfig": {
    "tag": "next"
  }
}

--dry-run=<val>string

La bandera --dry-run se puede usar para simular el proceso de publicación sin publicar realmente el paquete. Esto es útil para verificar el contenido del paquete publicado sin publicar realmente el paquete.

bun publish --dry-run

--gzip-levelstring default: 9

Especifica el nivel de compresión gzip a usar al empaquetar el paquete. Solo se aplica a bun publish sin un argumento de ruta de tarball. Los valores van de 0 a 9 (el predeterminado es 9).

--auth-typestring default: web

Si tienes 2FA habilitado para tu cuenta de npm, bun publish te solicitará una contraseña de un solo uso. Esto se puede hacer a través de un navegador o la CLI. La bandera --auth-type se puede usar para indicar al registro de npm qué método prefieres. Los valores posibles son web y legacy, siendo web el predeterminado.

bun publish --auth-type legacy
...
Esta operación requiere una contraseña de un solo uso.
Ingresa OTP: 123456
...

--otpstring default: web

Proporciona una contraseña de un solo uso directamente a la CLI. Si la contraseña es válida, esto omitirá la solicitud adicional de contraseña de un solo uso antes de publicar. Ejemplo de uso:

bun publish --otp 123456

NOTE

bun publish respeta la variable de entorno NPM_CONFIG_TOKEN que se puede usar al publicar en github actions o flujos de trabajo automatizados.

Configuración de Registro

Registro Personalizado

--registrystring

Especifica la URL del registro, anulando .npmrc y bunfig.toml

bun publish --registry https://my-private-registry.com

Certificados SSL

--castring

Proporciona un certificado de autoridad de certificación

--cafilestring

Ruta al archivo de certificado de autoridad de certificación

bun publish --ca "-----BEGIN CERTIFICATE-----..."

bun publish --cafile ./ca-cert.pem

Opciones de Publicación

Gestión de Dependencias

-p, --productionboolean

No instala devDependencies

--omitstring

Excluye tipos de dependencias: dev, optional, o peer

-f, --forceboolean

Siempre solicita las últimas versiones del registro y reinstala todas las dependencias

Control de Scripts

--ignore-scriptsboolean

Omite scripts de ciclo de vida durante el empaquetado y publicación

--trustboolean

Agrega paquetes a trustedDependencies y ejecuta sus scripts

NOTE

**Scripts de Ciclo de Vida** — Al proporcionar un tarball precompilado, los scripts de ciclo de vida (prepublishOnly, prepack, etc.) no se ejecutan. Los scripts solo se ejecutan cuando Bun empaqueta el paquete mismo.

Gestión de Archivos

--no-saveboolean

No actualiza package.json ni lockfile

--frozen-lockfileboolean

No permite cambios en el lockfile

--yarnboolean

Genera archivo yarn.lock (compatible con yarn v1)

Rendimiento

--backendstring

Optimizaciones de plataforma: clonefile (predeterminado), hardlink, symlink, o copyfile

--network-concurrencynumber default: 48

Máximo de solicitudes de red concurrentes

--concurrent-scriptsnumber default: 5

Máximo de scripts de ciclo de vida concurrentes

Control de Salida

--silentboolean

Suprime toda la salida

--verboseboolean

Muestra registro detallado

--no-progressboolean

Oculta la barra de progreso

--no-summaryboolean

No imprime el resumen de publicación