@teambit/builder 0.0.636 → 0.0.640

package/{__preview-1643426469482.js → __preview-1643858579620.js}

@@ -1 +1 @@
-export const overview = [require('/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.pipelines_builder@0.0.636/dist/builder.docs.mdx')]
+export const overview = [require('/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.pipelines_builder@0.0.640/dist/builder.docs.mdx')]

package/dist/build-pipe.js

@@ -175,7 +175,7 @@ class BuildPipe {
         const {
           aspectId,
           name
-        } = _buildTask().BuildTaskHelper.deserializeId(dependency);
+        } = _buildTask().BuildTaskHelper.deserializeIdAllowEmptyName(dependency);
 
         this.failedDependencyTask = this.failedTasks.find(failedTask => {
           if (name && name !== failedTask.name) return false;

package/dist/build-pipe.js.map

@@ -1 +1 @@
-{"version":3,"sources":["build-pipe.ts"],"names":["BuildPipe","constructor","tasksQueue","envsBuildContext","logger","artifactFactory","previousTaskResults","allTasksResults","taskResults","execute","executePreBuild","longProcessLogger","createLongProcessLogger","length","task","env","executeTask","end","tasksResultsList","TaskResultsList","executePostBuild","setStatusLine","preBuild","getBuildContext","id","consoleSuccess","taskId","BuildTaskHelper","serializeId","taskName","description","logProgress","updateFailedDependencyTask","shouldSkipTask","startTask","process","hrtime","taskStartTime","Date","now","buildContext","buildTaskResult","endTime","compsWithErrors","componentsResults","filter","c","errors","artifacts","consoleFailure","failedTasks","push","duration","defs","generate","startTime","tasksResults","postBuild","failedDependencyTask","dependencies","forEach","dependency","aspectId","name","deserializeId","find","failedTask","envId","failedTaskId","consoleWarning","Error","previousTasksResults","from"],"mappings":"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","sourcesContent":["import { EnvDefinition } from '@teambit/envs';\nimport { ComponentMap } from '@teambit/component';\nimport { Logger, LongProcessLogger } from '@teambit/logger';\nimport mapSeries from 'p-map-series';\nimport prettyTime from 'pretty-time';\nimport { ArtifactFactory, ArtifactList } from './artifact';\nimport { BuildTask, BuildTaskHelper } from './build-task';\nimport { ComponentResult } from './types';\nimport { TasksQueue } from './tasks-queue';\nimport { EnvsBuildContext } from './builder.service';\nimport { TaskResultsList } from './task-results-list';\n\nexport type TaskResults = {\n  /**\n   * task itself. useful for getting its id/description later on.\n   */\n  task: BuildTask;\n\n  /**\n   * environment were the task was running\n   */\n  env: EnvDefinition;\n\n  /**\n   * component build results.\n   */\n  componentsResults: ComponentResult[];\n\n  /**\n   * artifacts generated by the build pipeline.\n   * in case the task finished with errors, this prop is undefined.\n   */\n  artifacts: ComponentMap<ArtifactList> | undefined;\n\n  /**\n   * timestamp of start initiation.\n   */\n  startTime: number;\n\n  /**\n   * timestamp of task completion.\n   */\n  endTime: number;\n};\n\nexport class BuildPipe {\n  private failedTasks: BuildTask[] = [];\n  private failedDependencyTask: BuildTask | undefined;\n  private longProcessLogger: LongProcessLogger;\n  private taskResults: TaskResults[] = [];\n  constructor(\n    /**\n     * array of services to apply on the components.\n     */\n    readonly tasksQueue: TasksQueue,\n    readonly envsBuildContext: EnvsBuildContext,\n    readonly logger: Logger,\n    readonly artifactFactory: ArtifactFactory,\n    private previousTaskResults?: TaskResults[]\n  ) {}\n\n  get allTasksResults(): TaskResults[] {\n    return [...(this.previousTaskResults || []), ...(this.taskResults || [])];\n  }\n\n  /**\n   * execute a pipeline of build tasks.\n   */\n  async execute(): Promise<TaskResultsList> {\n    await this.executePreBuild();\n    this.longProcessLogger = this.logger.createLongProcessLogger('running tasks', this.tasksQueue.length);\n    await mapSeries(this.tasksQueue, async ({ task, env }) => this.executeTask(task, env));\n    this.longProcessLogger.end();\n    const tasksResultsList = new TaskResultsList(this.tasksQueue, this.taskResults);\n    await this.executePostBuild(tasksResultsList);\n\n    return tasksResultsList;\n  }\n\n  private async executePreBuild() {\n    this.logger.setStatusLine('executing pre-build for all tasks');\n    await mapSeries(this.tasksQueue, async ({ task, env }) => {\n      if (!task.preBuild) return;\n      await task.preBuild(this.getBuildContext(env.id));\n    });\n    this.logger.consoleSuccess();\n  }\n\n  private async executeTask(task: BuildTask, env: EnvDefinition): Promise<void> {\n    const taskId = BuildTaskHelper.serializeId(task);\n    const taskName = `${taskId}${task.description ? ` (${task.description})` : ''}`;\n    this.longProcessLogger.logProgress(`env \"${env.id}\", task \"${taskName}\"`);\n    this.updateFailedDependencyTask(task);\n    if (this.shouldSkipTask(taskId, env.id)) {\n      return;\n    }\n    const startTask = process.hrtime();\n    const taskStartTime = Date.now();\n    const buildContext = this.getBuildContext(env.id);\n    const buildTaskResult = await task.execute(buildContext);\n    const endTime = Date.now();\n    const compsWithErrors = buildTaskResult.componentsResults.filter((c) => c.errors?.length);\n    let artifacts;\n    if (compsWithErrors.length) {\n      this.logger.consoleFailure(`env: ${env.id}, task \"${taskId}\" has failed`);\n      this.failedTasks.push(task);\n    } else {\n      const duration = prettyTime(process.hrtime(startTask));\n      this.logger.consoleSuccess(`env \"${env.id}\", task \"${taskName}\" has completed successfully in ${duration}`);\n      const defs = buildTaskResult.artifacts || [];\n      artifacts = this.artifactFactory.generate(buildContext, defs, task);\n    }\n\n    const taskResults: TaskResults = {\n      task,\n      env,\n      componentsResults: buildTaskResult.componentsResults,\n      artifacts,\n      startTime: taskStartTime,\n      endTime,\n    };\n\n    this.taskResults.push(taskResults);\n  }\n\n  private async executePostBuild(tasksResults: TaskResultsList) {\n    this.logger.setStatusLine('executing post-build for all tasks');\n    await mapSeries(this.tasksQueue, async ({ task, env }) => {\n      if (!task.postBuild) return;\n      await task.postBuild(this.getBuildContext(env.id), tasksResults);\n    });\n    this.logger.consoleSuccess();\n  }\n\n  private updateFailedDependencyTask(task: BuildTask) {\n    if (!this.failedDependencyTask && this.failedTasks.length && task.dependencies) {\n      task.dependencies.forEach((dependency) => {\n        const { aspectId, name } = BuildTaskHelper.deserializeId(dependency);\n        this.failedDependencyTask = this.failedTasks.find((failedTask) => {\n          if (name && name !== failedTask.name) return false;\n          return aspectId === failedTask.aspectId;\n        });\n      });\n    }\n  }\n\n  private shouldSkipTask(taskId: string, envId: string): boolean {\n    if (!this.failedDependencyTask) return false;\n    const failedTaskId = BuildTaskHelper.serializeId(this.failedDependencyTask);\n    this.logger.consoleWarning(`env: ${envId}, task \"${taskId}\" has skipped due to \"${failedTaskId}\" failure`);\n    return true;\n  }\n\n  private getBuildContext(envId: string) {\n    const buildContext = this.envsBuildContext[envId];\n    if (!buildContext) throw new Error(`unable to find buildContext for ${envId}`);\n    buildContext.previousTasksResults = this.allTasksResults;\n    return buildContext;\n  }\n\n  /**\n   * create a build pipe from an array of tasks.\n   */\n  static from(\n    tasksQueue: TasksQueue,\n    envsBuildContext: EnvsBuildContext,\n    logger: Logger,\n    artifactFactory: ArtifactFactory,\n    previousTaskResults?: TaskResults[]\n  ) {\n    return new BuildPipe(tasksQueue, envsBuildContext, logger, artifactFactory, previousTaskResults);\n  }\n}\n"]}
+{"version":3,"sources":["build-pipe.ts"],"names":["BuildPipe","constructor","tasksQueue","envsBuildContext","logger","artifactFactory","previousTaskResults","allTasksResults","taskResults","execute","executePreBuild","longProcessLogger","createLongProcessLogger","length","task","env","executeTask","end","tasksResultsList","TaskResultsList","executePostBuild","setStatusLine","preBuild","getBuildContext","id","consoleSuccess","taskId","BuildTaskHelper","serializeId","taskName","description","logProgress","updateFailedDependencyTask","shouldSkipTask","startTask","process","hrtime","taskStartTime","Date","now","buildContext","buildTaskResult","endTime","compsWithErrors","componentsResults","filter","c","errors","artifacts","consoleFailure","failedTasks","push","duration","defs","generate","startTime","tasksResults","postBuild","failedDependencyTask","dependencies","forEach","dependency","aspectId","name","deserializeIdAllowEmptyName","find","failedTask","envId","failedTaskId","consoleWarning","Error","previousTasksResults","from"],"mappings":"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","sourcesContent":["import { EnvDefinition } from '@teambit/envs';\nimport { ComponentMap } from '@teambit/component';\nimport { Logger, LongProcessLogger } from '@teambit/logger';\nimport mapSeries from 'p-map-series';\nimport prettyTime from 'pretty-time';\nimport { ArtifactFactory, ArtifactList } from './artifact';\nimport { BuildTask, BuildTaskHelper } from './build-task';\nimport { ComponentResult } from './types';\nimport { TasksQueue } from './tasks-queue';\nimport { EnvsBuildContext } from './builder.service';\nimport { TaskResultsList } from './task-results-list';\n\nexport type TaskResults = {\n  /**\n   * task itself. useful for getting its id/description later on.\n   */\n  task: BuildTask;\n\n  /**\n   * environment were the task was running\n   */\n  env: EnvDefinition;\n\n  /**\n   * component build results.\n   */\n  componentsResults: ComponentResult[];\n\n  /**\n   * artifacts generated by the build pipeline.\n   * in case the task finished with errors, this prop is undefined.\n   */\n  artifacts: ComponentMap<ArtifactList> | undefined;\n\n  /**\n   * timestamp of start initiation.\n   */\n  startTime: number;\n\n  /**\n   * timestamp of task completion.\n   */\n  endTime: number;\n};\n\nexport class BuildPipe {\n  private failedTasks: BuildTask[] = [];\n  private failedDependencyTask: BuildTask | undefined;\n  private longProcessLogger: LongProcessLogger;\n  private taskResults: TaskResults[] = [];\n  constructor(\n    /**\n     * array of services to apply on the components.\n     */\n    readonly tasksQueue: TasksQueue,\n    readonly envsBuildContext: EnvsBuildContext,\n    readonly logger: Logger,\n    readonly artifactFactory: ArtifactFactory,\n    private previousTaskResults?: TaskResults[]\n  ) {}\n\n  get allTasksResults(): TaskResults[] {\n    return [...(this.previousTaskResults || []), ...(this.taskResults || [])];\n  }\n\n  /**\n   * execute a pipeline of build tasks.\n   */\n  async execute(): Promise<TaskResultsList> {\n    await this.executePreBuild();\n    this.longProcessLogger = this.logger.createLongProcessLogger('running tasks', this.tasksQueue.length);\n    await mapSeries(this.tasksQueue, async ({ task, env }) => this.executeTask(task, env));\n    this.longProcessLogger.end();\n    const tasksResultsList = new TaskResultsList(this.tasksQueue, this.taskResults);\n    await this.executePostBuild(tasksResultsList);\n\n    return tasksResultsList;\n  }\n\n  private async executePreBuild() {\n    this.logger.setStatusLine('executing pre-build for all tasks');\n    await mapSeries(this.tasksQueue, async ({ task, env }) => {\n      if (!task.preBuild) return;\n      await task.preBuild(this.getBuildContext(env.id));\n    });\n    this.logger.consoleSuccess();\n  }\n\n  private async executeTask(task: BuildTask, env: EnvDefinition): Promise<void> {\n    const taskId = BuildTaskHelper.serializeId(task);\n    const taskName = `${taskId}${task.description ? ` (${task.description})` : ''}`;\n    this.longProcessLogger.logProgress(`env \"${env.id}\", task \"${taskName}\"`);\n    this.updateFailedDependencyTask(task);\n    if (this.shouldSkipTask(taskId, env.id)) {\n      return;\n    }\n    const startTask = process.hrtime();\n    const taskStartTime = Date.now();\n    const buildContext = this.getBuildContext(env.id);\n    const buildTaskResult = await task.execute(buildContext);\n    const endTime = Date.now();\n    const compsWithErrors = buildTaskResult.componentsResults.filter((c) => c.errors?.length);\n    let artifacts;\n    if (compsWithErrors.length) {\n      this.logger.consoleFailure(`env: ${env.id}, task \"${taskId}\" has failed`);\n      this.failedTasks.push(task);\n    } else {\n      const duration = prettyTime(process.hrtime(startTask));\n      this.logger.consoleSuccess(`env \"${env.id}\", task \"${taskName}\" has completed successfully in ${duration}`);\n      const defs = buildTaskResult.artifacts || [];\n      artifacts = this.artifactFactory.generate(buildContext, defs, task);\n    }\n\n    const taskResults: TaskResults = {\n      task,\n      env,\n      componentsResults: buildTaskResult.componentsResults,\n      artifacts,\n      startTime: taskStartTime,\n      endTime,\n    };\n\n    this.taskResults.push(taskResults);\n  }\n\n  private async executePostBuild(tasksResults: TaskResultsList) {\n    this.logger.setStatusLine('executing post-build for all tasks');\n    await mapSeries(this.tasksQueue, async ({ task, env }) => {\n      if (!task.postBuild) return;\n      await task.postBuild(this.getBuildContext(env.id), tasksResults);\n    });\n    this.logger.consoleSuccess();\n  }\n\n  private updateFailedDependencyTask(task: BuildTask) {\n    if (!this.failedDependencyTask && this.failedTasks.length && task.dependencies) {\n      task.dependencies.forEach((dependency) => {\n        const { aspectId, name } = BuildTaskHelper.deserializeIdAllowEmptyName(dependency);\n        this.failedDependencyTask = this.failedTasks.find((failedTask) => {\n          if (name && name !== failedTask.name) return false;\n          return aspectId === failedTask.aspectId;\n        });\n      });\n    }\n  }\n\n  private shouldSkipTask(taskId: string, envId: string): boolean {\n    if (!this.failedDependencyTask) return false;\n    const failedTaskId = BuildTaskHelper.serializeId(this.failedDependencyTask);\n    this.logger.consoleWarning(`env: ${envId}, task \"${taskId}\" has skipped due to \"${failedTaskId}\" failure`);\n    return true;\n  }\n\n  private getBuildContext(envId: string) {\n    const buildContext = this.envsBuildContext[envId];\n    if (!buildContext) throw new Error(`unable to find buildContext for ${envId}`);\n    buildContext.previousTasksResults = this.allTasksResults;\n    return buildContext;\n  }\n\n  /**\n   * create a build pipe from an array of tasks.\n   */\n  static from(\n    tasksQueue: TasksQueue,\n    envsBuildContext: EnvsBuildContext,\n    logger: Logger,\n    artifactFactory: ArtifactFactory,\n    previousTaskResults?: TaskResults[]\n  ) {\n    return new BuildPipe(tasksQueue, envsBuildContext, logger, artifactFactory, previousTaskResults);\n  }\n}\n"]}

package/dist/build-pipeline-order.js

@@ -184,10 +184,8 @@ function addDependenciesToGraph(graphs, pipeline, task) {
     const {
       aspectId,
       name
-    } = dependency.includes(_buildTask().TaskIdDelimiter) ? _buildTask().BuildTaskHelper.deserializeId(dependency) : {
-      aspectId: dependency,
-      name: undefined
-    };
+    } = _buildTask().BuildTaskHelper.deserializeIdAllowEmptyName(dependency);
+
     const dependencyTasks = pipeline.filter(pipelineTask => {
       if (pipelineTask.aspectId !== aspectId) return false;
       return name ? name === pipelineTask.name : true;

package/dist/build-pipeline-order.js.map

@@ -1 +1 @@
-{"version":3,"sources":["build-pipeline-order.ts"],"names":["calculatePipelineOrder","taskSlot","envs","pipeNameOnEnv","tasks","skipTests","graphs","locations","forEach","location","push","graph","Graph","pipelineEnvs","envDefinition","pipeline","getPipelineForEnv","env","flattenedPipeline","map","pipelineEnv","flat","task","addDependenciesToGraph","dataPerLocation","pipelineEnvsPerLocation","filter","tasksQueue","TasksQueue","addTasksToGraph","length","includes","name","aspectId","TesterAspect","id","data","find","d","sorted","toposort","taskNode","BuildTaskHelper","deserializeId","attr","taskIndex","findIndex","pipelineTask","splice","dependencies","taskId","serializeId","dependency","TaskIdDelimiter","undefined","dependencyTasks","Error","dependencyTask","getLocation","graphLocation","g","dependencyId","setNode","setEdge","taskLocation","dependencyLocation","isDependencyAhead","isDependencyEqual","buildTasks","slotsTasks","values","tasksAtStart","tasksAtEnd","mergedTasks"],"mappings":"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","sourcesContent":["import { Graph } from 'cleargraph';\nimport TesterAspect from '@teambit/tester';\nimport { EnvDefinition, Environment } from '@teambit/envs';\nimport { BuildTask, BuildTaskHelper, TaskIdDelimiter } from './build-task';\nimport type { TaskSlot } from './builder.main.runtime';\nimport { TasksQueue } from './tasks-queue';\n\ntype TaskDependenciesGraph = Graph<string, string>;\ntype Location = 'start' | 'middle' | 'end';\ntype TasksLocationGraph = { location: Location; graph: TaskDependenciesGraph };\ntype PipelineEnv = { env: EnvDefinition; pipeline: BuildTask[] };\ntype DataPerLocation = { location: Location; graph: TaskDependenciesGraph; pipelineEnvs: PipelineEnv[] };\n\n/**\n * there are two ways how to add tasks to build pipeline.\n * 1. `getBuildPipe()` method of the env.\n * 2. registering to the `builder.registerBuildTask()`.\n *\n * in the option #1, it's possible to determine the order. e.g. `getBuildPipe() { return [taskA, taskB, taskC]; }`\n * in the option #2, the register happens once the extension is loaded, so there is no way to put\n * one task before/after another task.\n *\n * To be able to determine the order, you can do the following\n * 1. \"task.location\", it has two options \"start\" and \"end\". the rest are \"middle\".\n * 2. \"task.dependencies\", the dependencies must be completed for all envs before this task starts.\n * the dependencies are applicable inside a location and not across locations. see getLocation()\n * or/and continue reading for more info about this.\n *\n * to determine the final order of the tasks, the following is done:\n * 1. split all tasks to three groups: start, middle and end.\n * 2. for each group define a dependencies graph for the tasks with \"dependencies\" prop and the pipeline.\n * 3. start with the first group \"start\", toposort the dependencies graph and push the found tasks\n * to a queue. once completed, iterate the pipeline and add all tasks to the queue.\n * 4. do the same for the \"middle\" and \"end\" groups.\n *\n * the reason for splitting the tasks to the three groups and not using the \"dependencies\" field\n * alone to determine the order is that the \"start\" and \"end\" groups are mostly core and \"middle\"\n * is mostly the user entering tasks to the pipeline and we as the core don't know about the users\n * tasks. For example, a core task \"PublishComponent\" must happen after the compiler, however, a\n * user might have an env without a compiler. if we determine the order only by the dependencies\n * field, the \"PublishComponent\" would have a dependency \"compiler\" and because in this case there\n * is no compiler task, it would throw an error about missing dependencies.\n */\nexport function calculatePipelineOrder(\n  taskSlot: TaskSlot,\n  envs: EnvDefinition[],\n  pipeNameOnEnv = 'getBuildPipe',\n  tasks: string[] = [],\n  skipTests = false\n): TasksQueue {\n  const graphs: TasksLocationGraph[] = [];\n  const locations: Location[] = ['start', 'middle', 'end']; // the order is important here!\n  locations.forEach((location) => {\n    graphs.push({ location, graph: new Graph<string, string>() });\n  });\n  const pipelineEnvs: PipelineEnv[] = [];\n  envs.forEach((envDefinition) => {\n    const pipeline = getPipelineForEnv(taskSlot, envDefinition.env, pipeNameOnEnv);\n    pipelineEnvs.push({ env: envDefinition, pipeline });\n  });\n\n  const flattenedPipeline: BuildTask[] = pipelineEnvs.map((pipelineEnv) => pipelineEnv.pipeline).flat();\n  flattenedPipeline.forEach((task) => addDependenciesToGraph(graphs, flattenedPipeline, task));\n\n  const dataPerLocation: DataPerLocation[] = graphs.map(({ location, graph }) => {\n    const pipelineEnvsPerLocation: PipelineEnv[] = pipelineEnvs.map(({ env, pipeline }) => {\n      return { env, pipeline: pipeline.filter((task) => (task.location || 'middle') === location) };\n    });\n    return { location, graph, pipelineEnvs: pipelineEnvsPerLocation };\n  });\n\n  const tasksQueue = new TasksQueue();\n  locations.forEach((location) => addTasksToGraph(tasksQueue, dataPerLocation, location));\n  if (tasks.length) {\n    return new TasksQueue(\n      ...tasksQueue.filter(({ task }) => tasks.includes(task.name) || tasks.includes(task.aspectId))\n    );\n  }\n  if (skipTests) {\n    return new TasksQueue(...tasksQueue.filter(({ task }) => task.aspectId !== TesterAspect.id));\n  }\n  return tasksQueue;\n}\n\nfunction addTasksToGraph(tasksQueue: TasksQueue, dataPerLocation: DataPerLocation[], location: Location) {\n  const data = dataPerLocation.find((d) => d.location === location);\n  if (!data) return;\n  const sorted = data.graph.toposort();\n  sorted.forEach((taskNode) => {\n    const { aspectId, name } = BuildTaskHelper.deserializeId(taskNode.attr);\n    data.pipelineEnvs.forEach(({ env, pipeline }) => {\n      const taskIndex = pipeline.findIndex(\n        (pipelineTask) => pipelineTask.aspectId === aspectId && pipelineTask.name === name\n      );\n      if (taskIndex < 0) return;\n      const task = pipeline[taskIndex];\n      tasksQueue.push({ env, task });\n      pipeline.splice(taskIndex, 1); // delete the task from the pipeline\n    });\n  });\n  data.pipelineEnvs.forEach(({ env, pipeline }) => {\n    pipeline.forEach((task) => tasksQueue.push({ env, task }));\n  });\n}\n\nfunction addDependenciesToGraph(graphs: TasksLocationGraph[], pipeline: BuildTask[], task: BuildTask) {\n  if (!task.dependencies || !task.dependencies.length) return;\n  const taskId = BuildTaskHelper.serializeId(task);\n  task.dependencies.forEach((dependency) => {\n    const { aspectId, name } = dependency.includes(TaskIdDelimiter)\n      ? BuildTaskHelper.deserializeId(dependency)\n      : { aspectId: dependency, name: undefined };\n    const dependencyTasks = pipeline.filter((pipelineTask) => {\n      if (pipelineTask.aspectId !== aspectId) return false;\n      return name ? name === pipelineTask.name : true;\n    });\n    if (dependencyTasks.length === 0) {\n      throw new Error(\n        `unable to find dependency \"${dependency}\" of \"${BuildTaskHelper.serializeId(task)}\" in the pipeline`\n      );\n    }\n    dependencyTasks.forEach((dependencyTask) => {\n      const location = getLocation(task, dependencyTask);\n      if (!location) {\n        // the dependency is behind and will be in the correct order regardless the graph.\n        return;\n      }\n      const graphLocation = graphs.find((g) => g.location === location);\n      if (!graphLocation) throw new Error(`unable to find graph for location ${location}`);\n      const dependencyId = BuildTaskHelper.serializeId(dependencyTask);\n      const graph = graphLocation.graph;\n      graph.setNode(taskId, taskId);\n      graph.setNode(dependencyId, dependencyId);\n      graph.setEdge(dependencyId, taskId, 'dependency');\n    });\n  });\n}\n\n/**\n * since the task execution is happening per group: \"start\", \"middle\" and \"end\", the dependencies\n * need to be inside the same group.\n * e.g. if a dependency located at \"end\" group and the task located at \"start\", it's impossible to\n * complete the dependency before the task, there it throws an error.\n * it's ok to have the dependency located earlier, e.g. \"start\" and the task at \"end\", and in this\n * case, it will not be part of the graph because there is no need to do any special calculation.\n */\nfunction getLocation(task: BuildTask, dependencyTask: BuildTask): Location | null {\n  const taskLocation = task.location || 'middle';\n  const dependencyLocation = dependencyTask.location || 'middle';\n\n  const isDependencyAhead =\n    (taskLocation === 'start' && dependencyLocation !== 'start') ||\n    (taskLocation === 'middle' && dependencyLocation === 'end');\n\n  const isDependencyEqual = taskLocation === dependencyLocation;\n\n  if (isDependencyAhead) {\n    throw new Error(`a task \"${BuildTaskHelper.serializeId(task)}\" located at ${taskLocation}\nhas a dependency \"${BuildTaskHelper.serializeId(dependencyTask)} located at ${dependencyLocation},\nwhich is invalid. the dependency must be located earlier or in the same location as the task\"`);\n  }\n\n  if (isDependencyEqual) {\n    return taskLocation;\n  }\n\n  // dependency is behind. e.g. task is \"end\" and dependency is \"start\". no need to enter to the\n  // graph as it's going to be executed in the right order regardless the graph.\n  return null;\n}\n\nfunction getPipelineForEnv(taskSlot: TaskSlot, env: Environment, pipeNameOnEnv: string): BuildTask[] {\n  const buildTasks: BuildTask[] = env[pipeNameOnEnv] ? env[pipeNameOnEnv]() : [];\n  const slotsTasks = taskSlot.values().flat();\n  const tasksAtStart: BuildTask[] = [];\n  const tasksAtEnd: BuildTask[] = [];\n  slotsTasks.forEach((task) => {\n    if (task.location === 'start') {\n      tasksAtStart.push(task);\n      return;\n    }\n    if (task.location === 'end') {\n      tasksAtEnd.push(task);\n      return;\n    }\n    tasksAtStart.push(task);\n  });\n\n  // merge with extension registered tasks.\n  const mergedTasks = [...tasksAtStart, ...buildTasks, ...tasksAtEnd];\n\n  return mergedTasks;\n}\n"]}
+{"version":3,"sources":["build-pipeline-order.ts"],"names":["calculatePipelineOrder","taskSlot","envs","pipeNameOnEnv","tasks","skipTests","graphs","locations","forEach","location","push","graph","Graph","pipelineEnvs","envDefinition","pipeline","getPipelineForEnv","env","flattenedPipeline","map","pipelineEnv","flat","task","addDependenciesToGraph","dataPerLocation","pipelineEnvsPerLocation","filter","tasksQueue","TasksQueue","addTasksToGraph","length","includes","name","aspectId","TesterAspect","id","data","find","d","sorted","toposort","taskNode","BuildTaskHelper","deserializeId","attr","taskIndex","findIndex","pipelineTask","splice","dependencies","taskId","serializeId","dependency","deserializeIdAllowEmptyName","dependencyTasks","Error","dependencyTask","getLocation","graphLocation","g","dependencyId","setNode","setEdge","taskLocation","dependencyLocation","isDependencyAhead","isDependencyEqual","buildTasks","slotsTasks","values","tasksAtStart","tasksAtEnd","mergedTasks"],"mappings":"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","sourcesContent":["import { Graph } from 'cleargraph';\nimport TesterAspect from '@teambit/tester';\nimport { EnvDefinition, Environment } from '@teambit/envs';\nimport { BuildTask, BuildTaskHelper } from './build-task';\nimport type { TaskSlot } from './builder.main.runtime';\nimport { TasksQueue } from './tasks-queue';\n\ntype TaskDependenciesGraph = Graph<string, string>;\ntype Location = 'start' | 'middle' | 'end';\ntype TasksLocationGraph = { location: Location; graph: TaskDependenciesGraph };\ntype PipelineEnv = { env: EnvDefinition; pipeline: BuildTask[] };\ntype DataPerLocation = { location: Location; graph: TaskDependenciesGraph; pipelineEnvs: PipelineEnv[] };\n\n/**\n * there are two ways how to add tasks to build pipeline.\n * 1. `getBuildPipe()` method of the env.\n * 2. registering to the `builder.registerBuildTask()`.\n *\n * in the option #1, it's possible to determine the order. e.g. `getBuildPipe() { return [taskA, taskB, taskC]; }`\n * in the option #2, the register happens once the extension is loaded, so there is no way to put\n * one task before/after another task.\n *\n * To be able to determine the order, you can do the following\n * 1. \"task.location\", it has two options \"start\" and \"end\". the rest are \"middle\".\n * 2. \"task.dependencies\", the dependencies must be completed for all envs before this task starts.\n * the dependencies are applicable inside a location and not across locations. see getLocation()\n * or/and continue reading for more info about this.\n *\n * to determine the final order of the tasks, the following is done:\n * 1. split all tasks to three groups: start, middle and end.\n * 2. for each group define a dependencies graph for the tasks with \"dependencies\" prop and the pipeline.\n * 3. start with the first group \"start\", toposort the dependencies graph and push the found tasks\n * to a queue. once completed, iterate the pipeline and add all tasks to the queue.\n * 4. do the same for the \"middle\" and \"end\" groups.\n *\n * the reason for splitting the tasks to the three groups and not using the \"dependencies\" field\n * alone to determine the order is that the \"start\" and \"end\" groups are mostly core and \"middle\"\n * is mostly the user entering tasks to the pipeline and we as the core don't know about the users\n * tasks. For example, a core task \"PublishComponent\" must happen after the compiler, however, a\n * user might have an env without a compiler. if we determine the order only by the dependencies\n * field, the \"PublishComponent\" would have a dependency \"compiler\" and because in this case there\n * is no compiler task, it would throw an error about missing dependencies.\n */\nexport function calculatePipelineOrder(\n  taskSlot: TaskSlot,\n  envs: EnvDefinition[],\n  pipeNameOnEnv = 'getBuildPipe',\n  tasks: string[] = [],\n  skipTests = false\n): TasksQueue {\n  const graphs: TasksLocationGraph[] = [];\n  const locations: Location[] = ['start', 'middle', 'end']; // the order is important here!\n  locations.forEach((location) => {\n    graphs.push({ location, graph: new Graph<string, string>() });\n  });\n  const pipelineEnvs: PipelineEnv[] = [];\n  envs.forEach((envDefinition) => {\n    const pipeline = getPipelineForEnv(taskSlot, envDefinition.env, pipeNameOnEnv);\n    pipelineEnvs.push({ env: envDefinition, pipeline });\n  });\n\n  const flattenedPipeline: BuildTask[] = pipelineEnvs.map((pipelineEnv) => pipelineEnv.pipeline).flat();\n  flattenedPipeline.forEach((task) => addDependenciesToGraph(graphs, flattenedPipeline, task));\n\n  const dataPerLocation: DataPerLocation[] = graphs.map(({ location, graph }) => {\n    const pipelineEnvsPerLocation: PipelineEnv[] = pipelineEnvs.map(({ env, pipeline }) => {\n      return { env, pipeline: pipeline.filter((task) => (task.location || 'middle') === location) };\n    });\n    return { location, graph, pipelineEnvs: pipelineEnvsPerLocation };\n  });\n\n  const tasksQueue = new TasksQueue();\n  locations.forEach((location) => addTasksToGraph(tasksQueue, dataPerLocation, location));\n  if (tasks.length) {\n    return new TasksQueue(\n      ...tasksQueue.filter(({ task }) => tasks.includes(task.name) || tasks.includes(task.aspectId))\n    );\n  }\n  if (skipTests) {\n    return new TasksQueue(...tasksQueue.filter(({ task }) => task.aspectId !== TesterAspect.id));\n  }\n  return tasksQueue;\n}\n\nfunction addTasksToGraph(tasksQueue: TasksQueue, dataPerLocation: DataPerLocation[], location: Location) {\n  const data = dataPerLocation.find((d) => d.location === location);\n  if (!data) return;\n  const sorted = data.graph.toposort();\n  sorted.forEach((taskNode) => {\n    const { aspectId, name } = BuildTaskHelper.deserializeId(taskNode.attr);\n    data.pipelineEnvs.forEach(({ env, pipeline }) => {\n      const taskIndex = pipeline.findIndex(\n        (pipelineTask) => pipelineTask.aspectId === aspectId && pipelineTask.name === name\n      );\n      if (taskIndex < 0) return;\n      const task = pipeline[taskIndex];\n      tasksQueue.push({ env, task });\n      pipeline.splice(taskIndex, 1); // delete the task from the pipeline\n    });\n  });\n  data.pipelineEnvs.forEach(({ env, pipeline }) => {\n    pipeline.forEach((task) => tasksQueue.push({ env, task }));\n  });\n}\n\nfunction addDependenciesToGraph(graphs: TasksLocationGraph[], pipeline: BuildTask[], task: BuildTask) {\n  if (!task.dependencies || !task.dependencies.length) return;\n  const taskId = BuildTaskHelper.serializeId(task);\n  task.dependencies.forEach((dependency) => {\n    const { aspectId, name } = BuildTaskHelper.deserializeIdAllowEmptyName(dependency);\n    const dependencyTasks = pipeline.filter((pipelineTask) => {\n      if (pipelineTask.aspectId !== aspectId) return false;\n      return name ? name === pipelineTask.name : true;\n    });\n    if (dependencyTasks.length === 0) {\n      throw new Error(\n        `unable to find dependency \"${dependency}\" of \"${BuildTaskHelper.serializeId(task)}\" in the pipeline`\n      );\n    }\n    dependencyTasks.forEach((dependencyTask) => {\n      const location = getLocation(task, dependencyTask);\n      if (!location) {\n        // the dependency is behind and will be in the correct order regardless the graph.\n        return;\n      }\n      const graphLocation = graphs.find((g) => g.location === location);\n      if (!graphLocation) throw new Error(`unable to find graph for location ${location}`);\n      const dependencyId = BuildTaskHelper.serializeId(dependencyTask);\n      const graph = graphLocation.graph;\n      graph.setNode(taskId, taskId);\n      graph.setNode(dependencyId, dependencyId);\n      graph.setEdge(dependencyId, taskId, 'dependency');\n    });\n  });\n}\n\n/**\n * since the task execution is happening per group: \"start\", \"middle\" and \"end\", the dependencies\n * need to be inside the same group.\n * e.g. if a dependency located at \"end\" group and the task located at \"start\", it's impossible to\n * complete the dependency before the task, there it throws an error.\n * it's ok to have the dependency located earlier, e.g. \"start\" and the task at \"end\", and in this\n * case, it will not be part of the graph because there is no need to do any special calculation.\n */\nfunction getLocation(task: BuildTask, dependencyTask: BuildTask): Location | null {\n  const taskLocation = task.location || 'middle';\n  const dependencyLocation = dependencyTask.location || 'middle';\n\n  const isDependencyAhead =\n    (taskLocation === 'start' && dependencyLocation !== 'start') ||\n    (taskLocation === 'middle' && dependencyLocation === 'end');\n\n  const isDependencyEqual = taskLocation === dependencyLocation;\n\n  if (isDependencyAhead) {\n    throw new Error(`a task \"${BuildTaskHelper.serializeId(task)}\" located at ${taskLocation}\nhas a dependency \"${BuildTaskHelper.serializeId(dependencyTask)} located at ${dependencyLocation},\nwhich is invalid. the dependency must be located earlier or in the same location as the task\"`);\n  }\n\n  if (isDependencyEqual) {\n    return taskLocation;\n  }\n\n  // dependency is behind. e.g. task is \"end\" and dependency is \"start\". no need to enter to the\n  // graph as it's going to be executed in the right order regardless the graph.\n  return null;\n}\n\nfunction getPipelineForEnv(taskSlot: TaskSlot, env: Environment, pipeNameOnEnv: string): BuildTask[] {\n  const buildTasks: BuildTask[] = env[pipeNameOnEnv] ? env[pipeNameOnEnv]() : [];\n  const slotsTasks = taskSlot.values().flat();\n  const tasksAtStart: BuildTask[] = [];\n  const tasksAtEnd: BuildTask[] = [];\n  slotsTasks.forEach((task) => {\n    if (task.location === 'start') {\n      tasksAtStart.push(task);\n      return;\n    }\n    if (task.location === 'end') {\n      tasksAtEnd.push(task);\n      return;\n    }\n    tasksAtStart.push(task);\n  });\n\n  // merge with extension registered tasks.\n  const mergedTasks = [...tasksAtStart, ...buildTasks, ...tasksAtEnd];\n\n  return mergedTasks;\n}\n"]}

package/dist/build-task.d.ts

@@ -101,4 +101,12 @@ export declare class BuildTaskHelper {
         aspectId: string;
         name: string;
     };
+    /**
+     * don't throw an error when the id includes only the aspect-id without the task name.
+     * useful for task dependencies, when it's allowed to specify the aspect-id only.
+     */
+    static deserializeIdAllowEmptyName(id: string): {
+        aspectId: string;
+        name?: string;
+    };
 }

package/dist/build-task.js

@@ -38,6 +38,18 @@ class BuildTaskHelper {
     };
     throw new Error(`deserializeId, id ${id} has more than one ${TaskIdDelimiter}`);
   }
+  /**
+   * don't throw an error when the id includes only the aspect-id without the task name.
+   * useful for task dependencies, when it's allowed to specify the aspect-id only.
+   */
+
+
+  static deserializeIdAllowEmptyName(id) {
+    return id.includes(TaskIdDelimiter) ? BuildTaskHelper.deserializeId(id) : {
+      aspectId: id,
+      name: undefined
+    };
+  }
 
 }
 

package/dist/build-task.js.map

@@ -1 +1 @@
-{"version":3,"sources":["build-task.ts"],"names":["TaskIdDelimiter","CAPSULE_ARTIFACTS_DIR","BuildTaskHelper","serializeId","aspectId","name","deserializeId","id","split","length","Error"],"mappings":";;;;;;;;;AAUA;AACA;AACA;AACO,MAAMA,eAAe,GAAG,GAAxB;AAEP;AACA;AACA;AACA;;;AACO,MAAMC,qBAAqB,GAAG,WAA9B;;;AA8FA,MAAMC,eAAN,CAAsB;AACT,SAAXC,WAAW,CAAC;AAAEC,IAAAA,QAAF;AAAYC,IAAAA;AAAZ,GAAD,EAAiE;AACjF,WAAOD,QAAQ,GAAGJ,eAAX,GAA6BK,IAApC;AACD;;AACmB,SAAbC,aAAa,CAACC,EAAD,EAAiD;AACnE,UAAMC,KAAK,GAAGD,EAAE,CAACC,KAAH,CAASR,eAAT,CAAd;AACA,QAAIQ,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,MAAM,IAAIC,KAAJ,CAAW,kBAAiBH,EAAG,WAA/B,CAAN;AACxB,QAAIC,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,MAAM,IAAIC,KAAJ,CAAW,kBAAiBH,EAAG,kCAA/B,CAAN;AACxB,QAAIC,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,OAAO;AAAEL,MAAAA,QAAQ,EAAEI,KAAK,CAAC,CAAD,CAAjB;AAAsBH,MAAAA,IAAI,EAAEG,KAAK,CAAC,CAAD;AAAjC,KAAP;AACxB,UAAM,IAAIE,KAAJ,CAAW,qBAAoBH,EAAG,sBAAqBP,eAAgB,EAAvE,CAAN;AACD;;AAV0B","sourcesContent":["import type { Component } from '@teambit/component';\nimport { ExecutionContext } from '@teambit/envs';\nimport type { Network } from '@teambit/isolator';\nimport type { ComponentResult } from './types';\nimport type { ArtifactDefinition } from './artifact';\nimport { TaskResultsList } from './task-results-list';\nimport { TaskResults } from './build-pipe';\n\nexport type TaskLocation = 'start' | 'end';\n\n/**\n * delimiter between task.aspectId and task.name\n */\nexport const TaskIdDelimiter = ':';\n\n/**\n * A folder to write artifacts generated during a build task\n * This folder is used in the core envs and excluded by default from the package tar file (the core envs is writing this into the npmignore file)\n */\nexport const CAPSULE_ARTIFACTS_DIR = 'artifacts';\n\nexport interface BuildContext extends ExecutionContext {\n  /**\n   * all components about to be built/tagged.\n   */\n  components: Component[];\n\n  /**\n   * network of capsules ready to be built.\n   */\n  capsuleNetwork: Network;\n\n  /**\n   * data generated by tasks that were running before this task\n   */\n  previousTasksResults: TaskResults[];\n\n  /**\n   * Run the build pipeline in dev mode\n   */\n  dev?: boolean;\n}\n\nexport interface BuildTask {\n  /**\n   * aspect id serialized of the creator of the task.\n   * todo: automate this so then it won't be needed to pass manually.\n   */\n  aspectId: string;\n\n  /**\n   * name of the task. function as an identifier among other tasks of the same aspectId.\n   * spaces and special characters are not allowed. as a convention, use UpperCamelCase style.\n   * (e.g. TypescriptCompiler).\n   */\n  name: string;\n\n  /**\n   * description of what the task does.\n   * if available, the logger will log it show it in the status-line.\n   */\n  description?: string;\n\n  /**\n   * where to put the task, before the env pipeline or after\n   */\n  location?: TaskLocation;\n\n  /**\n   * execute a task in a build context\n   */\n  execute(context: BuildContext): Promise<BuiltTaskResult>;\n\n  /**\n   * run before the build pipeline has started. this is useful when some preparation are needed to\n   * be done on all envs before the build starts.\n   * e.g. typescript compiler needs to write the tsconfig file. doing it during the task, will\n   * cause dependencies from other envs to get this tsconfig written.\n   */\n  preBuild?(context: BuildContext): Promise<void>;\n\n  /**\n   * run after the build pipeline completed for all envs. useful for doing some cleanup on the\n   * capsules before the deployment starts.\n   */\n  postBuild?(context: BuildContext, tasksResults: TaskResultsList): Promise<void>;\n\n  /**\n   * needed if you want the task to be running only after the dependencies were completed\n   * for *all* envs.\n   * normally this is not needed because the build-pipeline runs the tasks in the same order\n   * they're located in the `getBuildPipe()` array and according to the task.location.\n   * the case where this is useful is when a task not only needs to be after another task, but also\n   * after all environments were running that task.\n   * a dependency is task.aspectId. if an aspect has multiple tasks, to be more specific, use\n   * \"aspectId:name\", e.g. \"teambit.compilation/compiler:TypescriptCompiler\".\n   */\n  dependencies?: string[];\n}\n\n// TODO: rename to BuildTaskResults\nexport interface BuiltTaskResult {\n  /**\n   * build results for each of the components in the build context.\n   */\n  componentsResults: ComponentResult[];\n\n  /**\n   * array of artifact definitions to generate after a successful build.\n   */\n  artifacts?: ArtifactDefinition[];\n}\n\nexport class BuildTaskHelper {\n  static serializeId({ aspectId, name }: { aspectId: string; name: string }): string {\n    return aspectId + TaskIdDelimiter + name;\n  }\n  static deserializeId(id: string): { aspectId: string; name: string } {\n    const split = id.split(TaskIdDelimiter);\n    if (split.length === 0) throw new Error(`deserializeId, ${id} is empty`);\n    if (split.length === 1) throw new Error(`deserializeId, ${id} has only aspect-id without name`);\n    if (split.length === 2) return { aspectId: split[0], name: split[1] };\n    throw new Error(`deserializeId, id ${id} has more than one ${TaskIdDelimiter}`);\n  }\n}\n"]}
+{"version":3,"sources":["build-task.ts"],"names":["TaskIdDelimiter","CAPSULE_ARTIFACTS_DIR","BuildTaskHelper","serializeId","aspectId","name","deserializeId","id","split","length","Error","deserializeIdAllowEmptyName","includes","undefined"],"mappings":";;;;;;;;;AAUA;AACA;AACA;AACO,MAAMA,eAAe,GAAG,GAAxB;AAEP;AACA;AACA;AACA;;;AACO,MAAMC,qBAAqB,GAAG,WAA9B;;;AA8FA,MAAMC,eAAN,CAAsB;AACT,SAAXC,WAAW,CAAC;AAAEC,IAAAA,QAAF;AAAYC,IAAAA;AAAZ,GAAD,EAAiE;AACjF,WAAOD,QAAQ,GAAGJ,eAAX,GAA6BK,IAApC;AACD;;AACmB,SAAbC,aAAa,CAACC,EAAD,EAAiD;AACnE,UAAMC,KAAK,GAAGD,EAAE,CAACC,KAAH,CAASR,eAAT,CAAd;AACA,QAAIQ,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,MAAM,IAAIC,KAAJ,CAAW,kBAAiBH,EAAG,WAA/B,CAAN;AACxB,QAAIC,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,MAAM,IAAIC,KAAJ,CAAW,kBAAiBH,EAAG,kCAA/B,CAAN;AACxB,QAAIC,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,OAAO;AAAEL,MAAAA,QAAQ,EAAEI,KAAK,CAAC,CAAD,CAAjB;AAAsBH,MAAAA,IAAI,EAAEG,KAAK,CAAC,CAAD;AAAjC,KAAP;AACxB,UAAM,IAAIE,KAAJ,CAAW,qBAAoBH,EAAG,sBAAqBP,eAAgB,EAAvE,CAAN;AACD;AACD;AACF;AACA;AACA;;;AACoC,SAA3BW,2BAA2B,CAACJ,EAAD,EAAkD;AAClF,WAAOA,EAAE,CAACK,QAAH,CAAYZ,eAAZ,IAA+BE,eAAe,CAACI,aAAhB,CAA8BC,EAA9B,CAA/B,GAAmE;AAAEH,MAAAA,QAAQ,EAAEG,EAAZ;AAAgBF,MAAAA,IAAI,EAAEQ;AAAtB,KAA1E;AACD;;AAjB0B","sourcesContent":["import type { Component } from '@teambit/component';\nimport { ExecutionContext } from '@teambit/envs';\nimport type { Network } from '@teambit/isolator';\nimport type { ComponentResult } from './types';\nimport type { ArtifactDefinition } from './artifact';\nimport { TaskResultsList } from './task-results-list';\nimport { TaskResults } from './build-pipe';\n\nexport type TaskLocation = 'start' | 'end';\n\n/**\n * delimiter between task.aspectId and task.name\n */\nexport const TaskIdDelimiter = ':';\n\n/**\n * A folder to write artifacts generated during a build task\n * This folder is used in the core envs and excluded by default from the package tar file (the core envs is writing this into the npmignore file)\n */\nexport const CAPSULE_ARTIFACTS_DIR = 'artifacts';\n\nexport interface BuildContext extends ExecutionContext {\n  /**\n   * all components about to be built/tagged.\n   */\n  components: Component[];\n\n  /**\n   * network of capsules ready to be built.\n   */\n  capsuleNetwork: Network;\n\n  /**\n   * data generated by tasks that were running before this task\n   */\n  previousTasksResults: TaskResults[];\n\n  /**\n   * Run the build pipeline in dev mode\n   */\n  dev?: boolean;\n}\n\nexport interface BuildTask {\n  /**\n   * aspect id serialized of the creator of the task.\n   * todo: automate this so then it won't be needed to pass manually.\n   */\n  aspectId: string;\n\n  /**\n   * name of the task. function as an identifier among other tasks of the same aspectId.\n   * spaces and special characters are not allowed. as a convention, use UpperCamelCase style.\n   * (e.g. TypescriptCompiler).\n   */\n  name: string;\n\n  /**\n   * description of what the task does.\n   * if available, the logger will log it show it in the status-line.\n   */\n  description?: string;\n\n  /**\n   * where to put the task, before the env pipeline or after\n   */\n  location?: TaskLocation;\n\n  /**\n   * execute a task in a build context\n   */\n  execute(context: BuildContext): Promise<BuiltTaskResult>;\n\n  /**\n   * run before the build pipeline has started. this is useful when some preparation are needed to\n   * be done on all envs before the build starts.\n   * e.g. typescript compiler needs to write the tsconfig file. doing it during the task, will\n   * cause dependencies from other envs to get this tsconfig written.\n   */\n  preBuild?(context: BuildContext): Promise<void>;\n\n  /**\n   * run after the build pipeline completed for all envs. useful for doing some cleanup on the\n   * capsules before the deployment starts.\n   */\n  postBuild?(context: BuildContext, tasksResults: TaskResultsList): Promise<void>;\n\n  /**\n   * needed if you want the task to be running only after the dependencies were completed\n   * for *all* envs.\n   * normally this is not needed because the build-pipeline runs the tasks in the same order\n   * they're located in the `getBuildPipe()` array and according to the task.location.\n   * the case where this is useful is when a task not only needs to be after another task, but also\n   * after all environments were running that task.\n   * a dependency is task.aspectId. if an aspect has multiple tasks, to be more specific, use\n   * \"aspectId:name\", e.g. \"teambit.compilation/compiler:TypescriptCompiler\".\n   */\n  dependencies?: string[];\n}\n\n// TODO: rename to BuildTaskResults\nexport interface BuiltTaskResult {\n  /**\n   * build results for each of the components in the build context.\n   */\n  componentsResults: ComponentResult[];\n\n  /**\n   * array of artifact definitions to generate after a successful build.\n   */\n  artifacts?: ArtifactDefinition[];\n}\n\nexport class BuildTaskHelper {\n  static serializeId({ aspectId, name }: { aspectId: string; name: string }): string {\n    return aspectId + TaskIdDelimiter + name;\n  }\n  static deserializeId(id: string): { aspectId: string; name: string } {\n    const split = id.split(TaskIdDelimiter);\n    if (split.length === 0) throw new Error(`deserializeId, ${id} is empty`);\n    if (split.length === 1) throw new Error(`deserializeId, ${id} has only aspect-id without name`);\n    if (split.length === 2) return { aspectId: split[0], name: split[1] };\n    throw new Error(`deserializeId, id ${id} has more than one ${TaskIdDelimiter}`);\n  }\n  /**\n   * don't throw an error when the id includes only the aspect-id without the task name.\n   * useful for task dependencies, when it's allowed to specify the aspect-id only.\n   */\n  static deserializeIdAllowEmptyName(id: string): { aspectId: string; name?: string } {\n    return id.includes(TaskIdDelimiter) ? BuildTaskHelper.deserializeId(id) : { aspectId: id, name: undefined };\n  }\n}\n"]}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@teambit/builder",
-  "version": "0.0.636",
+  "version": "0.0.640",
   "homepage": "https://bit.dev/teambit/pipelines/builder",
   "main": "dist/index.js",
   "componentId": {
     "scope": "teambit.pipelines",
     "name": "builder",
-    "version": "0.0.636"
+    "version": "0.0.640"
   },
   "dependencies": {
     "p-map-series": "2.1.0",
@@ -22,17 +22,17 @@
     "globby": "11.0.1",
     "@babel/runtime": "7.12.18",
     "core-js": "^3.0.0",
-    "@teambit/component": "0.0.636",
-    "@teambit/envs": "0.0.636",
-    "@teambit/logger": "0.0.524",
-    "@teambit/tester": "0.0.636",
-    "@teambit/isolator": "0.0.636",
-    "@teambit/cli": "0.0.434",
-    "@teambit/workspace": "0.0.636",
-    "@teambit/aspect-loader": "0.0.636",
-    "@teambit/generator": "0.0.636",
-    "@teambit/graphql": "0.0.636",
-    "@teambit/scope": "0.0.636",
+    "@teambit/component": "0.0.640",
+    "@teambit/envs": "0.0.640",
+    "@teambit/logger": "0.0.527",
+    "@teambit/tester": "0.0.640",
+    "@teambit/isolator": "0.0.640",
+    "@teambit/cli": "0.0.437",
+    "@teambit/workspace": "0.0.640",
+    "@teambit/aspect-loader": "0.0.640",
+    "@teambit/generator": "0.0.640",
+    "@teambit/graphql": "0.0.640",
+    "@teambit/scope": "0.0.640",
     "@teambit/bit-error": "0.0.394",
     "@teambit/component-id": "0.0.400"
   },
@@ -49,7 +49,7 @@
     "@teambit/pipelines.aspect-docs.builder": "0.0.131"
   },
   "peerDependencies": {
-    "@teambit/legacy": "1.0.210",
+    "@teambit/legacy": "1.0.213",
     "react-dom": "^16.8.0 || ^17.0.0",
     "react": "^16.8.0 || ^17.0.0"
   },
@@ -77,7 +77,7 @@
         "react": "-"
       },
       "peerDependencies": {
-        "@teambit/legacy": "1.0.210",
+        "@teambit/legacy": "1.0.213",
         "react-dom": "^16.8.0 || ^17.0.0",
         "react": "^16.8.0 || ^17.0.0"
       }