@aguacerowx/react-native 0.0.51 → 0.0.53

package/lib/commonjs/WeatherLayerManager.js

@@ -20,6 +20,8 @@ var _MapRegistry = require("./MapRegistry");
 var _satelliteBridgeDiag = require("./satelliteBridgeDiag");
 var _aguaceroRnDebug = require("./aguaceroRnDebug");
 var _aguaceroCoreDebugHooks = require("./aguaceroCoreDebugHooks");
+var _gridCdnAuth = require("./gridCdnAuth");
+var _satelliteRnDebug = require("./satelliteRnDebug");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 // packages/react-native/src/WeatherLayerManager.js
@@ -32,9 +34,9 @@ const SATELLITE_NATIVE = _reactNative.Platform.OS === 'android' || _reactNative.
   note: 'If you never see sat-bridge logs, the app bundle is not loading this WeatherLayerManager build.'
 });
 
-/**
- * Same filtering as {@link AguaceroCore#_getFilteredMrmsTimestampsForVariable} for older cores
- * where that helper (or {@code setMRMSDurationValue}) is missing from the prototype chain.
+/**
+ * Same filtering as {@link AguaceroCore#_getFilteredMrmsTimestampsForVariable} for older cores
+ * where that helper (or {@code setMRMSDurationValue}) is missing from the prototype chain.
  */
 function getFilteredMrmsTimestampsCompat(core, variable) {
   const raw = core.mrmsStatus?.[variable];
@@ -49,9 +51,9 @@ function getFilteredMrmsTimestampsCompat(core, variable) {
   return list;
 }
 
-/**
- * Older npm installs may resolve an {@link AguaceroCore} without {@code setMRMSDurationValue} /
- * {@code setNexradDurationValue}; mirror those methods here using the same logic as the SDK.
+/**
+ * Older npm installs may resolve an {@link AguaceroCore} without {@code setMRMSDurationValue} /
+ * {@code setNexradDurationValue}; mirror those methods here using the same logic as the SDK.
  */
 async function applyMrmsDurationValue(core, value) {
   if (typeof core.setMRMSDurationValue === 'function') {
@@ -116,12 +118,12 @@ const {
   InspectorModule
 } = _reactNative.NativeModules;
 
-/**
- * `state:change` payloads can briefly have {@code isNexrad} before {@code nexradSite} / {@code nexradTimestamp}
- * are populated; {@code core.state} is updated first. Merge so readouts match the active radar.
- *
- * @param {object | null} emitted
- * @param {object | null} coreState
+/**
+ * `state:change` payloads can briefly have {@code isNexrad} before {@code nexradSite} / {@code nexradTimestamp}
+ * are populated; {@code core.state} is updated first. Merge so readouts match the active radar.
+ *
+ * @param {object | null} emitted
+ * @param {object | null} coreState
  */
 function mergeNexradEmittedWithCore(emitted, coreState) {
   if (!emitted || !coreState) return null;
@@ -136,10 +138,10 @@ function mergeNexradEmittedWithCore(emitted, coreState) {
   };
 }
 
-/**
- * Compact timeline identity for deduping {@code state:change}: extending the NEXRAD/satellite window
- * often keeps the same selected unix — without this, {@link WeatherLayerManager} short-circuits and
- * never calls native {@code sync} / preload with the expanded frame list.
+/**
+ * Compact timeline identity for deduping {@code state:change}: extending the NEXRAD/satellite window
+ * often keeps the same selected unix — without this, {@link WeatherLayerManager} short-circuits and
+ * never calls native {@code sync} / preload with the expanded frame list.
  */
 function nexradObsTimelineSig(state) {
   const arr = [...(state?.availableNexradTimestamps || [])].map(Number).filter(t => Number.isFinite(t)).sort((a, b) => a - b);
@@ -180,37 +182,34 @@ function wxGridWarn(tag, detail) {
   }
 }
 
-/**
- * Native {@code processFrame} must mirror browser/AguaceroCore grid auth: encoded {@code apiKey}
- * in the query string and optional {@code Origin} / {@code Referer} (many CloudFront setups require them).
- *
- * @param {string} baseGridUrl
- * @param {string} resourcePath
- * @param {string} apiKey
- * @param {string | null | undefined} bundleId
- * @param {string | undefined} gridRequestSiteOrigin - e.g. production web origin your edge allowlists (no trailing slash)
+/**
+ * Native {@code processFrame} must mirror browser/AguaceroCore grid auth: encoded {@code apiKey}
+ * in the query string and optional {@code Origin} / {@code Referer} (many CloudFront setups require them).
+ *
+ * @param {string} baseGridUrl
+ * @param {string} resourcePath
+ * @param {string} apiKey
+ * @param {string | null | undefined} bundleId
+ * @param {string | undefined} gridRequestSiteOrigin - prop or core origin (see {@link resolveGridRequestSiteOrigin})
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCore | null | undefined} core
  */
-function buildGridFrameProcessOptions(baseGridUrl, resourcePath, apiKey, bundleId, gridRequestSiteOrigin) {
-  const url = `${baseGridUrl}${resourcePath}?apiKey=${encodeURIComponent(apiKey)}`;
+function buildGridFrameProcessOptions(baseGridUrl, resourcePath, apiKey, bundleId, gridRequestSiteOrigin, core) {
+  const trimmedKey = typeof apiKey === 'string' ? apiKey.trim() : apiKey;
+  const url = `${baseGridUrl}${resourcePath}?apiKey=${encodeURIComponent(trimmedKey || '')}`;
   const options = {
     url,
-    apiKey,
+    apiKey: trimmedKey,
     bundleId
   };
-  if (typeof gridRequestSiteOrigin === 'string') {
-    let origin = gridRequestSiteOrigin.trim();
-    while (origin.endsWith('/')) {
-      origin = origin.slice(0, -1);
-    }
-    if (origin.length > 0) {
-      options.gridRequestSiteOrigin = origin;
-    }
+  const origin = (0, _gridCdnAuth.resolveGridRequestSiteOrigin)(gridRequestSiteOrigin, core);
+  if (origin) {
+    options.gridRequestSiteOrigin = origin;
   }
   return options;
 }
 
-/**
- * A helper function to generate the raw RGBA byte buffer for the colormap texture.
+/**
+ * A helper function to generate the raw RGBA byte buffer for the colormap texture.
  */
 const _generateColormapBytes = colormap => {
   const width = 256;
@@ -262,6 +261,12 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
     customColormaps,
     initialMode,
     initialVariable,
+    /** GOES instrument when {@link initialMode} is `"satellite"` (default `GOES19-EAST`). */
+    initialSatelliteId,
+    /** Sector token or label when {@link initialMode} is `"satellite"` (default `conus` → GOES-EAST CONUS). */
+    initialSatelliteSector,
+    /** Product/band when {@link initialMode} is `"satellite"` (e.g. `geocolor`, `C13`). Falls back to {@link initialVariable}. */
+    initialSatelliteProduct,
     autoRefresh,
     autoRefreshInterval,
     initialModel,
@@ -281,6 +286,14 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
       enabled: Boolean(debug)
     });
   }, [debug]);
+  (0, _react.useEffect)(() => {
+    if (!debug) return undefined;
+    (0, _satelliteRnDebug.auditSatelliteIntegration)({
+      core,
+      satelliteLayerRef
+    });
+    return (0, _satelliteRnDebug.installSatelliteDiagnosticListener)();
+  }, [debug, core]);
   const context = (0, _react.useContext)(_AguaceroContext.AguaceroContext);
 
   // Create the core here instead of getting it from context
@@ -291,7 +304,12 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
     layerOptions: {
       mode: initialMode,
       variable: initialVariable,
-      model: initialModel
+      model: initialModel,
+      ...(initialMode === 'satellite' ? {
+        satelliteId: initialSatelliteId,
+        sector: initialSatelliteSector,
+        satelliteProduct: initialSatelliteProduct ?? initialVariable
+      } : {})
     },
     autoRefresh: false // <-- add this
   }), [apiKey, gridRequestSiteOrigin]);
@@ -416,6 +434,8 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
   // Track if we've done the initial load
   const hasInitialLoad = (0, _react.useRef)(false);
   const hasPreloadedRef = (0, _react.useRef)(false);
+  /** Bumped on {@code cancelAllFrames} / full reload so stale {@code processFrame} results are ignored. */
+  const preloadGenerationRef = (0, _react.useRef)(0);
 
   // Track the last state we processed to avoid redundant updates
   const lastProcessedState = (0, _react.useRef)(null);
@@ -496,9 +516,9 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
       refreshData: () => {
         _checkForUpdates();
       },
-      /**
-       * NWS watches/warnings (native map, iOS + Android): same options as mapsgl {@link WeatherLayerManager#configureWatchesWarnings}.
-       * @param {object} partial
+      /**
+       * NWS watches/warnings (native map, iOS + Android): same options as mapsgl {@link WeatherLayerManager#configureWatchesWarnings}.
+       * @param {object} partial
        */
       configureWatchesWarnings: partial => {
         setWatchesWarningsOptions(prev => ({
@@ -562,6 +582,8 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
 
     // Only mark as "has preloaded" after validation passes
     hasPreloadedRef.current = true;
+    const generation = preloadGenerationRef.current;
+    const isStaleGeneration = () => generation !== preloadGenerationRef.current;
     wxGridVerbose('preloadStart', {
       isMRMS,
       model,
@@ -678,7 +700,7 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
       } else {
         resourcePath = `/grids/${model}/${date}/${run}/${currentFrame}/${variable}/0`;
       }
-      const options = (0, _aguaceroRnDebug.augmentProcessFrameOptionsForDebug)(buildGridFrameProcessOptions(core.baseGridUrl, resourcePath, core.apiKey, core.bundleId, gridRequestSiteOrigin), core);
+      const options = (0, _aguaceroRnDebug.augmentProcessFrameOptionsForDebug)(buildGridFrameProcessOptions(core.baseGridUrl, resourcePath, core.apiKey, core.bundleId, gridRequestSiteOrigin, core), core);
       (0, _aguaceroCoreDebugHooks.logProcessFrameAuthMismatch)(core, options, {
         phase: 'preloadCurrent',
         currentCacheKey
@@ -690,6 +712,13 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
           frame: currentFrame
         });
         const result = await WeatherFrameProcessorModule.processFrame(options);
+        if (isStaleGeneration()) {
+          wxGridVerbose('preloadCurrentFrameStale', {
+            currentCacheKey,
+            generation
+          });
+          return;
+        }
         if (!result || !result.filePath) {
           hasPreloadedRef.current = false;
           wxGridWarn('preloadAbort', {
@@ -825,12 +854,15 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
       } else {
         resourcePath = `/grids/${model}/${date}/${run}/${frame}/${variable}/0`;
       }
-      const options = (0, _aguaceroRnDebug.augmentProcessFrameOptionsForDebug)(buildGridFrameProcessOptions(core.baseGridUrl, resourcePath, core.apiKey, core.bundleId, gridRequestSiteOrigin), core);
+      const options = (0, _aguaceroRnDebug.augmentProcessFrameOptionsForDebug)(buildGridFrameProcessOptions(core.baseGridUrl, resourcePath, core.apiKey, core.bundleId, gridRequestSiteOrigin, core), core);
       (0, _aguaceroCoreDebugHooks.logProcessFrameAuthMismatch)(core, options, {
         phase: 'preloadBackground',
         cacheKey
       });
       WeatherFrameProcessorModule.processFrame(options).then(result => {
+        if (isStaleGeneration()) {
+          return;
+        }
         if (!result || !result.filePath) {
           return;
         }
@@ -1218,7 +1250,7 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
             m = (frameDate.getUTCMonth() + 1).toString().padStart(2, '0'),
             d = frameDate.getUTCDate().toString().padStart(2, '0');
           const resourcePath = `/grids/mrms/${y}${m}${d}/${frame}/0/${currentVariable}/0`;
-          const options = (0, _aguaceroRnDebug.augmentProcessFrameOptionsForDebug)(buildGridFrameProcessOptions(core.baseGridUrl, resourcePath, core.apiKey, core.bundleId, gridRequestSiteOrigin), core);
+          const options = (0, _aguaceroRnDebug.augmentProcessFrameOptionsForDebug)(buildGridFrameProcessOptions(core.baseGridUrl, resourcePath, core.apiKey, core.bundleId, gridRequestSiteOrigin, core), core);
           (0, _aguaceroCoreDebugHooks.logProcessFrameAuthMismatch)(core, options, {
             phase: 'mrmsRefresh',
             cacheKey
@@ -1487,6 +1519,7 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
           }
         }
         hasPreloadedRef.current = false;
+        preloadGenerationRef.current += 1;
         preloadedDataCache.current.clear();
         cachedGeometry.current = null;
         cachedColormap.current = null;
@@ -1494,7 +1527,8 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
         WeatherFrameProcessorModule.cancelAllFrames();
         wxGridVerbose('cancelAllFrames', {
           reason: 'needsFullLoad',
-          variable: newState.variable
+          variable: newState.variable,
+          generation: preloadGenerationRef.current
         });
         if (!newState.variable) {
           previousStateRef.current = newState;
@@ -1516,6 +1550,8 @@ const WeatherLayerManager = exports.WeatherLayerManager = /*#__PURE__*/(0, _reac
             mrmsTimestamp: newState.mrmsTimestamp,
             forecastHour: newState.forecastHour
           });
+          hasPreloadedRef.current = false;
+          void preloadAllFramesToDisk(newState);
         }
         if (success && newState.opacity !== renderProps.opacity) {
           setRenderProps(prev => ({