@aguacerowx/react-native 0.0.51 → 0.0.53

package/android/src/main/java/com/aguacerowx/reactnative/SatelliteLayerView.java

@@ -1,384 +1,556 @@
-package com.aguacerowx.reactnative;
-
-import android.app.Activity;
-import android.os.Handler;
-import android.os.Looper;
-import android.util.Log;
-import android.view.View;
-import android.view.ViewGroup;
-import android.widget.FrameLayout;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import com.facebook.react.uimanager.ThemedReactContext;
-import com.mapbox.maps.LayerPosition;
-import com.mapbox.maps.MapView;
-import com.mapbox.maps.MapboxMap;
-import com.mapbox.maps.Style;
-
-import org.json.JSONArray;
-import org.json.JSONObject;
-
-import java.io.IOException;
-import java.util.Collections;
-import java.util.Locale;
-import java.util.Set;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-import java.util.concurrent.atomic.AtomicInteger;
-
-import okhttp3.Call;
-import okhttp3.HttpUrl;
-import okhttp3.OkHttpClient;
-import okhttp3.Request;
-import okhttp3.Response;
-import okhttp3.ResponseBody;
-
-/**
- * Hosts {@link SatelliteLayer} on the app {@link MapView} (Android satellite path — parity with mapsgl
- * {@code WeatherLayerManager} + {@code SatelliteShaderManager}).
- */
-public class SatelliteLayerView extends FrameLayout {
-
-    private static final String TAG = "AguaceroSatelliteView";
-
-    private final SatelliteLayer satelliteLayer;
-    private final String layerId;
-    private MapView mapView;
-    private boolean isLayerAdded = false;
-    private String belowLayerID = null;
-
-    /** Concurrent fetch+decode so the priority frame is not blocked behind the rest of the timeline. */
-    private final ExecutorService satDecodeExecutor =
-            Executors.newFixedThreadPool(
-                    4,
-                    r -> {
-                        Thread t = new Thread(r, "aguacero-satellite-decode");
-                        t.setPriority(Thread.NORM_PRIORITY - 1);
-                        return t;
-                    });
-
-    private final Handler mainHandler = new Handler(Looper.getMainLooper());
-    private final AtomicInteger decodeGeneration = new AtomicInteger(0);
-
-    private volatile String lastRunKey = null;
-
-    private final Set<Long> fetchInFlight =
-            Collections.newSetFromMap(new ConcurrentHashMap<Long, Boolean>());
-
-    private static final OkHttpClient HTTP =
-            new OkHttpClient.Builder()
-                    .followRedirects(true)
-                    .followSslRedirects(true)
-                    .build();
-
-    /**
-     * Match grid {@code buildGridFrameProcessOptions}: authoritative {@code apiKey} in the query string
-     * plus {@code x-api-key} header (same pattern as AguaceroCore grid / NEXRAD CDN).
-     */
-    private static String satelliteUrlWithQueryApiKey(String url, String apiKey) {
-        HttpUrl parsed = HttpUrl.parse(url);
-        if (parsed == null) {
-            return url;
-        }
-        HttpUrl.Builder b = parsed.newBuilder();
-        b.setQueryParameter("apiKey", apiKey);
-        if (parsed.queryParameter("userId") == null) {
-            b.setQueryParameter("userId", "sdk-user");
-        }
-        return b.build().toString();
-    }
-
-    public SatelliteLayerView(@NonNull ThemedReactContext context) {
-        super(context);
-        this.satelliteLayer = new SatelliteLayer();
-        this.layerId = AguaceroStyleLayerIds.SATELLITE_CUSTOM_LAYER;
-    }
-
-    public void setBelowID(String belowID) {
-        this.belowLayerID = belowID;
-    }
-
-    @Override
-    protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
-        super.onLayout(changed, left, top, right, bottom);
-        findMapViewAndAddLayer();
-    }
-
-    private void findMapViewAndAddLayer() {
-        if (mapView != null) {
-            Style existing = mapView.getMapboxMap().getStyle();
-            if (existing != null && existing.isStyleLoaded() && existing.styleLayerExists(layerId)) {
-                isLayerAdded = true;
-                return;
-            }
-        }
-
-        Activity activity = ((ThemedReactContext) getContext()).getCurrentActivity();
-        if (activity == null) {
-            return;
-        }
-        View rootView = activity.findViewById(android.R.id.content);
-        if (rootView == null) {
-            return;
-        }
-        MapView foundMap = findMapViewRecursive(rootView);
-        if (foundMap == null) {
-            return;
-        }
-        this.mapView = foundMap;
-        MapboxMap mapboxMap = mapView.getMapboxMap();
-        Style.OnStyleLoaded styleLoadedCallback =
-                style -> {
-                    if (!style.styleLayerExists(layerId)) {
-                        LayerPosition position = null;
-                        if (style.styleLayerExists(AguaceroStyleLayerIds.WEATHER_GRID_CUSTOM_LAYER)) {
-                            position =
-                                    new LayerPosition(
-                                            AguaceroStyleLayerIds.WEATHER_GRID_CUSTOM_LAYER, null, null);
-                        } else if (this.belowLayerID != null && style.styleLayerExists(this.belowLayerID)) {
-                            position = new LayerPosition(null, this.belowLayerID, null);
-                        }
-                        style.addStyleCustomLayer(layerId, satelliteLayer, position);
-                        isLayerAdded = true;
-                        triggerRepaint();
-                    }
-                };
-        Style currentStyle = mapboxMap.getStyle();
-        if (currentStyle != null && currentStyle.isStyleLoaded()) {
-            styleLoadedCallback.onStyleLoaded(currentStyle);
-        } else {
-            mapboxMap.getStyle(styleLoadedCallback);
-        }
-    }
-
-    private MapView findMapViewRecursive(View view) {
-        if (view instanceof MapView) return (MapView) view;
-        if (view instanceof ViewGroup) {
-            ViewGroup vg = (ViewGroup) view;
-            for (int i = 0; i < vg.getChildCount(); i++) {
-                MapView f = findMapViewRecursive(vg.getChildAt(i));
-                if (f != null) return f;
-            }
-        }
-        return null;
-    }
-
-    private void triggerRepaint() {
-        if (mapView != null) mapView.post(mapView.getMapboxMap()::triggerRepaint);
-    }
-
-    static final class FrameClass {
-        final boolean trueColor;
-        @NonNull final String colormapKind;
-        final boolean useColormap;
-
-        FrameClass(boolean trueColor, @NonNull String colormapKind, boolean useColormap) {
-            this.trueColor = trueColor;
-            this.colormapKind = colormapKind;
-            this.useColormap = useColormap;
-        }
-    }
-
-    static FrameClass classifyShaderFileName(@Nullable String shaderFileName) {
-        String fn = shaderFileName != null ? shaderFileName : "";
-        boolean isTrueColor =
-                fn.contains("_truecolor_")
-                        || fn.contains("_geocolor_")
-                        || fn.contains("_firetemperature_")
-                        || fn.contains("_dust_")
-                        || fn.contains("_simplewatervapor_")
-                        || fn.contains("_ntmicro_")
-                        || fn.contains("_daycloudphase_")
-                        || fn.contains("_daylandcloudfire_")
-                        || fn.contains("_airmass_")
-                        || fn.contains("_sandwich_");
-
-        String colormapType = "none";
-        if (fn.contains("C13") || fn.contains("C14") || fn.contains("C15") || fn.contains("C16")) {
-            colormapType = "ir";
-        } else if (fn.contains("C08") || fn.contains("C09") || fn.contains("C10")) {
-            colormapType = "wv";
-        }
-
-        boolean useColormap = !isTrueColor && !"none".equals(colormapType);
-        return new FrameClass(isTrueColor, colormapType, useColormap);
-    }
-
-    public void clearSatellite() {
-        decodeGeneration.incrementAndGet();
-        fetchInFlight.clear();
-        satelliteLayer.clearAll();
-        triggerRepaint();
-    }
-
-    /**
-     * Full sync from JS: run key, optional style, target unix, and frame descriptors (small strings —
-     * no image bytes on the bridge).
-     */
-    public void syncFromJson(@Nullable String json) {
-        if (json == null || json.isEmpty()) return;
-        try {
-            JSONObject o = new JSONObject(json);
-            String runKey = o.optString("runKey", "");
-            if (!runKey.isEmpty() && !runKey.equals(lastRunKey)) {
-                lastRunKey = runKey;
-                decodeGeneration.incrementAndGet();
-                fetchInFlight.clear();
-                satelliteLayer.clearAll();
-            }
-
-            boolean visible = o.optBoolean("visible", true);
-            float opacity = (float) o.optDouble("opacity", 1.0);
-            int fillSmoothing = o.optInt("fillSmoothing", 0);
-            satelliteLayer.setVisible(visible);
-            satelliteLayer.setOpacity(opacity);
-            satelliteLayer.setFillSmoothing(fillSmoothing);
-
-            long targetUnix = Long.MIN_VALUE;
-            if (o.has("targetUnix") && !o.isNull("targetUnix")) {
-                targetUnix = o.getLong("targetUnix");
-            }
-            if (targetUnix != Long.MIN_VALUE) {
-                satelliteLayer.setActiveUnix(targetUnix);
-            }
-
-            String apiKey = o.optString("apiKey", "");
-            String bundleId = o.optString("bundleId", "");
-            String gridSiteOrigin = o.optString("gridRequestSiteOrigin", "").trim();
-            while (gridSiteOrigin.endsWith("/")) {
-                gridSiteOrigin = gridSiteOrigin.substring(0, gridSiteOrigin.length() - 1);
-            }
-            JSONArray frames = o.optJSONArray("frames");
-            if (frames == null || apiKey.isEmpty()) {
-                triggerRepaint();
-                return;
-            }
-
-            final int gen = decodeGeneration.get();
-            for (int i = 0; i < frames.length(); i++) {
-                JSONObject f = frames.getJSONObject(i);
-                long unix = f.getLong("unix");
-                String url = f.getString("url");
-                String shaderFileName = f.optString("shaderFileName", "");
-                scheduleFetchIfNeeded(gen, unix, url, shaderFileName, apiKey, bundleId, gridSiteOrigin);
-            }
-            triggerRepaint();
-        } catch (Exception e) {
-            Log.e(TAG, "syncFromJson failed", e);
-        }
-    }
-
-    private void scheduleFetchIfNeeded(
-            int gen,
-            long unix,
-            @NonNull String url,
-            @NonNull String shaderFileName,
-            @NonNull String apiKey,
-            @NonNull String bundleId,
-            @NonNull String gridRequestSiteOrigin) {
-        if (satelliteLayer.isFrameCached(unix)) {
-            return;
-        }
-        if (!fetchInFlight.add(unix)) {
-            return;
-        }
-
-        satDecodeExecutor.execute(
-                () -> {
-                    try {
-                        if (gen != decodeGeneration.get()) {
-                            return;
-                        }
-                        String fetchUrl = satelliteUrlWithQueryApiKey(url, apiKey);
-                        Request.Builder reqBuilder =
-                                new Request.Builder().url(fetchUrl).header("x-api-key", apiKey);
-                        if (bundleId != null && !bundleId.isEmpty()) {
-                            reqBuilder.header("x-app-identifier", bundleId);
-                        }
-                        // Match WeatherFrameProcessorModule + AguaceroCore grid fetch (CloudFront allowlists on RN).
-                        if (gridRequestSiteOrigin != null && !gridRequestSiteOrigin.isEmpty()) {
-                            reqBuilder.header("Origin", gridRequestSiteOrigin);
-                            reqBuilder.header("Referer", gridRequestSiteOrigin + "/");
-                        }
-                        Request req = reqBuilder.build();
-                        Call call = HTTP.newCall(req);
-                        try (Response resp = call.execute()) {
-                            if (!resp.isSuccessful() || resp.body() == null) {
-                                Log.w(
-                                        TAG,
-                                        "HTTP "
-                                                + (resp != null ? resp.code() : -1)
-                                                + " for unix="
-                                                + unix);
-                                mainHandler.post(() -> fetchInFlight.remove(unix));
-                                return;
-                            }
-                            ResponseBody body = resp.body();
-                            byte[] ktxBytes = body.bytes();
-                            if (gen != decodeGeneration.get()) {
-                                mainHandler.post(() -> fetchInFlight.remove(unix));
-                                return;
-                            }
-                            byte[] packed = SatelliteKtxDecoder.transcodeKtx2(ktxBytes);
-                            SatelliteKtxDecoder.Parsed parsed = SatelliteKtxDecoder.parsePacked(packed);
-                            if (parsed == null) {
-                                Log.w(TAG, "KTX2 transcode failed unix=" + unix);
-                                mainHandler.post(() -> fetchInFlight.remove(unix));
-                                return;
-                            }
-                            SatelliteMeshBuilder.MeshResult mesh =
-                                    SatelliteMeshBuilder.buildMesh(shaderFileName, parsed.width, parsed.height);
-                            FrameClass fc = classifyShaderFileName(shaderFileName);
-                            SatelliteLayer.PendingGpuUpload pending =
-                                    new SatelliteLayer.PendingGpuUpload(
-                                            unix,
-                                            mesh,
-                                            parsed,
-                                            fc.trueColor,
-                                            fc.colormapKind,
-                                            fc.useColormap);
-
-                            mainHandler.post(
-                                    () -> {
-                                        fetchInFlight.remove(unix);
-                                        if (gen != decodeGeneration.get()) {
-                                            return;
-                                        }
-                                        if (!isLayerAdded) {
-                                            findMapViewAndAddLayer();
-                                        }
-                                        satelliteLayer.queueGpuUpload(pending);
-                                        triggerRepaint();
-                                    });
-                        }
-                    } catch (IOException e) {
-                        Log.e(TAG, "fetch satellite frame unix=" + unix, e);
-                        mainHandler.post(() -> fetchInFlight.remove(unix));
-                    } catch (Exception e) {
-                        Log.e(TAG, "decode satellite frame unix=" + unix, e);
-                        mainHandler.post(() -> fetchInFlight.remove(unix));
-                    }
-                });
-    }
-
-    public void activateSatelliteCachedUnix(long unix) {
-        satelliteLayer.activateCachedUnix(unix);
-        triggerRepaint();
-    }
-
-    public void updateStyleFromJson(@Nullable String json) {
-        if (json == null || json.isEmpty()) return;
-        try {
-            JSONObject o = new JSONObject(json);
-            satelliteLayer.setVisible(o.optBoolean("visible", true));
-            satelliteLayer.setOpacity((float) o.optDouble("opacity", 1.0));
-            satelliteLayer.setFillSmoothing(o.optInt("fillSmoothing", 0));
-            triggerRepaint();
-        } catch (Exception e) {
-            Log.e(TAG, "updateStyleFromJson failed", e);
-        }
-    }
-}
+package com.aguacerowx.reactnative;
+
+import android.app.Activity;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.Log;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.FrameLayout;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.ReactContext;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+import com.facebook.react.uimanager.ThemedReactContext;
+import com.mapbox.maps.LayerPosition;
+import com.mapbox.maps.MapView;
+import com.mapbox.maps.MapboxMap;
+import com.mapbox.maps.Style;
+
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.Locale;
+import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.atomic.AtomicInteger;
+
+import okhttp3.Call;
+import okhttp3.HttpUrl;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+import okhttp3.ResponseBody;
+
+/**
+ * Hosts {@link SatelliteLayer} on the app {@link MapView} (Android satellite path — parity with mapsgl
+ * {@code WeatherLayerManager} + {@code SatelliteShaderManager}).
+ */
+public class SatelliteLayerView extends FrameLayout {
+
+    private static final String TAG = "AguaceroSatelliteView";
+    private static final String DIAG_TAG = "AguaceroRN";
+    private static final String DIAG_EVENT = "AguaceroSatelliteDiagnostic";
+
+    private final ThemedReactContext reactContext;
+    private final SatelliteLayer satelliteLayer;
+    private final String layerId;
+    private MapView mapView;
+    private boolean isLayerAdded = false;
+    private String belowLayerID = null;
+    private volatile boolean debugDiagnostics = false;
+    private volatile long lastTargetUnix = Long.MIN_VALUE;
+    private final java.util.concurrent.atomic.AtomicInteger fetchOkCount =
+            new java.util.concurrent.atomic.AtomicInteger(0);
+    private final java.util.concurrent.atomic.AtomicInteger fetchFailCount =
+            new java.util.concurrent.atomic.AtomicInteger(0);
+
+    /** Concurrent fetch+decode so the priority frame is not blocked behind the rest of the timeline. */
+    private final ExecutorService satDecodeExecutor =
+            Executors.newFixedThreadPool(
+                    4,
+                    r -> {
+                        Thread t = new Thread(r, "aguacero-satellite-decode");
+                        t.setPriority(Thread.NORM_PRIORITY - 1);
+                        return t;
+                    });
+
+    private final Handler mainHandler = new Handler(Looper.getMainLooper());
+    private final AtomicInteger decodeGeneration = new AtomicInteger(0);
+
+    private volatile String lastRunKey = null;
+
+    private final Set<Long> fetchInFlight =
+            Collections.newSetFromMap(new ConcurrentHashMap<Long, Boolean>());
+
+    private static final OkHttpClient HTTP =
+            new OkHttpClient.Builder()
+                    .followRedirects(true)
+                    .followSslRedirects(true)
+                    .build();
+
+    /**
+     * Match grid {@code buildGridFrameProcessOptions}: authoritative {@code apiKey} in the query string
+     * plus {@code x-api-key} header (same pattern as AguaceroCore grid / NEXRAD CDN).
+     */
+    private static String satelliteUrlWithQueryApiKey(String url, String apiKey) {
+        HttpUrl parsed = HttpUrl.parse(url);
+        if (parsed == null) {
+            return url;
+        }
+        HttpUrl.Builder b = parsed.newBuilder();
+        b.setQueryParameter("apiKey", apiKey);
+        if (parsed.queryParameter("userId") == null) {
+            b.setQueryParameter("userId", "sdk-user");
+        }
+        return b.build().toString();
+    }
+
+    public SatelliteLayerView(@NonNull ThemedReactContext context) {
+        super(context);
+        this.reactContext = context;
+        this.satelliteLayer = new SatelliteLayer();
+        this.layerId = AguaceroStyleLayerIds.SATELLITE_CUSTOM_LAYER;
+    }
+
+    private void emitDiagnostic(@NonNull String phase, @Nullable WritableMap extra) {
+        if (!debugDiagnostics) return;
+        try {
+            WritableMap m = Arguments.createMap();
+            m.putString("phase", phase);
+            m.putBoolean("mapLayerAdded", isLayerAdded);
+            m.putBoolean("mapViewFound", mapView != null);
+            if (lastTargetUnix != Long.MIN_VALUE) {
+                m.putDouble("targetUnix", lastTargetUnix);
+            }
+            m.putInt("fetchOkCount", fetchOkCount.get());
+            m.putInt("fetchFailCount", fetchFailCount.get());
+            java.util.HashMap<String, Object> snap = new java.util.HashMap<>();
+            satelliteLayer.fillDebugSnapshot(snap);
+            for (java.util.Map.Entry<String, Object> e : snap.entrySet()) {
+                Object v = e.getValue();
+                if (v == null) continue;
+                String k = e.getKey();
+                if (v instanceof Boolean) m.putBoolean(k, (Boolean) v);
+                else if (v instanceof Integer) m.putInt(k, (Integer) v);
+                else if (v instanceof Long) m.putDouble(k, ((Long) v).doubleValue());
+                else if (v instanceof Float) m.putDouble(k, ((Float) v).doubleValue());
+                else if (v instanceof Double) m.putDouble(k, (Double) v);
+            }
+            if (extra != null) {
+                com.facebook.react.bridge.ReadableMapKeySetIterator it = extra.keySetIterator();
+                while (it.hasNextKey()) {
+                    String key = it.nextKey();
+                    switch (extra.getType(key)) {
+                        case String:
+                            m.putString(key, extra.getString(key));
+                            break;
+                        case Number:
+                            m.putDouble(key, extra.getDouble(key));
+                            break;
+                        case Boolean:
+                            m.putBoolean(key, extra.getBoolean(key));
+                            break;
+                        default:
+                            break;
+                    }
+                }
+            }
+            Log.i(DIAG_TAG, "[satellite.native] " + phase + " " + m.toString());
+            ReactContext ctx = reactContext.getReactApplicationContext();
+            if (ctx != null && ctx.hasActiveReactInstance()) {
+                reactContext.runOnUiQueueThread(
+                        () -> {
+                            try {
+                                ctx.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+                                        .emit(DIAG_EVENT, m);
+                            } catch (Throwable t) {
+                                Log.w(TAG, "emit " + DIAG_EVENT + " failed", t);
+                            }
+                        });
+            }
+        } catch (Throwable t) {
+            Log.w(TAG, "emitDiagnostic failed phase=" + phase, t);
+        }
+    }
+
+    private static void putMapValue(@NonNull WritableMap m, @NonNull String k, @Nullable Object v) {
+        if (v == null) return;
+        if (v instanceof String) m.putString(k, (String) v);
+        else if (v instanceof Integer) m.putInt(k, (Integer) v);
+        else if (v instanceof Long) m.putDouble(k, ((Long) v).doubleValue());
+        else if (v instanceof Boolean) m.putBoolean(k, (Boolean) v);
+        else if (v instanceof Double) m.putDouble(k, (Double) v);
+        else if (v instanceof Float) m.putDouble(k, ((Float) v).doubleValue());
+    }
+
+    /** Alternating keys and values: {@code mapOf("a", 1, "b", true)} */
+    private static WritableMap mapOf(Object... keysAndValues) {
+        WritableMap m = Arguments.createMap();
+        if (keysAndValues == null) return m;
+        for (int i = 0; i + 1 < keysAndValues.length; i += 2) {
+            putMapValue(m, String.valueOf(keysAndValues[i]), keysAndValues[i + 1]);
+        }
+        return m;
+    }
+
+    public void setBelowID(String belowID) {
+        this.belowLayerID = belowID;
+    }
+
+    @Override
+    protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
+        super.onLayout(changed, left, top, right, bottom);
+        findMapViewAndAddLayer();
+    }
+
+    private void findMapViewAndAddLayer() {
+        if (mapView != null) {
+            Style existing = mapView.getMapboxMap().getStyle();
+            if (existing != null && existing.isStyleLoaded() && existing.styleLayerExists(layerId)) {
+                isLayerAdded = true;
+                return;
+            }
+        }
+
+        Activity activity = ((ThemedReactContext) getContext()).getCurrentActivity();
+        if (activity == null) {
+            return;
+        }
+        View rootView = activity.findViewById(android.R.id.content);
+        if (rootView == null) {
+            return;
+        }
+        MapView foundMap = findMapViewRecursive(rootView);
+        if (foundMap == null) {
+            emitDiagnostic("map.viewNotFound", null);
+            return;
+        }
+        this.mapView = foundMap;
+        MapboxMap mapboxMap = mapView.getMapboxMap();
+        Style.OnStyleLoaded styleLoadedCallback =
+                style -> {
+                    if (!style.styleLayerExists(layerId)) {
+                        LayerPosition position = null;
+                        if (style.styleLayerExists(AguaceroStyleLayerIds.WEATHER_GRID_CUSTOM_LAYER)) {
+                            position =
+                                    new LayerPosition(
+                                            AguaceroStyleLayerIds.WEATHER_GRID_CUSTOM_LAYER, null, null);
+                        } else if (this.belowLayerID != null && style.styleLayerExists(this.belowLayerID)) {
+                            position = new LayerPosition(null, this.belowLayerID, null);
+                        }
+                        style.addStyleCustomLayer(layerId, satelliteLayer, position);
+                        isLayerAdded = true;
+                        emitDiagnostic("map.layerAdded", mapOf("layerId", layerId));
+                        triggerRepaint();
+                    }
+                };
+        Style currentStyle = mapboxMap.getStyle();
+        if (currentStyle != null && currentStyle.isStyleLoaded()) {
+            styleLoadedCallback.onStyleLoaded(currentStyle);
+        } else {
+            mapboxMap.getStyle(styleLoadedCallback);
+        }
+    }
+
+    private MapView findMapViewRecursive(View view) {
+        if (view instanceof MapView) return (MapView) view;
+        if (view instanceof ViewGroup) {
+            ViewGroup vg = (ViewGroup) view;
+            for (int i = 0; i < vg.getChildCount(); i++) {
+                MapView f = findMapViewRecursive(vg.getChildAt(i));
+                if (f != null) return f;
+            }
+        }
+        return null;
+    }
+
+    private void triggerRepaint() {
+        if (mapView != null) mapView.post(mapView.getMapboxMap()::triggerRepaint);
+    }
+
+    static final class FrameClass {
+        final boolean trueColor;
+        @NonNull final String colormapKind;
+        final boolean useColormap;
+
+        FrameClass(boolean trueColor, @NonNull String colormapKind, boolean useColormap) {
+            this.trueColor = trueColor;
+            this.colormapKind = colormapKind;
+            this.useColormap = useColormap;
+        }
+    }
+
+    static FrameClass classifyShaderFileName(@Nullable String shaderFileName) {
+        String fn = shaderFileName != null ? shaderFileName : "";
+        boolean isTrueColor =
+                fn.contains("_truecolor_")
+                        || fn.contains("_geocolor_")
+                        || fn.contains("_firetemperature_")
+                        || fn.contains("_dust_")
+                        || fn.contains("_simplewatervapor_")
+                        || fn.contains("_ntmicro_")
+                        || fn.contains("_daycloudphase_")
+                        || fn.contains("_daylandcloudfire_")
+                        || fn.contains("_airmass_")
+                        || fn.contains("_sandwich_");
+
+        String colormapType = "none";
+        if (fn.contains("C13") || fn.contains("C14") || fn.contains("C15") || fn.contains("C16")) {
+            colormapType = "ir";
+        } else if (fn.contains("C08") || fn.contains("C09") || fn.contains("C10")) {
+            colormapType = "wv";
+        }
+
+        boolean useColormap = !isTrueColor && !"none".equals(colormapType);
+        return new FrameClass(isTrueColor, colormapType, useColormap);
+    }
+
+    public void clearSatellite() {
+        decodeGeneration.incrementAndGet();
+        fetchInFlight.clear();
+        satelliteLayer.clearAll();
+        triggerRepaint();
+    }
+
+    /**
+     * Full sync from JS: run key, optional style, target unix, and frame descriptors (small strings —
+     * no image bytes on the bridge).
+     */
+    public void syncFromJson(@Nullable String json) {
+        if (json == null || json.isEmpty()) return;
+        try {
+            JSONObject o = new JSONObject(json);
+            debugDiagnostics = o.optBoolean("debug", false);
+            SatelliteLayer.setDebugLogging(debugDiagnostics);
+
+            String runKey = o.optString("runKey", "");
+            if (!runKey.isEmpty() && !runKey.equals(lastRunKey)) {
+                lastRunKey = runKey;
+                decodeGeneration.incrementAndGet();
+                fetchInFlight.clear();
+                satelliteLayer.clearAll();
+            }
+
+            boolean visible = o.optBoolean("visible", true);
+            float opacity = (float) o.optDouble("opacity", 1.0);
+            int fillSmoothing = o.optInt("fillSmoothing", 0);
+            satelliteLayer.setVisible(visible);
+            satelliteLayer.setOpacity(opacity);
+            satelliteLayer.setFillSmoothing(fillSmoothing);
+
+            long targetUnix = Long.MIN_VALUE;
+            if (o.has("targetUnix") && !o.isNull("targetUnix")) {
+                targetUnix = o.getLong("targetUnix");
+            }
+            if (targetUnix != Long.MIN_VALUE) {
+                lastTargetUnix = targetUnix;
+                satelliteLayer.setActiveUnix(targetUnix);
+            }
+
+            String apiKey = o.optString("apiKey", "");
+            String bundleId = o.optString("bundleId", "");
+            String gridSiteOrigin = o.optString("gridRequestSiteOrigin", "").trim();
+            while (gridSiteOrigin.endsWith("/")) {
+                gridSiteOrigin = gridSiteOrigin.substring(0, gridSiteOrigin.length() - 1);
+            }
+            JSONArray frames = o.optJSONArray("frames");
+            if (frames == null || apiKey.isEmpty()) {
+                WritableMap err = Arguments.createMap();
+                err.putBoolean("apiKeyEmpty", apiKey.isEmpty());
+                err.putBoolean("framesMissing", frames == null);
+                emitDiagnostic("sync.aborted", err);
+                triggerRepaint();
+                return;
+            }
+
+            WritableMap syncInfo = Arguments.createMap();
+            syncInfo.putString("runKey", runKey);
+            syncInfo.putInt("frameCount", frames.length());
+            syncInfo.putBoolean("visible", visible);
+            syncInfo.putDouble("opacity", opacity);
+            syncInfo.putBoolean("apiKeyPresent", !apiKey.isEmpty());
+            syncInfo.putBoolean("bundleIdPresent", bundleId != null && !bundleId.isEmpty());
+            syncInfo.putString("gridRequestSiteOrigin", gridSiteOrigin);
+            if (targetUnix != Long.MIN_VALUE) syncInfo.putDouble("targetUnix", targetUnix);
+            emitDiagnostic("sync.received", syncInfo);
+
+            final int gen = decodeGeneration.get();
+            for (int i = 0; i < frames.length(); i++) {
+                JSONObject f = frames.getJSONObject(i);
+                long unix = f.getLong("unix");
+                String url = f.getString("url");
+                String shaderFileName = f.optString("shaderFileName", "");
+                scheduleFetchIfNeeded(gen, unix, url, shaderFileName, apiKey, bundleId, gridSiteOrigin);
+            }
+            triggerRepaint();
+            if (debugDiagnostics) {
+                mainHandler.postDelayed(() -> emitDiagnostic("render.poll", null), 2500);
+                mainHandler.postDelayed(() -> emitDiagnostic("render.poll", null), 6000);
+            }
+        } catch (Exception e) {
+            Log.e(TAG, "syncFromJson failed", e);
+            WritableMap err = Arguments.createMap();
+            err.putString("error", e.getMessage() != null ? e.getMessage() : e.toString());
+            emitDiagnostic("sync.error", err);
+        }
+    }
+
+    private void scheduleFetchIfNeeded(
+            int gen,
+            long unix,
+            @NonNull String url,
+            @NonNull String shaderFileName,
+            @NonNull String apiKey,
+            @NonNull String bundleId,
+            @NonNull String gridRequestSiteOrigin) {
+        if (satelliteLayer.isFrameCached(unix)) {
+            return;
+        }
+        if (!fetchInFlight.add(unix)) {
+            return;
+        }
+
+        satDecodeExecutor.execute(
+                () -> {
+                    try {
+                        if (gen != decodeGeneration.get()) {
+                            return;
+                        }
+                        String fetchUrl = satelliteUrlWithQueryApiKey(url, apiKey);
+                        Request.Builder reqBuilder =
+                                new Request.Builder().url(fetchUrl).header("x-api-key", apiKey);
+                        if (bundleId != null && !bundleId.isEmpty()) {
+                            reqBuilder.header("x-app-identifier", bundleId);
+                        }
+                        // Match WeatherFrameProcessorModule + AguaceroCore grid fetch (CloudFront allowlists on RN).
+                        String gridOrigin = gridRequestSiteOrigin;
+                        if (gridOrigin == null || gridOrigin.trim().isEmpty()) {
+                            gridOrigin = "https://localhost";
+                        }
+                        gridOrigin = gridOrigin.trim();
+                        while (gridOrigin.endsWith("/")) {
+                            gridOrigin = gridOrigin.substring(0, gridOrigin.length() - 1);
+                        }
+                        if (!gridOrigin.isEmpty()) {
+                            reqBuilder.header("Origin", gridOrigin);
+                            reqBuilder.header("Referer", gridOrigin + "/");
+                        }
+                        Request req = reqBuilder.build();
+                        Call call = HTTP.newCall(req);
+                        try (Response resp = call.execute()) {
+                            if (!resp.isSuccessful() || resp.body() == null) {
+                                int code = resp != null ? resp.code() : -1;
+                                fetchFailCount.incrementAndGet();
+                                Log.w(
+                                        TAG,
+                                        "Satellite frame fetch failed HTTP "
+                                                + code
+                                                + " unix="
+                                                + unix
+                                                + (code == 403
+                                                        ? " — check apiKey, gridRequestSiteOrigin (Origin/Referer), and x-app-identifier bundle allowlist"
+                                                        : ""));
+                                WritableMap fail = Arguments.createMap();
+                                fail.putDouble("unix", unix);
+                                fail.putInt("httpCode", code);
+                                mainHandler.post(
+                                        () -> {
+                                            fetchInFlight.remove(unix);
+                                            emitDiagnostic("fetch.fail", fail);
+                                        });
+                                return;
+                            }
+                            ResponseBody body = resp.body();
+                            byte[] ktxBytes = body.bytes();
+                            fetchOkCount.incrementAndGet();
+                            if (gen != decodeGeneration.get()) {
+                                mainHandler.post(() -> fetchInFlight.remove(unix));
+                                return;
+                            }
+                            byte[] packed = SatelliteKtxDecoder.transcodeKtx2(ktxBytes);
+                            SatelliteKtxDecoder.Parsed parsed = SatelliteKtxDecoder.parsePacked(packed);
+                            if (parsed == null) {
+                                Log.w(TAG, "KTX2 transcode failed unix=" + unix);
+                                WritableMap tf = Arguments.createMap();
+                                tf.putDouble("unix", unix);
+                                tf.putInt("ktxBytes", ktxBytes.length);
+                                mainHandler.post(
+                                        () -> {
+                                            fetchInFlight.remove(unix);
+                                            emitDiagnostic("transcode.fail", tf);
+                                        });
+                                return;
+                            }
+                            WritableMap ok = Arguments.createMap();
+                            ok.putDouble("unix", unix);
+                            ok.putInt("httpBytes", ktxBytes.length);
+                            ok.putInt("basisFormatOrdinal", parsed.basisFormatOrdinal);
+                            ok.putInt("width", parsed.width);
+                            ok.putInt("height", parsed.height);
+                            ok.putString("shaderFileName", shaderFileName);
+                            if (parsed.basisFormatOrdinal
+                                    == SatelliteKtxDecoder.TF_ASTC_LDR_4x4_RGBA) {
+                                ok.putString(
+                                        "astcWarning",
+                                        "ASTC selected — black footprint if GPU cannot sample ASTC; prefer ETC2-first SDK build");
+                            }
+                            SatelliteMeshBuilder.MeshResult mesh =
+                                    SatelliteMeshBuilder.buildMesh(shaderFileName, parsed.width, parsed.height);
+                            FrameClass fc = classifyShaderFileName(shaderFileName);
+                            SatelliteLayer.PendingGpuUpload pending =
+                                    new SatelliteLayer.PendingGpuUpload(
+                                            unix,
+                                            mesh,
+                                            parsed,
+                                            fc.trueColor,
+                                            fc.colormapKind,
+                                            fc.useColormap);
+
+                            mainHandler.post(
+                                    () -> {
+                                        fetchInFlight.remove(unix);
+                                        if (gen != decodeGeneration.get()) {
+                                            return;
+                                        }
+                                        if (!isLayerAdded) {
+                                            findMapViewAndAddLayer();
+                                        }
+                                        satelliteLayer.queueGpuUpload(pending);
+                                        emitDiagnostic("fetch.ok", ok);
+                                        triggerRepaint();
+                                        if (lastTargetUnix == unix || fetchOkCount.get() == 1) {
+                                            emitDiagnostic("gpu.queued", ok);
+                                        }
+                                    });
+                        }
+                    } catch (IOException e) {
+                        Log.e(TAG, "fetch satellite frame unix=" + unix, e);
+                        mainHandler.post(() -> fetchInFlight.remove(unix));
+                    } catch (Exception e) {
+                        Log.e(TAG, "decode satellite frame unix=" + unix, e);
+                        mainHandler.post(() -> fetchInFlight.remove(unix));
+                    }
+                });
+    }
+
+    public void activateSatelliteCachedUnix(long unix) {
+        lastTargetUnix = unix;
+        satelliteLayer.activateCachedUnix(unix);
+        emitDiagnostic(
+                "scrub.activate",
+                mapOf("unix", unix, "wasCached", satelliteLayer.isFrameCached(unix)));
+        triggerRepaint();
+    }
+
+    public void updateStyleFromJson(@Nullable String json) {
+        if (json == null || json.isEmpty()) return;
+        try {
+            JSONObject o = new JSONObject(json);
+            satelliteLayer.setVisible(o.optBoolean("visible", true));
+            satelliteLayer.setOpacity((float) o.optDouble("opacity", 1.0));
+            satelliteLayer.setFillSmoothing(o.optInt("fillSmoothing", 0));
+            triggerRepaint();
+        } catch (Exception e) {
+            Log.e(TAG, "updateStyleFromJson failed", e);
+        }
+    }
+}