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.

Built and maintained with ❤️ by the AtmosphericX team
Not affiliated with NOAA or NWS

---

Official Documentation  •  Github Organization  •  Packages  •  Changelogs  •  Community Discord

Table of Contents

• 1.0 - Introduction
  • 1.1 - Package Installation
  • 1.2 - Usage
• 2.0 - Sources & Attributes
  • 2.1 - NOAA Weather Wire Service
    • 2.1.1 - Basic Settings
    • 2.1.2 - Connection Settings
    • 2.1.3 - Stanza Caching & Retention
    • 2.1.4 - Stanza Processing & Filtering (Pre-Event Processing)
  • 2.2 - National Weather Service API
    • 2.2.1 - Basic Settings
  • 2.3 - NOAA Weather Wire Service vs NWS RESTful API
  • 2.4 - Formatting Standards
    • 2.4.1 - GeoJSON Format
    • 2.4.2 - World Meteorological Organization (WMO) Format
• 3.0 - Configurations

  • 3.1 - Core Configurations

    • 3.1.1 - Timezone Handling
    • 3.1.2 - Database Management
    • 3.1.3 - Broadcastify Management & Filtering
    • 3.1.4 - Boundary & Population Data Management
    • 3.1.5 - NTFY Mobile Push Notifications
    • 3.1.6 - Action Settings

  • 3.2 - Global Settings & Filters

    • 3.2.1 - Polygon Products
      • 3.2.11 - Geometry Parsing
      • 3.2.12 - Shapefile Coordinate Parsing
      • 3.2.13 - Population Data (Polygon Area)
      • 3.2.14 - Nodes & Polygon Filtering
    • 3.2.2 - Product Filtering
      • 3.2.21 - The Basics
      • 3.2.22 - Ignoring Products
    • 3.2.3 - Themes
    • 3.2.4 - Archive Settings
      • 3.2.41 - TTL (Time To Live)
      • 3.2.42 - Archives & Directories
      • 3.2.43 - Logo & Toneouts

• 4.0 - Node Tracking
• 5.0 - Graphic Generation
• 6.0 - Audio Generation
• 7.0 - File Generation
• 8.0 - Integrations

Introduction

Formally known as atmosx-nwws-parser, @atmosx/event-product-parser is a TypeScript/JavaScript library designed to parse and ingest NOAA and NWS Weather Text Products. It includes quality of life features such as ingestion tools, graphics generation, audio output, and additional utilities.

Package Installation

Node Package Manager (NPM):

$ npm install @atmosx/event-product-parser

Performant Node Package Manager (PNPM):

$ pnpm install @atmosx/event-product-parser

Usage

Typescript:

import { Manager } from "@atmosx/event-product-parser"
const manager = new Manager({...settings})

Javascript:

const { Manager } = require("@atmosx/event-product-parser");
const manager = new Manager({...settings});