platformimport

type APIError struct {
	Status int
	Body   string
}

type App struct {
	SourceID    string
	Name        string
	Project     string
	Environment string
	// Server names the source host the app runs on, empty when unreported.
	Server string
	// BuildPack is the source's own build method name, unmapped.
	BuildPack string
	// PrivateRepo is true when the source needs credentials to clone.
	PrivateRepo bool
	Kind        SourceKind
	Image       string
	// ImageID is the source host's local image ID, set by snapshot sources.
	ImageID string
	// SourceContainer is the running container's ID on the source host, set by live Docker sources.
	SourceContainer string
	// HostBuilt marks an image built on the source host and absent from any registry.
	HostBuilt   bool
	GitURL      string
	GitBranch   string
	BuildMethod string
	BuildPath   string
	Port        int
	Env         []Env
	Domains     []string
	Volumes     []Volume
	Replicas    int
	Health      *HealthCheck
	Crons       []Cron
	MemoryBytes int64
	NanoCPUs    int64
	// Policy carries the source's proxy flags. Never a credential or hash.
	Policy DomainPolicy
	// Build is how the source builds and deploys the app, validated and secret free.
	Build BuildSettings
	// Files are config file mounts copied byte for byte from the source.
	Files []AppFile
	// Ingress is basic auth, redirects and header rules translated from the source proxy settings.
	Ingress *IngressPlan
	// Previews is true when the source ran preview deployments for the app.
	Previews bool
	// NetworkPeers names the other resources that shared a custom network with the app.
	NetworkPeers []string
	Notes        []Note
}

type AppFile struct {
	Path    string `json:"path"`
	Content []byte `json:"-"`
	Secret  bool   `json:"secret,omitempty"`
}

type AppPlan struct {
	SourceID    string            `json:"source_id"`
	SourceName  string            `json:"source_name"`
	Name        string            `json:"name"`
	Image       string            `json:"image"`
	Port        int               `json:"port"`
	Env         map[string]string `json:"env,omitempty"`
	Secrets     map[string]string `json:"-"`
	Domains     []string          `json:"domains,omitempty"`
	Volumes     []VolumePlan      `json:"volumes,omitempty"`
	Replicas    int               `json:"replicas"`
	Health      *HealthPlan       `json:"health,omitempty"`
	MemoryBytes int64             `json:"memory_bytes,omitempty"`
	NanoCPUs    int64             `json:"nano_cpus,omitempty"`
	Labels      map[string]string `json:"labels"`
	Project     string            `json:"project,omitempty"`
	Environment string            `json:"environment,omitempty"`
	GitURL      string            `json:"git_url,omitempty"`
	GitBranch   string            `json:"git_branch,omitempty"`
	BuildMethod string            `json:"build_method,omitempty"`
	BuildPath   string            `json:"build_path,omitempty"`
	Crons       []CronPlan        `json:"crons,omitempty"`
	Policy      DomainPolicy      `json:"-"`
	// UnreadSecrets names secret variables the source would not reveal.
	UnreadSecrets []string `json:"-"`
}

type Applier interface {
	CreateApp(ctx context.Context, p AppPlan) (warnings []string, err error)
	CreateDatabase(ctx context.Context, p DatabasePlan) (warnings []string, err error)
}

type BackupDestination struct {
	SourceID string
	Name     string
	Provider string
	Endpoint string
	Region   string
	Bucket   string
	// HasCredentials is false when the source returned no keys or masked ones.
	HasCredentials bool
}

type BackupSchedule struct {
	Schedule string
	Enabled  bool
	// Remote is true when the source also uploads the backup to S3.
	Remote bool
	// SourceID, DestinationID and KeepLatest are set by sources that bind a schedule to a destination.
	SourceID      string
	DestinationID string
	KeepLatest    int
}

type BuildSettings struct {
	BaseDirectory  string
	DockerfilePath string
	InstallCommand string
	BuildCommand   string
	StartCommand   string
	PublishDir     string
	PreDeploy      string
	PostDeploy     string
	// BuildTimeKeys names the variables the source only exposes during the build.
	BuildTimeKeys []string
}

type CapRoverSource struct {
	// contains filtered or unexported fields
}

type ClientOptions struct {
	Policy   NetworkPolicy
	Insecure bool
	// Team scopes a Vercel source to one team id or slug, other platforms reject it.
	Team string
}

type ComposeApp struct {
	SourceID    string   `json:"source_id"`
	Name        string   `json:"name"`
	Project     string   `json:"project,omitempty"`
	Environment string   `json:"environment,omitempty"`
	Compose     string   `json:"-"`
	Env         []Env    `json:"-"`
	Domains     []string `json:"domains,omitempty"`
	Volumes     []string `json:"volumes,omitempty"`
	Verdict     string   `json:"verdict"`
	Blocked     []string `json:"blocked,omitempty"`
	Notes       []Note   `json:"notes,omitempty"`
}

type ComposeSource struct {
	Data []byte
}

type CoolifySource struct {
	// contains filtered or unexported fields
}

type Cron struct {
	Name     string
	Schedule string
	Command  string
}

type CronPlan struct {
	Name     string `json:"name"`
	Schedule string `json:"schedule"`
	Command  string `json:"command"`
}

type Database struct {
	SourceID string
	Name     string
	Project  string
	Engine   string
	Version  string
	// Environment and InternalHost are set by sources that give each
	// database an in-network hostname apps connect to.
	Environment  string
	InternalHost string
	// Server, User, DBName, Public and PublicPort describe how the source
	// exposes the database. No credential is ever read here.
	Server     string
	User       string
	DBName     string
	Public     bool
	PublicPort int
	Backups    []BackupSchedule
}

type DatabasePlan struct {
	SourceID    string `json:"source_id"`
	SourceName  string `json:"source_name"`
	Name        string `json:"name"`
	Engine      string `json:"engine"`
	Version     string `json:"version"`
	Project     string `json:"project,omitempty"`
	Environment string `json:"environment,omitempty"`
}

type Discovery struct {
	Platform Platform
	Projects []string
	// Environments lists every source environment, including empty ones.
	Environments []SourceEnvironment
	Apps         []App
	Databases    []Database
	Unsupported  []Unsupported
	// Services holds each one-click service's masked compose body and env.
	Services []Service
	// ComposeApps are multi-service stacks imported as compose apps.
	ComposeApps []ComposeApp
	Servers     []Server
	// Destinations are object-storage backup targets, read without their keys.
	Destinations []BackupDestination
	// Notifications are alert providers, read without their tokens or webhook URLs.
	Notifications []NotificationProvider
	// Warnings are source reads that failed softly, so the plan lacks that detail.
	Warnings []string
}

type DockerSSHSource struct {
	Reader InspectReader
}

type DockerSource struct {
	Data []byte
}

type DokkuEnvSource struct {
	AppName string
	Data    string
}

type DokployPolicies struct {
	Redirects  []DokployRedirect
	Security   []DokploySecurity
	Ports      []DokployPort
	PreDeploy  string
	PostDeploy string
}

type DokployPort struct {
	Published int    `json:"publishedPort"`
	Target    int    `json:"targetPort"`
	Protocol  string `json:"protocol"`
}

type DokployRedirect struct {
	Regex       string `json:"regex"`
	Replacement string `json:"replacement"`
	Permanent   bool   `json:"permanent"`
}

type DokploySecurity struct {
	Username string `json:"username"`
}

type DokploySource struct {
	// contains filtered or unexported fields
}

type DokployTranslation struct {
	Ingress               *IngressPlan
	PreDeploy, PostDeploy string
	Notes                 []Note
}

type DomainPolicy struct {
	ForceHTTPS    bool
	WebSocket     bool
	RedirectTo    string
	BasicAuthUser string
}

type EmitApp struct {
	Name string
	// Project and Environment override the stack-wide ones when set.
	Project     string
	Environment string
	// Image is the prebuilt image. Empty means use EmitOptions.ImageRepo.
	Image       string
	Port        int
	Replicas    int
	Env         map[string]string
	Secrets     []EmitSecret
	Domains     []string
	MemoryBytes int64
	// Memory is a ready "512Mi" string and wins over MemoryBytes.
	Memory     string
	NanoCPUs   int64
	HealthPath string
	// HealthExec, when set, emits an exec probe instead of the HTTP path.
	HealthExec     []string
	HealthInterval int
	HealthTimeout  int
	HealthRetries  int
	Command        []string
	PreDeploy      string
	PostDeploy     string
	// Connections maps an env var to the emitted database it reads from.
	Connections map[string]EmitConnection
	Jobs        []EmitJob
	// Policy lists proxy flags for the domain steps in MIGRATION.md.
	Policy DomainPolicy
	// Notes are follow-ups for MIGRATION.md that the documents cannot express.
	Notes []string
}

type EmitConnection struct {
	Database string
	Field    string
}

type EmitDatabase struct {
	Name    string
	Project string
	Engine  string
	Version string
}

type EmitFile struct {
	Name    string
	Content []byte
}

type EmitInput struct {
	// Source names where the data came from, for the checklist header.
	Source    string
	Apps      []EmitApp
	Databases []EmitDatabase
	// Notes are source-wide follow-ups for MIGRATION.md.
	Notes []string
	// Environments are extra project environments to declare.
	Environments []SourceEnvironment
}

type EmitJob struct {
	Name     string
	Schedule string
	Command  []string
	// Mode is "exec" to run in the app's running container; empty means a fresh one.
	Mode     string
	Timezone string
}

type EmitOptions struct {
	Stack       string
	Project     string
	Environment string
	// ImageRepo prefixes the image of an app that has none, as REPO/APP:latest.
	ImageRepo string
}

type EmitSecret struct {
	Name string
	Hint string
}

type Env struct {
	Key    string
	Value  string
	Secret bool
	// BuildTime marks a variable the source only exposes during the image build.
	BuildTime bool
}

type EnvironmentApplier interface {
	CreateEnvironment(ctx context.Context, p EnvironmentPlan) (warnings []string, err error)
}

type EnvironmentPlan struct {
	SourceID string `json:"source_id"`
	Project  string `json:"project"`
	Name     string `json:"name"`
}

type HealthCheck struct {
	Path            string
	Exec            []string
	IntervalSeconds int
	TimeoutSeconds  int
	Retries         int
}

type HealthPlan struct {
	Path            string
	Exec            []string
	IntervalSeconds int
	TimeoutSeconds  int
	Failures        int
}

type HerokuSource struct {
	// contains filtered or unexported fields
}

type IngressPlan struct {
	// BasicAuth gates every domain with a placeholder credential the operator replaces.
	BasicAuth bool `json:"basic_auth,omitempty"`
	// Canonical is a www redirect preset (www-to-apex or apex-to-www).
	Canonical  string                     `json:"canonical,omitempty"`
	ForceHTTPS bool                       `json:"force_https,omitempty"`
	Forwarders []trafficpolicy.Forwarder  `json:"forwarders,omitempty"`
	Headers    []trafficpolicy.HeaderRule `json:"headers,omitempty"`
	// Manual lists label keys and settings with no translation, each with a reason; values are never kept.
	Manual []Note `json:"manual,omitempty"`
}

type IngressSource struct {
	Labels    string
	BasicAuth bool
	// Redirect is the source's www rule: www, non-www or both.
	Redirect string
	// App is the target app name a strip-prefix rule forwards back to.
	App string
	// Domain is the first domain, used as the validation context.
	Domain string
}

type InspectReader interface {
	InspectAll(ctx context.Context) ([]byte, error)
}

type Item struct {
	Kind       string   `json:"kind"`
	SourceID   string   `json:"source_id"`
	SourceName string   `json:"source_name"`
	Target     string   `json:"target,omitempty"`
	Status     string   `json:"status"`
	Reasons    []string `json:"reasons,omitempty"`
	Manual     []string `json:"manual,omitempty"`
}

type NetworkPolicy struct {
	AllowPrivate  bool
	AllowLoopback bool
}

type NodeRef struct {
	ID   string
	Name string
}

type Note struct {
	// Area groups notes in the exit report, such as "webhook" or "command". Empty means general.
	Area   string
	Reason string
	Manual string
}

type NotificationProvider struct {
	SourceID string
	Name     string
	// Kind is the source's provider type, lowercased.
	Kind string
	// Server is the non-secret base URL of a self-hosted provider (gotify, ntfy).
	Server string
	// Recipient is the email address for an email provider; it is not a credential.
	Recipient string
	// ExtraRecipients counts email addresses beyond the first.
	ExtraRecipients int
	// HasSecret is false when the source returned no usable token or masked one.
	HasSecret bool
	// HasHeaders is true for a custom webhook that sends extra headers, which do not carry over.
	HasHeaders bool
	// HasAccessToken is true for an ntfy provider protected by a token.
	HasAccessToken bool
	// Mismatch is true when the sub-object named by the kind is missing.
	Mismatch bool
}

type NotifyTarget struct {
	URL    string
	Kind   string
	Server string
}

type Plan struct {
	Environments []EnvironmentPlan
	Apps         []AppPlan
	Databases    []DatabasePlan
	Report       Report
}

type PlanOptions struct {
	// Only restricts the plan to these source ids or source names. Empty means all.
	Only []string
	// Collision is CollisionSuffix (default) or CollisionSkip.
	Collision string
	// ExistingApps maps an import label value (platform:sourceID) to the
	// app already created for it. TakenApps is every app name in use.
	ExistingApps map[string]string
	TakenApps    map[string]bool
	// ExistingDatabases maps a database name to "engine:version".
	ExistingDatabases map[string]string
	// ExistingEnvironments holds "project/environment" keys that already exist.
	ExistingEnvironments map[string]bool
	// DBVersions is the engine version the user chose per engine, and
	// LatestDBVersions the newest catalog version per engine. Both fill in
	// databases whose source reports no version.
	DBVersions       map[string]string
	LatestDBVersions map[string]string
}

type Platform string

type RenderSource struct {
	// contains filtered or unexported fields
}

type Report struct {
	Platform Platform       `json:"platform"`
	Items    []Item         `json:"items"`
	Counts   map[string]int `json:"counts"`
	Notes    []string       `json:"notes,omitempty"`
}

type Server struct {
	Name    string
	Address string
	// Proxy names the reverse proxy the source runs there, empty when none.
	Proxy string
	// BuildServer is true when the source uses the host only to build images.
	BuildServer bool
	Reachable   bool
}

type Service struct {
	SourceID    string
	Name        string
	Project     string
	Environment string
	Server      string
	Type        string
	Compose     string
	Env         []Env
}

type Source interface {
	Discover(ctx context.Context) (*Discovery, error)
}

type SourceEnvironment struct {
	Project string
	Name    string
}

type SourceKind string

type Unsupported struct {
	Kind     string
	SourceID string
	Name     string
	Reason   string
	Manual   string
	// Context the source reported about the unsupported item, for display.
	Project     string
	Environment string
	Server      string
	Source      string
	Domains     []string
	Port        int
}

type VercelSource struct {

	// TeamID scopes every call to a team, empty means the token's personal account.
	TeamID string
	// contains filtered or unexported fields
}

type Volume struct {
	Name          string
	HostPath      string
	ContainerPath string
	ReadOnly      bool
	// SizeBytes is 0 when the source API does not report volume sizes.
	SizeBytes int64
}

type VolumePlan struct {
	Name          string
	HostPath      string
	ContainerPath string
	ReadOnly      bool
}