@teambit/builder 1.0.234 → 1.0.237

package/artifacts/__bit_junit.xml

@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <testsuites tests="0" failures="0" errors="0" skipped="0">
-  <testsuite name="teambit.pipelines/builder@1.0.234" tests="0" failures="0" errors="0" skipped="0"/>
+  <testsuite name="teambit.pipelines/builder@1.0.237" tests="0" failures="0" errors="0" skipped="0"/>
 </testsuites>

package/artifacts/preview/teambit_pipelines_builder-preview.js

@@ -1 +1 @@
-!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports["teambit.pipelines/builder-preview"]=n():e["teambit.pipelines/builder-preview"]=n()}(self,(()=>(()=>{"use strict";var e={77456:(e,n,t)=>{var i={id:"teambit.pipelines/aspect-docs/builder@0.0.167",homepage:"https://bit.cloud/teambit/pipelines/aspect-docs/builder",exported:!0};Object.defineProperty(n,"__esModule",{value:!0}),n.default=u,o(t(41594));var a=t(5016),r=["components"];function o(e){return e&&e.__esModule?e:{default:e}}function s(){return s=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var t=arguments[n];for(var i in t)Object.prototype.hasOwnProperty.call(t,i)&&(e[i]=t[i])}return e},s.apply(this,arguments)}function l(e,n){if(null==e)return{};var t,i,a=d(e,n);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}function d(e,n){if(null==e)return{};var t,i,a={},r=Object.keys(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||(a[t]=e[t]);return a}o.__bit_component=i,s.__bit_component=i,l.__bit_component=i,d.__bit_component=i;var p={},m="wrapper";function u(e){var n=e.components,t=l(e,r);return(0,a.mdx)(m,s({},p,t,{components:n,mdxType:"MDXLayout"}),(0,a.mdx)("h2",null,"Background"),(0,a.mdx)("p",null,"Bit's build process is an extensible CI for independent components. It validates a component is not dependent on its context (the workspace), tests it, and generates all artifacts necessary for it to be viewed and consumed as an independent module (its distributable code, bundled preview, etc.)."),(0,a.mdx)("p",null,"The Build Pipeline is an Environment Service responsible for sequencing and executing a component's Build Tasks. As mentioned earlier, these tasks are performed on a component only after it's been isolated from the rest of the workspace."),(0,a.mdx)("p",null,"A component's default series of Build Tasks is composed of tasks set by Bit and by its environment."),(0,a.mdx)("h2",null,"Isolated builds"),(0,a.mdx)("p",null,"Components authored in a Bit workspace are created to be completely portable, and thus independent. To address that, the build process starts by creating a component 'capsule' which is an isolated instance of a component, generated in a separate directory in your filesystem."),(0,a.mdx)("p",null,'As part of the capsule creation, all packages listed as dependencies of that component will be installed. This step is necessary to validate there are no dependency-graph issues (a component that is not totally isolated will be able to use packages installed in parent directories in your workspace, by other components. This will translate into a "false positive" result when testing for dependency-graph issues in a non-isolated location).'),(0,a.mdx)("h2",null,"Incremental builds"),(0,a.mdx)("p",null,'When a component "goes through" the build pipeline, all of its dependencies are built as well. If a dependency has not changed since its last build, the build process will use its artifacts from the previous build (and will not process it again). This optimization to the build process supplements the "innate optimization" that naturally comes from developing (and building) independent components instead of a single monolithic codebase.'),(0,a.mdx)("h2",null,"Environment-specific builds"),(0,a.mdx)("p",null,"Each Bit environment determines its own build pipeline. That means, a single workspace that uses multiple environments will run a different set of build tasks on different components depending on their associated environment. This is another Bit feature that enables seamless transitioning between different development environments, all in the same workspace. It also makes it much easier to integrate the Build Pipeline in your (remote) CI, as it only requires executing the build step - all other per-component build configurations are already set by the various environments being used."),(0,a.mdx)("p",null,"Since environments are extensible, so are the build pipelines configured by them."),(0,a.mdx)("h2",null,"Build task"),(0,a.mdx)("p",null,"An example of a build-task is ",(0,a.mdx)("inlineCode",{parentName:"p"},"compile"),", it's written in the compiler aspect and is running on each one of the capsules created by the build process. build-tasks in many cases generate artifacts, in this case, the compiler generates ",(0,a.mdx)("inlineCode",{parentName:"p"},"dists")," files and write them on the isolated capsules. There artifacts files are used later for example when creating packages."),(0,a.mdx)("h2",null,"Pipelines"),(0,a.mdx)("p",null,"There are three pipelines: ",(0,a.mdx)("inlineCode",{parentName:"p"},"build"),", ",(0,a.mdx)("inlineCode",{parentName:"p"},"tag")," and ",(0,a.mdx)("inlineCode",{parentName:"p"},"snap"),"."),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit build")," runs the build pipeline."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit tag")," runs the build pipeline and then the tag pipeline."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit snap")," runs the build pipeline and then the snap pipeline.")),(0,a.mdx)("h2",null,"List Build Tasks"),(0,a.mdx)("p",null,"To get a list of all the tasks that will be running per pipeline on a specific component, run ",(0,a.mdx)("inlineCode",{parentName:"p"},"bit build --list-tasks <id>"),".\nHere is an example of the relevant part from the output:"),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre"},"➜  bit build --list-tasks ui/tooltip\nTasks List\nid:    teambit.design/ui/tooltip@0.0.347\nenvId: teambit.react/react\n\nBuild Pipeline Tasks:\nteambit.harmony/aspect:CoreExporter\nteambit.compilation/compiler:TSCompiler\nteambit.defender/tester:TestComponents\nteambit.pkg/pkg:PreparePackages\nteambit.pkg/pkg:PublishDryRun\nteambit.preview/preview:GeneratePreview\n\nTag Pipeline Tasks:\nteambit.harmony/application:build_ui_application\nteambit.pkg/pkg:PublishComponents\n\nSnap Pipeline Tasks:\n<N/A>\n")),(0,a.mdx)("h2",null,"Implementing Build Tasks"),(0,a.mdx)("p",null,"The ",(0,a.mdx)("inlineCode",{parentName:"p"},"BuildTask")," interface is a good start to understand how to implement a new build-task.\nWhen writing a build task, the ",(0,a.mdx)("inlineCode",{parentName:"p"},"Network")," object is passed and it includes the seeders capsules, as well as the entire graph including the dependencies.\nKeep in mind that the entire graph may contain components from other envs."),(0,a.mdx)("p",null,"Some tasks, such as, compiling in typescript and bundling with Webpack, need the entire graph.\nOthers, such as, Babel, need only the seeders. However, normally, the bundling is running after the compilation and it expects to have the dependencies compiled, so you might need the entire graph regardless."),(0,a.mdx)("h2",null,"Adding Tasks to a pipeline"),(0,a.mdx)("p",null,"There are two ways of adding tasks to the build pipeline."),(0,a.mdx)("ol",null,(0,a.mdx)("li",{parentName:"ol"},(0,a.mdx)("inlineCode",{parentName:"li"},"getBuildPipe()")," method of the env. (or ",(0,a.mdx)("inlineCode",{parentName:"li"},"getTagPipe()")," and ",(0,a.mdx)("inlineCode",{parentName:"li"},"getSnapPipe()"),")"),(0,a.mdx)("li",{parentName:"ol"},"registering to the slot via ",(0,a.mdx)("inlineCode",{parentName:"li"},"builder.registerBuildTask()"),". (or ",(0,a.mdx)("inlineCode",{parentName:"li"},"registerTagTask()")," and ",(0,a.mdx)("inlineCode",{parentName:"li"},"registerSnapTask()"),")")),(0,a.mdx)("p",null,"in the option #1, it's possible to determine the order. e.g. ",(0,a.mdx)("inlineCode",{parentName:"p"},"getBuildPipe() { return [taskA, taskB, taskC]; }"),"\nin the option #2, the register happens once the extension is loaded, so there is no way to put\none task before/after another task as of now."),(0,a.mdx)("h2",null,"Sequencing the build tasks"),(0,a.mdx)("p",null,"The Build Pipeline takes into consideration the following factors when deciding the order of which to execute each task:"),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("strong",{parentName:"li"},"Location"),": A task can be executed either at the start or end of the build pipeline. This can be explicitly configured by the task itself."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("strong",{parentName:"li"},"Dependencies"),": A task can depend on other tasks. That means, the dependencies must be completed successfully for all envs before this task starts. The dependencies are applicable inside a location and not across locations. This is configured by the task itself."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("strong",{parentName:"li"},"An environment's list of build tasks"),": This is the array of tasks as it is defined by an environment")),(0,a.mdx)("h2",null,"Executing the pipelines"),(0,a.mdx)("p",null,"Commands that trigger the build pipeline:"),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit build")," - runs the build pipeline on your local machine, for the entire workspace. The output data will not persist. - That is most often used for testing and debugging the build process."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit tag")," - runs the tag pipeline in addition to the build pipeline, before creating a new component release version. The output data will persist."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit snap")," - runs the snap pipeline in addition to the build pipeline. The output data will persist.")),(0,a.mdx)("p",null,"Build pipelines are determined by the environments in use. That means, in order to override the default pipeline, we need to create a new environment extension or modify an existing one."),(0,a.mdx)("p",null,"The example task below, shown being used by a customized environment, prints out the component name of every component handled by it. In addition to that, the task returns the component name as custom metadata to be logged and/or stored in the component tagged version. ",(0,a.mdx)("a",{parentName:"p",href:"https://github.com/teambit/harmony-build-examples"},"See a demo project here"),"."),(0,a.mdx)("blockquote",null,(0,a.mdx)("p",{parentName:"blockquote"},"Information returned by a build task will only persist if the build-pipeline was triggered by the 'hard-tag' command (",(0,a.mdx)("inlineCode",{parentName:"p"},"bit tag <component-id>"),").")),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="print-cmp-name-task.ts"',title:'"print-cmp-name-task.ts"'},"import { BuildTask, BuildContext, BuiltTaskResult, ComponentResult } from '@teambit/builder';\n\n// A task is an implementation of 'BuildTask' provided by the 'builder' aspect\nexport class PrintCmpNameTask implements BuildTask {\n  // The constructor leaves these properties up to the hands of the environment using this task\n  constructor(readonly aspectId: string, readonly name: string) {}\n\n  // This is where the task logic is placed. It will be executed by the build pipeline\n  async execute(context: BuildContext): Promise<BuiltTaskResult> {\n    const componentsResults: ComponentResult[] = [];\n\n    // Go through every isolated component instance\n    context.capsuleNetwork.seedersCapsules.forEach((capsule) => {\n      console.log(`The current component name is: ${capsule.component.id.name}`);\n\n      componentsResults.push({\n        component: capsule.component,\n        metadata: { customProp: capsule.component.id.name },\n      });\n    });\n    return {\n      // An array of component objects, enriched with additional data produced by the task\n      componentsResults,\n    };\n  }\n}\n")),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="customized-react.extension.ts"',title:'"customized-react.extension.ts"'},"import { EnvsMain, EnvsAspect } from '@teambit/envs';\nimport { ReactAspect, ReactMain } from '@teambit/react';\n\n// Import the task\nimport { PrintCmpNameTask } from './print-cmp-name-task';\n\nexport class CustomReact {\n  constructor(private react: ReactMain) {}\n\n  static dependencies: any = [EnvsAspect, ReactAspect];\n\n  static async provider([envs, react]: [EnvsMain, ReactMain]) {\n    // Get the environment's default build pipeline\n    const reactPipe = react.env.getBuildPipe();\n\n    // Add the custom task to the end of the build tasks sequence.\n    // Provide the task with the component ID of the extension using it.\n    // Provide the ask with a name.\n    const tasks = [...reactPipe, new PrintCompTask('extensions/custom-react', 'PrintCmpNameTask')];\n\n    // Create a new environment by merging these configurations with the env's default ones\n    const customReactEnv = react.compose([react.overrideBuildPipe(tasks)]);\n\n    // register the extension as an environment\n    envs.registerEnv(customReactEnv);\n    return new CustomReact(react);\n  }\n}\n")),(0,a.mdx)("h2",null,"Positioning a build task in the pipeline"),(0,a.mdx)("p",null,"A build task is positioned in the build pipeline sequence either by overriding the entire ",(0,a.mdx)("em",{parentName:"p"},"customizable")," pipeline or, by registering it to a location in the pipeline using the designated builder slot."),(0,a.mdx)("h3",null,"Override the build pipeline sequence"),(0,a.mdx)("p",null,"This methodology leaves the task completely agnostic as to its position in the build pipeline. Instead, the task position is determined by the environment using the ",(0,a.mdx)("inlineCode",{parentName:"p"},"getBuildPipe")," Environment Handler."),(0,a.mdx)("p",null,"The example above shows the React environment ",(0,a.mdx)("inlineCode",{parentName:"p"},"overrideBuildPipe")," method being used to override its default pipeline. This method uses the ",(0,a.mdx)("inlineCode",{parentName:"p"},"getBuildPipe()")," Environment Handler, internally."),(0,a.mdx)("h3",null,"Append to the start or end of the pipeline, in relation to other tasks"),(0,a.mdx)("p",null,"This methodology places the task at the start or end of the build pipeline sequence, and lists all other tasks needed to run successfully before it is executed."),(0,a.mdx)("p",null,"Example:"),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="print-cmp-name-task.ts"',title:'"print-cmp-name-task.ts"'},"import { BuildTask, BuildContext, BuiltTaskResult, ComponentResult } from '@teambit/builder';\n\nexport class PrintCmpNameTask implements BuildTask {\n  constructor(readonly aspectId: string, readonly name: string) {}\n\n  // Place the task at the end of the build pipeline\n  readonly location = 'end';\n\n  // Run this task only after the '@teambit/preview' task is completed successfully\n  readonly dependencies = ['@teambit/preview'];\n\n  async execute(context: BuildContext): Promise<BuiltTaskResult> {\n    const componentsResults: ComponentResult[] = [];\n    context.capsuleNetwork.seedersCapsules.forEach((capsule) => {\n      console.log(`The current component name is: ${capsule.component.id.name}`);\n\n      componentsResults.push({\n        component: capsule.component,\n        metadata: { customProp: capsule.component.id.name },\n      });\n    });\n    return {\n      componentsResults,\n    };\n  }\n}\n")),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="customized-react.extension.ts"',title:'"customized-react.extension.ts"'},"import { EnvsMain, EnvsAspect } from '@teambit/envs';\nimport { ReactAspect, ReactMain } from '@teambit/react';\nimport { BuilderMain } from '@teambit/builder';\n\n// Import the task (in reality, it should be an independent component)\nimport { PrintCmpNameTask } from './print-cmp-name-task';\n\nexport class CustomReact {\n  constructor(private react: ReactMain) {}\n\n  static dependencies: any = [EnvsAspect, ReactAspect];\n\n  // Inject the builder\n  static async provider([envs, react, builder]: [EnvsMain, ReactMain, BuilderMain]) {\n    // Register this task using the registration slot, made available by the 'builder'.\n    // Here, the environment has no say in the positioning of the task\n    builder.registerBuildTasks([new ExampleTask('extensions/custom-react', 'PrintCmpNameTask')]);\n\n    const customReactEnv = react.compose([]);\n\n    envs.registerEnv(customReactEnv);\n    return new CustomReact(react);\n  }\n}\n")),(0,a.mdx)("h2",null,"A build task anatomy"),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"aspectId")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"aspectId: string"),(0,a.mdx)("br",null),"\nThe component ID of the environment using this task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"name")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"name: string")," ",(0,a.mdx)("br",null),"\nA name for this task. Only alphanumerical characters are allowed. PascalCase should be used as a convention.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"location")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"location?: 'start' | 'end'")," ",(0,a.mdx)("br",null),"\nThe section of the build-pipeline to which to append this task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"dependencies")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"dependencies?: string[]")," ",(0,a.mdx)("br",null),"\nAn list of tasks that must be completed before this task gets executed. ",(0,a.mdx)("br",null),"\nFor example ",(0,a.mdx)("inlineCode",{parentName:"p"},"dependencies = ['@teambit/preview']"),".")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"execute")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"execute(context: BuildContext): Promise<BuiltTaskResult>")," ",(0,a.mdx)("br",null),"\nThe execute method is where all the task logic is placed."),(0,a.mdx)("ul",{parentName:"li"},(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"context")," (argument) ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"context: BuildContext")," ",(0,a.mdx)("br",null),"\nThe context of the build pipeline. Use this object (provided by the build pipeline) to get information regarding all components handled by the build pipeline. ",(0,a.mdx)("br",null),(0,a.mdx)("br",null),"\nFor example, ",(0,a.mdx)("inlineCode",{parentName:"p"},"context.capsuleNetwork.seedersCapsules")," are models representing isolated instances of components handled by the build pipeline. These isolated instances are independent projects, generated in your local filesystem (by the build pipeline).")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"return")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"Promise<BuiltTaskResult>")," ",(0,a.mdx)("br",null),"\nA ",(0,a.mdx)("inlineCode",{parentName:"p"},"context")," method returns an object with data regarding the build task process, additional data regarding the components handled by the task and, if available, data regarding the different artifacts generated by this task.",(0,a.mdx)("br",null),"\nThe returned object has the following attributes:"),(0,a.mdx)("ul",{parentName:"li"},(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"componentsResults")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"componentsResults: ComponentResult[]"),"\nAn array of objects, each containing an instance of an object handled the task and additional information regarding the process and the component itself.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"component")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"component: Component")," ",(0,a.mdx)("br",null),"\nAn instance of the component handled by the task (see the above task example).")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"metadata")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"metadata?: { [key: string]: Serializable }")," ",(0,a.mdx)("br",null),"\nComponent metadata generated during the build task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"errors")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"errors?: Array<Error | string>")," ",(0,a.mdx)("br",null),"\nBuild task errors. A task returning errors will abort the build pipeline and log the returned errors.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"warnings")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"warnings?: string[]")," ",(0,a.mdx)("br",null),"\nwarnings generated throughout the build task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"startTime")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"startTime?: number")," ",(0,a.mdx)("br",null),"\nA timestamp (in milliseconds) of when the task started")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"endTime")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"endTime?: number")," ",(0,a.mdx)("br",null),"\nA timestamp (in milliseconds) of when the task ended")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"artifacts")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"artifacts?: ArtifactDefinition[]")," ",(0,a.mdx)("br",null),"\nAn array of artifact definitions to generate after a successful build")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"name")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"name: string")," ",(0,a.mdx)("br",null),"\nThe name of the artifact. ",(0,a.mdx)("br",null),"\nFor example, a project might utilize two different artifacts for the same typescript compiler, one that generates ES5 files and another for ES6. This prop helps to distinguish between the two.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"generatedBy")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"generatedBy?: string;")," ",(0,a.mdx)("br",null),"\nId of the component that generated this artifact.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"description")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"description?: string")," ",(0,a.mdx)("br",null),"\nA description of the artifact. ",(0,a.mdx)("br",null))),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"globPatterns")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"globPatterns: string[]")," ",(0,a.mdx)("br",null),"\nGlob patterns of files to include upon artifact creation. Minimatch is used to match the patterns. ",(0,a.mdx)("br",null),"\nFor example, ",(0,a.mdx)("inlineCode",{parentName:"p"},"['*.ts', '!foo.ts']")," matches all ts files but ignores ",(0,a.mdx)("inlineCode",{parentName:"p"},"foo.ts"),".")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"rootDir")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"rootDir?: string")," ",(0,a.mdx)("br",null),"\nDefines the root directory of the artifacts in the capsule file system. The rootDir must be unique for every artifact, otherwise data might be overridden.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"dirPrefix")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"dirPrefix?: string")," ",(0,a.mdx)("br",null),"\nAdds a directory prefix for all artifact files.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"context")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"context?: 'component' | 'env'")," ",(0,a.mdx)("br",null),"\nDetermine the context of the artifact. The default artifact context is ",(0,a.mdx)("inlineCode",{parentName:"p"},"component"),". ",(0,a.mdx)("inlineCode",{parentName:"p"},"env"),' is useful when the same file is generated for all components, for example, a "preview" task may create the same webpack file for all components of that env.')),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"storageResolver")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"storageResolver?: string")," ",(0,a.mdx)("br",null),"\nUsed to replace the location of the stored artifacts. The default resolver persists artifacts on scope (that's not recommended for large files).")))))),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"preBuild")," (advanced) ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"preBuild?(context: BuildContext): Promise<void>")," ",(0,a.mdx)("br",null),"\nRuns before the build pipeline has started. This method should only be used when preparations are needed to be done on all environments before the build starts.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"postBuild")," (advanced) ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"postBuild?(context: BuildContext, tasksResults: TaskResultsList): Promise<void>")," ",(0,a.mdx)("br",null),"\nRuns after the dependencies were completed for all environments."))))}u.__bit_component=i,u.isMDXComponent=!0},37606:(e,n,t)=>{Object.defineProperty(n,"M",{enumerable:!0,get:function(){return i.default}});var i=a(t(77456));function a(e){return e&&e.__esModule?e:{default:e}}a.__bit_component={id:"teambit.pipelines/aspect-docs/builder@0.0.167",homepage:"https://bit.cloud/teambit/pipelines/aspect-docs/builder",exported:!0}},80282:(e,n,t)=>{var i={id:"teambit.pipelines/builder@1.0.234",homepage:"https://bit.cloud/teambit/pipelines/builder",exported:!0};function a(){const e=r(t(41594));return a=function(){return e},e}function r(e){return e&&e.__esModule?e:{default:e}}Object.defineProperty(n,"__esModule",{value:!0}),n.Logo=void 0,a.__bit_component=i,r.__bit_component=i;const o=()=>a().default.createElement("div",{style:{height:"100%",display:"flex",justifyContent:"center"}},a().default.createElement("img",{style:{width:70},src:"https://static.bit.dev/extensions-icons/builder.svg"}));o.__bit_component=i,n.Logo=o},5016:e=>{e.exports=MdxJsReact},41594:e=>{e.exports=React}},n={};function t(i){var a=n[i];if(void 0!==a)return a.exports;var r=n[i]={exports:{}};return e[i](r,r.exports,t),r.exports}t.d=(e,n)=>{for(var i in n)t.o(n,i)&&!t.o(e,i)&&Object.defineProperty(e,i,{enumerable:!0,get:n[i]})},t.o=(e,n)=>Object.prototype.hasOwnProperty.call(e,n),t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var i={};return(()=>{t.r(i),t.d(i,{compositions:()=>u,compositions_metadata:()=>h,overview:()=>c});var e={};t.r(e),t.d(e,{default:()=>m});var n=t(80282),a=(t(41594),t(5016));const r=TeambitMdxUiMdxScopeContext;var o=t(37606),s=["components"];function l(){return l=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var t=arguments[n];for(var i in t)Object.prototype.hasOwnProperty.call(t,i)&&(e[i]=t[i])}return e},l.apply(this,arguments)}var d={},p="wrapper";function m(e){var n=e.components,t=function(e,n){if(null==e)return{};var t,i,a=function(e,n){if(null==e)return{};var t,i,a={},r=Object.keys(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||(a[t]=e[t]);return a}(e,n);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}(e,s);return(0,a.mdx)(p,l({},d,t,{components:n,mdxType:"MDXLayout"}),(0,a.mdx)(r.MDXScopeProvider,{components:{Builder:o.M},mdxType:"MDXScopeProvider"},(0,a.mdx)(o.M,{mdxType:"Builder"})))}m.isMDXComponent=!0;const u=[n],c=[e],h={compositions:[{displayName:"Logo",identifier:"Logo"}]}})(),i})()));
+!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports["teambit.pipelines/builder-preview"]=n():e["teambit.pipelines/builder-preview"]=n()}(self,(()=>(()=>{"use strict";var e={77456:(e,n,t)=>{var i={id:"teambit.pipelines/aspect-docs/builder@0.0.167",homepage:"https://bit.cloud/teambit/pipelines/aspect-docs/builder",exported:!0};Object.defineProperty(n,"__esModule",{value:!0}),n.default=u,o(t(41594));var a=t(5016),r=["components"];function o(e){return e&&e.__esModule?e:{default:e}}function s(){return s=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var t=arguments[n];for(var i in t)Object.prototype.hasOwnProperty.call(t,i)&&(e[i]=t[i])}return e},s.apply(this,arguments)}function l(e,n){if(null==e)return{};var t,i,a=d(e,n);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}function d(e,n){if(null==e)return{};var t,i,a={},r=Object.keys(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||(a[t]=e[t]);return a}o.__bit_component=i,s.__bit_component=i,l.__bit_component=i,d.__bit_component=i;var p={},m="wrapper";function u(e){var n=e.components,t=l(e,r);return(0,a.mdx)(m,s({},p,t,{components:n,mdxType:"MDXLayout"}),(0,a.mdx)("h2",null,"Background"),(0,a.mdx)("p",null,"Bit's build process is an extensible CI for independent components. It validates a component is not dependent on its context (the workspace), tests it, and generates all artifacts necessary for it to be viewed and consumed as an independent module (its distributable code, bundled preview, etc.)."),(0,a.mdx)("p",null,"The Build Pipeline is an Environment Service responsible for sequencing and executing a component's Build Tasks. As mentioned earlier, these tasks are performed on a component only after it's been isolated from the rest of the workspace."),(0,a.mdx)("p",null,"A component's default series of Build Tasks is composed of tasks set by Bit and by its environment."),(0,a.mdx)("h2",null,"Isolated builds"),(0,a.mdx)("p",null,"Components authored in a Bit workspace are created to be completely portable, and thus independent. To address that, the build process starts by creating a component 'capsule' which is an isolated instance of a component, generated in a separate directory in your filesystem."),(0,a.mdx)("p",null,'As part of the capsule creation, all packages listed as dependencies of that component will be installed. This step is necessary to validate there are no dependency-graph issues (a component that is not totally isolated will be able to use packages installed in parent directories in your workspace, by other components. This will translate into a "false positive" result when testing for dependency-graph issues in a non-isolated location).'),(0,a.mdx)("h2",null,"Incremental builds"),(0,a.mdx)("p",null,'When a component "goes through" the build pipeline, all of its dependencies are built as well. If a dependency has not changed since its last build, the build process will use its artifacts from the previous build (and will not process it again). This optimization to the build process supplements the "innate optimization" that naturally comes from developing (and building) independent components instead of a single monolithic codebase.'),(0,a.mdx)("h2",null,"Environment-specific builds"),(0,a.mdx)("p",null,"Each Bit environment determines its own build pipeline. That means, a single workspace that uses multiple environments will run a different set of build tasks on different components depending on their associated environment. This is another Bit feature that enables seamless transitioning between different development environments, all in the same workspace. It also makes it much easier to integrate the Build Pipeline in your (remote) CI, as it only requires executing the build step - all other per-component build configurations are already set by the various environments being used."),(0,a.mdx)("p",null,"Since environments are extensible, so are the build pipelines configured by them."),(0,a.mdx)("h2",null,"Build task"),(0,a.mdx)("p",null,"An example of a build-task is ",(0,a.mdx)("inlineCode",{parentName:"p"},"compile"),", it's written in the compiler aspect and is running on each one of the capsules created by the build process. build-tasks in many cases generate artifacts, in this case, the compiler generates ",(0,a.mdx)("inlineCode",{parentName:"p"},"dists")," files and write them on the isolated capsules. There artifacts files are used later for example when creating packages."),(0,a.mdx)("h2",null,"Pipelines"),(0,a.mdx)("p",null,"There are three pipelines: ",(0,a.mdx)("inlineCode",{parentName:"p"},"build"),", ",(0,a.mdx)("inlineCode",{parentName:"p"},"tag")," and ",(0,a.mdx)("inlineCode",{parentName:"p"},"snap"),"."),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit build")," runs the build pipeline."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit tag")," runs the build pipeline and then the tag pipeline."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit snap")," runs the build pipeline and then the snap pipeline.")),(0,a.mdx)("h2",null,"List Build Tasks"),(0,a.mdx)("p",null,"To get a list of all the tasks that will be running per pipeline on a specific component, run ",(0,a.mdx)("inlineCode",{parentName:"p"},"bit build --list-tasks <id>"),".\nHere is an example of the relevant part from the output:"),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre"},"➜  bit build --list-tasks ui/tooltip\nTasks List\nid:    teambit.design/ui/tooltip@0.0.347\nenvId: teambit.react/react\n\nBuild Pipeline Tasks:\nteambit.harmony/aspect:CoreExporter\nteambit.compilation/compiler:TSCompiler\nteambit.defender/tester:TestComponents\nteambit.pkg/pkg:PreparePackages\nteambit.pkg/pkg:PublishDryRun\nteambit.preview/preview:GeneratePreview\n\nTag Pipeline Tasks:\nteambit.harmony/application:build_ui_application\nteambit.pkg/pkg:PublishComponents\n\nSnap Pipeline Tasks:\n<N/A>\n")),(0,a.mdx)("h2",null,"Implementing Build Tasks"),(0,a.mdx)("p",null,"The ",(0,a.mdx)("inlineCode",{parentName:"p"},"BuildTask")," interface is a good start to understand how to implement a new build-task.\nWhen writing a build task, the ",(0,a.mdx)("inlineCode",{parentName:"p"},"Network")," object is passed and it includes the seeders capsules, as well as the entire graph including the dependencies.\nKeep in mind that the entire graph may contain components from other envs."),(0,a.mdx)("p",null,"Some tasks, such as, compiling in typescript and bundling with Webpack, need the entire graph.\nOthers, such as, Babel, need only the seeders. However, normally, the bundling is running after the compilation and it expects to have the dependencies compiled, so you might need the entire graph regardless."),(0,a.mdx)("h2",null,"Adding Tasks to a pipeline"),(0,a.mdx)("p",null,"There are two ways of adding tasks to the build pipeline."),(0,a.mdx)("ol",null,(0,a.mdx)("li",{parentName:"ol"},(0,a.mdx)("inlineCode",{parentName:"li"},"getBuildPipe()")," method of the env. (or ",(0,a.mdx)("inlineCode",{parentName:"li"},"getTagPipe()")," and ",(0,a.mdx)("inlineCode",{parentName:"li"},"getSnapPipe()"),")"),(0,a.mdx)("li",{parentName:"ol"},"registering to the slot via ",(0,a.mdx)("inlineCode",{parentName:"li"},"builder.registerBuildTask()"),". (or ",(0,a.mdx)("inlineCode",{parentName:"li"},"registerTagTask()")," and ",(0,a.mdx)("inlineCode",{parentName:"li"},"registerSnapTask()"),")")),(0,a.mdx)("p",null,"in the option #1, it's possible to determine the order. e.g. ",(0,a.mdx)("inlineCode",{parentName:"p"},"getBuildPipe() { return [taskA, taskB, taskC]; }"),"\nin the option #2, the register happens once the extension is loaded, so there is no way to put\none task before/after another task as of now."),(0,a.mdx)("h2",null,"Sequencing the build tasks"),(0,a.mdx)("p",null,"The Build Pipeline takes into consideration the following factors when deciding the order of which to execute each task:"),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("strong",{parentName:"li"},"Location"),": A task can be executed either at the start or end of the build pipeline. This can be explicitly configured by the task itself."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("strong",{parentName:"li"},"Dependencies"),": A task can depend on other tasks. That means, the dependencies must be completed successfully for all envs before this task starts. The dependencies are applicable inside a location and not across locations. This is configured by the task itself."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("strong",{parentName:"li"},"An environment's list of build tasks"),": This is the array of tasks as it is defined by an environment")),(0,a.mdx)("h2",null,"Executing the pipelines"),(0,a.mdx)("p",null,"Commands that trigger the build pipeline:"),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit build")," - runs the build pipeline on your local machine, for the entire workspace. The output data will not persist. - That is most often used for testing and debugging the build process."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit tag")," - runs the tag pipeline in addition to the build pipeline, before creating a new component release version. The output data will persist."),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("inlineCode",{parentName:"li"},"bit snap")," - runs the snap pipeline in addition to the build pipeline. The output data will persist.")),(0,a.mdx)("p",null,"Build pipelines are determined by the environments in use. That means, in order to override the default pipeline, we need to create a new environment extension or modify an existing one."),(0,a.mdx)("p",null,"The example task below, shown being used by a customized environment, prints out the component name of every component handled by it. In addition to that, the task returns the component name as custom metadata to be logged and/or stored in the component tagged version. ",(0,a.mdx)("a",{parentName:"p",href:"https://github.com/teambit/harmony-build-examples"},"See a demo project here"),"."),(0,a.mdx)("blockquote",null,(0,a.mdx)("p",{parentName:"blockquote"},"Information returned by a build task will only persist if the build-pipeline was triggered by the 'hard-tag' command (",(0,a.mdx)("inlineCode",{parentName:"p"},"bit tag <component-id>"),").")),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="print-cmp-name-task.ts"',title:'"print-cmp-name-task.ts"'},"import { BuildTask, BuildContext, BuiltTaskResult, ComponentResult } from '@teambit/builder';\n\n// A task is an implementation of 'BuildTask' provided by the 'builder' aspect\nexport class PrintCmpNameTask implements BuildTask {\n  // The constructor leaves these properties up to the hands of the environment using this task\n  constructor(readonly aspectId: string, readonly name: string) {}\n\n  // This is where the task logic is placed. It will be executed by the build pipeline\n  async execute(context: BuildContext): Promise<BuiltTaskResult> {\n    const componentsResults: ComponentResult[] = [];\n\n    // Go through every isolated component instance\n    context.capsuleNetwork.seedersCapsules.forEach((capsule) => {\n      console.log(`The current component name is: ${capsule.component.id.name}`);\n\n      componentsResults.push({\n        component: capsule.component,\n        metadata: { customProp: capsule.component.id.name },\n      });\n    });\n    return {\n      // An array of component objects, enriched with additional data produced by the task\n      componentsResults,\n    };\n  }\n}\n")),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="customized-react.extension.ts"',title:'"customized-react.extension.ts"'},"import { EnvsMain, EnvsAspect } from '@teambit/envs';\nimport { ReactAspect, ReactMain } from '@teambit/react';\n\n// Import the task\nimport { PrintCmpNameTask } from './print-cmp-name-task';\n\nexport class CustomReact {\n  constructor(private react: ReactMain) {}\n\n  static dependencies: any = [EnvsAspect, ReactAspect];\n\n  static async provider([envs, react]: [EnvsMain, ReactMain]) {\n    // Get the environment's default build pipeline\n    const reactPipe = react.env.getBuildPipe();\n\n    // Add the custom task to the end of the build tasks sequence.\n    // Provide the task with the component ID of the extension using it.\n    // Provide the ask with a name.\n    const tasks = [...reactPipe, new PrintCompTask('extensions/custom-react', 'PrintCmpNameTask')];\n\n    // Create a new environment by merging these configurations with the env's default ones\n    const customReactEnv = react.compose([react.overrideBuildPipe(tasks)]);\n\n    // register the extension as an environment\n    envs.registerEnv(customReactEnv);\n    return new CustomReact(react);\n  }\n}\n")),(0,a.mdx)("h2",null,"Positioning a build task in the pipeline"),(0,a.mdx)("p",null,"A build task is positioned in the build pipeline sequence either by overriding the entire ",(0,a.mdx)("em",{parentName:"p"},"customizable")," pipeline or, by registering it to a location in the pipeline using the designated builder slot."),(0,a.mdx)("h3",null,"Override the build pipeline sequence"),(0,a.mdx)("p",null,"This methodology leaves the task completely agnostic as to its position in the build pipeline. Instead, the task position is determined by the environment using the ",(0,a.mdx)("inlineCode",{parentName:"p"},"getBuildPipe")," Environment Handler."),(0,a.mdx)("p",null,"The example above shows the React environment ",(0,a.mdx)("inlineCode",{parentName:"p"},"overrideBuildPipe")," method being used to override its default pipeline. This method uses the ",(0,a.mdx)("inlineCode",{parentName:"p"},"getBuildPipe()")," Environment Handler, internally."),(0,a.mdx)("h3",null,"Append to the start or end of the pipeline, in relation to other tasks"),(0,a.mdx)("p",null,"This methodology places the task at the start or end of the build pipeline sequence, and lists all other tasks needed to run successfully before it is executed."),(0,a.mdx)("p",null,"Example:"),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="print-cmp-name-task.ts"',title:'"print-cmp-name-task.ts"'},"import { BuildTask, BuildContext, BuiltTaskResult, ComponentResult } from '@teambit/builder';\n\nexport class PrintCmpNameTask implements BuildTask {\n  constructor(readonly aspectId: string, readonly name: string) {}\n\n  // Place the task at the end of the build pipeline\n  readonly location = 'end';\n\n  // Run this task only after the '@teambit/preview' task is completed successfully\n  readonly dependencies = ['@teambit/preview'];\n\n  async execute(context: BuildContext): Promise<BuiltTaskResult> {\n    const componentsResults: ComponentResult[] = [];\n    context.capsuleNetwork.seedersCapsules.forEach((capsule) => {\n      console.log(`The current component name is: ${capsule.component.id.name}`);\n\n      componentsResults.push({\n        component: capsule.component,\n        metadata: { customProp: capsule.component.id.name },\n      });\n    });\n    return {\n      componentsResults,\n    };\n  }\n}\n")),(0,a.mdx)("pre",null,(0,a.mdx)("code",{parentName:"pre",className:"language-ts",metastring:'title="customized-react.extension.ts"',title:'"customized-react.extension.ts"'},"import { EnvsMain, EnvsAspect } from '@teambit/envs';\nimport { ReactAspect, ReactMain } from '@teambit/react';\nimport { BuilderMain } from '@teambit/builder';\n\n// Import the task (in reality, it should be an independent component)\nimport { PrintCmpNameTask } from './print-cmp-name-task';\n\nexport class CustomReact {\n  constructor(private react: ReactMain) {}\n\n  static dependencies: any = [EnvsAspect, ReactAspect];\n\n  // Inject the builder\n  static async provider([envs, react, builder]: [EnvsMain, ReactMain, BuilderMain]) {\n    // Register this task using the registration slot, made available by the 'builder'.\n    // Here, the environment has no say in the positioning of the task\n    builder.registerBuildTasks([new ExampleTask('extensions/custom-react', 'PrintCmpNameTask')]);\n\n    const customReactEnv = react.compose([]);\n\n    envs.registerEnv(customReactEnv);\n    return new CustomReact(react);\n  }\n}\n")),(0,a.mdx)("h2",null,"A build task anatomy"),(0,a.mdx)("ul",null,(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"aspectId")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"aspectId: string"),(0,a.mdx)("br",null),"\nThe component ID of the environment using this task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"name")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"name: string")," ",(0,a.mdx)("br",null),"\nA name for this task. Only alphanumerical characters are allowed. PascalCase should be used as a convention.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"location")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"location?: 'start' | 'end'")," ",(0,a.mdx)("br",null),"\nThe section of the build-pipeline to which to append this task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"dependencies")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"dependencies?: string[]")," ",(0,a.mdx)("br",null),"\nAn list of tasks that must be completed before this task gets executed. ",(0,a.mdx)("br",null),"\nFor example ",(0,a.mdx)("inlineCode",{parentName:"p"},"dependencies = ['@teambit/preview']"),".")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"execute")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"execute(context: BuildContext): Promise<BuiltTaskResult>")," ",(0,a.mdx)("br",null),"\nThe execute method is where all the task logic is placed."),(0,a.mdx)("ul",{parentName:"li"},(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"context")," (argument) ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"context: BuildContext")," ",(0,a.mdx)("br",null),"\nThe context of the build pipeline. Use this object (provided by the build pipeline) to get information regarding all components handled by the build pipeline. ",(0,a.mdx)("br",null),(0,a.mdx)("br",null),"\nFor example, ",(0,a.mdx)("inlineCode",{parentName:"p"},"context.capsuleNetwork.seedersCapsules")," are models representing isolated instances of components handled by the build pipeline. These isolated instances are independent projects, generated in your local filesystem (by the build pipeline).")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"return")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"Promise<BuiltTaskResult>")," ",(0,a.mdx)("br",null),"\nA ",(0,a.mdx)("inlineCode",{parentName:"p"},"context")," method returns an object with data regarding the build task process, additional data regarding the components handled by the task and, if available, data regarding the different artifacts generated by this task.",(0,a.mdx)("br",null),"\nThe returned object has the following attributes:"),(0,a.mdx)("ul",{parentName:"li"},(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"componentsResults")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"componentsResults: ComponentResult[]"),"\nAn array of objects, each containing an instance of an object handled the task and additional information regarding the process and the component itself.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"component")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"component: Component")," ",(0,a.mdx)("br",null),"\nAn instance of the component handled by the task (see the above task example).")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"metadata")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"metadata?: { [key: string]: Serializable }")," ",(0,a.mdx)("br",null),"\nComponent metadata generated during the build task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"errors")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"errors?: Array<Error | string>")," ",(0,a.mdx)("br",null),"\nBuild task errors. A task returning errors will abort the build pipeline and log the returned errors.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"warnings")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"warnings?: string[]")," ",(0,a.mdx)("br",null),"\nwarnings generated throughout the build task.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"startTime")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"startTime?: number")," ",(0,a.mdx)("br",null),"\nA timestamp (in milliseconds) of when the task started")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"endTime")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"endTime?: number")," ",(0,a.mdx)("br",null),"\nA timestamp (in milliseconds) of when the task ended")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"artifacts")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"artifacts?: ArtifactDefinition[]")," ",(0,a.mdx)("br",null),"\nAn array of artifact definitions to generate after a successful build")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"name")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"name: string")," ",(0,a.mdx)("br",null),"\nThe name of the artifact. ",(0,a.mdx)("br",null),"\nFor example, a project might utilize two different artifacts for the same typescript compiler, one that generates ES5 files and another for ES6. This prop helps to distinguish between the two.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"generatedBy")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"generatedBy?: string;")," ",(0,a.mdx)("br",null),"\nId of the component that generated this artifact.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"description")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"description?: string")," ",(0,a.mdx)("br",null),"\nA description of the artifact. ",(0,a.mdx)("br",null))),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"globPatterns")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"globPatterns: string[]")," ",(0,a.mdx)("br",null),"\nGlob patterns of files to include upon artifact creation. Minimatch is used to match the patterns. ",(0,a.mdx)("br",null),"\nFor example, ",(0,a.mdx)("inlineCode",{parentName:"p"},"['*.ts', '!foo.ts']")," matches all ts files but ignores ",(0,a.mdx)("inlineCode",{parentName:"p"},"foo.ts"),".")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"rootDir")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"rootDir?: string")," ",(0,a.mdx)("br",null),"\nDefines the root directory of the artifacts in the capsule file system. The rootDir must be unique for every artifact, otherwise data might be overridden.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"dirPrefix")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"dirPrefix?: string")," ",(0,a.mdx)("br",null),"\nAdds a directory prefix for all artifact files.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"context")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"context?: 'component' | 'env'")," ",(0,a.mdx)("br",null),"\nDetermine the context of the artifact. The default artifact context is ",(0,a.mdx)("inlineCode",{parentName:"p"},"component"),". ",(0,a.mdx)("inlineCode",{parentName:"p"},"env"),' is useful when the same file is generated for all components, for example, a "preview" task may create the same webpack file for all components of that env.')),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"storageResolver")," ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"storageResolver?: string")," ",(0,a.mdx)("br",null),"\nUsed to replace the location of the stored artifacts. The default resolver persists artifacts on scope (that's not recommended for large files).")))))),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"preBuild")," (advanced) ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"preBuild?(context: BuildContext): Promise<void>")," ",(0,a.mdx)("br",null),"\nRuns before the build pipeline has started. This method should only be used when preparations are needed to be done on all environments before the build starts.")),(0,a.mdx)("li",{parentName:"ul"},(0,a.mdx)("p",{parentName:"li"},(0,a.mdx)("strong",{parentName:"p"},"postBuild")," (advanced) ",(0,a.mdx)("br",null),"\n",(0,a.mdx)("inlineCode",{parentName:"p"},"postBuild?(context: BuildContext, tasksResults: TaskResultsList): Promise<void>")," ",(0,a.mdx)("br",null),"\nRuns after the dependencies were completed for all environments."))))}u.__bit_component=i,u.isMDXComponent=!0},37606:(e,n,t)=>{Object.defineProperty(n,"M",{enumerable:!0,get:function(){return i.default}});var i=a(t(77456));function a(e){return e&&e.__esModule?e:{default:e}}a.__bit_component={id:"teambit.pipelines/aspect-docs/builder@0.0.167",homepage:"https://bit.cloud/teambit/pipelines/aspect-docs/builder",exported:!0}},79437:(e,n,t)=>{var i={id:"teambit.pipelines/builder@1.0.237",homepage:"https://bit.cloud/teambit/pipelines/builder",exported:!0};function a(){const e=r(t(41594));return a=function(){return e},e}function r(e){return e&&e.__esModule?e:{default:e}}Object.defineProperty(n,"__esModule",{value:!0}),n.Logo=void 0,a.__bit_component=i,r.__bit_component=i;const o=()=>a().default.createElement("div",{style:{height:"100%",display:"flex",justifyContent:"center"}},a().default.createElement("img",{style:{width:70},src:"https://static.bit.dev/extensions-icons/builder.svg"}));o.__bit_component=i,n.Logo=o},5016:e=>{e.exports=MdxJsReact},41594:e=>{e.exports=React}},n={};function t(i){var a=n[i];if(void 0!==a)return a.exports;var r=n[i]={exports:{}};return e[i](r,r.exports,t),r.exports}t.d=(e,n)=>{for(var i in n)t.o(n,i)&&!t.o(e,i)&&Object.defineProperty(e,i,{enumerable:!0,get:n[i]})},t.o=(e,n)=>Object.prototype.hasOwnProperty.call(e,n),t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var i={};return(()=>{t.r(i),t.d(i,{compositions:()=>u,compositions_metadata:()=>h,overview:()=>c});var e={};t.r(e),t.d(e,{default:()=>m});var n=t(79437),a=(t(41594),t(5016));const r=TeambitMdxUiMdxScopeContext;var o=t(37606),s=["components"];function l(){return l=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var t=arguments[n];for(var i in t)Object.prototype.hasOwnProperty.call(t,i)&&(e[i]=t[i])}return e},l.apply(this,arguments)}var d={},p="wrapper";function m(e){var n=e.components,t=function(e,n){if(null==e)return{};var t,i,a=function(e,n){if(null==e)return{};var t,i,a={},r=Object.keys(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||(a[t]=e[t]);return a}(e,n);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i<r.length;i++)t=r[i],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}(e,s);return(0,a.mdx)(p,l({},d,t,{components:n,mdxType:"MDXLayout"}),(0,a.mdx)(r.MDXScopeProvider,{components:{Builder:o.M},mdxType:"MDXScopeProvider"},(0,a.mdx)(o.M,{mdxType:"Builder"})))}m.isMDXComponent=!0;const u=[n],c=[e],h={compositions:[{displayName:"Logo",identifier:"Logo"}]}})(),i})()));

package/artifacts/schema.json

@@ -1064,7 +1064,7 @@
                 "_legacy": {
                   "scope": "teambit.pipelines",
                   "name": "builder",
-                  "version": "1.0.234"
+                  "version": "1.0.237"
                 },
                 "_scope": "teambit.pipelines"
               }
@@ -7396,7 +7396,7 @@
                 "_legacy": {
                   "scope": "teambit.pipelines",
                   "name": "builder",
-                  "version": "1.0.234"
+                  "version": "1.0.237"
                 },
                 "_scope": "teambit.pipelines"
               }
@@ -8138,7 +8138,7 @@
         "__schema": "ClassSchema",
         "location": {
           "filePath": "task-results-list.ts",
-          "line": 8,
+          "line": 9,
           "character": 1
         },
         "signature": "class TaskResultsList",
@@ -8148,17 +8148,17 @@
             "__schema": "ConstructorSchema",
             "location": {
               "filePath": "task-results-list.ts",
-              "line": 9,
+              "line": 10,
               "character": 3
             },
-            "signature": "constructor TaskResultsList(tasksQueue: TasksQueue, tasksResults: TaskResults[], capsuleRootDir: string): TaskResultsList",
+            "signature": "constructor TaskResultsList(tasksQueue: TasksQueue, tasksResults: TaskResults[], capsuleRootDir: string, logger: Logger): TaskResultsList",
             "name": "constructor",
             "params": [
               {
                 "__schema": "ParameterSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 10,
+                  "line": 11,
                   "character": 5
                 },
                 "name": "tasksQueue",
@@ -8166,7 +8166,7 @@
                   "__schema": "TypeRefSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 10,
+                    "line": 11,
                     "character": 24
                   },
                   "name": "TasksQueue",
@@ -8179,7 +8179,7 @@
                 "__schema": "ParameterSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 14,
+                  "line": 15,
                   "character": 5
                 },
                 "name": "tasksResults",
@@ -8187,14 +8187,14 @@
                   "__schema": "TypeArraySchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 14,
+                    "line": 15,
                     "character": 26
                   },
                   "type": {
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "task-results-list.ts",
-                      "line": 14,
+                      "line": 15,
                       "character": 26
                     },
                     "name": "TaskResults"
@@ -8207,7 +8207,7 @@
                 "__schema": "ParameterSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 16,
+                  "line": 17,
                   "character": 5
                 },
                 "name": "capsuleRootDir",
@@ -8215,20 +8215,44 @@
                   "__schema": "KeywordTypeSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 16,
+                    "line": 17,
                     "character": 28
                   },
                   "name": "string"
                 },
                 "isOptional": false,
                 "isSpread": false
+              },
+              {
+                "__schema": "ParameterSchema",
+                "location": {
+                  "filePath": "task-results-list.ts",
+                  "line": 19,
+                  "character": 5
+                },
+                "name": "logger",
+                "type": {
+                  "__schema": "TypeRefSchema",
+                  "location": {
+                    "filePath": "task-results-list.ts",
+                    "line": 19,
+                    "character": 21
+                  },
+                  "name": "Logger",
+                  "componentId": {
+                    "scope": "teambit.harmony",
+                    "name": "logger"
+                  }
+                },
+                "isOptional": false,
+                "isSpread": false
               }
             ],
             "returnType": {
               "__schema": "ThisTypeSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 8,
+                "line": 9,
                 "character": 1
               },
               "name": "TaskResultsList"
@@ -8239,7 +8263,7 @@
             "__schema": "FunctionLikeSchema",
             "location": {
               "filePath": "task-results-list.ts",
-              "line": 19,
+              "line": 22,
               "character": 3
             },
             "signature": "(method) TaskResultsList.hasErrors(): boolean",
@@ -8249,7 +8273,7 @@
               "__schema": "KeywordTypeSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 19,
+                "line": 22,
                 "character": 16
               },
               "name": "boolean"
@@ -8260,7 +8284,7 @@
             "__schema": "FunctionLikeSchema",
             "location": {
               "filePath": "task-results-list.ts",
-              "line": 23,
+              "line": 26,
               "character": 3
             },
             "signature": "(method) TaskResultsList.throwErrorsIfExist(): void",
@@ -8270,7 +8294,7 @@
               "__schema": "InferenceTypeSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 23,
+                "line": 26,
                 "character": 3
               },
               "type": "void"
@@ -8281,14 +8305,14 @@
             "__schema": "FunctionLikeSchema",
             "location": {
               "filePath": "task-results-list.ts",
-              "line": 33,
+              "line": 37,
               "character": 3
             },
             "doc": {
               "__schema": "DocSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 30,
+                "line": 34,
                 "character": 3
               },
               "raw": "/**\n   * group errors from all tasks and show them nicely to the user\n   */",
@@ -8301,16 +8325,16 @@
               "__schema": "TypeUnionSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 33,
-                "character": 38
+                "line": 37,
+                "character": 31
               },
               "types": [
                 {
                   "__schema": "KeywordTypeSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 33,
-                    "character": 38
+                    "line": 37,
+                    "character": 31
                   },
                   "name": "string"
                 },
@@ -8318,16 +8342,14 @@
                   "__schema": "LiteralTypeSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 33,
-                    "character": 47
+                    "line": 37,
+                    "character": 40
                   },
                   "name": "null"
                 }
               ]
             },
-            "modifiers": [
-              "public"
-            ]
+            "modifiers": []
           }
         ],
         "extendsNodes": [],
@@ -9621,7 +9643,7 @@
                   "_legacy": {
                     "scope": "teambit.pipelines",
                     "name": "builder",
-                    "version": "1.0.234"
+                    "version": "1.0.237"
                   },
                   "_scope": "teambit.pipelines"
                 }
@@ -16356,7 +16378,7 @@
                   "_legacy": {
                     "scope": "teambit.pipelines",
                     "name": "builder",
-                    "version": "1.0.234"
+                    "version": "1.0.237"
                   },
                   "_scope": "teambit.pipelines"
                 }
@@ -16380,7 +16402,7 @@
           "__schema": "ClassSchema",
           "location": {
             "filePath": "task-results-list.ts",
-            "line": 8,
+            "line": 9,
             "character": 1
           },
           "signature": "class TaskResultsList",
@@ -16390,17 +16412,17 @@
               "__schema": "ConstructorSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 9,
+                "line": 10,
                 "character": 3
               },
-              "signature": "constructor TaskResultsList(tasksQueue: TasksQueue, tasksResults: TaskResults[], capsuleRootDir: string): TaskResultsList",
+              "signature": "constructor TaskResultsList(tasksQueue: TasksQueue, tasksResults: TaskResults[], capsuleRootDir: string, logger: Logger): TaskResultsList",
               "name": "constructor",
               "params": [
                 {
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 10,
+                    "line": 11,
                     "character": 5
                   },
                   "name": "tasksQueue",
@@ -16408,7 +16430,7 @@
                     "__schema": "TypeRefSchema",
                     "location": {
                       "filePath": "task-results-list.ts",
-                      "line": 10,
+                      "line": 11,
                       "character": 24
                     },
                     "name": "TasksQueue",
@@ -16421,7 +16443,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 14,
+                    "line": 15,
                     "character": 5
                   },
                   "name": "tasksResults",
@@ -16429,14 +16451,14 @@
                     "__schema": "TypeArraySchema",
                     "location": {
                       "filePath": "task-results-list.ts",
-                      "line": 14,
+                      "line": 15,
                       "character": 26
                     },
                     "type": {
                       "__schema": "TypeRefSchema",
                       "location": {
                         "filePath": "task-results-list.ts",
-                        "line": 14,
+                        "line": 15,
                         "character": 26
                       },
                       "name": "TaskResults"
@@ -16449,7 +16471,7 @@
                   "__schema": "ParameterSchema",
                   "location": {
                     "filePath": "task-results-list.ts",
-                    "line": 16,
+                    "line": 17,
                     "character": 5
                   },
                   "name": "capsuleRootDir",
@@ -16457,20 +16479,44 @@
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "task-results-list.ts",
-                      "line": 16,
+                      "line": 17,
                       "character": 28
                     },
                     "name": "string"
                   },
                   "isOptional": false,
                   "isSpread": false
+                },
+                {
+                  "__schema": "ParameterSchema",
+                  "location": {
+                    "filePath": "task-results-list.ts",
+                    "line": 19,
+                    "character": 5
+                  },
+                  "name": "logger",
+                  "type": {
+                    "__schema": "TypeRefSchema",
+                    "location": {
+                      "filePath": "task-results-list.ts",
+                      "line": 19,
+                      "character": 21
+                    },
+                    "name": "Logger",
+                    "componentId": {
+                      "scope": "teambit.harmony",
+                      "name": "logger"
+                    }
+                  },
+                  "isOptional": false,
+                  "isSpread": false
                 }
               ],
               "returnType": {
                 "__schema": "ThisTypeSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 8,
+                  "line": 9,
                   "character": 1
                 },
                 "name": "TaskResultsList"
@@ -16481,7 +16527,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 19,
+                "line": 22,
                 "character": 3
               },
               "signature": "(method) TaskResultsList.hasErrors(): boolean",
@@ -16491,7 +16537,7 @@
                 "__schema": "KeywordTypeSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 19,
+                  "line": 22,
                   "character": 16
                 },
                 "name": "boolean"
@@ -16502,7 +16548,7 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 23,
+                "line": 26,
                 "character": 3
               },
               "signature": "(method) TaskResultsList.throwErrorsIfExist(): void",
@@ -16512,7 +16558,7 @@
                 "__schema": "InferenceTypeSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 23,
+                  "line": 26,
                   "character": 3
                 },
                 "type": "void"
@@ -16523,14 +16569,14 @@
               "__schema": "FunctionLikeSchema",
               "location": {
                 "filePath": "task-results-list.ts",
-                "line": 33,
+                "line": 37,
                 "character": 3
               },
               "doc": {
                 "__schema": "DocSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 30,
+                  "line": 34,
                   "character": 3
                 },
                 "raw": "/**\n   * group errors from all tasks and show them nicely to the user\n   */",
@@ -16543,16 +16589,16 @@
                 "__schema": "TypeUnionSchema",
                 "location": {
                   "filePath": "task-results-list.ts",
-                  "line": 33,
-                  "character": 38
+                  "line": 37,
+                  "character": 31
                 },
                 "types": [
                   {
                     "__schema": "KeywordTypeSchema",
                     "location": {
                       "filePath": "task-results-list.ts",
-                      "line": 33,
-                      "character": 38
+                      "line": 37,
+                      "character": 31
                     },
                     "name": "string"
                   },
@@ -16560,16 +16606,14 @@
                     "__schema": "LiteralTypeSchema",
                     "location": {
                       "filePath": "task-results-list.ts",
-                      "line": 33,
-                      "character": 47
+                      "line": 37,
+                      "character": 40
                     },
                     "name": "null"
                   }
                 ]
               },
-              "modifiers": [
-                "public"
-              ]
+              "modifiers": []
             }
           ],
           "extendsNodes": [],
@@ -16619,7 +16663,7 @@
   "componentId": {
     "scope": "teambit.pipelines",
     "name": "builder",
-    "version": "1.0.234"
+    "version": "1.0.237"
   },
   "taggedModuleExports": []
 }

package/dist/build-pipe.js

@@ -90,7 +90,7 @@ class BuildPipe {
     }) => this.executeTask(task, env));
     this.longProcessLogger.end();
     const capsuleRootDir = Object.values(this.envsBuildContext)[0]?.capsuleNetwork.capsulesRootDir;
-    const tasksResultsList = new (_taskResultsList().TaskResultsList)(this.tasksQueue, this.taskResults, capsuleRootDir);
+    const tasksResultsList = new (_taskResultsList().TaskResultsList)(this.tasksQueue, this.taskResults, capsuleRootDir, this.logger);
     await this.executePostBuild(tasksResultsList);
     return tasksResultsList;
   }

package/dist/build-pipe.js.map

@@ -1 +1 @@
-{"version":3,"names":["_component","data","require","_pMapSeries","_interopRequireDefault","_prettyTime","_toolboxString","_chalk","_buildTask","_taskResultsList","obj","__esModule","default","_defineProperty","key","value","_toPropertyKey","Object","defineProperty","enumerable","configurable","writable","t","i","_toPrimitive","r","e","Symbol","toPrimitive","call","TypeError","String","Number","BuildPipe","constructor","tasksQueue","envsBuildContext","logger","artifactFactory","previousTaskResults","options","allTasksResults","taskResults","execute","executePreBuild","longProcessLogger","createLongProcessLogger","length","mapSeries","task","env","executeTask","end","capsuleRootDir","values","capsuleNetwork","capsulesRootDir","tasksResultsList","TaskResultsList","executePostBuild","setStatusLine","preBuild","getBuildContext","id","taskId","BuildTaskHelper","serializeId","envName","showEnvNameInOutput","getPrettyEnvName","buildContext","hasOriginalSeeders","Boolean","_originalSeeders","dependencyStr","taskLogPrefix","getPrettyAspectName","aspectId","name","logProgress","description","updateFailedDependencyTask","shouldSkipTask","startTask","process","hrtime","taskStartTime","Date","now","buildTaskResult","err","consoleFailure","endTime","compsWithErrors","componentsResults","filter","c","errors","artifacts","duration","prettyTime","chalk","red","getProgress","failedTasks","push","color","green","dim","consoleSuccess","defs","generate","startTime","resolvedId","ComponentID","fromString","tokens","split","map","token","capitalize","join","envId","ver","showEnvVersionInOutput","version","fullName","tasksResults","postBuild","failedDependencyTask","dependencies","forEach","dependency","deserializeIdAllowEmptyName","find","failedTask","exitOnFirstFailedTask","failedTaskId","consoleWarning","Error","previousTasksResults","exports"],"sources":["build-pipe.ts"],"sourcesContent":["import { EnvDefinition } from '@teambit/envs';\nimport { ComponentMap, ComponentID } from '@teambit/component';\nimport { Logger, LongProcessLogger } from '@teambit/logger';\nimport mapSeries from 'p-map-series';\nimport prettyTime from 'pretty-time';\nimport { capitalize } from '@teambit/toolbox.string.capitalize';\nimport chalk from 'chalk';\nimport { ArtifactFactory, ArtifactList, FsArtifact } from './artifact';\nimport { BuildContext, BuildTask, BuildTaskHelper, BuiltTaskResult } 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<FsArtifact>> | 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\ntype PipeOptions = {\n  exitOnFirstFailedTask?: boolean; // by default it skips only when a dependent failed.\n  showEnvNameInOutput?: boolean;\n  showEnvVersionInOutput?: boolean; // in case it shows the env-name, whether should show also the version\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    private options?: PipeOptions\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 capsuleRootDir = Object.values(this.envsBuildContext)[0]?.capsuleNetwork.capsulesRootDir;\n    const tasksResultsList = new TaskResultsList(this.tasksQueue, this.taskResults, capsuleRootDir);\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    const longProcessLogger = this.logger.createLongProcessLogger('running 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    longProcessLogger.end();\n  }\n\n  private async executeTask(task: BuildTask, env: EnvDefinition): Promise<void> {\n    const taskId = BuildTaskHelper.serializeId(task);\n    const envName = this.options?.showEnvNameInOutput ? `(${this.getPrettyEnvName(env.id)}) ` : '';\n    const buildContext = this.getBuildContext(env.id);\n    const hasOriginalSeeders = Boolean(buildContext.capsuleNetwork._originalSeeders?.length);\n    const dependencyStr = hasOriginalSeeders ? '' : `[dependency] `;\n    const taskLogPrefix = `${dependencyStr}${envName}[${this.getPrettyAspectName(task.aspectId)}: ${task.name}]`;\n    this.longProcessLogger.logProgress(`${taskLogPrefix}${task.description ? ` ${task.description}` : ''}`, false);\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    let buildTaskResult: BuiltTaskResult;\n    try {\n      buildTaskResult = await task.execute(buildContext);\n    } catch (err) {\n      this.logger.consoleFailure(`env: ${env.id}, task \"${taskId}\" threw an error`);\n      throw err;\n    }\n\n    const endTime = Date.now();\n    const compsWithErrors = buildTaskResult.componentsResults.filter((c) => c.errors?.length);\n    let artifacts: ComponentMap<ArtifactList<FsArtifact>> | undefined;\n    const duration = prettyTime(process.hrtime(startTask));\n    if (compsWithErrors.length) {\n      this.logger.consoleFailure(`env: ${env.id}, task \"${taskId}\" has failed`);\n      this.logger.consoleFailure(\n        chalk.red(`${this.longProcessLogger.getProgress()} env: ${env.id}, task \"${taskId}\" has failed in ${duration}`)\n      );\n      this.failedTasks.push(task);\n    } else {\n      const color = hasOriginalSeeders ? chalk.green : chalk.green.dim;\n      this.logger.consoleSuccess(\n        color(`${this.longProcessLogger.getProgress()} ${taskLogPrefix} Completed successfully in ${duration}`)\n      );\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 getPrettyAspectName(aspectId: string): string {\n    const resolvedId = ComponentID.fromString(aspectId);\n    const tokens = resolvedId.name.split('-').map((token) => capitalize(token));\n    return tokens.join(' ');\n  }\n\n  private getPrettyEnvName(envId: string) {\n    const resolvedId = ComponentID.fromString(envId);\n    const ver = this.options?.showEnvVersionInOutput ? `@${resolvedId.version}` : '';\n    return `${resolvedId.fullName}${ver}`;\n  }\n\n  private async executePostBuild(tasksResults: TaskResultsList) {\n    const longProcessLogger = this.logger.createLongProcessLogger('running post-build for all tasks');\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    longProcessLogger.end();\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.options?.exitOnFirstFailedTask && this.failedTasks.length) {\n      const failedTaskId = BuildTaskHelper.serializeId(this.failedTasks[0]);\n      this.logger.consoleWarning(`env: ${envId}, task \"${taskId}\" has skipped due to \"${failedTaskId}\" failure`);\n      return true;\n    }\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): BuildContext {\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"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_component","data","require","_pMapSeries","_interopRequireDefault","_prettyTime","_toolboxString","_chalk","_buildTask","_taskResultsList","obj","__esModule","default","_defineProperty","key","value","_toPropertyKey","Object","defineProperty","enumerable","configurable","writable","t","i","_toPrimitive","r","e","Symbol","toPrimitive","call","TypeError","String","Number","BuildPipe","constructor","tasksQueue","envsBuildContext","logger","artifactFactory","previousTaskResults","options","allTasksResults","taskResults","execute","executePreBuild","longProcessLogger","createLongProcessLogger","length","mapSeries","task","env","executeTask","end","capsuleRootDir","values","capsuleNetwork","capsulesRootDir","tasksResultsList","TaskResultsList","executePostBuild","setStatusLine","preBuild","getBuildContext","id","taskId","BuildTaskHelper","serializeId","envName","showEnvNameInOutput","getPrettyEnvName","buildContext","hasOriginalSeeders","Boolean","_originalSeeders","dependencyStr","taskLogPrefix","getPrettyAspectName","aspectId","name","logProgress","description","updateFailedDependencyTask","shouldSkipTask","startTask","process","hrtime","taskStartTime","Date","now","buildTaskResult","err","consoleFailure","endTime","compsWithErrors","componentsResults","filter","c","errors","artifacts","duration","prettyTime","chalk","red","getProgress","failedTasks","push","color","green","dim","consoleSuccess","defs","generate","startTime","resolvedId","ComponentID","fromString","tokens","split","map","token","capitalize","join","envId","ver","showEnvVersionInOutput","version","fullName","tasksResults","postBuild","failedDependencyTask","dependencies","forEach","dependency","deserializeIdAllowEmptyName","find","failedTask","exitOnFirstFailedTask","failedTaskId","consoleWarning","Error","previousTasksResults","exports"],"sources":["build-pipe.ts"],"sourcesContent":["import { EnvDefinition } from '@teambit/envs';\nimport { ComponentMap, ComponentID } from '@teambit/component';\nimport { Logger, LongProcessLogger } from '@teambit/logger';\nimport mapSeries from 'p-map-series';\nimport prettyTime from 'pretty-time';\nimport { capitalize } from '@teambit/toolbox.string.capitalize';\nimport chalk from 'chalk';\nimport { ArtifactFactory, ArtifactList, FsArtifact } from './artifact';\nimport { BuildContext, BuildTask, BuildTaskHelper, BuiltTaskResult } 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<FsArtifact>> | 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\ntype PipeOptions = {\n  exitOnFirstFailedTask?: boolean; // by default it skips only when a dependent failed.\n  showEnvNameInOutput?: boolean;\n  showEnvVersionInOutput?: boolean; // in case it shows the env-name, whether should show also the version\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    private options?: PipeOptions\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 capsuleRootDir = Object.values(this.envsBuildContext)[0]?.capsuleNetwork.capsulesRootDir;\n    const tasksResultsList = new TaskResultsList(this.tasksQueue, this.taskResults, capsuleRootDir, this.logger);\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    const longProcessLogger = this.logger.createLongProcessLogger('running 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    longProcessLogger.end();\n  }\n\n  private async executeTask(task: BuildTask, env: EnvDefinition): Promise<void> {\n    const taskId = BuildTaskHelper.serializeId(task);\n    const envName = this.options?.showEnvNameInOutput ? `(${this.getPrettyEnvName(env.id)}) ` : '';\n    const buildContext = this.getBuildContext(env.id);\n    const hasOriginalSeeders = Boolean(buildContext.capsuleNetwork._originalSeeders?.length);\n    const dependencyStr = hasOriginalSeeders ? '' : `[dependency] `;\n    const taskLogPrefix = `${dependencyStr}${envName}[${this.getPrettyAspectName(task.aspectId)}: ${task.name}]`;\n    this.longProcessLogger.logProgress(`${taskLogPrefix}${task.description ? ` ${task.description}` : ''}`, false);\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    let buildTaskResult: BuiltTaskResult;\n    try {\n      buildTaskResult = await task.execute(buildContext);\n    } catch (err) {\n      this.logger.consoleFailure(`env: ${env.id}, task \"${taskId}\" threw an error`);\n      throw err;\n    }\n\n    const endTime = Date.now();\n    const compsWithErrors = buildTaskResult.componentsResults.filter((c) => c.errors?.length);\n    let artifacts: ComponentMap<ArtifactList<FsArtifact>> | undefined;\n    const duration = prettyTime(process.hrtime(startTask));\n    if (compsWithErrors.length) {\n      this.logger.consoleFailure(`env: ${env.id}, task \"${taskId}\" has failed`);\n      this.logger.consoleFailure(\n        chalk.red(`${this.longProcessLogger.getProgress()} env: ${env.id}, task \"${taskId}\" has failed in ${duration}`)\n      );\n      this.failedTasks.push(task);\n    } else {\n      const color = hasOriginalSeeders ? chalk.green : chalk.green.dim;\n      this.logger.consoleSuccess(\n        color(`${this.longProcessLogger.getProgress()} ${taskLogPrefix} Completed successfully in ${duration}`)\n      );\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 getPrettyAspectName(aspectId: string): string {\n    const resolvedId = ComponentID.fromString(aspectId);\n    const tokens = resolvedId.name.split('-').map((token) => capitalize(token));\n    return tokens.join(' ');\n  }\n\n  private getPrettyEnvName(envId: string) {\n    const resolvedId = ComponentID.fromString(envId);\n    const ver = this.options?.showEnvVersionInOutput ? `@${resolvedId.version}` : '';\n    return `${resolvedId.fullName}${ver}`;\n  }\n\n  private async executePostBuild(tasksResults: TaskResultsList) {\n    const longProcessLogger = this.logger.createLongProcessLogger('running post-build for all tasks');\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    longProcessLogger.end();\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.options?.exitOnFirstFailedTask && this.failedTasks.length) {\n      const failedTaskId = BuildTaskHelper.serializeId(this.failedTasks[0]);\n      this.logger.consoleWarning(`env: ${envId}, task \"${taskId}\" has skipped due to \"${failedTaskId}\" failure`);\n      return true;\n    }\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): BuildContext {\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"],"mappings":"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","ignoreList":[]}

package/dist/build.cmd.d.ts

@@ -3,13 +3,14 @@ import { Logger } from '@teambit/logger';
 import { Workspace } from '@teambit/workspace';
 import { BuilderMain } from './builder.main.runtime';
 type BuildOpts = {
-    all: boolean;
     unmodified?: boolean;
     dev: boolean;
     rebuild: boolean;
     install: boolean;
     cachePackagesOnCapsulesRoot: boolean;
     reuseCapsules: boolean;
+    rewrite?: boolean;
+    reinstall?: boolean;
     tasks: string;
     listTasks?: string;
     skipTests?: boolean;
@@ -28,12 +29,16 @@ export declare class BuilderCmd implements Command {
         name: string;
         description: string;
     }[];
+    examples: {
+        cmd: string;
+        description: string;
+    }[];
     helpUrl: string;
     alias: string;
     group: string;
     options: CommandOptions;
     constructor(builder: BuilderMain, workspace: Workspace, logger: Logger);
-    report([pattern]: [string], { all, unmodified, dev, install, cachePackagesOnCapsulesRoot, reuseCapsules, tasks, listTasks, skipTests, failFast, includeSnap, includeTag, }: BuildOpts): Promise<string>;
+    report([pattern]: [string], { unmodified, dev, install, cachePackagesOnCapsulesRoot, reuseCapsules, rewrite, reinstall, tasks, listTasks, skipTests, failFast, includeSnap, includeTag, }: BuildOpts): Promise<string>;
     private getListTasks;
 }
 export {};

package/dist/build.cmd.js

@@ -43,24 +43,37 @@ class BuilderCmd {
     this.logger = logger;
     _defineProperty(this, "name", 'build [component-pattern]');
     _defineProperty(this, "description", 'run set of tasks for build.');
-    _defineProperty(this, "extendedDescription", 'by default, only new and modified components are built');
+    _defineProperty(this, "extendedDescription", `by default, only new and modified components are built.
+the build takes place in an isolated directories on the filesystem (called "capsules"). the component files are copied to these directories
+and the package-manager installs the dependencies in the capsules root. once done, the build pipeline is running.
+because this process can take a while on a large workspace, some flags are available to shorten the process. See the example section for more info.
+  `);
     _defineProperty(this, "arguments", [{
       name: 'component-pattern',
       description: _constants().COMPONENT_PATTERN_HELP
     }]);
+    _defineProperty(this, "examples", [{
+      cmd: 'build --reuse-capsules --tasks "custom-task"',
+      description: 'helps to debug this "custom-task" without recreating the capsules from scratch'
+    }, {
+      cmd: 'build --reuse-capsules --rewrite --tasks "BabelCompile,MochaTest"',
+      description: `helpful when for example the tests are failing and code changes are needed to debug it.
+the "--rewrite" flag ensures the component files are fresh, and the "--tasks" ensures to re-compile them and then run the tests`
+    }]);
     _defineProperty(this, "helpUrl", 'reference/build-pipeline/builder-overview');
     _defineProperty(this, "alias", '');
     _defineProperty(this, "group", 'development');
-    _defineProperty(this, "options", [['a', 'all', 'DEPRECATED. use --unmodified'], ['u', 'unmodified', 'include unmodified components (by default, only new and modified components are built)'], ['d', 'dev', 'run the pipeline in dev mode'], ['', 'install', 'install core aspects in capsules'], ['', 'reuse-capsules', 'avoid deleting the capsules root-dir before starting the build'], ['', 'tasks <string>', `build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.
+    _defineProperty(this, "options", [['u', 'unmodified', 'include unmodified components (by default, only new and modified components are built)'], ['d', 'dev', 'run the pipeline in dev mode'], ['', 'install', 'install core aspects in capsules'], ['', 'reuse-capsules', 'avoid deleting the capsules root-dir before starting the build'], ['', 'rewrite', 'use only with --reuse-capsules. rewrite the component files'], ['', 'reinstall', 'use only with --reuse-capsules. rerun the installation'], ['', 'tasks <string>', `build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.
 specify the task-name (e.g. "TypescriptCompiler") or the task-aspect-id (e.g. teambit.compilation/compiler)`], ['', 'cache-packages-on-capsule-root', 'set the package-manager cache on the capsule root'], ['', 'list-tasks <string>', 'list tasks of an env or a component-id for each one of the pipelines: build, tag and snap'], ['', 'skip-tests', 'skip running component tests during build process'], ['', 'fail-fast', 'stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)'], ['', 'include-snap', 'EXPERIMENTAL. include snap pipeline tasks. Warning: this may deploy/publish if you have such tasks'], ['', 'include-tag', 'EXPERIMENTAL. include tag pipeline tasks. Warning: this may deploy/publish if you have such tasks']]);
   }
   async report([pattern], {
-    all = false,
     unmodified = false,
     dev = false,
     install = false,
     cachePackagesOnCapsulesRoot = false,
     reuseCapsules = false,
+    rewrite = false,
+    reinstall = false,
     tasks,
     listTasks,
     skipTests,
@@ -68,11 +81,9 @@ specify the task-name (e.g. "TypescriptCompiler") or the task-aspect-id (e.g. te
     includeSnap,
     includeTag
   }) {
+    if (rewrite && !reuseCapsules) throw new Error('cannot use --rewrite without --reuse-capsules');
+    if (reinstall && !reuseCapsules) throw new Error('cannot use --reinstall without --reuse-capsules');
     if (!this.workspace) throw new (_workspace().OutsideWorkspaceError)();
-    if (all) {
-      this.logger.consoleWarning(`--all is deprecated, please use --unmodified instead`);
-      unmodified = true;
-    }
     if (listTasks) {
       return this.getListTasks(listTasks);
     }
@@ -85,13 +96,14 @@ specify the task-name (e.g. "TypescriptCompiler") or the task-aspect-id (e.g. te
     const envsExecutionResults = await this.builder.build(components, {
       installOptions: {
         installTeambitBit: install,
-        packageManagerConfigRootDir: this.workspace.path
+        packageManagerConfigRootDir: this.workspace.path,
+        installPackages: rewrite && !reinstall ? false : true
       },
       linkingOptions: {
         linkTeambitBit: !install
       },
       emptyRootDir: !reuseCapsules,
-      getExistingAsIs: reuseCapsules,
+      getExistingAsIs: reuseCapsules && !rewrite && !reinstall,
       cachePackagesOnCapsulesRoot
     }, {
       dev,

package/dist/build.cmd.js.map

@@ -1 +1 @@
-{"version":3,"names":["_prettyTime","data","_interopRequireDefault","require","_workspace","_constants","_chalk","obj","__esModule","default","_defineProperty","key","value","_toPropertyKey","Object","defineProperty","enumerable","configurable","writable","t","i","_toPrimitive","r","e","Symbol","toPrimitive","call","TypeError","String","Number","BuilderCmd","constructor","builder","workspace","logger","name","description","COMPONENT_PATTERN_HELP","report","pattern","all","unmodified","dev","install","cachePackagesOnCapsulesRoot","reuseCapsules","tasks","listTasks","skipTests","failFast","includeSnap","includeTag","OutsideWorkspaceError","consoleWarning","getListTasks","setStatusLine","start","process","hrtime","components","getComponentsByUserInput","length","chalk","bold","envsExecutionResults","build","installOptions","installTeambitBit","packageManagerConfigRootDir","path","linkingOptions","linkTeambitBit","emptyRootDir","getExistingAsIs","split","map","task","trim","exitOnFirstFailedTask","console","capsuleRootDir","duration","prettyTime","succeedOrFailed","hasErrors","msg","consoleFailure","throwErrorsIfExist","green","componentIdStr","compId","resolveComponentId","component","get","results","id","toString","envId","buildTasks","join","tagTasks","snapTasks","exports"],"sources":["build.cmd.ts"],"sourcesContent":["import { Command, CommandOptions } from '@teambit/cli';\nimport { Logger } from '@teambit/logger';\nimport prettyTime from 'pretty-time';\nimport { OutsideWorkspaceError, Workspace } from '@teambit/workspace';\nimport { COMPONENT_PATTERN_HELP } from '@teambit/legacy/dist/constants';\nimport chalk from 'chalk';\nimport { BuilderMain } from './builder.main.runtime';\n\ntype BuildOpts = {\n  all: boolean; // deprecated. use unmodified\n  unmodified?: boolean;\n  dev: boolean;\n  rebuild: boolean;\n  install: boolean;\n  cachePackagesOnCapsulesRoot: boolean;\n  reuseCapsules: boolean;\n  tasks: string;\n  listTasks?: string;\n  skipTests?: boolean;\n  failFast?: boolean;\n  includeSnap?: boolean;\n  includeTag?: boolean;\n};\n\nexport class BuilderCmd implements Command {\n  name = 'build [component-pattern]';\n  description = 'run set of tasks for build.';\n  extendedDescription = 'by default, only new and modified components are built';\n  arguments = [{ name: 'component-pattern', description: COMPONENT_PATTERN_HELP }];\n  helpUrl = 'reference/build-pipeline/builder-overview';\n  alias = '';\n  group = 'development';\n  options = [\n    ['a', 'all', 'DEPRECATED. use --unmodified'],\n    ['u', 'unmodified', 'include unmodified components (by default, only new and modified components are built)'],\n    ['d', 'dev', 'run the pipeline in dev mode'],\n    ['', 'install', 'install core aspects in capsules'],\n    ['', 'reuse-capsules', 'avoid deleting the capsules root-dir before starting the build'],\n    [\n      '',\n      'tasks <string>',\n      `build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.\nspecify the task-name (e.g. \"TypescriptCompiler\") or the task-aspect-id (e.g. teambit.compilation/compiler)`,\n    ],\n    ['', 'cache-packages-on-capsule-root', 'set the package-manager cache on the capsule root'],\n    [\n      '',\n      'list-tasks <string>',\n      'list tasks of an env or a component-id for each one of the pipelines: build, tag and snap',\n    ],\n    ['', 'skip-tests', 'skip running component tests during build process'],\n    [\n      '',\n      'fail-fast',\n      'stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)',\n    ],\n    [\n      '',\n      'include-snap',\n      'EXPERIMENTAL. include snap pipeline tasks. Warning: this may deploy/publish if you have such tasks',\n    ],\n    [\n      '',\n      'include-tag',\n      'EXPERIMENTAL. include tag pipeline tasks. Warning: this may deploy/publish if you have such tasks',\n    ],\n  ] as CommandOptions;\n\n  constructor(private builder: BuilderMain, private workspace: Workspace, private logger: Logger) {}\n\n  async report(\n    [pattern]: [string],\n    {\n      all = false,\n      unmodified = false,\n      dev = false,\n      install = false,\n      cachePackagesOnCapsulesRoot = false,\n      reuseCapsules = false,\n      tasks,\n      listTasks,\n      skipTests,\n      failFast,\n      includeSnap,\n      includeTag,\n    }: BuildOpts\n  ): Promise<string> {\n    if (!this.workspace) throw new OutsideWorkspaceError();\n    if (all) {\n      this.logger.consoleWarning(`--all is deprecated, please use --unmodified instead`);\n      unmodified = true;\n    }\n    if (listTasks) {\n      return this.getListTasks(listTasks);\n    }\n\n    this.logger.setStatusLine('build');\n    const start = process.hrtime();\n    const components = await this.workspace.getComponentsByUserInput(unmodified, pattern, true);\n    if (!components.length) {\n      return chalk.bold(\n        `no components found to build. use \"--unmodified\" flag to build all components or specify the ids to build, otherwise, only new and modified components will be built`\n      );\n    }\n\n    const envsExecutionResults = await this.builder.build(\n      components,\n      {\n        installOptions: {\n          installTeambitBit: install,\n          packageManagerConfigRootDir: this.workspace.path,\n        },\n        linkingOptions: { linkTeambitBit: !install },\n        emptyRootDir: !reuseCapsules,\n        getExistingAsIs: reuseCapsules,\n        cachePackagesOnCapsulesRoot,\n      },\n      {\n        dev,\n        tasks: tasks ? tasks.split(',').map((task) => task.trim()) : [],\n        skipTests,\n        exitOnFirstFailedTask: failFast,\n      },\n      {\n        includeSnap,\n        includeTag,\n      }\n    );\n    this.logger.console(`build output can be found in path: ${envsExecutionResults.capsuleRootDir}`);\n    const duration = prettyTime(process.hrtime(start));\n    const succeedOrFailed = envsExecutionResults.hasErrors() ? 'failed' : 'succeeded';\n    const msg = `build ${succeedOrFailed}. completed in ${duration}.`;\n    if (envsExecutionResults.hasErrors()) {\n      this.logger.consoleFailure(msg);\n    }\n    envsExecutionResults.throwErrorsIfExist();\n    return chalk.green(msg);\n  }\n\n  private async getListTasks(componentIdStr: string): Promise<string> {\n    const compId = await this.workspace.resolveComponentId(componentIdStr);\n    const component = await this.workspace.get(compId);\n    const results = this.builder.listTasks(component);\n    return `${chalk.green('Task List')}\nid:    ${results.id.toString()}\nenvId: ${results.envId}\n\n${chalk.bold('Build Pipeline Tasks:')}\n${results.buildTasks.join('\\n')}\n\n${chalk.bold('Tag Pipeline Tasks:')}\n${results.tagTasks.join('\\n')}\n\n${chalk.bold('Snap Pipeline Tasks:')}\n${results.snapTasks.join('\\n') || '<N/A>'}`;\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_prettyTime","data","_interopRequireDefault","require","_workspace","_constants","_chalk","obj","__esModule","default","_defineProperty","key","value","_toPropertyKey","Object","defineProperty","enumerable","configurable","writable","t","i","_toPrimitive","r","e","Symbol","toPrimitive","call","TypeError","String","Number","BuilderCmd","constructor","builder","workspace","logger","name","description","COMPONENT_PATTERN_HELP","cmd","report","pattern","unmodified","dev","install","cachePackagesOnCapsulesRoot","reuseCapsules","rewrite","reinstall","tasks","listTasks","skipTests","failFast","includeSnap","includeTag","Error","OutsideWorkspaceError","getListTasks","setStatusLine","start","process","hrtime","components","getComponentsByUserInput","length","chalk","bold","envsExecutionResults","build","installOptions","installTeambitBit","packageManagerConfigRootDir","path","installPackages","linkingOptions","linkTeambitBit","emptyRootDir","getExistingAsIs","split","map","task","trim","exitOnFirstFailedTask","console","capsuleRootDir","duration","prettyTime","succeedOrFailed","hasErrors","msg","consoleFailure","throwErrorsIfExist","green","componentIdStr","compId","resolveComponentId","component","get","results","id","toString","envId","buildTasks","join","tagTasks","snapTasks","exports"],"sources":["build.cmd.ts"],"sourcesContent":["import { Command, CommandOptions } from '@teambit/cli';\nimport { Logger } from '@teambit/logger';\nimport prettyTime from 'pretty-time';\nimport { OutsideWorkspaceError, Workspace } from '@teambit/workspace';\nimport { COMPONENT_PATTERN_HELP } from '@teambit/legacy/dist/constants';\nimport chalk from 'chalk';\nimport { BuilderMain } from './builder.main.runtime';\n\ntype BuildOpts = {\n  unmodified?: boolean;\n  dev: boolean;\n  rebuild: boolean;\n  install: boolean;\n  cachePackagesOnCapsulesRoot: boolean;\n  reuseCapsules: boolean;\n  rewrite?: boolean; //relevant only when reuseCapsules is set\n  reinstall?: boolean; //relevant only when reuseCapsules is set\n  tasks: string;\n  listTasks?: string;\n  skipTests?: boolean;\n  failFast?: boolean;\n  includeSnap?: boolean;\n  includeTag?: boolean;\n};\n\nexport class BuilderCmd implements Command {\n  name = 'build [component-pattern]';\n  description = 'run set of tasks for build.';\n  extendedDescription = `by default, only new and modified components are built.\nthe build takes place in an isolated directories on the filesystem (called \"capsules\"). the component files are copied to these directories\nand the package-manager installs the dependencies in the capsules root. once done, the build pipeline is running.\nbecause this process can take a while on a large workspace, some flags are available to shorten the process. See the example section for more info.\n  `;\n  arguments = [{ name: 'component-pattern', description: COMPONENT_PATTERN_HELP }];\n  examples = [\n    {\n      cmd: 'build --reuse-capsules --tasks \"custom-task\"',\n      description: 'helps to debug this \"custom-task\" without recreating the capsules from scratch',\n    },\n    {\n      cmd: 'build --reuse-capsules --rewrite --tasks \"BabelCompile,MochaTest\"',\n      description: `helpful when for example the tests are failing and code changes are needed to debug it.\nthe \"--rewrite\" flag ensures the component files are fresh, and the \"--tasks\" ensures to re-compile them and then run the tests`,\n    },\n  ];\n  helpUrl = 'reference/build-pipeline/builder-overview';\n  alias = '';\n  group = 'development';\n  options = [\n    ['u', 'unmodified', 'include unmodified components (by default, only new and modified components are built)'],\n    ['d', 'dev', 'run the pipeline in dev mode'],\n    ['', 'install', 'install core aspects in capsules'],\n    ['', 'reuse-capsules', 'avoid deleting the capsules root-dir before starting the build'],\n    ['', 'rewrite', 'use only with --reuse-capsules. rewrite the component files'],\n    ['', 'reinstall', 'use only with --reuse-capsules. rerun the installation'],\n    [\n      '',\n      'tasks <string>',\n      `build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.\nspecify the task-name (e.g. \"TypescriptCompiler\") or the task-aspect-id (e.g. teambit.compilation/compiler)`,\n    ],\n    ['', 'cache-packages-on-capsule-root', 'set the package-manager cache on the capsule root'],\n    [\n      '',\n      'list-tasks <string>',\n      'list tasks of an env or a component-id for each one of the pipelines: build, tag and snap',\n    ],\n    ['', 'skip-tests', 'skip running component tests during build process'],\n    [\n      '',\n      'fail-fast',\n      'stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)',\n    ],\n    [\n      '',\n      'include-snap',\n      'EXPERIMENTAL. include snap pipeline tasks. Warning: this may deploy/publish if you have such tasks',\n    ],\n    [\n      '',\n      'include-tag',\n      'EXPERIMENTAL. include tag pipeline tasks. Warning: this may deploy/publish if you have such tasks',\n    ],\n  ] as CommandOptions;\n\n  constructor(private builder: BuilderMain, private workspace: Workspace, private logger: Logger) {}\n\n  async report(\n    [pattern]: [string],\n    {\n      unmodified = false,\n      dev = false,\n      install = false,\n      cachePackagesOnCapsulesRoot = false,\n      reuseCapsules = false,\n      rewrite = false,\n      reinstall = false,\n      tasks,\n      listTasks,\n      skipTests,\n      failFast,\n      includeSnap,\n      includeTag,\n    }: BuildOpts\n  ): Promise<string> {\n    if (rewrite && !reuseCapsules) throw new Error('cannot use --rewrite without --reuse-capsules');\n    if (reinstall && !reuseCapsules) throw new Error('cannot use --reinstall without --reuse-capsules');\n    if (!this.workspace) throw new OutsideWorkspaceError();\n    if (listTasks) {\n      return this.getListTasks(listTasks);\n    }\n\n    this.logger.setStatusLine('build');\n    const start = process.hrtime();\n    const components = await this.workspace.getComponentsByUserInput(unmodified, pattern, true);\n    if (!components.length) {\n      return chalk.bold(\n        `no components found to build. use \"--unmodified\" flag to build all components or specify the ids to build, otherwise, only new and modified components will be built`\n      );\n    }\n\n    const envsExecutionResults = await this.builder.build(\n      components,\n      {\n        installOptions: {\n          installTeambitBit: install,\n          packageManagerConfigRootDir: this.workspace.path,\n          installPackages: rewrite && !reinstall ? false : true,\n        },\n        linkingOptions: { linkTeambitBit: !install },\n        emptyRootDir: !reuseCapsules,\n        getExistingAsIs: reuseCapsules && !rewrite && !reinstall,\n        cachePackagesOnCapsulesRoot,\n      },\n      {\n        dev,\n        tasks: tasks ? tasks.split(',').map((task) => task.trim()) : [],\n        skipTests,\n        exitOnFirstFailedTask: failFast,\n      },\n      {\n        includeSnap,\n        includeTag,\n      }\n    );\n    this.logger.console(`build output can be found in path: ${envsExecutionResults.capsuleRootDir}`);\n    const duration = prettyTime(process.hrtime(start));\n    const succeedOrFailed = envsExecutionResults.hasErrors() ? 'failed' : 'succeeded';\n    const msg = `build ${succeedOrFailed}. completed in ${duration}.`;\n    if (envsExecutionResults.hasErrors()) {\n      this.logger.consoleFailure(msg);\n    }\n    envsExecutionResults.throwErrorsIfExist();\n    return chalk.green(msg);\n  }\n\n  private async getListTasks(componentIdStr: string): Promise<string> {\n    const compId = await this.workspace.resolveComponentId(componentIdStr);\n    const component = await this.workspace.get(compId);\n    const results = this.builder.listTasks(component);\n    return `${chalk.green('Task List')}\nid:    ${results.id.toString()}\nenvId: ${results.envId}\n\n${chalk.bold('Build Pipeline Tasks:')}\n${results.buildTasks.join('\\n')}\n\n${chalk.bold('Tag Pipeline Tasks:')}\n${results.tagTasks.join('\\n')}\n\n${chalk.bold('Snap Pipeline Tasks:')}\n${results.snapTasks.join('\\n') || '<N/A>'}`;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/{preview-1713151252756.js → preview-1713191433000.js}

@@ -1,5 +1,5 @@
-import * as compositions_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.pipelines_builder@1.0.234/dist/builder.composition.js';
-import * as overview_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.pipelines_builder@1.0.234/dist/builder.docs.mdx';
+import * as compositions_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.pipelines_builder@1.0.237/dist/builder.composition.js';
+import * as overview_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.pipelines_builder@1.0.237/dist/builder.docs.mdx';
 
 export const compositions = [compositions_0];
 export const overview = [overview_0];

package/dist/task-results-list.d.ts

@@ -1,3 +1,4 @@
+import { Logger } from '@teambit/logger';
 import { TasksQueue } from './tasks-queue';
 import { TaskResults } from './build-pipe';
 export declare class TaskResultsList {
@@ -7,11 +8,12 @@ export declare class TaskResultsList {
      */
     tasksResults: TaskResults[];
     capsuleRootDir: string;
+    private logger;
     constructor(tasksQueue: TasksQueue, 
     /**
      * results of all tasks executed in the build pipeline.
      */
-    tasksResults: TaskResults[], capsuleRootDir: string);
+    tasksResults: TaskResults[], capsuleRootDir: string, logger: Logger);
     hasErrors(): boolean;
     throwErrorsIfExist(): void;
     /**
@@ -19,4 +21,5 @@ export declare class TaskResultsList {
      */
     getErrorMessageFormatted(): string | null;
     private aggregateTaskErrorsToOneString;
+    private logStackTrace;
 }

package/dist/task-results-list.js

@@ -31,15 +31,17 @@ class TaskResultsList {
   /**
    * results of all tasks executed in the build pipeline.
    */
-  tasksResults, capsuleRootDir) {
+  tasksResults, capsuleRootDir, logger) {
     this.tasksQueue = tasksQueue;
     this.tasksResults = tasksResults;
     this.capsuleRootDir = capsuleRootDir;
+    this.logger = logger;
   }
   hasErrors() {
     return this.tasksResults.some(taskResult => taskResult.componentsResults.find(c => c.errors?.length));
   }
   throwErrorsIfExist() {
+    this.logStackTrace();
     const errorMessage = this.getErrorMessageFormatted();
     if (errorMessage) {
       throw new (_bitError().BitError)(errorMessage);
@@ -77,6 +79,17 @@ class TaskResultsList {
     const errors = rawErrors.map(e => typeof e === 'string' ? e : e.toString());
     return `component: ${componentResult.component.id.toString()}\n${errors.join('\n')}`;
   }
+  logStackTrace() {
+    this.tasksResults.forEach(taskResult => {
+      taskResult.componentsResults.forEach(componentResult => {
+        componentResult.errors?.forEach(error => {
+          if (error instanceof Error) {
+            this.logger.error(`failed running task ${taskResult.task.name} on ${componentResult.component.id.toString()}`, error);
+          }
+        });
+      });
+    });
+  }
 }
 exports.TaskResultsList = TaskResultsList;
 

package/dist/task-results-list.js.map

@@ -1 +1 @@
-{"version":3,"names":["_chalk","data","_interopRequireDefault","require","_bitError","_buildTask","obj","__esModule","default","TaskResultsList","constructor","tasksQueue","tasksResults","capsuleRootDir","hasErrors","some","taskResult","componentsResults","find","c","errors","length","throwErrorsIfExist","errorMessage","getErrorMessageFormatted","BitError","tasksErrors","totalErrors","forEach","compsWithErrors","filter","title","chalk","bold","BuildTaskHelper","serializeId","task","env","id","errorsStr","map","compWithErrors","aggregateTaskErrorsToOneString","join","taskErrors","reduce","acc","current","summery","push","totalTasks","totalFailed","totalSucceed","totalSkipped","componentResult","rawErrors","e","toString","component","exports"],"sources":["task-results-list.ts"],"sourcesContent":["import chalk from 'chalk';\nimport { BitError } from '@teambit/bit-error';\nimport { BuildTaskHelper } from './build-task';\nimport { TasksQueue } from './tasks-queue';\nimport { TaskResults } from './build-pipe';\nimport { ComponentResult } from './types';\n\nexport class TaskResultsList {\n  constructor(\n    public tasksQueue: TasksQueue,\n    /**\n     * results of all tasks executed in the build pipeline.\n     */\n    public tasksResults: TaskResults[],\n\n    public capsuleRootDir: string\n  ) {}\n\n  hasErrors(): boolean {\n    return this.tasksResults.some((taskResult) => taskResult.componentsResults.find((c) => c.errors?.length));\n  }\n\n  throwErrorsIfExist() {\n    const errorMessage = this.getErrorMessageFormatted();\n    if (errorMessage) {\n      throw new BitError(errorMessage);\n    }\n  }\n\n  /**\n   * group errors from all tasks and show them nicely to the user\n   */\n  public getErrorMessageFormatted(): string | null {\n    const tasksErrors: string[] = [];\n    let totalErrors = 0;\n    this.tasksResults.forEach((taskResult) => {\n      const compsWithErrors = taskResult.componentsResults.filter((c) => c.errors?.length);\n      if (!compsWithErrors.length) return;\n      const title = chalk.bold(\n        `Failed task ${tasksErrors.length + 1}: \"${BuildTaskHelper.serializeId(taskResult.task)}\" of env \"${\n          taskResult.env.id\n        }\"\\n`\n      );\n      const errorsStr = compsWithErrors\n        .map((compWithErrors) => this.aggregateTaskErrorsToOneString(compWithErrors))\n        .join('\\n\\n');\n      const taskErrors = compsWithErrors.reduce((acc, current) => acc + (current.errors || []).length, 0);\n      const summery = `\\n\\nFound ${taskErrors} errors in ${compsWithErrors.length} components`;\n      totalErrors += taskErrors;\n      tasksErrors.push(title + errorsStr + summery);\n    });\n    if (!tasksErrors.length) return null;\n    const title = `\\nThe following errors were found while running the build pipeline\\n`;\n    const errorsStr = tasksErrors.join('\\n\\n');\n    const totalTasks = this.tasksQueue.length;\n    const totalFailed = tasksErrors.length;\n    const totalSucceed = this.tasksResults.length - totalFailed;\n    const totalSkipped = totalTasks - this.tasksResults.length;\n    const summery = `\\n\\n\\n✖ Total ${totalTasks} tasks. ${totalSucceed} succeeded. ${totalFailed} failed. ${totalSkipped} skipped. Total errors: ${totalErrors}.`;\n    return title + errorsStr + summery;\n  }\n\n  private aggregateTaskErrorsToOneString(componentResult: ComponentResult) {\n    const rawErrors = componentResult.errors || [];\n    const errors = rawErrors.map((e) => (typeof e === 'string' ? e : e.toString()));\n    return `component: ${componentResult.component.id.toString()}\\n${errors.join('\\n')}`;\n  }\n}\n"],"mappings":";;;;;;AAAA,SAAAA,OAAA;EAAA,MAAAC,IAAA,GAAAC,sBAAA,CAAAC,OAAA;EAAAH,MAAA,YAAAA,CAAA;IAAA,OAAAC,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AACA,SAAAG,UAAA;EAAA,MAAAH,IAAA,GAAAE,OAAA;EAAAC,SAAA,YAAAA,CAAA;IAAA,OAAAH,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AACA,SAAAI,WAAA;EAAA,MAAAJ,IAAA,GAAAE,OAAA;EAAAE,UAAA,YAAAA,CAAA;IAAA,OAAAJ,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AAA+C,SAAAC,uBAAAI,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,KAAAE,OAAA,EAAAF,GAAA;AAKxC,MAAMG,eAAe,CAAC;EAC3BC,WAAWA,CACFC,UAAsB;EAC7B;AACJ;AACA;EACWC,YAA2B,EAE3BC,cAAsB,EAC7B;IAAA,KAPOF,UAAsB,GAAtBA,UAAsB;IAAA,KAItBC,YAA2B,GAA3BA,YAA2B;IAAA,KAE3BC,cAAsB,GAAtBA,cAAsB;EAC5B;EAEHC,SAASA,CAAA,EAAY;IACnB,OAAO,IAAI,CAACF,YAAY,CAACG,IAAI,CAAEC,UAAU,IAAKA,UAAU,CAACC,iBAAiB,CAACC,IAAI,CAAEC,CAAC,IAAKA,CAAC,CAACC,MAAM,EAAEC,MAAM,CAAC,CAAC;EAC3G;EAEAC,kBAAkBA,CAAA,EAAG;IACnB,MAAMC,YAAY,GAAG,IAAI,CAACC,wBAAwB,CAAC,CAAC;IACpD,IAAID,YAAY,EAAE;MAChB,MAAM,KAAIE,oBAAQ,EAACF,YAAY,CAAC;IAClC;EACF;;EAEA;AACF;AACA;EACSC,wBAAwBA,CAAA,EAAkB;IAC/C,MAAME,WAAqB,GAAG,EAAE;IAChC,IAAIC,WAAW,GAAG,CAAC;IACnB,IAAI,CAACf,YAAY,CAACgB,OAAO,CAAEZ,UAAU,IAAK;MACxC,MAAMa,eAAe,GAAGb,UAAU,CAACC,iBAAiB,CAACa,MAAM,CAAEX,CAAC,IAAKA,CAAC,CAACC,MAAM,EAAEC,MAAM,CAAC;MACpF,IAAI,CAACQ,eAAe,CAACR,MAAM,EAAE;MAC7B,MAAMU,KAAK,GAAGC,gBAAK,CAACC,IAAI,CACrB,eAAcP,WAAW,CAACL,MAAM,GAAG,CAAE,MAAKa,4BAAe,CAACC,WAAW,CAACnB,UAAU,CAACoB,IAAI,CAAE,aACtFpB,UAAU,CAACqB,GAAG,CAACC,EAChB,KACH,CAAC;MACD,MAAMC,SAAS,GAAGV,eAAe,CAC9BW,GAAG,CAAEC,cAAc,IAAK,IAAI,CAACC,8BAA8B,CAACD,cAAc,CAAC,CAAC,CAC5EE,IAAI,CAAC,MAAM,CAAC;MACf,MAAMC,UAAU,GAAGf,eAAe,CAACgB,MAAM,CAAC,CAACC,GAAG,EAAEC,OAAO,KAAKD,GAAG,GAAG,CAACC,OAAO,CAAC3B,MAAM,IAAI,EAAE,EAAEC,MAAM,EAAE,CAAC,CAAC;MACnG,MAAM2B,OAAO,GAAI,aAAYJ,UAAW,cAAaf,eAAe,CAACR,MAAO,aAAY;MACxFM,WAAW,IAAIiB,UAAU;MACzBlB,WAAW,CAACuB,IAAI,CAAClB,KAAK,GAAGQ,SAAS,GAAGS,OAAO,CAAC;IAC/C,CAAC,CAAC;IACF,IAAI,CAACtB,WAAW,CAACL,MAAM,EAAE,OAAO,IAAI;IACpC,MAAMU,KAAK,GAAI,sEAAqE;IACpF,MAAMQ,SAAS,GAAGb,WAAW,CAACiB,IAAI,CAAC,MAAM,CAAC;IAC1C,MAAMO,UAAU,GAAG,IAAI,CAACvC,UAAU,CAACU,MAAM;IACzC,MAAM8B,WAAW,GAAGzB,WAAW,CAACL,MAAM;IACtC,MAAM+B,YAAY,GAAG,IAAI,CAACxC,YAAY,CAACS,MAAM,GAAG8B,WAAW;IAC3D,MAAME,YAAY,GAAGH,UAAU,GAAG,IAAI,CAACtC,YAAY,CAACS,MAAM;IAC1D,MAAM2B,OAAO,GAAI,iBAAgBE,UAAW,WAAUE,YAAa,eAAcD,WAAY,YAAWE,YAAa,2BAA0B1B,WAAY,GAAE;IAC7J,OAAOI,KAAK,GAAGQ,SAAS,GAAGS,OAAO;EACpC;EAEQN,8BAA8BA,CAACY,eAAgC,EAAE;IACvE,MAAMC,SAAS,GAAGD,eAAe,CAAClC,MAAM,IAAI,EAAE;IAC9C,MAAMA,MAAM,GAAGmC,SAAS,CAACf,GAAG,CAAEgB,CAAC,IAAM,OAAOA,CAAC,KAAK,QAAQ,GAAGA,CAAC,GAAGA,CAAC,CAACC,QAAQ,CAAC,CAAE,CAAC;IAC/E,OAAQ,cAAaH,eAAe,CAACI,SAAS,CAACpB,EAAE,CAACmB,QAAQ,CAAC,CAAE,KAAIrC,MAAM,CAACuB,IAAI,CAAC,IAAI,CAAE,EAAC;EACtF;AACF;AAACgB,OAAA,CAAAlD,eAAA,GAAAA,eAAA","ignoreList":[]}
+{"version":3,"names":["_chalk","data","_interopRequireDefault","require","_bitError","_buildTask","obj","__esModule","default","TaskResultsList","constructor","tasksQueue","tasksResults","capsuleRootDir","logger","hasErrors","some","taskResult","componentsResults","find","c","errors","length","throwErrorsIfExist","logStackTrace","errorMessage","getErrorMessageFormatted","BitError","tasksErrors","totalErrors","forEach","compsWithErrors","filter","title","chalk","bold","BuildTaskHelper","serializeId","task","env","id","errorsStr","map","compWithErrors","aggregateTaskErrorsToOneString","join","taskErrors","reduce","acc","current","summery","push","totalTasks","totalFailed","totalSucceed","totalSkipped","componentResult","rawErrors","e","toString","component","error","Error","name","exports"],"sources":["task-results-list.ts"],"sourcesContent":["import chalk from 'chalk';\nimport { Logger } from '@teambit/logger';\nimport { BitError } from '@teambit/bit-error';\nimport { BuildTaskHelper } from './build-task';\nimport { TasksQueue } from './tasks-queue';\nimport { TaskResults } from './build-pipe';\nimport { ComponentResult } from './types';\n\nexport class TaskResultsList {\n  constructor(\n    public tasksQueue: TasksQueue,\n    /**\n     * results of all tasks executed in the build pipeline.\n     */\n    public tasksResults: TaskResults[],\n\n    public capsuleRootDir: string,\n\n    private logger: Logger\n  ) {}\n\n  hasErrors(): boolean {\n    return this.tasksResults.some((taskResult) => taskResult.componentsResults.find((c) => c.errors?.length));\n  }\n\n  throwErrorsIfExist() {\n    this.logStackTrace();\n    const errorMessage = this.getErrorMessageFormatted();\n    if (errorMessage) {\n      throw new BitError(errorMessage);\n    }\n  }\n\n  /**\n   * group errors from all tasks and show them nicely to the user\n   */\n  getErrorMessageFormatted(): string | null {\n    const tasksErrors: string[] = [];\n    let totalErrors = 0;\n    this.tasksResults.forEach((taskResult) => {\n      const compsWithErrors = taskResult.componentsResults.filter((c) => c.errors?.length);\n      if (!compsWithErrors.length) return;\n      const title = chalk.bold(\n        `Failed task ${tasksErrors.length + 1}: \"${BuildTaskHelper.serializeId(taskResult.task)}\" of env \"${\n          taskResult.env.id\n        }\"\\n`\n      );\n      const errorsStr = compsWithErrors\n        .map((compWithErrors) => this.aggregateTaskErrorsToOneString(compWithErrors))\n        .join('\\n\\n');\n      const taskErrors = compsWithErrors.reduce((acc, current) => acc + (current.errors || []).length, 0);\n      const summery = `\\n\\nFound ${taskErrors} errors in ${compsWithErrors.length} components`;\n      totalErrors += taskErrors;\n      tasksErrors.push(title + errorsStr + summery);\n    });\n    if (!tasksErrors.length) return null;\n    const title = `\\nThe following errors were found while running the build pipeline\\n`;\n    const errorsStr = tasksErrors.join('\\n\\n');\n    const totalTasks = this.tasksQueue.length;\n    const totalFailed = tasksErrors.length;\n    const totalSucceed = this.tasksResults.length - totalFailed;\n    const totalSkipped = totalTasks - this.tasksResults.length;\n    const summery = `\\n\\n\\n✖ Total ${totalTasks} tasks. ${totalSucceed} succeeded. ${totalFailed} failed. ${totalSkipped} skipped. Total errors: ${totalErrors}.`;\n    return title + errorsStr + summery;\n  }\n\n  private aggregateTaskErrorsToOneString(componentResult: ComponentResult) {\n    const rawErrors = componentResult.errors || [];\n    const errors = rawErrors.map((e) => (typeof e === 'string' ? e : e.toString()));\n    return `component: ${componentResult.component.id.toString()}\\n${errors.join('\\n')}`;\n  }\n\n  private logStackTrace() {\n    this.tasksResults.forEach((taskResult) => {\n      taskResult.componentsResults.forEach((componentResult) => {\n        componentResult.errors?.forEach((error) => {\n          if (error instanceof Error) {\n            this.logger.error(\n              `failed running task ${taskResult.task.name} on ${componentResult.component.id.toString()}`,\n              error\n            );\n          }\n        });\n      });\n    });\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@teambit/builder",
-  "version": "1.0.234",
+  "version": "1.0.237",
   "homepage": "https://bit.cloud/teambit/pipelines/builder",
   "main": "dist/index.js",
   "componentId": {
     "scope": "teambit.pipelines",
     "name": "builder",
-    "version": "1.0.234"
+    "version": "1.0.237"
   },
   "dependencies": {
     "chalk": "2.4.2",
@@ -26,22 +26,22 @@
     "@teambit/harmony": "0.4.6",
     "@teambit/bit-error": "0.0.404",
     "@teambit/component-id": "1.2.0",
-    "@teambit/component": "1.0.234",
-    "@teambit/envs": "1.0.234",
+    "@teambit/component": "1.0.237",
+    "@teambit/envs": "1.0.237",
     "@teambit/logger": "0.0.955",
     "@teambit/toolbox.string.capitalize": "0.0.496",
-    "@teambit/tester": "1.0.234",
-    "@teambit/isolator": "1.0.234",
+    "@teambit/tester": "1.0.237",
+    "@teambit/isolator": "1.0.237",
     "@teambit/cli": "0.0.862",
-    "@teambit/workspace": "1.0.234",
-    "@teambit/aspect-loader": "1.0.234",
-    "@teambit/aspect": "1.0.234",
-    "@teambit/generator": "1.0.235",
+    "@teambit/workspace": "1.0.237",
+    "@teambit/aspect-loader": "1.0.237",
+    "@teambit/aspect": "1.0.237",
+    "@teambit/generator": "1.0.238",
     "@teambit/global-config": "0.0.865",
-    "@teambit/graphql": "1.0.234",
-    "@teambit/scope": "1.0.234",
+    "@teambit/graphql": "1.0.237",
+    "@teambit/scope": "1.0.237",
     "@teambit/toolbox.array.duplications-finder": "0.0.1",
-    "@teambit/ui": "1.0.234",
+    "@teambit/ui": "1.0.237",
     "@teambit/express": "0.0.961"
   },
   "devDependencies": {