chore: types from otel packages

Author: RihanArfan

package.json

@@ -93,6 +93,8 @@
     "@hiogawa/vite-plugin-fullstack": "^0.0.11",
     "@netlify/edge-functions": "^3.0.8",
     "@netlify/functions": "^5.3.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/otlp-transformer": "^0.208.0",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-inject": "^5.0.5",

pnpm-lock.yaml

@@ -35,6 +35,7 @@ allowBuilds:
   sharp: false
   vue-demi: false
   workerd: false
+  protobufjs: false
 
 peerDependencyRules:
   allowedVersions:

pnpm-workspace.yaml

@@ -1,4 +1,9 @@
 import { definePlugin } from "nitro";
+import type { SpanContext } from "@opentelemetry/api";
+import type {
+  IExportTraceServiceRequest,
+  ISpan,
+} from "@opentelemetry/otlp-transformer/build/src/trace/internal-types.js";
 
 /**
  * Exports Nitro tracing-channel events to the Vercel runtime as OpenTelemetry
@@ -15,8 +20,24 @@ const SPAN_KIND_INTERNAL = 1;
 const STATUS_CODE_ERROR = 2;
 const SCOPE_NAME = "@nitro/vercel-tracing";
 
-function getTelemetry(): any {
-  return (globalThis as any)[REQUEST_CONTEXT_SYMBOL]?.get?.()?.telemetry;
+/**
+ * The Vercel runtime telemetry sink, exposed per-request via the global
+ * `@vercel/request-context` reader. `reportSpans` is fire-and-forget; the
+ * runtime correlates spans to the request by `rootSpanContext.traceId`.
+ */
+interface VercelTelemetry {
+  reportSpans(data: IExportTraceServiceRequest): void;
+  rootSpanContext?: SpanContext;
+}
+
+interface RequestContextReader {
+  get?(): { telemetry?: VercelTelemetry } | undefined;
+}
+
+function getTelemetry(): VercelTelemetry | undefined {
+  return (globalThis as Record<symbol, RequestContextReader | undefined>)[
+    REQUEST_CONTEXT_SYMBOL
+  ]?.get?.()?.telemetry;
 }
 
 /**
@@ -26,7 +47,7 @@ function getTelemetry(): any {
  * OTLP field is present even when empty (omitting e.g. `events` or `attributes`
  * makes the runtime drop the whole batch).
  */
-class Span {
+class Span implements ISpan {
   traceId: string;
   spanId: string;
   // Parent on the platform root so spans appear as flat siblings.