@decodx/logger-js

A lightweight, flexible Graylog logger for JavaScript/TypeScript applications.
Send structured logs over GELF HTTP with support for metadata, log levels, and easy integration.

✨ Features

• ✅ Send info, warn, error, and debug logs
• ✅ Built-in support for structured metadata (_service, _appName, _version, etc.)
• ✅ Sends logs to Graylog via HTTP (/gelf)
• ✅ Safe and async (non-blocking, fail-safe)
• ✅ TypeScript-friendly, minimal setup

📦 Installation

npm install @decodx/logger-js

🚀 Quick Start

import {Logger} from "@decodx/logger-js";

const log = new Logger({
    appName: "pairing-app",
    service: "auth",
    version: "1.0.0",
    authToken: "abcde..."
});

log.info("User signed in", {userId: "abc123"});
log.error("Database timeout", {retry: true});

⚙️ Constructor Options

| Option | Type | Required | Description | | ----------- | ------ | -------- | ---------------------------- | | service | string | ✅ | Name of your backend/service | | appName | string | ✅ | Module or application name | | version | string | ✅ | App version | | authToken | string | ✅ | Bearer token for auth header |

📘 Log Levels

| Method | Graylog Level | | ------------- | ------------- | | log.debug() | 7 | | log.info() | 6 | | log.warn() | 4 | | log.error() | 3 |

🧩 Coming Soon

• Express/NestJS middleware support
• Console + Graylog dual logging
• Retry & offline queueing
• Support for request/trace IDs