@vsfedorenko/next-logger 0.1.0 → 0.2.0

package/README.zh.md

@@ -0,0 +1,199 @@
+# @vsfedorenko/next-logger
+
+[![npm version](https://img.shields.io/npm/v/@vsfedorenko/next-logger.svg)](https://www.npmjs.com/package/@vsfedorenko/next-logger)
+
+> 语言：[English](README.md) | [Русский](README.ru.md) | **中文**
+
+**一个面向 Next.js 的通用日志工具包。**
+
+它包装全局的 `console.*`——也就是 Next.js 自身内部日志器所流向的同一个
+接收端——使所有诊断输出都经过一个可按级别控制的
+[consola](https://github.com/unjs/consola) 实例，并提供可插拔的 reporter
+接入结构化 **JSON** 等。无需自定义服务器，无需模块 monkey-patch（在
+Turbopack 下本来就够不着）。
+
+灵感来自 [`sainsburys-tech/next-logger`](https://github.com/sainsburys-tech/next-logger)，
+它用 [pino](https://getpino.io) 实现同样的事。本包将 pino 替换为 consola，
+并通过惯用的 `withLogger()` 配置包装器来传递配置。
+
+## 安装
+
+```sh
+npm install @vsfedorenko/next-logger consola
+# 或
+bun add @vsfedorenko/next-logger consola
+```
+
+`consola` 是 peer 依赖——请与本包一起安装。
+
+## 快速开始
+
+两步。
+
+**1. 包装你的 Next.js 配置**（`next.config.ts`）：
+
+```ts
+import { withLogger } from "@vsfedorenko/next-logger";
+
+export default withLogger({ consola: { level: 4 } })({
+  // ...你的其他 next 配置
+});
+```
+
+**2. 在 instrumentation 中调用 `init()`**（`instrumentation.ts`，项目根目录）：
+
+```ts
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    const { init } = await import("@vsfedorenko/next-logger");
+    init();
+  }
+}
+```
+
+完成。服务端的每一个 `console.*` 调用现在都会经过 consola。Next.js 自身的
+日志（构建输出、路由编译等）也会被捕获——它们共用同一个 `console.*` 接收端。
+
+> 可运行的示例应用见 [`examples/basic/`](examples/basic/)。
+
+## 配置
+
+`withLogger(options)` 通过 Next.js 经过校验的 `env` 配置键将 `options`
+序列化到 `NEXT_LOGGER_CONFIG` 环境变量——构建时内联，运行时读回。不会出现
+"Unrecognized key" 警告，在 webpack 和 Turbopack 下都能工作。
+
+```ts
+withLogger({
+  consola: {
+    level: 4,                          // debug
+    formatOptions: { date: false },    // consola 格式化选项
+  },
+})
+```
+
+仅支持可序列化的 consola 选项（`level`、`formatOptions`、…）。
+
+### 跳过 console 补丁
+
+`init({ console: false })` 构建日志器但不包装 `console.*`。如果你只想要
+配置好的 consola 实例（通过 `getLogger()`）做手动日志、但不想动全局
+`console`，就用这个。
+
+## 日志级别
+
+级别按以下顺序解析：
+
+1. 来自 `withLogger` 的 `consola.level`
+2. `LOG_LEVEL`（数字或名称）
+3. `NEXT_PUBLIC_LOG_LEVEL`（数字或名称）
+4. `3`（info）——默认值
+
+命名级别：`silent` (-∞)、`fatal` (0)、`error` (0)、`warn` (1)、
+`log` (2)、`info` (3)、`success` (3)、`debug` (4)、`trace` (5)、`verbose` (∞)。
+
+## 日志格式
+
+服务端输出格式由环境变量控制：
+
+1. `LOG_FORMAT`（`text` 或 `json`）
+2. `NEXT_PUBLIC_LOG_FORMAT`（同上）
+
+默认回退到 `text`（consola 默认的 pretty reporter）。
+
+### `text`（默认）
+
+人类可读，在 TTY 中带颜色与时间戳——consola 内置的 reporter。适合本地
+开发。
+
+### `json`
+
+按行输出 JSON 到 stdout（错误 → stderr），适合结构化日志聚合器
+（Loki、Datadog、CloudWatch、Elasticsearch）。适合生产环境。
+
+```json
+{"level":"info","type":"log","tag":"console","msg":"API /api/hello hit","date":"2026-07-12T10:00:00.000Z"}
+```
+
+每行包含：
+
+| 字段   | 说明                                                                  |
+|--------|-----------------------------------------------------------------------|
+| `level`| 命名级别（`error`/`warn`/`info`/`debug`/`trace`）                     |
+| `type` | consola 日志类型（`error`、`warn`、`info`、`success`、`ready`、`event` 等）|
+| `tag`  | consola 标签（`next.js`、`console`、…）                               |
+| `msg`  | 消息字符串（多个字符串参数以空格连接）                                |
+| `date` | ISO 8601 时间戳                                                       |
+| `args` | 额外的结构化参数（无则省略）                                          |
+
+错误会被序列化为 `{ name, message, stack }`。循环引用会变成
+`[Circular]`。BigInt 会被转成字符串。
+
+## 浏览器 / Client Components
+
+服务端入口会补丁 `console.*`，这只在 Node.js 中有意义。对于
+Client Components 或任何浏览器端代码，请使用
+**`@vsfedorenko/next-logger/browser`** 子路径：
+
+```ts
+"use client";
+import { logger } from "@vsfedorenko/next-logger/browser";
+
+export function MyComponent() {
+  logger.info("已渲染");
+  logger.warn("弃用提示");
+  return <div>…</div>;
+}
+```
+
+该入口基于环境变量驱动的默认值构建一个 consola 实例（同样的级别解析：
+`LOG_LEVEL` → `NEXT_PUBLIC_LOG_LEVEL` → `3`），不含任何服务端补丁机制。
+若要让级别在构建期内联进浏览器 bundle，请使用 `NEXT_PUBLIC_LOG_LEVEL`。
+
+## 工作原理
+
+1. **配置包装器**（`withLogger`，构建时）——将日志器选项序列化到
+   `NEXT_LOGGER_CONFIG`，通过 Next 的 `env` 键。Next 在构建时将其内联，
+   因此运行时通过 `process.env.NEXT_LOGGER_CONFIG` 读取，无需文件系统或
+   Next.js 内部导入。
+
+2. **Console 接收端补丁**（`patches/console.ts`，运行时）——包装
+   `console.{log,debug,info,warn,error}`，使每次调用都经过共享的 consola
+   实例。`log` 与 `info` 都映射到 consola 的 `info`。
+
+3. **Next 日志分类器**（`patches/next.ts`，运行时）——检查每个 `console.*`
+   调用：如果第一个参数携带 Next.js 标记符号（`▲`、`✓`、`⚠`、`●`、`✗`、…），
+   该行标记为 `next.js`；否则标记为 `console`。这在 Turbopack 下有效，
+   因为旧的基于 `require.cache` 的 monkey-patch 已经失效（Next 的日志器
+   存在于单独的 bundle 实例中）。
+
+### 空消息跳过
+
+当消息为**空**时（没有参数，或只有 `undefined`/`null`/`""`——即没有诊断
+价值、在 consola 下会渲染成一条只有标签而无内容的行），补丁会跳过打印。
+这镜像了 Next.js 自身的行为：`prefixedLog` 在消息为空时会丢弃前缀。
+
+为假但存在的值（`0`、`false`）**不**算作空，会照常打印。
+
+### Turbopack 说明
+
+Next.js 的**启动横幅**（`▲ Next.js`、`✓ Ready`、…）在 instrumentation 钩子
+运行*之前*就打印了，所以这些特定行不会被捕获。启动后发出的任何日志——
+路由编译、请求时输出、你自己的 `console.*` 调用——都会正常经过补丁。
+
+## 与 `sainsburys-tech/next-logger` 的差异
+
+| 关注点     | sainsburys-tech (pino)                    | 本包 (consola)                              |
+|------------|-------------------------------------------|---------------------------------------------|
+| 后端       | pino（JSON 到 stdout）                    | consola（默认 pretty）                      |
+| 配置传递   | `next-logger.config.js` + 预加载          | `withLogger()` 包装器（惯用、类型安全）     |
+| 拦截方式   | 补丁 `next/dist/build/output/log`         | 包装 `console.*` 接收端（Turbopack 安全）   |
+| 参数归一化 | 自定义 `hooks.logMethod`                  | 无需——consola 自带处理 console 风格参数     |
+| 子日志器   | `logger.child({ name })`                  | `consola.withTag(tag)`                      |
+| `trace` 级 | 回退到 `debug`（Winston 无 trace）        | 原生——consola 有 `trace`                    |
+| 默认级别   | 硬编码 `debug`                            | 由环境驱动（`LOG_LEVEL`）                   |
+| Turbopack  | `require.cache` 补丁失效                  | console 接收端——正常工作                    |
+| 语言       | 纯 JS（CommonJS）                         | TypeScript（CJS 输出）                      |
+
+## 许可证
+
+MIT

package/dist/config.d.ts

@@ -1,23 +1,19 @@
 import type { ConsolaInstance, ConsolaOptions } from "consola";
 /**
- * Shape of a `next-logger.config.{js,ts,cjs}` file.
+ * Shape of the config passed to {@link withLogger}, serialised to JSON and
+ * delivered to the runtime via the `NEXT_LOGGER_CONFIG` env var (inlined at
+ * build time by Next.js' `env` config key).
  *
- * The `consola` key may be:
- *   - a {@link ConsolaInstance} (complete custom backend — used directly), or
- *   - a partial {@link ConsolaOptions} object merged on top of the defaults, or
- *   - a factory `(defaults) => ConsolaInstance` (full control, receives the
- *     library's default options as a starting point).
+ * Because the value crosses a build→runtime boundary as JSON, `consola` can
+ * only be a partial options object here (not a live instance or factory). The
+ * full instance/factory forms remain supported when {@link resolveLoggerConfig}
+ * is called directly with such a value (e.g. in tests).
  */
 export interface NextLoggerConfig {
     consola?: ConsolaInstance | Partial<ConsolaOptions> | ((defaults: Partial<ConsolaOptions>) => ConsolaInstance);
 }
 /**
- * Discriminated result of config discovery.
- *
- *   - `kind: "instance"` — the config supplied a consola instance or a factory
- *     that produced one; use it directly.
- *   - `kind: "options"` — the config supplied a partial options object (or no
- *     config at all); build a consola from these merged options.
+ * Discriminated result of config resolution.
  */
 export type ResolvedConfig = {
     readonly kind: "instance";
@@ -26,13 +22,25 @@ export type ResolvedConfig = {
     readonly kind: "options";
     readonly options: Partial<ConsolaOptions>;
 };
+/** The env var that carries the serialised {@link NextLoggerConfig}. */
+export declare const CONFIG_ENV_VAR = "NEXT_LOGGER_CONFIG";
+/**
+ * Resolves a raw config value into a {@link ResolvedConfig}. Pure — exported
+ * for unit testing.
+ */
+export declare function resolveLoggerConfig(raw: NextLoggerConfig | undefined): ResolvedConfig;
 /**
- * Searches for `next-logger.config.{ts,js,cjs,...}` from cwd upward.
+ * Reads the `logger` config delivered by {@link withLogger} via the
+ * `NEXT_LOGGER_CONFIG` env var. Falls back to the bare defaults when the var is
+ * absent or unparseable.
+ *
+ * The access is a LITERAL `process.env.NEXT_LOGGER_CONFIG` (not computed via
+ * the {@link CONFIG_ENV_VAR} constant) so that Next.js' build-time `env`
+ * inlining (DefinePlugin) substitutes the value into the instrumentation
+ * bundle — a computed `process.env[const]` reference would NOT be inlined and
+ * would read `undefined` at runtime.
  *
- * Always returns a value: either a built consola instance (when the config
- * supplied one or a factory) or the options object to build from (the config's
- * partial options merged with defaults, or the bare defaults when no config
- * exists).
+ * Sync and free of any `next` dependency.
  */
 export declare function loadConfig(): ResolvedConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA+C/D;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EACJ,eAAe,GACf,OAAO,CAAC,cAAc,CAAC,GACvB,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,eAAe,CAAC,CAAC;CAC9D;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,cAAc,CA0C3C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI/D;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EACJ,eAAe,GACf,OAAO,CAAC,cAAc,CAAC,GACvB,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,eAAe,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC;AAE5E,wEAAwE;AACxE,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAChC,cAAc,CAiBhB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAQ3C"}

package/dist/config.js

@@ -1,95 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_ENV_VAR = void 0;
+exports.resolveLoggerConfig = resolveLoggerConfig;
 exports.loadConfig = loadConfig;
-const lilconfig_1 = require("lilconfig");
 const defaults_1 = require("./defaults");
 const types_1 = require("./types");
+/** The env var that carries the serialised {@link NextLoggerConfig}. */
+exports.CONFIG_ENV_VAR = "NEXT_LOGGER_CONFIG";
 /**
- * Loader for `.ts` config files.
- *
- * Uses `jiti` when available (the standard transpile-on-require used by
- * Nuxt/consola/tailwind). `jiti` is an optional peer dependency — when absent,
- * a clear error is thrown pointing to the missing package.
- *
- * Lazily required so the default path (no `.ts` config) never pays the jiti
- * import cost.
+ * Resolves a raw config value into a {@link ResolvedConfig}. Pure — exported
+ * for unit testing.
  */
-const tsLoader = (filepath) => {
-    const jiti = tryRequireJiti();
-    if (jiti === null) {
-        throw new Error(`next-logger: cannot load TypeScript config "${filepath}" — install "jiti" (optional peer dependency).`);
-    }
-    return jiti(filepath);
-};
-/**
- * Resolves the `jiti` callable if installed, or returns `null`.
- *
- * `jiti` v2 exports `createJiti`; the returned {@link Jiti} instance extends
- * `NodeRequire`, so it is directly callable as `jiti(filepath)`.
- */
-function tryRequireJiti() {
-    try {
-        const mod = require("jiti");
-        const jiti = mod.createJiti(__filename);
-        return jiti;
-    }
-    catch {
-        return null;
-    }
-}
-// Only register a loader for `.ts`; lilconfig's `defaultLoadersSync` handles
-// `.js`/`.cjs`/`.json` natively via `require(filepath)` / `JSON.parse`.
-const loaders = {
-    ...lilconfig_1.defaultLoadersSync,
-    ".ts": tsLoader,
-};
-/**
- * Searches for `next-logger.config.{ts,js,cjs,...}` from cwd upward.
- *
- * Always returns a value: either a built consola instance (when the config
- * supplied one or a factory) or the options object to build from (the config's
- * partial options merged with defaults, or the bare defaults when no config
- * exists).
- */
-function loadConfig() {
-    const explorer = (0, lilconfig_1.lilconfigSync)("next-logger", {
-        searchPlaces: [
-            "next-logger.config.ts",
-            "next-logger.config.js",
-            "next-logger.config.cjs",
-            ".next-loggerrc.ts",
-            ".next-loggerrc.js",
-            ".next-loggerrc.cjs",
-            ".next-loggerrc",
-            ".next-loggerrc.json",
-            "package.json",
-        ],
-        loaders,
-    });
-    const result = explorer.search();
-    const raw = result?.config;
+function resolveLoggerConfig(raw) {
     const def = raw?.consola;
-    // No config, or config without a `consola` key → bare defaults.
     if (def == null) {
         return { kind: "options", options: defaults_1.defaultConsolaOptions };
     }
-    // Factory — caller receives the library defaults, returns a consola.
     if (typeof def === "function") {
         const factory = def;
         return { kind: "instance", instance: factory(defaults_1.defaultConsolaOptions) };
     }
-    // Consola instance — use as-is (type guard narrows safely).
     if ((0, types_1.isConsolaInstance)(def)) {
         return { kind: "instance", instance: def };
     }
-    // Partial options object — merge with defaults (formatOptions nested).
-    const extra = def;
     return {
         kind: "options",
-        options: mergeOptions(extra),
+        options: mergeOptions(def),
     };
 }
-/** Merges a partial options object with the library defaults. */
+/**
+ * Reads the `logger` config delivered by {@link withLogger} via the
+ * `NEXT_LOGGER_CONFIG` env var. Falls back to the bare defaults when the var is
+ * absent or unparseable.
+ *
+ * The access is a LITERAL `process.env.NEXT_LOGGER_CONFIG` (not computed via
+ * the {@link CONFIG_ENV_VAR} constant) so that Next.js' build-time `env`
+ * inlining (DefinePlugin) substitutes the value into the instrumentation
+ * bundle — a computed `process.env[const]` reference would NOT be inlined and
+ * would read `undefined` at runtime.
+ *
+ * Sync and free of any `next` dependency.
+ */
+function loadConfig() {
+    const json = process.env.NEXT_LOGGER_CONFIG;
+    if (!json)
+        return resolveLoggerConfig(undefined);
+    try {
+        return resolveLoggerConfig(JSON.parse(json));
+    }
+    catch {
+        return resolveLoggerConfig(undefined);
+    }
+}
 function mergeOptions(extra) {
     return {
         ...defaults_1.defaultConsolaOptions,

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAoFA,gCA0CC;AA9HD,yCAA+E;AAE/E,yCAAmD;AACnD,mCAA4C;AAE5C;;;;;;;;;GASG;AACH,MAAM,QAAQ,GAAe,CAAC,QAAgB,EAAW,EAAE;IACzD,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,+CAA+C,QAAQ,gDAAgD,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAA0B,CAAC;QACrD,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,IAA0C,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,wEAAwE;AACxE,MAAM,OAAO,GAA+B;IAC1C,GAAG,8BAAkB;IACrB,KAAK,EAAE,QAAQ;CAChB,CAAC;AA8BF;;;;;;;GAOG;AACH,SAAgB,UAAU;IACxB,MAAM,QAAQ,GAAG,IAAA,yBAAa,EAAC,aAAa,EAAE;QAC5C,YAAY,EAAE;YACZ,uBAAuB;YACvB,uBAAuB;YACvB,wBAAwB;YACxB,mBAAmB;YACnB,mBAAmB;YACnB,oBAAoB;YACpB,gBAAgB;YAChB,qBAAqB;YACrB,cAAc;SACf;QACD,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,EAAE,MAAsC,CAAC;IAC3D,MAAM,GAAG,GAAG,GAAG,EAAE,OAAO,CAAC;IAEzB,gEAAgE;IAChE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAqB,EAAE,CAAC;IAC7D,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,GAA6D,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,gCAAqB,CAAC,EAAE,CAAC;IACxE,CAAC;IAED,4DAA4D;IAC5D,IAAI,IAAA,yBAAiB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC7C,CAAC;IAED,uEAAuE;IACvE,MAAM,KAAK,GAAG,GAA8B,CAAC;IAC7C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,SAAS,YAAY,CAAC,KAA8B;IAClD,OAAO;QACL,GAAG,gCAAqB;QACxB,GAAG,KAAK;QACR,aAAa,EAAE;YACb,GAAG,gCAAqB,CAAC,aAAa;YACtC,GAAG,KAAK,CAAC,aAAa;SACvB;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAmCA,kDAmBC;AAeD,gCAQC;AA5ED,yCAAmD;AACnD,mCAA4C;AA0B5C,wEAAwE;AAC3D,QAAA,cAAc,GAAG,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,GAAiC;IAEjC,MAAM,GAAG,GAAG,GAAG,EAAE,OAAO,CAAC;IAEzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAqB,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,GAA6D,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,gCAAqB,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,IAAA,yBAAiB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,YAAY,CAAC,GAA8B,CAAC;KACtD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,UAAU;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAA8B;IAClD,OAAO;QACL,GAAG,gCAAqB;QACxB,GAAG,KAAK;QACR,aAAa,EAAE;YACb,GAAG,gCAAqB,CAAC,aAAa;YACtC,GAAG,KAAK,CAAC,aAAa;SACvB;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,86 +1,67 @@
 /**
  * # @vsfedorenko/next-logger
  *
- * A universal logging kit for Next.js. Monkeypatches Next.js' internal
- * logger (`next/dist/build/output/log`) and the global `console.*` so all
- * diagnostic output flows through a single level-controllable sink —
- * consola by default, with reporters for Sentry, JSON, and more — without a
- * custom Next.js server.
+ * A universal logging kit for Next.js. Wraps the global `console.*` (which
+ * Next.js' own internal logger also funnels through) so all diagnostic output
+ * flows through a single level-controllable consola sink — without monkey
+ * patching Next's module (which is unreachable under Turbopack).
  *
  * ## Usage
  *
- * ### Instrumentation hook (Next.js ≥ 9.3 / instrumentationHook)
+ * Wrap your Next config and call `init()` from instrumentation:
+ *
+ * ```ts
+ * // next.config.ts
+ * import { withLogger } from "@vsfedorenko/next-logger";
+ *
+ * export default withLogger({ consola: { level: 4 } })({
+ *   // ...your next config
+ * });
+ * ```
  *
  * ```ts
  * // instrumentation.ts (project root)
  * export async function register() {
  *   if (process.env.NEXT_RUNTIME === "nodejs") {
- *     await import("@vsfedorenko/next-logger");
+ *     const { init } = await import("@vsfedorenko/next-logger");
+ *     init();
  *   }
  * }
  * ```
  *
- * The default import applies both patches (Next logger + console). To patch
- * only Next's logger:
- *
- * ```ts
- * await import("@vsfedorenko/next-logger/presets/next-only");
- * ```
- *
- * ### `-r` preload
- *
- * ```sh
- * node -r @vsfedorenko/next-logger server.js
- * ```
+ * `init()` patches `console.*`. To skip patching console, pass
+ * `{ console: false }`.
  *
  * ## Configuration
  *
- * Optional `next-logger.config.ts` (discovered from cwd upward):
+ * `withLogger(options)` serialises `options` into the `NEXT_LOGGER_CONFIG` env
+ * var via Next.js' validated `env` config key (no "Unrecognized key" warning),
+ * inlined at build time and read back at runtime. Only serialisable consola
+ * options are supported (level, formatOptions, …):
  *
  * ```ts
- * import { createConsola } from "consola";
- *
- * export default {
- *   consola: createConsola({ level: 4 }), // full custom instance
- * };
- * ```
- *
- * Or partial options (merged with defaults):
- *
- * ```ts
- * export default {
- *   consola: { level: 4, formatOptions: { date: false } },
- * };
- * ```
- *
- * Or a factory (receives the library's default options):
- *
- * ```ts
- * import type { ConsolaOptions } from "consola";
- *
- * export default {
- *   consola: (defaults: Partial<ConsolaOptions>) =>
- *     createConsola({ ...defaults, level: 5 }),
- * };
+ * withLogger({ consola: { level: 4, formatOptions: { date: false } } })
  * ```
  *
  * ## Log level
  *
- * Without a config file, the level resolves from (in order) `LOG_LEVEL` or
+ * Without `withLogger`, the level resolves from (in order) `LOG_LEVEL` or
  * `NEXT_PUBLIC_LOG_LEVEL` (numeric or named: silent/fatal/error/warn/info/log/
  * debug/trace/verbose), falling back to `3` (info).
  */
-import "./presets/all";
-export { logger } from "./logger";
-export { loadConfig } from "./config";
+export { withLogger } from "./withLogger";
+export type { LoggerPluginOptions } from "./withLogger";
+export { init, getLogger } from "./init";
+export type { InitOptions } from "./init";
+export { buildLogger } from "./logger";
+export { loadConfig, resolveLoggerConfig, CONFIG_ENV_VAR } from "./config";
 export type { NextLoggerConfig, ResolvedConfig } from "./config";
 export { defaultConsolaOptions, resolveFormat } from "./defaults";
 export type { LogFormat } from "./defaults";
 export { createJsonReporter } from "./reporters/json";
-export { patchNext, routeNextMethod, NEXT_PREFIXES } from "./patches/next";
-export type { NextMethodName } from "./patches/next";
 export { patchConsole, routeConsoleMethod, CONSOLE_METHODS } from "./patches/console";
 export type { ConsoleMethodName } from "./patches/console";
+export { isNextLog } from "./patches/next";
 export { isEmptyMessage, skipEmpty } from "./patches/util";
 export type { LogFunction, NextLogFn, NextLogModule } from "./types";
 export type { ConsolaInstance, ConsolaOptions, ConsolaReporter, FormatOptions, InputLogObject, LogLevel, LogObject, LogType, } from "consola";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAEH,OAAO,eAAe,CAAC;AAGvB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIrE,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIrE,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,SAAS,CAAC"}