@pyreon/router 0.24.4 → 0.24.6

package/src/not-found.ts

@@ -1,75 +0,0 @@
-import type { ComponentFn, Props, VNodeChild } from '@pyreon/core'
-import { ErrorBoundary, h } from '@pyreon/core'
-
-// ─── NotFound symbol + throw ────────────────────────────────────────────────
-
-const NOT_FOUND = Symbol.for('pyreon.notFound')
-
-/**
- * Throw inside a route loader or component to trigger the nearest
- * NotFoundBoundary. Inspired by Next.js's `notFound()`.
- *
- * @example
- * ```ts
- * // In a loader:
- * loader: async ({ params }) => {
- *   const user = await fetchUser(params.id)
- *   if (!user) notFound()
- *   return user
- * }
- * ```
- */
-export function notFound(message?: string): never {
-  const err = new Error(message ?? 'Not Found')
-  ;(err as unknown as Record<symbol, unknown>)[NOT_FOUND] = true
-  throw err
-}
-
-/** Check if an error is a NotFoundError thrown by `notFound()`. */
-export function isNotFoundError(err: unknown): boolean {
-  return (
-    typeof err === 'object' &&
-    err !== null &&
-    (err as Record<string | symbol, unknown>)[NOT_FOUND] === true
-  )
-}
-
-// ─── NotFoundBoundary ──────────────────────────────────────────────────────
-
-export interface NotFoundBoundaryProps extends Props {
-  /** Component or VNode to render when notFound() is thrown */
-  fallback: ComponentFn | VNodeChild
-  children?: VNodeChild
-}
-
-/**
- * Catches `notFound()` errors from child route components or loaders
- * and renders the fallback. Wraps Pyreon's ErrorBoundary with notFound
- * detection — non-notFound errors propagate to parent error boundaries.
- *
- * @example
- * ```tsx
- * <NotFoundBoundary fallback={<NotFoundPage />}>
- *   <RouterView />
- * </NotFoundBoundary>
- * ```
- */
-export const NotFoundBoundary: ComponentFn<NotFoundBoundaryProps> = (props) => {
-  return h(
-    ErrorBoundary,
-    {
-      fallback: (err: unknown, reset: () => void) => {
-        if (!isNotFoundError(err)) {
-          // Re-throw non-notFound errors so they propagate
-          throw err
-        }
-        const fb = props.fallback
-        if (typeof fb === 'function' && fb.length <= 1) {
-          return h(fb as ComponentFn, { error: err, reset })
-        }
-        return fb as VNodeChild
-      },
-    },
-    props.children,
-  )
-}

package/src/redirect.ts

@@ -1,63 +0,0 @@
-// ─── Redirect symbol + throw ────────────────────────────────────────────────
-
-const REDIRECT = Symbol.for('pyreon.redirect')
-
-/** Standard redirect status codes. 307/308 preserve the request method, 302/303 don't. */
-export type RedirectStatus = 301 | 302 | 303 | 307 | 308
-
-interface RedirectInfo {
-  url: string
-  status: RedirectStatus
-}
-
-/**
- * Throw inside a route loader to redirect the navigation server-side
- * (during SSR returns a 302/307 `Location:` response) and client-side
- * (during CSR triggers `router.replace()` before the layout renders).
- *
- * The auth-gate use case: replaces the fragile `onMount + router.push()`
- * workaround. `onMount` doesn't fire reliably under nested-layout dev SSR +
- * hydration — so the layout renders briefly before the push happens, leaking
- * authenticated UI to unauthenticated users. `redirect()` runs in the loader
- * BEFORE the layout's component is invoked, so the unauthenticated UI never
- * mounts in the first place.
- *
- * @example
- * ```ts
- * // src/routes/app/_layout.tsx
- * export const loader = async ({ request }) => {
- *   const session = await getSession(request)
- *   if (!session) redirect('/login')
- *   return { user: session.user }
- * }
- * ```
- *
- * @param url - Target URL (typically a path like `/login` or absolute URL for cross-origin).
- * @param status - HTTP redirect status. Default `307` (Temporary Redirect, method-preserving).
- *   Use `301`/`308` for permanent moves, `302`/`303` to force GET on the target.
- */
-export function redirect(url: string, status: RedirectStatus = 307): never {
-  const err = new Error(`Redirect to ${url}`)
-  ;(err as unknown as Record<symbol, RedirectInfo>)[REDIRECT] = { url, status }
-  throw err
-}
-
-/** Check if an error is a RedirectError thrown by `redirect()`. */
-export function isRedirectError(err: unknown): boolean {
-  return (
-    typeof err === 'object' &&
-    err !== null &&
-    typeof (err as Record<symbol, unknown>)[REDIRECT] === 'object'
-  )
-}
-
-/**
- * Extract the redirect URL and status from a thrown RedirectError. Returns
- * `null` if `err` isn't a RedirectError. Used by the router's loader-runner
- * (CSR) and the SSR handler to convert the thrown error into the right kind
- * of response (a `router.replace()` call or a `302`/`307` Response).
- */
-export function getRedirectInfo(err: unknown): RedirectInfo | null {
-  if (!isRedirectError(err)) return null
-  return (err as Record<symbol, RedirectInfo>)[REDIRECT] ?? null
-}