Tool debug toolkit for device management
npm install @mcesystems/tool-debugSmall logging helpers built on top of debug, with consistent namespaces and colors.
```
pnpm add @mcesystems/tool-debug
`
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");
}
`
setLogLevel toggles which loggers are enabled:
- info: enables info, task, error, warningdebug
- : enables all loggersnone
- : disables all loggers
If you prefer the default debug behavior, you can skip setLogLevel and use theDEBUG environment variable (for example DEBUG=usb-listener:*) to control output.
logNamespace("usb-listener") sets all loggers to usb-listener:, so yourDEBUG filter can target them consistently.
`
import { setColors, printColors } from "@mcesystems/tool-debug";
setColors("info", "33");
setColors("error", "196");
// Optional helper to preview 0-255 color codes
printColors();
`
`
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 ================================================================================