@glasstrace/sdk 0.4.2 → 0.7.0

package/dist/index.d.cts

@@ -67,6 +67,7 @@ type GlasstraceEnvVars = z.infer<typeof GlasstraceEnvVarsSchema>;
  * - SDK health diagnostics (embedded in init requests)
  * - Discovery endpoint (GET /__glasstrace/config)
  * - Source map upload (POST /v1/source-maps)
+ * - Presigned source map upload (POST /v1/source-maps/presign, POST /v1/source-maps/manifest)
  */
 
 /** Test file import relationships, embedded in SDK init request. */
@@ -112,6 +113,11 @@ declare const SdkInitResponseSchema: z.ZodObject<{
         maxTraceSizeBytes: z.ZodNumber;
         maxConcurrentSessions: z.ZodNumber;
     }, z.core.$strip>;
+    claimResult: z.ZodOptional<z.ZodObject<{
+        newApiKey: z.core.$ZodBranded<z.ZodString, "DevApiKey", "out">;
+        accountId: z.ZodString;
+        graceExpiresAt: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type SdkInitResponse = z.infer<typeof SdkInitResponseSchema>;
 /** Response from POST /v1/source-maps. */
@@ -122,6 +128,15 @@ declare const SourceMapUploadResponseSchema: z.ZodObject<{
     totalSizeBytes: z.ZodNumber;
 }, z.core.$strip>;
 type SourceMapUploadResponse = z.infer<typeof SourceMapUploadResponseSchema>;
+/** Response confirming source map manifest activation. */
+declare const SourceMapManifestResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    buildHash: z.core.$ZodBranded<z.ZodString, "BuildHash", "out">;
+    fileCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+    activatedAt: z.ZodNumber;
+}, z.core.$strip>;
+type SourceMapManifestResponse = z.infer<typeof SourceMapManifestResponseSchema>;
 
 /**
  * Internal SDK error class with a typed diagnostic code.
@@ -270,11 +285,24 @@ declare function sendInitRequest(config: ResolvedConfig, anonKey: AnonApiKey | n
     message: string;
     timestamp: number;
 }>, signal?: AbortSignal): Promise<SdkInitResponse>;
+/**
+ * Result returned by {@link performInit} when the backend reports an
+ * account claim transition. `null` means no claim was present.
+ */
+interface InitClaimResult {
+    claimResult: NonNullable<SdkInitResponse["claimResult"]>;
+}
 /**
  * Orchestrates the full init flow: send request, update config, cache result.
  * This function MUST NOT throw.
+ *
+ * Returns the claim result when the backend reports an account claim
+ * transition, or `null` when no claim result is available (including
+ * when init is skipped due to rate-limit backoff, missing API key,
+ * or request failure). Callers that do not need claim information
+ * can safely ignore the return value.
  */
-declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string): Promise<void>;
+declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string): Promise<InitClaimResult | null>;
 /**
  * Returns the current capture config from the three-tier fallback chain:
  * 1. In-memory config from latest init response
@@ -457,6 +485,43 @@ declare function computeBuildHash(maps?: SourceMapEntry[]): Promise<string>;
  * and file entries. Validates the response against SourceMapUploadResponseSchema.
  */
 declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[]): 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. */
+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
+ * 3. Submits the manifest to finalize the upload
+ *
+ * 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>;
+/**
+ * Options for {@link uploadSourceMapsAuto}, primarily used for test injection.
+ */
+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.
+ */
+declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
 
 /**
  * Manual error capture API.
@@ -519,4 +584,4 @@ declare function extractImports(fileContent: string): string[];
  */
 declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
 
-export { type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, deriveSessionId, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, withGlasstraceConfig };
+export { type AutoUploadOptions, type BlobUploader, 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, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, withGlasstraceConfig };

package/dist/index.d.ts

@@ -67,6 +67,7 @@ type GlasstraceEnvVars = z.infer<typeof GlasstraceEnvVarsSchema>;
  * - SDK health diagnostics (embedded in init requests)
  * - Discovery endpoint (GET /__glasstrace/config)
  * - Source map upload (POST /v1/source-maps)
+ * - Presigned source map upload (POST /v1/source-maps/presign, POST /v1/source-maps/manifest)
  */
 
 /** Test file import relationships, embedded in SDK init request. */
@@ -112,6 +113,11 @@ declare const SdkInitResponseSchema: z.ZodObject<{
         maxTraceSizeBytes: z.ZodNumber;
         maxConcurrentSessions: z.ZodNumber;
     }, z.core.$strip>;
+    claimResult: z.ZodOptional<z.ZodObject<{
+        newApiKey: z.core.$ZodBranded<z.ZodString, "DevApiKey", "out">;
+        accountId: z.ZodString;
+        graceExpiresAt: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type SdkInitResponse = z.infer<typeof SdkInitResponseSchema>;
 /** Response from POST /v1/source-maps. */
@@ -122,6 +128,15 @@ declare const SourceMapUploadResponseSchema: z.ZodObject<{
     totalSizeBytes: z.ZodNumber;
 }, z.core.$strip>;
 type SourceMapUploadResponse = z.infer<typeof SourceMapUploadResponseSchema>;
+/** Response confirming source map manifest activation. */
+declare const SourceMapManifestResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    buildHash: z.core.$ZodBranded<z.ZodString, "BuildHash", "out">;
+    fileCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+    activatedAt: z.ZodNumber;
+}, z.core.$strip>;
+type SourceMapManifestResponse = z.infer<typeof SourceMapManifestResponseSchema>;
 
 /**
  * Internal SDK error class with a typed diagnostic code.
@@ -270,11 +285,24 @@ declare function sendInitRequest(config: ResolvedConfig, anonKey: AnonApiKey | n
     message: string;
     timestamp: number;
 }>, signal?: AbortSignal): Promise<SdkInitResponse>;
+/**
+ * Result returned by {@link performInit} when the backend reports an
+ * account claim transition. `null` means no claim was present.
+ */
+interface InitClaimResult {
+    claimResult: NonNullable<SdkInitResponse["claimResult"]>;
+}
 /**
  * Orchestrates the full init flow: send request, update config, cache result.
  * This function MUST NOT throw.
+ *
+ * Returns the claim result when the backend reports an account claim
+ * transition, or `null` when no claim result is available (including
+ * when init is skipped due to rate-limit backoff, missing API key,
+ * or request failure). Callers that do not need claim information
+ * can safely ignore the return value.
  */
-declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string): Promise<void>;
+declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string): Promise<InitClaimResult | null>;
 /**
  * Returns the current capture config from the three-tier fallback chain:
  * 1. In-memory config from latest init response
@@ -457,6 +485,43 @@ declare function computeBuildHash(maps?: SourceMapEntry[]): Promise<string>;
  * and file entries. Validates the response against SourceMapUploadResponseSchema.
  */
 declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[]): 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. */
+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
+ * 3. Submits the manifest to finalize the upload
+ *
+ * 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>;
+/**
+ * Options for {@link uploadSourceMapsAuto}, primarily used for test injection.
+ */
+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.
+ */
+declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHash: string, maps: SourceMapEntry[], options?: AutoUploadOptions): Promise<SourceMapUploadResponse | SourceMapManifestResponse>;
 
 /**
  * Manual error capture API.
@@ -519,4 +584,4 @@ declare function extractImports(fileContent: string): string[];
  */
 declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
 
-export { type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, deriveSessionId, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, withGlasstraceConfig };
+export { type AutoUploadOptions, type BlobUploader, 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, getOrCreateAnonKey, getOrigin, isAnonymousMode, isProductionDisabled, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, withGlasstraceConfig };

package/dist/index.js

@@ -2,17 +2,19 @@ import {
   buildImportGraph,
   discoverTestFiles,
   extractImports
-} from "./chunk-67H2JEI4.js";
+} from "./chunk-SALPGSWK.js";
 import {
   DEFAULT_CAPTURE_CONFIG,
   GLASSTRACE_ATTRIBUTE_NAMES,
+  PresignedUploadResponseSchema,
   SdkCachedConfigSchema,
   SdkInitResponseSchema,
   SessionIdSchema,
+  SourceMapManifestResponseSchema,
   SourceMapUploadResponseSchema,
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-TVOYTJ7I.js";
+} from "./chunk-QW6W4CSA.js";
 import {
   INVALID_SPAN_CONTEXT,
   SamplingDecision,
@@ -281,13 +283,13 @@ async function sendInitRequest(config, anonKey, sdkVersion, importGraph, healthR
 async function performInit(config, anonKey, sdkVersion) {
   if (rateLimitBackoff) {
     rateLimitBackoff = false;
-    return;
+    return null;
   }
   try {
     const effectiveKey = config.apiKey || anonKey;
     if (!effectiveKey) {
       console.warn("[glasstrace] No API key available for init request.");
-      return;
+      return null;
     }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), INIT_TIMEOUT_MS);
@@ -304,45 +306,61 @@ async function performInit(config, anonKey, sdkVersion) {
       clearTimeout(timeoutId);
       currentConfig = result;
       await saveCachedConfig(result);
+      if (result.claimResult) {
+        try {
+          process.stderr.write(
+            `[glasstrace] Account claimed! Update GLASSTRACE_API_KEY=${result.claimResult.newApiKey} in your .env file.
+`
+          );
+        } catch (logErr) {
+          console.warn(
+            `[glasstrace] Failed to write claim migration message: ${logErr instanceof Error ? logErr.message : String(logErr)}`
+          );
+        }
+        return { claimResult: result.claimResult };
+      }
+      return null;
     } catch (err) {
       clearTimeout(timeoutId);
       if (err instanceof DOMException && err.name === "AbortError") {
         console.warn("[glasstrace] ingestion_unreachable: Init request timed out.");
-        return;
+        return null;
       }
       const status = err.status;
       if (status === 401) {
         console.warn(
           "[glasstrace] ingestion_auth_failed: Check your GLASSTRACE_API_KEY."
         );
-        return;
+        return null;
       }
       if (status === 429) {
         console.warn("[glasstrace] ingestion_rate_limited: Backing off.");
         rateLimitBackoff = true;
-        return;
+        return null;
       }
       if (typeof status === "number" && status >= 400) {
         console.warn(
           `[glasstrace] Init request failed with status ${status}. Using cached config.`
         );
-        return;
+        return null;
       }
       if (err instanceof Error && err.name === "ZodError") {
         console.warn(
           "[glasstrace] Init response failed validation (schema version mismatch?). Using cached config."
         );
-        return;
+        return null;
       }
       console.warn(
         `[glasstrace] ingestion_unreachable: ${err instanceof Error ? err.message : String(err)}`
       );
+      return null;
     }
   } catch (err) {
     console.warn(
       `[glasstrace] Unexpected init error: ${err instanceof Error ? err.message : String(err)}`
     );
   }
+  return null;
 }
 function getActiveConfig() {
   if (currentConfig) {
@@ -3452,6 +3470,14 @@ async function installConsoleCapture() {
     }
   };
 }
+function sdkLog(level, message) {
+  isGlasstraceLog = true;
+  try {
+    console[level](message);
+  } finally {
+    isGlasstraceLog = false;
+  }
+}
 
 // src/register.ts
 var consoleCaptureInstalled = false;
@@ -3541,7 +3567,11 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.4.2");
+            const initResult = await performInit(config, anonKey, "0.7.0");
+            if (initResult?.claimResult) {
+              setResolvedApiKey(initResult.claimResult.newApiKey);
+              notifyApiKeyResolved();
+            }
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3561,7 +3591,11 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.4.2");
+            const initResult = await performInit(config, anonKey, "0.7.0");
+            if (initResult?.claimResult) {
+              setResolvedApiKey(initResult.claimResult.newApiKey);
+              notifyApiKeyResolved();
+            }
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3583,7 +3617,7 @@ function registerGlasstrace(options) {
           if (config.verbose) {
             console.info("[glasstrace] Background init firing.");
           }
-          await performInit(config, anonKeyForInit, "0.4.2");
+          await performInit(config, anonKeyForInit, "0.7.0");
           maybeInstallConsoleCapture();
         } catch (err) {
           console.warn(
@@ -3682,10 +3716,7 @@ async function uploadSourceMaps(apiKey, endpoint, buildHash, maps) {
       sourceMap: m.content
     }))
   };
-  let baseUrl = endpoint;
-  while (baseUrl.endsWith("/")) {
-    baseUrl = baseUrl.slice(0, -1);
-  }
+  const baseUrl = stripTrailingSlashes(endpoint);
   const response = await fetch(`${baseUrl}/v1/source-maps`, {
     method: "POST",
     headers: {
@@ -3706,6 +3737,155 @@ async function uploadSourceMaps(apiKey, endpoint, buildHash, maps) {
   const json = await response.json();
   return SourceMapUploadResponseSchema.parse(json);
 }
+var PRESIGNED_THRESHOLD_BYTES = 45e5;
+function stripTrailingSlashes(url) {
+  let result = url;
+  while (result.endsWith("/")) {
+    result = result.slice(0, -1);
+  }
+  return result;
+}
+async function requestPresignedTokens(apiKey, endpoint, buildHash, files) {
+  const baseUrl = stripTrailingSlashes(endpoint);
+  const response = await fetch(`${baseUrl}/v1/source-maps/presign`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({ buildHash, files })
+  });
+  if (!response.ok) {
+    try {
+      await response.text();
+    } catch {
+    }
+    throw new Error(
+      `Presigned token request failed: ${String(response.status)} ${response.statusText}`
+    );
+  }
+  const json = await response.json();
+  return PresignedUploadResponseSchema.parse(json);
+}
+async function uploadToBlob(clientToken, pathname, content) {
+  let mod;
+  try {
+    mod = await import("@vercel/blob/client");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
+      throw new Error(
+        "Presigned upload requires @vercel/blob. Install it: npm install @vercel/blob"
+      );
+    }
+    throw err;
+  }
+  const result = await mod.put(pathname, new Blob([content]), {
+    access: "public",
+    token: clientToken
+  });
+  return { url: result.url, size: Buffer.byteLength(content, "utf-8") };
+}
+async function submitManifest(apiKey, endpoint, uploadId, buildHash, files) {
+  const baseUrl = stripTrailingSlashes(endpoint);
+  const response = await fetch(`${baseUrl}/v1/source-maps/manifest`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({ uploadId, buildHash, files })
+  });
+  if (!response.ok) {
+    try {
+      await response.text();
+    } catch {
+    }
+    throw new Error(
+      `Source map manifest submission failed: ${String(response.status)} ${response.statusText}`
+    );
+  }
+  const json = await response.json();
+  return SourceMapManifestResponseSchema.parse(json);
+}
+async function uploadSourceMapsPresigned(apiKey, endpoint, buildHash, maps, blobUploader = uploadToBlob) {
+  if (maps.length === 0) {
+    throw new Error("No source maps to upload");
+  }
+  const presigned = await requestPresignedTokens(
+    apiKey,
+    endpoint,
+    buildHash,
+    maps.map((m) => ({
+      filePath: m.filePath,
+      sizeBytes: Buffer.byteLength(m.content, "utf-8")
+    }))
+  );
+  const mapsByPath = new Map(maps.map((m) => [m.filePath, m]));
+  if (mapsByPath.size !== maps.length) {
+    throw new Error("Duplicate filePath entries in source maps");
+  }
+  for (const token of presigned.files) {
+    if (!mapsByPath.has(token.filePath)) {
+      throw new Error(
+        `Presigned token for "${token.filePath}" has no matching source map entry`
+      );
+    }
+  }
+  const CONCURRENCY = 5;
+  const uploadResults = [];
+  for (let i = 0; i < presigned.files.length; i += CONCURRENCY) {
+    const chunk = presigned.files.slice(i, i + CONCURRENCY);
+    const chunkResults = await Promise.all(
+      chunk.map(async (token) => {
+        const entry = mapsByPath.get(token.filePath);
+        const result = await blobUploader(token.clientToken, token.pathname, entry.content);
+        return {
+          filePath: token.filePath,
+          sizeBytes: result.size,
+          blobUrl: result.url
+        };
+      })
+    );
+    uploadResults.push(...chunkResults);
+  }
+  return submitManifest(apiKey, endpoint, presigned.uploadId, buildHash, uploadResults);
+}
+async function uploadSourceMapsAuto(apiKey, endpoint, buildHash, maps, options) {
+  if (maps.length === 0) {
+    throw new Error("No source maps to upload");
+  }
+  const totalBytes = maps.reduce(
+    (sum, m) => sum + Buffer.byteLength(m.content, "utf-8"),
+    0
+  );
+  if (totalBytes < PRESIGNED_THRESHOLD_BYTES) {
+    return uploadSourceMaps(apiKey, endpoint, buildHash, maps);
+  }
+  const checkAvailable = options?.checkBlobAvailable ?? (async () => {
+    try {
+      await import("@vercel/blob/client");
+      return true;
+    } catch {
+      return false;
+    }
+  });
+  const blobAvailable = await checkAvailable();
+  if (blobAvailable) {
+    return uploadSourceMapsPresigned(
+      apiKey,
+      endpoint,
+      buildHash,
+      maps,
+      options?.blobUploader
+    );
+  }
+  sdkLog(
+    "warn",
+    `[glasstrace] Build exceeds 4.5MB (${totalBytes} bytes). Install @vercel/blob for presigned uploads to avoid serverless body size limits. Falling back to legacy upload.`
+  );
+  return uploadSourceMaps(apiKey, endpoint, buildHash, maps);
+}
 
 // src/config-wrapper.ts
 function withGlasstraceConfig(nextConfig) {
@@ -3823,6 +4003,7 @@ function captureError(error) {
 export {
   GlasstraceExporter,
   GlasstraceSpanProcessor,
+  PRESIGNED_THRESHOLD_BYTES,
   SdkError,
   SessionManager,
   buildImportGraph,
@@ -3850,6 +4031,8 @@ export {
   saveCachedConfig,
   sendInitRequest,
   uploadSourceMaps,
+  uploadSourceMapsAuto,
+  uploadSourceMapsPresigned,
   withGlasstraceConfig
 };
 //# sourceMappingURL=index.js.map