@posthog/wizard 0.7.0 → 0.7.1

package/dist/src/react/react-wizard.js

@@ -0,0 +1,106 @@
+"use strict";
+/* eslint-disable max-lines */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runReactWizard = runReactWizard;
+const clack_utils_1 = require("../utils/clack-utils");
+const package_json_1 = require("../utils/package-json");
+const clack_1 = __importDefault(require("../utils/clack"));
+const constants_1 = require("../lib/constants");
+const docs_1 = require("./docs");
+const analytics_1 = require("../utils/analytics");
+const environment_1 = require("../utils/environment");
+const file_utils_1 = require("../utils/file-utils");
+const clack_utils_2 = require("../utils/clack-utils");
+const messages_1 = require("../lib/messages");
+const steps_1 = require("../steps");
+async function runReactWizard(options) {
+    (0, clack_utils_1.printWelcome)({
+        wizardName: 'PostHog React Wizard',
+    });
+    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
+    if (!aiConsent) {
+        await (0, clack_utils_1.abort)('The React wizard requires AI to get setup right now. Please view the docs to setup React manually instead: https://posthog.com/docs/libraries/react', 0);
+    }
+    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_2.askForCloudRegion)());
+    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
+    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
+    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, 'react', 'React');
+    const reactVersion = (0, package_json_1.getPackageVersion)('react', packageJson);
+    if (reactVersion) {
+        analytics_1.analytics.setTag('react-version', reactVersion);
+    }
+    const { projectApiKey, wizardHash, host } = await (0, clack_utils_1.getOrAskForProjectData)({
+        ...options,
+        cloudRegion,
+    });
+    const sdkAlreadyInstalled = (0, package_json_1.hasPackageInstalled)('posthog-js', packageJson);
+    analytics_1.analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);
+    const { packageManager: packageManagerFromInstallStep } = await (0, clack_utils_1.installPackage)({
+        packageName: 'posthog-js',
+        packageNameDisplayLabel: 'posthog-js',
+        alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],
+        forceInstall: options.forceInstall,
+        askBeforeUpdating: false,
+        installDir: options.installDir,
+        integration: constants_1.Integration.react,
+    });
+    const relevantFiles = await (0, file_utils_1.getRelevantFilesForIntegration)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.react,
+    });
+    const envVarPrefix = await (0, environment_1.detectEnvVarPrefix)(options);
+    const installationDocumentation = (0, docs_1.getReactDocumentation)({
+        language: typeScriptDetected ? 'typescript' : 'javascript',
+        envVarPrefix,
+    });
+    clack_1.default.log.info(`Reviewing PostHog documentation for React`);
+    const filesToChange = await (0, file_utils_1.getFilesToChange)({
+        integration: constants_1.Integration.react,
+        relevantFiles,
+        documentation: installationDocumentation,
+        wizardHash,
+        cloudRegion,
+    });
+    await (0, file_utils_1.generateFileChangesForIntegration)({
+        integration: constants_1.Integration.react,
+        filesToChange,
+        wizardHash,
+        installDir: options.installDir,
+        documentation: installationDocumentation,
+        cloudRegion,
+    });
+    const { relativeEnvFilePath, addedEnvVariables } = await (0, steps_1.addOrUpdateEnvironmentVariablesStep)({
+        variables: {
+            [envVarPrefix + 'POSTHOG_KEY']: projectApiKey,
+            [envVarPrefix + 'POSTHOG_HOST']: host,
+        },
+        installDir: options.installDir,
+        integration: constants_1.Integration.react,
+    });
+    const packageManagerForOutro = packageManagerFromInstallStep ?? (await (0, clack_utils_1.getPackageManager)(options));
+    await (0, steps_1.runPrettierStep)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.react,
+    });
+    const addedEditorRules = await (0, steps_1.addEditorRulesStep)({
+        installDir: options.installDir,
+        rulesName: 'react-rules.md',
+        integration: constants_1.Integration.react,
+        default: options.default,
+    });
+    const outroMessage = (0, messages_1.getOutroMessage)({
+        options,
+        integration: constants_1.Integration.react,
+        cloudRegion,
+        addedEditorRules,
+        packageManager: packageManagerForOutro,
+        envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,
+    });
+    clack_1.default.outro(outroMessage);
+    await analytics_1.analytics.shutdown('success');
+}
+//# sourceMappingURL=react-wizard.js.map

package/dist/src/react/react-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-wizard.js","sourceRoot":"","sources":["../../../src/react/react-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\n\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  getPackageManager,\n  installPackage,\n  isUsingTypeScript,\n  printWelcome,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport clack from '../utils/clack';\nimport { Integration } from '../lib/constants';\nimport { getReactDocumentation } from './docs';\nimport { analytics } from '../utils/analytics';\nimport { detectEnvVarPrefix } from '../utils/environment';\nimport {\n  generateFileChangesForIntegration,\n  getFilesToChange,\n  getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { getOutroMessage } from '../lib/messages';\nimport {\n  addEditorRulesStep,\n  addOrUpdateEnvironmentVariablesStep,\n  runPrettierStep,\n} from '../steps';\n\nexport async function runReactWizard(options: WizardOptions): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog React Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The React wizard requires AI to get setup right now. Please view the docs to setup React manually instead: https://posthog.com/docs/libraries/react',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n\n  await ensurePackageIsInstalled(packageJson, 'react', 'React');\n\n  const reactVersion = getPackageVersion('react', packageJson);\n\n  if (reactVersion) {\n    analytics.setTag('react-version', reactVersion);\n  }\n\n  const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n  analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n  const { packageManager: packageManagerFromInstallStep } =\n    await installPackage({\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],\n      forceInstall: options.forceInstall,\n      askBeforeUpdating: false,\n      installDir: options.installDir,\n      integration: Integration.react,\n    });\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  const envVarPrefix = await detectEnvVarPrefix(options);\n\n  const installationDocumentation = getReactDocumentation({\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n    envVarPrefix,\n  });\n\n  clack.log.info(`Reviewing PostHog documentation for React`);\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.react,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.react,\n    filesToChange,\n    wizardHash,\n    installDir: options.installDir,\n    documentation: installationDocumentation,\n    cloudRegion,\n  });\n\n  const { relativeEnvFilePath, addedEnvVariables } =\n    await addOrUpdateEnvironmentVariablesStep({\n      variables: {\n        [envVarPrefix + 'POSTHOG_KEY']: projectApiKey,\n        [envVarPrefix + 'POSTHOG_HOST']: host,\n      },\n      installDir: options.installDir,\n      integration: Integration.react,\n    });\n\n  const packageManagerForOutro =\n    packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n  await runPrettierStep({\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  const addedEditorRules = await addEditorRulesStep({\n    installDir: options.installDir,\n    rulesName: 'react-rules.md',\n    integration: Integration.react,\n    default: options.default,\n  });\n\n  const outroMessage = getOutroMessage({\n    options,\n    integration: Integration.react,\n    cloudRegion,\n    addedEditorRules,\n    packageManager: packageManagerForOutro,\n    envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,\n  });\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n"]}

package/dist/src/react-native/docs.d.ts

@@ -0,0 +1,5 @@
+export declare const getReactNativeDocumentation: ({ language, host, projectApiKey, }: {
+    language: "typescript" | "javascript";
+    host: string;
+    projectApiKey: string;
+}) => string;

package/dist/src/react-native/docs.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReactNativeDocumentation = void 0;
+const getReactNativeDocumentation = ({ language, host, projectApiKey, }) => {
+    return `
+==============================
+FILE: Modify the entrypoint for the app code
+LOCATION: Usually app/_layout.${language === 'typescript' ? 'tsx' : 'jsx'}, app/index.${language === 'typescript' ? 'ts' : 'js'}, App.${language === 'typescript' ? 'tsx' : 'jsx'} or something similar. There is only one entrypoint file, so you should edit the existing one.
+==============================
+Changes:
+- Add the PostHogProvider to the root of the app in the provider tree. If other providers are already present, add it in a suitable location.
+
+Example (with the correct API key and host):
+--------------------------------------------------
+import { PostHogProvider } from 'posthog-react-native'
+...
+
+export function MyApp() {
+    return (
+        <PostHogProvider apiKey="${projectApiKey}" options={{
+            host: '${host}', 
+            enableSessionReplay: true,
+        }} autocapture>
+         ...
+        </PostHogProvider>
+    )
+}
+--------------------------------------------------`;
+};
+exports.getReactNativeDocumentation = getReactNativeDocumentation;
+//# sourceMappingURL=docs.js.map

package/dist/src/react-native/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/react-native/docs.ts"],"names":[],"mappings":";;;AAAO,MAAM,2BAA2B,GAAG,CAAC,EAC1C,QAAQ,EACR,IAAI,EACJ,aAAa,GAKd,EAAE,EAAE;IACH,OAAO;;;gCAIL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC,eAAe,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SACpD,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;mCAYiC,aAAa;qBAC3B,IAAI;;;;;;;mDAO0B,CAAC;AACpD,CAAC,CAAC;AArCW,QAAA,2BAA2B,+BAqCtC","sourcesContent":["export const getReactNativeDocumentation = ({\n  language,\n  host,\n  projectApiKey,\n}: {\n  language: 'typescript' | 'javascript';\n  host: string;\n  projectApiKey: string;\n}) => {\n  return `\n==============================\nFILE: Modify the entrypoint for the app code\nLOCATION: Usually app/_layout.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  }, app/index.${language === 'typescript' ? 'ts' : 'js'}, App.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } or something similar. There is only one entrypoint file, so you should edit the existing one.\n==============================\nChanges:\n- Add the PostHogProvider to the root of the app in the provider tree. If other providers are already present, add it in a suitable location.\n\nExample (with the correct API key and host):\n--------------------------------------------------\nimport { PostHogProvider } from 'posthog-react-native'\n...\n\nexport function MyApp() {\n    return (\n        <PostHogProvider apiKey=\"${projectApiKey}\" options={{\n            host: '${host}', \n            enableSessionReplay: true,\n        }} autocapture>\n         ...\n        </PostHogProvider>\n    )\n}\n--------------------------------------------------`;\n};\n"]}

package/dist/src/react-native/react-native-wizard.d.ts

@@ -0,0 +1,2 @@
+import type { WizardOptions } from '../utils/types';
+export declare function runReactNativeWizard(options: WizardOptions): Promise<void>;

package/dist/src/react-native/react-native-wizard.js

@@ -0,0 +1,123 @@
+"use strict";
+/* eslint-disable max-lines */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runReactNativeWizard = runReactNativeWizard;
+const clack_utils_1 = require("../utils/clack-utils");
+const package_json_1 = require("../utils/package-json");
+const clack_1 = __importDefault(require("../utils/clack"));
+const constants_1 = require("../lib/constants");
+const docs_1 = require("./docs");
+const analytics_1 = require("../utils/analytics");
+const file_utils_1 = require("../utils/file-utils");
+const clack_utils_2 = require("../utils/clack-utils");
+const steps_1 = require("../steps");
+const package_manager_1 = require("../utils/package-manager");
+const messages_1 = require("../lib/messages");
+async function runReactNativeWizard(options) {
+    (0, clack_utils_1.printWelcome)({
+        wizardName: 'PostHog React Native Wizard',
+    });
+    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
+    if (!aiConsent) {
+        await (0, clack_utils_1.abort)('The React Native wizard requires AI to get setup right now. Please view the docs to setup React Native manually instead: https://posthog.com/docs/libraries/react-native', 0);
+    }
+    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_2.askForCloudRegion)());
+    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
+    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
+    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, 'react-native', 'React Native');
+    const reactNativeVersion = (0, package_json_1.getPackageVersion)('react-native', packageJson);
+    if (reactNativeVersion) {
+        analytics_1.analytics.setTag('react-native-version', reactNativeVersion);
+    }
+    const { projectApiKey, wizardHash, host } = await (0, clack_utils_1.getOrAskForProjectData)({
+        ...options,
+        cloudRegion,
+    });
+    const sdkAlreadyInstalled = (0, package_json_1.hasPackageInstalled)('posthog-js', packageJson);
+    analytics_1.analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);
+    const isUsingExpo = (0, package_json_1.hasPackageInstalled)('expo', packageJson);
+    if (isUsingExpo) {
+        analytics_1.analytics.setTag('is-using-expo', true);
+        analytics_1.analytics.setTag('expo-version', (0, package_json_1.getPackageVersion)('expo', packageJson));
+    }
+    clack_1.default.log.info(`Detected ${isUsingExpo ? 'Expo' : 'React Native'}`);
+    const packagesToInstall = isUsingExpo
+        ? [
+            'posthog-react-native',
+            'posthog-react-native-session-replay',
+            'expo-file-system',
+            'expo-application',
+            'expo-device',
+            'expo-localization',
+        ]
+        : [
+            'posthog-react-native',
+            '@react-native-async-storage/async-storage',
+            'react-native-device-info',
+            'react-native-localize',
+        ];
+    for (const packageName of packagesToInstall) {
+        await (0, clack_utils_1.installPackage)({
+            packageName,
+            packageNameDisplayLabel: packageName,
+            alreadyInstalled: !!packageJson?.dependencies?.[packageName],
+            forceInstall: options.forceInstall,
+            askBeforeUpdating: false,
+            installDir: options.installDir,
+            integration: constants_1.Integration.reactNative,
+            packageManager: isUsingExpo ? package_manager_1.EXPO : undefined,
+        });
+    }
+    const relevantFiles = await (0, file_utils_1.getRelevantFilesForIntegration)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.reactNative,
+    });
+    const installationDocumentation = (0, docs_1.getReactNativeDocumentation)({
+        language: typeScriptDetected ? 'typescript' : 'javascript',
+        host,
+        projectApiKey,
+    });
+    clack_1.default.log.info(`Reviewing PostHog documentation for ${isUsingExpo ? 'Expo' : 'React Native'}`);
+    const filesToChange = await (0, file_utils_1.getFilesToChange)({
+        integration: constants_1.Integration.reactNative,
+        relevantFiles,
+        documentation: installationDocumentation,
+        wizardHash,
+        cloudRegion,
+    });
+    await (0, file_utils_1.generateFileChangesForIntegration)({
+        integration: constants_1.Integration.reactNative,
+        filesToChange,
+        wizardHash,
+        installDir: options.installDir,
+        documentation: installationDocumentation,
+        cloudRegion,
+    });
+    await (0, steps_1.runPrettierStep)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.reactNative,
+    });
+    const addedEditorRules = await (0, steps_1.addEditorRulesStep)({
+        installDir: options.installDir,
+        rulesName: 'react-native-rules.md',
+        integration: constants_1.Integration.reactNative,
+        default: options.default,
+    });
+    const packageManagerForOutro = await (0, clack_utils_1.getPackageManager)({
+        installDir: options.installDir,
+    });
+    const outroMessage = (0, messages_1.getOutroMessage)({
+        options,
+        integration: constants_1.Integration.reactNative,
+        cloudRegion,
+        addedEditorRules,
+        packageManager: packageManagerForOutro,
+    });
+    clack_1.default.outro(outroMessage);
+    await analytics_1.analytics.shutdown('success');
+}
+//# sourceMappingURL=react-native-wizard.js.map

package/dist/src/react-native/react-native-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-wizard.js","sourceRoot":"","sources":["../../../src/react-native/react-native-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\n\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  getPackageManager,\n  installPackage,\n  isUsingTypeScript,\n  printWelcome,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport clack from '../utils/clack';\nimport { Integration } from '../lib/constants';\nimport { getReactNativeDocumentation } from './docs';\nimport { analytics } from '../utils/analytics';\nimport {\n  generateFileChangesForIntegration,\n  getFilesToChange,\n  getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { addEditorRulesStep, runPrettierStep } from '../steps';\nimport { EXPO } from '../utils/package-manager';\nimport { getOutroMessage } from '../lib/messages';\n\nexport async function runReactNativeWizard(\n  options: WizardOptions,\n): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog React Native Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The React Native wizard requires AI to get setup right now. Please view the docs to setup React Native manually instead: https://posthog.com/docs/libraries/react-native',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n\n  await ensurePackageIsInstalled(packageJson, 'react-native', 'React Native');\n\n  const reactNativeVersion = getPackageVersion('react-native', packageJson);\n\n  if (reactNativeVersion) {\n    analytics.setTag('react-native-version', reactNativeVersion);\n  }\n\n  const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n  analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n  const isUsingExpo = hasPackageInstalled('expo', packageJson);\n\n  if (isUsingExpo) {\n    analytics.setTag('is-using-expo', true);\n    analytics.setTag('expo-version', getPackageVersion('expo', packageJson));\n  }\n\n  clack.log.info(`Detected ${isUsingExpo ? 'Expo' : 'React Native'}`);\n\n  const packagesToInstall = isUsingExpo\n    ? [\n        'posthog-react-native',\n        'posthog-react-native-session-replay',\n        'expo-file-system',\n        'expo-application',\n        'expo-device',\n        'expo-localization',\n      ]\n    : [\n        'posthog-react-native',\n        '@react-native-async-storage/async-storage',\n        'react-native-device-info',\n        'react-native-localize',\n      ];\n\n  for (const packageName of packagesToInstall) {\n    await installPackage({\n      packageName,\n      packageNameDisplayLabel: packageName,\n      alreadyInstalled: !!packageJson?.dependencies?.[packageName],\n      forceInstall: options.forceInstall,\n      askBeforeUpdating: false,\n      installDir: options.installDir,\n      integration: Integration.reactNative,\n      packageManager: isUsingExpo ? EXPO : undefined,\n    });\n  }\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.reactNative,\n  });\n\n  const installationDocumentation = getReactNativeDocumentation({\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n    host,\n    projectApiKey,\n  });\n\n  clack.log.info(\n    `Reviewing PostHog documentation for ${\n      isUsingExpo ? 'Expo' : 'React Native'\n    }`,\n  );\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.reactNative,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.reactNative,\n    filesToChange,\n    wizardHash,\n    installDir: options.installDir,\n    documentation: installationDocumentation,\n    cloudRegion,\n  });\n\n  await runPrettierStep({\n    installDir: options.installDir,\n    integration: Integration.reactNative,\n  });\n\n  const addedEditorRules = await addEditorRulesStep({\n    installDir: options.installDir,\n    rulesName: 'react-native-rules.md',\n    integration: Integration.reactNative,\n    default: options.default,\n  });\n\n  const packageManagerForOutro = await getPackageManager({\n    installDir: options.installDir,\n  });\n\n  const outroMessage = getOutroMessage({\n    options,\n    integration: Integration.reactNative,\n    cloudRegion,\n    addedEditorRules,\n    packageManager: packageManagerForOutro,\n  });\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n"]}

package/dist/src/run.d.ts

@@ -0,0 +1,13 @@
+import type { CloudRegion } from './utils/types';
+import { Integration } from './lib/constants';
+type Args = {
+    integration?: Integration;
+    debug?: boolean;
+    forceInstall?: boolean;
+    installDir?: string;
+    region?: CloudRegion;
+    default?: boolean;
+    signup?: boolean;
+};
+export declare function run(argv: Args): Promise<void>;
+export {};

package/dist/src/run.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const clack_utils_1 = require("./utils/clack-utils");
+const nextjs_wizard_1 = require("./nextjs/nextjs-wizard");
+const constants_1 = require("./lib/constants");
+const environment_1 = require("./utils/environment");
+const clack_1 = __importDefault(require("./utils/clack"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./lib/config");
+const react_wizard_1 = require("./react/react-wizard");
+const analytics_1 = require("./utils/analytics");
+const svelte_wizard_1 = require("./svelte/svelte-wizard");
+const react_native_wizard_1 = require("./react-native/react-native-wizard");
+const events_1 = require("events");
+events_1.EventEmitter.defaultMaxListeners = 50;
+async function run(argv) {
+    await runWizard(argv);
+}
+async function runWizard(argv) {
+    const finalArgs = {
+        ...argv,
+        ...(0, environment_1.readEnvironment)(),
+    };
+    const wizardOptions = {
+        debug: finalArgs.debug ?? false,
+        forceInstall: finalArgs.forceInstall ?? false,
+        installDir: finalArgs.installDir
+            ? path_1.default.join(process.cwd(), finalArgs.installDir)
+            : process.cwd(),
+        cloudRegion: finalArgs.region ?? undefined,
+        default: finalArgs.default ?? false,
+        signup: finalArgs.signup ?? false,
+    };
+    clack_1.default.intro(`Welcome to the PostHog setup wizard ✨`);
+    const integration = finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));
+    analytics_1.analytics.setTag('integration', integration);
+    switch (integration) {
+        case constants_1.Integration.nextjs:
+            await (0, nextjs_wizard_1.runNextjsWizard)(wizardOptions);
+            break;
+        case constants_1.Integration.react:
+            await (0, react_wizard_1.runReactWizard)(wizardOptions);
+            break;
+        case constants_1.Integration.svelte:
+            await (0, svelte_wizard_1.runSvelteWizard)(wizardOptions);
+            break;
+        case constants_1.Integration.reactNative:
+            await (0, react_native_wizard_1.runReactNativeWizard)(wizardOptions);
+            break;
+        default:
+            clack_1.default.log.error('No setup wizard selected!');
+    }
+}
+async function detectIntegration(options) {
+    const integrationConfigs = Object.entries(config_1.INTEGRATION_CONFIG).sort(([a], [b]) => config_1.INTEGRATION_ORDER.indexOf(a) -
+        config_1.INTEGRATION_ORDER.indexOf(b));
+    for (const [integration, config] of integrationConfigs) {
+        const detected = await config.detect(options);
+        if (detected) {
+            return integration;
+        }
+    }
+}
+async function getIntegrationForSetup(options) {
+    const detectedIntegration = await detectIntegration(options);
+    if (detectedIntegration) {
+        clack_1.default.log.success(`Detected integration: ${(0, constants_1.getIntegrationDescription)(detectedIntegration)}`);
+        return detectedIntegration;
+    }
+    const integration = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
+        message: 'What do you want to set up?',
+        options: [
+            { value: constants_1.Integration.nextjs, label: 'Next.js' },
+            { value: constants_1.Integration.react, label: 'React' },
+            { value: constants_1.Integration.svelte, label: 'Svelte' },
+            { value: constants_1.Integration.reactNative, label: 'React Native' },
+        ],
+    }));
+    return integration;
+}
+//# sourceMappingURL=run.js.map

package/dist/src/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortIfCancelled } from './utils/clack-utils';\n\nimport { runNextjsWizard } from './nextjs/nextjs-wizard';\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport { getIntegrationDescription, Integration } from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { INTEGRATION_CONFIG, INTEGRATION_ORDER } from './lib/config';\nimport { runReactWizard } from './react/react-wizard';\nimport { analytics } from './utils/analytics';\nimport { runSvelteWizard } from './svelte/svelte-wizard';\nimport { runReactNativeWizard } from './react-native/react-native-wizard';\nimport { EventEmitter } from 'events';\n\nEventEmitter.defaultMaxListeners = 50;\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n  signup?: boolean;\n};\n\nexport async function run(argv: Args) {\n  await runWizard(argv);\n}\n\nasync function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: finalArgs.installDir\n      ? path.join(process.cwd(), finalArgs.installDir)\n      : process.cwd(),\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n    signup: finalArgs.signup ?? false,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  analytics.setTag('integration', integration);\n\n  switch (integration) {\n    case Integration.nextjs:\n      await runNextjsWizard(wizardOptions);\n      break;\n    case Integration.react:\n      await runReactWizard(wizardOptions);\n      break;\n    case Integration.svelte:\n      await runSvelteWizard(wizardOptions);\n      break;\n    case Integration.reactNative:\n      await runReactNativeWizard(wizardOptions);\n      break;\n    default:\n      clack.log.error('No setup wizard selected!');\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  const integrationConfigs = Object.entries(INTEGRATION_CONFIG).sort(\n    ([a], [b]) =>\n      INTEGRATION_ORDER.indexOf(a as Integration) -\n      INTEGRATION_ORDER.indexOf(b as Integration),\n  );\n\n  for (const [integration, config] of integrationConfigs) {\n    const detected = await config.detect(options);\n    if (detected) {\n      return integration as Integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir'>,\n) {\n  const detectedIntegration = await detectIntegration(options);\n\n  if (detectedIntegration) {\n    clack.log.success(\n      `Detected integration: ${getIntegrationDescription(detectedIntegration)}`,\n    );\n    return detectedIntegration;\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: [\n        { value: Integration.nextjs, label: 'Next.js' },\n        { value: Integration.react, label: 'React' },\n        { value: Integration.svelte, label: 'Svelte' },\n        { value: Integration.reactNative, label: 'React Native' },\n      ],\n    }),\n  );\n\n  return integration;\n}\n"]}

package/dist/src/steps/__tests__/add-editor-rules.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/steps/__tests__/add-editor-rules.test.js

@@ -0,0 +1,218 @@
+"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 });
+const fs = __importStar(require("fs"));
+const path_1 = __importDefault(require("path"));
+const add_editor_rules_1 = require("../add-editor-rules");
+const analytics_1 = require("../../utils/analytics");
+const clack_1 = __importDefault(require("../../utils/clack"));
+const chalk_1 = __importDefault(require("chalk"));
+// Mock dependencies
+jest.mock('fs', () => ({
+    promises: {
+        mkdir: jest.fn(),
+        readFile: jest.fn(),
+        writeFile: jest.fn(),
+    },
+}));
+jest.mock('../../utils/analytics', () => ({
+    analytics: {
+        capture: jest.fn(),
+        setTag: jest.fn(),
+        shutdown: jest.fn().mockResolvedValue(undefined),
+    },
+}));
+jest.mock('../../utils/clack', () => ({
+    log: {
+        info: jest.fn(),
+    },
+    select: jest.fn().mockResolvedValue(true),
+    isCancel: jest.fn((value) => false),
+    cancel: jest.fn(),
+}));
+describe('addEditorRules', () => {
+    const mockOptions = {
+        installDir: '/test/dir',
+        rulesName: 'react-rules.md',
+        integration: 'react',
+    };
+    const originalEnv = process.env;
+    const mkdirMock = fs.promises.mkdir;
+    const readFileMock = fs.promises.readFile;
+    const writeFileMock = fs.promises.writeFile;
+    // eslint-disable-next-line @typescript-eslint/unbound-method
+    const captureMock = analytics_1.analytics.capture;
+    const infoMock = clack_1.default.log.info;
+    const selectMock = clack_1.default.select;
+    const isCancelMock = clack_1.default.isCancel;
+    const cancelMock = clack_1.default.cancel;
+    beforeEach(() => {
+        // Reset all mocks before each test
+        jest.clearAllMocks();
+        // Clear mock implementations
+        fs.promises.mkdir.mockReset();
+        fs.promises.readFile.mockReset();
+        fs.promises.writeFile.mockReset();
+        selectMock.mockReset();
+        selectMock.mockResolvedValue(true); // Default to "Yes" for the prompt
+        isCancelMock.mockReset();
+        isCancelMock.mockReturnValue(false);
+        cancelMock.mockReset();
+        process.env = { ...originalEnv };
+    });
+    afterAll(() => {
+        process.env = originalEnv;
+    });
+    it('should not install rules when CURSOR_TRACE_ID is not set', async () => {
+        delete process.env.CURSOR_TRACE_ID;
+        await (0, add_editor_rules_1.addEditorRulesStep)(mockOptions);
+        expect(mkdirMock).not.toHaveBeenCalled();
+        expect(readFileMock).not.toHaveBeenCalled();
+        expect(writeFileMock).not.toHaveBeenCalled();
+        expect(captureMock).not.toHaveBeenCalled();
+        expect(infoMock).not.toHaveBeenCalled();
+    });
+    it('should install rules when CURSOR_TRACE_ID is set', async () => {
+        process.env.CURSOR_TRACE_ID = 'test-trace-id';
+        const mockFrameworkRules = 'framework rules {universal} content';
+        const mockUniversalRules = 'universal rules content';
+        const expectedCombinedRules = 'framework rules universal rules content content';
+        fs.promises.readFile
+            .mockImplementationOnce(() => Promise.resolve(mockFrameworkRules))
+            .mockImplementationOnce(() => Promise.resolve(mockUniversalRules));
+        await (0, add_editor_rules_1.addEditorRulesStep)(mockOptions);
+        // Check if directory was created
+        expect(mkdirMock).toHaveBeenCalledWith(path_1.default.join('/test/dir', '.cursor', 'rules'), { recursive: true });
+        // Check if correct files were read
+        expect(readFileMock).toHaveBeenCalledTimes(2);
+        expect(readFileMock).toHaveBeenNthCalledWith(1, expect.stringMatching(/react-rules\.md$/), 'utf8');
+        expect(readFileMock).toHaveBeenNthCalledWith(2, expect.stringMatching(/universal\.md$/), 'utf8');
+        // Check if combined rules were written correctly
+        expect(writeFileMock).toHaveBeenCalledWith(path_1.default.join('/test/dir', '.cursor', 'rules', 'posthog-integration.mdc'), expectedCombinedRules, 'utf8');
+        // Check if analytics were captured
+        expect(captureMock).toHaveBeenCalledWith('wizard interaction', {
+            action: 'added editor rules',
+            integration: mockOptions.integration,
+        });
+        // Check if success message was logged
+        expect(infoMock).toHaveBeenCalledWith(`Added Cursor rules to ${chalk_1.default.bold.cyan('.cursor/rules/posthog-integration.mdc')}`);
+    });
+    it('should handle file system errors gracefully', async () => {
+        process.env.CURSOR_TRACE_ID = 'test-trace-id';
+        const mockError = new Error('File not found');
+        // Mock readFile to throw an error
+        fs.promises.readFile.mockRejectedValue(mockError);
+        await expect((0, add_editor_rules_1.addEditorRulesStep)(mockOptions)).rejects.toThrow(mockError);
+        expect(writeFileMock).not.toHaveBeenCalled();
+        expect(captureMock).not.toHaveBeenCalled();
+        expect(infoMock).not.toHaveBeenCalled();
+    });
+    it('should handle missing rules files gracefully', async () => {
+        process.env.CURSOR_TRACE_ID = 'test-trace-id';
+        const mockError = new Error('File system error');
+        // Mock mkdir to throw an error
+        fs.promises.mkdir.mockRejectedValue(mockError);
+        await expect((0, add_editor_rules_1.addEditorRulesStep)(mockOptions)).rejects.toThrow(mockError);
+        expect(writeFileMock).not.toHaveBeenCalled();
+        expect(captureMock).not.toHaveBeenCalled();
+        expect(infoMock).not.toHaveBeenCalled();
+    });
+    it('should correctly substitute universal rules with realistic content', async () => {
+        process.env.CURSOR_TRACE_ID = 'test-trace-id';
+        const mockFrameworkRules = `---
+description: apply when interacting with PostHog/analytics tasks
+globs: 
+alwaysApply: true
+---
+
+{universal}
+
+# Framework-specific rules
+- Rule 1
+- Rule 2`;
+        const mockUniversalRules = `Never hallucinate an API key. Instead, always use the API key populated in the .env file.
+
+# Feature flags
+
+A given feature flag should be used in as few places as possible. Do not increase the risk of undefined behavior by scattering the same feature flag across multiple areas of code.`;
+        const expectedCombinedRules = `---
+description: apply when interacting with PostHog/analytics tasks
+globs: 
+alwaysApply: true
+---
+
+Never hallucinate an API key. Instead, always use the API key populated in the .env file.
+
+# Feature flags
+
+A given feature flag should be used in as few places as possible. Do not increase the risk of undefined behavior by scattering the same feature flag across multiple areas of code.
+
+# Framework-specific rules
+- Rule 1
+- Rule 2`;
+        fs.promises.readFile
+            .mockImplementationOnce(() => Promise.resolve(mockFrameworkRules))
+            .mockImplementationOnce(() => Promise.resolve(mockUniversalRules));
+        await (0, add_editor_rules_1.addEditorRulesStep)(mockOptions);
+        // Check if directory was created
+        expect(mkdirMock).toHaveBeenCalledWith(path_1.default.join('/test/dir', '.cursor', 'rules'), { recursive: true });
+        // Check if correct files were read
+        expect(readFileMock).toHaveBeenCalledWith(expect.stringMatching(/react-rules\.md$/), 'utf8');
+        expect(readFileMock).toHaveBeenCalledWith(expect.stringMatching(/universal\.md$/), 'utf8');
+        // Check if combined rules were written correctly
+        expect(writeFileMock).toHaveBeenCalledWith(path_1.default.join('/test/dir', '.cursor', 'rules', 'posthog-integration.mdc'), expectedCombinedRules, 'utf8');
+        // Check if analytics were captured
+        expect(captureMock).toHaveBeenCalledWith('wizard interaction', {
+            action: 'added editor rules',
+            integration: mockOptions.integration,
+        });
+        // Check if success message was logged
+        expect(infoMock).toHaveBeenCalledWith(`Added Cursor rules to ${chalk_1.default.bold.cyan('.cursor/rules/posthog-integration.mdc')}`);
+    });
+    it('should not install rules when user declines', async () => {
+        process.env.CURSOR_TRACE_ID = 'test-trace-id';
+        selectMock.mockResolvedValue(false);
+        await (0, add_editor_rules_1.addEditorRulesStep)(mockOptions);
+        expect(mkdirMock).not.toHaveBeenCalled();
+        expect(readFileMock).not.toHaveBeenCalled();
+        expect(writeFileMock).not.toHaveBeenCalled();
+        expect(captureMock).not.toHaveBeenCalled();
+        expect(infoMock).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=add-editor-rules.test.js.map