hop

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

type AppConfig struct {
	// Environment is the application environment (default: "development")
	Environment string
	// Host is the host address to bind the server to (default: "" - all interfaces)
	Host string
	// Port is the port to bind the server to (default: 8080)
	Port int
	// Handler is the http.Handler to use for the server (default: http.DefaultServeMux)
	Handler http.Handler
	// IdleTimeout is the maximum amount of time to wait for the next request when keep-alives are enabled (default: 120s)
	IdleTimeout time.Duration
	// ReadTimeout is the maximum duration before timing out read of the request (default: 5s)
	ReadTimeout time.Duration
	// WriteTimeout is the maximum duration before timing out write of the response (default: 10s)
	WriteTimeout time.Duration
	// ShutdownTimeout is the maximum duration before timing out server shutdown (default: 10s)
	ShutdownTimeout time.Duration
	// Logger is the application's logging instance. If nil, a default logger will be created based on the configuration
	Logger *slog.Logger
	// TemplateFS is the file system to use for template files
	TemplateFS fs.FS
	// TemplateFuncs merges custom template functions into the default set of functions provided by hop. These are available in all templates.
	TemplateFuncs template.FuncMap
	// TemplateExt defines the extension for template files (default: ".html")
	TemplateExt string
	// SessionStore provides the storage backend for sessions
	SessionStore scs.Store
	// SessionCookieLifetime is the duration for session cookies to persist (default: 168h)
	SessionLifetime time.Duration
	// SessionCookiePersist determines whether session cookies persist after the browser is closed (default: true)
	SessionCookiePersist bool
	// SessionCookieSameSite defines the SameSite attribute for session cookies (default: "lax")
	SessionCookieSameSite string
	// SessionCookieSecure determines whether session cookies are for secure connections only (default: true)
	SessionCookieSecure bool
	// SessionCookieHTTPOnly determines whether session cookies are HTTP-only (default: true)
	SessionCookieHTTPOnly bool
	// SessionCookiePath is the path for session cookies (default: "/")
	SessionCookiePath string
	// Stdout writer for standard output (default: os.Stdout)
	Stdout io.Writer
	// Stderr writer for error output (default: os.Stderr)
	Stderr io.Writer
}

type ConfigurableModule interface {
	Module
	// Configure applies the provided configuration to the module
	// The config parameter should be type asserted to the module's
	// specific configuration type
	Configure(ctx context.Context, config any) error
}

type DispatcherModule interface {
	Module
	// RegisterEvents registers the module's event handlers with the dispatcher
	RegisterEvents(events *dispatch.Dispatcher)
}

type HTTPModule interface {
	Module
	// RegisterRoutes adds the module's routes to the provided router
	RegisterRoutes(handler http.Handler)
}

type Module interface {
	// ID returns a unique identifier for the module
	ID() string

	// Init performs any necessary module initialization
	// It is called when the module is registered with the application
	Init() error
}

type OnTemplateDataFunc func(r *http.Request, data *map[string]any)

type ShutdownModule interface {
	Module
	// Stop performs cleanup actions for the module
	// It should respect the provided context's deadline for graceful shutdown
	Stop(ctx context.Context) error
}

type StartupModule interface {
	Module
	// Start performs startup actions for the module
	// The provided context will be canceled when the application begins shutdown
	Start(ctx context.Context) error
}

type TemplateDataModule interface {
	Module
	// OnTemplateData allows the module to add data to the template context
	// The provided map will be merged with other template data
	OnTemplateData(r *http.Request, data *map[string]any)
}