use-term 1.0.0 → 1.1.0

package/README.md

@@ -49,25 +49,29 @@ import term from "use-term";
 // --- A. Using inside a class (automatically gets class name) ---
 class AuthService {
   login() {
-    term.info(this, "Starting login process...");
+    term.info("Starting login process...", undefined, this);
 
     const user = { id: 42, name: "Alex", roles: ["admin", "billing"] };
-    term.success(this, "Credentials validated successfully", user);
+    term.success("Credentials validated successfully", user, this);
   }
 }
 
 // --- B. Using inside a function (automatically gets function name) ---
 function processPayment() {
-  term.warn(processPayment, "Payment gateway is responding slowly", {
-    delayMs: 1500,
-  });
-  term.error(processPayment, "Payment gateway connection timeout", {
-    code: "ETIMEDOUT",
-  });
+  term.warn(
+    "Payment gateway is responding slowly",
+    { delayMs: 1500 },
+    processPayment,
+  );
+  term.error(
+    "Payment gateway connection timeout",
+    { code: "ETIMEDOUT" },
+    processPayment,
+  );
 }
 
 // --- C. Using custom string scopes ---
-term.info("Server", "Server initialized on port 3000", { env: "production" });
+term.info("Server initialized on port 3000", { env: "production" }, "Server");
 
 // --- D. Visual titles ---
 term.title("Authentication Flow");
@@ -88,13 +92,13 @@ For traditional Node.js applications:
 const term = require("use-term");
 
 // Easily log with CommonJS:
-term.info("CJS", "Logging using standard require() syntax!");
+term.info("Logging using standard require() syntax!", undefined, "CJS");
 
 class AuthService {
   login() {
-    term.info(this, "Starting login process...");
+    term.info("Starting login process...", undefined, this);
     const user = { id: 42, name: "Alex", roles: ["admin", "billing"] };
-    term.success(this, "Credentials validated successfully", user);
+    term.success("Credentials validated successfully", user, this);
   }
 }
 
@@ -129,23 +133,23 @@ When you run your scripts, your terminal will light up with premium, high-visibi
 
 ## 🛠️ API Reference
 
-### `term.info(context, message, [data])`
+### `term.info(message, [data], [context])`
 
 Logs an informational message.
 
-- `context` `(any)`: `this` inside a class, a function name, or a plain string.
 - `message` `(string)`: The description text of the log.
 - `data` `(any, optional)`: Any object, array, or metadata to inspect and format below.
+- `context` `(any, optional)`: `this` inside a class, a function name, or a plain string.
 
-### `term.error(context, message, [data])`
+### `term.error(message, [data], [context])`
 
 Logs an error message. Same signature as `info()`.
 
-### `term.success(context, message, [data])`
+### `term.success(message, [data], [context])`
 
 Logs a success message. Same signature as `info()`.
 
-### `term.warn(context, message, [data])`
+### `term.warn(message, [data], [context])`
 
 Logs a warning message. Same signature as `info()`.
 
@@ -164,7 +168,7 @@ Autocompletion works out of the box in VS Code and modern IDEs. If you are using
 ```typescript
 import term from "use-term";
 
-term.info("TypeScript", "Fully typed logger out of the box!");
+term.info("Fully typed logger out of the box!", undefined, "TypeScript");
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-term",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A zero-dependency, ultra-lightweight, and beautiful terminal logging library for Node.js with smart context detection, colored outputs, and automatic timestamps.",
   "main": "src/term.js",
   "types": "src/term.d.ts",

package/src/term.d.ts

@@ -2,43 +2,47 @@
  * A beautiful, simple, and dependency-free terminal logger for Node.js.
  */
 declare class Term {
-    /**
-     * Logs an informational message.
-     * @param context The context of the log (e.g. `this`, a class instance, a function reference, or a string).
-     * @param msg The message to log.
-     * @param data Optional metadata or object to inspect.
-     */
-    info(context: any, msg: string, data?: any): void;
+  /**
+   * Logs an informational message.
+   * @param msg The message to log.
+   * @param data Optional metadata or object to inspect.
+   * @param context Optional scope or location for the log (e.g. `this`, a function, or a string).
+   */
+  info(msg: string, data?: any, context?: any): void;
+  info(context: any, msg: string, data?: any): void;
 
-    /**
-     * Logs an error message.
-     * @param context The context of the log (e.g. `this`, a class instance, a function reference, or a string).
-     * @param msg The message to log.
-     * @param data Optional metadata or object to inspect.
-     */
-    error(context: any, msg: string, data?: any): void;
+  /**
+   * Logs an error message.
+   * @param msg The message to log.
+   * @param data Optional metadata or object to inspect.
+   * @param context Optional scope or location for the log (e.g. `this`, a function, or a string).
+   */
+  error(msg: string, data?: any, context?: any): void;
+  error(context: any, msg: string, data?: any): void;
 
-    /**
-     * Logs a success message.
-     * @param context The context of the log (e.g. `this`, a class instance, a function reference, or a string).
-     * @param msg The message to log.
-     * @param data Optional metadata or object to inspect.
-     */
-    success(context: any, msg: string, data?: any): void;
+  /**
+   * Logs a success message.
+   * @param msg The message to log.
+   * @param data Optional metadata or object to inspect.
+   * @param context Optional scope or location for the log (e.g. `this`, a function, or a string).
+   */
+  success(msg: string, data?: any, context?: any): void;
+  success(context: any, msg: string, data?: any): void;
 
-    /**
-     * Logs a warning message.
-     * @param context The context of the log (e.g. `this`, a class instance, a function reference, or a string).
-     * @param msg The message to log.
-     * @param data Optional metadata or object to inspect.
-     */
-    warn(context: any, msg: string, data?: any): void;
+  /**
+   * Logs a warning message.
+   * @param msg The message to log.
+   * @param data Optional metadata or object to inspect.
+   * @param context Optional scope or location for the log (e.g. `this`, a function, or a string).
+   */
+  warn(msg: string, data?: any, context?: any): void;
+  warn(context: any, msg: string, data?: any): void;
 
-    /**
-     * Prints a bold, beautifully stylized title separator in the console.
-     * @param msg The section title to display.
-     */
-    title(msg: string): void;
+  /**
+   * Prints a bold, beautifully stylized title separator in the console.
+   * @param msg The section title to display.
+   */
+  title(msg: string): void;
 }
 
 declare const term: Term;

package/src/term.js

@@ -1,66 +1,109 @@
-const util = require('util');
+const util = require("util");
 
 const COLORS = {
-    info: '\x1b[36m',
-    error: '\x1b[31m',
-    success: '\x1b[32m',
-    warn: '\x1b[33m',
-    blue: '\x1b[34m',
-    gray: '\x1b[90m',
-    magenta: '\x1b[35m',
-    reset: '\x1b[0m',
-    bold: '\x1b[1m'
+  info: "\x1b[36m",
+  error: "\x1b[31m",
+  success: "\x1b[32m",
+  warn: "\x1b[33m",
+  blue: "\x1b[34m",
+  gray: "\x1b[90m",
+  magenta: "\x1b[35m",
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
 };
 
 class Term {
-    _timestamp() {
-        const now = new Date();
-        const time = `${now.getHours().toString().padStart(2, '0')}:${now.getMinutes().toString().padStart(2, '0')}:${now.getSeconds().toString().padStart(2, '0')}`;
-        return `${COLORS.gray}${time}${COLORS.reset}`;
-    }
+  _timestamp() {
+    const now = new Date();
+    const time = `${now.getHours().toString().padStart(2, "0")}:${now.getMinutes().toString().padStart(2, "0")}:${now.getSeconds().toString().padStart(2, "0")}`;
+    return `${COLORS.gray}${time}${COLORS.reset}`;
+  }
 
-    _getContextName(ctx) {
-        if (!ctx) return 'App';
-        if (typeof ctx === 'string') return ctx;
-        if (typeof ctx === 'function') return ctx.name || 'AnonymousFn';
-        if (typeof ctx === 'object' && ctx.constructor) return ctx.constructor.name;
-        return 'Unknown';
-    }
+  _getContextName(ctx) {
+    if (!ctx) return "App";
+    if (typeof ctx === "string") return ctx;
+    if (typeof ctx === "function") return ctx.name || "AnonymousFn";
+    if (typeof ctx === "object" && ctx.constructor) return ctx.constructor.name;
+    return "Unknown";
+  }
 
-    _log(type, color, icon, context, msg, data) {
-        const ctxName = this._getContextName(context);
-        const timestamp = this._timestamp();
-        const tag = `${color}${icon} ${type}${COLORS.reset}`;
-        const scope = `${COLORS.blue}[${ctxName}]${COLORS.reset}`;
-        
-        console.log(`${timestamp} ${tag} ${scope} ${msg}`);
-        
-        if (data !== undefined && data !== null) {
-            const formatted = util.inspect(data, { colors: true, depth: null });
-            const indented = formatted.split('\n').map(l => l).join('\n');
-            console.log(indented);
-        }
+  _resolveLogArgs(first, second, third) {
+    if (typeof first === "string" && typeof second !== "string") {
+      const msg = first;
+      if (third !== undefined) {
+        return { context: third, msg, data: second };
+      }
+      if (second === undefined) {
+        return { context: undefined, msg, data: undefined };
+      }
+      if (typeof second === "function" || typeof second === "string") {
+        return { context: second, msg, data: undefined };
+      }
+      return { context: undefined, msg, data: second };
     }
 
-    info(context, msg, data) {
-        this._log('INFO', COLORS.info, 'ℹ️ ', context, msg, data);
-    }
+    return { context: first, msg: second, data: third };
+  }
 
-    error(context, msg, data) {
-        this._log('ERROR', COLORS.error, '❌', context, msg, data);
-    }
- 
-    success(context, msg, data) {
-        this._log('SUCCESS', COLORS.success, '✅', context, msg, data);
-    }
+  _log(type, color, icon, context, msg, data) {
+    const ctxName = this._getContextName(context);
+    const timestamp = this._timestamp();
+    const tag = `${color}${icon} ${type}${COLORS.reset}`;
+    const scope = `${COLORS.blue}[${ctxName}]${COLORS.reset}`;
 
-    warn(context, msg, data) {
-        this._log('WARN', COLORS.warn, '⚠️ ', context, msg, data);
-    }
+    console.log(`${timestamp} ${tag} ${scope} ${msg}`);
 
-    title(msg) {
-        console.log(`\n${COLORS.magenta}${COLORS.bold}━━━ ${msg.toUpperCase()} ━━━${COLORS.reset}`);
+    if (data !== undefined && data !== null) {
+      const formatted = util.inspect(data, { colors: true, depth: null });
+      const indented = formatted
+        .split("\n")
+        .map((l) => l)
+        .join("\n");
+      console.log(indented);
     }
+  }
+
+  info(msgOrContext, dataOrMsg, context) {
+    const {
+      context: ctx,
+      msg,
+      data,
+    } = this._resolveLogArgs(msgOrContext, dataOrMsg, context);
+    this._log("INFO", COLORS.info, "ℹ️ ", ctx, msg, data);
+  }
+
+  error(msgOrContext, dataOrMsg, context) {
+    const {
+      context: ctx,
+      msg,
+      data,
+    } = this._resolveLogArgs(msgOrContext, dataOrMsg, context);
+    this._log("ERROR", COLORS.error, "❌", ctx, msg, data);
+  }
+
+  success(msgOrContext, dataOrMsg, context) {
+    const {
+      context: ctx,
+      msg,
+      data,
+    } = this._resolveLogArgs(msgOrContext, dataOrMsg, context);
+    this._log("SUCCESS", COLORS.success, "✅", ctx, msg, data);
+  }
+
+  warn(msgOrContext, dataOrMsg, context) {
+    const {
+      context: ctx,
+      msg,
+      data,
+    } = this._resolveLogArgs(msgOrContext, dataOrMsg, context);
+    this._log("WARN", COLORS.warn, "⚠️ ", ctx, msg, data);
+  }
+
+  title(msg) {
+    console.log(
+      `\n${COLORS.magenta}${COLORS.bold}━━━ ${msg.toUpperCase()} ━━━${COLORS.reset}`,
+    );
+  }
 }
 
 module.exports = new Term();