@mcesystems/tool-debug

Small logging helpers built on top of debug, with consistent namespaces and colors.

Install

pnpm add @mcesystems/tool-debug

Quick start

import {
	logNamespace,
	setLogLevel,
	logInfo,
	logTask,
	logWarning,
	logErrorObject,
} from "@mcesystems/tool-debug";

logNamespace("usb-listener");
setLogLevel("info");

logInfo("Starting USB listener");
logTask("Scanning devices");
logWarning("Device response is slow");

try {
	// ... work
} catch (error) {
	logErrorObject(error, "USB listener failed");
}

Log levels

setLogLevel toggles which loggers are enabled:

• info: enables info, task, error, warning
• debug: enables all loggers
• none: disables all loggers

If you prefer the default debug behavior, you can skip setLogLevel and use the DEBUG environment variable (for example DEBUG=usb-listener:*) to control output.

Namespaces

logNamespace("usb-listener") sets all loggers to usb-listener:<type>, so your DEBUG filter can target them consistently.

Custom colors

import { setColors, printColors } from "@mcesystems/tool-debug";

setColors("info", "33");
setColors("error", "196");

// Optional helper to preview 0-255 color codes
printColors();

Helpers

import { logHeader, logDataObject, logErrorObject } from "@mcesystems/tool-debug";

logHeader("USB session");
logDataObject("Detected devices", { count: 2, ids: ["abc", "def"] });
logErrorObject(new Error("Device not found"));

Example output (format varies by terminal):

usb-listener:info   ================================================================================
usb-listener:info                                USB session
usb-listener:info   ================================================================================

usb-listener:detail ================================================================================
usb-listener:detail                     *Detected devices* <anonymous>
usb-listener:detail ================================================================================
usb-listener:detail 
usb-listener:detail #  count: 2
usb-listener:detail #  ids:
usb-listener:detail #     0: abc
usb-listener:detail #     1: def
usb-listener:detail 
usb-listener:detail ================================================================================

usb-listener:error  ================================================================================
usb-listener:error                              Device not found
usb-listener:error  ================================================================================
usb-listener:error    Error Message:
usb-listener:error    Device not found
usb-listener:error    Error Stack:
usb-listener:error    Error: Device not found
usb-listener:error     at ...
usb-listener:error  ================================================================================