service

type AdminAppComponentDetails struct {
	*app.Component
}

type AdminAppConfigGraphRequest struct {
	ConfigID string
}

type AdminAppDetails struct {
	*app.App

	Components []AdminAppComponentDetails `json:"components,omitempty"`
}

type AdminTriggerAppBranchRunRequest struct {
	Force bool `json:"force"`
}

type AppAWSIAMPolicyConfig struct {
	ManagedPolicyName string `json:"managed_policy_name"`

	Name              string   `json:"name"`
	Contents          string   `json:"contents" swaggertype:"string" validate:"optional_json"`
	GCPPermissions    []string `json:"gcp_permissions,omitempty"`
	GCPPredefinedRole string   `json:"gcp_predefined_role,omitempty"`
	AzureActions      []string `json:"azure_actions,omitempty"`
	AzureBuiltInRoles []string `json:"azure_built_in_roles,omitempty"`
}

type AppAWSIAMRoleConfig struct {
	Name                string `json:"name" validate:"required"`
	DisplayName         string `json:"display_name" validate:"required"`
	Description         string `json:"description" validate:"required"`
	PermissionsBoundary string `json:"permissions_boundary,omitempty" swaggertype:"string" validate:"optional_json"`
	CloudPlatform       string `json:"cloud_platform,omitempty" validate:"omitempty,oneof=aws gcp azure"`
	EnabledInStack      *bool  `json:"enabled_in_stack" swaggertype:"boolean" extensions:"x-nullable"`

	// Policies may be empty when the role attaches named policies instead. A
	// role with neither grants nothing and is rejected.
	Policies []AppAWSIAMPolicyConfig `json:"policies" validate:"dive"`

	NamedPolicyNames []string `json:"named_policy_names,omitempty"`
}

type AppBranchRunComparisonResponse struct {
	ID        string `json:"id"`
	HeadRunID string `json:"head_run_id"`
	BaseRunID string `json:"base_run_id,omitempty"`
	BaseSHA   string `json:"base_sha,omitempty"`
	HeadSHA   string `json:"head_sha,omitempty"`

	HeadRun *AppBranchRunComparisonRunSummary `json:"head_run,omitempty"`
	BaseRun *AppBranchRunComparisonRunSummary `json:"base_run,omitempty"`

	GitDiff    *blobstore.BlobMetadata `json:"git_diff,omitempty"`
	FullDiff   *blobstore.BlobMetadata `json:"full_diff,omitempty"`
	ConfigDiff *blobstore.BlobMetadata `json:"config_diff,omitempty"`

	SourceDiff *blobstore.BlobMetadata `json:"source_diff,omitempty"`

	GitDiffContent    any `json:"git_diff_content,omitempty"`
	FullDiffContent   any `json:"full_diff_content,omitempty"`
	ConfigDiffContent any `json:"config_diff_content,omitempty"`

	SourceDiffContent any `json:"source_diff_content,omitempty"`
}

type AppBranchRunComparisonRunSummary struct {
	ID                  string                   `json:"id"`
	WorkflowID          string                   `json:"workflow_id,omitempty"`
	Status              string                   `json:"status,omitempty"`
	CreatedAt           time.Time                `json:"created_at,omitempty"`
	PRNumber            *int                     `json:"pr_number,omitempty"`
	BaseBranch          string                   `json:"base_branch,omitempty"`
	EventType           string                   `json:"event_type,omitempty"`
	AppConfigID         string                   `json:"app_config_id,omitempty"`
	VCSConnectionCommit *app.VCSConnectionCommit `json:"vcs_connection_commit,omitempty"`
}

type AppConfigDiffResponse struct {
	ConfigID      string                    `json:"config_id"`
	OldConfigID   string                    `json:"old_config_id,omitempty"`
	Diff          *diff.Diff                `json:"diff"`
	Summary       diff.DiffSummary          `json:"summary"`
	Changed       string                    `json:"changed"`
	Source        *config.SourceArchiveDiff `json:"source,omitempty"`
	SourceSkipped bool                      `json:"source_skipped,omitempty"`
}

type AppConfigTemplate struct {
	Format   app.AppConfigVersion
	Type     AppConfigTemplateType
	Filename string
	Content  string
}

type AppConfigTemplateType string

type AppGroupRequest struct {
	DisplayName string `json:"display_name" validate:"required"`
	Description string `json:"description" validate:"required"`
	Index       int    `json:"index" validate:"required"`
}

type AppInputRequest struct {
	DisplayName string `json:"display_name" validate:"required"`
	Description string `json:"description" validate:"required"`
	Default     string `json:"default"`
	Required    bool   `json:"required"`
	Sensitive   bool   `json:"sensitive"`
	Group       string `json:"group" validate:"required"`
	Index       int    `json:"index" validate:"required"`

	// New, optional fields
	Type   string             `json:"type"`
	Source app.AppInputSource `json:"source"`
}

type AppKubernetesContext struct {
	Name string `json:"name" validate:"required"`
	// Component is the name of the peer terraform_module or pulumi component
	// that emits cluster connection details as outputs.
	Component string `json:"component" validate:"required"`
}

type AppLabelKeySummary struct {
	Key          string   `json:"key"`
	Color        string   `json:"color"`
	DefaultColor string   `json:"default_color"`
	IsOverride   bool     `json:"is_override"`
	Values       []string `json:"values"`
	EntityTypes  []string `json:"entity_types"`
	UsageCount   int      `json:"usage_count"`
}

type AppLabelsResponse struct {
	Labels        []AppLabelKeySummary `json:"labels"`
	LabelColors   map[string]string    `json:"label_colors"`
	DefaultColors []string             `json:"default_colors"`
}

type AppNamedIAMPolicyConfig struct {
	Name        string `json:"name" validate:"required"`
	PolicyName  string `json:"policy_name,omitempty"`
	Description string `json:"description,omitempty"`
	Contents    string `json:"contents" swaggertype:"string" validate:"required"`
}

type AppPolicyConfig struct {
	Type        config.AppPolicyType   `json:"type" validate:"required"`
	Engine      config.AppPolicyEngine `json:"engine,omitempty"`
	Name        string                 `json:"name,omitempty"`
	Description string                 `json:"description,omitempty"`
	Contents    string                 `json:"contents" validate:"required" swaggertype:"string"`
	Components  []string               `json:"components,omitempty"`
}

type AppSecretConfig struct {
	Name        string `json:"name" validate:"interpolated_name,required"`
	DisplayName string `json:"display_name" validate:"required"`
	Description string `json:"description" validate:"required"`

	Required     bool   `json:"required"`
	AutoGenerate bool   `json:"auto_generate"`
	Format       string `json:"format"`
	Default      string `json:"default"`

	KubernetesSync            bool   `json:"kubernetes_sync"`
	KubernetesSecretNamespace string `json:"kubernetes_secret_namespace"`
	KubernetesSecretName      string `json:"kubernetes_secret_name" validate:"omitempty,hostname_rfc1123"`

	KubernetesSyncTargets []KubernetesSyncTarget `json:"kubernetes_sync_targets" validate:"dive"`
}

type BuildAppConfigRequest struct {
	RequestID string `json:"request_id,omitempty" validate:"omitempty,max=255"`
}

type CreateAppBranchConfigRequest struct {
	vcshelpers.VCSConfigRequest

	InstallGroups []InstallGroupRequest `json:"install_groups"`

	// PostDeployRunbookIDs run on each install, in order, after its deploy succeeds.
	// Omit to carry the current setting forward; send an empty array to clear it.
	PostDeployRunbookIDs *[]string `json:"post_deploy_runbook_ids,omitempty"`

	// IgnoreChangesRegex marks a run not-attempted when every changed file path in
	// it matches this RE2 pattern. Omit to carry the current setting forward; send
	// an empty string to clear it.
	IgnoreChangesRegex *string `json:"ignore_changes_regex,omitempty" swaggertype:"string" extensions:"x-nullable"`

	// SendStatusesOnIgnore posts a successful commit status for runs ignored by
	// IgnoreChangesRegex. Omit to carry the current setting forward.
	SendStatusesOnIgnore *bool `json:"send_statuses_on_ignore,omitempty" swaggertype:"boolean" extensions:"x-nullable"`

	PreviewConfig      *app.AppBranchPreviewConfig `json:"preview_config,omitempty"`
	ClearPreviewConfig bool                        `json:"clear_preview_config,omitempty"`
	RunConfig          *app.AppBranchRunConfig     `json:"run_config,omitempty"`
}

type CreateAppBranchRequest struct {
	Name      string `json:"name" validate:"required,min=1"`
	ManagedBy string `json:"managed_by,omitempty"`
}

type CreateAppBreakGlassConfigRequest struct {
	Roles []AppAWSIAMRoleConfig `json:"roles" validate:"required"`

	AppConfigID string `json:"app_config_id" validate:"required"`
}

type CreateAppConfigRequest struct {
	Readme     string `json:"readme,omitempty"`
	CLIVersion string `json:"cli_version,omitempty"`

	// IntermediateConfigJSON is the serialized intermediate config (parsed nuon.toml).
	// When provided, stored on the AppConfig for diffing in PR previews.
	IntermediateConfigJSON string `json:"intermediate_config_json,omitempty"`

	// AppBranchID optionally links this config to an app branch.
	// When set, triggers an app branch run after sync.
	AppBranchID string `json:"app_branch_id,omitempty"`
	// PlanOnly creates a preview run (plan without apply). Only used with AppBranchID.
	PlanOnly bool `json:"plan_only,omitempty"`

	// SkipNotification suppresses the app-config-synced signal emission.
	// Used when creating a config as part of app deletion cleanup.
	SkipNotification bool `json:"skip_notification,omitempty"`
}

type CreateAppInputConfigRequest struct {
	AppConfigID string                     `json:"app_config_id"`
	Inputs      map[string]AppInputRequest `json:"inputs" validate:"required"`
	Groups      map[string]AppGroupRequest `json:"groups" validate:"required"`
}

type CreateAppInstallsConfigRequest struct {
	VCSType         string  `json:"vcs_type" validate:"required,oneof=connected public"`
	VCSConnectionID *string `json:"vcs_connection_id,omitempty"`
	Repo            string  `json:"repo" validate:"required"`
	Branch          string  `json:"branch" validate:"required"`
	Directory       string  `json:"directory,omitempty"`
}

type CreateAppKubernetesContextsConfigRequest struct {
	AppConfigID string `json:"app_config_id" validate:"required"`

	Contexts []AppKubernetesContext `json:"contexts" validate:"dive"`
}

type CreateAppOperationRoleConfigRequest struct {
	AppConfigID string                     `json:"app_config_id" validate:"required"`
	Rules       []OperationRoleRuleRequest `json:"rules" validate:"required,dive"`
}

type CreateAppPermissionsConfigRequest struct {
	ProvisionRole   AppAWSIAMRoleConfig `json:"provision_role" validate:"required"`
	DeprovisionRole AppAWSIAMRoleConfig `json:"deprovision_role" validate:"required"`
	MaintenanceRole AppAWSIAMRoleConfig `json:"maintenance_role" validate:"required"`

	BreakGlassRoles *[]AppAWSIAMRoleConfig    `json:"break_glass_roles"`
	CustomRoles     *[]AppAWSIAMRoleConfig    `json:"custom_roles"`
	NamedPolicies   []AppNamedIAMPolicyConfig `json:"named_policies,omitempty"`

	AppConfigID string `json:"app_config_id" validate:"required"`
}

type CreateAppPoliciesConfigRequest struct {
	AppConfigID string `json:"app_config_id" validate:"required"`

	Policies []AppPolicyConfig `json:"policies"`
}

type CreateAppRequest struct {
	Name            string `json:"name" validate:"required,entity_name"`
	Description     string `json:"description"`
	DisplayName     string `json:"display_name"`
	SlackWebhookURL string `json:"slack_webhook_url"`
}

type CreateAppRunnerConfigRequest struct {
	Type          app.AppRunnerType                 `json:"type" validate:"required"`
	EnvVars       map[string]*string                `json:"env_vars"`
	HelmDriver    app.AppRunnerConfigHelmDriverType `json:"helm_driver"`
	InitScriptURL string                            `json:"init_script_url"`
	InstanceType  string                            `json:"instance_type"`
	RunnerAPIURL  string                            `json:"runner_api_url"`
	PublicAPIURL  string                            `json:"public_api_url"`
	// PhoneHomeScriptURL overrides the phone-home Lambda source for this app.
	PhoneHomeScriptURL string `json:"phone_home_script_url"`

	AppConfigID string `json:"app_config_id"`
}

type CreateAppSandboxBuildRequest struct {
	RequestID string `json:"request_id,omitempty" validate:"omitempty,max=255"`
}

type CreateAppSandboxConfigRequest struct {
	vcshelpers.VCSConfigRequest

	Type                         string  `json:"type,omitempty"`
	TerraformVersion             string  `json:"terraform_version,omitempty"`
	Runtime                      string  `json:"runtime,omitempty"`
	PulumiVersion                string  `json:"pulumi_version,omitempty"`
	DriftSchedule                *string `json:"drift_schedule,omitempty" validate:"omitempty,cron_schedule"`
	MaxAutoRetries               *int    `json:"max_auto_retries,omitempty"`
	SkipNoops                    *bool   `json:"skip_noops,omitempty"`
	AutoApproveOnPoliciesPassing *bool   `json:"auto_approve_on_policies_passing,omitempty"`

	VariablesFiles []string           `json:"variables_files,omitempty"`
	Variables      map[string]*string `json:"variables" validate:"required"`
	EnvVars        map[string]*string `json:"env_vars" validate:"required"`
	PulumiConfig   map[string]*string `json:"pulumi_config,omitempty"`

	OperationRoles map[app.OperationType]*string `json:"operation_roles,omitempty"`

	References []string `json:"references"`

	AppConfigID string `json:"app_config_id"`
}

type CreateAppSecretRequest struct {
	Name  string `json:"name" validate:"required,entity_name"`
	Value string `json:"value" validate:"required"`
}

type CreateAppSecretsConfigRequest struct {
	AppConfigID string `json:"app_config_id" validate:"required"`

	Secrets []AppSecretConfig `json:"secrets" validate:"dive"`
}

type CreateAppStackConfigRequest struct {
	Type        app.StackType `json:"type" validate:"required"`
	Description string        `json:"description" validate:"required"`
	Name        string        `json:"name" validate:"required"`

	RunnerNestedTemplateURL string `json:"runner_nested_template_url"`
	VPCNestedTemplateURL    string `json:"vpc_nested_template_url"`

	DeploymentScope string `json:"deployment_scope"`

	CustomNestedStacks []config.CustomNestedStack `json:"custom_nested_stacks"`

	AppConfigID string `json:"app_config_id" validate:"required"`
}

type InstallGroupRequest struct {
	Name  string `json:"name" validate:"required,min=1"`
	Order int    `json:"order" validate:"min=0"`

	LabelSelector *labels.Selector `json:"label_selector,omitempty"`

	Default bool `json:"default,omitempty"`

	// AutoApproveOnPoliciesPassing approves this group's plan step without user
	// input when its policy checks pass. Omit to leave it unset (off).
	AutoApproveOnPoliciesPassing *bool `json:"auto_approve_on_policies_passing,omitempty" swaggertype:"boolean" extensions:"x-nullable"`
}

type KubernetesSyncTarget struct {
	Namespaces []string `json:"namespaces" validate:"required,min=1,dive,hostname_rfc1123"`
	Name       string   `json:"name" validate:"required,hostname_rfc1123"`
	Key        string   `json:"key" validate:"required"`
}

type OperationRoleRuleRequest struct {
	Principal string            `json:"principal" validate:"required"`
	Operation app.OperationType `json:"operation" validate:"required"`
	Role      string            `json:"role" validate:"required"`
}

type Params struct {
	fx.In

	V               *validator.Validate
	DB              *gorm.DB `name:"psql"`
	MW              metrics.Writer
	L               *zap.Logger
	Cfg             *internal.Config
	VcsHelpers      *vcshelpers.Helpers
	Helpers         *appshelpers.Helpers
	InstallsHelpers *installshelpers.Helpers
	AccountsHelpers *accountshelpers.Helpers
	FeaturesClient  *features.Features
	QueueClient     *queueclient.Client
	EndpointAudit   *api.EndpointAudit
	TemporalClient  temporalclient.Client
	BlobService     blobstore.Service
	MeterProvider   metric.MeterProvider `optional:"true"`
}

type PreviewInstallCandidatesResponse struct {
	Installs []app.Install `json:"installs"`
}

type PreviewRunRequest struct {
	Source   app.AppBranchRunPreviewSource `json:"source"`
	PRNumber *int                          `json:"pr_number,omitempty"`
	GitRef   string                        `json:"git_ref,omitempty"`
	HeadSHA  string                        `json:"head_sha,omitempty"`

	Mode      *app.AppBranchRunPreviewMode `json:"mode,omitempty"`
	InstallID *string                      `json:"install_id,omitempty"`
}

type ReprovisionAppRequest struct{}

type RespondInstallCreationApprovalRequest struct {
	ResponseType string `json:"response_type" binding:"required,oneof=approve deny"`
}

type RestartAppRequest struct{}

type TriggerAppBranchRunRequest struct {
	RequestID   string `json:"request_id,omitempty" validate:"omitempty,max=255"`
	ConfigID    string `json:"config_id"`
	Force       bool   `json:"force"`
	PlanOnly    bool   `json:"plan_only"`
	AppConfigID string `json:"app_config_id"`
	SkipBuilds  bool   `json:"skip_builds"`

	SyncAppConfig bool `json:"sync_app_config"`

	AutoApprove bool `json:"auto_approve"`

	PRNumber   *int   `json:"pr_number,omitempty"`
	HeadSHA    string `json:"head_sha,omitempty"`
	BaseBranch string `json:"base_branch,omitempty"`

	PreviewRun *PreviewRunRequest `json:"preview_run,omitempty"`

	RunType TriggerAppBranchRunSource `json:"run_type,omitempty"`
	RunRef  string                    `json:"run_ref,omitempty"`
}

type TriggerAppBranchRunSource string

type TriggerAppInstallSyncRequest struct {
	RequestID string `json:"request_id,omitempty" validate:"omitempty,max=255"`
}

type TriggerInstallConfigSyncRequest struct {
	InstallName string `json:"install_name,omitempty"`
}

type UpdateAppBranchConfigRequest struct {
	// IgnoreChangesRegex marks a run not-attempted when every changed file path in
	// it matches this RE2 pattern. Send an empty string to clear it.
	IgnoreChangesRegex *string `json:"ignore_changes_regex,omitempty" swaggertype:"string" extensions:"x-nullable"`

	// SendStatusesOnIgnore posts a successful commit status for ignored runs.
	SendStatusesOnIgnore *bool `json:"send_statuses_on_ignore,omitempty" swaggertype:"boolean" extensions:"x-nullable"`
}

type UpdateAppBranchRequest struct {
	Name string `json:"name" validate:"required,min=1"`
}

type UpdateAppConfigInstallsRequest struct {
	UpdateAll  bool
	InstallIDs []string
}

type UpdateAppConfigRequest struct {
	Status            app.AppConfigStatus `json:"status"`
	StatusDescription string              `json:"status_description"`
	State             string              `json:"state"`
	ComponentIDs      []string            `json:"component_ids"`
}

type UpdateAppRequest struct {
	Name            string            `json:"name"`
	Description     string            `json:"description"`
	DisplayName     string            `json:"display_name"`
	SlackWebhookURL *string           `json:"slack_webhook_url"`
	ConfigRepo      *string           `json:"config_repo"`
	ConfigDirectory *string           `json:"config_directory"`
	LabelColors     map[string]string `json:"label_colors,omitempty"`
}