@sigil-dev/grimoire 0.9.4 → 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 -37
  2. package/package.json +3 -3
  3. package/preload.js +3 -3
  4. package/server.ts +19 -19
  5. package/src/client/deps.ts +36 -36
  6. package/src/client/enhance.ts +102 -102
  7. package/src/client/head.ts +30 -30
  8. package/src/client/index.ts +5 -5
  9. package/src/client/router.ts +42 -20
  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 +16 -3
  39. package/src/rendering/index.ts +10 -6
  40. package/src/rendering/ssrPlugin.ts +78 -69
  41. package/src/routing/manifest-gen.ts +55 -55
  42. package/src/routing/router.ts +135 -135
  43. package/src/routing/scanner.ts +196 -187
  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 -255
  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 -677
  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 -389
  58. package/src/types.ts +286 -286
  59. package/test/client-router.test.ts +295 -298
  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 -728
  71. package/test/routing.test.ts +197 -194
  72. package/test/scanning.test.ts +314 -254
  73. package/test/scope.test.ts +195 -195
  74. package/test/server.test.ts +360 -354
  75. package/test/streaming.test.ts +242 -242
  76. package/test/transform-routes.test.ts +87 -87
  77. package/test/typegen.test.ts +697 -697
  78. package/tsconfig.json +10 -10
@@ -1,354 +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
- });
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
- });
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
+ });