@sigil-dev/grimoire 0.9.3 → 0.9.5

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 (78) hide show
  1. package/index.ts +37 -35
  2. package/package.json +9 -12
  3. package/preload.js +3 -3
  4. package/server.ts +19 -19
  5. package/src/client/deps.ts +36 -19
  6. package/src/client/enhance.ts +102 -98
  7. package/src/client/head.ts +30 -30
  8. package/src/client/index.ts +2 -2
  9. package/src/client/router.ts +174 -68
  10. package/src/client/scope.ts +22 -22
  11. package/src/dev/compile-module.ts +215 -163
  12. package/src/dev/effect-registry.ts +23 -23
  13. package/src/dev/graph.ts +109 -114
  14. package/src/dev/hmr-client.ts +202 -185
  15. package/src/dev/hmr-server.ts +261 -187
  16. package/src/dev/loader.ts +120 -47
  17. package/src/dev/paths.ts +14 -14
  18. package/src/dev/resolve.ts +70 -0
  19. package/src/dev/runtime-bundle.ts +52 -52
  20. package/src/dev/scan.ts +78 -0
  21. package/src/dev/watcher.ts +69 -47
  22. package/src/env/dynamic-private.ts +19 -19
  23. package/src/env/dynamic-public.ts +22 -22
  24. package/src/env/index.ts +25 -25
  25. package/src/env/plugin.ts +19 -19
  26. package/src/env/private.ts +5 -5
  27. package/src/env/public.ts +7 -7
  28. package/src/env/typegen.ts +61 -61
  29. package/src/headers.ts +114 -114
  30. package/src/integrations/vite.ts +73 -73
  31. package/src/logger/index.ts +4 -4
  32. package/src/logger/instance.ts +6 -6
  33. package/src/logger/logger.ts +113 -113
  34. package/src/logger/request-middleware.ts +24 -24
  35. package/src/logger/transports.ts +117 -117
  36. package/src/logger/types.ts +39 -39
  37. package/src/rendering/head.ts +52 -47
  38. package/src/rendering/hydrate.ts +159 -138
  39. package/src/rendering/index.ts +140 -18
  40. package/src/rendering/ssrPlugin.ts +78 -69
  41. package/src/routing/manifest-gen.ts +13 -1
  42. package/src/routing/router.ts +135 -109
  43. package/src/routing/scanner.ts +196 -141
  44. package/src/routing/transform-routes.ts +102 -102
  45. package/src/sentinels/error.ts +52 -52
  46. package/src/sentinels/fail.ts +41 -41
  47. package/src/sentinels/redirect.ts +35 -35
  48. package/src/server/build.ts +250 -243
  49. package/src/server/context.ts +10 -10
  50. package/src/server/cookie-utils.ts +66 -66
  51. package/src/server/coordinator.ts +364 -364
  52. package/src/server/hooks.ts +114 -114
  53. package/src/server/index.ts +711 -655
  54. package/src/server/interactive.ts +56 -56
  55. package/src/server/plugins.ts +121 -121
  56. package/src/server/worker.ts +58 -58
  57. package/src/typegen/index.ts +389 -356
  58. package/src/types.ts +286 -282
  59. package/test/client-router.test.ts +295 -44
  60. package/test/context.test.ts +52 -52
  61. package/test/env.test.ts +90 -90
  62. package/test/exports.test.ts +37 -37
  63. package/test/fail.test.ts +46 -46
  64. package/test/headers.test.ts +100 -100
  65. package/test/hmr.test.ts +426 -0
  66. package/test/hydration.test.ts +119 -119
  67. package/test/middleware.test.ts +223 -223
  68. package/test/preload.ts +5 -5
  69. package/test/redirect-error.test.ts +112 -112
  70. package/test/rendering.test.ts +719 -615
  71. package/test/routing.test.ts +197 -81
  72. package/test/scanning.test.ts +314 -200
  73. package/test/scope.test.ts +195 -195
  74. package/test/server.test.ts +360 -249
  75. package/test/streaming.test.ts +242 -125
  76. package/test/transform-routes.test.ts +87 -84
  77. package/test/typegen.test.ts +697 -682
  78. package/tsconfig.json +10 -10
@@ -1,249 +1,360 @@
1
- import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
- import { mkdir, writeFile } from "node:fs/promises";
3
- import { tmpdir } from "node:os";
4
- import { join } from "node:path";
5
- import { createServer } from "../src/server";
6
-
7
- // ── Sandbox note ─────────────────────────────────────────────────────────────
8
- // The Babel plugin unconditionally inserts `import ... from "@sigil-dev/runtime"`
9
- // for all non-SSR route files. When createServer() calls Bun.build to bundle hydrate.js,
10
- // those compiled page files pull in @sigil-dev/runtime → Bun's test sandbox blocks the
11
- // read of packages/runtime/index.ts.
12
- //
13
- // Consequence: createServer() integration tests can only use +server.ts API routes
14
- // (which are never bundled by Bun.build). Form action behavior at the HTTP level cannot
15
- // be tested here — it is covered at unit level by fail.test.ts and redirect-error.test.ts,
16
- // and at the renderer level by rendering.test.ts.
17
- // ─────────────────────────────────────────────────────────────────────────────
18
-
19
- let tmpDir: string;
20
-
21
- beforeAll(async () => {
22
- tmpDir = join(tmpdir(), `grimoire-server-${Date.now()}`);
23
- await mkdir(join(tmpDir, "api", "hello"), { recursive: true });
24
- await mkdir(join(tmpDir, "api", "items"), { recursive: true });
25
-
26
- await writeFile(
27
- join(tmpDir, "api", "hello", "+server.ts"),
28
- `export async function GET() { return Response.json({ message: "hello" }); }`,
29
- );
30
-
31
- await writeFile(
32
- join(tmpDir, "api", "items", "+server.ts"),
33
- `export async function GET() {
34
- return Response.json([{ id: 1, name: "sword" }]);
35
- }
36
- export async function POST({ request }) {
37
- const body = await request.json();
38
- return Response.json({ id: 2, ...body }, { status: 201 });
39
- }`,
40
- );
41
- });
42
-
43
- describe("Server — API routes (+server.ts)", () => {
44
- test("GET returns JSON", async () => {
45
- const server = await createServer({
46
- port: 3004,
47
- routes: tmpDir,
48
- _skipBuild: true,
49
- });
50
- const res = await fetch("http://localhost:3004/api/hello");
51
- const data = await res.json();
52
- expect(data.message).toBe("hello");
53
- server.stop();
54
- });
55
-
56
- test("GET on multi-method route returns correct JSON", async () => {
57
- const server = await createServer({
58
- port: 3004,
59
- routes: tmpDir,
60
- _skipBuild: true,
61
- });
62
- const res = await fetch("http://localhost:3004/api/items");
63
- expect(res.status).toBe(200);
64
- const items = await res.json();
65
- expect(items[0].name).toBe("sword");
66
- server.stop();
67
- });
68
-
69
- test("POST returns 201 with created resource", async () => {
70
- const server = await createServer({
71
- port: 3004,
72
- routes: tmpDir,
73
- _skipBuild: true,
74
- });
75
- const res = await fetch("http://localhost:3004/api/items", {
76
- method: "POST",
77
- headers: { "Content-Type": "application/json" },
78
- body: JSON.stringify({ name: "shield" }),
79
- });
80
- expect(res.status).toBe(201);
81
- const item = await res.json();
82
- expect(item.name).toBe("shield");
83
- server.stop();
84
- });
85
-
86
- test("unsupported method returns 405", async () => {
87
- const server = await createServer({
88
- port: 3004,
89
- routes: tmpDir,
90
- _skipBuild: true,
91
- });
92
- const res = await fetch("http://localhost:3004/api/items", {
93
- method: "DELETE",
94
- });
95
- expect(res.status).toBe(405);
96
- server.stop();
97
- });
98
- });
99
-
100
- describe("Server — WebSocket routes", () => {
101
- let wsDir: string;
102
- let server: Awaited<ReturnType<typeof createServer>>;
103
-
104
- beforeAll(async () => {
105
- wsDir = join(tmpdir(), `grimoire-ws-${Date.now()}`);
106
- await mkdir(join(wsDir, "echo"), { recursive: true });
107
- await mkdir(join(wsDir, "params", "[docId]"), { recursive: true });
108
- await mkdir(join(wsDir, "reject"), { recursive: true });
109
- await mkdir(join(wsDir, "mixed"), { recursive: true });
110
-
111
- // echo: upgrade() merges extra data, message handler echoes back
112
- await writeFile(
113
- join(wsDir, "echo", "+server.ts"),
114
- `export function upgrade({ params }) {
115
- return { sessionId: "abc123" };
116
- }
117
- export const websocket = {
118
- message(ws, data) { ws.send("echo:" + data); },
119
- };`,
120
- );
121
-
122
- // params: no upgrade(), ws.data.params still available
123
- await writeFile(
124
- join(wsDir, "params", "[docId]", "+server.ts"),
125
- `export const websocket = {
126
- open(ws) { ws.send("docId:" + ws.data.params.docId); },
127
- };`,
128
- );
129
-
130
- // reject: upgrade() throws → 426
131
- await writeFile(
132
- join(wsDir, "reject", "+server.ts"),
133
- `export function upgrade() {
134
- throw new Error("Unauthorized");
135
- }
136
- export const websocket = {
137
- message(ws, data) { ws.send(data); },
138
- };`,
139
- );
140
-
141
- // mixed: HTTP GET and WebSocket both exported
142
- await writeFile(
143
- join(wsDir, "mixed", "+server.ts"),
144
- `export function GET() {
145
- return Response.json({ kind: "http" });
146
- }
147
- export function upgrade({ params }) { return {}; }
148
- export const websocket = {
149
- message(ws, data) { ws.send(data); },
150
- };`,
151
- );
152
-
153
- server = await createServer({
154
- port: 3005,
155
- routes: wsDir,
156
- _skipBuild: true,
157
- });
158
- });
159
-
160
- afterAll(() => {
161
- server.stop();
162
- });
163
-
164
- function wsConnect(path: string): Promise<WebSocket> {
165
- return new Promise((resolve, reject) => {
166
- const ws = new WebSocket(`ws://localhost:3005${path}`);
167
- ws.onopen = () => resolve(ws);
168
- ws.onerror = () =>
169
- reject(new Error(`WebSocket connection failed: ${path}`));
170
- });
171
- }
172
-
173
- function nextMessage(ws: WebSocket): Promise<string> {
174
- return new Promise((resolve, reject) => {
175
- const timer = setTimeout(
176
- () => reject(new Error("timeout waiting for message")),
177
- 2000,
178
- );
179
- ws.onmessage = (ev) => {
180
- clearTimeout(timer);
181
- resolve(String(ev.data));
182
- };
183
- ws.onerror = () => {
184
- clearTimeout(timer);
185
- reject(new Error("ws error"));
186
- };
187
- });
188
- }
189
-
190
- test("message is echoed back", async () => {
191
- const ws = await wsConnect("/echo");
192
- const pending = nextMessage(ws);
193
- ws.send("hello");
194
- expect(await pending).toBe("echo:hello");
195
- ws.close();
196
- });
197
-
198
- test("upgrade() return value merges into ws.data", async () => {
199
- // sessionId set in upgrade() — echo route sends it back via a second message
200
- const ws = new WebSocket("ws://localhost:3005/echo");
201
- // just verify connection opens cleanly (sessionId is in ws.data server-side)
202
- await new Promise<void>((resolve, reject) => {
203
- const t = setTimeout(() => reject(new Error("timeout")), 2000);
204
- ws.onopen = () => {
205
- clearTimeout(t);
206
- resolve();
207
- };
208
- ws.onerror = () => {
209
- clearTimeout(t);
210
- reject(new Error("connect failed"));
211
- };
212
- });
213
- ws.close();
214
- });
215
-
216
- test("ws.data.params available when no upgrade() export", async () => {
217
- const ws = await wsConnect("/params/42");
218
- expect(await nextMessage(ws)).toBe("docId:42");
219
- ws.close();
220
- });
221
-
222
- test("upgrade() throwing rejects the connection", async () => {
223
- await new Promise<void>((resolve, reject) => {
224
- const ws = new WebSocket("ws://localhost:3005/reject");
225
- const t = setTimeout(() => reject(new Error("timeout")), 2000);
226
- ws.onopen = () => {
227
- clearTimeout(t);
228
- ws.close();
229
- reject(new Error("should not have opened"));
230
- };
231
- ws.onerror = () => {
232
- clearTimeout(t);
233
- resolve();
234
- };
235
- ws.onclose = (ev) => {
236
- clearTimeout(t);
237
- if (ev.code !== 1006) resolve();
238
- else resolve();
239
- };
240
- });
241
- });
242
-
243
- test("plain HTTP GET on mixed route still works (no Upgrade header)", async () => {
244
- const res = await fetch("http://localhost:3005/mixed");
245
- expect(res.status).toBe(200);
246
- const body = await res.json();
247
- expect(body.kind).toBe("http");
248
- });
249
- });
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { mkdir, writeFile } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { createServer } from "../src/server";
6
+
7
+ // ── Sandbox note ─────────────────────────────────────────────────────────────
8
+ // The Babel plugin unconditionally inserts `import ... from "@sigil-dev/runtime"`
9
+ // for all non-SSR route files. When createServer() calls Bun.build to bundle hydrate.js,
10
+ // those compiled page files pull in @sigil-dev/runtime → Bun's test sandbox blocks the
11
+ // read of packages/runtime/index.ts.
12
+ //
13
+ // Consequence: createServer() integration tests can only use +server.ts API routes
14
+ // (which are never bundled by Bun.build). Form action behavior at the HTTP level cannot
15
+ // be tested here — it is covered at unit level by fail.test.ts and redirect-error.test.ts,
16
+ // and at the renderer level by rendering.test.ts.
17
+ // ─────────────────────────────────────────────────────────────────────────────
18
+
19
+ let tmpDir: string;
20
+
21
+ beforeAll(async () => {
22
+ tmpDir = join(tmpdir(), `grimoire-server-${Date.now()}`);
23
+ await mkdir(join(tmpDir, "api", "hello"), { recursive: true });
24
+ await mkdir(join(tmpDir, "api", "items"), { recursive: true });
25
+
26
+ await writeFile(
27
+ join(tmpDir, "api", "hello", "+server.ts"),
28
+ `export async function GET() { return Response.json({ message: "hello" }); }`,
29
+ );
30
+
31
+ await writeFile(
32
+ join(tmpDir, "api", "items", "+server.ts"),
33
+ `export async function GET() {
34
+ return Response.json([{ id: 1, name: "sword" }]);
35
+ }
36
+ export async function POST({ request }) {
37
+ const body = await request.json();
38
+ return Response.json({ id: 2, ...body }, { status: 201 });
39
+ }`,
40
+ );
41
+ });
42
+
43
+ describe("Server — API routes (+server.ts)", () => {
44
+ test("GET returns JSON", async () => {
45
+ const server = await createServer({
46
+ port: 3004,
47
+ routes: tmpDir,
48
+ _skipBuild: true,
49
+ });
50
+ const res = await fetch("http://localhost:3004/api/hello");
51
+ const data = await res.json();
52
+ expect(data.message).toBe("hello");
53
+ server.stop();
54
+ });
55
+
56
+ test("GET on multi-method route returns correct JSON", async () => {
57
+ const server = await createServer({
58
+ port: 3004,
59
+ routes: tmpDir,
60
+ _skipBuild: true,
61
+ });
62
+ const res = await fetch("http://localhost:3004/api/items");
63
+ expect(res.status).toBe(200);
64
+ const items = await res.json();
65
+ expect(items[0].name).toBe("sword");
66
+ server.stop();
67
+ });
68
+
69
+ test("POST returns 201 with created resource", async () => {
70
+ const server = await createServer({
71
+ port: 3004,
72
+ routes: tmpDir,
73
+ _skipBuild: true,
74
+ });
75
+ const res = await fetch("http://localhost:3004/api/items", {
76
+ method: "POST",
77
+ headers: { "Content-Type": "application/json" },
78
+ body: JSON.stringify({ name: "shield" }),
79
+ });
80
+ expect(res.status).toBe(201);
81
+ const item = await res.json();
82
+ expect(item.name).toBe("shield");
83
+ server.stop();
84
+ });
85
+
86
+ test("unsupported method returns 405", async () => {
87
+ const server = await createServer({
88
+ port: 3004,
89
+ routes: tmpDir,
90
+ _skipBuild: true,
91
+ });
92
+ const res = await fetch("http://localhost:3004/api/items", {
93
+ method: "DELETE",
94
+ });
95
+ expect(res.status).toBe(405);
96
+ server.stop();
97
+ });
98
+ });
99
+
100
+ describe("Server — WebSocket routes", () => {
101
+ let wsDir: string;
102
+ let server: Awaited<ReturnType<typeof createServer>>;
103
+
104
+ beforeAll(async () => {
105
+ wsDir = join(tmpdir(), `grimoire-ws-${Date.now()}`);
106
+ await mkdir(join(wsDir, "echo"), { recursive: true });
107
+ await mkdir(join(wsDir, "params", "[docId]"), { recursive: true });
108
+ await mkdir(join(wsDir, "reject"), { recursive: true });
109
+ await mkdir(join(wsDir, "mixed"), { recursive: true });
110
+
111
+ // echo: upgrade() merges extra data, message handler echoes back
112
+ await writeFile(
113
+ join(wsDir, "echo", "+server.ts"),
114
+ `export function upgrade({ params }) {
115
+ return { sessionId: "abc123" };
116
+ }
117
+ export const websocket = {
118
+ message(ws, data) { ws.send("echo:" + data); },
119
+ };`,
120
+ );
121
+
122
+ // params: no upgrade(), ws.data.params still available
123
+ await writeFile(
124
+ join(wsDir, "params", "[docId]", "+server.ts"),
125
+ `export const websocket = {
126
+ open(ws) { ws.send("docId:" + ws.data.params.docId); },
127
+ };`,
128
+ );
129
+
130
+ // reject: upgrade() throws → 426
131
+ await writeFile(
132
+ join(wsDir, "reject", "+server.ts"),
133
+ `export function upgrade() {
134
+ throw new Error("Unauthorized");
135
+ }
136
+ export const websocket = {
137
+ message(ws, data) { ws.send(data); },
138
+ };`,
139
+ );
140
+
141
+ // mixed: HTTP GET and WebSocket both exported
142
+ await writeFile(
143
+ join(wsDir, "mixed", "+server.ts"),
144
+ `export function GET() {
145
+ return Response.json({ kind: "http" });
146
+ }
147
+ export function upgrade({ params }) { return {}; }
148
+ export const websocket = {
149
+ message(ws, data) { ws.send(data); },
150
+ };`,
151
+ );
152
+
153
+ server = await createServer({
154
+ port: 3005,
155
+ routes: wsDir,
156
+ _skipBuild: true,
157
+ });
158
+ });
159
+
160
+ afterAll(() => {
161
+ server.stop();
162
+ });
163
+
164
+ function wsConnect(path: string): Promise<WebSocket> {
165
+ return new Promise((resolve, reject) => {
166
+ const ws = new WebSocket(`ws://localhost:3005${path}`);
167
+ ws.onopen = () => resolve(ws);
168
+ ws.onerror = () =>
169
+ reject(new Error(`WebSocket connection failed: ${path}`));
170
+ });
171
+ }
172
+
173
+ function nextMessage(ws: WebSocket): Promise<string> {
174
+ return new Promise((resolve, reject) => {
175
+ const timer = setTimeout(
176
+ () => reject(new Error("timeout waiting for message")),
177
+ 2000,
178
+ );
179
+ ws.onmessage = (ev) => {
180
+ clearTimeout(timer);
181
+ resolve(String(ev.data));
182
+ };
183
+ ws.onerror = () => {
184
+ clearTimeout(timer);
185
+ reject(new Error("ws error"));
186
+ };
187
+ });
188
+ }
189
+
190
+ test("message is echoed back", async () => {
191
+ const ws = await wsConnect("/echo");
192
+ const pending = nextMessage(ws);
193
+ ws.send("hello");
194
+ expect(await pending).toBe("echo:hello");
195
+ ws.close();
196
+ });
197
+
198
+ test("upgrade() return value merges into ws.data", async () => {
199
+ // sessionId set in upgrade() — echo route sends it back via a second message
200
+ const ws = new WebSocket("ws://localhost:3005/echo");
201
+ // just verify connection opens cleanly (sessionId is in ws.data server-side)
202
+ await new Promise<void>((resolve, reject) => {
203
+ const t = setTimeout(() => reject(new Error("timeout")), 2000);
204
+ ws.onopen = () => {
205
+ clearTimeout(t);
206
+ resolve();
207
+ };
208
+ ws.onerror = () => {
209
+ clearTimeout(t);
210
+ reject(new Error("connect failed"));
211
+ };
212
+ });
213
+ ws.close();
214
+ });
215
+
216
+ test("ws.data.params available when no upgrade() export", async () => {
217
+ const ws = await wsConnect("/params/42");
218
+ expect(await nextMessage(ws)).toBe("docId:42");
219
+ ws.close();
220
+ });
221
+
222
+ test("upgrade() throwing rejects the connection", async () => {
223
+ await new Promise<void>((resolve, reject) => {
224
+ const ws = new WebSocket("ws://localhost:3005/reject");
225
+ const t = setTimeout(() => reject(new Error("timeout")), 2000);
226
+ ws.onopen = () => {
227
+ clearTimeout(t);
228
+ ws.close();
229
+ reject(new Error("should not have opened"));
230
+ };
231
+ ws.onerror = () => {
232
+ clearTimeout(t);
233
+ resolve();
234
+ };
235
+ ws.onclose = (ev) => {
236
+ clearTimeout(t);
237
+ if (ev.code !== 1006) resolve();
238
+ else resolve();
239
+ };
240
+ });
241
+ });
242
+
243
+ test("plain HTTP GET on mixed route still works (no Upgrade header)", async () => {
244
+ const res = await fetch("http://localhost:3005/mixed");
245
+ expect(res.status).toBe(200);
246
+ const body = await res.json();
247
+ expect(body.kind).toBe("http");
248
+ });
249
+ });
250
+
251
+ describe("Server — named form actions (?/name)", () => {
252
+ let server: { stop: () => void };
253
+ let csrfToken = "";
254
+ const base = "http://localhost:3006";
255
+
256
+ beforeAll(async () => {
257
+ await mkdir(join(tmpDir, "form"), { recursive: true });
258
+ await writeFile(
259
+ join(tmpDir, "form", "+page.tsx"),
260
+ 'export default () => "<h1>form</h1>";',
261
+ );
262
+ await writeFile(
263
+ join(tmpDir, "form", "+page.server.ts"),
264
+ [
265
+ "export async function create(action) {",
266
+ " return {",
267
+ " __fail: true,",
268
+ " status: 400,",
269
+ " data: {",
270
+ " ok: false,",
271
+ ' hasCookies: typeof action.cookies?.get === "function",',
272
+ " method: action.request.method,",
273
+ " },",
274
+ " };",
275
+ "}",
276
+ "export async function POST() {",
277
+ ' return { redirect: "/done" };',
278
+ "}",
279
+ ].join("\n"),
280
+ );
281
+
282
+ server = await createServer({
283
+ port: 3006,
284
+ routes: tmpDir,
285
+ _skipBuild: true,
286
+ });
287
+ // SSR render sets the _csrf cookie
288
+ const res = await fetch(`${base}/form`);
289
+ const setCookie = res.headers.get("set-cookie") ?? "";
290
+ csrfToken = /_csrf=([a-f0-9]+)/.exec(setCookie)?.[1] ?? "";
291
+ });
292
+
293
+ afterAll(() => server.stop());
294
+
295
+ test("POST ?/create invokes the named export with cookies", async () => {
296
+ const res = await fetch(`${base}/form?/create`, {
297
+ method: "POST",
298
+ headers: {
299
+ "Content-Type": "application/x-www-form-urlencoded",
300
+ Cookie: `_csrf=${csrfToken}`,
301
+ },
302
+ body: `x=1&_csrf=${csrfToken}`,
303
+ });
304
+ expect(res.status).toBe(400);
305
+ // shape asserted below — typed to satisfy strict unknown-returning json()
306
+ const json = (await res.json()) as {
307
+ fail: boolean;
308
+ data: { hasCookies: boolean; method: string };
309
+ };
310
+ expect(json.fail).toBe(true);
311
+ expect(json.data.hasCookies).toBe(true);
312
+ expect(json.data.method).toBe("POST");
313
+ });
314
+
315
+ test("unknown named action returns 404", async () => {
316
+ const res = await fetch(`${base}/form?/nope`, {
317
+ method: "POST",
318
+ headers: {
319
+ "Content-Type": "application/x-www-form-urlencoded",
320
+ Cookie: `_csrf=${csrfToken}`,
321
+ },
322
+ body: `x=1&_csrf=${csrfToken}`,
323
+ });
324
+ expect(res.status).toBe(404);
325
+ });
326
+
327
+ test("GET named action is allowed (no CSRF needed)", async () => {
328
+ const res = await fetch(`${base}/form?/create`);
329
+ expect(res.status).toBe(400);
330
+ // shape asserted below — typed to satisfy strict unknown-returning json()
331
+ const json = (await res.json()) as {
332
+ fail: boolean;
333
+ data: { hasCookies: boolean; method: string };
334
+ };
335
+ expect(json.data.method).toBe("GET");
336
+ });
337
+
338
+ test("POST named action without CSRF token is forbidden", async () => {
339
+ const res = await fetch(`${base}/form?/create`, {
340
+ method: "POST",
341
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
342
+ body: "x=1",
343
+ });
344
+ expect(res.status).toBe(403);
345
+ });
346
+
347
+ test("method dispatch without query key is unchanged", async () => {
348
+ const res = await fetch(`${base}/form`, {
349
+ method: "POST",
350
+ headers: {
351
+ "Content-Type": "application/x-www-form-urlencoded",
352
+ Cookie: `_csrf=${csrfToken}`,
353
+ },
354
+ body: `x=1&_csrf=${csrfToken}`,
355
+ redirect: "manual",
356
+ });
357
+ expect(res.status).toBe(303);
358
+ expect(res.headers.get("location")).toBe("/done");
359
+ });
360
+ });