@posthog/wizard 0.5.0 → 0.7.0

package/README.md

@@ -2,8 +2,9 @@
   <img alt="posthoglogo" src="https://user-images.githubusercontent.com/65415371/205059737-c8a4f836-4889-4654-902e-f302b187b6a0.png">
 </p>
 
-> **⚠️ Experimental:** This wizard is still in an experimental phase. 
-> If you have any feedback, please drop an email to **joshua** [at] **posthog** [dot] **com**.
+> **⚠️ Experimental:** This wizard is still in an experimental phase. If you
+> have any feedback, please drop an email to **joshua** [at] **posthog** [dot]
+> **com**.
 
 <h1>PostHog Wizard ✨</h1>
 <h4>The PostHog Wizard helps you quickly add PostHog to your project using AI.</h4>
@@ -16,21 +17,26 @@ To use the wizard, you can run it directly using:
 npx @posthog/wizard
 ```
 
-Currently the wizard can be used for React & Next.js projects. If you have other integrations you would like the wizard to support, please open a [GitHub issue](https://github.com/posthog/wizard/issues)!
+Currently the wizard can be used for React, NextJS, Svelte and React Native
+projects. If you have other integrations you would like the wizard to support,
+please open a [GitHub issue](https://github.com/posthog/wizard/issues)!
 
 # Options
 
 The following CLI arguments are available:
 
-| Option            | Description                                                                | Type    | Default                         | Choices           | Environment Variable         |
-| ----------------- | -------------------------------------------------------------------------- | ------- | ------------------------------- | ----------------- | ---------------------------- |
-| `--help`          | Show help                                                                  | boolean |                                 |                   |                              |
-| `--version`       | Show version number                                                        | boolean |                                 |                   |                              |
-| `--debug`         | Enable verbose logging                                                     | boolean | `false`                         |                   | `POSTHOG_WIZARD_DEBUG`       |
-| `--integration`   | Choose the integration to setup                                            | choices | Select integration during setup | "nextjs", "react" | `POSTHOG_WIZARD_INTEGRATION` |
-| `--force-install` | Force install the SDK NPM package (use with caution!)                      | boolean | `false`                         |                   |                              |
-| `--install-dir`   | Relative path to install in                                                | string  | `.`                             |                   | `POSTHOG_WIZARD_INSTALL_DIR` |
-| `--region`        | PostHog region to use                                                      | choices |                                 | "us", "eu"        | `POSTHOG_WIZARD_REGION`      |
-| `--default`       | Select the default option for all questions automatically (where possible) | boolean | `false`                         |                   | `POSTHOG_WIZARD_DEFAULT`     |
-
-> Note: A large amount of the scaffolding for this came from the amazing Sentry wizard, which you can find [here](https://github.com/getsentry/sentry-wizard) 💖
+| Option            | Description                                                                | Type    | Default                         | Choices                                     | Environment Variable         |
+| ----------------- | -------------------------------------------------------------------------- | ------- | ------------------------------- | ------------------------------------------- | ---------------------------- |
+| `--help`          | Show help                                                                  | boolean |                                 |                                             |                              |
+| `--version`       | Show version number                                                        | boolean |                                 |                                             |                              |
+| `--debug`         | Enable verbose logging                                                     | boolean | `false`                         |                                             | `POSTHOG_WIZARD_DEBUG`       |
+| `--integration`   | Choose the integration to setup                                            | choices | Select integration during setup | "nextjs", "react", "svelte", "react-native" | `POSTHOG_WIZARD_INTEGRATION` |
+| `--force-install` | Force install the SDK NPM package (use with caution!)                      | boolean | `false`                         |                                             |                              |
+| `--install-dir`   | Relative path to install in                                                | string  | `.`                             |                                             | `POSTHOG_WIZARD_INSTALL_DIR` |
+| `--region`        | PostHog region to use                                                      | choices |                                 | "us", "eu"                                  | `POSTHOG_WIZARD_REGION`      |
+| `--default`       | Select the default option for all questions automatically (where possible) | boolean | `false`                         |                                             | `POSTHOG_WIZARD_DEFAULT`     |
+| `--signup`        | Create a new PostHog account during setup                                  | boolean | `false`                         |                                             | `POSTHOG_WIZARD_SIGNUP`      |
+
+> Note: A large amount of the scaffolding for this came from the amazing Sentry
+> wizard, which you can find [here](https://github.com/getsentry/sentry-wizard)
+> 💖

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/wizard",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "homepage": "https://github.com/posthog/wizard",
   "repository": "https://github.com/posthog/wizard",
   "description": "The PostHog wizard helps you to configure your project",

package/dist/bin.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/bin.js

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const semver_1 = require("semver");
-const logging_1 = require("./src/utils/logging");
-const yargs_1 = __importDefault(require("yargs"));
-const helpers_1 = require("yargs/helpers");
-const NODE_VERSION_RANGE = '>=18.20.0';
-// Have to run this above the other imports because they are importing clack that
-// has the problematic imports.
-if (!(0, semver_1.satisfies)(process.version, NODE_VERSION_RANGE)) {
-    (0, logging_1.red)(`PostHog Wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`);
-    process.exit(1);
-}
-const run_1 = require("./src/run");
-// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
-const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv)).options({
-    debug: {
-        default: false,
-        describe: 'Enable verbose logging\nenv: POSTHOG_WIZARD_DEBUG',
-        type: 'boolean',
-    },
-}).argv;
-void (0, run_1.run)(argv);
-//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../bin.ts"],"names":[],"mappings":";;;;;;AACA,mCAAmC;AACnC,iDAA0C;AAE1C,kDAA0B;AAC1B,2CAAwC;AAExC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAEvC,iFAAiF;AACjF,+BAA+B;AAC/B,IAAI,CAAC,IAAA,kBAAS,EAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC;IACpD,IAAA,aAAG,EACD,mCAAmC,kBAAkB,2BAA2B,OAAO,CAAC,OAAO,wCAAwC,CACxI,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,mCAAgC;AAEhC,kJAAkJ;AAClJ,MAAM,IAAI,GAAG,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,mDAAmD;QAC7D,IAAI,EAAE,SAAS;KAChB;CACF,CAAC,CAAC,IAAI,CAAC;AAER,KAAK,IAAA,SAAG,EAAC,IAAI,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { satisfies } from 'semver';\nimport { red } from './src/utils/logging';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nconst NODE_VERSION_RANGE = '>=18.20.0';\n\n// Have to run this above the other imports because they are importing clack that\n// has the problematic imports.\nif (!satisfies(process.version, NODE_VERSION_RANGE)) {\n  red(\n    `PostHog Wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`,\n  );\n  process.exit(1);\n}\nimport { run } from './src/run';\n\n// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call\nconst argv = yargs(hideBin(process.argv)).options({\n  debug: {\n    default: false,\n    describe: 'Enable verbose logging\\nenv: POSTHOG_WIZARD_DEBUG',\n    type: 'boolean',\n  },\n}).argv;\n\nvoid run(argv);\n"]}

package/dist/src/lib/config.d.ts

@@ -1,21 +0,0 @@
-import type { WizardOptions } from '../utils/types';
-import { Integration } from './constants';
-export declare const INTEGRATION_CONFIG: {
-    readonly nextjs: {
-        readonly name: "Next.js";
-        readonly filterPatterns: ["**/*.{tsx,ts,jsx,js,mjs,cjs}"];
-        readonly ignorePatterns: ["node_modules", "dist", "build", "public", "static", "next-env.d.*"];
-        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<boolean>;
-        readonly generateFilesRules: "";
-        readonly filterFilesRules: "";
-    };
-    readonly react: {
-        readonly name: "React";
-        readonly filterPatterns: ["**/*.{tsx,ts,jsx,js}"];
-        readonly ignorePatterns: ["node_modules", "dist", "build", "public", "static", "assets"];
-        readonly detect: (options: Pick<WizardOptions, "installDir">) => Promise<boolean>;
-        readonly generateFilesRules: "";
-        readonly filterFilesRules: "";
-    };
-};
-export declare const INTEGRATION_ORDER: readonly [Integration.nextjs, Integration.react];

package/dist/src/lib/config.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.INTEGRATION_ORDER = exports.INTEGRATION_CONFIG = void 0;
-const clack_utils_1 = require("../utils/clack-utils");
-const package_json_1 = require("../utils/package-json");
-const constants_1 = require("./constants");
-exports.INTEGRATION_CONFIG = {
-    [constants_1.Integration.nextjs]: {
-        name: 'Next.js',
-        filterPatterns: ['**/*.{tsx,ts,jsx,js,mjs,cjs}'],
-        ignorePatterns: [
-            'node_modules',
-            'dist',
-            'build',
-            'public',
-            'static',
-            'next-env.d.*',
-        ],
-        detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.hasPackageInstalled)('next', packageJson);
-        },
-        generateFilesRules: '',
-        filterFilesRules: '',
-    },
-    [constants_1.Integration.react]: {
-        name: 'React',
-        filterPatterns: ['**/*.{tsx,ts,jsx,js}'],
-        ignorePatterns: [
-            'node_modules',
-            'dist',
-            'build',
-            'public',
-            'static',
-            'assets',
-        ],
-        detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.hasPackageInstalled)('react', packageJson);
-        },
-        generateFilesRules: '',
-        filterFilesRules: '',
-    },
-};
-exports.INTEGRATION_ORDER = [
-    constants_1.Integration.nextjs,
-    constants_1.Integration.react,
-];
-//# sourceMappingURL=config.js.map

package/dist/src/lib/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":";;;AAAA,sDAAyD;AACzD,wDAA4D;AAE5D,2CAA0C;AAW7B,QAAA,kBAAkB,GAAG;IAChC,CAAC,uBAAW,CAAC,MAAM,CAAC,EAAE;QACpB,IAAI,EAAE,SAAS;QACf,cAAc,EAAE,CAAC,8BAA8B,CAAC;QAChD,cAAc,EAAE;YACd,cAAc;YACd,MAAM;YACN,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,cAAc;SACf;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,IAAA,kCAAmB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAClD,CAAC;QACD,kBAAkB,EAAE,EAAE;QACtB,gBAAgB,EAAE,EAAE;KACrB;IACD,CAAC,uBAAW,CAAC,KAAK,CAAC,EAAE;QACnB,IAAI,EAAE,OAAO;QACb,cAAc,EAAE,CAAC,sBAAsB,CAAC;QACxC,cAAc,EAAE;YACd,cAAc;YACd,MAAM;YACN,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,QAAQ;SACT;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,IAAA,kCAAmB,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;QACD,kBAAkB,EAAE,EAAE;QACtB,gBAAgB,EAAE,EAAE;KACrB;CACwD,CAAC;AAE/C,QAAA,iBAAiB,GAAG;IAC/B,uBAAW,CAAC,MAAM;IAClB,uBAAW,CAAC,KAAK;CACT,CAAC","sourcesContent":["import { getPackageDotJson } from '../utils/clack-utils';\nimport { hasPackageInstalled } from '../utils/package-json';\nimport type { WizardOptions } from '../utils/types';\nimport { Integration } from './constants';\n\ntype IntegrationConfig = {\n  name: string;\n  filterPatterns: string[];\n  ignorePatterns: string[];\n  detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<boolean>;\n  generateFilesRules: string;\n  filterFilesRules: string;\n};\n\nexport const INTEGRATION_CONFIG = {\n  [Integration.nextjs]: {\n    name: 'Next.js',\n    filterPatterns: ['**/*.{tsx,ts,jsx,js,mjs,cjs}'],\n    ignorePatterns: [\n      'node_modules',\n      'dist',\n      'build',\n      'public',\n      'static',\n      'next-env.d.*',\n    ],\n    detect: async (options) => {\n      const packageJson = await getPackageDotJson(options);\n      return hasPackageInstalled('next', packageJson);\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n  },\n  [Integration.react]: {\n    name: 'React',\n    filterPatterns: ['**/*.{tsx,ts,jsx,js}'],\n    ignorePatterns: [\n      'node_modules',\n      'dist',\n      'build',\n      'public',\n      'static',\n      'assets',\n    ],\n    detect: async (options) => {\n      const packageJson = await getPackageDotJson(options);\n      return hasPackageInstalled('react', packageJson);\n    },\n    generateFilesRules: '',\n    filterFilesRules: '',\n  },\n} as const satisfies Record<Integration, IntegrationConfig>;\n\nexport const INTEGRATION_ORDER = [\n  Integration.nextjs,\n  Integration.react,\n] as const;\n"]}

package/dist/src/lib/constants.d.ts

@@ -1,22 +0,0 @@
-export declare enum Integration {
-    nextjs = "nextjs",
-    react = "react"
-}
-export declare function getIntegrationDescription(type: string): string;
-type IntegrationChoice = {
-    name: string;
-    value: string;
-};
-export declare function getIntegrationChoices(): IntegrationChoice[];
-export interface Args {
-    debug: boolean;
-    integration: Integration;
-}
-export declare const IS_DEV = false;
-export declare const DEFAULT_URL: string;
-export declare const ISSUES_URL = "https://github.com/posthog/wizard/issues";
-export declare const DEFAULT_HOST_URL: string;
-export declare const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = "sTMFPsFhdP1Ssg";
-export declare const ANALYTICS_HOST_URL: string;
-export declare const DUMMY_PROJECT_API_KEY = "_YOUR_POSTHOG_PROJECT_API_KEY_";
-export {};

package/dist/src/lib/constants.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DUMMY_PROJECT_API_KEY = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.ISSUES_URL = exports.DEFAULT_URL = exports.IS_DEV = exports.Integration = void 0;
-exports.getIntegrationDescription = getIntegrationDescription;
-exports.getIntegrationChoices = getIntegrationChoices;
-var Integration;
-(function (Integration) {
-    Integration["nextjs"] = "nextjs";
-    Integration["react"] = "react";
-})(Integration || (exports.Integration = Integration = {}));
-function getIntegrationDescription(type) {
-    switch (type) {
-        case Integration.nextjs:
-            return 'Next.js';
-        case Integration.react:
-            return 'React';
-        default:
-            throw new Error(`Unknown integration ${type}`);
-    }
-}
-function getIntegrationChoices() {
-    return Object.keys(Integration).map((type) => ({
-        name: getIntegrationDescription(type),
-        value: type,
-    }));
-}
-exports.IS_DEV = false;
-exports.DEFAULT_URL = exports.IS_DEV
-    ? 'http://localhost:8010'
-    : 'https://us.posthog.com';
-exports.ISSUES_URL = 'https://github.com/posthog/wizard/issues';
-exports.DEFAULT_HOST_URL = exports.IS_DEV
-    ? 'http://localhost:8010'
-    : 'https://us.i.posthog.com';
-exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';
-exports.ANALYTICS_HOST_URL = exports.IS_DEV
-    ? 'http://localhost:8010'
-    : 'https://internal-t.posthog.com';
-exports.DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';
-//# sourceMappingURL=constants.js.map

package/dist/src/lib/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":";;;AAKA,8DASC;AAOD,sDAKC;AA1BD,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB;AAED,SAAgB,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAOD,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAOY,QAAA,MAAM,GAAG,KAAK,CAAC;AAEf,QAAA,WAAW,GAAG,cAAM;IAC/B,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,wBAAwB,CAAC;AAChB,QAAA,UAAU,GAAG,0CAA0C,CAAC;AACxD,QAAA,gBAAgB,GAAG,cAAM;IACpC,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,0BAA0B,CAAC;AAClB,QAAA,0CAA0C,GAAG,gBAAgB,CAAC;AAC9D,QAAA,kBAAkB,GAAG,cAAM;IACtC,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,gCAAgC,CAAC;AACxB,QAAA,qBAAqB,GAAG,gCAAgC,CAAC","sourcesContent":["export enum Integration {\n  nextjs = 'nextjs',\n  react = 'react',\n}\n\nexport function getIntegrationDescription(type: string): string {\n  switch (type) {\n    case Integration.nextjs:\n      return 'Next.js';\n    case Integration.react:\n      return 'React';\n    default:\n      throw new Error(`Unknown integration ${type}`);\n  }\n}\n\ntype IntegrationChoice = {\n  name: string;\n  value: string;\n};\n\nexport function getIntegrationChoices(): IntegrationChoice[] {\n  return Object.keys(Integration).map((type: string) => ({\n    name: getIntegrationDescription(type),\n    value: type,\n  }));\n}\n\nexport interface Args {\n  debug: boolean;\n  integration: Integration;\n}\n\nexport const IS_DEV = false;\n\nexport const DEFAULT_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.posthog.com';\nexport const ISSUES_URL = 'https://github.com/posthog/wizard/issues';\nexport const DEFAULT_HOST_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.i.posthog.com';\nexport const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';\nexport const ANALYTICS_HOST_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://internal-t.posthog.com';\nexport const DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';\n"]}

package/dist/src/lib/prompts.d.ts

@@ -1,16 +0,0 @@
-import { PromptTemplate } from '@langchain/core/prompts';
-export declare const baseFilterFilesPromptTemplate: PromptTemplate<{
-    documentation: any;
-    file_list: any;
-    integration_name: any;
-    integration_rules: any;
-}, any>;
-export declare const baseGenerateFileChangesPromptTemplate: PromptTemplate<{
-    documentation: any;
-    integration_name: any;
-    integration_rules: any;
-    file_content: any;
-    file_path: any;
-    changed_files: any;
-    unchanged_files: any;
-}, any>;

package/dist/src/lib/prompts.js

@@ -1,80 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.baseGenerateFileChangesPromptTemplate = exports.baseFilterFilesPromptTemplate = void 0;
-const prompts_1 = require("@langchain/core/prompts");
-exports.baseFilterFilesPromptTemplate = new prompts_1.PromptTemplate({
-    inputVariables: [
-        'documentation',
-        'file_list',
-        'integration_name',
-        'integration_rules',
-    ],
-    template: `You are a PostHog installation wizard, a master AI programming assistant that implements PostHog for {integration_name} projects.
-Given the following list of file paths from a project, determine which files are likely to require modifications 
-to integrate PostHog. Use the installation documentation as a reference for what files might need modifications, do not include files that are unlikely to require modification based on the documentation.
-
-- If you would like to create a new file, you can include the file path in your response.
-- If you would like to modify an existing file, you can include the file path in your response.
-
-You should return all files that you think will be required to look at or modify to integrate PostHog. You should return them in the order you would like to see them processed, with new files first, followed by the files that you want to update to integrate PostHog.
-
-Rules:
-- Only return files that you think will be required to look at or modify to integrate PostHog.
-- Do not return files that are unlikely to require modification based on the documentation.
-- If you are unsure, return the file, since it's better to have more files than less.
-- If you create a new file, it should not conflict with any existing files.
-- If the user is using TypeScript, you should return .ts and .tsx files.
-- The file structure of the project may be different than the documentation, you should follow the file structure of the project.
-{integration_rules}
-
-Installation documentation:
-{documentation}
-
-All current files in the repository:
-
-{file_list}`,
-});
-exports.baseGenerateFileChangesPromptTemplate = new prompts_1.PromptTemplate({
-    inputVariables: [
-        'file_content',
-        'documentation',
-        'file_path',
-        'changed_files',
-        'unchanged_files',
-        'integration_name',
-        'integration_rules',
-    ],
-    template: `You are a PostHog installation wizard, a master AI programming assistant that implements PostHog for {integration_name} projects.
-
-Your task is to update the file to integrate PostHog according to the documentation.
-Do not return a diff — you should return the complete updated file content.
-
-Rules:
-- Preserve the existing code formatting and style.
-- Only make the changes required by the documentation.
-- If no changes are needed, return the file as-is.
-- If the current file is empty, and you think it should be created, you can add the contents of the new file.
-- The file structure of the project may be different than the documentation, you should follow the file structure of the project.
-- Use relative imports if you are unsure what the project import paths are.
-{integration_rules}
-
-
-CONTEXT
----
-
-Documentation for integrating PostHog with {integration_name}:
-{documentation}
-
-The file you are updating is:
-{file_path}
-
-Here are the changes you have already made to the project:
-{changed_files}
-
-Here are the files that have not been changed yet:
-{unchanged_files}
-
-Below is the current file contents:
-{file_content}`,
-});
-//# sourceMappingURL=prompts.js.map

package/dist/src/lib/prompts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/lib/prompts.ts"],"names":[],"mappings":";;;AAAA,qDAAyD;AAE5C,QAAA,6BAA6B,GAAG,IAAI,wBAAc,CAAC;IAC9D,cAAc,EAAE;QACd,eAAe;QACf,WAAW;QACX,kBAAkB;QAClB,mBAAmB;KACpB;IACD,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;YAuBA;CACX,CAAC,CAAC;AAEU,QAAA,qCAAqC,GAAG,IAAI,wBAAc,CAAC;IACtE,cAAc,EAAE;QACd,cAAc;QACd,eAAe;QACf,WAAW;QACX,eAAe;QACf,iBAAiB;QACjB,kBAAkB;QAClB,mBAAmB;KACpB;IACD,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA+BG;CACd,CAAC,CAAC","sourcesContent":["import { PromptTemplate } from '@langchain/core/prompts';\n\nexport const baseFilterFilesPromptTemplate = new PromptTemplate({\n  inputVariables: [\n    'documentation',\n    'file_list',\n    'integration_name',\n    'integration_rules',\n  ],\n  template: `You are a PostHog installation wizard, a master AI programming assistant that implements PostHog for {integration_name} projects.\nGiven the following list of file paths from a project, determine which files are likely to require modifications \nto integrate PostHog. Use the installation documentation as a reference for what files might need modifications, do not include files that are unlikely to require modification based on the documentation.\n\n- If you would like to create a new file, you can include the file path in your response.\n- If you would like to modify an existing file, you can include the file path in your response.\n\nYou should return all files that you think will be required to look at or modify to integrate PostHog. You should return them in the order you would like to see them processed, with new files first, followed by the files that you want to update to integrate PostHog.\n\nRules:\n- Only return files that you think will be required to look at or modify to integrate PostHog.\n- Do not return files that are unlikely to require modification based on the documentation.\n- If you are unsure, return the file, since it's better to have more files than less.\n- If you create a new file, it should not conflict with any existing files.\n- If the user is using TypeScript, you should return .ts and .tsx files.\n- The file structure of the project may be different than the documentation, you should follow the file structure of the project.\n{integration_rules}\n\nInstallation documentation:\n{documentation}\n\nAll current files in the repository:\n\n{file_list}`,\n});\n\nexport const baseGenerateFileChangesPromptTemplate = new PromptTemplate({\n  inputVariables: [\n    'file_content',\n    'documentation',\n    'file_path',\n    'changed_files',\n    'unchanged_files',\n    'integration_name',\n    'integration_rules',\n  ],\n  template: `You are a PostHog installation wizard, a master AI programming assistant that implements PostHog for {integration_name} projects.\n\nYour task is to update the file to integrate PostHog according to the documentation.\nDo not return a diff — you should return the complete updated file content.\n\nRules:\n- Preserve the existing code formatting and style.\n- Only make the changes required by the documentation.\n- If no changes are needed, return the file as-is.\n- If the current file is empty, and you think it should be created, you can add the contents of the new file.\n- The file structure of the project may be different than the documentation, you should follow the file structure of the project.\n- Use relative imports if you are unsure what the project import paths are.\n{integration_rules}\n\n\nCONTEXT\n---\n\nDocumentation for integrating PostHog with {integration_name}:\n{documentation}\n\nThe file you are updating is:\n{file_path}\n\nHere are the changes you have already made to the project:\n{changed_files}\n\nHere are the files that have not been changed yet:\n{unchanged_files}\n\nBelow is the current file contents:\n{file_content}`,\n});\n"]}

package/dist/src/nextjs/docs.d.ts

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

package/dist/src/nextjs/docs.js

@@ -1,257 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNextjsPagesRouterDocs = exports.getNextjsAppRouterDocs = void 0;
-const urls_1 = require("../utils/urls");
-const getNextjsAppRouterDocs = ({ host, language, }) => {
-    return `
-==============================
-FILE: PostHogProvider.${language === 'typescript' ? 'tsx' : 'jsx'} (put it somewhere where client files are, like the components folder)
-LOCATION: Wherever other providers are, or the components folder
-==============================
-Changes:
-- Create a PostHogProvider component that will be imported into the layout file.
-
-Example:
---------------------------------------------------
-"use client"
-
-import posthog from "posthog-js"
-import { PostHogProvider as PHProvider, usePostHog } from "posthog-js/react"
-import { Suspense, useEffect } from "react"
-import { usePathname, useSearchParams } from "next/navigation"
-
-export function PostHogProvider({ children }: { children: React.ReactNode }) {
-  useEffect(() => {
-    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
-      api_host: "/ingest",
-      ui_host: "${(0, urls_1.getUiHostFromHost)(host)}",
-      capture_pageview: false, // We capture pageviews manually
-      capture_pageleave: true, // Enable pageleave capture
-      debug: process.env.NODE_ENV === "development",
-    })
-  }, [])
-
-  return (
-    <PHProvider client={posthog}>
-      <SuspendedPostHogPageView />
-      {children}
-    </PHProvider>
-  )
-}
-
-
-function PostHogPageView() {
-  const pathname = usePathname()
-  const searchParams = useSearchParams()
-  const posthog = usePostHog()
-
-  useEffect(() => {
-    if (pathname && posthog) {
-      let url = window.origin + pathname
-      const search = searchParams.toString()
-      if (search) {
-        url += "?" + search
-      }
-      posthog.capture("$pageview", { "$current_url": url })
-    }
-  }, [pathname, searchParams, posthog])
-
-  return null
-}
-
-function SuspendedPostHogPageView() {
-  return (
-    <Suspense fallback={null}>
-      <PostHogPageView />
-    </Suspense>
-  )
-}
---------------------------------------------------
-
-==============================
-FILE: layout.${language === 'typescript' ? 'tsx' : 'jsx'}
-LOCATION: Wherever the root layout is
-==============================
-Changes:
-- Import the PostHogProvider from the providers file and wrap the app in it.
-
-Example:
---------------------------------------------------
-// other imports
-import { PostHogProvider } from "LOCATION_OF_POSTHOG_PROVIDER"
-
-export default function RootLayout({ children }) {
-  return (
-    <html lang="en">
-      <body>
-        <PostHogProvider>
-          {/* other providers */}
-          {children}
-          {/* other providers */}
-        </PostHogProvider>
-      </body>
-    </html>
-  )
-}
---------------------------------------------------
-
-==============================
-FILE: posthog.${language === 'typescript' ? 'ts' : 'js'}
-LOCATION: Wherever works best given the project structure
-==============================
-Changes:
-- Initialize the PostHog Node.js client
-
-Example:
---------------------------------------------------
-import { PostHog } from "posthog-node"
-
-export default function PostHogClient() {
-  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
-    host: "${host}",
-    flushAt: 1,
-    flushInterval: 0,
-  })
-  return posthogClient
-}
---------------------------------------------------
-
-==============================
-FILE: next.config.{js,ts,mjs,cjs}
-LOCATION: Wherever the root next config is
-==============================
-Changes:
-- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.
-- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.
-- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.
-
-Example:
---------------------------------------------------
-const nextConfig = {
-  // other config
-  async rewrites() {
-    return [
-      {
-        source: "/ingest/static/:path*",
-        destination: "${(0, urls_1.getAssetHostFromHost)(host)}/static/:path*",
-      },
-      {
-        source: "/ingest/:path*",
-        destination: "${host}/:path*",
-      },
-      {
-        source: "/ingest/decide",
-        destination: "${host}/decide",
-      },
-    ];
-  },
-  // This is required to support PostHog trailing slash API requests
-  skipTrailingSlashRedirect: true,
-}
-module.exports = nextConfig
---------------------------------------------------`;
-};
-exports.getNextjsAppRouterDocs = getNextjsAppRouterDocs;
-const getNextjsPagesRouterDocs = ({ host, language, }) => {
-    return `
-==============================
-FILE: _app.${language === 'typescript' ? 'tsx' : 'jsx'}
-LOCATION: Wherever the root _app.${language === 'typescript' ? 'tsx' : 'jsx'} file is
-==============================
-Changes:
-- Initialize PostHog in _app.js.
-- Wrap the application in PostHogProvider.
-- Manually capture $pageview events.
-
-Example:
---------------------------------------------------
-import { useEffect } from "react"
-import { Router } from "next/router"
-import posthog from "posthog-js"
-import { PostHogProvider } from "posthog-js/react"
-
-export default function App({ Component, pageProps }) {
-  useEffect(() => {
-    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY, {
-      api_host: "/ingest",
-      ui_host: "${(0, urls_1.getUiHostFromHost)(host)}",
-      loaded: (posthog) => {
-        if (process.env.NODE_ENV === "development") posthog.debug()
-      },
-      debug: process.env.NODE_ENV === "development",
-    })
-
-    const handleRouteChange = () => posthog?.capture("$pageview")
-    Router.events.on("routeChangeComplete", handleRouteChange)
-
-    return () => {
-      Router.events.off("routeChangeComplete", handleRouteChange)
-    }
-  }, [])
-
-  return (
-    <PostHogProvider client={posthog}>
-      <Component {...pageProps} />
-    </PostHogProvider>
-  )
-}
---------------------------------------------------
-
-==============================
-FILE: posthog.${language === 'typescript' ? 'ts' : 'js'}
-LOCATION: Wherever works best given the project structure
-==============================
-Changes:
-- Initialize the PostHog Node.js client
-
-Example:
---------------------------------------------------
-import { PostHog } from "posthog-node"
-
-export default function PostHogClient() {
-  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
-    host: "${host}",
-    flushAt: 1,
-    flushInterval: 0,
-  })
-  return posthogClient
-}
---------------------------------------------------
-
-==============================
-FILE: next.config.{js,ts,mjs,cjs}
-LOCATION: Wherever the root next config is
-==============================
-Changes:
-- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.
-- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.
-- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.
-
-Example:
---------------------------------------------------
-const nextConfig = {
-  // other config
-  async rewrites() {
-    return [
-      {
-        source: "/ingest/static/:path*",
-        destination: "${(0, urls_1.getAssetHostFromHost)(host)}/static/:path*",
-      },
-      {
-        source: "/ingest/:path*",
-        destination: "${host}/:path*",
-      },
-      {
-        source: "/ingest/decide",
-        destination: "${host}/decide",
-      },
-    ];
-  },
-  // This is required to support PostHog trailing slash API requests
-  skipTrailingSlashRedirect: true,
-}
-module.exports = nextConfig
---------------------------------------------------`;
-};
-exports.getNextjsPagesRouterDocs = getNextjsPagesRouterDocs;
-//# sourceMappingURL=docs.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/nextjs/docs.ts"],"names":[],"mappings":";;;AAAA,wCAAwE;AAEjE,MAAM,sBAAsB,GAAG,CAAC,EACrC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;wBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;kBAmBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6C1B,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA2BxC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;aAY1C,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBO,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA5JW,QAAA,sBAAsB,0BA4JjC;AAEK,MAAM,wBAAwB,GAAG,CAAC,EACvC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;aAEI,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;mCAElD,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;kBAkBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;gBAwBzB,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;aAY1C,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBO,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA5GW,QAAA,wBAAwB,4BA4GnC","sourcesContent":["import { getAssetHostFromHost, getUiHostFromHost } from '../utils/urls';\n\nexport const getNextjsAppRouterDocs = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: PostHogProvider.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } (put it somewhere where client files are, like the components folder)\nLOCATION: Wherever other providers are, or the components folder\n==============================\nChanges:\n- Create a PostHogProvider component that will be imported into the layout file.\n\nExample:\n--------------------------------------------------\n\"use client\"\n\nimport posthog from \"posthog-js\"\nimport { PostHogProvider as PHProvider, usePostHog } from \"posthog-js/react\"\nimport { Suspense, useEffect } from \"react\"\nimport { usePathname, useSearchParams } from \"next/navigation\"\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n      api_host: \"/ingest\",\n      ui_host: \"${getUiHostFromHost(host)}\",\n      capture_pageview: false, // We capture pageviews manually\n      capture_pageleave: true, // Enable pageleave capture\n      debug: process.env.NODE_ENV === \"development\",\n    })\n  }, [])\n\n  return (\n    <PHProvider client={posthog}>\n      <SuspendedPostHogPageView />\n      {children}\n    </PHProvider>\n  )\n}\n\n\nfunction PostHogPageView() {\n  const pathname = usePathname()\n  const searchParams = useSearchParams()\n  const posthog = usePostHog()\n\n  useEffect(() => {\n    if (pathname && posthog) {\n      let url = window.origin + pathname\n      const search = searchParams.toString()\n      if (search) {\n        url += \"?\" + search\n      }\n      posthog.capture(\"$pageview\", { \"$current_url\": url })\n    }\n  }, [pathname, searchParams, posthog])\n\n  return null\n}\n\nfunction SuspendedPostHogPageView() {\n  return (\n    <Suspense fallback={null}>\n      <PostHogPageView />\n    </Suspense>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: layout.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root layout is\n==============================\nChanges:\n- Import the PostHogProvider from the providers file and wrap the app in it.\n\nExample:\n--------------------------------------------------\n// other imports\nimport { PostHogProvider } from \"LOCATION_OF_POSTHOG_PROVIDER\"\n\nexport default function RootLayout({ children }) {\n  return (\n    <html lang=\"en\">\n      <body>\n        <PostHogProvider>\n          {/* other providers */}\n          {children}\n          {/* other providers */}\n        </PostHogProvider>\n      </body>\n    </html>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n    host: \"${host}\",\n    flushAt: 1,\n    flushInterval: 0,\n  })\n  return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n  // other config\n  async rewrites() {\n    return [\n      {\n        source: \"/ingest/static/:path*\",\n        destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n      },\n      {\n        source: \"/ingest/:path*\",\n        destination: \"${host}/:path*\",\n      },\n      {\n        source: \"/ingest/decide\",\n        destination: \"${host}/decide\",\n      },\n    ];\n  },\n  // This is required to support PostHog trailing slash API requests\n  skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n\nexport const getNextjsPagesRouterDocs = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: _app.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root _app.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } file is\n==============================\nChanges:\n- Initialize PostHog in _app.js.\n- Wrap the application in PostHogProvider.\n- Manually capture $pageview events.\n\nExample:\n--------------------------------------------------\nimport { useEffect } from \"react\"\nimport { Router } from \"next/router\"\nimport posthog from \"posthog-js\"\nimport { PostHogProvider } from \"posthog-js/react\"\n\nexport default function App({ Component, pageProps }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY, {\n      api_host: \"/ingest\",\n      ui_host: \"${getUiHostFromHost(host)}\",\n      loaded: (posthog) => {\n        if (process.env.NODE_ENV === \"development\") posthog.debug()\n      },\n      debug: process.env.NODE_ENV === \"development\",\n    })\n\n    const handleRouteChange = () => posthog?.capture(\"$pageview\")\n    Router.events.on(\"routeChangeComplete\", handleRouteChange)\n\n    return () => {\n      Router.events.off(\"routeChangeComplete\", handleRouteChange)\n    }\n  }, [])\n\n  return (\n    <PostHogProvider client={posthog}>\n      <Component {...pageProps} />\n    </PostHogProvider>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n    host: \"${host}\",\n    flushAt: 1,\n    flushInterval: 0,\n  })\n  return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n  // other config\n  async rewrites() {\n    return [\n      {\n        source: \"/ingest/static/:path*\",\n        destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n      },\n      {\n        source: \"/ingest/:path*\",\n        destination: \"${host}/:path*\",\n      },\n      {\n        source: \"/ingest/decide\",\n        destination: \"${host}/decide\",\n      },\n    ];\n  },\n  // This is required to support PostHog trailing slash API requests\n  skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n"]}