@atmosx/event-product-parser 3.0.4 → 3.0.7

package/src/{@building/building.polygon.ts → building/GetEventNodes.ts}

@@ -11,17 +11,16 @@
     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/type.event"
-import { getEventGeometry } from "./building.geometry"
-import { bootstrap } from "../bootstrap"
-import { getShapeNearestPoint } from "../@modules/@utilities/utilities.getShapeNearestPoint"
+import { TypeEvent } from "StaticTypes/Event"
+import { Bootstrap } from "@Bootstrap"
+import { GetEventGeometry } from "@Building/GetEventGeometry"
+import { GetShapeNearestPoint } from "@Utilities/GetShapeNearestPoint"
 
 interface GetEventNodesResponse { 
     nodes: {
@@ -36,32 +35,37 @@ interface GetEventNodesResponse {
     updated: number
 }
 
-export const getEventNodes = async (event: TypeEvent): Promise<GetEventNodesResponse> => {
-    const metadata = { nodes: [], proximity: false, filtered: false }
-    const geometry = await getEventGeometry(event);
+export const GetEventNodes = async (event: TypeEvent): Promise<GetEventNodesResponse> => {
+    const nodes = Bootstrap.Cache.Nodes.features;
+    if (!nodes || nodes.length === 0) {
+        return { nodes: [], filtered: false, updated: Date.now() };
+    }
+    const metadata = { nodes: [] as GetEventNodesResponse['nodes'], proximity: false, filtered: false };
+    const geometry = await GetEventGeometry({ Event: event });;
     if (!geometry || !geometry.coordinates) {
         return { nodes: [], filtered: false, updated: Date.now() }
     }
-    const nodes = bootstrap.cache.nodes.features;
     for (const node of nodes) {
-        const [longitude, latitude] = node.geometry.coordinates;
-        const getPoint = getShapeNearestPoint(geometry.coordinates, [longitude, latitude])
-        const miles = getPoint.distance ?? null;
-        const kilometers = Number((miles * 1.609344).toFixed(3));
+        const [longitude, latitude] = (node?.geometry?.coordinates ?? []) as [number, number];
+        
+        const getPoint = GetShapeNearestPoint({ Coordinates: geometry.coordinates, Point: [longitude, latitude] });
+        const miles = getPoint.Distance ?? null;
+        const kilometers = miles != null ? Number((miles * 1.609344).toFixed(3)) : null;
 
         const info = {
             id: node.properties?.identifier,
-            coordinates: [longitude, latitude],
-            nearest: getPoint.point,
+            coordinates: [longitude, latitude] as [number, number],
+            nearest: getPoint.Point as [number, number],
             miles,
             kilometers,
-            proximity: getPoint.proximity
-        }
-        metadata.nodes.push(info)
-        if (bootstrap.settings.GlobalSettings.EventFiltering.NodeLocationFiltering && miles < bootstrap.settings.GlobalSettings.NodeMinDistance) {
-            metadata.proximity = true;
+            proximity: false
+        };
+        
+        if (miles != null && (miles < Bootstrap.Settings.GlobalSettings.NodeMaxDistance)) {
             info.proximity = true;
+            metadata.proximity = true;
         }
+        metadata.nodes.push(info);
     }
     return {
         nodes: metadata.nodes,

package/src/{@building/building.office.ts → building/GetEventOffice.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 { TypeAttributes } from "../@types/types.attributes";
-import { TypePVTEC } from "../@types/types.pvtec";
-import { officeICAOs } from "../@dictionaries/dictionaries.officeICAOs";
+import { TypeAttributes } from "StaticTypes/Attributes"
+import { TypeVTEC } from "Types/VTEC"
+import { EnumICAO } from "@Enums/ICAO"
 
 interface GetOfficeOptions { 
-    attributes: TypeAttributes
-    organization: string
-    pVtec: TypePVTEC
+    Attributes: TypeAttributes
+    Organization: string
+    VTEC: TypeVTEC
 }
 
 interface GetOfficeResponse { 
@@ -32,12 +32,12 @@ interface GetOfficeResponse {
     name: string | null
 }
 
-export const getEventOffice = (options: GetOfficeOptions): GetOfficeResponse => {
-    const office = options.pVtec != null 
-        ? options.pVtec?.tracking?.split(`-`)[0] : (options.attributes?.cccc || 
-            (options.organization != null ? 
-                (Array.isArray(options.organization) ? options.organization?.[0] : options.organization) 
+export const GetEventOffice = ({ Attributes, Organization, VTEC }: GetOfficeOptions): GetOfficeResponse => {
+    const office = VTEC != null 
+        ? VTEC?.Tracking?.split(`.`)[0] : (Attributes?.cccc ??
+            (Organization != null ? 
+                (Array.isArray(Organization) ? Organization?.[0] : Organization) 
         : null));
-    const name = officeICAOs?.[office] ?? null;
+    const name = EnumICAO?.[office] ?? null;
     return { office, name };
 }

package/src/building/GetEventProperties.ts

@@ -0,0 +1,105 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeEventProperties } from "StaticTypes/Properties"
+import { TypeAttributes } from "StaticTypes/Attributes"
+import { TypeUGC } from "Types/UGC"
+import { TypeVTEC } from "Types/VTEC"
+import { EnumExpressions } from "@Enums/Expressions"
+import { GetDescriptionFromProduct } from "@ParsingText/GetDescriptionFromProduct"
+import { GetPolygonFromProduct } from "@ParsingText/GetPolygonFromProduct"
+import { GetTextFromProduct } from "@ParsingText/GetTextFromProduct"
+import { GetEventOffice } from "@Building/GetEventOffice"
+import { GetEventTags } from "@Building/GetEventTags"
+import { GetEventDirection } from "@Building/GetEventDirection"
+
+interface GetEventPropertiesOptions { 
+    Message: string
+    Attributes: TypeAttributes
+    UGC?: TypeUGC
+    VTEC?: TypeVTEC
+}
+
+export const GetEventProperties = ({ Message, Attributes, UGC, VTEC }: GetEventPropertiesOptions): TypeEventProperties => {
+    const organization = Message.match(EnumExpressions.wmo)?.[0] ?? null
+    const polygons = GetPolygonFromProduct(Message)
+    const properties = {
+        locations: UGC?.Locations?.join(`; `) ?? null,
+        locations_array: UGC?.Locations ?? [],
+        regions: [...new Set(
+            UGC?.Zones
+            ?.map((location: string) => location.match(/^([A-Z]{2})[CZ](\d{3})$/)?.[1])
+            .filter(Boolean) ?? []
+        )],
+        regions_string: (() => {
+            const abbrs = [...new Set(UGC?.Zones?.map((l: string) => l.match(/^([A-Z]{2})[CZ](\d{3})$/)?.[1]).filter(Boolean) ?? [])];
+            return abbrs.length ? abbrs.join(`-`) : null;
+        })(),
+        description: GetDescriptionFromProduct({ Message: Message, Handle: VTEC?.Raw ?? null }),
+        attributes: Attributes,
+        geocode: {
+            office: GetEventOffice({ Attributes: Attributes, Organization: organization, VTEC: VTEC }),
+            organization: organization,
+            ugc: UGC?.Zones ?? [],
+            polygon: polygons.length > 0 ? Buffer.from(JSON.stringify([polygons])).toString('base64') : null,
+            polygon_generated: polygons.length > 0 ? true : false
+        },
+        parameters: {
+            tags: GetEventTags(Message),
+            instructions: GetTextFromProduct({ Message: Message, Find: [`For your protection`, `do not`, `use extreme caution`], Append: `...`, Removal: [`.`]})  ?? null,
+            source: GetTextFromProduct({ Message: Message, Find: [`SOURCE...`], Removal: [`.`]}) ?? null,
+            hazards: GetTextFromProduct({ Message: Message, Find: [`HAZARD...`], Removal: [`.`]}) ?? null,
+            impacts: GetTextFromProduct({ Message: Message, Find: [`IMPACT...`], Removal: [`.`]}) ?? null,
+            estimated_hail_size: GetTextFromProduct({ Message: Message, Find: [`MAX HAIL SIZE...`, `HAIL...`], Removal: ['in']}) ?? null,
+            estimated_wind_gusts: GetTextFromProduct({ Message: Message, Find: [`MAX WIND GUST...`, `WIND...`]}) ?? null,
+            direction: GetEventDirection(Message) ?? null,
+            damage_threat: GetTextFromProduct({ Message: Message, Find: [`DAMAGE THREAT...`], Removal: []}) ?? null,
+            tornado_threat: GetTextFromProduct({ Message: Message, Find: [`TORNADO...`, `WATERSPOUT...`] }) ?? null,
+            flood_threat: GetTextFromProduct({ Message: Message, Find: [`FLASH FLOOD...`]}) ?? null,
+            wind_threat: GetTextFromProduct({ Message: Message, Find: [`WIND THREAT...`]}) ?? null,
+            hail_threat: GetTextFromProduct({ Message: Message, Find: [`HAIL THREAT...`], Removal: []}) ?? null,
+        },
+        discussion_parameters: {
+            discussion_number: GetTextFromProduct({ Message: Message, Find: [`Mesoscale Discussion `], Removal: [`Mesoscale Discussion`, `Number`, `...`] })?.toString()?.padStart(4, "0") ?? null,
+            discussion_concerning: GetTextFromProduct({ Message: Message, Find: [`Concerning...`] }) ?? null,
+            discussion_max_tornado: GetTextFromProduct({ Message: Message, Find: [`MOST PROBABLE PEAK TORNADO INTENSITY...`] }) ?? null,
+            discussion_max_hail: GetTextFromProduct({ Message: Message, Find: [`MOST PROBABLE PEAK HAIL SIZE...`] }) ?? null,
+            discussion_max_wind: GetTextFromProduct({ Message: Message, Find: [`MOST PROBABLE PEAK WIND GUST...`] }) ?? null,
+            discussion_watch_issuance: GetTextFromProduct({ Message: Message, Find: [`Probability of Watch Issuance...`], Removal: [`percent`]}) ?? null,
+        },
+        watch_parameters: {
+            watch_number: VTEC?.Watch ? ( GetTextFromProduct({ Message: Message, Find: [`ITIES FOR`, `UPDATE FOR`, `Watch Number `], Removal: [`%`, `<`, `:`] })?.replace(/(WT|WS|)/g, '')?.trim()?.toString()?.padStart(4, "0") ?? VTEC?.Tracking?.slice(-4)?.toString()?.padStart(4, "0") ?? null) : null,
+            watch_type: Message.includes(`TORNADO WATCH`) ? `Tornado` : Message.includes(`SEVERE`) ? `Severe` : null,
+            additional_tornadoes_probability: GetTextFromProduct({ Message: Message, Find: [`PROB OF 2 OR MORE TORNADOES`], Removal: [`%`, `<`, `:`] }) ?? null,
+            strong_tornadoes_probability: GetTextFromProduct({ Message: Message, Find: [`PROB OF 1 OR MORE STRONG /EF2-EF5/ TORNADOES`], Removal: [`%`, `<`, `:`] }) ?? null,
+            severe_wind_probability: GetTextFromProduct({ Message: Message, Find: [`PROB OF 10 OR MORE SEVERE WIND EVENTS`], Removal: [`%`, `<`, `:`] }) ?? null,
+            severe_hail_probability: GetTextFromProduct({ Message: Message, Find: [`PROB OF 10 OR MORE SEVERE HAIL EVENTS`], Removal: [`%`, `<`, `:`] }) ?? null,
+            hail_2in_probability: GetTextFromProduct({ Message: Message, Find: [`PROB OF 1 OR MORE HAIL EVENTS >= 2 INCHES`], Removal: [`%`, `<`, `:`] }) ?? null,
+            combined_hail_wind_probability: GetTextFromProduct({ Message: Message, Find: [`PROB OF 6 OR MORE COMBINED SEVERE HAIL/WIND EVENTS`], Removal: [`%`, `<`, `:`] }) ?? null,
+            max_hail_in: GetTextFromProduct({ Message: Message, Find: [`MAX HAIL /INCHES/`], Removal: [`%`, `<`, `:`] }) ?? null,
+            max_wind_surface:  GetTextFromProduct({ Message: Message, Find: [`MAX WIND GUSTS SURFACE /KNOTS/`], Removal: [`%`, `<`, `:`] }) ?? null,
+            max_tops_x100feet:  GetTextFromProduct({ Message: Message, Find: [`MAX TOPS /X 100 FEET/`], Removal: [`%`, `<`, `:`] }) ?? null,
+            pds_watch: (GetTextFromProduct({ Message: Message, Find: [`PARTICULARLY DANGEROUS SITUATION`], Removal: [`%`, `<`, `:`] }) === `YES` ? true : null)
+        }
+    }
+    if (isNaN(Number(properties.watch_parameters.watch_number))) {
+        properties.watch_parameters.watch_number = null
+    }
+    return properties;
+}

package/src/{@building/building.signature.ts → building/GetEventSignature.ts}

@@ -11,30 +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 { TypeEvent } from "../@types/type.event";
-import { statusCorrelationText } from "../@dictionaries/dictionaries.statusCorrelationText";
-import { eventCancelMessages } from "../@dictionaries/dictionaries.eventCancelMessages";
-import { testSignatures} from "../@dictionaries/dictionaries.testSignatures"
-import { eventProducts } from "../@dictionaries/dictionaries.eventProducts";
-import { hailStrings } from "../@dictionaries/dictionaries.hailStrings"
+import { TypeEvent } from "StaticTypes/Event"
+import { EnumCorrelations } from "@Enums/Correlations"
+import { EnumCancellation } from "@Enums/Cancellation"
+import { EnumTesting} from "@Enums/Testing"
+import { EnumProducts } from "@Enums/Products"
+import { EnumHail } from "@Enums/Hail"
 
-
-export const getEventSignature = (event: TypeEvent): TypeEvent => {
+export const GetEventSignature = (event: TypeEvent): TypeEvent => {
     const properties = event?.properties;
     const vtec = event?.properties?.metadata?.vtec
-    const status = statusCorrelationText
+    const status = EnumCorrelations
         .find((c: { type: string }) => c.type === properties?.status);
-    const csig = eventCancelMessages.find(sig => properties.description.toLowerCase().includes(sig.toLowerCase()));
+    const csig = EnumCancellation.find(sig => properties.description.toLowerCase().includes(sig.toLowerCase()));
     properties.status_metadata = { ...properties.status_metadata, is_issued: true, is_test: false};
 
-    if (properties.parameters.estimated_hail_size) { 
-        properties.parameters.estimated_hail_size += ` (${hailStrings[properties.parameters.estimated_hail_size] ?? '--'})`
+    if (properties?.parameters?.estimated_hail_size) { 
+        properties.parameters.estimated_hail_size += ` (${EnumHail[properties?.parameters?.estimated_hail_size] ?? '--'})`
     }
 
     if (status) { 
@@ -45,9 +44,9 @@ export const getEventSignature = (event: TypeEvent): TypeEvent => {
         properties.status_metadata = { ...properties.status_metadata, is_expired: true };
     }
     
-    const getProduct = vtec?.vtec?.split(`.`)[0]?.replace(`/`, ``)
-    const isTestProduct = eventProducts[getProduct] == `Test Product`
-    if (isTestProduct || testSignatures.some(sig => properties.description?.toLowerCase().includes(sig.toLowerCase()) || properties?.parameters?.instructions?.toLowerCase().includes(sig.toLowerCase()))) {
+    const getProduct = vtec?.Raw?.split(`.`)[0]?.replace(`/`, ``)
+    const isTestProduct = EnumProducts[getProduct] == `Test Product`
+    if (isTestProduct || EnumTesting.some(sig => properties.description?.toLowerCase().includes(sig.toLowerCase()) ?? properties?.parameters?.instructions?.toLowerCase().includes(sig.toLowerCase()))) {
         properties.status_metadata = { ...properties.status_metadata, is_test: true }
     }    
     

package/src/{@core/core.createListener.ts → building/GetEventTags.ts}

@@ -11,14 +11,19 @@
     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 { setListener } from "../@modules/@utilities/utilities.setListener";
+import { EnumTags } from "@Enums/Tags"
 
-export const createListener = (event: string, callback: () => void) => {
-    setListener({event, callback})
-}
+export const GetEventTags = (message: string): string[] => {
+    if (!message) return [];
+    return [...new Set(Object.values(EnumTags)
+        .flat()
+        .filter(({ match }) => match.test(message))
+        .map(({ tag }) => tag)
+    )];
+};

package/src/building/GetEventTheme.ts

@@ -0,0 +1,26 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { EnumThemes } from "@Enums/Themes"
+import { GetMatched } from "@Utilities/GetMatched";
+
+export const GetEventTheme = (Event: string): string => {
+    return Bootstrap.Settings.GlobalSettings.Themes.find(theme => GetMatched({Strings: [theme.Event], String: Event}))?.RGB ?? EnumThemes.find(theme => theme.Event === `Default`)?.RGB ?? `rgb(56, 72, 88)`;
+};

package/src/building/GetEventTracking.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 { TypeAttributes } from "StaticTypes/Attributes"
+import { TypeEventProperties } from "StaticTypes/Properties"
+import { TypeStanzaCompiled } from "Types/StanzaCompiled"
+import { TypeVTEC } from "Types/VTEC"
+
+interface GetTrackingOptions { 
+    Type: `RAW` | `VTEC` | `API`
+    Stanza?: TypeStanzaCompiled
+    Attributes?: TypeAttributes
+    Properties?: TypeEventProperties
+    WMO?: {
+        Identifier: string
+        ID: string
+    }
+    VTEC?: TypeVTEC
+}
+
+export const GetEventTracking = ({ Type, Stanza, Attributes, Properties, WMO, VTEC }: GetTrackingOptions): string => {
+    if (Type === `RAW`) { 
+        const getWatchNumber = Properties?.watch_parameters?.watch_number ?? null
+        if (getWatchNumber) {
+            return `${Properties.geocode.office.office}.${Stanza.Type.Prefix}.A.${getWatchNumber}`
+        }
+        return `${Properties.geocode.office.office}.${Attributes.ttaaii}.${Attributes.id.slice(-4).replace(`.`, ``) ?? '0'}`
+    }
+    if (Type === `VTEC`) {
+        return VTEC?.Tracking;
+    }
+    if (Type === `API`) {
+        if (VTEC) { 
+            const vtecValue = Array.isArray(VTEC) 
+                ? VTEC[0].vtec : VTEC?.Raw;
+            const splitVTEC = vtecValue.split('.');
+            return `${splitVTEC[2]}.${splitVTEC[3]}.${splitVTEC[4]}.${splitVTEC[5]}`;
+        }
+        const wmoMatch = WMO?.Identifier?.match(/([A-Z]{4}\d{2})\s+([A-Z]{4})/);
+        const station = wmoMatch?.[2] ?? '---';
+        if (WMO?.ID) {
+            const idMatch = WMO?.ID.match(/([a-f0-9]+)\.(\d+)\.(\d+)$/);
+            return `${station}.${idMatch?.[0]?.replace(/\./g, '') ?? '---'}`;
+        }
+        const id = wmoMatch?.[1] ?? '---';
+        return `${station}.${id?.replace(/\./g, '') ?? '---'}`;
+    }
+}

package/src/components/audio/GenerateAudioMessage.ts

@@ -0,0 +1,149 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { Bootstrap } from "@Bootstrap"
+import { GetWavPCM16 } from "@AudioComponents/GetWavPCM16"
+import { GetSampledPCM16 } from "@AudioComponents/GetSampledPCM16"
+import { SetRadioEffect } from "@AudioComponents/SetRadioEffect"
+import { SetSameHeader } from "@AudioComponents/SetSameHeader"
+import { SetAttentionTone } from "@AudioComponents/SetAttentionTone"
+import { GetMergedPCM16 } from "@AudioComponents/GetMergedPCM16"
+import { SetNoise } from "@AudioComponents/SetNoise"
+import { GetPCM16 } from "@AudioComponents/GetPCM16"
+import { GetTTS } from "@AudioComponents/GetTTS"
+import { GetCleanDescription } from "@AudioComponents/GetCleanDescription"
+import { SetWarning } from "@Utilities/SetWarning"
+import { SetDebug } from "@Utilities/SetDebug"
+import { join } from "path"
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs"
+import { execSync } from "child_process"
+import { platform } from "os"
+
+interface GenerateAudioMessageOptions { 
+    Message: string
+    Header: string
+    Directory?: string
+    Title: string
+}
+
+export const GenerateAudioMessage = async ({ Message, Directory, Header, Title }: GenerateAudioMessageOptions): Promise<string> => {
+    const tick = performance.now()
+    const settings = Bootstrap.Settings as TypeSettings;
+    const prefix = settings.GlobalSettings.ArchiveSettings.AudioToneout;
+    let title = (Title ?? `${Math.random().toString(36).substring(2, 15)}-${Header.replace(/[^a-zA-Z0-9]/g, '')}`).replace(/[\\:*?"<>|]/g, "_").replace(/\s+/g, " ").trim();
+    if (!Message || !Header) {
+        SetWarning({
+            Title: `Audio`,
+            Message: `Message and header are required to generate an audio message.`
+        })
+        return null;
+    }
+    let buffTTS: Buffer;
+    let buffRadio: any;
+    let buffFull: any[] = [];
+
+    if (!Directory) {
+        SetWarning({
+            Title: `Audio`,
+            Message: `Audio directory is not set in the settings. Please set it to generate audio messages.`
+        });
+        return null;
+    }
+    
+    if (!existsSync(Directory)) {
+        mkdirSync(Directory, { recursive: true });
+    }
+    const tmpTTS = join(Directory, `/${title}-tts.wav`)
+    const outTTS = join(Directory, `/${title}.wav`)
+    const vPlatform = platform();
+
+    if (vPlatform === 'darwin') {
+        SetWarning({
+            Title: `Audio`,
+            Message: `Audio tone generation is not supported on macOS.`
+        });
+        return null
+    }
+
+
+    await new Promise<void>((resolve, reject) => {
+        const tMsg = GetCleanDescription(Message)
+        GetTTS({Text: tMsg, OutputPath: tmpTTS}).then(() => {
+            resolve();
+        });
+    });
+    if (!existsSync(tmpTTS)) {
+        return null;
+    }
+    buffTTS = readFileSync(tmpTTS);
+    const vWav = GetWavPCM16(buffTTS);
+    const vSamples = GetSampledPCM16({Int16: vWav.Samples, OriginalRate: vWav.SampleRate, TargetRate: 8000})
+    const vRadio = SetRadioEffect({Int16: vSamples, SampleRate: 8000});
+
+    if (existsSync(prefix)) {
+        let tBuffer = readFileSync(prefix);
+        let tWav = GetWavPCM16(tBuffer);
+
+        if (tWav == null) {
+            try {
+                const converted = join(Directory, `/${title}-tts-fixed.wav`)
+                execSync(`ffmpeg -y -i "${prefix}" -ar 8000 -ac 1 -sample_fmt s16 "${converted}"`, { stdio: 'ignore' })
+                if (existsSync(converted)) {
+                    tBuffer = readFileSync(converted)
+                    tWav = GetWavPCM16(tBuffer)
+                    try { unlinkSync(converted) } catch {}
+                }
+            } catch (e) {}
+        }
+
+        if (tWav == null) {
+            SetWarning({ 
+                Title: `EAS`, 
+                Message: `Intro tone isn't a valid .WAV file or isn't in PCM 16-bit format. Converted attempt failed; please convert it then try again.` 
+            })
+            return null;
+        }
+
+        const tSamples = (tWav.SampleRate != 8000 ? GetSampledPCM16({Int16: tWav.Samples, OriginalRate: tWav.SampleRate, TargetRate: 8000}) : tWav.Samples)
+        buffRadio = SetRadioEffect({Int16: tSamples, SampleRate: 8000})
+    }
+
+    buffFull = buffRadio != null ? [buffRadio, new Int16Array(Math.floor(0.5 * 8000))] : [];
+    buffFull.push(
+        SetSameHeader({ VTEC: Header, Repeats: 3, SampleRate: 8000, PreMarkSec: 1.1, GapSec: 0.5 }),
+        new Int16Array(Math.floor(0.5 * 8000)),
+        SetAttentionTone({ MS: 8, SampleRate: 8000 }),
+        new Int16Array(Math.floor(0.5 * 8000)),
+        vRadio
+    )
+    for (let i = 0; i < 3; i++) {
+        buffFull.push(SetSameHeader({ VTEC: Header, Repeats: 1, SampleRate: 8000, PreMarkSec: 0.5, GapSec: 0.1 }))
+        buffFull.push(new Int16Array(Math.floor(0.5 * 8000)));
+    }
+    const aSamples = GetMergedPCM16(buffFull);
+    const aFinal = SetNoise({ Int16: aSamples, NoiseLevel: 0.002 });
+    const aBuffer = GetPCM16({ Samples: Array.from(aFinal).map(v => ({ value: v })), SampleRate: 8000 });
+    writeFileSync(outTTS, aBuffer)
+    try{ unlinkSync(tmpTTS) } catch {}
+    SetDebug({ Title: `GenerateEASMessage`, Message: `${Math.round(performance.now() - tick)}ms` })
+    return outTTS;
+}
+
+

package/src/components/audio/components/GetCleanDescription.ts

@@ -0,0 +1,91 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 const GetCleanDescription = (message: string): string => {
+    const patches: { regex: RegExp, replacement: string }[] = [
+        { regex: /\.{3,}/g, replacement: ". " },
+        { regex: /\bUTC\b/g, replacement: 'Coordinated Universal Time' },
+        { regex: /\bGMT\b/g, replacement: 'Greenwich Mean Time' },
+        { regex: /\bEST\b(?!\w)/g, replacement: 'Eastern Standard Time' },
+        { regex: /\bEDT\b(?!\w)/g, replacement: 'Eastern Daylight Time' },
+        { regex: /\bCST\b(?!\w)/g, replacement: 'Central Standard Time' },
+        { regex: /\bCDT\b(?!\w)/g, replacement: 'Central Daylight Time' },
+        { regex: /\bMST\b(?!\w)/g, replacement: 'Mountain Standard Time' },
+        { regex: /\bMDT\b(?!\w)/g, replacement: 'Mountain Daylight Time' },
+        { regex: /\bPST\b(?!\w)/g, replacement: 'Pacific Standard Time' },
+        { regex: /\bPDT\b(?!\w)/g, replacement: 'Pacific Daylight Time' },
+        { regex: /\bAKST\b(?!\w)/g, replacement: 'Alaska Standard Time' },
+        { regex: /\bAKDT\b(?!\w)/g, replacement: 'Alaska Daylight Time' },
+        { regex: /\bHST\b(?!\w)/g, replacement: 'Hawaii Standard Time' },
+        { regex: /\bHDT\b(?!\w)/g, replacement: 'Hawaii Daylight Time' },
+        { regex: /\bmph\b(?!\w)/g, replacement: 'miles per hour' },
+        { regex: /\bkm\/h\b(?!\w)/g, replacement: 'kilometers per hour' },
+        { regex: /\bkmh\b(?!\w)/g, replacement: 'kilometers per hour' },
+        { regex: /\bkt\b(?!\w)/g, replacement: 'knots' },
+        { regex: /\bNE\b(?!\w)/g, replacement: 'northeast' },
+        { regex: /\bNW\b(?!\w)/g, replacement: 'northwest' },
+        { regex: /\bSE\b(?!\w)/g, replacement: 'southeast' },
+        { regex: /\bSW\b(?!\w)/g, replacement: 'southwest' },
+        { regex: /\bNM\b(?!\w)/g, replacement: 'nautical miles' },
+        { regex: /\bdeg\b(?!\w)/g, replacement: 'degrees' },
+        { regex: /\btstm\b(?!\w)/g, replacement: 'thunderstorm' },
+        { regex: /\bmm\b(?!\w)/g, replacement: 'millimeters' },
+        { regex: /\bcm\b(?!\w)/g, replacement: 'centimeters' },
+        { regex: /\bin.\b(?!\w)/g, replacement: 'inches' },
+        { regex: /\bft\b(?!\w)/g, replacement: 'feet' },
+        { regex: /\bmi\b(?!\w)/g, replacement: 'miles' },
+        { regex: /\bhr\b(?!\w)/g, replacement: 'hour' },
+        { regex: /\bhourly\b(?!\w)/g, replacement: 'per hour' },
+        { regex: /\bkg\b(?!\w)/g, replacement: 'kilograms' },
+        { regex: /\bg\/kg\b(?!\w)/g, replacement: 'grams per kilogram' },
+        { regex: /\bmb\b(?!\w)/g, replacement: 'millibars' },
+        { regex: /\bhPa\b(?!\w)/g, replacement: 'hectopascals' },
+        { regex: /\bPa\b(?!\w)/g, replacement: 'pascals' },
+        { regex: /\bKPa\b(?!\w)/g, replacement: 'kilopascals' },
+        { regex: /\bC\/hr\b(?!\w)/g, replacement: 'degrees Celsius per hour' },
+        { regex: /\bF\/hr\b(?!\w)/g, replacement: 'degrees Fahrenheit per hour' },
+        { regex: /\bC\/min\b(?!\w)/g, replacement: 'degrees Celsius per minute' },
+        { regex: /\bF\/min\b(?!\w)/g, replacement: 'degrees Fahrenheit per minute' },
+        { regex: /\bC\b(?!\w)/g, replacement: 'degrees Celsius' },
+        { regex: /\bF\b(?!\w)/g, replacement: 'degrees Fahrenheit' },
+    ]
+    const hours: Record<number, string> = {
+        0: "twelve", 1: "one", 2: "two", 3: "three", 4: "four",
+        5: "five", 6: "six", 7: "seven", 8: "eight", 9: "nine",
+        10: "ten", 11: "eleven", 12: "twelve",
+    };
+    const minWord = (m: number) => m === 0 ? "o'clock" : m < 10 ? `oh ${m}` : `${m}`;
+    const fmt = (h: number, m: number, ap: string) => `${hours[h % 12]} ${minWord(m)} ${ap}`;
+    for (const {regex, replacement} of patches) {
+        message = message.replace(regex, replacement)
+    }
+    return message
+        .replace(/'/g, "''")
+        .replace(/\b(\d{1,2}):(\d{2})\s*(AM|PM)\b/gi, (_, h, m, ap) => fmt(+h, +m, ap.toUpperCase()))
+        .replace(/\b(\d{1,2})\s+(\d{2})\s+(AM|PM)\b/gi, (_, h, m, ap) => fmt(+h, +m, ap.toUpperCase()))
+        .replace(/\b(\d{2})(\d{2})\s+(AM|PM)\b/gi, (_, hh, mm, ap) => fmt(+hh, +mm, ap.toUpperCase()))
+        .replace(/\b(\d{1,2})\s+(AM|PM)\b/gi, (_, h, ap) => fmt(+h, 0, ap.toUpperCase()))
+        .replace(/\*+/g, " ")
+        .replace(/-/g, " ")
+        .replace(/\n/g, " ")
+        .trim();
+}
+
+