@posthog/wizard 2.9.0 → 2.10.0

package/dist/defaults-DoVkE0gW.js

@@ -0,0 +1,234 @@
+import z$1 from "zod";
+z$1.object({ mcpServers: z$1.record(z$1.string(), z$1.union([z$1.object({
+	command: z$1.string().optional(),
+	args: z$1.array(z$1.string()).optional(),
+	env: z$1.record(z$1.string(), z$1.string()).optional()
+}), z$1.object({
+	url: z$1.string(),
+	headers: z$1.record(z$1.string(), z$1.string()).optional()
+})])) }).passthrough();
+const AVAILABLE_FEATURES = {
+	"Data & Analytics": [
+		{
+			value: "dashboards",
+			label: "Dashboards",
+			hint: "Dashboard creation and management"
+		},
+		{
+			value: "insights",
+			label: "Insights",
+			hint: "Analytics insights"
+		},
+		{
+			value: "product_analytics",
+			label: "Product Analytics",
+			hint: "Insight CRUD management"
+		},
+		{
+			value: "experiments",
+			label: "Experiments",
+			hint: "A/B testing experiments"
+		},
+		{
+			value: "surveys",
+			label: "Surveys",
+			hint: "Survey management"
+		},
+		{
+			value: "annotations",
+			label: "Annotations",
+			hint: "Annotation management"
+		},
+		{
+			value: "replay",
+			label: "Session Replay",
+			hint: "Session recording management"
+		},
+		{
+			value: "sql",
+			label: "SQL",
+			hint: "SQL query execution"
+		}
+	],
+	"AI Engineering": [{
+		value: "llm_analytics",
+		label: "LLM Analytics",
+		hint: "LLM usage and cost tracking"
+	}, {
+		value: "prompts",
+		label: "Prompts",
+		hint: "LLM prompt management"
+	}],
+	"Development Tools": [
+		{
+			value: "error_tracking",
+			label: "Error Tracking",
+			hint: "Error monitoring and debugging"
+		},
+		{
+			value: "logs",
+			label: "Logs",
+			hint: "Log querying"
+		},
+		{
+			value: "flags",
+			label: "Feature Flags",
+			hint: "Feature flag management"
+		},
+		{
+			value: "early_access_features",
+			label: "Early Access Features",
+			hint: "Early access feature management"
+		},
+		{
+			value: "cohorts",
+			label: "Cohorts",
+			hint: "Cohort management"
+		}
+	],
+	"Data Management": [
+		{
+			value: "events",
+			label: "Events",
+			hint: "Event and property definitions"
+		},
+		{
+			value: "persons",
+			label: "Persons",
+			hint: "Person and group management"
+		},
+		{
+			value: "actions",
+			label: "Actions",
+			hint: "Action definitions"
+		},
+		{
+			value: "data_warehouse",
+			label: "Data Warehouse",
+			hint: "Data warehouse management"
+		},
+		{
+			value: "endpoints",
+			label: "Endpoints",
+			hint: "Data warehouse endpoint management"
+		},
+		{
+			value: "data_schema",
+			label: "Data Schema",
+			hint: "Data schema exploration"
+		}
+	],
+	"CDP & Automation": [
+		{
+			value: "hog_functions",
+			label: "Hog Functions",
+			hint: "CDP function management"
+		},
+		{
+			value: "hog_function_templates",
+			label: "Hog Function Templates",
+			hint: "CDP function template browsing"
+		},
+		{
+			value: "workflows",
+			label: "Workflows",
+			hint: "Workflow management"
+		}
+	],
+	"Platform & Management": [
+		{
+			value: "workspace",
+			label: "Workspace",
+			hint: "Organization and project management"
+		},
+		{
+			value: "docs",
+			label: "Documentation",
+			hint: "PostHog documentation search"
+		},
+		{
+			value: "notebooks",
+			label: "Notebooks",
+			hint: "Notebook management"
+		},
+		{
+			value: "alerts",
+			label: "Alerts",
+			hint: "Alert management"
+		},
+		{
+			value: "platform_features",
+			label: "Platform Features",
+			hint: "Activity logs, approvals, comments, and roles"
+		},
+		{
+			value: "integrations",
+			label: "Integrations",
+			hint: "Connected integration management"
+		},
+		{
+			value: "conversations",
+			label: "Conversations",
+			hint: "Support ticket management"
+		},
+		{
+			value: "core",
+			label: "Subscriptions",
+			hint: "Scheduled insight and dashboard deliveries"
+		},
+		{
+			value: "search",
+			label: "Search",
+			hint: "Entity search across the project"
+		},
+		{
+			value: "reverse_proxy",
+			label: "Reverse Proxy",
+			hint: "Reverse proxy record management"
+		},
+		{
+			value: "debug",
+			label: "Debug",
+			hint: "Debug and diagnostic tools"
+		}
+	]
+};
+const ALL_FEATURE_VALUES = Object.values(AVAILABLE_FEATURES).flat().map((feature) => feature.value);
+const buildMCPUrl = (type, selectedFeatures, local) => {
+	const baseUrl = `${local ? "http://localhost:8787" : "https://mcp.posthog.com"}/${type === "sse" ? "sse" : "mcp"}`;
+	const isAllFeaturesSelected = selectedFeatures && selectedFeatures.length === ALL_FEATURE_VALUES.length && ALL_FEATURE_VALUES.every((feature) => selectedFeatures.includes(feature));
+	const params = [];
+	if (selectedFeatures && selectedFeatures.length > 0 && !isAllFeaturesSelected) params.push(`features=${selectedFeatures.join(",")}`);
+	return params.length > 0 ? `${baseUrl}?${params.join("&")}` : baseUrl;
+};
+const getNativeHTTPServerConfig = (apiKey, type, selectedFeatures, local) => {
+	const config = { url: buildMCPUrl(type, selectedFeatures, local) };
+	if (apiKey) config.headers = { Authorization: `Bearer ${apiKey}` };
+	return config;
+};
+const getDefaultServerConfig = (apiKey, type, selectedFeatures, local) => {
+	const urlWithFeatures = buildMCPUrl(type, selectedFeatures, local);
+	if (!apiKey) return {
+		command: "npx",
+		args: [
+			"-y",
+			"mcp-remote@latest",
+			urlWithFeatures
+		]
+	};
+	return {
+		command: "npx",
+		args: [
+			"-y",
+			"mcp-remote@latest",
+			urlWithFeatures,
+			"--header",
+			`Authorization:\${POSTHOG_AUTH_HEADER}`
+		],
+		env: { POSTHOG_AUTH_HEADER: `Bearer ${apiKey}` }
+	};
+};
+//#endregion
+export { getNativeHTTPServerConfig as a, getDefaultServerConfig as i, AVAILABLE_FEATURES as n, buildMCPUrl as r, ALL_FEATURE_VALUES as t };
+
+//# sourceMappingURL=defaults-DoVkE0gW.js.map

package/dist/defaults-DoVkE0gW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-DoVkE0gW.js","names":["z"],"sources":["../src/steps/add-mcp-server-to-clients/defaults.ts"],"sourcesContent":["import z from 'zod';\n\nexport const DefaultMCPClientConfig = z\n  .object({\n    mcpServers: z.record(\n      z.string(),\n      z.union([\n        z.object({\n          command: z.string().optional(),\n          args: z.array(z.string()).optional(),\n          env: z.record(z.string(), z.string()).optional(),\n        }),\n        z.object({\n          url: z.string(),\n          headers: z.record(z.string(), z.string()).optional(),\n        }),\n      ]),\n    ),\n  })\n  .passthrough();\n\nexport const AVAILABLE_FEATURES = {\n  'Data & Analytics': [\n    {\n      value: 'dashboards',\n      label: 'Dashboards',\n      hint: 'Dashboard creation and management',\n    },\n    {\n      value: 'insights',\n      label: 'Insights',\n      hint: 'Analytics insights',\n    },\n    {\n      value: 'product_analytics',\n      label: 'Product Analytics',\n      hint: 'Insight CRUD management',\n    },\n    {\n      value: 'experiments',\n      label: 'Experiments',\n      hint: 'A/B testing experiments',\n    },\n    {\n      value: 'surveys',\n      label: 'Surveys',\n      hint: 'Survey management',\n    },\n    {\n      value: 'annotations',\n      label: 'Annotations',\n      hint: 'Annotation management',\n    },\n    {\n      value: 'replay',\n      label: 'Session Replay',\n      hint: 'Session recording management',\n    },\n    {\n      value: 'sql',\n      label: 'SQL',\n      hint: 'SQL query execution',\n    },\n  ],\n  'AI Engineering': [\n    {\n      value: 'llm_analytics',\n      label: 'LLM Analytics',\n      hint: 'LLM usage and cost tracking',\n    },\n    {\n      value: 'prompts',\n      label: 'Prompts',\n      hint: 'LLM prompt management',\n    },\n  ],\n  'Development Tools': [\n    {\n      value: 'error_tracking',\n      label: 'Error Tracking',\n      hint: 'Error monitoring and debugging',\n    },\n    {\n      value: 'logs',\n      label: 'Logs',\n      hint: 'Log querying',\n    },\n    {\n      value: 'flags',\n      label: 'Feature Flags',\n      hint: 'Feature flag management',\n    },\n    {\n      value: 'early_access_features',\n      label: 'Early Access Features',\n      hint: 'Early access feature management',\n    },\n    {\n      value: 'cohorts',\n      label: 'Cohorts',\n      hint: 'Cohort management',\n    },\n  ],\n  'Data Management': [\n    {\n      value: 'events',\n      label: 'Events',\n      hint: 'Event and property definitions',\n    },\n    {\n      value: 'persons',\n      label: 'Persons',\n      hint: 'Person and group management',\n    },\n    {\n      value: 'actions',\n      label: 'Actions',\n      hint: 'Action definitions',\n    },\n    {\n      value: 'data_warehouse',\n      label: 'Data Warehouse',\n      hint: 'Data warehouse management',\n    },\n    {\n      value: 'endpoints',\n      label: 'Endpoints',\n      hint: 'Data warehouse endpoint management',\n    },\n    {\n      value: 'data_schema',\n      label: 'Data Schema',\n      hint: 'Data schema exploration',\n    },\n  ],\n  'CDP & Automation': [\n    {\n      value: 'hog_functions',\n      label: 'Hog Functions',\n      hint: 'CDP function management',\n    },\n    {\n      value: 'hog_function_templates',\n      label: 'Hog Function Templates',\n      hint: 'CDP function template browsing',\n    },\n    {\n      value: 'workflows',\n      label: 'Workflows',\n      hint: 'Workflow management',\n    },\n  ],\n  'Platform & Management': [\n    {\n      value: 'workspace',\n      label: 'Workspace',\n      hint: 'Organization and project management',\n    },\n    {\n      value: 'docs',\n      label: 'Documentation',\n      hint: 'PostHog documentation search',\n    },\n    {\n      value: 'notebooks',\n      label: 'Notebooks',\n      hint: 'Notebook management',\n    },\n    {\n      value: 'alerts',\n      label: 'Alerts',\n      hint: 'Alert management',\n    },\n    {\n      value: 'platform_features',\n      label: 'Platform Features',\n      hint: 'Activity logs, approvals, comments, and roles',\n    },\n    {\n      value: 'integrations',\n      label: 'Integrations',\n      hint: 'Connected integration management',\n    },\n    {\n      value: 'conversations',\n      label: 'Conversations',\n      hint: 'Support ticket management',\n    },\n    {\n      value: 'core',\n      label: 'Subscriptions',\n      hint: 'Scheduled insight and dashboard deliveries',\n    },\n    {\n      value: 'search',\n      label: 'Search',\n      hint: 'Entity search across the project',\n    },\n    {\n      value: 'reverse_proxy',\n      label: 'Reverse Proxy',\n      hint: 'Reverse proxy record management',\n    },\n    {\n      value: 'debug',\n      label: 'Debug',\n      hint: 'Debug and diagnostic tools',\n    },\n  ],\n};\n\nexport const ALL_FEATURE_VALUES = Object.values(AVAILABLE_FEATURES)\n  .flat()\n  .map((feature) => feature.value);\n\ntype MCPServerType = 'sse' | 'streamable-http';\n\nexport const buildMCPUrl = (\n  type: MCPServerType,\n  selectedFeatures?: string[],\n  local?: boolean,\n) => {\n  const host = local ? 'http://localhost:8787' : 'https://mcp.posthog.com';\n  const baseUrl = `${host}/${type === 'sse' ? 'sse' : 'mcp'}`;\n\n  const isAllFeaturesSelected =\n    selectedFeatures &&\n    selectedFeatures.length === ALL_FEATURE_VALUES.length &&\n    ALL_FEATURE_VALUES.every((feature) => selectedFeatures.includes(feature));\n\n  const params: string[] = [];\n\n  // Add features param if not all features selected\n  if (\n    selectedFeatures &&\n    selectedFeatures.length > 0 &&\n    !isAllFeaturesSelected\n  ) {\n    params.push(`features=${selectedFeatures.join(',')}`);\n  }\n\n  return params.length > 0 ? `${baseUrl}?${params.join('&')}` : baseUrl;\n};\n\nexport const getNativeHTTPServerConfig = (\n  apiKey: string | undefined,\n  type: MCPServerType,\n  selectedFeatures?: string[],\n  local?: boolean,\n) => {\n  const config: Record<string, unknown> = {\n    url: buildMCPUrl(type, selectedFeatures, local),\n  };\n\n  // Only add auth header if API key is provided (not OAuth mode)\n  if (apiKey) {\n    config.headers = {\n      Authorization: `Bearer ${apiKey}`,\n    };\n  }\n\n  return config;\n};\n\nexport const getDefaultServerConfig = (\n  apiKey: string | undefined,\n  type: MCPServerType,\n  selectedFeatures?: string[],\n  local?: boolean,\n) => {\n  const urlWithFeatures = buildMCPUrl(type, selectedFeatures, local);\n\n  // OAuth mode: no auth header, let MCP handle OAuth\n  if (!apiKey) {\n    return {\n      command: 'npx',\n      args: ['-y', 'mcp-remote@latest', urlWithFeatures],\n    };\n  }\n\n  // API key mode: include auth header\n  return {\n    command: 'npx',\n    args: [\n      '-y',\n      'mcp-remote@latest',\n      urlWithFeatures,\n      '--header',\n      `Authorization:\\${POSTHOG_AUTH_HEADER}`,\n    ],\n    env: {\n      POSTHOG_AUTH_HEADER: `Bearer ${apiKey}`,\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/detection-CkLpxBCD.js

@@ -0,0 +1,122 @@
+import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
+import { l as Integration, o as DETECTION_TIMEOUT_MS } from "./analytics-C4jO5Qda.js";
+import { t as FRAMEWORK_REGISTRY } from "./registry-s55_iuJT.js";
+import * as semver from "semver";
+import { readFileSync } from "fs";
+import { join } from "path";
+//#region src/lib/detection/framework.ts
+/**
+* Framework detection — identify which PostHog-supported framework
+* is present in the project directory.
+*
+* Pure function: takes an install dir, returns the detected integration
+* (or undefined). No store mutations, no UI calls.
+*/
+/**
+* Loop through all registered frameworks and return the first one
+* whose `detect()` predicate matches the given directory.
+* Returns undefined if no framework is detected or detection times out.
+*/
+async function detectFramework(installDir) {
+	for (const integration of Object.values(Integration)) {
+		const config = FRAMEWORK_REGISTRY[integration];
+		try {
+			if (await Promise.race([config.detection.detect({ installDir }), new Promise((resolve) => setTimeout(() => resolve(false), 1e4))])) return integration;
+		} catch {}
+	}
+}
+//#endregion
+//#region src/lib/detection/features.ts
+/**
+* Feature discovery — scan project dependencies for known SDK patterns
+* that indicate additional PostHog workflows are relevant.
+*
+* Pure function: takes an install dir, returns a set of discovered features.
+* No store mutations, no UI calls.
+*/
+const STRIPE_PACKAGES = ["stripe", "@stripe/stripe-js"];
+const LLM_PACKAGES = [
+	"openai",
+	"@anthropic-ai/sdk",
+	"ai",
+	"@ai-sdk/openai",
+	"langchain",
+	"@langchain/openai",
+	"@langchain/langgraph",
+	"@google/generative-ai",
+	"@google/genai",
+	"@instructor-ai/instructor",
+	"@mastra/core",
+	"portkey-ai"
+];
+/**
+* Scan `package.json` at `installDir` for dependencies that indicate
+* additional PostHog features (Stripe revenue analytics, LLM observability, etc.)
+*
+* Returns an array of discovered features, or empty if nothing found
+* or no package.json exists.
+*/
+function discoverFeatures(installDir) {
+	const features = [];
+	try {
+		const pkg = JSON.parse(readFileSync(join(installDir, "package.json"), "utf-8"));
+		const depNames = Object.keys({
+			...pkg.dependencies,
+			...pkg.devDependencies
+		});
+		if (depNames.some((d) => STRIPE_PACKAGES.includes(d))) features.push("stripe");
+		if (depNames.some((d) => LLM_PACKAGES.includes(d))) features.push("llm");
+	} catch {}
+	return features;
+}
+//#endregion
+//#region src/lib/detection/context.ts
+/**
+* Framework context gathering — run gatherContext and version checks
+* for a detected framework.
+*
+* Pure functions: take a framework config and options, return results.
+* No store mutations, no UI calls.
+*/
+/**
+* Run a framework's `gatherContext()` to collect variant-specific
+* metadata (e.g., router type for Next.js, Expo vs bare for React Native).
+*
+* Returns the gathered context, or an empty object on failure/timeout.
+*/
+async function gatherFrameworkContext(config, options) {
+	if (!config.metadata.gatherContext) return {};
+	try {
+		return await Promise.race([config.metadata.gatherContext(options), new Promise((resolve) => setTimeout(() => resolve({}), DETECTION_TIMEOUT_MS))]);
+	} catch {
+		return {};
+	}
+}
+/**
+* Check whether the installed framework version meets the minimum requirement.
+*
+* Returns `{ supported: true }` if the version is fine (or no check is needed).
+* Returns the version details if unsupported.
+*/
+async function checkFrameworkVersion(config, options) {
+	if (!config.detection.minimumVersion || !config.detection.getInstalledVersion) return { supported: true };
+	const version = await config.detection.getInstalledVersion(options);
+	if (!version) return { supported: true };
+	const coerced = semver.coerce(version);
+	if (coerced && semver.lt(coerced, config.detection.minimumVersion)) return { supported: {
+		current: version,
+		minimum: config.detection.minimumVersion,
+		docsUrl: config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl
+	} };
+	return { supported: true };
+}
+//#endregion
+//#region src/lib/detection/index.ts
+var detection_exports = /* @__PURE__ */ __exportAll({
+	detectFramework: () => detectFramework,
+	gatherFrameworkContext: () => gatherFrameworkContext
+});
+//#endregion
+export { detectFramework as a, discoverFeatures as i, checkFrameworkVersion as n, gatherFrameworkContext as r, detection_exports as t };
+
+//# sourceMappingURL=detection-CkLpxBCD.js.map

package/dist/detection-CkLpxBCD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection-CkLpxBCD.js","names":[],"sources":["../src/lib/detection/framework.ts","../src/lib/detection/features.ts","../src/lib/detection/context.ts","../src/lib/detection/index.ts"],"sourcesContent":["/**\n * Framework detection — identify which PostHog-supported framework\n * is present in the project directory.\n *\n * Pure function: takes an install dir, returns the detected integration\n * (or undefined). No store mutations, no UI calls.\n */\n\nimport { Integration, DETECTION_TIMEOUT_MS } from '../constants.js';\nimport { FRAMEWORK_REGISTRY } from '../registry.js';\n\n/**\n * Loop through all registered frameworks and return the first one\n * whose `detect()` predicate matches the given directory.\n * Returns undefined if no framework is detected or detection times out.\n */\nexport async function detectFramework(\n  installDir: string,\n): Promise<Integration | undefined> {\n  for (const integration of Object.values(Integration)) {\n    const config = FRAMEWORK_REGISTRY[integration];\n    try {\n      const detected = await Promise.race([\n        config.detection.detect({ installDir }),\n        new Promise<false>((resolve) =>\n          setTimeout(() => resolve(false), DETECTION_TIMEOUT_MS),\n        ),\n      ]);\n      if (detected) {\n        return integration;\n      }\n    } catch {\n      // Skip frameworks whose detection throws\n    }\n  }\n}\n","/**\n * Feature discovery — scan project dependencies for known SDK patterns\n * that indicate additional PostHog workflows are relevant.\n *\n * Pure function: takes an install dir, returns a set of discovered features.\n * No store mutations, no UI calls.\n */\n\nimport { readFileSync } from 'fs';\nimport { join } from 'path';\nimport { DiscoveredFeature } from '../wizard-session.js';\n\nconst STRIPE_PACKAGES = ['stripe', '@stripe/stripe-js'];\n\nconst LLM_PACKAGES = [\n  'openai',\n  '@anthropic-ai/sdk',\n  'ai',\n  '@ai-sdk/openai',\n  'langchain',\n  '@langchain/openai',\n  '@langchain/langgraph',\n  '@google/generative-ai',\n  '@google/genai',\n  '@instructor-ai/instructor',\n  '@mastra/core',\n  'portkey-ai',\n];\n\n/**\n * Scan `package.json` at `installDir` for dependencies that indicate\n * additional PostHog features (Stripe revenue analytics, LLM observability, etc.)\n *\n * Returns an array of discovered features, or empty if nothing found\n * or no package.json exists.\n */\nexport function discoverFeatures(installDir: string): DiscoveredFeature[] {\n  const features: DiscoveredFeature[] = [];\n\n  try {\n    const pkg = JSON.parse(\n      readFileSync(join(installDir, 'package.json'), 'utf-8'),\n    ) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n    const depNames = Object.keys({\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    });\n\n    if (depNames.some((d) => STRIPE_PACKAGES.includes(d))) {\n      features.push(DiscoveredFeature.Stripe);\n    }\n\n    if (depNames.some((d) => LLM_PACKAGES.includes(d))) {\n      features.push(DiscoveredFeature.LLM);\n    }\n  } catch {\n    // No package.json or parse error — skip feature discovery\n  }\n\n  return features;\n}\n","/**\n * Framework context gathering — run gatherContext and version checks\n * for a detected framework.\n *\n * Pure functions: take a framework config and options, return results.\n * No store mutations, no UI calls.\n */\n\nimport * as semver from 'semver';\nimport { DETECTION_TIMEOUT_MS } from '../constants.js';\nimport type { FrameworkConfig } from '../framework-config.js';\nimport type { WizardOptions } from '../../utils/types.js';\n\n/**\n * Run a framework's `gatherContext()` to collect variant-specific\n * metadata (e.g., router type for Next.js, Expo vs bare for React Native).\n *\n * Returns the gathered context, or an empty object on failure/timeout.\n */\nexport async function gatherFrameworkContext(\n  config: FrameworkConfig,\n  options: WizardOptions,\n): Promise<Record<string, unknown>> {\n  if (!config.metadata.gatherContext) return {};\n\n  try {\n    return await Promise.race([\n      config.metadata.gatherContext(options),\n      new Promise<Record<string, never>>((resolve) =>\n        setTimeout(() => resolve({}), DETECTION_TIMEOUT_MS),\n      ),\n    ]);\n  } catch {\n    return {};\n  }\n}\n\nexport interface VersionCheckResult {\n  /** Whether the installed version is supported */\n  supported:\n    | true\n    | {\n        current: string;\n        minimum: string;\n        docsUrl: string;\n      };\n}\n\n/**\n * Check whether the installed framework version meets the minimum requirement.\n *\n * Returns `{ supported: true }` if the version is fine (or no check is needed).\n * Returns the version details if unsupported.\n */\nexport async function checkFrameworkVersion(\n  config: FrameworkConfig,\n  options: WizardOptions,\n): Promise<VersionCheckResult> {\n  if (\n    !config.detection.minimumVersion ||\n    !config.detection.getInstalledVersion\n  ) {\n    return { supported: true };\n  }\n\n  const version = await config.detection.getInstalledVersion(options);\n  if (!version) return { supported: true };\n\n  const coerced = semver.coerce(version);\n  if (coerced && semver.lt(coerced, config.detection.minimumVersion)) {\n    return {\n      supported: {\n        current: version,\n        minimum: config.detection.minimumVersion,\n        docsUrl:\n          config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl,\n      },\n    };\n  }\n\n  return { supported: true };\n}\n","export { detectFramework } from './framework.js';\nexport { discoverFeatures } from './features.js';\nexport {\n  gatherFrameworkContext,\n  checkFrameworkVersion,\n  type VersionCheckResult,\n} from './context.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgBA,eAAsB,gBACpB,YACkC;AAClC,MAAK,MAAM,eAAe,OAAO,OAAO,YAAY,EAAE;EACpD,MAAM,SAAS,mBAAmB;AAClC,MAAI;AAOF,OANiB,MAAM,QAAQ,KAAK,CAClC,OAAO,UAAU,OAAO,EAAE,YAAY,CAAC,EACvC,IAAI,SAAgB,YAClB,iBAAiB,QAAQ,MAAM,EAAA,IAAuB,CACvD,CACF,CAAC,CAEA,QAAO;UAEH;;;;;;;;;;;;ACnBZ,MAAM,kBAAkB,CAAC,UAAU,oBAAoB;AAEvD,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;AASD,SAAgB,iBAAiB,YAAyC;CACxE,MAAM,WAAgC,EAAE;AAExC,KAAI;EACF,MAAM,MAAM,KAAK,MACf,aAAa,KAAK,YAAY,eAAe,EAAE,QAAQ,CACxD;EAID,MAAM,WAAW,OAAO,KAAK;GAC3B,GAAG,IAAI;GACP,GAAG,IAAI;GACR,CAAC;AAEF,MAAI,SAAS,MAAM,MAAM,gBAAgB,SAAS,EAAE,CAAC,CACnD,UAAS,KAAA,SAA8B;AAGzC,MAAI,SAAS,MAAM,MAAM,aAAa,SAAS,EAAE,CAAC,CAChD,UAAS,KAAA,MAA2B;SAEhC;AAIR,QAAO;;;;;;;;;;;;;;;;;AC3CT,eAAsB,uBACpB,QACA,SACkC;AAClC,KAAI,CAAC,OAAO,SAAS,cAAe,QAAO,EAAE;AAE7C,KAAI;AACF,SAAO,MAAM,QAAQ,KAAK,CACxB,OAAO,SAAS,cAAc,QAAQ,EACtC,IAAI,SAAgC,YAClC,iBAAiB,QAAQ,EAAE,CAAC,EAAE,qBAAqB,CACpD,CACF,CAAC;SACI;AACN,SAAO,EAAE;;;;;;;;;AAqBb,eAAsB,sBACpB,QACA,SAC6B;AAC7B,KACE,CAAC,OAAO,UAAU,kBAClB,CAAC,OAAO,UAAU,oBAElB,QAAO,EAAE,WAAW,MAAM;CAG5B,MAAM,UAAU,MAAM,OAAO,UAAU,oBAAoB,QAAQ;AACnE,KAAI,CAAC,QAAS,QAAO,EAAE,WAAW,MAAM;CAExC,MAAM,UAAU,OAAO,OAAO,QAAQ;AACtC,KAAI,WAAW,OAAO,GAAG,SAAS,OAAO,UAAU,eAAe,CAChE,QAAO,EACL,WAAW;EACT,SAAS;EACT,SAAS,OAAO,UAAU;EAC1B,SACE,OAAO,SAAS,6BAA6B,OAAO,SAAS;EAChE,EACF;AAGH,QAAO,EAAE,WAAW,MAAM"}

package/dist/env-api-key-K8TdTDII.js

@@ -0,0 +1,20 @@
+import * as fs$1 from "fs";
+import * as path$1 from "path";
+//#region src/utils/env-api-key.ts
+/**
+* Read POSTHOG_PERSONAL_API_KEY from .env.local or .env in the current
+* working directory. Returns undefined when no key is found.
+*/
+function readApiKeyFromEnv() {
+	for (const envFile of [".env.local", ".env"]) {
+		const envPath = path$1.join(process.cwd(), envFile);
+		if (fs$1.existsSync(envPath)) {
+			const match = fs$1.readFileSync(envPath, "utf8").match(/^POSTHOG_PERSONAL_API_KEY=(.+)$/m);
+			if (match) return match[1].trim();
+		}
+	}
+}
+//#endregion
+export { readApiKeyFromEnv };
+
+//# sourceMappingURL=env-api-key-K8TdTDII.js.map

package/dist/env-api-key-K8TdTDII.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-api-key-K8TdTDII.js","names":["path","fs"],"sources":["../src/utils/env-api-key.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\n/**\n * Read POSTHOG_PERSONAL_API_KEY from .env.local or .env in the current\n * working directory. Returns undefined when no key is found.\n */\nexport function readApiKeyFromEnv(): string | undefined {\n  const envFiles = ['.env.local', '.env'];\n  for (const envFile of envFiles) {\n    const envPath = path.join(process.cwd(), envFile);\n    if (fs.existsSync(envPath)) {\n      const content = fs.readFileSync(envPath, 'utf8');\n      const match = content.match(/^POSTHOG_PERSONAL_API_KEY=(.+)$/m);\n      if (match) {\n        return match[1].trim();\n      }\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,oBAAwC;AAEtD,MAAK,MAAM,WADM,CAAC,cAAc,OAAO,EACP;EAC9B,MAAM,UAAUA,OAAK,KAAK,QAAQ,KAAK,EAAE,QAAQ;AACjD,MAAIC,KAAG,WAAW,QAAQ,EAAE;GAE1B,MAAM,QADUA,KAAG,aAAa,SAAS,OAAO,CAC1B,MAAM,mCAAmC;AAC/D,OAAI,MACF,QAAO,MAAM,GAAG,MAAM"}

package/dist/file-utils-BWneZy6p.js

@@ -0,0 +1,38 @@
+import "fs";
+import "path";
+//#region src/utils/file-utils.ts
+/**
+* Directory names to skip when recursively scanning a project tree.
+* Used by detection logic (e.g. finding all package.json files) to avoid
+* dependency directories, build output, virtual environments, etc.
+*
+* For fast-glob `ignore` patterns, map this to `**\/<name>/**`.
+*/
+const IGNORED_DIRS = new Set([
+	"node_modules",
+	".git",
+	".next",
+	".nuxt",
+	".svelte-kit",
+	".turbo",
+	".cache",
+	".parcel-cache",
+	"dist",
+	"build",
+	"out",
+	"coverage",
+	".coverage",
+	"venv",
+	".venv",
+	"__pycache__",
+	".pytest_cache",
+	"vendor",
+	"target",
+	".gradle",
+	".idea",
+	".vscode"
+]);
+//#endregion
+export { IGNORED_DIRS as t };
+
+//# sourceMappingURL=file-utils-BWneZy6p.js.map

package/dist/file-utils-BWneZy6p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils-BWneZy6p.js","names":[],"sources":["../src/utils/file-utils.ts"],"sourcesContent":["import path from 'path';\nimport fs from 'fs';\nimport type { WizardOptions } from './types';\n\nexport function getDotGitignore({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>) {\n  const gitignorePath = path.join(installDir, '.gitignore');\n  const gitignoreExists = fs.existsSync(gitignorePath);\n\n  if (gitignoreExists) {\n    return gitignorePath;\n  }\n\n  return undefined;\n}\n\n/**\n * Directory names to skip when recursively scanning a project tree.\n * Used by detection logic (e.g. finding all package.json files) to avoid\n * dependency directories, build output, virtual environments, etc.\n *\n * For fast-glob `ignore` patterns, map this to `**\\/<name>/**`.\n */\nexport const IGNORED_DIRS = new Set<string>([\n  'node_modules',\n  '.git',\n  '.next',\n  '.nuxt',\n  '.svelte-kit',\n  '.turbo',\n  '.cache',\n  '.parcel-cache',\n  'dist',\n  'build',\n  'out',\n  'coverage',\n  '.coverage',\n  'venv',\n  '.venv',\n  '__pycache__',\n  '.pytest_cache',\n  'vendor',\n  'target',\n  '.gradle',\n  '.idea',\n  '.vscode',\n]);\n"],"mappings":";;;;;;;;;;AAwBA,MAAa,eAAe,IAAI,IAAY;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC"}

package/dist/generate-version.cjs

@@ -0,0 +1,11 @@
+const fs = require('fs');
+const path = require('path');
+
+const pkg = JSON.parse(
+  fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'),
+);
+const output = `// Auto-generated by scripts/generate-version.js — do not edit\nexport const VERSION = '${pkg.version}';\n`;
+fs.writeFileSync(
+  path.join(__dirname, '..', 'src', 'lib', 'version.ts'),
+  output,
+);

package/dist/package-json-BQgl5C3Z.js

@@ -0,0 +1,2 @@
+import { r as hasPackageInstalled } from "./package-json-Ctq6LSl8.js";
+export { hasPackageInstalled };

package/dist/package-json-Ctq6LSl8.js

@@ -0,0 +1,25 @@
+import { readFileSync } from "fs";
+import path from "path";
+//#region src/utils/package-json.ts
+function hasPackageInstalled(packageName, packageJson) {
+	return getPackageVersion(packageName, packageJson) !== void 0;
+}
+/**
+* Read the actual installed version from node_modules/[packageName]/package.json.
+* Returns the real semver (e.g. "15.5.9"), not the range from the project's package.json.
+*/
+function getInstalledPackageVersion(packageName, installDir) {
+	try {
+		const pkgPath = path.join(installDir, "node_modules", packageName, "package.json");
+		return JSON.parse(readFileSync(pkgPath, "utf-8")).version;
+	} catch {
+		return;
+	}
+}
+function getPackageVersion(packageName, packageJson) {
+	return packageJson?.dependencies?.[packageName] || packageJson?.devDependencies?.[packageName];
+}
+//#endregion
+export { getPackageVersion as n, hasPackageInstalled as r, getInstalledPackageVersion as t };
+
+//# sourceMappingURL=package-json-Ctq6LSl8.js.map

package/dist/package-json-Ctq6LSl8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json-Ctq6LSl8.js","names":[],"sources":["../src/utils/package-json.ts"],"sourcesContent":["import { readFileSync } from 'fs';\nimport path from 'path';\n\nexport type PackageDotJson = {\n  version?: string;\n  scripts?: Record<string, string | undefined>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  resolutions?: Record<string, string>;\n  overrides?: Record<string, string>;\n  pnpm?: {\n    overrides?: Record<string, string>;\n  };\n};\n\ntype NpmPackage = {\n  name: string;\n  version: string;\n};\n\n/**\n * Checks if @param packageJson has any of the @param packageNamesList package names\n * listed as a dependency or devDependency.\n * If so, it returns the first package name that is found, including the\n * version (range) specified in the package.json.\n */\nexport function findInstalledPackageFromList(\n  packageNamesList: string[],\n  packageJson: PackageDotJson,\n): NpmPackage | undefined {\n  return packageNamesList\n    .map((packageName) => ({\n      name: packageName,\n      version: getPackageVersion(packageName, packageJson),\n    }))\n    .find((sdkPackage): sdkPackage is NpmPackage => !!sdkPackage.version);\n}\n\nexport function hasPackageInstalled(\n  packageName: string,\n  packageJson: PackageDotJson,\n): boolean {\n  return getPackageVersion(packageName, packageJson) !== undefined;\n}\n\n/**\n * Read the actual installed version from node_modules/[packageName]/package.json.\n * Returns the real semver (e.g. \"15.5.9\"), not the range from the project's package.json.\n */\nexport function getInstalledPackageVersion(\n  packageName: string,\n  installDir: string,\n): string | undefined {\n  try {\n    const pkgPath = path.join(\n      installDir,\n      'node_modules',\n      packageName,\n      'package.json',\n    );\n    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n    return pkg.version;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function getPackageVersion(\n  packageName: string,\n  packageJson: PackageDotJson,\n): string | undefined {\n  return (\n    packageJson?.dependencies?.[packageName] ||\n    packageJson?.devDependencies?.[packageName]\n  );\n}\n"],"mappings":";;;AAsCA,SAAgB,oBACd,aACA,aACS;AACT,QAAO,kBAAkB,aAAa,YAAY,KAAK,KAAA;;;;;;AAOzD,SAAgB,2BACd,aACA,YACoB;AACpB,KAAI;EACF,MAAM,UAAU,KAAK,KACnB,YACA,gBACA,aACA,eACD;AAED,SADY,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC,CAC3C;SACL;AACN;;;AAIJ,SAAgB,kBACd,aACA,aACoB;AACpB,QACE,aAAa,eAAe,gBAC5B,aAAa,kBAAkB"}