logan-logger 1.1.2 → 1.1.6

package/README.md

@@ -9,6 +9,7 @@ A universal TypeScript logging library that works consistently across all JavaSc
 ## Features
 
 - 🌐 **Universal Runtime Support** - Works in Node.js, Deno, Bun, browsers, and WebAssembly
+- ⚛️ **Next.js Ready** - Full compatibility with App Router, Server Components, and API Routes
 - 🪶 **Zero Dependencies** - Core functionality with no required dependencies
 - ⚡ **Performance First** - Lazy evaluation, zero-allocation logging, minimal memory footprint
 - 🎯 **TypeScript Native** - Full type safety with comprehensive type definitions
@@ -58,6 +59,91 @@ const requestLogger = logger.child({
 requestLogger.info('Processing request', { endpoint: '/api/users' });
 ```
 
+### Next.js Integration
+
+Logan Logger is fully compatible with Next.js 13+ App Router, including Server Components, Client Components, and API Routes.
+
+#### Server Components
+```typescript
+import { createLogger, LogLevel } from 'logan-logger';
+
+const logger = createLogger({
+  level: process.env.NODE_ENV === 'development' ? LogLevel.DEBUG : LogLevel.INFO,
+  format: 'json'
+});
+
+export default async function ServerComponent() {
+  logger.info('Server component rendered');
+  
+  // Server-side data fetching
+  const data = await fetchData();
+  logger.debug('Data fetched', { recordCount: data.length });
+  
+  return <div>Server content</div>;
+}
+```
+
+#### Client Components
+```typescript
+'use client';
+
+import { createLogger, LogLevel } from 'logan-logger';
+
+const logger = createLogger({
+  level: LogLevel.INFO,
+  colorize: true
+});
+
+export default function ClientComponent() {
+  const handleClick = () => {
+    logger.info('User interaction', { action: 'button_click' });
+  };
+
+  return <button onClick={handleClick}>Click me</button>;
+}
+```
+
+#### API Routes
+```typescript
+// app/api/users/route.ts
+import { NextResponse } from 'next/server';
+import { createLogger } from 'logan-logger';
+
+const logger = createLogger({
+  format: 'json',
+  metadata: { service: 'api' }
+});
+
+export async function GET() {
+  const start = Date.now();
+  logger.info('API request started', { endpoint: '/api/users' });
+  
+  try {
+    const users = await getUsers();
+    const duration = Date.now() - start;
+    
+    logger.info('API request completed', { 
+      statusCode: 200, 
+      duration,
+      userCount: users.length 
+    });
+    
+    return NextResponse.json(users);
+  } catch (error) {
+    const duration = Date.now() - start;
+    logger.error('API request failed', { 
+      statusCode: 500, 
+      duration,
+      error: error instanceof Error ? error.message : 'Unknown error'
+    });
+    
+    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
+  }
+}
+```
+
+> **📋 See [Next.js Compatibility Guide](./docs/nextjs-compatibility.md) for complete setup instructions, advanced patterns, and troubleshooting.**
+
 ### Advanced Features
 
 #### Lazy Evaluation for Performance
@@ -150,6 +236,7 @@ logger.info('User processed', safeData);
 
 | Runtime | Import Path | Status | Implementation | Features |
 |---------|-------------|--------|----------------|----------|
+| **Next.js 13+** | `logan-logger` | ✅ **Full** | **Auto-detection** | **Server/Client Components, API Routes, Edge Runtime** |
 | Node.js 20+ | `logan-logger/node` | ✅ Full | Winston + Console | File logging, transports, Morgan integration |
 | Bun | `logan-logger/bun` | ✅ Full | NodeLogger adapter | Same as Node.js |
 | Browser | `logan-logger/browser` | ✅ Full | Console API | CSS styling, performance marks, grouping |

package/dist/browser-BzeNXjes.js

@@ -0,0 +1 @@
+"use strict";var n=(t=>(t[t.DEBUG=0]="DEBUG",t[t.INFO=1]="INFO",t[t.WARN=2]="WARN",t[t.ERROR=3]="ERROR",t[t.SILENT=4]="SILENT",t))(n||{});function f(){const t=c(),e=m(t),o=g(t);return{name:t,version:e,capabilities:o}}function c(){return typeof globalThis.Deno<"u"?"deno":typeof globalThis.Bun<"u"?"bun":typeof window<"u"&&typeof document<"u"?"browser":typeof globalThis.importScripts=="function"&&typeof window>"u"?"webworker":typeof process<"u"&&process.versions&&process.versions.node?"node":"unknown"}function m(t){switch(t){case"node":return typeof process<"u"?process.version:void 0;case"deno":return typeof globalThis.Deno<"u"?globalThis.Deno.version?.deno:void 0;case"bun":return typeof globalThis.Bun<"u"?globalThis.Bun.version:void 0;case"browser":return typeof navigator<"u"?navigator.userAgent:void 0;default:return}}function g(t){switch(t){case"node":return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case"deno":return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case"bun":return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case"browser":return{fileSystem:!1,colorSupport:!0,processInfo:!1,streams:!1};case"webworker":return{fileSystem:!1,colorSupport:!1,processInfo:!1,streams:!1};default:return{fileSystem:!1,colorSupport:!1,processInfo:!1,streams:!1}}}function h(){return c()==="node"}function y(){return c()==="browser"}function b(){return c()==="deno"}function w(){return c()==="bun"}class l{constructor(e={}){this.childMetadata={},this.config=e,this.level=e.level??n.INFO,this.runtime=f().name}debug(e,o){this.log(n.DEBUG,e,o)}info(e,o){this.log(n.INFO,e,o)}warn(e,o){this.log(n.WARN,e,o)}error(e,o){this.log(n.ERROR,e,o)}log(e,o,s){if(!this.shouldLog(e))return;const r=typeof o=="function"?o():o,i={...this.childMetadata,...s},a={timestamp:new Date,level:e,message:r,metadata:Object.keys(i).length>0?i:void 0,runtime:this.runtime};this.writeLog(a)}setLevel(e){this.level=e}getLevel(){return this.level}child(e){const o=this.createChild();return o.childMetadata={...this.childMetadata,...e},o}shouldLog(e){return e>=this.level}}function d(t,e){const o=new WeakSet;return JSON.stringify(t,(s,r)=>{if(typeof r=="object"&&r!==null){if(o.has(r))return"[Circular]";o.add(r)}return r instanceof Error?{name:r.name,message:r.message,stack:r.stack,...Object.getOwnPropertyNames(r).reduce((i,a)=>(a!=="name"&&a!=="message"&&a!=="stack"&&(i[a]=r[a]),i),{})}:typeof r=="function"?`[Function: ${r.name||"anonymous"}]`:r===void 0?"[undefined]":typeof r=="bigint"?`[BigInt: ${r.toString()}]`:typeof r=="symbol"?`[Symbol: ${r.toString()}]`:r},e)}function p(t,e=["password","token","secret","key","auth"]){if(typeof t!="object"||t===null)return t;const o=Array.isArray(t)?[]:{};for(const[s,r]of Object.entries(t))e.some(a=>s.toLowerCase().includes(a.toLowerCase()))?o[s]="[REDACTED]":typeof r=="object"&&r!==null?o[s]=p(r,e):o[s]=r;return o}function S(t){return t instanceof Error?{name:t.name,message:t.message,stack:t.stack,...t}:t}class u extends l{constructor(e={}){super(e)}writeLog(e){const o=this.formatMessage(e),s=this.getConsoleStyle(e.level),r=e.metadata?` ${d(e.metadata)}`:"",i=`%c${o}${r}`;switch(e.level){case n.DEBUG:console.debug?console.debug(i,s):console.log(i,s);break;case n.INFO:console.info(i,s);break;case n.WARN:console.warn(i,s);break;case n.ERROR:console.error(i,s);break}}createChild(){return new u(this.config)}formatMessage(e){const o=e.timestamp.toISOString(),s=n[e.level].toUpperCase();return`[${o}] ${s}: ${e.message}`}getConsoleStyle(e){if(!this.config.colorize)return"";switch(e){case n.DEBUG:return"color: #888; font-weight: normal;";case n.INFO:return"color: #007acc; font-weight: normal;";case n.WARN:return"color: #ff8c00; font-weight: bold;";case n.ERROR:return"color: #dc3545; font-weight: bold;";default:return""}}shouldLogInProduction(){return(globalThis.process?.env?.NODE_ENV||globalThis.process?.env?.NEXT_PUBLIC_APP_ENV||"development")!=="production"||this.level<=n.ERROR}shouldLog(e){return!this.shouldLogInProduction()&&e<n.ERROR?!1:super.shouldLog(e)}}class R extends u{constructor(){super(...arguments),this.groupStack=[]}group(e){console.group(e),this.groupStack.push(e)}groupCollapsed(e){console.groupCollapsed(e),this.groupStack.push(e)}groupEnd(){console.groupEnd(),this.groupStack.pop()}getCurrentGroupStack(){return[...this.groupStack]}getCurrentGroupPath(){return this.groupStack.join(" > ")}time(e){console.time(e)}timeEnd(e){console.timeEnd(e)}trace(e,o){console.trace(e,o)}count(e){console.count(e)}countReset(e){console.countReset(e)}table(e){console.table(e)}}class k extends u{mark(e){typeof performance<"u"&&performance.mark&&performance.mark(e)}measure(e,o,s){if(typeof performance<"u"&&performance.measure)try{performance.measure(e,o,s);const r=performance.getEntriesByName(e,"measure");if(r.length>0){const i=r[r.length-1];this.info(`Performance: ${e}`,{duration:i.duration,startTime:i.startTime})}}catch(r){this.warn("Failed to measure performance",{name:e,error:r})}}clearMarks(e){typeof performance<"u"&&performance.clearMarks&&performance.clearMarks(e)}clearMeasures(e){typeof performance<"u"&&performance.clearMeasures&&performance.clearMeasures(e)}}exports.BaseLogger=l;exports.BrowserLogger=u;exports.ConsoleGroupLogger=R;exports.LogLevel=n;exports.PerformanceLogger=k;exports.detectRuntime=f;exports.filterSensitiveData=p;exports.isBrowser=y;exports.isBun=w;exports.isDeno=b;exports.isNode=h;exports.safeStringify=d;exports.serializeError=S;

package/dist/browser-C6UkWymL.mjs

@@ -0,0 +1,293 @@
+var n = /* @__PURE__ */ ((t) => (t[t.DEBUG = 0] = "DEBUG", t[t.INFO = 1] = "INFO", t[t.WARN = 2] = "WARN", t[t.ERROR = 3] = "ERROR", t[t.SILENT = 4] = "SILENT", t))(n || {});
+function f() {
+  const t = c(), e = l(t), o = d(t);
+  return {
+    name: t,
+    version: e,
+    capabilities: o
+  };
+}
+function c() {
+  return typeof globalThis.Deno < "u" ? "deno" : typeof globalThis.Bun < "u" ? "bun" : typeof window < "u" && typeof document < "u" ? "browser" : typeof globalThis.importScripts == "function" && typeof window > "u" ? "webworker" : typeof process < "u" && process.versions && process.versions.node ? "node" : "unknown";
+}
+function l(t) {
+  switch (t) {
+    case "node":
+      return typeof process < "u" ? process.version : void 0;
+    case "deno":
+      return typeof globalThis.Deno < "u" ? globalThis.Deno.version?.deno : void 0;
+    case "bun":
+      return typeof globalThis.Bun < "u" ? globalThis.Bun.version : void 0;
+    case "browser":
+      return typeof navigator < "u" ? navigator.userAgent : void 0;
+    default:
+      return;
+  }
+}
+function d(t) {
+  switch (t) {
+    case "node":
+      return {
+        fileSystem: !0,
+        colorSupport: !0,
+        processInfo: !0,
+        streams: !0
+      };
+    case "deno":
+      return {
+        fileSystem: !0,
+        colorSupport: !0,
+        processInfo: !0,
+        streams: !0
+      };
+    case "bun":
+      return {
+        fileSystem: !0,
+        colorSupport: !0,
+        processInfo: !0,
+        streams: !0
+      };
+    case "browser":
+      return {
+        fileSystem: !1,
+        colorSupport: !0,
+        // CSS styling in console
+        processInfo: !1,
+        streams: !1
+      };
+    case "webworker":
+      return {
+        fileSystem: !1,
+        colorSupport: !1,
+        processInfo: !1,
+        streams: !1
+      };
+    default:
+      return {
+        fileSystem: !1,
+        colorSupport: !1,
+        processInfo: !1,
+        streams: !1
+      };
+  }
+}
+function h() {
+  return c() === "node";
+}
+function y() {
+  return c() === "browser";
+}
+function b() {
+  return c() === "deno";
+}
+function w() {
+  return c() === "bun";
+}
+class p {
+  constructor(e = {}) {
+    this.childMetadata = {}, this.config = e, this.level = e.level ?? n.INFO, this.runtime = f().name;
+  }
+  debug(e, o) {
+    this.log(n.DEBUG, e, o);
+  }
+  info(e, o) {
+    this.log(n.INFO, e, o);
+  }
+  warn(e, o) {
+    this.log(n.WARN, e, o);
+  }
+  error(e, o) {
+    this.log(n.ERROR, e, o);
+  }
+  log(e, o, s) {
+    if (!this.shouldLog(e))
+      return;
+    const r = typeof o == "function" ? o() : o, i = { ...this.childMetadata, ...s }, a = {
+      timestamp: /* @__PURE__ */ new Date(),
+      level: e,
+      message: r,
+      metadata: Object.keys(i).length > 0 ? i : void 0,
+      runtime: this.runtime
+    };
+    this.writeLog(a);
+  }
+  setLevel(e) {
+    this.level = e;
+  }
+  getLevel() {
+    return this.level;
+  }
+  child(e) {
+    const o = this.createChild();
+    return o.childMetadata = { ...this.childMetadata, ...e }, o;
+  }
+  shouldLog(e) {
+    return e >= this.level;
+  }
+}
+function m(t, e) {
+  const o = /* @__PURE__ */ new WeakSet();
+  return JSON.stringify(t, (s, r) => {
+    if (typeof r == "object" && r !== null) {
+      if (o.has(r))
+        return "[Circular]";
+      o.add(r);
+    }
+    return r instanceof Error ? {
+      name: r.name,
+      message: r.message,
+      stack: r.stack,
+      ...Object.getOwnPropertyNames(r).reduce((i, a) => (a !== "name" && a !== "message" && a !== "stack" && (i[a] = r[a]), i), {})
+    } : typeof r == "function" ? `[Function: ${r.name || "anonymous"}]` : r === void 0 ? "[undefined]" : typeof r == "bigint" ? `[BigInt: ${r.toString()}]` : typeof r == "symbol" ? `[Symbol: ${r.toString()}]` : r;
+  }, e);
+}
+function g(t, e = ["password", "token", "secret", "key", "auth"]) {
+  if (typeof t != "object" || t === null)
+    return t;
+  const o = Array.isArray(t) ? [] : {};
+  for (const [s, r] of Object.entries(t))
+    e.some(
+      (a) => s.toLowerCase().includes(a.toLowerCase())
+    ) ? o[s] = "[REDACTED]" : typeof r == "object" && r !== null ? o[s] = g(r, e) : o[s] = r;
+  return o;
+}
+function S(t) {
+  return t instanceof Error ? {
+    name: t.name,
+    message: t.message,
+    stack: t.stack,
+    ...t
+    // Include any additional properties
+  } : t;
+}
+class u extends p {
+  constructor(e = {}) {
+    super(e);
+  }
+  writeLog(e) {
+    const o = this.formatMessage(e), s = this.getConsoleStyle(e.level), r = e.metadata ? ` ${m(e.metadata)}` : "", i = `%c${o}${r}`;
+    switch (e.level) {
+      case n.DEBUG:
+        console.debug ? console.debug(i, s) : console.log(i, s);
+        break;
+      case n.INFO:
+        console.info(i, s);
+        break;
+      case n.WARN:
+        console.warn(i, s);
+        break;
+      case n.ERROR:
+        console.error(i, s);
+        break;
+    }
+  }
+  createChild() {
+    return new u(this.config);
+  }
+  formatMessage(e) {
+    const o = e.timestamp.toISOString(), s = n[e.level].toUpperCase();
+    return `[${o}] ${s}: ${e.message}`;
+  }
+  getConsoleStyle(e) {
+    if (!this.config.colorize)
+      return "";
+    switch (e) {
+      case n.DEBUG:
+        return "color: #888; font-weight: normal;";
+      case n.INFO:
+        return "color: #007acc; font-weight: normal;";
+      case n.WARN:
+        return "color: #ff8c00; font-weight: bold;";
+      case n.ERROR:
+        return "color: #dc3545; font-weight: bold;";
+      default:
+        return "";
+    }
+  }
+  shouldLogInProduction() {
+    return (globalThis.process?.env?.NODE_ENV || globalThis.process?.env?.NEXT_PUBLIC_APP_ENV || "development") !== "production" || this.level <= n.ERROR;
+  }
+  shouldLog(e) {
+    return !this.shouldLogInProduction() && e < n.ERROR ? !1 : super.shouldLog(e);
+  }
+}
+class R extends u {
+  constructor() {
+    super(...arguments), this.groupStack = [];
+  }
+  group(e) {
+    console.group(e), this.groupStack.push(e);
+  }
+  groupCollapsed(e) {
+    console.groupCollapsed(e), this.groupStack.push(e);
+  }
+  groupEnd() {
+    console.groupEnd(), this.groupStack.pop();
+  }
+  getCurrentGroupStack() {
+    return [...this.groupStack];
+  }
+  getCurrentGroupPath() {
+    return this.groupStack.join(" > ");
+  }
+  time(e) {
+    console.time(e);
+  }
+  timeEnd(e) {
+    console.timeEnd(e);
+  }
+  trace(e, o) {
+    console.trace(e, o);
+  }
+  count(e) {
+    console.count(e);
+  }
+  countReset(e) {
+    console.countReset(e);
+  }
+  table(e) {
+    console.table(e);
+  }
+}
+class k extends u {
+  mark(e) {
+    typeof performance < "u" && performance.mark && performance.mark(e);
+  }
+  measure(e, o, s) {
+    if (typeof performance < "u" && performance.measure)
+      try {
+        performance.measure(e, o, s);
+        const r = performance.getEntriesByName(e, "measure");
+        if (r.length > 0) {
+          const i = r[r.length - 1];
+          this.info(`Performance: ${e}`, {
+            duration: i.duration,
+            startTime: i.startTime
+          });
+        }
+      } catch (r) {
+        this.warn("Failed to measure performance", { name: e, error: r });
+      }
+  }
+  clearMarks(e) {
+    typeof performance < "u" && performance.clearMarks && performance.clearMarks(e);
+  }
+  clearMeasures(e) {
+    typeof performance < "u" && performance.clearMeasures && performance.clearMeasures(e);
+  }
+}
+export {
+  u as B,
+  R as C,
+  n as L,
+  k as P,
+  y as a,
+  b,
+  w as c,
+  f as d,
+  S as e,
+  g as f,
+  p as g,
+  h as i,
+  m as s
+};