@vsfedorenko/next-logger 0.1.0

package/dist/presets/all.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * 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

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

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

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

package/dist/reporters/json.d.ts

@@ -0,0 +1,37 @@
+/**
+ * JSON reporter for consola — emits each log as a single-line JSON object to
+ * stdout (or stderr for error+), suitable for structured-log aggregators
+ * (Loki, Datadog, CloudWatch, Elasticsearch, …).
+ *
+ * Output shape (stable):
+ *
+ * ```json
+ * {"level":"error","type":"error","tag":"next.js","msg":"failed to compile","date":"2026-07-11T13:43:10.712Z"}
+ * ```
+ *
+ *   - `level` — consola's named level (`silent`/`error`/`warn`/`info`/`debug`/`trace`/`verbose`/…).
+ *   - `type`  — consola's log type (usually matches `level`, but Next.js
+ *     distinguishes `event`, `ready`, `wait` etc.).
+ *   - `tag`   — the consola tag (`next.js`, `console`, `app`, …).
+ *   - `msg`   — the interpolated message string (multi-arg args joined with space).
+ *   - `args`  — additional structured arguments beyond the message (objects,
+ *     errors). Omitted when there are no extra args.
+ *   - `date`  — ISO 8601 timestamp.
+ *
+ * Errors are serialised as `{ message, stack, name }` so stack traces survive
+ * in log aggregators.
+ */
+import type { ConsolaReporter } from "consola";
+/**
+ * Creates a JSON reporter that writes to `process.stdout` / `process.stderr`.
+ *
+ *   - Error-level messages (level ≤ 1) go to **stderr** (conventional for
+ *     structured logs, keeps stdout clean for piping).
+ *   - Everything else goes to **stdout**.
+ *
+ * @param overrideStream force all output to a single stream (useful for tests).
+ */
+export declare function createJsonReporter(overrideStream?: {
+    write: (s: string) => boolean;
+}): ConsolaReporter;
+//# sourceMappingURL=json.d.ts.map

package/dist/reporters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/reporters/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,SAAS,CAAC;AA6D1E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACjD,eAAe,CAyBjB"}

package/dist/reporters/json.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * JSON reporter for consola — emits each log as a single-line JSON object to
+ * stdout (or stderr for error+), suitable for structured-log aggregators
+ * (Loki, Datadog, CloudWatch, Elasticsearch, …).
+ *
+ * Output shape (stable):
+ *
+ * ```json
+ * {"level":"error","type":"error","tag":"next.js","msg":"failed to compile","date":"2026-07-11T13:43:10.712Z"}
+ * ```
+ *
+ *   - `level` — consola's named level (`silent`/`error`/`warn`/`info`/`debug`/`trace`/`verbose`/…).
+ *   - `type`  — consola's log type (usually matches `level`, but Next.js
+ *     distinguishes `event`, `ready`, `wait` etc.).
+ *   - `tag`   — the consola tag (`next.js`, `console`, `app`, …).
+ *   - `msg`   — the interpolated message string (multi-arg args joined with space).
+ *   - `args`  — additional structured arguments beyond the message (objects,
+ *     errors). Omitted when there are no extra args.
+ *   - `date`  — ISO 8601 timestamp.
+ *
+ * Errors are serialised as `{ message, stack, name }` so stack traces survive
+ * in log aggregators.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJsonReporter = createJsonReporter;
+const defaults_1 = require("../defaults");
+/**
+ * Serialises an `Error` into a JSON-safe plain object (preserves stack + cause).
+ */
+function serializeError(err) {
+    const obj = {
+        name: err.name,
+        message: err.message,
+        stack: err.stack,
+    };
+    if (err.cause !== undefined) {
+        obj.cause = err.cause instanceof Error ? serializeError(err.cause) : err.cause;
+    }
+    return obj;
+}
+/**
+ * Makes any value JSON-safe — recursively converts BigInt, Error, circular
+ * references, and class instances into plain objects.
+ */
+function jsonSafe(value, seen = new WeakSet()) {
+    if (value === null || value === undefined)
+        return value;
+    switch (typeof value) {
+        case "string":
+        case "number":
+        case "boolean":
+            return value;
+        case "bigint":
+            return String(value);
+        case "function":
+            return `[Function: ${value.name || "anonymous"}]`;
+        case "symbol":
+            return String(value);
+        case "object": {
+            // Circular reference guard.
+            if (seen.has(value))
+                return "[Circular]";
+            seen.add(value);
+            if (value instanceof Date)
+                return value.toISOString();
+            if (value instanceof Error)
+                return serializeError(value);
+            if (value instanceof RegExp)
+                return value.toString();
+            if (Array.isArray(value)) {
+                return value.map((v) => jsonSafe(v, seen));
+            }
+            const obj = value;
+            const result = {};
+            for (const [key, val] of Object.entries(obj)) {
+                result[key] = jsonSafe(val, seen);
+            }
+            return result;
+        }
+        default:
+            return String(value);
+    }
+}
+/**
+ * Creates a JSON reporter that writes to `process.stdout` / `process.stderr`.
+ *
+ *   - Error-level messages (level ≤ 1) go to **stderr** (conventional for
+ *     structured logs, keeps stdout clean for piping).
+ *   - Everything else goes to **stdout**.
+ *
+ * @param overrideStream force all output to a single stream (useful for tests).
+ */
+function createJsonReporter(overrideStream) {
+    return {
+        log(logObj, _ctx) {
+            const msg = buildMessage(logObj.args);
+            const extra = buildExtraArgs(logObj.args);
+            const entry = {
+                level: defaults_1.LEVEL_TO_NAME[logObj.level] ?? "info",
+                type: logObj.type,
+                tag: logObj.tag ?? "",
+                msg,
+                date: logObj.date instanceof Date ? logObj.date.toISOString() : logObj.date,
+            };
+            // Include extra structured args when present.
+            if (extra !== undefined) {
+                entry.args = extra;
+            }
+            const line = JSON.stringify(jsonSafe(entry)) + "\n";
+            const stream = overrideStream ?? selectStream(logObj.level);
+            stream.write(line);
+        },
+    };
+}
+/** Selects stdout for info+ messages, stderr for error-level. */
+function selectStream(level) {
+    if (level <= 1) {
+        return process.stderr ?? process.stdout;
+    }
+    return process.stdout;
+}
+/**
+ * Extracts the message string from consola args.
+ *
+ * Following the upstream sainsburys-tech/next-logger convention: string args
+ * are joined with a space. The first non-string arg (object/error) is NOT part
+ * of the message — it goes into `args`.
+ */
+function buildMessage(args) {
+    const parts = [];
+    for (const arg of args) {
+        if (typeof arg === "string") {
+            parts.push(arg);
+        }
+        else if (arg instanceof Error) {
+            parts.push(arg.message);
+        }
+        else {
+            break; // stop at the first non-string, non-error arg
+        }
+    }
+    return parts.join(" ");
+}
+/**
+ * Extracts structured arguments beyond the message string — objects, errors,
+ * and non-string values that carry diagnostic metadata.
+ *
+ * Returns `undefined` when there are no extra args (keeps the JSON output clean).
+ */
+function buildExtraArgs(args) {
+    const extra = [];
+    for (const arg of args) {
+        if (typeof arg === "string")
+            continue;
+        extra.push(arg);
+    }
+    return extra.length > 0 ? extra : undefined;
+}
+//# sourceMappingURL=json.js.map

package/dist/reporters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/reporters/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;AAwEH,gDA2BC;AAhGD,0CAA4C;AAE5C;;GAEG;AACH,SAAS,cAAc,CAAC,GAAU;IAChC,MAAM,GAAG,GAA4B;QACnC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;IACF,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,KAAc,EAAE,OAAwB,IAAI,OAAO,EAAE;IACrE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAExD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,UAAU;YACb,OAAO,cAAc,KAAK,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;QACpD,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,4BAA4B;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC;gBAAE,OAAO,YAAY,CAAC;YACnD,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;YAE1B,IAAI,KAAK,YAAY,IAAI;gBAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;YACtD,IAAI,KAAK,YAAY,KAAK;gBAAE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;YACzD,IAAI,KAAK,YAAY,MAAM;gBAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;YAErD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD;YACE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAChC,cAAkD;IAElD,OAAO;QACL,GAAG,CAAC,MAAiB,EAAE,IAAiC;YACtD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE1C,MAAM,KAAK,GAA4B;gBACrC,KAAK,EAAE,wBAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM;gBAC5C,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;gBACrB,GAAG;gBACH,IAAI,EAAE,MAAM,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI;aAC5E,CAAC;YAEF,8CAA8C;YAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC;YACrB,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;YAEpD,MAAM,MAAM,GAAG,cAAc,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,IAAe;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,8CAA8C;QACvD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,IAAe;IACrC,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QACtC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/dist/reporters/sentry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Sentry breadcrumb reporter for consola — mirrors every browser log entry
+ * into Sentry as a **breadcrumb**.
+ *
+ * Breadcrumbs are NOT events — they don't create issues or cost anything on
+ * their own. They attach as context to the next real error captured by
+ * Sentry, giving you the full log trail that led to a crash.
+ *
+ * ## Optional dependency
+ *
+ * `@sentry/nextjs` is an **optional** peer dependency. The reporter resolves
+ * it lazily via dynamic `import()` inside `log()`. If the consumer hasn't
+ * installed `@sentry/nextjs`, the import rejects, the reporter catches it,
+ * and subsequent calls become a silent no-op — the logger keeps working.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * // instrumentation-client.ts (or sentry.client.config.ts)
+ * import { logger } from "@vsfedorenko/next-logger/browser";
+ * import { createSentryBreadcrumbReporter } from "@vsfedorenko/next-logger/reporters/sentry";
+ *
+ * Sentry.init({ dsn: process.env.NEXT_PUBLIC_SENTRY_DSN });
+ * logger.addReporter(createSentryBreadcrumbReporter());
+ * ```
+ *
+ * Attach AFTER `Sentry.init` so the lazily-resolved client is ready. Safe to
+ * attach unconditionally — `addBreadcrumb` is a no-op when no DSN is set.
+ */
+import type { ConsolaReporter, LogObject } from "consola";
+/**
+ * Sentry severity levels, ordered from highest to lowest.
+ *
+ * Mirrored here (not imported from `@sentry/nextjs`) so this module has **zero
+ * static dependency** on Sentry — the type alias is compile-time only and
+ * erased in the output.
+ */
+type SeverityLevel = "fatal" | "error" | "warning" | "log" | "info" | "debug";
+/**
+ * The shape of a Sentry breadcrumb — the subset of fields this reporter
+ * populates. Defined locally to avoid importing from `@sentry/nextjs`.
+ */
+interface SentryBreadcrumb {
+    level?: SeverityLevel;
+    category?: string;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Build a Sentry breadcrumb from a consola log object.
+ *
+ * Pure function — no Sentry dependency, fully testable in isolation.
+ *
+ * - String arguments and `logObj.message` are joined into `message`.
+ * - `Error` instances go into `data` as `{ name, message }` (stack is omitted
+ *   — breadcrumbs are one-line context, not stack traces).
+ * - Plain objects go into `data` keyed by argument position.
+ */
+export declare function logObjectToBreadcrumb(logObj: LogObject): SentryBreadcrumb;
+/**
+ * Create a consola reporter that forwards every log entry to
+ * `Sentry.addBreadcrumb`.
+ *
+ * The reporter is safe to attach unconditionally:
+ * - `@sentry/nextjs` not installed → silent no-op (cached failed import).
+ * - Installed but no DSN configured → `addBreadcrumb` is a no-op internally.
+ */
+export declare function createSentryBreadcrumbReporter(): ConsolaReporter;
+export {};
+//# sourceMappingURL=sentry.d.ts.map

package/dist/reporters/sentry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.d.ts","sourceRoot":"","sources":["../../src/reporters/sentry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAI1D;;;;;;GAMG;AACH,KAAK,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAoB9E;;;GAGG;AACH,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CA0BzE;AA2BD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,IAAI,eAAe,CAOhE"}

package/dist/reporters/sentry.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Sentry breadcrumb reporter for consola — mirrors every browser log entry
+ * into Sentry as a **breadcrumb**.
+ *
+ * Breadcrumbs are NOT events — they don't create issues or cost anything on
+ * their own. They attach as context to the next real error captured by
+ * Sentry, giving you the full log trail that led to a crash.
+ *
+ * ## Optional dependency
+ *
+ * `@sentry/nextjs` is an **optional** peer dependency. The reporter resolves
+ * it lazily via dynamic `import()` inside `log()`. If the consumer hasn't
+ * installed `@sentry/nextjs`, the import rejects, the reporter catches it,
+ * and subsequent calls become a silent no-op — the logger keeps working.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * // instrumentation-client.ts (or sentry.client.config.ts)
+ * import { logger } from "@vsfedorenko/next-logger/browser";
+ * import { createSentryBreadcrumbReporter } from "@vsfedorenko/next-logger/reporters/sentry";
+ *
+ * Sentry.init({ dsn: process.env.NEXT_PUBLIC_SENTRY_DSN });
+ * logger.addReporter(createSentryBreadcrumbReporter());
+ * ```
+ *
+ * Attach AFTER `Sentry.init` so the lazily-resolved client is ready. Safe to
+ * attach unconditionally — `addBreadcrumb` is a no-op when no DSN is set.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logObjectToBreadcrumb = logObjectToBreadcrumb;
+exports.createSentryBreadcrumbReporter = createSentryBreadcrumbReporter;
+/**
+ * Map consola's numeric level to Sentry's breadcrumb severity.
+ *
+ * Consola: 0=error/fatal, 1=warn, 2=log, 3=info, 4=debug, 5=trace/verbose.
+ *
+ * `fatal` and `error` both collapse to Sentry `error` — breadcrumbs are
+ * diagnostic context, not standalone error events. Real error capture goes
+ * through `captureException` / `onRequestError`.
+ */
+const SEVERITY_MAP = [
+    "error", // 0 — error / fatal
+    "warning", // 1 — warn
+    "log", // 2 — log
+    "info", // 3 — info / success / ready
+    "debug", // 4 — debug
+    "debug", // 5 — trace / verbose
+];
+/**
+ * Build a Sentry breadcrumb from a consola log object.
+ *
+ * Pure function — no Sentry dependency, fully testable in isolation.
+ *
+ * - String arguments and `logObj.message` are joined into `message`.
+ * - `Error` instances go into `data` as `{ name, message }` (stack is omitted
+ *   — breadcrumbs are one-line context, not stack traces).
+ * - Plain objects go into `data` keyed by argument position.
+ */
+function logObjectToBreadcrumb(logObj) {
+    const level = SEVERITY_MAP[Math.max(0, Math.min(5, logObj.level))] ?? "info";
+    const args = logObj.args ?? [];
+    const messageParts = [];
+    const data = {};
+    if (logObj.message)
+        messageParts.push(logObj.message);
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg instanceof Error) {
+            data[`arg_${i}`] = { name: arg.name, message: arg.message };
+        }
+        else if (typeof arg === "object" && arg !== null) {
+            data[`arg_${i}`] = arg;
+        }
+        else {
+            messageParts.push(String(arg));
+        }
+    }
+    return {
+        level,
+        category: logObj.tag || "console",
+        message: messageParts.length > 0 ? messageParts.join(" ") : undefined,
+        data: Object.keys(data).length > 0 ? data : undefined,
+    };
+}
+let sentryPromise = null;
+/**
+ * Lazily resolve the `@sentry/nextjs` module.
+ *
+ * The import is attempted once and cached:
+ * - If the consumer has `@sentry/nextjs` installed → resolves to the module.
+ * - If not installed → the rejection is caught and `null` is cached, making
+ *   subsequent `log()` calls a silent no-op without retrying.
+ */
+function getSentry() {
+    if (sentryPromise)
+        return sentryPromise;
+    sentryPromise = Promise.resolve().then(() => __importStar(require("@sentry/nextjs"))).then((mod) => mod)
+        .catch(() => null);
+    return sentryPromise;
+}
+/**
+ * Create a consola reporter that forwards every log entry to
+ * `Sentry.addBreadcrumb`.
+ *
+ * The reporter is safe to attach unconditionally:
+ * - `@sentry/nextjs` not installed → silent no-op (cached failed import).
+ * - Installed but no DSN configured → `addBreadcrumb` is a no-op internally.
+ */
+function createSentryBreadcrumbReporter() {
+    return {
+        log(logObj) {
+            const crumb = logObjectToBreadcrumb(logObj);
+            void getSentry().then((sentry) => sentry?.addBreadcrumb(crumb));
+        },
+    };
+}
+//# sourceMappingURL=sentry.js.map

package/dist/reporters/sentry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.js","sourceRoot":"","sources":["../../src/reporters/sentry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDH,sDA0BC;AAmCD,wEAOC;AA3GD;;;;;;;;GAQG;AACH,MAAM,YAAY,GAA6B;IAC7C,OAAO,EAAE,oBAAoB;IAC7B,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,6BAA6B;IACrC,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,sBAAsB;CAChC,CAAC;AAaF;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAE7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,IAAI,GAA4B,EAAE,CAAC;IAEzC,IAAI,MAAM,CAAC,OAAO;QAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC9D,CAAC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,QAAQ,EAAE,MAAM,CAAC,GAAG,IAAI,SAAS;QACjC,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QACrE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACtD,CAAC;AACJ,CAAC;AASD,IAAI,aAAa,GAAoC,IAAI,CAAC;AAE1D;;;;;;;GAOG;AACH,SAAS,SAAS;IAChB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,aAAa,GAAG,kDAAO,gBAAgB,IACpC,IAAI,CAAC,CAAC,GAAa,EAAE,EAAE,CAAC,GAAG,CAAC;SAC5B,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,8BAA8B;IAC5C,OAAO;QACL,GAAG,CAAC,MAAiB;YACnB,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAC5C,KAAK,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Central type definitions for @vsfedorenko/next-logger.
+ *
+ * Re-exports consola's core types so consumers don't need to depend on consola
+ * directly for type-only imports, and defines the shape of the Next.js log
+ * module we patch.
+ */
+import type { ConsolaInstance } from "consola";
+/**
+ * A variadic log function — the common shape shared by `console.*`,
+ * consola's `LogFn`, and Next.js' log methods. Accepts any arguments
+ * (strings, objects, errors, mixed) and returns void.
+ */
+export type LogFunction = (...args: unknown[]) => void;
+/**
+ * A Next.js log method signature. Identical to {@link LogFunction} but named
+ * to document that it matches the methods exported by
+ * `next/dist/build/output/log`.
+ */
+export type NextLogFn = (...args: unknown[]) => void;
+/**
+ * The shape of `next/dist/build/output/log` that we patch.
+ *
+ * Based on the actual exports of Next.js 13+ (see
+ * `next/dist/build/output/log.d.ts`):
+ *
+ *   - `prefixes` — a record mapping each method name to its coloured
+ *     symbol (○ ⨯ ⚠ ▲ etc.).
+ *   - `wait`/`error`/`warn`/`ready`/`info`/`event`/`trace` — the prefix-based
+ *     log methods we replace.
+ *   - `bootstrap` — a raw `console.log` (single `message` string, no prefix).
+ *   - `warnOnce`/`errorOnce` — deduplicating wrappers (optional — older
+ *     Next versions don't export them).
+ */
+export interface NextLogModule {
+    readonly prefixes: Record<string, string>;
+    wait: NextLogFn;
+    error: NextLogFn;
+    warn: NextLogFn;
+    ready: NextLogFn;
+    info: NextLogFn;
+    event: NextLogFn;
+    trace: NextLogFn;
+    bootstrap: (message: string) => void;
+    warnOnce?: NextLogFn;
+    errorOnce?: NextLogFn;
+}
+/**
+ * Type guard: narrows `unknown` to {@link ConsolaInstance} by checking for the
+ * two methods both patches depend on (`.withTag()` + `.log()`).
+ *
+ * Used when resolving a config file's `consola` key — the value may be a
+ * partial options object, a factory, or a fully built instance.
+ */
+export declare function isConsolaInstance(value: unknown): value is ConsolaInstance;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}

package/dist/types.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Central type definitions for @vsfedorenko/next-logger.
+ *
+ * Re-exports consola's core types so consumers don't need to depend on consola
+ * directly for type-only imports, and defines the shape of the Next.js log
+ * module we patch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isConsolaInstance = isConsolaInstance;
+/**
+ * Type guard: narrows `unknown` to {@link ConsolaInstance} by checking for the
+ * two methods both patches depend on (`.withTag()` + `.log()`).
+ *
+ * Used when resolving a config file's `consola` key — the value may be a
+ * partial options object, a factory, or a fully built instance.
+ */
+function isConsolaInstance(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.withTag === "function" &&
+        typeof value.log === "function");
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAqDH,8CAOC;AAdD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAyB,CAAC,OAAO,KAAK,UAAU;QACxD,OAAQ,KAAyB,CAAC,GAAG,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC"}