@atmosx/event-product-parser 2.0.15 → 3.0.0

package/src/@modules/@database/database.init.ts

@@ -0,0 +1,45 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 fs from 'fs'
+import sqlite3 from 'better-sqlite3'
+import { TypeSettings } from "../../@types/types.settings"
+import { bootstrap } from "../../bootstrap"
+import { setWarning } from '../@utilities/utilities.setWarning'
+import { importShapefiles } from './database.shapefiles'
+
+export const initializeDatabase = async (): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
+    try { 
+        if (!fs.existsSync(settings.Database)) { 
+            fs.writeFileSync(settings.Database, '')
+            setWarning({ message: `Creating new database at ${settings.Database}` })
+        }
+        bootstrap.database = new sqlite3(settings.Database);
+        bootstrap.database
+            .prepare(`CREATE TABLE IF NOT EXISTS stanzas ( id INTEGER PRIMARY KEY AUTOINCREMENT, type TEXT, issued TEXT, stanza TEXT )`)
+            .run();
+        bootstrap.database
+            .prepare(`CREATE TABLE IF NOT EXISTS shapefiles (id TEXT PRIMARY KEY, location TEXT, geometry TEXT)`)
+            .run();
+        await importShapefiles();
+    } catch (error) {
+        setWarning({ message: `An error occurred while initializing the database: ${error.message}` })
+    }
+}

package/src/@modules/@database/database.shapefiles.ts

@@ -0,0 +1,97 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 fs from 'fs'
+import { resolve, extname} from 'path'
+import { loadAsync } from 'jszip'
+import { read } from 'shapefile'
+import { TypeSettings } from "../../@types/types.settings"
+import { bootstrap } from "../../bootstrap"
+import { setSleep } from '../@utilities/utilities.setSleep'
+import { setWarning } from '../@utilities/utilities.setWarning'
+import { shapefileLinks } from '../../@dictionaries/dictionaries.shapefileLinks'
+
+export const importShapefiles = async (): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
+    try { 
+        const tShapefiles = bootstrap.database
+            .prepare(`SELECT COUNT(*) AS count FROM shapefiles`)
+            .get().count;
+        if (tShapefiles === 0) {
+            await setSleep({timeout: 1e3});
+            setWarning({ message: `Shapefiles are currently building, please DO NOT close your terminal. The shapefiles will not finish and will remain incomplete. If you do mess up, you will need to delete ${settings.Database} and restart the application.` })
+            for (const shapefile of shapefileLinks) {
+                const response = await fetch(shapefile.link);
+                const arrayBuff = await response.arrayBuffer();
+                const content = await loadAsync(arrayBuff);
+                const directory = resolve(__dirname, `../../shapefiles`);
+                if (!fs.existsSync(directory)) {
+                    fs.mkdirSync(directory, { recursive: true });
+                }
+                for (const file of Object.keys(content.files)) {
+                    if (file.endsWith('.shp') || file.endsWith('.dbf')) {
+                        const data = await content.files[file].async(`nodebuffer`)
+                        const output = resolve(directory, `${shapefile?.name ?? ``}_${shapefile?.id ?? ``}${extname(file)}`)
+                        fs.writeFileSync(output, data)
+                        setWarning({ message: `Successfully downloaded and extracted ${file}` })
+                    }
+                }
+                const filepath = resolve(__dirname, '../../shapefiles', shapefile.name + '_' + shapefile.id);
+                const { features } = await read(
+                    filepath,
+                    filepath,
+                );
+                setWarning({ message: `Importing ${features.length} features from ${shapefile.name}_${shapefile.id}` })
+                const insert = bootstrap.database
+                    .prepare(`INSERT OR REPLACE INTO shapefiles (id, location, geometry) VALUES (?, ?, ?)`)
+                const transaction = bootstrap.database.transaction((entries: any[]) => {
+                    for (const entry of entries) {
+                        const { properties, geometry } = entry;
+                        let final: string, location: string;
+                        if (properties.FIPS) {
+                            final = `${properties.STATE}${shapefile.id}${properties.FIPS.substring(2)}`;
+                            location = `${properties.COUNTYNAME}, ${properties.STATE}`;
+                        }
+                        else if (properties.FULLSTAID) {
+                            final = `${properties.ST}${shapefile.id}${properties.WFO}`;
+                            location = `${properties.CITY}, ${properties.STATE}`;
+                        }
+                        else if (properties.STATE) {
+                            final = `${properties.STATE}${shapefile.id}${properties.ZONE ?? properties.SITE_ID}`;
+                            location = `${properties.NAME ?? `${properties.RFC_NAME} ${properties.RFC_CITY}`}, ${properties.STATE}`;
+                        }
+                        else {
+                            final = properties.ID ?? properties.WFO
+                            location = properties.NAME;
+                        }
+                        insert.run(final, location, JSON.stringify(geometry));
+                    }
+                })
+                fs.unlinkSync(`${filepath}.shp`)
+                fs.unlinkSync(`${filepath}.dbf`)
+                setWarning({ message: `Cleaned up temporary files for ${shapefile.name}_${shapefile.id}` })
+                transaction(features)
+            }
+            setWarning({ message: `Shapefiles have finished compiling, you can now continue and close this terminal` })
+            fs.rm(resolve(__dirname, '../../shapefiles'), { recursive: true, force: true }, () => {});
+        }
+    } catch (error) {
+        setWarning( {message: `An error occurred while compiling shapefiles: ${error.message}` }) 
+    }
+}

package/src/@modules/@database/database.stanza.ts

@@ -0,0 +1,47 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 { setWarning } from '../@utilities/utilities.setWarning';
+import { TypeSettings } from "../../@types/types.settings"
+import { TypeStanzaCompiled } from '../../@types/types.compiled';
+
+export const importStanza = async (stanza: TypeStanzaCompiled): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
+    try { 
+        bootstrap.database
+            .prepare(`INSERT OR IGNORE INTO stanzas (type, stanza, issued) VALUES (?, ?, ?)`)
+            .run(stanza.getType.type, JSON.stringify(stanza), stanza.attributes.issue)
+        const count = bootstrap.database
+            .prepare(`SELECT COUNT(*) as total FROM stanzas`)
+            .get() as { total: number }
+        const max = settings.NOAAWeatherWireServiceSettings.CacheSettings.MaxDatabaseHistory;
+        if (count.total > max) { 
+            const toDelete = count.total - max;
+            if (toDelete > 0) {
+                bootstrap.database
+                    .prepare(`DELETE FROM stanzas WHERE id IN (SELECT id FROM stanzas ORDER BY issued ASC LIMIT ?)`)
+                    .run(toDelete);
+            }
+        }
+    } catch (error) {
+        setWarning({ message: `An error occurred while importing stanza: ${error.message}` })
+    }
+}

package/src/@modules/@stanza/stanza.getAwipsType.ts

@@ -0,0 +1,46 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 { TypeAttributes } from "../../@types/types.attributes"
+import { eventAwipAbreviations } from "../../@dictionaries/dictionaries.eventAwipAbreviations"
+
+interface ValidateOptions { 
+    attributes: TypeAttributes
+}
+
+interface ValidiateResponse { 
+    type: string
+    prefix: string
+}
+
+export const getAwipsType = (options: ValidateOptions): ValidiateResponse => {
+    const attributes = options.attributes;
+    if (!attributes.awipsid) { 
+        return { 
+            type: null, 
+            prefix: null
+        }
+    }
+    for (const [prefix, type] of Object.entries(eventAwipAbreviations)) {
+        if (attributes.awipsid.startsWith(prefix)) {
+            return { type, prefix }
+        }
+    }
+    return { type: null, prefix: null }
+}

package/src/@modules/@stanza/stanza.validate.ts

@@ -0,0 +1,50 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 { TypeStanzaCompiled } from "../../@types/types.compiled"
+import { regExp } from "../../@dictionaries/dictionaries.regExp"
+import { getAwipsType } from "./stanza.getAwipsType"
+
+interface ValidateOptions { 
+    stanza: TypeStanza
+}
+
+export const validate = (options: ValidateOptions): TypeStanzaCompiled => {
+    if (options.stanza.is(`message`)) {
+        const cb = options.stanza.getChild(`x`) as TypeStanza;
+        if (cb && cb.children) {
+            const message = unescape(cb.children[0]);
+            const attributes = cb.attrs;
+            if (attributes.awipsid && attributes.awipsid.length > 1) { 
+                const isCapEvent = message.includes(`<?xml`);
+                const isCapAreaDescription = message.includes(`<areaDesc>`)
+                const isVTEC = message.match(regExp.pvtec) != null;
+                const isUGC = message.match(regExp.ugc1) != null;
+                const getType = getAwipsType({ attributes: attributes})
+                if (getType.type != null) {
+                    return { 
+                        message, attributes, isCapEvent, isVTEC, isUGC, isCapAreaDescription, isIgnored: false, isNWWS: true, getType
+                    }
+                }
+            }
+        }
+    }
+    return { isIgnored: true}
+}

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

@@ -0,0 +1,75 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 request from 'request'
+
+interface ImportOptions { 
+    proxy?: string
+    url?: string
+    headers?: any
+    timeout?: number 
+}
+
+export const createHttp = async (options: ImportOptions): Promise<any> => {
+    return new Promise((resolve, reject) => {
+        const requestOptions = { 
+            url: options.url ?? `https://api.weather.gov/alerts/active`,
+            headers: options.headers ?? {
+                "User-Agent": "AtmosphericX",
+                "Accept": "application/geo+json, text/plain, */*; q=0.9",
+                "Accept-Language": "en-US,en;q=0.9"
+            }, 
+            timeout: options.timeout ?? 10e3,
+            proxy: options.proxy ?? null,
+            maxRedirects: 1, 
+        };
+        request(requestOptions, (error, response, body) => {
+            if (error) { 
+                return resolve({
+                    error: true,
+                    options: requestOptions,
+                    status: -1,
+                    message: error.message ?? `Unknown Error`
+                })
+            }
+            if (response.statusCode !== 200) { 
+                return resolve({
+                    error: true,
+                    options: requestOptions,
+                    status: response.statusCode ?? -1,
+                    message: `HTTP Status Code ${response.statusCode ?? `Unknown Status Code`}`
+                })
+            }
+            if (body == undefined || body == null) { 
+                return resolve({
+                    error: true,
+                    options: requestOptions,
+                    status: response.statusCode ?? -1,
+                    message: `Empty Response Body`
+                })
+            }
+            resolve({
+                error: false,
+                options: requestOptions,
+                status: response.statusCode ?? -1,
+                message: body
+            })  
+        })
+    })
+}

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

@@ -0,0 +1,43 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 getFormattedTime = (date: string): string => {
+    const now = Date.now();
+    const then = typeof date === "number" ? date : new Date(date).getTime()
+    const seconds = Math.floor((now - then) / 1000);
+    const absSeconds = Math.abs(seconds);
+    const isPast = seconds > 0;
+    const units: [string, number][] = [
+        ["year", 31536000], ["month", 2592000],
+        ["day", 86400], ["hour", 3600],
+        ["minute", 60], ["second", 1],
+    ];
+    for (const [name, value] of units) {
+        const interval = Math.floor(absSeconds / value);
+        if (interval >= 1) {
+            return isPast
+                ? `${interval} ${name}${interval > 1 ? "s" : ""} ago`
+                : `in ${interval} ${name}${interval > 1 ? "s" : ""}`;
+        }
+    }
+    return "just now";
+}
+
+

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

@@ -0,0 +1,25 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 getSettings = (): TypeSettings => {
+    return bootstrap.settings;
+}

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

@@ -0,0 +1,114 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 GetShapeNearestPointResponse { 
+    proximity: boolean
+    point: [number, number]
+    distance: number | null 
+    distanceKm?: number | null
+    distanceMeters?: number | null
+}
+
+export const getShapeNearestPoint = (coordinates: number[][], point: [number, number]): GetShapeNearestPointResponse => {
+    if (!coordinates || !point) { 
+        return { proximity: false, point: [0, 0], distance: null }
+    }
+    const normalize = (coords: any): any[] => {
+        if (!Array.isArray(coords)) return [];
+        if (typeof coords[0] === 'number' && typeof coords[1] === 'number') return [];
+        if (Array.isArray(coords[0]) && typeof coords[0][0] === 'number') {
+            return [[coords]];
+        }
+        if (Array.isArray(coords[0]) && Array.isArray(coords[0][0]) && typeof coords[0][0][0] === 'number') {
+            return [coords];
+        }
+        if (Array.isArray(coords[0]) && Array.isArray(coords[0][0]) && Array.isArray(coords[0][0][0]) && typeof coords[0][0][0][0] === 'number') {
+            return coords;
+        }
+        return [];
+    }
+    const polys = normalize(coordinates);
+    if (polys.length === 0) return { proximity: false, point: [0, 0], distance: null };
+    const lon = point[0];
+    const lat = point[1];
+    const pointInRing = (pt: [number, number], ring: number[][]): boolean => {
+        let x = pt[0], y = pt[1];
+        let inside = false;
+        for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) {
+            const xi = ring[i][0], yi = ring[i][1];
+            const xj = ring[j][0], yj = ring[j][1];
+            const intersect = ((yi > y) !== (yj > y)) && (x < (xj - xi) * (y - yi) / (yj - yi + 0) + xi);
+            if (intersect) inside = !inside;
+        }
+        return inside;
+    };
+
+    const toRadians = (deg: number) => (deg * Math.PI) / 180;
+    const haversineMiles = (a: [number, number], b: [number, number]) => {
+        const R = 3958.8;
+        const dLat = toRadians(b[1] - a[1]);
+        const dLon = toRadians(b[0] - a[0]);
+        const lat1 = toRadians(a[1]);
+        const lat2 = toRadians(b[1]);
+        const sinDLat = Math.sin(dLat / 2);
+        const sinDLon = Math.sin(dLon / 2);
+        const c = 2 * Math.asin(Math.sqrt(sinDLat * sinDLat + Math.cos(lat1) * Math.cos(lat2) * sinDLon * sinDLon));
+        return R * c;
+    };
+    let minDistance = Infinity;
+    let closestPoint: [number, number] | null = null;
+    for (const poly of polys) {
+        const outer = poly[0];
+        const holes = poly.slice(1);
+        if (pointInRing(point, outer)) {
+            let inHole = false;
+            for (const hole of holes) {
+                if (pointInRing(point, hole)) { inHole = true; break; }
+            }
+            if (!inHole) {
+                return { proximity: true, point, distance: 0 };
+            }
+        }
+        for (const ring of poly) {
+            for (let i = 0; i < ring.length - 1; i++) {
+                const start = [ring[i][0], ring[i][1]] as [number, number];
+                const end = [ring[i+1][0], ring[i+1][1]] as [number, number];
+                const A = lon - start[0];
+                const B = lat - start[1];
+                const C = end[0] - start[0];
+                const D = end[1] - start[1];
+                const lenSq = C*C + D*D;
+                const t = lenSq === 0 ? 0 : Math.max(0, Math.min(1, (A*C + B*D) / lenSq));
+                const candidate: [number, number] = [start[0] + t*C, start[1] + t*D];
+                const dist = haversineMiles([lon, lat], candidate);
+                if (!isNaN(dist) && dist < minDistance) {
+                    minDistance = Number(dist.toFixed(3));
+                    closestPoint = candidate;
+                }
+            }
+        }
+    }
+    if (!isFinite(minDistance) || closestPoint == null) {
+        return { proximity: false, point: [0,0], distance: null };
+    }
+    const distanceMiles = minDistance;
+    const distanceKm = Number((distanceMiles * 1.609344).toFixed(3));
+    const distanceMeters = Math.round(distanceKm * 1000);
+    return { proximity: distanceMiles === 0, point: closestPoint, distance: distanceMiles, distanceKm, distanceMeters };
+}

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

@@ -0,0 +1,38 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 { xReconnect } from "../@xmpp/xmpp.xReconnect"
+import { callback } from "../../@core/core.callback"
+import { bootstrap } from "../../bootstrap";
+import { updateNodes } from "../../@manager/manager.updateNodes";
+
+export const setCronSchedule = async (): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
+    if (settings.EnableWireService) {
+        if (settings.NOAAWeatherWireServiceSettings.ReconnectionSettings.Enabled) {
+            void xReconnect(settings.NOAAWeatherWireServiceSettings.ReconnectionSettings.ReconnectionInterval)
+        }
+    } else { 
+        await callback();
+    }
+}
+
+

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

@@ -0,0 +1,41 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 { setTimeoutAction } from "./utilities.setTimeoutAction";
+import { setWarning } from "./utilities.setWarning";
+
+interface SetEventEmitOptions { 
+    event: string
+    metadata: any
+    message?: string
+    limited?: boolean
+}
+
+export const setEventEmit = (options: SetEventEmitOptions): void => {
+    if (options.limited) {
+        const isTimeout = setTimeoutAction({ identifier: `event.${options.event}`, addTime: true, max: 1, interval: 1 })
+        if (isTimeout.limited) return;
+    }
+    bootstrap.listener.emit(options.event, options.metadata)
+    if (options.event != `log`) { bootstrap.listener.emit(`*`, {event: options.event, data: options.metadata}) }
+    if (options.message) {
+        setWarning({ message: options.message })
+    }
+}

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

@@ -0,0 +1,30 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & 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 ImportOptions { 
+    event: string,
+    callback: () => void
+}
+
+export const setListener = (options: ImportOptions): (() => void) => {
+    bootstrap.listener.on(options.event, options.callback)
+    return () => { void bootstrap.listener.off(options.event, options.callback) };
+}