module

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

type Context struct {
	DB                *sql.DB
	Store             *store.Queries
	Logger            *slog.Logger
	Config            *config.Config
	Render            *render.Renderer
	Events            *service.EventService
	Hooks             *HookRegistry
	SchedulerRegistry *scheduler.Registry
}

type EnvironmentChecker interface {
	AllowedEnvs() []string
}

type HookFunc func(ctx context.Context, data any) (any, error)

type HookHandler struct {
	Name     string   // Name of the handler for debugging
	Module   string   // Module that registered the handler
	Priority int      // Lower priority runs first (default: 0)
	Fn       HookFunc // The actual handler function
}

type HookHandlerInfo struct {
	Name     string
	Module   string
	Priority int
}

type HookInfo struct {
	Name     string
	Handlers []HookHandlerInfo
}

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

type Info struct {
	Name              string
	Version           string
	Description       string
	Initialized       bool
	Active            bool   // Whether the module is active (routes/hooks enabled)
	ShowInSidebar     bool   // Whether the module appears in admin sidebar
	MigrationCount    int    // Total number of migrations defined
	MigrationsApplied int    // Number of migrations applied
	MigrationsPending int    // Number of pending migrations
	HasMigrations     bool   // Whether the module has any migrations
	AdminURL          string // URL to module's admin dashboard (empty if none)
}

type IsModuleActiveFunc func(moduleName string) bool

type Migration struct {
	Version     int64
	Description string
	Up          func(db *sql.DB) error
	Down        func(db *sql.DB) error
}

type MigrationInfo struct {
	Version     int64
	Description string
	Applied     bool
}

type Module interface {
	// Name returns the module name.
	Name() string
	// Version returns the module version.
	Version() string
	// Description returns the module description.
	Description() string
	// Dependencies returns the list of module dependencies.
	Dependencies() []string

	// Init initializes the module with the given context.
	Init(ctx *Context) error
	// Shutdown performs cleanup when the module is shutting down.
	Shutdown() error

	// RegisterRoutes registers public routes for the module.
	RegisterRoutes(r chi.Router)

	// RegisterAdminRoutes registers admin routes for the module.
	RegisterAdminRoutes(r chi.Router)

	// TemplateFuncs returns template functions provided by the module.
	TemplateFuncs() template.FuncMap

	// Migrations returns migrations for the module.
	Migrations() []Migration

	// AdminURL returns the admin dashboard URL for the module (e.g., "/admin/developer").
	// Return empty string if module has no admin dashboard.
	AdminURL() string

	// SidebarLabel returns the display label for the admin sidebar.
	// Return empty string to use the module name as label.
	SidebarLabel() string

	// TranslationsFS returns an embedded filesystem containing module translations.
	// Expected structure: locales/{lang}/messages.json
	// Return nil if module has no translations.
	TranslationsFS() embed.FS
}

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