Übersetzung der englischen Originalseite. Bei Abweichungen gilt die englische Fassung.

Installation

DaloyJS richtet sich an Node.js 24 LTS oder Node.js 26 und neuer (engines.node: ^24.0.0 || >=26.0.0) und wird über die öffentliche npm-Registry als @daloyjs/core verteilt. Das Paket hat keine Peer-Abhängigkeiten, daher können npm, yarn, pnpm und bun es direkt installieren. Aus Gründen der Lieferkettensicherheit empfehlen wir pnpm zusammen mit den gehärteten .npmrc-Einstellungen weiter unten, Pflicht ist das aber nicht. Der Eintrag engines.pnpm in package.json ist ein Hinweis, während engines.node die unterstützte Laufzeit angibt und je nach Paketmanager und engine-strict-Einstellung eine Warnung oder einen Fehler auslösen kann.

Am schnellsten: Projekt anlegen

Nutzen Sie den offiziellen Generator: Er richtet mit einem Befehl eine gehärtete .npmrc, striktes TypeScript und eine funktionierende Route ein.

Paket-Links: create-daloy auf npm und @daloyjs/core auf npm.

# einen Paketmanager wählen
pnpm create daloy@latest my-api
npm  create daloy@latest my-api
yarn create daloy           my-api
bun  create daloy           my-api

Vorlagen und Optionen finden Sie unter Scaffold a project (auf Englisch).

Oder in ein bestehendes Projekt installieren

Voraussetzungen

• Node.js 24 LTS oder 26.0.0 und neuer (Node.js 25 wird nicht unterstützt).
• Ein Paketmanager. Jeder davon funktioniert; für die Härtung der Lieferkette wird pnpm 11.x oder neuer empfohlen, doch npm, yarn und bun installieren @daloyjs/core problemlos, da das Paket keine Peer-Abhängigkeiten hat.

So aktivieren Sie pnpm über Corepack:

corepack enable
corepack prepare pnpm@11.1.3 --activate
pnpm --version

DaloyJS installieren

pnpm add @daloyjs/core zod

npm install @daloyjs/core zod

yarn add @daloyjs/core zod

bun add @daloyjs/core zod

Optional, nur wenn Sie ein typisiertes SDK generieren möchten:

pnpm add -D typescript @hey-api/openapi-ts prettier

npm install --save-dev typescript @hey-api/openapi-ts prettier

yarn add --dev typescript @hey-api/openapi-ts prettier

bun add --dev typescript @hey-api/openapi-ts prettier

Das auf npm veröffentlichte Framework-Paket ist @daloyjs/core.

Gehärtete Installationseinstellungen

Legen Sie unter pnpm 11+ die Einstellungen zur Lieferkette in pnpm-workspace.yaml im Projektstamm ab (Schlüssel in camelCase; pnpm 11 liest diese Datei auch in einem Projekt mit nur einem Paket). pnpm 11 ignoriert diese Einstellungen in .npmrc, eine reine .npmrc-Konfiguration hat also weder Wartezeit noch Skript-Richtlinie.

minimumReleaseAge: 1440
blockExoticSubdeps: true
ignoreScripts: true
strictPeerDependencies: true
verifyStoreIntegrity: true
preferFrozenLockfile: true
autoInstallPeers: true

Für npm und ältere pnpm-Versionen behalten Sie dieselben Werte zusätzlich in .npmrc:

auto-install-peers=true
strict-peer-dependencies=true
prefer-frozen-lockfile=true
verify-store-integrity=true
minimum-release-age=1440
ignore-scripts=true

Die Wartezeit und ignoreScripts senken das Lieferkettenrisiko dieser Installationen, stoppen aber nicht jeden Angriff. ignoreScripts blockiert Schadcode in Installationsskripten, nicht Code, der beim Import eines Pakets läuft, und die 24-stündige Wartezeit schützt nur vor Kompromittierungen, die binnen eines Tages entdeckt werden.

Die Hintergründe stehen unter Sicherheit und im Leitfaden zur Motivation von pnpm.

Installation prüfen

Führen Sie dies nach der Installation im Projektstamm aus; es funktioniert unter pnpm, npm, yarn und bun gleich, weil es direkt node aufruft:

node -e "import('@daloyjs/core').then(m => console.log('DaloyJS ok ->', Object.keys(m).slice(0, 6)))"

Nächster Schritt

Zuletzt aktualisiert: 30. Oktober 2026