handlers

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

type APIKeyListItem struct {
	ID         int        `json:"id"`
	Name       string     `json:"name"`
	Prefix     string     `json:"prefix"`
	CreatedAt  time.Time  `json:"createdAt"`
	LastUsedAt *time.Time `json:"lastUsedAt"`
	ExpiresAt  *time.Time `json:"expiresAt"`
	RevokedAt  *time.Time `json:"revokedAt"`
}

type APIKeyService interface {
	// Existing (Story 1.1):
	Create(ctx context.Context, principal kernel.Principal, name string) (string, *apikey.APIKey, error)
	// New (Story 1.2):
	List(ctx context.Context, principal kernel.Principal) ([]*apikey.APIKey, error)
	Revoke(ctx context.Context, id int, principal kernel.Principal) (*apikey.APIKey, error)
}

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

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

type ContentServiceInterface interface {
	Create(ctx context.Context, principal kernel.Principal, req contentdomain.CreateContentRequest) (*contentdomain.Content, error)
	GetByUser(ctx context.Context, userID int, limit int, offset int) ([]*contentdomain.Content, error)
	GetAll(ctx context.Context, limit int, offset int) ([]*contentdomain.Content, error)
	GetByID(ctx context.Context, id int) (*contentdomain.Content, error)
	GenerateSlugFromTitle(ctx context.Context, title string) (string, error)
	Update(ctx context.Context, id int, principal kernel.Principal, req contentservice.UpdateContentRequest) (*contentdomain.Content, error)
	DeleteContent(ctx context.Context, id int, principal kernel.Principal) error
	GetPublished(ctx context.Context, limit int, offset int) ([]*contentdomain.Content, error)
	GetPublishedBySlug(ctx context.Context, slug string, language string) (*contentdomain.Content, error)
	GetTranslations(ctx context.Context, translationGroupID int, excludeID int) ([]*contentdomain.Content, error)
	GetPublishedByAuthorUsername(ctx context.Context, username string, languages []string, limit int, offset int) ([]*contentdomain.Content, error)
	AuthorExists(ctx context.Context, username string) (bool, error)
	ListByFilters(ctx context.Context, userID int, filters contentdomain.ContentFilters) ([]*contentdomain.Content, error)
	Count(ctx context.Context, userID int, filters contentdomain.ContentFilters) (int, error)
	SetSystemFields(ctx context.Context, contentID int, principal kernel.Principal, systemFields map[string]any) (*contentdomain.Content, error)
	SearchPublished(ctx context.Context, query string, limit int) ([]*contentdomain.Content, error)
	GetPublishedAuthors(ctx context.Context, filters contentdomain.PublishedAuthorFilters) ([]*contentdomain.PublishedAuthor, error)
	GetPublishedAuthor(ctx context.Context, username string) (*contentdomain.PublishedAuthor, error)
	GetPublishedArchive(ctx context.Context, postType string, languages []string) ([]*contentdomain.ArchiveMonth, error)
	GetPublishedByPostType(ctx context.Context, postType string, languages []string, year int, month int, limit int, offset int) ([]*contentdomain.Content, error)
}

type CreateAPIKeyRequest struct {
	Name  string `json:"name"`
	Scope string `json:"scope,omitempty"` // TODO(story-future): per-key scopes deferred — accepted but not persisted
}

type CreateAPIKeyResponse struct {
	Key       string    `json:"key"`
	ID        int       `json:"id"`
	Name      string    `json:"name"`
	KeyPrefix string    `json:"keyPrefix"`
	CreatedAt time.Time `json:"createdAt"`
}

type CreateContentData struct {
	Content *contentdomain.Content `json:"content"`
}

type CreateContentRequest struct {
	Title              string         `json:"title"`
	Slug               string         `json:"slug,omitempty"`
	Content            string         `json:"content"`
	Format             string         `json:"format,omitempty"`
	Tags               []string       `json:"tags"`
	Status             string         `json:"status"`
	PostType           string         `json:"postType"`
	MetaDescription    string         `json:"metaDescription,omitempty"`
	OGTitle            string         `json:"ogTitle,omitempty"`
	OGDescription      string         `json:"ogDescription,omitempty"`
	AllowComments      *bool          `json:"allowComments,omitempty"`
	CustomFields       map[string]any `json:"customFields,omitempty"`
	Language           string         `json:"language,omitempty"`
	TranslationGroupID *int           `json:"translationGroupId,omitempty"`
}

type CreateContentResponse struct {
	Data *CreateContentData `json:"data"`
	Meta *ResponseMeta      `json:"meta"`
}

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

type DashboardServiceInterface interface {
	GetStats(ctx context.Context, principal kernel.Principal) (*dashboarddomain.Stats, error)
}

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

type GenerateSlugData struct {
	Slug string `json:"slug"`
}

type GenerateSlugRequest struct {
	Title string `json:"title"`
}

type GenerateSlugResponse struct {
	Data *GenerateSlugData `json:"data"`
	Meta *ResponseMeta     `json:"meta"`
}

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

type NotificationRef struct {
	ID        int                         `json:"id"`
	Type      repository.NotificationType `json:"type"`
	Message   string                      `json:"message"`
	CreatedAt time.Time                   `json:"createdAt"`
}

type NotificationsResponse struct {
	Notifications []NotificationRef `json:"notifications"`
}

type PostTypeLister interface {
	GetAll() []posttype.PostType
}

type PublicArchiveMonthResponse struct {
	Year  int    `json:"year"`
	Month int    `json:"month"`
	Count int    `json:"count"`
	URL   string `json:"url"`
}

type PublicAuthorResponse struct {
	Username     string         `json:"username"`
	DisplayName  string         `json:"displayName"`
	AvatarURL    string         `json:"avatarURL"`
	ProfileURL   string         `json:"profileURL"`
	ContentCount int            `json:"contentCount"`
	PostTypes    []string       `json:"postTypes"`
	PublicFields map[string]any `json:"publicFields,omitempty"`
}

type PublicFieldLookup interface {
	IsQueryable(resource, postType, field, operation string) bool
	ExposedFields(resource, postType string) []string
}

type ResponseMeta struct {
	Count     int    `json:"count"`
	Timestamp string `json:"timestamp"`
}

type RevokeAPIKeyResponse struct {
	ID        int        `json:"id"`
	RevokedAt *time.Time `json:"revokedAt"`
}

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

type SearchResult struct {
	Slug            string `json:"slug"`
	Title           string `json:"title"`
	MetaDescription string `json:"metaDescription"`
}