go_ssr

type Config struct {
	AppEnv              string            // "production" or "development"
	AssetRoute          string            // The route to serve assets from, e.g. "/assets"
	FrontendDir         string            // The path to the frontend folder, where your React app lives
	GeneratedTypesPath  string            // The path to the generated types file
	PropsStructsPath    string            // The path to the Go structs file(s), comma-separated for multiple files
	LayoutFilePath      string            // The path to the layout file, relative to the frontend dir
	LayoutCSSFilePath   string            // The path to the layout css file, relative to the frontend dir
	TailwindConfigPath  string            // The path to the tailwind config file
	HotReloadServerPort int               // The port to run the hot reload server on, 3001 by default
	JSRuntimePoolSize   int               // The number of JS runtimes to keep in the pool, 10 by default
	CacheConfig         cache.CacheConfig // Cache configuration (local or redis)
	ClientAppPath       string            // Path to client SPA app (e.g., "App.tsx") for client-side routing after hydration
	// SPA hydration mode options (only used when ClientAppPath is set):
	// - "router": wraps with StaticRouter/BrowserRouter for true hydration (default, requires react-router-dom)
	// - "replace": uses createRoot to replace SSR HTML (no hydration, compatible with any SPA structure)
	SPAHydrationMode string // "router" or "replace", defaults to "router"
	// External JS file options (for browser caching optimization):
	// When StaticJSDir is set, JS bundles are written to files instead of inlined in HTML.
	// This enables browser caching - the React library bundle rarely changes and can be cached.
	StaticJSDir string // Directory to write JS files (e.g., "frontend/dist/assets"). If empty, JS is inlined.
	IsDev       bool   // Development mode - enables hot reload, disables caching

	// Generators are custom code generators that run during engine initialization (dev mode only)
	// Use this to generate routes, API clients, or any other code based on the SSR configuration
	Generators []Generator
}

type Engine struct {
	Logger                  *slog.Logger
	Config                  *Config
	HotReload               *HotReload
	Cache                   cache.Cache
	RuntimePool             *jsruntime.Pool
	CachedLayoutCSSFilePath string
	CachedClientSPAJS       string // Cached client SPA bundle JS
	CachedServerSPAJS       string // Cached server SPA bundle JS (for StaticRouter rendering)
	CachedServerSPACSS      string // Cached server SPA bundle CSS
}

type Generator interface {
	// Generate is called during engine initialization (dev mode only)
	// config contains all SSR configuration including props paths
	Generate(config *Config) error
}

type HotReload struct {
	// contains filtered or unexported fields
}

type RenderConfig struct {
	File        string
	Title       string
	MetaTags    map[string]string
	Props       interface{}
	RequestPath string // Current request URL path for SPA routing (e.g., "/board/1")
}