@atmosx/event-product-parser 3.0.62 → 3.0.75

package/src/{@parsers/@ugc → parsers/ugc}/SetCache.ts

@@ -11,18 +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 { bootstrap } from "../../bootstrap";
+import { Bootstrap } from "@Bootstrap"
 
-export const setCache = (key: string, value: string[]) => {
-	if (bootstrap.cache.ugc.size >= 5000) {
-        const firstKey = bootstrap.cache.ugc.keys().next().value;
-        bootstrap.cache.ugc.delete(firstKey);
+interface SetCacheOptions {
+    Key: string
+    Value: string[]
+}
+
+export const SetCache = ({ Key, Value }: SetCacheOptions) => {
+	if (Bootstrap.Cache.UGC.size >= 5000) {
+        const firstKey = Bootstrap.Cache.UGC.keys().next().value;
+        Bootstrap.Cache.UGC.delete(firstKey);
     }
-    bootstrap.cache.ugc.set(key, value);
+    Bootstrap.Cache.UGC.set(Key, Value);
 };

package/src/{@parsers/@ugc → parsers/ugc}/UGCExtract.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 { TypeUGC } from "../../@types/UGC";
-import { getUGCHeader } from "./GetUGCHeader"
-import { getZones } from "./GetZones";
-import { GetExpiry } from './GetExpiry';
-import { getLocations } from "./GetLocations";
+import { TypeUGC } from "Types/UGC"
+import { GetHeader } from "@ParsingUGC/GetHeader"
+import { GetZones } from "@ParsingUGC/GetZones"
+import { GetExpiry } from "@ParsingUGC/GetExpiry"
+import { GetLocations } from "@ParsingUGC/GetLocations"
 
-export const ugcExtract = async (message: string): Promise<TypeUGC> => {
-    const head = getUGCHeader(message);
-    const ugcs = getZones(head)
+export const UGCExtract = async (message: string): Promise<TypeUGC> => {
     const expires = GetExpiry(message)
-    const areas = await getLocations(ugcs)
+    const head = GetHeader(message);
+    const ugcs = GetZones(head);
+    const areas = await GetLocations(ugcs)
     if (!head || ugcs?.length == 0) return;
     return { 
-        zones: ugcs,
-        locations: areas, 
-        expires: expires
+        Zones: ugcs,
+        Locations: areas, 
+        Expires: expires
     }
 }

package/src/{@parsers/@pvtec → parsers/vtec}/GetExpiry.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/parsers/vtec/VTECExtract.ts

@@ -0,0 +1,49 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeVTEC } from "Types/VTEC"
+import { EnumExpressions } from "@Enums/Expressions"
+import { EnumProducts } from "@Enums/Products"
+import { EnumEvents } from "@Enums/Events"
+import { EnumActions } from "@Enums/Actions"
+import { EnumStatus } from "@Enums/Status"
+import { GetExpiry } from "@ParsingVTEC/GetExpiry"
+
+export const VTECExtract = (message: string): TypeVTEC[] | null => {
+    if (!message) return null;
+    const getVTECs = message.match(EnumExpressions.vtec) ?? [];
+    const vtecs: TypeVTEC[] = [];
+    for (const vtec of getVTECs) {
+        const sub = vtec.split(`.`);
+        if (sub?.length < 7) continue;
+        const dates = sub[6]?.split(`-`);
+        vtecs.push({
+            Raw: vtec,
+            ProductType: EnumProducts[sub[0]],
+            Tracking: `${sub[2]}.${sub[3]}.${sub[4]}.${sub[5]}`,
+            Event: `${EnumEvents[sub[3]]} ${EnumActions[sub[4]]}`,
+            Status: EnumStatus[sub[1]],
+            WMO: message.match(EnumExpressions.wmo)?.[0] ?? null,
+            Expires: GetExpiry(dates),
+            Watch: (sub[4] == `A` || sub[4] == `Y`) && (sub[3] == `TO` || sub[3] == `SV`),
+            PredictionCenter: sub[2] == `KWNS` ? true : false
+        })
+    }
+    return vtecs.length > 0 ? vtecs : null;
+}

package/src/{@types → static}/Attributes.ts

@@ -11,13 +11,12 @@
     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 type TypeAttributes = {
     xmlns: string 
     id: string

package/src/{@types → static}/Event.ts

@@ -11,20 +11,20 @@
     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 { TypeEventProperties as BaseTypeEventProperties } from "./Properties";
-import { TypeHVTEC } from "./HVTEC";
-import { TypePVTEC } from "./VTEC";
+import { TypeEventProperties as BaseTypeEventProperties } from "StaticTypes/Properties"
+import { TypeHVTEC } from "Types/HVTEC"
+import { TypeVTEC } from "Types/VTEC"
 
 export type TypeEvent = {
     type: string
     geometry: {
-        type: string
+        type: "Polygon" | "MultiPolygon"
         coordinates: number[][]
     }
     properties: {
@@ -33,6 +33,7 @@ export type TypeEvent = {
         status: string
         issued: string
         expires: string
+        theme: string
         status_metadata?: {
             is_issued?: boolean
             is_updated?: boolean
@@ -46,7 +47,7 @@ export type TypeEvent = {
             tracking: string
             hash?: string
             header: string
-            vtec?: TypePVTEC | null
+            vtec?: TypeVTEC | null
             hvtec?: TypeHVTEC[] | null
             nodes?: {
                 id?: string | number

package/src/{@types → static}/Properties.ts

@@ -11,17 +11,26 @@
     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 { TypeAttributes } from "./Attributes";
+import { TypeAttributes } from "StaticTypes/Attributes"
+
+export type TypeCities = { 
+    name: string
+    state: string
+    county: string
+    population: number
+}
     
 export type TypeEventProperties = {
     locations: string
     locations_array: string[]
+    regions: string[]
+    regions_string: string
     description: string
     attributes?: TypeAttributes
     geocode: {
@@ -31,6 +40,10 @@ export type TypeEventProperties = {
         }
         organization: string
         ugc: string[]
+        census?: {
+            population?: number
+            cities?: TypeCities[]
+        }
         polygon: string
         polygon_generated: boolean
     }
@@ -42,6 +55,7 @@ export type TypeEventProperties = {
         impacts: string
         estimated_hail_size: string
         estimated_wind_gusts: string
+        direction: string
         damage_threat: string
         tornado_threat: string
         flood_threat: string

package/src/{@types → static}/Stanza.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/tasks/CreateTasks.ts

@@ -0,0 +1,116 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeEvent } from "StaticTypes/Event"
+import { TypeActions } from "Types/Actions"
+import { Bootstrap } from "@Bootstrap"
+import { SetDebug } from "@Utilities/SetDebug"
+import { GetMatched } from "@Utilities/GetMatched"
+import { GetStringText } from "@Utilities/GetStringText"
+import { GetCleanedEvent } from "@Building/GetCleanedEvent"
+import { GenerateAudioMessage } from "@Audio/GenerateAudioMessage"
+import { TaskGenerateText } from "@Tasks/TaskGenerateText"
+import { TaskGenerateJSON } from "@Tasks/TaskGenerateJSON"
+import { TaskSendNTFY } from "@Tasks/TaskSendNTFY"
+import { TaskSendWebhook } from "@Tasks/TaskSendWebhook"
+import { GenerateGraphic } from "@Image/GenerateGraphic"
+import { QueueManager } from "@Utilities/QueueManager"
+
+const Webhooks = new QueueManager({ Concurrency: 1 });
+const NTFY = new QueueManager({ Concurrency: 5 });
+
+export const CreateTasks = async (events: TypeEvent[]): Promise<void> => {
+    
+    const settings = Bootstrap.Settings as TypeSettings;
+    const { ActionSettings, GlobalSettings, NotifyServer } = settings;
+    const actions = ActionSettings as TypeActions[];
+    for (const event of events) {
+        const tick = performance.now()
+        const { properties } = event;
+        const isActioning = Array.isArray(actions) && actions.length > 0;
+        if (!isActioning) { continue }
+        for (const action of actions) {
+            const { Events, Webhook, NotificationServer, Uploads } = action;
+            const isValidAction = GetMatched({ Strings: Events, String: properties.event });
+       
+            if ((Events.length == 0 || isValidAction)) {
+                const a = performance.now();
+                const [audio, text, json, image] = await Promise.all([
+                    Uploads?.AUDIO && GlobalSettings?.ArchiveSettings?.AudioDirectory ? GenerateAudioMessage({
+                        Directory: GlobalSettings?.ArchiveSettings?.AudioDirectory + `/${properties?.regions_string ?? `MC`}`,
+                        Title: (`${properties.event}_${properties.metadata.tracking}`).replace(/[\\:*?"<>|]/g, "_").replace(/\s+/g, " ").trim(),
+                        Message: properties.description,
+                        Header: properties.metadata.header
+                    }).then((result) => { return result; }) : Promise.resolve(null),
+
+                    Uploads?.TEXT && GlobalSettings?.ArchiveSettings?.TextDirectory ? TaskGenerateText({
+                        String: properties.metadata.raw,
+                        Directory: GlobalSettings?.ArchiveSettings?.TextDirectory + `/${properties?.regions_string ?? `MC`}`,
+                        Filename: (`${properties.event}_${properties.metadata.tracking}.txt`).replace(/[\\:*?"<>|]/g, "_").replace(/\s+/g, " ").trim()
+                    }).then((result) => { return result; }) : Promise.resolve(null),
+
+                    Uploads?.JSON && GlobalSettings?.ArchiveSettings?.JSONDirectory ? TaskGenerateJSON({
+                        String: JSON.stringify(GetCleanedEvent(event), null, 2),
+                        Directory: GlobalSettings?.ArchiveSettings?.JSONDirectory + `/${properties?.regions_string ?? `MC`}`,
+                        Filename: (`${properties.event}_${properties.metadata.tracking}.json`).replace(/[\\:*?"<>|]/g, "_").replace(/\s+/g, " ").trim()
+                    }).then((result) => { return result; }) : Promise.resolve(null),
+
+                    Uploads?.IMAGE && GlobalSettings?.ArchiveSettings?.ImageDirectory ? GenerateGraphic({
+                        Event: event,
+                        File: {
+                            Directory: GlobalSettings?.ArchiveSettings?.ImageDirectory + `/${properties?.regions_string ?? `MC`}`,
+                            Name: (`${properties.event}_${properties.metadata.tracking}.png`).replace(/[\\:*?"<>|]/g, "_").replace(/\s+/g, " ").trim()
+                        }
+                    }).then((result) => { return result; }) : Promise.resolve(null)
+                ]);
+           
+
+                SetDebug({ Title: `Tasks/Generative`, Message: `${Math.round(performance.now() - a)}ms` })
+
+                const b = performance.now();
+                await Promise.all([
+                    NotificationServer?.Enabled && NotifyServer?.Enabled && NotificationServer?.Topic ? NTFY.enqueue(() => TaskSendNTFY({
+                        Event: event,
+                        Priority: NotificationServer?.Priority ?? 5,
+                        Body: GetStringText(event),
+                        Topic: NotificationServer?.Topic
+                    })) : Promise.resolve(null),
+                    Webhook?.Enabled && Webhook?.Destination ? Webhooks.enqueue(() => TaskSendWebhook({
+                        Event: event,
+                        Webhook: {
+                            Enabled: Webhook?.Enabled,
+                            Destination: Webhook?.Destination,
+                            Message: Webhook?.Message,
+                            Title: Webhook?.Title,
+                            Ratelimit: Webhook?.Ratelimit
+                        },
+                        Attachments: {
+                            Image: image,
+                            Text: text,
+                            Audio: audio,
+                            Json: json
+                        }
+                    })) : Promise.resolve(null)
+                ]);
+                SetDebug({ Title: `Tasks/Send`, Message: `${Math.round(performance.now() - b)}ms` })
+            }
+        }
+        SetDebug({ Title: `Tasks/CompletedEventTask`, Message: `${Math.round(performance.now() - tick)}ms` })
+    }
+}

package/src/tasks/TaskGenerateJSON.ts

@@ -0,0 +1,34 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { mkdir, writeFile } from "fs/promises"
+
+interface TaskGenerateJSONOptions {
+    String: string;
+    Directory: string;
+    Filename: string;
+}
+
+export const TaskGenerateJSON = async function({ String, Directory, Filename }: TaskGenerateJSONOptions): Promise<string> { 
+    if (Directory) { 
+        await mkdir(Directory, { recursive: true });
+        await writeFile(Directory + "/" + Filename, `${String}${"\n".repeat(5)}`);
+    }
+    return String;
+}

package/src/tasks/TaskGenerateText.ts

@@ -0,0 +1,34 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { mkdir, appendFile } from "fs/promises"
+
+interface TaskGenerateTextOptions {
+    String: string;
+    Directory: string;
+    Filename: string;
+}
+
+export const TaskGenerateText = async function({ String, Directory, Filename }: TaskGenerateTextOptions): Promise<string> { 
+    if (Directory) { 
+        await mkdir(Directory, { recursive: true });
+        await appendFile(Directory + "/" + Filename, `${String}${"\n".repeat(5)}`);
+    }
+    return String;
+}

package/src/tasks/TaskSendNTFY.ts

@@ -0,0 +1,95 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeEvent } from "StaticTypes/Event"
+import { Bootstrap } from "@Bootstrap"
+import { CreateHttp } from "@Utilities/CreateHttp";
+import { SetDebug } from "@Utilities/SetDebug";
+
+interface TaskSendNTFYOptions {
+    Event: TypeEvent
+    Priority: string | number
+    Body: string
+    Topic: string
+}
+
+export const TaskSendNTFY = async function({ Event, Priority, Body, Topic }: TaskSendNTFYOptions): Promise<void> { 
+    const { properties } = Event;
+
+    const configurations = Bootstrap.Settings.NotifyServer;
+    const authentication = configurations?.Credentials?.Username && configurations?.Credentials?.Password ? { 
+        Username: configurations.Credentials.Username, 
+        Password: configurations.Credentials.Password 
+    } : undefined;
+
+    const image = configurations?.MediaStorage?.IMAGE ? { link: `${configurations?.MediaStorage?.IMAGE}/${properties.regions_string}//${properties?.event}_${properties?.metadata?.tracking}.png` } : undefined;
+    const SPCGraphic = properties?.metadata?.attachments?.find(a => a.name === "Image: SPC Graphic") 
+        
+    const buttons = [
+        ...(configurations?.MediaStorage?.AUDIO ? [{
+            "action": "view",
+            "label": "View Audio",
+            "url": `${configurations.MediaStorage.AUDIO}/${properties.regions_string}/${properties.event}_${properties.metadata.tracking}.wav`,
+        }] : []),
+        ...(configurations?.MediaStorage?.TEXT ? [{
+            "action": "view",
+            "label": "View Text",
+            "url": `${configurations.MediaStorage.TEXT}/${properties.regions_string}/${properties.event}_${properties.metadata.tracking}.txt`,
+        }] : []),
+        ...(SPCGraphic ? [{
+            "action": "view",
+            "label": "View Graphic",
+            "url": SPCGraphic.link,
+        }] : []),
+        ... [{
+            "action": "copy",
+            "label": "Copy Card",
+            "value": `${properties.event} (${properties.status})\n${Body}\nTags: ${properties.parameters.tags?.join(",") ?? "N/A"}`
+        }]
+    ];
+
+    const headers = {
+        "Title": `${properties.event} (${properties.status})`,
+        "Tags": properties.parameters.tags?.join(",") ?? "N/A",
+        "Priority": Priority ?? "5",
+        ...(image && { "Attach": image.link }),
+        ...(buttons.length > 0 && { "Actions": JSON.stringify(buttons) }),
+    };
+
+    const post = async (topic: string) => {
+        const response = await CreateHttp({
+            URL: `${configurations?.Server?.replace(/\/$/, "")}/${topic}`,
+            Timeout: 15_000,
+            Method: "PUT",
+            ...(authentication && { Auth: authentication }),
+            Headers: headers,
+            Body: Body
+        })
+        if (response.error) { 
+            SetDebug({ Title: `Tasks/NTFY`, Message: `Failed to send notification to topic "${topic}": ${response.message}` })
+        }
+    }
+
+    const topics = [
+        Topic,
+        ...(properties.metadata.filtered_proximity ? [`${Topic}-LOCAL`] : []),
+    ];
+
+    await Promise.all([...new Set(topics)].map(post));
+}

package/src/tasks/TaskSendWebhook.ts

@@ -0,0 +1,107 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeEvent } from "StaticTypes/Event"
+import { CreateHttp } from "@Utilities/CreateHttp";
+import { SetTimeoutAction } from "@Utilities/SetTimeoutAction";
+import { GetEmbededText } from "@Utilities/GetEmbededText";
+import { readFile } from "fs/promises"
+
+interface TaskSendWebhookOptions {
+    Event: TypeEvent;
+    Webhook: {
+        Enabled: boolean;
+        Destination: string;
+        Message: string;
+        Title: string;
+        Ratelimit: number;
+    };
+    Attachments: {
+        Image?: string;
+        Text?: string;
+        Audio?: string;
+        Json?: string;
+    }
+}
+
+export const TaskSendWebhook = async function({ Event, Webhook, Attachments }: TaskSendWebhookOptions): Promise<void> { 
+    const { properties } = Event;
+    const isRatelimited = SetTimeoutAction({
+        Identifier: Webhook.Destination,
+        Interval: (Webhook.Ratelimit ?? 2) * 2,
+        Max: (Webhook.Ratelimit ?? 2), 
+        AddTime: true 
+    })
+    if (isRatelimited.Limited) { return }
+    const newForm = new FormData();
+    const newEmbed = {
+        title: `${properties.event} (${properties.status})`,
+        description: GetEmbededText(Event),
+        fields: [] as { name: string, value: string }[],
+        color: 16711680,
+        thumbnail: Attachments?.Image ? { url: `attachment://${properties.event}_${properties.status}_${properties.metadata.tracking}.png` } : undefined,
+        timestamp: new Date().toISOString(),
+        footer: { text: Webhook.Title ?? `AtmosphericX` }
+    };
+    if (properties.description && !properties.status_metadata.is_expired) {
+        const description = properties.description.length > 900
+            ? properties.description.substring(0, 900) + "\n\n[Message truncated due to length]"
+            : properties.description;
+        newEmbed.fields.push({
+            name: "Description", 
+            value: description ? '```' + '\n' + description.split('\n').map(l => l.trim()).filter(Boolean).join('\n') + '\n' + '```' : ""
+        });
+    }
+    if (properties.metadata.attachments?.length > 0) {
+        const attachments = properties.metadata.attachments.slice(0, 5);
+        newEmbed.fields.push({
+            name: "Attachments", 
+            value: attachments.map(attachment => `- [${attachment.name.length > 45 ? attachment.name.substring(0, 45) + '...' : attachment.name}](${attachment.link})`).join('\n')
+        });
+    }
+
+    if (Attachments?.Image) {
+        const file = await readFile(Attachments.Image);
+        newForm.append("attachmentImage", new Blob([Buffer.from(file)], {type: "image/png"}), `${properties.event}_${properties.status}_${properties.metadata.tracking}.png`)
+    }
+
+    if (Attachments?.Text) {
+        newForm.append("attachmentText", new Blob([Buffer.from(Attachments.Text)], {type: "application/text"}), `${properties.event}_${properties.status}_${properties.metadata.tracking}.txt`)
+    }
+    if (Attachments?.Json) {
+        newForm.append("attachmentJson", new Blob([Buffer.from(Attachments.Json)], {type: "application/json"}), `${properties.event}_${properties.status}_${properties.metadata.tracking}.json`)
+    }
+    if (Attachments?.Audio) {
+        const file = await readFile(Attachments.Audio);
+        newForm.append("attachmentAudio", new Blob([Buffer.from(file)], {type: "application/wav"}), `${properties.event}_${properties.status}_${properties.metadata.tracking}.wav`)
+    }
+
+    newForm.append("payload_json", JSON.stringify({ 
+        username: Webhook.Title ?? `AtmosphericX`,
+        content: Webhook.Message ?? "",
+        embeds: [newEmbed]
+    }));
+
+    await CreateHttp({
+        URL: Webhook.Destination,
+        Timeout: 15e3,
+        Method: `POST`,
+        Body: newForm
+    })
+}