feat: add EventBridge importer

Author: gasolima

packages/@aws-cdk/aws-service-spec/build/full-database.ts

@@ -1,11 +1,11 @@
 import * as path from 'node:path';
-import { SpecDatabase } from '@aws-cdk/service-spec-types';
 import { DatabaseBuilder, DatabaseBuilderOptions, ReportAudience } from '@aws-cdk/service-spec-importers';
+import { patchOobRelationships } from '@aws-cdk/service-spec-importers/src/patches/oob-relationship-patches';
+import { SpecDatabase } from '@aws-cdk/service-spec-types';
 import { Augmentations } from './augmentations';
-import { Scrutinies } from './scrutinies';
-import { patchSamTemplateSpec } from './patches/sam-patches';
 import { patchCloudFormationRegistry } from './patches/registry-patches';
-import { patchOobRelationships } from '@aws-cdk/service-spec-importers/src/patches/oob-relationship-patches';
+import { patchSamTemplateSpec } from './patches/sam-patches';
+import { Scrutinies } from './scrutinies';
 
 const SOURCES = path.join(__dirname, '../../../../sources');
 
@@ -29,7 +29,8 @@ export class FullDatabase extends DatabaseBuilder {
       )
       .importLogSources(path.join(SOURCES, 'LogSources/log-source-resource.json'))
       .importScrutinies()
-      .importAugmentations();
+      .importAugmentations()
+      .importEventBridgeSchema(path.join(SOURCES, 'EventBridgeSchema'));
   }
 
   /**

packages/@aws-cdk/service-spec-importers/schemas/EventBridge.schema.json

@@ -0,0 +1,95 @@
+{
+  "$ref": "#/definitions/EventBridgeSchema",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "EventBridgeSchema": {
+      "additionalProperties": false,
+      "description": "Root class of an EventBridge Schema",
+      "properties": {
+        "SchemaName": {
+          "type": "string"
+        },
+        "Content": {
+          "$ref": "#/definitions/EventBridgeContent"
+        },
+        "Description": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "SchemaName",
+        "Content",
+        "Description"
+      ],
+      "type": "object"
+    },
+    "EventBridgeContent": {
+      "additionalProperties": false,
+      "properties": {
+        "components": {
+          "$ref": "#/definitions/EventBridgeComponents"
+        }
+      },
+      "required": [
+        "components"
+      ],
+      "type": "object"
+    },
+    "EventBridgeComponents": {
+      "additionalProperties": false,
+      "properties": {
+        "schemas": {
+          "$ref": "#/definitions/EventBridgeSchemas"
+        }
+      },
+      "required": [
+        "schemas"
+      ],
+      "type": "object"
+    },
+    "EventBridgeSchemas": {
+      "additionalProperties": false,
+      "properties": {
+        "AWSEvent": {
+          "$ref": "#/definitions/AWSEvent"
+        }
+      },
+      "required": [
+        "AWSEvent"
+      ],
+      "type": "object"
+    },
+    "AWSEvent": {
+      "additionalProperties": false,
+      "properties": {
+        "x-amazon-events-detail-type": {
+          "type": "string"
+        },
+        "x-amazon-events-source": {
+          "type": "string"
+        },
+        "properties": {
+          "$ref": "#/definitions/AWSEventProperties"
+        }
+      },
+      "required": [
+        "x-amazon-events-detail-type",
+        "x-amazon-events-source",
+        "properties"
+      ],
+      "type": "object"
+    },
+    "AWSEventProperties": {
+      "additionalProperties": false,
+      "properties": {
+        "detail": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "detail"
+      ],
+      "type": "object"
+    }
+  }
+}

packages/@aws-cdk/service-spec-importers/src/cli/import-db.ts

@@ -17,6 +17,7 @@ const AVAILABLE_SOURCES: Record<string, keyof DatabaseBuilder> = {
   arnTemplates: 'importArnTemplates',
   oobRelationships: 'importOobRelationships',
   logSources: 'importLogSources',
+  eventbridgeschema: 'importEventBridgeSchema',
 };
 
 async function main() {

packages/@aws-cdk/service-spec-importers/src/db-builder.ts

@@ -5,6 +5,7 @@ import { importArnTemplates } from './importers/import-arn-templates';
 import { importCannedMetrics } from './importers/import-canned-metrics';
 import { importCloudFormationDocumentation } from './importers/import-cloudformation-docs';
 import { importCloudFormationRegistryResource } from './importers/import-cloudformation-registry';
+import { importEventBridgeSchema } from './importers/import-eventbridge-schema';
 import { importGetAttAllowList } from './importers/import-getatt-allowlist';
 import { importLogSources } from './importers/import-log-source';
 import { importOobRelationships } from './importers/import-oob-relationships';
@@ -23,6 +24,7 @@ import {
   loadSamSpec,
   loadOobRelationships,
 } from './loaders';
+import { loadDefaultEventBridgeSchema } from './loaders/load-eventbridge-schema';
 import { JsonLensPatcher } from './patching';
 import { ProblemReport, ReportAudience } from './report';
 
@@ -56,7 +58,7 @@ export class DatabaseBuilder {
   constructor(
     protected readonly db: SpecDatabase = emptyDatabase(),
     private readonly options: DatabaseBuilderOptions,
-  ) {}
+  ) { }
 
   /**
    * Add a SourceImporter to the database builder
@@ -217,6 +219,29 @@ export class DatabaseBuilder {
     });
   }
 
+  /**
+   * Import the EvnetBridge schema
+   */
+  public importEventBridgeSchema(schemaDirectory: string) {
+    return this.addSourceImporter(async (db, report) => {
+      const regions = await loadDefaultEventBridgeSchema(schemaDirectory, {
+        ...this.options,
+        report,
+        failureAudience: this.defaultProblemGrouping,
+      });
+      for (const region of regions) {
+        for (const event of region.events) {
+          importEventBridgeSchema({
+            db,
+            event,
+            report,
+            region: region.regionName,
+          });
+        }
+      }
+    });
+  }
+
   /**
    * Look at a load result and report problems
    */

packages/@aws-cdk/service-spec-importers/src/diff-fmt.ts

@@ -34,6 +34,7 @@ export class DiffFormatter {
   constructor(db1: SpecDatabase, db2: SpecDatabase) {
     this.dbs = [db1, db2];
   }
+  // TODO: I'm pretty sure i need to add something here to make my changes to show in the diff thingy
 
   public format(diff: SpecDatabaseDiff): string {
     const tree = new PrintableTree();