@xpulse/logger – API

Server-Variante (`@xpulse/logger/server`)

logger.init()

Liest Konfiguration aus xpulse.json und .env, richtet Log-Level und Datei-Sink ein.

1
import logger from '@xpulse/logger/server';
2
await logger.init();

logger.create(module)

Gibt einen Modul-Logger zurück.

1
const log = logger.create('mein-modul');
2
log.debug('detail', { key: 'value' });
3
log.info('server gestartet');
4
log.warn('timeout überschritten');
5
log.error('unbekannter fehler', new Error('...'));

logger.startup({ name, port, env })

Gibt eine standardisierte Startup-Zeile aus.

logger.formatIp(ip)

Anonymisiert IP-Adressen (letztes Oktett → 0). Bei DEBUG=true wird die vollständige IP zurückgegeben.

Client-Variante (`@xpulse/logger/client`)

1
import logger from '@xpulse/logger/client';
2
 
3
await logger.init();
4
const log = logger.create('presence');
5
log.debug('verbindung aufgebaut', { peerId: 'abc' });

logger.init()

Liest Konfiguration (sofern @xpulse/config verfügbar). Setzt Level und enabled. Optional — im Browser kann @xpulse/config fehlen, dann gelten die Defaults (level: 'info').

logger.setLevel(level)

Setzt das Log-Level zur Laufzeit. Nützlich wenn der Level nach einem API-Call bekannt ist (z.B. nach /health).

1
logger.setLevel('debug');

Gültige Werte: 'debug' · 'info' · 'warn' · 'error' · 'off'

logger.create(module)

Gibt einen Modul-Logger zurück — identisch zur Server-Variante.

Konfiguration

1
{
2
  "log": {
3
    "enabled": true,
4
    "level": "info",
5
    "paths": { "file": "var/log/" }
6
  }
7
}

Events