add insertion/file creation/fallback flow

src/sourcemaps/tools/tsc.ts

@@ -1,12 +1,21 @@
 import * as fs from 'fs';
+import * as path from 'path';
 
 import * as recast from 'recast';
 
+import * as Sentry from '@sentry/node';
+
+// @ts-ignore - clack is ESM and TS complains about that. It works though
+import * as clack from '@clack/prompts';
+
 import {
+  askForToolConfigPath,
+  createNewConfigFile,
   makeCodeSnippet,
   showCopyPasteInstructions,
 } from '../../utils/clack-utils';
 import {
+  findFile,
   getOrSetObjectProperty,
   parseJsonC,
   printJsonC,
@@ -33,13 +42,43 @@ const getCodeSnippet = (colors: boolean) =>
   );
 
 export async function configureTscSourcemapGenerationFlow(): Promise<void> {
-  await showCopyPasteInstructions(
-    'tsconfig.json',
-    getCodeSnippet(true),
-    'This ensures that source maps are generated correctly',
-  );
+  const tsConfigPath =
+    findFile(path.join(process.cwd(), 'tsconfig'), ['.json']) ??
+    (await askForToolConfigPath('TypeScript', 'tsconfig.json'));
+
+  let successfullyAdded = false;
+  if (tsConfigPath) {
+    successfullyAdded = await enableSourcemaps(tsConfigPath);
+  } else {
+    successfullyAdded = await createNewConfigFile(
+      path.join(process.cwd(), 'tsconfig.json'),
+      getCodeSnippet(false),
+    );
+    Sentry.setTag('created-new-config', successfullyAdded ? 'success' : 'fail');
+  }
+
+  if (successfullyAdded) {
+    Sentry.setTag('ast-mod', 'success');
+    clack.log.info(
+      `We recommend checking the ${
+        tsConfigPath ? 'modified' : 'added'
+      } file after the wizard finished to ensure it works with your build setup.`,
+    );
+  } else {
+    Sentry.setTag('ast-mod', 'fail');
+    await showCopyPasteInstructions(
+      'tsconfig.json',
+      getCodeSnippet(true),
+      'This ensures that source maps are generated correctly',
+    );
+  }
 }
 
+/**
+ * Modifies tsconfig.json (@param tsConfigPath) to enable source maps generation.
+ *
+ * Exported only for testing
+ */
 export async function enableSourcemaps(tsConfigPath: string): Promise<boolean> {
   try {
     const tsConfig = await fs.promises.readFile(tsConfigPath, 'utf-8');
@@ -48,6 +87,7 @@ export async function enableSourcemaps(tsConfigPath: string): Promise<boolean> {
 
     if (!jsonObject || !ast) {
       // this will only happen if the input file isn't valid JSON-C
+      Sentry.setTag('ast-mod-fail-reason', 'original-file-invalid');
       return false;
     }
 
@@ -61,6 +101,7 @@ export async function enableSourcemaps(tsConfigPath: string): Promise<boolean> {
 
     if (!compilerOptionsObj || compilerOptionsObj.type !== 'ObjectExpression') {
       // a valid compilerOptions prop should always be an object expression
+      Sentry.setTag('ast-mod-fail-reason', 'original-file-invalid');
       return false;
     }
 
@@ -89,6 +130,7 @@ export async function enableSourcemaps(tsConfigPath: string): Promise<boolean> {
     return true;
   } catch (e) {
     debug(e);
+    Sentry.setTag('ast-mod-fail-reason', 'insertion-fail');
     return false;
   }
 }

src/utils/clack-utils.ts

@@ -826,7 +826,7 @@ export async function askForToolConfigPath(
     clack.confirm({
       message: `Do you have a ${toolName} config file (e.g. ${chalk.cyan(
         configFileName,
-      )}?`,
+      )})?`,
       initialValue: true,
     }),
   );