@variablesoftware/logface 🎛️🪵😎

🎛️🪵😎 A fun, lightweight, structured console-style logger with tag-based filtering for TypeScript projects.

✨ Features

Drop-in replacements for console.* methods: debug, info, warn, error, log
Scoped tagging via log.options({ tag }) or deprecated log.withTag(tag)
Filters logs using LOG or LOG_VERBOSE environment variables (supports wildcards)
Per-call configuration: timestamps, level formatting, and custom tags
Wildcard filtering support (e.g. auth:*, metrics*)
Global setup via log.setup({ ... })
Designed for Node.js and edge runtimes

🚀 Install

npm install @variablesoftware/logface
# or
yarn add @variablesoftware/logface

🔧 Quick Usage

import { log } from "@variablesoftware/logface";

// Basic usage
log.debug("Boot sequence initiated");
log.info("App started on port %d", 3000);
log.warn("Disk usage at %d%%", 91);
log.error("Database connection failed: %s", err.message);

// Scoped/tagged logs
log.options({ tag: "auth" }).debug("User login event");
log.options({ tag: "metrics", timestamp: true }).info("Memory: %dMB", 182);
log.options({ tag: "api", levelShort: false }).warn("Rate limit exceeded");

// Global setup
log.setup({ timestamp: true, levelShort: false });

📤 Output Format

[D][init] Booting...
[I][auth] Login successful
[L][metrics] 200 OK

Use log.setup() to enable timestamps or full level names.

🔍 Filtering

Use LOG or LOG_VERBOSE to filter logs by tag or level:

LOG=auth node app.js
LOG=metrics,debug,auth* node app.js

📚 Full Guide

For wildcard matching, structured output, test helpers, global setup, and advanced filtering:

➡️ See LOGGING.md for full logging level guidance

📄 License

Built with ❤️ by @variablesoftware
Thank you for downloading and using this project. Pull requests are warmly welcomed!

🌐 Inclusive & Accessible Design

Naming, logging, error messages, and tests avoid cultural or ableist bias
Avoids assumptions about input/output formats or encodings
Faithfully reflects user data — no coercion or silent transformations
Designed for clarity, predictability, and parity with underlying platforms (e.g., Cloudflare APIs)
Works well in diverse, multilingual, and inclusive developer environments