@xpulse/app – API

app.init(env?)

Bootstrapped den gesamten Stack über den resilienten Service Loader.

1
import app from '@xpulse/app';
2
await app.init();           // env aus APP_ENV → NODE_ENV
3
await app.init('stage');    // explizit

Bootstrap-Reihenfolge

1. App Root setzen
2. config.load() – xpulse.json + .env
3. debug.init() – wenn installiert + debug.enabled: true
4. logger.init()
5. http.init()
6. controller.init() – discovert + registriert Routes
7. CLI Discovery

Jeder Schritt ist resilient – fehlt ein Package, wird es übersprungen.

app.start()

Startet den HTTP-Server. Feuert app:ready.

app.stop(exitCode?)

Graceful Shutdown. Feuert app:stopping → app:stopped → process.exit().

Helpers

1
app.root()         // absoluter App Root Pfad
2
app.path('src/x')  // Pfad relativ zu App Root
3
app.env            // 'development' | 'stage' | 'production' | null
4
app.isDev()
5
app.isProd()
6
app.isStage()

Events

Vollständige Event-Referenz: GLOBAL_adr-010-event-driven.md