@vsfedorenko/next-logger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vadim Fedorenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,229 @@
+# @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](https://github.com/unjs/consola) by default,
+with pluggable reporters for **Sentry**, structured **JSON**, and more — without
+a custom Next.js server.
+
+Inspired by [`sainsburys-tech/next-logger`](https://github.com/sainsburys-tech/next-logger),
+which does the same with [pino](https://getpino.io). This package swaps pino
+for consola as the default backend and adds a reporter API so logs can be
+fanned out to any integration (Sentry breadcrumbs, JSON aggregators, …).
+
+## Install
+
+```sh
+bun add @vsfedorenko/next-logger consola
+# or
+npm install @vsfedorenko/next-logger consola
+```
+
+`consola` is a peer dependency — install it alongside this package.
+
+## Usage
+
+### Option A — Instrumentation hook (recommended)
+
+```ts
+// instrumentation.ts (project root)
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("@vsfedorenko/next-logger");
+  }
+}
+```
+
+The default import applies both patches: Next.js' logger **and** the global
+`console.*`.
+
+### Option B — `-r` preload
+
+```sh
+node -r @vsfedorenko/next-logger server.js
+```
+
+### Patch Next only (leave `console` untouched)
+
+```ts
+// instrumentation.ts
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("@vsfedorenko/next-logger/presets/next-only");
+  }
+}
+```
+
+Useful when you want Next's internal logs routed through consola but prefer
+native `console.*` formatting (e.g. in development).
+
+### Browser / Client Components
+
+The main entry (`@vsfedorenko/next-logger`) imports the patch modules, which
+depend on `require.cache` and `lilconfig` — neither exists in a browser bundle.
+For Client Components or any browser-side code, use the
+**`@vsfedorenko/next-logger/browser`** subpath:
+
+```ts
+"use client";
+import { logger } from "@vsfedorenko/next-logger/browser";
+
+export function MyComponent() {
+  logger.info("rendered");
+  logger.warn("deprecation notice");
+  return <div>…</div>;
+}
+```
+
+This entry builds a consola instance from env-driven defaults (same level
+resolution: `LOG_LEVEL` → `NEXT_PUBLIC_LOG_LEVEL` → `3`), without the
+server-side patching machinery. For build-time-inlined levels visible in the
+browser bundle, use `NEXT_PUBLIC_LOG_LEVEL`.
+
+## Configuration
+
+Optional config file (discovered from cwd upward via
+[lilconfig](https://github.com/antonk52/lilconfig)). Supported filenames:
+
+- `next-logger.config.ts` / `next-logger.config.js` / `next-logger.config.cjs`
+- `.next-loggerrc.ts` / `.next-loggerrc.js` / `.next-loggerrc.cjs`
+- `.next-loggerrc` (JSON)
+- `.next-loggerrc.json`
+- `next-logger` key in `package.json`
+
+**TypeScript configs** (`.ts`) are loaded via [jiti](https://github.com/unjs/jiti).
+Install it as an optional peer dependency:
+
+```sh
+bun add -d jiti   # or: npm install -D jiti
+```
+
+### Custom consola instance
+
+```ts
+// next-logger.config.ts
+import { createConsola } from "consola";
+
+export default {
+  consola: createConsola({ level: 4 }),
+};
+```
+
+### Partial options (merged with defaults)
+
+```ts
+import type { ConsolaOptions } from "consola";
+
+export default {
+  consola: { level: 4, formatOptions: { date: false } } satisfies Partial<ConsolaOptions>,
+};
+```
+
+### Factory (receives the library defaults)
+
+```ts
+import type { ConsolaOptions } from "consola";
+import { createConsola } from "consola";
+
+export default {
+  consola: (defaults: Partial<ConsolaOptions>) =>
+    createConsola({ ...defaults, level: 5 }),
+};
+```
+
+## Log level
+
+Without a config file, the level resolves from (in order):
+
+1. `LOG_LEVEL` (numeric or named)
+2. `NEXT_PUBLIC_LOG_LEVEL` (numeric or named)
+
+Falling back to `3` (info).
+
+Named levels: `silent` (-∞), `fatal` (0), `error` (0), `warn` (1),
+`log` (2), `info` (3), `success` (3), `debug` (4), `trace` (5), `verbose` (∞).
+
+## Log format
+
+Server-side output format, controlled by env var:
+
+1. `LOG_FORMAT` (`text` or `json`)
+2. `NEXT_PUBLIC_LOG_FORMAT` (same values)
+
+Falling back to `text` (consola's default pretty reporter).
+
+### `text` (default)
+
+Human-readable, coloured in TTY, with timestamps — consola's built-in reporter.
+Best for local development.
+
+### `json`
+
+Newline-delimited JSON to stdout (errors → stderr), suitable for structured-log
+aggregators (Loki, Datadog, CloudWatch, Elasticsearch). Best for production.
+
+```json
+{"level":"error","type":"error","tag":"next.js","msg":"failed to compile","date":"2026-07-11T13:43:10.712Z"}
+```
+
+Each line contains:
+
+| Field   | Description                                                                  |
+|---------|------------------------------------------------------------------------------|
+| `level` | Named level (`error`/`warn`/`info`/`debug`/`trace`)                          |
+| `type`  | Consola log type (e.g. `error`, `warn`, `info`, `success`, `ready`, `event`) |
+| `tag`   | The consola tag (`next.js`, `console`, `app`, …)                             |
+| `msg`   | The message string (multi-arg strings joined with space)                     |
+| `date`  | ISO 8601 timestamp                                                           |
+| `args`  | Additional structured arguments (omitted when none)                          |
+
+Errors are serialised as `{ name, message, stack }`. Circular references become
+`[Circular]`. BigInts become strings.
+
+Only applies to the server entry (`@vsfedorenko/next-logger`) — the browser
+entry always uses consola's built-in browser reporter. A custom consola instance
+from a config file bypasses format selection entirely.
+
+## How it works
+
+1. **Next.js logger patch** (`patches/next.ts`) — replaces the methods exported
+   by `next/dist/build/output/log` (`wait`, `error`, `warn`, `ready`, `info`,
+   `event`, `trace`) with bound consola methods tagged `next.js`. Preserves the
+   critical Next 13+ workaround: since Next defines these exports as
+   non-configurable accessors, the patch replaces `require.cache[...].exports`
+   with a shallow copy, then redefines each method on the copy.
+
+2. **Console patch** (`patches/console.ts`) — overwrites
+   `console.{log,debug,info,warn,error}` with bound consola methods tagged
+   `console`. `log` and `info` both map to consola `info`.
+
+Both patches share a single consola instance built by `logger.ts`, so the log
+level is controllable from one place.
+
+### Empty-message skipping
+
+Both patches skip printing when a message is **empty** — no arguments, or only
+`undefined`/`null`/`""` (values that carry no diagnostic value and would render
+as a bare tag line under consola). This mirrors Next.js' own behaviour, where
+`prefixedLog` drops the prefix when the message is empty.
+
+Falsy-but-present values (`0`, `false`) are **not** considered empty and are
+printed normally.
+
+## Differences from `sainsburys-tech/next-logger`
+
+| Concern           | sainsburys-tech (pino)                        | this package (consola)                          |
+|-------------------|-----------------------------------------------|-------------------------------------------------|
+| Backend           | pino (JSON to stdout)                         | consola (pretty by default)                     |
+| Arg normalisation | custom `hooks.logMethod`                      | not needed — consola handles console-style args |
+| Child logger      | `logger.child({ name })`                      | `consola.withTag(tag)`                          |
+| Custom backend    | any logger with `.child()` (pino, winston, …) | consola instances / options only                |
+| `trace` level     | falls back to `debug` (Winston has no trace)  | native — consola has `trace`                    |
+| Default level     | hardcoded `debug`                             | env-driven (`LOG_LEVEL`)                        |
+| Language          | plain JS (CommonJS)                           | TypeScript (CJS output)                         |
+
+## License
+
+MIT

package/dist/browser.d.ts

@@ -0,0 +1,41 @@
+/**
+ * # @vsfedorenko/next-logger/browser
+ *
+ * Browser-safe entry — exports a consola instance built from env-driven
+ * defaults, WITHOUT the server-side patching machinery.
+ *
+ * Use this from Client Components or any browser code:
+ *
+ * ```ts
+ * import { logger } from "@vsfedorenko/next-logger/browser";
+ *
+ * logger.info("hello from the browser");
+ * logger.warn("deprecation notice");
+ * ```
+ *
+ * ## Why a separate entry?
+ *
+ * The main entry (`@vsfedorenko/next-logger`) imports the patch modules, which
+ * depend on `require.cache` and `lilconfig` (filesystem) — neither of which
+ * exists in a browser bundle. This entry skips those entirely and builds the
+ * consola instance directly from {@link defaultConsolaOptions}.
+ *
+ * ## Level resolution
+ *
+ * Same as the server entry: `LOG_LEVEL` → `NEXT_PUBLIC_LOG_LEVEL` → `3` (info).
+ * For values inlined at build time (visible in the browser bundle), use
+ * `NEXT_PUBLIC_LOG_LEVEL`.
+ */
+/**
+ * The shared consola instance for browser use.
+ *
+ * Built once from {@link defaultConsolaOptions}. Unlike the server entry, there
+ * is no config-file discovery (the browser has no filesystem). Override the
+ * level at runtime via `logger.level = N`.
+ */
+export declare const logger: import("consola").ConsolaInstance;
+export { defaultConsolaOptions } from "./defaults";
+export { isEmptyMessage, skipEmpty } from "./patches/util";
+export type { LogFunction, NextLogFn } from "./types";
+export type { ConsolaInstance, ConsolaOptions, FormatOptions, LogLevel, LogObject, LogType, } from "consola";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,mCAAuC,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,SAAS,CAAC"}

package/dist/browser.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * # @vsfedorenko/next-logger/browser
+ *
+ * Browser-safe entry — exports a consola instance built from env-driven
+ * defaults, WITHOUT the server-side patching machinery.
+ *
+ * Use this from Client Components or any browser code:
+ *
+ * ```ts
+ * import { logger } from "@vsfedorenko/next-logger/browser";
+ *
+ * logger.info("hello from the browser");
+ * logger.warn("deprecation notice");
+ * ```
+ *
+ * ## Why a separate entry?
+ *
+ * The main entry (`@vsfedorenko/next-logger`) imports the patch modules, which
+ * depend on `require.cache` and `lilconfig` (filesystem) — neither of which
+ * exists in a browser bundle. This entry skips those entirely and builds the
+ * consola instance directly from {@link defaultConsolaOptions}.
+ *
+ * ## Level resolution
+ *
+ * Same as the server entry: `LOG_LEVEL` → `NEXT_PUBLIC_LOG_LEVEL` → `3` (info).
+ * For values inlined at build time (visible in the browser bundle), use
+ * `NEXT_PUBLIC_LOG_LEVEL`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skipEmpty = exports.isEmptyMessage = exports.defaultConsolaOptions = exports.logger = void 0;
+const consola_1 = require("consola");
+const defaults_1 = require("./defaults");
+/**
+ * The shared consola instance for browser use.
+ *
+ * Built once from {@link defaultConsolaOptions}. Unlike the server entry, there
+ * is no config-file discovery (the browser has no filesystem). Override the
+ * level at runtime via `logger.level = N`.
+ */
+exports.logger = (0, consola_1.createConsola)(defaults_1.defaultConsolaOptions);
+var defaults_2 = require("./defaults");
+Object.defineProperty(exports, "defaultConsolaOptions", { enumerable: true, get: function () { return defaults_2.defaultConsolaOptions; } });
+var util_1 = require("./patches/util");
+Object.defineProperty(exports, "isEmptyMessage", { enumerable: true, get: function () { return util_1.isEmptyMessage; } });
+Object.defineProperty(exports, "skipEmpty", { enumerable: true, get: function () { return util_1.skipEmpty; } });
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAEH,qCAAwC;AACxC,yCAAmD;AAEnD;;;;;;GAMG;AACU,QAAA,MAAM,GAAG,IAAA,uBAAa,EAAC,gCAAqB,CAAC,CAAC;AAE3D,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA;AAC9B,uCAA2D;AAAlD,sGAAA,cAAc,OAAA;AAAE,iGAAA,SAAS,OAAA"}

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+import type { ConsolaInstance, ConsolaOptions } from "consola";
+/**
+ * Shape of a `next-logger.config.{js,ts,cjs}` file.
+ *
+ * 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).
+ */
+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.
+ */
+export type ResolvedConfig = {
+    readonly kind: "instance";
+    readonly instance: ConsolaInstance;
+} | {
+    readonly kind: "options";
+    readonly options: Partial<ConsolaOptions>;
+};
+/**
+ * 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).
+ */
+export declare function loadConfig(): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +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"}

package/dist/config.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const lilconfig_1 = require("lilconfig");
+const defaults_1 = require("./defaults");
+const types_1 = require("./types");
+/**
+ * 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.
+ */
+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;
+    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),
+    };
+}
+/** Merges a partial options object with the library defaults. */
+function mergeOptions(extra) {
+    return {
+        ...defaults_1.defaultConsolaOptions,
+        ...extra,
+        formatOptions: {
+            ...defaults_1.defaultConsolaOptions.formatOptions,
+            ...extra.formatOptions,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +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"}

package/dist/defaults.d.ts

@@ -0,0 +1,31 @@
+import { type LogType, type ConsolaOptions } from "consola";
+export declare const LEVEL_TO_NAME: Readonly<Record<number, LogType>>;
+/**
+ * Supported log output formats.
+ *
+ *   - `text` — consola's default pretty reporter (human-readable, coloured in TTY).
+ *   - `json` — newline-delimited JSON to stdout/stderr (structured logging).
+ *
+ * Server-only; the browser entry always uses consola's built-in browser reporter.
+ */
+export type LogFormat = "text" | "json";
+/**
+ * Resolves the log format from the environment.
+ *
+ * Priority: `LOG_FORMAT` → `NEXT_PUBLIC_LOG_FORMAT` → `text`.
+ *
+ * Accepts `text`/`json` (case-insensitive). Unknown values fall back to `text`.
+ */
+export declare function resolveFormat(): LogFormat;
+/**
+ * Default consola options for the patched loggers.
+ *
+ * Unlike the pino original, consola already normalises console-style multi-arg
+ * signatures (strings, objects, errors, mixed), so there is no need for a
+ * `logMethod` hook. The level is env-driven instead of hardcoded.
+ *
+ * `colors` is intentionally omitted — consola auto-detects TTY and `CI`
+ * internally, so duplicating that logic here would be fragile.
+ */
+export declare const defaultConsolaOptions: Readonly<Partial<ConsolaOptions>>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAyBtF,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAaxD,CAAC;AAoDL;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAIzC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAMnE,CAAC"}

package/dist/defaults.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConsolaOptions = exports.LEVEL_TO_NAME = void 0;
+exports.resolveFormat = resolveFormat;
+const consola_1 = require("consola");
+/**
+ * Reverse lookup: consola numeric level → canonical name.
+ *
+ * Built by inverting consola's exported `LogLevels` (`Record<LogType, number>`),
+ * so this is always in sync with the actual library — no hand-rolled map that
+ * can drift. Multiple `LogType` values share the same numeric level (e.g.
+ * `fatal`/`error` → `0`, `info`/`success`/`ready`/`start`/`box` → `3`).
+ *
+ * When multiple names share a level, a priority list picks the most
+ * universally understood name (e.g. `"error"` over `"fatal"` for level `0`,
+ * `"info"` over `"success"`/`"ready"` etc. for level `3`).
+ */
+const PREFERRED_NAMES = [
+    "silent",
+    "error", // preferred over "fatal" for level 0
+    "warn",
+    "log",
+    "info", // preferred over "success"/"fail"/"ready"/"start"/"box" for level 3
+    "debug",
+    "trace",
+    "verbose",
+];
+exports.LEVEL_TO_NAME = (() => {
+    const inv = {};
+    // First pass: populate from PREFERRED_NAMES in priority order.
+    for (const name of PREFERRED_NAMES) {
+        const level = consola_1.LogLevels[name];
+        if (!(level in inv))
+            inv[level] = name;
+    }
+    // Second pass: fill any remaining levels from LogLevels (e.g. -Infinity for
+    // "silent" is already covered, but this catches edge cases).
+    for (const [name, level] of Object.entries(consola_1.LogLevels)) {
+        if (!(level in inv))
+            inv[level] = name;
+    }
+    return inv;
+})();
+/**
+ * Forward lookup: canonical name → consola numeric level.
+ *
+ * Directly derived from `LogLevels` — the authoritative source.
+ */
+const NAME_TO_LEVEL = Object.fromEntries(Object.entries(consola_1.LogLevels));
+/**
+ * Clamps an arbitrary number to consola's finite numeric level range `[0, 5]`.
+ *
+ * `-Infinity` (silent) and `Infinity` (verbose) are consola's sentinels; we
+ * collapse them to `0` and `5` respectively for env-var-driven configuration
+ * (users typing `LOG_LEVEL=999` get `5` = trace, not an unbounded value).
+ */
+function clampLevel(n) {
+    if (n <= 0)
+        return 0;
+    if (n >= 5)
+        return 5;
+    return Math.floor(n);
+}
+/**
+ * Resolves the default log level from the environment.
+ *
+ * Priority: `process.env.LOG_LEVEL` (numeric or named) →
+ * `process.env.NEXT_PUBLIC_LOG_LEVEL` (same rules; useful when the value must
+ * be inlined at build time) → `3` (info).
+ *
+ * Named values are resolved against consola's canonical `LogLevels` map.
+ * Numeric values are clamped to `[0, 5]`.
+ */
+function resolveLevel() {
+    for (const raw of [process.env.LOG_LEVEL, process.env.NEXT_PUBLIC_LOG_LEVEL]) {
+        if (raw === undefined || raw === "")
+            continue;
+        const numeric = Number(raw);
+        if (!Number.isNaN(numeric)) {
+            return clampLevel(numeric);
+        }
+        const mapped = NAME_TO_LEVEL[raw.toLowerCase()];
+        if (mapped !== undefined) {
+            return mapped;
+        }
+    }
+    return 3; // info
+}
+/**
+ * Resolves the log format from the environment.
+ *
+ * Priority: `LOG_FORMAT` → `NEXT_PUBLIC_LOG_FORMAT` → `text`.
+ *
+ * Accepts `text`/`json` (case-insensitive). Unknown values fall back to `text`.
+ */
+function resolveFormat() {
+    const raw = process.env.LOG_FORMAT ?? process.env.NEXT_PUBLIC_LOG_FORMAT;
+    if (raw === undefined || raw === "")
+        return "text";
+    return raw.toLowerCase() === "json" ? "json" : "text";
+}
+/**
+ * Default consola options for the patched loggers.
+ *
+ * Unlike the pino original, consola already normalises console-style multi-arg
+ * signatures (strings, objects, errors, mixed), so there is no need for a
+ * `logMethod` hook. The level is env-driven instead of hardcoded.
+ *
+ * `colors` is intentionally omitted — consola auto-detects TTY and `CI`
+ * internally, so duplicating that logic here would be fragile.
+ */
+exports.defaultConsolaOptions = {
+    level: resolveLevel(),
+    formatOptions: {
+        date: true,
+        compact: false,
+    },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":";;;AA2GA,sCAIC;AA/GD,qCAAsF;AAEtF;;;;;;;;;;;GAWG;AACH,MAAM,eAAe,GAAuB;IAC1C,QAAQ;IACR,OAAO,EAAE,qCAAqC;IAC9C,MAAM;IACN,KAAK;IACL,MAAM,EAAE,oEAAoE;IAC5E,OAAO;IACP,OAAO;IACP,SAAS;CACV,CAAC;AAEW,QAAA,aAAa,GAAsC,CAAC,GAAG,EAAE;IACpE,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,+DAA+D;IAC/D,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,mBAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,CAAC;IACD,4EAA4E;IAC5E,6DAA6D;IAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAS,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,IAAe,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,EAAE,CAAC;AAEL;;;;GAIG;AACH,MAAM,aAAa,GAAqC,MAAM,CAAC,WAAW,CACxE,MAAM,CAAC,OAAO,CAAC,mBAAS,CAAC,CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAa,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,YAAY;IACnB,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC7E,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS;QAE9C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,CAAC,OAAO;AACnB,CAAC;AAYD;;;;;;GAMG;AACH,SAAgB,aAAa;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACzE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC;AAED;;;;;;;;;GASG;AACU,QAAA,qBAAqB,GAAsC;IACtE,KAAK,EAAE,YAAY,EAAE;IACrB,aAAa,EAAE;QACb,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;KACf;CACF,CAAC"}