@fougere/app 0.6.0-alpha.0 → 0.7.0-alpha.0

package/src/web.ts

@@ -1,16 +1,4 @@
-/**
- * The three doors as Web-standard handlers: `Request` in, `Response` out.
- *
- * This is the whole server surface for any host built on fetch semantics — Next
- * route handlers, TanStack Start server routes, Hono, a bare `Deno.serve`. Such a
- * host mounts these; it does not translate anything, because there is nothing left
- * to translate.
- *
- * Nuxt is the exception and keeps its own translation, for a reason worth stating:
- * an h3 event is not a `Request`, and reading its body has to straddle two h3
- * majors (`server/routes/call.post.ts` carries that hundred lines). That file is
- * what a NON-Web-standard host costs.
- */
+/** The three doors as Web-standard handlers: `Request` in, `Response` out. */
 import { serveRest, serveRpc, rpcParseError, useFougereApp, serveGraphQL } from './index.js';
 import { MAX_BODY_BYTES } from '@fougere/core';
 import { sessionViewOf } from './session.js';
@@ -18,11 +6,7 @@ import { stateFor } from './state.js';
 
 const WITH_BODY = new Set(['POST', 'PUT', 'PATCH']);
 
-/**
- * The call envelope. A named surface is the path segment after the door —
- * `/_fougere/call/public` serves the `public` audience — and `surfaceOf` reads it,
- * so a host only has to mount this at a path that keeps the segments.
- */
+/** The call envelope. */
 export async function fougereCall(request: Request): Promise<Response> {
   const declared = Number(request.headers.get('content-length'));
   if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) {
@@ -46,14 +30,7 @@ export async function fougereCall(request: Request): Promise<Response> {
   );
 }
 
-/**
- * The REST projection, mounted under `/api`.
- *
- * `pass` — a path this app does not serve — becomes a 404 here rather than a
- * fall-through, because a Web handler has nobody to fall through to. Hosts that
- * resolve a static route before a catch-all (Next does) still let an app keep its
- * own `/api/*` handlers: they are reached BEFORE this one, not after.
- */
+/** The REST projection, mounted under `/api`. */
 export async function fougereRest(request: Request): Promise<Response> {
   const app = await useFougereApp();
   const url = new URL(request.url);
@@ -81,12 +58,7 @@ export async function fougereSession(request: Request): Promise<Response> {
   return Response.json(sessionViewOf(await stateFor(request.headers)));
 }
 
-/**
- * GraphQL, at whatever path the host mounted it — `/graphql` by convention.
- *
- * Answers `404` when the app declares no GraphQL adapter, because unlike REST this
- * door is mounted at a path of its own: there is no app route underneath it to pass to.
- */
+/** GraphQL, at whatever path the host mounted it — `/graphql` by convention. */
 export async function fougereGraphQL(request: Request): Promise<Response> {
   const app = await useFougereApp();
   const body = (await request.json().catch(() => ({}))) as {