Merge pull request #6 from MrAlders0n/copilot/add-meshmapper-api-post

Add automatic MeshMapper API posting on every ping

Author: MrAlders0n

.github/workflows/deploy.yml

@@ -0,0 +1,48 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Create config.js with API key from secrets
+        env:
+          API_KEY: ${{ secrets.MESHMAPPER_API_KEY }}
+        run: |
+          {
+            echo "// MeshMapper API Configuration"
+            echo "// This file is auto-generated during deployment from GitHub Secrets"
+            node -e "console.log('window.MESHMAPPER_API_KEY = ' + JSON.stringify(process.env.API_KEY) + ';')"
+          } > content/config.js
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: '.'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,20 @@
+# MeshMapper API configuration (contains sensitive API key)
+content/config.js
+
+# Node modules (if added in the future)
+node_modules/
+
+# Build artifacts
+dist/
+build/
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db

README.md

@@ -101,6 +101,13 @@ Pings are sent to the wardriving MeshCore channel to build community coverage ma
 - **Screen Wake Lock API** - Power management
 - **Tailwind CSS** - Responsive UI design
 - **PWA Ready** - Progressive Web App manifest
+- **MeshMapper API Integration** - Automatic ping data posting for mesh network comparison
+
+---
+
+## 🔐 MeshMapper API Integration
+
+This app automatically posts ping data to the YOW MeshMapper API to help compare if messages were received on the mesh. The API key is securely stored in GitHub Secrets.
 
 ---
 

content/config.template.js

@@ -0,0 +1,4 @@
+// MeshMapper API Configuration
+// This file contains the API key for posting to MeshMapper API
+// Set MESHMAPPER_API_KEY to your actual API key
+window.MESHMAPPER_API_KEY = "YOUR_API_KEY_HERE";

content/wardrive.js

@@ -18,6 +18,15 @@ const WARDROVE_KEY     = new Uint8Array([
   0xA9, 0x3F, 0x06, 0x60, 0x27, 0x32, 0x0F, 0xE5
 ]);
 
+// MeshMapper API Configuration
+const MESHMAPPER_API_URL = "https://yow.meshmapper.net/wardriving-api.php";
+// DO NOT EDIT: This placeholder is used to detect if the API key is configured
+const MESHMAPPER_API_KEY_PLACEHOLDER = "YOUR_API_KEY_HERE";
+// The API key is automatically injected from GitHub Secrets during deployment via config.js
+// You do NOT need to edit this file - just set MESHMAPPER_API_KEY in GitHub Secrets
+const MESHMAPPER_API_KEY = window.MESHMAPPER_API_KEY || MESHMAPPER_API_KEY_PLACEHOLDER;
+const MESHMAPPER_DEFAULT_WHO = "GOME-WarDriver"; // Default identifier
+
 // ---- DOM refs (from index.html; unchanged except the two new selectors) ----
 const $ = (id) => document.getElementById(id);
 const statusEl       = $("status");
@@ -333,14 +342,67 @@ function getGpsMaximumAge(minAge = 1000) {
   return Math.max(minAge, intervalMs - GPS_FRESHNESS_BUFFER_MS);
 }
 
+function getCurrentPowerSetting() {
+  const checkedPower = document.querySelector('input[name="power"]:checked');
+  return checkedPower ? checkedPower.value : "";
+}
+
 function buildPayload(lat, lon) {
   const coordsStr = `${lat.toFixed(5)}, ${lon.toFixed(5)}`;
-  const checkedPower = document.querySelector('input[name="power"]:checked');
-  const power = checkedPower ? checkedPower.value : "";
-   const suffix = power ? ` [${power}]` : "";
+  const power = getCurrentPowerSetting();
+  const suffix = power ? ` [${power}]` : "";
   return `${PING_PREFIX} ${coordsStr} ${suffix}`;
 }
 
+// ---- MeshMapper API ----
+async function postToMeshMapperAPI(lat, lon) {
+  try {
+    // Skip if API key is placeholder (not configured)
+    if (!MESHMAPPER_API_KEY || MESHMAPPER_API_KEY === MESHMAPPER_API_KEY_PLACEHOLDER) {
+      console.log("MeshMapper API key not configured, skipping API post");
+      return;
+    }
+
+    // Get current power setting
+    const power = getCurrentPowerSetting();
+    const powerValue = power || "N/A";
+
+    // Use device name if available, otherwise use default
+    const deviceText = deviceInfoEl?.textContent;
+    const whoIdentifier = (deviceText && deviceText !== "—") ? deviceText : MESHMAPPER_DEFAULT_WHO;
+
+    // Build API payload
+    const payload = {
+      key: MESHMAPPER_API_KEY,
+      lat: lat,
+      lon: lon,
+      who: whoIdentifier,
+      power: powerValue,
+      test: 1
+    };
+
+    console.log("Posting to MeshMapper API:", { lat, lon, who: whoIdentifier, power: powerValue });
+
+    // POST to MeshMapper API
+    const response = await fetch(MESHMAPPER_API_URL, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(payload)
+    });
+
+    if (!response.ok) {
+      console.warn(`MeshMapper API returned status ${response.status}`);
+    } else {
+      console.log("Successfully posted to MeshMapper API");
+    }
+  } catch (error) {
+    // Log error but don't fail the ping
+    console.error("Failed to post to MeshMapper API:", error);
+  }
+}
+
 // ---- Ping ----
 async function sendPing(manual = false) {
   try {
@@ -374,6 +436,10 @@ async function sendPing(manual = false) {
     const ch = await ensureChannel();
     await state.connection.sendChannelTextMessage(ch.channelIdx, payload);
 
+    // Post to MeshMapper API (fire-and-forget pattern: non-blocking, errors are logged inside the function)
+    // Not awaited intentionally to avoid delaying the ping flow
+    postToMeshMapperAPI(lat, lon);
+
     // Only refresh coverage iframe if GPS accuracy is good
     if (accuracy && accuracy < GPS_ACCURACY_THRESHOLD_M) {
       scheduleCoverageRefresh(lat, lon);

index.html

@@ -196,6 +196,8 @@ <h2 id="sessionPingsHeading" class="text-sm font-medium">Session Pings</h2>
     </div>
   </main>
 
+  <!-- Load config before main script -->
+  <script src="content/config.js"></script>
   <script type="module" src="content/wardrive.js"></script>
   <script type="module">
     import { onLoad } from '/content/wardrive.js';