evlog 2.3.0 → 2.4.1

package/dist/sveltekit/index.mjs

@@ -0,0 +1,163 @@
+import { EvlogError } from "../error.mjs";
+import { n as resolveEvlogError, r as serializeEvlogErrorResponse, t as extractErrorStatus } from "../nitro-Da8tEfJ3.mjs";
+import { r as createMiddlewareLogger, t as extractSafeHeaders } from "../headers-CXOd5EyZ.mjs";
+import { t as createLoggerStorage } from "../storage-CejtuV76.mjs";
+
+//#region src/sveltekit/index.ts
+const { storage, useLogger } = createLoggerStorage("handle context. Make sure evlog() handle is added to your hooks.server.ts.");
+/**
+* Create an evlog handle hook for SvelteKit.
+*
+* Add it to your `src/hooks.server.ts` using SvelteKit's `sequence` helper
+* or as the sole handle export.
+*
+* @example
+* ```ts
+* // src/hooks.server.ts
+* import { initLogger } from 'evlog'
+* import { evlog } from 'evlog/sveltekit'
+* import { createAxiomDrain } from 'evlog/axiom'
+*
+* initLogger({ env: { service: 'my-sveltekit-app' } })
+*
+* export const handle = evlog({
+*   drain: createAxiomDrain(),
+*   enrich: (ctx) => {
+*     ctx.event.region = process.env.FLY_REGION
+*   },
+* })
+* ```
+*
+* @example
+* ```ts
+* // Compose with other hooks using sequence
+* import { sequence } from '@sveltejs/kit/hooks'
+* import { evlog } from 'evlog/sveltekit'
+*
+* export const handle = sequence(evlog(), yourOtherHook)
+* ```
+*/
+function evlog(options = {}) {
+	return async ({ event, resolve }) => {
+		const { logger, finish, skipped } = createMiddlewareLogger({
+			method: event.request.method,
+			path: event.url.pathname,
+			requestId: event.request.headers.get("x-request-id") || crypto.randomUUID(),
+			headers: extractSafeHeaders(event.request.headers),
+			...options
+		});
+		if (skipped) return await resolve(event);
+		event.locals.log = logger;
+		return storage.run(logger, async () => {
+			try {
+				const response = await resolve(event);
+				const errorData = logger.getContext().error;
+				if (response.status >= 500 && errorData?.name === "EvlogError" && errorData.status) {
+					const { status } = errorData;
+					await finish({ status });
+					const body = serializeEvlogErrorResponse(errorData, event.url.pathname);
+					return new Response(JSON.stringify(body), {
+						status,
+						headers: { "content-type": "application/json" }
+					});
+				}
+				await finish({ status: response.status });
+				return response;
+			} catch (error) {
+				await finish({ error });
+				if (error instanceof EvlogError) {
+					const status = error.status ?? 500;
+					const body = serializeEvlogErrorResponse(error, event.url.pathname);
+					return new Response(JSON.stringify(body), {
+						status,
+						headers: { "content-type": "application/json" }
+					});
+				}
+				throw error;
+			}
+		});
+	};
+}
+/**
+* Create an evlog error handler for SvelteKit.
+*
+* Logs unhandled errors via `event.locals.log` (if available) and returns
+* structured error responses for `EvlogError` instances. For non-evlog errors,
+* returns a generic error response with sanitized messages in production.
+*
+* @example
+* ```ts
+* // src/hooks.server.ts
+* import { evlog, evlogHandleError } from 'evlog/sveltekit'
+*
+* export const handle = evlog()
+* export const handleError = evlogHandleError()
+* ```
+*/
+function evlogHandleError() {
+	return ({ error, event, status, message }) => {
+		const logger = event.locals.log;
+		if (logger && error instanceof Error) logger.error(error);
+		const evlogError = error instanceof Error ? resolveEvlogError(error) : null;
+		if (evlogError) {
+			const errorStatus = extractErrorStatus(evlogError);
+			const response = serializeEvlogErrorResponse(evlogError, event.url.pathname);
+			return {
+				message: response.message,
+				status: errorStatus,
+				why: response.data?.why,
+				fix: response.data?.fix,
+				link: response.data?.link
+			};
+		}
+		return {
+			message,
+			status
+		};
+	};
+}
+/**
+* Create both `handle` and `handleError` hooks in a single call.
+*
+* This is the recommended setup for SvelteKit — it returns both hooks
+* pre-configured and ready to export from `hooks.server.ts`.
+*
+* @example
+* ```ts
+* // src/hooks.server.ts
+* import { initLogger } from 'evlog'
+* import { createEvlogHooks } from 'evlog/sveltekit'
+* import { createAxiomDrain } from 'evlog/axiom'
+*
+* initLogger({ env: { service: 'my-app' } })
+*
+* export const { handle, handleError } = createEvlogHooks({
+*   drain: createAxiomDrain(),
+*   enrich: (ctx) => {
+*     ctx.event.region = process.env.FLY_REGION
+*   },
+* })
+* ```
+*
+* @example
+* ```ts
+* // Compose with other hooks using sequence
+* import { sequence } from '@sveltejs/kit/hooks'
+* import { createEvlogHooks } from 'evlog/sveltekit'
+*
+* const evlogHooks = createEvlogHooks()
+*
+* export const handle = sequence(evlogHooks.handle, yourOtherHook)
+* export const handleError = evlogHooks.handleError
+* ```
+*/
+function createEvlogHooks(options = {}) {
+	return {
+		handle: evlog(options),
+		handleError: evlogHandleError()
+	};
+}
+
+//#endregion
+export { createEvlogHooks, evlog, evlogHandleError, useLogger };
+//# sourceMappingURL=index.mjs.map

package/dist/sveltekit/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/sveltekit/index.ts"],"sourcesContent":["import type { RequestLogger } from '../types'\nimport { createMiddlewareLogger, type BaseEvlogOptions } from '../shared/middleware'\nimport { extractSafeHeaders } from '../shared/headers'\nimport { createLoggerStorage } from '../shared/storage'\nimport { resolveEvlogError, extractErrorStatus, serializeEvlogErrorResponse } from '../nitro'\nimport { EvlogError } from '../error'\n\nconst { storage, useLogger } = createLoggerStorage(\n  'handle context. Make sure evlog() handle is added to your hooks.server.ts.',\n)\n\nexport type EvlogSvelteKitOptions = BaseEvlogOptions\n\nexport { useLogger }\n\n/**\n * SvelteKit `Handle` function signature — avoids a hard dependency on `@sveltejs/kit`.\n */\ntype SvelteKitHandle = (input: {\n  event: { request: Request; url: URL; locals: Record<string, any> }\n  resolve: (event: any) => Promise<Response>\n}) => Promise<Response>\n\n/**\n * SvelteKit `HandleServerError` signature — avoids a hard dependency on `@sveltejs/kit`.\n */\ntype SvelteKitHandleServerError = (input: {\n  error: unknown\n  event: { request: Request; url: URL; locals: Record<string, any> }\n  status: number\n  message: string\n}) => MaybePromise<void | AppError>\n\ntype MaybePromise<T> = T | Promise<T>\n\n/** Minimal SvelteKit `App.Error` shape */\ninterface AppError {\n  message: string\n  [key: string]: unknown\n}\n\n/**\n * Create an evlog handle hook for SvelteKit.\n *\n * Add it to your `src/hooks.server.ts` using SvelteKit's `sequence` helper\n * or as the sole handle export.\n *\n * @example\n * ```ts\n * // src/hooks.server.ts\n * import { initLogger } from 'evlog'\n * import { evlog } from 'evlog/sveltekit'\n * import { createAxiomDrain } from 'evlog/axiom'\n *\n * initLogger({ env: { service: 'my-sveltekit-app' } })\n *\n * export const handle = evlog({\n *   drain: createAxiomDrain(),\n *   enrich: (ctx) => {\n *     ctx.event.region = process.env.FLY_REGION\n *   },\n * })\n * ```\n *\n * @example\n * ```ts\n * // Compose with other hooks using sequence\n * import { sequence } from '@sveltejs/kit/hooks'\n * import { evlog } from 'evlog/sveltekit'\n *\n * export const handle = sequence(evlog(), yourOtherHook)\n * ```\n */\nexport function evlog(options: EvlogSvelteKitOptions = {}): SvelteKitHandle {\n  return async ({ event, resolve }) => {\n    const { logger, finish, skipped } = createMiddlewareLogger({\n      method: event.request.method,\n      path: event.url.pathname,\n      requestId: event.request.headers.get('x-request-id') || crypto.randomUUID(),\n      headers: extractSafeHeaders(event.request.headers),\n      ...options,\n    })\n\n    if (skipped) {\n      return await resolve(event)\n    }\n\n    event.locals.log = logger\n\n    return storage.run(logger, async () => {\n      try {\n        const response = await resolve(event)\n\n        // SvelteKit catches route errors internally and returns 500.\n        // If handleError already logged an EvlogError with a specific status,\n        // return a structured JSON response instead of SvelteKit's generic 500.\n        const ctx = logger.getContext()\n        const errorData = ctx.error as { name?: string; status?: number; message?: string; data?: unknown } | undefined\n        if (response.status >= 500 && errorData?.name === 'EvlogError' && errorData.status) {\n          const { status } = errorData\n          await finish({ status })\n          const body = serializeEvlogErrorResponse(errorData as EvlogError, event.url.pathname)\n          return new Response(JSON.stringify(body), {\n            status,\n            headers: { 'content-type': 'application/json' },\n          })\n        }\n\n        await finish({ status: response.status })\n        return response\n      } catch (error) {\n        await finish({ error: error as Error })\n\n        // Return structured JSON for EvlogError (like NextJS withEvlog / Nuxt errorHandler)\n        if (error instanceof EvlogError) {\n          const status = error.status ?? 500\n          const body = serializeEvlogErrorResponse(error, event.url.pathname)\n          return new Response(JSON.stringify(body), {\n            status,\n            headers: { 'content-type': 'application/json' },\n          })\n        }\n\n        throw error\n      }\n    })\n  }\n}\n\n/**\n * Create an evlog error handler for SvelteKit.\n *\n * Logs unhandled errors via `event.locals.log` (if available) and returns\n * structured error responses for `EvlogError` instances. For non-evlog errors,\n * returns a generic error response with sanitized messages in production.\n *\n * @example\n * ```ts\n * // src/hooks.server.ts\n * import { evlog, evlogHandleError } from 'evlog/sveltekit'\n *\n * export const handle = evlog()\n * export const handleError = evlogHandleError()\n * ```\n */\nexport function evlogHandleError(): SvelteKitHandleServerError {\n  return ({ error, event, status, message }) => {\n    const logger = event.locals.log as RequestLogger | undefined\n\n    if (logger && error instanceof Error) {\n      logger.error(error)\n    }\n\n    const evlogError = error instanceof Error ? resolveEvlogError(error) : null\n\n    if (evlogError) {\n      const errorStatus = extractErrorStatus(evlogError)\n      const response = serializeEvlogErrorResponse(evlogError, event.url.pathname)\n      return {\n        message: response.message as string,\n        status: errorStatus,\n        why: (response.data as { why?: string })?.why,\n        fix: (response.data as { fix?: string })?.fix,\n        link: (response.data as { link?: string })?.link,\n      } as AppError\n    }\n\n    return { message, status } as AppError\n  }\n}\n\n/**\n * Create both `handle` and `handleError` hooks in a single call.\n *\n * This is the recommended setup for SvelteKit — it returns both hooks\n * pre-configured and ready to export from `hooks.server.ts`.\n *\n * @example\n * ```ts\n * // src/hooks.server.ts\n * import { initLogger } from 'evlog'\n * import { createEvlogHooks } from 'evlog/sveltekit'\n * import { createAxiomDrain } from 'evlog/axiom'\n *\n * initLogger({ env: { service: 'my-app' } })\n *\n * export const { handle, handleError } = createEvlogHooks({\n *   drain: createAxiomDrain(),\n *   enrich: (ctx) => {\n *     ctx.event.region = process.env.FLY_REGION\n *   },\n * })\n * ```\n *\n * @example\n * ```ts\n * // Compose with other hooks using sequence\n * import { sequence } from '@sveltejs/kit/hooks'\n * import { createEvlogHooks } from 'evlog/sveltekit'\n *\n * const evlogHooks = createEvlogHooks()\n *\n * export const handle = sequence(evlogHooks.handle, yourOtherHook)\n * export const handleError = evlogHooks.handleError\n * ```\n */\nexport function createEvlogHooks(options: EvlogSvelteKitOptions = {}) {\n  return {\n    handle: evlog(options),\n    handleError: evlogHandleError(),\n  }\n}\n"],"mappings":";;;;;;AAOA,MAAM,EAAE,SAAS,cAAc,oBAC7B,6EACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgED,SAAgB,MAAM,UAAiC,EAAE,EAAmB;AAC1E,QAAO,OAAO,EAAE,OAAO,cAAc;EACnC,MAAM,EAAE,QAAQ,QAAQ,YAAY,uBAAuB;GACzD,QAAQ,MAAM,QAAQ;GACtB,MAAM,MAAM,IAAI;GAChB,WAAW,MAAM,QAAQ,QAAQ,IAAI,eAAe,IAAI,OAAO,YAAY;GAC3E,SAAS,mBAAmB,MAAM,QAAQ,QAAQ;GAClD,GAAG;GACJ,CAAC;AAEF,MAAI,QACF,QAAO,MAAM,QAAQ,MAAM;AAG7B,QAAM,OAAO,MAAM;AAEnB,SAAO,QAAQ,IAAI,QAAQ,YAAY;AACrC,OAAI;IACF,MAAM,WAAW,MAAM,QAAQ,MAAM;IAMrC,MAAM,YADM,OAAO,YAAY,CACT;AACtB,QAAI,SAAS,UAAU,OAAO,WAAW,SAAS,gBAAgB,UAAU,QAAQ;KAClF,MAAM,EAAE,WAAW;AACnB,WAAM,OAAO,EAAE,QAAQ,CAAC;KACxB,MAAM,OAAO,4BAA4B,WAAyB,MAAM,IAAI,SAAS;AACrF,YAAO,IAAI,SAAS,KAAK,UAAU,KAAK,EAAE;MACxC;MACA,SAAS,EAAE,gBAAgB,oBAAoB;MAChD,CAAC;;AAGJ,UAAM,OAAO,EAAE,QAAQ,SAAS,QAAQ,CAAC;AACzC,WAAO;YACA,OAAO;AACd,UAAM,OAAO,EAAS,OAAgB,CAAC;AAGvC,QAAI,iBAAiB,YAAY;KAC/B,MAAM,SAAS,MAAM,UAAU;KAC/B,MAAM,OAAO,4BAA4B,OAAO,MAAM,IAAI,SAAS;AACnE,YAAO,IAAI,SAAS,KAAK,UAAU,KAAK,EAAE;MACxC;MACA,SAAS,EAAE,gBAAgB,oBAAoB;MAChD,CAAC;;AAGJ,UAAM;;IAER;;;;;;;;;;;;;;;;;;;AAoBN,SAAgB,mBAA+C;AAC7D,SAAQ,EAAE,OAAO,OAAO,QAAQ,cAAc;EAC5C,MAAM,SAAS,MAAM,OAAO;AAE5B,MAAI,UAAU,iBAAiB,MAC7B,QAAO,MAAM,MAAM;EAGrB,MAAM,aAAa,iBAAiB,QAAQ,kBAAkB,MAAM,GAAG;AAEvE,MAAI,YAAY;GACd,MAAM,cAAc,mBAAmB,WAAW;GAClD,MAAM,WAAW,4BAA4B,YAAY,MAAM,IAAI,SAAS;AAC5E,UAAO;IACL,SAAS,SAAS;IAClB,QAAQ;IACR,KAAM,SAAS,MAA2B;IAC1C,KAAM,SAAS,MAA2B;IAC1C,MAAO,SAAS,MAA4B;IAC7C;;AAGH,SAAO;GAAE;GAAS;GAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuC9B,SAAgB,iBAAiB,UAAiC,EAAE,EAAE;AACpE,QAAO;EACL,QAAQ,MAAM,QAAQ;EACtB,aAAa,kBAAkB;EAChC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evlog",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Wide event logging library with structured error handling. Inspired by LoggingSucks.",
   "author": "HugoRCD <contact@hrcd.fr>",
   "homepage": "https://evlog.dev",
@@ -23,6 +23,8 @@
     "express",
     "hono",
     "elysia",
+    "nestjs",
+    "sveltekit",
     "typescript"
   ],
   "license": "MIT",
@@ -100,6 +102,18 @@
     "./elysia": {
       "types": "./dist/elysia/index.d.mts",
       "import": "./dist/elysia/index.mjs"
+    },
+    "./fastify": {
+      "types": "./dist/fastify/index.d.mts",
+      "import": "./dist/fastify/index.mjs"
+    },
+    "./nestjs": {
+      "types": "./dist/nestjs/index.d.mts",
+      "import": "./dist/nestjs/index.mjs"
+    },
+    "./sveltekit": {
+      "types": "./dist/sveltekit/index.d.mts",
+      "import": "./dist/sveltekit/index.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -159,6 +173,15 @@
       ],
       "elysia": [
         "./dist/elysia/index.d.mts"
+      ],
+      "fastify": [
+        "./dist/fastify/index.d.mts"
+      ],
+      "nestjs": [
+        "./dist/nestjs/index.d.mts"
+      ],
+      "sveltekit": [
+        "./dist/sveltekit/index.d.mts"
       ]
     }
   },
@@ -187,6 +210,8 @@
     "consola": "^3.4.2",
     "elysia": "^1.4.27",
     "express": "^5.2.1",
+    "@nestjs/common": "^10.0.0",
+    "fastify": "^5.2.1",
     "h3": "^1.15.5",
     "happy-dom": "^20.7.2",
     "nitro": "^3.0.1-alpha.2",
@@ -207,7 +232,10 @@
     "react": ">=19.2.4",
     "hono": "",
     "express": ">=4.21.0",
-    "elysia": ">=1.0.0"
+    "elysia": ">=1.0.0",
+    "fastify": ">=4.0.0",
+    "@nestjs/common": ">=9.0.0",
+    "@sveltejs/kit": ">=2.0.0"
   },
   "peerDependenciesMeta": {
     "@nuxt/kit": {
@@ -239,6 +267,15 @@
     },
     "elysia": {
       "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@sveltejs/kit": {
+      "optional": true
     }
   }
 }