@lunora/runtime 1.0.0-alpha.25 → 1.0.0-alpha.26

package/dist/index.d.mts

@@ -682,6 +682,16 @@ interface ObservabilityEvent {
   ok: boolean;
   /** Shard key for single-shard calls; absent for fan-outs. */
   shardKey?: string;
+  /**
+  * W3C trace context for this dispatch, generated once at dispatch entry (32-
+  * and 16-hex). A sink (e.g. `otlpSink`) reuses these for the dispatch's span
+  * instead of minting fresh ids, and the runtime propagates them to the shard
+  * as a `traceparent` so a container the handler calls can stitch its spans
+  * under the same trace. Absent on paths that don't originate a trace (a sink
+  * falls back to random ids).
+  */
+  spanId?: string;
+  traceId?: string;
 }
 /** Severity of a {@link LogEvent}, mirroring the usual console levels. */
 type LogLevel = "debug" | "error" | "info" | "log" | "warn";

package/dist/index.d.ts

@@ -682,6 +682,16 @@ interface ObservabilityEvent {
   ok: boolean;
   /** Shard key for single-shard calls; absent for fan-outs. */
   shardKey?: string;
+  /**
+  * W3C trace context for this dispatch, generated once at dispatch entry (32-
+  * and 16-hex). A sink (e.g. `otlpSink`) reuses these for the dispatch's span
+  * instead of minting fresh ids, and the runtime propagates them to the shard
+  * as a `traceparent` so a container the handler calls can stitch its spans
+  * under the same trace. Absent on paths that don't originate a trace (a sink
+  * falls back to random ids).
+  */
+  spanId?: string;
+  traceId?: string;
 }
 /** Severity of a {@link LogEvent}, mirroring the usual console levels. */
 type LogLevel = "debug" | "error" | "info" | "log" | "warn";

package/dist/index.mjs

@@ -1,10 +1,10 @@
 export { toAirbyteMessages, toFivetranResponse } from './packem_shared/toAirbyteMessages-DrHdplb4.mjs';
-export { composeWorker, createLunoraHandler, createWorker, defineRpcEnvelope, resolveLunoraOptions, withFrameworkWorker } from './packem_shared/composeWorker-CxwkPZUl.mjs';
+export { composeWorker, createLunoraHandler, createWorker, defineRpcEnvelope, resolveLunoraOptions, withFrameworkWorker } from './packem_shared/composeWorker-BMxMYwKq.mjs';
 export { createCrossShardRelationCapabilities } from './packem_shared/createCrossShardRelationCapabilities-CbcWjkAn.mjs';
 export { DEFAULT_REGISTRY_CACHE_TTL_MS, SHARD_REGISTRY_DO_NAME, createDynamicShardRegistry } from './packem_shared/DEFAULT_REGISTRY_CACHE_TTL_MS-B3pA7aXp.mjs';
 export { LunoraError, toErrorResponse } from './packem_shared/LunoraError-Bpb9EFJ3.mjs';
 export { emitLogEvent, emitRpcEvent } from './packem_shared/emitLogEvent-pEdtqAK8.mjs';
-export { analyticsEngineSink, combineSinks, consoleSink, otlpSink, sentrySink, webhookSink } from './packem_shared/analyticsEngineSink-BpJlA7e9.mjs';
+export { analyticsEngineSink, combineSinks, consoleSink, otlpSink, sentrySink, webhookSink } from './packem_shared/analyticsEngineSink-F-5ZAdUA.mjs';
 export { createQueryCoordinator, createStaticShardRegistry, mergeStrategyForAggregate } from './packem_shared/createQueryCoordinator-DNCJzOZE.mjs';
 export { applyJurisdiction, resolveShard } from './packem_shared/applyJurisdiction-BkZtTkct.mjs';
 export { decorateResponse, enforceOrigin, handleCorsPreflight, resolveSecurity } from './packem_shared/decorateResponse-DRWQFNhF.mjs';

package/dist/packem_shared/{analyticsEngineSink-BpJlA7e9.mjs → analyticsEngineSink-F-5ZAdUA.mjs}

@@ -1,81 +1,4 @@
-const OTLP_SEVERITY = {
-  debug: 5,
-  // DEBUG
-  error: 17,
-  // ERROR
-  info: 9,
-  // INFO
-  log: 9,
-  // INFO
-  warn: 13
-  // WARN
-};
-const otlpUnixNano = (ms) => `${String(Math.round(ms))}000000`;
-const otlpRandomHex = (bytes) => {
-  const buffer = new Uint8Array(bytes);
-  crypto.getRandomValues(buffer);
-  let hex = "";
-  for (const byte of buffer) {
-    hex += byte.toString(16).padStart(2, "0");
-  }
-  return hex;
-};
-const encodeAttribute = (key, value) => {
-  if (typeof value === "boolean") {
-    return { key, value: { boolValue: value } };
-  }
-  if (typeof value === "number") {
-    if (!Number.isFinite(value)) {
-      return { key, value: { stringValue: String(value) } };
-    }
-    return Number.isSafeInteger(value) ? { key, value: { intValue: String(value) } } : { key, value: { doubleValue: value } };
-  }
-  return { key, value: { stringValue: value } };
-};
-const mergeHeaders = (defaults, overrides, token) => {
-  const merged = {};
-  const seen = /* @__PURE__ */ new Map();
-  const put = (name, value) => {
-    const lower = name.toLowerCase();
-    const existing = seen.get(lower);
-    if (existing === void 0) {
-      seen.set(lower, name);
-      merged[name] = value;
-    } else {
-      merged[existing] = value;
-    }
-  };
-  for (const [name, value] of Object.entries(defaults)) {
-    put(name, value);
-  }
-  for (const [name, value] of Object.entries(overrides ?? {})) {
-    put(name, value);
-  }
-  if (token !== void 0 && token.length > 0) {
-    put("authorization", `Bearer ${token}`);
-  }
-  return merged;
-};
-const wrapResourceSpans = (span, scopeName, serviceName) => {
-  return {
-    resourceSpans: [
-      {
-        resource: { attributes: [encodeAttribute("service.name", serviceName)] },
-        scopeSpans: [{ scope: { name: scopeName }, spans: [span] }]
-      }
-    ]
-  };
-};
-const wrapResourceLogs = (logRecord, scopeName, serviceName) => {
-  return {
-    resourceLogs: [
-      {
-        resource: { attributes: [encodeAttribute("service.name", serviceName)] },
-        scopeLogs: [{ logRecords: [logRecord], scope: { name: scopeName } }]
-      }
-    ]
-  };
-};
+import { m as mergeHeaders, o as otlpRandomHex, w as wrapResourceSpans, a as wrapResourceLogs, e as encodeAttribute, O as OTLP_SEVERITY, c as otlpUnixNano } from './otlp-D_YzGXu1.mjs';
 
 const shouldSkip = (event, onlyErrors) => onlyErrors === true && event.ok;
 const otlpTraceBody = (event, serviceName, endMs) => {
@@ -99,11 +22,13 @@ const otlpTraceBody = (event, serviceName, endMs) => {
     // SPAN_KIND_SERVER — a dispatched RPC is server-side request handling.
     kind: 2,
     name: event.functionPath,
-    spanId: otlpRandomHex(8),
+    // Reuse the dispatch's trace context when the runtime set it (so this span
+    // shares the id it propagated as `traceparent`); else mint fresh ids.
+    spanId: event.spanId ?? otlpRandomHex(8),
     startTimeUnixNano: otlpUnixNano(endMs - event.durationMs),
     // STATUS_CODE_OK (1) / STATUS_CODE_ERROR (2).
     status: event.ok ? { code: 1 } : { code: 2, message: event.error?.message ?? "" },
-    traceId: otlpRandomHex(16)
+    traceId: event.traceId ?? otlpRandomHex(16)
   };
   return wrapResourceSpans(span, "@lunora/runtime", serviceName);
 };

package/dist/packem_shared/{composeWorker-CxwkPZUl.mjs → composeWorker-BMxMYwKq.mjs}

@@ -1,5 +1,6 @@
 import { isLunoraError, toErrorBody } from '@lunora/errors';
 import { NOOP_EXECUTION_CONTEXT } from './NOOP_EXECUTION_CONTEXT-CCTu0Bf1.mjs';
+import { o as otlpRandomHex, b as buildTraceparent } from './otlp-D_YzGXu1.mjs';
 import { LunoraError, toErrorResponse } from './LunoraError-Bpb9EFJ3.mjs';
 import { wrapResolverWithContract } from './composeIdentityResolvers-XGjO7V1J.mjs';
 export { composeIdentityResolvers, routeIdentityResolvers } from './composeIdentityResolvers-XGjO7V1J.mjs';
@@ -2605,9 +2606,11 @@ const createWorker = (options) => {
   const dispatchSingleShard = async (functionPath, args, shardKey, forwardedHeaders, sinkContext) => {
     const rpcStartedAt = Date.now();
     const { observability } = options;
+    const traceId = otlpRandomHex(16);
+    const spanId = otlpRandomHex(8);
     const forwarded = new Request(`https://shard.internal/rpc`, {
       body: JSON.stringify({ args, functionPath }),
-      headers: forwardedHeaders,
+      headers: { ...forwardedHeaders, traceparent: buildTraceparent(traceId, spanId) },
       method: "POST"
     });
     try {
@@ -2619,13 +2622,15 @@ const createWorker = (options) => {
           functionPath,
           ok: response.ok,
           shardKey,
+          spanId,
+          traceId,
           ...response.ok ? {} : { error: { code: "SHARD_ERROR", message: `shard returned ${String(response.status)}`, status: response.status } }
         },
         sinkContext
       );
       return response;
     } catch (error) {
-      emitRpcEvent(observability, buildErrorEvent(functionPath, Date.now() - rpcStartedAt, error, { shardKey }), sinkContext);
+      emitRpcEvent(observability, { ...buildErrorEvent(functionPath, Date.now() - rpcStartedAt, error, { shardKey }), spanId, traceId }, sinkContext);
       throw error;
     }
   };

package/dist/packem_shared/otlp-D_YzGXu1.mjs

@@ -0,0 +1,81 @@
+const OTLP_SEVERITY = {
+  debug: 5,
+  // DEBUG
+  error: 17,
+  // ERROR
+  info: 9,
+  // INFO
+  log: 9,
+  // INFO
+  warn: 13
+  // WARN
+};
+const otlpUnixNano = (ms) => `${String(Math.round(ms))}000000`;
+const otlpRandomHex = (bytes) => {
+  const buffer = new Uint8Array(bytes);
+  crypto.getRandomValues(buffer);
+  let hex = "";
+  for (const byte of buffer) {
+    hex += byte.toString(16).padStart(2, "0");
+  }
+  return hex;
+};
+const buildTraceparent = (traceId, spanId) => `00-${traceId}-${spanId}-01`;
+const encodeAttribute = (key, value) => {
+  if (typeof value === "boolean") {
+    return { key, value: { boolValue: value } };
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      return { key, value: { stringValue: String(value) } };
+    }
+    return Number.isSafeInteger(value) ? { key, value: { intValue: String(value) } } : { key, value: { doubleValue: value } };
+  }
+  return { key, value: { stringValue: value } };
+};
+const mergeHeaders = (defaults, overrides, token) => {
+  const merged = {};
+  const seen = /* @__PURE__ */ new Map();
+  const put = (name, value) => {
+    const lower = name.toLowerCase();
+    const existing = seen.get(lower);
+    if (existing === void 0) {
+      seen.set(lower, name);
+      merged[name] = value;
+    } else {
+      merged[existing] = value;
+    }
+  };
+  for (const [name, value] of Object.entries(defaults)) {
+    put(name, value);
+  }
+  for (const [name, value] of Object.entries(overrides ?? {})) {
+    put(name, value);
+  }
+  if (token !== void 0 && token.length > 0) {
+    put("authorization", `Bearer ${token}`);
+  }
+  return merged;
+};
+const wrapResourceSpans = (span, scopeName, serviceName) => {
+  return {
+    resourceSpans: [
+      {
+        resource: { attributes: [encodeAttribute("service.name", serviceName)] },
+        scopeSpans: [{ scope: { name: scopeName }, spans: [span] }]
+      }
+    ]
+  };
+};
+const wrapResourceLogs = (logRecord, scopeName, serviceName) => {
+  return {
+    resourceLogs: [
+      {
+        resource: { attributes: [encodeAttribute("service.name", serviceName)] },
+        scopeLogs: [{ logRecords: [logRecord], scope: { name: scopeName } }]
+      }
+    ]
+  };
+};
+
+export { OTLP_SEVERITY as O, wrapResourceLogs as a, buildTraceparent as b, otlpUnixNano as c, encodeAttribute as e, mergeHeaders as m, otlpRandomHex as o, wrapResourceSpans as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/runtime",
-  "version": "1.0.0-alpha.25",
+  "version": "1.0.0-alpha.26",
   "description": "Lunora Worker runtime: the RPC router, shard resolver, and query coordinator",
   "keywords": [
     "cloudflare",