@atmosx/event-product-parser 3.0.621 → 3.1.0

package/src/{@modules/@database → components/events/utilities}/GetCachedEvents.ts

@@ -11,26 +11,29 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeSettings } from "../../@types/Settings"
-import { bootstrap } from '../../bootstrap'
-import { SetWarning } from '../@utilities/SetWarning';
-import { CreateEvent } from '../../@building/CreateEvent';
-import { ValidateEvents } from "../../@manager/ValidateEvents";
+import { TypeSettings } from "TypesStandard/Settings"
+import { Bootstrap } from "@Bootstrap"
+import { SetWarning } from "@Utilities/SetWarning"
+import { ProcessStanza } from "@Builder/ProcessStanza"
+import { CreateQuery } from "@Database/CreateQuery"
 
 export const GetCachedEvents = async (): Promise<void> => {
     try { 
-        const settings = bootstrap.settings as TypeSettings;
+        const settings = Bootstrap.Settings as TypeSettings;
         const tick = performance.now();
         if (settings.NOAAWeatherWireServiceSettings.CacheSettings.Enabled) {
             const max = settings.NOAAWeatherWireServiceSettings.CacheSettings.MaxRetentionHistory ?? 500;
-            const get = await bootstrap.database.prepare(`SELECT * FROM stanzas ORDER BY rowid DESC LIMIT ?`).all(max) as { rowid: number; stanza: string }[];
-            SetWarning({ message: `Fetched ${get.length} cached stanzas from the database in ${Math.floor(performance.now() - tick)} ms` })
+            const get = await CreateQuery({ 
+                Query: `SELECT * FROM stanzas ORDER BY rowid DESC LIMIT ?`, 
+                Parameters: [max] 
+            }) as { rowid: number; stanza: string }[];
+            SetWarning({ Message: `Fetched ${get.length} cached stanzas from the database in ${Math.floor(performance.now() - tick)} ms` })
             let events = get.map((row) => JSON.parse(row.stanza))
                 .filter(stanza => {
                     if (!stanza) { return }
@@ -40,11 +43,11 @@ export const GetCachedEvents = async (): Promise<void> => {
                     return !isSkippable
                 });
             events = events.sort((a, b) => b.issued - a.issued)
-            await Promise.all(events.map(event => CreateEvent(event, true)))
-            SetWarning({ message: `Processed ${events.length} cached stanzas in ${Math.floor(performance.now() - tick)} ms` })
-            await ValidateEvents(bootstrap.cache.processed)
+            await Promise.all(events.map(event => ProcessStanza(event)))
+            SetWarning({ Message: `Processed ${events.length} cached stanzas in ${Math.floor(performance.now() - tick)} ms` })
         }
-    } catch (error) {
-        SetWarning({ message: `An error occurred while fetching cached stanzas: ${error.message} -> ${error.stack}` })
+    } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : String(error);
+        SetWarning({ Message: `An error occurred while fetching cached stanzas: ${message}` })
     }
 }

package/src/{@manager → components/events/utilities}/SetHash.ts

@@ -11,26 +11,31 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeEvent } from "../@types/Event";
-import { TypeHash } from "../@types/Hash"
-import { bootstrap } from "../bootstrap"
+import { TypeEvent } from "TypesEvent/Event"
+import { TypeHash } from "TypesStandard/Hash"
+import { Bootstrap } from "@Bootstrap"
 
-export const SetHash = (event: TypeEvent, entry: TypeHash): void => {
-    if (!entry) {
-        bootstrap.cache.hashes.push({
-            tracking: event.properties.metadata.tracking,
-            hashes: [event.properties.metadata.hash],
-            expires: event.properties.expires
+interface SetHashOptions {
+    Event: TypeEvent
+    Entry: TypeHash
+}
+
+export const SetHash = ({ Event, Entry }: SetHashOptions): void => {
+    if (!Entry) {
+        Bootstrap.Cache.Hashes.push({
+            Tracking: Event.properties.metadata.tracking,
+            Hashes: [Event.properties.metadata.hash],
+            Expires: Event.properties.expires
         });
         return;
     }
 
-    entry.hashes.push(event.properties.metadata.hash);
-    entry.expires = event.properties.expires;
+    Entry.Hashes.push(Event.properties.metadata.hash);
+    Entry.Expires = Event.properties.expires;
 }

package/src/{@manager → components/events/utilities}/UpdateEvents.ts

@@ -11,25 +11,25 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeEvent } from "../@types/Event";
-import { bootstrap } from "../bootstrap"
-import { SetEventEmit } from "../@modules/@utilities/SetEventEmit";
-import { RemoveEvent } from "./RemoveEvent";
+import { TypeEvent } from "TypesEvent/Event"
+import { Bootstrap } from "@Bootstrap"
+import { SetEventEmit } from "@Utilities/SetEventEmit"
+import { RemoveEvents } from "@Builder/RemoveEvents"
 
-export const UpdateEvents = async (selectedEvent?: TypeEvent): Promise<void> => {
-    const events = bootstrap.cache.events.features;
+export const UpdateEvents = async (selected?: TypeEvent): Promise<void> => {
+    const events = Bootstrap.Cache.Events.features;
     async function update(event: TypeEvent) {
         if (new Date(event.properties.expires) < new Date()) {
-            SetEventEmit({ event: `onExpiredProduct`, metadata: event })
-            await RemoveEvent(event, true)
+            SetEventEmit({ Event: `onExpiredProduct`, Metadata: event })
+            await RemoveEvents({ Event: event, IsTimeBasedExpiration: true })
         }
     }
-    if (!selectedEvent) { await Promise.all(events.map(async (event) => { await update(event) })) } 
-    if (selectedEvent) { await update(selectedEvent) }
+    if (!selected) { await Promise.all(events.map(async (event) => { await update(event) })) } 
+    if (selected) { await update(selected) }
 }

package/src/{@manager → components/events/utilities}/UpdateNode.ts

@@ -11,23 +11,23 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeEvent } from "../@types/Event";
-import { bootstrap } from "../bootstrap"
-import { GetEventNodes } from "../@building/GetEventNodes";
-import { SetEventEmit } from "../@modules/@utilities/SetEventEmit";
+import { TypeEvent } from "TypesEvent/Event"
+import { Bootstrap } from "@Bootstrap"
+import { GetEventNodes } from "@BuilderComponents/GetEventNodes"
+import { SetEventEmit } from "@Utilities/SetEventEmit"
 
-export const UpdateNode = async (selectedEvent?: TypeEvent): Promise<void> => {
-    const events = bootstrap.cache.events.features;
-    const ttl = bootstrap.settings.GlobalSettings.NodeTTL * 1e3;
+export const UpdateNode = async (selected?: TypeEvent): Promise<void> => {
+    const events = Bootstrap.Cache.Events.features;
+    const ttl = Bootstrap.Settings.GlobalSettings.NodePolygonTTL * 1e3;
     let total = 0;
 
-    const TTLEvents = selectedEvent ? [selectedEvent] : events.filter((evt) => {
+    const TTLEvents = selected ? [selected] : events.filter((evt) => {
         const lastUpdate = evt?.properties?.metadata?.updated ?? null;
         return lastUpdate == null || (Date.now() - lastUpdate) >= ttl;
     });
@@ -52,10 +52,10 @@ export const UpdateNode = async (selectedEvent?: TypeEvent): Promise<void> => {
 
     if (total > 0) {
         SetEventEmit({
-            event: `onNodeUpdate`,
-            metadata: {
-                type: `global-update`,
-                updated: total
+            Event: `onNodeUpdate`,
+            Metadata: {
+                Type: `global-update`,
+                Updated: total
             },
         })
     }

package/src/{@parsers/@text → components/formatting}/GetEmbededText.ts

@@ -11,27 +11,32 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeEvent } from "../../@types/Event"
+import { TypeEvent } from "TypesEvent/Event"
 
-export const GetEmebedText = (event: TypeEvent): string => {
+export const GetEmbededText = (event: TypeEvent): string => {
     const line = (label: string, value: unknown, condition = true) => condition && value ? `${label} ${value}` : null;
     const isStatement = event.properties.status_metadata.is_statement;
     const isExpired = event.properties.status_metadata.is_expired;
+    const isIssued = event.properties.status_metadata.is_issued;
+    const isUpdated = event.properties.status_metadata.is_updated;
     return [
         line(`**Locations:**`, event?.properties?.locations?.slice(0, 100)),
-        line(`**Issued:**`, `<t:${Math.floor(new Date(event.properties.issued).getTime() / 1000)}:R>`, !isExpired),
-        line(`**Expires:**`, `<t:${Math.floor(new Date(event.properties.expires).getTime() / 1000)}:R>`, !isStatement),
+        line(`**Issued:**`, `<t:${Math.floor(new Date(event.properties.issued).getTime() / 1000)}:R>`, isIssued),
+        line(`**Updated:**`, `<t:${Math.floor(new Date(event.properties.issued).getTime() / 1000)}:R>`, isUpdated && !isExpired),
+        line(`**Expires:**`, `<t:${Math.floor(new Date(event.properties.expires).getTime() / 1000)}:R>`, !isStatement && !isExpired),
+        line(`**Expired:**`, `<t:${Math.floor(new Date(event.properties.expires).getTime() / 1000)}:R>`, isExpired),
         line(`**Damage Threat:**`, event?.properties?.parameters?.damage_threat, !isExpired),
         line(`**Flood Threat:**`, event?.properties?.parameters?.flood_threat, !isExpired),
         line(`**Tornado Threat:**`, event?.properties?.parameters?.tornado_threat, !isExpired),
-        line(`**Estimated Wind Gusts:**`, `${event?.properties?.parameters?.estimated_wind_gusts} ${event?.properties?.parameters?.wind_threat ? ` (${event?.properties?.parameters?.wind_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_wind_gusts != null),
-        line(`**Estimated Hail Size:**`, `${event?.properties?.parameters?.estimated_hail_size} ${event?.properties?.parameters?.hail_threat ? ` (${event?.properties?.parameters?.hail_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_hail_size != null),
+        line(`**Wind Gusts:**`, `${event?.properties?.parameters?.estimated_wind_gusts} ${event?.properties?.parameters?.wind_threat ? ` (${event?.properties?.parameters?.wind_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_wind_gusts != null),
+        line(`**Hail Size:**`, `${event?.properties?.parameters?.estimated_hail_size} ${event?.properties?.parameters?.hail_threat ? ` (${event?.properties?.parameters?.hail_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_hail_size != null),
+        line(`**Direction:**`, event?.properties?.parameters?.direction, !isExpired && event?.properties?.parameters?.direction != null),
         line(`**Discussion:**`, event?.properties?.discussion_parameters?.discussion_number, !isExpired),
         line(`**Concern:**`, event?.properties?.discussion_parameters?.discussion_concerning, !isExpired),
         line(`**SPC Max Tornado Threat:**`, event?.properties?.discussion_parameters?.discussion_max_tornado, !isExpired),
@@ -50,6 +55,7 @@ export const GetEmebedText = (event: TypeEvent): string => {
         line(`**Max Tops (x100 feet):**`, event?.properties?.watch_parameters?.max_tops_x100feet, !isExpired), 
         line(`**Tags:**`, event?.properties?.parameters?.tags?.length > 0 ? event?.properties?.parameters?.tags.join(', ') : null, !isExpired),
         line(`**Sender:**`, event?.properties?.geocode?.office?.name ? `${event?.properties?.geocode?.office?.name} (${event?.properties?.geocode?.office?.office})` : event?.properties?.geocode?.office?.office),
+        line(`**Population:**`, event?.properties?.geocode?.census?.population, !isExpired),
         line(`**Tracking:**`, event?.properties?.metadata?.tracking),
         line(`**Logs:**`, event?.properties?.metadata?.history?.length > 0 ? event?.properties?.metadata?.history.length : null),
     ].filter(Boolean).join('\n');

package/src/{@parsers/@text → components/formatting}/GetStringText.ts

@@ -11,31 +11,34 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeEvent } from "../../@types/Event"
-import { TypeSettings } from "../../@types/Settings";
-import { bootstrap } from "../../bootstrap";
+import { TypeEvent } from "TypesEvent/Event"
+import { Bootstrap } from "@Bootstrap"
 
 export const GetStringText = (event: TypeEvent): string => {
-    const settings = bootstrap.settings as TypeSettings;
-    const timezone = settings.NotifyServer.Timezone ?? `UTC`;
+    const timezone = Bootstrap.Settings.Timezone ?? `UTC`;
     const line = (label: string, value: unknown, condition = true) => condition && value ? `${label} ${value}` : null;
     const isStatement = event.properties.status_metadata.is_statement;
     const isExpired = event.properties.status_metadata.is_expired;
+    const isIssued = event.properties.status_metadata.is_issued;
+    const isUpdated = event.properties.status_metadata.is_updated;
     return [
         line(`Locations:`, event?.properties?.locations?.slice(0, 100)),
-        line(`Issued:`, `${new Date(event.properties.issued).toLocaleString([], { timeZone: timezone })} (${(timezone.replace(`America/`, ``))})`, !isExpired),
-        line(`Expires:`, `${new Date(event.properties.expires).toLocaleString([], { timeZone: timezone })} (${(timezone.replace(`America/`, ``))})`, !isStatement),
+        line(`Issued:`, `${new Date(event.properties.issued).toLocaleString([], { timeZone: timezone })} (${(timezone.replace(`America/`, ``))})`, isIssued),
+        line(`Updated:`, `${new Date(event.properties.issued).toLocaleString([], { timeZone: timezone })} (${(timezone.replace(`America/`, ``))})`, isUpdated && !isExpired),
+        line(`Expires:`, `${new Date(event.properties.expires).toLocaleString([], { timeZone: timezone })} (${(timezone.replace(`America/`, ``))})`, !isStatement && !isExpired),
+        line(`Expired:`, `${new Date(event.properties.expires).toLocaleString([], { timeZone: timezone })} (${(timezone.replace(`America/`, ``))})`, isExpired),
         line(`Damage Threat:`, event?.properties?.parameters?.damage_threat, !isExpired),
         line(`Flood Threat:`, event?.properties?.parameters?.flood_threat, !isExpired),
         line(`Tornado Threat:`, event?.properties?.parameters?.tornado_threat, !isExpired),
-        line(`Estimated Wind Gusts:`, `${event?.properties?.parameters?.estimated_wind_gusts} ${event?.properties?.parameters?.wind_threat ? ` (${event?.properties?.parameters?.wind_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_wind_gusts != null),
-        line(`Estimated Hail Size:`, `${event?.properties?.parameters?.estimated_hail_size} ${event?.properties?.parameters?.hail_threat ? ` (${event?.properties?.parameters?.hail_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_hail_size != null),
+        line(`Wind Gusts:`, `${event?.properties?.parameters?.estimated_wind_gusts} ${event?.properties?.parameters?.wind_threat ? ` (${event?.properties?.parameters?.wind_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_wind_gusts != null),
+        line(`Hail Size:`, `${event?.properties?.parameters?.estimated_hail_size} ${event?.properties?.parameters?.hail_threat ? ` (${event?.properties?.parameters?.hail_threat})` : ''}`, !isExpired && event?.properties?.parameters?.estimated_hail_size != null),
+        line(`Direction:`, event?.properties?.parameters?.direction, !isExpired && event?.properties?.parameters?.direction != null),
         line(`Discussion:`, event?.properties?.discussion_parameters?.discussion_number, !isExpired),
         line(`Concern:`, event?.properties?.discussion_parameters?.discussion_concerning, !isExpired),
         line(`SPC Max Tornado Threat:`, event?.properties?.discussion_parameters?.discussion_max_tornado, !isExpired),
@@ -53,6 +56,7 @@ export const GetStringText = (event: TypeEvent): string => {
         line(`Max Surface Wind:`, event?.properties?.watch_parameters?.max_wind_surface, !isExpired),
         line(`Max Tops (x100 feet):`, event?.properties?.watch_parameters?.max_tops_x100feet, !isExpired), 
         line(`Sender:`, event?.properties?.geocode?.office?.name ? `${event?.properties?.geocode?.office?.name} (${event?.properties?.geocode?.office?.office})` : event?.properties?.geocode?.office?.office),
+        line(`Population:`, event?.properties?.geocode?.census?.population, !isExpired),
         line(`Tracking:`, event?.properties?.metadata?.tracking),
     ].filter(Boolean).join('\n');
 }

package/src/{@modules/@utilities → components/geometry}/GetShapeNearestPoint.ts

@@ -11,23 +11,28 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
+interface GetShapeNearestPointOptions {
+    Coordinates: number[][]
+    Point: [number, number]
+}
+
 interface GetShapeNearestPointResponse { 
-    proximity: boolean
-    point: [number, number]
-    distance: number | null 
-    distanceKm?: number | null
-    distanceMeters?: number | null
+    Proximity: boolean
+    Point: [number, number]
+    Distance: number | null 
+    DistanceKm?: number | null
+    DistanceMeters?: number | null
 }
 
-export const GetShapeNearestPoint = (coordinates: number[][], point: [number, number]): GetShapeNearestPointResponse => {
-    if (!coordinates || !point) { 
-        return { proximity: false, point: [0, 0], distance: null }
+export const GetShapeNearestPoint = ({ Coordinates, Point }: GetShapeNearestPointOptions): GetShapeNearestPointResponse => {
+    if (!Coordinates || !Point) { 
+        return { Proximity: false, Point: [0, 0], Distance: null }
     }
     const normalize = (coords: any): any[] => {
         if (!Array.isArray(coords)) return [];
@@ -43,10 +48,10 @@ export const GetShapeNearestPoint = (coordinates: number[][], point: [number, nu
         }
         return [];
     }
-    const polys = normalize(coordinates);
-    if (polys.length === 0) return { proximity: false, point: [0, 0], distance: null };
-    const lon = point[0];
-    const lat = point[1];
+    const polys = normalize(Coordinates);
+    if (polys.length === 0) return { Proximity: false, Point: [0, 0], Distance: null };
+    const lon = Point[0];
+    const lat = Point[1];
     const pointInRing = (pt: [number, number], ring: number[][]): boolean => {
         let x = pt[0], y = pt[1];
         let inside = false;
@@ -76,13 +81,13 @@ export const GetShapeNearestPoint = (coordinates: number[][], point: [number, nu
     for (const poly of polys) {
         const outer = poly[0];
         const holes = poly.slice(1);
-        if (pointInRing(point, outer)) {
+        if (pointInRing(Point, outer)) {
             let inHole = false;
             for (const hole of holes) {
-                if (pointInRing(point, hole)) { inHole = true; break; }
+                if (pointInRing(Point, hole)) { inHole = true; break; }
             }
             if (!inHole) {
-                return { proximity: true, point, distance: 0 };
+                return { Proximity: true, Point, Distance: 0 };
             }
         }
         for (const ring of poly) {
@@ -105,10 +110,10 @@ export const GetShapeNearestPoint = (coordinates: number[][], point: [number, nu
         }
     }
     if (!isFinite(minDistance) || closestPoint == null) {
-        return { proximity: false, point: [0,0], distance: null };
+        return { Proximity: false, Point: [0,0], Distance: null };
     }
     const distanceMiles = minDistance;
     const distanceKm = Number((distanceMiles * 1.609344).toFixed(3));
     const distanceMeters = Math.round(distanceKm * 1000);
-    return { proximity: distanceMiles === 0, point: closestPoint, distance: distanceMiles, distanceKm, distanceMeters };
+    return { Proximity: distanceMiles === 0, Point: closestPoint, Distance: distanceMiles, DistanceKm: distanceKm, DistanceMeters: distanceMeters };
 }

package/src/components/geometry/GetUnionPolygon.ts

@@ -0,0 +1,36 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+import { union } from "polygon-clipping";
+
+interface GetUnionPolygonOptions {
+    Polygons: number[][][][] | null;
+}
+
+export const GetUnionPolygon = ({ Polygons }: GetUnionPolygonOptions): GeoJSON.MultiPolygon | null => {
+    if (!Polygons || Polygons.length === 0) {
+        return null;
+    }
+    const unionFn = union as unknown as (...polygons: number[][][][]) => number[][][][];
+    const unioned = unionFn(...Polygons)
+    return {
+        type: `MultiPolygon`,
+        coordinates: unioned
+    }
+};