create-fluxstack 1.13.0 → 1.15.0

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,6 +1,40 @@
-// 🔥 FluxStack Client Core - Main Export
+// FluxStack Client Core - Main Export
+// Re-exports from @fluxstack/live-react + FluxStack-specific code
 
-// API Client (Eden Treaty)
+// === Re-exports from @fluxstack/live-react ===
+
+// Provider
+export { LiveComponentsProvider, useLiveComponents } from '@fluxstack/live-react'
+export type {
+  LiveComponentsProviderProps,
+  LiveComponentsContextValue,
+} from '@fluxstack/live-react'
+export type { LiveAuthOptions } from '@fluxstack/live-react'
+
+// Live.use() API
+export { Live } from '@fluxstack/live-react'
+
+// 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,
+  ComponentSnapshot,
+  DebugSnapshot,
+  DebugFilter,
+  UseLiveDebuggerReturn,
+  UseLiveDebuggerOptions,
+} from '@fluxstack/live-react'
+
+// === FluxStack-specific (stays here) ===
+
+// Eden Treaty API client
 export {
   createEdenClient,
   getErrorMessage,
@@ -9,23 +43,9 @@ export {
   type EdenClientOptions
 } from './api'
 
-// Live Components Provider (Singleton WebSocket Connection)
-export {
-  LiveComponentsProvider,
-  useLiveComponents
-} from './LiveComponentsProvider'
-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'
+// LiveDebugger UI component (React component, 1325 lines - not extracted to lib)
+export { LiveDebugger } from './components/LiveDebugger'
+export type { LiveDebuggerProps } from './components/LiveDebugger'
 
-// Live Component Hook (API principal)
-export { Live } from './components/Live'
+// 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/plugins/built-in/index.ts

@@ -1,135 +1,135 @@
-/**
- * Built-in Plugins for FluxStack
- * Core plugins that provide essential functionality
- *
- * Note: Logger is NOT a plugin - it's core infrastructure used by plugins
- */
-
-// Import all built-in plugins
-import { swaggerPlugin } from './swagger'
-import { vitePlugin } from './vite'
-import { monitoringPlugin } from './monitoring'
-
-// Export individual plugins
-export { swaggerPlugin } from './swagger'
-export { vitePlugin } from './vite'
-export { monitoringPlugin } from './monitoring'
-
-// Deprecated: staticPlugin is now merged into vitePlugin (auto-detects dev/prod)
-/** @deprecated Use vitePlugin instead - it now handles both dev and prod */
-export const staticPlugin = vitePlugin
-
-// Export as a collection
-export const builtInPlugins = {
-  swagger: swaggerPlugin,
-  vite: vitePlugin,
-  static: staticPlugin,
-  monitoring: monitoringPlugin
-} as const
-
-// Export as an array for easy registration
-export const builtInPluginsList = [
-  swaggerPlugin,
-  vitePlugin,
-  staticPlugin,
-  monitoringPlugin
-] as const
-
-// Plugin categories
-export const pluginCategories = {
-  core: [vitePlugin], // vitePlugin now handles both dev (Vite) and prod (static)
-  development: [vitePlugin],
-  documentation: [swaggerPlugin],
-  monitoring: [monitoringPlugin]
-} as const
-
-// Default plugin configuration
-export const defaultPluginConfig = {
-  swagger: {
-    enabled: true,
-    path: '/swagger',
-    title: 'FluxStack API',
-    description: 'Modern full-stack TypeScript framework with type-safe API endpoints'
-  },
-  vite: {
-    enabled: true,
-    port: 5173,
-    host: 'localhost',
-    checkInterval: 2000,
-    maxRetries: 10,
-    timeout: 5000
-  },
-  static: {
-    enabled: true,
-    publicDir: 'public',
-    distDir: 'dist/client',
-    indexFile: 'index.html',
-    spa: {
-      enabled: true,
-      fallback: 'index.html'
-    }
-  },
-  monitoring: {
-    enabled: false, // Disabled by default to avoid overhead
-    httpMetrics: true,
-    systemMetrics: true,
-    customMetrics: true,
-    collectInterval: 5000,
-    retentionPeriod: 300000,
-    exporters: [
-      {
-        type: 'console',
-        interval: 30000,
-        enabled: false
-      }
-    ],
-    thresholds: {
-      responseTime: 1000,
-      errorRate: 0.05,
-      memoryUsage: 0.8,
-      cpuUsage: 0.8
-    }
-  }
-} as const
-
-/**
- * Get default plugins for a specific environment
- */
-export function getDefaultPlugins(environment: 'development' | 'production' | 'test' = 'development') {
-  // vitePlugin now auto-detects dev/prod and serves appropriately
-  const basePlugins = [vitePlugin]
-
-  switch (environment) {
-    case 'development':
-      return [...basePlugins, swaggerPlugin, monitoringPlugin]
-    case 'production':
-      return [...basePlugins, monitoringPlugin]
-    case 'test':
-      return [] // Minimal plugins for testing
-    default:
-      return basePlugins
-  }
-}
-
-/**
- * Get plugin by name
- */
-export function getBuiltInPlugin(name: string) {
-  return builtInPlugins[name as keyof typeof builtInPlugins]
-}
-
-/**
- * Check if a plugin is built-in
- */
-export function isBuiltInPlugin(name: string): boolean {
-  return name in builtInPlugins
-}
-
-/**
- * Get plugins by category
- */
-export function getPluginsByCategory(category: keyof typeof pluginCategories) {
-  return pluginCategories[category] || []
-}
-
+/**
+ * Built-in Plugins for FluxStack
+ * Core plugins that provide essential functionality
+ *
+ * Note: Logger is NOT a plugin - it's core infrastructure used by plugins
+ */
+
+// Import all built-in plugins
+import { swaggerPlugin } from './swagger'
+import { vitePlugin } from './vite'
+import { monitoringPlugin } from './monitoring'
+
+// Export individual plugins
+export { swaggerPlugin } from './swagger'
+export { vitePlugin } from './vite'
+export { monitoringPlugin } from './monitoring'
+
+// Deprecated: staticPlugin is now merged into vitePlugin (auto-detects dev/prod)
+/** @deprecated Use vitePlugin instead - it now handles both dev and prod */
+export const staticPlugin = vitePlugin
+
+// Export as a collection
+export const builtInPlugins = {
+  swagger: swaggerPlugin,
+  vite: vitePlugin,
+  static: staticPlugin,
+  monitoring: monitoringPlugin
+} as const
+
+// Export as an array for easy registration
+export const builtInPluginsList = [
+  swaggerPlugin,
+  vitePlugin,
+  staticPlugin,
+  monitoringPlugin
+] as const
+
+// Plugin categories
+export const pluginCategories = {
+  core: [vitePlugin], // vitePlugin now handles both dev (Vite) and prod (static)
+  development: [vitePlugin],
+  documentation: [swaggerPlugin],
+  monitoring: [monitoringPlugin]
+} as const
+
+// Default plugin configuration
+export const defaultPluginConfig = {
+  swagger: {
+    enabled: true,
+    path: '/swagger',
+    title: 'FluxStack API',
+    description: 'Modern full-stack TypeScript framework with type-safe API endpoints'
+  },
+  vite: {
+    enabled: true,
+    port: 5173,
+    host: 'localhost',
+    checkInterval: 2000,
+    maxRetries: 10,
+    timeout: 5000
+  },
+  static: {
+    enabled: true,
+    publicDir: 'public',
+    distDir: 'dist/client',
+    indexFile: 'index.html',
+    spa: {
+      enabled: true,
+      fallback: 'index.html'
+    }
+  },
+  monitoring: {
+    enabled: false, // Disabled by default to avoid overhead
+    httpMetrics: true,
+    systemMetrics: true,
+    customMetrics: true,
+    collectInterval: 5000,
+    retentionPeriod: 300000,
+    exporters: [
+      {
+        type: 'console',
+        interval: 30000,
+        enabled: false
+      }
+    ],
+    thresholds: {
+      responseTime: 1000,
+      errorRate: 0.05,
+      memoryUsage: 0.8,
+      cpuUsage: 0.8
+    }
+  }
+} as const
+
+/**
+ * Get default plugins for a specific environment
+ */
+export function getDefaultPlugins(environment: 'development' | 'production' | 'test' = 'development') {
+  // vitePlugin now auto-detects dev/prod and serves appropriately
+  const basePlugins = [vitePlugin]
+
+  switch (environment) {
+    case 'development':
+      return [...basePlugins, swaggerPlugin, monitoringPlugin]
+    case 'production':
+      return [...basePlugins, monitoringPlugin]
+    case 'test':
+      return [] // Minimal plugins for testing
+    default:
+      return basePlugins
+  }
+}
+
+/**
+ * Get plugin by name
+ */
+export function getBuiltInPlugin(name: string) {
+  return builtInPlugins[name as keyof typeof builtInPlugins]
+}
+
+/**
+ * Check if a plugin is built-in
+ */
+export function isBuiltInPlugin(name: string): boolean {
+  return name in builtInPlugins
+}
+
+/**
+ * Get plugins by category
+ */
+export function getPluginsByCategory(category: keyof typeof pluginCategories) {
+  return pluginCategories[category] || []
+}
+
 export default builtInPlugins

package/core/plugins/built-in/live-components/commands/create-live-component.ts

@@ -27,6 +27,7 @@ ${clientLink}
 
 export class ${name} extends LiveComponent<typeof ${name}.defaultState> {
   static componentName = '${name}'
+  static publicActions = ['increment', 'decrement', 'reset'] as const
   static defaultState = {
     count: 0
   }
@@ -58,6 +59,7 @@ ${clientLink}
 
 export class ${name} extends LiveComponent<typeof ${name}.defaultState> {
   static componentName = '${name}'
+  static publicActions = ['submit', 'reset'] as const
   static defaultState = {
     name: '',
     email: '',
@@ -89,6 +91,7 @@ ${clientLink}
 
 export class ${name} extends LiveComponent<typeof ${name}.defaultState> {
   static componentName = '${name}'
+  static publicActions = ['sendMessage', 'setUsername'] as const
   static defaultState = {
     messages: [] as Array<{ id: string; text: string; username: string; timestamp: string }>,
     username: '',
@@ -125,6 +128,7 @@ ${clientLink}
 
 export class ${name} extends LiveComponent<typeof ${name}.defaultState> {
   static componentName = '${name}'
+  static publicActions = ['updateMessage', 'increment', 'reset'] as const
   static defaultState = {
     message: 'Hello from ${name}!',
     count: 0

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

@@ -4,7 +4,7 @@ import { clientConfig } from '@config'
 import { pluginsConfig } from '@config'
 import { isDevelopment } from "@core/utils/helpers"
 import { join } from "path"
-import { statSync, existsSync, readdirSync } from "fs"
+import { existsSync } from "fs"
 
 type Plugin = FluxStack.Plugin
 
@@ -21,24 +21,30 @@ const STATIC_MAX_AGE = 31536000
 const HASHED_EXT = /\.[0-9a-f]{8,}\.\w+$/
 
 /**
- * Recursively collect all files under `dir` as relative paths (e.g. "/assets/app.abc123.js").
- * Runs once at startup — in production the build output never changes.
+ * Collect all files under `dir` using Bun.Glob (native C++ implementation).
+ * Returns a map of relative URL paths → absolute filesystem paths.
+ *
+ * Throws if the directory does not exist so callers get a clear signal
+ * instead of silently serving nothing.
  */
-function collectFiles(dir: string, prefix = ''): Map<string, string> {
+function collectFiles(dir: string): Map<string, string> {
+  if (!existsSync(dir)) {
+    throw new Error(
+      `Static file directory "${dir}" does not exist. ` +
+      `Run the client build first or check your configuration.`
+    )
+  }
+
   const map = new Map<string, string>()
-  try {
-    const entries = readdirSync(dir, { withFileTypes: true })
-    for (const entry of entries) {
-      const rel = prefix + '/' + entry.name
-      if (entry.isDirectory()) {
-        for (const [k, v] of collectFiles(join(dir, entry.name), rel)) {
-          map.set(k, v)
-        }
-      } else if (entry.isFile()) {
-        map.set(rel, join(dir, entry.name))
-      }
-    }
-  } catch {}
+  const glob = new Bun.Glob("**/*")
+
+  for (const relativePath of glob.scanSync({ cwd: dir, onlyFiles: true, dot: true })) {
+    // scanSync may return OS-native separators (backslashes on Windows)
+    // Normalize to forward slashes so URL lookups always match
+    const urlPath = '/' + relativePath.replaceAll('\\', '/')
+    map.set(urlPath, join(dir, relativePath))
+  }
+
   return map
 }
 
@@ -60,6 +66,15 @@ function createStaticFallback() {
   // Bun.file() handle cache — avoids re-creating handles on repeated requests
   const fileCache = new Map<string, ReturnType<typeof Bun.file>>()
 
+  // Build a set of paths that have a pre-compressed .gz sibling
+  const gzSet = new Set<string>()
+  for (const [rel] of fileMap) {
+    if (rel.endsWith('.gz')) {
+      // "/assets/app.abc123.js.gz" → "/assets/app.abc123.js"
+      gzSet.add(rel.slice(0, -3))
+    }
+  }
+
   return (c: { request?: Request }) => {
     const req = c.request
     if (!req) return
@@ -96,6 +111,39 @@ function createStaticFallback() {
     // O(1) lookup in pre-scanned file map
     const absolutePath = fileMap.get(pathname)
     if (absolutePath) {
+      // Check for pre-compressed .gz variant
+      const acceptEncoding = req.headers.get('accept-encoding') || ''
+      if (gzSet.has(pathname) && acceptEncoding.includes('gzip')) {
+        const gzPath = pathname + '.gz'
+        const gzAbsolute = fileMap.get(gzPath)
+        if (gzAbsolute) {
+          let gzFile = fileCache.get(gzPath)
+          if (!gzFile) {
+            gzFile = Bun.file(gzAbsolute)
+            fileCache.set(gzPath, gzFile)
+          }
+
+          // Determine original content type from the uncompressed file
+          let origFile = fileCache.get(pathname)
+          if (!origFile) {
+            origFile = Bun.file(absolutePath)
+            fileCache.set(pathname, origFile)
+          }
+
+          const headers: Record<string, string> = {
+            'Content-Encoding': 'gzip',
+            'Content-Type': origFile.type || 'application/octet-stream',
+            'Vary': 'Accept-Encoding',
+          }
+
+          if (HASHED_EXT.test(pathname)) {
+            headers['Cache-Control'] = `public, max-age=${STATIC_MAX_AGE}, immutable`
+          }
+
+          return new Response(gzFile, { headers })
+        }
+      }
+
       let file = fileCache.get(pathname)
       if (!file) {
         file = Bun.file(absolutePath)
@@ -114,14 +162,19 @@ function createStaticFallback() {
       return file
     }
 
-    // SPA fallback: serve index.html for unmatched routes
+    // SPA fallback: serve index.html for unmatched routes with no-cache
+    // so the browser always checks for a newer version on deploy
     if (indexFile) {
-      return indexFile
+      return new Response(indexFile, {
+        headers: {
+          'Cache-Control': 'no-cache',
+        }
+      })
     }
   }
 }
 
-/** Proxy request to Vite dev server */
+/** Proxy request to Vite dev server — streams the response body */
 async function proxyToVite(ctx: RequestContext): Promise<void> {
   const { host, port } = clientConfig.vite
 
@@ -143,7 +196,8 @@ async function proxyToVite(ctx: RequestContext): Promise<void> {
     })
 
     ctx.handled = true
-    ctx.response = new Response(await response.arrayBuffer(), {
+    // Stream the response body instead of buffering the entire payload in memory
+    ctx.response = new Response(response.body, {
       status: response.status,
       statusText: response.statusText,
       headers: response.headers

package/core/server/index.ts

@@ -1,16 +1,15 @@
-// FluxStack framework exports
-export { FluxStackFramework } from "../framework/server"
-export { vitePlugin, staticPlugin } from "../plugins/built-in"
-export { swaggerPlugin } from "../plugins/built-in/swagger"
-export { PluginRegistry } from "../plugins/registry"
-export * from "../types"
-
-// Live Components exports
-export { liveComponentsPlugin } from "./live/websocket-plugin"
-export { componentRegistry } from "./live/ComponentRegistry"
-export { LiveComponent } from "../types/types"
-
-// Static Files Plugin
-export { staticFilesPlugin } from "./plugins/static-files-plugin"
-
+// FluxStack framework exports
+export { FluxStackFramework } from "../framework/server"
+export { vitePlugin, staticPlugin } from "../plugins/built-in"
+export { swaggerPlugin } from "../plugins/built-in/swagger"
+export { PluginRegistry } from "../plugins/registry"
+export * from "../types"
+
+// Live Components exports
+export { liveComponentsPlugin, componentRegistry } from "./live"
+export { LiveComponent } from "../types/types"
+
+// Static Files Plugin
+export { staticFilesPlugin } from "./plugins/static-files-plugin"
+
 export * from "../types/types"

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-17T00:55:07.182Z
+// 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
 }