From 7094d395947e2d46702cff0c48eb547f97a84e2f Mon Sep 17 00:00:00 2001
From: Ivan <e318cbc04468bd574db2b4523dddd710>
Date: Thu, 13 Aug 2026 14:36:28 -0500
Subject: [PATCH] feat: add new HTTP JSON contracts and schemas for map data
 status, published, and heard endpoints

---
 meshchatx.rsm                               | Bin 191718 -> 191718 bytes
 tests/backend/http_api_response_registry.py |  24 ++++++++++++
 tests/backend/http_api_response_schemas.py  |  39 ++++++++++++++++++++
 3 files changed, 63 insertions(+)

diff --git a/meshchatx.rsm b/meshchatx.rsm
index ff854582ca1451f328435c8fbd9ce398d000abfe..24b20d2531d554d0b1a7f612fc34637a35794279 100644
GIT binary patch
delta 269
zcmV+o0rLLl*$d{`3qZyb&!&$CX4^@RYCaK=n8Dn1>4pJdj7;rSa1ey@{L%0^BxK~}
zbggHwV%N42-VVh}OM$5-3Qo6*W+g1q1ptvi7$9H~T+nC~rf#JFv$lsaekoKV=5IzO
z1A3}hBKS4iBP4-%wRiy*)IecmVmC85VK6f{W-~Z4H#lKsWj16pIbva9Wier4G%+(a
zF*P}4WMMfsFfuS?Vq;`6H)3KnHZ?UdGG<{oWn-6N)Bzcn=hOieKs7TqVq!RCGGs9_
zVlXx|F=IG2Vq-HmHZ)-}Fk>`gWI16rHexYkVPZ07WHdK3Ff}$eF*Pz}WivKoF)%VQ
TF_&S~0U3u?)d9Cv)dG<hLdRm-

delta 269
zcmV+o0rLLl*$d{`3qUc-hBd+{v}aQTVf-uGI13Dha5#k6S~*1b`+1L0%UK3s8DDz3
z?FuRBbuK0H%d<&=M8+CEQ!x>s;aFg1T?vsu7$7{PM*M}0|4A#ySRX6#Sg?btrdcJ~
zl5gtDR@~Az{4arcwRiy*)Ic?2Heq8lGcsjmHDNPjH8N#3IASqmGBROdG%{vmWi~Z6
zFf=nZW;kLsWnnjDVlgo@He)hnF=b|9HZ^24Ffx~6)Bzcn=hOieKsYovWiezkI5lHp
zG&V3dF)}kZW?^DBVmM}EVL4<sG&yB4IWaIbWI1DFVKp;mG-NqtVKp*jHfCZuFfn0e
TF_&S~0U3u?)d9Cv)dG<hcDG}?

diff --git a/tests/backend/http_api_response_registry.py b/tests/backend/http_api_response_registry.py
index d316ac13..3061ecdd 100644
--- a/tests/backend/http_api_response_registry.py
+++ b/tests/backend/http_api_response_registry.py
@@ -65,6 +65,9 @@ from tests.backend.http_api_response_schemas import (
     LXMF_SIEVE_FILTERS_SCHEMA,
     MAINTENANCE_MESSAGES_PURGE_PREVIEW_SCHEMA,
     MAINTENANCE_MESSAGES_DUPLICATES_SCHEMA,
+    MAP_DATA_HEARD_SCHEMA,
+    MAP_DATA_PUBLISHED_SCHEMA,
+    MAP_DATA_STATUS_SCHEMA,
     MAP_DRAWINGS_SCHEMA,
     MAP_MBTILES_SCHEMA,
     MAP_OFFLINE_SCHEMA,
@@ -403,6 +406,27 @@ HTTP_JSON_GET_CONTRACTS: tuple[HttpJsonContract, ...] = (
     HttpJsonContract("GET", "/api/v1/map/drawings", MAP_DRAWINGS_SCHEMA),
     HttpJsonContract("GET", "/api/v1/map/offline", MAP_OFFLINE_SCHEMA),
     HttpJsonContract("GET", "/api/v1/map/mbtiles", MAP_MBTILES_SCHEMA),
+    HttpJsonContract(
+        "GET",
+        "/api/v1/map/data/status",
+        MAP_DATA_STATUS_SCHEMA,
+        allow_statuses=(200, 503),
+        alt_schemas=(ERROR_ENVELOPE_SCHEMA,),
+    ),
+    HttpJsonContract(
+        "GET",
+        "/api/v1/map/data/published",
+        MAP_DATA_PUBLISHED_SCHEMA,
+        allow_statuses=(200, 503),
+        alt_schemas=(ERROR_ENVELOPE_SCHEMA,),
+    ),
+    HttpJsonContract(
+        "GET",
+        "/api/v1/map/data/heard",
+        MAP_DATA_HEARD_SCHEMA,
+        allow_statuses=(200, 503),
+        alt_schemas=(ERROR_ENVELOPE_SCHEMA,),
+    ),
     HttpJsonContract("GET", "/api/v1/telemetry/peers", TELEMETRY_PEERS_SCHEMA),
     HttpJsonContract("GET", "/api/v1/telemetry/tracking", TELEMETRY_TRACKING_SCHEMA),
     HttpJsonContract(
diff --git a/tests/backend/http_api_response_schemas.py b/tests/backend/http_api_response_schemas.py
index c31fb87a..cf5be6c9 100644
--- a/tests/backend/http_api_response_schemas.py
+++ b/tests/backend/http_api_response_schemas.py
@@ -453,6 +453,45 @@ MAP_MBTILES_SCHEMA: dict = {
     "items": _OBJECT,
 }
 
+MAP_DATA_STATUS_SCHEMA: dict = {
+    "type": "object",
+    "required": [
+        "aspect",
+        "running",
+        "destination_hash",
+        "display_name",
+        "announce_enabled",
+        "announce_interval",
+        "max_bytes",
+        "published_count",
+    ],
+    "properties": {
+        "aspect": _STRING,
+        "running": _BOOLEAN,
+        "destination_hash": {"type": ["string", "null"]},
+        "display_name": _STRING,
+        "announce_enabled": _BOOLEAN,
+        "announce_interval": _INTEGER,
+        "max_bytes": _INTEGER,
+        "published_count": _INTEGER,
+    },
+    "additionalProperties": True,
+}
+
+MAP_DATA_PUBLISHED_SCHEMA: dict = {
+    "type": "object",
+    "required": ["maps"],
+    "properties": {"maps": _ARRAY},
+    "additionalProperties": True,
+}
+
+MAP_DATA_HEARD_SCHEMA: dict = {
+    "type": "object",
+    "required": ["announces"],
+    "properties": {"announces": _ARRAY},
+    "additionalProperties": True,
+}
+
 TELEMETRY_PEERS_SCHEMA: dict = {
     "type": "object",
     "required": ["telemetry"],