@posthog/wizard 0.7.0 → 0.8.0

package/dist/src/svelte/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/svelte/docs.ts"],"names":[],"mappings":";;;AAAO,MAAM,sBAAsB,GAAG,CAAC,EACrC,QAAQ,GAGT,EAAE,EAAE;IACH,OAAO;;oBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IACrC,6BAA6B,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;0EAElE,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAkDE,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAkDiD,CAAC;AACpD,CAAC,CAAC;AAlHW,QAAA,sBAAsB,0BAkHjC","sourcesContent":["export const getSvelteDocumentation = ({\n  language,\n}: {\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: Root layout.${\n    language === 'typescript' ? 'ts' : 'js'\n  } file (e.g routes/+layout.${language === 'typescript' ? 'ts' : 'js'})\nLOCATION: Usually placed at the root of the app (e.g src/routes/+layout.${\n    language === 'typescript' ? 'ts' : 'js'\n  })\n==============================\nChanges:\n- Add a load function to initialize PostHog, checking if the browser is available to make sure it only initializes on the client\nExample:\n--------------------------------------------------\nimport posthog from 'posthog-js'\nimport { browser } from '$app/environment';\nimport { PUBLIC_POSTHOG_KEY } from '$env/static/public';\n\nexport const load = async () => {\n\n  if (browser) {\n    posthog.init(\n      PUBLIC_POSTHOG_KEY,\n      {\n        api_host: PUBLIC_POSTHOG_HOST,\n        capture_pageview: false,\n        capture_pageleave: false\n      }\n    )\n  }\n  return\n};\n--------------------------------------------------\n\n==============================\nFile: Root layout .svelte file (e.g routes/+layout.svelte)\nLOCATION: Usually placed at the root of the app (e.g src/routes/+layout.svelte)\n==============================\nChanges:\n- Add pageview & pageleave tracking to the layout\n\nExample:\n--------------------------------------------------\n<script>\n  import { browser } from '$app/environment';\n  import { beforeNavigate, afterNavigate } from '$app/navigation';\n  import posthog from 'posthog-js'\n\n  if (browser) {\n    beforeNavigate(() => posthog.capture('$pageleave'));\n    afterNavigate(() => posthog.capture('$pageview'));\n  }\n</script>\n--------------------------------------------------\n\n==============================\nFile: PostHog server initializion\nLOCATION: With other server-side code, e.g. src/lib/server/posthog${\n    language === 'typescript' ? '.ts' : '.js'\n  }\n==============================\nChanges:\n- Initialize a PostHog client for the server using posthog-node that can be used in other server-side code\nExample:\n--------------------------------------------------\nimport posthog, { PostHog } from 'posthog-node';\nimport { PUBLIC_POSTHOG_KEY, PUBLIC_POSTHOG_HOST } from '$env/static/public';\n\nlet _client: PostHog | null = null;\n\nexport function getPostHogClient() {\n  if (!_client) {\n    _client = new posthog.PostHog(PUBLIC_POSTHOG_KEY, {\n      host: PUBLIC_POSTHOG_HOST,\n    });\n  }\n  return _client;\n}\n--------------------------------------------------\n\n==============================\nFILE: Svelte Config (e.g svelte.config.js)\nLOCATION: Wherever the root of the app is\n==============================\nChanges:\n- Set config to not use relative asset paths\n\nExample:\n--------------------------------------------------\nimport adapter from '@sveltejs/adapter-auto';\nimport { vitePreprocess } from '@sveltejs/vite-plugin-svelte';\n\n/** @type {import('@sveltejs/kit').Config} */\nconst config = {\n\t// Consult https://svelte.dev/docs/kit/integrations\n\t// for more information about preprocessors\n\tpreprocess: vitePreprocess(),\n\n\tkit: {\n    // ...\n    paths: {\n        relative: false, // Required for PostHog session replay to work correctly\n    },\n    // ...\n\t}\n};\n\nexport default config;\n\n--------------------------------------------------`;\n};\n"]}

package/dist/src/svelte/svelte-wizard.d.ts

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

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

@@ -0,0 +1,115 @@
+"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.runSvelteWizard = runSvelteWizard;
+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 add_editor_rules_1 = require("../steps/add-editor-rules");
+const messages_1 = require("../lib/messages");
+const steps_1 = require("../steps");
+async function runSvelteWizard(options) {
+    (0, clack_utils_1.printWelcome)({
+        wizardName: 'PostHog Svelte Wizard',
+    });
+    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
+    if (!aiConsent) {
+        await (0, clack_utils_1.abort)('The Svelte wizard requires AI to get setup right now. Please view the docs to setup Svelte manually instead: https://posthog.com/docs/libraries/svelte', 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, '@sveltejs/kit', '@sveltejs/kit');
+    const svelteVersion = (0, package_json_1.getPackageVersion)('@sveltejs/kit', packageJson);
+    if (svelteVersion) {
+        analytics_1.analytics.setTag('svelte-version', svelteVersion);
+    }
+    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.svelte,
+    });
+    await (0, clack_utils_1.installPackage)({
+        packageName: 'posthog-node',
+        packageNameDisplayLabel: 'posthog-node',
+        packageManager: packageManagerFromInstallStep,
+        alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],
+        forceInstall: options.forceInstall,
+        askBeforeUpdating: false,
+        installDir: options.installDir,
+        integration: constants_1.Integration.svelte,
+    });
+    const relevantFiles = await (0, file_utils_1.getRelevantFilesForIntegration)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.svelte,
+    });
+    const installationDocumentation = (0, docs_1.getSvelteDocumentation)({
+        language: typeScriptDetected ? 'typescript' : 'javascript',
+    });
+    clack_1.default.log.info(`Reviewing PostHog documentation for Svelte`);
+    const filesToChange = await (0, file_utils_1.getFilesToChange)({
+        integration: constants_1.Integration.svelte,
+        relevantFiles,
+        documentation: installationDocumentation,
+        wizardHash,
+        cloudRegion,
+    });
+    await (0, file_utils_1.generateFileChangesForIntegration)({
+        integration: constants_1.Integration.svelte,
+        filesToChange,
+        wizardHash,
+        installDir: options.installDir,
+        documentation: installationDocumentation,
+        cloudRegion,
+    });
+    const { relativeEnvFilePath, addedEnvVariables } = await (0, steps_1.addOrUpdateEnvironmentVariablesStep)({
+        variables: {
+            ['PUBLIC_POSTHOG_KEY']: projectApiKey,
+            ['PUBLIC_POSTHOG_HOST']: host,
+        },
+        installDir: options.installDir,
+        integration: constants_1.Integration.svelte,
+    });
+    const packageManagerForOutro = packageManagerFromInstallStep ?? (await (0, clack_utils_1.getPackageManager)(options));
+    await (0, steps_1.runPrettierStep)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.svelte,
+    });
+    const addedEditorRules = await (0, add_editor_rules_1.addEditorRulesStep)({
+        installDir: options.installDir,
+        rulesName: 'svelte-rules.md',
+        integration: constants_1.Integration.svelte,
+        default: options.default,
+    });
+    const outroMessage = (0, messages_1.getOutroMessage)({
+        options,
+        integration: constants_1.Integration.svelte,
+        cloudRegion,
+        addedEditorRules,
+        packageManager: packageManagerForOutro,
+        envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,
+        uploadedEnvVars: [],
+    });
+    clack_1.default.outro(outroMessage);
+    await analytics_1.analytics.shutdown('success');
+}
+//# sourceMappingURL=svelte-wizard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svelte-wizard.js","sourceRoot":"","sources":["../../../src/svelte/svelte-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 { getSvelteDocumentation } 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 } from '../steps/add-editor-rules';\nimport { getOutroMessage } from '../lib/messages';\nimport { addOrUpdateEnvironmentVariablesStep, runPrettierStep } from '../steps';\n\nexport async function runSvelteWizard(options: WizardOptions): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog Svelte Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The Svelte wizard requires AI to get setup right now. Please view the docs to setup Svelte manually instead: https://posthog.com/docs/libraries/svelte',\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, '@sveltejs/kit', '@sveltejs/kit');\n\n  const svelteVersion = getPackageVersion('@sveltejs/kit', packageJson);\n\n  if (svelteVersion) {\n    analytics.setTag('svelte-version', svelteVersion);\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.svelte,\n    });\n\n  await installPackage({\n    packageName: 'posthog-node',\n    packageNameDisplayLabel: 'posthog-node',\n    packageManager: packageManagerFromInstallStep,\n    alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],\n    forceInstall: options.forceInstall,\n    askBeforeUpdating: false,\n    installDir: options.installDir,\n    integration: Integration.svelte,\n  });\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.svelte,\n  });\n\n  const installationDocumentation = getSvelteDocumentation({\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n  });\n\n  clack.log.info(`Reviewing PostHog documentation for Svelte`);\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.svelte,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.svelte,\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        ['PUBLIC_POSTHOG_KEY']: projectApiKey,\n        ['PUBLIC_POSTHOG_HOST']: host,\n      },\n      installDir: options.installDir,\n      integration: Integration.svelte,\n    });\n\n  const packageManagerForOutro =\n    packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n  await runPrettierStep({\n    installDir: options.installDir,\n    integration: Integration.svelte,\n  });\n\n  const addedEditorRules = await addEditorRulesStep({\n    installDir: options.installDir,\n    rulesName: 'svelte-rules.md',\n    integration: Integration.svelte,\n    default: options.default,\n  });\n\n  const outroMessage = getOutroMessage({\n    options,\n    integration: Integration.svelte,\n    cloudRegion,\n    addedEditorRules,\n    packageManager: packageManagerForOutro,\n    envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,\n    uploadedEnvVars: [],\n  });\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n"]}

package/dist/src/telemetry.d.ts

@@ -0,0 +1,2 @@
+export declare function traceStep<T>(step: string, callback: () => T): T;
+export declare function updateProgress(step: string): void;

package/dist/src/telemetry.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceStep = traceStep;
+exports.updateProgress = updateProgress;
+const analytics_1 = require("./utils/analytics");
+function traceStep(step, callback) {
+    updateProgress(step);
+    return callback();
+}
+function updateProgress(step) {
+    analytics_1.analytics.setTag('progress', step);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/src/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/telemetry.ts"],"names":[],"mappings":";;AAEA,8BAGC;AAED,wCAEC;AATD,iDAA8C;AAE9C,SAAgB,SAAS,CAAI,IAAY,EAAE,QAAiB;IAC1D,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY;IACzC,qBAAS,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import { analytics } from './utils/analytics';\n\nexport function traceStep<T>(step: string, callback: () => T): T {\n  updateProgress(step);\n  return callback();\n}\n\nexport function updateProgress(step: string) {\n  analytics.setTag('progress', step);\n}\n"]}

package/dist/src/utils/__tests__/clack-utils.test.d.ts

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

package/dist/src/utils/__tests__/clack-utils.test.js

@@ -0,0 +1,128 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const clack_utils_1 = require("../clack-utils");
+const ChildProcess = __importStar(require("node:child_process"));
+jest.mock('node:child_process', () => ({
+    __esModule: true,
+    ...jest.requireActual('node:child_process'),
+}));
+jest.mock('@clack/prompts', () => ({
+    log: {
+        info: jest.fn(),
+        success: jest.fn(),
+        warn: jest.fn(),
+        error: jest.fn(),
+    },
+    text: jest.fn(),
+    confirm: jest.fn(),
+    cancel: jest.fn(),
+    outro: jest.fn(),
+    // passthrough for abortIfCancelled
+    isCancel: jest.fn().mockReturnValue(false),
+    spinner: jest
+        .fn()
+        .mockImplementation(() => ({ start: jest.fn(), stop: jest.fn() })),
+}));
+describe.skip('installPackage', () => {
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    it('force-installs a package if the forceInstall flag is set', async () => {
+        const packageManagerMock = {
+            name: 'npm',
+            label: 'NPM',
+            installCommand: 'npm install',
+            buildCommand: 'npm run build',
+            runScriptCommand: 'npm run',
+            flags: '',
+            forceInstallFlag: '--force',
+            detect: jest.fn(),
+            addOverride: jest.fn(),
+        };
+        const execSpy = jest
+            .spyOn(ChildProcess, 'exec')
+            // @ts-expect-error - don't care about the return value
+            .mockImplementationOnce((cmd, cb) => {
+            if (cb) {
+                // @ts-expect-error - don't care about the options value
+                cb(null, '', '');
+            }
+        });
+        await (0, clack_utils_1.installPackage)({
+            alreadyInstalled: false,
+            packageName: 'posthog-js',
+            packageNameDisplayLabel: 'posthog-js',
+            forceInstall: true,
+            askBeforeUpdating: false,
+            packageManager: packageManagerMock,
+            installDir: process.cwd(),
+        });
+        expect(execSpy).toHaveBeenCalledWith('npm install posthog-js  --force', expect.any(Function));
+    });
+    it.each([false, undefined])("doesn't force-install a package if the forceInstall flag is %s", async (flag) => {
+        const packageManagerMock = {
+            name: 'npm',
+            label: 'NPM',
+            installCommand: 'npm install',
+            buildCommand: 'npm run build',
+            runScriptCommand: 'npm run',
+            flags: '',
+            forceInstallFlag: '--force',
+            detect: jest.fn(),
+            addOverride: jest.fn(),
+        };
+        const execSpy = jest
+            .spyOn(ChildProcess, 'exec')
+            // @ts-expect-error - don't care about the return value
+            .mockImplementationOnce((cmd, cb) => {
+            if (cb) {
+                // @ts-expect-error - don't care about the options value
+                cb(null, '', '');
+            }
+        });
+        await (0, clack_utils_1.installPackage)({
+            alreadyInstalled: false,
+            packageName: 'posthog-js',
+            packageNameDisplayLabel: 'posthog-js',
+            forceInstall: flag,
+            askBeforeUpdating: false,
+            packageManager: packageManagerMock,
+            installDir: process.cwd(),
+        });
+        expect(execSpy).toHaveBeenCalledWith('npm install posthog-js  ', expect.any(Function));
+    });
+});
+//# sourceMappingURL=clack-utils.test.js.map

package/dist/src/utils/__tests__/clack-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clack-utils.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/clack-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { installPackage } from '../clack-utils';\n\nimport * as ChildProcess from 'node:child_process';\nimport type { PackageManager } from '../package-manager';\n\njest.mock('node:child_process', () => ({\n  __esModule: true,\n  ...jest.requireActual('node:child_process'),\n}));\n\njest.mock('@clack/prompts', () => ({\n  log: {\n    info: jest.fn(),\n    success: jest.fn(),\n    warn: jest.fn(),\n    error: jest.fn(),\n  },\n  text: jest.fn(),\n  confirm: jest.fn(),\n  cancel: jest.fn(),\n  outro: jest.fn(),\n  // passthrough for abortIfCancelled\n  isCancel: jest.fn().mockReturnValue(false),\n  spinner: jest\n    .fn()\n    .mockImplementation(() => ({ start: jest.fn(), stop: jest.fn() })),\n}));\n\ndescribe.skip('installPackage', () => {\n  afterEach(() => {\n    jest.clearAllMocks();\n  });\n\n  it('force-installs a package if the forceInstall flag is set', async () => {\n    const packageManagerMock: PackageManager = {\n      name: 'npm',\n      label: 'NPM',\n      installCommand: 'npm install',\n      buildCommand: 'npm run build',\n      runScriptCommand: 'npm run',\n      flags: '',\n      forceInstallFlag: '--force',\n      detect: jest.fn(),\n      addOverride: jest.fn(),\n    };\n\n    const execSpy = jest\n      .spyOn(ChildProcess, 'exec')\n      // @ts-expect-error - don't care about the return value\n      .mockImplementationOnce((cmd, cb) => {\n        if (cb) {\n          // @ts-expect-error - don't care about the options value\n          cb(null, '', '');\n        }\n      });\n\n    await installPackage({\n      alreadyInstalled: false,\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      forceInstall: true,\n      askBeforeUpdating: false,\n      packageManager: packageManagerMock,\n      installDir: process.cwd(),\n    });\n\n    expect(execSpy).toHaveBeenCalledWith(\n      'npm install posthog-js  --force',\n      expect.any(Function),\n    );\n  });\n\n  it.each([false, undefined])(\n    \"doesn't force-install a package if the forceInstall flag is %s\",\n    async (flag) => {\n      const packageManagerMock: PackageManager = {\n        name: 'npm',\n        label: 'NPM',\n        installCommand: 'npm install',\n        buildCommand: 'npm run build',\n        runScriptCommand: 'npm run',\n        flags: '',\n        forceInstallFlag: '--force',\n        detect: jest.fn(),\n        addOverride: jest.fn(),\n      };\n\n      const execSpy = jest\n        .spyOn(ChildProcess, 'exec')\n        // @ts-expect-error - don't care about the return value\n        .mockImplementationOnce((cmd, cb) => {\n          if (cb) {\n            // @ts-expect-error - don't care about the options value\n            cb(null, '', '');\n          }\n        });\n\n      await installPackage({\n        alreadyInstalled: false,\n        packageName: 'posthog-js',\n        packageNameDisplayLabel: 'posthog-js',\n        forceInstall: flag,\n        askBeforeUpdating: false,\n        packageManager: packageManagerMock,\n        installDir: process.cwd(),\n      });\n\n      expect(execSpy).toHaveBeenCalledWith(\n        'npm install posthog-js  ',\n        expect.any(Function),\n      );\n    },\n  );\n});\n"]}

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

@@ -0,0 +1,12 @@
+export declare class Analytics {
+    private client;
+    private tags;
+    private distinctId?;
+    private anonymousId;
+    constructor();
+    setDistinctId(distinctId: string): void;
+    setTag(key: string, value: string | boolean | number | null | undefined): void;
+    capture(eventName: string, properties?: Record<string, unknown>): void;
+    shutdown(status: 'success' | 'error' | 'cancelled'): Promise<void>;
+}
+export declare const analytics: Analytics;

package/dist/src/utils/analytics.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analytics = exports.Analytics = void 0;
+const posthog_node_1 = require("posthog-node");
+const constants_1 = require("../lib/constants");
+const uuid_1 = require("uuid");
+class Analytics {
+    client;
+    tags = {};
+    distinctId;
+    anonymousId;
+    constructor() {
+        this.client = new posthog_node_1.PostHog(constants_1.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {
+            host: constants_1.ANALYTICS_HOST_URL,
+            flushAt: 1,
+            flushInterval: 0,
+        });
+        this.tags = {};
+        this.anonymousId = (0, uuid_1.v4)();
+        this.distinctId = undefined;
+    }
+    setDistinctId(distinctId) {
+        this.distinctId = distinctId;
+        this.client.alias({
+            distinctId,
+            alias: this.anonymousId,
+        });
+    }
+    setTag(key, value) {
+        this.tags[key] = value;
+    }
+    capture(eventName, properties) {
+        this.client.capture({
+            distinctId: this.distinctId ?? this.anonymousId,
+            event: eventName,
+            properties: {
+                ...this.tags,
+                ...properties,
+            },
+        });
+    }
+    async shutdown(status) {
+        if (Object.keys(this.tags).length === 0) {
+            return;
+        }
+        this.client.capture({
+            distinctId: this.distinctId ?? this.anonymousId,
+            event: 'setup wizard finished',
+            properties: {
+                status,
+                tags: this.tags,
+            },
+        });
+        await this.client.shutdown();
+    }
+}
+exports.Analytics = Analytics;
+exports.analytics = new Analytics();
+//# sourceMappingURL=analytics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":";;;AAAA,+CAAuC;AACvC,gDAG0B;AAC1B,+BAAoC;AACpC,MAAa,SAAS;IACZ,MAAM,CAAU;IAChB,IAAI,GACV,EAAE,CAAC;IACG,UAAU,CAAU;IACpB,WAAW,CAAS;IAE5B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAO,CAAC,sDAA0C,EAAE;YACpE,IAAI,EAAE,8BAAkB;YACxB,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QAEf,IAAI,CAAC,WAAW,GAAG,IAAA,SAAM,GAAE,CAAC;QAE5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,UAAU;YACV,KAAK,EAAE,IAAI,CAAC,WAAW;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAmD;QACrE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,UAAoC;QAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW;YAC/C,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE;gBACV,GAAG,IAAI,CAAC,IAAI;gBACZ,GAAG,UAAU;aACd;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAyC;QACtD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW;YAC/C,KAAK,EAAE,uBAAuB;YAC9B,UAAU,EAAE;gBACV,MAAM;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF;AA5DD,8BA4DC;AAEY,QAAA,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC","sourcesContent":["import { PostHog } from 'posthog-node';\nimport {\n  ANALYTICS_HOST_URL,\n  ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY,\n} from '../lib/constants';\nimport { v4 as uuidv4 } from 'uuid';\nexport class Analytics {\n  private client: PostHog;\n  private tags: Record<string, string | boolean | number | null | undefined> =\n    {};\n  private distinctId?: string;\n  private anonymousId: string;\n\n  constructor() {\n    this.client = new PostHog(ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {\n      host: ANALYTICS_HOST_URL,\n      flushAt: 1,\n      flushInterval: 0,\n    });\n\n    this.tags = {};\n\n    this.anonymousId = uuidv4();\n\n    this.distinctId = undefined;\n  }\n\n  setDistinctId(distinctId: string) {\n    this.distinctId = distinctId;\n    this.client.alias({\n      distinctId,\n      alias: this.anonymousId,\n    });\n  }\n\n  setTag(key: string, value: string | boolean | number | null | undefined) {\n    this.tags[key] = value;\n  }\n\n  capture(eventName: string, properties?: Record<string, unknown>) {\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: eventName,\n      properties: {\n        ...this.tags,\n        ...properties,\n      },\n    });\n  }\n\n  async shutdown(status: 'success' | 'error' | 'cancelled') {\n    if (Object.keys(this.tags).length === 0) {\n      return;\n    }\n\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: 'setup wizard finished',\n      properties: {\n        status,\n        tags: this.tags,\n      },\n    });\n\n    await this.client.shutdown();\n  }\n}\n\nexport const analytics = new Analytics();\n"]}

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

@@ -0,0 +1,2 @@
+export declare function executeSync(command: string): string;
+export declare function execute(command: string): Promise<string>;

package/dist/src/utils/bash.js

@@ -0,0 +1,54 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeSync = executeSync;
+exports.execute = execute;
+const child_process = __importStar(require("child_process"));
+function executeSync(command) {
+    const output = child_process.execSync(command);
+    return output.toString();
+}
+function execute(command) {
+    return new Promise((resolve, reject) => {
+        child_process.exec(command, (error, stdout, _) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+//# sourceMappingURL=bash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/utils/bash.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kCAGC;AAED,0BAWC;AAlBD,6DAA+C;AAE/C,SAAgB,WAAW,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;YAC/C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import * as child_process from 'child_process';\n\nexport function executeSync(command: string): string {\n  const output = child_process.execSync(command);\n  return output.toString();\n}\n\nexport function execute(command: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    child_process.exec(command, (error, stdout, _) => {\n      if (error) {\n        reject(error);\n        return;\n      }\n\n      resolve(stdout);\n    });\n  });\n}\n"]}

package/dist/src/utils/clack-utils.d.ts

@@ -0,0 +1,180 @@
+import { type PackageDotJson } from './package-json';
+import { type PackageManager } from './package-manager';
+import type { CloudRegion, Feature, WizardOptions } from './types';
+export interface CliSetupConfig {
+    filename: string;
+    name: string;
+    gitignore: boolean;
+    likelyAlreadyHasAuthToken(contents: string): boolean;
+    tokenContent(authToken: string): string;
+    likelyAlreadyHasOrgAndProject(contents: string): boolean;
+    orgAndProjContent(org: string, project: string): string;
+    likelyAlreadyHasUrl?(contents: string): boolean;
+    urlContent?(url: string): string;
+}
+export interface CliSetupConfigContent {
+    authToken: string;
+    org?: string;
+    project?: string;
+    url?: string;
+}
+export declare function abort(message?: string, status?: number): Promise<never>;
+export declare function abortIfCancelled<T>(input: T | Promise<T>): Promise<Exclude<T, symbol>>;
+export declare function printWelcome(options: {
+    wizardName: string;
+    message?: string;
+}): void;
+export declare function confirmContinueIfNoOrDirtyGitRepo(options: Pick<WizardOptions, 'default'>): Promise<void>;
+export declare function isInGitRepo(): boolean;
+export declare function getUncommittedOrUntrackedFiles(): string[];
+export declare function askForItemSelection(items: string[], message: string): Promise<{
+    value: string;
+    index: number;
+}>;
+export declare function confirmContinueIfPackageVersionNotSupported({ packageId, packageName, packageVersion, acceptableVersions, note, }: {
+    packageId: string;
+    packageName: string;
+    packageVersion: string;
+    acceptableVersions: string;
+    note?: string;
+}): Promise<void>;
+/**
+ * Installs or updates a package with the user's package manager.
+ *
+ * IMPORTANT: This function modifies the `package.json`! Be sure to re-read
+ * it if you make additional modifications to it after calling this function!
+ */
+export declare function installPackage({ packageName, alreadyInstalled, askBeforeUpdating, packageNameDisplayLabel, packageManager, forceInstall, integration, installDir, }: {
+    /** The string that is passed to the package manager CLI as identifier to install (e.g. `posthog-js`, or `posthog-js@^1.100.0`) */
+    packageName: string;
+    alreadyInstalled: boolean;
+    askBeforeUpdating?: boolean;
+    /** Overrides what is shown in the installation logs in place of the `packageName` option. Useful if the `packageName` is ugly */
+    packageNameDisplayLabel?: string;
+    packageManager?: PackageManager;
+    /** Add force install flag to command to skip install precondition fails */
+    forceInstall?: boolean;
+    /** The integration that is being used */
+    integration?: string;
+    /** The directory to install the package in */
+    installDir: string;
+}): Promise<{
+    packageManager?: PackageManager;
+}>;
+/**
+ * Checks if @param packageId is listed as a dependency in @param packageJson.
+ * If not, it will ask users if they want to continue without the package.
+ *
+ * Use this function to check if e.g. a the framework of the SDK is installed
+ *
+ * @param packageJson the package.json object
+ * @param packageId the npm name of the package
+ * @param packageName a human readable name of the package
+ */
+export declare function ensurePackageIsInstalled(packageJson: PackageDotJson, packageId: string, packageName: string): Promise<void>;
+export declare function getPackageDotJson({ installDir, }: Pick<WizardOptions, 'installDir'>): Promise<PackageDotJson>;
+export declare function updatePackageDotJson(packageDotJson: PackageDotJson, { installDir }: Pick<WizardOptions, 'installDir'>): Promise<void>;
+export declare function getPackageManager({ installDir, }: Pick<WizardOptions, 'installDir'>): Promise<PackageManager>;
+export declare function isUsingTypeScript({ installDir, }: Pick<WizardOptions, 'installDir'>): boolean;
+/**
+ *
+ * Use this function to get project data for the wizard.
+ *
+ * @param options wizard options
+ * @returns project data (token, url)
+ */
+export declare function getOrAskForProjectData(_options: WizardOptions & {
+    cloudRegion: CloudRegion;
+}): Promise<{
+    wizardHash: string;
+    host: string;
+    projectApiKey: string;
+}>;
+/**
+ * Asks users if they have a config file for @param tool (e.g. Vite).
+ * If yes, asks users to specify the path to their config file.
+ *
+ * Use this helper function as a fallback mechanism if the lookup for
+ * a config file with its most usual location/name fails.
+ *
+ * @param toolName Name of the tool for which we're looking for the config file
+ * @param configFileName Name of the most common config file name (e.g. vite.config.js)
+ *
+ * @returns a user path to the config file or undefined if the user doesn't have a config file
+ */
+export declare function askForToolConfigPath(toolName: string, configFileName: string): Promise<string | undefined>;
+/**
+ * Prints copy/paste-able instructions to the console.
+ * Afterwards asks the user if they added the code snippet to their file.
+ *
+ * While there's no point in providing a "no" answer here, it gives users time to fulfill the
+ * task before the wizard continues with additional steps.
+ *
+ * Use this function if you want to show users instructions on how to add/modify
+ * code in their file. This is helpful if automatic insertion failed or is not possible/feasible.
+ *
+ * @param filename the name of the file to which the code snippet should be applied.
+ * If a path is provided, only the filename will be used.
+ *
+ * @param codeSnippet the snippet to be printed. Use {@link makeCodeSnippet}  to create the
+ * diff-like format for visually highlighting unchanged or modified lines of code.
+ *
+ * @param hint (optional) a hint to be printed after the main instruction to add
+ * the code from @param codeSnippet to their @param filename.
+ *
+ * TODO: refactor copy paste instructions across different wizards to use this function.
+ *       this might require adding a custom message parameter to the function
+ */
+export declare function showCopyPasteInstructions(filename: string, codeSnippet: string, hint?: string): Promise<void>;
+/**
+ * Callback that exposes formatting helpers for a code snippet.
+ * @param unchanged - Formats text as old code.
+ * @param plus - Formats text as new code.
+ * @param minus - Formats text as removed code.
+ */
+type CodeSnippetFormatter = (unchanged: (txt: string) => string, plus: (txt: string) => string, minus: (txt: string) => string) => string;
+/**
+ * Crafts a code snippet that can be used to e.g.
+ * - print copy/paste instructions to the console
+ * - create a new config file.
+ *
+ * @param colors set this to true if you want the final snippet to be colored.
+ * This is useful for printing the snippet to the console as part of copy/paste instructions.
+ *
+ * @param callback the callback that returns the formatted code snippet.
+ * It exposes takes the helper functions for marking code as unchanged, new or removed.
+ * These functions no-op if no special formatting should be applied
+ * and otherwise apply the appropriate formatting/coloring.
+ * (@see {@link CodeSnippetFormatter})
+ *
+ * @see {@link showCopyPasteInstructions} for the helper with which to display the snippet in the console.
+ *
+ * @returns a string containing the final, formatted code snippet.
+ */
+export declare function makeCodeSnippet(colors: boolean, callback: CodeSnippetFormatter): string;
+/**
+ * Creates a new config file with the given @param filepath and @param codeSnippet.
+ *
+ * Use this function to create a new config file for users. This is useful
+ * when users answered that they don't yet have a config file for a tool.
+ *
+ * (This doesn't mean that they don't yet have some other way of configuring
+ * their tool but we can leave it up to them to figure out how to merge configs
+ * here.)
+ *
+ * @param filepath absolute path to the new config file
+ * @param codeSnippet the snippet to be inserted into the file
+ * @param moreInformation (optional) the message to be printed after the file was created
+ * For example, this can be a link to more information about configuring the tool.
+ *
+ * @returns true on success, false otherwise
+ */
+export declare function createNewConfigFile(filepath: string, codeSnippet: string, { installDir }: Pick<WizardOptions, 'installDir'>, moreInformation?: string): Promise<boolean>;
+export declare function featureSelectionPrompt<F extends ReadonlyArray<Feature>>(features: F): Promise<{
+    [key in F[number]['id']]: boolean;
+}>;
+export declare function askShouldInstallPackage(pkgName: string): Promise<boolean>;
+export declare function askShouldAddPackageOverride(pkgName: string, pkgVersion: string): Promise<boolean>;
+export declare function askForAIConsent(options: Pick<WizardOptions, 'default'>): Promise<boolean>;
+export declare function askForCloudRegion(): Promise<CloudRegion>;
+export {};