client

type AdminPageData ¶ added in v0.7.0

type AdminPageData struct {
	Title      string
	Theme      string
	Owner      string
	Sections   []AdminSection
	KindLabels map[int]string
}

AdminPageData is what admin.html renders against.

type AdminSection ¶ added in v0.7.0

type AdminSection struct {
	ID     string
	Title  string
	Icon   string
	Method string // grain_* write method this section targets (empty for ops)
	Config any
}

AdminSection is one panel in the accordion. Config is the typed config blob (or nil for ops) — the template renders it inside the stub <pre> in Phase 1, and Phase 2+ commits read individual fields off the typed struct as they replace each stub with a real form.

type BlacklistSectionData ¶ added in v0.7.0

type BlacklistSectionData struct {
	Config                cfgType.BlacklistConfig
	UnifiedPubkeys        []UnifiedPubkey
	BrokenPubkeys         []string // bad entries from blacklist.yml's pubkeys/npubs
	MutelistAuthors       []UnifiedPubkey
	BrokenMutelistAuthors []string

	// Owner's private mute list sync status (#60). Rendered so the owner
	// knows when they last synced and how many pubkeys it contributed.
	// Zero values mean "never synced".
	OwnerMutelistCount  int
	OwnerMutelistSynced int64 // unix seconds; 0 = never

	// The owner's synced private-mute pubkeys, for in-panel display with
	// profiles. Owner-only page, so showing the actual keys is fine here
	// (the public endpoint stays count-only).
	OwnerMutelistPubkeys []UnifiedPubkey
}

BlacklistSectionData wraps BlacklistConfig with the same unified pubkey treatment the whitelist gets: hex + npub merge into one display list, mutelist authors render with profile previews. IP scalars ride through the bulk save now that UpdateBlacklistConfig writes them to config.yml. The IP LIST is edited live (per-row blockip/unblockip) rather than via the section Save, so it has no snapshot-replay path.

type ClientInitError ¶

type ClientInitError struct {
	Message string
}

ClientInitError represents initialization errors

func (e *ClientInitError) Error() string

type EventPurgeSectionData ¶ added in v0.7.0

type EventPurgeSectionData struct {
	Config      cfgType.EventPurgeConfig
	Categories  []string
	CommonKinds []QuickKind
	// KindLabels duplicated here from the page-level data because
	// Go templates lose access to the outer dot once a sub-template
	// is invoked. Cheap to pass — it's a single map reference.
	KindLabels map[int]string
}

EventPurgeSectionData is the per-section template data for the event_purge form. The form renders one checkbox per known purge category (the v0.4-compat names from server/db/nostrdb/purge.go:purgeCategoryForKind); rather than teach the template to construct a literal slice, we hand it the list directly. CommonKinds drives the quick-add chip row above the kinds_to_purge textarea.

type KindRatePreset ¶ added in v0.7.0

type KindRatePreset struct {
	Kind  int
	Limit float64
	Burst int
}

KindRatePreset is one suggested kind→{limit, burst} on the per-kind rate quick-add row.

type KindSizePreset ¶ added in v0.7.0

type KindSizePreset struct {
	Kind  int
	Bytes int
}

KindSizePreset is one suggested kind→max_size pairing on the per-kind size limits quick-add row. Sizes here are operator- friendly defaults — operators can edit before clicking Add.

type LoggingSectionData ¶ added in v0.7.0

type LoggingSectionData struct {
	Config        cfgType.LogConfig
	AllComponents []string
}

LoggingSectionData is the per-section template data for the logging form. We can't render the suppress-components UI from just LogConfig — the form needs the full set of known component names (so an operator gets checkboxes instead of typing names they have to guess), and that catalog lives in server/utils/log/components.go. Bundling the two here keeps the template clean and the catalog discoverable.

type OpsSectionData ¶ added in v0.7.0

type OpsSectionData struct {
	RelayName           string
	RelayDescription    string
	RelayIcon           string
	RelayBanner         string
	RelayContact        string
	RelayPrivacyPolicy  string
	RelayTermsOfService string
	RelayPostingPolicy  string
}

OpsSectionData is the per-section template data for ops. The dashboard renders the current relay identity (name/description/ icon/banner/contact + policy URLs) so an operator can edit them in place, plus a stats area fetched live via grain_stats_overview. Cache refresh and config reload run via separate buttons.

type PWAIcon ¶

type PWAIcon struct {
	Src     string `json:"src"`
	Sizes   string `json:"sizes"`
	Type    string `json:"type"`
	Purpose string `json:"purpose,omitempty"`
}

PWAIcon represents an icon in the manifest

type PWAManifest ¶

type PWAManifest struct {
	Name            string          `json:"name"`
	ShortName       string          `json:"short_name"`
	Description     string          `json:"description"`
	StartURL        string          `json:"start_url"`
	Display         string          `json:"display"`
	BackgroundColor string          `json:"background_color"`
	ThemeColor      string          `json:"theme_color"`
	Orientation     string          `json:"orientation"`
	Scope           string          `json:"scope"`
	Lang            string          `json:"lang"`
	Categories      []string        `json:"categories"`
	Screenshots     []PWAScreenshot `json:"screenshots,omitempty"`
	Icons           []PWAIcon       `json:"icons"`
}

PWAManifest represents the web app manifest structure

type PWAScreenshot ¶

type PWAScreenshot struct {
	Src        string `json:"src"`
	Sizes      string `json:"sizes"`
	Type       string `json:"type"`
	FormFactor string `json:"form_factor,omitempty"`
	Label      string `json:"label,omitempty"`
}

PWAScreenshot represents a screenshot in the manifest

type PageData ¶

type PageData struct {
	Title string
	Theme string
}

type QuickKind ¶ added in v0.7.0

type QuickKind struct {
	Kind  int
	Label string
}

QuickKind is one entry in the kinds_to_purge quick-add chip row.

type RateLimitSectionData ¶ added in v0.7.0

type RateLimitSectionData struct {
	Config              cfgType.RateLimitConfig
	RateLimitCategories []string
	CategoryDefaults    map[string]map[string]float64 // category → {limit, burst}
	KindSizePresets     []KindSizePreset
	KindRatePresets     []KindRatePreset
}

RateLimitSectionData is the per-section template data for the rate_limit form. Carries the typed config plus reference catalogs the form needs (category list for deterministic order, suggested per-kind size and rate presets for the quick-add chip rows).

type SetupPageData ¶ added in v0.7.0

type SetupPageData struct {
	Title     string
	OwnerHex  string
	OwnerNpub string
}

SetupPageData feeds setup.html (claim form) and setup-claimed.html (already-owned info panel). OwnerNpub is empty in the unowned state; populated with the bech32 form when rendering the claimed panel so the operator can eyeball whether the claimant is them.

type UnifiedPubkey ¶ added in v0.7.0

type UnifiedPubkey struct {
	Hex  string
	Npub string
}

UnifiedPubkey is one row of the merged hex+npub display. Both forms are precomputed server-side so the page doesn't have to fan out N convert-API calls on first render.

type WhitelistSectionData ¶ added in v0.7.0

type WhitelistSectionData struct {
	Config         cfgType.WhitelistConfig
	UnifiedPubkeys []UnifiedPubkey
	BrokenPubkeys  []string // raw entries from the YAML that didn't parse
	KindLabels     map[int]string
	KindPresets    []QuickKind
}

WhitelistSectionData wraps WhitelistConfig with a unified pubkey view + the kind catalog needed by the form. The dashboard renders one row per UnifiedPubkey showing both hex and npub regardless of which form the operator originally entered; the wire shape (Pubkeys vs Npubs) is collapsed on save into Pubkeys-only by the JS submit path.