internal

type AdminAPI ¶

type AdminAPI struct {
	ReloadFunc  func() error
	PreviewBase string
	Audit       *audit.Logger
	AuditActor  func(*http.Request) string
	// contains filtered or unexported fields
}

AdminAPI is the HTTP surface for the multisite admin.

Per SPEC §I/T16: tenant CRUD, domain CRUD, page CRUD. Routes are mounted by the host at /api/v1/admin/* (see gocodealone-multisite app.yaml). The host wraps every endpoint with auth + authz middleware; this layer assumes the request is already authenticated.

Tenant scope for page endpoints comes from the URL path (/api/v1/admin/tenants/:id/pages...) — V12 isolation is enforced by passing tenantID as the first arg after ctx into every store call.

ReloadFunc is optional; when set, POST /api/v1/admin/reload invokes it to flush in-memory caches (tenant resolver, page renderer). See SPEC T31.

PreviewBase is the FQDN suffix for auto-provisioned preview subdomains. When non-empty, CreateTenant also creates a `<slug>.<preview_base>` domain row (V18 / T32). Empty disables auto-provision.

func NewAdminAPI(tenants store.TenantAdminStore, pages store.PageStore) *AdminAPI

func (a *AdminAPI) ServeHTTP(w http.ResponseWriter, r *http.Request)

type AdminContribution ¶ added in v0.1.2

type AdminContribution struct {
	ID          string
	Title       string
	Category    string
	Path        string
	RenderMode  string
	AppContext  string
	Permissions []string
	Metadata    map[string]string
	Actions     []string
}

AdminContribution describes a CMS admin surface in the shape expected by workflow-plugin-admin, without depending on that plugin's generated types.

func CMSAdminContribution() AdminContribution

type CMSPlugin ¶

type CMSPlugin struct{}

CMSPlugin implements sdk.PluginProvider.

func (p *CMSPlugin) ContractRegistry() *pb.ContractRegistry

func (p *CMSPlugin) CreateModule(typeName, name string, config map[string]any) (sdk.ModuleInstance, error)

func (p *CMSPlugin) CreateStep(typeName, name string, config map[string]any) (sdk.StepInstance, error)

func (p *CMSPlugin) Manifest() sdk.PluginManifest

func (p *CMSPlugin) ModuleTypes() []string

func (p *CMSPlugin) StepTypes() []string

type MediaPolicy ¶ added in v0.1.2

type MediaPolicy struct {
	AllowedObjectPrefixes []string `json:"allowed_object_prefixes"`
}

type NavStatus ¶ added in v0.1.2

type NavStatus string

const (
	NavStatusDraft     NavStatus = "draft"
	NavStatusPublished NavStatus = "published"
	NavStatusScheduled NavStatus = "scheduled"
	NavStatusArchived  NavStatus = "archived"
)

type NavTargetKind ¶ added in v0.1.2

type NavTargetKind string

const (
	NavTargetStatic   NavTargetKind = "static"
	NavTargetCMSPage  NavTargetKind = "cms_page"
	NavTargetOverlay  NavTargetKind = "overlay"
	NavTargetExternal NavTargetKind = "external"
)

type NavigationItem ¶ added in v0.1.2

type NavigationItem struct {
	Label     string        `json:"label"`
	Kind      NavTargetKind `json:"kind"`
	Target    string        `json:"target"`
	Status    NavStatus     `json:"status"`
	PublishAt *time.Time    `json:"publish_at"`
}

func PublishedNavigation(items []NavigationItem, now time.Time) ([]NavigationItem, error)

type OverlayMode ¶ added in v0.1.2

type OverlayMode string

const (
	OverlayModeReplace OverlayMode = "replace"
	OverlayModeAppend  OverlayMode = "append"
	OverlayModePrepend OverlayMode = "prepend"
	OverlayModeRemove  OverlayMode = "remove"
)

type OverlayPublishResult ¶ added in v0.1.2

type OverlayPublishResult struct {
	Published      bool
	ConflictReason string
	SourceHash     string
}

func PublishOverlay(overlay *StaticPageOverlay, currentSourceHash string, force bool) (OverlayPublishResult, error)

type OverlaySelector ¶ added in v0.1.2

type OverlaySelector struct {
	Selector string      `json:"selector"`
	Mode     OverlayMode `json:"mode"`
}

type OverlayStatus ¶ added in v0.1.2

type OverlayStatus string

const (
	OverlayStatusDraft          OverlayStatus = "draft"
	OverlayStatusPublished      OverlayStatus = "published"
	OverlayStatusConflictReview OverlayStatus = "conflict_review"
	OverlayStatusDisabled       OverlayStatus = "disabled"
)

type PageTemplate ¶ added in v0.1.2

type PageTemplate struct {
	ID   string
	HTML string
}

PageTemplate is the shell used to wrap a CMS page body.

type StaticPageOverlay ¶ added in v0.1.2

type StaticPageOverlay struct {
	TenantID    int64
	SourcePath  string
	SourceHash  string
	Selectors   []OverlaySelector
	DraftBlocks json.RawMessage
	Status      OverlayStatus
	Enabled     bool
}

func NewStaticPageOverlay(input StaticPageOverlayInput) (*StaticPageOverlay, error)

type StaticPageOverlayInput ¶ added in v0.1.2

type StaticPageOverlayInput struct {
	TenantID    int64             `json:"tenant_id"`
	SourcePath  string            `json:"source_path"`
	SourceHash  string            `json:"source_hash"`
	Selectors   []OverlaySelector `json:"selectors"`
	DraftBlocks json.RawMessage   `json:"draft_blocks"`
}

type TenantInfo ¶

type TenantInfo struct {
	TenantID     int64
	TenantSlug   string
	SubsiteLabel string // empty if no subsite scope
	Kind         string // "vanity" | "preview" | "subdomain"
}

TenantInfo is the resolved tenant + optional subsite for a request.

func TenantFromContext(ctx context.Context) (TenantInfo, bool)

type TenantStore ¶

type TenantStore interface {
	// Lookup returns the tenant for an exact domain match. ok=false on miss.
	Lookup(ctx context.Context, host string) (TenantInfo, bool)
	// LookupBySlug resolves a preview subdomain pattern (<slug>.<base>).
	LookupBySlug(ctx context.Context, slug string) (TenantInfo, bool)
}

TenantStore looks up tenants by domain. Host wires the production postgres-backed implementation at boot.

type WidgetInstance ¶ added in v0.1.2

type WidgetInstance struct {
	ID   string `json:"id"`
	Type string `json:"type"`
}

type WidgetRegistry ¶ added in v0.1.2

type WidgetRegistry struct {
	Types map[string]WidgetType `json:"types"`
}

type WidgetType ¶ added in v0.1.2

type WidgetType struct {
	Type   string `json:"type"`
	Markup string `json:"markup"`
}