@atmosx/event-product-parser 3.0.6 → 3.0.7

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/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/{@modules/@utilities → components/utilities}/SetCronSchedule.ts

@@ -11,34 +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 { TypeSettings } from "../../@types/Settings";
-import { ReconnectXMPP } from "../@xmpp/ReconnectXMPP"
-import { bootstrap } from "../../bootstrap";
-import { CreateHttp } from "./CreateHttp";
-import { CreateEvent } from "../../@building/CreateEvent";
-import { SetEventEmit } from "./SetEventEmit";
-import { readdirSync, unlinkSync, statSync, existsSync } from "fs";
-import { join } from "path";
+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 settings = Bootstrap.Settings as TypeSettings;
 
     const TTL = settings.GlobalSettings.ArchiveSettings.TTL
     const TTLCUT = Date.now() - TTL * 1000;
 
-    const walk = (dir: string): void => {
+    const walk = (dir: string, deleteFolder?: boolean): void => {
         if (existsSync(dir)) {
             const entries = readdirSync(dir, { withFileTypes: true });
             for (const entry of entries) {
                 const fullPath = join(dir, entry.name);
-                if (entry.isDirectory()) { walk(fullPath); continue; }
+                if (entry.isDirectory()) { walk(fullPath, deleteFolder); continue; }
                 const stats = statSync(fullPath);
                 if (stats.mtime.getTime() < TTLCUT) {
                     try {
@@ -47,12 +47,16 @@ export const SetCronSchedule = async (): Promise<void> => {
                         console.error(`Failed to delete ${fullPath}:`, err);
                     }
                 }
+                if (deleteFolder && readdirSync(dir).length === 0) {
+                    rmdirSync(dir);
+                }
             }
         }
     };
     walk(settings.GlobalSettings.ArchiveSettings.TextDirectory)
-    walk(settings.GlobalSettings.ArchiveSettings.EasDirectory)
+    walk(settings.GlobalSettings.ArchiveSettings.AudioDirectory)
     walk(settings.GlobalSettings.ArchiveSettings.JSONDirectory)
+    walk(settings.GlobalSettings.ArchiveSettings.ImageDirectory, true)
 
 
 
@@ -62,15 +66,15 @@ export const SetCronSchedule = async (): Promise<void> => {
         }
     } else { 
         const response = await CreateHttp({
-            url: settings.NationalWeatherServiceSettings.EventsEndpoint,
-            headers: {
+            URL: settings.NationalWeatherServiceSettings.EventsEndpoint,
+            Headers: {
                 "User-Agent": "@atmosx/event-product-parser"
             }
         })
         if (response.error) {
             return SetEventEmit({
-                event: `onServiceStatus`,
-                metadata: {
+                Event: `onServiceStatus`,
+                Metadata: {
                     type: "fetch-api",
                     message: `Failed to fetch latest events from National Weather Service API - ${response.message}`,
                     data: {},
@@ -79,15 +83,15 @@ export const SetCronSchedule = async (): Promise<void> => {
             })
         }
         SetEventEmit({
-            event: `onServiceStatus`,
-            metadata: {
-                message: `Fetched latest events from National Weather Service API`,
-                data: {},
-                type: "fetch-api",
-                error: false
+            Event: `onServiceStatus`,
+            Metadata: {
+                Message: `Fetched latest events from National Weather Service API`,
+                Data: {},
+                Type: "fetch-api",
+                Error: false
             },
         })
-        await CreateEvent({ message: response.message, isNWWS: 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 };
+}

package/src/components/utilities/SetWarning.ts

@@ -0,0 +1,47 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeSettings } from "Types/Settings"
+
+interface SetWarningOptions { 
+    Title?: string
+    Message: string
+    Tree?: string[]
+}
+
+export const SetWarning = ({ Title, Message, Tree }: SetWarningOptions): void => {
+    const settings = Bootstrap.Settings as TypeSettings;
+    const title = Title ?? (`[${Bootstrap.Colors.Yellow}@atmosx/event-product-parser${Bootstrap.Colors.Reset}]`);
+    const log = (message: string): void => {
+        Bootstrap.Listener.emit(`log`, message);
+        if (settings.EnableJournal) { console.log(message); }
+    };
+    log(`${title} ${Message}`);
+
+    if (!Tree?.length) return;
+
+    const cleanTitle = title.replace(/\x1b\[[0-9;]*m/g, ``);
+    const padding = ` `.repeat(cleanTitle.length + 1);
+    const entries = Tree.filter((entry): entry is NonNullable<typeof entry> => entry !== undefined && entry !== null);
+    entries.forEach((entry, index) => {
+        const prefix = index === entries.length - 1 ? `└─` : `├─`;
+        log(`${padding}${prefix} ${entry}`);
+    });
+};