evlog 1.2.0 → 1.4.0

package/dist/workers.d.mts

@@ -0,0 +1,45 @@
+import { RequestLogger, LoggerConfig } from './types.mjs';
+
+/**
+ * Options for createWorkersLogger
+ */
+interface WorkersLoggerOptions {
+    /** Override the request ID (default: cf-ray header) */
+    requestId?: string;
+    /** Headers to include in logs (default: none) */
+    headers?: string[];
+}
+/**
+ * Initialize evlog for Cloudflare Workers.
+ * Call once at module scope.
+ *
+ * @example
+ * ```ts
+ * initWorkersLogger({
+ *   env: { service: 'my-api' },
+ * })
+ * ```
+ */
+declare function initWorkersLogger(options?: LoggerConfig): void;
+/**
+ * Create a request-scoped logger for Cloudflare Workers.
+ * Auto-extracts cf-ray, request.cf context, method, and path.
+ *
+ * @example
+ * ```ts
+ * export default {
+ *   async fetch(request: Request) {
+ *     const log = createWorkersLogger(request)
+ *
+ *     log.set({ user: { id: '123' } })
+ *     log.emit({ status: 200 })
+ *
+ *     return new Response('ok')
+ *   }
+ * }
+ * ```
+ */
+declare function createWorkersLogger(request: Request, options?: WorkersLoggerOptions): RequestLogger;
+
+export { createWorkersLogger, initWorkersLogger };
+export type { WorkersLoggerOptions };

package/dist/workers.d.ts

@@ -0,0 +1,45 @@
+import { RequestLogger, LoggerConfig } from './types.js';
+
+/**
+ * Options for createWorkersLogger
+ */
+interface WorkersLoggerOptions {
+    /** Override the request ID (default: cf-ray header) */
+    requestId?: string;
+    /** Headers to include in logs (default: none) */
+    headers?: string[];
+}
+/**
+ * Initialize evlog for Cloudflare Workers.
+ * Call once at module scope.
+ *
+ * @example
+ * ```ts
+ * initWorkersLogger({
+ *   env: { service: 'my-api' },
+ * })
+ * ```
+ */
+declare function initWorkersLogger(options?: LoggerConfig): void;
+/**
+ * Create a request-scoped logger for Cloudflare Workers.
+ * Auto-extracts cf-ray, request.cf context, method, and path.
+ *
+ * @example
+ * ```ts
+ * export default {
+ *   async fetch(request: Request) {
+ *     const log = createWorkersLogger(request)
+ *
+ *     log.set({ user: { id: '123' } })
+ *     log.emit({ status: 200 })
+ *
+ *     return new Response('ok')
+ *   }
+ * }
+ * ```
+ */
+declare function createWorkersLogger(request: Request, options?: WorkersLoggerOptions): RequestLogger;
+
+export { createWorkersLogger, initWorkersLogger };
+export type { WorkersLoggerOptions };

package/dist/workers.mjs

@@ -0,0 +1,53 @@
+import { createRequestLogger, initLogger } from './logger.mjs';
+import 'defu';
+import './utils.mjs';
+
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function collectHeaders(headers, include) {
+  if (!include || include.length === 0) return void 0;
+  const normalized = new Set(include.map((h) => h.toLowerCase()));
+  const result = {};
+  headers.forEach((value, key) => {
+    if (normalized.has(key.toLowerCase())) {
+      result[key] = value;
+    }
+  });
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function initWorkersLogger(options = {}) {
+  initLogger({
+    ...options,
+    pretty: false,
+    stringify: false
+  });
+}
+function pickCfContext(request) {
+  const cf = Reflect.get(request, "cf");
+  if (!isRecord(cf)) return {};
+  const out = {};
+  if (typeof cf.colo === "string") out.colo = cf.colo;
+  if (typeof cf.country === "string") out.country = cf.country;
+  if (typeof cf.asn === "number") out.asn = cf.asn;
+  return out;
+}
+function createWorkersLogger(request, options = {}) {
+  const url = new URL(request.url);
+  const cfRay = request.headers.get("cf-ray") ?? void 0;
+  const traceparent = request.headers.get("traceparent") ?? void 0;
+  const log = createRequestLogger({
+    method: request.method,
+    path: url.pathname,
+    requestId: options.requestId ?? cfRay
+  });
+  log.set({
+    cfRay,
+    traceparent,
+    ...pickCfContext(request),
+    ...options.headers ? { requestHeaders: collectHeaders(request.headers, options.headers) } : {}
+  });
+  return log;
+}
+
+export { createWorkersLogger, initWorkersLogger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evlog",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Wide event logging library with structured error handling. Inspired by LoggingSucks.",
   "author": "HugoRCD <contact@hrcd.fr>",
   "homepage": "https://evlog.dev",
@@ -34,6 +34,18 @@
     "./nitro": {
       "types": "./dist/nitro/plugin.d.mts",
       "import": "./dist/nitro/plugin.mjs"
+    },
+    "./workers": {
+      "types": "./dist/workers.d.mts",
+      "import": "./dist/workers.mjs"
+    },
+    "./axiom": {
+      "types": "./dist/adapters/axiom.d.mts",
+      "import": "./dist/adapters/axiom.mjs"
+    },
+    "./otlp": {
+      "types": "./dist/adapters/otlp.d.mts",
+      "import": "./dist/adapters/otlp.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -48,6 +60,15 @@
       ],
       "nitro": [
         "./dist/nitro/plugin.d.mts"
+      ],
+      "workers": [
+        "./dist/workers.d.mts"
+      ],
+      "axiom": [
+        "./dist/adapters/axiom.d.mts"
+      ],
+      "otlp": [
+        "./dist/adapters/otlp.d.mts"
       ]
     }
   },