@atmosx/event-product-parser 3.0.62 → 3.0.75

package/src/{@building → 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/Attributes";
-import { TypePVTEC } from "../@types/VTEC";
-import { EnumICAO } from "../@enums/ICAO";
+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,11 +32,11 @@ 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 = EnumICAO?.[office] ?? null;
     return { office, name };

package/src/building/GetEventPopulation.ts

@@ -0,0 +1,58 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeCities } from "StaticTypes/Properties"
+import { Bootstrap } from "@Bootstrap"
+import { CreateQuery } from "@Database/CreateQuery"
+import { NormalizePolygon } from "@ImageModules/NormalizePolygon"
+
+interface GetEventPopulationResponse { 
+    population: number
+    cities: TypeCities[]
+}
+
+export const GetEventPopulation = (geometry: GeoJSON.Polygon | GeoJSON.MultiPolygon | null): GetEventPopulationResponse => {
+    const coordinates = geometry?.coordinates;
+    if (!coordinates || !Array.isArray(coordinates) || coordinates.length === 0 || !Bootstrap.Settings.GlobalSettings.CensusPopulationData) {
+        return { population: 0, cities: [] };
+    }
+    const normalized = NormalizePolygon(geometry) as GeoJSON.Polygon | GeoJSON.MultiPolygon;
+    const points = normalized.type === `Polygon` ? normalized.coordinates[0] : normalized.coordinates.flatMap(polygon => polygon[0]);
+    const latitudes = points.map(([lon, lat]) => lat);
+    const longitudes = points.map(([lon, lat]) => lon);
+    const minLat = Math.min(...latitudes);
+    const maxLat = Math.max(...latitudes);
+    const minLon = Math.min(...longitudes);
+    const maxLon = Math.max(...longitudes);
+    const A = CreateQuery({
+        Query: `SELECT * FROM cities WHERE LAT BETWEEN ? AND ? AND LON BETWEEN ? AND ?`,
+        Parameters: [ minLat, maxLat, minLon, maxLon ]
+    });
+    const population = A.reduce((acc: number, city: any) => {
+        const census = Number(city.population);
+        return acc + (isNaN(census) ? 0 : census);
+    }, 0);
+    const cities = A.map((city: any) => ({
+        name: city.name,
+        state: city.state,
+        county: city.county.replace(/ County$/i, ``),
+        population: Number(city.population)
+    }));
+    return { population, cities };
+}

package/src/building/GetEventProperties.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 { 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 ?? [],
+            census: {},
+            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}/GetEventSignature.ts

@@ -11,18 +11,18 @@
     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 { EnumCorrelations } from "../@enums/Correlations";
-import { EnumCancellation } from "../@enums/Cancellation";
-import { EnumTesting} from "../@enums/Testing"
-import { EnumProducts } from "../@enums/Products";
-import { EnumHail } from "../@enums/Hail"
+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 => {
     const properties = event?.properties;
@@ -44,7 +44,7 @@ export const GetEventSignature = (event: TypeEvent): TypeEvent => {
         properties.status_metadata = { ...properties.status_metadata, is_expired: true };
     }
     
-    const getProduct = vtec?.vtec?.split(`.`)[0]?.replace(`/`, ``)
+    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/{@building → building}/GetEventTags.ts

@@ -11,13 +11,13 @@
     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 { EnumTags } from "../@enums/Tags";
+import { EnumTags } from "@Enums/Tags"
 
 export const GetEventTags = (message: string): string[] => {
     if (!message) return [];

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/{@modules/@eas → components/audio/components}/GetCleanDescription.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/@eas → components/audio/components}/GetFloatPCM16.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/@eas → components/audio/components}/GetMergedPCM16.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/@eas → components/audio/components}/GetPCM16.ts

@@ -11,19 +11,24 @@
     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 GetPCM16 = (samples: Record<string, number>[], sampleRate: number): Buffer => {
+interface GetPCM16Options {
+    Samples: Record<string, number>[]
+    SampleRate: number
+}
+
+export const GetPCM16 = ({ Samples, SampleRate }: GetPCM16Options): Buffer => {
     let o = 0;
     const bytesPerSample = 2;
     const blockAlign = 1 * bytesPerSample;
-    const byteRate = sampleRate * blockAlign;
-    const subchunk2Size = samples.length * bytesPerSample;
+    const byteRate = SampleRate * blockAlign;
+    const subchunk2Size = Samples.length * bytesPerSample;
     const chunkSize = 36 + subchunk2Size;
     const buffer = Buffer.alloc(44 + subchunk2Size);
  
@@ -35,7 +40,7 @@ export const GetPCM16 = (samples: Record<string, number>[], sampleRate: number):
     buffer.writeUInt32LE(16, o); o += 4;                 
     buffer.writeUInt16LE(1, o); o += 2;                  
     buffer.writeUInt16LE(1, o); o += 2;
-    buffer.writeUInt32LE(sampleRate, o); o += 4;
+    buffer.writeUInt32LE(SampleRate, o); o += 4;
     buffer.writeUInt32LE(byteRate, o); o += 4;
     buffer.writeUInt16LE(blockAlign, o); o += 2;
     buffer.writeUInt16LE(16, o); o += 2;
@@ -43,8 +48,8 @@ export const GetPCM16 = (samples: Record<string, number>[], sampleRate: number):
     buffer.write("data", o); o += 4;
     buffer.writeUInt32LE(subchunk2Size, o); o += 4;
 
-    for (let i = 0; i < samples.length; i++, o += 2) {
-        buffer.writeInt16LE(samples[i].value, o);
+    for (let i = 0; i < Samples.length; i++, o += 2) {
+        buffer.writeInt16LE(Samples[i].value, o);
     }
     return buffer;
 }

package/src/{@modules/@eas → components/audio/components}/GetPCMToFloat.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/@eas → components/audio/components}/GetSampledPCM16.ts

@@ -11,24 +11,30 @@
     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 GetSampledPCM16 = (int16: Int16Array, originalRate: number, targetRate: number): Int16Array => {
-    if (originalRate === targetRate) return int16;
-    const ratio = targetRate / originalRate;
-    const outLen = Math.max(1, Math.round(int16.length * ratio));
+interface GetSampledPCM16Options {
+    Int16: Int16Array
+    OriginalRate: number
+    TargetRate: number
+}
+
+export const GetSampledPCM16 = ({ Int16, OriginalRate, TargetRate }: GetSampledPCM16Options): Int16Array => {
+    if (OriginalRate === TargetRate) return Int16;
+    const ratio = TargetRate / OriginalRate;
+    const outLen = Math.max(1, Math.round(Int16.length * ratio));
     const out = new Int16Array(outLen);
     for (let i = 0; i < outLen; i++) {
         const pos = i / ratio;
         const i0 = Math.floor(pos);
-        const i1 = Math.min(i0 + 1, int16.length - 1);
+        const i1 = Math.min(i0 + 1, Int16.length - 1);
         const frac = pos - i0;
-        const v = int16[i0] * (1 - frac) + int16[i1] * frac;
+        const v = Int16[i0] * (1 - frac) + Int16[i1] * frac;
         out[i] = Math.round(v);
     }
     return out;