@atmosx/event-product-parser 2.0.16 → 3.0.1

package/src/@modules/@utilities/utilities.setSettings.ts

@@ -0,0 +1,42 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeSettings } from '../../@types/types.settings'
+import { bootstrap } from "../../bootstrap"
+
+export const setSettings = (newSettings: TypeSettings): TypeSettings => {
+    const settings = bootstrap.settings as Record<string, unknown>;
+    const merge = (target: Record<string, unknown>, source: Record<string, unknown>) => {
+        for (const key in source) {
+            if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+            const srcVal = source[key];
+            const tgtVal = target[key];
+            if (srcVal && typeof srcVal === 'object' && !Array.isArray(srcVal)) {
+                if (!tgtVal || typeof tgtVal !== 'object' || Array.isArray(tgtVal)) {
+                    target[key] = {};
+                }
+                merge(target[key] as Record<string, unknown>, srcVal as Record<string, unknown>);
+            } else {
+                target[key] = srcVal;
+            }
+        }
+    };
+    merge(settings, newSettings as Record<string, unknown>);
+    return settings as TypeSettings;
+}

package/src/@modules/@utilities/utilities.setSleep.ts

@@ -0,0 +1,33 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+    
+*/
+
+interface SetSleepOptions { 
+    timeout: number
+}
+
+export const setSleep = async (options: SetSleepOptions): Promise<void> => {
+    return new Promise((resolve) => {
+        setTimeout(() => {
+            resolve();
+        }, options.timeout);
+    });
+}
+
+

package/src/@modules/@utilities/utilities.setTimeoutAction.ts

@@ -0,0 +1,59 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { bootstrap } from "../../bootstrap"
+
+interface SetTimeoutActionOptions {
+    identifier: string
+    addTime?: boolean
+    max?: number
+    interval: number
+}
+
+type SetTimeoutActionResponse = {
+    limited: boolean
+    remaining?: number
+    response?: string
+}
+
+export const setTimeoutAction = (options: SetTimeoutActionOptions): SetTimeoutActionResponse =>  {
+    let target = bootstrap?.ratelimits?.[options?.identifier];
+    if (!target) {
+        bootstrap.ratelimits[options?.identifier] = [];
+        target = bootstrap.ratelimits[options?.identifier];
+    }
+    if (target?.length > 0) {
+       bootstrap.ratelimits[options?.identifier] = target.filter((ts: number) => Date.now() - ts < options?.interval * 1000);
+       target = bootstrap.ratelimits[options?.identifier];
+    }
+
+    const oldestTimestamp = target?.[0];
+    const getWait = oldestTimestamp ? Math.ceil((options?.interval * 1000) - (Date.now() - oldestTimestamp)) : 0;
+    const max = options?.max || 1;
+    
+    if (target?.length >= max && getWait > 0) {
+        return {
+            limited: true,
+            remaining: getWait,
+            response: `You are being rate limited, please wait ${(getWait / 1e3).toFixed(1)} second(s) before performing this action again.`
+        }
+    }
+    bootstrap.ratelimits[options?.identifier].push(Date.now());
+    return { limited: false };
+}

package/src/@modules/@utilities/utilities.setWarning.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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { bootstrap } from "../../bootstrap"
+import { TypeSettings } from "../../@types/types.settings";
+
+interface SetWarningOptions { 
+    title?: string
+    message: string
+}
+
+export const setWarning = (options: SetWarningOptions): void => {
+    const settings = bootstrap.settings as TypeSettings;
+    bootstrap.listener.emit(`log`, `${options.title ?? `[${bootstrap.ansi_colors.YELLOW}ATMOSX-PARSER${bootstrap.ansi_colors.RESET}]`} ${options.message}`)
+    if (settings.EnableJournal) { 
+        console.log(`${options.title ?? `[${bootstrap.ansi_colors.YELLOW}ATMOSX-PARSER${bootstrap.ansi_colors.RESET}]`} ${options.message}`)
+    }
+}

package/src/@modules/@xmpp/xmpp.xDeploy.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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { client } from '@xmpp/client';
+import { TypeSettings } from "../../@types/types.settings";
+import { bootstrap } from "../../bootstrap"
+import { setWarning } from "../@utilities/utilities.setWarning";
+import { xOnline } from "./xmpp.xOnline";
+import { xOffline } from "./xmpp.xOffline";
+import { xError } from "./xmpp.xError";
+import { xStanza } from "./xmpp.xStanza";
+import { setEventEmit } from '../@utilities/utilities.setEventEmit';
+
+export const xDeploy = async (): Promise<void> => {
+    let session;
+    const settings = bootstrap.settings as TypeSettings
+    settings.NOAAWeatherWireServiceSettings.CredentialSettings.Nickname 
+        ??= settings.NOAAWeatherWireServiceSettings.CredentialSettings.Username;
+    session = bootstrap.session_xmpp = client({
+        service: 'xmpp://nwws-oi.weather.gov',
+        domain: 'nwws-oi.weather.gov',
+        username: settings.NOAAWeatherWireServiceSettings.CredentialSettings.Username,
+        password: settings.NOAAWeatherWireServiceSettings.CredentialSettings.Password
+    })
+    try {
+        await xOffline();
+        await xError();
+        await xStanza();
+        await xOnline();
+        await session.start()
+    } catch (error) {
+        setEventEmit({
+            event: `onServiceStatus`,
+            metadata: {
+                message: `Error occured while starting XMPP Session: ${error}`,
+                data: {},
+                type: `error`,
+                error: true 
+            },
+        })
+    }
+}

package/src/@modules/@xmpp/xmpp.xError.ts

@@ -0,0 +1,29 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { bootstrap } from "../../bootstrap";
+import { setEventEmit } from "../@utilities/utilities.setEventEmit";
+import { setWarning } from "../@utilities/utilities.setWarning";
+
+export const xError = () => {
+    bootstrap.session_xmpp.on(`error`, async (error: Error) => {
+        bootstrap.cache.isConnected = false;
+        bootstrap.cache.sigHault = true;
+    })
+}

package/src/@modules/@xmpp/xmpp.xOffline.ts

@@ -0,0 +1,38 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { bootstrap } from "../../bootstrap";
+import { setEventEmit } from "../@utilities/utilities.setEventEmit";
+import { setWarning } from "../@utilities/utilities.setWarning";
+
+export const xOffline = () => {
+    bootstrap.session_xmpp.on(`offline`, async () => {
+        bootstrap.cache.isConnected = false;
+        bootstrap.cache.sigHault = true;
+        setEventEmit({
+            event: `onServiceStatus`,
+            metadata: {
+                message: `Client has gone offline`,
+                data: {},
+                type: `offline`,
+                error: true 
+            },
+        })
+    })
+}

package/src/@modules/@xmpp/xmpp.xOnline.ts

@@ -0,0 +1,45 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+import { xml } from '@xmpp/client'
+import { bootstrap } from "../../bootstrap";
+import { setSleep } from "../@utilities/utilities.setSleep";
+import { setEventEmit } from '../@utilities/utilities.setEventEmit';
+
+export const xOnline = () => {
+    const settings = bootstrap.settings;
+    bootstrap.session_xmpp.on(`online`, async (address: string) => {
+        bootstrap.cache.sigHault = false;
+        bootstrap.cache.isConnected = true;
+        bootstrap.cache.tReconnects = 0;
+        const nickname = settings.NOAAWeatherWireServiceSettings.CredentialSettings.Nickname;
+        bootstrap.session_xmpp.send(xml('presence', {
+            to: `nwws@conference.nwws-oi.weather.gov/${nickname}`,
+            xmlns: 'http://jabber.org/protocol/muc',
+        }))
+        setEventEmit({
+            event: `onServiceStatus`,
+            metadata: {
+                message: `Succesfully connected to NOAA Weather Wire Service as "${nickname}"`,
+                data: {},
+                type: `online`,
+                error: false
+            },
+        })
+    })
+}

package/src/@modules/@xmpp/xmpp.xReconnect.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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeSettings } from "../../@types/types.settings";
+import { bootstrap } from "../../bootstrap"
+import { setEventEmit } from "../@utilities/utilities.setEventEmit";
+import { setWarning } from "../@utilities/utilities.setWarning";
+
+export const xReconnect = async (interval: number): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
+    const lastStanza = Date.now() - bootstrap.cache.lastStanza
+    if (interval < 15) { 
+        setWarning({ message: `Reconnection Interval of ${interval} seconds is too low, setting to 15 seconds` })
+        interval = 15;
+        bootstrap.settings.NOAAWeatherWireServiceSettings.ReconnectionSettings.ReconnectionInterval = 15;
+    }
+    const reconnectThreshold = interval * 1e3
+    if ((!bootstrap.cache.isConnected && !bootstrap.cache.sigHault) || !bootstrap.session_xmpp) { 
+        return; 
+    }
+    if (lastStanza > reconnectThreshold) {
+        if (!bootstrap.cache.isReconnecting) {
+            bootstrap.cache.isReconnecting = true;
+            bootstrap.cache.isConnected = false;
+            bootstrap.cache.tReconnects += 1;
+            try { 
+                setEventEmit({
+                    event: `onServiceStatus`,
+                    metadata: {
+                        message: `Attempting to reconnect to XMPP Service (Reconnect Attempt ${bootstrap.cache.tReconnects})`,
+                        data: {
+                            last_stanza: lastStanza,
+                            nickname: settings.NOAAWeatherWireServiceSettings.CredentialSettings.Nickname
+                        },
+                        type: `reconnect`,
+                        error: true
+                    },
+                })
+                await bootstrap.session_xmpp.stop().catch(() => {});
+                await bootstrap.session_xmpp.start().catch(() => {});
+            } catch (error) {
+                setWarning({ message: `XMPP Reconnect Failed - ${(error as Error).message}` })
+            } finally { 
+                bootstrap.cache.isReconnecting = false;
+            }
+        }
+    }
+}

package/src/@modules/@xmpp/xmpp.xStanza.ts

@@ -0,0 +1,63 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeStanza } from "../../@types/types.stanza";
+import { bootstrap } from "../../bootstrap";
+import { validate } from "../@stanza/stanza.validate";
+import { createEvent } from "../../@building/building.create";
+import { importStanza } from "../@database/database.stanza";
+import { setEventEmit } from "../@utilities/utilities.setEventEmit";
+
+export const xStanza = () => {
+    bootstrap.session_xmpp.on(`stanza`, async (stanza: TypeStanza) => {
+        const msgFrom = stanza?.attrs?.from ?? ``
+        const msgType = stanza?.attrs?.type ?? ``
+        setEventEmit({
+            event: `onServiceStatus`,
+            metadata: {
+                message: stanza,
+                from: msgFrom,
+                type: `stanza`
+            },
+        })
+        bootstrap.cache.lastStanza = Date.now();
+        if (stanza.is(`message`)) {
+            const result = validate({ stanza });
+            const isSkippable = result.isIgnored ||
+                (result.isCapEvent) ||
+                (result.isCapEvent && !result.isCapAreaDescription)
+            if (isSkippable) { return; }
+            await createEvent(result);
+            await importStanza(result);
+        }
+        if (stanza.is(`presence`) && msgFrom.startsWith('nwws@conference.nwws-oi.weather.gov/')) {
+            const getOccupant = msgFrom.split(`/`).slice(1).join(`/`)
+            const getAvailability = msgType === `unavailable`
+            setEventEmit({
+                event: `onServiceStatus`,
+                metadata: {
+                    message: `Occupant ${getOccupant} has ${getAvailability ? `left` : `joined`} the room`,
+                    data: {},
+                    type: `occupant`,
+                    error: false 
+                },
+            })
+        }
+    })
+}

package/src/@parsers/@hvtec/hvtec.extract.ts

@@ -0,0 +1,40 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeHVTEC } from "../../@types/types.hvtec";
+import { eventCauses } from "../../@dictionaries/dictionaries.eventCauses";
+import { eventRecords } from "../../@dictionaries/dictionaries.eventRecords";
+import { regExp } from "../../@dictionaries/dictionaries.regExp";
+import { eventSeverity } from "../../@dictionaries/dictionaries.eventSeverity";
+
+export const hvExtract = (message: string): TypeHVTEC[] | null => {
+    const getHVTECs = message.match(regExp.hvtec) ?? [];
+    const vtecs: TypeHVTEC[] = [];
+    for (const vtec of getHVTECs) {
+        const sub = vtec.split(`.`);
+        if (sub.length < 7) continue;
+        vtecs.push({
+            hvtec: vtec,
+            severity: eventSeverity[sub[1]],
+            cause: eventCauses[sub[2]],
+            record: eventRecords[sub[6]]
+        })
+    }
+    return vtecs.length > 0 ? vtecs : null;
+}

package/src/@parsers/@pvtec/pvtec.expires.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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+export const getExpiry = (dates: string[]): string => {
+    if (dates?.[1] == `000000T0000Z`) return 'Invalid Date Format'
+    const expires = `${new Date().getFullYear().toString().substring(0, 2)}${dates[1].substring(0, 2)}-${dates[1].substring(2, 4)}-${dates[1].substring(4, 6)}T${dates[1].substring(7, 9)}:${dates[1].substring(9, 11)}:00`;
+    const local = new Date(new Date(expires).getTime() - 4 * 60 * 60000);
+    const pad = (n: number) => n.toString().padStart(2, '0');
+    return `${local.getFullYear()}-${pad(local.getMonth() + 1)}-${pad(local.getDate())}T${pad(local.getHours())}:${pad(local.getMinutes())}:00.000-04:00`;
+}

package/src/@parsers/@pvtec/pvtec.extract.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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypePVTEC } from "../../@types/types.pvtec";
+import { regExp } from "../../@dictionaries/dictionaries.regExp";
+import { eventProducts } from "../../@dictionaries/dictionaries.eventProducts";
+import { eventTypes } from "../../@dictionaries/dictionaries.eventTypes";
+import { eventActions } from "../../@dictionaries/dictionaries.eventActions";
+import { eventStatus } from "../../@dictionaries/dictionaries.eventStatus";
+import { getExpiry } from "./pvtec.expires";
+
+export const pvExtract = (message: string): TypePVTEC[] | null => {
+    const getVTECs = message.match(regExp.pvtec) ?? [];
+    const vtecs: TypePVTEC[] = [];
+    for (const vtec of getVTECs) {
+        const sub = vtec.split(`.`);
+        if (sub?.length < 7) continue;
+        const dates = sub[6]?.split(`-`);
+        vtecs.push({
+            vtec: vtec,
+            product: eventProducts[sub[0]],
+            tracking: `${sub[2]}-${sub[3]}-${sub[4]}-${sub[5]}`,
+            event: `${eventTypes[sub[3]]} ${eventActions[sub[4]]}`,
+            status: eventStatus[sub[1]],
+            organization: message.match(regExp.wmo)?.[0] ?? null,
+            expires: getExpiry(dates),
+            is_watch: (sub[4] == `A` || sub[4] == `Y`) && (sub[3] == `TO` || sub[3] == `SV`),
+            prediction_center: sub[2] == `KWNS`
+            ? true : false
+        })
+    }
+    return vtecs.length > 0 ? vtecs : null;
+}

package/src/@parsers/@text/text.getDescriptionFromProduct.ts

@@ -0,0 +1,53 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { regExp } from "../../@dictionaries/dictionaries.regExp";
+
+interface GetDescriptionFromProductOptions { 
+    message: string
+    handle?: string
+}
+
+export const getDescriptionFromProduct = (options: GetDescriptionFromProductOptions): string => {
+    let message = options.message;
+    const dates = Array.from(message.matchAll(regExp.dateline));
+    if (dates.length) {
+        const lastMatch = dates[dates.length - 1][0];
+        const sIndx = message.lastIndexOf(lastMatch);
+        if (sIndx !== -1) {
+            const endIndx = message.indexOf('&&', sIndx);
+            message = message.substring(sIndx + lastMatch.length, endIndx !== -1 ? endIndx : undefined).trimStart();
+            if (message.startsWith('/')) message = message.slice(1).trimStart();
+            if (options.handle && message.includes(options.handle)) {
+                const handleIdx = message.indexOf(options.handle);
+                message = message.substring(handleIdx + options.handle.length).trimStart();
+                if (message.startsWith('/')) message = message.slice(1).trimStart();
+            }
+        }
+    } else if (options.handle) {
+        const handleIndx = message.indexOf(options.handle);
+        if (handleIndx !== -1) {
+            let afterHandle = message.substring(handleIndx + options.handle.length).trimStart();
+            if (afterHandle.startsWith('/')) afterHandle = afterHandle.slice(1).trimStart();
+            const latEnd = afterHandle.indexOf('&&')
+            message = latEnd !== -1 ? afterHandle.substring(0, latEnd).trim() : afterHandle.trim();
+        }
+    }
+    return message.trim();
+}