From 6f70f8b4c7e8735f103058de2c0d8839ce599ea2 Mon Sep 17 00:00:00 2001
From: Ivan <ivan@quad4.io>
Date: Sat, 2 May 2026 09:57:50 -0500
Subject: [PATCH] feat(tests): add regression tests for websocket download
 status in Nomadnet

---
 .../test_nomadnet_download_ws_order.py        | 91 +++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 tests/backend/test_nomadnet_download_ws_order.py

diff --git a/tests/backend/test_nomadnet_download_ws_order.py b/tests/backend/test_nomadnet_download_ws_order.py
new file mode 100644
index 0000000..1ca453f
--- /dev/null
+++ b/tests/backend/test_nomadnet_download_ws_order.py
@@ -0,0 +1,91 @@
+# SPDX-License-Identifier: 0BSD
+
+"""Regression: Nomad net downloads must emit websocket ``started`` before scheduling ``download()``."""
+
+import json
+from unittest.mock import AsyncMock, MagicMock
+
+import pytest
+
+import meshchatx.meshchat as meshchat_module
+
+
+@pytest.mark.asyncio
+async def test_nomadnet_page_download_started_before_download_async_scheduled(
+    mock_app, monkeypatch
+):
+    mock_app._try_serve_local_page_node = MagicMock(return_value=None)
+
+    events = []
+    mock_ws = MagicMock()
+    mock_ws.send_str = AsyncMock(
+        side_effect=lambda payload: events.append(("send_str", json.loads(payload)))
+    )
+
+    inner_async_utils = meshchat_module.AsyncUtils
+    prev_run_async = inner_async_utils.run_async
+
+    def wrapping_run_async(coro):
+        events.append(("run_async", coro))
+        return prev_run_async(coro)
+
+    monkeypatch.setattr(inner_async_utils, "run_async", wrapping_run_async)
+
+    dh = "a" * 32
+    await mock_app.on_websocket_data_received(
+        mock_ws,
+        {
+            "type": "nomadnet.page.download",
+            "nomadnet_page_download": {
+                "destination_hash": dh,
+                "page_path": "/page/index.mu",
+                "field_data": None,
+            },
+        },
+    )
+
+    assert len(events) >= 2
+    assert events[0][0] == "send_str"
+    assert events[0][1]["type"] == "nomadnet.page.download"
+    assert events[0][1]["nomadnet_page_download"]["status"] == "started"
+    assert events[1][0] == "run_async"
+
+
+@pytest.mark.asyncio
+async def test_nomadnet_file_download_started_before_download_async_scheduled(
+    mock_app, monkeypatch
+):
+    mock_app._try_serve_local_page_node_file = MagicMock(return_value=None)
+
+    events = []
+    mock_ws = MagicMock()
+    mock_ws.send_str = AsyncMock(
+        side_effect=lambda payload: events.append(("send_str", json.loads(payload)))
+    )
+
+    inner_async_utils = meshchat_module.AsyncUtils
+    prev_run_async = inner_async_utils.run_async
+
+    def wrapping_run_async(coro):
+        events.append(("run_async", coro))
+        return prev_run_async(coro)
+
+    monkeypatch.setattr(inner_async_utils, "run_async", wrapping_run_async)
+
+    dh = "b" * 32
+    await mock_app.on_websocket_data_received(
+        mock_ws,
+        {
+            "type": "nomadnet.file.download",
+            "nomadnet_file_download": {
+                "destination_hash": dh,
+                "file_path": "/files/readme.txt",
+            },
+        },
+    )
+
+    assert len(events) >= 2
+    assert events[0][0] == "send_str"
+    assert events[0][1]["type"] == "nomadnet.file.download"
+    assert events[0][1]["nomadnet_file_download"]["status"] == "started"
+    assert events[1][0] == "run_async"