@atmosx/event-product-parser 3.0.51 → 3.0.52

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

@@ -1,50 +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 { TypeSettings } from "../../@types/type.settings"
-import { bootstrap } from '../../bootstrap'
-import { setWarning } from '../@utilities/utilities.setWarning';
-import { createEvent } from '../../@building/building.create';
-import { validateEvents } from "../../@building/building.validate";
-
-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 stanzas 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, true)))
-            setWarning({ message: `Processed ${events.length} cached stanzas in ${Math.floor(performance.now() - tick)} ms` })
-            validateEvents(bootstrap.cache.processed)
-        }
-    } catch (error) {
-        setWarning({ message: `An error occurred while fetching cached stanzas: ${error.message} -> ${error.stack}` })
-    }
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeSettings } from "../../@types/type.settings"
+import { bootstrap } from '../../bootstrap'
+import { setWarning } from '../@utilities/utilities.setWarning';
+import { createEvent } from '../../@building/building.create';
+import { validateEvents } from "../../@building/building.validate";
+
+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 stanzas 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, true)))
+            setWarning({ message: `Processed ${events.length} cached stanzas in ${Math.floor(performance.now() - tick)} ms` })
+            validateEvents(bootstrap.cache.processed)
+        }
+    } catch (error) {
+        setWarning({ message: `An error occurred while fetching cached stanzas: ${error.message} -> ${error.stack}` })
+    }
 }

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

@@ -1,59 +1,59 @@
-/*
-              _                             _               _     __   __
-         /\  | |                           | |             (_)    \ \ / /
-        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
-       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
-      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
-     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
-                                     | |                            
-                                     |_|                                                                                                                
-
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
-    Discord: https://atmosphericx-discord.scriptkitty.cafe
-    Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
-
-    Internal Package: @atmosx/event-product-parser
-
-*/
-
-
-import { TypeSettings } from "../../@types/type.settings"
-import { bootstrap } from "../../bootstrap"
-import { setWarning } from '../@utilities/utilities.setWarning'
-import { importShapefiles } from './database.shapefiles'
-import { importBroadcastify } from "./database.broadcastify"
-import { existsSync, writeFileSync } from "fs"
-import sqlite3 from 'better-sqlite3'
-
-export const initializeDatabase = async (): Promise<void> => {
-    const settings = bootstrap.settings as TypeSettings;
-    try { 
-        if (!existsSync(settings.Database)) { 
-            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();
-        const isNeedingShapefiles = bootstrap.database
-            .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='shapefiles';`)
-            .get();
-        const isNeedingBroadcastify = bootstrap.database
-            .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='broadcastify';`)
-            .get();
-
-        if (!isNeedingShapefiles || !isNeedingBroadcastify) {
-            setWarning({message: `Required database tables are currently building, please ${bootstrap.ansi_colors.RED}DO NOT${bootstrap.ansi_colors.RESET} close your terminal. The building will not finish and will remain incomplete. If you do mess up, you will need to delete ${settings.Database} and restart the application.` })
-            await importBroadcastify();
-            await importShapefiles();
-            setWarning({ message: `Building has completed, you can now continue or close the terminal`})
-        }
-    } catch (error) {
-        setWarning({ message: `An error occurred while initializing the database: ${error.message}` })
-    }
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+
+import { TypeSettings } from "../../@types/type.settings"
+import { bootstrap } from "../../bootstrap"
+import { setWarning } from '../@utilities/utilities.setWarning'
+import { importShapefiles } from './database.shapefiles'
+import { importBroadcastify } from "./database.broadcastify"
+import { existsSync, writeFileSync } from "fs"
+import sqlite3 from 'better-sqlite3'
+
+export const initializeDatabase = async (): Promise<void> => {
+    const settings = bootstrap.settings as TypeSettings;
+    try { 
+        if (!existsSync(settings.Database)) { 
+            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();
+        const isNeedingShapefiles = bootstrap.database
+            .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='shapefiles';`)
+            .get();
+        const isNeedingBroadcastify = bootstrap.database
+            .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='broadcastify';`)
+            .get();
+
+        if (!isNeedingShapefiles || !isNeedingBroadcastify) {
+            setWarning({message: `Required database tables are currently building, please ${bootstrap.ansi_colors.RED}DO NOT${bootstrap.ansi_colors.RESET} close your terminal. The building will not finish and will remain incomplete. If you do mess up, you will need to delete ${settings.Database} and restart the application.` })
+            await importBroadcastify();
+            await importShapefiles();
+            setWarning({ message: `Building has completed, you can now continue or close the terminal`})
+        }
+    } catch (error) {
+        setWarning({ message: `An error occurred while initializing the database: ${error.message}` })
+    }
 }

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

@@ -1,93 +1,93 @@
-/*
-              _                             _               _     __   __
-         /\  | |                           | |             (_)    \ \ / /
-        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
-       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
-      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
-     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
-                                     | |                            
-                                     |_|                                                                                                                
-
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
-    Discord: https://atmosphericx-discord.scriptkitty.cafe
-    Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
-
-    Internal Package: @atmosx/event-product-parser
-
-*/
-
-import { TypeSettings } from "../../@types/type.settings"
-import { dict_shapefiles } from '../../@dictionaries/dictionaries.shapefiles'
-import { bootstrap } from "../../bootstrap"
-import { setSleep } from '../@utilities/utilities.setSleep'
-import { setWarning } from '../@utilities/utilities.setWarning'
-import { existsSync, mkdirSync, writeFileSync, unlinkSync, rm } from "fs"
-import { resolve, extname} from 'path'
-import { loadAsync } from 'jszip'
-import { read } from 'shapefile'
-
-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});
-            for (const shapefile of dict_shapefiles) {
-                const response = await fetch(shapefile.link);
-                const arrayBuff = await response.arrayBuffer();
-                const content = await loadAsync(arrayBuff);
-                const directory = resolve(__dirname, `../../shapefiles`);
-                if (!existsSync(directory)) {
-                    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)}`)
-                        writeFileSync(output, data)
-                    }
-                }
-                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} for Shapefiles` })
-                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));
-                    }
-                })
-                unlinkSync(`${filepath}.shp`)
-                unlinkSync(`${filepath}.dbf`)
-                transaction(features)
-            }
-            rm(resolve(__dirname, '../../shapefiles'), { recursive: true, force: true }, () => {});
-        }
-    } catch (error) {
-        setWarning( {message: `An error occurred while compiling shapefiles: ${error.message}` }) 
-    }
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeSettings } from "../../@types/type.settings"
+import { dict_shapefiles } from '../../@dictionaries/dictionaries.shapefiles'
+import { bootstrap } from "../../bootstrap"
+import { setSleep } from '../@utilities/utilities.setSleep'
+import { setWarning } from '../@utilities/utilities.setWarning'
+import { existsSync, mkdirSync, writeFileSync, unlinkSync, rm } from "fs"
+import { resolve, extname} from 'path'
+import { loadAsync } from 'jszip'
+import { read } from 'shapefile'
+
+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});
+            for (const shapefile of dict_shapefiles) {
+                const response = await fetch(shapefile.link);
+                const arrayBuff = await response.arrayBuffer();
+                const content = await loadAsync(arrayBuff);
+                const directory = resolve(__dirname, `../../shapefiles`);
+                if (!existsSync(directory)) {
+                    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)}`)
+                        writeFileSync(output, data)
+                    }
+                }
+                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} for Shapefiles` })
+                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));
+                    }
+                })
+                unlinkSync(`${filepath}.shp`)
+                unlinkSync(`${filepath}.dbf`)
+                transaction(features)
+            }
+            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

@@ -1,47 +1,47 @@
-/*
-              _                             _               _     __   __
-         /\  | |                           | |             (_)    \ \ / /
-        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
-       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
-      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
-     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
-                                     | |                            
-                                     |_|                                                                                                                
-
-    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
-    Discord: https://atmosphericx-discord.scriptkitty.cafe
-    Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
-
-    Internal Package: @atmosx/event-product-parser
-
-*/
-
-import { TypeSettings } from "../../@types/type.settings"
-import { TypeStanzaCompiled } from '../../@types/type.compiled';
-import { bootstrap } from '../../bootstrap'
-import { setWarning } from '../@utilities/utilities.setWarning';
-
-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)
-        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}` })
-    }
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+
+    Internal Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeSettings } from "../../@types/type.settings"
+import { TypeStanzaCompiled } from '../../@types/type.compiled';
+import { bootstrap } from '../../bootstrap'
+import { setWarning } from '../@utilities/utilities.setWarning';
+
+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)
+        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}` })
+    }
 }