@posthog/wizard 2.10.3 → 2.11.0

package/dist/bin.js

@@ -1,16 +1,18 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
-import { c as getUI, f as runtimeEnv, l as setUI, p as red, u as LoggingUI } from "./debug-CyJ_3dTP.js";
-import { T as VERSION } from "./analytics-xANpxdVL.js";
-import "./setup-utils-C1h1QDiG.js";
-import { t as posthogIntegrationConfig } from "./posthog-integration-DUZpiyxg.js";
-import { t as IGNORED_DIRS } from "./file-utils-BWneZy6p.js";
+import { c as getUI, f as runtimeEnv, l as setUI, p as red, u as LoggingUI } from "./debug-gWEjmYVV.js";
+import { C as WIZARD_USER_AGENT, D as VERSION, n as analytics, p as POSTHOG_DOCS_URL } from "./analytics-D3rY3TaN.js";
+import { u as handleApiError } from "./setup-utils-y4s-3uKT.js";
+import { t as posthogIntegrationConfig } from "./posthog-integration-D4SRhJIQ.js";
+import { t as IGNORED_DIRS } from "./file-utils-Dy9JncCo.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import readEnvModule from "read-env";
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { join, relative } from "path";
+import axios from "axios";
+import { z } from "zod";
 import "fast-glob";
 //#region src/utils/environment.ts
 var environment_exports = /* @__PURE__ */ __exportAll({
@@ -160,8 +162,8 @@ function detectRevenuePrerequisites(session, setFrameworkContext) {
 	setFrameworkContext("detectedPackagePaths", matches.filter((m) => m.posthogSdks.length > 0 || m.stripeSdks.length > 0).map((m) => m.path));
 }
 //#endregion
-//#region src/lib/workflows/workflow-registry.ts
-const WORKFLOW_REGISTRY = [posthogIntegrationConfig, {
+//#region src/lib/workflows/revenue-analytics/index.ts
+const revenueAnalyticsConfig = {
 	command: "revenue",
 	description: "Set up PostHog revenue analytics (e.g. Stripe integration)",
 	flowKey: "revenue-analytics-setup",
@@ -213,7 +215,162 @@ const WORKFLOW_REGISTRY = [posthogIntegrationConfig, {
 		abortCases: REVENUE_ABORT_CASES
 	},
 	requires: ["posthog-integration"]
-}];
+};
+//#endregion
+//#region src/lib/workflows/posthog-doctor/steps.ts
+const POSTHOG_DOCTOR_WORKFLOW = [
+	{
+		id: "intro",
+		label: "Welcome",
+		screen: "doctor-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screen: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "report",
+		label: "Doctor report",
+		screen: "doctor-report",
+		isComplete: (session) => session.outroData !== null
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screen: "outro",
+		isComplete: (session) => session.outroDismissed
+	}
+];
+//#endregion
+//#region src/lib/workflows/posthog-doctor/types.ts
+const HealthIssueSeveritySchema = z.enum([
+	"critical",
+	"warning",
+	"info"
+]);
+const HealthIssueStatusSchema = z.enum(["active", "resolved"]);
+const HealthIssueSchema = z.object({
+	id: z.string(),
+	kind: z.string(),
+	severity: HealthIssueSeveritySchema,
+	status: HealthIssueStatusSchema,
+	dismissed: z.boolean(),
+	created_at: z.string(),
+	updated_at: z.string(),
+	resolved_at: z.string().nullable().optional()
+});
+const HealthIssueListResponseSchema = z.object({
+	results: z.array(HealthIssueSchema),
+	count: z.number().optional(),
+	next: z.string().nullable().optional(),
+	previous: z.string().nullable().optional()
+});
+//#endregion
+//#region src/lib/workflows/posthog-doctor/fetch.ts
+async function fetchHealthIssues(accessToken, baseUrl, projectId) {
+	const endpoint = `/api/environments/${projectId}/health_issues/`;
+	const url = `${baseUrl}${endpoint}?status=active&dismissed=false&limit=250`;
+	try {
+		const response = await axios.get(url, { headers: {
+			Authorization: `Bearer ${accessToken}`,
+			"User-Agent": WIZARD_USER_AGENT
+		} });
+		return HealthIssueListResponseSchema.parse(response.data).results;
+	} catch (error) {
+		const apiError = handleApiError(error, "fetch health issues");
+		analytics.captureException(apiError, {
+			endpoint,
+			baseUrl,
+			projectId
+		});
+		throw apiError;
+	}
+}
+//#endregion
+//#region src/lib/workflows/posthog-doctor/kind-metadata.ts
+const KIND_METADATA = {
+	ingestion_lag: {
+		title: "Ingestion is delayed",
+		description: "Events are being received but are taking longer than usual to appear.",
+		docsUrl: `${POSTHOG_DOCS_URL}/support/troubleshooting`
+	},
+	ingestion_warning: {
+		title: "Ingestion warnings on recent events",
+		description: "Some recent events were rejected or flagged by the ingestion pipeline.",
+		docsUrl: `${POSTHOG_DOCS_URL}/support/troubleshooting`
+	},
+	sdk_outdated: {
+		title: "SDK version is out of date",
+		description: "One or more SDKs are running an old version. Upgrade to get the latest fixes.",
+		docsUrl: `${POSTHOG_DOCS_URL}/libraries`
+	},
+	no_live_events: {
+		title: "No $pageview or $screen events in the last 30 days",
+		description: "PostHog is not receiving page or screen events from this project.",
+		docsUrl: `${POSTHOG_DOCS_URL}/getting-started/install`
+	},
+	no_pageleave_events: {
+		title: "$pageleave events not being sent",
+		description: "Enable pageleave tracking to power bounce rate and session duration.",
+		docsUrl: `${POSTHOG_DOCS_URL}/libraries/js#config`
+	},
+	scroll_depth: {
+		title: "Scroll depth tracking disabled",
+		description: "Turn on scroll depth to capture how far users read each page.",
+		docsUrl: `${POSTHOG_DOCS_URL}/libraries/js#config`
+	},
+	authorized_urls: {
+		title: "No authorized URLs configured",
+		description: "Some web analytics filters require at least one authorized URL to work.",
+		docsUrl: `${POSTHOG_DOCS_URL}/web-analytics/faq`
+	},
+	reverse_proxy: {
+		title: "No reverse proxy detected",
+		description: "A reverse proxy reduces data loss from ad blockers.",
+		docsUrl: `${POSTHOG_DOCS_URL}/advanced/proxy`
+	},
+	web_vitals: {
+		title: "Web Vitals tracking disabled",
+		description: "Enable Web Vitals to capture LCP, CLS and other performance metrics.",
+		docsUrl: `${POSTHOG_DOCS_URL}/web-analytics/web-vitals`
+	},
+	materialized_view_failure: {
+		title: "A materialized view is failing",
+		description: "A data modeling pipeline failed its most recent run.",
+		docsUrl: `${POSTHOG_DOCS_URL}/data-warehouse`
+	},
+	external_data_failure: {
+		title: "External data source is failing",
+		description: "An external data source sync failed and data may be stale.",
+		docsUrl: `${POSTHOG_DOCS_URL}/data-warehouse/sources`
+	}
+};
+const UNKNOWN_KIND_META = {
+	title: "Unknown issue",
+	description: "PostHog reported an issue kind the wizard does not yet recognize.",
+	docsUrl: POSTHOG_DOCS_URL
+};
+function getKindMeta(kind) {
+	return KIND_METADATA[kind] ?? {
+		...UNKNOWN_KIND_META,
+		title: kind
+	};
+}
+//#endregion
+//#region src/lib/workflows/workflow-registry.ts
+const WORKFLOW_REGISTRY = [
+	posthogIntegrationConfig,
+	revenueAnalyticsConfig,
+	{
+		command: "doctor",
+		description: "Diagnose your PostHog project for configuration issues and setup warnings",
+		flowKey: "posthog-doctor",
+		steps: POSTHOG_DOCTOR_WORKFLOW
+	}
+];
 /** All workflow configs that are exposed as CLI subcommands. */
 function getSubcommandWorkflows() {
 	return WORKFLOW_REGISTRY.filter((c) => c.command != null);
@@ -366,11 +523,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 			return;
 		}
 		(async () => {
-			const { posthogIntegrationConfig } = await import("./posthog-integration-DUZpiyxg.js").then((n) => n.n);
-			const { FRAMEWORK_REGISTRY } = await import("./registry-qfhSxTjo.js").then((n) => n.n);
-			const { detectFramework, gatherFrameworkContext } = await import("./detection-Drfq0l8n.js").then((n) => n.t);
-			const { analytics } = await import("./analytics-DdTDVjqs.js");
-			const { wizardAbort } = await import("./wizard-abort-Bc3lWNLb.js");
+			const { posthogIntegrationConfig } = await import("./posthog-integration-D4SRhJIQ.js").then((n) => n.n);
+			const { FRAMEWORK_REGISTRY } = await import("./registry-DaPKstG3.js").then((n) => n.n);
+			const { detectFramework, gatherFrameworkContext } = await import("./detection-B7GNzve-.js").then((n) => n.t);
+			const { analytics } = await import("./analytics-CfAUlt6-.js");
+			const { wizardAbort } = await import("./wizard-abort-DZmO_sIZ.js");
 			runWizardCI(posthogIntegrationConfig, options, async (session) => {
 				const integration = session.integration ?? await detectFramework(session.installDir);
 				if (!integration) {
@@ -403,11 +560,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		getUI().log.error("This installer requires an interactive terminal (TTY) to run.\nIt appears you are running in a non-interactive environment.\nPlease run the wizard in an interactive terminal.\n\nFor CI/CD environments, use --ci mode:\n  npx @posthog/wizard --ci --region us --api-key phx_xxx");
 		process.exit(1);
 	} else if (options.playground) (async () => {
-		const { startPlayground } = await import("./start-playground-xOLMYzst.js");
+		const { startPlayground } = await import("./start-playground-g1TxpCZ5.js");
 		startPlayground(WIZARD_VERSION);
 	})();
 	else if (options.skill) (async () => {
-		const { createSkillWorkflow } = await import("./agent-skill-BVjJqol6.js").then((n) => n.t);
+		const { createSkillWorkflow } = await import("./agent-skill-DJOzDaQV.js").then((n) => n.t);
 		const skillId = options.skill;
 		runWizard(createSkillWorkflow({
 			skillId,
@@ -417,13 +574,16 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 			integrationLabel: skillId,
 			successMessage: `${skillId} completed!`,
 			reportFile: `posthog-${skillId}-report.md`,
-			docsUrl: "https://posthog.com/docs",
+			docsUrl: POSTHOG_DOCS_URL,
 			spinnerMessage: `Running ${skillId}...`,
 			estimatedDurationMinutes: 5
-		}), options);
+		}), {
+			...options,
+			skillId
+		});
 	})();
 	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-DUZpiyxg.js").then((n) => n.n);
+		const { posthogIntegrationConfig } = await import("./posthog-integration-D4SRhJIQ.js").then((n) => n.n);
 		runWizard(posthogIntegrationConfig, options);
 	})();
 }).command("mcp <command>", "MCP server management commands", (yargs) => {
@@ -447,12 +607,12 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		const mcpFeatures = options.features?.split(",").map((s) => s.trim()).filter(Boolean);
 		(async () => {
-			const { readApiKeyFromEnv } = await import("./env-api-key-K8TdTDII.js");
+			const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
 			const apiKey = options.apiKey || readApiKeyFromEnv();
 			try {
-				const { startTUI } = await import("./start-tui-Ddo4TI9T.js");
-				const { buildSession } = await import("./wizard-session-y7nf6aKH.js");
-				const { Flow } = await import("./router-D5A1Sb4p.js").then((n) => n.n);
+				const { startTUI } = await import("./start-tui-CQef69NR.js");
+				const { buildSession } = await import("./wizard-session-COhklXAF.js");
+				const { Flow } = await import("./router-SgzmfLGi.js").then((n) => n.n);
 				const tui = startTUI(WIZARD_VERSION, Flow.McpAdd);
 				const session = buildSession({
 					debug: options.debug,
@@ -463,7 +623,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-B6baHy_h.js").then((n) => n.r);
+				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Br1hDRiB.js").then((n) => n.r);
 				await addMCPServerToClientsStep({
 					local: options.local,
 					features: mcpFeatures,
@@ -481,9 +641,9 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		(async () => {
 			try {
-				const { startTUI } = await import("./start-tui-Ddo4TI9T.js");
-				const { buildSession } = await import("./wizard-session-y7nf6aKH.js");
-				const { Flow } = await import("./router-D5A1Sb4p.js").then((n) => n.n);
+				const { startTUI } = await import("./start-tui-CQef69NR.js");
+				const { buildSession } = await import("./wizard-session-COhklXAF.js");
+				const { Flow } = await import("./router-SgzmfLGi.js").then((n) => n.n);
 				const tui = startTUI(WIZARD_VERSION, Flow.McpRemove);
 				const session = buildSession({
 					debug: options.debug,
@@ -492,7 +652,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-B6baHy_h.js").then((n) => n.r);
+				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Br1hDRiB.js").then((n) => n.r);
 				await removeMCPServerFromClientsStep({ local: options.local });
 			}
 		})();
@@ -513,8 +673,12 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-Ddo4TI9T.js");
-			const { buildSession } = await import("./wizard-session-y7nf6aKH.js");
+			const { startTUI } = await import("./start-tui-CQef69NR.js");
+			const { buildSession } = await import("./wizard-session-COhklXAF.js");
+			const { TaskStreamPush } = await import("./task-stream-DX_jKDQu.js");
+			const { FileDestination } = await import("./file-DhSBlq-x.js");
+			const { PostHogDestination } = await import("./posthog-ByrpqEjN.js");
+			const { analytics } = await import("./analytics-CfAUlt6-.js");
 			const tui = startTUI(WIZARD_VERSION, config.flowKey);
 			const session = buildSession({
 				debug: options.debug,
@@ -532,24 +696,54 @@ function runWizard(config, options) {
 				yaraReport: options.yaraReport
 			});
 			session.workflowLabel = config.flowKey;
-			session.skillId = (typeof config.run === "object" ? config.run : null)?.skillId ?? null;
+			if (options.skillId) session.skillId = options.skillId;
 			tui.store.session = session;
+			const taskStream = new TaskStreamPush({
+				store: tui.store,
+				workflowId: config.flowKey,
+				destinations: [new FileDestination(), new PostHogDestination()]
+			});
+			tui.store.onTasksChanged = () => void taskStream.push();
 			await tui.store.runReadyHooks();
 			await tui.store.getGate("intro");
-			const { runAgent } = await import("./agent-runner-CBPBefLt.js");
-			await runAgent(config, tui.store.session);
+			const skipAgent = config.run == null;
+			if (skipAgent) {
+				const { getOrAskForProjectData } = await import("./setup-utils-_ONxN-TT.js");
+				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
+					signup: session.signup,
+					ci: session.ci,
+					apiKey: session.apiKey,
+					projectId: session.projectId
+				});
+				tui.store.setCredentials({
+					accessToken,
+					projectApiKey,
+					host,
+					projectId
+				});
+			} else {
+				const { runAgent } = await import("./agent-runner-fWYFO4H0.js");
+				await runAgent(config, tui.store.session);
+			}
+			const isDone = () => skipAgent ? tui.store.session.outroDismissed : tui.store.session.skillsComplete;
 			await new Promise((resolve) => {
 				const unsub = tui.store.subscribe(() => {
-					if (tui.store.session.skillsComplete) {
+					if (isDone()) {
 						unsub();
 						resolve();
 					}
 				});
-				if (tui.store.session.skillsComplete) {
+				if (isDone()) {
 					unsub();
 					resolve();
 				}
 			});
+			try {
+				await taskStream.dispose();
+			} catch (error) {
+				analytics.captureException(error);
+			}
+			tui.unmount();
 			process.exit(0);
 		} catch (err) {
 			if (runtimeEnv("DEBUG") || runtimeEnv("POSTHOG_WIZARD_DEBUG")) console.error("TUI init failed:", err);
@@ -579,11 +773,11 @@ function runWizardCI(config, options, preRun) {
 	}
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-y7nf6aKH.js");
+		const { buildSession } = await import("./wizard-session-COhklXAF.js");
 		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
-		const { readApiKeyFromEnv } = await import("./env-api-key-K8TdTDII.js");
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-CIyf0ZGx.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-Bc3lWNLb.js");
+		const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-D-0xueVl.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-DZmO_sIZ.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -606,7 +800,6 @@ function runWizardCI(config, options, preRun) {
 		});
 		session.workflowLabel = config.flowKey;
 		const runDef = typeof config.run === "object" ? config.run : null;
-		session.skillId = runDef?.skillId ?? null;
 		getUI().intro("Welcome to the PostHog setup wizard");
 		getUI().log.info(`Running ${config.flowKey} in CI mode`);
 		try {
@@ -633,7 +826,7 @@ function runWizardCI(config, options, preRun) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-CBPBefLt.js");
+			const { runAgent } = await import("./agent-runner-fWYFO4H0.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -651,6 +844,6 @@ function runWizardCI(config, options, preRun) {
 	});
 }
 //#endregion
-export { POSTHOG_SDKS as n, STRIPE_SDKS as r, WORKFLOW_REGISTRY as t };
+export { STRIPE_SDKS as a, POSTHOG_SDKS as i, getKindMeta as n, fetchHealthIssues as r, WORKFLOW_REGISTRY as t };
 
 //# sourceMappingURL=bin.js.map