@atmosx/event-product-parser 3.0.0 → 3.0.2

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -40,8 +40,8 @@ export const vtec = async (stanza: TypeStanzaCompiled): Promise<void> => {
     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 pVtec = pvExtract(message) as TypePVTEC[];
+        const hVtec = hvExtract(message) as TypeHVTEC[];
         const ugc = await ugcExtract(message)
         if (pVtec != null && ugc != null ) {
             for (const pv of pVtec) {
@@ -61,14 +61,14 @@ export const vtec = async (stanza: TypeStanzaCompiled): Promise<void> => {
                         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(),
+                        expires: (!isNaN(expires.getTime())) ? expires.toISOString() : ugc.expires ??  new Date(issued.getTime() + 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,
+                            vtec: pv,
                             hvtec: hVtec,
                             history: [
                                 {

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -21,17 +21,32 @@ import { setEventEmit } from "../@modules/@utilities/utilities.setEventEmit";
 import { TypeEvent } from "../@types/type.event";
 import { bootstrap } from "../bootstrap"
 import { setHash } from "./manager.setHash";
+import { updateWebhooks } from "./manager.updateWebhooks";
+import { updateNode } from "./manager.updateNodes";
+import { TypeSettings } from "../@types/types.settings";
 
 export const mkEvent = async (event: TypeEvent): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
     const features = bootstrap.cache.events.features;
-    const featureMap: Map<string, typeof features[0]> = new Map();
+    const map = new Map<string, typeof features[0]>();
+    
+    for (const f of features) {
+        const key = f?.properties?.metadata?.tracking;
+        if (!key) continue;
+        map.set(key, f);
+    }
+    
     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);
+    const getFeature = map.get(getTracking);
+    
     if (isHashed || event.properties.status_metadata.is_expired) return
+    await setHash(event, isEntry)
+    const isFilteredLocation = await updateNode(event).then(() => event.properties.metadata.filtered_proximity);
+    if (!isFilteredLocation && settings.GlobalSettings.EventFiltering.NodeLocationFiltering) { return }
+
     setEventEmit({
         event: `onEventStatus`,
         metadata: {
@@ -40,40 +55,41 @@ export const mkEvent = async (event: TypeEvent): Promise<void> => {
         },
         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)
+    if (settings.GlobalSettings.EventManagement) {
+        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)
+            }
         }
     }
+    updateWebhooks(event)
 }

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -20,9 +20,13 @@
 import { setEventEmit } from "../@modules/@utilities/utilities.setEventEmit";
 import { TypeEvent } from "../@types/type.event";
 import { bootstrap } from "../bootstrap"
+import { updateWebhooks } from "./manager.updateWebhooks";
 
 export const rmEvent = (event: TypeEvent): void => {
     const getEvent = bootstrap.cache.events.features.find(f => f?.properties?.metadata?.tracking === event?.properties?.metadata?.tracking);
+    const cachedStatus = event.properties.status;
+    event.properties.expires = new Date().toISOString();
+    event.properties.status = `Expired`;
     if (getEvent) {
         setEventEmit({
             event: `onEventStatus`,
@@ -33,6 +37,7 @@ export const rmEvent = (event: TypeEvent): void => {
             message: `[Removed] ${event.properties.event} (${event.properties.status}) (${event.properties.metadata.tracking})`
         })
         setEventEmit({ event: `onExpiredProduct`, metadata: event })
+        if (cachedStatus != `Statement`) updateWebhooks(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);
     }

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -22,7 +22,7 @@ import { TypeHash } from "../@types/types.hash"
 import { bootstrap } from "../bootstrap"
 
 
-export const setHash = (event: TypeEvent, entry: TypeHash): void => {
+export const setHash = async (event: TypeEvent, entry: TypeHash): Promise<void> => {
     if (entry) {
         entry.hashes.push(event.properties.metadata.hash);
         entry.expires = event.properties.expires;

package/src/@manager/manager.updateEvents.ts

@@ -0,0 +1,35 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { getFormattedTime } from "../@modules/@utilities/utilities.getFormattedTime";
+import { TypeEvent } from "../@types/type.event";
+import { bootstrap } from "../bootstrap"
+import { rmEvent } from "./manager.rmEvent";
+
+
+export const updateEvents = async (selectedEvent?: TypeEvent): Promise<void> => {
+    const events = bootstrap.cache.events.features;
+    async function update(evt: TypeEvent) {
+        if (new Date(evt.properties.expires) < new Date()) {
+            rmEvent(evt);
+        }
+    }
+    if (!selectedEvent) { await Promise.all(events.map(async (evt) => { await update(evt) })) } 
+    if (selectedEvent) { await update(selectedEvent) }
+}

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -19,15 +19,17 @@
 
 import { getEventNodes } from "../@building/building.polygon";
 import { setEventEmit } from "../@modules/@utilities/utilities.setEventEmit";
+import { TypeEvent } from "../@types/type.event";
 import { bootstrap } from "../bootstrap"
 
 
-export const updateNodes = async (): Promise<void> => {
+export const updateNode = async (selectedEvent?: TypeEvent): 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;
+
+    async function update(evt: TypeEvent) {
+        const lastUpdate = evt?.properties?.metadata?.updated ?? null;
         if (lastUpdate != null && (Date.now() - lastUpdate) < ttl) {
             return evt;
         }
@@ -37,8 +39,10 @@ export const updateNodes = async (): Promise<void> => {
         }
         evt.properties.metadata.nodes = node.nodes
         evt.properties.metadata.filtered_proximity = node.filtered
-        evt.properties.metadata.nodes_updated = node.updated
-    }))
+        evt.properties.metadata.updated = node.updated
+    }
+    if (!selectedEvent) { await Promise.all(events.map(async (evt) => { await update(evt) })) } 
+    if (selectedEvent) { await update(selectedEvent) }
     if (total > 0) {
         setEventEmit({
             event: `onNodeUpdate`,

package/src/@manager/manager.updateWebhooks.ts

@@ -0,0 +1,50 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 { createWebhook } from "../@modules/@utilities/utilities.createWebhook";
+import { TypeEvent } from "../@types/type.event";
+import { TypeWebhook } from "../@types/types.webhook";
+import { bootstrap } from "../bootstrap"
+
+
+export const updateWebhooks = async (event: TypeEvent): Promise<void> => {
+    const settings = bootstrap.settings;
+    const webhooks = settings.WebhookSettings as TypeWebhook[];
+    const eventName = event.properties.event;
+    for (const socket of webhooks) {
+        const events = socket.events;
+        if (!events || events.length === 0) {
+            await createWebhook({ webhook: socket, event });
+            continue;
+        }
+        const matched = events.some(pattern => {
+            if (!pattern) return false;
+            if (pattern === "*" || pattern === eventName) return true;
+            if (pattern.includes("*")) {
+                const regex = "^" +
+                    pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$";
+                return new RegExp(regex).test(eventName);
+            }
+            return false;
+        });
+        if (matched) {
+            await createWebhook({ webhook: socket, event });
+        }
+    }
+};

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -49,10 +49,9 @@ export const importShapefiles = async (): Promise<void> => {
                         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 filepath = resolve(__dirname, '../../shapefiles', shapefile.name + '_' + shapefile.id)
                 const { features } = await read(
                     filepath,
                     filepath,

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

@@ -8,7 +8,7 @@
                                      | |                            
                                      |_|                                                                                                                
 
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, Everwatch1, & CJ Ziegler)
+    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
@@ -26,6 +26,7 @@ import { TypeStanzaCompiled } from '../../@types/types.compiled';
 export const importStanza = async (stanza: TypeStanzaCompiled): Promise<void> => {
     const settings = bootstrap.settings as TypeSettings;
     try { 
+        if (!settings.NOAAWeatherWireServiceSettings.CacheSettings.Enabled) { return }
         bootstrap.database
             .prepare(`INSERT OR IGNORE INTO stanzas (type, stanza, issued) VALUES (?, ?, ?)`)
             .run(stanza.getType.type, JSON.stringify(stanza), stanza.attributes.issue)

package/src/@modules/@eas/eas.getFloatPCM16.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
+
+    
+*/
+
+export const getFloatPCM16 = (float32: Float32Array): Int16Array => {
+    const out = new Int16Array(float32.length);
+    for (let i = 0; i < float32.length; i++) {
+        let v = Math.max(-1, Math.min(1, float32[i]));
+        out[i] = Math.round(v * 32767);
+    }
+    return out;
+}
+

package/src/@modules/@eas/eas.getMergedPCM16.ts

@@ -0,0 +1,32 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 getMergedPCM16 = (arrays: Int16Array[]): Int16Array => {
+    let total = 0;
+    for (const a of arrays) total += a.length;
+    const out = new Int16Array(total);
+    let o = 0;
+    for (const a of arrays) {
+        out.set(a, o);
+        o += a.length;
+    }
+    return out;
+}
+

package/src/@modules/@eas/eas.getPCM16.ts

@@ -0,0 +1,52 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 getPCM16 = (samples: Record<string, number>[], sampleRate: number): Buffer => {
+    let o = 0;
+    const bytesPerSample = 2;
+    const blockAlign = 1 * bytesPerSample;
+    const byteRate = sampleRate * blockAlign;
+    const subchunk2Size = samples.length * bytesPerSample;
+    const chunkSize = 36 + subchunk2Size;
+    const buffer = Buffer.alloc(44 + subchunk2Size);
+ 
+    buffer.write("RIFF", o); o += 4;
+    buffer.writeUInt32LE(chunkSize, o); o += 4;
+    buffer.write("WAVE", o); o += 4;
+
+    buffer.write("fmt ", o); o += 4;
+    buffer.writeUInt32LE(16, o); o += 4;                 
+    buffer.writeUInt16LE(1, o); o += 2;                  
+    buffer.writeUInt16LE(1, o); o += 2;
+    buffer.writeUInt32LE(sampleRate, o); o += 4;
+    buffer.writeUInt32LE(byteRate, o); o += 4;
+    buffer.writeUInt16LE(blockAlign, o); o += 2;
+    buffer.writeUInt16LE(16, o); o += 2;
+
+    buffer.write("data", o); o += 4;
+    buffer.writeUInt32LE(subchunk2Size, o); o += 4;
+
+    for (let i = 0; i < samples.length; i++, o += 2) {
+        buffer.writeInt16LE(samples[i].value, o);
+    }
+    return buffer;
+}
+
+

package/src/@modules/@eas/eas.getPCMToFloat.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 getPCMToFloat = (int16: Int16Array): Float32Array => {
+    const out = new Float32Array(int16.length);
+    for (let i = 0; i < int16.length; i++) out[i] = int16[i] / 32768;
+    return out;
+}
+

package/src/@modules/@eas/eas.getSampledPCM16.ts

@@ -0,0 +1,36 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 getSampledPCM16 = (int16: Int16Array, originalRate: number, targetRate: number): Int16Array => {
+    if (originalRate === targetRate) return int16;
+    const ratio = targetRate / originalRate;
+    const outLen = Math.max(1, Math.round(int16.length * ratio));
+    const out = new Int16Array(outLen);
+    for (let i = 0; i < outLen; i++) {
+        const pos = i / ratio;
+        const i0 = Math.floor(pos);
+        const i1 = Math.min(i0 + 1, int16.length - 1);
+        const frac = pos - i0;
+        const v = int16[i0] * (1 - frac) + int16[i1] * frac;
+        out[i] = Math.round(v);
+    }
+    return out;
+}
+

package/src/@modules/@eas/eas.getWavPCM16.ts

@@ -0,0 +1,52 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ 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 getWavPCM16Response { 
+    samples: Int16Array
+    sampleRate: number
+    channels: number
+    bitsPerSample: number
+}
+
+export const getWavPCM16 = (buffer: Buffer): getWavPCM16Response => {
+    if (buffer.toString("ascii", 0, 4) !== "RIFF" || buffer.toString("ascii", 8, 12) !== "WAVE") { return null; }
+    let fmt = null;
+    let data = null;
+    let i = 12;
+    while (i + 8 <= buffer.length) {
+        const id = buffer.toString("ascii", i, i + 4);
+        const size = buffer.readUInt32LE(i + 4);
+        const start = i + 8;
+        const end = start + size;
+        if (id === "fmt ") fmt = buffer.slice(start, end);
+        if (id === "data") data = buffer.slice(start, end);
+        i = end + (size % 2); 
+    }
+    if (!fmt || !data) return null;
+    const audioFormat = fmt.readUInt16LE(0);
+    const channels = fmt.readUInt16LE(2);
+    const sampleRate = fmt.readUInt32LE(4);
+    const bitsPerSample = fmt.readUInt16LE(14);
+    if (audioFormat !== 1 || bitsPerSample !== 16 || channels !== 1) { return null; }
+    const samples = new Int16Array(data.buffer, data.byteOffset, data.length / 2);
+    return { samples: new Int16Array(samples), sampleRate, channels, bitsPerSample };
+}
+
+