[feat] Standardizes region IDs using external mapping (#277)

Author: Aloento

src/Services/Status.Trans.V2.ts

@@ -5,35 +5,14 @@ import { Logger } from "~/Helpers/Logger";
 import { EmptyDB } from "./Status";
 import { IncidentEntityV2, NameEnum, StatusEntityV2, StatusEnum } from "./Status.Entities";
 import { IStatusContext, Models } from "./Status.Models";
+import regionIdMap from "./regionIdMap.json";
 
 const log = new Logger("Service", "Status", "TransformerV2");
 
 /**
- * Transforms the provided components and events into a status context.
- *
- * This function processes the given components and events, organizing them into
- * categories, regions, and services. It also handles event statuses and histories,
- * ensuring that the data is structured and ready for further use.
- *
- * Note: This function assumes that all components have valid attributes and that
- * all events have valid impact values. It also assumes that the input data is
- * already sorted in the desired order.
- *
- * @param {Object} param - The input object containing components and events.
- * @param {StatusEntityV2[]} param.Components - The list of status components to be processed.
- * @param {IncidentEntityV2[]} param.Events - The list of incident events to be processed.
- * @returns {IStatusContext} The transformed status context containing organized data.
- *
- * @example
- * const context = TransformerV2({ Components: [], Events: [] });
- * console.log(context);
- *
- * @throws {Error} If any component or event is missing required attributes.
- * @throws {Error} If any event has an invalid impact value.
- *
  * @author Aloento
  * @since 1.0.0
- * @version 0.2.0
+ * @version 0.2.1
  */
 export function TransformerV2({ Components, Events }: { Components: StatusEntityV2[], Events: IncidentEntityV2[] }): IStatusContext {
   let id = 0;
@@ -74,7 +53,8 @@ export function TransformerV2({ Components, Events }: { Components: StatusEntity
 
     let dbRegion = db.Regions.find((x) => x.Name === targetRegion);
     if (!dbRegion) {
-      dbRegion = { Id: id++, Name: targetRegion, Services: new Set() };
+      const regionId = regionIdMap[targetRegion as keyof typeof regionIdMap] ?? id++;
+      dbRegion = { Id: regionId, Name: targetRegion, Services: new Set() };
       db.Regions.push(dbRegion);
     }
 
@@ -118,6 +98,8 @@ export function TransformerV2({ Components, Events }: { Components: StatusEntity
     }
   }
 
+  db.Regions.sort((a, b) => a.Id - b.Id);
+
   log.debug("Component data loaded.");
 
   for (const event of Events) {

src/Services/regionIdMap.json

@@ -0,0 +1,5 @@
+{
+  "EU-DE": 0,
+  "EU-NL": 1,
+  "Global": 2
+}