Add full sortof codebase: API, drain workers, frontend, schema, specs

api/steam.py

@@ -0,0 +1,82 @@
+"""Async wrapper for Steam's anonymous GetPublishedFileDetails endpoint."""
+
+from __future__ import annotations
+
+from typing import Dict, List, TypedDict
+
+import httpx
+
+
+class CollectionEntry(TypedDict):
+    """One element of fetch_collection_details's response.
+
+    result == 1 → valid collection; children populated.
+    result != 1 → not a collection / deleted / private; children typically [].
+    """
+    result: int
+    children: List[str]
+
+STEAM_URL = (
+    "https://api.steampowered.com/ISteamRemoteStorage/GetPublishedFileDetails/v1/"
+)
+
+
+async def fetch_workshop_details(
+    client: httpx.AsyncClient,
+    workshop_ids: List[str],
+) -> Dict[str, dict]:
+    if not workshop_ids:
+        return {}
+    data: Dict[str, str] = {"itemcount": str(len(workshop_ids))}
+    for i, wid in enumerate(workshop_ids):
+        data[f"publishedfileids[{i}]"] = wid
+    r = await client.post(STEAM_URL, data=data)
+    r.raise_for_status()
+    body = r.json()
+    out: Dict[str, dict] = {}
+    for item in body.get("response", {}).get("publishedfiledetails", []) or []:
+        out[item["publishedfileid"]] = item
+    return out
+
+
+COLLECTION_URL = (
+    "https://api.steampowered.com/ISteamRemoteStorage/GetCollectionDetails/v1/"
+)
+
+
+async def fetch_collection_details(
+    client: httpx.AsyncClient,
+    collection_ids: List[str],
+) -> Dict[str, CollectionEntry]:
+    """Resolve candidate collection IDs to their child wsids.
+
+    Returns a dict keyed by collection_id with shape:
+        { "result": int, "children": List[str] }
+
+    Anonymous endpoint; no API key needed. result==1 means valid collection;
+    result!=1 means the ID isn't a collection (could be a mod, deleted, or
+    private). Caller decides what to do with non-1 results - see Spec B+F
+    §10 Q3 "Partial expansion failure" and Q4 "Flakiness".
+    """
+    if not collection_ids:
+        return {}
+    data: Dict[str, str] = {"collectioncount": str(len(collection_ids))}
+    for i, cid in enumerate(collection_ids):
+        data[f"publishedfileids[{i}]"] = cid
+    r = await client.post(COLLECTION_URL, data=data)
+    r.raise_for_status()
+    body = r.json()
+    out: Dict[str, CollectionEntry] = {}
+    for item in body.get("response", {}).get("collectiondetails", []) or []:
+        cid = item.get("publishedfileid")
+        if not cid:
+            continue
+        out[cid] = {
+            "result": int(item.get("result") or 0),
+            "children": [
+                c.get("publishedfileid", "")
+                for c in (item.get("children") or [])
+                if c.get("publishedfileid")
+            ],
+        }
+    return out