typefaster-cli 0.1.3__py3-none-any.whl → 0.2.0__py3-none-any.whl

typefaster/__init__.py

@@ -1,3 +1,3 @@
 """TYPEFASTER-CLI — a terminal-first typing game."""
 
-__version__ = "0.1.3"
+__version__ = "0.2.0"

typefaster/net/token_store.py

@@ -18,7 +18,7 @@ class Session:
     # Default points at the public TYPEFASTER server so a fresh install can
     # register/play with zero config. Override with `typefaster config set-server`
     # (e.g. a local server or your own deployment).
-    server_url: str = "https://typefaster-cli.fly.dev"
+    server_url: str = "https://140.245.248.113.sslip.io"
     token: str | None = None
     username: str | None = None
 

typefaster/services/daily_service.py

@@ -2,22 +2,33 @@
 
 from __future__ import annotations
 
-from datetime import date
+from datetime import UTC, date, datetime
 
 from ..domain.models import DailyChallenge, RaceRecord
 from ..infra import quote_loader
 from ..infra.repository import Repository
 
 
+def _utc_today() -> date:
+    """The daily challenge day in UTC.
+
+    Races are stored with a UTC ``started_at`` and the daily leaderboard filters
+    on that, so the day MUST be UTC too — otherwise (e.g. in IST) results land on
+    the wrong day and the challenge never updates. UTC also makes the daily
+    genuinely 'the same for everyone'.
+    """
+    return datetime.now(UTC).date()
+
+
 class DailyService:
     def __init__(self, repo: Repository) -> None:
         self._repo = repo
 
     def today(self, day: date | None = None) -> DailyChallenge:
-        day = day or date.today()
+        day = day or _utc_today()
         quote = quote_loader.daily_quote(day)
         return self._repo.get_or_create_daily(day.isoformat(), quote)
 
     def leaderboard(self, day: date | None = None, limit: int = 20) -> list[RaceRecord]:
-        day = day or date.today()
+        day = day or _utc_today()
         return self._repo.daily_leaderboard(day.isoformat(), limit=limit)

typefaster/ui/app.py

@@ -8,10 +8,12 @@ from ..domain.models import RaceResult
 from ..services.container import App as Services
 from ..services.container import build_app
 from ..services.race_service import RaceConfig, RaceSetup
+from .screens.account import AccountScreen
 from .screens.daily import DailyScreen
 from .screens.help import HelpScreen
 from .screens.history import HistoryScreen
 from .screens.leaderboard import LeaderboardScreen
+from .screens.lobby_browser import LobbyBrowserScreen
 from .screens.main_menu import MainMenu
 from .screens.practice import PracticeScreen
 from .screens.profile import ProfileScreen
@@ -30,6 +32,8 @@ _PANELS = {
     "leaderboard": LeaderboardScreen,
     "settings": SettingsScreen,
     "help": HelpScreen,
+    "account": AccountScreen,
+    "online": LobbyBrowserScreen,
 }
 
 

typefaster/ui/screens/_base.py

@@ -20,11 +20,15 @@ class PanelScreen(Screen[None]):
         with Vertical(id="panel-wrap"):
             yield Static(Text(self.title_text, justify="center"), id="title")
             with VerticalScroll():
-                yield Static(self.body())
+                yield Static(self.body(), id="panel-body")
             yield Static("esc back", classes="dim")
 
     def body(self) -> RenderableType:  # pragma: no cover - overridden
         return Text("")
 
+    def on_screen_resume(self) -> None:
+        # Re-query when we return here (e.g. after a race) so data is fresh.
+        self.query_one("#panel-body", Static).update(self.body())
+
     def action_back(self) -> None:
         self.app.pop_screen()

typefaster/ui/screens/account.py

@@ -0,0 +1,193 @@
+"""In-TUI account screen: register, login (password / GitHub / Google), logout.
+
+Actions are an OptionList (not single-letter keys, which would collide with the
+username/password Inputs). Network calls (blocking httpx) run in worker threads
+and post results back via ``call_from_thread``.
+"""
+
+from __future__ import annotations
+
+import contextlib
+import time
+import webbrowser
+
+from rich.text import Text
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import Screen
+from textual.widgets import Input, OptionList, Static
+from textual.widgets.option_list import Option
+
+from ...net.api import ApiClient, ApiError
+from ...net.token_store import Session
+
+_ACTIONS = [
+    ("register", "Register (username + password)"),
+    ("login", "Login (username + password)"),
+    ("github", "Login with GitHub (browser)"),
+    ("google", "Login with Google (browser)"),
+    ("setserver", "Set server URL (from field above)"),
+    ("logout", "Logout"),
+]
+
+
+class AccountScreen(Screen[None]):
+    BINDINGS = [("escape", "back", "Back")]
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="panel-wrap"):
+            yield Static(Text("ACCOUNT", justify="center"), id="title")
+            yield Static(self._status_text(), id="acct-status")
+            yield Input(placeholder="username", id="user")
+            yield Input(placeholder="password", password=True, id="pw")
+            yield Input(placeholder="server url", id="server", value=Session.load().server_url)
+            yield OptionList(*[Option(label, id=key) for key, label in _ACTIONS])
+            yield Static(
+                Text("Tab between fields · pick an action below · esc back", justify="center"),
+                classes="dim",
+            )
+            yield Static("", id="acct-msg")
+
+    def on_mount(self) -> None:
+        self.query_one("#user", Input).focus()
+
+    def on_option_list_option_selected(self, event: OptionList.OptionSelected) -> None:
+        match event.option.id:
+            case "register":
+                self._auth("register")
+            case "login":
+                self._auth("login")
+            case "github":
+                self._oauth("github")
+            case "google":
+                self._oauth("google")
+            case "setserver":
+                self._set_server()
+            case "logout":
+                self._logout()
+
+    # ── helpers ────────────────────────────────────────────────────────
+    def _status_text(self) -> Text:
+        s = Session.load()
+        who = s.username or "not logged in"
+        return Text.from_markup(f"server: [bold]{s.server_url}[/]   ·   [bold cyan]{who}[/]")
+
+    def _msg(self, markup: str) -> None:
+        self.query_one("#acct-msg", Static).update(Text.from_markup(markup))
+
+    def _refresh_status(self) -> None:
+        self.query_one("#acct-status", Static).update(self._status_text())
+
+    def _field(self, wid: str) -> str:
+        return self.query_one(f"#{wid}", Input).value.strip()
+
+    # ── password auth ──────────────────────────────────────────────────
+    def _auth(self, kind: str) -> None:
+        user, pw = self._field("user"), self._field("pw")
+        if not user or not pw:
+            self._msg("[red]Enter a username and password first.[/]")
+            return
+        self._msg(f"[grey58]{kind.title()}ing…[/]")
+        self.run_worker(lambda: self._do_auth(kind, user, pw), thread=True, name="auth")
+
+    def _do_auth(self, kind: str, user: str, pw: str) -> None:
+        session = Session.load()
+        client = ApiClient(session)
+        try:
+            data = client.register(user, pw) if kind == "register" else client.login(user, pw)
+            session.token = data["access_token"]
+            session.username = data["username"]
+            session.save()
+            self.app.call_from_thread(self._on_auth_ok, session.username)
+        except ApiError as exc:
+            self.app.call_from_thread(self._msg, f"[red]{exc.detail}[/]")
+        finally:
+            client.close()
+
+    def _on_auth_ok(self, username: str) -> None:
+        self._refresh_status()
+        self._msg(f"[green]Logged in as[/] [bold]{username}[/]. Press esc, then 'Play Online'.")
+
+    # ── logout / server ────────────────────────────────────────────────
+    def _logout(self) -> None:
+        self.run_worker(self._do_logout, thread=True, name="logout")
+
+    def _do_logout(self) -> None:
+        session = Session.load()
+        client = ApiClient(session)
+        with contextlib.suppress(ApiError):
+            if session.logged_in:
+                client.logout()
+        client.close()
+        session.clear()
+        self.app.call_from_thread(self._after_logout)
+
+    def _after_logout(self) -> None:
+        self._refresh_status()
+        self._msg("[green]Logged out.[/]")
+
+    def _set_server(self) -> None:
+        url = self._field("server")
+        if not url:
+            return
+        session = Session.load()
+        if url.rstrip("/") != session.server_url:
+            session.token = None
+            session.username = None
+        session.server_url = url.rstrip("/")
+        session.save()
+        self._refresh_status()
+        self._msg(f"[green]Server set to[/] [bold]{session.server_url}[/]")
+
+    # ── OAuth device flow ──────────────────────────────────────────────
+    def _oauth(self, provider: str) -> None:
+        self._msg(f"[grey58]Starting {provider.title()} login…[/]")
+        self.run_worker(lambda: self._do_oauth(provider), thread=True, name="oauth")
+
+    def _do_oauth(self, provider: str) -> None:
+        session = Session.load()
+        client = ApiClient(session)
+        try:
+            start = client.oauth_start(provider)
+        except ApiError as exc:
+            self.app.call_from_thread(
+                self._msg, f"[red]{provider.title()} unavailable: {exc.detail}[/]"
+            )
+            client.close()
+            return
+
+        uri, code, device = start["verification_uri"], start["user_code"], start["device_code"]
+        interval = int(start.get("interval", 5))
+        deadline = time.time() + int(start.get("expires_in", 900))
+        self.app.call_from_thread(
+            self._msg,
+            f"Open [bold underline]{uri}[/] · enter code [bold cyan]{code}[/] · waiting…",
+        )
+        with contextlib.suppress(Exception):
+            webbrowser.open(uri)
+
+        try:
+            while time.time() < deadline:
+                time.sleep(interval)
+                try:
+                    r = client.oauth_poll(provider, device)
+                except ApiError as exc:
+                    self.app.call_from_thread(self._msg, f"[red]Login failed: {exc.detail}[/]")
+                    return
+                st = r.get("status")
+                if st == "pending":
+                    continue
+                if st == "slow_down":
+                    interval += 5
+                    continue
+                session.token = r["access_token"]
+                session.username = r["username"]
+                session.save()
+                self.app.call_from_thread(self._on_auth_ok, session.username)
+                return
+            self.app.call_from_thread(self._msg, "[red]Login timed out.[/]")
+        finally:
+            client.close()
+
+    def action_back(self) -> None:
+        self.app.pop_screen()

typefaster/ui/screens/daily.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from datetime import date
+from datetime import UTC, datetime
 
 from rich.console import Group
 from rich.table import Table
@@ -23,15 +23,17 @@ class DailyScreen(Screen[None]):
     ]
 
     def compose(self) -> ComposeResult:
+        day = datetime.now(UTC).date().isoformat()  # UTC — matches how results are filed
         with Vertical(id="panel-wrap"):
-            yield Static(
-                Text(f"DAILY CHALLENGE · {date.today().isoformat()}", justify="center"),
-                id="title",
-            )
+            yield Static(Text(f"DAILY CHALLENGE · {day} (UTC)", justify="center"), id="title")
             with VerticalScroll():
-                yield Static(self._body())
+                yield Static(self._body(), id="panel-body")
             yield Static("⏎ play today's challenge    esc back", classes="dim")
 
+    def on_screen_resume(self) -> None:
+        # Refresh best/attempts/leaderboard after returning from a race.
+        self.query_one("#panel-body", Static).update(self._body())
+
     def _body(self) -> Group:
         svc = self.app.services  # type: ignore[attr-defined]
         challenge = svc.daily.today()

typefaster/ui/screens/lobby_browser.py

@@ -0,0 +1,150 @@
+"""In-TUI lobby browser: list public lobbies, create, or join by code.
+
+OptionList-driven (Create / Refresh are list items so there are no single-letter
+key collisions with the join-code Input). Joining/creating launches the
+OnlineRaceScreen on the app stack, so leaving a race returns here. Network calls
+run in worker threads.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from rich.text import Text
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import Screen
+from textual.widgets import Input, OptionList, Static
+from textual.widgets.option_list import Option
+
+from ...net.api import ApiClient, ApiError, ws_url
+from ...net.token_store import Session
+from .online_race import OnlineRaceScreen
+
+
+class LobbyBrowserScreen(Screen[None]):
+    BINDINGS = [("escape", "back", "Back")]
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="panel-wrap"):
+            yield Static(Text("PLAY ONLINE — LOBBIES", justify="center"), id="title")
+            yield Static("", id="lobby-status")
+            yield Input(placeholder="join code — type it and press Enter", id="code")
+            yield OptionList(id="lobby-list")
+            yield Static(
+                Text("⏎ select · type a code + Enter to join · esc back", justify="center"),
+                classes="dim",
+            )
+            yield Static("", id="lobby-msg")
+
+    def on_mount(self) -> None:
+        self._refresh()
+
+    def on_screen_resume(self) -> None:
+        self._refresh()
+
+    def _session(self) -> Session:
+        return Session.load()
+
+    def _msg(self, markup: str) -> None:
+        self.query_one("#lobby-msg", Static).update(Text.from_markup(markup))
+
+    # ── listing ────────────────────────────────────────────────────────
+    def _refresh(self) -> None:
+        s = self._session()
+        self.query_one("#lobby-status", Static).update(
+            Text.from_markup(
+                f"server: [bold]{s.server_url}[/] · [bold cyan]{s.username or 'not logged in'}[/]"
+            )
+        )
+        ol = self.query_one("#lobby-list", OptionList)
+        ol.clear_options()
+        ol.add_option(Option("➕  Create a lobby", id="__create__"))
+        ol.add_option(Option("🔄  Refresh list", id="__refresh__"))
+        if not s.logged_in:
+            self._msg("[red]Not logged in.[/] esc → Account to log in first.")
+            return
+        self._msg("Loading lobbies…")
+        self.run_worker(self._load, thread=True, name="load")
+
+    def _load(self) -> None:
+        client = ApiClient(self._session())
+        try:
+            lobbies = client.list_lobbies()
+            self.app.call_from_thread(self._show_lobbies, lobbies)
+        except ApiError as exc:
+            self.app.call_from_thread(self._msg, f"[red]{exc.detail}[/]")
+        finally:
+            client.close()
+
+    def _show_lobbies(self, lobbies: list[dict[str, Any]]) -> None:
+        ol = self.query_one("#lobby-list", OptionList)
+        for lob in lobbies:
+            label = (
+                f"{lob['code']}  ·  {lob['name'][:24]}  ·  host {lob['host'][:12]}  "
+                f"·  {lob['mode_seconds']}s  ·  {lob['player_count']} players"
+            )
+            ol.add_option(Option(label, id=f"join:{lob['code']}:{lob['mode_seconds']}"))
+        if lobbies:
+            self._msg(f"{len(lobbies)} public lobby(ies). ⏎ to join the highlighted one.")
+        else:
+            self._msg("No public lobbies yet — pick 'Create a lobby'.")
+
+    # ── actions ────────────────────────────────────────────────────────
+    def on_option_list_option_selected(self, event: OptionList.OptionSelected) -> None:
+        oid = event.option.id or ""
+        if oid == "__create__":
+            self._create()
+        elif oid == "__refresh__":
+            self._refresh()
+        elif oid.startswith("join:"):
+            _, code, mode = oid.split(":")
+            self._join(code, int(mode))
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        code = event.value.strip().upper()
+        if code:
+            self._join(code, 0)  # mode learned from the join response
+
+    def _create(self) -> None:
+        if not self._session().logged_in:
+            self._msg("[red]Log in first (esc → Account).[/]")
+            return
+        self._msg("[grey58]Creating lobby…[/]")
+        self.run_worker(self._do_create, thread=True, name="create")
+
+    def _do_create(self) -> None:
+        s = self._session()
+        client = ApiClient(s)
+        try:
+            lob = client.create_lobby(f"{s.username}'s lobby", is_public=True, mode_seconds=60)
+            self.app.call_from_thread(self._enter, lob["code"], int(lob["mode_seconds"]))
+        except ApiError as exc:
+            self.app.call_from_thread(self._msg, f"[red]{exc.detail}[/]")
+        finally:
+            client.close()
+
+    def _join(self, code: str, mode_hint: int) -> None:
+        if not self._session().logged_in:
+            self._msg("[red]Log in first (esc → Account).[/]")
+            return
+        self._msg(f"[grey58]Joining {code}…[/]")
+        self.run_worker(lambda: self._do_join(code), thread=True, name="join")
+
+    def _do_join(self, code: str) -> None:
+        client = ApiClient(self._session())
+        try:
+            lob = client.join_lobby(code)
+            self.app.call_from_thread(self._enter, lob["code"], int(lob["mode_seconds"]))
+        except ApiError as exc:
+            self.app.call_from_thread(self._msg, f"[red]{exc.detail}[/]")
+        finally:
+            client.close()
+
+    def _enter(self, code: str, mode_seconds: int) -> None:
+        s = self._session()
+        url = ws_url(s.server_url, code, s.token or "")
+        self.app.push_screen(OnlineRaceScreen(url, s.username or "you", mode_seconds))
+
+    def action_back(self) -> None:
+        self.app.pop_screen()

typefaster/ui/screens/main_menu.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import contextlib
+
 from rich.text import Text
 from textual.app import ComposeResult
 from textual.containers import Vertical
@@ -10,6 +12,7 @@ from textual.widgets import OptionList, Static
 from textual.widgets.option_list import Option
 
 from ...domain.models import RaceKind, RaceMode
+from ...net.token_store import Session
 from ...services.race_service import RaceConfig
 
 _TIMES = [30, 60, 120]
@@ -36,6 +39,8 @@ class MainMenu(Screen[None]):
             ("time", self._time_label()),
             ("practice", "Practice"),
             ("daily", "Daily Challenge"),
+            ("online", "🌐 Play Online  (multiplayer lobbies)"),
+            ("account", "🌐 Account / Login"),
             ("stats", "Stats"),
             ("history", "History"),
             ("profile", "Profile"),
@@ -49,14 +54,26 @@ class MainMenu(Screen[None]):
             yield Static(Text("⌨  T Y P E F A S T E R", justify="center"), id="title")
             yield Static(self._tagline(), id="subtitle")
             yield OptionList(*[Option(label, id=key) for key, label in self._items()])
+            yield Static(
+                Text("crafted by Anoshor Paul", justify="center"),
+                id="byline",
+                classes="dim",
+            )
 
     def _tagline(self) -> Text:
         p = self.app.services.profile.get()  # type: ignore[attr-defined]
+        s = Session.load()
+        status = f"online · {s.username}" if s.logged_in else "offline"
         return Text(
-            f"best {p.best_wpm:.0f} wpm  ·  races {p.races_played}  ·  offline mode",
+            f"best {p.best_wpm:.0f} wpm  ·  races {p.races_played}  ·  {status}",
             justify="center",
         )
 
+    def on_screen_resume(self) -> None:
+        # Reflect login changes made in the Account screen.
+        with contextlib.suppress(Exception):
+            self.query_one("#subtitle", Static).update(self._tagline())
+
     def on_mount(self) -> None:
         self.query_one(OptionList).focus()
 

typefaster/ui/screens/online_race.py

@@ -307,8 +307,12 @@ class OnlineRaceScreen(Screen[None]):
 
     # ── exit ───────────────────────────────────────────────────────────
     def action_leave(self) -> None:
-        # This screen IS the whole online app, so leaving exits cleanly back to
-        # the shell (popping the only screen would leave a blank screen). The
-        # server removes us from the lobby when the WebSocket closes on exit.
+        # Tell the server we're leaving (it also detects the socket close).
         self.run_worker(self._send("LEAVE"), name="leave")
-        self.app.exit()
+        # If launched from the menu (screen underneath), pop back to it;
+        # if standalone (CLI `lobby join`), exit the app — popping the only
+        # screen would leave a blank screen.
+        if len(self.app.screen_stack) > 2:  # base + this (+ any) → safe to pop
+            self.app.pop_screen()
+        else:
+            self.app.exit()

typefaster_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: typefaster-cli
+Version: 0.2.0
+Summary: A terminal-first typing game inspired by MonkeyType and TypeRacer.
+Project-URL: Homepage, https://github.com/Anoshor/typefaster-cli
+Project-URL: Repository, https://github.com/Anoshor/typefaster-cli
+Author: Anoshor Paul
+License: MIT
+License-File: LICENSE
+Keywords: cli,game,monkeytype,terminal,tui,typeracer,typing,wpm
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: rich>=13.7
+Requires-Dist: textual>=0.60
+Requires-Dist: typer>=0.12
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: textual-dev>=1.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ⌨ TYPEFASTER
+
+[![CI](https://github.com/Anoshor/typefaster-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Anoshor/typefaster-cli/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/typefaster-cli)](https://pypi.org/project/typefaster-cli/)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+A **terminal-first** typing game inspired by MonkeyType and TypeRacer — race
+quotes, beat your ghost, climb leaderboards, and play **live multiplayer** with
+friends. Pure TUI, no browser, no GUI.
+
+```bash
+brew install Anoshor/typefaster/typefaster   # or: pipx install typefaster-cli
+typefaster
+```
+
+---
+
+## Install
+
+**Homebrew** (macOS / Linux)
+```bash
+brew install Anoshor/typefaster/typefaster
+```
+
+**pipx** (any OS with Python 3.11+) — fastest
+```bash
+pipx install typefaster-cli
+```
+
+Verify: `typefaster version`
+
+## Play (offline — no account, no internet)
+
+Just run it:
+```bash
+typefaster
+```
+Keyboard-only menu:
+- **Quick Race** — a fresh random quote each time; race your personal-best ghost.
+- **Time Attack** — type for 30 / 60 / 120s (←/→ to change the duration inline).
+- **Practice** — pick a mode/ghost.
+- **Daily Challenge** — same quote for everyone each day, local leaderboard.
+- **Stats / History / Profile / Leaderboard / Settings**.
+
+Live WPM, accuracy, progress, and an animated ghost bar. Backspace corrects
+mistakes (original errors still count, MonkeyType-style). All progress is saved
+locally in SQLite.
+
+Direct commands too:
+```bash
+typefaster race                      # quote race
+typefaster race --mode time --time 60
+typefaster daily
+typefaster stats   |   typefaster history
+```
+
+## Play online (multiplayer lobbies)
+
+It works out of the box against the public server — **no setup**. From the main
+menu pick **Account** to register/login, then **Play Online**:
+
+```text
+Account      → Register / Login (password, GitHub, or Google)
+Play Online  → ➕ Create a lobby  → share the join code
+             → or type a friend's code + Enter to join
+```
+In the waiting room press **R** to ready; the **server** runs the countdown,
+sends everyone the same quote, shows live progress bars, and scores results
+authoritatively (with anti-cheat). **Esc** leaves.
+
+Prefer the CLI?
+```bash
+typefaster register <name>      # or: typefaster login --github / --google
+typefaster lobby create --name "Friday" --time 60
+typefaster lobby join ABC123
+typefaster leaderboard global   # global | daily | weekly
+```
+
+## Self-host the server (optional)
+
+The game ships pointing at a public server, but you can run your own:
+```bash
+git clone https://github.com/Anoshor/typefaster-cli && cd typefaster-cli
+cp .env.example .env            # set TYPEFASTER_JWT_SECRET
+make up                         # Redis + FastAPI server on :8000 (Docker)
+typefaster config set-server http://localhost:8000
+```
+Deploy guides: [`docs/deploy-oracle.md`](docs/deploy-oracle.md) (free 24/7 VM) ·
+[`docs/deploy-fly.md`](docs/deploy-fly.md) · TLS + hardening in
+[`docs/SECURITY-REVIEW.md`](docs/SECURITY-REVIEW.md).
+
+## How it works
+
+- **Client**: Python · Typer (CLI) · Textual + Rich (TUI) · SQLite (local
+  progress) · httpx + websockets (online).
+- **Server**: FastAPI · WebSockets · Redis · Pydantic — **server-authoritative**
+  race timing and scoring.
+- Deep dive: [`docs/DEEPDIVE.md`](docs/DEEPDIVE.md) · architecture:
+  [`docs/architecture.md`](docs/architecture.md).
+
+## Develop
+
+```bash
+make install     # editable install + dev deps
+make play        # run it
+make check       # ruff + mypy + pytest
+```
+Contributions welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE). Crafted by **Anoshor Paul**.

{typefaster_cli-0.1.3.dist-info → typefaster_cli-0.2.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-typefaster/__init__.py,sha256=wRbUzq7R-a3kRsE_ybdBWOSFn-4XPHr7wc2H_5FUiN4,78
+typefaster/__init__.py,sha256=cfdYbT59dWFZ4oxJu7NWC94LrR8lKT_ZagPhY6DjWAM,78
 typefaster/__main__.py,sha256=2dxSnCI2wKDhIgdMFPwlZkdbJ-GQwy6uZApfeoyFAkA,135
 typefaster/cli.py,sha256=NnKzBjvFtr36tBgA5x4XgCuqWo-QGB_40XLLy34Gu9I,6549
 typefaster/assets/__init__.py,sha256=uDRfxDegVWAPzgSUlv-yy_ILP5UTMVIa9lNTh4moyU4,43
@@ -23,26 +23,28 @@ typefaster/infra/sqlite_repository.py,sha256=XRtT8Q3tbi9cbuQIYCqfHly54rKF_koLT1D
 typefaster/net/__init__.py,sha256=tSx4UMBc0kUlp60corti6SvOnc9fJ_n5guJlysdRUZ0,74
 typefaster/net/api.py,sha256=dxYx5VUkADjK_65rKNoR2kz8V4EDPnnU3dO_fjaZ2j8,4440
 typefaster/net/commands.py,sha256=OBsP3DbfAHz-1LmQX0B2FZB0cVIuTQ_od2tCNfQBpy4,9791
-typefaster/net/token_store.py,sha256=KLDXAqZyOdnnnlAEsRO4V6FfzmSYi-5WrO098dI4n3M,1502
+typefaster/net/token_store.py,sha256=yZsjNVot9tAEVw_G7_BoqFUKcbLHZ9kXh1WG_NQTc7Q,1504
 typefaster/services/__init__.py,sha256=4VngeItS-jc6-I71DsWkaWnvHODCni7ot4kiDICfMaw,79
 typefaster/services/container.py,sha256=79AR_skykXGsneXZx-LZ6ihbV8x8yzWBBnTQIzeUzK4,1143
-typefaster/services/daily_service.py,sha256=DpLGpa3Z53_-SOTYd4tTZB2VbwXJRyl8pwMZZoI6Iww,782
+typefaster/services/daily_service.py,sha256=xROI20AYUtoBn332Zn2QBg_4sEPU_Eptu4_O1Xap0Lk,1189
 typefaster/services/ghost_service.py,sha256=U6XPMDtgi8ORvf6w-mGpyZf8aiHaDD35zZ6F3cjzSsw,1676
 typefaster/services/profile_service.py,sha256=EquonTLismSHcs3HTQlUC_Rtt3uI3CT-Q5igFwRk220,473
 typefaster/services/race_service.py,sha256=BmTMIpjkHX9Wom7PeaWRXHUHuZ4siaVtq-iey2tfwIQ,5406
 typefaster/services/stats_service.py,sha256=yLP2hwubhqUr5rPxnxWX9n5PbINpgn9dQc1RANiYBeU,1912
 typefaster/ui/__init__.py,sha256=IbB-ajsaTRD4HS4zy-fNbpkv8_broTEEhJgl_1d93q4,72
-typefaster/ui/app.py,sha256=ki1Neeb2ErZiL3gvAgwwRJ1JPKa-H7hpZ_AJFaiibOE,3430
+typefaster/ui/app.py,sha256=wr95rqeTBYRjLMo4Mr4usGaxj9CI-QWYSDo50JbdGqg,3591
 typefaster/ui/online_app.py,sha256=PHycCB32LGho8hHx9sfJ-o-gyiDT82CUTRRVF5ov33Y,678
 typefaster/ui/theme.py,sha256=XzJFft9L3QP4qqUbbHmZ0v3ZeWodvcUY89PhsEHqlfs,1487
 typefaster/ui/screens/__init__.py,sha256=-L4TEWNuG14Jofv6FNRLMKYGYoNquB1HvGmYV3YXYus,23
-typefaster/ui/screens/_base.py,sha256=D-XqZBOwdINhtXUXjUfPReYA_aFRDuBAItGhXjH5Fmg,983
-typefaster/ui/screens/daily.py,sha256=h2pvI4_vDQedEU-JRPRpLz6f8Bop39wW5FZoOSZ6kkY,2343
+typefaster/ui/screens/_base.py,sha256=yNdf-HUSYgYM5-nNsM622DAiN1DvNDptY_gFH3hk0l0,1184
+typefaster/ui/screens/account.py,sha256=C9xf52ju2XGxA9mkGWqed8goTooZ7ZJmnfPYmsNGNLA,7749
+typefaster/ui/screens/daily.py,sha256=vjHMZ8TNXxNKDNMbyWDPvxcbQK_ff-M8YK0bRtyXuio,2580
 typefaster/ui/screens/help.py,sha256=OCzQlsGWzY7CwZMAcElGxMtBmao_KRjIFse7RuABtNE,788
 typefaster/ui/screens/history.py,sha256=PQ0f5F7aHv1E6pmJvsNNYlbm59HthwAHGtYR0bX_i8s,1073
 typefaster/ui/screens/leaderboard.py,sha256=kZhuixwIZLVsHaDjwsB258sQyMBZ9dYs2Y0QdRaFpKg,1968
-typefaster/ui/screens/main_menu.py,sha256=DSJTHypdT32ieckVn5AoR7BQJfH_qxpHnJwUgR3SX3A,3435
-typefaster/ui/screens/online_race.py,sha256=B1WILBarV66blhKDpxqJe0MEwesHFuviH_e-GlsCOkg,13132
+typefaster/ui/screens/lobby_browser.py,sha256=5upNsBBXd_jurXOv1IuQ-C94AvdVZzOzfR68bz209q8,6102
+typefaster/ui/screens/main_menu.py,sha256=HW2Zl8nk_YMZ5r07J51SJ86iShaUCCMu3kl3472j1Eg,4090
+typefaster/ui/screens/online_race.py,sha256=oVHi2FICWMPcEHYXQ0eS8I9Fa6OZInseKSPnGoPZbk8,13302
 typefaster/ui/screens/practice.py,sha256=6gvzVFYprGrbDClPArWM4COnzRi0zASrtnKjP6AREx8,2115
 typefaster/ui/screens/profile.py,sha256=1QiUkhMBH38q3Vkw5kx4O1LUZc8vrNtKF8q4p8GABAk,995
 typefaster/ui/screens/race.py,sha256=JlCxayx2W-fjnIza4ASK4Yg-UGkWSXDQv2YkndnxOMY,9961
@@ -54,8 +56,8 @@ typefaster/ui/widgets/bigtext.py,sha256=6naRaTuxke6tP0Q7j67KyvMsibTlRdhdiuEiszNd
 typefaster/ui/widgets/live_stats.py,sha256=Q17tvAOHanhf4qS78G59sLEY-mieAUyDjyvAZN8tAaw,683
 typefaster/ui/widgets/progress_bars.py,sha256=fZTh9a0KPVK1UnRq75Jf0YzSF4r85e3xn12oSUmIzmA,1392
 typefaster/ui/widgets/typing_field.py,sha256=gYKOjytwsMEU_k5Nu9mnYLBP4smNEw4bZ6lR27_m-k0,934
-typefaster_cli-0.1.3.dist-info/METADATA,sha256=2IntcvRgfG49mXXkrNp453vb_gMihS2Gm2DEvG6dXc4,5851
-typefaster_cli-0.1.3.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-typefaster_cli-0.1.3.dist-info/entry_points.txt,sha256=-ix_zmJiKj-cikp7-QfkxqB6MPIYCD0hiGd36Q-XlS8,50
-typefaster_cli-0.1.3.dist-info/licenses/LICENSE,sha256=ZrmIfNfrisYorCVzUnlZHoQZxJQB06oC_0lrNMkkXls,1079
-typefaster_cli-0.1.3.dist-info/RECORD,,
+typefaster_cli-0.2.0.dist-info/METADATA,sha256=ATYsxkT15-Yin4G-8cHJO8Xgbgnb0ffifEaUFblhNZ4,5014
+typefaster_cli-0.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+typefaster_cli-0.2.0.dist-info/entry_points.txt,sha256=-ix_zmJiKj-cikp7-QfkxqB6MPIYCD0hiGd36Q-XlS8,50
+typefaster_cli-0.2.0.dist-info/licenses/LICENSE,sha256=ZrmIfNfrisYorCVzUnlZHoQZxJQB06oC_0lrNMkkXls,1079
+typefaster_cli-0.2.0.dist-info/RECORD,,

typefaster_cli-0.1.3.dist-info/METADATA

@@ -1,156 +0,0 @@
-Metadata-Version: 2.4
-Name: typefaster-cli
-Version: 0.1.3
-Summary: A terminal-first typing game inspired by MonkeyType and TypeRacer.
-Project-URL: Homepage, https://github.com/Anoshor/typefaster-cli
-Project-URL: Repository, https://github.com/Anoshor/typefaster-cli
-Author: Anoshor Paul
-License: MIT
-License-File: LICENSE
-Keywords: cli,game,monkeytype,terminal,tui,typeracer,typing,wpm
-Classifier: Environment :: Console
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Games/Entertainment
-Requires-Python: >=3.11
-Requires-Dist: httpx>=0.27
-Requires-Dist: platformdirs>=4.2
-Requires-Dist: rich>=13.7
-Requires-Dist: textual>=0.60
-Requires-Dist: typer>=0.12
-Requires-Dist: websockets>=12.0
-Provides-Extra: dev
-Requires-Dist: black>=24.0; extra == 'dev'
-Requires-Dist: mypy>=1.10; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
-Requires-Dist: pytest-cov>=5.0; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: ruff>=0.5; extra == 'dev'
-Requires-Dist: textual-dev>=1.5; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# ⌨ TYPEFASTER-CLI
-
-[![CI](https://github.com/Anoshor/typefaster-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Anoshor/typefaster-cli/actions/workflows/ci.yml)
-[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
-
-A **terminal-first** typing game inspired by MonkeyType and TypeRacer.
-
-> Not a web app. Not a browser game. Not a desktop GUI.
-> A polished **Python terminal application** that works offline first, then scales to internet multiplayer.
-
-```bash
-typefaster
-```
-
-…and you're racing within seconds. No login, no server, no Docker, no internet required.
-
----
-
-## What Phase 1 delivers
-
-- **Instant offline races** — random quote, live WPM / accuracy / progress / timer.
-- **30 / 60 / 120 second** race modes.
-- **Ghost races** against your `personal-best`, `last`, or a `random` historical run, animated live.
-- **Local profile & stats** in SQLite — races played/won, best/avg WPM, best/avg accuracy, total chars, total time, full history.
-- **Daily challenge** — same quote for everyone each day, with a local daily leaderboard.
-- **Polished TUI** built on **Textual** + **Rich**, keyboard-only, resize-aware.
-
-## Planned CLI
-
-```bash
-typefaster                                   # launch straight into the game
-typefaster race --time 60 --ghost personal-best
-typefaster race --ghost last
-typefaster race --ghost random
-typefaster daily
-typefaster profile
-typefaster stats
-typefaster history
-```
-
----
-
-## Tech stack
-
-**Client (Phase 1):** Python 3.11+, Typer, Rich, Textual, SQLite (stdlib), platformdirs.
-**Server (Phase 2):** FastAPI, asyncio, WebSockets, Pydantic, Redis, Docker Compose.
-
-## Repository layout
-
-```
-typefaster-cli/
-├── client/typefaster/   # CLI app: domain · services · infra · ui · net · assets
-├── server/app/          # FastAPI server: routers · ws · repositories · security
-├── shared/              # shared schemas, WS protocol, scoring, anti-cheat
-├── infra/               # redis.conf · nginx.conf (TLS + WS proxy)
-├── docs/                # architecture, schemas, protocol, deployment, roadmap
-├── tests/               # client unit · integration · UI smoke
-├── scripts/             # quote dataset tooling
-├── docker-compose.yml   # redis + server (+ nginx via --profile proxy)
-├── pyproject.toml · Makefile · README.md
-```
-
-See [`docs/architecture.md`](docs/architecture.md) for the full design.
-
-## Online play (Phase 2)
-
-Run the server stack (Redis + FastAPI + WebSockets) with Docker:
-
-```bash
-cp .env.example .env       # set TYPEFASTER_JWT_SECRET
-make up                    # redis + server on :8000  (make up-proxy adds nginx TLS)
-```
-
-Then, from the client:
-
-```bash
-typefaster register alice          # create an account
-typefaster login alice
-typefaster lobby create --name "Friday Sprint" --time 60
-typefaster lobby join ABC123       # join a friend's private lobby
-typefaster lobby list              # browse public lobbies
-typefaster leaderboard global      # global | daily | weekly
-typefaster logout
-```
-
-The server is **authoritative**: it controls race start/finish, re-scores every
-result, and runs anti-cheat before writing leaderboards. See the docs:
-
-- [API specification](docs/api-spec.md)
-- [WebSocket protocol](docs/websocket-protocol.md)
-- [Redis schema](docs/redis-schema.md)
-- [Deployment guide (single Linux VM)](docs/deployment.md)
-
-The client points at `http://localhost:8000` by default; set `server_url` in
-`~/.config/typefaster/auth.json` to target a deployed server.
-
-## Development
-
-```bash
-make install   # editable install + dev deps
-make play      # launch the game
-make test      # pytest
-make lint      # ruff
-make typecheck # mypy
-make format    # black + ruff --fix
-make check     # lint + typecheck + test (CI parity)
-```
-
-> **Note on the monorepo layout:** the importable package lives at
-> `client/typefaster`. A normal install (`pip install .`, used by Docker and end
-> users) places it on the path automatically. For local development the
-> `Makefile` exports `PYTHONPATH=client`, so `make play` / `make test` always
-> work. If you invoke tools directly, prefix with `PYTHONPATH=client` (e.g.
-> `PYTHONPATH=client python -m typefaster`).
-
-## Design preferences locked for Phase 1
-
-- **Quotes:** curated public-domain set, tagged `short` / `medium` / `long` for difficulty buckets and 30/60/120s fit.
-- **Backspace:** allowed (MonkeyType-style) — corrections permitted, original errors still count toward accuracy; exposed as a Settings toggle.
-
-## License
-
-MIT.