Merge branch 'master' into concurrently-prefix

Author: 72636c

docs/cli/run.md

@@ -10,6 +10,10 @@ nav_order: 3
 **skuba** lets you interactively run your TypeScript source code during development.
 The following commands are powered by [`ts-node`] and [`ts-node-dev`].
 
+These commands are only intended to serve local development and simple scripting scenarios,
+as a TypeScript process can present substantial overhead at runtime.
+In production, we recommend [`skuba build`]ing your project and executing under a regular Node.js runtime.
+
 ---
 
 ## skuba node
@@ -125,6 +129,7 @@ const app = express();
 export default Object.assign(app, { port });
 ```
 
+[`skuba build`]: ./build.md
 [`skuba-dive/register`]: https://github.com/seek-oss/skuba-dive#register
 [`ts-node-dev`]: https://github.com/whitecolor/ts-node-dev
 [`ts-node`]: https://github.com/typestrong/ts-node

src/cli/configure/index.ts

@@ -118,7 +118,8 @@ export const configure = async () => {
       log.plain(log.bold('yarn format'));
 
       log.newline();
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     try {
       await exec('npx', 'yarn-deduplicate', '--strategy=highest');

src/cli/init/index.ts

@@ -112,7 +112,8 @@ export const init = async () => {
     log.ok('git push --set-upstream origin master');
 
     log.newline();
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
 
   log.newline();

src/skuba.ts

@@ -34,7 +34,8 @@ const skuba = async () => {
 
     if (!hasProp(commandModule, moduleName)) {
       log.err(log.bold(commandName), "couldn't run! Please submit an issue.");
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
 
     const run = commandModule[moduleName] as () => Promise<unknown>;
@@ -46,7 +47,7 @@ const skuba = async () => {
   await showLogoAndVersionInfo();
   showHelp();
 
-  process.exit(1);
+  process.exitCode = 1;
 };
 
 skuba().catch(handleCliError);

src/utils/error.ts

@@ -24,11 +24,13 @@ const isExecaError = (err: unknown): err is ExecaError =>
 
 export const handleCliError = (err: unknown) => {
   if (isExecaError(err)) {
-    process.exit(err.exitCode);
+    process.exitCode = err.exitCode;
+    return;
   }
 
   log.err(err);
-  process.exit(1);
+  process.exitCode = 1;
+  return;
 };
 
 export const isErrorWithCode = <T>(