@aguacerowx/javascript-sdk 0.0.27 → 0.0.28

package/src/nws/nwsAlertsFetchSpec.js

@@ -1,93 +1,93 @@
-/**
- * NWWS `/alerts?hours=` sizing (aguacero-frontend baseline + overlap window parity).
- *
- * Hours follow the **active** observational mode only: NEXRAD → `nexradDurationValue`,
- * MRMS → `mrmsDurationValue`, satellite → `satelliteDurationValue`, otherwise `1` (e.g. model-only).
- * Tier cap uses {@link AguaceroCore} `satelliteTier` — the only subscription-style field on core today
- * (same values as the frontend board tier: basic / enthusiast / professional).
- */
-
-import { parseTimelineDurationHours } from '../satellite_support.js';
-
-const MAX_ALERT_HISTORY_HOURS = 8760;
-
-/** Max option span (hours) per tier from frontend `RADAR_DURATION_CONFIG`. */
-const TIER_MAX_HOURS = {
-    professional: 12,
-    enthusiast: 4,
-    basic: 1,
-};
-
-/**
- * @param {string | undefined} tier
- * @returns {'professional'|'enthusiast'|'basic'}
- */
-export function normalizeNwsSubscriptionTier(tier) {
-    const t = String(tier || 'basic').toLowerCase();
-    if (t === 'commercial' || t === 'lifetime' || t === 'partner') return 'professional';
-    if (t === 'professional' || t === 'enthusiast' || t === 'basic') return t;
-    return 'basic';
-}
-
-/**
- * @param {string | undefined} tier
- * @returns {number}
- */
-export function getMaxRadarHistoryHoursForTier(tier) {
-    const k = normalizeNwsSubscriptionTier(tier);
-    return TIER_MAX_HOURS[k] ?? TIER_MAX_HOURS.basic;
-}
-
-/**
- * @param {object | null | undefined} state - {@link AguaceroCore} `state`
- * @returns {number} integer hours in [1, MAX_ALERT_HISTORY_HOURS]
- */
-export function computeNwsAlertsFetchHoursFromAguaceroState(state) {
-    const tierMax = getMaxRadarHistoryHoursForTier(state?.satelliteTier);
-    let desired = 1;
-    if (state?.isNexrad) {
-        desired = parseTimelineDurationHours(state.nexradDurationValue);
-    } else if (state?.isMRMS) {
-        desired = parseTimelineDurationHours(state.mrmsDurationValue);
-    } else if (state?.isSatellite) {
-        desired = parseTimelineDurationHours(state.satelliteDurationValue);
-    }
-    const clamped = Math.min(tierMax, Math.max(1, desired));
-    return Math.min(MAX_ALERT_HISTORY_HOURS, Math.floor(clamped));
-}
-
-/**
- * @param {number} hours
- * @returns {string}
- */
-export function nwsAlertsFetchSpecCacheKey(hours) {
-    return `h${hours}`;
-}
-
-/**
- * Unix window [start, end] for client-side validity overlap (wall-clock end at “now”).
- *
- * @param {number} hours
- * @param {number | null} [anchorSec] - reserved; default now (matches frontend `anchorSec: null`)
- * @returns {{ winStartSec: number; winEndSec: number }}
- */
-export function nwwsAlertsFetchUnixWindow(hours, anchorSec = null) {
-    const nowSec = Math.floor(Date.now() / 1000);
-    const winEndSec = anchorSec ?? nowSec;
-    const winStartSec = winEndSec - hours * 3600;
-    return { winStartSec, winEndSec };
-}
-
-/**
- * @param {string} baseUrl - `/alerts` root (no query)
- * @param {number} hours
- * @returns {string}
- */
-export function buildNwwsActiveAlertsUrl(baseUrl, hours) {
-    const h = Math.max(1, Math.floor(Number(hours) || 1));
-    const params = new URLSearchParams();
-    params.set('hours', String(h));
-    const q = params.toString();
-    const base = String(baseUrl || '').replace(/\/$/, '');
-    return q ? `${base}?${q}` : base;
-}
+/**
+ * NWWS `/alerts?hours=` sizing (aguacero-frontend baseline + overlap window parity).
+ *
+ * Hours follow the **active** observational mode only: NEXRAD → `nexradDurationValue`,
+ * MRMS → `mrmsDurationValue`, satellite → `satelliteDurationValue`, otherwise `1` (e.g. model-only).
+ * Tier cap uses {@link AguaceroCore} `satelliteTier` — the only subscription-style field on core today
+ * (same values as the frontend board tier: basic / enthusiast / professional).
+ */
+
+import { parseTimelineDurationHours } from '../satellite_support.js';
+
+const MAX_ALERT_HISTORY_HOURS = 8760;
+
+/** Max option span (hours) per tier from frontend `RADAR_DURATION_CONFIG`. */
+const TIER_MAX_HOURS = {
+    professional: 12,
+    enthusiast: 4,
+    basic: 1,
+};
+
+/**
+ * @param {string | undefined} tier
+ * @returns {'professional'|'enthusiast'|'basic'}
+ */
+export function normalizeNwsSubscriptionTier(tier) {
+    const t = String(tier || 'basic').toLowerCase();
+    if (t === 'commercial' || t === 'lifetime' || t === 'partner') return 'professional';
+    if (t === 'professional' || t === 'enthusiast' || t === 'basic') return t;
+    return 'basic';
+}
+
+/**
+ * @param {string | undefined} tier
+ * @returns {number}
+ */
+export function getMaxRadarHistoryHoursForTier(tier) {
+    const k = normalizeNwsSubscriptionTier(tier);
+    return TIER_MAX_HOURS[k] ?? TIER_MAX_HOURS.basic;
+}
+
+/**
+ * @param {object | null | undefined} state - {@link AguaceroCore} `state`
+ * @returns {number} integer hours in [1, MAX_ALERT_HISTORY_HOURS]
+ */
+export function computeNwsAlertsFetchHoursFromAguaceroState(state) {
+    const tierMax = getMaxRadarHistoryHoursForTier(state?.satelliteTier);
+    let desired = 1;
+    if (state?.isNexrad) {
+        desired = parseTimelineDurationHours(state.nexradDurationValue);
+    } else if (state?.isMRMS) {
+        desired = parseTimelineDurationHours(state.mrmsDurationValue);
+    } else if (state?.isSatellite) {
+        desired = parseTimelineDurationHours(state.satelliteDurationValue);
+    }
+    const clamped = Math.min(tierMax, Math.max(1, desired));
+    return Math.min(MAX_ALERT_HISTORY_HOURS, Math.floor(clamped));
+}
+
+/**
+ * @param {number} hours
+ * @returns {string}
+ */
+export function nwsAlertsFetchSpecCacheKey(hours) {
+    return `h${hours}`;
+}
+
+/**
+ * Unix window [start, end] for client-side validity overlap (wall-clock end at “now”).
+ *
+ * @param {number} hours
+ * @param {number | null} [anchorSec] - reserved; default now (matches frontend `anchorSec: null`)
+ * @returns {{ winStartSec: number; winEndSec: number }}
+ */
+export function nwwsAlertsFetchUnixWindow(hours, anchorSec = null) {
+    const nowSec = Math.floor(Date.now() / 1000);
+    const winEndSec = anchorSec ?? nowSec;
+    const winStartSec = winEndSec - hours * 3600;
+    return { winStartSec, winEndSec };
+}
+
+/**
+ * @param {string} baseUrl - `/alerts` root (no query)
+ * @param {number} hours
+ * @returns {string}
+ */
+export function buildNwwsActiveAlertsUrl(baseUrl, hours) {
+    const h = Math.max(1, Math.floor(Number(hours) || 1));
+    const params = new URLSearchParams();
+    params.set('hours', String(h));
+    const q = params.toString();
+    const base = String(baseUrl || '').replace(/\/$/, '');
+    return q ? `${base}?${q}` : base;
+}

package/src/nws/nwsEventColorsDefaults.js

@@ -1,133 +1,133 @@
-/**
- * Default NWS/IPAWS alert fill colors — kept in sync with
- * `aguacero-frontend/src/lib/defaultColormaps.ts` (`NWS_EVENT_COLORS`).
- * Update both when the palette changes.
- */
-
-export const NWS_EVENT_COLORS = {
-    'Tsunami Warning': '#FD6347',
-    'Tsunami Advisory': '#D2691E',
-    'Tsunami Watch': '#FF00FF',
-    'Tornado Warning': '#FF0000',
-    'Tornado Warning (Observed)': '#FF0000',
-    'Tornado Warning (PDS)': '#FF0000',
-    'Tornado Warning (Emergency)': '#FF0000',
-    'Tornado Watch': '#FFFF00',
-    'Severe Thunderstorm Warning': '#FFA500',
-    'Severe Thunderstorm Warning (Considerable)': '#FFA500',
-    'Severe Thunderstorm Warning (Destructive)': '#FFA500',
-    'Severe Thunderstorm Watch': '#DB7093',
-    'Severe Weather Statement': '#00FFFF',
-    'Extreme Wind Warning': '#FF8C00',
-    'High Wind Warning': '#DAA520',
-    'High Wind Watch': '#B8860B',
-    'Wind Advisory': '#D2B48C',
-    'Lake Wind Advisory': '#D2B48C',
-    'Flash Flood Warning': '#8B0000',
-    'Flash Flood Warning (Considerable)': '#8B0000',
-    'Flash Flood Warning (Emergency)': '#8B0000',
-    'Flash Flood Statement': '#8B0000',
-    'Flash Flood Watch': '#2E8B57',
-    'Flood Warning': '#00FF00',
-    'Flood Statement': '#00FF00',
-    'Flood Watch': '#2E8B57',
-    'Flood Advisory': '#00FF7F',
-    'Coastal Flood Warning': '#228B22',
-    'Coastal Flood Watch': '#66CDAA',
-    'Coastal Flood Advisory': '#7CFC00',
-    'Coastal Flood Statement': '#6B8E23',
-    'Lakeshore Flood Warning': '#228B22',
-    'Lakeshore Flood Watch': '#66CDAA',
-    'Lakeshore Flood Advisory': '#7CFC00',
-    'Lakeshore Flood Statement': '#6B8E23',
-    'Hydrologic Outlook': '#90EE90',
-    'Shelter In Place Warning': '#FA8072',
-    'Evacuation Immediate': '#7FFF00',
-    'Civil Danger Warning': '#FFB6C1',
-    'Civil Emergency Message': '#FFB6C1',
-    'Law Enforcement Warning': '#C0C0C0',
-    'Local Area Emergency': '#C0C0C0',
-    '911 Telephone Outage': '#C0C0C0',
-    'Nuclear Power Plant Warning': '#4B0082',
-    'Radiological Hazard Warning': '#4B0082',
-    'Hazardous Materials Warning': '#4B0082',
-    'Fire Warning': '#A0522D',
-    'Red Flag Warning': '#FF1493',
-    'Fire Weather Watch': '#FFDEAD',
-    'Extreme Fire Danger': '#E9967A',
-    'Storm Surge Warning': '#B524F7',
-    'Storm Surge Watch': '#DB7FF7',
-    'Hurricane Force Wind Warning': '#CD5C5C',
-    'Hurricane Force Wind Watch': '#9932CC',
-    'Hurricane Warning': '#DC143C',
-    'Hurricane Watch': '#FF00FF',
-    'Typhoon Warning': '#DC143C',
-    'Typhoon Watch': '#FF00FF',
-    'Tropical Storm Warning': '#B22222',
-    'Tropical Storm Watch': '#F08080',
-    'Tropical Cyclone Local Statement': '#FFE4B5',
-    'Special Marine Warning': '#FFA500',
-    'Gale Warning': '#DDA0DD',
-    'Gale Watch': '#FFC0CB',
-    'Storm Warning': '#9400D3',
-    'Storm Watch': '#FFE4B5',
-    'Small Craft Advisory': '#D8BFD8',
-    'Brisk Wind Advisory': '#D8BFD8',
-    'Hazardous Seas Warning': '#D8BFD8',
-    'Hazardous Seas Watch': '#483D8B',
-    'Heavy Freezing Spray Warning': '#00BFFF',
-    'Heavy Freezing Spray Watch': '#BC8F8F',
-    'Marine Weather Statement': '#FFDAB9',
-    'Low Water Advisory': '#A52A2A',
-    'High Surf Warning': '#228B22',
-    'High Surf Advisory': '#BA55D3',
-    'Beach Hazards Statement': '#40E0D0',
-    'Rip Current Statement': '#40E0D0',
-    'Blizzard Warning': '#FF4500',
-    'Snow Squall Warning': '#C71585',
-    'Ice Storm Warning': '#8B008B',
-    'Winter Storm Warning': '#FF69B4',
-    'Lake Effect Snow Warning': '#008B8B',
-    'Winter Storm Watch': '#4682B4',
-    'Winter Weather Advisory': '#7B68EE',
-    'Freeze Warning': '#483D8B',
-    'Freeze Watch': '#00FFFF',
-    'Frost Advisory': '#6495ED',
-    'Freezing Fog Advisory': '#008080',
-    'Freezing Spray Advisory': '#00BFFF',
-    'Freezing Rain Advisory': '#DA70D6',
-    'Wind Chill Warning': '#B0C4DE',
-    'Cold Weather Advisory': '#AFEEEE',
-    'Extreme Heat Warning': '#C71585',
-    'Extreme Heat Watch': '#800000',
-    'Heat Advisory': '#FF7F50',
-    'Extreme Cold Warning': '#0000FF',
-    'Extreme Cold Watch': '#5F9EA0',
-    'Dust Storm Warning': '#FFE4C4',
-    'Blowing Dust Warning': '#FFE4C4',
-    'Dust Advisory': '#BDB76B',
-    'Blowing Dust Advisory': '#BDB76B',
-    'Ashfall Warning': '#A9A9A9',
-    'Ashfall Advisory': '#696969',
-    'Avalanche Warning': '#1E90FF',
-    'Avalanche Watch': '#F4A460',
-    'Avalanche Advisory': '#CD853F',
-    'Earthquake Warning': '#8B4513',
-    'Volcano Warning': '#2F4F4F',
-    'Dense Fog Advisory': '#708090',
-    'Dense Smoke Advisory': '#F0E68C',
-    'Air Quality Alert': '#808080',
-    'Air Stagnation Advisory': '#808080',
-    'Special Weather Statement': '#FFE4B5',
-    'Hazardous Weather Outlook': '#EEE8AA',
-    'Short Term Forecast': '#98FB98',
-    'Administrative Message': '#C0C0C0',
-    'Test': '#F0FFFF',
-    'Child Abduction Emergency': '#FFFFFF',
-    'Blue Alert': '#FFFFFF',
-};
-
-/** Same ordering as frontend `NWS_ALERT_EVENT_NAMES`. */
-export const NWS_ALERT_EVENT_NAMES = Object.keys(NWS_EVENT_COLORS).sort((a, b) =>
-    a.localeCompare(b, undefined, { sensitivity: 'base' })
-);
+/**
+ * Default NWS/IPAWS alert fill colors — kept in sync with
+ * `aguacero-frontend/src/lib/defaultColormaps.ts` (`NWS_EVENT_COLORS`).
+ * Update both when the palette changes.
+ */
+
+export const NWS_EVENT_COLORS = {
+    'Tsunami Warning': '#FD6347',
+    'Tsunami Advisory': '#D2691E',
+    'Tsunami Watch': '#FF00FF',
+    'Tornado Warning': '#FF0000',
+    'Tornado Warning (Observed)': '#FF0000',
+    'Tornado Warning (PDS)': '#FF0000',
+    'Tornado Warning (Emergency)': '#FF0000',
+    'Tornado Watch': '#FFFF00',
+    'Severe Thunderstorm Warning': '#FFA500',
+    'Severe Thunderstorm Warning (Considerable)': '#FFA500',
+    'Severe Thunderstorm Warning (Destructive)': '#FFA500',
+    'Severe Thunderstorm Watch': '#DB7093',
+    'Severe Weather Statement': '#00FFFF',
+    'Extreme Wind Warning': '#FF8C00',
+    'High Wind Warning': '#DAA520',
+    'High Wind Watch': '#B8860B',
+    'Wind Advisory': '#D2B48C',
+    'Lake Wind Advisory': '#D2B48C',
+    'Flash Flood Warning': '#8B0000',
+    'Flash Flood Warning (Considerable)': '#8B0000',
+    'Flash Flood Warning (Emergency)': '#8B0000',
+    'Flash Flood Statement': '#8B0000',
+    'Flash Flood Watch': '#2E8B57',
+    'Flood Warning': '#00FF00',
+    'Flood Statement': '#00FF00',
+    'Flood Watch': '#2E8B57',
+    'Flood Advisory': '#00FF7F',
+    'Coastal Flood Warning': '#228B22',
+    'Coastal Flood Watch': '#66CDAA',
+    'Coastal Flood Advisory': '#7CFC00',
+    'Coastal Flood Statement': '#6B8E23',
+    'Lakeshore Flood Warning': '#228B22',
+    'Lakeshore Flood Watch': '#66CDAA',
+    'Lakeshore Flood Advisory': '#7CFC00',
+    'Lakeshore Flood Statement': '#6B8E23',
+    'Hydrologic Outlook': '#90EE90',
+    'Shelter In Place Warning': '#FA8072',
+    'Evacuation Immediate': '#7FFF00',
+    'Civil Danger Warning': '#FFB6C1',
+    'Civil Emergency Message': '#FFB6C1',
+    'Law Enforcement Warning': '#C0C0C0',
+    'Local Area Emergency': '#C0C0C0',
+    '911 Telephone Outage': '#C0C0C0',
+    'Nuclear Power Plant Warning': '#4B0082',
+    'Radiological Hazard Warning': '#4B0082',
+    'Hazardous Materials Warning': '#4B0082',
+    'Fire Warning': '#A0522D',
+    'Red Flag Warning': '#FF1493',
+    'Fire Weather Watch': '#FFDEAD',
+    'Extreme Fire Danger': '#E9967A',
+    'Storm Surge Warning': '#B524F7',
+    'Storm Surge Watch': '#DB7FF7',
+    'Hurricane Force Wind Warning': '#CD5C5C',
+    'Hurricane Force Wind Watch': '#9932CC',
+    'Hurricane Warning': '#DC143C',
+    'Hurricane Watch': '#FF00FF',
+    'Typhoon Warning': '#DC143C',
+    'Typhoon Watch': '#FF00FF',
+    'Tropical Storm Warning': '#B22222',
+    'Tropical Storm Watch': '#F08080',
+    'Tropical Cyclone Local Statement': '#FFE4B5',
+    'Special Marine Warning': '#FFA500',
+    'Gale Warning': '#DDA0DD',
+    'Gale Watch': '#FFC0CB',
+    'Storm Warning': '#9400D3',
+    'Storm Watch': '#FFE4B5',
+    'Small Craft Advisory': '#D8BFD8',
+    'Brisk Wind Advisory': '#D8BFD8',
+    'Hazardous Seas Warning': '#D8BFD8',
+    'Hazardous Seas Watch': '#483D8B',
+    'Heavy Freezing Spray Warning': '#00BFFF',
+    'Heavy Freezing Spray Watch': '#BC8F8F',
+    'Marine Weather Statement': '#FFDAB9',
+    'Low Water Advisory': '#A52A2A',
+    'High Surf Warning': '#228B22',
+    'High Surf Advisory': '#BA55D3',
+    'Beach Hazards Statement': '#40E0D0',
+    'Rip Current Statement': '#40E0D0',
+    'Blizzard Warning': '#FF4500',
+    'Snow Squall Warning': '#C71585',
+    'Ice Storm Warning': '#8B008B',
+    'Winter Storm Warning': '#FF69B4',
+    'Lake Effect Snow Warning': '#008B8B',
+    'Winter Storm Watch': '#4682B4',
+    'Winter Weather Advisory': '#7B68EE',
+    'Freeze Warning': '#483D8B',
+    'Freeze Watch': '#00FFFF',
+    'Frost Advisory': '#6495ED',
+    'Freezing Fog Advisory': '#008080',
+    'Freezing Spray Advisory': '#00BFFF',
+    'Freezing Rain Advisory': '#DA70D6',
+    'Wind Chill Warning': '#B0C4DE',
+    'Cold Weather Advisory': '#AFEEEE',
+    'Extreme Heat Warning': '#C71585',
+    'Extreme Heat Watch': '#800000',
+    'Heat Advisory': '#FF7F50',
+    'Extreme Cold Warning': '#0000FF',
+    'Extreme Cold Watch': '#5F9EA0',
+    'Dust Storm Warning': '#FFE4C4',
+    'Blowing Dust Warning': '#FFE4C4',
+    'Dust Advisory': '#BDB76B',
+    'Blowing Dust Advisory': '#BDB76B',
+    'Ashfall Warning': '#A9A9A9',
+    'Ashfall Advisory': '#696969',
+    'Avalanche Warning': '#1E90FF',
+    'Avalanche Watch': '#F4A460',
+    'Avalanche Advisory': '#CD853F',
+    'Earthquake Warning': '#8B4513',
+    'Volcano Warning': '#2F4F4F',
+    'Dense Fog Advisory': '#708090',
+    'Dense Smoke Advisory': '#F0E68C',
+    'Air Quality Alert': '#808080',
+    'Air Stagnation Advisory': '#808080',
+    'Special Weather Statement': '#FFE4B5',
+    'Hazardous Weather Outlook': '#EEE8AA',
+    'Short Term Forecast': '#98FB98',
+    'Administrative Message': '#C0C0C0',
+    'Test': '#F0FFFF',
+    'Child Abduction Emergency': '#FFFFFF',
+    'Blue Alert': '#FFFFFF',
+};
+
+/** Same ordering as frontend `NWS_ALERT_EVENT_NAMES`. */
+export const NWS_ALERT_EVENT_NAMES = Object.keys(NWS_EVENT_COLORS).sort((a, b) =>
+    a.localeCompare(b, undefined, { sensitivity: 'base' })
+);