@atmosx/event-product-parser 3.0.62 → 3.0.75

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

@@ -11,15 +11,15 @@
     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 "StaticTypes/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;
@@ -30,8 +30,9 @@ export const GetEmebedText = (event: TypeEvent): string => {
         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 +51,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/{@modules/@utilities → components/utilities}/GetFormattedTime.ts

@@ -11,9 +11,9 @@
     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
 
     
 */

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

@@ -11,9 +11,9 @@
     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
 
     
 */

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

@@ -11,17 +11,22 @@
     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
 
 */
 
-export const GetMatched = (strings: string[], string: string): boolean => {
-    const isMatched = strings.some(pattern => {
+interface GetMatchedOptions {
+    Strings: string[]
+    String: string
+}
+
+export const GetMatched = ({ Strings, String }: GetMatchedOptions): boolean => {
+    const isMatched = Strings.some(pattern => {
         if (!pattern) return false;
         const lowerP = pattern.toLowerCase();
-        const lowerS = string.toLowerCase()
+        const lowerS = String.toLowerCase()
         if (lowerP === "*" || lowerP === lowerS) return true;
         if (lowerP.includes("*")) {
             const regex = "^" + lowerP.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$";

package/src/{@modules/@utilities → components/utilities}/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/{@parsers/@text → components/utilities}/GetStringText.ts

@@ -11,19 +11,17 @@
     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 "StaticTypes/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;
@@ -34,8 +32,9 @@ export const GetStringText = (event: TypeEvent): string => {
         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 +52,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/components/utilities/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
+    }
+};

package/src/components/utilities/QueueManager.ts

@@ -0,0 +1,70 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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
+*/
+
+export type QueueTask = () => Promise<void>;
+
+export interface QueueManagerOptions {
+    Concurrency?: number;
+    Error?: (error: unknown) => void;
+}
+
+export class QueueManager {
+    private readonly queue: QueueTask[] = [];
+    private readonly concurrency: number;
+    private readonly onError: (error: unknown) => void;
+
+    private running = 0;
+    private draining = false;
+
+    public constructor({ Concurrency, Error }: QueueManagerOptions = {}) {
+        this.concurrency = Concurrency ?? 1;
+        this.onError = Error ?? ((error) => {
+            console.error("[QueueManager] Task failed:", error);
+        });
+    }
+
+    public enqueue(task: QueueTask): void {
+        this.queue.push(task);
+        this.drain();
+    }
+
+    private drain(): void {
+        if (this.draining) { return; }
+        this.draining = true;
+        while (this.running < this.concurrency && this.queue.length > 0) {
+            const task = this.queue.shift();
+            if (!task) { continue; }
+            this.running++;
+            void this.execute(task);
+        }
+        this.draining = false;
+    }
+
+    private async execute(task: QueueTask): Promise<void> {
+        try {
+            await task();
+        } catch (error) {
+            try {
+                this.onError(error);
+            } catch (handlerError) {}
+        } finally {
+            this.running--;
+            this.drain();
+        }
+    }
+}

package/src/components/utilities/SetCronSchedule.ts

@@ -0,0 +1,106 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeSettings } from "Types/Settings"
+import { ReconnectXMPP } from "@XMPP/ReconnectXMPP"
+import { Bootstrap } from "@Bootstrap"
+import { CreateHttp } from "@Utilities/CreateHttp"
+import { SetEventEmit } from "@Utilities/SetEventEmit"
+import { CreateEvent } from "@Building/CreateEvent"
+import { readdirSync, unlinkSync, statSync, rmdirSync, existsSync } from "fs"
+import { join } from "path"
+
+export const SetCronSchedule = async (): Promise<void> => {
+    const settings = Bootstrap.Settings as TypeSettings;
+
+    const TTL = settings.GlobalSettings.ArchiveSettings.TTL
+    const TTLCUT = Date.now() - TTL * 1000;
+
+    const walk = (dir: string, deleteFolder = false): void => {
+        if (!existsSync(dir)) return;
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath, deleteFolder);
+                continue;
+            }
+            const stats = statSync(fullPath);
+            if (stats.mtime.getTime() < TTLCUT) {
+                try {
+                    unlinkSync(fullPath);
+                } catch (err) {
+                    console.error(`Failed to delete ${fullPath}:`, err);
+                }
+            }
+        }
+        if (deleteFolder) {
+            try {
+                if (readdirSync(dir).length === 0 && statSync(dir).mtime.getTime() < TTLCUT) {
+                    rmdirSync(dir);
+                }
+            } catch (err) {
+                console.error(`Failed to delete directory ${dir}:`, err);
+            }
+        }
+    };
+    walk(settings.GlobalSettings.ArchiveSettings.TextDirectory, true)
+    walk(settings.GlobalSettings.ArchiveSettings.AudioDirectory, true)
+    walk(settings.GlobalSettings.ArchiveSettings.JSONDirectory, true)
+    walk(settings.GlobalSettings.ArchiveSettings.ImageDirectory, true)
+
+
+
+    if (settings.EnableWireService) {
+        if (settings.NOAAWeatherWireServiceSettings.ReconnectionSettings.Enabled) {
+            void ReconnectXMPP(settings.NOAAWeatherWireServiceSettings.ReconnectionSettings.ReconnectionInterval)
+        }
+    } else { 
+        const response = await CreateHttp({
+            URL: settings.NationalWeatherServiceSettings.EventsEndpoint,
+            Headers: {
+                "User-Agent": "@atmosx/event-product-parser"
+            }
+        })
+        if (response.error) {
+            return SetEventEmit({
+                Event: `onServiceStatus`,
+                Metadata: {
+                    type: "fetch-api",
+                    message: `Failed to fetch latest events from National Weather Service API - ${response.message}`,
+                    data: {},
+                    error: true
+                },
+            })
+        }
+        SetEventEmit({
+            Event: `onServiceStatus`,
+            Metadata: {
+                Message: `Fetched latest events from National Weather Service API`,
+                Data: {},
+                Type: "fetch-api",
+                Error: false
+            },
+        })
+        await CreateEvent({ Message: response.message, NWWS: false })
+    }
+}
+
+

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

@@ -11,27 +11,27 @@
     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 { TypeSettings } from "Types/Settings"
+import { Bootstrap } from "@Bootstrap"
 
 interface SetDebugOptions { 
-    title?: string
-    message: string
+    Title?: string
+    Message: string
 }
 
-export const SetDebug = (options: SetDebugOptions): void => {
-    const settings = bootstrap.settings as TypeSettings;
-    bootstrap.listener.emit(`debug`, {
-        message: options.message,
-        function: options.title ?? `debug`,
+export const SetDebug = ({ Title, Message }: SetDebugOptions): void => {
+    const settings = Bootstrap.Settings as TypeSettings;
+    Bootstrap.Listener.emit(`debug`, {
+        message: Message,
+        function: Title ?? `debug`,
     })
     if (settings.EnableDebugging) { 
-        console.log(`[${bootstrap.ansi_colors.BLUE}${options.title ?? `debug`}${bootstrap.ansi_colors.RESET}] ${options.message}`)
+        console.log(`[${Bootstrap.Colors.Blue}${Title ?? `debug`}${Bootstrap.Colors.Reset}] ${Message}`)
     }
 }

package/src/components/utilities/SetEventEmit.ts

@@ -0,0 +1,42 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { Bootstrap } from "@Bootstrap"
+import { SetTimeoutAction } from "@Utilities/SetTimeoutAction"
+import { SetWarning } from "@Utilities/SetWarning"
+
+interface SetEventEmitOptions { 
+    Event: string
+    Metadata: any
+    Message?: string
+    Limited?: boolean
+    Tree?: string[]
+}
+
+export const SetEventEmit = ({ Event, Metadata, Message, Limited, Tree }: SetEventEmitOptions): void => {
+    if (Limited) {
+        const isTimeout = SetTimeoutAction({ Identifier: `event.${Event}`, AddTime: true, Max: 1, Interval: 1 })
+        if (isTimeout.Limited) return;
+    }
+    Bootstrap.Listener.emit(Event, Metadata)
+    if (Event != `log`) { Bootstrap.Listener.emit(`*`, {event: Event, data: Metadata}) }
+    if (Message) {
+        SetWarning({ Message: Message, Tree: Tree })
+    }
+}

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

@@ -11,17 +11,17 @@
     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 { TypeSettings } from "Types/Settings"
+import { Bootstrap } from "@Bootstrap"
 
-export const SetSettings = (newSettings: TypeSettings): TypeSettings => {
-    const settings = bootstrap.settings as Record<string, unknown>;
+export const SetSettings = (imported: TypeSettings): TypeSettings => {
+    const settings = Bootstrap.Settings as Record<string, unknown>;
     const merge = (target: Record<string, unknown>, source: Record<string, unknown>) => {
         for (const key in source) {
             if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
@@ -37,6 +37,6 @@ export const SetSettings = (newSettings: TypeSettings): TypeSettings => {
             }
         }
     };
-    merge(settings, newSettings as Record<string, unknown>);
+    merge(settings, imported as Record<string, unknown>);
     return settings as TypeSettings;
 }

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

@@ -11,22 +11,22 @@
     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 SetSleepOptions { 
-    timeout: number
+    Timeout: number
 }
 
-export const SetSleep = async (options: SetSleepOptions): Promise<void> => {
+export const SetSleep = async ({ Timeout }: SetSleepOptions): Promise<void> => {
     return new Promise((resolve) => {
         setTimeout(() => {
             resolve();
-        }, options.timeout);
+        }, Timeout);
     });
 }
 

package/src/components/utilities/SetTimeoutAction.ts

@@ -0,0 +1,64 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { Bootstrap } from "@Bootstrap"
+
+interface SetTimeoutActionOptions {
+    Identifier: string
+    AddTime?: boolean
+    Max?: number
+    Interval?: number
+    Expire?: boolean
+}
+
+type SetTimeoutActionResponse = {
+    Limited: boolean
+    Remaining?: number
+    Response?: string
+}
+
+export const SetTimeoutAction = ({ Identifier, AddTime, Max, Interval, Expire }: SetTimeoutActionOptions): SetTimeoutActionResponse =>  {
+    let target = Bootstrap?.Ratelimits?.[Identifier];
+    if (!target) {
+        Bootstrap.Ratelimits[Identifier] = [];
+        target = Bootstrap.Ratelimits[Identifier];
+    }
+    if (Expire) {
+        delete Bootstrap.Ratelimits[Identifier];
+        return { Limited: false };
+    }
+    if (target?.length > 0) {
+       Bootstrap.Ratelimits[Identifier] = target.filter((ts: number) => Date.now() - ts < Interval * 1000);
+       target = Bootstrap.Ratelimits[Identifier];
+    }
+
+    const oldestTimestamp = target?.[0];
+    const getWait = oldestTimestamp ? Math.ceil((Interval * 1000) - (Date.now() - oldestTimestamp)) : 0;
+    const max = Max ?? 1;
+    
+    if (target?.length >= max && getWait > 0) {
+        return {
+            Limited: true,
+            Remaining: getWait,
+            Response: `You are being rate limited, please wait ${(getWait / 1e3).toFixed(1)} second(s) before performing this action again.`
+        }
+    }
+    Bootstrap.Ratelimits[Identifier].push(Date.now());
+    return { Limited: false };
+}