@posthog/wizard 1.21.1 → 1.23.0

package/dist/src/nextjs/event-setup.js

@@ -1,390 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runEventSetupWizard = runEventSetupWizard;
-const clack_utils_1 = require("../utils/clack-utils");
-const clack_1 = __importDefault(require("../utils/clack"));
-const fs = __importStar(require("fs/promises"));
-const path = __importStar(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const query_1 = require("../utils/query");
-const zod_1 = require("zod");
-const file_utils_1 = require("../utils/file-utils");
-const package_json_1 = require("../utils/package-json");
-const semver = __importStar(require("semver"));
-const debug_1 = require("../utils/debug");
-const analytics_1 = require("../utils/analytics");
-// Analytics constants
-const WIZARD_INTERACTION = 'wizard interaction';
-const INTEGRATION_NAME = 'event-setup';
-// Schema for file selection from AI
-const FileSelectionSchema = zod_1.z.object({
-    files: zod_1.z.array(zod_1.z.string()).max(10),
-});
-// Schema for enhanced file with events
-const EnhancedFileSchema = zod_1.z.object({
-    filePath: zod_1.z.string(),
-    content: zod_1.z.string(),
-    events: zod_1.z.array(zod_1.z.object({
-        name: zod_1.z.string(),
-        description: zod_1.z.string(),
-    })),
-});
-async function runEventSetupWizard(options) {
-    if (options.debug) {
-        (0, debug_1.enableDebugLogs)();
-    }
-    clack_1.default.intro(`Let's do a first pass on PostHog event tracking for your project.
-    
-    We'll start by analyzing your project structure, then choose up to ten files to enhance. Use git to discard any events you're not happy with.
-
-    This will give you a starting point, then you can add any events that we missed.
-    `);
-    // Check for uncommitted changes
-    if ((0, clack_utils_1.isInGitRepo)()) {
-        const uncommittedOrUntrackedFiles = (0, clack_utils_1.getUncommittedOrUntrackedFiles)();
-        if (uncommittedOrUntrackedFiles.length) {
-            clack_1.default.log.warn(`You have uncommitted or untracked files in your repo:
-
-${uncommittedOrUntrackedFiles.join('\n')}
-
-The event setup wizard will modify multiple files. For the best experience, commit or stash your changes first.`);
-            const continueWithDirtyRepo = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.confirm({
-                message: 'Do you want to continue anyway?',
-            }));
-            if (!continueWithDirtyRepo) {
-                analytics_1.analytics.capture(WIZARD_INTERACTION, {
-                    action: 'aborted due to uncommitted changes',
-                    integration: INTEGRATION_NAME,
-                });
-                return (0, clack_utils_1.abort)('Please commit your changes and try again.', 0);
-            }
-            analytics_1.analytics.capture(WIZARD_INTERACTION, {
-                action: 'continued with uncommitted changes',
-                integration: INTEGRATION_NAME,
-            });
-        }
-    }
-    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_1.askForCloudRegion)());
-    const { accessToken, projectId } = await (0, clack_utils_1.getOrAskForProjectData)({
-        ...options,
-        cloudRegion,
-    });
-    // Check if this is a Next.js 15.3+ project with instrumentation-client
-    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-    const isNextJs = (0, package_json_1.hasPackageInstalled)('next', packageJson);
-    if (!isNextJs) {
-        return (0, clack_utils_1.abort)('This feature is only available for Next.js projects.');
-    }
-    const nextVersion = (0, package_json_1.getPackageVersion)('next', packageJson);
-    const isNext15_3Plus = nextVersion && semver.gte(nextVersion, '15.3.0');
-    analytics_1.analytics.setTag('nextjs-version', nextVersion);
-    if (!isNext15_3Plus) {
-        analytics_1.analytics.capture(WIZARD_INTERACTION, {
-            action: 'aborted due to nextjs version',
-            integration: INTEGRATION_NAME,
-            nextjsVersion: nextVersion,
-        });
-        return (0, clack_utils_1.abort)('This feature requires Next.js 15.3.0 or higher.');
-    }
-    // Check for instrumentation-client file
-    const allFiles = await (0, file_utils_1.getAllFilesInProject)(options.installDir);
-    const instrumentationFiles = allFiles.filter((f) => f.includes('instrumentation') &&
-        (f.endsWith('.ts') || f.endsWith('.js')) &&
-        (f.includes('client') || f.includes('Client')));
-    if (instrumentationFiles.length === 0) {
-        analytics_1.analytics.capture(WIZARD_INTERACTION, {
-            action: 'aborted due to missing instrumentation-client',
-            integration: INTEGRATION_NAME,
-        });
-        return (0, clack_utils_1.abort)('No instrumentation-client file found. Please set up Next.js instrumentation-client first. Try using this wizard to do it!');
-    }
-    analytics_1.analytics.capture(WIZARD_INTERACTION, {
-        action: 'started event setup',
-        integration: INTEGRATION_NAME,
-        instrumentationFilesCount: instrumentationFiles.length,
-    });
-    // Get the project file tree
-    const s = clack_1.default.spinner();
-    s.start('Analyzing your project structure');
-    const projectFiles = await (0, file_utils_1.getAllFilesInProject)(options.installDir);
-    const relativeFiles = projectFiles
-        .map((f) => path.relative(options.installDir, f))
-        .filter((f) => {
-        // Exclude instrumentation files and next.config
-        const isInstrumentation = f.includes('instrumentation') &&
-            (f.endsWith('.ts') || f.endsWith('.js'));
-        const isNextConfig = f.startsWith('next.config.') || f === 'next.config';
-        return !isInstrumentation && !isNextConfig;
-    });
-    (0, debug_1.debug)('Total files found:', projectFiles.length);
-    (0, debug_1.debug)('Files after filtering:', relativeFiles.length);
-    s.stop('Project structure analyzed');
-    analytics_1.analytics.capture(WIZARD_INTERACTION, {
-        action: 'analyzed project structure',
-        integration: INTEGRATION_NAME,
-        totalFiles: projectFiles.length,
-        eligibleFiles: relativeFiles.length,
-    });
-    // Send file tree to AI to get 10 most useful files
-    s.start('Selecting some files to enhance with events...');
-    const fileSelectionPrompt = `Given this Next.js 15.3+ project structure and package.json, select up to 10 CLIENT-SIDE FILES for adding PostHog analytics events.
-  
-  IMPORTANT: Only select files that:
-  - Have "use client" directive at the top, OR
-  - Use React hooks (useState, useEffect, etc.), OR  
-  - Have event handlers (onClick, onSubmit, onChange)
-  
-  DO NOT select:
-  - API routes (files in /api/ or route.ts/route.js files)
-  - Server Components (files without "use client" and no hooks/handlers)
-  - Layout files (layout.tsx/layout.js)
-  - Configuration files
-  - Pure utility files
-  
-  Focus on:
-  - User interaction points (buttons, forms, navigation)
-  - Key user flows (auth, checkout, main features)
-  - Business-critical paths
-  - Files that represent important user actions
-  
-  Package.json:
-  ${JSON.stringify(packageJson, null, 2)}
-  
-  Project files:
-  ${relativeFiles.join('\n')}
-  
-  Return file paths for client-side files ONLY that would benefit most from analytics tracking. If there are fewer than 10 suitable client files, return only those.`;
-    let selectedFiles = [];
-    try {
-        const response = await (0, query_1.query)({
-            message: fileSelectionPrompt,
-            model: 'gemini-2.5-flash',
-            region: cloudRegion,
-            schema: FileSelectionSchema,
-            accessToken,
-            projectId,
-        });
-        selectedFiles = response.files;
-        s.stop(`Selected ${selectedFiles.length} files for event tracking`);
-        analytics_1.analytics.capture(WIZARD_INTERACTION, {
-            action: 'selected files for tracking',
-            integration: INTEGRATION_NAME,
-            filesSelected: selectedFiles.length,
-        });
-    }
-    catch (error) {
-        s.stop('Failed to select files');
-        analytics_1.analytics.capture(WIZARD_INTERACTION, {
-            action: 'file selection failed',
-            integration: INTEGRATION_NAME,
-            error: error instanceof Error ? error.message : 'Unknown error',
-        });
-        return (0, clack_utils_1.abort)('Could not analyze project structure. Please try again.');
-    }
-    // Read the selected files and enhance them with events
-    clack_1.default.log.info('Files selected for event tracking:');
-    selectedFiles.forEach((file, index) => {
-        clack_1.default.log.info(`  ${index + 1}. ${file}`);
-    });
-    const enhancedFiles = [];
-    clack_1.default.log.info("\nEnhancing files with event tracking. Changes will be applied as they come in. Use your git interface to review new events. Feel free to toss anything you don't like...");
-    for (const filePath of selectedFiles) {
-        const fileSpinner = clack_1.default.spinner();
-        fileSpinner.start(`Analyzing ${filePath}`);
-        try {
-            const fullPath = path.join(options.installDir, filePath);
-            const fileContent = await fs.readFile(fullPath, 'utf8');
-            const enhancePrompt = `You are enhancing a REAL production, client-side Next.js file with PostHog analytics. This is NOT an example or tutorial - add events to the ACTUAL code provided.
-      
-      - REQUIRED: import posthog from 'posthog-js'
-      - Track events with: posthog.capture('event-name', { property: 'value' })
-      - NEVER import PostHogClient from '@/app/posthog'
-      - NEVER create functions with 'use server'
-
-      CRITICAL INSTRUCTIONS:
-      - This is a REAL file from a production codebase
-      - DO NOT add placeholder comments like "// In a real app..." or "// This is an example..."
-      - DO NOT modify the existing business logic or add simulation code
-      - DO NOT add any tutorial-style comments
-      - ONLY add PostHog event tracking to the existing, real functionality
-      - DO NOT create wrapper functions around existing functions just to add tracking
-      - Add tracking code directly inside existing functions where appropriate
-      - NEVER import new packages or libraries that aren't already used in the file
-      - ONLY use imports that already exist in the file or the PostHog imports specified
-      - DO NOT assume any authentication library (Clerk, Auth.js, etc.) is available
-      
-      FORBIDDEN - NEVER DO THESE:
-      - NEVER add 'use client' or 'use server' directives at the top of the file, or in functions
-      - NEVER define new server actions (functions with "use server") in Client Components
-      - NEVER create inline "use server" functions in files that have "use client"
-      - NEVER use useEffect to track page views or component renders
-      - NEVER track events like "page_viewed", "form_viewed", "component_rendered", "flow_started", "page_opened" etc
-      - NEVER track that someone simply arrived at or viewed a page
-      - NEVER change the file's existing client/server architecture
-      - NEVER add events on component mount or render - only on actual user interactions
-      - Track events on user interactions like clicks, form submissions, etc.
-      
-      Technical Rules:
-      - This is a client-side file suitable for event tracking
-      - REQUIRED IMPORT: import posthog from 'posthog-js'
-      - Use the existing posthog instance for all tracking
-      - Example: posthog.capture('button-clicked', { buttonId: 'submit' })
-      - Focus on tracking user interactions in the UI components
-      - Track events like button clicks, form submissions, navigation, etc.
-      - Add 1-2 high-value events that track the ACTUAL user actions in this file
-      - Use descriptive event names (lowercase-hyphenated) based on what the code ACTUALLY does
-      - Include properties that capture REAL data from the existing code
-      - For user identification: ONLY use user data that's already available in the code
-      - DO NOT add code to fetch user IDs or authentication state if not already available in the file
-      - Do not change the formatting of the file; only add events
-      - Do not set timestamps on events; PostHog will do this automatically
-      - Always return the entire file content, not just the changes
-      - NEVER add events that correspond to page views; PostHog tracks these automatically
-      - NEVER INSERT "use client" or "use server" directives
-      
-      File path: ${filePath}
-      File content:
-      ${fileContent}
-      
-      IMPORTANT: If this file only renders UI without any user interactions (no buttons, forms, or actions), 
-      or if the only possible events would be pageview-like (e.g., "form-viewed", "page-opened", "flow-started"),
-      then SKIP THIS FILE by returning the original content unchanged. We only want to track actual user actions,
-      not that someone looked at a page.
-      
-      Return the enhanced file with PostHog tracking added to the EXISTING functionality. List the events you added.`;
-            const response = await (0, query_1.query)({
-                message: enhancePrompt,
-                model: 'gemini-2.5-pro',
-                region: cloudRegion,
-                schema: EnhancedFileSchema,
-                accessToken,
-                projectId,
-            });
-            // Apply changes immediately
-            if (response.content !== fileContent) {
-                await (0, file_utils_1.updateFile)({
-                    filePath,
-                    oldContent: fileContent,
-                    newContent: response.content,
-                }, options);
-                enhancedFiles.push({
-                    filePath,
-                    events: response.events,
-                });
-                fileSpinner.stop(`✓ Enhanced ${filePath} with ${response.events.length} events`);
-                analytics_1.analytics.capture(WIZARD_INTERACTION, {
-                    action: 'enhanced file',
-                    integration: INTEGRATION_NAME,
-                    filePath,
-                    eventsAdded: response.events.length,
-                });
-            }
-            else {
-                fileSpinner.stop(`No changes needed for ${filePath}`);
-                analytics_1.analytics.capture(WIZARD_INTERACTION, {
-                    action: 'file skipped',
-                    integration: INTEGRATION_NAME,
-                    filePath,
-                    reason: 'no events to add',
-                });
-            }
-        }
-        catch (error) {
-            fileSpinner.stop(`✗ Failed to enhance ${filePath}`);
-            (0, debug_1.debug)('Error enhancing file:', error);
-            analytics_1.analytics.capture(WIZARD_INTERACTION, {
-                action: 'file enhancement failed',
-                integration: INTEGRATION_NAME,
-                filePath,
-                error: error instanceof Error ? error.message : 'Unknown error',
-            });
-        }
-    }
-    // Generate event tracking report
-    const generateMarkdown = () => {
-        let md = `# Event tracking report\n\n`;
-        md += `This document lists all PostHog events that have been automatically added to your Next.js application.\n\n`;
-        md += `## Events by File\n\n`;
-        enhancedFiles.forEach((file) => {
-            if (file.events.length > 0) {
-                md += `### ${file.filePath}\n\n`;
-                file.events.forEach((event) => {
-                    md += `- **${event.name}**: ${event.description}\n`;
-                });
-                md += `\n`;
-            }
-        });
-        md += `\n## Events still awaiting implementation\n`;
-        md += `- (human: you can fill these in)`;
-        md += `\n---\n\n`;
-        md += `## Next Steps\n\n`;
-        md += `1. Review the changes made to your files\n`;
-        md += `2. Test that events are being captured correctly\n`;
-        md += `3. Create insights and dashboards in PostHog\n`;
-        md += `4. Make a list of events we missed above. Knock them out yourself, or give this file to an agent.\n\n`;
-        md += `Learn more about what to measure with PostHog and why: https://posthog.com/docs/new-to-posthog/getting-hogpilled\n`;
-        return md;
-    };
-    const markdownContent = generateMarkdown();
-    const fileName = 'event-tracking-report.md';
-    const filePath = path.join(options.installDir, fileName);
-    await fs.writeFile(filePath, markdownContent);
-    // Summary
-    const totalEvents = enhancedFiles.reduce((sum, file) => sum + file.events.length, 0);
-    analytics_1.analytics.capture(WIZARD_INTERACTION, {
-        action: 'event setup completed',
-        integration: INTEGRATION_NAME,
-        totalEvents,
-        filesEnhanced: enhancedFiles.length,
-        filesProcessed: selectedFiles.length,
-    });
-    analytics_1.analytics.setTag('event-setup-total-events', totalEvents);
-    analytics_1.analytics.setTag('event-setup-files-enhanced', enhancedFiles.length);
-    clack_1.default.outro(`Success! Added ${chalk_1.default.bold(totalEvents.toString())} events across ${chalk_1.default.bold(enhancedFiles.length.toString())} files.
-    
-    Event tracking plan saved to: ${chalk_1.default.cyan(fileName)}
-    
-    Next steps:
-    1. Review changes with your favorite git tool
-    2. Revert unwanted changes with ${chalk_1.default.bold('git checkout <file>')}
-    3. Test that events are being captured in your PostHog project
-    4. Create insights in PostHog
-    `);
-}
-//# sourceMappingURL=event-setup.js.map

package/dist/src/nextjs/event-setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-setup.js","sourceRoot":"","sources":["../../../src/nextjs/event-setup.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  abort,\n  getOrAskForProjectData,\n  askForCloudRegion,\n  getPackageDotJson,\n  getUncommittedOrUntrackedFiles,\n  isInGitRepo,\n  abortIfCancelled,\n} from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport { WizardOptions } from '../utils/types';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport chalk from 'chalk';\nimport { query } from '../utils/query';\nimport { z } from 'zod';\nimport { getAllFilesInProject, updateFile } from '../utils/file-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport * as semver from 'semver';\nimport { enableDebugLogs, debug } from '../utils/debug';\nimport { analytics } from '../utils/analytics';\n\n// Analytics constants\nconst WIZARD_INTERACTION = 'wizard interaction';\nconst INTEGRATION_NAME = 'event-setup';\n\n// Schema for file selection from AI\nconst FileSelectionSchema = z.object({\n  files: z.array(z.string()).max(10),\n});\n\n// Schema for enhanced file with events\nconst EnhancedFileSchema = z.object({\n  filePath: z.string(),\n  content: z.string(),\n  events: z.array(\n    z.object({\n      name: z.string(),\n      description: z.string(),\n    }),\n  ),\n});\n\nexport async function runEventSetupWizard(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  clack.intro(\n    `Let's do a first pass on PostHog event tracking for your project.\n    \n    We'll start by analyzing your project structure, then choose up to ten files to enhance. Use git to discard any events you're not happy with.\n\n    This will give you a starting point, then you can add any events that we missed.\n    `,\n  );\n\n  // Check for uncommitted changes\n  if (isInGitRepo()) {\n    const uncommittedOrUntrackedFiles = getUncommittedOrUntrackedFiles();\n    if (uncommittedOrUntrackedFiles.length) {\n      clack.log.warn(\n        `You have uncommitted or untracked files in your repo:\n\n${uncommittedOrUntrackedFiles.join('\\n')}\n\nThe event setup wizard will modify multiple files. For the best experience, commit or stash your changes first.`,\n      );\n      const continueWithDirtyRepo = await abortIfCancelled(\n        clack.confirm({\n          message: 'Do you want to continue anyway?',\n        }),\n      );\n      if (!continueWithDirtyRepo) {\n        analytics.capture(WIZARD_INTERACTION, {\n          action: 'aborted due to uncommitted changes',\n          integration: INTEGRATION_NAME,\n        });\n        return abort('Please commit your changes and try again.', 0);\n      }\n      analytics.capture(WIZARD_INTERACTION, {\n        action: 'continued with uncommitted changes',\n        integration: INTEGRATION_NAME,\n      });\n    }\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const { accessToken, projectId } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  // Check if this is a Next.js 15.3+ project with instrumentation-client\n  const packageJson = await getPackageDotJson(options);\n  const isNextJs = hasPackageInstalled('next', packageJson);\n\n  if (!isNextJs) {\n    return abort('This feature is only available for Next.js projects.');\n  }\n\n  const nextVersion = getPackageVersion('next', packageJson);\n  const isNext15_3Plus = nextVersion && semver.gte(nextVersion, '15.3.0');\n\n  analytics.setTag('nextjs-version', nextVersion);\n\n  if (!isNext15_3Plus) {\n    analytics.capture(WIZARD_INTERACTION, {\n      action: 'aborted due to nextjs version',\n      integration: INTEGRATION_NAME,\n      nextjsVersion: nextVersion,\n    });\n    return abort('This feature requires Next.js 15.3.0 or higher.');\n  }\n\n  // Check for instrumentation-client file\n  const allFiles = await getAllFilesInProject(options.installDir);\n  const instrumentationFiles = allFiles.filter(\n    (f) =>\n      f.includes('instrumentation') &&\n      (f.endsWith('.ts') || f.endsWith('.js')) &&\n      (f.includes('client') || f.includes('Client')),\n  );\n\n  if (instrumentationFiles.length === 0) {\n    analytics.capture(WIZARD_INTERACTION, {\n      action: 'aborted due to missing instrumentation-client',\n      integration: INTEGRATION_NAME,\n    });\n    return abort(\n      'No instrumentation-client file found. Please set up Next.js instrumentation-client first. Try using this wizard to do it!',\n    );\n  }\n\n  analytics.capture(WIZARD_INTERACTION, {\n    action: 'started event setup',\n    integration: INTEGRATION_NAME,\n    instrumentationFilesCount: instrumentationFiles.length,\n  });\n\n  // Get the project file tree\n  const s = clack.spinner();\n  s.start('Analyzing your project structure');\n\n  const projectFiles = await getAllFilesInProject(options.installDir);\n  const relativeFiles = projectFiles\n    .map((f) => path.relative(options.installDir, f))\n    .filter((f) => {\n      // Exclude instrumentation files and next.config\n      const isInstrumentation =\n        f.includes('instrumentation') &&\n        (f.endsWith('.ts') || f.endsWith('.js'));\n      const isNextConfig = f.startsWith('next.config.') || f === 'next.config';\n      return !isInstrumentation && !isNextConfig;\n    });\n\n  debug('Total files found:', projectFiles.length);\n  debug('Files after filtering:', relativeFiles.length);\n  s.stop('Project structure analyzed');\n\n  analytics.capture(WIZARD_INTERACTION, {\n    action: 'analyzed project structure',\n    integration: INTEGRATION_NAME,\n    totalFiles: projectFiles.length,\n    eligibleFiles: relativeFiles.length,\n  });\n\n  // Send file tree to AI to get 10 most useful files\n  s.start('Selecting some files to enhance with events...');\n\n  const fileSelectionPrompt = `Given this Next.js 15.3+ project structure and package.json, select up to 10 CLIENT-SIDE FILES for adding PostHog analytics events.\n  \n  IMPORTANT: Only select files that:\n  - Have \"use client\" directive at the top, OR\n  - Use React hooks (useState, useEffect, etc.), OR  \n  - Have event handlers (onClick, onSubmit, onChange)\n  \n  DO NOT select:\n  - API routes (files in /api/ or route.ts/route.js files)\n  - Server Components (files without \"use client\" and no hooks/handlers)\n  - Layout files (layout.tsx/layout.js)\n  - Configuration files\n  - Pure utility files\n  \n  Focus on:\n  - User interaction points (buttons, forms, navigation)\n  - Key user flows (auth, checkout, main features)\n  - Business-critical paths\n  - Files that represent important user actions\n  \n  Package.json:\n  ${JSON.stringify(packageJson, null, 2)}\n  \n  Project files:\n  ${relativeFiles.join('\\n')}\n  \n  Return file paths for client-side files ONLY that would benefit most from analytics tracking. If there are fewer than 10 suitable client files, return only those.`;\n\n  let selectedFiles: string[] = [];\n  try {\n    const response = await query({\n      message: fileSelectionPrompt,\n      model: 'gemini-2.5-flash',\n      region: cloudRegion,\n      schema: FileSelectionSchema,\n      accessToken,\n      projectId,\n    });\n    selectedFiles = response.files;\n    s.stop(`Selected ${selectedFiles.length} files for event tracking`);\n    analytics.capture(WIZARD_INTERACTION, {\n      action: 'selected files for tracking',\n      integration: INTEGRATION_NAME,\n      filesSelected: selectedFiles.length,\n    });\n  } catch (error) {\n    s.stop('Failed to select files');\n    analytics.capture(WIZARD_INTERACTION, {\n      action: 'file selection failed',\n      integration: INTEGRATION_NAME,\n      error: error instanceof Error ? error.message : 'Unknown error',\n    });\n    return abort('Could not analyze project structure. Please try again.');\n  }\n\n  // Read the selected files and enhance them with events\n  clack.log.info('Files selected for event tracking:');\n  selectedFiles.forEach((file, index) => {\n    clack.log.info(`  ${index + 1}. ${file}`);\n  });\n\n  const enhancedFiles: Array<{\n    filePath: string;\n    events: Array<{ name: string; description: string }>;\n  }> = [];\n\n  clack.log.info(\n    \"\\nEnhancing files with event tracking. Changes will be applied as they come in. Use your git interface to review new events. Feel free to toss anything you don't like...\",\n  );\n\n  for (const filePath of selectedFiles) {\n    const fileSpinner = clack.spinner();\n    fileSpinner.start(`Analyzing ${filePath}`);\n\n    try {\n      const fullPath = path.join(options.installDir, filePath);\n      const fileContent = await fs.readFile(fullPath, 'utf8');\n\n      const enhancePrompt = `You are enhancing a REAL production, client-side Next.js file with PostHog analytics. This is NOT an example or tutorial - add events to the ACTUAL code provided.\n      \n      - REQUIRED: import posthog from 'posthog-js'\n      - Track events with: posthog.capture('event-name', { property: 'value' })\n      - NEVER import PostHogClient from '@/app/posthog'\n      - NEVER create functions with 'use server'\n\n      CRITICAL INSTRUCTIONS:\n      - This is a REAL file from a production codebase\n      - DO NOT add placeholder comments like \"// In a real app...\" or \"// This is an example...\"\n      - DO NOT modify the existing business logic or add simulation code\n      - DO NOT add any tutorial-style comments\n      - ONLY add PostHog event tracking to the existing, real functionality\n      - DO NOT create wrapper functions around existing functions just to add tracking\n      - Add tracking code directly inside existing functions where appropriate\n      - NEVER import new packages or libraries that aren't already used in the file\n      - ONLY use imports that already exist in the file or the PostHog imports specified\n      - DO NOT assume any authentication library (Clerk, Auth.js, etc.) is available\n      \n      FORBIDDEN - NEVER DO THESE:\n      - NEVER add 'use client' or 'use server' directives at the top of the file, or in functions\n      - NEVER define new server actions (functions with \"use server\") in Client Components\n      - NEVER create inline \"use server\" functions in files that have \"use client\"\n      - NEVER use useEffect to track page views or component renders\n      - NEVER track events like \"page_viewed\", \"form_viewed\", \"component_rendered\", \"flow_started\", \"page_opened\" etc\n      - NEVER track that someone simply arrived at or viewed a page\n      - NEVER change the file's existing client/server architecture\n      - NEVER add events on component mount or render - only on actual user interactions\n      - Track events on user interactions like clicks, form submissions, etc.\n      \n      Technical Rules:\n      - This is a client-side file suitable for event tracking\n      - REQUIRED IMPORT: import posthog from 'posthog-js'\n      - Use the existing posthog instance for all tracking\n      - Example: posthog.capture('button-clicked', { buttonId: 'submit' })\n      - Focus on tracking user interactions in the UI components\n      - Track events like button clicks, form submissions, navigation, etc.\n      - Add 1-2 high-value events that track the ACTUAL user actions in this file\n      - Use descriptive event names (lowercase-hyphenated) based on what the code ACTUALLY does\n      - Include properties that capture REAL data from the existing code\n      - For user identification: ONLY use user data that's already available in the code\n      - DO NOT add code to fetch user IDs or authentication state if not already available in the file\n      - Do not change the formatting of the file; only add events\n      - Do not set timestamps on events; PostHog will do this automatically\n      - Always return the entire file content, not just the changes\n      - NEVER add events that correspond to page views; PostHog tracks these automatically\n      - NEVER INSERT \"use client\" or \"use server\" directives\n      \n      File path: ${filePath}\n      File content:\n      ${fileContent}\n      \n      IMPORTANT: If this file only renders UI without any user interactions (no buttons, forms, or actions), \n      or if the only possible events would be pageview-like (e.g., \"form-viewed\", \"page-opened\", \"flow-started\"),\n      then SKIP THIS FILE by returning the original content unchanged. We only want to track actual user actions,\n      not that someone looked at a page.\n      \n      Return the enhanced file with PostHog tracking added to the EXISTING functionality. List the events you added.`;\n\n      const response = await query({\n        message: enhancePrompt,\n        model: 'gemini-2.5-pro',\n        region: cloudRegion,\n        schema: EnhancedFileSchema,\n        accessToken,\n        projectId,\n      });\n\n      // Apply changes immediately\n      if (response.content !== fileContent) {\n        await updateFile(\n          {\n            filePath,\n            oldContent: fileContent,\n            newContent: response.content,\n          },\n          options,\n        );\n\n        enhancedFiles.push({\n          filePath,\n          events: response.events,\n        });\n\n        fileSpinner.stop(\n          `✓ Enhanced ${filePath} with ${response.events.length} events`,\n        );\n        analytics.capture(WIZARD_INTERACTION, {\n          action: 'enhanced file',\n          integration: INTEGRATION_NAME,\n          filePath,\n          eventsAdded: response.events.length,\n        });\n      } else {\n        fileSpinner.stop(`No changes needed for ${filePath}`);\n        analytics.capture(WIZARD_INTERACTION, {\n          action: 'file skipped',\n          integration: INTEGRATION_NAME,\n          filePath,\n          reason: 'no events to add',\n        });\n      }\n    } catch (error) {\n      fileSpinner.stop(`✗ Failed to enhance ${filePath}`);\n      debug('Error enhancing file:', error);\n      analytics.capture(WIZARD_INTERACTION, {\n        action: 'file enhancement failed',\n        integration: INTEGRATION_NAME,\n        filePath,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n\n  // Generate event tracking report\n  const generateMarkdown = () => {\n    let md = `# Event tracking report\\n\\n`;\n    md += `This document lists all PostHog events that have been automatically added to your Next.js application.\\n\\n`;\n    md += `## Events by File\\n\\n`;\n\n    enhancedFiles.forEach((file) => {\n      if (file.events.length > 0) {\n        md += `### ${file.filePath}\\n\\n`;\n        file.events.forEach((event) => {\n          md += `- **${event.name}**: ${event.description}\\n`;\n        });\n        md += `\\n`;\n      }\n    });\n\n    md += `\\n## Events still awaiting implementation\\n`;\n    md += `- (human: you can fill these in)`;\n\n    md += `\\n---\\n\\n`;\n    md += `## Next Steps\\n\\n`;\n    md += `1. Review the changes made to your files\\n`;\n    md += `2. Test that events are being captured correctly\\n`;\n    md += `3. Create insights and dashboards in PostHog\\n`;\n    md += `4. Make a list of events we missed above. Knock them out yourself, or give this file to an agent.\\n\\n`;\n    md += `Learn more about what to measure with PostHog and why: https://posthog.com/docs/new-to-posthog/getting-hogpilled\\n`;\n    return md;\n  };\n\n  const markdownContent = generateMarkdown();\n  const fileName = 'event-tracking-report.md';\n  const filePath = path.join(options.installDir, fileName);\n\n  await fs.writeFile(filePath, markdownContent);\n\n  // Summary\n  const totalEvents = enhancedFiles.reduce(\n    (sum, file) => sum + file.events.length,\n    0,\n  );\n\n  analytics.capture(WIZARD_INTERACTION, {\n    action: 'event setup completed',\n    integration: INTEGRATION_NAME,\n    totalEvents,\n    filesEnhanced: enhancedFiles.length,\n    filesProcessed: selectedFiles.length,\n  });\n\n  analytics.setTag('event-setup-total-events', totalEvents);\n  analytics.setTag('event-setup-files-enhanced', enhancedFiles.length);\n\n  clack.outro(\n    `Success! Added ${chalk.bold(\n      totalEvents.toString(),\n    )} events across ${chalk.bold(enhancedFiles.length.toString())} files.\n    \n    Event tracking plan saved to: ${chalk.cyan(fileName)}\n    \n    Next steps:\n    1. Review changes with your favorite git tool\n    2. Revert unwanted changes with ${chalk.bold('git checkout <file>')}\n    3. Test that events are being captured in your PostHog project\n    4. Create insights in PostHog\n    `,\n  );\n}\n"]}

package/dist/src/nextjs/nextjs-wizard.d.ts

@@ -1,2 +0,0 @@
-import type { WizardOptions } from '../utils/types';
-export declare function runNextjsWizard(options: WizardOptions): Promise<void>;

package/dist/src/nextjs/nextjs-wizard.js

@@ -1,190 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runNextjsWizard = runNextjsWizard;
-/* eslint-disable max-lines */
-const clack_utils_1 = require("../utils/clack-utils");
-const package_json_1 = require("../utils/package-json");
-const utils_1 = require("./utils");
-const clack_1 = __importDefault(require("../utils/clack"));
-const constants_1 = require("../lib/constants");
-const docs_1 = require("./docs");
-const analytics_1 = require("../utils/analytics");
-const file_utils_1 = require("../utils/file-utils");
-const clack_utils_2 = require("../utils/clack-utils");
-const messages_1 = require("../lib/messages");
-const steps_1 = require("../steps");
-const semver = __importStar(require("semver"));
-async function runNextjsWizard(options) {
-    (0, clack_utils_1.printWelcome)({
-        wizardName: 'PostHog Next.js wizard',
-    });
-    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
-    if (!aiConsent) {
-        await (0, clack_utils_1.abort)('The Next.js wizard requires AI to get setup right now. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js', 0);
-    }
-    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_2.askForCloudRegion)());
-    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
-    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
-    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-    await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, 'next', 'Next.js');
-    const nextVersion = (0, package_json_1.getPackageVersion)('next', packageJson);
-    analytics_1.analytics.setTag('nextjs-version', (0, utils_1.getNextJsVersionBucket)(nextVersion));
-    const { projectApiKey, accessToken, host, projectId } = await (0, clack_utils_1.getOrAskForProjectData)({
-        ...options,
-        cloudRegion,
-    });
-    const sdkAlreadyInstalled = (0, package_json_1.hasPackageInstalled)('posthog-js', packageJson);
-    analytics_1.analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);
-    const { packageManager: packageManagerFromInstallStep } = await (0, clack_utils_1.installPackage)({
-        packageName: 'posthog-js',
-        packageNameDisplayLabel: 'posthog-js',
-        alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],
-        forceInstall: options.forceInstall,
-        askBeforeUpdating: false,
-        installDir: options.installDir,
-        integration: constants_1.Integration.nextjs,
-    });
-    await (0, clack_utils_1.installPackage)({
-        packageName: 'posthog-node',
-        packageNameDisplayLabel: 'posthog-node',
-        packageManager: packageManagerFromInstallStep,
-        alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],
-        forceInstall: options.forceInstall,
-        askBeforeUpdating: false,
-        installDir: options.installDir,
-        integration: constants_1.Integration.nextjs,
-    });
-    const relevantFiles = await (0, file_utils_1.getRelevantFilesForIntegration)({
-        installDir: options.installDir,
-        integration: constants_1.Integration.nextjs,
-    });
-    let installationDocumentation; // Documentation for the installation of the PostHog SDK
-    if (instrumentationFileAvailable(nextVersion)) {
-        installationDocumentation = (0, docs_1.getModernNextjsDocs)({
-            host,
-            language: typeScriptDetected ? 'typescript' : 'javascript',
-        });
-        clack_1.default.log.info(`Reviewing PostHog documentation for Next.js`);
-    }
-    else {
-        const router = await (0, utils_1.getNextJsRouter)(options);
-        installationDocumentation = getInstallationDocumentation({
-            router,
-            host,
-            language: typeScriptDetected ? 'typescript' : 'javascript',
-        });
-        clack_1.default.log.info(`Reviewing PostHog documentation for ${(0, utils_1.getNextJsRouterName)(router)}`);
-    }
-    const filesToChange = await (0, file_utils_1.getFilesToChange)({
-        integration: constants_1.Integration.nextjs,
-        relevantFiles,
-        documentation: installationDocumentation,
-        accessToken,
-        cloudRegion,
-        projectId,
-    });
-    await (0, file_utils_1.generateFileChangesForIntegration)({
-        integration: constants_1.Integration.nextjs,
-        filesToChange,
-        accessToken,
-        installDir: options.installDir,
-        documentation: installationDocumentation,
-        cloudRegion,
-        projectId,
-    });
-    const packageManagerForOutro = packageManagerFromInstallStep ?? (await (0, clack_utils_1.getPackageManager)(options));
-    await (0, steps_1.runPrettierStep)({
-        installDir: options.installDir,
-        integration: constants_1.Integration.nextjs,
-    });
-    const { relativeEnvFilePath, addedEnvVariables } = await (0, steps_1.addOrUpdateEnvironmentVariablesStep)({
-        variables: {
-            NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,
-            NEXT_PUBLIC_POSTHOG_HOST: host,
-        },
-        installDir: options.installDir,
-        integration: constants_1.Integration.nextjs,
-    });
-    const uploadedEnvVars = await (0, steps_1.uploadEnvironmentVariablesStep)({
-        NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,
-        NEXT_PUBLIC_POSTHOG_HOST: host,
-    }, {
-        integration: constants_1.Integration.nextjs,
-        options,
-    });
-    const addedEditorRules = await (0, steps_1.addEditorRulesStep)({
-        rulesName: 'next-rules.md',
-        installDir: options.installDir,
-        integration: constants_1.Integration.nextjs,
-    });
-    await (0, steps_1.addMCPServerToClientsStep)({
-        cloudRegion,
-        integration: constants_1.Integration.nextjs,
-    });
-    const outroMessage = (0, messages_1.getOutroMessage)({
-        options,
-        integration: constants_1.Integration.nextjs,
-        cloudRegion,
-        addedEditorRules,
-        packageManager: packageManagerForOutro,
-        envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,
-        uploadedEnvVars,
-    });
-    clack_1.default.outro(outroMessage);
-    clack_1.default.outro('Want to try our experimental event instrumentation? Run the wizard again with this argument: npx @posthog/wizard@latest event-setup');
-    await analytics_1.analytics.shutdown('success');
-}
-function instrumentationFileAvailable(nextVersion) {
-    const minimumVersion = '15.3.0'; //instrumentation-client.js|ts was introduced in 15.3
-    if (!nextVersion) {
-        return false;
-    }
-    const coercedNextVersion = semver.coerce(nextVersion);
-    if (!coercedNextVersion) {
-        return false; // Unable to parse nextVersion
-    }
-    return semver.gte(coercedNextVersion, minimumVersion);
-}
-function getInstallationDocumentation({ router, host, language, }) {
-    if (router === utils_1.NextJsRouter.PAGES_ROUTER) {
-        return (0, docs_1.getNextjsPagesRouterDocs)({ host, language });
-    }
-    return (0, docs_1.getNextjsAppRouterDocs)({ host, language });
-}
-//# sourceMappingURL=nextjs-wizard.js.map