pages

type Attr map[string]string

type BeforeSaveFunc func(context.Context, *Page) error

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

type DOM struct {
	HTML struct {
		Attr Attr `envPrefix:"ATTR_" json:"attr,omitempty" yaml:"attr,omitempty"`
	} `envPrefix:"HTML_" json:"html,omitempty" yaml:"html,omitempty"`

	Head Head `envPrefix:"HEAD_" json:"head,omitempty" yaml:"head,omitempty"`

	Body struct {
		Attr Attr `envPrefix:"ATTR_" json:"attr,omitempty" yaml:"attr,omitempty"`
	} `envPrefix:"BODY_" json:"body,omitempty" yaml:"body,omitempty"`
}

type Decision int8

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

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

type ErrorHandlerConfig struct {
	// FallbackTemplate is a template name for fallback error page.
	// The fallback template is used when the error page is not found
	// by pattern, also the Site and Page variables could not be provided.
	FallbackTemplate string

	// StatusFunc returns an error code code.
	StatusFunc middleware.ErrorStatusFunc

	// JSONHandler is a handler for JSON error responses.
	JSONHandler http.Handler

	// Logger is used for logging.
	Logger *slog.Logger
}

type ErrorPatternFunc func(r *http.Request, status int, err error) string

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

type HTTPSiteRetrieverConfig struct {
	// CountryFunc determines the country based on the provided
	// HTTP request and returns it as a string along with any error.
	CountryFunc func(*http.Request) (string, error)

	// ErrorFunc handles errors by taking an HTTP request and an error,
	// returning a Site instance or an error.
	ErrorFunc func(*http.Request, error) (*Site, error)
}

type Head struct {
	Attr  Attr  `envPrefix:"ATTR_" json:"attr,omitempty" yaml:"attr,omitempty"`
	Nodes Nodes `envPrefix:"NODE_" json:"nodes,omitempty" yaml:"nodes,omitempty"`
}

type HeadLink struct {
	// CrossOrigin Specifies how the element handles cross-origin requests
	CrossOrigin string
	// Href Specifies the location of the linked document
	Href string
	// HrefLang Specifies the language of the text in the linked document
	HrefLang string
	// Media Specifies on what device the linked document will be displayed
	Media string
	// Rel REQUIRED Specifies the relationship between the current document and the linked document
	Rel string
	// Sizes Specifies the size of the linked resource. Only for rel="icon"
	Sizes string
	// Title Defines a preferred or an alternate stylesheet
	Title string
	// Type Specifies the media type of the linked document
	Type string
}

type ID string

type IDGeneratorFunc func(ctx context.Context) (ID, error)

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

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

type Meta map[string]any

type Node struct {
	Tag  string `env:"TAG" json:"tag,omitempty" yaml:"tag,omitempty"`
	Text string `env:"TEXT" json:"text,omitempty" yaml:"text,omitempty"`
	Attr Attr   `env:"ATTR" json:"attr,omitempty" yaml:"attr,omitempty"`
}

type Nodes []Node

type Page struct {
	ID ID `json:"id,omitempty" yaml:"id,omitempty"`

	SiteID ID    `json:"siteID,omitempty" yaml:"siteID,omitempty"`
	Site   *Site `json:"site,omitempty" yaml:"site,omitempty"`

	ParentID *ID     `json:"parentID,omitempty" yaml:"parentID,omitempty"`
	Parent   *Page   `json:"parent,omitempty" yaml:"parent,omitempty"`
	Children []*Page `json:"children,omitempty" yaml:"children,omitempty"`

	Created time.Time `json:"created,omitzero" yaml:"created,omitempty"`
	Updated time.Time `json:"updated,omitzero" yaml:"updated,omitempty"`

	Status     Status     `json:"status,omitempty" yaml:"status,omitempty"`
	Visibility Visibility `json:"visibility,omitempty" yaml:"visibility,omitempty"`

	Meta   Meta                `json:"meta,omitempty" yaml:"meta,omitempty"`
	DOM    DOM                 `json:"dom,omitempty" yaml:"dom,omitempty"`
	Header map[string][]string `json:"header,omitempty" yaml:"header,omitempty"`

	Name      string `json:"name,omitempty" yaml:"name,omitempty"`
	Title     string `json:"title,omitempty" yaml:"title,omitempty"`
	Pattern   string `json:"pattern,omitempty" yaml:"pattern,omitempty"`
	Alias     string `json:"alias,omitempty" yaml:"alias,omitempty"`
	Slug      string `json:"slug,omitempty" yaml:"slug,omitempty"`
	URL       string `json:"url,omitempty" yaml:"url,omitempty"`
	CustomURL string `json:"customURL,omitempty" yaml:"customURL,omitempty"`
	Template  string `json:"template,omitempty" yaml:"template,omitempty"`
	Position  int    `json:"position,omitempty" yaml:"position,omitempty"`
	Decorate  bool   `json:"decorate,omitempty" yaml:"decorate,omitempty"`
}

type PageAction int8

type PageAuthorizer interface {
	Authorize(ctx context.Context, action PageAction) Decision
}

type PageConfig struct {
	ParentID   *ID                 `json:"parentID,omitempty" yaml:"parentID,omitempty"`
	Template   *string             `json:"template,omitempty" yaml:"template,omitempty"`
	Position   *int                `json:"position,omitempty" yaml:"position,omitempty"`
	Decorate   *bool               `json:"decorate,omitempty" yaml:"decorate,omitempty"`
	Status     *Status             `json:"status,omitempty" yaml:"status,omitempty"`
	Visibility *Visibility         `json:"visibility,omitempty" yaml:"visibility,omitempty"`
	DOM        *DOM                `json:"dom,omitempty" yaml:"dom,omitempty"`
	Meta       Meta                `json:"meta,omitempty" yaml:"meta,omitempty"`
	Header     map[string][]string `json:"header,omitempty" yaml:"header,omitempty"`
}

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

type PageCreateHandlerConfig struct {
	GeneratorFunc  IDGeneratorFunc
	BeforeSaveFunc BeforeSaveFunc
}

type PageCreateRequest struct {
	URL      string `json:"url,omitempty" form:"url,omitempty"`
	Template string `json:"template,omitempty" form:"template,omitempty"`
	Title    string `json:"title,omitempty" form:"title,omitempty"`
}

type PageDecoratorStrategy interface {
	IsPatternDecorable(ctx context.Context, pattern string) bool
	IsURIDecorable(ctx context.Context, uri string) bool
}

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

type PageHandlerConfig struct {
	// VarsFunc defines a function that generates
	// template variables from an HTTP request and context.
	VarsFunc TemplateVarsFunc

	// Logger is used for logging.
	Logger *slog.Logger
}

type PageManager interface {
	GetByID(ctx context.Context, id ID) (*Page, error)
	GetByURL(ctx context.Context, site *Site, url string) (*Page, error)
	GetByPattern(ctx context.Context, site *Site, pattern string) (*Page, error)
	GetByAlias(ctx context.Context, site *Site, alias string) (*Page, error)
}

type PageStore interface {
	FindByID(ctx context.Context, id ID) (*Page, error)
	FindByURL(ctx context.Context, siteID ID, url string) (*Page, error)
	FindByPattern(ctx context.Context, siteID ID, pattern string) (*Page, error)
	FindByPatterns(ctx context.Context, siteID ID, patterns ...string) iter.Seq2[*Page, error]
	FindByAlias(ctx context.Context, siteID ID, alias string) (*Page, error)
	Save(ctx context.Context, pages ...*Page) error
}

type PageSyncer interface {
	Sync(ctx context.Context, site *Site) error
}

type PageSyncerConfig struct {
	DefaultPage     *PageConfig            `json:"defaultPage,omitempty" yaml:"defaultPage,omitempty"`
	DefaultPatterns map[string]*PageConfig `json:"defaultPatterns,omitempty" yaml:"defaultPatterns,omitempty"`
}

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

type PatternArgsFunc func(*http.Request) []any

type Patterns interface {
	Patterns() iter.Seq[string]
}

type Site struct {
	ID ID `json:"id,omitempty" yaml:"id,omitempty"`

	Created time.Time `json:"created,omitzero" yaml:"created,omitempty"`
	Updated time.Time `json:"updated,omitzero" yaml:"updated,omitempty"`

	Status Status `json:"status,omitempty" yaml:"status,omitempty"`

	Meta Meta `json:"meta,omitempty" yaml:"meta,omitempty"`
	DOM  DOM  `json:"dom,omitempty" yaml:"dom,omitempty"`

	Name      string   `json:"name,omitempty" yaml:"name,omitempty"`
	Title     string   `json:"title,omitempty" yaml:"title,omitempty"`
	Separator string   `json:"separator,omitempty" yaml:"separator,omitempty"`
	Locale    string   `json:"locale,omitempty" yaml:"locale,omitempty"`
	Timezone  string   `json:"timezone,omitempty" yaml:"timezone,omitempty"`
	Countries []string `json:"countries,omitempty" yaml:"countries,omitempty"`

	Scheme       string `json:"scheme,omitempty" yaml:"scheme,omitempty"`
	Host         string `json:"host,omitempty" yaml:"host,omitempty"`
	RelativePath string `json:"relativePath,omitempty" yaml:"relativePath,omitempty"`
	IsDefault    bool   `json:"isDefault,omitempty" yaml:"isDefault,omitempty"`

	IsRoot bool `json:"-" yaml:"-"`
	// contains filtered or unexported fields
}

type SiteRetriever interface {
	Retrieve(r *http.Request) (*Site, string, error)
}

type SiteStore interface {
	FindPublished(ctx context.Context) iter.Seq2[*Site, error]
}

type Status int8

type TemplateVars struct {
	*Context
	Request *http.Request
	Ctx     context.Context
}

type TemplateVarsFunc func(*http.Request, *Context) any

type Theme interface {
	Render(ctx context.Context, template string, data any) ([]byte, error)
}

type URLGenerator interface {
	Generate(ctx context.Context, site *Site, arg any, args ...any) (string, error)
}

type Visibility int8