plugin

type AppContext struct {
	Router   chi.Router
	DB       Database
	Redis    *redis.Client
	Logger   *zap.Logger
	Services *ServiceRegistry
	Config   ConfigProvider
	Events   EventBus
}

type ConfigProvider interface {
	Get(key string) (any, bool)
	GetString(key string, defaultVal string) string
	GetInt(key string, defaultVal int) int
	GetBool(key string, defaultVal bool) bool
	Bind(target any) error
	IsEnabled() bool
}

type Configurable interface {
	PluginOptions() PluginOptions
}

type Database interface {
	Close() error
}

type Disableable interface {
	Disable(ctx context.Context, app *AppContext) error
}

type DomainPlugin interface {
	TypeCode() string
	ResolveDomain(ctx context.Context, r *http.Request) (*ResolvedDomainInfo, bool, error)
	ValidateMembership(ctx context.Context, domainID uuid.UUID, subject Subject) (bool, error)
}

type Event struct {
	Name      string    // e.g. "user.created"
	Data      any       // payload
	Source    string    // originating plugin name
	Timestamp time.Time // when the event was created
}

type EventBus interface {
	// Publish sends an event. Blocks if buffer is full until ctx expires.
	Publish(ctx context.Context, event Event) error

	// Subscribe registers a handler for a topic. Returns a Subscription for unsubscribing.
	Subscribe(topic string, handler EventHandler) Subscription

	// Close drains pending events and waits for in-flight handlers to complete.
	Close() error
}

type EventHandler func(ctx context.Context, event Event) error

type EventSubscriber interface {
	SubscribeEvents(bus EventBus)
}

type HealthReporter interface {
	HealthCheck(ctx context.Context) error
}

type Installable interface {
	Install(ctx context.Context, app *AppContext) error
}

type MapConfigProvider = PluginConfigEntry

type MiddlewareProvider interface {
	RegisterMiddlewares(router chi.Router)
}

type ModelProvider interface {
	RegisterModels() []any
}

type Plugin interface {
	Name() string
	Version() string
	Dependencies() []string
	Enable(ctx context.Context, app *AppContext) error
}

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

type PluginOptions struct {
	Optional    bool   // If true, failure does not abort bootstrap.
	Description string // Human-readable description.
}

type PluginState int

type ResolvedDomainInfo struct {
	DomainID    uuid.UUID `json:"domainId"`
	TypeCode    string    `json:"typeCode"`
	Key         string    `json:"key"`
	DisplayName string    `json:"displayName"`
}

type RouteProvider interface {
	RegisterRoutes(router chi.Router)
}

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

type Subject struct {
	ID   uuid.UUID `json:"id"`
	Type string    `json:"type"`
}

type Subscription interface {
	Unsubscribe()
}

type Uninstallable interface {
	Uninstall(ctx context.Context, app *AppContext) error
}