@lunora/runtime 1.0.0-alpha.24 → 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";
@@ -2778,6 +2788,60 @@ interface AnalyticsEngineSinkOptions extends OnlyErrorsOption {
 * only error events (defaults to all events).
 */
 declare const analyticsEngineSink: (options: AnalyticsEngineSinkOptions) => ObservabilitySink;
+/** Options for {@link otlpSink}. */
+interface OtlpSinkOptions extends OnlyErrorsOption {
+  /**
+  * The OTLP-over-HTTP collector base endpoint (e.g.
+  * `https://collector.example.com`). Following the OTel base-endpoint
+  * convention, the sink POSTs spans to `${endpoint}/v1/traces` and log
+  * records to `${endpoint}/v1/logs`; a trailing slash is tolerated.
+  */
+  endpoint: string;
+  /**
+  * Extra headers merged onto every OTLP POST — typically an `Authorization`
+  * bearer plus the `x-lunora-deployment` / `x-lunora-org` correlation headers
+  * the platform injects at deploy. `Content-Type: application/json` is set by
+  * default and may be overridden here.
+  */
+  headers?: Record<string, string>;
+  /**
+  * Value of the `service.name` resource attribute on every exported span and
+  * log — the logical service the telemetry belongs to. Defaults to `lunora`.
+  */
+  serviceName?: string;
+  /**
+  * Convenience bearer token: when set, an `Authorization: Bearer` header
+  * carrying it is added to every POST (overriding any authorization in
+  * `headers`). Mirrors the container exporter so the platform can inject the
+  * same `LUNORA_OTLP_TOKEN` into both. Leave unset for an unauthenticated collector.
+  */
+  token?: string;
+}
+/**
+* A fire-and-forget sink that exports telemetry over OTLP-over-HTTP (JSON).
+*
+* This is the single, standard wire contract both the worker and (via the
+* container exporter helper) container processes use, so telemetry from either
+* side lands in the same collector. Each RPC dispatch becomes one OTLP **span**
+* (`${endpoint}/v1/traces`) named after its `functionPath`, with start/end
+* derived from `durationMs` and status OK/ERROR; each `ctx.log.*` line becomes
+* one OTLP **log record** (`${endpoint}/v1/logs`). Trace/span ids are random
+* per span — real trace correlation (worker→container `traceparent`) is a later
+* phase.
+*
+* Like {@link webhookSink}, each export is its own `fetch`, registered with the
+* request's `context.waitUntil` when present so it survives isolate teardown,
+* and every rejection is swallowed so a flaky collector never surfaces to the
+* caller.
+*
+* Privacy: spans carry `error.type`/`error.message` and logs carry the rendered
+* `message`, which may include user input. Point `endpoint` only at a collector
+* you trust, and gate PII upstream if that is a concern.
+* @param options Sink options: `endpoint` is the collector base URL, `headers`
+* are merged onto every POST (auth + correlation), `serviceName` sets the
+* resource `service.name`, and `onlyErrors` exports error spans only.
+*/
+declare const otlpSink: (options: OtlpSinkOptions) => ObservabilitySink;
 /**
 * Combine several sinks into one that fans each event out to all of them.
 *
@@ -2787,4 +2851,4 @@ declare const analyticsEngineSink: (options: AnalyticsEngineSinkOptions) => Obse
 */
 declare const combineSinks: (...sinks: ObservabilitySink[]) => ObservabilitySink;
 declare const VERSION: string;
-export { type AdminTableResolver, type AirbyteMessage, type AnalyticsEngineDataPointLike, type AnalyticsEngineDatasetLike, type AnalyticsEngineSinkOptions, type AuthAdmin, type AuthCapabilities, type AuthConfigInfo, type AuthImpersonation, type AuthIntrospector, type AuthPage, type AuthSession, type AuthUser, type AuthUserFieldSpec, type BackupManifest, type BackupStore, type ComposeIdentityResolversErrorMode, type ComposeIdentityResolversOptions, type ConnectorChange, type ConnectorSyncPage, type CorsOptions, type CronHandler, type CronJobDispatch, type CronJobInfo, type CrossShardCounter, type CrossShardReader, type CrossShardRelationCapabilities, type CrossShardRelationOptions, type CsrfOptions, DEFAULT_REGISTRY_CACHE_TTL_MS, type DurableObjectJurisdiction, type DynamicShardRegistry, type DynamicShardRegistryOptions, type ExecutionContextLike, type ExportFanOutRequest, type ExportFanOutResult, type FanOutRequest, type FanOutResult, type FanOutSpec, type FivetranResponse, type FrameworkHostHandler, type FrameworkWorkerOptions, type FrameworkWorkerOptionsInput, type FunctionDescriptor, type FunctionRegistryEntry, type FunctionRegistryLike, type GlobalExportFunction as GlobalExportFn, type GlobalImportFunction as GlobalImportFn, type GlobalIntrospector, type GlobalTableInfo as GlobalTableInfoMeta, type GlobalTablePage as GlobalTablePageMeta, type HttpActionContext, type HttpActionLike, type HttpRouterLike, type IdentityContractLike, type IdentityResolver, type IdentityValidation, type ImportFanOutRequest, type ImportFanOutResult, type KvIntrospector, type KvKeyEntry, type KvKeyListResult, type KvNamespaceSummary, type KvValueResult, type ListAuthUsersOptions, type LogEvent, type LogLevel, LunoraError, type LunoraErrorBody, type LunoraHandlerOptions, type LunoraWorker, type MergeStrategy, type MigrationFanOutRequest, type MigrationFanOutResult, NOOP_EXECUTION_CONTEXT, type ObservabilityEvent, type ObservabilitySink, type ObservabilitySinkContext, type QueryCoordinator, type QueryCoordinatorOptions, type RankFanOutRequest, type RankFanOutResult, type RankPageFanOutRequest, type RankPageFanOutResult, type ResolvedSecurity, type ResolvedShard, type Route, type RpcContext, type RpcEnvelope, SHARD_REGISTRY_DO_NAME, type ScheduledControllerLike, type SecurityHeadersOptions, type SecurityOptions, type SentrySinkOptions, type ShardError, type ShardExportOutcome, type ShardImportOutcome, type ShardMigrationOutcome, type ShardNamespaceLike, type ShardRankOutcome, type ShardRankPageOutcome, type ShardRegistry, type ShardTrafficEntry, type ShardTrafficFanOutRequest, type ShardTrafficFanOutResult, type ShardingInfo, type StorageListFunction as StorageListFn, type StorageObject, VERSION, type VectorIndexSummary, type VectorIntrospector, type VectorQueryMatch, type WebhookSinkOptions, type WorkerOptions, analyticsEngineSink, applyJurisdiction, combineSinks, composeIdentityResolvers, composeWorker, consoleSink, createCrossShardRelationCapabilities, createDynamicShardRegistry, createLunoraHandler, createQueryCoordinator, createStaticShardRegistry, createWorker, decorateResponse, defineRpcEnvelope, emitLogEvent, emitRpcEvent, enforceOrigin, handleCorsPreflight, mergeStrategyForAggregate, resolveLunoraOptions, resolveSecurity, resolveShard, routeIdentityResolvers, sentrySink, toAirbyteMessages, toErrorResponse, toFivetranResponse, webhookSink, withFrameworkWorker };
+export { type AdminTableResolver, type AirbyteMessage, type AnalyticsEngineDataPointLike, type AnalyticsEngineDatasetLike, type AnalyticsEngineSinkOptions, type AuthAdmin, type AuthCapabilities, type AuthConfigInfo, type AuthImpersonation, type AuthIntrospector, type AuthPage, type AuthSession, type AuthUser, type AuthUserFieldSpec, type BackupManifest, type BackupStore, type ComposeIdentityResolversErrorMode, type ComposeIdentityResolversOptions, type ConnectorChange, type ConnectorSyncPage, type CorsOptions, type CronHandler, type CronJobDispatch, type CronJobInfo, type CrossShardCounter, type CrossShardReader, type CrossShardRelationCapabilities, type CrossShardRelationOptions, type CsrfOptions, DEFAULT_REGISTRY_CACHE_TTL_MS, type DurableObjectJurisdiction, type DynamicShardRegistry, type DynamicShardRegistryOptions, type ExecutionContextLike, type ExportFanOutRequest, type ExportFanOutResult, type FanOutRequest, type FanOutResult, type FanOutSpec, type FivetranResponse, type FrameworkHostHandler, type FrameworkWorkerOptions, type FrameworkWorkerOptionsInput, type FunctionDescriptor, type FunctionRegistryEntry, type FunctionRegistryLike, type GlobalExportFunction as GlobalExportFn, type GlobalImportFunction as GlobalImportFn, type GlobalIntrospector, type GlobalTableInfo as GlobalTableInfoMeta, type GlobalTablePage as GlobalTablePageMeta, type HttpActionContext, type HttpActionLike, type HttpRouterLike, type IdentityContractLike, type IdentityResolver, type IdentityValidation, type ImportFanOutRequest, type ImportFanOutResult, type KvIntrospector, type KvKeyEntry, type KvKeyListResult, type KvNamespaceSummary, type KvValueResult, type ListAuthUsersOptions, type LogEvent, type LogLevel, LunoraError, type LunoraErrorBody, type LunoraHandlerOptions, type LunoraWorker, type MergeStrategy, type MigrationFanOutRequest, type MigrationFanOutResult, NOOP_EXECUTION_CONTEXT, type ObservabilityEvent, type ObservabilitySink, type ObservabilitySinkContext, type OtlpSinkOptions, type QueryCoordinator, type QueryCoordinatorOptions, type RankFanOutRequest, type RankFanOutResult, type RankPageFanOutRequest, type RankPageFanOutResult, type ResolvedSecurity, type ResolvedShard, type Route, type RpcContext, type RpcEnvelope, SHARD_REGISTRY_DO_NAME, type ScheduledControllerLike, type SecurityHeadersOptions, type SecurityOptions, type SentrySinkOptions, type ShardError, type ShardExportOutcome, type ShardImportOutcome, type ShardMigrationOutcome, type ShardNamespaceLike, type ShardRankOutcome, type ShardRankPageOutcome, type ShardRegistry, type ShardTrafficEntry, type ShardTrafficFanOutRequest, type ShardTrafficFanOutResult, type ShardingInfo, type StorageListFunction as StorageListFn, type StorageObject, VERSION, type VectorIndexSummary, type VectorIntrospector, type VectorQueryMatch, type WebhookSinkOptions, type WorkerOptions, analyticsEngineSink, applyJurisdiction, combineSinks, composeIdentityResolvers, composeWorker, consoleSink, createCrossShardRelationCapabilities, createDynamicShardRegistry, createLunoraHandler, createQueryCoordinator, createStaticShardRegistry, createWorker, decorateResponse, defineRpcEnvelope, emitLogEvent, emitRpcEvent, enforceOrigin, handleCorsPreflight, mergeStrategyForAggregate, otlpSink, resolveLunoraOptions, resolveSecurity, resolveShard, routeIdentityResolvers, sentrySink, toAirbyteMessages, toErrorResponse, toFivetranResponse, webhookSink, withFrameworkWorker };

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";
@@ -2778,6 +2788,60 @@ interface AnalyticsEngineSinkOptions extends OnlyErrorsOption {
 * only error events (defaults to all events).
 */
 declare const analyticsEngineSink: (options: AnalyticsEngineSinkOptions) => ObservabilitySink;
+/** Options for {@link otlpSink}. */
+interface OtlpSinkOptions extends OnlyErrorsOption {
+  /**
+  * The OTLP-over-HTTP collector base endpoint (e.g.
+  * `https://collector.example.com`). Following the OTel base-endpoint
+  * convention, the sink POSTs spans to `${endpoint}/v1/traces` and log
+  * records to `${endpoint}/v1/logs`; a trailing slash is tolerated.
+  */
+  endpoint: string;
+  /**
+  * Extra headers merged onto every OTLP POST — typically an `Authorization`
+  * bearer plus the `x-lunora-deployment` / `x-lunora-org` correlation headers
+  * the platform injects at deploy. `Content-Type: application/json` is set by
+  * default and may be overridden here.
+  */
+  headers?: Record<string, string>;
+  /**
+  * Value of the `service.name` resource attribute on every exported span and
+  * log — the logical service the telemetry belongs to. Defaults to `lunora`.
+  */
+  serviceName?: string;
+  /**
+  * Convenience bearer token: when set, an `Authorization: Bearer` header
+  * carrying it is added to every POST (overriding any authorization in
+  * `headers`). Mirrors the container exporter so the platform can inject the
+  * same `LUNORA_OTLP_TOKEN` into both. Leave unset for an unauthenticated collector.
+  */
+  token?: string;
+}
+/**
+* A fire-and-forget sink that exports telemetry over OTLP-over-HTTP (JSON).
+*
+* This is the single, standard wire contract both the worker and (via the
+* container exporter helper) container processes use, so telemetry from either
+* side lands in the same collector. Each RPC dispatch becomes one OTLP **span**
+* (`${endpoint}/v1/traces`) named after its `functionPath`, with start/end
+* derived from `durationMs` and status OK/ERROR; each `ctx.log.*` line becomes
+* one OTLP **log record** (`${endpoint}/v1/logs`). Trace/span ids are random
+* per span — real trace correlation (worker→container `traceparent`) is a later
+* phase.
+*
+* Like {@link webhookSink}, each export is its own `fetch`, registered with the
+* request's `context.waitUntil` when present so it survives isolate teardown,
+* and every rejection is swallowed so a flaky collector never surfaces to the
+* caller.
+*
+* Privacy: spans carry `error.type`/`error.message` and logs carry the rendered
+* `message`, which may include user input. Point `endpoint` only at a collector
+* you trust, and gate PII upstream if that is a concern.
+* @param options Sink options: `endpoint` is the collector base URL, `headers`
+* are merged onto every POST (auth + correlation), `serviceName` sets the
+* resource `service.name`, and `onlyErrors` exports error spans only.
+*/
+declare const otlpSink: (options: OtlpSinkOptions) => ObservabilitySink;
 /**
 * Combine several sinks into one that fans each event out to all of them.
 *
@@ -2787,4 +2851,4 @@ declare const analyticsEngineSink: (options: AnalyticsEngineSinkOptions) => Obse
 */
 declare const combineSinks: (...sinks: ObservabilitySink[]) => ObservabilitySink;
 declare const VERSION: string;
-export { type AdminTableResolver, type AirbyteMessage, type AnalyticsEngineDataPointLike, type AnalyticsEngineDatasetLike, type AnalyticsEngineSinkOptions, type AuthAdmin, type AuthCapabilities, type AuthConfigInfo, type AuthImpersonation, type AuthIntrospector, type AuthPage, type AuthSession, type AuthUser, type AuthUserFieldSpec, type BackupManifest, type BackupStore, type ComposeIdentityResolversErrorMode, type ComposeIdentityResolversOptions, type ConnectorChange, type ConnectorSyncPage, type CorsOptions, type CronHandler, type CronJobDispatch, type CronJobInfo, type CrossShardCounter, type CrossShardReader, type CrossShardRelationCapabilities, type CrossShardRelationOptions, type CsrfOptions, DEFAULT_REGISTRY_CACHE_TTL_MS, type DurableObjectJurisdiction, type DynamicShardRegistry, type DynamicShardRegistryOptions, type ExecutionContextLike, type ExportFanOutRequest, type ExportFanOutResult, type FanOutRequest, type FanOutResult, type FanOutSpec, type FivetranResponse, type FrameworkHostHandler, type FrameworkWorkerOptions, type FrameworkWorkerOptionsInput, type FunctionDescriptor, type FunctionRegistryEntry, type FunctionRegistryLike, type GlobalExportFunction as GlobalExportFn, type GlobalImportFunction as GlobalImportFn, type GlobalIntrospector, type GlobalTableInfo as GlobalTableInfoMeta, type GlobalTablePage as GlobalTablePageMeta, type HttpActionContext, type HttpActionLike, type HttpRouterLike, type IdentityContractLike, type IdentityResolver, type IdentityValidation, type ImportFanOutRequest, type ImportFanOutResult, type KvIntrospector, type KvKeyEntry, type KvKeyListResult, type KvNamespaceSummary, type KvValueResult, type ListAuthUsersOptions, type LogEvent, type LogLevel, LunoraError, type LunoraErrorBody, type LunoraHandlerOptions, type LunoraWorker, type MergeStrategy, type MigrationFanOutRequest, type MigrationFanOutResult, NOOP_EXECUTION_CONTEXT, type ObservabilityEvent, type ObservabilitySink, type ObservabilitySinkContext, type QueryCoordinator, type QueryCoordinatorOptions, type RankFanOutRequest, type RankFanOutResult, type RankPageFanOutRequest, type RankPageFanOutResult, type ResolvedSecurity, type ResolvedShard, type Route, type RpcContext, type RpcEnvelope, SHARD_REGISTRY_DO_NAME, type ScheduledControllerLike, type SecurityHeadersOptions, type SecurityOptions, type SentrySinkOptions, type ShardError, type ShardExportOutcome, type ShardImportOutcome, type ShardMigrationOutcome, type ShardNamespaceLike, type ShardRankOutcome, type ShardRankPageOutcome, type ShardRegistry, type ShardTrafficEntry, type ShardTrafficFanOutRequest, type ShardTrafficFanOutResult, type ShardingInfo, type StorageListFunction as StorageListFn, type StorageObject, VERSION, type VectorIndexSummary, type VectorIntrospector, type VectorQueryMatch, type WebhookSinkOptions, type WorkerOptions, analyticsEngineSink, applyJurisdiction, combineSinks, composeIdentityResolvers, composeWorker, consoleSink, createCrossShardRelationCapabilities, createDynamicShardRegistry, createLunoraHandler, createQueryCoordinator, createStaticShardRegistry, createWorker, decorateResponse, defineRpcEnvelope, emitLogEvent, emitRpcEvent, enforceOrigin, handleCorsPreflight, mergeStrategyForAggregate, resolveLunoraOptions, resolveSecurity, resolveShard, routeIdentityResolvers, sentrySink, toAirbyteMessages, toErrorResponse, toFivetranResponse, webhookSink, withFrameworkWorker };
+export { type AdminTableResolver, type AirbyteMessage, type AnalyticsEngineDataPointLike, type AnalyticsEngineDatasetLike, type AnalyticsEngineSinkOptions, type AuthAdmin, type AuthCapabilities, type AuthConfigInfo, type AuthImpersonation, type AuthIntrospector, type AuthPage, type AuthSession, type AuthUser, type AuthUserFieldSpec, type BackupManifest, type BackupStore, type ComposeIdentityResolversErrorMode, type ComposeIdentityResolversOptions, type ConnectorChange, type ConnectorSyncPage, type CorsOptions, type CronHandler, type CronJobDispatch, type CronJobInfo, type CrossShardCounter, type CrossShardReader, type CrossShardRelationCapabilities, type CrossShardRelationOptions, type CsrfOptions, DEFAULT_REGISTRY_CACHE_TTL_MS, type DurableObjectJurisdiction, type DynamicShardRegistry, type DynamicShardRegistryOptions, type ExecutionContextLike, type ExportFanOutRequest, type ExportFanOutResult, type FanOutRequest, type FanOutResult, type FanOutSpec, type FivetranResponse, type FrameworkHostHandler, type FrameworkWorkerOptions, type FrameworkWorkerOptionsInput, type FunctionDescriptor, type FunctionRegistryEntry, type FunctionRegistryLike, type GlobalExportFunction as GlobalExportFn, type GlobalImportFunction as GlobalImportFn, type GlobalIntrospector, type GlobalTableInfo as GlobalTableInfoMeta, type GlobalTablePage as GlobalTablePageMeta, type HttpActionContext, type HttpActionLike, type HttpRouterLike, type IdentityContractLike, type IdentityResolver, type IdentityValidation, type ImportFanOutRequest, type ImportFanOutResult, type KvIntrospector, type KvKeyEntry, type KvKeyListResult, type KvNamespaceSummary, type KvValueResult, type ListAuthUsersOptions, type LogEvent, type LogLevel, LunoraError, type LunoraErrorBody, type LunoraHandlerOptions, type LunoraWorker, type MergeStrategy, type MigrationFanOutRequest, type MigrationFanOutResult, NOOP_EXECUTION_CONTEXT, type ObservabilityEvent, type ObservabilitySink, type ObservabilitySinkContext, type OtlpSinkOptions, type QueryCoordinator, type QueryCoordinatorOptions, type RankFanOutRequest, type RankFanOutResult, type RankPageFanOutRequest, type RankPageFanOutResult, type ResolvedSecurity, type ResolvedShard, type Route, type RpcContext, type RpcEnvelope, SHARD_REGISTRY_DO_NAME, type ScheduledControllerLike, type SecurityHeadersOptions, type SecurityOptions, type SentrySinkOptions, type ShardError, type ShardExportOutcome, type ShardImportOutcome, type ShardMigrationOutcome, type ShardNamespaceLike, type ShardRankOutcome, type ShardRankPageOutcome, type ShardRegistry, type ShardTrafficEntry, type ShardTrafficFanOutRequest, type ShardTrafficFanOutResult, type ShardingInfo, type StorageListFunction as StorageListFn, type StorageObject, VERSION, type VectorIndexSummary, type VectorIntrospector, type VectorQueryMatch, type WebhookSinkOptions, type WorkerOptions, analyticsEngineSink, applyJurisdiction, combineSinks, composeIdentityResolvers, composeWorker, consoleSink, createCrossShardRelationCapabilities, createDynamicShardRegistry, createLunoraHandler, createQueryCoordinator, createStaticShardRegistry, createWorker, decorateResponse, defineRpcEnvelope, emitLogEvent, emitRpcEvent, enforceOrigin, handleCorsPreflight, mergeStrategyForAggregate, otlpSink, resolveLunoraOptions, resolveSecurity, resolveShard, routeIdentityResolvers, sentrySink, toAirbyteMessages, toErrorResponse, toFivetranResponse, webhookSink, withFrameworkWorker };

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, sentrySink, webhookSink } from './packem_shared/analyticsEngineSink-DqEvrQs0.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-F-5ZAdUA.mjs

@@ -0,0 +1,200 @@
+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) => {
+  const attributes = [encodeAttribute("lunora.function_path", event.functionPath), encodeAttribute("lunora.ok", event.ok)];
+  if (event.shardKey !== void 0) {
+    attributes.push(encodeAttribute("lunora.shard_key", event.shardKey));
+  }
+  if (event.error) {
+    attributes.push(encodeAttribute("error.type", event.error.code), encodeAttribute("lunora.error_status", event.error.status));
+  }
+  if (event.fanOut) {
+    attributes.push(
+      encodeAttribute("lunora.fanout.table", event.fanOut.table),
+      encodeAttribute("lunora.fanout.shards", event.fanOut.shards),
+      encodeAttribute("lunora.fanout.failed", event.fanOut.failed)
+    );
+  }
+  const span = {
+    attributes,
+    endTimeUnixNano: otlpUnixNano(endMs),
+    // SPAN_KIND_SERVER — a dispatched RPC is server-side request handling.
+    kind: 2,
+    name: event.functionPath,
+    // 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: event.traceId ?? otlpRandomHex(16)
+  };
+  return wrapResourceSpans(span, "@lunora/runtime", serviceName);
+};
+const otlpLogBody = (event, serviceName) => {
+  const attributes = [encodeAttribute("lunora.function_path", event.functionPath)];
+  if (event.shardKey !== void 0) {
+    attributes.push(encodeAttribute("lunora.shard_key", event.shardKey));
+  }
+  if (event.userId !== void 0) {
+    attributes.push(encodeAttribute("lunora.user_id", event.userId));
+  }
+  const logRecord = {
+    attributes,
+    body: { stringValue: event.message },
+    severityNumber: OTLP_SEVERITY[event.level],
+    severityText: event.level.toUpperCase(),
+    timeUnixNano: otlpUnixNano(event.ts)
+  };
+  return wrapResourceLogs(logRecord, "@lunora/runtime", serviceName);
+};
+const otlpPost = (url, body, headers, context) => {
+  try {
+    const sent = fetch(url, { body: JSON.stringify(body), headers, method: "POST" }).catch(() => {
+    });
+    if (context?.waitUntil) {
+      context.waitUntil(sent);
+    }
+  } catch {
+  }
+};
+const consoleSink = (options = {}) => {
+  const { onlyErrors } = options;
+  return {
+    onLog: (event) => {
+      if (event.level === "error") {
+        console.error("[lunora:log]", event.functionPath, event.message);
+      } else {
+        console.log("[lunora:log]", event.functionPath, event.message);
+      }
+    },
+    onRpc: (event) => {
+      if (shouldSkip(event, onlyErrors)) {
+        return;
+      }
+      if (event.ok) {
+        console.log("[lunora:rpc]", event);
+      } else {
+        console.error("[lunora:rpc]", event);
+      }
+    }
+  };
+};
+const webhookSink = (options) => {
+  const { headers, onlyErrors, transform, url } = options;
+  const mergedHeaders = mergeHeaders({ "content-type": "application/json" }, headers);
+  return {
+    onRpc: (event, context) => {
+      if (shouldSkip(event, onlyErrors)) {
+        return;
+      }
+      try {
+        let payload = event;
+        if (transform) {
+          try {
+            payload = transform(event);
+          } catch {
+            return;
+          }
+        }
+        if (payload === null || payload === void 0) {
+          return;
+        }
+        const sent = fetch(url, {
+          body: JSON.stringify(payload),
+          headers: mergedHeaders,
+          method: "POST"
+        }).catch(() => {
+        });
+        if (context?.waitUntil) {
+          context.waitUntil(sent);
+        }
+      } catch {
+      }
+    }
+  };
+};
+const sentrySink = (options) => {
+  const { capture } = options;
+  const onlyErrors = options.onlyErrors ?? true;
+  return {
+    onRpc: (event) => {
+      if (shouldSkip(event, onlyErrors)) {
+        return;
+      }
+      try {
+        capture(event);
+      } catch {
+      }
+    }
+  };
+};
+const analyticsEngineSink = (options) => {
+  const { dataset, onlyErrors } = options;
+  return {
+    onRpc: (event) => {
+      if (shouldSkip(event, onlyErrors)) {
+        return;
+      }
+      try {
+        dataset.writeDataPoint({
+          blobs: [event.functionPath, event.ok ? "ok" : "error", event.shardKey ?? "", event.error?.code ?? "", event.fanOut?.table ?? ""],
+          doubles: [event.durationMs, event.ok ? 0 : 1, event.fanOut?.shards ?? 0, event.fanOut?.failed ?? 0],
+          indexes: [event.functionPath]
+        });
+      } catch {
+      }
+    }
+  };
+};
+const otlpSink = (options) => {
+  const { endpoint, headers, onlyErrors, token } = options;
+  const serviceName = options.serviceName ?? "lunora";
+  let base = endpoint;
+  while (base.endsWith("/")) {
+    base = base.slice(0, -1);
+  }
+  const tracesUrl = `${base}/v1/traces`;
+  const logsUrl = `${base}/v1/logs`;
+  const mergedHeaders = mergeHeaders({ "content-type": "application/json" }, headers, token);
+  return {
+    onLog: (event, context) => {
+      otlpPost(logsUrl, otlpLogBody(event, serviceName), mergedHeaders, context);
+    },
+    onRpc: (event, context) => {
+      if (shouldSkip(event, onlyErrors)) {
+        return;
+      }
+      otlpPost(tracesUrl, otlpTraceBody(event, serviceName, Date.now()), mergedHeaders, context);
+    }
+  };
+};
+const combineSinks = (...sinks) => {
+  return {
+    onLog: (event, context) => {
+      for (const sink of sinks) {
+        if (!sink.onLog) {
+          continue;
+        }
+        try {
+          sink.onLog(event, context);
+        } catch {
+        }
+      }
+    },
+    onRpc: (event, context) => {
+      for (const sink of sinks) {
+        if (!sink.onRpc) {
+          continue;
+        }
+        try {
+          sink.onRpc(event, context);
+        } catch {
+        }
+      }
+    }
+  };
+};
+
+export { analyticsEngineSink, combineSinks, consoleSink, otlpSink, sentrySink, webhookSink };

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.24",
+  "version": "1.0.0-alpha.26",
   "description": "Lunora Worker runtime: the RPC router, shard resolver, and query coordinator",
   "keywords": [
     "cloudflare",

package/dist/packem_shared/analyticsEngineSink-DqEvrQs0.mjs

@@ -1,141 +0,0 @@
-const shouldSkip = (event, onlyErrors) => onlyErrors === true && event.ok;
-const mergeHeaders = (defaults, overrides) => {
-  if (!overrides) {
-    return { ...defaults };
-  }
-  const merged = {};
-  const seen = /* @__PURE__ */ new Map();
-  for (const [name, value] of Object.entries(defaults)) {
-    const lower = name.toLowerCase();
-    seen.set(lower, name);
-    merged[name] = value;
-  }
-  for (const [name, value] of Object.entries(overrides)) {
-    const lower = name.toLowerCase();
-    const existing = seen.get(lower);
-    if (existing === void 0) {
-      seen.set(lower, name);
-      merged[name] = value;
-    } else {
-      merged[existing] = value;
-    }
-  }
-  return merged;
-};
-const consoleSink = (options = {}) => {
-  const { onlyErrors } = options;
-  return {
-    onLog: (event) => {
-      if (event.level === "error") {
-        console.error("[lunora:log]", event.functionPath, event.message);
-      } else {
-        console.log("[lunora:log]", event.functionPath, event.message);
-      }
-    },
-    onRpc: (event) => {
-      if (shouldSkip(event, onlyErrors)) {
-        return;
-      }
-      if (event.ok) {
-        console.log("[lunora:rpc]", event);
-      } else {
-        console.error("[lunora:rpc]", event);
-      }
-    }
-  };
-};
-const webhookSink = (options) => {
-  const { headers, onlyErrors, transform, url } = options;
-  const mergedHeaders = mergeHeaders({ "content-type": "application/json" }, headers);
-  return {
-    onRpc: (event, context) => {
-      if (shouldSkip(event, onlyErrors)) {
-        return;
-      }
-      try {
-        let payload = event;
-        if (transform) {
-          try {
-            payload = transform(event);
-          } catch {
-            return;
-          }
-        }
-        if (payload === null || payload === void 0) {
-          return;
-        }
-        const sent = fetch(url, {
-          body: JSON.stringify(payload),
-          headers: mergedHeaders,
-          method: "POST"
-        }).catch(() => {
-        });
-        if (context?.waitUntil) {
-          context.waitUntil(sent);
-        }
-      } catch {
-      }
-    }
-  };
-};
-const sentrySink = (options) => {
-  const { capture } = options;
-  const onlyErrors = options.onlyErrors ?? true;
-  return {
-    onRpc: (event) => {
-      if (shouldSkip(event, onlyErrors)) {
-        return;
-      }
-      try {
-        capture(event);
-      } catch {
-      }
-    }
-  };
-};
-const analyticsEngineSink = (options) => {
-  const { dataset, onlyErrors } = options;
-  return {
-    onRpc: (event) => {
-      if (shouldSkip(event, onlyErrors)) {
-        return;
-      }
-      try {
-        dataset.writeDataPoint({
-          blobs: [event.functionPath, event.ok ? "ok" : "error", event.shardKey ?? "", event.error?.code ?? "", event.fanOut?.table ?? ""],
-          doubles: [event.durationMs, event.ok ? 0 : 1, event.fanOut?.shards ?? 0, event.fanOut?.failed ?? 0],
-          indexes: [event.functionPath]
-        });
-      } catch {
-      }
-    }
-  };
-};
-const combineSinks = (...sinks) => {
-  return {
-    onLog: (event, context) => {
-      for (const sink of sinks) {
-        if (!sink.onLog) {
-          continue;
-        }
-        try {
-          sink.onLog(event, context);
-        } catch {
-        }
-      }
-    },
-    onRpc: (event, context) => {
-      for (const sink of sinks) {
-        if (!sink.onRpc) {
-          continue;
-        }
-        try {
-          sink.onRpc(event, context);
-        } catch {
-        }
-      }
-    }
-  };
-};
-
-export { analyticsEngineSink, combineSinks, consoleSink, sentrySink, webhookSink };