Catalog npm
Back to packageRELEASE DETAILS

0.0.3

npm

0xlogs

Lightweight and configurable logging utility for Node.js with JSON support and file logging.

debugerrorfileinfojsonlogloggerloggingnodejsprocesswarn
Published11 May 2025
Direct dependencies0
Transitive dependenciesNot calculated

README

Current package documentation

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

OptionTypeDefaultDescription
typeStringinfoLog level (info, warn, error, debug)
filePathStringundefinedPath to output log file (optional)
jsonBooleantrueEnable 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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 0

Native requirements
0 direct targetsNot calculated transitive count
No declared dependencies in this collected response

Declarations describe requirements; they are not a resolved dependency graph.

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "478beec723de2ea332bcd60ab78a1ceb313a86ca",
  "tarball": "https://registry.npmjs.org/0xlogs/-/0xlogs-0.0.3.tgz",
  "fileCount": 8,
  "integrity": "sha512-Y/5I0S5BOqGKEXzfd2N6gz9ur3LPqy5P70vnAbB8WfcGSFRM/Wx/UbIFeXlQDsu+kPbKg68vTtU1FuGLQC4DOQ==",
  "signatures": [
    {
      "sig": "MEUCIHU1j2sYMrkg/THtJQ0C2tdwKhwkJaGofjQhD4jbSZbGAiEAhRBR+ukWujqvMZ+VhuSrn6L2Rv/tVKBvPiL0e08kb3I=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 9401
}

Repository

PENDING
shadym00n/0xlogs

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 17:51 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:a2dc9051da4eef5a09e3f77a24db2dbaf7286a3422f9143a3af80cfa46cfe2a5

Other collected versions

1.0.112 May1.0.011 May0.0.210 May0.0.110 MayView all collected versions →