@senzops/apm-worker 1.0.0

package/README.md

@@ -0,0 +1,133 @@
+# **@senzops/apm-worker**
+
+The official Serverless & Worker SDK for **Senzor APM**.
+
+Designed specifically for **Cloudflare Workers**, **Cloudflare Pages**, **Nitro**, and modern Edge runtimes.
+
+## **✨ Features**
+
+- **Zero-Config Auto-Instrumentation:** Automatically captures all global `fetch` calls.
+- **Context Propagation:** Uses `AsyncLocalStorage` (via `nodejs_compat`) to track requests across async boundaries without manual passing.
+- **Lightweight:** < 5KB gzip, zero external dependencies.
+- **Non-Blocking:** Uses `ctx.waitUntil` to flush data without adding latency to user responses.
+- **W3C Trace Context:** Automatically injects `traceparent` headers into outgoing requests for distributed tracing.
+
+## **📦 Installation**
+
+```sh
+npm install @senzops/apm-worker
+```
+
+## **🚀 Quick Start (Cloudflare Workers)**
+
+### **1. Enable Node Compatibility**
+
+Add the `nodejs_compat` flag to your `wrangler.toml`. This is **required** for the SDK to track context across async `fetch` calls.
+
+```toml
+# wrangler.toml
+compatibility_flags = [ "nodejs_compat" ]
+compatibility_date = "2024-09-23"
+```
+
+### **2. Integrate the SDK**
+
+Initialize Senzor in the global scope and wrap your `fetch` handler.
+
+```typescript
+import Senzor from "@senzops/apm-worker";
+
+// 1. Initialize (Global Scope)
+Senzor.init({
+  apiKey: "sz_apm_...",
+});
+
+export default {
+  // 2. Wrap the fetch handler
+  fetch: Senzor.worker(async (request, env, ctx) => {
+    // ... your code ...
+    return new Response("Hello World!");
+  }),
+};
+```
+
+---
+
+## **⚡ Usage with Nitro / Nuxt**
+
+If you are using **Nitro** (standalone) or **Nuxt** deployed to Cloudflare Workers.
+
+### **1. Create a Server Plugin**
+
+Create a file at `server/plugins/senzor.ts`:
+
+```typescript
+import Senzor from "@senzops/apm-worker";
+
+export default defineNitroPlugin((nitroApp) => {
+  // 1. Initialize
+  // Note: For Workers, 'env' vars might need runtime access or define replacement
+  Senzor.init({
+    apiKey: process.env.SENZOR_API_KEY || "sz_apm_...",
+  });
+
+  // 2. Hook into request handling
+  nitroApp.hooks.hook("request", (event) => {
+    // Nitro hooks don't easily allow wrapping the entire execution context for AsyncLocalStorage yet.
+    // For full auto-instrumentation, consider wrapping specific event handlers or using the middleware approach below.
+  });
+});
+```
+
+### **Recommended: Wrap Event Handlers**
+
+To ensure `fetch` auto-instrumentation works correctly with `AsyncLocalStorage`, wrap your event handlers.
+
+```typescript
+// server/api/hello.ts
+import Senzor from "@senzops/apm-worker";
+
+export default Senzor.nitro(
+  defineEventHandler(async (event) => {
+    // ✅ This fetch is automatically tracked
+    await fetch("https://google.com");
+
+    return { hello: "world" };
+  }),
+);
+```
+
+### **Configuration (nitro.config.ts)**
+
+Ensure you enable the node compatibility for Cloudflare.
+
+```typescript
+// nitro.config.ts
+export default defineNitroConfig({
+  cloudflare: {
+    wrangler: {
+      compatibility_flags: ["nodejs_compat"],
+    },
+  },
+});
+```
+
+---
+
+## **📋 Production Checklist**
+
+### **1. Environment Variables**
+
+For security, do not commit your API key.
+
+1. Run `npx wrangler secret put SENZOR_API_KEY`.
+2. Update your worker to initialize lazily or use build-time variables.
+
+### **2. Distributed Tracing**
+
+If your Worker calls other services (like a backend API), this SDK automatically adds the `traceparent` header.
+Ensure your backend services (Node.js, Python, Go) are configured to extract this header to see a connected trace from Edge -> Backend.
+
+### **3. Error Tracking**
+
+Any uncaught exception thrown in your handler is automatically captured, logged, and reported to Senzor with the stack trace.

package/dist/index.d.mts

@@ -0,0 +1,41 @@
+interface SenzorOptions {
+    apiKey: string;
+    endpoint?: string;
+    debug?: boolean;
+}
+interface TraceController {
+    /**
+     * Starts a new span.
+     */
+    startSpan(name: string, type?: 'db' | 'http' | 'function' | 'custom'): {
+        end: (meta?: any, status?: number) => void;
+    };
+    /**
+     * Adds an error to the trace.
+     */
+    captureException(error: Error | any): void;
+    /**
+     * The trace ID for the current session
+     */
+    readonly traceId: string;
+}
+
+declare const Senzor: {
+    /**
+     * Initialize the SDK.
+     * Call this in the global scope of your Worker or Plugin.
+     */
+    init: (options: SenzorOptions) => void;
+    /**
+     * Wrap your Cloudflare Worker 'fetch' handler.
+     * Inject trace controller as the 4th argument.
+     */
+    worker: (handler: (request: Request, env: any, ctx: any, trace: TraceController) => Promise<Response>) => (request: Request, env: any, ctx: any) => Promise<Response>;
+    /**
+     * Wrap a Nitro/H3 event handler.
+     * Use this for Nuxt or pure Nitro server routes.
+     */
+    nitro: (handler: (event: any) => any) => (event: any) => Promise<any>;
+};
+
+export { Senzor, type TraceController, Senzor as default };

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+interface SenzorOptions {
+    apiKey: string;
+    endpoint?: string;
+    debug?: boolean;
+}
+interface TraceController {
+    /**
+     * Starts a new span.
+     */
+    startSpan(name: string, type?: 'db' | 'http' | 'function' | 'custom'): {
+        end: (meta?: any, status?: number) => void;
+    };
+    /**
+     * Adds an error to the trace.
+     */
+    captureException(error: Error | any): void;
+    /**
+     * The trace ID for the current session
+     */
+    readonly traceId: string;
+}
+
+declare const Senzor: {
+    /**
+     * Initialize the SDK.
+     * Call this in the global scope of your Worker or Plugin.
+     */
+    init: (options: SenzorOptions) => void;
+    /**
+     * Wrap your Cloudflare Worker 'fetch' handler.
+     * Inject trace controller as the 4th argument.
+     */
+    worker: (handler: (request: Request, env: any, ctx: any, trace: TraceController) => Promise<Response>) => (request: Request, env: any, ctx: any) => Promise<Response>;
+    /**
+     * Wrap a Nitro/H3 event handler.
+     * Use this for Nuxt or pure Nitro server routes.
+     */
+    nitro: (handler: (event: any) => any) => (event: any) => Promise<any>;
+};
+
+export { Senzor, type TraceController, Senzor as default };

package/dist/index.global.js

@@ -0,0 +1,2 @@
+"use strict";(()=>{var z=(r=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(r,{get:(t,e)=>(typeof require<"u"?require:t)[e]}):r)(function(r){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+r+'" is not supported')});var m=class{constructor(t){this.config=t;this.queue=[]}add(t){this.queue.push(t)}async flush(){if(this.queue.length===0)return;let t=[...this.queue];this.queue=[];try{let e=this.config.endpoint||"https://api.senzor.dev/api/ingest/apm";await fetch(e,{method:"POST",headers:{"Content-Type":"application/json","x-service-api-key":this.config.apiKey},body:JSON.stringify(t),keepalive:!0}),this.config.debug&&console.log(`[Senzor] Flushed ${t.length} traces`)}catch(e){this.config.debug&&console.error("[Senzor] Ingestion Error:",e)}}};var T=z("async_hooks"),f=new T.AsyncLocalStorage;var w=!1,S=()=>{if(w)return;let r=globalThis.fetch;globalThis.fetch=async(t,e)=>{let n=f.getStore();if(!n)return r(t,e);let o="",a="GET";typeof t=="string"?o=t:t instanceof URL?o=t.toString():t instanceof Request&&(o=t.url,a=t.method),e&&e.method&&(a=e.method);let s=`HTTP ${a}`,c=n.startSpan(s,"http"),l=new Headers(e?.headers||(t instanceof Request?t.headers:{})),i=crypto.randomUUID().replace(/-/g,"").substring(0,16),h=`00-${n.traceId}-${i}-01`;l.set("traceparent",h);let u={...e,headers:l};try{let p=await r(t,u);return c.end({url:o,method:a,status:p.status},p.status),p}catch(p){throw c.end({url:o,method:a,error:p.message},500),p}},w=!0};var g=class{constructor(){this.transport=null;this.options=null}init(t){if(!t.apiKey){console.warn("[Senzor] API Key missing. SDK disabled.");return}this.options=t,this.transport=new m(t);try{S()}catch(e){t.debug&&console.warn("[Senzor] Failed to instrument fetch:",e)}t.debug&&console.log("[Senzor] Initialized for Serverless")}createTrace(t){if(!this.transport)return{controller:{startSpan:()=>({end:()=>{}}),captureException:()=>{},traceId:"00000000000000000000000000000000"},end:()=>{},flush:async()=>{}};let e=crypto.randomUUID().replace(/-/g,""),n=performance.now(),o=[];return{controller:{traceId:e,startSpan:(i,h="custom")=>{let u=performance.now(),p=u-n;return{end:(R,U)=>{o.push({name:i,type:h,startTime:p,duration:performance.now()-u,status:U,meta:R})}}},captureException:i=>{o.push({name:"exception",type:"custom",startTime:performance.now()-n,duration:0,status:500,meta:{error:i.message||String(i),stack:i.stack}})}},end:(i,h="UNKNOWN")=>{let u=performance.now()-n,p={traceId:e,method:t.method||"GET",route:h,path:t.path||"/",status:i,duration:u,ip:t.ip,userAgent:t.userAgent,timestamp:new Date().toISOString(),spans:o};this.transport?.add(p)},flush:async()=>{await this.transport?.flush()}}}track(t){if(!this.transport)return;let e={traceId:crypto.randomUUID(),method:t.method||"GET",route:t.route,path:t.path||"/",status:t.status,duration:t.duration,ip:t.ip,userAgent:t.userAgent,timestamp:new Date().toISOString(),spans:t.spans||[]};this.transport.add(e),this.transport.flush().catch(()=>{})}startTrace(t,e){return e()}endTrace(t,e){}},d=new g;var y=r=>!r||r==="/"?"/":r.replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,":uuid").replace(/[0-9a-fA-F]{24}/g,":objectId").replace(/\/(\d+)(?=\/|$)/g,"/:id").split("?")[0],b=(r,t)=>r.route&&r.route.path?(r.baseUrl||"")+r.route.path:r.context&&r.context.matchedRoute?r.context.matchedRoute.path:r.routerPath?r.routerPath:y(t);var x=r=>async(t,e,n)=>{let a=new URL(t.url).pathname,s=d.createTrace({method:t.method,path:a,userAgent:t.headers.get("user-agent")||void 0,ip:t.headers.get("cf-connecting-ip")||t.headers.get("x-forwarded-for")||void 0});return f.run(s.controller,async()=>{let c,l=500;try{return c=await r(t,e,n,s.controller),l=c.status,c}catch(i){throw s.controller.captureException(i),i}finally{s.end(l,y(a)),n&&typeof n.waitUntil=="function"?n.waitUntil(s.flush()):await s.flush()}})};var I=r=>async t=>{let e=t.node.req,n=e.originalUrl||e.url||"/",o=d.createTrace({method:e.method||"GET",path:n,ip:e.headers["x-forwarded-for"]||e.socket?.remoteAddress||t.context?.cf?.connectingIp,userAgent:e.headers["user-agent"]});return f.run(o.controller,async()=>{let a,s=200;try{return a=await r(t),t.node.res.statusCode&&(s=t.node.res.statusCode),a&&a.statusCode&&(s=a.statusCode),a}catch(c){throw s=c.statusCode||c.status||500,o.controller.captureException(c),c}finally{o.end(s,b(t,n));let l=(t.context?.cloudflare?.context||t.context?.cf)?.waitUntil||t.waitUntil;l&&typeof l=="function"?l(o.flush()):o.flush().catch(()=>{})}})};var A={init:r=>d.init(r),worker:x,nitro:I},Q=A;})();
+//# sourceMappingURL=index.global.js.map

package/dist/index.global.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/transport.ts","../src/core/context.ts","../src/instrumentation/fetch.ts","../src/core/client.ts","../src/core/normalizer.ts","../src/wrappers/worker.ts","../src/wrappers/h3.ts","../src/index.ts"],"sourcesContent":["import { SenzorOptions, TraceData } from './types';\r\n\r\nexport class Transport {\r\n  private queue: TraceData[] = [];\r\n\r\n  constructor(private config: SenzorOptions) { }\r\n\r\n  public add(trace: TraceData) {\r\n    this.queue.push(trace);\r\n  }\r\n\r\n  /**\r\n   * Flushes the queue to the API. \r\n   * Returns a promise that should be passed to ctx.waitUntil()\r\n   */\r\n  public async flush(): Promise<void> {\r\n    if (this.queue.length === 0) return;\r\n\r\n    const batch = [...this.queue];\r\n    this.queue = []; // Clear immediately\r\n\r\n    try {\r\n      const endpoint = this.config.endpoint || 'https://api.senzor.dev/api/ingest/apm';\r\n\r\n      await fetch(endpoint, {\r\n        method: 'POST',\r\n        headers: {\r\n          'Content-Type': 'application/json',\r\n          'x-service-api-key': this.config.apiKey,\r\n        },\r\n        body: JSON.stringify(batch),\r\n        // keepalive is not strictly necessary in workers if awaited/waitUntil'd, but good practice\r\n        keepalive: true,\r\n      });\r\n\r\n      if (this.config.debug) console.log(`[Senzor] Flushed ${batch.length} traces`);\r\n    } catch (err) {\r\n      if (this.config.debug) console.error('[Senzor] Ingestion Error:', err);\r\n    }\r\n  }\r\n}\r\n","import { AsyncLocalStorage } from 'node:async_hooks';\r\nimport { TraceController } from './types';\r\n\r\n// This relies on the 'nodejs_compat' compatibility flag in Cloudflare Workers.\r\nexport const storage = new AsyncLocalStorage<TraceController>();\r\n","import { storage } from '../core/context';\r\n\r\nlet isInstrumented = false;\r\n\r\nexport const enableFetchInstrumentation = () => {\r\n  if (isInstrumented) return;\r\n\r\n  const originalFetch = globalThis.fetch;\r\n\r\n  // Monkey-patch global fetch\r\n  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {\r\n    // 1. Check for active trace context\r\n    const controller = storage.getStore();\r\n\r\n    // If no trace is active, just pass through\r\n    if (!controller) {\r\n      return originalFetch(input, init);\r\n    }\r\n\r\n    // 2. Resolve URL and Method\r\n    let url = '';\r\n    let method = 'GET';\r\n\r\n    if (typeof input === 'string') {\r\n      url = input;\r\n    } else if (input instanceof URL) {\r\n      url = input.toString();\r\n    } else if (input instanceof Request) {\r\n      url = input.url;\r\n      method = input.method;\r\n    }\r\n\r\n    if (init && init.method) {\r\n      method = init.method;\r\n    }\r\n\r\n    // 3. Start Span\r\n    const spanName = `HTTP ${method}`;\r\n    const span = controller.startSpan(spanName, 'http');\r\n\r\n    // 4. Inject Trace Headers (W3C Trace Context)\r\n    // We clone headers to avoid side effects on the input object\r\n    const headers = new Headers(init?.headers || (input instanceof Request ? input.headers : {}));\r\n\r\n    // Generate a span ID for the outgoing request\r\n    const spanId = crypto.randomUUID().replace(/-/g, '').substring(0, 16);\r\n    const traceParent = `00-${controller.traceId}-${spanId}-01`;\r\n    headers.set('traceparent', traceParent);\r\n\r\n    const newInit: RequestInit = {\r\n      ...init,\r\n      headers\r\n    };\r\n\r\n    try {\r\n      const response = await originalFetch(input, newInit);\r\n      span.end({\r\n        url,\r\n        method,\r\n        status: response.status\r\n      }, response.status);\r\n      return response;\r\n    } catch (err: any) {\r\n      span.end({\r\n        url,\r\n        method,\r\n        error: err.message\r\n      }, 500);\r\n      throw err;\r\n    }\r\n  };\r\n\r\n  isInstrumented = true;\r\n};\r\n","import { Transport } from './transport';\r\nimport { SenzorOptions, TraceData, Span, TraceController } from './types';\r\nimport { enableFetchInstrumentation } from '../instrumentation/fetch';\r\n\r\nexport class SenzorClient {\r\n  private transport: Transport | null = null;\r\n  private options: SenzorOptions | null = null;\r\n\r\n  public init(options: SenzorOptions) {\r\n    if (!options.apiKey) {\r\n      console.warn('[Senzor] API Key missing. SDK disabled.');\r\n      return;\r\n    }\r\n    this.options = options;\r\n    this.transport = new Transport(options);\r\n\r\n    // Auto-instrument global fetch\r\n    try {\r\n      enableFetchInstrumentation();\r\n    } catch (e) {\r\n      if (options.debug) console.warn('[Senzor] Failed to instrument fetch:', e);\r\n    }\r\n\r\n    if (options.debug) console.log('[Senzor] Initialized for Serverless');\r\n  }\r\n\r\n  /**\r\n   * Creates a detached trace session.\r\n   */\r\n  public createTrace(data: Partial<TraceData>): { controller: TraceController, end: (status: number, route?: string) => void, flush: () => Promise<void> } {\r\n    if (!this.transport) {\r\n      // Return dummy if not initialized\r\n      return {\r\n        controller: {\r\n          startSpan: () => ({ end: () => { } }),\r\n          captureException: () => { },\r\n          traceId: '00000000000000000000000000000000'\r\n        },\r\n        end: () => { },\r\n        flush: async () => { }\r\n      };\r\n    }\r\n\r\n    const traceId = crypto.randomUUID().replace(/-/g, ''); // 32 hex chars usually\r\n    const startTime = performance.now();\r\n    const spans: Span[] = [];\r\n\r\n    const startSpan = (name: string, type: 'db' | 'http' | 'function' | 'custom' = 'custom') => {\r\n      const spanStartAbs = performance.now();\r\n      const startRel = spanStartAbs - startTime;\r\n      return {\r\n        end: (meta?: any, status?: number) => {\r\n          spans.push({\r\n            name,\r\n            type,\r\n            startTime: startRel, // Relative to trace start\r\n            duration: performance.now() - spanStartAbs,\r\n            status,\r\n            meta\r\n          });\r\n        }\r\n      };\r\n    };\r\n\r\n    const controller: TraceController = {\r\n      traceId,\r\n      startSpan,\r\n      captureException: (err: any) => {\r\n        spans.push({\r\n          name: 'exception',\r\n          type: 'custom',\r\n          startTime: performance.now() - startTime,\r\n          duration: 0,\r\n          status: 500,\r\n          meta: { error: err.message || String(err), stack: err.stack }\r\n        });\r\n      }\r\n    };\r\n\r\n    const end = (status: number, route: string = 'UNKNOWN') => {\r\n      const duration = performance.now() - startTime;\r\n      const payload: TraceData = {\r\n        traceId,\r\n        method: data.method || 'GET',\r\n        route,\r\n        path: data.path || '/',\r\n        status,\r\n        duration,\r\n        ip: data.ip,\r\n        userAgent: data.userAgent,\r\n        timestamp: new Date().toISOString(),\r\n        spans\r\n      };\r\n      this.transport?.add(payload);\r\n    };\r\n\r\n    const flush = async () => {\r\n      await this.transport?.flush();\r\n    };\r\n\r\n    return { controller, end, flush };\r\n  }\r\n\r\n  /**\r\n   * Track a single request trace immediately.\r\n   */\r\n  public track(data: Partial<TraceData> & { status: number, duration: number, route: string }) {\r\n    if (!this.transport) return;\r\n\r\n    const payload: TraceData = {\r\n      traceId: crypto.randomUUID(),\r\n      method: data.method || 'GET',\r\n      route: data.route,\r\n      path: data.path || '/',\r\n      status: data.status,\r\n      duration: data.duration,\r\n      ip: data.ip,\r\n      userAgent: data.userAgent,\r\n      timestamp: new Date().toISOString(),\r\n      spans: data.spans || []\r\n    };\r\n\r\n    this.transport.add(payload);\r\n    this.transport.flush().catch(() => { });\r\n  }\r\n\r\n  // Stubs for legacy Node support\r\n  public startTrace<T>(data: Partial<TraceData>, callback: () => T): T { return callback(); }\r\n  public endTrace(status: number, data?: { route?: string }) { }\r\n}\r\n\r\nexport const client = new SenzorClient();\r\n","/**\r\n * Heuristic URL Normalizer\r\n * Converts raw paths with IDs into generic patterns to prevent high cardinality.\r\n * Example: /users/123/orders/abc-def -> /users/:id/orders/:uuid\r\n */\r\nexport const normalizePath = (path: string): string => {\r\n  if (!path || path === '/') return '/';\r\n\r\n  return path\r\n    // Replace UUIDs (long alphanumeric strings)\r\n    .replace(\r\n      /[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,\r\n      ':uuid'\r\n    )\r\n    // Replace MongoDB ObjectIds (24 hex chars)\r\n    .replace(/[0-9a-fA-F]{24}/g, ':objectId')\r\n    // Replace pure numeric IDs (e.g., /123)\r\n    .replace(/\\/(\\d+)(?=\\/|$)/g, '/:id')\r\n    // Remove query strings\r\n    .split('?')[0];\r\n};\r\n\r\n/**\r\n * Tries to extract route from Framework internals, falls back to heuristic\r\n */\r\nexport const getRoute = (req: any, fallbackPath: string): string => {\r\n  // Express / Connect\r\n  if (req.route && req.route.path) {\r\n    return (req.baseUrl || '') + req.route.path;\r\n  }\r\n\r\n  // H3 / Nitro (Nuxt)\r\n  if (req.context && req.context.matchedRoute) {\r\n    return req.context.matchedRoute.path;\r\n  }\r\n\r\n  // Fastify\r\n  if (req.routerPath) {\r\n    return req.routerPath;\r\n  }\r\n\r\n  // Fallback: Heuristic Normalization\r\n  return normalizePath(fallbackPath);\r\n};","import { client } from '../core/client';\r\nimport { normalizePath } from '../core/normalizer';\r\nimport { TraceController } from '../core/types';\r\nimport { storage } from '../core/context';\r\n\r\ntype WorkerHandler = (request: Request, env: any, ctx: any, trace: TraceController) => Promise<Response>;\r\n\r\nexport const wrapWorker = (handler: WorkerHandler) => {\r\n  return async (request: Request, env: any, ctx: any) => {\r\n    // 2. Extract Request Info\r\n    const url = new URL(request.url);\r\n    const path = url.pathname;\r\n\r\n    // 3. Start Trace\r\n    const session = client.createTrace({\r\n      method: request.method,\r\n      path: path,\r\n      userAgent: request.headers.get('user-agent') || undefined,\r\n      ip: request.headers.get('cf-connecting-ip') || request.headers.get('x-forwarded-for') || undefined\r\n    });\r\n\r\n    // 4. Run Handler within Context (AsyncLocalStorage)\r\n    // This enables the global fetch instrumentation to find the current trace controller\r\n    return storage.run(session.controller, async () => {\r\n      let response: Response;\r\n      let status = 500;\r\n\r\n      try {\r\n        // Inject trace controller as 4th arg for manual usage\r\n        response = await handler(request, env, ctx, session.controller);\r\n        status = response.status;\r\n        return response;\r\n      } catch (err: any) {\r\n        session.controller.captureException(err);\r\n        throw err;\r\n      } finally {\r\n        // 5. End Trace\r\n        session.end(status, normalizePath(path));\r\n\r\n        // 6. Flush (Async WaitUntil)\r\n        if (ctx && typeof ctx.waitUntil === 'function') {\r\n          ctx.waitUntil(session.flush());\r\n        } else {\r\n          await session.flush();\r\n        }\r\n      }\r\n    });\r\n  };\r\n};\r\n","import { client } from '../core/client';\r\nimport { getRoute } from '../core/normalizer';\r\nimport { storage } from '../core/context';\r\n\r\n// Minimal types for H3 to avoid peer-deps\r\ntype EventHandler = (event: any) => any;\r\n\r\nexport const wrapH3 = (handler: EventHandler) => {\r\n  return async (event: any) => {\r\n    const req = event.node.req;\r\n    const path = req.originalUrl || req.url || '/';\r\n\r\n    // 1. Start Trace Session\r\n    const session = client.createTrace({\r\n      method: req.method || 'GET',\r\n      path: path,\r\n      ip: req.headers['x-forwarded-for'] || req.socket?.remoteAddress || event.context?.cf?.connectingIp,\r\n      userAgent: req.headers['user-agent'],\r\n    });\r\n\r\n    // 2. Run Handler within AsyncLocalStorage Context\r\n    // This ensures global fetch() auto-instrumentation works inside Nitro handlers\r\n    return storage.run(session.controller, async () => {\r\n      let response: any;\r\n      let status = 200;\r\n\r\n      try {\r\n        response = await handler(event);\r\n\r\n        // H3/Nitro response status handling\r\n        if (event.node.res.statusCode) status = event.node.res.statusCode;\r\n        if (response && response.statusCode) status = response.statusCode;\r\n\r\n        return response;\r\n      } catch (err: any) {\r\n        status = err.statusCode || err.status || 500;\r\n        session.controller.captureException(err);\r\n        throw err;\r\n      } finally {\r\n        // 3. End Trace\r\n        session.end(status, getRoute(event, path));\r\n\r\n        // 4. Flush Data (Non-blocking for Cloudflare)\r\n        // Nitro exposes Cloudflare context in event.context.cloudflare\r\n        const cfCtx = event.context?.cloudflare?.context || event.context?.cf;\r\n        // Or sometimes directly on event in newer H3 versions if adapter binds it\r\n        const waitUntil = cfCtx?.waitUntil || event.waitUntil;\r\n\r\n        if (waitUntil && typeof waitUntil === 'function') {\r\n          waitUntil(session.flush());\r\n        } else {\r\n          // If not in a worker environment or waitUntil missing, flush async but don't block response significantly\r\n          // (Note: without waitUntil, the runtime might kill the process before flush completes)\r\n          session.flush().catch(() => { });\r\n        }\r\n      }\r\n    });\r\n  };\r\n};\r\n","import { client } from './core/client';\r\nimport { wrapWorker } from './wrappers/worker';\r\nimport { wrapH3 } from './wrappers/h3';\r\nimport { SenzorOptions } from './core/types';\r\n\r\nconst Senzor = {\r\n  /**\r\n   * Initialize the SDK.\r\n   * Call this in the global scope of your Worker or Plugin.\r\n   */\r\n  init: (options: SenzorOptions) => client.init(options),\r\n\r\n  /**\r\n   * Wrap your Cloudflare Worker 'fetch' handler.\r\n   * Inject trace controller as the 4th argument.\r\n   */\r\n  worker: wrapWorker,\r\n\r\n  /**\r\n   * Wrap a Nitro/H3 event handler.\r\n   * Use this for Nuxt or pure Nitro server routes.\r\n   */\r\n  nitro: wrapH3\r\n};\r\n\r\nexport default Senzor;\r\nexport { Senzor };\r\nexport type { TraceController } from './core/types';\r\n"],"mappings":"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","names":["Transport","config","trace","batch","endpoint","err","import_node_async_hooks","storage","isInstrumented","enableFetchInstrumentation","originalFetch","input","init","controller","storage","url","method","spanName","span","headers","spanId","traceParent","newInit","response","err","SenzorClient","options","Transport","enableFetchInstrumentation","data","traceId","startTime","spans","name","type","spanStartAbs","startRel","meta","status","err","route","duration","payload","callback","client","normalizePath","path","getRoute","req","fallbackPath","wrapWorker","handler","request","env","ctx","path","session","client","storage","response","status","err","normalizePath","wrapH3","handler","event","req","path","session","client","storage","response","status","err","getRoute","waitUntil","Senzor","options","client","wrapWorker","wrapH3","index_default"]}

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";var g=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var O=(r,t)=>{for(var e in t)g(r,e,{get:t[e],enumerable:!0})},k=(r,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of D(t))!P.call(r,o)&&o!==e&&g(r,o,{get:()=>t[o],enumerable:!(n=C(t,o))||n.enumerable});return r};var E=r=>k(g({},"__esModule",{value:!0}),r);var H={};O(H,{Senzor:()=>U,default:()=>F});module.exports=E(H);var m=class{constructor(t){this.config=t;this.queue=[]}add(t){this.queue.push(t)}async flush(){if(this.queue.length===0)return;let t=[...this.queue];this.queue=[];try{let e=this.config.endpoint||"https://api.senzor.dev/api/ingest/apm";await fetch(e,{method:"POST",headers:{"Content-Type":"application/json","x-service-api-key":this.config.apiKey},body:JSON.stringify(t),keepalive:!0}),this.config.debug&&console.log(`[Senzor] Flushed ${t.length} traces`)}catch(e){this.config.debug&&console.error("[Senzor] Ingestion Error:",e)}}};var w=require("async_hooks"),f=new w.AsyncLocalStorage;var S=!1,b=()=>{if(S)return;let r=globalThis.fetch;globalThis.fetch=async(t,e)=>{let n=f.getStore();if(!n)return r(t,e);let o="",a="GET";typeof t=="string"?o=t:t instanceof URL?o=t.toString():t instanceof Request&&(o=t.url,a=t.method),e&&e.method&&(a=e.method);let s=`HTTP ${a}`,c=n.startSpan(s,"http"),l=new Headers(e?.headers||(t instanceof Request?t.headers:{})),i=crypto.randomUUID().replace(/-/g,"").substring(0,16),h=`00-${n.traceId}-${i}-01`;l.set("traceparent",h);let u={...e,headers:l};try{let p=await r(t,u);return c.end({url:o,method:a,status:p.status},p.status),p}catch(p){throw c.end({url:o,method:a,error:p.message},500),p}},S=!0};var y=class{constructor(){this.transport=null;this.options=null}init(t){if(!t.apiKey){console.warn("[Senzor] API Key missing. SDK disabled.");return}this.options=t,this.transport=new m(t);try{b()}catch(e){t.debug&&console.warn("[Senzor] Failed to instrument fetch:",e)}t.debug&&console.log("[Senzor] Initialized for Serverless")}createTrace(t){if(!this.transport)return{controller:{startSpan:()=>({end:()=>{}}),captureException:()=>{},traceId:"00000000000000000000000000000000"},end:()=>{},flush:async()=>{}};let e=crypto.randomUUID().replace(/-/g,""),n=performance.now(),o=[];return{controller:{traceId:e,startSpan:(i,h="custom")=>{let u=performance.now(),p=u-n;return{end:(z,A)=>{o.push({name:i,type:h,startTime:p,duration:performance.now()-u,status:A,meta:z})}}},captureException:i=>{o.push({name:"exception",type:"custom",startTime:performance.now()-n,duration:0,status:500,meta:{error:i.message||String(i),stack:i.stack}})}},end:(i,h="UNKNOWN")=>{let u=performance.now()-n,p={traceId:e,method:t.method||"GET",route:h,path:t.path||"/",status:i,duration:u,ip:t.ip,userAgent:t.userAgent,timestamp:new Date().toISOString(),spans:o};this.transport?.add(p)},flush:async()=>{await this.transport?.flush()}}}track(t){if(!this.transport)return;let e={traceId:crypto.randomUUID(),method:t.method||"GET",route:t.route,path:t.path||"/",status:t.status,duration:t.duration,ip:t.ip,userAgent:t.userAgent,timestamp:new Date().toISOString(),spans:t.spans||[]};this.transport.add(e),this.transport.flush().catch(()=>{})}startTrace(t,e){return e()}endTrace(t,e){}},d=new y;var T=r=>!r||r==="/"?"/":r.replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,":uuid").replace(/[0-9a-fA-F]{24}/g,":objectId").replace(/\/(\d+)(?=\/|$)/g,"/:id").split("?")[0],x=(r,t)=>r.route&&r.route.path?(r.baseUrl||"")+r.route.path:r.context&&r.context.matchedRoute?r.context.matchedRoute.path:r.routerPath?r.routerPath:T(t);var I=r=>async(t,e,n)=>{let a=new URL(t.url).pathname,s=d.createTrace({method:t.method,path:a,userAgent:t.headers.get("user-agent")||void 0,ip:t.headers.get("cf-connecting-ip")||t.headers.get("x-forwarded-for")||void 0});return f.run(s.controller,async()=>{let c,l=500;try{return c=await r(t,e,n,s.controller),l=c.status,c}catch(i){throw s.controller.captureException(i),i}finally{s.end(l,T(a)),n&&typeof n.waitUntil=="function"?n.waitUntil(s.flush()):await s.flush()}})};var R=r=>async t=>{let e=t.node.req,n=e.originalUrl||e.url||"/",o=d.createTrace({method:e.method||"GET",path:n,ip:e.headers["x-forwarded-for"]||e.socket?.remoteAddress||t.context?.cf?.connectingIp,userAgent:e.headers["user-agent"]});return f.run(o.controller,async()=>{let a,s=200;try{return a=await r(t),t.node.res.statusCode&&(s=t.node.res.statusCode),a&&a.statusCode&&(s=a.statusCode),a}catch(c){throw s=c.statusCode||c.status||500,o.controller.captureException(c),c}finally{o.end(s,x(t,n));let l=(t.context?.cloudflare?.context||t.context?.cf)?.waitUntil||t.waitUntil;l&&typeof l=="function"?l(o.flush()):o.flush().catch(()=>{})}})};var U={init:r=>d.init(r),worker:I,nitro:R},F=U;0&&(module.exports={Senzor});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core/transport.ts","../src/core/context.ts","../src/instrumentation/fetch.ts","../src/core/client.ts","../src/core/normalizer.ts","../src/wrappers/worker.ts","../src/wrappers/h3.ts"],"sourcesContent":["import { client } from './core/client';\r\nimport { wrapWorker } from './wrappers/worker';\r\nimport { wrapH3 } from './wrappers/h3';\r\nimport { SenzorOptions } from './core/types';\r\n\r\nconst Senzor = {\r\n  /**\r\n   * Initialize the SDK.\r\n   * Call this in the global scope of your Worker or Plugin.\r\n   */\r\n  init: (options: SenzorOptions) => client.init(options),\r\n\r\n  /**\r\n   * Wrap your Cloudflare Worker 'fetch' handler.\r\n   * Inject trace controller as the 4th argument.\r\n   */\r\n  worker: wrapWorker,\r\n\r\n  /**\r\n   * Wrap a Nitro/H3 event handler.\r\n   * Use this for Nuxt or pure Nitro server routes.\r\n   */\r\n  nitro: wrapH3\r\n};\r\n\r\nexport default Senzor;\r\nexport { Senzor };\r\nexport type { TraceController } from './core/types';\r\n","import { SenzorOptions, TraceData } from './types';\r\n\r\nexport class Transport {\r\n  private queue: TraceData[] = [];\r\n\r\n  constructor(private config: SenzorOptions) { }\r\n\r\n  public add(trace: TraceData) {\r\n    this.queue.push(trace);\r\n  }\r\n\r\n  /**\r\n   * Flushes the queue to the API. \r\n   * Returns a promise that should be passed to ctx.waitUntil()\r\n   */\r\n  public async flush(): Promise<void> {\r\n    if (this.queue.length === 0) return;\r\n\r\n    const batch = [...this.queue];\r\n    this.queue = []; // Clear immediately\r\n\r\n    try {\r\n      const endpoint = this.config.endpoint || 'https://api.senzor.dev/api/ingest/apm';\r\n\r\n      await fetch(endpoint, {\r\n        method: 'POST',\r\n        headers: {\r\n          'Content-Type': 'application/json',\r\n          'x-service-api-key': this.config.apiKey,\r\n        },\r\n        body: JSON.stringify(batch),\r\n        // keepalive is not strictly necessary in workers if awaited/waitUntil'd, but good practice\r\n        keepalive: true,\r\n      });\r\n\r\n      if (this.config.debug) console.log(`[Senzor] Flushed ${batch.length} traces`);\r\n    } catch (err) {\r\n      if (this.config.debug) console.error('[Senzor] Ingestion Error:', err);\r\n    }\r\n  }\r\n}\r\n","import { AsyncLocalStorage } from 'node:async_hooks';\r\nimport { TraceController } from './types';\r\n\r\n// This relies on the 'nodejs_compat' compatibility flag in Cloudflare Workers.\r\nexport const storage = new AsyncLocalStorage<TraceController>();\r\n","import { storage } from '../core/context';\r\n\r\nlet isInstrumented = false;\r\n\r\nexport const enableFetchInstrumentation = () => {\r\n  if (isInstrumented) return;\r\n\r\n  const originalFetch = globalThis.fetch;\r\n\r\n  // Monkey-patch global fetch\r\n  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {\r\n    // 1. Check for active trace context\r\n    const controller = storage.getStore();\r\n\r\n    // If no trace is active, just pass through\r\n    if (!controller) {\r\n      return originalFetch(input, init);\r\n    }\r\n\r\n    // 2. Resolve URL and Method\r\n    let url = '';\r\n    let method = 'GET';\r\n\r\n    if (typeof input === 'string') {\r\n      url = input;\r\n    } else if (input instanceof URL) {\r\n      url = input.toString();\r\n    } else if (input instanceof Request) {\r\n      url = input.url;\r\n      method = input.method;\r\n    }\r\n\r\n    if (init && init.method) {\r\n      method = init.method;\r\n    }\r\n\r\n    // 3. Start Span\r\n    const spanName = `HTTP ${method}`;\r\n    const span = controller.startSpan(spanName, 'http');\r\n\r\n    // 4. Inject Trace Headers (W3C Trace Context)\r\n    // We clone headers to avoid side effects on the input object\r\n    const headers = new Headers(init?.headers || (input instanceof Request ? input.headers : {}));\r\n\r\n    // Generate a span ID for the outgoing request\r\n    const spanId = crypto.randomUUID().replace(/-/g, '').substring(0, 16);\r\n    const traceParent = `00-${controller.traceId}-${spanId}-01`;\r\n    headers.set('traceparent', traceParent);\r\n\r\n    const newInit: RequestInit = {\r\n      ...init,\r\n      headers\r\n    };\r\n\r\n    try {\r\n      const response = await originalFetch(input, newInit);\r\n      span.end({\r\n        url,\r\n        method,\r\n        status: response.status\r\n      }, response.status);\r\n      return response;\r\n    } catch (err: any) {\r\n      span.end({\r\n        url,\r\n        method,\r\n        error: err.message\r\n      }, 500);\r\n      throw err;\r\n    }\r\n  };\r\n\r\n  isInstrumented = true;\r\n};\r\n","import { Transport } from './transport';\r\nimport { SenzorOptions, TraceData, Span, TraceController } from './types';\r\nimport { enableFetchInstrumentation } from '../instrumentation/fetch';\r\n\r\nexport class SenzorClient {\r\n  private transport: Transport | null = null;\r\n  private options: SenzorOptions | null = null;\r\n\r\n  public init(options: SenzorOptions) {\r\n    if (!options.apiKey) {\r\n      console.warn('[Senzor] API Key missing. SDK disabled.');\r\n      return;\r\n    }\r\n    this.options = options;\r\n    this.transport = new Transport(options);\r\n\r\n    // Auto-instrument global fetch\r\n    try {\r\n      enableFetchInstrumentation();\r\n    } catch (e) {\r\n      if (options.debug) console.warn('[Senzor] Failed to instrument fetch:', e);\r\n    }\r\n\r\n    if (options.debug) console.log('[Senzor] Initialized for Serverless');\r\n  }\r\n\r\n  /**\r\n   * Creates a detached trace session.\r\n   */\r\n  public createTrace(data: Partial<TraceData>): { controller: TraceController, end: (status: number, route?: string) => void, flush: () => Promise<void> } {\r\n    if (!this.transport) {\r\n      // Return dummy if not initialized\r\n      return {\r\n        controller: {\r\n          startSpan: () => ({ end: () => { } }),\r\n          captureException: () => { },\r\n          traceId: '00000000000000000000000000000000'\r\n        },\r\n        end: () => { },\r\n        flush: async () => { }\r\n      };\r\n    }\r\n\r\n    const traceId = crypto.randomUUID().replace(/-/g, ''); // 32 hex chars usually\r\n    const startTime = performance.now();\r\n    const spans: Span[] = [];\r\n\r\n    const startSpan = (name: string, type: 'db' | 'http' | 'function' | 'custom' = 'custom') => {\r\n      const spanStartAbs = performance.now();\r\n      const startRel = spanStartAbs - startTime;\r\n      return {\r\n        end: (meta?: any, status?: number) => {\r\n          spans.push({\r\n            name,\r\n            type,\r\n            startTime: startRel, // Relative to trace start\r\n            duration: performance.now() - spanStartAbs,\r\n            status,\r\n            meta\r\n          });\r\n        }\r\n      };\r\n    };\r\n\r\n    const controller: TraceController = {\r\n      traceId,\r\n      startSpan,\r\n      captureException: (err: any) => {\r\n        spans.push({\r\n          name: 'exception',\r\n          type: 'custom',\r\n          startTime: performance.now() - startTime,\r\n          duration: 0,\r\n          status: 500,\r\n          meta: { error: err.message || String(err), stack: err.stack }\r\n        });\r\n      }\r\n    };\r\n\r\n    const end = (status: number, route: string = 'UNKNOWN') => {\r\n      const duration = performance.now() - startTime;\r\n      const payload: TraceData = {\r\n        traceId,\r\n        method: data.method || 'GET',\r\n        route,\r\n        path: data.path || '/',\r\n        status,\r\n        duration,\r\n        ip: data.ip,\r\n        userAgent: data.userAgent,\r\n        timestamp: new Date().toISOString(),\r\n        spans\r\n      };\r\n      this.transport?.add(payload);\r\n    };\r\n\r\n    const flush = async () => {\r\n      await this.transport?.flush();\r\n    };\r\n\r\n    return { controller, end, flush };\r\n  }\r\n\r\n  /**\r\n   * Track a single request trace immediately.\r\n   */\r\n  public track(data: Partial<TraceData> & { status: number, duration: number, route: string }) {\r\n    if (!this.transport) return;\r\n\r\n    const payload: TraceData = {\r\n      traceId: crypto.randomUUID(),\r\n      method: data.method || 'GET',\r\n      route: data.route,\r\n      path: data.path || '/',\r\n      status: data.status,\r\n      duration: data.duration,\r\n      ip: data.ip,\r\n      userAgent: data.userAgent,\r\n      timestamp: new Date().toISOString(),\r\n      spans: data.spans || []\r\n    };\r\n\r\n    this.transport.add(payload);\r\n    this.transport.flush().catch(() => { });\r\n  }\r\n\r\n  // Stubs for legacy Node support\r\n  public startTrace<T>(data: Partial<TraceData>, callback: () => T): T { return callback(); }\r\n  public endTrace(status: number, data?: { route?: string }) { }\r\n}\r\n\r\nexport const client = new SenzorClient();\r\n","/**\r\n * Heuristic URL Normalizer\r\n * Converts raw paths with IDs into generic patterns to prevent high cardinality.\r\n * Example: /users/123/orders/abc-def -> /users/:id/orders/:uuid\r\n */\r\nexport const normalizePath = (path: string): string => {\r\n  if (!path || path === '/') return '/';\r\n\r\n  return path\r\n    // Replace UUIDs (long alphanumeric strings)\r\n    .replace(\r\n      /[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,\r\n      ':uuid'\r\n    )\r\n    // Replace MongoDB ObjectIds (24 hex chars)\r\n    .replace(/[0-9a-fA-F]{24}/g, ':objectId')\r\n    // Replace pure numeric IDs (e.g., /123)\r\n    .replace(/\\/(\\d+)(?=\\/|$)/g, '/:id')\r\n    // Remove query strings\r\n    .split('?')[0];\r\n};\r\n\r\n/**\r\n * Tries to extract route from Framework internals, falls back to heuristic\r\n */\r\nexport const getRoute = (req: any, fallbackPath: string): string => {\r\n  // Express / Connect\r\n  if (req.route && req.route.path) {\r\n    return (req.baseUrl || '') + req.route.path;\r\n  }\r\n\r\n  // H3 / Nitro (Nuxt)\r\n  if (req.context && req.context.matchedRoute) {\r\n    return req.context.matchedRoute.path;\r\n  }\r\n\r\n  // Fastify\r\n  if (req.routerPath) {\r\n    return req.routerPath;\r\n  }\r\n\r\n  // Fallback: Heuristic Normalization\r\n  return normalizePath(fallbackPath);\r\n};","import { client } from '../core/client';\r\nimport { normalizePath } from '../core/normalizer';\r\nimport { TraceController } from '../core/types';\r\nimport { storage } from '../core/context';\r\n\r\ntype WorkerHandler = (request: Request, env: any, ctx: any, trace: TraceController) => Promise<Response>;\r\n\r\nexport const wrapWorker = (handler: WorkerHandler) => {\r\n  return async (request: Request, env: any, ctx: any) => {\r\n    // 2. Extract Request Info\r\n    const url = new URL(request.url);\r\n    const path = url.pathname;\r\n\r\n    // 3. Start Trace\r\n    const session = client.createTrace({\r\n      method: request.method,\r\n      path: path,\r\n      userAgent: request.headers.get('user-agent') || undefined,\r\n      ip: request.headers.get('cf-connecting-ip') || request.headers.get('x-forwarded-for') || undefined\r\n    });\r\n\r\n    // 4. Run Handler within Context (AsyncLocalStorage)\r\n    // This enables the global fetch instrumentation to find the current trace controller\r\n    return storage.run(session.controller, async () => {\r\n      let response: Response;\r\n      let status = 500;\r\n\r\n      try {\r\n        // Inject trace controller as 4th arg for manual usage\r\n        response = await handler(request, env, ctx, session.controller);\r\n        status = response.status;\r\n        return response;\r\n      } catch (err: any) {\r\n        session.controller.captureException(err);\r\n        throw err;\r\n      } finally {\r\n        // 5. End Trace\r\n        session.end(status, normalizePath(path));\r\n\r\n        // 6. Flush (Async WaitUntil)\r\n        if (ctx && typeof ctx.waitUntil === 'function') {\r\n          ctx.waitUntil(session.flush());\r\n        } else {\r\n          await session.flush();\r\n        }\r\n      }\r\n    });\r\n  };\r\n};\r\n","import { client } from '../core/client';\r\nimport { getRoute } from '../core/normalizer';\r\nimport { storage } from '../core/context';\r\n\r\n// Minimal types for H3 to avoid peer-deps\r\ntype EventHandler = (event: any) => any;\r\n\r\nexport const wrapH3 = (handler: EventHandler) => {\r\n  return async (event: any) => {\r\n    const req = event.node.req;\r\n    const path = req.originalUrl || req.url || '/';\r\n\r\n    // 1. Start Trace Session\r\n    const session = client.createTrace({\r\n      method: req.method || 'GET',\r\n      path: path,\r\n      ip: req.headers['x-forwarded-for'] || req.socket?.remoteAddress || event.context?.cf?.connectingIp,\r\n      userAgent: req.headers['user-agent'],\r\n    });\r\n\r\n    // 2. Run Handler within AsyncLocalStorage Context\r\n    // This ensures global fetch() auto-instrumentation works inside Nitro handlers\r\n    return storage.run(session.controller, async () => {\r\n      let response: any;\r\n      let status = 200;\r\n\r\n      try {\r\n        response = await handler(event);\r\n\r\n        // H3/Nitro response status handling\r\n        if (event.node.res.statusCode) status = event.node.res.statusCode;\r\n        if (response && response.statusCode) status = response.statusCode;\r\n\r\n        return response;\r\n      } catch (err: any) {\r\n        status = err.statusCode || err.status || 500;\r\n        session.controller.captureException(err);\r\n        throw err;\r\n      } finally {\r\n        // 3. End Trace\r\n        session.end(status, getRoute(event, path));\r\n\r\n        // 4. Flush Data (Non-blocking for Cloudflare)\r\n        // Nitro exposes Cloudflare context in event.context.cloudflare\r\n        const cfCtx = event.context?.cloudflare?.context || event.context?.cf;\r\n        // Or sometimes directly on event in newer H3 versions if adapter binds it\r\n        const waitUntil = cfCtx?.waitUntil || event.waitUntil;\r\n\r\n        if (waitUntil && typeof waitUntil === 'function') {\r\n          waitUntil(session.flush());\r\n        } else {\r\n          // If not in a worker environment or waitUntil missing, flush async but don't block response significantly\r\n          // (Note: without waitUntil, the runtime might kill the process before flush completes)\r\n          session.flush().catch(() => { });\r\n        }\r\n      }\r\n    });\r\n  };\r\n};\r\n"],"mappings":"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","names":["index_exports","__export","Senzor","index_default","__toCommonJS","Transport","config","trace","batch","endpoint","err","import_node_async_hooks","storage","isInstrumented","enableFetchInstrumentation","originalFetch","input","init","controller","storage","url","method","spanName","span","headers","spanId","traceParent","newInit","response","err","SenzorClient","options","Transport","enableFetchInstrumentation","data","traceId","startTime","spans","name","type","spanStartAbs","startRel","meta","status","err","route","duration","payload","callback","client","normalizePath","path","getRoute","req","fallbackPath","wrapWorker","handler","request","env","ctx","path","session","client","storage","response","status","err","normalizePath","wrapH3","handler","event","req","path","session","client","storage","response","status","err","getRoute","waitUntil","Senzor","options","client","wrapWorker","wrapH3","index_default"]}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+var m=class{constructor(t){this.config=t;this.queue=[]}add(t){this.queue.push(t)}async flush(){if(this.queue.length===0)return;let t=[...this.queue];this.queue=[];try{let e=this.config.endpoint||"https://api.senzor.dev/api/ingest/apm";await fetch(e,{method:"POST",headers:{"Content-Type":"application/json","x-service-api-key":this.config.apiKey},body:JSON.stringify(t),keepalive:!0}),this.config.debug&&console.log(`[Senzor] Flushed ${t.length} traces`)}catch(e){this.config.debug&&console.error("[Senzor] Ingestion Error:",e)}}};import{AsyncLocalStorage as U}from"async_hooks";var f=new U;var T=!1,w=()=>{if(T)return;let r=globalThis.fetch;globalThis.fetch=async(t,e)=>{let n=f.getStore();if(!n)return r(t,e);let o="",a="GET";typeof t=="string"?o=t:t instanceof URL?o=t.toString():t instanceof Request&&(o=t.url,a=t.method),e&&e.method&&(a=e.method);let s=`HTTP ${a}`,c=n.startSpan(s,"http"),l=new Headers(e?.headers||(t instanceof Request?t.headers:{})),i=crypto.randomUUID().replace(/-/g,"").substring(0,16),h=`00-${n.traceId}-${i}-01`;l.set("traceparent",h);let u={...e,headers:l};try{let p=await r(t,u);return c.end({url:o,method:a,status:p.status},p.status),p}catch(p){throw c.end({url:o,method:a,error:p.message},500),p}},T=!0};var g=class{constructor(){this.transport=null;this.options=null}init(t){if(!t.apiKey){console.warn("[Senzor] API Key missing. SDK disabled.");return}this.options=t,this.transport=new m(t);try{w()}catch(e){t.debug&&console.warn("[Senzor] Failed to instrument fetch:",e)}t.debug&&console.log("[Senzor] Initialized for Serverless")}createTrace(t){if(!this.transport)return{controller:{startSpan:()=>({end:()=>{}}),captureException:()=>{},traceId:"00000000000000000000000000000000"},end:()=>{},flush:async()=>{}};let e=crypto.randomUUID().replace(/-/g,""),n=performance.now(),o=[];return{controller:{traceId:e,startSpan:(i,h="custom")=>{let u=performance.now(),p=u-n;return{end:(I,R)=>{o.push({name:i,type:h,startTime:p,duration:performance.now()-u,status:R,meta:I})}}},captureException:i=>{o.push({name:"exception",type:"custom",startTime:performance.now()-n,duration:0,status:500,meta:{error:i.message||String(i),stack:i.stack}})}},end:(i,h="UNKNOWN")=>{let u=performance.now()-n,p={traceId:e,method:t.method||"GET",route:h,path:t.path||"/",status:i,duration:u,ip:t.ip,userAgent:t.userAgent,timestamp:new Date().toISOString(),spans:o};this.transport?.add(p)},flush:async()=>{await this.transport?.flush()}}}track(t){if(!this.transport)return;let e={traceId:crypto.randomUUID(),method:t.method||"GET",route:t.route,path:t.path||"/",status:t.status,duration:t.duration,ip:t.ip,userAgent:t.userAgent,timestamp:new Date().toISOString(),spans:t.spans||[]};this.transport.add(e),this.transport.flush().catch(()=>{})}startTrace(t,e){return e()}endTrace(t,e){}},d=new g;var y=r=>!r||r==="/"?"/":r.replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,":uuid").replace(/[0-9a-fA-F]{24}/g,":objectId").replace(/\/(\d+)(?=\/|$)/g,"/:id").split("?")[0],S=(r,t)=>r.route&&r.route.path?(r.baseUrl||"")+r.route.path:r.context&&r.context.matchedRoute?r.context.matchedRoute.path:r.routerPath?r.routerPath:y(t);var b=r=>async(t,e,n)=>{let a=new URL(t.url).pathname,s=d.createTrace({method:t.method,path:a,userAgent:t.headers.get("user-agent")||void 0,ip:t.headers.get("cf-connecting-ip")||t.headers.get("x-forwarded-for")||void 0});return f.run(s.controller,async()=>{let c,l=500;try{return c=await r(t,e,n,s.controller),l=c.status,c}catch(i){throw s.controller.captureException(i),i}finally{s.end(l,y(a)),n&&typeof n.waitUntil=="function"?n.waitUntil(s.flush()):await s.flush()}})};var x=r=>async t=>{let e=t.node.req,n=e.originalUrl||e.url||"/",o=d.createTrace({method:e.method||"GET",path:n,ip:e.headers["x-forwarded-for"]||e.socket?.remoteAddress||t.context?.cf?.connectingIp,userAgent:e.headers["user-agent"]});return f.run(o.controller,async()=>{let a,s=200;try{return a=await r(t),t.node.res.statusCode&&(s=t.node.res.statusCode),a&&a.statusCode&&(s=a.statusCode),a}catch(c){throw s=c.statusCode||c.status||500,o.controller.captureException(c),c}finally{o.end(s,S(t,n));let l=(t.context?.cloudflare?.context||t.context?.cf)?.waitUntil||t.waitUntil;l&&typeof l=="function"?l(o.flush()):o.flush().catch(()=>{})}})};var z={init:r=>d.init(r),worker:b,nitro:x},M=z;export{z as Senzor,M as default};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/transport.ts","../src/core/context.ts","../src/instrumentation/fetch.ts","../src/core/client.ts","../src/core/normalizer.ts","../src/wrappers/worker.ts","../src/wrappers/h3.ts","../src/index.ts"],"sourcesContent":["import { SenzorOptions, TraceData } from './types';\r\n\r\nexport class Transport {\r\n  private queue: TraceData[] = [];\r\n\r\n  constructor(private config: SenzorOptions) { }\r\n\r\n  public add(trace: TraceData) {\r\n    this.queue.push(trace);\r\n  }\r\n\r\n  /**\r\n   * Flushes the queue to the API. \r\n   * Returns a promise that should be passed to ctx.waitUntil()\r\n   */\r\n  public async flush(): Promise<void> {\r\n    if (this.queue.length === 0) return;\r\n\r\n    const batch = [...this.queue];\r\n    this.queue = []; // Clear immediately\r\n\r\n    try {\r\n      const endpoint = this.config.endpoint || 'https://api.senzor.dev/api/ingest/apm';\r\n\r\n      await fetch(endpoint, {\r\n        method: 'POST',\r\n        headers: {\r\n          'Content-Type': 'application/json',\r\n          'x-service-api-key': this.config.apiKey,\r\n        },\r\n        body: JSON.stringify(batch),\r\n        // keepalive is not strictly necessary in workers if awaited/waitUntil'd, but good practice\r\n        keepalive: true,\r\n      });\r\n\r\n      if (this.config.debug) console.log(`[Senzor] Flushed ${batch.length} traces`);\r\n    } catch (err) {\r\n      if (this.config.debug) console.error('[Senzor] Ingestion Error:', err);\r\n    }\r\n  }\r\n}\r\n","import { AsyncLocalStorage } from 'node:async_hooks';\r\nimport { TraceController } from './types';\r\n\r\n// This relies on the 'nodejs_compat' compatibility flag in Cloudflare Workers.\r\nexport const storage = new AsyncLocalStorage<TraceController>();\r\n","import { storage } from '../core/context';\r\n\r\nlet isInstrumented = false;\r\n\r\nexport const enableFetchInstrumentation = () => {\r\n  if (isInstrumented) return;\r\n\r\n  const originalFetch = globalThis.fetch;\r\n\r\n  // Monkey-patch global fetch\r\n  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {\r\n    // 1. Check for active trace context\r\n    const controller = storage.getStore();\r\n\r\n    // If no trace is active, just pass through\r\n    if (!controller) {\r\n      return originalFetch(input, init);\r\n    }\r\n\r\n    // 2. Resolve URL and Method\r\n    let url = '';\r\n    let method = 'GET';\r\n\r\n    if (typeof input === 'string') {\r\n      url = input;\r\n    } else if (input instanceof URL) {\r\n      url = input.toString();\r\n    } else if (input instanceof Request) {\r\n      url = input.url;\r\n      method = input.method;\r\n    }\r\n\r\n    if (init && init.method) {\r\n      method = init.method;\r\n    }\r\n\r\n    // 3. Start Span\r\n    const spanName = `HTTP ${method}`;\r\n    const span = controller.startSpan(spanName, 'http');\r\n\r\n    // 4. Inject Trace Headers (W3C Trace Context)\r\n    // We clone headers to avoid side effects on the input object\r\n    const headers = new Headers(init?.headers || (input instanceof Request ? input.headers : {}));\r\n\r\n    // Generate a span ID for the outgoing request\r\n    const spanId = crypto.randomUUID().replace(/-/g, '').substring(0, 16);\r\n    const traceParent = `00-${controller.traceId}-${spanId}-01`;\r\n    headers.set('traceparent', traceParent);\r\n\r\n    const newInit: RequestInit = {\r\n      ...init,\r\n      headers\r\n    };\r\n\r\n    try {\r\n      const response = await originalFetch(input, newInit);\r\n      span.end({\r\n        url,\r\n        method,\r\n        status: response.status\r\n      }, response.status);\r\n      return response;\r\n    } catch (err: any) {\r\n      span.end({\r\n        url,\r\n        method,\r\n        error: err.message\r\n      }, 500);\r\n      throw err;\r\n    }\r\n  };\r\n\r\n  isInstrumented = true;\r\n};\r\n","import { Transport } from './transport';\r\nimport { SenzorOptions, TraceData, Span, TraceController } from './types';\r\nimport { enableFetchInstrumentation } from '../instrumentation/fetch';\r\n\r\nexport class SenzorClient {\r\n  private transport: Transport | null = null;\r\n  private options: SenzorOptions | null = null;\r\n\r\n  public init(options: SenzorOptions) {\r\n    if (!options.apiKey) {\r\n      console.warn('[Senzor] API Key missing. SDK disabled.');\r\n      return;\r\n    }\r\n    this.options = options;\r\n    this.transport = new Transport(options);\r\n\r\n    // Auto-instrument global fetch\r\n    try {\r\n      enableFetchInstrumentation();\r\n    } catch (e) {\r\n      if (options.debug) console.warn('[Senzor] Failed to instrument fetch:', e);\r\n    }\r\n\r\n    if (options.debug) console.log('[Senzor] Initialized for Serverless');\r\n  }\r\n\r\n  /**\r\n   * Creates a detached trace session.\r\n   */\r\n  public createTrace(data: Partial<TraceData>): { controller: TraceController, end: (status: number, route?: string) => void, flush: () => Promise<void> } {\r\n    if (!this.transport) {\r\n      // Return dummy if not initialized\r\n      return {\r\n        controller: {\r\n          startSpan: () => ({ end: () => { } }),\r\n          captureException: () => { },\r\n          traceId: '00000000000000000000000000000000'\r\n        },\r\n        end: () => { },\r\n        flush: async () => { }\r\n      };\r\n    }\r\n\r\n    const traceId = crypto.randomUUID().replace(/-/g, ''); // 32 hex chars usually\r\n    const startTime = performance.now();\r\n    const spans: Span[] = [];\r\n\r\n    const startSpan = (name: string, type: 'db' | 'http' | 'function' | 'custom' = 'custom') => {\r\n      const spanStartAbs = performance.now();\r\n      const startRel = spanStartAbs - startTime;\r\n      return {\r\n        end: (meta?: any, status?: number) => {\r\n          spans.push({\r\n            name,\r\n            type,\r\n            startTime: startRel, // Relative to trace start\r\n            duration: performance.now() - spanStartAbs,\r\n            status,\r\n            meta\r\n          });\r\n        }\r\n      };\r\n    };\r\n\r\n    const controller: TraceController = {\r\n      traceId,\r\n      startSpan,\r\n      captureException: (err: any) => {\r\n        spans.push({\r\n          name: 'exception',\r\n          type: 'custom',\r\n          startTime: performance.now() - startTime,\r\n          duration: 0,\r\n          status: 500,\r\n          meta: { error: err.message || String(err), stack: err.stack }\r\n        });\r\n      }\r\n    };\r\n\r\n    const end = (status: number, route: string = 'UNKNOWN') => {\r\n      const duration = performance.now() - startTime;\r\n      const payload: TraceData = {\r\n        traceId,\r\n        method: data.method || 'GET',\r\n        route,\r\n        path: data.path || '/',\r\n        status,\r\n        duration,\r\n        ip: data.ip,\r\n        userAgent: data.userAgent,\r\n        timestamp: new Date().toISOString(),\r\n        spans\r\n      };\r\n      this.transport?.add(payload);\r\n    };\r\n\r\n    const flush = async () => {\r\n      await this.transport?.flush();\r\n    };\r\n\r\n    return { controller, end, flush };\r\n  }\r\n\r\n  /**\r\n   * Track a single request trace immediately.\r\n   */\r\n  public track(data: Partial<TraceData> & { status: number, duration: number, route: string }) {\r\n    if (!this.transport) return;\r\n\r\n    const payload: TraceData = {\r\n      traceId: crypto.randomUUID(),\r\n      method: data.method || 'GET',\r\n      route: data.route,\r\n      path: data.path || '/',\r\n      status: data.status,\r\n      duration: data.duration,\r\n      ip: data.ip,\r\n      userAgent: data.userAgent,\r\n      timestamp: new Date().toISOString(),\r\n      spans: data.spans || []\r\n    };\r\n\r\n    this.transport.add(payload);\r\n    this.transport.flush().catch(() => { });\r\n  }\r\n\r\n  // Stubs for legacy Node support\r\n  public startTrace<T>(data: Partial<TraceData>, callback: () => T): T { return callback(); }\r\n  public endTrace(status: number, data?: { route?: string }) { }\r\n}\r\n\r\nexport const client = new SenzorClient();\r\n","/**\r\n * Heuristic URL Normalizer\r\n * Converts raw paths with IDs into generic patterns to prevent high cardinality.\r\n * Example: /users/123/orders/abc-def -> /users/:id/orders/:uuid\r\n */\r\nexport const normalizePath = (path: string): string => {\r\n  if (!path || path === '/') return '/';\r\n\r\n  return path\r\n    // Replace UUIDs (long alphanumeric strings)\r\n    .replace(\r\n      /[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,\r\n      ':uuid'\r\n    )\r\n    // Replace MongoDB ObjectIds (24 hex chars)\r\n    .replace(/[0-9a-fA-F]{24}/g, ':objectId')\r\n    // Replace pure numeric IDs (e.g., /123)\r\n    .replace(/\\/(\\d+)(?=\\/|$)/g, '/:id')\r\n    // Remove query strings\r\n    .split('?')[0];\r\n};\r\n\r\n/**\r\n * Tries to extract route from Framework internals, falls back to heuristic\r\n */\r\nexport const getRoute = (req: any, fallbackPath: string): string => {\r\n  // Express / Connect\r\n  if (req.route && req.route.path) {\r\n    return (req.baseUrl || '') + req.route.path;\r\n  }\r\n\r\n  // H3 / Nitro (Nuxt)\r\n  if (req.context && req.context.matchedRoute) {\r\n    return req.context.matchedRoute.path;\r\n  }\r\n\r\n  // Fastify\r\n  if (req.routerPath) {\r\n    return req.routerPath;\r\n  }\r\n\r\n  // Fallback: Heuristic Normalization\r\n  return normalizePath(fallbackPath);\r\n};","import { client } from '../core/client';\r\nimport { normalizePath } from '../core/normalizer';\r\nimport { TraceController } from '../core/types';\r\nimport { storage } from '../core/context';\r\n\r\ntype WorkerHandler = (request: Request, env: any, ctx: any, trace: TraceController) => Promise<Response>;\r\n\r\nexport const wrapWorker = (handler: WorkerHandler) => {\r\n  return async (request: Request, env: any, ctx: any) => {\r\n    // 2. Extract Request Info\r\n    const url = new URL(request.url);\r\n    const path = url.pathname;\r\n\r\n    // 3. Start Trace\r\n    const session = client.createTrace({\r\n      method: request.method,\r\n      path: path,\r\n      userAgent: request.headers.get('user-agent') || undefined,\r\n      ip: request.headers.get('cf-connecting-ip') || request.headers.get('x-forwarded-for') || undefined\r\n    });\r\n\r\n    // 4. Run Handler within Context (AsyncLocalStorage)\r\n    // This enables the global fetch instrumentation to find the current trace controller\r\n    return storage.run(session.controller, async () => {\r\n      let response: Response;\r\n      let status = 500;\r\n\r\n      try {\r\n        // Inject trace controller as 4th arg for manual usage\r\n        response = await handler(request, env, ctx, session.controller);\r\n        status = response.status;\r\n        return response;\r\n      } catch (err: any) {\r\n        session.controller.captureException(err);\r\n        throw err;\r\n      } finally {\r\n        // 5. End Trace\r\n        session.end(status, normalizePath(path));\r\n\r\n        // 6. Flush (Async WaitUntil)\r\n        if (ctx && typeof ctx.waitUntil === 'function') {\r\n          ctx.waitUntil(session.flush());\r\n        } else {\r\n          await session.flush();\r\n        }\r\n      }\r\n    });\r\n  };\r\n};\r\n","import { client } from '../core/client';\r\nimport { getRoute } from '../core/normalizer';\r\nimport { storage } from '../core/context';\r\n\r\n// Minimal types for H3 to avoid peer-deps\r\ntype EventHandler = (event: any) => any;\r\n\r\nexport const wrapH3 = (handler: EventHandler) => {\r\n  return async (event: any) => {\r\n    const req = event.node.req;\r\n    const path = req.originalUrl || req.url || '/';\r\n\r\n    // 1. Start Trace Session\r\n    const session = client.createTrace({\r\n      method: req.method || 'GET',\r\n      path: path,\r\n      ip: req.headers['x-forwarded-for'] || req.socket?.remoteAddress || event.context?.cf?.connectingIp,\r\n      userAgent: req.headers['user-agent'],\r\n    });\r\n\r\n    // 2. Run Handler within AsyncLocalStorage Context\r\n    // This ensures global fetch() auto-instrumentation works inside Nitro handlers\r\n    return storage.run(session.controller, async () => {\r\n      let response: any;\r\n      let status = 200;\r\n\r\n      try {\r\n        response = await handler(event);\r\n\r\n        // H3/Nitro response status handling\r\n        if (event.node.res.statusCode) status = event.node.res.statusCode;\r\n        if (response && response.statusCode) status = response.statusCode;\r\n\r\n        return response;\r\n      } catch (err: any) {\r\n        status = err.statusCode || err.status || 500;\r\n        session.controller.captureException(err);\r\n        throw err;\r\n      } finally {\r\n        // 3. End Trace\r\n        session.end(status, getRoute(event, path));\r\n\r\n        // 4. Flush Data (Non-blocking for Cloudflare)\r\n        // Nitro exposes Cloudflare context in event.context.cloudflare\r\n        const cfCtx = event.context?.cloudflare?.context || event.context?.cf;\r\n        // Or sometimes directly on event in newer H3 versions if adapter binds it\r\n        const waitUntil = cfCtx?.waitUntil || event.waitUntil;\r\n\r\n        if (waitUntil && typeof waitUntil === 'function') {\r\n          waitUntil(session.flush());\r\n        } else {\r\n          // If not in a worker environment or waitUntil missing, flush async but don't block response significantly\r\n          // (Note: without waitUntil, the runtime might kill the process before flush completes)\r\n          session.flush().catch(() => { });\r\n        }\r\n      }\r\n    });\r\n  };\r\n};\r\n","import { client } from './core/client';\r\nimport { wrapWorker } from './wrappers/worker';\r\nimport { wrapH3 } from './wrappers/h3';\r\nimport { SenzorOptions } from './core/types';\r\n\r\nconst Senzor = {\r\n  /**\r\n   * Initialize the SDK.\r\n   * Call this in the global scope of your Worker or Plugin.\r\n   */\r\n  init: (options: SenzorOptions) => client.init(options),\r\n\r\n  /**\r\n   * Wrap your Cloudflare Worker 'fetch' handler.\r\n   * Inject trace controller as the 4th argument.\r\n   */\r\n  worker: wrapWorker,\r\n\r\n  /**\r\n   * Wrap a Nitro/H3 event handler.\r\n   * Use this for Nuxt or pure Nitro server routes.\r\n   */\r\n  nitro: wrapH3\r\n};\r\n\r\nexport default Senzor;\r\nexport { Senzor };\r\nexport type { TraceController } from './core/types';\r\n"],"mappings":"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","names":["Transport","config","trace","batch","endpoint","err","AsyncLocalStorage","storage","isInstrumented","enableFetchInstrumentation","originalFetch","input","init","controller","storage","url","method","spanName","span","headers","spanId","traceParent","newInit","response","err","SenzorClient","options","Transport","enableFetchInstrumentation","data","traceId","startTime","spans","name","type","spanStartAbs","startRel","meta","status","err","route","duration","payload","callback","client","normalizePath","path","getRoute","req","fallbackPath","wrapWorker","handler","request","env","ctx","path","session","client","storage","response","status","err","normalizePath","wrapH3","handler","event","req","path","session","client","storage","response","status","err","getRoute","waitUntil","Senzor","options","client","wrapWorker","wrapH3","index_default"]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@senzops/apm-worker",
+  "version": "1.0.0",
+  "description": "Cloudflare Worker / Serverless APM SDK for Senzor",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm,iife --dts --clean --minify",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20240101.0",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "keywords": [
+    "apm",
+    "monitoring",
+    "senzor",
+    "cloudflare",
+    "worker",
+    "serverless",
+    "observability"
+  ],
+  "author": "Senzops",
+  "license": "MIT"
+}

package/src/core/client.ts

@@ -0,0 +1,132 @@
+import { Transport } from './transport';
+import { SenzorOptions, TraceData, Span, TraceController } from './types';
+import { enableFetchInstrumentation } from '../instrumentation/fetch';
+
+export class SenzorClient {
+  private transport: Transport | null = null;
+  private options: SenzorOptions | null = null;
+
+  public init(options: SenzorOptions) {
+    if (!options.apiKey) {
+      console.warn('[Senzor] API Key missing. SDK disabled.');
+      return;
+    }
+    this.options = options;
+    this.transport = new Transport(options);
+
+    // Auto-instrument global fetch
+    try {
+      enableFetchInstrumentation();
+    } catch (e) {
+      if (options.debug) console.warn('[Senzor] Failed to instrument fetch:', e);
+    }
+
+    if (options.debug) console.log('[Senzor] Initialized for Serverless');
+  }
+
+  /**
+   * Creates a detached trace session.
+   */
+  public createTrace(data: Partial<TraceData>): { controller: TraceController, end: (status: number, route?: string) => void, flush: () => Promise<void> } {
+    if (!this.transport) {
+      // Return dummy if not initialized
+      return {
+        controller: {
+          startSpan: () => ({ end: () => { } }),
+          captureException: () => { },
+          traceId: '00000000000000000000000000000000'
+        },
+        end: () => { },
+        flush: async () => { }
+      };
+    }
+
+    const traceId = crypto.randomUUID().replace(/-/g, ''); // 32 hex chars usually
+    const startTime = performance.now();
+    const spans: Span[] = [];
+
+    const startSpan = (name: string, type: 'db' | 'http' | 'function' | 'custom' = 'custom') => {
+      const spanStartAbs = performance.now();
+      const startRel = spanStartAbs - startTime;
+      return {
+        end: (meta?: any, status?: number) => {
+          spans.push({
+            name,
+            type,
+            startTime: startRel, // Relative to trace start
+            duration: performance.now() - spanStartAbs,
+            status,
+            meta
+          });
+        }
+      };
+    };
+
+    const controller: TraceController = {
+      traceId,
+      startSpan,
+      captureException: (err: any) => {
+        spans.push({
+          name: 'exception',
+          type: 'custom',
+          startTime: performance.now() - startTime,
+          duration: 0,
+          status: 500,
+          meta: { error: err.message || String(err), stack: err.stack }
+        });
+      }
+    };
+
+    const end = (status: number, route: string = 'UNKNOWN') => {
+      const duration = performance.now() - startTime;
+      const payload: TraceData = {
+        traceId,
+        method: data.method || 'GET',
+        route,
+        path: data.path || '/',
+        status,
+        duration,
+        ip: data.ip,
+        userAgent: data.userAgent,
+        timestamp: new Date().toISOString(),
+        spans
+      };
+      this.transport?.add(payload);
+    };
+
+    const flush = async () => {
+      await this.transport?.flush();
+    };
+
+    return { controller, end, flush };
+  }
+
+  /**
+   * Track a single request trace immediately.
+   */
+  public track(data: Partial<TraceData> & { status: number, duration: number, route: string }) {
+    if (!this.transport) return;
+
+    const payload: TraceData = {
+      traceId: crypto.randomUUID(),
+      method: data.method || 'GET',
+      route: data.route,
+      path: data.path || '/',
+      status: data.status,
+      duration: data.duration,
+      ip: data.ip,
+      userAgent: data.userAgent,
+      timestamp: new Date().toISOString(),
+      spans: data.spans || []
+    };
+
+    this.transport.add(payload);
+    this.transport.flush().catch(() => { });
+  }
+
+  // Stubs for legacy Node support
+  public startTrace<T>(data: Partial<TraceData>, callback: () => T): T { return callback(); }
+  public endTrace(status: number, data?: { route?: string }) { }
+}
+
+export const client = new SenzorClient();

package/src/core/context.ts

@@ -0,0 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { TraceController } from './types';
+
+// This relies on the 'nodejs_compat' compatibility flag in Cloudflare Workers.
+export const storage = new AsyncLocalStorage<TraceController>();

package/src/core/normalizer.ts

@@ -0,0 +1,44 @@
+/**
+ * Heuristic URL Normalizer
+ * Converts raw paths with IDs into generic patterns to prevent high cardinality.
+ * Example: /users/123/orders/abc-def -> /users/:id/orders/:uuid
+ */
+export const normalizePath = (path: string): string => {
+  if (!path || path === '/') return '/';
+
+  return path
+    // Replace UUIDs (long alphanumeric strings)
+    .replace(
+      /[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g,
+      ':uuid'
+    )
+    // Replace MongoDB ObjectIds (24 hex chars)
+    .replace(/[0-9a-fA-F]{24}/g, ':objectId')
+    // Replace pure numeric IDs (e.g., /123)
+    .replace(/\/(\d+)(?=\/|$)/g, '/:id')
+    // Remove query strings
+    .split('?')[0];
+};
+
+/**
+ * Tries to extract route from Framework internals, falls back to heuristic
+ */
+export const getRoute = (req: any, fallbackPath: string): string => {
+  // Express / Connect
+  if (req.route && req.route.path) {
+    return (req.baseUrl || '') + req.route.path;
+  }
+
+  // H3 / Nitro (Nuxt)
+  if (req.context && req.context.matchedRoute) {
+    return req.context.matchedRoute.path;
+  }
+
+  // Fastify
+  if (req.routerPath) {
+    return req.routerPath;
+  }
+
+  // Fallback: Heuristic Normalization
+  return normalizePath(fallbackPath);
+};

package/src/core/transport.ts

@@ -0,0 +1,41 @@
+import { SenzorOptions, TraceData } from './types';
+
+export class Transport {
+  private queue: TraceData[] = [];
+
+  constructor(private config: SenzorOptions) { }
+
+  public add(trace: TraceData) {
+    this.queue.push(trace);
+  }
+
+  /**
+   * Flushes the queue to the API. 
+   * Returns a promise that should be passed to ctx.waitUntil()
+   */
+  public async flush(): Promise<void> {
+    if (this.queue.length === 0) return;
+
+    const batch = [...this.queue];
+    this.queue = []; // Clear immediately
+
+    try {
+      const endpoint = this.config.endpoint || 'https://api.senzor.dev/api/ingest/apm';
+
+      await fetch(endpoint, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-service-api-key': this.config.apiKey,
+        },
+        body: JSON.stringify(batch),
+        // keepalive is not strictly necessary in workers if awaited/waitUntil'd, but good practice
+        keepalive: true,
+      });
+
+      if (this.config.debug) console.log(`[Senzor] Flushed ${batch.length} traces`);
+    } catch (err) {
+      if (this.config.debug) console.error('[Senzor] Ingestion Error:', err);
+    }
+  }
+}

package/src/core/types.ts

@@ -0,0 +1,44 @@
+export interface SenzorOptions {
+  apiKey: string;
+  endpoint?: string;
+  debug?: boolean;
+}
+
+export interface Span {
+  name: string;
+  type: 'db' | 'http' | 'function' | 'custom';
+  startTime: number; // Relative to trace start
+  duration: number;
+  status?: number;
+  meta?: Record<string, any>;
+}
+
+export interface TraceData {
+  traceId: string;
+  method: string;
+  route: string; // Normalized
+  path: string;  // Raw
+  status: number;
+  duration: number;
+  ip?: string;
+  userAgent?: string;
+  timestamp: string;
+  spans: Span[];
+}
+
+export interface TraceController {
+  /**
+   * Starts a new span.
+   */
+  startSpan(name: string, type?: 'db' | 'http' | 'function' | 'custom'): { end: (meta?: any, status?: number) => void };
+
+  /**
+   * Adds an error to the trace.
+   */
+  captureException(error: Error | any): void;
+
+  /**
+   * The trace ID for the current session
+   */
+  readonly traceId: string;
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+import { client } from './core/client';
+import { wrapWorker } from './wrappers/worker';
+import { wrapH3 } from './wrappers/h3';
+import { SenzorOptions } from './core/types';
+
+const Senzor = {
+  /**
+   * Initialize the SDK.
+   * Call this in the global scope of your Worker or Plugin.
+   */
+  init: (options: SenzorOptions) => client.init(options),
+
+  /**
+   * Wrap your Cloudflare Worker 'fetch' handler.
+   * Inject trace controller as the 4th argument.
+   */
+  worker: wrapWorker,
+
+  /**
+   * Wrap a Nitro/H3 event handler.
+   * Use this for Nuxt or pure Nitro server routes.
+   */
+  nitro: wrapH3
+};
+
+export default Senzor;
+export { Senzor };
+export type { TraceController } from './core/types';

package/src/instrumentation/fetch.ts

@@ -0,0 +1,74 @@
+import { storage } from '../core/context';
+
+let isInstrumented = false;
+
+export const enableFetchInstrumentation = () => {
+  if (isInstrumented) return;
+
+  const originalFetch = globalThis.fetch;
+
+  // Monkey-patch global fetch
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    // 1. Check for active trace context
+    const controller = storage.getStore();
+
+    // If no trace is active, just pass through
+    if (!controller) {
+      return originalFetch(input, init);
+    }
+
+    // 2. Resolve URL and Method
+    let url = '';
+    let method = 'GET';
+
+    if (typeof input === 'string') {
+      url = input;
+    } else if (input instanceof URL) {
+      url = input.toString();
+    } else if (input instanceof Request) {
+      url = input.url;
+      method = input.method;
+    }
+
+    if (init && init.method) {
+      method = init.method;
+    }
+
+    // 3. Start Span
+    const spanName = `HTTP ${method}`;
+    const span = controller.startSpan(spanName, 'http');
+
+    // 4. Inject Trace Headers (W3C Trace Context)
+    // We clone headers to avoid side effects on the input object
+    const headers = new Headers(init?.headers || (input instanceof Request ? input.headers : {}));
+
+    // Generate a span ID for the outgoing request
+    const spanId = crypto.randomUUID().replace(/-/g, '').substring(0, 16);
+    const traceParent = `00-${controller.traceId}-${spanId}-01`;
+    headers.set('traceparent', traceParent);
+
+    const newInit: RequestInit = {
+      ...init,
+      headers
+    };
+
+    try {
+      const response = await originalFetch(input, newInit);
+      span.end({
+        url,
+        method,
+        status: response.status
+      }, response.status);
+      return response;
+    } catch (err: any) {
+      span.end({
+        url,
+        method,
+        error: err.message
+      }, 500);
+      throw err;
+    }
+  };
+
+  isInstrumented = true;
+};

package/src/wrappers/h3.ts

@@ -0,0 +1,59 @@
+import { client } from '../core/client';
+import { getRoute } from '../core/normalizer';
+import { storage } from '../core/context';
+
+// Minimal types for H3 to avoid peer-deps
+type EventHandler = (event: any) => any;
+
+export const wrapH3 = (handler: EventHandler) => {
+  return async (event: any) => {
+    const req = event.node.req;
+    const path = req.originalUrl || req.url || '/';
+
+    // 1. Start Trace Session
+    const session = client.createTrace({
+      method: req.method || 'GET',
+      path: path,
+      ip: req.headers['x-forwarded-for'] || req.socket?.remoteAddress || event.context?.cf?.connectingIp,
+      userAgent: req.headers['user-agent'],
+    });
+
+    // 2. Run Handler within AsyncLocalStorage Context
+    // This ensures global fetch() auto-instrumentation works inside Nitro handlers
+    return storage.run(session.controller, async () => {
+      let response: any;
+      let status = 200;
+
+      try {
+        response = await handler(event);
+
+        // H3/Nitro response status handling
+        if (event.node.res.statusCode) status = event.node.res.statusCode;
+        if (response && response.statusCode) status = response.statusCode;
+
+        return response;
+      } catch (err: any) {
+        status = err.statusCode || err.status || 500;
+        session.controller.captureException(err);
+        throw err;
+      } finally {
+        // 3. End Trace
+        session.end(status, getRoute(event, path));
+
+        // 4. Flush Data (Non-blocking for Cloudflare)
+        // Nitro exposes Cloudflare context in event.context.cloudflare
+        const cfCtx = event.context?.cloudflare?.context || event.context?.cf;
+        // Or sometimes directly on event in newer H3 versions if adapter binds it
+        const waitUntil = cfCtx?.waitUntil || event.waitUntil;
+
+        if (waitUntil && typeof waitUntil === 'function') {
+          waitUntil(session.flush());
+        } else {
+          // If not in a worker environment or waitUntil missing, flush async but don't block response significantly
+          // (Note: without waitUntil, the runtime might kill the process before flush completes)
+          session.flush().catch(() => { });
+        }
+      }
+    });
+  };
+};

package/src/wrappers/worker.ts

@@ -0,0 +1,49 @@
+import { client } from '../core/client';
+import { normalizePath } from '../core/normalizer';
+import { TraceController } from '../core/types';
+import { storage } from '../core/context';
+
+type WorkerHandler = (request: Request, env: any, ctx: any, trace: TraceController) => Promise<Response>;
+
+export const wrapWorker = (handler: WorkerHandler) => {
+  return async (request: Request, env: any, ctx: any) => {
+    // 2. Extract Request Info
+    const url = new URL(request.url);
+    const path = url.pathname;
+
+    // 3. Start Trace
+    const session = client.createTrace({
+      method: request.method,
+      path: path,
+      userAgent: request.headers.get('user-agent') || undefined,
+      ip: request.headers.get('cf-connecting-ip') || request.headers.get('x-forwarded-for') || undefined
+    });
+
+    // 4. Run Handler within Context (AsyncLocalStorage)
+    // This enables the global fetch instrumentation to find the current trace controller
+    return storage.run(session.controller, async () => {
+      let response: Response;
+      let status = 500;
+
+      try {
+        // Inject trace controller as 4th arg for manual usage
+        response = await handler(request, env, ctx, session.controller);
+        status = response.status;
+        return response;
+      } catch (err: any) {
+        session.controller.captureException(err);
+        throw err;
+      } finally {
+        // 5. End Trace
+        session.end(status, normalizePath(path));
+
+        // 6. Flush (Async WaitUntil)
+        if (ctx && typeof ctx.waitUntil === 'function') {
+          ctx.waitUntil(session.flush());
+        } else {
+          await session.flush();
+        }
+      }
+    });
+  };
+};

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  dts: true,
+  clean: true,
+  minify: true,
+  sourcemap: true,
+  splitting: false,
+});