create-fluxstack 1.7.5 → 1.8.3

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

@@ -1,305 +1,103 @@
-import { join, extname } from "path"
-import { existsSync, statSync } from "fs"
-import type { FluxStack, PluginContext } from "../../types"
+import { join } from "path"
+import { statSync, existsSync } from "fs"
+import type { Plugin, PluginContext } from "@/core/plugins"
 
-type Plugin = FluxStack.Plugin
+// Default configuration values
+const DEFAULTS = {
+  enabled: true,
+  publicDir: "./dist/client",
+  indexFile: "index.html"
+}
 
 export const staticPlugin: Plugin = {
   name: "static",
-  version: "1.0.0",
-  description: "Enhanced static file serving plugin for FluxStack with caching and compression",
+  version: "2.0.0",
+  description: "Simple and efficient static file serving plugin for FluxStack",
   author: "FluxStack Team",
-  priority: 100, // Should run after other plugins
+  priority: 200, // Run after all other plugins
   category: "core",
   tags: ["static", "files", "spa"],
-  dependencies: [], // No hard dependencies, but works with vite plugin
-  
-  configSchema: {
-    type: "object",
-    properties: {
-      enabled: {
-        type: "boolean",
-        description: "Enable static file serving"
-      },
-      publicDir: {
-        type: "string",
-        description: "Public directory for static files"
-      },
-      distDir: {
-        type: "string", 
-        description: "Distribution directory for built files"
-      },
-      indexFile: {
-        type: "string",
-        description: "Index file for SPA routing"
-      },
-      cacheControl: {
-        type: "object",
-        properties: {
-          enabled: { type: "boolean" },
-          maxAge: { type: "number" },
-          immutable: { type: "boolean" }
-        },
-        description: "Cache control settings"
-      },
-      compression: {
-        type: "object",
-        properties: {
-          enabled: { type: "boolean" },
-          types: {
-            type: "array",
-            items: { type: "string" }
-          }
-        },
-        description: "Compression settings"
-      },
-      spa: {
-        type: "object",
-        properties: {
-          enabled: { type: "boolean" },
-          fallback: { type: "string" }
-        },
-        description: "Single Page Application settings"
-      },
-      excludePaths: {
-        type: "array",
-        items: { type: "string" },
-        description: "Paths to exclude from static serving"
-      }
-    },
-    additionalProperties: false
-  },
-  
-  defaultConfig: {
-    enabled: true,
-    publicDir: "public",
-    distDir: "dist/client",
-    indexFile: "index.html",
-    cacheControl: {
-      enabled: true,
-      maxAge: 31536000, // 1 year for assets
-      immutable: true
-    },
-    compression: {
-      enabled: true,
-      types: [".js", ".css", ".html", ".json", ".svg"]
-    },
-    spa: {
-      enabled: true,
-      fallback: "index.html"
-    },
-    excludePaths: []
-  },
+  dependencies: [],
 
   setup: async (context: PluginContext) => {
-    const config = getPluginConfig(context)
-    
-    if (!config.enabled) {
-      context.logger.info('Static files plugin disabled by configuration')
+    if (!DEFAULTS.enabled) {
+      context.logger.info('Static files plugin disabled')
       return
     }
 
-    context.logger.info("Enhanced static files plugin activated", {
-      publicDir: config.publicDir,
-      distDir: config.distDir,
-      spa: config.spa.enabled,
-      compression: config.compression.enabled
+    context.logger.info("Static files plugin activated", {
+      publicDir: DEFAULTS.publicDir
     })
-    
-    // Helper function for handling both GET and HEAD requests
-    const handleStaticRequest = async ({ request, set }: { request: Request, set: any }) => {
-      const url = new URL(request.url)
-      
-      // Skip API routes
-      if (url.pathname.startsWith(context.config.server.apiPrefix)) {
-        return
+
+    // Static fallback handler (runs last)
+    const staticFallback = (c: any) => {
+      const req = c.request
+      if (!req) return
+
+      const url = new URL(req.url)
+      let pathname = decodeURIComponent(url.pathname)
+
+      // Determine base directory using path discovery
+      const isDev = context.utils.isDevelopment()
+      let baseDir: string
+
+      if (isDev && existsSync(DEFAULTS.publicDir)) {
+        // Development: use public directory
+        baseDir = DEFAULTS.publicDir
+      } else {
+        // Production: try paths in order of preference
+        if (existsSync('client')) {
+          // Found client/ in current directory (running from dist/)
+          baseDir = 'client'
+        } else if (existsSync('dist/client')) {
+          // Found dist/client/ (running from project root)
+          baseDir = 'dist/client'
+        } else {
+          // Fallback to configured path
+          baseDir = DEFAULTS.publicDir
+        }
+      }
+
+      // Root or empty path → index.html
+      if (pathname === '/' || pathname === '') {
+        pathname = `/${DEFAULTS.indexFile}`
       }
-      
-      // Skip excluded paths
-      if (config.excludePaths.some((path: string) => url.pathname.startsWith(path))) {
-        return
+
+      const filePath = join(baseDir, pathname)
+
+      try {
+        const info = statSync(filePath)
+
+        // File exists → serve it
+        if (info.isFile()) {
+          return new Response(Bun.file(filePath))
+        }
+      } catch (_) {
+        // File not found → continue
       }
-      
+
+      // SPA fallback: serve index.html for non-file routes
+      const indexPath = join(baseDir, DEFAULTS.indexFile)
       try {
-        // Note: Vite proxy is now handled by the Vite plugin via onBeforeRoute hook
-        // This plugin only handles static files serving in production or fallback
-        
-        // Serve static files
-        return await serveStaticFile(url.pathname, config, context, set, request.method === 'HEAD')
-        
-      } catch (error) {
-        context.logger.error("Error serving static file", { 
-          path: url.pathname, 
-          error: error instanceof Error ? error.message : String(error)
-        })
-        
-        set.status = 500
-        return "Internal Server Error"
+        statSync(indexPath) // Ensure index exists
+        return new Response(Bun.file(indexPath))
+      } catch (_) {
+        // Index not found → let request continue (404)
       }
     }
 
-    // Setup static file handling in Elysia - handle both GET and HEAD
-    context.app.get("/*", handleStaticRequest)
-    context.app.head("/*", handleStaticRequest)
+    // Register as catch-all fallback (runs after all other routes)
+    context.app.all('*', staticFallback)
   },
 
   onServerStart: async (context: PluginContext) => {
-    const config = getPluginConfig(context)
-    
-    if (config.enabled) {
-      const mode = context.utils.isDevelopment() ? 'development' : 'production'
-      context.logger.info(`Static files plugin ready in ${mode} mode`, {
-        publicDir: config.publicDir,
-        distDir: config.distDir,
-        spa: config.spa.enabled
+    if (DEFAULTS.enabled) {
+      context.logger.info(`Static files plugin ready`, {
+        publicDir: DEFAULTS.publicDir,
+        indexFile: DEFAULTS.indexFile
       })
     }
   }
 }
 
-// Helper function to get plugin config
-function getPluginConfig(context: PluginContext) {
-  const pluginConfig = context.config.plugins.config?.static || {}
-  return { ...staticPlugin.defaultConfig, ...pluginConfig }
-}
-
-// Serve static file
-async function serveStaticFile(
-  pathname: string, 
-  config: any, 
-  context: PluginContext,
-  set: any,
-  isHead: boolean = false
-): Promise<any> {
-  const isDev = context.utils.isDevelopment()
-  
-  // Determine base directory using path discovery (no hardcoded detection)
-  let baseDir: string
-  
-  if (isDev && existsSync(config.publicDir)) {
-    // Development: use public directory
-    baseDir = config.publicDir
-  } else {
-    // Production: try paths in order of preference
-    if (existsSync('client')) {
-      // Found client/ in current directory (running from dist/)
-      baseDir = 'client'
-    } else if (existsSync('dist/client')) {
-      // Found dist/client/ (running from project root)
-      baseDir = 'dist/client'
-    } else {
-      // Fallback to configured path
-      baseDir = config.distDir
-    }
-  }
-  
-  if (!existsSync(baseDir)) {
-    context.logger.warn(`Static directory not found: ${baseDir}`)
-    set.status = 404
-    return "Not Found"
-  }
-  
-  // Clean pathname
-  const cleanPath = pathname === '/' ? `/${config.indexFile}` : pathname
-  const filePath = join(process.cwd(), baseDir, cleanPath)
-  
-  // Security check - prevent directory traversal
-  const resolvedPath = join(process.cwd(), baseDir)
-  if (!filePath.startsWith(resolvedPath)) {
-    set.status = 403
-    return "Forbidden"
-  }
-  
-  // Check if file exists
-  if (!existsSync(filePath)) {
-    // For SPA, serve index.html for non-file routes
-    if (config.spa.enabled && !pathname.includes('.')) {
-      const indexPath = join(process.cwd(), baseDir, config.spa.fallback)
-      if (existsSync(indexPath)) {
-        return serveFile(indexPath, config, set, context, isHead)
-      }
-    }
-    
-    set.status = 404
-    return "Not Found"
-  }
-  
-  // Check if it's a directory
-  const stats = statSync(filePath)
-  if (stats.isDirectory()) {
-    const indexPath = join(filePath, config.indexFile)
-    if (existsSync(indexPath)) {
-      return serveFile(indexPath, config, set, context, isHead)
-    }
-    
-    set.status = 404
-    return "Not Found"
-  }
-  
-  return serveFile(filePath, config, set, context, isHead)
-}
-
-// Serve individual file
-function serveFile(filePath: string, config: any, set: any, context: PluginContext, isHead: boolean = false) {
-  const ext = extname(filePath)
-  const file = Bun.file(filePath)
-  
-  // Set content type
-  const mimeTypes: Record<string, string> = {
-    '.html': 'text/html',
-    '.css': 'text/css',
-    '.js': 'application/javascript',
-    '.json': 'application/json',
-    '.png': 'image/png',
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.gif': 'image/gif',
-    '.svg': 'image/svg+xml',
-    '.ico': 'image/x-icon',
-    '.woff': 'font/woff',
-    '.woff2': 'font/woff2',
-    '.ttf': 'font/ttf',
-    '.eot': 'application/vnd.ms-fontobject'
-  }
-  
-  const contentType = mimeTypes[ext] || 'application/octet-stream'
-  set.headers['Content-Type'] = contentType
-  
-  // Set content-length for both GET and HEAD requests
-  set.headers['Content-Length'] = file.size.toString()
-  
-  // Set cache headers
-  if (config.cacheControl.enabled) {
-    if (ext === '.html') {
-      // Don't cache HTML files aggressively
-      set.headers['Cache-Control'] = 'no-cache'
-    } else {
-      // Cache assets aggressively
-      const maxAge = config.cacheControl.maxAge
-      const cacheControl = config.cacheControl.immutable 
-        ? `public, max-age=${maxAge}, immutable`
-        : `public, max-age=${maxAge}`
-      set.headers['Cache-Control'] = cacheControl
-    }
-  }
-  
-  // Add compression hint if enabled
-  if (config.compression.enabled && config.compression.types.includes(ext)) {
-    set.headers['Vary'] = 'Accept-Encoding'
-  }
-  
-  context.logger.debug(`Serving static file: ${filePath}`, {
-    contentType,
-    size: file.size,
-    method: isHead ? 'HEAD' : 'GET'
-  })
-  
-  // For HEAD requests, return empty body but keep all headers
-  if (isHead) {
-    return ""
-  }
-  
-  return file
-}
-
 export default staticPlugin