@vigilon/nextjs 0.0.0-stage → 0.2.15

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Vigilon
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,3 +1,114 @@
-# Temporary Holding Version
+# `@vigilon/nextjs`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vigilon for Next.js: server traces and errors from the Node.js runtime, and browser errors from the client, reported under one service. It wraps [`@vigilon/node`](../node#readme) on the server and [`@vigilon/react`](../react#readme) in the browser.
+
+> **Early access.** Browser error monitoring is not yet generally available. The ingest endpoint accepts browser events only from projects enabled for early access and answers `403` for the rest, which the SDK does not retry.
+
+Requires Next.js 15.3 or later, and Node.js 22.12 or later for the build and the server. Automatic source map upload needs Next.js 15.4 or later.
+
+## Install
+
+```bash
+npm install @vigilon/nextjs
+```
+
+## Set up
+
+### `next.config.ts`
+
+```ts
+import { withVigilon } from "@vigilon/nextjs/config";
+
+export default withVigilon({
+  // your Next.js config
+});
+```
+
+`withVigilon()` keeps the SDK and its OpenTelemetry dependencies out of the server bundle, and has Next.js render the request's `traceparent` in a meta tag so browser errors on a server-rendered page link to the server trace that rendered it.
+
+### `instrumentation.ts` (server)
+
+```ts
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    const { register } = await import("@vigilon/nextjs/server");
+    register({ serviceName: "storefront", serviceVersion: process.env.VIGILON_SERVICE_VERSION });
+  }
+}
+```
+
+`register()` takes the same options as [`@vigilon/node`](../node#readme) and reads anything you leave out from the environment (`VIGILON_API_KEY`, `VIGILON_ENVIRONMENT`, …). It adds what Next.js needs on top: request spans are labelled with the route Next.js resolved (`/api/orders/[id]`), and on Vercel telemetry is flushed at the end of every request and the real response status is recorded. The SDK cannot run in the Edge runtime, so gate on `NEXT_RUNTIME` and import it dynamically as above.
+
+Next.js records errors from Server Components, route handlers, and Server Actions on its own request spans, so no `onRequestError` hook is needed. Everything from `@vigilon/node` (`recordException`, `withJobMonitor`, …) is re-exported from `@vigilon/nextjs/server`.
+
+### `instrumentation-client.ts` (browser)
+
+```ts
+import { init } from "@vigilon/nextjs";
+
+init({
+  apiKey: process.env.NEXT_PUBLIC_VIGILON_API_KEY!,
+  serviceName: "storefront",
+  environment: process.env.NEXT_PUBLIC_VIGILON_ENVIRONMENT!,
+  serviceVersion: process.env.NEXT_PUBLIC_VIGILON_SERVICE_VERSION,
+});
+```
+
+Use the same `serviceName` as the server: Vigilon keeps server and browser errors apart by origin. `init` takes the options of [`@vigilon/browser`](../browser#readme). Every event captured before the first client-side navigation carries the trace ID of the request that rendered the page.
+
+### Error boundaries
+
+Next.js creates the React root itself, so render errors that an `error.tsx` or `global-error.tsx` boundary catches are reported from the boundary:
+
+```tsx
+"use client";
+import { useReportError } from "@vigilon/nextjs";
+
+export default function GlobalError({ error }: { error: Error & { digest?: string } }) {
+  useReportError(error);
+  return (
+    <html lang="en">
+      <body>
+        <h2>Something went wrong.</h2>
+      </body>
+    </html>
+  );
+}
+```
+
+`@vigilon/nextjs` re-exports `@vigilon/react`, including `ErrorBoundary` for your own boundaries inside client components.
+
+## Source maps
+
+With a source map upload token, `withVigilon()` builds browser source maps and, once Next.js has compiled, gives every script a debug ID, uploads the scripts and their maps, and deletes every map so none is deployed. Before that it marks, in each map's `ignoreList`, the sources that are not files in your project, such as the precompiled Next.js code a webpack build maps, so Vigilon treats their frames as library code rather than yours. Files outside the project directory that exist on disk, such as a shared package in a monorepo, stay yours. It runs in Next.js's `compiler.runAfterProductionCompile` hook (Next.js 15.4 or later), so it works with both Turbopack and webpack.
+
+```bash
+VIGILON_SOURCE_MAP_TOKEN=vg_sm_... next build
+```
+
+| Option | Default | |
+|---|---|---|
+| `uploadToken` | `VIGILON_SOURCE_MAP_TOKEN` | A source map upload token for the project. Without one, no source maps are built or uploaded. Never use a project API key here: API keys are public in the browser. |
+| `apiUrl` | `VIGILON_API_URL`, then `https://api.vigilon.io` | The Vigilon API. |
+| `onUploadError` | `"error"` | `"warn"` keeps a failed upload from failing the build. The maps are deleted either way. |
+
+```ts
+export default withVigilon(nextConfig, { onUploadError: "warn" });
+```
+
+On Next.js 15.3, run [`@vigilon/cli`](../cli#readme) on `.next/static` after `next build` instead, with `productionBrowserSourceMaps: true`.
+
+## Self-hosted Next.js (optional)
+
+With `next start` or the standalone output you can preload the SDK instead of, or as well as, registering it from `instrumentation.ts`, which adds Vigilon's own HTTP server spans:
+
+```bash
+NODE_OPTIONS='--import @vigilon/nextjs/register' next start
+```
+
+The preload reads its settings from the environment. Preload this package's entry, not `@vigilon/node/register`: a plain `@vigilon/node` start has no Next.js route labelling, and `register()` from this package then warns and does nothing. Preloading does not work on Vercel; use `instrumentation.ts` there.
+
+## Support
+
+- Bugs and feature requests: [GitHub Issues](https://github.com/vigilonio/js/issues)
+- Security vulnerabilities: report them privately to [security@vigilon.io](mailto:security@vigilon.io)

package/dist/config.cjs

@@ -0,0 +1,170 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/config/index.ts
+var config_exports = {};
+__export(config_exports, {
+  uploadSourceMaps: () => uploadSourceMaps,
+  withVigilon: () => withVigilon
+});
+module.exports = __toCommonJS(config_exports);
+
+// ../../node_modules/.pnpm/tsup@8.5.1_postcss@8.5.31_tsx@4.23.13_typescript@6.0.3_yaml@2.9.0/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/config/index.ts
+var import_node_child_process = require("child_process");
+var import_promises2 = require("fs/promises");
+var import_node_module = require("module");
+var import_node_path2 = require("path");
+var import_node_util = require("util");
+
+// src/config/ignore-list.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function ignoreSourcesNotOnDisk(staticDir, projectDir) {
+  const files = (await (0, import_promises.readdir)(staticDir, { recursive: true })).filter((file) => file.endsWith(".map"));
+  await Promise.all(
+    files.map(async (file) => {
+      const path = (0, import_node_path.join)(staticDir, file);
+      let map;
+      try {
+        map = JSON.parse(await (0, import_promises.readFile)(path, "utf8"));
+      } catch {
+        return;
+      }
+      const maps = map.sections ? map.sections.map((section) => section.map) : [map];
+      let changed = false;
+      for (const part of maps) {
+        changed = await ignoreInMap(part, projectDir) || changed;
+      }
+      if (changed) {
+        await (0, import_promises.writeFile)(path, JSON.stringify(map));
+      }
+    })
+  );
+}
+async function ignoreInMap(map, projectDir) {
+  const sources = map.sources ?? [];
+  const ignored = /* @__PURE__ */ new Set([...map.ignoreList ?? [], ...map.x_google_ignoreList ?? []]);
+  const added = [];
+  await Promise.all(
+    sources.map(async (source, index) => {
+      if (ignored.has(index) || typeof source !== "string") return;
+      const path = webpackSourcePath(source, projectDir);
+      if (path !== null && !await isFile(path)) added.push(index);
+    })
+  );
+  if (added.length === 0) return false;
+  map.ignoreList = [...ignored, ...added].sort((a, b) => a - b);
+  return true;
+}
+function webpackSourcePath(source, projectDir) {
+  const match = /^webpack:\/\/[^/]*\/(.*)$/.exec(source);
+  if (!match) return null;
+  const path = (match[1] ?? "").replace(/[?#].*$/, "");
+  return (0, import_node_path.isAbsolute)(path) ? path : (0, import_node_path.resolve)(projectDir, path);
+}
+async function isFile(path) {
+  try {
+    return (await (0, import_promises.stat)(path)).isFile();
+  } catch {
+    return false;
+  }
+}
+
+// src/config/index.ts
+var SERVER_PACKAGES = ["@vigilon/nextjs", "@vigilon/node"];
+function withVigilon(config, options = {}) {
+  const uploadToken = options.uploadToken ?? process.env.VIGILON_SOURCE_MAP_TOKEN;
+  const experimental = config.experimental ?? {};
+  const wrapped = {
+    ...config,
+    serverExternalPackages: unique([...config.serverExternalPackages ?? [], ...SERVER_PACKAGES]),
+    experimental: {
+      ...experimental,
+      clientTraceMetadata: unique([...experimental.clientTraceMetadata ?? [], "traceparent"])
+    }
+  };
+  if (uploadToken) {
+    const previous = config.compiler?.runAfterProductionCompile;
+    wrapped.productionBrowserSourceMaps = true;
+    wrapped.compiler = {
+      ...config.compiler,
+      runAfterProductionCompile: async (metadata) => {
+        await previous?.(metadata);
+        const staticDir = (0, import_node_path2.join)(metadata.distDir, "static");
+        try {
+          await ignoreSourcesNotOnDisk(staticDir, metadata.projectDir);
+          await uploadSourceMaps(staticDir, uploadToken, options);
+        } finally {
+          await deleteSourceMaps(staticDir);
+        }
+      }
+    };
+  }
+  return wrapped;
+}
+var run = (0, import_node_util.promisify)(import_node_child_process.execFile);
+async function uploadSourceMaps(staticDir, uploadToken, options) {
+  const cli = cliBinPath();
+  const env = {
+    ...process.env,
+    VIGILON_SOURCE_MAP_TOKEN: uploadToken,
+    ...options.apiUrl ? { VIGILON_API_URL: options.apiUrl } : {}
+  };
+  const warnOnly = options.onUploadError === "warn" ? ["--warn-only"] : [];
+  for (const args of [
+    ["sourcemaps", "inject", staticDir],
+    ["sourcemaps", "upload", staticDir, "--delete-after-upload", ...warnOnly]
+  ]) {
+    try {
+      const { stdout, stderr } = await run(process.execPath, [cli, ...args], { env });
+      process.stdout.write(stdout);
+      process.stderr.write(stderr);
+    } catch (error) {
+      const { stdout = "", stderr = "" } = error;
+      process.stdout.write(stdout);
+      process.stderr.write(stderr);
+      throw new Error(`Vigilon source map upload failed: vigilon ${args.join(" ")}`);
+    }
+  }
+}
+async function deleteSourceMaps(dir) {
+  const files = await (0, import_promises2.readdir)(dir, { recursive: true });
+  await Promise.all(
+    files.filter((file) => file.endsWith(".map")).map((file) => (0, import_promises2.rm)((0, import_node_path2.join)(dir, file), { force: true }))
+  );
+}
+function cliBinPath() {
+  const require2 = (0, import_node_module.createRequire)(importMetaUrl);
+  const manifestPath = require2.resolve("@vigilon/cli/package.json");
+  const manifest = require2(manifestPath);
+  return (0, import_node_path2.join)((0, import_node_path2.dirname)(manifestPath), manifest.bin.vigilon);
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  uploadSourceMaps,
+  withVigilon
+});
+//# sourceMappingURL=config.cjs.map

package/dist/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/index.ts","../../../node_modules/.pnpm/tsup@8.5.1_postcss@8.5.31_tsx@4.23.13_typescript@6.0.3_yaml@2.9.0/node_modules/tsup/assets/cjs_shims.js","../src/config/ignore-list.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { readdir, rm } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { ignoreSourcesNotOnDisk } from \"./ignore-list\";\n\nexport interface VigilonNextConfigOptions {\n  /**\n   * A source map upload token for the project. Falls back to\n   * VIGILON_SOURCE_MAP_TOKEN. Without one, source maps are neither built nor\n   * uploaded. Never use a project API key here: API keys are public.\n   */\n  uploadToken?: string;\n  /** The Vigilon API. Falls back to VIGILON_API_URL, then https://api.vigilon.io. */\n  apiUrl?: string;\n  /** What a failed upload does to the build. Defaults to \"error\". */\n  onUploadError?: \"error\" | \"warn\";\n}\n\n/** The parts of a Next.js config this wrapper reads and sets. */\nexport interface NextConfigLike {\n  serverExternalPackages?: string[];\n  productionBrowserSourceMaps?: boolean;\n  experimental?: { clientTraceMetadata?: string[]; [key: string]: unknown };\n  compiler?: {\n    runAfterProductionCompile?: (metadata: { projectDir: string; distDir: string }) => Promise<void>;\n    [key: string]: unknown;\n  };\n  [key: string]: unknown;\n}\n\nconst SERVER_PACKAGES = [\"@vigilon/nextjs\", \"@vigilon/node\"];\n\n/**\n * Wraps a Next.js config for Vigilon:\n *\n * - keeps the SDK and its require-hook based OpenTelemetry dependencies out\n *   of the server bundle;\n * - has Next.js render the request's `traceparent` in a meta tag, so browser\n *   errors on a server-rendered page link to its server trace;\n * - with an upload token, builds browser source maps and, once Next.js has\n *   compiled (Next.js 15.4 or later, with Turbopack or webpack), marks\n *   sources that are not the application's own files as library code, gives\n *   every script a debug ID, uploads the scripts and their maps, and deletes\n *   every map so none is deployed.\n *\n * ```ts\n * export default withVigilon({ reactStrictMode: true });\n * ```\n */\nexport function withVigilon<T extends NextConfigLike>(\n  config: T,\n  options: VigilonNextConfigOptions = {},\n): T & NextConfigLike {\n  const uploadToken = options.uploadToken ?? process.env.VIGILON_SOURCE_MAP_TOKEN;\n  const experimental = config.experimental ?? {};\n  const wrapped: NextConfigLike = {\n    ...config,\n    serverExternalPackages: unique([...(config.serverExternalPackages ?? []), ...SERVER_PACKAGES]),\n    experimental: {\n      ...experimental,\n      clientTraceMetadata: unique([...(experimental.clientTraceMetadata ?? []), \"traceparent\"]),\n    },\n  };\n  if (uploadToken) {\n    const previous = config.compiler?.runAfterProductionCompile;\n    wrapped.productionBrowserSourceMaps = true;\n    wrapped.compiler = {\n      ...config.compiler,\n      runAfterProductionCompile: async (metadata) => {\n        await previous?.(metadata);\n        const staticDir = join(metadata.distDir, \"static\");\n        try {\n          // Before inject, so each debug ID covers the final map.\n          await ignoreSourcesNotOnDisk(staticDir, metadata.projectDir);\n          await uploadSourceMaps(staticDir, uploadToken, options);\n        } finally {\n          // The maps were turned on only for the upload, so none may be\n          // deployed: not after a failed upload, which keeps them for a\n          // retry, and not the maps of Next.js's own files, which have no\n          // sourceMappingURL to pair them with a script.\n          await deleteSourceMaps(staticDir);\n        }\n      },\n    };\n  }\n  return wrapped as T & NextConfigLike;\n}\n\nconst run = promisify(execFile);\n\n/** Runs @vigilon/cli's inject and upload over the browser build output. */\nexport async function uploadSourceMaps(\n  staticDir: string,\n  uploadToken: string,\n  options: VigilonNextConfigOptions,\n): Promise<void> {\n  const cli = cliBinPath();\n  const env = {\n    ...process.env,\n    VIGILON_SOURCE_MAP_TOKEN: uploadToken,\n    ...(options.apiUrl ? { VIGILON_API_URL: options.apiUrl } : {}),\n  };\n  const warnOnly = options.onUploadError === \"warn\" ? [\"--warn-only\"] : [];\n  for (const args of [\n    [\"sourcemaps\", \"inject\", staticDir],\n    [\"sourcemaps\", \"upload\", staticDir, \"--delete-after-upload\", ...warnOnly],\n  ]) {\n    try {\n      const { stdout, stderr } = await run(process.execPath, [cli, ...args], { env });\n      process.stdout.write(stdout);\n      process.stderr.write(stderr);\n    } catch (error) {\n      // A failed run rejects with its output attached; show it, then fail the\n      // build with it.\n      const { stdout = \"\", stderr = \"\" } = error as { stdout?: string; stderr?: string };\n      process.stdout.write(stdout);\n      process.stderr.write(stderr);\n      throw new Error(`Vigilon source map upload failed: vigilon ${args.join(\" \")}`);\n    }\n  }\n}\n\nasync function deleteSourceMaps(dir: string): Promise<void> {\n  const files = await readdir(dir, { recursive: true });\n  await Promise.all(\n    files.filter((file) => file.endsWith(\".map\")).map((file) => rm(join(dir, file), { force: true })),\n  );\n}\n\nfunction cliBinPath(): string {\n  const require = createRequire(import.meta.url);\n  const manifestPath = require.resolve(\"@vigilon/cli/package.json\");\n  const manifest = require(manifestPath) as { bin: { vigilon: string } };\n  return join(dirname(manifestPath), manifest.bin.vigilon);\n}\n\nfunction unique(values: string[]): string[] {\n  return [...new Set(values)];\n}\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","import { readdir, readFile, stat, writeFile } from \"node:fs/promises\";\nimport { isAbsolute, join, resolve } from \"node:path\";\n\ninterface SourceMapSection {\n  map: SourceMapLike;\n}\n\ninterface SourceMapLike {\n  sources?: (string | null)[];\n  ignoreList?: number[];\n  x_google_ignoreList?: number[];\n  sections?: SourceMapSection[];\n}\n\n/**\n * Adds to each map's `ignoreList` every webpack source that is not a file on\n * disk under the project, so Vigilon reads it as library code. Next.js's\n * webpack build gives Next's own precompiled client code sources such as\n * `webpack://_N_E/../../src/client/add-base-path.ts`, which no path rule can\n * tell from the application's, and leaves them off the list. The\n * application's own sources, including a monorepo package outside the\n * project, are files on disk while it builds.\n *\n * Turbopack sources are left alone: Turbopack lists its framework and runtime\n * sources itself, and its `[project]` root may be a monorepo root rather than\n * the project directory.\n */\nexport async function ignoreSourcesNotOnDisk(staticDir: string, projectDir: string): Promise<void> {\n  const files = (await readdir(staticDir, { recursive: true })).filter((file) => file.endsWith(\".map\"));\n  await Promise.all(\n    files.map(async (file) => {\n      const path = join(staticDir, file);\n      let map: SourceMapLike;\n      try {\n        map = JSON.parse(await readFile(path, \"utf8\")) as SourceMapLike;\n      } catch {\n        return;\n      }\n      const maps = map.sections ? map.sections.map((section) => section.map) : [map];\n      let changed = false;\n      for (const part of maps) {\n        changed = (await ignoreInMap(part, projectDir)) || changed;\n      }\n      if (changed) {\n        await writeFile(path, JSON.stringify(map));\n      }\n    }),\n  );\n}\n\nasync function ignoreInMap(map: SourceMapLike, projectDir: string): Promise<boolean> {\n  const sources = map.sources ?? [];\n  const ignored = new Set([...(map.ignoreList ?? []), ...(map.x_google_ignoreList ?? [])]);\n  const added: number[] = [];\n  await Promise.all(\n    sources.map(async (source, index) => {\n      if (ignored.has(index) || typeof source !== \"string\") return;\n      const path = webpackSourcePath(source, projectDir);\n      if (path !== null && !(await isFile(path))) added.push(index);\n    }),\n  );\n  if (added.length === 0) return false;\n  // Readers take ignoreList over x_google_ignoreList, so the old entries are\n  // merged into it rather than left beside it.\n  map.ignoreList = [...ignored, ...added].sort((a, b) => a - b);\n  return true;\n}\n\n/**\n * The file a `webpack://<namespace>/<path>` source names, relative to the\n * project (webpack's context), without a query or fragment; null for any\n * other source.\n */\nexport function webpackSourcePath(source: string, projectDir: string): string | null {\n  const match = /^webpack:\\/\\/[^/]*\\/(.*)$/.exec(source);\n  if (!match) return null;\n  const path = (match[1] ?? \"\").replace(/[?#].*$/, \"\");\n  return isAbsolute(path) ? path : resolve(projectDir, path);\n}\n\nasync function isFile(path: string): Promise<boolean> {\n  try {\n    return (await stat(path)).isFile();\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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","names":["import_promises","import_node_path","require"]}

package/dist/config.d.mts

@@ -0,0 +1,51 @@
+interface VigilonNextConfigOptions {
+    /**
+     * A source map upload token for the project. Falls back to
+     * VIGILON_SOURCE_MAP_TOKEN. Without one, source maps are neither built nor
+     * uploaded. Never use a project API key here: API keys are public.
+     */
+    uploadToken?: string;
+    /** The Vigilon API. Falls back to VIGILON_API_URL, then https://api.vigilon.io. */
+    apiUrl?: string;
+    /** What a failed upload does to the build. Defaults to "error". */
+    onUploadError?: "error" | "warn";
+}
+/** The parts of a Next.js config this wrapper reads and sets. */
+interface NextConfigLike {
+    serverExternalPackages?: string[];
+    productionBrowserSourceMaps?: boolean;
+    experimental?: {
+        clientTraceMetadata?: string[];
+        [key: string]: unknown;
+    };
+    compiler?: {
+        runAfterProductionCompile?: (metadata: {
+            projectDir: string;
+            distDir: string;
+        }) => Promise<void>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Wraps a Next.js config for Vigilon:
+ *
+ * - keeps the SDK and its require-hook based OpenTelemetry dependencies out
+ *   of the server bundle;
+ * - has Next.js render the request's `traceparent` in a meta tag, so browser
+ *   errors on a server-rendered page link to its server trace;
+ * - with an upload token, builds browser source maps and, once Next.js has
+ *   compiled (Next.js 15.4 or later, with Turbopack or webpack), marks
+ *   sources that are not the application's own files as library code, gives
+ *   every script a debug ID, uploads the scripts and their maps, and deletes
+ *   every map so none is deployed.
+ *
+ * ```ts
+ * export default withVigilon({ reactStrictMode: true });
+ * ```
+ */
+declare function withVigilon<T extends NextConfigLike>(config: T, options?: VigilonNextConfigOptions): T & NextConfigLike;
+/** Runs @vigilon/cli's inject and upload over the browser build output. */
+declare function uploadSourceMaps(staticDir: string, uploadToken: string, options: VigilonNextConfigOptions): Promise<void>;
+
+export { type NextConfigLike, type VigilonNextConfigOptions, uploadSourceMaps, withVigilon };

package/dist/config.d.ts

@@ -0,0 +1,51 @@
+interface VigilonNextConfigOptions {
+    /**
+     * A source map upload token for the project. Falls back to
+     * VIGILON_SOURCE_MAP_TOKEN. Without one, source maps are neither built nor
+     * uploaded. Never use a project API key here: API keys are public.
+     */
+    uploadToken?: string;
+    /** The Vigilon API. Falls back to VIGILON_API_URL, then https://api.vigilon.io. */
+    apiUrl?: string;
+    /** What a failed upload does to the build. Defaults to "error". */
+    onUploadError?: "error" | "warn";
+}
+/** The parts of a Next.js config this wrapper reads and sets. */
+interface NextConfigLike {
+    serverExternalPackages?: string[];
+    productionBrowserSourceMaps?: boolean;
+    experimental?: {
+        clientTraceMetadata?: string[];
+        [key: string]: unknown;
+    };
+    compiler?: {
+        runAfterProductionCompile?: (metadata: {
+            projectDir: string;
+            distDir: string;
+        }) => Promise<void>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Wraps a Next.js config for Vigilon:
+ *
+ * - keeps the SDK and its require-hook based OpenTelemetry dependencies out
+ *   of the server bundle;
+ * - has Next.js render the request's `traceparent` in a meta tag, so browser
+ *   errors on a server-rendered page link to its server trace;
+ * - with an upload token, builds browser source maps and, once Next.js has
+ *   compiled (Next.js 15.4 or later, with Turbopack or webpack), marks
+ *   sources that are not the application's own files as library code, gives
+ *   every script a debug ID, uploads the scripts and their maps, and deletes
+ *   every map so none is deployed.
+ *
+ * ```ts
+ * export default withVigilon({ reactStrictMode: true });
+ * ```
+ */
+declare function withVigilon<T extends NextConfigLike>(config: T, options?: VigilonNextConfigOptions): T & NextConfigLike;
+/** Runs @vigilon/cli's inject and upload over the browser build output. */
+declare function uploadSourceMaps(staticDir: string, uploadToken: string, options: VigilonNextConfigOptions): Promise<void>;
+
+export { type NextConfigLike, type VigilonNextConfigOptions, uploadSourceMaps, withVigilon };

package/dist/config.mjs

@@ -0,0 +1,138 @@
+// src/config/index.ts
+import { execFile } from "child_process";
+import { readdir as readdir2, rm } from "fs/promises";
+import { createRequire } from "module";
+import { dirname, join as join2 } from "path";
+import { promisify } from "util";
+
+// src/config/ignore-list.ts
+import { readdir, readFile, stat, writeFile } from "fs/promises";
+import { isAbsolute, join, resolve } from "path";
+async function ignoreSourcesNotOnDisk(staticDir, projectDir) {
+  const files = (await readdir(staticDir, { recursive: true })).filter((file) => file.endsWith(".map"));
+  await Promise.all(
+    files.map(async (file) => {
+      const path = join(staticDir, file);
+      let map;
+      try {
+        map = JSON.parse(await readFile(path, "utf8"));
+      } catch {
+        return;
+      }
+      const maps = map.sections ? map.sections.map((section) => section.map) : [map];
+      let changed = false;
+      for (const part of maps) {
+        changed = await ignoreInMap(part, projectDir) || changed;
+      }
+      if (changed) {
+        await writeFile(path, JSON.stringify(map));
+      }
+    })
+  );
+}
+async function ignoreInMap(map, projectDir) {
+  const sources = map.sources ?? [];
+  const ignored = /* @__PURE__ */ new Set([...map.ignoreList ?? [], ...map.x_google_ignoreList ?? []]);
+  const added = [];
+  await Promise.all(
+    sources.map(async (source, index) => {
+      if (ignored.has(index) || typeof source !== "string") return;
+      const path = webpackSourcePath(source, projectDir);
+      if (path !== null && !await isFile(path)) added.push(index);
+    })
+  );
+  if (added.length === 0) return false;
+  map.ignoreList = [...ignored, ...added].sort((a, b) => a - b);
+  return true;
+}
+function webpackSourcePath(source, projectDir) {
+  const match = /^webpack:\/\/[^/]*\/(.*)$/.exec(source);
+  if (!match) return null;
+  const path = (match[1] ?? "").replace(/[?#].*$/, "");
+  return isAbsolute(path) ? path : resolve(projectDir, path);
+}
+async function isFile(path) {
+  try {
+    return (await stat(path)).isFile();
+  } catch {
+    return false;
+  }
+}
+
+// src/config/index.ts
+var SERVER_PACKAGES = ["@vigilon/nextjs", "@vigilon/node"];
+function withVigilon(config, options = {}) {
+  const uploadToken = options.uploadToken ?? process.env.VIGILON_SOURCE_MAP_TOKEN;
+  const experimental = config.experimental ?? {};
+  const wrapped = {
+    ...config,
+    serverExternalPackages: unique([...config.serverExternalPackages ?? [], ...SERVER_PACKAGES]),
+    experimental: {
+      ...experimental,
+      clientTraceMetadata: unique([...experimental.clientTraceMetadata ?? [], "traceparent"])
+    }
+  };
+  if (uploadToken) {
+    const previous = config.compiler?.runAfterProductionCompile;
+    wrapped.productionBrowserSourceMaps = true;
+    wrapped.compiler = {
+      ...config.compiler,
+      runAfterProductionCompile: async (metadata) => {
+        await previous?.(metadata);
+        const staticDir = join2(metadata.distDir, "static");
+        try {
+          await ignoreSourcesNotOnDisk(staticDir, metadata.projectDir);
+          await uploadSourceMaps(staticDir, uploadToken, options);
+        } finally {
+          await deleteSourceMaps(staticDir);
+        }
+      }
+    };
+  }
+  return wrapped;
+}
+var run = promisify(execFile);
+async function uploadSourceMaps(staticDir, uploadToken, options) {
+  const cli = cliBinPath();
+  const env = {
+    ...process.env,
+    VIGILON_SOURCE_MAP_TOKEN: uploadToken,
+    ...options.apiUrl ? { VIGILON_API_URL: options.apiUrl } : {}
+  };
+  const warnOnly = options.onUploadError === "warn" ? ["--warn-only"] : [];
+  for (const args of [
+    ["sourcemaps", "inject", staticDir],
+    ["sourcemaps", "upload", staticDir, "--delete-after-upload", ...warnOnly]
+  ]) {
+    try {
+      const { stdout, stderr } = await run(process.execPath, [cli, ...args], { env });
+      process.stdout.write(stdout);
+      process.stderr.write(stderr);
+    } catch (error) {
+      const { stdout = "", stderr = "" } = error;
+      process.stdout.write(stdout);
+      process.stderr.write(stderr);
+      throw new Error(`Vigilon source map upload failed: vigilon ${args.join(" ")}`);
+    }
+  }
+}
+async function deleteSourceMaps(dir) {
+  const files = await readdir2(dir, { recursive: true });
+  await Promise.all(
+    files.filter((file) => file.endsWith(".map")).map((file) => rm(join2(dir, file), { force: true }))
+  );
+}
+function cliBinPath() {
+  const require2 = createRequire(import.meta.url);
+  const manifestPath = require2.resolve("@vigilon/cli/package.json");
+  const manifest = require2(manifestPath);
+  return join2(dirname(manifestPath), manifest.bin.vigilon);
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+export {
+  uploadSourceMaps,
+  withVigilon
+};
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/index.ts","../src/config/ignore-list.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { readdir, rm } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { ignoreSourcesNotOnDisk } from \"./ignore-list\";\n\nexport interface VigilonNextConfigOptions {\n  /**\n   * A source map upload token for the project. Falls back to\n   * VIGILON_SOURCE_MAP_TOKEN. Without one, source maps are neither built nor\n   * uploaded. Never use a project API key here: API keys are public.\n   */\n  uploadToken?: string;\n  /** The Vigilon API. Falls back to VIGILON_API_URL, then https://api.vigilon.io. */\n  apiUrl?: string;\n  /** What a failed upload does to the build. Defaults to \"error\". */\n  onUploadError?: \"error\" | \"warn\";\n}\n\n/** The parts of a Next.js config this wrapper reads and sets. */\nexport interface NextConfigLike {\n  serverExternalPackages?: string[];\n  productionBrowserSourceMaps?: boolean;\n  experimental?: { clientTraceMetadata?: string[]; [key: string]: unknown };\n  compiler?: {\n    runAfterProductionCompile?: (metadata: { projectDir: string; distDir: string }) => Promise<void>;\n    [key: string]: unknown;\n  };\n  [key: string]: unknown;\n}\n\nconst SERVER_PACKAGES = [\"@vigilon/nextjs\", \"@vigilon/node\"];\n\n/**\n * Wraps a Next.js config for Vigilon:\n *\n * - keeps the SDK and its require-hook based OpenTelemetry dependencies out\n *   of the server bundle;\n * - has Next.js render the request's `traceparent` in a meta tag, so browser\n *   errors on a server-rendered page link to its server trace;\n * - with an upload token, builds browser source maps and, once Next.js has\n *   compiled (Next.js 15.4 or later, with Turbopack or webpack), marks\n *   sources that are not the application's own files as library code, gives\n *   every script a debug ID, uploads the scripts and their maps, and deletes\n *   every map so none is deployed.\n *\n * ```ts\n * export default withVigilon({ reactStrictMode: true });\n * ```\n */\nexport function withVigilon<T extends NextConfigLike>(\n  config: T,\n  options: VigilonNextConfigOptions = {},\n): T & NextConfigLike {\n  const uploadToken = options.uploadToken ?? process.env.VIGILON_SOURCE_MAP_TOKEN;\n  const experimental = config.experimental ?? {};\n  const wrapped: NextConfigLike = {\n    ...config,\n    serverExternalPackages: unique([...(config.serverExternalPackages ?? []), ...SERVER_PACKAGES]),\n    experimental: {\n      ...experimental,\n      clientTraceMetadata: unique([...(experimental.clientTraceMetadata ?? []), \"traceparent\"]),\n    },\n  };\n  if (uploadToken) {\n    const previous = config.compiler?.runAfterProductionCompile;\n    wrapped.productionBrowserSourceMaps = true;\n    wrapped.compiler = {\n      ...config.compiler,\n      runAfterProductionCompile: async (metadata) => {\n        await previous?.(metadata);\n        const staticDir = join(metadata.distDir, \"static\");\n        try {\n          // Before inject, so each debug ID covers the final map.\n          await ignoreSourcesNotOnDisk(staticDir, metadata.projectDir);\n          await uploadSourceMaps(staticDir, uploadToken, options);\n        } finally {\n          // The maps were turned on only for the upload, so none may be\n          // deployed: not after a failed upload, which keeps them for a\n          // retry, and not the maps of Next.js's own files, which have no\n          // sourceMappingURL to pair them with a script.\n          await deleteSourceMaps(staticDir);\n        }\n      },\n    };\n  }\n  return wrapped as T & NextConfigLike;\n}\n\nconst run = promisify(execFile);\n\n/** Runs @vigilon/cli's inject and upload over the browser build output. */\nexport async function uploadSourceMaps(\n  staticDir: string,\n  uploadToken: string,\n  options: VigilonNextConfigOptions,\n): Promise<void> {\n  const cli = cliBinPath();\n  const env = {\n    ...process.env,\n    VIGILON_SOURCE_MAP_TOKEN: uploadToken,\n    ...(options.apiUrl ? { VIGILON_API_URL: options.apiUrl } : {}),\n  };\n  const warnOnly = options.onUploadError === \"warn\" ? [\"--warn-only\"] : [];\n  for (const args of [\n    [\"sourcemaps\", \"inject\", staticDir],\n    [\"sourcemaps\", \"upload\", staticDir, \"--delete-after-upload\", ...warnOnly],\n  ]) {\n    try {\n      const { stdout, stderr } = await run(process.execPath, [cli, ...args], { env });\n      process.stdout.write(stdout);\n      process.stderr.write(stderr);\n    } catch (error) {\n      // A failed run rejects with its output attached; show it, then fail the\n      // build with it.\n      const { stdout = \"\", stderr = \"\" } = error as { stdout?: string; stderr?: string };\n      process.stdout.write(stdout);\n      process.stderr.write(stderr);\n      throw new Error(`Vigilon source map upload failed: vigilon ${args.join(\" \")}`);\n    }\n  }\n}\n\nasync function deleteSourceMaps(dir: string): Promise<void> {\n  const files = await readdir(dir, { recursive: true });\n  await Promise.all(\n    files.filter((file) => file.endsWith(\".map\")).map((file) => rm(join(dir, file), { force: true })),\n  );\n}\n\nfunction cliBinPath(): string {\n  const require = createRequire(import.meta.url);\n  const manifestPath = require.resolve(\"@vigilon/cli/package.json\");\n  const manifest = require(manifestPath) as { bin: { vigilon: string } };\n  return join(dirname(manifestPath), manifest.bin.vigilon);\n}\n\nfunction unique(values: string[]): string[] {\n  return [...new Set(values)];\n}\n","import { readdir, readFile, stat, writeFile } from \"node:fs/promises\";\nimport { isAbsolute, join, resolve } from \"node:path\";\n\ninterface SourceMapSection {\n  map: SourceMapLike;\n}\n\ninterface SourceMapLike {\n  sources?: (string | null)[];\n  ignoreList?: number[];\n  x_google_ignoreList?: number[];\n  sections?: SourceMapSection[];\n}\n\n/**\n * Adds to each map's `ignoreList` every webpack source that is not a file on\n * disk under the project, so Vigilon reads it as library code. Next.js's\n * webpack build gives Next's own precompiled client code sources such as\n * `webpack://_N_E/../../src/client/add-base-path.ts`, which no path rule can\n * tell from the application's, and leaves them off the list. The\n * application's own sources, including a monorepo package outside the\n * project, are files on disk while it builds.\n *\n * Turbopack sources are left alone: Turbopack lists its framework and runtime\n * sources itself, and its `[project]` root may be a monorepo root rather than\n * the project directory.\n */\nexport async function ignoreSourcesNotOnDisk(staticDir: string, projectDir: string): Promise<void> {\n  const files = (await readdir(staticDir, { recursive: true })).filter((file) => file.endsWith(\".map\"));\n  await Promise.all(\n    files.map(async (file) => {\n      const path = join(staticDir, file);\n      let map: SourceMapLike;\n      try {\n        map = JSON.parse(await readFile(path, \"utf8\")) as SourceMapLike;\n      } catch {\n        return;\n      }\n      const maps = map.sections ? map.sections.map((section) => section.map) : [map];\n      let changed = false;\n      for (const part of maps) {\n        changed = (await ignoreInMap(part, projectDir)) || changed;\n      }\n      if (changed) {\n        await writeFile(path, JSON.stringify(map));\n      }\n    }),\n  );\n}\n\nasync function ignoreInMap(map: SourceMapLike, projectDir: string): Promise<boolean> {\n  const sources = map.sources ?? [];\n  const ignored = new Set([...(map.ignoreList ?? []), ...(map.x_google_ignoreList ?? [])]);\n  const added: number[] = [];\n  await Promise.all(\n    sources.map(async (source, index) => {\n      if (ignored.has(index) || typeof source !== \"string\") return;\n      const path = webpackSourcePath(source, projectDir);\n      if (path !== null && !(await isFile(path))) added.push(index);\n    }),\n  );\n  if (added.length === 0) return false;\n  // Readers take ignoreList over x_google_ignoreList, so the old entries are\n  // merged into it rather than left beside it.\n  map.ignoreList = [...ignored, ...added].sort((a, b) => a - b);\n  return true;\n}\n\n/**\n * The file a `webpack://<namespace>/<path>` source names, relative to the\n * project (webpack's context), without a query or fragment; null for any\n * other source.\n */\nexport function webpackSourcePath(source: string, projectDir: string): string | null {\n  const match = /^webpack:\\/\\/[^/]*\\/(.*)$/.exec(source);\n  if (!match) return null;\n  const path = (match[1] ?? \"\").replace(/[?#].*$/, \"\");\n  return isAbsolute(path) ? path : resolve(projectDir, path);\n}\n\nasync function isFile(path: string): Promise<boolean> {\n  try {\n    return (await stat(path)).isFile();\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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","names":["readdir","join","join","readdir","require"]}