boot

type ActionResponse struct {
	StatusCode int            `json:"status_code"`
	Data       map[string]any `json:"data"`
}

type ActivityBinding interface {
	List(router.Context) (map[string]any, error)
	FilterOptions(router.Context) (any, error)
}

type BootCtx interface {
	LifecycleContext() context.Context
	Router() Router
	AuthWrapper() HandlerWrapper
	BasePath() string
	AdminUIGroup() string
	AdminAPIGroup() string
	RoutingPlanner() routing.Planner
	URLs() urlkit.Resolver
	DefaultLocale() string
	NavMenuCode() string
	Gates() FeatureGates
	Responder() Responder
	ParseBody(router.Context) (map[string]any, error)

	Panels() []PanelBinding
	SetMountedPanelRoutes([]string)
	BootDashboard() DashboardBinding
	BootNavigation() NavigationBinding
	BootSearch() SearchBinding
	ExportRegistrar() ExportRegistrar
	BootBulk() BulkBinding
	BootMedia() MediaBinding
	BootUserImport() UserImportBinding
	BootTranslationFamilies() TranslationFamiliesBinding
	BootTranslationExchange() TranslationExchangeBinding
	BootTranslationQueue() TranslationQueueBinding
	BootNotifications() NotificationsBinding
	BootActivity() ActivityBinding
	BootJobs() JobsBinding
	BootSettings() SettingsBinding
	BootWorkflows() WorkflowManagementBinding
	BootSchemaRegistry() SchemaRegistryBinding
	BootFeatureOverrides() FeatureOverridesBinding
	BootIcons() IconsBinding

	SettingsWidget() error
	ActivityWidget() error
	NotificationsWidget() error
	RegisterWidgetAreas() error
	RegisterWidgetDefinitions() error
	RegisterDashboardProviders() error
}

type BulkBinding interface {
	List(router.Context) (map[string]any, error)
	Start(router.Context, map[string]any) (map[string]any, error)
	Rollback(router.Context, string, map[string]any) (map[string]any, error)
}

type DashboardBinding interface {
	Enabled() bool
	HasRenderer() bool
	RenderHTML(router.Context, string) (string, error)
	Widgets(router.Context, string) (map[string]any, error)
	Preferences(router.Context, string) (map[string]any, error)
	SavePreferences(router.Context, map[string]any) (map[string]any, error)
	Diagnostics(router.Context, string) (map[string]any, error)
}

type ExportRegistrar interface {
	Register(Router, ExportRouteOptions) error
}

type ExportRouteOptions struct {
	BasePath string         `json:"base_path"`
	Wrap     HandlerWrapper `json:"wrap"`
}

type FeatureGates interface {
	Enabled(key string) bool
	Require(key string) error
}

type FeatureOverridesBinding interface {
	List(router.Context) (map[string]any, error)
	Set(router.Context, map[string]any) (map[string]any, error)
	Unset(router.Context, map[string]any) (map[string]any, error)
}

type HandlerWrapper func(router.HandlerFunc) router.HandlerFunc

type IconsBinding interface {
	// Libraries returns all registered icon libraries.
	Libraries(router.Context) (map[string]any, error)
	// Library returns a single icon library by ID.
	Library(router.Context, string) (map[string]any, error)
	// LibraryIcons returns icons from a library, optionally filtered by category.
	LibraryIcons(router.Context, string, string) ([]map[string]any, error)
	// Search searches icons across libraries.
	Search(router.Context, string, int) ([]map[string]any, error)
	// Resolve resolves an icon reference to its definition.
	Resolve(router.Context, string) (map[string]any, error)
	// Render renders an icon to HTML.
	Render(router.Context, string, string) (map[string]any, error)
}

type JobsBinding interface {
	List(router.Context) (map[string]any, error)
	Trigger(router.Context, map[string]any) error
}

type ListOptions struct {
	Page       int             `json:"page"`
	PerPage    int             `json:"per_page"`
	SortBy     string          `json:"sort_by"`
	SortDesc   bool            `json:"sort_desc"`
	Filters    map[string]any  `json:"filters"`
	Predicates []ListPredicate `json:"predicates"`
	Fields     []string        `json:"fields"`
	Search     string          `json:"search"`
}

type ListPredicate struct {
	Field    string   `json:"field"`
	Operator string   `json:"operator"`
	Values   []string `json:"values"`
}

type MediaBinding interface {
	List(router.Context) (any, error)
	Get(router.Context, string) (any, error)
	Resolve(router.Context, map[string]any) (any, error)
	Upload(router.Context, map[string]any, MultipartFile) (any, error)
	Presign(router.Context, map[string]any) (any, error)
	Confirm(router.Context, map[string]any) (any, error)
	Update(router.Context, string, map[string]any) (any, error)
	Delete(router.Context, string) error
	Capabilities(router.Context) (any, error)
}

type MultipartFile struct {
	FileName    string
	ContentType string
	Size        int64
	Reader      io.ReadCloser
}

type NavigationBinding interface {
	Resolve(router.Context, string, string) (items any, theme map[string]map[string]string)
}

type NotificationCapabilities struct {
	Deliveries bool `json:"deliveries"`
	Receipts   bool `json:"receipts"`
	Retention  bool `json:"retention"`
}

type NotificationsBinding interface {
	Capabilities() NotificationCapabilities
	List(router.Context) (map[string]any, error)
	Mark(router.Context, map[string]any) error
	ListDeliveries(router.Context) (any, error)
	GetDeliveryEvent(router.Context, string) (any, error)
	GetDeliveryMessage(router.Context, string) (any, error)
	LookupReceipt(router.Context, map[string]any) (any, error)
	PurgeRetention(router.Context, map[string]any) (any, error)
}

type PanelBinding interface {
	Name() string
	List(router.Context, string, ListOptions) ([]map[string]any, int, any, any, map[string]any, error)
	Detail(router.Context, string, string) (map[string]any, error)
	Create(router.Context, string, map[string]any) (map[string]any, error)
	Update(router.Context, string, string, map[string]any) (map[string]any, error)
	Delete(router.Context, string, string) error
	Action(router.Context, string, string, map[string]any) (ActionResponse, error)
	BulkActionState(router.Context, string, map[string]any) (map[string]any, error)
	Bulk(router.Context, string, string, map[string]any) (map[string]any, error)
	Preview(router.Context, string, string) (map[string]any, error)
	Subresources() []PanelSubresourceSpec
	HandleSubresource(router.Context, string, string, string, string) error
}

type PanelSubresourceSpec struct {
	Name   string `json:"name"`
	Method string `json:"method"`
}

type Responder interface {
	WriteJSON(router.Context, any) error
	WriteJSONStatus(router.Context, int, any) error
	WriteHTML(router.Context, string) error
	WriteError(router.Context, error) error
}

type RouteSpec struct {
	Method  string             `json:"method"`
	Path    string             `json:"path"`
	Handler router.HandlerFunc `json:"handler"`
}

type Router interface {
	Handle(method router.HTTPMethod, path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Get(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Post(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Put(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Delete(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Patch(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Head(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
}

type SchemaRegistryBinding interface {
	List(router.Context) (any, error)
	Get(router.Context, string) (any, error)
}

type SearchBinding interface {
	Query(router.Context, string, string, int) ([]any, error)
}

type SettingsBinding interface {
	Values(router.Context) (map[string]any, error)
	Form(router.Context) (any, error)
	Save(router.Context, map[string]any) (map[string]any, error)
}

type StaticRouter[T any] interface {
	Router
	Static(prefix, root string, config ...router.Static) router.Router[T]
}

type Step func(BootCtx) error

type TranslationExchangeBinding interface {
	Export(router.Context) (any, error)
	Template(router.Context) error
	ImportValidate(router.Context) (any, error)
	ImportApply(router.Context) (any, error)
	History(router.Context) (any, error)
	JobStatus(router.Context, string) (any, error)
	DeleteJob(router.Context, string) (any, error)
}

type TranslationFamiliesBinding interface {
	List(router.Context) (any, error)
	Detail(router.Context, string) (any, error)
	Create(router.Context, string) (any, error)
	CreateAssignment(router.Context, string) (any, error)
	Matrix(router.Context) (any, error)
	CreateMissingBulk(router.Context, map[string]any) (any, error)
	ExportSelectedBulk(router.Context, map[string]any) (any, error)
}

type TranslationQueueBinding interface {
	Assignments(router.Context) (any, error)
	FamilyAssignments(router.Context, string) (any, error)
	AssignmentDetail(router.Context, string) (any, error)
	AssignmentPreview(router.Context, string) (any, error)
	RunAssignmentAction(router.Context, string, string, map[string]any) (any, error)
	CreateAssignmentBulkSnapshot(router.Context, map[string]any) (any, error)
	RunAssignmentBulkAction(router.Context, map[string]any) (any, error)
	ReadDraftSync(router.Context) error
	MutateDraftSync(router.Context) error
	Dashboard(router.Context) (any, error)
	MyWork(router.Context) (any, error)
	Queue(router.Context) (any, error)
	EntityTypesOptions(router.Context) (any, error)
	SourceRecordsOptions(router.Context) (any, error)
	LocalesOptions(router.Context) (any, error)
	TranslationGroupsOptions(router.Context) (any, error)
	AssigneesOptions(router.Context) (any, error)
	ReviewersOptions(router.Context) (any, error)
}

type UserImportBinding interface {
	ImportUsers(router.Context) error
	ImportTemplate(router.Context) error
}

type WorkflowManagementBinding interface {
	ListWorkflows(router.Context) (map[string]any, error)
	CreateWorkflow(router.Context, map[string]any) (map[string]any, error)
	UpdateWorkflow(router.Context, string, map[string]any) (map[string]any, error)

	ListBindings(router.Context) (map[string]any, error)
	CreateBinding(router.Context, map[string]any) (map[string]any, error)
	UpdateBinding(router.Context, string, map[string]any) (map[string]any, error)
	DeleteBinding(router.Context, string) error
}