@aws-cdk/toolkit-lib 1.24.0 → 1.25.1

package/lib/api/diagnosing/diagnosis-formatting.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostMessageFromDiagnosis = hostMessageFromDiagnosis;
+exports.throwDeploymentErrorFromDiagnosis = throwDeploymentErrorFromDiagnosis;
+const tree_builder_1 = require("./tree-builder");
+const toolkit_error_1 = require("../../toolkit/toolkit-error");
+const util_1 = require("../../util");
+const private_1 = require("../io/private");
+/**
+ * Turn the given stack diagnosis result into an IO message, with default message formatting
+ *
+ * The default message formatting is what the CLI will print.
+ */
+function hostMessageFromDiagnosis(stack) {
+    const diagnosis = stack.result;
+    switch (diagnosis.type) {
+        case 'no-problem':
+            return private_1.IO.CDK_TOOLKIT_I9500.msg(formatNoProblemStack(stack, diagnosis), stack);
+        case 'problem':
+            return private_1.IO.CDK_TOOLKIT_E9500.msg(formatProblemStack(stack, diagnosis), stack);
+        case 'error-diagnosing':
+            return private_1.IO.CDK_TOOLKIT_W9501.msg(formatDiagnosisErrorStack(stack, diagnosis), stack);
+    }
+}
+/**
+ * Turn the given diagnosis into a DeploymentError
+ */
+function throwDeploymentErrorFromDiagnosis(diag) {
+    switch (diag.type) {
+        case 'no-problem':
+            throw new toolkit_error_1.ToolkitError('DeploymentErrorNotError', 'Diagnosis should represent an error, but does not');
+        case 'error-diagnosing':
+            throw new toolkit_error_1.DeploymentError(diag.message, 'ErrorDiagnosisFailed');
+    }
+    // Guaranteed 'type=problem' here
+    const errorCode = diag.problems[0]?.errorCode;
+    let defaultErrorCode;
+    switch (diag.detectedBy.type) {
+        case 'change-set':
+            defaultErrorCode = 'ChangeSetCreationFailed';
+            break;
+        case 'early-validation':
+            defaultErrorCode = 'EarlyValidationFailure';
+            break;
+        case 'deployment':
+            defaultErrorCode = 'StackDeployFailed';
+            break;
+    }
+    throw new toolkit_error_1.DeploymentError(formatProblemDiagnosis(diag), errorCode ?? defaultErrorCode);
+}
+function formatProblemDiagnosis(diag) {
+    switch (diag.detectedBy.type) {
+        case 'change-set':
+            return formatChangeSetProblems(diag.problems, diag.detectedBy);
+        case 'early-validation':
+            return formatEarlyValidationProblems(diag.problems, diag.detectedBy);
+        case 'deployment':
+            return formatDeploymentProblems(diag.problems, diag.detectedBy);
+    }
+}
+function formatChangeSetProblems(problems, detectedBy) {
+    const caption = `Failed to create change set ${detectedBy.changeSetName}`;
+    if (problems.length > 0) {
+        return `${caption}:\n${formatResourceErrors(problems)}`;
+    }
+    else {
+        return `${caption}: ${detectedBy.statusReason}`;
+    }
+}
+function formatEarlyValidationProblems(problems, detectedBy) {
+    const caption = `Early validation failed for change set ${detectedBy.changeSetName}`;
+    if (problems.length > 0) {
+        return `${caption}:\n${formatResourceErrors(problems)}`;
+    }
+    else {
+        return caption;
+    }
+}
+function formatDeploymentProblems(problems, detectedBy) {
+    const caption = 'Resource updates failed';
+    if (problems.length > 0) {
+        return `${caption}:\n${formatResourceErrors(problems)}`;
+    }
+    else {
+        return `${caption} (${detectedBy.stackStatus}): ${detectedBy.statusReason}`;
+    }
+}
+function formatNoProblemStack(stack, _m) {
+    // TODO: print stack by construct path, not name
+    return `✅ Stack ${stack.stackName}: no issues found.`;
+}
+function formatProblemStack(stack, m) {
+    // TODO: print stack by construct path, not name
+    return `❌ Stack ${stack.stackName}:\n${formatProblemDiagnosis(m)}`;
+}
+function formatDiagnosisErrorStack(stack, m) {
+    // TODO: print stack by construct path, not name
+    return `⚠️ Could not diagnose stack ${stack.stackName}: ${m.message}`;
+}
+function formatResourceErrors(es) {
+    (0, util_1.sortByKey)(es, (e) => [locateResourceError(e)]);
+    const b = new tree_builder_1.TreeBuilder('');
+    for (const e of es) {
+        const p = locateResourceError(e);
+        const lastPart = p.split('/').slice(-1)[0];
+        const nodeText = b.nodeText(p);
+        nodeText.header = [`${lastPart}  ${addendum(' ', e.resourceType, e.logicalId)}`.trim()];
+        nodeText.body.push(...(0, tree_builder_1.sideBySide)(['🛑'], ' ', (0, tree_builder_1.wrapText)(120, e.message)));
+        nodeText.footer = e.sourceTrace?.creationStackTrace
+            ? (0, tree_builder_1.sideBySide)(['Source Location:'], ' ', e.sourceTrace?.creationStackTrace)
+            : [];
+    }
+    return b.render();
+}
+/**
+ * Return a /-separated construct path for the given error, or try to build as close a represention as possible if we don't have a construct path
+ *
+ * The root will be the "app"
+ */
+function locateResourceError(e) {
+    if (e.sourceTrace?.constructPath) {
+        return e.sourceTrace?.constructPath;
+    }
+    const nestedStackParts = e.parentStackLogicalIds.map((l) => `Nested stack ${l}`);
+    if (e.logicalId) {
+        return [e.topLevelStackHierarchicalId, ...nestedStackParts, e.logicalId].join('/');
+    }
+    // No logical ID means we are targeting the stack itself
+    return [e.topLevelStackHierarchicalId, nestedStackParts].join('/');
+}
+function addendum(sep, ...xs) {
+    xs = xs.filter(x => x && typeof x === 'string');
+    if (xs.length > 0) {
+        return `(${xs.join(sep)})`;
+    }
+    else {
+        return '';
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGlhZ25vc2lzLWZvcm1hdHRpbmcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJkaWFnbm9zaXMtZm9ybWF0dGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQVlBLDREQWFDO0FBS0QsOEVBMkJDO0FBekRELGlEQUFtRTtBQUVuRSwrREFBNEU7QUFDNUUscUNBQXVDO0FBRXZDLDJDQUFtQztBQUVuQzs7OztHQUlHO0FBQ0gsU0FBZ0Isd0JBQXdCLENBQUMsS0FBcUI7SUFDNUQsTUFBTSxTQUFTLEdBQUcsS0FBSyxDQUFDLE1BQU0sQ0FBQztJQUUvQixRQUFRLFNBQVMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUN2QixLQUFLLFlBQVk7WUFDZixPQUFPLFlBQUUsQ0FBQyxpQkFBaUIsQ0FBQyxHQUFHLENBQUMsb0JBQW9CLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBRWpGLEtBQUssU0FBUztZQUNaLE9BQU8sWUFBRSxDQUFDLGlCQUFpQixDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxLQUFLLEVBQUUsU0FBUyxDQUFDLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFFL0UsS0FBSyxrQkFBa0I7WUFDckIsT0FBTyxZQUFFLENBQUMsaUJBQWlCLENBQUMsR0FBRyxDQUFDLHlCQUF5QixDQUFDLEtBQUssRUFBRSxTQUFTLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUN4RixDQUFDO0FBQ0gsQ0FBQztBQUVEOztHQUVHO0FBQ0gsU0FBZ0IsaUNBQWlDLENBQUMsSUFBb0I7SUFDcEUsUUFBUSxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDbEIsS0FBSyxZQUFZO1lBQ2YsTUFBTSxJQUFJLDRCQUFZLENBQUMseUJBQXlCLEVBQUUsbURBQW1ELENBQUMsQ0FBQztRQUV6RyxLQUFLLGtCQUFrQjtZQUNyQixNQUFNLElBQUksK0JBQWUsQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLHNCQUFzQixDQUFDLENB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Q2xCLE9BQU8sSUFBSSxFQUFFLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUM7SUFDN0IsQ0FBQztTQUFNLENBQUM7UUFDTixPQUFPLEVBQUUsQ0FBQztJQUNaLENBQUM7QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgc2lkZUJ5U2lkZSwgVHJlZUJ1aWxkZXIsIHdyYXBUZXh0IH0gZnJvbSAnLi90cmVlLWJ1aWxkZXInO1xuaW1wb3J0IHR5cGUgeyBEaWFnbm9zZWRTdGFjaywgU3RhY2tEaWFnbm9zaXMsIFN0YWNrUHJvYmxlbVNvdXJjZSwgVHJhY2VkUmVzb3VyY2VFcnJvciB9IGZyb20gJy4uLy4uL2FjdGlvbnMvZGlhZ25vc2UnO1xuaW1wb3J0IHsgRGVwbG95bWVudEVycm9yLCBUb29sa2l0RXJyb3IgfSBmcm9tICcuLi8uLi90b29sa2l0L3Rvb2xraXQtZXJyb3InO1xuaW1wb3J0IHsgc29ydEJ5S2V5IH0gZnJvbSAnLi4vLi4vdXRpbCc7XG5pbXBvcnQgdHlwZSB7IEFjdGlvbkxlc3NNZXNzYWdlIH0gZnJvbSAnLi4vaW8vcHJpdmF0ZSc7XG5pbXBvcnQgeyBJTyB9IGZyb20gJy4uL2lvL3ByaXZhdGUnO1xuXG4vKipcbiAqIFR1cm4gdGhlIGdpdmVuIHN0YWNrIGRpYWdub3NpcyByZXN1bHQgaW50byBhbiBJTyBtZXNzYWdlLCB3aXRoIGRlZmF1bHQgbWVzc2FnZSBmb3JtYXR0aW5nXG4gKlxuICogVGhlIGRlZmF1bHQgbWVzc2FnZSBmb3JtYXR0aW5nIGlzIHdoYXQgdGhlIENMSSB3aWxsIHByaW50LlxuICovXG5leHBvcnQgZnVuY3Rpb24gaG9zdE1lc3NhZ2VGcm9tRGlhZ25vc2lzKHN0YWNrOiBEaWFnbm9zZWRTdGFjayk6IEFjdGlvbkxlc3NNZXNzYWdlPGFueT4ge1xuICBjb25zdCBkaWFnbm9zaXMgPSBzdGFjay5yZXN1bHQ7XG5cbiAgc3dpdGNoIChkaWFnbm9zaXMudHlwZSkge1xuICAgIGNhc2UgJ25vLXByb2JsZW0nOlxuICAgICAgcmV0dXJuIElPLkNES19UT09MS0lUX0k5NTAwLm1zZyhmb3JtYXROb1Byb2JsZW1TdGFjayhzdGFjaywgZGlhZ25vc2lzKSwgc3RhY2spO1xuXG4gICAgY2FzZSAncHJvYmxlbSc6XG4gICAgICByZXR1cm4gSU8uQ0RLX1RPT0xLSVRfRTk1MDAubXNnKGZvcm1hdFByb2JsZW1TdGFjayhzdGFjaywgZGlhZ25vc2lzKSwgc3RhY2spO1xuXG4gICAgY2FzZSAnZXJyb3ItZGlhZ25vc2luZyc6XG4gICAgICByZXR1cm4gSU8uQ0RLX1RPT0xLSVRfVzk1MDEubXNnKGZvcm1hdERpYWdub3Npc0Vycm9yU3RhY2soc3RhY2ssIGRpYWdub3NpcyksIHN0YWNrKTtcbiAgfVxufVxuXG4vKipcbiAqIFR1cm4gdGhlIGdpdmVuIGRpYWdub3NpcyBpbnRvIGEgRGVwbG95bWVudEVycm9yXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0aHJvd0RlcGxveW1lbnRFcnJvckZyb21EaWFnbm9zaXMoZGlhZzogU3RhY2tEaWFnbm9zaXMpOiBuZXZlciB7XG4gIHN3aXRjaCAoZGlhZy50eXBlKSB7XG4gICAgY2FzZSAnbm8tcHJvYmxlbSc6XG4gICAgICB0aHJvdyBuZXcgVG9vbGtpdEVycm9yKCdEZXBsb3ltZW50RXJyb3JOb3RFcnJvcicsICdEaWFnbm9zaXMgc2hvdWxkIHJlcHJlc2VudCBhbiBlcnJvciwgYnV0IGRvZXMgbm90Jyk7XG5cbiAgICBjYXNlICdlcnJvci1kaWFnbm9zaW5nJzpcbiAgICAgIHRocm93IG5ldyBEZXBsb3ltZW50RXJyb3IoZGlhZy5tZXNzYWdlLCAnRXJyb3JEaWFnbm9zaXNGYWlsZWQnKTtcbiAgfVxuICAvLyBHdWFyYW50ZWVkICd0eXBlPXByb2JsZW0nIGhlcmVcblxuICBjb25zdCBlcnJvckNvZGUgPSBkaWFnLnByb2JsZW1zWzBdPy5lcnJvckNvZGU7XG4gIGxldCBkZWZhdWx0RXJyb3JDb2RlO1xuICBzd2l0Y2ggKGRpYWcuZGV0ZWN0ZWRCeS50eXBlKSB7XG4gICAgY2FzZSAnY2hhbmdlLXNldCc6XG4gICAgICBkZWZhdWx0RXJyb3JDb2RlID0gJ0NoYW5nZVNldENyZWF0aW9uRmFpbGVkJztcbiAgICAgIGJyZWFrO1xuXG4gICAgY2FzZSAnZWFybHktdmFsaWRhdGlvbic6XG4gICAgICBkZWZhdWx0RXJyb3JDb2RlID0gJ0Vhcmx5VmFsaWRhdGlvbkZhaWx1cmUnO1xuICAgICAgYnJlYWs7XG5cbiAgICBjYXNlICdkZXBsb3ltZW50JzpcbiAgICAgIGRlZmF1bHRFcnJvckNvZGUgPSAnU3RhY2tEZXBsb3lGYWlsZWQnO1xuICAgICAgYnJlYWs7XG4gIH1cblxuICB0aHJvdyBuZXcgRGVwbG95bWVudEVycm9yKGZvcm1hdFByb2JsZW1EaWFnbm9zaXMoZGlhZyksIGVycm9yQ29kZSA/PyBkZWZhdWx0RXJyb3JDb2RlKTtcbn1cblxuZnVuY3Rpb24gZm9ybWF0UHJvYmxlbURpYWdub3NpcyhkaWFnOiBFeHRyYWN0PFN0YWNrRGlhZ25vc2lzLCB7IHR5cGU6ICdwcm9ibGVtJyB9Pik6IHN0cmluZyB7XG4gIHN3aXRjaCAoZGlhZy5kZXRlY3RlZEJ5LnR5cGUpIHtcbiAgICBjYXNlICdjaGFuZ2Utc2V0JzpcbiAgICAgIHJldHVybiBmb3JtYXRDaGFuZ2VTZXRQcm9ibGVtcyhkaWFnLnByb2JsZW1zLCBkaWFnLmRldGVjdGVkQnkpO1xuXG4gICAgY2FzZSAnZWFybHktdmFsaWRhdGlvbic6XG4gICAgICByZXR1cm4gZm9ybWF0RWFybHlWYWxpZGF0aW9uUHJvYmxlbXMoZGlhZy5wcm9ibGVtcywgZGlhZy5kZXRlY3RlZEJ5KTtcblxuICAgIGNhc2UgJ2RlcGxveW1lbnQnOlxuICAgICAgcmV0dXJuIGZvcm1hdERlcGxveW1lbnRQcm9ibGVtcyhkaWFnLnByb2JsZW1zLCBkaWFnLmRldGVjdGVkQnkpO1xuICB9XG59XG5cbmZ1bmN0aW9uIGZvcm1hdENoYW5nZVNldFByb2JsZW1zKHByb2JsZW1zOiBUcmFjZWRSZXNvdXJjZUVycm9yW10sIGRldGVjdGVkQnk6IEV4dHJhY3Q8U3RhY2tQcm9ibGVtU291cmNlLCB7IHR5cGU6ICdjaGFuZ2Utc2V0JyB9Pik6IHN0cmluZyB7XG4gIGNvbnN0IGNhcHRpb24gPSBgRmFpbGVkIHRvIGNyZWF0ZSBjaGFuZ2Ugc2V0ICR7ZGV0ZWN0ZWRCeS5jaGFuZ2VTZXROYW1lfWA7XG5cbiAgaWYgKHByb2JsZW1zLmxlbmd0aCA+IDApIHtcbiAgICByZXR1cm4gYCR7Y2FwdGlvbn06XFxuJHtmb3JtYXRSZXNvdXJjZUVycm9ycyhwcm9ibGVtcyl9YDtcbiAgfSBlbHNlIHtcbiAgICByZXR1cm4gYCR7Y2FwdGlvbn06ICR7ZGV0ZWN0ZWRCeS5zdGF0dXNSZWFzb259YDtcbiAgfVxufVxuXG5mdW5jdGlvbiBmb3JtYXRFYXJseVZhbGlkYXRpb25Qcm9ibGVtcyhwcm9ibGVtczogVHJhY2VkUmVzb3VyY2VFcnJvcltdLCBkZXRlY3RlZEJ5OiBFeHRyYWN0PFN0YWNrUHJvYmxlbVNvdXJjZSwgeyB0eXBlOiAnZWFybHktdmFsaWRhdGlvbicgfT4pOiBzdHJpbmcge1xuICBjb25zdCBjYXB0aW9uID0gYEVhcmx5IHZhbGlkYXRpb24gZmFpbGVkIGZvciBjaGFuZ2Ugc2V0ICR7ZGV0ZWN0ZWRCeS5jaGFuZ2VTZXROYW1lfWA7XG4gIGlmIChwcm9ibGVtcy5sZW5ndGggPiAwKSB7XG4gICAgcmV0dXJuIGAke2NhcHRpb259OlxcbiR7Zm9ybWF0UmVzb3VyY2VFcnJvcnMocHJvYmxlbXMpfWA7XG4gIH0gZWxzZSB7XG4gICAgcmV0dXJuIGNhcHRpb247XG4gIH1cbn1cblxuZnVuY3Rpb24gZm9ybWF0RGVwbG95bWVudFByb2JsZW1zKHByb2JsZW1zOiBUcmFjZWRSZXNvdXJjZUVycm9yW10sIGRldGVjdGVkQnk6IEV4dHJhY3Q8U3RhY2tQcm9ibGVtU291cmNlLCB7IHR5cGU6ICdkZXBsb3ltZW50JyB9Pik6IHN0cmluZyB7XG4gIGNvbnN0IGNhcHRpb24gPSAnUmVzb3VyY2UgdXBkYXRlcyBmYWlsZWQnO1xuXG4gIGlmIChwcm9ibGVtcy5sZW5ndGggPiAwKSB7XG4gICAgcmV0dXJuIGAke2NhcHRpb259OlxcbiR7Zm9ybWF0UmVzb3VyY2VFcnJvcnMocHJvYmxlbXMpfWA7XG4gIH0gZWxzZSB7XG4gICAgcmV0dXJuIGAke2NhcHRpb259ICgke2RldGVjdGVkQnkuc3RhY2tTdGF0dXN9KTogJHtkZXRlY3RlZEJ5LnN0YXR1c1JlYXNvbn1gO1xuICB9XG59XG5cbmZ1bmN0aW9uIGZvcm1hdE5vUHJvYmxlbVN0YWNrKHN0YWNrOiBEaWFnbm9zZWRTdGFjaywgX206IEV4dHJhY3Q8U3RhY2tEaWFnbm9zaXMsIHsgdHlwZTogJ25vLXByb2JsZW0nIH0+KSB7XG4gIC8vIFRPRE86IHByaW50IHN0YWNrIGJ5IGNvbnN0cnVjdCBwYXRoLCBub3QgbmFtZVxuICByZXR1cm4gYOKchSBTdGFjayAke3N0YWNrLnN0YWNrTmFtZX06IG5vIGlzc3VlcyBmb3VuZC5gO1xufVxuXG5mdW5jdGlvbiBmb3JtYXRQcm9ibGVtU3RhY2soc3RhY2s6IERpYWdub3NlZFN0YWNrLCBtOiBFeHRyYWN0PFN0YWNrRGlhZ25vc2lzLCB7IHR5cGU6ICdwcm9ibGVtJyB9Pikge1xuICAvLyBUT0RPOiBwcmludCBzdGFjayBieSBjb25zdHJ1Y3QgcGF0aCwgbm90IG5hbWVcbiAgcmV0dXJuIGDinYwgU3RhY2sgJHtzdGFjay5zdGFja05hbWV9OlxcbiR7Zm9ybWF0UHJvYmxlbURpYWdub3NpcyhtKX1gO1xufVxuXG5mdW5jdGlvbiBmb3JtYXREaWFnbm9zaXNFcnJvclN0YWNrKHN0YWNrOiBEaWFnbm9zZWRTdGFjaywgbTogRXh0cmFjdDxTdGFja0RpYWdub3NpcywgeyB0eXBlOiAnZXJyb3ItZGlhZ25vc2luZycgfT4pIHtcbiAgLy8gVE9ETzogcHJpbnQgc3RhY2sgYnkgY29uc3RydWN0IHBhdGgsIG5vdCBuYW1lXG4gIHJldHVybiBg4pqg77iPIENvdWxkIG5vdCBkaWFnbm9zZSBzdGFjayAke3N0YWNrLnN0YWNrTmFtZX06ICR7bS5tZXNzYWdlfWA7XG59XG5cbmZ1bmN0aW9uIGZvcm1hdFJlc291cmNlRXJyb3JzKGVzOiBUcmFjZWRSZXNvdXJjZUVycm9yW10pIHtcbiAgc29ydEJ5S2V5KGVzLCAoZSkgPT4gW2xvY2F0ZVJlc291cmNlRXJyb3IoZSldKTtcblxuICBjb25zdCBiID0gbmV3IFRyZWVCdWlsZGVyKCcnKTtcbiAgZm9yIChjb25zdCBlIG9mIGVzKSB7XG4gICAgY29uc3QgcCA9IGxvY2F0ZVJlc291cmNlRXJyb3IoZSk7XG4gICAgY29uc3QgbGFzdFBhcnQgPSBwLnNwbGl0KCcvJykuc2xpY2UoLTEpWzBdO1xuXG4gICAgY29uc3Qgbm9kZVRleHQgPSBiLm5vZGVUZXh0KHApO1xuICAgIG5vZGVUZXh0LmhlYWRlciA9IFtgJHtsYXN0UGFydH0gICR7YWRkZW5kdW0oJyAnLCBlLnJlc291cmNlVHlwZSwgZS5sb2dpY2FsSWQpfWAudHJpbSgpXTtcbiAgICBub2RlVGV4dC5ib2R5LnB1c2goLi4uc2lkZUJ5U2lkZShbJ/Cfm5EnXSwgJyAnLCB3cmFwVGV4dCgxMjAsIGUubWVzc2FnZSkpKTtcbiAgICBub2RlVGV4dC5mb290ZXIgPSBlLnNvdXJjZVRyYWNlPy5jcmVhdGlvblN0YWNrVHJhY2VcbiAgICAgID8gc2lkZUJ5U2lkZShbJ1NvdXJjZSBMb2NhdGlvbjonXSwgJyAnLCBlLnNvdXJjZVRyYWNlPy5jcmVhdGlvblN0YWNrVHJhY2UpXG4gICAgICA6IFtdO1xuICB9XG4gIHJldHVybiBiLnJlbmRlcigpO1xufVxuXG4vKipcbiAqIFJldHVybiBhIC8tc2VwYXJhdGVkIGNvbnN0cnVjdCBwYXRoIGZvciB0aGUgZ2l2ZW4gZXJyb3IsIG9yIHRyeSB0byBidWlsZCBhcyBjbG9zZSBhIHJlcHJlc2VudGlvbiBhcyBwb3NzaWJsZSBpZiB3ZSBkb24ndCBoYXZlIGEgY29uc3RydWN0IHBhdGhcbiAqXG4gKiBUaGUgcm9vdCB3aWxsIGJlIHRoZSBcImFwcFwiXG4gKi9cbmZ1bmN0aW9uIGxvY2F0ZVJlc291cmNlRXJyb3IoZTogVHJhY2VkUmVzb3VyY2VFcnJvcik6IHN0cmluZyB7XG4gIGlmIChlLnNvdXJjZVRyYWNlPy5jb25zdHJ1Y3RQYXRoKSB7XG4gICAgcmV0dXJuIGUuc291cmNlVHJhY2U/LmNvbnN0cnVjdFBhdGg7XG4gIH1cblxuICBjb25zdCBuZXN0ZWRTdGFja1BhcnRzID0gZS5wYXJlbnRTdGFja0xvZ2ljYWxJZHMubWFwKChsKSA9PiBgTmVzdGVkIHN0YWNrICR7bH1gKTtcbiAgaWYgKGUubG9naWNhbElkKSB7XG4gICAgcmV0dXJuIFtlLnRvcExldmVsU3RhY2tIaWVyYXJjaGljYWxJZCwgLi4ubmVzdGVkU3RhY2tQYXJ0cywgZS5sb2dpY2FsSWRdLmpvaW4oJy8nKTtcbiAgfVxuICAvLyBObyBsb2dpY2FsIElEIG1lYW5zIHdlIGFyZSB0YXJnZXRpbmcgdGhlIHN0YWNrIGl0c2VsZlxuICByZXR1cm4gW2UudG9wTGV2ZWxTdGFja0hpZXJhcmNoaWNhbElkLCBuZXN0ZWRTdGFja1BhcnRzXS5qb2luKCcvJyk7XG59XG5cbmZ1bmN0aW9uIGFkZGVuZHVtKHNlcDogc3RyaW5nLCAuLi54czogQXJyYXk8c3RyaW5nIHwgdW5kZWZpbmVkPik6IHN0cmluZyB7XG4gIHhzID0geHMuZmlsdGVyKHggPT4geCAmJiB0eXBlb2YgeCA9PT0gJ3N0cmluZycpO1xuICBpZiAoeHMubGVuZ3RoID4gMCkge1xuICAgIHJldHVybiBgKCR7eHMuam9pbihzZXApfSlgO1xuICB9IGVsc2Uge1xuICAgIHJldHVybiAnJztcbiAgfVxufVxuIl19

package/lib/api/diagnosing/stack-diagnoser.d.ts

@@ -0,0 +1,106 @@
+import type { ChangeSetSummary, Stack } from '@aws-sdk/client-cloudformation';
+import type { StackDiagnosis } from '../../actions/diagnose';
+import type { SDK } from '../aws-auth/sdk';
+import type { EnvironmentResources } from '../environment';
+import type { IoHelper } from '../io/private/io-helper';
+import type { ISourceTracer } from '../source-tracing/private/source-tracing';
+import type { ResourceErrors } from '../stack-events/resource-errors';
+export interface CloudFormationStackDiagnoserProps {
+    readonly sdk: SDK;
+    readonly envResources?: EnvironmentResources;
+    readonly sourceTracer: ISourceTracer;
+    readonly ioHelper: IoHelper;
+    readonly topLevelStackHierarchicalId: string;
+}
+/**
+ * Diagnose a stack's failed state
+ *
+ * - First, determine the stack's state.
+ * - If it is in a failed state, we started a deployment that failed. Describe the stack
+ *   events, and try to determine the root cause from that.
+ * - If it is in a normal state, see if there are any failed change sets. Either
+ *   get the failure message from the change set, or get the failure events from
+ *   the change set (early validation).
+ *
+ * This class works at the CloudFormation level, and does not deal with tracing
+ * CloudFormation errors to construct code sources yet.
+ */
+export declare class CloudFormationStackDiagnoser {
+    private readonly props;
+    private readonly cfn;
+    private parentStackLogicalIds;
+    constructor(props: CloudFormationStackDiagnoserProps);
+    /**
+     * Diagnose a stack's root cause given no pre-existing state
+     */
+    diagnoseFromFresh(stackName: string): Promise<StackDiagnosis>;
+    /**
+     * Diagnose potential problems with the change set
+     */
+    diagnoseChangeSet(changeSet: ChangeSetSummary): Promise<StackDiagnosis>;
+    /**
+     * Diagnose potential problems with the change set
+     */
+    diagnoseFromErrorCollection(errors: ResourceErrors, stack: Stack): Promise<StackDiagnosis>;
+    /**
+     * Diagnose a deployment failure via stack events
+     *
+     * This is the same logic that the deployment monitor uses.
+     */
+    private _diagnoseViaStackEvents;
+    private _diagnoseChangeSetFailureFromStackName;
+    /**
+     * Try to diagnose the reason that caused a changeset to fail to create
+     *
+     * There are a couple of different reasons this can happen, and we go through each of them in order.
+     *
+     * Usually this starts from trying to detect an error message pattern in the change set status reason,
+     * and then potentially going to fetch additional information using additional API calls.
+     */
+    private _diagnoseChangeSetFailure;
+    /**
+     * Try to read the resource-specific reasons for a changeset failure from `DescribeEvents`.
+     *
+     * If we couldn't read the events or there are 0 errors returned by that API, return a generic
+     * error.
+     */
+    private _reportChangeSetFailureFromEvents;
+    private addErrorTraces;
+    private addErrorTrace;
+    /**
+     * Build a generic stack error from the given change set information
+     *
+     * We can't point to a specific resource.
+     */
+    private _nonSpecificChangeSetError;
+    /**
+     * Look for nested change sets that have failed, and diagnose those.
+     */
+    private _diagnoseNestedChangeSetFailure;
+    private _findFailedNestedStack;
+    /**
+     * Try to parse failed auto-imports out from a change set status
+     *
+     * The pattern looks like this:
+     *
+     * ```
+     * CloudFormation is attempting to import some resources because they already exist in your account. The resources must have the DeletionPolicy attribute set to 'Retain' or 'RetainExceptOnCreate' in the template for successful import. The affected resources are SomeBucketD5B70704 ({BucketName=zomaareenbucket})
+     * ```
+     *
+     * Followed by
+     *
+     * ```
+     * LogicalID ({Prop=Value,Prop=Value}), LogicalID ({Prop=Value}), ...
+     * ```
+     */
+    private _tryDetectFailedAutoImport;
+}
+/**
+ * Return true if the given change set has no changes
+ *
+ * This must be determined from the status, not the 'Changes' array on the
+ * object; the latter can be empty because no resources were changed, but if
+ * there are changes to Outputs, the change set can still be executed.
+ */
+export declare function changeSetHasNoChanges(description: ChangeSetSummary): boolean;
+//# sourceMappingURL=stack-diagnoser.d.ts.map