@cyanheads/noaa-spaceweather-mcp-server 0.1.1

package/dist/services/space-weather/space-weather-service.js

@@ -0,0 +1,402 @@
+/**
+ * @fileoverview NOAA Space Weather Prediction Center (SWPC) feed client.
+ * Wraps keyless public JSON feeds from services.swpc.noaa.gov, normalizes the
+ * diverse feed shapes (array-of-arrays, array-of-objects, keyed objects) into
+ * clean typed domain records, and exposes per-feed methods used by all tools.
+ * @module services/space-weather/space-weather-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
+// ── Constants ──────────────────────────────────────────────────────────────
+const BASE_URL = 'https://services.swpc.noaa.gov';
+const USER_AGENT = 'noaa-spaceweather-mcp-server/0.1.1 (github.com/cyanheads/noaa-spaceweather-mcp-server)';
+const FETCH_TIMEOUT_MS = 15_000;
+/** Missing/fill value used in many SWPC feeds for sensor failures. */
+const FILL_VALUE = -9999;
+// ── NOAA scale helpers ──────────────────────────────────────────────────────
+/** Maps Kp value (0–9) to NOAA G-scale level (0–5). */
+function kpToGScale(kp) {
+    if (kp >= 9)
+        return 5;
+    if (kp >= 8)
+        return 4;
+    if (kp >= 7)
+        return 3;
+    if (kp >= 6)
+        return 2;
+    if (kp >= 5)
+        return 1;
+    return 0;
+}
+/** Returns aurora visibility latitude guidance for a G-scale level. */
+function gScaleToAuroraLatitude(gScale) {
+    switch (gScale) {
+        case 5:
+            return 'Aurora possible to ~40° geomagnetic latitude';
+        case 4:
+            return 'Aurora possible to ~45° geomagnetic latitude';
+        case 3:
+            return 'Aurora possible to ~50° geomagnetic latitude';
+        case 2:
+            return 'Aurora possible to ~55° geomagnetic latitude';
+        case 1:
+            return 'Aurora possible to ~60° geomagnetic latitude';
+        default:
+            return 'No significant aurora expected at mid-latitudes';
+    }
+}
+// ── Shared fetch helper ─────────────────────────────────────────────────────
+async function fetchFeed(path, ctx) {
+    // Cast ctx to RequestContext for framework utils — Context is structurally
+    // compatible but lacks the index signature the type expects.
+    const reqCtx = ctx;
+    return withRetry(async () => {
+        const url = `${BASE_URL}${path}`;
+        const response = await fetchWithTimeout(url, FETCH_TIMEOUT_MS, reqCtx, {
+            signal: ctx.signal,
+            headers: { 'User-Agent': USER_AGENT },
+        });
+        const text = await response.text();
+        if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+            throw serviceUnavailable(`SWPC feed returned HTML instead of JSON — likely rate-limited or unavailable.`, { path });
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (err) {
+            throw serviceUnavailable(`Failed to parse SWPC feed JSON from ${path}.`, { path }, { cause: err });
+        }
+    }, {
+        operation: `fetchFeed:${path}`,
+        context: reqCtx,
+        baseDelayMs: 1000,
+        signal: ctx.signal,
+    });
+}
+// ── Normalization helpers ───────────────────────────────────────────────────
+/**
+ * Normalize a null/string/number scale value to a number.
+ * SWPC returns null for unavailable forecasts — treat as 0 (no storm).
+ */
+function coerceScale(v) {
+    if (v == null)
+        return 0;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+}
+/** Parse numeric string, returning null if the value is the fill value or NaN. */
+function parseNum(s) {
+    if (s == null)
+        return null;
+    const n = typeof s === 'string' ? parseFloat(s) : s;
+    if (!Number.isFinite(n) || n === FILL_VALUE)
+        return null;
+    return n;
+}
+/**
+ * Normalize a SWPC time tag string to ISO 8601 UTC.
+ * SWPC solar-wind feeds use "YYYY-MM-DD HH:MM:SS.mmm" (space-separated, no 'Z').
+ * Without normalization, `new Date(tag)` interprets the string as local time
+ * rather than UTC, corrupting all time-based filtering.
+ */
+function normalizeSwpcTime(tag) {
+    // Replace the space between date and time with 'T' and append 'Z' if absent.
+    if (typeof tag !== 'string' || tag.includes('T'))
+        return tag;
+    const normalized = tag.replace(' ', 'T');
+    return normalized.endsWith('Z') ? normalized : `${normalized}Z`;
+}
+/**
+ * Normalize array-of-arrays feed (plasma, mag) with a header row.
+ * data[0] is string[] field names; data[1..n] are string[] value rows.
+ */
+function normalizeArrayOfArrays(raw) {
+    if (raw.length < 2 || !Array.isArray(raw[0]))
+        return [];
+    const headers = raw[0];
+    return raw.slice(1).map((row) => {
+        const obj = {};
+        headers.forEach((h, i) => {
+            obj[h] = row[i] ?? '';
+        });
+        return obj;
+    });
+}
+/** Parse a product code prefix to a product type. */
+function parseProductType(id) {
+    const upper = id.toUpperCase();
+    if (upper.startsWith('WAR'))
+        return 'Warning';
+    if (upper.startsWith('WAT'))
+        return 'Watch';
+    if (upper.startsWith('ALT'))
+        return 'Alert';
+    if (upper.startsWith('SUM'))
+        return 'Summary';
+    return 'Other';
+}
+/** Extract phenomenon name from product code. */
+function parsePhenomenon(id) {
+    const upper = id.toUpperCase();
+    // After the 3-char type prefix, look at the next character(s)
+    const core = upper.slice(3);
+    if (core.startsWith('G') || core.startsWith('K'))
+        return 'Geomagnetic';
+    if (core.startsWith('R') || core.startsWith('X'))
+        return 'Radio Blackout';
+    if (core.startsWith('S'))
+        return 'Solar Radiation';
+    if (core.startsWith('A'))
+        return 'Aurora';
+    return 'Space Weather';
+}
+/** Parse numeric level from product code suffix. */
+function parseLevel(id) {
+    const match = id.match(/(\d+)\w*$/);
+    if (!match)
+        return 0;
+    return parseInt(match[1], 10);
+}
+// ── SpaceWeatherService ─────────────────────────────────────────────────────
+/** NOAA SWPC public feeds client. Initialized once; accessed via accessor. */
+export class SpaceWeatherService {
+    // config and storage are accepted per the service contract but not used by this
+    // keyless, stateless feed client.
+    constructor(_config, _storage) { }
+    // ── NOAA Scales ────────────────────────────────────────────────────────
+    /** Fetch current NOAA storm scales (today + 3-day forecast). */
+    async getNoaaScales(ctx) {
+        const raw = await fetchFeed('/products/noaa-scales.json', ctx);
+        const normalizePeriod = (r) => ({
+            date: r.DateStamp ?? '',
+            time: r.TimeStamp ?? '',
+            G: {
+                category: 'G',
+                scale: coerceScale(r.G?.Scale),
+                text: r.G?.Text ?? '',
+                minorProb: r.G?.Prob != null ? coerceScale(r.G.Prob) : null,
+                majorProb: null,
+            },
+            R: {
+                category: 'R',
+                scale: coerceScale(r.R?.Scale),
+                text: r.R?.Text ?? '',
+                minorProb: r.R?.MinorProb != null ? coerceScale(r.R.MinorProb) : null,
+                majorProb: r.R?.MajorProb != null ? coerceScale(r.R.MajorProb) : null,
+            },
+            S: {
+                category: 'S',
+                scale: coerceScale(r.S?.Scale),
+                text: r.S?.Text ?? '',
+                minorProb: r.S?.Prob != null ? coerceScale(r.S.Prob) : null,
+                majorProb: null,
+            },
+        });
+        const today = raw['0'];
+        if (!today)
+            throw serviceUnavailable('SWPC scales feed missing key "0" (today).', {
+                available: Object.keys(raw),
+            });
+        return {
+            today: normalizePeriod(today),
+            forecast: ['1', '2', '3']
+                .filter((k) => raw[k] != null)
+                .map((k) => normalizePeriod(raw[k])),
+        };
+    }
+    // ── Kp Index ────────────────────────────────────────────────────────────
+    /** Fetch observed Kp index history. */
+    async getKpObserved(ctx) {
+        const raw = await fetchFeed('/products/noaa-planetary-k-index.json', ctx);
+        return raw.map((r) => {
+            const kp = parseNum(r.Kp) ?? 0;
+            const gScale = kpToGScale(kp);
+            return {
+                timeTag: r.time_tag,
+                kp,
+                gScale,
+                auroraLatitude: gScaleToAuroraLatitude(gScale),
+                aRunning: parseNum(r.a_running),
+                stationCount: parseNum(r.station_count),
+            };
+        });
+    }
+    /** Fetch Kp 3-day forecast. */
+    async getKpForecast(ctx) {
+        const raw = await fetchFeed('/products/noaa-planetary-k-index-forecast.json', ctx);
+        return raw.map((r) => ({
+            timeTag: r.time_tag,
+            kp: parseNum(r.kp) ?? 0,
+            observed: r.observed,
+            noaaScale: r.noaa_scale ?? null,
+        }));
+    }
+    // ── OVATION Aurora ──────────────────────────────────────────────────────
+    /** Fetch the latest OVATION aurora forecast grid. */
+    async getAuroraForecast(ctx) {
+        const raw = await fetchFeed('/json/ovation_aurora_latest.json', ctx);
+        return {
+            meta: {
+                observationTime: raw['Observation Time'] ?? '',
+                forecastTime: raw['Forecast Time'] ?? '',
+            },
+            grid: (raw.coordinates ?? []).map(([lon, lat, aurora]) => ({
+                // OVATION grid uses 0–360 longitude. Normalize to −180..179 so user
+                // coordinates (WGS84 standard −180..180) map to the same range for
+                // nearest-grid-point search.
+                longitude: lon > 180 ? lon - 360 : lon,
+                latitude: lat,
+                auroraPercent: aurora,
+            })),
+        };
+    }
+    // ── Solar Wind ──────────────────────────────────────────────────────────
+    /** Fetch solar wind plasma (7-day, array-of-arrays format). */
+    async getSolarWindPlasma(ctx) {
+        const raw = await fetchFeed('/products/solar-wind/plasma-7-day.json', ctx);
+        const rows = normalizeArrayOfArrays(raw);
+        return rows.map((r) => ({
+            timeTag: normalizeSwpcTime(r['time_tag'] ?? ''),
+            densityPerCm3: parseNum(r['density']),
+            speedKmS: parseNum(r['speed']),
+            temperatureK: parseNum(r['temperature']),
+        }));
+    }
+    /** Fetch solar wind magnetic field (7-day, array-of-arrays format). */
+    async getSolarWindMag(ctx) {
+        const raw = await fetchFeed('/products/solar-wind/mag-7-day.json', ctx);
+        const rows = normalizeArrayOfArrays(raw);
+        return rows.map((r) => ({
+            timeTag: normalizeSwpcTime(r['time_tag'] ?? ''),
+            bxGsm: parseNum(r['bx_gsm']),
+            byGsm: parseNum(r['by_gsm']),
+            bzGsm: parseNum(r['bz_gsm']),
+            bt: parseNum(r['bt']),
+        }));
+    }
+    // ── Solar Activity ──────────────────────────────────────────────────────
+    /** Fetch GOES X-ray flux (7-day, long-channel 0.1-0.8nm only). */
+    async getXrayFlux(ctx) {
+        const raw = await fetchFeed('/json/goes/primary/xrays-7-day.json', ctx);
+        return raw
+            .filter((r) => r.energy === '0.1-0.8nm')
+            .map((r) => ({
+            timeTag: r.time_tag,
+            satellite: r.satellite,
+            fluxWm2: r.flux,
+            energy: r.energy,
+        }));
+    }
+    /** Fetch active solar regions (most recent observed date only). */
+    async getSolarRegions(ctx) {
+        const raw = await fetchFeed('/json/solar_regions.json', ctx);
+        // The feed contains ~30 days of region history in reverse-chrono order.
+        // Filter to the most recent observed_date to return only currently active regions.
+        const mostRecentDate = raw.length > 0 ? raw[0]?.observed_date : null;
+        return raw
+            .filter((r) => r.location != null && r.observed_date === mostRecentDate) // most recent date only, skip tombstones
+            .map((r) => {
+            // latitude is a bare integer in the live feed (e.g. 17, -5).
+            // Normalize to heliographic string ("N17", "S05") to match the declared output type.
+            const latNum = typeof r.latitude === 'number' ? r.latitude : parseFloat(String(r.latitude));
+            const latStr = Number.isFinite(latNum)
+                ? `${latNum >= 0 ? 'N' : 'S'}${String(Math.abs(latNum)).padStart(2, '0')}`
+                : String(r.latitude ?? '');
+            return {
+                observedDate: r.observed_date,
+                region: r.region,
+                latitude: latStr,
+                location: r.location,
+                spotClass: r.spot_class ?? '',
+                numberSpots: r.number_spots ?? 0,
+                magClass: r.mag_class ?? '',
+                cFlareProbability: parseNum(r.c_flare_probability) ?? 0,
+                mFlareProbability: parseNum(r.m_flare_probability) ?? 0,
+                xFlareProbability: parseNum(r.x_flare_probability) ?? 0,
+                protonProbability: parseNum(r.proton_probability) ?? 0,
+            };
+        });
+    }
+    /** Fetch solar flare probabilities (3-day forward outlook from the latest issued entry). */
+    async getSolarProbabilities(ctx) {
+        const raw = await fetchFeed('/json/solar_probabilities.json', ctx);
+        // The feed is a 30-entry reverse-chrono archive of daily forecasts.
+        // Each entry embeds a 3-day outlook via _1_day / _2_day / _3_day columns.
+        // Take only the most recent entry (index 0) and expand its 3-day outlook
+        // into three records, advancing the date by 0, 1, and 2 days respectively.
+        if (raw.length === 0)
+            return [];
+        const latest = raw[0];
+        // Normalize to UTC: the date field is "2026-06-04T00:00:00" without a 'Z',
+        // so new Date() would interpret it as local time. Append 'Z' to force UTC.
+        const rawDate = latest.date.endsWith('Z') ? latest.date : `${latest.date}Z`;
+        const baseDate = new Date(rawDate);
+        return [0, 1, 2].map((dayOffset) => {
+            const d = new Date(baseDate);
+            d.setDate(d.getDate() + dayOffset);
+            const suffix = dayOffset === 0 ? '1_day' : dayOffset === 1 ? '2_day' : '3_day';
+            return {
+                date: d.toISOString(),
+                cClass1Day: parseNum(latest[`c_class_${suffix}`]) ?? 0,
+                mClass1Day: parseNum(latest[`m_class_${suffix}`]) ?? 0,
+                xClass1Day: parseNum(latest[`x_class_${suffix}`]) ?? 0,
+                protons1Day: parseNum(latest[`10mev_protons_${suffix}`]) ?? 0,
+            };
+        });
+    }
+    /** Fetch GOES integral proton flux (3-day, ≥10 MeV channel). */
+    async getProtonFlux(ctx) {
+        const raw = await fetchFeed('/json/goes/primary/integral-protons-plot-3-day.json', ctx);
+        return raw
+            .filter((r) => r.energy === '>=10 MeV')
+            .map((r) => ({
+            timeTag: r.time_tag,
+            satellite: r.satellite,
+            fluxPfu: r.flux,
+            energy: r.energy,
+        }));
+    }
+    // ── Alerts ──────────────────────────────────────────────────────────────
+    /** Fetch SWPC alerts, watches, and warnings. */
+    async getAlerts(ctx) {
+        const raw = await fetchFeed('/products/alerts.json', ctx);
+        return raw.map((r) => {
+            const id = r.product_id ?? '';
+            // The product_id field in the feed is a 4-char abbreviated code (e.g. "K04W").
+            // The full message code (e.g. "WARK04") lives in the message body as:
+            //   "Space Weather Message Code: WARK04"
+            // Use the full message code for type/phenomenon/level parsing; it carries
+            // the WAR/WAT/ALT/SUM prefix the parser needs.
+            const msgCodeMatch = r.message?.match(/Space\s+Weather\s+Message\s+Code:\s*(\S+)/i);
+            const msgCode = msgCodeMatch?.[1] ?? id;
+            // Parse valid from/to from structured message lines like:
+            //   Valid From: 2026 Jun 04 0000 UTC
+            //   Valid To: 2026 Jun 04 2359 UTC
+            const fromMatch = r.message?.match(/Valid\s+From:\s*(.+?)(?:\r?\n|\r)/i);
+            const toMatch = r.message?.match(/Valid\s+To:\s*(.+?)(?:\r?\n|\r)/i);
+            return {
+                productId: id,
+                productType: parseProductType(msgCode),
+                level: parseLevel(msgCode),
+                issueDatetime: r.issue_datetime,
+                message: (r.message ?? '').replace(/\r\n/g, '\n').replace(/\r/g, '\n').trim(),
+                phenomenon: parsePhenomenon(msgCode),
+                validFrom: fromMatch?.[1] != null ? fromMatch[1].trim() : null,
+                validTo: toMatch?.[1] != null ? toMatch[1].trim() : null,
+            };
+        });
+    }
+}
+// ── Init / accessor ─────────────────────────────────────────────────────────
+let _service;
+/** Initialize the SpaceWeatherService singleton. Call once in setup(). */
+export function initSpaceWeatherService(config, storage) {
+    _service = new SpaceWeatherService(config, storage);
+}
+/** Access the initialized SpaceWeatherService singleton. */
+export function getSpaceWeatherService() {
+    if (!_service)
+        throw new Error('SpaceWeatherService not initialized — call initSpaceWeatherService() in setup()');
+    return _service;
+}
+//# sourceMappingURL=space-weather-service.js.map

package/dist/services/space-weather/space-weather-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-weather-service.js","sourceRoot":"","sources":["../../../src/services/space-weather/space-weather-service.ts"],"names":[],"mappings":"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"}

package/dist/services/space-weather/types.d.ts

@@ -0,0 +1,189 @@
+/**
+ * @fileoverview Domain types for NOAA Space Weather Prediction Center feeds.
+ * @module services/space-weather/types
+ */
+/** A single NOAA storm scale entry (R, S, or G) for one forecast period. */
+export interface NoaaScaleEntry {
+    /** Storm scale category: R (radio blackout), S (solar radiation), G (geomagnetic). */
+    category: 'R' | 'S' | 'G';
+    /** Probability of a major event (%), or null when not applicable. */
+    majorProb: number | null;
+    /** Probability of a minor event (%), or null when not applicable. */
+    minorProb: number | null;
+    /** Storm scale level 0–5. */
+    scale: number;
+    /** Human-readable descriptor, e.g. "Moderate". Empty string when scale is 0. */
+    text: string;
+}
+/** NOAA storm scales for one forecast period. */
+export interface NoaaScalesPeriod {
+    /** Date string for this period, e.g. "2026-06-04". */
+    date: string;
+    /** Geomagnetic storm scale (G). */
+    G: NoaaScaleEntry;
+    /** Radio blackout scale (R). */
+    R: NoaaScaleEntry;
+    /** Solar radiation storm scale (S). */
+    S: NoaaScaleEntry;
+    /** UTC time stamp, e.g. "15:00:00". */
+    time: string;
+}
+/** All NOAA storm scale periods from the feed. */
+export interface NoaaScalesData {
+    /** 3-day forecast array (keys "1", "2", "3"). */
+    forecast: NoaaScalesPeriod[];
+    /** Today's observed/current values (key "0"). */
+    today: NoaaScalesPeriod;
+}
+/** One observed Kp index reading. */
+export interface KpObservation {
+    /** Running mean of geomagnetic activity. */
+    aRunning: number | null;
+    /** Aurora latitude guidance for this Kp level, e.g. "Aurora possible to ~55°". */
+    auroraLatitude: string;
+    /** Corresponding NOAA G-scale level (0–5). */
+    gScale: number;
+    /** Kp value 0–9. */
+    kp: number;
+    /** Number of stations contributing. */
+    stationCount: number | null;
+    /** ISO 8601 time tag for the 3-hour interval. */
+    timeTag: string;
+}
+/** One Kp forecast point. */
+export interface KpForecast {
+    /** Forecasted Kp value. */
+    kp: number;
+    /** NOAA scale string, e.g. "G1", or null when not available. */
+    noaaScale: string | null;
+    /** "observed" or "predicted". */
+    observed: string;
+    /** ISO 8601 time tag. */
+    timeTag: string;
+}
+/** OVATION aurora forecast metadata. */
+export interface AuroraForecastMeta {
+    /** Forecast valid time, e.g. "2026-06-04T15:02:00Z". */
+    forecastTime: string;
+    /** Observation time, e.g. "2026-06-04T14:32:00Z". */
+    observationTime: string;
+}
+/** Aurora probability for a single grid cell. */
+export interface AuroraGridPoint {
+    /** Aurora probability 0–100. */
+    auroraPercent: number;
+    /** Latitude −90–90. */
+    latitude: number;
+    /** Longitude −180–180. */
+    longitude: number;
+}
+/** Full OVATION aurora forecast. */
+export interface AuroraForecastData {
+    /** Grid of aurora probability points (1° resolution). */
+    grid: AuroraGridPoint[];
+    meta: AuroraForecastMeta;
+}
+/** One real-time plasma measurement from DSCOVR. */
+export interface SolarWindPlasma {
+    /** Proton density in particles/cm³. Null when the sensor returns -9999. */
+    densityPerCm3: number | null;
+    /** Solar wind speed in km/s. Null when missing. */
+    speedKmS: number | null;
+    /** Proton temperature in Kelvin. Null when missing. */
+    temperatureK: number | null;
+    /** ISO 8601 time tag. */
+    timeTag: string;
+}
+/** One real-time magnetic field measurement from DSCOVR. */
+export interface SolarWindMag {
+    /** Total field magnitude Bt (nT). Null when missing. */
+    bt: number | null;
+    /** Bx component in GSM coordinates (nT). Null when missing. */
+    bxGsm: number | null;
+    /** By component in GSM coordinates (nT). Null when missing. */
+    byGsm: number | null;
+    /** Bz component in GSM coordinates (nT). Null when missing. */
+    bzGsm: number | null;
+    /** ISO 8601 time tag. */
+    timeTag: string;
+}
+/** One GOES X-ray flux reading. */
+export interface XrayFlux {
+    /** Energy band descriptor. */
+    energy: string;
+    /** Flux in W/m² (the "0.1-0.8nm" long channel). */
+    fluxWm2: number;
+    /** Satellite number. */
+    satellite: number;
+    /** ISO 8601 time tag. */
+    timeTag: string;
+}
+/** Active solar region (NOAA active region). */
+export interface SolarRegion {
+    /** C-class flare probability (%). */
+    cFlareProbability: number;
+    /** Heliographic latitude, e.g. "N17". */
+    latitude: string;
+    /** Heliographic location, e.g. "N17E47". */
+    location: string;
+    /** Magnetic class. */
+    magClass: string;
+    /** M-class flare probability (%). */
+    mFlareProbability: number;
+    /** Number of sunspots. */
+    numberSpots: number;
+    /** Observation date. */
+    observedDate: string;
+    /** Proton event probability (%). */
+    protonProbability: number;
+    /** NOAA active region number. */
+    region: number;
+    /** Spot classification. */
+    spotClass: string;
+    /** X-class flare probability (%). */
+    xFlareProbability: number;
+}
+/** Flare probability forecast for one day. */
+export interface SolarProbabilities {
+    /** Probability of a C-class flare (%). */
+    cClass1Day: number;
+    /** Forecast date. */
+    date: string;
+    /** Probability of an M-class flare (%). */
+    mClass1Day: number;
+    /** Probability of ≥10 MeV proton event (%). */
+    protons1Day: number;
+    /** Probability of an X-class flare (%). */
+    xClass1Day: number;
+}
+/** One integral proton flux reading from GOES. */
+export interface ProtonFlux {
+    /** Energy channel, e.g. ">=10 MeV". */
+    energy: string;
+    /** Flux in particle flux units (pfu). */
+    fluxPfu: number;
+    /** Satellite number. */
+    satellite: number;
+    /** ISO 8601 time tag. */
+    timeTag: string;
+}
+/** Parsed SWPC alert/watch/warning. */
+export interface SpaceWeatherAlert {
+    /** ISO 8601 issue datetime. */
+    issueDatetime: string;
+    /** Severity level (numeric suffix from product code, 0 when not applicable). */
+    level: number;
+    /** Full plain-text message body. */
+    message: string;
+    /** Short parsed phenomenon, e.g. "Geomagnetic", "Radio Blackout", "Solar Radiation". */
+    phenomenon: string;
+    /** Product code, e.g. "WARK04", "ALTK07", "SUMS". */
+    productId: string;
+    /** Product type derived from the code prefix. */
+    productType: 'Warning' | 'Watch' | 'Alert' | 'Summary' | 'Other';
+    /** Valid from (parsed from message), null if not found. */
+    validFrom: string | null;
+    /** Valid to (parsed from message), null if not found. */
+    validTo: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/space-weather/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/space-weather/types.ts"],"names":[],"mappings":"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"}

package/dist/services/space-weather/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Domain types for NOAA Space Weather Prediction Center feeds.
+ * @module services/space-weather/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/space-weather/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/space-weather/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}