@mbsks/rspfx-diagnostics

Diagnostics for RSPFX — an SPFx-compatible build toolchain powered by Rspack.

Structured logging, typed errors, benchmarks, and formatting helpers shared across the toolchain and CLI.

Install

npm i @mbsks/rspfx-diagnostics

Usage

import { createLogger, RspfxError, formatBytes, reportBenchmark, timeStart } from '@mbsks/rspfx-diagnostics';

const log = createLogger({ level: 'info' });
log.info('building %s', 'my-webpart');

try {
  // ...
} catch (cause) {
  throw new RspfxError('E1001', 'something failed', cause);
}

const elapsed = timeStart();
// ... work ...
reportBenchmark('my-step', elapsed());

console.log(formatBytes(1_500_000)); // "1.4 MB"

API

• createLogger(opts) / Logger / LogLevel — structured logger (level from RSPFX_LOG_LEVEL env var)
• RspfxError — typed error with code, message, and cause
• reportBenchmark, timeStart, trace — timing/telemetry
• formatBytes — human-readable byte sizes

Links

• RSPFX documentation
• License: MIT