Stage 7 (wip): UI shell, libs, mock transport, screens (lobby->game), e2e smoke

- plain Svelte 5 + TS + Vite (no SvelteKit); CSS-token design system (Telegram-ready), hash router, IndexedDB session - pure libs: domain model, premium/value maps ported from solver, board replay, placement state machine, i18n en/ru - in-memory mock transport + seed data; pnpm start runs lobby->active game->board with no backend - board: pointer-drag + tap placement, MakeMove (popup / 1s-hold commit), two-state zoom, blank chooser, exchange, hint, word-check, chat - Playwright smoke (mock) green; svelte-check clean; mock bundle ~37 KB gzip
2026-06-03 00:32:50 +02:00
parent 19ae8f04a2
commit 453ddc5e94
48 changed files with 5696 additions and 0 deletions
@@ -0,0 +1,84 @@
+// GatewayClient — the typed facade the screens call. Both the real Connect/
+// FlatBuffers transport and the in-memory mock implement it. Domain failures (the
+// gateway's result_code) and edge failures (Connect error codes) are normalised
+// into a thrown GatewayError carrying a stable `code` the UI maps to an i18n
+// message.
+
+import type {
+  ChatMessage,
+  EvalResult,
+  GameList,
+  GameView,
+  History,
+  HintResult,
+  MatchResult,
+  MoveResult,
+  Profile,
+  PushEvent,
+  Session,
+  StateView,
+  Tile,
+  Variant,
+  WordCheckResult,
+} from './model';
+
+/** GatewayError carries a stable code (the gateway result_code, or an edge code). */
+export class GatewayError extends Error {
+  readonly code: string;
+  constructor(code: string, message?: string) {
+    super(message ?? code);
+    this.name = 'GatewayError';
+    this.code = code;
+  }
+}
+
+/** A tile the player is submitting (rack/blank already resolved to a letter). */
+export interface PlacedTile {
+  row: number;
+  col: number;
+  letter: string;
+  blank: boolean;
+}
+
+/** Unsubscribe handle for the live stream. */
+export type Unsubscribe = () => void;
+
+export interface GatewayClient {
+  // --- auth (unauthenticated) ---
+  authGuest(locale?: string): Promise<Session>;
+  authEmailRequest(email: string): Promise<void>;
+  authEmailLogin(email: string, code: string): Promise<Session>;
+
+  // --- profile / lists ---
+  profileGet(): Promise<Profile>;
+  gamesList(): Promise<GameList>;
+
+  // --- lobby ---
+  lobbyEnqueue(variant: Variant): Promise<MatchResult>;
+  lobbyPoll(): Promise<MatchResult>;
+
+  // --- game ---
+  gameState(gameId: string): Promise<StateView>;
+  gameHistory(gameId: string): Promise<History>;
+  submitPlay(gameId: string, dir: 'H' | 'V', tiles: PlacedTile[]): Promise<MoveResult>;
+  pass(gameId: string): Promise<MoveResult>;
+  exchange(gameId: string, tiles: string[]): Promise<MoveResult>;
+  resign(gameId: string): Promise<MoveResult>;
+  hint(gameId: string): Promise<HintResult>;
+  evaluate(gameId: string, dir: 'H' | 'V', tiles: PlacedTile[]): Promise<EvalResult>;
+  checkWord(gameId: string, word: string): Promise<WordCheckResult>;
+  complaint(gameId: string, word: string, note: string): Promise<void>;
+
+  // --- chat ---
+  chatPost(gameId: string, body: string): Promise<ChatMessage>;
+  chatList(gameId: string): Promise<ChatMessage[]>;
+  nudge(gameId: string): Promise<ChatMessage>;
+
+  // --- live stream ---
+  subscribe(onEvent: (e: PushEvent) => void, onError?: (err: unknown) => void): Unsubscribe;
+
+  /** Set or clear the bearer token used for authenticated calls and the stream. */
+  setToken(token: string | null): void;
+}
+
+export type { GameView, Tile };