@aguacerowx/react-native 0.0.53 → 0.0.54

package/src/aguaceroCoreDebugHooks.js

@@ -1,142 +1 @@
-/**
- * Per-core hooks for {@link AguaceroCore} when RN debug is enabled.
- */
-import {
-    aguaceroDebug,
-    aguaceroDebugWarn,
-    getAguaceroAuthDiagnosticSnapshot,
-    isAguaceroRnDebugEnabled,
-    redactApiKeyFromUrl,
-} from './aguaceroRnDebug';
-
-const HOOK_FLAG = '__aguaceroRnDebugHooksInstalled';
-
-/**
- * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
- * @param {Record<string, unknown>} [extra]
- */
-export function installAguaceroCoreDebugHooks(core, extra = {}) {
-    if (!core || !isAguaceroRnDebugEnabled() || core[HOOK_FLAG]) {
-        return;
-    }
-    core[HOOK_FLAG] = true;
-
-    aguaceroDebug('core.created', getAguaceroAuthDiagnosticSnapshot(core, extra));
-
-    if (typeof core.initialize === 'function' && !core.__aguaceroOrigInitialize) {
-        core.__aguaceroOrigInitialize = core.initialize.bind(core);
-        core.initialize = async function aguaceroDebugInitialize(options) {
-            aguaceroDebug('core.initialize.start', {
-                stateMode: {
-                    isMRMS: core.state?.isMRMS,
-                    isSatellite: core.state?.isSatellite,
-                    isNexrad: core.state?.isNexrad,
-                    model: core.state?.model,
-                    variable: core.state?.variable,
-                },
-            });
-            try {
-                await core.__aguaceroOrigInitialize(options);
-                aguaceroDebug('core.initialize.done', {
-                    hasModelStatus: Boolean(core.modelStatus),
-                    hasMrmsStatus: Boolean(core.mrmsStatus),
-                    hasSatelliteListing: Boolean(core.satelliteListing),
-                    mrmsVariableCount: core.mrmsStatus ? Object.keys(core.mrmsStatus).length : 0,
-                });
-            } catch (err) {
-                aguaceroDebugWarn('core.initialize.error', { message: err?.message || String(err) });
-                throw err;
-            }
-        };
-    }
-
-    if (typeof core._loadGridData === 'function' && !core.__aguaceroOrigLoadGridData) {
-        core.__aguaceroOrigLoadGridData = core._loadGridData.bind(core);
-        core._loadGridData = async function aguaceroDebugLoadGridData(state) {
-            const tag = 'core._loadGridData';
-            aguaceroDebug(`${tag}.start`, {
-                isMRMS: state?.isMRMS,
-                model: state?.model,
-                variable: state?.variable,
-                mrmsTimestamp: state?.mrmsTimestamp,
-                forecastHour: state?.forecastHour,
-                auth: getAguaceroAuthDiagnosticSnapshot(core),
-            });
-            const result = await core.__aguaceroOrigLoadGridData(state);
-            if (result == null) {
-                aguaceroDebugWarn(`${tag}.null`, {
-                    hint: 'Grid load returned null — often failed fetch (check fetch.httpError above) or missing apiKey',
-                });
-            } else {
-                aguaceroDebug(`${tag}.ok`, {
-                    hasData: Boolean(result?.data),
-                    encodingKeys: result?.encoding ? Object.keys(result.encoding) : [],
-                });
-            }
-            return result;
-        };
-    }
-
-    if (typeof core.refreshNexradTimes === 'function' && !core.__aguaceroOrigRefreshNexradTimes) {
-        core.__aguaceroOrigRefreshNexradTimes = core.refreshNexradTimes.bind(core);
-        core.refreshNexradTimes = async function aguaceroDebugRefreshNexradTimes() {
-            aguaceroDebug('core.refreshNexradTimes.start', {
-                site: core.state?.nexradSite,
-                product: core.state?.nexradProduct,
-                dataSource: core.state?.nexradDataSource,
-            });
-            try {
-                const out = await core.__aguaceroOrigRefreshNexradTimes();
-                aguaceroDebug('core.refreshNexradTimes.done', {
-                    timesCount: out?.unixTimes?.length ?? 0,
-                });
-                return out;
-            } catch (err) {
-                aguaceroDebugWarn('core.refreshNexradTimes.error', { message: err?.message || String(err) });
-                throw err;
-            }
-        };
-    }
-
-    if (typeof core.setState === 'function' && !core.__aguaceroOrigSetState) {
-        core.__aguaceroOrigSetState = core.setState.bind(core);
-        core.setState = async function aguaceroDebugSetState(patch) {
-            const modeChange =
-                patch &&
-                ('isMRMS' in patch || 'isSatellite' in patch || 'isNexrad' in patch || 'variable' in patch);
-            if (modeChange) {
-                aguaceroDebug('core.setState.modePatch', {
-                    keys: Object.keys(patch || {}),
-                    patch: { ...patch, apiKey: undefined },
-                });
-            }
-            return core.__aguaceroOrigSetState(patch);
-        };
-    }
-}
-
-/**
- * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
- */
-export function logProcessFrameAuthMismatch(core, options, context = {}) {
-    if (!isAguaceroRnDebugEnabled() || !core || !options) return;
-    const mismatches = [];
-    if (options.apiKey && core.apiKey && options.apiKey !== core.apiKey) {
-        mismatches.push('processFrame.apiKey !== core.apiKey');
-    }
-    if (options.bundleId !== undefined && options.bundleId !== core.bundleId) {
-        mismatches.push('processFrame.bundleId !== core.bundleId');
-    }
-    const optOrigin = options.gridRequestSiteOrigin || '';
-    const coreOrigin = core.gridRequestSiteOrigin || '';
-    if (String(optOrigin) !== String(coreOrigin)) {
-        mismatches.push('processFrame.gridRequestSiteOrigin !== core.gridRequestSiteOrigin');
-    }
-    if (mismatches.length > 0) {
-        aguaceroDebugWarn('auth.mismatch', {
-            mismatches,
-            processFrameUrl: redactApiKeyFromUrl(options.url),
-            ...context,
-        });
-    }
-}
+import{aguaceroDebug as s,aguaceroDebugWarn as o,getAguaceroAuthDiagnosticSnapshot as n,isAguaceroRnDebugEnabled as c,redactApiKeyFromUrl as d}from"./aguaceroRnDebug";const u="__aguaceroRnDebugHooksInstalled";export function installAguaceroCoreDebugHooks(a,e={}){!a||!c()||a[u]||(a[u]=!0,s("core.created",n(a,e)),typeof a.initialize=="function"&&!a.__aguaceroOrigInitialize&&(a.__aguaceroOrigInitialize=a.initialize.bind(a),a.initialize=async function(i){s("core.initialize.start",{stateMode:{isMRMS:a.state?.isMRMS,isSatellite:a.state?.isSatellite,isNexrad:a.state?.isNexrad,model:a.state?.model,variable:a.state?.variable}});try{await a.__aguaceroOrigInitialize(i),s("core.initialize.done",{hasModelStatus:!!a.modelStatus,hasMrmsStatus:!!a.mrmsStatus,hasSatelliteListing:!!a.satelliteListing,mrmsVariableCount:a.mrmsStatus?Object.keys(a.mrmsStatus).length:0})}catch(t){throw o("core.initialize.error",{message:t?.message||String(t)}),t}}),typeof a._loadGridData=="function"&&!a.__aguaceroOrigLoadGridData&&(a.__aguaceroOrigLoadGridData=a._loadGridData.bind(a),a._loadGridData=async function(i){const t="core._loadGridData";s(`${t}.start`,{isMRMS:i?.isMRMS,model:i?.model,variable:i?.variable,mrmsTimestamp:i?.mrmsTimestamp,forecastHour:i?.forecastHour,auth:n(a)});const r=await a.__aguaceroOrigLoadGridData(i);return r==null?o(`${t}.null`,{hint:"Grid load returned null \u2014 often failed fetch (check fetch.httpError above) or missing apiKey"}):s(`${t}.ok`,{hasData:!!r?.data,encodingKeys:r?.encoding?Object.keys(r.encoding):[]}),r}),typeof a.setState=="function"&&!a.__aguaceroOrigSetState&&(a.__aguaceroOrigSetState=a.setState.bind(a),a.setState=async function(i){return i&&("isMRMS"in i||"isSatellite"in i||"isNexrad"in i||"variable"in i)&&s("core.setState.modePatch",{keys:Object.keys(i||{}),patch:{...i,apiKey:void 0}}),a.__aguaceroOrigSetState(i)}))}export function logProcessFrameAuthMismatch(a,e,i={}){if(!c()||!a||!e)return;const t=[];e.apiKey&&a.apiKey&&e.apiKey!==a.apiKey&&t.push("processFrame.apiKey !== core.apiKey"),e.bundleId!==void 0&&e.bundleId!==a.bundleId&&t.push("processFrame.bundleId !== core.bundleId");const r=e.gridRequestSiteOrigin||"",l=a.gridRequestSiteOrigin||"";String(r)!==String(l)&&t.push("processFrame.gridRequestSiteOrigin !== core.gridRequestSiteOrigin"),t.length>0&&o("auth.mismatch",{mismatches:t,processFrameUrl:d(e.url),...i})}

package/src/aguaceroRnDebug.js

@@ -1,336 +1 @@
-/**
- * React Native SDK auth / HTTP diagnostics.
- *
- * Enable in your app (pick one):
- *
- * 1. **Recommended** — pass `debug={true}` on {@link WeatherLayerManager}:
- *    ```jsx
- *    <WeatherLayerManager apiKey={key} debug gridRequestSiteOrigin="https://your-allowed-origin.com" />
- *    ```
- *
- * 2. **Global** — before rendering weather (works in release builds):
- *    ```js
- *    import { configureAguaceroRnDebug } from '@aguacerowx/react-native';
- *    configureAguaceroRnDebug({ enabled: true });
- *    ```
- *    or: `globalThis.__AGUACERO_DEBUG__ = true` in your entry file.
- *
- * Logs use the prefix `[AguaceroRN][debug]` (Metro, Xcode, Logcat).
- * Satellite imagery: also filter `[AguaceroRN][satellite]` and native `AguaceroSatelliteDiagnostic` events.
- * API keys are never printed in full — only length, fingerprint, and whitespace hints.
- */
-
-import { Platform } from 'react-native';
-import { resolveGridRequestSiteOrigin } from './gridCdnAuth';
-
-const LOG_PREFIX = '[AguaceroRN][debug]';
-
-/** @type {boolean | null} */
-let _explicitEnabled = null;
-
-let _fetchLoggerInstalled = false;
-let _fetchSeq = 0;
-
-const AGUACERO_URL_MARKERS = [
-    'cloudfront.net',
-    'lambda-url.us-east-2.on.aws',
-    'amazonaws.com',
-    'noaa.gov',
-];
-
-/**
- * @param {boolean} enabled
- */
-export function setAguaceroRnDebugEnabled(enabled) {
-    configureAguaceroRnDebug({ enabled: Boolean(enabled) });
-}
-
-/**
- * @param {{ enabled?: boolean }} opts
- */
-export function configureAguaceroRnDebug(opts = {}) {
-    if (opts && typeof opts.enabled === 'boolean') {
-        _explicitEnabled = opts.enabled;
-    }
-    const on = isAguaceroRnDebugEnabled();
-    try {
-        if (typeof globalThis !== 'undefined') {
-            globalThis.__AGUACERO_DEBUG__ = on;
-            globalThis.__AGUACERO_WX_GRID_DEBUG__ = on;
-            globalThis.__AGUACERO_NEXRAD_DEBUG__ = on;
-        }
-    } catch {
-        /* ignore */
-    }
-    if (on) {
-        installGlobalFetchLogger();
-        aguaceroDebug('debug.enabled', {
-            platform: Platform.OS,
-            explicitFlag: _explicitEnabled,
-            globalFlag: safeGlobalDebugFlag(),
-        });
-    }
-}
-
-/**
- * True when `debug={true}`, {@link configureAguaceroRnDebug}, or `globalThis.__AGUACERO_DEBUG__ === true`.
- * @returns {boolean}
- */
-export function isAguaceroRnDebugEnabled() {
-    if (_explicitEnabled === true) return true;
-    if (_explicitEnabled === false) {
-        try {
-            return typeof globalThis !== 'undefined' && globalThis.__AGUACERO_DEBUG__ === true;
-        } catch {
-            return false;
-        }
-    }
-    try {
-        if (typeof __DEV__ !== 'undefined' && __DEV__) return false;
-    } catch {
-        /* ignore */
-    }
-    try {
-        return typeof globalThis !== 'undefined' && globalThis.__AGUACERO_DEBUG__ === true;
-    } catch {
-        return false;
-    }
-}
-
-function safeGlobalDebugFlag() {
-    try {
-        return typeof globalThis !== 'undefined' ? globalThis.__AGUACERO_DEBUG__ === true : false;
-    } catch {
-        return false;
-    }
-}
-
-/**
- * @param {string | null | undefined} secret
- * @returns {Record<string, unknown>}
- */
-export function describeSecret(secret) {
-    if (secret == null || secret === '') {
-        return { present: false, length: 0 };
-    }
-    const s = String(secret);
-    const trimmed = s.trim();
-    return {
-        present: true,
-        length: s.length,
-        trimmedLength: trimmed.length,
-        hasLeadingWhitespace: s.length > 0 && s !== trimmed && /^\s/.test(s),
-        hasTrailingWhitespace: s.length > 0 && s !== trimmed && /\s$/.test(s),
-        hasInternalWhitespace: /\s/.test(trimmed) && trimmed.indexOf(' ') >= 0,
-        fingerprint: fingerprintSecret(trimmed || s),
-        looksLikePlaceholder: /^(your[-_]?)?api[-_]?key|xxx+|test+$/i.test(trimmed),
-    };
-}
-
-/**
- * @param {string} s
- * @returns {string}
- */
-export function fingerprintSecret(s) {
-    if (!s) return '(empty)';
-    if (s.length <= 8) return `len${s.length}`;
-    return `${s.slice(0, 4)}…${s.slice(-4)} (len=${s.length})`;
-}
-
-/**
- * @param {string} u
- * @returns {string}
- */
-export function redactApiKeyFromUrl(u) {
-    if (!u || typeof u !== 'string') return String(u);
-    return u.replace(/([?&])apiKey=[^&]*/gi, '$1apiKey=(redacted)');
-}
-
-/**
- * @param {string} url
- * @returns {boolean}
- */
-export function shouldLogAguaceroUrl(url) {
-    if (!url || typeof url !== 'string') return false;
-    const lower = url.toLowerCase();
-    return AGUACERO_URL_MARKERS.some((m) => lower.includes(m));
-}
-
-/**
- * @param {string} tag
- * @param {Record<string, unknown> | undefined} detail
- */
-export function aguaceroDebug(tag, detail) {
-    if (!isAguaceroRnDebugEnabled()) return;
-    if (detail !== undefined) {
-        console.warn(`${LOG_PREFIX}[${tag}]`, detail);
-    } else {
-        console.warn(`${LOG_PREFIX}[${tag}]`);
-    }
-}
-
-/**
- * Auth / HTTP failures: logged when debug is on (same prefix).
- * @param {string} tag
- * @param {Record<string, unknown> | undefined} detail
- */
-export function aguaceroDebugWarn(tag, detail) {
-    if (!isAguaceroRnDebugEnabled()) return;
-    if (detail !== undefined) {
-        console.warn(`${LOG_PREFIX}[WARN][${tag}]`, detail);
-    } else {
-        console.warn(`${LOG_PREFIX}[WARN][${tag}]`);
-    }
-}
-
-/**
- * @param {import('@aguacerowx/javascript-sdk').AguaceroCore | { apiKey?: string; bundleId?: string | null; gridRequestSiteOrigin?: string | null; baseGridUrl?: string; isReactNative?: boolean }} core
- * @param {Record<string, unknown>} [extra]
- */
-export function getAguaceroAuthDiagnosticSnapshot(core, extra = {}) {
-    const apiKey = core?.apiKey;
-    const bundleId = core?.bundleId;
-    const origin = core?.gridRequestSiteOrigin;
-    return {
-        platform: Platform.OS,
-        isReactNative: Boolean(core?.isReactNative),
-        baseGridUrl: core?.baseGridUrl ?? null,
-        apiKey: describeSecret(apiKey),
-        bundleId: bundleId
-            ? { present: true, value: String(bundleId), length: String(bundleId).length }
-            : { present: false, hint: 'Install react-native-device-info for x-app-identifier on CDN requests' },
-        gridRequestSiteOrigin: origin
-            ? { present: true, value: String(origin), length: String(origin).length }
-            : {
-                  present: false,
-                  hint: 'Pass gridRequestSiteOrigin on WeatherLayerManager (RN falls back to https://localhost if omitted)',
-              },
-        willSendAppIdentifier: Boolean(bundleId && core?.isReactNative),
-        willSendOriginHeaders: Boolean(origin && String(origin).trim()),
-        ...extra,
-    };
-}
-
-/**
- * @param {Record<string, unknown>} options - {@link buildGridFrameProcessOptions} output
- * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} [core]
- * @returns {Record<string, unknown>}
- */
-export function augmentProcessFrameOptionsForDebug(options, core) {
-    const out = { ...options };
-    if (!out.gridRequestSiteOrigin && core) {
-        const origin = resolveGridRequestSiteOrigin(undefined, core);
-        if (origin) {
-            out.gridRequestSiteOrigin = origin;
-        }
-    }
-    if (!isAguaceroRnDebugEnabled()) {
-        return out;
-    }
-    out.debug = true;
-    aguaceroDebug('processFrame.options', {
-        url: redactApiKeyFromUrl(out.url),
-        hasApiKeyInQuery: typeof out.url === 'string' && /[?&]apiKey=/i.test(out.url),
-        apiKey: describeSecret(out.apiKey),
-        bundleId: out.bundleId ? { present: true, value: String(out.bundleId) } : { present: false },
-        gridRequestSiteOrigin: out.gridRequestSiteOrigin ?? null,
-        coreSnapshot: core ? getAguaceroAuthDiagnosticSnapshot(core) : undefined,
-    });
-    return out;
-}
-
-/**
- * @param {string | Request} input
- * @param {RequestInit | undefined} init
- */
-function summarizeFetchRequest(input, init) {
-    const url = typeof input === 'string' ? input : input?.url;
-    const headers = new Headers(
-        (typeof input !== 'string' && input?.headers) || init?.headers || undefined,
-    );
-    const headerRecord = {};
-    headers.forEach((v, k) => {
-        const lk = k.toLowerCase();
-        if (lk === 'x-api-key' || lk === 'authorization') {
-            headerRecord[k] = describeSecret(v);
-        } else {
-            headerRecord[k] = v;
-        }
-    });
-    return {
-        url: redactApiKeyFromUrl(url || ''),
-        method: init?.method || (typeof input !== 'string' ? input?.method : undefined) || 'GET',
-        headers: headerRecord,
-        hasApiKeyQuery: typeof url === 'string' && /[?&]apiKey=/i.test(url),
-    };
-}
-
-/**
- * Patches `global.fetch` once to log Aguacero CDN / API traffic when debug is enabled.
- */
-export function installGlobalFetchLogger() {
-    if (_fetchLoggerInstalled || !isAguaceroRnDebugEnabled()) return;
-    if (typeof globalThis === 'undefined' || typeof globalThis.fetch !== 'function') return;
-
-    const originalFetch = globalThis.fetch.bind(globalThis);
-    _fetchLoggerInstalled = true;
-
-    globalThis.fetch = async function aguaceroInstrumentedFetch(input, init) {
-        const url = typeof input === 'string' ? input : input?.url;
-        const shouldLog = shouldLogAguaceroUrl(url || '');
-        const reqId = shouldLog ? `f${++_fetchSeq}` : null;
-        const started = Date.now();
-
-        if (shouldLog) {
-            aguaceroDebug('fetch.start', { reqId, ...summarizeFetchRequest(input, init) });
-        }
-
-        try {
-            const response = await originalFetch(input, init);
-            if (shouldLog) {
-                const elapsedMs = Date.now() - started;
-                const base = {
-                    reqId,
-                    status: response.status,
-                    statusText: response.statusText,
-                    ok: response.ok,
-                    elapsedMs,
-                    url: redactApiKeyFromUrl(url || ''),
-                };
-                if (!response.ok) {
-                    let bodySnippet = null;
-                    try {
-                        const clone = response.clone();
-                        const text = await clone.text();
-                        bodySnippet = text.length > 600 ? `${text.slice(0, 600)}…` : text;
-                    } catch {
-                        bodySnippet = '(could not read body)';
-                    }
-                    aguaceroDebugWarn('fetch.httpError', {
-                        ...base,
-                        bodySnippet,
-                        hint403:
-                            response.status === 403
-                                ? '403 usually means: invalid/disabled API key, bundleId not allowlisted (x-app-identifier), or missing/wrong gridRequestSiteOrigin (Origin/Referer). Compare snapshot at core.created / processFrame.options.'
-                                : undefined,
-                    });
-                } else {
-                    aguaceroDebug('fetch.ok', base);
-                }
-            }
-            return response;
-        } catch (err) {
-            if (shouldLog) {
-                aguaceroDebugWarn('fetch.throw', {
-                    reqId,
-                    message: err?.message || String(err),
-                    elapsedMs: Date.now() - started,
-                    url: redactApiKeyFromUrl(url || ''),
-                });
-            }
-            throw err;
-        }
-    };
-
-    aguaceroDebug('fetch.hookInstalled', { platform: Platform.OS });
-}
+import{Platform as p}from"react-native";import{resolveGridRequestSiteOrigin as b}from"./gridCdnAuth";const l="[AguaceroRN][debug]";let u=null,h=!1,_=0;const y=["cloudfront.net","lambda-url.us-east-2.on.aws","amazonaws.com","noaa.gov"];export function setAguaceroRnDebugEnabled(e){configureAguaceroRnDebug({enabled:!!e})}export function configureAguaceroRnDebug(e={}){e&&typeof e.enabled=="boolean"&&(u=e.enabled);const t=isAguaceroRnDebugEnabled();try{typeof globalThis<"u"&&(globalThis.__AGUACERO_DEBUG__=t,globalThis.__AGUACERO_WX_GRID_DEBUG__=t,globalThis.__AGUACERO_NEXRAD_DEBUG__=t,globalThis.__AGUACERO_NEXRAD_PIPELINE__=t)}catch{}t&&(installGlobalFetchLogger(),aguaceroDebug("debug.enabled",{platform:p.OS,explicitFlag:u,globalFlag:m()}))}export function isAguaceroRnDebugEnabled(){if(u===!0)return!0;if(u===!1)try{return typeof globalThis<"u"&&globalThis.__AGUACERO_DEBUG__===!0}catch{return!1}try{if(typeof __DEV__<"u"&&__DEV__)return!1}catch{}try{return typeof globalThis<"u"&&globalThis.__AGUACERO_DEBUG__===!0}catch{return!1}}function m(){try{return typeof globalThis<"u"?globalThis.__AGUACERO_DEBUG__===!0:!1}catch{return!1}}export function describeSecret(e){if(e==null||e==="")return{present:!1,length:0};const t=String(e),n=t.trim();return{present:!0,length:t.length,trimmedLength:n.length,hasLeadingWhitespace:t.length>0&&t!==n&&/^\s/.test(t),hasTrailingWhitespace:t.length>0&&t!==n&&/\s$/.test(t),hasInternalWhitespace:/\s/.test(n)&&n.indexOf(" ")>=0,fingerprint:fingerprintSecret(n||t),looksLikePlaceholder:/^(your[-_]?)?api[-_]?key|xxx+|test+$/i.test(n)}}export function fingerprintSecret(e){return e?e.length<=8?`len${e.length}`:`${e.slice(0,4)}\u2026${e.slice(-4)} (len=${e.length})`:"(empty)"}export function redactApiKeyFromUrl(e){return!e||typeof e!="string"?String(e):e.replace(/([?&])apiKey=[^&]*/gi,"$1apiKey=(redacted)")}export function shouldLogAguaceroUrl(e){if(!e||typeof e!="string")return!1;const t=e.toLowerCase();return y.some(n=>t.includes(n))}export function aguaceroDebug(e,t){isAguaceroRnDebugEnabled()&&(t!==void 0?console.warn(`${l}[${e}]`,t):console.warn(`${l}[${e}]`))}export function aguaceroDebugWarn(e,t){isAguaceroRnDebugEnabled()&&(t!==void 0?console.warn(`${l}[WARN][${e}]`,t):console.warn(`${l}[WARN][${e}]`))}export function getAguaceroAuthDiagnosticSnapshot(e,t={}){const n=e?.apiKey,o=e?.bundleId,r=e?.gridRequestSiteOrigin;return{platform:p.OS,isReactNative:!!e?.isReactNative,baseGridUrl:e?.baseGridUrl??null,apiKey:describeSecret(n),bundleId:o?{present:!0,value:String(o),length:String(o).length}:{present:!1,hint:"Install react-native-device-info for x-app-identifier on CDN requests"},gridRequestSiteOrigin:r?{present:!0,value:String(r),length:String(r).length}:{present:!1,hint:"Pass gridRequestSiteOrigin on WeatherLayerManager (RN falls back to https://localhost if omitted)"},willSendAppIdentifier:!!(o&&e?.isReactNative),willSendOriginHeaders:!!(r&&String(r).trim()),...t}}export function augmentProcessFrameOptionsForDebug(e,t){const n={...e};if(!n.gridRequestSiteOrigin&&t){const o=b(void 0,t);o&&(n.gridRequestSiteOrigin=o)}return isAguaceroRnDebugEnabled()&&(n.debug=!0,aguaceroDebug("processFrame.options",{url:redactApiKeyFromUrl(n.url),hasApiKeyInQuery:typeof n.url=="string"&&/[?&]apiKey=/i.test(n.url),apiKey:describeSecret(n.apiKey),bundleId:n.bundleId?{present:!0,value:String(n.bundleId)}:{present:!1},gridRequestSiteOrigin:n.gridRequestSiteOrigin??null,coreSnapshot:t?getAguaceroAuthDiagnosticSnapshot(t):void 0})),n}function A(e,t){const n=typeof e=="string"?e:e?.url,o=new Headers(typeof e!="string"&&e?.headers||t?.headers||void 0),r={};return o.forEach((a,s)=>{const i=s.toLowerCase();i==="x-api-key"||i==="authorization"?r[s]=describeSecret(a):r[s]=a}),{url:redactApiKeyFromUrl(n||""),method:t?.method||(typeof e!="string"?e?.method:void 0)||"GET",headers:r,hasApiKeyQuery:typeof n=="string"&&/[?&]apiKey=/i.test(n)}}export function installGlobalFetchLogger(){if(h||!isAguaceroRnDebugEnabled()||typeof globalThis>"u"||typeof globalThis.fetch!="function")return;const e=globalThis.fetch.bind(globalThis);h=!0,globalThis.fetch=async function(t,n){const o=typeof t=="string"?t:t?.url,r=shouldLogAguaceroUrl(o||""),a=r?`f${++_}`:null,s=Date.now();r&&aguaceroDebug("fetch.start",{reqId:a,...A(t,n)});try{const i=await e(t,n);if(r){const f=Date.now()-s,d={reqId:a,status:i.status,statusText:i.statusText,ok:i.ok,elapsedMs:f,url:redactApiKeyFromUrl(o||"")};if(i.ok)aguaceroDebug("fetch.ok",d);else{let g=null;try{const c=await i.clone().text();g=c.length>600?`${c.slice(0,600)}\u2026`:c}catch{g="(could not read body)"}aguaceroDebugWarn("fetch.httpError",{...d,bodySnippet:g,hint403:i.status===403?"403 usually means: invalid/disabled API key, bundleId not allowlisted (x-app-identifier), or missing/wrong gridRequestSiteOrigin (Origin/Referer). Compare snapshot at core.created / processFrame.options.":void 0})}}return i}catch(i){throw r&&aguaceroDebugWarn("fetch.throw",{reqId:a,message:i?.message||String(i),elapsedMs:Date.now()-s,url:redactApiKeyFromUrl(o||"")}),i}},aguaceroDebug("fetch.hookInstalled",{platform:p.OS})}

package/src/cdnAuthenticatedFetch.js

@@ -0,0 +1 @@
+import{NativeModules as O,Platform as h}from"react-native";import{toByteArray as R}from"base64-js";import{buildNativeCloudFrontFetchOptions as q,RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN as F}from"./gridCdnAuth";import{aguaceroDebug as w,isAguaceroRnDebugEnabled as v,redactApiKeyFromUrl as K}from"./aguaceroRnDebug";const s="[Aguacero][NEXRAD][fetch]";function I(e){if(!e)return{};if(typeof Headers<"u"&&e instanceof Headers){const r={};return e.forEach((d,c)=>{r[c]=d}),r}return{...e}}function A(e){const r=R(e||"");return r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength)}export function nexradNativeCloudFrontFetchUnavailableReason(){if(h.OS!=="android"&&h.OS!=="ios")return`platform=${h.OS}`;const e=O.WeatherFrameProcessorModule;return e?typeof e.fetchCloudFront!="function"?"fetchCloudFront not on native module \u2014 rebuild native app after SDK update":null:"WeatherFrameProcessorModule missing \u2014 rebuild native app"}export function createNexradCloudFrontFetch(e){const r=nexradNativeCloudFrontFetchUnavailableReason();if(r)return console.warn(`${s} native unavailable: ${r}`),null;const d=O.WeatherFrameProcessorModule;return console.warn(`${s} using native OkHttp/URLSession for level-2 CloudFront`),async function(c,L={}){const b=I(L.headers),g=b.Range||b.range||null,p=e()||{},t=q({url:c,apiKey:p.apiKey,bundleId:p.bundleId,gridRequestSiteOrigin:p.gridRequestSiteOrigin,range:g||void 0});v()&&w("nexrad.fetchCloudFront.request",{url:K(t.url),range:g||"(none)",apiKeyLen:t.apiKey.length,bundleId:t.bundleId||"(none)",gridRequestSiteOrigin:t.gridRequestSiteOrigin,hint:"Same native auth as processFrame / satellite: x-api-key + ?apiKey= + Origin; x-app-identifier only if bundleId set"}),t.apiKey||console.warn(`${s} apiKey is empty \u2014 CloudFront will 403. Pass apiKey on WeatherLayerManager (same as models/satellite).`);const i=await d.fetchCloudFront({...t,debug:v()}),a=Number(i?.status)||0;if(console.warn(`${s} response`,{status:a,range:g||"(none)",transport:"native",bodyBytes:i?.bodyBase64?Math.floor(i.bodyBase64.length*3/4):0}),a===403){let n="";try{const u=R(i?.bodyBase64||"");let l="";for(let y=0;y<u.length;y++)l+=String.fromCharCode(u[y]);n=l.length>200?`${l.slice(0,200)}\u2026`:l}catch(u){n=`(unreadable: ${u.message})`}const m=typeof n=="string"&&n.includes("<Code>AccessDenied</Code>")&&n.includes("Access Denied"),S=typeof n=="string"&&(n.includes("Access Denied:")||n.includes("Missing API Key"));let o;m?o="CloudFront Lambda auth succeeded; S3 origin denied /level-2-new (fix OAC + bucket policy for that prefix, or object missing). Grids use other paths \u2014 they can work while level-2 fails.":S?o=t.gridRequestSiteOrigin===F?"Lambda rejected request \u2014 pass gridRequestSiteOrigin on WeatherLayerManager.":"Lambda rejected request \u2014 verify apiKey, bundleId allowlist, and gridRequestSiteOrigin.":t.gridRequestSiteOrigin===F?o="Origin is https://localhost \u2014 pass gridRequestSiteOrigin on WeatherLayerManager (same origin as MapsGL / App2).":o="Verify apiKey, bundleId allowlist (com.reactnativeapp), and gridRequestSiteOrigin match CloudFront.",console.warn(`${s} 403`,{hint:o,denialLayer:m?"s3-origin":S?"lambda-edge":"unknown",apiKeyLen:t.apiKey.length,bundleId:t.bundleId||"(none)",gridRequestSiteOrigin:t.gridRequestSiteOrigin,bodySnippet:n})}const f=new Map;i?.contentRange&&f.set("content-range",String(i.contentRange)),i?.contentLength!=null&&i.contentLength!==""&&f.set("content-length",String(i.contentLength));const C=A(i?.bodyBase64||"");return{ok:a>=200&&a<300||a===206,status:a,headers:{get(n){return f.get(String(n).toLowerCase())??null}},arrayBuffer:async()=>C}}}

package/src/dispatchViewManagerCommandCompat.js

@@ -1,100 +1 @@
-import { satBridgeWarn } from './satelliteBridgeDiag';
-
-/**
- * Dispatches native view-manager commands on both the New Architecture (Fabric `HostInstance`)
- * and the legacy Paper renderer (`reactTag` from {@code findNodeHandle}).
- *
- * Codegen views that only used {@code UIManager.dispatchViewManagerCommand(findNodeHandle(...))}
- * silently no-op on Fabric when {@code findNodeHandle} returns null — satellite/NEXRAD/grid
- * commands never reach native.
- *
- * @param {React.RefObject | { current: unknown }} nativeRef
- * @param {string} viewManagerName e.g. `'SatelliteLayer'`
- * @param {string} commandName e.g. `'syncSatellite'` (must match native Commands export)
- * @param {Array<unknown>} args
- * @returns {boolean} true if a dispatch path ran
- */
-export function dispatchViewManagerCommandCompat(nativeRef, viewManagerName, commandName, args) {
-    const node = nativeRef?.current;
-    const nodeDesc =
-        node == null
-            ? 'null'
-            : `${typeof node}${node?.constructor?.name ? ':' + node.constructor.name : ''}`;
-    if (node == null) {
-        satBridgeWarn(`dispatch:${commandName}:abort`, {
-            reason: 'nativeRef.current is null — SatelliteLayer native view never mounted or ref not attached',
-            viewManagerName,
-        });
-        return false;
-    }
-
-    const { UIManager, findNodeHandle } = require('react-native');
-    let cmdId;
-    let commandsKeys = [];
-    try {
-        const cfg = UIManager.getViewManagerConfig(viewManagerName);
-        commandsKeys = cfg?.Commands ? Object.keys(cfg.Commands) : [];
-        cmdId = cfg?.Commands?.[commandName];
-    } catch (e) {
-        cmdId = null;
-        satBridgeWarn(`dispatch:${commandName}:uimanager-error`, { viewManagerName, message: String(e) });
-    }
-
-    satBridgeWarn(`dispatch:${commandName}:try-paper`, {
-        viewManagerName,
-        nodeDesc,
-        cmdId: cmdId ?? 'MISSING',
-        commandsKeys,
-        argsSummary:
-            commandName === 'syncSatellite' && args?.[0]
-                ? `jsonLen=${String(args[0]).length}`
-                : `argsLen=${args?.length ?? 0}`,
-    });
-
-    // Prefer legacy Paper dispatch when we have a react tag — matches Grid/NEXRAD paths that still work on bridge mode.
-    if (cmdId != null) {
-        const tag = findNodeHandle(node);
-        if (tag != null) {
-            try {
-                UIManager.dispatchViewManagerCommand(tag, cmdId, args);
-                satBridgeWarn(`dispatch:${commandName}:ok-paper`, { reactTag: tag, cmdId });
-                return true;
-            } catch (e) {
-                satBridgeWarn(`dispatch:${commandName}:paper-threw`, { message: String(e), reactTag: tag });
-            }
-        } else {
-            satBridgeWarn(`dispatch:${commandName}:paper-skip`, {
-                reason: 'findNodeHandle(node) is null (typical on Fabric — will try RendererProxy.dispatchCommand)',
-            });
-        }
-    } else {
-        satBridgeWarn(`dispatch:${commandName}:no-cmdId`, {
-            reason: 'UIManager has no Commands entry — view manager name mismatch or pod not linked',
-            viewManagerName,
-        });
-    }
-
-    // Fabric / bridgeless: HostInstance + command name (string). Required when findNodeHandle is null.
-    try {
-        const RendererProxy = require('react-native/Libraries/ReactNative/RendererProxy');
-        if (typeof RendererProxy.dispatchCommand === 'function') {
-            RendererProxy.dispatchCommand(node, commandName, args);
-            satBridgeWarn(`dispatch:${commandName}:ok-fabric`, {
-                note: 'dispatched via RendererProxy.dispatchCommand(string name)',
-            });
-            return true;
-        }
-        satBridgeWarn(`dispatch:${commandName}:no-rendererProxy`, {
-            reason: 'RendererProxy.dispatchCommand missing',
-        });
-    } catch (e) {
-        satBridgeWarn(`dispatch:${commandName}:fabric-threw`, { message: String(e) });
-    }
-
-    satBridgeWarn(`dispatch:${commandName}:FAILED`, {
-        viewManagerName,
-        nodeDesc,
-        hadCmdId: cmdId != null,
-    });
-    return false;
-}
+import{satBridgeWarn as n}from"./satelliteBridgeDiag";export function dispatchViewManagerCommandCompat(m,i,a,s){const r=m?.current,o=r==null?"null":`${typeof r}${r?.constructor?.name?":"+r.constructor.name:""}`;if(r==null)return n(`dispatch:${a}:abort`,{reason:"nativeRef.current is null \u2014 SatelliteLayer native view never mounted or ref not attached",viewManagerName:i}),!1;const{UIManager:c,findNodeHandle:p}=require("react-native");let t,d=[];try{const e=c.getViewManagerConfig(i);d=e?.Commands?Object.keys(e.Commands):[],t=e?.Commands?.[a]}catch(e){t=null,n(`dispatch:${a}:uimanager-error`,{viewManagerName:i,message:String(e)})}if(n(`dispatch:${a}:try-paper`,{viewManagerName:i,nodeDesc:o,cmdId:t??"MISSING",commandsKeys:d,argsSummary:a==="syncSatellite"&&s?.[0]?`jsonLen=${String(s[0]).length}`:`argsLen=${s?.length??0}`}),t!=null){const e=p(r);if(e!=null)try{return c.dispatchViewManagerCommand(e,t,s),n(`dispatch:${a}:ok-paper`,{reactTag:e,cmdId:t}),!0}catch(l){n(`dispatch:${a}:paper-threw`,{message:String(l),reactTag:e})}else n(`dispatch:${a}:paper-skip`,{reason:"findNodeHandle(node) is null (typical on Fabric \u2014 will try RendererProxy.dispatchCommand)"})}else n(`dispatch:${a}:no-cmdId`,{reason:"UIManager has no Commands entry \u2014 view manager name mismatch or pod not linked",viewManagerName:i});try{const e=require("react-native/Libraries/ReactNative/RendererProxy");if(typeof e.dispatchCommand=="function")return e.dispatchCommand(r,a,s),n(`dispatch:${a}:ok-fabric`,{note:"dispatched via RendererProxy.dispatchCommand(string name)"}),!0;n(`dispatch:${a}:no-rendererProxy`,{reason:"RendererProxy.dispatchCommand missing"})}catch(e){n(`dispatch:${a}:fabric-threw`,{message:String(e)})}return n(`dispatch:${a}:FAILED`,{viewManagerName:i,nodeDesc:o,hadCmdId:t!=null}),!1}

package/src/gridCdnAuth.js

@@ -1,56 +1 @@
-/**
- * CloudFront grid CDN auth helpers for React Native.
- *
- * The CDN returns HTTP 403 when {@code Origin} is missing (even if {@code x-api-key} and
- * {@code apiKey} query are valid). Browsers set Origin automatically; RN native HTTP does not.
- */
-
-/** Fallback when no prop/core/global origin is configured (any origin satisfies the CDN). */
-export const RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN = 'https://localhost';
-
-/**
- * @returns {string}
- */
-export function readGlobalGridRequestSiteOrigin() {
-    try {
-        const g = globalThis.__AGUACERO_GRID_REQUEST_SITE_ORIGIN__;
-        if (typeof g === 'string' && g.trim()) {
-            return g.trim().replace(/\/+$/, '');
-        }
-    } catch {
-        /* ignore */
-    }
-    return '';
-}
-
-/**
- * Resolve the site origin used for {@code Origin} / {@code Referer} on grid CDN requests.
- *
- * @param {string | undefined | null} propOrigin - {@link WeatherLayerManager} `gridRequestSiteOrigin` prop
- * @param {{ gridRequestSiteOrigin?: string | null; isReactNative?: boolean } | null | undefined} core
- * @returns {string | null} Normalized origin without trailing slash, or null on web when unset
- */
-export function resolveGridRequestSiteOrigin(propOrigin, core) {
-    const normalize = (s) => {
-        let o = String(s).trim();
-        while (o.endsWith('/')) {
-            o = o.slice(0, -1);
-        }
-        return o;
-    };
-
-    if (typeof propOrigin === 'string' && propOrigin.trim()) {
-        return normalize(propOrigin);
-    }
-    if (typeof core?.gridRequestSiteOrigin === 'string' && core.gridRequestSiteOrigin.trim()) {
-        return normalize(core.gridRequestSiteOrigin);
-    }
-    const fromGlobal = readGlobalGridRequestSiteOrigin();
-    if (fromGlobal) {
-        return fromGlobal;
-    }
-    if (core?.isReactNative) {
-        return RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN;
-    }
-    return null;
-}
+export const RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN="https://localhost";export function readGlobalGridRequestSiteOrigin(){try{const t=globalThis.__AGUACERO_GRID_REQUEST_SITE_ORIGIN__;if(typeof t=="string"&&t.trim())return t.trim().replace(/\/+$/,"")}catch{}return""}export function resolveGridRequestSiteOrigin(t,e){const i=n=>{let r=String(n).trim();for(;r.endsWith("/");)r=r.slice(0,-1);return r};return typeof t=="string"&&t.trim()?i(t):typeof e?.gridRequestSiteOrigin=="string"&&e.gridRequestSiteOrigin.trim()?i(e.gridRequestSiteOrigin):readGlobalGridRequestSiteOrigin()||(e?.isReactNative?RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN:null)}export function normalizeCdnApiKey(t){return typeof t=="string"?t.trim():""}export function ensureApiKeyInUrl(t,e){const i=normalizeCdnApiKey(e);if(!i||/[?&]apiKey=/i.test(t))return t;const n=t.includes("?")?"&":"?";return`${t}${n}apiKey=${encodeURIComponent(i)}`}export function buildNativeCloudFrontFetchOptions({url:t,apiKey:e,bundleId:i,gridRequestSiteOrigin:n,core:r,range:o}){const u=normalizeCdnApiKey(e),c=resolveGridRequestSiteOrigin(n,r)||RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN,s={url:ensureApiKeyInUrl(t,u),apiKey:u,bundleId:i?String(i):"",gridRequestSiteOrigin:c};return o&&(s.range=o),s}