@aguacerowx/react-native 0.0.50 → 0.0.52

package/lib/commonjs/aguaceroRnDebug.js

@@ -0,0 +1,358 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.aguaceroDebug = aguaceroDebug;
+exports.aguaceroDebugWarn = aguaceroDebugWarn;
+exports.augmentProcessFrameOptionsForDebug = augmentProcessFrameOptionsForDebug;
+exports.configureAguaceroRnDebug = configureAguaceroRnDebug;
+exports.describeSecret = describeSecret;
+exports.fingerprintSecret = fingerprintSecret;
+exports.getAguaceroAuthDiagnosticSnapshot = getAguaceroAuthDiagnosticSnapshot;
+exports.installGlobalFetchLogger = installGlobalFetchLogger;
+exports.isAguaceroRnDebugEnabled = isAguaceroRnDebugEnabled;
+exports.redactApiKeyFromUrl = redactApiKeyFromUrl;
+exports.setAguaceroRnDebugEnabled = setAguaceroRnDebugEnabled;
+exports.shouldLogAguaceroUrl = shouldLogAguaceroUrl;
+var _reactNative = require("react-native");
+var _gridCdnAuth = require("./gridCdnAuth");
+/**
+ * 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.
+ */
+
+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
+ */
+function setAguaceroRnDebugEnabled(enabled) {
+  configureAguaceroRnDebug({
+    enabled: Boolean(enabled)
+  });
+}
+
+/**
+ * @param {{ enabled?: boolean }} opts
+ */
+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: _reactNative.Platform.OS,
+      explicitFlag: _explicitEnabled,
+      globalFlag: safeGlobalDebugFlag()
+    });
+  }
+}
+
+/**
+ * True when `debug={true}`, {@link configureAguaceroRnDebug}, or `globalThis.__AGUACERO_DEBUG__ === true`.
+ * @returns {boolean}
+ */
+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>}
+ */
+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}
+ */
+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}
+ */
+function redactApiKeyFromUrl(u) {
+  if (!u || typeof u !== 'string') return String(u);
+  return u.replace(/([?&])apiKey=[^&]*/gi, '$1apiKey=(redacted)');
+}
+
+/**
+ * @param {string} url
+ * @returns {boolean}
+ */
+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
+ */
+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
+ */
+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]
+ */
+function getAguaceroAuthDiagnosticSnapshot(core, extra = {}) {
+  const apiKey = core?.apiKey;
+  const bundleId = core?.bundleId;
+  const origin = core?.gridRequestSiteOrigin;
+  return {
+    platform: _reactNative.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>}
+ */
+function augmentProcessFrameOptionsForDebug(options, core) {
+  const out = {
+    ...options
+  };
+  if (!out.gridRequestSiteOrigin && core) {
+    const origin = (0, _gridCdnAuth.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.
+ */
+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: _reactNative.Platform.OS
+  });
+}
+//# sourceMappingURL=aguaceroRnDebug.js.map

package/lib/commonjs/aguaceroRnDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_gridCdnAuth","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","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","resolveGridRequestSiteOrigin","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/commonjs/gridCdnAuth.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN = void 0;
+exports.readGlobalGridRequestSiteOrigin = readGlobalGridRequestSiteOrigin;
+exports.resolveGridRequestSiteOrigin = resolveGridRequestSiteOrigin;
+/**
+ * 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). */
+const RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN = exports.RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN = 'https://localhost';
+
+/**
+ * @returns {string}
+ */
+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
+ */
+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;
+}
+//# sourceMappingURL=gridCdnAuth.js.map

package/lib/commonjs/gridCdnAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN","exports","readGlobalGridRequestSiteOrigin","g","globalThis","__AGUACERO_GRID_REQUEST_SITE_ORIGIN__","trim","replace","resolveGridRequestSiteOrigin","propOrigin","core","normalize","s","o","String","endsWith","slice","gridRequestSiteOrigin","fromGlobal","isReactNative"],"sourceRoot":"..\\..\\src","sources":["gridCdnAuth.js"],"mappings":";;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACO,MAAMA,mCAAmC,GAAAC,OAAA,CAAAD,mCAAA,GAAG,mBAAmB;;AAEtE;AACA;AACA;AACO,SAASE,+BAA+BA,CAAA,EAAG;EAC9C,IAAI;IACA,MAAMC,CAAC,GAAGC,UAAU,CAACC,qCAAqC;IAC1D,IAAI,OAAOF,CAAC,KAAK,QAAQ,IAAIA,CAAC,CAACG,IAAI,CAAC,CAAC,EAAE;MACnC,OAAOH,CAAC,CAACG,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IACvC;EACJ,CAAC,CAAC,MAAM;IACJ;EAAA;EAEJ,OAAO,EAAE;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,4BAA4BA,CAACC,UAAU,EAAEC,IAAI,EAAE;EAC3D,MAAMC,SAAS,GAAIC,CAAC,IAAK;IACrB,IAAIC,CAAC,GAAGC,MAAM,CAACF,CAAC,CAAC,CAACN,IAAI,CAAC,CAAC;IACxB,OAAOO,CAAC,CAACE,QAAQ,CAAC,GAAG,CAAC,EAAE;MACpBF,CAAC,GAAGA,CAAC,CAACG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB;IACA,OAAOH,CAAC;EACZ,CAAC;EAED,IAAI,OAAOJ,UAAU,KAAK,QAAQ,IAAIA,UAAU,CAACH,IAAI,CAAC,CAAC,EAAE;IACrD,OAAOK,SAAS,CAACF,UAAU,CAAC;EAChC;EACA,IAAI,OAAOC,IAAI,EAAEO,qBAAqB,KAAK,QAAQ,IAAIP,IAAI,CAACO,qBAAqB,CAACX,IAAI,CAAC,CAAC,EAAE;IACtF,OAAOK,SAAS,CAACD,IAAI,CAACO,qBAAqB,CAAC;EAChD;EACA,MAAMC,UAAU,GAAGhB,+BAA+B,CAAC,CAAC;EACpD,IAAIgB,UAAU,EAAE;IACZ,OAAOA,UAAU;EACrB;EACA,IAAIR,IAAI,EAAES,aAAa,EAAE;IACrB,OAAOnB,mCAAmC;EAC9C;EACA,OAAO,IAAI;AACf","ignoreList":[]}

package/lib/commonjs/index.js

@@ -27,14 +27,64 @@ Object.defineProperty(exports, "MapManager", {
     return _MapManager.MapManager;
   }
 });
+Object.defineProperty(exports, "RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN", {
+  enumerable: true,
+  get: function () {
+    return _gridCdnAuth.RN_DEFAULT_GRID_REQUEST_SITE_ORIGIN;
+  }
+});
 Object.defineProperty(exports, "WeatherLayerManager", {
   enumerable: true,
   get: function () {
     return _WeatherLayerManager.WeatherLayerManager;
   }
 });
+Object.defineProperty(exports, "aguaceroDebug", {
+  enumerable: true,
+  get: function () {
+    return _aguaceroRnDebug.aguaceroDebug;
+  }
+});
+Object.defineProperty(exports, "aguaceroDebugWarn", {
+  enumerable: true,
+  get: function () {
+    return _aguaceroRnDebug.aguaceroDebugWarn;
+  }
+});
+Object.defineProperty(exports, "configureAguaceroRnDebug", {
+  enumerable: true,
+  get: function () {
+    return _aguaceroRnDebug.configureAguaceroRnDebug;
+  }
+});
+Object.defineProperty(exports, "getAguaceroAuthDiagnosticSnapshot", {
+  enumerable: true,
+  get: function () {
+    return _aguaceroRnDebug.getAguaceroAuthDiagnosticSnapshot;
+  }
+});
+Object.defineProperty(exports, "isAguaceroRnDebugEnabled", {
+  enumerable: true,
+  get: function () {
+    return _aguaceroRnDebug.isAguaceroRnDebugEnabled;
+  }
+});
+Object.defineProperty(exports, "resolveGridRequestSiteOrigin", {
+  enumerable: true,
+  get: function () {
+    return _gridCdnAuth.resolveGridRequestSiteOrigin;
+  }
+});
+Object.defineProperty(exports, "setAguaceroRnDebugEnabled", {
+  enumerable: true,
+  get: function () {
+    return _aguaceroRnDebug.setAguaceroRnDebugEnabled;
+  }
+});
 var _MapManager = require("./MapManager");
 var _WeatherLayerManager = require("./WeatherLayerManager");
+var _aguaceroRnDebug = require("./aguaceroRnDebug");
+var _gridCdnAuth = require("./gridCdnAuth");
 var _GridRenderLayerNativeComponent = _interopRequireDefault(require("./GridRenderLayerNativeComponent"));
 var _nwsAndroidConstants = require("./nws/nwsAndroidConstants");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_MapManager","require","_WeatherLayerManager","_GridRenderLayerNativeComponent","_interopRequireDefault","_nwsAndroidConstants","e","__esModule","default"],"sourceRoot":"..\\..\\src","sources":["index.js"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,oBAAA,GAAAD,OAAA;AACA,IAAAE,+BAAA,GAAAC,sBAAA,CAAAH,OAAA;AACA,IAAAI,oBAAA,GAAAJ,OAAA;AAGmC,SAAAG,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}
+{"version":3,"names":["_MapManager","require","_WeatherLayerManager","_aguaceroRnDebug","_gridCdnAuth","_GridRenderLayerNativeComponent","_interopRequireDefault","_nwsAndroidConstants","e","__esModule","default"],"sourceRoot":"..\\..\\src","sources":["index.js"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,oBAAA,GAAAD,OAAA;AACA,IAAAE,gBAAA,GAAAF,OAAA;AAQA,IAAAG,YAAA,GAAAH,OAAA;AAIA,IAAAI,+BAAA,GAAAC,sBAAA,CAAAL,OAAA;AACA,IAAAM,oBAAA,GAAAN,OAAA;AAGmC,SAAAK,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/nexrad/nexradAndroidController.js

@@ -13,8 +13,9 @@ var _nexradCrossSectionSampleAtLatLonBundled = require("./nexradCrossSectionSamp
 var _nexradLutBuild = require("./nexradLutBuild.js");
 var _reactNative = require("react-native");
 var _nexradDiag = require("./nexradDiag.js");
-/**
- * AguaceroCore NEXRAD → Android native custom layer (parity with mapsgl {@link NexradWeatherController}).
+var _aguaceroRnDebug = require("../aguaceroRnDebug");
+/**
+ * AguaceroCore NEXRAD → Android native custom layer (parity with mapsgl {@link NexradWeatherController}).
  */
 
 (0, _nexradDiag.nexradDiagBootSnapshot)({
@@ -170,10 +171,10 @@ function rleCompressGateData(gateData) {
   return out.subarray(0, outIdx);
 }
 class NexradAndroidController {
-  /**
-   * @param {*} core - AguaceroCore instance
-   * @param {React.MutableRefObject<{ uploadNexradFrame?: (s: string) => void; uploadNexradStyleOnly?: (s: string) => void; clearNexrad?: () => void; activateNexradCachedFrame?: (k: string) => void } | null>} layerRef
-       * @param {object} [options]
+  /**
+   * @param {*} core - AguaceroCore instance
+   * @param {React.MutableRefObject<{ uploadNexradFrame?: (s: string) => void; uploadNexradStyleOnly?: (s: string) => void; clearNexrad?: () => void; activateNexradCachedFrame?: (k: string) => void } | null>} layerRef
+       * @param {object} [options]
        */
   constructor(core, layerRef, options = {}) {
     this.core = core;
@@ -219,7 +220,12 @@ class NexradAndroidController {
       (0, _radarArchiveCoreBundled.setNexradSitesJsonUrl)(`${base}/data/nexrad.json`);
       (0, _radarArchiveCoreBundled.setNexradSitesFetchAuth)(core.apiKey || '', core.bundleId || '');
     }
-    (0, _radarArchiveCoreBundled.setNexradArchiveSiteOrigin)(core.gridRequestSiteOrigin || '');
+    (0, _radarArchiveCoreBundled.setNexradArchiveSiteOrigin)(core.gridRequestSiteOrigin || 'https://localhost');
+    if ((0, _aguaceroRnDebug.isAguaceroRnDebugEnabled)()) {
+      (0, _aguaceroRnDebug.aguaceroDebug)('nexrad.authConfigured', (0, _aguaceroRnDebug.getAguaceroAuthDiagnosticSnapshot)(core, {
+        phase: 'NexradAndroidController.constructor'
+      }));
+    }
   }
   _trimNativeGpuReadyKeys(max) {
     while (this._nativeGpuReadyKeys.size > max) {
@@ -303,10 +309,10 @@ class NexradAndroidController {
     };
   }
 
-  /**
-   * LRU for full native JSON payloads (parity with mapsgl gate-texture reuse — avoids base64 + stringify on repeat scrubs).
-   * @param {string} syncKey
-   * @returns {{ json: string; valueScale: number; valueOffset: number } | null}
+  /**
+   * LRU for full native JSON payloads (parity with mapsgl gate-texture reuse — avoids base64 + stringify on repeat scrubs).
+   * @param {string} syncKey
+   * @returns {{ json: string; valueScale: number; valueOffset: number } | null}
    */
   _nativeUploadJsonLruTouch(syncKey) {
     const ent = this._nativeUploadJsonLru.get(syncKey);
@@ -327,18 +333,18 @@ class NexradAndroidController {
     }
   }
 
-  /**
-   * Full-frame JSON includes LUT + opacity + shader toggles; keep LRU key aligned so scrubbing
-   * cannot resurrect an outdated style after the user changes only presentation options.
+  /**
+   * Full-frame JSON includes LUT + opacity + shader toggles; keep LRU key aligned so scrubbing
+   * cannot resurrect an outdated style after the user changes only presentation options.
    */
   _nativeUploadLruKey(state, syncKey) {
     return `${syncKey}|o:${state.opacity ?? 1}|g:${this._gateSmoothing ? 1 : 0}|i:${this._interpolateColormap ? 1 : 0}`;
   }
 
-  /**
-   * After JS decoded a frame into `_frameCache`, optionally push it through the native bridge.
-   * During timeline preload we **only** upload the **currently displayed** unix to Metal; other
-   * volumes stay in the JS cache until {@link sync} needs them (avoids 40+ full decodes on load).
+  /**
+   * After JS decoded a frame into `_frameCache`, optionally push it through the native bridge.
+   * During timeline preload we **only** upload the **currently displayed** unix to Metal; other
+   * volumes stay in the JS cache until {@link sync} needs them (avoids 40+ full decodes on load).
    */
   _primeNativeGpuUploadIfNeeded(snapshot, unix, p, frame, abortSignal) {
     if (!frame || !p || abortSignal && abortSignal.aborted) return;
@@ -360,11 +366,11 @@ class NexradAndroidController {
     }
   }
 
-  /**
-   * @param {*} state
-   * @param {*} frame - decoded archive frame
-   * @param {{ fetchKey: string }} p - from {@link _buildFetchParamsForUnix}
-   * @param {number} unix
+  /**
+   * @param {*} state
+   * @param {*} frame - decoded archive frame
+   * @param {{ fetchKey: string }} p - from {@link _buildFetchParamsForUnix}
+   * @param {number} unix
    */
   _uploadFrameToNative(state, frame, p, unix) {
     const uploadTotal = (0, _nexradDiag.nexradPerfSpan)(`uploadFrame.total site=${state.nexradSite} unix=${unix} var=${p?.radarVar ?? state.nexradProduct}`);
@@ -681,8 +687,15 @@ class NexradAndroidController {
 
     (0, _radarArchiveCoreBundled.setNexradArchiveApiKey)(this.core.apiKey || '');
     (0, _radarArchiveCoreBundled.setNexradArchiveBundleId)(this.core.bundleId || '');
-    (0, _radarArchiveCoreBundled.setNexradArchiveSiteOrigin)(this.core.gridRequestSiteOrigin || '');
+    (0, _radarArchiveCoreBundled.setNexradArchiveSiteOrigin)(this.core.gridRequestSiteOrigin || 'https://localhost');
     (0, _radarArchiveCoreBundled.setNexradSitesFetchAuth)(this.core.apiKey || '', this.core.bundleId || '');
+    if ((0, _aguaceroRnDebug.isAguaceroRnDebugEnabled)()) {
+      (0, _aguaceroRnDebug.aguaceroDebug)('nexrad.authConfigured', (0, _aguaceroRnDebug.getAguaceroAuthDiagnosticSnapshot)(this.core, {
+        phase: 'NexradAndroidController.preload',
+        site: state.nexradSite,
+        product: state.nexradProduct
+      }));
+    }
     const snapshot = {
       ...state
     };
@@ -804,7 +817,7 @@ class NexradAndroidController {
     const tAuth = (0, _nexradDiag.nexradPerfSpan)('sync.setArchiveAuth');
     (0, _radarArchiveCoreBundled.setNexradArchiveApiKey)(this.core.apiKey || '');
     (0, _radarArchiveCoreBundled.setNexradArchiveBundleId)(this.core.bundleId || '');
-    (0, _radarArchiveCoreBundled.setNexradArchiveSiteOrigin)(this.core.gridRequestSiteOrigin || '');
+    (0, _radarArchiveCoreBundled.setNexradArchiveSiteOrigin)(this.core.gridRequestSiteOrigin || 'https://localhost');
     (0, _radarArchiveCoreBundled.setNexradSitesFetchAuth)(this.core.apiKey || '', this.core.bundleId || '');
     tAuth.end({});
     const unix = Number(state.nexradTimestamp);