@aguacerowx/react-native 0.0.51 → 0.0.52

package/src/satellite/satelliteAndroidController.js

@@ -1,245 +1,245 @@
-/**
- * AguaceroCore satellite mode → Android native {@link SatelliteLayerView} (parity with mapsgl
- * {@link WeatherLayerManager} satellite paths — preload timeline + scrub via {@code targetUnix}).
- */
-import { resolveSatelliteS3FileName } from '@aguacerowx/javascript-sdk';
-import { satBridgeWarn } from '../satelliteBridgeDiag';
-import { aguaceroDebug, getAguaceroAuthDiagnosticSnapshot, isAguaceroRnDebugEnabled, redactApiKeyFromUrl } from '../aguaceroRnDebug';
-
-/**
- * Target frame first, then remaining frames by increasing temporal distance to {@code targetUnix}.
- * @param {{ unix: number; url: string; shaderFileName: string }[]} frames
- * @param {number | null} targetUnix
- */
-export function sortFramesByTargetProximity(frames, targetUnix) {
-    if (!frames.length) return frames;
-    if (targetUnix == null || !Number.isFinite(targetUnix)) {
-        return frames;
-    }
-    const withDistance = frames.map((f) => ({
-        ...f,
-        _d: Math.abs(f.unix - targetUnix),
-    }));
-    withDistance.sort((a, b) => {
-        if (a._d !== b._d) return a._d - b._d;
-        return a.unix - b.unix;
-    });
-    return withDistance.map(({ _d, ...rest }) => rest);
-}
-
-/**
- * @param {import('@aguacerowx/javascript-sdk').AguaceroCoreState} state
- * @param {number} satelliteTimestamp
- */
-export function buildSatelliteFetchParts(state, satelliteTimestamp) {
-    const fileName = resolveSatelliteS3FileName(
-        state.satelliteChannel,
-        state.satelliteTimeToFileMap,
-        satelliteTimestamp,
-    );
-    if (!fileName) {
-        return null;
-    }
-    const channelName = state.satelliteChannel || state.variable;
-    const channelNameUpper = String(channelName).toUpperCase();
-    let s3FileName = fileName.replace('MULTI', channelNameUpper);
-    if (!s3FileName.endsWith('.ktx2')) {
-        s3FileName += '.ktx2';
-    }
-    let shaderFileName = s3FileName;
-    if (!channelNameUpper.startsWith('C') || channelNameUpper.length > 3) {
-        const token = channelNameUpper.toLowerCase().replace(/_/g, '');
-        shaderFileName = `${s3FileName}_${token}_`;
-    }
-    const apiKey = state.apiKey;
-    if (!apiKey) {
-        return null;
-    }
-    const url = `https://d3dc62msmxkrd7.cloudfront.net/satellite/${s3FileName}?userId=${encodeURIComponent('sdk-user')}&apiKey=${encodeURIComponent(apiKey)}`;
-    return { url, shaderFileName, frameKey: Number(satelliteTimestamp), apiKey };
-}
-
-export class SatelliteAndroidController {
-    /**
-     * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
-     * @param {React.RefObject<{ syncSatellite?: (json: string) => void; clearSatellite?: () => void; activateSatelliteCachedUnix?: (unix: number) => void; updateSatelliteStyle?: (json: string) => void }>} satelliteLayerRef
-     */
-    constructor(core, satelliteLayerRef) {
-        this.core = core;
-        this.satelliteLayerRef = satelliteLayerRef;
-        this._destroyed = false;
-        /** @type {string | undefined} */
-        this._cachedRunKey = undefined;
-        /** @type {string | undefined} */
-        this._cachedTimelineSig = undefined;
-        /** @type {number | null | undefined} */
-        this._lastTargetUnix = undefined;
-        /** @type {string | undefined} */
-        this._lastStyleJson = undefined;
-    }
-
-    destroy() {
-        this._destroyed = true;
-        this._cachedRunKey = undefined;
-        this._cachedTimelineSig = undefined;
-        this._lastTargetUnix = undefined;
-        this._lastStyleJson = undefined;
-        const native = this.satelliteLayerRef?.current;
-        native?.clearSatellite?.();
-    }
-
-    /**
-     * @param {import('@aguacerowx/javascript-sdk').AguaceroCoreState} state
-     */
-    sync(state) {
-        satBridgeWarn('SatelliteAndroidController.sync enter', {
-            destroyed: this._destroyed,
-            isSatellite: Boolean(state?.isSatellite),
-            instrumentId: state?.satelliteInstrumentId ?? null,
-            sector: state?.satelliteSectorLabel ?? null,
-            channel: state?.satelliteChannel ?? null,
-            tlMapSize:
-                state?.satelliteTimeToFileMap && typeof state.satelliteTimeToFileMap === 'object'
-                    ? Object.keys(state.satelliteTimeToFileMap).length
-                    : 0,
-        });
-
-        if (this._destroyed || !state?.isSatellite) {
-            satBridgeWarn('SatelliteAndroidController.sync early-exit', {
-                destroyed: this._destroyed,
-                isSatellite: state?.isSatellite,
-            });
-            return;
-        }
-
-        const native = this.satelliteLayerRef?.current;
-        if (!native?.syncSatellite) {
-            satBridgeWarn('SatelliteAndroidController.sync abort: no native.syncSatellite', {
-                refExists: Boolean(this.satelliteLayerRef?.current),
-                keys: this.satelliteLayerRef?.current ? Object.keys(this.satelliteLayerRef.current) : [],
-            });
-            return;
-        }
-
-        const keys = Object.keys(state.satelliteTimeToFileMap || {}).sort((a, b) => Number(a) - Number(b));
-        const satRunKey = `${state.satelliteInstrumentId}|${state.satelliteSectorLabel}|${state.satelliteChannel}|${state.variable || ''}`;
-        const timelineSig = keys.join(',');
-
-        const mergedState = {
-            ...state,
-            apiKey: state.apiKey || this.core.apiKey,
-        };
-
-        const frames = [];
-        for (const k of keys) {
-            const ts = Number(k);
-            if (!Number.isFinite(ts)) continue;
-            const parts = buildSatelliteFetchParts(mergedState, ts);
-            if (!parts) continue;
-            frames.push({
-                unix: ts,
-                url: parts.url,
-                shaderFileName: parts.shaderFileName,
-            });
-        }
-
-        if (frames.length === 0) {
-            console.warn('[AguaceroWX][satellite][satelliteSyncNoFrames]', {
-                satRunKey,
-                timelineKeyCount: keys.length,
-                hasApiKey: Boolean(mergedState.apiKey),
-                satelliteChannel: mergedState.satelliteChannel,
-                mapKeys:
-                    mergedState.satelliteTimeToFileMap &&
-                    typeof mergedState.satelliteTimeToFileMap === 'object'
-                        ? Object.keys(mergedState.satelliteTimeToFileMap).length
-                        : 0,
-            });
-        }
-
-        let targetUnix =
-            state.satelliteTimestamp == null || state.satelliteTimestamp === undefined
-                ? null
-                : Number(state.satelliteTimestamp);
-
-        // Core often omits satelliteTimestamp on the first satellite emit; without targetUnix the native
-        // layer never promotes uploads to activeUnix until a later activateSatelliteCachedUnix — blank map.
-        if (targetUnix == null || !Number.isFinite(targetUnix)) {
-            const nk = keys.map((k) => Number(k)).filter((n) => Number.isFinite(n));
-            if (nk.length > 0) {
-                targetUnix = Math.max(...nk);
-            }
-        }
-
-        const stylePayload = {
-            visible: state.visible !== false,
-            opacity: state.opacity ?? 1,
-            fillSmoothing: 0,
-        };
-        const styleJson = JSON.stringify(stylePayload);
-
-        const runKeyChanged = satRunKey !== this._cachedRunKey;
-        const timelineChanged = timelineSig !== this._cachedTimelineSig;
-
-        if (runKeyChanged || timelineChanged) {
-            if (isAguaceroRnDebugEnabled()) {
-                aguaceroDebug('satellite.sync.payload', {
-                    auth: getAguaceroAuthDiagnosticSnapshot(this.core),
-                    frameCount: frames.length,
-                    sampleFrameUrl: frames[0] ? redactApiKeyFromUrl(frames[0].url) : null,
-                    gridRequestSiteOrigin: mergedState.gridRequestSiteOrigin ?? this.core.gridRequestSiteOrigin ?? null,
-                });
-            }
-            const sortedFrames = sortFramesByTargetProximity(frames, targetUnix);
-            const payload = {
-                runKey: satRunKey,
-                // Must match query params on each frame URL (same merge as buildSatelliteFetchParts) and mapsgl fetch headers.
-                apiKey: mergedState.apiKey || '',
-                userId: 'sdk-user',
-                // RN has no browser default Origin; native satellite fetch must mirror WeatherFrameProcessor / AguaceroCore grid headers.
-                gridRequestSiteOrigin:
-                    typeof this.core.gridRequestSiteOrigin === 'string' ? this.core.gridRequestSiteOrigin : '',
-                bundleId: this.core.bundleId || '',
-                visible: stylePayload.visible,
-                opacity: stylePayload.opacity,
-                fillSmoothing: stylePayload.fillSmoothing,
-                frames: sortedFrames,
-            };
-            if (targetUnix != null && Number.isFinite(targetUnix)) {
-                payload.targetUnix = targetUnix;
-            }
-
-            const payloadJson = JSON.stringify(payload);
-            native.syncSatellite(payloadJson);
-            satBridgeWarn('SatelliteAndroidController.sync full payload sent', {
-                runKey: satRunKey,
-                timelineChanged,
-                frameCount: sortedFrames.length,
-                targetUnix: payload.targetUnix ?? null,
-                jsonChars: payloadJson.length,
-            });
-            this._cachedRunKey = satRunKey;
-            this._cachedTimelineSig = timelineSig;
-            this._lastTargetUnix = targetUnix != null && Number.isFinite(targetUnix) ? targetUnix : null;
-            this._lastStyleJson = styleJson;
-            return;
-        }
-
-        // Same timeline: avoid large JSON over the bridge — scrub + style deltas only.
-        const finiteTarget =
-            targetUnix != null && Number.isFinite(targetUnix) ? targetUnix : null;
-        if (finiteTarget !== this._lastTargetUnix) {
-            if (finiteTarget != null && native.activateSatelliteCachedUnix) {
-                native.activateSatelliteCachedUnix(finiteTarget);
-                satBridgeWarn('SatelliteAndroidController.activateSatelliteCachedUnix', { unix: finiteTarget });
-            }
-            this._lastTargetUnix = finiteTarget;
-        }
-
-        if (styleJson !== this._lastStyleJson && native.updateSatelliteStyle) {
-            native.updateSatelliteStyle(styleJson);
-            satBridgeWarn('SatelliteAndroidController.updateSatelliteStyle', { jsonChars: styleJson.length });
-            this._lastStyleJson = styleJson;
-        }
-    }
-}
+/**
+ * AguaceroCore satellite mode → Android native {@link SatelliteLayerView} (parity with mapsgl
+ * {@link WeatherLayerManager} satellite paths — preload timeline + scrub via {@code targetUnix}).
+ */
+import { resolveSatelliteS3FileName } from '@aguacerowx/javascript-sdk';
+import { satBridgeWarn } from '../satelliteBridgeDiag';
+import { aguaceroDebug, getAguaceroAuthDiagnosticSnapshot, isAguaceroRnDebugEnabled, redactApiKeyFromUrl } from '../aguaceroRnDebug';
+
+/**
+ * Target frame first, then remaining frames by increasing temporal distance to {@code targetUnix}.
+ * @param {{ unix: number; url: string; shaderFileName: string }[]} frames
+ * @param {number | null} targetUnix
+ */
+export function sortFramesByTargetProximity(frames, targetUnix) {
+    if (!frames.length) return frames;
+    if (targetUnix == null || !Number.isFinite(targetUnix)) {
+        return frames;
+    }
+    const withDistance = frames.map((f) => ({
+        ...f,
+        _d: Math.abs(f.unix - targetUnix),
+    }));
+    withDistance.sort((a, b) => {
+        if (a._d !== b._d) return a._d - b._d;
+        return a.unix - b.unix;
+    });
+    return withDistance.map(({ _d, ...rest }) => rest);
+}
+
+/**
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCoreState} state
+ * @param {number} satelliteTimestamp
+ */
+export function buildSatelliteFetchParts(state, satelliteTimestamp) {
+    const fileName = resolveSatelliteS3FileName(
+        state.satelliteChannel,
+        state.satelliteTimeToFileMap,
+        satelliteTimestamp,
+    );
+    if (!fileName) {
+        return null;
+    }
+    const channelName = state.satelliteChannel || state.variable;
+    const channelNameUpper = String(channelName).toUpperCase();
+    let s3FileName = fileName.replace('MULTI', channelNameUpper);
+    if (!s3FileName.endsWith('.ktx2')) {
+        s3FileName += '.ktx2';
+    }
+    let shaderFileName = s3FileName;
+    if (!channelNameUpper.startsWith('C') || channelNameUpper.length > 3) {
+        const token = channelNameUpper.toLowerCase().replace(/_/g, '');
+        shaderFileName = `${s3FileName}_${token}_`;
+    }
+    const apiKey = state.apiKey;
+    if (!apiKey) {
+        return null;
+    }
+    const url = `https://d3dc62msmxkrd7.cloudfront.net/satellite/${s3FileName}?userId=${encodeURIComponent('sdk-user')}&apiKey=${encodeURIComponent(apiKey)}`;
+    return { url, shaderFileName, frameKey: Number(satelliteTimestamp), apiKey };
+}
+
+export class SatelliteAndroidController {
+    /**
+     * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
+     * @param {React.RefObject<{ syncSatellite?: (json: string) => void; clearSatellite?: () => void; activateSatelliteCachedUnix?: (unix: number) => void; updateSatelliteStyle?: (json: string) => void }>} satelliteLayerRef
+     */
+    constructor(core, satelliteLayerRef) {
+        this.core = core;
+        this.satelliteLayerRef = satelliteLayerRef;
+        this._destroyed = false;
+        /** @type {string | undefined} */
+        this._cachedRunKey = undefined;
+        /** @type {string | undefined} */
+        this._cachedTimelineSig = undefined;
+        /** @type {number | null | undefined} */
+        this._lastTargetUnix = undefined;
+        /** @type {string | undefined} */
+        this._lastStyleJson = undefined;
+    }
+
+    destroy() {
+        this._destroyed = true;
+        this._cachedRunKey = undefined;
+        this._cachedTimelineSig = undefined;
+        this._lastTargetUnix = undefined;
+        this._lastStyleJson = undefined;
+        const native = this.satelliteLayerRef?.current;
+        native?.clearSatellite?.();
+    }
+
+    /**
+     * @param {import('@aguacerowx/javascript-sdk').AguaceroCoreState} state
+     */
+    sync(state) {
+        satBridgeWarn('SatelliteAndroidController.sync enter', {
+            destroyed: this._destroyed,
+            isSatellite: Boolean(state?.isSatellite),
+            instrumentId: state?.satelliteInstrumentId ?? null,
+            sector: state?.satelliteSectorLabel ?? null,
+            channel: state?.satelliteChannel ?? null,
+            tlMapSize:
+                state?.satelliteTimeToFileMap && typeof state.satelliteTimeToFileMap === 'object'
+                    ? Object.keys(state.satelliteTimeToFileMap).length
+                    : 0,
+        });
+
+        if (this._destroyed || !state?.isSatellite) {
+            satBridgeWarn('SatelliteAndroidController.sync early-exit', {
+                destroyed: this._destroyed,
+                isSatellite: state?.isSatellite,
+            });
+            return;
+        }
+
+        const native = this.satelliteLayerRef?.current;
+        if (!native?.syncSatellite) {
+            satBridgeWarn('SatelliteAndroidController.sync abort: no native.syncSatellite', {
+                refExists: Boolean(this.satelliteLayerRef?.current),
+                keys: this.satelliteLayerRef?.current ? Object.keys(this.satelliteLayerRef.current) : [],
+            });
+            return;
+        }
+
+        const keys = Object.keys(state.satelliteTimeToFileMap || {}).sort((a, b) => Number(a) - Number(b));
+        const satRunKey = `${state.satelliteInstrumentId}|${state.satelliteSectorLabel}|${state.satelliteChannel}|${state.variable || ''}`;
+        const timelineSig = keys.join(',');
+
+        const mergedState = {
+            ...state,
+            apiKey: state.apiKey || this.core.apiKey,
+        };
+
+        const frames = [];
+        for (const k of keys) {
+            const ts = Number(k);
+            if (!Number.isFinite(ts)) continue;
+            const parts = buildSatelliteFetchParts(mergedState, ts);
+            if (!parts) continue;
+            frames.push({
+                unix: ts,
+                url: parts.url,
+                shaderFileName: parts.shaderFileName,
+            });
+        }
+
+        if (frames.length === 0) {
+            console.warn('[AguaceroWX][satellite][satelliteSyncNoFrames]', {
+                satRunKey,
+                timelineKeyCount: keys.length,
+                hasApiKey: Boolean(mergedState.apiKey),
+                satelliteChannel: mergedState.satelliteChannel,
+                mapKeys:
+                    mergedState.satelliteTimeToFileMap &&
+                    typeof mergedState.satelliteTimeToFileMap === 'object'
+                        ? Object.keys(mergedState.satelliteTimeToFileMap).length
+                        : 0,
+            });
+        }
+
+        let targetUnix =
+            state.satelliteTimestamp == null || state.satelliteTimestamp === undefined
+                ? null
+                : Number(state.satelliteTimestamp);
+
+        // Core often omits satelliteTimestamp on the first satellite emit; without targetUnix the native
+        // layer never promotes uploads to activeUnix until a later activateSatelliteCachedUnix — blank map.
+        if (targetUnix == null || !Number.isFinite(targetUnix)) {
+            const nk = keys.map((k) => Number(k)).filter((n) => Number.isFinite(n));
+            if (nk.length > 0) {
+                targetUnix = Math.max(...nk);
+            }
+        }
+
+        const stylePayload = {
+            visible: state.visible !== false,
+            opacity: state.opacity ?? 1,
+            fillSmoothing: 0,
+        };
+        const styleJson = JSON.stringify(stylePayload);
+
+        const runKeyChanged = satRunKey !== this._cachedRunKey;
+        const timelineChanged = timelineSig !== this._cachedTimelineSig;
+
+        if (runKeyChanged || timelineChanged) {
+            if (isAguaceroRnDebugEnabled()) {
+                aguaceroDebug('satellite.sync.payload', {
+                    auth: getAguaceroAuthDiagnosticSnapshot(this.core),
+                    frameCount: frames.length,
+                    sampleFrameUrl: frames[0] ? redactApiKeyFromUrl(frames[0].url) : null,
+                    gridRequestSiteOrigin: mergedState.gridRequestSiteOrigin ?? this.core.gridRequestSiteOrigin ?? null,
+                });
+            }
+            const sortedFrames = sortFramesByTargetProximity(frames, targetUnix);
+            const payload = {
+                runKey: satRunKey,
+                // Must match query params on each frame URL (same merge as buildSatelliteFetchParts) and mapsgl fetch headers.
+                apiKey: mergedState.apiKey || '',
+                userId: 'sdk-user',
+                // RN has no browser default Origin; native satellite fetch must mirror WeatherFrameProcessor / AguaceroCore grid headers.
+                gridRequestSiteOrigin:
+                    typeof this.core.gridRequestSiteOrigin === 'string' ? this.core.gridRequestSiteOrigin : '',
+                bundleId: this.core.bundleId || '',
+                visible: stylePayload.visible,
+                opacity: stylePayload.opacity,
+                fillSmoothing: stylePayload.fillSmoothing,
+                frames: sortedFrames,
+            };
+            if (targetUnix != null && Number.isFinite(targetUnix)) {
+                payload.targetUnix = targetUnix;
+            }
+
+            const payloadJson = JSON.stringify(payload);
+            native.syncSatellite(payloadJson);
+            satBridgeWarn('SatelliteAndroidController.sync full payload sent', {
+                runKey: satRunKey,
+                timelineChanged,
+                frameCount: sortedFrames.length,
+                targetUnix: payload.targetUnix ?? null,
+                jsonChars: payloadJson.length,
+            });
+            this._cachedRunKey = satRunKey;
+            this._cachedTimelineSig = timelineSig;
+            this._lastTargetUnix = targetUnix != null && Number.isFinite(targetUnix) ? targetUnix : null;
+            this._lastStyleJson = styleJson;
+            return;
+        }
+
+        // Same timeline: avoid large JSON over the bridge — scrub + style deltas only.
+        const finiteTarget =
+            targetUnix != null && Number.isFinite(targetUnix) ? targetUnix : null;
+        if (finiteTarget !== this._lastTargetUnix) {
+            if (finiteTarget != null && native.activateSatelliteCachedUnix) {
+                native.activateSatelliteCachedUnix(finiteTarget);
+                satBridgeWarn('SatelliteAndroidController.activateSatelliteCachedUnix', { unix: finiteTarget });
+            }
+            this._lastTargetUnix = finiteTarget;
+        }
+
+        if (styleJson !== this._lastStyleJson && native.updateSatelliteStyle) {
+            native.updateSatelliteStyle(styleJson);
+            satBridgeWarn('SatelliteAndroidController.updateSatelliteStyle', { jsonChars: styleJson.length });
+            this._lastStyleJson = styleJson;
+        }
+    }
+}