@aguacerowx/javascript-sdk 0.0.22 → 0.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aguacerowx/javascript-sdk",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "private": false,
   "publishConfig": {
     "access": "public"

package/src/AguaceroCore.js

@@ -228,11 +228,19 @@ export class AguaceroCore extends EventEmitter {
             patch.isNexrad !== undefined ? Boolean(patch.isNexrad) : this.state.isNexrad;
         if (willBeNexrad && 'nexradProduct' in patch && patch.nexradProduct != null) {
             const p = (patch.nexradProduct || 'REF').toUpperCase();
+            const prevP = (this.state.nexradProduct || 'REF').toUpperCase();
             const ds = inferNexradDataSourceForProduct(p);
             patch.nexradProduct = p;
             patch.nexradDataSource = ds;
             patch.variable = nexradColormapFldKey(ds, p);
-            patch.nexradStormRelative = this._nexradStormRelativeFor(ds, p);
+            if (!('nexradStormRelative' in newState)) {
+                // Default: base radial velocity (L3 N0G only) — one fetch per time; fast scrub.
+                // SRV (N0G + N0S) is opt-in: setNexradStormRelative(true) or pass nexradStormRelative in setState.
+                // Re-selecting the same product (e.g. VEL → VEL) leaves the current SRV flag alone.
+                if (p !== 'VEL' || prevP !== 'VEL') {
+                    patch.nexradStormRelative = false;
+                }
+            }
         }
         if ('forecastHour' in patch && patch.forecastHour != null) {
             patch.forecastHour = Number(patch.forecastHour);
@@ -373,13 +381,6 @@ export class AguaceroCore extends EventEmitter {
         return `${site}_${group}_${elevNormUse}`;
     }
 
-    /** Storm-relative Level-III velocity (N0G + N0S) — matches aguacero-frontend `level3StormRelative` for VEL. */
-    _nexradStormRelativeFor(nexradDataSource, nexradProduct) {
-        const ds = nexradDataSource === 'level3' ? 'level3' : 'level2';
-        const p = (nexradProduct || 'REF').toUpperCase();
-        return ds === 'level3' && p === 'VEL';
-    }
-
     _emitStateChange() {
         const { colormap, baseUnit } = this._getColormapForVariable(this.state.variable);
         const toUnit = this._getTargetUnit(baseUnit, this.state.units);
@@ -1094,6 +1095,16 @@ export class AguaceroCore extends EventEmitter {
         await this.refreshNexradTimes();
     }
 
+    /**
+     * Opt-in storm-relative velocity (L3: N0G + N0S). When off (default), only base radial velocity is used (faster).
+     * @param {boolean} enabled
+     */
+    async setNexradStormRelative(enabled) {
+        if (!this.state.isNexrad) return;
+        await this.setState({ nexradStormRelative: Boolean(enabled) });
+        await this.refreshNexradTimes();
+    }
+
     async setNexradTimestamp(ts) {
         if (!this.state.isNexrad) return;
         await this.setState({ nexradTimestamp: ts != null ? Number(ts) : null });

package/src/nexrad_support.js

@@ -277,15 +277,16 @@ export function getRawNexradTiltsForCoalesce(siteId, nexradDataSource, nexradPro
     const v = (nexradProduct || 'REF').toUpperCase();
     const ds = nexradDataSource === 'level3' ? 'level3' : 'level2';
     const tilts = getRadarTilts(siteId, v);
+    /** L3 super-res VEL (N*G) uses the same first-N manifest slots as KDP/N0H — not the full L2 g2-only list. */
+    if (v === 'VEL') {
+        return tilts.slice(0, L3_TILT_INDEX_MANIFEST_SLOTS);
+    }
     if (ds === 'level2') {
         return [...tilts];
     }
     if (v === 'KDP' || v === 'N0H') {
         return tilts.slice(0, L3_TILT_INDEX_MANIFEST_SLOTS);
     }
-    if (v === 'VEL') {
-        return [...tilts];
-    }
     return [];
 }