Link Ayah to HexoAPI

[itsreallyhex]

Instead of needing a local file Ayah will make a web req for a Random Ayah or hadith from HexoAPI , making adding new ayahs and hadiths easy for me. It will include fallback that has 10 ayahs/hadiths in case web req fails

Todo:

- make the dll make a web req 
-  Add a fallback incase of a failed req. It will be hard codded into dll
- Add a separate section on web for Ayah

[itsreallyhex]

Review Notes on This Plan

The overall idea here is really smart. Instead of shipping a new version of the mod every time you want to add a new verse or hadith, you just update the JSON file on HexoAPI and every player automatically gets the new content next time the mod runs. That's a clean separation of concerns.

What's solid about this plan:

• The fallback with 10 hardcoded items is a good safety net — players with no internet or a failed request won't get a broken experience
• The data already exists (extras/Ayah.json) with 50 Quran verses and 50 hadiths, so the API side is mostly ready

Things worth thinking through before building:

1. How does the web request work exactly? Right now Ayah.json lives at extras/Ayah.json in the repo. The mod will need to hit the raw GitHub URL for that file. That URL should be documented somewhere so it doesn't get accidentally broken if the file moves.

2. When does it refresh? Every game launch? Every round? Every time someone sees it? This decision affects how "fresh" the content feels vs. how many requests get made.

3. The fallback has 10 items — that's fine as a safety net, but if someone plays offline a lot, they'll see the same 10 over and over. Worth noting as a known limitation.

4. The "separate section on web for Ayah" — this is currently not built. The HTML body of HexoAPI is empty right now, and main.js has no code in it at all. The Ayah page needs to be created before this issue can be considered fully done.

5. No error handling is mentioned for partial failures — what if the request succeeds but returns malformed JSON? The DLL should probably validate the response before trying to use it.

The plan is good. The main risk is the web portion (#4 above) since the site itself needs to be built first. Suggest splitting this into two milestones: (1) build the Ayah section on the website, (2) update the mod to fetch from it.

---

Generated by Claude Code