Plugin: publisher-npm

Veröffentlicht JavaScript- und TypeScript-Pakete in der npm-Registry (oder einer kompatiblen Registry), nachdem semrel die Version aktualisiert hat. Erkennt automatisch pnpm, Yarn Berry, Yarn Classic oder npm anhand der vorhandenen Lockfiles.

Installation

Binärdatei

semrel plugin install @semrel/publisher-npm

semrel plugin install lädt die Binärdatei nach .semrel/plugins/ herunter und aktualisiert .semrel.lock. Committe .semrel.lock, um die Version für dein Team festzuschreiben.

Docker

Vorgefertigte, signierte Multi-Plattform-Images (linux/amd64, linux/arm64) werden bei jedem Release veröffentlicht:

docker pull ghcr.io/semrels/publisher-npm:latest

Überprüfe die Image-Signatur mit cosign:

cosign verify ghcr.io/semrels/publisher-npm:latest \
  --certificate-identity-regexp 'https://github.com/SemRels/publisher-npm/.github/workflows/release.yml.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Konfiguration

version: 1
plugins:
  - uses: @semrel/updater-npm
    phase: pre-tag
    args:
      update_lockfile: "true"

  - uses: @semrel/publisher-npm
    phase: release
    args:
      npm_token: '${env.NPM_TOKEN}'
      npm_tag: latest
      npm_provenance: "true"
      npm_access: public

Umgebungsvariablen

Name	Erforderlich	Standard	Beschreibung
`SEMREL_PLUGIN_NPM_TOKEN`	ja (außer Dry-Run)	`—`	npm-Authentifizierungs-Token, wird als `NODE_AUTH_TOKEN` übergeben.
`SEMREL_PLUGIN_NPM_TAG`	nein	`latest`	Dist-Tag (`--tag <wert>`).
`SEMREL_PLUGIN_NPM_PROVENANCE`	nein	`false`	Wenn `true`, wird `--provenance` für npm-Provenance-Attestierungen angehängt.
`SEMREL_PLUGIN_NPM_ACCESS`	nein	`—`	`public` oder `restricted` (`--access <wert>`, hilfreich für Scoped Packages).

Release-Kontextvariablen

SEMREL_VERSION
SEMREL_NEXT_VERSION
SEMREL_DRY_RUN

Paketmanager-Erkennung

publisher-npm prüft das Arbeitsverzeichnis in folgender Reihenfolge:

pnpm-lock.yaml → pnpm publish
yarn.lock + .yarnrc.yml (oder yarn --version >= 2) → yarn npm publish
yarn.lock → yarn publish
Fallback → npm publish

Bei SEMREL_DRY_RUN=true gibt das Plugin den Paketnamen, die Version und den geplanten Befehl aus, ohne einen Upload auszuführen.

Quelle

SemRels/publisher-npm