@vsfedorenko/next-logger 0.1.0 → 0.2.0

package/dist/patches/next.js

@@ -1,124 +1,33 @@
 "use strict";
 /**
- * Patches Next.js' internal logger (`next/dist/build/output/log`) so every
- * call routes through the shared consola instance tagged `next.js`.
+ * Classifier for Next.js' internal log output captured at the console sink.
  *
- * Next 13+ defines its logger exports as non-configurable accessor properties,
- * which would throw under a plain redefinition. We work around this by
- * replacing `require.cache[...].exports` with a shallow copy (the original's
- * approach), then defining each method as a plain value property on the copy.
- *
- * This is a side-effect module — importing it applies the patch exactly once.
+ * Next.js' `next/dist/build/output/log` funnels every diagnostic line through
+ * `console.log`/`console.warn`/`console.error`, prefixing each with a coloured
+ * marker symbol (`▲`, `✓`, `⚠`, …). Detecting that prefix lets the console
+ * patch tag those lines as `next.js` rather than `console` — restoring the
+ * source distinction WITHOUT monkeypatching Next's module (which is isolated
+ * into a separate bundle instance under Turbopack and unreachable via
+ * `require.cache`).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NEXT_PREFIXES = void 0;
-exports.routeNextMethod = routeNextMethod;
-exports.patchNext = patchNext;
-const logger_1 = require("../logger");
-const util_1 = require("./util");
-/**
- * The methods exported by Next's log module that we patch.
- *
- * `prefixes` is the set Next itself advertises (wait/error/warn/ready/info/
- * event/trace). `bootstrap` is an extra export that bypasses the prefix logic
- * (raw `console.log`) — we route it too so it stays consistent.
- */
-exports.NEXT_PREFIXES = [
-    "wait",
-    "error",
-    "warn",
-    "ready",
-    "info",
-    "event",
-    "trace",
-];
+exports.isNextLog = isNextLog;
+const ANSI = /\u001b\[[0-9;]*m/g;
 /**
- * Maps a Next.js prefix name to the corresponding consola log function.
- * `trace` maps to consola's native `trace` — no fallback needed (consola has
- * it; the pino original had to fall back to `debug` for Winston which lacks
- * trace).
- *
- * Pure function — given a consola instance and a tag, returns the routing
- * function. Exported so the level mapping can be unit-tested without touching
- * `require.cache` or a real Next.js install.
+ * Marker symbols Next.js prefixes its log lines with (after stripping ANSI
+ * colour codes). Covers the startup banner (`▲ Next.js`), `✓ Ready`/`event`,
+ * and `⚠` warnings.
  */
-function routeNextMethod(method, consola, tag) {
-    const child = consola.withTag(tag);
-    const bound = selectConsolaMethod(method, child);
-    return (0, util_1.skipEmpty)(bound);
-}
+const NEXT_MARKERS = ["▲", "✓", "⚠", "●", "✗"];
 /**
- * Selects the consola method matching a Next.js method name.
+ * Returns `true` when the given console call args look like a Next.js log line
+ * (first string arg, ANSI-stripped, starts with a Next marker symbol).
  */
-function selectConsolaMethod(method, consola) {
-    switch (method) {
-        case "error":
-            return consola.error.bind(consola);
-        case "warn":
-            return consola.warn.bind(consola);
-        case "trace":
-            return consola.trace.bind(consola);
-        default:
-            // wait, ready, info, event, bootstrap → info
-            return consola.info.bind(consola);
-    }
-}
-/**
- * Applies the Next.js logger patch. Safe to call multiple times — it
- * re-derives the methods from the current {@link logger} each time.
- *
- * @param tagOverride override the `next.js` tag (useful for tests).
- */
-function patchNext(tagOverride) {
-    const tag = tagOverride ?? "next.js";
-    let nextLog;
-    try {
-        nextLog = require("next/dist/build/output/log");
-    }
-    catch {
-        // `next` is not installed — nothing to patch.
-        return;
-    }
-    // Build the routed methods for every prefix + bootstrap.
-    const methodNames = [...Object.keys(nextLog.prefixes), "bootstrap"];
-    const routed = {};
-    for (const method of methodNames) {
-        routed[method] = routeNextMethod(method, logger_1.logger, tag);
-    }
-    // Strategy 1: if we have access to the CJS module cache, replace the exports
-    // with a fresh shallow copy. This sidesteps the non-configurable accessor
-    // properties Next 13+ defines (they throw under defineProperty).
-    const cacheObject = tryGetCache("next/dist/build/output/log");
-    if (cacheObject !== null) {
-        cacheObject.exports = { ...nextLog, ...routed };
-        return;
-    }
-    // Strategy 2 (fallback): mutate the live exports object in place. Try plain
-    // assignment first; if the property is non-configurable + non-writable,
-    // skip silently (the routing function is still correct — verified by unit
-    // tests on routeNextMethod directly).
-    const target = nextLog;
-    for (const [method, fn] of Object.entries(routed)) {
-        try {
-            target[method] = fn;
-        }
-        catch {
-            // Non-writable, non-configurable — skip.
-        }
-    }
-}
-/** Looks up a module in the CJS cache by specifier; returns null if absent. */
-function tryGetCache(specifier) {
-    try {
-        const resolved = require.resolve(specifier);
-        const cached = require.cache[resolved];
-        return cached ?? null;
-    }
-    catch {
-        return null;
-    }
+function isNextLog(args) {
+    const first = args.find((a) => typeof a === "string");
+    if (first === undefined)
+        return false;
+    const stripped = first.replace(ANSI, "").trimStart();
+    return NEXT_MARKERS.some((m) => stripped.startsWith(m));
 }
-// Apply on import (side effect), matching the original's
-// `require('./patches/next')` semantics.
-patchNext();
 //# sourceMappingURL=next.js.map

package/dist/patches/next.js.map

@@ -1 +1 @@
-{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/patches/next.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/patches/next.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAeH,8BAKC;AAlBD,MAAM,IAAI,GAAG,mBAAmB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAExD;;;GAGG;AACH,SAAgB,SAAS,CAAC,IAAwB;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACnE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;IACrD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/withLogger.d.ts

@@ -0,0 +1,36 @@
+import type { ConsolaOptions } from "consola";
+/**
+ * Options for {@link withLogger} — the build-time, serialisable form of the
+ * logger config. Delivered to the runtime as JSON via the `NEXT_LOGGER_CONFIG`
+ * env var (Next.js' `env` config key inlines it at build time).
+ */
+export interface LoggerPluginOptions {
+    /**
+     * Partial consola options merged over the library defaults
+     * (`{ level, formatOptions: { date, compact } }`). Only serialisable options
+     * are supported here — a live `ConsolaInstance` or factory cannot cross the
+     * build→runtime boundary.
+     */
+    readonly consola?: Partial<ConsolaOptions>;
+}
+/**
+ * Next.js config wrapper (higher-order function), used like the other `withX`
+ * plugins (`withPWA`, `withBundleAnalyzer`):
+ *
+ * ```ts
+ * // next.config.ts
+ * import { withLogger } from "@vsfedorenko/next-logger";
+ *
+ * export default withLogger({ consola: { level: 4 } })({
+ *   // ...your next config
+ * });
+ * ```
+ *
+ * It injects `NEXT_LOGGER_CONFIG` (the serialised options) into the config's
+ * `env` key — a validated, warning-free key that Next.js inlines into
+ * `process.env` at build time. {@link init} reads it back at runtime. Works
+ * under both webpack and Turbopack, and avoids the "Unrecognized key" warning
+ * that a custom top-level `logger` key would trigger.
+ */
+export declare function withLogger(options?: LoggerPluginOptions): <C extends object>(nextConfig: C) => C;
+//# sourceMappingURL=withLogger.d.ts.map

package/dist/withLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withLogger.d.ts","sourceRoot":"","sources":["../src/withLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,mBAAwB,IAEzC,CAAC,SAAS,MAAM,EAAE,YAAY,CAAC,KAAG,CAAC,CAQrD"}

package/dist/withLogger.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withLogger = withLogger;
+const config_1 = require("./config");
+/**
+ * Next.js config wrapper (higher-order function), used like the other `withX`
+ * plugins (`withPWA`, `withBundleAnalyzer`):
+ *
+ * ```ts
+ * // next.config.ts
+ * import { withLogger } from "@vsfedorenko/next-logger";
+ *
+ * export default withLogger({ consola: { level: 4 } })({
+ *   // ...your next config
+ * });
+ * ```
+ *
+ * It injects `NEXT_LOGGER_CONFIG` (the serialised options) into the config's
+ * `env` key — a validated, warning-free key that Next.js inlines into
+ * `process.env` at build time. {@link init} reads it back at runtime. Works
+ * under both webpack and Turbopack, and avoids the "Unrecognized key" warning
+ * that a custom top-level `logger` key would trigger.
+ */
+function withLogger(options = {}) {
+    const serialised = JSON.stringify(options);
+    return function (nextConfig) {
+        const existingEnv = nextConfig.env ?? {};
+        return {
+            ...nextConfig,
+            env: { ...existingEnv, [config_1.CONFIG_ENV_VAR]: serialised },
+        };
+    };
+}
+//# sourceMappingURL=withLogger.js.map

package/dist/withLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withLogger.js","sourceRoot":"","sources":["../src/withLogger.ts"],"names":[],"mappings":";;AAqCA,gCAUC;AA9CD,qCAA0C;AAiB1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,UAAU,CAAC,UAA+B,EAAE;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,UAA4B,UAAa;QAC9C,MAAM,WAAW,GACb,UAAsC,CAAC,GAA0C,IAAI,EAAE,CAAC;QAC5F,OAAO;YACL,GAAG,UAAU;YACb,GAAG,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC,uBAAc,CAAC,EAAE,UAAU,EAAE;SACjD,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vsfedorenko/next-logger",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Universal logging kit for Next.js — patches Next's internal logger & console, routes output to consola, Sentry, JSON, and more.",
   "license": "MIT",
   "author": "Vadim Fedorenko <vsfedorenko@yandex.ru>",
@@ -37,14 +37,6 @@
       "types": "./dist/browser.d.ts",
       "default": "./dist/browser.js"
     },
-    "./presets/all": {
-      "types": "./dist/presets/all.d.ts",
-      "default": "./dist/presets/all.js"
-    },
-    "./presets/next-only": {
-      "types": "./dist/presets/next-only.d.ts",
-      "default": "./dist/presets/next-only.js"
-    },
     "./reporters/sentry": {
       "types": "./dist/reporters/sentry.d.ts",
       "default": "./dist/reporters/sentry.js"
@@ -56,11 +48,7 @@
     "LICENSE"
   ],
   "sideEffects": [
-    "./dist/index.js",
-    "./dist/presets/all.js",
-    "./dist/presets/next-only.js",
-    "./dist/patches/console.js",
-    "./dist/patches/next.js"
+    "./dist/browser.js"
   ],
   "engines": {
     "node": ">=18"
@@ -71,6 +59,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:e2e": "npm run build && vitest --config vitest.e2e.config.ts run",
     "prepublishOnly": "npm run build && npm test"
   },
   "peerDependencies": {
@@ -80,18 +69,12 @@
   "peerDependenciesMeta": {
     "@sentry/nextjs": {
       "optional": true
-    },
-    "jiti": {
-      "optional": true
     }
   },
-  "dependencies": {
-    "lilconfig": "^3.1.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/node": "^22.0.0",
     "consola": "^3.4.2",
-    "jiti": "^2.0.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0"
   },

package/dist/presets/all.d.ts

@@ -1,14 +0,0 @@
-/**
- * Preset: patch Next.js' logger **and** the global `console.*`.
- *
- * This is the default — importing `@vsfedorenko/next-logger` or `@vsfedorenko/next-logger/presets/all`
- * applies both patches as side effects.
- *
- * Order matters: Next's logger is patched first so its internal calls are
- * already routed through consola before `console` itself is overwritten. Both
- * patches share the same {@link logger} instance.
- */
-import "../patches/next";
-import "../patches/console";
-export {};
-//# sourceMappingURL=all.d.ts.map

package/dist/presets/all.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/presets/all.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,iBAAiB,CAAC;AACzB,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,CAAC"}

package/dist/presets/all.js

@@ -1,15 +0,0 @@
-"use strict";
-/**
- * Preset: patch Next.js' logger **and** the global `console.*`.
- *
- * This is the default — importing `@vsfedorenko/next-logger` or `@vsfedorenko/next-logger/presets/all`
- * applies both patches as side effects.
- *
- * Order matters: Next's logger is patched first so its internal calls are
- * already routed through consola before `console` itself is overwritten. Both
- * patches share the same {@link logger} instance.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-require("../patches/next");
-require("../patches/console");
-//# sourceMappingURL=all.js.map

package/dist/presets/all.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"all.js","sourceRoot":"","sources":["../../src/presets/all.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAEH,2BAAyB;AACzB,8BAA4B"}

package/dist/presets/next-only.d.ts

@@ -1,12 +0,0 @@
-/**
- * Preset: patch Next.js' logger **only**, leaving the global `console.*`
- * untouched.
- *
- * Import `@vsfedorenko/next-logger/presets/next-only` instead of the default entry when you
- * want Next's internal logs routed through consola but prefer to keep
- * `console.log`/`console.error` with their native Node.js formatting (e.g. for
- * terminal-pretty output in development).
- */
-import "../patches/next";
-export {};
-//# sourceMappingURL=next-only.d.ts.map

package/dist/presets/next-only.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"next-only.d.ts","sourceRoot":"","sources":["../../src/presets/next-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,iBAAiB,CAAC;AAEzB,OAAO,EAAE,CAAC"}

package/dist/presets/next-only.js

@@ -1,13 +0,0 @@
-"use strict";
-/**
- * Preset: patch Next.js' logger **only**, leaving the global `console.*`
- * untouched.
- *
- * Import `@vsfedorenko/next-logger/presets/next-only` instead of the default entry when you
- * want Next's internal logs routed through consola but prefer to keep
- * `console.log`/`console.error` with their native Node.js formatting (e.g. for
- * terminal-pretty output in development).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-require("../patches/next");
-//# sourceMappingURL=next-only.js.map

package/dist/presets/next-only.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"next-only.js","sourceRoot":"","sources":["../../src/presets/next-only.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAEH,2BAAyB"}