@posthog/wizard 2.9.1 → 2.10.1

package/dist/src/frameworks/javascript-web/utils.d.ts

@@ -1,28 +0,0 @@
-import type { WizardOptions } from '../../utils/types';
-export type JavaScriptContext = {
-    packageManagerName?: string;
-    hasTypeScript?: boolean;
-    hasBundler?: string;
-};
-/**
- * Packages that indicate a specific framework integration exists.
- * If any of these are in package.json, we should NOT match as generic JavaScript.
- *
- * When adding a new JS framework integration to the wizard,
- * add its detection package here too.
- */
-export declare const FRAMEWORK_PACKAGES: readonly ["next", "nuxt", "vue", "react-router", "@tanstack/react-start", "@tanstack/react-router", "react-native", "@angular/core", "astro", "@sveltejs/kit"];
-/**
- * Detect the JS package manager for the project by checking lockfiles.
- * Reuses the existing package manager detection infrastructure.
- */
-export declare function detectJsPackageManager(options: Pick<WizardOptions, 'installDir'>): string;
-/**
- * Detect the bundler used in the project by checking package.json dependencies.
- */
-export declare function detectBundler(options: Pick<WizardOptions, 'installDir'>): string | undefined;
-/**
- * Heuristic: check if there is an index.html anywhere in the project,
- * ignoring common build and dependency directories.
- */
-export declare function hasIndexHtml(options: Pick<WizardOptions, 'installDir'>): boolean;

package/dist/src/frameworks/javascript-web/utils.js

@@ -1,147 +0,0 @@
-"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.FRAMEWORK_PACKAGES = void 0;
-exports.detectJsPackageManager = detectJsPackageManager;
-exports.detectBundler = detectBundler;
-exports.hasIndexHtml = hasIndexHtml;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const package_manager_1 = require("../../utils/package-manager");
-const INDEX_HTML_MAX_DEPTH = 6;
-const INDEX_HTML_IGNORE_DIRS = new Set([
-    'node_modules',
-    '.git',
-    '.next',
-    'dist',
-    'build',
-    '.turbo',
-    '.cache',
-]);
-/**
- * Packages that indicate a specific framework integration exists.
- * If any of these are in package.json, we should NOT match as generic JavaScript.
- *
- * When adding a new JS framework integration to the wizard,
- * add its detection package here too.
- */
-exports.FRAMEWORK_PACKAGES = [
-    'next',
-    'nuxt',
-    'vue',
-    'react-router',
-    '@tanstack/react-start',
-    '@tanstack/react-router',
-    'react-native',
-    '@angular/core',
-    'astro',
-    '@sveltejs/kit',
-];
-/**
- * Detect the JS package manager for the project by checking lockfiles.
- * Reuses the existing package manager detection infrastructure.
- */
-function detectJsPackageManager(options) {
-    const detected = (0, package_manager_1.detectAllPackageManagers)(options);
-    if (detected.length > 0) {
-        return detected[0].label;
-    }
-    return 'unknown';
-}
-/**
- * Detect the bundler used in the project by checking package.json dependencies.
- */
-function detectBundler(options) {
-    try {
-        const content = fs.readFileSync(path.join(options.installDir, 'package.json'), 'utf-8');
-        const pkg = JSON.parse(content);
-        const allDeps = {
-            ...pkg.dependencies,
-            ...pkg.devDependencies,
-        };
-        if (allDeps['vite'])
-            return 'vite';
-        if (allDeps['webpack'])
-            return 'webpack';
-        if (allDeps['esbuild'])
-            return 'esbuild';
-        if (allDeps['parcel'])
-            return 'parcel';
-        if (allDeps['rollup'])
-            return 'rollup';
-        return undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Heuristic: check if there is an index.html anywhere in the project,
- * ignoring common build and dependency directories.
- */
-function hasIndexHtml(options) {
-    const root = options.installDir;
-    function search(dir, depth) {
-        if (depth > INDEX_HTML_MAX_DEPTH) {
-            return false;
-        }
-        const base = path.basename(dir);
-        if (INDEX_HTML_IGNORE_DIRS.has(base)) {
-            return false;
-        }
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            return false;
-        }
-        for (const entry of entries) {
-            if (entry.isFile() && entry.name.toLowerCase() === 'index.html') {
-                return true;
-            }
-        }
-        for (const entry of entries) {
-            if (entry.isDirectory()) {
-                if (search(path.join(dir, entry.name), depth + 1)) {
-                    return true;
-                }
-            }
-        }
-        return false;
-    }
-    return search(root, 0);
-}
-//# sourceMappingURL=utils.js.map

package/dist/src/frameworks/javascript-web/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/javascript-web/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { detectAllPackageManagers } from '../../utils/package-manager';\nimport type { WizardOptions } from '../../utils/types';\n\nexport type JavaScriptContext = {\n  packageManagerName?: string;\n  hasTypeScript?: boolean;\n  hasBundler?: string;\n};\n\nconst INDEX_HTML_MAX_DEPTH = 6;\nconst INDEX_HTML_IGNORE_DIRS = new Set([\n  'node_modules',\n  '.git',\n  '.next',\n  'dist',\n  'build',\n  '.turbo',\n  '.cache',\n]);\n\n/**\n * Packages that indicate a specific framework integration exists.\n * If any of these are in package.json, we should NOT match as generic JavaScript.\n *\n * When adding a new JS framework integration to the wizard,\n * add its detection package here too.\n */\nexport const FRAMEWORK_PACKAGES = [\n  'next',\n  'nuxt',\n  'vue',\n  'react-router',\n  '@tanstack/react-start',\n  '@tanstack/react-router',\n  'react-native',\n  '@angular/core',\n  'astro',\n  '@sveltejs/kit',\n] as const;\n\n/**\n * Detect the JS package manager for the project by checking lockfiles.\n * Reuses the existing package manager detection infrastructure.\n */\nexport function detectJsPackageManager(\n  options: Pick<WizardOptions, 'installDir'>,\n): string {\n  const detected = detectAllPackageManagers(options);\n  if (detected.length > 0) {\n    return detected[0].label;\n  }\n  return 'unknown';\n}\n\n/**\n * Detect the bundler used in the project by checking package.json dependencies.\n */\nexport function detectBundler(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  try {\n    const content = fs.readFileSync(\n      path.join(options.installDir, 'package.json'),\n      'utf-8',\n    );\n    const pkg = JSON.parse(content);\n    const allDeps: Record<string, string> = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n\n    if (allDeps['vite']) return 'vite';\n    if (allDeps['webpack']) return 'webpack';\n    if (allDeps['esbuild']) return 'esbuild';\n    if (allDeps['parcel']) return 'parcel';\n    if (allDeps['rollup']) return 'rollup';\n    return undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Heuristic: check if there is an index.html anywhere in the project,\n * ignoring common build and dependency directories.\n */\nexport function hasIndexHtml(\n  options: Pick<WizardOptions, 'installDir'>,\n): boolean {\n  const root = options.installDir;\n\n  function search(dir: string, depth: number): boolean {\n    if (depth > INDEX_HTML_MAX_DEPTH) {\n      return false;\n    }\n\n    const base = path.basename(dir);\n    if (INDEX_HTML_IGNORE_DIRS.has(base)) {\n      return false;\n    }\n\n    let entries: fs.Dirent[];\n    try {\n      entries = fs.readdirSync(dir, { withFileTypes: true });\n    } catch {\n      return false;\n    }\n\n    for (const entry of entries) {\n      if (entry.isFile() && entry.name.toLowerCase() === 'index.html') {\n        return true;\n      }\n    }\n\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        if (search(path.join(dir, entry.name), depth + 1)) {\n          return true;\n        }\n      }\n    }\n\n    return false;\n  }\n\n  return search(root, 0);\n}\n"]}

package/dist/src/frameworks/laravel/laravel-wizard-agent.d.ts

@@ -1,10 +0,0 @@
-import type { FrameworkConfig } from '../../lib/framework-config';
-import { LaravelProjectType } from './utils';
-type LaravelContext = {
-    projectType?: LaravelProjectType;
-    serviceProvider?: string;
-    bootstrapFile?: string;
-    laravelStructure?: string;
-};
-export declare const LARAVEL_AGENT_CONFIG: FrameworkConfig<LaravelContext>;
-export {};

package/dist/src/frameworks/laravel/laravel-wizard-agent.js

@@ -1,182 +0,0 @@
-"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 });
-exports.LARAVEL_AGENT_CONFIG = void 0;
-const package_manager_1 = require("../../lib/detection/package-manager");
-const constants_1 = require("../../lib/constants");
-const fast_glob_1 = __importDefault(require("fast-glob"));
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const utils_1 = require("./utils");
-exports.LARAVEL_AGENT_CONFIG = {
-    metadata: {
-        name: 'Laravel',
-        integration: constants_1.Integration.laravel,
-        beta: true,
-        docsUrl: 'https://posthog.com/docs/libraries/php',
-        unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/php',
-        gatherContext: async (options) => {
-            const projectType = await (0, utils_1.getLaravelProjectType)(options);
-            const serviceProvider = await (0, utils_1.findLaravelServiceProvider)(options);
-            const bootstrapFile = (0, utils_1.findLaravelBootstrapFile)(options);
-            const laravelStructure = (0, utils_1.detectLaravelStructure)(options);
-            return {
-                projectType,
-                serviceProvider,
-                bootstrapFile,
-                laravelStructure,
-            };
-        },
-    },
-    detection: {
-        packageName: 'laravel/framework',
-        packageDisplayName: 'Laravel',
-        usesPackageJson: false,
-        getVersion: () => undefined,
-        getVersionBucket: utils_1.getLaravelVersionBucket,
-        minimumVersion: '9.0.0',
-        getInstalledVersion: (options) => Promise.resolve((0, utils_1.getLaravelVersion)(options)),
-        detect: async (options) => {
-            const { installDir } = options;
-            const artisanPath = path.join(installDir, 'artisan');
-            if (fs.existsSync(artisanPath)) {
-                try {
-                    const content = fs.readFileSync(artisanPath, 'utf-8');
-                    if (content.includes('Laravel') || content.includes('Artisan')) {
-                        return true;
-                    }
-                }
-                catch {
-                    // Continue to other checks
-                }
-            }
-            const composerPath = path.join(installDir, 'composer.json');
-            if (fs.existsSync(composerPath)) {
-                try {
-                    const content = fs.readFileSync(composerPath, 'utf-8');
-                    const composer = JSON.parse(content);
-                    if (composer.require?.['laravel/framework'] ||
-                        composer['require-dev']?.['laravel/framework']) {
-                        return true;
-                    }
-                }
-                catch {
-                    // Continue to other checks
-                }
-            }
-            const hasLaravelStructure = await (0, fast_glob_1.default)(['**/bootstrap/app.php', '**/app/Http/Kernel.php'], { cwd: installDir, ignore: ['**/vendor/**'] });
-            return hasLaravelStructure.length > 0;
-        },
-        detectPackageManager: package_manager_1.composerPackageManager,
-    },
-    environment: {
-        uploadToHosting: false,
-        getEnvVars: (apiKey, host) => ({
-            POSTHOG_PROJECT_TOKEN: apiKey,
-            POSTHOG_HOST: host,
-        }),
-    },
-    analytics: {
-        getTags: (context) => ({
-            projectType: context.projectType || 'unknown',
-            laravelStructure: context.laravelStructure || 'unknown',
-        }),
-    },
-    prompts: {
-        projectTypeDetection: 'This is a PHP/Laravel project. Look for composer.json, artisan CLI, and app/ directory structure to confirm. Check for Laravel-specific packages like laravel/framework.',
-        packageInstallation: 'Use Composer to install packages. Run `composer require posthog/posthog-php` without pinning a specific version.',
-        getAdditionalContextLines: (context) => {
-            const projectTypeName = context.projectType
-                ? (0, utils_1.getLaravelProjectTypeName)(context.projectType)
-                : 'unknown';
-            const lines = [
-                `Project type: ${projectTypeName}`,
-                `Framework docs ID: php (use posthog://docs/frameworks/php for documentation)`,
-                `Laravel structure: ${context.laravelStructure} (affects where to add configuration)`,
-            ];
-            if (context.serviceProvider) {
-                lines.push(`Service provider: ${context.serviceProvider}`);
-            }
-            if (context.bootstrapFile) {
-                lines.push(`Bootstrap file: ${context.bootstrapFile}`);
-            }
-            // Add Laravel-specific guidance based on version structure
-            if (context.laravelStructure === 'latest') {
-                lines.push('Note: Laravel 11+ uses simplified bootstrap/app.php for middleware and providers');
-            }
-            else {
-                lines.push('Note: Use app/Http/Kernel.php for middleware, app/Providers for service providers');
-            }
-            return lines;
-        },
-    },
-    ui: {
-        successMessage: 'PostHog integration complete',
-        estimatedDurationMinutes: 5,
-        getOutroChanges: (context) => {
-            const projectTypeName = context.projectType
-                ? (0, utils_1.getLaravelProjectTypeName)(context.projectType)
-                : 'Laravel';
-            const changes = [
-                `Analyzed your ${projectTypeName} project structure`,
-                `Installed the PostHog PHP package via Composer`,
-                `Configured PostHog in your Laravel application`,
-            ];
-            if (context.laravelStructure === 'latest') {
-                changes.push('Added PostHog initialization to bootstrap/app.php');
-            }
-            else {
-                changes.push('Created a PostHog service provider for initialization');
-            }
-            if (context.projectType === utils_1.LaravelProjectType.INERTIA) {
-                changes.push('Configured PostHog to work with Inertia.js');
-            }
-            if (context.projectType === utils_1.LaravelProjectType.LIVEWIRE) {
-                changes.push('Configured PostHog to work with Livewire');
-            }
-            return changes;
-        },
-        getOutroNextSteps: () => [
-            'Start your Laravel development server with `php artisan serve`',
-            'Visit your PostHog dashboard to see incoming events',
-            'Use PostHog::capture() to track custom events',
-            'Use PostHog::identify() to associate events with users',
-        ],
-    },
-};
-//# sourceMappingURL=laravel-wizard-agent.js.map

package/dist/src/frameworks/laravel/laravel-wizard-agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"laravel-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/laravel/laravel-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Laravel wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { composerPackageManager } from '../../lib/detection/package-manager';\nimport { Integration } from '../../lib/constants';\nimport fg from 'fast-glob';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport {\n  getLaravelVersion,\n  getLaravelProjectType,\n  getLaravelProjectTypeName,\n  getLaravelVersionBucket,\n  LaravelProjectType,\n  findLaravelServiceProvider,\n  findLaravelBootstrapFile,\n  detectLaravelStructure,\n} from './utils';\n\ntype LaravelContext = {\n  projectType?: LaravelProjectType;\n  serviceProvider?: string;\n  bootstrapFile?: string;\n  laravelStructure?: string;\n};\n\nexport const LARAVEL_AGENT_CONFIG: FrameworkConfig<LaravelContext> = {\n  metadata: {\n    name: 'Laravel',\n    integration: Integration.laravel,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/php',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/php',\n    gatherContext: async (options: WizardOptions) => {\n      const projectType = await getLaravelProjectType(options);\n      const serviceProvider = await findLaravelServiceProvider(options);\n      const bootstrapFile = findLaravelBootstrapFile(options);\n      const laravelStructure = detectLaravelStructure(options);\n\n      return {\n        projectType,\n        serviceProvider,\n        bootstrapFile,\n        laravelStructure,\n      };\n    },\n  },\n\n  detection: {\n    packageName: 'laravel/framework',\n    packageDisplayName: 'Laravel',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getLaravelVersionBucket,\n    minimumVersion: '9.0.0',\n    getInstalledVersion: (options: WizardOptions) =>\n      Promise.resolve(getLaravelVersion(options)),\n    detect: async (options) => {\n      const { installDir } = options;\n\n      const artisanPath = path.join(installDir, 'artisan');\n      if (fs.existsSync(artisanPath)) {\n        try {\n          const content = fs.readFileSync(artisanPath, 'utf-8');\n          if (content.includes('Laravel') || content.includes('Artisan')) {\n            return true;\n          }\n        } catch {\n          // Continue to other checks\n        }\n      }\n\n      const composerPath = path.join(installDir, 'composer.json');\n      if (fs.existsSync(composerPath)) {\n        try {\n          const content = fs.readFileSync(composerPath, 'utf-8');\n          const composer = JSON.parse(content);\n          if (\n            composer.require?.['laravel/framework'] ||\n            composer['require-dev']?.['laravel/framework']\n          ) {\n            return true;\n          }\n        } catch {\n          // Continue to other checks\n        }\n      }\n\n      const hasLaravelStructure = await fg(\n        ['**/bootstrap/app.php', '**/app/Http/Kernel.php'],\n        { cwd: installDir, ignore: ['**/vendor/**'] },\n      );\n\n      return hasLaravelStructure.length > 0;\n    },\n    detectPackageManager: composerPackageManager,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      POSTHOG_PROJECT_TOKEN: apiKey,\n      POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      projectType: context.projectType || 'unknown',\n      laravelStructure: context.laravelStructure || 'unknown',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a PHP/Laravel project. Look for composer.json, artisan CLI, and app/ directory structure to confirm. Check for Laravel-specific packages like laravel/framework.',\n    packageInstallation:\n      'Use Composer to install packages. Run `composer require posthog/posthog-php` without pinning a specific version.',\n    getAdditionalContextLines: (context) => {\n      const projectTypeName = context.projectType\n        ? getLaravelProjectTypeName(context.projectType)\n        : 'unknown';\n\n      const lines = [\n        `Project type: ${projectTypeName}`,\n        `Framework docs ID: php (use posthog://docs/frameworks/php for documentation)`,\n        `Laravel structure: ${context.laravelStructure} (affects where to add configuration)`,\n      ];\n\n      if (context.serviceProvider) {\n        lines.push(`Service provider: ${context.serviceProvider}`);\n      }\n\n      if (context.bootstrapFile) {\n        lines.push(`Bootstrap file: ${context.bootstrapFile}`);\n      }\n\n      // Add Laravel-specific guidance based on version structure\n      if (context.laravelStructure === 'latest') {\n        lines.push(\n          'Note: Laravel 11+ uses simplified bootstrap/app.php for middleware and providers',\n        );\n      } else {\n        lines.push(\n          'Note: Use app/Http/Kernel.php for middleware, app/Providers for service providers',\n        );\n      }\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: (context) => {\n      const projectTypeName = context.projectType\n        ? getLaravelProjectTypeName(context.projectType)\n        : 'Laravel';\n\n      const changes = [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the PostHog PHP package via Composer`,\n        `Configured PostHog in your Laravel application`,\n      ];\n\n      if (context.laravelStructure === 'latest') {\n        changes.push('Added PostHog initialization to bootstrap/app.php');\n      } else {\n        changes.push('Created a PostHog service provider for initialization');\n      }\n\n      if (context.projectType === LaravelProjectType.INERTIA) {\n        changes.push('Configured PostHog to work with Inertia.js');\n      }\n\n      if (context.projectType === LaravelProjectType.LIVEWIRE) {\n        changes.push('Configured PostHog to work with Livewire');\n      }\n\n      return changes;\n    },\n    getOutroNextSteps: () => [\n      'Start your Laravel development server with `php artisan serve`',\n      'Visit your PostHog dashboard to see incoming events',\n      'Use PostHog::capture() to track custom events',\n      'Use PostHog::identify() to associate events with users',\n    ],\n  },\n};\n"]}

package/dist/src/frameworks/laravel/utils.d.ts

@@ -1,38 +0,0 @@
-import type { WizardOptions } from '../../utils/types';
-export declare enum LaravelProjectType {
-    STANDARD = "standard",// Basic Laravel app
-    INERTIA = "inertia",// Inertia.js (Vue/React SPA) - may need JS SDK too
-    LIVEWIRE = "livewire"
-}
-/**
- * Get Laravel version bucket for analytics
- */
-export declare const getLaravelVersionBucket: (version: string | undefined) => string;
-/**
- * Read and parse composer.json
- */
-export declare function getComposerJson(options: Pick<WizardOptions, 'installDir'>): Record<string, any> | undefined;
-/**
- * Get Laravel version from composer.json
- */
-export declare function getLaravelVersion(options: Pick<WizardOptions, 'installDir'>): string | undefined;
-/**
- * Get human-readable name for Laravel project type
- */
-export declare function getLaravelProjectTypeName(projectType: LaravelProjectType): string;
-/**
- * Detect Laravel project type
- */
-export declare function getLaravelProjectType(options: WizardOptions): Promise<LaravelProjectType>;
-/**
- * Find the main service provider file
- */
-export declare function findLaravelServiceProvider(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;
-/**
- * Find the bootstrap file (differs between Laravel versions)
- */
-export declare function findLaravelBootstrapFile(options: Pick<WizardOptions, 'installDir'>): string | undefined;
-/**
- * Detect Laravel version structure for configuration guidance
- */
-export declare function detectLaravelStructure(options: Pick<WizardOptions, 'installDir'>): 'legacy' | 'modern' | 'latest';