@glasstrace/sdk 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -187,8 +187,9 @@ declare function isProductionDisabled(config: ResolvedConfig): boolean;
 declare function isAnonymousMode(config: ResolvedConfig): boolean;
 
 /**
- * Derives a deterministic session ID from the given inputs using SHA-256.
- * The hash is truncated to 16 hex characters and parsed through SessionIdSchema.
+ * Derives a deterministic session ID from the given inputs.
+ * Uses SHA-256 (truncated to 16 hex chars) when `node:crypto` is available,
+ * or a deterministic FNV-1a hash as a fallback in non-Node environments.
  *
  * @param apiKey - The project's API key (or anonymous placeholder).
  * @param origin - The origin string identifying the deployment environment.
@@ -253,6 +254,7 @@ declare function classifyFetchTarget(url: string): FetchTarget;
  * - The file does not exist
  * - The file content is invalid
  * - An I/O error occurs
+ * - `node:fs` is unavailable (non-Node environment)
  */
 declare function readAnonKey(projectRoot?: string): Promise<AnonApiKey | null>;
 /**
@@ -263,17 +265,20 @@ declare function readAnonKey(projectRoot?: string): Promise<AnonApiKey | null>;
  * - Writes the new key to `.glasstrace/anon_key`, creating the directory if needed
  * - On file write failure: logs a warning, caches an ephemeral in-memory key so
  *   repeated calls in the same process return the same key
+ * - In non-Node environments: returns an ephemeral in-memory key
  */
 declare function getOrCreateAnonKey(projectRoot?: string): Promise<AnonApiKey>;
 
 /**
  * Reads and validates a cached config file from `.glasstrace/config`.
- * Returns the parsed `SdkInitResponse` or `null` on any failure.
+ * Returns the parsed `SdkInitResponse` or `null` on any failure,
+ * including when `node:fs` is unavailable (non-Node environments).
  */
 declare function loadCachedConfig(projectRoot?: string): SdkInitResponse | null;
 /**
  * Persists the init response to `.glasstrace/config`.
- * On failure, logs a warning and continues.
+ * Silently skipped when `node:fs` is unavailable (non-Node environments).
+ * On I/O failure, logs a warning and continues.
  */
 declare function saveCachedConfig(response: SdkInitResponse, projectRoot?: string): Promise<void>;
 /**
@@ -491,9 +496,29 @@ 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.
+ */
+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.
+ */
+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.
  */
 declare function collectSourceMaps(buildDir: string): Promise<SourceMapEntry[]>;
 /**
@@ -503,15 +528,24 @@ declare function collectSourceMaps(buildDir: string): Promise<SourceMapEntry[]>;
  * 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).
  */
-declare function computeBuildHash(maps?: SourceMapEntry[]): Promise<string>;
+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.
  */
-declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[]): Promise<SourceMapUploadResponse>;
+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. */
 declare const PRESIGNED_THRESHOLD_BYTES = 4500000;
 /** Signature for the blob upload function, injectable for testing. */
@@ -523,13 +557,17 @@ type BlobUploader = (clientToken: string, pathname: string, content: string) =>
  * 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
+ * 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}.
  */
-declare function uploadSourceMapsPresigned(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[], blobUploader?: BlobUploader): Promise<SourceMapManifestResponse>;
+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.
  */
@@ -547,8 +585,11 @@ interface AutoUploadOptions {
  * - 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).
  */
-declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
+declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
 
 /**
  * Manual error capture API.
@@ -611,4 +652,4 @@ declare function extractImports(fileContent: string): string[];
  */
 declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
 
-export { type AutoUploadOptions, type BlobUploader, type ClaimState, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, deriveSessionId, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, withGlasstraceConfig };
+export { type AutoUploadOptions, type BlobUploader, type ClaimState, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, type SourceMapFileInfo, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, deriveSessionId, discoverSourceMapFiles, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, withGlasstraceConfig };

package/dist/index.d.ts

@@ -187,8 +187,9 @@ declare function isProductionDisabled(config: ResolvedConfig): boolean;
 declare function isAnonymousMode(config: ResolvedConfig): boolean;
 
 /**
- * Derives a deterministic session ID from the given inputs using SHA-256.
- * The hash is truncated to 16 hex characters and parsed through SessionIdSchema.
+ * Derives a deterministic session ID from the given inputs.
+ * Uses SHA-256 (truncated to 16 hex chars) when `node:crypto` is available,
+ * or a deterministic FNV-1a hash as a fallback in non-Node environments.
  *
  * @param apiKey - The project's API key (or anonymous placeholder).
  * @param origin - The origin string identifying the deployment environment.
@@ -253,6 +254,7 @@ declare function classifyFetchTarget(url: string): FetchTarget;
  * - The file does not exist
  * - The file content is invalid
  * - An I/O error occurs
+ * - `node:fs` is unavailable (non-Node environment)
  */
 declare function readAnonKey(projectRoot?: string): Promise<AnonApiKey | null>;
 /**
@@ -263,17 +265,20 @@ declare function readAnonKey(projectRoot?: string): Promise<AnonApiKey | null>;
  * - Writes the new key to `.glasstrace/anon_key`, creating the directory if needed
  * - On file write failure: logs a warning, caches an ephemeral in-memory key so
  *   repeated calls in the same process return the same key
+ * - In non-Node environments: returns an ephemeral in-memory key
  */
 declare function getOrCreateAnonKey(projectRoot?: string): Promise<AnonApiKey>;
 
 /**
  * Reads and validates a cached config file from `.glasstrace/config`.
- * Returns the parsed `SdkInitResponse` or `null` on any failure.
+ * Returns the parsed `SdkInitResponse` or `null` on any failure,
+ * including when `node:fs` is unavailable (non-Node environments).
  */
 declare function loadCachedConfig(projectRoot?: string): SdkInitResponse | null;
 /**
  * Persists the init response to `.glasstrace/config`.
- * On failure, logs a warning and continues.
+ * Silently skipped when `node:fs` is unavailable (non-Node environments).
+ * On I/O failure, logs a warning and continues.
  */
 declare function saveCachedConfig(response: SdkInitResponse, projectRoot?: string): Promise<void>;
 /**
@@ -491,9 +496,29 @@ 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.
+ */
+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.
+ */
+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.
  */
 declare function collectSourceMaps(buildDir: string): Promise<SourceMapEntry[]>;
 /**
@@ -503,15 +528,24 @@ declare function collectSourceMaps(buildDir: string): Promise<SourceMapEntry[]>;
  * 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).
  */
-declare function computeBuildHash(maps?: SourceMapEntry[]): Promise<string>;
+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.
  */
-declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[]): Promise<SourceMapUploadResponse>;
+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. */
 declare const PRESIGNED_THRESHOLD_BYTES = 4500000;
 /** Signature for the blob upload function, injectable for testing. */
@@ -523,13 +557,17 @@ type BlobUploader = (clientToken: string, pathname: string, content: string) =>
  * 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
+ * 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}.
  */
-declare function uploadSourceMapsPresigned(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[], blobUploader?: BlobUploader): Promise<SourceMapManifestResponse>;
+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.
  */
@@ -547,8 +585,11 @@ interface AutoUploadOptions {
  * - 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).
  */
-declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
+declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[] | SourceMapFileInfo[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
 
 /**
  * Manual error capture API.
@@ -611,4 +652,4 @@ declare function extractImports(fileContent: string): string[];
  */
 declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
 
-export { type AutoUploadOptions, type BlobUploader, type ClaimState, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, deriveSessionId, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, withGlasstraceConfig };
+export { type AutoUploadOptions, type BlobUploader, type ClaimState, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, type SourceMapFileInfo, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, deriveSessionId, discoverSourceMapFiles, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, withGlasstraceConfig };

package/dist/index.js

@@ -2,6 +2,7 @@ import {
   PRESIGNED_THRESHOLD_BYTES,
   collectSourceMaps,
   computeBuildHash,
+  discoverSourceMapFiles,
   installConsoleCapture,
   isAnonymousMode,
   isProductionDisabled,
@@ -11,23 +12,23 @@ import {
   uploadSourceMaps,
   uploadSourceMapsAuto,
   uploadSourceMapsPresigned
-} from "./chunk-SLSWEQCC.js";
+} from "./chunk-MSMOH6IH.js";
 import {
   buildImportGraph,
   discoverTestFiles,
   extractImports
-} from "./chunk-M7RDFOFR.js";
+} from "./chunk-LW7DPKBA.js";
 import {
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-2JUH3VGJ.js";
+} from "./chunk-6GRNJ722.js";
 import {
   DEFAULT_CAPTURE_CONFIG,
   GLASSTRACE_ATTRIBUTE_NAMES,
   SdkCachedConfigSchema,
   SdkInitResponseSchema,
   SessionIdSchema
-} from "./chunk-D3JC3LAK.js";
+} from "./chunk-OKIP4SRG.js";
 import {
   INVALID_SPAN_CONTEXT,
   SamplingDecision,
@@ -43,7 +44,9 @@ import {
   isValidTraceId,
   trace
 } from "./chunk-DQ25VOKK.js";
-import "./chunk-PZ5AY32C.js";
+import {
+  __require
+} from "./chunk-NSBPE2FW.js";
 
 // src/errors.ts
 var SdkError = class extends Error {
@@ -56,13 +59,36 @@ var SdkError = class extends Error {
 };
 
 // src/session.ts
-import { createHash } from "crypto";
 var FOUR_HOURS_MS = 4 * 60 * 60 * 1e3;
+var hashFn = null;
+function fnv1aHash(input) {
+  let hash = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+    hash >>>= 0;
+  }
+  return hash.toString(16).padStart(8, "0");
+}
+function getHashFn() {
+  if (hashFn) return hashFn;
+  try {
+    const { createHash } = __require("crypto");
+    hashFn = (input) => createHash("sha256").update(input).digest("hex").slice(0, 16);
+  } catch {
+    hashFn = (input) => {
+      const h1 = fnv1aHash(input);
+      const h2 = fnv1aHash(input + "\0");
+      return (h1 + h2).slice(0, 16);
+    };
+  }
+  return hashFn;
+}
 var cachedGlasstraceEnv = process.env.GLASSTRACE_ENV;
 var cachedPort = process.env.PORT ?? "3000";
 function deriveSessionId(apiKey, origin, date, windowIndex) {
   const input = JSON.stringify([apiKey, origin, date, windowIndex]);
-  const hash = createHash("sha256").update(input).digest("hex").slice(0, 16);
+  const hash = getHashFn()(input);
   return SessionIdSchema.parse(hash);
 }
 function getOrigin() {
@@ -148,21 +174,44 @@ function classifyFetchTarget(url) {
 }
 
 // src/init-client.ts
-import { readFileSync } from "fs";
-import { readFile, writeFile, mkdir, chmod } from "fs/promises";
-import { join } from "path";
 var GLASSTRACE_DIR = ".glasstrace";
 var CONFIG_FILE = "config";
 var TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1e3;
 var INIT_TIMEOUT_MS = 1e4;
+var fsPathAsyncCache;
+async function loadFsPathAsync() {
+  if (fsPathAsyncCache !== void 0) return fsPathAsyncCache;
+  try {
+    const [fs2, path2] = await Promise.all([
+      import("fs/promises"),
+      import("path")
+    ]);
+    fsPathAsyncCache = { fs: fs2, path: path2 };
+    return fsPathAsyncCache;
+  } catch {
+    fsPathAsyncCache = null;
+    return null;
+  }
+}
+function loadFsSyncOrNull() {
+  try {
+    const fs2 = __require("fs");
+    const path2 = __require("path");
+    return { readFileSync: fs2.readFileSync, join: path2.join };
+  } catch {
+    return null;
+  }
+}
 var currentConfig = null;
 var configCacheChecked = false;
 var rateLimitBackoff = false;
 function loadCachedConfig(projectRoot) {
+  const modules = loadFsSyncOrNull();
+  if (!modules) return null;
   const root = projectRoot ?? process.cwd();
-  const configPath = join(root, GLASSTRACE_DIR, CONFIG_FILE);
+  const configPath = modules.join(root, GLASSTRACE_DIR, CONFIG_FILE);
   try {
-    const content = readFileSync(configPath, "utf-8");
+    const content = modules.readFileSync(configPath, "utf-8");
     const parsed = JSON.parse(content);
     const cached = SdkCachedConfigSchema.parse(parsed);
     const age = Date.now() - cached.cachedAt;
@@ -182,18 +231,20 @@ function loadCachedConfig(projectRoot) {
   }
 }
 async function saveCachedConfig(response, projectRoot) {
+  const modules = await loadFsPathAsync();
+  if (!modules) return;
   const root = projectRoot ?? process.cwd();
-  const dirPath = join(root, GLASSTRACE_DIR);
-  const configPath = join(dirPath, CONFIG_FILE);
+  const dirPath = modules.path.join(root, GLASSTRACE_DIR);
+  const configPath = modules.path.join(dirPath, CONFIG_FILE);
   try {
-    await mkdir(dirPath, { recursive: true, mode: 448 });
-    await chmod(dirPath, 448);
+    await modules.fs.mkdir(dirPath, { recursive: true, mode: 448 });
+    await modules.fs.chmod(dirPath, 448);
     const cached = {
       response,
       cachedAt: Date.now()
     };
-    await writeFile(configPath, JSON.stringify(cached), { encoding: "utf-8", mode: 384 });
-    await chmod(configPath, 384);
+    await modules.fs.writeFile(configPath, JSON.stringify(cached), { encoding: "utf-8", mode: 384 });
+    await modules.fs.chmod(configPath, 384);
   } catch (err) {
     console.warn(
       `[glasstrace] Failed to cache config to ${configPath}: ${err instanceof Error ? err.message : String(err)}`
@@ -247,69 +298,72 @@ async function sendInitRequest(config, anonKey, sdkVersion, importGraph, healthR
   return SdkInitResponseSchema.parse(body);
 }
 async function writeClaimedKey(newApiKey, projectRoot) {
-  const root = projectRoot ?? process.cwd();
-  const envLocalPath = join(root, ".env.local");
-  let envLocalWritten = false;
-  try {
-    let content;
+  const modules = await loadFsPathAsync();
+  if (modules) {
+    const root = projectRoot ?? process.cwd();
+    const envLocalPath = modules.path.join(root, ".env.local");
+    let envLocalWritten = false;
     try {
-      content = await readFile(envLocalPath, "utf-8");
-      if (/^GLASSTRACE_API_KEY=.*/m.test(content)) {
-        content = content.replace(
-          /^GLASSTRACE_API_KEY=.*$/gm,
-          `GLASSTRACE_API_KEY=${newApiKey}`
-        );
-      } else {
-        if (content.length > 0 && !content.endsWith("\n")) {
-          content += "\n";
+      let content;
+      try {
+        content = await modules.fs.readFile(envLocalPath, "utf-8");
+        if (/^GLASSTRACE_API_KEY=.*/m.test(content)) {
+          content = content.replace(
+            /^GLASSTRACE_API_KEY=.*$/gm,
+            `GLASSTRACE_API_KEY=${newApiKey}`
+          );
+        } else {
+          if (content.length > 0 && !content.endsWith("\n")) {
+            content += "\n";
+          }
+          content += `GLASSTRACE_API_KEY=${newApiKey}
+`;
+        }
+      } catch (readErr) {
+        const code = readErr instanceof Error ? readErr.code : void 0;
+        if (code !== "ENOENT") {
+          throw readErr;
         }
-        content += `GLASSTRACE_API_KEY=${newApiKey}
+        content = `GLASSTRACE_API_KEY=${newApiKey}
 `;
       }
-    } catch (readErr) {
-      const code = readErr instanceof Error ? readErr.code : void 0;
-      if (code !== "ENOENT") {
-        throw readErr;
+      await modules.fs.writeFile(envLocalPath, content, { encoding: "utf-8", mode: 384 });
+      await modules.fs.chmod(envLocalPath, 384);
+      envLocalWritten = true;
+    } catch {
+    }
+    if (envLocalWritten) {
+      try {
+        process.stderr.write(
+          "[glasstrace] Account claimed! API key written to .env.local. Restart your dev server to use it.\n"
+        );
+      } catch {
       }
-      content = `GLASSTRACE_API_KEY=${newApiKey}
-`;
+      return;
     }
-    await writeFile(envLocalPath, content, { encoding: "utf-8", mode: 384 });
-    await chmod(envLocalPath, 384);
-    envLocalWritten = true;
-  } catch {
-  }
-  if (envLocalWritten) {
+    let claimedKeyWritten = false;
     try {
-      process.stderr.write(
-        "[glasstrace] Account claimed! API key written to .env.local. Restart your dev server to use it.\n"
-      );
+      const dirPath = modules.path.join(root, GLASSTRACE_DIR);
+      await modules.fs.mkdir(dirPath, { recursive: true, mode: 448 });
+      await modules.fs.chmod(dirPath, 448);
+      const claimedKeyPath = modules.path.join(dirPath, "claimed-key");
+      await modules.fs.writeFile(claimedKeyPath, newApiKey, {
+        encoding: "utf-8",
+        mode: 384
+      });
+      await modules.fs.chmod(claimedKeyPath, 384);
+      claimedKeyWritten = true;
     } catch {
     }
-    return;
-  }
-  let claimedKeyWritten = false;
-  try {
-    const dirPath = join(root, GLASSTRACE_DIR);
-    await mkdir(dirPath, { recursive: true, mode: 448 });
-    await chmod(dirPath, 448);
-    const claimedKeyPath = join(dirPath, "claimed-key");
-    await writeFile(claimedKeyPath, newApiKey, {
-      encoding: "utf-8",
-      mode: 384
-    });
-    await chmod(claimedKeyPath, 384);
-    claimedKeyWritten = true;
-  } catch {
-  }
-  if (claimedKeyWritten) {
-    try {
-      process.stderr.write(
-        "[glasstrace] Account claimed! API key written to .glasstrace/claimed-key. Copy it to your .env.local file.\n"
-      );
-    } catch {
+    if (claimedKeyWritten) {
+      try {
+        process.stderr.write(
+          "[glasstrace] Account claimed! API key written to .glasstrace/claimed-key. Copy it to your .env.local file.\n"
+        );
+      } catch {
+      }
+      return;
     }
-    return;
   }
   try {
     process.stderr.write(
@@ -3618,7 +3672,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const initResult = await performInit(config, anonKeyForInit, "0.11.0");
+  const initResult = await performInit(config, anonKeyForInit, "0.12.0");
   if (generation !== registrationGeneration) return;
   if (initResult?.claimResult) {
     setResolvedApiKey(initResult.claimResult.newApiKey);
@@ -3692,16 +3746,16 @@ async function handleSourceMapUpload(distDir) {
       );
       return;
     }
-    const { collectSourceMaps: collectSourceMaps2, computeBuildHash: computeBuildHash2, uploadSourceMaps: uploadSourceMaps2 } = await import("./source-map-uploader-OFEM54UE.js");
-    const maps = await collectSourceMaps2(distDir);
-    if (maps.length === 0) {
+    const { discoverSourceMapFiles: discoverSourceMapFiles2, computeBuildHash: computeBuildHash2, uploadSourceMaps: uploadSourceMaps2 } = await import("./source-map-uploader-ZFCYOURS.js");
+    const files = await discoverSourceMapFiles2(distDir);
+    if (files.length === 0) {
       console.info("[glasstrace] No source map files found. Skipping upload.");
       return;
     }
-    const buildHash = await computeBuildHash2(maps);
-    await uploadSourceMaps2(apiKey, endpoint, buildHash, maps);
+    const buildHash = await computeBuildHash2(files);
+    await uploadSourceMaps2(apiKey, endpoint, buildHash, files);
     console.info(
-      `[glasstrace] Uploaded ${String(maps.length)} source map(s) for build ${buildHash}.`
+      `[glasstrace] Uploaded ${String(files.length)} source map(s) for build ${buildHash}.`
     );
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";
@@ -3743,6 +3797,7 @@ export {
   computeBuildHash,
   createDiscoveryHandler,
   deriveSessionId,
+  discoverSourceMapFiles,
   discoverTestFiles,
   extractImports,
   getActiveConfig,