evlog 1.6.0 → 1.8.0

package/dist/runtime/server/useLogger.d.mts

@@ -1,5 +1,6 @@
-import { ServerEvent, RequestLogger } from '../../types.mjs';
+import { RequestLogger, ServerEvent } from "../../types.mjs";
 
+//#region src/runtime/server/useLogger.d.ts
 /**
  * Returns the request logger attached to the given server event.
  *
@@ -22,7 +23,17 @@ import { ServerEvent, RequestLogger } from '../../types.mjs';
  *   log.set({ foo: 'bar' })
  *   // ...
  * })
+ *
+ * @example
+ * // Typed fields — must use explicit import for type checking to work
+ * import { useLogger } from 'evlog'
+ *
+ * interface MyFields { user: { id: string; plan: string } }
+ * const log = useLogger<MyFields>(event)
+ * log.set({ user: { id: '123', plan: 'pro' } }) // OK
+ * log.set({ foo: 'bar' })                        // TS error
  */
-declare function useLogger(event: ServerEvent, service?: string): RequestLogger;
-
+declare function useLogger<T extends object = Record<string, unknown>>(event: ServerEvent, service?: string): RequestLogger<T>;
+//#endregion
 export { useLogger };
+//# sourceMappingURL=useLogger.d.mts.map

package/dist/runtime/server/useLogger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.d.mts","names":[],"sources":["../../../src/runtime/server/useLogger.ts"],"mappings":";;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,SAAA,oBAA6B,MAAA,kBAAA,CAAyB,KAAA,EAAO,WAAA,EAAa,OAAA,YAAmB,aAAA,CAAc,CAAA"}

package/dist/runtime/server/useLogger.mjs

@@ -1,14 +1,43 @@
+//#region src/runtime/server/useLogger.ts
+/**
+* Returns the request logger attached to the given server event.
+*
+* @param event - The current server event containing the context with the logger.
+* @param service - Optional service name to override the default service.
+* @returns The request-scoped logger.
+* @throws Error if the logger is not initialized on the event context.
+*
+* @example
+* export default defineEventHandler((event) => {
+*   const log = useLogger(event)
+*   log.set({ foo: 'bar' })
+*   // ...
+* })
+*
+* @example
+* // Override service name for specific routes
+* export default defineEventHandler((event) => {
+*   const log = useLogger(event, 'payment-service')
+*   log.set({ foo: 'bar' })
+*   // ...
+* })
+*
+* @example
+* // Typed fields — must use explicit import for type checking to work
+* import { useLogger } from 'evlog'
+*
+* interface MyFields { user: { id: string; plan: string } }
+* const log = useLogger<MyFields>(event)
+* log.set({ user: { id: '123', plan: 'pro' } }) // OK
+* log.set({ foo: 'bar' })                        // TS error
+*/
 function useLogger(event, service) {
-  const log = event.context.log;
-  if (!log) {
-    throw new Error(
-      '[evlog] Logger not initialized. Make sure the evlog Nitro plugin is registered. If using Nuxt, add "evlog" to your modules.'
-    );
-  }
-  if (service) {
-    log.set({ service });
-  }
-  return log;
+	const log = event.context.log;
+	if (!log) throw new Error("[evlog] Logger not initialized. Make sure the evlog Nitro plugin is registered. If using Nuxt, add \"evlog\" to your modules.");
+	if (service) log.set({ service });
+	return log;
 }
 
+//#endregion
 export { useLogger };
+//# sourceMappingURL=useLogger.mjs.map

package/dist/runtime/server/useLogger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.mjs","names":[],"sources":["../../../src/runtime/server/useLogger.ts"],"sourcesContent":["import type { RequestLogger, ServerEvent } from '../../types'\n\n/**\n * Returns the request logger attached to the given server event.\n *\n * @param event - The current server event containing the context with the logger.\n * @param service - Optional service name to override the default service.\n * @returns The request-scoped logger.\n * @throws Error if the logger is not initialized on the event context.\n *\n * @example\n * export default defineEventHandler((event) => {\n *   const log = useLogger(event)\n *   log.set({ foo: 'bar' })\n *   // ...\n * })\n *\n * @example\n * // Override service name for specific routes\n * export default defineEventHandler((event) => {\n *   const log = useLogger(event, 'payment-service')\n *   log.set({ foo: 'bar' })\n *   // ...\n * })\n *\n * @example\n * // Typed fields — must use explicit import for type checking to work\n * import { useLogger } from 'evlog'\n *\n * interface MyFields { user: { id: string; plan: string } }\n * const log = useLogger<MyFields>(event)\n * log.set({ user: { id: '123', plan: 'pro' } }) // OK\n * log.set({ foo: 'bar' })                        // TS error\n */\nexport function useLogger<T extends object = Record<string, unknown>>(event: ServerEvent, service?: string): RequestLogger<T> {\n  const log = event.context.log as RequestLogger<T> | undefined\n\n  if (!log) {\n    throw new Error(\n      '[evlog] Logger not initialized. Make sure the evlog Nitro plugin is registered. '\n      + 'If using Nuxt, add \"evlog\" to your modules.',\n    )\n  }\n\n  if (service) {\n    const untyped = log as unknown as RequestLogger\n    untyped.set({ service })\n  }\n\n  return log\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,UAAsD,OAAoB,SAAoC;CAC5H,MAAM,MAAM,MAAM,QAAQ;AAE1B,KAAI,CAAC,IACH,OAAM,IAAI,MACR,gIAED;AAGH,KAAI,QAEF,CADgB,IACR,IAAI,EAAE,SAAS,CAAC;AAG1B,QAAO"}

package/dist/runtime/utils/parseError.d.mts

@@ -1,5 +1,7 @@
-import { ParsedError } from '../../types.mjs';
+import { ParsedError } from "../../types.mjs";
 
+//#region src/runtime/utils/parseError.d.ts
 declare function parseError(error: unknown): ParsedError;
-
-export { ParsedError, parseError };
+//#endregion
+export { type ParsedError, parseError };
+//# sourceMappingURL=parseError.d.mts.map

package/dist/runtime/utils/parseError.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseError.d.mts","names":[],"sources":["../../../src/runtime/utils/parseError.ts"],"mappings":";;;iBAKgB,UAAA,CAAW,KAAA,YAAiB,WAAA"}

package/dist/runtime/utils/parseError.mjs

@@ -1,30 +1,29 @@
+//#region src/runtime/utils/parseError.ts
 function parseError(error) {
-  if (error && typeof error === "object" && "data" in error) {
-    const { data, message: fetchMessage, statusCode: fetchStatusCode, status: fetchStatus } = error;
-    const evlogData = data?.data ?? data;
-    return {
-      // Prefer statusText, then statusMessage (or message) for the error message
-      message: data?.statusText || data?.statusMessage || data?.message || fetchMessage || "An error occurred",
-      // Prefer status, then statusCode for the status value
-      status: data?.status || data?.statusCode || fetchStatus || fetchStatusCode || 500,
-      why: evlogData?.why,
-      fix: evlogData?.fix,
-      link: evlogData?.link,
-      raw: error
-    };
-  }
-  if (error instanceof Error) {
-    return {
-      message: error.message,
-      status: 500,
-      raw: error
-    };
-  }
-  return {
-    message: String(error),
-    status: 500,
-    raw: error
-  };
+	if (error && typeof error === "object" && "data" in error) {
+		const { data, message: fetchMessage, statusCode: fetchStatusCode, status: fetchStatus } = error;
+		const evlogData = data?.data ?? data;
+		return {
+			message: data?.statusText || data?.statusMessage || data?.message || fetchMessage || "An error occurred",
+			status: data?.status || data?.statusCode || fetchStatus || fetchStatusCode || 500,
+			why: evlogData?.why,
+			fix: evlogData?.fix,
+			link: evlogData?.link,
+			raw: error
+		};
+	}
+	if (error instanceof Error) return {
+		message: error.message,
+		status: 500,
+		raw: error
+	};
+	return {
+		message: String(error),
+		status: 500,
+		raw: error
+	};
 }
 
+//#endregion
 export { parseError };
+//# sourceMappingURL=parseError.mjs.map

package/dist/runtime/utils/parseError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseError.mjs","names":[],"sources":["../../../src/runtime/utils/parseError.ts"],"sourcesContent":["import type { FetchError } from 'ofetch'\nimport type { ParsedError } from '../../types'\n\nexport type { ParsedError }\n\nexport function parseError(error: unknown): ParsedError {\n  if (error && typeof error === 'object' && 'data' in error) {\n    const { data, message: fetchMessage, statusCode: fetchStatusCode, status: fetchStatus } = error as FetchError & { status?: number }\n\n    // Support both nested data.data (fetch response) and direct data (EvlogError)\n    const evlogData = (data?.data ?? data) as { why?: string, fix?: string, link?: string } | undefined\n\n    return {\n      // Prefer statusText, then statusMessage (or message) for the error message\n      message: data?.statusText || data?.statusMessage || data?.message || fetchMessage || 'An error occurred',\n      // Prefer status, then statusCode for the status value\n      status: data?.status || data?.statusCode || fetchStatus || fetchStatusCode || 500,\n      why: evlogData?.why,\n      fix: evlogData?.fix,\n      link: evlogData?.link,\n      raw: error,\n    }\n  }\n\n  if (error instanceof Error) {\n    return {\n      message: error.message,\n      status: 500,\n      raw: error,\n    }\n  }\n\n  return {\n    message: String(error),\n    status: 500,\n    raw: error,\n  }\n}\n"],"mappings":";AAKA,SAAgB,WAAW,OAA6B;AACtD,KAAI,SAAS,OAAO,UAAU,YAAY,UAAU,OAAO;EACzD,MAAM,EAAE,MAAM,SAAS,cAAc,YAAY,iBAAiB,QAAQ,gBAAgB;EAG1F,MAAM,YAAa,MAAM,QAAQ;AAEjC,SAAO;GAEL,SAAS,MAAM,cAAc,MAAM,iBAAiB,MAAM,WAAW,gBAAgB;GAErF,QAAQ,MAAM,UAAU,MAAM,cAAc,eAAe,mBAAmB;GAC9E,KAAK,WAAW;GAChB,KAAK,WAAW;GAChB,MAAM,WAAW;GACjB,KAAK;GACN;;AAGH,KAAI,iBAAiB,MACnB,QAAO;EACL,SAAS,MAAM;EACf,QAAQ;EACR,KAAK;EACN;AAGH,QAAO;EACL,SAAS,OAAO,MAAM;EACtB,QAAQ;EACR,KAAK;EACN"}