@interfere/next 12.3.1 → 12.4.0

package/README.md

@@ -155,34 +155,37 @@ The mode and the hosting platform come only from the surface configuration that
 
 ### Composing with an existing Vercel OTel setup
 
-Use the kit instead of calling Interfere's standalone `register()` alongside `registerOTel()`. For a Vercel deployment with a configured Trace Drain:
+Use the kit instead of calling Interfere's standalone `register()` alongside `registerOTel()`:
 
 ```ts
 import { registerOTel } from "@vercel/otel";
 import { buildInterfereOtelKit } from "@interfere/next/instrumentation";
 
-export function register() {
-  const kit = buildInterfereOtelKit({ serverTracing: "drain" });
+export { onRequestError } from "@interfere/next/instrumentation";
 
-  if (!kit) return;
+export function register() {
+  const kit = buildInterfereOtelKit({ serviceName: "my-app" });
 
   registerOTel({
     serviceName: "my-app",
-    attributes: kit.resourceAttributes,
-    idGenerator: kit.idGenerator,
-    spanProcessors: ["auto", ...kit.spanProcessors],
-    logRecordProcessors: kit.logRecordProcessors,
-    propagators: ["auto", kit.traceContextPropagator, ...kit.propagators],
-    instrumentations: ["auto", ...kit.instrumentations],
+    attributes: { ...kit?.resourceAttributes },
+    ...(kit && { idGenerator: kit.idGenerator }),
+    spanProcessors: ["auto", ...(kit?.spanProcessors ?? [])],
+    logRecordProcessors: [...(kit?.logRecordProcessors ?? [])],
+    propagators: [
+      "auto",
+      ...(kit ? [kit.traceContextPropagator, ...kit.propagators] : []),
+    ],
   });
 
-  kit.enableConsoleBridge();
+  kit?.enableConsoleBridge();
+  void kit?.fetchRemoteConfig();
 }
-
-export { onRequestError } from "@interfere/next/instrumentation";
 ```
 
-Keep `"auto"` in `spanProcessors` for Vercel drain delivery. For direct Interfere export through a customer-owned provider, use `serverTracing: "full"` and `spanProcessors: kit.spanProcessors` to choose a single export path. The host owns flushing and shutdown in composed setups.
+The kit returns `null` when `INTERFERE_PUBLIC_KEY` is unset and on the Edge runtime, so the optional chaining keeps `registerOTel()` working in both cases. Keep the propagators in this order: the freshness propagator must run last.
+
+The build-injected surface configuration selects the export path; there is no option to set. With a Vercel Trace Drain, the kit leaves out its trace exporter and `"auto"` delivers spans to the drain, so keep `"auto"` in `spanProcessors`. Without a drain, the kit's span processors export to Interfere directly; do not also point the `OTEL_EXPORTER_OTLP_*` variables at Interfere. The host owns flushing and shutdown in composed setups.
 
 `@vercel/otel@2.1.3` supports OTel API `>=1.9.0 <2`, stable SDK peers `>=2 <3`, and experimental peers `>=0.200.0 <0.300.0`. The SDK declares all required peers as dependencies, including `sdk-metrics`. Custom compositions must use compatible versions too.
 

package/dist/package.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/next",
-  "version": "12.3.1",
+  "version": "12.4.0",
   "description": "Build software that never breaks.",
   "keywords": [
     "error-tracking",
@@ -92,17 +92,18 @@
   },
   "scripts": {
     "build": "tsdown",
+    "lint:oxlint": "cd ../../../.. && GOMAXPROCS=2 oxlint --max-warnings=0 --report-unused-disable-directives-severity=error --no-error-on-unmatched-pattern --threads=2 src/packages/public/next",
     "test": "node ../../private/vitest-config/src/cli.ts run --config ../../../../vitest.config.ts",
     "test:e2e": "playwright test",
     "typecheck": "bun check"
   },
   "dependencies": {
-    "@interfere/build": "^0.4.1",
+    "@interfere/build": "^0.4.2",
     "@interfere/constants": "^9.3.0",
     "@interfere/helpers": "^9.3.0",
     "@interfere/javascript": "^0.3.1",
-    "@interfere/react": "^12.3.1",
-    "@interfere/types": "^10.5.1",
+    "@interfere/react": "^12.4.0",
+    "@interfere/types": "^10.6.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/api-logs": "0.222.0",
     "@opentelemetry/baggage-span-processor": "0.5.0",