@interfere/next 11.0.0 → 11.0.3

package/dist/config.d.mts

@@ -1,6 +1,5 @@
 import { ReleaseSlug } from "@interfere/types/releases/slug";
 import { NextConfig } from "next";
-
 //#region src/config.d.ts
 interface NextConfigWithInterfere extends NextConfig {
   interfere?: {

package/dist/config.mjs

@@ -1 +1 @@
-import{configureBuild}from"./internal/build/configure-build.mjs";import{readInterfereEnv}from"./internal/env.mjs";import{FatalError,log}from"./internal/logger.mjs";import{resolveReleaseSlug}from"./internal/release-slug.mjs";import{readNextMajorVersion,warnIfServerInstrumentationMissing}from"./internal/setup-warnings.mjs";import{API_URL}from"@interfere/constants/api";import{omitUndefined}from"@interfere/helpers/omit-undefined";import{LOCAL_DEV_RELEASE_SLUG}from"@interfere/types/releases/slug";import{classifyReleasePipelineError,diagnoseRelease,isInterfereApiKey}from"@interfere/types/sdk/build-diagnostics";import{resolveDeployEnvironment}from"@interfere/types/sdk/deploy-environment";import{PHASE_PRODUCTION_BUILD}from"next/constants.js";const CLIENT_TRACE_METADATA_KEYS=[`traceparent`,`baggage`],DIAGNOSTIC_CONTEXT={publicKeyEnvVar:`INTERFERE_PUBLIC_KEY`};function reportReleaseDiagnostic(code,input){let diagnostic=diagnoseRelease(code,DIAGNOSTIC_CONTEXT,input),lines=[...diagnostic.details];if(diagnostic.severity===`fatal`){log.fatal(diagnostic.title,lines);return}log.warn(diagnostic.title,lines)}function withInterfere(settingsOrConfig={},maybeConfig){let[settings,nextConfig]=maybeConfig===void 0?[{},settingsOrConfig]:[settingsOrConfig,maybeConfig],{interfere,env:userEnv,webpack,turbopack,compiler,productionBrowserSourceMaps,...rest}=nextConfig;if(interfere&&`buildId`in interfere&&interfere.buildId!==void 0)return log.fatal(`Removed: interfere.buildId`,["`interfere.buildId` was removed in SDK 10. It only worked at build time, so server-side spans drifted from the bundle's slug.","Override the commit SHA via the `INTERFERE_SOURCE_ID` env var on both build and runtime envs instead."]);let projectDir=process.cwd(),config=resolveBuildConfig(settings),apiHost=resolveBrowserApiHost(interfere?.apiHost,config.apiUrl),forceEnable=!!process.env.NEXT_PUBLIC_INTERFERE_FORCE_ENABLE,build=configureBuild({existingWebpack:webpack,existingTurbopack:turbopack,projectDir,values:{__INTERFERE_RELEASE_SLUG__:forceEnable?LOCAL_DEV_RELEASE_SLUG:config.releaseSlug,...config.publicKey&&{__INTERFERE_PUBLIC_KEY__:config.publicKey,...apiHost&&{__INTERFERE_API_URL__:apiHost}},...config.environment&&{__INTERFERE_ENVIRONMENT__:config.environment},...forceEnable&&{__INTERFERE_FORCE_ENABLE__:!0}}});if(config.publicKey!==null&&!build.clientInstrumentationApplies)return log.fatal(`Missing instrumentation client`,[`INTERFERE_PUBLIC_KEY is set but no instrumentation-client file was found.`,`Create an instrumentation-client.ts file in your project root or src/ directory.`]);config.publicKey!==null&&warnIfServerInstrumentationMissing(projectDir);let nextMajor=readNextMajorVersion(projectDir),experimental=interfereExperimentalConfig({existing:rest.experimental,instrumentationHook:nextMajor===null||nextMajor<=14,traceMetadata:config.publicKey!==null||forceEnable}),existingHook=compiler?.runAfterProductionCompile,browserSourceMaps=config.apiKey===null?productionBrowserSourceMaps:!0;return config.apiKey!==null&&productionBrowserSourceMaps===!1&&log.warn(`Forcing productionBrowserSourceMaps`,[`withInterfere() requires production source maps to symbolicate errors.`,"Your `productionBrowserSourceMaps: false` was overridden to `true`."]),{...rest,...userEnv?{env:userEnv}:{},compiler:{...omitUndefined(compiler??{}),async runAfterProductionCompile(context){existingHook&&await existingHook(context);try{await runBuildReleasePipeline(context,config)}catch(error){if(error instanceof FatalError)throw error;let message=error instanceof Error?error.message:String(error);log.warn(`Skipping release pipeline`,[`Interfere encountered an unexpected error.`,`Build will continue, but this release's data will be ingested, but ignored as finding when generating insights.`,`Error: ${message}`])}}},...omitUndefined({productionBrowserSourceMaps:browserSourceMaps,turbopack:build.turbopack,webpack:build.webpack}),...experimental?{experimental}:{}}}function interfereExperimentalConfig({existing,instrumentationHook,traceMetadata}){let merged={...existing,...instrumentationHook?{instrumentationHook:!0}:{},...traceMetadata?{clientTraceMetadata:[...new Set([...existing?.clientTraceMetadata??[],...CLIENT_TRACE_METADATA_KEYS])]}:{}};return Object.keys(merged).length>0?merged:void 0}function resolveBrowserApiHost(apiHost,apiUrl){let host=apiHost??apiUrl;if(host!==API_URL)return normalizeHost(host)}function normalizeHost(host){try{return new URL(host).origin}catch{return log.fatal(`Invalid apiHost`,[`interfere.apiHost must be a full URL, e.g. "https://in.yourapp.com".`,`Received: ${host}`])}}function resolveBuildConfig(settings){let{apiKey,apiUrl,publicKey}=readInterfereEnv(),{commitSha,slug}=resolveReleaseSlug(),environment=process.env.NEXT_PHASE===PHASE_PRODUCTION_BUILD?resolveDeployEnvironment(process.env):null;return{apiKey:apiKey??null,apiUrl,buildId:commitSha,environment,publicKey:publicKey??null,purgeSourceMaps:settings.sourceMaps?.purge??!0,releaseSlug:slug}}async function runBuildReleasePipeline(context,config){let{apiKey,buildId,releaseSlug}=config;if(!apiKey)return log.fatal(`API key not set`,[`withInterfere() requires an API key to publish release metadata during production builds.`,`Set the INTERFERE_API_KEY environment variable, or remove withInterfere() from your Next.js config.`,`See: https://interfere.com/docs/guides/next-js`]);if(!isInterfereApiKey(apiKey))return reportReleaseDiagnostic(`API_KEY_WRONG_PREFIX`,{apiKey});if(!(buildId&&releaseSlug))return log.fatal(`Commit SHA missing`,[`Could not resolve a commit SHA from environment variables or git.`,"Set `INTERFERE_SOURCE_ID`, ensure your CI exposes its git SHA env var (e.g. `VERCEL_GIT_COMMIT_SHA`, `GITHUB_SHA`), or run inside a git checkout."]);let{runBuildPipeline}=await import(`./internal/build/pipeline.mjs`);try{let result=await runBuildPipeline(context,{...config,apiKey,buildId,releaseSlug});if(!result.ready){log.warn(`Skipping`,[`No source maps found`]);return}log.info(`Completed`,[`https://interfere.com/~/${result.config?.org.slug}/surfaces/${result.config?.surface.slug}`,`Release: ${result.release?.destination.slug??`Unknown`}`,`Build: ${result.buildId}`,`Artifacts: ${result.fileCount} source maps`])}catch(error){let message=error instanceof Error?error.message:String(error);reportReleaseDiagnostic(classifyReleasePipelineError(error),{errorMessage:message});return}}export{withInterfere};
+import{configureBuild}from"./internal/build/configure-build.mjs";import{readInterfereEnv}from"./internal/env.mjs";import{FatalError,log}from"./internal/logger.mjs";import{resolveReleaseSlug}from"./internal/release-slug.mjs";import{readNextMajorVersion,warnIfServerInstrumentationMissing}from"./internal/setup-warnings.mjs";import{API_URL}from"@interfere/constants/api";import{omitUndefined}from"@interfere/helpers/omit-undefined";import{LOCAL_DEV_RELEASE_SLUG}from"@interfere/types/releases/slug";import{classifyReleasePipelineError,diagnoseRelease,isInterfereApiKey}from"@interfere/types/sdk/build-diagnostics";import{resolveDeployEnvironment}from"@interfere/types/sdk/deploy-environment";import{PHASE_PRODUCTION_BUILD}from"next/constants.js";const CLIENT_TRACE_METADATA_KEYS=[`traceparent`,`baggage`],DIAGNOSTIC_CONTEXT={publicKeyEnvVar:`INTERFERE_PUBLIC_KEY`};function reportReleaseDiagnostic(code,input){let diagnostic=diagnoseRelease(code,DIAGNOSTIC_CONTEXT,input),lines=[...diagnostic.details];if(diagnostic.severity===`fatal`){log.fatal(diagnostic.title,lines);return}log.warn(diagnostic.title,lines)}function withInterfere(settingsOrConfig={},maybeConfig){let[settings,nextConfig]=maybeConfig===void 0?[{},settingsOrConfig]:[settingsOrConfig,maybeConfig],{interfere,env:userEnv,webpack,turbopack,compiler,productionBrowserSourceMaps,...rest}=nextConfig;if(interfere&&`buildId`in interfere&&interfere.buildId!==void 0)return log.fatal(`Removed: interfere.buildId`,["`interfere.buildId` was removed in SDK 10. It only worked at build time, so server-side spans drifted from the bundle's slug.","Override the commit SHA via the `INTERFERE_SOURCE_ID` env var on both build and runtime envs instead."]);let projectDir=process.cwd(),config=resolveBuildConfig(settings),apiHost=resolveBrowserApiHost(interfere?.apiHost,config.apiUrl),forceEnable=!!process.env.NEXT_PUBLIC_INTERFERE_FORCE_ENABLE,releaseSlug=forceEnable?LOCAL_DEV_RELEASE_SLUG:config.releaseSlug,build=configureBuild({existingWebpack:webpack,existingTurbopack:turbopack,projectDir,remoteConfigFetch:resolveRemoteConfigFetch(config),values:{__INTERFERE_RELEASE_SLUG__:releaseSlug,...config.publicKey&&{__INTERFERE_PUBLIC_KEY__:config.publicKey,...apiHost&&{__INTERFERE_API_URL__:apiHost}},...config.environment&&{__INTERFERE_ENVIRONMENT__:config.environment},...forceEnable&&{__INTERFERE_FORCE_ENABLE__:!0}}});if(config.publicKey!==null&&!build.clientInstrumentationApplies)return log.fatal(`Missing instrumentation client`,[`INTERFERE_PUBLIC_KEY is set but no instrumentation-client file was found.`,`Create an instrumentation-client.ts file in your project root or src/ directory.`]);config.publicKey!==null&&warnIfServerInstrumentationMissing(projectDir);let nextMajor=readNextMajorVersion(projectDir),experimental=interfereExperimentalConfig({existing:rest.experimental,instrumentationHook:nextMajor===null||nextMajor<=14,traceMetadata:config.publicKey!==null||forceEnable}),existingHook=compiler?.runAfterProductionCompile,browserSourceMaps=config.apiKey!==null||productionBrowserSourceMaps;return config.apiKey!==null&&productionBrowserSourceMaps===!1&&log.warn(`Forcing productionBrowserSourceMaps`,[`withInterfere() requires production source maps to symbolicate errors.`,"Your `productionBrowserSourceMaps: false` was overridden to `true`."]),{...rest,...userEnv?{env:userEnv}:{},compiler:{...omitUndefined(compiler??{}),async runAfterProductionCompile(context){existingHook&&await existingHook(context);try{await runBuildReleasePipeline(context,config)}catch(error){if(error instanceof FatalError)throw error;let message=error instanceof Error?error.message:String(error);log.warn(`Skipping release pipeline`,[`Interfere encountered an unexpected error.`,`Build will continue, but this release's data will be ingested, but ignored as finding when generating insights.`,`Error: ${message}`])}}},...omitUndefined({productionBrowserSourceMaps:browserSourceMaps,turbopack:build.turbopack,webpack:build.webpack}),...experimental?{experimental}:{}}}function interfereExperimentalConfig({existing,instrumentationHook,traceMetadata}){let merged={...existing,...instrumentationHook?{instrumentationHook:!0}:{},...traceMetadata?{clientTraceMetadata:[...new Set([...existing?.clientTraceMetadata??[],...CLIENT_TRACE_METADATA_KEYS])]}:{}};return Object.keys(merged).length>0?merged:void 0}function resolveBrowserApiHost(apiHost,apiUrl){let host=apiHost??apiUrl;if(host!==API_URL)return normalizeHost(host)}function normalizeHost(host){try{return new URL(host).origin}catch{return log.fatal(`Invalid apiHost`,[`interfere.apiHost must be a full URL, e.g. "https://in.yourapp.com".`,`Received: ${host}`])}}function resolveBuildConfig(settings){let{apiKey,apiUrl,publicKey}=readInterfereEnv(),{commitSha,slug}=resolveReleaseSlug(),environment=process.env.NEXT_PHASE===PHASE_PRODUCTION_BUILD?resolveDeployEnvironment(process.env):null;return{apiKey:apiKey??null,apiUrl,buildId:commitSha,environment,publicKey:publicKey??null,purgeSourceMaps:settings.sourceMaps?.purge??!0,releaseSlug:slug}}function resolveRemoteConfigFetch(config){if(process.env.NEXT_PHASE===PHASE_PRODUCTION_BUILD&&config.publicKey)return{apiUrl:config.apiUrl,publicKey:config.publicKey}}async function runBuildReleasePipeline(context,config){let{apiKey,buildId,releaseSlug}=config;if(!apiKey)return log.fatal(`API key not set`,[`withInterfere() requires an API key to publish release metadata during production builds.`,`Set the INTERFERE_API_KEY environment variable, or remove withInterfere() from your Next.js config.`,`See: https://interfere.com/docs/guides/next-js`]);if(!isInterfereApiKey(apiKey))return reportReleaseDiagnostic(`API_KEY_WRONG_PREFIX`,{apiKey});if(!(buildId&&releaseSlug))return log.fatal(`Commit SHA missing`,[`Could not resolve a commit SHA from environment variables or git.`,"Set `INTERFERE_SOURCE_ID`, ensure your CI exposes its git SHA env var (e.g. `VERCEL_GIT_COMMIT_SHA`, `GITHUB_SHA`), or run inside a git checkout."]);let{runBuildPipeline}=await import(`./internal/build/pipeline.mjs`);try{let result=await runBuildPipeline(context,{...config,apiKey,buildId,releaseSlug});if(!result.ready){log.warn(`Skipping`,[`No source maps found`]);return}log.info(`Completed`,[`https://interfere.com/~/${result.config?.org.slug}/surfaces/${result.config?.surface.slug}`,`Release: ${result.release?.destination.slug??`Unknown`}`,`Build: ${result.buildId}`,`Artifacts: ${result.fileCount} source maps`])}catch(error){let message=error instanceof Error?error.message:String(error);reportReleaseDiagnostic(classifyReleasePipelineError(error),{errorMessage:message});return}}export{withInterfere};

package/dist/instrument-client.d.mts

@@ -1,15 +1,14 @@
 import { capture, span } from "@interfere/react/api";
 import { Kernel, KernelInternalOptions, KernelOptions } from "@interfere/react/internal/kernel";
 import { ConsentCategory, ConsentState, GateableCategory } from "@interfere/types/sdk/plugins/manifest";
-
 //#region src/instrument-client.d.ts
 declare const close: () => Promise<void>, consent: {
-    get(): import("@interfere/types/sdk/plugins/manifest").ConsentState | null;
-    set(value?: import("@interfere/types/sdk/plugins/manifest").ConsentState): void;
-  }, getKernel: () => import("@interfere/react/internal/kernel").Kernel, getKernelOrNull: () => import("@interfere/react/internal/kernel").Kernel | null, identity: {
-    clear(): void;
-    get(): import("@interfere/types/sdk/identify").IdentifyParams | null;
-    set(params: import("@interfere/types/sdk/identify").IdentifyParams): Promise<void>;
-  }, init: (opts?: import("@interfere/react/internal/kernel").KernelOptions) => Promise<import("@interfere/react/internal/kernel").Kernel | null>, subscribeToKernel: (listener: () => void) => () => void;
+  get(): import("@interfere/types/sdk/plugins/manifest").ConsentState | null;
+  set(value?: import("@interfere/types/sdk/plugins/manifest").ConsentState): void;
+}, getKernel: () => import("@interfere/react/internal/kernel").Kernel, getKernelOrNull: () => import("@interfere/react/internal/kernel").Kernel | null, identity: {
+  clear(): void;
+  get(): import("@interfere/types/sdk/identify").IdentifyParams | null;
+  set(params: import("@interfere/types/sdk/identify").IdentifyParams): Promise<void>;
+}, init: (opts?: import("@interfere/react/internal/kernel").KernelOptions) => Promise<import("@interfere/react/internal/kernel").Kernel | null>, subscribeToKernel: (listener: () => void) => () => void;
 //#endregion
 export { type ConsentCategory, type ConsentState, type GateableCategory, type Kernel, type KernelInternalOptions, type KernelOptions, capture, close, consent, getKernel, getKernelOrNull, identity, init, span, subscribeToKernel };

package/dist/instrumentation.d.mts

@@ -5,15 +5,13 @@ import { AttributeValue, TextMapPropagator } from "@opentelemetry/api";
 import { SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { Instrumentation } from "@opentelemetry/instrumentation";
 import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
-import { MetricReader } from "@opentelemetry/sdk-metrics";
-
 //#region src/instrumentation.d.ts
 declare function flush(): Promise<void>;
 /**
  * Composable building blocks the Interfere SDK contributes to OTel —
- * span / log / metric processors, baggage propagator, undici
- * instrumentation, plus the resource attributes and side-effect
- * installers (console bridge + remote-config fetch).
+ * span / log / metric processors, baggage propagator, plus the
+ * resource attributes and side-effect installers (console bridge +
+ * remote-config fetch).
  *
  * Use this when you want to plug Interfere into an existing OTel
  * bootstrap (e.g. `@vercel/otel`'s `registerOTel({...})`, DataDog's
@@ -44,28 +42,15 @@ interface InterfereOtelKit {
    */
   fetchRemoteConfig: () => Promise<void>;
   /**
-   * Instrumentations the SDK ships. Currently `UndiciInstrumentation`
-   * pre-configured with `propagateContextUrls` / `ignoreUrls` semantics
-   * from `ServerInstrumentationOptions`.
-   *
-   * **Composition with `@vercel/otel`**: `instrumentations: ["auto"]`
-   * registers Vercel's `globalThis.fetch` wrapper, which only
-   * auto-propagates `traceparent` to Vercel deployment URLs — outbound
-   * fetches to a different origin (e.g. `in.interfere.com`) get a
-   * span but no header injection unless
-   * `instrumentationConfig.fetch.propagateContextUrls` is set, and
-   * even then it doesn't cover the lower-level undici dispatcher path
-   * Next.js route handlers use. Spread `kit.instrumentations` after
-   * `"auto"` to layer this UndiciInstrumentation on top — propagation
-   * extends to every outbound undici call (filtered via `ignoreUrls`).
-   * Risk of double span emission on overlapping call sites is bounded:
-   * Vercel's fetch wraps `globalThis.fetch`, this hooks the undici
-   * dispatcher one layer lower, so duplicates only appear when both
-   * paths actually fire on the same call.
+   * Instrumentations the SDK ships. Currently empty — outbound HTTP
+   * spans come from Next.js's own `patchFetch` (App Router) or
+   * `@vercel/otel`'s fetch wrap, so we don't layer a redundant undici
+   * instrumentation and stay off the request hot path. Kept in the
+   * kit shape for forward-compatibility with composed setups that
+   * spread `[...kit.instrumentations, ...]` into `registerOTel({...})`.
    */
   instrumentations: Instrumentation[];
   logRecordProcessors: LogRecordProcessor[];
-  metricReaders: MetricReader[];
   /**
    * W3C baggage propagator. Trace context is intentionally *not*
    * included — `@vercel/otel`'s `propagators: ["auto"]` already

package/dist/instrumentation.edge.d.mts

@@ -1,7 +1,6 @@
 import { ServerInstrumentationOptions } from "./internal/server/instrumentation-options.mjs";
 import { onRequestError } from "./internal/server/capture.mjs";
 import { InterfereOtelKit } from "./instrumentation.mjs";
-
 //#region src/instrumentation.edge.d.ts
 /**
  * Edge-runtime bootstrap for `@interfere/next/instrumentation`. Selected by
@@ -12,7 +11,9 @@ import { InterfereOtelKit } from "./instrumentation.mjs";
  * console bridge, `node:child_process`/`node:crypto` release-slug derivation)
  * can't run on edge, so this builds an edge-safe pipeline instead: a
  * `BasicTracerProvider` + `SimpleSpanProcessor` exporting via {@link FetchTraceExporter}.
- * `onRequestError` then records middleware / edge route-handler errors onto it.
+ * Under `serverTracing: "drain"` the exporter is omitted and traces come from
+ * the platform trace drain instead — the provider is still registered so
+ * `onRequestError` can record exception events on the active span.
  *
  * Release slug is `LOCAL_DEV_RELEASE_SLUG` under force-enable (dev); a
  * build-baked slug for production edge is a follow-up.

package/dist/instrumentation.edge.mjs

@@ -1 +1 @@
-import{readInterfereEnv}from"./internal/env.mjs";import{PRODUCER_VERSION}from"./internal/version.mjs";import{FetchTraceExporter}from"./internal/server/edge-exporter.mjs";import{setServerFlush}from"./internal/server/server-flush.mjs";import{withPublicKey}from"./internal/url.mjs";import{onRequestError}from"./internal/server/capture.mjs";import{LOCAL_DEV_RELEASE_SLUG}from"@interfere/types/releases/slug";import{trace}from"@opentelemetry/api";import{resourceFromAttributes}from"@opentelemetry/resources";import{BasicTracerProvider,SimpleSpanProcessor}from"@opentelemetry/sdk-trace-base";let registered=!1;function register(opts={}){if(registered)return Promise.resolve();let env=readInterfereEnv();if(!env.publicKey)return Promise.resolve();let releaseSlug=process.env.NEXT_PUBLIC_INTERFERE_FORCE_ENABLE?LOCAL_DEV_RELEASE_SLUG:null;releaseSlug||console.warn(`[interfere] edge runtime has no build-baked release.slug; the collector will reject edge spans until one is wired (production follow-up).`);let sinkUrl=withPublicKey(`${env.apiUrl}/v2/sink`,env.publicKey),provider=new BasicTracerProvider({resource:resourceFromAttributes({"service.name":opts.serviceName??`interfere-sdk-next-edge`,"service.namespace":`interfere`,"deployment.environment.name":env.nodeEnvironment,"telemetry.sdk.language":`nodejs`,"interfere.sdk.name":`@interfere/next`,"interfere.sdk.version":PRODUCER_VERSION,...releaseSlug?{"release.slug":releaseSlug}:{}}),spanProcessors:[new SimpleSpanProcessor(new FetchTraceExporter(sinkUrl,{"x-interfere-producer-version":PRODUCER_VERSION}))]});return trace.setGlobalTracerProvider(provider),setServerFlush(()=>provider.forceFlush()),registered=!0,Promise.resolve()}function buildInterfereOtelKit(_opts={}){return null}export{buildInterfereOtelKit,onRequestError,register};
+import{readInterfereEnv}from"./internal/env.mjs";import{PRODUCER_VERSION}from"./internal/version.mjs";import{FetchTraceExporter}from"./internal/server/edge-exporter.mjs";import{setServerFlush}from"./internal/server/server-flush.mjs";import{withPublicKey}from"./internal/url.mjs";import{onRequestError}from"./internal/server/capture.mjs";import{LOCAL_DEV_RELEASE_SLUG}from"@interfere/types/releases/slug";import{readServerTracingMode}from"@interfere/types/sdk/server-tracing";import{trace}from"@opentelemetry/api";import{resourceFromAttributes}from"@opentelemetry/resources";import{BasicTracerProvider,SimpleSpanProcessor}from"@opentelemetry/sdk-trace-base";let registered=!1;function register(opts={}){if(registered)return Promise.resolve();let env=readInterfereEnv();if(!env.publicKey)return Promise.resolve();let releaseSlug=process.env.NEXT_PUBLIC_INTERFERE_FORCE_ENABLE?LOCAL_DEV_RELEASE_SLUG:null;releaseSlug||console.warn(`[interfere] edge runtime has no build-baked release.slug; the collector will reject edge spans until one is wired (production follow-up).`);let isDrainMode=readServerTracingMode()===`drain`;isDrainMode&&console.info(`[interfere] edge server tracing in drain mode; SDK trace exporter disabled — server traces come from the platform trace drain.`);let provider=new BasicTracerProvider({resource:resourceFromAttributes({"service.name":opts.serviceName??`interfere-sdk-next-edge`,"service.namespace":`interfere`,"deployment.environment.name":env.nodeEnvironment,"telemetry.sdk.language":`nodejs`,"interfere.sdk.name":`@interfere/next`,"interfere.sdk.version":PRODUCER_VERSION,...releaseSlug?{"release.slug":releaseSlug}:{}}),spanProcessors:isDrainMode?[]:[new SimpleSpanProcessor(new FetchTraceExporter(withPublicKey(`${env.apiUrl}/v2/sink`,env.publicKey),{"x-interfere-producer-version":PRODUCER_VERSION}))]});return trace.setGlobalTracerProvider(provider),setServerFlush(()=>provider.forceFlush()),registered=!0,Promise.resolve()}function buildInterfereOtelKit(_opts={}){return null}export{buildInterfereOtelKit,onRequestError,register};

package/dist/instrumentation.mjs

@@ -1 +1 @@
-import{readInterfereEnv}from"./internal/env.mjs";import{resolveReleaseSlug}from"./internal/release-slug.mjs";import{PRODUCER_VERSION}from"./internal/version.mjs";import{setServerFlush}from"./internal/server/server-flush.mjs";import{withPublicKey}from"./internal/url.mjs";import{fetchAndCacheRemoteConfig}from"./internal/server/remote-config.mjs";import{onRequestError}from"./internal/server/capture.mjs";import{bridgeConsoleToOtel}from"./internal/server/console-bridge.mjs";import{installGlobalHandlers}from"./internal/server/global-handlers.mjs";import{PrerenderSafeIdGenerator}from"./internal/server/id-generator.mjs";import{metrics,propagation}from"@opentelemetry/api";import{resourceFromAttributes}from"@opentelemetry/resources";import{BatchSpanProcessor}from"@opentelemetry/sdk-trace-base";import{CompositePropagator,W3CBaggagePropagator,W3CTraceContextPropagator}from"@opentelemetry/core";import{BaggageSpanProcessor}from"@opentelemetry/baggage-span-processor";import{AsyncLocalStorageContextManager}from"@opentelemetry/context-async-hooks";import{OTLPLogExporter}from"@opentelemetry/exporter-logs-otlp-http";import{AggregationTemporalityPreference,OTLPMetricExporter}from"@opentelemetry/exporter-metrics-otlp-http";import{OTLPTraceExporter}from"@opentelemetry/exporter-trace-otlp-http";import{registerInstrumentations}from"@opentelemetry/instrumentation";import{UndiciInstrumentation}from"@opentelemetry/instrumentation-undici";import{BatchLogRecordProcessor,LoggerProvider}from"@opentelemetry/sdk-logs";import{MeterProvider,PeriodicExportingMetricReader}from"@opentelemetry/sdk-metrics";import{NodeTracerProvider}from"@opentelemetry/sdk-trace-node";let registered=!1,tracerProvider=null,loggerProvider=null,meterProvider=null;async function flush(){await Promise.all([tracerProvider?.forceFlush(),loggerProvider?.forceFlush(),meterProvider?.forceFlush()])}function matchesAny(url,patterns){for(let pattern of patterns)if(pattern instanceof RegExp?pattern.test(url):url.includes(pattern))return!0;return!1}function buildInterfereOtelKit(opts={}){let env=readInterfereEnv();if(!env.publicKey)return null;let{slug:releaseSlug}=resolveReleaseSlug();releaseSlug||console.warn("[interfere] No commit SHA available; server spans will ship without `release.slug`. Set `INTERFERE_SOURCE_ID` (or any of `VERCEL_GIT_COMMIT_SHA`, `GITHUB_SHA`) on the runtime env.");let sinkUrl=withPublicKey(`${env.apiUrl}/v2/sink`,env.publicKey),ignoreUrls=[sinkUrl,...opts.ignoreUrls??[]],propagateContextUrls=opts.propagateContextUrls??[],exporterHeaders={"x-interfere-producer-version":PRODUCER_VERSION};return{resourceAttributes:{"service.name":opts.serviceName??`interfere-sdk-next-server`,"service.namespace":`interfere`,"deployment.environment.name":env.nodeEnvironment,"telemetry.sdk.language":`nodejs`,"interfere.sdk.name":`@interfere/next`,"interfere.sdk.version":PRODUCER_VERSION,...releaseSlug?{"release.slug":releaseSlug}:{}},spanProcessors:[new BaggageSpanProcessor(()=>!0),new BatchSpanProcessor(new OTLPTraceExporter({url:sinkUrl,headers:exporterHeaders})),...opts._internalAdditionalSpanProcessors??[]],logRecordProcessors:[new BatchLogRecordProcessor(new OTLPLogExporter({url:sinkUrl,headers:exporterHeaders})),...opts._internalAdditionalLogRecordProcessors??[]],metricReaders:[new PeriodicExportingMetricReader({exporter:new OTLPMetricExporter({url:sinkUrl,headers:exporterHeaders,temporalityPreference:AggregationTemporalityPreference.DELTA}),exportIntervalMillis:3e4}),...opts._internalAdditionalMetricReaders??[]],propagators:[new W3CBaggagePropagator],instrumentations:[new UndiciInstrumentation({ignoreRequestHook:req=>matchesAny(`${req.origin}${req.path}`,ignoreUrls),requestHook:(span,req)=>{matchesAny(`${req.origin}${req.path}`,propagateContextUrls)&&span.setAttribute(`interfere.propagated`,!0)}})],enableConsoleBridge:()=>bridgeConsoleToOtel(),fetchRemoteConfig:()=>fetchAndCacheRemoteConfig()}}async function register(opts={}){if(registered)return;let kit=buildInterfereOtelKit(opts);if(!kit)return;let resource=resourceFromAttributes(kit.resourceAttributes);tracerProvider=new NodeTracerProvider({resource,spanProcessors:kit.spanProcessors,idGenerator:new PrerenderSafeIdGenerator}),propagation.fields().length===0&&propagation.setGlobalPropagator(new CompositePropagator({propagators:[new W3CTraceContextPropagator,...kit.propagators]})),tracerProvider.register({contextManager:new AsyncLocalStorageContextManager().enable()}),loggerProvider=new LoggerProvider({resource,processors:kit.logRecordProcessors});let{logs:logsApi}=await import(`@opentelemetry/api-logs`);logsApi.setGlobalLoggerProvider(loggerProvider),meterProvider=new MeterProvider({resource,readers:kit.metricReaders}),metrics.setGlobalMeterProvider(meterProvider),registerInstrumentations({tracerProvider,meterProvider,instrumentations:kit.instrumentations}),opts.consoleBridge!==!1&&kit.enableConsoleBridge(),installGlobalHandlers({captureUncaughtException:opts.captureUncaughtException??!0,captureUnhandledRejection:opts.captureUnhandledRejection??!0,exitOnUncaughtException:process.env.NODE_ENV===`production`,flush}),setServerFlush(flush),registered=!0,await kit.fetchRemoteConfig()}export{PrerenderSafeIdGenerator,buildInterfereOtelKit,flush,onRequestError,register};
+import{readInterfereEnv}from"./internal/env.mjs";import{resolveReleaseSlug}from"./internal/release-slug.mjs";import{PRODUCER_VERSION}from"./internal/version.mjs";import{setServerFlush}from"./internal/server/server-flush.mjs";import{withPublicKey}from"./internal/url.mjs";import{fetchAndCacheRemoteConfig}from"./internal/server/remote-config.mjs";import{onRequestError}from"./internal/server/capture.mjs";import{bridgeConsoleToOtel}from"./internal/server/console-bridge.mjs";import{installGlobalHandlers}from"./internal/server/global-handlers.mjs";import{PrerenderSafeIdGenerator}from"./internal/server/id-generator.mjs";import{readServerTracingMode}from"@interfere/types/sdk/server-tracing";import{propagation}from"@opentelemetry/api";import{resourceFromAttributes}from"@opentelemetry/resources";import{BatchSpanProcessor}from"@opentelemetry/sdk-trace-base";import{CompositePropagator,W3CBaggagePropagator,W3CTraceContextPropagator}from"@opentelemetry/core";import{readLogSourcingMode}from"@interfere/types/sdk/log-sourcing";import{BaggageSpanProcessor}from"@opentelemetry/baggage-span-processor";import{AsyncLocalStorageContextManager}from"@opentelemetry/context-async-hooks";import{OTLPLogExporter}from"@opentelemetry/exporter-logs-otlp-http";import{OTLPTraceExporter}from"@opentelemetry/exporter-trace-otlp-http";import{registerInstrumentations}from"@opentelemetry/instrumentation";import{CompressionAlgorithm}from"@opentelemetry/otlp-exporter-base";import{BatchLogRecordProcessor,LoggerProvider}from"@opentelemetry/sdk-logs";import{NodeTracerProvider}from"@opentelemetry/sdk-trace-node";const EXPORT_TIMEOUT_MS=2e3;let registered=!1,tracerProvider=null,loggerProvider=null;async function flush(){await Promise.all([tracerProvider?.forceFlush(),loggerProvider?.forceFlush()])}function buildInterfereOtelKit(opts={}){let env=readInterfereEnv();if(!env.publicKey)return null;let{slug:releaseSlug}=resolveReleaseSlug();releaseSlug||console.warn("[interfere] No commit SHA available; server spans will ship without `release.slug`. Set `INTERFERE_SOURCE_ID` (or any of `VERCEL_GIT_COMMIT_SHA`, `GITHUB_SHA`) on the runtime env.");let sinkUrl=withPublicKey(`${env.apiUrl}/v2/sink`,env.publicKey),exporterHeaders={"x-interfere-producer-version":PRODUCER_VERSION},resourceAttributes={"service.name":opts.serviceName??`interfere-sdk-next-server`,"service.namespace":`interfere`,"deployment.environment.name":env.nodeEnvironment,"telemetry.sdk.language":`nodejs`,"interfere.sdk.name":`@interfere/next`,"interfere.sdk.version":PRODUCER_VERSION,...releaseSlug?{"release.slug":releaseSlug}:{}},compression=opts.compression===`gzip`?CompressionAlgorithm.GZIP:CompressionAlgorithm.NONE,isDrainMode=readServerTracingMode()===`drain`,spanProcessors=[new BaggageSpanProcessor(()=>!0),...isDrainMode?[]:[new BatchSpanProcessor(new OTLPTraceExporter({url:sinkUrl,headers:exporterHeaders,compression,timeoutMillis:EXPORT_TIMEOUT_MS}))],...opts._internalAdditionalSpanProcessors??[]],isLogDrainMode=readLogSourcingMode()===`drain`;return{resourceAttributes,spanProcessors,logRecordProcessors:[...isLogDrainMode?[]:[new BatchLogRecordProcessor(new OTLPLogExporter({url:sinkUrl,headers:exporterHeaders,compression,timeoutMillis:EXPORT_TIMEOUT_MS}))],...opts._internalAdditionalLogRecordProcessors??[]],propagators:[new W3CBaggagePropagator],instrumentations:[],enableConsoleBridge:()=>isLogDrainMode?()=>void 0:bridgeConsoleToOtel(),fetchRemoteConfig:()=>fetchAndCacheRemoteConfig()}}async function register(opts={}){if(registered)return;let kit=buildInterfereOtelKit(opts);if(!kit)return;readServerTracingMode()===`drain`&&console.info(`[interfere] server tracing in drain mode; SDK trace exporter disabled — server traces come from the platform trace drain.`);let resource=resourceFromAttributes(kit.resourceAttributes);tracerProvider=new NodeTracerProvider({resource,spanProcessors:kit.spanProcessors,idGenerator:new PrerenderSafeIdGenerator}),propagation.fields().length===0&&propagation.setGlobalPropagator(new CompositePropagator({propagators:[new W3CTraceContextPropagator,...kit.propagators]})),tracerProvider.register({contextManager:new AsyncLocalStorageContextManager().enable()}),loggerProvider=new LoggerProvider({resource,processors:kit.logRecordProcessors});let{logs:logsApi}=await import(`@opentelemetry/api-logs`);logsApi.setGlobalLoggerProvider(loggerProvider),registerInstrumentations({tracerProvider,instrumentations:kit.instrumentations}),opts.consoleBridge!==!1&&kit.enableConsoleBridge(),installGlobalHandlers({captureUncaughtException:opts.captureUncaughtException??!0,captureUnhandledRejection:opts.captureUnhandledRejection??!0,exitOnUncaughtException:process.env.NODE_ENV===`production`,flush}),setServerFlush(flush),registered=!0}export{PrerenderSafeIdGenerator,buildInterfereOtelKit,flush,onRequestError,register};

package/dist/internal/build/configure-build.d.mts

@@ -1,17 +1,30 @@
+import { ServerTracingMode } from "@interfere/types/sdk/server-tracing";
 import { NextConfig } from "next";
-
 //#region src/internal/build/configure-build.d.ts
 interface InterfereInjectedValues {
   readonly __INTERFERE_API_URL__?: string;
   readonly __INTERFERE_ENVIRONMENT__?: string;
   readonly __INTERFERE_FORCE_ENABLE__?: boolean;
+  readonly __INTERFERE_INGEST_URL__?: string;
   readonly __INTERFERE_PUBLIC_KEY__?: string;
   readonly __INTERFERE_RELEASE_SLUG__: string | null;
+  readonly __INTERFERE_SERVER_TRACING__?: ServerTracingMode;
+}
+/**
+ * Inputs for the loader's build-time `/v2/config` fetch that resolves the
+ * surface's remote config (`serverTracing` mode + `ingestUrl`). Omitted
+ * outside production builds or when no public key is set — the loader then
+ * bakes no remote-config globals.
+ */
+interface RemoteConfigFetch {
+  readonly apiUrl: string;
+  readonly publicKey: string;
 }
 interface ConfigureBuildInput {
   readonly existingTurbopack: NextConfig["turbopack"] | undefined;
   readonly existingWebpack: NextConfig["webpack"] | undefined;
   readonly projectDir: string;
+  readonly remoteConfigFetch?: RemoteConfigFetch | undefined;
   readonly values: InterfereInjectedValues;
 }
 interface ConfigureBuildOutput {
@@ -19,11 +32,6 @@ interface ConfigureBuildOutput {
   readonly turbopack: NextConfig["turbopack"] | undefined;
   readonly webpack: NextConfig["webpack"] | undefined;
 }
-declare function configureBuild({
-  existingWebpack,
-  existingTurbopack,
-  projectDir,
-  values
-}: ConfigureBuildInput): ConfigureBuildOutput;
+declare function configureBuild({ existingWebpack, existingTurbopack, projectDir, remoteConfigFetch, values }: ConfigureBuildInput): ConfigureBuildOutput;
 //#endregion
-export { InterfereInjectedValues, configureBuild };
+export { InterfereInjectedValues, RemoteConfigFetch, configureBuild };

package/dist/internal/build/configure-build.mjs

@@ -1 +1 @@
-import{existsSync}from"node:fs";import{basename,dirname,join,normalize,resolve}from"node:path";import{fileURLToPath}from"node:url";const INSTRUMENTATION_CLIENT_FILES=[`instrumentation-client.ts`,`instrumentation-client.tsx`,`instrumentation-client.js`,`instrumentation-client.jsx`,`src/instrumentation-client.ts`,`src/instrumentation-client.tsx`,`src/instrumentation-client.js`,`src/instrumentation-client.jsx`],INSTRUMENTATION_SERVER_FILES=[`instrumentation.ts`,`instrumentation.tsx`,`instrumentation.js`,`instrumentation.jsx`,`src/instrumentation.ts`,`src/instrumentation.tsx`,`src/instrumentation.js`,`src/instrumentation.jsx`],LOADER_FILE_CANDIDATES=[`value-injection-loader.ts`,`value-injection-loader.js`,`value-injection-loader.mjs`,`value-injection-loader.cjs`];function configureBuild({existingWebpack,existingTurbopack,projectDir,values}){let clientPath=resolveFirstExisting(projectDir,INSTRUMENTATION_CLIENT_FILES),targets=[clientPath,resolveFirstExisting(projectDir,INSTRUMENTATION_SERVER_FILES)].filter(path=>path!==null),clientInstrumentationApplies=!!(clientPath&&hasInjectedMetadata(values));return{clientInstrumentationApplies,webpack:buildWebpackHook(existingWebpack,targets,values,clientInstrumentationApplies),turbopack:buildTurbopackConfig(existingTurbopack,targets,values,clientInstrumentationApplies)}}function hasInjectedMetadata(metadata){return metadata.__INTERFERE_RELEASE_SLUG__!==null||metadata.__INTERFERE_PUBLIC_KEY__!==void 0}function buildWebpackHook(existingWebpack,targets,values,injectionApplies){if(!injectionApplies)return existingWebpack;let normalizedTargets=new Set(targets.map(path=>normalize(path))),injectionLoaderPath=resolveLoaderPath();return(webpackConfig,options)=>{let outputConfig=existingWebpack?existingWebpack(webpackConfig,options):webpackConfig,mutableConfig=outputConfig;return mutableConfig.module??={},mutableConfig.module.rules??=[],mutableConfig.module.rules.push({test:resource=>!!resource&&normalizedTargets.has(normalize(resource)),use:[{loader:injectionLoaderPath,options:{values}}]}),outputConfig}}function buildTurbopackConfig(existingTurbopack,targets,values,injectionApplies){let baseConfig=existingTurbopack??{},debugIds=baseConfig.debugIds??!0;if(!injectionApplies)return existingTurbopack===void 0&&debugIds===baseConfig.debugIds?existingTurbopack:{...baseConfig,debugIds};let rules={...baseConfig.rules},loaderPath=resolveLoaderPath();for(let target of targets){let ruleKey=`**/${basename(target)}`;rules[ruleKey]=appendTurbopackLoader(rules[ruleKey],{loader:loaderPath,options:{serializedValues:JSON.stringify(values)}})}return{...baseConfig,debugIds,rules}}function appendTurbopackLoader(existing,loader){let rule=existing??{},loaders=Array.isArray(rule.loaders)?rule.loaders:[];return{...rule,loaders:[...loaders,loader]}}function resolveFirstExisting(projectDir,candidates){for(let candidate of candidates){let filePath=resolve(projectDir,candidate);if(existsSync(filePath))return filePath}return null}function resolveLoaderPath(){let directory=resolve(dirname(fileURLToPath(import.meta.url)));for(let candidate of LOADER_FILE_CANDIDATES){let filePath=join(directory,candidate);if(existsSync(filePath))return filePath}return join(directory,`value-injection-loader.js`)}export{configureBuild};
+import{existsSync}from"node:fs";import{basename,dirname,join,normalize,resolve}from"node:path";import{fileURLToPath}from"node:url";const INSTRUMENTATION_CLIENT_FILES=[`instrumentation-client.ts`,`instrumentation-client.tsx`,`instrumentation-client.js`,`instrumentation-client.jsx`,`src/instrumentation-client.ts`,`src/instrumentation-client.tsx`,`src/instrumentation-client.js`,`src/instrumentation-client.jsx`],INSTRUMENTATION_SERVER_FILES=[`instrumentation.ts`,`instrumentation.tsx`,`instrumentation.js`,`instrumentation.jsx`,`src/instrumentation.ts`,`src/instrumentation.tsx`,`src/instrumentation.js`,`src/instrumentation.jsx`],LOADER_FILE_CANDIDATES=[`value-injection-loader.ts`,`value-injection-loader.js`,`value-injection-loader.mjs`,`value-injection-loader.cjs`];function configureBuild({existingWebpack,existingTurbopack,projectDir,remoteConfigFetch,values}){let clientPath=resolveFirstExisting(projectDir,INSTRUMENTATION_CLIENT_FILES),targets=[clientPath,resolveFirstExisting(projectDir,INSTRUMENTATION_SERVER_FILES)].filter(path=>path!==null),clientInstrumentationApplies=!!(clientPath&&hasInjectedMetadata(values));return{clientInstrumentationApplies,webpack:buildWebpackHook(existingWebpack,targets,values,remoteConfigFetch,clientInstrumentationApplies),turbopack:buildTurbopackConfig(existingTurbopack,targets,values,remoteConfigFetch,clientInstrumentationApplies)}}function hasInjectedMetadata(metadata){return metadata.__INTERFERE_RELEASE_SLUG__!==null||metadata.__INTERFERE_PUBLIC_KEY__!==void 0}function buildWebpackHook(existingWebpack,targets,values,remoteConfigFetch,injectionApplies){if(!injectionApplies)return existingWebpack;let normalizedTargets=new Set(targets.map(path=>normalize(path))),injectionLoaderPath=resolveLoaderPath();return(webpackConfig,options)=>{let outputConfig=existingWebpack?existingWebpack(webpackConfig,options):webpackConfig,mutableConfig=outputConfig;return mutableConfig.module??={},mutableConfig.module.rules??=[],mutableConfig.module.rules.push({test:resource=>!!resource&&normalizedTargets.has(normalize(resource)),use:[{loader:injectionLoaderPath,options:{values,...remoteConfigFetch?{fetch:remoteConfigFetch}:{}}}]}),outputConfig}}function buildTurbopackConfig(existingTurbopack,targets,values,remoteConfigFetch,injectionApplies){let baseConfig=existingTurbopack??{},debugIds=baseConfig.debugIds??!0;if(!injectionApplies)return existingTurbopack===void 0&&debugIds===baseConfig.debugIds?existingTurbopack:{...baseConfig,debugIds};let rules={...baseConfig.rules},loaderPath=resolveLoaderPath();for(let target of targets){let ruleKey=`**/${basename(target)}`;rules[ruleKey]=appendTurbopackLoader(rules[ruleKey],{loader:loaderPath,options:{serializedValues:JSON.stringify(values),...remoteConfigFetch?{serializedFetch:JSON.stringify(remoteConfigFetch)}:{}}})}return{...baseConfig,debugIds,rules}}function appendTurbopackLoader(existing,loader){let rule=existing??{},loaders=Array.isArray(rule.loaders)?rule.loaders:[];return{...rule,loaders:[...loaders,loader]}}function resolveFirstExisting(projectDir,candidates){for(let candidate of candidates){let filePath=resolve(projectDir,candidate);if(existsSync(filePath))return filePath}return null}function resolveLoaderPath(){let directory=resolve(dirname(fileURLToPath(import.meta.url)));for(let candidate of LOADER_FILE_CANDIDATES){let filePath=join(directory,candidate);if(existsSync(filePath))return filePath}return join(directory,`value-injection-loader.js`)}export{configureBuild};

package/dist/internal/build/detect-bundler.d.mts

@@ -1,5 +1,4 @@
 import { ManifestBundler } from "@interfere/types/data/source-maps";
-
 //#region src/internal/build/detect-bundler.d.ts
 type NextBuildBundler = Extract<ManifestBundler, "webpack" | "turbopack">;
 declare function detectActiveBundler(env?: Readonly<Record<string, string | undefined>>, argv?: readonly string[]): NextBuildBundler;

package/dist/internal/build/pipeline.d.mts

@@ -1,7 +1,6 @@
 import { ProductionCompileContext, ResolvedBuildConfig } from "../../config.mjs";
 import { ReleaseSlug } from "@interfere/types/releases/slug";
 import { ReleasesConfigResponse } from "@interfere/sdk/models/releases-config-response.js";
-
 //#region src/internal/build/pipeline.d.ts
 interface BuildTiming {
   cleanup: number;

package/dist/internal/build/release/destinations/cli.d.mts

@@ -1,6 +1,5 @@
 import { ReleaseSlug } from "@interfere/types/releases/slug";
 import { ReleaseDestinationMetadata } from "@interfere/types/integrations";
-
 //#region src/internal/build/release/destinations/cli.d.ts
 declare function resolve(releaseSlug: ReleaseSlug): ReleaseDestinationMetadata;
 //#endregion

package/dist/internal/build/release/destinations/cloudflare.d.mts

@@ -1,5 +1,4 @@
 import { ReleaseDestinationMetadata } from "@interfere/types/integrations";
-
 //#region src/internal/build/release/destinations/cloudflare.d.ts
 declare function resolve(): ReleaseDestinationMetadata;
 //#endregion

package/dist/internal/build/release/destinations/index.d.mts

@@ -1,6 +1,5 @@
 import { ReleaseSlug } from "@interfere/types/releases/slug";
 import { ReleaseDestinationMetadata, ReleaseDestinationProvider } from "@interfere/types/integrations";
-
 //#region src/internal/build/release/destinations/index.d.ts
 /**
  * Per-provider destination metadata resolvers. Mirrors `sources/` —

package/dist/internal/build/release/destinations/vercel.d.mts

@@ -1,5 +1,4 @@
 import { ReleaseDestinationMetadata } from "@interfere/types/integrations";
-
 //#region src/internal/build/release/destinations/vercel.d.ts
 declare function resolve(): ReleaseDestinationMetadata;
 //#endregion

package/dist/internal/build/release/index.d.mts

@@ -1,7 +1,6 @@
 import { ReleaseSlug } from "@interfere/types/releases/slug";
 import { ReleasesConfigResponse } from "@interfere/sdk/models/releases-config-response.js";
 import { CreateReleaseRequest } from "@interfere/types/releases/definition";
-
 //#region src/internal/build/release/index.d.ts
 declare function resolveReleaseRequest(buildId: string, environment: string | null, releaseSlug: ReleaseSlug, config: ReleasesConfigResponse): CreateReleaseRequest;
 //#endregion

package/dist/internal/build/release/sources/github.d.mts

@@ -1,5 +1,4 @@
 import { ReleaseSourceMetadata } from "@interfere/types/integrations";
-
 //#region src/internal/build/release/sources/github.d.ts
 type GithubReleaseSource = Extract<ReleaseSourceMetadata, {
   provider: "github";

package/dist/internal/build/release/sources/index.d.mts

@@ -1,5 +1,4 @@
 import { ReleaseSourceMetadata, SourceProvider } from "@interfere/types/integrations";
-
 //#region src/internal/build/release/sources/index.d.ts
 /**
  * Per-provider source metadata resolvers. Each entry knows how to read

package/dist/internal/build/source-maps/discover-turbopack.d.mts

@@ -1,5 +1,4 @@
 import { SourceMapFile } from "./discover.mjs";
-
 //#region src/internal/build/source-maps/discover-turbopack.d.ts
 /**
  * Turbopack-mode discovery.

package/dist/internal/build/source-maps/discover-webpack.d.mts

@@ -1,5 +1,4 @@
 import { SourceMapFile } from "./discover.mjs";
-
 //#region src/internal/build/source-maps/discover-webpack.d.ts
 declare function injectDebugIdIntoMap(content: string, debugId: string): string;
 declare function discoverWebpack(opts: {

package/dist/internal/build/source-maps/discover.d.mts

@@ -1,7 +1,6 @@
 import { NextBuildBundler } from "../detect-bundler.mjs";
 import { injectDebugIdIntoMap } from "./discover-webpack.mjs";
 import { injectDebugIdIntoJs } from "@interfere/types/data/source-maps";
-
 //#region src/internal/build/source-maps/discover.d.ts
 interface SourceMapFile {
   readonly absolute: string;

package/dist/internal/build/source-maps/index.d.mts

@@ -1,6 +1,5 @@
 import { SourceMapFile } from "./discover.mjs";
 import { uploadSourceMaps } from "./upload.mjs";
-
 //#region src/internal/build/source-maps/index.d.ts
 declare function cleanupSourceMaps(files: SourceMapFile[]): Promise<void>;
 //#endregion

package/dist/internal/build/source-maps/upload.d.mts

@@ -2,7 +2,6 @@ import { DiscoveryResult } from "./discover.mjs";
 import { ReleaseSlug } from "@interfere/types/releases/slug";
 import { HTTPClient } from "@interfere/sdk";
 import { ManifestBundler } from "@interfere/types/data/source-maps";
-
 //#region src/internal/build/source-maps/upload.d.ts
 interface UploadResult {
   fileCount: number;
@@ -28,13 +27,7 @@ interface UploadParams {
  * limits, not Cloudflare worker / load-balancer body-size caps. The
  * legacy multipart endpoint is still wired for older SDKs.
  */
-declare function uploadSourceMaps({
-  apiUrl,
-  bundler,
-  discovered,
-  httpClient,
-  releaseSlug
-}: UploadParams): Promise<UploadResult>;
+declare function uploadSourceMaps({ apiUrl, bundler, discovered, httpClient, releaseSlug }: UploadParams): Promise<UploadResult>;
 interface SourceMapRichness {
   hasSourcesContent: boolean;
   hasNames: boolean;

package/dist/internal/build/value-injection-loader.d.mts

@@ -1,13 +1,15 @@
-import { InterfereInjectedValues } from "./configure-build.mjs";
-
+import { InterfereInjectedValues, RemoteConfigFetch } from "./configure-build.mjs";
 //#region src/internal/build/value-injection-loader.d.ts
 interface ValueInjectionLoaderOptions {
+  readonly fetch?: RemoteConfigFetch;
+  readonly serializedFetch?: string;
   readonly serializedValues?: string;
   readonly values?: Partial<InterfereInjectedValues>;
 }
 interface LoaderThis<T> {
+  async(): (error: Error | null, content?: string) => void;
   getOptions(): T;
 }
-declare function valueInjectionLoader(this: LoaderThis<ValueInjectionLoaderOptions>, userCode: string): string;
+declare function valueInjectionLoader(this: LoaderThis<ValueInjectionLoaderOptions>, userCode: string): void;
 //#endregion
 export { ValueInjectionLoaderOptions, valueInjectionLoader as default };

package/dist/internal/build/value-injection-loader.mjs

@@ -1,2 +1,2 @@
-function valueInjectionLoader(userCode){let values=resolveValues(this.getOptions()),lines=Object.entries(values).filter(([,value])=>value!==void 0).map(([key,value])=>`globalThis["${key.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`)}"] = ${JSON.stringify(value)};`);return lines.length===0?userCode:`${lines.join(`
-`)}\n${userCode}`}function resolveValues(options){if(typeof options.serializedValues==`string`)try{let parsed=JSON.parse(options.serializedValues);return isRecord(parsed)?parsed:{}}catch{return{}}return options.values??{}}function isRecord(value){return typeof value==`object`&&!!value&&!Array.isArray(value)}export{valueInjectionLoader as default};
+import{SERVER_TRACING_GLOBAL}from"@interfere/types/sdk/server-tracing";import{PLUGINS_GLOBAL}from"@interfere/types/sdk/remote-config";import{LOG_SOURCING_GLOBAL}from"@interfere/types/sdk/log-sourcing";let remoteConfigPromise=null;function valueInjectionLoader(userCode){let options=this.getOptions(),callback=this.async(),values=resolveValues(options);resolveRemoteConfig(resolveFetch(options)).then(config=>{callback(null,render({...values,...bakedGlobals(config)},userCode))}).catch(()=>callback(null,render(values,userCode)))}function bakedGlobals(config){return config?{...config.serverTracing?{[SERVER_TRACING_GLOBAL]:config.serverTracing}:{},...config.logSourcing?{[LOG_SOURCING_GLOBAL]:config.logSourcing}:{},...config.ingestUrl?{__INTERFERE_INGEST_URL__:config.ingestUrl}:{},...config.plugins?{[PLUGINS_GLOBAL]:config.plugins}:{}}:{}}function render(values,userCode){let lines=Object.entries(values).filter(([,value])=>value!==void 0).map(([key,value])=>`globalThis["${key.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`)}"] = ${JSON.stringify(value)};`);return lines.length===0?userCode:`${lines.join(`
+`)}\n${userCode}`}function resolveRemoteConfig(fetchOptions){return fetchOptions?(remoteConfigPromise??=fetchRemoteConfig(fetchOptions),remoteConfigPromise):Promise.resolve(null)}async function fetchRemoteConfig(fetchOptions){try{let url=`${fetchOptions.apiUrl}/v2/config?pk=${encodeURIComponent(fetchOptions.publicKey)}`,response=await fetch(url,{method:`GET`,headers:{"content-type":`application/json`},signal:AbortSignal.timeout(3e3)});if(!response.ok)return null;let config=await response.json();return{...config.serverTracing===`full`||config.serverTracing===`drain`?{serverTracing:config.serverTracing}:{},...config.logSourcing===`sdk`||config.logSourcing===`drain`?{logSourcing:config.logSourcing}:{},...typeof config.ingestUrl==`string`&&config.ingestUrl.length>0?{ingestUrl:config.ingestUrl}:{},...isRecord(config.plugins)?{plugins:config.plugins}:{}}}catch{return null}}function resolveFetch(options){if(options.fetch)return options.fetch;if(typeof options.serializedFetch==`string`)try{let parsed=JSON.parse(options.serializedFetch);if(isRemoteConfigFetch(parsed))return parsed}catch{return null}return null}function isRemoteConfigFetch(value){return isRecord(value)&&typeof value.apiUrl==`string`&&typeof value.publicKey==`string`}function resolveValues(options){if(typeof options.serializedValues==`string`)try{let parsed=JSON.parse(options.serializedValues);return isRecord(parsed)?parsed:{}}catch{return{}}return options.values??{}}function isRecord(value){return typeof value==`object`&&!!value&&!Array.isArray(value)}export{valueInjectionLoader as default};

package/dist/internal/env.mjs

@@ -1 +1 @@
-import{API_URL}from"@interfere/constants/api";import{parseEnvValue}from"@interfere/types/sdk/env";import{resolveEnvironment}from"@interfere/types/sdk/runtime";function isEnabledOnServer(){return process.env.NODE_ENV===`production`?!0:!!process.env.NEXT_PUBLIC_INTERFERE_FORCE_ENABLE}function readInterfereEnv(){let nodeEnvironment=resolveEnvironment({env:process.env});return{apiKey:parseEnvValue(process.env.INTERFERE_API_KEY),apiUrl:parseEnvValue(process.env.INTERFERE_API_URL)??API_URL,nextRuntime:parseEnvValue(process.env.NEXT_RUNTIME),nodeEnvironment,publicKey:parseEnvValue(process.env.INTERFERE_PUBLIC_KEY),release:{sourceId:parseEnvValue(process.env.NEXT_PUBLIC_INTERFERE_BUILD_ID),destinationId:parseEnvValue(process.env.NEXT_PUBLIC_INTERFERE_RELEASE_ID)}}}export{isEnabledOnServer,readInterfereEnv};
+import{API_URL}from"@interfere/constants/api";import{parseEnvValue}from"@interfere/types/sdk/env";import{resolveEnvironment}from"@interfere/types/sdk/runtime";function isEnabledOnServer(){return process.env.NODE_ENV===`production`||!!process.env.NEXT_PUBLIC_INTERFERE_FORCE_ENABLE}function readInterfereEnv(){let nodeEnvironment=resolveEnvironment({env:process.env});return{apiKey:parseEnvValue(process.env.INTERFERE_API_KEY),apiUrl:parseEnvValue(process.env.INTERFERE_API_URL)??API_URL,nextRuntime:parseEnvValue(process.env.NEXT_RUNTIME),nodeEnvironment,publicKey:parseEnvValue(process.env.INTERFERE_PUBLIC_KEY),release:{sourceId:parseEnvValue(process.env.NEXT_PUBLIC_INTERFERE_BUILD_ID),destinationId:parseEnvValue(process.env.NEXT_PUBLIC_INTERFERE_RELEASE_ID)}}}export{isEnabledOnServer,readInterfereEnv};

package/dist/internal/release-slug.d.mts

@@ -1,5 +1,4 @@
 import { ReleaseSlug } from "@interfere/types/releases/slug";
-
 //#region src/internal/release-slug.d.ts
 declare function resolveReleaseSlug(): {
   commitSha: string | null;

package/dist/internal/server/capture.d.mts

@@ -1,5 +1,4 @@
 import { CaptureErrorContext, OnRequestErrorContext } from "./types.mjs";
-
 //#region src/internal/server/capture.d.ts
 declare function captureError(error: unknown, _request?: unknown, context?: CaptureErrorContext): void;
 interface OnRequestErrorRequest {

package/dist/internal/server/edge-exporter.d.mts

@@ -1,6 +1,5 @@
 import { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
 import { ExportResult } from "@opentelemetry/core";
-
 //#region src/internal/server/edge-exporter.d.ts
 declare class FetchTraceExporter implements SpanExporter {
   private readonly url;

package/dist/internal/server/id-generator.d.mts

@@ -1,5 +1,4 @@
 import { IdGenerator } from "@opentelemetry/sdk-trace-base";
-
 //#region src/internal/server/id-generator.d.ts
 /**
  * IdGenerator hybrid that uses OTel's default `RandomIdGenerator` whenever

package/dist/internal/server/instrumentation-options.d.mts

@@ -1,7 +1,5 @@
 import { SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
-import { MetricReader } from "@opentelemetry/sdk-metrics";
-
 //#region src/internal/server/instrumentation-options.d.ts
 /**
  * Per-instrumentation tuning for the server-side `register()`. Mirrors
@@ -17,9 +15,8 @@ import { MetricReader } from "@opentelemetry/sdk-metrics";
  * compatible so customer code compiles unchanged when bundled for either
  * runtime.
  *
- * `LogRecordProcessor`, `MetricReader`, and `SpanProcessor` come from
- * the OTel "base" packages (`@opentelemetry/sdk-logs`,
- * `@opentelemetry/sdk-metrics`, `@opentelemetry/sdk-trace-base`),
+ * `LogRecordProcessor` and `SpanProcessor` come from the OTel "base"
+ * packages (`@opentelemetry/sdk-logs`, `@opentelemetry/sdk-trace-base`),
  * which are edge-safe at the import level. They're also `import type` here
  * so they're erased before bundling — the Edge runtime bundle never sees
  * them at all.
@@ -35,18 +32,6 @@ interface ServerInstrumentationOptions {
    * SDK surface; this is a private bridge for our own dogfood apps.
    */
   _internalAdditionalLogRecordProcessors?: LogRecordProcessor[];
-  /**
-   * @internal
-   *
-   * Extra metric readers fanned into the MeterProvider's reader list.
-   * See `_internalAdditionalLogRecordProcessors`. Used to keep
-   * `http.client.request.duration` (from `UndiciInstrumentation`) and
-   * any first-party `metrics.getMeter(...)` counters landing on the
-   * BetterStack-fronting OTel collector after the `@vercel/otel` →
-   * `@interfere/next` migration removed the default metric reader
-   * `registerOTel({ metricReader: "auto" })` used to install.
-   */
-  _internalAdditionalMetricReaders?: MetricReader[];
   /**
    * @internal
    *
@@ -68,6 +53,11 @@ interface ServerInstrumentationOptions {
    * to run your own handler.
    */
   captureUnhandledRejection?: boolean;
+  /**
+   * OTLP payload compression. Default `"none"`. `"gzip"` shrinks each
+   * `/v2/sink` POST body.
+   */
+  compression?: "gzip" | "none";
   /**
    * `false` disables the `console.*` → OTel `LogRecord` bridge.
    * Defaults to enabled. Customers running their own structured
@@ -75,21 +65,6 @@ interface ServerInstrumentationOptions {
    * opt out to avoid double-emit.
    */
   consoleBridge?: boolean;
-  /**
-   * URL patterns the undici fetch instrumentation skips (no spans
-   * created for these). The collector OTLP endpoint is always
-   * skipped automatically — without this the SDK would trace its
-   * own export requests in an infinite loop.
-   */
-  ignoreUrls?: (string | RegExp)[];
-  /**
-   * URL patterns the undici fetch instrumentation injects W3C
-   * `traceparent` + `baggage` headers on for cross-process trace
-   * correlation. Same-origin requests aren't a concept on the server
-   * the way they are in a browser, so the allowlist is the only
-   * propagation control.
-   */
-  propagateContextUrls?: (string | RegExp)[];
   /**
    * Override the OTel `service.name` resource attribute. Defaults to
    * `"interfere-sdk-next-server"`.

package/dist/internal/server/remote-config.mjs

@@ -1 +1 @@
-import{isEnabledOnServer,readInterfereEnv}from"../env.mjs";import{withPublicKey}from"../url.mjs";import{API_PATHS}from"@interfere/constants/api";let cachedConfig=null;async function fetchAndCacheRemoteConfig(){if(!isEnabledOnServer())return;let env=readInterfereEnv();if(env.publicKey!==null)try{let url=withPublicKey(`${env.apiUrl}${API_PATHS.CONFIG}`,env.publicKey),response=await fetch(url,{method:`GET`,headers:{"content-type":`application/json`},signal:AbortSignal.timeout(1e4)});if(!response.ok)return;let config=await response.json();config?.plugins&&(cachedConfig=config.plugins)}catch{return}}function isPluginEnabled(plugin){return cachedConfig?cachedConfig[plugin]!==!1:!0}export{fetchAndCacheRemoteConfig,isPluginEnabled};
+import{isEnabledOnServer,readInterfereEnv}from"../env.mjs";import{withPublicKey}from"../url.mjs";import{API_PATHS}from"@interfere/constants/api";import{readBakedPlugins}from"@interfere/types/sdk/remote-config";let cachedConfig=null;async function fetchAndCacheRemoteConfig(){if(readBakedPlugins()||!isEnabledOnServer())return;let env=readInterfereEnv();if(env.publicKey!==null)try{let url=withPublicKey(`${env.apiUrl}${API_PATHS.CONFIG}`,env.publicKey),response=await fetch(url,{method:`GET`,headers:{"content-type":`application/json`},signal:AbortSignal.timeout(1e4)});if(!response.ok)return;let config=await response.json();config?.plugins&&(cachedConfig=config.plugins)}catch{return}}function isPluginEnabled(plugin){let config=readBakedPlugins()??cachedConfig;return!config||config[plugin]!==!1}export{fetchAndCacheRemoteConfig,isPluginEnabled};

package/dist/internal/server/types.d.mts

@@ -1,6 +1,5 @@
 import { NextjsContext } from "@interfere/types/sdk/plugins/context/next";
 import { ErrorMechanism } from "@interfere/types/sdk/plugins/payload/errors";
-
 //#region src/internal/server/types.d.ts
 type OnRequestErrorContext = Omit<NextjsContext, "errorDigest" | "requestMethod" | "requestPath" | "runtime">;
 interface CaptureErrorContext {

package/dist/internal/server/wrap-proxy.d.mts

@@ -1,5 +1,4 @@
 import { NextMiddleware } from "next/server.js";
-
 //#region src/internal/server/wrap-proxy.d.ts
 /**
  * Wraps a Next.js proxy (formerly `middleware`) so thrown errors are captured

package/dist/package.mjs

@@ -1 +1 @@
-var name=`@interfere/next`,version=`11.0.0`;export{name,version};
+var name=`@interfere/next`,version=`11.0.3`;export{name,version};

package/dist/provider.d.mts

@@ -1,11 +1,11 @@
-import { useInterfere, useSession } from "@interfere/react/provider";
+import { PluginOverrides, useInterfere, useSession } from "@interfere/react/provider";
 import { PropsWithChildren, ReactNode } from "react";
 import { ConsentCategory, ConsentState, ConsentState as ConsentState$1, GateableCategory } from "@interfere/types/sdk/plugins/manifest";
-
 //#region src/provider.d.ts
 interface InterfereProviderProps extends PropsWithChildren {
   consent?: ConsentState$1 | undefined;
   errorBoundary?: boolean;
+  plugins?: PluginOverrides | undefined;
 }
 /**
  * Next.js wrapper around `@interfere/react`'s provider that resolves the
@@ -15,10 +15,6 @@ interface InterfereProviderProps extends PropsWithChildren {
  * (`init()` is client-only); the core provider mounts with null-safe
  * accessors and switches to the real kernel on client hydration.
  */
-declare function InterfereProvider({
-  children,
-  consent,
-  errorBoundary
-}: InterfereProviderProps): ReactNode;
+declare function InterfereProvider({ children, consent, plugins, errorBoundary }: InterfereProviderProps): ReactNode;
 //#endregion
 export { type ConsentCategory, type ConsentState, type GateableCategory, InterfereProvider, useInterfere, useSession };

package/dist/provider.mjs

@@ -1 +1 @@
-"use client";import{getKernelOrNull,subscribeToKernel}from"./instrument-client.mjs";import{InterfereProvider as InterfereProvider$1,useInterfere,useSession}from"@interfere/react/provider";import{useSyncExternalStore}from"react";import{jsx}from"react/jsx-runtime";const nullSnapshot=()=>null;function InterfereProvider({children,consent,errorBoundary}){return jsx(InterfereProvider$1,{kernel:useSyncExternalStore(subscribeToKernel,getKernelOrNull,nullSnapshot),...consent===void 0?{}:{consent},...errorBoundary===void 0?{}:{errorBoundary},children})}export{InterfereProvider,useInterfere,useSession};
+"use client";import{getKernelOrNull,subscribeToKernel}from"./instrument-client.mjs";import{omitUndefined}from"@interfere/helpers/omit-undefined";import{InterfereProvider as InterfereProvider$1,useInterfere,useSession}from"@interfere/react/provider";import{useSyncExternalStore}from"react";import{jsx}from"react/jsx-runtime";const nullSnapshot=()=>null;function InterfereProvider({children,consent,plugins,errorBoundary}){return jsx(InterfereProvider$1,{kernel:useSyncExternalStore(subscribeToKernel,getKernelOrNull,nullSnapshot),...omitUndefined({consent,plugins,errorBoundary}),children})}export{InterfereProvider,useInterfere,useSession};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/next",
-  "version": "11.0.0",
+  "version": "11.0.3",
   "license": "MIT",
   "description": "Build software that never breaks.",
   "keywords": [
@@ -93,25 +93,23 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@interfere/constants": "^9.0.2-canary.3",
-    "@interfere/helpers": "^9.0.1-canary.2",
-    "@interfere/react": "^11.0.0-canary.7",
-    "@interfere/sdk": "^11.0.0-canary.7",
-    "@interfere/types": "^10.0.0-canary.6",
+    "@interfere/constants": "^9.0.3",
+    "@interfere/helpers": "^9.0.3",
+    "@interfere/react": "^11.0.3",
+    "@interfere/sdk": "^11.0.3",
+    "@interfere/types": "^10.0.1",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/api-logs": "^0.219.0",
     "@opentelemetry/baggage-span-processor": "^0.5.0",
     "@opentelemetry/context-async-hooks": "^2.7.1",
     "@opentelemetry/core": "^2.7.0",
     "@opentelemetry/exporter-logs-otlp-http": "^0.219.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.219.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
     "@opentelemetry/instrumentation": "^0.219.0",
-    "@opentelemetry/instrumentation-undici": "^0.29.0",
+    "@opentelemetry/otlp-exporter-base": "^0.219.0",
     "@opentelemetry/otlp-transformer": "^0.219.0",
     "@opentelemetry/resources": "^2.7.0",
     "@opentelemetry/sdk-logs": "^0.219.0",
-    "@opentelemetry/sdk-metrics": "^2.7.0",
     "@opentelemetry/sdk-trace-base": "^2.7.0",
     "@opentelemetry/sdk-trace-node": "^2.7.1",
     "chalk": "^5.6.2"
@@ -133,8 +131,8 @@
     }
   },
   "devDependencies": {
-    "@interfere/test-utils": "^9.0.1-canary.2",
-    "@interfere/typescript-config": "^9.0.1-canary.1",
+    "@interfere/test-utils": "^9.0.4",
+    "@interfere/typescript-config": "^9.0.1",
     "@types/node": "^26.1.0",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",