@ereo/trace 0.1.28

package/dist/client.js

@@ -0,0 +1,193 @@
+// @bun
+// src/client.ts
+function randomHex(len) {
+  let s = "";
+  while (s.length < len) {
+    s += Math.random().toString(16).slice(2);
+  }
+  return s.slice(0, len);
+}
+function browserSpanId() {
+  return randomHex(16);
+}
+
+class ClientSpan {
+  id;
+  traceId;
+  parentId;
+  name;
+  layer;
+  startTime;
+  endTime = 0;
+  attributes = {};
+  status = "ok";
+  events = [];
+  children = [];
+  ended = false;
+  constructor(traceId, parentId, name, layer) {
+    this.id = browserSpanId();
+    this.traceId = traceId;
+    this.parentId = parentId;
+    this.name = name;
+    this.layer = layer;
+    this.startTime = performance.now();
+  }
+  setAttribute(key, value) {
+    if (!this.ended)
+      this.attributes[key] = value;
+  }
+  event(name, attrs) {
+    if (!this.ended)
+      this.events.push({ name, time: performance.now(), attributes: attrs });
+  }
+  end() {
+    if (this.ended)
+      return;
+    this.ended = true;
+    this.endTime = performance.now();
+  }
+  error(err) {
+    if (this.ended)
+      return;
+    this.status = "error";
+    this.attributes["error.message"] = err instanceof Error ? err.message : String(err);
+  }
+  addChild(childId) {
+    this.children.push(childId);
+  }
+  toData() {
+    return {
+      id: this.id,
+      traceId: this.traceId,
+      parentId: this.parentId,
+      name: this.name,
+      layer: this.layer,
+      status: this.status,
+      startTime: this.startTime,
+      endTime: this.endTime || performance.now(),
+      duration: (this.endTime || performance.now()) - this.startTime,
+      attributes: { ...this.attributes },
+      events: [...this.events],
+      children: [...this.children]
+    };
+  }
+}
+
+class ClientTracer {
+  ws = null;
+  pendingSpans = [];
+  currentTraceId = null;
+  connected = false;
+  init() {
+    if (typeof window === "undefined")
+      return;
+    this.currentTraceId = window.__EREO_TRACE_ID__ || null;
+    this.connect();
+    this.interceptFetch();
+  }
+  connect() {
+    if (typeof WebSocket === "undefined")
+      return;
+    const protocol = location.protocol === "https:" ? "wss:" : "ws:";
+    const url = `${protocol}//${location.host}/__ereo/trace-ws`;
+    try {
+      this.ws = new WebSocket(url);
+      this.ws.onopen = () => {
+        this.connected = true;
+        this.flushPending();
+      };
+      this.ws.onclose = () => {
+        this.connected = false;
+        this.ws = null;
+      };
+      this.ws.onerror = () => {};
+    } catch {}
+  }
+  interceptFetch() {
+    if (typeof window === "undefined")
+      return;
+    const originalFetch = window.fetch.bind(window);
+    const self = this;
+    const patchedFetch = function(input, init) {
+      if (self.currentTraceId) {
+        const headers = new Headers(init?.headers);
+        if (!headers.has("X-Ereo-Trace-Id")) {
+          headers.set("X-Ereo-Trace-Id", self.currentTraceId);
+        }
+        init = { ...init, headers };
+      }
+      return originalFetch(input, init).then((response) => {
+        const newTraceId = response.headers.get("X-Ereo-Trace-Id");
+        if (newTraceId) {
+          self.currentTraceId = newTraceId;
+        }
+        return response;
+      });
+    };
+    Object.assign(patchedFetch, originalFetch);
+    window.fetch = patchedFetch;
+  }
+  startSpan(name, layer, parentId) {
+    const traceId = this.currentTraceId || browserSpanId() + browserSpanId();
+    return new ClientSpan(traceId, parentId || null, name, layer);
+  }
+  submitSpan(span) {
+    const data = span.toData();
+    this.pendingSpans.push(data);
+    if (this.connected) {
+      this.flushPending();
+    }
+  }
+  setTraceId(traceId) {
+    this.currentTraceId = traceId;
+  }
+  getTraceId() {
+    return this.currentTraceId;
+  }
+  flushPending() {
+    if (!this.ws || !this.connected || this.pendingSpans.length === 0)
+      return;
+    const traceGroups = new Map;
+    for (const span of this.pendingSpans) {
+      const group = traceGroups.get(span.traceId) || [];
+      group.push(span);
+      traceGroups.set(span.traceId, group);
+    }
+    for (const [traceId, spans] of traceGroups) {
+      try {
+        this.ws.send(JSON.stringify({
+          type: "client:spans",
+          traceId,
+          spans
+        }));
+      } catch {
+        return;
+      }
+    }
+    this.pendingSpans = [];
+  }
+  destroy() {
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.connected = false;
+    this.pendingSpans = [];
+  }
+}
+var clientTracer = null;
+function getClientTracer() {
+  if (!clientTracer) {
+    clientTracer = new ClientTracer;
+  }
+  return clientTracer;
+}
+function initClientTracing() {
+  getClientTracer().init();
+}
+export {
+  initClientTracing,
+  getClientTracer,
+  ClientTracer,
+  ClientSpan
+};

package/dist/collector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @ereo/trace - Collector
+ *
+ * Merges server + client spans into unified traces.
+ * Client spans arrive via WebSocket with their traceId,
+ * and are stitched into the corresponding server trace.
+ */
+import type { SpanData, TraceData, TraceId, Tracer } from './types';
+/**
+ * Collector that merges client-side spans into server traces.
+ */
+export declare class TraceCollector {
+    private tracer;
+    constructor(tracer: Tracer);
+    /**
+     * Merge client spans into an existing server trace.
+     * Called when client spans arrive via WebSocket.
+     */
+    mergeClientSpans(traceId: TraceId, clientSpans: SpanData[]): void;
+    /**
+     * Get a unified trace with both server and client spans.
+     */
+    getUnifiedTrace(traceId: TraceId): TraceData | undefined;
+}
+/**
+ * Create a collector instance.
+ */
+export declare function createCollector(tracer: Tracer): TraceCollector;
+//# sourceMappingURL=collector.d.ts.map

package/dist/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpE;;GAEG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAElC;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI;IAIjE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;CAGzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAE9D"}

package/dist/context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @ereo/trace - Context Integration
+ *
+ * Attach/retrieve tracer from RequestContext store.
+ * Uses the existing ctx.set()/ctx.get() mechanism — no changes to @ereo/core needed.
+ */
+import type { AppContext } from '@ereo/core';
+import type { Tracer, Span } from './types';
+/** Attach a tracer to the request context */
+export declare function setTracer(context: AppContext, tracer: Tracer): void;
+/** Retrieve the tracer from the request context */
+export declare function getTracer(context: AppContext): Tracer | undefined;
+/** Store the active root span on the context (for child span creation by instrumentors) */
+export declare function setActiveSpan(context: AppContext, span: Span): void;
+/** Retrieve the active root span from the context */
+export declare function getActiveSpan(context: AppContext): Span | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAK5C,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAEnE;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAEnE"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @ereo/trace - Full-stack developer observability for EreoJS
+ *
+ * Provides unified tracing across all 11 framework layers:
+ * request, routing, data, forms, signals, rpc, database, auth, islands, build, errors.
+ *
+ * Usage:
+ *   import { createTracer, traceMiddleware, createCLIReporter } from '@ereo/trace';
+ *   const tracer = createTracer();
+ *   server.use(traceMiddleware(tracer));
+ *   createCLIReporter(tracer);
+ */
+export { createTracer, TracerImpl } from './tracer';
+export { SpanImpl, generateSpanId, generateTraceId } from './span';
+export { RingBuffer } from './ring-buffer';
+export { setTracer, getTracer, setActiveSpan, getActiveSpan } from './context';
+export { noopTracer, noopSpan, NoopTracer } from './noop';
+export { createCLIReporter, type CLIReporterOptions } from './cli-reporter';
+export { createTraceWebSocket, createTracesAPIHandler, serializeTrace, deserializeTrace, type SerializedTraceData, type SerializedTraceStreamEvent, } from './transport';
+export { createCollector, TraceCollector } from './collector';
+export { createViewerHandler, exportTracesHTML, generateViewerHTML } from './viewer';
+export { traceMiddleware, type TraceMiddlewareOptions, traceRouteMatch, recordRouteMatch, traceLoader, recordLoaderMetrics, traceCacheOperation, type LoaderTraceInfo, traceFormSubmit, recordFormValidation, recordSignalUpdate, recordSignalBatch, traceRPCCall, recordRPCValidation, tracedAdapter, traceQuery, type TracedAdapterMethods, traceAuthCheck, traceHydration, recordHydration, traceBuildStage, traceBuild, traceError, withErrorCapture, type ErrorPhase, } from './instrumentors';
+export type { TraceId, SpanId, SpanLayer, SpanStatus, SpanEvent, SpanData, TraceOrigin, TraceMetadata, TraceData, Span, Tracer, TraceStreamEvent, TracerConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGrF,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,eAAe,EACpB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,KAAK,oBAAoB,EACzB,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,EACb,SAAS,EACT,IAAI,EACJ,MAAM,EACN,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC"}