create-fluxstack 1.14.0 → 1.15.0

package/app/server/live/LiveTodoList.ts

@@ -0,0 +1,110 @@
+// LiveTodoList - Lista de tarefas colaborativa em tempo real
+// Testa: state mutations, room events, multiple actions, arrays no state
+
+import { LiveComponent, type FluxStackWebSocket } from '@core/types/types'
+
+// Componente Cliente (Ctrl+Click para navegar)
+import type { TodoListDemo as _Client } from '@client/src/live/TodoListDemo'
+
+interface TodoItem {
+  id: string
+  text: string
+  done: boolean
+  createdBy: string
+  createdAt: number
+}
+
+export class LiveTodoList extends LiveComponent<typeof LiveTodoList.defaultState> {
+  static componentName = 'LiveTodoList'
+  static publicActions = ['addTodo', 'toggleTodo', 'removeTodo', 'clearCompleted'] as const
+  static defaultState = {
+    todos: [] as TodoItem[],
+    totalCreated: 0,
+    connectedUsers: 0
+  }
+  protected roomType = 'todo'
+
+  constructor(initialState: Partial<typeof LiveTodoList.defaultState> = {}, ws: FluxStackWebSocket, options?: { room?: string; userId?: string }) {
+    super(initialState, ws, options)
+
+    this.onRoomEvent<{ todos: TodoItem[]; totalCreated: number }>('TODOS_CHANGED', (data) => {
+      this.setState({ todos: data.todos, totalCreated: data.totalCreated })
+    })
+
+    this.onRoomEvent<{ connectedUsers: number }>('USER_COUNT_CHANGED', (data) => {
+      this.setState({ connectedUsers: data.connectedUsers })
+    })
+
+    const newCount = this.state.connectedUsers + 1
+    this.emitRoomEventWithState('USER_COUNT_CHANGED', { connectedUsers: newCount }, { connectedUsers: newCount })
+  }
+
+  async addTodo(payload: { text: string }) {
+    if (!payload.text?.trim()) {
+      return { success: false, error: 'Text is required' }
+    }
+
+    const todo: TodoItem = {
+      id: `todo-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+      text: payload.text.trim(),
+      done: false,
+      createdBy: this.userId || 'anonymous',
+      createdAt: Date.now()
+    }
+
+    const nextTodos = [...this.state.todos, todo]
+    const nextTotal = this.state.totalCreated + 1
+
+    this.emitRoomEventWithState(
+      'TODOS_CHANGED',
+      { todos: nextTodos, totalCreated: nextTotal },
+      { todos: nextTodos, totalCreated: nextTotal }
+    )
+
+    return { success: true, todo }
+  }
+
+  async toggleTodo(payload: { id: string }) {
+    const nextTodos = this.state.todos.map(t =>
+      t.id === payload.id ? { ...t, done: !t.done } : t
+    )
+
+    this.emitRoomEventWithState(
+      'TODOS_CHANGED',
+      { todos: nextTodos, totalCreated: this.state.totalCreated },
+      { todos: nextTodos }
+    )
+
+    return { success: true }
+  }
+
+  async removeTodo(payload: { id: string }) {
+    const nextTodos = this.state.todos.filter(t => t.id !== payload.id)
+
+    this.emitRoomEventWithState(
+      'TODOS_CHANGED',
+      { todos: nextTodos, totalCreated: this.state.totalCreated },
+      { todos: nextTodos }
+    )
+
+    return { success: true }
+  }
+
+  async clearCompleted() {
+    const nextTodos = this.state.todos.filter(t => !t.done)
+
+    this.emitRoomEventWithState(
+      'TODOS_CHANGED',
+      { todos: nextTodos, totalCreated: this.state.totalCreated },
+      { todos: nextTodos }
+    )
+
+    return { success: true, removed: this.state.todos.length - nextTodos.length }
+  }
+
+  destroy() {
+    const newCount = Math.max(0, this.state.connectedUsers - 1)
+    this.emitRoomEvent('USER_COUNT_CHANGED', { connectedUsers: newCount })
+    super.destroy()
+  }
+}

package/app/server/routes/room.routes.ts

@@ -4,8 +4,7 @@
 // enviem mensagens para salas de chat via API REST
 
 import { Elysia, t } from 'elysia'
-import { liveRoomManager } from '@core/server/live/LiveRoomManager'
-import { roomEvents } from '@core/server/live/RoomEventBus'
+import { liveRoomManager, roomEvents } from '@core/server/live'
 
 export const roomRoutes = new Elysia({ prefix: '/rooms' })
 

package/core/build/live-components-generator.ts

@@ -116,7 +116,7 @@ export class LiveComponentsGenerator {
 // Generated at: ${new Date().toISOString()}
 
 ${imports}
-import { componentRegistry } from "@core/server/live/ComponentRegistry"
+import { componentRegistry } from "@core/server/live"
 
 // Register all components statically for production bundle
 function registerAllComponents() {

package/core/build/vite-plugins.ts

@@ -0,0 +1,28 @@
+/**
+ * FluxStack internal Vite plugins.
+ *
+ * Returns all framework-level Vite plugins that should be registered
+ * automatically. Consumers just call `fluxstackVitePlugins()` in their
+ * vite.config.ts — no need to know about individual internal plugins.
+ */
+
+import type { Plugin } from 'vite'
+import { resolve } from 'path'
+import tsconfigPaths from 'vite-tsconfig-paths'
+import checker from 'vite-plugin-checker'
+import { liveStripPlugin } from '@fluxstack/live/build'
+import { helpers } from '../utils/env'
+
+export function fluxstackVitePlugins(): Plugin[] {
+  return [
+    liveStripPlugin({ verbose: false }),
+    tsconfigPaths({
+      projects: [resolve(import.meta.dirname, '..', '..', 'tsconfig.json')]
+    }),
+    // Only run type checker in development (saves ~5+ minutes in Docker builds)
+    helpers.isDevelopment() && checker({
+      typescript: true,
+      overlay: true
+    }),
+  ].filter(Boolean) as Plugin[]
+}

package/core/client/components/LiveDebugger.tsx

@@ -8,7 +8,7 @@
 //   <LiveDebugger />
 
 import React, { useState, useRef, useEffect, useCallback, useMemo } from 'react'
-import { useLiveDebugger, type DebugEvent, type DebugEventType, type ComponentSnapshot } from '../hooks/useLiveDebugger'
+import { useLiveDebugger, type DebugEvent, type DebugEventType, type ComponentSnapshot } from '@fluxstack/live-react'
 
 // ===== Debugger Settings =====
 

package/core/client/hooks/useLiveUpload.ts

@@ -1,8 +1,7 @@
 import { useMemo } from 'react'
-import { Live } from '../components/Live'
-import { useLiveChunkedUpload } from './useLiveChunkedUpload'
-import type { LiveChunkedUploadOptions } from './useLiveChunkedUpload'
-import type { FileUploadCompleteResponse } from '@core/types/types'
+import { Live, useLiveChunkedUpload } from '@fluxstack/live-react'
+import type { LiveChunkedUploadOptions } from '@fluxstack/live-react'
+import type { FileUploadCompleteResponse } from '@fluxstack/live'
 import { LiveUpload } from '@server/live/LiveUpload'
 
 export interface UseLiveUploadOptions {

package/core/client/index.ts

@@ -1,39 +1,27 @@
-// 🔥 FluxStack Client Core - Main Export
+// FluxStack Client Core - Main Export
+// Re-exports from @fluxstack/live-react + FluxStack-specific code
 
-// API Client (Eden Treaty)
-export {
-  createEdenClient,
-  getErrorMessage,
-  getDefaultBaseUrl,
-  treaty,
-  type EdenClientOptions
-} from './api'
+// === Re-exports from @fluxstack/live-react ===
 
-// Live Components Provider (Singleton WebSocket Connection)
-export {
-  LiveComponentsProvider,
-  useLiveComponents
-} from './LiveComponentsProvider'
+// Provider
+export { LiveComponentsProvider, useLiveComponents } from '@fluxstack/live-react'
 export type {
   LiveComponentsProviderProps,
   LiveComponentsContextValue,
-  LiveAuthOptions
-} from './LiveComponentsProvider'
-
-// Chunked Upload Hook
-export { useChunkedUpload } from './hooks/useChunkedUpload'
-export type { ChunkedUploadOptions, ChunkedUploadState } from './hooks/useChunkedUpload'
-export { useLiveChunkedUpload } from './hooks/useLiveChunkedUpload'
-export type { LiveChunkedUploadOptions } from './hooks/useLiveChunkedUpload'
-export { useLiveUpload } from './hooks/useLiveUpload'
+} from '@fluxstack/live-react'
+export type { LiveAuthOptions } from '@fluxstack/live-react'
 
-// Live Component Hook (API principal)
-export { Live } from './components/Live'
+// Live.use() API
+export { Live } from '@fluxstack/live-react'
 
-// Live Component Debugger
-export { LiveDebugger } from './components/LiveDebugger'
-export type { LiveDebuggerProps } from './components/LiveDebugger'
-export { useLiveDebugger } from './hooks/useLiveDebugger'
+// Upload Hooks
+export { useChunkedUpload } from '@fluxstack/live-react'
+export type { ChunkedUploadOptions, ChunkedUploadState } from '@fluxstack/live-react'
+export { useLiveChunkedUpload } from '@fluxstack/live-react'
+export type { LiveChunkedUploadOptions } from '@fluxstack/live-react'
+
+// Debugger Hook
+export { useLiveDebugger } from '@fluxstack/live-react'
 export type {
   DebugEvent,
   DebugEventType,
@@ -41,5 +29,23 @@ export type {
   DebugSnapshot,
   DebugFilter,
   UseLiveDebuggerReturn,
-  UseLiveDebuggerOptions
-} from './hooks/useLiveDebugger'
+  UseLiveDebuggerOptions,
+} from '@fluxstack/live-react'
+
+// === FluxStack-specific (stays here) ===
+
+// Eden Treaty API client
+export {
+  createEdenClient,
+  getErrorMessage,
+  getDefaultBaseUrl,
+  treaty,
+  type EdenClientOptions
+} from './api'
+
+// LiveDebugger UI component (React component, 1325 lines - not extracted to lib)
+export { LiveDebugger } from './components/LiveDebugger'
+export type { LiveDebuggerProps } from './components/LiveDebugger'
+
+// useLiveUpload (FluxStack-specific convenience wrapper)
+export { useLiveUpload } from './hooks/useLiveUpload'

package/core/framework/server.ts

@@ -7,7 +7,7 @@ import { fluxStackConfig } from "@config"
 import { getEnvironmentInfo } from "@core/config"
 import { logger } from "@core/utils/logger"
 import { displayStartupBanner, type StartupInfo } from "@core/utils/logger/startup-banner"
-import { componentRegistry } from "@core/server/live/ComponentRegistry"
+import { componentRegistry } from "@core/server/live"
 import { FluxStackError } from "@core/utils/errors"
 import { createTimer, formatBytes, isProduction, isDevelopment } from "@core/utils/helpers"
 import type { Plugin } from "@core/plugins"

package/core/server/index.ts

@@ -6,8 +6,7 @@ export { PluginRegistry } from "../plugins/registry"
 export * from "../types"
 
 // Live Components exports
-export { liveComponentsPlugin } from "./live/websocket-plugin"
-export { componentRegistry } from "./live/ComponentRegistry"
+export { liveComponentsPlugin, componentRegistry } from "./live"
 export { LiveComponent } from "../types/types"
 
 // Static Files Plugin

package/core/server/live/auto-generated-components.ts

@@ -1,6 +1,6 @@
 // 🔥 Auto-generated Live Components Registration
 // This file is automatically generated during build time - DO NOT EDIT MANUALLY
-// Generated at: 2026-02-21T20:03:53.569Z
+// Generated at: 2026-03-01T19:00:29.650Z
 
 import { LiveAdminPanel } from "@app/server/live/LiveAdminPanel"
 import { LiveChat } from "@app/server/live/LiveChat"
@@ -9,8 +9,9 @@ import { LiveForm } from "@app/server/live/LiveForm"
 import { LiveLocalCounter } from "@app/server/live/LiveLocalCounter"
 import { LiveProtectedChat } from "@app/server/live/LiveProtectedChat"
 import { LiveRoomChat } from "@app/server/live/LiveRoomChat"
+import { LiveTodoList } from "@app/server/live/LiveTodoList"
 import { LiveUpload } from "@app/server/live/LiveUpload"
-import { componentRegistry } from "@core/server/live/ComponentRegistry"
+import { componentRegistry } from "@core/server/live"
 
 // Register all components statically for production bundle
 function registerAllComponents() {
@@ -23,9 +24,10 @@ function registerAllComponents() {
     componentRegistry.registerComponentClass('LiveLocalCounter', LiveLocalCounter)
     componentRegistry.registerComponentClass('LiveProtectedChat', LiveProtectedChat)
     componentRegistry.registerComponentClass('LiveRoomChat', LiveRoomChat)
+    componentRegistry.registerComponentClass('LiveTodoList', LiveTodoList)
     componentRegistry.registerComponentClass('LiveUpload', LiveUpload)
     
-    console.log('📝 Live components registered successfully! (8 components)')
+    console.log('📝 Live components registered successfully! (9 components)')
   } catch (error) {
     console.warn('⚠️ Error registering components:', error)
   }
@@ -43,5 +45,6 @@ export {
   LiveLocalCounter,
   LiveProtectedChat,
   LiveRoomChat,
+  LiveTodoList,
   LiveUpload
 }

package/core/server/live/index.ts

@@ -1,23 +1,26 @@
-// 🔥 FluxStack Live - Server Exports
-
-export { roomState, createTypedRoomState } from './RoomStateManager'
-export type { RoomStateData, RoomInfo } from './RoomStateManager'
-
-export { roomEvents, createTypedRoomEventBus } from './RoomEventBus'
-export type { EventHandler, RoomSubscription } from './RoomEventBus'
-
-export { componentRegistry } from './ComponentRegistry'
-export { liveComponentsPlugin } from './websocket-plugin'
-export { connectionManager } from './WebSocketConnectionManager'
-export { fileUploadManager } from './FileUploadManager'
-export { stateSignature } from './StateSignature'
-export { performanceMonitor } from './LiveComponentPerformanceMonitor'
-export { liveLog, liveWarn, registerComponentLogging, unregisterComponentLogging } from './LiveLogger'
-export type { LiveLogCategory, LiveLogConfig } from './LiveLogger'
-
-// 🔒 Auth system
-export { liveAuthManager, LiveAuthManager } from './auth/LiveAuthManager'
-export { AuthenticatedContext, AnonymousContext, ANONYMOUS_CONTEXT } from './auth/LiveAuthContext'
+// FluxStack Live - Server Exports
+// Re-exports from @fluxstack/live + backward-compatible singleton accessors
+
+export { liveComponentsPlugin, liveServer } from './websocket-plugin'
+
+// Re-export classes and types from @fluxstack/live
+export { RoomStateManager, createTypedRoomState } from '@fluxstack/live'
+export type { RoomStateData, RoomInfo } from '@fluxstack/live'
+
+export { RoomEventBus, createTypedRoomEventBus } from '@fluxstack/live'
+export type { EventHandler, RoomSubscription } from '@fluxstack/live'
+
+export { ComponentRegistry } from '@fluxstack/live'
+export { WebSocketConnectionManager } from '@fluxstack/live'
+export { FileUploadManager } from '@fluxstack/live'
+export { StateSignatureManager } from '@fluxstack/live'
+export { PerformanceMonitor } from '@fluxstack/live'
+export { liveLog, liveWarn, registerComponentLogging, unregisterComponentLogging } from '@fluxstack/live'
+export type { LiveLogCategory, LiveLogConfig } from '@fluxstack/live'
+
+// Auth system
+export { LiveAuthManager } from '@fluxstack/live'
+export { AuthenticatedContext, AnonymousContext, ANONYMOUS_CONTEXT } from '@fluxstack/live'
 export type {
   LiveAuthProvider,
   LiveAuthCredentials,
@@ -27,4 +30,75 @@ export type {
   LiveActionAuth,
   LiveActionAuthMap,
   LiveAuthResult,
-} from './auth/types'
+} from '@fluxstack/live'
+
+// Backward-compatible singleton accessors
+// These lazily access the LiveServer instance created by the plugin
+import { liveServer, pendingAuthProviders } from './websocket-plugin'
+import type { LiveAuthProvider as _LiveAuthProvider } from '@fluxstack/live'
+
+/**
+ * Backward-compatible liveAuthManager.
+ * Buffers register() calls that happen before the plugin setup(),
+ * then delegates to liveServer.authManager once available.
+ * @deprecated Access via liveServer.authManager instead
+ */
+export const liveAuthManager = {
+  register(provider: _LiveAuthProvider) {
+    if (liveServer) {
+      liveServer.useAuth(provider)
+    } else {
+      pendingAuthProviders.push(provider)
+    }
+  },
+  get authenticate() { return liveServer!.authManager.authenticate.bind(liveServer!.authManager) },
+  get hasProviders() { return liveServer!.authManager.hasProviders.bind(liveServer!.authManager) },
+  get authorizeRoom() { return liveServer!.authManager.authorizeRoom.bind(liveServer!.authManager) },
+  get authorizeAction() { return liveServer!.authManager.authorizeAction.bind(liveServer!.authManager) },
+  get authorizeComponent() { return liveServer!.authManager.authorizeComponent.bind(liveServer!.authManager) },
+} as any
+
+/** @deprecated Access via liveServer.registry instead */
+export const componentRegistry = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.registry as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.connectionManager instead */
+export const connectionManager = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.connectionManager as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.roomManager instead */
+export const liveRoomManager = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.roomManager as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.roomEvents instead */
+export const roomEvents = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.roomEvents as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.fileUploadManager instead */
+export const fileUploadManager = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.fileUploadManager as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.performanceMonitor instead */
+export const performanceMonitor = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.performanceMonitor as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.stateSignature instead */
+export const stateSignature = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.stateSignature as any)[prop] }
+})
+
+/** @deprecated Access via liveServer.debugger instead */
+export const liveDebugger = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.debugger as any)[prop] }
+})
+
+// Room state backward compat
+export const roomState = new Proxy({} as any, {
+  get(_, prop) { return (liveServer!.roomManager as any)[prop] }
+})