@aws-cdk/toolkit-lib 1.23.0 → 1.25.0

package/lib/api/source-tracing/private/stack-source-tracing.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StackArtifactSourceTracer = void 0;
+const fs = require("fs");
+const path = require("path");
+const cxapi = require("@aws-cdk/cloud-assembly-api");
+const cxschema = require("@aws-cdk/cloud-assembly-schema");
+/**
+ * Use a stack artifact as the root for tracing problems with this deployment
+ *
+ * The stack can be either the stack itself, or a nested stack inside it.
+ *
+ * ## Strategy
+ *
+ * The first thing we need to do is translate the given resource to a
+ * construct path.
+ *
+ * - The construct path can be found in the target template, if that option was
+ *   enabled during synthesis; or
+ * - We can (try to) dig it out of the `tree.json` once
+ *   https://github.com/aws/aws-cdk/pull/37630 is merged (although we still
+ *   need some information about the stack).
+ *
+ * Especially for nested stacks the above is hard, since this called from a
+ * place where we only have CloudFormation information (stack name). The stack
+ * name of a nested stack cannot be predicted in advance, and even if we have
+ * the list of logical IDs to get to the nested stack (which we do), finding
+ * the actual template is not easy.
+ */
+class StackArtifactSourceTracer {
+    stack;
+    constructor(stack) {
+        this.stack = stack;
+    }
+    async traceResource(_stackName, nestedStackLogicalIds, logicalId, propertyName) {
+        const containingTemplate = getStackTemplate(this.stack, nestedStackLogicalIds);
+        const constructPath = containingTemplate?.Resources?.[logicalId]?.Metadata?.[cxapi.PATH_METADATA_KEY];
+        if (!constructPath) {
+            return undefined;
+        }
+        return {
+            constructPath,
+            creationStackTrace: findCreationStackTrace(this.stack, constructPath),
+            mutationStackTraces: propertyName ? findMutationStackTraces(this.stack, constructPath, propertyName) : undefined,
+        };
+    }
+    async traceStack(_stackName, nestedStackLogicalIds) {
+        // This can either be a stack or nested stack. If it's a nested stack, trace the resource
+        // in the parent stack.
+        if (nestedStackLogicalIds.length > 0) {
+            const lastLogicalId = nestedStackLogicalIds.pop();
+            return this.traceResource(_stackName, nestedStackLogicalIds, lastLogicalId);
+        }
+        // Must be the root stack
+        const constructPath = this.stack.hierarchicalId;
+        return {
+            constructPath,
+            creationStackTrace: findCreationStackTrace(this.stack, constructPath),
+        };
+    }
+}
+exports.StackArtifactSourceTracer = StackArtifactSourceTracer;
+/**
+ * Try to find the creation stack trace for the given construct
+ *
+ * - This can be the 'trace' of adding the 'aws:cdk:logicalId' metadata.
+ * - This can also be dedicated metadata (we haven't added it yet).
+ *
+ * The construct path in metadata ALWAYS starts with a `/` while the construct path
+ * we have here probably doesn't, account for that as well.
+ *
+ * Stack's currently don't emit any stack traces.
+ */
+function findCreationStackTrace(stack, constructPath) {
+    const candidates = [
+        // logical ID traces
+        ...resourceMetadata(stack, constructPath, cxschema.ArtifactMetadataEntryType.LOGICAL_ID).flatMap((m) => {
+            if (m.trace) {
+                return [m.trace];
+            }
+            return [];
+        }),
+        // Creation stack
+        ...resourceMetadata(stack, constructPath, 'aws:cdk:creationStack').flatMap((m) => {
+            if (m.data) {
+                return [m.data];
+            }
+            return [];
+        }),
+    ];
+    return candidates[0];
+}
+/**
+ * Find property mutation stack traces
+ *
+ * These are all places in the code where a property's value is overwritten after
+ * construct creation.
+ */
+function findMutationStackTraces(stack, constructPath, propertyName) {
+    const assignments = resourceMetadata(stack, constructPath, 'aws:cdk:propertyAssignment');
+    return assignments.flatMap((m) => {
+        const data = m.data;
+        if (data?.propertyName === propertyName) {
+            return [data.stackTrace];
+        }
+        return [];
+    });
+}
+function resourceMetadata(stack, constructPath, metadataType) {
+    if (!constructPath.startsWith('/')) {
+        constructPath = '/' + constructPath;
+    }
+    return (stack.metadata[constructPath] ?? []).filter((m) => m.type === metadataType);
+}
+/**
+ * Find the stack template given a root stack and a logical ID path into nested stacks
+ */
+function getStackTemplate(stack, logicalIdPath) {
+    let template = stack.template;
+    const segments = [...logicalIdPath];
+    while (segments.length > 0) {
+        const next = segments.shift();
+        // The nested stack resource has metadata to tell us which (local) file
+        // we are looking for: "aws:asset:path".
+        const nextTemplateFile = template.Resources[next]?.Metadata?.[cxapi.ASSET_RESOURCE_METADATA_PATH_KEY];
+        if (!nextTemplateFile) {
+            return undefined;
+        }
+        const nextTemplatePath = path.join(path.dirname(stack.templateFullPath), nextTemplateFile);
+        template = JSON.parse(fs.readFileSync(nextTemplatePath, 'utf-8'));
+    }
+    return template;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhY2stc291cmNlLXRyYWNpbmcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJzdGFjay1zb3VyY2UtdHJhY2luZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSx5QkFBeUI7QUFDekIsNkJBQTZCO0FBQzdCLHFEQUFxRDtBQUNyRCwyREFBMkQ7QUFJM0Q7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXFCRztBQUNILE1BQWEseUJBQXlCO0lBQ1A7SUFBN0IsWUFBNkIsS0FBd0M7UUFBeEMsVUFBSyxHQUFMLEtBQUssQ0FBbUM7SUFDckUsQ0FBQztJQUVNLEtBQUssQ0FBQyxhQUFhLENBQ3hCLFVBQWtCLEVBQ2xCLHFCQUErQixFQUMvQixTQUFpQixFQUNqQixZQUFxQjtRQUVyQixNQUFNLGtCQUFrQixHQUFHLGdCQUFnQixDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUscUJBQXFCLENBQUMsQ0FBQztRQUUvRSxNQUFNLGFBQWEsR0FBRyxrQkFBa0IsRUFBRSxTQUFTLEVBQUUsQ0FBQyxTQUFTLENBQUMsRUFBRSxRQUFRLEVBQUUsQ0FBQyxLQUFLLENBQUMsaUJBQWlCLENBQUMsQ0FBQztRQUN0RyxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7WUFDbkIsT0FBTyxTQUFTLENBQUM7UUFDbkIsQ0FBQztRQUVELE9BQU87WUFDTCxhQUFhO1lBQ2Isa0JBQWtCLEVBQUUsc0JBQXNCLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRSxhQUFhLENBQUM7WUFDckUsbUJBQW1CLEVBQUUsWUFBWSxDQUFDLENBQUMsQ0FBQyx1QkFBdUIsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLGFBQWEsRUFBRSxZQUFZLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUztTQUNqSCxDQUFDO0lBQ0osQ0FBQztJQUVNLEtBQUssQ0FBQyxVQUFVLENBQUMsVUFBa0IsRUFBRSxxQkFBK0I7UUFDekUseUZBQXlGO1FBQ3pGLHVCQUF1QjtRQUN2QixJQUFJLHFCQUFxQixDQUFDLE1B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QixNQUFNLElBQUksR0FBRyxRQUFRLENBQUMsS0FBSyxFQUFHLENBQUM7UUFFL0IsdUVBQXVFO1FBQ3ZFLHdDQUF3QztRQUN4QyxNQUFNLGdCQUFnQixHQUFHLFFBQVEsQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLEVBQUUsUUFBUSxFQUFFLENBQUMsS0FBSyxDQUFDLGdDQUFnQyxDQUFDLENBQUM7UUFDdEcsSUFBSSxDQUFDLGdCQUFnQixFQUFFLENBQUM7WUFDdEIsT0FBTyxTQUFTLENBQUM7UUFDbkIsQ0FBQztRQUVELE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFFLGdCQUFnQixDQUFDLENBQUM7UUFDM0YsUUFBUSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLFlBQVksQ0FBQyxnQkFBZ0IsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDO0lBQ3BFLENBQUM7SUFFRCxPQUFPLFFBQVEsQ0FBQztBQUNsQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgZnMgZnJvbSAnZnMnO1xuaW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCAqIGFzIGN4YXBpIGZyb20gJ0Bhd3MtY2RrL2Nsb3VkLWFzc2VtYmx5LWFwaSc7XG5pbXBvcnQgKiBhcyBjeHNjaGVtYSBmcm9tICdAYXdzLWNkay9jbG91ZC1hc3NlbWJseS1zY2hlbWEnO1xuaW1wb3J0IHR5cGUgeyBTb3VyY2VUcmFjZSB9IGZyb20gJy4uL3R5cGVzJztcbmltcG9ydCB0eXBlIHsgSVNvdXJjZVRyYWNlciB9IGZyb20gJy4vc291cmNlLXRyYWNpbmcnO1xuXG4vKipcbiAqIFVzZSBhIHN0YWNrIGFydGlmYWN0IGFzIHRoZSByb290IGZvciB0cmFjaW5nIHByb2JsZW1zIHdpdGggdGhpcyBkZXBsb3ltZW50XG4gKlxuICogVGhlIHN0YWNrIGNhbiBiZSBlaXRoZXIgdGhlIHN0YWNrIGl0c2VsZiwgb3IgYSBuZXN0ZWQgc3RhY2sgaW5zaWRlIGl0LlxuICpcbiAqICMjIFN0cmF0ZWd5XG4gKlxuICogVGhlIGZpcnN0IHRoaW5nIHdlIG5lZWQgdG8gZG8gaXMgdHJhbnNsYXRlIHRoZSBnaXZlbiByZXNvdXJjZSB0byBhXG4gKiBjb25zdHJ1Y3QgcGF0aC5cbiAqXG4gKiAtIFRoZSBjb25zdHJ1Y3QgcGF0aCBjYW4gYmUgZm91bmQgaW4gdGhlIHRhcmdldCB0ZW1wbGF0ZSwgaWYgdGhhdCBvcHRpb24gd2FzXG4gKiAgIGVuYWJsZWQgZHVyaW5nIHN5bnRoZXNpczsgb3JcbiAqIC0gV2UgY2FuICh0cnkgdG8pIGRpZyBpdCBvdXQgb2YgdGhlIGB0cmVlLmpzb25gIG9uY2VcbiAqICAgaHR0cHM6Ly9naXRodWIuY29tL2F3cy9hd3MtY2RrL3B1bGwvMzc2MzAgaXMgbWVyZ2VkIChhbHRob3VnaCB3ZSBzdGlsbFxuICogICBuZWVkIHNvbWUgaW5mb3JtYXRpb24gYWJvdXQgdGhlIHN0YWNrKS5cbiAqXG4gKiBFc3BlY2lhbGx5IGZvciBuZXN0ZWQgc3RhY2tzIHRoZSBhYm92ZSBpcyBoYXJkLCBzaW5jZSB0aGlzIGNhbGxlZCBmcm9tIGFcbiAqIHBsYWNlIHdoZXJlIHdlIG9ubHkgaGF2ZSBDbG91ZEZvcm1hdGlvbiBpbmZvcm1hdGlvbiAoc3RhY2sgbmFtZSkuIFRoZSBzdGFja1xuICogbmFtZSBvZiBhIG5lc3RlZCBzdGFjayBjYW5ub3QgYmUgcHJlZGljdGVkIGluIGFkdmFuY2UsIGFuZCBldmVuIGlmIHdlIGhhdmVcbiAqIHRoZSBsaXN0IG9mIGxvZ2ljYWwgSURzIHRvIGdldCB0byB0aGUgbmVzdGVkIHN0YWNrICh3aGljaCB3ZSBkbyksIGZpbmRpbmdcbiAqIHRoZSBhY3R1YWwgdGVtcGxhdGUgaXMgbm90IGVhc3kuXG4gKi9cbmV4cG9ydCBjbGFzcyBTdGFja0FydGlmYWN0U291cmNlVHJhY2VyIGltcGxlbWVudHMgSVNvdXJjZVRyYWNlciB7XG4gIGNvbnN0cnVjdG9yKHByaXZhdGUgcmVhZG9ubHkgc3RhY2s6IGN4YXBpLkNsb3VkRm9ybWF0aW9uU3RhY2tBcnRpZmFjdCkge1xuICB9XG5cbiAgcHVibGljIGFzeW5jIHRyYWNlUmVzb3VyY2UoXG4gICAgX3N0YWNrTmFtZTogc3RyaW5nLFxuICAgIG5lc3RlZFN0YWNrTG9naWNhbElkczogc3RyaW5nW10sXG4gICAgbG9naWNhbElkOiBzdHJpbmcsXG4gICAgcHJvcGVydHlOYW1lPzogc3RyaW5nLFxuICApOiBQcm9taXNlPFNvdXJjZVRyYWNlIHwgdW5kZWZpbmVkPiB7XG4gICAgY29uc3QgY29udGFpbmluZ1RlbXBsYXRlID0gZ2V0U3RhY2tUZW1wbGF0ZSh0aGlzLnN0YWNrLCBuZXN0ZWRTdGFja0xvZ2ljYWxJZHMpO1xuXG4gICAgY29uc3QgY29uc3RydWN0UGF0aCA9IGNvbnRhaW5pbmdUZW1wbGF0ZT8uUmVzb3VyY2VzPy5bbG9naWNhbElkXT8uTWV0YWRhdGE/LltjeGFwaS5QQVRIX01FVEFEQVRBX0tFWV07XG4gICAgaWYgKCFjb25zdHJ1Y3RQYXRoKSB7XG4gICAgICByZXR1cm4gdW5kZWZpbmVkO1xuICAgIH1cblxuICAgIHJldHVybiB7XG4gICAgICBjb25zdHJ1Y3RQYXRoLFxuICAgICAgY3JlYXRpb25TdGFja1RyYWNlOiBmaW5kQ3JlYXRpb25TdGFja1RyYWNlKHRoaXMuc3RhY2ssIGNvbnN0cnVjdFBhdGgpLFxuICAgICAgbXV0YXRpb25TdGFja1RyYWNlczogcHJvcGVydHlOYW1lID8gZmluZE11dGF0aW9uU3RhY2tUcmFjZXModGhpcy5zdGFjaywgY29uc3RydWN0UGF0aCwgcHJvcGVydHlOYW1lKSA6IHVuZGVmaW5lZCxcbiAgICB9O1xuICB9XG5cbiAgcHVibGljIGFzeW5jIHRyYWNlU3RhY2soX3N0YWNrTmFtZTogc3RyaW5nLCBuZXN0ZWRTdGFja0xvZ2ljYWxJZHM6IHN0cmluZ1tdKTogUHJvbWlzZTxTb3VyY2VUcmFjZSB8IHVuZGVmaW5lZD4ge1xuICAgIC8vIFRoaXMgY2FuIGVpdGhlciBiZSBhIHN0YWNrIG9yIG5lc3RlZCBzdGFjay4gSWYgaXQncyBhIG5lc3RlZCBzdGFjaywgdHJhY2UgdGhlIHJlc291cmNlXG4gICAgLy8gaW4gdGhlIHBhcmVudCBzdGFjay5cbiAgICBpZiAobmVzdGVkU3RhY2tMb2dpY2FsSWRzLmxlbmd0aCA+IDApIHtcbiAgICAgIGNvbnN0IGxhc3RMb2dpY2FsSWQgPSBuZXN0ZWRTdGFja0xvZ2ljYWxJZHMucG9wKCkhO1xuICAgICAgcmV0dXJuIHRoaXMudHJhY2VSZXNvdXJjZShfc3RhY2tOYW1lLCBuZXN0ZWRTdGFja0xvZ2ljYWxJZHMsIGxhc3RMb2dpY2FsSWQpO1xuICAgIH1cblxuICAgIC8vIE11c3QgYmUgdGhlIHJvb3Qgc3RhY2tcbiAgICBjb25zdCBjb25zdHJ1Y3RQYXRoID0gdGhpcy5zdGFjay5oaWVyYXJjaGljYWxJZDtcbiAgICByZXR1cm4ge1xuICAgICAgY29uc3RydWN0UGF0aCxcbiAgICAgIGNyZWF0aW9uU3RhY2tUcmFjZTogZmluZENyZWF0aW9uU3RhY2tUcmFjZSh0aGlzLnN0YWNrLCBjb25zdHJ1Y3RQYXRoKSxcbiAgICB9O1xuICB9XG59XG5cbi8qKlxuICogVHJ5IHRvIGZpbmQgdGhlIGNyZWF0aW9uIHN0YWNrIHRyYWNlIGZvciB0aGUgZ2l2ZW4gY29uc3RydWN0XG4gKlxuICogLSBUaGlzIGNhbiBiZSB0aGUgJ3RyYWNlJyBvZiBhZGRpbmcgdGhlICdhd3M6Y2RrOmxvZ2ljYWxJZCcgbWV0YWRhdGEuXG4gKiAtIFRoaXMgY2FuIGFsc28gYmUgZGVkaWNhdGVkIG1ldGFkYXRhICh3ZSBoYXZlbid0IGFkZGVkIGl0IHlldCkuXG4gKlxuICogVGhlIGNvbnN0cnVjdCBwYXRoIGluIG1ldGFkYXRhIEFMV0FZUyBzdGFydHMgd2l0aCBhIGAvYCB3aGlsZSB0aGUgY29uc3RydWN0IHBhdGhcbiAqIHdlIGhhdmUgaGVyZSBwcm9iYWJseSBkb2Vzbid0LCBhY2NvdW50IGZvciB0aGF0IGFzIHdlbGwuXG4gKlxuICogU3RhY2sncyBjdXJyZW50bHkgZG9uJ3QgZW1pdCBhbnkgc3RhY2sgdHJhY2VzLlxuICovXG5mdW5jdGlvbiBmaW5kQ3JlYXRpb25TdGFja1RyYWNlKHN0YWNrOiBjeGFwaS5DbG91ZEZvcm1hdGlvblN0YWNrQXJ0aWZhY3QsIGNvbnN0cnVjdFBhdGg6IHN0cmluZyk6IHN0cmluZ1tdIHwgdW5kZWZpbmVkIHtcbiAgY29uc3QgY2FuZGlkYXRlcyA9IFtcbiAgICAvLyBsb2dpY2FsIElEIHRyYWNlc1xuICAgIC4uLnJlc291cmNlTWV0YWRhdGEoc3RhY2ssIGNvbnN0cnVjdFBhdGgsIGN4c2NoZW1hLkFydGlmYWN0TWV0YWRhdGFFbnRyeVR5cGUuTE9HSUNBTF9JRCkuZmxhdE1hcCgobSkgPT4ge1xuICAgICAgaWYgKG0udHJhY2UpIHtcbiAgICAgICAgcmV0dXJuIFttLnRyYWNlXTtcbiAgICAgIH1cbiAgICAgIHJldHVybiBbXTtcbiAgICB9KSxcbiAgICAvLyBDcmVhdGlvbiBzdGFja1xuICAgIC4uLnJlc291cmNlTWV0YWRhdGEoc3RhY2ssIGNvbnN0cnVjdFBhdGgsICdhd3M6Y2RrOmNyZWF0aW9uU3RhY2snKS5mbGF0TWFwKChtKSA9PiB7XG4gICAgICBpZiAobS5kYXRhKSB7XG4gICAgICAgIHJldHVybiBbbS5kYXRhIGFzIHVua25vd24gYXMgc3RyaW5nW11dO1xuICAgICAgfVxuICAgICAgcmV0dXJuIFtdO1xuICAgIH0pLFxuICBdO1xuXG4gIHJldHVybiBjYW5kaWRhdGVzWzBdO1xufVxuXG4vKipcbiAqIEZpbmQgcHJvcGVydHkgbXV0YXRpb24gc3RhY2sgdHJhY2VzXG4gKlxuICogVGhlc2UgYXJlIGFsbCBwbGFjZXMgaW4gdGhlIGNvZGUgd2hlcmUgYSBwcm9wZXJ0eSdzIHZhbHVlIGlzIG92ZXJ3cml0dGVuIGFmdGVyXG4gKiBjb25zdHJ1Y3QgY3JlYXRpb24uXG4gKi9cbmZ1bmN0aW9uIGZpbmRNdXRhdGlvblN0YWNrVHJhY2VzKHN0YWNrOiBjeGFwaS5DbG91ZEZvcm1hdGlvblN0YWNrQXJ0aWZhY3QsIGNvbnN0cnVjdFBhdGg6IHN0cmluZywgcHJvcGVydHlOYW1lOiBzdHJpbmcpOiBzdHJpbmdbXVtdIHwgdW5kZWZpbmVkIHtcbiAgY29uc3QgYXNzaWdubWVudHMgPSByZXNvdXJjZU1ldGFkYXRhKHN0YWNrLCBjb25zdHJ1Y3RQYXRoLCAnYXdzOmNkazpwcm9wZXJ0eUFzc2lnbm1lbnQnKTtcblxuICByZXR1cm4gYXNzaWdubWVudHMuZmxhdE1hcCgobSkgPT4ge1xuICAgIGNvbnN0IGRhdGE6IFByb3BlcnR5QXNzaWdubWVudERhdGEgfCB1bmRlZmluZWQgPSBtLmRhdGEgYXMgYW55O1xuICAgIGlmIChkYXRhPy5wcm9wZXJ0eU5hbWUgPT09IHByb3BlcnR5TmFtZSkge1xuICAgICAgcmV0dXJuIFtkYXRhLnN0YWNrVHJhY2VdO1xuICAgIH1cbiAgICByZXR1cm4gW107XG4gIH0pO1xufVxuXG5mdW5jdGlvbiByZXNvdXJjZU1ldGFkYXRhKHN0YWNrOiBjeGFwaS5DbG91ZEZvcm1hdGlvblN0YWNrQXJ0aWZhY3QsIGNvbnN0cnVjdFBhdGg6IHN0cmluZywgbWV0YWRhdGFUeXBlOiBzdHJpbmcpOiBjeHNjaGVtYS5NZXRhZGF0YUVudHJ5W10ge1xuICBpZiAoIWNvbnN0cnVjdFBhdGguc3RhcnRzV2l0aCgnLycpKSB7XG4gICAgY29uc3RydWN0UGF0aCA9ICcvJyArIGNvbnN0cnVjdFBhdGg7XG4gIH1cblxuICByZXR1cm4gKHN0YWNrLm1ldGFkYXRhW2NvbnN0cnVjdFBhdGhdID8/IFtdKS5maWx0ZXIoKG0pID0+IG0udHlwZSA9PT0gbWV0YWRhdGFUeXBlKTtcbn1cblxuLyoqXG4gKiBGaW5kIHRoZSBzdGFjayB0ZW1wbGF0ZSBnaXZlbiBhIHJvb3Qgc3RhY2sgYW5kIGEgbG9naWNhbCBJRCBwYXRoIGludG8gbmVzdGVkIHN0YWNrc1xuICovXG5mdW5jdGlvbiBnZXRTdGFja1RlbXBsYXRlKHN0YWNrOiBjeGFwaS5DbG91ZEZvcm1hdGlvblN0YWNrQXJ0aWZhY3QsIGxvZ2ljYWxJZFBhdGg6IHJlYWRvbmx5IHN0cmluZ1tdKTogYW55IHwgdW5kZWZpbmVkIHtcbiAgbGV0IHRlbXBsYXRlID0gc3RhY2sudGVtcGxhdGU7XG4gIGNvbnN0IHNlZ21lbnRzID0gWy4uLmxvZ2ljYWxJZFBhdGhdO1xuICB3aGlsZSAoc2VnbWVudHMubGVuZ3RoID4gMCkge1xuICAgIGNvbnN0IG5leHQgPSBzZWdtZW50cy5zaGlmdCgpITtcblxuICAgIC8vIFRoZSBuZXN0ZWQgc3RhY2sgcmVzb3VyY2UgaGFzIG1ldGFkYXRhIHRvIHRlbGwgdXMgd2hpY2ggKGxvY2FsKSBmaWxlXG4gICAgLy8gd2UgYXJlIGxvb2tpbmcgZm9yOiBcImF3czphc3NldDpwYXRoXCIuXG4gICAgY29uc3QgbmV4dFRlbXBsYXRlRmlsZSA9IHRlbXBsYXRlLlJlc291cmNlc1tuZXh0XT8uTWV0YWRhdGE/LltjeGFwaS5BU1NFVF9SRVNPVVJDRV9NRVRBREFUQV9QQVRIX0tFWV07XG4gICAgaWYgKCFuZXh0VGVtcGxhdGVGaWxlKSB7XG4gICAgICByZXR1cm4gdW5kZWZpbmVkO1xuICAgIH1cblxuICAgIGNvbnN0IG5leHRUZW1wbGF0ZVBhdGggPSBwYXRoLmpvaW4ocGF0aC5kaXJuYW1lKHN0YWNrLnRlbXBsYXRlRnVsbFBhdGgpLCBuZXh0VGVtcGxhdGVGaWxlKTtcbiAgICB0ZW1wbGF0ZSA9IEpTT04ucGFyc2UoZnMucmVhZEZpbGVTeW5jKG5leHRUZW1wbGF0ZVBhdGgsICd1dGYtOCcpKTtcbiAgfVxuXG4gIHJldHVybiB0ZW1wbGF0ZTtcbn1cblxuaW50ZXJmYWNlIFByb3BlcnR5QXNzaWdubWVudERhdGEge1xuICBwcm9wZXJ0eU5hbWU6IHN0cmluZztcbiAgc3RhY2tUcmFjZTogc3RyaW5nW107XG59XG4iXX0=

package/lib/api/source-tracing/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Enough information to locate a certain CloudFormation resource in a CDK app
+ */
+export interface SourceTrace {
+    readonly constructPath: string;
+    readonly creationStackTrace?: string[];
+    readonly mutationStackTraces?: string[][];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/api/source-tracing/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJ0eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiXG4vKipcbiAqIEVub3VnaCBpbmZvcm1hdGlvbiB0byBsb2NhdGUgYSBjZXJ0YWluIENsb3VkRm9ybWF0aW9uIHJlc291cmNlIGluIGEgQ0RLIGFwcFxuICovXG5leHBvcnQgaW50ZXJmYWNlIFNvdXJjZVRyYWNlIHtcbiAgcmVhZG9ubHkgY29uc3RydWN0UGF0aDogc3RyaW5nO1xuICByZWFkb25seSBjcmVhdGlvblN0YWNrVHJhY2U/OiBzdHJpbmdbXTtcbiAgcmVhZG9ubHkgbXV0YXRpb25TdGFja1RyYWNlcz86IHN0cmluZ1tdW107XG59XG4iXX0=

package/lib/api/stack-events/resource-errors.d.ts

@@ -0,0 +1,82 @@
+import type { StackEvent } from '@aws-sdk/client-cloudformation';
+import type { ResourceEvent } from './stack-event-poller';
+export interface ResourceError {
+    /**
+     * The stack this resource error occurred in
+     *
+     * NOTE: This will be a stack ID (which is a full ARN including the unique identifier),
+     * not just a name.
+     */
+    readonly stackArn: string;
+    /**
+     * IDs of parent stacks of the resource, in case of resources in nested stacks
+     */
+    readonly parentStackLogicalIds: string[];
+    /**
+     * Logical ID of the resource
+     *
+     * (May be absent in case this message is about the stack itself)
+     */
+    readonly logicalId?: string;
+    /**
+     * Resource type
+     */
+    readonly resourceType?: string;
+    /**
+     * Physical ID of the resource
+     */
+    readonly physicalId?: string;
+    /**
+     * Error message of the resource
+     */
+    readonly message: string;
+    /**
+     * Error code of the resource
+     */
+    readonly errorCode?: string;
+}
+/**
+ * Class used to send stack event errors into, to come up with root causes.
+ */
+export declare class ResourceErrors {
+    /**
+     * A list of all non-cancellation errors we have seen.
+     *
+     * By the nature of the order we see events in, will be ordered from oldest to newest.
+     */
+    private readonly _errors;
+    isEmpty(): boolean;
+    get all(): ReadonlyArray<ResourceError>;
+    /**
+     * Update the error collection with the given stack activity
+     *
+     * May be from a nested stack as well.
+     *
+     * This class expects to see all events in chronological order.
+     */
+    update(...events: ResourceEvent[]): void;
+    /**
+     * Take our best guess at the error code of the root cause
+     *
+     * The first error that occurs is the root cause.
+     */
+    get rootCauseErrorCode(): string | undefined;
+    /**
+     * Return error messages of all encountered errors (that aren't cancellations)
+     */
+    get allErrorMessages(): string[];
+    /**
+     * Return error codeds of all encountered errors (that aren't cancellations nor stack errors)
+     *
+     * We don't need to include nested stack errors because our poller will poll the nested stack,
+     * and have returned the actual error as well.
+     */
+    get allErrorCodes(): string[];
+}
+/**
+ * Extract an error code from the given stack event.
+ *
+ * Always contains the services, and includes the handler error code if available.
+ */
+export declare function extractErrorCode(event: StackEvent): string;
+//# sourceMappingURL=resource-errors.d.ts.map

package/lib/api/stack-events/resource-errors.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceErrors = void 0;
+exports.extractErrorCode = extractErrorCode;
+const toolkit_error_1 = require("../../toolkit/toolkit-error");
+const cloudformation_1 = require("../../util/cloudformation");
+/**
+ * Class used to send stack event errors into, to come up with root causes.
+ */
+class ResourceErrors {
+    /**
+     * A list of all non-cancellation errors we have seen.
+     *
+     * By the nature of the order we see events in, will be ordered from oldest to newest.
+     */
+    _errors = [];
+    isEmpty() {
+        return this._errors.length === 0;
+    }
+    get all() {
+        return this._errors;
+    }
+    /**
+     * Update the error collection with the given stack activity
+     *
+     * May be from a nested stack as well.
+     *
+     * This class expects to see all events in chronological order.
+     */
+    update(...events) {
+        for (const event of events) {
+            if ((0, cloudformation_1.isErrorEvent)(event.event)) {
+                // Cancelled is not an interesting failure reason, nor is the stack message (stack
+                // message will just say something like "stack failed to update")
+                if (!(0, cloudformation_1.isCancellationEvent)(event.event) && (0, cloudformation_1.isRegularResourceEvent)(event.event)) {
+                    this._errors.push(errorFromEvent(event));
+                }
+            }
+        }
+    }
+    /**
+     * Take our best guess at the error code of the root cause
+     *
+     * The first error that occurs is the root cause.
+     */
+    get rootCauseErrorCode() {
+        return this.allErrorCodes[0];
+    }
+    /**
+     * Return error messages of all encountered errors (that aren't cancellations)
+     */
+    get allErrorMessages() {
+        return this._errors.map(e => e.message);
+    }
+    /**
+     * Return error codeds of all encountered errors (that aren't cancellations nor stack errors)
+     *
+     * We don't need to include nested stack errors because our poller will poll the nested stack,
+     * and have returned the actual error as well.
+     */
+    get allErrorCodes() {
+        return this._errors.map(e => e.errorCode).filter(x => typeof x === 'string');
+    }
+}
+exports.ResourceErrors = ResourceErrors;
+function errorFromEvent(ev) {
+    // FIXME: Check hooks
+    return {
+        logicalId: ev.event.LogicalResourceId ?? '',
+        message: ev.event.ResourceStatusReason ?? '',
+        parentStackLogicalIds: ev.parentStackLogicalIds,
+        resourceType: ev.event.ResourceType ?? '',
+        stackArn: ev.event.StackId ?? '',
+        errorCode: extractErrorCode(ev.event),
+        physicalId: ev.event.PhysicalResourceId,
+    };
+}
+/**
+ * Extract an error code from the given stack event.
+ *
+ * Always contains the services, and includes the handler error code if available.
+ */
+function extractErrorCode(event) {
+    const isOurCustomResource = OUR_CUSTOM_RESOURCE_TYPES.includes(event.ResourceType ?? '');
+    // Get the resource type; if it is non-AWS then we are done.
+    const resourceTypeParts = (event.ResourceType ?? '').split('::');
+    if (resourceTypeParts[0] !== 'AWS' && !isOurCustomResource) {
+        return toolkit_error_1.DeploymentErrorCodes.PRIVATE_RESOURCE_ERROR;
+    }
+    const resourceType = isOurCustomResource ? resourceTypeParts.join('') : resourceTypeParts.slice(1).join('');
+    const reason = event.ResourceStatusReason ?? '';
+    const errorRe = /(?:HandlerErrorCode:|Error Code:) ([a-zA-Z0-9:-]+)/;
+    const handlerCode = reason.match(errorRe);
+    return `${resourceType}:${handlerCode ? handlerCode[1] : toolkit_error_1.DeploymentErrorCodes.UNKNOWN_ERROR}`;
+}
+// Some custom resource types that the CDK standard library creates that we
+// would like to see it if they fail.
+const OUR_CUSTOM_RESOURCE_TYPES = [
+    'Custom::AWS',
+    'Custom::AWSCDK-EKS-Cluster',
+    'Custom::AWSCDK-EKS-FargateProfile',
+    'Custom::AWSCDK-EKS-HelmChart',
+    'Custom::AWSCDK-EKS-KubernetesObjectValue',
+    'Custom::AWSCDK-EKS-KubernetesPatch',
+    'Custom::AWSCDK-EKS-KubernetesResource',
+    'Custom::AWSCDKCfnJson',
+    'Custom::AWSCDKCfnJsonStringify',
+    'Custom::AWSCDKOpenIdConnectProvider',
+    'Custom::CDKBucketDeployment',
+    'Custom::CloudwatchLogResourcePolicy',
+    'Custom::CrossAccountZoneDelegation',
+    'Custom::CrossRegionExportReader',
+    'Custom::CrossRegionExportWriter',
+    'Custom::CrossRegionStringParameterReader',
+    'Custom::DeleteExistingRecordSet',
+    'Custom::DescribeCognitoUserPoolClient',
+    'Custom::DynamoDBReplica',
+    'Custom::ECRAutoDeleteImages',
+    'Custom::ElasticsearchAccessPolicy',
+    'Custom::LogRetention',
+    'Custom::OpenSearchAccessPolicy',
+    'Custom::S3AutoDeleteObjects',
+    'Custom::S3BucketNotifications',
+    'Custom::SyntheticsAutoDeleteUnderlyingResources',
+    'Custom::Trigger',
+    'Custom::UserPoolCloudFrontDomainName',
+    'Custom::VpcRestrictDefaultSG',
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb3VyY2UtZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsicmVzb3VyY2UtZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQW1JQSw0Q0FpQkM7QUFsSkQsK0RBQW1FO0FBQ25FLDhEQUFzRztBQTRDdEc7O0dBRUc7QUFDSCxNQUFhLGNBQWM7SUFDekI7Ozs7T0FJRztJQUNjLE9BQU8sR0FBb0IsRUFBRSxDQUFDO0lBRXhDLE9BQU87UUFDWixPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxLQUFLLENBQUMsQ0FBQztJQUNuQyxDQUFDO0lBRUQsSUFBVyxHQUFHO1FBQ1osT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDO0lBQ3RCLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxNQUFNLENBQUMsR0FBRyxNQUF1QjtRQUN0QyxLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1lBQzNCLElBQUksSUFBQSw2QkFBWSxFQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO2dCQUM5QixrRkFBa0Y7Z0JBQ2xGLGlFQUFpRTtnQkFDakUsSUFBSSxDQUFDLElBQUEsb0NBQW1CLEVBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxJQUFJLElBQUEsdUNBQXNCLEVBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7b0JBQzdFLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLGNBQWMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO2dCQUMzQyxDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILElBQVcsa0JBQWtCO1FBQzNCLE9BQU8sSUFBSSxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUMvQixDQUFDO0lBRUQ7O09BRUc7SUFDSCxJQUFXLGdCQUFnQjtRQUN6QixPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxF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SUFDakIsc0NBQXNDO0lBQ3RDLDhCQUE4QjtDQUMvQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBTdGFja0V2ZW50IH0gZnJvbSAnQGF3cy1zZGsvY2xpZW50LWNsb3VkZm9ybWF0aW9uJztcbmltcG9ydCB0eXBlIHsgUmVzb3VyY2VFdmVudCB9IGZyb20gJy4vc3RhY2stZXZlbnQtcG9sbGVyJztcbmltcG9ydCB7IERlcGxveW1lbnRFcnJvckNvZGVzIH0gZnJvbSAnLi4vLi4vdG9vbGtpdC90b29sa2l0LWVycm9yJztcbmltcG9ydCB7IGlzQ2FuY2VsbGF0aW9uRXZlbnQsIGlzRXJyb3JFdmVudCwgaXNSZWd1bGFyUmVzb3VyY2VFdmVudCB9IGZyb20gJy4uLy4uL3V0aWwvY2xvdWRmb3JtYXRpb24nO1xuXG5leHBvcnQgaW50ZXJmYWNlIFJlc291cmNlRXJyb3Ige1xuICAvKipcbiAgICogVGhlIHN0YWNrIHRoaXMgcmVzb3VyY2UgZXJyb3Igb2NjdXJyZWQgaW5cbiAgICpcbiAgICogTk9URTogVGhpcyB3aWxsIGJlIGEgc3RhY2sgSUQgKHdoaWNoIGlzIGEgZnVsbCBBUk4gaW5jbHVkaW5nIHRoZSB1bmlxdWUgaWRlbnRpZmllciksXG4gICAqIG5vdCBqdXN0IGEgbmFtZS5cbiAgICovXG4gIHJlYWRvbmx5IHN0YWNrQXJuOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIElEcyBvZiBwYXJlbnQgc3RhY2tzIG9mIHRoZSByZXNvdXJjZSwgaW4gY2FzZSBvZiByZXNvdXJjZXMgaW4gbmVzdGVkIHN0YWNrc1xuICAgKi9cbiAgcmVhZG9ubHkgcGFyZW50U3RhY2tMb2dpY2FsSWRzOiBzdHJpbmdbXTtcblxuICAvKipcbiAgICogTG9naWNhbCBJRCBvZiB0aGUgcmVzb3VyY2VcbiAgICpcbiAgICogKE1heSBiZSBhYnNlbnQgaW4gY2FzZSB0aGlzIG1lc3NhZ2UgaXMgYWJvdXQgdGhlIHN0YWNrIGl0c2VsZilcbiAgICovXG4gIHJlYWRvbmx5IGxvZ2ljYWxJZD86IHN0cmluZztcblxuICAvKipcbiAgICogUmVzb3VyY2UgdHlwZVxuICAgKi9cbiAgcmVhZG9ubHkgcmVzb3VyY2VUeXBlPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBQaHlzaWNhbCBJRCBvZiB0aGUgcmVzb3VyY2VcbiAgICovXG4gIHJlYWRvbmx5IHBoeXNpY2FsSWQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEVycm9yIG1lc3NhZ2Ugb2YgdGhlIHJlc291cmNlXG4gICAqL1xuICByZWFkb25seSBtZXNzYWdlOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEVycm9yIGNvZGUgb2YgdGhlIHJlc291cmNlXG4gICAqL1xuICByZWFkb25seSBlcnJvckNvZGU/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogQ2xhc3MgdXNlZCB0byBzZW5kIHN0YWNrIGV2ZW50IGVycm9ycyBpbnRvLCB0byBjb21lIHVwIHdpdGggcm9vdCBjYXVzZXMuXG4gKi9cbmV4cG9ydCBjbGFzcyBSZXNvdXJjZUVycm9ycyB7XG4gIC8qKlxuICAgKiBBIGxpc3Qgb2YgYWxsIG5vbi1jYW5jZWxsYXRpb24gZXJyb3JzIHdlIGhhdmUgc2Vlbi5cbiAgICpcbiAgICogQnkgdGhlIG5hdHVyZSBvZiB0aGUgb3JkZXIgd2Ugc2VlIGV2ZW50cyBpbiwgd2lsbCBiZSBvcmRlcmVkIGZyb20gb2xkZXN0IHRvIG5ld2VzdC5cbiAgICovXG4gIHByaXZhdGUgcmVhZG9ubHkgX2Vycm9yczogUmVzb3VyY2VFcnJvcltdID0gW107XG5cbiAgcHVibGljIGlzRW1wdHkoKSB7XG4gICAgcmV0dXJuIHRoaXMuX2Vycm9ycy5sZW5ndGggPT09IDA7XG4gIH1cblxuICBwdWJsaWMgZ2V0IGFsbCgpOiBSZWFkb25seUFycmF5PFJlc291cmNlRXJyb3I+IHtcbiAgICByZXR1cm4gdGhpcy5fZXJyb3JzO1xuICB9XG5cbiAgLyoqXG4gICAqIFVwZGF0ZSB0aGUgZXJyb3IgY29sbGVjdGlvbiB3aXRoIHRoZSBnaXZlbiBzdGFjayBhY3Rpdml0eVxuICAgKlxuICAgKiBNYXkgYmUgZnJvbSBhIG5lc3RlZCBzdGFjayBhcyB3ZWxsLlxuICAgKlxuICAgKiBUaGlzIGNsYXNzIGV4cGVjdHMgdG8gc2VlIGFsbCBldmVudHMgaW4gY2hyb25vbG9naWNhbCBvcmRlci5cbiAgICovXG4gIHB1YmxpYyB1cGRhdGUoLi4uZXZlbnRzOiBSZXNvdXJjZUV2ZW50W10pIHtcbiAgICBmb3IgKGNvbnN0IGV2ZW50IG9mIGV2ZW50cykge1xuICAgICAgaWYgKGlzRXJyb3JFdmVudChldmVudC5ldmVudCkpIHtcbiAgICAgICAgLy8gQ2FuY2VsbGVkIGlzIG5vdCBhbiBpbnRlcmVzdGluZyBmYWlsdXJlIHJlYXNvbiwgbm9yIGlzIHRoZSBzdGFjayBtZXNzYWdlIChzdGFja1xuICAgICAgICAvLyBtZXNzYWdlIHdpbGwganVzdCBzYXkgc29tZXRoaW5nIGxpa2UgXCJzdGFjayBmYWlsZWQgdG8gdXBkYXRlXCIpXG4gICAgICAgIGlmICghaXNDYW5jZWxsYXRpb25FdmVudChldmVudC5ldmVudCkgJiYgaXNSZWd1bGFyUmVzb3VyY2VFdmVudChldmVudC5ldmVudCkpIHtcbiAgICAgICAgICB0aGlzLl9lcnJvcnMucHVzaChlcnJvckZyb21FdmVudChldmVudCkpO1xuICAgICAgICB9XG4gICAgICB9XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFRha2Ugb3VyIGJlc3QgZ3Vlc3MgYXQgdGhlIGVycm9yIGNvZGUgb2YgdGhlIHJvb3QgY2F1c2VcbiAgICpcbiAgICogVGhlIGZpcnN0IGVycm9yIHRoYXQgb2NjdXJzIGlzIHRoZSByb290IGNhdXNlLlxuICAgKi9cbiAgcHVibGljIGdldCByb290Q2F1c2VFcnJvckNvZGUoKTogc3RyaW5nIHwgdW5kZWZpbmVkIHtcbiAgICByZXR1cm4gdGhpcy5hbGxFcnJvckNvZGVzWzBdO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHVybiBlcnJvciBtZXNzYWdlcyBvZiBhbGwgZW5jb3VudGVyZWQgZXJyb3JzICh0aGF0IGFyZW4ndCBjYW5jZWxsYXRpb25zKVxuICAgKi9cbiAgcHVibGljIGdldCBhbGxFcnJvck1lc3NhZ2VzKCk6IHN0cmluZ1tdIHtcbiAgICByZXR1cm4gdGhpcy5fZXJyb3JzLm1hcChlID0+IGUubWVzc2FnZSk7XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJuIGVycm9yIGNvZGVkcyBvZiBhbGwgZW5jb3VudGVyZWQgZXJyb3JzICh0aGF0IGFyZW4ndCBjYW5jZWxsYXRpb25zIG5vciBzdGFjayBlcnJvcnMpXG4gICAqXG4gICAqIFdlIGRvbid0IG5lZWQgdG8gaW5jbHVkZSBuZXN0ZWQgc3RhY2sgZXJyb3JzIGJlY2F1c2Ugb3VyIHBvbGxlciB3aWxsIHBvbGwgdGhlIG5lc3RlZCBzdGFjayxcbiAgICogYW5kIGhhdmUgcmV0dXJuZWQgdGhlIGFjdHVhbCBlcnJvciBhcyB3ZWxsLlxuICAgKi9cbiAgcHVibGljIGdldCBhbGxFcnJvckNvZGVzKCk6IHN0cmluZ1tdIHtcbiAgICByZXR1cm4gdGhpcy5fZXJyb3JzLm1hcChlID0+IGUuZXJyb3JDb2RlKS5maWx0ZXIoeCA9PiB0eXBlb2YgeCA9PT0gJ3N0cmluZycpO1xuICB9XG59XG5cbmZ1bmN0aW9uIGVycm9yRnJvbUV2ZW50KGV2OiBSZXNvdXJjZUV2ZW50KTogUmVzb3VyY2VFcnJvciB7XG4gIC8vIEZJWE1FOiBDaGVjayBob29rc1xuXG4gIHJldHVybiB7XG4gICAgbG9naWNhbElkOiBldi5ldmVudC5Mb2dpY2FsUmVzb3VyY2VJZCA/PyAnJyxcbiAgICBtZXNzYWdlOiBldi5ldmVudC5SZXNvdXJjZVN0YXR1c1JlYXNvbiA/PyAnJyxcbiAgICBwYXJlbnRTdGFja0xvZ2ljYWxJZHM6IGV2LnBhcmVudFN0YWNrTG9naWNhbElkcyxcbiAgICByZXNvdXJjZVR5cGU6IGV2LmV2ZW50LlJlc291cmNlVHlwZSA/PyAnJyxcbiAgICBzdGFja0FybjogZXYuZXZlbnQuU3RhY2tJZCA/PyAnJyxcbiAgICBlcnJvckNvZGU6IGV4dHJhY3RFcnJvckNvZGUoZXYuZXZlbnQpLFxuICAgIHBoeXNpY2FsSWQ6IGV2LmV2ZW50LlBoeXNpY2FsUmVzb3VyY2VJZCxcbiAgfTtcbn1cblxuLyoqXG4gKiBFeHRyYWN0IGFuIGVycm9yIGNvZGUgZnJvbSB0aGUgZ2l2ZW4gc3RhY2sgZXZlbnQuXG4gKlxuICogQWx3YXlzIGNvbnRhaW5zIHRoZSBzZXJ2aWNlcywgYW5kIGluY2x1ZGVzIHRoZSBoYW5kbGVyIGVycm9yIGNvZGUgaWYgYXZhaWxhYmxlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZXh0cmFjdEVycm9yQ29kZShldmVudDogU3RhY2tFdmVudCk6IHN0cmluZyB7XG4gIGNvbnN0IGlzT3VyQ3VzdG9tUmVzb3VyY2UgPSBPVVJfQ1VTVE9NX1JFU09VUkNFX1RZUEVTLmluY2x1ZGVzKGV2ZW50LlJlc291cmNlVHlwZSA/PyAnJyk7XG5cbiAgLy8gR2V0IHRoZSByZXNvdXJjZSB0eXBlOyBpZiBpdCBpcyBub24tQVdTIHRoZW4gd2UgYXJlIGRvbmUuXG4gIGNvbnN0IHJlc291cmNlVHlwZVBhcnRzID0gKGV2ZW50LlJlc291cmNlVHlwZSA/PyAnJykuc3BsaXQoJzo6Jyk7XG4gIGlmIChyZXNvdXJjZVR5cGVQYXJ0c1swXSAhPT0gJ0FXUycgJiYgIWlzT3VyQ3VzdG9tUmVzb3VyY2UpIHtcbiAgICByZXR1cm4gRGVwbG95bWVudEVycm9yQ29kZXMuUFJJVkFURV9SRVNPVVJDRV9FUlJPUjtcbiAgfVxuXG4gIGNvbnN0IHJlc291cmNlVHlwZSA9IGlzT3VyQ3VzdG9tUmVzb3VyY2UgPyByZXNvdXJjZVR5cGVQYXJ0cy5qb2luKCcnKSA6IHJlc291cmNlVHlwZVBhcnRzLnNsaWNlKDEpLmpvaW4oJycpO1xuXG4gIGNvbnN0IHJlYXNvbiA9IGV2ZW50LlJlc291cmNlU3RhdHVzUmVhc29uID8/ICcnO1xuXG4gIGNvbnN0IGVycm9yUmUgPSAvKD86SGFuZGxlckVycm9yQ29kZTp8RXJyb3IgQ29kZTopIChbYS16QS1aMC05Oi1dKykvO1xuICBjb25zdCBoYW5kbGVyQ29kZSA9IHJlYXNvbi5tYXRjaChlcnJvclJlKTtcblxuICByZXR1cm4gYCR7cmVzb3VyY2VUeXBlfToke2hhbmRsZXJDb2RlID8gaGFuZGxlckNvZGVbMV0gOiBEZXBsb3ltZW50RXJyb3JDb2Rlcy5VTktOT1dOX0VSUk9SfWA7XG59XG5cbi8vIFNvbWUgY3VzdG9tIHJlc291cmNlIHR5cGVzIHRoYXQgdGhlIENESyBzdGFuZGFyZCBsaWJyYXJ5IGNyZWF0ZXMgdGhhdCB3ZVxuLy8gd291bGQgbGlrZSB0byBzZWUgaXQgaWYgdGhleSBmYWlsLlxuY29uc3QgT1VSX0NVU1RPTV9SRVNPVVJDRV9UWVBFUyA9IFtcbiAgJ0N1c3RvbTo6QVdTJyxcbiAgJ0N1c3RvbTo6QVdTQ0RLLUVLUy1DbHVzdGVyJyxcbiAgJ0N1c3RvbTo6QVdTQ0RLLUVLUy1GYXJnYXRlUHJvZmlsZScsXG4gICdDdXN0b206OkFXU0NESy1FS1MtSGVsbUNoYXJ0JyxcbiAgJ0N1c3RvbTo6QVdTQ0RLLUVLUy1LdWJlcm5ldGVzT2JqZWN0VmFsdWUnLFxuICAnQ3VzdG9tOjpBV1NDREstRUtTLUt1YmVybmV0ZXNQYXRjaCcsXG4gICdDdXN0b206OkFXU0NESy1FS1MtS3ViZXJuZXRlc1Jlc291cmNlJyxcbiAgJ0N1c3RvbTo6QVdTQ0RLQ2ZuSnNvbicsXG4gICdDdXN0b206OkFXU0NES0Nmbkpzb25TdHJpbmdpZnknLFxuICAnQ3VzdG9tOjpBV1NDREtPcGVuSWRDb25uZWN0UHJvdmlkZXInLFxuICAnQ3VzdG9tOjpDREtCdWNrZXREZXBsb3ltZW50JyxcbiAgJ0N1c3RvbTo6Q2xvdWR3YXRjaExvZ1Jlc291cmNlUG9saWN5JyxcbiAgJ0N1c3RvbTo6Q3Jvc3NBY2NvdW50Wm9uZURlbGVnYXRpb24nLFxuICAnQ3VzdG9tOjpDcm9zc1JlZ2lvbkV4cG9ydFJlYWRlcicsXG4gICdDdXN0b206OkNyb3NzUmVnaW9uRXhwb3J0V3JpdGVyJyxcbiAgJ0N1c3RvbTo6Q3Jvc3NSZWdpb25TdHJpbmdQYXJhbWV0ZXJSZWFkZXInLFxuICAnQ3VzdG9tOjpEZWxldGVFeGlzdGluZ1JlY29yZFNldCcsXG4gICdDdXN0b206OkRlc2NyaWJlQ29nbml0b1VzZXJQb29sQ2xpZW50JyxcbiAgJ0N1c3RvbTo6RHluYW1vREJSZXBsaWNhJyxcbiAgJ0N1c3RvbTo6RUNSQXV0b0RlbGV0ZUltYWdlcycsXG4gICdDdXN0b206OkVsYXN0aWNzZWFyY2hBY2Nlc3NQb2xpY3knLFxuICAnQ3VzdG9tOjpMb2dSZXRlbnRpb24nLFxuICAnQ3VzdG9tOjpPcGVuU2VhcmNoQWNjZXNzUG9saWN5JyxcbiAgJ0N1c3RvbTo6UzNBdXRvRGVsZXRlT2JqZWN0cycsXG4gICdDdXN0b206OlMzQnVja2V0Tm90aWZpY2F0aW9ucycsXG4gICdDdXN0b206OlN5bnRoZXRpY3NBdXRvRGVsZXRlVW5kZXJseWluZ1Jlc291cmNlcycsXG4gICdDdXN0b206OlRyaWdnZXInLFxuICAnQ3VzdG9tOjpVc2VyUG9vbENsb3VkRnJvbnREb21haW5OYW1lJyxcbiAgJ0N1c3RvbTo6VnBjUmVzdHJpY3REZWZhdWx0U0cnLFxuXTtcbiJdfQ==

package/lib/api/stack-events/stack-activity-monitor.d.ts

@@ -1,5 +1,4 @@
 import type { CloudFormationStackArtifact } from '@aws-cdk/cloud-assembly-api';
-import type { StackEvent } from '@aws-sdk/client-cloudformation';
 import type { ICloudFormationClient } from '../aws-auth/private';
 import type { EnvironmentResources } from '../environment';
 import { type IoHelper } from '../io/private';
@@ -76,12 +75,6 @@ export declare class StackActivityMonitor {
      * Printers can decide to update a view less frequently if desired
      */
     private readonly pollingInterval;
-    /**
-     * A list of all non-cancellation errors we have seen.
-     *
-     * By the nature of the order we see events in, will be ordered from oldest to newest.
-     */
-    private readonly _errors;
     private monitorId?;
     private readonly progressMonitor;
     /**
@@ -99,22 +92,9 @@ export declare class StackActivityMonitor {
     private readonly envResources?;
     constructor({ cfn, ioHelper, stack, stackName, resourcesTotal, changeSetCreationTime, pollingInterval, envResources, }: StackActivityMonitorProps);
     /**
-     * Return error messages of all encountered errors (that aren't cancellations)
-     */
-    get allErrorMessages(): string[];
-    /**
-     * Return error codeds of all encountered errors (that aren't cancellations nor stack errors)
-     *
-     * We don't need to include nested stack errors because our poller will poll the nested stack,
-     * and have returned the actual error as well.
-     */
-    get allErrorCodes(): string[];
-    /**
-     * Take our best guess at the error code of the root cause
-     *
-     * The first error that occurs is the root cause.
+     * The resource errors that were discovered during monitoring of this stack
      */
-    get rootCauseErrorCode(): string | undefined;
+    get errors(): import("./resource-errors").ResourceErrors;
     start(): Promise<this>;
     stop(): Promise<void>;
     private scheduleNextTick;
@@ -149,12 +129,5 @@ export declare class StackActivityMonitor {
      * Formats a stack activity into a basic string
      */
     private formatActivity;
-    private checkForErrors;
 }
-/**
- * Extract an error code from the given stack event.
- *
- * Always contains the services, and includes the handler error code if available.
- */
-export declare function extractErrorCode(event: StackEvent): string;
 //# sourceMappingURL=stack-activity-monitor.d.ts.map