From 4de0a01464f8bd2efaa31e986e0f5218a73eadc1771af366a3ba3f3a70fcbc45 Mon Sep 17 00:00:00 2001
From: Lixen Wraith <lixen.wraith@gmail.com>
Date: Tue, 13 Oct 2026 20:26:00 -0400
Subject: [PATCH] v0.13.4 api update for deployment

---
 doc/deployment.md                             |  6 ++-
 doc/development.md                            |  2 +-
 doc/todo.md                                   |  3 +-
 .../server/webserver/chess-client-web/app.js  | 30 ++++-------
 internal/server/webserver/server.go           | 54 ++++++++++++-------
 internal/server/webserver/server_test.go      | 36 +++++++++++++
 6 files changed, 87 insertions(+), 44 deletions(-)

diff --git a/doc/deployment.md b/doc/deployment.md
index 2e51a8c..ac604da 100644
--- a/doc/deployment.md
+++ b/doc/deployment.md
@@ -208,8 +208,10 @@ Browser clients are static files published by the host, and must match the
 server's API paths:
 
 - **Web client:** copy `internal/server/webserver/chess-client-web/`
-  (`index.html`, `app.js`, `style.css`) to the site directory. Without the
-  embedded `/config` endpoint, it uses the `/chess` API prefix.
+  (`index.html`, `app.js`, `style.css`) to the site directory. It takes its
+  API base from its script element, `<script src="app.js" data-api="…">`,
+  which the embedded server sets from `-web-api-url`; without one, as copied,
+  it uses the `/chess` API prefix.
 - **WASM terminal client (if published):** `make wasm` (xterm.js is committed
   under `lib/`), then copy `web/chess-client-wasm/`. It derives its API base
   as `<origin>/chess`. Its API paths are compiled into `chess-client.wasm`,
diff --git a/doc/development.md b/doc/development.md
index 7f12e8f..6540785 100644
--- a/doc/development.md
+++ b/doc/development.md
@@ -37,7 +37,7 @@ go build ./cmd/chess-client-cli
 - `-finished-game-ttl`: How long terminal games stay in memory (default: `1h`; `0` disables eviction)
 - `-anonymous-game-ttl`: How long games without a registered player survive after their last activity, in memory and in the database (default: `24h`; `0` keeps them)
 - `-max-users`: Accounts at which public registration closes (default: `100`; `0` = no limit; the CLI is not limited)
-- `-web-api-url`: Browser-visible API origin for the embedded web client; useful when its public origin differs from the listen address
+- `-web-api-url`: Browser-visible API origin for the embedded web client, set on its script element as `data-api`; useful when its public origin differs from the listen address
 
 ### Modes
 ```bash
diff --git a/doc/todo.md b/doc/todo.md
index 280d94d..e9e5870 100644
--- a/doc/todo.md
+++ b/doc/todo.md
@@ -120,7 +120,8 @@ Constraints from the host's security headers:
   classes instead of inline style strings.
 - `img-src 'self' data:`: pieces remain Unicode glyphs or `data:` SVG.
 - `connect-src 'self'`: all requests go to the same origin under `/chess/`
-  (the existing `/config` fallback); no CDN or cross-origin API.
+  (the board's default API base, or the host's `data-api`); no CDN or
+  cross-origin API.
 - `frame-ancestors 'self'` and `X-Frame-Options: SAMEORIGIN`: the iframe host
   page must stay on the same origin. Downloads from `blob:` URLs and
   `navigator.clipboard` work in a same-origin frame.
diff --git a/internal/server/webserver/chess-client-web/app.js b/internal/server/webserver/chess-client-web/app.js
index 75b0bdb..d46c4f7 100644
--- a/internal/server/webserver/chess-client-web/app.js
+++ b/internal/server/webserver/chess-client-web/app.js
@@ -7,7 +7,7 @@ let gameState = {
     isLocked: false,
     polling: false,
     pollController: null,
-    apiUrl: '',
+    apiUrl: apiBase(document.currentScript),
     selectedSquare: null,
     healthCheckInterval: null,
     networkError: false,
@@ -49,10 +49,7 @@ function clearModalMessage(elementId) {
 }
 
 // Initialize on page load
-document.addEventListener('DOMContentLoaded', async () => {
-    const config = await getConfig();
-    gameState.apiUrl = config.apiUrl;
-
+document.addEventListener('DOMContentLoaded', () => {
     // Check for existing session on load
     restoreAuthSession();
 
@@ -471,21 +468,14 @@ function authFetch(url, options = {}) {
     return fetch(url, options);
 }
 
-async function getConfig() {
-    try {
-        const response = await fetch('./config', { cache: 'no-store' });
-        if (!response.ok) throw new Error(`config returned ${response.status}`);
-        const config = await response.json();
-        if (typeof config.apiUrl !== 'string' || !config.apiUrl.trim()) {
-            throw new Error('config is missing apiUrl');
-        }
-        return { apiUrl: config.apiUrl.replace(/\/+$/, '') };
-    } catch (error) {
-        // Static production hosting currently reverse-proxies the API here.
-        // The embedded server supplies /config and does not use this fallback.
-        console.debug('Using default API route:', error.message);
-        return { apiUrl: '/chess' };
-    }
+// The API base, from the page that loads this script: its element's data-api,
+// set by the embedded server from -web-api-url and by a host that publishes
+// the files itself. Without it, /chess, where a static host proxies the API.
+// "/" is the origin's root. Read while the script runs: document.currentScript
+// is null in any callback.
+function apiBase(script) {
+    const api = script?.dataset.api?.trim();
+    return api ? api.replace(/\/+$/, '') : '/chess';
 }
 
 function startHealthCheck() {
diff --git a/internal/server/webserver/server.go b/internal/server/webserver/server.go
index b215bde..4d47d98 100644
--- a/internal/server/webserver/server.go
+++ b/internal/server/webserver/server.go
@@ -3,6 +3,7 @@ package webserver
 import (
 	"embed"
 	"fmt"
+	"html"
 	"io/fs"
 	"strings"
 	"time"
@@ -39,36 +40,30 @@ func Start(host string, port int, apiURL string, logRequests bool) error {
 		return fmt.Errorf("failed to create web sub-filesystem: %w", err)
 	}
 
-	// API config endpoint, served before the static file handler
-	app.Get("/config", func(c *fiber.Ctx) error {
-		return c.JSON(fiber.Map{
-			"apiUrl": apiURL,
-		})
-	})
+	index, err := indexHTML(webContent, apiURL)
+	if err != nil {
+		return err
+	}
 
 	// Serve static files from the embedded client directory.
 	app.Get("*", func(c *fiber.Ctx) error {
-		path := c.Path()
-
-		// Default to index.html for the root path
-		if path == "/" {
-			path = "/index.html"
-		}
-
 		// The path for the embedded filesystem must not have a leading slash
-		fsPath := strings.TrimPrefix(path, "/")
+		fsPath := strings.TrimPrefix(c.Path(), "/")
+
+		sendIndex := func() error {
+			c.Set("Content-Type", "text/html; charset=utf-8")
+			return c.Send(index)
+		}
+		if fsPath == "" || fsPath == "index.html" {
+			return sendIndex()
+		}
 
 		// Try to read the file
 		data, err := fs.ReadFile(webContent, fsPath)
 		if err != nil {
 			// If the file isn't found, serve index.html for SPA-style routing
 			// This handles client-side routes that don't correspond to a file
-			data, err = fs.ReadFile(webContent, "index.html")
-			if err != nil {
-				return c.Status(fiber.StatusInternalServerError).SendString("index.html not found")
-			}
-			c.Set("Content-Type", "text/html; charset=utf-8")
-			return c.Send(data)
+			return sendIndex()
 		}
 
 		// Set the correct Content-Type based on file extension
@@ -89,3 +84,22 @@ func Start(host string, port int, apiURL string, logRequests bool) error {
 	addr := fmt.Sprintf("%s:%d", host, port)
 	return app.Listen(addr)
 }
+
+// boardScript is how index.html loads the board; indexHTML adds the API base.
+const boardScript = `<script src="app.js">`
+
+// indexHTML returns the client's index.html with the browser-visible API base
+// on the board's script element, data-api, which app.js reads as it runs: the
+// same attribute a host that publishes the files itself sets.
+func indexHTML(content fs.FS, apiURL string) ([]byte, error) {
+	data, err := fs.ReadFile(content, "index.html")
+	if err != nil {
+		return nil, fmt.Errorf("embedded index.html: %w", err)
+	}
+	page := string(data)
+	if n := strings.Count(page, boardScript); n != 1 {
+		return nil, fmt.Errorf("embedded index.html has %s %d times, want once", boardScript, n)
+	}
+	tag := fmt.Sprintf(`<script src="app.js" data-api="%s">`, html.EscapeString(apiURL))
+	return []byte(strings.Replace(page, boardScript, tag, 1)), nil
+}
diff --git a/internal/server/webserver/server_test.go b/internal/server/webserver/server_test.go
index a8042b3..23a84a9 100644
--- a/internal/server/webserver/server_test.go
+++ b/internal/server/webserver/server_test.go
@@ -2,7 +2,9 @@ package webserver
 
 import (
 	"io/fs"
+	"strings"
 	"testing"
+	"testing/fstest"
 )
 
 func TestEmbeddedWebClientRoot(t *testing.T) {
@@ -20,3 +22,37 @@ func TestEmbeddedWebClientRoot(t *testing.T) {
 		}
 	}
 }
+
+func TestIndexHTMLSetsAPIBase(t *testing.T) {
+	content, err := fs.Sub(webFS, "chess-client-web")
+	if err != nil {
+		t.Fatal(err)
+	}
+	for apiURL, want := range map[string]string{
+		"http://localhost:8080":     `<script src="app.js" data-api="http://localhost:8080">`,
+		`https://x.test/?a=1&b="2"`: `<script src="app.js" data-api="https://x.test/?a=1&amp;b=&#34;2&#34;">`,
+	} {
+		page, err := indexHTML(content, apiURL)
+		if err != nil {
+			t.Fatalf("%s: %v", apiURL, err)
+		}
+		if n := strings.Count(string(page), want); n != 1 {
+			t.Errorf("%s: index.html has %s %d times, want once", apiURL, want, n)
+		}
+		if strings.Contains(string(page), boardScript) {
+			t.Errorf("%s: index.html still loads the board without data-api", apiURL)
+		}
+	}
+}
+
+func TestIndexHTMLRefusesChangedScript(t *testing.T) {
+	for name, page := range map[string]string{
+		"absent": `<script src="./app.js"></script>`,
+		"twice":  `<script src="app.js"></script><script src="app.js"></script>`,
+	} {
+		content := fstest.MapFS{"index.html": {Data: []byte(page)}}
+		if _, err := indexHTML(content, "http://localhost:8080"); err == nil {
+			t.Errorf("%s: no error", name)
+		}
+	}
+}