From 56089572a94f44e7d215a2c8df82641b678dca25 Mon Sep 17 00:00:00 2001 From: Sasha Koss Date: Fri, 13 Nov 2026 11:12:30 +0800 Subject: [PATCH 1/5] chore: add playground with integration tests for #785 --- .../integration/server-auth-errors.test.ts | 382 ++++++++++++++++++ playground/server-auth-errors/README.md | 25 ++ .../server-auth-errors/middleware/auth.ts | 16 + playground/server-auth-errors/package.json | 24 ++ .../server-auth-errors/pages/_error.tsx | 16 + .../server-auth-errors/pages/_not-found.tsx | 8 + .../pages/actions/[mode].server.ts | 33 ++ .../pages/actions/[mode].tsx | 51 +++ .../pages/actions/success.tsx | 9 + playground/server-auth-errors/pages/index.tsx | 273 +++++++++++++ .../server-auth-errors/pages/layout.tsx | 79 ++++ .../pages/loaders/not-found.server.ts | 11 + .../pages/loaders/not-found.tsx | 1 + .../pages/loaders/optional-session.server.ts | 7 + .../pages/loaders/optional-session.tsx | 1 + .../pages/loaders/optional-user.server.ts | 4 + .../pages/loaders/optional-user.tsx | 1 + .../pages/loaders/require-auth.server.ts | 4 + .../pages/loaders/require-auth.tsx | 1 + .../pages/loaders/return-redirect.server.ts | 10 + .../pages/loaders/return-redirect.tsx | 1 + .../pages/loaders/throw-redirect.server.ts | 4 + .../pages/loaders/throw-redirect.tsx | 1 + .../pages/loaders/unexpected.server.ts | 10 + .../pages/loaders/unexpected.tsx | 1 + .../server-auth-errors/pages/login.server.ts | 12 + playground/server-auth-errors/pages/login.tsx | 46 +++ .../pages/middleware/[mode].server.ts | 10 + .../pages/middleware/[mode].tsx | 1 + .../server-auth-errors/pages/styles.css | 72 ++++ .../routes/api/demo-login.ts | 21 + .../server-auth-errors/routes/api/profile.ts | 7 + .../server-auth-errors/src/demo-user.ts | 5 + .../src/require-page-user.ts | 12 + playground/server-auth-errors/src/result.tsx | 16 + .../server-auth-errors/src/source-link.tsx | 14 + playground/server-auth-errors/tsconfig.json | 18 + playground/server-auth-errors/vite.config.ts | 10 + playground/server-auth-errors/void.config.ts | 10 + playground/server-auth-errors/void.lock.json | 8 + pnpm-lock.yaml | 34 ++ 41 files changed, 1269 insertions(+) create mode 100644 packages/void/test/integration/server-auth-errors.test.ts create mode 100644 playground/server-auth-errors/README.md create mode 100644 playground/server-auth-errors/middleware/auth.ts create mode 100644 playground/server-auth-errors/package.json create mode 100644 playground/server-auth-errors/pages/_error.tsx create mode 100644 playground/server-auth-errors/pages/_not-found.tsx create mode 100644 playground/server-auth-errors/pages/actions/[mode].server.ts create mode 100644 playground/server-auth-errors/pages/actions/[mode].tsx create mode 100644 playground/server-auth-errors/pages/actions/success.tsx create mode 100644 playground/server-auth-errors/pages/index.tsx create mode 100644 playground/server-auth-errors/pages/layout.tsx create mode 100644 playground/server-auth-errors/pages/loaders/not-found.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/not-found.tsx create mode 100644 playground/server-auth-errors/pages/loaders/optional-session.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/optional-session.tsx create mode 100644 playground/server-auth-errors/pages/loaders/optional-user.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/optional-user.tsx create mode 100644 playground/server-auth-errors/pages/loaders/require-auth.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/require-auth.tsx create mode 100644 playground/server-auth-errors/pages/loaders/return-redirect.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/return-redirect.tsx create mode 100644 playground/server-auth-errors/pages/loaders/throw-redirect.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/throw-redirect.tsx create mode 100644 playground/server-auth-errors/pages/loaders/unexpected.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/unexpected.tsx create mode 100644 playground/server-auth-errors/pages/login.server.ts create mode 100644 playground/server-auth-errors/pages/login.tsx create mode 100644 playground/server-auth-errors/pages/middleware/[mode].server.ts create mode 100644 playground/server-auth-errors/pages/middleware/[mode].tsx create mode 100644 playground/server-auth-errors/pages/styles.css create mode 100644 playground/server-auth-errors/routes/api/demo-login.ts create mode 100644 playground/server-auth-errors/routes/api/profile.ts create mode 100644 playground/server-auth-errors/src/demo-user.ts create mode 100644 playground/server-auth-errors/src/require-page-user.ts create mode 100644 playground/server-auth-errors/src/result.tsx create mode 100644 playground/server-auth-errors/src/source-link.tsx create mode 100644 playground/server-auth-errors/tsconfig.json create mode 100644 playground/server-auth-errors/vite.config.ts create mode 100644 playground/server-auth-errors/void.config.ts create mode 100644 playground/server-auth-errors/void.lock.json diff --git a/packages/void/test/integration/server-auth-errors.test.ts b/packages/void/test/integration/server-auth-errors.test.ts new file mode 100644 index 000000000..14678a00b --- /dev/null +++ b/packages/void/test/integration/server-auth-errors.test.ts @@ -0,0 +1,382 @@ +import { join } from 'node:path'; +import spawn from 'cross-spawn'; +import type { Browser, BrowserContext, Page, Response } from 'playwright'; +import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it } from 'vite-plus/test'; +import { collectBrowserDiagnostics } from '../../../../test/browser-helpers.ts'; +import { + createIsolatedPlayground, + killChild, + startServer, + type IsolatedPlayground, + type StartedServer, +} from '../../../../test/integration-helpers.ts'; +import { launchPagesBrowser } from '../../../../test/pages-browser.ts'; + +const ROOT = join(import.meta.dirname, '../../../..'); +const PLAYGROUND = 'playground/server-auth-errors'; +const EMAIL = 'demo@example.com'; +const guards = ['require-auth', 'return-redirect', 'throw-redirect'] as const; +const visits = ['Document load', 'Client navigation'] as const; +const forms = ['Native form POST', 'Enhanced form POST'] as const; +const pages = [ + { path: '/loaders/optional-user', status: 200, heading: 'Loader rendered the page' }, + { path: '/loaders/optional-session', status: 200, heading: 'Loader rendered the page' }, + { path: '/loaders/require-auth', status: 401, heading: null }, + { path: '/loaders/return-redirect', status: 302, heading: 'Sign in' }, + { path: '/loaders/throw-redirect', status: 302, heading: 'Sign in' }, + { path: '/loaders/not-found', status: 404, heading: 'Not-found boundary' }, + { path: '/loaders/unexpected', status: 500, heading: 'Root error boundary' }, + { path: '/middleware/require-auth', status: 401, heading: null }, + { path: '/middleware/return-redirect', status: 302, heading: 'Sign in' }, + { path: '/middleware/throw-redirect', status: 302, heading: 'Sign in' }, +] as const; + +let playground: IsolatedPlayground; +let server: StartedServer; +let browser: Browser; +let signedInState: Awaited>; +let page: Page; +let diagnostics: () => string; + +beforeAll(async () => { + playground = createIsolatedPlayground(ROOT, PLAYGROUND); + server = await startServer( + (port) => + spawn('vp', ['dev', '--host', '127.0.0.1', '--port', String(port), '--strictPort'], { + cwd: playground.root, + stdio: ['ignore', 'pipe', 'pipe'], + env: { ...process.env, VOID_INSPECTOR_PORT: 'false' }, + }), + 60_000, + { expectStatus: 200, expectBody: 'Server Auth Errors Example' }, + ); + browser = await launchPagesBrowser(); + + // A fresh copy has its own D1 database. Create a real session once, then give + // each signed-in scenario an independent cookie jar containing that session. + const context = await browser.newContext(); + try { + const response = await context.request.post(`${server.base}/api/demo-login`); + expect(response.status(), await response.text()).toBe(200); + const profile = await context.request.get(`${server.base}/api/profile`); + expect(profile.status()).toBe(200); + expect(await profile.json()).toEqual({ name: 'Demo user', email: EMAIL }); + signedInState = await context.storageState(); + } finally { + await context.close(); + } +}); + +afterEach(async ({ task }) => { + if (task.result?.state === 'fail') { + console.error(`${diagnostics?.() ?? ''}\n${server?.output() ?? ''}`); + } + await page?.context().close(); +}); + +afterAll(async () => { + await browser?.close(); + if (server) { + await killChild(server.child); + } + playground?.cleanup(); +}); + +async function newPage(signedIn = false) { + const context = await browser.newContext({ storageState: signedIn ? signedInState : undefined }); + page = await context.newPage(); + page.setDefaultTimeout(10_000); + diagnostics = collectBrowserDiagnostics(page); +} + +async function open(path = '/', signedIn = false) { + const response = await page.goto(`${server.base}${path}`); + expect(response?.status()).toBe(200); + await page + .getByRole('navigation') + .getByRole('link', { + name: signedIn ? 'Sign out' : 'Sign in', + exact: true, + }) + .waitFor(); +} + +async function markLayout() { + await page + .locator('header') + .evaluate((header) => header.setAttribute('data-test-layout', 'retained')); + return page.evaluate(() => performance.timeOrigin); +} + +async function expectLayout(timeOrigin: number, retained: boolean) { + expect((await page.evaluate(() => performance.timeOrigin)) === timeOrigin).toBe(retained); + expect(await page.locator('header[data-test-layout="retained"]').count()).toBe(retained ? 1 : 0); +} + +function responseFor(path: string, method = 'GET') { + return page.waitForResponse( + (response) => + response.url() === `${server.base}${path}` && response.request().method() === method, + ); +} + +async function expectRedirect(response: Response, destination: string, status: number) { + expect(response.status()).toBe(status); + expect(await response.headerValue('location')).toBe(destination); + await page.waitForURL(`${server.base}${destination}`); +} + +describe.each([ + { state: 'signed out', signedIn: false }, + { state: 'signed in', signedIn: true }, +])('server auth: $state', ({ signedIn }) => { + beforeEach(() => newPage(signedIn)); + + describe.each(visits)('%s', (visit) => { + it.each(pages)('handles $path', async ({ path, status, heading }) => { + await open('/', signedIn); + const timeOrigin = await markLayout(); + const pending = responseFor(path); + await page.locator(`a[href="${path}"]`).filter({ hasText: visit }).click(); + const response = await pending; + const expectedStatus = signedIn ? 200 : status; + expect(response.status()).toBe(expectedStatus); + + if (expectedStatus === 401) { + await expect.poll(() => page.locator('body').innerText()).toBe('Unauthorized'); + expect(await response.headerValue('content-type')).toContain('text/plain'); + expect(await page.locator('header').count()).toBe(0); + expect(await page.getByRole('heading', { name: 'Root error boundary' }).count()).toBe(0); + expect(await page.evaluate(() => performance.timeOrigin)).not.toBe(timeOrigin); + expect(page.url()).toBe(`${server.base}${path}`); + return; + } + + if (expectedStatus === 302) { + await expectRedirect(response, `/login?next=${encodeURIComponent(path)}`, 302); + } else { + await page.waitForURL(`${server.base}${path}`); + } + await page + .getByRole('heading', { + name: signedIn ? 'Loader rendered the page' : heading!, + exact: true, + }) + .waitFor(); + await expectLayout(timeOrigin, visit === 'Client navigation'); + + if (signedIn) { + expect(await page.locator('main').innerText()).toContain(`Signed in as ${EMAIL}.`); + if (path === '/loaders/optional-session') { + expect(await page.locator('main').innerText()).toMatch( + /Session expires: \d{4}-\d{2}-\d{2}T/, + ); + } + } else if (status === 200) { + expect(await page.locator('main').innerText()).toContain( + 'Anonymous visitor: user is null.', + ); + expect(await page.locator('main').innerText()).not.toContain('Session expires:'); + } + }); + }); + + describe.each(forms)('%s', (form) => { + it.each(guards)('checks authentication for the %s action', async (guard) => { + const path = `/actions/${guard}`; + await open(path, signedIn); + const timeOrigin = await markLayout(); + const pending = responseFor(path, 'POST'); + await page.getByRole('button', { name: form, exact: true }).click(); + const response = await pending; + + if (!signedIn && guard === 'require-auth') { + expect(response.status()).toBe(401); + expect(await response.text()).toBe('Unauthorized'); + if (form === 'Native form POST') { + await expect.poll(() => page.locator('body').innerText()).toBe('Unauthorized'); + expect(await page.locator('header').count()).toBe(0); + expect(await page.evaluate(() => performance.timeOrigin)).not.toBe(timeOrigin); + } else { + await expect.poll(() => page.getByRole('alert').innerText()).toBe('401: Unauthorized'); + expect(await page.getByRole('heading', { name: `Action: ${guard}` }).count()).toBe(1); + await expectLayout(timeOrigin, true); + } + expect(page.url()).toBe(`${server.base}${path}`); + return; + } + + const destination = signedIn ? '/actions/success' : `/login?next=${encodeURIComponent(path)}`; + await expectRedirect(response, destination, 303); + expect(response.request().redirectedTo()?.method()).toBe('GET'); + await page + .getByRole('heading', { + name: signedIn ? 'Action authorized' : 'Sign in', + exact: true, + }) + .waitFor(); + await expectLayout(timeOrigin, form === 'Enhanced form POST'); + }); + }); + + it('returns the API profile as a document', async () => { + await open('/', signedIn); + const timeOrigin = await markLayout(); + const pending = responseFor('/api/profile'); + await page.locator('a[href="/api/profile"]').click(); + const response = await pending; + expect(response.status()).toBe(signedIn ? 200 : 401); + if (signedIn) { + expect(await response.json()).toEqual({ name: 'Demo user', email: EMAIL }); + } else { + expect(await response.text()).toBe('Unauthorized'); + } + await page.waitForURL(`${server.base}/api/profile`); + expect(await page.evaluate(() => performance.timeOrigin)).not.toBe(timeOrigin); + expect(await page.locator('header').count()).toBe(0); + }); + + it('displays the API profile fetch result without navigating', async () => { + await open('/', signedIn); + const timeOrigin = await markLayout(); + await page.getByRole('button', { name: 'Fetch API response' }).click(); + const result = page.locator('#api').locator('..').getByRole('status'); + await expect.poll(() => result.innerText()).toContain(signedIn ? 'HTTP 200' : 'HTTP 401'); + expect(await result.innerText()).toContain(signedIn ? EMAIL : 'Unauthorized'); + expect(await result.innerText()).toContain(signedIn ? 'application/json' : 'text/plain'); + expect(page.url()).toBe(`${server.base}/`); + await expectLayout(timeOrigin, true); + }); +}); + +describe('demo session and navigation', () => { + beforeEach(() => newPage()); + + it('signs in with the demo user and updates the auth links', async () => { + const destination = '/loaders/throw-redirect'; + await open(); + const timeOrigin = await markLayout(); + await page.locator(`a[href="${destination}"]`).filter({ hasText: 'Client navigation' }).click(); + await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); + expect(await page.getByLabel('Email', { exact: true }).inputValue()).toBe(EMAIL); + expect(await page.getByLabel('Email', { exact: true }).isDisabled()).toBe(true); + expect(await page.getByLabel('Password', { exact: true }).inputValue()).toBe('demo-password'); + expect(await page.getByLabel('Password', { exact: true }).isDisabled()).toBe(true); + await page.getByRole('button', { name: 'Sign in', exact: true }).click(); + await page.getByRole('heading', { name: 'Loader rendered the page' }).waitFor(); + expect(page.url()).toBe(`${server.base}${destination}`); + await page.getByRole('link', { name: 'Sign out', exact: true }).waitFor(); + expect(await page.getByRole('link', { name: 'Sign in', exact: true }).count()).toBe(0); + await expectLayout(timeOrigin, true); + + await page.reload(); + await page.getByRole('link', { name: 'Sign out', exact: true }).waitFor(); + await page.getByRole('link', { name: 'Sign out', exact: true }).click(); + await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); + await page.getByRole('link', { name: 'Sign in', exact: true }).waitFor(); + expect(await page.getByRole('link', { name: 'Sign out', exact: true }).count()).toBe(0); + expect((await page.request.get(`${server.base}/api/profile`)).status()).toBe(401); + }); + + it('uses the demo credentials regardless of the submitted fields', async () => { + const response = await page.request.post(`${server.base}/api/demo-login`, { + data: { email: 'other@example.com', password: 'different-password' }, + }); + expect(response.status()).toBe(200); + const profile = await page.request.get(`${server.base}/api/profile`); + expect(await profile.json()).toEqual({ name: 'Demo user', email: EMAIL }); + }); + + describe.each(forms)('%s after the session ends', (form) => { + it.each(guards)('rechecks authentication for the %s action', async (guard) => { + expect((await page.request.post(`${server.base}/api/demo-login`)).status()).toBe(200); + const path = `/actions/${guard}`; + await open(path, true); + expect(await page.locator('main').innerText()).toContain(`Signed in as ${EMAIL}.`); + + // End the session without refreshing the already-rendered form. + const signedOut = await page.request.post(`${server.base}/api/auth/sign-out`, { + headers: { Origin: server.base }, + data: {}, + }); + expect(signedOut.status()).toBe(200); + const pending = responseFor(path, 'POST'); + await page.getByRole('button', { name: form, exact: true }).click(); + const response = await pending; + + if (guard === 'require-auth') { + expect(response.status()).toBe(401); + if (form === 'Native form POST') { + await expect.poll(() => page.locator('body').innerText()).toBe('Unauthorized'); + } else { + await expect.poll(() => page.getByRole('alert').innerText()).toBe('401: Unauthorized'); + } + } else { + await expectRedirect(response, `/login?next=${encodeURIComponent(path)}`, 303); + await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); + } + expect(await page.getByRole('heading', { name: 'Action authorized' }).count()).toBe(0); + }); + }); + + it.each(['return-redirect', 'throw-redirect'])( + 'returns to the %s form after login without replaying its action', + async (guard) => { + const path = `/actions/${guard}`; + await open(path); + const submissions: Array = []; + page.on('request', (request) => { + if (request.url() === `${server.base}${path}` && request.method() === 'POST') { + submissions.push(request.method()); + } + }); + await page.getByRole('button', { name: 'Enhanced form POST' }).click(); + await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); + await page.getByRole('button', { name: 'Sign in', exact: true }).click(); + await page.getByRole('heading', { name: `Action: ${guard}` }).waitFor(); + expect(submissions).toEqual(['POST']); + expect(page.url()).toBe(`${server.base}${path}`); + await page.getByRole('button', { name: 'Enhanced form POST' }).click(); + await page.getByRole('heading', { name: 'Action authorized' }).waitFor(); + expect(submissions).toEqual(['POST', 'POST']); + }, + ); + + it('renders the client error boundary when an enhanced form throws its 401', async () => { + await open('/actions/require-auth'); + const timeOrigin = await markLayout(); + await page.getByRole('checkbox', { name: /Throw enhanced-form errors/ }).check(); + await page.getByRole('button', { name: 'Enhanced form POST' }).click(); + await page.getByRole('heading', { name: 'Root error boundary' }).waitFor(); + expect(await page.locator('main').innerText()).toContain('401: Unauthorized'); + await expectLayout(timeOrigin, true); + await page.getByRole('link', { name: 'Server Auth Errors Example', exact: true }).click(); + await page.getByRole('heading', { name: 'Server Auth Errors Example', exact: true }).waitFor(); + expect(await page.getByRole('heading', { name: 'Root error boundary' }).count()).toBe(0); + }); + + it('shows a temporary page-loaded popover only on document loads', async () => { + await open(); + const toast = page.locator('.page-loaded-toast'); + await expect + .poll(() => toast.evaluate((element) => element.matches(':popover-open'))) + .toBe(true); + const timeOrigin = await markLayout(); + await page + .locator('a[href="/loaders/optional-user"]') + .filter({ hasText: 'Client navigation' }) + .click(); + await page.getByRole('heading', { name: 'Loader rendered the page' }).waitFor(); + expect(await toast.evaluate((element) => element.matches(':popover-open'))).toBe(false); + await expectLayout(timeOrigin, true); + await page.reload(); + await expect + .poll(() => toast.evaluate((element) => element.matches(':popover-open'))) + .toBe(true); + await expect + .poll(() => toast.evaluate((element) => element.matches(':popover-open')), { + timeout: 5000, + }) + .toBe(false); + }); +}); diff --git a/playground/server-auth-errors/README.md b/playground/server-auth-errors/README.md new file mode 100644 index 000000000..38fe2ee11 --- /dev/null +++ b/playground/server-auth-errors/README.md @@ -0,0 +1,25 @@ +# Server auth errors + +Compare auth checks, redirects, and page boundaries in a grid of React Pages examples. + +From the repository root: + +```sh +vp run --filter ./playground/server-auth-errors dev +``` + +Start signed out to see the limitations of a plain-text `401`. Compare document loads and client navigation: a native popover shows “Page loaded” for 2.5 seconds on document loads. Client visits do not show it again; plain-text responses replace the app entirely. The action examples offer native and enhanced forms, including inline errors and client error boundaries. + +Submit `/login` to sign in as the demo user, then repeat the examples. The disabled fields show example credentials; the server ignores submitted fields and always uses the same demo account, creating it on first use. The app uses Void’s auth and local D1; dev creates the auth tables automatically. No Cloudflare login or OAuth provider is needed. + +Source links open the corresponding files in VS Code. Use the Network panel with Preserve log to inspect statuses and redirects. The shared guard in `src/require-page-user.ts` throws a `302` for page visits or a `303` for actions. + +## Tests + +Run the Vitest browser integration from the repository root: + +```sh +vp test run packages/void/test/integration/server-auth-errors.test.ts +``` + +The suite starts an isolated copy of this playground with its own local D1 database and drives it with Playwright. It covers every example signed out and signed in, both navigation modes, native and enhanced forms, redirects, boundaries, and session changes. diff --git a/playground/server-auth-errors/middleware/auth.ts b/playground/server-auth-errors/middleware/auth.ts new file mode 100644 index 000000000..2738b18d6 --- /dev/null +++ b/playground/server-auth-errors/middleware/auth.ts @@ -0,0 +1,16 @@ +import { defineMiddleware } from 'void'; +import { getUser, requireAuth } from 'void/auth'; +import { requirePageUser } from '../src/require-page-user.ts'; + +export default defineMiddleware(async (c, next) => { + if (c.req.path === '/middleware/require-auth') { + requireAuth(c); + } + if (c.req.path === '/middleware/return-redirect' && !getUser()) { + return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`); + } + if (c.req.path === '/middleware/throw-redirect') { + requirePageUser(c); + } + await next(); +}); diff --git a/playground/server-auth-errors/package.json b/playground/server-auth-errors/package.json new file mode 100644 index 000000000..44c3376b8 --- /dev/null +++ b/playground/server-auth-errors/package.json @@ -0,0 +1,24 @@ +{ + "name": "playground-server-auth-errors", + "private": true, + "type": "module", + "scripts": { + "build": "vp build", + "dev": "vp dev", + "typecheck": "tsc --noEmit" + }, + "dependencies": { + "hono": "catalog:", + "react": "catalog:", + "react-dom": "catalog:" + }, + "devDependencies": { + "@types/react": "^19.3.0", + "@types/react-dom": "^19.3.0", + "@void/react": "workspace:*", + "typescript": "catalog:", + "vite": "catalog:", + "vite-plus": "catalog:", + "void": "workspace:*" + } +} diff --git a/playground/server-auth-errors/pages/_error.tsx b/playground/server-auth-errors/pages/_error.tsx new file mode 100644 index 000000000..212999309 --- /dev/null +++ b/playground/server-auth-errors/pages/_error.tsx @@ -0,0 +1,16 @@ +import type { ErrorPageProps } from '@void/react'; + +export default function RootError({ error }: ErrorPageProps) { + return ( +
+

Root error boundary

+

+ {error.status}: {error.message} +

+

+ Ordinary loader errors and thrown client action errors reach this boundary. On the server, + requireAuth sends a plain-text 401 instead. +

+
+ ); +} diff --git a/playground/server-auth-errors/pages/_not-found.tsx b/playground/server-auth-errors/pages/_not-found.tsx new file mode 100644 index 000000000..198121cb7 --- /dev/null +++ b/playground/server-auth-errors/pages/_not-found.tsx @@ -0,0 +1,8 @@ +export default function NotFound() { + return ( +
+

Not-found boundary

+

HTTP 404 selects this boundary inside the layout, unlike the 401 from requireAuth.

+
+ ); +} diff --git a/playground/server-auth-errors/pages/actions/[mode].server.ts b/playground/server-auth-errors/pages/actions/[mode].server.ts new file mode 100644 index 000000000..905791c7e --- /dev/null +++ b/playground/server-auth-errors/pages/actions/[mode].server.ts @@ -0,0 +1,33 @@ +import { HTTPException } from 'hono/http-exception'; +import { defineHandler, type CloudContext, type InferProps } from 'void'; +import { getUser, requireAuth } from 'void/auth'; +import { requirePageUser } from '../../src/require-page-user.ts'; + +function mode(c: CloudContext) { + const value = c.req.param('mode'); + if (value === 'require-auth' || value === 'return-redirect' || value === 'throw-redirect') { + return value; + } + throw new HTTPException(404); +} + +export type Props = InferProps; + +// The form is public; the action checks auth again on every submission. +export const loader = defineHandler((c) => ({ mode: mode(c), email: getUser()?.email ?? null })); + +export const action = defineHandler((c) => { + const variant = mode(c); + if (variant === 'require-auth') { + requireAuth(c); + } + if (variant === 'return-redirect' && !getUser()) { + return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`, 303); + } + if (variant === 'throw-redirect') { + requirePageUser(c, 303); + } + + // A real mutation would run here, only after the auth check succeeds. + return c.redirect('/actions/success', 303); +}); diff --git a/playground/server-auth-errors/pages/actions/[mode].tsx b/playground/server-auth-errors/pages/actions/[mode].tsx new file mode 100644 index 000000000..ce4a00418 --- /dev/null +++ b/playground/server-auth-errors/pages/actions/[mode].tsx @@ -0,0 +1,51 @@ +import { Form, useForm } from '@void/react'; +import { useState } from 'react'; +import type { Props } from './[mode].server.ts'; + +export default function ActionExample({ mode, email }: Props) { + const [throwOnError, setThrowOnError] = useState(false); + const path = `/actions/${mode}`; + const form = useForm('/actions/[mode]', {}, { params: { mode }, throwOnError }); + return ( +
+

Action: {mode}

+

+ {email ? `Signed in as ${email}.` : 'Anonymous visitor.'} The loader allows everyone; the + POST action checks auth. +

+

+ Both buttons submit to the same action. Successful auth redirects to the success page with + 303; no data is changed. +

+ {mode === 'require-auth' ? ( + <> +

+ When signed out, a native form displays a plain-text 401. The enhanced form can keep + that failure inline, or throw it to the error boundary. +

+ + + ) : ( +

+ When signed out, both forms redirect to login with 303. Signing in returns to this form; + it does not replay the rejected action. +

+ )} +
+
+ +
+
`${error.status}: ${error.message}`}> + +
+
+
+ ); +} diff --git a/playground/server-auth-errors/pages/actions/success.tsx b/playground/server-auth-errors/pages/actions/success.tsx new file mode 100644 index 000000000..276d3e98c --- /dev/null +++ b/playground/server-auth-errors/pages/actions/success.tsx @@ -0,0 +1,9 @@ +export default function Success() { + return ( +
+

Action authorized

+

The auth check passed. The action redirected here with 303, followed by a GET.

+

This demo does not write application data.

+
+ ); +} diff --git a/playground/server-auth-errors/pages/index.tsx b/playground/server-auth-errors/pages/index.tsx new file mode 100644 index 000000000..7dc0fe1f4 --- /dev/null +++ b/playground/server-auth-errors/pages/index.tsx @@ -0,0 +1,273 @@ +import { Link } from '@void/react'; +import { useState, type ReactNode } from 'react'; +import { SourceLink } from '../src/source-link.tsx'; + +const loaders = [ + { + mode: 'optional-user', + title: 'getUser(): optional auth', + code: 'return { user: getUser() };', + document: '200 page with user: null.', + navigation: 'Same page, preserving the layout.', + note: 'Reading the user does not protect the page.', + }, + { + mode: 'optional-session', + title: 'getSession(): optional session', + code: 'const state = getSession();\nreturn { user: state?.user ?? null,\n expiresAt: state?.session.expiresAt ?? null };', + document: '200 page with null user and expiry.', + navigation: 'Same page, preserving the layout.', + note: 'Reading the session does not require one.', + }, + { + mode: 'require-auth', + title: 'requireAuth(): plain-text 401', + code: 'return { user: requireAuth(c) };', + document: '401 Unauthorized as plain text, replacing the app.', + navigation: 'Falls back to a document load. The page and layout are replaced by plain text.', + note: 'No login redirect; _error is bypassed even though it exists.', + }, + { + mode: 'return-redirect', + title: 'Return a login redirect', + code: 'const user = getUser();\nif (!user) return c.redirect(\n `/login?next=${encodeURIComponent(c.req.path)}`\n);\nreturn { user };', + document: '302 to login with a return path.', + navigation: 'Visits login without reloading the document.', + note: 'Sign in to continue to the requested page.', + }, + { + mode: 'throw-redirect', + title: 'Throw a redirect from a helper', + code: '// Inside requirePageUser(c):\nif (!user) {\n throw new HTTPException(302, {\n res: c.redirect(location, 302),\n });\n}\nreturn user;', + document: '302 to login with a return path.', + navigation: 'Visits login without reloading the document, like a returned redirect.', + note: 'The helper stops execution without returning a Response to its caller.', + }, + { + mode: 'not-found', + title: 'Throw 404 for comparison', + code: 'const user = getUser();\nif (!user) throw new HTTPException(404);\nreturn { user };', + document: '404 renders _not-found inside the layout.', + navigation: 'Same boundary, preserving the layout.', + note: 'Unlike 401, this HTTPException selects a page boundary. No login redirect.', + }, + { + mode: 'unexpected', + title: 'Throw an ordinary error for comparison', + code: "const user = getUser();\nif (!user) throw new Error('No user');\nreturn { user };", + document: '500 renders _error inside the layout.', + navigation: 'Same boundary, preserving the layout.', + note: 'An ordinary error is not an authentication response. No login redirect.', + }, +] as const; + +const guards = [ + { + mode: 'require-auth', + title: 'requireAuth', + code: 'requireAuth(c);', + document: '401 plain text, replacing the app.', + navigation: 'Falls back to a document load, replacing the page and layout with plain text.', + note: 'No login redirect or server-rendered error boundary.', + }, + { + mode: 'return-redirect', + title: 'Returned redirect', + code: 'if (!getUser()) return c.redirect(location);', + document: '302 to login with a return path.', + navigation: 'Visits login without reloading the document.', + note: 'Redirects before the loader runs.', + }, + { + mode: 'throw-redirect', + title: 'Thrown redirect', + code: 'requirePageUser(c);', + document: '302 to login with a return path.', + navigation: 'Visits login without reloading the document.', + note: 'The shared helper throws a redirect before the loader runs.', + }, +] as const; + +function Visits({ path }: { path: string }) { + return ( +

+ Document load | Client navigation +

+ ); +} + +function Example({ + title, + file, + code, + children, +}: { + title: string; + file: string; + code: string; + children: ReactNode; +}) { + return ( +
+

{title}

+

+ +

+
{code}
+

Expected when signed out

+ {children} +
+ ); +} + +function ProfileRequest() { + const [result, setResult] = useState(''); + async function request() { + try { + const response = await fetch('/api/profile'); + setResult( + `HTTP ${response.status}\n${response.headers.get('Content-Type')}\n${await response.text()}`, + ); + } catch (error) { + setResult(String(error)); + } + } + return ( + <> +

+ Document load |{' '} + +

+
{result}
+ + ); +} + +export default function Home() { + return ( + <> +

Server Auth Errors Example

+

+ Compare server auth in loaders, middleware, API routes, and actions. Each card shows the + signed-out outcome; sign in and repeat to see the authorized path. +

+

+ Related:{' '} + Issue #785 | PR #XXX +

+
+
+

Loaders

+
+ {loaders.map(({ mode, title, code, document, navigation, note }) => ( + +

+ Document load: {document} +

+

+ Client navigation: {navigation} +

+

{note}

+ +
+ ))} +
+
+
+
+

Middleware

+

+ These guards run in application middleware before the loader. A successful check continues + with await next(). +

+
+ {guards.map(({ mode, title, code, document, navigation, note }) => ( + +

+ Document load: {document} +

+

+ Client navigation: {navigation} +

+

{note}

+ +
+ ))} +
+
+
+
+

Actions

+

+ The form pages are public. Each offers a native form and an enhanced useForm submission to + the same protected action. Redirects use 303 so the next request is a GET. +

+
+ {guards.map(({ mode, title }) => ( + +

+ Native form POST:{' '} + {mode === 'require-auth' + ? '401 plain text, replacing the app.' + : '303 to login, followed by a document GET.'} +

+

+ Enhanced form POST:{' '} + {mode === 'require-auth' + ? 'Displays 401 inline or throws to the client error boundary.' + : 'Visits login without reloading the document.'} +

+ {mode !== 'require-auth' && ( +

Signing in returns to the form; it does not replay the rejected action.

+ )} +

Expected when signed in

+

+ Both forms redirect to the success page with 303. No application data is written. +

+ +
+ ))} +
+
+
+
+

API route

+
+ +

+ Document load: 401 plain text, replacing the app. +

+

+ Fetch API response: 401 plain text, displayed below without + navigating. +

+

A fetch caller must check the status before parsing JSON.

+

Expected when signed in

+

Both requests return 200 JSON with the user’s name and email.

+ +
+
+
+ + ); +} diff --git a/playground/server-auth-errors/pages/layout.tsx b/playground/server-auth-errors/pages/layout.tsx new file mode 100644 index 000000000..c16459027 --- /dev/null +++ b/playground/server-auth-errors/pages/layout.tsx @@ -0,0 +1,79 @@ +import { Link, useNavigation, useRouter } from '@void/react'; +import { useEffect, useRef, useState, type ReactNode } from 'react'; +import { auth } from 'void/client/react'; +import './styles.css'; + +export default function Layout({ children }: { children: ReactNode }) { + const toastRef = useRef(null); + const [message, setMessage] = useState(''); + const router = useRouter(); + const navigation = useNavigation(); + const { data: session, isPending } = auth.useSession(); + + useEffect(() => { + const toast = toastRef.current!; + toast.showPopover(); + const timeout = window.setTimeout(() => toast.hidePopover(), 2500); + return () => { + window.clearTimeout(timeout); + toast.hidePopover(); + }; + }, []); + + useEffect(() => { + if (navigation.state !== 'idle') { + toastRef.current?.hidePopover(); + } + }, [navigation.state]); + + async function signOut() { + try { + const result = await auth.signOut(); + if (result.error) { + throw new Error(result.error.message); + } + setMessage(''); + router.refresh(); + } catch (error) { + setMessage(error instanceof Error ? error.message : 'Could not sign out.'); + } + } + + return ( +
+
+ Page loaded +
+
+ +

{message}

+
+
+
{children}
+
+ ); +} diff --git a/playground/server-auth-errors/pages/loaders/not-found.server.ts b/playground/server-auth-errors/pages/loaders/not-found.server.ts new file mode 100644 index 000000000..9678bdbae --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/not-found.server.ts @@ -0,0 +1,11 @@ +import { HTTPException } from 'hono/http-exception'; +import { defineHandler } from 'void'; +import { getUser } from 'void/auth'; + +export const loader = defineHandler(() => { + const user = getUser(); + if (!user) { + throw new HTTPException(404, { message: 'Page not found' }); + } + return { user }; +}); diff --git a/playground/server-auth-errors/pages/loaders/not-found.tsx b/playground/server-auth-errors/pages/loaders/not-found.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/not-found.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/optional-session.server.ts b/playground/server-auth-errors/pages/loaders/optional-session.server.ts new file mode 100644 index 000000000..173353b2f --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/optional-session.server.ts @@ -0,0 +1,7 @@ +import { defineHandler } from 'void'; +import { getSession } from 'void/auth'; + +export const loader = defineHandler(() => { + const state = getSession(); + return { user: state?.user ?? null, expiresAt: state?.session.expiresAt ?? null }; +}); diff --git a/playground/server-auth-errors/pages/loaders/optional-session.tsx b/playground/server-auth-errors/pages/loaders/optional-session.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/optional-session.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/optional-user.server.ts b/playground/server-auth-errors/pages/loaders/optional-user.server.ts new file mode 100644 index 000000000..1f8d65e25 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/optional-user.server.ts @@ -0,0 +1,4 @@ +import { defineHandler } from 'void'; +import { getUser } from 'void/auth'; + +export const loader = defineHandler(() => ({ user: getUser() })); diff --git a/playground/server-auth-errors/pages/loaders/optional-user.tsx b/playground/server-auth-errors/pages/loaders/optional-user.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/optional-user.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/require-auth.server.ts b/playground/server-auth-errors/pages/loaders/require-auth.server.ts new file mode 100644 index 000000000..480465f11 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/require-auth.server.ts @@ -0,0 +1,4 @@ +import { defineHandler } from 'void'; +import { requireAuth } from 'void/auth'; + +export const loader = defineHandler((c) => ({ user: requireAuth(c) })); diff --git a/playground/server-auth-errors/pages/loaders/require-auth.tsx b/playground/server-auth-errors/pages/loaders/require-auth.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/require-auth.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/return-redirect.server.ts b/playground/server-auth-errors/pages/loaders/return-redirect.server.ts new file mode 100644 index 000000000..22de0c02f --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/return-redirect.server.ts @@ -0,0 +1,10 @@ +import { defineHandler } from 'void'; +import { getUser } from 'void/auth'; + +export const loader = defineHandler((c) => { + const user = getUser(); + if (!user) { + return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`); + } + return { user }; +}); diff --git a/playground/server-auth-errors/pages/loaders/return-redirect.tsx b/playground/server-auth-errors/pages/loaders/return-redirect.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/return-redirect.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/throw-redirect.server.ts b/playground/server-auth-errors/pages/loaders/throw-redirect.server.ts new file mode 100644 index 000000000..29e2cee4c --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/throw-redirect.server.ts @@ -0,0 +1,4 @@ +import { defineHandler } from 'void'; +import { requirePageUser } from '../../src/require-page-user.ts'; + +export const loader = defineHandler((c) => ({ user: requirePageUser(c) })); diff --git a/playground/server-auth-errors/pages/loaders/throw-redirect.tsx b/playground/server-auth-errors/pages/loaders/throw-redirect.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/throw-redirect.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/unexpected.server.ts b/playground/server-auth-errors/pages/loaders/unexpected.server.ts new file mode 100644 index 000000000..525bb8733 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/unexpected.server.ts @@ -0,0 +1,10 @@ +import { defineHandler } from 'void'; +import { getUser } from 'void/auth'; + +export const loader = defineHandler(() => { + const user = getUser(); + if (!user) { + throw new Error('No user: ordinary error for comparison'); + } + return { user }; +}); diff --git a/playground/server-auth-errors/pages/loaders/unexpected.tsx b/playground/server-auth-errors/pages/loaders/unexpected.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/unexpected.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/login.server.ts b/playground/server-auth-errors/pages/login.server.ts new file mode 100644 index 000000000..a9b0bb956 --- /dev/null +++ b/playground/server-auth-errors/pages/login.server.ts @@ -0,0 +1,12 @@ +import { defineHandler, type InferProps } from 'void'; + +export type Props = InferProps; + +export const loader = defineHandler((c) => { + const destination = new URL(c.req.query('next') || '/', c.req.url); + const next = + destination.origin === new URL(c.req.url).origin + ? destination.pathname + destination.search + : '/'; + return { next }; +}); diff --git a/playground/server-auth-errors/pages/login.tsx b/playground/server-auth-errors/pages/login.tsx new file mode 100644 index 000000000..28280cd63 --- /dev/null +++ b/playground/server-auth-errors/pages/login.tsx @@ -0,0 +1,46 @@ +import { useRouter } from '@void/react'; +import { useState, type FormEvent } from 'react'; +import { auth } from 'void/client/react'; +import { demoUser } from '../src/demo-user.ts'; +import type { Props } from './login.server.ts'; + +export default function Login({ next }: Props) { + const [pending, setPending] = useState(false); + const [error, setError] = useState(''); + const router = useRouter(); + const { refetch } = auth.useSession(); + + async function submit(event: FormEvent) { + event.preventDefault(); + setPending(true); + setError(''); + try { + const response = await fetch('/api/demo-login', { method: 'POST' }); + if (!response.ok) { + throw new Error('Could not start the demo session.'); + } + await refetch(); + await router.visit(next); + } catch (error) { + setError(error instanceof Error ? error.message : 'Could not sign in.'); + } finally { + setPending(false); + } + } + + return ( +
+

Sign in

+
+ + + + {error &&

{error}

} +
+
+ ); +} diff --git a/playground/server-auth-errors/pages/middleware/[mode].server.ts b/playground/server-auth-errors/pages/middleware/[mode].server.ts new file mode 100644 index 000000000..d44a5b405 --- /dev/null +++ b/playground/server-auth-errors/pages/middleware/[mode].server.ts @@ -0,0 +1,10 @@ +import { HTTPException } from 'hono/http-exception'; +import { defineHandler } from 'void'; +import { getUser } from 'void/auth'; + +export const loader = defineHandler((c) => { + if (!['require-auth', 'return-redirect', 'throw-redirect'].includes(c.req.param('mode') ?? '')) { + throw new HTTPException(404); + } + return { user: getUser() }; +}); diff --git a/playground/server-auth-errors/pages/middleware/[mode].tsx b/playground/server-auth-errors/pages/middleware/[mode].tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/middleware/[mode].tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/styles.css b/playground/server-auth-errors/pages/styles.css new file mode 100644 index 000000000..6c84e34d8 --- /dev/null +++ b/playground/server-auth-errors/pages/styles.css @@ -0,0 +1,72 @@ +.example-container { + box-sizing: border-box; + max-width: 100rem; + margin-inline: auto; + padding: 1rem; +} + +.example-container p { + max-width: 75ch; +} + +.page-loaded-toast { + position: fixed; + inset: 1rem auto auto 50%; + transform: translateX(-50%); + margin: 0; + padding: 1rem 1.5rem; + border: 1px solid #c2410c; + border-radius: 0.25rem; + background: #fb923c; + color: #431407; + font-size: 1.125rem; + font-weight: 700; + box-shadow: 0 4px 16px rgb(0 0 0 / 25%); +} + +.examples { + display: grid; + grid-template-columns: repeat(3, minmax(0, 1fr)); + align-items: start; + gap: 1rem 2rem; +} + +@media (max-width: 70rem) { + .examples { + grid-template-columns: repeat(2, minmax(0, 1fr)); + } +} + +@media (max-width: 46rem) { + .examples { + grid-template-columns: minmax(0, 1fr); + } +} + +.example { + min-width: 0; +} + +pre { + white-space: pre-wrap; + overflow-wrap: anywhere; +} + +code { + overflow-wrap: anywhere; +} + +.auth-form label { + display: block; + margin-block: 1rem; +} + +.auth-form input { + display: block; +} + +.action-forms { + display: flex; + flex-wrap: wrap; + gap: 1rem; +} diff --git a/playground/server-auth-errors/routes/api/demo-login.ts b/playground/server-auth-errors/routes/api/demo-login.ts new file mode 100644 index 000000000..bde1db583 --- /dev/null +++ b/playground/server-auth-errors/routes/api/demo-login.ts @@ -0,0 +1,21 @@ +import { defineHandler } from 'void'; +import { getAuth } from 'void/auth'; +import { demoUser } from '../../src/demo-user.ts'; + +// This demo always signs in the same user, regardless of the submitted fields. +export const POST = defineHandler(async (c) => { + const auth = getAuth(c); + const options = { body: demoUser, headers: c.req.raw.headers, asResponse: true } as const; + const response = await auth.api.signInEmail(options); + if (response.status !== 401) { + return response; + } + + // Initialize the demo account on the first login to a fresh database. + const created = await auth.api.signUpEmail(options); + if (created.status === 422) { + // Another first login may have created the account concurrently. + return auth.api.signInEmail(options); + } + return created; +}); diff --git a/playground/server-auth-errors/routes/api/profile.ts b/playground/server-auth-errors/routes/api/profile.ts new file mode 100644 index 000000000..450d883b1 --- /dev/null +++ b/playground/server-auth-errors/routes/api/profile.ts @@ -0,0 +1,7 @@ +import { defineHandler } from 'void'; +import { requireAuth } from 'void/auth'; + +export const GET = defineHandler((c) => { + const user = requireAuth(c); + return { name: user.name, email: user.email }; +}); diff --git a/playground/server-auth-errors/src/demo-user.ts b/playground/server-auth-errors/src/demo-user.ts new file mode 100644 index 000000000..9a4463bfa --- /dev/null +++ b/playground/server-auth-errors/src/demo-user.ts @@ -0,0 +1,5 @@ +export const demoUser = { + name: 'Demo user', + email: 'demo@example.com', + password: 'demo-password', +}; diff --git a/playground/server-auth-errors/src/require-page-user.ts b/playground/server-auth-errors/src/require-page-user.ts new file mode 100644 index 000000000..dff2f2582 --- /dev/null +++ b/playground/server-auth-errors/src/require-page-user.ts @@ -0,0 +1,12 @@ +import { HTTPException } from 'hono/http-exception'; +import type { CloudContext } from 'void'; +import { getUser } from 'void/auth'; + +export function requirePageUser(c: CloudContext, status: 302 | 303 = 302) { + const user = getUser(); + if (!user) { + const location = `/login?next=${encodeURIComponent(c.req.path)}`; + throw new HTTPException(status, { res: c.redirect(location, status) }); + } + return user; +} diff --git a/playground/server-auth-errors/src/result.tsx b/playground/server-auth-errors/src/result.tsx new file mode 100644 index 000000000..97820a1ad --- /dev/null +++ b/playground/server-auth-errors/src/result.tsx @@ -0,0 +1,16 @@ +export default function Result({ + user, + expiresAt, +}: { + user: { name: string; email: string } | null; + expiresAt?: Date | null; +}) { + return ( +
+

Loader rendered the page

+

{user ? `Signed in as ${user.email}.` : 'Anonymous visitor: user is null.'}

+ {expiresAt &&

Session expires: {expiresAt.toISOString()}

} +

This is the requested page, inside the root layout. No error boundary was selected.

+
+ ); +} diff --git a/playground/server-auth-errors/src/source-link.tsx b/playground/server-auth-errors/src/source-link.tsx new file mode 100644 index 000000000..ffba9b7ea --- /dev/null +++ b/playground/server-auth-errors/src/source-link.tsx @@ -0,0 +1,14 @@ +declare const __SERVER_AUTH_ERRORS_SOURCE_ROOT__: string; + +export function SourceLink({ file }: { file: string }) { + const source = new URL( + file.split('/').map(encodeURIComponent).join('/'), + __SERVER_AUTH_ERRORS_SOURCE_ROOT__, + ); + const host = source.host ? `//${source.host}` : ''; + return ( + + {file} + + ); +} diff --git a/playground/server-auth-errors/tsconfig.json b/playground/server-auth-errors/tsconfig.json new file mode 100644 index 000000000..ac1a4f641 --- /dev/null +++ b/playground/server-auth-errors/tsconfig.json @@ -0,0 +1,18 @@ +{ + "extends": "./.void/tsconfig.json", + "compilerOptions": { + "target": "ES2022", + "lib": ["ES2022", "DOM", "DOM.Iterable"], + "module": "NodeNext", + "moduleResolution": "NodeNext", + "strict": true, + "noUnusedLocals": true, + "esModuleInterop": true, + "skipLibCheck": true, + "jsx": "react-jsx", + "types": ["vite/client"], + "noEmit": true, + "allowImportingTsExtensions": true + }, + "include": ["pages", "routes", "middleware", "src", "*.config.ts"] +} diff --git a/playground/server-auth-errors/vite.config.ts b/playground/server-auth-errors/vite.config.ts new file mode 100644 index 000000000..4a594243f --- /dev/null +++ b/playground/server-auth-errors/vite.config.ts @@ -0,0 +1,10 @@ +import { voidReact } from '@void/react/plugin'; +import { defineConfig } from 'vite-plus'; +import { voidPlugin } from 'void'; + +export default defineConfig({ + define: { + __SERVER_AUTH_ERRORS_SOURCE_ROOT__: JSON.stringify(new URL('./', import.meta.url).href), + }, + plugins: [voidPlugin(), voidReact()], +}); diff --git a/playground/server-auth-errors/void.config.ts b/playground/server-auth-errors/void.config.ts new file mode 100644 index 000000000..2152bc9d6 --- /dev/null +++ b/playground/server-auth-errors/void.config.ts @@ -0,0 +1,10 @@ +import { defineConfig } from 'void/config'; + +export default defineConfig({ + auth: { providers: ['email'] }, + head: { + title: 'Server Auth Errors Example', + htmlAttrs: { lang: 'en' }, + meta: [{ name: 'viewport', content: 'width=device-width, initial-scale=1' }], + }, +}); diff --git a/playground/server-auth-errors/void.lock.json b/playground/server-auth-errors/void.lock.json new file mode 100644 index 000000000..393006e90 --- /dev/null +++ b/playground/server-auth-errors/void.lock.json @@ -0,0 +1,8 @@ +{ + "version": 1, + "source": {}, + "resolved": { + "compatibility_date": "2026-02-24" + }, + "text": "{\n \"compatibility_date\": \"2026-02-24\"\n}\n" +} diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index d0f5c3463..7fcfad01f 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -1715,6 +1715,40 @@ importers: specifier: workspace:* version: link:../../packages/void + playground/server-auth-errors: + dependencies: + hono: + specifier: 'catalog:' + version: 4.13.17 + react: + specifier: 'catalog:' + version: 19.3.1 + react-dom: + specifier: 'catalog:' + version: 19.3.1(react@19.3.1) + devDependencies: + '@types/react': + specifier: ^19.3.0 + version: 19.3.0 + '@types/react-dom': + specifier: ^19.3.0 + version: 19.3.0(@types/react@19.3.0) + '@void/react': + specifier: workspace:* + version: link:../../packages/react + typescript: + specifier: 'catalog:' + version: 7.0.2 + vite: + specifier: 'catalog:' + version: '@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1)' + vite-plus: + specifier: 'catalog:' + version: 1.6.0(@astrojs/compiler-rs@0.5.2)(@types/node@26.6.6)(@vitest/ui@5.1.0)(esbuild@0.28.2)(happy-dom@21.0.4)(jiti@2.7.0)(playwright@1.65.0)(sass-embedded@1.104.1)(sass@1.104.1)(svelte@5.57.2)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1) + void: + specifier: workspace:* + version: link:../../packages/void + playground/solid-pages: dependencies: hono: From ea2a65263cfb4113d7cc15b83965f8852c0d6572 Mon Sep 17 00:00:00 2001 From: Sasha Koss Date: Fri, 13 Nov 2026 11:14:30 +0800 Subject: [PATCH 2/5] docs: clarify `requireAuth` usage (closes #785) --- docs/guide/auth.md | 11 +++++++---- docs/integrations/hono.md | 21 +++++++++++++++++++++ docs/reference/api/auth.md | 2 ++ 3 files changed, 30 insertions(+), 4 deletions(-) diff --git a/docs/guide/auth.md b/docs/guide/auth.md index 7fc08cb9e..0e8045f4c 100644 --- a/docs/guide/auth.md +++ b/docs/guide/auth.md @@ -38,9 +38,9 @@ await auth.signIn.email({ }); ``` -### 3. Protect a server route +### 3. Protect a server route {#protect-a-server-route} -Call `requireAuth` in a route handler or page loader that needs a signed-in user. It returns that user, or throws `401` if the request isn't authenticated: +Call `requireAuth` in a route handler or action to get the signed-in user or reject unauthenticated requests with `401`: ```ts // routes/api/profile.ts @@ -53,7 +53,7 @@ export const GET = defineHandler((c) => { }); ``` -In a pages-mode loader, use `getUser` or `getSession` when you want to allow unauthenticated access: +In a page loader, use `getUser` and redirect unauthenticated visitors to your login page. `requireAuth` sends a plain-text `401` instead of a redirect or an error page: ```ts // pages/dashboard.server.ts @@ -62,12 +62,15 @@ import { getUser } from 'void/auth'; export type Props = InferProps; -export const loader = defineHandler(() => { +export const loader = defineHandler((c) => { const user = getUser(); + if (!user) return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`); return { user }; }); ``` +To allow unauthenticated access, return the nullable user without redirecting. For a reusable auth guard, you can [throw a redirect](../integrations/hono.md#redirects) from a helper. + ### 4. Sign out ```tsx diff --git a/docs/integrations/hono.md b/docs/integrations/hono.md index c96160611..7e981fd21 100644 --- a/docs/integrations/hono.md +++ b/docs/integrations/hono.md @@ -104,3 +104,24 @@ throw new HTTPException(404, { message: 'User not found' }); ``` For the full list of built-in middleware, see the [Hono documentation](https://hono.dev/docs/middleware/builtin). + +### Redirects + +Return `c.redirect()` from a handler to redirect. From a shared helper, throw an `HTTPException` with the redirect response in `res`. This works in loaders, actions, and middleware, including client-side page visits: + +```ts +// lib/require-page-user.ts +import { HTTPException } from 'hono/http-exception'; +import type { CloudContext } from 'void'; +import { getUser } from 'void/auth'; + +export function requirePageUser(c: CloudContext) { + const user = getUser(); + if (!user) { + throw new HTTPException(302, { res: c.redirect('/login') }); + } + return user; +} +``` + +After a mutation, use `303` for both the exception and `c.redirect('/login', 303)` so the browser follows with a GET. diff --git a/docs/reference/api/auth.md b/docs/reference/api/auth.md index d727145c0..fa0d9ae69 100644 --- a/docs/reference/api/auth.md +++ b/docs/reference/api/auth.md @@ -81,6 +81,8 @@ function getAuth(c: CloudContext): AuthInstance; Extracts the authenticated user from the request context. Throws a 401 `HTTPException` if no session is present. +Use it in route handlers or actions when you want a `401` response. In a page loader, [redirect unauthenticated visitors to login](../../guide/auth.md#protect-a-server-route) instead; `requireAuth` sends a plain-text `401`, not an error page. + ```ts import { defineHandler } from 'void'; import { requireAuth } from 'void/auth'; From 9c2dcd4eec647a7a3ec87ac81547e6528ac47bb8 Mon Sep 17 00:00:00 2001 From: Sasha Koss Date: Fri, 13 Nov 2026 16:00:49 +0800 Subject: [PATCH 3/5] feat: add `throwRedirect` option to `requireAuth` --- docs/guide/auth.md | 18 ++-- docs/reference/api/auth.md | 24 ++++- packages/void/skills/void/SKILL.md | 2 +- packages/void/src/runtime/auth.ts | 5 + .../integration/auth-types-typecheck.test.ts | 5 + .../integration/server-auth-errors.test.ts | 85 ++++++++++------- packages/void/test/unit/require-auth.test.ts | 91 +++++++++++++++++++ playground/server-auth-errors/README.md | 2 + .../server-auth-errors/middleware/auth.ts | 5 +- .../pages/actions/[mode].server.ts | 12 ++- .../pages/actions/[mode].tsx | 4 +- playground/server-auth-errors/pages/index.tsx | 42 ++++++--- .../pages/loaders/auth-redirect.server.ts | 9 ++ .../pages/loaders/auth-redirect.tsx | 1 + .../pages/loaders/return-redirect.server.ts | 2 +- .../server-auth-errors/pages/login.server.ts | 12 --- playground/server-auth-errors/pages/login.tsx | 5 +- .../pages/middleware/[mode].server.ts | 6 +- .../src/require-page-user.ts | 3 +- 19 files changed, 252 insertions(+), 81 deletions(-) create mode 100644 packages/void/test/unit/require-auth.test.ts create mode 100644 playground/server-auth-errors/pages/loaders/auth-redirect.server.ts create mode 100644 playground/server-auth-errors/pages/loaders/auth-redirect.tsx delete mode 100644 playground/server-auth-errors/pages/login.server.ts diff --git a/docs/guide/auth.md b/docs/guide/auth.md index 0e8045f4c..c302951b2 100644 --- a/docs/guide/auth.md +++ b/docs/guide/auth.md @@ -53,23 +53,28 @@ export const GET = defineHandler((c) => { }); ``` -In a page loader, use `getUser` and redirect unauthenticated visitors to your login page. `requireAuth` sends a plain-text `401` instead of a redirect or an error page: +In a page loader, pass `throwRedirect` to send unauthenticated visitors to your login page instead of a plain-text `401`: ```ts // pages/dashboard.server.ts import { defineHandler, type InferProps } from 'void'; -import { getUser } from 'void/auth'; +import { requireAuth } from 'void/auth'; export type Props = InferProps; export const loader = defineHandler((c) => { - const user = getUser(); - if (!user) return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`); + const user = requireAuth(c, { + throwRedirect: '/login', + }); return { user }; }); ``` -To allow unauthenticated access, return the nullable user without redirecting. For a reusable auth guard, you can [throw a redirect](../integrations/hono.md#redirects) from a helper. +The same option works in actions and middleware. It throws a redirect, stopping execution: `302` for GET/HEAD requests and `303` for other methods. Document requests follow the redirect normally; Pages client navigation follows it without reloading the document. + +Signing in does not replay a rejected action. + +To allow unauthenticated access, use `getUser()` and return the nullable user. For custom guards, you can also [throw a redirect](../integrations/hono.md#redirects) from a helper. ### 4. Sign out @@ -122,7 +127,8 @@ import { getSession, getUser, requireAuth } from 'void/auth'; - `getUser()` returns the current `AuthUser | null` - `getSession()` returns `{ user, session } | null` - `requireAuth(c)` returns the authenticated user or throws `401` -- [`getAuth(c)`](../reference/api/auth.md#getauth-c) returns the request's Better Auth instance, including typed plugin APIs from `auth.ts`. +- `requireAuth(c, { throwRedirect: '/login' })` returns the user or throws a login redirect +- [`getAuth(c)`](../reference/api/auth.md#getauth-c) returns the request's Better Auth instance, with plugin APIs inferred from `auth.ts`, for use with Better Auth helpers. Import `AuthUser` and `AuthSession` from `void/auth` for type annotations. They include the fields your Better Auth plugins and `user.additionalFields` add, such as `role` from `admin()`. See their fields in the [API reference](../reference/api/auth.md#authuser). diff --git a/docs/reference/api/auth.md b/docs/reference/api/auth.md index fa0d9ae69..ac1471324 100644 --- a/docs/reference/api/auth.md +++ b/docs/reference/api/auth.md @@ -77,11 +77,11 @@ Enable [authentication](../../guide/auth.md) before calling this helper; it thro function getAuth(c: CloudContext): AuthInstance; ``` -## `requireAuth(c)` {#requireauth-c} +## `requireAuth(c, options?)` {#requireauth-c} -Extracts the authenticated user from the request context. Throws a 401 `HTTPException` if no session is present. +Returns the authenticated user from the request context. Without `throwRedirect`, throws a 401 `HTTPException` if no session is present. -Use it in route handlers or actions when you want a `401` response. In a page loader, [redirect unauthenticated visitors to login](../../guide/auth.md#protect-a-server-route) instead; `requireAuth` sends a plain-text `401`, not an error page. +Use it without options in route handlers or actions when you want a plain-text `401`, not an error page: ```ts import { defineHandler } from 'void'; @@ -93,10 +93,26 @@ export const GET = defineHandler((c) => { }); ``` +For protected pages, pass `throwRedirect` to [redirect unauthenticated visitors to login](../../guide/auth.md#protect-a-server-route): + +```ts +import { defineHandler } from 'void'; +import { requireAuth } from 'void/auth'; + +export const loader = defineHandler((c) => { + const user = requireAuth(c, { throwRedirect: '/login' }); + return { email: user.email }; +}); +``` + +`throwRedirect` works in loaders, actions, and middleware. When signed out, it throws a redirect with status `302` for GET/HEAD requests or `303` for other methods, stopping execution. When signed in, it returns the user normally. + +The destination is application-controlled. + **Signature:** ```ts -function requireAuth(c: CloudContext): AuthUser; +function requireAuth(c: CloudContext, options?: { throwRedirect?: string }): AuthUser; ``` ## `AuthUser` {#authuser} diff --git a/packages/void/skills/void/SKILL.md b/packages/void/skills/void/SKILL.md index edc6e4134..24550f2c0 100644 --- a/packages/void/skills/void/SKILL.md +++ b/packages/void/skills/void/SKILL.md @@ -45,7 +45,7 @@ Use `void deploy --skip-migrations` when database migrations run separately; it | Pages mode, loader/action, forms, layouts | `docs/guide/pages-routing/*.md`, `docs/guide/type-safety.md` | | Database and migrations | `docs/guide/database.md`, `docs/guide/type-safety.md` | | Typed fetch and end-to-end typing | `docs/guide/typed-fetch.md`, `docs/guide/type-safety.md` | -| Authentication | `docs/guide/auth.md`, `docs/guide/env-vars.md` | +| Authentication | `docs/guide/auth.md`, `docs/reference/api/auth.md`, `docs/guide/env-vars.md` | | Cloudflare runtime bindings and config | `docs/integrations/cloudflare.md`, `docs/reference/config.md`, `docs/guide/env-vars.md` | | AI inference (Workers AI, providers) | `docs/guide/ai.md` | | Platform AI logging policy | `docs/reference/cli/platform-users.md#ai-gateway-logging` | diff --git a/packages/void/src/runtime/auth.ts b/packages/void/src/runtime/auth.ts index e4499d58f..6d799e260 100644 --- a/packages/void/src/runtime/auth.ts +++ b/packages/void/src/runtime/auth.ts @@ -101,9 +101,14 @@ export function getAuth(c: Context): AuthInstance { export function requireAuth( c: Context, + options?: { throwRedirect?: string }, ): AuthUser { const user = c.get('user'); if (!user) { + if (options?.throwRedirect !== undefined) { + const status = c.req.method === 'GET' || c.req.method === 'HEAD' ? 302 : 303; + throw new HTTPException(status, { res: c.redirect(options.throwRedirect, status) }); + } throw new HTTPException(401, { message: 'Unauthorized' }); } return user; diff --git a/packages/void/test/integration/auth-types-typecheck.test.ts b/packages/void/test/integration/auth-types-typecheck.test.ts index 286f2b6b5..f47204eb5 100644 --- a/packages/void/test/integration/auth-types-typecheck.test.ts +++ b/packages/void/test/integration/auth-types-typecheck.test.ts @@ -88,6 +88,11 @@ describe('generated auth types in a consumer project', () => { ' getSession()?.session.impersonatedBy;\n' + ' const user = requireAuth(c);\n' + ' const requiredRole: string | null | undefined = user.role;\n' + + ' const redirectedUser = requireAuth(c, { throwRedirect: "/login" });\n' + + ' const redirectedId: string = redirectedUser.id;\n' + + ' const redirectedRole: string | null | undefined = redirectedUser.role;\n' + + ' // @ts-expect-error throwRedirect must be a string\n' + + ' requireAuth(c, { throwRedirect: 123 });\n' + ' const fields: Record = user;\n' + ' logger.info("signed in", user);\n' + ' // @ts-expect-error not a field of the inferred user\n' + diff --git a/packages/void/test/integration/server-auth-errors.test.ts b/packages/void/test/integration/server-auth-errors.test.ts index 14678a00b..5cfdb68c7 100644 --- a/packages/void/test/integration/server-auth-errors.test.ts +++ b/packages/void/test/integration/server-auth-errors.test.ts @@ -15,7 +15,7 @@ import { launchPagesBrowser } from '../../../../test/pages-browser.ts'; const ROOT = join(import.meta.dirname, '../../../..'); const PLAYGROUND = 'playground/server-auth-errors'; const EMAIL = 'demo@example.com'; -const guards = ['require-auth', 'return-redirect', 'throw-redirect'] as const; +const guards = ['require-auth', 'return-redirect', 'throw-redirect', 'auth-redirect'] as const; const visits = ['Document load', 'Client navigation'] as const; const forms = ['Native form POST', 'Enhanced form POST'] as const; const pages = [ @@ -24,11 +24,13 @@ const pages = [ { path: '/loaders/require-auth', status: 401, heading: null }, { path: '/loaders/return-redirect', status: 302, heading: 'Sign in' }, { path: '/loaders/throw-redirect', status: 302, heading: 'Sign in' }, + { path: '/loaders/auth-redirect', status: 302, heading: 'Sign in' }, { path: '/loaders/not-found', status: 404, heading: 'Not-found boundary' }, { path: '/loaders/unexpected', status: 500, heading: 'Root error boundary' }, { path: '/middleware/require-auth', status: 401, heading: null }, { path: '/middleware/return-redirect', status: 302, heading: 'Sign in' }, { path: '/middleware/throw-redirect', status: 302, heading: 'Sign in' }, + { path: '/middleware/auth-redirect', status: 302, heading: 'Sign in' }, ] as const; let playground: IsolatedPlayground; @@ -153,7 +155,7 @@ describe.each([ } if (expectedStatus === 302) { - await expectRedirect(response, `/login?next=${encodeURIComponent(path)}`, 302); + await expectRedirect(response, '/login', 302); } else { await page.waitForURL(`${server.base}${path}`); } @@ -206,7 +208,7 @@ describe.each([ return; } - const destination = signedIn ? '/actions/success' : `/login?next=${encodeURIComponent(path)}`; + const destination = signedIn ? '/actions/success' : '/login'; await expectRedirect(response, destination, 303); expect(response.request().redirectedTo()?.method()).toBe('GET'); await page @@ -252,31 +254,44 @@ describe.each([ describe('demo session and navigation', () => { beforeEach(() => newPage()); - it('signs in with the demo user and updates the auth links', async () => { - const destination = '/loaders/throw-redirect'; - await open(); - const timeOrigin = await markLayout(); - await page.locator(`a[href="${destination}"]`).filter({ hasText: 'Client navigation' }).click(); - await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); - expect(await page.getByLabel('Email', { exact: true }).inputValue()).toBe(EMAIL); - expect(await page.getByLabel('Email', { exact: true }).isDisabled()).toBe(true); - expect(await page.getByLabel('Password', { exact: true }).inputValue()).toBe('demo-password'); - expect(await page.getByLabel('Password', { exact: true }).isDisabled()).toBe(true); - await page.getByRole('button', { name: 'Sign in', exact: true }).click(); - await page.getByRole('heading', { name: 'Loader rendered the page' }).waitFor(); - expect(page.url()).toBe(`${server.base}${destination}`); - await page.getByRole('link', { name: 'Sign out', exact: true }).waitFor(); - expect(await page.getByRole('link', { name: 'Sign in', exact: true }).count()).toBe(0); - await expectLayout(timeOrigin, true); - - await page.reload(); - await page.getByRole('link', { name: 'Sign out', exact: true }).waitFor(); - await page.getByRole('link', { name: 'Sign out', exact: true }).click(); - await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); - await page.getByRole('link', { name: 'Sign in', exact: true }).waitFor(); - expect(await page.getByRole('link', { name: 'Sign out', exact: true }).count()).toBe(0); - expect((await page.request.get(`${server.base}/api/profile`)).status()).toBe(401); - }); + it.each(['throw-redirect', 'auth-redirect'])( + 'signs in after the %s guard and updates the auth links', + async (guard) => { + const destination = `/loaders/${guard}`; + await open(); + const timeOrigin = await markLayout(); + await page + .locator(`a[href="${destination}"]`) + .filter({ hasText: 'Client navigation' }) + .click(); + await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); + expect(await page.getByLabel('Email', { exact: true }).inputValue()).toBe(EMAIL); + expect(await page.getByLabel('Email', { exact: true }).isDisabled()).toBe(true); + expect(await page.getByLabel('Password', { exact: true }).inputValue()).toBe('demo-password'); + expect(await page.getByLabel('Password', { exact: true }).isDisabled()).toBe(true); + await page.getByRole('button', { name: 'Sign in', exact: true }).click(); + await page + .getByRole('heading', { name: 'Server Auth Errors Example', exact: true }) + .waitFor(); + expect(page.url()).toBe(`${server.base}/`); + await page.getByRole('link', { name: 'Sign out', exact: true }).waitFor(); + await page + .locator(`a[href="${destination}"]`) + .filter({ hasText: 'Client navigation' }) + .click(); + await page.getByRole('heading', { name: 'Loader rendered the page' }).waitFor(); + expect(await page.getByRole('link', { name: 'Sign in', exact: true }).count()).toBe(0); + await expectLayout(timeOrigin, true); + + await page.reload(); + await page.getByRole('link', { name: 'Sign out', exact: true }).waitFor(); + await page.getByRole('link', { name: 'Sign out', exact: true }).click(); + await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); + await page.getByRole('link', { name: 'Sign in', exact: true }).waitFor(); + expect(await page.getByRole('link', { name: 'Sign out', exact: true }).count()).toBe(0); + expect((await page.request.get(`${server.base}/api/profile`)).status()).toBe(401); + }, + ); it('uses the demo credentials regardless of the submitted fields', async () => { const response = await page.request.post(`${server.base}/api/demo-login`, { @@ -312,15 +327,15 @@ describe('demo session and navigation', () => { await expect.poll(() => page.getByRole('alert').innerText()).toBe('401: Unauthorized'); } } else { - await expectRedirect(response, `/login?next=${encodeURIComponent(path)}`, 303); + await expectRedirect(response, '/login', 303); await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); } expect(await page.getByRole('heading', { name: 'Action authorized' }).count()).toBe(0); }); }); - it.each(['return-redirect', 'throw-redirect'])( - 'returns to the %s form after login without replaying its action', + it.each(['return-redirect', 'throw-redirect', 'auth-redirect'])( + 'does not replay the %s action after login', async (guard) => { const path = `/actions/${guard}`; await open(path); @@ -333,9 +348,13 @@ describe('demo session and navigation', () => { await page.getByRole('button', { name: 'Enhanced form POST' }).click(); await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); await page.getByRole('button', { name: 'Sign in', exact: true }).click(); - await page.getByRole('heading', { name: `Action: ${guard}` }).waitFor(); + await page + .getByRole('heading', { name: 'Server Auth Errors Example', exact: true }) + .waitFor(); expect(submissions).toEqual(['POST']); - expect(page.url()).toBe(`${server.base}${path}`); + expect(page.url()).toBe(`${server.base}/`); + await page.locator(`a[href="${path}"]`).filter({ hasText: 'Client navigation' }).click(); + await page.getByRole('heading', { name: `Action: ${guard}` }).waitFor(); await page.getByRole('button', { name: 'Enhanced form POST' }).click(); await page.getByRole('heading', { name: 'Action authorized' }).waitFor(); expect(submissions).toEqual(['POST', 'POST']); diff --git a/packages/void/test/unit/require-auth.test.ts b/packages/void/test/unit/require-auth.test.ts new file mode 100644 index 000000000..6627dc909 --- /dev/null +++ b/packages/void/test/unit/require-auth.test.ts @@ -0,0 +1,91 @@ +import { Hono } from 'hono'; +import { HTTPException } from 'hono/http-exception'; +import { describe, expect, it, vi } from 'vite-plus/test'; +import { requireAuth, type AuthUser } from '../../src/runtime/auth.ts'; + +const user: AuthUser = { + id: 'demo', + name: 'Demo user', + email: 'demo@example.com', + emailVerified: true, + createdAt: new Date(), + updatedAt: new Date(), +}; + +function appFor(currentUser: AuthUser | null, options?: { throwRedirect?: string }) { + const app = new Hono<{ Variables: { user: AuthUser | null } }>(); + const authorized = vi.fn(); + app.use(async (c, next) => { + c.set('user', currentUser); + await next(); + }); + app.all('/account', (c) => { + const result = requireAuth(c, options); + expect(result).toBe(currentUser); + authorized(); + return c.json({ email: result.email }); + }); + return { app, authorized }; +} + +describe('requireAuth', () => { + it.each([undefined, {}, { throwRedirect: undefined }])( + 'keeps the plain-text 401 default with options %j', + async (options) => { + const { app, authorized } = appFor(null, options); + const response = await app.request('/account'); + expect(response.status).toBe(401); + expect(response.headers.get('content-type')).toContain('text/plain'); + expect(response.headers.get('location')).toBeNull(); + expect(await response.text()).toBe('Unauthorized'); + expect(authorized).not.toHaveBeenCalled(); + }, + ); + + it.each(['GET', 'HEAD', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'])( + 'redirects unauthenticated %s requests without running protected work', + async (method) => { + const { app, authorized } = appFor(null, { throwRedirect: '/login?reason=expired' }); + const response = await app.request('/account?tab=settings', { method }); + expect(response.status).toBe(method === 'GET' || method === 'HEAD' ? 302 : 303); + expect(response.headers.get('location')).toBe('/login?reason=expired'); + expect(authorized).not.toHaveBeenCalled(); + }, + ); + + it('uses the supplied login destination without adding return parameters', async () => { + const { app } = appFor(null, { throwRedirect: '/login' }); + const response = await app.request('/account?tab=settings'); + expect(response.headers.get('location')).toBe('/login'); + }); + + it('throws an HTTPException carrying the redirect response from a nested helper', async () => { + const { app } = appFor(null); + app.get('/nested', (c) => { + const guard = () => requireAuth(c, { throwRedirect: '/login' }); + expect(guard).toThrow(HTTPException); + try { + guard(); + } catch (error) { + expect(error).toBeInstanceOf(HTTPException); + const exception = error as HTTPException; + expect(exception.status).toBe(302); + expect(exception.getResponse().headers.get('location')).toBe('/login'); + throw error; + } + return c.text('protected'); + }); + expect((await app.request('/nested')).status).toBe(302); + }); + + it.each([undefined, { throwRedirect: '/login' }])( + 'returns the authenticated user with options %j', + async (options) => { + const { app, authorized } = appFor(user, options); + const response = await app.request('/account'); + expect(response.status).toBe(200); + expect(await response.json()).toEqual({ email: user.email }); + expect(authorized).toHaveBeenCalledOnce(); + }, + ); +}); diff --git a/playground/server-auth-errors/README.md b/playground/server-auth-errors/README.md index 38fe2ee11..4205a2c7e 100644 --- a/playground/server-auth-errors/README.md +++ b/playground/server-auth-errors/README.md @@ -14,6 +14,8 @@ Submit `/login` to sign in as the demo user, then repeat the examples. The disab Source links open the corresponding files in VS Code. Use the Network panel with Preserve log to inspect statuses and redirects. The shared guard in `src/require-page-user.ts` throws a `302` for page visits or a `303` for actions. +The `requireAuth with throwRedirect` examples use the built-in option instead: `302` for GET/HEAD and `303` for other methods. All auth redirects go to `/login`; signing in opens the example grid. + ## Tests Run the Vitest browser integration from the repository root: diff --git a/playground/server-auth-errors/middleware/auth.ts b/playground/server-auth-errors/middleware/auth.ts index 2738b18d6..8108253df 100644 --- a/playground/server-auth-errors/middleware/auth.ts +++ b/playground/server-auth-errors/middleware/auth.ts @@ -7,10 +7,13 @@ export default defineMiddleware(async (c, next) => { requireAuth(c); } if (c.req.path === '/middleware/return-redirect' && !getUser()) { - return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`); + return c.redirect('/login'); } if (c.req.path === '/middleware/throw-redirect') { requirePageUser(c); } + if (c.req.path === '/middleware/auth-redirect') { + requireAuth(c, { throwRedirect: '/login' }); + } await next(); }); diff --git a/playground/server-auth-errors/pages/actions/[mode].server.ts b/playground/server-auth-errors/pages/actions/[mode].server.ts index 905791c7e..11dc76cef 100644 --- a/playground/server-auth-errors/pages/actions/[mode].server.ts +++ b/playground/server-auth-errors/pages/actions/[mode].server.ts @@ -5,7 +5,12 @@ import { requirePageUser } from '../../src/require-page-user.ts'; function mode(c: CloudContext) { const value = c.req.param('mode'); - if (value === 'require-auth' || value === 'return-redirect' || value === 'throw-redirect') { + if ( + value === 'require-auth' || + value === 'return-redirect' || + value === 'throw-redirect' || + value === 'auth-redirect' + ) { return value; } throw new HTTPException(404); @@ -22,11 +27,14 @@ export const action = defineHandler((c) => { requireAuth(c); } if (variant === 'return-redirect' && !getUser()) { - return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`, 303); + return c.redirect('/login', 303); } if (variant === 'throw-redirect') { requirePageUser(c, 303); } + if (variant === 'auth-redirect') { + requireAuth(c, { throwRedirect: '/login' }); + } // A real mutation would run here, only after the auth check succeeds. return c.redirect('/actions/success', 303); diff --git a/playground/server-auth-errors/pages/actions/[mode].tsx b/playground/server-auth-errors/pages/actions/[mode].tsx index ce4a00418..e0cafddd8 100644 --- a/playground/server-auth-errors/pages/actions/[mode].tsx +++ b/playground/server-auth-errors/pages/actions/[mode].tsx @@ -34,8 +34,8 @@ export default function ActionExample({ mode, email }: Props) { ) : (

- When signed out, both forms redirect to login with 303. Signing in returns to this form; - it does not replay the rejected action. + When signed out, both forms redirect to login with 303. Signing in does not replay the + rejected action.

)}
diff --git a/playground/server-auth-errors/pages/index.tsx b/playground/server-auth-errors/pages/index.tsx index 7dc0fe1f4..bc8dc9855 100644 --- a/playground/server-auth-errors/pages/index.tsx +++ b/playground/server-auth-errors/pages/index.tsx @@ -30,19 +30,27 @@ const loaders = [ { mode: 'return-redirect', title: 'Return a login redirect', - code: 'const user = getUser();\nif (!user) return c.redirect(\n `/login?next=${encodeURIComponent(c.req.path)}`\n);\nreturn { user };', - document: '302 to login with a return path.', + code: "const user = getUser();\nif (!user) return c.redirect('/login');\nreturn { user };", + document: '302 to login.', navigation: 'Visits login without reloading the document.', - note: 'Sign in to continue to the requested page.', + note: 'Redirects before the protected work runs.', }, { mode: 'throw-redirect', title: 'Throw a redirect from a helper', code: '// Inside requirePageUser(c):\nif (!user) {\n throw new HTTPException(302, {\n res: c.redirect(location, 302),\n });\n}\nreturn user;', - document: '302 to login with a return path.', + document: '302 to login.', navigation: 'Visits login without reloading the document, like a returned redirect.', note: 'The helper stops execution without returning a Response to its caller.', }, + { + mode: 'auth-redirect', + title: 'requireAuth(): login redirect', + code: "const user = requireAuth(c, { throwRedirect: '/login' });\nreturn { user };", + document: '302 to login.', + navigation: 'Visits login without reloading the document.', + note: 'Returns the user or throws a redirect.', + }, { mode: 'not-found', title: 'Throw 404 for comparison', @@ -73,8 +81,8 @@ const guards = [ { mode: 'return-redirect', title: 'Returned redirect', - code: 'if (!getUser()) return c.redirect(location);', - document: '302 to login with a return path.', + code: "if (!getUser()) return c.redirect('/login');", + document: '302 to login.', navigation: 'Visits login without reloading the document.', note: 'Redirects before the loader runs.', }, @@ -82,10 +90,18 @@ const guards = [ mode: 'throw-redirect', title: 'Thrown redirect', code: 'requirePageUser(c);', - document: '302 to login with a return path.', + document: '302 to login.', navigation: 'Visits login without reloading the document.', note: 'The shared helper throws a redirect before the loader runs.', }, + { + mode: 'auth-redirect', + title: 'requireAuth with throwRedirect', + code: "requireAuth(c, { throwRedirect: '/login' });", + document: '302 to login.', + navigation: 'Visits login without reloading the document.', + note: 'Throws a redirect before the loader runs.', + }, ] as const; function Visits({ path }: { path: string }) { @@ -208,7 +224,7 @@ export default function Home() { the same protected action. Redirects use 303 so the next request is a GET.

- {guards.map(({ mode, title }) => ( + {guards.map(({ mode, title, code }) => (

@@ -233,9 +251,7 @@ export default function Home() { ? 'Displays 401 inline or throws to the client error boundary.' : 'Visits login without reloading the document.'}

- {mode !== 'require-auth' && ( -

Signing in returns to the form; it does not replay the rejected action.

- )} + {mode !== 'require-auth' &&

Signing in does not replay the rejected action.

}

Expected when signed in

Both forms redirect to the success page with 303. No application data is written. diff --git a/playground/server-auth-errors/pages/loaders/auth-redirect.server.ts b/playground/server-auth-errors/pages/loaders/auth-redirect.server.ts new file mode 100644 index 000000000..f359ba221 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/auth-redirect.server.ts @@ -0,0 +1,9 @@ +import { defineHandler } from 'void'; +import { requireAuth } from 'void/auth'; + +export const loader = defineHandler((c) => { + const user = requireAuth(c, { + throwRedirect: '/login', + }); + return { user }; +}); diff --git a/playground/server-auth-errors/pages/loaders/auth-redirect.tsx b/playground/server-auth-errors/pages/loaders/auth-redirect.tsx new file mode 100644 index 000000000..2818feb45 --- /dev/null +++ b/playground/server-auth-errors/pages/loaders/auth-redirect.tsx @@ -0,0 +1 @@ +export { default } from '../../src/result.tsx'; diff --git a/playground/server-auth-errors/pages/loaders/return-redirect.server.ts b/playground/server-auth-errors/pages/loaders/return-redirect.server.ts index 22de0c02f..1ac26d920 100644 --- a/playground/server-auth-errors/pages/loaders/return-redirect.server.ts +++ b/playground/server-auth-errors/pages/loaders/return-redirect.server.ts @@ -4,7 +4,7 @@ import { getUser } from 'void/auth'; export const loader = defineHandler((c) => { const user = getUser(); if (!user) { - return c.redirect(`/login?next=${encodeURIComponent(c.req.path)}`); + return c.redirect('/login'); } return { user }; }); diff --git a/playground/server-auth-errors/pages/login.server.ts b/playground/server-auth-errors/pages/login.server.ts deleted file mode 100644 index a9b0bb956..000000000 --- a/playground/server-auth-errors/pages/login.server.ts +++ /dev/null @@ -1,12 +0,0 @@ -import { defineHandler, type InferProps } from 'void'; - -export type Props = InferProps; - -export const loader = defineHandler((c) => { - const destination = new URL(c.req.query('next') || '/', c.req.url); - const next = - destination.origin === new URL(c.req.url).origin - ? destination.pathname + destination.search - : '/'; - return { next }; -}); diff --git a/playground/server-auth-errors/pages/login.tsx b/playground/server-auth-errors/pages/login.tsx index 28280cd63..936253e3f 100644 --- a/playground/server-auth-errors/pages/login.tsx +++ b/playground/server-auth-errors/pages/login.tsx @@ -2,9 +2,8 @@ import { useRouter } from '@void/react'; import { useState, type FormEvent } from 'react'; import { auth } from 'void/client/react'; import { demoUser } from '../src/demo-user.ts'; -import type { Props } from './login.server.ts'; -export default function Login({ next }: Props) { +export default function Login() { const [pending, setPending] = useState(false); const [error, setError] = useState(''); const router = useRouter(); @@ -20,7 +19,7 @@ export default function Login({ next }: Props) { throw new Error('Could not start the demo session.'); } await refetch(); - await router.visit(next); + await router.visit('/'); } catch (error) { setError(error instanceof Error ? error.message : 'Could not sign in.'); } finally { diff --git a/playground/server-auth-errors/pages/middleware/[mode].server.ts b/playground/server-auth-errors/pages/middleware/[mode].server.ts index d44a5b405..c3c28dfa1 100644 --- a/playground/server-auth-errors/pages/middleware/[mode].server.ts +++ b/playground/server-auth-errors/pages/middleware/[mode].server.ts @@ -3,7 +3,11 @@ import { defineHandler } from 'void'; import { getUser } from 'void/auth'; export const loader = defineHandler((c) => { - if (!['require-auth', 'return-redirect', 'throw-redirect'].includes(c.req.param('mode') ?? '')) { + if ( + !['require-auth', 'return-redirect', 'throw-redirect', 'auth-redirect'].includes( + c.req.param('mode') ?? '', + ) + ) { throw new HTTPException(404); } return { user: getUser() }; diff --git a/playground/server-auth-errors/src/require-page-user.ts b/playground/server-auth-errors/src/require-page-user.ts index dff2f2582..f50a60260 100644 --- a/playground/server-auth-errors/src/require-page-user.ts +++ b/playground/server-auth-errors/src/require-page-user.ts @@ -5,8 +5,7 @@ import { getUser } from 'void/auth'; export function requirePageUser(c: CloudContext, status: 302 | 303 = 302) { const user = getUser(); if (!user) { - const location = `/login?next=${encodeURIComponent(c.req.path)}`; - throw new HTTPException(status, { res: c.redirect(location, status) }); + throw new HTTPException(status, { res: c.redirect('/login', status) }); } return user; } From 66a3498088a129e39878ba814ae6912812e6653b Mon Sep 17 00:00:00 2001 From: Sasha Koss Date: Fri, 13 Nov 2026 16:38:26 +0800 Subject: [PATCH 4/5] chore: fix pnpm lock file after rebase main --- pnpm-lock.yaml | 44 ++++++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 7fcfad01f..0e2591bd2 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -1574,7 +1574,7 @@ importers: dependencies: nuxt: specifier: 'catalog:' - version: 4.6.4(28cabe179d6b5d1d97f7fc0415b8148e) + version: 4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b) devDependencies: pathslash: specifier: 'catalog:' @@ -1719,7 +1719,7 @@ importers: dependencies: hono: specifier: 'catalog:' - version: 4.13.17 + version: 4.13.18 react: specifier: 'catalog:' version: 19.3.1 @@ -1744,7 +1744,7 @@ importers: version: '@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1)' vite-plus: specifier: 'catalog:' - version: 1.6.0(@astrojs/compiler-rs@0.5.2)(@types/node@26.6.6)(@vitest/ui@5.1.0)(esbuild@0.28.2)(happy-dom@21.0.4)(jiti@2.7.0)(playwright@1.65.0)(sass-embedded@1.104.1)(sass@1.104.1)(svelte@5.57.2)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1) + version: 1.6.0(@astrojs/compiler-rs@0.5.3)(@types/node@26.6.6)(@vitest/ui@5.1.0)(esbuild@0.28.2)(happy-dom@21.0.4)(jiti@2.7.0)(playwright@1.65.0)(sass-embedded@1.104.1)(sass@1.104.1)(svelte@5.57.2)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1) void: specifier: workspace:* version: link:../../packages/void @@ -12440,10 +12440,10 @@ snapshots: - magic-string - unplugin - '@nuxt/nitro-server@4.6.4(11c7add04b75266a45f152ffa44abd58)': + '@nuxt/nitro-server@4.6.4(4420c67e34a1beb2667caeefcf5ec4ed)': dependencies: '@nuxt/kit': 4.6.4(@nuxt/schema@4.6.4)(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))) - '@unhead/vue': 3.4.3(@oxc-project/types@0.156.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(vue@3.5.45(typescript@7.0.2))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) + '@unhead/vue': 3.4.3(@oxc-project/types@0.158.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(vue@3.5.45(typescript@7.0.2))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) consola: 3.4.2 defu: 6.1.7 destr: 2.0.5 @@ -12459,7 +12459,7 @@ snapshots: my-bad: 0.2.12(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1)) nitropack: 2.13.6(@electric-sql/pglite@0.5.16)(@parcel/watcher@2.6.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(aws4fetch@1.0.20)(bare-buffer@3.7.1)(better-sqlite3@13.0.3)(drizzle-orm@0.45.4(@cloudflare/workers-types@5.20261110.1)(@electric-sql/pglite@0.5.16)(@types/better-sqlite3@9.6.0)(@types/pg@8.23.1)(better-sqlite3@13.0.3)(kysely@0.29.8)(mysql2@3.24.6(@types/node@26.6.6))(pg@8.23.1))(mysql2@3.24.6(@types/node@26.6.6))(oxc-parser@0.156.0)(rolldown@1.3.1)(srvx@1.0.8)(supports-color@10.2.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) nostics: 1.3.0 - nuxt: 4.6.4(28cabe179d6b5d1d97f7fc0415b8148e) + nuxt: 4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b) ohash: 2.0.12 pathe: 2.0.3 radix3: 1.1.2 @@ -12550,7 +12550,7 @@ snapshots: rc9: 3.1.0 std-env: 4.3.0 - '@nuxt/vite-builder@4.6.4(926b91ff9d9fff80aa13715ef35bb050)': + '@nuxt/vite-builder@4.6.4(6fcbe3d3dcc90cf47c525e8ae510ae9b)': dependencies: '@nuxt/kit': 4.6.4(@nuxt/schema@4.6.4)(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))) '@vitejs/plugin-vue': 6.0.10(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(vue@3.5.45(typescript@7.0.2)) @@ -12568,7 +12568,7 @@ snapshots: knitwork: 1.3.0 mocked-exports: 0.1.1 my-bad: 0.2.12(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1)) - nuxt: 4.6.4(28cabe179d6b5d1d97f7fc0415b8148e) + nuxt: 4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b) pathe: 2.0.3 pkg-types: 2.4.0 postcss: 8.5.32 @@ -12631,7 +12631,7 @@ snapshots: - webpack - yaml - '@nuxt/vite-server@4.6.4(@nuxt/schema@4.6.4)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(nuxt@4.6.4(28cabe179d6b5d1d97f7fc0415b8148e))(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))': + '@nuxt/vite-server@4.6.4(@nuxt/schema@4.6.4)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(nuxt@4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b))(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))': dependencies: '@nuxt/kit': 4.6.4(@nuxt/schema@4.6.4)(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))) clickable-path: 0.1.1 @@ -12639,7 +12639,7 @@ snapshots: exsolve: 1.2.0 mocked-exports: 0.1.1 my-bad: 0.2.12(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1)) - nuxt: 4.6.4(28cabe179d6b5d1d97f7fc0415b8148e) + nuxt: 4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b) pathe: 2.0.3 rou3: 0.9.2 srvx: 1.0.5 @@ -14006,10 +14006,10 @@ snapshots: '@ungap/structured-clone@1.4.0': {} - '@unhead/bundler@3.4.3(@oxc-project/types@0.156.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(unhead@3.4.3(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))': + '@unhead/bundler@3.4.3(@oxc-project/types@0.158.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(unhead@3.4.3(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))': dependencies: magic-string: 1.4.5 - oxc-walker: 1.1.1(@oxc-project/types@0.156.0)(oxc-parser@0.156.0)(rolldown@1.3.1) + oxc-walker: 1.1.1(@oxc-project/types@0.158.0)(oxc-parser@0.156.0)(rolldown@1.3.1) unhead: 3.4.3(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) unplugin: 3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) optionalDependencies: @@ -14028,9 +14028,9 @@ snapshots: - rollup - unloader - '@unhead/vue@3.4.3(@oxc-project/types@0.156.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(vue@3.5.45(typescript@7.0.2))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))': + '@unhead/vue@3.4.3(@oxc-project/types@0.158.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(vue@3.5.45(typescript@7.0.2))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))': dependencies: - '@unhead/bundler': 3.4.3(@oxc-project/types@0.156.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(unhead@3.4.3(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) + '@unhead/bundler': 3.4.3(@oxc-project/types@0.158.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(unhead@3.4.3(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) hookable: 6.1.2 unhead: 3.4.3(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) unplugin: 3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) @@ -17091,7 +17091,7 @@ snapshots: dependencies: boolbase: 2.0.0 - nuxt@4.6.4(28cabe179d6b5d1d97f7fc0415b8148e): + nuxt@4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b): dependencies: '@dxup/nuxt': 0.5.11(@nuxt/schema@4.6.4)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(confbox@0.3.2)(dotenv@17.4.2)(esbuild@0.28.2)(giget@3.3.1)(jiti@2.7.0)(mlly@1.8.2)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) '@jridgewell/trace-mapping': 0.3.31 @@ -17099,12 +17099,12 @@ snapshots: '@nuxt/devalue': 2.0.2 '@nuxt/devtools': 3.4.4(0696d073fe5f9c60158611c26666c741) '@nuxt/kit': 4.6.4(@nuxt/schema@4.6.4)(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))) - '@nuxt/nitro-server': 4.6.4(11c7add04b75266a45f152ffa44abd58) + '@nuxt/nitro-server': 4.6.4(4420c67e34a1beb2667caeefcf5ec4ed) '@nuxt/schema': 4.6.4 '@nuxt/telemetry': 2.9.1(@nuxt/kit@4.6.4(@nuxt/schema@4.6.4)(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))) - '@nuxt/vite-builder': 4.6.4(926b91ff9d9fff80aa13715ef35bb050) - '@nuxt/vite-server': 4.6.4(@nuxt/schema@4.6.4)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(nuxt@4.6.4(28cabe179d6b5d1d97f7fc0415b8148e))(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))) - '@unhead/vue': 3.4.3(@oxc-project/types@0.156.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(vue@3.5.45(typescript@7.0.2))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) + '@nuxt/vite-builder': 4.6.4(6fcbe3d3dcc90cf47c525e8ae510ae9b) + '@nuxt/vite-server': 4.6.4(@nuxt/schema@4.6.4)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(confbox@0.3.2)(dotenv@17.4.2)(giget@3.3.1)(jiti@2.7.0)(magic-string@1.4.5)(mlly@1.8.2)(nuxt@4.6.4(bb0ed2b01b3594c95f4ec08c384cb46b))(oxc-parser@0.156.0)(rolldown@1.3.1)(unplugin@3.7.0(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(rolldown@1.3.1)(rollup@4.68.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0))) + '@unhead/vue': 3.4.3(@oxc-project/types@0.158.0)(@voidzero-dev/vite-plus-core@1.6.0(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(typescript@7.0.2)(yaml@2.9.1))(esbuild@0.28.2)(lightningcss@1.33.0)(oxc-parser@0.156.0)(rolldown@1.3.1)(rollup@4.68.2)(vue@3.5.45(typescript@7.0.2))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.32))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.32)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) '@vue/shared': 3.5.45 chokidar: 5.0.0 clickable-path: 0.1.1 @@ -17134,7 +17134,7 @@ snapshots: ofetch: 1.5.1 ohash: 2.0.12 on-change: 6.0.2 - oxc-walker: 1.1.1(@oxc-project/types@0.156.0)(oxc-parser@0.156.0)(rolldown@1.3.1) + oxc-walker: 1.1.1(@oxc-project/types@0.158.0)(oxc-parser@0.156.0)(rolldown@1.3.1) pathe: 2.0.3 perfect-debounce: 2.1.0 picomatch: 4.0.7 @@ -17367,9 +17367,9 @@ snapshots: '@oxc-parser/binding-win32-ia32-msvc': 0.156.0 '@oxc-parser/binding-win32-x64-msvc': 0.156.0 - oxc-walker@1.1.1(@oxc-project/types@0.156.0)(oxc-parser@0.156.0)(rolldown@1.3.1): + oxc-walker@1.1.1(@oxc-project/types@0.158.0)(oxc-parser@0.156.0)(rolldown@1.3.1): optionalDependencies: - '@oxc-project/types': 0.156.0 + '@oxc-project/types': 0.158.0 oxc-parser: 0.156.0 rolldown: 1.3.1 From e3bf8a9840b625ce8a80342f231e6f642e741d56 Mon Sep 17 00:00:00 2001 From: Sasha Koss Date: Fri, 13 Nov 2026 16:56:30 +0800 Subject: [PATCH 5/5] chore: fix test failures caused by returned status code changes --- .../integration/server-auth-errors.test.ts | 35 ++++++++++++++----- 1 file changed, 27 insertions(+), 8 deletions(-) diff --git a/packages/void/test/integration/server-auth-errors.test.ts b/packages/void/test/integration/server-auth-errors.test.ts index 5cfdb68c7..c855b122b 100644 --- a/packages/void/test/integration/server-auth-errors.test.ts +++ b/packages/void/test/integration/server-auth-errors.test.ts @@ -122,8 +122,19 @@ function responseFor(path: string, method = 'GET') { ); } -async function expectRedirect(response: Response, destination: string, status: number) { - expect(response.status()).toBe(status); +async function expectRedirect( + response: Response, + destination: string, + status: number, + enhanced = false, +) { + // Pages negotiates redirects as HTTP 200 so fetch can read Location (including + // fragments). Document requests keep the original HTTP redirect status. + expect(response.status()).toBe(enhanced ? 200 : status); + expect(await response.request().headerValue('X-VoidPages-Redirect')).toBe( + enhanced ? 'manual' : null, + ); + expect(await response.headerValue('X-VoidPages-Redirect')).toBe(enhanced ? String(status) : null); expect(await response.headerValue('location')).toBe(destination); await page.waitForURL(`${server.base}${destination}`); } @@ -142,7 +153,9 @@ describe.each([ await page.locator(`a[href="${path}"]`).filter({ hasText: visit }).click(); const response = await pending; const expectedStatus = signedIn ? 200 : status; - expect(response.status()).toBe(expectedStatus); + if (expectedStatus !== 302) { + expect(response.status()).toBe(expectedStatus); + } if (expectedStatus === 401) { await expect.poll(() => page.locator('body').innerText()).toBe('Unauthorized'); @@ -155,7 +168,7 @@ describe.each([ } if (expectedStatus === 302) { - await expectRedirect(response, '/login', 302); + await expectRedirect(response, '/login', 302, visit === 'Client navigation'); } else { await page.waitForURL(`${server.base}${path}`); } @@ -189,6 +202,8 @@ describe.each([ await open(path, signedIn); const timeOrigin = await markLayout(); const pending = responseFor(path, 'POST'); + const destination = signedIn ? '/actions/success' : '/login'; + const followUp = signedIn || guard !== 'require-auth' ? responseFor(destination) : undefined; await page.getByRole('button', { name: form, exact: true }).click(); const response = await pending; @@ -208,9 +223,11 @@ describe.each([ return; } - const destination = signedIn ? '/actions/success' : '/login'; - await expectRedirect(response, destination, 303); - expect(response.request().redirectedTo()?.method()).toBe('GET'); + await expectRedirect(response, destination, 303, form === 'Enhanced form POST'); + expect((await followUp)?.status()).toBe(200); + if (form === 'Native form POST') { + expect(response.request().redirectedTo()?.method()).toBe('GET'); + } await page .getByRole('heading', { name: signedIn ? 'Action authorized' : 'Sign in', @@ -316,6 +333,7 @@ describe('demo session and navigation', () => { }); expect(signedOut.status()).toBe(200); const pending = responseFor(path, 'POST'); + const followUp = guard !== 'require-auth' ? responseFor('/login') : undefined; await page.getByRole('button', { name: form, exact: true }).click(); const response = await pending; @@ -327,7 +345,8 @@ describe('demo session and navigation', () => { await expect.poll(() => page.getByRole('alert').innerText()).toBe('401: Unauthorized'); } } else { - await expectRedirect(response, '/login', 303); + await expectRedirect(response, '/login', 303, form === 'Enhanced form POST'); + expect((await followUp)?.status()).toBe(200); await page.getByRole('heading', { name: 'Sign in', exact: true }).waitFor(); } expect(await page.getByRole('heading', { name: 'Action authorized' }).count()).toBe(0);