wip build executor 5

tools/build-env/executors.json

@@ -5,15 +5,20 @@
       "schema": "./src/executors/setup-env/schema.json",
       "description": "Generate and install test environments in your workspace. Cached and ready for use."
     },
-    "build": {
-      "implementation": "./src/executors/build/executor",
-      "schema": "./src/executors/build/schema.json",
-      "description": "Generate test environments in your workspace. Cached and ready for use."
+    "bootstrap": {
+      "implementation": "./src/executors/bootstrap/executor",
+      "schema": "./src/executors/bootstrap/schema.json",
+      "description": "Bootstraps a test environments in your workspace. Cached and ready for use."
     },
     "kill-process": {
       "implementation": "./src/executors/kill-process/executor",
       "schema": "./src/executors/kill-process/schema.json",
-      "description": "´Kills process by PID, command or file path."
+      "description": "Kills process by PID, command or file path."
+    },
+    "npm-install": {
+      "implementation": "./src/executors/npm-install/executor",
+      "schema": "./src/executors/npm-install/schema.json",
+      "description": "Installs npm packages in your workspace."
     }
   }
 }

tools/build-env/src/executors/build/executor.ts → tools/build-env/src/executors/bootstrap/executor.ts

@@ -1,23 +1,23 @@
 import { type ExecutorContext, logger } from '@nx/devkit';
-import type { BuildExecutorOptions } from './schema';
-import { setupNpmEnv } from '../../internal/verdaccio/verdaccio-npm-env';
+import type { BootstrapExecutorOptions } from './schema';
+import { bootstrapEnvironment } from '../../internal/verdaccio/verdaccio-npm-env';
 import { join } from 'node:path';
-import * as process from 'process';
+import { DEFAULT_ENVIRONMENTS_OUTPUT_DIR } from '../../internal/constants';
 
-export type ExecutorOutput = {
+export type BootstrapExecutorOutput = {
   success: boolean;
   command?: string;
   error?: Error;
 };
 
-export default async function runBuildExecutor(
-  terminalAndExecutorOptions: BuildExecutorOptions,
+export default async function runBootstrapExecutor(
+  terminalAndExecutorOptions: BootstrapExecutorOptions,
   context: ExecutorContext
 ) {
   const { projectName } = context;
   const normalizedOptions = {
     ...terminalAndExecutorOptions,
-    workspaceRoot: join('tmp', 'environments', projectName),
+    environmentRoot: join(DEFAULT_ENVIRONMENTS_OUTPUT_DIR, projectName),
   };
   logger.info(
     `Execute @org/build-env:build with options: ${JSON.stringify(
@@ -29,7 +29,7 @@ export default async function runBuildExecutor(
 
   let envResult;
   try {
-    envResult = await setupNpmEnv({
+    envResult = await bootstrapEnvironment({
       ...normalizedOptions,
       projectName,
       readyWhen: 'Environment ready under',
@@ -46,5 +46,5 @@ export default async function runBuildExecutor(
   return Promise.resolve({
     success: true,
     command: JSON.stringify(envResult, null, 2),
-  } satisfies ExecutorOutput);
+  } satisfies BootstrapExecutorOutput);
 }

tools/build-env/src/executors/bootstrap/schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "BootstrapExecutorOptions",
+  "title": "Environment bootstrap executor options",
+  "type": "object",
+  "properties": {
+    "workspaceRoot": {
+      "type": "string",
+      "description": "The root directory of the environment"
+    },
+    "dryRun": {
+      "type": "boolean",
+      "description": "Print the commands that would be run, but don't actually run them"
+    },
+    "verbose": {
+      "type": "boolean",
+      "description": "Print additional logs"
+    }
+  },
+  "additionalProperties": true
+}

tools/build-env/src/executors/build/schema.ts → tools/build-env/src/executors/bootstrap/schema.ts

@@ -1,6 +1,5 @@
-export type BuildExecutorOptions = Partial<{
+export type BootstrapExecutorOptions = Partial<{
   workspaceRoot: string;
   dryRun: boolean;
-  progress: boolean;
   verbose: boolean;
 }>;

tools/build-env/src/executors/kill-process/executor.ts

@@ -3,7 +3,6 @@ import { type ExecutorContext, logger } from '@nx/devkit';
 import type { KillProcessExecutorOptions } from './schema';
 import { join } from 'node:path';
 import { killProcessFromPid } from '../../internal/utils/process';
-import * as process from 'process';
 
 export type ExecutorOutput = {
   success: boolean;