@faststore/api 4.5.1 → 4.6.0-dev.0

package/dist/src/observability/telemetry.d.ts

@@ -1,5 +1,5 @@
 export declare const ResolverTrace: <TContext extends {
-    OTEL: Record<string, any>;
+    OTEL_ENABLED: boolean;
     account: string;
     discoveryConfig: Record<string, any>;
 }, TSource = any, TVars = any, TReturn = any>(fn: (source: TSource, vars: TVars, context: TContext, info: any) => TReturn, resolverName?: string) => (source: TSource, vars: TVars, graphqlContext: TContext, info: any) => TReturn;

package/dist/src/observability/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/observability/telemetry.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACrC,EACD,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,GAAG,EACX,OAAO,GAAG,GAAG,EAEb,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,EAC3E,eAAe,MAAM,MAGnB,QAAQ,OAAO,EACf,MAAM,KAAK,EACX,gBAAgB,QAAQ,EACxB,MAAM,GAAG,KACR,OA4CJ,CAAA"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/observability/telemetry.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS;IACf,YAAY,EAAE,OAAO,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACrC,EACD,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,GAAG,EACX,OAAO,GAAG,GAAG,EAEb,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,EAC3E,qBAAyC,MAGvC,QAAQ,OAAO,EACf,MAAM,KAAK,EACX,gBAAgB,QAAQ,EACxB,MAAM,GAAG,KACR,OA2CJ,CAAA"}

package/dist/src/platforms/vtex/index.d.ts

@@ -30,7 +30,7 @@ export interface GraphqlContext {
     };
     headers: Record<string, string>;
     account: string;
-    OTEL: Record<string, unknown>;
+    OTEL_ENABLED: boolean;
     /** Discovery config passed from @faststore/core, including localization settings. */
     discoveryConfig?: Record<string, unknown>;
 }

package/dist/src/platforms/vtex/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platforms/vtex/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,SAAS,CAAA;AAKtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAG9C,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;SAKK;IACL,OAAO,EAAE;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,YAAY,CAAA;QACnB,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;QAC5C;;;;;WAKG;QACH,wBAAwB,CAAC,EAAE,GAAG,CAC5B,MAAM,EACN,OAAO,CAAC,OAAO,mBAAmB,EAAE,qBAAqB,GAAG,IAAI,CAAC,CAClE,CAAA;KACF,CAAA;IACD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,eAAO,MAAM,yBAAyB,GAAU,SAAS,OAAO,mBAIpD,GAAG,KAAG,cAAc,CAmB/B,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,QAAQ,CAC/D,cAAc,EACd,CAAC,EACD,CAAC,EACD,CAAC,CACF,CAAA;AAED,wBAAgB,YAAY;;;;;;gJAkC2H,6CAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA+if,CAAC;mBAAsB,CAAC;kBAAqB,CAAC;yBAA8B,CAAC;uBAA0B,CAAC;yBAA4B,CAAC;uBAA0B,CAAC;iBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAAwzZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAlBls5B;AAED,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,aAAa,iBAe5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platforms/vtex/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,SAAS,CAAA;AAKtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAG9C,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;SAKK;IACL,OAAO,EAAE;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,YAAY,CAAA;QACnB,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;QAC5C;;;;;WAKG;QACH,wBAAwB,CAAC,EAAE,GAAG,CAC5B,MAAM,EACN,OAAO,CAAC,OAAO,mBAAmB,EAAE,qBAAqB,GAAG,IAAI,CAAC,CAClE,CAAA;KACF,CAAA;IACD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;IACrB,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,eAAO,MAAM,yBAAyB,GAAU,SAAS,OAAO,mBACjD,GAAG,KAAG,cAAc,CAkBlC,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,QAAQ,CAC/D,cAAc,EACd,CAAC,EACD,CAAC,EACD,CAAC,CACF,CAAA;AAED,wBAAgB,YAAY;;;;;;gJAkCuV,6CAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA+if,CAAC;mBAAsB,CAAC;kBAAqB,CAAC;yBAA8B,CAAC;uBAA0B,CAAC;yBAA4B,CAAC;uBAA0B,CAAC;iBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAAwzZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAlB955B;AAED,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,aAAa,iBAe5D"}

package/dist/src/typings/globals.d.ts

@@ -14,12 +14,9 @@ interface Options {
     incrementAddress: boolean;
     flags?: FeatureFlags;
     version?: string;
-    OTEL?: {
-        enabled: boolean;
-        traceparent?: string;
-        tracestate?: string;
-    };
     discoveryConfig?: Record<string, unknown>;
+    /** Emit OpenTelemetry spans from resolvers. Defaults to disabled. */
+    OTEL_ENABLED?: boolean;
 }
 interface FeatureFlags {
     enableOrderFormSync?: boolean;

package/dist/src/typings/globals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../../src/typings/globals.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,CAAA;AAEtB,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAExD,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE3D,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IAEtD,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;IAClD,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,OAAO,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,UAAU,YAAY;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAA;CACvC;AAED,KAAK,QAAQ,CACX,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,GAAG,EACX,OAAO,GAAG,GAAG,IACX,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAA"}
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../../src/typings/globals.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,CAAA;AAEtB,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAExD,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE3D,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IAEtD,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;IAClD,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,UAAU,YAAY;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAA;CACvC;AAED,KAAK,QAAQ,CACX,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,GAAG,EACX,OAAO,GAAG,GAAG,IACX,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faststore/api",
-  "version": "4.5.1",
+  "version": "4.6.0-dev.0",
   "license": "MIT",
   "main": "dist/cjs/index.js",
   "typings": "dist/src/index.d.ts",
@@ -49,7 +49,7 @@
     "@types/cookie": "^0.6.0",
     "@types/express": "^4.17.16",
     "@types/sanitize-html": "^2.9.1",
-    "@vitest/coverage-v8": "4.0.7",
+    "@vitest/coverage-v8": "4.0.18",
     "concurrently": "^6.2.1",
     "copyfiles": "^2.4.1",
     "graphql": "16.11.0",
@@ -57,12 +57,12 @@
     "tslib": "2.8.1",
     "vite": "7.1.5",
     "vite-plugin-dts": "4.5.4",
-    "vitest": "^4.0.7",
-    "@faststore/diagnostics": "^4.5.1"
+    "vitest": "4.0.18",
+    "@faststore/diagnostics": "^4.6.0-dev.0"
   },
   "peerDependencies": {
     "graphql": "16.11.0",
-    "@faststore/diagnostics": "4.5.1"
+    "@faststore/diagnostics": "4.6.0-dev.0"
   },
   "publishConfig": {
     "access": "public"

package/src/observability/telemetry.ts

@@ -1,9 +1,11 @@
-import { OTELAPI } from '@faststore/diagnostics'
+import { logger, OTELAPI } from '@faststore/diagnostics'
 import { name, version } from '../../package.json' with { type: 'json' }
 
+const OTELLogger = logger('@faststore/api')
+
 export const ResolverTrace = <
   TContext extends {
-    OTEL: Record<string, any>
+    OTEL_ENABLED: boolean
     account: string
     discoveryConfig: Record<string, any>
   },
@@ -12,7 +14,7 @@ export const ResolverTrace = <
   TReturn = any,
 >(
   fn: (source: TSource, vars: TVars, context: TContext, info: any) => TReturn,
-  resolverName?: string
+  resolverName = 'Unknown Graphql Resolver'
 ) => {
   return (
     source: TSource,
@@ -20,47 +22,62 @@ export const ResolverTrace = <
     graphqlContext: TContext,
     info: any
   ): TReturn => {
-    if ((graphqlContext?.OTEL?.enabled ?? false) === false) {
+    if (!graphqlContext?.OTEL_ENABLED) {
       return fn(source, vars, graphqlContext, info)
     }
 
-    const trace = OTELAPI.trace.getTracer(name, version)
-    const activeContext = OTELAPI.propagation.extract(
-      OTELAPI.context.active(),
-      graphqlContext.OTEL
-    )
+    const span = OTELAPI.trace.getTracer('Graphql').startSpan(resolverName, {
+      kind: OTELAPI.SpanKind.INTERNAL,
+      attributes: {
+        timestamp: Date.now(),
+        '@faststore_version': version,
+        '@faststore_package_name': name,
+        '@faststore_account_name': graphqlContext.account,
+        '@faststore_environment': process.env.NODE_ENV,
+        '@faststore_resolver_parent_type': info?.parentType?.name,
+        '@faststore_resolver_field_name': info?.fieldName,
+      },
+    })
 
-    return OTELAPI.context.with(activeContext, () => {
-      const span = trace.startSpan(resolverName ?? 'Unknown Graphql Resolver', {
-        startTime: Date.now(),
-        kind: OTELAPI.SpanKind.INTERNAL,
-        attributes: {
-          timestamp: Date.now(),
-          '@faststore_version': version,
-          '@faststore_package_name': name,
-          '@faststore_account_name': graphqlContext.account,
-          '@faststore_environment': process.env.NODE_ENV,
-        },
-      })
+    const otelContext = OTELAPI.trace.setSpan(OTELAPI.context.active(), span)
 
-      if (!span) return fn(source, vars, graphqlContext, info)
-      try {
-        const returnedValue = fn(source, vars, graphqlContext, info)
+    try {
+      const result = OTELAPI.context.with(otelContext, () =>
+        fn(source, vars, graphqlContext, info)
+      )
 
-        if (!(returnedValue instanceof Promise)) {
-          span.end()
-          return returnedValue
-        }
+      if (result instanceof Promise) {
+        return result.then(
+          (value) => {
+            span.end()
 
-        return returnedValue.then((value) => {
-          span.end()
-          return value
-        }) as TReturn
-      } catch (error) {
-        span.end()
-        console.error(`Error when executing resolver: ${resolverName}`, error)
-        throw error
+            return value
+          },
+          (error) => recordResolverError(error, span, resolverName)
+        ) as TReturn
       }
-    })
+
+      span.end()
+
+      return result
+    } catch (error) {
+      return recordResolverError(error, span, resolverName)
+    }
   }
 }
+
+/** Marks the span as failed and rethrows, keeping call sites linear. */
+function recordResolverError(
+  error: unknown,
+  span: OTELAPI.Span,
+  resolverName: string
+): never {
+  span.setStatus({ code: OTELAPI.SpanStatusCode.ERROR })
+  span.recordException(error as Error)
+  span.end()
+
+  console.error(`Error at resolver: ${resolverName}: \n %o`, error)
+  OTELLogger('error', 'Error at resolver: %s\n%o', resolverName, error)
+
+  throw error
+}

package/src/platforms/vtex/index.ts

@@ -1,4 +1,3 @@
-import { OTELAPI } from '@faststore/diagnostics'
 import { mergeSchemas } from '@graphql-tools/schema'
 import { type GraphQLSchema, isSchema } from 'graphql'
 import { withDirectives } from '../../directives'
@@ -45,34 +44,30 @@ export interface GraphqlContext {
   }
   headers: Record<string, string>
   account: string
-  OTEL: Record<string, unknown>
+  OTEL_ENABLED: boolean
   /** Discovery config passed from @faststore/core, including localization settings. */
   discoveryConfig?: Record<string, unknown>
 }
 
 export const GraphqlVtexContextFactory = async (options: Options) => {
-  return OTELAPI.context.with(
-    OTELAPI.propagation.extract(OTELAPI.context.active(), options.OTEL),
-    () =>
-      (ctx: any): GraphqlContext => {
-        ctx.storage = {
-          channel: ChannelMarshal.parse(options.channel),
-          flags: options.flags ?? {},
-          locale: options.locale,
-          cookies: new Map<string, Record<string, string>>(),
-        }
-        ctx.account = options.account
-        ctx.OTEL = options.OTEL
-        ctx.discoveryConfig = options.discoveryConfig
-        // Build clients/loaders last: they capture `ctx` and read storage,
-        // discoveryConfig, etc. at request time, so everything they may depend on
-        // must already be assigned.
-        ctx.clients = getClients(options, ctx)
-        ctx.loaders = getLoaders(options, ctx)
+  return (ctx: any): GraphqlContext => {
+    ctx.storage = {
+      channel: ChannelMarshal.parse(options.channel),
+      flags: options.flags ?? {},
+      locale: options.locale,
+      cookies: new Map<string, Record<string, string>>(),
+    }
+    ctx.account = options.account
+    ctx.OTEL_ENABLED = options.OTEL_ENABLED
+    ctx.discoveryConfig = options.discoveryConfig
+    // Build clients/loaders last: they capture `ctx` and read storage,
+    // discoveryConfig, etc. at request time, so everything they may depend on
+    // must already be assigned.
+    ctx.clients = getClients(options, ctx)
+    ctx.loaders = getLoaders(options, ctx)
 
-        return ctx
-      }
-  )
+    return ctx
+  }
 }
 
 export type GraphqlResolver<S = any, V = any, R = any> = Resolver<

package/src/typings/globals.ts

@@ -18,12 +18,9 @@ interface Options {
   incrementAddress: boolean
   flags?: FeatureFlags
   version?: string
-  OTEL?: {
-    enabled: boolean
-    traceparent?: string
-    tracestate?: string
-  }
   discoveryConfig?: Record<string, unknown>
+  /** Emit OpenTelemetry spans from resolvers. Defaults to disabled. */
+  OTEL_ENABLED?: boolean
 }
 
 interface FeatureFlags {