feat: prevent users from running wizard in non tty env

bin.ts

@@ -4,6 +4,7 @@
 
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
+import chalk from 'chalk';
 
 const NODE_VERSION_RANGE = '>=18.17.0';
 
@@ -20,8 +21,23 @@
 import type { CloudRegion, WizardOptions } from './src/utils/types';
 import { runWizard } from './src/run';
 import { runEventSetupWizard } from './src/nextjs/event-setup';
-import { readEnvironment } from './src/utils/environment';
+import {
+  readEnvironment,
+  isNonInteractiveEnvironment,
+} from './src/utils/environment';
 import path from 'path';
+import clack from './src/utils/clack';
+
+if (isNonInteractiveEnvironment()) {
+  clack.intro(chalk.inverse(`PostHog Wizard`));
+
+  clack.log.error(
+    'This installer requires an interactive terminal (TTY) to run.\n' +
+      'It appears you are running in a non-interactive environment.\n' +
+      'Please run the wizard in an interactive terminal.',
+  );
+  process.exit(1);
+}
 
 if (process.env.NODE_ENV === 'test') {
   void (async () => {
@@ -104,24 +120,24 @@
       });
     },
     (argv) => {
       const finalArgs = {
         ...argv,
         ...readEnvironment(),
       } as any;
 
       let resolvedInstallDir: string;
       if (finalArgs.installDir) {
         if (path.isAbsolute(finalArgs.installDir)) {
           resolvedInstallDir = finalArgs.installDir;
         } else {
           resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);
         }
       } else {
         resolvedInstallDir = process.cwd();
       }
 
       const wizardOptions: WizardOptions = {
         debug: finalArgs.debug ?? false,
         installDir: resolvedInstallDir,
         cloudRegion: finalArgs.region as CloudRegion | undefined,
         default: finalArgs.default ?? false,

src/utils/environment.ts

@@ -2,6 +2,19 @@ import readEnv from 'read-env';
 import { getPackageDotJson } from './clack-utils';
 import type { WizardOptions } from './types';
 import fg from 'fast-glob';
+import { IS_DEV } from '../lib/constants';
+
+export function isNonInteractiveEnvironment(): boolean {
+  if (IS_DEV) {
+    return false;
+  }
+
+  if (!process.stdout.isTTY || !process.stderr.isTTY) {
+    return true;
+  }
+
+  return false;
+}
 
 export function readEnvironment(): Record<string, unknown> {
   const result = readEnv('POSTHOG_WIZARD');