@sentry/wizard 3.25.1 → 3.26.0

package/src/nextjs/templates.ts

@@ -7,6 +7,7 @@ type WithSentryConfigOptions = {
   selfHosted: boolean;
   sentryUrl: string;
   tunnelRoute: boolean;
+  reactComponentAnnotation: boolean;
 };
 
 export function getWithSentryConfigOptionsTemplate({
@@ -14,6 +15,7 @@ export function getWithSentryConfigOptionsTemplate({
   projectSlug,
   selfHosted,
   tunnelRoute,
+  reactComponentAnnotation,
   sentryUrl,
 }: WithSentryConfigOptions): string {
   return `{
@@ -32,7 +34,15 @@ export function getWithSentryConfigOptionsTemplate({
     // https://docs.sentry.io/platforms/javascript/guides/nextjs/manual-setup/
 
     // Upload a larger set of source maps for prettier stack traces (increases build time)
-    widenClientFileUpload: true,
+    widenClientFileUpload: true,${
+      reactComponentAnnotation
+        ? `\n
+    // Automatically annotate React components to show their full name in breadcrumbs and session replay
+    reactComponentAnnotation: {
+      enabled: true,
+    },`
+        : ''
+    }
 
     // ${
       tunnelRoute ? 'Route' : 'Uncomment to route'
@@ -125,7 +135,6 @@ export function getSentryConfigContents(
   let additionalOptions = '';
   if (config === 'client') {
     additionalOptions = `
-
   replaysOnErrorSampleRate: 1.0,
 
   // This sets the sample rate to be 10%. You may want this to be 100% while
@@ -261,7 +270,7 @@ export default function Page() {
 `;
 }
 
-export function getSentryExampleApiRoute() {
+export function getSentryExamplePagesDirApiRoute() {
   return `// A faulty API route to test Sentry's error monitoring
 export default function handler(_req, res) {
   throw new Error("Sentry Example API Route Error");
@@ -307,16 +316,19 @@ export default CustomErrorComponent;
 export function getSimpleUnderscoreErrorCopyPasteSnippet() {
   return `
 ${chalk.green(`import * as Sentry from '@sentry/nextjs';`)}
+${chalk.green(`import Error from "next/error";`)}
 
 ${chalk.dim(
   '// Replace "YourCustomErrorComponent" with your custom error component!',
 )}
 YourCustomErrorComponent.getInitialProps = async (${chalk.green(
-    `contextData`,
+    'contextData',
   )}) => {
   ${chalk.green('await Sentry.captureUnderscoreErrorException(contextData);')}
 
   ${chalk.dim('// ...other getInitialProps code')}
+
+  return Error.getInitialProps(contextData);
 };
 `;
 }
@@ -326,6 +338,7 @@ export function getFullUnderscoreErrorCopyPasteSnippet(isTs: boolean) {
 import * as Sentry from '@sentry/nextjs';${
     isTs ? '\nimport type { NextPageContext } from "next";' : ''
   }
+import Error from "next/error";
 
 ${chalk.dim(
   '// Replace "YourCustomErrorComponent" with your custom error component!',
@@ -334,6 +347,8 @@ YourCustomErrorComponent.getInitialProps = async (contextData${
     isTs ? ': NextPageContext' : ''
   }) => {
   await Sentry.captureUnderscoreErrorException(contextData);
+
+  return Error.getInitialProps(contextData);
 };
 `;
 }

package/src/run.ts

@@ -0,0 +1,142 @@
+// @ts-ignore - clack is ESM and TS complains about that. It works though
+import * as clack from '@clack/prompts';
+import { abortIfCancelled } from './utils/clack-utils';
+import { runReactNativeWizard } from './react-native/react-native-wizard';
+
+import { run as legacyRun } from '../lib/Setup';
+import { WizardOptions } from './utils/types';
+import { runAndroidWizard } from './android/android-wizard';
+import { runAppleWizard } from './apple/apple-wizard';
+import { runNextjsWizard } from './nextjs/nextjs-wizard';
+import { runRemixWizard } from './remix/remix-wizard';
+import { runSvelteKitWizard } from './sveltekit/sveltekit-wizard';
+import { runSourcemapsWizard } from './sourcemaps/sourcemaps-wizard';
+import { readEnvironment } from '../lib/Helper/Env';
+import { Platform } from '../lib/Constants';
+import { PackageDotJson } from './utils/package-json';
+
+type WizardIntegration =
+  | 'reactNative'
+  | 'ios'
+  | 'android'
+  | 'cordova'
+  | 'electron'
+  | 'nextjs'
+  | 'remix'
+  | 'sveltekit'
+  | 'sourcemaps';
+
+type Args = {
+  integration?: WizardIntegration;
+
+  uninstall: boolean;
+  signup: boolean;
+  skipConnect: boolean;
+  debug: boolean;
+  quiet: boolean;
+  disableTelemetry: boolean;
+  promoCode?: string;
+
+  url?: string;
+  platform?: Platform[];
+};
+
+export async function run(argv: Args) {
+  const finalArgs = {
+    ...argv,
+    ...readEnvironment(),
+  };
+
+  let integration = finalArgs.integration;
+  if (!integration) {
+    clack.intro(`Sentry Wizard ${tryGetWizardVersion()}`);
+
+    integration = await abortIfCancelled(
+      clack.select({
+        message: 'What do you want to set up?',
+        options: [
+          { value: 'reactNative', label: 'React Native' },
+          { value: 'ios', label: 'iOS' },
+          { value: 'android', label: 'Android' },
+          { value: 'cordova', label: 'Cordova' },
+          { value: 'electron', label: 'Electron' },
+          { value: 'nextjs', label: 'NextJS' },
+          { value: 'remix', label: 'Remix' },
+          { value: 'sveltekit', label: 'SvelteKit' },
+          { value: 'sourcemaps', label: 'Configure Source Maps Upload' },
+        ],
+      }),
+    );
+
+    if (!integration) {
+      clack.log.error('No integration selected. Exiting.');
+      return;
+    }
+
+    clack.outro(`Starting ${integration} setup`);
+  }
+
+  const wizardOptions: WizardOptions = {
+    telemetryEnabled: !argv.disableTelemetry,
+    promoCode: argv.promoCode,
+    url: argv.url,
+  };
+
+  switch (integration) {
+    case 'reactNative':
+      await runReactNativeWizard({
+        ...wizardOptions,
+        uninstall: argv.uninstall,
+      });
+      break;
+
+    case 'ios':
+      await runAppleWizard(wizardOptions);
+      break;
+
+    case 'android':
+      await runAndroidWizard(wizardOptions);
+      break;
+
+    case 'nextjs':
+      await runNextjsWizard(wizardOptions);
+      break;
+
+    case 'remix':
+      await runRemixWizard(wizardOptions);
+      break;
+
+    case 'sveltekit':
+      await runSvelteKitWizard(wizardOptions);
+      break;
+
+    case 'sourcemaps':
+      await runSourcemapsWizard(wizardOptions);
+      break;
+
+    case 'cordova':
+      argv.integration = 'cordova';
+      void legacyRun(argv);
+      break;
+
+    case 'electron':
+      argv.integration = 'electron';
+      void legacyRun(argv);
+      break;
+
+    default:
+      clack.log.error(`No setup wizard selected!`);
+  }
+}
+
+/**
+ * TODO: replace with rollup replace whenever we switch to rollup
+ */
+function tryGetWizardVersion(): string {
+  try {
+    const wizardPkgJson = require('../package.json') as PackageDotJson;
+    return wizardPkgJson.version ?? '';
+  } catch {
+    return '';
+  }
+}

package/src/telemetry.ts

@@ -8,6 +8,7 @@ import {
   runWithAsyncContext,
   setTag,
   startSpan,
+  flush,
 } from '@sentry/node';
 import packageJson from '../package.json';
 
@@ -49,7 +50,12 @@ export async function withTelemetry<F>(
     throw e;
   } finally {
     sentryHub.endSession();
-    await sentryClient.flush(3000);
+    await sentryClient.flush(3000).then(null, () => {
+      // If telemetry flushing fails we generally don't care
+    });
+    await flush(3000).then(null, () => {
+      // If telemetry flushing fails we generally don't care
+    });
   }
 }
 

package/src/utils/clack-utils.ts

@@ -15,7 +15,6 @@ import { traceStep } from '../telemetry';
 import {
   detectPackageManger,
   PackageManager,
-  installPackageWithPackageManager,
   packageManagers,
 } from './package-manager';
 import { debug } from './debug';
@@ -23,6 +22,9 @@ import { fulfillsVersionRange } from './semver';
 
 const opn = require('opn') as (
   url: string,
+  options?: {
+    wait?: boolean;
+  },
 ) => Promise<childProcess.ChildProcess>;
 
 export const SENTRY_DOT_ENV_FILE = '.env.sentry-build-plugin';
@@ -383,7 +385,31 @@ export async function installPackage({
     );
 
     try {
-      await installPackageWithPackageManager(packageManager, packageName);
+      await new Promise<void>((resolve, reject) => {
+        childProcess.exec(
+          `${packageManager.installCommand} ${packageName} ${packageManager.flags}`,
+          (err, stdout, stderr) => {
+            if (err) {
+              // Write a log file so we can better troubleshoot issues
+              fs.writeFileSync(
+                path.join(
+                  process.cwd(),
+                  `sentry-wizard-installation-error-${Date.now()}.log`,
+                ),
+                JSON.stringify({
+                  stdout,
+                  stderr,
+                }),
+                { encoding: 'utf8' },
+              );
+
+              reject(err);
+            } else {
+              resolve();
+            }
+          },
+        );
+      });
     } catch (e) {
       sdkInstallSpinner.stop('Installation failed.');
       clack.log.error(
@@ -391,7 +417,7 @@ export async function installPackage({
           'Encountered the following error during installation:',
           // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
         )}\n\n${e}\n\n${chalk.dim(
-          'If you think this issue is caused by the Sentry wizard, let us know here:\nhttps://github.com/getsentry/sentry-wizard/issues',
+          "The wizard has created a `sentry-wizard-installation-error-*.log` file. If you think this issue is caused by the Sentry wizard, create an issue on GitHub and include the log file's content:\nhttps://github.com/getsentry/sentry-wizard/issues",
         )}`,
       );
       await abort();
@@ -614,10 +640,21 @@ SENTRY_AUTH_TOKEN=${authToken}
 }
 
 async function addCliConfigFileToGitIgnore(filename: string): Promise<void> {
-  //TODO: Add a check to see if the file is already ignored in .gitignore
+  const gitignorePath = path.join(process.cwd(), '.gitignore');
+
   try {
+    const gitignoreContent = await fs.promises.readFile(gitignorePath, 'utf8');
+    if (gitignoreContent.split(/\r?\n/).includes(filename)) {
+      clack.log.info(
+        `${chalk.bold('.gitignore')} already has ${chalk.bold(
+          filename,
+        )}. Will not add it again.`,
+      );
+      return;
+    }
+
     await fs.promises.appendFile(
-      path.join(process.cwd(), '.gitignore'),
+      gitignorePath,
       `\n# Sentry Config File\n${filename}\n`,
       { encoding: 'utf8' },
     );
@@ -875,7 +912,7 @@ async function askForSelfHosted(urlFromArgs?: string): Promise<{
       }
     } catch {
       clack.log.error(
-        'Please enter a valid URL. (It should look something like "https://sentry.mydomain.com/")',
+        `Please enter a valid URL. (It should look something like "https://sentry.mydomain.com/", got ${url})`,
       );
     }
   }
@@ -958,7 +995,7 @@ async function askForWizardLogin(options: {
     )}\n\n${chalk.cyan(urlToOpen)}`,
   );
 
-  opn(urlToOpen).catch(() => {
+  opn(urlToOpen, { wait: false }).catch(() => {
     // opn throws in environments that don't have a browser (e.g. remote shells) so we just noop here
   });
 

package/src/utils/package-json.ts

@@ -1,4 +1,5 @@
 export type PackageDotJson = {
+  version?: string;
   scripts?: Record<string, string | undefined>;
   dependencies?: Record<string, string>;
   devDependencies?: Record<string, string>;

package/src/utils/package-manager.ts

@@ -1,8 +1,6 @@
 /* eslint-disable @typescript-eslint/typedef */
-import { exec } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
-import { promisify } from 'util';
 
 import * as Sentry from '@sentry/node';
 import { traceStep } from '../telemetry';
@@ -15,6 +13,7 @@ export interface PackageManager {
   buildCommand: string;
   /* The command that the package manager uses to run a script from package.json */
   runScriptCommand: string;
+  flags: string;
 }
 
 export const BUN: PackageManager = {
@@ -24,6 +23,7 @@ export const BUN: PackageManager = {
   installCommand: 'bun add',
   buildCommand: 'bun run build',
   runScriptCommand: 'bun run',
+  flags: '',
 };
 export const YARN: PackageManager = {
   name: 'yarn',
@@ -32,6 +32,7 @@ export const YARN: PackageManager = {
   installCommand: 'yarn add',
   buildCommand: 'yarn build',
   runScriptCommand: 'yarn',
+  flags: '--ignore-workspace-root-check',
 };
 export const PNPM: PackageManager = {
   name: 'pnpm',
@@ -40,6 +41,7 @@ export const PNPM: PackageManager = {
   installCommand: 'pnpm add',
   buildCommand: 'pnpm build',
   runScriptCommand: 'pnpm',
+  flags: '--ignore-workspace-root-check',
 };
 export const NPM: PackageManager = {
   name: 'npm',
@@ -48,6 +50,7 @@ export const NPM: PackageManager = {
   installCommand: 'npm add',
   buildCommand: 'npm run build',
   runScriptCommand: 'npm run',
+  flags: '',
 };
 
 export const packageManagers = [BUN, YARN, PNPM, NPM];
@@ -64,10 +67,3 @@ export function detectPackageManger(): PackageManager | null {
     return null;
   });
 }
-
-export async function installPackageWithPackageManager(
-  packageManager: PackageManager,
-  packageName: string,
-): Promise<void> {
-  await promisify(exec)(`${packageManager.installCommand} ${packageName}`);
-}

package/test/nextjs/templates.test.ts

@@ -9,6 +9,7 @@ describe('NextJS code templates', () => {
         selfHosted: false,
         sentryUrl: 'https://dont-use-this-url.com',
         tunnelRoute: true,
+        reactComponentAnnotation: false,
       });
 
       expect(template).toMatchInlineSnapshot(`
@@ -56,6 +57,7 @@ describe('NextJS code templates', () => {
         selfHosted: true,
         sentryUrl: 'https://my-sentry.com',
         tunnelRoute: true,
+        reactComponentAnnotation: false,
       });
 
       expect(template).toMatchInlineSnapshot(`
@@ -104,6 +106,7 @@ describe('NextJS code templates', () => {
         selfHosted: false,
         sentryUrl: 'https://dont-use-this-url.com',
         tunnelRoute: false,
+        reactComponentAnnotation: false,
       });
 
       expect(template).toMatchInlineSnapshot(`
@@ -143,5 +146,58 @@ describe('NextJS code templates', () => {
           }"
       `);
     });
+
+    it('adds `reactComponentAnnotations` option if `reactComponentAnnotations` is enabled', () => {
+      const template = getWithSentryConfigOptionsTemplate({
+        orgSlug: 'my-org',
+        projectSlug: 'my-project',
+        selfHosted: false,
+        sentryUrl: 'https://dont-use-this-url.com',
+        tunnelRoute: true,
+        reactComponentAnnotation: true,
+      });
+
+      expect(template).toMatchInlineSnapshot(`
+        "{
+            // For all available options, see:
+            // https://github.com/getsentry/sentry-webpack-plugin#options
+
+            org: "my-org",
+            project: "my-project",
+
+            // Only print logs for uploading source maps in CI
+            silent: !process.env.CI,
+
+            // For all available options, see:
+            // https://docs.sentry.io/platforms/javascript/guides/nextjs/manual-setup/
+
+            // Upload a larger set of source maps for prettier stack traces (increases build time)
+            widenClientFileUpload: true,
+
+            // Automatically annotate React components to show their full name in breadcrumbs and session replay
+            reactComponentAnnotation: {
+              enabled: true,
+            },
+
+            // Route browser requests to Sentry through a Next.js rewrite to circumvent ad-blockers.
+            // This can increase your server load as well as your hosting bill.
+            // Note: Check that the configured route will not match with your Next.js middleware, otherwise reporting of client-
+            // side errors will fail.
+            tunnelRoute: "/monitoring",
+
+            // Hides source maps from generated client bundles
+            hideSourceMaps: true,
+
+            // Automatically tree-shake Sentry logger statements to reduce bundle size
+            disableLogger: true,
+
+            // Enables automatic instrumentation of Vercel Cron Monitors. (Does not yet work with App Router route handlers.)
+            // See the following for more information:
+            // https://docs.sentry.io/product/crons/
+            // https://vercel.com/docs/cron-jobs
+            automaticVercelMonitors: true,
+          }"
+            `);
+    });
   });
 });

package/dist/lib/Steps/Integrations/Android.d.ts

@@ -1,9 +0,0 @@
-import { Answers } from 'inquirer';
-import { BaseIntegration } from './BaseIntegration';
-import { Args } from '../../Constants';
-export declare class Android extends BaseIntegration {
-    protected _argv: Args;
-    constructor(_argv: Args);
-    emit(_answers: Answers): Promise<Answers>;
-    shouldConfigure(_answers: Answers): Promise<Answers>;
-}

package/dist/lib/Steps/Integrations/Android.js

@@ -1,86 +0,0 @@
-"use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Android = void 0;
-var BaseIntegration_1 = require("./BaseIntegration");
-var android_wizard_1 = require("../../../src/android/android-wizard");
-var Android = /** @class */ (function (_super) {
-    __extends(Android, _super);
-    function Android(_argv) {
-        var _this = _super.call(this, _argv) || this;
-        _this._argv = _argv;
-        return _this;
-    }
-    Android.prototype.emit = function (_answers) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, (0, android_wizard_1.runAndroidWizard)({
-                            promoCode: this._argv.promoCode,
-                            url: this._argv.url,
-                            telemetryEnabled: !this._argv.disableTelemetry,
-                        })];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, {}];
-                }
-            });
-        });
-    };
-    Android.prototype.shouldConfigure = function (_answers) {
-        return this._shouldConfigure;
-    };
-    return Android;
-}(BaseIntegration_1.BaseIntegration));
-exports.Android = Android;
-//# sourceMappingURL=Android.js.map

package/dist/lib/Steps/Integrations/Android.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Android.js","sourceRoot":"","sources":["../../../../lib/Steps/Integrations/Android.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,qDAAoD;AAEpD,sEAAuE;AAEvE;IAA6B,2BAAe;IAC1C,iBAA6B,KAAW;QAAxC,YACE,kBAAM,KAAK,CAAC,SACb;QAF4B,WAAK,GAAL,KAAK,CAAM;;IAExC,CAAC;IAEY,sBAAI,GAAjB,UAAkB,QAAiB;;;;4BACjC,qBAAM,IAAA,iCAAgB,EAAC;4BACrB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS;4BAC/B,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;4BACnB,gBAAgB,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB;yBAC/C,CAAC,EAAA;;wBAJF,SAIE,CAAC;wBACH,sBAAO,EAAE,EAAC;;;;KACX;IAEM,iCAAe,GAAtB,UAAuB,QAAiB;QACtC,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IACH,cAAC;AAAD,CAAC,AAjBD,CAA6B,iCAAe,GAiB3C;AAjBY,0BAAO","sourcesContent":["import { Answers } from 'inquirer';\nimport { BaseIntegration } from './BaseIntegration';\nimport { Args } from '../../Constants';\nimport { runAndroidWizard } from '../../../src/android/android-wizard';\n\nexport class Android extends BaseIntegration {\n  public constructor(protected _argv: Args) {\n    super(_argv);\n  }\n\n  public async emit(_answers: Answers): Promise<Answers> {\n    await runAndroidWizard({\n      promoCode: this._argv.promoCode,\n      url: this._argv.url,\n      telemetryEnabled: !this._argv.disableTelemetry,\n    });\n    return {};\n  }\n\n  public shouldConfigure(_answers: Answers): Promise<Answers> {\n    return this._shouldConfigure;\n  }\n}\n"]}

package/dist/lib/Steps/Integrations/Apple.d.ts

@@ -1,10 +0,0 @@
-import { Answers } from 'inquirer';
-import type { Args } from '../../Constants';
-import { BaseIntegration } from './BaseIntegration';
-export declare class Apple extends BaseIntegration {
-    protected _argv: Args;
-    argv: Args;
-    constructor(_argv: Args);
-    emit(_answers: Answers): Promise<Answers>;
-    shouldConfigure(_answers: Answers): Promise<Answers>;
-}