integrations

type ActiveProvider struct {
	Provider Provider
	Config   *IntegrationConfig
}

type BackendNeeds struct {
	Auth        bool     `json:"auth"`
	AuthMethods []string `json:"auth_methods,omitempty"` // "email", "apple", "google", "anonymous"
	DB          bool     `json:"db"`
	Storage     bool     `json:"storage"`
}

type CuratedIntegration struct {
	ID          ProviderID
	Name        string
	Description string
	SPMPackage  string   // key in package_registry.go
	MCPCommand  string   // e.g. "nanowave"
	MCPArgs     []string // e.g. ["mcp", "supabase"]
	DocsMCPPkg  string   // NPM package for docs MCP (optional)
}

type IntegrationConfig struct {
	Provider   ProviderID `json:"provider"`
	ProjectURL string     `json:"project_url"`   // https://xyz.supabase.co
	ProjectRef string     `json:"project_ref"`   // xyz (extracted from URL)
	AnonKey    string     `json:"anon_key"`      // public anon key
	PAT        string     `json:"pat,omitempty"` // Personal Access Token for MCP
}

type IntegrationStatus struct {
	Provider    ProviderID `json:"provider"`
	AppName     string     `json:"app_name,omitempty"`
	Configured  bool       `json:"configured"`
	ProjectURL  string     `json:"project_url,omitempty"`
	HasAnonKey  bool       `json:"has_anon_key"`
	HasPAT      bool       `json:"has_pat"`
	ValidatedAt string     `json:"validated_at,omitempty"`
}

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

type MCPCapable interface {
	// MCPServer returns the MCP server configuration for this provider.
	MCPServer(ctx context.Context, req MCPRequest) (*MCPServerConfig, error)
	// MCPTools returns MCP tool names for settings allowlist (e.g. "mcp__supabase__execute_sql").
	MCPTools() []string
	// AgentTools returns tools for the agentic build allowlist.
	AgentTools() []string
}

type MCPRequest struct {
	PAT        string
	ProjectURL string // provider-specific project ID (e.g. Supabase URL, RevenueCat project ID)
	ProjectRef string // provider-specific secondary ref (e.g. Supabase ref, RevenueCat app ID)
}

type MCPServerConfig struct {
	Name    string            // server name key (e.g. "supabase")
	Command string            // executable (e.g. "nanowave")
	Args    []string          // arguments (e.g. ["mcp", "supabase"])
	Env     map[string]string // environment variables
}

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

type ModelRef struct {
	Name       string
	Storage    string
	Properties []PropertyRef
}

type MonetizationPlan struct {
	Model       string
	Products    []MonetizationProduct
	Entitlement string
	FreeCredits int
}

type MonetizationProduct struct {
	Identifier  string
	Type        string
	DisplayName string
	Price       string
	Credits     int
	Duration    string
}

type PromptCapable interface {
	// PromptContribution generates prompt content for the build phase.
	PromptContribution(ctx context.Context, req PromptRequest) (*PromptContribution, error)
}

type PromptContribution struct {
	// SystemBlock is content appended to the system prompt (e.g. <integration-config>).
	SystemBlock string
	// UserBlock is content injected into the user message (e.g. backend-first instructions).
	UserBlock string
	// BackendProvisioned signals whether the backend was already provisioned.
	BackendProvisioned bool
}

type PromptRequest struct {
	AppName            string
	Models             []ModelRef
	AuthMethods        []string
	Store              *IntegrationStore
	BackendProvisioned bool
	MonetizationPlan   *MonetizationPlan // product/subscription plan from planner
}

type PropertyRef struct {
	Name         string
	Type         string
	DefaultValue string
}

type Provider interface {
	// ID returns the unique provider identifier (e.g. ProviderSupabase).
	ID() ProviderID
	// Meta returns display metadata for the provider.
	Meta() ProviderMeta
}

type ProviderID string

type ProviderMeta struct {
	Name        string   // Human-readable name (e.g. "Supabase")
	Description string   // Short description
	SPMPackage  string   // SPM package key (e.g. "supabase-swift")
	MCPCommand  string   // MCP server command (e.g. "nanowave")
	MCPArgs     []string // MCP server args (e.g. ["mcp", "supabase"])
	DocsMCPPkg  string   // NPM package for docs MCP (optional)
}

type ProviderStatus struct {
	Configured  bool
	ProjectURL  string
	HasAnonKey  bool
	HasPAT      bool
	ValidatedAt string
}

type ProvisionCapable interface {
	// Provision creates backend resources (tables, auth, storage, etc).
	Provision(ctx context.Context, req ProvisionRequest) (*ProvisionResult, error)
}

type ProvisionRequest struct {
	PAT               string
	ProjectURL        string // provider-specific project ID (e.g. Supabase URL, RevenueCat project ID)
	ProjectRef        string // provider-specific secondary ref (e.g. Supabase ref, RevenueCat app ID)
	AppName           string
	BundleID          string
	Models            []ModelRef
	AuthMethods       []string
	NeedsAuth         bool
	NeedsDB           bool
	NeedsStorage      bool
	NeedsRealtime     bool
	NeedsMonetization bool              // in-app purchases / subscriptions
	MonetizationType  string            // "subscription", "consumable", "hybrid"
	MonetizationPlan  *MonetizationPlan // product definitions from planner
}

type ProvisionResult struct {
	BackendProvisioned bool
	NeedsAppleSignIn   bool
	TablesCreated      []string
	Warnings           []string
}

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

type SetupCapable interface {
	// Setup runs the interactive setup flow for a provider.
	Setup(ctx context.Context, req SetupRequest) error
	// Remove removes the provider config for an app.
	Remove(ctx context.Context, store *IntegrationStore, appName string) error
	// Status returns the current status for an app.
	Status(ctx context.Context, store *IntegrationStore, appName string) (ProviderStatus, error)
	// CLIAvailable returns true if the provider's CLI tool is installed.
	CLIAvailable() bool
}

type SetupRequest struct {
	Store      *IntegrationStore
	AppName    string
	Manual     bool
	ReadLineFn func(label string) string
	PrintFn    func(level, msg string)
	PickFn     func(title string, options []string) string
}

type SetupUI interface {
	// PromptSetup handles first-time setup for a provider. Returns config or nil if skipped.
	PromptSetup(ctx context.Context, sc SetupCapable, p Provider, store *IntegrationStore, appName string) *IntegrationConfig
	// ValidateExisting validates an existing config, refreshing if needed. Returns updated config or nil.
	ValidateExisting(ctx context.Context, sc SetupCapable, p Provider, store *IntegrationStore, appName string, cfg *IntegrationConfig) *IntegrationConfig
	// Info prints an informational message.
	Info(msg string)
	// Warning prints a warning message.
	Warning(msg string)
}