@amplitude/wizard 1.0.0-beta.0

package/dist/src/frameworks/react-native/utils.js

@@ -0,0 +1,82 @@
+"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.detectReactNativeProject = detectReactNativeProject;
+exports.detectExpo = detectExpo;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+/**
+ * Returns true when the directory contains a React Native project.
+ *
+ * Primary signal: package.json with `react-native` in dependencies or
+ * devDependencies. This is the definitive indicator that distinguishes
+ * React Native from:
+ *   - Plain web apps (Next.js, Vite, CRA) — no `react-native` dep
+ *   - Pure Android native projects — no package.json at all
+ *   - Flutter — uses pubspec.yaml, detected earlier in the pipeline
+ *
+ * Note: The `javascript-web` detector already excludes `react-native`
+ * via FRAMEWORK_PACKAGES, and this detector runs before `android` in
+ * the registry so AndroidManifest.xml overlap is not a concern.
+ */
+async function detectReactNativeProject(options) {
+    const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+    if (!packageJson)
+        return false;
+    return (0, package_json_1.hasPackageInstalled)('react-native', packageJson);
+}
+/**
+ * Returns true if the React Native project uses Expo.
+ * Checks for `expo` package or an app.json with a top-level "expo" key.
+ */
+async function detectExpo(options) {
+    const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+    if (packageJson && (0, package_json_1.hasPackageInstalled)('expo', packageJson)) {
+        return true;
+    }
+    // Expo managed workflow: app.json has { "expo": { ... } }
+    const appJsonPath = path.join(options.installDir, 'app.json');
+    try {
+        const appJson = JSON.parse(fs.readFileSync(appJsonPath, 'utf-8'));
+        if ('expo' in appJson)
+            return true;
+    }
+    catch {
+        // absent or unparseable — not Expo
+    }
+    return false;
+}

package/dist/src/frameworks/react-router/react-router-wizard-agent.d.ts

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+import { ReactRouterMode } from './utils';
+type ReactRouterContext = {
+    routerMode?: ReactRouterMode;
+};
+export declare const REACT_ROUTER_AGENT_CONFIG: FrameworkConfig<ReactRouterContext>;
+export {};

package/dist/src/frameworks/react-router/react-router-wizard-agent.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACT_ROUTER_AGENT_CONFIG = void 0;
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+const ui_1 = require("../../ui");
+const utils_1 = require("./utils");
+exports.REACT_ROUTER_AGENT_CONFIG = {
+    metadata: {
+        name: 'React Router',
+        integration: constants_1.Integration.reactRouter,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/browser/browser-sdk-2',
+        unsupportedVersionDocsUrl: 'https://amplitude.com/docs/sdks/analytics/browser/browser-sdk-2',
+        gatherContext: async (options) => {
+            const routerMode = await (0, utils_1.getReactRouterMode)(options);
+            if (routerMode) {
+                (0, ui_1.getUI)().setDetectedFramework(`React Router ${(0, utils_1.getReactRouterModeName)(routerMode)}`);
+                return { routerMode };
+            }
+            return {};
+        },
+    },
+    detection: {
+        packageName: 'react-router',
+        packageDisplayName: 'React Router',
+        getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('react-router', packageJson),
+        getVersionBucket: utils_1.getReactRouterVersionBucket,
+        minimumVersion: '6.0.0',
+        getInstalledVersion: async (options) => {
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.getPackageVersion)('react-router', packageJson)
+                : undefined;
+        },
+        detect: async (options) => {
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.hasPackageInstalled)('react-router', packageJson)
+                : false;
+        },
+        detectPackageManager: package_manager_detection_1.detectNodePackageManagers,
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, _host) => ({
+            REACT_APP_AMPLITUDE_API_KEY: apiKey,
+        }),
+    },
+    analytics: {
+        getTags: (context) => ({
+            routerMode: context.routerMode || 'unknown',
+        }),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',
+        getAdditionalContextLines: (context) => {
+            const routerMode = context.routerMode;
+            const modeName = routerMode
+                ? (0, utils_1.getReactRouterModeName)(routerMode)
+                : 'unknown';
+            // Map router mode to framework ID for MCP docs resource
+            const frameworkIdMap = {
+                [utils_1.ReactRouterMode.V6]: 'react-react-router-6',
+                [utils_1.ReactRouterMode.V7_FRAMEWORK]: 'react-react-router-7-framework',
+                [utils_1.ReactRouterMode.V7_DATA]: 'react-react-router-7-data',
+                [utils_1.ReactRouterMode.V7_DECLARATIVE]: 'react-react-router-7-declarative',
+            };
+            const frameworkId = routerMode
+                ? frameworkIdMap[routerMode]
+                : utils_1.ReactRouterMode.V7_FRAMEWORK;
+            return [
+                `Router mode: ${modeName}`,
+                `Framework docs ID: ${frameworkId} (use amplitude://docs/frameworks/${frameworkId} for documentation)`,
+                `Preferred Amplitude SDK: @amplitude/unified (prefer over @amplitude/analytics-browser for new browser integrations)`,
+            ];
+        },
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 8,
+        getOutroChanges: (context) => {
+            const modeName = context.routerMode
+                ? (0, utils_1.getReactRouterModeName)(context.routerMode)
+                : 'React Router';
+            return [
+                `Analyzed your React Router project structure (${modeName})`,
+                `Created and configured Amplitude initializers`,
+                `Integrated Amplitude into your application`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Start your development server to see Amplitude in action',
+            'Visit your Amplitude dashboard to see incoming events',
+        ],
+    },
+};

package/dist/src/frameworks/react-router/utils.d.ts

@@ -0,0 +1,13 @@
+import type { WizardOptions } from '../../utils/types';
+export declare enum ReactRouterMode {
+    V6 = "v6",
+    V7_FRAMEWORK = "v7-framework",
+    V7_DATA = "v7-data",
+    V7_DECLARATIVE = "v7-declarative"
+}
+export declare const getReactRouterVersionBucket: (version: string | undefined) => string;
+/**
+ * Detect React Router mode. Pure — returns null if ambiguous.
+ */
+export declare function getReactRouterMode(options: WizardOptions): Promise<ReactRouterMode | null>;
+export declare function getReactRouterModeName(mode: ReactRouterMode): string;

package/dist/src/frameworks/react-router/utils.js

@@ -0,0 +1,160 @@
+"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.getReactRouterVersionBucket = exports.ReactRouterMode = void 0;
+exports.getReactRouterMode = getReactRouterMode;
+exports.getReactRouterModeName = getReactRouterModeName;
+const semver_1 = require("semver");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const setup_utils_1 = require("../../utils/setup-utils");
+const package_json_1 = require("../../utils/package-json");
+const semver_2 = require("../../utils/semver");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const semver = __importStar(require("semver"));
+var ReactRouterMode;
+(function (ReactRouterMode) {
+    ReactRouterMode["V6"] = "v6";
+    ReactRouterMode["V7_FRAMEWORK"] = "v7-framework";
+    ReactRouterMode["V7_DATA"] = "v7-data";
+    ReactRouterMode["V7_DECLARATIVE"] = "v7-declarative";
+})(ReactRouterMode || (exports.ReactRouterMode = ReactRouterMode = {}));
+const IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/public/**',
+    '**/.next/**',
+];
+exports.getReactRouterVersionBucket = (0, semver_2.createVersionBucket)();
+async function hasReactRouterConfig({ installDir, }) {
+    const configMatches = await (0, fast_glob_1.default)('**/react-router.config.@(ts|js|tsx|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    return configMatches.length > 0;
+}
+async function hasCreateBrowserRouter({ installDir, }) {
+    const sourceFiles = await (0, fast_glob_1.default)('**/*.@(ts|tsx|js|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const file of sourceFiles) {
+        try {
+            const filePath = path.join(installDir, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            if (content.includes('createBrowserRouter')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+async function hasDeclarativeRouter({ installDir, }) {
+    const sourceFiles = await (0, fast_glob_1.default)('**/*.@(ts|tsx|js|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const file of sourceFiles) {
+        try {
+            const filePath = path.join(installDir, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            if (content.includes('<BrowserRouter') ||
+                (content.includes('BrowserRouter') &&
+                    (content.includes('from "react-router-dom"') ||
+                        content.includes("from 'react-router-dom'")))) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Detect React Router mode. Pure — returns null if ambiguous.
+ */
+async function getReactRouterMode(options) {
+    const { installDir } = options;
+    const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+    if (!packageJson)
+        return null;
+    const reactRouterVersion = (0, package_json_1.getPackageVersion)('react-router-dom', packageJson) ||
+        (0, package_json_1.getPackageVersion)('react-router', packageJson);
+    if (!reactRouterVersion) {
+        return null;
+    }
+    const coercedVersion = semver.coerce(reactRouterVersion);
+    const majorVersion = coercedVersion ? (0, semver_1.major)(coercedVersion) : null;
+    if (majorVersion === 6) {
+        return ReactRouterMode.V6;
+    }
+    if (majorVersion === 7) {
+        const hasConfig = await hasReactRouterConfig({ installDir });
+        if (hasConfig)
+            return ReactRouterMode.V7_FRAMEWORK;
+        const hasDataMode = await hasCreateBrowserRouter({ installDir });
+        if (hasDataMode)
+            return ReactRouterMode.V7_DATA;
+        const hasDeclarative = await hasDeclarativeRouter({ installDir });
+        if (hasDeclarative)
+            return ReactRouterMode.V7_DECLARATIVE;
+        // v7 but can't detect mode
+        return null;
+    }
+    return null;
+}
+function getReactRouterModeName(mode) {
+    switch (mode) {
+        case ReactRouterMode.V6:
+            return 'v6';
+        case ReactRouterMode.V7_FRAMEWORK:
+            return 'v7 Framework mode';
+        case ReactRouterMode.V7_DATA:
+            return 'v7 Data mode';
+        case ReactRouterMode.V7_DECLARATIVE:
+            return 'v7 Declarative mode';
+    }
+}

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

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+import type { SwiftPackageManager } from './utils';
+type SwiftContext = {
+    packageManager?: SwiftPackageManager;
+};
+export declare const SWIFT_AGENT_CONFIG: FrameworkConfig<SwiftContext>;
+export {};

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

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SWIFT_AGENT_CONFIG = void 0;
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const utils_1 = require("./utils");
+const SWIFT_PACKAGE_INSTALLATION = "Use the detect_package_manager tool to determine the package manager. For Swift Package Manager: add the dependency via Xcode (File > Add Package Dependencies) using the URL https://github.com/amplitude/AmplitudeUnified-Swift, or by editing Package.swift. For CocoaPods: add `pod 'AmplitudeUnified'` to the Podfile and run pod install.";
+exports.SWIFT_AGENT_CONFIG = {
+    metadata: {
+        name: 'Swift',
+        integration: constants_1.Integration.swift,
+        beta: true,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/ios/unified-sdk',
+        preRunNotice: 'Close Xcode before running the wizard to avoid file conflicts.',
+        gatherContext: (options) => {
+            const packageManager = (0, utils_1.detectSwiftPackageManager)(options);
+            return Promise.resolve({ packageManager });
+        },
+    },
+    detection: {
+        packageName: 'AmplitudeUnified',
+        packageDisplayName: 'Swift',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detect: utils_1.detectSwiftProject,
+        detectPackageManager: package_manager_detection_1.swiftPackageManager,
+    },
+    environment: {
+        // iOS/macOS apps don't use .env files — the agent stores the key in the project
+        uploadToHosting: false,
+        getEnvVars: () => ({}),
+    },
+    analytics: {
+        getTags: (context) => ({
+            packageManager: context.packageManager ?? 'unknown',
+        }),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a Swift/iOS/macOS project. Look for *.xcodeproj directories, Podfile, Package.swift, or .swift source files to confirm.',
+        packageInstallation: SWIFT_PACKAGE_INSTALLATION,
+        getAdditionalContextLines: (context) => {
+            const pm = context.packageManager ?? 'spm';
+            return [
+                `Package manager: ${pm === 'cocoapods' ? 'CocoaPods' : 'Swift Package Manager'}`,
+                `Framework docs ID: swift (use amplitude://docs/frameworks/swift for documentation)`,
+                `SDK: AmplitudeUnified — Swift package URL: https://github.com/amplitude/AmplitudeUnified-Swift`,
+                `Initialization: let amplitude = Amplitude(apiKey: "YOUR_API_KEY", analyticsConfig: AnalyticsConfig(autocapture: [.sessions, .appLifecycles, .screenViews]))`,
+                `Never hardcode the API key in source files — store it in a .xcconfig file or Info.plist and read it at runtime`,
+            ];
+        },
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 8,
+        getOutroChanges: (context) => {
+            const pmLabel = context.packageManager === 'cocoapods'
+                ? 'CocoaPods'
+                : 'Swift Package Manager';
+            return [
+                `Analyzed your Swift project structure`,
+                `Added the AmplitudeUnified package via ${pmLabel}`,
+                `Configured Amplitude with autocapture for sessions, app lifecycles, and screen views`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Build and run your app in the simulator to verify the integration',
+            'Visit your Amplitude dashboard to see incoming events',
+            'Use amplitude.track(eventType:eventProperties:) for custom events',
+            'Use amplitude.setUserId(userId:) to associate events with users',
+        ],
+    },
+};

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

@@ -0,0 +1,12 @@
+import type { WizardOptions } from '../../utils/types';
+export type SwiftPackageManager = 'spm' | 'cocoapods';
+/**
+ * Returns the package manager used by the Swift project.
+ * CocoaPods takes priority when a Podfile is present.
+ */
+export declare function detectSwiftPackageManager(options: Pick<WizardOptions, 'installDir'>): SwiftPackageManager;
+/**
+ * Returns true when the directory contains an iOS/macOS Swift project.
+ * Signals: *.xcodeproj directory, Podfile, or Package.swift + .swift sources.
+ */
+export declare function detectSwiftProject(options: Pick<WizardOptions, 'installDir'>): Promise<boolean>;

package/dist/src/frameworks/swift/utils.js

@@ -0,0 +1,82 @@
+"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.detectSwiftPackageManager = detectSwiftPackageManager;
+exports.detectSwiftProject = detectSwiftProject;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+/**
+ * Returns the package manager used by the Swift project.
+ * CocoaPods takes priority when a Podfile is present.
+ */
+function detectSwiftPackageManager(options) {
+    if (fs.existsSync(path.join(options.installDir, 'Podfile'))) {
+        return 'cocoapods';
+    }
+    return 'spm';
+}
+/**
+ * Returns true when the directory contains an iOS/macOS Swift project.
+ * Signals: *.xcodeproj directory, Podfile, or Package.swift + .swift sources.
+ */
+async function detectSwiftProject(options) {
+    const { installDir } = options;
+    // Xcode project or workspace
+    const xcodeProjects = await (0, fast_glob_1.default)(['*.xcodeproj', '*.xcworkspace'], {
+        cwd: installDir,
+        onlyDirectories: true,
+        deep: 1,
+    });
+    if (xcodeProjects.length > 0) {
+        return true;
+    }
+    // CocoaPods Podfile
+    if (fs.existsSync(path.join(installDir, 'Podfile'))) {
+        return true;
+    }
+    // Package.swift with at least one .swift source file
+    if (fs.existsSync(path.join(installDir, 'Package.swift'))) {
+        const swiftFiles = await (0, fast_glob_1.default)('Sources/**/*.swift', {
+            cwd: installDir,
+            ignore: ['**/.build/**'],
+        });
+        return swiftFiles.length > 0;
+    }
+    return false;
+}

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

@@ -0,0 +1,6 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+type UnityContext = {
+    pluginAlreadyPresent?: boolean;
+};
+export declare const UNITY_AGENT_CONFIG: FrameworkConfig<UnityContext>;
+export {};

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

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNITY_AGENT_CONFIG = void 0;
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const utils_1 = require("./utils");
+exports.UNITY_AGENT_CONFIG = {
+    metadata: {
+        name: 'Unity',
+        integration: constants_1.Integration.unity,
+        beta: true,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/unity/unity-sdk',
+        preRunNotice: 'Close the Unity Editor before running the wizard to avoid file conflicts.',
+        gatherContext: (options) => {
+            const pluginAlreadyPresent = (0, utils_1.isAmplitudePluginPresent)(options);
+            return Promise.resolve({ pluginAlreadyPresent });
+        },
+    },
+    detection: {
+        packageName: 'com.amplitude.unity-plugin',
+        packageDisplayName: 'Unity',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detect: utils_1.detectUnityProject,
+        detectPackageManager: package_manager_detection_1.unityPackageManager,
+    },
+    environment: {
+        // Unity C# doesn't read from .env files — API key is stored in a
+        // ScriptableObject, Resources asset, or directly in initialization code
+        uploadToHosting: false,
+        getEnvVars: () => ({}),
+    },
+    analytics: {
+        getTags: (context) => ({
+            pluginAlreadyPresent: context.pluginAlreadyPresent ? 'true' : 'false',
+        }),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a Unity project. Look for ProjectSettings/ProjectVersion.txt to confirm.',
+        packageInstallation: 'Install via Unity Package Manager by editing Packages/manifest.json: add "com.amplitude.unity-plugin": "https://github.com/amplitude/unity-plugin.git?path=/Assets" to the dependencies object. Do not use npm or any other package manager.',
+        getAdditionalContextLines: (context) => {
+            const lines = [
+                `Framework docs ID: unity (use amplitude://docs/frameworks/unity for documentation)`,
+                `SDK: amplitude/unity-plugin — install via UPM git URL in Packages/manifest.json`,
+                `Initialization (C#):`,
+                `  Amplitude amplitude = Amplitude.getInstance();`,
+                `  amplitude.setServerUrl("https://api2.amplitude.com");`,
+                `  amplitude.trackSessionEvents(true);`,
+                `  amplitude.init("YOUR_API_KEY");`,
+                `Event tracking: amplitude.logEvent("Button Clicked", new Dictionary<string, object> {{ "key", "value" }});`,
+                `EU data residency (SDK 2.4.0+): amplitude.setServerZone(AmplitudeServerZone.EU);`,
+                `Store the API key in a Unity ScriptableObject or Resources asset — never hardcode it in a file committed to source control`,
+                `NOT supported: WebGL, Unity Editor-only builds`,
+            ];
+            if (context.pluginAlreadyPresent) {
+                lines.unshift('Amplitude plugin is already present — skip installation, proceed to initialization.');
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 8,
+        getOutroChanges: (context) => [
+            context.pluginAlreadyPresent
+                ? 'Amplitude plugin was already present — skipped installation'
+                : 'Added amplitude/unity-plugin to Packages/manifest.json via UPM',
+            'Configured Amplitude initialization in a C# script',
+            'Added event tracking calls',
+        ],
+        getOutroNextSteps: () => [
+            'Open the Unity Editor — it will automatically resolve and download the package',
+            'Attach the Amplitude initialization script to a persistent GameObject (e.g. GameManager)',
+            'Visit your Amplitude dashboard to see incoming events',
+            'Use amplitude.logEvent("Event Name") for custom events',
+            'Note: WebGL builds are not supported',
+        ],
+    },
+};

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

@@ -0,0 +1,12 @@
+import type { WizardOptions } from '../../utils/types';
+/**
+ * Returns true when the directory contains a Unity project.
+ * Primary signal: ProjectSettings/ProjectVersion.txt — Unity-specific,
+ * present in every Unity project since 2017+.
+ */
+export declare function detectUnityProject(options: Pick<WizardOptions, 'installDir'>): Promise<boolean>;
+/**
+ * Returns true if the Amplitude Unity plugin is already present,
+ * either via UPM (Packages/manifest.json) or manual import (Assets/).
+ */
+export declare function isAmplitudePluginPresent(options: Pick<WizardOptions, 'installDir'>): boolean;