@glasstrace/sdk 0.4.1 → 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
@@ -354,9 +382,13 @@ declare class GlasstraceExporter implements SpanExporter {
      * Enriches a ReadableSpan with all glasstrace.* attributes.
      * Returns a new ReadableSpan wrapper; the original span is not mutated.
      *
-     * External function calls (getSessionId, deriveErrorCategory,
-     * deriveOrmProvider, classifyFetchTarget) are individually guarded so a
-     * failure in one does not prevent the remaining attributes from being set.
+     * Only {@link SessionManager.getSessionId} is individually guarded because
+     * it calls into crypto and schema validation — a session ID failure should
+     * not prevent the rest of enrichment. The other helper calls
+     * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
+     * {@link classifyFetchTarget}) are pure functions on typed string inputs
+     * and rely on the outer catch for any unexpected failure.
+     *
      * On total failure, returns the original span unchanged.
      */
     private enrichSpan;
@@ -453,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.
@@ -515,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
@@ -354,9 +382,13 @@ declare class GlasstraceExporter implements SpanExporter {
      * Enriches a ReadableSpan with all glasstrace.* attributes.
      * Returns a new ReadableSpan wrapper; the original span is not mutated.
      *
-     * External function calls (getSessionId, deriveErrorCategory,
-     * deriveOrmProvider, classifyFetchTarget) are individually guarded so a
-     * failure in one does not prevent the remaining attributes from being set.
+     * Only {@link SessionManager.getSessionId} is individually guarded because
+     * it calls into crypto and schema validation — a session ID failure should
+     * not prevent the rest of enrichment. The other helper calls
+     * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
+     * {@link classifyFetchTarget}) are pure functions on typed string inputs
+     * and rely on the outer catch for any unexpected failure.
+     *
      * On total failure, returns the original span unchanged.
      */
     private enrichSpan;
@@ -453,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.
@@ -515,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-LAMTBURS.js";
+} from "./chunk-SALPGSWK.js";
 import {
   DEFAULT_CAPTURE_CONFIG,
   GLASSTRACE_ATTRIBUTE_NAMES,
+  PresignedUploadResponseSchema,
   SdkCachedConfigSchema,
   SdkInitResponseSchema,
   SessionIdSchema,
+  SourceMapManifestResponseSchema,
   SourceMapUploadResponseSchema,
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-EC5IINUT.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) {
@@ -452,9 +470,13 @@ var GlasstraceExporter = class {
    * Enriches a ReadableSpan with all glasstrace.* attributes.
    * Returns a new ReadableSpan wrapper; the original span is not mutated.
    *
-   * External function calls (getSessionId, deriveErrorCategory,
-   * deriveOrmProvider, classifyFetchTarget) are individually guarded so a
-   * failure in one does not prevent the remaining attributes from being set.
+   * Only {@link SessionManager.getSessionId} is individually guarded because
+   * it calls into crypto and schema validation — a session ID failure should
+   * not prevent the rest of enrichment. The other helper calls
+   * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
+   * {@link classifyFetchTarget}) are pure functions on typed string inputs
+   * and rely on the outer catch for any unexpected failure.
+   *
    * On total failure, returns the original span unchanged.
    */
   enrichSpan(span) {
@@ -497,44 +519,39 @@ var GlasstraceExporter = class {
         }
       }
       const errorMessage = attrs["exception.message"];
-      if (errorMessage) {
+      if (typeof errorMessage === "string") {
         extra[ATTR.ERROR_MESSAGE] = errorMessage;
       }
-      try {
-        const errorType = attrs["exception.type"];
-        if (errorType) {
-          extra[ATTR.ERROR_CODE] = errorType;
-          extra[ATTR.ERROR_CATEGORY] = deriveErrorCategory(errorType);
-        }
-      } catch {
+      const errorType = attrs["exception.type"];
+      if (typeof errorType === "string") {
+        extra[ATTR.ERROR_CODE] = errorType;
+        extra[ATTR.ERROR_CATEGORY] = deriveErrorCategory(errorType);
       }
       const errorField = attrs["error.field"];
-      if (errorField) {
+      if (typeof errorField === "string") {
         extra[ATTR.ERROR_FIELD] = errorField;
       }
-      try {
-        const spanAny = span;
-        const instrumentationName = spanAny.instrumentationScope?.name ?? spanAny.instrumentationLibrary?.name ?? "";
-        const ormProvider = deriveOrmProvider(instrumentationName);
-        if (ormProvider) {
-          extra[ATTR.ORM_PROVIDER] = ormProvider;
-          const model = attrs["db.sql.table"] ?? attrs["db.prisma.model"];
-          if (model) {
-            extra[ATTR.ORM_MODEL] = model;
-          }
-          const operation = attrs["db.operation"];
-          if (operation) {
-            extra[ATTR.ORM_OPERATION] = operation;
-          }
+      const spanAny = span;
+      const instrumentationName = spanAny.instrumentationScope?.name ?? spanAny.instrumentationLibrary?.name ?? "";
+      const ormProvider = deriveOrmProvider(instrumentationName);
+      if (ormProvider) {
+        extra[ATTR.ORM_PROVIDER] = ormProvider;
+        const table = attrs["db.sql.table"];
+        const prismaModel = attrs["db.prisma.model"];
+        const model = typeof table === "string" ? table : typeof prismaModel === "string" ? prismaModel : void 0;
+        if (model) {
+          extra[ATTR.ORM_MODEL] = model;
         }
-      } catch {
-      }
-      try {
-        const url = attrs["http.url"] ?? attrs["url.full"];
-        if (url && span.kind === SpanKind.CLIENT) {
-          extra[ATTR.FETCH_TARGET] = classifyFetchTarget(url);
+        const operation = attrs["db.operation"];
+        if (typeof operation === "string") {
+          extra[ATTR.ORM_OPERATION] = operation;
         }
-      } catch {
+      }
+      const httpUrl = attrs["http.url"];
+      const fullUrl = attrs["url.full"];
+      const url = typeof httpUrl === "string" ? httpUrl : typeof fullUrl === "string" ? fullUrl : void 0;
+      if (url && span.kind === SpanKind.CLIENT) {
+        extra[ATTR.FETCH_TARGET] = classifyFetchTarget(url);
       }
       return createEnrichedSpan(span, extra);
     } catch {
@@ -3453,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;
@@ -3542,7 +3567,11 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.4.1");
+            const initResult = await performInit(config, anonKey, "0.7.0");
+            if (initResult?.claimResult) {
+              setResolvedApiKey(initResult.claimResult.newApiKey);
+              notifyApiKeyResolved();
+            }
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3562,7 +3591,11 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.4.1");
+            const initResult = await performInit(config, anonKey, "0.7.0");
+            if (initResult?.claimResult) {
+              setResolvedApiKey(initResult.claimResult.newApiKey);
+              notifyApiKeyResolved();
+            }
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3584,7 +3617,7 @@ function registerGlasstrace(options) {
           if (config.verbose) {
             console.info("[glasstrace] Background init firing.");
           }
-          await performInit(config, anonKeyForInit, "0.4.1");
+          await performInit(config, anonKeyForInit, "0.7.0");
           maybeInstallConsoleCapture();
         } catch (err) {
           console.warn(
@@ -3683,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: {
@@ -3707,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) {
@@ -3824,6 +4003,7 @@ function captureError(error) {
 export {
   GlasstraceExporter,
   GlasstraceSpanProcessor,
+  PRESIGNED_THRESHOLD_BYTES,
   SdkError,
   SessionManager,
   buildImportGraph,
@@ -3851,6 +4031,8 @@ export {
   saveCachedConfig,
   sendInitRequest,
   uploadSourceMaps,
+  uploadSourceMapsAuto,
+  uploadSourceMapsPresigned,
   withGlasstraceConfig
 };
 //# sourceMappingURL=index.js.map