@aguacerowx/react-native 0.0.49 → 0.0.51

package/lib/module/aguaceroCoreDebugHooks.js

@@ -0,0 +1,136 @@
+/**
+ * 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
+    });
+  }
+}
+//# sourceMappingURL=aguaceroCoreDebugHooks.js.map

package/lib/module/aguaceroCoreDebugHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["aguaceroDebug","aguaceroDebugWarn","getAguaceroAuthDiagnosticSnapshot","isAguaceroRnDebugEnabled","redactApiKeyFromUrl","HOOK_FLAG","installAguaceroCoreDebugHooks","core","extra","initialize","__aguaceroOrigInitialize","bind","aguaceroDebugInitialize","options","stateMode","isMRMS","state","isSatellite","isNexrad","model","variable","hasModelStatus","Boolean","modelStatus","hasMrmsStatus","mrmsStatus","hasSatelliteListing","satelliteListing","mrmsVariableCount","Object","keys","length","err","message","String","_loadGridData","__aguaceroOrigLoadGridData","aguaceroDebugLoadGridData","tag","mrmsTimestamp","forecastHour","auth","result","hint","hasData","data","encodingKeys","encoding","refreshNexradTimes","__aguaceroOrigRefreshNexradTimes","aguaceroDebugRefreshNexradTimes","site","nexradSite","product","nexradProduct","dataSource","nexradDataSource","out","timesCount","unixTimes","setState","__aguaceroOrigSetState","aguaceroDebugSetState","patch","modeChange","apiKey","undefined","logProcessFrameAuthMismatch","context","mismatches","push","bundleId","optOrigin","gridRequestSiteOrigin","coreOrigin","processFrameUrl","url"],"sourceRoot":"..\\..\\src","sources":["aguaceroCoreDebugHooks.js"],"mappings":"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","ignoreList":[]}

package/lib/module/aguaceroRnDebug.js

@@ -0,0 +1,334 @@
+/**
+ * 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).
+ * API keys are never printed in full — only length, fingerprint, and whitespace hints.
+ */
+
+import { Platform } from 'react-native';
+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 — many CloudFront rules require Origin + Referer'
+    },
+    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 (!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
+  });
+}
+//# sourceMappingURL=aguaceroRnDebug.js.map

package/lib/module/aguaceroRnDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","LOG_PREFIX","_explicitEnabled","_fetchLoggerInstalled","_fetchSeq","AGUACERO_URL_MARKERS","setAguaceroRnDebugEnabled","enabled","configureAguaceroRnDebug","Boolean","opts","on","isAguaceroRnDebugEnabled","globalThis","__AGUACERO_DEBUG__","__AGUACERO_WX_GRID_DEBUG__","__AGUACERO_NEXRAD_DEBUG__","installGlobalFetchLogger","aguaceroDebug","platform","OS","explicitFlag","globalFlag","safeGlobalDebugFlag","__DEV__","describeSecret","secret","present","length","s","String","trimmed","trim","trimmedLength","hasLeadingWhitespace","test","hasTrailingWhitespace","hasInternalWhitespace","indexOf","fingerprint","fingerprintSecret","looksLikePlaceholder","slice","redactApiKeyFromUrl","u","replace","shouldLogAguaceroUrl","url","lower","toLowerCase","some","m","includes","tag","detail","undefined","console","warn","aguaceroDebugWarn","getAguaceroAuthDiagnosticSnapshot","core","extra","apiKey","bundleId","origin","gridRequestSiteOrigin","isReactNative","baseGridUrl","value","hint","willSendAppIdentifier","willSendOriginHeaders","augmentProcessFrameOptionsForDebug","options","out","debug","hasApiKeyInQuery","coreSnapshot","summarizeFetchRequest","input","init","headers","Headers","headerRecord","forEach","v","k","lk","method","hasApiKeyQuery","fetch","originalFetch","bind","aguaceroInstrumentedFetch","shouldLog","reqId","started","Date","now","response","elapsedMs","base","status","statusText","ok","bodySnippet","clone","text","hint403","err","message"],"sourceRoot":"..\\..\\src","sources":["aguaceroRnDebug.js"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,6 @@
 export { MapManager } from './MapManager';
 export { WeatherLayerManager } from './WeatherLayerManager';
+export { configureAguaceroRnDebug, setAguaceroRnDebugEnabled, isAguaceroRnDebugEnabled, getAguaceroAuthDiagnosticSnapshot, aguaceroDebug, aguaceroDebugWarn } from './aguaceroRnDebug';
 export { default as GridRenderLayer } from './GridRenderLayerNativeComponent';
 export { AGUACERO_NEXRAD_MAP_LAYER_ID, AGUACERO_SATELLITE_MAP_LAYER_ID } from './nws/nwsAndroidConstants';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["MapManager","WeatherLayerManager","default","GridRenderLayer","AGUACERO_NEXRAD_MAP_LAYER_ID","AGUACERO_SATELLITE_MAP_LAYER_ID"],"sourceRoot":"..\\..\\src","sources":["index.js"],"mappings":"AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,mBAAmB,QAAQ,uBAAuB;AAC3D,SAASC,OAAO,IAAIC,eAAe,QAAQ,kCAAkC;AAC7E,SACEC,4BAA4B,EAC5BC,+BAA+B,QAC1B,2BAA2B","ignoreList":[]}
+{"version":3,"names":["MapManager","WeatherLayerManager","configureAguaceroRnDebug","setAguaceroRnDebugEnabled","isAguaceroRnDebugEnabled","getAguaceroAuthDiagnosticSnapshot","aguaceroDebug","aguaceroDebugWarn","default","GridRenderLayer","AGUACERO_NEXRAD_MAP_LAYER_ID","AGUACERO_SATELLITE_MAP_LAYER_ID"],"sourceRoot":"..\\..\\src","sources":["index.js"],"mappings":"AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,mBAAmB,QAAQ,uBAAuB;AAC3D,SACIC,wBAAwB,EACxBC,yBAAyB,EACzBC,wBAAwB,EACxBC,iCAAiC,EACjCC,aAAa,EACbC,iBAAiB,QACd,mBAAmB;AAC1B,SAASC,OAAO,IAAIC,eAAe,QAAQ,kCAAkC;AAC7E,SACEC,4BAA4B,EAC5BC,+BAA+B,QAC1B,2BAA2B","ignoreList":[]}

package/lib/module/nexrad/nexradAndroidController.js

@@ -10,6 +10,7 @@ import { sampleNexradFrameAtLatLon } from './nexradCrossSectionSampleAtLatLon.bu
 import { buildNexradLutRgba } from './nexradLutBuild.js';
 import { Platform } from 'react-native';
 import { nexradDiagBootSnapshot, nexradDiagGateTextureSummary, nexradPerfSpan } from './nexradDiag.js';
+import { aguaceroDebug, getAguaceroAuthDiagnosticSnapshot, isAguaceroRnDebugEnabled } from '../aguaceroRnDebug';
 nexradDiagBootSnapshot({
   archiveExports: {
     setNexradArchiveApiKey: typeof setNexradArchiveApiKey,
@@ -213,6 +214,11 @@ export class NexradAndroidController {
       setNexradSitesFetchAuth(core.apiKey || '', core.bundleId || '');
     }
     setNexradArchiveSiteOrigin(core.gridRequestSiteOrigin || '');
+    if (isAguaceroRnDebugEnabled()) {
+      aguaceroDebug('nexrad.authConfigured', getAguaceroAuthDiagnosticSnapshot(core, {
+        phase: 'NexradAndroidController.constructor'
+      }));
+    }
   }
   _trimNativeGpuReadyKeys(max) {
     while (this._nativeGpuReadyKeys.size > max) {
@@ -676,6 +682,13 @@ export class NexradAndroidController {
     setNexradArchiveBundleId(this.core.bundleId || '');
     setNexradArchiveSiteOrigin(this.core.gridRequestSiteOrigin || '');
     setNexradSitesFetchAuth(this.core.apiKey || '', this.core.bundleId || '');
+    if (isAguaceroRnDebugEnabled()) {
+      aguaceroDebug('nexrad.authConfigured', getAguaceroAuthDiagnosticSnapshot(this.core, {
+        phase: 'NexradAndroidController.preload',
+        site: state.nexradSite,
+        product: state.nexradProduct
+      }));
+    }
     const snapshot = {
       ...state
     };