@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:, 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
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 ================================================================================
``