@teambit/builder 0.0.636 → 0.0.637

package/{__preview-1643426469482.js → __preview-1643599267183.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.637/dist/builder.docs.mdx')]

package/dist/build-pipe.js

@@ -175,7 +175,7 @@ class BuildPipe {
         const {
           aspectId,
           name
-        } = _buildTask().BuildTaskHelper.deserializeId(dependency);
+        } = _buildTask().BuildTaskHelper.safeDeserializeId(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","safeDeserializeId","find","failedTask","envId","failedTaskId","consoleWarning","Error","previousTasksResults","from"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAGA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AACA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AAEA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AAIA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;;AAmCO,MAAMA,SAAN,CAAgB;AAKrBC,EAAAA,WAAW;AACT;AACJ;AACA;AACaC,EAAAA,UAJA,EAKAC,gBALA,EAMAC,MANA,EAOAC,eAPA,EAQDC,mBARC,EAST;AAAA,SALSJ,UAKT,GALSA,UAKT;AAAA,SAJSC,gBAIT,GAJSA,gBAIT;AAAA,SAHSC,MAGT,GAHSA,MAGT;AAAA,SAFSC,eAET,GAFSA,eAET;AAAA,SADQC,mBACR,GADQA,mBACR;AAAA,yDAbiC,EAajC;AAAA;AAAA;AAAA,yDAVmC,EAUnC;AAAE;;AAEe,MAAfC,eAAe,GAAkB;AACnC,WAAO,CAAC,IAAI,KAAKD,mBAAL,IAA4B,EAAhC,CAAD,EAAsC,IAAI,KAAKE,WAAL,IAAoB,EAAxB,CAAtC,CAAP;AACD;AAED;AACF;AACA;;;AACe,QAAPC,OAAO,GAA6B;AACxC,UAAM,KAAKC,eAAL,EAAN;AACA,SAAKC,iBAAL,GAAyB,KAAKP,MAAL,CAAYQ,uBAAZ,CAAoC,eAApC,EAAqD,KAAKV,UAAL,CAAgBW,MAArE,CAAzB;AACA,UAAM,2BAAU,KAAKX,UAAf,EAA2B,OAAO;AAAEY,MAAAA,IAAF;AAAQC,MAAAA;AAAR,KAAP,KAAyB,KAAKC,WAAL,CAAiBF,IAAjB,EAAuBC,GAAvB,CAApD,CAAN;AACA,SAAKJ,iBAAL,CAAuBM,GAAvB;AACA,UAAMC,gBAAgB,GAAG,KAAIC,kCAAJ,EAAoB,KAAKjB,UAAzB,EAAqC,KAAKM,WAA1C,CAAzB;AACA,UAAM,KAAKY,gBAAL,CAAsBF,gBAAtB,CAAN;AAEA,WAAOA,gBAAP;AACD;;AAE4B,QAAfR,eAAe,GAAG;AAC9B,SAAKN,MAAL,CAAYiB,aAAZ,CAA0B,mCAA1B;AACA,UAAM,2BAAU,KAAKnB,UAAf,EAA2B,OAAO;AAAEY,MAAAA,IAAF;AAAQC,MAAAA;AAAR,KAAP,KAAyB;AACxD,UAAI,CAACD,IAAI,CAACQ,QAAV,EAAoB;AACpB,YAAMR,IAAI,CAACQ,QAAL,CAAc,KAAKC,eAAL,CAAqBR,GAAG,CAACS,EAAzB,CAAd,CAAN;AACD,KAHK,CAAN;AAIA,SAAKpB,MAAL,CAAYqB,cAAZ;AACD;;AAEwB,QAAXT,WAAW,CAACF,IAAD,EAAkBC,GAAlB,EAAqD;AAC5E,UAAMW,MAAM,GAAGC,6BAAgBC,WAAhB,CAA4Bd,IAA5B,CAAf;;AACA,UAAMe,QAAQ,GAAI,GAAEH,MAAO,GAAEZ,IAAI,CAACgB,WAAL,GAAoB,KAAIhB,IAAI,CAACgB,WAAY,GAAzC,GAA8C,EAAG,EAA9E;AACA,SAAKnB,iBAAL,CAAuBoB,WAAvB,CAAoC,QAAOhB,GAAG,CAACS,EAAG,YAAWK,QAAS,GAAtE;AACA,SAAKG,0BAAL,CAAgClB,IAAhC;;AACA,QAAI,KAAKmB,cAAL,CAAoBP,MAApB,EAA4BX,GAAG,CAACS,EAAhC,CAAJ,EAAyC;AACvC;AACD;;AACD,UAAMU,SAAS,GAAGC,OAAO,CAACC,MAAR,EAAlB;AACA,UAAMC,aAAa,GAAGC,IAAI,CAACC,GAAL,EAAtB;AACA,UAAMC,YAAY,GAAG,KAAKjB,eAAL,CAAqBR,GAAG,CAACS,EAAzB,CAArB;AACA,UAAMiB,eAAe,GAAG,MAAM3B,IAAI,CAACL,OAAL,CAAa+B,YAAb,CAA9B;AACA,UAAME,OAAO,GAAGJ,IAAI,CAACC,GAAL,EAAhB;AACA,UAAMI,eAAe,GAAGF,eAAe,CAACG,iBAAhB,CAAkCC,MAAlC,CAA0CC,CAAD;AAAA;;AAAA,0BAAOA,CAAC,CAACC,MAAT,8CAAO,UAAUlC,MAAjB;AAAA,KAAzC,CAAxB;AACA,QAAImC,SAAJ;;AACA,QAAIL,eAAe,CAAC9B,MAApB,EAA4B;AAC1B,WAAKT,MAAL,CAAY6C,cAAZ,CAA4B,QAAOlC,GAAG,CAACS,EAAG,WAAUE,MAAO,cAA3D;AACA,WAAKwB,WAAL,CAAiBC,IAAjB,CAAsBrC,IAAtB;AACD,KAHD,MAGO;AACL,YAAMsC,QAAQ,GAAG,2BAAWjB,OAAO,CAACC,MAAR,CAAeF,SAAf,CAAX,CAAjB;AACA,WAAK9B,MAAL,CAAYqB,cAAZ,CAA4B,QAAOV,GAAG,CAACS,EAAG,YAAWK,QAAS,mCAAkCuB,QAAS,EAAzG;AACA,YAAMC,IAAI,GAAGZ,eAAe,CAACO,SAAhB,IAA6B,EAA1C;AACAA,MAAAA,SAAS,GAAG,KAAK3C,eAAL,CAAqBiD,QAArB,CAA8Bd,YAA9B,EAA4Ca,IAA5C,EAAkDvC,IAAlD,CAAZ;AACD;;AAED,UAAMN,WAAwB,GAAG;AAC/BM,MAAAA,IAD+B;AAE/BC,MAAAA,GAF+B;AAG/B6B,MAAAA,iBAAiB,EAAEH,eAAe,CAACG,iBAHJ;AAI/BI,MAAAA,SAJ+B;AAK/BO,MAAAA,SAAS,EAAElB,aALoB;AAM/BK,MAAAA;AAN+B,KAAjC;AASA,SAAKlC,WAAL,CAAiB2C,IAAjB,CAAsB3C,WAAtB;AACD;;AAE6B,QAAhBY,gBAAgB,CAACoC,YAAD,EAAgC;AAC5D,SAAKpD,MAAL,CAAYiB,aAAZ,CAA0B,oCAA1B;AACA,UAAM,2BAAU,KAAKnB,UAAf,EAA2B,OAAO;AAAEY,MAAAA,IAAF;AAAQC,MAAAA;AAAR,KAAP,KAAyB;AACxD,UAAI,CAACD,IAAI,CAAC2C,SAAV,EAAqB;AACrB,YAAM3C,IAAI,CAAC2C,SAAL,CAAe,KAAKlC,eAAL,CAAqBR,GAAG,CAACS,EAAzB,CAAf,EAA6CgC,YAA7C,CAAN;AACD,KAHK,CAAN;AAIA,SAAKpD,MAAL,CAAYqB,cAAZ;AACD;;AAEOO,EAAAA,0BAA0B,CAAClB,IAAD,EAAkB;AAClD,QAAI,CAAC,KAAK4C,oBAAN,IAA8B,KAAKR,WAAL,CAAiBrC,MAA/C,IAAyDC,IAAI,CAAC6C,YAAlE,EAAgF;AAC9E7C,MAAAA,IAAI,CAAC6C,YAAL,CAAkBC,OAAlB,CAA2BC,UAAD,IAAgB;AACxC,cAAM;AAAEC,UAAAA,QAAF;AAAYC,UAAAA;AAAZ,YAAqBpC,6BAAgBqC,iBAAhB,CAAkCH,UAAlC,CAA3B;;AACA,aAAKH,oBAAL,GAA4B,KAAKR,WAAL,CAAiBe,IAAjB,CAAuBC,UAAD,IAAgB;AAChE,cAAIH,IAAI,IAAIA,IAAI,KAAKG,UAAU,CAACH,IAAhC,EAAsC,OAAO,KAAP;AACtC,iBAAOD,QAAQ,KAAKI,UAAU,CAACJ,QAA/B;AACD,SAH2B,CAA5B;AAID,OAND;AAOD;AACF;;AAEO7B,EAAAA,cAAc,CAACP,MAAD,EAAiByC,KAAjB,EAAyC;AAC7D,QAAI,CAAC,KAAKT,oBAAV,EAAgC,OAAO,KAAP;;AAChC,UAAMU,YAAY,GAAGzC,6BAAgBC,WAAhB,CAA4B,KAAK8B,oBAAjC,CAArB;;AACA,SAAKtD,MAAL,CAAYiE,cAAZ,CAA4B,QAAOF,KAAM,WAAUzC,MAAO,yBAAwB0C,YAAa,WAA/F;AACA,WAAO,IAAP;AACD;;AAEO7C,EAAAA,eAAe,CAAC4C,KAAD,EAAgB;AACrC,UAAM3B,YAAY,GAAG,KAAKrC,gBAAL,CAAsBgE,KAAtB,CAArB;AACA,QAAI,CAAC3B,YAAL,EAAmB,MAAM,IAAI8B,KAAJ,CAAW,mCAAkCH,KAAM,EAAnD,CAAN;AACnB3B,IAAAA,YAAY,CAAC+B,oBAAb,GAAoC,KAAKhE,eAAzC;AACA,WAAOiC,YAAP;AACD;AAED;AACF;AACA;;;AACa,SAAJgC,IAAI,CACTtE,UADS,EAETC,gBAFS,EAGTC,MAHS,EAITC,eAJS,EAKTC,mBALS,EAMT;AACA,WAAO,IAAIN,SAAJ,CAAcE,UAAd,EAA0BC,gBAA1B,EAA4CC,MAA5C,EAAoDC,eAApD,EAAqEC,mBAArE,CAAP;AACD;;AA9HoB","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.safeDeserializeId(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-task.d.ts

@@ -101,4 +101,13 @@ export declare class BuildTaskHelper {
         aspectId: string;
         name: string;
     };
+    /**
+     * Deserialize the id, but without throw an error in case something is missing
+     * @param id
+     * @returns
+     */
+    static safeDeserializeId(id: string): {
+        aspectId?: string;
+        name?: string;
+    };
 }

package/dist/build-task.js

@@ -38,6 +38,25 @@ class BuildTaskHelper {
     };
     throw new Error(`deserializeId, id ${id} has more than one ${TaskIdDelimiter}`);
   }
+  /**
+   * Deserialize the id, but without throw an error in case something is missing
+   * @param id
+   * @returns
+   */
+
+
+  static safeDeserializeId(id) {
+    const split = id.split(TaskIdDelimiter);
+    if (split.length === 0) return {};
+    if (split.length === 1) return {
+      aspectId: split[0]
+    };
+    if (split.length === 2) return {
+      aspectId: split[0],
+      name: split[1]
+    };
+    throw new Error(`deserializeId, id ${id} has more than one ${TaskIdDelimiter}`);
+  }
 
 }
 

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","safeDeserializeId"],"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;AACA;;;AAC0B,SAAjBW,iBAAiB,CAACJ,EAAD,EAAmD;AACzE,UAAMC,KAAK,GAAGD,EAAE,CAACC,KAAH,CAASR,eAAT,CAAd;AACA,QAAIQ,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,OAAO,EAAP;AACxB,QAAID,KAAK,CAACC,MAAN,KAAiB,CAArB,EAAwB,OAAO;AAAEL,MAAAA,QAAQ,EAAEI,KAAK,CAAC,CAAD;AAAjB,KAAP;AACxB,QAAIA,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;;AAtB0B","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   * Deserialize the id, but without throw an error in case something is missing\n   * @param id\n   * @returns\n   */\n  static safeDeserializeId(id: string): { aspectId?: string; name?: string } {\n    const split = id.split(TaskIdDelimiter);\n    if (split.length === 0) return {};\n    if (split.length === 1) return { aspectId: split[0] };\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"]}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@teambit/builder",
-  "version": "0.0.636",
+  "version": "0.0.637",
   "homepage": "https://bit.dev/teambit/pipelines/builder",
   "main": "dist/index.js",
   "componentId": {
     "scope": "teambit.pipelines",
     "name": "builder",
-    "version": "0.0.636"
+    "version": "0.0.637"
   },
   "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/component": "0.0.637",
+    "@teambit/envs": "0.0.637",
     "@teambit/logger": "0.0.524",
-    "@teambit/tester": "0.0.636",
-    "@teambit/isolator": "0.0.636",
+    "@teambit/tester": "0.0.637",
+    "@teambit/isolator": "0.0.637",
     "@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/workspace": "0.0.637",
+    "@teambit/aspect-loader": "0.0.637",
+    "@teambit/generator": "0.0.637",
+    "@teambit/graphql": "0.0.637",
+    "@teambit/scope": "0.0.637",
     "@teambit/bit-error": "0.0.394",
     "@teambit/component-id": "0.0.400"
   },