Plugins

SpectralLogs supports a simple plugin system with two lifecycle hooks per log call and an optional init.

Interface

interface Plugin {
  name: string;
  init?: (logger: any) => void;
  beforeLog?: (message: string, level: LogLevel, options?: LogOptions) => string | void;
  afterLog?: (message: string, level: LogLevel, options?: LogOptions) => void;
}

• beforeLog: can transform the message (return a new string) or just observe.
• afterLog: runs after the message is written.

Node Plugins

• FileLoggerPlugin: appends entries to a file, with optional rotation.
• PerformanceTrackerPlugin: measures time per log using perf_hooks.

import spec, { FileLoggerPlugin, PerformanceTrackerPlugin } from 'spectrallogs';

spec.use(new FileLoggerPlugin({ filePath: '.spectral/logs.txt' }));
spec.use(new PerformanceTrackerPlugin());

Web Plugins

• PerformanceTrackerWeb: measures time using performance.now().

import spec, { PerformanceTrackerWeb } from 'spectrallogs/web';

spec.use(new PerformanceTrackerWeb());

Custom Plugin Example

const myPlugin = {
  name: 'Uppercase',
  beforeLog(msg) {
    return msg.toUpperCase();
  },
  afterLog(msg, level) {
    // send analytics if needed
  }
};

spec.use(myPlugin);