API

config.load(options?)

Lädt .env und xpulse.json, merged Fallbacks und löst ${VAR} auf. Feuert config:loaded nach erfolgreichem Laden.

1 await config.load();
2 await config.load({ path: '/app', env: 'stage' });

Option	Typ	Beschreibung
`path`	`string`	Verzeichnis mit `xpulse.json` – Standard: `process.cwd()`
`env`	`string`	Environment für `.env.{env}` – Fallback: `process.env.NODE_ENV`

Fehler:

Situation	Verhalten
`xpulse.json` nicht gefunden	wirft `Error`
Ungültiges JSON	wirft `Error`
`name` fehlt	wirft `Error`
Unbekannte Keys	ignoriert, keine Warnung
`${VAR}` nicht auflösbar	Warnung, Wert bleibt `${VAR}`

config.get(path, fallback?)

Gibt einen Wert aus der Konfiguration zurück. Unterstützt Dot-Notation.

1 config.get('http.port')              // '3000'
2 config.get('i18n.locales')           // ['de', 'en']
3 config.get('sources.chat.url')       // 'https://chat.xpulse.one'
4 config.get('release.current')        // '1.3.0' (custom key)
5 config.get('missing.key', 'default') // 'default'
6 config.get('missing.key')            // null

Parameter	Typ	Beschreibung
`path`	`string`	Dot-Notation Pfad
`fallback`	`unknown`	Rückgabe wenn Pfad nicht existiert (Standard: `null`)

config.all()

Gibt alle Konfigurationswerte zurück – inkl. Fallbacks und aufgelösten ${VAR}. Gibt eine Kopie zurück, keine Referenz.

1 const all = config.all();
2 // → { name: 'xpulse-web', type: 'tool', http: { port: '3000' }, ... }

config.name

Kurzform für config.get('name').

1 config.name  // 'xpulse-web'

config.type

Kurzform für config.get('type').

1 config.type  // 'tool'

config.loaded

true nach erfolgreichem load().

1 config.loaded  // true | false

Event: `config:loaded`

Wird nach load() emittiert.

1 // Payload:
2 {
3     name:  'xpulse-web',
4     type:  'tool',
5     env:   'production',         // process.env.NODE_ENV | null
6     files: [
7         '/app/xpulse.json',
8         '/app/.env',
9         '/app/.env.production',  // nur wenn vorhanden
10     ]
11 }

1	await config.load();
2	await config.load({ path: '/app', env: 'stage' });

1	config.get('http.port') // '3000'
2	config.get('i18n.locales') // ['de', 'en']
3	config.get('sources.chat.url') // 'https://chat.xpulse.one'
4	config.get('release.current') // '1.3.0' (custom key)
5	config.get('missing.key', 'default') // 'default'
6	config.get('missing.key') // null

1	const all = config.all();
2	// → { name: 'xpulse-web', type: 'tool', http: { port: '3000' }, ... }

1	// Payload:
2	{
3	name: 'xpulse-web',
4	type: 'tool',
5	env: 'production', // process.env.NODE_ENV \| null
6	files: [
7	'/app/xpulse.json',
8	'/app/.env',
9	'/app/.env.production', // nur wenn vorhanden
10	]
11	}