@posthog/wizard 1.31.1 → 1.32.0

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

@@ -3,19 +3,23 @@ import type { WizardOptions } from '../utils/types';
 /**
  * Configuration interface for framework-specific agent integrations.
  * Each framework exports a FrameworkConfig that the universal runner uses.
+ *
+ * The TContext generic represents the framework-specific context gathered
+ * before the agent runs (e.g., router type for Next.js, project type for Django).
+ * The runner threads this opaquely — all framework-specific logic stays inside the config.
  */
-export interface FrameworkConfig {
-    metadata: FrameworkMetadata;
+export interface FrameworkConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
+    metadata: FrameworkMetadata<TContext>;
     detection: FrameworkDetection;
     environment: EnvironmentConfig;
-    analytics: AnalyticsConfig;
-    prompts: PromptConfig;
-    ui: UIConfig;
+    analytics: AnalyticsConfig<TContext>;
+    prompts: PromptConfig<TContext>;
+    ui: UIConfig<TContext>;
 }
 /**
  * Basic framework information and documentation
  */
-export interface FrameworkMetadata {
+export interface FrameworkMetadata<TContext extends Record<string, unknown> = Record<string, unknown>> {
     /** Display name (e.g., "Next.js", "React") */
     name: string;
     /** Integration type from constants */
@@ -27,12 +31,20 @@ export interface FrameworkMetadata {
      * If not provided, defaults to docsUrl.
      */
     unsupportedVersionDocsUrl?: string;
+    /** If true, shows a beta notice before running the wizard. */
+    beta?: boolean;
+    /** Optional notice shown before the agent runs (e.g., "Close Xcode before proceeding"). */
+    preRunNotice?: 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>>;
+    gatherContext?: (options: WizardOptions) => Promise<TContext>;
+    /** Optional additional MCP servers for this framework (e.g., Svelte MCP). */
+    additionalMcpServers?: Record<string, {
+        url: string;
+    }>;
 }
 /**
  * Framework detection and version handling
@@ -43,7 +55,7 @@ export interface FrameworkDetection {
     /** Human-readable name for error messages (e.g., "Next.js") */
     packageDisplayName: string;
     /** Extract version from package.json */
-    getVersion: (packageJson: any) => string | undefined;
+    getVersion: (packageJson: unknown) => string | undefined;
     /** Optional: Convert version to analytics bucket (e.g., "15.x") */
     getVersionBucket?: (version: string) => string;
     /**
@@ -52,6 +64,12 @@ export interface FrameworkDetection {
      * Defaults to true if not specified.
      */
     usesPackageJson?: boolean;
+    /** Minimum supported version. If set, runner checks before proceeding. */
+    minimumVersion?: string;
+    /** Get the currently installed version. Called by runner for version check. */
+    getInstalledVersion?: (options: WizardOptions) => Promise<string | undefined>;
+    /** Detect whether this framework is present in the project. */
+    detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<boolean>;
 }
 /**
  * Environment variable configuration
@@ -68,22 +86,22 @@ export interface EnvironmentConfig {
 /**
  * Analytics configuration
  */
-export interface AnalyticsConfig {
+export interface AnalyticsConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
     /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */
-    getTags: (context: any) => Record<string, any>;
+    getTags: (context: TContext) => Record<string, string>;
     /** Optional: Additional event properties */
-    getEventProperties?: (context: any) => Record<string, any>;
+    getEventProperties?: (context: TContext) => Record<string, string>;
 }
 /**
  * Prompt configuration
  */
-export interface PromptConfig {
+export interface PromptConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
     /**
      * Optional: Additional context lines to append to base prompt
      * For Next.js: "- Router: app"
      * For React Native: "- Platform: Expo"
      */
-    getAdditionalContextLines?: (context: any) => string[];
+    getAdditionalContextLines?: (context: TContext) => string[];
     /**
      * How to detect the project type for this framework.
      * e.g., "Look for package.json and lockfiles" or "Look for requirements.txt and manage.py"
@@ -98,15 +116,15 @@ export interface PromptConfig {
 /**
  * UI messaging configuration
  */
-export interface UIConfig {
+export interface UIConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
     /** 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[];
+    getOutroChanges: (context: TContext) => string[];
     /** Generate "Next steps" bullets from context */
-    getOutroNextSteps: (context: any) => string[];
+    getOutroNextSteps: (context: TContext) => string[];
 }
 /**
  * Generate welcome message from framework name

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

@@ -1 +1 @@
-{"version":3,"file":"framework-config.js","sourceRoot":"","sources":["../../../src/lib/framework-config.ts"],"names":[],"mappings":";;;AAwIA,8CAEC;AALD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,aAAqB;IACrD,OAAO,WAAW,aAAa,yBAAyB,CAAC;AAC3D,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAC1B,mEAAmE,CAAC","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  /**\n   * Optional URL to docs for users with unsupported framework versions.\n   * If not provided, defaults to docsUrl.\n   */\n  unsupportedVersionDocsUrl?: 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   * Whether this framework uses package.json (Node.js/JavaScript).\n   * If false, skips package.json checks (for Python, Go, etc.)\n   * Defaults to true if not specified.\n   */\n  usesPackageJson?: boolean;\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   * How to detect the project type for this framework.\n   * e.g., \"Look for package.json and lockfiles\" or \"Look for requirements.txt and manage.py\"\n   */\n  projectTypeDetection: string;\n\n  /**\n   * How to install packages for this framework.\n   * e.g., \"Use npm/yarn/pnpm based on lockfile\" or \"Use pip/poetry based on config files\"\n   */\n  packageInstallation: string;\n}\n\n/**\n * UI messaging configuration\n */\nexport interface UIConfig {\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\n/**\n * Generate welcome message from framework name\n */\nexport function getWelcomeMessage(frameworkName: string): string {\n  return `PostHog ${frameworkName} wizard (agent-powered)`;\n}\n\n/**\n * Shared spinner message for all frameworks\n */\nexport const SPINNER_MESSAGE =\n  'Writing your PostHog setup with events, error capture and more...';\n"]}
+{"version":3,"file":"framework-config.js","sourceRoot":"","sources":["../../../src/lib/framework-config.ts"],"names":[],"mappings":";;;AAwKA,8CAEC;AALD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,aAAqB;IACrD,OAAO,WAAW,aAAa,yBAAyB,CAAC;AAC3D,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAC1B,mEAAmE,CAAC","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 *\n * The TContext generic represents the framework-specific context gathered\n * before the agent runs (e.g., router type for Next.js, project type for Django).\n * The runner threads this opaquely — all framework-specific logic stays inside the config.\n */\nexport interface FrameworkConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  metadata: FrameworkMetadata<TContext>;\n  detection: FrameworkDetection;\n  environment: EnvironmentConfig;\n  analytics: AnalyticsConfig<TContext>;\n  prompts: PromptConfig<TContext>;\n  ui: UIConfig<TContext>;\n}\n\n/**\n * Basic framework information and documentation\n */\nexport interface FrameworkMetadata<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\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  /**\n   * Optional URL to docs for users with unsupported framework versions.\n   * If not provided, defaults to docsUrl.\n   */\n  unsupportedVersionDocsUrl?: string;\n\n  /** If true, shows a beta notice before running the wizard. */\n  beta?: boolean;\n\n  /** Optional notice shown before the agent runs (e.g., \"Close Xcode before proceeding\"). */\n  preRunNotice?: 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<TContext>;\n\n  /** Optional additional MCP servers for this framework (e.g., Svelte MCP). */\n  additionalMcpServers?: Record<string, { url: string }>;\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: unknown) => string | undefined;\n\n  /** Optional: Convert version to analytics bucket (e.g., \"15.x\") */\n  getVersionBucket?: (version: string) => string;\n\n  /**\n   * Whether this framework uses package.json (Node.js/JavaScript).\n   * If false, skips package.json checks (for Python, Go, etc.)\n   * Defaults to true if not specified.\n   */\n  usesPackageJson?: boolean;\n\n  /** Minimum supported version. If set, runner checks before proceeding. */\n  minimumVersion?: string;\n\n  /** Get the currently installed version. Called by runner for version check. */\n  getInstalledVersion?: (options: WizardOptions) => Promise<string | undefined>;\n\n  /** Detect whether this framework is present in the project. */\n  detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<boolean>;\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  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */\n  getTags: (context: TContext) => Record<string, string>;\n\n  /** Optional: Additional event properties */\n  getEventProperties?: (context: TContext) => Record<string, string>;\n}\n\n/**\n * Prompt configuration\n */\nexport interface PromptConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\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: TContext) => string[];\n\n  /**\n   * How to detect the project type for this framework.\n   * e.g., \"Look for package.json and lockfiles\" or \"Look for requirements.txt and manage.py\"\n   */\n  projectTypeDetection: string;\n\n  /**\n   * How to install packages for this framework.\n   * e.g., \"Use npm/yarn/pnpm based on lockfile\" or \"Use pip/poetry based on config files\"\n   */\n  packageInstallation: string;\n}\n\n/**\n * UI messaging configuration\n */\nexport interface UIConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\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: TContext) => string[];\n\n  /** Generate \"Next steps\" bullets from context */\n  getOutroNextSteps: (context: TContext) => string[];\n}\n\n/**\n * Generate welcome message from framework name\n */\nexport function getWelcomeMessage(frameworkName: string): string {\n  return `PostHog ${frameworkName} wizard (agent-powered)`;\n}\n\n/**\n * Shared spinner message for all frameworks\n */\nexport const SPINNER_MESSAGE =\n  'Writing your PostHog setup with events, error capture and more...';\n"]}

package/dist/src/lib/registry.d.ts

@@ -0,0 +1,3 @@
+import type { FrameworkConfig } from './framework-config';
+import { Integration } from './constants';
+export declare const FRAMEWORK_REGISTRY: Record<Integration, FrameworkConfig>;

package/dist/src/lib/registry.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRAMEWORK_REGISTRY = void 0;
+const constants_1 = require("./constants");
+const nextjs_wizard_agent_1 = require("../nextjs/nextjs-wizard-agent");
+const nuxt_wizard_agent_1 = require("../nuxt/nuxt-wizard-agent");
+const vue_wizard_agent_1 = require("../vue/vue-wizard-agent");
+const react_router_wizard_agent_1 = require("../react-router/react-router-wizard-agent");
+const tanstack_router_wizard_agent_1 = require("../tanstack-router/tanstack-router-wizard-agent");
+const tanstack_start_wizard_agent_1 = require("../tanstack-start/tanstack-start-wizard-agent");
+const react_native_wizard_agent_1 = require("../react-native/react-native-wizard-agent");
+const angular_wizard_agent_1 = require("../angular/angular-wizard-agent");
+const astro_wizard_agent_1 = require("../astro/astro-wizard-agent");
+const django_wizard_agent_1 = require("../django/django-wizard-agent");
+const flask_wizard_agent_1 = require("../flask/flask-wizard-agent");
+const fastapi_wizard_agent_1 = require("../fastapi/fastapi-wizard-agent");
+const laravel_wizard_agent_1 = require("../laravel/laravel-wizard-agent");
+const svelte_wizard_agent_1 = require("../svelte/svelte-wizard-agent");
+const swift_wizard_agent_1 = require("../swift/swift-wizard-agent");
+const android_wizard_agent_1 = require("../android/android-wizard-agent");
+const python_wizard_agent_1 = require("../python/python-wizard-agent");
+exports.FRAMEWORK_REGISTRY = {
+    [constants_1.Integration.nextjs]: nextjs_wizard_agent_1.NEXTJS_AGENT_CONFIG,
+    [constants_1.Integration.nuxt]: nuxt_wizard_agent_1.NUXT_AGENT_CONFIG,
+    [constants_1.Integration.vue]: vue_wizard_agent_1.VUE_AGENT_CONFIG,
+    [constants_1.Integration.tanstackStart]: tanstack_start_wizard_agent_1.TANSTACK_START_AGENT_CONFIG,
+    [constants_1.Integration.reactRouter]: react_router_wizard_agent_1.REACT_ROUTER_AGENT_CONFIG,
+    [constants_1.Integration.tanstackRouter]: tanstack_router_wizard_agent_1.TANSTACK_ROUTER_AGENT_CONFIG,
+    [constants_1.Integration.reactNative]: react_native_wizard_agent_1.REACT_NATIVE_AGENT_CONFIG,
+    [constants_1.Integration.angular]: angular_wizard_agent_1.ANGULAR_AGENT_CONFIG,
+    [constants_1.Integration.astro]: astro_wizard_agent_1.ASTRO_AGENT_CONFIG,
+    [constants_1.Integration.django]: django_wizard_agent_1.DJANGO_AGENT_CONFIG,
+    [constants_1.Integration.flask]: flask_wizard_agent_1.FLASK_AGENT_CONFIG,
+    [constants_1.Integration.fastapi]: fastapi_wizard_agent_1.FASTAPI_AGENT_CONFIG,
+    [constants_1.Integration.laravel]: laravel_wizard_agent_1.LARAVEL_AGENT_CONFIG,
+    [constants_1.Integration.sveltekit]: svelte_wizard_agent_1.SVELTEKIT_AGENT_CONFIG,
+    [constants_1.Integration.swift]: swift_wizard_agent_1.SWIFT_AGENT_CONFIG,
+    [constants_1.Integration.android]: android_wizard_agent_1.ANDROID_AGENT_CONFIG,
+    [constants_1.Integration.python]: python_wizard_agent_1.PYTHON_AGENT_CONFIG,
+};
+//# sourceMappingURL=registry.js.map

package/dist/src/lib/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/registry.ts"],"names":[],"mappings":";;;AACA,2CAA0C;AAC1C,uEAAoE;AACpE,iEAA8D;AAC9D,8DAA2D;AAC3D,yFAAsF;AACtF,kGAA+F;AAC/F,+FAA4F;AAC5F,yFAAsF;AACtF,0EAAuE;AACvE,oEAAiE;AACjE,uEAAoE;AACpE,oEAAiE;AACjE,0EAAuE;AACvE,0EAAuE;AACvE,uEAAuE;AACvE,oEAAiE;AACjE,0EAAuE;AACvE,uEAAoE;AAEvD,QAAA,kBAAkB,GAAyC;IACtE,CAAC,uBAAW,CAAC,MAAM,CAAC,EAAE,yCAAmB;IACzC,CAAC,uBAAW,CAAC,IAAI,CAAC,EAAE,qCAAiB;IACrC,CAAC,uBAAW,CAAC,GAAG,CAAC,EAAE,mCAAgB;IACnC,CAAC,uBAAW,CAAC,aAAa,CAAC,EAAE,yDAA2B;IACxD,CAAC,uBAAW,CAAC,WAAW,CAAC,EAAE,qDAAyB;IACpD,CAAC,uBAAW,CAAC,cAAc,CAAC,EAAE,2DAA4B;IAC1D,CAAC,uBAAW,CAAC,WAAW,CAAC,EAAE,qDAAyB;IACpD,CAAC,uBAAW,CAAC,OAAO,CAAC,EAAE,2CAAoB;IAC3C,CAAC,uBAAW,CAAC,KAAK,CAAC,EAAE,uCAAkB;IACvC,CAAC,uBAAW,CAAC,MAAM,CAAC,EAAE,yCAAmB;IACzC,CAAC,uBAAW,CAAC,KAAK,CAAC,EAAE,uCAAkB;IACvC,CAAC,uBAAW,CAAC,OAAO,CAAC,EAAE,2CAAoB;IAC3C,CAAC,uBAAW,CAAC,OAAO,CAAC,EAAE,2CAAoB;IAC3C,CAAC,uBAAW,CAAC,SAAS,CAAC,EAAE,4CAAsB;IAC/C,CAAC,uBAAW,CAAC,KAAK,CAAC,EAAE,uCAAkB;IACvC,CAAC,uBAAW,CAAC,OAAO,CAAC,EAAE,2CAAoB;IAC3C,CAAC,uBAAW,CAAC,MAAM,CAAC,EAAE,yCAAmB;CAC1C,CAAC","sourcesContent":["import type { FrameworkConfig } from './framework-config';\nimport { Integration } from './constants';\nimport { NEXTJS_AGENT_CONFIG } from '../nextjs/nextjs-wizard-agent';\nimport { NUXT_AGENT_CONFIG } from '../nuxt/nuxt-wizard-agent';\nimport { VUE_AGENT_CONFIG } from '../vue/vue-wizard-agent';\nimport { REACT_ROUTER_AGENT_CONFIG } from '../react-router/react-router-wizard-agent';\nimport { TANSTACK_ROUTER_AGENT_CONFIG } from '../tanstack-router/tanstack-router-wizard-agent';\nimport { TANSTACK_START_AGENT_CONFIG } from '../tanstack-start/tanstack-start-wizard-agent';\nimport { REACT_NATIVE_AGENT_CONFIG } from '../react-native/react-native-wizard-agent';\nimport { ANGULAR_AGENT_CONFIG } from '../angular/angular-wizard-agent';\nimport { ASTRO_AGENT_CONFIG } from '../astro/astro-wizard-agent';\nimport { DJANGO_AGENT_CONFIG } from '../django/django-wizard-agent';\nimport { FLASK_AGENT_CONFIG } from '../flask/flask-wizard-agent';\nimport { FASTAPI_AGENT_CONFIG } from '../fastapi/fastapi-wizard-agent';\nimport { LARAVEL_AGENT_CONFIG } from '../laravel/laravel-wizard-agent';\nimport { SVELTEKIT_AGENT_CONFIG } from '../svelte/svelte-wizard-agent';\nimport { SWIFT_AGENT_CONFIG } from '../swift/swift-wizard-agent';\nimport { ANDROID_AGENT_CONFIG } from '../android/android-wizard-agent';\nimport { PYTHON_AGENT_CONFIG } from '../python/python-wizard-agent';\n\nexport const FRAMEWORK_REGISTRY: Record<Integration, FrameworkConfig> = {\n  [Integration.nextjs]: NEXTJS_AGENT_CONFIG,\n  [Integration.nuxt]: NUXT_AGENT_CONFIG,\n  [Integration.vue]: VUE_AGENT_CONFIG,\n  [Integration.tanstackStart]: TANSTACK_START_AGENT_CONFIG,\n  [Integration.reactRouter]: REACT_ROUTER_AGENT_CONFIG,\n  [Integration.tanstackRouter]: TANSTACK_ROUTER_AGENT_CONFIG,\n  [Integration.reactNative]: REACT_NATIVE_AGENT_CONFIG,\n  [Integration.angular]: ANGULAR_AGENT_CONFIG,\n  [Integration.astro]: ASTRO_AGENT_CONFIG,\n  [Integration.django]: DJANGO_AGENT_CONFIG,\n  [Integration.flask]: FLASK_AGENT_CONFIG,\n  [Integration.fastapi]: FASTAPI_AGENT_CONFIG,\n  [Integration.laravel]: LARAVEL_AGENT_CONFIG,\n  [Integration.sveltekit]: SVELTEKIT_AGENT_CONFIG,\n  [Integration.swift]: SWIFT_AGENT_CONFIG,\n  [Integration.android]: ANDROID_AGENT_CONFIG,\n  [Integration.python]: PYTHON_AGENT_CONFIG,\n};\n"]}

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

@@ -1,5 +1,7 @@
-import type { WizardOptions } from '../utils/types';
-/**
- * Next.js wizard powered by the universal agent runner.
- */
-export declare function runNextjsWizardAgent(options: WizardOptions): Promise<void>;
+import type { FrameworkConfig } from '../lib/framework-config';
+import { NextJsRouter } from './utils';
+type NextjsContext = {
+    router?: NextJsRouter;
+};
+export declare const NEXTJS_AGENT_CONFIG: FrameworkConfig<NextjsContext>;
+export {};

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

@@ -1,56 +1,11 @@
 "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.runNextjsWizardAgent = runNextjsWizardAgent;
-const debug_1 = require("../utils/debug");
-const agent_runner_1 = require("../lib/agent-runner");
+exports.NEXTJS_AGENT_CONFIG = void 0;
 const constants_1 = require("../lib/constants");
 const package_json_1 = require("../utils/package-json");
 const clack_utils_1 = require("../utils/clack-utils");
-const clack_1 = __importDefault(require("../utils/clack"));
-const chalk_1 = __importDefault(require("chalk"));
-const semver = __importStar(require("semver"));
 const utils_1 = require("./utils");
-/**
- * Next.js framework configuration for the universal agent runner.
- */
-const MINIMUM_NEXTJS_VERSION = '15.3.0';
-const NEXTJS_AGENT_CONFIG = {
+exports.NEXTJS_AGENT_CONFIG = {
     metadata: {
         name: 'Next.js',
         integration: constants_1.Integration.nextjs,
@@ -66,6 +21,15 @@ const NEXTJS_AGENT_CONFIG = {
         packageDisplayName: 'Next.js',
         getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('next', packageJson),
         getVersionBucket: utils_1.getNextJsVersionBucket,
+        minimumVersion: '15.3.0',
+        getInstalledVersion: async (options) => {
+            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+            return (0, package_json_1.getPackageVersion)('next', packageJson);
+        },
+        detect: async (options) => {
+            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            return packageJson ? (0, package_json_1.hasPackageInstalled)('next', packageJson) : false;
+        },
     },
     environment: {
         uploadToHosting: true,
@@ -75,19 +39,15 @@ const NEXTJS_AGENT_CONFIG = {
         }),
     },
     analytics: {
-        getTags: (context) => {
-            const router = context.router;
-            return {
-                router: router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages',
-            };
-        },
+        getTags: (context) => ({
+            router: context.router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages',
+        }),
     },
     prompts: {
         projectTypeDetection: 'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',
         packageInstallation: 'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',
         getAdditionalContextLines: (context) => {
-            const router = context.router;
-            const routerType = router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages';
+            const routerType = context.router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages';
             return [`Router: ${routerType}`];
         },
     },
@@ -95,7 +55,7 @@ const NEXTJS_AGENT_CONFIG = {
         successMessage: 'PostHog integration complete',
         estimatedDurationMinutes: 8,
         getOutroChanges: (context) => {
-            const router = context.router;
+            const router = context.router ?? utils_1.NextJsRouter.APP_ROUTER;
             const routerName = (0, utils_1.getNextJsRouterName)(router);
             return [
                 `Analyzed your Next.js project structure (${routerName})`,
@@ -111,27 +71,4 @@ const NEXTJS_AGENT_CONFIG = {
         },
     },
 };
-/**
- * Next.js wizard powered by the universal agent runner.
- */
-async function runNextjsWizardAgent(options) {
-    if (options.debug) {
-        (0, debug_1.enableDebugLogs)();
-    }
-    // Check Next.js version - agent wizard requires >= 15.3.0
-    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-    const nextVersion = (0, package_json_1.getPackageVersion)('next', packageJson);
-    if (nextVersion) {
-        const coercedVersion = semver.coerce(nextVersion);
-        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_NEXTJS_VERSION)) {
-            const docsUrl = NEXTJS_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??
-                NEXTJS_AGENT_CONFIG.metadata.docsUrl;
-            clack_1.default.log.warn(`Sorry: the wizard can't help you with Next.js ${nextVersion}. Upgrade to Next.js ${MINIMUM_NEXTJS_VERSION} or later, or check out the manual setup guide.`);
-            clack_1.default.log.info(`Setup Next.js manually: ${chalk_1.default.cyan(docsUrl)}`);
-            clack_1.default.outro('PostHog wizard will see you next time!');
-            return;
-        }
-    }
-    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 type { WizardOptions } from '../utils/types';\nimport { enableDebugLogs } from '../utils/debug';\nimport { runAgentWizard } from '../lib/agent-runner';\nimport { Integration } from '../lib/constants';\nimport { getPackageVersion } from '../utils/package-json';\nimport { getPackageDotJson } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\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 MINIMUM_NEXTJS_VERSION = '15.3.0';\n\nconst NEXTJS_AGENT_CONFIG = {\n  metadata: {\n    name: 'Next.js',\n    integration: Integration.nextjs,\n    docsUrl: 'https://posthog.com/docs/libraries/next-js',\n    unsupportedVersionDocsUrl: '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: string, host: string) => ({\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    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',\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    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  // Check Next.js version - agent wizard requires >= 15.3.0\n  const packageJson = await getPackageDotJson(options);\n  const nextVersion = getPackageVersion('next', packageJson);\n\n  if (nextVersion) {\n    const coercedVersion = semver.coerce(nextVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_NEXTJS_VERSION)) {\n      const docsUrl =\n        NEXTJS_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??\n        NEXTJS_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with Next.js ${nextVersion}. Upgrade to Next.js ${MINIMUM_NEXTJS_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup Next.js manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('PostHog wizard will see you next time!');\n      return;\n    }\n  }\n\n  await runAgentWizard(NEXTJS_AGENT_CONFIG, options);\n}\n"]}
+{"version":3,"file":"nextjs-wizard-agent.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard-agent.ts"],"names":[],"mappings":";;;AAGA,gDAA+C;AAC/C,wDAI+B;AAC/B,sDAA4E;AAC5E,mCAKiB;AAMJ,QAAA,mBAAmB,GAAmC;IACjE,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uBAAW,CAAC,MAAM;QAC/B,OAAO,EAAE,4CAA4C;QACrD,yBAAyB,EAAE,4CAA4C;QACvE,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,WAAoB,EAAE,EAAE,CACnC,IAAA,gCAAiB,EAAC,MAAM,EAAE,WAA6B,CAAC;QAC1D,gBAAgB,EAAE,8BAAsB;QACxC,cAAc,EAAE,QAAQ;QACxB,mBAAmB,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,IAAA,gCAAiB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,WAAW,CAAC,CAAC,CAAC,IAAA,kCAAmB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,CAAC;KACF;IAED,WAAW,EAAE;QACX,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;YAC7C,uBAAuB,EAAE,MAAM;YAC/B,wBAAwB,EAAE,IAAI;SAC/B,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,oBAAY,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;SACrE,CAAC;KACH;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,oJAAoJ;QACtJ,mBAAmB,EACjB,gHAAgH;QAClH,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,UAAU,GACd,OAAO,CAAC,MAAM,KAAK,oBAAY,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/D,OAAO,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;QACnC,CAAC;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,oBAAY,CAAC,UAAU,CAAC;YACzD,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","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 { Integration } from '../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../utils/package-json';\nimport { getPackageDotJson, tryGetPackageJson } from '../utils/clack-utils';\nimport {\n  getNextJsRouter,\n  getNextJsVersionBucket,\n  getNextJsRouterName,\n  NextJsRouter,\n} from './utils';\n\ntype NextjsContext = {\n  router?: NextJsRouter;\n};\n\nexport const NEXTJS_AGENT_CONFIG: FrameworkConfig<NextjsContext> = {\n  metadata: {\n    name: 'Next.js',\n    integration: Integration.nextjs,\n    docsUrl: 'https://posthog.com/docs/libraries/next-js',\n    unsupportedVersionDocsUrl: '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: unknown) =>\n      getPackageVersion('next', packageJson as PackageDotJson),\n    getVersionBucket: getNextJsVersionBucket,\n    minimumVersion: '15.3.0',\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await getPackageDotJson(options);\n      return getPackageVersion('next', packageJson);\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? hasPackageInstalled('next', packageJson) : false;\n    },\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      NEXT_PUBLIC_POSTHOG_KEY: apiKey,\n      NEXT_PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      router: context.router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',\n    getAdditionalContextLines: (context) => {\n      const routerType =\n        context.router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n      return [`Router: ${routerType}`];\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: (context) => {\n      const router = context.router ?? NextJsRouter.APP_ROUTER;\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"]}

package/dist/src/nextjs/utils.d.ts

@@ -1,5 +1,5 @@
 import type { WizardOptions } from '../utils/types';
-export declare function getNextJsVersionBucket(version: string | undefined): string;
+export declare const getNextJsVersionBucket: (version: string | undefined) => string;
 export declare enum NextJsRouter {
     APP_ROUTER = "app-router",
     PAGES_ROUTER = "pages-router"

package/dist/src/nextjs/utils.js

@@ -3,33 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNextJsRouterName = exports.IGNORE_PATTERNS = exports.NextJsRouter = void 0;
-exports.getNextJsVersionBucket = getNextJsVersionBucket;
+exports.getNextJsRouterName = exports.IGNORE_PATTERNS = exports.NextJsRouter = exports.getNextJsVersionBucket = void 0;
 exports.getNextJsRouter = getNextJsRouter;
-const semver_1 = require("semver");
 const fast_glob_1 = __importDefault(require("fast-glob"));
 const clack_utils_1 = require("../utils/clack-utils");
 const clack_1 = __importDefault(require("../utils/clack"));
 const constants_1 = require("../lib/constants");
-function getNextJsVersionBucket(version) {
-    if (!version) {
-        return 'none';
-    }
-    try {
-        const minVer = (0, semver_1.minVersion)(version);
-        if (!minVer) {
-            return 'invalid';
-        }
-        const majorVersion = (0, semver_1.major)(minVer);
-        if (majorVersion >= 11) {
-            return `${majorVersion}.x`;
-        }
-        return '<11.0.0';
-    }
-    catch {
-        return 'unknown';
-    }
-}
+const semver_1 = require("../utils/semver");
+exports.getNextJsVersionBucket = (0, semver_1.createVersionBucket)();
 var NextJsRouter;
 (function (NextJsRouter) {
     NextJsRouter["APP_ROUTER"] = "app-router";

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/nextjs/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major, minVersion } from 'semver';\nimport fg from 'fast-glob';\nimport { abortIfCancelled } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\nimport { Integration } from '../lib/constants';\n\nexport function getNextJsVersionBucket(version: string | undefined) {\n  if (!version) {\n    return 'none';\n  }\n\n  try {\n    const minVer = minVersion(version);\n    if (!minVer) {\n      return 'invalid';\n    }\n    const majorVersion = major(minVer);\n    if (majorVersion >= 11) {\n      return `${majorVersion}.x`;\n    }\n    return '<11.0.0';\n  } catch {\n    return 'unknown';\n  }\n}\n\nexport enum NextJsRouter {\n  APP_ROUTER = 'app-router',\n  PAGES_ROUTER = 'pages-router',\n}\n\nexport const IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\nexport async function getNextJsRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter> {\n  const pagesMatches = await fg('**/pages/_app.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasPagesDir = pagesMatches.length > 0;\n\n  const appMatches = await fg('**/app/**/layout.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasAppDir = appMatches.length > 0;\n\n  if (hasPagesDir && !hasAppDir) {\n    clack.log.info(\n      `Detected ${getNextJsRouterName(NextJsRouter.PAGES_ROUTER)} 📃`,\n    );\n    return NextJsRouter.PAGES_ROUTER;\n  }\n\n  if (hasAppDir && !hasPagesDir) {\n    clack.log.info(\n      `Detected ${getNextJsRouterName(NextJsRouter.APP_ROUTER)} 📱`,\n    );\n    return NextJsRouter.APP_ROUTER;\n  }\n\n  const result: NextJsRouter = await abortIfCancelled(\n    clack.select({\n      message: 'What router are you using?',\n      options: [\n        {\n          label: getNextJsRouterName(NextJsRouter.APP_ROUTER),\n          value: NextJsRouter.APP_ROUTER,\n        },\n        {\n          label: getNextJsRouterName(NextJsRouter.PAGES_ROUTER),\n          value: NextJsRouter.PAGES_ROUTER,\n        },\n      ],\n    }),\n    Integration.nextjs,\n  );\n\n  return result;\n}\n\nexport const getNextJsRouterName = (router: NextJsRouter) => {\n  return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';\n};\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/nextjs/utils.ts"],"names":[],"mappings":";;;;;;AAqBA,0CAmDC;AAxED,0DAA2B;AAC3B,sDAAwD;AACxD,2DAAmC;AAEnC,gDAA+C;AAC/C,4CAAsD;AAEzC,QAAA,sBAAsB,GAAG,IAAA,4BAAmB,GAAE,CAAC;AAE5D,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,6CAA6B,CAAA;AAC/B,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAEY,QAAA,eAAe,GAAG;IAC7B,oBAAoB;IACpB,YAAY;IACZ,aAAa;IACb,cAAc;IACd,aAAa;CACd,CAAC;AACK,KAAK,UAAU,eAAe,CAAC,EACpC,UAAU,GACwB;IAClC,MAAM,YAAY,GAAG,MAAM,IAAA,mBAAE,EAAC,gCAAgC,EAAE;QAC9D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,uBAAe;KACxB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,MAAM,IAAA,mBAAE,EAAC,mCAAmC,EAAE;QAC/D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,uBAAe;KACxB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,IAAI,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,eAAK,CAAC,GAAG,CAAC,IAAI,CACZ,YAAY,IAAA,2BAAmB,EAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAChE,CAAC;QACF,OAAO,YAAY,CAAC,YAAY,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,eAAK,CAAC,GAAG,CAAC,IAAI,CACZ,YAAY,IAAA,2BAAmB,EAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAC9D,CAAC;QACF,OAAO,YAAY,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAiB,MAAM,IAAA,8BAAgB,EACjD,eAAK,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,4BAA4B;QACrC,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,IAAA,2BAAmB,EAAC,YAAY,CAAC,UAAU,CAAC;gBACnD,KAAK,EAAE,YAAY,CAAC,UAAU;aAC/B;YACD;gBACE,KAAK,EAAE,IAAA,2BAAmB,EAAC,YAAY,CAAC,YAAY,CAAC;gBACrD,KAAK,EAAE,YAAY,CAAC,YAAY;aACjC;SACF;KACF,CAAC,EACF,uBAAW,CAAC,MAAM,CACnB,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,MAAM,mBAAmB,GAAG,CAAC,MAAoB,EAAE,EAAE;IAC1D,OAAO,MAAM,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;AAC5E,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B","sourcesContent":["import fg from 'fast-glob';\nimport { abortIfCancelled } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\nimport { Integration } from '../lib/constants';\nimport { createVersionBucket } from '../utils/semver';\n\nexport const getNextJsVersionBucket = createVersionBucket();\n\nexport enum NextJsRouter {\n  APP_ROUTER = 'app-router',\n  PAGES_ROUTER = 'pages-router',\n}\n\nexport const IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\nexport async function getNextJsRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter> {\n  const pagesMatches = await fg('**/pages/_app.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasPagesDir = pagesMatches.length > 0;\n\n  const appMatches = await fg('**/app/**/layout.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasAppDir = appMatches.length > 0;\n\n  if (hasPagesDir && !hasAppDir) {\n    clack.log.info(\n      `Detected ${getNextJsRouterName(NextJsRouter.PAGES_ROUTER)} 📃`,\n    );\n    return NextJsRouter.PAGES_ROUTER;\n  }\n\n  if (hasAppDir && !hasPagesDir) {\n    clack.log.info(\n      `Detected ${getNextJsRouterName(NextJsRouter.APP_ROUTER)} 📱`,\n    );\n    return NextJsRouter.APP_ROUTER;\n  }\n\n  const result: NextJsRouter = await abortIfCancelled(\n    clack.select({\n      message: 'What router are you using?',\n      options: [\n        {\n          label: getNextJsRouterName(NextJsRouter.APP_ROUTER),\n          value: NextJsRouter.APP_ROUTER,\n        },\n        {\n          label: getNextJsRouterName(NextJsRouter.PAGES_ROUTER),\n          value: NextJsRouter.PAGES_ROUTER,\n        },\n      ],\n    }),\n    Integration.nextjs,\n  );\n\n  return result;\n}\n\nexport const getNextJsRouterName = (router: NextJsRouter) => {\n  return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';\n};\n"]}

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

@@ -0,0 +1,6 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+type NuxtContext = {
+    versionBucket?: string;
+};
+export declare const NUXT_AGENT_CONFIG: FrameworkConfig<NuxtContext>;
+export {};

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

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NUXT_AGENT_CONFIG = void 0;
+const constants_1 = require("../lib/constants");
+const package_json_1 = require("../utils/package-json");
+const clack_utils_1 = require("../utils/clack-utils");
+const semver_1 = require("../utils/semver");
+const getNuxtVersionBucket = (0, semver_1.createVersionBucket)();
+exports.NUXT_AGENT_CONFIG = {
+    metadata: {
+        name: 'Nuxt',
+        integration: constants_1.Integration.nuxt,
+        docsUrl: 'https://posthog.com/docs/libraries/nuxt',
+        beta: true,
+        gatherContext: async (options) => {
+            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+            const version = (0, package_json_1.getPackageVersion)('nuxt', packageJson);
+            const versionBucket = getNuxtVersionBucket(version);
+            return { versionBucket };
+        },
+    },
+    detection: {
+        packageName: 'nuxt',
+        packageDisplayName: 'Nuxt',
+        getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('nuxt', packageJson),
+        getVersionBucket: getNuxtVersionBucket,
+        getInstalledVersion: async (options) => {
+            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+            return (0, package_json_1.getPackageVersion)('nuxt', packageJson);
+        },
+        detect: async (options) => {
+            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            return packageJson ? (0, package_json_1.hasPackageInstalled)('nuxt', packageJson) : false;
+        },
+    },
+    environment: {
+        uploadToHosting: true,
+        getEnvVars: (apiKey, host) => ({
+            NUXT_PUBLIC_POSTHOG_KEY: apiKey,
+            NUXT_PUBLIC_POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => ({
+            ...(context.versionBucket
+                ? { versionBucket: context.versionBucket }
+                : {}),
+        }),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',
+        packageInstallation: 'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',
+        getAdditionalContextLines: (context) => {
+            const lines = [];
+            if (context.versionBucket) {
+                lines.push(`Nuxt version: ${context.versionBucket}`);
+            }
+            const frameworkId = 'nuxt';
+            lines.push(`Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`);
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: () => [
+            'Analyzed your Nuxt project structure',
+            'Configured PostHog module/plugin',
+            'Integrated PostHog into your application',
+        ],
+        getOutroNextSteps: () => [
+            'Start your development server to see PostHog in action',
+            'Visit your PostHog dashboard to see incoming events',
+        ],
+    },
+};
+//# sourceMappingURL=nuxt-wizard-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-wizard-agent.js","sourceRoot":"","sources":["../../../src/nuxt/nuxt-wizard-agent.ts"],"names":[],"mappings":";;;AAGA,gDAA+C;AAC/C,wDAI+B;AAC/B,sDAA4E;AAC5E,4CAAsD;AAEtD,MAAM,oBAAoB,GAAG,IAAA,4BAAmB,GAAE,CAAC;AAMtC,QAAA,iBAAiB,GAAiC;IAC7D,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,uBAAW,CAAC,IAAI;QAC7B,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,IAAI;QACV,aAAa,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YAC9C,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,IAAA,gCAAiB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACvD,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,CAAC;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,MAAM;QACnB,kBAAkB,EAAE,MAAM;QAC1B,UAAU,EAAE,CAAC,WAAoB,EAAE,EAAE,CACnC,IAAA,gCAAiB,EAAC,MAAM,EAAE,WAA6B,CAAC;QAC1D,gBAAgB,EAAE,oBAAoB;QACtC,mBAAmB,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,IAAA,gCAAiB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,WAAW,CAAC,CAAC,CAAC,IAAA,kCAAmB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,CAAC;KACF;IAED,WAAW,EAAE;QACX,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;YAC7C,uBAAuB,EAAE,MAAM;YAC/B,wBAAwB,EAAE,IAAI;SAC/B,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrB,GAAG,CAAC,OAAO,CAAC,aAAa;gBACvB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;gBAC1C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;KACH;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,oJAAoJ;QACtJ,mBAAmB,EACjB,gHAAgH;QAClH,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,CAAC;YAC3B,KAAK,CAAC,IAAI,CACR,sBAAsB,WAAW,mCAAmC,WAAW,qBAAqB,CACrG,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,GAAG,EAAE,CAAC;YACrB,sCAAsC;YACtC,kCAAkC;YAClC,0CAA0C;SAC3C;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,wDAAwD;YACxD,qDAAqD;SACtD;KACF;CACF,CAAC","sourcesContent":["/* Nuxt wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { Integration } from '../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../utils/package-json';\nimport { getPackageDotJson, tryGetPackageJson } from '../utils/clack-utils';\nimport { createVersionBucket } from '../utils/semver';\n\nconst getNuxtVersionBucket = createVersionBucket();\n\ntype NuxtContext = {\n  versionBucket?: string;\n};\n\nexport const NUXT_AGENT_CONFIG: FrameworkConfig<NuxtContext> = {\n  metadata: {\n    name: 'Nuxt',\n    integration: Integration.nuxt,\n    docsUrl: 'https://posthog.com/docs/libraries/nuxt',\n    beta: true,\n    gatherContext: async (options: WizardOptions) => {\n      const packageJson = await getPackageDotJson(options);\n      const version = getPackageVersion('nuxt', packageJson);\n      const versionBucket = getNuxtVersionBucket(version);\n      return { versionBucket };\n    },\n  },\n\n  detection: {\n    packageName: 'nuxt',\n    packageDisplayName: 'Nuxt',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('nuxt', packageJson as PackageDotJson),\n    getVersionBucket: getNuxtVersionBucket,\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await getPackageDotJson(options);\n      return getPackageVersion('nuxt', packageJson);\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? hasPackageInstalled('nuxt', packageJson) : false;\n    },\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      NUXT_PUBLIC_POSTHOG_KEY: apiKey,\n      NUXT_PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      ...(context.versionBucket\n        ? { versionBucket: context.versionBucket }\n        : {}),\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',\n    getAdditionalContextLines: (context) => {\n      const lines: string[] = [];\n      if (context.versionBucket) {\n        lines.push(`Nuxt version: ${context.versionBucket}`);\n      }\n      const frameworkId = 'nuxt';\n      lines.push(\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      );\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: () => [\n      'Analyzed your Nuxt project structure',\n      'Configured PostHog module/plugin',\n      'Integrated PostHog into your application',\n    ],\n    getOutroNextSteps: () => [\n      'Start your development server to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

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

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+import { PythonPackageManager } from './utils';
+type PythonContext = {
+    packageManager?: PythonPackageManager;
+};
+export declare const PYTHON_AGENT_CONFIG: FrameworkConfig<PythonContext>;
+export {};