@glasstrace/sdk 1.15.0 → 1.16.0

package/dist/edge-entry.d.cts

@@ -1,7 +1,7 @@
-export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, c as captureCorrelationId } from './correlation-id-CZ2bstzA.cjs';
+export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, c as captureCorrelationId } from './correlation-id-CelUvw7j.cjs';
 export { RequestMiddlewareFunction, TracedRequestMiddlewareOptions, tracedRequestMiddleware } from './middleware/index.cjs';
 export { WithAsyncCausalityOptions, withAsyncCausality } from './async-context/index.cjs';
-import './index.d-BQIJ5Dvc.cjs';
+import './index.d-3-cJoY8y.cjs';
 import './v4/classic/external.cjs';
 import './export/ReadableSpan';
 import './Span';

package/dist/edge-entry.d.ts

@@ -1,7 +1,7 @@
-export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, c as captureCorrelationId } from './correlation-id-YcfcqOru.js';
+export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, c as captureCorrelationId } from './correlation-id-B9YYmoZw.js';
 export { RequestMiddlewareFunction, TracedRequestMiddlewareOptions, tracedRequestMiddleware } from './middleware/index.js';
 export { WithAsyncCausalityOptions, withAsyncCausality } from './async-context/index.js';
-import './index.d-BQIJ5Dvc.js';
+import './index.d-3-cJoY8y.js';
 import './v4/classic/external.cjs';
 import './export/ReadableSpan';
 import './Span';

package/dist/edge-entry.js

@@ -1,17 +1,17 @@
 import {
   tracedRequestMiddleware
-} from "./chunk-VMK2G6QR.js";
+} from "./chunk-AFTCLH77.js";
 import {
   withAsyncCausality
-} from "./chunk-LQZRGBN5.js";
+} from "./chunk-DW3CZDS6.js";
 import {
   GlasstraceSpanProcessor,
   SdkError,
   captureCorrelationId
-} from "./chunk-HMEHYSTS.js";
+} from "./chunk-KM4UNN3Q.js";
 import "./chunk-CL3OVHPO.js";
 import "./chunk-DQ25VOKK.js";
-import "./chunk-7LE2O4ZJ.js";
+import "./chunk-GBVMPMVV.js";
 import "./chunk-NSBPE2FW.js";
 export {
   GlasstraceSpanProcessor,

package/dist/import-graph-DBLGNjcI.d.cts

@@ -0,0 +1,238 @@
+import { g as SourceMapUploadResponse, h as SourceMapManifestResponse, I as ImportGraphPayload } from './index.d-3-cJoY8y.cjs';
+
+/**
+ * In-memory source map entry: a file path paired with its full text content.
+ *
+ * @remarks
+ * Node-only. Describes the legacy in-memory shape consumed by
+ * {@link uploadSourceMaps} and {@link uploadSourceMapsAuto}. The type
+ * itself erases at runtime and is safe to import from edge code, but
+ * every function that produces or consumes it depends on `node:fs`
+ * and cannot run at the edge.
+ */
+interface SourceMapEntry {
+    filePath: string;
+    content: string;
+}
+/**
+ * Metadata for a discovered source map file, without its content loaded.
+ * Used by the streaming upload flow to defer file reads until upload time.
+ *
+ * @remarks
+ * Node-only. Describes the shape of data produced by the Node-only
+ * source-map upload flow ({@link discoverSourceMapFiles},
+ * {@link uploadSourceMapsAuto}). The type itself erases at runtime and
+ * is safe to import from edge code, but every function that produces
+ * or consumes it depends on `node:fs`/`node:path` and cannot run at
+ * the edge.
+ */
+interface SourceMapFileInfo {
+    /** Relative path to the compiled JS file (`.map` extension stripped). */
+    filePath: string;
+    /** Absolute path on disk for reading the file content on demand. */
+    absolutePath: string;
+    /** File size in bytes. */
+    sizeBytes: number;
+}
+/**
+ * Recursively discovers all `.map` files in the given build directory.
+ * Returns metadata only — file content is NOT read into memory.
+ *
+ * @remarks
+ * Node-only. Walks the filesystem with `node:fs/promises` (`readdir`,
+ * `stat`) and resolves paths with `node:path`. No edge-safe
+ * alternative — call from a Node context (build script, Next.js
+ * `next.config.ts`, CI job).
+ */
+declare function discoverSourceMapFiles(buildDir: string): Promise<SourceMapFileInfo[]>;
+/**
+ * Recursively finds all .map files in the given build directory.
+ * Returns relative paths and file contents.
+ *
+ * @deprecated Prefer {@link discoverSourceMapFiles} to avoid loading all
+ * source maps into memory simultaneously.
+ *
+ * @remarks
+ * Node-only. Reads every discovered `.map` file into memory via
+ * `node:fs/promises` (`readFile`). No edge-safe alternative — call
+ * from a Node context (build script, Next.js `next.config.ts`, CI job).
+ */
+declare function collectSourceMaps(buildDir: string): Promise<SourceMapEntry[]>;
+/**
+ * Computes a build hash for source map uploads.
+ *
+ * First tries `git rev-parse HEAD` to get the git commit SHA.
+ * On failure, falls back to a deterministic content hash:
+ * sort source map file paths alphabetically, concatenate each as
+ * `{relativePath}\n{fileLength}\n{fileContent}`, then SHA-256 the result.
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (streaming, reads on demand).
+ *
+ * @remarks
+ * Node-only. Spawns `git rev-parse HEAD` via `node:child_process`
+ * (`execFileSync`), hashes with `node:crypto` (`createHash("sha256")`),
+ * and reads map contents from disk with `node:fs/promises`. No
+ * edge-safe alternative — call from a Node context (build script,
+ * Next.js `next.config.ts`, CI job). If a pre-computed build hash is
+ * already known (e.g., provided as a CI environment variable), pass
+ * it directly to {@link uploadSourceMaps} instead of calling this
+ * helper.
+ */
+declare function computeBuildHash(maps?: SourceMapEntry[] | SourceMapFileInfo[]): Promise<string>;
+/**
+ * Uploads source maps to the ingestion API.
+ *
+ * POSTs to `{endpoint}/v1/source-maps` with the API key, build hash,
+ * and file entries. Validates the response against SourceMapUploadResponseSchema.
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (deferred reads). With `SourceMapFileInfo[]`,
+ * file content is read at upload time rather than at discovery time.
+ * Note: the legacy endpoint sends all files in a single JSON body, so
+ * peak memory is similar — the benefit is deferring reads past discovery.
+ *
+ * @remarks
+ * Node-only. Reads map contents from disk via `node:fs/promises` when
+ * invoked with `SourceMapFileInfo[]`. The network call uses the
+ * platform-standard `fetch` (edge-safe on its own), but the upstream
+ * discovery and read path is Node-only, so the function is only
+ * reachable from a Node context (build script, Next.js
+ * `next.config.ts`, CI job). No edge-safe alternative.
+ */
+declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[]): Promise<SourceMapUploadResponse>;
+/**
+ * Builds at or above this byte size route to the presigned upload flow.
+ *
+ * @remarks
+ * Node-only. The numeric value itself is pure (a constant is evaluable
+ * anywhere), but it is meaningful only alongside
+ * {@link uploadSourceMapsPresigned} and {@link uploadSourceMapsAuto},
+ * both of which depend on `node:fs` and `@vercel/blob`. No edge-safe
+ * alternative — consume from a Node context.
+ */
+declare const PRESIGNED_THRESHOLD_BYTES = 4500000;
+/**
+ * Signature for the blob upload function, injectable for testing.
+ *
+ * @remarks
+ * Node-only. Describes the shape of the uploader consumed by
+ * {@link uploadSourceMapsPresigned} and {@link uploadSourceMapsAuto},
+ * both of which depend on `@vercel/blob` and `node:fs`. The type itself
+ * erases at runtime and is safe to import from edge code, but every
+ * producer and consumer is Node-only.
+ */
+type BlobUploader = (clientToken: string, pathname: string, content: string) => Promise<{
+    url: string;
+    size: number;
+}>;
+/**
+ * Orchestrates the 3-phase presigned upload flow.
+ *
+ * 1. Requests presigned tokens for all source map files
+ * 2. Uploads each file to blob storage with a concurrency limit of 5,
+ *    reading file content from disk just before each upload
+ * 3. Submits the manifest to finalize the upload
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (streaming, reads on demand).
+ *
+ * Accepts an optional `blobUploader` for test injection; defaults to
+ * {@link uploadToBlob}.
+ *
+ * @remarks
+ * Node-only. Streams map contents from disk via `node:fs/promises`
+ * and uploads through `@vercel/blob/client` (loaded lazily as an
+ * optional peer dependency). No edge-safe alternative — call from a
+ * Node context (build script, Next.js `next.config.ts`, CI job).
+ */
+declare function uploadSourceMapsPresigned(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[], blobUploader?: BlobUploader): Promise<SourceMapManifestResponse>;
+/**
+ * Options for {@link uploadSourceMapsAuto}, primarily used for test injection.
+ *
+ * @remarks
+ * Node-only. Describes the shape of overrides consumed by
+ * {@link uploadSourceMapsAuto}, which depends on `node:fs` and
+ * `@vercel/blob`. The type itself erases at runtime and is safe to
+ * import from edge code, but the surrounding function is Node-only.
+ */
+interface AutoUploadOptions {
+    /** Override blob availability check (for testing). */
+    checkBlobAvailable?: () => Promise<boolean>;
+    /** Override blob uploader (for testing). */
+    blobUploader?: BlobUploader;
+}
+/**
+ * Automatically routes source map uploads based on total build size.
+ *
+ * - Below {@link PRESIGNED_THRESHOLD_BYTES}: uses the legacy single-request
+ *   {@link uploadSourceMaps} endpoint.
+ * - At or above the threshold: checks if `@vercel/blob` is available and
+ *   uses the presigned 3-phase flow. Falls back to legacy with a warning
+ *   if the package is not installed.
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (streaming, reads on demand).
+ *
+ * @remarks
+ * Node-only. Reads source map sizes/contents via `node:fs/promises`
+ * and, above the threshold, dynamically loads `@vercel/blob/client`
+ * (optional peer dependency) for direct blob storage uploads. No
+ * edge-safe alternative — call from a Node context (build script,
+ * Next.js `next.config.ts`, CI job). This is the recommended entry
+ * point for source-map upload in most projects.
+ */
+declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
+
+/**
+ * Discovers test files by scanning the project directory for conventional
+ * test file patterns. Also reads vitest/jest config files for custom include
+ * patterns and merges them with the defaults. Excludes node_modules/ and .next/.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns Relative POSIX paths from projectRoot, capped at {@link MAX_TEST_FILES}.
+ *
+ * @remarks
+ * Node-only. Walks the filesystem with `node:fs/promises`
+ * (`readdir`), reads vitest/jest config files with `node:fs`
+ * (`readFileSync`), and resolves paths with `node:path`. No edge-safe
+ * alternative — call from a Node context (build script, CI job,
+ * Next.js `next.config.ts`).
+ */
+declare function discoverTestFiles(projectRoot: string): Promise<string[]>;
+/**
+ * Extracts import paths from file content using regex.
+ * Handles ES module imports, CommonJS requires, and dynamic imports.
+ *
+ * @param fileContent - The full text content of a TypeScript/JavaScript file.
+ * @returns An array of import path strings as written in the source (e.g. "./foo", "react").
+ *
+ * @remarks
+ * Node-only. The function body itself is pure string processing and
+ * would run anywhere, but it is exported through `@glasstrace/sdk/node`
+ * alongside {@link discoverTestFiles} and {@link buildImportGraph} —
+ * the practical consumers all pair it with those Node-only helpers.
+ * Kept under the `/node` subpath for API cohesion; call from a Node
+ * context (build script, CI job, Next.js `next.config.ts`).
+ */
+declare function extractImports(fileContent: string): string[];
+/**
+ * Builds an import graph mapping test file paths to their imported module paths.
+ *
+ * Discovers test files, reads each, extracts imports, and builds a graph.
+ * Computes a deterministic buildHash from the serialized graph content.
+ * Individual file read failures are silently skipped.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns An {@link ImportGraphPayload} containing the graph and a deterministic buildHash.
+ *
+ * @remarks
+ * Node-only. Walks the project with `node:fs/promises`, reads each
+ * test file from disk, resolves paths with `node:path`, and hashes
+ * the serialized graph with `node:crypto` (`createHash("sha256")`).
+ * No edge-safe alternative — call from a Node context (build script,
+ * CI job, Next.js `next.config.ts`).
+ */
+declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
+
+export { type AutoUploadOptions as A, type BlobUploader as B, PRESIGNED_THRESHOLD_BYTES as P, type SourceMapEntry as S, type SourceMapFileInfo as a, buildImportGraph as b, collectSourceMaps as c, computeBuildHash as d, discoverSourceMapFiles as e, discoverTestFiles as f, extractImports as g, uploadSourceMapsAuto as h, uploadSourceMapsPresigned as i, uploadSourceMaps as u };

package/dist/import-graph-Dka_Fm7j.d.ts

@@ -0,0 +1,238 @@
+import { g as SourceMapUploadResponse, h as SourceMapManifestResponse, I as ImportGraphPayload } from './index.d-3-cJoY8y.js';
+
+/**
+ * In-memory source map entry: a file path paired with its full text content.
+ *
+ * @remarks
+ * Node-only. Describes the legacy in-memory shape consumed by
+ * {@link uploadSourceMaps} and {@link uploadSourceMapsAuto}. The type
+ * itself erases at runtime and is safe to import from edge code, but
+ * every function that produces or consumes it depends on `node:fs`
+ * and cannot run at the edge.
+ */
+interface SourceMapEntry {
+    filePath: string;
+    content: string;
+}
+/**
+ * Metadata for a discovered source map file, without its content loaded.
+ * Used by the streaming upload flow to defer file reads until upload time.
+ *
+ * @remarks
+ * Node-only. Describes the shape of data produced by the Node-only
+ * source-map upload flow ({@link discoverSourceMapFiles},
+ * {@link uploadSourceMapsAuto}). The type itself erases at runtime and
+ * is safe to import from edge code, but every function that produces
+ * or consumes it depends on `node:fs`/`node:path` and cannot run at
+ * the edge.
+ */
+interface SourceMapFileInfo {
+    /** Relative path to the compiled JS file (`.map` extension stripped). */
+    filePath: string;
+    /** Absolute path on disk for reading the file content on demand. */
+    absolutePath: string;
+    /** File size in bytes. */
+    sizeBytes: number;
+}
+/**
+ * Recursively discovers all `.map` files in the given build directory.
+ * Returns metadata only — file content is NOT read into memory.
+ *
+ * @remarks
+ * Node-only. Walks the filesystem with `node:fs/promises` (`readdir`,
+ * `stat`) and resolves paths with `node:path`. No edge-safe
+ * alternative — call from a Node context (build script, Next.js
+ * `next.config.ts`, CI job).
+ */
+declare function discoverSourceMapFiles(buildDir: string): Promise<SourceMapFileInfo[]>;
+/**
+ * Recursively finds all .map files in the given build directory.
+ * Returns relative paths and file contents.
+ *
+ * @deprecated Prefer {@link discoverSourceMapFiles} to avoid loading all
+ * source maps into memory simultaneously.
+ *
+ * @remarks
+ * Node-only. Reads every discovered `.map` file into memory via
+ * `node:fs/promises` (`readFile`). No edge-safe alternative — call
+ * from a Node context (build script, Next.js `next.config.ts`, CI job).
+ */
+declare function collectSourceMaps(buildDir: string): Promise<SourceMapEntry[]>;
+/**
+ * Computes a build hash for source map uploads.
+ *
+ * First tries `git rev-parse HEAD` to get the git commit SHA.
+ * On failure, falls back to a deterministic content hash:
+ * sort source map file paths alphabetically, concatenate each as
+ * `{relativePath}\n{fileLength}\n{fileContent}`, then SHA-256 the result.
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (streaming, reads on demand).
+ *
+ * @remarks
+ * Node-only. Spawns `git rev-parse HEAD` via `node:child_process`
+ * (`execFileSync`), hashes with `node:crypto` (`createHash("sha256")`),
+ * and reads map contents from disk with `node:fs/promises`. No
+ * edge-safe alternative — call from a Node context (build script,
+ * Next.js `next.config.ts`, CI job). If a pre-computed build hash is
+ * already known (e.g., provided as a CI environment variable), pass
+ * it directly to {@link uploadSourceMaps} instead of calling this
+ * helper.
+ */
+declare function computeBuildHash(maps?: SourceMapEntry[] | SourceMapFileInfo[]): Promise<string>;
+/**
+ * Uploads source maps to the ingestion API.
+ *
+ * POSTs to `{endpoint}/v1/source-maps` with the API key, build hash,
+ * and file entries. Validates the response against SourceMapUploadResponseSchema.
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (deferred reads). With `SourceMapFileInfo[]`,
+ * file content is read at upload time rather than at discovery time.
+ * Note: the legacy endpoint sends all files in a single JSON body, so
+ * peak memory is similar — the benefit is deferring reads past discovery.
+ *
+ * @remarks
+ * Node-only. Reads map contents from disk via `node:fs/promises` when
+ * invoked with `SourceMapFileInfo[]`. The network call uses the
+ * platform-standard `fetch` (edge-safe on its own), but the upstream
+ * discovery and read path is Node-only, so the function is only
+ * reachable from a Node context (build script, Next.js
+ * `next.config.ts`, CI job). No edge-safe alternative.
+ */
+declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[]): Promise<SourceMapUploadResponse>;
+/**
+ * Builds at or above this byte size route to the presigned upload flow.
+ *
+ * @remarks
+ * Node-only. The numeric value itself is pure (a constant is evaluable
+ * anywhere), but it is meaningful only alongside
+ * {@link uploadSourceMapsPresigned} and {@link uploadSourceMapsAuto},
+ * both of which depend on `node:fs` and `@vercel/blob`. No edge-safe
+ * alternative — consume from a Node context.
+ */
+declare const PRESIGNED_THRESHOLD_BYTES = 4500000;
+/**
+ * Signature for the blob upload function, injectable for testing.
+ *
+ * @remarks
+ * Node-only. Describes the shape of the uploader consumed by
+ * {@link uploadSourceMapsPresigned} and {@link uploadSourceMapsAuto},
+ * both of which depend on `@vercel/blob` and `node:fs`. The type itself
+ * erases at runtime and is safe to import from edge code, but every
+ * producer and consumer is Node-only.
+ */
+type BlobUploader = (clientToken: string, pathname: string, content: string) => Promise<{
+    url: string;
+    size: number;
+}>;
+/**
+ * Orchestrates the 3-phase presigned upload flow.
+ *
+ * 1. Requests presigned tokens for all source map files
+ * 2. Uploads each file to blob storage with a concurrency limit of 5,
+ *    reading file content from disk just before each upload
+ * 3. Submits the manifest to finalize the upload
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (streaming, reads on demand).
+ *
+ * Accepts an optional `blobUploader` for test injection; defaults to
+ * {@link uploadToBlob}.
+ *
+ * @remarks
+ * Node-only. Streams map contents from disk via `node:fs/promises`
+ * and uploads through `@vercel/blob/client` (loaded lazily as an
+ * optional peer dependency). No edge-safe alternative — call from a
+ * Node context (build script, Next.js `next.config.ts`, CI job).
+ */
+declare function uploadSourceMapsPresigned(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[], blobUploader?: BlobUploader): Promise<SourceMapManifestResponse>;
+/**
+ * Options for {@link uploadSourceMapsAuto}, primarily used for test injection.
+ *
+ * @remarks
+ * Node-only. Describes the shape of overrides consumed by
+ * {@link uploadSourceMapsAuto}, which depends on `node:fs` and
+ * `@vercel/blob`. The type itself erases at runtime and is safe to
+ * import from edge code, but the surrounding function is Node-only.
+ */
+interface AutoUploadOptions {
+    /** Override blob availability check (for testing). */
+    checkBlobAvailable?: () => Promise<boolean>;
+    /** Override blob uploader (for testing). */
+    blobUploader?: BlobUploader;
+}
+/**
+ * Automatically routes source map uploads based on total build size.
+ *
+ * - Below {@link PRESIGNED_THRESHOLD_BYTES}: uses the legacy single-request
+ *   {@link uploadSourceMaps} endpoint.
+ * - At or above the threshold: checks if `@vercel/blob` is available and
+ *   uses the presigned 3-phase flow. Falls back to legacy with a warning
+ *   if the package is not installed.
+ *
+ * Accepts either `SourceMapEntry[]` (legacy, in-memory) or
+ * `SourceMapFileInfo[]` (streaming, reads on demand).
+ *
+ * @remarks
+ * Node-only. Reads source map sizes/contents via `node:fs/promises`
+ * and, above the threshold, dynamically loads `@vercel/blob/client`
+ * (optional peer dependency) for direct blob storage uploads. No
+ * edge-safe alternative — call from a Node context (build script,
+ * Next.js `next.config.ts`, CI job). This is the recommended entry
+ * point for source-map upload in most projects.
+ */
+declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
+
+/**
+ * Discovers test files by scanning the project directory for conventional
+ * test file patterns. Also reads vitest/jest config files for custom include
+ * patterns and merges them with the defaults. Excludes node_modules/ and .next/.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns Relative POSIX paths from projectRoot, capped at {@link MAX_TEST_FILES}.
+ *
+ * @remarks
+ * Node-only. Walks the filesystem with `node:fs/promises`
+ * (`readdir`), reads vitest/jest config files with `node:fs`
+ * (`readFileSync`), and resolves paths with `node:path`. No edge-safe
+ * alternative — call from a Node context (build script, CI job,
+ * Next.js `next.config.ts`).
+ */
+declare function discoverTestFiles(projectRoot: string): Promise<string[]>;
+/**
+ * Extracts import paths from file content using regex.
+ * Handles ES module imports, CommonJS requires, and dynamic imports.
+ *
+ * @param fileContent - The full text content of a TypeScript/JavaScript file.
+ * @returns An array of import path strings as written in the source (e.g. "./foo", "react").
+ *
+ * @remarks
+ * Node-only. The function body itself is pure string processing and
+ * would run anywhere, but it is exported through `@glasstrace/sdk/node`
+ * alongside {@link discoverTestFiles} and {@link buildImportGraph} —
+ * the practical consumers all pair it with those Node-only helpers.
+ * Kept under the `/node` subpath for API cohesion; call from a Node
+ * context (build script, CI job, Next.js `next.config.ts`).
+ */
+declare function extractImports(fileContent: string): string[];
+/**
+ * Builds an import graph mapping test file paths to their imported module paths.
+ *
+ * Discovers test files, reads each, extracts imports, and builds a graph.
+ * Computes a deterministic buildHash from the serialized graph content.
+ * Individual file read failures are silently skipped.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns An {@link ImportGraphPayload} containing the graph and a deterministic buildHash.
+ *
+ * @remarks
+ * Node-only. Walks the project with `node:fs/promises`, reads each
+ * test file from disk, resolves paths with `node:path`, and hashes
+ * the serialized graph with `node:crypto` (`createHash("sha256")`).
+ * No edge-safe alternative — call from a Node context (build script,
+ * CI job, Next.js `next.config.ts`).
+ */
+declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
+
+export { type AutoUploadOptions as A, type BlobUploader as B, PRESIGNED_THRESHOLD_BYTES as P, type SourceMapEntry as S, type SourceMapFileInfo as a, buildImportGraph as b, collectSourceMaps as c, computeBuildHash as d, discoverSourceMapFiles as e, discoverTestFiles as f, extractImports as g, uploadSourceMapsAuto as h, uploadSourceMapsPresigned as i, uploadSourceMaps as u };