@angular/cli 14.0.3 → 14.1.0-next.2

package/lib/cli/index.js

@@ -81,7 +81,7 @@ async function default_1(options) {
             }
             catch (e) {
                 logger.fatal(`An unhandled exception occurred: ${err.message}\n` +
-                    `Fatal error writing debug log file: ${e.message}`);
+                    `Fatal error writing debug log file: ${e}`);
                 if (err.stack) {
                     logger.fatal(err.stack);
                 }
@@ -95,7 +95,7 @@ async function default_1(options) {
             // Log nothing.
         }
         else {
-            logger.fatal(`An unexpected error occurred: ${'toString' in err ? err.toString() : JSON.stringify(err)}`);
+            logger.fatal(`An unexpected error occurred: ${err}`);
         }
         return 1;
     }

package/lib/config/schema.json

@@ -372,6 +372,7 @@
                     "enum": [
                       "@angular-devkit/build-angular:app-shell",
                       "@angular-devkit/build-angular:browser",
+                      "@angular-devkit/build-angular:browser-esbuild",
                       "@angular-devkit/build-angular:dev-server",
                       "@angular-devkit/build-angular:extract-i18n",
                       "@angular-devkit/build-angular:karma",
@@ -445,6 +446,28 @@
                 }
               }
             },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "builder": {
+                  "const": "@angular-devkit/build-angular:browser-esbuild"
+                },
+                "defaultConfiguration": {
+                  "type": "string",
+                  "description": "A default named configuration to use when a target configuration is not provided."
+                },
+                "options": {
+                  "$ref": "#/definitions/AngularDevkitBuildAngularBuildersBrowserEsbuildSchema"
+                },
+                "configurations": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/definitions/AngularDevkitBuildAngularBuildersBrowserEsbuildSchema"
+                  }
+                }
+              }
+            },
             {
               "type": "object",
               "additionalProperties": false,
@@ -2176,6 +2199,569 @@
         }
       }
     },
+    "AngularDevkitBuildAngularBuildersBrowserEsbuildSchema": {
+      "title": "Esbuild browser schema for Build Facade.",
+      "description": "Browser target options",
+      "type": "object",
+      "properties": {
+        "assets": {
+          "type": "array",
+          "description": "List of static application assets.",
+          "default": [],
+          "items": {
+            "$ref": "#/definitions/AngularDevkitBuildAngularBuildersBrowserEsbuildSchema/definitions/assetPattern"
+          }
+        },
+        "main": {
+          "type": "string",
+          "description": "The full path for the main entry point to the app, relative to the current workspace."
+        },
+        "polyfills": {
+          "type": "string",
+          "description": "The full path for the polyfills file, relative to the current workspace."
+        },
+        "tsConfig": {
+          "type": "string",
+          "description": "The full path for the TypeScript configuration file, relative to the current workspace."
+        },
+        "scripts": {
+          "description": "Global scripts to be included in the build.",
+          "type": "array",
+          "default": [],
+          "items": {
+            "oneOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "input": {
+                    "type": "string",
+                    "description": "The file to include.",
+                    "pattern": "\\.[cm]?jsx?$"
+                  },
+                  "bundleName": {
+                    "type": "string",
+                    "pattern": "^[\\w\\-.]*$",
+                    "description": "The bundle name for this extra entry point."
+                  },
+                  "inject": {
+                    "type": "boolean",
+                    "description": "If the bundle will be referenced in the HTML file.",
+                    "default": true
+                  }
+                },
+                "additionalProperties": false
+              },
+              {
+                "type": "string",
+                "description": "The file to include.",
+                "pattern": "\\.[cm]?jsx?$"
+              }
+            ]
+          }
+        },
+        "styles": {
+          "description": "Global styles to be included in the build.",
+          "type": "array",
+          "default": [],
+          "items": {
+            "oneOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "input": {
+                    "type": "string",
+                    "description": "The file to include.",
+                    "pattern": "\\.(?:css|scss|sass|less|styl)$"
+                  },
+                  "bundleName": {
+                    "type": "string",
+                    "pattern": "^[\\w\\-.]*$",
+                    "description": "The bundle name for this extra entry point."
+                  },
+                  "inject": {
+                    "type": "boolean",
+                    "description": "If the bundle will be referenced in the HTML file.",
+                    "default": true
+                  }
+                },
+                "additionalProperties": false
+              },
+              {
+                "type": "string",
+                "description": "The file to include.",
+                "pattern": "\\.(?:css|scss|sass|less|styl)$"
+              }
+            ]
+          }
+        },
+        "inlineStyleLanguage": {
+          "description": "The stylesheet language to use for the application's inline component styles.",
+          "type": "string",
+          "default": "css",
+          "enum": [
+            "css",
+            "less",
+            "sass",
+            "scss"
+          ]
+        },
+        "stylePreprocessorOptions": {
+          "description": "Options to pass to style preprocessors.",
+          "type": "object",
+          "properties": {
+            "includePaths": {
+              "description": "Paths to include. Paths will be resolved to workspace root.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": []
+            }
+          },
+          "additionalProperties": false
+        },
+        "externalDependencies": {
+          "description": "Exclude the listed external dependencies from being bundled into the bundle. Instead, the created bundle relies on these dependencies to be available during runtime.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "optimization": {
+          "description": "Enables optimization of the build output. Including minification of scripts and styles, tree-shaking, dead-code elimination, inlining of critical CSS and fonts inlining. For more information, see https://angular.io/guide/workspace-config#optimization-configuration.",
+          "x-user-analytics": 16,
+          "default": true,
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "scripts": {
+                  "type": "boolean",
+                  "description": "Enables optimization of the scripts output.",
+                  "default": true
+                },
+                "styles": {
+                  "description": "Enables optimization of the styles output.",
+                  "default": true,
+                  "oneOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "minify": {
+                          "type": "boolean",
+                          "description": "Minify CSS definitions by removing extraneous whitespace and comments, merging identifiers and minimizing values.",
+                          "default": true
+                        },
+                        "inlineCritical": {
+                          "type": "boolean",
+                          "description": "Extract and inline critical CSS definitions to improve first paint time.",
+                          "default": true
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "boolean"
+                    }
+                  ]
+                },
+                "fonts": {
+                  "description": "Enables optimization for fonts. This option requires internet access. `HTTPS_PROXY` environment variable can be used to specify a proxy server.",
+                  "default": true,
+                  "oneOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "inline": {
+                          "type": "boolean",
+                          "description": "Reduce render blocking requests by inlining external Google Fonts and Adobe Fonts CSS definitions in the application's HTML index file. This option requires internet access. `HTTPS_PROXY` environment variable can be used to specify a proxy server.",
+                          "default": true
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "boolean"
+                    }
+                  ]
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "boolean"
+            }
+          ]
+        },
+        "fileReplacements": {
+          "description": "Replace compilation source files with other compilation source files in the build.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AngularDevkitBuildAngularBuildersBrowserEsbuildSchema/definitions/fileReplacement"
+          },
+          "default": []
+        },
+        "outputPath": {
+          "type": "string",
+          "description": "The full path for the new output directory, relative to the current workspace.\nBy default, writes output to a folder named dist/ in the current project."
+        },
+        "resourcesOutputPath": {
+          "type": "string",
+          "description": "The path where style resources will be placed, relative to outputPath."
+        },
+        "aot": {
+          "type": "boolean",
+          "description": "Build using Ahead of Time compilation.",
+          "x-user-analytics": 13,
+          "default": true
+        },
+        "sourceMap": {
+          "description": "Output source maps for scripts and styles. For more information, see https://angular.io/guide/workspace-config#source-map-configuration.",
+          "default": false,
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "scripts": {
+                  "type": "boolean",
+                  "description": "Output source maps for all scripts.",
+                  "default": true
+                },
+                "styles": {
+                  "type": "boolean",
+                  "description": "Output source maps for all styles.",
+                  "default": true
+                },
+                "hidden": {
+                  "type": "boolean",
+                  "description": "Output source maps used for error reporting tools.",
+                  "default": false
+                },
+                "vendor": {
+                  "type": "boolean",
+                  "description": "Resolve vendor packages source maps.",
+                  "default": false
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "boolean"
+            }
+          ]
+        },
+        "vendorChunk": {
+          "type": "boolean",
+          "description": "Generate a seperate bundle containing only vendor libraries. This option should only used for development.",
+          "default": false
+        },
+        "commonChunk": {
+          "type": "boolean",
+          "description": "Generate a seperate bundle containing code used across multiple bundles.",
+          "default": true
+        },
+        "baseHref": {
+          "type": "string",
+          "description": "Base url for the application being built."
+        },
+        "deployUrl": {
+          "type": "string",
+          "description": "URL where files will be deployed.",
+          "x-deprecated": "Use \"baseHref\" option, \"APP_BASE_HREF\" DI token or a combination of both instead. For more information, see https://angular.io/guide/deployment#the-deploy-url."
+        },
+        "verbose": {
+          "type": "boolean",
+          "description": "Adds more details to output logging.",
+          "default": false
+        },
+        "progress": {
+          "type": "boolean",
+          "description": "Log progress to the console while building.",
+          "default": true
+        },
+        "i18nMissingTranslation": {
+          "type": "string",
+          "description": "How to handle missing translations for i18n.",
+          "enum": [
+            "warning",
+            "error",
+            "ignore"
+          ],
+          "default": "warning"
+        },
+        "i18nDuplicateTranslation": {
+          "type": "string",
+          "description": "How to handle duplicate translations for i18n.",
+          "enum": [
+            "warning",
+            "error",
+            "ignore"
+          ],
+          "default": "warning"
+        },
+        "localize": {
+          "description": "Translate the bundles in one or more locales.",
+          "oneOf": [
+            {
+              "type": "boolean",
+              "description": "Translate all locales."
+            },
+            {
+              "type": "array",
+              "description": "List of locales ID's to translate.",
+              "minItems": 1,
+              "items": {
+                "type": "string",
+                "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z]{4})?(-([a-zA-Z]{2}|[0-9]{3}))?(-[a-zA-Z]{5,8})?(-x(-[a-zA-Z0-9]{1,8})+)?$"
+              }
+            }
+          ]
+        },
+        "watch": {
+          "type": "boolean",
+          "description": "Run build when files change.",
+          "default": false
+        },
+        "outputHashing": {
+          "type": "string",
+          "description": "Define the output filename cache-busting hashing mode.",
+          "default": "none",
+          "enum": [
+            "none",
+            "all",
+            "media",
+            "bundles"
+          ]
+        },
+        "poll": {
+          "type": "number",
+          "description": "Enable and define the file watching poll time period in milliseconds."
+        },
+        "deleteOutputPath": {
+          "type": "boolean",
+          "description": "Delete the output path before building.",
+          "default": true
+        },
+        "preserveSymlinks": {
+          "type": "boolean",
+          "description": "Do not use the real path when resolving modules. If unset then will default to `true` if NodeJS option --preserve-symlinks is set."
+        },
+        "extractLicenses": {
+          "type": "boolean",
+          "description": "Extract all licenses in a separate file.",
+          "default": true
+        },
+        "buildOptimizer": {
+          "type": "boolean",
+          "description": "Enables advanced build optimizations when using the 'aot' option.",
+          "default": true
+        },
+        "namedChunks": {
+          "type": "boolean",
+          "description": "Use file name for lazy loaded chunks.",
+          "default": false
+        },
+        "subresourceIntegrity": {
+          "type": "boolean",
+          "description": "Enables the use of subresource integrity validation.",
+          "default": false
+        },
+        "serviceWorker": {
+          "type": "boolean",
+          "description": "Generates a service worker config for production builds.",
+          "default": false
+        },
+        "ngswConfigPath": {
+          "type": "string",
+          "description": "Path to ngsw-config.json."
+        },
+        "index": {
+          "description": "Configures the generation of the application's HTML index.",
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "The path of a file to use for the application's HTML index. The filename of the specified path will be used for the generated file and will be created in the root of the application's configured output path."
+            },
+            {
+              "type": "object",
+              "description": "",
+              "properties": {
+                "input": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The path of a file to use for the application's generated HTML index."
+                },
+                "output": {
+                  "type": "string",
+                  "minLength": 1,
+                  "default": "index.html",
+                  "description": "The output path of the application's generated HTML index file. The full provided path will be used and will be considered relative to the application's configured output path."
+                }
+              }
+            }
+          ]
+        },
+        "statsJson": {
+          "type": "boolean",
+          "description": "Generates a 'stats.json' file which can be analyzed using tools such as 'webpack-bundle-analyzer'.",
+          "default": false
+        },
+        "budgets": {
+          "description": "Budget thresholds to ensure parts of your application stay within boundaries which you set.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AngularDevkitBuildAngularBuildersBrowserEsbuildSchema/definitions/budget"
+          },
+          "default": []
+        },
+        "webWorkerTsConfig": {
+          "type": "string",
+          "description": "TypeScript configuration for Web Worker modules."
+        },
+        "crossOrigin": {
+          "type": "string",
+          "description": "Define the crossorigin attribute setting of elements that provide CORS support.",
+          "default": "none",
+          "enum": [
+            "none",
+            "anonymous",
+            "use-credentials"
+          ]
+        },
+        "allowedCommonJsDependencies": {
+          "description": "A list of CommonJS packages that are allowed to be used without a build time warning.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false,
+      "definitions": {
+        "assetPattern": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "followSymlinks": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Allow glob patterns to follow symlink directories. This allows subdirectories of the symlink to be searched."
+                },
+                "glob": {
+                  "type": "string",
+                  "description": "The pattern to match."
+                },
+                "input": {
+                  "type": "string",
+                  "description": "The input directory path in which to apply 'glob'. Defaults to the project root."
+                },
+                "ignore": {
+                  "description": "An array of globs to ignore.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "output": {
+                  "type": "string",
+                  "description": "Absolute path within the output."
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "fileReplacement": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "src": {
+                  "type": "string",
+                  "pattern": "\\.(([cm]?j|t)sx?|json)$"
+                },
+                "replaceWith": {
+                  "type": "string",
+                  "pattern": "\\.(([cm]?j|t)sx?|json)$"
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "replace": {
+                  "type": "string",
+                  "pattern": "\\.(([cm]?j|t)sx?|json)$"
+                },
+                "with": {
+                  "type": "string",
+                  "pattern": "\\.(([cm]?j|t)sx?|json)$"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "budget": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "description": "The type of budget.",
+              "enum": [
+                "all",
+                "allScript",
+                "any",
+                "anyScript",
+                "anyComponentStyle",
+                "bundle",
+                "initial"
+              ]
+            },
+            "name": {
+              "type": "string",
+              "description": "The name of the bundle."
+            },
+            "baseline": {
+              "type": "string",
+              "description": "The baseline size for comparison."
+            },
+            "maximumWarning": {
+              "type": "string",
+              "description": "The maximum threshold for warning relative to the baseline."
+            },
+            "maximumError": {
+              "type": "string",
+              "description": "The maximum threshold for error relative to the baseline."
+            },
+            "minimumWarning": {
+              "type": "string",
+              "description": "The minimum threshold for warning relative to the baseline."
+            },
+            "minimumError": {
+              "type": "string",
+              "description": "The minimum threshold for error relative to the baseline."
+            },
+            "warning": {
+              "type": "string",
+              "description": "The threshold for warning relative to the baseline (min & max)."
+            },
+            "error": {
+              "type": "string",
+              "description": "The threshold for error relative to the baseline (min & max)."
+            }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
     "AngularDevkitBuildAngularBuildersDevServerSchema": {
       "title": "Dev Server Target",
       "description": "Dev Server target options for Build Facade.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "14.0.3",
+  "version": "14.1.0-next.2",
   "description": "CLI tool for Angular",
   "main": "lib/cli/index.js",
   "bin": {
@@ -25,12 +25,12 @@
   },
   "homepage": "https://github.com/angular/angular-cli",
   "dependencies": {
-    "@angular-devkit/architect": "0.1400.3",
-    "@angular-devkit/core": "14.0.3",
-    "@angular-devkit/schematics": "14.0.3",
-    "@schematics/angular": "14.0.3",
+    "@angular-devkit/architect": "0.1401.0-next.2",
+    "@angular-devkit/core": "14.1.0-next.2",
+    "@angular-devkit/schematics": "14.1.0-next.2",
+    "@schematics/angular": "14.1.0-next.2",
     "@yarnpkg/lockfile": "1.1.0",
-    "ansi-colors": "4.1.1",
+    "ansi-colors": "4.1.3",
     "debug": "4.3.4",
     "ini": "3.0.0",
     "inquirer": "8.2.4",
@@ -39,22 +39,22 @@
     "npm-pick-manifest": "7.0.1",
     "open": "8.4.0",
     "ora": "5.4.1",
-    "pacote": "13.3.0",
+    "pacote": "13.6.0",
     "resolve": "1.22.0",
     "semver": "7.3.7",
     "symbol-observable": "4.0.0",
     "uuid": "8.3.2",
-    "yargs": "17.4.1"
+    "yargs": "17.5.1"
   },
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "14.0.3",
-      "@angular-devkit/architect": "0.1400.3",
-      "@angular-devkit/build-angular": "14.0.3",
-      "@angular-devkit/build-webpack": "0.1400.3",
-      "@angular-devkit/core": "14.0.3",
-      "@angular-devkit/schematics": "14.0.3"
+      "@angular/cli": "14.1.0-next.2",
+      "@angular-devkit/architect": "0.1401.0-next.2",
+      "@angular-devkit/build-angular": "14.1.0-next.2",
+      "@angular-devkit/build-webpack": "0.1401.0-next.2",
+      "@angular-devkit/core": "14.1.0-next.2",
+      "@angular-devkit/schematics": "14.1.0-next.2"
     }
   },
   "engines": {

package/src/analytics/analytics.js

@@ -40,6 +40,7 @@ const uuid_1 = require("uuid");
 const color_1 = require("../utilities/color");
 const config_1 = require("../utilities/config");
 const environment_options_1 = require("../utilities/environment-options");
+const error_1 = require("../utilities/error");
 const tty_1 = require("../utilities/tty");
 const version_1 = require("../utilities/version");
 const analytics_collector_1 = require("./analytics-collector");
@@ -200,6 +201,7 @@ async function getAnalytics(level) {
         }
     }
     catch (err) {
+        (0, error_1.assertIsError)(err);
         analyticsDebug('Error happened during reading of analytics config: %s', err.message);
         return undefined;
     }
@@ -229,6 +231,7 @@ async function getSharedAnalytics() {
         }
     }
     catch (err) {
+        (0, error_1.assertIsError)(err);
         analyticsDebug('Error happened during reading of analytics sharing config: %s', err.message);
         return undefined;
     }

package/src/command-builder/architect-base-command-module.js

@@ -15,6 +15,7 @@ const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const analytics_1 = require("../analytics/analytics");
+const error_1 = require("../utilities/error");
 const prompt_1 = require("../utilities/prompt");
 const tty_1 = require("../utilities/tty");
 const command_module_1 = require("./command-module");
@@ -32,6 +33,7 @@ class ArchitectBaseCommandModule extends command_module_1.CommandModule {
             builderName = await architectHost.getBuilderNameForTarget(target);
         }
         catch (e) {
+            (0, error_1.assertIsError)(e);
             return this.onMissingTarget(e.message);
         }
         await this.reportAnalytics({
@@ -81,6 +83,7 @@ class ArchitectBaseCommandModule extends command_module_1.CommandModule {
             builderDesc = await architectHost.resolveBuilder(builderConf);
         }
         catch (e) {
+            (0, error_1.assertIsError)(e);
             if (e.code === 'MODULE_NOT_FOUND') {
                 this.warnOnMissingNodeModules();
                 throw new command_module_1.CommandModuleError(`Could not find the '${builderConf}' builder's node package.`);

package/src/command-builder/command-runner.js

@@ -34,6 +34,7 @@ const cli_18 = require("../commands/update/cli");
 const cli_19 = require("../commands/version/cli");
 const color_1 = require("../utilities/color");
 const config_1 = require("../utilities/config");
+const error_1 = require("../utilities/error");
 const package_manager_1 = require("../utilities/package-manager");
 const command_module_1 = require("./command-module");
 const command_1 = require("./utilities/command");
@@ -78,6 +79,7 @@ async function runCommand(args, logger) {
         ]);
     }
     catch (e) {
+        (0, error_1.assertIsError)(e);
         logger.fatal(e.message);
         return 1;
     }

package/src/command-builder/schematics-command-module.js

@@ -42,6 +42,7 @@ const schematics_1 = require("@angular-devkit/schematics");
 const tools_1 = require("@angular-devkit/schematics/tools");
 const path_1 = require("path");
 const config_1 = require("../utilities/config");
+const error_1 = require("../utilities/error");
 const memoize_1 = require("../utilities/memoize");
 const tty_1 = require("../utilities/tty");
 const command_module_1 = require("./command-module");
@@ -307,6 +308,7 @@ class SchematicsCommandModule extends command_module_1.CommandModule {
                 logger.fatal('The Schematic workflow failed. See above.');
             }
             else {
+                (0, error_1.assertIsError)(err);
                 logger.fatal(err.message);
             }
             return 1;

package/src/command-builder/utilities/schematic-engine-host.js

@@ -19,6 +19,7 @@ const jsonc_parser_1 = require("jsonc-parser");
 const module_1 = __importDefault(require("module"));
 const path_1 = require("path");
 const vm_1 = require("vm");
+const error_1 = require("../../utilities/error");
 /**
  * Environment variable to control schematic package redirection
  */
@@ -127,6 +128,7 @@ function wrap(schematicFile, schematicDirectory, moduleCache, exportName) {
                     return schematicRequire(id);
                 }
                 catch (e) {
+                    (0, error_1.assertIsError)(e);
                     if (e.code !== 'MODULE_NOT_FOUND') {
                         throw e;
                     }

package/src/commands/add/cli.js

@@ -20,6 +20,7 @@ const workspace_schema_1 = require("../../../lib/config/workspace-schema");
 const analytics_1 = require("../../analytics/analytics");
 const schematics_command_module_1 = require("../../command-builder/schematics-command-module");
 const color_1 = require("../../utilities/color");
+const error_1 = require("../../utilities/error");
 const package_metadata_1 = require("../../utilities/package-metadata");
 const prompt_1 = require("../../utilities/prompt");
 const spinner_1 = require("../../utilities/spinner");
@@ -90,6 +91,7 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
             packageIdentifier = (0, npm_package_arg_1.default)(collection);
         }
         catch (e) {
+            (0, error_1.assertIsError)(e);
             logger.error(e.message);
             return 1;
         }
@@ -120,6 +122,7 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
                 });
             }
             catch (e) {
+                (0, error_1.assertIsError)(e);
                 spinner.fail(`Unable to load package information from registry: ${e.message}`);
                 return 1;
             }
@@ -190,6 +193,7 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
             }
         }
         catch (e) {
+            (0, error_1.assertIsError)(e);
             spinner.fail(`Unable to fetch package information for '${packageIdentifier}': ${e.message}`);
             return 1;
         }
@@ -266,6 +270,7 @@ class AddCommandModule extends schematics_command_module_1.SchematicsCommandModu
             return true;
         }
         catch (e) {
+            (0, error_1.assertIsError)(e);
             if (e.code !== 'MODULE_NOT_FOUND') {
                 throw e;
             }

package/src/commands/completion/cli.js

@@ -17,6 +17,7 @@ const command_module_1 = require("../../command-builder/command-module");
 const command_1 = require("../../command-builder/utilities/command");
 const color_1 = require("../../utilities/color");
 const completion_1 = require("../../utilities/completion");
+const error_1 = require("../../utilities/error");
 class CompletionCommandModule extends command_module_1.CommandModule {
     constructor() {
         super(...arguments);
@@ -33,6 +34,7 @@ class CompletionCommandModule extends command_module_1.CommandModule {
             rcFile = await (0, completion_1.initializeAutocomplete)();
         }
         catch (err) {
+            (0, error_1.assertIsError)(err);
             this.context.logger.error(err.message);
             return 1;
         }

package/src/commands/update/cli.js

@@ -49,6 +49,7 @@ const schematic_engine_host_1 = require("../../command-builder/utilities/schemat
 const schematic_workflow_1 = require("../../command-builder/utilities/schematic-workflow");
 const color_1 = require("../../utilities/color");
 const environment_options_1 = require("../../utilities/environment-options");
+const error_1 = require("../../utilities/error");
 const log_file_1 = require("../../utilities/log-file");
 const package_metadata_1 = require("../../utilities/package-metadata");
 const package_tree_1 = require("../../utilities/package-tree");
@@ -179,6 +180,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 packages.push(packageIdentifier);
             }
             catch (e) {
+                (0, error_1.assertIsError)(e);
                 logger.error(e.message);
                 return 1;
             }
@@ -231,6 +233,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 logger.error(`${color_1.colors.symbols.cross} Migration failed. See above for further details.\n`);
             }
             else {
+                (0, error_1.assertIsError)(e);
                 const logPath = (0, log_file_1.writeErrorToLogFile)(e);
                 logger.fatal(`${color_1.colors.symbols.cross} Migration failed: ${e.message}\n` +
                     `  See "${logPath}" for further details.\n`);
@@ -367,6 +370,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 migrations = require.resolve(migrations, { paths: [packagePath] });
             }
             catch (e) {
+                (0, error_1.assertIsError)(e);
                 if (e.code === 'MODULE_NOT_FOUND') {
                     logger.error('Migrations for package were not found.');
                 }
@@ -426,6 +430,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                 });
             }
             catch (e) {
+                (0, error_1.assertIsError)(e);
                 logger.error(`Error fetching metadata for '${packageName}': ` + e.message);
                 return 1;
             }
@@ -439,6 +444,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                     manifest = (0, npm_pick_manifest_1.default)(metadata, requestIdentifier.fetchSpec);
                 }
                 catch (e) {
+                    (0, error_1.assertIsError)(e);
                     if (e.code === 'ETARGET') {
                         // If not found and next was used and user did not provide a specifier, try latest.
                         // Package may not have a next tag.
@@ -449,6 +455,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                                 manifest = (0, npm_pick_manifest_1.default)(metadata, 'latest');
                             }
                             catch (e) {
+                                (0, error_1.assertIsError)(e);
                                 if (e.code !== 'ETARGET' && e.code !== 'ENOVERSIONS') {
                                     throw e;
                                 }
@@ -555,6 +562,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                         }));
                     }
                     catch (e) {
+                        (0, error_1.assertIsError)(e);
                         if (e.code === 'MODULE_NOT_FOUND') {
                             // Fallback to trying to resolve the package's main entry point
                             packagePath = require.resolve(migration.package, { paths: [this.context.root] });
@@ -565,6 +573,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                     }
                 }
                 catch (e) {
+                    (0, error_1.assertIsError)(e);
                     if (e.code === 'MODULE_NOT_FOUND') {
                         logVerbose(e.toString());
                         logger.error(`Migrations for package (${migration.package}) were not found.` +
@@ -588,6 +597,7 @@ class UpdateCommandModule extends command_module_1.CommandModule {
                         migrations = require.resolve(migration.collection, { paths: [packagePath] });
                     }
                     catch (e) {
+                        (0, error_1.assertIsError)(e);
                         if (e.code === 'MODULE_NOT_FOUND') {
                             logger.error(`Migrations for package (${migration.package}) were not found.`);
                         }

package/src/commands/update/schematic/index.js

@@ -35,6 +35,7 @@ const core_1 = require("@angular-devkit/core");
 const schematics_1 = require("@angular-devkit/schematics");
 const npa = __importStar(require("npm-package-arg"));
 const semver = __importStar(require("semver"));
+const error_1 = require("../../../utilities/error");
 const package_metadata_1 = require("../../../utilities/package-metadata");
 // Angular guarantees that a major is compatible with its following major (so packages that depend
 // on Angular 5 are also compatible with Angular 6). This is, in code, represented by verifying
@@ -199,6 +200,7 @@ function _performUpdate(tree, context, infoMap, logger, migrateOnly) {
         packageJson = JSON.parse(packageJsonContent.toString());
     }
     catch (e) {
+        (0, error_1.assertIsError)(e);
         throw new schematics_1.SchematicsException('package.json could not be parsed: ' + e.message);
     }
     const updateDependency = (deps, name, newVersion) => {
@@ -588,6 +590,7 @@ function _getAllDependencies(tree) {
         packageJson = JSON.parse(packageJsonContent.toString());
     }
     catch (e) {
+        (0, error_1.assertIsError)(e);
         throw new schematics_1.SchematicsException('package.json could not be parsed: ' + e.message);
     }
     return [

package/src/utilities/completion.js

@@ -40,6 +40,7 @@ const color_1 = require("../utilities/color");
 const config_1 = require("../utilities/config");
 const environment_options_1 = require("../utilities/environment-options");
 const tty_1 = require("../utilities/tty");
+const error_1 = require("./error");
 /**
  * Checks if it is appropriate to prompt the user to setup autocompletion. If not, does nothing. If
  * so prompts and sets up autocompletion for the user. Returns an exit code if the program should
@@ -71,6 +72,7 @@ Ok, you won't be prompted again. Should you change your mind, the following comm
         rcFile = await initializeAutocomplete();
     }
     catch (err) {
+        (0, error_1.assertIsError)(err);
         // Failed to set up autocompeletion, log the error and abort.
         logger.error(err.message);
         return 1;
@@ -213,6 +215,7 @@ async function initializeAutocomplete() {
         await fs_1.promises.appendFile(rcFile, '\n\n# Load Angular CLI autocompletion.\nsource <(ng completion script)\n');
     }
     catch (err) {
+        (0, error_1.assertIsError)(err);
         throw new Error(`Failed to append autocompletion setup to \`${rcFile}\`:\n${err.message}`);
     }
     return rcFile;

package/src/utilities/error.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+export declare function assertIsError(value: unknown): asserts value is Error & {
+    code?: string;
+};

package/src/utilities/error.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertIsError = void 0;
+const assert_1 = __importDefault(require("assert"));
+function assertIsError(value) {
+    (0, assert_1.default)(value instanceof Error, 'catch clause variable is not an Error instance');
+}
+exports.assertIsError = assertIsError;