evlog 2.4.0 → 2.4.1

package/dist/express/index.mjs

@@ -1,5 +1,5 @@
 import { n as extractSafeNodeHeaders, r as createMiddlewareLogger } from "../headers-CXOd5EyZ.mjs";
-import { t as createLoggerStorage } from "../storage-Dd3PHiMh.mjs";
+import { t as createLoggerStorage } from "../storage-CejtuV76.mjs";
 
 //#region src/express/index.ts
 const { storage, useLogger } = createLoggerStorage("middleware context. Make sure app.use(evlog()) is registered before your routes.");

package/dist/fastify/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/fastify/index.ts"],"mappings":";;;;;cAMiB,SAAA,sBAAS,MAAA,wBAAA,aAAA,CAAA,CAAA;AAAA,KAId,mBAAA,GAAsB,gBAAA;AAAA;EAAA,UAKtB,cAAA;IAER,GAAA;EAAA;AAAA;;;;;;;;;AAPJ;;;;;AAEoB;;;;;;AAyFpB;;cAAa,KAAA,EAAK,qBAAA,CAAA,gBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/fastify/index.ts"],"mappings":";;;;;cAKiB,SAAA,sBAAS,MAAA,wBAAA,aAAA,CAAA,CAAA;AAAA,KAId,mBAAA,GAAsB,gBAAA;AAAA;EAAA,UAKtB,cAAA;IAER,GAAA;EAAA;AAAA;;;;;;;;;;;AAPJ;;;;;AAEoB;;;;;;cAyFP,KAAA,EAAK,qBAAA,CAAA,gBAAA"}

package/dist/fastify/index.mjs

@@ -1,5 +1,5 @@
 import { n as extractSafeNodeHeaders, r as createMiddlewareLogger } from "../headers-CXOd5EyZ.mjs";
-import { t as createLoggerStorage } from "../storage-Dd3PHiMh.mjs";
+import { t as createLoggerStorage } from "../storage-CejtuV76.mjs";
 
 //#region src/fastify/index.ts
 const { storage, useLogger } = createLoggerStorage("plugin context. Make sure app.register(evlog) is called before your routes.");

package/dist/fastify/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/fastify/index.ts"],"sourcesContent":["import type { FastifyPluginCallback } from 'fastify'\nimport type { RequestLogger } from '../types'\nimport { createMiddlewareLogger, type BaseEvlogOptions } from '../shared/middleware'\nimport { extractSafeNodeHeaders } from '../shared/headers'\nimport { createLoggerStorage } from '../shared/storage'\n\nconst { storage, useLogger } = createLoggerStorage(\n  'plugin context. Make sure app.register(evlog) is called before your routes.',\n)\n\nexport type EvlogFastifyOptions = BaseEvlogOptions\n\nexport { useLogger }\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    // Overrides Fastify's built-in pino logger on the request with evlog's RequestLogger.\n    log: any\n  }\n}\n\ninterface RequestState {\n  finish: (opts?: { status?: number; error?: Error }) => Promise<unknown>\n}\n\nconst evlogPlugin: FastifyPluginCallback<EvlogFastifyOptions> = (fastify, options, done) => {\n  const emitted = new WeakSet<object>()\n  const requestState = new WeakMap<object, RequestState>()\n\n  fastify.addHook('onRequest', (request, _reply, done) => {\n    const headers = extractSafeNodeHeaders(request.headers)\n    const path = new URL(request.url, 'http://localhost').pathname\n\n    const { logger, finish, skipped } = createMiddlewareLogger({\n      method: request.method,\n      path,\n      requestId: headers['x-request-id'] || crypto.randomUUID(),\n      headers,\n      ...options,\n    })\n\n    if (skipped) {\n      done()\n      return\n    }\n\n    // Shadow Fastify's built-in pino logger with evlog's request-scoped logger\n    const req = request as any\n    req.log = logger\n    requestState.set(request, { finish })\n\n    storage.run(logger, () => done())\n  })\n\n  fastify.addHook('onResponse', async (request, reply) => {\n    const state = requestState.get(request)\n    if (!state || emitted.has(request)) return\n    emitted.add(request)\n    await state.finish({ status: reply.statusCode })\n  })\n\n  fastify.addHook('onError', async (request, _reply, error) => {\n    const state = requestState.get(request)\n    if (!state || emitted.has(request)) return\n    emitted.add(request)\n    const logger = (request as any).log\n    const err = error instanceof Error ? error : new Error(String(error))\n    if (logger && typeof logger.error === 'function') logger.error(err)\n    await state.finish({ error: err })\n  })\n\n  done()\n}\n\n// Break Fastify plugin encapsulation without a runtime dependency on fastify-plugin.\n// This is the same mechanism fastify-plugin uses internally.\nconst plugin = evlogPlugin as any\nplugin[Symbol.for('skip-override')] = true\nplugin[Symbol.for('fastify.display-name')] = 'evlog'\n\n/**\n * Create an evlog plugin for Fastify.\n *\n * @example\n * ```ts\n * import Fastify from 'fastify'\n * import { initLogger } from 'evlog'\n * import { evlog } from 'evlog/fastify'\n * import { createAxiomDrain } from 'evlog/axiom'\n *\n * initLogger({ env: { service: 'fastify-api' } })\n *\n * const app = Fastify()\n * await app.register(evlog, {\n *   drain: createAxiomDrain(),\n *   enrich: (ctx) => {\n *     ctx.event.region = process.env.FLY_REGION\n *   },\n * })\n * ```\n */\nexport const evlog = evlogPlugin\n"],"mappings":";;;;AAMA,MAAM,EAAE,SAAS,cAAc,oBAC7B,8EACD;AAiBD,MAAM,eAA2D,SAAS,SAAS,SAAS;CAC1F,MAAM,0BAAU,IAAI,SAAiB;CACrC,MAAM,+BAAe,IAAI,SAA+B;AAExD,SAAQ,QAAQ,cAAc,SAAS,QAAQ,SAAS;EACtD,MAAM,UAAU,uBAAuB,QAAQ,QAAQ;EACvD,MAAM,OAAO,IAAI,IAAI,QAAQ,KAAK,mBAAmB,CAAC;EAEtD,MAAM,EAAE,QAAQ,QAAQ,YAAY,uBAAuB;GACzD,QAAQ,QAAQ;GAChB;GACA,WAAW,QAAQ,mBAAmB,OAAO,YAAY;GACzD;GACA,GAAG;GACJ,CAAC;AAEF,MAAI,SAAS;AACX,SAAM;AACN;;EAIF,MAAM,MAAM;AACZ,MAAI,MAAM;AACV,eAAa,IAAI,SAAS,EAAE,QAAQ,CAAC;AAErC,UAAQ,IAAI,cAAc,MAAM,CAAC;GACjC;AAEF,SAAQ,QAAQ,cAAc,OAAO,SAAS,UAAU;EACtD,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,QAAQ,IAAI,QAAQ,CAAE;AACpC,UAAQ,IAAI,QAAQ;AACpB,QAAM,MAAM,OAAO,EAAE,QAAQ,MAAM,YAAY,CAAC;GAChD;AAEF,SAAQ,QAAQ,WAAW,OAAO,SAAS,QAAQ,UAAU;EAC3D,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,QAAQ,IAAI,QAAQ,CAAE;AACpC,UAAQ,IAAI,QAAQ;EACpB,MAAM,SAAU,QAAgB;EAChC,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,MAAI,UAAU,OAAO,OAAO,UAAU,WAAY,QAAO,MAAM,IAAI;AACnE,QAAM,MAAM,OAAO,EAAE,OAAO,KAAK,CAAC;GAClC;AAEF,OAAM;;AAKR,MAAM,SAAS;AACf,OAAO,OAAO,IAAI,gBAAgB,IAAI;AACtC,OAAO,OAAO,IAAI,uBAAuB,IAAI;;;;;;;;;;;;;;;;;;;;;;AAuB7C,MAAa,QAAQ"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/fastify/index.ts"],"sourcesContent":["import type { FastifyPluginCallback } from 'fastify'\nimport { createMiddlewareLogger, type BaseEvlogOptions } from '../shared/middleware'\nimport { extractSafeNodeHeaders } from '../shared/headers'\nimport { createLoggerStorage } from '../shared/storage'\n\nconst { storage, useLogger } = createLoggerStorage(\n  'plugin context. Make sure app.register(evlog) is called before your routes.',\n)\n\nexport type EvlogFastifyOptions = BaseEvlogOptions\n\nexport { useLogger }\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    // Overrides Fastify's built-in pino logger on the request with evlog's RequestLogger.\n    log: any\n  }\n}\n\ninterface RequestState {\n  finish: (opts?: { status?: number; error?: Error }) => Promise<unknown>\n}\n\nconst evlogPlugin: FastifyPluginCallback<EvlogFastifyOptions> = (fastify, options, done) => {\n  const emitted = new WeakSet<object>()\n  const requestState = new WeakMap<object, RequestState>()\n\n  fastify.addHook('onRequest', (request, _reply, done) => {\n    const headers = extractSafeNodeHeaders(request.headers)\n    const path = new URL(request.url, 'http://localhost').pathname\n\n    const { logger, finish, skipped } = createMiddlewareLogger({\n      method: request.method,\n      path,\n      requestId: headers['x-request-id'] || crypto.randomUUID(),\n      headers,\n      ...options,\n    })\n\n    if (skipped) {\n      done()\n      return\n    }\n\n    // Shadow Fastify's built-in pino logger with evlog's request-scoped logger\n    const req = request as any\n    req.log = logger\n    requestState.set(request, { finish })\n\n    storage.run(logger, () => done())\n  })\n\n  fastify.addHook('onResponse', async (request, reply) => {\n    const state = requestState.get(request)\n    if (!state || emitted.has(request)) return\n    emitted.add(request)\n    await state.finish({ status: reply.statusCode })\n  })\n\n  fastify.addHook('onError', async (request, _reply, error) => {\n    const state = requestState.get(request)\n    if (!state || emitted.has(request)) return\n    emitted.add(request)\n    const logger = (request as any).log\n    const err = error instanceof Error ? error : new Error(String(error))\n    if (logger && typeof logger.error === 'function') logger.error(err)\n    await state.finish({ error: err })\n  })\n\n  done()\n}\n\n// Break Fastify plugin encapsulation without a runtime dependency on fastify-plugin.\n// This is the same mechanism fastify-plugin uses internally.\nconst plugin = evlogPlugin as any\nplugin[Symbol.for('skip-override')] = true\nplugin[Symbol.for('fastify.display-name')] = 'evlog'\n\n/**\n * Create an evlog plugin for Fastify.\n *\n * @example\n * ```ts\n * import Fastify from 'fastify'\n * import { initLogger } from 'evlog'\n * import { evlog } from 'evlog/fastify'\n * import { createAxiomDrain } from 'evlog/axiom'\n *\n * initLogger({ env: { service: 'fastify-api' } })\n *\n * const app = Fastify()\n * await app.register(evlog, {\n *   drain: createAxiomDrain(),\n *   enrich: (ctx) => {\n *     ctx.event.region = process.env.FLY_REGION\n *   },\n * })\n * ```\n */\nexport const evlog = evlogPlugin\n"],"mappings":";;;;AAKA,MAAM,EAAE,SAAS,cAAc,oBAC7B,8EACD;AAiBD,MAAM,eAA2D,SAAS,SAAS,SAAS;CAC1F,MAAM,0BAAU,IAAI,SAAiB;CACrC,MAAM,+BAAe,IAAI,SAA+B;AAExD,SAAQ,QAAQ,cAAc,SAAS,QAAQ,SAAS;EACtD,MAAM,UAAU,uBAAuB,QAAQ,QAAQ;EACvD,MAAM,OAAO,IAAI,IAAI,QAAQ,KAAK,mBAAmB,CAAC;EAEtD,MAAM,EAAE,QAAQ,QAAQ,YAAY,uBAAuB;GACzD,QAAQ,QAAQ;GAChB;GACA,WAAW,QAAQ,mBAAmB,OAAO,YAAY;GACzD;GACA,GAAG;GACJ,CAAC;AAEF,MAAI,SAAS;AACX,SAAM;AACN;;EAIF,MAAM,MAAM;AACZ,MAAI,MAAM;AACV,eAAa,IAAI,SAAS,EAAE,QAAQ,CAAC;AAErC,UAAQ,IAAI,cAAc,MAAM,CAAC;GACjC;AAEF,SAAQ,QAAQ,cAAc,OAAO,SAAS,UAAU;EACtD,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,QAAQ,IAAI,QAAQ,CAAE;AACpC,UAAQ,IAAI,QAAQ;AACpB,QAAM,MAAM,OAAO,EAAE,QAAQ,MAAM,YAAY,CAAC;GAChD;AAEF,SAAQ,QAAQ,WAAW,OAAO,SAAS,QAAQ,UAAU;EAC3D,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,QAAQ,IAAI,QAAQ,CAAE;AACpC,UAAQ,IAAI,QAAQ;EACpB,MAAM,SAAU,QAAgB;EAChC,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,MAAI,UAAU,OAAO,OAAO,UAAU,WAAY,QAAO,MAAM,IAAI;AACnE,QAAM,MAAM,OAAO,EAAE,OAAO,KAAK,CAAC;GAClC;AAEF,OAAM;;AAKR,MAAM,SAAS;AACf,OAAO,OAAO,IAAI,gBAAgB,IAAI;AACtC,OAAO,OAAO,IAAI,uBAAuB,IAAI;;;;;;;;;;;;;;;;;;;;;;AAuB7C,MAAa,QAAQ"}

package/dist/nestjs/index.mjs

@@ -1,5 +1,5 @@
 import { n as extractSafeNodeHeaders, r as createMiddlewareLogger } from "../headers-CXOd5EyZ.mjs";
-import { t as createLoggerStorage } from "../storage-Dd3PHiMh.mjs";
+import { t as createLoggerStorage } from "../storage-CejtuV76.mjs";
 
 //#region src/nestjs/index.ts
 const { storage, useLogger } = createLoggerStorage("middleware context. Make sure EvlogModule.forRoot() is imported in your AppModule.");

package/dist/nuxt/module.mjs

@@ -2,7 +2,7 @@ import { addImports, addPlugin, addServerHandler, addServerImports, addServerPlu
 
 //#region package.json
 var name = "evlog";
-var version = "2.4.0";
+var version = "2.4.1";
 
 //#endregion
 //#region src/nuxt/module.ts

package/dist/{storage-Dd3PHiMh.mjs → storage-CejtuV76.mjs}

@@ -13,6 +13,22 @@ import { AsyncLocalStorage } from "node:async_hooks";
 */
 function createLoggerStorage(contextHint) {
 	const storage = new AsyncLocalStorage();
+	/**
+	* Access the request-scoped logger created by the evlog middleware.
+	*
+	* Must be called inside a request that is handled by the evlog middleware.
+	* Throws if called outside of a request context.
+	*
+	* @example
+	* ```ts
+	* import { useLogger } from 'evlog/express' // or /fastify, /nestjs, /sveltekit, /elysia
+	*
+	* function myService() {
+	*   const log = useLogger()
+	*   log.set({ users: { count: 42 } })
+	* }
+	* ```
+	*/
 	function useLogger() {
 		const logger = storage.getStore();
 		if (!logger) throw new Error(`[evlog] useLogger() was called outside of an evlog ${contextHint}`);
@@ -26,4 +42,4 @@ function createLoggerStorage(contextHint) {
 
 //#endregion
 export { createLoggerStorage as t };
-//# sourceMappingURL=storage-Dd3PHiMh.mjs.map
+//# sourceMappingURL=storage-CejtuV76.mjs.map

package/dist/storage-CejtuV76.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-CejtuV76.mjs","names":[],"sources":["../src/shared/storage.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { RequestLogger } from '../types'\n\n/**\n * Create a request-scoped `AsyncLocalStorage` and a matching `useLogger` accessor.\n *\n * Every framework that needs `useLogger()` (Express, Fastify, NestJS, SvelteKit)\n * calls this once at module level to get its own isolated storage + accessor pair.\n *\n * @param contextHint - Human-readable hint appended to the error message when\n *   `useLogger()` is called outside of a request (e.g.\n *   `\"middleware context. Make sure app.use(evlog()) is registered before your routes.\"`).\n */\nexport function createLoggerStorage(contextHint: string) {\n  const storage = new AsyncLocalStorage<RequestLogger>()\n\n  /**\n   * Access the request-scoped logger created by the evlog middleware.\n   *\n   * Must be called inside a request that is handled by the evlog middleware.\n   * Throws if called outside of a request context.\n   *\n   * @example\n   * ```ts\n   * import { useLogger } from 'evlog/express' // or /fastify, /nestjs, /sveltekit, /elysia\n   *\n   * function myService() {\n   *   const log = useLogger()\n   *   log.set({ users: { count: 42 } })\n   * }\n   * ```\n   */\n  function useLogger<T extends object = Record<string, unknown>>(): RequestLogger<T> {\n    const logger = storage.getStore()\n    if (!logger) {\n      throw new Error(\n        `[evlog] useLogger() was called outside of an evlog ${contextHint}`,\n      )\n    }\n    return logger as RequestLogger<T>\n  }\n\n  return { storage, useLogger }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,oBAAoB,aAAqB;CACvD,MAAM,UAAU,IAAI,mBAAkC;;;;;;;;;;;;;;;;;CAkBtD,SAAS,YAA0E;EACjF,MAAM,SAAS,QAAQ,UAAU;AACjC,MAAI,CAAC,OACH,OAAM,IAAI,MACR,sDAAsD,cACvD;AAEH,SAAO;;AAGT,QAAO;EAAE;EAAS;EAAW"}

package/dist/sveltekit/index.mjs

@@ -1,7 +1,7 @@
 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-Dd3PHiMh.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.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evlog",
-  "version": "2.4.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",

package/dist/storage-Dd3PHiMh.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-Dd3PHiMh.mjs","names":[],"sources":["../src/shared/storage.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { RequestLogger } from '../types'\n\n/**\n * Create a request-scoped `AsyncLocalStorage` and a matching `useLogger` accessor.\n *\n * Every framework that needs `useLogger()` (Express, Fastify, NestJS, SvelteKit)\n * calls this once at module level to get its own isolated storage + accessor pair.\n *\n * @param contextHint - Human-readable hint appended to the error message when\n *   `useLogger()` is called outside of a request (e.g.\n *   `\"middleware context. Make sure app.use(evlog()) is registered before your routes.\"`).\n */\nexport function createLoggerStorage(contextHint: string) {\n  const storage = new AsyncLocalStorage<RequestLogger>()\n\n  function useLogger<T extends object = Record<string, unknown>>(): RequestLogger<T> {\n    const logger = storage.getStore()\n    if (!logger) {\n      throw new Error(\n        `[evlog] useLogger() was called outside of an evlog ${contextHint}`,\n      )\n    }\n    return logger as RequestLogger<T>\n  }\n\n  return { storage, useLogger }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,oBAAoB,aAAqB;CACvD,MAAM,UAAU,IAAI,mBAAkC;CAEtD,SAAS,YAA0E;EACjF,MAAM,SAAS,QAAQ,UAAU;AACjC,MAAI,CAAC,OACH,OAAM,IAAI,MACR,sDAAsD,cACvD;AAEH,SAAO;;AAGT,QAAO;EAAE;EAAS;EAAW"}