@sigil-dev/grimoire 0.9.2 → 0.9.4

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 (88) 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 +31 -8
  6. package/src/client/enhance.ts +102 -98
  7. package/src/client/head.ts +30 -30
  8. package/src/client/index.ts +5 -5
  9. package/src/client/router.ts +529 -371
  10. package/src/client/scope.ts +22 -22
  11. package/src/dev/compile-module.ts +163 -163
  12. package/src/dev/effect-registry.ts +23 -23
  13. package/src/dev/graph.ts +114 -114
  14. package/src/dev/hmr-client.ts +185 -185
  15. package/src/dev/loader.ts +47 -47
  16. package/src/dev/paths.ts +14 -14
  17. package/src/dev/runtime-bundle.ts +52 -52
  18. package/src/dev/watcher.ts +47 -46
  19. package/src/env/dynamic-private.ts +19 -19
  20. package/src/env/dynamic-public.ts +22 -22
  21. package/src/env/index.ts +25 -25
  22. package/src/env/plugin.ts +19 -19
  23. package/src/env/private.ts +5 -5
  24. package/src/env/public.ts +7 -7
  25. package/src/env/typegen.ts +61 -61
  26. package/src/headers.ts +114 -114
  27. package/src/integrations/vite.ts +73 -73
  28. package/src/logger/index.ts +4 -4
  29. package/src/logger/instance.ts +6 -6
  30. package/src/logger/logger.ts +113 -113
  31. package/src/logger/request-middleware.ts +24 -24
  32. package/src/logger/transports.ts +117 -117
  33. package/src/logger/types.ts +39 -39
  34. package/src/rendering/head.ts +47 -47
  35. package/src/rendering/hydrate.ts +146 -119
  36. package/src/rendering/index.ts +573 -372
  37. package/src/rendering/ssrPlugin.ts +69 -69
  38. package/src/routing/manifest-gen.ts +55 -42
  39. package/src/routing/router.ts +135 -109
  40. package/src/routing/scanner.ts +187 -141
  41. package/src/routing/transform-routes.ts +102 -102
  42. package/src/sentinels/error.ts +52 -52
  43. package/src/sentinels/fail.ts +41 -41
  44. package/src/sentinels/redirect.ts +35 -35
  45. package/src/server/build.ts +255 -219
  46. package/src/server/context.ts +10 -10
  47. package/src/server/cookie-utils.ts +66 -66
  48. package/src/server/coordinator.ts +364 -356
  49. package/src/server/hooks.ts +114 -114
  50. package/src/server/index.ts +677 -658
  51. package/src/server/interactive.ts +56 -56
  52. package/src/server/plugins.ts +121 -120
  53. package/src/server/worker.ts +58 -58
  54. package/src/typegen/index.ts +389 -356
  55. package/src/types.ts +8 -4
  56. package/test/client-router.test.ts +295 -35
  57. package/test/context.test.ts +52 -52
  58. package/test/env.test.ts +70 -70
  59. package/test/exports.test.ts +37 -37
  60. package/test/fail.test.ts +46 -46
  61. package/test/headers.test.ts +100 -100
  62. package/test/hydration.test.ts +119 -119
  63. package/test/middleware.test.ts +223 -223
  64. package/test/preload.ts +5 -5
  65. package/test/redirect-error.test.ts +112 -112
  66. package/test/rendering.test.ts +728 -579
  67. package/test/routing.test.ts +194 -81
  68. package/test/scanning.test.ts +254 -200
  69. package/test/scope.test.ts +195 -195
  70. package/test/server.test.ts +354 -249
  71. package/test/streaming.test.ts +242 -125
  72. package/test/transform-routes.test.ts +87 -84
  73. package/test/typegen.test.ts +697 -682
  74. package/tsconfig.json +10 -10
  75. package/.grimoire/_routes.dom.js +0 -8
  76. package/.grimoire/_routes.hydrate.js +0 -8
  77. package/.grimoire/tsconfig.generated.json +0 -11
  78. package/.grimoire/types/ambient.d.ts +0 -59
  79. package/.grimoire/types/api/hello/$types.d.ts +0 -50
  80. package/.grimoire/types/api/items/$types.d.ts +0 -50
  81. package/.grimoire/types/echo/$types.d.ts +0 -50
  82. package/.grimoire/types/env-private.d.ts +0 -5
  83. package/.grimoire/types/env-public.d.ts +0 -5
  84. package/.grimoire/types/mixed/$types.d.ts +0 -50
  85. package/.grimoire/types/params/[docId]/$types.d.ts +0 -52
  86. package/.grimoire/types/reject/$types.d.ts +0 -50
  87. package/public/__grimoire__/hydrate.js +0 -585
  88. package/public/__grimoire__/index.js +0 -490
@@ -1,249 +1,354 @@
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 { fail: boolean; data: { hasCookies: boolean; method: string } };
307
+ expect(json.fail).toBe(true);
308
+ expect(json.data.hasCookies).toBe(true);
309
+ expect(json.data.method).toBe("POST");
310
+ });
311
+
312
+ test("unknown named action returns 404", async () => {
313
+ const res = await fetch(`${base}/form?/nope`, {
314
+ method: "POST",
315
+ headers: {
316
+ "Content-Type": "application/x-www-form-urlencoded",
317
+ Cookie: `_csrf=${csrfToken}`,
318
+ },
319
+ body: `x=1&_csrf=${csrfToken}`,
320
+ });
321
+ expect(res.status).toBe(404);
322
+ });
323
+
324
+ test("GET named action is allowed (no CSRF needed)", async () => {
325
+ const res = await fetch(`${base}/form?/create`);
326
+ expect(res.status).toBe(400);
327
+ // shape asserted below — typed to satisfy strict unknown-returning json()
328
+ const json = (await res.json()) as { fail: boolean; data: { hasCookies: boolean; method: string } };
329
+ expect(json.data.method).toBe("GET");
330
+ });
331
+
332
+ test("POST named action without CSRF token is forbidden", async () => {
333
+ const res = await fetch(`${base}/form?/create`, {
334
+ method: "POST",
335
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
336
+ body: "x=1",
337
+ });
338
+ expect(res.status).toBe(403);
339
+ });
340
+
341
+ test("method dispatch without query key is unchanged", async () => {
342
+ const res = await fetch(`${base}/form`, {
343
+ method: "POST",
344
+ headers: {
345
+ "Content-Type": "application/x-www-form-urlencoded",
346
+ Cookie: `_csrf=${csrfToken}`,
347
+ },
348
+ body: `x=1&_csrf=${csrfToken}`,
349
+ redirect: "manual",
350
+ });
351
+ expect(res.status).toBe(303);
352
+ expect(res.headers.get("location")).toBe("/done");
353
+ });
354
+ });