feat(node): Auto-detect ai module in CJS

Especially for next.js, this should work to avoid manual setup.

Author: mydea

packages/node/src/integrations/modules.ts

@@ -29,6 +29,7 @@ const _modulesIntegration = (() => {
 
       return event;
     },
+    getModules: _getModules,
   };
 }) satisfies IntegrationFn;
 
@@ -39,7 +40,7 @@ const _modulesIntegration = (() => {
  * - They are extracted from the dependencies & devDependencies in the package.json file
  * - They are extracted from the require.cache (CJS only)
  */
-export const modulesIntegration = defineIntegration(_modulesIntegration);
+export const modulesIntegration = _modulesIntegration;
 
 function getRequireCachePaths(): string[] {
   try {

packages/node/src/integrations/tracing/vercelai/index.ts

@@ -1,9 +1,10 @@
 /* eslint-disable @typescript-eslint/no-dynamic-delete */
 /* eslint-disable complexity */
-import type { IntegrationFn } from '@sentry/core';
+import type { Client, IntegrationFn } from '@sentry/core';
 import { defineIntegration, SEMANTIC_ATTRIBUTE_SENTRY_OP, spanToJSON } from '@sentry/core';
 import { generateInstrumentOnce } from '../../../otel/instrument';
 import { addOriginToSpan } from '../../../utils/addOriginToSpan';
+import type { modulesIntegration } from '../../modules';
 import {
   AI_MODEL_ID_ATTRIBUTE,
   AI_MODEL_PROVIDER_ATTRIBUTE,
@@ -23,6 +24,15 @@ import type { VercelAiOptions } from './types';
 
 export const instrumentVercelAi = generateInstrumentOnce(INTEGRATION_NAME, () => new SentryVercelAiInstrumentation({}));
 
+/**
+ * Determines if the integration should be forced based on environment and package availability.
+ * Returns true if the 'ai' package is available.
+ */
+function shouldForceIntegration(client: Client): boolean {
+  const modules = client.getIntegrationByName<ReturnType<typeof modulesIntegration>>('Modules');
+  return !!modules?.getModules?.()?.ai;
+}
+
 const _vercelAIIntegration = ((options: VercelAiOptions = {}) => {
   let instrumentation: undefined | SentryVercelAiInstrumentation;
 
@@ -190,7 +200,11 @@ const _vercelAIIntegration = ((options: VercelAiOptions = {}) => {
         });
       }
 
-      if (options.force) {
+      // Auto-detect if we should force the integration when running with 'ai' package available
+      // Note that this can only be detected if the 'Modules' integration is available, and running in CJS mode
+      const shouldForce = options.force ?? shouldForceIntegration(client);
+
+      if (shouldForce) {
         registerProcessors();
       } else {
         instrumentation?.callWhenPatched(registerProcessors);
@@ -213,6 +227,9 @@ const _vercelAIIntegration = ((options: VercelAiOptions = {}) => {
  * });
  * ```
  *
+ * The integration automatically detects when to force registration in CommonJS environments
+ * when the 'ai' package is available. You can still manually set the `force` option if needed.
+ *
  * By default this integration adds tracing support to all `ai` function calls. If you need to disable
  * collecting spans for a specific call, you can do so by setting `experimental_telemetry.isEnabled` to
  * `false` in the first argument of the function call.