mcpserver

type AuditEntry struct {
	KeyID   uuid.UUID
	KeyName string
	Tool    string
	Args    json.RawMessage
	Err     error
}

type Auditor interface {
	Record(ctx context.Context, e AuditEntry)
}

type Deps struct {
	Keys           KeyService
	Limiter        Limiter
	Entities       *entity.Service
	PublicEntities *entity.PostgresPublicRepository
	Media          *media.Service
	Menus          *menu.Service
	Taxonomy       *taxonomy.Service
	Redirects      *redirect.Service
	Crawlers       *agents.StatsRepository
	Referrals      *analytics.Reader
	Audit          Auditor
	Logger         *slog.Logger

	// ClientIP is the caller's address as the API sees it (trusted-proxy
	// aware). Defaults to the connection's remote address.
	ClientIP func(*http.Request) string
	// PublicOrigin is the site's public origin (scheme://host from
	// PUBLIC_BASE_URL); a browser request carrying an Origin header must
	// match it or one of AllowedOrigins. Requests without Origin (non-browser
	// clients) are always allowed.
	PublicOrigin   string
	AllowedOrigins []string

	// Fetch serves a public GET path in process (sitemaps, llms.txt, pages).
	Fetch func(ctx context.Context, path string) (Response, error)
	// PageURL is the public path of an entity.
	PageURL func(ctx context.Context, e *entity.Entity) string
	// Changed drops cached pages and sitemaps after a write the entity
	// events do not cover (menus, redirects, terms).
	Changed func(ctx context.Context)

	// The builder tools. BuilderEntities defaults to Entities; the others
	// are optional and the tools that need one say so when it is nil.
	BuilderEntities entity.BuilderStore
	// Design resolves the site's design tokens and presets (builder_design).
	Design func(ctx context.Context) (DesignInfo, error)
	// Templates is the section template store (builder_templates_list).
	Templates TemplateStore
	// RenderPage renders a document in the page's context (builder_render).
	RenderPage func(ctx context.Context, req RenderRequest) (RenderResult, error)
}

type DesignInfo struct {
	// Colors by name (primary bg text surface muted accent), Space by step
	// ("0".."12") and FS by name (xs..4xl); the values style keys accept as tokens.
	Colors, Space, FS map[string]string
	Presets           []DesignPreset
}

type DesignPreset struct {
	Name  string                       `json:"name"`
	Label string                       `json:"label"`
	S     map[string]map[string]string `json:"s"`
}

type JSONLDNode struct {
	Type     string   `json:"type"`
	Errors   []string `json:"errors,omitempty"`
	Warnings []string `json:"warnings,omitempty"`
}

type JSONLDReport struct {
	Valid  bool         `json:"valid"` // no errors (warnings allowed)
	Blocks int          `json:"blocks"`
	Nodes  []JSONLDNode `json:"nodes"`
	Errors []string     `json:"errors,omitempty"` // block-level problems
}

type KeyService interface {
	ValidateKey(ctx context.Context, plainKey string) (*hmauth.APIKey, error)
	RecordUsage(ctx context.Context, keyID uuid.UUID, ipAddress string) error
}

type Limiter interface {
	Allow(keyID uuid.UUID, rateLimit int) bool
}

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

type RenderRequest struct {
	Entity *entity.Entity
	Doc    []byte
	IDs    []string
}

type RenderResult struct {
	HTML, CSS string
}

type Response struct {
	Status int
	Body   []byte
}

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

type TemplateStore interface {
	List(ctx context.Context, f *sectiontemplate.ListFilter, limit, offset int) (*sectiontemplate.ListResult, error)
	Get(ctx context.Context, id uuid.UUID) (*sectiontemplate.SectionTemplate, error)
}