hotelme-nuxt-logger 1.2.1 → 1.4.0

package/README.md

@@ -70,6 +70,8 @@ export default defineNuxtConfig({
     enableRequestLogging: true
   },
 
+  // Назва потрапляє в runtimeConfig.public.projectName і використовується для всіх
+  // записів (запити, помилки Nitro, SSR, клієнтські помилки, ручні logger.*).
   // Альтернативно через env
   runtimeConfig: {
     public: {
@@ -115,6 +117,8 @@ logger.warn('Rate limit approaching', { remaining: 10 })
 
 ### В API handlers
 
+`logger` та `getRequestId` auto-import'яться і в серверному коді Nitro (з 1.4.0). Явний імпорт, якщо треба: `import { logger } from 'hotelme-nuxt-logger/runtime/logger'`.
+
 ```typescript
 // server/api/hotels.get.ts
 export default defineEventHandler((event) => {
@@ -169,6 +173,19 @@ export default defineEventHandler((event) => {
 })
 ```
 
+## Рівні для помилок сервера
+
+Nitro `error` hook (модульна опція `enableErrorLogging`):
+
+| Що сталося | msg | level | stack |
+|---|---|---|---|
+| `createError({ statusCode: 4xx })`, відсутній `/_nuxt/*` chunk, валідація | `request_error` | Warn | ні |
+| 5xx або не-HTTP виняток у handler/middleware | `unhandled_error` | Error | так |
+| `unhandledRejection` / `uncaughtException` процесу | `unhandled_rejection` / `uncaught_exception` | Fatal | так |
+
+4xx не є помилкою застосунку, тому не засмічує рівень Error; сам запит при цьому все одно
+логується request-middleware як `stats` / `api request` з кодом відповіді.
+
 ## Формат логів
 
 | Поле | Тип | Опис |

package/dist/module.cjs

@@ -26,6 +26,10 @@ const module$1 = kit.defineNuxtModule({
     const clientErrorEndpoint = options.clientErrorEndpoint || "/_logger/client-error";
     nuxt.options.runtimeConfig.public.loggerClientErrorEndpoint = clientErrorEndpoint;
     kit.addImportsDir(resolver.resolve("./runtime"));
+    kit.addServerImports([
+      { name: "logger", from: resolver.resolve("./runtime/logger") },
+      { name: "getRequestId", from: resolver.resolve("./runtime/logger") }
+    ]);
     if (options.enableRequestLogging) {
       kit.addServerHandler({
         handler: resolver.resolve("./runtime/middleware/logger.server"),

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^3.0.0 || ^4.0.0"
   },
-  "version": "1.2.1",
+  "version": "1.4.0",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, createResolver, addImportsDir, addServerHandler, addServerPlugin, addPlugin } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addImportsDir, addServerImports, addServerHandler, addServerPlugin, addPlugin } from '@nuxt/kit';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 
@@ -32,6 +32,10 @@ const module = defineNuxtModule({
     const clientErrorEndpoint = options.clientErrorEndpoint || "/_logger/client-error";
     nuxt.options.runtimeConfig.public.loggerClientErrorEndpoint = clientErrorEndpoint;
     addImportsDir(resolver.resolve("./runtime"));
+    addServerImports([
+      { name: "logger", from: resolver.resolve("./runtime/logger") },
+      { name: "getRequestId", from: resolver.resolve("./runtime/logger") }
+    ]);
     if (options.enableRequestLogging) {
       addServerHandler({
         handler: resolver.resolve("./runtime/middleware/logger.server"),

package/dist/runtime/httpError.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Чисті хелпери для класифікації помилок у Nitro `error` hook.
+ * Без імпортів із Nuxt/Nitro, щоб їх можна було перевірити звичайним Node.
+ */
+/**
+ * HTTP-статус помилки. h3 `createError()` кладе його в `statusCode`,
+ * деякі бібліотеки — у `status`. Якщо на помилці статусу немає,
+ * повертаємо `fallback` (зазвичай `res.statusCode`).
+ */
+export declare function httpStatusOf(error: unknown, fallback?: number): number | undefined;
+/** 4xx: помилка на боці клієнта (не знайдено, невалідний запит, заборонено). */
+export declare function isClientError(status: number | undefined): boolean;
+/**
+ * Текст помилки для логу: `message`, а якщо порожній — `statusMessage`
+ * (h3 для 404 на статику дає порожній message і "Not Found" у statusMessage).
+ */
+export declare function errorText(error: unknown): string;

package/dist/runtime/httpError.js

@@ -0,0 +1,18 @@
+export function httpStatusOf(error, fallback) {
+  const e = error;
+  for (const candidate of [e?.statusCode, e?.status]) {
+    if (typeof candidate === "number" && candidate >= 100 && candidate <= 599) {
+      return candidate;
+    }
+  }
+  return fallback;
+}
+export function isClientError(status) {
+  return status !== void 0 && status >= 400 && status < 500;
+}
+export function errorText(error) {
+  const e = error;
+  if (e && typeof e.message === "string" && e.message) return e.message;
+  if (e && typeof e.statusMessage === "string" && e.statusMessage) return e.statusMessage;
+  return String(error);
+}

package/dist/runtime/logger.d.ts

@@ -4,11 +4,11 @@
  * Виводить логи в stdout у JSON-форматі, сумісному з бекенд-логами.
  *
  * Обов'язкові поля в кожному лозі:
- * - ts: ISO timestamp з timezone
+ * - ts: timestamp у локальному часі процесу з зсувом зони
  * - level: рівень логування (Trace, Debug, Info, Warn, Error, Fatal)
  * - reqid: унікальний ID запиту (з header X-Request-ID)
  * - msg: текст повідомлення
- * - project: назва проекту (з env або 'hotelme' за замовчуванням)
+ * - project: назва проекту (див. resolveProjectName)
  * - log_type: 'frontend' для розрізнення з бекенд-логами
  * - pid: process ID
  *
@@ -20,7 +20,7 @@
  *   "project": "hotelme",
  *   "log_type": "frontend",
  *   "pid": 53,
- *   "ts": "2025-06-17T09:58:18.539733-0500",
+ *   "ts": "2025-06-17T09:58:18.539000-0500",
  *   "stage": "after",
  *   "domain": "localhost:3000",
  *   "request": "/api/hotels",
@@ -37,6 +37,17 @@ export declare enum LogLevel {
     Error = "Error",
     Fatal = "Fatal"
 }
+/**
+ * Запам'ятати назву проекту для всіх наступних записів. Викликається серверними
+ * частинами модуля при старті (Nitro-плагін) та на першому запиті (middleware,
+ * SSR-плагін). Порожні значення ігноруються.
+ */
+export declare function setProjectName(name: unknown): void;
+/**
+ * Назва проекту для запису: явно передана → з runtimeConfig (setProjectName) →
+ * env `NUXT_PUBLIC_PROJECT_NAME` → 'hotelme'.
+ */
+export declare function resolveProjectName(explicit?: unknown): string;
 /**
  * Генерує унікальний ID запиту
  * Використовується UUID v4 без дефісів для компактності
@@ -51,6 +62,7 @@ export declare function getRequestId(): string;
  *
  * Важливі поля в details:
  * - reqid: ID запиту (береться з X-Request-ID header)
+ * - project: назва проекту (за замовчуванням з runtimeConfig, див. resolveProjectName)
  * - request: URL запиту
  * - request_time: час виконання запиту в секундах
  * - domain: домен

package/dist/runtime/logger.js

@@ -8,8 +8,22 @@ export var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
   LogLevel2["Fatal"] = "Fatal";
   return LogLevel2;
 })(LogLevel || {});
-const PROJECT_NAME = import.meta.server ? process.env.NUXT_PUBLIC_PROJECT_NAME || "hotelme" : "hotelme";
+const DEFAULT_PROJECT_NAME = "hotelme";
 const PID = import.meta.server ? process.pid : void 0;
+let projectName;
+export function setProjectName(name) {
+  if (typeof name === "string" && name) {
+    projectName = name;
+  }
+}
+export function resolveProjectName(explicit) {
+  if (typeof explicit === "string" && explicit) return explicit;
+  if (projectName) return projectName;
+  if (import.meta.server && typeof process !== "undefined" && process.env?.NUXT_PUBLIC_PROJECT_NAME) {
+    return process.env.NUXT_PUBLIC_PROJECT_NAME;
+  }
+  return DEFAULT_PROJECT_NAME;
+}
 export function getRequestId() {
   return uuidv4().replace(/-/g, "");
 }
@@ -27,12 +41,12 @@ function formatTimestamp() {
 }
 export function log(level, msg, details) {
   const reqid = details?.reqid || getRequestId();
-  const { request, request_time, domain, method, response, stage, ...otherDetails } = details || {};
+  const { project, request, request_time, domain, method, response, stage, ...otherDetails } = details || {};
   const logEntry = {
     msg,
     level,
     reqid,
-    project: PROJECT_NAME,
+    project: resolveProjectName(project),
     log_type: "frontend",
     pid: PID,
     ts: formatTimestamp(),

package/dist/runtime/middleware/logger.server.js

@@ -1,6 +1,6 @@
 import { defineEventHandler, getRequestURL } from "h3";
 import { useRuntimeConfig } from "#imports";
-import { logger } from "../logger.js";
+import { logger, setProjectName } from "../logger.js";
 import { v4 as uuidv4 } from "uuid";
 export default defineEventHandler(async (event) => {
   if (event.context.reqid) {
@@ -9,6 +9,7 @@ export default defineEventHandler(async (event) => {
   try {
     const config = useRuntimeConfig();
     const projectName = config.public.projectName || "hotelme";
+    setProjectName(projectName);
     let reqid = event.node.req.headers["x-request-id"];
     if (!reqid) {
       reqid = uuidv4().replace(/-/g, "");

package/dist/runtime/plugins/error.js

@@ -1,8 +1,9 @@
 import { defineNuxtPlugin, useRequestEvent, useRuntimeConfig } from "#imports";
-import { logger } from "../logger.js";
+import { logger, setProjectName } from "../logger.js";
 import { isBrowserExtensionError } from "../browserExtensionFilter.js";
 export default defineNuxtPlugin((nuxtApp) => {
   if (import.meta.server) {
+    setProjectName(useRuntimeConfig().public.projectName);
     const event = useRequestEvent();
     const reqid = event?.context?.reqid;
     const request = event?.path;

package/dist/runtime/server/plugin.d.ts

@@ -7,6 +7,14 @@
  *
  * `reqid` is read from `event.context.reqid` set by `logger.server.ts` middleware,
  * so SSR and backend logs stay correlated by the same id.
+ *
+ * Levels (since 1.3.0):
+ * - 4xx (`createError({ statusCode: 404 })`, missing `/_nuxt/*` asset, validation
+ *   errors): `msg: "request_error"`, level Warn, no stack trace. These are the
+ *   client's problem, and the request middleware already logs the same request
+ *   as `stats`/`api request` with the status code. Stale hashed chunks after a
+ *   deploy used to produce dozens of Error entries with 1 KB Nitro stacks each.
+ * - 5xx and non-HTTP throws: `msg: "unhandled_error"`, level Error, with stack.
  */
 declare const _default: import("nitropack").NitroAppPlugin;
 export default _default;

package/dist/runtime/server/plugin.js

@@ -1,17 +1,28 @@
 import { defineNitroPlugin } from "nitropack/runtime";
-import { logger } from "../logger.js";
+import { useRuntimeConfig } from "#imports";
+import { logger, setProjectName } from "../logger.js";
+import { httpStatusOf, isClientError, errorText } from "../httpError.js";
 export default defineNitroPlugin((nitroApp) => {
+  setProjectName(useRuntimeConfig().public.projectName);
   nitroApp.hooks.hook("error", (error, ctx) => {
     const event = ctx?.event;
     const req = event?.node?.req;
     const res = event?.node?.res;
-    logger.error("unhandled_error", {
+    const status = httpStatusOf(error, res?.statusCode);
+    const base = {
       reqid: event?.context?.reqid,
       domain: req?.headers?.host,
       request: event?.path || req?.url,
       method: req?.method,
-      response: res?.statusCode,
-      error: error instanceof Error ? error.message : String(error),
+      response: status,
+      error: errorText(error)
+    };
+    if (isClientError(status)) {
+      logger.warn("request_error", base);
+      return;
+    }
+    logger.error("unhandled_error", {
+      ...base,
       error_name: error instanceof Error ? error.name : void 0,
       stack: error instanceof Error ? error.stack : void 0
     });

package/dist/runtime/server/routes/client-error.post.js

@@ -1,4 +1,5 @@
 import { defineEventHandler, readBody } from "h3";
+import { useRuntimeConfig } from "#imports";
 import { logger } from "../../logger.js";
 import { isBrowserExtensionError } from "../../browserExtensionFilter.js";
 export default defineEventHandler(async (event) => {
@@ -9,6 +10,7 @@ export default defineEventHandler(async (event) => {
   }
   logger.error(typeof msg === "string" && msg ? msg : "client_error", {
     reqid: event.context.reqid,
+    project: useRuntimeConfig().public.projectName,
     domain: event.node.req.headers.host,
     referer: event.node.req.headers.referer,
     user_agent: event.node.req.headers["user-agent"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotelme-nuxt-logger",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Стандартний logger для Nuxt проектів з JSON виводом сумісним з бекенд-логами",
   "keywords": [
     "nuxt",
@@ -20,6 +20,10 @@
       "types": "./dist/types.d.ts",
       "import": "./dist/module.mjs",
       "require": "./dist/module.cjs"
+    },
+    "./runtime/logger": {
+      "types": "./dist/runtime/logger.d.ts",
+      "import": "./dist/runtime/logger.js"
     }
   },
   "main": "./dist/module.cjs",