@atmosx/event-product-parser 2.0.15 → 3.0.0

package/src/@events/events.api.ts

@@ -0,0 +1,113 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeStanzaCompiled } from "../@types/types.compiled"
+import { TypeEvent } from "../@types/type.event";
+import { getEventTracking } from "../@building/building.tracking";
+import { validateEvents } from "../@building/building.validate";
+import { getEventOffice } from "../@building/building.office";
+import { getEventTags } from "../@building/building.tags";
+import { getTextFromProduct } from "../@parsers/@text/text.getTextFromProduct";
+import { officeICAOs } from "../@dictionaries/dictionaries.officeICAOs";
+
+export const api = async (stanza: TypeStanzaCompiled): Promise<void> => {
+    let processed: TypeEvent[] = [];
+    const messages =  Object.values(JSON.parse(stanza.message).features) as any;
+    for (const feature of messages) {
+        const tick = performance.now();
+        const pVtec = feature?.properties?.parameters?.VTEC?.[0] ?? null
+        processed.push({
+            type: `Feature`,
+            geometry: {
+                type: `Point`,
+                coordinates: []
+            },
+            properties: { 
+                event: feature?.properties?.event ?? null,
+                parent: feature?.properties?.event ?? null,
+                status: feature?.properties?.messageType ?? null,
+                issued: feature?.properties?.sent ? new Date(feature?.properties?.sent).toISOString() : null,
+                expires: feature?.properties?.expires ? new Date(feature?.properties?.expires).toISOString() : null,
+                locations: feature?.properties?.areaDesc ?? null,
+                description: feature?.properties?.description ?? null,
+                attributes: feature?.properties?.attributes ?? {},
+                geocode: {
+                    office: {
+                        office: pVtec ? pVtec.split(`.`)[2] : null,
+                        name: officeICAOs[pVtec ? pVtec.split(`.`)[2] : null] ?? null,
+                    },
+                    organization:  feature?.properties?.parameters?.WMOidentifier?.[0],
+                    ugc: feature?.properties?.geocode?.UGC ?? [], 
+                    polygon: feature?.geometry?.coordinates.length > 0 ? Buffer.from(JSON.stringify([feature?.geometry?.coordinates[0]])).toString('base64') : null,
+                    polygon_generated: feature?.geometry?.coordinates.length > 0 ? true : false,
+                },
+                parameters: {
+                    tags: getEventTags(feature?.properties?.description),
+                    instructions: feature?.properties?.instruction ?? null,
+                    source: getTextFromProduct({ message: feature?.properties?.description, find: [`SOURCE...`], removal: [`.`]}) ?? null,
+                    hazards: getTextFromProduct({ message: feature?.properties?.description, find: [`HAZARD...`], removal: [`.`]}) ?? null,
+                    impacts: getTextFromProduct({ message: feature?.properties?.description, find: [`IMPACT...`], removal: [`.`]}) ?? null,
+                    estimated_hail_size: feature?.properties?.parameters?.maxHailSize?.[0] ?? null,
+                    estimated_wind_gusts: feature?.properties?.parameters?.maxWindGust?.[0] ?? null,
+                    damage_threat: feature?.properties?.parameters?.thunderstormDamageThreat?.[0] ?? null,
+                    tornado_threat: feature?.properties?.parameters?.tornadoDetection?.[0] ?? null,
+                    flood_threat: feature?.properties?.parameters?.floodDetection?.[0] ?? null,
+                    wind_threat: feature?.properties?.parameters?.windThreat?.[0] ?? null,
+                    hail_threat: feature?.properties?.parameters?.hailThreat?.[0] ?? null,
+                },
+                spc_parameters: {
+                    spc_max_tornado: getTextFromProduct({ message: feature?.properties?.description, find: [`MOST PROBABLE PEAK TORNADO INTENSITY...`] }) ?? null,
+                    spc_max_hail: getTextFromProduct({ message: feature?.properties?.description, find: [`MOST PROBABLE PEAK HAIL SIZE...`] }) ?? null,
+                    spc_max_wind: getTextFromProduct({ message: feature?.properties?.description, find: [`MOST PROBABLE PEAK WIND GUST...`] }) ?? null,
+                    spc_watch_issuance: getTextFromProduct({ message: feature?.properties?.description, find: [`Probability of Watch Issuance...`], removal: [`percent`]}) ?? null,
+                },
+                watch_parameters: {
+                    watch_number: getTextFromProduct({ message: feature?.properties?.description, find: [`ITIES FOR`, `UPDATE FOR`, `Watch Number `], removal: [`%`, `<`, `:`] })?.replace(/(WT|WS|)/g, '')?.trim() ?? null,
+                    watch_type: feature?.properties?.description.includes(`TORNADO WATCH`) ? `Tornado` : feature?.properties?.description.includes(`SEVERE`) ? `Severe` : null,
+                    additional_tornadoes_probability: getTextFromProduct({ message: feature?.properties?.description, find: [`PROB OF 2 OR MORE TORNADOES`], removal: [`%`, `<`, `:`] }) ?? null,
+                    strong_tornadoes_probability: getTextFromProduct({ message: feature?.properties?.description, find: [`PROB OF 1 OR MORE STRONG /EF2-EF5/ TORNADOES`], removal: [`%`, `<`, `:`] }) ?? null,
+                    severe_wind_probability: getTextFromProduct({ message: feature?.properties?.description, find: [`PROB OF 10 OR MORE SEVERE WIND EVENTS`], removal: [`%`, `<`, `:`] }) ?? null,
+                    severe_hail_probability: getTextFromProduct({ message: feature?.properties?.description, find: [`PROB OF 10 OR MORE SEVERE HAIL EVENTS`], removal: [`%`, `<`, `:`] }) ?? null,
+                    hail_2in_probability: getTextFromProduct({ message: feature?.properties?.description, find: [`PROB OF 1 OR MORE HAIL EVENTS >= 2 INCHES`], removal: [`%`, `<`, `:`] }) ?? null,
+                    combined_hail_wind_probability: getTextFromProduct({ message: feature?.properties?.description, find: [`PROB OF 6 OR MORE COMBINED SEVERE HAIL/WIND EVENTS`], removal: [`%`, `<`, `:`] }) ?? null,
+                    max_hail_in: getTextFromProduct({ message: feature?.properties?.description, find: [`MAX HAIL /INCHES/`], removal: [`%`, `<`, `:`] }) ?? null,
+                    max_wind_surface:  getTextFromProduct({ message: feature?.properties?.description, find: [`MAX WIND GUSTS SURFACE /KNOTS/`], removal: [`%`, `<`, `:`] }) ?? null,
+                    max_tops_x100feet:  getTextFromProduct({ message: feature?.properties?.description, find: [`MAX TOPS /X 100 FEET/`], removal: [`%`, `<`, `:`] }) ?? null,
+                    pds_watch: (getTextFromProduct({ message: feature?.properties?.description, find: [`PARTICULARLY DANGEROUS SITUATION`], removal: [`%`, `<`, `:`] }) === `YES`)
+                },
+                metadata: {
+                    ms: performance.now() - tick,
+                    source: `events.api`,
+                    tracking: getEventTracking({ type: `API`, organization: { wmoidentifier: feature?.properties?.parameters?.WMOidentifier?.[0], featureId: feature?.id}, vtec: pVtec}),
+                    header: `ZCZC-ATMOSX-${feature?.properties?.parameters?.WMOidentifier}`,
+                    vtec: pVtec,
+                    hvtec: null,
+                    history: [
+                        {
+                            description: feature?.properties?.description,
+                            issued: feature?.properties?.sent ? new Date(feature?.properties?.sent).toISOString() : null,
+                            status: feature?.properties?.messageType ?? null,
+                        }
+                    ]
+                }
+            }
+        })
+    }
+    validateEvents(processed)
+}

package/src/@events/events.text.ts

@@ -0,0 +1,79 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeStanzaCompiled } from "../@types/types.compiled"
+import { TypeEvent } from "../@types/type.event";
+import { properties } from "../@building/building.properties";
+import { getEventHeader } from "../@building/building.headers";
+import { eventsOffshore } from "../@dictionaries/dictionaries.eventsOffshore";
+import { getEventTracking } from "../@building/building.tracking";
+import { validateEvents } from "../@building/building.validate";
+
+export const text = async (stanza: TypeStanzaCompiled): Promise<void> => {
+    let processed: TypeEvent[] = [];
+    const getMessages = stanza?.message
+        ?.split(/(?=\$\$)/g)
+        ?.map(message => message.trim())
+        ?.filter(message => message && message !== "$$");
+    if (!getMessages || getMessages?.length == 0 ) return;
+    for (const message of getMessages) {
+        const tick = performance.now();
+        const attributes = stanza?.attributes as TypeAttributes
+        const props = properties({ message, attributes })
+        const header = getEventHeader({properties: props, getType: stanza.getType})   
+        const issued = new Date(attributes.issue)
+        const expires = new Date(issued.getTime() + 12 * 60 * 60 * 1000)
+        let event = Object.keys(eventsOffshore).find(event => message.toLowerCase().includes(event.toLowerCase()));
+        if (!event) { 
+            event = stanza.getType.type.split(`-`).map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(` `)
+        }
+        processed.push({
+            type: `Feature`,
+            geometry: {
+                type: `Point`,
+                coordinates: []
+            },
+            properties: { 
+                event: event,
+                parent: event,
+                status: `Issued`,
+                issued: (!isNaN(issued.getTime())) ? issued.toISOString() : new Date().toISOString(),
+                expires: (!isNaN(expires.getTime())) ? expires.toISOString() : new Date(Date.now() + 60 * 60 * 1000).toISOString(),
+                ...props,
+                metadata: {
+                    ms: performance.now() - tick,
+                    source: `events.text`,
+                    tracking: getEventTracking({ type: `RAW`, stanza, attributes, properties: props }),
+                    header: header,
+                    vtec: null,
+                    hvtec: null,
+                    history: [
+                        {
+                            description: props.description,
+                            issued: (!isNaN(issued.getTime())) ? issued.toISOString() : new Date().toISOString(),
+                            status: `Issued`,
+                        }
+                    ]
+                }
+            }
+        })  
+    }
+    validateEvents(processed)
+}

package/src/@events/events.ugc.ts

@@ -0,0 +1,83 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeStanzaCompiled } from "../@types/types.compiled"
+import { TypeEvent } from "../@types/type.event";
+import { eventsOffshore } from "../@dictionaries/dictionaries.eventsOffshore";
+import { ugcExtract } from "../@parsers/@ugc/ugc.extract";
+import { properties } from "../@building/building.properties";
+import { getEventHeader } from "../@building/building.headers";
+import { getEventTracking } from "../@building/building.tracking";
+import { validateEvents } from "../@building/building.validate";
+
+export const ugc = async (stanza: TypeStanzaCompiled): Promise<void> => {
+    let processed: TypeEvent[] = [];
+    const getMessages = stanza?.message
+        ?.split(/(?=\$\$)/g)
+        ?.map(message => message.trim())
+        ?.filter(message => message && message !== "$$");
+    if (!getMessages || getMessages?.length == 0 ) return;
+    for (const message of getMessages) {
+        const tick = performance.now();
+        const attributes = stanza?.attributes as TypeAttributes
+        const ugc = await ugcExtract(message)
+        if (ugc != null ) {
+            const props = properties({ message, attributes, ugc: ugc })
+            const issued = new Date(attributes.issue)
+            const expires = new Date(issued.getTime() + 12 * 60 * 60 * 1000)
+            const header = getEventHeader({properties: props, getType: stanza.getType })
+            let event = Object.keys(eventsOffshore).find(event => message.toLowerCase().includes(event.toLowerCase()));
+            if (!event) { 
+                event = stanza.getType.type.split(`-`).map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(` `)
+            }
+            processed.push({
+                type: `Feature`,
+                geometry: {
+                    type: `Point`,
+                    coordinates: []
+                },
+                properties: { 
+                    event: event,
+                    parent: event,
+                    status: `Issued`,
+                    issued: (!isNaN(issued.getTime())) ? issued.toISOString() : new Date().toISOString(),
+                    expires: (!isNaN(expires.getTime())) ? expires.toISOString() : new Date(Date.now() + 60 * 60 * 1000).toISOString(),
+                    ...props,
+                    metadata: {
+                        ms: performance.now() - tick,
+                        source: `events.ugc`,
+                        tracking: getEventTracking({ type: `RAW`, stanza, attributes, properties: props }),
+                        header: header,
+                        vtec: null,
+                        hvtec: null,
+                        history: [
+                            {
+                                description: props.description,
+                                issued: (!isNaN(issued.getTime())) ? issued.toISOString() : new Date().toISOString(),
+                                status: `Issued`
+                            }
+                        ]
+                    }
+                }
+            })
+        }
+    }
+    validateEvents(processed)
+}

package/src/@events/events.vtec.ts

@@ -0,0 +1,87 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeStanzaCompiled } from "../@types/types.compiled"
+import { TypeEvent } from "../@types/type.event";
+import { TypePVTEC } from "../@types/types.pvtec";
+import { TypeHVTEC } from "../@types/types.hvtec";
+import { pvExtract } from "../@parsers/@pvtec/pvtec.extract";
+import { hvExtract } from "../@parsers/@hvtec/hvtec.extract";
+import { ugcExtract } from "../@parsers/@ugc/ugc.extract";
+import { properties } from "../@building/building.properties";
+import { getEventHeader } from "../@building/building.headers";
+import { getEventTracking } from "../@building/building.tracking";
+import { validateEvents } from "../@building/building.validate";
+
+export const vtec = async (stanza: TypeStanzaCompiled): Promise<void> => {
+    let processed: TypeEvent[] = [];
+    const getMessages = stanza?.message
+        ?.split(/(?=\$\$)/g)
+        ?.map(message => message.trim())
+        ?.filter(message => message && message !== "$$");
+    if (!getMessages || getMessages?.length == 0 ) return;
+    for (const message of getMessages) {
+        const tick = performance.now();
+        const attributes = stanza?.attributes as TypeAttributes
+        const pVtec = await pvExtract(message) as TypePVTEC[];
+        const hVtec = await hvExtract(message) as TypeHVTEC[];
+        const ugc = await ugcExtract(message)
+        if (pVtec != null && ugc != null ) {
+            for (const pv of pVtec) {
+                const vtec = pv;
+                const props = properties({ message, attributes, ugc, pVtec: vtec })
+                const header = getEventHeader({properties: props, getType: stanza.getType, vtec: vtec})
+                const issued = new Date(attributes.issue)?? new Date()
+                const expires = new Date(vtec.expires)
+                processed.push({
+                    type: `Feature`,
+                    geometry: {
+                        type: `Point`,
+                        coordinates: []
+                    },
+                    properties: { 
+                        event: pv.event,
+                        parent: pv.event,
+                        status: pv.status,
+                        issued: (!isNaN(issued.getTime())) ? issued.toISOString() : new Date().toISOString(),
+                        expires: (!isNaN(expires.getTime())) ? expires.toISOString() : new Date(Date.now() + 60 * 60 * 1000).toISOString(),
+                        ...props,
+                        metadata: {
+                            ms: performance.now() - tick,
+                            source: `events.vtec`,
+                            tracking: getEventTracking({ type: `VTEC`, stanza, attributes, properties: props, vtec }),
+                            header: header,
+                            vtec: pv.vtec,
+                            hvtec: hVtec,
+                            history: [
+                                {
+                                    description: props.description,
+                                    issued: (!isNaN(issued.getTime())) ? issued.toISOString() : new Date().toISOString(),
+                                    status: pv.status
+                                }
+                            ]
+                        }
+                    }
+                })
+            }
+        }
+    }
+    validateEvents(processed)
+}

package/src/@manager/manager.mkEvent.ts

@@ -0,0 +1,79 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { setEventEmit } from "../@modules/@utilities/utilities.setEventEmit";
+import { TypeEvent } from "../@types/type.event";
+import { bootstrap } from "../bootstrap"
+import { setHash } from "./manager.setHash";
+
+export const mkEvent = async (event: TypeEvent): Promise<void> => {
+    const features = bootstrap.cache.events.features;
+    const featureMap: Map<string, typeof features[0]> = new Map();
+    const getHash = event.properties.metadata.hash;
+    const getTracking = event.properties.metadata.tracking;
+    features.forEach(f => f?.properties?.metadata?.tracking && featureMap.set(f?.properties?.metadata?.tracking, f));
+    const isEntry = bootstrap.cache.hashes?.find(hash => hash.tracking === getTracking)
+    const isHashed = isEntry?.hashes?.includes(getHash) ?? false;
+    const getFeature = featureMap.get(getTracking);
+    if (isHashed || event.properties.status_metadata.is_expired) return
+    setEventEmit({
+        event: `onEventStatus`,
+        metadata: {
+            type: getFeature ? `Updated` : `New`,
+            event: event
+        },
+        message: `[${getFeature ? 'Updated' : 'New'}] ${event.properties.event} (${event.properties.status}) (${event.properties.metadata.tracking})`
+    })
+    setHash(event, isEntry)
+    if (event.properties.status_metadata.is_issued || event.properties.status_metadata.is_updated) {
+        if (getFeature) { 
+            const getIndex = features.indexOf(getFeature);
+            const cHistory = getFeature?.properties?.metadata?.history ?? [];
+            const cLocations = getFeature?.properties?.locations?.split(";").map((l: string) => l.trim()) ?? [];
+            const cUgc = getFeature?.properties?.geocode?.ugc ?? [];
+
+            const iHistory = event.properties?.metadata?.history ?? [];
+            const iLocations = event.properties?.locations?.split(";").map((l: string) => l.trim()) ?? [];
+            const iUgc = event.properties?.geocode?.ugc ?? [];
+
+            const mHistory = [...cHistory, ...iHistory].filter((v, i, a) => a.indexOf(v) === i);
+            const mLocations = [...cLocations, ...iLocations].filter((v, i, a) => a.indexOf(v) === i).join('; ');
+            const mUgc = [...cUgc, ...iUgc].filter((v, i, a) => a.indexOf(v) === i);
+
+            bootstrap.cache.events.features[getIndex] = {
+                ...event,
+                properties: {
+                    ...event.properties,
+                    metadata: {
+                        ...event?.properties?.metadata,
+                        history: mHistory
+                    },
+                    locations: mLocations,
+                    geocode: {
+                        ...event?.properties?.geocode,  
+                        ugc: mUgc
+                    },
+                }
+            };
+        } else { 
+            features.push(event)
+            featureMap.set(getTracking, event)
+        }
+    }
+}

package/src/@manager/manager.rmEvent.ts

@@ -0,0 +1,44 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { setEventEmit } from "../@modules/@utilities/utilities.setEventEmit";
+import { TypeEvent } from "../@types/type.event";
+import { bootstrap } from "../bootstrap"
+
+export const rmEvent = (event: TypeEvent): void => {
+    const getEvent = bootstrap.cache.events.features.find(f => f?.properties?.metadata?.tracking === event?.properties?.metadata?.tracking);
+    if (getEvent) {
+        setEventEmit({
+            event: `onEventStatus`,
+            metadata: {
+                type: `Removed`,
+                event: event
+            },
+            message: `[Removed] ${event.properties.event} (${event.properties.status}) (${event.properties.metadata.tracking})`
+        })
+        setEventEmit({ event: `onExpiredProduct`, metadata: event })
+        bootstrap.cache.events.features.splice(bootstrap.cache.events.features.indexOf(getEvent), 1);
+        bootstrap.cache.hashes = bootstrap.cache.hashes.filter(hash => hash.tracking !== event.properties.metadata.tracking);
+    }
+    setEventEmit({
+        event: `onEventCache`,
+        metadata: bootstrap.cache.events,
+        limited: true
+    })
+}

package/src/@manager/manager.setHash.ts

@@ -0,0 +1,37 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { TypeEvent } from "../@types/type.event";
+import { TypeHash } from "../@types/types.hash"
+import { bootstrap } from "../bootstrap"
+
+
+export const setHash = (event: TypeEvent, entry: TypeHash): void => {
+    if (entry) {
+        entry.hashes.push(event.properties.metadata.hash);
+        entry.expires = event.properties.expires;
+    } else { 
+        bootstrap.cache.hashes.push({
+            tracking: event.properties.metadata.tracking,
+            hashes: [event.properties.metadata.hash],
+            expires: event.properties.expires
+        });
+    }
+    
+}

package/src/@manager/manager.updateNodes.ts

@@ -0,0 +1,51 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { getEventNodes } from "../@building/building.polygon";
+import { setEventEmit } from "../@modules/@utilities/utilities.setEventEmit";
+import { bootstrap } from "../bootstrap"
+
+
+export const updateNodes = async (): Promise<void> => {
+    const events = bootstrap.cache.events.features;
+    const ttl = bootstrap.settings.GlobalSettings.NodeTTL * 1e3;
+    let total = 0;
+    await Promise.all(events.map(async (evt) => {
+        const lastUpdate = evt?.properties?.metadata?.nodes_updated ?? null;
+        if (lastUpdate != null && (Date.now() - lastUpdate) < ttl) {
+            return evt;
+        }
+        const node = await getEventNodes(evt);
+        if (node.nodes.length > 0) {
+            total++
+        }
+        evt.properties.metadata.nodes = node.nodes
+        evt.properties.metadata.filtered_proximity = node.filtered
+        evt.properties.metadata.nodes_updated = node.updated
+    }))
+    if (total > 0) {
+        setEventEmit({
+            event: `onNodeUpdate`,
+            metadata: {
+                type: `global-update`,
+                updated: total
+            },
+        })
+    }
+}

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

@@ -0,0 +1,48 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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'
+import { setWarning } from '../@utilities/utilities.setWarning';
+import { createEvent } from '../../@building/building.create';
+
+export const getCachedEvents = async (): Promise<void> => {
+    try { 
+        const settings = bootstrap.settings as TypeSettings;
+        const tick = performance.now();
+        if (settings.NOAAWeatherWireServiceSettings.CacheSettings.Enabled) {
+            const max = settings.NOAAWeatherWireServiceSettings.CacheSettings.MaxRetentionHistory ?? 500;
+            const get = await bootstrap.database.prepare(`SELECT * FROM stanzas ORDER BY rowid DESC LIMIT ?`).all(max) as { rowid: number; stanza: string }[];
+            setWarning({ message: `Fetched ${get.length} cached events from the database in ${Math.floor(performance.now() - tick)} ms` })
+            let events = get.map((row) => JSON.parse(row.stanza))
+                .filter(stanza => {
+                    if (!stanza) { return }
+                    const isSkippable = stanza.isIgnored ||
+                        (stanza.isCapEvent) ||
+                        (stanza.isCapEvent && !stanza.isCapAreaDescription)
+                    return !isSkippable
+                });
+            events = events.sort((a, b) => b.issued - a.issued)
+            await Promise.all(events.map(event => createEvent(event)))
+            setWarning({ message: `Processed ${events.length} cached events in ${Math.floor(performance.now() - tick)} ms` })
+        }
+    } catch (error) {
+        setWarning({ message: `An error occurred while fetching cached events: ${error.message} -> ${error.stack}` })
+    }
+}