@ms-cloudpack/cli 0.73.5 → 0.73.7

package/lib/commands/init/InitSummaryData.d.ts

@@ -3,6 +3,7 @@ import type { GeneratedPackageChanges } from './types/GeneratedPackageChanges.js
 import type { InitPackageResult } from './types/InitPackageResult.js';
 import type { InitOptions } from './types/InitOptions.js';
 import type { BundleMessage } from '@ms-cloudpack/common-types';
+import { type GeneratedChange } from './types/GeneratedChange.js';
 import type { EnsurePackageBundledResult } from '@ms-cloudpack/api-server';
 /**
  * Creates a summary tracking helper for the `init` verb to use to record statistics about results and needed
@@ -13,7 +14,9 @@ import type { EnsurePackageBundledResult } from '@ms-cloudpack/api-server';
 export declare class InitSummaryData {
     /** Set this to indicate that the generated config was deleted. */
     deletedGeneratedConfig: boolean;
+    /** Mapping from absolute package path to results */
     private _packageResults;
+    /** Mapping from absolute package path to generated config updates */
     private _generatedUpdates;
     private _startTime;
     private _appPath;
@@ -26,17 +29,22 @@ export declare class InitSummaryData {
      */
     hasChanges(): boolean;
     /**
-     * Saves a package result.
+     * Saves a package bundle result. Overwrites the previous result if there was one.
+     * @param packagePath - Absolute package path
      */
     recordResult(packagePath: string, result: Pick<EnsurePackageBundledResult, 'name' | 'version' | 'info' | 'outputPath' | 'errors' | 'warnings'>): void;
     /**
      * Record an exception for a given package path.
      * This creates a bundle message like "Error thrown while (context): (error)".
+     *
      * (Unlike `addErrors`, this will create an overall package result if one doesn't exist yet.)
      */
     recordException(params: {
+        /** Absolute package path */
         packagePath: string;
+        /** Error object or other caught item */
         error: unknown;
+        /** Bundler or step that generated this message. */
         source: string;
         /** Description of the context in which the error was thrown, e.g. "evaluating package" */
         context: string;
@@ -47,20 +55,27 @@ export declare class InitSummaryData {
     }): void;
     /**
      * Record more errors for a given package path.
+     * @param packagePath - Absolute package path
      */
     addErrors(packagePath: string, errors: BundleMessage[]): void;
     /**
      * Record more warnings for a given package path.
+     * @param packagePath - Absolute package path
      */
     addWarnings(packagePath: string, warnings: BundleMessage[]): void;
     /**
-     * Returns the package results.
-     * @returns The package results.
+     * Get the recorded package results.
+     * @returns Mapping from absolute package path to results
      */
     getResults(): Record<string, InitPackageResult>;
     /**
-     * Saves a generated file update.
-     * @param allChanges - The generated file update to save.
+     * Get the recorded generated config updates.
+     * @returns Mapping from absolute package path to generated config updates
+     */
+    getGeneratedChanges(): Record<string, GeneratedPackageChanges>;
+    /**
+     * Save generated config updates, potentially from multiple packages.
+     * @param allChanges - The generated config update to save.
      */
     recordGeneratedChanges(allChanges: GeneratedPackageChanges[]): void;
     /**
@@ -68,4 +83,9 @@ export declare class InitSummaryData {
      */
     summarize(): InitSummary;
 }
+/**
+ * Sort generated changes in-place alphabetically by `.change` (description).
+ * Returns the array for convenience (though it's the same object).
+ */
+export declare function sortChanges(changes: GeneratedChange[]): GeneratedChange[];
 //# sourceMappingURL=InitSummaryData.d.ts.map

package/lib/commands/init/InitSummaryData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InitSummaryData.d.ts","sourceRoot":"","sources":["../../../src/commands/init/InitSummaryData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,kEAAkE;IAC3D,sBAAsB,UAAS;IAEtC,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAU;gBAGtB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;QACnC,OAAO,EAAE,MAAM,CAAC;KACjB;IASH;;OAEG;IACI,UAAU,IAAI,OAAO;IAI5B;;OAEG;IACI,YAAY,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC,GAC3G,IAAI;IAYP;;;;OAIG;IACI,eAAe,CAAC,MAAM,EAAE;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,0FAA0F;QAC1F,OAAO,EAAE,MAAM,CAAC;QAChB,4EAA4E;QAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,+EAA+E;QAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;IAUR;;OAEG;IACI,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IASpE;;OAEG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IASxE;;;OAGG;IACI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAItD;;;OAGG;IACI,sBAAsB,CAAC,UAAU,EAAE,uBAAuB,EAAE,GAAG,IAAI;IAY1E;;OAEG;IACI,SAAS,IAAI,WAAW;CAgDhC"}
+{"version":3,"file":"InitSummaryData.d.ts","sourceRoot":"","sources":["../../../src/commands/init/InitSummaryData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,kEAAkE;IAC3D,sBAAsB,UAAS;IAEtC,oDAAoD;IACpD,OAAO,CAAC,eAAe,CAAoC;IAC3D,qEAAqE;IACrE,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAU;gBAGtB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;QACnC,OAAO,EAAE,MAAM,CAAC;KACjB;IASH;;OAEG;IACI,UAAU,IAAI,OAAO;IAI5B;;;OAGG;IACI,YAAY,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC,GAC3G,IAAI;IAaP;;;;;OAKG;IACI,eAAe,CAAC,MAAM,EAAE;QAC7B,4BAA4B;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,wCAAwC;QACxC,KAAK,EAAE,OAAO,CAAC;QACf,mDAAmD;QACnD,MAAM,EAAE,MAAM,CAAC;QACf,0FAA0F;QAC1F,OAAO,EAAE,MAAM,CAAC;QAChB,4EAA4E;QAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,+EAA+E;QAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;IAUR;;;OAGG;IACI,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IASpE;;;OAGG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IASxE;;;OAGG;IACI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAItD;;;OAGG;IACI,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAIrE;;;OAGG;IACI,sBAAsB,CAAC,UAAU,EAAE,uBAAuB,EAAE,GAAG,IAAI;IAY1E;;OAEG;IACI,SAAS,IAAI,WAAW;CAgDhC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAEzE"}

package/lib/commands/init/InitSummaryData.js

@@ -8,7 +8,9 @@ import { requiredChangeTypes } from './types/GeneratedChange.js';
 export class InitSummaryData {
     /** Set this to indicate that the generated config was deleted. */
     deletedGeneratedConfig = false;
+    /** Mapping from absolute package path to results */
     _packageResults;
+    /** Mapping from absolute package path to generated config updates */
     _generatedUpdates;
     _startTime;
     _appPath;
@@ -27,22 +29,25 @@ export class InitSummaryData {
         return Object.values(this._generatedUpdates).length > 0;
     }
     /**
-     * Saves a package result.
+     * Saves a package bundle result. Overwrites the previous result if there was one.
+     * @param packagePath - Absolute package path
      */
     recordResult(packagePath, result) {
         this._packageResults[packagePath] = {
             path: packagePath,
             name: result.name,
             version: result.version,
-            info: result.info,
-            outputPath: result.outputPath,
-            errors: result.errors,
-            warnings: result.warnings,
+            // this is mainly for easier testing: don't set properties if they'll be undefined
+            ...(result.info && { info: result.info }),
+            ...(result.outputPath && { outputPath: result.outputPath }),
+            ...(result.errors && { errors: result.errors }),
+            ...(result.warnings && { warnings: result.warnings }),
         };
     }
     /**
      * Record an exception for a given package path.
      * This creates a bundle message like "Error thrown while (context): (error)".
+     *
      * (Unlike `addErrors`, this will create an overall package result if one doesn't exist yet.)
      */
     recordException(params) {
@@ -55,6 +60,7 @@ export class InitSummaryData {
     }
     /**
      * Record more errors for a given package path.
+     * @param packagePath - Absolute package path
      */
     addErrors(packagePath, errors) {
         const packageResult = this._packageResults[packagePath];
@@ -65,6 +71,7 @@ export class InitSummaryData {
     }
     /**
      * Record more warnings for a given package path.
+     * @param packagePath - Absolute package path
      */
     addWarnings(packagePath, warnings) {
         const packageResult = this._packageResults[packagePath];
@@ -74,15 +81,22 @@ export class InitSummaryData {
         packageResult.warnings = [...(packageResult.warnings || []), ...warnings];
     }
     /**
-     * Returns the package results.
-     * @returns The package results.
+     * Get the recorded package results.
+     * @returns Mapping from absolute package path to results
      */
     getResults() {
         return this._packageResults;
     }
     /**
-     * Saves a generated file update.
-     * @param allChanges - The generated file update to save.
+     * Get the recorded generated config updates.
+     * @returns Mapping from absolute package path to generated config updates
+     */
+    getGeneratedChanges() {
+        return this._generatedUpdates;
+    }
+    /**
+     * Save generated config updates, potentially from multiple packages.
+     * @param allChanges - The generated config update to save.
      */
     recordGeneratedChanges(allChanges) {
         for (const update of allChanges) {
@@ -123,7 +137,7 @@ export class InitSummaryData {
         for (const updates of sortedUpdates) {
             totalChanges += updates.changes.length;
             totalRequiredChanges += updates.changes.filter((u) => requiredChangeTypes[u.type]).length;
-            updates.changes = updates.changes.sort((a, b) => a.change.localeCompare(b.change));
+            sortChanges(updates.changes);
         }
         return {
             appPath: this._appPath,
@@ -142,4 +156,11 @@ export class InitSummaryData {
         };
     }
 }
+/**
+ * Sort generated changes in-place alphabetically by `.change` (description).
+ * Returns the array for convenience (though it's the same object).
+ */
+export function sortChanges(changes) {
+    return changes.sort((a, b) => a.change.localeCompare(b.change));
+}
 //# sourceMappingURL=InitSummaryData.js.map

package/lib/commands/init/InitSummaryData.js.map

@@ -1 +1 @@
-{"version":3,"file":"InitSummaryData.js","sourceRoot":"","sources":["../../../src/commands/init/InitSummaryData.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InitSummary } from './types/InitSummary.js';\nimport type { GeneratedPackageChanges } from './types/GeneratedPackageChanges.js';\nimport type {\n  InitPackageResult,\n  InitPackageResultErrors,\n  InitPackageResultWarnings,\n} from './types/InitPackageResult.js';\nimport type { InitOptions } from './types/InitOptions.js';\nimport type { BundleMessage } from '@ms-cloudpack/common-types';\nimport { requiredChangeTypes } from './types/GeneratedChange.js';\nimport type { EnsurePackageBundledResult } from '@ms-cloudpack/api-server';\n\n/**\n * Creates a summary tracking helper for the `init` verb to use to record statistics about results and needed\n * changes. The `record*` methods of the returned object will be used within init to add the stats, and the\n * `summarize` method will return the final tally. The resulting `InitSummary` object can be used in the\n * `formatInitSummary` helper to convert it to a string for the user.\n */\nexport class InitSummaryData {\n  /** Set this to indicate that the generated config was deleted. */\n  public deletedGeneratedConfig = false;\n\n  private _packageResults: Record<string, InitPackageResult>;\n  private _generatedUpdates: Record<string, GeneratedPackageChanges>;\n  private _startTime: number;\n  private _appPath: string;\n  private _check: boolean;\n\n  constructor(\n    params: Pick<InitOptions, 'check'> & {\n      appPath: string;\n    },\n  ) {\n    this._packageResults = {};\n    this._generatedUpdates = {};\n    this._startTime = Date.now();\n    this._appPath = params.appPath;\n    this._check = !!params.check;\n  }\n\n  /**\n   * Returns whether any generated changes have been recorded.\n   */\n  public hasChanges(): boolean {\n    return Object.values(this._generatedUpdates).length > 0;\n  }\n\n  /**\n   * Saves a package result.\n   */\n  public recordResult(\n    packagePath: string,\n    result: Pick<EnsurePackageBundledResult, 'name' | 'version' | 'info' | 'outputPath' | 'errors' | 'warnings'>,\n  ): void {\n    this._packageResults[packagePath] = {\n      path: packagePath,\n      name: result.name,\n      version: result.version,\n      info: result.info,\n      outputPath: result.outputPath,\n      errors: result.errors,\n      warnings: result.warnings,\n    };\n  }\n\n  /**\n   * Record an exception for a given package path.\n   * This creates a bundle message like \"Error thrown while (context): (error)\".\n   * (Unlike `addErrors`, this will create an overall package result if one doesn't exist yet.)\n   */\n  public recordException(params: {\n    packagePath: string;\n    error: unknown;\n    source: string;\n    /** Description of the context in which the error was thrown, e.g. \"evaluating package\" */\n    context: string;\n    /** Package name in case no result has been recorded for this package yet */\n    name?: string;\n    /** Package version in case no result has been recorded for this package yet */\n    version?: string;\n  }): void {\n    const { packagePath, error, source, context, name = '<unknown>', version = '<unknown>' } = params;\n    if (!this._packageResults[packagePath]) {\n      this.recordResult(packagePath, { name, version });\n    }\n\n    const text = `Error thrown while ${context}: ${(error as Error).stack || error}`;\n    this.addErrors(packagePath, [{ text, source }]);\n  }\n\n  /**\n   * Record more errors for a given package path.\n   */\n  public addErrors(packagePath: string, errors: BundleMessage[]): void {\n    const packageResult = this._packageResults[packagePath];\n    if (!packageResult) {\n      throw new Error(`Package result not found for path ${packagePath}`);\n    }\n\n    packageResult.errors = [...(packageResult.errors || []), ...errors];\n  }\n\n  /**\n   * Record more warnings for a given package path.\n   */\n  public addWarnings(packagePath: string, warnings: BundleMessage[]): void {\n    const packageResult = this._packageResults[packagePath];\n    if (!packageResult) {\n      throw new Error(`Package result not found for path ${packagePath}`);\n    }\n\n    packageResult.warnings = [...(packageResult.warnings || []), ...warnings];\n  }\n\n  /**\n   * Returns the package results.\n   * @returns The package results.\n   */\n  public getResults(): Record<string, InitPackageResult> {\n    return this._packageResults;\n  }\n\n  /**\n   * Saves a generated file update.\n   * @param allChanges - The generated file update to save.\n   */\n  public recordGeneratedChanges(allChanges: GeneratedPackageChanges[]): void {\n    for (const update of allChanges) {\n      const { name, version, path, changes } = update;\n      // Only record changes if there are any, so that hasChanges() is accurate.\n      if (changes.length) {\n        const updatesForPackage = (this._generatedUpdates[path] ??= { name, version, path, changes: [] });\n\n        updatesForPackage.changes.push(...changes);\n      }\n    }\n  }\n\n  /**\n   * Returns the summary of the results.\n   */\n  public summarize(): InitSummary {\n    const duration = Date.now() - this._startTime;\n    let totalSuccess = 0;\n    let totalErrors = 0;\n    let totalWarnings = 0;\n    let totalChanges = 0;\n    let totalRequiredChanges = 0;\n    const packagesWithErrors: InitPackageResultErrors[] = [];\n    const packagesWithWarnings: InitPackageResultWarnings[] = [];\n\n    for (const packageResult of Object.values(this._packageResults)) {\n      if (packageResult.errors?.length) {\n        packagesWithErrors.push(packageResult as InitPackageResultErrors);\n        totalErrors += packageResult.errors.length;\n      } else {\n        totalSuccess++;\n      }\n\n      if (packageResult.warnings?.length) {\n        packagesWithWarnings.push(packageResult as InitPackageResultWarnings);\n        totalWarnings += packageResult.warnings.length;\n      }\n    }\n\n    const sortedUpdates = Object.values(this._generatedUpdates).sort((a, b) => a.path.localeCompare(b.path));\n\n    for (const updates of sortedUpdates) {\n      totalChanges += updates.changes.length;\n      totalRequiredChanges += updates.changes.filter((u) => requiredChangeTypes[u.type]).length;\n      updates.changes = updates.changes.sort((a, b) => a.change.localeCompare(b.change));\n    }\n\n    return {\n      appPath: this._appPath,\n      duration,\n      totalPackages: Object.keys(this._packageResults).length,\n      totalSuccess,\n      totalErrors,\n      totalWarnings,\n      totalChanges,\n      totalRequiredChanges,\n      failed: totalErrors > 0 || (this._check && totalRequiredChanges > 0),\n      packagesWithErrors,\n      packagesWithWarnings,\n      generatedFileUpdates: sortedUpdates,\n      deletedGeneratedConfig: this.deletedGeneratedConfig,\n    };\n  }\n}\n"]}
+{"version":3,"file":"InitSummaryData.js","sourceRoot":"","sources":["../../../src/commands/init/InitSummaryData.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InitSummary } from './types/InitSummary.js';\nimport type { GeneratedPackageChanges } from './types/GeneratedPackageChanges.js';\nimport type {\n  InitPackageResult,\n  InitPackageResultErrors,\n  InitPackageResultWarnings,\n} from './types/InitPackageResult.js';\nimport type { InitOptions } from './types/InitOptions.js';\nimport type { BundleMessage } from '@ms-cloudpack/common-types';\nimport { requiredChangeTypes, type GeneratedChange } from './types/GeneratedChange.js';\nimport type { EnsurePackageBundledResult } from '@ms-cloudpack/api-server';\n\n/**\n * Creates a summary tracking helper for the `init` verb to use to record statistics about results and needed\n * changes. The `record*` methods of the returned object will be used within init to add the stats, and the\n * `summarize` method will return the final tally. The resulting `InitSummary` object can be used in the\n * `formatInitSummary` helper to convert it to a string for the user.\n */\nexport class InitSummaryData {\n  /** Set this to indicate that the generated config was deleted. */\n  public deletedGeneratedConfig = false;\n\n  /** Mapping from absolute package path to results */\n  private _packageResults: Record<string, InitPackageResult>;\n  /** Mapping from absolute package path to generated config updates */\n  private _generatedUpdates: Record<string, GeneratedPackageChanges>;\n  private _startTime: number;\n  private _appPath: string;\n  private _check: boolean;\n\n  constructor(\n    params: Pick<InitOptions, 'check'> & {\n      appPath: string;\n    },\n  ) {\n    this._packageResults = {};\n    this._generatedUpdates = {};\n    this._startTime = Date.now();\n    this._appPath = params.appPath;\n    this._check = !!params.check;\n  }\n\n  /**\n   * Returns whether any generated changes have been recorded.\n   */\n  public hasChanges(): boolean {\n    return Object.values(this._generatedUpdates).length > 0;\n  }\n\n  /**\n   * Saves a package bundle result. Overwrites the previous result if there was one.\n   * @param packagePath - Absolute package path\n   */\n  public recordResult(\n    packagePath: string,\n    result: Pick<EnsurePackageBundledResult, 'name' | 'version' | 'info' | 'outputPath' | 'errors' | 'warnings'>,\n  ): void {\n    this._packageResults[packagePath] = {\n      path: packagePath,\n      name: result.name,\n      version: result.version,\n      // this is mainly for easier testing: don't set properties if they'll be undefined\n      ...(result.info && { info: result.info }),\n      ...(result.outputPath && { outputPath: result.outputPath }),\n      ...(result.errors && { errors: result.errors }),\n      ...(result.warnings && { warnings: result.warnings }),\n    };\n  }\n\n  /**\n   * Record an exception for a given package path.\n   * This creates a bundle message like \"Error thrown while (context): (error)\".\n   *\n   * (Unlike `addErrors`, this will create an overall package result if one doesn't exist yet.)\n   */\n  public recordException(params: {\n    /** Absolute package path */\n    packagePath: string;\n    /** Error object or other caught item */\n    error: unknown;\n    /** Bundler or step that generated this message. */\n    source: string;\n    /** Description of the context in which the error was thrown, e.g. \"evaluating package\" */\n    context: string;\n    /** Package name in case no result has been recorded for this package yet */\n    name?: string;\n    /** Package version in case no result has been recorded for this package yet */\n    version?: string;\n  }): void {\n    const { packagePath, error, source, context, name = '<unknown>', version = '<unknown>' } = params;\n    if (!this._packageResults[packagePath]) {\n      this.recordResult(packagePath, { name, version });\n    }\n\n    const text = `Error thrown while ${context}: ${(error as Error).stack || error}`;\n    this.addErrors(packagePath, [{ text, source }]);\n  }\n\n  /**\n   * Record more errors for a given package path.\n   * @param packagePath - Absolute package path\n   */\n  public addErrors(packagePath: string, errors: BundleMessage[]): void {\n    const packageResult = this._packageResults[packagePath];\n    if (!packageResult) {\n      throw new Error(`Package result not found for path ${packagePath}`);\n    }\n\n    packageResult.errors = [...(packageResult.errors || []), ...errors];\n  }\n\n  /**\n   * Record more warnings for a given package path.\n   * @param packagePath - Absolute package path\n   */\n  public addWarnings(packagePath: string, warnings: BundleMessage[]): void {\n    const packageResult = this._packageResults[packagePath];\n    if (!packageResult) {\n      throw new Error(`Package result not found for path ${packagePath}`);\n    }\n\n    packageResult.warnings = [...(packageResult.warnings || []), ...warnings];\n  }\n\n  /**\n   * Get the recorded package results.\n   * @returns Mapping from absolute package path to results\n   */\n  public getResults(): Record<string, InitPackageResult> {\n    return this._packageResults;\n  }\n\n  /**\n   * Get the recorded generated config updates.\n   * @returns Mapping from absolute package path to generated config updates\n   */\n  public getGeneratedChanges(): Record<string, GeneratedPackageChanges> {\n    return this._generatedUpdates;\n  }\n\n  /**\n   * Save generated config updates, potentially from multiple packages.\n   * @param allChanges - The generated config update to save.\n   */\n  public recordGeneratedChanges(allChanges: GeneratedPackageChanges[]): void {\n    for (const update of allChanges) {\n      const { name, version, path, changes } = update;\n      // Only record changes if there are any, so that hasChanges() is accurate.\n      if (changes.length) {\n        const updatesForPackage = (this._generatedUpdates[path] ??= { name, version, path, changes: [] });\n\n        updatesForPackage.changes.push(...changes);\n      }\n    }\n  }\n\n  /**\n   * Returns the summary of the results.\n   */\n  public summarize(): InitSummary {\n    const duration = Date.now() - this._startTime;\n    let totalSuccess = 0;\n    let totalErrors = 0;\n    let totalWarnings = 0;\n    let totalChanges = 0;\n    let totalRequiredChanges = 0;\n    const packagesWithErrors: InitPackageResultErrors[] = [];\n    const packagesWithWarnings: InitPackageResultWarnings[] = [];\n\n    for (const packageResult of Object.values(this._packageResults)) {\n      if (packageResult.errors?.length) {\n        packagesWithErrors.push(packageResult as InitPackageResultErrors);\n        totalErrors += packageResult.errors.length;\n      } else {\n        totalSuccess++;\n      }\n\n      if (packageResult.warnings?.length) {\n        packagesWithWarnings.push(packageResult as InitPackageResultWarnings);\n        totalWarnings += packageResult.warnings.length;\n      }\n    }\n\n    const sortedUpdates = Object.values(this._generatedUpdates).sort((a, b) => a.path.localeCompare(b.path));\n\n    for (const updates of sortedUpdates) {\n      totalChanges += updates.changes.length;\n      totalRequiredChanges += updates.changes.filter((u) => requiredChangeTypes[u.type]).length;\n      sortChanges(updates.changes);\n    }\n\n    return {\n      appPath: this._appPath,\n      duration,\n      totalPackages: Object.keys(this._packageResults).length,\n      totalSuccess,\n      totalErrors,\n      totalWarnings,\n      totalChanges,\n      totalRequiredChanges,\n      failed: totalErrors > 0 || (this._check && totalRequiredChanges > 0),\n      packagesWithErrors,\n      packagesWithWarnings,\n      generatedFileUpdates: sortedUpdates,\n      deletedGeneratedConfig: this.deletedGeneratedConfig,\n    };\n  }\n}\n\n/**\n * Sort generated changes in-place alphabetically by `.change` (description).\n * Returns the array for convenience (though it's the same object).\n */\nexport function sortChanges(changes: GeneratedChange[]): GeneratedChange[] {\n  return changes.sort((a, b) => a.change.localeCompare(b.change));\n}\n"]}

package/lib/commands/init/formatInitSummary.d.ts

@@ -1,6 +1,6 @@
 import type { InitOptions } from './types/InitOptions.js';
 import type { InitSummary } from './types/InitSummary.js';
-interface FormatSummaryParams extends Pick<InitOptions, 'check'> {
+export interface FormatSummaryParams extends Pick<InitOptions, 'check'> {
     summary: InitSummary;
     isMultiApp?: boolean;
     verb: 'init' | 'bundle';
@@ -10,5 +10,4 @@ interface FormatSummaryParams extends Pick<InitOptions, 'check'> {
  * Given a summary and options, returns a formatted string message to display to the user via console.
  */
 export declare function formatInitSummary(params: FormatSummaryParams): string;
-export {};
 //# sourceMappingURL=formatInitSummary.d.ts.map

package/lib/commands/init/formatInitSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatInitSummary.d.ts","sourceRoot":"","sources":["../../../src/commands/init/formatInitSummary.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,UAAU,mBAAoB,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9D,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA0GrE"}
+{"version":3,"file":"formatInitSummary.d.ts","sourceRoot":"","sources":["../../../src/commands/init/formatInitSummary.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IACrE,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAsBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAuHrE"}

package/lib/commands/init/formatInitSummary.js

@@ -12,83 +12,103 @@ const statusByType = {
     add: '+',
     success: prefixCharacters.complete,
 };
+/** "cloudpack.generated.json" with color */
+const generatedConfigFile = cyan('cloudpack.generated.json');
+/** "cloudpack init" with color and quotes */
+const cloudpackInit = `"${yellow('cloudpack init')}"`;
 /**
  * Given a summary and options, returns a formatted string message to display to the user via console.
  */
 export function formatInitSummary(params) {
     const { summary, check, isInterrupted, isMultiApp, verb } = params;
-    const summaryString = [];
+    /** Sections of the summary that will be joined with two newlines */
+    const summarySections = [];
     const { totalPackages, totalErrors, totalWarnings, totalChanges, totalRequiredChanges, packagesWithErrors, packagesWithWarnings, generatedFileUpdates, deletedGeneratedConfig, } = summary;
+    // With --check, show required changes even if there are errors.
+    // Otherwise, skip since they'll be applied automatically once errors are fixed.
+    const showRequiredChanges = !!(totalRequiredChanges && (!totalErrors || check));
     const incompleteText = isInterrupted ? bold(` (incomplete)`) : ``;
-    // If there are required changes, updates will be "made" or "needed" with check,
-    // else if the changes are not required, only report work done when updates are "made" (check is disabled).
-    const updatesRequired = totalRequiredChanges || (totalChanges && !check);
-    // Report updates that were or should be added to the generated config.
-    if (!packagesWithErrors.length && updatesRequired) {
-        summaryString.push(formatPackageUpdates({ generatedFileUpdates, check }));
+    let warnings;
+    let generatedChanges;
+    // In single-app mode, report packages with warnings.
+    if (!isMultiApp && packagesWithWarnings.length) {
+        warnings = formatPackageResults({ results: packagesWithWarnings, issueType: 'warn' });
     }
-    if (!isMultiApp) {
-        // Report packages with warnings.
-        if (packagesWithWarnings.length) {
-            summaryString.push(formatPackageResults({ results: packagesWithWarnings, issueType: 'warn' }), '');
-        }
+    // Report required changes if appropriate (see showRequiredChanges)
+    if (showRequiredChanges) {
+        generatedChanges = formatPackageUpdates({ generatedFileUpdates, check, hasErrors: !!totalErrors });
+    }
+    if (check) {
+        // With --check, it's most helpful to show warnings then generated changes. Required changes
+        // are errors in that context, and if they're listed above warnings, it's easy to miss them,
+        // which might lead to confusion.
+        warnings && summarySections.push(warnings);
+        generatedChanges && summarySections.push(generatedChanges);
+    }
+    else {
+        // Without --check, show generated changes first, then warnings. In this case, any generated
+        // change listing is just informational (the changes were already made), but the warnings
+        // require manual intervention if the user wants to fix them.
+        generatedChanges && summarySections.push(generatedChanges);
+        warnings && summarySections.push(warnings);
     }
     // Report packages with errors.
     if (packagesWithErrors.length) {
-        summaryString.push(formatPackageResults({ results: packagesWithErrors, issueType: 'error' }), '');
+        summarySections.push(formatPackageResults({ results: packagesWithErrors, issueType: 'error' }));
     }
     if (deletedGeneratedConfig) {
-        summaryString.push(`Deleted the ${cyan('cloudpack.generated.json')} file because it is no longer needed.`, '');
+        summarySections.push(`Deleted the ${generatedConfigFile} file because it is no longer needed.`);
     }
     if (totalPackages > 1 || verb === 'init') {
+        // Report totals
         const action = verb === 'init' ? 'evaluated' : 'bundled';
-        summaryString.push(`${cyan(plural(totalPackages, 'total package'))} ${action} in ${formatTime(summary.duration)}${incompleteText}:`);
+        const totalLines = [
+            `${cyan(plural(totalPackages, 'total package'))} ${action} in ${formatTime(summary.duration)}${incompleteText}`,
+        ];
         const errorPkgCount = packagesWithErrors.length;
         const succesPkgCount = totalPackages - errorPkgCount;
         const warningPkgCount = packagesWithWarnings.length;
         const optionalChangesCount = totalChanges - totalRequiredChanges;
-        // Add totals. Without --check:
-        //   ✓ 5 packages evaluated without errors
-        //   + 2 changes made to generated config
-        //   ! 3 packages with warnings (5 total warnings)
-        //   ✗ 1 package with errors (2 total errors)
-        // With --check:
-        //   ✓ 5 packages evaluated without errors
-        //   ! 2 optional changes could be made to generated config
-        //   ! 3 packages with warnings (5 total warnings)
-        //   ✗ 1 required change missing from generated config
-        //   ✗ 1 package with errors (2 total errors)
-        // (bundle will only ever show the main warnings)
-        summaryString.push(...[
+        // See snapshots for examples of this output
+        totalLines.push(...[
             // "without errors" because they might have warnings
             formatCount('success', succesPkgCount, 'package', `${action} without errors`),
-            // For check, show optional changes as warnings. (required changes will be shown below)
-            // If updating, show the total changes made.
-            // (these messages won't show for bundle since the change counts there are 0)
-            check
-                ? formatCount('warn', optionalChangesCount, 'optional change', 'could be made to generated config')
-                : formatCount('add', totalChanges, 'change', 'made to generated config'),
+            !errorPkgCount &&
+                (check
+                    ? // For --check, only show optional changes if there are no errors, and format the
+                        // optional changes as warnings. (required changes will be shown below)
+                        formatCount('warn', optionalChangesCount, 'optional change', 'could be made to generated config')
+                    : // If updating, show the total changes made.
+                        formatCount('add', totalChanges, 'change', 'made to generated config')),
             formatCount('warn', warningPkgCount, 'package', 'with warnings', totalWarnings, 'total warning'),
+            // For --check, show required changes as errors.
             check && formatCount('error', totalRequiredChanges, 'required change', 'missing from generated config'),
             formatCount('error', errorPkgCount, 'package', 'with errors', totalErrors, 'total error'),
         ].filter(Boolean));
+        if (totalLines.length > 1) {
+            // add a colon to the first line if there are other lines
+            totalLines[0] += ':';
+        }
+        summarySections.push(totalLines.join('\n'));
     }
     if (isInterrupted) {
-        summaryString.push('', yellow(bold('Process was interrupted before all tasks could complete.')));
+        summarySections.push(yellow(bold('Process was interrupted before all tasks could complete.')));
     }
-    else if (check && totalRequiredChanges) {
-        summaryString.push(`Run "${yellow('cloudpack init')}" in your application folder to apply changes to the ${cyan('cloudpack.generated.json')} file.`);
+    else if (check && totalRequiredChanges && !totalErrors) {
+        // Skip the instruction to update the generated config if there were errors.
+        summarySections.push(`Run ${cloudpackInit} in ${summary.appPath} to apply missing changes to the ${generatedConfigFile} file.`);
     }
     // Skip the header if there was nothing to report.
-    if (summaryString.length) {
+    if (summarySections.length) {
         // For bundle, we just say "summary" since `appPath` might not actually be the path that was bundled.
-        summaryString.unshift(bold(`==== ${verb === 'bundle' ? 'Summary' : `Summary for ${summary.appPath}`} ====`));
-        summaryString.push('\n');
+        summarySections.unshift(bold(`==== ${verb === 'bundle' ? 'Summary' : `Summary for ${summary.appPath}`} ====`));
     }
-    return (summaryString
-        .join('\n')
+    const summaryString = summarySections
+        .join('\n\n')
         // replace >= 3 newlines with 2 newlines
-        .replace(/\n{3,}/g, '\n\n'));
+        .replace(/\n{3,}/g, '\n\n');
+    // Ensure a final newline for readability, unless it's empty.
+    return !summaryString || summaryString.endsWith('\n') ? summaryString : summaryString + '\n';
 }
 /**
  * If `count > 0`, return a pluralized formatted string like "+ 5 items description"
@@ -109,27 +129,44 @@ function formatCount(type, count, item, description, extraCount, extraItem) {
     return undefined;
 }
 function formatPackageUpdates(params) {
-    const { generatedFileUpdates, check, isInterrupted } = params;
+    const { generatedFileUpdates, check, isInterrupted, hasErrors } = params;
+    // mapping from change type to [description, optional plural description]
     const descriptions = {
-        'added-export': `path$s ${check ? 'missing from' : 'added to'} exports map`,
-        'included-dependency-required': 'dependency$s required to be included',
-        'changed-export': 'previously unused export path(s) are now used',
-        'added-dynamic-import': 'dynamic import$s added',
+        'added-export': [`path$s ${check ? 'missing from' : 'added to'} exports map`],
+        'included-dependency-required': ['dependency required to be included', 'dependencies required to be included'],
+        'changed-export': ['previously unused export path$s now used'],
+        'added-dynamic-import': ['dynamic import$s added'],
     };
     const summaryString = [];
     for (const packageUpdates of generatedFileUpdates) {
+        // list of update type descriptions and updates of that type
+        const updates = [];
         for (const type of Object.keys(descriptions)) {
             const typeUpdates = packageUpdates.changes.filter((u) => u.type === type);
             if (typeUpdates.length) {
-                const description = plural(typeUpdates.length, descriptions[type]);
-                // If we already made the updates, don't make them look like warnings.
-                const issueType = check ? 'warn' : 'add';
-                summaryString.push(formatPackageHeader({ ...packageUpdates, issueType, description }), bulletedList(typeUpdates.map((u) => `${cyan(u.change)}${u.reason ? ` - ${u.reason}` : ''}`)), '');
+                const description = plural(typeUpdates.length, ...descriptions[type]);
+                updates.push([description, typeUpdates]);
             }
         }
+        if (updates.length) {
+            summaryString.push(formatPackageHeader(packageUpdates));
+            for (const [description, typeUpdates] of updates) {
+                summaryString.push(
+                // If updates are required, format them as errors.
+                formatPackageSubhead({ issueType: check ? 'error' : 'add', description }), bulletedList(typeUpdates.map((u) => `${cyan(u.change)}${u.reason ? ` - ${u.reason}` : ''}`)));
+            }
+            summaryString.push('');
+        }
     }
     if (summaryString.length) {
-        summaryString.unshift(bold(`Updates ${check || isInterrupted ? 'needed for' : 'made to'} ${cyan(`cloudpack.generated.json`)}:\n`));
+        const needsUpdates = check || isInterrupted;
+        const extraInstructions = needsUpdates
+            ? hasErrors
+                ? `fix errors first, then run ${cloudpackInit}`
+                : `run ${cloudpackInit} to fix`
+            : '';
+        summaryString.unshift(bold(`Updates ${needsUpdates ? 'needed for' : 'made to'} ${generatedConfigFile}`) +
+            `${extraInstructions ? ` (${extraInstructions})` : ''}:\n`);
     }
     return summaryString.join('\n');
 }
@@ -149,7 +186,7 @@ function formatPackageResults(params) {
             continue;
         }
         const description = plural(unformattedMessages.length, messageType.slice(0, -1) + '$s');
-        summaryString.push(formatPackageHeader({ ...result, issueType, description }));
+        summaryString.push(formatPackageHeader(result), formatPackageSubhead({ issueType, description }));
         const messages = unformattedMessages.map(({ location, text, source }) => {
             // Show the whole path so it can be easily opened with ctrl+click.
             // NOTE: location.file should be relative to the package path, not the app path.
@@ -162,16 +199,20 @@ function formatPackageResults(params) {
     return summaryString.join('\n');
 }
 /**
- * Helper to format the header for a list of issues in a package:
- * status character, `name@version`, issue description, package path.
+ * Helper to format the package `name@version` and output path.
  */
 function formatPackageHeader(params) {
-    const { name, version, path: packagePath, outputPath, description, issueType } = params;
+    const { name, version, path: packagePath, outputPath } = params;
+    const packageName = bold(lightCyan(`${name}@${version}`));
+    return `${packageName} - ${packagePath}${outputPath ? '\n' + darkGrey(`(output: ${outputPath})`) : ''}`;
+}
+/**
+ * Add a status character and formatting to the subhead description.
+ */
+function formatPackageSubhead(params) {
+    const { description, issueType } = params;
     const color = colorsByType[issueType];
     const statusChar = bold(color(statusByType[issueType]));
-    const packageName = bold(lightCyan(`${name}@${version || `<unknown>`}`));
-    return (`${packageName} - ${packagePath}\n` +
-        (outputPath ? darkGrey(`(output: ${outputPath})\n`) : '') +
-        `${statusChar} ${bold(color(description))}`);
+    return `${statusChar} ${bold(color(description))}`;
 }
 //# sourceMappingURL=formatInitSummary.js.map

package/lib/commands/init/formatInitSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatInitSummary.js","sourceRoot":"","sources":["../../../src/commands/init/formatInitSummary.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  bold,\n  bulletedList,\n  cyan,\n  formatTime,\n  green,\n  darkGrey,\n  indent,\n  lightCyan,\n  plural,\n  red,\n  prefixCharacters,\n  yellow,\n} from '@ms-cloudpack/task-reporter';\nimport type { InitOptions } from './types/InitOptions.js';\nimport type { InitPackageResult } from './types/InitPackageResult.js';\nimport type { InitSummary } from './types/InitSummary.js';\nimport { formatLocation } from '@ms-cloudpack/path-utilities';\nimport type { RequiredGeneratedChangeType } from './types/GeneratedChange.js';\n\ninterface FormatSummaryParams extends Pick<InitOptions, 'check'> {\n  summary: InitSummary;\n  isMultiApp?: boolean;\n  verb: 'init' | 'bundle';\n  isInterrupted?: boolean;\n}\n\n/** Result types with different colors and symbols for logging purposes */\ntype ResultType = 'error' | 'warn' | 'add' | 'success';\nconst colorsByType: Record<ResultType, (str: string) => string> = {\n  error: red,\n  warn: yellow,\n  add: (str) => str, // no color\n  success: green,\n};\nconst statusByType: Record<ResultType, string> = {\n  error: prefixCharacters.error,\n  warn: prefixCharacters.warn,\n  add: '+',\n  success: prefixCharacters.complete,\n};\n\n/**\n * Given a summary and options, returns a formatted string message to display to the user via console.\n */\nexport function formatInitSummary(params: FormatSummaryParams): string {\n  const { summary, check, isInterrupted, isMultiApp, verb } = params;\n  const summaryString: string[] = [];\n\n  const {\n    totalPackages,\n    totalErrors,\n    totalWarnings,\n    totalChanges,\n    totalRequiredChanges,\n    packagesWithErrors,\n    packagesWithWarnings,\n    generatedFileUpdates,\n    deletedGeneratedConfig,\n  } = summary;\n\n  const incompleteText = isInterrupted ? bold(` (incomplete)`) : ``;\n\n  // If there are required changes, updates will be \"made\" or \"needed\" with check,\n  // else if the changes are not required, only report work done when updates are \"made\" (check is disabled).\n  const updatesRequired = totalRequiredChanges || (totalChanges && !check);\n\n  // Report updates that were or should be added to the generated config.\n  if (!packagesWithErrors.length && updatesRequired) {\n    summaryString.push(formatPackageUpdates({ generatedFileUpdates, check }));\n  }\n\n  if (!isMultiApp) {\n    // Report packages with warnings.\n    if (packagesWithWarnings.length) {\n      summaryString.push(formatPackageResults({ results: packagesWithWarnings, issueType: 'warn' }), '');\n    }\n  }\n\n  // Report packages with errors.\n  if (packagesWithErrors.length) {\n    summaryString.push(formatPackageResults({ results: packagesWithErrors, issueType: 'error' }), '');\n  }\n\n  if (deletedGeneratedConfig) {\n    summaryString.push(`Deleted the ${cyan('cloudpack.generated.json')} file because it is no longer needed.`, '');\n  }\n\n  if (totalPackages > 1 || verb === 'init') {\n    const action = verb === 'init' ? 'evaluated' : 'bundled';\n    summaryString.push(\n      `${cyan(plural(totalPackages, 'total package'))} ${action} in ${formatTime(summary.duration)}${incompleteText}:`,\n    );\n\n    const errorPkgCount = packagesWithErrors.length;\n    const succesPkgCount = totalPackages - errorPkgCount;\n    const warningPkgCount = packagesWithWarnings.length;\n    const optionalChangesCount = totalChanges - totalRequiredChanges;\n\n    // Add totals. Without --check:\n    //   ✓ 5 packages evaluated without errors\n    //   + 2 changes made to generated config\n    //   ! 3 packages with warnings (5 total warnings)\n    //   ✗ 1 package with errors (2 total errors)\n    // With --check:\n    //   ✓ 5 packages evaluated without errors\n    //   ! 2 optional changes could be made to generated config\n    //   ! 3 packages with warnings (5 total warnings)\n    //   ✗ 1 required change missing from generated config\n    //   ✗ 1 package with errors (2 total errors)\n    // (bundle will only ever show the main warnings)\n    summaryString.push(\n      ...([\n        // \"without errors\" because they might have warnings\n        formatCount('success', succesPkgCount, 'package', `${action} without errors`),\n        // For check, show optional changes as warnings. (required changes will be shown below)\n        // If updating, show the total changes made.\n        // (these messages won't show for bundle since the change counts there are 0)\n        check\n          ? formatCount('warn', optionalChangesCount, 'optional change', 'could be made to generated config')\n          : formatCount('add', totalChanges, 'change', 'made to generated config'),\n        formatCount('warn', warningPkgCount, 'package', 'with warnings', totalWarnings, 'total warning'),\n        check && formatCount('error', totalRequiredChanges, 'required change', 'missing from generated config'),\n        formatCount('error', errorPkgCount, 'package', 'with errors', totalErrors, 'total error'),\n      ].filter(Boolean) as string[]),\n    );\n  }\n\n  if (isInterrupted) {\n    summaryString.push('', yellow(bold('Process was interrupted before all tasks could complete.')));\n  } else if (check && totalRequiredChanges) {\n    summaryString.push(\n      `Run \"${yellow('cloudpack init')}\" in your application folder to apply changes to the ${cyan(\n        'cloudpack.generated.json',\n      )} file.`,\n    );\n  }\n\n  // Skip the header if there was nothing to report.\n  if (summaryString.length) {\n    // For bundle, we just say \"summary\" since `appPath` might not actually be the path that was bundled.\n    summaryString.unshift(bold(`==== ${verb === 'bundle' ? 'Summary' : `Summary for ${summary.appPath}`} ====`));\n    summaryString.push('\\n');\n  }\n\n  return (\n    summaryString\n      .join('\\n')\n      // replace >= 3 newlines with 2 newlines\n      .replace(/\\n{3,}/g, '\\n\\n')\n  );\n}\n\n/**\n * If `count > 0`, return a pluralized formatted string like \"+ 5 items description\"\n * (otherwise ignore). `type` determines the status character used, and the color for the\n * status character and item count.\n *\n * `extraCount` and `extraItem` are optional and will be added to the end in parentheses\n * if both are provided.\n */\nfunction formatCount(\n  type: ResultType,\n  count: number,\n  item: string,\n  description: string,\n  extraCount?: number,\n  extraItem?: string,\n): string | undefined {\n  if (count > 0) {\n    const color = colorsByType[type];\n    const statusChar = bold(color(statusByType[type]));\n    const itemCount = color(plural(count, item));\n    const extra = extraCount && extraItem ? ` (${plural(extraCount, extraItem)})` : '';\n    return `  ${statusChar} ${itemCount} ${description}${extra}`;\n  }\n  return undefined;\n}\n\nfunction formatPackageUpdates(\n  params: Pick<InitSummary, 'generatedFileUpdates'> & Pick<FormatSummaryParams, 'isInterrupted' | 'check'>,\n): string {\n  const { generatedFileUpdates, check, isInterrupted } = params;\n\n  const descriptions: Record<RequiredGeneratedChangeType, string> = {\n    'added-export': `path$s ${check ? 'missing from' : 'added to'} exports map`,\n    'included-dependency-required': 'dependency$s required to be included',\n    'changed-export': 'previously unused export path(s) are now used',\n    'added-dynamic-import': 'dynamic import$s added',\n  };\n\n  const summaryString: string[] = [];\n\n  for (const packageUpdates of generatedFileUpdates) {\n    for (const type of Object.keys(descriptions) as RequiredGeneratedChangeType[]) {\n      const typeUpdates = packageUpdates.changes.filter((u) => u.type === type);\n\n      if (typeUpdates.length) {\n        const description = plural(typeUpdates.length, descriptions[type]);\n        // If we already made the updates, don't make them look like warnings.\n        const issueType = check ? 'warn' : 'add';\n        summaryString.push(\n          formatPackageHeader({ ...packageUpdates, issueType, description }),\n          bulletedList(typeUpdates.map((u) => `${cyan(u.change)}${u.reason ? ` - ${u.reason}` : ''}`)),\n          '',\n        );\n      }\n    }\n  }\n\n  if (summaryString.length) {\n    summaryString.unshift(\n      bold(`Updates ${check || isInterrupted ? 'needed for' : 'made to'} ${cyan(`cloudpack.generated.json`)}:\\n`),\n    );\n  }\n  return summaryString.join('\\n');\n}\n\n/** Helper to format `packagesWithWarnings` or `packagesWithErrors`. */\nfunction formatPackageResults(params: { results: InitPackageResult[]; issueType: 'error' | 'warn' }): string {\n  const { results, issueType } = params;\n  if (!results.length) {\n    return '';\n  }\n\n  const color = colorsByType[issueType];\n  const messageType = issueType === 'error' ? 'errors' : 'warnings';\n  const statusChar = bold(color(prefixCharacters[issueType]));\n\n  const summaryString = [bold(color(`${plural(results.length, 'package')} with ${messageType}:`)), ''];\n\n  for (const result of results) {\n    const unformattedMessages = result[messageType];\n    if (!unformattedMessages?.length) {\n      continue;\n    }\n\n    const description = plural(unformattedMessages.length, messageType.slice(0, -1) + '$s');\n    summaryString.push(formatPackageHeader({ ...result, issueType, description }));\n\n    const messages = unformattedMessages.map(({ location, text, source }) => {\n      // Show the whole path so it can be easily opened with ctrl+click.\n      // NOTE: location.file should be relative to the package path, not the app path.\n      const filePath = location ? ` ${formatLocation({ ...location, fromPath: result.path })}` : '';\n      // Indent the message for readability.\n      return `[${source}]${filePath}\\n${color(indent(text, 1))}`;\n    });\n\n    summaryString.push(bulletedList(messages, undefined, statusChar), '');\n  }\n\n  return summaryString.join('\\n');\n}\n\n/**\n * Helper to format the header for a list of issues in a package:\n * status character, `name@version`, issue description, package path.\n */\nfunction formatPackageHeader(\n  params: InitPackageResult & {\n    description: string;\n    issueType: 'error' | 'warn' | 'add';\n  },\n): string {\n  const { name, version, path: packagePath, outputPath, description, issueType } = params;\n  const color = colorsByType[issueType];\n  const statusChar = bold(color(statusByType[issueType]));\n  const packageName = bold(lightCyan(`${name}@${version || `<unknown>`}`));\n\n  return (\n    `${packageName} - ${packagePath}\\n` +\n    (outputPath ? darkGrey(`(output: ${outputPath})\\n`) : '') +\n    `${statusChar} ${bold(color(description))}`\n  );\n}\n"]}
+{"version":3,"file":"formatInitSummary.js","sourceRoot":"","sources":["../../../src/commands/init/formatInitSummary.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  bold,\n  bulletedList,\n  cyan,\n  formatTime,\n  green,\n  darkGrey,\n  indent,\n  lightCyan,\n  plural,\n  red,\n  prefixCharacters,\n  yellow,\n} from '@ms-cloudpack/task-reporter';\nimport type { InitOptions } from './types/InitOptions.js';\nimport type { InitPackageResult } from './types/InitPackageResult.js';\nimport type { InitSummary } from './types/InitSummary.js';\nimport { formatLocation } from '@ms-cloudpack/path-utilities';\nimport type { GeneratedChange, RequiredGeneratedChangeType } from './types/GeneratedChange.js';\n\nexport interface FormatSummaryParams extends Pick<InitOptions, 'check'> {\n  summary: InitSummary;\n  isMultiApp?: boolean;\n  verb: 'init' | 'bundle';\n  isInterrupted?: boolean;\n}\n\n/** Result types with different colors and symbols for logging purposes */\ntype ResultType = 'error' | 'warn' | 'add' | 'success';\nconst colorsByType: Record<ResultType, (str: string) => string> = {\n  error: red,\n  warn: yellow,\n  add: (str) => str, // no color\n  success: green,\n};\nconst statusByType: Record<ResultType, string> = {\n  error: prefixCharacters.error,\n  warn: prefixCharacters.warn,\n  add: '+',\n  success: prefixCharacters.complete,\n};\n\n/** \"cloudpack.generated.json\" with color */\nconst generatedConfigFile = cyan('cloudpack.generated.json');\n/** \"cloudpack init\" with color and quotes */\nconst cloudpackInit = `\"${yellow('cloudpack init')}\"`;\n\n/**\n * Given a summary and options, returns a formatted string message to display to the user via console.\n */\nexport function formatInitSummary(params: FormatSummaryParams): string {\n  const { summary, check, isInterrupted, isMultiApp, verb } = params;\n  /** Sections of the summary that will be joined with two newlines */\n  const summarySections: string[] = [];\n\n  const {\n    totalPackages,\n    totalErrors,\n    totalWarnings,\n    totalChanges,\n    totalRequiredChanges,\n    packagesWithErrors,\n    packagesWithWarnings,\n    generatedFileUpdates,\n    deletedGeneratedConfig,\n  } = summary;\n\n  // With --check, show required changes even if there are errors.\n  // Otherwise, skip since they'll be applied automatically once errors are fixed.\n  const showRequiredChanges = !!(totalRequiredChanges && (!totalErrors || check));\n\n  const incompleteText = isInterrupted ? bold(` (incomplete)`) : ``;\n\n  let warnings: string | undefined;\n  let generatedChanges: string | undefined;\n\n  // In single-app mode, report packages with warnings.\n  if (!isMultiApp && packagesWithWarnings.length) {\n    warnings = formatPackageResults({ results: packagesWithWarnings, issueType: 'warn' });\n  }\n\n  // Report required changes if appropriate (see showRequiredChanges)\n  if (showRequiredChanges) {\n    generatedChanges = formatPackageUpdates({ generatedFileUpdates, check, hasErrors: !!totalErrors });\n  }\n\n  if (check) {\n    // With --check, it's most helpful to show warnings then generated changes. Required changes\n    // are errors in that context, and if they're listed above warnings, it's easy to miss them,\n    // which might lead to confusion.\n    warnings && summarySections.push(warnings);\n    generatedChanges && summarySections.push(generatedChanges);\n  } else {\n    // Without --check, show generated changes first, then warnings. In this case, any generated\n    // change listing is just informational (the changes were already made), but the warnings\n    // require manual intervention if the user wants to fix them.\n    generatedChanges && summarySections.push(generatedChanges);\n    warnings && summarySections.push(warnings);\n  }\n\n  // Report packages with errors.\n  if (packagesWithErrors.length) {\n    summarySections.push(formatPackageResults({ results: packagesWithErrors, issueType: 'error' }));\n  }\n\n  if (deletedGeneratedConfig) {\n    summarySections.push(`Deleted the ${generatedConfigFile} file because it is no longer needed.`);\n  }\n\n  if (totalPackages > 1 || verb === 'init') {\n    // Report totals\n    const action = verb === 'init' ? 'evaluated' : 'bundled';\n    const totalLines = [\n      `${cyan(plural(totalPackages, 'total package'))} ${action} in ${formatTime(summary.duration)}${incompleteText}`,\n    ];\n\n    const errorPkgCount = packagesWithErrors.length;\n    const succesPkgCount = totalPackages - errorPkgCount;\n    const warningPkgCount = packagesWithWarnings.length;\n    const optionalChangesCount = totalChanges - totalRequiredChanges;\n\n    // See snapshots for examples of this output\n    totalLines.push(\n      ...([\n        // \"without errors\" because they might have warnings\n        formatCount('success', succesPkgCount, 'package', `${action} without errors`),\n        !errorPkgCount &&\n          (check\n            ? // For --check, only show optional changes if there are no errors, and format the\n              // optional changes as warnings. (required changes will be shown below)\n              formatCount('warn', optionalChangesCount, 'optional change', 'could be made to generated config')\n            : // If updating, show the total changes made.\n              formatCount('add', totalChanges, 'change', 'made to generated config')),\n        formatCount('warn', warningPkgCount, 'package', 'with warnings', totalWarnings, 'total warning'),\n        // For --check, show required changes as errors.\n        check && formatCount('error', totalRequiredChanges, 'required change', 'missing from generated config'),\n        formatCount('error', errorPkgCount, 'package', 'with errors', totalErrors, 'total error'),\n      ].filter(Boolean) as string[]),\n    );\n\n    if (totalLines.length > 1) {\n      // add a colon to the first line if there are other lines\n      totalLines[0] += ':';\n    }\n\n    summarySections.push(totalLines.join('\\n'));\n  }\n\n  if (isInterrupted) {\n    summarySections.push(yellow(bold('Process was interrupted before all tasks could complete.')));\n  } else if (check && totalRequiredChanges && !totalErrors) {\n    // Skip the instruction to update the generated config if there were errors.\n    summarySections.push(\n      `Run ${cloudpackInit} in ${summary.appPath} to apply missing changes to the ${generatedConfigFile} file.`,\n    );\n  }\n\n  // Skip the header if there was nothing to report.\n  if (summarySections.length) {\n    // For bundle, we just say \"summary\" since `appPath` might not actually be the path that was bundled.\n    summarySections.unshift(bold(`==== ${verb === 'bundle' ? 'Summary' : `Summary for ${summary.appPath}`} ====`));\n  }\n\n  const summaryString = summarySections\n    .join('\\n\\n')\n    // replace >= 3 newlines with 2 newlines\n    .replace(/\\n{3,}/g, '\\n\\n');\n  // Ensure a final newline for readability, unless it's empty.\n  return !summaryString || summaryString.endsWith('\\n') ? summaryString : summaryString + '\\n';\n}\n\n/**\n * If `count > 0`, return a pluralized formatted string like \"+ 5 items description\"\n * (otherwise ignore). `type` determines the status character used, and the color for the\n * status character and item count.\n *\n * `extraCount` and `extraItem` are optional and will be added to the end in parentheses\n * if both are provided.\n */\nfunction formatCount(\n  type: ResultType,\n  count: number,\n  item: string,\n  description: string,\n  extraCount?: number,\n  extraItem?: string,\n): string | undefined {\n  if (count > 0) {\n    const color = colorsByType[type];\n    const statusChar = bold(color(statusByType[type]));\n    const itemCount = color(plural(count, item));\n    const extra = extraCount && extraItem ? ` (${plural(extraCount, extraItem)})` : '';\n    return `  ${statusChar} ${itemCount} ${description}${extra}`;\n  }\n  return undefined;\n}\n\nfunction formatPackageUpdates(\n  params: Pick<InitSummary, 'generatedFileUpdates'> &\n    Pick<FormatSummaryParams, 'isInterrupted' | 'check'> & {\n      hasErrors: boolean;\n    },\n): string {\n  const { generatedFileUpdates, check, isInterrupted, hasErrors } = params;\n\n  // mapping from change type to [description, optional plural description]\n  const descriptions: Record<RequiredGeneratedChangeType, [string, string?]> = {\n    'added-export': [`path$s ${check ? 'missing from' : 'added to'} exports map`],\n    'included-dependency-required': ['dependency required to be included', 'dependencies required to be included'],\n    'changed-export': ['previously unused export path$s now used'],\n    'added-dynamic-import': ['dynamic import$s added'],\n  };\n\n  const summaryString: string[] = [];\n\n  for (const packageUpdates of generatedFileUpdates) {\n    // list of update type descriptions and updates of that type\n    const updates: [string, GeneratedChange[]][] = [];\n    for (const type of Object.keys(descriptions) as RequiredGeneratedChangeType[]) {\n      const typeUpdates = packageUpdates.changes.filter((u) => u.type === type);\n\n      if (typeUpdates.length) {\n        const description = plural(typeUpdates.length, ...descriptions[type]);\n        updates.push([description, typeUpdates]);\n      }\n    }\n\n    if (updates.length) {\n      summaryString.push(formatPackageHeader(packageUpdates));\n      for (const [description, typeUpdates] of updates) {\n        summaryString.push(\n          // If updates are required, format them as errors.\n          formatPackageSubhead({ issueType: check ? 'error' : 'add', description }),\n          bulletedList(typeUpdates.map((u) => `${cyan(u.change)}${u.reason ? ` - ${u.reason}` : ''}`)),\n        );\n      }\n      summaryString.push('');\n    }\n  }\n\n  if (summaryString.length) {\n    const needsUpdates = check || isInterrupted;\n    const extraInstructions = needsUpdates\n      ? hasErrors\n        ? `fix errors first, then run ${cloudpackInit}`\n        : `run ${cloudpackInit} to fix`\n      : '';\n    summaryString.unshift(\n      bold(`Updates ${needsUpdates ? 'needed for' : 'made to'} ${generatedConfigFile}`) +\n        `${extraInstructions ? ` (${extraInstructions})` : ''}:\\n`,\n    );\n  }\n  return summaryString.join('\\n');\n}\n\n/** Helper to format `packagesWithWarnings` or `packagesWithErrors`. */\nfunction formatPackageResults(params: { results: InitPackageResult[]; issueType: 'error' | 'warn' }): string {\n  const { results, issueType } = params;\n  if (!results.length) {\n    return '';\n  }\n\n  const color = colorsByType[issueType];\n  const messageType = issueType === 'error' ? 'errors' : 'warnings';\n  const statusChar = bold(color(prefixCharacters[issueType]));\n\n  const summaryString = [bold(color(`${plural(results.length, 'package')} with ${messageType}:`)), ''];\n\n  for (const result of results) {\n    const unformattedMessages = result[messageType];\n    if (!unformattedMessages?.length) {\n      continue;\n    }\n\n    const description = plural(unformattedMessages.length, messageType.slice(0, -1) + '$s');\n    summaryString.push(formatPackageHeader(result), formatPackageSubhead({ issueType, description }));\n\n    const messages = unformattedMessages.map(({ location, text, source }) => {\n      // Show the whole path so it can be easily opened with ctrl+click.\n      // NOTE: location.file should be relative to the package path, not the app path.\n      const filePath = location ? ` ${formatLocation({ ...location, fromPath: result.path })}` : '';\n      // Indent the message for readability.\n      return `[${source}]${filePath}\\n${color(indent(text, 1))}`;\n    });\n\n    summaryString.push(bulletedList(messages, undefined, statusChar), '');\n  }\n\n  return summaryString.join('\\n');\n}\n\n/**\n * Helper to format the package `name@version` and output path.\n */\nfunction formatPackageHeader(params: InitPackageResult): string {\n  const { name, version, path: packagePath, outputPath } = params;\n  const packageName = bold(lightCyan(`${name}@${version}`));\n\n  return `${packageName} - ${packagePath}${outputPath ? '\\n' + darkGrey(`(output: ${outputPath})`) : ''}`;\n}\n\n/**\n * Add a status character and formatting to the subhead description.\n */\nfunction formatPackageSubhead(params: { description: string; issueType: ResultType }): string {\n  const { description, issueType } = params;\n  const color = colorsByType[issueType];\n  const statusChar = bold(color(statusByType[issueType]));\n  return `${statusChar} ${bold(color(description))}`;\n}\n"]}

package/lib/commands/init/types/GeneratedChange.d.ts

@@ -12,4 +12,9 @@ export interface GeneratedChange {
  * (Keys for non-required change types will be undefined.)
  */
 export declare const requiredChangeTypes: Partial<Record<GeneratedChangeType, true>>;
+/**
+ * Mapping of optional change types to true.
+ * (Keys for required change types will be undefined.)
+ */
+export declare const optionalChangeTypes: Partial<Record<GeneratedChangeType, true>>;
 //# sourceMappingURL=GeneratedChange.d.ts.map

package/lib/commands/init/types/GeneratedChange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratedChange.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/types/GeneratedChange.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GACnC,gBAAgB,GAChB,cAAc,GACd,sBAAsB,GACtB,8BAA8B,CAAC;AAEnC,MAAM,MAAM,mBAAmB,GAC3B,2BAA2B,GAC3B,8BAA8B,GAC9B,qBAAqB,GACrB,6BAA6B,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AAGH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAKtB,CAAC"}
+{"version":3,"file":"GeneratedChange.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/types/GeneratedChange.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GACnC,gBAAgB,GAChB,cAAc,GACd,sBAAsB,GACtB,8BAA8B,CAAC;AAEnC,MAAM,MAAM,mBAAmB,GAC3B,2BAA2B,GAC3B,8BAA8B,GAC9B,qBAAqB,GACrB,6BAA6B,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AAGH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAKtB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAIQ,CAAC"}

package/lib/commands/init/types/GeneratedChange.js

@@ -10,4 +10,13 @@ export const requiredChangeTypes = {
     'added-dynamic-import': true,
     'included-dependency-required': true,
 };
+/**
+ * Mapping of optional change types to true.
+ * (Keys for required change types will be undefined.)
+ */
+export const optionalChangeTypes = {
+    'included-dependency-optional': true,
+    'excluded-dependency': true,
+    'removed-excluded-dependency': true,
+};
 //# sourceMappingURL=GeneratedChange.js.map

package/lib/commands/init/types/GeneratedChange.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratedChange.js","sourceRoot":"","sources":["../../../../src/commands/init/types/GeneratedChange.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,uFAAuF;AACvF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAA+C;IAC7E,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,sBAAsB,EAAE,IAAI;IAC5B,8BAA8B,EAAE,IAAI;CACe,CAAC","sourcesContent":["export type RequiredGeneratedChangeType =\n  | 'changed-export'\n  | 'added-export'\n  | 'added-dynamic-import'\n  | 'included-dependency-required';\n\nexport type GeneratedChangeType =\n  | RequiredGeneratedChangeType\n  | 'included-dependency-optional'\n  | 'excluded-dependency'\n  | 'removed-excluded-dependency';\n\nexport interface GeneratedChange {\n  type: GeneratedChangeType;\n  /** Item that changed, such as the dependency name, export path, or bundler type */\n  change: string;\n  /** Additional explanation */\n  reason?: string;\n}\n\n/**\n * Mapping of required change types to true.\n * (Keys for non-required change types will be undefined.)\n */\n// It's easier to ensure this stays up to date by using an object rather than an array.\n// Any GeneratedChangeType is allowed as a lookup key to make usage easier.\nexport const requiredChangeTypes: Partial<Record<GeneratedChangeType, true>> = {\n  'changed-export': true,\n  'added-export': true,\n  'added-dynamic-import': true,\n  'included-dependency-required': true,\n} satisfies Record<RequiredGeneratedChangeType, true>;\n"]}
+{"version":3,"file":"GeneratedChange.js","sourceRoot":"","sources":["../../../../src/commands/init/types/GeneratedChange.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,uFAAuF;AACvF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAA+C;IAC7E,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,sBAAsB,EAAE,IAAI;IAC5B,8BAA8B,EAAE,IAAI;CACe,CAAC;AAEtD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA+C;IAC7E,8BAA8B,EAAE,IAAI;IACpC,qBAAqB,EAAE,IAAI;IAC3B,6BAA6B,EAAE,IAAI;CAC8C,CAAC","sourcesContent":["export type RequiredGeneratedChangeType =\n  | 'changed-export'\n  | 'added-export'\n  | 'added-dynamic-import'\n  | 'included-dependency-required';\n\nexport type GeneratedChangeType =\n  | RequiredGeneratedChangeType\n  | 'included-dependency-optional'\n  | 'excluded-dependency'\n  | 'removed-excluded-dependency';\n\nexport interface GeneratedChange {\n  type: GeneratedChangeType;\n  /** Item that changed, such as the dependency name, export path, or bundler type */\n  change: string;\n  /** Additional explanation */\n  reason?: string;\n}\n\n/**\n * Mapping of required change types to true.\n * (Keys for non-required change types will be undefined.)\n */\n// It's easier to ensure this stays up to date by using an object rather than an array.\n// Any GeneratedChangeType is allowed as a lookup key to make usage easier.\nexport const requiredChangeTypes: Partial<Record<GeneratedChangeType, true>> = {\n  'changed-export': true,\n  'added-export': true,\n  'added-dynamic-import': true,\n  'included-dependency-required': true,\n} satisfies Record<RequiredGeneratedChangeType, true>;\n\n/**\n * Mapping of optional change types to true.\n * (Keys for required change types will be undefined.)\n */\nexport const optionalChangeTypes: Partial<Record<GeneratedChangeType, true>> = {\n  'included-dependency-optional': true,\n  'excluded-dependency': true,\n  'removed-excluded-dependency': true,\n} satisfies Record<Exclude<GeneratedChangeType, RequiredGeneratedChangeType>, true>;\n"]}

package/lib/commands/init/types/InitSummary.d.ts

@@ -3,9 +3,15 @@ import type { InitPackageResultErrors, InitPackageResultWarnings } from './InitP
 export interface InitSummary {
     appPath: string;
     duration: number;
+    /** True if there were errors, or if `check` was set and there were required changes. */
+    failed: boolean;
+    /** Total number of packages */
     totalPackages: number;
+    /** Total packages without errors (doesn't consider required config changes) */
     totalSuccess: number;
+    /** Total number of errors (doesn't include required config changes) */
     totalErrors: number;
+    /** Total number of warnings (doesn't include config changes) */
     totalWarnings: number;
     /** Total number of changes made to the generated config */
     totalChanges: number;
@@ -14,11 +20,13 @@ export interface InitSummary {
      * This will cause `init --check` to fail if it's not 0.
      */
     totalRequiredChanges: number;
-    failed: boolean;
     /** If true, the generated config previously existed but is now not needed and was deleted */
     deletedGeneratedConfig?: boolean;
+    /** Updates made to the generated config */
     generatedFileUpdates: GeneratedPackageChanges[];
+    /** Results for each package with errors (doesn't include required config changes) */
     packagesWithErrors: InitPackageResultErrors[];
+    /** Results for each package with warnings (doesn't include config changes) */
     packagesWithWarnings: InitPackageResultWarnings[];
 }
 //# sourceMappingURL=InitSummary.d.ts.map

package/lib/commands/init/types/InitSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InitSummary.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/types/InitSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEjG,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,6FAA6F;IAC7F,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,oBAAoB,EAAE,uBAAuB,EAAE,CAAC;IAChD,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,oBAAoB,EAAE,yBAAyB,EAAE,CAAC;CACnD"}
+{"version":3,"file":"InitSummary.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/types/InitSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEjG,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,MAAM,EAAE,OAAO,CAAC;IAChB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B,6FAA6F;IAC7F,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,2CAA2C;IAC3C,oBAAoB,EAAE,uBAAuB,EAAE,CAAC;IAChD,qFAAqF;IACrF,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,8EAA8E;IAC9E,oBAAoB,EAAE,yBAAyB,EAAE,CAAC;CACnD"}

package/lib/commands/init/types/InitSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"InitSummary.js","sourceRoot":"","sources":["../../../../src/commands/init/types/InitSummary.ts"],"names":[],"mappings":"","sourcesContent":["import type { GeneratedPackageChanges } from './GeneratedPackageChanges.js';\nimport type { InitPackageResultErrors, InitPackageResultWarnings } from './InitPackageResult.js';\n\nexport interface InitSummary {\n  appPath: string;\n  duration: number;\n  totalPackages: number;\n  totalSuccess: number;\n  totalErrors: number;\n  totalWarnings: number;\n  /** Total number of changes made to the generated config */\n  totalChanges: number;\n  /**\n   * Total number of required changes made to the generated config.\n   * This will cause `init --check` to fail if it's not 0.\n   */\n  totalRequiredChanges: number;\n  failed: boolean;\n  /** If true, the generated config previously existed but is now not needed and was deleted */\n  deletedGeneratedConfig?: boolean;\n\n  generatedFileUpdates: GeneratedPackageChanges[];\n  packagesWithErrors: InitPackageResultErrors[];\n  packagesWithWarnings: InitPackageResultWarnings[];\n}\n"]}
+{"version":3,"file":"InitSummary.js","sourceRoot":"","sources":["../../../../src/commands/init/types/InitSummary.ts"],"names":[],"mappings":"","sourcesContent":["import type { GeneratedPackageChanges } from './GeneratedPackageChanges.js';\nimport type { InitPackageResultErrors, InitPackageResultWarnings } from './InitPackageResult.js';\n\nexport interface InitSummary {\n  appPath: string;\n  duration: number;\n  /** True if there were errors, or if `check` was set and there were required changes. */\n  failed: boolean;\n  /** Total number of packages */\n  totalPackages: number;\n  /** Total packages without errors (doesn't consider required config changes) */\n  totalSuccess: number;\n  /** Total number of errors (doesn't include required config changes) */\n  totalErrors: number;\n  /** Total number of warnings (doesn't include config changes) */\n  totalWarnings: number;\n  /** Total number of changes made to the generated config */\n  totalChanges: number;\n  /**\n   * Total number of required changes made to the generated config.\n   * This will cause `init --check` to fail if it's not 0.\n   */\n  totalRequiredChanges: number;\n  /** If true, the generated config previously existed but is now not needed and was deleted */\n  deletedGeneratedConfig?: boolean;\n  /** Updates made to the generated config */\n  generatedFileUpdates: GeneratedPackageChanges[];\n  /** Results for each package with errors (doesn't include required config changes) */\n  packagesWithErrors: InitPackageResultErrors[];\n  /** Results for each package with warnings (doesn't include config changes) */\n  packagesWithWarnings: InitPackageResultWarnings[];\n}\n"]}

package/lib/utilities/readLocalConfigs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readLocalConfigs.d.ts","sourceRoot":"","sources":["../../src/utilities/readLocalConfigs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,eAAO,MAAM,gBAAgB,aACjB,MAAM,EAAE,qBACC,iBAAiB,KACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAgBzC,CAAC"}
+{"version":3,"file":"readLocalConfigs.d.ts","sourceRoot":"","sources":["../../src/utilities/readLocalConfigs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAAE,EAClB,mBAAmB,iBAAiB,KACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAgBzC,CAAC"}

package/lib/utilities/readRemoteConfigs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readRemoteConfigs.d.ts","sourceRoot":"","sources":["../../src/utilities/readRemoteConfigs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,eAAO,MAAM,iBAAiB,aAClB,MAAM,EAAE,qBACC,iBAAiB,KACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAezC,CAAC"}
+{"version":3,"file":"readRemoteConfigs.d.ts","sourceRoot":"","sources":["../../src/utilities/readRemoteConfigs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,EAAE,EAClB,mBAAmB,iBAAiB,KACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAezC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/cli",
-  "version": "0.73.5",
+  "version": "0.73.7",
   "description": "The Cloudpack command line interface - a tool for managing fast inner and outer looping in web apps.",
   "license": "MIT",
   "type": "module",
@@ -10,19 +10,19 @@
     "cloudpack": "./bin/cloudpack.js"
   },
   "dependencies": {
-    "@ms-cloudpack/api-server": "^0.61.33",
-    "@ms-cloudpack/app-server": "^0.17.87",
-    "@ms-cloudpack/bundler": "^0.24.28",
+    "@ms-cloudpack/api-server": "^0.61.35",
+    "@ms-cloudpack/app-server": "^0.17.89",
+    "@ms-cloudpack/bundler": "^0.24.30",
     "@ms-cloudpack/common-types": "^0.24.16",
     "@ms-cloudpack/config": "^0.35.0",
     "@ms-cloudpack/environment": "^0.1.1",
     "@ms-cloudpack/json-utilities": "^0.1.10",
-    "@ms-cloudpack/link-proxy": "^0.1.5",
-    "@ms-cloudpack/overlay": "^0.17.166",
+    "@ms-cloudpack/link-proxy": "^0.1.7",
+    "@ms-cloudpack/overlay": "^0.17.168",
     "@ms-cloudpack/package-utilities": "^12.3.3",
     "@ms-cloudpack/path-string-parsing": "^1.2.7",
     "@ms-cloudpack/path-utilities": "^3.1.0",
-    "@ms-cloudpack/remote-cache": "^0.11.11",
+    "@ms-cloudpack/remote-cache": "^0.11.12",
     "@ms-cloudpack/setup-utilities": "^0.5.23",
     "@ms-cloudpack/task-reporter": "^0.16.2",
     "@ms-cloudpack/telemetry": "^0.11.15",