@promise-inc/devlog 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+<img src="./assets/logo.svg" alt="devlog" height="36" />
+
+Simple logger with automatic context (file + line). Zero dependencies.
+
+<p align="center">
+  <img src="./assets/output.svg" alt="devlog output" width="680" />
+</p>
+
+## Install
+
+```bash
+npm install @promise-inc/devlog
+```
+
+## Usage
+
+```ts
+import { log } from "@promise-inc/devlog";
+
+log.info("User created", { userId: 42 });
+log.warn("Deprecated method");
+log.error("Failed to save", err);
+log.success("Migration complete");
+log.debug("Cache hit", { key: "users:1" });
+```
+
+## Custom instance
+
+```ts
+import { createLogger } from "@promise-inc/devlog";
+
+const logger = createLogger({
+  enabled: true,
+  debugEnabled: false,
+});
+
+logger.info("Custom logger");
+```
+
+## Environment variables
+
+| Variable | Effect |
+|----------|--------|
+| `DEVLOG_ENABLED=false` | Disables all logs |
+| `DEVLOG_ENABLED=true` | Enables all logs including debug |
+| `NODE_ENV=production` | Disables debug level (unless `DEVLOG_ENABLED=true`) |
+
+## Output
+
+- **Node.js** — Colored output with ANSI escape codes
+- **Browser** — `console.groupCollapsed` with `%c` styling. Data nested inside collapsible groups
+
+---
+
+Developed by [Promise Inc.](https://promise.codes)

package/dist/context.d.ts

@@ -0,0 +1,2 @@
+import type { CallerInfo } from "./types.js";
+export declare function getCallerInfo(): CallerInfo | null;

package/dist/context.js

@@ -0,0 +1,43 @@
+const NODE_STACK_REGEX = /at\s+.*\((.+):(\d+):(\d+)\)/;
+const NODE_STACK_REGEX_NO_PARENS = /at\s+(.+):(\d+):(\d+)/;
+const BROWSER_STACK_REGEX = /(?:@)(.+):(\d+):(\d+)/;
+function parseLine(line) {
+    const nodeMatch = line.match(NODE_STACK_REGEX);
+    if (nodeMatch) {
+        return {
+            file: nodeMatch[1],
+            line: Number(nodeMatch[2]),
+            column: Number(nodeMatch[3]),
+        };
+    }
+    const nodeMatchNoParens = line.match(NODE_STACK_REGEX_NO_PARENS);
+    if (nodeMatchNoParens) {
+        return {
+            file: nodeMatchNoParens[1],
+            line: Number(nodeMatchNoParens[2]),
+            column: Number(nodeMatchNoParens[3]),
+        };
+    }
+    const browserMatch = line.match(BROWSER_STACK_REGEX);
+    if (browserMatch) {
+        return {
+            file: browserMatch[1],
+            line: Number(browserMatch[2]),
+            column: Number(browserMatch[3]),
+        };
+    }
+    return null;
+}
+export function getCallerInfo() {
+    const stack = new Error().stack;
+    if (!stack)
+        return null;
+    const lines = stack.split("\n");
+    // Skip: Error, getCallerInfo, logMethod, log.level → caller is at index 4+
+    for (let i = 4; i < lines.length; i++) {
+        const info = parseLine(lines[i]);
+        if (info)
+            return info;
+    }
+    return null;
+}

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+export declare function isBrowser(): boolean;
+export declare function isEnabled(): boolean;
+export declare function isDebugEnabled(): boolean;

package/dist/env.js

@@ -0,0 +1,31 @@
+export function isBrowser() {
+    return typeof window !== "undefined";
+}
+function getEnv(key) {
+    if (isBrowser()) {
+        return undefined;
+    }
+    try {
+        return process.env[key];
+    }
+    catch {
+        return undefined;
+    }
+}
+export function isEnabled() {
+    const value = getEnv("DEVLOG_ENABLED");
+    if (value === "false")
+        return false;
+    if (value === "true")
+        return true;
+    return true;
+}
+export function isDebugEnabled() {
+    const value = getEnv("DEVLOG_ENABLED");
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    const nodeEnv = getEnv("NODE_ENV");
+    return nodeEnv !== "production";
+}

package/dist/formatter.d.ts

@@ -0,0 +1,2 @@
+import type { LogEntry } from "./types.js";
+export declare function formatEntry(entry: LogEntry): void;

package/dist/formatter.js

@@ -0,0 +1,96 @@
+import { isBrowser } from "./env.js";
+const ANSI = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    green: "\x1b[32m",
+    cyan: "\x1b[36m",
+    gray: "\x1b[90m",
+};
+const LEVEL_COLORS = {
+    debug: ANSI.gray,
+    info: ANSI.blue,
+    success: ANSI.green,
+    warn: ANSI.yellow,
+    error: ANSI.red,
+};
+const LEVEL_LABELS = {
+    debug: "DEBUG",
+    info: "INFO",
+    success: "OK",
+    warn: "WARN",
+    error: "ERROR",
+};
+const BROWSER_LEVEL_STYLES = {
+    debug: "color: #6b7280; font-weight: normal;",
+    info: "color: #3b82f6; font-weight: bold;",
+    success: "color: #22c55e; font-weight: bold;",
+    warn: "color: #eab308; font-weight: bold;",
+    error: "color: #ef4444; font-weight: bold;",
+};
+const BROWSER_CONSOLE_METHOD = {
+    debug: "debug",
+    info: "log",
+    success: "log",
+    warn: "warn",
+    error: "error",
+};
+function formatTimestamp(date) {
+    return date.toLocaleTimeString("en-US", { hour12: false });
+}
+function shortenPath(filePath) {
+    const parts = filePath.split("/");
+    if (parts.length <= 3)
+        return filePath;
+    return parts.slice(-3).join("/");
+}
+function formatNode(entry) {
+    const color = LEVEL_COLORS[entry.level];
+    const label = LEVEL_LABELS[entry.level];
+    const time = formatTimestamp(entry.timestamp);
+    const callerStr = entry.caller
+        ? `${ANSI.dim}${shortenPath(entry.caller.file)}:${entry.caller.line}${ANSI.reset}`
+        : "";
+    const prefix = `${ANSI.dim}${time}${ANSI.reset} ${color}${ANSI.bold}[${label}]${ANSI.reset}`;
+    const line = callerStr
+        ? `${prefix} ${entry.message} ${callerStr}`
+        : `${prefix} ${entry.message}`;
+    const method = entry.level === "error" ? "error" : entry.level === "warn" ? "warn" : "log";
+    if (entry.data !== undefined) {
+        console[method](line);
+        console[method](entry.data);
+    }
+    else {
+        console[method](line);
+    }
+}
+function formatBrowser(entry) {
+    const label = LEVEL_LABELS[entry.level];
+    const style = BROWSER_LEVEL_STYLES[entry.level];
+    const time = formatTimestamp(entry.timestamp);
+    const method = BROWSER_CONSOLE_METHOD[entry.level];
+    const callerStr = entry.caller
+        ? `${shortenPath(entry.caller.file)}:${entry.caller.line}`
+        : "";
+    const hasData = entry.data !== undefined;
+    const groupLabel = `%c[${label}]%c ${time} ${entry.message}${callerStr ? ` (${callerStr})` : ""}`;
+    if (hasData) {
+        console.groupCollapsed(groupLabel, style, "color: inherit;");
+        console[method](entry.data);
+        console.groupEnd();
+    }
+    else {
+        console[method](groupLabel, style, "color: inherit;");
+    }
+}
+export function formatEntry(entry) {
+    if (isBrowser()) {
+        formatBrowser(entry);
+    }
+    else {
+        formatNode(entry);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createLogger } from "./logger.js";
+export { log } from "./log.js";
+export type { Logger, LoggerConfig, LogLevel, LogEntry, CallerInfo } from "./types.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createLogger } from "./logger.js";
+export { log } from "./log.js";

package/dist/log.d.ts

@@ -0,0 +1 @@
+export declare const log: import("./types.js").Logger;

package/dist/log.js

@@ -0,0 +1,2 @@
+import { createLogger } from "./logger.js";
+export const log = createLogger();

package/dist/logger.d.ts

@@ -0,0 +1,2 @@
+import type { Logger, LoggerConfig } from "./types.js";
+export declare function createLogger(config?: LoggerConfig): Logger;

package/dist/logger.js

@@ -0,0 +1,35 @@
+import { isEnabled, isDebugEnabled } from "./env.js";
+import { getCallerInfo } from "./context.js";
+import { formatEntry } from "./formatter.js";
+function shouldLog(level, config) {
+    const enabled = config?.enabled ?? isEnabled();
+    if (!enabled)
+        return false;
+    if (level === "debug") {
+        return config?.debugEnabled ?? isDebugEnabled();
+    }
+    return true;
+}
+function logMethod(level, config) {
+    return (message, data) => {
+        if (!shouldLog(level, config))
+            return;
+        const caller = getCallerInfo();
+        formatEntry({
+            level,
+            message,
+            data,
+            timestamp: new Date(),
+            caller,
+        });
+    };
+}
+export function createLogger(config) {
+    return {
+        info: logMethod("info", config),
+        warn: logMethod("warn", config),
+        error: logMethod("error", config),
+        success: logMethod("success", config),
+        debug: logMethod("debug", config),
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+export declare const LOG_LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly success: 2;
+    readonly warn: 3;
+    readonly error: 4;
+};
+export type LogLevel = keyof typeof LOG_LEVELS;
+export interface CallerInfo {
+    file: string;
+    line: number;
+    column: number;
+}
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    data?: unknown;
+    timestamp: Date;
+    caller: CallerInfo | null;
+}
+export interface LoggerConfig {
+    enabled?: boolean;
+    debugEnabled?: boolean;
+}
+export interface Logger {
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    success: (message: string, data?: unknown) => void;
+    debug: (message: string, data?: unknown) => void;
+}

package/dist/types.js

@@ -0,0 +1,7 @@
+export const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    success: 2,
+    warn: 3,
+    error: 4,
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@promise-inc/devlog",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Simple logger with automatic context (file + line)",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "typescript": "^5.9.3"
+  }
+}