create-fluxstack 1.22.0 → 1.22.1

package/app/client/src/pages/auth.tsx

@@ -1,13 +1,13 @@
-// Página /auth (file-based). Demo Live — React normal.
-import { LivePage } from '../framework/LivePage'
-import { AuthDemo } from '../live/AuthDemo'
-
-export const title = 'Auth'
-
-export default function AuthPage() {
-  return (
-    <LivePage title="Auth" description="Autenticação declarativa para Live Components com $auth.">
-      <AuthDemo />
-    </LivePage>
-  )
-}
+// Página /auth (file-based). Demo Live — React normal.
+import { LivePage } from '../framework/LivePage'
+import { AuthDemo } from '../live/AuthDemo'
+
+export const title = 'Auth'
+
+export default function AuthPage() {
+  return (
+    <LivePage title="Auth" description="Autenticação declarativa para Live Components com $auth.">
+      <AuthDemo />
+    </LivePage>
+  )
+}

package/app/client/src/pages/blog/[slug].tsx

@@ -1,23 +1,23 @@
-// Rota DINÂMICA /blog/:slug (file-based: pages/blog/[slug].tsx).
-// Server component (0 JS) — recebe os params como PROP. Funciona no server.
-import type { PageProps } from '../../framework/routes'
-
-export const title = 'Blog Post'
-
-export default function BlogPost({ params }: PageProps) {
-  const slug = params.slug as string
-  return (
-    <div className="relative min-h-[calc(100vh-57px)] px-4 py-10">
-      <div className="absolute inset-0 app-grid-bg opacity-70" />
-      <div className="relative z-10 mx-auto max-w-3xl">
-        <a href="/blog" className="text-sm text-gray-400 hover:text-white">← Blog</a>
-        <h1 className="mt-4 text-4xl font-semibold text-white">Post: {slug}</h1>
-        <p className="mt-4 text-gray-400">
-          Rota dinâmica renderizada no <strong>server</strong> (0 JS). O slug
-          <code className="text-theme"> {slug} </code> veio de <code className="text-theme">params</code>,
-          extraído da URL pelo roteador file-based — arquivo <code className="text-theme">pages/blog/[slug].tsx</code>.
-        </p>
-      </div>
-    </div>
-  )
-}
+// Rota DINÂMICA /blog/:slug (file-based: pages/blog/[slug].tsx).
+// Server component (0 JS) — recebe os params como PROP. Funciona no server.
+import type { PageProps } from '../../framework/routes'
+
+export const title = 'Blog Post'
+
+export default function BlogPost({ params }: PageProps) {
+  const slug = params.slug as string
+  return (
+    <div className="relative min-h-[calc(100vh-57px)] px-4 py-10">
+      <div className="absolute inset-0 app-grid-bg opacity-70" />
+      <div className="relative z-10 mx-auto max-w-3xl">
+        <a href="/blog" className="text-sm text-gray-400 hover:text-white">← Blog</a>
+        <h1 className="mt-4 text-4xl font-semibold text-white">Post: {slug}</h1>
+        <p className="mt-4 text-gray-400">
+          Rota dinâmica renderizada no <strong>server</strong> (0 JS). O slug
+          <code className="text-theme"> {slug} </code> veio de <code className="text-theme">params</code>,
+          extraído da URL pelo roteador file-based — arquivo <code className="text-theme">pages/blog/[slug].tsx</code>.
+        </p>
+      </div>
+    </div>
+  )
+}

package/app/client/src/pages/counter.tsx

@@ -1,15 +1,15 @@
-// Página /counter (file-based). Demo Live — React normal.
-// O CounterDemo usa Live.use(); no server vira placeholder (guarda SSR),
-// no client monta e conecta. O LivePage cuida do Provider/ClientOnly.
-import { LivePage } from '../framework/LivePage'
-import { CounterDemo } from '../live/CounterDemo'
-
-export const title = 'Counters'
-
-export default function CounterPage() {
-  return (
-    <LivePage title="Counters" description="Estado local, sala isolada e sala compartilhada em tempo real.">
-      <CounterDemo />
-    </LivePage>
-  )
-}
+// Página /counter (file-based). Demo Live — React normal.
+// O CounterDemo usa Live.use(); no server vira placeholder (guarda SSR),
+// no client monta e conecta. O LivePage cuida do Provider/ClientOnly.
+import { LivePage } from '../framework/LivePage'
+import { CounterDemo } from '../live/CounterDemo'
+
+export const title = 'Counters'
+
+export default function CounterPage() {
+  return (
+    <LivePage title="Counters" description="Estado local, sala isolada e sala compartilhada em tempo real.">
+      <CounterDemo />
+    </LivePage>
+  )
+}

package/app/client/src/pages/form.tsx

@@ -1,13 +1,13 @@
-// Página /form (file-based). Demo Live — React normal.
-import { LivePage } from '../framework/LivePage'
-import { FormDemo } from '../live/FormDemo'
-
-export const title = 'Form'
-
-export default function FormPage() {
-  return (
-    <LivePage title="Live Form" description="Formulário com campos sincronizados pelo servidor via proxy Live.">
-      <FormDemo />
-    </LivePage>
-  )
-}
+// Página /form (file-based). Demo Live — React normal.
+import { LivePage } from '../framework/LivePage'
+import { FormDemo } from '../live/FormDemo'
+
+export const title = 'Form'
+
+export default function FormPage() {
+  return (
+    <LivePage title="Live Form" description="Formulário com campos sincronizados pelo servidor via proxy Live.">
+      <FormDemo />
+    </LivePage>
+  )
+}

package/app/client/src/pages/index.tsx

@@ -1,9 +1,9 @@
-// Página HOME — rota / (file-based: app/client/src/pages/index.tsx)
-// Componente React normal. Server component (sem Live) → 0 JS no client.
-import { RscHomePage } from '../framework/RscHomePage'
-
-export const title = 'Home'
-
-export default function HomePage() {
-  return <RscHomePage />
-}
+// Página HOME — rota / (file-based: app/client/src/pages/index.tsx)
+// Componente React normal. Server component (sem Live) → 0 JS no client.
+import { RscHomePage } from '../framework/RscHomePage'
+
+export const title = 'Home'
+
+export default function HomePage() {
+  return <RscHomePage />
+}

package/app/client/src/pages/ping-pong.tsx

@@ -1,13 +1,13 @@
-// Página /ping-pong (file-based). Demo Live — React normal.
-import { LivePage } from '../framework/LivePage'
-import { PingPongDemo } from '../live/PingPongDemo'
-
-export const title = 'Ping-Pong'
-
-export default function PingPongPage() {
-  return (
-    <LivePage title="Ping-Pong" description="Latency demo com codec binário msgpack no WebSocket.">
-      <PingPongDemo />
-    </LivePage>
-  )
-}
+// Página /ping-pong (file-based). Demo Live — React normal.
+import { LivePage } from '../framework/LivePage'
+import { PingPongDemo } from '../live/PingPongDemo'
+
+export const title = 'Ping-Pong'
+
+export default function PingPongPage() {
+  return (
+    <LivePage title="Ping-Pong" description="Latency demo com codec binário msgpack no WebSocket.">
+      <PingPongDemo />
+    </LivePage>
+  )
+}

package/app/client/src/pages/room-chat.tsx

@@ -1,13 +1,13 @@
-// Página /room-chat (file-based). Demo Live — React normal.
-import { LivePage } from '../framework/LivePage'
-import { RoomChatDemo } from '../live/RoomChatDemo'
-
-export const title = 'Chat'
-
-export default function RoomChatPage() {
-  return (
-    <LivePage title="Room Chat" description="Chat multi-sala usando o sistema $room.">
-      <RoomChatDemo />
-    </LivePage>
-  )
-}
+// Página /room-chat (file-based). Demo Live — React normal.
+import { LivePage } from '../framework/LivePage'
+import { RoomChatDemo } from '../live/RoomChatDemo'
+
+export const title = 'Chat'
+
+export default function RoomChatPage() {
+  return (
+    <LivePage title="Room Chat" description="Chat multi-sala usando o sistema $room.">
+      <RoomChatDemo />
+    </LivePage>
+  )
+}

package/app/client/src/pages/shared-counter.tsx

@@ -1,13 +1,13 @@
-// Página /shared-counter (file-based). Demo Live — React normal.
-import { LivePage } from '../framework/LivePage'
-import { SharedCounterDemo } from '../live/SharedCounterDemo'
-
-export const title = 'Shared'
-
-export default function SharedCounterPage() {
-  return (
-    <LivePage title="Shared Counter" description="Sala global sincroniza usuários e estado entre abas.">
-      <SharedCounterDemo />
-    </LivePage>
-  )
-}
+// Página /shared-counter (file-based). Demo Live — React normal.
+import { LivePage } from '../framework/LivePage'
+import { SharedCounterDemo } from '../live/SharedCounterDemo'
+
+export const title = 'Shared'
+
+export default function SharedCounterPage() {
+  return (
+    <LivePage title="Shared Counter" description="Sala global sincroniza usuários e estado entre abas.">
+      <SharedCounterDemo />
+    </LivePage>
+  )
+}

package/app/client/src/pages/sobre.tsx

@@ -1,19 +1,19 @@
-// Página /sobre — PROVA do file-based routing. Só criar este arquivo já cria a
-// rota /sobre e o link na navbar. React normal, server component (0 JS).
-export const title = 'Sobre'
-
-export default function SobrePage() {
-  return (
-    <div className="relative min-h-[calc(100vh-57px)] px-4 py-10">
-      <div className="absolute inset-0 app-grid-bg opacity-70" />
-      <div className="relative z-10 mx-auto max-w-3xl">
-        <h1 className="text-4xl font-semibold text-white">Sobre</h1>
-        <p className="mt-4 text-gray-400">
-          Esta página foi criada só adicionando <code className="text-theme">app/client/src/pages/sobre.tsx</code>.
-          Sem editar router, sem registrar rota, sem tocar em nada. É React normal — e roda
-          como Server Component (zero JS no client).
-        </p>
-      </div>
-    </div>
-  )
-}
+// Página /sobre — PROVA do file-based routing. Só criar este arquivo já cria a
+// rota /sobre e o link na navbar. React normal, server component (0 JS).
+export const title = 'Sobre'
+
+export default function SobrePage() {
+  return (
+    <div className="relative min-h-[calc(100vh-57px)] px-4 py-10">
+      <div className="absolute inset-0 app-grid-bg opacity-70" />
+      <div className="relative z-10 mx-auto max-w-3xl">
+        <h1 className="text-4xl font-semibold text-white">Sobre</h1>
+        <p className="mt-4 text-gray-400">
+          Esta página foi criada só adicionando <code className="text-theme">app/client/src/pages/sobre.tsx</code>.
+          Sem editar router, sem registrar rota, sem tocar em nada. É React normal — e roda
+          como Server Component (zero JS no client).
+        </p>
+      </div>
+    </div>
+  )
+}

package/app/server/live/rooms/index.ts

@@ -1,14 +1,14 @@
-// Registro ESTÁTICO das LiveRoom classes — usado no build de produção.
-//
-// Em dev, as rooms são auto-descobertas varrendo este diretório (import dinâmico).
-// Em PROD isso quebraria (import do disco carrega uma instância separada do
-// @fluxstack/live → context null). Aqui declaramos as rooms estaticamente para
-// entrarem no bundle e serem registradas no LiveServer({ rooms }).
-//
-// Ao adicionar uma room nova em rooms/, inclua-a aqui também (ou rode o gerador).
-import { ChatRoom } from './ChatRoom'
-import { CounterRoom } from './CounterRoom'
-import { DirectoryRoom } from './DirectoryRoom'
-import { PingRoom } from './PingRoom'
-
-export const liveRoomClasses = [ChatRoom, CounterRoom, DirectoryRoom, PingRoom]
+// Registro ESTÁTICO das LiveRoom classes — usado no build de produção.
+//
+// Em dev, as rooms são auto-descobertas varrendo este diretório (import dinâmico).
+// Em PROD isso quebraria (import do disco carrega uma instância separada do
+// @fluxstack/live → context null). Aqui declaramos as rooms estaticamente para
+// entrarem no bundle e serem registradas no LiveServer({ rooms }).
+//
+// Ao adicionar uma room nova em rooms/, inclua-a aqui também (ou rode o gerador).
+import { ChatRoom } from './ChatRoom'
+import { CounterRoom } from './CounterRoom'
+import { DirectoryRoom } from './DirectoryRoom'
+import { PingRoom } from './PingRoom'
+
+export const liveRoomClasses = [ChatRoom, CounterRoom, DirectoryRoom, PingRoom]

package/core/plugins/built-in/rsc/index.ts

@@ -1,156 +1,156 @@
-/**
- * FluxStack RSC Plugin
- *
- * Serve React Server Components pelo proxy interno do FluxStack (Elysia), em vez
- * do middleware próprio do @vitejs/plugin-rsc. Prioridade 860 > ssr (850) >
- * vite (800): intercepta rotas de página antes deles. Só age se RSC_ENABLED=true.
- *
- * DEV: chama o handler do ambiente Vite `rsc` via runner (Vite dev server).
- * PROD: importa o handler RSC BUILDADO (app/client/dist/rsc/index.js, default) e
- *   serve os assets buildados (app/client/dist/client/assets). Sem Vite em prod.
- *
- * Em erro NÃO trata (fallback pro Vite/SPA). Requer o Vite criado com
- * rsc({serverHandler:false}) — ver vite.config.ts (condicionado a RSC_ENABLED).
- */
-
-import type { FluxStack, PluginContext, RequestContext } from '@core/plugins/types'
-import { FLUXSTACK_VERSION } from '@core/utils/version'
-import { isDevelopment } from '@core/utils/helpers'
-import { clientConfig, pluginsConfig } from '@config'
-import { isRunnableDevEnvironment } from 'vite'
-import { join } from 'path'
-import { existsSync } from 'fs'
-
-type Plugin = FluxStack.Plugin
-type RscHandler = (request: Request) => Promise<Response>
-
-const PLUGIN_PRIORITY = 860 // > ssr (850) > vite (800)
-const IS_DEV = isDevelopment()
-
-/** id do entry rsc no runner (dev) — relativo ao root app/client */
-const RSC_ENTRY_ID = '/src/framework/entry.rsc.tsx'
-/** caminho do handler RSC buildado (prod) e dos assets do client */
-const PROD_RSC_HANDLER = join(process.cwd(), 'app', 'client', 'dist', 'rsc', 'index.js')
-const PROD_CLIENT_DIR = join(process.cwd(), 'app', 'client', 'dist', 'client')
-
-const ASSET_EXT = /\.(js|mjs|ts|tsx|jsx|css|map|json|svg|png|jpe?g|gif|webp|avif|ico|woff2?|ttf|eot|wasm|txt|xml|webmanifest)$/i
-const PASSTHROUGH_PREFIXES = ['/@', '/src/', '/node_modules/', '/api', '/swagger', '/__plugins']
-
-function isPageRoute(path: string): boolean {
-  if (ASSET_EXT.test(path)) return false
-  return !PASSTHROUGH_PREFIXES.some((p) => path === p || path.startsWith(p))
-}
-
-/** Vite dev server (dev) — capturado do vitePlugin. */
-let viteServer: { environments: Record<string, unknown> } | null = null
-/** Handler RSC buildado (prod) — importado uma vez e cacheado. */
-let prodHandler: RscHandler | null = null
-
-/** Normaliza a URL da request para absoluta (handler RSC precisa de URL completa). */
-function absoluteUrl(ctx: RequestContext): string {
-  try {
-    return new URL(ctx.request.url).href
-  } catch {
-    const host = ctx.request.headers.get('host') || `${clientConfig.vite.host}:3000`
-    const proto = ctx.request.headers.get('x-forwarded-proto') || 'http'
-    const q = ctx.request.url.indexOf('?')
-    const search = q === -1 ? '' : ctx.request.url.slice(q)
-    return `${proto}://${host}${ctx.path}${search}`
-  }
-}
-
-/** Resolve o handler RSC (dev via runner, prod via import do build). */
-async function getHandler(): Promise<RscHandler | null> {
-  if (IS_DEV) {
-    if (!viteServer) return null
-    const rscEnv = viteServer.environments.rsc
-    if (!rscEnv || !isRunnableDevEnvironment(rscEnv as never)) return null
-    const mod = await (rscEnv as { runner: { import: (id: string) => Promise<{ default: RscHandler }> } })
-      .runner.import(RSC_ENTRY_ID)
-    return mod.default
-  }
-  // prod: importa o handler buildado uma vez
-  if (!prodHandler) {
-    if (!existsSync(PROD_RSC_HANDLER)) return null
-    const mod = await import(/* @vite-ignore */ PROD_RSC_HANDLER) as { default: RscHandler }
-    prodHandler = mod.default
-  }
-  return prodHandler
-}
-
-export const rscPlugin: Plugin = {
-  name: 'rsc',
-  version: FLUXSTACK_VERSION,
-  description: 'React Server Components served through the FluxStack proxy',
-  author: 'FluxStack Team',
-  priority: PLUGIN_PRIORITY,
-  category: 'rendering',
-  tags: ['rsc', 'react', 'server-components'],
-  dependencies: [],
-
-  setup: async (context: PluginContext) => {
-    if (!(pluginsConfig as Record<string, unknown>).rscEnabled) {
-      context.logger.debug('RSC plugin disabled (set RSC_ENABLED=true)')
-      return
-    }
-    if (!IS_DEV && !existsSync(PROD_RSC_HANDLER)) {
-      context.logger.warn(`RSC: handler buildado não encontrado (${PROD_RSC_HANDLER}). Rode o build com RSC_ENABLED=true.`)
-      return
-    }
-    context.logger.debug(`RSC plugin active (priority ${PLUGIN_PRIORITY}, ${IS_DEV ? 'dev' : 'prod'})`)
-  },
-
-  // DEV: captura o Vite dev server (do vitePlugin) para o runner.
-  onServerStart: async (context: PluginContext) => {
-    if (!(pluginsConfig as Record<string, unknown>).rscEnabled || !IS_DEV) return
-    const cfg = (context as PluginContext & { viteConfig?: { server?: unknown } }).viteConfig
-    if (cfg?.server) {
-      viteServer = cfg.server as { environments: Record<string, unknown> }
-      context.logger.debug('RSC: Vite dev server capturado para o runner')
-    }
-  },
-
-  onBeforeRoute: async (ctx: RequestContext) => {
-    if (!(pluginsConfig as Record<string, unknown>).rscEnabled) return
-    if (ctx.method !== 'GET') return
-
-    // PROD: servir assets buildados (/assets/*, /favicon.svg) do dist/client.
-    if (!IS_DEV && !isPageRoute(ctx.path)) {
-      const assetPath = join(PROD_CLIENT_DIR, ctx.path)
-      if (ctx.path !== '/' && existsSync(assetPath)) {
-        ctx.handled = true
-        ctx.response = new Response(Bun.file(assetPath))
-      }
-      return
-    }
-    if (!isPageRoute(ctx.path)) return // dev: assets vão pro Vite
-
-    try {
-      const handler = await getHandler()
-      if (!handler) return // sem handler → fallback
-
-      // Cold-start (dev): a 1ª render pode suspender enquanto o grafo client
-      // carrega; um retry cobre. Em prod o handler já está pronto (1 tentativa).
-      const attempts = IS_DEV ? 2 : 1
-      let response: Response | null = null
-      for (let i = 0; i < attempts; i++) {
-        try {
-          const request = new Request(absoluteUrl(ctx), { method: ctx.method, headers: ctx.request.headers })
-          response = await handler(request)
-          break
-        } catch (e) {
-          if (i === attempts - 1) throw e
-        }
-      }
-      if (response) {
-        ctx.handled = true
-        ctx.response = response
-      }
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err)
-      console.error(`[RSC] render failed for ${ctx.path}, falling back: ${msg}`)
-    }
-  },
-}
-
-export default rscPlugin
+/**
+ * FluxStack RSC Plugin
+ *
+ * Serve React Server Components pelo proxy interno do FluxStack (Elysia), em vez
+ * do middleware próprio do @vitejs/plugin-rsc. Prioridade 860 > ssr (850) >
+ * vite (800): intercepta rotas de página antes deles. Só age se RSC_ENABLED=true.
+ *
+ * DEV: chama o handler do ambiente Vite `rsc` via runner (Vite dev server).
+ * PROD: importa o handler RSC BUILDADO (app/client/dist/rsc/index.js, default) e
+ *   serve os assets buildados (app/client/dist/client/assets). Sem Vite em prod.
+ *
+ * Em erro NÃO trata (fallback pro Vite/SPA). Requer o Vite criado com
+ * rsc({serverHandler:false}) — ver vite.config.ts (condicionado a RSC_ENABLED).
+ */
+
+import type { FluxStack, PluginContext, RequestContext } from '@core/plugins/types'
+import { FLUXSTACK_VERSION } from '@core/utils/version'
+import { isDevelopment } from '@core/utils/helpers'
+import { clientConfig, pluginsConfig } from '@config'
+import { isRunnableDevEnvironment } from 'vite'
+import { join } from 'path'
+import { existsSync } from 'fs'
+
+type Plugin = FluxStack.Plugin
+type RscHandler = (request: Request) => Promise<Response>
+
+const PLUGIN_PRIORITY = 860 // > ssr (850) > vite (800)
+const IS_DEV = isDevelopment()
+
+/** id do entry rsc no runner (dev) — relativo ao root app/client */
+const RSC_ENTRY_ID = '/src/framework/entry.rsc.tsx'
+/** caminho do handler RSC buildado (prod) e dos assets do client */
+const PROD_RSC_HANDLER = join(process.cwd(), 'app', 'client', 'dist', 'rsc', 'index.js')
+const PROD_CLIENT_DIR = join(process.cwd(), 'app', 'client', 'dist', 'client')
+
+const ASSET_EXT = /\.(js|mjs|ts|tsx|jsx|css|map|json|svg|png|jpe?g|gif|webp|avif|ico|woff2?|ttf|eot|wasm|txt|xml|webmanifest)$/i
+const PASSTHROUGH_PREFIXES = ['/@', '/src/', '/node_modules/', '/api', '/swagger', '/__plugins']
+
+function isPageRoute(path: string): boolean {
+  if (ASSET_EXT.test(path)) return false
+  return !PASSTHROUGH_PREFIXES.some((p) => path === p || path.startsWith(p))
+}
+
+/** Vite dev server (dev) — capturado do vitePlugin. */
+let viteServer: { environments: Record<string, unknown> } | null = null
+/** Handler RSC buildado (prod) — importado uma vez e cacheado. */
+let prodHandler: RscHandler | null = null
+
+/** Normaliza a URL da request para absoluta (handler RSC precisa de URL completa). */
+function absoluteUrl(ctx: RequestContext): string {
+  try {
+    return new URL(ctx.request.url).href
+  } catch {
+    const host = ctx.request.headers.get('host') || `${clientConfig.vite.host}:3000`
+    const proto = ctx.request.headers.get('x-forwarded-proto') || 'http'
+    const q = ctx.request.url.indexOf('?')
+    const search = q === -1 ? '' : ctx.request.url.slice(q)
+    return `${proto}://${host}${ctx.path}${search}`
+  }
+}
+
+/** Resolve o handler RSC (dev via runner, prod via import do build). */
+async function getHandler(): Promise<RscHandler | null> {
+  if (IS_DEV) {
+    if (!viteServer) return null
+    const rscEnv = viteServer.environments.rsc
+    if (!rscEnv || !isRunnableDevEnvironment(rscEnv as never)) return null
+    const mod = await (rscEnv as { runner: { import: (id: string) => Promise<{ default: RscHandler }> } })
+      .runner.import(RSC_ENTRY_ID)
+    return mod.default
+  }
+  // prod: importa o handler buildado uma vez
+  if (!prodHandler) {
+    if (!existsSync(PROD_RSC_HANDLER)) return null
+    const mod = await import(/* @vite-ignore */ PROD_RSC_HANDLER) as { default: RscHandler }
+    prodHandler = mod.default
+  }
+  return prodHandler
+}
+
+export const rscPlugin: Plugin = {
+  name: 'rsc',
+  version: FLUXSTACK_VERSION,
+  description: 'React Server Components served through the FluxStack proxy',
+  author: 'FluxStack Team',
+  priority: PLUGIN_PRIORITY,
+  category: 'rendering',
+  tags: ['rsc', 'react', 'server-components'],
+  dependencies: [],
+
+  setup: async (context: PluginContext) => {
+    if (!(pluginsConfig as Record<string, unknown>).rscEnabled) {
+      context.logger.debug('RSC plugin disabled (set RSC_ENABLED=true)')
+      return
+    }
+    if (!IS_DEV && !existsSync(PROD_RSC_HANDLER)) {
+      context.logger.warn(`RSC: handler buildado não encontrado (${PROD_RSC_HANDLER}). Rode o build com RSC_ENABLED=true.`)
+      return
+    }
+    context.logger.debug(`RSC plugin active (priority ${PLUGIN_PRIORITY}, ${IS_DEV ? 'dev' : 'prod'})`)
+  },
+
+  // DEV: captura o Vite dev server (do vitePlugin) para o runner.
+  onServerStart: async (context: PluginContext) => {
+    if (!(pluginsConfig as Record<string, unknown>).rscEnabled || !IS_DEV) return
+    const cfg = (context as PluginContext & { viteConfig?: { server?: unknown } }).viteConfig
+    if (cfg?.server) {
+      viteServer = cfg.server as { environments: Record<string, unknown> }
+      context.logger.debug('RSC: Vite dev server capturado para o runner')
+    }
+  },
+
+  onBeforeRoute: async (ctx: RequestContext) => {
+    if (!(pluginsConfig as Record<string, unknown>).rscEnabled) return
+    if (ctx.method !== 'GET') return
+
+    // PROD: servir assets buildados (/assets/*, /favicon.svg) do dist/client.
+    if (!IS_DEV && !isPageRoute(ctx.path)) {
+      const assetPath = join(PROD_CLIENT_DIR, ctx.path)
+      if (ctx.path !== '/' && existsSync(assetPath)) {
+        ctx.handled = true
+        ctx.response = new Response(Bun.file(assetPath))
+      }
+      return
+    }
+    if (!isPageRoute(ctx.path)) return // dev: assets vão pro Vite
+
+    try {
+      const handler = await getHandler()
+      if (!handler) return // sem handler → fallback
+
+      // Cold-start (dev): a 1ª render pode suspender enquanto o grafo client
+      // carrega; um retry cobre. Em prod o handler já está pronto (1 tentativa).
+      const attempts = IS_DEV ? 2 : 1
+      let response: Response | null = null
+      for (let i = 0; i < attempts; i++) {
+        try {
+          const request = new Request(absoluteUrl(ctx), { method: ctx.method, headers: ctx.request.headers })
+          response = await handler(request)
+          break
+        } catch (e) {
+          if (i === attempts - 1) throw e
+        }
+      }
+      if (response) {
+        ctx.handled = true
+        ctx.response = response
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      console.error(`[RSC] render failed for ${ctx.path}, falling back: ${msg}`)
+    }
+  },
+}
+
+export default rscPlugin