0xLogs

0xLogs is a lightweight and configurable logging utility for Node.js applications. It supports JSON parsing, file output, and built-in process event logging to help monitor your app's health and behavior with minimal setup.

📦 Installation

npm install 0xlogs

🚀 Features

• Logging with custom levels: info, warn, error, debug
• Optional JSON formatting
• File logging support
• Safe schema validation
• Auto-handling for:
  • uncaughtException
  • unhandledRejection
  • SIGINT, SIGTERM, exit
  • Warnings and IPC messages

🛠️ Usage

Basic Example

const CreateLog = require("0xlogs");

const log = new CreateLog({
  type: "info",
  filePath: "./logs.txt",
  json: true
});

log("App started", { port: 3000 });

Update Config

log.setConfig({
  type: "error",
  json: false
});

⚙️ Config Options

| Option | Type | Default | Description | |-----------|---------|---------|--------------------------------------| | type | String | info | Log level (info, warn, error, debug) | | filePath| String | undefined | Path to output log file (optional) | | json | Boolean | true | Enable JSON formatting for logs |

📂 Built-in Process Logging

When require("0xlogs") is invoked, it automatically logs:

• Uncaught exceptions and rejections
• Signals like SIGINT, SIGTERM
• Process exit events
• IPC messages (process.send)
• Warnings

Example logs:

[~] [ERROR] Uncaught Exception: ...
[~] [INFO] Exited Application.
[~] [WARN] A promise rejection was handled asynchronously: ...

📁 File Structure (for contributors)

0xlogs/
├── lib/
│   ├── index.js        # Combines validation utilities and config types
│   ├── process/
│   │   ├── index.js    # Handles process-level logging
│   ├── types/
│   │   ├── index.js    # Schema definition
│   ├── functions/
│   │   ├── index.js    # Config & path validation
├── index.js            # Main class (CreateLog)

📜 License

MIT © 2025