@aguacerowx/javascript-sdk 0.0.9 → 0.0.10

package/dist/AguaceroCore.js

@@ -10,7 +10,6 @@ var _unitConversions = require("./unitConversions.js");
 var _dictionaries = require("./dictionaries.js");
 var _defaultColormaps = require("./default-colormaps.js");
 var _proj = _interopRequireDefault(require("proj4"));
-var _fzstd = require("fzstd");
 var _getBundleId = require("./getBundleId");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 // AguaceroCore.js - The Headless "Engine"
@@ -92,7 +91,7 @@ class AguaceroCore extends _events.EventEmitter {
       run: null,
       forecastHour: 0,
       visible: true,
-      opacity: userLayerOptions.opacity ?? 0.85,
+      opacity: userLayerOptions.opacity ?? 1,
       units: options.initialUnit || 'imperial',
       shaderSmoothingEnabled: options.shaderSmoothingEnabled ?? true
     };
@@ -190,24 +189,60 @@ class AguaceroCore extends _events.EventEmitter {
     this.isPlaying ? this.pause() : this.play();
   }
   step(direction = 1) {
-    var _this$modelStatus3;
-    const {
-      model,
-      date,
-      run,
-      forecastHour
-    } = this.state;
-    const forecastHours = (_this$modelStatus3 = this.modelStatus) === null || _this$modelStatus3 === void 0 || (_this$modelStatus3 = _this$modelStatus3[model]) === null || _this$modelStatus3 === void 0 || (_this$modelStatus3 = _this$modelStatus3[date]) === null || _this$modelStatus3 === void 0 ? void 0 : _this$modelStatus3[run];
-    if (!forecastHours || forecastHours.length === 0) return;
-    const currentIndex = forecastHours.indexOf(forecastHour);
-    if (currentIndex === -1) return;
-    const maxIndex = forecastHours.length - 1;
-    let nextIndex = currentIndex + direction;
-    if (nextIndex > maxIndex) nextIndex = 0;
-    if (nextIndex < 0) nextIndex = maxIndex;
-    this.setState({
-      forecastHour: forecastHours[nextIndex]
-    });
+    // --- THIS IS THE CORRECTED MRMS LOGIC ---
+    if (this.state.isMRMS) {
+      const {
+        variable,
+        mrmsTimestamp
+      } = this.state;
+      if (!this.mrmsStatus || !this.mrmsStatus[variable]) {
+        console.warn('[Core.step] MRMS status or variable not available.');
+        return;
+      }
+
+      // CRITICAL FIX: The UI and state emissions use a REVERSED array (newest first).
+      // The step logic MUST use the same reversed array for indexes to match.
+      const availableTimestamps = [...(this.mrmsStatus[variable] || [])].reverse();
+      if (availableTimestamps.length === 0) return;
+      const currentIndex = availableTimestamps.indexOf(mrmsTimestamp);
+      if (currentIndex === -1) {
+        // If not found, reset to the first (newest) frame
+        this.setState({
+          mrmsTimestamp: availableTimestamps[0]
+        });
+        return;
+      }
+      const maxIndex = availableTimestamps.length - 1;
+      let nextIndex = currentIndex + direction;
+
+      // Loop animation
+      if (nextIndex > maxIndex) nextIndex = 0;
+      if (nextIndex < 0) nextIndex = maxIndex;
+      const newTimestamp = availableTimestamps[nextIndex];
+      this.setState({
+        mrmsTimestamp: newTimestamp
+      });
+    } else {
+      var _this$modelStatus3;
+      const {
+        model,
+        date,
+        run,
+        forecastHour
+      } = this.state;
+      const forecastHours = (_this$modelStatus3 = this.modelStatus) === null || _this$modelStatus3 === void 0 || (_this$modelStatus3 = _this$modelStatus3[model]) === null || _this$modelStatus3 === void 0 || (_this$modelStatus3 = _this$modelStatus3[date]) === null || _this$modelStatus3 === void 0 ? void 0 : _this$modelStatus3[run];
+      if (!forecastHours || forecastHours.length === 0) return;
+      const currentIndex = forecastHours.indexOf(forecastHour);
+      if (currentIndex === -1) return;
+      const maxIndex = forecastHours.length - 1;
+      let nextIndex = currentIndex + direction;
+      if (nextIndex > maxIndex) nextIndex = 0;
+      if (nextIndex < 0) nextIndex = maxIndex;
+      const newHour = forecastHours[nextIndex];
+      this.setState({
+        forecastHour: newHour
+      });
+    }
   }
   setPlaybackSpeed(speed) {
     if (speed > 0) {
@@ -350,6 +385,10 @@ class AguaceroCore extends _events.EventEmitter {
     return new Uint8Array(reconstructedData.buffer);
   }
   async _loadGridData(state) {
+    if (this.isReactNative) {
+      console.warn(`[AguaceroCore] _loadGridData was called in React Native. This is a bypass. Data loading is handled natively.`);
+      return null;
+    }
     const {
       model,
       date,
@@ -404,7 +443,7 @@ class AguaceroCore extends _events.EventEmitter {
         const headers = {
           'x-api-key': this.apiKey
         };
-        if (this.bundleId) {
+        if (this.bundleId && this.isReactNative) {
           headers['x-app-identifier'] = this.bundleId;
         }
         const response = await fetch(urlWithApiKeyParam, {
@@ -504,20 +543,68 @@ class AguaceroCore extends _events.EventEmitter {
       const index1D = j * nx + i;
       const byteValue = gridData.data[index1D];
       const signedQuantizedValue = byteValue - 128;
+
+      // --- START OF FIX ---
+      // You were missing 'scale_type' in this destructuring assignment.
       const {
         scale,
         offset,
-        missing_quantized
+        missing_quantized,
+        scale_type
       } = gridData.encoding;
+      // --- END OF FIX ---
+
       if (signedQuantizedValue === missing_quantized) return null;
-      const nativeValue = signedQuantizedValue * scale + offset;
+      const intermediateValue = signedQuantizedValue * scale + offset;
+
+      // Step 2: Apply non-linear scaling if specified
+      let nativeValue = intermediateValue;
+      if (scale_type === 'sqrt') {
+        // Square the value while preserving its sign
+        nativeValue = intermediateValue < 0 ? -(intermediateValue * intermediateValue) : intermediateValue * intermediateValue;
+      }
       const {
+        colormap,
         baseUnit
       } = this._getColormapForVariable(variable);
+
+      // If the value is outside the colormap's bounds, return null.
+      if (colormap && colormap.length >= 2) {
+        const minBound = colormap[0];
+        const maxBound = colormap[colormap.length - 2];
+        if (nativeValue < minBound || nativeValue > maxBound) {
+          return null;
+        }
+      }
       let dataNativeUnit = baseUnit || (_dictionaries.DICTIONARIES.fld[variable] || {}).defaultUnit || 'none';
       const displayUnit = this._getTargetUnit(dataNativeUnit, units);
       const conversionFunc = (0, _unitConversions.getUnitConversionFunction)(dataNativeUnit, displayUnit);
-      const displayValue = conversionFunc ? conversionFunc(nativeValue) : nativeValue;
+      let displayValue = conversionFunc ? conversionFunc(nativeValue) : nativeValue;
+
+      // --- START: ADDED CODE ---
+
+      // Create a variable to hold the precipitation type, if any.
+      let precipType = null;
+
+      // Check if the current variable is one of the special ptype variables.
+      if (variable === 'ptypeRefl' || variable === 'ptypeRate') {
+        const value = nativeValue; // Use the raw, unconverted value for ptype logic
+
+        if (value >= 100 && value < 200) {
+          displayValue -= 100;
+          precipType = 'Snow';
+        } else if (value >= 200 && value < 300) {
+          displayValue -= 200;
+          precipType = 'Frzg Rain'; // Abbreviated for tooltips
+        } else if (value >= 300 && value < 400) {
+          displayValue -= 300;
+          precipType = 'Ice Pellets';
+        } else {
+          precipType = 'Rain';
+        }
+      }
+
+      // Return the final payload, now including the precipType.
       return {
         lngLat: {
           lng,
@@ -528,7 +615,8 @@ class AguaceroCore extends _events.EventEmitter {
           name: this.getVariableDisplayName(variable)
         },
         value: displayValue,
-        unit: displayUnit
+        unit: displayUnit,
+        precipType: precipType // NEW: Add this to the return object
       };
     } catch (error) {
       return null;
@@ -548,9 +636,6 @@ class AguaceroCore extends _events.EventEmitter {
       colormap: [],
       baseUnit: ''
     };
-
-    // This logic for user-provided custom colormaps is correct.
-    // If a user provides a custom map, it should always take top priority.
     if (this.customColormaps[variable] && this.customColormaps[variable].colormap) {
       return {
         colormap: this.customColormaps[variable].colormap,
@@ -566,45 +651,18 @@ class AguaceroCore extends _events.EventEmitter {
       };
     }
     const defaultColormapData = _defaultColormaps.DEFAULT_COLORMAPS[colormapKey];
-
-    // --- START OF THE BUG FIX ---
-    // This block handles the "default" case when no custom colormap is provided.
     if (defaultColormapData && defaultColormapData.units) {
-      var _DICTIONARIES$fld$var;
-      // 1. EDITED: Explicitly look up the CORRECT default unit from the main dictionary.
-      //    This is the information source we were previously ignoring.
-      const preferredUnit = (_DICTIONARIES$fld$var = _dictionaries.DICTIONARIES.fld[variable]) === null || _DICTIONARIES$fld$var === void 0 ? void 0 : _DICTIONARIES$fld$var.defaultUnit; // e.g., '°C' for '2t_2'
-
-      // 2. EDITED: Check if that preferred unit exists in the colormap definitions.
-      if (preferredUnit && defaultColormapData.units[preferredUnit]) {
-        const unitData = defaultColormapData.units[preferredUnit];
-        if (unitData && unitData.colormap) {
-          // 3. EDITED: If it exists, return ITS data. This is the correct path.
-          console.log(`[AguaceroCore] Using dictionary default unit '${preferredUnit}' for variable '${variable}'.`);
-          return {
-            colormap: unitData.colormap,
-            baseUnit: preferredUnit
-          };
-        }
-      }
-
-      // 4. EDITED: The old, buggy logic now serves as a FALLBACK ONLY.
-      //    This will only run if the specified defaultUnit is missing from the colormap data.
-      console.warn(`[AguaceroCore] Default unit for '${variable}' not found in colormap. Using fallback.`);
-      const availableUnits = Object.keys(defaultColormapData.units);
-      if (availableUnits.length > 0) {
-        const fallbackUnit = availableUnits[0]; // e.g., '°F'
-        const unitData = defaultColormapData.units[fallbackUnit];
-        if (unitData && unitData.colormap) {
-          return {
-            colormap: unitData.colormap,
-            baseUnit: fallbackUnit
-          };
-        }
+      // ✅ Get defaultUnit from the field dictionary
+      const fieldInfo = _dictionaries.DICTIONARIES.fld[variable] || {};
+      const baseUnit = fieldInfo.defaultUnit || Object.keys(defaultColormapData.units)[0];
+      const unitData = defaultColormapData.units[baseUnit];
+      if (unitData && unitData.colormap) {
+        return {
+          colormap: unitData.colormap,
+          baseUnit: baseUnit
+        };
       }
     }
-    // --- END OF THE BUG FIX ---
-
     return {
       colormap: [],
       baseUnit: ''
@@ -713,13 +771,15 @@ class AguaceroCore extends _events.EventEmitter {
   }
   _getTargetUnit(defaultUnit, system) {
     if (system === 'metric') {
-      if (['°F', '°C'].includes(defaultUnit)) return 'celsius';
+      if (['°F', '°C', 'fahrenheit', 'celsius'].includes(defaultUnit)) return '°C';
       if (['kts', 'mph', 'm/s'].includes(defaultUnit)) return 'km/h';
       if (['in', 'mm', 'cm'].includes(defaultUnit)) return 'mm';
     }
-    if (['°F', '°C'].includes(defaultUnit)) return 'fahrenheit';
-    if (['kts', 'mph', 'm/s'].includes(defaultUnit)) return 'mph';
-    if (['in', 'mm', 'cm'].includes(defaultUnit)) return 'in';
+    if (system === 'imperial') {
+      if (['°F', '°C', 'fahrenheit', 'celsius'].includes(defaultUnit)) return '°F';
+      if (['kts', 'mph', 'm/s'].includes(defaultUnit)) return 'mph';
+      if (['in', 'mm', 'cm'].includes(defaultUnit)) return 'in';
+    }
     return defaultUnit;
   }
   _getGridIndexFromLngLat(lng, lat) {

package/dist/default-colormaps.js

@@ -17,14 +17,10 @@ const DEFAULT_COLORMAPS = exports.DEFAULT_COLORMAPS = {
         // --- Snow Palette (Reflectivity Values Offset by +100) ---
         105, "#33ccff", 135, "#8800cc", 170, "#ffccff", 180, "#dddddd",
         // --- Freezing Rain Palette (Reflectivity Values Offset by +200) ---
-        205, "#ff3300", 230, "#ffaa33", 280, "#cc0066"],
-        "breakpoints": [
-        // Rain Breakpoints
-        5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80,
-        // Snow Breakpoints
-        105, 110, 115, 120, 125, 130, 135, 140, 145, 150, 155, 160, 165, 170, 175, 180,
-        // Freezing Rain Breakpoints
-        205, 210, 215, 220, 225, 230, 235, 240, 245, 250, 255, 260, 265, 270, 275, 280]
+        205, "#ff3300", 230, "#ffaa33", 280, "#cc0066",
+        // icep
+        305, "#8800cc", 370, "#ffbb00", 380, "#dddddd"],
+        "breakpoints": []
       }
     }
   },
@@ -811,6 +807,37 @@ const DEFAULT_COLORMAPS = exports.DEFAULT_COLORMAPS = {
       }
     }
   },
+  "ptypeRate": {
+    "type": "fill",
+    "gridded": false,
+    "interpolationType": "interpolate",
+    "units": {
+      "in/hr": {
+        "colormap": [
+        // --- Rain Palette (Standard Reflectivity Values: 5 to 80) ---
+        0.005, "#00cc66", 0.1, "#ffff00", 0.3, "#ff8800", 1, "#ff0000", 1.5, '#ff00cc',
+        // --- Snow Palette (Reflectivity Values Offset by +100) ---
+        100.05, "#33ccff", 101, "#000099", 104, "#ff00cc",
+        // --- Freezing Rain Palette (Reflectivity Values Offset by +200) ---
+        200.005, "#ff3300", 200.1, "#ff33ff", 200.6, "#cc99cc",
+        // icep
+        300.005, "#8800cc", 300.2, "#aa44dd", 300.6, "#cc88dd"],
+        "breakpoints": []
+      },
+      "mm/hr": {
+        "colormap": [
+        // --- Rain Palette (Standard Reflectivity Values: 5 to 80) ---
+        0.1, "#00cc66", 3, "#ffff00", 7, "#ff8800", 24, "#ff0000", 36, '#ff00cc',
+        // --- Snow Palette (Reflectivity Values Offset by +100) ---
+        100.1, "#33ccff", 103, "#000099", 110, "#ff00cc",
+        // --- Freezing Rain Palette (Reflectivity Values Offset by +200) ---
+        200.1, "#ff3300", 203, "#ff33ff", 214, "#cc99cc",
+        // icep
+        300.1, "#ff3300", 303, "#ff33ff", 314, "#cc99cc"],
+        "breakpoints": []
+      }
+    }
+  },
   "frzrRefl": {
     "type": "fill",
     "gridded": false,
@@ -902,11 +929,11 @@ const DEFAULT_COLORMAPS = exports.DEFAULT_COLORMAPS = {
         "colormap": [0.01, "#eeccff", .1, "#ff9999", .25, "#cc3366", .5, "#ff9933", .75, "#ffee00", 1, "#00cccc", 3, "#99ffff"],
         "breakpoints": [0.01, 0.1, 0.25, 0.5, 0.75, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 7, 8, 9, 10]
       },
-      "cm": {
+      "cm [QPF]": {
         "colormap": [0.03, "#eeccff", .25, "#ff9999", .75, "#cc3366", 1, "#cc0066", 2, "#ffee00", 3, "#00cccc", 7, "#99ffff"],
         "breakpoints": [.03, .25, .5, .75, 1, 1.25, 1.5, 1.75, 2, 2.25, 2.5, 2.75, 3, 3.25, 3.5, 3.75, 4, 4.5, 5, 5.5, 6, 7, 8, 9, 10, 12, 14, 16, 18, 20, 22, 24, 26]
       },
-      "mm": {
+      "mm [QPF]": {
         "colormap": [0.3, "#eeccff", 2.5, "#ff9999", 7.5, "#cc3366", 10, "#cc0066", 20, "#ffee00", 30, "#00cccc", 70, "#99ffff"],
         "breakpoints": [0.3, 2.5, 5, 7.5, 10, 12.5, 15, 17.5, 20, 22.5, 25, 27.5, 30, 32.5, 35, 37.5, 40, 45, 50, 55, 60, 70, 80, 90, 100, 120, 140, 160, 180, 200, 220, 240, 260]
       }
@@ -921,11 +948,11 @@ const DEFAULT_COLORMAPS = exports.DEFAULT_COLORMAPS = {
         "colormap": [0.01, "#eeccff", .1, "#ff9999", .3, "#cc3366", .4, "#cc0033", .5, "#ff9933", .9, "#ffee00", 1, "#00cccc", 3, "#99ffff"],
         "breakpoints": [0.01, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1, 1.25, 1.5, 1.75, 2, 2.5, 3]
       },
-      "cm": {
+      "cm [QPF]": {
         "colormap": [0.03, "#eeccff", .25, "#ff9999", .75, "#cc3366", 1, "#cc0033", 2, "#ffee00", 3, "#00cccc", 7, "#99ffff"],
         "breakpoints": [.03, .25, .5, .75, 1, 1.25, 1.5, 1.75, 2, 2.25, 2.5, 2.75, 3, 3.25, 3.5, 3.75, 4, 4.5, 5, 5.5, 6, 7, 8, 9, 10, 12, 14, 16]
       },
-      "mm": {
+      "mm [QPF]": {
         "colormap": [0.3, "#eeccff", 2.5, "#ff9999", 7.5, "#cc3366", 10, "#cc0033", 20, "#ffee00", 30, "#00cccc", 70, "#99ffff"],
         "breakpoints": [0.3, 2.5, 5, 7.5, 10, 12.5, 15, 17.5, 20, 22.5, 25, 27.5, 30, 32.5, 35, 37.5, 40, 45, 50, 55, 60, 70, 80, 90, 100, 120, 140, 160]
       }