@atmosx/event-product-parser 3.0.622 → 3.1.0

package/.github/CHANGELOGS.md

@@ -0,0 +1,52 @@
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
+
+## Changelogs
+
+### September 21st, 2026 - b3.1
+
+**Features**
+- add(theme): Ability to overwrite the default themes using `Manager.GlobalSettings.Themes`
+- add(nodes): Adds nearest location metadata.
+
+**Documentation**
+- feat(github): Added `CHANGELOGS.md` file to the repository for better version tracking and release notes for future releases. See [Changelogs](https://raw.githubusercontent.com/AtmosphericX/AtmosphericX/refs/heads/main/.github/CHANGELOG.md) for prior updates and release notes.
+- feat(github): Added `CODE_OF_CONDUCT.md` and `CONTRIBUTING.md` files to the repository for better community engagement and contribution guidelines.
+- feat(github): Added `SECURITY.md` file to the repository to outline security policies and procedures for reporting vulnerabilities.
+- feat(github): Improved the documentation pathing.
+- feat(docuimentation): Added `FUNDING.yaml` file to the repository to provide information on how to support the project financially.
+
+
+
+**Updates**
+- update(settings): `DebugDisableAllEvents` -> DeveloperDisableEvents.
+- update(settings): `EnableDebugging` -> DeveloperMode.
+- update(settings): `EnhancedEventJournaling` -> DeveloperEventLogging.
+- update(settings): `NodeTTL` -> NodePolygonTTL.
+
+**Deprecations**
+- deprecate(esm): ESM support is now deprecated. Please use the CJS version of the library instead.
+
+
+------------------------------------------------------------------------------------------------------------------------
+See [Changelogs](https://raw.githubusercontent.com/AtmosphericX/AtmosphericX/refs/heads/main/.github/CHANGELOG.md) for prior updates and release notes.

package/.github/CODE_OF_CONDUCT.md

@@ -1,4 +1,27 @@
-# Code of Conduct
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
+
+## Code of Conduct
 AtmosphericX is an independent, open source project and is **not** affiliated with, endorsed by, or sponsored by any government agency, meteorological organization, emergency management service, or official weather provider. This project may reference, parse, or process publicly available weather data, including but **not** limited to services operated by the National Weather Service (NWS) and the National Oceanic and Atmospheric Administration (NOAA). All trademarks, service marks, and data rights remain the property of their respective owners. AtmosphericX is provided "as is", without warranty of any kind, express or implied, including but **not** limited to:
 
 - Accuracy or completeness of parsed weather data

package/.github/CONTRIBUTING.md

@@ -1,6 +1,25 @@
-# Contributing
-
-This project is community driven and primarily maintained by `k3yomi`.
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
 
 ## How to Contribute
 

package/.github/FUNDING.yaml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+ko_fi: k3yomi

package/.github/LICENSE

@@ -1,4 +1,27 @@
-Copyright (c) 2026 k3yomi
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
+
+## Copyright (c) 2026 AtmosphericX
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to use,

package/.github/SECURITY.md

@@ -1,10 +1,31 @@
-# Security Policy
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
 
 ## Reporting Vulnerabilities
 If you discover a security vulnerability or issue in this repository such as exposed sensitive data, misconfigurations, or content that could cause harm. Please report it **immediately and responsibly**.  
 
 **Do not report security issues publicly.**  
-Instead, report privately by emailing **antimal@scriptkitty.cafe**, clearly describing the vulnerability.
+Instead, report privately by emailing [security@scriptkitty.cafe](mailto:security@scriptkitty.cafe), clearly describing the vulnerability.
 
 ## What to Include
 When reporting a vulnerability, please include:  
@@ -13,9 +34,7 @@ When reporting a vulnerability, please include:
 - Any recommendations  
 
 ## Response
-All reports will be reviewed and addressed as quickly as possible.  
-This is a community driven project, so response times may vary. Please allow up to a few weeks for a full response.  
+All reports will be reviewed and addressed as quickly as possible. This is a community driven project, so response times may vary. Please allow up to a few weeks for a full response.  
 
 ## Scope
-This repository **does not contain any credentials, keys, tokens, or personally identifiable information (PII)**.  
-If you discover any such data, report it immediately.
+This repository **does not contain any credentials, keys, tokens, or personally identifiable information (PII)**. If you discover any such data, report it immediately.

package/.github/docs/chapters/general-configurations.md

@@ -0,0 +1,109 @@
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
+
+# 3.0 - Configurations
+**@atmosx/event-product-parser** provides a wide range of configuration options, from basic event handling and management to advanced filtering capabilities and customizable event properties. This documentation provides an overview of every available configuration, including event settings, filtering options, and parser behavior, along with detailed explanations and practical examples to help you configure the parser for your specific use case.
+
+# 3.1 - Core Configurations
+
+## 3.1.1 - Timezone Handling
+Timezone handling is used to ensure that all event timestamps, push notifications, and other time sensitive operations are correctly aligned with the desired timezone. The parser supports both local and UTC timezones, allowing you to configure the parser to match your application's requirements.
+
+```ts
+new Manager({
+    Timezone: 'UTC', // 'America/New_York', 'Europe/London', etc. are also valid options
+})
+```
+
+## 3.1.2 - Database Management
+Databases are used to store and manage stanzas, geographic data, population, broadcastify feeds, and other relevant information that must be stored and easily accessed by the parser. By default, a path is already defined for the database, but you can customize the path to suit your application's needs.
+
+```ts
+new Manager({
+    Database: `product-parser-operations.db`, // Custom database path
+})
+```
+
+> [!DANGER]
+> It is imperative that you wait for **ALL** database operations to complete before forcing your application to close. Failure to do so may prevent important data from being fully processed, resulting in missing or incomplete records. If the application is restarted before the database has finished building, you must delete the existing database and allow the parser to rebuild it from scratch. A message will be logged to the console if the database is fully built and ready for use. All event processing is haulted until the database is fully built and ready for use.
+
+
+
+## 3.1.3 - Broadcastify Management & Filtering
+Broadcastify feeds can be attached to events based on their geographical location. The parser can filter available feeds by proximity, ensuring that events are associated only with relevant nearby feeds and providing additional audio context when available.
+
+```ts
+new Manager({
+    BroadcastifySettings: {
+        BroadcastifyAttachments: true, // Enable atatchment of Broadcastify feeds to events
+        BroadcastifyDatabase: `https://scriptkitty.cafe/ftp/@atmosphericx/assets/broadcastify.json`,
+        BroadcastifyTags: [`Ham`, `Air`, `Fire`, `Public Safety`, `Weather`, `EMS`, `Police`, `Rail`] // Filter by specific tags
+    }
+})
+```
+
+> [!IMPORTANT]
+> The availability of Broadcastify feeds are sourced from `scriptkitty.cafe` and are updated once per month. If you have any questions regarding the availability of Broadcastify feeds, please feel free to contact me directly.
+
+## 3.1.4 - Boundary & Population Data Management
+Boundary and population data provide additional geographic context for events, support the generation of graphics, and contribute to the calculation of a severity index based on the population potentially affected by an event. The parser uses proximity to associate events with relevant boundary and population data. This feature does not require any configuration. The required `.json` files are statically sourced from the `scriptkitty.cafe` server and are automatically retrieved by the parser.
+
+```ts
+new Manager({
+    BoundarySettings: {
+        BoundaryDatabase: `https://scriptkitty.cafe/ftp/@atmosphericx/assets/counties-10m.json`,
+        CityDatabase: `https://scriptkitty.cafe/ftp/@atmosphericx/assets/cities500.json`
+    },
+})
+```
+
+## 3.1.5 - NTFY Mobile Push Notifications
+This core parser feature enables mobile push notifications through the ntfy service. Notifications can be configured to trigger for specific event types, with options to customize the notification content, priority, media attachments, and other delivery settings. The feature is optional and can be enabled or disabled depending on your application's requirements.
+
+```ts
+new Manager({
+    NotifyServer: {
+        Enabled: false,
+        Server: `https://ntfy.sh`,
+        MediaStorage: {
+            AUDIO: `http_path_to_audio_storage`,
+            TEXT: `http_path_to_text_storage`,
+            JSON: `http_path_to_json_storage`,
+            IMAGE: `http_path_to_image_storage`,
+        },
+        Credentials: {
+            Username: `your_ntfy_username`,
+            Password: `your_ntfy_password`
+        }
+    },
+})
+```
+> [!WARNING]
+> If you plan on self hosting your own ntfy server, please ensure that you set the **upstream-base-url** to **https://ntfy.sh** in your **server.yml** file. This is required for proper delivery of push notifications.
+
+
+> [!TIP]
+> It's best to set your message retention to a maximum of **12 hours**. This ensures that messages are not retained for too long, which could lead to unnecessary storage usage and potential delays in message delivery.
+
+
+## 3.1.6 - Action Settings

package/.github/docs/chapters/sources-and-attributes.md

@@ -0,0 +1,219 @@
+<div align="center" style="margin-top: 20px;">
+    <a href="https://atmosphericx.scriptkitty.cafe">
+        <img src="https://scriptkitty.cafe/ftp/@atmosphericx/assets/logo-event-product-parser.png"
+             alt="@atmosx/event-product-parser"
+             width="800"/>
+    </a>
+    <p style="font-size: 1.1em; max-width: 700px;">
+        A robust TypeScript/JavaScript library for parsing and ingesting NOAA and NWS Weather Text Products, featuring an expanded suite of quality‑of‑life tools for faster, cleaner, and more reliable development.
+    </p>
+    <small style="display: block; margin-top: 10px;">
+        Built and maintained with ❤️ by the AtmosphericX team<br>
+        <i>Not affiliated with NOAA or NWS</i>
+    </small>
+    <hr style="width: 60%; margin: 25px auto; opacity: 0.3;">
+    <p style="text-align: center; font-size: 1.05em;">
+        <a href="https://atmosphericx.scriptkitty.cafe"><b>Official Documentation</b></a> &nbsp;•&nbsp;
+        <a href="https://github.com/AtmosphericX"><b>Github Organization</b></a> &nbsp;•&nbsp;
+        <a href="https://www.npmjs.com/search?q=%40atmosx"><b>Packages</b></a> &nbsp;•&nbsp;
+        <a href="/.github/CHANGELOGS.md"><b>Changelogs</b></a> &nbsp;•&nbsp;
+        <a href="https://atmosphericx-discord.scriptkitty.cafe"><b>Community Discord</b></a>
+    </p>
+</div>
+
+# 2.0 - Sources & Attributes
+
+**@atmosx/event-product-parser** supports multiple source attributes that allow you to customize how event products are ingested and processed. These configurations define the external services, connection methods, and parsing used by the parser to receive weather products. The available source configurations provide flexibility for different data ingestion requirements, allowing you to choose the appropriate source based on your application's needs while maintaining a consistent parsing experience.
+
+> [!IMPORTANT]
+> You can only use one source at any given time. Attempting to use multiple sources simultaneously will result in event conflicts and parsing issues.
+# 2.1 - NOAA Weather Wire Service
+[NOAA Weather Wire Service](https://www.weather.gov/nwws) is a real-time dissemination service that delivers official weather information, alerts, forecasts, products, and warnings in text format from NWS Weather Forecast Offices and National Centers. This service is designed for television and radio broadcasters, emergency managers, commercial alerting providers, private weather services, and other organizations that require rapid access to weather products.
+
+Each alert, forecast, and observation is delivered over [XMPP](https://xmpp.org/) using the standardized [WMO Header Format](#242---world-meteorological-organization-wmo-format). This provides a consistent structure for automated processing. 
+
+Accessing the NOAA Weather Wire Service requires credentials, which can be obtained by sending an email to [NWWS.Issue@noaa.gov](mailto:NWWS.Issue@noaa.gov).
+
+When requesting access, provide the following information:
+
+* Name (First and Last)
+* Company
+* Address
+* State, City, and ZIP Code
+* Telephone Number
+* Account Information: Single or Multiple Accounts
+
+NWS processing of your request may take as long as 10 days or more depending on critical weather days and NWS priority requirements.
+
+
+
+> [!IMPORTANT]
+> The National Weather Service (NWS) has officially proposed the retirement of the Satellite Broadcast Network (SBN), commonly known as NOAAPort, which could take effect as early as August 31, 2027. This means that this project will no longer look into supporting NOAAPort/SBN as a source for ingesting weather products. The NOAA Weather Wire Service (NWWS) will remain the primary source for ingesting weather products in real-time, and the NWS RESTful API will continue to provide on-demand access to weather data and products.
+
+## 2.1.1 - Basic Settings
+To configure properly, you must set **EnableWireService** to `true` and provide your credentials within **NOAAWeatherWireServiceSettings**. The following example demonstrates how to configure the parser to use the NOAA Weather Wire Service source using the `Manager` class.
+
+```ts
+new Manager({
+	EnableWireService: true, // Enable NOAA Weather Wire Service (NWWS)
+	NOAAWeatherWireServiceSettings: {
+		CredentialSettings: {
+			Username: `PUT_YOUR_USERNAME_HERE`, // Case sensitive
+			Password: `PUT_YOUR_PASSWORD_HERE`, // Case sensitive
+			Nickname: `PUT_YOUR_NICKNAME_HERE`, // Visible to other connected users
+		}
+	}
+})
+```
+
+## 2.1.2 - Connection Settings
+By default, the parser will attempt to reconnect if a stanza has not been received within the configured timeout period. The default reconnection interval is **60 seconds**. You can adjust this interval by modifying the **ReconnectInterval** property in **NOAAWeatherWireServiceSettings**.
+
+```ts
+NOAAWeatherWireServiceSettings: {
+    ReconnectionSettings: {
+        Enabled: true, // Enable auto reconnect
+        ReconnectionInterval: 60, // Time since last stanza before reconnecting (seconds)
+    }
+}
+```
+
+## 2.1.3 - Stanza Caching & Retention
+This package provides support for caching and retaining stanzas received from the XMPP client. Cached stanzas can be retained for later processing, allowing querying and analysis of historical weather products received from the NOAA Weather Wire Service. The following example demonstrates how to configure stanza caching and retention settings.
+
+```ts
+NOAAWeatherWireServiceSettings: {
+	CacheSettings: {
+		Enabled: true, // Enable stanza caching
+		MaxDatabaseHistory: 50000, // Maximum stanzas to store in the database
+		MaxRetentionHistory: 1200, // Maximum stanzas to load during startup
+	},
+},
+```
+
+
+## 2.1.4 - Stanza Processing & Filtering (Pre-Event Processing)
+While processing stanzas, each one is categorized based on its contents and characteristics. This includes formats such as [CAP (Common Alerting Protocol) v1.2](https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html), [VTEC](https://www.weather.gov/vtec/), [UGC](https://www.weather.gov/gis/AWIPSShapefiles), and **Text** products. By default, all product categories are enabled by default which includes: 
+
+* UGC/FIPS Based Products
+* VTEC/HVTEC + UGC/FIPS Products
+* Text (No UGC/FIPS/VTEC Present)
+
+
+```ts
+NOAAWeatherWireServiceSettings: {
+	StanzaSettings: {
+		DisableUGC: false, // Disables all UGC Categories
+		DisableVTEC: false, // Disables all VTEC/HVTEC Categories
+		DisableText: false, // Disables all RawText Categories
+	}
+},
+```
+
+
+> [!IMPORTANT]
+> Please keep in mind that CAP v1.2 products are not currently supported by this package and will be ignored during processing. Support for CAP v1.2 is planned for a future release.
+
+
+
+
+# 2.2 - National Weather Service API
+The [National Weather Service](https://www.weather.gov/) provides a [RESTful API](https://www.weather.gov/documentation/services-web-api) for programmatically accessing weather data and products. 
+
+Compared to the [NOAA Weather Wire Service](#21---noaa-weather-wire-service), the API introduces additional latency, with data typically delayed by 1 to 2 minutes on average. This delay is one of the primary tradeoffs when using the API instead of NOAA Weather Wire Service for real-time weather product ingestion.
+
+The NWS API is best suited for applications that require on demand access to weather data rather than the lowest possible latency delivery of operational weather products. All responses are provided in [GeoJSON](https://geojson.org/) format, making the data straightforward to parse and integrate into applications.
+
+# 2.2.1 - Basic Settings
+The **National Weather Service API** source requires minimal configuration and is the **default source** used by the parser. To use the NWS API, simply set **EnableWireService** to `false`. The following example demonstrates how to configure the parser to use the NWS API source using the `Manager` class.
+
+```ts
+new Manager({
+	EnableWireService: false, // Disable NOAA Weather Wire Service (NWWS)
+	NationalWeatherServiceSettings: {
+        CallbackInterval: 30, // How often it retrieves new products (Minimum: 15 seconds)
+        EventsEndpoint: `https://api.weather.gov/alerts/active`, // RESTful API
+    }
+})
+```
+
+You can also configure the **CallbackInterval** to control how frequently the parser retrieves new products from the NWS API. The minimum allowed interval is 15 seconds, and the default is 30 seconds.
+
+# 2.3 - NOAA Weather Wire Service vs NWS RESTful API
+There are significant differences between these two sources. [NOAA Weather Wire Service](#21---noaa-weather-wire-service) requires authenticated access and is optimized for real-time product delivery, while the [NWS RESTful API](#22---national-weather-service-api) is publicly accessible and designed for on demand data retrieval.
+
+| Feature | NOAA Weather Wire Service | NWS RESTful API |
+| --- | --- | --- |
+| Authentication | ✅ | ❌ |
+| Real-time Delivery | ✅ | ❌ |
+| WMO Formatting | ✅ | ❌ |
+| Persistent Connection | ✅ | ❌ |
+| Low Latency Products | ✅ | ❌ |
+| Easy to Use | ❌ | ✅ |
+| Publicly Accessible | ❌ | ✅ |
+
+# 2.4 - Formatting Standards
+The parser supports two primary formatting standards for weather products: **GeoJSON** and **WMO Format**. These formats provide structured representations of weather data, allowing for consistent parsing and processing of weather products.
+
+## 2.4.1 - GeoJSON Format
+
+[GeoJSON](https://geojson.org/) is a format for encoding a variety of geographic data structures. It is based on the JavaScript Object Notation (JSON) standard and is widely used for representing geographic features in web applications.
+
+```json
+{
+	"type": "Feature",
+	"geometry": {
+		"type": "Polygon",
+		"coordinates": [[]]
+	},
+	"properties": {}
+}
+```
+
+
+## 2.4.2 - World Meteorological Organization (WMO) Format
+
+**WMO Format** (World Meteorological Organization Format) is a standardized structure used for exchanging meteorological data, including observations, forecasts, and warnings. It provides a consistent format for weather products, allowing meteorological organizations and systems around the world to reliably share and process weather information.
+
+
+```text
+000
+WUUS51 KLOT 000000
+SVRGYX
+ILC001-ILC002-
+/O.NEW.XXXX.XX.X.0000.000000T0000Z-000000T0000Z/
+
+BULLETIN - IMMEDIATE BROADCAST REQUESTED
+
+Severe Thunderstorm Warning
+
+National Weather Service
+
+XXXX PM Timezone Weekday Month DD 2026
+
+TEST EXAMPLE - TEXT EXAMPLE - TEST EXAMPLE
+
+&&
+
+
+LAT...LON 4587 6965 4585 6968 4588 6971 4587 6972
+
+      4584 6970 4576 6972 4576 6976 4577 6978
+
+      4574 6981 4566 6974 4565 6970 4558 6971
+
+      4553 6978 4530 6970 4567 7054 4573 7038
+
+      4580 7042 4589 7026 4596 7026 4598 6968
+
+TIME...MOT...LOC 1650Z 313DEG 52KT 4600 7042
+
+
+HAIL THREAT...TEST EXAMPLE
+
+MAX HAIL SIZE...TEST EXAMPLE
+
+WIND THREAT...TEST EXAMPLE
+
+MAX WIND GUST...TEST EXAMPLE
+```