more reusable components for events-api to use

Author: mudhoney

src/Data/DataSource.php

@@ -14,6 +14,7 @@
  * IF YOU EDIT THIS CLASS, YOU MUST UPDATE docs/datasources.md
  */
 abstract class DataSource {
+    public string $pin;
     /** Name of where the data is coming from */
     public string $source;
     /** Name of data product */
@@ -91,4 +92,12 @@ protected function Transform(array $data, DateTimeInterface $obstime): array {
         return "HelioviewerEventInterface\\Translator\\$this->translator::Transform"($data, $obstime);
     }
 
+    /**
+     * Returns the translator class name for this data source
+     * @return string
+     */
+    public function getTranslator(): string {
+        return $this->translator;
+    }
+
 }

src/Translator/DonkiCme.php

@@ -293,6 +293,33 @@ private function instruments(): string {
         return $text;
     }
 
+    public static function buildTranslatedCME(array $record): array {
+        try {
+            return TranslateCME($record);
+        } catch (IgnoreCme $e) {
+            // Create the event with null coordinates when location can't be determined
+            $start = new DateTimeImmutable($record['startTime']);
+            $end = $start->add(new DateInterval("P1D"));
+            
+            $event = new HelioviewerEvent();
+            $event->id      = $record['activityID'];
+            $event->label   = "CME " . $record['activityID'];
+            $event->short_label = "CME";
+            $event->version = $record['catalog'] ?? null;
+            $event->type    = 'CE';
+            $event->start   = $start->format('Y-m-d H:i:s');
+            $event->end     = $end->format('Y-m-d H:i:s');
+            $event->link    = new EventLink("DONKI", "https://kauai.ccmc.gsfc.nasa.gov/DONKI/view/CME/" . $record['activityID']);
+            $event->views   = [];
+            // Set coordinates to null when location is unknown
+            // $event->hv_hpc_x = null;
+            // $event->hv_hpc_y = null;
+            
+            $event->source = $record;
+            return (array) $event;
+        }
+    }
+
     public static function Translate(array $data, mixed $extra): array {
         $groups = [
             [

src/Translator/DonkiFlare.php

@@ -119,6 +119,24 @@ public function views(): array {
         ];
     }
 
+    public static function makeEventFromRawFlare(array $flare): array {
+        $flare = new self($flare);
+        $event = new HelioviewerEvent();
+        $event->id = $flare->id();
+        $event->label = $flare->label();
+        $event->short_label   = $flare->shortLabel();
+        $event->version = '';
+        $event->type = 'FL';
+        $event->start = $flare->start();
+        $event->end = $flare->end();
+        $event->source = $flare->flare;
+        $event->views = $flare->views();
+        $event->link = $flare->link();
+        $res = (array) $event;
+        $res['peak'] = $flare->peak();
+        return $res;
+    }
+
 
     public static function Translate(array $flares, mixed $extra): array {
         $groups = [
@@ -131,19 +149,8 @@ public static function Translate(array $flares, mixed $extra): array {
         ];
         $data = &$groups[0]['data'];
         foreach ($flares as $flare) {
-            $flare = new self($flare);
-            $event = new HelioviewerEvent();
-            $event->id = $flare->id();
-            $event->label = $flare->label();
-            $event->short_label   = $flare->shortLabel();
-            $event->version = '';
-            $event->type = 'FL';
-            $event->start = $flare->start();
-            $event->end = $flare->end();
-            $event->source = $flare->flare;
-            $event->views = $flare->views();
-            $event->link = $flare->link();
-            array_push($data, (array) $event);
+            $event = self::makeEventFromRawFlare($flare);
+            array_push($data, $event);
         }
         return $groups;
     }

src/Util/HapiRecord.php

@@ -80,4 +80,4 @@ public function jsonSerialize(): array
         }
         return $result;
     }
-}
+}