@aws-cdk/cloud-assembly-api 2.4.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,191 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.loadUnifiedValidationReport = loadUnifiedValidationReport;
37
+ const fs_1 = require("fs");
38
+ const path = __importStar(require("path"));
39
+ const cloud_assembly_schema_1 = require("@aws-cdk/cloud-assembly-schema");
40
+ const metadata_1 = require("../metadata");
41
+ const parsing_1 = require("./parsing");
42
+ const stack_trace_1 = require("../stack-trace");
43
+ const VALIDATION_REPORT_FILE = 'validation-report.json';
44
+ /**
45
+ * Return a validation report that contains the validation report that the CDK app has written, as well as any Construct Metadata annotations in the manifest.
46
+ *
47
+ * This function takes into account the CDK app can already have written the
48
+ * construct annotations into the validation report, or not, depending on the
49
+ * setting of a deprecated feature flag. If the annotations are already in the report,
50
+ * they are not copied.
51
+ *
52
+ * Afterwards, the list of violations is filtered to only include those that are relevant to the stacks selected for validation.
53
+ *
54
+ * Returns whether an explicit report file was found or not.
55
+ */
56
+ async function loadUnifiedValidationReport(assembly, stacks) {
57
+ const ret = [];
58
+ const reportPath = path.join(assembly.directory, VALIDATION_REPORT_FILE);
59
+ if (await pathExists(reportPath)) {
60
+ const selectedStackIds = new Set(stacks.map(stack => stack.hierarchicalId));
61
+ const report = cloud_assembly_schema_1.Manifest.loadValidationReport(reportPath);
62
+ // Filter the report to only include violations for the selected stacks
63
+ const filteredReports = filterReportsByStacks(report.pluginReports, selectedStackIds);
64
+ ret.push(...filteredReports);
65
+ }
66
+ const alreadyHasAnnotations = ret.some((r) => r.pluginName === parsing_1.ANNOTATION_PLUGIN_NAME);
67
+ if (!alreadyHasAnnotations) {
68
+ const annotationReport = pluginReportFromAnnotations(stacks);
69
+ if (annotationReport.violations.length > 0 || annotationReport.conclusion === 'failure') {
70
+ ret.push(annotationReport);
71
+ }
72
+ }
73
+ // Remove all inconsequential reports
74
+ return ret;
75
+ }
76
+ /**
77
+ * Report only violations that are in one of the given stacks
78
+ */
79
+ function filterReportsByStacks(reports, selectedStackIds) {
80
+ const stackIds = Array.from(selectedStackIds);
81
+ return reports.map(filterReport);
82
+ function filterReport(report) {
83
+ // Filter the violations of this report down. In order to be backwards compatible with previously established behavior,
84
+ // if a violation has no constructs associated with it, we retain it. Otherwise, we remove it if it has no constructs left.
85
+ const violationsWithoutConstructs = new Set(report.violations.flatMap((v, i) => v.violatingConstructs.length === 0 ? [i] : []));
86
+ const filteredViolations = report
87
+ .violations.map(v => ({
88
+ ...v,
89
+ violatingConstructs: v.violatingConstructs.filter(constructMatches),
90
+ })).filter((v, i) => v.violatingConstructs.length > 0 || violationsWithoutConstructs.has(i));
91
+ return {
92
+ ...report,
93
+ violations: filteredViolations,
94
+ conclusion: filteredViolations.length > 0 ? report.conclusion : 'success',
95
+ };
96
+ }
97
+ function constructMatches(c) {
98
+ // If we don't have a construct path, we can't filter out this violation so we have to keep it.
99
+ return !c.constructPath || stackIds.some((stackId) => c.constructPath === stackId || c.constructPath?.startsWith(`${stackId}/`));
100
+ }
101
+ }
102
+ /**
103
+ * Collect annotation metadata (warnings and errors) from the construct tree
104
+ * and convert them into a NamedValidationPluginReport that can be merged
105
+ * into the same report pipeline as plugin violations.
106
+ *
107
+ * Effectively the same as what happens here:
108
+ * <https://github.com/aws/aws-cdk/blob/main/packages/aws-cdk-lib/core/lib/private/collect-annotation-report.ts>
109
+ */
110
+ function pluginReportFromAnnotations(stacks) {
111
+ // The return type requires that we combine violations by rule, so we have to group them first here.
112
+ const ruleMap = new Map();
113
+ for (const stack of stacks) {
114
+ for (const entry of stack.messages) {
115
+ let severity;
116
+ switch (entry.level) {
117
+ case metadata_1.SynthesisMessageLevel.WARNING:
118
+ severity = 'warning';
119
+ break;
120
+ case metadata_1.SynthesisMessageLevel.ERROR:
121
+ severity = 'error';
122
+ break;
123
+ case metadata_1.SynthesisMessageLevel.INFO:
124
+ severity = 'info';
125
+ break;
126
+ }
127
+ const { message, ruleName } = splitDescriptionAndId(String(entry.entry.data));
128
+ const ruleKey = `${ruleName}|${severity}|${message}`;
129
+ let violation = ruleMap.get(ruleKey);
130
+ if (!violation) {
131
+ violation = {
132
+ ruleName: ruleName ?? `${severity}-annotation`,
133
+ description: message,
134
+ severity,
135
+ violatingConstructs: [],
136
+ ruleMetadata: {
137
+ 'cdk:annotation': 'true',
138
+ },
139
+ };
140
+ ruleMap.set(ruleKey, violation);
141
+ }
142
+ violation.violatingConstructs.push({
143
+ constructPath: entry.id.replace(/^\//, ''), // remove leading slash
144
+ // If we get this stack trace here, it was recorded by the `constructs` library,
145
+ // which means it hasn't been JustMyCode-stripped yet.
146
+ stackTraces: entry.entry.trace ? [
147
+ new stack_trace_1.StackTrace(entry.entry.trace).renderJustMyCode().join('\n'),
148
+ ] : [],
149
+ });
150
+ }
151
+ }
152
+ const violations = Array.from(ruleMap.values());
153
+ const hasErrors = violations.some(v => v.severity === 'error');
154
+ return {
155
+ pluginName: parsing_1.ANNOTATION_PLUGIN_NAME,
156
+ conclusion: hasErrors ? 'failure' : 'success',
157
+ violations,
158
+ };
159
+ }
160
+ /**
161
+ * Annotations have IDs in two places:
162
+ *
163
+ * - Warnings have `[ack:<id>]` in the message.
164
+ * - Errors have `(<namespace>::<id>)` in the message.
165
+ *
166
+ * Separate the rule name from the rest of the description.
167
+ */
168
+ function splitDescriptionAndId(message) {
169
+ const ackMatch = message.match(/\[ack: ([^\]]+)\]/);
170
+ if (ackMatch) {
171
+ return { message: message.replace(ackMatch[0], '').trim(), ruleName: ackMatch[1] };
172
+ }
173
+ const idMatch = message.match(/\(([^()]+::[^()]+)\)$/);
174
+ if (idMatch) {
175
+ return { message: message.replace(idMatch[0], '').trim(), ruleName: idMatch[1] };
176
+ }
177
+ return { message };
178
+ }
179
+ async function pathExists(pathName) {
180
+ try {
181
+ await fs_1.promises.access(pathName);
182
+ return true;
183
+ }
184
+ catch (e) {
185
+ if (e.code !== 'ENOENT') {
186
+ throw e;
187
+ }
188
+ return false;
189
+ }
190
+ }
191
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZGluZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImxvYWRpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUEyQkEsa0VBMEJDO0FBckRELDJCQUFvQztBQUNwQywyQ0FBNkI7QUFDN0IsMEVBQTBEO0FBRzFELDBDQUFvRDtBQUNwRCx1Q0FBbUQ7QUFDbkQsZ0RBQTRDO0FBRTVDLE1BQU0sc0JBQXNCLEdBQUcsd0JBQXdCLENBQUM7QUFNeEQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSSxLQUFLLFVBQVUsMkJBQTJCLENBQy9DLFFBQXNCLEVBQ3RCLE1BQXFDO0lBRXJDLE1BQU0sR0FBRyxHQUFnQyxFQUFFLENBQUM7SUFFNUMsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsU0FBUyxFQUFFLHNCQUFzQixDQUFDLENBQUM7SUFDekUsSUFBSSxNQUFNLFVBQVUsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO1FBQ2pDLE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxHQUFHLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDO1FBQzVFLE1BQU0sTUFBTSxHQUFHLGdDQUFRLENBQUMsb0JBQW9CLENBQUMsVUFBVSxDQUFDLENBQUM7UUFFekQsdUVBQXVFO1FBQ3ZFLE1BQU0sZUFBZSxHQUFHLHFCQUFxQixDQUFDLE1BQU0sQ0FBQyxhQUFhLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQztRQUN0RixHQUFHLENBQUMsSUFBSSxDQUFDLEdBQUcsZUFBZSxDQUFDLENBQUM7SUFDL0IsQ0FBQztJQUVELE1BQU0scUJBQXFCLEdBQUcsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLFVBQVUsS0FBSyxnQ0FBc0IsQ0FBQyxDQUFDO0lBQ3ZGLElB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LE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUMxQixPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFBQyxPQUFPLENBQU0sRUFBRSxDQUFDO1FBQ2hCLElBQUksQ0FBQyxDQUFDLElBQUksS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUN4QixNQUFNLENBQUMsQ0FBQztRQUNWLENBQUM7UUFDRCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgcHJvbWlzZXMgYXMgZnMgfSBmcm9tICdmcyc7XG5pbXBvcnQgKiBhcyBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0IHsgTWFuaWZlc3QgfSBmcm9tICdAYXdzLWNkay9jbG91ZC1hc3NlbWJseS1zY2hlbWEnO1xuaW1wb3J0IHR5cGUgKiBhcyBjeHNjaGVtYSBmcm9tICdAYXdzLWNkay9jbG91ZC1hc3NlbWJseS1zY2hlbWEnO1xuaW1wb3J0IHR5cGUgeyBDbG91ZEZvcm1hdGlvblN0YWNrQXJ0aWZhY3QgfSBmcm9tICcuLi9hcnRpZmFjdHMvY2xvdWRmb3JtYXRpb24tYXJ0aWZhY3QnO1xuaW1wb3J0IHsgU3ludGhlc2lzTWVzc2FnZUxldmVsIH0gZnJvbSAnLi4vbWV0YWRhdGEnO1xuaW1wb3J0IHsgQU5OT1RBVElPTl9QTFVHSU5fTkFNRSB9IGZyb20gJy4vcGFyc2luZyc7XG5pbXBvcnQgeyBTdGFja1RyYWNlIH0gZnJvbSAnLi4vc3RhY2stdHJhY2UnO1xuXG5jb25zdCBWQUxJREFUSU9OX1JFUE9SVF9GSUxFID0gJ3ZhbGlkYXRpb24tcmVwb3J0Lmpzb24nO1xuXG5pbnRlcmZhY2UgQXNzZW1ibHlMaWtlIHtcbiAgcmVhZG9ubHkgZGlyZWN0b3J5OiBzdHJpbmc7XG59XG5cbi8qKlxuICogUmV0dXJuIGEgdmFsaWRhdGlvbiByZXBvcnQgdGhhdCBjb250YWlucyB0aGUgdmFsaWRhdGlvbiByZXBvcnQgdGhhdCB0aGUgQ0RLIGFwcCBoYXMgd3JpdHRlbiwgYXMgd2VsbCBhcyBhbnkgQ29uc3RydWN0IE1ldGFkYXRhIGFubm90YXRpb25zIGluIHRoZSBtYW5pZmVzdC5cbiAqXG4gKiBUaGlzIGZ1bmN0aW9uIHRha2VzIGludG8gYWNjb3VudCB0aGUgQ0RLIGFwcCBjYW4gYWxyZWFkeSBoYXZlIHdyaXR0ZW4gdGhlXG4gKiBjb25zdHJ1Y3QgYW5ub3RhdGlvbnMgaW50byB0aGUgdmFsaWRhdGlvbiByZXBvcnQsIG9yIG5vdCwgZGVwZW5kaW5nIG9uIHRoZVxuICogc2V0dGluZyBvZiBhIGRlcHJlY2F0ZWQgZmVhdHVyZSBmbGFnLiBJZiB0aGUgYW5ub3RhdGlvbnMgYXJlIGFscmVhZHkgaW4gdGhlIHJlcG9ydCxcbiAqIHRoZXkgYXJlIG5vdCBjb3BpZWQuXG4gKlxuICogQWZ0ZXJ3YXJkcywgdGhlIGxpc3Qgb2YgdmlvbGF0aW9ucyBpcyBmaWx0ZXJlZCB0byBvbmx5IGluY2x1ZGUgdGhvc2UgdGhhdCBhcmUgcmVsZXZhbnQgdG8gdGhlIHN0YWNrcyBzZWxlY3RlZCBmb3IgdmFsaWRhdGlvbi5cbiAqXG4gKiBSZXR1cm5zIHdoZXRoZXIgYW4gZXhwbGljaXQgcmVwb3J0IGZpbGUgd2FzIGZvdW5kIG9yIG5vdC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGxvYWRVbmlmaWVkVmFsaWRhdGlvblJlcG9ydChcbiAgYXNzZW1ibHk6IEFzc2VtYmx5TGlrZSxcbiAgc3RhY2tzOiBDbG91ZEZvcm1hdGlvblN0YWNrQXJ0aWZhY3RbXSxcbik6IFByb21pc2U8Y3hzY2hlbWEuUGx1Z2luUmVwb3J0SnNvbltdPiB7XG4gIGNvbnN0IHJldDogY3hzY2hlbWEuUGx1Z2luUmVwb3J0SnNvbltdID0gW107XG5cbiAgY29uc3QgcmVwb3J0UGF0aCA9IHBhdGguam9pbihhc3NlbWJseS5kaXJlY3RvcnksIFZBTElEQVRJT05fUkVQT1JUX0ZJTEUpO1xuICBpZiAoYXdhaXQgcGF0aEV4aXN0cyhyZXBvcnRQYXRoKSkge1xuICAgIGNvbnN0IHNlbGVjdGVkU3RhY2tJZHMgPSBuZXcgU2V0KHN0YWNrcy5tYXAoc3RhY2sgPT4gc3RhY2suaGllcmFyY2hpY2FsSWQpKTtcbiAgICBjb25zdCByZXBvcnQgPSBNYW5pZmVzdC5sb2FkVmFsaWRhdGlvblJlcG9ydChyZXBvcnRQYXRoKTtcblxuICAgIC8vIEZpbHRlciB0aGUgcmVwb3J0IHRvIG9ubHkgaW5jbHVkZSB2aW9sYXRpb25zIGZvciB0aGUgc2VsZWN0ZWQgc3RhY2tzXG4gICAgY29uc3QgZmlsdGVyZWRSZXBvcnRzID0gZmlsdGVyUmVwb3J0c0J5U3RhY2tzKHJlcG9ydC5wbHVnaW5SZXBvcnRzLCBzZWxlY3RlZFN0YWNrSWRzKTtcbiAgICByZXQucHVzaCguLi5maWx0ZXJlZFJlcG9ydHMpO1xuICB9XG5cbiAgY29uc3QgYWxyZWFkeUhhc0Fubm90YXRpb25zID0gcmV0LnNvbWUoKHIpID0+IHIucGx1Z2luTmFtZSA9PT0gQU5OT1RBVElPTl9QTFVHSU5fTkFNRSk7XG4gIGlmICghYWxyZWFkeUhhc0Fubm90YXRpb25zKSB7XG4gICAgY29uc3QgYW5ub3RhdGlvblJlcG9ydCA9IHBsdWdpblJlcG9ydEZyb21Bbm5vdGF0aW9ucyhzdGFja3MpO1xuICAgIGlmIChhbm5vdGF0aW9uUmVwb3J0LnZpb2xhdGlvbnMubGVuZ3RoID4gMCB8fCBhbm5vdGF0aW9uUmVwb3J0LmNvbmNsdXNpb24gPT09ICdmYWlsdXJlJykge1xuICAgICAgcmV0LnB1c2goYW5ub3RhdGlvblJlcG9ydCk7XG4gICAgfVxuICB9XG5cbiAgLy8gUmVtb3ZlIGFsbCBpbmNvbnNlcXVlbnRpYWwgcmVwb3J0c1xuICByZXR1cm4gcmV0O1xufVxuXG4vKipcbiAqIFJlcG9ydCBvbmx5IHZpb2xhdGlvbnMgdGhhdCBhcmUgaW4gb25lIG9mIHRoZSBnaXZlbiBzdGFja3NcbiAqL1xuZnVuY3Rpb24gZmlsdGVyUmVwb3J0c0J5U3RhY2tzKHJlcG9ydHM6IGN4c2NoZW1hLlBsdWdpblJlcG9ydEpzb25bXSwgc2VsZWN0ZWRTdGFja0lkczogU2V0PHN0cmluZz4pOiBjeHNjaGVtYS5QbHVnaW5SZXBvcnRKc29uW10ge1xuICBjb25zdCBzdGFja0lkcyA9IEFycmF5LmZyb20oc2VsZWN0ZWRTdGFja0lkcyk7XG5cbiAgcmV0dXJuIHJlcG9ydHMubWFwKGZpbHRlclJlcG9ydCk7XG5cbiAgZnVuY3Rpb24gZmlsdGVyUmVwb3J0KHJlcG9ydDogY3hzY2hlbWEuUGx1Z2luUmVwb3J0SnNvbik6IGN4c2NoZW1hLlBsdWdpblJlcG9ydEpzb24ge1xuICAgIC8vIEZpbHRlciB0aGUgdmlvbGF0aW9ucyBvZiB0aGlzIHJlcG9ydCBkb3duLiBJbiBvcmRlciB0byBiZSBiYWNrd2FyZHMgY29tcGF0aWJsZSB3aXRoIHByZXZpb3VzbHkgZXN0YWJsaXNoZWQgYmVoYXZpb3IsXG4gICAgLy8gaWYgYSB2aW9sYXRpb24gaGFzIG5vIGNvbnN0cnVjdHMgYXNzb2NpYXRlZCB3aXRoIGl0LCB3ZSByZXRhaW4gaXQuIE90aGVyd2lzZSwgd2UgcmVtb3ZlIGl0IGlmIGl0IGhhcyBubyBjb25zdHJ1Y3RzIGxlZnQuXG4gICAgY29uc3QgdmlvbGF0aW9uc1dpdGhvdXRDb25zdHJ1Y3RzID0gbmV3IFNldChyZXBvcnQudmlvbGF0aW9ucy5mbGF0TWFwKCh2LCBpKSA9PiB2LnZpb2xhdGluZ0NvbnN0cnVjdHMubGVuZ3RoID09PSAwID8gW2ldIDogW10pKTtcblxuICAgIGNvbnN0IGZpbHRlcmVkVmlvbGF0aW9ucyA9IHJlcG9ydFxuICAgICAgLnZpb2xhdGlvbnMubWFwKHYgPT4gKHtcbiAgICAgICAgLi4udixcbiAgICAgICAgdmlvbGF0aW5nQ29uc3RydWN0czogdi52aW9sYXRpbmdDb25zdHJ1Y3RzLmZpbHRlcihjb25zdHJ1Y3RNYXRjaGVzKSxcbiAgICAgIH0pKS5maWx0ZXIoKHYsIGkpID0+IHYudmlvbGF0aW5nQ29uc3RydWN0cy5sZW5ndGggPiAwIHx8IHZpb2xhdGlvbnNXaXRob3V0Q29uc3RydWN0cy5oYXMoaSkpO1xuXG4gICAgcmV0dXJuIHtcbiAgICAgIC4uLnJlcG9ydCxcbiAgICAgIHZpb2xhdGlvbnM6IGZpbHRlcmVkVmlvbGF0aW9ucyxcbiAgICAgIGNvbmNsdXNpb246IGZpbHRlcmVkVmlvbGF0aW9ucy5sZW5ndGggPiAwID8gcmVwb3J0LmNvbmNsdXNpb24gOiAoJ3N1Y2Nlc3MnIGFzIGNvbnN0KSxcbiAgICB9O1xuICB9XG5cbiAgZnVuY3Rpb24gY29uc3RydWN0TWF0Y2hlcyhjOiBjeHNjaGVtYS5WaW9sYXRpbmdDb25zdHJ1Y3RKc29uKSB7XG4gICAgLy8gIElmIHdlIGRvbid0IGhhdmUgYSBjb25zdHJ1Y3QgcGF0aCwgd2UgY2FuJ3QgZmlsdGVyIG91dCB0aGlzIHZpb2xhdGlvbiBzbyB3ZSBoYXZlIHRvIGtlZXAgaXQuXG4gICAgcmV0dXJuICFjLmNvbnN0cnVjdFBhdGggfHwgc3RhY2tJZHMuc29tZSgoc3RhY2tJZCkgPT4gYy5jb25zdHJ1Y3RQYXRoID09PSBzdGFja0lkIHx8IGMuY29uc3RydWN0UGF0aD8uc3RhcnRzV2l0aChgJHtzdGFja0lkfS9gKSk7XG4gIH1cbn1cblxuLyoqXG4gKiBDb2xsZWN0IGFubm90YXRpb24gbWV0YWRhdGEgKHdhcm5pbmdzIGFuZCBlcnJvcnMpIGZyb20gdGhlIGNvbnN0cnVjdCB0cmVlXG4gKiBhbmQgY29udmVydCB0aGVtIGludG8gYSBOYW1lZFZhbGlkYXRpb25QbHVnaW5SZXBvcnQgdGhhdCBjYW4gYmUgbWVyZ2VkXG4gKiBpbnRvIHRoZSBzYW1lIHJlcG9ydCBwaXBlbGluZSBhcyBwbHVnaW4gdmlvbGF0aW9ucy5cbiAqXG4gKiBFZmZlY3RpdmVseSB0aGUgc2FtZSBhcyB3aGF0IGhhcHBlbnMgaGVyZTpcbiAqIDxodHRwczovL2dpdGh1Yi5jb20vYXdzL2F3cy1jZGsvYmxvYi9tYWluL3BhY2thZ2VzL2F3cy1jZGstbGliL2NvcmUvbGliL3ByaXZhdGUvY29sbGVjdC1hbm5vdGF0aW9uLXJlcG9ydC50cz5cbiAqL1xuZnVuY3Rpb24gcGx1Z2luUmVwb3J0RnJvbUFubm90YXRpb25zKHN0YWNrczogQ2xvdWRGb3JtYXRpb25TdGFja0FydGlmYWN0W10pOiBjeHNjaGVtYS5QbHVnaW5SZXBvcnRKc29uIHtcbiAgLy8gVGhlIHJldHVybiB0eXBlIHJlcXVpcmVzIHRoYXQgd2UgY29tYmluZSB2aW9sYXRpb25zIGJ5IHJ1bGUsIHNvIHdlIGhhdmUgdG8gZ3JvdXAgdGhlbSBmaXJzdCBoZXJlLlxuICBjb25zdCBydWxlTWFwID0gbmV3IE1hcDxzdHJpbmcsIGN4c2NoZW1hLlBvbGljeVZpb2xhdGlvbkpzb24+KCk7XG5cbiAgZm9yIChjb25zdCBzdGFjayBvZiBzdGFja3MpIHtcbiAgICBmb3IgKGNvbnN0IGVudHJ5IG9mIHN0YWNrLm1lc3NhZ2VzKSB7XG4gICAgICBsZXQgc2V2ZXJpdHk6IGN4c2NoZW1hLlBvbGljeVZpb2xhdGlvblNldmVyaXR5IHwgdW5kZWZpbmVkO1xuXG4gICAgICBzd2l0Y2ggKGVudHJ5LmxldmVsKSB7XG4gICAgICAgIGNhc2UgU3ludGhlc2lzTWVzc2FnZUxldmVsLldBUk5JTkc6XG4gICAgICAgICAgc2V2ZXJpdHkgPSAnd2FybmluZyc7XG4gICAgICAgICAgYnJlYWs7XG4gICAgICAgIGNhc2UgU3ludGhlc2lzTWVzc2FnZUxldmVsLkVSUk9SOlxuICAgICAgICAgIHNldmVyaXR5ID0gJ2Vycm9yJztcbiAgICAgICAgICBicmVhaztcbiAgICAgICAgY2FzZSBTeW50aGVzaXNNZXNzYWdlTGV2ZWwuSU5GTzpcbiAgICAgICAgICBzZXZlcml0eSA9ICdpbmZvJztcbiAgICAgICAgICBicmVhaztcbiAgICAgIH1cblxuICAgICAgY29uc3QgeyBtZXNzYWdlLCBydWxlTmFtZSB9ID0gc3BsaXREZXNjcmlwdGlvbkFuZElkKFN0cmluZyhlbnRyeS5lbnRyeS5kYXRhKSk7XG4gICAgICBjb25zdCBydWxlS2V5ID0gYCR7cnVsZU5hbWV9fCR7c2V2ZXJpdHl9fCR7bWVzc2FnZX1gO1xuICAgICAgbGV0IHZpb2xhdGlvbiA9IHJ1bGVNYXAuZ2V0KHJ1bGVLZXkpO1xuICAgICAgaWYgKCF2aW9sYXRpb24pIHtcbiAgICAgICAgdmlvbGF0aW9uID0ge1xuICAgICAgICAgIHJ1bGVOYW1lOiBydWxlTmFtZSA/PyBgJHtzZXZlcml0eX0tYW5ub3RhdGlvbmAsXG4gICAgICAgICAgZGVzY3JpcHRpb246IG1lc3NhZ2UsXG4gICAgICAgICAgc2V2ZXJpdHksXG4gICAgICAgICAgdmlvbGF0aW5nQ29uc3RydWN0czogW10sXG4gICAgICAgICAgcnVsZU1ldGFkYXRhOiB7XG4gICAgICAgICAgICAnY2RrOmFubm90YXRpb24nOiAndHJ1ZScsXG4gICAgICAgICAgfSxcbiAgICAgICAgfTtcbiAgICAgICAgcnVsZU1hcC5zZXQocnVsZUtleSwgdmlvbGF0aW9uKTtcbiAgICAgIH1cblxuICAgICAgdmlvbGF0aW9uLnZpb2xhdGluZ0NvbnN0cnVjdHMucHVzaCh7XG4gICAgICAgIGNvbnN0cnVjdFBhdGg6IGVudHJ5LmlkLnJlcGxhY2UoL15cXC8vLCAnJyksIC8vIHJlbW92ZSBsZWFkaW5nIHNsYXNoXG5cbiAgICAgICAgLy8gSWYgd2UgZ2V0IHRoaXMgc3RhY2sgdHJhY2UgaGVyZSwgaXQgd2FzIHJlY29yZGVkIGJ5IHRoZSBgY29uc3RydWN0c2AgbGlicmFyeSxcbiAgICAgICAgLy8gd2hpY2ggbWVhbnMgaXQgaGFzbid0IGJlZW4gSnVzdE15Q29kZS1zdHJpcHBlZCB5ZXQuXG4gICAgICAgIHN0YWNrVHJhY2VzOiBlbnRyeS5lbnRyeS50cmFjZSA/IFtcbiAgICAgICAgICBuZXcgU3RhY2tUcmFjZShlbnRyeS5lbnRyeS50cmFjZSkucmVuZGVySnVzdE15Q29kZSgpLmpvaW4oJ1xcbicpLFxuICAgICAgICBdIDogW10sXG4gICAgICB9KTtcbiAgICB9XG4gIH1cblxuICBjb25zdCB2aW9sYXRpb25zID0gQXJyYXkuZnJvbShydWxlTWFwLnZhbHVlcygpKTtcbiAgY29uc3QgaGFzRXJyb3JzID0gdmlvbGF0aW9ucy5zb21lKHYgPT4gdi5zZXZlcml0eSA9PT0gJ2Vycm9yJyk7XG4gIHJldHVybiB7XG4gICAgcGx1Z2luTmFtZTogQU5OT1RBVElPTl9QTFVHSU5fTkFNRSxcbiAgICBjb25jbHVzaW9uOiBoYXNFcnJvcnMgPyAnZmFpbHVyZScgOiAnc3VjY2VzcycsXG4gICAgdmlvbGF0aW9ucyxcbiAgfTtcbn1cblxuLyoqXG4gKiBBbm5vdGF0aW9ucyBoYXZlIElEcyBpbiB0d28gcGxhY2VzOlxuICpcbiAqIC0gV2FybmluZ3MgaGF2ZSBgW2Fjazo8aWQ+XWAgaW4gdGhlIG1lc3NhZ2UuXG4gKiAtIEVycm9ycyBoYXZlIGAoPG5hbWVzcGFjZT46OjxpZD4pYCBpbiB0aGUgbWVzc2FnZS5cbiAqXG4gKiBTZXBhcmF0ZSB0aGUgcnVsZSBuYW1lIGZyb20gdGhlIHJlc3Qgb2YgdGhlIGRlc2NyaXB0aW9uLlxuICovXG5mdW5jdGlvbiBzcGxpdERlc2NyaXB0aW9uQW5kSWQobWVzc2FnZTogc3RyaW5nKTogeyBtZXNzYWdlOiBzdHJpbmc7IHJ1bGVOYW1lPzogc3RyaW5nIH0ge1xuICBjb25zdCBhY2tNYXRjaCA9IG1lc3NhZ2UubWF0Y2goL1xcW2FjazogKFteXFxdXSspXFxdLyk7XG4gIGlmIChhY2tNYXRjaCkge1xuICAgIHJldHVybiB7IG1lc3NhZ2U6IG1lc3NhZ2UucmVwbGFjZShhY2tNYXRjaFswXSwgJycpLnRyaW0oKSwgcnVsZU5hbWU6IGFja01hdGNoWzFdIH07XG4gIH1cblxuICBjb25zdCBpZE1hdGNoID0gbWVzc2FnZS5tYXRjaCgvXFwoKFteKCldKzo6W14oKV0rKVxcKSQvKTtcbiAgaWYgKGlkTWF0Y2gpIHtcbiAgICByZXR1cm4geyBtZXNzYWdlOiBtZXNzYWdlLnJlcGxhY2UoaWRNYXRjaFswXSwgJycpLnRyaW0oKSwgcnVsZU5hbWU6IGlkTWF0Y2hbMV0gfTtcbiAgfVxuXG4gIHJldHVybiB7IG1lc3NhZ2UgfTtcbn1cblxuYXN5bmMgZnVuY3Rpb24gcGF0aEV4aXN0cyhwYXRoTmFtZTogc3RyaW5nKSB7XG4gIHRyeSB7XG4gICAgYXdhaXQgZnMuYWNjZXNzKHBhdGhOYW1lKTtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfSBjYXRjaCAoZTogYW55KSB7XG4gICAgaWYgKGUuY29kZSAhPT0gJ0VOT0VOVCcpIHtcbiAgICAgIHRocm93IGU7XG4gICAgfVxuICAgIHJldHVybiBmYWxzZTtcbiAgfVxufVxuIl19
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Report whether it is possible to suppress this violation.
3
+ *
4
+ * Violations that are reported as "fatal", or that have been converted from annotations, cannot be suppressed.
5
+ */
6
+ export declare function isSuppressibleViolation(violation: {
7
+ severity?: string;
8
+ ruleMetadata?: {
9
+ [key: string]: string;
10
+ };
11
+ }): boolean;
12
+ export interface ValidationId {
13
+ readonly namespace?: Namespace;
14
+ readonly ruleId: string;
15
+ }
16
+ /**
17
+ * Parse a validation ID into a namespace and rule name.
18
+ *
19
+ * `::` is used to separate the namespace from the rule name. If no namespace is provided, the `annotation` namespace is assumed.
20
+ *
21
+ * The rule name may not contain `::`, except between brackets.
22
+ *
23
+ * Right now, this parses and validates balanced brackets, because we assume the
24
+ * people who invent identifiers are not maniacs. If it turns out this causes
25
+ * too many problems, we can remove matching bracket validation and just check
26
+ * for whether any brackets are open, not necessarily whether they match.
27
+ */
28
+ export declare function parseValidationId(id: string): ValidationId;
29
+ /**
30
+ * Normalize the given validation ID to a fully qualified ID, using the `annotation` namespace if no namespace is provided.
31
+ */
32
+ export declare function normalizeValidationId(id: string | ValidationId, defaultNamespace: Namespace): string;
33
+ /**
34
+ * Normalize the given validation ID to a fully qualified ID, using the `Annotation` namespace if no namespace is provided.
35
+ */
36
+ export declare function normalizeValidationIdForAnnotations(id: string | ValidationId): string;
37
+ declare const NS: unique symbol;
38
+ export interface Namespace {
39
+ [NS]: string;
40
+ }
41
+ /**
42
+ * Convert a plugin name to a namespace for validation IDs.
43
+ */
44
+ export declare function namespaceFromPluginName(pluginName: string): Namespace;
45
+ /**
46
+ * Convert a namespace to a displayable plugin name
47
+ */
48
+ export declare function pluginNameFromNamespace(namespace: Namespace): string;
49
+ export declare const ANNOTATION_PLUGIN_NAME = "Construct Annotations";
50
+ export declare const ANNOTATION_PLUGIN_NAMESPACE: Namespace;
51
+ export {};
@@ -0,0 +1,121 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ANNOTATION_PLUGIN_NAMESPACE = exports.ANNOTATION_PLUGIN_NAME = void 0;
4
+ exports.isSuppressibleViolation = isSuppressibleViolation;
5
+ exports.parseValidationId = parseValidationId;
6
+ exports.normalizeValidationId = normalizeValidationId;
7
+ exports.normalizeValidationIdForAnnotations = normalizeValidationIdForAnnotations;
8
+ exports.namespaceFromPluginName = namespaceFromPluginName;
9
+ exports.pluginNameFromNamespace = pluginNameFromNamespace;
10
+ /**
11
+ * Report whether it is possible to suppress this violation.
12
+ *
13
+ * Violations that are reported as "fatal", or that have been converted from annotations, cannot be suppressed.
14
+ */
15
+ function isSuppressibleViolation(violation) {
16
+ const isFatal = violation.severity?.toLowerCase() === 'fatal';
17
+ const isErrorAnnotation = violation.ruleMetadata?.['cdk:annotation'] && violation.severity?.toLowerCase() === 'error';
18
+ return !isFatal && !isErrorAnnotation;
19
+ }
20
+ /**
21
+ * Parse a validation ID into a namespace and rule name.
22
+ *
23
+ * `::` is used to separate the namespace from the rule name. If no namespace is provided, the `annotation` namespace is assumed.
24
+ *
25
+ * The rule name may not contain `::`, except between brackets.
26
+ *
27
+ * Right now, this parses and validates balanced brackets, because we assume the
28
+ * people who invent identifiers are not maniacs. If it turns out this causes
29
+ * too many problems, we can remove matching bracket validation and just check
30
+ * for whether any brackets are open, not necessarily whether they match.
31
+ */
32
+ function parseValidationId(id) {
33
+ let nsSeparator = undefined;
34
+ // Parser loop
35
+ const braceStack = [];
36
+ for (let i = 0; i < id.length; i++) {
37
+ const c = id[i];
38
+ if (c === ':' && id[i + 1] === ':' && braceStack.length === 0) {
39
+ // Found a namespace separator
40
+ if (nsSeparator !== undefined) {
41
+ throw new Error(`Invalid validation rule ID '${id}'. The '::' delimiter is reserved for separating the prefix from the rule name (e.g. 'prefix::RuleName').`);
42
+ }
43
+ nsSeparator = i;
44
+ i += 1;
45
+ }
46
+ else if ([']', ')', '}'].includes(c)) {
47
+ // Found a closing brace, pop the stack
48
+ const lastBrace = braceStack.pop();
49
+ if (lastBrace === undefined) {
50
+ throw new Error(`Invalid validation rule ID '${id}'. Unmatched closing brace '${c}' at position ${i}.`);
51
+ }
52
+ if ((lastBrace === '(' && c !== ')') || (lastBrace === '[' && c !== ']') || (lastBrace === '{' && c !== '}')) {
53
+ throw new Error(`Invalid validation rule ID '${id}'. Mismatched closing brace '${c}' at position ${i}. Expected '${lastBrace === '(' ? ')' : lastBrace === '[' ? ']' : '}'}'.`);
54
+ }
55
+ }
56
+ else if (['[', '(', '{'].includes(c)) {
57
+ // Found an opening brace, push it onto the stack
58
+ braceStack.push(c);
59
+ }
60
+ }
61
+ // Handle result
62
+ if (nsSeparator === undefined) {
63
+ return { ruleId: id };
64
+ }
65
+ if (nsSeparator === 0) {
66
+ throw new Error(`Invalid validation rule ID '${id}'. Missing plugin name before '::'.`);
67
+ }
68
+ const namespace = namespaceFromString(id.substring(0, nsSeparator));
69
+ const ruleId = id.substring(nsSeparator + 2);
70
+ return { namespace, ruleId };
71
+ }
72
+ /**
73
+ * Normalize the given validation ID to a fully qualified ID, using the `annotation` namespace if no namespace is provided.
74
+ */
75
+ function normalizeValidationId(id, defaultNamespace) {
76
+ const p = typeof id === 'string' ? parseValidationId(id) : id;
77
+ const parsed = {
78
+ namespace: p.namespace ? namespaceFromString(p.namespace[NS].replaceAll(/ /g, '-')) : undefined,
79
+ ruleId: p.ruleId.replaceAll(/ /g, '-'),
80
+ };
81
+ // Allow aliases for this namespace, but normalize it to the actual namespace we settled on.
82
+ if (parsed.namespace && ['annotation', 'Construct-Annotations'].includes(parsed.namespace[NS])) {
83
+ return `${exports.ANNOTATION_PLUGIN_NAMESPACE}::${parsed.ruleId}`;
84
+ }
85
+ return `${parsed.namespace ?? defaultNamespace[NS]}::${parsed.ruleId}`;
86
+ }
87
+ /**
88
+ * Normalize the given validation ID to a fully qualified ID, using the `Annotation` namespace if no namespace is provided.
89
+ */
90
+ function normalizeValidationIdForAnnotations(id) {
91
+ return normalizeValidationId(id, exports.ANNOTATION_PLUGIN_NAMESPACE);
92
+ }
93
+ const NS = Symbol('namespace');
94
+ /**
95
+ * Convert a plugin name to a namespace for validation IDs.
96
+ */
97
+ function namespaceFromPluginName(pluginName) {
98
+ if (pluginName === exports.ANNOTATION_PLUGIN_NAME) {
99
+ return exports.ANNOTATION_PLUGIN_NAMESPACE;
100
+ }
101
+ return namespaceFromString(pluginName.replace(/ /g, '-'));
102
+ }
103
+ function namespaceFromString(namespace) {
104
+ return Object.assign({
105
+ [NS]: namespace.replace(/ /g, '-'),
106
+ }, {
107
+ toString() {
108
+ return this[NS];
109
+ },
110
+ });
111
+ }
112
+ /**
113
+ * Convert a namespace to a displayable plugin name
114
+ */
115
+ function pluginNameFromNamespace(namespace) {
116
+ // We do not convert the annotation namespace back to its legacy plugin name.
117
+ return namespace[NS].replace(/-/g, ' ');
118
+ }
119
+ exports.ANNOTATION_PLUGIN_NAME = 'Construct Annotations';
120
+ exports.ANNOTATION_PLUGIN_NAMESPACE = namespaceFromPluginName('Annotation');
121
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyc2luZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbInBhcnNpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBS0EsMERBSUM7QUFtQkQsOENBMkNDO0FBS0Qsc0RBY0M7QUFLRCxrRkFFQztBQVdELDBEQU1DO0FBZUQsMERBR0M7QUFwSUQ7Ozs7R0FJRztBQUNILFNBQWdCLHVCQUF1QixDQUFDLFNBQTBFO0lBQ2hILE1BQU0sT0FBTyxHQUFHLFNBQVMsQ0FBQyxRQUFRLEVBQUUsV0FBVyxFQUFFLEtBQUssT0FBTyxDQUFDO0lBQzlELE1BQU0saUJBQWlCLEdBQUcsU0FBUyxDQUFDLFlBQVksRUFBRSxDQUFDLGdCQUFnQixDQUFDLElBQUksU0FBUyxDQUFDLFFBQVEsRUFBRSxXQUFXLEVBQUUsS0FBSyxPQUFPLENBQUM7SUFDdEgsT0FBTyxDQUFDLE9BQU8sSUFBSSxDQUFDLGlCQUFpQixDQUFDO0FBQ3hDLENBQUM7QUFPRDs7Ozs7Ozs7Ozs7R0FXRztBQUNILFNBQWdCLGlCQUFpQixDQUFDLEVBQVU7SUFDMUMsSUFBSSxXQUFXLEdBQXVCLFNBQVMsQ0FBQztJQUVoRCxjQUFjO0lBQ2QsTUFBTSxVQUFVLEdBQWEsRUFBRSxDQUFDO0lBQ2hDLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxFQUFFLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDbkMsTUFBTSxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ2hCLElBQUksQ0FBQyxLQUFLLEdBQUcsSUFBSSxFQUFFLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxLQUFLLEdBQUcsSUFBSSxVQUFVLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQzlELDhCQUE4QjtZQUM5QixJQUFJLFdBQVcsS0FBSyxTQUFTLEVBQUUsQ0FBQztnQkFDOUIsTUFBTSxJQUFJLEtBQUssQ0FBQywrQkFBK0IsRUFBRSwyR0FBMkcs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RCxRQUFBLDJCQUEyQixHQUFHLHVCQUF1QixDQUFDLFlBQVksQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBSZXBvcnQgd2hldGhlciBpdCBpcyBwb3NzaWJsZSB0byBzdXBwcmVzcyB0aGlzIHZpb2xhdGlvbi5cbiAqXG4gKiBWaW9sYXRpb25zIHRoYXQgYXJlIHJlcG9ydGVkIGFzIFwiZmF0YWxcIiwgb3IgdGhhdCBoYXZlIGJlZW4gY29udmVydGVkIGZyb20gYW5ub3RhdGlvbnMsIGNhbm5vdCBiZSBzdXBwcmVzc2VkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNTdXBwcmVzc2libGVWaW9sYXRpb24odmlvbGF0aW9uOiB7IHNldmVyaXR5Pzogc3RyaW5nOyBydWxlTWV0YWRhdGE/OiB7IFtrZXk6IHN0cmluZ106IHN0cmluZyB9IH0pOiBib29sZWFuIHtcbiAgY29uc3QgaXNGYXRhbCA9IHZpb2xhdGlvbi5zZXZlcml0eT8udG9Mb3dlckNhc2UoKSA9PT0gJ2ZhdGFsJztcbiAgY29uc3QgaXNFcnJvckFubm90YXRpb24gPSB2aW9sYXRpb24ucnVsZU1ldGFkYXRhPy5bJ2Nkazphbm5vdGF0aW9uJ10gJiYgdmlvbGF0aW9uLnNldmVyaXR5Py50b0xvd2VyQ2FzZSgpID09PSAnZXJyb3InO1xuICByZXR1cm4gIWlzRmF0YWwgJiYgIWlzRXJyb3JBbm5vdGF0aW9uO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFZhbGlkYXRpb25JZCB7XG4gIHJlYWRvbmx5IG5hbWVzcGFjZT86IE5hbWVzcGFjZTtcbiAgcmVhZG9ubHkgcnVsZUlkOiBzdHJpbmc7XG59XG5cbi8qKlxuICogUGFyc2UgYSB2YWxpZGF0aW9uIElEIGludG8gYSBuYW1lc3BhY2UgYW5kIHJ1bGUgbmFtZS5cbiAqXG4gKiBgOjpgIGlzIHVzZWQgdG8gc2VwYXJhdGUgdGhlIG5hbWVzcGFjZSBmcm9tIHRoZSBydWxlIG5hbWUuIElmIG5vIG5hbWVzcGFjZSBpcyBwcm92aWRlZCwgdGhlIGBhbm5vdGF0aW9uYCBuYW1lc3BhY2UgaXMgYXNzdW1lZC5cbiAqXG4gKiBUaGUgcnVsZSBuYW1lIG1heSBub3QgY29udGFpbiBgOjpgLCBleGNlcHQgYmV0d2VlbiBicmFja2V0cy5cbiAqXG4gKiBSaWdodCBub3csIHRoaXMgcGFyc2VzIGFuZCB2YWxpZGF0ZXMgYmFsYW5jZWQgYnJhY2tldHMsIGJlY2F1c2Ugd2UgYXNzdW1lIHRoZVxuICogcGVvcGxlIHdobyBpbnZlbnQgaWRlbnRpZmllcnMgYXJlIG5vdCBtYW5pYWNzLiAgSWYgaXQgdHVybnMgb3V0IHRoaXMgY2F1c2VzXG4gKiB0b28gbWFueSBwcm9ibGVtcywgd2UgY2FuIHJlbW92ZSBtYXRjaGluZyBicmFja2V0IHZhbGlkYXRpb24gYW5kIGp1c3QgY2hlY2tcbiAqIGZvciB3aGV0aGVyIGFueSBicmFja2V0cyBhcmUgb3Blbiwgbm90IG5lY2Vzc2FyaWx5IHdoZXRoZXIgdGhleSBtYXRjaC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlVmFsaWRhdGlvbklkKGlkOiBzdHJpbmcpOiBWYWxpZGF0aW9uSWQge1xuICBsZXQgbnNTZXBhcmF0b3I6IHVuZGVmaW5lZCB8IG51bWJlciA9IHVuZGVmaW5lZDtcblxuICAvLyBQYXJzZXIgbG9vcFxuICBjb25zdCBicmFjZVN0YWNrOiBzdHJpbmdbXSA9IFtdO1xuICBmb3IgKGxldCBpID0gMDsgaSA8IGlkLmxlbmd0aDsgaSsrKSB7XG4gICAgY29uc3QgYyA9IGlkW2ldO1xuICAgIGlmIChjID09PSAnOicgJiYgaWRbaSArIDFdID09PSAnOicgJiYgYnJhY2VTdGFjay5sZW5ndGggPT09IDApIHtcbiAgICAgIC8vIEZvdW5kIGEgbmFtZXNwYWNlIHNlcGFyYXRvclxuICAgICAgaWYgKG5zU2VwYXJhdG9yICE9PSB1bmRlZmluZWQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBJbnZhbGlkIHZhbGlkYXRpb24gcnVsZSBJRCAnJHtpZH0nLiBUaGUgJzo6JyBkZWxpbWl0ZXIgaXMgcmVzZXJ2ZWQgZm9yIHNlcGFyYXRpbmcgdGhlIHByZWZpeCBmcm9tIHRoZSBydWxlIG5hbWUgKGUuZy4gJ3ByZWZpeDo6UnVsZU5hbWUnKS5gKTtcbiAgICAgIH1cblxuICAgICAgbnNTZXBhcmF0b3IgPSBpO1xuICAgICAgaSArPSAxO1xuICAgIH0gZWxzZSBpZiAoWyddJywgJyknLCAnfSddLmluY2x1ZGVzKGMpKSB7XG4gICAgICAvLyBGb3VuZCBhIGNsb3NpbmcgYnJhY2UsIHBvcCB0aGUgc3RhY2tcbiAgICAgIGNvbnN0IGxhc3RCcmFjZSA9IGJyYWNlU3RhY2sucG9wKCk7XG4gICAgICBpZiAobGFzdEJyYWNlID09PSB1bmRlZmluZWQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBJbnZhbGlkIHZhbGlkYXRpb24gcnVsZSBJRCAnJHtpZH0nLiBVbm1hdGNoZWQgY2xvc2luZyBicmFjZSAnJHtjfScgYXQgcG9zaXRpb24gJHtpfS5gKTtcbiAgICAgIH1cbiAgICAgIGlmICgobGFzdEJyYWNlID09PSAnKCcgJiYgYyAhPT0gJyknKSB8fCAobGFzdEJyYWNlID09PSAnWycgJiYgYyAhPT0gJ10nKSB8fCAobGFzdEJyYWNlID09PSAneycgJiYgYyAhPT0gJ30nKSkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYEludmFsaWQgdmFsaWRhdGlvbiBydWxlIElEICcke2lkfScuIE1pc21hdGNoZWQgY2xvc2luZyBicmFjZSAnJHtjfScgYXQgcG9zaXRpb24gJHtpfS4gRXhwZWN0ZWQgJyR7bGFzdEJyYWNlID09PSAnKCcgPyAnKScgOiBsYXN0QnJhY2UgPT09ICdbJyA/ICddJyA6ICd9J30nLmApO1xuICAgICAgfVxuICAgIH0gZWxzZSBpZiAoWydbJywgJygnLCAneyddLmluY2x1ZGVzKGMpKSB7XG4gICAgICAvLyBGb3VuZCBhbiBvcGVuaW5nIGJyYWNlLCBwdXNoIGl0IG9udG8gdGhlIHN0YWNrXG4gICAgICBicmFjZVN0YWNrLnB1c2goYyk7XG4gICAgfVxuICB9XG5cbiAgLy8gSGFuZGxlIHJlc3VsdFxuICBpZiAobnNTZXBhcmF0b3IgPT09IHVuZGVmaW5lZCkge1xuICAgIHJldHVybiB7IHJ1bGVJZDogaWQgfTtcbiAgfVxuXG4gIGlmIChuc1NlcGFyYXRvciA9PT0gMCkge1xuICAgIHRocm93IG5ldyBFcnJvcihgSW52YWxpZCB2YWxpZGF0aW9uIHJ1bGUgSUQgJyR7aWR9Jy4gTWlzc2luZyBwbHVnaW4gbmFtZSBiZWZvcmUgJzo6Jy5gKTtcbiAgfVxuXG4gIGNvbnN0IG5hbWVzcGFjZSA9IG5hbWVzcGFjZUZyb21TdHJpbmcoaWQuc3Vic3RyaW5nKDAsIG5zU2VwYXJhdG9yKSk7XG4gIGNvbnN0IHJ1bGVJZCA9IGlkLnN1YnN0cmluZyhuc1NlcGFyYXRvciArIDIpO1xuXG4gIHJldHVybiB7IG5hbWVzcGFjZSwgcnVsZUlkIH07XG59XG5cbi8qKlxuICogTm9ybWFsaXplIHRoZSBnaXZlbiB2YWxpZGF0aW9uIElEIHRvIGEgZnVsbHkgcXVhbGlmaWVkIElELCB1c2luZyB0aGUgYGFubm90YXRpb25gIG5hbWVzcGFjZSBpZiBubyBuYW1lc3BhY2UgaXMgcHJvdmlkZWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBub3JtYWxpemVWYWxpZGF0aW9uSWQoaWQ6IHN0cmluZyB8IFZhbGlkYXRpb25JZCwgZGVmYXVsdE5hbWVzcGFjZTogTmFtZXNwYWNlKTogc3RyaW5nIHtcbiAgY29uc3QgcCA9IHR5cGVvZiBpZCA9PT0gJ3N0cmluZycgPyBwYXJzZVZhbGlkYXRpb25JZChpZCkgOiBpZDtcblxuICBjb25zdCBwYXJzZWQgPSB7XG4gICAgbmFtZXNwYWNlOiBwLm5hbWVzcGFjZSA/IG5hbWVzcGFjZUZyb21TdHJpbmcocC5uYW1lc3BhY2VbTlNdLnJlcGxhY2VBbGwoLyAvZywgJy0nKSkgOiB1bmRlZmluZWQsXG4gICAgcnVsZUlkOiBwLnJ1bGVJZC5yZXBsYWNlQWxsKC8gL2csICctJyksXG4gIH07XG5cbiAgLy8gQWxsb3cgYWxpYXNlcyBmb3IgdGhpcyBuYW1lc3BhY2UsIGJ1dCBub3JtYWxpemUgaXQgdG8gdGhlIGFjdHVhbCBuYW1lc3BhY2Ugd2Ugc2V0dGxlZCBvbi5cbiAgaWYgKHBhcnNlZC5uYW1lc3BhY2UgJiYgWydhbm5vdGF0aW9uJywgJ0NvbnN0cnVjdC1Bbm5vdGF0aW9ucyddLmluY2x1ZGVzKHBhcnNlZC5uYW1lc3BhY2VbTlNdKSkge1xuICAgIHJldHVybiBgJHtBTk5PVEFUSU9OX1BMVUdJTl9OQU1FU1BBQ0V9Ojoke3BhcnNlZC5ydWxlSWR9YDtcbiAgfVxuXG4gIHJldHVybiBgJHtwYXJzZWQubmFtZXNwYWNlID8/IGRlZmF1bHROYW1lc3BhY2VbTlNdfTo6JHtwYXJzZWQucnVsZUlkfWA7XG59XG5cbi8qKlxuICogTm9ybWFsaXplIHRoZSBnaXZlbiB2YWxpZGF0aW9uIElEIHRvIGEgZnVsbHkgcXVhbGlmaWVkIElELCB1c2luZyB0aGUgYEFubm90YXRpb25gIG5hbWVzcGFjZSBpZiBubyBuYW1lc3BhY2UgaXMgcHJvdmlkZWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBub3JtYWxpemVWYWxpZGF0aW9uSWRGb3JBbm5vdGF0aW9ucyhpZDogc3RyaW5nIHwgVmFsaWRhdGlvbklkKTogc3RyaW5nIHtcbiAgcmV0dXJuIG5vcm1hbGl6ZVZhbGlkYXRpb25JZChpZCwgQU5OT1RBVElPTl9QTFVHSU5fTkFNRVNQQUNFKTtcbn1cblxuY29uc3QgTlMgPSBTeW1ib2woJ25hbWVzcGFjZScpO1xuXG5leHBvcnQgaW50ZXJmYWNlIE5hbWVzcGFjZSB7XG4gIFtOU106IHN0cmluZztcbn1cblxuLyoqXG4gKiBDb252ZXJ0IGEgcGx1Z2luIG5hbWUgdG8gYSBuYW1lc3BhY2UgZm9yIHZhbGlkYXRpb24gSURzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gbmFtZXNwYWNlRnJvbVBsdWdpbk5hbWUocGx1Z2luTmFtZTogc3RyaW5nKTogTmFtZXNwYWNlIHtcbiAgaWYgKHBsdWdpbk5hbWUgPT09IEFOTk9UQVRJT05fUExVR0lOX05BTUUpIHtcbiAgICByZXR1cm4gQU5OT1RBVElPTl9QTFVHSU5fTkFNRVNQQUNFIGFzIE5hbWVzcGFjZTtcbiAgfVxuXG4gIHJldHVybiBuYW1lc3BhY2VGcm9tU3RyaW5nKHBsdWdpbk5hbWUucmVwbGFjZSgvIC9nLCAnLScpKTtcbn1cblxuZnVuY3Rpb24gbmFtZXNwYWNlRnJvbVN0cmluZyhuYW1lc3BhY2U6IHN0cmluZyk6IE5hbWVzcGFjZSB7XG4gIHJldHVybiBPYmplY3QuYXNzaWduKHtcbiAgICBbTlNdOiBuYW1lc3BhY2UucmVwbGFjZSgvIC9nLCAnLScpLFxuICB9LCB7XG4gICAgdG9TdHJpbmcodGhpczogTmFtZXNwYWNlKTogc3RyaW5nIHtcbiAgICAgIHJldHVybiB0aGlzW05TXTtcbiAgICB9LFxuICB9KTtcbn1cblxuLyoqXG4gKiBDb252ZXJ0IGEgbmFtZXNwYWNlIHRvIGEgZGlzcGxheWFibGUgcGx1Z2luIG5hbWVcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBsdWdpbk5hbWVGcm9tTmFtZXNwYWNlKG5hbWVzcGFjZTogTmFtZXNwYWNlKTogc3RyaW5nIHtcbiAgLy8gV2UgZG8gbm90IGNvbnZlcnQgdGhlIGFubm90YXRpb24gbmFtZXNwYWNlIGJhY2sgdG8gaXRzIGxlZ2FjeSBwbHVnaW4gbmFtZS5cbiAgcmV0dXJuIG5hbWVzcGFjZVtOU10ucmVwbGFjZSgvLS9nLCAnICcpO1xufVxuXG5leHBvcnQgY29uc3QgQU5OT1RBVElPTl9QTFVHSU5fTkFNRSA9ICdDb25zdHJ1Y3QgQW5ub3RhdGlvbnMnO1xuZXhwb3J0IGNvbnN0IEFOTk9UQVRJT05fUExVR0lOX05BTUVTUEFDRSA9IG5hbWVzcGFjZUZyb21QbHVnaW5OYW1lKCdBbm5vdGF0aW9uJyk7XG4iXX0=
package/package.json CHANGED
@@ -33,37 +33,35 @@
33
33
  "organization": true
34
34
  },
35
35
  "devDependencies": {
36
- "@aws-cdk/cloud-assembly-schema": "54.21.0",
37
- "@cdklabs/eslint-plugin": "^2.0.18",
36
+ "@aws-cdk/cloud-assembly-schema": "55.3.0",
37
+ "@cdklabs/eslint-plugin": "^2.0.25",
38
38
  "@stylistic/eslint-plugin": "^3",
39
39
  "@types/jest": "^29.5.14",
40
- "@types/json-source-map": "^0.6.0",
41
40
  "@types/node": "^20",
42
41
  "@typescript-eslint/eslint-plugin": "^8",
43
42
  "@typescript-eslint/parser": "^8",
44
- "commit-and-tag-version": "^12",
43
+ "commit-and-tag-version": "^13",
45
44
  "constructs": "^10.0.0",
46
45
  "eslint": "^9",
47
46
  "eslint-config-prettier": "^10.1.8",
48
47
  "eslint-import-resolver-typescript": "^4.4.5",
49
48
  "eslint-plugin-import": "^2.32.0",
50
- "eslint-plugin-jest": "^29.16.1",
49
+ "eslint-plugin-jest": "^29.17.0",
51
50
  "eslint-plugin-jsdoc": "^62.9.0",
52
51
  "eslint-plugin-prettier": "^4.2.5",
53
52
  "jest": "^29.7.0",
54
53
  "jest-junit": "^16",
55
54
  "license-checker": "^25.0.1",
56
- "nx": "^22.7.8",
55
+ "nx": "^22.7.12",
57
56
  "prettier": "^2.8",
58
- "projen": "^0.101.36",
59
- "ts-jest": "^29.4.12",
57
+ "projen": "^0.104.14",
58
+ "ts-jest": "^29.4.15",
60
59
  "typescript": "5.9"
61
60
  },
62
61
  "peerDependencies": {
63
- "@aws-cdk/cloud-assembly-schema": ">=54.21.0"
62
+ "@aws-cdk/cloud-assembly-schema": ">=55.3.0"
64
63
  },
65
64
  "dependencies": {
66
- "json-source-map": "^0.6.1",
67
65
  "jsonschema": "^1.5.0",
68
66
  "semver": "^7.8.5"
69
67
  },
@@ -87,7 +85,7 @@
87
85
  "publishConfig": {
88
86
  "access": "public"
89
87
  },
90
- "version": "2.4.0",
88
+ "version": "3.0.0",
91
89
  "packageManager": "yarn@4.17.1",
92
90
  "types": "lib/index.d.ts",
93
91
  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"yarn projen\"."
@@ -1,102 +0,0 @@
1
- import type { CloudFormationStackArtifact } from './artifacts/cloudformation-artifact';
2
- import type { CloudAssembly } from './cloud-assembly';
3
- /**
4
- * A construct from tree.json joined with the CloudFormation metadata of the
5
- * stack it belongs to: the construct path/id plus, for CFN resources, the
6
- * logical ID and resource type. Readers that need more (for example a source
7
- * location) extend this and build the richer tree via {@link buildConstructTree}.
8
- */
9
- export interface ConstructTreeNode {
10
- readonly path: string;
11
- readonly id: string;
12
- /** CFN resource type (e.g. "AWS::S3::Bucket"), if this construct is a CFN resource. */
13
- readonly type?: string;
14
- /** CFN logical ID, if this construct maps to a CFN resource. */
15
- readonly logicalId?: string;
16
- /**
17
- * Absolute path to the `*.template.json` that declares this construct's CFN
18
- * resource -- the nested template for resources inside a NestedStack. Set
19
- * only for CFN resources whose template is resolvable.
20
- */
21
- readonly templateFile?: string;
22
- /**
23
- * Resolved CloudFormation resource properties (the synthesized values from
24
- * the `aws:cdk:cloudformation:props` attribute), if this is a CFN resource.
25
- */
26
- readonly cfnProperties?: Record<string, unknown>;
27
- readonly children: readonly ConstructTreeNode[];
28
- }
29
- /**
30
- * The generic fields {@link buildConstructTree} computes for each node before a
31
- * consumer decorates it. `children` are already the decorated node type.
32
- */
33
- export interface ConstructTreeNodeFields<T extends ConstructTreeNode> {
34
- readonly path: string;
35
- readonly id: string;
36
- readonly type?: string;
37
- readonly logicalId?: string;
38
- readonly templateFile?: string;
39
- readonly cfnProperties?: Record<string, unknown>;
40
- readonly children: readonly T[];
41
- }
42
- /**
43
- * Produces a node of type `T` from the generic fields, the owning stack
44
- * artifact (if any), and the construct path. Readers use the stack + path to
45
- * attach extra data (for example a source location traced from the stack).
46
- */
47
- export type ConstructNodeDecorator<T extends ConstructTreeNode> = (fields: ConstructTreeNodeFields<T>, stack: CloudFormationStackArtifact | undefined, constructPath: string) => T;
48
- /**
49
- * Async variant of {@link ConstructNodeDecorator}: the decorator may return a
50
- * `Promise<T>`, so it can do non-blocking I/O (for example reading source maps
51
- * off disk with `fs.promises`) while building each node. Used by
52
- * {@link buildConstructTreeAsync}.
53
- */
54
- export type AsyncConstructNodeDecorator<T extends ConstructTreeNode> = (fields: ConstructTreeNodeFields<T>, stack: CloudFormationStackArtifact | undefined, constructPath: string) => T | Promise<T>;
55
- /**
56
- * A pre-built index over a construct tree. Walks the tree once and exposes
57
- * O(1) path lookup plus pre-order iteration over every node, so callers never
58
- * re-implement the recursive descent over `children`.
59
- *
60
- * Generic over the concrete node type, so callers that store richer nodes get
61
- * those richer nodes back from `byPath()` and iteration.
62
- */
63
- export declare class ConstructIndex<T extends ConstructTreeNode = ConstructTreeNode> implements Iterable<T> {
64
- private readonly byPathMap;
65
- /** Build an index from the roots of a construct tree. */
66
- static fromTree<T extends ConstructTreeNode>(tree: readonly T[]): ConstructIndex<T>;
67
- private constructor();
68
- /** The node at a given construct path, or undefined if absent. */
69
- byPath(constructPath: string): T | undefined;
70
- /** Number of nodes in the tree. */
71
- get size(): number;
72
- /** Pre-order iteration over every node in the tree. */
73
- [Symbol.iterator](): Iterator<T>;
74
- }
75
- /**
76
- * Read a cloud assembly's tree.json and join it with each stack's manifest
77
- * metadata to produce a construct tree where every CFN resource carries its
78
- * logicalId and CFN type.
79
- *
80
- * Supports:
81
- * - Flat assemblies (stacks directly under App).
82
- * - Stage-based apps: each Stage produces a nested cloud-assembly artifact
83
- * under assembly-STAGE/. stacksRecursively descends into them.
84
- * - NestedStack contents: aws-cdk-lib emits the per-resource metadata for
85
- * nested-stack constructs into the PARENT stack's artifact metadata,
86
- * keyed by full construct path.
87
- *
88
- * The `decorate` callback turns each node's generic fields and its metadata
89
- * entries into the concrete node type (e.g. attaching a resolved source location).
90
- *
91
- * This is the synchronous variant: `decorate` must return `T`. Callers whose
92
- * decoration needs non-blocking I/O should use {@link buildConstructTreeAsync}.
93
- */
94
- export declare function buildConstructTree<T extends ConstructTreeNode>(assembly: CloudAssembly, decorate: ConstructNodeDecorator<T>): T[];
95
- /**
96
- * Async counterpart of {@link buildConstructTree}: the `decorate` callback may
97
- * return a `Promise<T>`, letting it do non-blocking I/O per node (for example
98
- * tracing source locations with `fs.promises`) without blocking the calling
99
- * thread. Behaves identically otherwise; the tree is walked in pre-order and
100
- * each node's children are resolved before the node is decorated.
101
- */
102
- export declare function buildConstructTreeAsync<T extends ConstructTreeNode>(assembly: CloudAssembly, decorate: AsyncConstructNodeDecorator<T>): Promise<T[]>;