@posthog/wizard 1.19.0 → 1.20.0

package/dist/src/lib/framework-config.d.ts

@@ -0,0 +1,95 @@
+import type { Integration } from './constants';
+import type { WizardOptions } from '../utils/types';
+/**
+ * Configuration interface for framework-specific agent integrations.
+ * Each framework exports a FrameworkConfig that the universal runner uses.
+ */
+export interface FrameworkConfig {
+    metadata: FrameworkMetadata;
+    detection: FrameworkDetection;
+    environment: EnvironmentConfig;
+    analytics: AnalyticsConfig;
+    prompts: PromptConfig;
+    ui: UIConfig;
+}
+/**
+ * Basic framework information and documentation
+ */
+export interface FrameworkMetadata {
+    /** Display name (e.g., "Next.js", "React") */
+    name: string;
+    /** Integration type from constants */
+    integration: Integration;
+    /** URL to framework-specific PostHog docs */
+    docsUrl: string;
+    /** Message shown when user declines AI consent */
+    abortMessage: string;
+    /**
+     * Optional function to gather framework-specific context before agent runs.
+     * For Next.js: detects router type
+     * For React Native: detects Expo vs bare
+     */
+    gatherContext?: (options: WizardOptions) => Promise<Record<string, any>>;
+}
+/**
+ * Framework detection and version handling
+ */
+export interface FrameworkDetection {
+    /** Package name to check in package.json (e.g., "next", "react") */
+    packageName: string;
+    /** Human-readable name for error messages (e.g., "Next.js") */
+    packageDisplayName: string;
+    /** Extract version from package.json */
+    getVersion: (packageJson: any) => string | undefined;
+    /** Optional: Convert version to analytics bucket (e.g., "15.x") */
+    getVersionBucket?: (version: string) => string;
+}
+/**
+ * Environment variable configuration
+ */
+export interface EnvironmentConfig {
+    /** Whether to upload env vars to hosting providers post-agent */
+    uploadToHosting: boolean;
+    /**
+     * Build the environment variables object for this framework.
+     * Returns the exact variable names and values to upload to hosting providers.
+     */
+    getEnvVars: (apiKey: string, host: string) => Record<string, string>;
+}
+/**
+ * Analytics configuration
+ */
+export interface AnalyticsConfig {
+    /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */
+    getTags: (context: any) => Record<string, any>;
+    /** Optional: Additional event properties */
+    getEventProperties?: (context: any) => Record<string, any>;
+}
+/**
+ * Prompt configuration
+ */
+export interface PromptConfig {
+    /**
+     * Optional: Additional context lines to append to base prompt
+     * For Next.js: "- Router: app"
+     * For React Native: "- Platform: Expo"
+     */
+    getAdditionalContextLines?: (context: any) => string[];
+}
+/**
+ * UI messaging configuration
+ */
+export interface UIConfig {
+    /** Welcome message for wizard start */
+    welcomeMessage: string;
+    /** Spinner message while agent runs */
+    spinnerMessage: string;
+    /** Success message when agent completes */
+    successMessage: string;
+    /** Estimated time for agent to complete (in minutes) */
+    estimatedDurationMinutes: number;
+    /** Generate "What the agent did" bullets from context */
+    getOutroChanges: (context: any) => string[];
+    /** Generate "Next steps" bullets from context */
+    getOutroNextSteps: (context: any) => string[];
+}

package/dist/src/lib/framework-config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=framework-config.js.map

package/dist/src/lib/framework-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-config.js","sourceRoot":"","sources":["../../../src/lib/framework-config.ts"],"names":[],"mappings":"","sourcesContent":["import type { Integration } from './constants';\nimport type { WizardOptions } from '../utils/types';\n\n/**\n * Configuration interface for framework-specific agent integrations.\n * Each framework exports a FrameworkConfig that the universal runner uses.\n */\nexport interface FrameworkConfig {\n  metadata: FrameworkMetadata;\n  detection: FrameworkDetection;\n  environment: EnvironmentConfig;\n  analytics: AnalyticsConfig;\n  prompts: PromptConfig;\n  ui: UIConfig;\n}\n\n/**\n * Basic framework information and documentation\n */\nexport interface FrameworkMetadata {\n  /** Display name (e.g., \"Next.js\", \"React\") */\n  name: string;\n\n  /** Integration type from constants */\n  integration: Integration;\n\n  /** URL to framework-specific PostHog docs */\n  docsUrl: string;\n\n  /** Message shown when user declines AI consent */\n  abortMessage: string;\n\n  /**\n   * Optional function to gather framework-specific context before agent runs.\n   * For Next.js: detects router type\n   * For React Native: detects Expo vs bare\n   */\n  gatherContext?: (options: WizardOptions) => Promise<Record<string, any>>;\n}\n\n/**\n * Framework detection and version handling\n */\nexport interface FrameworkDetection {\n  /** Package name to check in package.json (e.g., \"next\", \"react\") */\n  packageName: string;\n\n  /** Human-readable name for error messages (e.g., \"Next.js\") */\n  packageDisplayName: string;\n\n  /** Extract version from package.json */\n  getVersion: (packageJson: any) => string | undefined;\n\n  /** Optional: Convert version to analytics bucket (e.g., \"15.x\") */\n  getVersionBucket?: (version: string) => string;\n}\n\n/**\n * Environment variable configuration\n */\nexport interface EnvironmentConfig {\n  /** Whether to upload env vars to hosting providers post-agent */\n  uploadToHosting: boolean;\n\n  /**\n   * Build the environment variables object for this framework.\n   * Returns the exact variable names and values to upload to hosting providers.\n   */\n  getEnvVars: (apiKey: string, host: string) => Record<string, string>;\n}\n\n/**\n * Analytics configuration\n */\nexport interface AnalyticsConfig {\n  /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */\n  getTags: (context: any) => Record<string, any>;\n\n  /** Optional: Additional event properties */\n  getEventProperties?: (context: any) => Record<string, any>;\n}\n\n/**\n * Prompt configuration\n */\nexport interface PromptConfig {\n  /**\n   * Optional: Additional context lines to append to base prompt\n   * For Next.js: \"- Router: app\"\n   * For React Native: \"- Platform: Expo\"\n   */\n  getAdditionalContextLines?: (context: any) => string[];\n}\n\n/**\n * UI messaging configuration\n */\nexport interface UIConfig {\n  /** Welcome message for wizard start */\n  welcomeMessage: string;\n\n  /** Spinner message while agent runs */\n  spinnerMessage: string;\n\n  /** Success message when agent completes */\n  successMessage: string;\n\n  /** Estimated time for agent to complete (in minutes) */\n  estimatedDurationMinutes: number;\n\n  /** Generate \"What the agent did\" bullets from context */\n  getOutroChanges: (context: any) => string[];\n\n  /** Generate \"Next steps\" bullets from context */\n  getOutroNextSteps: (context: any) => string[];\n}\n"]}

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

@@ -1,5 +1,5 @@
 import type { WizardOptions } from '../utils/types';
 /**
- * Simplified Next.js wizard that delegates to PostHog MCP's /integrate command
+ * Next.js wizard powered by the universal agent runner.
  */
 export declare function runNextjsWizardAgent(options: WizardOptions): Promise<void>;

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

@@ -1,146 +1,82 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runNextjsWizardAgent = runNextjsWizardAgent;
-/* Simplified Next.js wizard using posthog-agent with PostHog MCP */
-const clack_utils_1 = require("../utils/clack-utils");
+const debug_1 = require("../utils/debug");
+const agent_runner_1 = require("../lib/agent-runner");
+const constants_1 = require("../lib/constants");
 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 analytics_1 = require("../utils/analytics");
-const clack_utils_2 = require("../utils/clack-utils");
-const urls_1 = require("../utils/urls");
-const chalk_1 = __importDefault(require("chalk"));
-const steps_1 = require("../steps");
-const debug_1 = require("../utils/debug");
-const agent_interface_1 = require("../lib/agent-interface");
 /**
- * Simplified Next.js wizard that delegates to PostHog MCP's /integrate command
+ * Next.js framework configuration for the universal agent runner.
+ */
+const NEXTJS_AGENT_CONFIG = {
+    metadata: {
+        name: 'Next.js',
+        integration: constants_1.Integration.nextjs,
+        docsUrl: 'https://posthog.com/docs/libraries/next-js',
+        abortMessage: 'This wizard uses an LLM agent to intelligently modify your project. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',
+        gatherContext: async (options) => {
+            const router = await (0, utils_1.getNextJsRouter)(options);
+            return { router };
+        },
+    },
+    detection: {
+        packageName: 'next',
+        packageDisplayName: 'Next.js',
+        getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('next', packageJson),
+        getVersionBucket: utils_1.getNextJsVersionBucket,
+    },
+    environment: {
+        uploadToHosting: true,
+        getEnvVars: (apiKey, host) => ({
+            NEXT_PUBLIC_POSTHOG_KEY: apiKey,
+            NEXT_PUBLIC_POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const router = context.router;
+            return {
+                router: router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages',
+            };
+        },
+    },
+    prompts: {
+        getAdditionalContextLines: (context) => {
+            const router = context.router;
+            const routerType = router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages';
+            return [`Router: ${routerType}`];
+        },
+    },
+    ui: {
+        welcomeMessage: 'PostHog Next.js wizard (agent-powered)',
+        spinnerMessage: 'Writing your PostHog setup with events, error capture and more...',
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 8,
+        getOutroChanges: (context) => {
+            const router = context.router;
+            const routerName = (0, utils_1.getNextJsRouterName)(router);
+            return [
+                `Analyzed your Next.js project structure (${routerName})`,
+                `Created and configured PostHog initializers`,
+                `Integrated PostHog into your application`,
+            ];
+        },
+        getOutroNextSteps: () => {
+            return [
+                'Start your development server to see PostHog in action',
+                'Visit your PostHog dashboard to see incoming events',
+            ];
+        },
+    },
+};
+/**
+ * Next.js wizard powered by the universal agent runner.
  */
 async function runNextjsWizardAgent(options) {
     if (options.debug) {
         (0, debug_1.enableDebugLogs)();
     }
-    (0, clack_utils_1.printWelcome)({
-        wizardName: 'PostHog Next.js wizard (agent-powered)',
-    });
-    clack_1.default.log.info('🧙 The wizard has chosen you to try the next-generation agent integration for Next.js.\n\nStand by for the good stuff, and let me know how it goes:\n\ndanilo@posthog.com');
-    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
-    if (!aiConsent) {
-        await (0, clack_utils_1.abort)('This wizard uses an LLM agent to intelligently modify your project. 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));
-    analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
-        action: 'started agent integration',
-    });
-    const { projectApiKey, host, accessToken } = await (0, clack_utils_1.getOrAskForProjectData)({
-        ...options,
-        cloudRegion,
-    });
-    const router = await (0, utils_1.getNextJsRouter)(options);
-    const routerType = router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages';
-    const spinner = clack_1.default.spinner();
-    const agent = await (0, agent_interface_1.initializeAgent)({
-        workingDirectory: options.installDir,
-        posthogMcpUrl: 'https://mcp.posthog.com/mcp',
-        posthogApiKey: accessToken,
-        debug: false,
-    }, options, spinner);
-    const integrationPrompt = buildIntegrationPrompt({
-        framework: 'Next.js',
-        version: nextVersion || 'latest',
-        router: routerType,
-        typescript: typeScriptDetected,
-        projectApiKey,
-        host,
-    });
-    await (0, agent_interface_1.runAgent)(agent, integrationPrompt, options, spinner, {
-        estimatedDurationMinutes: 8,
-        spinnerMessage: 'Writing your PostHog setup with events, error capture and more...',
-        successMessage: 'PostHog integration complete',
-        errorMessage: 'Integration failed',
-    });
-    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,
-    });
-    await (0, steps_1.addMCPServerToClientsStep)({
-        cloudRegion,
-        integration: constants_1.Integration.nextjs,
-    });
-    const continueUrl = options.signup
-        ? `${(0, urls_1.getCloudUrlFromRegion)(cloudRegion)}/products?source=wizard`
-        : undefined;
-    const changes = [
-        addedEnvVariables
-            ? `Added your Project API key to your ${relativeEnvFilePath} file`
-            : '',
-        uploadedEnvVars.length > 0
-            ? `Uploaded your Project API key to your hosting provider`
-            : '',
-    ].filter(Boolean);
-    const nextSteps = [
-        uploadedEnvVars.length === 0
-            ? `Upload your Project API key to your hosting provider`
-            : '',
-    ].filter(Boolean);
-    const outroMessage = `
-${chalk_1.default.green('Successfully installed PostHog!')}
-
-${chalk_1.default.cyan('What the agent did:')}
-• Analyzed your Next.js project structure (${routerType} router)
-• Created and configured PostHog initializers
-• Integrated PostHog into your application
-${changes.map((change) => `• ${change}`).join('\n')}
-
-${chalk_1.default.yellow('Next steps:')}
-• Start your development server to see PostHog in action
-• Visit your PostHog dashboard to see incoming events
-${nextSteps.map((step) => `• ${step}`).join('\n')}
-
-Learn more about PostHog + Next.js: ${chalk_1.default.cyan('https://posthog.com/docs/libraries/next-js')}
-${continueUrl ? `\nContinue onboarding: ${chalk_1.default.cyan(continueUrl)}\n` : ``}
-${chalk_1.default.dim('Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.')}
-
-${chalk_1.default.dim(`How did this work for you? Drop me a line: danilo@posthog.com`)}`;
-    clack_1.default.outro(outroMessage);
-    await analytics_1.analytics.shutdown('success');
-}
-function buildIntegrationPrompt(context) {
-    return `You have access to the PostHog MCP server which provides an integration resource to integrate PostHog into this ${context.framework} project.
-
-Project context:
-- Framework: ${context.framework} ${context.version}
-- Router: ${context.router}
-- TypeScript: ${context.typescript ? 'Yes' : 'No'}
-- PostHog API Key: ${context.projectApiKey}
-- PostHog Host: ${context.host}
-
-Instructions:
-1. Call the PostHog MCP's resource for setup: posthog://integration/workflow/setup/begin
-2. Follow all instructions provided
-
-The PostHog MCP will provide specific integration code and instructions. Please follow them carefully. Be sure to look for lockfiles to determine the appropriate package manager to use when installing PostHog. Do not manually edit the package.json file.
-`;
+    await (0, agent_runner_1.runAgentWizard)(NEXTJS_AGENT_CONFIG, options);
 }
 //# sourceMappingURL=nextjs-wizard-agent.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"nextjs-wizard-agent.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Simplified Next.js wizard using posthog-agent with PostHog MCP */\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  isUsingTypeScript,\n  printWelcome,\n} from '../utils/clack-utils';\nimport { getPackageVersion } from '../utils/package-json';\nimport { getNextJsRouter, getNextJsVersionBucket, NextJsRouter } from './utils';\nimport clack from '../utils/clack';\nimport { Integration, WIZARD_INTERACTION_EVENT_NAME } from '../lib/constants';\nimport { analytics } from '../utils/analytics';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { getCloudUrlFromRegion } from '../utils/urls';\nimport chalk from 'chalk';\nimport {\n  addOrUpdateEnvironmentVariablesStep,\n  addMCPServerToClientsStep,\n  uploadEnvironmentVariablesStep,\n} from '../steps';\nimport { enableDebugLogs } from '../utils/debug';\nimport { initializeAgent, runAgent } from '../lib/agent-interface';\n\n/**\n * Simplified Next.js wizard that delegates to PostHog MCP's /integrate command\n */\nexport async function runNextjsWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  printWelcome({\n    wizardName: 'PostHog Next.js wizard (agent-powered)',\n  });\n\n  clack.log.info(\n    '🧙 The wizard has chosen you to try the next-generation agent integration for Next.js.\\n\\nStand by for the good stuff, and let me know how it goes:\\n\\ndanilo@posthog.com',\n  );\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'This wizard uses an LLM agent to intelligently modify your project. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n  await ensurePackageIsInstalled(packageJson, 'next', 'Next.js');\n\n  const nextVersion = getPackageVersion('next', packageJson);\n  analytics.setTag('nextjs-version', getNextJsVersionBucket(nextVersion));\n\n  analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n  });\n\n  const { projectApiKey, host, accessToken } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const router = await getNextJsRouter(options);\n  const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n\n  const spinner = clack.spinner();\n\n  const agent = await initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      posthogMcpUrl: 'https://mcp.posthog.com/mcp',\n      posthogApiKey: accessToken,\n      debug: false,\n    },\n    options,\n    spinner,\n  );\n\n  const integrationPrompt = buildIntegrationPrompt({\n    framework: 'Next.js',\n    version: nextVersion || 'latest',\n    router: routerType,\n    typescript: typeScriptDetected,\n    projectApiKey,\n    host,\n  });\n\n  await runAgent(agent, integrationPrompt, options, spinner, {\n    estimatedDurationMinutes: 8,\n    spinnerMessage:\n      'Writing your PostHog setup with events, error capture and more...',\n    successMessage: 'PostHog integration complete',\n    errorMessage: 'Integration failed',\n  });\n\n  const { relativeEnvFilePath, addedEnvVariables } =\n    await addOrUpdateEnvironmentVariablesStep({\n      variables: {\n        NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n        NEXT_PUBLIC_POSTHOG_HOST: host,\n      },\n      installDir: options.installDir,\n      integration: Integration.nextjs,\n    });\n\n  const uploadedEnvVars = await uploadEnvironmentVariablesStep(\n    {\n      NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n      NEXT_PUBLIC_POSTHOG_HOST: host,\n    },\n    {\n      integration: Integration.nextjs,\n      options,\n    },\n  );\n\n  await addMCPServerToClientsStep({\n    cloudRegion,\n    integration: Integration.nextjs,\n  });\n\n  const continueUrl = options.signup\n    ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n    : undefined;\n\n  const changes = [\n    addedEnvVariables\n      ? `Added your Project API key to your ${relativeEnvFilePath} file`\n      : '',\n    uploadedEnvVars.length > 0\n      ? `Uploaded your Project API key to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const nextSteps = [\n    uploadedEnvVars.length === 0\n      ? `Upload your Project API key to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const outroMessage = `\n${chalk.green('Successfully installed PostHog!')}\n\n${chalk.cyan('What the agent did:')}\n• Analyzed your Next.js project structure (${routerType} router)\n• Created and configured PostHog initializers\n• Integrated PostHog into your application\n${changes.map((change) => `• ${change}`).join('\\n')}\n\n${chalk.yellow('Next steps:')}\n• Start your development server to see PostHog in action\n• Visit your PostHog dashboard to see incoming events\n${nextSteps.map((step) => `• ${step}`).join('\\n')}\n\nLearn more about PostHog + Next.js: ${chalk.cyan(\n    'https://posthog.com/docs/libraries/next-js',\n  )}\n${continueUrl ? `\\nContinue onboarding: ${chalk.cyan(continueUrl)}\\n` : ``}\n${chalk.dim(\n  'Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.',\n)}\n\n${chalk.dim(`How did this work for you? Drop me a line: danilo@posthog.com`)}`;\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n\nfunction buildIntegrationPrompt(context: {\n  framework: string;\n  version: string;\n  router: string;\n  typescript: boolean;\n  projectApiKey: string;\n  host: string;\n}): string {\n  return `You have access to the PostHog MCP server which provides an integration resource to integrate PostHog into this ${\n    context.framework\n  } project.\n\nProject context:\n- Framework: ${context.framework} ${context.version}\n- Router: ${context.router}\n- TypeScript: ${context.typescript ? 'Yes' : 'No'}\n- PostHog API Key: ${context.projectApiKey}\n- PostHog Host: ${context.host}\n\nInstructions:\n1. Call the PostHog MCP's resource for setup: posthog://integration/workflow/setup/begin\n2. Follow all instructions provided\n\nThe PostHog MCP will provide specific integration code and instructions. Please follow them carefully. Be sure to look for lockfiles to determine the appropriate package manager to use when installing PostHog. Do not manually edit the package.json file.\n`;\n}\n"]}
+{"version":3,"file":"nextjs-wizard-agent.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard-agent.ts"],"names":[],"mappings":";;AAyFA,oDAQC;AA9FD,0CAAiD;AACjD,sDAAqD;AACrD,gDAA+C;AAC/C,wDAA0D;AAC1D,mCAKiB;AAEjB;;GAEG;AACH,MAAM,mBAAmB,GAAoB;IAC3C,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uBAAW,CAAC,MAAM;QAC/B,OAAO,EAAE,4CAA4C;QACrD,YAAY,EACV,wKAAwK;QAC1K,aAAa,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YAC9C,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,MAAM;QACnB,kBAAkB,EAAE,SAAS;QAC7B,UAAU,EAAE,CAAC,WAAgB,EAAE,EAAE,CAAC,IAAA,gCAAiB,EAAC,MAAM,EAAE,WAAW,CAAC;QACxE,gBAAgB,EAAE,8BAAsB;KACzC;IAED,WAAW,EAAE;QACX,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7B,uBAAuB,EAAE,MAAM;YAC/B,wBAAwB,EAAE,IAAI;SAC/B,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,CAAC,OAAY,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAsB,CAAC;YAC9C,OAAO;gBACL,MAAM,EAAE,MAAM,KAAK,oBAAY,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;aAC7D,CAAC;QACJ,CAAC;KACF;IAED,OAAO,EAAE;QACP,yBAAyB,EAAE,CAAC,OAAY,EAAE,EAAE;YAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAsB,CAAC;YAC9C,MAAM,UAAU,GAAG,MAAM,KAAK,oBAAY,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YACxE,OAAO,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;QACnC,CAAC;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,wCAAwC;QACxD,cAAc,EACZ,mEAAmE;QACrE,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,CAAC,OAAY,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAsB,CAAC;YAC9C,MAAM,UAAU,GAAG,IAAA,2BAAmB,EAAC,MAAM,CAAC,CAAC;YAC/C,OAAO;gBACL,4CAA4C,UAAU,GAAG;gBACzD,6CAA6C;gBAC7C,0CAA0C;aAC3C,CAAC;QACJ,CAAC;QACD,iBAAiB,EAAE,GAAG,EAAE;YACtB,OAAO;gBACL,wDAAwD;gBACxD,qDAAqD;aACtD,CAAC;QACJ,CAAC;KACF;CACF,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAsB;IAEtB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAA,uBAAe,GAAE,CAAC;IACpB,CAAC;IAED,MAAM,IAAA,6BAAc,EAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC","sourcesContent":["/* Simplified Next.js wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { enableDebugLogs } from '../utils/debug';\nimport { runAgentWizard } from '../lib/agent-runner';\nimport { Integration } from '../lib/constants';\nimport { getPackageVersion } from '../utils/package-json';\nimport {\n  getNextJsRouter,\n  getNextJsVersionBucket,\n  getNextJsRouterName,\n  NextJsRouter,\n} from './utils';\n\n/**\n * Next.js framework configuration for the universal agent runner.\n */\nconst NEXTJS_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'Next.js',\n    integration: Integration.nextjs,\n    docsUrl: 'https://posthog.com/docs/libraries/next-js',\n    abortMessage:\n      'This wizard uses an LLM agent to intelligently modify your project. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',\n    gatherContext: async (options: WizardOptions) => {\n      const router = await getNextJsRouter(options);\n      return { router };\n    },\n  },\n\n  detection: {\n    packageName: 'next',\n    packageDisplayName: 'Next.js',\n    getVersion: (packageJson: any) => getPackageVersion('next', packageJson),\n    getVersionBucket: getNextJsVersionBucket,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey, host) => ({\n      NEXT_PUBLIC_POSTHOG_KEY: apiKey,\n      NEXT_PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => {\n      const router = context.router as NextJsRouter;\n      return {\n        router: router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',\n      };\n    },\n  },\n\n  prompts: {\n    getAdditionalContextLines: (context: any) => {\n      const router = context.router as NextJsRouter;\n      const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n      return [`Router: ${routerType}`];\n    },\n  },\n\n  ui: {\n    welcomeMessage: 'PostHog Next.js wizard (agent-powered)',\n    spinnerMessage:\n      'Writing your PostHog setup with events, error capture and more...',\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: (context: any) => {\n      const router = context.router as NextJsRouter;\n      const routerName = getNextJsRouterName(router);\n      return [\n        `Analyzed your Next.js project structure (${routerName})`,\n        `Created and configured PostHog initializers`,\n        `Integrated PostHog into your application`,\n      ];\n    },\n    getOutroNextSteps: () => {\n      return [\n        'Start your development server to see PostHog in action',\n        'Visit your PostHog dashboard to see incoming events',\n      ];\n    },\n  },\n};\n\n/**\n * Next.js wizard powered by the universal agent runner.\n */\nexport async function runNextjsWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  await runAgentWizard(NEXTJS_AGENT_CONFIG, options);\n}\n"]}

package/dist/src/utils/__tests__/analytics.test.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const analytics_1 = require("../analytics");
 const posthog_node_1 = require("posthog-node");
 const uuid_1 = require("uuid");
+const constants_1 = require("../../lib/constants");
 jest.mock('posthog-node');
 jest.mock('uuid');
 const mockUuidv4 = uuid_1.v4;
@@ -28,7 +29,7 @@ describe('Analytics', () => {
             const properties = { integration: 'nextjs' };
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
                 ...properties,
             });
@@ -39,7 +40,7 @@ describe('Analytics', () => {
             analytics.setTag('testTag', 'testValue');
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
                 testTag: 'testValue',
                 ...properties,
@@ -51,7 +52,7 @@ describe('Analytics', () => {
             analytics.setDistinctId(distinctId);
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, distinctId, {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
             });
         });
@@ -59,7 +60,7 @@ describe('Analytics', () => {
             const error = new Error('Test error');
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
             });
         });
@@ -70,7 +71,7 @@ describe('Analytics', () => {
             analytics.setTag('version', '1.0.0');
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
                 environment: 'test',
                 version: '1.0.0',
@@ -84,16 +85,16 @@ describe('Analytics', () => {
             analytics.setTag('integration', 'nextjs');
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
                 integration: 'react',
             });
         });
-        it('should always include team:growth property in exceptions', () => {
+        it('should always include team property in exceptions', () => {
             const error = new Error('Test error');
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
             });
         });
@@ -109,7 +110,7 @@ describe('Analytics', () => {
                 step: 'wizard-execution',
             });
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
                 integration: 'nextjs',
                 forceInstall: true,
@@ -125,7 +126,7 @@ describe('Analytics', () => {
             analytics.setTag('integration', 'svelte');
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, distinctId, {
-                team: 'growth',
+                team: constants_1.ANALYTICS_TEAM_TAG,
                 $app_name: 'wizard',
                 integration: 'svelte',
             });

package/dist/src/utils/__tests__/analytics.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/analytics.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Analytics } from '../analytics';\nimport { PostHog } from 'posthog-node';\nimport { v4 as uuidv4 } from 'uuid';\n\njest.mock('posthog-node');\njest.mock('uuid');\n\nconst mockUuidv4 = uuidv4 as jest.MockedFunction<typeof uuidv4>;\nconst MockedPostHog = PostHog as jest.MockedClass<typeof PostHog>;\n\ndescribe('Analytics', () => {\n  let analytics: Analytics;\n  let mockPostHogInstance: jest.Mocked<PostHog>;\n\n  beforeEach(() => {\n    jest.clearAllMocks();\n    mockUuidv4.mockReturnValue('test-uuid' as any);\n\n    mockPostHogInstance = {\n      capture: jest.fn(),\n      captureException: jest.fn(),\n      alias: jest.fn(),\n      shutdown: jest.fn().mockResolvedValue(undefined),\n    } as any;\n\n    MockedPostHog.mockImplementation(() => mockPostHogInstance);\n\n    analytics = new Analytics();\n  });\n\n  describe('captureException', () => {\n    it('should capture exception with error object and properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with tags included in properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.setTag('testTag', 'testValue');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          testTag: 'testValue',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with distinct ID when set', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-123';\n\n      analytics.setDistinctId(distinctId);\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n        },\n      );\n    });\n\n    it('should capture exception without properties when not provided', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n        },\n      );\n    });\n\n    it('should merge tags with provided properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs', step: 'installation' };\n\n      analytics.setTag('environment', 'test');\n      analytics.setTag('version', '1.0.0');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          environment: 'test',\n          version: '1.0.0',\n          integration: 'nextjs',\n          step: 'installation',\n        },\n      );\n    });\n\n    it('should override tags with properties when keys conflict', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'react' };\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          integration: 'react',\n        },\n      );\n    });\n\n    it('should always include team:growth property in exceptions', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n        },\n      );\n    });\n  });\n\n  describe('integration with other methods', () => {\n    it('should work correctly with setTag and captureException', () => {\n      const error = new Error('Test error');\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.setTag('forceInstall', true);\n      analytics.setTag('debug', false);\n\n      analytics.captureException(error, {\n        arguments: JSON.stringify({ installDir: '/test' }),\n        step: 'wizard-execution',\n      });\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          integration: 'nextjs',\n          forceInstall: true,\n          debug: false,\n          arguments: JSON.stringify({ installDir: '/test' }),\n          step: 'wizard-execution',\n        },\n      );\n    });\n\n    it('should work correctly with setDistinctId and captureException', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-456';\n\n      analytics.setDistinctId(distinctId);\n      analytics.setTag('integration', 'svelte');\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          integration: 'svelte',\n        },\n      );\n    });\n  });\n});\n"]}
+{"version":3,"file":"analytics.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/analytics.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Analytics } from '../analytics';\nimport { PostHog } from 'posthog-node';\nimport { v4 as uuidv4 } from 'uuid';\nimport { ANALYTICS_TEAM_TAG } from '../../lib/constants';\n\njest.mock('posthog-node');\njest.mock('uuid');\n\nconst mockUuidv4 = uuidv4 as jest.MockedFunction<typeof uuidv4>;\nconst MockedPostHog = PostHog as jest.MockedClass<typeof PostHog>;\n\ndescribe('Analytics', () => {\n  let analytics: Analytics;\n  let mockPostHogInstance: jest.Mocked<PostHog>;\n\n  beforeEach(() => {\n    jest.clearAllMocks();\n    mockUuidv4.mockReturnValue('test-uuid' as any);\n\n    mockPostHogInstance = {\n      capture: jest.fn(),\n      captureException: jest.fn(),\n      alias: jest.fn(),\n      shutdown: jest.fn().mockResolvedValue(undefined),\n    } as any;\n\n    MockedPostHog.mockImplementation(() => mockPostHogInstance);\n\n    analytics = new Analytics();\n  });\n\n  describe('captureException', () => {\n    it('should capture exception with error object and properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with tags included in properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.setTag('testTag', 'testValue');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n          testTag: 'testValue',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with distinct ID when set', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-123';\n\n      analytics.setDistinctId(distinctId);\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n        },\n      );\n    });\n\n    it('should capture exception without properties when not provided', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n        },\n      );\n    });\n\n    it('should merge tags with provided properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs', step: 'installation' };\n\n      analytics.setTag('environment', 'test');\n      analytics.setTag('version', '1.0.0');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n          environment: 'test',\n          version: '1.0.0',\n          integration: 'nextjs',\n          step: 'installation',\n        },\n      );\n    });\n\n    it('should override tags with properties when keys conflict', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'react' };\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n          integration: 'react',\n        },\n      );\n    });\n\n    it('should always include team property in exceptions', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n        },\n      );\n    });\n  });\n\n  describe('integration with other methods', () => {\n    it('should work correctly with setTag and captureException', () => {\n      const error = new Error('Test error');\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.setTag('forceInstall', true);\n      analytics.setTag('debug', false);\n\n      analytics.captureException(error, {\n        arguments: JSON.stringify({ installDir: '/test' }),\n        step: 'wizard-execution',\n      });\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n          integration: 'nextjs',\n          forceInstall: true,\n          debug: false,\n          arguments: JSON.stringify({ installDir: '/test' }),\n          step: 'wizard-execution',\n        },\n      );\n    });\n\n    it('should work correctly with setDistinctId and captureException', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-456';\n\n      analytics.setDistinctId(distinctId);\n      analytics.setTag('integration', 'svelte');\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: ANALYTICS_TEAM_TAG,\n          $app_name: 'wizard',\n          integration: 'svelte',\n        },\n      );\n    });\n  });\n});\n"]}

package/dist/src/utils/analytics.js

@@ -34,7 +34,7 @@ class Analytics {
     }
     captureException(error, properties = {}) {
         this.client.captureException(error, this.distinctId ?? this.anonymousId, {
-            team: 'growth',
+            team: constants_1.ANALYTICS_TEAM_TAG,
             ...this.tags,
             ...properties,
         });

package/dist/src/utils/analytics.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":"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","sourcesContent":["import { PostHog } from 'posthog-node';\nimport {\n  ANALYTICS_HOST_URL,\n  ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY,\n} from '../lib/constants';\nimport { v4 as uuidv4 } from 'uuid';\nimport { debug } from './debug';\nexport class Analytics {\n  private client: PostHog;\n  private tags: Record<string, string | boolean | number | null | undefined> =\n    {};\n  private distinctId?: string;\n  private anonymousId: string;\n  private appName = 'wizard';\n\n  constructor() {\n    this.client = new PostHog(ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {\n      host: ANALYTICS_HOST_URL,\n      flushAt: 1,\n      flushInterval: 0,\n      enableExceptionAutocapture: true,\n    });\n\n    this.tags = { $app_name: this.appName };\n\n    this.anonymousId = uuidv4();\n\n    this.distinctId = undefined;\n  }\n\n  setDistinctId(distinctId: string) {\n    this.distinctId = distinctId;\n    this.client.alias({\n      distinctId,\n      alias: this.anonymousId,\n    });\n  }\n\n  setTag(key: string, value: string | boolean | number | null | undefined) {\n    this.tags[key] = value;\n  }\n\n  captureException(error: Error, properties: Record<string, unknown> = {}) {\n    this.client.captureException(error, this.distinctId ?? this.anonymousId, {\n      team: 'growth',\n      ...this.tags,\n      ...properties,\n    });\n  }\n\n  capture(eventName: string, properties?: Record<string, unknown>) {\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: eventName,\n      properties: {\n        ...this.tags,\n        ...properties,\n      },\n    });\n  }\n\n  async getFeatureFlag(flagKey: string): Promise<string | boolean | undefined> {\n    try {\n      const distinctId = this.distinctId ?? this.anonymousId;\n      return await this.client.getFeatureFlag(flagKey, distinctId, {\n        sendFeatureFlagEvents: true,\n        personProperties: {\n          $app_name: this.appName,\n        },\n      });\n    } catch (error) {\n      debug('Failed to get feature flag:', flagKey, error);\n      return undefined;\n    }\n  }\n\n  async shutdown(status: 'success' | 'error' | 'cancelled') {\n    if (Object.keys(this.tags).length === 0) {\n      return;\n    }\n\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: 'setup wizard finished',\n      properties: {\n        status,\n        tags: this.tags,\n      },\n    });\n\n    await this.client.shutdown();\n  }\n}\n\nexport const analytics = new Analytics();\n"]}
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":"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","sourcesContent":["import { PostHog } from 'posthog-node';\nimport {\n  ANALYTICS_HOST_URL,\n  ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY,\n  ANALYTICS_TEAM_TAG,\n} from '../lib/constants';\nimport { v4 as uuidv4 } from 'uuid';\nimport { debug } from './debug';\nexport class Analytics {\n  private client: PostHog;\n  private tags: Record<string, string | boolean | number | null | undefined> =\n    {};\n  private distinctId?: string;\n  private anonymousId: string;\n  private appName = 'wizard';\n\n  constructor() {\n    this.client = new PostHog(ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {\n      host: ANALYTICS_HOST_URL,\n      flushAt: 1,\n      flushInterval: 0,\n      enableExceptionAutocapture: true,\n    });\n\n    this.tags = { $app_name: this.appName };\n\n    this.anonymousId = uuidv4();\n\n    this.distinctId = undefined;\n  }\n\n  setDistinctId(distinctId: string) {\n    this.distinctId = distinctId;\n    this.client.alias({\n      distinctId,\n      alias: this.anonymousId,\n    });\n  }\n\n  setTag(key: string, value: string | boolean | number | null | undefined) {\n    this.tags[key] = value;\n  }\n\n  captureException(error: Error, properties: Record<string, unknown> = {}) {\n    this.client.captureException(error, this.distinctId ?? this.anonymousId, {\n      team: ANALYTICS_TEAM_TAG,\n      ...this.tags,\n      ...properties,\n    });\n  }\n\n  capture(eventName: string, properties?: Record<string, unknown>) {\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: eventName,\n      properties: {\n        ...this.tags,\n        ...properties,\n      },\n    });\n  }\n\n  async getFeatureFlag(flagKey: string): Promise<string | boolean | undefined> {\n    try {\n      const distinctId = this.distinctId ?? this.anonymousId;\n      return await this.client.getFeatureFlag(flagKey, distinctId, {\n        sendFeatureFlagEvents: true,\n        personProperties: {\n          $app_name: this.appName,\n        },\n      });\n    } catch (error) {\n      debug('Failed to get feature flag:', flagKey, error);\n      return undefined;\n    }\n  }\n\n  async shutdown(status: 'success' | 'error' | 'cancelled') {\n    if (Object.keys(this.tags).length === 0) {\n      return;\n    }\n\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: 'setup wizard finished',\n      properties: {\n        status,\n        tags: this.tags,\n      },\n    });\n\n    await this.client.shutdown();\n  }\n}\n\nexport const analytics = new Analytics();\n"]}

package/dist/src/utils/oauth.js

@@ -48,6 +48,28 @@ const constants_1 = require("../lib/constants");
 const clack_utils_1 = require("./clack-utils");
 const analytics_1 = require("./analytics");
 const urls_1 = require("./urls");
+const OAUTH_CALLBACK_STYLES = `
+  <style>
+    * {
+      font-family: monospace;
+      background-color: #1b0a00;
+      color: #F7A502;
+      font-weight: medium;
+      font-size: 24px;
+      margin: .25rem;
+    }
+
+    .blink {
+      animation: blink-animation 1s steps(2, start) infinite;
+    }
+
+    @keyframes blink-animation {
+      to {
+        opacity: 0;
+      }
+    }
+  </style>
+`;
 const OAuthTokenResponseSchema = zod_1.z.object({
     access_token: zod_1.z.string(),
     expires_in: zod_1.z.number(),
@@ -90,10 +112,15 @@ async function startCallbackServer(authUrl, signupUrl) {
             if (error) {
                 const isAccessDenied = error === 'access_denied';
                 res.writeHead(isAccessDenied ? 200 : 400, {
-                    'Content-Type': 'text/html',
+                    'Content-Type': 'text/html; charset=utf-8',
                 });
                 res.end(`
           <html>
+            <head>
+              <meta charset="UTF-8">
+              <title>PostHog wizard - Authorization ${isAccessDenied ? 'cancelled' : 'failed'}</title>
+              ${OAUTH_CALLBACK_STYLES}
+            </head>
             <body>
               <p>${isAccessDenied
                     ? 'Authorization cancelled.'
@@ -107,11 +134,17 @@ async function startCallbackServer(authUrl, signupUrl) {
                 return;
             }
             if (code) {
-                res.writeHead(200, { 'Content-Type': 'text/html' });
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
                 res.end(`
           <html>
+            <head>
+              <meta charset="UTF-8">
+              <title>PostHog wizard is ready</title>
+              ${OAUTH_CALLBACK_STYLES}
+            </head>
             <body>
-              <p>Authorization successful! Return to your terminal.</p>
+              <p>PostHog login complete!</p>
+              <p>Return to your terminal: the wizard is hard at work on your project<span class="blink">█</span></p>
               <script>window.close();</script>
             </body>
           </html>
@@ -119,9 +152,14 @@ async function startCallbackServer(authUrl, signupUrl) {
                 callbackResolve(code);
             }
             else {
-                res.writeHead(400, { 'Content-Type': 'text/html' });
+                res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
                 res.end(`
           <html>
+            <head>
+              <meta charset="UTF-8">
+              <title>PostHog wizard - Invalid request</title>
+              ${OAUTH_CALLBACK_STYLES}
+            </head>
             <body>
               <p>Invalid request - no authorization code received.</p>
               <p>You can close this window.</p>