models

type APIToken struct {
	ID          string      `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	Name        string      `gorm:"not null" json:"name"`
	UserID      string      `gorm:"not null" json:"userId"`
	TokenHash   string      `gorm:"not null" json:"-"`
	TokenPrefix string      `gorm:"not null" json:"tokenPrefix"`
	Scopes      StringSlice `gorm:"type:jsonb;not null" json:"scopes"`
	ResourceIDs StringSlice `gorm:"type:jsonb" json:"resourceIds,omitempty"`
	OrgID       string      `gorm:"not null" json:"orgId"`
	ExpiresAt   *time.Time  `json:"expiresAt,omitempty"`
	LastUsedAt  *time.Time  `json:"lastUsedAt,omitempty"`
	CreatedAt   time.Time   `gorm:"not null" json:"createdAt"`
	RevokedAt   *time.Time  `json:"revokedAt,omitempty"`
}

type Addon interface {
	Type() string
	AddonName() string
}

type Annotation struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type Annotations []Annotation

type AzureCredentials struct {
	ConnectionString   SecretReference `json:"connectionString"`
	StorageAccountName string          `json:"storageAccountName"`
}

type BuildArtifactSource struct {
	ResourceName    string `json:"resource_name"`
	SourcePath      string `json:"source_path"`
	DestinationPath string `json:"destination_path"`
}

type BuildArtifactSources []BuildArtifactSource

type BuildArtifactSyncInfo struct {
	ResourceName string `json:"resource_name"`
	BuildID      string `json:"build_id"`
	Status       string `json:"status"`
}

type BuildConfigSpec struct {
	SourceContext           BuildContextSource   `json:"source_context"`
	ContextPathWithinSource string               `json:"context_path_within_source"`
	DockerfilePath          string               `json:"dockerfile_path"`
	SourceRevision          BuildSourceRevision  `json:"source_revision"`
	BuildImageRepository    BuildImageRepository `json:"build_image_repository"`
	// PushRegistryCredentialID pins an org-level registry credential for the
	// push target, overriding host auto-attach.
	PushRegistryCredentialID string `json:"push_registry_credential_id,omitempty"`
}

type BuildContextSource struct {
	Volume *VolumeBuildSource `json:"volume"`
	Git    *GitBuildSource    `json:"git"`
}

type BuildFailureDetail struct {
	FailureType  string `json:"failure_type"`
	Reason       string `json:"reason,omitempty"`
	Message      string `json:"message,omitempty"`
	RestartCount int32  `json:"restart_count"`
	ExitCode     *int32 `json:"exit_code,omitempty"`
}

type BuildImageRepository struct {
	InsecureRegistry     bool   `json:"insecure_registry"`
	UseInClusterRegistry bool   `json:"use_in_cluster_registry"`
	ClusterRegistryName  string `json:"cluster_registry_name,omitempty"`
	ExternalImageRef     string `json:"external_image_ref,omitempty"`
}

type BuildSourceRevision struct {
	Volume *VolumeRevision `json:"volume"`
	Git    *GitRevision    `json:"git"`
}

type Cluster struct {
	ID                     string `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID         string `gorm:"not null"`
	Name                   string `gorm:"not null;check:name <> ''"`
	CreatedAt              time.Time
	UpdatedAt              time.Time
	DeletionTimestamp      *time.Time `json:"deletion_timestamp,omitempty"`
	SharedCompute          bool
	ClusterURL             string `gorm:"not null;check:cluster_url <> '';uniqueIndex:idx_clusters_cluster_url_unique"`
	EncryptedClusterCAData string `gorm:"not null"`
	EncryptedToken         string `gorm:"not null"`
	ManagerRunning         bool
	ClusterInfo            *ClusterInfo            `gorm:"type:jsonb"`
	ImageRegistries        []*ClusterImageRegistry `gorm:"foreignKey:ClusterID"`

	// Transient fields — populated by service layer after decryption, never persisted
	ClusterCAData string `gorm:"-"`
	Token         string `gorm:"-"`
}

type ClusterImageRegistry struct {
	ID                  string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	ClusterID           string `gorm:"not null;index:idx_cluster_image_registry_cluster_id" json:"cluster_id"`
	OrganisationID      string `gorm:"not null;index:idx_cluster_image_registry_organisation_id" json:"organisation_id"`
	Name                string `gorm:"not null;check:name <> ''" json:"name"`
	BackendStorageSize  string `gorm:"not null;check:backend_storage_size <> ''" json:"backend_storage_size"`
	BackendStorageClass string
	Status              *ClusterImageRegistryStatus `gorm:"type:jsonb" json:"status"`
}

type ClusterImageRegistryOperand struct{ ClusterID string }

type ClusterImageRegistryStatus struct {
	State       RegistryState `json:"state"`
	Conditions  []Condition   `json:"conditions"`
	RegistryUrl string        `json:"registry_url"`
}

type ClusterInfo struct {
	Phase             ClusterInfoPhase      `json:"phase,omitempty"`
	LastRefreshedAt   *time.Time            `json:"lastRefreshedAt,omitempty"`
	KubernetesVersion string                `json:"kubernetesVersion,omitempty"`
	TotalNodes        int                   `json:"totalNodes,omitempty"`
	ReadyNodes        int                   `json:"readyNodes,omitempty"`
	AvailabilityZones []string              `json:"availabilityZones,omitempty"`
	Nodes             []ClusterNode         `json:"nodes,omitempty"`
	StorageClasses    []ClusterStorageClass `json:"storageClasses,omitempty"`
	LoadBalancers     []ClusterLoadBalancer `json:"loadBalancers,omitempty"`
	IngressClasses    []ClusterIngressClass `json:"ingressClasses,omitempty"`
}

type ClusterInfoPhase string

type ClusterIngressClass struct {
	Name       string `json:"name"`
	Controller string `json:"controller,omitempty"`
	IsDefault  bool   `json:"isDefault"`
}

type ClusterLoadBalancer struct {
	ServiceName      string   `json:"serviceName"`
	ServiceNamespace string   `json:"serviceNamespace"`
	IngressIPs       []string `json:"ingressIPs,omitempty"`
	IngressHostnames []string `json:"ingressHostnames,omitempty"`
	HasIP            bool     `json:"hasIP"`
}

type ClusterNode struct {
	Name                     string             `json:"name"`
	Ready                    bool               `json:"ready"`
	AllocatableCPU           *resource.Quantity `json:"allocatableCpu,omitempty"`
	AllocatableMemory        *resource.Quantity `json:"allocatableMemory,omitempty"`
	AllocatableEphemeralDisk *resource.Quantity `json:"allocatableEphemeralDisk,omitempty"`
	CapacityEphemeralDisk    *resource.Quantity `json:"capacityEphemeralDisk,omitempty"`
	Zone                     string             `json:"zone,omitempty"`
	Region                   string             `json:"region,omitempty"`
}

type ClusterStorageClass struct {
	Name        string `json:"name"`
	Provisioner string `json:"provisioner,omitempty"`
	IsDefault   bool   `json:"isDefault"`
}

type Condition struct {
	Type               string    `json:"type"`
	Status             string    `json:"status"`
	LastTransitionTime time.Time `json:"last_transition_time"`
	Reason             string    `json:"reason"`
	Message            string    `json:"message"`
}

type ConditionStatus string

type ConnectionConfig map[string]interface{}

type ConnectionConfigKey string

type ConnectionKind string

type ConnectionMapping struct {
	Target ConnectionTarget `json:"target"`
	Value  ValueRef         `json:"value"`
}

type ConnectionMappings []ConnectionMapping

type ConnectionTarget struct {
	Type ConnectionTargetType `json:"type"`
	Name string               `json:"name,omitempty"`
	// Used when Type is file, represents the path where the file should be mounted inside the container
	Path string `json:"path,omitempty"`
}

type ConnectionTargetType string

type ContainerFailureDetail struct {
	FailureType  string `json:"failure_type"`
	Reason       string `json:"reason,omitempty"`
	Message      string `json:"message,omitempty"`
	RestartCount int32  `json:"restart_count"`
	ExitCode     *int32 `json:"exit_code,omitempty"`
}

type Dependencies []string

type DeployedClusterInfo struct {
	ClusterID string `json:"clusterId"`
	Namespace string `json:"namespace"`
}

type EnvSecretRef struct {
	SecretName string `json:"secret_name"`
	Key        string `json:"key"`
}

type EnvVar struct {
	Name         string        `json:"name"`
	Value        string        `json:"value,omitempty"`
	SelfOutput   string        `json:"self_output,omitempty"`
	SecretKeyRef *EnvSecretRef `json:"secret_key_ref,omitempty"`
}

type EnvVars []EnvVar

type ExecutionConfig struct {
	Command []string `json:"command,omitempty"`
	Args    []string `json:"args,omitempty"`
	Env     []EnvVar `json:"env,omitempty"`
}

type GCSCredentials struct {
	ServiceAccountCredentials SecretReference `json:"serviceAccountCredentials"`
}

type GitAccountType string

type GitBuildSource struct {
	RepoURL string `json:"repo_url"`
	// IntegrationID pins an org-level git integration for clone auth,
	// overriding host auto-attach. Resolution lands with git integrations.
	IntegrationID string `json:"integration_id,omitempty"`
}

type GitHubAppCredentials struct {
	AppID         int64  `json:"app_id"`
	Slug          string `json:"slug"`
	PEM           string `json:"pem"`
	WebhookSecret string `json:"webhook_secret"`
	ClientID      string `json:"client_id"`
	ClientSecret  string `json:"client_secret"`
}

type GitHubAppManifestFlow struct {
	Manifest  map[string]any
	GitHubURL string
	State     string
}

type GitHubAppMintResult struct {
	IntegrationID string
	Host          string
	Token         string
	MintedAt      time.Time
	ExpiresAt     time.Time
	DataHash      string
}

type GitInstallation struct {
	ID                  string `gorm:"primary_key;default:gen_random_uuid()"`
	GitIntegrationID    string `gorm:"not null;index"`
	InstallationID      int64  `gorm:"not null"`
	AccountLogin        string `gorm:"not null"`
	AccountType         GitAccountType
	RepositorySelection string
	CreatedAt           time.Time
	UpdatedAt           time.Time
}

type GitIntegration struct {
	ID             string             `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID string             `gorm:"not null;index"`
	Type           GitIntegrationType `gorm:"not null"`
	// Host is the git host this integration covers (required for
	// git_credentials; github.com for github_app).
	Host          string `gorm:"index"`
	EncryptedAuth string `gorm:"type:text"`
	Status        GitIntegrationStatus
	DataHash      string `gorm:"not null"` // for change detection / release freezing
	CreatedAt     time.Time
	UpdatedAt     time.Time

	// Transient decrypted auth; never stored or serialized.
	Auth *GitIntegrationAuth `gorm:"-" json:"-"`
	// Transient GitHub install URL for github_app integrations.
	InstallURL string `gorm:"-" json:"-"`
}

type GitIntegrationAuth struct {
	Basic     *GitIntegrationBasicAuth `json:"basic,omitempty"`
	Token     string                   `json:"token,omitempty"`
	GitHubApp *GitHubAppCredentials    `json:"github_app,omitempty"`
}

type GitIntegrationBasicAuth struct {
	Username string `json:"username"`
	Password string `json:"password"`
}

type GitIntegrationStatus string

type GitIntegrationType string

type GitRepoRevision struct {
	Branch string `json:"branch"`
	Tag    string `json:"tag"`
	Commit string `json:"commit"`
}

type GitRepoRevisionType string

type GitRepoSource struct {
	RepoUrl  string          `json:"repo_url"`
	Revision GitRepoRevision `json:"revision"`
}

type GitRevision struct {
	Branch string `json:"branch"`
	Tag    string `json:"tag"`
	Commit string `json:"commit"`
}

type ImageBuild struct {
	ID                string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	Name              string `gorm:"not null; <-:create" json:"name"`
	Namespace         string
	StackID           string
	StackResourceID   string
	StackResourceName string
	StackResource     *StackResource    `gorm:"foreignKey:StackResourceID"`
	Spec              BuildConfigSpec   `gorm:"type:jsonb"`
	Status            *ImageBuildStatus `gorm:"type:jsonb"`
	CreatedAt         time.Time
	UpdatedAt         time.Time
}

type ImageBuildStatus struct {
	Conditions             []Condition         `json:"conditions"`
	State                  string              `json:"state"`
	BuildSourceHash        string              `json:"build_source_hash"`
	ImageURL               string              `json:"image_url"`
	BuildSourceRevision    string              `json:"build_source_revision"`
	LastObservedStatusHash string              `json:"last_observed_status_hash,omitempty"`
	LastBuildFailureDetail *BuildFailureDetail `json:"last_build_failure_detail,omitempty"`
	// ReleaseID is the release that triggered this build: the agent copies the
	// parent StackResource's release-id annotation onto the ImageBuild at
	// creation, and builds are never mutated after that.
	ReleaseID string `json:"release_id,omitempty"`
}

type ImageConfigSpec struct {
	Image           string `json:"image"`
	ImagePullPolicy string `json:"image_pull_policy,omitempty"`
	// RegistryCredentialID pins an org-level registry credential for image
	// pulls, overriding host auto-attach.
	RegistryCredentialID string `json:"registry_credential_id,omitempty"`
}

type ImageOverrides map[string]string

type Ingress struct {
	URL        string `json:"url"`
	TargetPort int    `json:"target_port"`
}

type InitConfig struct {
	Command []string `json:"command"`
	Args    []string `json:"args"`
}

type InviteStatus string

type Label struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type Labels []Label

type LifecycleConfig struct {
	RestartRequestTime *time.Time `json:"restart_request_time"`
}

type Meta struct {
	ID        string `gorm:"primary_key"`
	CreatedAt time.Time
	UpdatedAt time.Time
	DeletedAt gorm.DeletedAt `gorm:"index"`
}

type Namespace struct {
	ID             string      `gorm:"primary_key;default:gen_random_uuid()"`
	Name           string      `gorm:"not null;unique"`
	OrganisationID string      `gorm:"not null"`
	Labels         Labels      `gorm:"type:jsonb"`
	Annotations    Annotations `gorm:"type:jsonb"`
	CreatedAt      time.Time
	UpdatedAt      time.Time
}

type NodeCapacity struct {
	NodeName string             `json:"node_name"` // Name of the node
	CPU      *resource.Quantity `json:"cpu"`       // Total CPU capacity
	Memory   *resource.Quantity `json:"memory"`    // Total memory capacity
	Storage  *resource.Quantity `json:"storage"`   // Total storage capacity
}

type OAuthState struct {
	ID          string    `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	State       string    `gorm:"not null;uniqueIndex" json:"state"`
	Provider    string    `gorm:"not null" json:"provider"`
	InviteToken string    `json:"inviteToken,omitempty"`
	CreatedAt   time.Time `gorm:"not null" json:"createdAt"`
}

type ObjectStore struct {
	ID             string `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID string `gorm:"not null;index"`
	ProjectID      string `gorm:"index" json:"project_id"`
	Name           string `gorm:"not null"`

	// Spec fields
	Configuration   ObjectStoreConfiguration `gorm:"type:jsonb;not null"`
	DestinationPath string                   `gorm:"not null"`
	RetentionPolicy string

	// Status fields
	Status    ObjectStoreStatus `gorm:"type:jsonb"`
	CreatedAt time.Time
	UpdatedAt time.Time
}

type ObjectStoreConfiguration struct {
	S3Credentials    *S3Credentials    `json:"s3Credentials,omitempty"`
	AzureCredentials *AzureCredentials `json:"azureCredentials,omitempty"`
	GCSCredentials   *GCSCredentials   `json:"gcsCredentials,omitempty"`
}

type ObjectStoreStatus struct {
	State            string                `json:"state,omitempty"`
	Message          string                `json:"message,omitempty"`
	Conditions       []Condition           `json:"conditions,omitempty"`
	DeployedClusters []DeployedClusterInfo `json:"deployedClusters,omitempty"`
}

type OrgInvite struct {
	ID             string       `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	Email          string       `gorm:"not null" json:"email"`
	OrganisationID string       `gorm:"not null" json:"organisation_id"`
	ProjectID      string       `gorm:"not null" json:"project_id"`
	ProjectRole    ProjectRole  `gorm:"not null;column:project_role" json:"project_role"`
	TokenHash      string       `gorm:"not null" json:"-"`
	EncryptedToken string       `gorm:"not null" json:"-"`
	Status         InviteStatus `gorm:"not null;default:pending" json:"status"`
	ExpiresAt      time.Time    `gorm:"not null" json:"expires_at"`
	InvitedByID    string       `gorm:"not null" json:"invited_by_id"`
	AcceptedAt     *time.Time   `json:"accepted_at,omitempty"`
	EmailSent      bool         `gorm:"not null;default:false" json:"email_sent"`
	EmailSentAt    *time.Time   `json:"email_sent_at,omitempty"`
	EmailError     *string      `json:"email_error,omitempty"`
	CreatedAt      time.Time    `gorm:"not null" json:"created_at"`

	Organisation *Organisation `gorm:"foreignKey:OrganisationID" json:"organisation,omitempty"`
	Project      *Project      `gorm:"foreignKey:ProjectID" json:"project,omitempty"`
	InvitedBy    *User         `gorm:"foreignKey:InvitedByID" json:"invited_by,omitempty"`
}

type OrgInviteOperand struct{ ID string }

type OrgRegistryDefaults struct {
	StorageSize  string
	StorageClass string
}

type Organisation struct {
	CreatedAt time.Time
	UpdatedAt time.Time
	ID        string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	Name      string
	Platform  bool                  `gorm:"column:platform"`
	Domains   []*OrganisationDomain `gorm:"foreignKey:OrganisationID"`
}

type OrganisationDomain struct {
	ID             string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	OrganisationID string `gorm:"not null"`
	Domain         string `gorm:"unique;not null"`
	CreatedAt      time.Time
	UpdatedAt      time.Time
}

type OutputDescriptor struct {
	Name      string          `json:"name"`
	Type      OutputValueType `json:"type"`
	Sensitive bool            `json:"sensitive"`
}

type OutputValueRef struct {
	Output string `json:"output"`
}

type OutputValueType string

type Port struct {
	Name                     string `json:"name"`
	Number                   int    `json:"number"`
	Protocol                 string `json:"protocol"`
	ExposedToPublic          bool   `json:"exposed_to_public"`
	SubdomainPrefix          string `json:"subdomain_prefix"`
	GeneratedSubdomainPrefix string `json:"generated_subdomain_prefix"`
	ExposedFqdn              string `json:"fqdn"`
}

type Ports []Port

type PostgresAddon struct {
	ID             string      `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID string      `gorm:"not null;index"`
	ProjectID      string      `gorm:"index" json:"project_id"`
	UserID         string      `gorm:"not null;index"`
	ClusterID      string      `gorm:"not null;index"`
	Name           string      `gorm:"not null"`
	NamespaceID    string      `gorm:"not null;index"`
	Namespace      string      `gorm:"not null"`
	Labels         Labels      `gorm:"type:jsonb"`
	Annotations    Annotations `gorm:"type:jsonb"`
	Revision       string

	// Spec fields
	PostgresVersion PostgresVersion        `gorm:"type:jsonb;not null"`
	Instances       PostgresInstances      `gorm:"type:jsonb;not null"`
	Resources       PostgresResources      `gorm:"type:jsonb;not null"`
	Storage         PostgresStorage        `gorm:"type:jsonb;not null"`
	Configuration   PostgresConfiguration  `gorm:"type:jsonb"`
	Initialization  PostgresInitialization `gorm:"type:jsonb"`
	BackupConfig    PostgresBackupConfig   `gorm:"type:jsonb"`

	// Lifecycle fields
	BackupRequestedAt *time.Time              `gorm:"default:NULL"`
	LifecycleConfig   PostgresLifecycleConfig `gorm:"type:jsonb"`
	DeletionTimestamp *time.Time              `gorm:"default:NULL"`

	// Status fields
	Status    PostgresAddonStatus `gorm:"type:jsonb"`
	CreatedAt time.Time
	UpdatedAt time.Time

	// Relationships
	Databases []PostgresAddonDatabase `gorm:"foreignKey:PostgresAddonID"`
	Backups   []PostgresBackup        `gorm:"foreignKey:PostgresAddonID"`
	Outputs   []OutputDescriptor      `gorm:"-" json:"outputs,omitempty"`
}

type PostgresAddonClusterSecrets struct {
	SuperuserSecret     *string           `json:"superuserSecret,omitempty"`
	UserSecrets         map[string]string `json:"userSecrets,omitempty"`
	CACertificateSecret string            `json:"caCertificateSecret,omitempty"`
}

type PostgresAddonConditionType string

type PostgresAddonConnectionInfo struct {
	Host           string                       `json:"host,omitempty"`
	Port           int32                        `json:"port,omitempty"`
	SSLMode        string                       `json:"sslMode,omitempty"`
	WriteService   string                       `json:"writeService,omitempty"`
	ReadService    string                       `json:"readService,omitempty"`
	ClusterSecrets *PostgresAddonClusterSecrets `json:"clusterSecrets,omitempty"`
}

type PostgresAddonDatabase struct {
	ID              string             `gorm:"primary_key;default:gen_random_uuid()"`
	PostgresAddonID string             `gorm:"not null;index"`
	Name            string             `gorm:"not null"`
	Extensions      PostgresExtensions `gorm:"type:jsonb"`
	CreatedAt       time.Time
	UpdatedAt       time.Time
}

type PostgresAddonOperand struct{ ID string }

type PostgresAddonState string

type PostgresAddonStatus struct {
	State                  PostgresAddonState           `json:"state,omitempty"`
	Message                string                       `json:"message,omitempty"`
	Conditions             []Condition                  `json:"conditions,omitempty"`
	ConnectionInfo         *PostgresAddonConnectionInfo `json:"connectionInfo,omitempty"`
	Databases              []PostgresDatabaseInfo       `json:"databases,omitempty"`
	LastObservedStatusHash string                       `json:"lastObservedStatusHash,omitempty"`
}

type PostgresBackup struct {
	ID              string `gorm:"primary_key;default:gen_random_uuid()"`
	PostgresAddonID string `gorm:"not null;index"`
	Name            string
	Description     string
	Type            PostgresBackupType
	Phase           string
	StartedAt       *time.Time
	CompletedAt     *time.Time
	Error           string
	SizeBytes       *int32
	CreatedAt       time.Time
	UpdatedAt       time.Time
}

type PostgresBackupConfig struct {
	ObjectStoreID string `json:"objectStoreId,omitempty"`
	Schedule      string `json:"schedule,omitempty"`
	WALArchiving  bool   `json:"walArchiving,omitempty"`
}

type PostgresBackupType string

type PostgresCPUResource struct {
	Request string `json:"request"`
	Limit   string `json:"limit"`
}

type PostgresConfiguration struct {
	EnableSuperuserAccess bool              `json:"enableSuperuserAccess,omitempty"`
	Parameters            map[string]string `json:"parameters,omitempty"`
}

type PostgresCredentials struct {
	Database         string `json:"database"`
	Host             string `json:"host"`
	Port             int32  `json:"port"`
	Username         string `json:"username"`
	Password         string `json:"password"`
	SSLMode          string `json:"sslMode"`
	ConnectionString string `json:"connectionString"`
	CACertificate    string `json:"caCertificate,omitempty"`
}

type PostgresDatabaseInfo struct {
	Name  string `json:"name"`
	Owner string `json:"owner,omitempty"`
}

type PostgresExtensions []string

type PostgresImportFromExternal struct {
	Host              string   `json:"host"`
	Port              int      `json:"port"`
	Database          string   `json:"database"`
	Username          string   `json:"username"`
	PasswordSecretID  string   `json:"passwordSecretId"`
	SslMode           *string  `json:"sslMode,omitempty"`
	DatabasesToImport []string `json:"databasesToImport,omitempty"`
}

type PostgresInitialization struct {
	RestoreFromBackup      *PostgresRestoreFromBackup      `json:"restoreFromBackup,omitempty"`
	RestoreFromObjectStore *PostgresRestoreFromObjectStore `json:"restoreFromObjectStore,omitempty"`
	ImportFromExternal     *PostgresImportFromExternal     `json:"importFromExternal,omitempty"`
}

type PostgresInstancePlacement struct {
	TopologyKey  string               `json:"topology_key,omitempty"`
	Policy       string               `json:"policy,omitempty"` // preferred or required
	NodeSelector map[string]string    `json:"node_selector,omitempty"`
	Tolerations  []PostgresToleration `json:"tolerations,omitempty"`
}

type PostgresInstances struct {
	Count     int                        `json:"count"`
	Placement *PostgresInstancePlacement `json:"placement,omitempty"`
}

type PostgresLifecycleConfig struct {
	HibernationEnabled bool `json:"hibernationEnabled,omitempty"`
	FencingEnabled     bool `json:"fencingEnabled,omitempty"`
}

type PostgresMemoryResource struct {
	Request string `json:"request"`
	Limit   string `json:"limit"`
}

type PostgresResources struct {
	CPU    PostgresCPUResource    `json:"cpu"`
	Memory PostgresMemoryResource `json:"memory"`
}

type PostgresRestoreFromBackup struct {
	BackupID string `json:"backupId"`
}

type PostgresRestoreFromObjectStore struct {
	ObjectStoreID         string     `json:"objectStoreId"`
	SourcePostgresAddonID string     `json:"sourcePostgresAddonId"`
	RecoveryTargetTime    *time.Time `json:"recoveryTargetTime,omitempty"`
}

type PostgresStorage struct {
	Size         string `json:"size"`
	StorageClass string `json:"storageClass,omitempty"`
}

type PostgresToleration struct {
	Key      string `json:"key"`
	Operator string `json:"operator"`
	Value    string `json:"value,omitempty"`
	Effect   string `json:"effect"`
}

type PostgresVersion struct {
	Major                     int  `json:"major"`
	Minor                     int  `json:"minor"`
	EnableMajorVersionUpgrade bool `json:"enableMajorVersionUpgrade,omitempty"`
	EnableMinorVersionUpgrade bool `json:"enableMinorVersionUpgrade,omitempty"`
}

type PreviewGitRepository struct {
	RepoURL    string `json:"repo_url"`
	BaseBranch string `json:"base_branch"`
	// IntegrationID pins an org-level git integration for clone auth;
	// otherwise clone auth follows host auto-match, then anonymous.
	IntegrationID string `json:"integration_id,omitempty"`
}

type PreviewReconcilerStatus struct {
	LastAppliedCommitSHA     string    `json:"last_applied_commit_sha,omitempty"`
	LastAppliedStackfileHash string    `json:"last_applied_stackfile_hash,omitempty"`
	LastAppliedOverridesHash string    `json:"last_applied_overrides_hash,omitempty"`
	LastProcessedForceSyncAt time.Time `json:"last_processed_force_sync_at,omitempty"`
}

type PreviewStack struct {
	ID                   string `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID       string `gorm:"not null"`
	ProjectID            string `gorm:"not null"`
	UserID               string `gorm:"not null"`
	StackPreviewConfigID string `gorm:"not null"`
	StackID              *string
	ActiveReleaseID      *string
	Name                 string                  `gorm:"not null"`
	PRNumber             string                  `gorm:"not null"`
	Branch               string                  `gorm:"not null"`
	CommitSHA            string                  `gorm:"not null"`
	Source               PreviewStackSource      `gorm:"not null"`
	GitHubCommentID      int64                   `gorm:"column:github_comment_id;not null;default:0"`
	GitHubCommentPending bool                    `gorm:"column:github_comment_pending;not null;default:false"`
	ImageOverrides       ImageOverrides          `gorm:"type:jsonb"`
	Labels               Labels                  `gorm:"type:jsonb"`
	Annotations          Annotations             `gorm:"type:jsonb"`
	Status               PreviewStackStatus      `gorm:"type:jsonb;not null"`
	ReconcilerStatus     PreviewReconcilerStatus `gorm:"type:jsonb;not null;default:'{}'"`
	ForceSyncRequestedAt *time.Time
	StackfileContent     *string
	DeletionTimestamp    *time.Time
	CreatedAt            time.Time
	UpdatedAt            time.Time
}

type PreviewStackOperand struct{ ID string }

type PreviewStackOutputs struct {
	CommitSHA string       `json:"commit_sha,omitempty"`
	URLs      []PreviewURL `json:"urls,omitempty"`
}

type PreviewStackPhase string

type PreviewStackSource string

type PreviewStackStatus struct {
	Phase   PreviewStackPhase    `json:"phase"`
	Reason  string               `json:"reason,omitempty"`
	Message string               `json:"message,omitempty"`
	Outputs *PreviewStackOutputs `json:"outputs,omitempty"`
}

type PreviewURL struct {
	Resource string `json:"resource"`
	URL      string `json:"url"`
}

type Project struct {
	ID             string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	Name           string `gorm:"not null" json:"name"`
	OrganisationID string `gorm:"not null" json:"organisation_id"`
	DefaultProject bool   `gorm:"not null;default:false" json:"default_project"`
	CreatedAt      time.Time
	UpdatedAt      time.Time
}

type ProjectMembership struct {
	ID        string      `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	ProjectID string      `gorm:"not null" json:"project_id"`
	UserID    string      `gorm:"not null" json:"user_id"`
	Role      ProjectRole `gorm:"not null" json:"role"`
	CreatedAt time.Time
	Project   *Project `gorm:"foreignKey:ProjectID" json:"project,omitempty"`
	User      *User    `gorm:"foreignKey:UserID" json:"user,omitempty"`
}

type ProjectRole string

type ReferentType string

type RefreshToken struct {
	ID        string     `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	UserID    string     `gorm:"not null" json:"userId"`
	TokenHash string     `gorm:"not null" json:"-"`
	ExpiresAt time.Time  `gorm:"not null" json:"expiresAt"`
	CreatedAt time.Time  `gorm:"not null" json:"createdAt"`
	RevokedAt *time.Time `json:"revokedAt,omitempty"`
}

type RegistryCredential struct {
	ID                string                    `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID    string                    `gorm:"not null;index"`
	Host              string                    `gorm:"not null"` // normalized registry host
	Purpose           RegistryCredentialPurpose `gorm:"not null;default:'both'"`
	Username          string                    `gorm:"not null"`
	EncryptedPassword string                    `gorm:"type:text;not null"`
	DataHash          string                    `gorm:"not null"` // for change detection / release freezing
	CreatedAt         time.Time
	UpdatedAt         time.Time

	// Transient plaintext password; never stored or serialized.
	Password string `gorm:"-" json:"-"`
}

type RegistryCredentialPurpose string

type RegistryState string

type RelationKind string

type ReleaseCause struct {
	Kind   ReleaseCauseKind `json:"kind"`
	Detail string           `json:"detail,omitempty"`
}

type ReleaseCauseKind string

type ReleaseEvent struct {
	ID           string             `gorm:"primaryKey;default:gen_random_uuid()"`
	ReleaseID    string             `gorm:"not null"`
	StackID      string             `gorm:"not null"`
	Sequence     int                `gorm:"not null"`
	OccurredAt   time.Time          `gorm:"not null;default:now()"`
	Source       ReleaseEventSource `gorm:"not null"`
	Scope        ReleaseEventScope  `gorm:"not null"`
	ResourceName *string
	Type         ReleaseEventType     `gorm:"not null"`
	Level        ReleaseEventLevel    `gorm:"not null"`
	Message      string               `gorm:"not null"`
	DedupeKey    string               `gorm:"not null"`
	Links        ReleaseEventLinks    `gorm:"type:jsonb"`
	Metadata     ReleaseEventMetadata `gorm:"type:jsonb"`
	CreatedAt    time.Time
}

type ReleaseEventLevel string

type ReleaseEventLink struct {
	Kind   string            `json:"kind"`
	Label  string            `json:"label"`
	Target map[string]string `json:"target"`
}

type ReleaseEventLinks []ReleaseEventLink

type ReleaseEventMetadata map[string]string

type ReleaseEventScope string

type ReleaseEventSource string

type ReleaseEventType string

type ReleaseHealth string

type ReleaseLiveStatus struct {
	Health           ReleaseHealth
	Resources        map[string]*StackResourceStatus
	Conditions       []Condition
	TargetRevision   string
	ObservedRevision string
}

type ReleaseManifest struct {
	StackCR            json.RawMessage                  `json:"stack_cr"`
	StackResourceCRs   map[string]json.RawMessage       `json:"stack_resource_crs"`
	ResourceNames      []string                         `json:"resource_names"`
	VolumeBuildSources map[string][]BuildArtifactSource `json:"volume_build_sources,omitempty"`
	ResourceRevisions  map[string]string                `json:"resource_revisions"`
}

type ReleaseOutcome struct {
	Resources map[string]ResourceOutcome `json:"resources,omitempty"`
	Duration  time.Duration              `json:"duration"`
}

type ReleasePins struct {
	// Resource Name -> Resolved artifact src.
	Resources map[string]ResourcePins `json:"resources,omitempty"`
}

type ReleaseSummary struct {
	ID       string
	Sequence int
	State    StackReleaseState
}

type ReleaseValidationError struct {
	ResourceName string `json:"resource_name"`
	Field        string `json:"field"`
	Code         string `json:"code"`
	Message      string `json:"message"`
}

type ReleaseValidationErrors []ReleaseValidationError

type ReleaseWorkerStatus struct {
	// ConvergeClockStartedAt is when the convergence timeout clock started.
	// The deadline reconciler stamps it once the release has no builds left
	// to wait for, and clears it again if a build shows up running. Nil means
	// the clock has not started and the release cannot converge-timeout.
	ConvergeClockStartedAt *time.Time `json:"converge_clock_started_at,omitempty"`
}

type RemoteDirSource struct {
	// Path within the client where the directory to be synced is located.
	Path string `json:"path"`
	// We use this to track the current state of the remote directory.
	CurrentDirectoryHash string `json:"current_directory_hash"`
}

type ResourceMetrics struct {
	AssignedNodes  []string          `json:"assigned_node"` // Node where the resource is assigned
	CPUUsage       resource.Quantity `json:"cpu_usage"`     // CPU usage in percentage
	CPULimit       resource.Quantity `json:"cpu_limit"`     // CPU limit in cores
	MemoryUsage    resource.Quantity `json:"memory_usage"`  // Memory usage in percentage
	MemoryLimit    resource.Quantity `json:"memory_limit"`  // Memory limit in bytes
	NetworkIO      float64           `json:"network_io"`    // Network I/O in bytes
	StorageIO      float64           `json:"storage_io"`    // Storage I/O in bytes
	NodeCapacities []*NodeCapacity   `json:"node_capacity"` // Node capacity metrics
	TimeStamp      time.Time         `json:"time_stamp"`    // Timestamp of the metrics
}

type ResourceOutcome struct {
	Phase         StackResourcePhase `json:"phase"`
	ReadyReplicas int32              `json:"ready_replicas"`
	Replicas      int32              `json:"replicas"`
	Message       string             `json:"message,omitempty"`
}

type ResourcePins struct {
	GitSHA string `json:"git_sha,omitempty"`
	// Branch records the branch a default-branch resolution landed on, so the
	// snapshot can carry it (the CRD requires branch-or-tag on git revisions).
	Branch      string `json:"branch,omitempty"`
	VolumeHash  string `json:"volume_hash,omitempty"`
	ImageDigest string `json:"image_digest,omitempty"`
}

type ResourceReference struct {
	ID           string       `gorm:"primary_key;default:gen_random_uuid()"`
	StackID      string       `gorm:"not null;index"`
	ReleaseID    *string      `gorm:"index"` // nil => live spec
	ReferentType ReferentType `gorm:"not null"`
	ReferentID   string       `gorm:"not null"`
	RelationKind RelationKind `gorm:"not null"`
	CreatedAt    time.Time
}

type ResourceValidationCheckKind string

type ResourceValidationRecord struct {
	StackID      string                      `gorm:"primaryKey"`
	ResourceName string                      `gorm:"primaryKey"`
	CheckKind    ResourceValidationCheckKind `gorm:"primaryKey"`
	Fingerprint  string                      `gorm:"not null"`
	ValidatedAt  time.Time                   `gorm:"not null"`
}

type S3Credentials struct {
	AccessKeyID     SecretReference `json:"accessKeyId"`
	SecretAccessKey SecretReference `json:"secretAccessKey"`
	Region          string          `json:"region"`
	Endpoint        string          `json:"endpoint,omitempty"`
}

type SSHConfig struct {
	// Users public key.
	PublicKey string `json:"public_key"`
}

type Secret struct {
	ID             string `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID string `gorm:"not null;index"`
	ProjectID      string `gorm:"index" json:"project_id"`
	UserID         string `gorm:"not null;index"`
	Name           string `gorm:"not null"`
	Description    string
	Type           SecretType `gorm:"not null" json:"type"`
	EncryptedData  string     `gorm:"type:text;not null"`
	Keys           SecretKeys `gorm:"type:jsonb" json:"keys"`
	DataHash       string     `gorm:"not null" ` // For change detection

	CreatedAt time.Time
	UpdatedAt time.Time

	// Transient field for API responses (not stored in DB)
	Data    map[string]string  `gorm:"-" json:"data,omitempty"`
	Outputs []OutputDescriptor `gorm:"-" json:"outputs,omitempty"`
}

type SecretKeys []string

type SecretReference struct {
	SecretID string `json:"secret_id"` // UUID of the secret
	Key      string `json:"key"`       // Key within the secret
}

type SecretType string

type SourceVolumeType string

type Stack struct {
	ID                string      `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	OrganisationID    string      `gorm:"not null"`
	ProjectID         string      `gorm:"index" json:"project_id"`
	ClusterID         string      `gorm:"not null"`
	UserID            string      `gorm:"not null"`
	Name              string      `gorm:"not null;<-:create"`
	NamespaceID       string      `gorm:"not null"`
	Namespace         string      `gorm:"unique;not null;<-:create"`
	Labels            Labels      `gorm:"type:jsonb"`
	Annotations       Annotations `gorm:"type:jsonb"`
	CrRevision        string
	Connections       StackConnections `gorm:"-"`
	StackResources    []*StackResource `gorm:"foreignKey:StackID"`
	Volumes           []*Volume        `gorm:"-"`
	Status            *StackStatus     `gorm:"type:jsonb"`
	Settings          *StackSettings   `gorm:"type:jsonb"`
	CreatedAt         time.Time
	UpdatedAt         time.Time
	DeletionTimestamp *time.Time `gorm:"default:NULL"`
}

type StackConditionType string

type StackConnection struct {
	ID            string             `json:"id" gorm:"column:id;primary_key;default:gen_random_uuid()"`
	StackID       string             `json:"-" gorm:"not null;index"`
	Kind          ConnectionKind     `json:"kind" gorm:"not null"`
	From          TopologyNodeRef    `json:"from" gorm:"column:from_ref;type:jsonb;not null"`
	To            TopologyNodeRef    `json:"to" gorm:"column:to_ref;type:jsonb;not null"`
	Mappings      ConnectionMappings `json:"mappings,omitempty" gorm:"type:jsonb"`
	Config        ConnectionConfig   `json:"config,omitempty" gorm:"type:jsonb"`
	Discriminator string             `json:"-" gorm:"not null;default:''"`
	CreatedAt     time.Time          `json:"-"`
	UpdatedAt     time.Time          `json:"-"`
}

type StackConnections []StackConnection

type StackConvergenceRecord struct {
	Revision  string    `json:"revision"`
	ReleaseID string    `json:"release_id,omitempty"`
	At        time.Time `json:"at"`
}

type StackDomain struct {
	ID                string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	OrganisationID    string `gorm:"not null"`
	Fqdn              string `gorm:"unique;not null"`
	StackID           string `gorm:"not null;index"`
	StackResourceID   string `gorm:"not null;index"`
	StackResourceName string `gorm:"not null"`
	TargetPort        int    `gorm:"not null"`
	CreatedAt         time.Time
	UpdatedAt         time.Time
}

type StackDomainList []*StackDomain

type StackOperand struct{ ID string }

type StackPhase string

type StackPreviewConfig struct {
	ID                string `gorm:"primary_key;default:gen_random_uuid()"`
	OrganisationID    string `gorm:"not null"`
	ProjectID         string `gorm:"not null"`
	UserID            string `gorm:"not null"`
	Name              string `gorm:"not null"`
	Description       string
	GitRepository     PreviewGitRepository `gorm:"type:jsonb;not null"`
	StackfilePath     string               `gorm:"not null;default:'stackfile.yaml'"`
	MaxActivePreviews int                  `gorm:"not null;default:10"`
	Env               EnvVars              `gorm:"type:jsonb" json:"env"`
	RepoURLNormalized string               `gorm:"column:repo_url_normalized" json:"-"`
	Labels            Labels               `gorm:"type:jsonb"`
	Annotations       Annotations          `gorm:"type:jsonb"`
	CreatedAt         time.Time
	UpdatedAt         time.Time
}

type StackRelease struct {
	ID               string            `gorm:"primary_key;default:gen_random_uuid()"`
	StackID          string            `gorm:"not null"`
	Sequence         int               `gorm:"not null"`
	State            StackReleaseState `gorm:"not null"`
	Message          string
	Cause            ReleaseCause     `gorm:"type:jsonb"`
	Snapshot         StackSnapshot    `gorm:"type:jsonb;not null"`
	SnapshotRevision string           `gorm:"not null"`
	Manifest         *ReleaseManifest `gorm:"type:jsonb"`
	ManifestRevision string
	Pins             ReleasePins `gorm:"type:jsonb"`
	RendererVersion  string
	Outcome          *ReleaseOutcome         `gorm:"type:jsonb"`
	ValidationErrors ReleaseValidationErrors `gorm:"type:jsonb"`
	WorkerStatus     *ReleaseWorkerStatus    `gorm:"type:jsonb"`
	CreatedBy        string
	CreatedAt        time.Time
	UpdatedAt        time.Time
	RenderedAt       *time.Time
	CompletedAt      *time.Time
}

type StackReleaseOperand struct{ ID string }

type StackReleaseRefs struct {
	Converged *StackRelease
	Latest    *StackRelease
}

type StackReleaseState string

type StackResource struct {
	ID          string `gorm:"default:gen_random_uuid()"`
	UserID      string `gorm:"not null"`
	StackID     string
	Name        string      `gorm:"<-:create"`
	Namespace   string      `gorm:"<-:create"`
	Labels      Labels      `gorm:"type:jsonb"`
	Annotations Annotations `gorm:"type:jsonb"`
	// Tracks the version of the object in the database.
	Version         int
	BuildConfig     *BuildConfigSpec   `gorm:"type:jsonb"`
	ImageConfig     *ImageConfigSpec   `gorm:"type:jsonb"`
	Init            *InitConfig        `gorm:"type:jsonb"`
	ExecutionConfig *ExecutionConfig   `gorm:"type:jsonb"`
	VolumeMounts    []*VolumeMount     `gorm:"-"`
	DependsOn       Dependencies       `gorm:"type:jsonb"`
	LifecycleConfig *LifecycleConfig   `gorm:"type:jsonb"`
	Ports           Ports              `gorm:"type:jsonb"`
	Outputs         []OutputDescriptor `gorm:"-" json:"outputs,omitempty"`
	WorkloadType    WorkloadType
	Schedule        string
	Replicas        *int32
	Status          *StackResourceStatus `gorm:"type:jsonb"`
	CreatedAt       time.Time
	UpdatedAt       time.Time
}

type StackResourceConditionType string

type StackResourceConvergenceRecord struct {
	Revision string    `json:"revision"`
	At       time.Time `json:"at"`
}

type StackResourceFailure struct {
	Type          StackResourceFailureType `json:"type"`
	Container     *ContainerFailureDetail  `json:"container,omitempty"`
	InitContainer *ContainerFailureDetail  `json:"init_container,omitempty"`
	Build         *BuildFailureDetail      `json:"build,omitempty"`
}

type StackResourceFailureType string

type StackResourcePhase string

type StackResourceState string

type StackResourceStatus struct {
	State                         StackResourceState    `json:"state"`
	Message                       string                `json:"message"`
	ObservedCrRevision            string                `json:"observed_cr_revision"`
	Conditions                    []Condition           `json:"conditions"`
	PublicIngresses               []Ingress             `json:"public_ingresses"`
	InternalServiceName           *string               `json:"internal_service_name,omitempty"`
	LastObservedStatusHash        string                `json:"last_observed_status_hash,omitempty"`
	LastRestartRequestProcessedAt *time.Time            `json:"last_restart_request_processed_at,omitempty"`
	LastFailure                   *StackResourceFailure `json:"last_failure,omitempty"`
	Replicas                      int32                 `json:"replicas,omitempty"`
	AvailableReplicas             int32                 `json:"available_replicas,omitempty"`
	UpdatedReplicas               int32                 `json:"updated_replicas,omitempty"`
	LastRunTime                   *time.Time            `json:"last_run_time,omitempty"`
	LastRunSucceeded              *bool                 `json:"last_run_succeeded,omitempty"`
}

type StackResourceSummary struct {
	Name              string                          `json:"name"`
	Phase             StackResourcePhase              `json:"phase,omitempty"`
	ObservedRevision  string                          `json:"observed_revision,omitempty"`
	ConvergedRevision string                          `json:"converged_revision,omitempty"`
	LastConverged     *StackResourceConvergenceRecord `json:"last_converged,omitempty"`
	AvailableReplicas int32                           `json:"available_replicas,omitempty"`
	UpdatedReplicas   int32                           `json:"updated_replicas,omitempty"`
	Replicas          int32                           `json:"replicas,omitempty"`
	Missing           bool                            `json:"missing,omitempty"`
	Message           string                          `json:"message,omitempty"`
}

type StackSettings struct {
	ReleaseRetentionLimit int `json:"release_retention_limit"`
	MinSuccessfulReleases int `json:"min_successful_releases"`
}

type StackShellSnapshot struct {
	ID             string      `json:"id"`
	OrganisationID string      `json:"organisation_id"`
	ProjectID      string      `json:"project_id"`
	ClusterID      string      `json:"cluster_id"`
	UserID         string      `json:"user_id"`
	Name           string      `json:"name"`
	NamespaceID    string      `json:"namespace_id"`
	Namespace      string      `json:"namespace"`
	Labels         Labels      `json:"labels"`
	Annotations    Annotations `json:"annotations"`
}

type StackSnapshot struct {
	Stack       StackShellSnapshot `json:"stack"`
	Resources   []*StackResource   `json:"resources"`
	Volumes     []*Volume          `json:"volumes"`
	Connections StackConnections   `json:"connections"`
	CapturedAt  time.Time          `json:"captured_at"`
}

type StackState string

type StackStatus struct {
	State                  StackState              `json:"state"`
	Message                string                  `json:"message"`
	ObservedCrRevision     string                  `json:"observed_cr_revision"`
	Conditions             []Condition             `json:"conditions"`
	LastObservedStatusHash string                  `json:"last_observed_status_hash"`
	LastValidationRun      *ValidationRun          `json:"last_validation_run"`
	TargetRevision         string                  `json:"target_revision,omitempty"`
	LastConverged          *StackConvergenceRecord `json:"last_converged,omitempty"`
	Resources              []StackResourceSummary  `json:"resources,omitempty"`
}

type StackStorage struct {
	ID             string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	OrganisationID string `gorm:"not null"`
	UserID         string `gorm:"not null"`
	Name           string `gorm:"not null; <-:create"`
	Namespace      string `gorm:"unique;not null;  <-:create"`
	WorkspaceName  string `gorm:"<-:create"`
	// Tracks the version of the object in the database.
	Version           int
	Labels            Labels              `gorm:"type:jsonb"`
	Annotations       Annotations         `gorm:"type:jsonb"`
	SSHConfig         SSHConfig           `gorm:"type:jsonb"`
	Volumes           []*Volume           `gorm:"foreignKey:StorageID"`
	Status            *StackStorageStatus `gorm:"type:jsonb"`
	DeletionTimeStamp *time.Time          `json:"deletion_timestamp"`
	CreatedAt         time.Time
	UpdatedAt         time.Time
}

type StackStorageState string

type StackStorageStatus struct {
	State                    StackStorageState `json:"state"`
	Conditions               []Condition       `json:"conditions"`
	Phase                    string            `json:"phase"`
	StorageServerServiceName string            `json:"storage_server_service_name"`
	LastObservedStatusHash   string            `json:"last_observed_status_hash,omitempty"`
	ObservedVersion          int64             `json:"observed_version"`
	// Subpath within the storage pod where different volumes are mounted.
	VolumeMountPaths []VolumeMountPath `json:"volume_mount_paths,omitempty"`
}

type StackTopology struct {
	Nodes []TopologyNode `json:"nodes"`
	Edges []TopologyEdge `json:"edges"`
}

type StackVolume struct {
	StackID  string `gorm:"primary_key"`
	VolumeID string `gorm:"primary_key"`
}

type StringSlice []string

type TopologyEdge struct {
	Id       string                 `json:"id,omitempty"`
	Kind     string                 `json:"kind"`
	Source   TopologyNodeRef        `json:"source"`
	Target   TopologyNodeRef        `json:"target"`
	Mappings []ConnectionMapping    `json:"mappings,omitempty"`
	Config   map[string]interface{} `json:"config,omitempty"`
	// If its from user's explicit connection or inferred by the system, Like consuming pull secrets, git credentials.
	SourceOfTruth string `json:"source_of_truth"`
}

type TopologyNode struct {
	Ref     TopologyNodeRef    `json:"ref"`
	Label   string             `json:"label"`
	Outputs []OutputDescriptor `json:"outputs,omitempty"`
	State   string             `json:"state,omitempty"`
}

type TopologyNodeRef struct {
	Type TopologyNodeType `json:"type"`
	Id   string           `json:"id,omitempty"`
	Name string           `json:"name,omitempty"`
}

type TopologyNodeType string

type User struct {
	ID             string `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	CreatedAt      time.Time
	UpdatedAt      time.Time
	Name           string
	Email          string `gorm:"unique"`
	Password       string
	Organisation   *Organisation `gorm:"foreignKey:OrganisationID"`
	Role           UserRole
	OrganisationID string
	GithubID       *string `gorm:"column:github_id;uniqueIndex"`
	AvatarURL      *string `gorm:"column:avatar_url"`
}

type UserRole string

type ValidationRun struct {
	// List of validation types that were run.
	ValidationTypes []string `json:"validation_types"`
	StackRevision   string   `json:"stack_revision"`
	Passed          bool     `json:"passed"`
	Message         string   `json:"message"`
}

type ValueRef struct {
	Output   string                    `json:"output,omitempty"`
	Template string                    `json:"template,omitempty"`
	Values   map[string]OutputValueRef `json:"values,omitempty"`
}

type Volume struct {
	ID             string           `gorm:"primary_key;default:gen_random_uuid()" json:"id"`
	OrganisationID string           `gorm:"not null" json:"organisation_id"`
	ProjectID      string           `gorm:"index" json:"project_id"`
	UserID         string           `gorm:"not null" json:"user_id"`
	Name           string           `gorm:"not null; <-:create" json:"name"`
	NamespaceID    string           `gorm:"not null" json:"namespace_id"`
	Namespace      string           `gorm:"not null;  <-:create" json:"namespace"`
	Labels         Labels           `gorm:"type:jsonb" json:"labels"`
	Annotations    Annotations      `gorm:"type:jsonb" json:"annotations"`
	Size           string           `gorm:"<-:create" json:"size"`
	StorageClass   string           `gorm:"<-:create" json:"storage_class,omitempty"`
	AccessMode     VolumeAccessMode `gorm:"not null; <-:create"`
	VolumeSource   *VolumeSource    `gorm:"type:jsonb" json:"volume_source,omitempty"`
	SyncBeforeUse  bool             `json:"sync_before_use"`
	Status         *VolumeStatus    `gorm:"type:jsonb" json:"volume_status,omitempty"`
	CreatedAt      time.Time        `json:"created_at"`
	UpdatedAt      time.Time        `json:"updated_at"`
}

type VolumeAccessMode string

type VolumeBuildSource struct {
	SourceVolumeID   string `json:"source_volume_id"`
	SourceVolumeName string `json:"source_volume_name"`
}

type VolumeMount struct {
	StackID          string
	StackResourceID  string
	SourceVolumeName string
	SourceVolumeID   string
	SourceVolumeType SourceVolumeType
	SourceSubPath    string
	TargetPath       string
}

type VolumeMountPath struct {
	VolumeID string `json:"volume_id"`
	Path     string `json:"path"`
}

type VolumeOperand struct{ ID string }

type VolumeRevision struct {
	// Hash of the contents of the volume.
	CurrentVolumeHash string `json:"current_volume_hash"`
}

type VolumeSource struct {
	RemoteDirSource *RemoteDirSource     `json:"remote_dir_source,omitempty"`
	BuildSource     BuildArtifactSources `json:"build_source,omitempty"`
	GitRepoSource   *GitRepoSource       `json:"git_repo_source,omitempty"`
}

type VolumeStatus struct {
	ObservedGeneration     int64                   `json:"observed_generation"`
	Conditions             []Condition             `json:"conditions"`
	Phase                  string                  `json:"phase"`
	BuildArtifactSyncs     []BuildArtifactSyncInfo `json:"build_artifact_syncs,omitempty"`
	LastObservedStatusHash string                  `json:"last_observed_status_hash,omitempty"`
	InUse                  bool                    `json:"in_use"`
	LastSyncedGitRevision  string                  `json:"last_synced_git_revision,omitempty"`
	LastRemoteDirSyncHash  string                  `json:"last_remote_dir_sync_hash,omitempty"`
}