@use-tusk/drift-node-sdk 0.1.34 → 0.1.36

package/dist/instrumentation-manifest.json

@@ -1,7 +1,7 @@
 {
-  "sdkVersion": "0.1.34",
+  "sdkVersion": "0.1.36",
   "language": "node",
-  "generatedAt": "2026-03-06T00:00:54.434Z",
+  "generatedAt": "2026-03-11T22:44:41.220Z",
   "instrumentations": [
     {
       "packageName": "@google-cloud/firestore",
@@ -96,9 +96,7 @@
     {
       "packageName": "mongodb",
       "supportedVersions": [
-        "5.*",
-        "6.*",
-        "7.*"
+        "*"
       ]
     },
     {

package/dist/next.cjs

@@ -0,0 +1,211 @@
+const require_chunk = require('./chunk-Cd-22Um9.cjs');
+let fs = require("fs");
+fs = require_chunk.__toESM(fs);
+let path = require("path");
+path = require_chunk.__toESM(path);
+let semver = require("semver");
+semver = require_chunk.__toESM(semver);
+
+//#region src/nextjs/utils.ts
+/**
+* Get the installed Next.js version by reading package.json from node_modules.
+*
+* @returns The Next.js version string, or undefined if not found
+*/
+function getNextjsVersion() {
+	try {
+		const nextPackageJsonPath = path.join(process.cwd(), "node_modules", "next", "package.json");
+		if (fs.existsSync(nextPackageJsonPath)) return JSON.parse(fs.readFileSync(nextPackageJsonPath, "utf-8")).version;
+	} catch (error) {}
+}
+/**
+* Parse a semantic version string into its components.
+*
+* @param version - The version string to parse (e.g., "15.0.0-canary.124")
+* @returns Parsed version object with major, minor, patch, and prerelease
+*/
+function parseVersion(version) {
+	try {
+		const parsed = (0, semver.parse)(version);
+		if (!parsed) return {
+			major: void 0,
+			minor: void 0,
+			patch: void 0,
+			prerelease: void 0
+		};
+		return {
+			major: parsed.major,
+			minor: parsed.minor,
+			patch: parsed.patch,
+			prerelease: parsed.prerelease.length > 0 ? parsed.prerelease.join(".") : void 0
+		};
+	} catch {
+		return {
+			major: void 0,
+			minor: void 0,
+			patch: void 0,
+			prerelease: void 0
+		};
+	}
+}
+/**
+* Check if the Next.js version requires the instrumentationHook to be set.
+* From Next.js 15.0.0-rc.1 onwards, the instrumentationHook is no longer needed
+* and Next.js will warn if it's set.
+*
+* @param version - The Next.js version string
+* @returns true if instrumentationHook should be set, false otherwise
+*/
+function shouldSetInstrumentationHook(version) {
+	if (!version) return true;
+	const { major, minor, patch, prerelease } = parseVersion(version);
+	if (major === void 0 || minor === void 0 || patch === void 0) return true;
+	if (major >= 16) return false;
+	if (major < 15) return true;
+	if (major === 15) {
+		if (minor > 0 || patch > 0) return false;
+		if (minor === 0 && patch === 0 && prerelease === void 0) return false;
+		if (prerelease?.startsWith("rc.")) {
+			if (parseInt(prerelease.split(".")[1] || "0", 10) >= 1) return false;
+		}
+		if (prerelease?.startsWith("canary.")) {
+			if (parseInt(prerelease.split(".")[1] || "0", 10) >= 124) return false;
+		}
+		return true;
+	}
+	return true;
+}
+/**
+* Log a message if debug mode is enabled.
+*
+* @param debug - Whether debug mode is enabled
+* @param message - The message to log
+*/
+function debugLog(debug, message) {
+	if (debug) console.log(`[Tusk Drift] ${message}`);
+}
+/**
+* Log a warning message if warnings are not suppressed.
+*
+* @param suppress - Whether to suppress the warning
+* @param message - The warning message to log
+*/
+function warn(suppress, message) {
+	if (!suppress) console.warn(`[Tusk Drift] ${message}`);
+}
+
+//#endregion
+//#region src/nextjs/withTuskDrift.ts
+/**
+* Wraps your Next.js configuration with Tusk Drift instrumentation setup.
+*
+* This function automatically configures Next.js to work with Tusk Drift by:
+* - Enabling the Next.js instrumentation hook (for Next.js < 15.0.0-rc.1)
+* - Configuring server external packages to prevent bundling of core instrumentation packages
+* - Supporting both webpack and Turbopack bundlers
+* - Preserving your existing Next.js configuration and webpack customizations
+*
+* @param nextConfig - Your existing Next.js configuration object (optional)
+* @param options - Additional options to configure Tusk Drift's behavior (optional)
+* @returns The wrapped Next.js configuration with Tusk Drift instrumentation enabled
+*
+* @example
+* Basic usage:
+* ```javascript
+* // next.config.js
+* const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+*
+* module.exports = withTuskDrift({
+*   // Your Next.js config
+* });
+* ```
+*
+* @example
+* With debug logging:
+* ```javascript
+* // next.config.js
+* const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+*
+* module.exports = withTuskDrift(
+*   {
+*     // Your Next.js config
+*   },
+*   {
+*     debug: true,
+*   }
+* );
+* ```
+*
+* @remarks
+* The following packages are added as server externals for both webpack and Turbopack:
+* - `require-in-the-middle` - Required for CommonJS module interception
+* - `jsonpath` - Required for schema manipulation
+* - Additional packages when TUSK_DRIFT_MODE is RECORD or REPLAY (e.g., database clients, etc.)
+*
+* Works with both webpack (default) and Turbopack (`next dev --turbo`).
+*/
+function withTuskDrift(nextConfig = {}, options = {}) {
+	const config = nextConfig;
+	const debug = options.debug || false;
+	const suppressAllWarnings = options.suppressWarnings || false;
+	const nextjsVersion = getNextjsVersion();
+	if (nextjsVersion) debugLog(debug, `Detected Next.js version: ${nextjsVersion}`);
+	else warn(suppressAllWarnings || false, "Could not detect Next.js version. Some features may not work correctly. If you encounter issues, please ensure Next.js is properly installed.");
+	const needsInstrumentationHook = !options.disableInstrumentationHook && shouldSetInstrumentationHook(nextjsVersion);
+	const mode = process.env.TUSK_DRIFT_MODE?.toUpperCase();
+	const coreExternals = [
+		"require-in-the-middle",
+		"jsonpath",
+		...mode === "RECORD" || mode === "REPLAY" ? [
+			"@upstash/redis",
+			"ioredis",
+			"pg",
+			"postgres",
+			"mysql2",
+			"@prisma/client",
+			"@google-cloud/firestore",
+			"@grpc/grpc-js",
+			"graphql",
+			"jsonwebtoken",
+			"jwks-rsa"
+		] : []
+	];
+	const wrappedConfig = {
+		...config,
+		...needsInstrumentationHook ? { experimental: {
+			...config.experimental,
+			instrumentationHook: true
+		} } : { experimental: config.experimental },
+		serverExternalPackages: [...config.serverExternalPackages || [], ...coreExternals],
+		webpack: (webpackConfig, webpackOptions) => {
+			if (webpackOptions.isServer) {
+				const originalExternals = webpackConfig.externals;
+				const externalsMapping = {};
+				for (const pkg of coreExternals) {
+					externalsMapping[pkg] = `commonjs ${pkg}`;
+					debugLog(debug, `Mapped external ${pkg} -> commonjs ${pkg}`);
+				}
+				if (!originalExternals) {
+					webpackConfig.externals = [externalsMapping];
+					debugLog(debug, "Created new externals with SDK paths");
+				} else if (Array.isArray(originalExternals)) {
+					originalExternals.push(externalsMapping);
+					debugLog(debug, "Added SDK paths to existing externals array");
+				} else {
+					webpackConfig.externals = [originalExternals, externalsMapping];
+					debugLog(debug, "Wrapped existing externals with SDK paths");
+				}
+			}
+			if (typeof config.webpack === "function") return config.webpack(webpackConfig, webpackOptions);
+			return webpackConfig;
+		}
+	};
+	if (needsInstrumentationHook) debugLog(debug, "Set experimental.instrumentationHook to true");
+	else debugLog(debug, "Skipped setting experimental.instrumentationHook (not needed for Next.js 15.0.0-rc.1+)");
+	if (options.disableInstrumentationHook && nextjsVersion && shouldSetInstrumentationHook(nextjsVersion)) warn(suppressAllWarnings || false, "You disabled instrumentationHook, but your Next.js version requires it. Tusk Drift may not initialize properly. Please remove the disableInstrumentationHook option.");
+	return wrappedConfig;
+}
+
+//#endregion
+exports.withTuskDrift = withTuskDrift;
+//# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.cjs","names":["wrappedConfig: NextConfig","externalsMapping: Record<string, string>"],"sources":["../src/nextjs/utils.ts","../src/nextjs/withTuskDrift.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport { parse as parseSemver } from \"semver\";\nimport type { ParsedVersion } from \"./types\";\n\n/**\n * Get the installed Next.js version by reading package.json from node_modules.\n *\n * @returns The Next.js version string, or undefined if not found\n */\nexport function getNextjsVersion(): string | undefined {\n  try {\n    // Try to read from node_modules/next/package.json\n    const nextPackageJsonPath = path.join(process.cwd(), \"node_modules\", \"next\", \"package.json\");\n\n    if (fs.existsSync(nextPackageJsonPath)) {\n      const packageJson = JSON.parse(fs.readFileSync(nextPackageJsonPath, \"utf-8\"));\n      return packageJson.version;\n    }\n  } catch (error) {\n    // Silent failure - we'll warn the user in the main function\n  }\n\n  return undefined;\n}\n\n/**\n * Parse a semantic version string into its components.\n *\n * @param version - The version string to parse (e.g., \"15.0.0-canary.124\")\n * @returns Parsed version object with major, minor, patch, and prerelease\n */\nexport function parseVersion(version: string): ParsedVersion {\n  try {\n    const parsed = parseSemver(version);\n\n    if (!parsed) {\n      return {\n        major: undefined,\n        minor: undefined,\n        patch: undefined,\n        prerelease: undefined,\n      };\n    }\n\n    return {\n      major: parsed.major,\n      minor: parsed.minor,\n      patch: parsed.patch,\n      prerelease: parsed.prerelease.length > 0 ? parsed.prerelease.join(\".\") : undefined,\n    };\n  } catch {\n    return {\n      major: undefined,\n      minor: undefined,\n      patch: undefined,\n      prerelease: undefined,\n    };\n  }\n}\n\n/**\n * Check if the Next.js version requires the instrumentationHook to be set.\n * From Next.js 15.0.0-rc.1 onwards, the instrumentationHook is no longer needed\n * and Next.js will warn if it's set.\n *\n * @param version - The Next.js version string\n * @returns true if instrumentationHook should be set, false otherwise\n */\nexport function shouldSetInstrumentationHook(version: string | undefined): boolean {\n  if (!version) {\n    // If we can't detect the version, err on the side of setting it\n    // (better to have a warning than broken instrumentation)\n    return true;\n  }\n\n  const { major, minor, patch, prerelease } = parseVersion(version);\n\n  // Unable to parse version\n  if (major === undefined || minor === undefined || patch === undefined) {\n    return true;\n  }\n\n  // Next.js 16+ definitely doesn't need it\n  if (major >= 16) {\n    return false;\n  }\n\n  // Next.js 14 and below need it\n  if (major < 15) {\n    return true;\n  }\n\n  // Next.js 15.x.x - check specific versions\n  if (major === 15) {\n    // 15.0.0 stable and higher don't need it\n    if (minor > 0 || patch > 0) {\n      return false;\n    }\n\n    // Check if it's 15.0.0 with no prerelease (stable)\n    if (minor === 0 && patch === 0 && prerelease === undefined) {\n      return false;\n    }\n\n    // Check for RC versions (rc.1 and higher don't need it)\n    if (prerelease?.startsWith(\"rc.\")) {\n      const rcNumber = parseInt(prerelease.split(\".\")[1] || \"0\", 10);\n      if (rcNumber >= 1) {\n        return false;\n      }\n    }\n\n    // Check for canary versions (canary.124 and higher don't need it)\n    if (prerelease?.startsWith(\"canary.\")) {\n      const canaryNumber = parseInt(prerelease.split(\".\")[1] || \"0\", 10);\n      if (canaryNumber >= 124) {\n        return false;\n      }\n    }\n\n    // All other 15.0.0 prereleases need it\n    return true;\n  }\n\n  // Default to true for safety\n  return true;\n}\n\n/**\n * Log a message if debug mode is enabled.\n *\n * @param debug - Whether debug mode is enabled\n * @param message - The message to log\n */\nexport function debugLog(debug: boolean, message: string): void {\n  if (debug) {\n    // eslint-disable-next-line no-console\n    console.log(`[Tusk Drift] ${message}`);\n  }\n}\n\n/**\n * Log a warning message if warnings are not suppressed.\n *\n * @param suppress - Whether to suppress the warning\n * @param message - The warning message to log\n */\nexport function warn(suppress: boolean, message: string): void {\n  if (!suppress) {\n    // eslint-disable-next-line no-console\n    console.warn(`[Tusk Drift] ${message}`);\n  }\n}\n","import type { NextConfig } from \"next\";\nimport type { TuskDriftNextOptions } from \"./types\";\nimport { getNextjsVersion, shouldSetInstrumentationHook, debugLog, warn } from \"./utils\";\n\n/**\n * Wraps your Next.js configuration with Tusk Drift instrumentation setup.\n *\n * This function automatically configures Next.js to work with Tusk Drift by:\n * - Enabling the Next.js instrumentation hook (for Next.js < 15.0.0-rc.1)\n * - Configuring server external packages to prevent bundling of core instrumentation packages\n * - Supporting both webpack and Turbopack bundlers\n * - Preserving your existing Next.js configuration and webpack customizations\n *\n * @param nextConfig - Your existing Next.js configuration object (optional)\n * @param options - Additional options to configure Tusk Drift's behavior (optional)\n * @returns The wrapped Next.js configuration with Tusk Drift instrumentation enabled\n *\n * @example\n * Basic usage:\n * ```javascript\n * // next.config.js\n * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');\n *\n * module.exports = withTuskDrift({\n *   // Your Next.js config\n * });\n * ```\n *\n * @example\n * With debug logging:\n * ```javascript\n * // next.config.js\n * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');\n *\n * module.exports = withTuskDrift(\n *   {\n *     // Your Next.js config\n *   },\n *   {\n *     debug: true,\n *   }\n * );\n * ```\n *\n * @remarks\n * The following packages are added as server externals for both webpack and Turbopack:\n * - `require-in-the-middle` - Required for CommonJS module interception\n * - `jsonpath` - Required for schema manipulation\n * - Additional packages when TUSK_DRIFT_MODE is RECORD or REPLAY (e.g., database clients, etc.)\n *\n * Works with both webpack (default) and Turbopack (`next dev --turbo`).\n */\nexport function withTuskDrift(\n  nextConfig: NextConfig = {},\n  options: TuskDriftNextOptions = {},\n): NextConfig {\n  const config = nextConfig;\n\n  const debug = options.debug || false;\n  const suppressAllWarnings = options.suppressWarnings || false;\n\n  // Detect Next.js version\n  const nextjsVersion = getNextjsVersion();\n\n  if (nextjsVersion) {\n    debugLog(debug, `Detected Next.js version: ${nextjsVersion}`);\n  } else {\n    warn(\n      suppressAllWarnings || false,\n      \"Could not detect Next.js version. Some features may not work correctly. \" +\n        \"If you encounter issues, please ensure Next.js is properly installed.\",\n    );\n  }\n\n  // Determine if we should set instrumentationHook\n  const needsInstrumentationHook =\n    !options.disableInstrumentationHook && shouldSetInstrumentationHook(nextjsVersion);\n\n  // Check if we're in RECORD or REPLAY mode\n  const mode = process.env.TUSK_DRIFT_MODE?.toUpperCase();\n  const isRecordOrReplay = mode === \"RECORD\" || mode === \"REPLAY\";\n\n  // Core packages that must be external for instrumentation\n  //\n  // Why these packages need to be external:\n  //\n  // 1. require-in-the-middle & jsonpath:\n  //    Required for the instrumentation infrastructure itself.\n  //\n  // 2. Others:\n  //    By default, Next.js bundlers (webpack/Turbopack) bundle packages into the server bundle at build time.\n  //    Once bundled, there's no runtime require() call for require-in-the-middle to intercept.\n  //    The instrumentation's patch callback never executes because module loading has already\n  //    happened during the build process, not at runtime.\n  //\n  //    By adding packages to serverExternalPackages (for both webpack and Turbopack) and webpack externals\n  //    (for webpack specifically), we tell the bundler to exclude these packages from bundling.\n  //    Instead, the bundler leaves these packages as runtime require() calls. When the Next.js server starts,\n  //    require-in-the-middle intercepts these runtime require() calls, triggers our instrumentation's\n  //    patch callback, and successfully returns the wrapped moduleExports with the instrumented class.\n  //\n  //    Next.js externalizes some packages by default, see: https://nextjs.org/docs/app/api-reference/config/next-config-js/serverExternalPackages\n  //    Others we need to add ourselves.\n  //\n  // Note: Other packages are only added when TUSK_DRIFT_MODE is RECORD or REPLAY\n  const coreExternals = [\n    \"require-in-the-middle\",\n    \"jsonpath\",\n    ...(isRecordOrReplay\n      ? [\n          \"@upstash/redis\",\n          \"ioredis\",\n          \"pg\",\n          \"postgres\",\n          \"mysql2\",\n          \"@prisma/client\",\n          \"@google-cloud/firestore\",\n          \"@grpc/grpc-js\",\n          \"graphql\",\n          \"jsonwebtoken\",\n          \"jwks-rsa\",\n        ]\n      : []),\n  ];\n\n  const wrappedConfig: NextConfig = {\n    ...config,\n    ...(needsInstrumentationHook\n      ? {\n          experimental: {\n            ...config.experimental,\n            instrumentationHook: true,\n          } as any, // Type assertion for experimental features\n        }\n      : {\n          experimental: config.experimental,\n        }),\n\n    // Add serverExternalPackages for Turbopack + Webpack support (Next.js 13.1+)\n    // This ensures packages remain external regardless of which bundler is used\n    serverExternalPackages: [...(config.serverExternalPackages || []), ...coreExternals],\n\n    webpack: (webpackConfig: any, webpackOptions: any) => {\n      if (webpackOptions.isServer) {\n        // Safely handle different externals formats (array, function, object, or undefined)\n        const originalExternals = webpackConfig.externals;\n\n        // Create externals mapping - since SDK's node_modules aren't published,\n        // we rely on these packages being available in the consumer's node_modules\n        const externalsMapping: Record<string, string> = {};\n        for (const pkg of coreExternals) {\n          externalsMapping[pkg] = `commonjs ${pkg}`;\n          debugLog(debug, `Mapped external ${pkg} -> commonjs ${pkg}`);\n        }\n\n        // Add our externals mapping\n        if (!originalExternals) {\n          webpackConfig.externals = [externalsMapping];\n          debugLog(debug, \"Created new externals with SDK paths\");\n        } else if (Array.isArray(originalExternals)) {\n          originalExternals.push(externalsMapping);\n          debugLog(debug, \"Added SDK paths to existing externals array\");\n        } else {\n          webpackConfig.externals = [originalExternals, externalsMapping];\n          debugLog(debug, \"Wrapped existing externals with SDK paths\");\n        }\n      }\n\n      // Call user's webpack function if they provided one\n      if (typeof config.webpack === \"function\") {\n        return config.webpack(webpackConfig, webpackOptions);\n      }\n\n      return webpackConfig;\n    },\n  };\n\n  if (needsInstrumentationHook) {\n    debugLog(debug, \"Set experimental.instrumentationHook to true\");\n  } else {\n    debugLog(\n      debug,\n      \"Skipped setting experimental.instrumentationHook (not needed for Next.js 15.0.0-rc.1+)\",\n    );\n  }\n\n  // Warn if user explicitly disabled instrumentationHook but we need it\n  if (\n    options.disableInstrumentationHook &&\n    nextjsVersion &&\n    shouldSetInstrumentationHook(nextjsVersion)\n  ) {\n    warn(\n      suppressAllWarnings || false,\n      \"You disabled instrumentationHook, but your Next.js version requires it. \" +\n        \"Tusk Drift may not initialize properly. Please remove the disableInstrumentationHook option.\",\n    );\n  }\n\n  return wrappedConfig;\n}\n"],"mappings":"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"}

package/dist/next.d.cts

@@ -0,0 +1,84 @@
+import { NextConfig } from "next";
+
+//#region src/nextjs/types.d.ts
+
+/**
+ * Options for configuring Tusk Drift's Next.js integration.
+ */
+interface TuskDriftNextOptions {
+  /**
+   * Enable debug logging for Tusk Drift's Next.js integration.
+   * When enabled, logs information about configuration changes and version detection.
+   *
+   * @default false
+   */
+  debug?: boolean;
+  /**
+   * Disable automatic setting of `experimental.instrumentationHook`.
+   * Use this if you want to manually control the instrumentation hook setting.
+   *
+   * @default false
+   */
+  disableInstrumentationHook?: boolean;
+  /**
+   * Suppress all warnings from Tusk Drift's Next.js integration.
+   * Not recommended unless you know what you're doing.
+   *
+   * @default false
+   */
+  suppressWarnings?: boolean;
+}
+//#endregion
+//#region src/nextjs/withTuskDrift.d.ts
+/**
+ * Wraps your Next.js configuration with Tusk Drift instrumentation setup.
+ *
+ * This function automatically configures Next.js to work with Tusk Drift by:
+ * - Enabling the Next.js instrumentation hook (for Next.js < 15.0.0-rc.1)
+ * - Configuring server external packages to prevent bundling of core instrumentation packages
+ * - Supporting both webpack and Turbopack bundlers
+ * - Preserving your existing Next.js configuration and webpack customizations
+ *
+ * @param nextConfig - Your existing Next.js configuration object (optional)
+ * @param options - Additional options to configure Tusk Drift's behavior (optional)
+ * @returns The wrapped Next.js configuration with Tusk Drift instrumentation enabled
+ *
+ * @example
+ * Basic usage:
+ * ```javascript
+ * // next.config.js
+ * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+ *
+ * module.exports = withTuskDrift({
+ *   // Your Next.js config
+ * });
+ * ```
+ *
+ * @example
+ * With debug logging:
+ * ```javascript
+ * // next.config.js
+ * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+ *
+ * module.exports = withTuskDrift(
+ *   {
+ *     // Your Next.js config
+ *   },
+ *   {
+ *     debug: true,
+ *   }
+ * );
+ * ```
+ *
+ * @remarks
+ * The following packages are added as server externals for both webpack and Turbopack:
+ * - `require-in-the-middle` - Required for CommonJS module interception
+ * - `jsonpath` - Required for schema manipulation
+ * - Additional packages when TUSK_DRIFT_MODE is RECORD or REPLAY (e.g., database clients, etc.)
+ *
+ * Works with both webpack (default) and Turbopack (`next dev --turbo`).
+ */
+declare function withTuskDrift(nextConfig?: NextConfig, options?: TuskDriftNextOptions): NextConfig;
+//#endregion
+export { type TuskDriftNextOptions, withTuskDrift };
+//# sourceMappingURL=next.d.cts.map

package/dist/next.d.ts

@@ -0,0 +1,84 @@
+import { NextConfig } from "next";
+
+//#region src/nextjs/types.d.ts
+
+/**
+ * Options for configuring Tusk Drift's Next.js integration.
+ */
+interface TuskDriftNextOptions {
+  /**
+   * Enable debug logging for Tusk Drift's Next.js integration.
+   * When enabled, logs information about configuration changes and version detection.
+   *
+   * @default false
+   */
+  debug?: boolean;
+  /**
+   * Disable automatic setting of `experimental.instrumentationHook`.
+   * Use this if you want to manually control the instrumentation hook setting.
+   *
+   * @default false
+   */
+  disableInstrumentationHook?: boolean;
+  /**
+   * Suppress all warnings from Tusk Drift's Next.js integration.
+   * Not recommended unless you know what you're doing.
+   *
+   * @default false
+   */
+  suppressWarnings?: boolean;
+}
+//#endregion
+//#region src/nextjs/withTuskDrift.d.ts
+/**
+ * Wraps your Next.js configuration with Tusk Drift instrumentation setup.
+ *
+ * This function automatically configures Next.js to work with Tusk Drift by:
+ * - Enabling the Next.js instrumentation hook (for Next.js < 15.0.0-rc.1)
+ * - Configuring server external packages to prevent bundling of core instrumentation packages
+ * - Supporting both webpack and Turbopack bundlers
+ * - Preserving your existing Next.js configuration and webpack customizations
+ *
+ * @param nextConfig - Your existing Next.js configuration object (optional)
+ * @param options - Additional options to configure Tusk Drift's behavior (optional)
+ * @returns The wrapped Next.js configuration with Tusk Drift instrumentation enabled
+ *
+ * @example
+ * Basic usage:
+ * ```javascript
+ * // next.config.js
+ * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+ *
+ * module.exports = withTuskDrift({
+ *   // Your Next.js config
+ * });
+ * ```
+ *
+ * @example
+ * With debug logging:
+ * ```javascript
+ * // next.config.js
+ * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+ *
+ * module.exports = withTuskDrift(
+ *   {
+ *     // Your Next.js config
+ *   },
+ *   {
+ *     debug: true,
+ *   }
+ * );
+ * ```
+ *
+ * @remarks
+ * The following packages are added as server externals for both webpack and Turbopack:
+ * - `require-in-the-middle` - Required for CommonJS module interception
+ * - `jsonpath` - Required for schema manipulation
+ * - Additional packages when TUSK_DRIFT_MODE is RECORD or REPLAY (e.g., database clients, etc.)
+ *
+ * Works with both webpack (default) and Turbopack (`next dev --turbo`).
+ */
+declare function withTuskDrift(nextConfig?: NextConfig, options?: TuskDriftNextOptions): NextConfig;
+//#endregion
+export { type TuskDriftNextOptions, withTuskDrift };
+//# sourceMappingURL=next.d.ts.map

package/dist/next.js

@@ -0,0 +1,207 @@
+import * as fs$1 from "fs";
+import * as path$1 from "path";
+import { parse } from "semver";
+
+//#region src/nextjs/utils.ts
+/**
+* Get the installed Next.js version by reading package.json from node_modules.
+*
+* @returns The Next.js version string, or undefined if not found
+*/
+function getNextjsVersion() {
+	try {
+		const nextPackageJsonPath = path$1.join(process.cwd(), "node_modules", "next", "package.json");
+		if (fs$1.existsSync(nextPackageJsonPath)) return JSON.parse(fs$1.readFileSync(nextPackageJsonPath, "utf-8")).version;
+	} catch (error) {}
+}
+/**
+* Parse a semantic version string into its components.
+*
+* @param version - The version string to parse (e.g., "15.0.0-canary.124")
+* @returns Parsed version object with major, minor, patch, and prerelease
+*/
+function parseVersion(version) {
+	try {
+		const parsed = parse(version);
+		if (!parsed) return {
+			major: void 0,
+			minor: void 0,
+			patch: void 0,
+			prerelease: void 0
+		};
+		return {
+			major: parsed.major,
+			minor: parsed.minor,
+			patch: parsed.patch,
+			prerelease: parsed.prerelease.length > 0 ? parsed.prerelease.join(".") : void 0
+		};
+	} catch {
+		return {
+			major: void 0,
+			minor: void 0,
+			patch: void 0,
+			prerelease: void 0
+		};
+	}
+}
+/**
+* Check if the Next.js version requires the instrumentationHook to be set.
+* From Next.js 15.0.0-rc.1 onwards, the instrumentationHook is no longer needed
+* and Next.js will warn if it's set.
+*
+* @param version - The Next.js version string
+* @returns true if instrumentationHook should be set, false otherwise
+*/
+function shouldSetInstrumentationHook(version) {
+	if (!version) return true;
+	const { major, minor, patch, prerelease } = parseVersion(version);
+	if (major === void 0 || minor === void 0 || patch === void 0) return true;
+	if (major >= 16) return false;
+	if (major < 15) return true;
+	if (major === 15) {
+		if (minor > 0 || patch > 0) return false;
+		if (minor === 0 && patch === 0 && prerelease === void 0) return false;
+		if (prerelease?.startsWith("rc.")) {
+			if (parseInt(prerelease.split(".")[1] || "0", 10) >= 1) return false;
+		}
+		if (prerelease?.startsWith("canary.")) {
+			if (parseInt(prerelease.split(".")[1] || "0", 10) >= 124) return false;
+		}
+		return true;
+	}
+	return true;
+}
+/**
+* Log a message if debug mode is enabled.
+*
+* @param debug - Whether debug mode is enabled
+* @param message - The message to log
+*/
+function debugLog(debug, message) {
+	if (debug) console.log(`[Tusk Drift] ${message}`);
+}
+/**
+* Log a warning message if warnings are not suppressed.
+*
+* @param suppress - Whether to suppress the warning
+* @param message - The warning message to log
+*/
+function warn(suppress, message) {
+	if (!suppress) console.warn(`[Tusk Drift] ${message}`);
+}
+
+//#endregion
+//#region src/nextjs/withTuskDrift.ts
+/**
+* Wraps your Next.js configuration with Tusk Drift instrumentation setup.
+*
+* This function automatically configures Next.js to work with Tusk Drift by:
+* - Enabling the Next.js instrumentation hook (for Next.js < 15.0.0-rc.1)
+* - Configuring server external packages to prevent bundling of core instrumentation packages
+* - Supporting both webpack and Turbopack bundlers
+* - Preserving your existing Next.js configuration and webpack customizations
+*
+* @param nextConfig - Your existing Next.js configuration object (optional)
+* @param options - Additional options to configure Tusk Drift's behavior (optional)
+* @returns The wrapped Next.js configuration with Tusk Drift instrumentation enabled
+*
+* @example
+* Basic usage:
+* ```javascript
+* // next.config.js
+* const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+*
+* module.exports = withTuskDrift({
+*   // Your Next.js config
+* });
+* ```
+*
+* @example
+* With debug logging:
+* ```javascript
+* // next.config.js
+* const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');
+*
+* module.exports = withTuskDrift(
+*   {
+*     // Your Next.js config
+*   },
+*   {
+*     debug: true,
+*   }
+* );
+* ```
+*
+* @remarks
+* The following packages are added as server externals for both webpack and Turbopack:
+* - `require-in-the-middle` - Required for CommonJS module interception
+* - `jsonpath` - Required for schema manipulation
+* - Additional packages when TUSK_DRIFT_MODE is RECORD or REPLAY (e.g., database clients, etc.)
+*
+* Works with both webpack (default) and Turbopack (`next dev --turbo`).
+*/
+function withTuskDrift(nextConfig = {}, options = {}) {
+	const config = nextConfig;
+	const debug = options.debug || false;
+	const suppressAllWarnings = options.suppressWarnings || false;
+	const nextjsVersion = getNextjsVersion();
+	if (nextjsVersion) debugLog(debug, `Detected Next.js version: ${nextjsVersion}`);
+	else warn(suppressAllWarnings || false, "Could not detect Next.js version. Some features may not work correctly. If you encounter issues, please ensure Next.js is properly installed.");
+	const needsInstrumentationHook = !options.disableInstrumentationHook && shouldSetInstrumentationHook(nextjsVersion);
+	const mode = process.env.TUSK_DRIFT_MODE?.toUpperCase();
+	const coreExternals = [
+		"require-in-the-middle",
+		"jsonpath",
+		...mode === "RECORD" || mode === "REPLAY" ? [
+			"@upstash/redis",
+			"ioredis",
+			"pg",
+			"postgres",
+			"mysql2",
+			"@prisma/client",
+			"@google-cloud/firestore",
+			"@grpc/grpc-js",
+			"graphql",
+			"jsonwebtoken",
+			"jwks-rsa"
+		] : []
+	];
+	const wrappedConfig = {
+		...config,
+		...needsInstrumentationHook ? { experimental: {
+			...config.experimental,
+			instrumentationHook: true
+		} } : { experimental: config.experimental },
+		serverExternalPackages: [...config.serverExternalPackages || [], ...coreExternals],
+		webpack: (webpackConfig, webpackOptions) => {
+			if (webpackOptions.isServer) {
+				const originalExternals = webpackConfig.externals;
+				const externalsMapping = {};
+				for (const pkg of coreExternals) {
+					externalsMapping[pkg] = `commonjs ${pkg}`;
+					debugLog(debug, `Mapped external ${pkg} -> commonjs ${pkg}`);
+				}
+				if (!originalExternals) {
+					webpackConfig.externals = [externalsMapping];
+					debugLog(debug, "Created new externals with SDK paths");
+				} else if (Array.isArray(originalExternals)) {
+					originalExternals.push(externalsMapping);
+					debugLog(debug, "Added SDK paths to existing externals array");
+				} else {
+					webpackConfig.externals = [originalExternals, externalsMapping];
+					debugLog(debug, "Wrapped existing externals with SDK paths");
+				}
+			}
+			if (typeof config.webpack === "function") return config.webpack(webpackConfig, webpackOptions);
+			return webpackConfig;
+		}
+	};
+	if (needsInstrumentationHook) debugLog(debug, "Set experimental.instrumentationHook to true");
+	else debugLog(debug, "Skipped setting experimental.instrumentationHook (not needed for Next.js 15.0.0-rc.1+)");
+	if (options.disableInstrumentationHook && nextjsVersion && shouldSetInstrumentationHook(nextjsVersion)) warn(suppressAllWarnings || false, "You disabled instrumentationHook, but your Next.js version requires it. Tusk Drift may not initialize properly. Please remove the disableInstrumentationHook option.");
+	return wrappedConfig;
+}
+
+//#endregion
+export { withTuskDrift };
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","names":["path","fs","parseSemver","wrappedConfig: NextConfig","externalsMapping: Record<string, string>"],"sources":["../src/nextjs/utils.ts","../src/nextjs/withTuskDrift.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport { parse as parseSemver } from \"semver\";\nimport type { ParsedVersion } from \"./types\";\n\n/**\n * Get the installed Next.js version by reading package.json from node_modules.\n *\n * @returns The Next.js version string, or undefined if not found\n */\nexport function getNextjsVersion(): string | undefined {\n  try {\n    // Try to read from node_modules/next/package.json\n    const nextPackageJsonPath = path.join(process.cwd(), \"node_modules\", \"next\", \"package.json\");\n\n    if (fs.existsSync(nextPackageJsonPath)) {\n      const packageJson = JSON.parse(fs.readFileSync(nextPackageJsonPath, \"utf-8\"));\n      return packageJson.version;\n    }\n  } catch (error) {\n    // Silent failure - we'll warn the user in the main function\n  }\n\n  return undefined;\n}\n\n/**\n * Parse a semantic version string into its components.\n *\n * @param version - The version string to parse (e.g., \"15.0.0-canary.124\")\n * @returns Parsed version object with major, minor, patch, and prerelease\n */\nexport function parseVersion(version: string): ParsedVersion {\n  try {\n    const parsed = parseSemver(version);\n\n    if (!parsed) {\n      return {\n        major: undefined,\n        minor: undefined,\n        patch: undefined,\n        prerelease: undefined,\n      };\n    }\n\n    return {\n      major: parsed.major,\n      minor: parsed.minor,\n      patch: parsed.patch,\n      prerelease: parsed.prerelease.length > 0 ? parsed.prerelease.join(\".\") : undefined,\n    };\n  } catch {\n    return {\n      major: undefined,\n      minor: undefined,\n      patch: undefined,\n      prerelease: undefined,\n    };\n  }\n}\n\n/**\n * Check if the Next.js version requires the instrumentationHook to be set.\n * From Next.js 15.0.0-rc.1 onwards, the instrumentationHook is no longer needed\n * and Next.js will warn if it's set.\n *\n * @param version - The Next.js version string\n * @returns true if instrumentationHook should be set, false otherwise\n */\nexport function shouldSetInstrumentationHook(version: string | undefined): boolean {\n  if (!version) {\n    // If we can't detect the version, err on the side of setting it\n    // (better to have a warning than broken instrumentation)\n    return true;\n  }\n\n  const { major, minor, patch, prerelease } = parseVersion(version);\n\n  // Unable to parse version\n  if (major === undefined || minor === undefined || patch === undefined) {\n    return true;\n  }\n\n  // Next.js 16+ definitely doesn't need it\n  if (major >= 16) {\n    return false;\n  }\n\n  // Next.js 14 and below need it\n  if (major < 15) {\n    return true;\n  }\n\n  // Next.js 15.x.x - check specific versions\n  if (major === 15) {\n    // 15.0.0 stable and higher don't need it\n    if (minor > 0 || patch > 0) {\n      return false;\n    }\n\n    // Check if it's 15.0.0 with no prerelease (stable)\n    if (minor === 0 && patch === 0 && prerelease === undefined) {\n      return false;\n    }\n\n    // Check for RC versions (rc.1 and higher don't need it)\n    if (prerelease?.startsWith(\"rc.\")) {\n      const rcNumber = parseInt(prerelease.split(\".\")[1] || \"0\", 10);\n      if (rcNumber >= 1) {\n        return false;\n      }\n    }\n\n    // Check for canary versions (canary.124 and higher don't need it)\n    if (prerelease?.startsWith(\"canary.\")) {\n      const canaryNumber = parseInt(prerelease.split(\".\")[1] || \"0\", 10);\n      if (canaryNumber >= 124) {\n        return false;\n      }\n    }\n\n    // All other 15.0.0 prereleases need it\n    return true;\n  }\n\n  // Default to true for safety\n  return true;\n}\n\n/**\n * Log a message if debug mode is enabled.\n *\n * @param debug - Whether debug mode is enabled\n * @param message - The message to log\n */\nexport function debugLog(debug: boolean, message: string): void {\n  if (debug) {\n    // eslint-disable-next-line no-console\n    console.log(`[Tusk Drift] ${message}`);\n  }\n}\n\n/**\n * Log a warning message if warnings are not suppressed.\n *\n * @param suppress - Whether to suppress the warning\n * @param message - The warning message to log\n */\nexport function warn(suppress: boolean, message: string): void {\n  if (!suppress) {\n    // eslint-disable-next-line no-console\n    console.warn(`[Tusk Drift] ${message}`);\n  }\n}\n","import type { NextConfig } from \"next\";\nimport type { TuskDriftNextOptions } from \"./types\";\nimport { getNextjsVersion, shouldSetInstrumentationHook, debugLog, warn } from \"./utils\";\n\n/**\n * Wraps your Next.js configuration with Tusk Drift instrumentation setup.\n *\n * This function automatically configures Next.js to work with Tusk Drift by:\n * - Enabling the Next.js instrumentation hook (for Next.js < 15.0.0-rc.1)\n * - Configuring server external packages to prevent bundling of core instrumentation packages\n * - Supporting both webpack and Turbopack bundlers\n * - Preserving your existing Next.js configuration and webpack customizations\n *\n * @param nextConfig - Your existing Next.js configuration object (optional)\n * @param options - Additional options to configure Tusk Drift's behavior (optional)\n * @returns The wrapped Next.js configuration with Tusk Drift instrumentation enabled\n *\n * @example\n * Basic usage:\n * ```javascript\n * // next.config.js\n * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');\n *\n * module.exports = withTuskDrift({\n *   // Your Next.js config\n * });\n * ```\n *\n * @example\n * With debug logging:\n * ```javascript\n * // next.config.js\n * const { withTuskDrift } = require('@use-tusk/drift-node-sdk/next');\n *\n * module.exports = withTuskDrift(\n *   {\n *     // Your Next.js config\n *   },\n *   {\n *     debug: true,\n *   }\n * );\n * ```\n *\n * @remarks\n * The following packages are added as server externals for both webpack and Turbopack:\n * - `require-in-the-middle` - Required for CommonJS module interception\n * - `jsonpath` - Required for schema manipulation\n * - Additional packages when TUSK_DRIFT_MODE is RECORD or REPLAY (e.g., database clients, etc.)\n *\n * Works with both webpack (default) and Turbopack (`next dev --turbo`).\n */\nexport function withTuskDrift(\n  nextConfig: NextConfig = {},\n  options: TuskDriftNextOptions = {},\n): NextConfig {\n  const config = nextConfig;\n\n  const debug = options.debug || false;\n  const suppressAllWarnings = options.suppressWarnings || false;\n\n  // Detect Next.js version\n  const nextjsVersion = getNextjsVersion();\n\n  if (nextjsVersion) {\n    debugLog(debug, `Detected Next.js version: ${nextjsVersion}`);\n  } else {\n    warn(\n      suppressAllWarnings || false,\n      \"Could not detect Next.js version. Some features may not work correctly. \" +\n        \"If you encounter issues, please ensure Next.js is properly installed.\",\n    );\n  }\n\n  // Determine if we should set instrumentationHook\n  const needsInstrumentationHook =\n    !options.disableInstrumentationHook && shouldSetInstrumentationHook(nextjsVersion);\n\n  // Check if we're in RECORD or REPLAY mode\n  const mode = process.env.TUSK_DRIFT_MODE?.toUpperCase();\n  const isRecordOrReplay = mode === \"RECORD\" || mode === \"REPLAY\";\n\n  // Core packages that must be external for instrumentation\n  //\n  // Why these packages need to be external:\n  //\n  // 1. require-in-the-middle & jsonpath:\n  //    Required for the instrumentation infrastructure itself.\n  //\n  // 2. Others:\n  //    By default, Next.js bundlers (webpack/Turbopack) bundle packages into the server bundle at build time.\n  //    Once bundled, there's no runtime require() call for require-in-the-middle to intercept.\n  //    The instrumentation's patch callback never executes because module loading has already\n  //    happened during the build process, not at runtime.\n  //\n  //    By adding packages to serverExternalPackages (for both webpack and Turbopack) and webpack externals\n  //    (for webpack specifically), we tell the bundler to exclude these packages from bundling.\n  //    Instead, the bundler leaves these packages as runtime require() calls. When the Next.js server starts,\n  //    require-in-the-middle intercepts these runtime require() calls, triggers our instrumentation's\n  //    patch callback, and successfully returns the wrapped moduleExports with the instrumented class.\n  //\n  //    Next.js externalizes some packages by default, see: https://nextjs.org/docs/app/api-reference/config/next-config-js/serverExternalPackages\n  //    Others we need to add ourselves.\n  //\n  // Note: Other packages are only added when TUSK_DRIFT_MODE is RECORD or REPLAY\n  const coreExternals = [\n    \"require-in-the-middle\",\n    \"jsonpath\",\n    ...(isRecordOrReplay\n      ? [\n          \"@upstash/redis\",\n          \"ioredis\",\n          \"pg\",\n          \"postgres\",\n          \"mysql2\",\n          \"@prisma/client\",\n          \"@google-cloud/firestore\",\n          \"@grpc/grpc-js\",\n          \"graphql\",\n          \"jsonwebtoken\",\n          \"jwks-rsa\",\n        ]\n      : []),\n  ];\n\n  const wrappedConfig: NextConfig = {\n    ...config,\n    ...(needsInstrumentationHook\n      ? {\n          experimental: {\n            ...config.experimental,\n            instrumentationHook: true,\n          } as any, // Type assertion for experimental features\n        }\n      : {\n          experimental: config.experimental,\n        }),\n\n    // Add serverExternalPackages for Turbopack + Webpack support (Next.js 13.1+)\n    // This ensures packages remain external regardless of which bundler is used\n    serverExternalPackages: [...(config.serverExternalPackages || []), ...coreExternals],\n\n    webpack: (webpackConfig: any, webpackOptions: any) => {\n      if (webpackOptions.isServer) {\n        // Safely handle different externals formats (array, function, object, or undefined)\n        const originalExternals = webpackConfig.externals;\n\n        // Create externals mapping - since SDK's node_modules aren't published,\n        // we rely on these packages being available in the consumer's node_modules\n        const externalsMapping: Record<string, string> = {};\n        for (const pkg of coreExternals) {\n          externalsMapping[pkg] = `commonjs ${pkg}`;\n          debugLog(debug, `Mapped external ${pkg} -> commonjs ${pkg}`);\n        }\n\n        // Add our externals mapping\n        if (!originalExternals) {\n          webpackConfig.externals = [externalsMapping];\n          debugLog(debug, \"Created new externals with SDK paths\");\n        } else if (Array.isArray(originalExternals)) {\n          originalExternals.push(externalsMapping);\n          debugLog(debug, \"Added SDK paths to existing externals array\");\n        } else {\n          webpackConfig.externals = [originalExternals, externalsMapping];\n          debugLog(debug, \"Wrapped existing externals with SDK paths\");\n        }\n      }\n\n      // Call user's webpack function if they provided one\n      if (typeof config.webpack === \"function\") {\n        return config.webpack(webpackConfig, webpackOptions);\n      }\n\n      return webpackConfig;\n    },\n  };\n\n  if (needsInstrumentationHook) {\n    debugLog(debug, \"Set experimental.instrumentationHook to true\");\n  } else {\n    debugLog(\n      debug,\n      \"Skipped setting experimental.instrumentationHook (not needed for Next.js 15.0.0-rc.1+)\",\n    );\n  }\n\n  // Warn if user explicitly disabled instrumentationHook but we need it\n  if (\n    options.disableInstrumentationHook &&\n    nextjsVersion &&\n    shouldSetInstrumentationHook(nextjsVersion)\n  ) {\n    warn(\n      suppressAllWarnings || false,\n      \"You disabled instrumentationHook, but your Next.js version requires it. \" +\n        \"Tusk Drift may not initialize properly. Please remove the disableInstrumentationHook option.\",\n    );\n  }\n\n  return wrappedConfig;\n}\n"],"mappings":"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"}