NPM-Registry

Der Marketplace stellt ProcessCube NPM-Pakete ueber eine Registry-Proxy unter marketplace.processcube.io/npm/ bereit. Je nach Paket werden Anfragen transparent an GitHub Packages oder npmjs.org weitergeleitet.

Konfiguration

Nur ProcessCube-Scopes (empfohlen)

Erstellen Sie eine .npmrc im Projektverzeichnis:


# .npmrc — Nur ProcessCube-Pakete ueber den Marketplace
@5minds:registry=https://marketplace.processcube.io/npm/
@processcube-io:registry=https://marketplace.processcube.io/npm/
//marketplace.processcube.io/npm/:_authToken=DEIN_API_KEY

Ersetzen Sie DEIN_API_KEY durch den API-Key aus Ihrer ProcessCube-Rechnung. Fuer CI/CD-Pipelines kann der Key als Umgebungsvariable genutzt werden: //marketplace.processcube.io/npm/:_authToken=$PROCESSCUBE_API_KEY

Pakete installieren


# ProcessCube Engine
npm install @5minds/processcube_engine
 
# KnowledgeSDK
npm install @processcube-io/knowledge-sdk
 
# Bestimmte Version
npm install @5minds/processcube_engine@19.2.1
 
# Verfuegbare Versionen anzeigen
npm view @processcube-io/knowledge-sdk versions

Paket-Routing

Der Proxy leitet Anfragen je nach Paketname an die richtige Upstream-Registry weiter:

Paket-Scope	Upstream
`@5minds/processcube_*`	GitHub Packages
`@processcube-io/*`	GitHub Packages
Alle anderen	npmjs.org

Der Proxy schreibt Tarball-URLs automatisch um — Clients muessen sich nicht separat bei GitHub Packages authentifizieren.

Fehlerbehebung

Fehler	Ursache	Loesung
`401 Unauthorized`	API-Key fehlt oder ungueltig	`.npmrc` pruefen, Key aktualisieren
`404 Not Found`	Paket existiert nicht	Paketname und Scope pruefen
`ECONNREFUSED`	Registry nicht erreichbar	URL in `.npmrc` pruefen