@aguacerowx/react-native 0.0.49 → 0.0.51

package/lib/module/satellite/satelliteAndroidController.js

@@ -4,6 +4,7 @@
  */
 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}.
@@ -163,6 +164,14 @@ export class SatelliteAndroidController {
     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,

package/lib/module/satellite/satelliteAndroidController.js.map

@@ -1 +1 @@
-{"version":3,"names":["resolveSatelliteS3FileName","satBridgeWarn","sortFramesByTargetProximity","frames","targetUnix","length","Number","isFinite","withDistance","map","f","_d","Math","abs","unix","sort","a","b","rest","buildSatelliteFetchParts","state","satelliteTimestamp","fileName","satelliteChannel","satelliteTimeToFileMap","channelName","variable","channelNameUpper","String","toUpperCase","s3FileName","replace","endsWith","shaderFileName","startsWith","token","toLowerCase","apiKey","url","encodeURIComponent","frameKey","SatelliteAndroidController","constructor","core","satelliteLayerRef","_destroyed","_cachedRunKey","undefined","_cachedTimelineSig","_lastTargetUnix","_lastStyleJson","destroy","native","current","clearSatellite","sync","destroyed","isSatellite","Boolean","instrumentId","satelliteInstrumentId","sector","satelliteSectorLabel","channel","tlMapSize","Object","keys","syncSatellite","refExists","satRunKey","timelineSig","join","mergedState","k","ts","parts","push","console","warn","timelineKeyCount","hasApiKey","mapKeys","nk","filter","n","max","stylePayload","visible","opacity","fillSmoothing","styleJson","JSON","stringify","runKeyChanged","timelineChanged","sortedFrames","payload","runKey","userId","gridRequestSiteOrigin","bundleId","payloadJson","frameCount","jsonChars","finiteTarget","activateSatelliteCachedUnix","updateSatelliteStyle"],"sourceRoot":"..\\..\\..\\src","sources":["satellite/satelliteAndroidController.js"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["resolveSatelliteS3FileName","satBridgeWarn","aguaceroDebug","getAguaceroAuthDiagnosticSnapshot","isAguaceroRnDebugEnabled","redactApiKeyFromUrl","sortFramesByTargetProximity","frames","targetUnix","length","Number","isFinite","withDistance","map","f","_d","Math","abs","unix","sort","a","b","rest","buildSatelliteFetchParts","state","satelliteTimestamp","fileName","satelliteChannel","satelliteTimeToFileMap","channelName","variable","channelNameUpper","String","toUpperCase","s3FileName","replace","endsWith","shaderFileName","startsWith","token","toLowerCase","apiKey","url","encodeURIComponent","frameKey","SatelliteAndroidController","constructor","core","satelliteLayerRef","_destroyed","_cachedRunKey","undefined","_cachedTimelineSig","_lastTargetUnix","_lastStyleJson","destroy","native","current","clearSatellite","sync","destroyed","isSatellite","Boolean","instrumentId","satelliteInstrumentId","sector","satelliteSectorLabel","channel","tlMapSize","Object","keys","syncSatellite","refExists","satRunKey","timelineSig","join","mergedState","k","ts","parts","push","console","warn","timelineKeyCount","hasApiKey","mapKeys","nk","filter","n","max","stylePayload","visible","opacity","fillSmoothing","styleJson","JSON","stringify","runKeyChanged","timelineChanged","auth","frameCount","sampleFrameUrl","gridRequestSiteOrigin","sortedFrames","payload","runKey","userId","bundleId","payloadJson","jsonChars","finiteTarget","activateSatelliteCachedUnix","updateSatelliteStyle"],"sourceRoot":"..\\..\\..\\src","sources":["satellite/satelliteAndroidController.js"],"mappings":"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","ignoreList":[]}

package/lib/typescript/WeatherLayerManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WeatherLayerManager.d.ts","sourceRoot":"","sources":["../../src/WeatherLayerManager.js"],"names":[],"mappings":"AAkQA,sCAipDG"}
+{"version":3,"file":"WeatherLayerManager.d.ts","sourceRoot":"","sources":["../../src/WeatherLayerManager.js"],"names":[],"mappings":"AA2QA,sCAisDG"}

package/lib/typescript/aguaceroCoreDebugHooks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
+ * @param {Record<string, unknown>} [extra]
+ */
+export function installAguaceroCoreDebugHooks(core: any, extra?: Record<string, unknown>): void;
+/**
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
+ */
+export function logProcessFrameAuthMismatch(core: any, options: any, context?: {}): void;
+//# sourceMappingURL=aguaceroCoreDebugHooks.d.ts.map

package/lib/typescript/aguaceroCoreDebugHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aguaceroCoreDebugHooks.d.ts","sourceRoot":"","sources":["../../src/aguaceroCoreDebugHooks.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH,iEAFW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAoGjC;AAED;;GAEG;AACH,yFAqBC"}

package/lib/typescript/aguaceroRnDebug.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @param {boolean} enabled
+ */
+export function setAguaceroRnDebugEnabled(enabled: boolean): void;
+/**
+ * @param {{ enabled?: boolean }} opts
+ */
+export function configureAguaceroRnDebug(opts?: {
+    enabled?: boolean;
+}): void;
+/**
+ * True when `debug={true}`, {@link configureAguaceroRnDebug}, or `globalThis.__AGUACERO_DEBUG__ === true`.
+ * @returns {boolean}
+ */
+export function isAguaceroRnDebugEnabled(): boolean;
+/**
+ * @param {string | null | undefined} secret
+ * @returns {Record<string, unknown>}
+ */
+export function describeSecret(secret: string | null | undefined): Record<string, unknown>;
+/**
+ * @param {string} s
+ * @returns {string}
+ */
+export function fingerprintSecret(s: string): string;
+/**
+ * @param {string} u
+ * @returns {string}
+ */
+export function redactApiKeyFromUrl(u: string): string;
+/**
+ * @param {string} url
+ * @returns {boolean}
+ */
+export function shouldLogAguaceroUrl(url: string): boolean;
+/**
+ * @param {string} tag
+ * @param {Record<string, unknown> | undefined} detail
+ */
+export function aguaceroDebug(tag: string, detail: Record<string, unknown> | undefined): void;
+/**
+ * Auth / HTTP failures: logged when debug is on (same prefix).
+ * @param {string} tag
+ * @param {Record<string, unknown> | undefined} detail
+ */
+export function aguaceroDebugWarn(tag: string, detail: Record<string, unknown> | undefined): void;
+/**
+ * @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: any | {
+    apiKey?: string;
+    bundleId?: string | null;
+    gridRequestSiteOrigin?: string | null;
+    baseGridUrl?: string;
+    isReactNative?: boolean;
+}, extra?: Record<string, unknown>): {
+    platform: "ios" | "android" | "windows" | "macos" | "web";
+    isReactNative: boolean;
+    baseGridUrl: any;
+    apiKey: Record<string, unknown>;
+    bundleId: {
+        present: boolean;
+        value: string;
+        length: number;
+        hint?: undefined;
+    } | {
+        present: boolean;
+        hint: string;
+        value?: undefined;
+        length?: undefined;
+    };
+    gridRequestSiteOrigin: {
+        present: boolean;
+        value: string;
+        length: number;
+        hint?: undefined;
+    } | {
+        present: boolean;
+        hint: string;
+        value?: undefined;
+        length?: undefined;
+    };
+    willSendAppIdentifier: boolean;
+    willSendOriginHeaders: boolean;
+};
+/**
+ * @param {Record<string, unknown>} options - {@link buildGridFrameProcessOptions} output
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} [core]
+ * @returns {Record<string, unknown>}
+ */
+export function augmentProcessFrameOptionsForDebug(options: Record<string, unknown>, core?: any): Record<string, unknown>;
+/**
+ * Patches `global.fetch` once to log Aguacero CDN / API traffic when debug is enabled.
+ */
+export function installGlobalFetchLogger(): void;
+//# sourceMappingURL=aguaceroRnDebug.d.ts.map

package/lib/typescript/aguaceroRnDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aguaceroRnDebug.d.ts","sourceRoot":"","sources":["../../src/aguaceroRnDebug.js"],"names":[],"mappings":"AAsCA;;GAEG;AACH,mDAFW,OAAO,QAIjB;AAED;;GAEG;AACH,gDAFW;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,QAwB/B;AAED;;;GAGG;AACH,4CAFa,OAAO,CAqBnB;AAUD;;;GAGG;AACH,uCAHW,MAAM,GAAG,IAAI,GAAG,SAAS,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBnC;AAED;;;GAGG;AACH,qCAHW,MAAM,GACJ,MAAM,CAMlB;AAED;;;GAGG;AACH,uCAHW,MAAM,GACJ,MAAM,CAKlB;AAED;;;GAGG;AACH,0CAHW,MAAM,GACJ,OAAO,CAMnB;AAED;;;GAGG;AACH,mCAHW,MAAM,UACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,QAS7C;AAED;;;;GAIG;AACH,uCAHW,MAAM,UACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,QAS7C;AAED;;;GAGG;AACH,wDAHW,GAAiD,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,UACvL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBjC;AAED;;;;GAIG;AACH,4DAJW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAErB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBnC;AA4BD;;GAEG;AACH,iDAiEC"}

package/lib/typescript/index.d.ts

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

package/lib/typescript/nexrad/nexradAndroidController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexradAndroidController.d.ts","sourceRoot":"","sources":["../../../src/nexrad/nexradAndroidController.js"],"names":[],"mappings":"AAmNA;IACA;;;;WAIO;IACH,kBAJO,GAAC,YACD,KAAK,CAAC,gBAAgB,CAAC;QAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,YAC9L,MAAM,EA6ChB;IA1CG,UAAgB;IAChB;4BALgD,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI;gCAA0B,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI;sBAAgB,MAAM,IAAI;oCAA8B,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI;cAKlK;IACzB,kBAAwB;IACxB,+BAAkB;IAClB,8BAAuE;IACvE,wBAA0D;IAC1D,2BAA4B;IAC5B,kHAAkH;IAClH,uCAAoC;IACpC,sCAAyB;IACzB,yBAA+B;IAC/B,8BAAiC;IACjC,iEAAiE;IACjE,iBADW;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAClC;IAC3B,qFAAqF;IACrF,sBADW,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAC5C;IACrC,oHAAoH;IACpH,qBADW,GAAG,CAAC,MAAM,CAAC,CACc;IACpC,uEAAuE;IACvE,sBADW,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAC9B;IACrC,4CAA4C;IAC5C,mBADW;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CACX;IAuBjC,wCAMC;IAED,qFAOC;IAED,uCAOC;IAED,gBAqBC;IAED,2DAgBC;IAED,eAEC;IAED;;;;;MAuBC;IAED;;;;OAIG;IACH,mCAHW,MAAM,GACJ;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAQ5E;IAED,uGAAuG;IACvG,iCADY,MAAM,SAAkB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,QAS5F;IAED;;;OAGG;IACH,sDAEC;IAED;;;;OAIG;IACH,oGAqBC;IAED;;;;;OAKG;IACH,4BALW,GAAC,SACD,GAAC,KACD;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,QACpB,MAAM,QAgIhB;IAED,sCAwCC;IAED;;;;;MAUC;IAED;;;;;;;;aAkBC;IAED;;;qBAgCC;IAED,8CAYC;IAED,qDAMC;IAED,sCA0JC;IAED,gCA0HC;IAED;;;;;;;;;;;;;;;aAwGC;CACJ"}
+{"version":3,"file":"nexradAndroidController.d.ts","sourceRoot":"","sources":["../../../src/nexrad/nexradAndroidController.js"],"names":[],"mappings":"AAoNA;IACA;;;;WAIO;IACH,kBAJO,GAAC,YACD,KAAK,CAAC,gBAAgB,CAAC;QAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,YAC9L,MAAM,EAgDhB;IA7CG,UAAgB;IAChB;4BALgD,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI;gCAA0B,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI;sBAAgB,MAAM,IAAI;oCAA8B,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI;cAKlK;IACzB,kBAAwB;IACxB,+BAAkB;IAClB,8BAAuE;IACvE,wBAA0D;IAC1D,2BAA4B;IAC5B,kHAAkH;IAClH,uCAAoC;IACpC,sCAAyB;IACzB,yBAA+B;IAC/B,8BAAiC;IACjC,iEAAiE;IACjE,iBADW;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAClC;IAC3B,qFAAqF;IACrF,sBADW,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAC5C;IACrC,oHAAoH;IACpH,qBADW,GAAG,CAAC,MAAM,CAAC,CACc;IACpC,uEAAuE;IACvE,sBADW,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAC9B;IACrC,4CAA4C;IAC5C,mBADW;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CACX;IA0BjC,wCAMC;IAED,qFAOC;IAED,uCAOC;IAED,gBAqBC;IAED,2DAgBC;IAED,eAEC;IAED;;;;;MAuBC;IAED;;;;OAIG;IACH,mCAHW,MAAM,GACJ;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAQ5E;IAED,uGAAuG;IACvG,iCADY,MAAM,SAAkB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,QAS5F;IAED;;;OAGG;IACH,sDAEC;IAED;;;;OAIG;IACH,oGAqBC;IAED;;;;;OAKG;IACH,4BALW,GAAC,SACD,GAAC,KACD;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,QACpB,MAAM,QAgIhB;IAED,sCAwCC;IAED;;;;;MAUC;IAED;;;;;;;;aAkBC;IAED;;;qBAgCC;IAED,8CAYC;IAED,qDAMC;IAED,sCAgKC;IAED,gCA0HC;IAED;;;;;;;;;;;;;;;aAwGC;CACJ"}

package/lib/typescript/nexrad/nexradDiag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexradDiag.d.ts","sourceRoot":"","sources":["../../../src/nexrad/nexradDiag.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAEC;AAED;;;;GAIG;AACH,qCAHW,MAAM,WACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAiBjC;AAED,0DAOC;AAED;;;GAGG;AACH,sCAHW,MAAM,GACJ;IAAE,SAAS,EAAE,MAAM,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;CAAE,CAuB1F;AAED;;GAEG;AACH,+CAFW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAWjC;AAED;;;;;;;;GAQG;AACH,uDARW,UAAU,UACV,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,UACN,MAAM,UACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDhB"}
+{"version":3,"file":"nexradDiag.d.ts","sourceRoot":"","sources":["../../../src/nexrad/nexradDiag.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAQC;AAED;;;;GAIG;AACH,qCAHW,MAAM,WACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAiBjC;AAED,0DAOC;AAED;;;GAGG;AACH,sCAHW,MAAM,GACJ;IAAE,SAAS,EAAE,MAAM,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;CAAE,CAuB1F;AAED;;GAEG;AACH,+CAFW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAWjC;AAED;;;;;;;;GAQG;AACH,uDARW,UAAU,UACV,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,UACN,MAAM,UACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDhB"}

package/lib/typescript/nexrad/radarArchiveCore.bundled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radarArchiveCore.bundled.d.ts","sourceRoot":"","sources":["../../../src/nexrad/radarArchiveCore.bundled.js"],"names":[],"mappings":"AA6rNA,+IAwNC;AAlyCD,0EAKC;AA1ID,qDAEC;AACD,8DAEC;AACD,8DAGC;AA94BD,0EAKC;AAVD,sDAEC"}
+{"version":3,"file":"radarArchiveCore.bundled.d.ts","sourceRoot":"","sources":["../../../src/nexrad/radarArchiveCore.bundled.js"],"names":[],"mappings":"AA8rNA,+IAwNC;AAlyCD,0EAKC;AA1ID,qDAEC;AACD,8DAEC;AACD,8DAGC;AA94BD,0EAKC;AAVD,sDAEC"}

package/lib/typescript/satellite/satelliteAndroidController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"satelliteAndroidController.d.ts","sourceRoot":"","sources":["../../../src/satellite/satelliteAndroidController.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,oDAHW;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,cACvD,MAAM,GAAG,IAAI;UADL,MAAM;SAAO,MAAM;oBAAkB,MAAM;IAiB7D;AAED;;;GAGG;AACH,yEAFW,MAAM;;;;;SA4BhB;AAED;IACI;;;OAGG;IACH,0CAFW,KAAK,CAAC,SAAS,CAAC;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC,EAcvM;IAXG,UAAgB;IAChB;wBAJyC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;yBAAmB,MAAM,IAAI;sCAAgC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;+BAAyB,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;OAIvJ;IAC1C,oBAAuB;IACvB,iCAAiC;IACjC,eADW,MAAM,GAAG,SAAS,CACC;IAC9B,iCAAiC;IACjC,oBADW,MAAM,GAAG,SAAS,CACM;IACnC,wCAAwC;IACxC,iBADW,MAAM,GAAG,IAAI,GAAG,SAAS,CACJ;IAChC,iCAAiC;IACjC,gBADW,MAAM,GAAG,SAAS,CACE;IAGnC,gBAQC;IAED;;OAEG;IACH,uBA8IC;CACJ"}
+{"version":3,"file":"satelliteAndroidController.d.ts","sourceRoot":"","sources":["../../../src/satellite/satelliteAndroidController.js"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,oDAHW;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,cACvD,MAAM,GAAG,IAAI;UADL,MAAM;SAAO,MAAM;oBAAkB,MAAM;IAiB7D;AAED;;;GAGG;AACH,yEAFW,MAAM;;;;;SA4BhB;AAED;IACI;;;OAGG;IACH,0CAFW,KAAK,CAAC,SAAS,CAAC;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC,EAcvM;IAXG,UAAgB;IAChB;wBAJyC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;yBAAmB,MAAM,IAAI;sCAAgC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;+BAAyB,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;OAIvJ;IAC1C,oBAAuB;IACvB,iCAAiC;IACjC,eADW,MAAM,GAAG,SAAS,CACC;IAC9B,iCAAiC;IACjC,oBADW,MAAM,GAAG,SAAS,CACM;IACnC,wCAAwC;IACxC,iBADW,MAAM,GAAG,IAAI,GAAG,SAAS,CACJ;IAChC,iCAAiC;IACjC,gBADW,MAAM,GAAG,SAAS,CACE;IAGnC,gBAQC;IAED;;OAEG;IACH,uBAsJC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aguacerowx/react-native",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "description": "Native weather rendering for React Native",
   "license": "ISC",
   "author": "Michael Barletta",
@@ -46,7 +46,7 @@
     "react-native-device-info": ">=10.0.0"
   },
   "dependencies": {
-    "@aguacerowx/javascript-sdk": "^0.0.27",
+    "@aguacerowx/javascript-sdk": "^0.0.29",
     "base64-js": "^1.5.1"
   },
   "react-native-builder-bob": {

package/src/WeatherLayerManager.js

@@ -20,6 +20,14 @@ import { SatelliteAndroidController } from './satellite/satelliteAndroidControll
 import NwsAlertsOverlay from './nws/NwsAlertsOverlay';
 import { mapRegistry } from './MapRegistry';
 import { satBridgeWarn } from './satelliteBridgeDiag';
+import {
+    augmentProcessFrameOptionsForDebug,
+    aguaceroDebugWarn,
+    configureAguaceroRnDebug,
+    getAguaceroAuthDiagnosticSnapshot,
+    isAguaceroRnDebugEnabled,
+} from './aguaceroRnDebug';
+import { installAguaceroCoreDebugHooks, logProcessFrameAuthMismatch } from './aguaceroCoreDebugHooks';
 
 const NEXRAD_NATIVE = Platform.OS === 'android' || Platform.OS === 'ios';
 const SATELLITE_NATIVE = Platform.OS === 'android' || Platform.OS === 'ios';
@@ -154,8 +162,9 @@ function satelliteObsTimelineSig(state) {
     return `${keys.length}:${keys[0]}:${keys[keys.length - 1]}`;
 }
 
-/** True in __DEV__, or set `globalThis.__AGUACERO_WX_GRID_DEBUG__ = true` in the app entry for release builds. */
+/** True when {@link WeatherLayerManager} `debug` / {@link configureAguaceroRnDebug}, or legacy `__AGUACERO_WX_GRID_DEBUG__`. */
 function wxGridDebugEnabled() {
+    if (isAguaceroRnDebugEnabled()) return true;
     try {
         if (typeof __DEV__ !== 'undefined' && __DEV__) return true;
         return Boolean(typeof globalThis !== 'undefined' && globalThis.__AGUACERO_WX_GRID_DEBUG__);
@@ -274,8 +283,14 @@ export const WeatherLayerManager = forwardRef((props, ref) => {
         onNwsAlertClick,
         /** Same semantics as mapsgl / AguaceroCore: Origin + Referer for grid CDN (required by many CloudFront rules). */
         gridRequestSiteOrigin,
+        /** When true, logs auth/HTTP diagnostics under `[AguaceroRN][debug]` (Metro / Logcat / Xcode). */
+        debug = false,
         ...restProps
     } = props;
+
+    useEffect(() => {
+        configureAguaceroRnDebug({ enabled: Boolean(debug) });
+    }, [debug]);
     const context = useContext(AguaceroContext);
 
     // Create the core here instead of getting it from context
@@ -295,6 +310,25 @@ export const WeatherLayerManager = forwardRef((props, ref) => {
         [apiKey, gridRequestSiteOrigin],
     );
 
+    useEffect(() => {
+        if (!core) return;
+        installAguaceroCoreDebugHooks(core, {
+            gridRequestSiteOriginProp: gridRequestSiteOrigin ?? null,
+            debugProp: Boolean(debug),
+        });
+        if (isAguaceroRnDebugEnabled() && !apiKey) {
+            aguaceroDebugWarn('WeatherLayerManager.missingApiKey', {
+                hint: 'apiKey prop is empty — all CDN requests will fail or return 403',
+            });
+        }
+        if (isAguaceroRnDebugEnabled() && apiKey && !gridRequestSiteOrigin) {
+            aguaceroDebugWarn('WeatherLayerManager.missingGridOrigin', {
+                hint: 'gridRequestSiteOrigin is not set — CloudFront often returns 403 without Origin/Referer on React Native',
+                snapshot: getAguaceroAuthDiagnosticSnapshot(core),
+            });
+        }
+    }, [core, debug, gridRequestSiteOrigin, apiKey]);
+
     const [watchesWarningsOptions, setWatchesWarningsOptions] = useState(() => ({
         alertInteractionEnabled: true,
         ...(watchesWarningsProp ?? {}),
@@ -637,13 +671,17 @@ export const WeatherLayerManager = forwardRef((props, ref) => {
                 resourcePath = `/grids/${model}/${date}/${run}/${currentFrame}/${variable}/0`;
             }
 
-            const options = buildGridFrameProcessOptions(
-                core.baseGridUrl,
-                resourcePath,
-                core.apiKey,
-                core.bundleId,
-                gridRequestSiteOrigin,
+            const options = augmentProcessFrameOptionsForDebug(
+                buildGridFrameProcessOptions(
+                    core.baseGridUrl,
+                    resourcePath,
+                    core.apiKey,
+                    core.bundleId,
+                    gridRequestSiteOrigin,
+                ),
+                core,
             );
+            logProcessFrameAuthMismatch(core, options, { phase: 'preloadCurrent', currentCacheKey });
 
             try {
                 wxGridVerbose('processFrameRequest', { currentCacheKey, resourcePath, frame: currentFrame });
@@ -763,12 +801,23 @@ export const WeatherLayerManager = forwardRef((props, ref) => {
                         (typeof e?.message === 'string' && e.message.includes('superseded')));
                 if (!cancelled) {
                     hasPreloadedRef.current = false;
-                    wxGridWarn('preloadProcessFrameError', {
+                    const errDetail = {
                         currentCacheKey,
                         code: e?.code,
                         message: e?.message,
                         userInfo: e?.userInfo,
-                    });
+                    };
+                    wxGridWarn('preloadProcessFrameError', errDetail);
+                    if (isAguaceroRnDebugEnabled()) {
+                        aguaceroDebugWarn('preloadProcessFrameError', {
+                            ...errDetail,
+                            auth: getAguaceroAuthDiagnosticSnapshot(core),
+                            is403:
+                                e?.code === 'HTTP_ERROR' &&
+                                typeof e?.message === 'string' &&
+                                e.message.includes('403'),
+                        });
+                    }
                 } else {
                     wxGridVerbose('preloadProcessFrameCancelled', { currentCacheKey });
                 }
@@ -793,13 +842,17 @@ export const WeatherLayerManager = forwardRef((props, ref) => {
                 resourcePath = `/grids/${model}/${date}/${run}/${frame}/${variable}/0`;
             }
 
-            const options = buildGridFrameProcessOptions(
-                core.baseGridUrl,
-                resourcePath,
-                core.apiKey,
-                core.bundleId,
-                gridRequestSiteOrigin,
+            const options = augmentProcessFrameOptionsForDebug(
+                buildGridFrameProcessOptions(
+                    core.baseGridUrl,
+                    resourcePath,
+                    core.apiKey,
+                    core.bundleId,
+                    gridRequestSiteOrigin,
+                ),
+                core,
             );
+            logProcessFrameAuthMismatch(core, options, { phase: 'preloadBackground', cacheKey });
 
             WeatherFrameProcessorModule.processFrame(options)
                 .then(result => {
@@ -1194,13 +1247,17 @@ export const WeatherLayerManager = forwardRef((props, ref) => {
                     const frameDate = new Date(frame * 1000);
                     const y = frameDate.getUTCFullYear(), m = (frameDate.getUTCMonth() + 1).toString().padStart(2, '0'), d = frameDate.getUTCDate().toString().padStart(2, '0');
                     const resourcePath = `/grids/mrms/${y}${m}${d}/${frame}/0/${currentVariable}/0`;
-                    const options = buildGridFrameProcessOptions(
-                        core.baseGridUrl,
-                        resourcePath,
-                        core.apiKey,
-                        core.bundleId,
-                        gridRequestSiteOrigin,
+                    const options = augmentProcessFrameOptionsForDebug(
+                        buildGridFrameProcessOptions(
+                            core.baseGridUrl,
+                            resourcePath,
+                            core.apiKey,
+                            core.bundleId,
+                            gridRequestSiteOrigin,
+                        ),
+                        core,
                     );
+                    logProcessFrameAuthMismatch(core, options, { phase: 'mrmsRefresh', cacheKey });
 
                     WeatherFrameProcessorModule.processFrame(options)
                         .then(result => {

package/src/aguaceroCoreDebugHooks.js

@@ -0,0 +1,142 @@
+/**
+ * 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,
+        });
+    }
+}