npm - serverless-ircd - Versions diffs - 0.7.0 → 0.9.0 - Mend

serverless-ircd 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (168) hide show

package/.github/workflows/ci.yml +7 -3
package/.gitmodules +1 -1
package/CHANGELOG.md +518 -29
package/README.md +221 -161
package/apps/aws-stack/package.json +1 -1
package/apps/aws-stack/src/aws-stack.ts +186 -18
package/apps/aws-stack/tests/stack.test.ts +400 -56
package/apps/cf-tcp-container/package.json +1 -1
package/apps/cf-tcp-container/src/container-server.ts +21 -1
package/apps/cf-tcp-container/tests/config-loader.test.ts +43 -0
package/apps/cf-tcp-container/tests/container-server.test.ts +249 -1
package/apps/cf-tcp-container/tests/persistence.test.ts +9 -0
package/apps/cf-tcp-container/tests/tls-e2e.test.ts +24 -5
package/apps/cf-worker/package.json +1 -1
package/apps/cf-worker/src/worker.ts +4 -4
package/apps/cf-worker/tests/fixtures/web-dist/webclient/index.html +18 -0
package/apps/cf-worker/tests/smoke.test.ts +5 -5
package/apps/cf-worker/wrangler.test.toml +6 -6
package/apps/cf-worker/wrangler.toml +7 -5
package/apps/local-cli/package.json +1 -1
package/apps/local-cli/src/config-loader.ts +8 -0
package/apps/local-cli/src/main.ts +16 -0
package/apps/local-cli/src/server.ts +95 -31
package/apps/local-cli/tests/config-loader.test.ts +14 -0
package/apps/local-cli/tests/config-resolution.test.ts +65 -0
package/apps/local-cli/tests/motd-file-non-error.test.ts +29 -0
package/apps/local-cli/tests/rehash.test.ts +147 -0
package/apps/local-cli/tests/server-helpers.test.ts +63 -0
package/apps/local-cli/tests/tcp.test.ts +89 -0
package/apps/local-cli/tests/ws-subprotocol.test.ts +92 -0
package/apps/web/landing/index.html +237 -16
package/apps/web/package.json +3 -2
package/apps/web/scripts/build.mjs +46 -16
package/apps/web/src/build-env.ts +1 -1
package/apps/web/src/config-schema.ts +6 -6
package/apps/web/src/render-docs.ts +292 -0
package/apps/web/tests/build-smoke.test.ts +43 -14
package/apps/web/tests/config-schema.test.ts +1 -1
package/apps/web/tests/landing-content.test.ts +103 -0
package/apps/web/tests/render-docs.test.ts +198 -0
package/docs/AWS-Adapter-Architecture.md +3 -2
package/docs/AWS-Deployment.md +21 -8
package/docs/Cloudflare-Deployment-Guide.md +22 -6
package/docs/PlanExtensions.md +113 -3
package/docs/Release-Process.md +23 -13
package/docs/Services.md +578 -0
package/docs/WebClientGuide.md +32 -31
package/package.json +2 -2
package/packages/aws-adapter/package.json +1 -1
package/packages/aws-adapter/src/aws-runtime.ts +20 -1
package/packages/aws-adapter/src/cdk-table-defs.ts +6 -0
package/packages/aws-adapter/src/config-loader.ts +11 -0
package/packages/aws-adapter/src/connection-counter.ts +89 -0
package/packages/aws-adapter/src/dynamo-services-store.ts +649 -0
package/packages/aws-adapter/src/handlers/connect.ts +55 -51
package/packages/aws-adapter/src/handlers/default.ts +36 -4
package/packages/aws-adapter/src/handlers/index.ts +15 -0
package/packages/aws-adapter/src/handlers/nlb-stream.ts +25 -2
package/packages/aws-adapter/src/handlers/sweeper.ts +5 -1
package/packages/aws-adapter/src/index.ts +4 -0
package/packages/aws-adapter/src/stats.ts +6 -1
package/packages/aws-adapter/src/tables.ts +34 -4
package/packages/aws-adapter/tests/aws-harness.ts +3 -0
package/packages/aws-adapter/tests/aws-runtime.test.ts +23 -1
package/packages/aws-adapter/tests/config-loader.test.ts +8 -0
package/packages/aws-adapter/tests/connect.test.ts +158 -32
package/packages/aws-adapter/tests/connection-counter.test.ts +144 -0
package/packages/aws-adapter/tests/dynamo-services-store-dynamo.test.ts +183 -0
package/packages/aws-adapter/tests/dynamo-services-store-unit.test.ts +568 -0
package/packages/aws-adapter/tests/global-setup.ts +28 -1
package/packages/aws-adapter/tests/gone-exception.test.ts +21 -2
package/packages/aws-adapter/tests/handlers.test.ts +105 -3
package/packages/aws-adapter/tests/nlb-stream.test.ts +29 -1
package/packages/aws-adapter/tests/sweeper.test.ts +20 -0
package/packages/aws-adapter/tests/tables.test.ts +6 -1
package/packages/cf-adapter/package.json +1 -1
package/packages/cf-adapter/src/config-loader.ts +11 -0
package/packages/cf-adapter/src/connection-do.ts +130 -8
package/packages/cf-adapter/src/d1-services-store.ts +703 -0
package/packages/cf-adapter/src/env.ts +8 -0
package/packages/cf-adapter/src/index.ts +5 -0
package/packages/cf-adapter/tests/config-loader.test.ts +19 -0
package/packages/cf-adapter/tests/connection-do-nickserv-d1.test.ts +128 -0
package/packages/cf-adapter/tests/connection-do-pure.test.ts +130 -0
package/packages/cf-adapter/tests/connection-do.test.ts +150 -2
package/packages/cf-adapter/tests/d1-services-store.test.ts +582 -0
package/packages/cf-adapter/tests/serialize.test.ts +1 -0
package/packages/in-memory-runtime/package.json +1 -1
package/packages/irc-core/package.json +1 -1
package/packages/irc-core/scripts/generate-build-info.mjs +26 -5
package/packages/irc-core/src/commands/account-auth.ts +200 -0
package/packages/irc-core/src/commands/chanserv.ts +1166 -0
package/packages/irc-core/src/commands/hostserv.ts +522 -0
package/packages/irc-core/src/commands/index.ts +13 -0
package/packages/irc-core/src/commands/join.ts +171 -9
package/packages/irc-core/src/commands/markread.ts +202 -0
package/packages/irc-core/src/commands/memoserv.ts +319 -0
package/packages/irc-core/src/commands/mode.ts +96 -4
package/packages/irc-core/src/commands/nickserv.ts +402 -0
package/packages/irc-core/src/commands/oper.ts +18 -1
package/packages/irc-core/src/commands/operserv.ts +346 -0
package/packages/irc-core/src/commands/pre-away.ts +3 -1
package/packages/irc-core/src/commands/privmsg.ts +42 -0
package/packages/irc-core/src/commands/read-marker.ts +8 -8
package/packages/irc-core/src/commands/registration.ts +78 -12
package/packages/irc-core/src/commands/sasl.ts +18 -49
package/packages/irc-core/src/commands/service-aliases.ts +52 -0
package/packages/irc-core/src/commands/tagmsg.ts +41 -6
package/packages/irc-core/src/commands/topic.ts +60 -10
package/packages/irc-core/src/config.ts +36 -5
package/packages/irc-core/src/effects.ts +56 -1
package/packages/irc-core/src/ports.ts +1653 -84
package/packages/irc-core/src/protocol/numerics.ts +8 -0
package/packages/irc-core/src/state/channel.ts +38 -1
package/packages/irc-core/src/state/connection.ts +25 -1
package/packages/irc-core/src/types.ts +48 -12
package/packages/irc-core/tests/commands/chanserv.test.ts +2335 -0
package/packages/irc-core/tests/commands/chathistory.test.ts +6 -0
package/packages/irc-core/tests/commands/hostserv.test.ts +1006 -0
package/packages/irc-core/tests/commands/join.test.ts +572 -1
package/packages/irc-core/tests/commands/markread.test.ts +361 -0
package/packages/irc-core/tests/commands/memoserv.test.ts +654 -0
package/packages/irc-core/tests/commands/mode.test.ts +381 -2
package/packages/irc-core/tests/commands/nickserv.test.ts +990 -0
package/packages/irc-core/tests/commands/oper.test.ts +13 -0
package/packages/irc-core/tests/commands/operserv.test.ts +656 -0
package/packages/irc-core/tests/commands/privmsg.test.ts +147 -0
package/packages/irc-core/tests/commands/read-marker.test.ts +28 -28
package/packages/irc-core/tests/commands/registration.test.ts +1015 -20
package/packages/irc-core/tests/commands/sasl.test.ts +229 -12
package/packages/irc-core/tests/commands/server-info.test.ts +9 -5
package/packages/irc-core/tests/commands/service-aliases.test.ts +52 -0
package/packages/irc-core/tests/commands/tagmsg.test.ts +73 -33
package/packages/irc-core/tests/commands/topic.test.ts +94 -2
package/packages/irc-core/tests/commands/unified-account.test.ts +416 -0
package/packages/irc-core/tests/config.test.ts +49 -5
package/packages/irc-core/tests/effects.test.ts +19 -0
package/packages/irc-core/tests/message-store.test.ts +63 -0
package/packages/irc-core/tests/persistent-services-store.test.ts +582 -0
package/packages/irc-core/tests/services-store.test.ts +1289 -0
package/packages/irc-core/tests/state/channel.test.ts +3 -0
package/packages/irc-server/package.json +1 -1
package/packages/irc-server/src/actor.ts +121 -16
package/packages/irc-server/src/dispatch.ts +94 -7
package/packages/irc-server/src/routing.ts +19 -0
package/packages/irc-server/tests/actor.test.ts +988 -15
package/packages/irc-server/tests/dispatch.test.ts +270 -2
package/packages/irc-server/tests/routing.test.ts +6 -0
package/packages/irc-test-support/package.json +1 -1
package/packages/irc-test-support/src/in-memory-harness.ts +37 -8
package/packages/irc-test-support/src/index.ts +1 -0
package/packages/irc-test-support/src/scenarios.ts +21 -6
package/packages/irc-test-support/tests/in-memory-harness.test.ts +51 -0
package/packages/irc-test-support/vitest.config.ts +6 -1
package/tools/ci-hardening/package.json +1 -1
package/tools/load-test/package.json +1 -1
package/tools/load-test/src/client.ts +13 -13
package/tools/load-test/tests/client.test.ts +258 -2
package/tools/load-test/tests/config.test.ts +39 -0
package/tools/load-test/tests/harness.test.ts +21 -0
package/tools/load-test/tests/metrics.test.ts +7 -0
package/tools/tcp-ws-forwarder/package.json +1 -1
package/tools/tcp-ws-forwarder/tests/close-error.test.ts +40 -0
package/tools/tcp-ws-forwarder/tests/defensive-branches.test.ts +78 -0
package/tools/tcp-ws-forwarder/tests/forwarder.test.ts +53 -2
package/tools/tcp-ws-forwarder/tests/logger.test.ts +31 -1
package/apps/cf-worker/tests/fixtures/web-dist/app/index.html +0 -18
package/packages/irc-core/tests/read-marker-store.test.ts +0 -108

package/apps/web/src/render-docs.ts ADDED Viewed

@@ -0,0 +1,292 @@
+/**
+ * Markdown → static-HTML render pipeline for the `docs/` submodule.
+ *
+ * Renders every `docs/*.md` to a standalone HTML page under `dist/docs/` so
+ * the Worker `[assets]` binding serves them at `/docs/<name>.html` (and
+ * `/docs/` for the index — `Home.md` becomes `index.html`). Wired into the
+ * `apps/web` build by `scripts/build.mjs`.
+ *
+ * Extracted from the build script so the rendering pipeline is unit-testable
+ * without running the (heavy) Kiwi upstream SPA build.
+ */
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { marked } from 'marked';
+// GFM is on by default in marked v18+, but pin it explicitly so a future
+// upstream default flip can't silently change the rendered output. `async:
+// false` makes `.parse()` return a plain string (its return type is the
+// union `string | Promise<string>` — narrowed with a type assertion at the
+// call site).
+marked.use({ gfm: true, async: false });
+/** Basename of the docs landing page (rendered to `index.html`). */
+const HOME_SLUG = 'Home';
+/**
+ * Render GitHub-flavored markdown to an HTML fragment (no surrounding
+ * `<html>`/`<body>` — {@link buildDocs} wraps the result in a full page).
+ */
+export function renderMarkdown(md: string): string {
+  return marked.parse(md, { async: false }) as string;
+}
+/**
+ * Rewrite intra-docs links in already-rendered HTML so relative references
+ * resolve on the static site. Two source shapes are handled:
+ *
+ * 1. `[x](OtherDoc.md)` / `[x](./OtherDoc.md)` — Gitea-relative, emitted by
+ *    marked as `<a href="./OtherDoc.md">`.
+ * 2. `[x](OtherDoc)` — Gitea-wiki "bare" link (no extension), used heavily
+ *    in `Home.md` and `ADR-Index.md`.
+ *
+ * Only slugs present in `knownDocs` are rewritten, so external links, repo
+ * paths, and unknown targets are left untouched. Anchor fragments
+ * (`#section`) are preserved.
+ */
+export function rewriteDocLinks(html: string, knownDocs: Set<string>): string {
+  return html.replace(/href="([^"]*)"/g, (match, raw: string) => {
+    // Leave external URLs and pure-anchor links alone.
+    if (raw === '' || raw.startsWith('#') || /^(?:https?:|mailto:|tel:|data:)/i.test(raw)) {
+      return match;
+    }
+    const [pathPartRaw, ...fragParts] = raw.split('#');
+    const pathPart = pathPartRaw ?? '';
+    const fragment = fragParts.length > 0 ? `#${fragParts.join('#')}` : '';
+    const slug = pathPart.replace(/^\.\//, '').replace(/\.md$/i, '').trim();
+    if (slug === '' || !knownDocs.has(slug)) {
+      return match;
+    }
+    return `href="${slug}.html${fragment}"`;
+  });
+}
+export interface BuildDocsOptions {
+  /** Source directory containing the `*.md` files (typically the `docs/` submodule). */
+  srcDir: string;
+  /** Output directory to write the rendered site (typically `dist/docs/`). */
+  outDir: string;
+}
+export interface BuildDocsResult {
+  /** Relative names of the files written under `outDir`. */
+  emitted: string[];
+}
+/**
+ * Render every `*.md` under `srcDir` into a standalone HTML page under
+ * `outDir`. `Home.md` becomes `index.html`; every other file `<Slug>.md`
+ * becomes `<Slug>.html`. Throws a clear error if `srcDir` is missing or
+ * empty — the build script surfaces this so a stale `docs/` submodule
+ * checkout fails loudly (mirroring the Kiwi `upstream/` guard).
+ */
+export async function buildDocs({ srcDir, outDir }: BuildDocsOptions): Promise<BuildDocsResult> {
+  if (!existsSync(srcDir)) {
+    throw new Error(
+      `Docs source missing at ${srcDir}. Run \`git submodule update --init docs\` first.`,
+    );
+  }
+  const entries = await readdir(srcDir);
+  const mdFiles = entries.filter((f) => f.toLowerCase().endsWith('.md'));
+  if (mdFiles.length === 0) {
+    throw new Error(
+      `Docs source directory is empty at ${srcDir}. Run \`git submodule update --init docs\` first.`,
+    );
+  }
+  const knownSlugs = new Set(mdFiles.map((f) => f.replace(/\.md$/i, '')));
+  await mkdir(outDir, { recursive: true });
+  // Shared stylesheet — single source of truth for every page, mirroring the
+  // landing page's dark theme (CSS variables kept inline so the rendered
+  // docs work as static files served from any path).
+  await writeFile(path.join(outDir, 'docs.css'), DOCS_CSS, 'utf8');
+  const emitted: string[] = [];
+  for (const file of mdFiles) {
+    const slug = file.replace(/\.md$/i, '');
+    const md = await readFile(path.join(srcDir, file), 'utf8');
+    const body = rewriteDocLinks(renderMarkdown(md), knownSlugs);
+    const title = extractTitle(md) ?? slug;
+    const outName = slug === HOME_SLUG ? 'index.html' : `${slug}.html`;
+    const html = wrapPage(title, body, slug === HOME_SLUG);
+    await writeFile(path.join(outDir, outName), html, 'utf8');
+    emitted.push(outName);
+  }
+  return { emitted };
+}
+/** Extract the first ATX `# Heading` as the page title; `undefined` if none. */
+function extractTitle(md: string): string | undefined {
+  const match = md.match(/^#\s+(.+?)\s*$/m);
+  return match?.[1];
+}
+/** Escape the four significant HTML characters in a text string. */
+function escapeHtml(s: string): string {
+  return s
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+/** Wrap a rendered HTML fragment in a full page with the shared stylesheet. */
+function wrapPage(title: string, body: string, isIndex: boolean): string {
+  const back = isIndex ? '' : '<p class="back"><a href="./index.html">Docs home</a></p>';
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(title)} — ServerlessIRCd Docs</title>
+    <link rel="stylesheet" href="./docs.css" />
+  </head>
+  <body>
+    <header>
+      <div class="container">
+        <h1><a href="./index.html">ServerlessIRCd Docs</a></h1>
+      </div>
+    </header>
+    <main class="container">
+      ${back}
+      <article>
+${body}
+      </article>
+    </main>
+    <footer>
+      <div class="container">
+        <p><a href="/">Back to landing</a></p>
+      </div>
+    </footer>
+  </body>
+</html>
+`;
+}
+const DOCS_CSS = `:root {
+  --bg: #0d1117;
+  --surface: #161b22;
+  --border: #30363d;
+  --text: #e6edf3;
+  --muted: #8b949e;
+  --accent: #58a6ff;
+  --accent-hover: #79c0ff;
+  --mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas,
+    "Liberation Mono", monospace;
+  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial,
+    sans-serif;
+}
+* { box-sizing: border-box; }
+html { -webkit-text-size-adjust: 100%; }
+body {
+  margin: 0;
+  font-family: var(--sans);
+  line-height: 1.6;
+  color: var(--text);
+  background-color: var(--bg);
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+.container {
+  width: 100%;
+  max-width: 820px;
+  margin: 0 auto;
+  padding: 0 20px;
+}
+header {
+  padding: 24px 0 14px;
+  border-bottom: 1px solid var(--border);
+}
+header h1 {
+  margin: 0;
+  font-size: 1.4rem;
+  letter-spacing: -0.02em;
+}
+header h1 a {
+  color: var(--accent);
+  text-decoration: none;
+}
+header h1 a:hover { text-decoration: underline; }
+main { flex: 1 0 auto; padding: 28px 0; }
+article {
+  font-size: 1rem;
+  overflow-wrap: break-word;
+}
+article h1, article h2, article h3, article h4 {
+  letter-spacing: -0.01em;
+  line-height: 1.25;
+  margin-top: 1.6em;
+  margin-bottom: 0.6em;
+}
+article h1 { font-size: 1.7rem; margin-top: 0; }
+article h2 { font-size: 1.35rem; border-bottom: 1px solid var(--border); padding-bottom: 0.3em; }
+article h3 { font-size: 1.12rem; }
+article h4 { font-size: 1rem; color: var(--accent-hover); }
+article p { margin: 0.8em 0; }
+article a { color: var(--accent); text-decoration: none; }
+article a:hover { text-decoration: underline; }
+article ul, article ol { padding-left: 1.6em; }
+article li { margin: 0.25em 0; }
+article blockquote {
+  margin: 0.9em 0;
+  padding: 0.4em 1em;
+  border-left: 3px solid var(--border);
+  color: var(--muted);
+}
+article blockquote p { margin: 0.4em 0; }
+article code {
+  font-family: var(--mono);
+  background-color: var(--surface);
+  padding: 2px 6px;
+  border-radius: 4px;
+  font-size: 0.9em;
+}
+article pre {
+  font-family: var(--mono);
+  background-color: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 14px 16px;
+  margin: 12px 0;
+  overflow-x: auto;
+  line-height: 1.5;
+  font-size: 0.88rem;
+}
+article pre code {
+  background: none; border: none; padding: 0; font-size: inherit;
+}
+article table {
+  border-collapse: collapse;
+  margin: 1em 0;
+  display: block;
+  overflow-x: auto;
+}
+article table th, article table td {
+  border: 1px solid var(--border);
+  padding: 6px 12px;
+  text-align: left;
+}
+article table th { background-color: var(--surface); }
+article hr {
+  border: none;
+  border-top: 1px solid var(--border);
+  margin: 1.6em 0;
+}
+article img { max-width: 100%; }
+.back { margin-top: 0; color: var(--muted); font-size: 0.92rem; }
+.back a { color: var(--accent); }
+footer {
+  flex-shrink: 0;
+  padding: 18px 0;
+  border-top: 1px solid var(--border);
+  color: var(--muted);
+  font-size: 0.9rem;
+}
+footer a { color: var(--muted); text-decoration: none; }
+footer a:hover { color: var(--accent); }
+`;

package/apps/web/tests/build-smoke.test.ts CHANGED Viewed

@@ -5,7 +5,7 @@ import { describe, expect, it } from 'vitest';
 import { parseKiwiConfig } from '../src/config-schema';
 const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const appDist = path.join(pkgRoot, 'dist', 'app');
+const appDist = path.join(pkgRoot, 'dist', 'webclient');
 const indexPath = path.join(appDist, 'index.html');
 const landingSrc = path.join(pkgRoot, 'landing', 'index.html');
 const landingDist = path.join(pkgRoot, 'dist', 'index.html');
@@ -19,12 +19,12 @@ const built = existsSync(indexPath);
 // artifact; gate the build-output assertion on its own presence.
 const landingBuilt = existsSync(landingDist) && statSync(landingDist).size > 0;
-describe.skipIf(!built)('Kiwi SPA build output (dist/app/)', () => {
-  it('emits dist/app/index.html', () => {
+describe.skipIf(!built)('Kiwi SPA build output (dist/webclient/)', () => {
+  it('emits dist/webclient/index.html', () => {
     expect(existsSync(indexPath)).toBe(true);
   });
-  it('layers a schema-valid static/config.json into dist/app/static/config.json', () => {
+  it('layers a schema-valid static/config.json into dist/webclient/static/config.json', () => {
     const configPath = path.join(appDist, 'static', 'config.json');
     expect(existsSync(configPath)).toBe(true);
     // The baked config must clear the Zod schema no matter which --env was
@@ -34,17 +34,17 @@ describe.skipIf(!built)('Kiwi SPA build output (dist/app/)', () => {
     expect(cfg.startupOptions.channel.startsWith('#')).toBe(true);
   });
-  it('prefixes every asset reference with /app/', () => {
+  it('prefixes every asset reference with /webclient/', () => {
     const html = readFileSync(indexPath, 'utf8');
     // No bare relative `static/...` references may remain.
     const bareStaticRefs = html.match(/(?:src|href)=["']static\//g) ?? [];
     expect(bareStaticRefs).toEqual([]);
-    // At least one asset must be /app/-prefixed (the main bundle).
-    const appPrefixed = html.match(/(?:src|href)=["']\/app\/static\//g) ?? [];
+    // At least one asset must be /webclient/-prefixed (the main bundle).
+    const appPrefixed = html.match(/(?:src|href)=["']\/webclient\/static\//g) ?? [];
     expect(appPrefixed.length).toBeGreaterThan(0);
   });
-  it('ships a hashed JS bundle under dist/app/static/js/', () => {
+  it('ships a hashed JS bundle under dist/webclient/static/js/', () => {
     const jsDir = path.join(appDist, 'static', 'js');
     expect(existsSync(jsDir)).toBe(true);
     const js = readdirSync(jsDir).filter((f) => f.endsWith('.js'));
@@ -65,19 +65,19 @@ describe('landing page source (landing/index.html)', () => {
     expect(html).toContain('<title>');
   });
-  it('links to the IRC client at /app/', () => {
+  it('links to the IRC client at /webclient/', () => {
     const html = readFileSync(landingSrc, 'utf8');
-    expect(html).toMatch(/href=["']\/app\/?["']/);
+    expect(html).toMatch(/href=["']\/webclient\/?["']/);
   });
-  it('links to the project docs', () => {
+  it('links to the rendered project docs at /docs/', () => {
     const html = readFileSync(landingSrc, 'utf8');
-    expect(html).toMatch(/href=["'][^"']*docs\/?["']/);
+    expect(html).toMatch(/href=["']\/docs\/?["']/);
   });
-  it('links to the source repository', () => {
+  it('links to the source repository on Gitea', () => {
     const html = readFileSync(landingSrc, 'utf8');
-    expect(html.toLowerCase()).toMatch(/github\.com/);
+    expect(html.toLowerCase()).toMatch(/gitea\.com/);
   });
   it('is responsive (declares a viewport meta tag)', () => {
@@ -101,3 +101,32 @@ describe.skipIf(!landingBuilt)('landing page build output (dist/index.html)', ()
     expect(dist).toBe(src);
   });
 });
+// Validates the docs/ build pass: `pnpm --filter web build` renders every
+// `docs/*.md` to standalone HTML under `dist/docs/` so the Worker `[assets]`
+// binding serves them at `/docs/<name>.html` (and `/docs/` for the index).
+// Gated on the directory's presence — like the Kiwi SPA gate above — so CI
+// can run this test file without paying the heavy SPA build cost; the
+// pipeline runs in full via `apps/web/tests/render-docs.test.ts`.
+const docsDist = path.join(pkgRoot, 'dist', 'docs');
+const docsBuilt = existsSync(docsDist) && statSync(docsDist).size > 0;
+describe.skipIf(!docsBuilt)('docs build output (dist/docs/)', () => {
+  it('emits dist/docs/index.html', () => {
+    expect(existsSync(path.join(docsDist, 'index.html'))).toBe(true);
+  });
+  it('emits Services.html with rendered HTML (an <h1>, not raw markdown)', () => {
+    const target = path.join(docsDist, 'Services.html');
+    expect(existsSync(target)).toBe(true);
+    const html = readFileSync(target, 'utf8');
+    expect(html).toMatch(/<h1[^>]*>/);
+    // The markdown H1 marker must not survive rendering.
+    expect(html).not.toMatch(/^# IRC Services Reference/m);
+  });
+  it('shares a stylesheet (a .css file is emitted alongside the HTML)', () => {
+    const css = readdirSync(docsDist).filter((f) => f.endsWith('.css'));
+    expect(css.length).toBeGreaterThanOrEqual(1);
+  });
+});

package/apps/web/tests/config-schema.test.ts CHANGED Viewed

@@ -250,7 +250,7 @@ describe('KiwiConfigSchema — WS path (direct_path)', () => {
     expect(() =>
       parseKiwiConfig(
         validConfig({
-          startupOptions: validStartupOptions({ direct_path: '/app/' }),
+          startupOptions: validStartupOptions({ direct_path: '/webclient/' }),
         }),
       ),
     ).toThrowError(/direct_path/u);

package/apps/web/tests/landing-content.test.ts ADDED Viewed

@@ -0,0 +1,103 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const landingSrc = path.join(pkgRoot, 'landing', 'index.html');
+// Pure-string assertions over landing/index.html. The file is copied verbatim
+// to dist/index.html by scripts/build.mjs (verified separately by
+// build-smoke.test.ts), so these checks run against the source in CI without
+// paying the Kiwi SPA build cost.
+const html = readFileSync(landingSrc, 'utf8');
+describe('landing page "Connect" section', () => {
+  it('contains a "Connect" heading', () => {
+    // The project front door must tell visitors how to reach the IRC server.
+    expect(html).toMatch(/<h2[^>]*>\s*Connect\s*<\/h2>/i);
+  });
+  it('documents the WeeChat client', () => {
+    expect(html).toMatch(/WeeChat/i);
+  });
+  it('documents the HexChat client', () => {
+    expect(html).toMatch(/HexChat/i);
+  });
+  it('documents the irssi client', () => {
+    expect(html).toMatch(/irssi/i);
+  });
+  it('documents the IRCCloud client', () => {
+    expect(html).toMatch(/IRCCloud/i);
+  });
+  it('documents TheLounge client', () => {
+    expect(html).toMatch(/TheLounge/i);
+  });
+  it('mentions the wss (secure WebSocket) transport for the web client', () => {
+    expect(html).toMatch(/\bwss\b/i);
+  });
+  it('mentions port 443 for the wss transport', () => {
+    expect(html).toMatch(/443\b/);
+  });
+  it('mentions the irc+tls :6697 direct-connect transport', () => {
+    expect(html).toMatch(/6697\b/);
+  });
+  it('hides the low-level WebSocket subprotocol framing detail', () => {
+    // The subprotocol negotiation + 510-byte frame budget is IRC-wire-level
+    // detail that doesn't belong on the project front door. It lives in the
+    // docs; the page should not surface `text.ircv3.net` or the 510 figure.
+    expect(html).not.toMatch(/text\.ircv3\.net/i);
+    expect(html).not.toMatch(/\b510\b/);
+  });
+  it('links to the Web Client Guide doc', () => {
+    // Cross-references to the docs/ subtree keep the page terse while still
+    // pointing at full instructions. The docs are out-of-tree (git submodule)
+    // so the link is a relative repo path, not a served route.
+    expect(html).toMatch(/WebClientGuide/i);
+  });
+  it('references the tcp-ws-forwarder bridge for stock TCP clients', () => {
+    expect(html).toMatch(/tcp-ws-forwarder/i);
+  });
+  it('uses a generic hostname placeholder (no per-env host baked in)', () => {
+    // The landing page is built once and served across staging + prod, so it
+    // must NOT pin a concrete worker hostname.
+    expect(html).toMatch(/irc\.example\.com|{{\s*hostname\s*}}|your deployed Worker host/i);
+  });
+  it('includes a WeeChat /server add snippet', () => {
+    expect(html).toMatch(/\/server add/i);
+  });
+  it('renders the connect instructions as a radio-backed client tab picker', () => {
+    // A horizontal list of client "buttons" selects which instructions show.
+    // Radio inputs share one name so the picker works without JavaScript
+    // (the build-smoke suite asserts the page ships no <script> tags).
+    const tabRadios = html.match(/type=["']radio["'][^>]*name=["']client-tab["']/gi) ?? [];
+    expect(tabRadios.length).toBeGreaterThanOrEqual(4);
+  });
+  it('renders a tab label for each documented client', () => {
+    expect(html).toMatch(/<label[^>]*for=["']tab-web["']/i);
+    expect(html).toMatch(/<label[^>]*for=["']tab-weechat["']/i);
+    expect(html).toMatch(/<label[^>]*for=["']tab-hexchat["']/i);
+    expect(html).toMatch(/<label[^>]*for=["']tab-irccloud["']/i);
+  });
+  it('hides client panels by default and reveals the selected one via :checked', () => {
+    // Pure-CSS tabs: panels are display:none unless their radio is checked,
+    // then `:checked ~ #panel-x` flips them to display:block.
+    expect(html).toMatch(/\.panel\s*\{[^}]*display:\s*none/i);
+    expect(html).toMatch(/:checked\s*~\s*#panel-/i);
+  });
+});