registry.py 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. """Local JSON registry of approved remote meet nodes.
  2. ``$HERMES_HOME/workspace/meetings/nodes.json``::
  3. {"nodes": {"<name>": {"url": "ws://host:port", "token": "...", "added_at": <epoch>}}}
  4. """
  5. from __future__ import annotations
  6. import time
  7. from pathlib import Path
  8. from typing import Any, Dict, List, Optional
  9. from hermes_constants import get_hermes_home
  10. from plugins.google_meet._jsonfile import read_json
  11. from utils import atomic_json_write
  12. def _default_path() -> Path:
  13. return Path(get_hermes_home()) / "workspace" / "meetings" / "nodes.json"
  14. class NodeRegistry:
  15. """File-backed registry; single writer assumed (the gateway CLI)."""
  16. def __init__(self, path: Optional[Path] = None) -> None:
  17. self.path = Path(path) if path is not None else _default_path()
  18. def _load(self) -> dict[str, dict[str, Any]]:
  19. """The ``nodes`` map (name → entry); empty when the file is missing or malformed."""
  20. data = read_json(self.path)
  21. nodes = data.get("nodes") if isinstance(data, dict) else None
  22. return nodes if isinstance(nodes, dict) else {}
  23. def _save(self, nodes: dict[str, dict[str, Any]]) -> None:
  24. atomic_json_write(self.path, {"nodes": nodes})
  25. def get(self, name: str) -> Optional[dict[str, Any]]:
  26. entry = self._load().get(name)
  27. return None if entry is None else {"name": name, **entry}
  28. def add(self, name: str, url: str, token: str) -> None:
  29. for label, value in (("node name", name), ("url", url), ("token", token)):
  30. if not isinstance(value, str) or not value:
  31. raise ValueError(f"{label} must be a non-empty string")
  32. nodes = self._load()
  33. nodes[name] = {"url": url, "token": token, "added_at": time.time()}
  34. self._save(nodes)
  35. def remove(self, name: str) -> bool:
  36. nodes = self._load()
  37. if name not in nodes:
  38. return False
  39. del nodes[name]
  40. self._save(nodes)
  41. return True
  42. def list_all(self) -> list[dict[str, Any]]:
  43. return [{"name": name, **entry} for name, entry in sorted(self._load().items())]
  44. def resolve(self, chrome_node: Optional[str]) -> Optional[dict[str, Any]]:
  45. """Named node's entry, or (``chrome_node`` falsy) the sole registered node; None if unknown
  46. or when zero / several nodes are registered (ambiguous)."""
  47. if chrome_node:
  48. return self.get(chrome_node)
  49. nodes = self.list_all()
  50. return nodes[0] if len(nodes) == 1 else None