appdef

type App struct {
	Name             string                                  `json:"name" validate:"required,lowercase,alphanumdash" description:"Unique identifier for the app (lowercase, hyphenated)"`
	Title            string                                  `json:"title" validate:"required" description:"Human-readable app name for display purposes"`
	Type             AppType                                 `json:"type" validate:"required,oneof=svelte-kit golang payload" description:"Application type (payload, svelte-kit, golang)"`
	Description      string                                  `` /* 128-byte string literal not displayed */
	Path             string                                  `json:"path" validate:"required" description:"Relative file path to the app's source code directory"`
	Build            Build                                   `json:"build" description:"Build configuration for Docker containerisation"`
	Infra            Infra                                   `json:"infra" validate:"required" description:"Infrastructure and deployment configuration"`
	Env              Environment                             `json:"env" description:"Environment variables specific to this app"`
	Monitoring       bool                                    `json:"monitoring,omitempty" description:"Whether to enable uptime monitoring for this app (defaults to true)"`
	UsesNPM          *bool                                   `json:"usesNPM" description:"Whether this app should be included in the pnpm workspace (auto-detected if not set)"`
	TerraformManaged *bool                                   `json:"terraformManaged,omitempty" description:"Whether this app's infrastructure is managed by Terraform (defaults to true)"`
	Domains          []Domain                                `json:"domains,omitzero" description:"Domain configurations for accessing this app"`
	Tools            map[string]Tool                         `json:"tools,omitempty" inline:"true" description:"Build tools required for CI/CD workflows"`
	Commands         *types.OrderedMap[Command, CommandSpec] `` /* 161-byte string literal not displayed */
}

type AppType string

type Brand struct {
	PrimaryColour   string `json:"primaryColour,omitempty" validate:"omitempty,hexcolor" description:"Primary brand colour in hex format (e.g., #3B82F6)"`
	SecondaryColour string `` /* 129-byte string literal not displayed */
	LogoURL         string `json:"logoUrl,omitempty" validate:"omitempty,url" description:"URL to the project's logo image"`
	IconURL         string `` /* 127-byte string literal not displayed */
}

type Build struct {
	Dockerfile string `json:"dockerfile" description:"Path to the Dockerfile relative to the app directory"`
	Port       int    `json:"port,omitempty" validate:"omitempty,min=1,max=65535" description:"Port number the app listens on inside the container"`
	Release    *bool  `json:"release,omitempty" description:"Whether to build and release this app in CI/CD (defaults to true)"`
}

type Command string

type CommandSpec struct {
	Name     string `json:"-"`
	Cmd      string `json:"command,omitempty" description:"The shell command to execute (e.g., 'pnpm build')"`
	SkipCI   bool   `json:"skip_ci,omitempty" description:"Whether to skip running this command in CI/CD pipelines"`
	Timeout  string `json:"timeout,omitempty" description:"Maximum execution time for the command (e.g., '5m', '1h')"`
	Disabled bool   `json:"-"` // Set during unmarshal
}

type Config map[string]any

type Contact struct {
	Email       string
	Phone       string
	Coordinates struct{ Latitude, Longitude string }
	Address     schemaorg.Address
}

type Definition struct {
	Schema        string     `json:"$schema,omitempty" jsonschema:"-" description:"JSON Schema reference for IDE validation and autocomplete"`
	WebkitVersion string     `` /* 129-byte string literal not displayed */
	Project       Project    `` /* 131-byte string literal not displayed */
	Monitoring    Monitoring `json:"monitoring,omitempty" description:"Monitoring configuration including status page and custom monitors"`
	Shared        Shared     `json:"shared" description:"Shared configuration that applies to all apps"`
	Resources     []Resource `json:"resources" description:"Infrastructure resources such as databases and storage buckets"`
	Apps          []App      `` /* 137-byte string literal not displayed */
}

type Domain struct {
	Name     string     `json:"name" validate:"required" description:"Domain name without protocol (e.g., 'example.com' or 'api.example.com')"`
	Type     DomainType `json:"type" validate:"omitempty,oneof=primary alias unmanaged" description:"Domain type (primary, alias, unmanaged)"`
	Zone     string     `json:"zone,omitempty" description:"DNS zone for the domain if different from default"`
	Wildcard bool       `json:"wildcard,omitempty" description:"Whether this is a wildcard domain (e.g., '*.example.com')"`
}

type DomainType string

type EnvSource string

type EnvValue struct {
	Source EnvSource `` /* 148-byte string literal not displayed */
	// Value holds the actual value or reference depending on the source type:
	// - "value": A static string (e.g., "https://api.example.com")
	// - "resource": A Terraform resource reference (e.g., "db.connection_url")
	// - "sops": The variable name/key to lookup in the SOPS file (e.g., "API_KEY")
	Value any `json:"value,omitempty" description:"The value or reference for this variable (format depends on source type)"`
}

type EnvVar map[string]EnvValue

type EnvWalkEntry struct {
	Environment env.Environment
	Key         string
	Value       any
	Source      EnvSource
	Map         EnvVar
}

type Environment struct {
	Default    EnvVar `` /* 132-byte string literal not displayed */
	Dev        EnvVar `json:"dev,omitempty" inline:"true" description:"Environment variables specific to the development environment"`
	Staging    EnvVar `json:"staging,omitempty" inline:"true" description:"Environment variables specific to the staging environment"`
	Production EnvVar `json:"production,omitempty" inline:"true" description:"Environment variables specific to the production environment"`
}

type EnvironmentWalker func(entry EnvWalkEntry)

type EnvironmentWalkerE func(entry EnvWalkEntry) error

type GitHubRepo struct {
	Owner string `json:"owner" validate:"required" description:"GitHub username or organisation that owns the repository"`
	Name  string `json:"name" validate:"required" description:"Repository name on GitHub"`
}

type Infra struct {
	Provider ResourceProvider `json:"provider" validate:"required" description:"Cloud infrastructure provider (digitalocean, backblaze)"`
	Type     string           `json:"type" validate:"required" description:"Infrastructure type (vm, app, container, function)"`
	Config   Config           `json:"config" description:"Provider-specific infrastructure configuration options"`
}

type MenuItem struct {
	Identifier string
	Name       string
	URL        string
	Weight     string
	Children   []MenuItem
	Params     map[string]any
}

type Monitor struct {
	Name       string      `json:"name" validate:"required" description:"Unique monitor name"`
	Type       MonitorType `` /* 142-byte string literal not displayed */
	Interval   int         `json:"interval,omitempty" description:"Interval in seconds between checks (defaults based on monitor type if not specified)"`
	Identifier string      `` /* 147-byte string literal not displayed */
	Config     Config      `json:"config,omitempty" description:"Type-specific monitor configuration (e.g., url, method, keyword, domain)"`
}

type MonitorType string

type Monitoring struct {
	Enabled    *bool      `json:"enabled,omitempty" description:"Enable or disable all monitoring globally (defaults to true)"`
	StatusPage StatusPage `json:"statusPage,omitempty" description:"Public status page configuration"`
	Custom     []Monitor  `json:"custom,omitempty" description:"Custom monitors beyond auto-generated ones"`
}

type Project struct {
	Name        string     `` /* 126-byte string literal not displayed */
	Title       string     `json:"title" validate:"required" description:"Human-readable project name displayed in documentation and UIs"`
	Description string     `json:"description" validate:"required,max=200" description:"Brief description of the project's purpose and functionality"`
	Repo        GitHubRepo `json:"repo" validate:"required" description:"GitHub repository information for the project"`
	Brand       Brand      `json:"brand,omitempty" description:"Branding configuration for the project including colours and logo"`
}

type Resource struct {
	Name             string               `` /* 161-byte string literal not displayed */
	Title            string               `json:"title" required:"true" validate:"required" description:"Human-readable resource name for display purposes"`
	Type             ResourceType         `` /* 139-byte string literal not displayed */
	Description      string               `` /* 133-byte string literal not displayed */
	Provider         ResourceProvider     `` /* 187-byte string literal not displayed */
	Config           Config               `json:"config" description:"Provider-specific resource configuration (e.g., size, region, version)"`
	Backup           ResourceBackupConfig `json:"backup,omitempty" description:"Backup configuration for the resource"`
	Monitoring       bool                 `json:"monitoring,omitempty" description:"Whether to enable uptime monitoring for this resource (defaults to true)"`
	TerraformManaged *bool                `json:"terraformManaged,omitempty" description:"Whether this resource is managed by Terraform (defaults to true)"`
}

type ResourceBackupConfig struct {
	Enabled bool `json:"enabled" description:"Whether to enable automated backups for this resource"`
}

type ResourceOutput struct {
	Name        string
	Description string
}

type ResourceProvider string

type ResourceType string

type Shared struct {
	Env Environment `json:"env" description:"Environment variables shared across all apps"`
}

type SkippedItems struct {
	Apps      []string
	Resources []string
}

type Social struct {
	Twitter   string
	LinkedIn  string
	GitHub    string
	YouTube   string
	Facebook  string
	Instagram string
	TikTok    string
	Dribbble  string
}

type StatusPage struct {
	Domain string `` /* 183-byte string literal not displayed */
	Slug   string `` /* 194-byte string literal not displayed */
	Theme  string `` /* 144-byte string literal not displayed */
}

type Tool struct {
	Type    string `json:"type" inline:"true" description:"Installation method: 'go', 'pnpm', or 'script'"`
	Name    string `json:"name,omitempty" inline:"true" description:"Package path (for 'go') or package name (for 'pnpm')"`
	Version string `json:"version,omitempty" inline:"true" description:"Version to install (e.g., 'latest', 'v0.2.543')"`
	Install string `json:"install,omitempty" inline:"true" description:"Custom installation command (overrides auto-generated command)"`
}