@interfere/next 9.0.2 → 10.0.0

package/dist/instrumentation.mjs

@@ -0,0 +1,165 @@
+import { readInterfereEnv } from "./internal/env.mjs";
+import { resolveReleaseSlug } from "./internal/release-slug.mjs";
+import { PRODUCER_VERSION } from "./internal/version.mjs";
+import { bridgeConsoleToOtel } from "./internal/server/console-bridge.mjs";
+import { PrerenderSafeIdGenerator } from "./internal/server/id-generator.mjs";
+import { fetchAndCacheRemoteConfig } from "./internal/server/remote-config.mjs";
+import { metrics, propagation } from "@opentelemetry/api";
+import { BaggageSpanProcessor } from "@opentelemetry/baggage-span-processor";
+import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
+import { CompositePropagator, W3CBaggagePropagator, W3CTraceContextPropagator } from "@opentelemetry/core";
+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 { resourceFromAttributes } from "@opentelemetry/resources";
+import { BatchLogRecordProcessor, LoggerProvider } from "@opentelemetry/sdk-logs";
+import { MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+//#region src/instrumentation.ts
+const DEFAULT_SERVICE_NAME = "interfere-sdk-next-server";
+const SERVICE_NAMESPACE = "interfere";
+let registered = false;
+function matchesAny(url, patterns) {
+	for (const pattern of patterns) if (pattern instanceof RegExp ? pattern.test(url) : url.includes(pattern)) return true;
+	return false;
+}
+/**
+* Pure factory — no global registration, no provider construction. Returns
+* the OTel primitives the SDK contributes so a host bootstrap (Vercel,
+* DataDog, custom) can compose them in.
+*
+* Returns `null` when `INTERFERE_API_KEY` isn't set, so callers can
+* unconditionally spread `kit?.spanProcessors ?? []` in dev where the
+* SDK isn't configured.
+*/
+function buildInterfereOtelKit(opts = {}) {
+	const env = readInterfereEnv();
+	if (!env.apiKey) return null;
+	const { slug: releaseSlug } = resolveReleaseSlug();
+	if (!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.");
+	const sinkUrl = `${env.apiUrl}/v2/sink`;
+	const ignoreUrls = [sinkUrl, ...opts.ignoreUrls ?? []];
+	const propagateContextUrls = opts.propagateContextUrls ?? [];
+	const exporterHeaders = {
+		"x-api-key": env.apiKey,
+		"x-interfere-producer-version": PRODUCER_VERSION
+	};
+	return {
+		resourceAttributes: {
+			"service.name": opts.serviceName ?? DEFAULT_SERVICE_NAME,
+			"service.namespace": SERVICE_NAMESPACE,
+			"deployment.environment.name": env.nodeEnvironment ?? "unknown",
+			"telemetry.sdk.language": "nodejs",
+			"interfere.sdk.name": "@interfere/next",
+			"interfere.sdk.version": PRODUCER_VERSION,
+			...releaseSlug ? { "release.slug": releaseSlug } : {}
+		},
+		spanProcessors: [
+			new BaggageSpanProcessor(() => true),
+			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) => {
+				return matchesAny(`${req.origin}${req.path}`, ignoreUrls);
+			},
+			requestHook: (span, req) => {
+				if (matchesAny(`${req.origin}${req.path}`, propagateContextUrls)) span.setAttribute("interfere.propagated", true);
+			}
+		})],
+		enableConsoleBridge: () => bridgeConsoleToOtel(),
+		fetchRemoteConfig: () => fetchAndCacheRemoteConfig()
+	};
+}
+/**
+* One-line server-side bootstrap for Next.js. Customers' `instrumentation.ts`
+* becomes:
+*
+* ```ts
+* export { register } from "@interfere/next/instrumentation";
+* ```
+*
+* Or, with overrides:
+*
+* ```ts
+* import { register as base } from "@interfere/next/instrumentation";
+* export const register = () => base({ serviceName: "@my-org/api" });
+* ```
+*
+* Customers who already run another OTel bootstrap (`@vercel/otel`,
+* DataDog `dd-trace-js`, custom `NodeTracerProvider`) should use
+* `buildInterfereOtelKit({...})` instead and compose the returned
+* processors / readers / propagators into their existing setup —
+* see the kit's JSDoc for examples.
+*
+* Constructs private `NodeTracerProvider` / `LoggerProvider` /
+* `MeterProvider` and registers them on the global slots. Last writer
+* wins on the globals, so customers running another OTel bootstrap
+* alongside this one will end up with whichever booted last; the kit
+* path avoids that fight entirely.
+*
+* Wired against the Node OTel SDK (`NodeTracerProvider`,
+* `AsyncLocalStorageContextManager`) — so this entry only ships into the
+* `nodejs` runtime bundle. The Edge runtime gets the no-op stub at
+* `instrumentation.edge.ts` via `package.json`'s `edge-light` /
+* `workerd` export conditions.
+*
+* Idempotent — repeat calls (e.g. HMR) short-circuit on the
+* module-scoped `registered` flag.
+*
+* Bails silently when `INTERFERE_API_KEY` is unset so dev runs without
+* the SDK configured don't crash.
+*/
+async function register(opts = {}) {
+	if (registered) return;
+	const kit = buildInterfereOtelKit(opts);
+	if (!kit) return;
+	const resource = resourceFromAttributes(kit.resourceAttributes);
+	const tracerProvider = new NodeTracerProvider({
+		resource,
+		spanProcessors: kit.spanProcessors,
+		idGenerator: new PrerenderSafeIdGenerator()
+	});
+	if (propagation.fields().length === 0) propagation.setGlobalPropagator(new CompositePropagator({ propagators: [new W3CTraceContextPropagator(), ...kit.propagators] }));
+	tracerProvider.register({ contextManager: new AsyncLocalStorageContextManager().enable() });
+	const loggerProvider = new LoggerProvider({
+		resource,
+		processors: kit.logRecordProcessors
+	});
+	const { logs: logsApi } = await import("@opentelemetry/api-logs");
+	logsApi.setGlobalLoggerProvider(loggerProvider);
+	const meterProvider = new MeterProvider({
+		resource,
+		readers: kit.metricReaders
+	});
+	metrics.setGlobalMeterProvider(meterProvider);
+	registerInstrumentations({
+		tracerProvider,
+		meterProvider,
+		instrumentations: kit.instrumentations
+	});
+	if (opts.consoleBridge !== false) kit.enableConsoleBridge();
+	registered = true;
+	await kit.fetchRemoteConfig();
+}
+//#endregion
+export { PrerenderSafeIdGenerator, buildInterfereOtelKit, register };

package/dist/instrumentation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.mjs","names":[],"sources":["../src/instrumentation.ts"],"sourcesContent":["import type {\n  AttributeValue,\n  Span,\n  TextMapPropagator,\n} from \"@opentelemetry/api\";\nimport { metrics, propagation } from \"@opentelemetry/api\";\nimport { BaggageSpanProcessor } from \"@opentelemetry/baggage-span-processor\";\nimport { AsyncLocalStorageContextManager } from \"@opentelemetry/context-async-hooks\";\nimport {\n  CompositePropagator,\n  W3CBaggagePropagator,\n  W3CTraceContextPropagator,\n} from \"@opentelemetry/core\";\nimport { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport {\n  AggregationTemporalityPreference,\n  OTLPMetricExporter,\n} from \"@opentelemetry/exporter-metrics-otlp-http\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport {\n  type Instrumentation,\n  registerInstrumentations,\n} from \"@opentelemetry/instrumentation\";\nimport { UndiciInstrumentation } from \"@opentelemetry/instrumentation-undici\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport {\n  BatchLogRecordProcessor,\n  LoggerProvider,\n  type LogRecordProcessor,\n} from \"@opentelemetry/sdk-logs\";\nimport {\n  MeterProvider,\n  type MetricReader,\n  PeriodicExportingMetricReader,\n} from \"@opentelemetry/sdk-metrics\";\nimport {\n  BatchSpanProcessor,\n  type SpanProcessor,\n} from \"@opentelemetry/sdk-trace-base\";\nimport { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\n\nimport { readInterfereEnv } from \"./internal/env.js\";\nimport { resolveReleaseSlug } from \"./internal/release-slug.js\";\nimport { bridgeConsoleToOtel } from \"./internal/server/console-bridge.js\";\nimport { PrerenderSafeIdGenerator } from \"./internal/server/id-generator.js\";\nimport type { ServerInstrumentationOptions } from \"./internal/server/instrumentation-options.js\";\nimport { fetchAndCacheRemoteConfig } from \"./internal/server/remote-config.js\";\nimport { PRODUCER_VERSION } from \"./internal/version.js\";\n\nexport { PrerenderSafeIdGenerator } from \"./internal/server/id-generator.js\";\nexport type { ServerInstrumentationOptions } from \"./internal/server/instrumentation-options.js\";\n\nconst DEFAULT_SERVICE_NAME = \"interfere-sdk-next-server\";\nconst SERVICE_NAMESPACE = \"interfere\";\n\nlet registered = false;\n\nfunction matchesAny(url: string, patterns: (string | RegExp)[]): boolean {\n  for (const pattern of patterns) {\n    if (pattern instanceof RegExp ? pattern.test(url) : url.includes(pattern)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Composable building blocks the Interfere SDK contributes to OTel —\n * span / log / metric processors, baggage propagator, undici\n * instrumentation, plus the resource attributes and side-effect\n * installers (console bridge + remote-config fetch).\n *\n * Use this when you want to plug Interfere into an existing OTel\n * bootstrap (e.g. `@vercel/otel`'s `registerOTel({...})`, DataDog's\n * `dd-trace-js`, or any custom `NodeTracerProvider` setup) instead of\n * the standalone `register()` path. The kit holds no global state and\n * touches no global slots — composition is the consumer's job.\n *\n * The standalone `register()` builds the kit internally and wires it\n * into private providers, so customer DX stays a one-liner export.\n *\n * Returns `null` when `INTERFERE_API_KEY` is unset — callers can spread\n * `kit?.spanProcessors ?? []` without a no-op guard.\n */\nexport interface InterfereOtelKit {\n  /**\n   * Patches `console.{debug,log,info,warn,error}` to also emit OTel\n   * `LogRecord`s via the global `LoggerProvider`. Caller is responsible\n   * for ensuring a `LoggerProvider` is registered globally before\n   * calling — `register()` handles this; for composed setups, call\n   * after your bootstrap (`registerOTel({...})` etc.) has run. Returns\n   * a disposer that restores the original `console.*` methods.\n   */\n  enableConsoleBridge: () => () => void;\n  /**\n   * Fetches the SDK's remote plugin config and caches it for the\n   * runtime. Customer code's `isPluginEnabled(...)` checks read from\n   * the cache. Safe to call repeatedly.\n   */\n  fetchRemoteConfig: () => Promise<void>;\n  /**\n   * Instrumentations the SDK ships. Currently `UndiciInstrumentation`\n   * pre-configured with `propagateContextUrls` / `ignoreUrls` semantics\n   * from `ServerInstrumentationOptions`.\n   *\n   * **Composition with `@vercel/otel`**: `instrumentations: [\"auto\"]`\n   * registers Vercel's `globalThis.fetch` wrapper, which only\n   * auto-propagates `traceparent` to Vercel deployment URLs — outbound\n   * fetches to a different origin (e.g. `in.interfere.com`) get a\n   * span but no header injection unless\n   * `instrumentationConfig.fetch.propagateContextUrls` is set, and\n   * even then it doesn't cover the lower-level undici dispatcher path\n   * Next.js route handlers use. Spread `kit.instrumentations` after\n   * `\"auto\"` to layer this UndiciInstrumentation on top — propagation\n   * extends to every outbound undici call (filtered via `ignoreUrls`).\n   * Risk of double span emission on overlapping call sites is bounded:\n   * Vercel's fetch wraps `globalThis.fetch`, this hooks the undici\n   * dispatcher one layer lower, so duplicates only appear when both\n   * paths actually fire on the same call.\n   */\n  instrumentations: Instrumentation[];\n  logRecordProcessors: LogRecordProcessor[];\n  metricReaders: MetricReader[];\n  /**\n   * W3C baggage propagator. Trace context is intentionally *not*\n   * included — `@vercel/otel`'s `propagators: [\"auto\"]` already\n   * registers it, and standalone `register()` adds it itself when\n   * the global slot is empty. Composing this on top extends rather\n   * than overrides.\n   */\n  propagators: TextMapPropagator[];\n  /**\n   * Pre-built resource attribute set. Pass into your provider's\n   * `Resource` directly, or into `@vercel/otel`'s `attributes` field\n   * (which merges with Vercel's own auto-detected `vercel.*` attrs).\n   */\n  resourceAttributes: Record<string, AttributeValue>;\n  spanProcessors: SpanProcessor[];\n}\n\n/**\n * Pure factory — no global registration, no provider construction. Returns\n * the OTel primitives the SDK contributes so a host bootstrap (Vercel,\n * DataDog, custom) can compose them in.\n *\n * Returns `null` when `INTERFERE_API_KEY` isn't set, so callers can\n * unconditionally spread `kit?.spanProcessors ?? []` in dev where the\n * SDK isn't configured.\n */\nexport function buildInterfereOtelKit(\n  opts: ServerInstrumentationOptions = {}\n): InterfereOtelKit | null {\n  const env = readInterfereEnv();\n  if (!env.apiKey) {\n    return null;\n  }\n\n  const { slug: releaseSlug } = resolveReleaseSlug();\n  if (!releaseSlug) {\n    console.warn(\n      \"[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.\"\n    );\n  }\n\n  const sinkUrl = `${env.apiUrl}/v2/sink`;\n  // Always-on ignore: the OTLP exporter posting to /v2/sink would\n  // otherwise be re-traced by UndiciInstrumentation in an infinite\n  // loop.\n  const ignoreUrls = [sinkUrl, ...(opts.ignoreUrls ?? [])];\n  const propagateContextUrls = opts.propagateContextUrls ?? [];\n\n  const exporterHeaders: Record<string, string> = {\n    \"x-api-key\": env.apiKey,\n    \"x-interfere-producer-version\": PRODUCER_VERSION,\n  };\n\n  const resourceAttributes: Record<string, AttributeValue> = {\n    \"service.name\": opts.serviceName ?? DEFAULT_SERVICE_NAME,\n    \"service.namespace\": SERVICE_NAMESPACE,\n    \"deployment.environment.name\": env.nodeEnvironment ?? \"unknown\",\n    \"telemetry.sdk.language\": \"nodejs\",\n    \"interfere.sdk.name\": \"@interfere/next\",\n    \"interfere.sdk.version\": PRODUCER_VERSION,\n    ...(releaseSlug ? { \"release.slug\": releaseSlug } : {}),\n  };\n\n  // `BaggageSpanProcessor` runs at span start (before the batch\n  // processor schedules export) so every span carries the full baggage\n  // attribute set when batched. Default `keyFilter` accepts everything;\n  // browser SDK only writes `interfere.*`-prefixed entries via baggage\n  // propagation, so the server side stays scoped without an explicit\n  // filter.\n  const spanProcessors: SpanProcessor[] = [\n    new BaggageSpanProcessor(() => true),\n    new BatchSpanProcessor(\n      new OTLPTraceExporter({ url: sinkUrl, headers: exporterHeaders })\n    ),\n    ...(opts._internalAdditionalSpanProcessors ?? []),\n  ];\n\n  const logRecordProcessors: LogRecordProcessor[] = [\n    new BatchLogRecordProcessor(\n      new OTLPLogExporter({ url: sinkUrl, headers: exporterHeaders })\n    ),\n    ...(opts._internalAdditionalLogRecordProcessors ?? []),\n  ];\n\n  // `DELTA` temporality matches what `@vercel/otel`'s default\n  // `metricReader: \"auto\"` used to install (see vercel/otel\n  // `defaultMetricReader`) so the wire shape downstream consumers\n  // (ClickHouse via Tinybird, the OTel collector's BetterStack export)\n  // receive is unchanged across the migration. The 30s interval matches\n  // the browser SDK's primary metric reader so server + client\n  // datapoints land at the same cadence.\n  const metricReaders: MetricReader[] = [\n    new PeriodicExportingMetricReader({\n      exporter: new OTLPMetricExporter({\n        url: sinkUrl,\n        headers: exporterHeaders,\n        temporalityPreference: AggregationTemporalityPreference.DELTA,\n      }),\n      exportIntervalMillis: 30_000,\n    }),\n    ...(opts._internalAdditionalMetricReaders ?? []),\n  ];\n\n  // Just W3C baggage. Trace context is contributed by the host\n  // bootstrap (`@vercel/otel`'s `propagators: [\"auto\"]`, or the\n  // CompositePropagator standalone `register()` constructs). Composing\n  // this on top extends rather than overrides.\n  const propagators: TextMapPropagator[] = [new W3CBaggagePropagator()];\n\n  // Standalone-path instrumentations. Conflicts with `@vercel/otel`'s\n  // `instrumentations: [\"auto\"]` (Vercel ships its own runtime-aware\n  // fetch instrumentation) — see the JSDoc on `InterfereOtelKit`.\n  const instrumentations: Instrumentation[] = [\n    new UndiciInstrumentation({\n      ignoreRequestHook: (req: { origin: string; path: string }) => {\n        const url = `${req.origin}${req.path}`;\n        return matchesAny(url, ignoreUrls);\n      },\n      requestHook: (span: Span, req: { origin: string; path: string }) => {\n        const url = `${req.origin}${req.path}`;\n        if (matchesAny(url, propagateContextUrls)) {\n          span.setAttribute(\"interfere.propagated\", true);\n        }\n      },\n    }),\n  ];\n\n  return {\n    resourceAttributes,\n    spanProcessors,\n    logRecordProcessors,\n    metricReaders,\n    propagators,\n    instrumentations,\n    enableConsoleBridge: () => bridgeConsoleToOtel(),\n    fetchRemoteConfig: () => fetchAndCacheRemoteConfig(),\n  };\n}\n\n/**\n * One-line server-side bootstrap for Next.js. Customers' `instrumentation.ts`\n * becomes:\n *\n * ```ts\n * export { register } from \"@interfere/next/instrumentation\";\n * ```\n *\n * Or, with overrides:\n *\n * ```ts\n * import { register as base } from \"@interfere/next/instrumentation\";\n * export const register = () => base({ serviceName: \"@my-org/api\" });\n * ```\n *\n * Customers who already run another OTel bootstrap (`@vercel/otel`,\n * DataDog `dd-trace-js`, custom `NodeTracerProvider`) should use\n * `buildInterfereOtelKit({...})` instead and compose the returned\n * processors / readers / propagators into their existing setup —\n * see the kit's JSDoc for examples.\n *\n * Constructs private `NodeTracerProvider` / `LoggerProvider` /\n * `MeterProvider` and registers them on the global slots. Last writer\n * wins on the globals, so customers running another OTel bootstrap\n * alongside this one will end up with whichever booted last; the kit\n * path avoids that fight entirely.\n *\n * Wired against the Node OTel SDK (`NodeTracerProvider`,\n * `AsyncLocalStorageContextManager`) — so this entry only ships into the\n * `nodejs` runtime bundle. The Edge runtime gets the no-op stub at\n * `instrumentation.edge.ts` via `package.json`'s `edge-light` /\n * `workerd` export conditions.\n *\n * Idempotent — repeat calls (e.g. HMR) short-circuit on the\n * module-scoped `registered` flag.\n *\n * Bails silently when `INTERFERE_API_KEY` is unset so dev runs without\n * the SDK configured don't crash.\n */\nexport async function register(\n  opts: ServerInstrumentationOptions = {}\n): Promise<void> {\n  if (registered) {\n    return;\n  }\n\n  const kit = buildInterfereOtelKit(opts);\n  if (!kit) {\n    return;\n  }\n\n  const resource = resourceFromAttributes(kit.resourceAttributes);\n\n  // Next 16's prerender extension throws on `Math.random()` /\n  // `crypto.getRandomValues()` calls inside a Server Component that hasn't\n  // awaited Request data first. OTel's default `RandomIdGenerator` calls\n  // `Math.random()` for every span ID, so any span Next opens around a\n  // prerendered route render blows up the build with\n  // `next-prerender-random`. The counter-based generator below seeds its\n  // randomness once at register-time (outside any prerender ALS frame) and\n  // keeps span minting deterministic afterwards.\n  const tracerProvider = new NodeTracerProvider({\n    resource,\n    spanProcessors: kit.spanProcessors,\n    idGenerator: new PrerenderSafeIdGenerator(),\n  });\n\n  // Composed W3C trace context + baggage. `UndiciInstrumentation`\n  // injects both `traceparent` and `baggage` on outgoing requests\n  // matching `propagateContextUrls`, so cross-process correlation +\n  // customer baggage propagation work without per-call code.\n  //\n  // Only set the global propagator when none is registered — customers\n  // who installed their own propagator (B3, Jaeger, composite, ...) are\n  // preserved. Mirrors the browser-side guard in\n  // `react/internal/otel/provider.ts`.\n  if (propagation.fields().length === 0) {\n    propagation.setGlobalPropagator(\n      new CompositePropagator({\n        propagators: [new W3CTraceContextPropagator(), ...kit.propagators],\n      })\n    );\n  }\n\n  tracerProvider.register({\n    contextManager: new AsyncLocalStorageContextManager().enable(),\n  });\n\n  const loggerProvider = new LoggerProvider({\n    resource,\n    processors: kit.logRecordProcessors,\n  });\n  // `logs.setGlobalLoggerProvider` is the single global slot OTel\n  // exposes. Customers with their own LoggerProvider boot last and\n  // win; we accept the trade-off — same constraint we live with on\n  // the global propagator and context manager.\n  const { logs: logsApi } = await import(\"@opentelemetry/api-logs\");\n  logsApi.setGlobalLoggerProvider(loggerProvider);\n\n  const meterProvider = new MeterProvider({\n    resource,\n    readers: kit.metricReaders,\n  });\n  // `MeterProvider` has no `register()` method — wire it into the\n  // single global slot manually. Same trade-off as\n  // `setGlobalLoggerProvider`: customers with their own MeterProvider\n  // boot last and win.\n  metrics.setGlobalMeterProvider(meterProvider);\n\n  // Pass the meter provider explicitly so `UndiciInstrumentation`\n  // records `http.client.request.duration` histograms against it.\n  registerInstrumentations({\n    tracerProvider,\n    meterProvider,\n    instrumentations: kit.instrumentations,\n  });\n\n  if (opts.consoleBridge !== false) {\n    kit.enableConsoleBridge();\n  }\n\n  registered = true;\n\n  // Preserve the existing `register` semantics from `@interfere/next/server` —\n  // remote config gates plugin enable/disable. Customers migrating to this\n  // subpath shouldn't lose that behaviour.\n  await kit.fetchRemoteConfig();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoDA,MAAM,uBAAuB;AAC7B,MAAM,oBAAoB;AAE1B,IAAI,aAAa;AAEjB,SAAS,WAAW,KAAa,UAAwC;CACvE,KAAK,MAAM,WAAW,UACpB,IAAI,mBAAmB,SAAS,QAAQ,KAAK,IAAI,GAAG,IAAI,SAAS,QAAQ,EACvE,OAAO;CAGX,OAAO;;;;;;;;;;;AAsFT,SAAgB,sBACd,OAAqC,EAAE,EACd;CACzB,MAAM,MAAM,kBAAkB;CAC9B,IAAI,CAAC,IAAI,QACP,OAAO;CAGT,MAAM,EAAE,MAAM,gBAAgB,oBAAoB;CAClD,IAAI,CAAC,aACH,QAAQ,KACN,sLACD;CAGH,MAAM,UAAU,GAAG,IAAI,OAAO;CAI9B,MAAM,aAAa,CAAC,SAAS,GAAI,KAAK,cAAc,EAAE,CAAE;CACxD,MAAM,uBAAuB,KAAK,wBAAwB,EAAE;CAE5D,MAAM,kBAA0C;EAC9C,aAAa,IAAI;EACjB,gCAAgC;EACjC;CA4ED,OAAO;EACL,oBAAA;GA1EA,gBAAgB,KAAK,eAAe;GACpC,qBAAqB;GACrB,+BAA+B,IAAI,mBAAmB;GACtD,0BAA0B;GAC1B,sBAAsB;GACtB,yBAAyB;GACzB,GAAI,cAAc,EAAE,gBAAgB,aAAa,GAAG,EAAE;GAoEpC;EAClB,gBAAA;GA3DA,IAAI,2BAA2B,KAAK;GACpC,IAAI,mBACF,IAAI,kBAAkB;IAAE,KAAK;IAAS,SAAS;IAAiB,CAAC,CAClE;GACD,GAAI,KAAK,qCAAqC,EAAE;GAuDlC;EACd,qBAAA,CApDA,IAAI,wBACF,IAAI,gBAAgB;GAAE,KAAK;GAAS,SAAS;GAAiB,CAAC,CAChE,EACD,GAAI,KAAK,0CAA0C,EAAE,CAiDlC;EACnB,eAAA,CAvCA,IAAI,8BAA8B;GAChC,UAAU,IAAI,mBAAmB;IAC/B,KAAK;IACL,SAAS;IACT,uBAAuB,iCAAiC;IACzD,CAAC;GACF,sBAAsB;GACvB,CAAC,EACF,GAAI,KAAK,oCAAoC,EAAE,CA+BlC;EACb,aAAA,CAzBwC,IAAI,sBAAsB,CAyBvD;EACX,kBAAA,CApBA,IAAI,sBAAsB;GACxB,oBAAoB,QAA0C;IAE5D,OAAO,WAAW,GADH,IAAI,SAAS,IAAI,QACT,WAAW;;GAEpC,cAAc,MAAY,QAA0C;IAElE,IAAI,WAAW,GADA,IAAI,SAAS,IAAI,QACZ,qBAAqB,EACvC,KAAK,aAAa,wBAAwB,KAAK;;GAGpD,CAAC,CASc;EAChB,2BAA2B,qBAAqB;EAChD,yBAAyB,2BAA2B;EACrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CH,eAAsB,SACpB,OAAqC,EAAE,EACxB;CACf,IAAI,YACF;CAGF,MAAM,MAAM,sBAAsB,KAAK;CACvC,IAAI,CAAC,KACH;CAGF,MAAM,WAAW,uBAAuB,IAAI,mBAAmB;CAU/D,MAAM,iBAAiB,IAAI,mBAAmB;EAC5C;EACA,gBAAgB,IAAI;EACpB,aAAa,IAAI,0BAA0B;EAC5C,CAAC;CAWF,IAAI,YAAY,QAAQ,CAAC,WAAW,GAClC,YAAY,oBACV,IAAI,oBAAoB,EACtB,aAAa,CAAC,IAAI,2BAA2B,EAAE,GAAG,IAAI,YAAY,EACnE,CAAC,CACH;CAGH,eAAe,SAAS,EACtB,gBAAgB,IAAI,iCAAiC,CAAC,QAAQ,EAC/D,CAAC;CAEF,MAAM,iBAAiB,IAAI,eAAe;EACxC;EACA,YAAY,IAAI;EACjB,CAAC;CAKF,MAAM,EAAE,MAAM,YAAY,MAAM,OAAO;CACvC,QAAQ,wBAAwB,eAAe;CAE/C,MAAM,gBAAgB,IAAI,cAAc;EACtC;EACA,SAAS,IAAI;EACd,CAAC;CAKF,QAAQ,uBAAuB,cAAc;CAI7C,yBAAyB;EACvB;EACA;EACA,kBAAkB,IAAI;EACvB,CAAC;CAEF,IAAI,KAAK,kBAAkB,OACzB,IAAI,qBAAqB;CAG3B,aAAa;CAKb,MAAM,IAAI,mBAAmB"}

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

@@ -2,9 +2,8 @@ import { NextConfig } from "next";
 
 //#region src/internal/build/configure-build.d.ts
 interface InterfereInjectedValues {
-  readonly __INTERFERE_BUILD_ID__: string | null;
   readonly __INTERFERE_FORCE_ENABLE__?: boolean;
-  readonly __INTERFERE_RELEASE_ID__: string | null;
+  readonly __INTERFERE_RELEASE_SLUG__: string | null;
 }
 interface ConfigureBuildInput {
   readonly existingTurbopack: NextConfig["turbopack"] | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"configure-build.d.mts","names":[],"sources":["../../../src/internal/build/configure-build.ts"],"mappings":";;;UAKiB,uBAAA;EAAA,SACN,sBAAA;EAAA,SACA,0BAAA;EAAA,SACA,wBAAA;AAAA;AAAA,UAqBD,mBAAA;EAAA,SACC,iBAAA,EAAmB,UAAA;EAAA,SACnB,eAAA,EAAiB,UAAA;EAAA,SACjB,UAAA;EAAA,SACA,MAAA,EAAQ,uBAAA;AAAA;AAAA,UAGT,oBAAA;EAAA,SACC,SAAA,EAAW,UAAA;EAAA,SACX,OAAA,EAAS,UAAA;AAAA;AAAA,iBAGJ,cAAA,CAAA;EACd,eAAA;EACA,iBAAA;EACA,UAAA;EACA;AAAA,GACC,mBAAA,GAAsB,oBAAA"}
+{"version":3,"file":"configure-build.d.mts","names":[],"sources":["../../../src/internal/build/configure-build.ts"],"mappings":";;;UAKiB,uBAAA;EAAA,SACN,0BAAA;EAAA,SACA,0BAAA;AAAA;AAAA,UAqBD,mBAAA;EAAA,SACC,iBAAA,EAAmB,UAAA;EAAA,SACnB,eAAA,EAAiB,UAAA;EAAA,SACjB,UAAA;EAAA,SACA,MAAA,EAAQ,uBAAA;AAAA;AAAA,UAGT,oBAAA;EAAA,SACC,SAAA,EAAW,UAAA;EAAA,SACX,OAAA,EAAS,UAAA;AAAA;AAAA,iBAGJ,cAAA,CAAA;EACd,eAAA;EACA,iBAAA;EACA,UAAA;EACA;AAAA,GACC,mBAAA,GAAsB,oBAAA"}

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

@@ -26,7 +26,7 @@ function configureBuild({ existingWebpack, existingTurbopack, projectDir, values
 	};
 }
 function hasInjectedMetadata(metadata) {
-	return metadata.__INTERFERE_BUILD_ID__ !== null || metadata.__INTERFERE_RELEASE_ID__ !== null;
+	return metadata.__INTERFERE_RELEASE_SLUG__ !== null;
 }
 function buildWebpackHook(existingWebpack, instrumentationClientPath, values) {
 	if (!(instrumentationClientPath && hasInjectedMetadata(values))) return existingWebpack;
@@ -49,13 +49,21 @@ function buildWebpackHook(existingWebpack, instrumentationClientPath, values) {
 	};
 }
 function buildTurbopackConfig(existingTurbopack, instrumentationClientPath, values) {
-	if (!(instrumentationClientPath && hasInjectedMetadata(values))) return existingTurbopack;
 	const baseConfig = existingTurbopack ?? {};
+	const debugIds = baseConfig.debugIds ?? true;
+	if (!(instrumentationClientPath && hasInjectedMetadata(values))) {
+		if (existingTurbopack === void 0 && debugIds === baseConfig.debugIds) return existingTurbopack;
+		return {
+			...baseConfig,
+			debugIds
+		};
+	}
 	const ruleKey = `**/${basename(instrumentationClientPath)}`;
 	const existingRule = baseConfig.rules?.[ruleKey] ?? {};
 	const existingLoaders = Array.isArray(existingRule.loaders) ? existingRule.loaders : [];
 	return {
 		...baseConfig,
+		debugIds,
 		rules: {
 			...baseConfig.rules,
 			[ruleKey]: {

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

@@ -1 +1 @@
-{"version":3,"file":"configure-build.mjs","names":[],"sources":["../../../src/internal/build/configure-build.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { basename, dirname, join, normalize, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { NextConfig } from \"next\";\n\nexport interface InterfereInjectedValues {\n  readonly __INTERFERE_BUILD_ID__: string | null;\n  readonly __INTERFERE_FORCE_ENABLE__?: boolean;\n  readonly __INTERFERE_RELEASE_ID__: string | null;\n}\n\nconst INSTRUMENTATION_CLIENT_FILES = [\n  \"instrumentation-client.ts\",\n  \"instrumentation-client.tsx\",\n  \"instrumentation-client.js\",\n  \"instrumentation-client.jsx\",\n  \"src/instrumentation-client.ts\",\n  \"src/instrumentation-client.tsx\",\n  \"src/instrumentation-client.js\",\n  \"src/instrumentation-client.jsx\",\n] as const;\n\nconst LOADER_FILE_CANDIDATES = [\n  \"value-injection-loader.ts\",\n  \"value-injection-loader.js\",\n  \"value-injection-loader.mjs\",\n  \"value-injection-loader.cjs\",\n] as const;\n\ninterface ConfigureBuildInput {\n  readonly existingTurbopack: NextConfig[\"turbopack\"] | undefined;\n  readonly existingWebpack: NextConfig[\"webpack\"] | undefined;\n  readonly projectDir: string;\n  readonly values: InterfereInjectedValues;\n}\n\ninterface ConfigureBuildOutput {\n  readonly turbopack: NextConfig[\"turbopack\"] | undefined;\n  readonly webpack: NextConfig[\"webpack\"] | undefined;\n}\n\nexport function configureBuild({\n  existingWebpack,\n  existingTurbopack,\n  projectDir,\n  values,\n}: ConfigureBuildInput): ConfigureBuildOutput {\n  const instrumentationClientPath =\n    resolveInstrumentationClientPath(projectDir);\n\n  return {\n    webpack: buildWebpackHook(\n      existingWebpack,\n      instrumentationClientPath,\n      values\n    ),\n    turbopack: buildTurbopackConfig(\n      existingTurbopack,\n      instrumentationClientPath,\n      values\n    ),\n  };\n}\n\nfunction hasInjectedMetadata(metadata: InterfereInjectedValues): boolean {\n  return (\n    metadata.__INTERFERE_BUILD_ID__ !== null ||\n    metadata.__INTERFERE_RELEASE_ID__ !== null\n  );\n}\n\nfunction buildWebpackHook(\n  existingWebpack: NextConfig[\"webpack\"] | undefined,\n  instrumentationClientPath: string | null,\n  values: InterfereInjectedValues\n): NextConfig[\"webpack\"] | undefined {\n  if (!(instrumentationClientPath && hasInjectedMetadata(values))) {\n    return existingWebpack;\n  }\n\n  const normalizedPath = normalize(instrumentationClientPath);\n  const loaderPath = resolveLoaderPath();\n\n  return (webpackConfig, options) => {\n    const outputConfig = existingWebpack\n      ? existingWebpack(webpackConfig, options)\n      : webpackConfig;\n    const mutableConfig = outputConfig as {\n      module?: { rules?: unknown[] };\n    };\n\n    const injectionRule = {\n      test: (resource: string): boolean =>\n        Boolean(resource) && normalize(resource) === normalizedPath,\n      use: [\n        {\n          loader: loaderPath,\n          options: { values },\n        },\n      ],\n    };\n\n    mutableConfig.module ??= {};\n    mutableConfig.module.rules ??= [];\n    mutableConfig.module.rules.push(injectionRule);\n\n    return outputConfig;\n  };\n}\n\nfunction buildTurbopackConfig(\n  existingTurbopack: NextConfig[\"turbopack\"] | undefined,\n  instrumentationClientPath: string | null,\n  values: InterfereInjectedValues\n): NextConfig[\"turbopack\"] | undefined {\n  if (!(instrumentationClientPath && hasInjectedMetadata(values))) {\n    return existingTurbopack;\n  }\n\n  const baseConfig = (existingTurbopack ?? {}) as {\n    rules?: Record<string, unknown>;\n  };\n  const ruleKey = `**/${basename(instrumentationClientPath)}`;\n  const existingRule = (baseConfig.rules?.[ruleKey] ?? {}) as {\n    loaders?: unknown[];\n  };\n  const existingLoaders = Array.isArray(existingRule.loaders)\n    ? existingRule.loaders\n    : [];\n\n  return {\n    ...baseConfig,\n    rules: {\n      ...baseConfig.rules,\n      [ruleKey]: {\n        ...existingRule,\n        loaders: [\n          ...existingLoaders,\n          {\n            loader: resolveLoaderPath(),\n            options: {\n              serializedValues: JSON.stringify(values),\n            },\n          },\n        ],\n      },\n    },\n  } as NextConfig[\"turbopack\"];\n}\n\nfunction resolveInstrumentationClientPath(projectDir: string): string | null {\n  for (const candidate of INSTRUMENTATION_CLIENT_FILES) {\n    const filePath = resolve(projectDir, candidate);\n    if (existsSync(filePath)) {\n      return filePath;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveLoaderPath(): string {\n  const directory = resolve(dirname(fileURLToPath(import.meta.url)));\n\n  for (const candidate of LOADER_FILE_CANDIDATES) {\n    const filePath = join(directory, candidate);\n    if (existsSync(filePath)) {\n      return filePath;\n    }\n  }\n\n  return join(directory, \"value-injection-loader.js\");\n}\n"],"mappings":";;;;AAWA,MAAM,+BAA+B;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,yBAAyB;CAC7B;CACA;CACA;CACA;CACD;AAcD,SAAgB,eAAe,EAC7B,iBACA,mBACA,YACA,UAC4C;CAC5C,MAAM,4BACJ,iCAAiC,WAAW;AAE9C,QAAO;EACL,SAAS,iBACP,iBACA,2BACA,OACD;EACD,WAAW,qBACT,mBACA,2BACA,OACD;EACF;;AAGH,SAAS,oBAAoB,UAA4C;AACvE,QACE,SAAS,2BAA2B,QACpC,SAAS,6BAA6B;;AAI1C,SAAS,iBACP,iBACA,2BACA,QACmC;AACnC,KAAI,EAAE,6BAA6B,oBAAoB,OAAO,EAC5D,QAAO;CAGT,MAAM,iBAAiB,UAAU,0BAA0B;CAC3D,MAAM,aAAa,mBAAmB;AAEtC,SAAQ,eAAe,YAAY;EACjC,MAAM,eAAe,kBACjB,gBAAgB,eAAe,QAAQ,GACvC;EACJ,MAAM,gBAAgB;EAItB,MAAM,gBAAgB;GACpB,OAAO,aACL,QAAQ,SAAS,IAAI,UAAU,SAAS,KAAK;GAC/C,KAAK,CACH;IACE,QAAQ;IACR,SAAS,EAAE,QAAQ;IACpB,CACF;GACF;AAED,gBAAc,WAAW,EAAE;AAC3B,gBAAc,OAAO,UAAU,EAAE;AACjC,gBAAc,OAAO,MAAM,KAAK,cAAc;AAE9C,SAAO;;;AAIX,SAAS,qBACP,mBACA,2BACA,QACqC;AACrC,KAAI,EAAE,6BAA6B,oBAAoB,OAAO,EAC5D,QAAO;CAGT,MAAM,aAAc,qBAAqB,EAAE;CAG3C,MAAM,UAAU,MAAM,SAAS,0BAA0B;CACzD,MAAM,eAAgB,WAAW,QAAQ,YAAY,EAAE;CAGvD,MAAM,kBAAkB,MAAM,QAAQ,aAAa,QAAQ,GACvD,aAAa,UACb,EAAE;AAEN,QAAO;EACL,GAAG;EACH,OAAO;GACL,GAAG,WAAW;IACb,UAAU;IACT,GAAG;IACH,SAAS,CACP,GAAG,iBACH;KACE,QAAQ,mBAAmB;KAC3B,SAAS,EACP,kBAAkB,KAAK,UAAU,OAAO,EACzC;KACF,CACF;IACF;GACF;EACF;;AAGH,SAAS,iCAAiC,YAAmC;AAC3E,MAAK,MAAM,aAAa,8BAA8B;EACpD,MAAM,WAAW,QAAQ,YAAY,UAAU;AAC/C,MAAI,WAAW,SAAS,CACtB,QAAO;;AAIX,QAAO;;AAGT,SAAS,oBAA4B;CACnC,MAAM,YAAY,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,CAAC;AAElE,MAAK,MAAM,aAAa,wBAAwB;EAC9C,MAAM,WAAW,KAAK,WAAW,UAAU;AAC3C,MAAI,WAAW,SAAS,CACtB,QAAO;;AAIX,QAAO,KAAK,WAAW,4BAA4B"}
+{"version":3,"file":"configure-build.mjs","names":[],"sources":["../../../src/internal/build/configure-build.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { basename, dirname, join, normalize, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { NextConfig } from \"next\";\n\nexport interface InterfereInjectedValues {\n  readonly __INTERFERE_FORCE_ENABLE__?: boolean;\n  readonly __INTERFERE_RELEASE_SLUG__: string | null;\n}\n\nconst INSTRUMENTATION_CLIENT_FILES = [\n  \"instrumentation-client.ts\",\n  \"instrumentation-client.tsx\",\n  \"instrumentation-client.js\",\n  \"instrumentation-client.jsx\",\n  \"src/instrumentation-client.ts\",\n  \"src/instrumentation-client.tsx\",\n  \"src/instrumentation-client.js\",\n  \"src/instrumentation-client.jsx\",\n] as const;\n\nconst LOADER_FILE_CANDIDATES = [\n  \"value-injection-loader.ts\",\n  \"value-injection-loader.js\",\n  \"value-injection-loader.mjs\",\n  \"value-injection-loader.cjs\",\n] as const;\n\ninterface ConfigureBuildInput {\n  readonly existingTurbopack: NextConfig[\"turbopack\"] | undefined;\n  readonly existingWebpack: NextConfig[\"webpack\"] | undefined;\n  readonly projectDir: string;\n  readonly values: InterfereInjectedValues;\n}\n\ninterface ConfigureBuildOutput {\n  readonly turbopack: NextConfig[\"turbopack\"] | undefined;\n  readonly webpack: NextConfig[\"webpack\"] | undefined;\n}\n\nexport function configureBuild({\n  existingWebpack,\n  existingTurbopack,\n  projectDir,\n  values,\n}: ConfigureBuildInput): ConfigureBuildOutput {\n  const instrumentationClientPath =\n    resolveInstrumentationClientPath(projectDir);\n\n  return {\n    webpack: buildWebpackHook(\n      existingWebpack,\n      instrumentationClientPath,\n      values\n    ),\n    turbopack: buildTurbopackConfig(\n      existingTurbopack,\n      instrumentationClientPath,\n      values\n    ),\n  };\n}\n\nfunction hasInjectedMetadata(metadata: InterfereInjectedValues): boolean {\n  return metadata.__INTERFERE_RELEASE_SLUG__ !== null;\n}\n\nfunction buildWebpackHook(\n  existingWebpack: NextConfig[\"webpack\"] | undefined,\n  instrumentationClientPath: string | null,\n  values: InterfereInjectedValues\n): NextConfig[\"webpack\"] | undefined {\n  if (!(instrumentationClientPath && hasInjectedMetadata(values))) {\n    return existingWebpack;\n  }\n\n  const normalizedPath = normalize(instrumentationClientPath);\n  const loaderPath = resolveLoaderPath();\n\n  return (webpackConfig, options) => {\n    const outputConfig = existingWebpack\n      ? existingWebpack(webpackConfig, options)\n      : webpackConfig;\n    const mutableConfig = outputConfig as {\n      module?: { rules?: unknown[] };\n    };\n\n    const injectionRule = {\n      test: (resource: string): boolean =>\n        Boolean(resource) && normalize(resource) === normalizedPath,\n      use: [\n        {\n          loader: loaderPath,\n          options: { values },\n        },\n      ],\n    };\n\n    mutableConfig.module ??= {};\n    mutableConfig.module.rules ??= [];\n    mutableConfig.module.rules.push(injectionRule);\n\n    return outputConfig;\n  };\n}\n\nfunction buildTurbopackConfig(\n  existingTurbopack: NextConfig[\"turbopack\"] | undefined,\n  instrumentationClientPath: string | null,\n  values: InterfereInjectedValues\n): NextConfig[\"turbopack\"] | undefined {\n  // Turbopack natively pairs JS chunks to source maps via debug IDs (it\n  // injects matching `//# debugId=…` into the chunk and a `\"debugId\"` field\n  // into the map). We rely on this in `discoverTurbopack`, because the\n  // `//# sourceMappingURL=…` URL in the chunk is the source map's content\n  // hash — not the `.js.map` filename on disk — so URL-based pairing always\n  // fails for turbopack output.\n  //\n  // We force `debugIds: true` unless the user opted out explicitly. The\n  // user keeps full control: any user-provided value (including `false`)\n  // wins via `??`.\n  const baseConfig = (existingTurbopack ?? {}) as {\n    rules?: Record<string, unknown>;\n    debugIds?: boolean;\n  };\n  const debugIds = baseConfig.debugIds ?? true;\n\n  // No instrumentation client → only the debugIds patch is needed, and only\n  // if the user hasn't already declared turbopack config (in which case we\n  // leave their object untouched but layered with our default).\n  if (!(instrumentationClientPath && hasInjectedMetadata(values))) {\n    if (existingTurbopack === undefined && debugIds === baseConfig.debugIds) {\n      return existingTurbopack;\n    }\n    \n    return { ...baseConfig, debugIds } as NextConfig[\"turbopack\"];\n  }\n\n  const ruleKey = `**/${basename(instrumentationClientPath)}`;\n  const existingRule = (baseConfig.rules?.[ruleKey] ?? {}) as {\n    loaders?: unknown[];\n  };\n  const existingLoaders = Array.isArray(existingRule.loaders)\n    ? existingRule.loaders\n    : [];\n\n  return {\n    ...baseConfig,\n    debugIds,\n    rules: {\n      ...baseConfig.rules,\n      [ruleKey]: {\n        ...existingRule,\n        loaders: [\n          ...existingLoaders,\n          {\n            loader: resolveLoaderPath(),\n            options: {\n              serializedValues: JSON.stringify(values),\n            },\n          },\n        ],\n      },\n    },\n  } as NextConfig[\"turbopack\"];\n}\n\nfunction resolveInstrumentationClientPath(projectDir: string): string | null {\n  for (const candidate of INSTRUMENTATION_CLIENT_FILES) {\n    const filePath = resolve(projectDir, candidate);\n    if (existsSync(filePath)) {\n      return filePath;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveLoaderPath(): string {\n  const directory = resolve(dirname(fileURLToPath(import.meta.url)));\n\n  for (const candidate of LOADER_FILE_CANDIDATES) {\n    const filePath = join(directory, candidate);\n    if (existsSync(filePath)) {\n      return filePath;\n    }\n  }\n\n  return join(directory, \"value-injection-loader.js\");\n}\n"],"mappings":";;;;AAUA,MAAM,+BAA+B;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,yBAAyB;CAC7B;CACA;CACA;CACA;CACD;AAcD,SAAgB,eAAe,EAC7B,iBACA,mBACA,YACA,UAC4C;CAC5C,MAAM,4BACJ,iCAAiC,WAAW;CAE9C,OAAO;EACL,SAAS,iBACP,iBACA,2BACA,OACD;EACD,WAAW,qBACT,mBACA,2BACA,OACD;EACF;;AAGH,SAAS,oBAAoB,UAA4C;CACvE,OAAO,SAAS,+BAA+B;;AAGjD,SAAS,iBACP,iBACA,2BACA,QACmC;CACnC,IAAI,EAAE,6BAA6B,oBAAoB,OAAO,GAC5D,OAAO;CAGT,MAAM,iBAAiB,UAAU,0BAA0B;CAC3D,MAAM,aAAa,mBAAmB;CAEtC,QAAQ,eAAe,YAAY;EACjC,MAAM,eAAe,kBACjB,gBAAgB,eAAe,QAAQ,GACvC;EACJ,MAAM,gBAAgB;EAItB,MAAM,gBAAgB;GACpB,OAAO,aACL,QAAQ,SAAS,IAAI,UAAU,SAAS,KAAK;GAC/C,KAAK,CACH;IACE,QAAQ;IACR,SAAS,EAAE,QAAQ;IACpB,CACF;GACF;EAED,cAAc,WAAW,EAAE;EAC3B,cAAc,OAAO,UAAU,EAAE;EACjC,cAAc,OAAO,MAAM,KAAK,cAAc;EAE9C,OAAO;;;AAIX,SAAS,qBACP,mBACA,2BACA,QACqC;CAWrC,MAAM,aAAc,qBAAqB,EAAE;CAI3C,MAAM,WAAW,WAAW,YAAY;CAKxC,IAAI,EAAE,6BAA6B,oBAAoB,OAAO,GAAG;EAC/D,IAAI,sBAAsB,KAAA,KAAa,aAAa,WAAW,UAC7D,OAAO;EAGT,OAAO;GAAE,GAAG;GAAY;GAAU;;CAGpC,MAAM,UAAU,MAAM,SAAS,0BAA0B;CACzD,MAAM,eAAgB,WAAW,QAAQ,YAAY,EAAE;CAGvD,MAAM,kBAAkB,MAAM,QAAQ,aAAa,QAAQ,GACvD,aAAa,UACb,EAAE;CAEN,OAAO;EACL,GAAG;EACH;EACA,OAAO;GACL,GAAG,WAAW;IACb,UAAU;IACT,GAAG;IACH,SAAS,CACP,GAAG,iBACH;KACE,QAAQ,mBAAmB;KAC3B,SAAS,EACP,kBAAkB,KAAK,UAAU,OAAO,EACzC;KACF,CACF;IACF;GACF;EACF;;AAGH,SAAS,iCAAiC,YAAmC;CAC3E,KAAK,MAAM,aAAa,8BAA8B;EACpD,MAAM,WAAW,QAAQ,YAAY,UAAU;EAC/C,IAAI,WAAW,SAAS,EACtB,OAAO;;CAIX,OAAO;;AAGT,SAAS,oBAA4B;CACnC,MAAM,YAAY,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,CAAC;CAElE,KAAK,MAAM,aAAa,wBAAwB;EAC9C,MAAM,WAAW,KAAK,WAAW,UAAU;EAC3C,IAAI,WAAW,SAAS,EACtB,OAAO;;CAIX,OAAO,KAAK,WAAW,4BAA4B"}

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

@@ -0,0 +1,6 @@
+import { ManifestBundler } from "@interfere/types/data/source-maps";
+
+//#region src/internal/build/detect-bundler.d.ts
+declare function detectActiveBundler(env?: Readonly<Record<string, string | undefined>>, argv?: readonly string[]): Exclude<ManifestBundler, "tsc">;
+//#endregion
+export { detectActiveBundler };

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect-bundler.d.mts","names":[],"sources":["../../../src/internal/build/detect-bundler.ts"],"mappings":";;;iBAIgB,mBAAA,CACd,GAAA,GAAK,QAAA,CAAS,MAAA,+BACd,IAAA,uBACC,OAAA,CAAQ,eAAA"}

package/dist/internal/build/detect-bundler.mjs

@@ -0,0 +1,9 @@
+//#region src/internal/build/detect-bundler.ts
+const TURBOPACK_FLAGS = ["--turbo", "--turbopack"];
+function detectActiveBundler(env = process.env, argv = process.argv) {
+	if (env["TURBOPACK"] === "1") return "turbopack";
+	if (TURBOPACK_FLAGS.some((flag) => argv.includes(flag))) return "turbopack";
+	return "webpack";
+}
+//#endregion
+export { detectActiveBundler };

package/dist/internal/build/detect-bundler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-bundler.mjs","names":[],"sources":["../../../src/internal/build/detect-bundler.ts"],"sourcesContent":["import type { ManifestBundler } from \"@interfere/types/data/source-maps\";\n\nconst TURBOPACK_FLAGS = [\"--turbo\", \"--turbopack\"] as const;\n\nexport function detectActiveBundler(\n  env: Readonly<Record<string, string | undefined>> = process.env,\n  argv: readonly string[] = process.argv\n): Exclude<ManifestBundler, \"tsc\"> {\n  if (env[\"TURBOPACK\"] === \"1\") {\n    return \"turbopack\";\n  }\n  if (TURBOPACK_FLAGS.some((flag) => argv.includes(flag))) {\n    return \"turbopack\";\n  }\n  return \"webpack\";\n}\n"],"mappings":";AAEA,MAAM,kBAAkB,CAAC,WAAW,cAAc;AAElD,SAAgB,oBACd,MAAoD,QAAQ,KAC5D,OAA0B,QAAQ,MACD;CACjC,IAAI,IAAI,iBAAiB,KACvB,OAAO;CAET,IAAI,gBAAgB,MAAM,SAAS,KAAK,SAAS,KAAK,CAAC,EACrD,OAAO;CAET,OAAO"}

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

@@ -1,5 +1,7 @@
 import { ProductionCompileContext, ResolvedBuildConfig } from "../../config.mjs";
+import { ReleaseSlug } from "@interfere/types/releases/slug";
 import * as _$_interfere_sdk_models0 from "@interfere/sdk/models";
+import * as _$zod from "zod";
 import { ReleasesConfigResponse } from "@interfere/sdk/models/releases-config-response.js";
 import { CreateReleaseResponse } from "@interfere/types/releases/definition";
 
@@ -29,6 +31,7 @@ type PipelineResult = {
 declare function runBuildPipeline(context: ProductionCompileContext, metadata: ResolvedBuildConfig & {
   apiKey: string;
   buildId: string;
+  releaseSlug: ReleaseSlug;
 }): Promise<{
   ready: boolean;
   reason: string;
@@ -41,7 +44,17 @@ declare function runBuildPipeline(context: ProductionCompileContext, metadata: R
   reason?: never;
   ready: true;
   fileCount: number;
-  release: _$_interfere_sdk_models0.ReleasesCreateResponse;
+  release: {
+    org: _$_interfere_sdk_models0.OrgRef;
+    surface: _$_interfere_sdk_models0.SurfaceRef;
+    source: _$_interfere_sdk_models0.ReleaseSourceRef;
+    build: _$_interfere_sdk_models0.ReleaseBuildRef;
+    destination: {
+      id: string;
+      environment: string | null;
+      slug: `rel_${string}` & _$zod.$brand<"ReleaseSlug">;
+    };
+  };
   config: ReleasesConfigResponse;
   buildId: string;
   timing: BuildTiming;

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.mts","names":[],"sources":["../../../src/internal/build/pipeline.ts"],"mappings":";;;;;;UAYiB,WAAA;EACf,OAAA;EACA,aAAA;EACA,QAAA;EACA,SAAA;EACA,SAAA;EACA,KAAA;EACA,UAAA;EACA,MAAA;AAAA;AAAA,KAGU,cAAA;EACN,KAAA;EAAc,MAAA;EAA0B,SAAA;AAAA;EAExC,KAAA;EACA,SAAA;EACA,OAAA,EAAS,qBAAA;EACT,MAAA,EAAQ,sBAAA;EACR,OAAA;EACA,MAAA,EAAQ,WAAA;AAAA;AAAA,iBAUQ,gBAAA,CACpB,OAAA,EAAS,wBAAA,EACT,QAAA,EAAU,mBAAA;EAAwB,MAAA;EAAgB,OAAA;AAAA,IAAiB,OAAA;;;;;;;;;;;;WAAtC,wBAAA,CAAA,sBAAA"}
+{"version":3,"file":"pipeline.d.mts","names":[],"sources":["../../../src/internal/build/pipeline.ts"],"mappings":";;;;;;;;UAciB,WAAA;EACf,OAAA;EACA,aAAA;EACA,QAAA;EACA,SAAA;EACA,SAAA;EACA,KAAA;EACA,UAAA;EACA,MAAA;AAAA;AAAA,KAGU,cAAA;EACN,KAAA;EAAc,MAAA;EAA0B,SAAA;AAAA;EAExC,KAAA;EACA,SAAA;EACA,OAAA,EAAS,qBAAA;EACT,MAAA,EAAQ,sBAAA;EACR,OAAA;EACA,MAAA,EAAQ,WAAA;AAAA;AAAA,iBAUQ,gBAAA,CACpB,OAAA,EAAS,wBAAA,EACT,QAAA,EAAU,mBAAA;EACR,MAAA;EACA,OAAA;EACA,WAAA,EAAa,WAAA;AAAA,IACd,OAAA;;;;;;;;;;;;;SADyB,wBAAA,CAAA,MAAA"}

package/dist/internal/build/pipeline.mjs

@@ -1,6 +1,9 @@
+import { detectActiveBundler } from "./detect-bundler.mjs";
 import { resolveReleaseRequest } from "./release/index.mjs";
-import { discover, normalizeDistDir } from "./source-maps/discover.mjs";
-import { buildUploadBody, cleanupSourceMaps } from "./source-maps/index.mjs";
+import { discoverSourceMaps } from "./source-maps/discover.mjs";
+import { uploadSourceMaps } from "./source-maps/upload.mjs";
+import { cleanupSourceMaps } from "./source-maps/index.mjs";
+import { releaseSlugSchema } from "@interfere/types/releases/slug";
 import { HTTPClient, Interfere } from "@interfere/sdk";
 //#region src/internal/build/pipeline.ts
 async function timed(fn) {
@@ -20,8 +23,13 @@ async function runBuildPipeline(context, metadata) {
 		httpClient
 	});
 	const start = performance.now();
+	const bundler = detectActiveBundler();
 	const [{ discovered, config }, discoverMs] = await timed(async () => {
-		const [discovered, config] = await Promise.all([discover(context.projectDir, normalizeDistDir(context.distDir)), sdk.releases.getConfig()]);
+		const [discovered, config] = await Promise.all([discoverSourceMaps({
+			bundler,
+			projectDir: context.projectDir,
+			distDir: context.distDir
+		}), sdk.releases.getConfig()]);
 		return {
 			discovered,
 			config
@@ -32,14 +40,16 @@ async function runBuildPipeline(context, metadata) {
 		reason: "no_source_maps",
 		fileCount: 0
 	};
-	const releaseRequest = resolveReleaseRequest(metadata.buildId, config);
+	const releaseRequest = resolveReleaseRequest(metadata.buildId, metadata.releaseSlug, config);
 	const [release, createReleaseMs] = await timed(() => sdk.releases.create(releaseRequest));
-	const releaseSlug = release.destination.slug;
+	const releaseSlug = releaseSlugSchema.parse(release.destination.slug);
 	const buildId = release.build.hash ?? metadata.buildId;
-	const { body, totalBytes } = buildUploadBody(discovered);
-	const [, uploadMs] = await timed(() => sdk.sourceMaps.uploadMultipart({
-		releaseSlug,
-		body
+	const [{ totalBytes }, uploadMs] = await timed(() => uploadSourceMaps({
+		apiUrl,
+		bundler,
+		discovered,
+		httpClient,
+		releaseSlug
 	}));
 	const [, preflightMs] = await timed(() => sdk.releases.preflight({ releaseSlug }));
 	const [, cleanupMs] = await timed(() => cleanupSourceMaps(discovered.files));
@@ -56,7 +66,13 @@ async function runBuildPipeline(context, metadata) {
 	return {
 		ready: true,
 		fileCount: discovered.files.length,
-		release,
+		release: {
+			...release,
+			destination: {
+				...release.destination,
+				slug: releaseSlug
+			}
+		},
 		config,
 		buildId,
 		timing

package/dist/internal/build/pipeline.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../../src/internal/build/pipeline.ts"],"sourcesContent":["import { HTTPClient, Interfere } from \"@interfere/sdk\";\nimport type { ReleasesConfigResponse } from \"@interfere/sdk/models/releases-config-response.js\";\nimport type { CreateReleaseResponse } from \"@interfere/types/releases/definition\";\n\nimport type {\n  ProductionCompileContext,\n  ResolvedBuildConfig,\n} from \"../../config.js\";\nimport { resolveReleaseRequest } from \"./release/index.js\";\nimport { discover, normalizeDistDir } from \"./source-maps/discover.js\";\nimport { buildUploadBody, cleanupSourceMaps } from \"./source-maps/index.js\";\n\nexport interface BuildTiming {\n  cleanup: number;\n  createRelease: number;\n  discover: number;\n  fileCount: number;\n  preflight: number;\n  total: number;\n  totalBytes: number;\n  upload: number;\n}\n\nexport type PipelineResult =\n  | { ready: false; reason: \"no_source_maps\"; fileCount: 0 }\n  | {\n      ready: true;\n      fileCount: number;\n      release: CreateReleaseResponse;\n      config: ReleasesConfigResponse;\n      buildId: string;\n      timing: BuildTiming;\n    };\n\nasync function timed<T>(fn: () => Promise<T>): Promise<[T, number]> {\n  const start = performance.now();\n  const result = await fn();\n  return [result, Math.round(performance.now() - start)];\n}\n\n\nexport async function runBuildPipeline(\n  context: ProductionCompileContext,\n  metadata: ResolvedBuildConfig & { apiKey: string; buildId: string }\n) {\n  const { apiUrl, apiKey } = metadata;\n\n  const httpClient = new HTTPClient();\n\n  httpClient.addHook(\"beforeRequest\", (request) => {\n    const nextRequest = new Request(request);\n\n    nextRequest.headers.set(\"x-api-key\", apiKey);\n\n    return nextRequest;\n  });\n\n  const sdk = new Interfere({ serverURL: apiUrl, httpClient });\n\n  const start = performance.now();\n\n  const [{ discovered, config }, discoverMs] = await timed(async () => {\n    const [discovered, config] = await Promise.all([\n      discover(context.projectDir, normalizeDistDir(context.distDir)),\n      sdk.releases.getConfig(),\n    ]);\n    return { discovered, config };\n  });\n\n  if (discovered.files.length === 0) {\n    return { ready: false, reason: \"no_source_maps\", fileCount: 0 };\n  }\n\n  const releaseRequest = resolveReleaseRequest(metadata.buildId, config);\n\n  const [release, createReleaseMs] = await timed(() =>\n    sdk.releases.create(releaseRequest)\n  );\n\n  const releaseSlug = release.destination.slug;\n  const buildId = release.build.hash ?? metadata.buildId;\n\n  const { body, totalBytes } = buildUploadBody(discovered);\n\n  const [, uploadMs] = await timed(() =>\n    sdk.sourceMaps.uploadMultipart({ releaseSlug, body })\n  );\n\n  // Cleanup runs *after* preflight, not before (PRD draft had it inverted).\n  // Preflight only depends on the upload having succeeded; if local cleanup\n  // fails we still want the release marked confirmed and the build to fail\n  // loudly via the cleanup error, rather than leaving a confirmed-but-uncleaned\n  // workspace and a release that needs a redeploy to recover.\n  const [, preflightMs] = await timed(() =>\n    sdk.releases.preflight({ releaseSlug })\n  );\n\n  const [, cleanupMs] = await timed(() => cleanupSourceMaps(discovered.files));\n\n  const timing: BuildTiming = {\n    discover: discoverMs,\n    createRelease: createReleaseMs,\n    upload: uploadMs,\n    preflight: preflightMs,\n    cleanup: cleanupMs,\n    total: Math.round(performance.now() - start),\n    fileCount: discovered.files.length,\n    totalBytes,\n  };\n\n  return {\n    ready: true,\n    fileCount: discovered.files.length,\n    release,\n    config,\n    buildId,\n    timing,\n  } satisfies PipelineResult;\n}\n"],"mappings":";;;;;AAkCA,eAAe,MAAS,IAA4C;CAClE,MAAM,QAAQ,YAAY,KAAK;AAE/B,QAAO,CAAC,MADa,IAAI,EACT,KAAK,MAAM,YAAY,KAAK,GAAG,MAAM,CAAC;;AAIxD,eAAsB,iBACpB,SACA,UACA;CACA,MAAM,EAAE,QAAQ,WAAW;CAE3B,MAAM,aAAa,IAAI,YAAY;AAEnC,YAAW,QAAQ,kBAAkB,YAAY;EAC/C,MAAM,cAAc,IAAI,QAAQ,QAAQ;AAExC,cAAY,QAAQ,IAAI,aAAa,OAAO;AAE5C,SAAO;GACP;CAEF,MAAM,MAAM,IAAI,UAAU;EAAE,WAAW;EAAQ;EAAY,CAAC;CAE5D,MAAM,QAAQ,YAAY,KAAK;CAE/B,MAAM,CAAC,EAAE,YAAY,UAAU,cAAc,MAAM,MAAM,YAAY;EACnE,MAAM,CAAC,YAAY,UAAU,MAAM,QAAQ,IAAI,CAC7C,SAAS,QAAQ,YAAY,iBAAiB,QAAQ,QAAQ,CAAC,EAC/D,IAAI,SAAS,WAAW,CACzB,CAAC;AACF,SAAO;GAAE;GAAY;GAAQ;GAC7B;AAEF,KAAI,WAAW,MAAM,WAAW,EAC9B,QAAO;EAAE,OAAO;EAAO,QAAQ;EAAkB,WAAW;EAAG;CAGjE,MAAM,iBAAiB,sBAAsB,SAAS,SAAS,OAAO;CAEtE,MAAM,CAAC,SAAS,mBAAmB,MAAM,YACvC,IAAI,SAAS,OAAO,eAAe,CACpC;CAED,MAAM,cAAc,QAAQ,YAAY;CACxC,MAAM,UAAU,QAAQ,MAAM,QAAQ,SAAS;CAE/C,MAAM,EAAE,MAAM,eAAe,gBAAgB,WAAW;CAExD,MAAM,GAAG,YAAY,MAAM,YACzB,IAAI,WAAW,gBAAgB;EAAE;EAAa;EAAM,CAAC,CACtD;CAOD,MAAM,GAAG,eAAe,MAAM,YAC5B,IAAI,SAAS,UAAU,EAAE,aAAa,CAAC,CACxC;CAED,MAAM,GAAG,aAAa,MAAM,YAAY,kBAAkB,WAAW,MAAM,CAAC;CAE5E,MAAM,SAAsB;EAC1B,UAAU;EACV,eAAe;EACf,QAAQ;EACR,WAAW;EACX,SAAS;EACT,OAAO,KAAK,MAAM,YAAY,KAAK,GAAG,MAAM;EAC5C,WAAW,WAAW,MAAM;EAC5B;EACD;AAED,QAAO;EACL,OAAO;EACP,WAAW,WAAW,MAAM;EAC5B;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../../src/internal/build/pipeline.ts"],"sourcesContent":["import { HTTPClient, Interfere } from \"@interfere/sdk\";\nimport type { ReleasesConfigResponse } from \"@interfere/sdk/models/releases-config-response.js\";\nimport type { CreateReleaseResponse } from \"@interfere/types/releases/definition\";\nimport { type ReleaseSlug, releaseSlugSchema } from \"@interfere/types/releases/slug\";\n\nimport type {\n  ProductionCompileContext,\n  ResolvedBuildConfig,\n} from \"../../config.js\";\nimport { detectActiveBundler } from \"./detect-bundler.js\";\nimport { resolveReleaseRequest } from \"./release/index.js\";\nimport { discoverSourceMaps } from \"./source-maps/discover.js\";\nimport { cleanupSourceMaps, uploadSourceMaps } from \"./source-maps/index.js\";\n\nexport interface BuildTiming {\n  cleanup: number;\n  createRelease: number;\n  discover: number;\n  fileCount: number;\n  preflight: number;\n  total: number;\n  totalBytes: number;\n  upload: number;\n}\n\nexport type PipelineResult =\n  | { ready: false; reason: \"no_source_maps\"; fileCount: 0 }\n  | {\n      ready: true;\n      fileCount: number;\n      release: CreateReleaseResponse;\n      config: ReleasesConfigResponse;\n      buildId: string;\n      timing: BuildTiming;\n    };\n\nasync function timed<T>(fn: () => Promise<T>): Promise<[T, number]> {\n  const start = performance.now();\n  const result = await fn();\n  return [result, Math.round(performance.now() - start)];\n}\n\n\nexport async function runBuildPipeline(\n  context: ProductionCompileContext,\n  metadata: ResolvedBuildConfig & {\n    apiKey: string;\n    buildId: string;\n    releaseSlug: ReleaseSlug;\n  }\n) {\n  const { apiUrl, apiKey } = metadata;\n\n  const httpClient = new HTTPClient();\n\n  httpClient.addHook(\"beforeRequest\", (request) => {\n    const nextRequest = new Request(request);\n\n    nextRequest.headers.set(\"x-api-key\", apiKey);\n\n    return nextRequest;\n  });\n\n  const sdk = new Interfere({ serverURL: apiUrl, httpClient });\n\n  const start = performance.now();\n\n  const bundler = detectActiveBundler();\n\n  const [{ discovered, config }, discoverMs] = await timed(async () => {\n    const [discovered, config] = await Promise.all([\n      discoverSourceMaps({\n        bundler,\n        projectDir: context.projectDir,\n        distDir: context.distDir,\n      }),\n      sdk.releases.getConfig(),\n    ]);\n    return { discovered, config };\n  });\n\n  if (discovered.files.length === 0) {\n    return { ready: false, reason: \"no_source_maps\", fileCount: 0 };\n  }\n\n  const releaseRequest = resolveReleaseRequest(\n    metadata.buildId,\n    metadata.releaseSlug,\n    config\n  );\n\n  const [release, createReleaseMs] = await timed(() =>\n    sdk.releases.create(releaseRequest)\n  );\n\n  // The SDK response carries the slug as a plain `string`. Brand it\n  // here at the API boundary so every downstream caller (upload,\n  // preflight, cleanup) reads a `ReleaseSlug`.\n  const releaseSlug = releaseSlugSchema.parse(release.destination.slug);\n  const buildId = release.build.hash ?? metadata.buildId;\n\n  const [{ totalBytes }, uploadMs] = await timed(() =>\n    uploadSourceMaps({ apiUrl, bundler, discovered, httpClient, releaseSlug: releaseSlug })\n  );\n\n  // Cleanup runs *after* preflight, not before (PRD draft had it inverted).\n  // Preflight only depends on the upload having succeeded; if local cleanup\n  // fails we still want the release marked confirmed and the build to fail\n  // loudly via the cleanup error, rather than leaving a confirmed-but-uncleaned\n  // workspace and a release that needs a redeploy to recover.\n  const [, preflightMs] = await timed(() =>\n    sdk.releases.preflight({ releaseSlug })\n  );\n\n  const [, cleanupMs] = await timed(() => cleanupSourceMaps(discovered.files));\n\n  const timing: BuildTiming = {\n    discover: discoverMs,\n    createRelease: createReleaseMs,\n    upload: uploadMs,\n    preflight: preflightMs,\n    cleanup: cleanupMs,\n    total: Math.round(performance.now() - start),\n    fileCount: discovered.files.length,\n    totalBytes,\n  };\n\n  return {\n    ready: true,\n    fileCount: discovered.files.length,\n    release: { ...release, destination: { ...release.destination, slug: releaseSlug } },\n    config,\n    buildId,\n    timing,\n  } satisfies PipelineResult;\n}\n"],"mappings":";;;;;;;;AAoCA,eAAe,MAAS,IAA4C;CAClE,MAAM,QAAQ,YAAY,KAAK;CAE/B,OAAO,CAAC,MADa,IAAI,EACT,KAAK,MAAM,YAAY,KAAK,GAAG,MAAM,CAAC;;AAIxD,eAAsB,iBACpB,SACA,UAKA;CACA,MAAM,EAAE,QAAQ,WAAW;CAE3B,MAAM,aAAa,IAAI,YAAY;CAEnC,WAAW,QAAQ,kBAAkB,YAAY;EAC/C,MAAM,cAAc,IAAI,QAAQ,QAAQ;EAExC,YAAY,QAAQ,IAAI,aAAa,OAAO;EAE5C,OAAO;GACP;CAEF,MAAM,MAAM,IAAI,UAAU;EAAE,WAAW;EAAQ;EAAY,CAAC;CAE5D,MAAM,QAAQ,YAAY,KAAK;CAE/B,MAAM,UAAU,qBAAqB;CAErC,MAAM,CAAC,EAAE,YAAY,UAAU,cAAc,MAAM,MAAM,YAAY;EACnE,MAAM,CAAC,YAAY,UAAU,MAAM,QAAQ,IAAI,CAC7C,mBAAmB;GACjB;GACA,YAAY,QAAQ;GACpB,SAAS,QAAQ;GAClB,CAAC,EACF,IAAI,SAAS,WAAW,CACzB,CAAC;EACF,OAAO;GAAE;GAAY;GAAQ;GAC7B;CAEF,IAAI,WAAW,MAAM,WAAW,GAC9B,OAAO;EAAE,OAAO;EAAO,QAAQ;EAAkB,WAAW;EAAG;CAGjE,MAAM,iBAAiB,sBACrB,SAAS,SACT,SAAS,aACT,OACD;CAED,MAAM,CAAC,SAAS,mBAAmB,MAAM,YACvC,IAAI,SAAS,OAAO,eAAe,CACpC;CAKD,MAAM,cAAc,kBAAkB,MAAM,QAAQ,YAAY,KAAK;CACrE,MAAM,UAAU,QAAQ,MAAM,QAAQ,SAAS;CAE/C,MAAM,CAAC,EAAE,cAAc,YAAY,MAAM,YACvC,iBAAiB;EAAE;EAAQ;EAAS;EAAY;EAAyB;EAAa,CAAC,CACxF;CAOD,MAAM,GAAG,eAAe,MAAM,YAC5B,IAAI,SAAS,UAAU,EAAE,aAAa,CAAC,CACxC;CAED,MAAM,GAAG,aAAa,MAAM,YAAY,kBAAkB,WAAW,MAAM,CAAC;CAE5E,MAAM,SAAsB;EAC1B,UAAU;EACV,eAAe;EACf,QAAQ;EACR,WAAW;EACX,SAAS;EACT,OAAO,KAAK,MAAM,YAAY,KAAK,GAAG,MAAM;EAC5C,WAAW,WAAW,MAAM;EAC5B;EACD;CAED,OAAO;EACL,OAAO;EACP,WAAW,WAAW,MAAM;EAC5B,SAAS;GAAE,GAAG;GAAS,aAAa;IAAE,GAAG,QAAQ;IAAa,MAAM;IAAa;GAAE;EACnF;EACA;EACA;EACD"}

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

@@ -0,0 +1,14 @@
+import { DestinationProvider, ReleaseDestinationMetadata } from "@interfere/types/integrations";
+
+//#region src/internal/build/release/destinations/index.d.ts
+/**
+ * Per-provider destination metadata resolvers. Mirrors `sources/` —
+ * each entry knows how to read its platform's deployment env vars and
+ * returns a `ReleaseDestinationMetadata` blob.
+ *
+ * Adding a new destination (cloudflare-pages, fly, render, …) is one
+ * new file under this directory + one entry here.
+ */
+declare const destinations: Record<DestinationProvider, () => ReleaseDestinationMetadata>;
+//#endregion
+export { destinations };

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/internal/build/release/destinations/index.ts"],"mappings":";;;;;AAeA;;;;;;cAAa,YAAA,EAAc,MAAA,CACzB,mBAAA,QACM,0BAAA"}

package/dist/internal/build/release/destinations/index.mjs

@@ -0,0 +1,13 @@
+import { resolve } from "./vercel.mjs";
+//#region src/internal/build/release/destinations/index.ts
+/**
+* Per-provider destination metadata resolvers. Mirrors `sources/` —
+* each entry knows how to read its platform's deployment env vars and
+* returns a `ReleaseDestinationMetadata` blob.
+*
+* Adding a new destination (cloudflare-pages, fly, render, …) is one
+* new file under this directory + one entry here.
+*/
+const destinations = { vercel: resolve };
+//#endregion
+export { destinations };

package/dist/internal/build/release/destinations/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["resolveVercel"],"sources":["../../../../../src/internal/build/release/destinations/index.ts"],"sourcesContent":["import type {\n  DestinationProvider,\n  ReleaseDestinationMetadata,\n} from \"@interfere/types/integrations\";\n\nimport { resolve as resolveVercel } from \"./vercel.js\";\n\n/**\n * Per-provider destination metadata resolvers. Mirrors `sources/` —\n * each entry knows how to read its platform's deployment env vars and\n * returns a `ReleaseDestinationMetadata` blob.\n *\n * Adding a new destination (cloudflare-pages, fly, render, …) is one\n * new file under this directory + one entry here.\n */\nexport const destinations: Record<\n  DestinationProvider,\n  () => ReleaseDestinationMetadata\n> = {\n  vercel: resolveVercel,\n};\n"],"mappings":";;;;;;;;;;AAeA,MAAa,eAGT,EACF,QAAQA,SACT"}

package/dist/internal/build/release/destinations/vercel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vercel.mjs","names":[],"sources":["../../../../../src/internal/build/release/destinations/vercel.ts"],"sourcesContent":["import type { ReleaseDestinationMetadata } from \"@interfere/types/integrations\";\nimport { parseEnvValue } from \"@interfere/types/sdk/env\";\n\nexport function resolve(): ReleaseDestinationMetadata {\n  const environment = parseEnvValue(\n    process.env[\"VERCEL_ENV\"] ?? process.env[\"VERCEL_TARGET_ENV\"]\n  );\n\n  const deploymentId = parseEnvValue(process.env[\"VERCEL_DEPLOYMENT_ID\"]);\n\n  return {\n    provider: \"vercel\",\n    destinationReleaseId: deploymentId,\n    environment,\n    deploymentId,\n    deploymentUrl: resolveDeploymentUrl(),\n    environmentName: environment,\n    environmentTarget: environment,\n  };\n}\n\nfunction resolveDeploymentUrl(): string | null {\n  const deploymentUrl = parseEnvValue(process.env[\"VERCEL_URL\"]);\n\n  if (deploymentUrl === null) {\n    return null;\n  }\n\n  if (\n    deploymentUrl.startsWith(\"https://\") ||\n    deploymentUrl.startsWith(\"http://\")\n  ) {\n    return deploymentUrl;\n  }\n\n  return `https://${deploymentUrl}`;\n}\n"],"mappings":";;AAGA,SAAgB,UAAsC;CACpD,MAAM,cAAc,cAClB,QAAQ,IAAI,iBAAiB,QAAQ,IAAI,qBAC1C;CAED,MAAM,eAAe,cAAc,QAAQ,IAAI,wBAAwB;AAEvE,QAAO;EACL,UAAU;EACV,sBAAsB;EACtB;EACA;EACA,eAAe,sBAAsB;EACrC,iBAAiB;EACjB,mBAAmB;EACpB;;AAGH,SAAS,uBAAsC;CAC7C,MAAM,gBAAgB,cAAc,QAAQ,IAAI,cAAc;AAE9D,KAAI,kBAAkB,KACpB,QAAO;AAGT,KACE,cAAc,WAAW,WAAW,IACpC,cAAc,WAAW,UAAU,CAEnC,QAAO;AAGT,QAAO,WAAW"}
+{"version":3,"file":"vercel.mjs","names":[],"sources":["../../../../../src/internal/build/release/destinations/vercel.ts"],"sourcesContent":["import type { ReleaseDestinationMetadata } from \"@interfere/types/integrations\";\nimport { parseEnvValue } from \"@interfere/types/sdk/env\";\n\nexport function resolve(): ReleaseDestinationMetadata {\n  const environment = parseEnvValue(\n    process.env[\"VERCEL_ENV\"] ?? process.env[\"VERCEL_TARGET_ENV\"]\n  );\n\n  const deploymentId = parseEnvValue(process.env[\"VERCEL_DEPLOYMENT_ID\"]);\n\n  return {\n    provider: \"vercel\",\n    destinationReleaseId: deploymentId,\n    environment,\n    deploymentId,\n    deploymentUrl: resolveDeploymentUrl(),\n    environmentName: environment,\n    environmentTarget: environment,\n  };\n}\n\nfunction resolveDeploymentUrl(): string | null {\n  const deploymentUrl = parseEnvValue(process.env[\"VERCEL_URL\"]);\n\n  if (deploymentUrl === null) {\n    return null;\n  }\n\n  if (\n    deploymentUrl.startsWith(\"https://\") ||\n    deploymentUrl.startsWith(\"http://\")\n  ) {\n    return deploymentUrl;\n  }\n\n  return `https://${deploymentUrl}`;\n}\n"],"mappings":";;AAGA,SAAgB,UAAsC;CACpD,MAAM,cAAc,cAClB,QAAQ,IAAI,iBAAiB,QAAQ,IAAI,qBAC1C;CAED,MAAM,eAAe,cAAc,QAAQ,IAAI,wBAAwB;CAEvE,OAAO;EACL,UAAU;EACV,sBAAsB;EACtB;EACA;EACA,eAAe,sBAAsB;EACrC,iBAAiB;EACjB,mBAAmB;EACpB;;AAGH,SAAS,uBAAsC;CAC7C,MAAM,gBAAgB,cAAc,QAAQ,IAAI,cAAc;CAE9D,IAAI,kBAAkB,MACpB,OAAO;CAGT,IACE,cAAc,WAAW,WAAW,IACpC,cAAc,WAAW,UAAU,EAEnC,OAAO;CAGT,OAAO,WAAW"}

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

@@ -1,4 +1,17 @@
 //#region src/internal/build/release/git.d.ts
+/**
+ * Runs a git command and returns its stdout, or `null` when git isn't
+ * available (no `.git` checkout, git binary missing, command errored).
+ *
+ * The ignore-on-failure shape lets callers compose this with env-var
+ * reads as a fallback chain — env vars first (CI environments where
+ * git isn't checked out), git as a last resort (local dev).
+ *
+ * Build-time only. `node:child_process` isn't available in the Edge
+ * runtime, so this helper must never end up in `instrumentation.ts`'s
+ * import graph (the SDK ships that entrypoint to both Node + Edge
+ * runtimes via conditional exports).
+ */
 declare function runGitCommand(command: string): string | null;
 //#endregion
 export { runGitCommand };

package/dist/internal/build/release/git.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.mts","names":[],"sources":["../../../../src/internal/build/release/git.ts"],"mappings":";iBAIgB,aAAA,CAAc,OAAA"}
+{"version":3,"file":"git.d.mts","names":[],"sources":["../../../../src/internal/build/release/git.ts"],"mappings":";;AAeA;;;;;;;;;;;;iBAAgB,aAAA,CAAc,OAAA"}

package/dist/internal/build/release/git.mjs

@@ -1,6 +1,18 @@
-import { log } from "../../logger.mjs";
 import { execSync } from "node:child_process";
 //#region src/internal/build/release/git.ts
+/**
+* Runs a git command and returns its stdout, or `null` when git isn't
+* available (no `.git` checkout, git binary missing, command errored).
+*
+* The ignore-on-failure shape lets callers compose this with env-var
+* reads as a fallback chain — env vars first (CI environments where
+* git isn't checked out), git as a last resort (local dev).
+*
+* Build-time only. `node:child_process` isn't available in the Edge
+* runtime, so this helper must never end up in `instrumentation.ts`'s
+* import graph (the SDK ships that entrypoint to both Node + Edge
+* runtimes via conditional exports).
+*/
 function runGitCommand(command) {
 	try {
 		const output = execSync(command, {
@@ -13,7 +25,6 @@ function runGitCommand(command) {
 		}).trim();
 		return output.length > 0 ? output : null;
 	} catch {
-		log.warn("Git unavailable", [`Failed: ${command}`]);
 		return null;
 	}
 }

package/dist/internal/build/release/git.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"git.mjs","names":[],"sources":["../../../../src/internal/build/release/git.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\n\nimport { log } from \"../../logger.js\";\n\nexport function runGitCommand(command: string): string | null {\n  try {\n    const output = execSync(command, {\n      encoding: \"utf8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n\n    return output.length > 0 ? output : null;\n  } catch {\n    log.warn(\"Git unavailable\", [`Failed: ${command}`]);\n    return null;\n  }\n}\n"],"mappings":";;;AAIA,SAAgB,cAAc,SAAgC;AAC5D,KAAI;EACF,MAAM,SAAS,SAAS,SAAS;GAC/B,UAAU;GACV,OAAO;IAAC;IAAU;IAAQ;IAAS;GACpC,CAAC,CAAC,MAAM;AAET,SAAO,OAAO,SAAS,IAAI,SAAS;SAC9B;AACN,MAAI,KAAK,mBAAmB,CAAC,WAAW,UAAU,CAAC;AACnD,SAAO"}
+{"version":3,"file":"git.mjs","names":[],"sources":["../../../../src/internal/build/release/git.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\n\n/**\n * Runs a git command and returns its stdout, or `null` when git isn't\n * available (no `.git` checkout, git binary missing, command errored).\n *\n * The ignore-on-failure shape lets callers compose this with env-var\n * reads as a fallback chain — env vars first (CI environments where\n * git isn't checked out), git as a last resort (local dev).\n *\n * Build-time only. `node:child_process` isn't available in the Edge\n * runtime, so this helper must never end up in `instrumentation.ts`'s\n * import graph (the SDK ships that entrypoint to both Node + Edge\n * runtimes via conditional exports).\n */\nexport function runGitCommand(command: string): string | null {\n  try {\n    const output = execSync(command, {\n      encoding: \"utf8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n\n    return output.length > 0 ? output : null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,SAAgC;CAC5D,IAAI;EACF,MAAM,SAAS,SAAS,SAAS;GAC/B,UAAU;GACV,OAAO;IAAC;IAAU;IAAQ;IAAS;GACpC,CAAC,CAAC,MAAM;EAET,OAAO,OAAO,SAAS,IAAI,SAAS;SAC9B;EACN,OAAO"}

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

@@ -1,7 +1,8 @@
+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, config: ReleasesConfigResponse): CreateReleaseRequest;
+declare function resolveReleaseRequest(buildId: string, releaseSlug: ReleaseSlug, config: ReleasesConfigResponse): CreateReleaseRequest;
 //#endregion
 export { resolveReleaseRequest };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/internal/build/release/index.ts"],"mappings":";;;;iBAyBgB,qBAAA,CACd,OAAA,UACA,MAAA,EAAQ,sBAAA,GACP,oBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/internal/build/release/index.ts"],"mappings":";;;;;iBASgB,qBAAA,CACd,OAAA,UACA,WAAA,EAAa,WAAA,EACb,MAAA,EAAQ,sBAAA,GACP,oBAAA"}

package/dist/internal/build/release/index.mjs

@@ -1,17 +1,16 @@
 import { log } from "../../logger.mjs";
 import { PRODUCER_VERSION } from "../../version.mjs";
-import { resolve } from "./destinations/vercel.mjs";
-import { resolve as resolve$1 } from "./sources/github.mjs";
+import { destinations } from "./destinations/index.mjs";
+import { sources } from "./sources/index.mjs";
 //#region src/internal/build/release/index.ts
-const sources = { github: resolve$1 };
-const destinations = { vercel: resolve };
-function resolveReleaseRequest(buildId, config) {
+function resolveReleaseRequest(buildId, releaseSlug, config) {
 	if (!config.surface.sourceProvider) return log.fatal("Missing version control provider", ["This surface does not have a version control provider configured.", `Configure one at https://interfere.com/~/${config.org.slug}/surfaces/${config.surface.slug}`]);
 	if (!config.surface.destinationProvider) return log.fatal("Missing deployment target", ["This surface does not have a deployment target integration configured.", `Configure one at https://interfere.com/~/${config.org.slug}/surfaces/${config.surface.slug}`]);
 	return {
 		source: sources[config.surface.sourceProvider](),
 		destination: destinations[config.surface.destinationProvider](),
 		buildId,
+		slug: releaseSlug,
 		producerVersion: PRODUCER_VERSION
 	};
 }