chesspal 0.0.1 → 0.1.0

package/dist/server/page.d.ts

@@ -0,0 +1,46 @@
+import { type ServerResponse } from "node:http";
+import type { Context } from "../commands/context.ts";
+import { DrawRefused } from "../commands/draw-offer.ts";
+import { WordsRefused } from "../games/index.ts";
+import { Bell } from "./bell.ts";
+/** The page of a player's folder, served: its address, how to tell it the AI was given words, which change no file, and how to stop it. */
+export interface Page {
+    readonly url: string;
+    heard(): void;
+    /** The chat calls a tool: the page hears it listens, and the AI's clock, held while nobody heard the player, starts now. */
+    chatCalls(): void;
+    /** Whether a browser has the page open now: one listens to the game's changes. */
+    open(): boolean;
+    /** Opens the New game window on every page open now, for the player to choose the game there: whether one was open. */
+    askNewGame(): boolean;
+    close(): Promise<void>;
+}
+/**
+ * Serves the page of the context's folder on 127.0.0.1, on a port of its own when free, else on any free one, where the doorbell cannot find it. The page
+ * names the opponent as the host does, once it has connected; the doorbell knows from the context what the chat has read of the player's words.
+ */
+export declare function startPage(context: Context, opponent?: () => string | undefined): Promise<Page>;
+/** What the server keeps of its folder: the doorbell, and the pages that wait to hear the game has changed. */
+export interface Served {
+    /** The host's folder, which gives the page its ports and the doorbell its chat; the game is in the context's data folder (D-71). */
+    readonly folder: string;
+    readonly context: Context;
+    readonly opponent: () => string | undefined;
+    readonly bell: Bell;
+    readonly watchers: Set<ServerResponse>;
+    port: number;
+}
+/**
+ * A request refused, as the page reads it: the server's words, and the code of a refusal the page says in the player's language (T-11), with the characters
+ * left for words too long; without a code, the page shows the words.
+ */
+export interface Refused {
+    readonly error: string;
+    readonly refusal?: "no-game" | "ai-to-move" | "illegal" | "clear-chat" | `words-${WordsRefused["reason"]}` | `draw-${DrawRefused["reason"]}` | "profile-game" | "game-going" | "pgn-unreadable";
+    readonly most?: number;
+}
+/**
+ * The chat has read the game as it is now, at the end of a tool's call: the doorbell wakes it only for what changes it after; and, when the tool `showed` it
+ * the game, it moves on that position and no other until a tool shows it another (D-71). A game that cannot be read shows none.
+ */
+export declare function chatHasRead(context: Context, showed: boolean): void;