@interfere/next 9.0.1 → 10.0.0

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

@@ -1,29 +1,7 @@
 import { SourceMapFile } from "./discover.mjs";
+import { uploadSourceMaps } from "./upload.mjs";
 
 //#region src/internal/build/source-maps/index.d.ts
-declare function buildUploadBody(discovered: {
-  files: SourceMapFile[];
-  mapping: Record<string, string>;
-  sourceFileCount: number;
-}): {
-  body: {
-    files: {
-      fileName: string;
-      content: Blob;
-    }[];
-    metadata: {
-      sourceMapToGenerated: Record<string, string>;
-      hashes: {
-        [k: string]: string;
-      };
-      debugIds: {
-        [k: string]: string;
-      };
-      sourceFileCount: number;
-    };
-  };
-  totalBytes: number;
-};
 declare function cleanupSourceMaps(files: SourceMapFile[]): Promise<void>;
 //#endregion
-export { buildUploadBody, cleanupSourceMaps };
+export { cleanupSourceMaps, uploadSourceMaps };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/internal/build/source-maps/index.ts"],"mappings":";;;iBAIgB,eAAA,CAAgB,UAAA;EAC9B,KAAA,EAAO,aAAA;EACP,OAAA,EAAS,MAAA;EACT,eAAA;AAAA;;;;;;;;;;;;;;;;;;;iBAwBoB,iBAAA,CAAkB,KAAA,EAAO,aAAA,KAAe,OAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/internal/build/source-maps/index.ts"],"mappings":";;;;iBAKsB,iBAAA,CAAkB,KAAA,EAAO,aAAA,KAAkB,OAAA"}

package/dist/internal/build/source-maps/index.mjs

@@ -1,28 +1,18 @@
+import { log } from "../../logger.mjs";
+import { uploadSourceMaps } from "./upload.mjs";
 import { unlink } from "node:fs/promises";
 //#region src/internal/build/source-maps/index.ts
-function buildUploadBody(discovered) {
-	let totalBytes = 0;
-	return {
-		body: {
-			files: discovered.files.map((file) => {
-				totalBytes += file.content.length;
-				return {
-					fileName: file.path,
-					content: new Blob([file.content], { type: "application/json" })
-				};
-			}),
-			metadata: {
-				sourceMapToGenerated: discovered.mapping,
-				hashes: Object.fromEntries(discovered.files.map((f) => [f.path, f.hash])),
-				debugIds: Object.fromEntries(discovered.files.map((f) => [f.path, f.debugId])),
-				sourceFileCount: discovered.sourceFileCount
-			}
-		},
-		totalBytes
-	};
-}
 async function cleanupSourceMaps(files) {
-	await Promise.all(files.map((f) => unlink(f.absolute).catch(() => void 0)));
+	const results = await Promise.allSettled(files.map((f) => unlink(f.absolute)));
+	const failures = [];
+	for (const [i, r] of results.entries()) {
+		if (r.status !== "rejected") continue;
+		const err = r.reason;
+		if (err.code === "ENOENT") continue;
+		const file = files[i];
+		failures.push(`${file?.absolute ?? "<unknown>"}: ${err.code ?? err.message ?? String(err)}`);
+	}
+	if (failures.length > 0) log.warn("Source-map cleanup left files on disk", failures);
 }
 //#endregion
-export { buildUploadBody, cleanupSourceMaps };
+export { cleanupSourceMaps, uploadSourceMaps };

package/dist/internal/build/source-maps/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/internal/build/source-maps/index.ts"],"sourcesContent":["import { unlink } from \"node:fs/promises\";\n\nimport type { SourceMapFile } from \"./discover.js\";\n\nexport function buildUploadBody(discovered: {\n  files: SourceMapFile[];\n  mapping: Record<string, string>;\n  sourceFileCount: number;\n}) {\n  let totalBytes = 0;\n\n  const files = discovered.files.map((file) => {\n    totalBytes += file.content.length;\n    return {\n      fileName: file.path,\n      content: new Blob([file.content], { type: \"application/json\" }),\n    };\n  });\n\n  const metadata = {\n    sourceMapToGenerated: discovered.mapping,\n    hashes: Object.fromEntries(discovered.files.map((f) => [f.path, f.hash])),\n    debugIds: Object.fromEntries(\n      discovered.files.map((f) => [f.path, f.debugId])\n    ),\n    sourceFileCount: discovered.sourceFileCount,\n  };\n\n  return { body: { files, metadata }, totalBytes };\n}\n\nexport async function cleanupSourceMaps(files: SourceMapFile[]) {\n  await Promise.all(\n    files.map((f) => unlink(f.absolute).catch(() => undefined))\n  );\n}\n"],"mappings":";;AAIA,SAAgB,gBAAgB,YAI7B;CACD,IAAI,aAAa;AAmBjB,QAAO;EAAE,MAAM;GAAE,OAjBH,WAAW,MAAM,KAAK,SAAS;AAC3C,kBAAc,KAAK,QAAQ;AAC3B,WAAO;KACL,UAAU,KAAK;KACf,SAAS,IAAI,KAAK,CAAC,KAAK,QAAQ,EAAE,EAAE,MAAM,oBAAoB,CAAC;KAChE;KAYmB;GAAE,UAAA;IARtB,sBAAsB,WAAW;IACjC,QAAQ,OAAO,YAAY,WAAW,MAAM,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACzE,UAAU,OAAO,YACf,WAAW,MAAM,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CACjD;IACD,iBAAiB,WAAW;IAGE;GAAE;EAAE;EAAY;;AAGlD,eAAsB,kBAAkB,OAAwB;AAC9D,OAAM,QAAQ,IACZ,MAAM,KAAK,MAAM,OAAO,EAAE,SAAS,CAAC,YAAY,KAAA,EAAU,CAAC,CAC5D"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/internal/build/source-maps/index.ts"],"sourcesContent":["import { unlink } from \"node:fs/promises\";\n\nimport { log } from \"../../logger.js\";\nimport type { SourceMapFile } from \"./discover.js\";\n\nexport async function cleanupSourceMaps(files: SourceMapFile[]): Promise<void> {\n  // ENOENT is the only failure we silently absorb — a missing file just\n  // means the upload-then-cleanup race lost. Anything else (perm, IO,\n  // EBUSY) is a real signal: the source map is now stranded on the\n  // customer's CDN and we surface it via a single aggregated warning so\n  // an operator can investigate without the build failing outright.\n  const results = await Promise.allSettled(files.map((f) => unlink(f.absolute)));\n  const failures: string[] = [];\n  for (const [i, r] of results.entries()) {\n    if (r.status !== \"rejected\") {\n      continue;\n    }\n    const err = r.reason as NodeJS.ErrnoException;\n    if (err.code === \"ENOENT\") {\n      continue;\n    }\n    const file = files[i];\n    failures.push(\n      `${file?.absolute ?? \"<unknown>\"}: ${err.code ?? err.message ?? String(err)}`\n    );\n  }\n  if (failures.length > 0) {\n    log.warn(\"Source-map cleanup left files on disk\", failures);\n  }\n}\n\nexport { uploadSourceMaps } from \"./upload.js\";\n"],"mappings":";;;;AAKA,eAAsB,kBAAkB,OAAuC;CAM7E,MAAM,UAAU,MAAM,QAAQ,WAAW,MAAM,KAAK,MAAM,OAAO,EAAE,SAAS,CAAC,CAAC;CAC9E,MAAM,WAAqB,EAAE;CAC7B,KAAK,MAAM,CAAC,GAAG,MAAM,QAAQ,SAAS,EAAE;EACtC,IAAI,EAAE,WAAW,YACf;EAEF,MAAM,MAAM,EAAE;EACd,IAAI,IAAI,SAAS,UACf;EAEF,MAAM,OAAO,MAAM;EACnB,SAAS,KACP,GAAG,MAAM,YAAY,YAAY,IAAI,IAAI,QAAQ,IAAI,WAAW,OAAO,IAAI,GAC5E;;CAEH,IAAI,SAAS,SAAS,GACpB,IAAI,KAAK,yCAAyC,SAAS"}

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

@@ -0,0 +1,28 @@
+//#region src/internal/build/source-maps/paths.d.ts
+/**
+ * Strips Windows path separators and leading `./` segments so the rest of
+ * the discovery code can assume POSIX-style paths relative to `projectDir`.
+ */
+declare function normalizeDistDir(distDir?: string): string;
+/**
+ * Resolves an absolute filesystem path for the build's `distDir`. Accepts
+ * either an absolute path (passed through) or a path relative to
+ * `projectDir`.
+ */
+declare function resolveDistDir(projectDir: string, distDir: string): string;
+/**
+ * Maps an on-disk path (relative to `projectDir`) to the URL path Next.js
+ * will serve it at. Both `_next/` and `.next/` shapes resolve to the public
+ * `_next/` prefix the browser sees in `//# sourceMappingURL=...` comments.
+ */
+declare function toPublicPath(rel: string, distDir: string): string;
+/**
+ * Recursively collects files under `<absDistDir>/static` and
+ * `<absDistDir>/server` matching the given suffix. Both subtrees are
+ * optional — partial builds (e.g. server-only chunks during ISR) commonly
+ * leave one missing, so a missing directory is treated as empty rather
+ * than fatal.
+ */
+declare function walkDistTrees(absDistDir: string, suffix: ".js" | ".js.map"): Promise<string[]>;
+//#endregion
+export { normalizeDistDir, resolveDistDir, toPublicPath, walkDistTrees };

package/dist/internal/build/source-maps/paths.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.mts","names":[],"sources":["../../../../src/internal/build/source-maps/paths.ts"],"mappings":";;AAUA;;;iBAAgB,gBAAA,CAAiB,OAAA;;AASjC;;;;iBAAgB,cAAA,CAAe,UAAA,UAAoB,OAAA;AASnD;;;;;AAAA,iBAAgB,YAAA,CAAa,GAAA,UAAa,OAAA;;;;;;;;iBAkBpB,aAAA,CACpB,UAAA,UACA,MAAA,sBACC,OAAA"}

package/dist/internal/build/source-maps/paths.mjs

@@ -0,0 +1,49 @@
+import { isAbsolute, join, resolve } from "node:path";
+import { readdir } from "node:fs/promises";
+//#region src/internal/build/source-maps/paths.ts
+const NEXT_PUBLIC_PREFIX = "_next/";
+const NEXT_DIST_PREFIX = ".next/";
+/**
+* Strips Windows path separators and leading `./` segments so the rest of
+* the discovery code can assume POSIX-style paths relative to `projectDir`.
+*/
+function normalizeDistDir(distDir = ".next") {
+	return distDir.replaceAll("\\", "/").replace(/^(\.\/)+/, "");
+}
+/**
+* Resolves an absolute filesystem path for the build's `distDir`. Accepts
+* either an absolute path (passed through) or a path relative to
+* `projectDir`.
+*/
+function resolveDistDir(projectDir, distDir) {
+	return isAbsolute(distDir) ? distDir : resolve(projectDir, distDir);
+}
+/**
+* Maps an on-disk path (relative to `projectDir`) to the URL path Next.js
+* will serve it at. Both `_next/` and `.next/` shapes resolve to the public
+* `_next/` prefix the browser sees in `//# sourceMappingURL=...` comments.
+*/
+function toPublicPath(rel, distDir) {
+	const p = rel.replaceAll("\\", "/");
+	if (p.startsWith(`${distDir}/`)) return `${NEXT_PUBLIC_PREFIX}${p.slice(distDir.length + 1)}`;
+	if (p.startsWith(NEXT_DIST_PREFIX)) return `${NEXT_PUBLIC_PREFIX}${p.slice(6)}`;
+	return p;
+}
+/**
+* Recursively collects files under `<absDistDir>/static` and
+* `<absDistDir>/server` matching the given suffix. Both subtrees are
+* optional — partial builds (e.g. server-only chunks during ISR) commonly
+* leave one missing, so a missing directory is treated as empty rather
+* than fatal.
+*/
+async function walkDistTrees(absDistDir, suffix) {
+	return (await Promise.all(["static", "server"].map(async (subtree) => {
+		const root = join(absDistDir, subtree);
+		const entries = await readdir(root, { recursive: true }).catch(() => []);
+		const out = [];
+		for (const entry of entries) if (typeof entry === "string" && entry.endsWith(suffix)) out.push(join(root, entry));
+		return out;
+	}))).flat();
+}
+//#endregion
+export { normalizeDistDir, resolveDistDir, toPublicPath, walkDistTrees };

package/dist/internal/build/source-maps/paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../../../src/internal/build/source-maps/paths.ts"],"sourcesContent":["import { readdir } from \"node:fs/promises\";\nimport { isAbsolute, join, resolve } from \"node:path\";\n\nconst NEXT_PUBLIC_PREFIX = \"_next/\";\nconst NEXT_DIST_PREFIX = \".next/\";\n\n/**\n * Strips Windows path separators and leading `./` segments so the rest of\n * the discovery code can assume POSIX-style paths relative to `projectDir`.\n */\nexport function normalizeDistDir(distDir = \".next\"): string {\n  return distDir.replaceAll(\"\\\\\", \"/\").replace(/^(\\.\\/)+/, \"\");\n}\n\n/**\n * Resolves an absolute filesystem path for the build's `distDir`. Accepts\n * either an absolute path (passed through) or a path relative to\n * `projectDir`.\n */\nexport function resolveDistDir(projectDir: string, distDir: string): string {\n  return isAbsolute(distDir) ? distDir : resolve(projectDir, distDir);\n}\n\n/**\n * Maps an on-disk path (relative to `projectDir`) to the URL path Next.js\n * will serve it at. Both `_next/` and `.next/` shapes resolve to the public\n * `_next/` prefix the browser sees in `//# sourceMappingURL=...` comments.\n */\nexport function toPublicPath(rel: string, distDir: string): string {\n  const p = rel.replaceAll(\"\\\\\", \"/\");\n  if (p.startsWith(`${distDir}/`)) {\n    return `${NEXT_PUBLIC_PREFIX}${p.slice(distDir.length + 1)}`;\n  }\n  if (p.startsWith(NEXT_DIST_PREFIX)) {\n    return `${NEXT_PUBLIC_PREFIX}${p.slice(NEXT_DIST_PREFIX.length)}`;\n  }\n  return p;\n}\n\n/**\n * Recursively collects files under `<absDistDir>/static` and\n * `<absDistDir>/server` matching the given suffix. Both subtrees are\n * optional — partial builds (e.g. server-only chunks during ISR) commonly\n * leave one missing, so a missing directory is treated as empty rather\n * than fatal.\n */\nexport async function walkDistTrees(\n  absDistDir: string,\n  suffix: \".js\" | \".js.map\"\n): Promise<string[]> {\n  const subtrees = [\"static\", \"server\"] as const;\n\n  const results = await Promise.all(\n    subtrees.map(async (subtree) => {\n      const root = join(absDistDir, subtree);\n      const entries = await readdir(root, { recursive: true }).catch(\n        () => [] as string[]\n      );\n      const out: string[] = [];\n      for (const entry of entries) {\n        if (typeof entry === \"string\" && entry.endsWith(suffix)) {\n          out.push(join(root, entry));\n        }\n      }\n      return out;\n    })\n  );\n\n  return results.flat();\n}\n"],"mappings":";;;AAGA,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;;;;;AAMzB,SAAgB,iBAAiB,UAAU,SAAiB;CAC1D,OAAO,QAAQ,WAAW,MAAM,IAAI,CAAC,QAAQ,YAAY,GAAG;;;;;;;AAQ9D,SAAgB,eAAe,YAAoB,SAAyB;CAC1E,OAAO,WAAW,QAAQ,GAAG,UAAU,QAAQ,YAAY,QAAQ;;;;;;;AAQrE,SAAgB,aAAa,KAAa,SAAyB;CACjE,MAAM,IAAI,IAAI,WAAW,MAAM,IAAI;CACnC,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,EAC7B,OAAO,GAAG,qBAAqB,EAAE,MAAM,QAAQ,SAAS,EAAE;CAE5D,IAAI,EAAE,WAAW,iBAAiB,EAChC,OAAO,GAAG,qBAAqB,EAAE,MAAM,EAAwB;CAEjE,OAAO;;;;;;;;;AAUT,eAAsB,cACpB,YACA,QACmB;CAmBnB,QAAO,MAhBe,QAAQ,IAC5B,CAHgB,UAAU,SAGlB,CAAC,IAAI,OAAO,YAAY;EAC9B,MAAM,OAAO,KAAK,YAAY,QAAQ;EACtC,MAAM,UAAU,MAAM,QAAQ,MAAM,EAAE,WAAW,MAAM,CAAC,CAAC,YACjD,EAAE,CACT;EACD,MAAM,MAAgB,EAAE;EACxB,KAAK,MAAM,SAAS,SAClB,IAAI,OAAO,UAAU,YAAY,MAAM,SAAS,OAAO,EACrD,IAAI,KAAK,KAAK,MAAM,MAAM,CAAC;EAG/B,OAAO;GACP,CACH,EAEc,MAAM"}

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

@@ -0,0 +1,46 @@
+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;
+  totalBytes: number;
+}
+interface UploadParams {
+  apiUrl: string;
+  bundler: ManifestBundler;
+  discovered: DiscoveryResult;
+  httpClient: HTTPClient;
+  releaseSlug: ReleaseSlug;
+}
+/**
+ * Drives the three-step presigned-URL flow:
+ *
+ *   1. POST `/v1/releases/:slug/source-maps/sign` with per-file metadata.
+ *   2. PUT each file's content directly to R2 in parallel (concurrency
+ *      bounded so a build with 1000+ chunks doesn't open 1000 sockets).
+ *   3. POST `/v1/releases/:slug/source-maps/complete` to materialize the
+ *      manifest and update the release row.
+ *
+ * The collector never sees source-map bytes — uploads scale with R2
+ * 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>;
+interface SourceMapRichness {
+  hasSourcesContent: boolean;
+  hasNames: boolean;
+  hasFile: boolean;
+  mappingsPresent: boolean;
+}
+declare function extractRichness(content: string): SourceMapRichness;
+//#endregion
+export { UploadResult, extractRichness, uploadSourceMaps };

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.mts","names":[],"sources":["../../../../src/internal/build/source-maps/upload.ts"],"mappings":";;;;;;UAciB,YAAA;EACf,SAAA;EACA,UAAA;AAAA;AAAA,UAGQ,YAAA;EACR,MAAA;EACA,OAAA,EAAS,eAAA;EACT,UAAA,EAAY,eAAA;EACZ,UAAA,EAAY,UAAA;EACZ,WAAA,EAAa,WAAA;AAAA;;;;;;;;;;;;;;iBAgBO,gBAAA,CAAA;EACpB,MAAA;EACA,OAAA;EACA,UAAA;EACA,UAAA;EACA;AAAA,GACC,YAAA,GAAe,OAAA,CAAQ,YAAA;AAAA,UAoEhB,iBAAA;EACR,iBAAA;EACA,QAAA;EACA,OAAA;EACA,eAAA;AAAA;AAAA,iBAyBc,eAAA,CAAgB,OAAA,WAAkB,iBAAA"}

package/dist/internal/build/source-maps/upload.mjs

@@ -0,0 +1,134 @@
+//#region src/internal/build/source-maps/upload.ts
+const PUT_CONCURRENCY = 12;
+/**
+* Drives the three-step presigned-URL flow:
+*
+*   1. POST `/v1/releases/:slug/source-maps/sign` with per-file metadata.
+*   2. PUT each file's content directly to R2 in parallel (concurrency
+*      bounded so a build with 1000+ chunks doesn't open 1000 sockets).
+*   3. POST `/v1/releases/:slug/source-maps/complete` to materialize the
+*      manifest and update the release row.
+*
+* The collector never sees source-map bytes — uploads scale with R2
+* limits, not Cloudflare worker / load-balancer body-size caps. The
+* legacy multipart endpoint is still wired for older SDKs.
+*/
+async function uploadSourceMaps({ apiUrl, bundler, discovered, httpClient, releaseSlug }) {
+	const filesByPath = new Map(discovered.files.map((f) => [f.path, f]));
+	const signRequest = { files: discovered.files.map((file) => ({
+		path: file.path,
+		sizeBytes: byteLengthOf(file.content),
+		...extractRichness(file.content)
+	})) };
+	const signResponse = await postJson(httpClient, new URL(`/v1/releases/${encodeURIComponent(releaseSlug)}/source-maps/sign`, apiUrl), signRequest);
+	let totalBytes = 0;
+	await mapWithConcurrency(signResponse.uploads, PUT_CONCURRENCY, async (upload) => {
+		const file = filesByPath.get(upload.path);
+		if (!file) throw new Error(`Sign response referenced unknown path "${upload.path}"`);
+		totalBytes += byteLengthOf(file.content);
+		await putToR2(upload.presignedUrl, file.content);
+	});
+	const completeRequest = {
+		files: discovered.files.map((file) => ({
+			path: file.path,
+			hash: file.hash,
+			debugId: file.debugId,
+			chunkUrl: file.chunkUrl
+		})),
+		sourceFileCount: discovered.sourceFileCount,
+		bundler
+	};
+	return {
+		fileCount: (await postJson(httpClient, new URL(`/v1/releases/${encodeURIComponent(releaseSlug)}/source-maps/complete`, apiUrl), completeRequest)).fileCount,
+		totalBytes
+	};
+}
+function byteLengthOf(content) {
+	return new TextEncoder().encode(content).byteLength;
+}
+const EMPTY_RICHNESS = {
+	hasSourcesContent: false,
+	hasNames: false,
+	hasFile: false,
+	mappingsPresent: false
+};
+function leafRichness(map) {
+	const sourcesContent = map["sourcesContent"];
+	const names = map["names"];
+	const file = map["file"];
+	const mappings = map["mappings"];
+	return {
+		hasSourcesContent: Array.isArray(sourcesContent) && sourcesContent.length > 0,
+		hasNames: Array.isArray(names) && names.length > 0,
+		hasFile: typeof file === "string" && file.length > 0,
+		mappingsPresent: typeof mappings === "string" && mappings.length > 0
+	};
+}
+function extractRichness(content) {
+	let parsed;
+	try {
+		parsed = JSON.parse(content);
+	} catch {
+		return EMPTY_RICHNESS;
+	}
+	if (!(parsed && typeof parsed === "object")) return EMPTY_RICHNESS;
+	const top = parsed;
+	const sections = top["sections"];
+	if (!Array.isArray(sections)) return leafRichness(top);
+	const merged = {
+		hasSourcesContent: false,
+		hasNames: false,
+		hasFile: typeof top["file"] === "string" && top["file"].length > 0,
+		mappingsPresent: false
+	};
+	for (const section of sections) {
+		const inner = section?.map;
+		if (!(inner && typeof inner === "object")) continue;
+		const r = leafRichness(inner);
+		merged.hasSourcesContent ||= r.hasSourcesContent;
+		merged.hasNames ||= r.hasNames;
+		merged.mappingsPresent ||= r.mappingsPresent;
+	}
+	return merged;
+}
+async function postJson(httpClient, url, body) {
+	const response = await httpClient.request(new Request(url, {
+		method: "POST",
+		headers: {
+			"content-type": "application/json",
+			accept: "application/json"
+		},
+		body: JSON.stringify(body)
+	}));
+	if (!response.ok) {
+		const detail = await response.text().catch(() => "");
+		throw new Error(`Source-map API request failed: POST ${url.pathname} -> ${response.status} ${detail}`);
+	}
+	return await response.json();
+}
+async function putToR2(presignedUrl, content) {
+	const response = await fetch(presignedUrl, {
+		method: "PUT",
+		headers: { "content-type": "application/json" },
+		body: content
+	});
+	if (!response.ok) {
+		const detail = await response.text().catch(() => "");
+		throw new Error(`Source-map upload to R2 failed: ${response.status} ${detail}`);
+	}
+}
+async function mapWithConcurrency(items, concurrency, fn) {
+	let cursor = 0;
+	async function worker() {
+		while (true) {
+			const i = cursor++;
+			if (i >= items.length) return;
+			const item = items[i];
+			if (item === void 0) return;
+			await fn(item, i);
+		}
+	}
+	await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker()));
+}
+//#endregion
+export { extractRichness, uploadSourceMaps };

package/dist/internal/build/source-maps/upload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.mjs","names":[],"sources":["../../../../src/internal/build/source-maps/upload.ts"],"sourcesContent":["import type { HTTPClient } from \"@interfere/sdk\";\nimport type { ReleaseSlug } from \"@interfere/types/releases/slug\";\nimport type {\n  CompleteSourceMapsRequest,\n  CompleteSourceMapsResponse,\n  ManifestBundler,\n  SignSourceMapsRequest,\n  SignSourceMapsResponse,\n} from \"@interfere/types/data/source-maps\";\n\nimport type { DiscoveryResult } from \"./discover.js\";\n\nconst PUT_CONCURRENCY = 12;\n\nexport interface UploadResult {\n  fileCount: number;\n  totalBytes: number;\n}\n\ninterface UploadParams {\n  apiUrl: string;\n  bundler: ManifestBundler;\n  discovered: DiscoveryResult;\n  httpClient: HTTPClient;\n  releaseSlug: ReleaseSlug;\n}\n\n/**\n * Drives the three-step presigned-URL flow:\n *\n *   1. POST `/v1/releases/:slug/source-maps/sign` with per-file metadata.\n *   2. PUT each file's content directly to R2 in parallel (concurrency\n *      bounded so a build with 1000+ chunks doesn't open 1000 sockets).\n *   3. POST `/v1/releases/:slug/source-maps/complete` to materialize the\n *      manifest and update the release row.\n *\n * The collector never sees source-map bytes — uploads scale with R2\n * limits, not Cloudflare worker / load-balancer body-size caps. The\n * legacy multipart endpoint is still wired for older SDKs.\n */\nexport async function uploadSourceMaps({\n  apiUrl,\n  bundler,\n  discovered,\n  httpClient,\n  releaseSlug,\n}: UploadParams): Promise<UploadResult> {\n  const filesByPath = new Map(discovered.files.map((f) => [f.path, f]));\n\n  const signRequest = {\n    files: discovered.files.map((file) => ({\n      path: file.path,\n      sizeBytes: byteLengthOf(file.content),\n      ...extractRichness(file.content),\n    })),\n  } satisfies SignSourceMapsRequest;\n\n  const signResponse = await postJson<SignSourceMapsResponse>(\n    httpClient,\n    new URL(\n      `/v1/releases/${encodeURIComponent(releaseSlug)}/source-maps/sign`,\n      apiUrl\n    ),\n    signRequest\n  );\n\n  let totalBytes = 0;\n\n  await mapWithConcurrency(\n    signResponse.uploads,\n    PUT_CONCURRENCY,\n    async (upload) => {\n      const file = filesByPath.get(upload.path);\n      if (!file) {\n        throw new Error(\n          `Sign response referenced unknown path \"${upload.path}\"`\n        );\n      }\n\n      totalBytes += byteLengthOf(file.content);\n      await putToR2(upload.presignedUrl, file.content);\n    }\n  );\n\n  const completeRequest = {\n    files: discovered.files.map((file) => ({\n      path: file.path,\n      hash: file.hash,\n      debugId: file.debugId,\n      chunkUrl: file.chunkUrl,\n    })),\n    sourceFileCount: discovered.sourceFileCount,\n    bundler,\n  } satisfies CompleteSourceMapsRequest;\n\n  const completeResponse = await postJson<CompleteSourceMapsResponse>(\n    httpClient,\n    new URL(\n      `/v1/releases/${encodeURIComponent(releaseSlug)}/source-maps/complete`,\n      apiUrl\n    ),\n    completeRequest\n  );\n\n  return {\n    fileCount: completeResponse.fileCount,\n    totalBytes,\n  };\n}\n\nfunction byteLengthOf(content: string) {\n  return new TextEncoder().encode(content).byteLength;\n}\n\ninterface SourceMapRichness {\n  hasSourcesContent: boolean;\n  hasNames: boolean;\n  hasFile: boolean;\n  mappingsPresent: boolean;\n}\n\nconst EMPTY_RICHNESS: SourceMapRichness = {\n  hasSourcesContent: false,\n  hasNames: false,\n  hasFile: false,\n  mappingsPresent: false,\n};\n\nfunction leafRichness(map: Record<string, unknown>): SourceMapRichness {\n  const sourcesContent = map[\"sourcesContent\"];\n  const names = map[\"names\"];\n  const file = map[\"file\"];\n  const mappings = map[\"mappings\"];\n\n  return {\n    hasSourcesContent:\n      Array.isArray(sourcesContent) && sourcesContent.length > 0,\n    hasNames: Array.isArray(names) && names.length > 0,\n    hasFile: typeof file === \"string\" && file.length > 0,\n    mappingsPresent: typeof mappings === \"string\" && mappings.length > 0,\n  };\n}\n\nexport function extractRichness(content: string): SourceMapRichness {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(content);\n  } catch {\n    return EMPTY_RICHNESS;\n  }\n\n  if (!(parsed && typeof parsed === \"object\")) {\n    return EMPTY_RICHNESS;\n  }\n\n  const top = parsed as Record<string, unknown>;\n  const sections = top[\"sections\"];\n\n  if (!Array.isArray(sections)) {\n    return leafRichness(top);\n  }\n\n  const merged: SourceMapRichness = {\n    hasSourcesContent: false,\n    hasNames: false,\n    hasFile: typeof top[\"file\"] === \"string\" && (top[\"file\"] as string).length > 0,\n    mappingsPresent: false,\n  };\n\n  for (const section of sections) {\n    const inner = (section as { map?: unknown } | null)?.map;\n    if (!(inner && typeof inner === \"object\")) {\n      continue;\n    }\n    const r = leafRichness(inner as Record<string, unknown>);\n    merged.hasSourcesContent ||= r.hasSourcesContent;\n    merged.hasNames ||= r.hasNames;\n    merged.mappingsPresent ||= r.mappingsPresent;\n  }\n\n  return merged;\n}\n\nasync function postJson<T>(\n  httpClient: HTTPClient,\n  url: URL,\n  body: unknown\n): Promise<T> {\n  const response = await httpClient.request(\n    new Request(url, {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        accept: \"application/json\",\n      },\n      body: JSON.stringify(body),\n    })\n  );\n\n  if (!response.ok) {\n    const detail = await response.text().catch(() => \"\");\n    throw new Error(\n      `Source-map API request failed: POST ${url.pathname} -> ${response.status} ${detail}`\n    );\n  }\n\n  return (await response.json()) as T;\n}\n\nasync function putToR2(presignedUrl: string, content: string) {\n  const response = await fetch(presignedUrl, {\n    method: \"PUT\",\n    headers: { \"content-type\": \"application/json\" },\n    body: content,\n  });\n\n  if (!response.ok) {\n    const detail = await response.text().catch(() => \"\");\n    throw new Error(\n      `Source-map upload to R2 failed: ${response.status} ${detail}`\n    );\n  }\n}\n\nasync function mapWithConcurrency<T>(\n  items: T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<void>\n): Promise<void> {\n  let cursor = 0;\n\n  async function worker() {\n    while (true) {\n      const i = cursor++;\n      if (i >= items.length) {\n        return;\n      }\n      const item = items[i];\n      // Index is bounded by `items.length` above; the assertion is\n      // narrowing for noUncheckedIndexedAccess, not a runtime check.\n      if (item === undefined) {\n        return;\n      }\n      await fn(item, i);\n    }\n  }\n\n  await Promise.all(\n    Array.from({ length: Math.min(concurrency, items.length) }, () => worker())\n  );\n}\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"value-injection-loader.mjs","names":[],"sources":["../../../src/internal/build/value-injection-loader.ts"],"sourcesContent":["import type { InterfereInjectedValues } from \"./configure-build.js\";\n\nexport interface ValueInjectionLoaderOptions {\n  readonly serializedValues?: string;\n  readonly values?: Partial<InterfereInjectedValues>;\n}\n\ninterface LoaderThis<T> {\n  getOptions(): T;\n}\n\nexport default function valueInjectionLoader(\n  this: LoaderThis<ValueInjectionLoaderOptions>,\n  userCode: string\n): string {\n  const values = resolveValues(this.getOptions());\n  const lines = Object.entries(values)\n    .filter(([, value]) => value !== undefined)\n    .map(([key, value]) => {\n      const escapedKey = key.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n      return `globalThis[\"${escapedKey}\"] = ${JSON.stringify(value)};`;\n    });\n\n  if (lines.length === 0) {\n    return userCode;\n  }\n\n  return `${lines.join(\"\\n\")}\\n${userCode}`;\n}\n\nfunction resolveValues(\n  options: ValueInjectionLoaderOptions\n): Record<string, unknown> {\n  if (typeof options.serializedValues === \"string\") {\n    try {\n      const parsed = JSON.parse(options.serializedValues);\n      if (isRecord(parsed)) {\n        return parsed;\n      }\n      return {};\n    } catch {\n      return {};\n    }\n  }\n\n  return options.values ?? {};\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"mappings":";AAWA,SAAwB,qBAEtB,UACQ;CACR,MAAM,SAAS,cAAc,KAAK,YAAY,CAAC;CAC/C,MAAM,QAAQ,OAAO,QAAQ,OAAO,CACjC,QAAQ,GAAG,WAAW,UAAU,KAAA,EAAU,CAC1C,KAAK,CAAC,KAAK,WAAW;AAErB,SAAO,eADY,IAAI,QAAQ,OAAO,OAAO,CAAC,QAAQ,MAAM,OAC5B,CAAC,OAAO,KAAK,UAAU,MAAM,CAAC;GAC9D;AAEJ,KAAI,MAAM,WAAW,EACnB,QAAO;AAGT,QAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI;;AAGjC,SAAS,cACP,SACyB;AACzB,KAAI,OAAO,QAAQ,qBAAqB,SACtC,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,QAAQ,iBAAiB;AACnD,MAAI,SAAS,OAAO,CAClB,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;AAIb,QAAO,QAAQ,UAAU,EAAE;;AAG7B,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM"}
+{"version":3,"file":"value-injection-loader.mjs","names":[],"sources":["../../../src/internal/build/value-injection-loader.ts"],"sourcesContent":["import type { InterfereInjectedValues } from \"./configure-build.js\";\n\nexport interface ValueInjectionLoaderOptions {\n  readonly serializedValues?: string;\n  readonly values?: Partial<InterfereInjectedValues>;\n}\n\ninterface LoaderThis<T> {\n  getOptions(): T;\n}\n\nexport default function valueInjectionLoader(\n  this: LoaderThis<ValueInjectionLoaderOptions>,\n  userCode: string\n): string {\n  const values = resolveValues(this.getOptions());\n  const lines = Object.entries(values)\n    .filter(([, value]) => value !== undefined)\n    .map(([key, value]) => {\n      const escapedKey = key.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n      return `globalThis[\"${escapedKey}\"] = ${JSON.stringify(value)};`;\n    });\n\n  if (lines.length === 0) {\n    return userCode;\n  }\n\n  return `${lines.join(\"\\n\")}\\n${userCode}`;\n}\n\nfunction resolveValues(\n  options: ValueInjectionLoaderOptions\n): Record<string, unknown> {\n  if (typeof options.serializedValues === \"string\") {\n    try {\n      const parsed = JSON.parse(options.serializedValues);\n      if (isRecord(parsed)) {\n        return parsed;\n      }\n      return {};\n    } catch {\n      return {};\n    }\n  }\n\n  return options.values ?? {};\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"mappings":";AAWA,SAAwB,qBAEtB,UACQ;CACR,MAAM,SAAS,cAAc,KAAK,YAAY,CAAC;CAC/C,MAAM,QAAQ,OAAO,QAAQ,OAAO,CACjC,QAAQ,GAAG,WAAW,UAAU,KAAA,EAAU,CAC1C,KAAK,CAAC,KAAK,WAAW;EAErB,OAAO,eADY,IAAI,QAAQ,OAAO,OAAO,CAAC,QAAQ,MAAM,OAC5B,CAAC,OAAO,KAAK,UAAU,MAAM,CAAC;GAC9D;CAEJ,IAAI,MAAM,WAAW,GACnB,OAAO;CAGT,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI;;AAGjC,SAAS,cACP,SACyB;CACzB,IAAI,OAAO,QAAQ,qBAAqB,UACtC,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,QAAQ,iBAAiB;EACnD,IAAI,SAAS,OAAO,EAClB,OAAO;EAET,OAAO,EAAE;SACH;EACN,OAAO,EAAE;;CAIb,OAAO,QAAQ,UAAU,EAAE;;AAG7B,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM"}

package/dist/internal/env.d.mts

@@ -11,7 +11,16 @@ interface InterfereEnv {
     readonly destinationId: string | null;
   };
 }
-declare function isEnabledInEnvironment(): boolean;
+/**
+ * Server-side gate for the proxy route handler, the `captureError` /
+ * `onRequestError` helpers, and the remote-config fetcher. Distinct
+ * from the browser-side `isEnabledByEnvironment` (in
+ * `@interfere/react/internal/kernel`) because the server has different
+ * env conventions: `NEXT_PUBLIC_INTERFERE_FORCE_ENABLE` is the dev
+ * opt-in, and there's no "unknown runtime, default enabled" case the
+ * way the browser SDK has for plain-browser / Vite hosts.
+ */
+declare function isEnabledOnServer(): boolean;
 declare function readInterfereEnv(): InterfereEnv;
 //#endregion
-export { InterfereEnv, isEnabledInEnvironment, readInterfereEnv };
+export { InterfereEnv, isEnabledOnServer, readInterfereEnv };

package/dist/internal/env.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/internal/env.ts"],"mappings":";;;UAKiB,YAAA;EAAA,SACN,MAAA;EAAA,SACA,MAAA;EAAA,SACA,WAAA;EAAA,SACA,eAAA,EAAiB,OAAA,CAAQ,GAAA;EAAA,SACzB,OAAA;IAAA,SACE,QAAA;IAAA,SACA,aAAA;EAAA;AAAA;AAAA,iBAIG,sBAAA,CAAA;AAAA,iBAOA,gBAAA,CAAA,GAAoB,YAAA"}
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/internal/env.ts"],"mappings":";;;UAKiB,YAAA;EAAA,SACN,MAAA;EAAA,SACA,MAAA;EAAA,SACA,WAAA;EAAA,SACA,eAAA,EAAiB,OAAA,CAAQ,GAAA;EAAA,SACzB,OAAA;IAAA,SACE,QAAA;IAAA,SACA,aAAA;EAAA;AAAA;;;;;;;;AAab;;iBAAgB,iBAAA,CAAA;AAAA,iBAOA,gBAAA,CAAA,GAAoB,YAAA"}

package/dist/internal/env.mjs

@@ -1,8 +1,17 @@
-import { parseEnvValue } from "@interfere/types/sdk/env";
 import { API_URL } from "@interfere/constants/api";
+import { parseEnvValue } from "@interfere/types/sdk/env";
 import { normalizeEnv } from "@interfere/types/sdk/runtime";
 //#region src/internal/env.ts
-function isEnabledInEnvironment() {
+/**
+* Server-side gate for the proxy route handler, the `captureError` /
+* `onRequestError` helpers, and the remote-config fetcher. Distinct
+* from the browser-side `isEnabledByEnvironment` (in
+* `@interfere/react/internal/kernel`) because the server has different
+* env conventions: `NEXT_PUBLIC_INTERFERE_FORCE_ENABLE` is the dev
+* opt-in, and there's no "unknown runtime, default enabled" case the
+* way the browser SDK has for plain-browser / Vite hosts.
+*/
+function isEnabledOnServer() {
 	if (process.env["NODE_ENV"] === "production") return true;
 	return !!process.env["NEXT_PUBLIC_INTERFERE_FORCE_ENABLE"];
 }
@@ -20,4 +29,4 @@ function readInterfereEnv() {
 	};
 }
 //#endregion
-export { isEnabledInEnvironment, readInterfereEnv };
+export { isEnabledOnServer, readInterfereEnv };

package/dist/internal/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","names":[],"sources":["../../src/internal/env.ts"],"sourcesContent":["import { API_URL } from \"@interfere/constants/api\";\nimport { parseEnvValue } from \"@interfere/types/sdk/env\";\nimport type { Env } from \"@interfere/types/sdk/runtime\";\nimport { normalizeEnv } from \"@interfere/types/sdk/runtime\";\n\nexport interface InterfereEnv {\n  readonly apiKey: string | null;\n  readonly apiUrl: string;\n  readonly nextRuntime: string | null;\n  readonly nodeEnvironment: Exclude<Env, null>;\n  readonly release: {\n    readonly sourceId: string | null;\n    readonly destinationId: string | null;\n  };\n}\n\nexport function isEnabledInEnvironment(): boolean {\n  if (process.env[\"NODE_ENV\"] === \"production\") {\n    return true;\n  }\n  return !!process.env[\"NEXT_PUBLIC_INTERFERE_FORCE_ENABLE\"];\n}\n\nexport function readInterfereEnv(): InterfereEnv {\n  const nodeEnvironment = normalizeEnv(process.env[\"NODE_ENV\"]) ?? \"production\";\n\n  return {\n    apiKey: parseEnvValue(process.env[\"INTERFERE_API_KEY\"]),\n    apiUrl: parseEnvValue(process.env[\"INTERFERE_API_URL\"]) ?? API_URL,\n    nextRuntime: parseEnvValue(process.env[\"NEXT_RUNTIME\"]),\n    nodeEnvironment,\n    release: {\n      sourceId: parseEnvValue(process.env[\"NEXT_PUBLIC_INTERFERE_BUILD_ID\"]),\n      destinationId: parseEnvValue(\n        process.env[\"NEXT_PUBLIC_INTERFERE_RELEASE_ID\"]\n      ),\n    },\n  };\n}\n"],"mappings":";;;;AAgBA,SAAgB,yBAAkC;AAChD,KAAI,QAAQ,IAAI,gBAAgB,aAC9B,QAAO;AAET,QAAO,CAAC,CAAC,QAAQ,IAAI;;AAGvB,SAAgB,mBAAiC;CAC/C,MAAM,kBAAkB,aAAa,QAAQ,IAAI,YAAY,IAAI;AAEjE,QAAO;EACL,QAAQ,cAAc,QAAQ,IAAI,qBAAqB;EACvD,QAAQ,cAAc,QAAQ,IAAI,qBAAqB,IAAI;EAC3D,aAAa,cAAc,QAAQ,IAAI,gBAAgB;EACvD;EACA,SAAS;GACP,UAAU,cAAc,QAAQ,IAAI,kCAAkC;GACtE,eAAe,cACb,QAAQ,IAAI,oCACb;GACF;EACF"}
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/internal/env.ts"],"sourcesContent":["import { API_URL } from \"@interfere/constants/api\";\nimport { parseEnvValue } from \"@interfere/types/sdk/env\";\nimport type { Env } from \"@interfere/types/sdk/runtime\";\nimport { normalizeEnv } from \"@interfere/types/sdk/runtime\";\n\nexport interface InterfereEnv {\n  readonly apiKey: string | null;\n  readonly apiUrl: string;\n  readonly nextRuntime: string | null;\n  readonly nodeEnvironment: Exclude<Env, null>;\n  readonly release: {\n    readonly sourceId: string | null;\n    readonly destinationId: string | null;\n  };\n}\n\n/**\n * Server-side gate for the proxy route handler, the `captureError` /\n * `onRequestError` helpers, and the remote-config fetcher. Distinct\n * from the browser-side `isEnabledByEnvironment` (in\n * `@interfere/react/internal/kernel`) because the server has different\n * env conventions: `NEXT_PUBLIC_INTERFERE_FORCE_ENABLE` is the dev\n * opt-in, and there's no \"unknown runtime, default enabled\" case the\n * way the browser SDK has for plain-browser / Vite hosts.\n */\nexport function isEnabledOnServer(): boolean {\n  if (process.env[\"NODE_ENV\"] === \"production\") {\n    return true;\n  }\n  return !!process.env[\"NEXT_PUBLIC_INTERFERE_FORCE_ENABLE\"];\n}\n\nexport function readInterfereEnv(): InterfereEnv {\n  const nodeEnvironment = normalizeEnv(process.env[\"NODE_ENV\"]) ?? \"production\";\n\n  return {\n    apiKey: parseEnvValue(process.env[\"INTERFERE_API_KEY\"]),\n    apiUrl: parseEnvValue(process.env[\"INTERFERE_API_URL\"]) ?? API_URL,\n    nextRuntime: parseEnvValue(process.env[\"NEXT_RUNTIME\"]),\n    nodeEnvironment,\n    release: {\n      sourceId: parseEnvValue(process.env[\"NEXT_PUBLIC_INTERFERE_BUILD_ID\"]),\n      destinationId: parseEnvValue(\n        process.env[\"NEXT_PUBLIC_INTERFERE_RELEASE_ID\"]\n      ),\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAyBA,SAAgB,oBAA6B;CAC3C,IAAI,QAAQ,IAAI,gBAAgB,cAC9B,OAAO;CAET,OAAO,CAAC,CAAC,QAAQ,IAAI;;AAGvB,SAAgB,mBAAiC;CAC/C,MAAM,kBAAkB,aAAa,QAAQ,IAAI,YAAY,IAAI;CAEjE,OAAO;EACL,QAAQ,cAAc,QAAQ,IAAI,qBAAqB;EACvD,QAAQ,cAAc,QAAQ,IAAI,qBAAqB,IAAI;EAC3D,aAAa,cAAc,QAAQ,IAAI,gBAAgB;EACvD;EACA,SAAS;GACP,UAAU,cAAc,QAAQ,IAAI,kCAAkC;GACtE,eAAe,cACb,QAAQ,IAAI,oCACb;GACF;EACF"}

package/dist/internal/logger.d.mts

@@ -1,4 +1,12 @@
 //#region src/internal/logger.d.ts
+/**
+ * Thrown by `log.fatal` in test environments where `process.exit` is not
+ * appropriate. Tagged so callers' catch blocks can re-throw fatal errors and
+ * keep test-env behavior aligned with the production hard-exit.
+ */
+declare class FatalError extends Error {
+  readonly name = "FatalError";
+}
 declare const log: {
   info: (title: string, lines: string[]) => void;
   warn: (title: string, lines: string[]) => void;
@@ -6,4 +14,4 @@ declare const log: {
   fatal(title: string, lines: string[]): never;
 };
 //#endregion
-export { log };
+export { FatalError, log };

package/dist/internal/logger.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/internal/logger.ts"],"mappings":";cA6Ea,GAAA;wBACS,KAAA;wBACA,KAAA;yBACC,KAAA;uBACF,KAAA;AAAA"}
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/internal/logger.ts"],"mappings":";;AAuDA;;;;cAAa,UAAA,SAAmB,KAAA;EAAA,SACZ,IAAA;AAAA;AAAA,cA8BP,GAAA;wBACS,KAAA;wBACA,KAAA;yBACC,KAAA;uBACF,KAAA;AAAA"}

package/dist/internal/logger.mjs

@@ -35,6 +35,14 @@ const consoleMethods = {
 function isTestEnv() {
 	return Boolean(process.env["VITEST"] || process.env["VITEST_WORKER_ID"]);
 }
+/**
+* Thrown by `log.fatal` in test environments where `process.exit` is not
+* appropriate. Tagged so callers' catch blocks can re-throw fatal errors and
+* keep test-env behavior aligned with the production hard-exit.
+*/
+var FatalError = class extends Error {
+	name = "FatalError";
+};
 function emit(level, title, lines) {
 	if (isTestEnv()) return;
 	const style = styles[level];
@@ -52,9 +60,9 @@ const log = {
 	error: (title, lines) => emit("error", title, lines),
 	fatal(title, lines) {
 		emit("fatal", title, lines);
-		if (isTestEnv()) throw new Error(title);
+		if (isTestEnv()) throw new FatalError(title);
 		process.exit(1);
 	}
 };
 //#endregion
-export { log };
+export { FatalError, log };

package/dist/internal/logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/internal/logger.ts"],"sourcesContent":["import chalk from \"chalk\";\n\ntype LogLevel = \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nconst styles = {\n  info: {\n    prefix: `${chalk.whiteBright.bold(\"❖\")}`,\n    text: chalk.cyan.bold,\n    content: chalk.white,\n    prependLevel: false,\n  },\n  warn: {\n    prefix: `${chalk.yellow.bold(\"⚠\")} `,\n    text: chalk.yellow.bold,\n    content: chalk.yellowBright,\n    prependLevel: false,\n  },\n  error: {\n    prefix: `${chalk.red.bold(\"⨯\")} `,\n    text: chalk.red.bold,\n    content: chalk.redBright,\n    prependLevel: true,\n  },\n  fatal: {\n    prefix: `${chalk.red.bold(\"⨯\")} `,\n    text: chalk.red.bold,\n    content: chalk.redBright,\n    prependLevel: true,\n  },\n} satisfies Record<\n  LogLevel,\n  {\n    prefix: string;\n    text: typeof chalk.bold;\n    content: typeof chalk;\n    prependLevel: boolean;\n  }\n>;\n\nconst consoleMethods = {\n  info: \"log\",\n  warn: \"warn\",\n  error: \"error\",\n  fatal: \"error\",\n} satisfies Record<LogLevel, string>;\n\nfunction isTestEnv() {\n  return Boolean(process.env[\"VITEST\"] || process.env[\"VITEST_WORKER_ID\"]);\n}\n\nfunction emit(level: LogLevel, title: string, lines: string[]) {\n  if (isTestEnv()) {\n    return;\n  }\n\n  const style = styles[level];\n  const method = consoleMethods[level] as keyof Console;\n  const fn = globalThis.console[method];\n  if (typeof fn !== \"function\") {\n    return;\n  }\n\n  const invoke = (...args: unknown[]) =>\n    Reflect.apply(fn, globalThis.console, args);\n\n  const prependLevel = style.prependLevel\n    ? `[${style.text(level.toUpperCase())}] `\n    : \"\";\n\n  invoke(`${prependLevel} ${chalk.white(\"Interfere →\")} ${style.text(title)}`);\n\n  for (const [i, line] of lines.entries()) {\n    const connector = i === lines.length - 1 ? \"└\" : \"├\";\n    invoke(`${prependLevel} ${connector} ${style.content(line)}`);\n  }\n}\n\nexport const log = {\n  info: (title: string, lines: string[]) => emit(\"info\", title, lines),\n  warn: (title: string, lines: string[]) => emit(\"warn\", title, lines),\n  error: (title: string, lines: string[]) => emit(\"error\", title, lines),\n  fatal(title: string, lines: string[]): never {\n    emit(\"fatal\", title, lines);\n\n    if (isTestEnv()) {\n      throw new Error(title);\n    }\n\n    process.exit(1);\n  },\n};\n"],"mappings":";;AAIA,MAAM,SAAS;CACb,MAAM;EACJ,QAAQ,GAAG,MAAM,YAAY,KAAK,IAAI;EACtC,MAAM,MAAM,KAAK;EACjB,SAAS,MAAM;EACf,cAAc;EACf;CACD,MAAM;EACJ,QAAQ,GAAG,MAAM,OAAO,KAAK,IAAI,CAAC;EAClC,MAAM,MAAM,OAAO;EACnB,SAAS,MAAM;EACf,cAAc;EACf;CACD,OAAO;EACL,QAAQ,GAAG,MAAM,IAAI,KAAK,IAAI,CAAC;EAC/B,MAAM,MAAM,IAAI;EAChB,SAAS,MAAM;EACf,cAAc;EACf;CACD,OAAO;EACL,QAAQ,GAAG,MAAM,IAAI,KAAK,IAAI,CAAC;EAC/B,MAAM,MAAM,IAAI;EAChB,SAAS,MAAM;EACf,cAAc;EACf;CACF;AAUD,MAAM,iBAAiB;CACrB,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,SAAS,YAAY;AACnB,QAAO,QAAQ,QAAQ,IAAI,aAAa,QAAQ,IAAI,oBAAoB;;AAG1E,SAAS,KAAK,OAAiB,OAAe,OAAiB;AAC7D,KAAI,WAAW,CACb;CAGF,MAAM,QAAQ,OAAO;CACrB,MAAM,SAAS,eAAe;CAC9B,MAAM,KAAK,WAAW,QAAQ;AAC9B,KAAI,OAAO,OAAO,WAChB;CAGF,MAAM,UAAU,GAAG,SACjB,QAAQ,MAAM,IAAI,WAAW,SAAS,KAAK;CAE7C,MAAM,eAAe,MAAM,eACvB,IAAI,MAAM,KAAK,MAAM,aAAa,CAAC,CAAC,MACpC;AAEJ,QAAO,GAAG,aAAa,GAAG,MAAM,MAAM,cAAc,CAAC,GAAG,MAAM,KAAK,MAAM,GAAG;AAE5E,MAAK,MAAM,CAAC,GAAG,SAAS,MAAM,SAAS,CAErC,QAAO,GAAG,aAAa,GADL,MAAM,MAAM,SAAS,IAAI,MAAM,IACb,GAAG,MAAM,QAAQ,KAAK,GAAG;;AAIjE,MAAa,MAAM;CACjB,OAAO,OAAe,UAAoB,KAAK,QAAQ,OAAO,MAAM;CACpE,OAAO,OAAe,UAAoB,KAAK,QAAQ,OAAO,MAAM;CACpE,QAAQ,OAAe,UAAoB,KAAK,SAAS,OAAO,MAAM;CACtE,MAAM,OAAe,OAAwB;AAC3C,OAAK,SAAS,OAAO,MAAM;AAE3B,MAAI,WAAW,CACb,OAAM,IAAI,MAAM,MAAM;AAGxB,UAAQ,KAAK,EAAE;;CAElB"}
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/internal/logger.ts"],"sourcesContent":["import chalk from \"chalk\";\n\ntype LogLevel = \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nconst styles = {\n  info: {\n    prefix: `${chalk.whiteBright.bold(\"❖\")}`,\n    text: chalk.cyan.bold,\n    content: chalk.white,\n    prependLevel: false,\n  },\n  warn: {\n    prefix: `${chalk.yellow.bold(\"⚠\")} `,\n    text: chalk.yellow.bold,\n    content: chalk.yellowBright,\n    prependLevel: false,\n  },\n  error: {\n    prefix: `${chalk.red.bold(\"⨯\")} `,\n    text: chalk.red.bold,\n    content: chalk.redBright,\n    prependLevel: true,\n  },\n  fatal: {\n    prefix: `${chalk.red.bold(\"⨯\")} `,\n    text: chalk.red.bold,\n    content: chalk.redBright,\n    prependLevel: true,\n  },\n} satisfies Record<\n  LogLevel,\n  {\n    prefix: string;\n    text: typeof chalk.bold;\n    content: typeof chalk;\n    prependLevel: boolean;\n  }\n>;\n\nconst consoleMethods = {\n  info: \"log\",\n  warn: \"warn\",\n  error: \"error\",\n  fatal: \"error\",\n} satisfies Record<LogLevel, string>;\n\nfunction isTestEnv() {\n  return Boolean(process.env[\"VITEST\"] || process.env[\"VITEST_WORKER_ID\"]);\n}\n\n/**\n * Thrown by `log.fatal` in test environments where `process.exit` is not\n * appropriate. Tagged so callers' catch blocks can re-throw fatal errors and\n * keep test-env behavior aligned with the production hard-exit.\n */\nexport class FatalError extends Error {\n  override readonly name = \"FatalError\";\n}\n\nfunction emit(level: LogLevel, title: string, lines: string[]) {\n  if (isTestEnv()) {\n    return;\n  }\n\n  const style = styles[level];\n  const method = consoleMethods[level] as keyof Console;\n  const fn = globalThis.console[method];\n  if (typeof fn !== \"function\") {\n    return;\n  }\n\n  const invoke = (...args: unknown[]) =>\n    Reflect.apply(fn, globalThis.console, args);\n\n  const prependLevel = style.prependLevel\n    ? `[${style.text(level.toUpperCase())}] `\n    : \"\";\n\n  invoke(`${prependLevel} ${chalk.white(\"Interfere →\")} ${style.text(title)}`);\n\n  for (const [i, line] of lines.entries()) {\n    const connector = i === lines.length - 1 ? \"└\" : \"├\";\n    invoke(`${prependLevel} ${connector} ${style.content(line)}`);\n  }\n}\n\nexport const log = {\n  info: (title: string, lines: string[]) => emit(\"info\", title, lines),\n  warn: (title: string, lines: string[]) => emit(\"warn\", title, lines),\n  error: (title: string, lines: string[]) => emit(\"error\", title, lines),\n  fatal(title: string, lines: string[]): never {\n    emit(\"fatal\", title, lines);\n\n    if (isTestEnv()) {\n      throw new FatalError(title);\n    }\n\n    process.exit(1);\n  },\n};\n"],"mappings":";;AAIA,MAAM,SAAS;CACb,MAAM;EACJ,QAAQ,GAAG,MAAM,YAAY,KAAK,IAAI;EACtC,MAAM,MAAM,KAAK;EACjB,SAAS,MAAM;EACf,cAAc;EACf;CACD,MAAM;EACJ,QAAQ,GAAG,MAAM,OAAO,KAAK,IAAI,CAAC;EAClC,MAAM,MAAM,OAAO;EACnB,SAAS,MAAM;EACf,cAAc;EACf;CACD,OAAO;EACL,QAAQ,GAAG,MAAM,IAAI,KAAK,IAAI,CAAC;EAC/B,MAAM,MAAM,IAAI;EAChB,SAAS,MAAM;EACf,cAAc;EACf;CACD,OAAO;EACL,QAAQ,GAAG,MAAM,IAAI,KAAK,IAAI,CAAC;EAC/B,MAAM,MAAM,IAAI;EAChB,SAAS,MAAM;EACf,cAAc;EACf;CACF;AAUD,MAAM,iBAAiB;CACrB,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,SAAS,YAAY;CACnB,OAAO,QAAQ,QAAQ,IAAI,aAAa,QAAQ,IAAI,oBAAoB;;;;;;;AAQ1E,IAAa,aAAb,cAAgC,MAAM;CACpC,OAAyB;;AAG3B,SAAS,KAAK,OAAiB,OAAe,OAAiB;CAC7D,IAAI,WAAW,EACb;CAGF,MAAM,QAAQ,OAAO;CACrB,MAAM,SAAS,eAAe;CAC9B,MAAM,KAAK,WAAW,QAAQ;CAC9B,IAAI,OAAO,OAAO,YAChB;CAGF,MAAM,UAAU,GAAG,SACjB,QAAQ,MAAM,IAAI,WAAW,SAAS,KAAK;CAE7C,MAAM,eAAe,MAAM,eACvB,IAAI,MAAM,KAAK,MAAM,aAAa,CAAC,CAAC,MACpC;CAEJ,OAAO,GAAG,aAAa,GAAG,MAAM,MAAM,cAAc,CAAC,GAAG,MAAM,KAAK,MAAM,GAAG;CAE5E,KAAK,MAAM,CAAC,GAAG,SAAS,MAAM,SAAS,EAErC,OAAO,GAAG,aAAa,GADL,MAAM,MAAM,SAAS,IAAI,MAAM,IACb,GAAG,MAAM,QAAQ,KAAK,GAAG;;AAIjE,MAAa,MAAM;CACjB,OAAO,OAAe,UAAoB,KAAK,QAAQ,OAAO,MAAM;CACpE,OAAO,OAAe,UAAoB,KAAK,QAAQ,OAAO,MAAM;CACpE,QAAQ,OAAe,UAAoB,KAAK,SAAS,OAAO,MAAM;CACtE,MAAM,OAAe,OAAwB;EAC3C,KAAK,SAAS,OAAO,MAAM;EAE3B,IAAI,WAAW,EACb,MAAM,IAAI,WAAW,MAAM;EAG7B,QAAQ,KAAK,EAAE;;CAElB"}

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

@@ -0,0 +1,25 @@
+import { ReleaseSlug } from "@interfere/types/releases/slug";
+
+//#region src/internal/release-slug.d.ts
+/**
+ * Walks the same env keys at build time (`withInterfere`) and at runtime
+ * (server-side `register()`), then falls back to `git rev-parse HEAD`. Both
+ * call sites resolving the same SHA → both derive the same `release.slug`,
+ * so server and client spans agree by construction.
+ *
+ * Override path for non-CI builds: set `INTERFERE_SOURCE_ID` (or any other
+ * key in `releaseSourceIdEnvKeys`) on both the build env and the runtime
+ * env. The `interfere.buildId` next.config knob was removed in 10.0 because
+ * it only worked at build time and caused server/client slug drift.
+ *
+ * `runGitCommand` (`node:child_process`) keeps this module on the Node side
+ * of `@interfere/next`'s dual entry — the edge entrypoint
+ * (`instrumentation.edge.ts`) intentionally doesn't import this file.
+ */
+declare function resolveCommitSha(): string | null;
+declare function resolveReleaseSlug(): {
+  commitSha: string | null;
+  slug: ReleaseSlug | null;
+};
+//#endregion
+export { resolveCommitSha, resolveReleaseSlug };

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

@@ -0,0 +1 @@
+{"version":3,"file":"release-slug.d.mts","names":[],"sources":["../../src/internal/release-slug.ts"],"mappings":";;;;;AAwBA;;;;;AAOA;;;;;;;;iBAPgB,gBAAA,CAAA;AAAA,iBAOA,kBAAA,CAAA;EACd,SAAA;EACA,IAAA,EAAM,WAAA;AAAA"}

package/dist/internal/release-slug.mjs

@@ -0,0 +1,32 @@
+import { runGitCommand } from "./build/release/git.mjs";
+import { readFirstEnvValue } from "@interfere/types/sdk/env";
+import { releaseSourceIdEnvKeys } from "@interfere/types/integrations";
+import { deriveReleaseSlug } from "@interfere/types/releases/slug";
+//#region src/internal/release-slug.ts
+/**
+* Walks the same env keys at build time (`withInterfere`) and at runtime
+* (server-side `register()`), then falls back to `git rev-parse HEAD`. Both
+* call sites resolving the same SHA → both derive the same `release.slug`,
+* so server and client spans agree by construction.
+*
+* Override path for non-CI builds: set `INTERFERE_SOURCE_ID` (or any other
+* key in `releaseSourceIdEnvKeys`) on both the build env and the runtime
+* env. The `interfere.buildId` next.config knob was removed in 10.0 because
+* it only worked at build time and caused server/client slug drift.
+*
+* `runGitCommand` (`node:child_process`) keeps this module on the Node side
+* of `@interfere/next`'s dual entry — the edge entrypoint
+* (`instrumentation.edge.ts`) intentionally doesn't import this file.
+*/
+function resolveCommitSha() {
+	return readFirstEnvValue(process.env, releaseSourceIdEnvKeys) ?? runGitCommand("git rev-parse HEAD");
+}
+function resolveReleaseSlug() {
+	const commitSha = resolveCommitSha();
+	return {
+		commitSha,
+		slug: commitSha ? deriveReleaseSlug(commitSha) : null
+	};
+}
+//#endregion
+export { resolveCommitSha, resolveReleaseSlug };

package/dist/internal/release-slug.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-slug.mjs","names":[],"sources":["../../src/internal/release-slug.ts"],"sourcesContent":["import { releaseSourceIdEnvKeys } from \"@interfere/types/integrations\";\nimport {\n  deriveReleaseSlug,\n  type ReleaseSlug,\n} from \"@interfere/types/releases/slug\";\nimport { readFirstEnvValue } from \"@interfere/types/sdk/env\";\n\nimport { runGitCommand } from \"./build/release/git.js\";\n\n/**\n * Walks the same env keys at build time (`withInterfere`) and at runtime\n * (server-side `register()`), then falls back to `git rev-parse HEAD`. Both\n * call sites resolving the same SHA → both derive the same `release.slug`,\n * so server and client spans agree by construction.\n *\n * Override path for non-CI builds: set `INTERFERE_SOURCE_ID` (or any other\n * key in `releaseSourceIdEnvKeys`) on both the build env and the runtime\n * env. The `interfere.buildId` next.config knob was removed in 10.0 because\n * it only worked at build time and caused server/client slug drift.\n *\n * `runGitCommand` (`node:child_process`) keeps this module on the Node side\n * of `@interfere/next`'s dual entry — the edge entrypoint\n * (`instrumentation.edge.ts`) intentionally doesn't import this file.\n */\nexport function resolveCommitSha(): string | null {\n  return (\n    readFirstEnvValue(process.env, releaseSourceIdEnvKeys) ??\n    runGitCommand(\"git rev-parse HEAD\")\n  );\n}\n\nexport function resolveReleaseSlug(): {\n  commitSha: string | null;\n  slug: ReleaseSlug | null;\n} {\n  const commitSha = resolveCommitSha();\n  return {\n    commitSha,\n    slug: commitSha ? deriveReleaseSlug(commitSha) : null,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,mBAAkC;CAChD,OACE,kBAAkB,QAAQ,KAAK,uBAAuB,IACtD,cAAc,qBAAqB;;AAIvC,SAAgB,qBAGd;CACA,MAAM,YAAY,kBAAkB;CACpC,OAAO;EACL;EACA,MAAM,YAAY,kBAAkB,UAAU,GAAG;EAClD"}