π missionlog is a lightweight, structured logging package designed for performance, flexibility, and ease of use. It works as a drop-in replacement for console.log
or ts-log
, and offers both log level filtering, optional tag filtering, and customizable output handlingβall in a tiny (~1KB) package.
β Fully Typed (TypeScript) β’ β ESM & CJS Support β’ β Zero Dependencies β’ β 100% Coverage
β
Drop-in Replacement for console.log
& ts-log
β Start using it instantly!
β Seamless Upgrade to Tagged Logging β Reduce log clutter and focus on what's important.
β Configurable Log Levels β Adjust visibility for log level and tags at runtime.
β Customizable Output β Send logs anywhere: console, JSON, cloud services.
β Structured Logging Support β Enhanced callbacks with timestamp and typed message data.
β Blazing Fast Performance β O(1) log level lookups with advanced level caching.
β TypeScript-First β Full type safety with LogMessage and LogConfig interfaces.
β Chainable API β All methods return the logger instance for method chaining.
β Works Everywhere β Browser, Node.js, Firebase, AWS Lambda etc.
npm i missionlog
Missionlog works as a drop-in replacement for console.log:
import { log } from "missionlog";
// Works just like console.log
log.info("Hello, world!");
log.warn("Warning message");
log.error("Error occurred!");
// Chainable API for fluent logging
log.debug("Starting process")
.info("Process step 1 complete")
.warn("Process running slowly");
import { log, tag, LogLevel, DEFAULT_TAG } from "missionlog";
// Configure logging levels for different tags
log.init({
network: LogLevel.DEBUG,
ui: LogLevel.INFO,
[DEFAULT_TAG]: LogLevel.WARN // Default level for uncategorized logs
});
// Log with tags
log.debug(tag.network, "Connection established");
log.info(tag.ui, "Component rendered");
// Untagged logs use the DEFAULT_TAG level
log.debug("This won't be logged because DEFAULT_TAG is WARN");
log.error("This will be logged because ERROR > WARN");
import { log, LogLevel, LogLevelStr, LogCallbackParams } from "missionlog";
import chalk from "chalk";
// Create a custom log handler
function createCustomHandler() {
const logConfig: Record<
LogLevelStr,
{ color: (text: string) => string; method: (...args: unknown[]) => void }
> = {
ERROR: { color: chalk.red, method: console.error },
WARN: { color: chalk.yellow, method: console.warn },
INFO: { color: chalk.blue, method: console.log },
DEBUG: { color: chalk.magenta, method: console.log },
TRACE: { color: chalk.cyan, method: console.log },
OFF: { color: () => '', method: () => {} }
};
return (level: LogLevelStr, tag: string, message: unknown, params: unknown[]) => {
const { method, color } = logConfig[level];
const logLine = `[${color(level)}] ${tag ? tag + ' - ' : ''}${message}`;
method(logLine, ...params);
};
}
// Initialize with custom handler
log.init(
{ network: LogLevel.INFO, [DEFAULT_TAG]: LogLevel.INFO },
createCustomHandler()
);
// Enhanced structured logging with timestamps and typed data
log.setEnhancedCallback((params: LogCallbackParams) => {
const { level, tag, message, timestamp, params: extraParams } = params;
console.log(
`[${timestamp.toISOString()}] [${level}] ${tag ? tag + ' - ' : ''}${message}`,
...extraParams
);
});
// Check if a level is enabled before expensive logging operations
if (log.isLevelEnabled(LogLevel.DEBUG, 'network')) {
// Only perform this expensive operation if DEBUG logs will be shown
const stats = getNetworkStatistics(); // Example of an expensive operation
log.debug(tag.network, 'Network statistics', stats);
}
log.trace(messageOrTag?, ...params)
- Lowest verbosity levellog.debug(messageOrTag?, ...params)
- Detailed debugging informationlog.info(messageOrTag?, ...params)
- Notable but expected eventslog.log(messageOrTag?, ...params)
- Alias for info()log.warn(messageOrTag?, ...params)
- Potential issues or warningslog.error(messageOrTag?, ...params)
- Error conditions
log.init(config?, callback?)
- Configure log levels and custom handlerlog.setEnhancedCallback(callback)
- Set structured logging callback with extended parameterslog.isLevelEnabled(level, tag?)
- Check if a specific level would be logged for a taglog.reset()
- Clear all tag registrations and configurations
LogLevel.TRACE
- Most verboseLogLevel.DEBUG
LogLevel.INFO
- Default levelLogLevel.WARN
LogLevel.ERROR
LogLevel.OFF
- No logs
MIT License Β© 2019-2025 Ray Martone
π Install missionlog
today and make logging clean, structured, and powerful!