@glasstrace/sdk 1.15.0 → 1.15.1

package/README.md

@@ -363,6 +363,49 @@ A future SDK release may extend the auto-attach detection to recognize
 additional Next 16 provider shapes; until that ships, the manual path
 above is the production-supported integration.
 
+## Database query spans (Prisma)
+
+When Glasstrace manages the OpenTelemetry provider — the default when
+your app does not already run its own OpenTelemetry or Sentry setup — it
+automatically instruments [Prisma](https://www.prisma.io/) queries.
+Install
+[`@prisma/instrumentation`](https://www.npmjs.com/package/@prisma/instrumentation)
+(an optional peer dependency, Prisma 4–7) and query spans appear once the
+package is reachable; no extra wiring is required.
+
+If Glasstrace instead detects a provider you already registered (Sentry,
+a custom OpenTelemetry SDK, and similar), it attaches its exporter to
+that provider rather than taking over instrumentation — so it does not
+add Prisma instrumentation itself, and the diagnostic below does not
+apply. Register `@prisma/instrumentation` on your own provider;
+Glasstrace exports the spans it produces.
+
+Prisma ORM versions **4.2.0 through 6.1.0** additionally require enabling
+the `tracing`
+[preview feature](https://www.prisma.io/docs/orm/prisma-client/observability-and-logging/opentelemetry-tracing)
+in your schema's `generator` block — `previewFeatures = ["tracing"]` —
+before any tracing spans are emitted. Later Prisma versions need no flag.
+
+**Missing Prisma query spans?** On Prisma 4.2.0–6.1.0, first confirm the
+`tracing` preview feature above is enabled. Otherwise, the usual cause is
+a package manager that does not expose transitive copies of optional
+peers. Under pnpm's
+strict, isolated `node_modules`, `@prisma/instrumentation` can sit in
+the virtual store (pulled in by another dependency) without being
+linked into your app's `node_modules/@prisma/` — so the SDK's optional
+import resolves to nothing and Prisma spans are silently skipped. Add it
+as a **direct dependency** of your app:
+
+```bash
+npm install @prisma/instrumentation
+# pnpm add @prisma/instrumentation
+```
+
+To confirm whether it was loaded, enable verbose mode
+(`registerGlasstrace({ verbose: true })`): when
+`@prisma/instrumentation` cannot be loaded, the SDK logs a diagnostic
+noting that Prisma query spans will not be captured.
+
 ## Capturing error response bodies
 
 When debugging a 4xx or 5xx, the response body is often the most useful

package/dist/{chunk-PSMSSLQY.js → chunk-T4ETJJSK.js}

@@ -3892,6 +3892,13 @@ async function tryImport(moduleId) {
     return null;
   }
 }
+function warnPrismaInstrumentationUnavailable(verbose, detail) {
+  if (!verbose) return;
+  sdkLog(
+    "warn",
+    `[glasstrace] @prisma/instrumentation ${detail}; Prisma query spans will not be captured. If you use Prisma and expect database spans, add @prisma/instrumentation as a direct dependency (some package managers, e.g. pnpm, do not expose transitive copies).`
+  );
+}
 async function configureOtel(config, sessionManager) {
   setOtelState(OtelState.CONFIGURING);
   await new Promise((resolve2) => {
@@ -3999,7 +4006,14 @@ async function runRegistrationPath(config, sessionManager) {
       const PrismaInstrumentation = prismaModule2.PrismaInstrumentation;
       if (PrismaInstrumentation) {
         otelConfig.instrumentations = [new PrismaInstrumentation()];
+      } else {
+        warnPrismaInstrumentationUnavailable(
+          config.verbose,
+          "was loaded but did not export PrismaInstrumentation"
+        );
       }
+    } else {
+      warnPrismaInstrumentationUnavailable(config.verbose, "could not be loaded");
     }
     vercelOtel.registerOTel(otelConfig);
     const vercelProxy = trace.getTracerProvider();
@@ -4054,9 +4068,22 @@ async function runRegistrationPath(config, sessionManager) {
         const inst = new PrismaInstrumentation();
         inst.setTracerProvider(provider);
         inst.enable();
-      } catch {
+      } catch (err) {
+        if (config.verbose) {
+          sdkLog(
+            "warn",
+            `[glasstrace] @prisma/instrumentation failed to initialize: ${err instanceof Error ? err.message : String(err)}. Prisma query spans will not be captured.`
+          );
+        }
       }
+    } else {
+      warnPrismaInstrumentationUnavailable(
+        config.verbose,
+        "was loaded but did not export PrismaInstrumentation"
+      );
     }
+  } else {
+    warnPrismaInstrumentationUnavailable(config.verbose, "could not be loaded");
   }
   setOtelState(OtelState.OWNS_PROVIDER);
   emitLifecycleEvent("otel:configured", { state: OtelState.OWNS_PROVIDER, scenario: "A" });
@@ -4969,11 +4996,11 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     maybeWarnStaleAgentInstructions({
       projectRoot: process.cwd(),
-      sdkVersion: "1.15.0"
+      sdkVersion: "1.15.1"
     });
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.15.0"
+      sdkVersion: "1.15.1"
     });
     const config = resolveConfig(options);
     setSideEffectVerboseFlag(config.verbose);
@@ -5141,8 +5168,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("1.15.0");
-  const initResult = await performInit(config, anonKeyForInit, "1.15.0", healthReport);
+  const healthReport = collectHealthReport("1.15.1");
+  const initResult = await performInit(config, anonKeyForInit, "1.15.1", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -5165,7 +5192,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config, anonKeyForInit, "1.15.0", generation, (newApiKey, accountId) => {
+    startHeartbeat(config, anonKeyForInit, "1.15.1", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);
@@ -5563,4 +5590,4 @@ export {
   withGlasstraceConfig,
   captureError
 };
-//# sourceMappingURL=chunk-PSMSSLQY.js.map
+//# sourceMappingURL=chunk-T4ETJJSK.js.map